@chrono-meta/fh-gate 1.4.64 → 1.4.66

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.64",
14
+ "version": "1.4.66",
15
15
  "description": "Hub meta-operations toolkit — 34 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.64",
20
+ "version": "1.4.66",
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
@@ -104,11 +104,11 @@ For complex multi-step tasks, run `/agent-composer` first to plan which agents t
104
104
 
105
105
  The methodology layer (`tracks/`, `knowledge/`, `SKILL.md` docs) is Codex-compatible beta. Any AI model can follow skill workflows by reading SKILL.md files directly; the automation layer (hooks, plugin-channel agents under `plugins/*/agents/`, `/model`) is Claude Code-native and requires manual adaptation. FH's own agents are auto-loaded via the plugin channel when the plugin is enabled — `.claude/agents/` is the field-project override slot, not where FH ships its agents. Non-Claude runtimes use this `AGENTS.md`, `plugins/*/agents/*.md`, and `scripts/fh-run.sh` to apply the same methodology via adapter.
106
106
 
107
- ### Non-Claude runtimes: two things CLAUDE.md holds that you will not auto-load
107
+ ### Non-Claude runtimes: four things CLAUDE.md holds that you will not auto-load
108
108
 
109
109
  `.claude/rules/*.md` with `paths:` frontmatter is a **Claude Code platform feature** — those files are
110
110
  auto-loaded into a Claude Code session when it reads a matching file, and **your runtime has no equivalent**.
111
- So two things that govern behavior are not going to reach you on their own. Read them explicitly:
111
+ So four things that govern behavior are not going to reach you on their own. Read them explicitly:
112
112
 
113
113
  1. **FH asset changes run a mandatory 4-axis verification chain before the session's first commit.**
114
114
  Detail (axis definitions · marker required fields · lightweight exception · substantive carve-out):
@@ -122,6 +122,44 @@ So two things that govern behavior are not going to reach you on their own. Read
122
122
  approval plus a gitignored audit note. This binds every runtime, not just Claude Code — a leak does not
123
123
  un-happen, and the guard is worth nothing if it only lives where one runtime reads.
124
124
 
125
+ 3. **Before calling a material work product done, name what you are blind to.** CLAUDE.md routes the
126
+ everyday "commit and merge this" moment to `agent-composer` **§Author-Exposure Table** — a review
127
+ pass keyed on *what the author cannot self-detect* (cold entry → `beginner` · everyday friction →
128
+ `main-player` · outside currency → `expert` · optimistic self-verification → `challenger` +
129
+ cross-family · rebuilding what exists → `fact-checker` · ungrounded numbers → `phantom-quench`),
130
+ with a materiality gate and an `Exposure-unclear → challenger` default so "no row applies" is not
131
+ an exit. **This row exists because the triggering utterance names no agent** — nothing will fire it
132
+ for you. Your runtime *can* run these lenses: substitute `Agent(subagent_type=...)` per §M2 above
133
+ (`fh-run`, or `codex exec` reading the agent spec). The lens returns evidence, never the verdict.
134
+
135
+ 4. **General work is in scope here, and the mechanism for serving it is to marshal installed
136
+ capability.** CLAUDE.md §Intent Marshaling makes this the runtime default. It settles a *category*
137
+ question only — whether non-harness work belongs in this environment at all. Every ordinary check
138
+ about a specific request (is it safe, sensible, well-formed, worth doing) is yours and is unaffected.
139
+
140
+ The category answer is yes, for a concrete reason: the skill registry, the mapped field harnesses,
141
+ and the memory store exist **only** in this environment. So when the operator states a work intent in
142
+ plain language (write this doc, build this wiki page, organize this material — **any work-shaped ask,
143
+ not only harness building**), the scan below is what tells you whether capability for it is actually
144
+ present. An empty scan, reported with the scan cited, is a correct answer — see the third bullet.
145
+
146
+ Three constraints carry over unchanged to your runtime:
147
+ - **Enumerate rather than recall.** List the available skills, `LOCAL_SKILL_REGISTRY`, and the mapped
148
+ project assets. Recall under-reports what is installed, which is why the scan is a listing step.
149
+ - **Marshaling never upgrades a trust tier.** Run-first autonomy covers **FH-native capability whose
150
+ steps are per-action reversible**. A non-FH sibling capability stays at its registry `ask-tier`
151
+ (propose only), and an outward-mutating action (send · post · deploy · delete) keeps its own gate.
152
+ - **A capability gap is declared by citing the scan result**, not as a bare "nothing fits" — then
153
+ route at request scale (internal scan → external search → in-session synthesis). *Persist* routes
154
+ to the New-Skill gate; *install* routes to plugin-recommender's HITL. No new gates.
155
+
156
+ **This item exists because the triggering utterance is ordinary work language that names no skill and
157
+ no agent** — like item 3, no automatic trigger covers it; read it explicitly.
158
+
159
+ > **Detail**: See `knowledge/shared/harness-core/intent_marshaling_general_work.md` — the 5-step loop,
160
+ > the gate-routing table, the Sonnet-floor boundaries, and the origin defect — **open it directly**
161
+ > before applying the ladder or when a gap appears.
162
+
125
163
  The irreversible-surface gates (Pre-Publish · Destructive-Op) likewise live in CLAUDE.md and fire on
