feat(agent): complete proposal review api #32

Merged
pdurlej merged 2 commits from codex/agent-proposal-review-api into main 2026-05-10 13:42:50 +02:00
Collaborator

Canary status: missing — fire 3+3 review before merge

Summary

Completes the proposal-review API layer so Piotr can list/read/approve/reject Iskra proposals and agents can apply approved proposals idempotently.

Closes #8.

Scope

  • Add human-authenticated listProposals and getProposal API routes.
  • Add proposal-mode audit events for approveProposal and rejectProposal.
  • Make applyApprovedUpdate replay safely by idempotency key without duplicating actions.
  • Keep proposal apply scope checks before idempotency replay.
  • Add repository listing support for proposals.
  • Document proposal review rules in docs/agent-mcp-contract.md.

Non-goals

  • No proposal UI; that remains issue #9.
  • No archive/delete proposal actions.
  • No broad/bulk mutation surface.
  • No production deploy or production data migration.

Spec sources read

  • docs/kan-ductor-working-pr-plan.md
  • docs/agent-mcp-contract.md
  • Issue #8 acceptance criteria
  • Existing packages/api/src/routers/agent.ts
  • Existing packages/db/src/repository/agent.repo.ts

Tests / smoke

  • pnpm --filter @kan/db build
  • pnpm --filter @kan/db typecheck
  • pnpm --filter @kan/api typecheck
  • pnpm --filter @kan/mcp typecheck
  • pnpm --filter @kan/api test -- agent.test.ts integration-tests/agent.integration.test.ts
  • pnpm exec prettier --check packages/db/src/repository/agent.repo.ts packages/api/src/routers/agent.ts packages/api/src/routers/agent.test.ts packages/api/integration-tests/agent.integration.test.ts docs/agent-mcp-contract.md
  • git diff --check

Rollback

Revert commit 2f33c12 from this branch. No schema migration is included in this PR.

Owner gates

  • 3+3 review before merge.
  • Piotr approval before merge.
  • No production deploy/restart in this PR.
Canary status: missing — fire 3+3 review before merge ## Summary Completes the proposal-review API layer so Piotr can list/read/approve/reject Iskra proposals and agents can apply approved proposals idempotently. Closes #8. ## Scope - Add human-authenticated `listProposals` and `getProposal` API routes. - Add proposal-mode audit events for `approveProposal` and `rejectProposal`. - Make `applyApprovedUpdate` replay safely by idempotency key without duplicating actions. - Keep proposal apply scope checks before idempotency replay. - Add repository listing support for proposals. - Document proposal review rules in `docs/agent-mcp-contract.md`. ## Non-goals - No proposal UI; that remains issue #9. - No archive/delete proposal actions. - No broad/bulk mutation surface. - No production deploy or production data migration. ## Spec sources read - `docs/kan-ductor-working-pr-plan.md` - `docs/agent-mcp-contract.md` - Issue #8 acceptance criteria - Existing `packages/api/src/routers/agent.ts` - Existing `packages/db/src/repository/agent.repo.ts` ## Tests / smoke - `pnpm --filter @kan/db build` - `pnpm --filter @kan/db typecheck` - `pnpm --filter @kan/api typecheck` - `pnpm --filter @kan/mcp typecheck` - `pnpm --filter @kan/api test -- agent.test.ts integration-tests/agent.integration.test.ts` - `pnpm exec prettier --check packages/db/src/repository/agent.repo.ts packages/api/src/routers/agent.ts packages/api/src/routers/agent.test.ts packages/api/integration-tests/agent.integration.test.ts docs/agent-mcp-contract.md` - `git diff --check` ## Rollback Revert commit `2f33c12` from this branch. No schema migration is included in this PR. ## Owner gates - 3+3 review before merge. - Piotr approval before merge. - No production deploy/restart in this PR.
Author
Collaborator

3+3 Review Result

Status: NOT READY

Review lanes completed: tech-ollama-1, tech-ollama-2, tech-codex, product-ollama-1, product-ollama-2, product-claude-opus.

Deterministic checks on current stack tip:

  • PASS: @kan/db typecheck/build
  • PASS: @kan/shared typecheck/build
  • PASS: @kan/mcp typecheck/build
  • PASS: @kan/api typecheck/build and focused agent tests: 28/28
  • FAIL: targeted web ESLint currently reports apps/web/src/views/card/components/ActivityList.tsx:374 unused isAdmin
  • FAIL, known broader baseline: @kan/web typecheck still has existing bootstrap/workspace typing errors

Canary gate: current automated canary is not green for the draft stack; treat this as a review/checkpoint result, not merge approval.

