[Governance] Add bounded /deliver-issue command #16
No reviewers
Labels
No labels
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
Creatidy/creatidy-kernel!16
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "issue-15-deliver-issue"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Refs #15.
Adds
/deliver-issueas a small single-issue orchestration command reusing/implement-issueand/review-pr: every independent review is a freshrepository_reviewScarcity Router boundary with capability-derived monotone tightening, exact task-level Agent Manager dispatch and resolution verification, full exact-HEAD re-reviews, durable 10-cycle remediation ledger, bounded architecture correction and infrastructure retries, and no auto-merge ormaintarget.AGENTS.mdsurfaces the dynamic routing requirement; implementation guidance clarifies this is development workflow only. No Kernel product/runtime routing or Program engine change.Current PR HEAD:
a8c7cfe0ca80a27a9c176e4d5ce4af8c7b66d4ed; basedevelop(06c374be43fc0781912a16cba0788821d6973090).make checkPASS (142 tests),make package-checkPASS,git diff --checkPASS; exact-HEAD Forgejo CI run 28 succeeded. A fresh review route was attempted usingrepository_reviewwith architecture/security L4/5/5/5 tightening; Scarcity Router returned genericinvalid_request, despite the payload parsing against the documented local v1 schema. No route was selected and no reviewer was launched, so current review isNOT_RUN, no valid review cycle was added, and no remediation was consumed. Issue #15 ledger recordsremediation_used=0/10, two historical valid reviews on stale heads, and terminalREVIEW_INFRASTRUCTURE_BLOCKED. Issue remains open; PR remains unmerged.PR Review: [Governance] Add bounded /deliver-issue command (#16)
Repository: Creatidy/creatidy-kernel
Branch:
issue-15-deliver-issue->developFrozen head:
6e29a5b788e69ca3b7f175f1b5fc26ff9000c27b(verified unchanged before, during, and after review; local checkout clean at this commit, matchingorigin/issue-15-deliver-issue)Linked issue: #15 (identified from PR body
Refs #15and branch name; issue open)Summary
Markdown-only governance change: adds
.kilo/command/deliver-issue.md(111 lines) defining a bounded single-issue delivery orchestration contract reusing/implement-issueand/review-pr, plus a minimal 2-lineAGENTS.mdpointer. No product code, runtime, dependency, CI, or Program-workflow changes.Intent / Acceptance Evidence
Finishsection enumerates exactlyREADY_FOR_OWNER_MERGE,REMEDIATION_BUDGET_EXHAUSTED,REVIEW_INFRASTRUCTURE_BLOCKED,GENUINE_OWNER_DECISION_REQUIRED; every mid-flow stop maps to one of these (dispatch failure →REVIEW_INFRASTRUCTURE_BLOCKED; routing/owner-policy or material authority/architecture/security/scope decision →GENUINE_OWNER_DECISION_REQUIRED; 10/10 without approval →REMEDIATION_BUDGET_EXHAUSTED);BOUNDED_CORRECTIONis explicitly non-terminal; "APPROVE alone is insufficient" is stated and operationalized (exact-HEAD validation, green CI, acceptance criteria, zero unresolved blockers; HEAD movement voids approval)Independent Review1–2 freeze the exact PR HEAD and base per review, require a fresh, distinct, read-only session per substantive review, forbid session reuse after HEAD change and implementation-session self-review; item 3 tracks exactly the five required stages, excludes request acceptance/session status/prompt text/self-report as resolution evidence, and forbids silent reviewer substitution;Ledger And RemediationandFinishrequire a new full review after every changed HEADmax_remediation_cycles = 10initialized in the ledger and never reset; initial/fresh reviews and dispatch failures cost zero; aREQUEST_CHANGEScosts one only for valid in-scope changes (batched findings = one); invalid/duplicate/out-of-scope findings cost zero; after the tenth remediation a fresh review decides, never an eleventh change or autonomous budget extension; numbered ledger entries record cycle, reviewed HEAD, class, review reference + verdict, blocker IDs, remediation status, resulting HEAD,used / 10; at most two diagnosed corrected launch retries; failed attempts recorded only as invalid diagnosticsmaintargetingBOUNDED_CORRECTIONorGENUINE_OWNER_DECISION_REQUIRED, correction costing one cycle when changed; "Never widen scope or change acceptance criteria to obtain approval"; step 2: never modify/targetmain, never open a replacement PR, never auto-merge;Finish: issue stays open, PR unmergedmake checkandmake package-checkpass; PR todevelop; independent fresh reviewer assesses without mergingmake checkPASS (uv lock, ruff format/check, basedpyright 0 errors, lint-imports contracts kept, 142 tests passed, secret scan clean,git diff --check) andmake package-checkPASS (sdist/wheel rebuild, metadata/license, isolated smoke install). Required Forgejo CI run 26 (check) on6e29a5b: success. PR targetsdevelop(base sha06c374b). This review is that independent assessment; nothing mergedArchitecture / Information Flow
Preserve prior entries and finding identities); finite preauthorized budget with recorded exhaustion; no generic human-gate bucket (an ordinary defect does notstop delivery); acceptance is not merge.docs/architecture/delivery.md(develop-only branch/PR flow, requiredcheckCI) and.kilo/rules/10-task-system.md,20-forgejo-mcp.md,30-implementation-discipline.md(issue stays open until integration, nomain, no auto-merge, MCP for platform operations).Blocking Issues
None.
Non-blocking Suggestions
/review-pr"for each read-only review", but the architecture-correction review returnsBOUNDED_CORRECTION/GENUINE_OWNER_DECISION_REQUIRED, outside/review-pr'sAPPROVE | REQUEST_CHANGES | COMMENTvocabulary. Consider one clarifying clause that the architecture-correction dispatch is a distinct review contract to which/review-prguardrails (read-only, fresh, frozen HEAD) apply rather than its verdict format.Finish's "required evidence is temporarily unavailable" case names no explicit terminal mapping or bound.REVIEW_INFRASTRUCTURE_BLOCKEDalready covers inability to obtain "required verification evidence" after bounded attempts; stating that mapping explicitly would remove the reading of an indefinite non-terminal hold.Questions for the Author
None blocking.
Security / Privacy Notes
No secrets, credentials, private model/provider names, or routing details; the ledger explicitly excludes prompts, chain-of-thought, and transcripts and forbids publishing private routing details. Secret scan clean at the frozen HEAD.
Test / Documentation Gaps
No executable tests are applicable to a Markdown-only governance change; formatting/lint/link-hygiene/package gates cover the change. Remaining uncertainty (disclosed by the author, not verifiable in this context): live slash-command registration was not observed (editor hot-reload reported
No context found for instance; nokiloCLI installed). The frontmatter matches the existing command convention (.kilo/command/review-pr.md,implement-issue.md), so residual risk is low.Follow-Up Candidates
None durable; the two suggestions above are optional inline clarifications for a future governance pass, not follow-up issues.
Overall Recommendation
APPROVE — all five acceptance criteria of #15 are met at frozen HEAD
6e29a5b788e69ca3b7f175f1b5fc26ff9000c27b, repository gates and required CI are green, and no blocking defects were found. Per the contract under review, approval alone is insufficient for readiness: the delivery session must still record the ledger cycle and complete its exact-HEAD evidence verification; merge remains an owner action. Note for dispatch verification: this reviewer's Forgejo identity equals the PR author identity, so the platform cannot record anAPPROVED-state review for this PR; obtaining a platform-recorded approval requires a distinct reviewer Forgejo identity (owner policy/infrastructure, not a defect in this change).Substantive Recommendation: APPROVE
This is a conclusive independent full-PR review with no blocking findings, recorded as
COMMENTsolely because of a Forgejo identity limitation. I first submitted it asAPPROVED; Forgejo rejected that call withapprove your own pull is not allowed. The configured MCP identity iskilo, also the PR author, although this is a new independent reviewer session. This COMMENT is not a platform-recorded approval and cannot satisfy any required approving-identity rule. No protection is bypassed.PR Review
[Governance] Add bounded /deliver-issue command (#16)
Repository: Creatidy/creatidy-kernel
Author: kilo
Branch:
issue-15-deliver-issue->developFrozen HEAD:
eaf0211ce6f41c551b7650ce8cdfbf140a10b4f6Frozen base/merge base:
06c374be43fc0781912a16cba0788821d6973090Selected issue: #15, updated model-bound delivery contract
Scope: All three changed files and both included commits, not just the amendment or prior findings. PR metadata and the issue were re-fetched before submission; HEAD, base and issue contract remain unchanged. Earlier reviews #595/#596 apply to the old HEAD and were not reused as acceptance.
Blocking Issues
None found.
Acceptance Evidence
.kilo/command/deliver-issue.md:117-131requires exact-HEAD local validation, green required CI, issue acceptance and zero blockers, then enumerates only the four requested terminal conditions.deliver-issue.md:36-60contains the required JSON and explicit placement rules.AGENTS.md:47-49makes the binding always visible. Compared with the available Agent Manager schema; model discovery confirmsGPT-6 Astra, provideropenai, variantmaxare available. Availability is not proof of this session's dispatch.deliver-issue.md:66-80requires matchingResolved models:evidence, rejects self-report/session-state substitutes, excludes malformed/unresolved attempts from both cycle counts, limits corrected launch retries to two for the frozen HEAD, and forbids all specified fallback categories.deliver-issue.md:20-32,61-65,84-113covers explicit selection/resumption, same issue/branch/PR, preserved ledger and finding identities, zero-cost reviews/invalid findings, one cycle per valid remediation batch, correction review, a fresh review after the tenth remediation and no eleventh change. No automatic ordinary-blocker issues, merge or main target.successforeaf0211ce6f41c551b7650ce8cdfbf140a10b4f6. The unchanged.forgejo/workflows/ci.yml:39-46runsmake check,make package-checkandmake audit. Issue ledger comment 11615 records localmake checkPASS (142 tests),make package-checkPASS andgit diff --checkPASS. This is a new whole-PR assessment; nothing merged.CI reference: https://forgejo.creatidy.com/Creatidy/creatidy-kernel/actions/runs/27
Ledger evidence: #15 (comment)
Architecture Review
The change is confined to development guidance. It introduces no package/runtime dependency, domain state transition, Program execution exception, private implementation or product routing policy. The additional edit at
.kilo/rules/30-implementation-discipline.md:23-25is justified by the prior blanket Markdown routing prohibition and is narrowly scoped to this explicitly selected development-workflow binding. Inward dependencies and the public self-contained product boundary are unaffected.The separation of observations from acceptance, fresh exact-subject review, preserved findings, bounded corrections and genuine owner decisions aligns with ADR 0005:24-48. The development-only pin does not alter the replaceable product ports in ADR 0004. I inspected the authoritative local rules, the reused implement/review commands, README, Makefile, delivery/threat-model/target architecture, ADRs 0001/0004/0005 and repository tests. Normal approval, malformed dispatch, resumed ledger, remediation, recurring defects, tenth-cycle exhaustion, stale approval and unavailable-evidence paths were manually traced.
Non-blocking Suggestions
S1:
.kilo/command/deliver-issue.md:120-122requires bounded corrected attempts to obtain verification evidence but does not give that evidence-retrieval bound a number or explicitly reuse the launch retry limit. Naming a concrete bound would make separate sessions more consistent. The existing instruction already requires a finite stop and namesREVIEW_INFRASTRUCTURE_BLOCKED; this is a clarity improvement, not a blocker.Author Questions
None blocking.
Security Notes
No secret or private audit payload is introduced in the diff. The ledger excludes prompts, chain-of-thought and transcripts (
deliver-issue.md:88-91). A fresh local read-only session is a development-review convention, not a claim of hostile-worker isolation; the accepted security boundary is unchanged.Verification Limits
git diff --check 06c374be43fc0781912a16cba0788821d6973090...eaf0211ce6f41c551b7650ce8cdfbf140a10b4f6: PASS. The complete local Git diff matches the MCP diff; inspected files match the frozen commit and the checkout remains clean.Resolved models:receipt is not visible in this reviewer context. This report, model discovery and reviewer self-description cannot replace that receipt under the new contract; the dispatcher must verify it before recordingDISPATCH_VERIFIEDor final readiness.Follow-Up Candidates
None requiring a separate issue.
Overall Recommendation
APPROVE the full current PR at
eaf0211ce6f41c551b7650ce8cdfbf140a10b4f6, with no blocking source/governance findings. Recorded state is COMMENT solely because Forgejo rejected self-approval under the shared identity. This recommendation does not declareREADY_FOR_OWNER_MERGE, waive dispatch/evidence requirements or authorize integration. Issue #15 remains open and PR #16 remains unmerged.