Skip to content

Docs/completion program design - #102

Merged
cvsz merged 3 commits into
mainfrom
docs/completion-program-design
Aug 23, 2026
Merged

Docs/completion program design#102
cvsz merged 3 commits into
mainfrom
docs/completion-program-design

Conversation

@cvsz

@cvsz cvsz commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Summary

Describe the bounded change and why it is needed.

Scope

  • One bounded vertical slice only
  • No unrelated refactor or broad rewrite
  • Backward-compatibility impact documented

Validation

  • Ruff
  • Black
  • Python 3.10
  • Python 3.11
  • Python 3.12
  • Bandit / security
  • Docker build/smoke where applicable
  • CodeQL
  • Dependency Review
  • Release Gate
  • Helm
  • SDK / TypeScript

Security review

  • Trust boundaries reviewed
  • User/model-controlled source-to-sink paths reviewed
  • Filesystem/network/permission/secret impacts reviewed
  • No tests, coverage thresholds, permissions, or security gates weakened
  • No production data or third parties used for security validation

Operations / release

  • Configuration or migration impact documented
  • Rollback path documented when behavior/storage/config changed
  • Observability/audit impact considered
  • Exact final head must be green before merge

Documentation

  • README / SECURITY / ARCHITECTURE / exec-planning / CHANGELOG updated where applicable

Notes for reviewers

Call out the highest-risk assumption, unresolved blocker, or follow-up slice. Do not merge while hosted verification is pending or red.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5682bb4438

ℹ️ 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".

Replace the SEC-010 matrix claim that cosign and uv.lock wiring remain with a state that distinguishes implementation from final qualification:

```markdown
| **SEC-010** | **CI/dependency/supply-chain** | **IMPLEMENTED / FINAL-RC QUALIFICATION PENDING** | Immutable action pinning, least privilege, release/container SBOMs, per-arch SBOMs, `uv lock --check`, `uv sync --locked`, keyless cosign signing, Helm packaging/checksums, and release-tag gate are merged. Final artifact/signature/reproducibility verification is C5. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the approved qualification state for SEC-010

Replace IMPLEMENTED / FINAL-RC QUALIFICATION PENDING with the defined IMPLEMENTED / QUALIFICATION PENDING state. The plan requires every final-release row to use only the four ledger states, so executing this prescribed replacement would immediately create a fifth state in the canonical execution plan and undermine the state-normalization and verification steps later in this document.

Useful? React with 👍 / 👎.

Comment on lines +103 to +106
| Fleet | Admission seam | INCOMPLETE / ACTIONABLE | PR #99 deliberately leaves `AdmissionGate` unwired | none | C3 |
| Agent UX | Skills install lifecycle | INCOMPLETE / ACTIONABLE | PR #81 advertises install but implementation is placeholder | none | C2 |
| Performance | Bounded performance targets | IMPLEMENTED / QUALIFICATION PENDING | `tests/unit/test_performance_targets.py` | Exact-RC execution pending | C5 |
| Governance | Main branch protection/rulesets | INCOMPLETE / ACTIONABLE | repository audit shows `protected:false` | none | C6 |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add the C4 lifecycle gap to the canonical ledger

Add an INCOMPLETE / ACTIONABLE row for the agent/subagent lifecycle audit mapped to C4. The design defines this as a remaining completion domain and Task 2 includes C4 in the active residuals, but the required starter matrix skips directly from the C2/C3 gaps to C5/C6 items; because Task 8 validates only rows that already exist, an executor can follow this plan successfully while leaving the canonical ledger with no record of C4.

Useful? React with 👍 / 👎.

@cvsz
cvsz merged commit 512e5e2 into main Aug 23, 2026
19 checks passed
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.

1 participant