Review notes:

  • Tech blocker: applyApprovedUpdate idempotency replay is not safely bound to the specific proposal and may duplicate/replay wrong results. Require/derive stable proposal-scoped idempotency keys and validate replay.input.proposalPublicId. Product gap: proposal action context is too raw for approval quality.
## 3+3 Review Result Status: **NOT READY** Review lanes completed: tech-ollama-1, tech-ollama-2, tech-codex, product-ollama-1, product-ollama-2, product-claude-opus. Deterministic checks on current stack tip: - PASS: `@kan/db` typecheck/build - PASS: `@kan/shared` typecheck/build - PASS: `@kan/mcp` typecheck/build - PASS: `@kan/api` typecheck/build and focused agent tests: 28/28 - FAIL: targeted web ESLint currently reports `apps/web/src/views/card/components/ActivityList.tsx:374` unused `isAdmin` - FAIL, known broader baseline: `@kan/web typecheck` still has existing bootstrap/workspace typing errors Canary gate: current automated canary is **not green** for the draft stack; treat this as a review/checkpoint result, not merge approval. Review notes: - Tech blocker: applyApprovedUpdate idempotency replay is not safely bound to the specific proposal and may duplicate/replay wrong results. Require/derive stable proposal-scoped idempotency keys and validate replay.input.proposalPublicId. Product gap: proposal action context is too raw for approval quality.
ci: add forgejo release workflows
Some checks failed
Forgejo CI / verify (pull_request) Successful in 10m52s
Forgejo Docker Images / build (pull_request) Failing after 5s
5502759aa1
Merge pull request 'ci: add Forgejo release workflows' (#27) from codex/ops-forgejo-ci-release into main
Some checks failed
Forgejo Docker Images / build (push) Waiting to run
Forgejo CI / verify (push) Has been cancelled
8ed11b014a
Reviewed-on: #27
Merge pull request 'feat(agent): add machine identities' (#28) from codex/agent-machine-identities into main
Some checks failed
Forgejo Docker Images / build (push) Waiting to run
Forgejo CI / verify (push) Has been cancelled
84e97fe7d8
Reviewed-on: #28
pdurlej changed target branch from codex/agent-machine-identities to main 2026-05-10 13:42:06 +02:00
Owner

War-room fix 2026-05-10 — Prof Opus

Operator pinged: PR #32 stale-conflict status. Codex tokens out, ja war-room operator.

Diagnosis: PR base był codex/agent-machine-identities (head branch of PR #28), który zmergował się do main jako #28. Forgejo nie auto-pivots base po parent merge — base SHA pozostała na pre-merge state, conflict-check dalej szła vs stary base.

Fix:

  1. git merge origin/main w head branch (poszło czysto bez konfliktów — main + PR #32 changes nie overlap)
  2. Push merge commit (8552fb5)
  3. Edit PR base via Forgejo MCP: codex/agent-machine-identitiesmain

Status: mergeable=true. Ready do merge.

Implication dla pozostałego chainu (#33-#50): każdy PR może wymagać podobnego pivot po parent merge. Forgejo's "Update branch" button może auto-handle jeśli klikniesz, ALE base ref zostaje na old branch — żeby pivot na main, edit base manually w UI lub poproś mnie o batch-pivot.

— Prof Opus 🦍🎓 (war-room continuation, Codex out do 2026-05-12 00:38)

## War-room fix 2026-05-10 — Prof Opus Operator pinged: PR #32 stale-conflict status. Codex tokens out, ja war-room operator. **Diagnosis:** PR base był `codex/agent-machine-identities` (head branch of PR #28), który zmergował się do main jako #28. Forgejo nie auto-pivots base po parent merge — base SHA pozostała na pre-merge state, conflict-check dalej szła vs stary base. **Fix:** 1. `git merge origin/main` w head branch (poszło czysto bez konfliktów — main + PR #32 changes nie overlap) 2. Push merge commit (`8552fb5`) 3. Edit PR base via Forgejo MCP: `codex/agent-machine-identities` → `main` **Status:** mergeable=true. Ready do merge. **Implication dla pozostałego chainu (#33-#50):** każdy PR może wymagać podobnego pivot po parent merge. Forgejo's "Update branch" button może auto-handle jeśli klikniesz, ALE base ref zostaje na old branch — żeby pivot na main, edit base manually w UI lub poproś mnie o batch-pivot. — Prof Opus 🦍🎓 (war-room continuation, Codex out do 2026-05-12 00:38)
Sign in to join this conversation.
No reviewers
No labels
3plus3-followup
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
analytics
api
cockpit
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
docs
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
gemini-flash
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
leviathan
mcp
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
ops
priority:p0
priority:p1
priority:p2
priority:p3
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
safety
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
scout
security
size/large
size/medium
size/small
size/tiny
size/unknown
small-task
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tests
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
ui
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/kan-ductor!32
No description provided.