@chrono-meta/fh-gate 1.4.73 → 1.4.74
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.
- package/.claude-plugin/marketplace.json +2 -2
- package/docs/ETHOS.md +106 -0
- package/docs/OUTPUT_EVIDENCE.md +118 -0
- package/docs/WHY.md +42 -0
- package/knowledge/patterns/ensemble_union_detection_task_pattern.md +125 -0
- package/knowledge/shared/GLOSSARY.md +77 -0
- package/knowledge/shared/patterns/multi-persona-review.md +88 -0
- package/knowledge/shared/plugin-catalog/recommended_plugins.md +117 -0
- package/package.json +22 -1
- package/plugins/fh-commons/.claude-plugin/plugin.json +1 -1
- package/plugins/fh-meta/.claude-plugin/plugin.json +2 -2
- package/plugins/fh-meta/CHANGELOG.md +617 -0
- package/scripts/below_floor_scan.sh +91 -0
- package/scripts/chamber_run.sh +184 -0
- package/scripts/fh_env_delta_scan.sh +108 -0
- package/scripts/package_coverage_check.sh +119 -0
- package/scripts/selfcheck.sh +12 -0
- package/scripts/substrate_jump_detector.sh +60 -0
- package/scripts/test_marker_floor_lanes.sh +45 -0
- package/scripts/tier_census_grep.sh +54 -0
- package/templates/.claude/rules/session.md +153 -0
- package/templates/contrib_session.md +34 -0
- package/templates/goal-quench-hook-setup.md +152 -0
- package/templates/starter_profile.md +83 -0
- package/templates/temper_check.sh +46 -0
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: forge-harness Recommended Plugins Catalog
|
|
3
|
+
description: Persistent record of plugin-recommender skill execution results. The primary asset for plugin-recommender skill Step 2 [1st priority] Curated List. Updated cumulatively each time the skill runs.
|
|
4
|
+
date: 2026-05-08
|
|
5
|
+
version: 0.1
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# forge-harness Recommended Plugins Catalog
|
|
9
|
+
|
|
10
|
+
> Primary search asset for the plugin-recommender skill. Updated cumulatively each run.
|
|
11
|
+
|
|
12
|
+
## Run History
|
|
13
|
+
|
|
14
|
+
| Run | Date | Context | Result |
|
|
15
|
+
|:--:|---|---|---|
|
|
16
|
+
| 1 | 2026-05-07/08 | `.claudeignore` + model switching / project automation path | Organization GHE 0 items / Claude Code built-in sufficient / external OSS simulation phase |
|
|
17
|
+
| 2 | 2026-05-08 | UX Writing QA / NLP — self-simulation | Top asset utilization + md-wiki activation / external NLP plugin simulation phase |
|
|
18
|
+
| 3 | 2026-05-08 | Virtual: full-stack (React + Spring Boot) — self-simulation | `.claudeignore` big effect (node_modules·target·build) + model switching / external LSP·ESLint simulation phase |
|
|
19
|
+
| 4 | 2026-05-08 | **Organization GHE Tier 1 cross-recommendation simulation** — 5 repos | ★★★ 2 items + ★★ 3 items found / harness return value 4 paths |
|
|
20
|
+
| 5 | 2026-05-08 | **Organization GHE Tier 2 sister asset cross-recommendation simulation** — 6 repos | ★★★ 1 item + ★★ 4 items + ★ 2 items / Tier 1+2 cumulative n=11 |
|
|
21
|
+
|
|
22
|
+
## Category 0.5 — claude-plugins-official (Tier 1 official — check BEFORE building or searching elsewhere)
|
|
23
|
+
|
|
24
|
+
> **No-reinvention rule (meta-harness 철칙)**: if an official plugin covers the capability, use it —
|
|
25
|
+
> do not rebuild it as an FH skill or hunt third-party. FH builds only what adds *governance* on top.
|
|
26
|
+
> Source: [`anthropics/claude-plugins-official/plugins`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins)
|
|
27
|
+
> — inventory snapshot 2026-06-10 (36 plugins), **name-based grouping; verify each plugin's actual
|
|
28
|
+
> behavior via its README before install — do not trust the group label alone. Re-enumerate the
|
|
29
|
+
> directory when recommending; this list goes stale.**
|
|
30
|
+
|
|
31
|
+
| Group | Plugins | FH / mapped-project relevance |
|
|
32
|
+
|---|---|---|
|
|
33
|
+
| **Language servers (12)** | clangd · csharp · gopls · jdtls · kotlin · lua · php · pyright · ruby · rust-analyzer · swift · typescript (`*-lsp`) | Full-Harness Mode step 4: match to the mapped project's language — instant capability boost, zero FH build |
|
|
34
|
+
| **Dev workflow** | feature-dev · commit-commands · pr-review-toolkit · code-review · code-simplifier · code-modernization · frontend-design | Field-project execution layer. Role split: code work → these; FH-asset coherence → FH skills |
|
|
35
|
+
| **Authoring/extension** | skill-creator · plugin-dev · hookify · mcp-server-dev · agent-sdk-dev | Drafting tools. **FH 6-item gate still applies to anything they produce** |
|
|
36
|
+
| **Setup/session** | claude-code-setup · claude-md-management · mcp-tunnels · session-report · explanatory/learning-output-style | ⚠️ `claude-md-management` overlaps FH territory — role split: file mechanics → plugin; methodology/governance → FH. Evaluate before adopting |
|
|
37
|
+
| **Other** | security-guidance · ralph-loop · math-olympiad · playground · example-plugin · cwc-makers | `security-guidance`: candidate complement to Pre-Publish gate — evaluate |
|
|
38
|
+
|
|
39
|
+
## Category 1 — Claude Code Built-in (Standard usage / no install)
|
|
40
|
+
|
|
41
|
+
| Item | Mechanism | Usage path |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| **`.claudeignore`** | `.gitignore` syntax / per-session token cost 20-40% ↓ | `cp templates/.claudeignore <project>/.claudeignore` |
|
|
44
|
+
| **`/model` + model switching** | Switch models mid-session | `/model opus` / `/model sonnet` / `/model haiku` |
|
|
45
|
+
|
|
46
|
+
## Category 2 — Forge-Harness Meta Skills (already installed / use fully)
|
|
47
|
+
|
|
48
|
+
- **fh-meta 5 skills**: `harvest-loop` · `verify-bidirectional` · `frontier-digest` · `cross-ecosystem-synergy-detection` · `plugin-recommender`
|
|
49
|
+
- **`hub-persona-auditor`** + **`fact-checker`** agents
|
|
50
|
+
- **Active onboarding protocol** (forge-harness `CLAUDE.md`) — greeting/start trigger → 5-skill cascade
|
|
51
|
+
|
|
52
|
+
## Category 3 — Organization Internal Tools / MCP (install as needed)
|
|
53
|
+
|
|
54
|
+
> Replace this section with your organization's specific MCP tools and internal plugins.
|
|
55
|
+
|
|
56
|
+
| Item | Source | Usage path |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| **`<your-mcp-plugin>`** | `<your-org>/<your-plugin-repo>` | Configure in `.mcp.json` / refer to your organization's MCP setup guide |
|
|
59
|
+
|
|
60
|
+
### Examples of what to put here:
|
|
61
|
+
- Calendar / task management MCP (e.g., Google Calendar, Jira)
|
|
62
|
+
- Internal wiki / docs MCP
|
|
63
|
+
- Slack / messaging MCP
|
|
64
|
+
- Organization-specific API adapters
|
|
65
|
+
|
|
66
|
+
## Category 4 — External OSS (evaluate then decide / simulation phase)
|
|
67
|
+
|
|
68
|
+
| Item | Evaluation | Priority |
|
|
69
|
+
|---|---|---|
|
|
70
|
+
| TestSprite MCP | May be covered by internal tools | ⚠ Follow-up |
|
|
71
|
+
| TestCollab MCP | May be covered by internal tools | ⚠ Follow-up |
|
|
72
|
+
| claude-code-skills (levnikolaevich) | Possible overlap with fh-meta 5 skills | ⚠ Follow-up |
|
|
73
|
+
| ClaudeMarketplaces.com (4,200+ skills) | Additional search area — not covered in 1st run | ⚠ Follow-up |
|
|
74
|
+
| awesome-claude-skills (ComposioHQ) | Curated list — not covered in 1st run | ⚠ Follow-up |
|
|
75
|
+
|
|
76
|
+
## Domain-Specific Simulation Matrix (n=3 accumulated)
|
|
77
|
+
|
|
78
|
+
| Domain | ★★★ Immediate | ★★ Gradual | ★ Follow-up evaluation |
|
|
79
|
+
|---|---|---|---|
|
|
80
|
+
| **QA automation** (test prep automation) | `.claudeignore` · active onboarding · `verify-bidirectional` | `harvest-loop` | domain-specific test plugins |
|
|
81
|
+
| **Technical writing / docs QA** | `.claudeignore` · active onboarding · `<your-wiki-mcp>` · `verify-bidirectional` | `<your-messaging-mcp>` | NLP plugin |
|
|
82
|
+
| **Virtual full-stack** (React + Spring Boot) | `.claudeignore` (node_modules·target big effect) · active onboarding · `/model opus` for reasoning | `verify-bidirectional` | ESLint MCP · TS LSP |
|
|
83
|
+
|
|
84
|
+
### Common 3 items (all domains ★★★)
|
|
85
|
+
**`.claudeignore`** + **active onboarding protocol** + **harness meta skills**
|
|
86
|
+
|
|
87
|
+
→ These 3 are automatically applied in active onboarding Step 4 setup. Core of the user's fast path (direct implementation of harness mission — *"easy + no setup burden"*).
|
|
88
|
+
|
|
89
|
+
### Domain-differentiated tools
|
|
90
|
+
|
|
91
|
+
| Domain area | Differentiated tool |
|
|
92
|
+
|---|---|
|
|
93
|
+
| QA domain | `verify-bidirectional` · `harvest-loop` |
|
|
94
|
+
| Frontend/full-stack | `/model opus` (coding/reasoning split) |
|
|
95
|
+
| Wiki/documentation | `<your-wiki-mcp>` (publish · update · sync) |
|
|
96
|
+
| Collaboration notifications | `<your-messaging-mcp>` |
|
|
97
|
+
| All domains | harness meta skills (cross-validation) |
|
|
98
|
+
|
|
99
|
+
### n=3 simulation learnings (maturity improvement path)
|
|
100
|
+
|
|
101
|
+
1. **Common 3 auto-applied** — active onboarding protocol naturally manifests (no user burden)
|
|
102
|
+
2. **Domain-differentiated tools matched after user answer** (plugin-recommender 5-step)
|
|
103
|
+
3. **External OSS decided after evaluation** (simplification guard — 80%+ covered by harness meta skills)
|
|
104
|
+
4. **plugin-recommender skill v0.2 patch decision after 3+ runs** (currently at 3 runs)
|
|
105
|
+
|
|
106
|
+
## Update obligation (cumulative each run)
|
|
107
|
+
|
|
108
|
+
- Add 1 row to run history table
|
|
109
|
+
- Update per-category matrix (new recommendations / evaluation changes)
|
|
110
|
+
- Persist domain-specific results
|
|
111
|
+
- Immediately reflect when new insights are caught
|
|
112
|
+
|
|
113
|
+
## Next trigger
|
|
114
|
+
|
|
115
|
+
- On new work/project entry, read this file first → match against Category 1·2·3 first
|
|
116
|
+
- On external plugin search cycle, update Category 4 (ClaudeMarketplaces.com / awesome-claude-skills direct fetch)
|
|
117
|
+
- plugin-recommender skill v0.2 evolution: decide after 5-run accumulation
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chrono-meta/fh-gate",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.74",
|
|
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": [
|
|
@@ -63,8 +63,29 @@
|
|
|
63
63
|
"scripts/fh-goal.sh",
|
|
64
64
|
"scripts/count_check.sh",
|
|
65
65
|
"scripts/selfcheck.sh",
|
|
66
|
+
"scripts/package_coverage_check.sh",
|
|
66
67
|
"scripts/test_fh_gate_regressions.sh",
|
|
67
68
|
"templates/local_fh_context.md",
|
|
69
|
+
"docs/ETHOS.md",
|
|
70
|
+
"docs/WHY.md",
|
|
71
|
+
"docs/OUTPUT_EVIDENCE.md",
|
|
72
|
+
"knowledge/shared/GLOSSARY.md",
|
|
73
|
+
"knowledge/shared/patterns",
|
|
74
|
+
"knowledge/shared/plugin-catalog",
|
|
75
|
+
"knowledge/patterns",
|
|
76
|
+
"templates/CLAUDE.md",
|
|
77
|
+
"templates/starter_profile.md",
|
|
78
|
+
"templates/temper_check.sh",
|
|
79
|
+
"templates/contrib_session.md",
|
|
80
|
+
"templates/goal-quench-hook-setup.md",
|
|
81
|
+
"templates/.claude/rules/session.md",
|
|
82
|
+
"scripts/below_floor_scan.sh",
|
|
83
|
+
"scripts/chamber_run.sh",
|
|
84
|
+
"scripts/fh_env_delta_scan.sh",
|
|
85
|
+
"scripts/substrate_jump_detector.sh",
|
|
86
|
+
"scripts/tier_census_grep.sh",
|
|
87
|
+
"scripts/test_marker_floor_lanes.sh",
|
|
88
|
+
"plugins/fh-meta/CHANGELOG.md",
|
|
68
89
|
"knowledge/shared/learnings/subagent_invocations_log.yaml",
|
|
69
90
|
"scripts/chamber_candidate_collect.sh",
|
|
70
91
|
"scripts/fh_session_load.sh",
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fh-meta",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.74",
|
|
4
4
|
"engines": {
|
|
5
5
|
"claudeCode": ">=1.0.0"
|
|
6
6
|
},
|
|
7
|
-
"description": "New in 1.4.73: the mechanical floor now ships — templates/.git-hooks (pre-commit/pre-push) plus every script they actually invoke, their regression anchors, and the .claude/rules data they read. Until now the package shipped the prose that tells you to run the gates while omitting the gates, and 35 shipped-doc references pointed at files the tarball did not contain. Verified by unpacking the tarball, installing the hooks in a scratch repo and committing through them, not by inspecting files[]. degrade_direction_scan gains shell probes: it collected .sh files that no probe could match and reported them clean (known-positive scored 0/4); git hooks were invisible entirely because the extension test ran against the path, not the basename. The field-propagated templates/ copy had drifted from scripts/ and is now byte-pinned by an anchor. Hub meta-engineering toolkit — 35 skills + 7 agents. New in 1.4.71: SKILL_detail.md brought inside the 4-axis gate — the gate matched the literal `SKILL.md`, which `SKILL_detail.md` does not contain, leaving 27.7% of the skill-spec surface ungated (measured; it leaked twice for real). Fix escalated from a name list to a directory scope after an enumeration sweep found a real uncovered file on its first run; anchored by scripts/gate_pathspec_check.sh (known-pair, wired into pre-commit). One-way mirror sync gains a destination-newer abort + mechanically injected mirror banner after two session cards were silently overwritten, anchored by scripts/sync_guard_check.sh. dialogue-harvest gains Step 4-b cross-corpus provenance (absorbed / held-unused / declined) for single-author corpora, where the original provenance labels were free and measured nothing. frontier-digest arxiv leg category-scoped after a relevance drift the staleness rule structurally could not catch (known-pair calibration recorded). templates/CLAUDE.md hub paths switched to {FH_ROOT} so a copied harness stops carrying one operator's absolute paths into org-visible checkouts. New in 1.4.70: dialogue-harvest (mines AI-dialogue logs — sycophancy strip first, induced-vs-independent provenance labeling, EN+KO known-pair calibration shipped); asset-placement-gate Step 0.6 official-corpora check (Claude Cookbook as Tier-0 consult corpus, judged-flag semantics); context-doctor built-in-/doctor-first sister 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 gains a command-output axis — routes to a command-output proxy/hook (rtk) to trim verbose CLI stdout, complementing .claudeignore; risk-gated to token-scarce environments (lossy filtering, off gate-input paths). 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 scaffolds the companion store as a queryable wiki (INDEX + session-start read + Raw/Wiki/Conversation ingest axis). New in 1.4.39: auto-decorrelation (cross-family verifier sidecar recruitment, calibration-gated) + video-ingest (capability-routed video ingestion). New in 1.4.37: corpus-grounding-expander + persona-roster-expander (field-harvested verbatim-relay capability skills). New in 1.3.0: public-surface-audit (git-tracked private-token leak scan), field-harvest Mode B session-end auto-trigger, 4-axis gate scope extension (docs/ + AGENTS.md). New in 1.2.0: pipeline-conductor (4-pipeline gated sweep), return-path-gate (chain closure audit), goal-quench (Stop hook + quality gate), steel-quench Wave 5 (multi-model sidecar challenger), 2-layer architecture docs, YAML validation script. Validated cross-CLI: Claude Code, Codex, Gemini.",
|
|
7
|
+
"description": "New in 1.4.74: shipped documents no longer point at files the package omits. 35 such paths were measured on 2026-07-28 — CLAUDE.md instructed consumers to run templates/predelete_check.sh before a destructive op and the file did not ship. 20 more paths added; the 4 that remain absent are enumerated with a written reason each (per-environment registries and operator-private sync). Closing the set once is worth little because it regrows, so scripts/package_coverage_check.sh now fails selfcheck on any new occurrence, known-pair calibrated, and it caught itself on first wiring. New in 1.4.73: the mechanical floor now ships — templates/.git-hooks (pre-commit/pre-push) plus every script they actually invoke, their regression anchors, and the .claude/rules data they read. Until now the package shipped the prose that tells you to run the gates while omitting the gates, and 35 shipped-doc references pointed at files the tarball did not contain. Verified by unpacking the tarball, installing the hooks in a scratch repo and committing through them, not by inspecting files[]. degrade_direction_scan gains shell probes: it collected .sh files that no probe could match and reported them clean (known-positive scored 0/4); git hooks were invisible entirely because the extension test ran against the path, not the basename. The field-propagated templates/ copy had drifted from scripts/ and is now byte-pinned by an anchor. Hub meta-engineering toolkit — 35 skills + 7 agents. New in 1.4.71: SKILL_detail.md brought inside the 4-axis gate — the gate matched the literal `SKILL.md`, which `SKILL_detail.md` does not contain, leaving 27.7% of the skill-spec surface ungated (measured; it leaked twice for real). Fix escalated from a name list to a directory scope after an enumeration sweep found a real uncovered file on its first run; anchored by scripts/gate_pathspec_check.sh (known-pair, wired into pre-commit). One-way mirror sync gains a destination-newer abort + mechanically injected mirror banner after two session cards were silently overwritten, anchored by scripts/sync_guard_check.sh. dialogue-harvest gains Step 4-b cross-corpus provenance (absorbed / held-unused / declined) for single-author corpora, where the original provenance labels were free and measured nothing. frontier-digest arxiv leg category-scoped after a relevance drift the staleness rule structurally could not catch (known-pair calibration recorded). templates/CLAUDE.md hub paths switched to {FH_ROOT} so a copied harness stops carrying one operator's absolute paths into org-visible checkouts. New in 1.4.70: dialogue-harvest (mines AI-dialogue logs — sycophancy strip first, induced-vs-independent provenance labeling, EN+KO known-pair calibration shipped); asset-placement-gate Step 0.6 official-corpora check (Claude Cookbook as Tier-0 consult corpus, judged-flag semantics); context-doctor built-in-/doctor-first sister 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 gains a command-output axis — routes to a command-output proxy/hook (rtk) to trim verbose CLI stdout, complementing .claudeignore; risk-gated to token-scarce environments (lossy filtering, off gate-input paths). 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 scaffolds the companion store as a queryable wiki (INDEX + session-start read + Raw/Wiki/Conversation ingest axis). New in 1.4.39: auto-decorrelation (cross-family verifier sidecar recruitment, calibration-gated) + video-ingest (capability-routed video ingestion). New in 1.4.37: corpus-grounding-expander + persona-roster-expander (field-harvested verbatim-relay capability skills). New in 1.3.0: public-surface-audit (git-tracked private-token leak scan), field-harvest Mode B session-end auto-trigger, 4-axis gate scope extension (docs/ + AGENTS.md). New in 1.2.0: pipeline-conductor (4-pipeline gated sweep), return-path-gate (chain closure audit), goal-quench (Stop hook + quality gate), steel-quench Wave 5 (multi-model sidecar challenger), 2-layer architecture docs, YAML validation script. Validated cross-CLI: Claude Code, Codex, Gemini.",
|
|
8
8
|
"author": {
|
|
9
9
|
"name": "chrono-meta",
|
|
10
10
|
"email": "chrono-meta@users.noreply.github.com"
|