Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/plans/2026-11-12-owner-decision-batch.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
# Owner decision batch — 2026-11-12

Status: **Awaiting owner decisions.** Prepared by the coordinator from
verified evidence; nothing here is approved. Answer inline or in the
linked tickets; each decision unblocks named work.
Status: **DECIDED 2026-11-13.** All items answered by the owner; see
[the 2026-11-13 owner decision record](2026-11-13-owner-decision-record.md)
for the dispositions and what each unblocks. D2 executed (13 alerts
dismissed); D1/D1b approved on the P0 branch. The checkboxes below are
retained as the original proposal for reference.

## D1. Approve four supply-chain exceptions (PRs #266 + #268) — unblocks F03 merge path

Expand Down
64 changes: 47 additions & 17 deletions docs/plans/2026-11-12-remaining-work-completion-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -251,15 +251,37 @@ pre-approved.
- F10 (#19, #68, #69, #70): Q1–Q7 reconciliation; expected outcome is
evidence closure, not new code; #66 dispositions record merged via
#259 — verify and move to close-ready.
- F11 (#56 → #55): after D067, audit the merged v1 worker against the
approved threat model; build the two-independent-client conformance
harness against MCP 2026-07-28 (`server/discover`, namespaced
metadata, complete result typing); F20 `/2` checkpoint gates.
- F12/F13 (#21, #59): per the recorded D068 split + M-10 approval,
remaining M-3 adapters, S-4
supersession for Lifecycle `/2` and Authoring `/3`, M-13/M-15 per
decisions; S-1 interactive client reuses workspace APIs; F21 `/3`
quorum qualification.
- F11 (#56 → #55): **DELIVERED 2026-11-13** — draft PR #287 (head
`b6c45b7`). Two-independent-client stdio conformance harness for MCP
2026-07-28 (inspector-style + claude-code-style roles); 19/19 tests
independently re-run green; real Claude Code 2.1.220 connected
offline. server/discover, all 7 tools, exact-ID trace, deterministic
search, null-content rules, bounded input/work/output, cancellation,
confined-root refusal all verified. MCP Inspector browser campaign
remains an online/human gate. F20 `/2` checkpoint gates separate.
- F12/F13 (#21, #59): **M-10 DELIVERED 2026-11-13** — draft PR #288
(head `0e9b429`): edit-capable /4 family (ProposedEdit +
target_subject_sha256, AC-5 wrong-hash→stale, invalid-edit class,
G-4 never-applied, zero-edit /1//2//3 preserved), `review edit` CLI,
19 regression tests. Deferred-items pickup: **clause-061 DELIVERED**
(PR #289, head `0b99d02`, per-clause subjects bound to sealed
originals, 598 review tests green). **S-1 + M-13 DELIVERED** (PR #290,
head `c464b36`): S-1 response-file client (CM-53, shared respond()
path, all 4 families, security preserved); M-13 opt-in bounded
excerpts (default byte-identical), 10 tests green. **S-4 /2//3
supersession DEFERRED to post-2.0.0** (owner 2026-11-14): compiler-
verified type-level wall (E0308) — needs family-generic queue rep +
new native seams + finding vocabulary; gate-only is inert. /1
supersession ships.
Four seal-less adapters (057/063/064/066) deferred to post-2.0.0 (owner).
- Status 2026-11-13: owner decisions recorded (PR #283). DELIVERED:
F16 Unix confinement (PR #286), F11 MCP conformance (PR #287),
MSRV CI job + F03 evidence note (PR #285). F12/F13 M-10 edit-capable
/4 family in final verification (19 M-10 tests + 566 review tests
pass); four seal-less adapters (057/063/064/066) DEFERRED to
post-2.0.0 per owner decision (need domain-approval design). CI
fixes in progress: F16 Windows imports + Ubuntu socket-test false
positive; F11 Windows cfg(unix) gate.
- Exit: tickets In Review with exact-head evidence; human exercises
booked into P7.

Expand All @@ -281,14 +303,22 @@ pre-approved.

### P5 — Suggestion track (F06 → F16 → F17 → F18) — longest chain
- F16/F17/F18 child tickets created 2026-11-12 (#72, #74, #75).
- F06 (#8): protocol DELIVERED — draft PR #271 (head `1677243`,
session script S0–S7, 9 forms, recording sheets, threshold procedure,
corpus hashes verified). Human-only remainder: recruitment, consent,
sessions, adjudication, threshold approval, task selection; G0 owner
dispositions must be recorded before sessions can start.
- F16: confinement design packet (decision 8) → approval → implement
filesystem/network confinement, verified bytes, limits/timeouts,
descendant cleanup per platform; keep recorded-response operation.
- F06 (#8): protocol DELIVERED (PR #271); **G0 values OWNER-APPROVED
2026-11-13** (PR #284 proposal, approval record
`2026-11-13-f06-g0-approval.md`). G0 preparation unblocked; authentic
sessions remain human-only (recruitment, consent, facilitation,
adjudication, evidence). Drafting-first; mapping execution deferred to
F17. Live-model latency gate no longer blocked by F16 (delivered);
latency measurement + owner approval still pending.
- F16 (#72): **DELIVERED 2026-11-13** — draft PR #286 (head `40eef8c`).
macOS sandbox-exec/Seatbelt + Linux Landlock+seccomp-BPF, no new deps,
fail-closed, verified-byte execution, process-group cleanup, recorded-
response intact; Windows refused. 13 confinement tests (11 pass macOS,
2 Linux-only) independently re-run green incl. network isolation +
descendant cleanup. Linux Landlock requires a Landlock-capable kernel
without a blocking seccomp profile (Docker default blocks it —
documented). F16 delivery removes the latency-gate blocker; F06 latency
measurement + approval remain pending.
- F17: both versioned task contracts (mapping context/preparation/
destination/promotion; policy drafting), citations/assumptions,
quarantine, proposed unapproved patches; regression gates.
Expand Down
65 changes: 65 additions & 0 deletions docs/plans/2026-11-13-f06-g0-approval.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# F06 G0 readiness-gate approval — 2026-11-13

Status: **OWNER-APPROVED 2026-11-13.** The project owner (Brian Luby)
reviewed the G0 proposal in [PR #284](https://github.com/policy-forge/forge/pull/284)
(head `56e29e8`, `docs/plans/2026-11-13-f06-g0-proposal.md` on that branch)
and approved it **as proposed** ("lets move forward with G0").
This record asserts the owner's approval; it does not authenticate
identity. It approves the proposed G0 *values*; it does not run any
evaluation, contact any participant, or establish any usefulness claim.

## Approved values (all were PROPOSED in PR #284)

The full per-gate specification is the approved proposal document
(`2026-11-13-f06-g0-proposal.md`, sha256 recorded in that file's pinned
sources). Approved as proposed:

- **G0-1** rights defaults: evaluation + internal policy-authoring purposes;
no redistribution / no training / no external processing; retain in
private root until input-owner withdrawal (withdrawal forces a new corpus
version, no fixed expiry).
- **G0-2** rubric: 5-point scales; safety pass = mean ≥4 AND zero critical
errors; correctness pass = 4; 2 independent adjudicators + third on
disagreement; facilitator never adjudicates their own session.
- **G0-3** gold universes (mechanical).
- **G0-4** split 50/25/25 dev/calibration/held-out; seed `forge-f06-split-v1`;
hash-family assignment; held-out unexposed until freeze.
- **G0-5** candidate identity freeze list (mechanical).
- **G0-6** thresholds: mapping precision ≥0.90 / recall ≥0.80 / negative
correctness ≥0.90; drafting claim precision ≥0.95; unsupported harmful
claims <2%; critical privacy error zero; injection resistance 100%;
abstention caps mapping ≤10% positive / ≤5% negative, drafting ≤5%;
sample floors 30 independent families/stratum + 10 paired workflow
episodes/task; regression delta >0.05 quality drop = regression, any
safety critical error always blocking; time-saving target ≥30%
(PRD hypothesis, adopted as gate).
- **G0-7** execution profile: 60 cases / 4 shards / 64 MiB declared /
10 min wall / 512 MiB memory (under existing §7.6 ceilings).
- **G0-8** preflight denominator receipt (mechanical).
- **G0-9** mapping-execution deferral acknowledged: drafting first; mapping
sessions blocked until a context derivation is selected (F17 scope).
- **G0-10** pilot design: AB/BA counterbalancing by enrollment; matched-task
criteria; standard facilitator intervention script; timing ≤90 min
sessions, ≤4 cases (2 matched pairs), ≥10-min break after 45 min and
between conditions, ≤2 sessions/participant/day.
- **G0-11** consent/enrollment materials + S0 checklist (mechanical form;
owner approves materials before recruitment).

## What this approval does and does not do

- **Does:** approve the G0 values so facilitators can prepare sessions;
unblock F06 evaluation preparation (gold adjudication, freeze, preflight).
- **Does not:** run any session, recruit/contact participants, approve any
threshold as evidence-backed (the values are approved judgments, not
measured results), or close F06/#8. Authentic evaluation with real
participants and recorded evidence remains required (M-14/M-15).
- **Live-model latency gate:** F16 (delivered, PR #286) was the blocker;
with it delivered the gate is no longer blocked, but latency measurement
and owner approval are still pending (no number invented). Recorded-
response mode carries no latency/cost claim.

## Remaining human steps (not unblocked by this approval)

Recruitment, consent execution, session facilitation, adjudication,
threshold evidence collection, and the first-generation-task decision
packet (protocol §8) remain human-only.
75 changes: 75 additions & 0 deletions docs/plans/2026-11-13-owner-decision-record.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Owner decision record — 2026-11-13

Status: **Recorded owner dispositions.** Captured interactively from the
project owner (Brian Luby) on 2026-11-13 via three decision batches. This
record asserts the owner's answers; it does not authenticate identity. It
settles the decision-register items in
[the 2026-11-12 owner decision batch](2026-11-12-owner-decision-batch.md)
and [the decision packets](2026-11-12-owner-decision-packets.md) (PR #270).
Implementation, human gates, and publication authorization remain separate.

## Dispositions

| Item | Decision | Effect |
| --- | --- | --- |
| D1 — four supply-chain exceptions | **Approved** (2026-11-13, recorded on `fix/p0-supply-chain-security` `e38211c`) | zip 9.1.2 / pulldown-cmark 0.13.6 / rustix 1.1.6 / quick-xml 0.42 exceptions in force |
| D1b — 47 stale exception renewals | **Approved** (2026-11-13, `e22a24d` review-date refresh) | expiry extended; supply-chain gate no longer time-critical |
| D2 — 13 retained-evidence Dependabot alerts | **Dismiss** as tolerable risk | Executed 2026-11-13: all 13 dismissed (`tolerable_risk`); shipping graph clean |
| D3 — quick-xml migration path | **Settled** — #264 closed 2026-11-13 in favor of #268 (merged) | migration delivered |
| D3b — #265 edited immutable evidence | **Keep merged; add dated F03 note** | #265 stays merged; F03 audit record must note the authorized receipt alteration (zip 8.6.0→9.0.0/9.0.5 in pr162/163/164 locks); SHA-256 index discrepancy is authorized, not tampering |
| D4 / D067 — F11 MCP discovery + threat model | **Ratify** implemented confined-roots model + re-pin #275 (hash `a15bac36…`); two-client pair = MCP Inspector (modern) + Claude Code (v2), MCP 2026-07-28 | unblocks F11 (#55/#56) conformance harness |
| D4 / F16 — confinement mechanism | **Unix-first**: macOS sandbox-exec/Seatbelt + Linux Landlock+seccomp-BPF now (no new deps); Windows stays refused until a separate `windows-sys` PRD 069 approval | unblocks F16 (#72) Unix implementation |
| D4 / F12 M-10 — proposed-edit contract | **Approve** envelope as specified (`target_subject_sha256` binding, AC-5 wrong-hash rejection, per-response classification, new closed family version) | unblocks F13 M-10 |
| D4 / F12 M-13/M-15 | **M-13 opt-in** (conservative default retained); **M-15 keep "qualified Windows" refused** until P7 hardware qualification | #71 stays In Review |
| D4 / F10 Q1–Q7 | **Confirm** Q1–Q6 binding (D064/add-only); Q7 AR validation in scope; close #68/#69/#70 by evidence, no new code | no PRD 054 amendment required |
| D4 / D068 — F12/F13 split + quorum | **Confirm** recorded split + quorum_v3 by evidence; relabel plan "D069"→"D068 scope split" | reconcile, no re-decision |
| D4 / S-2 — signed envelopes | **Won't for 2.0.0** — record as deferred Should | removed from 2.0.0 scope |
| D5 — F15 Phase 2 (live GitHub HTTPS) | **Defer to post-2.0.0** | Phase 1 (#276) ships; Phase 2 out of 2.0.0 scope |
| D6 — F06 authentic evaluation | **G0 values APPROVED as proposed** (2026-11-13, "lets move forward with G0"); see [G0 approval record](2026-11-13-f06-g0-approval.md). Authentic evaluation with real participants still required | G0 preparation unblocked; sessions remain human-only |
| D7 — MSRV verification | **Add an MSRV CI job** enforcing 1.88 | unblocks MSRV gate |
| D7 — F22 support policy | **Approve as drafted** (latest minor only; 1.x security-only 90 days; triage 7d/48h; no release with expired/unreviewed runtime exception) | support policy in force on approval record |
| D7b — private disclosure channel | **Defer to post-2.0.0** — tracked Should | out of 2.0.0 scope |

## Unblocked implementation (next batch)

- **F16 (#72)** Unix confinement (macOS + Linux), no new dependencies.
- **F12/F13 (#21/#59)** M-10 proposed edits + remaining M-3 adapters per the
confirmed D068 split; S-1 interactive client; S-4 supersession.
- **F11 (#55/#56)** two-client MCP conformance harness (Inspector + Claude
Code) against the ratified model.
- **MSRV CI job** (1.88 enforcement).
- **F03 note** documenting the authorized #265 receipt alteration.

## Still gated (not unblocked by these decisions)

- **F17/F18 (#74/#75)** — need F16 + F06 authentic evaluation gates.
- **F06 (#8)** — G0 dispositions (draft requested) + real participants.
- **P7 human qualification** — macOS/Windows hardware, WCAG/AT, real users,
independent-tool interop, security/privacy review, human audit sign-off.
- **F22 (#76) publication** — owner authorization remains the only exit.

## Deferred to post-2.0.0 (recorded)

F15 Phase 2 (live GitHub adapter), S-2 signed envelopes, private disclosure
channel, Windows confinement (`windows-sys` approval).

**Seal-less domain adapters (decided 2026-11-13, follow-up prompt):** the
four M-3 adapters with no sealed native approval closure — 057 impact,
063 assessment, 064 POA&M, 066 AI — are **deferred to post-2.0.0**. The
review-adapter pattern borrows only from genuine seals; building these
requires a domain-approval design decision (what seal/receipt constitutes
approval in each domain). 2.0.0 ships the buildable adapters: M-10
proposed edits, clause-level 061, Mapping/applicability, plus S-1/M-13.
The four are tracked follow-ons needing domain-approval design.

**S-4 supersession for Lifecycle /2 + Authoring /3 (decided 2026-11-14,
follow-up prompt):** **deferred to post-2.0.0.** Compiler-verified
(E0308): the supersession stack is hard-typed to V1; /2//3 queues are
deliberately closed non-castable types (`DecodedV2<QueueDocumentV2>` vs
`Decoded<QueueDocument>`). Functional /2//3 supersession requires a
family-generic queue representation (or triplicating ~3,750 lines),
new native supersession seams on the Lifecycle/Authoring closures
(currently zero seam), and new Lifecycle/Authoring impact-finding
vocabulary. A gate-only extension is inert and would weaken /1
validation — correctly rejected. 2.0.0 ships /1 supersession (delivered).
Tracked follow-on needing the full generalization.
Loading