126
164
  **intent**, not on a file — read them before any publish, delete, or history-rewrite. `pre-push` enforces
127
165
  the git-side destructive surface mechanically for every runtime.
package/CATALOG.md CHANGED
@@ -8,6 +8,12 @@ AI reads this file first when searching past work. Open individual files for det
8
8
 
9
9
  <!-- Add entries in reverse date order (newest at top) -->
10
10
 
11
+ ### 2026-07-22 | forge-harness | #intent-marshaling, #doctrine, #purpose-organization, #leader-briefing, #conference, #pre-registration
12
+ **File:** knowledge/shared/harness-core/intent_marshaling_general_work.md · CLAUDE.md §Intent Marshaling · (companion store) leader/TF briefing pair · handoff §5-§7
13
+ Two operator insights forged into doctrine. **Intent Marshaling** (PR #161, mirrored to the field meta-harness as its PR #23): the runtime twin of intent-machinization — a work-shaped request in plain language triggers a mechanical capability scan (trust tiers carried in scan output), a one-line compose proposal, then run-first execution; gap declarable only by citing the scan; no new gates (install/persist/outward actions route to existing ones). Verified by Sonnet known-pair sim (2/2 separated) + codex cross-family R1 4/4-confirmed findings (2 HIGH: non-FH ask-tier auto-run hole, per-action reversibility fail-open) fixed to R2 CONVERGED. **Leader-judgment briefing pair** (companion store, operator-approved): QA-team edition (4 judgment axes, measured/pending boundary, act-by-act glossary from operator definitions) + org-TF edition (domain-agnostic layers as protagonist, field harness as the n=1 evidence case, method-stack 8/8 as the domain-agnostic quantitative anchor) — both persona-audited (SHIP_AFTER_M, all findings applied; the audits caught the docs' own optimism twice, which became a self-evidencing section). Conference talk submitted (title A) with **metric pre-registration** pinned in the handoff (calibration / field / org metric sets + before-baseline warning + freeze-timeline insurance).
14
+ - Decision: marshaling autonomy covers FH-native per-action-reversible work only; non-FH registry hits keep ask-tier; specific initiative rows always outrank the fallback row. Briefing scope split two-audience (QA team vs org TF) rather than one doc.
15
+ - Open: marshaling operational track record starts at zero (manifest prediction pending); AGENTS.md port of the marshaling anchor = deferred drift candidate; handoff-reachability defect (untracked file referenced for remote verification) recorded as signal S-1 with a mechanical-check prescription.
16
+
11
17
  > **Backfill note (2026-07-15):** the 07-12 / 07-13 / 07-14 entries below were reconstructed from git
12
18
  > history + the session card's completion log during the 2026-07-15 harness-doctor run, which found that
13
19
  > CATALOG had stopped at 07-10 while 30 FH-asset commits landed — i.e. 5 days of work were invisible to
package/CLAUDE.md CHANGED
@@ -176,10 +176,36 @@ The forge-harness hub has a dual identity: **(a) a seed for others** + **(b) you
176
176
  - **Implementation:** Skills such as `harvest-loop` follow this principle — they generate skill drafts, prepare commits automatically, and propose PR creation. However, the final decision to submit a PR must always require the user's explicit approval (`y`). This ensures Human-in-the-loop while maximizing AI contribution.
177
177
 
178
178
  **PR Creation Principle:**
179
- - AI may commit and push automatically (when changes are approved)
179
+ - AI may commit and push automatically (when changes are approved) — **to a feature branch, never to the integration branch**
180
180
  - **PR creation requires explicit user request** ("create PR", "PR 올려줘", "pull request")
181
181
  - **Reason:** Prevents PR fragmentation — logical units should be grouped into meaningful PRs, not atomized per commit
182
- - Default workflow: commit → push → wait for explicit PR request
182
+ - Default workflow: branch → commit → push branch → wait for explicit PR request
183
+
184
+ **Integration branch is PR-only** (operator decision 2026-07-20). Never `git push origin main`
185
+ directly. Normal path: `git switch -c <branch>` → push the branch → `gh pr create` → after review
186
+ `gh pr merge --squash --delete-branch --admin` (self-approval is impossible when you authored the PR,
187
+ so `--admin` after a completed review is the normal route, not a shortcut).
188
+
189
+ **Mechanically enforced** by `templates/.git-hooks/pre-push`, which blocks a direct push to
190
+ `main`/`master` unless the explicit `MAIN_PUSH_OK=1` acknowledgment is set (same channel shape as
191
+ `DESTRUCTIVE_OP_OK` / `PUBLIC_SURFACE_OK`). Known-pair calibrated: direct-to-main blocks,
192
+ feature-branch push passes untouched, override honored — over-blocking would just train the override
193
+ into muscle memory and disarm it.
194
+
195
+ > **Two layers, and which one is the floor**: the **hard floor is server-side** — this repo now runs
196
+ > `enforce_admins: true` with `required_approving_review_count: 0` (set 2026-07-20; the count must be
197
+ > `0`, because enabling `enforce_admins` while it is `1` locks a solo operator out of merging their
198
+ > own PRs — self-approval is impossible). The hook is the **shift-left layer**: it fails at push time
199
+ > and prints the actual remedy, and it keeps holding if the server setting is ever relaxed. It is
200
+ > deliberately not the floor — a client-side hook is bypassable with `--no-verify`.
201
+ > *Origin*: before that change the server had `enforce_admins: false`, so an admin push *satisfied*
202
+ > the rule and merely printed `Bypassed rule violations` — a notice, not a block. A rule that
203
+ > announces its own bypass is not a floor.
204
+ > ⚠️ **Unresolved residual**: `allow_force_pushes` on `main` is still `true`. Two documented API
205
+ > attempts to set it `false` were accepted without error and did **not** persist (verified by
206
+ > independent GET, not by the write response). Force/non-ff pushes are blocked locally by this same
207
+ > hook, so the honest-model case is covered — but the **server-side** history-rewrite surface on
208
+ > `main` remains open. Re-check before relying on it.
183
209
 
184
210
  ## Permission-Denial Guidance (When Auto-Mode Blocks an Action)
185
211
 
@@ -481,6 +507,7 @@ Proposal format: `"I see [X]. Want me to run /[skill] to [one-line description]?
481
507
  | "keep watching X", "poll this", "check every N minutes", recurring WATCH item | built-in `/loop` (interval runner) — pair with the WATCH list, don't hand-poll |
482
508
  | "research this deeply", "survey the literature", "comprehensive analysis", "deep research", "look this up thoroughly", "조사해줘", "리서치" (general topic research, not trend-scan) | **Deep-Research Capability Ladder** (`knowledge/shared/harness-core/deep_research_capability_ladder.md`) — route to the highest available rung: built-in `/deep-research` if present → else Claude `WebSearch`+`WebFetch` synthesis (tier-sensitive) → `/frontier-digest` only if it's AI/harness trend-scan. No-reinvention: FH routes, does not build a research engine. |
483
509
  | "orchestrate agents", "parallel dispatch", "combine skills", "multiple agents" | `/agent-composer` |
510
+ | **a material work product is about to be called done / merged / published** — public or irreversible surface · affects others · carries external claims or numbers · new behavior · security/data/permissions (proactive; the everyday "커밋하고 머지하자" utterance does **not** name an agent, so agent-composer never self-fires here — that is why this row exists) | `agent-composer` **§Author-Exposure Table** — name the exposure row, dispatch that review pass, then decide. Materiality gate + `Exposure-unclear → challenger` default live there; the lens returns evidence, never the verdict |
484
511
  | "broaden the grounded corpus", "add another version of the corpus", "ingest the full source as the grounding axiom", "여러 버전으로 통째로 가져와" (verbatim-relay corpus expansion — fail-closed grounding, no generator) | `/corpus-grounding-expander` |
485
512
  | "broaden these personas", "what other voices fit this cast", "map these roles to a decision lens", "페르소나 후보군 더 넓혀" (persona seed → tiered judgment-mapped cast; pairs with `persona-innovator` for naming) | `/persona-roster-expander` |
486
513
  | "connect a project", "map this project", "link to hub" | `auto_project_mapping.md` (mapping) |
@@ -497,6 +524,7 @@ Proposal format: `"I see [X]. Want me to run /[skill] to [one-line description]?
497
524
  | "help me write a prompt", "build a prompt", "improve this prompt", "prompt template" | `/meta-prompt-builder` |
498
525
  | "/goal", "run this autonomously", "big multi-step task", "orchestrate this goal", or **any heavy autonomous/multi-agent run** (proactive — propose *before* running; it is expensive, so the proposal is mandatory, not the auto-run) | `/goal-quench` (budget gate + quality gate) |
499
526
  | "I don't know what to build", "how should I approach this", "organize this for me", "clarify this", "정리해줘" (ambiguous request before dispatch) | `/deep-clarify` |
527
+ | **work-shaped request outside the harness domain** — "이 문서 만들어줘", "위키 페이지 써줘", "이 자료 표로 만들어줘", any general work ask no other row or skill catches (**fallback default** — a more specific row above/below always wins: 리서치→deep-research · ambiguous "정리해줘"→deep-clarify · heavy fleet→goal-quench) | **Intent-Marshaling loop** (§Intent Marshaling — mechanical capability scan → one-line compose proposal → run; gap → capability ladder) |
500
528
  | "memory feels bloated", "clean up memory", "memory too large", "memory hygiene" | `/memory-hygiene` |
501
529
  | "ready to PR", "about to push", "merge this", "PR 올려줘", FH asset changed in session | 4-axis auto-gate (see above — runs automatically, no proposal needed) |
502
530
  | **field verdict/gate/safety/irreversible code changed** in a mapped project (function returning a verdict enum / gate exit code / safety-invariant · publish/delete/history path) — **proactive, before merge** | **Field-Harness Load-Bearing Change Gate** (see above → degrade-lint → cross-family review → converge; same rigor as FH assets, applied to field code) |
@@ -573,6 +601,29 @@ Simple file-lookup agents may omit. Agent dispatch works from any mapped project
573
601
 
574
602
  ---
575
603
 
604
+ ## Intent Marshaling — General-Work Serving (runtime default)
605
+
606
+ FH/PMH is a **purpose organization**, not only a meta-harness: when the leader states a work intent in
607
+ plain language — wiki/document production, research-and-write, organizing, **any work-shaped ask, not
608
+ just harness building** — the session **marshals installed capability** (skills · agents · mapped
609
+ harnesses · memory) into a one-line composition proposal and runs it. "This is a harness hub, not for
610
+ that" is a forbidden deflection — serving general work is identity (the registry + mapped harnesses +
611
+ memory exist only here; a plain chatbot cannot marshal them). Marshal-by-feel is the defect this
612
+ replaces (same shape as pre-#158 lens selection): the capability scan is **mechanical** (skill list ·
613
+ `LOCAL_SKILL_REGISTRY` · mapped assets), never recall — and it **carries trust tiers**: run-first
614
+ autonomy covers **FH-native capability with per-action-reversible steps only**; a non-FH sibling hit
615
+ stays at its registry `ask-tier` (propose-only) and an outward-mutating action (send · post · deploy ·
616
+ delete) keeps its own gate — marshaling never upgrades either. Capability gap (declared only by citing
617
+ the scan result, never a bare "nothing fits") → the goal-quench Step C ladder semantics at request
618
+ scale (internal scan → external search → in-session synthesis; **persist** routes to the New-Skill
619
+ gate, **install** to plugin-recommender's HITL — no new gates).
620
+
621
+ > **Detail (read before applying the ladder or when a gap appears)**:
622
+ > `knowledge/shared/harness-core/intent_marshaling_general_work.md` — the 5-step loop, gate-routing
623
+ > table, Sonnet-floor boundaries, and the origin defect.
624
+
625
+ ---
626
+
576
627
  ## Cross-Project Skill Bus (Active Throughout Session)
577
628
 
578
629
  Based on LOCAL_SKILL_REGISTRY (Step 1-c), **propose and connect skills from other projects directly**. Proposal: *"{Project} has `{skill-name}`. Want me to dispatch it via Agent?"*
@@ -0,0 +1,75 @@
1
+ # Intent Marshaling — General-Work Serving (runtime twin of intent machinization)
2
+
3
+ > **Status**: doctrine (judgment-shaped, operator-forged 2026-07-22). Companion:
4
+ > `harness_incubator_doctrine.md` covers **forge time** (`intent → forge → agreement → machinery`);
5
+ > this file covers **run time** — what a mapped, skill-equipped environment does with a plain work
6
+ > request. Floor companion: `sonnet_floor_doctrine.md`.
7
+
8
+ ## 1. Doctrine statement
9
+
10
+ At forge time a harness machinizes intent into new machinery. At **run time**, an environment with
11
+ installed skills, agents, mapped harnesses, and persistent memory is a **purpose organization**: the
12
+ leader states a work intent in plain language, and the session **marshals installed capability into a
13
+ composition and executes** — without the leader naming skills, agents, or files.
14
+
15
+ **Scope is general work, not only harness work.** Wiki/document production, research-and-write,
16
+ review, organizing, data shaping — any work-shaped request is in-scope. The environment moat is the
17
+ point: a capability registry + mapped harnesses + memory exist *here*, so a plain chatbot session
18
+ cannot marshal what it does not have. Serving general work is therefore **identity, not a favor** —
19
+ "this is a harness hub, not for wiki work" is a forbidden deflection.
20
+
21
+ ## 2. Why doctrine, not mood (origin defect)
22
+
23
+ 2026-07-21: a session marshaled sim/persona skills onto wiki-polishing work "by feel" and the effect
24
+ was large. That was orchestrator taste — the same failure shape lens selection had before the
25
+ Author-Exposure Table (PR #158: picked right 4/4, but by judgment-luck, not machine). Taste survives
26
+ only on strong tiers and good days; a Sonnet-tier session with the same assets would serve the same
27
+ request thinly and call it done. This doctrine converts the marshal decision from taste into a
28
+ mechanical default that survives at the Sonnet floor.
29
+
30
+ ## 3. The marshaling loop (every step Sonnet-runnable)
31
+
32
+ | Step | Action | Mechanical form |
33
+ |---|---|---|
34
+ | **1 Intent read** | Restate the request as *deliverable + doneness* in one line. Genuinely ambiguous → the existing `/deep-clarify` route, not guessing. | one sentence, embedded in the compose proposal |
35
+ | **2 Capability scan** | Scan what is actually installed/mapped — never recall from memory: ① in-session skill list (description match) ② `LOCAL_SKILL_REGISTRY` / Cross-Project Skill Bus ③ the target project's mapped harness assets. **The scan carries each hit's trust tier with it** (FH-native · non-FH sibling `ask-tier` · external) — trust is scan output, not a later afterthought. | list/grep, not vibes |
36
+ | **3 Compose & run** | One-line composition proposal ("draft via X, then Y as the quality gate"), then **run-first, ask-last** — for **FH-native / session-installed capability whose actions are reversible**. A **non-FH sibling registry hit keeps its registry trust tier**: `ask-tier` = propose-only, never auto-run (`fh_detail_protocols.md` 1-c — sibling code is an injection surface). **Reversibility is judged per action, not per skill**: an installed skill whose step sends/posts/deploys/deletes outward hits that action's own gate (`mcp_tool_gating.md` ask-tier · the irreversibility gates) — marshaling never upgrades an ask-tier action to autonomous. | the one-liner IS the HITL surface for reversible work |
37
+ | **4 Gap → ladder** | Gap may be declared **only by citing the Step-2 scan result** ("scanned ①②③, nothing covers X") — never a bare "nothing fits"; a gap claim without a named scan is the under-serve degrade direction this doctrine exists to close. Then reuse the goal-quench Phase 1.5 Step C **ladder semantics** (order + trust-gating + degrade direction — NOT its max-mode `fit_score` trigger, which stays goal-quench-local): internal registry scan → external search (`plugin-recommender`) → **in-session synthesis** from existing meta-skills (composition, not persisted) → net-new skill only as last resort. | same ladder order, no new machinery |
38
+ | **5 Exposure check** | Deliverable is material (published · carries external claims · others rely on it) → the Author-Exposure Table (`agent-composer` §Author-Exposure) names the review pass before "done". | existing gate, unchanged |
39
+
40
+ ## 4. Gates — reused, none new
41
+
42
+ | Surface | Gate |
43
+ |---|---|
44
+ | Scan · compose · run **FH-native** installed capability, **per-action reversible** | **none** — autonomous, one-line notice |
45
+ | Dispatching a **non-FH sibling/registry skill** | its **registry trust tier** — `ask-tier` = propose-only, never auto-run (injection surface) |
46
+ | An action that mutates **outward** (send · post · deploy · delete · payment — even via an installed skill) | that action's own gate (`mcp_tool_gating.md` ask-tier · irreversibility gates) — never converted to autonomous by marshaling |
47
+ | External plugin/skill **install** | `plugin-recommender`'s own install-HITL (environment mutation) |
48
+ | **Persisting** a synthesized skill | New-Skill Pre-Commit Gate + `asset-placement-gate` (ephemeral in-session composition needs neither) |
49
+ | Irreversible surfaces (publish · delete · heavy autonomous fleet) | existing gates unchanged (Pre-Publish · Destructive-Op · the goal-quench proposal row) |
50
+
51
+ ## 5. Boundaries
52
+
53
+ - **Not a heavy-orchestration auto-runner**: a run that would spawn a large multi-agent fleet still
54
+ proposes `/goal-quench` first (existing row). Marshaling defaults to the **cheapest composition
55
+ that serves the intent** — one skill beats three when one suffices.
56
+ - **Sonnet floor**: every loop step is list/grep/one-liner/run — no depth-gated judgment on the
57
+ critical path. Depth escalation is dispatch (consent-gated), never substrate.
58
+ - **Company residency unchanged** — marshaling never widens what may leave the machine.
59
+ - **Operator-taste default**: tuning targets the operator's convenience (operator, 2026-07-22: "if
60
+ it's convenient for me, that's sufficient" — FH/PMH distributes *how the operator works well*).
61
+ Per-user adaptation is the UAP's layer, not this file's.
62
+ - **Honesty**: marshaling quality is bounded by what is actually installed — a thin environment
63
+ marshals thin. The scan reports what it found; it never inflates the roster.
64
+
65
+ ## Done When (adoption, measured)
66
+
67
+ - A general work request in a mapped environment produces a one-line composition proposal grounded in
68
+ an actual capability scan (check class: **measured** — target-tier sim at Sonnet, known-pair: one
69
+ work-shaped positive must marshal, one trivial/out-of-scope negative must NOT add ceremony).
70
+ - No new gate machinery introduced; the mutation points (install · persist · non-FH dispatch ·
71
+ outward actions) route to existing gates (check class: **mandatory-pass** — grep this file for gate
72
+ names, confirm all resolve to pre-existing assets).
73
+ - Trust tiers survive marshaling: no path in this file lets a non-FH `ask-tier` hit or an outward
74
+ action run without its own gate (check class: **mandatory-pass** — cross-family verified 2026-07-22,
75
+ codex F1/F2 closed).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chrono-meta/fh-gate",
3
- "version": "1.4.64",
3
+ "version": "1.4.66",
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.64",
3
+ "version": "1.4.66",
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.64",
3
+ "version": "1.4.66",
4
4
  "engines": {
5
5
  "claudeCode": ">=1.0.0"
6
6
  },
@@ -63,6 +63,50 @@ For each subtask in the composition plan:
63
63
  | Code generation | `writes: true` + code tools | `writes: false` or no code tools |
64
64
  | Audit-only | `writes: false` (safe) | `writes: true` (risky for audit) |
65
65
 
66
+ ### Author-Exposure Table — a review pass, not a second executor
67
+
68
+ The table above picks **who does the subtask**. This one adds a different question at a different
69
+ stage: **what failure is the author structurally exposed to, now that the work is claimed done?**
70
+ It never replaces capability fit and never selects the agent that performs the work — it adds a
71
+ **review pass** before the work is released. A doc-writing subtask scores no "adversarial review"
72
+ fit, yet its author is blind to cold-entry failure, and capability fit never surfaces that.
73
+
74
+ **Materiality gate — run this pass only when the work product is material.** At least one of:
75
+ public or otherwise irreversible surface · affects users other than the author · carries external
76
+ claims, numbers, or citations · introduces new behavior · touches security, data, deletion, or
77
+ permissions. Internal notes, wording fixes, and one-line edits do **not** trigger it — an
78
+ unbounded trigger just trains the pass into being skipped.
79
+
80
+ | Failure the author cannot self-detect | Review mechanism | Type |
81
+ |---|---|---|
82
+ | Cold entry — first contact breaks (missing install step, undefined term, no success signal) | `beginner` | agent |
83
+ | Everyday-use friction invisible to the designer | `main-player` | agent |
84
+ | Currency vs the outside field (needs external citation, not assertion) | `expert` | agent |
85
+ | Self-verification only fails in the optimistic direction | `challenger` + `auto-decorrelation` | agent + pipeline |
86
+ | Rebuilding something that already exists | `fact-checker` · `asset-placement-gate` | agent · skill |
87
+ | Numbers/citations living in the artifact without grounding | `phantom-quench` | skill |
88
+ | **Exposure unclear** (material, but no row above fits) | `challenger` | agent — default, not a skip |
89
+
90
+ The `Type` column matters for the capability-fit checks above: `writes`/tooling scoring applies to
91
+ **agent** rows only; skill and pipeline rows are invoked, not scored.
92
+
93
+ **Behavioral rule — no silent skip, and "no row applies" is not an exit.** Name the row before the
94
+ agent. If you believe none applies, you must (a) state which rows you considered, (b) give a
95
+ one-line reason each is excluded, and (c) fall through to the **Exposure-unclear** row — the
96
+ default is `challenger`, never nothing. (Origin: 2026-07-21 — four dispatches in one session were
97
+ chosen by orchestrator judgment alone. They were right; that is luck, not a mechanism. In the same
98
+ session one `beginner` dispatch blocked a public-repo merge on 4 findings the author had not seen.)
99
+
100
+ **Behavioral rule — the lens does not hold the verdict.** A review pass returns `evidence`,
101
+ `risk`, and a `recommended decision` only. It may **not** emit a terminal `block`/`approve`; the
102
+ orchestrator declares the outcome, on its own stated grounds, and approval on an irreversible
103
+ surface stays with the human regardless of what the lens returned.
104
+
105
+ **Row-growth criterion (anti-case-crafting).** A new row is admissible only if the failure type has
106
+ been **observed more than once**, is **not coverable by an existing row**, and names a *verifiable
107
+ exposure axis* rather than a job title or a favorite tool. If rows keep accreting, that is the
108
+ signal to fold the table into a smaller set of principled axes — not to keep appending.
109
+
66
110
  **Behavioral rule**: A `writes: false` agent (e.g. fact-checker, hub-persona-auditor) must NOT be assigned a task requiring edits. Capability fit scoring catches this statically before dispatch.
67
111
 
68
112
  **Behavioral rule**: Degraded composition — when any required-weight role is filled with general-purpose fallback, output `⚠️ degraded: [role]` in the composition plan. Do not silently use general-purpose for a specialized role.
@@ -115,6 +115,7 @@ size instrument* is read. The footprint rows below apply to **both** scopes and
115
115
  | **Pointer-illusion**: a CLAUDE.md "detail/detailed procedure" pointer whose target is itself an always-loaded `.claude/rules/*.md` | S-tier — the split saves zero context (rules/ auto-loads regardless); move the target out of auto-load, keep the pointer |
116
116
  | weekly_audit 14~30 days elapsed | S-tier |
117
117
  | weekly_audit 30+ days elapsed | M-tier |
118
+ | `tracks/_meta/*.md` **reference assets** (excluding dated chronological records — `fh_completed_*` · `fh_signal_*` · `frontier_digest_*` · `session_*` · `weekly_audit_*` · `*_log_*`, whose date lives in the filename by design) missing **both** a role/type tag and a version/date stamp | R-tier — taxonomy gap, not urgent. ⚠️ **Measured FP rate before you act on this**: run against FH itself 2026-07-21 it flagged **99/161 (61%)** un-narrowed and **19/26 (73%)** after narrowing — a row that flags most of a directory is noise, not signal. ⚠️ **No consumer**: grep found **no skill that reads `role`/`type` from these files**. Until one exists this is taxonomy for taxonomy's sake — treat as an inventory observation, never escalate |
118
119
 
119
120
  **Per-unit ≠ aggregate — do not slide between them.** "Every section earns its scope" (the per-unit
120
121
  doctrine test) and "the always-loaded total is affordable" (the budget test) are **different questions, and
@@ -229,6 +230,52 @@ FAIL, the safe direction); and the scope test reads directory *existence*, so th
229
230
  field→meta (acceptable: the operator names the target, and the footprint rows apply to **both** scopes
230
231
  regardless — but it does skip the field-only line rows).
231
232
 
233
+ **Context-File Taxonomy check** (mechanical grep, R-tier only — a coverage lens, not a mandate): L1 (Step 2)
234
+ checks `CLAUDE.md` / `.claudeignore` / `.claude/` existence, but nothing checks `tracks/_meta/*.md` context-file
235
+ existence or taxonomy — this adds both. Note: `tpa_schema.md` classifies this file class (`session_card`) as
236
+ **low** risk / "ephemeral state, low blast radius" — most `tracks/_meta/*.md` files are untagged by design, and
237
+ that is expected, not a defect. This check surfaces untagged files for optional triage on the subset that
238
+ function as durable references (e.g. `reference_next_session_starter.md`); it is not a mandate that every file
239
+ in the directory carry a tag.
240
+
241
+ Scan for two markers per file — a role/type tag (`role:` or `type:` in frontmatter, or a leading `# Role:`
242
+ line) and a version/date stamp (a `YYYY-MM-DD` date or a `version:` frontmatter key, either in the first 10
243
+ lines). A file missing either marker is untagged — report the file list and count; do not escalate past R
244
+ without a human judging whether the specific file's staleness is actually a problem.
245
+
246
+ ```bash
247
+ # find | while, not a glob — same reason as the always-loaded footprint scan above: an unmatched
248
+ # glob aborts under zsh, and a silent zero-match run must still report, not disappear.
249
+ TARGET="${1:?pass the target root explicitly — cwd is not the target}"
250
+ total=0; untagged=0
251
+ while IFS= read -r f; do
252
+ [ -n "$f" ] || continue
253
+ total=$((total + 1))
254
+ # 연대기 기록물은 파일명에 날짜가 있는 것이 설계다 — taxonomy 대상이 아니다(FP 원인의 78/99)
255
+ case "$(basename "$f")" in fh_completed_*|fh_signal_*|frontier_digest_*|session_*|weekly_audit_*|*_log_*) continue ;; esac
256
+ grep -qE '^(role|type):|^# ?Role:' "$f" && tag=yes || tag=no
257
+ head -10 "$f" | grep -qE '[0-9]{4}-[0-9]{2}-[0-9]{2}|^version:' && stamp=yes || stamp=no
258
+ if [ "$tag" = no ] || [ "$stamp" = no ]; then
259
+ untagged=$((untagged + 1))
260
+ echo "UNTAGGED: $f (role-tag=$tag version-stamp=$stamp)"
261
+ fi
262
+ done < <(find "$TARGET/tracks/_meta" -maxdepth 1 -name '*.md' 2>/dev/null)
263
+ echo "context-file-taxonomy: $untagged untagged of $total files"
264
+ ```
265
+
266
+ **Named residuals of this scan**: `head -10` can miss a stamp in unusually long frontmatter; `^type:` is not
267
+ fence-scoped, so a stray body line starting `type:` outside frontmatter false-positives `tag=yes` — both push
268
+ toward under-reporting, not over-reporting.
269
+
270
+ Origin (2026-07-20, frontier-auto): surfaced via [Frontier Digest 2026-07-14](https://github.com/chrono-meta/forge-harness/issues/102#issuecomment-4964058520),
271
+ which described a durable-context-file pattern (role-tagged, versioned files shared across 50+ specialized
272
+ agents) citing `aimultiple.com/llm-orchestration` as its source. A `/phantom-quench` pass on 2026-07-20 found
273
+ that page's retrievable content does not actually discuss this pattern — the digest's citation is mis-attributed
274
+ and no verified primary source has been located. The qualitative taxonomy idea (role/version tagging on context
275
+ files) is adopted here on the digest's description alone and is `SPECULATIVE` per H1/H1-b until a verified
276
+ primary source is found; the "40% fewer tool calls" figure the digest also reported is not cited anywhere in
277
+ this check for the same reason.
278
+
232
279
  ### Step 3-L. Language Lint (`--lint` mode only)
233
280
 
234
281
  > Activate with `/harness-doctor --lint` or when harvest-loop surfaces a P10-series signal. Skipped in standard runs.