Agent task: mature Holmes language intelligence fabric to M2/M3 product spine

[mdheller]

Agent-directed work package.

Target agent: GitHub Copilot coding agent; Codex may also take this if enabled via GitHub Agent HQ.

Context:
Holmes is the SocioProphet language intelligence fabric: governed classical NLP, neural NLP, semantic search, retrieval, knowledge graphs, foundation-language services, guardrails, evals, and investigative agentic discovery. Sherlock Search is the discovery engine; Holmes is the detective layer above it.

Scope:

1. Inspect the live repository before editing.
2. Add/repair product README and docs/ARCHITECTURE.md if incomplete.
3. Add repo.maturity.yaml conforming to repo-maturity.v1 semantics from SocioProphet/functional-model-surfaces.
4. Add contracts/holmes-surface.v1.json or equivalent compact product-surface manifest.
5. Add examples/holmes.surface.example.json.
6. Add Makefile validation target and minimal validator tooling.
7. Define Holmes boundaries: it may orchestrate Sherlock Search, NLP labs, embedding/rerank, graph conversion, guardrails, and agent tools, but it must not own model promotion, mutable model lifecycle, or SourceOS OS state.

Acceptance criteria:

• make validate passes.
• Product docs clearly explain Holmes, Sherlock Search, 221B, Mycroft, Moriarty Bench, Irene Shield, The Canon, and Deduction Engine as product roles.
• repo.maturity.yaml marks current maturity honestly and lists next actions.
• Future Prophet CLI work can consume the product-surface manifest without inventing semantics.

Boundary:
One PR only. Do not touch unrelated repositories. Do not add model weights, datasets, secrets, or runtime credentials.

[mdheller]

@copilot Please take this Holmes product-spine maturity issue.

Execution rules:

• Inspect the live repository before editing.
• Work in one copilot/... branch and open one PR.
• Keep Holmes as the language intelligence product surface. Do not move model promotion, mutable model lifecycle, or SourceOS OS state into this repo.
• Include make validate evidence in the PR body.

The issue body contains required files and acceptance criteria.

[mdheller]

@codex Please take this issue if Codex is enabled for this repo through GitHub Agent HQ or the connected Codex environment.

Keep the implementation bounded to repo maturity/product-spine hardening. Do not implement broad runtime services or CLI internals here unless they are minimal contract stubs needed for validation. Open one PR with make validate evidence.

[chatgpt-codex-connector]

Summary

• Took the Holmes product-spine maturity task and implemented bounded hardening artifacts for M2→M3 readiness: added repo.maturity.yaml with repo-maturity.v1, current stage, boundaries, and concrete next actions. repo.maturity.yamlL1-L31
• Added a compact product-surface contract manifest at contracts/holmes-surface.v1.json that defines Holmes role, orchestrated capabilities, explicit non-ownership boundaries, product-role mapping, and method families for downstream tooling. contracts/holmes-surface.v1.jsonL1
• Added the required surface example at examples/holmes.surface.example.json (matching the requested filename semantics) to serve as the validated instance manifest. examples/holmes.surface.example.jsonL1-L55
• Updated validator tooling so make validate now checks for all required spine artifacts (examples/holmes.surface.example.json, contracts/holmes-surface.v1.json, repo.maturity.yaml) in addition to component/evidence/integration semantics. tools/validate_holmes.pyL8-L63
• Updated CLI self-test wiring to validate against the new example path, keeping runtime scope minimal and aligned to contract validation only. cmd/holmes/main.goL111-L117
• Updated README with a product-surface artifacts section documenting the new maturity/contract/example files. README.mdL58-L62
• Confirmed architecture doc already clearly explains Holmes, Sherlock Search, 221B, Mycroft, Moriarty Bench, Irene Shield, The Canon, and Deduction Engine roles, so no additional edits were needed there. docs/ARCHITECTURE.mdL9-L37

Testing

• ✅ make validate
• ✅ git status --short
• ✅ git add README.md cmd/holmes/main.go tools/validate_holmes.py contracts/holmes-surface.v1.json examples/holmes.surface.example.json repo.maturity.yaml && git commit -m "Add Holmes maturity and surface validation artifacts"

Also completed the follow-up workflow requirement by creating a PR via make_pr after committing.

View task →