process-hooks — soft deterministic guards at the moment of the event - #89
Merged
Conversation
added 7 commits
September 2, 2026 14:13
…oment of the event, soft first
…t observable, fallback pending
…(2.1) H1 leak-stamp (PostToolUse Edit|Write) reuses the leak-gate signatures via a new --print-patterns mode; H2 harbor-marker reminder (PreToolUse Edit|Write) guards the installer-owned AGENTS.md block; H3 quiet session brief (SessionStart startup|resume) injects context only when the harbor queue or the change list is non-empty. Soft phase: no exit 2 anywhere, silent on the happy path. Envelope and payload keys remain assumptions until a live firing (task 1.1 spike checklist).
Pointers only: the three soft hooks by path, the protocol rule each serves (leak-gate; the installer-owned harbor block; J1), the soft phase (warn, never block; CI stays the done-bar), and the two D1 escalation triggers.
…probing, battery green (task 4.1)
…sty note, socratic edits applied
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Openspec change
process-hooks(dev-process tooling, no product behavior changes). Three soft hooks, each naming the protocol rule it serves:PostToolUse Edit|Write): flags the touched file on leak-gate signatures — the class of failure a review caught inprocess-fabriconly after the fact. Signatures stay single-homed inscripts/leak-gate.sh(--print-patterns, now stdout — dedupe per socratic).PreToolUse Edit|Write, root AGENTS.md only): the installer-owned block between the harbor markers; hand edits there are reverted on install.SessionStart): harbor queue + active changes, injected only when non-empty (design D2;buildBriefnull-on-all-quiet is unit-tested).Wiring: tracked
.zcode/config.json,hooks.enabled: true, process-type hooks via${ZCODE_PROJECT_DIR}.Honesty
The spike (task 1.1) could not confirm workspace-config loading from inside one session — verdict FALLBACK PENDING, carried honestly: the wiring is inert if never loaded, nothing exits 2 anywhere, and
docs/workflow.mdsays live loading is unconfirmed. Next-session checklist lives inreports/task-1-spike-report.md(hookCount at bootstrap, first-edit probe, H3 briefing).Verification
bun test373 pass / 0 fail (378 total, 5 environmental skips), tsc core+acceptance,validate --specs --strict10/10,validate --changes --strict1/1, skill checks, leak-gate.reports/task-2.1-report.md; post-fix H2 root/nested and leak-stamp end-to-end re-verified.Merge prep:
@portolan/core0.4.2 → 0.4.3, CHANGELOG entry.