Skip to content

docs: state HQ proof boundaries for W3-08 and consumers - #251

Merged
mergify[bot] merged 2 commits into
mainfrom
claude/hq-proof-boundaries
Oct 3, 2026
Merged

mergify[bot] merged 2 commits into
mainfrom
claude/hq-proof-boundaries

Conversation

@Cuarroc

@Cuarroc Cuarroc commented Oct 3, 2026 •

Copy link
Copy Markdown
Owner

Dieses Paket dokumentiert in zwei Dateien die Grenzen der HQ-Belege.
Es beschreibt die später nötige Prüfung der laufenden App sowie die Aussagekraft von Kontext, Cursor und Manifest-Fingerabdruck.
Der Koordinator hat die Dokumentation und die grünen Tests am veröffentlichten Commit geprüft; W3-08 selbst bleibt offen.

Report

Scope: docs/ci-lokal.md (German, new W3-08 proof-path section) and docs/dev-hq/README.md (English, new consumer-boundaries section). No .pa/spec/PLAN/source/gates/config/schema/test/CI changes. Tier C, pure documentation.

Base / head: base 1334b70a0e05de018270369ee57d6a77a2dcf010 (current main, PR #246 merged; ci and Push on main for that SHA were completed/success when checked). Final head 0b59019c8f970c4edfe8942fce8573df83b47c8f, verified with git ls-remote. Diff: 2 files, +68/-0. Latest commit corrects the field name: the compiled LF-normalised agent-defaults fingerprint is returned as provenance.builtinManifestSha256 (no manifestFingerprint property exists); pa hq changes --project <id> is unchanged. The fingerprint is a limited byte fingerprint only, not proof of the whole Git SHA, model, credentials, production signing or install.

Evidence:

  • bash scripts/ci/gates.sh lane prepush in the own worktree at new committed head 0b59019, clean tree before/after, direct exit 0, 81 s gate summary / 83 s wall time (11 gates green; rust-suite 1705 passed, 7 skipped, 41 s). Log: /tmp/hqpb-prepush.log on the worker host. The earlier a9fce06 gate run is not reused. Start check: model Sonnet 5.5 as reported by the harness, ~14.7 GiB RAM available, 0 other cargo builds; provider quota not observable from this worker.
  • precommit hook on the commit: exit 0 (secrets, fmt, cargo-check, typecheck green).
  • git push -u origin claude/hq-proof-boundaries: exit 0.
  • node_modules was linked (symlink, not installed) from an existing worktree whose package.json and package-lock.json are byte-identical (cmp); npm ls showed no missing/invalid packages.

No-Test: pure documentation. The proposed doctor/runtime commands (npm run dev:doctor -- --json, pa hq runtime) are instructions for a later proof, not observations; they were not run and the app was not started.

NICHT ABGEDECKT:

  • #[cfg(windows)] tests and the Windows arms of clippy (Linux run only; Windows lane runs in the merge queue).
  • Browser smoke, frontend build and workflow gates (only in lane linux); full Linux workflow in CI not observed for this head.
  • External services (updater endpoint, OmniRoute, mirror).
  • Actual app, visual and runtime behaviour: nothing was started or measured. W3-08 itself stays open; no claim it is complete.

Review disposition — Tier C (coordinator)

ACCEPT for exact candidate 0b59019c8f970c4edfe8942fce8573df83b47c8f, 2026-10-03 23:00 CEST. Root inspected the complete +68/-0 two-document patch and the two-line correction delta. Existing CLI parser confirms pa hq changes --project <id> is valid; the field is accurately named provenance.builtinManifestSha256. Root rejected its earlier unsupported missing-CLI-command hypothesis after reading the full parser; no erroneous flag was introduced.
Root read the complete continuation author log and new 278584-byte gate log, header HEAD0b59019, direct EXIT=0, own clean worktree before/after and unchanged SHA. Secret precommit passed; foreground push=0 and remote full SHA match. Old a9fce06 gates are not reused. Native admission quota 22:53 Claude 10% session/31% weekly/10% Fable used was observed by Root; worker could not independently observe provider quota. Actual continuation CLI init Claude Sonnet5.5 confirmed.
Pure documentation, no source/tests/config/schema/PLAN/installation changes; No-Test: pure documentation is valid. No external review required. No unresolved introduced finding. Ready is authorized through Mergify only while main stays green; actual merge/real Windows verdict still pending.

Add the installed-build proof path (running executable, HQ v1,
manifest.state matched at the build commit) to ci-lokal.md and the limits
of runtime/context/cursor queries to the dev-hq README. Proposed commands
are instructions for a later proof, not observations.

No-Test: pure documentation
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@Cuarroc Cuarroc added the do-not-merge Keep this pull request out of the merge queue label Oct 3, 2026
Replace the non-existent manifestFingerprint with the real
provenance.builtinManifestSha256 field in the dev-hq README and the
ci-lokal example comment. Pure documentation; no code changes.

No-Test: pure documentation
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@Cuarroc
Cuarroc marked this pull request as ready for review October 3, 2026 21:00
@Cuarroc Cuarroc removed the do-not-merge Keep this pull request out of the merge queue label Oct 3, 2026
@mergify

mergify Bot commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Queued — the merge queue status continues in this comment ↓.

@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: 0b59019c8f

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

Comment thread docs/ci-lokal.md
Comment on lines +160 to +163
```sh
npm run dev:doctor -- --json # ohne --apply; Zeile "runtime" lesen
pa hq runtime # profilesPath, capabilities, provenance.builtinManifestSha256
```

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 Binde den Beleg an die installierte ausführbare Datei

Wenn ein Entwicklungsbuild oder eine andere Installation dieselbe agent-defaults.json enthält, liefern diese Befehle HQ v1 und manifest.state: matched, obwohl weder dev:doctor noch pa hq runtime den Prozesspfad oder Hash der laufenden EXE erfasst. Damit lassen sich die unmittelbar zuvor geforderten Punkte 1 und 4 nicht nachweisen, und W3-08 könnte gegen das falsche Binary abgenommen werden. Ergänze einen beobachteten Prozesspfad/EXE-Hash samt Bindung an Paketartefakt oder Build-Commit und stelle sicher, dass beide Befehle denselben Descriptor verwenden.

AGENTS.md reference: AGENTS.md:L40-L43

Useful? React with 👍 / 👎.

@Cuarroc

Cuarroc commented Oct 3, 2026

Copy link
Copy Markdown
Owner Author

@Mergifyio queue

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-03T21:08:52.953631Z 0b59019 Draft marked ready
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@mergify mergify Bot added the queued label Oct 3, 2026
@mergify mergify Bot mentioned this pull request Oct 3, 2026
11 tasks done
@mergify
mergify Bot merged commit 4050077 into main Oct 3, 2026
15 checks passed
@mergify
mergify Bot deleted the claude/hq-proof-boundaries branch October 3, 2026 21:22
@mergify

mergify Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 12 minutes 50 seconds in the queue, including 12 minutes 36 seconds running CI.

Required conditions to merge

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