chore: bootstrap capability inventory (docs/project-state.md) - #223
Conversation
There was a problem hiding this comment.
🟡 Changes recommended
The new doc contains a few concrete accuracy/actionability issues (non-existent reference, inconsistent landed date vs issue history, and misleading Kùzu planning wording) that should be corrected before merging.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Bootstraps a new, version-controlled “capability inventory” document (docs/project-state.md) that summarizes what the CSSC framework has implemented, what is in progress, and what is planned/deferred, based on existing issues/PRs and a code scan.
Changes:
- Adds
docs/project-state.mdwith capability tables (Implemented / In progress / Planned / Deferred). - Captures known gaps & debt and clarifies how status is classified (issues-only, not a project board).
File summaries
| File | Description |
|---|---|
| docs/project-state.md | Introduces the initial capability inventory and status breakdown for the project. |
Review details
Suppressed comments (1)
docs/project-state.md:80
- This mentions “the requirements folder”, but there is no requirements directory in the repo (only language
requirements.txtfiles), so the guidance isn’t actionable as written.
| No PRD/EDD documents on record for pre-agent capabilities | Most Implemented rows predate agent-managed planning; `PRD doc` column is `—`. New features should author a PRD+EDD under the requirements folder. |
- Files reviewed: 1/1 changed files
- Comments generated: 3
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 312397375e
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
…eclassify Kùzu and vuln-attestation
There was a problem hiding this comment.
🟡 Changes recommended
The new inventory doc contains a few durability/consistency problems (Implemented rows lacking doc links despite existing docs, and time-sensitive PR status text) that should be fixed before merge.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Review details
Suppressed comments (1)
docs/project-state.md:44
- These Implemented rows have
Docsset to—, which conflicts with the file’s stated rule that Implemented implies user docs have landed. There are already relevant docs in-repo (graph model doc for multi-arch index↔child, and the promote-from-quarantine workflow doc for referrer-preserving promotion/cleanup), so linking them here would make the inventory easier to validate and keep consistent.
| Observability: model multi-arch index ↔ per-architecture child manifest relationship | multiarch-index-platform | [#216](https://github.com/toddysm/cssc-framework/issues/216) | — | — | 2026-08 |
| Catalog: promotion + quarantine cleanup includes all referrers (OCI 1.0 + 1.1) | promote-referrers | [#198](https://github.com/toddysm/cssc-framework/issues/198) | — | — | 2026-08 |
- Files reviewed: 1/1 changed files
- Comments generated: 2
- Review effort level: Lite
| | Capability | Feature slug | Tracking issue | PRD doc | Docs | Landed | | ||
| | --- | --- | --- | --- | --- | --- | | ||
| | Acquire: sync/mirror images from upstream registries (DockerHub) into quarantine | mirror-image | [#1](https://github.com/toddysm/cssc-framework/issues/1), [#51](https://github.com/toddysm/cssc-framework/issues/51), [#55](https://github.com/toddysm/cssc-framework/issues/55) | — | [docs/architecture/acquire](https://github.com/toddysm/cssc-framework/tree/main/docs/architecture/acquire) | 2026-06 | | ||
| | Acquire: mirror Docker Hardened Images + SBOM-based scanning into hardened namespaces | mirror-hardened | [#50](https://github.com/toddysm/cssc-framework/issues/50), [#52](https://github.com/toddysm/cssc-framework/issues/52), [#54](https://github.com/toddysm/cssc-framework/issues/54) | — | — | 2026-06 | |
| | Capability | Feature slug | Tracking issue | PRD doc | Docs | | ||
| | --- | --- | --- | --- | --- | | ||
| | Observability: supply-chain graph — overall implementation epic | supply-chain-graph | [#177](https://github.com/toddysm/cssc-framework/issues/177) | — | — | | ||
| | Observability: roll up per-platform child referrers/attestations to the index in graph queries/views (PR [#221](https://github.com/toddysm/cssc-framework/pull/221) open on `feat/rollup-platform-referrers`, CI green, awaiting review) | rollup-platform-referrers | [#217](https://github.com/toddysm/cssc-framework/issues/217) | — | — | |
Summary
Bootstraps the project capability inventory at
docs/project-state.md, generated by My Feature Engineer (work-status skill) from existing GitHub issues/PRs and a code scan on 2026-08-25.This is the durable, version-controlled record of what the project has and is building, complementing the transient work-in-flight tracking.
What's inside
Review notes
> NOTE: inferredneed a human read before they are treated as canonical.Landedyears are approximate (merge dates not individually resolved).