@chrono-meta/fh-gate 1.4.75 → 1.4.76

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -11,13 +11,13 @@
11
11
  "plugins": [
12
12
  {
13
13
  "name": "fh-meta",
14
- "version": "1.4.75",
14
+ "version": "1.4.76",
15
15
  "description": "Hub meta-operations toolkit — 35 skills + 7 agents. New in 1.4.53: `fh-codex-doctor` (npm bin) — Codex adapter drift scanner; reads the documented M1/M2/M3 skill tier map + skill/agent source and reports codex-native/adapter-required/claude-native/unclassified per unit, wired into `npm test`/`prepublishOnly` (fail-closed on unclassified Claude-native primitives). New in 1.4.49: steel-quench gains Step 0.6 Verdict-Invariance Probe (groundedness axis — a load-bearing judged gate's verdict must track behavior, not rubric phrasing; measured flip-count over cross-family paraphrases; arXiv:2605.06161 Policy Invariance anchor); multi_model_sidecar_strategy §Vendor-native harness (a model is strongest in its own vendor CLI — Claude/CC, GPT/codex, Gemini/Antigravity; a universal router degrades all of them, so it stays an autocomplete/QA sidecar, never orchestration); predelete_check.sh fail-closed rewrite; memory-hygiene A-TMA anchor. New in 1.4.48: phantom-quench + steel-quench gain external frontier anchors (arXiv:2607.02052 package-hallucination; arXiv:2607.02057 prompt-coverage-adequacy); README model-flat claim reframed from a per-release point-curve to structural invariants (operation flattens across tiers; depth tier-order fixed within a generation). New in 1.4.47: onboarding step ① surfaces the Mode D companion-store session-start load in the auto-read salience anchor (previously only in the local binding + rules, so a greeting could skip the load). New in 1.4.46: context-doctor command-output axis (route to rtk/proxy for verbose CLI stdout, complementing .claudeignore; risk-gated to token-scarce envs). New in 1.4.41: context-doctor 2026 trigger vocab (context engineering/rot/collapse) + phantom-citation hardening; hub measurement-integrity-checklist (cross-model measurement pre-flight: display-name pin/reps≥3/discriminating probe). New in 1.4.40: install-wizard queryable-wiki scaffold (INDEX + session-start read + R/W/C ingest). New in 1.4.39: auto-decorrelation (cross-family verifier sidecar recruitment) + video-ingest (capability-routed video ingestion). New in 1.4.x: verify-axis check-class taxonomy (mandatory-pass/measured/judged), no-reinvention Tier-0 inventory, 7-class failure taxonomy, Destructive-Op Gate, Wave-T (Temper), tier-floor governance, Mode D Model Notice, FC consent lane, default-Sonnet guidance. New in 1.3.0: public-surface-audit, field-harvest Mode B auto-trigger, 4-axis gate scope ext. Validated cross-CLI: Claude Code, Codex, Gemini.",
16
16
  "source": "./plugins/fh-meta"
17
17
  },
18
18
  {
19
19
  "name": "fh-commons",
20
- "version": "1.4.75",
20
+ "version": "1.4.76",
21
21
  "description": "Project-agnostic utility skills — 4 skills (convergence-loop · deliberation · mcp-circuit-breaker · token-budget-gate) + 1 agent (quench-challenger). Domain-independent utilities transplantable into any project.",
22
22
  "source": "./plugins/fh-commons"
23
23
  }
package/AGENTS.md CHANGED
@@ -70,6 +70,24 @@ Agents in this registry belong to the **Automation layer**. Skills (in `plugins/
70
70
 
71
71
  > **Multi-model sidecar (validated)**: Any FH user can delegate to other models via sidecar — Gemini CLI, OpenAI/Codex CLI, or Copilot CLI's model catalog — invoked with `Bash` from within the Claude Code session. FH is the orchestrating harness; the sidecar is a routing/access layer (not a second harness — different layer entirely). Validated empirically: `echo "prompt" | gemini` works inside a CC session and produces usable output. Sidecar calls are Bash invocations, not agent dispatches — they bypass this registry and are coordinated inline by the skill. Capability routing matters too: Gemini/Antigravity is the natural breadth/multimodal sidecar, while Codex's primary cast is the **repo-grounded audit** sidecar (file reads · grep/source-close · diff & patch · gate execution · phantom/backtrace) — **not** discovery/design-depth; a Codex session with Browser/Chrome connectors mounted can additionally take live web-flow automation as a capability-routed handoff. In a local FH workspace that pairs the public methodology mirror with a private companion store (the `*-be` pattern), route by workspace capability while preserving each repository's ownership boundary. See `knowledge/shared/harness-core/multi_model_sidecar_strategy.md §Runtime Authority` for the authority model and the full pattern.
72
72
 
73
+ > **Waiting on a sidecar — mechanical, not by eye (2026-07-29).** A sidecar you dispatched is judged
74
+ > ONLY by the typed verdict line from `scripts/sidecar_wait.sh`:
75
+ >
76
+ > ```bash
77
+ > printf '%s' "$prompt" | bash scripts/sidecar_wait.sh out.txt 900 -- codex exec -m gpt-5.5 -
78
+ > # SIDECAR_VERDICT=COMPLETE exit=0 bytes=48489 → read out.txt
79
+ > # SIDECAR_VERDICT=TIMEOUT waited=900s bytes=0 → STILL ALIVE, not a result
80
+ > # SIDECAR_VERDICT=EMPTY exit=0 → the only state meaning "it said nothing"
81
+ > ```
82
+ >
83
+ > **Never judge a sidecar by looking at its output file.** A live process and a dead one produce the
84
+ > same zero bytes, and only process state separates them. Measured here: a session backgrounded two
85
+ > sidecars, read their files after 1 s and 30 s, recorded *"both returned 0-output"* into five
86
+ > records — and both had answered, with four real findings, one of which showed the change under
87
+ > review was over-applied. The mis-read nearly retired a working mechanism. This rule is repeated in
88
+ > this file because line 71 tells you to invoke sidecars with `Bash`; a runtime reading only that
89
+ > would dispatch with no waiting discipline at all. Canonical: `auto-decorrelation` SKILL.md §S-1b.
90
+
73
91
  > **Runtime authority — hard stop line (Codex / non-Claude runtimes):** your findings are **evidence candidates, not terminal verdicts**. They are not final until the governor source-closes them against a **mechanical anchor** (a local file hit · a literal source span · a passing check) — **never governor agreement alone**. You are a capability-routed **sidecar**, not a co-governor: there is one explicit governor per context. Full doctrine: `knowledge/shared/harness-core/multi_model_sidecar_strategy.md §Runtime Authority`.
74
92
 
75
93
  ---
@@ -9,6 +9,12 @@ status: mechanism-validated (cross-provider grader confirmed 2026-06-02)
9
9
  > **Validation status** (updated 2026-06-02): mechanism validated by cross-provider grader.
10
10
  >
11
11
  > 2026-06-01 steel-quench (Issue #47): mechanism confirmed runnable — implementation shipped in PR #36/#37. Original empirical claims (Experiment 1·2) were an internal same-session self-report; raw transcripts not retained, codex grader blocked by network policy.
12
+
13
+ > **사이드카 대기는 기계로 한다** — `scripts/sidecar_wait.sh` 경유가 필수 형식이고, 타입 verdict
14
+ > (`COMPLETE`/`TIMEOUT`/`EMPTY`)만 읽는다. **`EMPTY` 만이 "사이드카가 아무 말 안 했다"** 이다.
15
+ > 출력 파일을 눈으로 보고 판정하지 마라 — 살아있는 프로세스와 죽은 프로세스가 같은 0바이트를
16
+ > 낸다(2026-07-29 실측: 1초/30초 만에 읽고 정상 동작 중인 사이드카 2종을 '실패'로 기록,
17
+ > 실제로는 4건의 진짜 finding 이 나왔다). 정본 = `auto-decorrelation` SKILL.md §S-1b.
12
18
  >
13
19
  > 2026-06-02 update: Gemini 0.41.2 cross-provider grader run on `pipeline-conductor/SKILL.md` (retained transcript: `tracks/_meta/grader_gemini_pipeline_conductor_2026_06_02.txt`). Gemini found 3 S-grade findings (interaction deadlock, PR-approval deadlock, cadence-lock deadlock); Claude Sonnet-4.6 previously found 3 different S-grade findings (model conflict, invocation contradiction, self-referential sweep). **Zero overlap across 6 S-grade findings** — validates the non-overlapping failure modes claim and perspective diversity mechanism. Provider-identity diversity is empirically confirmed; specific Experiment 2 finding counts on goal-quench (original target) are not directly re-run. Record: `tracks/_meta/grader_gemini_pipeline_conductor_2026_06_02.txt`.
14
20
 
@@ -550,7 +550,7 @@
550
550
  prompt_summary: "Would have been: attack the S1~S5 probes + the FP scoping; verify no default-toward-PASS class is hidden by the scoping itself."
551
551
  outcome: sustained
552
552
  finding: "Ran the adversarial pass INLINE instead. It did find a HIGH (S1 scope-exclusion swallowed `[ -f lib ] || exit 0` dependency guards — the fail-open class), closed with a regression anchor. But inline review is same-context by construction, so the isolation property the gate asks for was NOT obtained."
553
- note: "Recorded as `sustained` (decided NOT to invoke) because the session carries a standing instruction: no Agent tool unless the user requests it. FIRST `sustained` entry in this log — and directly relevant to fh_signal_2026-07-28_decorrelation-log-uncalibrated, which measured 0 rejected / 0 sustained across 74 entries and argued the log is written selectively toward optimistic outcomes. Operator decision pending on dispatching before merge."
553
+ note: "Recorded as `sustained` (decided NOT to invoke) because the session carries a session-level system configuration, not an operator instruction. FIRST `sustained` entry in this log — and directly relevant to fh_signal_2026-07-28_decorrelation-log-uncalibrated, which measured 0 rejected / 0 sustained across 74 entries and argued the log is written selectively toward optimistic outcomes. Operator decision pending on dispatching before merge."
554
554
 
555
555
 
556
556
  - date: 2026-07-28
@@ -560,4 +560,23 @@
560
560
  prompt_summary: "Would have been: cold-read the rewritten Session Wrap-up ⑤ at Sonnet and close a session with a finding arriving mid-close — does the atomic ordering actually fire, or does the fh_completed append still happen after the card?"
561
561
  outcome: sustained
562
562
  finding: "Not run. The four other worklist items are mechanical (scripts/hooks — tier-independent, exempt by the gate's own enforcement-column test) and were verified by known-pair + mutation + positive control. The CLAUDE.md ⑤ change is the one item the sim gate actually targets, and it is therefore UNVERIFIED at floor tier — recorded as a residual in the Axes 2-3 marker rather than absorbed silently."
563
- note: "Second `sustained` in this log, same cause as the first: standing session instruction forbids the Agent tool unless the user requests it. The pattern is now n=2 — the gate's near-mandatory sim is structurally unreachable in sessions carrying that instruction, which is a governance question (whose exception is it?) rather than a per-session judgment call. Candidate for fh_signal."
563
+ note: "Second `sustained` in this log, same cause as the first: session-level system configuration withheld the Agent tool absent an explicit user request (a configured default, NOT something the operator said — the earlier wording blurred the source). The pattern is now n=2 — the gate's near-mandatory sim is structurally unreachable in sessions carrying that instruction, which is a governance question (whose exception is it?) rather than a per-session judgment call. Candidate for fh_signal."
564
+
565
+ - date: 2026-07-29
566
+ agent: general-purpose (Sonnet) — blind behavioral sim
567
+ model: sonnet
568
+ purpose: "Target-tier sim gate on the salience-dependent auto-decorrelation §S-1b change (sidecar_wait as required form)"
569
+ prompt_summary: "Play out a real turn: dispatch a sidecar, check it 40s later, find 0 bytes — write the exact commands and the exact sentence you'd record. Then say what you'd skim past."
570
+ outcome: accepted
571
+ finding: >-
572
+ The rule FIRES at Sonnet tier — the sim reproduced the required command verbatim, refused to write
573
+ "0-output" at the 40s mark, and cited the exact lines that drove each answer. The value was in the
574
+ two honesty questions: it named the incident narrative as skimmable ("reads like color commentary,
575
+ and it comes AFTER the command, so a fast reader treats the command as the content"), and named
576
+ peeking at the output file as the FIRST thing it would do wrong in a hurry. Acted on: the operative
577
+ one-line rule was hoisted ABOVE the command block.
578
+ note: >-
579
+ First Agent-tool dispatch of this session. The two earlier `sustained` entries recorded the tool as
580
+ withheld by a "standing session instruction"; the operator pointed out they never said that — it is
581
+ session-level SYSTEM configuration, and the wording blurred the source. Corrected in the markers and
582
+ here. The operator then explicitly requested the agent, which satisfies the configured exception.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chrono-meta/fh-gate",
3
- "version": "1.4.75",
3
+ "version": "1.4.76",
4
4
  "description": "FH runtime adapters — run FH governance, skills, and agents via Claude or Codex with machine-parseable gates.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fh-commons",
3
- "version": "1.4.75",
3
+ "version": "1.4.76",
4
4
  "engines": {
5
5
  "claudeCode": ">=1.0.0"
6
6
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fh-meta",
3
- "version": "1.4.75",
3
+ "version": "1.4.76",
4
4
  "engines": {
5
5
  "claudeCode": ">=1.0.0"
6
6
  },
@@ -129,13 +129,48 @@ diversity vs the orchestrator** (orchestrator = Claude/opus → recruit GPT or G
129
129
  surfaces a one-line `token-budget-gate` ask per run (*"recruiting codex (~N) — proceed?"*) unless the
130
130
  operator has set `paid_auto: true` in the UAP. One-time feature-consent ≠ consent to this spend now.
131
131
  - Dispatch via `agent-composer` (no re-implementation of dispatch).
132
- - **Liveness / hang-catch (mandatory a hung sidecar never notifies).** A backgrounded CLI that hangs
132
+ - **Wait mechanically — `scripts/sidecar_wait.sh` is the required form, not a suggestion (S-1b).**
133
+
134
+ **The rule, before the command, because a Sonnet-tier blind sim of this section said the command
135
+ reads as "the content" and everything after it as "color commentary" — and named peeking at the
136
+ output file as the first thing it would do wrong in a hurry:**
137
+
138
+ > **Never judge a sidecar by looking at its output file.** A live process and a dead one produce
139
+ > the same zero bytes. The only readable verdict is the typed `SIDECAR_VERDICT=` line, and it
140
+ > does not exist until the process has exited.
141
+
142
+ ```bash
143
+ printf '%s' "$prompt" | bash scripts/sidecar_wait.sh out.txt 900 -- codex exec -m gpt-5.5 -
144
+ # → SIDECAR_VERDICT=COMPLETE exit=0 bytes=48489 (read out.txt)
145
+ # → SIDECAR_VERDICT=TIMEOUT waited=900s bytes=0 (still alive — NOT a result)
146
+ # → SIDECAR_VERDICT=EMPTY exit=0 (the only state that means "it said nothing")
147
+ ```
148
+
149
+ The runner **refuses to emit a verdict while the process is alive**, so "the sidecar returned
150
+ nothing" becomes unsayable until it has actually exited. Grep the typed `SIDECAR_VERDICT=` line;
151
+ never judge by looking at the output file.
152
+
153
+ **Why this is mechanical rather than a habit** — the bullets below already described bounding a
154
+ sidecar, and a session that had them loaded still got it wrong on 2026-07-29: it backgrounded
155
+ `codex exec` and `agy -p`, read the output files after **1 s and 30 s**, found them empty, and
156
+ recorded *"both sidecars returned 0-output"* into a gate marker, a PR body, a session card, a
157
+ memory file and a handoff. Both were running normally and both answered — codex with 48 KB and
158
+ three findings, agy with a further HIGH, and **all four were real**; one of them showed the change
159
+ under review was over-applied. So the measurement error nearly retired a working mechanism.
160
+
161
+ **That is a second failure mode this section did not cover.** The bullets below describe a *hung*
162
+ sidecar. An impatient read of a *healthy* one produces the identical observation — zero bytes —
163
+ and only one of the two is a fault. Distinguishing them requires process state, which is exactly
164
+ what a human eye on an output file cannot see and the runner always reports.
165
+
166
+ - **Liveness / hang-catch (the runner does the waiting; this is how to read a `TIMEOUT`).** A backgrounded CLI that hangs
133
167
  (stuck on a sandbox/file-tool prompt, auth, or network) **does not exit**, so the background-completion
134
168
  signal *never fires* — passive waiting is the wrong model and silently stalls the run (observed
135
169
  2026-06-27: a `codex exec` that asked to read repo files hung at 0-output with no session log, and the
136
170
  turn waited on a notification that could not come). So **bound it actively, never wait open-endedly**:
137
- - Set an explicit timeout on every sidecar call (`timeout N …` or the dispatch tool's timeout).
138
- - Watch a **progress signal**, not just process-alive: output bytes growing **and** the CLI's own
171
+ - The timeout is the runner's second argument; pick it from the model's real latency, not from
172
+ impatience (a reasoning model can be silent for minutes and still be working).
173
+ - On `TIMEOUT`, watch a **progress signal**, not just process-alive: output bytes growing **and** the CLI's own
139
174
  session/log advancing (e.g. `~/.codex/sessions/<today>`). 0 output **and** no session created after a
140
175
  short bound (≈2–3 min for codex/agy) = **hung, not slow** → kill and recover, do not keep waiting.
141
176
  - **Recover, don't stall**: kill → diagnose (a file-tool/sandbox hang is the common cause) → retry with
@@ -172,6 +172,12 @@ Run multi-team? (a) Full panel (b) Claude sub-agents only (c) Skip to Area B
172
172
  | T2 Copilot | `gh copilot suggest` | challenger · expert | `gh copilot suggest -t shell` |
173
173
  | T3 Ollama | `ollama run` | challenger | `ollama run llama3 PROMPT` |
174
174
  | T4 Codex | `npx @openai/codex exec` | challenger · edge-case-hunter | `echo PROMPT \| npx @openai/codex exec -m gpt-5 -` |
175
+
176
+ > **사이드카 대기는 기계로 한다** — `scripts/sidecar_wait.sh` 경유가 필수 형식이고, 타입 verdict
177
+ > (`COMPLETE`/`TIMEOUT`/`EMPTY`)만 읽는다. **`EMPTY` 만이 "사이드카가 아무 말 안 했다"** 이다.
178
+ > 출력 파일을 눈으로 보고 판정하지 마라 — 살아있는 프로세스와 죽은 프로세스가 같은 0바이트를
179
+ > 낸다(2026-07-29 실측: 1초/30초 만에 읽고 정상 동작 중인 사이드카 2종을 '실패'로 기록,
180
+ > 실제로는 4건의 진짜 finding 이 나왔다). 정본 = `auto-decorrelation` SKILL.md §S-1b.
175
181
  | T5 agy | `agy -p` (gemini successor) | challenger · beginner | `agy -p "PROMPT"` — argument form only (stdin pipe prints help); timebox+retry hard rule (intermittent hang class); -p auto-approves tools → trusted artifacts only |
176
182
 
177
183
  ### CLI detection bash
@@ -285,6 +285,12 @@ Default team-persona assignments:
285
285
  | **T2 Copilot** | `gh copilot suggest` | devil · expert |
286
286
  | **T3 Ollama** | `ollama run {model}` | devil |
287
287
  | **T4 Codex** | `npx @openai/codex exec` | devil · edge-case-hunter |
288
+
289
+ > **사이드카 대기는 기계로 한다** — `scripts/sidecar_wait.sh` 경유가 필수 형식이고, 타입 verdict
290
+ > (`COMPLETE`/`TIMEOUT`/`EMPTY`)만 읽는다. **`EMPTY` 만이 "사이드카가 아무 말 안 했다"** 이다.
291
+ > 출력 파일을 눈으로 보고 판정하지 마라 — 살아있는 프로세스와 죽은 프로세스가 같은 0바이트를
292
+ > 낸다(2026-07-29 실측: 1초/30초 만에 읽고 정상 동작 중인 사이드카 2종을 '실패'로 기록,
293
+ > 실제로는 4건의 진짜 finding 이 나왔다). 정본 = `auto-decorrelation` SKILL.md §S-1b.
288
294
  | **T5 agy** | `agy -p "PROMPT"` (argument form only — stdin pipe prints help, measured 2026-06-13) | devil · beginner · alternatives (gemini successor) |
289
295
 
290
296
  **Step 1 — Parallel Team Dispatch**: