Skip to content

feat: need-driven project intelligence pipeline - #99

Merged
sarthakagrawal927 merged 1 commit into
mainfrom
feat/need-driven-intelligence-pipeline
Aug 17, 2026
Merged

feat: need-driven project intelligence pipeline#99
sarthakagrawal927 merged 1 commit into
mainfrom
feat/need-driven-intelligence-pipeline

Conversation

@sarthakagrawal927

Copy link
Copy Markdown
Member

Summary

  • Implement the deterministic Starboard side of the need-driven recommendation system (issue Build need-driven project recommendations with Devin final review #82)
  • Add D1 migration 0004_need_driven_intelligence.sql with 7 new tables: capability cards, project fingerprints, needs, candidate pools, draft reports, external review requests, reviewed reports
  • Implement full pipeline in src/lib/need-driven-intelligence.ts: fingerprinting, need extraction (5–10 evidence-backed needs), per-need full-catalog retrieval (Vectorize + FTS + structured), five-bucket classification, draft report persistence with incremental reruns, cached candidate pools, and provider-neutral external review ingestion with idempotency
  • Add API endpoints: GET /api/projects/[slug]/intelligence (read), POST /api/internal/project-intelligence/run (operator run), POST /api/internal/external-reviews/ingest (review ingestion)
  • Starboard contains no Devin credentials; Devin is optional, not required. Read endpoints never trigger external-agent spend. Degraded runs preserve the latest successful report.
  • Add docs: docs/architecture/need-driven-intelligence.md, updated data-flow, features, and index

Test plan

  • Typecheck passes (pnpm typecheck)
  • Lint passes (pnpm lint — 1 pre-existing warning)
  • 249 tests pass across 47 files (pnpm test)
  • Docs check passes (pnpm docs:check — 57 files)
  • Cloudflare build passes (pnpm build:cf)
  • Local D1 migration applied successfully (pnpm db:migrate)

Closes #82

Generated with Devin

Add the deterministic Starboard side of the need-driven recommendation
system (issue #82): extract evidence-backed needs per project, search the
full eligible catalog independently for each need, classify candidates
into five buckets, persist draft reports with incremental reruns, and
expose a provider-neutral external review ingestion contract.

- D1 migration 0004 adds 7 tables: repo_capability_cards,
  project_fingerprints, project_needs, need_candidate_pools,
  project_draft_reports, external_review_requests,
  project_reviewed_reports
- src/lib/need-driven-intelligence.ts: full pipeline implementation
  with fingerprinting, need extraction, per-need retrieval, five-bucket
  classification, draft report persistence, cached candidate pools,
  incremental evaluation, and idempotent review ingestion
- API endpoints: GET /api/projects/[slug]/intelligence (read),
  POST /api/internal/project-intelligence/run (operator run),
  POST /api/internal/external-reviews/ingest (review ingestion)
- 249 tests pass (including 30+ new need-driven intelligence tests)
- Starboard contains no Devin credentials; Devin is optional, not required
- Docs: need-driven-intelligence.md, updated data-flow, features, index

Closes #82

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@sarthakagrawal927
sarthakagrawal927 merged commit 11b0a62 into main Aug 17, 2026
1 of 2 checks passed
@sarthakagrawal927
sarthakagrawal927 deleted the feat/need-driven-intelligence-pipeline branch August 17, 2026 08:41
sarthakagrawal927 added a commit that referenced this pull request Aug 17, 2026
All 26 tasks complete. PR #99 merged, migration applied, production
deployed at SHA 11b0a62. Issue #82 closed.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Build need-driven project recommendations with Devin final review

1 participant