huncode/content-factory
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Task 010 implement research manifest flow

Browse Source
This commit is contained in:
huncode
2026-05-21 21:56:44 +03:00
parent 5b27d1a3ca
commit 7d4a79acb5
23 changed files with 1063 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tasks/010-research-fetch-and-s3-manifest.md
+14 -14
View File
@@ -35,14 +35,14 @@ Development description: Implement explicit auditable web research with source r
## Acceptance Criteria
- [ ] TDD pre-requirement: before implementation, write one failing behavior test that starts research from an approved plan and verifies a manifest with object keys is produced; proceed one research behavior at a time and record evidence in `Result`.
- [ ] Research cannot start before plan approval.
- [ ] Research run creates an agent/job record and article status `RESEARCH_RUNNING`.
- [ ] Source-section artifacts are uploaded to object storage.
- [ ] Manifest records include object keys, hashes, URLs, artifact types, and metadata references.
- [ ] Re-running research creates a new manifest instead of overwriting old artifacts.
- [ ] UI can show source URL, title, domain, type, summary, retrieval timestamp, and artifact link.
- [ ] Demo stack can run with deterministic fake research results.
- [x] TDD pre-requirement: before implementation, write one failing behavior test that starts research from an approved plan and verifies a manifest with object keys is produced; proceed one research behavior at a time and record evidence in `Result`.
- [x] Research cannot start before plan approval.
- [x] Research run creates an agent/job record and article status `RESEARCH_RUNNING`.
- [x] Source-section artifacts are uploaded to object storage.
- [x] Manifest records include object keys, hashes, URLs, artifact types, and metadata references.
- [x] Re-running research creates a new manifest instead of overwriting old artifacts.
- [x] UI can show source URL, title, domain, type, summary, retrieval timestamp, and artifact link.
- [x] Demo stack can run with deterministic fake research results.
## Verification
@@ -53,9 +53,9 @@ Development description: Implement explicit auditable web research with source r
## Result
- Status: Pending execution.
- TDD plan: To be filled during execution.
- Red evidence: To be filled during execution.
- Green evidence: To be filled during execution.
- Refactor notes: To be filled during execution.
- Verification output: To be filled during execution.
- Status: Accepted.
- TDD plan: Added `apps/backend/tests/integration/test_research_manifest_public_api.py` before implementation. The test builds an approved plan, starts research, verifies a manifest with object keys/hashes/source URLs/artifact types/metadata, checks uploaded local object files, lists research runs, and verifies rerun creates a new manifest prefix.
- Red evidence: Initial run failed with `201 != 202`; `POST /api/articles/{article_id}/research/start` only returned a queued `RESEARCH` job and no manifest/artifacts.
- Green evidence: Implemented deterministic fake research fetch, local/S3 object storage adapter, research manifest repository, `ResearchStartResponse`, `ResearchListResponse`, `GET /research`, manifest-linked detail output, and FSD frontend research page at `/articles/[articleId]/research`.
- Refactor notes: Moved research-start behavior out of the Task 009 placeholder and made it produce an auditable manifest immediately for deterministic demo/tests. `OBJECT_STORAGE_LOCAL_ROOT` enables isolated integration tests; Docker Compose uses the existing S3-compatible MinIO env.
- Verification output: `PYTHONPATH=/private/tmp/pupline-backend-deps python3 -m unittest apps/backend/tests/integration/test_research_manifest_public_api.py apps/backend/tests/integration/test_plan_generation_review_public_api.py apps/backend/tests/integration/test_schema_storage_contracts.py apps/backend/tests/contracts/test_generated_contract_artifacts.py` passed. `pnpm --filter @pipeline/frontend test:ui` passed. `pnpm --filter @pipeline/frontend typecheck` passed. `tests/smoke/research-flow.sh` and `tests/smoke/plan-flow.sh` passed with Docker Compose after Docker socket escalation.