Skip to content

spec: confirmation queue, recall provenance labels, widened activity aperture - #294

Draft
equationalapplications wants to merge 26 commits into
mainfrom
spec/user-confirmation-queue
Draft

equationalapplications wants to merge 26 commits into
mainfrom
spec/user-confirmation-queue

Conversation

@equationalapplications

Copy link
Copy Markdown
Owner

What

Rev-1 spec for the pending-user-confirmation queue, per Kurt's rulings of 2026-10-20/21 (all decisions resolved — S1/S2, Active Verification Prompting ruling, D1–D8).

Spec: docs/superpowers/specs/2026-10-20-user-confirmation-queue-design.md

Covers: deposit-file attribution carrier; the unverified-facts queue (app-only confirm, read-only MCP queue list); Active Verification Prompting modal; recall provenance labels (ct wisdom match untouched); #282 §5 rev-15 delta (activity aperture admits user_stated + user_confirmed, immutable_document excluded); Path B stated/<author>/<year>/ attested-file pipeline; full INTENT.md amendment text (Rules 2/3/8, new Rule 10, glossary, new \u201cWho verifies: users and scope\u201d section).

Provenance

  • Investigation backbone: tier-4 Fable guidance memo, run 1 (2026-10-20, $5.65) — vault records/investigations/2026-10-20-confirm-queue-fable-consult/memo-run1.md (vault is outside this repo)
  • Decision log: vault immutable-source-files/agents/memories/confirm-queue-aperture-decision-2026-10-20.md
  • Prior handoff: records/handoffs/2026-10-19-handoff-user-confirmation-queue.md (vault)

Review plan (per dual-review-cycle; this PR stays DRAFT until implementation completes)

  • Self-review (placeholder scan, internal consistency, spec-vs-INTENT alignment)
  • Tier 2: GLM 5.3 spec review
  • Tier 3: Opus spec review (--doc with INTENT.md + code context)
  • Tier 4: Fable spec-approval gate (post-convergence, budget to be announced)
  • Kurt spec approval (gates planning — no implementation before it)

Per the delivery flow: spec + plan + implementation all travel in this ONE PR; nothing merges until implementation is done and reviewed (curated-thoughts: regular merges only).

@coderabbitai

coderabbitai Bot commented Oct 21, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@aws-cloud-agent-pr-review

aws-cloud-agent-pr-review Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

✅ Reviewed 60a652d — 1 finding posted inline

Last run: 2026-10-21 21:21 UTC

Kurt VanDusen added 17 commits October 21, 2026 08:01
…le channel (M1), deny suppression (M2), minors
…-spoof, durability/sync), ruling R-B remote-verification roadmap
…mations.jsonl durability (B2), removed-tool premise (M1), sibling-safe deny key (M3), confidence ordinal (M4), per-hit source_type labels (M5), direct-write retirement (M6), minors
…struction handles, content-hash rebuild match, ledger ingest tier)
…ute E2 deferral and Low findings to Task 11
…; route Low-1 test gap to Task 11, close N+1 in Task 7

@aws-cloud-agent-pr-review aws-cloud-agent-pr-review 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.

Adds a human-tier gate and confirmation queue infrastructure. The diff correctly implements the spec's human/agent tier separation and read-only queue query, but introduces a potential data integrity issue in the deposit_attribution index where a missing speaker value would violate the NOT NULL constraint.

-- carrier; this table is a derived brain-side cache keyed by document path,
-- written inside the same audit_and_seed_kick transaction as the audit and
-- kick-ledger rows (wisdom_deposit.rs). A re-ingest repopulates the index
-- from the file.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Advisory. This bot's findings are usually wrong (measured precision ~2–5%). No reply needed. If you do check it: reply false: <one-line reason> if it's wrong, or fix it and say so if it's right.

major · data-integrity

deposit_attribution speaker column is NOT NULL but the spec allows None.

Failure scenario: A deposit with an empty or missing speaker (e.g., via a malformed frontmatter or a future spec change) causes the INSERT to fail with a constraint violation, breaking the deposit pipeline.

Suggested fix: Change the column definition to speaker TEXT (nullable) to match the spec's allowance for missing attribution, or add a runtime guard to reject deposits without a speaker.

@aws-cloud-agent-pr-review aws-cloud-agent-pr-review 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.

Adds a human-tier surface flag to resolve options and a read-only MCP queue list. The diff adds a guard for the flag but does not enforce it in the commit logic, and the MCP tool description is inconsistent with the spec's 'app-only' rule.

/// ONLY when this flag is `true` AND `auto_approve` is `false`. Set ONLY
/// by the desktop app's resolve path (`proposals_api.rs`); CLI, MCP, and
/// internal-API approvals resolve at agent tier (`librarian_inferred`)
/// and write an `approved_at_agent_tier` event. Never derived from a

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Advisory. This bot's findings are usually wrong (measured precision ~2–5%). No reply needed. If you do check it: reply false: <one-line reason> if it's wrong, or fix it and say so if it's right.

major · logic-flaw

human_surface flag is not enforced in commit logic

Failure scenario: When human_surface is true, the code does not guarantee that user_confirmed provenance is stamped; the flag is only used in review_shim.rs and proposals_api.rs, not in the actual commit transaction.

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