Handoff: Codex Orchestrator Build Sprint
Context: The spec-agentic-source-orchestrator has been finalized and promoted to active. We are now transitioning from blueprinting to the Implementation Phase. As the Engineer, your mission is to build the structural foundation of the ingestion pipeline.
1. Directives (Infrastructure)
- Schema Provisioning:
-
- Initialize the Supabase/Postgres tables defined in spec-firecrawl-pgvector-pipeline.
- Ensure the
extensions.vectorandpgcryptoextensions are enabled. - Implement the
match_documentsRPC function.
-
- Policy Loader:
-
- Create
02_System/pipeline-policy.yamlbased on the schema in Section 6 of the master spec. - Implement a Python or PowerShell loader that enforces "fail-closed" logic (if policy is missing or invalid, all ingestion tools must error).
- Create
-
- MCP Tool Scaffolding:
-
- Create a new MCP server (Python or TypeScript) at
02_System/vulture-ingest/. - Implement the core "Reflex" tools:
propose_source_intake,orchestrate_ingestion, andexecute_source_crawl. - Invariant: Tools must check the
pipeline-policy.yamlquotas and denied domains before every execution.
- Create a new MCP server (Python or TypeScript) at
-
2. Dependencies
- spec-agentic-source-orchestrator (The Master Spec)
- spec-firecrawl-pgvector-pipeline (The DB Schema)
- visitor-directives (The Seam Protocol)
3. Next Seam
Upon completion of the MCP scaffold and DB verification, write a Seam to the log.md and hand off to Claude for the Synthesis Intelligence layer.