From 4ddf94c1b578a943ebbea782c914022260836836 Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Tue, 21 Jul 2026 15:14:12 +0900 Subject: [PATCH 01/13] fix(soft-shell): say "spec entry", not "shard", in AI-facing surfaces MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The AI mirrors the terminology it reads in the surfaces it consumes while serving a user — the persona prompts and the managed AGENTS.md / CLAUDE.md blocks cladding writes into a project. 0.9.1 kept "shard" there and relied on the AI translating it to "spec entry" at relay time; in practice the AI echoes "shard" verbatim. Use the plain term at the source instead: the managed blocks and persona prompts now say "spec entry" / "per-feature spec files", and the translate-by-meaning guidance drops the "shard = spec entry" example that re-exposed the word. A guard test (tests/shard-term-guard.test.ts) scans the rendered managed blocks + persona sources and fails on any "shard", so it can't creep back. "shard" stays in code, identifiers, --json machine messages, and maintainer docs. Reconciles the interpreter-rule test (no longer requires the removed example) and the repo's own CLAUDE.md (dogfood byte-parity). Adds F-876b6f48. Live: `clad init` generates an AGENTS.md with 0 "shard". Co-Authored-By: Claude Opus 4.8 --- CLAUDE.md | 8 +-- README.html | 4 +- README.ja.md | 4 +- README.ko.html | 4 +- README.ko.md | 4 +- README.md | 4 +- README.zh.md | 4 +- plugins/antigravity/skills/developer/SKILL.md | 2 +- .../antigravity/skills/observability/SKILL.md | 2 +- .../antigravity/skills/orchestrator/SKILL.md | 6 +-- plugins/antigravity/skills/planner/SKILL.md | 6 +-- plugins/antigravity/skills/reviewer/SKILL.md | 2 +- plugins/claude-code/agents/developer.md | 2 +- plugins/claude-code/agents/observability.md | 2 +- plugins/claude-code/agents/orchestrator.md | 6 +-- plugins/claude-code/agents/planner.md | 6 +-- plugins/claude-code/agents/reviewer.md | 2 +- plugins/claude-code/dist/agents/developer.md | 2 +- .../claude-code/dist/agents/observability.md | 2 +- .../claude-code/dist/agents/orchestrator.md | 6 +-- plugins/claude-code/dist/agents/planner.md | 6 +-- plugins/claude-code/dist/agents/reviewer.md | 2 +- plugins/claude-code/dist/clad.js | 4 +- plugins/codex/skills/developer/SKILL.md | 2 +- plugins/codex/skills/observability/SKILL.md | 2 +- plugins/codex/skills/orchestrator/SKILL.md | 6 +-- plugins/codex/skills/planner/SKILL.md | 6 +-- plugins/codex/skills/reviewer/SKILL.md | 2 +- spec.yaml | 4 +- spec/attestation.yaml | 51 ++++++++++--------- .../shard-term-to-spec-entry-876b6f48.yaml | 28 ++++++++++ spec/index.yaml | 1 + src/agents/developer.md | 2 +- src/agents/observability.md | 2 +- src/agents/orchestrator.md | 6 +-- src/agents/planner.md | 6 +-- src/agents/reviewer.md | 2 +- src/init/agents-md.ts | 4 +- src/init/host-instructions.ts | 8 +-- tests/agent-interpreter-rule.test.ts | 24 ++++----- tests/shard-term-guard.test.ts | 43 ++++++++++++++++ 41 files changed, 179 insertions(+), 110 deletions(-) create mode 100644 spec/features/shard-term-to-spec-entry-876b6f48.yaml create mode 100644 tests/shard-term-guard.test.ts diff --git a/CLAUDE.md b/CLAUDE.md index e3cf087d..404e9c09 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -99,9 +99,9 @@ When `ai_hints` conflicts with `CLAUDE.md` for cladding-self specifically, **`ai implements; whoever authors a unit must not sign off on it (anti-self-cert). **Feature cycle — one at a time** — One feature end-to-end before the next: -author its shard (`acceptance_criteria` + `modules`) → implement → author tests +author its spec entry (`acceptance_criteria` + `modules`) → implement → author tests in a separate context → `clad done ` (sets `status: done` only when -`clad check --tier=pre-push --strict` is GREEN). Never author shards ahead of +`clad check --tier=pre-push --strict` is GREEN). Never author spec entries ahead of their code, or hand-write `status: done`. See `docs/feature-cycle.md`. **Hash-based IDs** — Never hand-author `F-NNN` filenames; use the `clad` CLI @@ -111,6 +111,6 @@ their code, or hand-write `status: done`. See `docs/feature-cycle.md`. findings — fix them or update spec. **Speak the user's language** — when reporting to the user, translate -cladding terms into plain words in the user's own language (a shard = a spec -entry) — including cladding's own gate and hook messages: relay them by +cladding terms into plain words in the user's own language — including +cladding's own gate and hook messages: relay them by meaning. Never lead with internal ids. diff --git a/README.html b/README.html index 5e7a96b8..5962cc16 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -548,7 +548,7 @@

Status

tests
-
2602/2602
+
2605/2605
all pass
diff --git a/README.ja.md b/README.ja.md index d6f5ee60..773273c6 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -339,7 +339,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2602 / 2602 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 段階 · 41 detectors | 261（258 done） | 236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック diff --git a/README.ko.html b/README.ko.html index c304e32d..d47a2056 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -584,7 +584,7 @@

Status

tests
-
2602/2602
+
2605/2605
all pass
diff --git a/README.ko.md b/README.ko.md index 3d9db6d8..38e7b049 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -338,7 +338,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2602 / 2602 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | 236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 diff --git a/README.md b/README.md index 979e893c..f5348851 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -352,7 +352,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2602 / 2602 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 stages · 41 detectors | 261 (258 done) | 236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector diff --git a/README.zh.md b/README.zh.md index 12839a2e..bfc2ceb9 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -335,7 +335,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2602 / 2602 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 阶段 · 41 检测器 | 261（258 done） | 236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 diff --git a/plugins/antigravity/skills/developer/SKILL.md b/plugins/antigravity/skills/developer/SKILL.md index 7393b7cf..853c7106 100644 --- a/plugins/antigravity/skills/developer/SKILL.md +++ b/plugins/antigravity/skills/developer/SKILL.md @@ -82,4 +82,4 @@ Advisory (no detector enforces it) — but after your edits the hook auto-surfac ## User-facing language (Soft Shell) -Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/antigravity/skills/observability/SKILL.md b/plugins/antigravity/skills/observability/SKILL.md index 5beb1a28..a792c05e 100644 --- a/plugins/antigravity/skills/observability/SKILL.md +++ b/plugins/antigravity/skills/observability/SKILL.md @@ -47,4 +47,4 @@ When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: ## User-facing language (Soft Shell) -The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/antigravity/skills/orchestrator/SKILL.md b/plugins/antigravity/skills/orchestrator/SKILL.md index bf8d0c1e..641d2e2d 100644 --- a/plugins/antigravity/skills/orchestrator/SKILL.md +++ b/plugins/antigravity/skills/orchestrator/SKILL.md @@ -35,14 +35,14 @@ You do NOT pre-load Tier C (conventions — developer's concern). Drive development as a per-feature **cycle**, detailed in [`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (shard + ACs) → `developer` (code) → test-author (separate context) → +`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → `reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author shards ahead of the code +gates dispose.** Do NOT author spec entries ahead of the code that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: @@ -86,4 +86,4 @@ When delegating, attach: ## User-facing language (Soft Shell) -Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — shard = spec entry, attestation = sign-off, finding = what drifted and why; never lead with ids. +Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — attestation = sign-off, finding = what drifted and why; never lead with ids. diff --git a/plugins/antigravity/skills/planner/SKILL.md b/plugins/antigravity/skills/planner/SKILL.md index 7736e7b7..edf9ab5f 100644 --- a/plugins/antigravity/skills/planner/SKILL.md +++ b/plugins/antigravity/skills/planner/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + sharded `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -27,7 +27,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. -- Shard `spec.yaml` into `spec/features/*.yaml` when the master crosses ~1k lines. +- Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. - Run `npm run spec:validate` and `npm run stage:drift` after every edit. @@ -70,4 +70,4 @@ Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If ## User-facing language (Soft Shell) -The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/antigravity/skills/reviewer/SKILL.md b/plugins/antigravity/skills/reviewer/SKILL.md index 837d92e0..e7c6e110 100644 --- a/plugins/antigravity/skills/reviewer/SKILL.md +++ b/plugins/antigravity/skills/reviewer/SKILL.md @@ -78,4 +78,4 @@ You also own the **advisory half no gate enforces**: confirm the test-author wro ## User-facing language (Soft Shell) -The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/agents/developer.md b/plugins/claude-code/agents/developer.md index 7393b7cf..853c7106 100644 --- a/plugins/claude-code/agents/developer.md +++ b/plugins/claude-code/agents/developer.md @@ -82,4 +82,4 @@ Advisory (no detector enforces it) — but after your edits the hook auto-surfac ## User-facing language (Soft Shell) -Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/agents/observability.md b/plugins/claude-code/agents/observability.md index 5beb1a28..a792c05e 100644 --- a/plugins/claude-code/agents/observability.md +++ b/plugins/claude-code/agents/observability.md @@ -47,4 +47,4 @@ When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: ## User-facing language (Soft Shell) -The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/agents/orchestrator.md b/plugins/claude-code/agents/orchestrator.md index bf8d0c1e..641d2e2d 100644 --- a/plugins/claude-code/agents/orchestrator.md +++ b/plugins/claude-code/agents/orchestrator.md @@ -35,14 +35,14 @@ You do NOT pre-load Tier C (conventions — developer's concern). Drive development as a per-feature **cycle**, detailed in [`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (shard + ACs) → `developer` (code) → test-author (separate context) → +`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → `reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author shards ahead of the code +gates dispose.** Do NOT author spec entries ahead of the code that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: @@ -86,4 +86,4 @@ When delegating, attach: ## User-facing language (Soft Shell) -Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — shard = spec entry, attestation = sign-off, finding = what drifted and why; never lead with ids. +Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — attestation = sign-off, finding = what drifted and why; never lead with ids. diff --git a/plugins/claude-code/agents/planner.md b/plugins/claude-code/agents/planner.md index 7736e7b7..edf9ab5f 100644 --- a/plugins/claude-code/agents/planner.md +++ b/plugins/claude-code/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + sharded `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -27,7 +27,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. -- Shard `spec.yaml` into `spec/features/*.yaml` when the master crosses ~1k lines. +- Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. - Run `npm run spec:validate` and `npm run stage:drift` after every edit. @@ -70,4 +70,4 @@ Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If ## User-facing language (Soft Shell) -The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/agents/reviewer.md b/plugins/claude-code/agents/reviewer.md index 837d92e0..e7c6e110 100644 --- a/plugins/claude-code/agents/reviewer.md +++ b/plugins/claude-code/agents/reviewer.md @@ -78,4 +78,4 @@ You also own the **advisory half no gate enforces**: confirm the test-author wro ## User-facing language (Soft Shell) -The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/dist/agents/developer.md b/plugins/claude-code/dist/agents/developer.md index 7393b7cf..853c7106 100644 --- a/plugins/claude-code/dist/agents/developer.md +++ b/plugins/claude-code/dist/agents/developer.md @@ -82,4 +82,4 @@ Advisory (no detector enforces it) — but after your edits the hook auto-surfac ## User-facing language (Soft Shell) -Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/dist/agents/observability.md b/plugins/claude-code/dist/agents/observability.md index 5beb1a28..a792c05e 100644 --- a/plugins/claude-code/dist/agents/observability.md +++ b/plugins/claude-code/dist/agents/observability.md @@ -47,4 +47,4 @@ When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: ## User-facing language (Soft Shell) -The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/dist/agents/orchestrator.md b/plugins/claude-code/dist/agents/orchestrator.md index bf8d0c1e..641d2e2d 100644 --- a/plugins/claude-code/dist/agents/orchestrator.md +++ b/plugins/claude-code/dist/agents/orchestrator.md @@ -35,14 +35,14 @@ You do NOT pre-load Tier C (conventions — developer's concern). Drive development as a per-feature **cycle**, detailed in [`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (shard + ACs) → `developer` (code) → test-author (separate context) → +`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → `reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author shards ahead of the code +gates dispose.** Do NOT author spec entries ahead of the code that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: @@ -86,4 +86,4 @@ When delegating, attach: ## User-facing language (Soft Shell) -Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — shard = spec entry, attestation = sign-off, finding = what drifted and why; never lead with ids. +Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — attestation = sign-off, finding = what drifted and why; never lead with ids. diff --git a/plugins/claude-code/dist/agents/planner.md b/plugins/claude-code/dist/agents/planner.md index 7736e7b7..edf9ab5f 100644 --- a/plugins/claude-code/dist/agents/planner.md +++ b/plugins/claude-code/dist/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + sharded `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -27,7 +27,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. -- Shard `spec.yaml` into `spec/features/*.yaml` when the master crosses ~1k lines. +- Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. - Run `npm run spec:validate` and `npm run stage:drift` after every edit. @@ -70,4 +70,4 @@ Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If ## User-facing language (Soft Shell) -The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/dist/agents/reviewer.md b/plugins/claude-code/dist/agents/reviewer.md index 837d92e0..e7c6e110 100644 --- a/plugins/claude-code/dist/agents/reviewer.md +++ b/plugins/claude-code/dist/agents/reviewer.md @@ -78,4 +78,4 @@ You also own the **advisory half no gate enforces**: confirm the test-author wro ## User-facing language (Soft Shell) -The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/claude-code/dist/clad.js b/plugins/claude-code/dist/clad.js index f7c74bc8..be06ec71 100755 --- a/plugins/claude-code/dist/clad.js +++ b/plugins/claude-code/dist/clad.js @@ -673,7 +673,7 @@ ${t}`}function eX(t,e,r){if(!e)return{ok:!1,code:2,featureId:e,reason:"feature i `)){let r=e.trim();if(r)return r}}function SDe(t){for(let n of t){let i=(n.findings??[]).filter(a=>a.path&&a.severity!=="info");if(i.length===0)continue;let o=i.find(a=>a.line!==void 0)??i[0];return`${o.line!==void 0?`${o.path}:${o.line}`:o.path} ${o.detector}: ${o.message}`}let e=t[0],r=DX(e?.stderr);return e?r?`${e.label}: ${r}`:`${e.label} failed`:"gate failed"}function NX(t){let{outcome:e,spec:r}=t,n=r.features??[],i=n.filter(bDe),o=i.filter(u=>u.status!=="done").map(u=>({id:u.id,slug:u.slug??"",status:u.status}));if(n.length===0)return{verdict:"BOOTSTRAP",next_action:"no features declared \u2014 create one with clad_create_feature, then run the gate",remaining:[]};let s=e.stages??[];if(e.anyFailed||e.worst>0){let u=s.filter(p=>ci(p.status)),d=u.find(p=>p.status==="pending_env"||p.status==="advisory");if(d){let p=DX(d.stderr);return{verdict:"ESCALATE",next_action:p?`${d.label}: ${p}`:`${d.label} needs a human or an environment it cannot self-supply`,remaining:o,halt_class:"HUMAN_REQUIRED"}}let f=SDe(u);return t.stuck===!0?{verdict:"ESCALATE",next_action:`${f} \u2014 no progress: identical gate findings twice, needs a human`,remaining:o,halt_class:"GATE_NO_PROGRESS"}:{verdict:"ITERATE",next_action:f,remaining:o}}let c=i.every(u=>u.status==="done"),l=s.some(u=>_De.has(u.stage)&&u.status==="pass");if(c&&l)return{verdict:"DONE",next_action:null,remaining:o};if(!c){let u=new Set(i.filter(p=>p.status==="done").map(p=>p.id)),d=i.filter(p=>p.status!=="done"),f=d.find(p=>(p.depends_on??[]).every(m=>u.has(m)));return f?{verdict:"ITERATE",next_action:`implement ${vDe(f)} (${f.id})`,remaining:o}:{verdict:"BLOCKED",next_action:`${d.length} feature(s) blocked on unfinished dependencies`,remaining:o}}return{verdict:"ITERATE",next_action:"gate is green but no behavioral proof ran \u2014 add a test/oracle/smoke that actually executes the code",remaining:o}}function MX(){return EDe(Kp.cwd(),".cladding","verdict-progress.json")}function ADe(){try{let t=JSON.parse(xDe(MX(),"utf8")),e=typeof t.fingerprint=="string"?t.fingerprint:void 0,r=typeof t.repeat=="number"?t.repeat:void 0;return e===void 0?void 0:{fingerprint:e,repeat:r??1}}catch{return}}function TDe(t){try{let e=MX();wDe(kDe(e),{recursive:!0}),$De(e,`${JSON.stringify(t)} `,"utf8")}catch{}}function FX(t,e){let r;try{r=q()}catch(c){let l={verdict:"ESCALATE",next_action:`spec could not be loaded: ${c.message} \u2014 fix the spec, then run the gate`,remaining:[],halt_class:"SPEC_UNREADABLE"};jX(l,t.json===!0),Kp.exit(0)}let n=e.checkStages({tier:t.tier??"pre-push",strict:!0,silent:!0}),i=ADe(),o=PX(n.stages??[]),s=CX(o,i);TDe({fingerprint:s.fingerprint,repeat:s.repeat});let a=NX({outcome:n,spec:r,stuck:s.stuck});jX(a,t.json===!0),Kp.exit(0)}function jX(t,e){if(e){Kp.stdout.write(`${JSON.stringify(t,null,2)} `);return}let r=t.next_action?` \u2014 ${t.next_action}`:"";Kp.stdout.write(`verdict: ${t.verdict}${r} -`)}import{existsSync as qX,readFileSync as GDe}from"node:fs";import{join as w1}from"node:path";import{existsSync as ODe,readFileSync as RDe,writeFileSync as $S}from"node:fs";import{join as IDe}from"node:path";var b1="## cladding",kS="## cladding\n\n**Spec is SSoT** \u2014 `spec.yaml` is authoritative; code must satisfy its\n`features[]` and `acceptance_criteria`. Run `clad check --strict` before commit.\n\n**Persona separation** \u2014 planner writes spec, reviewer audits, developer\nimplements; whoever authors a unit must not sign off on it (anti-self-cert).\n\n**Feature cycle \u2014 one at a time** \u2014 One feature end-to-end before the next:\nauthor its shard (`acceptance_criteria` + `modules`) \u2192 implement \u2192 author tests\nin a separate context \u2192 `clad done ` (sets `status: done` only when\n`clad check --tier=pre-push --strict` is GREEN). Never author shards ahead of\ntheir code, or hand-write `status: done`. See `docs/feature-cycle.md`.\n\n**Hash-based IDs** \u2014 Never hand-author `F-NNN` filenames; use the `clad` CLI\n(or `/cladding:init`). Model in `docs/spec-ids-multi-dev.md`.\n\n**Drift detectors** \u2014 `clad check --strict` runs them all; don't suppress\nfindings \u2014 fix them or update spec.\n\n**Speak the user's language** \u2014 when reporting to the user, translate\ncladding terms into plain words in the user's own language (a shard = a spec\nentry) \u2014 including cladding's own gate and hook messages: relay them by\nmeaning. Never lead with internal ids.\n",PDe=["_meta.enrichment_status","first-task enrichment rule","enrichment_scope"],CDe="Feature cycle \u2014 one at a time",DDe="anti-self-cert";function NDe(t){return!!(PDe.some(r=>t.includes(r))||/clad_create_feature[^.\n]{0,40}MCP\s*\n?\s*tool/i.test(t)&&!t.includes("clad` CLI")&&!t.includes("clad CLI")||t.includes(DDe)&&!t.includes(CDe))}function zX(t,e={}){let r=IDe(t,"CLAUDE.md");if(!ODe(r))return $S(r,kS),"created";let n=RDe(r,"utf8");if(!n.includes(b1)){let s=n.endsWith(` +`)}import{existsSync as qX,readFileSync as GDe}from"node:fs";import{join as w1}from"node:path";import{existsSync as ODe,readFileSync as RDe,writeFileSync as $S}from"node:fs";import{join as IDe}from"node:path";var b1="## cladding",kS="## cladding\n\n**Spec is SSoT** \u2014 `spec.yaml` is authoritative; code must satisfy its\n`features[]` and `acceptance_criteria`. Run `clad check --strict` before commit.\n\n**Persona separation** \u2014 planner writes spec, reviewer audits, developer\nimplements; whoever authors a unit must not sign off on it (anti-self-cert).\n\n**Feature cycle \u2014 one at a time** \u2014 One feature end-to-end before the next:\nauthor its spec entry (`acceptance_criteria` + `modules`) \u2192 implement \u2192 author tests\nin a separate context \u2192 `clad done ` (sets `status: done` only when\n`clad check --tier=pre-push --strict` is GREEN). Never author spec entries ahead of\ntheir code, or hand-write `status: done`. See `docs/feature-cycle.md`.\n\n**Hash-based IDs** \u2014 Never hand-author `F-NNN` filenames; use the `clad` CLI\n(or `/cladding:init`). Model in `docs/spec-ids-multi-dev.md`.\n\n**Drift detectors** \u2014 `clad check --strict` runs them all; don't suppress\nfindings \u2014 fix them or update spec.\n\n**Speak the user's language** \u2014 when reporting to the user, translate\ncladding terms into plain words in the user's own language \u2014 including\ncladding's own gate and hook messages: relay them by\nmeaning. Never lead with internal ids.\n",PDe=["_meta.enrichment_status","first-task enrichment rule","enrichment_scope"],CDe="Feature cycle \u2014 one at a time",DDe="anti-self-cert";function NDe(t){return!!(PDe.some(r=>t.includes(r))||/clad_create_feature[^.\n]{0,40}MCP\s*\n?\s*tool/i.test(t)&&!t.includes("clad` CLI")&&!t.includes("clad CLI")||t.includes(DDe)&&!t.includes(CDe))}function zX(t,e={}){let r=IDe(t,"CLAUDE.md");if(!ODe(r))return $S(r,kS),"created";let n=RDe(r,"utf8");if(!n.includes(b1)){let s=n.endsWith(` `)?` `:` @@ -697,7 +697,7 @@ ${r.join(` ${n} `:` `,a=LDe.map(([l,u])=>`- ${l} \u2014 ${u}`).join(` -`),c=i?` The default persona for this project is **${i}**.`:"";return["This project is managed by **cladding** \u2014 the Spec-Anchored Agent Harness.","The lines between the `clad:agents-md` markers are generated from `spec.yaml`; edit the spec, not them. Everything OUTSIDE the markers is yours to keep.","",o,s.replace(/\n$/,""),"","## Single source of truth","","- `spec.yaml` is authoritative (Tier A); code must conform to its `features[]` and"," `acceptance_criteria`. Feature detail lives in `spec/features/-.yaml` \u2014"," never hand-author `F-NNN` filenames; ask cladding via the `clad` CLI (or"," `clad_create_feature` when your host has cladding wired as an MCP server).","- For shell commands, use `node .cladding/host/serve.cjs ` when that"," project launcher exists; it pins the CLI to the same engine as MCP. Fall back to"," `clad ` only when the project has no launcher.","- Run the resolved Cladding command with `check --strict` to verify spec \u2194 code"," across every drift detector.",qDe(e).replace(/\n$/,""),"","## Feature cycle \u2014 one at a time","","Finish ONE feature end-to-end before the next: author its shard (`acceptance_criteria`","+ `modules`) \u2192 implement \u2192 author tests in a separate context \u2192 run the declared test","command and confirm it collected relevant tests \u2192 run the resolved Cladding command","with `done ` (sets `status: done` only when the strict pre-push gate is","GREEN). Package test scripts must not depend on shell-expanded glob patterns. Do not","author shards ahead of their code, or hand-write `status: done`.","","## Design evolves with each feature","","Before implementation, classify the feature as: no design impact, an additive","capability/scenario link, or a structural change. Apply deterministic links directly;","preview architecture or project-context changes for the user. Do not finish a feature","while a material design impact remains unresolved, and do not churn design documents","for internal fixes that genuinely have no design impact.",UDe(t).replace(/\n$/,""),"","## Personas \u2014 cross-host capability map (anti-self-cert)","",`The agent that writes a unit of work must not sign off on it.${c} Each`,"persona and the vendor-neutral capabilities it may use \u2014 so Codex, Gemini, and other","AGENTS.md readers receive the same guidance Claude does:","",a,"","## Speak the user's language","","Translate cladding's vocabulary into plain words in the user's own language when you","report progress \u2014 relay gate/hook messages by meaning, and never lead with an internal","id (`F-\u2026`, `AC-\u2026`, `stage_X.Y`): name the feature and the plain outcome instead."].join(` +`),c=i?` The default persona for this project is **${i}**.`:"";return["This project is managed by **cladding** \u2014 the Spec-Anchored Agent Harness.","The lines between the `clad:agents-md` markers are generated from `spec.yaml`; edit the spec, not them. Everything OUTSIDE the markers is yours to keep.","",o,s.replace(/\n$/,""),"","## Single source of truth","","- `spec.yaml` is authoritative (Tier A); code must conform to its `features[]` and"," `acceptance_criteria`. Feature detail lives in `spec/features/-.yaml` \u2014"," never hand-author `F-NNN` filenames; ask cladding via the `clad` CLI (or"," `clad_create_feature` when your host has cladding wired as an MCP server).","- For shell commands, use `node .cladding/host/serve.cjs ` when that"," project launcher exists; it pins the CLI to the same engine as MCP. Fall back to"," `clad ` only when the project has no launcher.","- Run the resolved Cladding command with `check --strict` to verify spec \u2194 code"," across every drift detector.",qDe(e).replace(/\n$/,""),"","## Feature cycle \u2014 one at a time","","Finish ONE feature end-to-end before the next: author its spec entry (`acceptance_criteria`","+ `modules`) \u2192 implement \u2192 author tests in a separate context \u2192 run the declared test","command and confirm it collected relevant tests \u2192 run the resolved Cladding command","with `done ` (sets `status: done` only when the strict pre-push gate is","GREEN). Package test scripts must not depend on shell-expanded glob patterns. Do not","author spec entries ahead of their code, or hand-write `status: done`.","","## Design evolves with each feature","","Before implementation, classify the feature as: no design impact, an additive","capability/scenario link, or a structural change. Apply deterministic links directly;","preview architecture or project-context changes for the user. Do not finish a feature","while a material design impact remains unresolved, and do not churn design documents","for internal fixes that genuinely have no design impact.",UDe(t).replace(/\n$/,""),"","## Personas \u2014 cross-host capability map (anti-self-cert)","",`The agent that writes a unit of work must not sign off on it.${c} Each`,"persona and the vendor-neutral capabilities it may use \u2014 so Codex, Gemini, and other","AGENTS.md readers receive the same guidance Claude does:","",a,"","## Speak the user's language","","Translate cladding's vocabulary into plain words in the user's own language when you","report progress \u2014 relay gate/hook messages by meaning, and never lead with an internal","id (`F-\u2026`, `AC-\u2026`, `stage_X.Y`): name the feature and the plain outcome instead."].join(` `).replace(/\n{3,}/g,` `).trim()}function HDe(t,e){let r=t.includes(`\r diff --git a/plugins/codex/skills/developer/SKILL.md b/plugins/codex/skills/developer/SKILL.md index 7393b7cf..853c7106 100644 --- a/plugins/codex/skills/developer/SKILL.md +++ b/plugins/codex/skills/developer/SKILL.md @@ -82,4 +82,4 @@ Advisory (no detector enforces it) — but after your edits the hook auto-surfac ## User-facing language (Soft Shell) -Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/codex/skills/observability/SKILL.md b/plugins/codex/skills/observability/SKILL.md index 5beb1a28..a792c05e 100644 --- a/plugins/codex/skills/observability/SKILL.md +++ b/plugins/codex/skills/observability/SKILL.md @@ -47,4 +47,4 @@ When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: ## User-facing language (Soft Shell) -The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/codex/skills/orchestrator/SKILL.md b/plugins/codex/skills/orchestrator/SKILL.md index bf8d0c1e..641d2e2d 100644 --- a/plugins/codex/skills/orchestrator/SKILL.md +++ b/plugins/codex/skills/orchestrator/SKILL.md @@ -35,14 +35,14 @@ You do NOT pre-load Tier C (conventions — developer's concern). Drive development as a per-feature **cycle**, detailed in [`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (shard + ACs) → `developer` (code) → test-author (separate context) → +`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → `reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author shards ahead of the code +gates dispose.** Do NOT author spec entries ahead of the code that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: @@ -86,4 +86,4 @@ When delegating, attach: ## User-facing language (Soft Shell) -Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — shard = spec entry, attestation = sign-off, finding = what drifted and why; never lead with ids. +Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — attestation = sign-off, finding = what drifted and why; never lead with ids. diff --git a/plugins/codex/skills/planner/SKILL.md b/plugins/codex/skills/planner/SKILL.md index 7736e7b7..edf9ab5f 100644 --- a/plugins/codex/skills/planner/SKILL.md +++ b/plugins/codex/skills/planner/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + sharded `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -27,7 +27,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. -- Shard `spec.yaml` into `spec/features/*.yaml` when the master crosses ~1k lines. +- Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. - Run `npm run spec:validate` and `npm run stage:drift` after every edit. @@ -70,4 +70,4 @@ Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If ## User-facing language (Soft Shell) -The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/plugins/codex/skills/reviewer/SKILL.md b/plugins/codex/skills/reviewer/SKILL.md index 837d92e0..e7c6e110 100644 --- a/plugins/codex/skills/reviewer/SKILL.md +++ b/plugins/codex/skills/reviewer/SKILL.md @@ -78,4 +78,4 @@ You also own the **advisory half no gate enforces**: confirm the test-author wro ## User-facing language (Soft Shell) -The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/spec.yaml b/spec.yaml index c7444b70..4fcae76c 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 262 + features: 263 scenarios: 2 capabilities: 6 - test_files: 243 + test_files: 244 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index a36e8d8f..ea220c95 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -18,14 +18,14 @@ attested_modules: .github/workflows/ci.yml: 8ea99219cb80df60 .gitignore: 1294975ba3b47043 CHANGELOG.md: c3353cc4baf17ec7 - CLAUDE.md: 16212c1749e6005d + CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: f9378f61e0073367 - README.ja.md: 1b94669e076dd9c9 - README.ko.html: 9209820dc1e7a57a - README.ko.md: 160a0845e8775bf6 - README.md: 81c9c6691e1ce51b - README.zh.md: 1572f023debba60d + README.html: 5279f49be32246a1 + README.ja.md: 7500babce103dd55 + README.ko.html: 68cb46e739415abc + README.ko.md: fe0f25795546c550 + README.md: bd81ec36d52b7118 + README.zh.md: d139855a357f0818 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -70,22 +70,22 @@ attested_modules: package-lock.json: dc094f923ab99ab8 package.json: 5fc7fe2a9f18a959 plugins/claude-code/.claude-plugin/plugin.json: 4daaab360fbbea9e - plugins/claude-code/agents/developer.md: 40af2943253f6c72 - plugins/claude-code/agents/observability.md: 5ea8f14b1c9b4a61 - plugins/claude-code/agents/orchestrator.md: 443c6e13ade590cf - plugins/claude-code/agents/planner.md: 5750002ebdfb43f1 - plugins/claude-code/agents/reviewer.md: 9c4e095e60040473 + plugins/claude-code/agents/developer.md: 2c4547977f46913e + plugins/claude-code/agents/observability.md: 150da78e2ba51885 + plugins/claude-code/agents/orchestrator.md: acd60ec32857fbe3 + plugins/claude-code/agents/planner.md: 8fbc7ea526889c5f + plugins/claude-code/agents/reviewer.md: 9928347c71265757 plugins/claude-code/commands/init.md: 5529b13d0f1ab4bf plugins/claude-code/hooks/hooks.json: 42321ead26fb1da8 plugins/codex/.codex-plugin/plugin.json: 835ff6366182f1ea plugins/codex/.mcp.json: 43e3f4b2af24aa18 plugins/codex/skills/check/SKILL.md: 6a665422af510e72 - plugins/codex/skills/developer/SKILL.md: 40af2943253f6c72 + plugins/codex/skills/developer/SKILL.md: 2c4547977f46913e plugins/codex/skills/init/SKILL.md: 5529b13d0f1ab4bf - plugins/codex/skills/observability/SKILL.md: 5ea8f14b1c9b4a61 - plugins/codex/skills/orchestrator/SKILL.md: 443c6e13ade590cf - plugins/codex/skills/planner/SKILL.md: 5750002ebdfb43f1 - plugins/codex/skills/reviewer/SKILL.md: 9c4e095e60040473 + plugins/codex/skills/observability/SKILL.md: 150da78e2ba51885 + plugins/codex/skills/orchestrator/SKILL.md: acd60ec32857fbe3 + plugins/codex/skills/planner/SKILL.md: 8fbc7ea526889c5f + plugins/codex/skills/reviewer/SKILL.md: 9928347c71265757 plugins/codex/skills/run/SKILL.md: 9f95ff17d70c8dd1 plugins/codex/skills/serve/SKILL.md: f08bbdbbfeb05041 plugins/codex/skills/status/SKILL.md: 09faadc50b3449da @@ -113,7 +113,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: f3b85cd5c92644ce + spec.yaml: f03bdc6a66336832 spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -135,12 +135,12 @@ attested_modules: src/agents: a4d0f0eb87fed960 src/agents/README.md: b9fe459af1d36e8d src/agents/blind-author.md: e9d2977f9879d3f9 - src/agents/developer.md: 40af2943253f6c72 + src/agents/developer.md: 2c4547977f46913e src/agents/loader.ts: 6d35560c47f9ae85 - src/agents/observability.md: 5ea8f14b1c9b4a61 - src/agents/orchestrator.md: 443c6e13ade590cf - src/agents/planner.md: 5750002ebdfb43f1 - src/agents/reviewer.md: 9c4e095e60040473 + src/agents/observability.md: 150da78e2ba51885 + src/agents/orchestrator.md: acd60ec32857fbe3 + src/agents/planner.md: 8fbc7ea526889c5f + src/agents/reviewer.md: 9928347c71265757 src/changelog/collect.ts: a6c936a7b8c34e2a src/changelog/render.ts: 83dd2d95f24ca68c src/cli: a4d0f0eb87fed960 @@ -202,9 +202,9 @@ attested_modules: src/hitl/anti-self-cert.ts: 53a714d8e489d00a src/hitl/audit.ts: 79b06e904815469a src/hitl/identity.ts: 52ff84aa666f1dab - src/init/agents-md.ts: 7dc05f6d82e5c3ce + src/init/agents-md.ts: 3eb5ed2c7b6edc8c src/init/git-hook.ts: b77910b0df392cbf - src/init/host-instructions.ts: 7a066c646f0b6133 + src/init/host-instructions.ts: c598f8598d8d1cd4 src/init/host-setup.ts: 158cc9306a746da1 src/optimizer: a4d0f0eb87fed960 src/optimizer/code-excerpt.ts: e2c4598efcd28d2a @@ -601,6 +601,7 @@ attested_features: F-803386ab: ok F-80d19d: ok F-836a90: ok + F-876b6f48: ok F-898783ee: ok F-8f419e: ok F-904495a5: ok diff --git a/spec/features/shard-term-to-spec-entry-876b6f48.yaml b/spec/features/shard-term-to-spec-entry-876b6f48.yaml new file mode 100644 index 00000000..3f57586e --- /dev/null +++ b/spec/features/shard-term-to-spec-entry-876b6f48.yaml @@ -0,0 +1,28 @@ +id: F-876b6f48 +slug: shard-term-to-spec-entry +title: "AI-facing surfaces say \"spec entry\", not \"shard\"" +status: done +modules: + - src/init/agents-md.ts + - src/init/host-instructions.ts + - src/agents/planner.md + - src/agents/developer.md + - src/agents/reviewer.md + - src/agents/observability.md + - src/agents/orchestrator.md +acceptance_criteria: + - id: AC-c5593b9e + ears: ubiquitous + response: "renderAgentsMdManagedBlock output and CLAUDE_MD_SECTION contain no /\\bshards?\\b/i" + text: "The managed AGENTS.md and CLAUDE.md blocks cladding writes into a project shall refer to a per-feature spec file as a 'spec entry', never 'shard'." + test_refs: ["tests/shard-term-guard.test.ts"] + - id: AC-918035ef + ears: ubiquitous + response: "every src/agents/*.md contains no /\\bshards?\\b/i" + text: "Persona prompts shall use 'spec entry' rather than 'shard', and the translate-by-meaning guidance shall not carry a 'shard = spec entry' example that re-exposes the internal term." + test_refs: ["tests/shard-term-guard.test.ts"] +design_impact: + classification: none + rationale: "Terminology fix to the AI-facing prose (managed AGENTS.md/CLAUDE.md blocks + persona prompts) so users hear 'spec entry' instead of the internal 'shard'. Does not change cladding's own capabilities, architecture, or project-context." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index a9a1b7f6..6c0a8519 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -174,6 +174,7 @@ features: F-80d19d: {slug: setup-command, status: done, modules: 5} F-8234ec3c: {slug: graph-viewer-galaxy, status: archived, modules: 0} F-836a90: {slug: link-capability-tool, status: done, modules: 2} + F-876b6f48: {slug: shard-term-to-spec-entry, status: done, modules: 7} F-898783ee: {slug: self-count-guard, status: done, modules: 17} F-8f419e: {slug: smoke-legacy-liveness, status: done, modules: 1} F-904495a5: {slug: changelog-render, status: done, modules: 5} diff --git a/src/agents/developer.md b/src/agents/developer.md index 7393b7cf..853c7106 100644 --- a/src/agents/developer.md +++ b/src/agents/developer.md @@ -82,4 +82,4 @@ Advisory (no detector enforces it) — but after your edits the hook auto-surfac ## User-facing language (Soft Shell) -Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +Any string your code writes to stdout / a log a user reads must use feature titles, never `F-NNN` (or `F-` for v0.3.9+ features); stage names (`Drift`, `UAT`), never `stage_X.Y`. Use `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`). The audit log keeps the raw ids — those are for replay, not for users. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/src/agents/observability.md b/src/agents/observability.md index 5beb1a28..a792c05e 100644 --- a/src/agents/observability.md +++ b/src/agents/observability.md @@ -47,4 +47,4 @@ When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: ## User-facing language (Soft Shell) -The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The source artifacts above are Iron Core — they contain `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. When you produce a report for the user, translate the ids in your row labels and headlines via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`); keep the raw ids only when the user explicitly asked for the Iron Core view. Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/src/agents/orchestrator.md b/src/agents/orchestrator.md index bf8d0c1e..641d2e2d 100644 --- a/src/agents/orchestrator.md +++ b/src/agents/orchestrator.md @@ -35,14 +35,14 @@ You do NOT pre-load Tier C (conventions — developer's concern). Drive development as a per-feature **cycle**, detailed in [`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (shard + ACs) → `developer` (code) → test-author (separate context) → +`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → `reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author shards ahead of the code +gates dispose.** Do NOT author spec entries ahead of the code that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: @@ -86,4 +86,4 @@ When delegating, attach: ## User-facing language (Soft Shell) -Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — shard = spec entry, attestation = sign-off, finding = what drifted and why; never lead with ids. +Surface business titles ("Login flow") to users, never internal ids (`F-049`, `F-a3f9c2`, …). The audit log keeps the raw ids; the user surface stays free of `F-NNN` / `F-` / `AC-N` / `stage_X.Y` codes. Use the helpers in `src/ui/softShell.ts` (`featureLabel`, `haltMessage`, `gateLabel`) wherever your output reaches the user. Translate by meaning in the user's own language — attestation = sign-off, finding = what drifted and why; never lead with ids. diff --git a/src/agents/planner.md b/src/agents/planner.md index 7736e7b7..edf9ab5f 100644 --- a/src/agents/planner.md +++ b/src/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + sharded `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -27,7 +27,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. -- Shard `spec.yaml` into `spec/features/*.yaml` when the master crosses ~1k lines. +- Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. - Run `npm run spec:validate` and `npm run stage:drift` after every edit. @@ -70,4 +70,4 @@ Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If ## User-facing language (Soft Shell) -The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The spec uses `F-NNN` / `F-` and `AC-N` internally — that's Iron Core. When you summarise a change to the user, use the feature title (`spec.features[].title`), not the id. Use the helpers in `src/ui/softShell.ts` (`featureLabel`). Beyond ids, translate by meaning in the user's own language — an acceptance criterion = a testable promise, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/src/agents/reviewer.md b/src/agents/reviewer.md index 837d92e0..e7c6e110 100644 --- a/src/agents/reviewer.md +++ b/src/agents/reviewer.md @@ -78,4 +78,4 @@ You also own the **advisory half no gate enforces**: confirm the test-author wro ## User-facing language (Soft Shell) -The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. +The audit JSON above is Iron Core — `F-NNN` / `F-` / `stage_X.Y` codes belong in the log. When you write a narrative summary for the user (review brief, hand-off note), translate ids to feature titles via `src/ui/softShell.ts` (`featureLabel`, `gateLabel`). Beyond ids, translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids. diff --git a/src/init/agents-md.ts b/src/init/agents-md.ts index e10f3144..6c362d44 100644 --- a/src/init/agents-md.ts +++ b/src/init/agents-md.ts @@ -146,12 +146,12 @@ export function renderAgentsMdManagedBlock(spec: Spec | null, cwd: string = '.') '', '## Feature cycle — one at a time', '', - 'Finish ONE feature end-to-end before the next: author its shard (`acceptance_criteria`', + 'Finish ONE feature end-to-end before the next: author its spec entry (`acceptance_criteria`', '+ `modules`) → implement → author tests in a separate context → run the declared test', 'command and confirm it collected relevant tests → run the resolved Cladding command', 'with `done ` (sets `status: done` only when the strict pre-push gate is', 'GREEN). Package test scripts must not depend on shell-expanded glob patterns. Do not', - 'author shards ahead of their code, or hand-write `status: done`.', + 'author spec entries ahead of their code, or hand-write `status: done`.', '', '## Design evolves with each feature', '', diff --git a/src/init/host-instructions.ts b/src/init/host-instructions.ts index ddda2c65..e47d3a7a 100644 --- a/src/init/host-instructions.ts +++ b/src/init/host-instructions.ts @@ -25,9 +25,9 @@ export const CLAUDE_MD_SECTION = `## cladding implements; whoever authors a unit must not sign off on it (anti-self-cert). **Feature cycle — one at a time** — One feature end-to-end before the next: -author its shard (\`acceptance_criteria\` + \`modules\`) → implement → author tests +author its spec entry (\`acceptance_criteria\` + \`modules\`) → implement → author tests in a separate context → \`clad done \` (sets \`status: done\` only when -\`clad check --tier=pre-push --strict\` is GREEN). Never author shards ahead of +\`clad check --tier=pre-push --strict\` is GREEN). Never author spec entries ahead of their code, or hand-write \`status: done\`. See \`docs/feature-cycle.md\`. **Hash-based IDs** — Never hand-author \`F-NNN\` filenames; use the \`clad\` CLI @@ -37,8 +37,8 @@ their code, or hand-write \`status: done\`. See \`docs/feature-cycle.md\`. findings — fix them or update spec. **Speak the user's language** — when reporting to the user, translate -cladding terms into plain words in the user's own language (a shard = a spec -entry) — including cladding's own gate and hook messages: relay them by +cladding terms into plain words in the user's own language — including +cladding's own gate and hook messages: relay them by meaning. Never lead with internal ids. `; diff --git a/tests/agent-interpreter-rule.test.ts b/tests/agent-interpreter-rule.test.ts index 525a7b59..254ca3f5 100644 --- a/tests/agent-interpreter-rule.test.ts +++ b/tests/agent-interpreter-rule.test.ts @@ -44,17 +44,16 @@ const read = (rel: string): string => readFileSync(join(ROOT, rel), 'utf8'); const norm = (s: string): string => s.replace(/\s+/g, ' '); // Tolerant patterns — phrasing legitimately varies per template/persona. -// Orchestrator's is the most compressed variant ("shard = spec entry", +// Orchestrator's is the most compressed variant ("attestation = sign-off", // "never lead with ids" — no article, no "internal"); every persona and -// both templates must still satisfy all three semantic elements. +// both templates must still satisfy the semantic elements. const TRANSLATE_BY_MEANING = /translate by meaning/i; -const SHARD_SPEC_ENTRY_EQUIV = /shard\s*=\s*a?\s*spec entry/i; const USERS_OWN_LANGUAGE = /user's own language/i; const NEVER_LEAD_WITH_IDS = /never lead with(?: an)?(?: internal)? ids?/i; -// AC-6bf501f8's own text names three nouns explicitly (shard, attestation, -// detector findings) reported "by meaning" — these two catch the other pair -// alongside SHARD_SPEC_ENTRY_EQUIV, so the persona check does not silently -// narrow the AC's three-noun claim down to just the shard example. +// The translate-by-meaning clause names example equivalences reported "by +// meaning". "shard" was dropped from those examples (cladding no longer +// exposes "shard" to users — it says "spec entry" directly), so attestation + +// finding prove the clause is a real mapping list, not a bare phrase. const ATTESTATION_EQUIV = /attestation\s*=\s*(a\s+)?(signed\s+)?sign-off/i; const FINDING_EQUIV = /finding\s*=\s*what drifted/i; @@ -116,13 +115,12 @@ describe('AC-6bf501f8 · all five personas extend Soft Shell with the three sema }); for (const relPath of PERSONA_FILES) { - test(`${relPath}: Soft Shell section translates by meaning (shard = spec entry), in the user's own language, never leading with ids`, () => { + test(`${relPath}: Soft Shell section translates by meaning, in the user's own language, never leading with ids`, () => { const body = read(relPath); const sectionStart = body.indexOf('## User-facing language'); expect(sectionStart, `${relPath}: must have a "User-facing language" section`).toBeGreaterThanOrEqual(0); const section = body.slice(sectionStart); expect(section, `${relPath}: translate-by-meaning clause`).toMatch(TRANSLATE_BY_MEANING); - expect(section, `${relPath}: shard = spec entry equivalence`).toMatch(SHARD_SPEC_ENTRY_EQUIV); expect(section, `${relPath}: attestation = sign-off equivalence`).toMatch(ATTESTATION_EQUIV); expect(section, `${relPath}: detector finding = what drifted equivalence`).toMatch(FINDING_EQUIV); expect(section, `${relPath}: user's-own-language clause`).toMatch(USERS_OWN_LANGUAGE); @@ -140,23 +138,21 @@ describe('AC-6bf501f8 · all five personas extend Soft Shell with the three sema const stub = 'Use src/ui/softShell.ts (featureLabel, gateLabel) to keep F-NNN / stage_X.Y codes out of user-facing prose.'; expect(TRANSLATE_BY_MEANING.test(stub)).toBe(false); - expect(SHARD_SPEC_ENTRY_EQUIV.test(stub)).toBe(false); expect(ATTESTATION_EQUIV.test(stub)).toBe(false); expect(FINDING_EQUIV.test(stub)).toBe(false); expect(USERS_OWN_LANGUAGE.test(stub)).toBe(false); expect(NEVER_LEAD_WITH_IDS.test(stub)).toBe(false); const real = - "translate by meaning in the user's own language — a shard = a spec entry, an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids."; + "translate by meaning in the user's own language — an attestation = a signed sign-off, a detector finding = what drifted and why; never lead with internal ids."; expect(TRANSLATE_BY_MEANING.test(real)).toBe(true); - expect(SHARD_SPEC_ENTRY_EQUIV.test(real)).toBe(true); expect(ATTESTATION_EQUIV.test(real)).toBe(true); expect(FINDING_EQUIV.test(real)).toBe(true); expect(USERS_OWN_LANGUAGE.test(real)).toBe(true); expect(NEVER_LEAD_WITH_IDS.test(real)).toBe(true); - const orchestratorVariant = 'translate by meaning in the user\'s own language — shard = spec entry; never lead with ids.'; - expect(SHARD_SPEC_ENTRY_EQUIV.test(orchestratorVariant)).toBe(true); + const orchestratorVariant = 'translate by meaning in the user\'s own language — attestation = sign-off, finding = what drifted; never lead with ids.'; + expect(ATTESTATION_EQUIV.test(orchestratorVariant)).toBe(true); expect(NEVER_LEAD_WITH_IDS.test(orchestratorVariant)).toBe(true); }); }); diff --git a/tests/shard-term-guard.test.ts b/tests/shard-term-guard.test.ts new file mode 100644 index 00000000..561f2c09 --- /dev/null +++ b/tests/shard-term-guard.test.ts @@ -0,0 +1,43 @@ +// Cladding — "shard" stays out of the AI-facing surfaces (say "spec entry"). +// +// The AI mirrors whatever term it reads in the surfaces it consumes while +// serving a user: the persona prompts, and the managed AGENTS.md / CLAUDE.md +// blocks cladding writes into the project. 0.9.1 kept "shard" in those and bet +// the AI would translate it to "spec entry" at relay time; a live test showed +// the AI mirrors "shard" verbatim instead. This guard keeps exactly those +// surfaces shard-free so the leak can't creep back into them. +// +// "shard" is still fine in code, identifiers, --json machine messages, and +// maintainer docs — this only fences the AI-/user-facing prose. + +import {readFileSync, readdirSync} from 'node:fs'; +import {join} from 'node:path'; +import {fileURLToPath} from 'node:url'; + +import {describe, expect, test} from 'vitest'; + +const {renderAgentsMdManagedBlock} = await import('../src/init/agents-md.js'); +const {CLAUDE_MD_SECTION} = await import('../src/init/host-instructions.js'); + +const SHARD = /\bshards?\b/i; +const agentsDir = fileURLToPath(new URL('../src/agents/', import.meta.url)); + +describe('AI-facing surfaces stay shard-free — say "spec entry"', () => { + test('the generated AGENTS.md managed block has no "shard"', () => { + const block = renderAgentsMdManagedBlock(null); + expect(block, 'AGENTS.md managed block must say "spec entry", never "shard"').not.toMatch(SHARD); + }); + + test('the generated CLAUDE.md `## cladding` section has no "shard"', () => { + expect(CLAUDE_MD_SECTION, 'CLAUDE.md section must say "spec entry", never "shard"').not.toMatch(SHARD); + }); + + test('every persona prompt has no "shard"', () => { + const personas = readdirSync(agentsDir).filter((f) => f.endsWith('.md')); + expect(personas.length).toBeGreaterThan(0); + for (const file of personas) { + const body = readFileSync(join(agentsDir, file), 'utf8'); + expect(body, `src/agents/${file} must say "spec entry", never "shard"`).not.toMatch(SHARD); + } + }); +}); From 032f5fdfc056299913b4e9e4c8dbad27d346b62d Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Fri, 24 Jul 2026 18:07:10 +0900 Subject: [PATCH 02/13] feat(hitl): evidence-based independence label on done/verdict (F-c566f590) Role-contract architecture, feature 1: make silent self-certification visible. A feature is 'independent' iff >=1 of its evidence entries is human-authored or blind-authored (blind: true); 'self-certified' otherwise, including zero evidence. - src/hitl/independence.ts: pure computeIndependence + independenceSummary - clad done: label on DoneResult + done_attempted event (kept and reverted paths); opt-in project.independence_policy: 'require' refuses a self-certified completion (spec entry reverted, human-review ask); default 'label' only annotates - existing behavior unchanged - clad verdict: per-done-feature labels in --json, human-line tail when any done feature is self-certified; computeVerdict stays IO-free - 31 new tests (independence/done/verdict); full battery green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 --- README.html | 4 +- README.ja.md | 4 +- README.ko.html | 4 +- README.ko.md | 4 +- README.md | 4 +- README.zh.md | 4 +- plugins/claude-code/dist/clad.js | 706 +++++++++--------- plugins/claude-code/dist/schema.json | 5 + spec.yaml | 4 +- spec/attestation.yaml | 30 +- .../features/independence-label-c566f590.yaml | 41 + spec/index.yaml | 1 + src/cli/clad.ts | 28 +- src/cli/done.ts | 84 ++- src/cli/verdict.ts | 21 +- src/hitl/independence.ts | 94 +++ src/spec/schema.json | 5 + src/spec/types.ts | 11 + src/ui/softShell.ts | 10 + src/verdict/verdict.ts | 8 + tests/cli/done-independence.test.ts | 211 ++++++ tests/cli/verdict-independence.test.ts | 161 ++++ tests/hitl/independence.test.ts | 139 ++++ 23 files changed, 1190 insertions(+), 393 deletions(-) create mode 100644 spec/features/independence-label-c566f590.yaml create mode 100644 src/hitl/independence.ts create mode 100644 tests/cli/done-independence.test.ts create mode 100644 tests/cli/verdict-independence.test.ts create mode 100644 tests/hitl/independence.test.ts diff --git a/README.html b/README.html index 5962cc16..363aebe6 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -548,7 +548,7 @@

Status

tests
-
2605/2605
+
2636/2636
all pass
diff --git a/README.ja.md b/README.ja.md index 773273c6..4ecf97c4 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -339,7 +339,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 段階 · 41 detectors | 261（258 done） | 236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック diff --git a/README.ko.html b/README.ko.html index d47a2056..b7d080df 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -584,7 +584,7 @@

Status

tests
-
2605/2605
+
2636/2636
all pass
diff --git a/README.ko.md b/README.ko.md index 38e7b049..5ddd0614 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -338,7 +338,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | 236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 diff --git a/README.md b/README.md index f5348851..31e90c18 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -352,7 +352,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 stages · 41 detectors | 261 (258 done) | 236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector diff --git a/README.zh.md b/README.zh.md index bfc2ceb9..216bd32f 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -335,7 +335,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2605 / 2605 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 阶段 · 41 检测器 | 261（258 done） | 236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 diff --git a/plugins/claude-code/dist/clad.js b/plugins/claude-code/dist/clad.js index be06ec71..6fa8d623 100755 --- a/plugins/claude-code/dist/clad.js +++ b/plugins/claude-code/dist/clad.js @@ -4,100 +4,100 @@ const require = __claddingCreateRequire(import.meta.url); // Marker for stages/*.ts: when true, the per-stage CLI-entry guard // short-circuits so the bundle doesn't fire every stage at startup. globalThis.__CLADDING_BUNDLED = true; -var Fde=Object.create;var EA=Object.defineProperty;var Lde=Object.getOwnPropertyDescriptor;var zde=Object.getOwnPropertyNames;var Ude=Object.getPrototypeOf,qde=Object.prototype.hasOwnProperty;var Ge=(t=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(e,r)=>(typeof require<"u"?require:e)[r]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});var y=(t,e)=>()=>(t&&(e=t(t=0)),e);var v=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),Pr=(t,e)=>{for(var r in e)EA(t,r,{get:e[r],enumerable:!0})},Bde=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of zde(e))!qde.call(t,i)&&i!==r&&EA(t,i,{get:()=>e[i],enumerable:!(n=Lde(e,i))||n.enumerable});return t};var St=(t,e,r)=>(r=t!=null?Fde(Ude(t)):{},Bde(e||!t||!t.__esModule?EA(r,"default",{value:t,enumerable:!0}):r,t));var nf=v(TA=>{var by=class extends Error{constructor(e,r,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=r,this.exitCode=e,this.nestedError=void 0}},AA=class extends by{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};TA.CommanderError=by;TA.InvalidArgumentError=AA});var vy=v(RA=>{var{InvalidArgumentError:Hde}=nf(),OA=class{constructor(e,r){switch(this.description=r||"",this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case"<":this.required=!0,this._name=e.slice(1,-1);break;case"[":this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e;break}this._name.endsWith("...")&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_collectValue(e,r){return r===this.defaultValue||!Array.isArray(r)?[e]:(r.push(e),r)}default(e,r){return this.defaultValue=e,this.defaultValueDescription=r,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(r,n)=>{if(!this.argChoices.includes(r))throw new Hde(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._collectValue(r,n):r},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function Gde(t){let e=t.name()+(t.variadic===!0?"...":"");return t.required?"<"+e+">":"["+e+"]"}RA.Argument=OA;RA.humanReadableArgName=Gde});var CA=v(PA=>{var{humanReadableArgName:Zde}=vy(),IA=class{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext(e){this.helpWidth=this.helpWidth??e.helpWidth??80}visibleCommands(e){let r=e.commands.filter(i=>!i._hidden),n=e._getHelpCommand();return n&&!n._hidden&&r.push(n),this.sortSubcommands&&r.sort((i,o)=>i.name().localeCompare(o.name())),r}compareOptions(e,r){let n=i=>i.short?i.short.replace(/^-/,""):i.long.replace(/^--/,"");return n(e).localeCompare(n(r))}visibleOptions(e){let r=e.options.filter(i=>!i.hidden),n=e._getHelpOption();if(n&&!n.hidden){let i=n.short&&e._findOption(n.short),o=n.long&&e._findOption(n.long);!i&&!o?r.push(n):n.long&&!o?r.push(e.createOption(n.long,n.description)):n.short&&!i&&r.push(e.createOption(n.short,n.description))}return this.sortOptions&&r.sort(this.compareOptions),r}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let r=[];for(let n=e.parent;n;n=n.parent){let i=n.options.filter(o=>!o.hidden);r.push(...i)}return this.sortOptions&&r.sort(this.compareOptions),r}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(r=>{r.description=r.description||e._argsDescription[r.name()]||""}),e.registeredArguments.find(r=>r.description)?e.registeredArguments:[]}subcommandTerm(e){let r=e.registeredArguments.map(n=>Zde(n)).join(" ");return e._name+(e._aliases[0]?"|"+e._aliases[0]:"")+(e.options.length?" [options]":"")+(r?" "+r:"")}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,r){return r.visibleCommands(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleSubcommandTerm(r.subcommandTerm(i)))),0)}longestOptionTermLength(e,r){return r.visibleOptions(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleOptionTerm(r.optionTerm(i)))),0)}longestGlobalOptionTermLength(e,r){return r.visibleGlobalOptions(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleOptionTerm(r.optionTerm(i)))),0)}longestArgumentTermLength(e,r){return r.visibleArguments(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleArgumentTerm(r.argumentTerm(i)))),0)}commandUsage(e){let r=e._name;e._aliases[0]&&(r=r+"|"+e._aliases[0]);let n="";for(let i=e.parent;i;i=i.parent)n=i.name()+" "+n;return n+r+" "+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let r=[];if(e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue=="boolean")&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&r.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&r.push(`env: ${e.envVar}`),r.length>0){let n=`(${r.join(", ")})`;return e.description?`${e.description} ${n}`:n}return e.description}argumentDescription(e){let r=[];if(e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),r.length>0){let n=`(${r.join(", ")})`;return e.description?`${e.description} ${n}`:n}return e.description}formatItemList(e,r,n){return r.length===0?[]:[n.styleTitle(e),...r,""]}groupItems(e,r,n){let i=new Map;return e.forEach(o=>{let s=n(o);i.has(s)||i.set(s,[])}),r.forEach(o=>{let s=n(o);i.has(s)||i.set(s,[]),i.get(s).push(o)}),i}formatHelp(e,r){let n=r.padWidth(e,r),i=r.helpWidth??80;function o(d,f){return r.formatItem(d,n,f,r)}let s=[`${r.styleTitle("Usage:")} ${r.styleUsage(r.commandUsage(e))}`,""],a=r.commandDescription(e);a.length>0&&(s=s.concat([r.boxWrap(r.styleCommandDescription(a),i),""]));let c=r.visibleArguments(e).map(d=>o(r.styleArgumentTerm(r.argumentTerm(d)),r.styleArgumentDescription(r.argumentDescription(d))));if(s=s.concat(this.formatItemList("Arguments:",c,r)),this.groupItems(e.options,r.visibleOptions(e),d=>d.helpGroupHeading??"Options:").forEach((d,f)=>{let p=d.map(m=>o(r.styleOptionTerm(r.optionTerm(m)),r.styleOptionDescription(r.optionDescription(m))));s=s.concat(this.formatItemList(f,p,r))}),r.showGlobalOptions){let d=r.visibleGlobalOptions(e).map(f=>o(r.styleOptionTerm(r.optionTerm(f)),r.styleOptionDescription(r.optionDescription(f))));s=s.concat(this.formatItemList("Global Options:",d,r))}return this.groupItems(e.commands,r.visibleCommands(e),d=>d.helpGroup()||"Commands:").forEach((d,f)=>{let p=d.map(m=>o(r.styleSubcommandTerm(r.subcommandTerm(m)),r.styleSubcommandDescription(r.subcommandDescription(m))));s=s.concat(this.formatItemList(f,p,r))}),s.join(` -`)}displayWidth(e){return u4(e).length}styleTitle(e){return e}styleUsage(e){return e.split(" ").map(r=>r==="[options]"?this.styleOptionText(r):r==="[command]"?this.styleSubcommandText(r):r[0]==="["||r[0]==="<"?this.styleArgumentText(r):this.styleCommandText(r)).join(" ")}styleCommandDescription(e){return this.styleDescriptionText(e)}styleOptionDescription(e){return this.styleDescriptionText(e)}styleSubcommandDescription(e){return this.styleDescriptionText(e)}styleArgumentDescription(e){return this.styleDescriptionText(e)}styleDescriptionText(e){return e}styleOptionTerm(e){return this.styleOptionText(e)}styleSubcommandTerm(e){return e.split(" ").map(r=>r==="[options]"?this.styleOptionText(r):r[0]==="["||r[0]==="<"?this.styleArgumentText(r):this.styleSubcommandText(r)).join(" ")}styleArgumentTerm(e){return this.styleArgumentText(e)}styleOptionText(e){return e}styleArgumentText(e){return e}styleSubcommandText(e){return e}styleCommandText(e){return e}padWidth(e,r){return Math.max(r.longestOptionTermLength(e,r),r.longestGlobalOptionTermLength(e,r),r.longestSubcommandTermLength(e,r),r.longestArgumentTermLength(e,r))}preformatted(e){return/\n[^\S\r\n]/.test(e)}formatItem(e,r,n,i){let s=" ".repeat(2);if(!n)return s+e;let a=e.padEnd(r+e.length-i.displayWidth(e)),c=2,u=(this.helpWidth??80)-r-c-2,d;return utypeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(e,r)=>(typeof require<"u"?require:e)[r]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});var y=(t,e)=>()=>(t&&(e=t(t=0)),e);var v=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),Cr=(t,e)=>{for(var r in e)EA(t,r,{get:e[r],enumerable:!0})},Zde=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Bde(e))!Gde.call(t,i)&&i!==r&&EA(t,i,{get:()=>e[i],enumerable:!(n=qde(e,i))||n.enumerable});return t};var St=(t,e,r)=>(r=t!=null?Ude(Hde(t)):{},Zde(e||!t||!t.__esModule?EA(r,"default",{value:t,enumerable:!0}):r,t));var of=v(TA=>{var by=class extends Error{constructor(e,r,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=r,this.exitCode=e,this.nestedError=void 0}},AA=class extends by{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};TA.CommanderError=by;TA.InvalidArgumentError=AA});var vy=v(RA=>{var{InvalidArgumentError:Vde}=of(),OA=class{constructor(e,r){switch(this.description=r||"",this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case"<":this.required=!0,this._name=e.slice(1,-1);break;case"[":this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e;break}this._name.endsWith("...")&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_collectValue(e,r){return r===this.defaultValue||!Array.isArray(r)?[e]:(r.push(e),r)}default(e,r){return this.defaultValue=e,this.defaultValueDescription=r,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(r,n)=>{if(!this.argChoices.includes(r))throw new Vde(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._collectValue(r,n):r},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function Wde(t){let e=t.name()+(t.variadic===!0?"...":"");return t.required?"<"+e+">":"["+e+"]"}RA.Argument=OA;RA.humanReadableArgName=Wde});var CA=v(PA=>{var{humanReadableArgName:Kde}=vy(),IA=class{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext(e){this.helpWidth=this.helpWidth??e.helpWidth??80}visibleCommands(e){let r=e.commands.filter(i=>!i._hidden),n=e._getHelpCommand();return n&&!n._hidden&&r.push(n),this.sortSubcommands&&r.sort((i,o)=>i.name().localeCompare(o.name())),r}compareOptions(e,r){let n=i=>i.short?i.short.replace(/^-/,""):i.long.replace(/^--/,"");return n(e).localeCompare(n(r))}visibleOptions(e){let r=e.options.filter(i=>!i.hidden),n=e._getHelpOption();if(n&&!n.hidden){let i=n.short&&e._findOption(n.short),o=n.long&&e._findOption(n.long);!i&&!o?r.push(n):n.long&&!o?r.push(e.createOption(n.long,n.description)):n.short&&!i&&r.push(e.createOption(n.short,n.description))}return this.sortOptions&&r.sort(this.compareOptions),r}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let r=[];for(let n=e.parent;n;n=n.parent){let i=n.options.filter(o=>!o.hidden);r.push(...i)}return this.sortOptions&&r.sort(this.compareOptions),r}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(r=>{r.description=r.description||e._argsDescription[r.name()]||""}),e.registeredArguments.find(r=>r.description)?e.registeredArguments:[]}subcommandTerm(e){let r=e.registeredArguments.map(n=>Kde(n)).join(" ");return e._name+(e._aliases[0]?"|"+e._aliases[0]:"")+(e.options.length?" [options]":"")+(r?" "+r:"")}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,r){return r.visibleCommands(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleSubcommandTerm(r.subcommandTerm(i)))),0)}longestOptionTermLength(e,r){return r.visibleOptions(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleOptionTerm(r.optionTerm(i)))),0)}longestGlobalOptionTermLength(e,r){return r.visibleGlobalOptions(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleOptionTerm(r.optionTerm(i)))),0)}longestArgumentTermLength(e,r){return r.visibleArguments(e).reduce((n,i)=>Math.max(n,this.displayWidth(r.styleArgumentTerm(r.argumentTerm(i)))),0)}commandUsage(e){let r=e._name;e._aliases[0]&&(r=r+"|"+e._aliases[0]);let n="";for(let i=e.parent;i;i=i.parent)n=i.name()+" "+n;return n+r+" "+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let r=[];if(e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue=="boolean")&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&r.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&r.push(`env: ${e.envVar}`),r.length>0){let n=`(${r.join(", ")})`;return e.description?`${e.description} ${n}`:n}return e.description}argumentDescription(e){let r=[];if(e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),r.length>0){let n=`(${r.join(", ")})`;return e.description?`${e.description} ${n}`:n}return e.description}formatItemList(e,r,n){return r.length===0?[]:[n.styleTitle(e),...r,""]}groupItems(e,r,n){let i=new Map;return e.forEach(o=>{let s=n(o);i.has(s)||i.set(s,[])}),r.forEach(o=>{let s=n(o);i.has(s)||i.set(s,[]),i.get(s).push(o)}),i}formatHelp(e,r){let n=r.padWidth(e,r),i=r.helpWidth??80;function o(d,f){return r.formatItem(d,n,f,r)}let s=[`${r.styleTitle("Usage:")} ${r.styleUsage(r.commandUsage(e))}`,""],a=r.commandDescription(e);a.length>0&&(s=s.concat([r.boxWrap(r.styleCommandDescription(a),i),""]));let c=r.visibleArguments(e).map(d=>o(r.styleArgumentTerm(r.argumentTerm(d)),r.styleArgumentDescription(r.argumentDescription(d))));if(s=s.concat(this.formatItemList("Arguments:",c,r)),this.groupItems(e.options,r.visibleOptions(e),d=>d.helpGroupHeading??"Options:").forEach((d,f)=>{let p=d.map(m=>o(r.styleOptionTerm(r.optionTerm(m)),r.styleOptionDescription(r.optionDescription(m))));s=s.concat(this.formatItemList(f,p,r))}),r.showGlobalOptions){let d=r.visibleGlobalOptions(e).map(f=>o(r.styleOptionTerm(r.optionTerm(f)),r.styleOptionDescription(r.optionDescription(f))));s=s.concat(this.formatItemList("Global Options:",d,r))}return this.groupItems(e.commands,r.visibleCommands(e),d=>d.helpGroup()||"Commands:").forEach((d,f)=>{let p=d.map(m=>o(r.styleSubcommandTerm(r.subcommandTerm(m)),r.styleSubcommandDescription(r.subcommandDescription(m))));s=s.concat(this.formatItemList(f,p,r))}),s.join(` +`)}displayWidth(e){return d4(e).length}styleTitle(e){return e}styleUsage(e){return e.split(" ").map(r=>r==="[options]"?this.styleOptionText(r):r==="[command]"?this.styleSubcommandText(r):r[0]==="["||r[0]==="<"?this.styleArgumentText(r):this.styleCommandText(r)).join(" ")}styleCommandDescription(e){return this.styleDescriptionText(e)}styleOptionDescription(e){return this.styleDescriptionText(e)}styleSubcommandDescription(e){return this.styleDescriptionText(e)}styleArgumentDescription(e){return this.styleDescriptionText(e)}styleDescriptionText(e){return e}styleOptionTerm(e){return this.styleOptionText(e)}styleSubcommandTerm(e){return e.split(" ").map(r=>r==="[options]"?this.styleOptionText(r):r[0]==="["||r[0]==="<"?this.styleArgumentText(r):this.styleSubcommandText(r)).join(" ")}styleArgumentTerm(e){return this.styleArgumentText(e)}styleOptionText(e){return e}styleArgumentText(e){return e}styleSubcommandText(e){return e}styleCommandText(e){return e}padWidth(e,r){return Math.max(r.longestOptionTermLength(e,r),r.longestGlobalOptionTermLength(e,r),r.longestSubcommandTermLength(e,r),r.longestArgumentTermLength(e,r))}preformatted(e){return/\n[^\S\r\n]/.test(e)}formatItem(e,r,n,i){let s=" ".repeat(2);if(!n)return s+e;let a=e.padEnd(r+e.length-i.displayWidth(e)),c=2,u=(this.helpWidth??80)-r-c-2,d;return u{let a=s.match(i);if(a===null){o.push("");return}let c=[a.shift()],l=this.displayWidth(c[0]);a.forEach(u=>{let d=this.displayWidth(u);if(l+d<=r){c.push(u),l+=d;return}o.push(c.join(""));let f=u.trimStart();c=[f],l=this.displayWidth(f)}),o.push(c.join(""))}),o.join(` -`)}};function u4(t){let e=/\x1b\[\d*(;\d*)*m/g;return t.replace(e,"")}PA.Help=IA;PA.stripColor=u4});var MA=v(jA=>{var{InvalidArgumentError:Vde}=nf(),DA=class{constructor(e,r){this.flags=e,this.description=r||"",this.required=e.includes("<"),this.optional=e.includes("["),this.variadic=/\w\.\.\.[>\]]$/.test(e),this.mandatory=!1;let n=Wde(e);this.short=n.shortFlag,this.long=n.longFlag,this.negate=!1,this.long&&(this.negate=this.long.startsWith("--no-")),this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0,this.helpGroupHeading=void 0}default(e,r){return this.defaultValue=e,this.defaultValueDescription=r,this}preset(e){return this.presetArg=e,this}conflicts(e){return this.conflictsWith=this.conflictsWith.concat(e),this}implies(e){let r=e;return typeof e=="string"&&(r={[e]:!0}),this.implied=Object.assign(this.implied||{},r),this}env(e){return this.envVar=e,this}argParser(e){return this.parseArg=e,this}makeOptionMandatory(e=!0){return this.mandatory=!!e,this}hideHelp(e=!0){return this.hidden=!!e,this}_collectValue(e,r){return r===this.defaultValue||!Array.isArray(r)?[e]:(r.push(e),r)}choices(e){return this.argChoices=e.slice(),this.parseArg=(r,n)=>{if(!this.argChoices.includes(r))throw new Vde(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._collectValue(r,n):r},this}name(){return this.long?this.long.replace(/^--/,""):this.short.replace(/^-/,"")}attributeName(){return this.negate?d4(this.name().replace(/^no-/,"")):d4(this.name())}helpGroup(e){return this.helpGroupHeading=e,this}is(e){return this.short===e||this.long===e}isBoolean(){return!this.required&&!this.optional&&!this.negate}},NA=class{constructor(e){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,e.forEach(r=>{r.negate?this.negativeOptions.set(r.attributeName(),r):this.positiveOptions.set(r.attributeName(),r)}),this.negativeOptions.forEach((r,n)=>{this.positiveOptions.has(n)&&this.dualOptions.add(n)})}valueFromOption(e,r){let n=r.attributeName();if(!this.dualOptions.has(n))return!0;let i=this.negativeOptions.get(n).presetArg,o=i!==void 0?i:!1;return r.negate===(o===e)}};function d4(t){return t.split("-").reduce((e,r)=>e+r[0].toUpperCase()+r.slice(1))}function Wde(t){let e,r,n=/^-[^-]$/,i=/^--[^-]/,o=t.split(/[ |,]+/).concat("guard");if(n.test(o[0])&&(e=o.shift()),i.test(o[0])&&(r=o.shift()),!e&&n.test(o[0])&&(e=o.shift()),!e&&i.test(o[0])&&(e=r,r=o.shift()),o[0].startsWith("-")){let s=o[0],a=`option creation failed due to '${s}' in option flags '${t}'`;throw/^-[^-][^-]/.test(s)?new Error(`${a} +`)}};function d4(t){let e=/\x1b\[\d*(;\d*)*m/g;return t.replace(e,"")}PA.Help=IA;PA.stripColor=d4});var MA=v(jA=>{var{InvalidArgumentError:Jde}=of(),DA=class{constructor(e,r){this.flags=e,this.description=r||"",this.required=e.includes("<"),this.optional=e.includes("["),this.variadic=/\w\.\.\.[>\]]$/.test(e),this.mandatory=!1;let n=Yde(e);this.short=n.shortFlag,this.long=n.longFlag,this.negate=!1,this.long&&(this.negate=this.long.startsWith("--no-")),this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0,this.helpGroupHeading=void 0}default(e,r){return this.defaultValue=e,this.defaultValueDescription=r,this}preset(e){return this.presetArg=e,this}conflicts(e){return this.conflictsWith=this.conflictsWith.concat(e),this}implies(e){let r=e;return typeof e=="string"&&(r={[e]:!0}),this.implied=Object.assign(this.implied||{},r),this}env(e){return this.envVar=e,this}argParser(e){return this.parseArg=e,this}makeOptionMandatory(e=!0){return this.mandatory=!!e,this}hideHelp(e=!0){return this.hidden=!!e,this}_collectValue(e,r){return r===this.defaultValue||!Array.isArray(r)?[e]:(r.push(e),r)}choices(e){return this.argChoices=e.slice(),this.parseArg=(r,n)=>{if(!this.argChoices.includes(r))throw new Jde(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._collectValue(r,n):r},this}name(){return this.long?this.long.replace(/^--/,""):this.short.replace(/^-/,"")}attributeName(){return this.negate?f4(this.name().replace(/^no-/,"")):f4(this.name())}helpGroup(e){return this.helpGroupHeading=e,this}is(e){return this.short===e||this.long===e}isBoolean(){return!this.required&&!this.optional&&!this.negate}},NA=class{constructor(e){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,e.forEach(r=>{r.negate?this.negativeOptions.set(r.attributeName(),r):this.positiveOptions.set(r.attributeName(),r)}),this.negativeOptions.forEach((r,n)=>{this.positiveOptions.has(n)&&this.dualOptions.add(n)})}valueFromOption(e,r){let n=r.attributeName();if(!this.dualOptions.has(n))return!0;let i=this.negativeOptions.get(n).presetArg,o=i!==void 0?i:!1;return r.negate===(o===e)}};function f4(t){return t.split("-").reduce((e,r)=>e+r[0].toUpperCase()+r.slice(1))}function Yde(t){let e,r,n=/^-[^-]$/,i=/^--[^-]/,o=t.split(/[ |,]+/).concat("guard");if(n.test(o[0])&&(e=o.shift()),i.test(o[0])&&(r=o.shift()),!e&&n.test(o[0])&&(e=o.shift()),!e&&i.test(o[0])&&(e=r,r=o.shift()),o[0].startsWith("-")){let s=o[0],a=`option creation failed due to '${s}' in option flags '${t}'`;throw/^-[^-][^-]/.test(s)?new Error(`${a} - a short flag is a single dash and a single character - either use a single dash and a single character (for a short flag) - or use a double dash for a long option (and can have two, like '--ws, --workspace')`):n.test(s)?new Error(`${a} - too many short flags`):i.test(s)?new Error(`${a} - too many long flags`):new Error(`${a} -- unrecognised flag format`)}if(e===void 0&&r===void 0)throw new Error(`option creation failed due to no flags found in '${t}'.`);return{shortFlag:e,longFlag:r}}jA.Option=DA;jA.DualOptions=NA});var p4=v(f4=>{function Kde(t,e){if(Math.abs(t.length-e.length)>3)return Math.max(t.length,e.length);let r=[];for(let n=0;n<=t.length;n++)r[n]=[n];for(let n=0;n<=e.length;n++)r[0][n]=n;for(let n=1;n<=e.length;n++)for(let i=1;i<=t.length;i++){let o=1;t[i-1]===e[n-1]?o=0:o=1,r[i][n]=Math.min(r[i-1][n]+1,r[i][n-1]+1,r[i-1][n-1]+o),i>1&&n>1&&t[i-1]===e[n-2]&&t[i-2]===e[n-1]&&(r[i][n]=Math.min(r[i][n],r[i-2][n-2]+1))}return r[t.length][e.length]}function Jde(t,e){if(!e||e.length===0)return"";e=Array.from(new Set(e));let r=t.startsWith("--");r&&(t=t.slice(2),e=e.map(s=>s.slice(2)));let n=[],i=3,o=.4;return e.forEach(s=>{if(s.length<=1)return;let a=Kde(t,s),c=Math.max(t.length,s.length);(c-a)/c>o&&(as.localeCompare(a)),r&&(n=n.map(s=>`--${s}`)),n.length>1?` +- unrecognised flag format`)}if(e===void 0&&r===void 0)throw new Error(`option creation failed due to no flags found in '${t}'.`);return{shortFlag:e,longFlag:r}}jA.Option=DA;jA.DualOptions=NA});var m4=v(p4=>{function Xde(t,e){if(Math.abs(t.length-e.length)>3)return Math.max(t.length,e.length);let r=[];for(let n=0;n<=t.length;n++)r[n]=[n];for(let n=0;n<=e.length;n++)r[0][n]=n;for(let n=1;n<=e.length;n++)for(let i=1;i<=t.length;i++){let o=1;t[i-1]===e[n-1]?o=0:o=1,r[i][n]=Math.min(r[i-1][n]+1,r[i][n-1]+1,r[i-1][n-1]+o),i>1&&n>1&&t[i-1]===e[n-2]&&t[i-2]===e[n-1]&&(r[i][n]=Math.min(r[i][n],r[i-2][n-2]+1))}return r[t.length][e.length]}function Qde(t,e){if(!e||e.length===0)return"";e=Array.from(new Set(e));let r=t.startsWith("--");r&&(t=t.slice(2),e=e.map(s=>s.slice(2)));let n=[],i=3,o=.4;return e.forEach(s=>{if(s.length<=1)return;let a=Xde(t,s),c=Math.max(t.length,s.length);(c-a)/c>o&&(as.localeCompare(a)),r&&(n=n.map(s=>`--${s}`)),n.length>1?` (Did you mean one of ${n.join(", ")}?)`:n.length===1?` -(Did you mean ${n[0]}?)`:""}f4.suggestSimilar=Jde});var y4=v(qA=>{var Yde=Ge("node:events").EventEmitter,FA=Ge("node:child_process"),fo=Ge("node:path"),Sy=Ge("node:fs"),Be=Ge("node:process"),{Argument:Xde,humanReadableArgName:Qde}=vy(),{CommanderError:LA}=nf(),{Help:efe,stripColor:tfe}=CA(),{Option:m4,DualOptions:rfe}=MA(),{suggestSimilar:h4}=p4(),zA=class t extends Yde{constructor(e){super(),this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!1,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=e||"",this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description="",this._summary="",this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._savedState=null,this._outputConfiguration={writeOut:r=>Be.stdout.write(r),writeErr:r=>Be.stderr.write(r),outputError:(r,n)=>n(r),getOutHelpWidth:()=>Be.stdout.isTTY?Be.stdout.columns:void 0,getErrHelpWidth:()=>Be.stderr.isTTY?Be.stderr.columns:void 0,getOutHasColors:()=>UA()??(Be.stdout.isTTY&&Be.stdout.hasColors?.()),getErrHasColors:()=>UA()??(Be.stderr.isTTY&&Be.stderr.hasColors?.()),stripColor:r=>tfe(r)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={},this._helpGroupHeading=void 0,this._defaultCommandGroup=void 0,this._defaultOptionGroup=void 0}copyInheritedSettings(e){return this._outputConfiguration=e._outputConfiguration,this._helpOption=e._helpOption,this._helpCommand=e._helpCommand,this._helpConfiguration=e._helpConfiguration,this._exitCallback=e._exitCallback,this._storeOptionsAsProperties=e._storeOptionsAsProperties,this._combineFlagAndOptionalValue=e._combineFlagAndOptionalValue,this._allowExcessArguments=e._allowExcessArguments,this._enablePositionalOptions=e._enablePositionalOptions,this._showHelpAfterError=e._showHelpAfterError,this._showSuggestionAfterError=e._showSuggestionAfterError,this}_getCommandAndAncestors(){let e=[];for(let r=this;r;r=r.parent)e.push(r);return e}command(e,r,n){let i=r,o=n;typeof i=="object"&&i!==null&&(o=i,i=null),o=o||{};let[,s,a]=e.match(/([^ ]+) *(.*)/),c=this.createCommand(s);return i&&(c.description(i),c._executableHandler=!0),o.isDefault&&(this._defaultCommandName=c._name),c._hidden=!!(o.noHelp||o.hidden),c._executableFile=o.executableFile||null,a&&c.arguments(a),this._registerCommand(c),c.parent=this,c.copyInheritedSettings(this),i?this:c}createCommand(e){return new t(e)}createHelp(){return Object.assign(new efe,this.configureHelp())}configureHelp(e){return e===void 0?this._helpConfiguration:(this._helpConfiguration=e,this)}configureOutput(e){return e===void 0?this._outputConfiguration:(this._outputConfiguration={...this._outputConfiguration,...e},this)}showHelpAfterError(e=!0){return typeof e!="string"&&(e=!!e),this._showHelpAfterError=e,this}showSuggestionAfterError(e=!0){return this._showSuggestionAfterError=!!e,this}addCommand(e,r){if(!e._name)throw new Error(`Command passed to .addCommand() must have a name -- specify the name in Command constructor or using .name()`);return r=r||{},r.isDefault&&(this._defaultCommandName=e._name),(r.noHelp||r.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,r){return new Xde(e,r)}argument(e,r,n,i){let o=this.createArgument(e,r);return typeof n=="function"?o.default(i).argParser(n):o.default(n),this.addArgument(o),this}arguments(e){return e.trim().split(/ +/).forEach(r=>{this.argument(r)}),this}addArgument(e){let r=this.registeredArguments.slice(-1)[0];if(r?.variadic)throw new Error(`only the last argument can be variadic '${r.name()}'`);if(e.required&&e.defaultValue!==void 0&&e.parseArg===void 0)throw new Error(`a default value for a required argument is never used: '${e.name()}'`);return this.registeredArguments.push(e),this}helpCommand(e,r){if(typeof e=="boolean")return this._addImplicitHelpCommand=e,e&&this._defaultCommandGroup&&this._initCommandGroup(this._getHelpCommand()),this;let n=e??"help [command]",[,i,o]=n.match(/([^ ]+) *(.*)/),s=r??"display help for command",a=this.createCommand(i);return a.helpOption(!1),o&&a.arguments(o),s&&a.description(s),this._addImplicitHelpCommand=!0,this._helpCommand=a,(e||r)&&this._initCommandGroup(a),this}addHelpCommand(e,r){return typeof e!="object"?(this.helpCommand(e,r),this):(this._addImplicitHelpCommand=!0,this._helpCommand=e,this._initCommandGroup(e),this)}_getHelpCommand(){return this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand("help"))?(this._helpCommand===void 0&&this.helpCommand(void 0,void 0),this._helpCommand):null}hook(e,r){let n=["preSubcommand","preAction","postAction"];if(!n.includes(e))throw new Error(`Unexpected value for event passed to hook : '${e}'. -Expecting one of '${n.join("', '")}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(r):this._lifeCycleHooks[e]=[r],this}exitOverride(e){return e?this._exitCallback=e:this._exitCallback=r=>{if(r.code!=="commander.executeSubCommandAsync")throw r},this}_exit(e,r,n){this._exitCallback&&this._exitCallback(new LA(e,r,n)),Be.exit(e)}action(e){let r=n=>{let i=this.registeredArguments.length,o=n.slice(0,i);return this._storeOptionsAsProperties?o[i]=this:o[i]=this.opts(),o.push(this),e.apply(this,o)};return this._actionHandler=r,this}createOption(e,r){return new m4(e,r)}_callParseArg(e,r,n,i){try{return e.parseArg(r,n)}catch(o){if(o.code==="commander.invalidArgument"){let s=`${i} ${o.message}`;this.error(s,{exitCode:o.exitCode,code:o.code})}throw o}}_registerOption(e){let r=e.short&&this._findOption(e.short)||e.long&&this._findOption(e.long);if(r){let n=e.long&&this._findOption(e.long)?e.long:e.short;throw new Error(`Cannot add option '${e.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${n}' -- already used by option '${r.flags}'`)}this._initOptionGroup(e),this.options.push(e)}_registerCommand(e){let r=i=>[i.name()].concat(i.aliases()),n=r(e).find(i=>this._findCommand(i));if(n){let i=r(this._findCommand(n)).join("|"),o=r(e).join("|");throw new Error(`cannot add command '${o}' as already have command '${i}'`)}this._initCommandGroup(e),this.commands.push(e)}addOption(e){this._registerOption(e);let r=e.name(),n=e.attributeName();if(e.negate){let o=e.long.replace(/^--no-/,"--");this._findOption(o)||this.setOptionValueWithSource(n,e.defaultValue===void 0?!0:e.defaultValue,"default")}else e.defaultValue!==void 0&&this.setOptionValueWithSource(n,e.defaultValue,"default");let i=(o,s,a)=>{o==null&&e.presetArg!==void 0&&(o=e.presetArg);let c=this.getOptionValue(n);o!==null&&e.parseArg?o=this._callParseArg(e,o,c,s):o!==null&&e.variadic&&(o=e._collectValue(o,c)),o==null&&(e.negate?o=!1:e.isBoolean()||e.optional?o=!0:o=""),this.setOptionValueWithSource(n,o,a)};return this.on("option:"+r,o=>{let s=`error: option '${e.flags}' argument '${o}' is invalid.`;i(o,s,"cli")}),e.envVar&&this.on("optionEnv:"+r,o=>{let s=`error: option '${e.flags}' value '${o}' from env '${e.envVar}' is invalid.`;i(o,s,"env")}),this}_optionEx(e,r,n,i,o){if(typeof r=="object"&&r instanceof m4)throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");let s=this.createOption(r,n);if(s.makeOptionMandatory(!!e.mandatory),typeof i=="function")s.default(o).argParser(i);else if(i instanceof RegExp){let a=i;i=(c,l)=>{let u=a.exec(c);return u?u[0]:l},s.default(o).argParser(i)}else s.default(i);return this.addOption(s)}option(e,r,n,i){return this._optionEx({},e,r,n,i)}requiredOption(e,r,n,i){return this._optionEx({mandatory:!0},e,r,n,i)}combineFlagAndOptionalValue(e=!0){return this._combineFlagAndOptionalValue=!!e,this}allowUnknownOption(e=!0){return this._allowUnknownOption=!!e,this}allowExcessArguments(e=!0){return this._allowExcessArguments=!!e,this}enablePositionalOptions(e=!0){return this._enablePositionalOptions=!!e,this}passThroughOptions(e=!0){return this._passThroughOptions=!!e,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties(e=!0){if(this.options.length)throw new Error("call .storeOptionsAsProperties() before adding options");if(Object.keys(this._optionValues).length)throw new Error("call .storeOptionsAsProperties() before setting option values");return this._storeOptionsAsProperties=!!e,this}getOptionValue(e){return this._storeOptionsAsProperties?this[e]:this._optionValues[e]}setOptionValue(e,r){return this.setOptionValueWithSource(e,r,void 0)}setOptionValueWithSource(e,r,n){return this._storeOptionsAsProperties?this[e]=r:this._optionValues[e]=r,this._optionValueSources[e]=n,this}getOptionValueSource(e){return this._optionValueSources[e]}getOptionValueSourceWithGlobals(e){let r;return this._getCommandAndAncestors().forEach(n=>{n.getOptionValueSource(e)!==void 0&&(r=n.getOptionValueSource(e))}),r}_prepareUserArgs(e,r){if(e!==void 0&&!Array.isArray(e))throw new Error("first parameter to parse must be array or undefined");if(r=r||{},e===void 0&&r.from===void 0){Be.versions?.electron&&(r.from="electron");let i=Be.execArgv??[];(i.includes("-e")||i.includes("--eval")||i.includes("-p")||i.includes("--print"))&&(r.from="eval")}e===void 0&&(e=Be.argv),this.rawArgs=e.slice();let n;switch(r.from){case void 0:case"node":this._scriptPath=e[1],n=e.slice(2);break;case"electron":Be.defaultApp?(this._scriptPath=e[1],n=e.slice(2)):n=e.slice(1);break;case"user":n=e.slice(0);break;case"eval":n=e.slice(1);break;default:throw new Error(`unexpected parse option { from: '${r.from}' }`)}return!this._name&&this._scriptPath&&this.nameFromFilename(this._scriptPath),this._name=this._name||"program",n}parse(e,r){this._prepareForParse();let n=this._prepareUserArgs(e,r);return this._parseCommand([],n),this}async parseAsync(e,r){this._prepareForParse();let n=this._prepareUserArgs(e,r);return await this._parseCommand([],n),this}_prepareForParse(){this._savedState===null?this.saveStateBeforeParse():this.restoreStateBeforeParse()}saveStateBeforeParse(){this._savedState={_name:this._name,_optionValues:{...this._optionValues},_optionValueSources:{...this._optionValueSources}}}restoreStateBeforeParse(){if(this._storeOptionsAsProperties)throw new Error(`Can not call parse again when storeOptionsAsProperties is true. +(Did you mean ${n[0]}?)`:""}p4.suggestSimilar=Qde});var _4=v(qA=>{var efe=Ge("node:events").EventEmitter,FA=Ge("node:child_process"),fo=Ge("node:path"),Sy=Ge("node:fs"),Be=Ge("node:process"),{Argument:tfe,humanReadableArgName:rfe}=vy(),{CommanderError:LA}=of(),{Help:nfe,stripColor:ife}=CA(),{Option:h4,DualOptions:ofe}=MA(),{suggestSimilar:g4}=m4(),zA=class t extends efe{constructor(e){super(),this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!1,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=e||"",this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description="",this._summary="",this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._savedState=null,this._outputConfiguration={writeOut:r=>Be.stdout.write(r),writeErr:r=>Be.stderr.write(r),outputError:(r,n)=>n(r),getOutHelpWidth:()=>Be.stdout.isTTY?Be.stdout.columns:void 0,getErrHelpWidth:()=>Be.stderr.isTTY?Be.stderr.columns:void 0,getOutHasColors:()=>UA()??(Be.stdout.isTTY&&Be.stdout.hasColors?.()),getErrHasColors:()=>UA()??(Be.stderr.isTTY&&Be.stderr.hasColors?.()),stripColor:r=>ife(r)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={},this._helpGroupHeading=void 0,this._defaultCommandGroup=void 0,this._defaultOptionGroup=void 0}copyInheritedSettings(e){return this._outputConfiguration=e._outputConfiguration,this._helpOption=e._helpOption,this._helpCommand=e._helpCommand,this._helpConfiguration=e._helpConfiguration,this._exitCallback=e._exitCallback,this._storeOptionsAsProperties=e._storeOptionsAsProperties,this._combineFlagAndOptionalValue=e._combineFlagAndOptionalValue,this._allowExcessArguments=e._allowExcessArguments,this._enablePositionalOptions=e._enablePositionalOptions,this._showHelpAfterError=e._showHelpAfterError,this._showSuggestionAfterError=e._showSuggestionAfterError,this}_getCommandAndAncestors(){let e=[];for(let r=this;r;r=r.parent)e.push(r);return e}command(e,r,n){let i=r,o=n;typeof i=="object"&&i!==null&&(o=i,i=null),o=o||{};let[,s,a]=e.match(/([^ ]+) *(.*)/),c=this.createCommand(s);return i&&(c.description(i),c._executableHandler=!0),o.isDefault&&(this._defaultCommandName=c._name),c._hidden=!!(o.noHelp||o.hidden),c._executableFile=o.executableFile||null,a&&c.arguments(a),this._registerCommand(c),c.parent=this,c.copyInheritedSettings(this),i?this:c}createCommand(e){return new t(e)}createHelp(){return Object.assign(new nfe,this.configureHelp())}configureHelp(e){return e===void 0?this._helpConfiguration:(this._helpConfiguration=e,this)}configureOutput(e){return e===void 0?this._outputConfiguration:(this._outputConfiguration={...this._outputConfiguration,...e},this)}showHelpAfterError(e=!0){return typeof e!="string"&&(e=!!e),this._showHelpAfterError=e,this}showSuggestionAfterError(e=!0){return this._showSuggestionAfterError=!!e,this}addCommand(e,r){if(!e._name)throw new Error(`Command passed to .addCommand() must have a name +- specify the name in Command constructor or using .name()`);return r=r||{},r.isDefault&&(this._defaultCommandName=e._name),(r.noHelp||r.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,r){return new tfe(e,r)}argument(e,r,n,i){let o=this.createArgument(e,r);return typeof n=="function"?o.default(i).argParser(n):o.default(n),this.addArgument(o),this}arguments(e){return e.trim().split(/ +/).forEach(r=>{this.argument(r)}),this}addArgument(e){let r=this.registeredArguments.slice(-1)[0];if(r?.variadic)throw new Error(`only the last argument can be variadic '${r.name()}'`);if(e.required&&e.defaultValue!==void 0&&e.parseArg===void 0)throw new Error(`a default value for a required argument is never used: '${e.name()}'`);return this.registeredArguments.push(e),this}helpCommand(e,r){if(typeof e=="boolean")return this._addImplicitHelpCommand=e,e&&this._defaultCommandGroup&&this._initCommandGroup(this._getHelpCommand()),this;let n=e??"help [command]",[,i,o]=n.match(/([^ ]+) *(.*)/),s=r??"display help for command",a=this.createCommand(i);return a.helpOption(!1),o&&a.arguments(o),s&&a.description(s),this._addImplicitHelpCommand=!0,this._helpCommand=a,(e||r)&&this._initCommandGroup(a),this}addHelpCommand(e,r){return typeof e!="object"?(this.helpCommand(e,r),this):(this._addImplicitHelpCommand=!0,this._helpCommand=e,this._initCommandGroup(e),this)}_getHelpCommand(){return this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand("help"))?(this._helpCommand===void 0&&this.helpCommand(void 0,void 0),this._helpCommand):null}hook(e,r){let n=["preSubcommand","preAction","postAction"];if(!n.includes(e))throw new Error(`Unexpected value for event passed to hook : '${e}'. +Expecting one of '${n.join("', '")}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(r):this._lifeCycleHooks[e]=[r],this}exitOverride(e){return e?this._exitCallback=e:this._exitCallback=r=>{if(r.code!=="commander.executeSubCommandAsync")throw r},this}_exit(e,r,n){this._exitCallback&&this._exitCallback(new LA(e,r,n)),Be.exit(e)}action(e){let r=n=>{let i=this.registeredArguments.length,o=n.slice(0,i);return this._storeOptionsAsProperties?o[i]=this:o[i]=this.opts(),o.push(this),e.apply(this,o)};return this._actionHandler=r,this}createOption(e,r){return new h4(e,r)}_callParseArg(e,r,n,i){try{return e.parseArg(r,n)}catch(o){if(o.code==="commander.invalidArgument"){let s=`${i} ${o.message}`;this.error(s,{exitCode:o.exitCode,code:o.code})}throw o}}_registerOption(e){let r=e.short&&this._findOption(e.short)||e.long&&this._findOption(e.long);if(r){let n=e.long&&this._findOption(e.long)?e.long:e.short;throw new Error(`Cannot add option '${e.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${n}' +- already used by option '${r.flags}'`)}this._initOptionGroup(e),this.options.push(e)}_registerCommand(e){let r=i=>[i.name()].concat(i.aliases()),n=r(e).find(i=>this._findCommand(i));if(n){let i=r(this._findCommand(n)).join("|"),o=r(e).join("|");throw new Error(`cannot add command '${o}' as already have command '${i}'`)}this._initCommandGroup(e),this.commands.push(e)}addOption(e){this._registerOption(e);let r=e.name(),n=e.attributeName();if(e.negate){let o=e.long.replace(/^--no-/,"--");this._findOption(o)||this.setOptionValueWithSource(n,e.defaultValue===void 0?!0:e.defaultValue,"default")}else e.defaultValue!==void 0&&this.setOptionValueWithSource(n,e.defaultValue,"default");let i=(o,s,a)=>{o==null&&e.presetArg!==void 0&&(o=e.presetArg);let c=this.getOptionValue(n);o!==null&&e.parseArg?o=this._callParseArg(e,o,c,s):o!==null&&e.variadic&&(o=e._collectValue(o,c)),o==null&&(e.negate?o=!1:e.isBoolean()||e.optional?o=!0:o=""),this.setOptionValueWithSource(n,o,a)};return this.on("option:"+r,o=>{let s=`error: option '${e.flags}' argument '${o}' is invalid.`;i(o,s,"cli")}),e.envVar&&this.on("optionEnv:"+r,o=>{let s=`error: option '${e.flags}' value '${o}' from env '${e.envVar}' is invalid.`;i(o,s,"env")}),this}_optionEx(e,r,n,i,o){if(typeof r=="object"&&r instanceof h4)throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");let s=this.createOption(r,n);if(s.makeOptionMandatory(!!e.mandatory),typeof i=="function")s.default(o).argParser(i);else if(i instanceof RegExp){let a=i;i=(c,l)=>{let u=a.exec(c);return u?u[0]:l},s.default(o).argParser(i)}else s.default(i);return this.addOption(s)}option(e,r,n,i){return this._optionEx({},e,r,n,i)}requiredOption(e,r,n,i){return this._optionEx({mandatory:!0},e,r,n,i)}combineFlagAndOptionalValue(e=!0){return this._combineFlagAndOptionalValue=!!e,this}allowUnknownOption(e=!0){return this._allowUnknownOption=!!e,this}allowExcessArguments(e=!0){return this._allowExcessArguments=!!e,this}enablePositionalOptions(e=!0){return this._enablePositionalOptions=!!e,this}passThroughOptions(e=!0){return this._passThroughOptions=!!e,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties(e=!0){if(this.options.length)throw new Error("call .storeOptionsAsProperties() before adding options");if(Object.keys(this._optionValues).length)throw new Error("call .storeOptionsAsProperties() before setting option values");return this._storeOptionsAsProperties=!!e,this}getOptionValue(e){return this._storeOptionsAsProperties?this[e]:this._optionValues[e]}setOptionValue(e,r){return this.setOptionValueWithSource(e,r,void 0)}setOptionValueWithSource(e,r,n){return this._storeOptionsAsProperties?this[e]=r:this._optionValues[e]=r,this._optionValueSources[e]=n,this}getOptionValueSource(e){return this._optionValueSources[e]}getOptionValueSourceWithGlobals(e){let r;return this._getCommandAndAncestors().forEach(n=>{n.getOptionValueSource(e)!==void 0&&(r=n.getOptionValueSource(e))}),r}_prepareUserArgs(e,r){if(e!==void 0&&!Array.isArray(e))throw new Error("first parameter to parse must be array or undefined");if(r=r||{},e===void 0&&r.from===void 0){Be.versions?.electron&&(r.from="electron");let i=Be.execArgv??[];(i.includes("-e")||i.includes("--eval")||i.includes("-p")||i.includes("--print"))&&(r.from="eval")}e===void 0&&(e=Be.argv),this.rawArgs=e.slice();let n;switch(r.from){case void 0:case"node":this._scriptPath=e[1],n=e.slice(2);break;case"electron":Be.defaultApp?(this._scriptPath=e[1],n=e.slice(2)):n=e.slice(1);break;case"user":n=e.slice(0);break;case"eval":n=e.slice(1);break;default:throw new Error(`unexpected parse option { from: '${r.from}' }`)}return!this._name&&this._scriptPath&&this.nameFromFilename(this._scriptPath),this._name=this._name||"program",n}parse(e,r){this._prepareForParse();let n=this._prepareUserArgs(e,r);return this._parseCommand([],n),this}async parseAsync(e,r){this._prepareForParse();let n=this._prepareUserArgs(e,r);return await this._parseCommand([],n),this}_prepareForParse(){this._savedState===null?this.saveStateBeforeParse():this.restoreStateBeforeParse()}saveStateBeforeParse(){this._savedState={_name:this._name,_optionValues:{...this._optionValues},_optionValueSources:{...this._optionValueSources}}}restoreStateBeforeParse(){if(this._storeOptionsAsProperties)throw new Error(`Can not call parse again when storeOptionsAsProperties is true. - either make a new Command for each call to parse, or stop storing options as properties`);this._name=this._savedState._name,this._scriptPath=null,this.rawArgs=[],this._optionValues={...this._savedState._optionValues},this._optionValueSources={...this._savedState._optionValueSources},this.args=[],this.processedArgs=[]}_checkForMissingExecutable(e,r,n){if(Sy.existsSync(e))return;let i=r?`searched for local subcommand relative to directory '${r}'`:"no directory for search for local subcommand, use .executableDir() to supply a custom directory",o=`'${e}' does not exist - if '${n}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead - if the default executable name is not suitable, use the executableFile option to supply a custom name or path - - ${i}`;throw new Error(o)}_executeSubCommand(e,r){r=r.slice();let n=!1,i=[".js",".ts",".tsx",".mjs",".cjs"];function o(u,d){let f=fo.resolve(u,d);if(Sy.existsSync(f))return f;if(i.includes(fo.extname(d)))return;let p=i.find(m=>Sy.existsSync(`${f}${m}`));if(p)return`${f}${p}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let s=e._executableFile||`${this._name}-${e._name}`,a=this._executableDir||"";if(this._scriptPath){let u;try{u=Sy.realpathSync(this._scriptPath)}catch{u=this._scriptPath}a=fo.resolve(fo.dirname(u),a)}if(a){let u=o(a,s);if(!u&&!e._executableFile&&this._scriptPath){let d=fo.basename(this._scriptPath,fo.extname(this._scriptPath));d!==this._name&&(u=o(a,`${d}-${e._name}`))}s=u||s}n=i.includes(fo.extname(s));let c;Be.platform!=="win32"?n?(r.unshift(s),r=g4(Be.execArgv).concat(r),c=FA.spawn(Be.argv[0],r,{stdio:"inherit"})):c=FA.spawn(s,r,{stdio:"inherit"}):(this._checkForMissingExecutable(s,a,e._name),r.unshift(s),r=g4(Be.execArgv).concat(r),c=FA.spawn(Be.execPath,r,{stdio:"inherit"})),c.killed||["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach(d=>{Be.on(d,()=>{c.killed===!1&&c.exitCode===null&&c.kill(d)})});let l=this._exitCallback;c.on("close",u=>{u=u??1,l?l(new LA(u,"commander.executeSubCommandAsync","(close)")):Be.exit(u)}),c.on("error",u=>{if(u.code==="ENOENT")this._checkForMissingExecutable(s,a,e._name);else if(u.code==="EACCES")throw new Error(`'${s}' not executable`);if(!l)Be.exit(1);else{let d=new LA(1,"commander.executeSubCommandAsync","(error)");d.nestedError=u,l(d)}}),this.runningCommand=c}_dispatchSubcommand(e,r,n){let i=this._findCommand(e);i||this.help({error:!0}),i._prepareForParse();let o;return o=this._chainOrCallSubCommandHook(o,i,"preSubcommand"),o=this._chainOrCall(o,()=>{if(i._executableHandler)this._executeSubCommand(i,r.concat(n));else return i._parseCommand(r,n)}),o}_dispatchHelpCommand(e){e||this.help();let r=this._findCommand(e);return r&&!r._executableHandler&&r.help(),this._dispatchSubcommand(e,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??"--help"])}_checkNumberOfArguments(){this.registeredArguments.forEach((e,r)=>{e.required&&this.args[r]==null&&this.missingArgument(e.name())}),!(this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)&&this.args.length>this.registeredArguments.length&&this._excessArguments(this.args)}_processArguments(){let e=(n,i,o)=>{let s=i;if(i!==null&&n.parseArg){let a=`error: command-argument value '${i}' is invalid for argument '${n.name()}'.`;s=this._callParseArg(n,i,o,a)}return s};this._checkNumberOfArguments();let r=[];this.registeredArguments.forEach((n,i)=>{let o=n.defaultValue;n.variadic?ie(n,a,s),n.defaultValue))):o===void 0&&(o=[]):ir()):r()}_chainOrCallHooks(e,r){let n=e,i=[];return this._getCommandAndAncestors().reverse().filter(o=>o._lifeCycleHooks[r]!==void 0).forEach(o=>{o._lifeCycleHooks[r].forEach(s=>{i.push({hookedCommand:o,callback:s})})}),r==="postAction"&&i.reverse(),i.forEach(o=>{n=this._chainOrCall(n,()=>o.callback(o.hookedCommand,this))}),n}_chainOrCallSubCommandHook(e,r,n){let i=e;return this._lifeCycleHooks[n]!==void 0&&this._lifeCycleHooks[n].forEach(o=>{i=this._chainOrCall(i,()=>o(this,r))}),i}_parseCommand(e,r){let n=this.parseOptions(r);if(this._parseOptionsEnv(),this._parseOptionsImplied(),e=e.concat(n.operands),r=n.unknown,this.args=e.concat(r),e&&this._findCommand(e[0]))return this._dispatchSubcommand(e[0],e.slice(1),r);if(this._getHelpCommand()&&e[0]===this._getHelpCommand().name())return this._dispatchHelpCommand(e[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(r),this._dispatchSubcommand(this._defaultCommandName,e,r);this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName&&this.help({error:!0}),this._outputHelpIfRequested(n.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let i=()=>{n.unknown.length>0&&this.unknownOption(n.unknown[0])},o=`command:${this.name()}`;if(this._actionHandler){i(),this._processArguments();let s;return s=this._chainOrCallHooks(s,"preAction"),s=this._chainOrCall(s,()=>this._actionHandler(this.processedArgs)),this.parent&&(s=this._chainOrCall(s,()=>{this.parent.emit(o,e,r)})),s=this._chainOrCallHooks(s,"postAction"),s}if(this.parent?.listenerCount(o))i(),this._processArguments(),this.parent.emit(o,e,r);else if(e.length){if(this._findCommand("*"))return this._dispatchSubcommand("*",e,r);this.listenerCount("command:*")?this.emit("command:*",e,r):this.commands.length?this.unknownCommand():(i(),this._processArguments())}else this.commands.length?(i(),this.help({error:!0})):(i(),this._processArguments())}_findCommand(e){if(e)return this.commands.find(r=>r._name===e||r._aliases.includes(e))}_findOption(e){return this.options.find(r=>r.is(e))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(e=>{e.options.forEach(r=>{r.mandatory&&e.getOptionValue(r.attributeName())===void 0&&e.missingMandatoryOptionValue(r)})})}_checkForConflictingLocalOptions(){let e=this.options.filter(n=>{let i=n.attributeName();return this.getOptionValue(i)===void 0?!1:this.getOptionValueSource(i)!=="default"});e.filter(n=>n.conflictsWith.length>0).forEach(n=>{let i=e.find(o=>n.conflictsWith.includes(o.attributeName()));i&&this._conflictingOption(n,i)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(e=>{e._checkForConflictingLocalOptions()})}parseOptions(e){let r=[],n=[],i=r;function o(u){return u.length>1&&u[0]==="-"}let s=u=>/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(u)?!this._getCommandAndAncestors().some(d=>d.options.map(f=>f.short).some(f=>/^-\d$/.test(f))):!1,a=null,c=null,l=0;for(;l2&&u[0]==="-"&&u[1]!=="-"){let d=this._findOption(`-${u[1]}`);if(d){d.required||d.optional&&this._combineFlagAndOptionalValue?this.emit(`option:${d.name()}`,u.slice(2)):(this.emit(`option:${d.name()}`),c=`-${u.slice(2)}`);continue}}if(/^--[^=]+=/.test(u)){let d=u.indexOf("="),f=this._findOption(u.slice(0,d));if(f&&(f.required||f.optional)){this.emit(`option:${f.name()}`,u.slice(d+1));continue}}if(i===r&&o(u)&&!(this.commands.length===0&&s(u))&&(i=n),(this._enablePositionalOptions||this._passThroughOptions)&&r.length===0&&n.length===0){if(this._findCommand(u)){r.push(u),n.push(...e.slice(l));break}else if(this._getHelpCommand()&&u===this._getHelpCommand().name()){r.push(u,...e.slice(l));break}else if(this._defaultCommandName){n.push(u,...e.slice(l));break}}if(this._passThroughOptions){i.push(u,...e.slice(l));break}i.push(u)}return{operands:r,unknown:n}}opts(){if(this._storeOptionsAsProperties){let e={},r=this.options.length;for(let n=0;nObject.assign(e,r.opts()),{})}error(e,r){this._outputConfiguration.outputError(`${e} + - ${i}`;throw new Error(o)}_executeSubCommand(e,r){r=r.slice();let n=!1,i=[".js",".ts",".tsx",".mjs",".cjs"];function o(u,d){let f=fo.resolve(u,d);if(Sy.existsSync(f))return f;if(i.includes(fo.extname(d)))return;let p=i.find(m=>Sy.existsSync(`${f}${m}`));if(p)return`${f}${p}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let s=e._executableFile||`${this._name}-${e._name}`,a=this._executableDir||"";if(this._scriptPath){let u;try{u=Sy.realpathSync(this._scriptPath)}catch{u=this._scriptPath}a=fo.resolve(fo.dirname(u),a)}if(a){let u=o(a,s);if(!u&&!e._executableFile&&this._scriptPath){let d=fo.basename(this._scriptPath,fo.extname(this._scriptPath));d!==this._name&&(u=o(a,`${d}-${e._name}`))}s=u||s}n=i.includes(fo.extname(s));let c;Be.platform!=="win32"?n?(r.unshift(s),r=y4(Be.execArgv).concat(r),c=FA.spawn(Be.argv[0],r,{stdio:"inherit"})):c=FA.spawn(s,r,{stdio:"inherit"}):(this._checkForMissingExecutable(s,a,e._name),r.unshift(s),r=y4(Be.execArgv).concat(r),c=FA.spawn(Be.execPath,r,{stdio:"inherit"})),c.killed||["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach(d=>{Be.on(d,()=>{c.killed===!1&&c.exitCode===null&&c.kill(d)})});let l=this._exitCallback;c.on("close",u=>{u=u??1,l?l(new LA(u,"commander.executeSubCommandAsync","(close)")):Be.exit(u)}),c.on("error",u=>{if(u.code==="ENOENT")this._checkForMissingExecutable(s,a,e._name);else if(u.code==="EACCES")throw new Error(`'${s}' not executable`);if(!l)Be.exit(1);else{let d=new LA(1,"commander.executeSubCommandAsync","(error)");d.nestedError=u,l(d)}}),this.runningCommand=c}_dispatchSubcommand(e,r,n){let i=this._findCommand(e);i||this.help({error:!0}),i._prepareForParse();let o;return o=this._chainOrCallSubCommandHook(o,i,"preSubcommand"),o=this._chainOrCall(o,()=>{if(i._executableHandler)this._executeSubCommand(i,r.concat(n));else return i._parseCommand(r,n)}),o}_dispatchHelpCommand(e){e||this.help();let r=this._findCommand(e);return r&&!r._executableHandler&&r.help(),this._dispatchSubcommand(e,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??"--help"])}_checkNumberOfArguments(){this.registeredArguments.forEach((e,r)=>{e.required&&this.args[r]==null&&this.missingArgument(e.name())}),!(this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)&&this.args.length>this.registeredArguments.length&&this._excessArguments(this.args)}_processArguments(){let e=(n,i,o)=>{let s=i;if(i!==null&&n.parseArg){let a=`error: command-argument value '${i}' is invalid for argument '${n.name()}'.`;s=this._callParseArg(n,i,o,a)}return s};this._checkNumberOfArguments();let r=[];this.registeredArguments.forEach((n,i)=>{let o=n.defaultValue;n.variadic?ie(n,a,s),n.defaultValue))):o===void 0&&(o=[]):ir()):r()}_chainOrCallHooks(e,r){let n=e,i=[];return this._getCommandAndAncestors().reverse().filter(o=>o._lifeCycleHooks[r]!==void 0).forEach(o=>{o._lifeCycleHooks[r].forEach(s=>{i.push({hookedCommand:o,callback:s})})}),r==="postAction"&&i.reverse(),i.forEach(o=>{n=this._chainOrCall(n,()=>o.callback(o.hookedCommand,this))}),n}_chainOrCallSubCommandHook(e,r,n){let i=e;return this._lifeCycleHooks[n]!==void 0&&this._lifeCycleHooks[n].forEach(o=>{i=this._chainOrCall(i,()=>o(this,r))}),i}_parseCommand(e,r){let n=this.parseOptions(r);if(this._parseOptionsEnv(),this._parseOptionsImplied(),e=e.concat(n.operands),r=n.unknown,this.args=e.concat(r),e&&this._findCommand(e[0]))return this._dispatchSubcommand(e[0],e.slice(1),r);if(this._getHelpCommand()&&e[0]===this._getHelpCommand().name())return this._dispatchHelpCommand(e[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(r),this._dispatchSubcommand(this._defaultCommandName,e,r);this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName&&this.help({error:!0}),this._outputHelpIfRequested(n.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let i=()=>{n.unknown.length>0&&this.unknownOption(n.unknown[0])},o=`command:${this.name()}`;if(this._actionHandler){i(),this._processArguments();let s;return s=this._chainOrCallHooks(s,"preAction"),s=this._chainOrCall(s,()=>this._actionHandler(this.processedArgs)),this.parent&&(s=this._chainOrCall(s,()=>{this.parent.emit(o,e,r)})),s=this._chainOrCallHooks(s,"postAction"),s}if(this.parent?.listenerCount(o))i(),this._processArguments(),this.parent.emit(o,e,r);else if(e.length){if(this._findCommand("*"))return this._dispatchSubcommand("*",e,r);this.listenerCount("command:*")?this.emit("command:*",e,r):this.commands.length?this.unknownCommand():(i(),this._processArguments())}else this.commands.length?(i(),this.help({error:!0})):(i(),this._processArguments())}_findCommand(e){if(e)return this.commands.find(r=>r._name===e||r._aliases.includes(e))}_findOption(e){return this.options.find(r=>r.is(e))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(e=>{e.options.forEach(r=>{r.mandatory&&e.getOptionValue(r.attributeName())===void 0&&e.missingMandatoryOptionValue(r)})})}_checkForConflictingLocalOptions(){let e=this.options.filter(n=>{let i=n.attributeName();return this.getOptionValue(i)===void 0?!1:this.getOptionValueSource(i)!=="default"});e.filter(n=>n.conflictsWith.length>0).forEach(n=>{let i=e.find(o=>n.conflictsWith.includes(o.attributeName()));i&&this._conflictingOption(n,i)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(e=>{e._checkForConflictingLocalOptions()})}parseOptions(e){let r=[],n=[],i=r;function o(u){return u.length>1&&u[0]==="-"}let s=u=>/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(u)?!this._getCommandAndAncestors().some(d=>d.options.map(f=>f.short).some(f=>/^-\d$/.test(f))):!1,a=null,c=null,l=0;for(;l2&&u[0]==="-"&&u[1]!=="-"){let d=this._findOption(`-${u[1]}`);if(d){d.required||d.optional&&this._combineFlagAndOptionalValue?this.emit(`option:${d.name()}`,u.slice(2)):(this.emit(`option:${d.name()}`),c=`-${u.slice(2)}`);continue}}if(/^--[^=]+=/.test(u)){let d=u.indexOf("="),f=this._findOption(u.slice(0,d));if(f&&(f.required||f.optional)){this.emit(`option:${f.name()}`,u.slice(d+1));continue}}if(i===r&&o(u)&&!(this.commands.length===0&&s(u))&&(i=n),(this._enablePositionalOptions||this._passThroughOptions)&&r.length===0&&n.length===0){if(this._findCommand(u)){r.push(u),n.push(...e.slice(l));break}else if(this._getHelpCommand()&&u===this._getHelpCommand().name()){r.push(u,...e.slice(l));break}else if(this._defaultCommandName){n.push(u,...e.slice(l));break}}if(this._passThroughOptions){i.push(u,...e.slice(l));break}i.push(u)}return{operands:r,unknown:n}}opts(){if(this._storeOptionsAsProperties){let e={},r=this.options.length;for(let n=0;nObject.assign(e,r.opts()),{})}error(e,r){this._outputConfiguration.outputError(`${e} `,this._outputConfiguration.writeErr),typeof this._showHelpAfterError=="string"?this._outputConfiguration.writeErr(`${this._showHelpAfterError} `):this._showHelpAfterError&&(this._outputConfiguration.writeErr(` -`),this.outputHelp({error:!0}));let n=r||{},i=n.exitCode||1,o=n.code||"commander.error";this._exit(i,o,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in Be.env){let r=e.attributeName();(this.getOptionValue(r)===void 0||["default","config","env"].includes(this.getOptionValueSource(r)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,Be.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new rfe(this.options),r=n=>this.getOptionValue(n)!==void 0&&!["default","implied"].includes(this.getOptionValueSource(n));this.options.filter(n=>n.implied!==void 0&&r(n.attributeName())&&e.valueFromOption(this.getOptionValue(n.attributeName()),n)).forEach(n=>{Object.keys(n.implied).filter(i=>!r(i)).forEach(i=>{this.setOptionValueWithSource(i,n.implied[i],"implied")})})}missingArgument(e){let r=`error: missing required argument '${e}'`;this.error(r,{code:"commander.missingArgument"})}optionMissingArgument(e){let r=`error: option '${e.flags}' argument missing`;this.error(r,{code:"commander.optionMissingArgument"})}missingMandatoryOptionValue(e){let r=`error: required option '${e.flags}' not specified`;this.error(r,{code:"commander.missingMandatoryOptionValue"})}_conflictingOption(e,r){let n=s=>{let a=s.attributeName(),c=this.getOptionValue(a),l=this.options.find(d=>d.negate&&a===d.attributeName()),u=this.options.find(d=>!d.negate&&a===d.attributeName());return l&&(l.presetArg===void 0&&c===!1||l.presetArg!==void 0&&c===l.presetArg)?l:u||s},i=s=>{let a=n(s),c=a.attributeName();return this.getOptionValueSource(c)==="env"?`environment variable '${a.envVar}'`:`option '${a.flags}'`},o=`error: ${i(e)} cannot be used with ${i(r)}`;this.error(o,{code:"commander.conflictingOption"})}unknownOption(e){if(this._allowUnknownOption)return;let r="";if(e.startsWith("--")&&this._showSuggestionAfterError){let i=[],o=this;do{let s=o.createHelp().visibleOptions(o).filter(a=>a.long).map(a=>a.long);i=i.concat(s),o=o.parent}while(o&&!o._enablePositionalOptions);r=h4(e,i)}let n=`error: unknown option '${e}'${r}`;this.error(n,{code:"commander.unknownOption"})}_excessArguments(e){if(this._allowExcessArguments)return;let r=this.registeredArguments.length,n=r===1?"":"s",o=`error: too many arguments${this.parent?` for '${this.name()}'`:""}. Expected ${r} argument${n} but got ${e.length}.`;this.error(o,{code:"commander.excessArguments"})}unknownCommand(){let e=this.args[0],r="";if(this._showSuggestionAfterError){let i=[];this.createHelp().visibleCommands(this).forEach(o=>{i.push(o.name()),o.alias()&&i.push(o.alias())}),r=h4(e,i)}let n=`error: unknown command '${e}'${r}`;this.error(n,{code:"commander.unknownCommand"})}version(e,r,n){if(e===void 0)return this._version;this._version=e,r=r||"-V, --version",n=n||"output the version number";let i=this.createOption(r,n);return this._versionOptionName=i.attributeName(),this._registerOption(i),this.on("option:"+i.name(),()=>{this._outputConfiguration.writeOut(`${e} -`),this._exit(0,"commander.version",e)}),this}description(e,r){return e===void 0&&r===void 0?this._description:(this._description=e,r&&(this._argsDescription=r),this)}summary(e){return e===void 0?this._summary:(this._summary=e,this)}alias(e){if(e===void 0)return this._aliases[0];let r=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler&&(r=this.commands[this.commands.length-1]),e===r._name)throw new Error("Command alias can't be the same as its name");let n=this.parent?._findCommand(e);if(n){let i=[n.name()].concat(n.aliases()).join("|");throw new Error(`cannot add alias '${e}' to command '${this.name()}' as already have command '${i}'`)}return r._aliases.push(e),this}aliases(e){return e===void 0?this._aliases:(e.forEach(r=>this.alias(r)),this)}usage(e){if(e===void 0){if(this._usage)return this._usage;let r=this.registeredArguments.map(n=>Qde(n));return[].concat(this.options.length||this._helpOption!==null?"[options]":[],this.commands.length?"[command]":[],this.registeredArguments.length?r:[]).join(" ")}return this._usage=e,this}name(e){return e===void 0?this._name:(this._name=e,this)}helpGroup(e){return e===void 0?this._helpGroupHeading??"":(this._helpGroupHeading=e,this)}commandsGroup(e){return e===void 0?this._defaultCommandGroup??"":(this._defaultCommandGroup=e,this)}optionsGroup(e){return e===void 0?this._defaultOptionGroup??"":(this._defaultOptionGroup=e,this)}_initOptionGroup(e){this._defaultOptionGroup&&!e.helpGroupHeading&&e.helpGroup(this._defaultOptionGroup)}_initCommandGroup(e){this._defaultCommandGroup&&!e.helpGroup()&&e.helpGroup(this._defaultCommandGroup)}nameFromFilename(e){return this._name=fo.basename(e,fo.extname(e)),this}executableDir(e){return e===void 0?this._executableDir:(this._executableDir=e,this)}helpInformation(e){let r=this.createHelp(),n=this._getOutputContext(e);r.prepareContext({error:n.error,helpWidth:n.helpWidth,outputHasColors:n.hasColors});let i=r.formatHelp(this,r);return n.hasColors?i:this._outputConfiguration.stripColor(i)}_getOutputContext(e){e=e||{};let r=!!e.error,n,i,o;return r?(n=a=>this._outputConfiguration.writeErr(a),i=this._outputConfiguration.getErrHasColors(),o=this._outputConfiguration.getErrHelpWidth()):(n=a=>this._outputConfiguration.writeOut(a),i=this._outputConfiguration.getOutHasColors(),o=this._outputConfiguration.getOutHelpWidth()),{error:r,write:a=>(i||(a=this._outputConfiguration.stripColor(a)),n(a)),hasColors:i,helpWidth:o}}outputHelp(e){let r;typeof e=="function"&&(r=e,e=void 0);let n=this._getOutputContext(e),i={error:n.error,write:n.write,command:this};this._getCommandAndAncestors().reverse().forEach(s=>s.emit("beforeAllHelp",i)),this.emit("beforeHelp",i);let o=this.helpInformation({error:n.error});if(r&&(o=r(o),typeof o!="string"&&!Buffer.isBuffer(o)))throw new Error("outputHelp callback must return a string or a Buffer");n.write(o),this._getHelpOption()?.long&&this.emit(this._getHelpOption().long),this.emit("afterHelp",i),this._getCommandAndAncestors().forEach(s=>s.emit("afterAllHelp",i))}helpOption(e,r){return typeof e=="boolean"?(e?(this._helpOption===null&&(this._helpOption=void 0),this._defaultOptionGroup&&this._initOptionGroup(this._getHelpOption())):this._helpOption=null,this):(this._helpOption=this.createOption(e??"-h, --help",r??"display help for command"),(e||r)&&this._initOptionGroup(this._helpOption),this)}_getHelpOption(){return this._helpOption===void 0&&this.helpOption(void 0,void 0),this._helpOption}addHelpOption(e){return this._helpOption=e,this._initOptionGroup(e),this}help(e){this.outputHelp(e);let r=Number(Be.exitCode??0);r===0&&e&&typeof e!="function"&&e.error&&(r=1),this._exit(r,"commander.help","(outputHelp)")}addHelpText(e,r){let n=["beforeAll","before","after","afterAll"];if(!n.includes(e))throw new Error(`Unexpected value for position to addHelpText. +`),this.outputHelp({error:!0}));let n=r||{},i=n.exitCode||1,o=n.code||"commander.error";this._exit(i,o,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in Be.env){let r=e.attributeName();(this.getOptionValue(r)===void 0||["default","config","env"].includes(this.getOptionValueSource(r)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,Be.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new ofe(this.options),r=n=>this.getOptionValue(n)!==void 0&&!["default","implied"].includes(this.getOptionValueSource(n));this.options.filter(n=>n.implied!==void 0&&r(n.attributeName())&&e.valueFromOption(this.getOptionValue(n.attributeName()),n)).forEach(n=>{Object.keys(n.implied).filter(i=>!r(i)).forEach(i=>{this.setOptionValueWithSource(i,n.implied[i],"implied")})})}missingArgument(e){let r=`error: missing required argument '${e}'`;this.error(r,{code:"commander.missingArgument"})}optionMissingArgument(e){let r=`error: option '${e.flags}' argument missing`;this.error(r,{code:"commander.optionMissingArgument"})}missingMandatoryOptionValue(e){let r=`error: required option '${e.flags}' not specified`;this.error(r,{code:"commander.missingMandatoryOptionValue"})}_conflictingOption(e,r){let n=s=>{let a=s.attributeName(),c=this.getOptionValue(a),l=this.options.find(d=>d.negate&&a===d.attributeName()),u=this.options.find(d=>!d.negate&&a===d.attributeName());return l&&(l.presetArg===void 0&&c===!1||l.presetArg!==void 0&&c===l.presetArg)?l:u||s},i=s=>{let a=n(s),c=a.attributeName();return this.getOptionValueSource(c)==="env"?`environment variable '${a.envVar}'`:`option '${a.flags}'`},o=`error: ${i(e)} cannot be used with ${i(r)}`;this.error(o,{code:"commander.conflictingOption"})}unknownOption(e){if(this._allowUnknownOption)return;let r="";if(e.startsWith("--")&&this._showSuggestionAfterError){let i=[],o=this;do{let s=o.createHelp().visibleOptions(o).filter(a=>a.long).map(a=>a.long);i=i.concat(s),o=o.parent}while(o&&!o._enablePositionalOptions);r=g4(e,i)}let n=`error: unknown option '${e}'${r}`;this.error(n,{code:"commander.unknownOption"})}_excessArguments(e){if(this._allowExcessArguments)return;let r=this.registeredArguments.length,n=r===1?"":"s",o=`error: too many arguments${this.parent?` for '${this.name()}'`:""}. Expected ${r} argument${n} but got ${e.length}.`;this.error(o,{code:"commander.excessArguments"})}unknownCommand(){let e=this.args[0],r="";if(this._showSuggestionAfterError){let i=[];this.createHelp().visibleCommands(this).forEach(o=>{i.push(o.name()),o.alias()&&i.push(o.alias())}),r=g4(e,i)}let n=`error: unknown command '${e}'${r}`;this.error(n,{code:"commander.unknownCommand"})}version(e,r,n){if(e===void 0)return this._version;this._version=e,r=r||"-V, --version",n=n||"output the version number";let i=this.createOption(r,n);return this._versionOptionName=i.attributeName(),this._registerOption(i),this.on("option:"+i.name(),()=>{this._outputConfiguration.writeOut(`${e} +`),this._exit(0,"commander.version",e)}),this}description(e,r){return e===void 0&&r===void 0?this._description:(this._description=e,r&&(this._argsDescription=r),this)}summary(e){return e===void 0?this._summary:(this._summary=e,this)}alias(e){if(e===void 0)return this._aliases[0];let r=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler&&(r=this.commands[this.commands.length-1]),e===r._name)throw new Error("Command alias can't be the same as its name");let n=this.parent?._findCommand(e);if(n){let i=[n.name()].concat(n.aliases()).join("|");throw new Error(`cannot add alias '${e}' to command '${this.name()}' as already have command '${i}'`)}return r._aliases.push(e),this}aliases(e){return e===void 0?this._aliases:(e.forEach(r=>this.alias(r)),this)}usage(e){if(e===void 0){if(this._usage)return this._usage;let r=this.registeredArguments.map(n=>rfe(n));return[].concat(this.options.length||this._helpOption!==null?"[options]":[],this.commands.length?"[command]":[],this.registeredArguments.length?r:[]).join(" ")}return this._usage=e,this}name(e){return e===void 0?this._name:(this._name=e,this)}helpGroup(e){return e===void 0?this._helpGroupHeading??"":(this._helpGroupHeading=e,this)}commandsGroup(e){return e===void 0?this._defaultCommandGroup??"":(this._defaultCommandGroup=e,this)}optionsGroup(e){return e===void 0?this._defaultOptionGroup??"":(this._defaultOptionGroup=e,this)}_initOptionGroup(e){this._defaultOptionGroup&&!e.helpGroupHeading&&e.helpGroup(this._defaultOptionGroup)}_initCommandGroup(e){this._defaultCommandGroup&&!e.helpGroup()&&e.helpGroup(this._defaultCommandGroup)}nameFromFilename(e){return this._name=fo.basename(e,fo.extname(e)),this}executableDir(e){return e===void 0?this._executableDir:(this._executableDir=e,this)}helpInformation(e){let r=this.createHelp(),n=this._getOutputContext(e);r.prepareContext({error:n.error,helpWidth:n.helpWidth,outputHasColors:n.hasColors});let i=r.formatHelp(this,r);return n.hasColors?i:this._outputConfiguration.stripColor(i)}_getOutputContext(e){e=e||{};let r=!!e.error,n,i,o;return r?(n=a=>this._outputConfiguration.writeErr(a),i=this._outputConfiguration.getErrHasColors(),o=this._outputConfiguration.getErrHelpWidth()):(n=a=>this._outputConfiguration.writeOut(a),i=this._outputConfiguration.getOutHasColors(),o=this._outputConfiguration.getOutHelpWidth()),{error:r,write:a=>(i||(a=this._outputConfiguration.stripColor(a)),n(a)),hasColors:i,helpWidth:o}}outputHelp(e){let r;typeof e=="function"&&(r=e,e=void 0);let n=this._getOutputContext(e),i={error:n.error,write:n.write,command:this};this._getCommandAndAncestors().reverse().forEach(s=>s.emit("beforeAllHelp",i)),this.emit("beforeHelp",i);let o=this.helpInformation({error:n.error});if(r&&(o=r(o),typeof o!="string"&&!Buffer.isBuffer(o)))throw new Error("outputHelp callback must return a string or a Buffer");n.write(o),this._getHelpOption()?.long&&this.emit(this._getHelpOption().long),this.emit("afterHelp",i),this._getCommandAndAncestors().forEach(s=>s.emit("afterAllHelp",i))}helpOption(e,r){return typeof e=="boolean"?(e?(this._helpOption===null&&(this._helpOption=void 0),this._defaultOptionGroup&&this._initOptionGroup(this._getHelpOption())):this._helpOption=null,this):(this._helpOption=this.createOption(e??"-h, --help",r??"display help for command"),(e||r)&&this._initOptionGroup(this._helpOption),this)}_getHelpOption(){return this._helpOption===void 0&&this.helpOption(void 0,void 0),this._helpOption}addHelpOption(e){return this._helpOption=e,this._initOptionGroup(e),this}help(e){this.outputHelp(e);let r=Number(Be.exitCode??0);r===0&&e&&typeof e!="function"&&e.error&&(r=1),this._exit(r,"commander.help","(outputHelp)")}addHelpText(e,r){let n=["beforeAll","before","after","afterAll"];if(!n.includes(e))throw new Error(`Unexpected value for position to addHelpText. Expecting one of '${n.join("', '")}'`);let i=`${e}Help`;return this.on(i,o=>{let s;typeof r=="function"?s=r({error:o.error,command:o.command}):s=r,s&&o.write(`${s} -`)}),this}_outputHelpIfRequested(e){let r=this._getHelpOption();r&&e.find(i=>r.is(i))&&(this.outputHelp(),this._exit(0,"commander.helpDisplayed","(outputHelp)"))}};function g4(t){return t.map(e=>{if(!e.startsWith("--inspect"))return e;let r,n="127.0.0.1",i="9229",o;return(o=e.match(/^(--inspect(-brk)?)$/))!==null?r=o[1]:(o=e.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))!==null?(r=o[1],/^\d+$/.test(o[3])?i=o[3]:n=o[3]):(o=e.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null&&(r=o[1],n=o[3],i=o[4]),r&&i!=="0"?`${r}=${n}:${parseInt(i)+1}`:e})}function UA(){if(Be.env.NO_COLOR||Be.env.FORCE_COLOR==="0"||Be.env.FORCE_COLOR==="false")return!1;if(Be.env.FORCE_COLOR||Be.env.CLICOLOR_FORCE!==void 0)return!0}qA.Command=zA;qA.useColor=UA});var S4=v(kn=>{var{Argument:_4}=vy(),{Command:BA}=y4(),{CommanderError:nfe,InvalidArgumentError:b4}=nf(),{Help:ife}=CA(),{Option:v4}=MA();kn.program=new BA;kn.createCommand=t=>new BA(t);kn.createOption=(t,e)=>new v4(t,e);kn.createArgument=(t,e)=>new _4(t,e);kn.Command=BA;kn.Option=v4;kn.Argument=_4;kn.Help=ife;kn.CommanderError=nfe;kn.InvalidArgumentError=b4;kn.InvalidOptionArgumentError=b4});var De=v(Qt=>{"use strict";var GA=Symbol.for("yaml.alias"),k4=Symbol.for("yaml.document"),wy=Symbol.for("yaml.map"),E4=Symbol.for("yaml.pair"),ZA=Symbol.for("yaml.scalar"),xy=Symbol.for("yaml.seq"),po=Symbol.for("yaml.node.type"),ufe=t=>!!t&&typeof t=="object"&&t[po]===GA,dfe=t=>!!t&&typeof t=="object"&&t[po]===k4,ffe=t=>!!t&&typeof t=="object"&&t[po]===wy,pfe=t=>!!t&&typeof t=="object"&&t[po]===E4,A4=t=>!!t&&typeof t=="object"&&t[po]===ZA,mfe=t=>!!t&&typeof t=="object"&&t[po]===xy;function T4(t){if(t&&typeof t=="object")switch(t[po]){case wy:case xy:return!0}return!1}function hfe(t){if(t&&typeof t=="object")switch(t[po]){case GA:case wy:case ZA:case xy:return!0}return!1}var gfe=t=>(A4(t)||T4(t))&&!!t.anchor;Qt.ALIAS=GA;Qt.DOC=k4;Qt.MAP=wy;Qt.NODE_TYPE=po;Qt.PAIR=E4;Qt.SCALAR=ZA;Qt.SEQ=xy;Qt.hasAnchor=gfe;Qt.isAlias=ufe;Qt.isCollection=T4;Qt.isDocument=dfe;Qt.isMap=ffe;Qt.isNode=hfe;Qt.isPair=pfe;Qt.isScalar=A4;Qt.isSeq=mfe});var of=v(VA=>{"use strict";var Ut=De(),Cr=Symbol("break visit"),O4=Symbol("skip children"),Ai=Symbol("remove node");function $y(t,e){let r=R4(e);Ut.isDocument(t)?Qc(null,t.contents,r,Object.freeze([t]))===Ai&&(t.contents=null):Qc(null,t,r,Object.freeze([]))}$y.BREAK=Cr;$y.SKIP=O4;$y.REMOVE=Ai;function Qc(t,e,r,n){let i=I4(t,e,r,n);if(Ut.isNode(i)||Ut.isPair(i))return P4(t,n,i),Qc(t,i,r,n);if(typeof i!="symbol"){if(Ut.isCollection(e)){n=Object.freeze(n.concat(e));for(let o=0;o{"use strict";var C4=De(),yfe=of(),_fe={"!":"%21",",":"%2C","[":"%5B","]":"%5D","{":"%7B","}":"%7D"},bfe=t=>t.replace(/[!,[\]{}]/g,e=>_fe[e]),sf=class t{constructor(e,r){this.docStart=null,this.docEnd=!1,this.yaml=Object.assign({},t.defaultYaml,e),this.tags=Object.assign({},t.defaultTags,r)}clone(){let e=new t(this.yaml,this.tags);return e.docStart=this.docStart,e}atDocument(){let e=new t(this.yaml,this.tags);switch(this.yaml.version){case"1.1":this.atNextDocument=!0;break;case"1.2":this.atNextDocument=!1,this.yaml={explicit:t.defaultYaml.explicit,version:"1.2"},this.tags=Object.assign({},t.defaultTags);break}return e}add(e,r){this.atNextDocument&&(this.yaml={explicit:t.defaultYaml.explicit,version:"1.1"},this.tags=Object.assign({},t.defaultTags),this.atNextDocument=!1);let n=e.trim().split(/[ \t]+/),i=n.shift();switch(i){case"%TAG":{if(n.length!==2&&(r(0,"%TAG directive should contain exactly two parts"),n.length<2))return!1;let[o,s]=n;return this.tags[o]=s,!0}case"%YAML":{if(this.yaml.explicit=!0,n.length!==1)return r(0,"%YAML directive should contain exactly one part"),!1;let[o]=n;if(o==="1.1"||o==="1.2")return this.yaml.version=o,!0;{let s=/^\d+\.\d+$/.test(o);return r(6,`Unsupported YAML version ${o}`,s),!1}}default:return r(0,`Unknown directive ${i}`,!0),!1}}tagName(e,r){if(e==="!")return"!";if(e[0]!=="!")return r(`Not a valid tag: ${e}`),null;if(e[1]==="<"){let s=e.slice(2,-1);return s==="!"||s==="!!"?(r(`Verbatim tags aren't resolved, so ${e} is invalid.`),null):(e[e.length-1]!==">"&&r("Verbatim tags must end with a >"),s)}let[,n,i]=e.match(/^(.*!)([^!]*)$/s);i||r(`The ${e} tag has no suffix`);let o=this.tags[n];if(o)try{return o+decodeURIComponent(i)}catch(s){return r(String(s)),null}return n==="!"?e:(r(`Could not resolve tag: ${e}`),null)}tagString(e){for(let[r,n]of Object.entries(this.tags))if(e.startsWith(n))return r+bfe(e.substring(n.length));return e[0]==="!"?e:`!<${e}>`}toString(e){let r=this.yaml.explicit?[`%YAML ${this.yaml.version||"1.2"}`]:[],n=Object.entries(this.tags),i;if(e&&n.length>0&&C4.isNode(e.contents)){let o={};yfe.visit(e.contents,(s,a)=>{C4.isNode(a)&&a.tag&&(o[a.tag]=!0)}),i=Object.keys(o)}else i=[];for(let[o,s]of n)o==="!!"&&s==="tag:yaml.org,2002:"||(!e||i.some(a=>a.startsWith(s)))&&r.push(`%TAG ${o} ${s}`);return r.join(` -`)}};sf.defaultYaml={explicit:!1,version:"1.2"};sf.defaultTags={"!!":"tag:yaml.org,2002:"};D4.Directives=sf});var Ey=v(af=>{"use strict";var N4=De(),vfe=of();function Sfe(t){if(/[\x00-\x19\s,[\]{}]/.test(t)){let r=`Anchor must not contain whitespace or control characters: ${JSON.stringify(t)}`;throw new Error(r)}return!0}function j4(t){let e=new Set;return vfe.visit(t,{Value(r,n){n.anchor&&e.add(n.anchor)}}),e}function M4(t,e){for(let r=1;;++r){let n=`${t}${r}`;if(!e.has(n))return n}}function wfe(t,e){let r=[],n=new Map,i=null;return{onAnchor:o=>{r.push(o),i??(i=j4(t));let s=M4(e,i);return i.add(s),s},setAnchors:()=>{for(let o of r){let s=n.get(o);if(typeof s=="object"&&s.anchor&&(N4.isScalar(s.node)||N4.isCollection(s.node)))s.node.anchor=s.anchor;else{let a=new Error("Failed to resolve repeated object (this should not happen)");throw a.source=o,a}}},sourceObjects:n}}af.anchorIsValid=Sfe;af.anchorNames=j4;af.createNodeAnchors=wfe;af.findNewAnchor=M4});var KA=v(F4=>{"use strict";function cf(t,e,r,n){if(n&&typeof n=="object")if(Array.isArray(n))for(let i=0,o=n.length;i{"use strict";var xfe=De();function L4(t,e,r){if(Array.isArray(t))return t.map((n,i)=>L4(n,String(i),r));if(t&&typeof t.toJSON=="function"){if(!r||!xfe.hasAnchor(t))return t.toJSON(e,r);let n={aliasCount:0,count:1,res:void 0};r.anchors.set(t,n),r.onCreate=o=>{n.res=o,delete r.onCreate};let i=t.toJSON(e,r);return r.onCreate&&r.onCreate(i),i}return typeof t=="bigint"&&!r?.keep?Number(t):t}z4.toJS=L4});var Ay=v(q4=>{"use strict";var $fe=KA(),U4=De(),kfe=Zo(),JA=class{constructor(e){Object.defineProperty(this,U4.NODE_TYPE,{value:e})}clone(){let e=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return this.range&&(e.range=this.range.slice()),e}toJS(e,{mapAsMap:r,maxAliasCount:n,onAnchor:i,reviver:o}={}){if(!U4.isDocument(e))throw new TypeError("A document argument is required");let s={anchors:new Map,doc:e,keep:!0,mapAsMap:r===!0,mapKeyWarned:!1,maxAliasCount:typeof n=="number"?n:100},a=kfe.toJS(this,"",s);if(typeof i=="function")for(let{count:c,res:l}of s.anchors.values())i(l,c);return typeof o=="function"?$fe.applyReviver(o,{"":a},"",a):a}};q4.NodeBase=JA});var lf=v(B4=>{"use strict";var Efe=Ey(),Afe=of(),tl=De(),Tfe=Ay(),Ofe=Zo(),YA=class extends Tfe.NodeBase{constructor(e){super(tl.ALIAS),this.source=e,Object.defineProperty(this,"tag",{set(){throw new Error("Alias nodes cannot have tags")}})}resolve(e,r){if(r?.maxAliasCount===0)throw new ReferenceError("Alias resolution is disabled");let n;r?.aliasResolveCache?n=r.aliasResolveCache:(n=[],Afe.visit(e,{Node:(o,s)=>{(tl.isAlias(s)||tl.hasAnchor(s))&&n.push(s)}}),r&&(r.aliasResolveCache=n));let i;for(let o of n){if(o===this)break;o.anchor===this.source&&(i=o)}return i}toJSON(e,r){if(!r)return{source:this.source};let{anchors:n,doc:i,maxAliasCount:o}=r,s=this.resolve(i,r);if(!s){let c=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new ReferenceError(c)}let a=n.get(s);if(a||(Ofe.toJS(s,null,r),a=n.get(s)),a?.res===void 0){let c="This should not happen: Alias anchor was not resolved?";throw new ReferenceError(c)}if(o>=0&&(a.count+=1,a.aliasCount===0&&(a.aliasCount=Ty(i,s,n)),a.count*a.aliasCount>o)){let c="Excessive alias count indicates a resource exhaustion attack";throw new ReferenceError(c)}return a.res}toString(e,r,n){let i=`*${this.source}`;if(e){if(Efe.anchorIsValid(this.source),e.options.verifyAliasOrder&&!e.anchors.has(this.source)){let o=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new Error(o)}if(e.implicitKey)return`${i} `}return i}};function Ty(t,e,r){if(tl.isAlias(e)){let n=e.resolve(t),i=r&&n&&r.get(n);return i?i.count*i.aliasCount:0}else if(tl.isCollection(e)){let n=0;for(let i of e.items){let o=Ty(t,i,r);o>n&&(n=o)}return n}else if(tl.isPair(e)){let n=Ty(t,e.key,r),i=Ty(t,e.value,r);return Math.max(n,i)}return 1}B4.Alias=YA});var Dt=v(XA=>{"use strict";var Rfe=De(),Ife=Ay(),Pfe=Zo(),Cfe=t=>!t||typeof t!="function"&&typeof t!="object",Vo=class extends Ife.NodeBase{constructor(e){super(Rfe.SCALAR),this.value=e}toJSON(e,r){return r?.keep?this.value:Pfe.toJS(this.value,e,r)}toString(){return String(this.value)}};Vo.BLOCK_FOLDED="BLOCK_FOLDED";Vo.BLOCK_LITERAL="BLOCK_LITERAL";Vo.PLAIN="PLAIN";Vo.QUOTE_DOUBLE="QUOTE_DOUBLE";Vo.QUOTE_SINGLE="QUOTE_SINGLE";XA.Scalar=Vo;XA.isScalarValue=Cfe});var uf=v(G4=>{"use strict";var Dfe=lf(),da=De(),H4=Dt(),Nfe="tag:yaml.org,2002:";function jfe(t,e,r){if(e){let n=r.filter(o=>o.tag===e),i=n.find(o=>!o.format)??n[0];if(!i)throw new Error(`Tag ${e} not found`);return i}return r.find(n=>n.identify?.(t)&&!n.format)}function Mfe(t,e,r){if(da.isDocument(t)&&(t=t.contents),da.isNode(t))return t;if(da.isPair(t)){let d=r.schema[da.MAP].createNode?.(r.schema,null,r);return d.items.push(t),d}(t instanceof String||t instanceof Number||t instanceof Boolean||typeof BigInt<"u"&&t instanceof BigInt)&&(t=t.valueOf());let{aliasDuplicateObjects:n,onAnchor:i,onTagObj:o,schema:s,sourceObjects:a}=r,c;if(n&&t&&typeof t=="object"){if(c=a.get(t),c)return c.anchor??(c.anchor=i(t)),new Dfe.Alias(c.anchor);c={anchor:null,node:null},a.set(t,c)}e?.startsWith("!!")&&(e=Nfe+e.slice(2));let l=jfe(t,e,s.tags);if(!l){if(t&&typeof t.toJSON=="function"&&(t=t.toJSON()),!t||typeof t!="object"){let d=new H4.Scalar(t);return c&&(c.node=d),d}l=t instanceof Map?s[da.MAP]:Symbol.iterator in Object(t)?s[da.SEQ]:s[da.MAP]}o&&(o(l),delete r.onTagObj);let u=l?.createNode?l.createNode(r.schema,t,r):typeof l?.nodeClass?.from=="function"?l.nodeClass.from(r.schema,t,r):new H4.Scalar(t);return e?u.tag=e:l.default||(u.tag=l.tag),c&&(c.node=u),u}G4.createNode=Mfe});var Ry=v(Oy=>{"use strict";var Ffe=uf(),Ti=De(),Lfe=Ay();function QA(t,e,r){let n=r;for(let i=e.length-1;i>=0;--i){let o=e[i];if(typeof o=="number"&&Number.isInteger(o)&&o>=0){let s=[];s[o]=n,n=s}else n=new Map([[o,n]])}return Ffe.createNode(n,void 0,{aliasDuplicateObjects:!1,keepUndefined:!1,onAnchor:()=>{throw new Error("This should not happen, please report a bug.")},schema:t,sourceObjects:new Map})}var Z4=t=>t==null||typeof t=="object"&&!!t[Symbol.iterator]().next().done,eT=class extends Lfe.NodeBase{constructor(e,r){super(e),Object.defineProperty(this,"schema",{value:r,configurable:!0,enumerable:!1,writable:!0})}clone(e){let r=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return e&&(r.schema=e),r.items=r.items.map(n=>Ti.isNode(n)||Ti.isPair(n)?n.clone(e):n),this.range&&(r.range=this.range.slice()),r}addIn(e,r){if(Z4(e))this.add(r);else{let[n,...i]=e,o=this.get(n,!0);if(Ti.isCollection(o))o.addIn(i,r);else if(o===void 0&&this.schema)this.set(n,QA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}deleteIn(e){let[r,...n]=e;if(n.length===0)return this.delete(r);let i=this.get(r,!0);if(Ti.isCollection(i))return i.deleteIn(n);throw new Error(`Expected YAML collection at ${r}. Remaining path: ${n}`)}getIn(e,r){let[n,...i]=e,o=this.get(n,!0);return i.length===0?!r&&Ti.isScalar(o)?o.value:o:Ti.isCollection(o)?o.getIn(i,r):void 0}hasAllNullValues(e){return this.items.every(r=>{if(!Ti.isPair(r))return!1;let n=r.value;return n==null||e&&Ti.isScalar(n)&&n.value==null&&!n.commentBefore&&!n.comment&&!n.tag})}hasIn(e){let[r,...n]=e;if(n.length===0)return this.has(r);let i=this.get(r,!0);return Ti.isCollection(i)?i.hasIn(n):!1}setIn(e,r){let[n,...i]=e;if(i.length===0)this.set(n,r);else{let o=this.get(n,!0);if(Ti.isCollection(o))o.setIn(i,r);else if(o===void 0&&this.schema)this.set(n,QA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}};Oy.Collection=eT;Oy.collectionFromPath=QA;Oy.isEmptyPath=Z4});var df=v(Iy=>{"use strict";var zfe=t=>t.replace(/^(?!$)(?: $)?/gm,"#");function tT(t,e){return/^\n+$/.test(t)?t.substring(1):e?t.replace(/^(?! *$)/gm,e):t}var Ufe=(t,e,r)=>t.endsWith(` +`)}),this}_outputHelpIfRequested(e){let r=this._getHelpOption();r&&e.find(i=>r.is(i))&&(this.outputHelp(),this._exit(0,"commander.helpDisplayed","(outputHelp)"))}};function y4(t){return t.map(e=>{if(!e.startsWith("--inspect"))return e;let r,n="127.0.0.1",i="9229",o;return(o=e.match(/^(--inspect(-brk)?)$/))!==null?r=o[1]:(o=e.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))!==null?(r=o[1],/^\d+$/.test(o[3])?i=o[3]:n=o[3]):(o=e.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null&&(r=o[1],n=o[3],i=o[4]),r&&i!=="0"?`${r}=${n}:${parseInt(i)+1}`:e})}function UA(){if(Be.env.NO_COLOR||Be.env.FORCE_COLOR==="0"||Be.env.FORCE_COLOR==="false")return!1;if(Be.env.FORCE_COLOR||Be.env.CLICOLOR_FORCE!==void 0)return!0}qA.Command=zA;qA.useColor=UA});var w4=v(An=>{var{Argument:b4}=vy(),{Command:BA}=_4(),{CommanderError:sfe,InvalidArgumentError:v4}=of(),{Help:afe}=CA(),{Option:S4}=MA();An.program=new BA;An.createCommand=t=>new BA(t);An.createOption=(t,e)=>new S4(t,e);An.createArgument=(t,e)=>new b4(t,e);An.Command=BA;An.Option=S4;An.Argument=b4;An.Help=afe;An.CommanderError=sfe;An.InvalidArgumentError=v4;An.InvalidOptionArgumentError=v4});var De=v(Qt=>{"use strict";var GA=Symbol.for("yaml.alias"),E4=Symbol.for("yaml.document"),wy=Symbol.for("yaml.map"),A4=Symbol.for("yaml.pair"),ZA=Symbol.for("yaml.scalar"),xy=Symbol.for("yaml.seq"),po=Symbol.for("yaml.node.type"),pfe=t=>!!t&&typeof t=="object"&&t[po]===GA,mfe=t=>!!t&&typeof t=="object"&&t[po]===E4,hfe=t=>!!t&&typeof t=="object"&&t[po]===wy,gfe=t=>!!t&&typeof t=="object"&&t[po]===A4,T4=t=>!!t&&typeof t=="object"&&t[po]===ZA,yfe=t=>!!t&&typeof t=="object"&&t[po]===xy;function O4(t){if(t&&typeof t=="object")switch(t[po]){case wy:case xy:return!0}return!1}function _fe(t){if(t&&typeof t=="object")switch(t[po]){case GA:case wy:case ZA:case xy:return!0}return!1}var bfe=t=>(T4(t)||O4(t))&&!!t.anchor;Qt.ALIAS=GA;Qt.DOC=E4;Qt.MAP=wy;Qt.NODE_TYPE=po;Qt.PAIR=A4;Qt.SCALAR=ZA;Qt.SEQ=xy;Qt.hasAnchor=bfe;Qt.isAlias=pfe;Qt.isCollection=O4;Qt.isDocument=mfe;Qt.isMap=hfe;Qt.isNode=_fe;Qt.isPair=gfe;Qt.isScalar=T4;Qt.isSeq=yfe});var sf=v(VA=>{"use strict";var Ut=De(),Dr=Symbol("break visit"),R4=Symbol("skip children"),Ai=Symbol("remove node");function $y(t,e){let r=I4(e);Ut.isDocument(t)?Qc(null,t.contents,r,Object.freeze([t]))===Ai&&(t.contents=null):Qc(null,t,r,Object.freeze([]))}$y.BREAK=Dr;$y.SKIP=R4;$y.REMOVE=Ai;function Qc(t,e,r,n){let i=P4(t,e,r,n);if(Ut.isNode(i)||Ut.isPair(i))return C4(t,n,i),Qc(t,i,r,n);if(typeof i!="symbol"){if(Ut.isCollection(e)){n=Object.freeze(n.concat(e));for(let o=0;o{"use strict";var D4=De(),vfe=sf(),Sfe={"!":"%21",",":"%2C","[":"%5B","]":"%5D","{":"%7B","}":"%7D"},wfe=t=>t.replace(/[!,[\]{}]/g,e=>Sfe[e]),af=class t{constructor(e,r){this.docStart=null,this.docEnd=!1,this.yaml=Object.assign({},t.defaultYaml,e),this.tags=Object.assign({},t.defaultTags,r)}clone(){let e=new t(this.yaml,this.tags);return e.docStart=this.docStart,e}atDocument(){let e=new t(this.yaml,this.tags);switch(this.yaml.version){case"1.1":this.atNextDocument=!0;break;case"1.2":this.atNextDocument=!1,this.yaml={explicit:t.defaultYaml.explicit,version:"1.2"},this.tags=Object.assign({},t.defaultTags);break}return e}add(e,r){this.atNextDocument&&(this.yaml={explicit:t.defaultYaml.explicit,version:"1.1"},this.tags=Object.assign({},t.defaultTags),this.atNextDocument=!1);let n=e.trim().split(/[ \t]+/),i=n.shift();switch(i){case"%TAG":{if(n.length!==2&&(r(0,"%TAG directive should contain exactly two parts"),n.length<2))return!1;let[o,s]=n;return this.tags[o]=s,!0}case"%YAML":{if(this.yaml.explicit=!0,n.length!==1)return r(0,"%YAML directive should contain exactly one part"),!1;let[o]=n;if(o==="1.1"||o==="1.2")return this.yaml.version=o,!0;{let s=/^\d+\.\d+$/.test(o);return r(6,`Unsupported YAML version ${o}`,s),!1}}default:return r(0,`Unknown directive ${i}`,!0),!1}}tagName(e,r){if(e==="!")return"!";if(e[0]!=="!")return r(`Not a valid tag: ${e}`),null;if(e[1]==="<"){let s=e.slice(2,-1);return s==="!"||s==="!!"?(r(`Verbatim tags aren't resolved, so ${e} is invalid.`),null):(e[e.length-1]!==">"&&r("Verbatim tags must end with a >"),s)}let[,n,i]=e.match(/^(.*!)([^!]*)$/s);i||r(`The ${e} tag has no suffix`);let o=this.tags[n];if(o)try{return o+decodeURIComponent(i)}catch(s){return r(String(s)),null}return n==="!"?e:(r(`Could not resolve tag: ${e}`),null)}tagString(e){for(let[r,n]of Object.entries(this.tags))if(e.startsWith(n))return r+wfe(e.substring(n.length));return e[0]==="!"?e:`!<${e}>`}toString(e){let r=this.yaml.explicit?[`%YAML ${this.yaml.version||"1.2"}`]:[],n=Object.entries(this.tags),i;if(e&&n.length>0&&D4.isNode(e.contents)){let o={};vfe.visit(e.contents,(s,a)=>{D4.isNode(a)&&a.tag&&(o[a.tag]=!0)}),i=Object.keys(o)}else i=[];for(let[o,s]of n)o==="!!"&&s==="tag:yaml.org,2002:"||(!e||i.some(a=>a.startsWith(s)))&&r.push(`%TAG ${o} ${s}`);return r.join(` +`)}};af.defaultYaml={explicit:!1,version:"1.2"};af.defaultTags={"!!":"tag:yaml.org,2002:"};N4.Directives=af});var Ey=v(cf=>{"use strict";var j4=De(),xfe=sf();function $fe(t){if(/[\x00-\x19\s,[\]{}]/.test(t)){let r=`Anchor must not contain whitespace or control characters: ${JSON.stringify(t)}`;throw new Error(r)}return!0}function M4(t){let e=new Set;return xfe.visit(t,{Value(r,n){n.anchor&&e.add(n.anchor)}}),e}function F4(t,e){for(let r=1;;++r){let n=`${t}${r}`;if(!e.has(n))return n}}function kfe(t,e){let r=[],n=new Map,i=null;return{onAnchor:o=>{r.push(o),i??(i=M4(t));let s=F4(e,i);return i.add(s),s},setAnchors:()=>{for(let o of r){let s=n.get(o);if(typeof s=="object"&&s.anchor&&(j4.isScalar(s.node)||j4.isCollection(s.node)))s.node.anchor=s.anchor;else{let a=new Error("Failed to resolve repeated object (this should not happen)");throw a.source=o,a}}},sourceObjects:n}}cf.anchorIsValid=$fe;cf.anchorNames=M4;cf.createNodeAnchors=kfe;cf.findNewAnchor=F4});var KA=v(L4=>{"use strict";function lf(t,e,r,n){if(n&&typeof n=="object")if(Array.isArray(n))for(let i=0,o=n.length;i{"use strict";var Efe=De();function z4(t,e,r){if(Array.isArray(t))return t.map((n,i)=>z4(n,String(i),r));if(t&&typeof t.toJSON=="function"){if(!r||!Efe.hasAnchor(t))return t.toJSON(e,r);let n={aliasCount:0,count:1,res:void 0};r.anchors.set(t,n),r.onCreate=o=>{n.res=o,delete r.onCreate};let i=t.toJSON(e,r);return r.onCreate&&r.onCreate(i),i}return typeof t=="bigint"&&!r?.keep?Number(t):t}U4.toJS=z4});var Ay=v(B4=>{"use strict";var Afe=KA(),q4=De(),Tfe=Zo(),JA=class{constructor(e){Object.defineProperty(this,q4.NODE_TYPE,{value:e})}clone(){let e=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return this.range&&(e.range=this.range.slice()),e}toJS(e,{mapAsMap:r,maxAliasCount:n,onAnchor:i,reviver:o}={}){if(!q4.isDocument(e))throw new TypeError("A document argument is required");let s={anchors:new Map,doc:e,keep:!0,mapAsMap:r===!0,mapKeyWarned:!1,maxAliasCount:typeof n=="number"?n:100},a=Tfe.toJS(this,"",s);if(typeof i=="function")for(let{count:c,res:l}of s.anchors.values())i(l,c);return typeof o=="function"?Afe.applyReviver(o,{"":a},"",a):a}};B4.NodeBase=JA});var uf=v(H4=>{"use strict";var Ofe=Ey(),Rfe=sf(),tl=De(),Ife=Ay(),Pfe=Zo(),YA=class extends Ife.NodeBase{constructor(e){super(tl.ALIAS),this.source=e,Object.defineProperty(this,"tag",{set(){throw new Error("Alias nodes cannot have tags")}})}resolve(e,r){if(r?.maxAliasCount===0)throw new ReferenceError("Alias resolution is disabled");let n;r?.aliasResolveCache?n=r.aliasResolveCache:(n=[],Rfe.visit(e,{Node:(o,s)=>{(tl.isAlias(s)||tl.hasAnchor(s))&&n.push(s)}}),r&&(r.aliasResolveCache=n));let i;for(let o of n){if(o===this)break;o.anchor===this.source&&(i=o)}return i}toJSON(e,r){if(!r)return{source:this.source};let{anchors:n,doc:i,maxAliasCount:o}=r,s=this.resolve(i,r);if(!s){let c=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new ReferenceError(c)}let a=n.get(s);if(a||(Pfe.toJS(s,null,r),a=n.get(s)),a?.res===void 0){let c="This should not happen: Alias anchor was not resolved?";throw new ReferenceError(c)}if(o>=0&&(a.count+=1,a.aliasCount===0&&(a.aliasCount=Ty(i,s,n)),a.count*a.aliasCount>o)){let c="Excessive alias count indicates a resource exhaustion attack";throw new ReferenceError(c)}return a.res}toString(e,r,n){let i=`*${this.source}`;if(e){if(Ofe.anchorIsValid(this.source),e.options.verifyAliasOrder&&!e.anchors.has(this.source)){let o=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new Error(o)}if(e.implicitKey)return`${i} `}return i}};function Ty(t,e,r){if(tl.isAlias(e)){let n=e.resolve(t),i=r&&n&&r.get(n);return i?i.count*i.aliasCount:0}else if(tl.isCollection(e)){let n=0;for(let i of e.items){let o=Ty(t,i,r);o>n&&(n=o)}return n}else if(tl.isPair(e)){let n=Ty(t,e.key,r),i=Ty(t,e.value,r);return Math.max(n,i)}return 1}H4.Alias=YA});var Dt=v(XA=>{"use strict";var Cfe=De(),Dfe=Ay(),Nfe=Zo(),jfe=t=>!t||typeof t!="function"&&typeof t!="object",Vo=class extends Dfe.NodeBase{constructor(e){super(Cfe.SCALAR),this.value=e}toJSON(e,r){return r?.keep?this.value:Nfe.toJS(this.value,e,r)}toString(){return String(this.value)}};Vo.BLOCK_FOLDED="BLOCK_FOLDED";Vo.BLOCK_LITERAL="BLOCK_LITERAL";Vo.PLAIN="PLAIN";Vo.QUOTE_DOUBLE="QUOTE_DOUBLE";Vo.QUOTE_SINGLE="QUOTE_SINGLE";XA.Scalar=Vo;XA.isScalarValue=jfe});var df=v(Z4=>{"use strict";var Mfe=uf(),da=De(),G4=Dt(),Ffe="tag:yaml.org,2002:";function Lfe(t,e,r){if(e){let n=r.filter(o=>o.tag===e),i=n.find(o=>!o.format)??n[0];if(!i)throw new Error(`Tag ${e} not found`);return i}return r.find(n=>n.identify?.(t)&&!n.format)}function zfe(t,e,r){if(da.isDocument(t)&&(t=t.contents),da.isNode(t))return t;if(da.isPair(t)){let d=r.schema[da.MAP].createNode?.(r.schema,null,r);return d.items.push(t),d}(t instanceof String||t instanceof Number||t instanceof Boolean||typeof BigInt<"u"&&t instanceof BigInt)&&(t=t.valueOf());let{aliasDuplicateObjects:n,onAnchor:i,onTagObj:o,schema:s,sourceObjects:a}=r,c;if(n&&t&&typeof t=="object"){if(c=a.get(t),c)return c.anchor??(c.anchor=i(t)),new Mfe.Alias(c.anchor);c={anchor:null,node:null},a.set(t,c)}e?.startsWith("!!")&&(e=Ffe+e.slice(2));let l=Lfe(t,e,s.tags);if(!l){if(t&&typeof t.toJSON=="function"&&(t=t.toJSON()),!t||typeof t!="object"){let d=new G4.Scalar(t);return c&&(c.node=d),d}l=t instanceof Map?s[da.MAP]:Symbol.iterator in Object(t)?s[da.SEQ]:s[da.MAP]}o&&(o(l),delete r.onTagObj);let u=l?.createNode?l.createNode(r.schema,t,r):typeof l?.nodeClass?.from=="function"?l.nodeClass.from(r.schema,t,r):new G4.Scalar(t);return e?u.tag=e:l.default||(u.tag=l.tag),c&&(c.node=u),u}Z4.createNode=zfe});var Ry=v(Oy=>{"use strict";var Ufe=df(),Ti=De(),qfe=Ay();function QA(t,e,r){let n=r;for(let i=e.length-1;i>=0;--i){let o=e[i];if(typeof o=="number"&&Number.isInteger(o)&&o>=0){let s=[];s[o]=n,n=s}else n=new Map([[o,n]])}return Ufe.createNode(n,void 0,{aliasDuplicateObjects:!1,keepUndefined:!1,onAnchor:()=>{throw new Error("This should not happen, please report a bug.")},schema:t,sourceObjects:new Map})}var V4=t=>t==null||typeof t=="object"&&!!t[Symbol.iterator]().next().done,eT=class extends qfe.NodeBase{constructor(e,r){super(e),Object.defineProperty(this,"schema",{value:r,configurable:!0,enumerable:!1,writable:!0})}clone(e){let r=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return e&&(r.schema=e),r.items=r.items.map(n=>Ti.isNode(n)||Ti.isPair(n)?n.clone(e):n),this.range&&(r.range=this.range.slice()),r}addIn(e,r){if(V4(e))this.add(r);else{let[n,...i]=e,o=this.get(n,!0);if(Ti.isCollection(o))o.addIn(i,r);else if(o===void 0&&this.schema)this.set(n,QA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}deleteIn(e){let[r,...n]=e;if(n.length===0)return this.delete(r);let i=this.get(r,!0);if(Ti.isCollection(i))return i.deleteIn(n);throw new Error(`Expected YAML collection at ${r}. Remaining path: ${n}`)}getIn(e,r){let[n,...i]=e,o=this.get(n,!0);return i.length===0?!r&&Ti.isScalar(o)?o.value:o:Ti.isCollection(o)?o.getIn(i,r):void 0}hasAllNullValues(e){return this.items.every(r=>{if(!Ti.isPair(r))return!1;let n=r.value;return n==null||e&&Ti.isScalar(n)&&n.value==null&&!n.commentBefore&&!n.comment&&!n.tag})}hasIn(e){let[r,...n]=e;if(n.length===0)return this.has(r);let i=this.get(r,!0);return Ti.isCollection(i)?i.hasIn(n):!1}setIn(e,r){let[n,...i]=e;if(i.length===0)this.set(n,r);else{let o=this.get(n,!0);if(Ti.isCollection(o))o.setIn(i,r);else if(o===void 0&&this.schema)this.set(n,QA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}};Oy.Collection=eT;Oy.collectionFromPath=QA;Oy.isEmptyPath=V4});var ff=v(Iy=>{"use strict";var Bfe=t=>t.replace(/^(?!$)(?: $)?/gm,"#");function tT(t,e){return/^\n+$/.test(t)?t.substring(1):e?t.replace(/^(?! *$)/gm,e):t}var Hfe=(t,e,r)=>t.endsWith(` `)?tT(r,e):r.includes(` `)?` -`+tT(r,e):(t.endsWith(" ")?"":" ")+r;Iy.indentComment=tT;Iy.lineComment=Ufe;Iy.stringifyComment=zfe});var W4=v(ff=>{"use strict";var qfe="flow",rT="block",Py="quoted";function Bfe(t,e,r="flow",{indentAtStart:n,lineWidth:i=80,minContentWidth:o=20,onFold:s,onOverflow:a}={}){if(!i||i<0)return t;ii-Math.max(2,o)?l.push(0):d=i-n);let f,p,m=!1,h=-1,g=-1,b=-1;r===rT&&(h=V4(t,h,e.length),h!==-1&&(d=h+c));for(let S;S=t[h+=1];){if(r===Py&&S==="\\"){switch(g=h,t[h+1]){case"x":h+=3;break;case"u":h+=5;break;case"U":h+=9;break;default:h+=1}b=h}if(S===` -`)r===rT&&(h=V4(t,h,e.length)),d=h+e.length+c,f=void 0;else{if(S===" "&&p&&p!==" "&&p!==` +`+tT(r,e):(t.endsWith(" ")?"":" ")+r;Iy.indentComment=tT;Iy.lineComment=Hfe;Iy.stringifyComment=Bfe});var K4=v(pf=>{"use strict";var Gfe="flow",rT="block",Py="quoted";function Zfe(t,e,r="flow",{indentAtStart:n,lineWidth:i=80,minContentWidth:o=20,onFold:s,onOverflow:a}={}){if(!i||i<0)return t;ii-Math.max(2,o)?l.push(0):d=i-n);let f,p,m=!1,h=-1,g=-1,b=-1;r===rT&&(h=W4(t,h,e.length),h!==-1&&(d=h+c));for(let S;S=t[h+=1];){if(r===Py&&S==="\\"){switch(g=h,t[h+1]){case"x":h+=3;break;case"u":h+=5;break;case"U":h+=9;break;default:h+=1}b=h}if(S===` +`)r===rT&&(h=W4(t,h,e.length)),d=h+e.length+c,f=void 0;else{if(S===" "&&p&&p!==" "&&p!==` `&&p!==" "){let x=t[h+1];x&&x!==" "&&x!==` `&&x!==" "&&(f=h)}if(h>=d)if(f)l.push(f),d=f+c,f=void 0;else if(r===Py){for(;p===" "||p===" ";)p=S,S=t[h+=1],m=!0;let x=h>b+1?h-2:g-1;if(u[x])return t;l.push(x),u[x]=!0,d=x+c,f=void 0}else m=!0}p=S}if(m&&a&&a(),l.length===0)return t;s&&s();let _=t.slice(0,l[0]);for(let S=0;S{"use strict";var Kn=Dt(),Wo=W4(),Dy=(t,e)=>({indentAtStart:e?t.indent.length:t.indentAtStart,lineWidth:t.options.lineWidth,minContentWidth:t.options.minContentWidth}),Ny=t=>/^(%|---|\.\.\.)/m.test(t);function Hfe(t,e,r){if(!e||e<0)return!1;let n=e-r,i=t.length;if(i<=n)return!1;for(let o=0,s=0;on)return!0;if(s=o+1,i-s<=n)return!1}return!0}function pf(t,e){let r=JSON.stringify(t);if(e.options.doubleQuotedAsJSON)return r;let{implicitKey:n}=e,i=e.options.doubleQuotedMinMultiLineLength,o=e.indent||(Ny(t)?" ":""),s="",a=0;for(let c=0,l=r[c];l;l=r[++c])if(l===" "&&r[c+1]==="\\"&&r[c+2]==="n"&&(s+=r.slice(a,c)+"\\ ",c+=1,a=c,l="\\"),l==="\\")switch(r[c+1]){case"u":{s+=r.slice(a,c);let u=r.substr(c+2,4);switch(u){case"0000":s+="\\0";break;case"0007":s+="\\a";break;case"000b":s+="\\v";break;case"001b":s+="\\e";break;case"0085":s+="\\N";break;case"00a0":s+="\\_";break;case"2028":s+="\\L";break;case"2029":s+="\\P";break;default:u.substr(0,2)==="00"?s+="\\x"+u.substr(2):s+=r.substr(c,6)}c+=5,a=c+1}break;case"n":if(n||r[c+2]==='"'||r.length{"use strict";var Jn=Dt(),Wo=K4(),Dy=(t,e)=>({indentAtStart:e?t.indent.length:t.indentAtStart,lineWidth:t.options.lineWidth,minContentWidth:t.options.minContentWidth}),Ny=t=>/^(%|---|\.\.\.)/m.test(t);function Vfe(t,e,r){if(!e||e<0)return!1;let n=e-r,i=t.length;if(i<=n)return!1;for(let o=0,s=0;on)return!0;if(s=o+1,i-s<=n)return!1}return!0}function mf(t,e){let r=JSON.stringify(t);if(e.options.doubleQuotedAsJSON)return r;let{implicitKey:n}=e,i=e.options.doubleQuotedMinMultiLineLength,o=e.indent||(Ny(t)?" ":""),s="",a=0;for(let c=0,l=r[c];l;l=r[++c])if(l===" "&&r[c+1]==="\\"&&r[c+2]==="n"&&(s+=r.slice(a,c)+"\\ ",c+=1,a=c,l="\\"),l==="\\")switch(r[c+1]){case"u":{s+=r.slice(a,c);let u=r.substr(c+2,4);switch(u){case"0000":s+="\\0";break;case"0007":s+="\\a";break;case"000b":s+="\\v";break;case"001b":s+="\\e";break;case"0085":s+="\\N";break;case"00a0":s+="\\_";break;case"2028":s+="\\L";break;case"2029":s+="\\P";break;default:u.substr(0,2)==="00"?s+="\\x"+u.substr(2):s+=r.substr(c,6)}c+=5,a=c+1}break;case"n":if(n||r[c+2]==='"'||r.length `;let d,f;for(f=r.length;f>0;--f){let w=r[f-1];if(w!==` `&&w!==" "&&w!==" ")break}let p=r.substring(f),m=p.indexOf(` `);m===-1?d="-":r===p||m!==p.length-1?(d="+",o&&o()):d="",p&&(r=r.slice(0,-p.length),p[p.length-1]===` `&&(p=p.slice(0,-1)),p=p.replace(iT,`$&${l}`));let h=!1,g,b=-1;for(g=0;g{O=!0});let A=Wo.foldFlowLines(`${_}${w}${p}`,l,Wo.FOLD_BLOCK,T);if(!O)return`>${x} +$&`).replace(/(?:^|\n)([\t ].*)(?:([\n\t ]*)\n(?![\n\t ]))?/g,"$1$2").replace(/\n+/g,`$&${l}`),O=!1,T=Dy(n,!0);s!=="folded"&&e!==Jn.Scalar.BLOCK_FOLDED&&(T.onOverflow=()=>{O=!0});let A=Wo.foldFlowLines(`${_}${w}${p}`,l,Wo.FOLD_BLOCK,T);if(!O)return`>${x} ${l}${A}`}return r=r.replace(/\n+/g,`$&${l}`),`|${x} -${l}${_}${r}${p}`}function Gfe(t,e,r,n){let{type:i,value:o}=t,{actualString:s,implicitKey:a,indent:c,indentStep:l,inFlow:u}=e;if(a&&o.includes(` +${l}${_}${r}${p}`}function Wfe(t,e,r,n){let{type:i,value:o}=t,{actualString:s,implicitKey:a,indent:c,indentStep:l,inFlow:u}=e;if(a&&o.includes(` `)||u&&/[[\]{},]/.test(o))return rl(o,e);if(/^[\n\t ,[\]{}#&*!|>'"%@`]|^[?-]$|^[?-][ \t]|[\n:][ \t]|[ \t]\n|[\n\t ]#|[\n\t :]$/.test(o))return a||u||!o.includes(` -`)?rl(o,e):Cy(t,e,r,n);if(!a&&!u&&i!==Kn.Scalar.PLAIN&&o.includes(` +`)?rl(o,e):Cy(t,e,r,n);if(!a&&!u&&i!==Jn.Scalar.PLAIN&&o.includes(` `))return Cy(t,e,r,n);if(Ny(o)){if(c==="")return e.forceBlockIndent=!0,Cy(t,e,r,n);if(a&&c===l)return rl(o,e)}let d=o.replace(/\n+/g,`$& -${c}`);if(s){let f=h=>h.default&&h.tag!=="tag:yaml.org,2002:str"&&h.test?.test(d),{compat:p,tags:m}=e.doc.schema;if(m.some(f)||p?.some(f))return rl(o,e)}return a?d:Wo.foldFlowLines(d,c,Wo.FOLD_FLOW,Dy(e,!1))}function Zfe(t,e,r,n){let{implicitKey:i,inFlow:o}=e,s=typeof t.value=="string"?t:Object.assign({},t,{value:String(t.value)}),{type:a}=t;a!==Kn.Scalar.QUOTE_DOUBLE&&/[\x00-\x08\x0b-\x1f\x7f-\x9f\u{D800}-\u{DFFF}]/u.test(s.value)&&(a=Kn.Scalar.QUOTE_DOUBLE);let c=u=>{switch(u){case Kn.Scalar.BLOCK_FOLDED:case Kn.Scalar.BLOCK_LITERAL:return i||o?rl(s.value,e):Cy(s,e,r,n);case Kn.Scalar.QUOTE_DOUBLE:return pf(s.value,e);case Kn.Scalar.QUOTE_SINGLE:return nT(s.value,e);case Kn.Scalar.PLAIN:return Gfe(s,e,r,n);default:return null}},l=c(a);if(l===null){let{defaultKeyType:u,defaultStringType:d}=e.options,f=i&&u||d;if(l=c(f),l===null)throw new Error(`Unsupported default string type ${f}`)}return l}K4.stringifyString=Zfe});var hf=v(oT=>{"use strict";var Vfe=Ey(),Ko=De(),Wfe=df(),Kfe=mf();function Jfe(t,e){let r=Object.assign({blockQuote:!0,commentString:Wfe.stringifyComment,defaultKeyType:null,defaultStringType:"PLAIN",directives:null,doubleQuotedAsJSON:!1,doubleQuotedMinMultiLineLength:40,falseStr:"false",flowCollectionPadding:!0,indentSeq:!0,lineWidth:80,minContentWidth:20,nullStr:"null",simpleKeys:!1,singleQuote:null,trailingComma:!1,trueStr:"true",verifyAliasOrder:!0},t.schema.toStringOptions,e),n;switch(r.collectionStyle){case"block":n=!1;break;case"flow":n=!0;break;default:n=null}return{anchors:new Set,doc:t,flowCollectionPadding:r.flowCollectionPadding?" ":"",indent:"",indentStep:typeof r.indent=="number"?" ".repeat(r.indent):" ",inFlow:n,options:r}}function Yfe(t,e){if(e.tag){let i=t.filter(o=>o.tag===e.tag);if(i.length>0)return i.find(o=>o.format===e.format)??i[0]}let r,n;if(Ko.isScalar(e)){n=e.value;let i=t.filter(o=>o.identify?.(n));if(i.length>1){let o=i.filter(s=>s.test);o.length>0&&(i=o)}r=i.find(o=>o.format===e.format)??i.find(o=>!o.format)}else n=e,r=t.find(i=>i.nodeClass&&n instanceof i.nodeClass);if(!r){let i=n?.constructor?.name??(n===null?"null":typeof n);throw new Error(`Tag not resolved for ${i} value`)}return r}function Xfe(t,e,{anchors:r,doc:n}){if(!n.directives)return"";let i=[],o=(Ko.isScalar(t)||Ko.isCollection(t))&&t.anchor;o&&Vfe.anchorIsValid(o)&&(r.add(o),i.push(`&${o}`));let s=t.tag??(e.default?null:e.tag);return s&&i.push(n.directives.tagString(s)),i.join(" ")}function Qfe(t,e,r,n){if(Ko.isPair(t))return t.toString(e,r,n);if(Ko.isAlias(t)){if(e.doc.directives)return t.toString(e);if(e.resolvedAliases?.has(t))throw new TypeError("Cannot stringify circular structure without alias nodes");e.resolvedAliases?e.resolvedAliases.add(t):e.resolvedAliases=new Set([t]),t=t.resolve(e.doc)}let i,o=Ko.isNode(t)?t:e.doc.createNode(t,{onTagObj:c=>i=c});i??(i=Yfe(e.doc.schema.tags,o));let s=Xfe(o,i,e);s.length>0&&(e.indentAtStart=(e.indentAtStart??0)+s.length+1);let a=typeof i.stringify=="function"?i.stringify(o,e,r,n):Ko.isScalar(o)?Kfe.stringifyString(o,e,r,n):o.toString(e,r,n);return s?Ko.isScalar(o)||a[0]==="{"||a[0]==="["?`${s} ${a}`:`${s} -${e.indent}${a}`:a}oT.createStringifyContext=Jfe;oT.stringify=Qfe});var Q4=v(X4=>{"use strict";var mo=De(),J4=Dt(),Y4=hf(),gf=df();function epe({key:t,value:e},r,n,i){let{allNullValues:o,doc:s,indent:a,indentStep:c,options:{commentString:l,indentSeq:u,simpleKeys:d}}=r,f=mo.isNode(t)&&t.comment||null;if(d){if(f)throw new Error("With simple keys, key nodes cannot have comments");if(mo.isCollection(t)||!mo.isNode(t)&&typeof t=="object"){let T="With simple keys, collection cannot be used as a key value";throw new Error(T)}}let p=!d&&(!t||f&&e==null&&!r.inFlow||mo.isCollection(t)||(mo.isScalar(t)?t.type===J4.Scalar.BLOCK_FOLDED||t.type===J4.Scalar.BLOCK_LITERAL:typeof t=="object"));r=Object.assign({},r,{allNullValues:!1,implicitKey:!p&&(d||!o),indent:a+c});let m=!1,h=!1,g=Y4.stringify(t,r,()=>m=!0,()=>h=!0);if(!p&&!r.inFlow&&g.length>1024){if(d)throw new Error("With simple keys, single line scalar must not span more than 1024 characters");p=!0}if(r.inFlow){if(o||e==null)return m&&n&&n(),g===""?"?":p?`? ${g}`:g}else if(o&&!d||e==null&&p)return g=`? ${g}`,f&&!m?g+=gf.lineComment(g,r.indent,l(f)):h&&i&&i(),g;m&&(f=null),p?(f&&(g+=gf.lineComment(g,r.indent,l(f))),g=`? ${g} -${a}:`):(g=`${g}:`,f&&(g+=gf.lineComment(g,r.indent,l(f))));let b,_,S;mo.isNode(e)?(b=!!e.spaceBefore,_=e.commentBefore,S=e.comment):(b=!1,_=null,S=null,e&&typeof e=="object"&&(e=s.createNode(e))),r.implicitKey=!1,!p&&!f&&mo.isScalar(e)&&(r.indentAtStart=g.length+1),h=!1,!u&&c.length>=2&&!r.inFlow&&!p&&mo.isSeq(e)&&!e.flow&&!e.tag&&!e.anchor&&(r.indent=r.indent.substring(2));let x=!1,w=Y4.stringify(e,r,()=>x=!0,()=>h=!0),O=" ";if(f||b||_){if(O=b?` +${c}`);if(s){let f=h=>h.default&&h.tag!=="tag:yaml.org,2002:str"&&h.test?.test(d),{compat:p,tags:m}=e.doc.schema;if(m.some(f)||p?.some(f))return rl(o,e)}return a?d:Wo.foldFlowLines(d,c,Wo.FOLD_FLOW,Dy(e,!1))}function Kfe(t,e,r,n){let{implicitKey:i,inFlow:o}=e,s=typeof t.value=="string"?t:Object.assign({},t,{value:String(t.value)}),{type:a}=t;a!==Jn.Scalar.QUOTE_DOUBLE&&/[\x00-\x08\x0b-\x1f\x7f-\x9f\u{D800}-\u{DFFF}]/u.test(s.value)&&(a=Jn.Scalar.QUOTE_DOUBLE);let c=u=>{switch(u){case Jn.Scalar.BLOCK_FOLDED:case Jn.Scalar.BLOCK_LITERAL:return i||o?rl(s.value,e):Cy(s,e,r,n);case Jn.Scalar.QUOTE_DOUBLE:return mf(s.value,e);case Jn.Scalar.QUOTE_SINGLE:return nT(s.value,e);case Jn.Scalar.PLAIN:return Wfe(s,e,r,n);default:return null}},l=c(a);if(l===null){let{defaultKeyType:u,defaultStringType:d}=e.options,f=i&&u||d;if(l=c(f),l===null)throw new Error(`Unsupported default string type ${f}`)}return l}J4.stringifyString=Kfe});var gf=v(oT=>{"use strict";var Jfe=Ey(),Ko=De(),Yfe=ff(),Xfe=hf();function Qfe(t,e){let r=Object.assign({blockQuote:!0,commentString:Yfe.stringifyComment,defaultKeyType:null,defaultStringType:"PLAIN",directives:null,doubleQuotedAsJSON:!1,doubleQuotedMinMultiLineLength:40,falseStr:"false",flowCollectionPadding:!0,indentSeq:!0,lineWidth:80,minContentWidth:20,nullStr:"null",simpleKeys:!1,singleQuote:null,trailingComma:!1,trueStr:"true",verifyAliasOrder:!0},t.schema.toStringOptions,e),n;switch(r.collectionStyle){case"block":n=!1;break;case"flow":n=!0;break;default:n=null}return{anchors:new Set,doc:t,flowCollectionPadding:r.flowCollectionPadding?" ":"",indent:"",indentStep:typeof r.indent=="number"?" ".repeat(r.indent):" ",inFlow:n,options:r}}function epe(t,e){if(e.tag){let i=t.filter(o=>o.tag===e.tag);if(i.length>0)return i.find(o=>o.format===e.format)??i[0]}let r,n;if(Ko.isScalar(e)){n=e.value;let i=t.filter(o=>o.identify?.(n));if(i.length>1){let o=i.filter(s=>s.test);o.length>0&&(i=o)}r=i.find(o=>o.format===e.format)??i.find(o=>!o.format)}else n=e,r=t.find(i=>i.nodeClass&&n instanceof i.nodeClass);if(!r){let i=n?.constructor?.name??(n===null?"null":typeof n);throw new Error(`Tag not resolved for ${i} value`)}return r}function tpe(t,e,{anchors:r,doc:n}){if(!n.directives)return"";let i=[],o=(Ko.isScalar(t)||Ko.isCollection(t))&&t.anchor;o&&Jfe.anchorIsValid(o)&&(r.add(o),i.push(`&${o}`));let s=t.tag??(e.default?null:e.tag);return s&&i.push(n.directives.tagString(s)),i.join(" ")}function rpe(t,e,r,n){if(Ko.isPair(t))return t.toString(e,r,n);if(Ko.isAlias(t)){if(e.doc.directives)return t.toString(e);if(e.resolvedAliases?.has(t))throw new TypeError("Cannot stringify circular structure without alias nodes");e.resolvedAliases?e.resolvedAliases.add(t):e.resolvedAliases=new Set([t]),t=t.resolve(e.doc)}let i,o=Ko.isNode(t)?t:e.doc.createNode(t,{onTagObj:c=>i=c});i??(i=epe(e.doc.schema.tags,o));let s=tpe(o,i,e);s.length>0&&(e.indentAtStart=(e.indentAtStart??0)+s.length+1);let a=typeof i.stringify=="function"?i.stringify(o,e,r,n):Ko.isScalar(o)?Xfe.stringifyString(o,e,r,n):o.toString(e,r,n);return s?Ko.isScalar(o)||a[0]==="{"||a[0]==="["?`${s} ${a}`:`${s} +${e.indent}${a}`:a}oT.createStringifyContext=Qfe;oT.stringify=rpe});var e6=v(Q4=>{"use strict";var mo=De(),Y4=Dt(),X4=gf(),yf=ff();function npe({key:t,value:e},r,n,i){let{allNullValues:o,doc:s,indent:a,indentStep:c,options:{commentString:l,indentSeq:u,simpleKeys:d}}=r,f=mo.isNode(t)&&t.comment||null;if(d){if(f)throw new Error("With simple keys, key nodes cannot have comments");if(mo.isCollection(t)||!mo.isNode(t)&&typeof t=="object"){let T="With simple keys, collection cannot be used as a key value";throw new Error(T)}}let p=!d&&(!t||f&&e==null&&!r.inFlow||mo.isCollection(t)||(mo.isScalar(t)?t.type===Y4.Scalar.BLOCK_FOLDED||t.type===Y4.Scalar.BLOCK_LITERAL:typeof t=="object"));r=Object.assign({},r,{allNullValues:!1,implicitKey:!p&&(d||!o),indent:a+c});let m=!1,h=!1,g=X4.stringify(t,r,()=>m=!0,()=>h=!0);if(!p&&!r.inFlow&&g.length>1024){if(d)throw new Error("With simple keys, single line scalar must not span more than 1024 characters");p=!0}if(r.inFlow){if(o||e==null)return m&&n&&n(),g===""?"?":p?`? ${g}`:g}else if(o&&!d||e==null&&p)return g=`? ${g}`,f&&!m?g+=yf.lineComment(g,r.indent,l(f)):h&&i&&i(),g;m&&(f=null),p?(f&&(g+=yf.lineComment(g,r.indent,l(f))),g=`? ${g} +${a}:`):(g=`${g}:`,f&&(g+=yf.lineComment(g,r.indent,l(f))));let b,_,S;mo.isNode(e)?(b=!!e.spaceBefore,_=e.commentBefore,S=e.comment):(b=!1,_=null,S=null,e&&typeof e=="object"&&(e=s.createNode(e))),r.implicitKey=!1,!p&&!f&&mo.isScalar(e)&&(r.indentAtStart=g.length+1),h=!1,!u&&c.length>=2&&!r.inFlow&&!p&&mo.isSeq(e)&&!e.flow&&!e.tag&&!e.anchor&&(r.indent=r.indent.substring(2));let x=!1,w=X4.stringify(e,r,()=>x=!0,()=>h=!0),O=" ";if(f||b||_){if(O=b?` `:"",_){let T=l(_);O+=` -${gf.indentComment(T,r.indent)}`}w===""&&!r.inFlow?O===` +${yf.indentComment(T,r.indent)}`}w===""&&!r.inFlow?O===` `&&S&&(O=` `):O+=` ${r.indent}`}else if(!p&&mo.isCollection(e)){let T=w[0],A=w.indexOf(` `),D=A!==-1,$=r.inFlow??e.flow??e.items.length===0;if(D||!$){let re=!1;if(D&&(T==="&"||T==="!")){let K=w.indexOf(" ");T==="&"&&K!==-1&&K{"use strict";var e6=Ge("process");function tpe(t,...e){t==="debug"&&console.log(...e)}function rpe(t,e){(t==="debug"||t==="warn")&&(typeof e6.emitWarning=="function"?e6.emitWarning(e):console.warn(e))}sT.debug=tpe;sT.warn=rpe});var zy=v(Ly=>{"use strict";var Fy=De(),t6=Dt(),jy="<<",My={identify:t=>t===jy||typeof t=="symbol"&&t.description===jy,default:"key",tag:"tag:yaml.org,2002:merge",test:/^<<$/,resolve:()=>Object.assign(new t6.Scalar(Symbol(jy)),{addToJSMap:r6}),stringify:()=>jy},npe=(t,e)=>(My.identify(e)||Fy.isScalar(e)&&(!e.type||e.type===t6.Scalar.PLAIN)&&My.identify(e.value))&&t?.doc.schema.tags.some(r=>r.tag===My.tag&&r.default);function r6(t,e,r){let n=n6(t,r);if(Fy.isSeq(n))for(let i of n.items)cT(t,e,i);else if(Array.isArray(n))for(let i of n)cT(t,e,i);else cT(t,e,n)}function cT(t,e,r){let n=n6(t,r);if(!Fy.isMap(n))throw new Error("Merge sources must be maps or map aliases");let i=n.toJSON(null,t,Map);for(let[o,s]of i)e instanceof Map?e.has(o)||e.set(o,s):e instanceof Set?e.add(o):Object.prototype.hasOwnProperty.call(e,o)||Object.defineProperty(e,o,{value:s,writable:!0,enumerable:!0,configurable:!0});return e}function n6(t,e){return t&&Fy.isAlias(e)?e.resolve(t.doc,t):e}Ly.addMergeToJSMap=r6;Ly.isMergeKey=npe;Ly.merge=My});var uT=v(s6=>{"use strict";var ipe=aT(),i6=zy(),ope=hf(),o6=De(),lT=Zo();function spe(t,e,{key:r,value:n}){if(o6.isNode(r)&&r.addToJSMap)r.addToJSMap(t,e,n);else if(i6.isMergeKey(t,r))i6.addMergeToJSMap(t,e,n);else{let i=lT.toJS(r,"",t);if(e instanceof Map)e.set(i,lT.toJS(n,i,t));else if(e instanceof Set)e.add(i);else{let o=ape(r,i,t),s=lT.toJS(n,o,t);o in e?Object.defineProperty(e,o,{value:s,writable:!0,enumerable:!0,configurable:!0}):e[o]=s}}return e}function ape(t,e,r){if(e===null)return"";if(typeof e!="object")return String(e);if(o6.isNode(t)&&r?.doc){let n=ope.createStringifyContext(r.doc,{});n.anchors=new Set;for(let o of r.anchors.keys())n.anchors.add(o.anchor);n.inFlow=!0,n.inStringifyKey=!0;let i=t.toString(n);if(!r.mapKeyWarned){let o=JSON.stringify(i);o.length>40&&(o=o.substring(0,36)+'..."'),ipe.warn(r.doc.options.logLevel,`Keys with collection values will be stringified due to JS Object restrictions: ${o}. Set mapAsMap: true to use object keys.`),r.mapKeyWarned=!0}return i}return JSON.stringify(e)}s6.addPairToJSMap=spe});var Jo=v(dT=>{"use strict";var a6=uf(),cpe=Q4(),lpe=uT(),Uy=De();function upe(t,e,r){let n=a6.createNode(t,void 0,r),i=a6.createNode(e,void 0,r);return new qy(n,i)}var qy=class t{constructor(e,r=null){Object.defineProperty(this,Uy.NODE_TYPE,{value:Uy.PAIR}),this.key=e,this.value=r}clone(e){let{key:r,value:n}=this;return Uy.isNode(r)&&(r=r.clone(e)),Uy.isNode(n)&&(n=n.clone(e)),new t(r,n)}toJSON(e,r){let n=r?.mapAsMap?new Map:{};return lpe.addPairToJSMap(r,n,this)}toString(e,r,n){return e?.doc?cpe.stringifyPair(this,e,r,n):JSON.stringify(this)}};dT.Pair=qy;dT.createPair=upe});var fT=v(l6=>{"use strict";var fa=De(),c6=hf(),By=df();function dpe(t,e,r){return(e.inFlow??t.flow?ppe:fpe)(t,e,r)}function fpe({comment:t,items:e},r,{blockItemPrefix:n,flowChars:i,itemIndent:o,onChompKeep:s,onComment:a}){let{indent:c,options:{commentString:l}}=r,u=Object.assign({},r,{indent:o,type:null}),d=!1,f=[];for(let m=0;mg=null,()=>d=!0);g&&(b+=By.lineComment(b,o,l(g))),d&&g&&(d=!1),f.push(n+b)}let p;if(f.length===0)p=i.start+i.end;else{p=f[0];for(let m=1;m{"use strict";var t6=Ge("process");function ipe(t,...e){t==="debug"&&console.log(...e)}function ope(t,e){(t==="debug"||t==="warn")&&(typeof t6.emitWarning=="function"?t6.emitWarning(e):console.warn(e))}sT.debug=ipe;sT.warn=ope});var zy=v(Ly=>{"use strict";var Fy=De(),r6=Dt(),jy="<<",My={identify:t=>t===jy||typeof t=="symbol"&&t.description===jy,default:"key",tag:"tag:yaml.org,2002:merge",test:/^<<$/,resolve:()=>Object.assign(new r6.Scalar(Symbol(jy)),{addToJSMap:n6}),stringify:()=>jy},spe=(t,e)=>(My.identify(e)||Fy.isScalar(e)&&(!e.type||e.type===r6.Scalar.PLAIN)&&My.identify(e.value))&&t?.doc.schema.tags.some(r=>r.tag===My.tag&&r.default);function n6(t,e,r){let n=i6(t,r);if(Fy.isSeq(n))for(let i of n.items)cT(t,e,i);else if(Array.isArray(n))for(let i of n)cT(t,e,i);else cT(t,e,n)}function cT(t,e,r){let n=i6(t,r);if(!Fy.isMap(n))throw new Error("Merge sources must be maps or map aliases");let i=n.toJSON(null,t,Map);for(let[o,s]of i)e instanceof Map?e.has(o)||e.set(o,s):e instanceof Set?e.add(o):Object.prototype.hasOwnProperty.call(e,o)||Object.defineProperty(e,o,{value:s,writable:!0,enumerable:!0,configurable:!0});return e}function i6(t,e){return t&&Fy.isAlias(e)?e.resolve(t.doc,t):e}Ly.addMergeToJSMap=n6;Ly.isMergeKey=spe;Ly.merge=My});var uT=v(a6=>{"use strict";var ape=aT(),o6=zy(),cpe=gf(),s6=De(),lT=Zo();function lpe(t,e,{key:r,value:n}){if(s6.isNode(r)&&r.addToJSMap)r.addToJSMap(t,e,n);else if(o6.isMergeKey(t,r))o6.addMergeToJSMap(t,e,n);else{let i=lT.toJS(r,"",t);if(e instanceof Map)e.set(i,lT.toJS(n,i,t));else if(e instanceof Set)e.add(i);else{let o=upe(r,i,t),s=lT.toJS(n,o,t);o in e?Object.defineProperty(e,o,{value:s,writable:!0,enumerable:!0,configurable:!0}):e[o]=s}}return e}function upe(t,e,r){if(e===null)return"";if(typeof e!="object")return String(e);if(s6.isNode(t)&&r?.doc){let n=cpe.createStringifyContext(r.doc,{});n.anchors=new Set;for(let o of r.anchors.keys())n.anchors.add(o.anchor);n.inFlow=!0,n.inStringifyKey=!0;let i=t.toString(n);if(!r.mapKeyWarned){let o=JSON.stringify(i);o.length>40&&(o=o.substring(0,36)+'..."'),ape.warn(r.doc.options.logLevel,`Keys with collection values will be stringified due to JS Object restrictions: ${o}. Set mapAsMap: true to use object keys.`),r.mapKeyWarned=!0}return i}return JSON.stringify(e)}a6.addPairToJSMap=lpe});var Jo=v(dT=>{"use strict";var c6=df(),dpe=e6(),fpe=uT(),Uy=De();function ppe(t,e,r){let n=c6.createNode(t,void 0,r),i=c6.createNode(e,void 0,r);return new qy(n,i)}var qy=class t{constructor(e,r=null){Object.defineProperty(this,Uy.NODE_TYPE,{value:Uy.PAIR}),this.key=e,this.value=r}clone(e){let{key:r,value:n}=this;return Uy.isNode(r)&&(r=r.clone(e)),Uy.isNode(n)&&(n=n.clone(e)),new t(r,n)}toJSON(e,r){let n=r?.mapAsMap?new Map:{};return fpe.addPairToJSMap(r,n,this)}toString(e,r,n){return e?.doc?dpe.stringifyPair(this,e,r,n):JSON.stringify(this)}};dT.Pair=qy;dT.createPair=ppe});var fT=v(u6=>{"use strict";var fa=De(),l6=gf(),By=ff();function mpe(t,e,r){return(e.inFlow??t.flow?gpe:hpe)(t,e,r)}function hpe({comment:t,items:e},r,{blockItemPrefix:n,flowChars:i,itemIndent:o,onChompKeep:s,onComment:a}){let{indent:c,options:{commentString:l}}=r,u=Object.assign({},r,{indent:o,type:null}),d=!1,f=[];for(let m=0;mg=null,()=>d=!0);g&&(b+=By.lineComment(b,o,l(g))),d&&g&&(d=!1),f.push(n+b)}let p;if(f.length===0)p=i.start+i.end;else{p=f[0];for(let m=1;mg=null);l||(l=d.length>u||b.includes(` +`+By.indentComment(l(t),c),a&&a()):d&&s&&s(),p}function gpe({items:t},e,{flowChars:r,itemIndent:n}){let{indent:i,indentStep:o,flowCollectionPadding:s,options:{commentString:a}}=e;n+=o;let c=Object.assign({},e,{indent:n,inFlow:!0,type:null}),l=!1,u=0,d=[];for(let m=0;mg=null);l||(l=d.length>u||b.includes(` `)),m0&&(l||(l=d.reduce((_,S)=>_+S.length+2,2)+(b.length+2)>e.options.lineWidth)),l&&(b+=",")),g&&(b+=By.lineComment(b,n,a(g))),d.push(b),u=d.length}let{start:f,end:p}=r;if(d.length===0)return f+p;if(!l){let m=d.reduce((h,g)=>h+g.length+2,2);l=e.options.lineWidth>0&&m>e.options.lineWidth}if(l){let m=f;for(let h of d)m+=h?` ${o}${i}${h}`:` `;return`${m} -${i}${p}`}else return`${f}${s}${d.join(" ")}${s}${p}`}function Hy({indent:t,options:{commentString:e}},r,n,i){if(n&&i&&(n=n.replace(/^\n+/,"")),n){let o=By.indentComment(e(n),t);r.push(o.trimStart())}}l6.stringifyCollection=dpe});var Xo=v(mT=>{"use strict";var mpe=fT(),hpe=uT(),gpe=Ry(),Yo=De(),Gy=Jo(),ype=Dt();function yf(t,e){let r=Yo.isScalar(e)?e.value:e;for(let n of t)if(Yo.isPair(n)&&(n.key===e||n.key===r||Yo.isScalar(n.key)&&n.key.value===r))return n}var pT=class extends gpe.Collection{static get tagName(){return"tag:yaml.org,2002:map"}constructor(e){super(Yo.MAP,e),this.items=[]}static from(e,r,n){let{keepUndefined:i,replacer:o}=n,s=new this(e),a=(c,l)=>{if(typeof o=="function")l=o.call(r,c,l);else if(Array.isArray(o)&&!o.includes(c))return;(l!==void 0||i)&&s.items.push(Gy.createPair(c,l,n))};if(r instanceof Map)for(let[c,l]of r)a(c,l);else if(r&&typeof r=="object")for(let c of Object.keys(r))a(c,r[c]);return typeof e.sortMapEntries=="function"&&s.items.sort(e.sortMapEntries),s}add(e,r){let n;Yo.isPair(e)?n=e:!e||typeof e!="object"||!("key"in e)?n=new Gy.Pair(e,e?.value):n=new Gy.Pair(e.key,e.value);let i=yf(this.items,n.key),o=this.schema?.sortMapEntries;if(i){if(!r)throw new Error(`Key ${n.key} already set`);Yo.isScalar(i.value)&&ype.isScalarValue(n.value)?i.value.value=n.value:i.value=n.value}else if(o){let s=this.items.findIndex(a=>o(n,a)<0);s===-1?this.items.push(n):this.items.splice(s,0,n)}else this.items.push(n)}delete(e){let r=yf(this.items,e);return r?this.items.splice(this.items.indexOf(r),1).length>0:!1}get(e,r){let i=yf(this.items,e)?.value;return(!r&&Yo.isScalar(i)?i.value:i)??void 0}has(e){return!!yf(this.items,e)}set(e,r){this.add(new Gy.Pair(e,r),!0)}toJSON(e,r,n){let i=n?new n:r?.mapAsMap?new Map:{};r?.onCreate&&r.onCreate(i);for(let o of this.items)hpe.addPairToJSMap(r,i,o);return i}toString(e,r,n){if(!e)return JSON.stringify(this);for(let i of this.items)if(!Yo.isPair(i))throw new Error(`Map items must all be pairs; found ${JSON.stringify(i)} instead`);return!e.allNullValues&&this.hasAllNullValues(!1)&&(e=Object.assign({},e,{allNullValues:!0})),mpe.stringifyCollection(this,e,{blockItemPrefix:"",flowChars:{start:"{",end:"}"},itemIndent:e.indent||"",onChompKeep:n,onComment:r})}};mT.YAMLMap=pT;mT.findPair=yf});var nl=v(d6=>{"use strict";var _pe=De(),u6=Xo(),bpe={collection:"map",default:!0,nodeClass:u6.YAMLMap,tag:"tag:yaml.org,2002:map",resolve(t,e){return _pe.isMap(t)||e("Expected a mapping for this tag"),t},createNode:(t,e,r)=>u6.YAMLMap.from(t,e,r)};d6.map=bpe});var Qo=v(f6=>{"use strict";var vpe=uf(),Spe=fT(),wpe=Ry(),Vy=De(),xpe=Dt(),$pe=Zo(),hT=class extends wpe.Collection{static get tagName(){return"tag:yaml.org,2002:seq"}constructor(e){super(Vy.SEQ,e),this.items=[]}add(e){this.items.push(e)}delete(e){let r=Zy(e);return typeof r!="number"?!1:this.items.splice(r,1).length>0}get(e,r){let n=Zy(e);if(typeof n!="number")return;let i=this.items[n];return!r&&Vy.isScalar(i)?i.value:i}has(e){let r=Zy(e);return typeof r=="number"&&r=0?e:null}f6.YAMLSeq=hT});var il=v(m6=>{"use strict";var kpe=De(),p6=Qo(),Epe={collection:"seq",default:!0,nodeClass:p6.YAMLSeq,tag:"tag:yaml.org,2002:seq",resolve(t,e){return kpe.isSeq(t)||e("Expected a sequence for this tag"),t},createNode:(t,e,r)=>p6.YAMLSeq.from(t,e,r)};m6.seq=Epe});var _f=v(h6=>{"use strict";var Ape=mf(),Tpe={identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify(t,e,r,n){return e=Object.assign({actualString:!0},e),Ape.stringifyString(t,e,r,n)}};h6.string=Tpe});var Wy=v(_6=>{"use strict";var g6=Dt(),y6={identify:t=>t==null,createNode:()=>new g6.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^(?:~|[Nn]ull|NULL)?$/,resolve:()=>new g6.Scalar(null),stringify:({source:t},e)=>typeof t=="string"&&y6.test.test(t)?t:e.options.nullStr};_6.nullTag=y6});var gT=v(v6=>{"use strict";var Ope=Dt(),b6={identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:[Tt]rue|TRUE|[Ff]alse|FALSE)$/,resolve:t=>new Ope.Scalar(t[0]==="t"||t[0]==="T"),stringify({source:t,value:e},r){if(t&&b6.test.test(t)){let n=t[0]==="t"||t[0]==="T";if(e===n)return t}return e?r.options.trueStr:r.options.falseStr}};v6.boolTag=b6});var ol=v(S6=>{"use strict";function Rpe({format:t,minFractionDigits:e,tag:r,value:n}){if(typeof n=="bigint")return String(n);let i=typeof n=="number"?n:Number(n);if(!isFinite(i))return isNaN(i)?".nan":i<0?"-.inf":".inf";let o=Object.is(n,-0)?"-0":JSON.stringify(n);if(!t&&e&&(!r||r==="tag:yaml.org,2002:float")&&/^-?\d/.test(o)&&!o.includes("e")){let s=o.indexOf(".");s<0&&(s=o.length,o+=".");let a=e-(o.length-s-1);for(;a-- >0;)o+="0"}return o}S6.stringifyNumber=Rpe});var _T=v(Ky=>{"use strict";var Ipe=Dt(),yT=ol(),Ppe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^(?:[-+]?\.(?:inf|Inf|INF)|\.nan|\.NaN|\.NAN)$/,resolve:t=>t.slice(-3).toLowerCase()==="nan"?NaN:t[0]==="-"?Number.NEGATIVE_INFINITY:Number.POSITIVE_INFINITY,stringify:yT.stringifyNumber},Cpe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"EXP",test:/^[-+]?(?:\.[0-9]+|[0-9]+(?:\.[0-9]*)?)[eE][-+]?[0-9]+$/,resolve:t=>parseFloat(t),stringify(t){let e=Number(t.value);return isFinite(e)?e.toExponential():yT.stringifyNumber(t)}},Dpe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^[-+]?(?:\.[0-9]+|[0-9]+\.[0-9]*)$/,resolve(t){let e=new Ipe.Scalar(parseFloat(t)),r=t.indexOf(".");return r!==-1&&t[t.length-1]==="0"&&(e.minFractionDigits=t.length-r-1),e},stringify:yT.stringifyNumber};Ky.float=Dpe;Ky.floatExp=Cpe;Ky.floatNaN=Ppe});var vT=v(Yy=>{"use strict";var w6=ol(),Jy=t=>typeof t=="bigint"||Number.isInteger(t),bT=(t,e,r,{intAsBigInt:n})=>n?BigInt(t):parseInt(t.substring(e),r);function x6(t,e,r){let{value:n}=t;return Jy(n)&&n>=0?r+n.toString(e):w6.stringifyNumber(t)}var Npe={identify:t=>Jy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^0o[0-7]+$/,resolve:(t,e,r)=>bT(t,2,8,r),stringify:t=>x6(t,8,"0o")},jpe={identify:Jy,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9]+$/,resolve:(t,e,r)=>bT(t,0,10,r),stringify:w6.stringifyNumber},Mpe={identify:t=>Jy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^0x[0-9a-fA-F]+$/,resolve:(t,e,r)=>bT(t,2,16,r),stringify:t=>x6(t,16,"0x")};Yy.int=jpe;Yy.intHex=Mpe;Yy.intOct=Npe});var k6=v($6=>{"use strict";var Fpe=nl(),Lpe=Wy(),zpe=il(),Upe=_f(),qpe=gT(),ST=_T(),wT=vT(),Bpe=[Fpe.map,zpe.seq,Upe.string,Lpe.nullTag,qpe.boolTag,wT.intOct,wT.int,wT.intHex,ST.floatNaN,ST.floatExp,ST.float];$6.schema=Bpe});var T6=v(A6=>{"use strict";var Hpe=Dt(),Gpe=nl(),Zpe=il();function E6(t){return typeof t=="bigint"||Number.isInteger(t)}var Xy=({value:t})=>JSON.stringify(t),Vpe=[{identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify:Xy},{identify:t=>t==null,createNode:()=>new Hpe.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^null$/,resolve:()=>null,stringify:Xy},{identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^true$|^false$/,resolve:t=>t==="true",stringify:Xy},{identify:E6,default:!0,tag:"tag:yaml.org,2002:int",test:/^-?(?:0|[1-9][0-9]*)$/,resolve:(t,e,{intAsBigInt:r})=>r?BigInt(t):parseInt(t,10),stringify:({value:t})=>E6(t)?t.toString():JSON.stringify(t)},{identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^-?(?:0|[1-9][0-9]*)(?:\.[0-9]*)?(?:[eE][-+]?[0-9]+)?$/,resolve:t=>parseFloat(t),stringify:Xy}],Wpe={default:!0,tag:"",test:/^/,resolve(t,e){return e(`Unresolved plain scalar ${JSON.stringify(t)}`),t}},Kpe=[Gpe.map,Zpe.seq].concat(Vpe,Wpe);A6.schema=Kpe});var $T=v(O6=>{"use strict";var bf=Ge("buffer"),xT=Dt(),Jpe=mf(),Ype={identify:t=>t instanceof Uint8Array,default:!1,tag:"tag:yaml.org,2002:binary",resolve(t,e){if(typeof bf.Buffer=="function")return bf.Buffer.from(t,"base64");if(typeof atob=="function"){let r=atob(t.replace(/[\n\r]/g,"")),n=new Uint8Array(r.length);for(let i=0;i{"use strict";var Qy=De(),kT=Jo(),Xpe=Dt(),Qpe=Qo();function R6(t,e){if(Qy.isSeq(t))for(let r=0;r1&&e("Each pair must have its own sequence indicator");let i=n.items[0]||new kT.Pair(new Xpe.Scalar(null));if(n.commentBefore&&(i.key.commentBefore=i.key.commentBefore?`${n.commentBefore} +${i}${p}`}else return`${f}${s}${d.join(" ")}${s}${p}`}function Hy({indent:t,options:{commentString:e}},r,n,i){if(n&&i&&(n=n.replace(/^\n+/,"")),n){let o=By.indentComment(e(n),t);r.push(o.trimStart())}}u6.stringifyCollection=mpe});var Xo=v(mT=>{"use strict";var ype=fT(),_pe=uT(),bpe=Ry(),Yo=De(),Gy=Jo(),vpe=Dt();function _f(t,e){let r=Yo.isScalar(e)?e.value:e;for(let n of t)if(Yo.isPair(n)&&(n.key===e||n.key===r||Yo.isScalar(n.key)&&n.key.value===r))return n}var pT=class extends bpe.Collection{static get tagName(){return"tag:yaml.org,2002:map"}constructor(e){super(Yo.MAP,e),this.items=[]}static from(e,r,n){let{keepUndefined:i,replacer:o}=n,s=new this(e),a=(c,l)=>{if(typeof o=="function")l=o.call(r,c,l);else if(Array.isArray(o)&&!o.includes(c))return;(l!==void 0||i)&&s.items.push(Gy.createPair(c,l,n))};if(r instanceof Map)for(let[c,l]of r)a(c,l);else if(r&&typeof r=="object")for(let c of Object.keys(r))a(c,r[c]);return typeof e.sortMapEntries=="function"&&s.items.sort(e.sortMapEntries),s}add(e,r){let n;Yo.isPair(e)?n=e:!e||typeof e!="object"||!("key"in e)?n=new Gy.Pair(e,e?.value):n=new Gy.Pair(e.key,e.value);let i=_f(this.items,n.key),o=this.schema?.sortMapEntries;if(i){if(!r)throw new Error(`Key ${n.key} already set`);Yo.isScalar(i.value)&&vpe.isScalarValue(n.value)?i.value.value=n.value:i.value=n.value}else if(o){let s=this.items.findIndex(a=>o(n,a)<0);s===-1?this.items.push(n):this.items.splice(s,0,n)}else this.items.push(n)}delete(e){let r=_f(this.items,e);return r?this.items.splice(this.items.indexOf(r),1).length>0:!1}get(e,r){let i=_f(this.items,e)?.value;return(!r&&Yo.isScalar(i)?i.value:i)??void 0}has(e){return!!_f(this.items,e)}set(e,r){this.add(new Gy.Pair(e,r),!0)}toJSON(e,r,n){let i=n?new n:r?.mapAsMap?new Map:{};r?.onCreate&&r.onCreate(i);for(let o of this.items)_pe.addPairToJSMap(r,i,o);return i}toString(e,r,n){if(!e)return JSON.stringify(this);for(let i of this.items)if(!Yo.isPair(i))throw new Error(`Map items must all be pairs; found ${JSON.stringify(i)} instead`);return!e.allNullValues&&this.hasAllNullValues(!1)&&(e=Object.assign({},e,{allNullValues:!0})),ype.stringifyCollection(this,e,{blockItemPrefix:"",flowChars:{start:"{",end:"}"},itemIndent:e.indent||"",onChompKeep:n,onComment:r})}};mT.YAMLMap=pT;mT.findPair=_f});var nl=v(f6=>{"use strict";var Spe=De(),d6=Xo(),wpe={collection:"map",default:!0,nodeClass:d6.YAMLMap,tag:"tag:yaml.org,2002:map",resolve(t,e){return Spe.isMap(t)||e("Expected a mapping for this tag"),t},createNode:(t,e,r)=>d6.YAMLMap.from(t,e,r)};f6.map=wpe});var Qo=v(p6=>{"use strict";var xpe=df(),$pe=fT(),kpe=Ry(),Vy=De(),Epe=Dt(),Ape=Zo(),hT=class extends kpe.Collection{static get tagName(){return"tag:yaml.org,2002:seq"}constructor(e){super(Vy.SEQ,e),this.items=[]}add(e){this.items.push(e)}delete(e){let r=Zy(e);return typeof r!="number"?!1:this.items.splice(r,1).length>0}get(e,r){let n=Zy(e);if(typeof n!="number")return;let i=this.items[n];return!r&&Vy.isScalar(i)?i.value:i}has(e){let r=Zy(e);return typeof r=="number"&&r=0?e:null}p6.YAMLSeq=hT});var il=v(h6=>{"use strict";var Tpe=De(),m6=Qo(),Ope={collection:"seq",default:!0,nodeClass:m6.YAMLSeq,tag:"tag:yaml.org,2002:seq",resolve(t,e){return Tpe.isSeq(t)||e("Expected a sequence for this tag"),t},createNode:(t,e,r)=>m6.YAMLSeq.from(t,e,r)};h6.seq=Ope});var bf=v(g6=>{"use strict";var Rpe=hf(),Ipe={identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify(t,e,r,n){return e=Object.assign({actualString:!0},e),Rpe.stringifyString(t,e,r,n)}};g6.string=Ipe});var Wy=v(b6=>{"use strict";var y6=Dt(),_6={identify:t=>t==null,createNode:()=>new y6.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^(?:~|[Nn]ull|NULL)?$/,resolve:()=>new y6.Scalar(null),stringify:({source:t},e)=>typeof t=="string"&&_6.test.test(t)?t:e.options.nullStr};b6.nullTag=_6});var gT=v(S6=>{"use strict";var Ppe=Dt(),v6={identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:[Tt]rue|TRUE|[Ff]alse|FALSE)$/,resolve:t=>new Ppe.Scalar(t[0]==="t"||t[0]==="T"),stringify({source:t,value:e},r){if(t&&v6.test.test(t)){let n=t[0]==="t"||t[0]==="T";if(e===n)return t}return e?r.options.trueStr:r.options.falseStr}};S6.boolTag=v6});var ol=v(w6=>{"use strict";function Cpe({format:t,minFractionDigits:e,tag:r,value:n}){if(typeof n=="bigint")return String(n);let i=typeof n=="number"?n:Number(n);if(!isFinite(i))return isNaN(i)?".nan":i<0?"-.inf":".inf";let o=Object.is(n,-0)?"-0":JSON.stringify(n);if(!t&&e&&(!r||r==="tag:yaml.org,2002:float")&&/^-?\d/.test(o)&&!o.includes("e")){let s=o.indexOf(".");s<0&&(s=o.length,o+=".");let a=e-(o.length-s-1);for(;a-- >0;)o+="0"}return o}w6.stringifyNumber=Cpe});var _T=v(Ky=>{"use strict";var Dpe=Dt(),yT=ol(),Npe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^(?:[-+]?\.(?:inf|Inf|INF)|\.nan|\.NaN|\.NAN)$/,resolve:t=>t.slice(-3).toLowerCase()==="nan"?NaN:t[0]==="-"?Number.NEGATIVE_INFINITY:Number.POSITIVE_INFINITY,stringify:yT.stringifyNumber},jpe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"EXP",test:/^[-+]?(?:\.[0-9]+|[0-9]+(?:\.[0-9]*)?)[eE][-+]?[0-9]+$/,resolve:t=>parseFloat(t),stringify(t){let e=Number(t.value);return isFinite(e)?e.toExponential():yT.stringifyNumber(t)}},Mpe={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^[-+]?(?:\.[0-9]+|[0-9]+\.[0-9]*)$/,resolve(t){let e=new Dpe.Scalar(parseFloat(t)),r=t.indexOf(".");return r!==-1&&t[t.length-1]==="0"&&(e.minFractionDigits=t.length-r-1),e},stringify:yT.stringifyNumber};Ky.float=Mpe;Ky.floatExp=jpe;Ky.floatNaN=Npe});var vT=v(Yy=>{"use strict";var x6=ol(),Jy=t=>typeof t=="bigint"||Number.isInteger(t),bT=(t,e,r,{intAsBigInt:n})=>n?BigInt(t):parseInt(t.substring(e),r);function $6(t,e,r){let{value:n}=t;return Jy(n)&&n>=0?r+n.toString(e):x6.stringifyNumber(t)}var Fpe={identify:t=>Jy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^0o[0-7]+$/,resolve:(t,e,r)=>bT(t,2,8,r),stringify:t=>$6(t,8,"0o")},Lpe={identify:Jy,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9]+$/,resolve:(t,e,r)=>bT(t,0,10,r),stringify:x6.stringifyNumber},zpe={identify:t=>Jy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^0x[0-9a-fA-F]+$/,resolve:(t,e,r)=>bT(t,2,16,r),stringify:t=>$6(t,16,"0x")};Yy.int=Lpe;Yy.intHex=zpe;Yy.intOct=Fpe});var E6=v(k6=>{"use strict";var Upe=nl(),qpe=Wy(),Bpe=il(),Hpe=bf(),Gpe=gT(),ST=_T(),wT=vT(),Zpe=[Upe.map,Bpe.seq,Hpe.string,qpe.nullTag,Gpe.boolTag,wT.intOct,wT.int,wT.intHex,ST.floatNaN,ST.floatExp,ST.float];k6.schema=Zpe});var O6=v(T6=>{"use strict";var Vpe=Dt(),Wpe=nl(),Kpe=il();function A6(t){return typeof t=="bigint"||Number.isInteger(t)}var Xy=({value:t})=>JSON.stringify(t),Jpe=[{identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify:Xy},{identify:t=>t==null,createNode:()=>new Vpe.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^null$/,resolve:()=>null,stringify:Xy},{identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^true$|^false$/,resolve:t=>t==="true",stringify:Xy},{identify:A6,default:!0,tag:"tag:yaml.org,2002:int",test:/^-?(?:0|[1-9][0-9]*)$/,resolve:(t,e,{intAsBigInt:r})=>r?BigInt(t):parseInt(t,10),stringify:({value:t})=>A6(t)?t.toString():JSON.stringify(t)},{identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^-?(?:0|[1-9][0-9]*)(?:\.[0-9]*)?(?:[eE][-+]?[0-9]+)?$/,resolve:t=>parseFloat(t),stringify:Xy}],Ype={default:!0,tag:"",test:/^/,resolve(t,e){return e(`Unresolved plain scalar ${JSON.stringify(t)}`),t}},Xpe=[Wpe.map,Kpe.seq].concat(Jpe,Ype);T6.schema=Xpe});var $T=v(R6=>{"use strict";var vf=Ge("buffer"),xT=Dt(),Qpe=hf(),eme={identify:t=>t instanceof Uint8Array,default:!1,tag:"tag:yaml.org,2002:binary",resolve(t,e){if(typeof vf.Buffer=="function")return vf.Buffer.from(t,"base64");if(typeof atob=="function"){let r=atob(t.replace(/[\n\r]/g,"")),n=new Uint8Array(r.length);for(let i=0;i{"use strict";var Qy=De(),kT=Jo(),tme=Dt(),rme=Qo();function I6(t,e){if(Qy.isSeq(t))for(let r=0;r1&&e("Each pair must have its own sequence indicator");let i=n.items[0]||new kT.Pair(new tme.Scalar(null));if(n.commentBefore&&(i.key.commentBefore=i.key.commentBefore?`${n.commentBefore} ${i.key.commentBefore}`:n.commentBefore),n.comment){let o=i.value??i.key;o.comment=o.comment?`${n.comment} -${o.comment}`:n.comment}n=i}t.items[r]=Qy.isPair(n)?n:new kT.Pair(n)}}else e("Expected a sequence for this tag");return t}function I6(t,e,r){let{replacer:n}=r,i=new Qpe.YAMLSeq(t);i.tag="tag:yaml.org,2002:pairs";let o=0;if(e&&Symbol.iterator in Object(e))for(let s of e){typeof n=="function"&&(s=n.call(e,String(o++),s));let a,c;if(Array.isArray(s))if(s.length===2)a=s[0],c=s[1];else throw new TypeError(`Expected [key, value] tuple: ${s}`);else if(s&&s instanceof Object){let l=Object.keys(s);if(l.length===1)a=l[0],c=s[a];else throw new TypeError(`Expected tuple with one key, not ${l.length} keys`)}else a=s;i.items.push(kT.createPair(a,c,r))}return i}var eme={collection:"seq",default:!1,tag:"tag:yaml.org,2002:pairs",resolve:R6,createNode:I6};e_.createPairs=I6;e_.pairs=eme;e_.resolvePairs=R6});var TT=v(AT=>{"use strict";var P6=De(),ET=Zo(),vf=Xo(),tme=Qo(),C6=t_(),pa=class t extends tme.YAMLSeq{constructor(){super(),this.add=vf.YAMLMap.prototype.add.bind(this),this.delete=vf.YAMLMap.prototype.delete.bind(this),this.get=vf.YAMLMap.prototype.get.bind(this),this.has=vf.YAMLMap.prototype.has.bind(this),this.set=vf.YAMLMap.prototype.set.bind(this),this.tag=t.tag}toJSON(e,r){if(!r)return super.toJSON(e);let n=new Map;r?.onCreate&&r.onCreate(n);for(let i of this.items){let o,s;if(P6.isPair(i)?(o=ET.toJS(i.key,"",r),s=ET.toJS(i.value,o,r)):o=ET.toJS(i,"",r),n.has(o))throw new Error("Ordered maps must not include duplicate keys");n.set(o,s)}return n}static from(e,r,n){let i=C6.createPairs(e,r,n),o=new this;return o.items=i.items,o}};pa.tag="tag:yaml.org,2002:omap";var rme={collection:"seq",identify:t=>t instanceof Map,nodeClass:pa,default:!1,tag:"tag:yaml.org,2002:omap",resolve(t,e){let r=C6.resolvePairs(t,e),n=[];for(let{key:i}of r.items)P6.isScalar(i)&&(n.includes(i.value)?e(`Ordered maps must not include duplicate keys: ${i.value}`):n.push(i.value));return Object.assign(new pa,r)},createNode:(t,e,r)=>pa.from(t,e,r)};AT.YAMLOMap=pa;AT.omap=rme});var F6=v(OT=>{"use strict";var D6=Dt();function N6({value:t,source:e},r){return e&&(t?j6:M6).test.test(e)?e:t?r.options.trueStr:r.options.falseStr}var j6={identify:t=>t===!0,default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:Y|y|[Yy]es|YES|[Tt]rue|TRUE|[Oo]n|ON)$/,resolve:()=>new D6.Scalar(!0),stringify:N6},M6={identify:t=>t===!1,default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:N|n|[Nn]o|NO|[Ff]alse|FALSE|[Oo]ff|OFF)$/,resolve:()=>new D6.Scalar(!1),stringify:N6};OT.falseTag=M6;OT.trueTag=j6});var L6=v(r_=>{"use strict";var nme=Dt(),RT=ol(),ime={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^(?:[-+]?\.(?:inf|Inf|INF)|\.nan|\.NaN|\.NAN)$/,resolve:t=>t.slice(-3).toLowerCase()==="nan"?NaN:t[0]==="-"?Number.NEGATIVE_INFINITY:Number.POSITIVE_INFINITY,stringify:RT.stringifyNumber},ome={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"EXP",test:/^[-+]?(?:[0-9][0-9_]*)?(?:\.[0-9_]*)?[eE][-+]?[0-9]+$/,resolve:t=>parseFloat(t.replace(/_/g,"")),stringify(t){let e=Number(t.value);return isFinite(e)?e.toExponential():RT.stringifyNumber(t)}},sme={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^[-+]?(?:[0-9][0-9_]*)?\.[0-9_]*$/,resolve(t){let e=new nme.Scalar(parseFloat(t.replace(/_/g,""))),r=t.indexOf(".");if(r!==-1){let n=t.substring(r+1).replace(/_/g,"");n[n.length-1]==="0"&&(e.minFractionDigits=n.length)}return e},stringify:RT.stringifyNumber};r_.float=sme;r_.floatExp=ome;r_.floatNaN=ime});var U6=v(wf=>{"use strict";var z6=ol(),Sf=t=>typeof t=="bigint"||Number.isInteger(t);function n_(t,e,r,{intAsBigInt:n}){let i=t[0];if((i==="-"||i==="+")&&(e+=1),t=t.substring(e).replace(/_/g,""),n){switch(r){case 2:t=`0b${t}`;break;case 8:t=`0o${t}`;break;case 16:t=`0x${t}`;break}let s=BigInt(t);return i==="-"?BigInt(-1)*s:s}let o=parseInt(t,r);return i==="-"?-1*o:o}function IT(t,e,r){let{value:n}=t;if(Sf(n)){let i=n.toString(e);return n<0?"-"+r+i.substr(1):r+i}return z6.stringifyNumber(t)}var ame={identify:Sf,default:!0,tag:"tag:yaml.org,2002:int",format:"BIN",test:/^[-+]?0b[0-1_]+$/,resolve:(t,e,r)=>n_(t,2,2,r),stringify:t=>IT(t,2,"0b")},cme={identify:Sf,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^[-+]?0[0-7_]+$/,resolve:(t,e,r)=>n_(t,1,8,r),stringify:t=>IT(t,8,"0")},lme={identify:Sf,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9][0-9_]*$/,resolve:(t,e,r)=>n_(t,0,10,r),stringify:z6.stringifyNumber},ume={identify:Sf,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^[-+]?0x[0-9a-fA-F_]+$/,resolve:(t,e,r)=>n_(t,2,16,r),stringify:t=>IT(t,16,"0x")};wf.int=lme;wf.intBin=ame;wf.intHex=ume;wf.intOct=cme});var CT=v(PT=>{"use strict";var s_=De(),i_=Jo(),o_=Xo(),ma=class t extends o_.YAMLMap{constructor(e){super(e),this.tag=t.tag}add(e){let r;s_.isPair(e)?r=e:e&&typeof e=="object"&&"key"in e&&"value"in e&&e.value===null?r=new i_.Pair(e.key,null):r=new i_.Pair(e,null),o_.findPair(this.items,r.key)||this.items.push(r)}get(e,r){let n=o_.findPair(this.items,e);return!r&&s_.isPair(n)?s_.isScalar(n.key)?n.key.value:n.key:n}set(e,r){if(typeof r!="boolean")throw new Error(`Expected boolean value for set(key, value) in a YAML set, not ${typeof r}`);let n=o_.findPair(this.items,e);n&&!r?this.items.splice(this.items.indexOf(n),1):!n&&r&&this.items.push(new i_.Pair(e))}toJSON(e,r){return super.toJSON(e,r,Set)}toString(e,r,n){if(!e)return JSON.stringify(this);if(this.hasAllNullValues(!0))return super.toString(Object.assign({},e,{allNullValues:!0}),r,n);throw new Error("Set items must all have null values")}static from(e,r,n){let{replacer:i}=n,o=new this(e);if(r&&Symbol.iterator in Object(r))for(let s of r)typeof i=="function"&&(s=i.call(r,s,s)),o.items.push(i_.createPair(s,null,n));return o}};ma.tag="tag:yaml.org,2002:set";var dme={collection:"map",identify:t=>t instanceof Set,nodeClass:ma,default:!1,tag:"tag:yaml.org,2002:set",createNode:(t,e,r)=>ma.from(t,e,r),resolve(t,e){if(s_.isMap(t)){if(t.hasAllNullValues(!0))return Object.assign(new ma,t);e("Set items must all have null values")}else e("Expected a mapping for this tag");return t}};PT.YAMLSet=ma;PT.set=dme});var NT=v(a_=>{"use strict";var fme=ol();function DT(t,e){let r=t[0],n=r==="-"||r==="+"?t.substring(1):t,i=s=>e?BigInt(s):Number(s),o=n.replace(/_/g,"").split(":").reduce((s,a)=>s*i(60)+i(a),i(0));return r==="-"?i(-1)*o:o}function q6(t){let{value:e}=t,r=s=>s;if(typeof e=="bigint")r=s=>BigInt(s);else if(isNaN(e)||!isFinite(e))return fme.stringifyNumber(t);let n="";e<0&&(n="-",e*=r(-1));let i=r(60),o=[e%i];return e<60?o.unshift(0):(e=(e-o[0])/i,o.unshift(e%i),e>=60&&(e=(e-o[0])/i,o.unshift(e))),n+o.map(s=>String(s).padStart(2,"0")).join(":").replace(/000000\d*$/,"")}var pme={identify:t=>typeof t=="bigint"||Number.isInteger(t),default:!0,tag:"tag:yaml.org,2002:int",format:"TIME",test:/^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+$/,resolve:(t,e,{intAsBigInt:r})=>DT(t,r),stringify:q6},mme={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"TIME",test:/^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*$/,resolve:t=>DT(t,!1),stringify:q6},B6={identify:t=>t instanceof Date,default:!0,tag:"tag:yaml.org,2002:timestamp",test:RegExp("^([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})(?:(?:t|T|[ \\t]+)([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2}(\\.[0-9]+)?)(?:[ \\t]*(Z|[-+][012]?[0-9](?::[0-9]{2})?))?)?$"),resolve(t){let e=t.match(B6.test);if(!e)throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");let[,r,n,i,o,s,a]=e.map(Number),c=e[7]?Number((e[7]+"00").substr(1,3)):0,l=Date.UTC(r,n-1,i,o||0,s||0,a||0,c),u=e[8];if(u&&u!=="Z"){let d=DT(u,!1);Math.abs(d)<30&&(d*=60),l-=6e4*d}return new Date(l)},stringify:({value:t})=>t?.toISOString().replace(/(T00:00:00)?\.000Z$/,"")??""};a_.floatTime=mme;a_.intTime=pme;a_.timestamp=B6});var Z6=v(G6=>{"use strict";var hme=nl(),gme=Wy(),yme=il(),_me=_f(),bme=$T(),H6=F6(),jT=L6(),c_=U6(),vme=zy(),Sme=TT(),wme=t_(),xme=CT(),MT=NT(),$me=[hme.map,yme.seq,_me.string,gme.nullTag,H6.trueTag,H6.falseTag,c_.intBin,c_.intOct,c_.int,c_.intHex,jT.floatNaN,jT.floatExp,jT.float,bme.binary,vme.merge,Sme.omap,wme.pairs,xme.set,MT.intTime,MT.floatTime,MT.timestamp];G6.schema=$me});var rB=v(zT=>{"use strict";var J6=nl(),kme=Wy(),Y6=il(),Eme=_f(),Ame=gT(),FT=_T(),LT=vT(),Tme=k6(),Ome=T6(),X6=$T(),xf=zy(),Q6=TT(),eB=t_(),V6=Z6(),tB=CT(),l_=NT(),W6=new Map([["core",Tme.schema],["failsafe",[J6.map,Y6.seq,Eme.string]],["json",Ome.schema],["yaml11",V6.schema],["yaml-1.1",V6.schema]]),K6={binary:X6.binary,bool:Ame.boolTag,float:FT.float,floatExp:FT.floatExp,floatNaN:FT.floatNaN,floatTime:l_.floatTime,int:LT.int,intHex:LT.intHex,intOct:LT.intOct,intTime:l_.intTime,map:J6.map,merge:xf.merge,null:kme.nullTag,omap:Q6.omap,pairs:eB.pairs,seq:Y6.seq,set:tB.set,timestamp:l_.timestamp},Rme={"tag:yaml.org,2002:binary":X6.binary,"tag:yaml.org,2002:merge":xf.merge,"tag:yaml.org,2002:omap":Q6.omap,"tag:yaml.org,2002:pairs":eB.pairs,"tag:yaml.org,2002:set":tB.set,"tag:yaml.org,2002:timestamp":l_.timestamp};function Ime(t,e,r){let n=W6.get(e);if(n&&!t)return r&&!n.includes(xf.merge)?n.concat(xf.merge):n.slice();let i=n;if(!i)if(Array.isArray(t))i=[];else{let o=Array.from(W6.keys()).filter(s=>s!=="yaml11").map(s=>JSON.stringify(s)).join(", ");throw new Error(`Unknown schema "${e}"; use one of ${o} or define customTags array`)}if(Array.isArray(t))for(let o of t)i=i.concat(o);else typeof t=="function"&&(i=t(i.slice()));return r&&(i=i.concat(xf.merge)),i.reduce((o,s)=>{let a=typeof s=="string"?K6[s]:s;if(!a){let c=JSON.stringify(s),l=Object.keys(K6).map(u=>JSON.stringify(u)).join(", ");throw new Error(`Unknown custom tag ${c}; use one of ${l}`)}return o.includes(a)||o.push(a),o},[])}zT.coreKnownTags=Rme;zT.getTags=Ime});var BT=v(nB=>{"use strict";var UT=De(),Pme=nl(),Cme=il(),Dme=_f(),u_=rB(),Nme=(t,e)=>t.keye.key?1:0,qT=class t{constructor({compat:e,customTags:r,merge:n,resolveKnownTags:i,schema:o,sortMapEntries:s,toStringDefaults:a}){this.compat=Array.isArray(e)?u_.getTags(e,"compat"):e?u_.getTags(null,e):null,this.name=typeof o=="string"&&o||"core",this.knownTags=i?u_.coreKnownTags:{},this.tags=u_.getTags(r,this.name,n),this.toStringOptions=a??null,Object.defineProperty(this,UT.MAP,{value:Pme.map}),Object.defineProperty(this,UT.SCALAR,{value:Dme.string}),Object.defineProperty(this,UT.SEQ,{value:Cme.seq}),this.sortMapEntries=typeof s=="function"?s:s===!0?Nme:null}clone(){let e=Object.create(t.prototype,Object.getOwnPropertyDescriptors(this));return e.tags=this.tags.slice(),e}};nB.Schema=qT});var oB=v(iB=>{"use strict";var jme=De(),HT=hf(),$f=df();function Mme(t,e){let r=[],n=e.directives===!0;if(e.directives!==!1&&t.directives){let c=t.directives.toString(t);c?(r.push(c),n=!0):t.directives.docStart&&(n=!0)}n&&r.push("---");let i=HT.createStringifyContext(t,e),{commentString:o}=i.options;if(t.commentBefore){r.length!==1&&r.unshift("");let c=o(t.commentBefore);r.unshift($f.indentComment(c,""))}let s=!1,a=null;if(t.contents){if(jme.isNode(t.contents)){if(t.contents.spaceBefore&&n&&r.push(""),t.contents.commentBefore){let u=o(t.contents.commentBefore);r.push($f.indentComment(u,""))}i.forceBlockIndent=!!t.comment,a=t.contents.comment}let c=a?void 0:()=>s=!0,l=HT.stringify(t.contents,i,()=>a=null,c);a&&(l+=$f.lineComment(l,"",o(a))),(l[0]==="|"||l[0]===">")&&r[r.length-1]==="---"?r[r.length-1]=`--- ${l}`:r.push(l)}else r.push(HT.stringify(t.contents,i));if(t.directives?.docEnd)if(t.comment){let c=o(t.comment);c.includes(` -`)?(r.push("..."),r.push($f.indentComment(c,""))):r.push(`... ${c}`)}else r.push("...");else{let c=t.comment;c&&s&&(c=c.replace(/^\n+/,"")),c&&((!s||a)&&r[r.length-1]!==""&&r.push(""),r.push($f.indentComment(o(c),"")))}return r.join(` +${o.comment}`:n.comment}n=i}t.items[r]=Qy.isPair(n)?n:new kT.Pair(n)}}else e("Expected a sequence for this tag");return t}function P6(t,e,r){let{replacer:n}=r,i=new rme.YAMLSeq(t);i.tag="tag:yaml.org,2002:pairs";let o=0;if(e&&Symbol.iterator in Object(e))for(let s of e){typeof n=="function"&&(s=n.call(e,String(o++),s));let a,c;if(Array.isArray(s))if(s.length===2)a=s[0],c=s[1];else throw new TypeError(`Expected [key, value] tuple: ${s}`);else if(s&&s instanceof Object){let l=Object.keys(s);if(l.length===1)a=l[0],c=s[a];else throw new TypeError(`Expected tuple with one key, not ${l.length} keys`)}else a=s;i.items.push(kT.createPair(a,c,r))}return i}var nme={collection:"seq",default:!1,tag:"tag:yaml.org,2002:pairs",resolve:I6,createNode:P6};e_.createPairs=P6;e_.pairs=nme;e_.resolvePairs=I6});var TT=v(AT=>{"use strict";var C6=De(),ET=Zo(),Sf=Xo(),ime=Qo(),D6=t_(),pa=class t extends ime.YAMLSeq{constructor(){super(),this.add=Sf.YAMLMap.prototype.add.bind(this),this.delete=Sf.YAMLMap.prototype.delete.bind(this),this.get=Sf.YAMLMap.prototype.get.bind(this),this.has=Sf.YAMLMap.prototype.has.bind(this),this.set=Sf.YAMLMap.prototype.set.bind(this),this.tag=t.tag}toJSON(e,r){if(!r)return super.toJSON(e);let n=new Map;r?.onCreate&&r.onCreate(n);for(let i of this.items){let o,s;if(C6.isPair(i)?(o=ET.toJS(i.key,"",r),s=ET.toJS(i.value,o,r)):o=ET.toJS(i,"",r),n.has(o))throw new Error("Ordered maps must not include duplicate keys");n.set(o,s)}return n}static from(e,r,n){let i=D6.createPairs(e,r,n),o=new this;return o.items=i.items,o}};pa.tag="tag:yaml.org,2002:omap";var ome={collection:"seq",identify:t=>t instanceof Map,nodeClass:pa,default:!1,tag:"tag:yaml.org,2002:omap",resolve(t,e){let r=D6.resolvePairs(t,e),n=[];for(let{key:i}of r.items)C6.isScalar(i)&&(n.includes(i.value)?e(`Ordered maps must not include duplicate keys: ${i.value}`):n.push(i.value));return Object.assign(new pa,r)},createNode:(t,e,r)=>pa.from(t,e,r)};AT.YAMLOMap=pa;AT.omap=ome});var L6=v(OT=>{"use strict";var N6=Dt();function j6({value:t,source:e},r){return e&&(t?M6:F6).test.test(e)?e:t?r.options.trueStr:r.options.falseStr}var M6={identify:t=>t===!0,default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:Y|y|[Yy]es|YES|[Tt]rue|TRUE|[Oo]n|ON)$/,resolve:()=>new N6.Scalar(!0),stringify:j6},F6={identify:t=>t===!1,default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:N|n|[Nn]o|NO|[Ff]alse|FALSE|[Oo]ff|OFF)$/,resolve:()=>new N6.Scalar(!1),stringify:j6};OT.falseTag=F6;OT.trueTag=M6});var z6=v(r_=>{"use strict";var sme=Dt(),RT=ol(),ame={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^(?:[-+]?\.(?:inf|Inf|INF)|\.nan|\.NaN|\.NAN)$/,resolve:t=>t.slice(-3).toLowerCase()==="nan"?NaN:t[0]==="-"?Number.NEGATIVE_INFINITY:Number.POSITIVE_INFINITY,stringify:RT.stringifyNumber},cme={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"EXP",test:/^[-+]?(?:[0-9][0-9_]*)?(?:\.[0-9_]*)?[eE][-+]?[0-9]+$/,resolve:t=>parseFloat(t.replace(/_/g,"")),stringify(t){let e=Number(t.value);return isFinite(e)?e.toExponential():RT.stringifyNumber(t)}},lme={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",test:/^[-+]?(?:[0-9][0-9_]*)?\.[0-9_]*$/,resolve(t){let e=new sme.Scalar(parseFloat(t.replace(/_/g,""))),r=t.indexOf(".");if(r!==-1){let n=t.substring(r+1).replace(/_/g,"");n[n.length-1]==="0"&&(e.minFractionDigits=n.length)}return e},stringify:RT.stringifyNumber};r_.float=lme;r_.floatExp=cme;r_.floatNaN=ame});var q6=v(xf=>{"use strict";var U6=ol(),wf=t=>typeof t=="bigint"||Number.isInteger(t);function n_(t,e,r,{intAsBigInt:n}){let i=t[0];if((i==="-"||i==="+")&&(e+=1),t=t.substring(e).replace(/_/g,""),n){switch(r){case 2:t=`0b${t}`;break;case 8:t=`0o${t}`;break;case 16:t=`0x${t}`;break}let s=BigInt(t);return i==="-"?BigInt(-1)*s:s}let o=parseInt(t,r);return i==="-"?-1*o:o}function IT(t,e,r){let{value:n}=t;if(wf(n)){let i=n.toString(e);return n<0?"-"+r+i.substr(1):r+i}return U6.stringifyNumber(t)}var ume={identify:wf,default:!0,tag:"tag:yaml.org,2002:int",format:"BIN",test:/^[-+]?0b[0-1_]+$/,resolve:(t,e,r)=>n_(t,2,2,r),stringify:t=>IT(t,2,"0b")},dme={identify:wf,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^[-+]?0[0-7_]+$/,resolve:(t,e,r)=>n_(t,1,8,r),stringify:t=>IT(t,8,"0")},fme={identify:wf,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9][0-9_]*$/,resolve:(t,e,r)=>n_(t,0,10,r),stringify:U6.stringifyNumber},pme={identify:wf,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^[-+]?0x[0-9a-fA-F_]+$/,resolve:(t,e,r)=>n_(t,2,16,r),stringify:t=>IT(t,16,"0x")};xf.int=fme;xf.intBin=ume;xf.intHex=pme;xf.intOct=dme});var CT=v(PT=>{"use strict";var s_=De(),i_=Jo(),o_=Xo(),ma=class t extends o_.YAMLMap{constructor(e){super(e),this.tag=t.tag}add(e){let r;s_.isPair(e)?r=e:e&&typeof e=="object"&&"key"in e&&"value"in e&&e.value===null?r=new i_.Pair(e.key,null):r=new i_.Pair(e,null),o_.findPair(this.items,r.key)||this.items.push(r)}get(e,r){let n=o_.findPair(this.items,e);return!r&&s_.isPair(n)?s_.isScalar(n.key)?n.key.value:n.key:n}set(e,r){if(typeof r!="boolean")throw new Error(`Expected boolean value for set(key, value) in a YAML set, not ${typeof r}`);let n=o_.findPair(this.items,e);n&&!r?this.items.splice(this.items.indexOf(n),1):!n&&r&&this.items.push(new i_.Pair(e))}toJSON(e,r){return super.toJSON(e,r,Set)}toString(e,r,n){if(!e)return JSON.stringify(this);if(this.hasAllNullValues(!0))return super.toString(Object.assign({},e,{allNullValues:!0}),r,n);throw new Error("Set items must all have null values")}static from(e,r,n){let{replacer:i}=n,o=new this(e);if(r&&Symbol.iterator in Object(r))for(let s of r)typeof i=="function"&&(s=i.call(r,s,s)),o.items.push(i_.createPair(s,null,n));return o}};ma.tag="tag:yaml.org,2002:set";var mme={collection:"map",identify:t=>t instanceof Set,nodeClass:ma,default:!1,tag:"tag:yaml.org,2002:set",createNode:(t,e,r)=>ma.from(t,e,r),resolve(t,e){if(s_.isMap(t)){if(t.hasAllNullValues(!0))return Object.assign(new ma,t);e("Set items must all have null values")}else e("Expected a mapping for this tag");return t}};PT.YAMLSet=ma;PT.set=mme});var NT=v(a_=>{"use strict";var hme=ol();function DT(t,e){let r=t[0],n=r==="-"||r==="+"?t.substring(1):t,i=s=>e?BigInt(s):Number(s),o=n.replace(/_/g,"").split(":").reduce((s,a)=>s*i(60)+i(a),i(0));return r==="-"?i(-1)*o:o}function B6(t){let{value:e}=t,r=s=>s;if(typeof e=="bigint")r=s=>BigInt(s);else if(isNaN(e)||!isFinite(e))return hme.stringifyNumber(t);let n="";e<0&&(n="-",e*=r(-1));let i=r(60),o=[e%i];return e<60?o.unshift(0):(e=(e-o[0])/i,o.unshift(e%i),e>=60&&(e=(e-o[0])/i,o.unshift(e))),n+o.map(s=>String(s).padStart(2,"0")).join(":").replace(/000000\d*$/,"")}var gme={identify:t=>typeof t=="bigint"||Number.isInteger(t),default:!0,tag:"tag:yaml.org,2002:int",format:"TIME",test:/^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+$/,resolve:(t,e,{intAsBigInt:r})=>DT(t,r),stringify:B6},yme={identify:t=>typeof t=="number",default:!0,tag:"tag:yaml.org,2002:float",format:"TIME",test:/^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*$/,resolve:t=>DT(t,!1),stringify:B6},H6={identify:t=>t instanceof Date,default:!0,tag:"tag:yaml.org,2002:timestamp",test:RegExp("^([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})(?:(?:t|T|[ \\t]+)([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2}(\\.[0-9]+)?)(?:[ \\t]*(Z|[-+][012]?[0-9](?::[0-9]{2})?))?)?$"),resolve(t){let e=t.match(H6.test);if(!e)throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");let[,r,n,i,o,s,a]=e.map(Number),c=e[7]?Number((e[7]+"00").substr(1,3)):0,l=Date.UTC(r,n-1,i,o||0,s||0,a||0,c),u=e[8];if(u&&u!=="Z"){let d=DT(u,!1);Math.abs(d)<30&&(d*=60),l-=6e4*d}return new Date(l)},stringify:({value:t})=>t?.toISOString().replace(/(T00:00:00)?\.000Z$/,"")??""};a_.floatTime=yme;a_.intTime=gme;a_.timestamp=H6});var V6=v(Z6=>{"use strict";var _me=nl(),bme=Wy(),vme=il(),Sme=bf(),wme=$T(),G6=L6(),jT=z6(),c_=q6(),xme=zy(),$me=TT(),kme=t_(),Eme=CT(),MT=NT(),Ame=[_me.map,vme.seq,Sme.string,bme.nullTag,G6.trueTag,G6.falseTag,c_.intBin,c_.intOct,c_.int,c_.intHex,jT.floatNaN,jT.floatExp,jT.float,wme.binary,xme.merge,$me.omap,kme.pairs,Eme.set,MT.intTime,MT.floatTime,MT.timestamp];Z6.schema=Ame});var nB=v(zT=>{"use strict";var Y6=nl(),Tme=Wy(),X6=il(),Ome=bf(),Rme=gT(),FT=_T(),LT=vT(),Ime=E6(),Pme=O6(),Q6=$T(),$f=zy(),eB=TT(),tB=t_(),W6=V6(),rB=CT(),l_=NT(),K6=new Map([["core",Ime.schema],["failsafe",[Y6.map,X6.seq,Ome.string]],["json",Pme.schema],["yaml11",W6.schema],["yaml-1.1",W6.schema]]),J6={binary:Q6.binary,bool:Rme.boolTag,float:FT.float,floatExp:FT.floatExp,floatNaN:FT.floatNaN,floatTime:l_.floatTime,int:LT.int,intHex:LT.intHex,intOct:LT.intOct,intTime:l_.intTime,map:Y6.map,merge:$f.merge,null:Tme.nullTag,omap:eB.omap,pairs:tB.pairs,seq:X6.seq,set:rB.set,timestamp:l_.timestamp},Cme={"tag:yaml.org,2002:binary":Q6.binary,"tag:yaml.org,2002:merge":$f.merge,"tag:yaml.org,2002:omap":eB.omap,"tag:yaml.org,2002:pairs":tB.pairs,"tag:yaml.org,2002:set":rB.set,"tag:yaml.org,2002:timestamp":l_.timestamp};function Dme(t,e,r){let n=K6.get(e);if(n&&!t)return r&&!n.includes($f.merge)?n.concat($f.merge):n.slice();let i=n;if(!i)if(Array.isArray(t))i=[];else{let o=Array.from(K6.keys()).filter(s=>s!=="yaml11").map(s=>JSON.stringify(s)).join(", ");throw new Error(`Unknown schema "${e}"; use one of ${o} or define customTags array`)}if(Array.isArray(t))for(let o of t)i=i.concat(o);else typeof t=="function"&&(i=t(i.slice()));return r&&(i=i.concat($f.merge)),i.reduce((o,s)=>{let a=typeof s=="string"?J6[s]:s;if(!a){let c=JSON.stringify(s),l=Object.keys(J6).map(u=>JSON.stringify(u)).join(", ");throw new Error(`Unknown custom tag ${c}; use one of ${l}`)}return o.includes(a)||o.push(a),o},[])}zT.coreKnownTags=Cme;zT.getTags=Dme});var BT=v(iB=>{"use strict";var UT=De(),Nme=nl(),jme=il(),Mme=bf(),u_=nB(),Fme=(t,e)=>t.keye.key?1:0,qT=class t{constructor({compat:e,customTags:r,merge:n,resolveKnownTags:i,schema:o,sortMapEntries:s,toStringDefaults:a}){this.compat=Array.isArray(e)?u_.getTags(e,"compat"):e?u_.getTags(null,e):null,this.name=typeof o=="string"&&o||"core",this.knownTags=i?u_.coreKnownTags:{},this.tags=u_.getTags(r,this.name,n),this.toStringOptions=a??null,Object.defineProperty(this,UT.MAP,{value:Nme.map}),Object.defineProperty(this,UT.SCALAR,{value:Mme.string}),Object.defineProperty(this,UT.SEQ,{value:jme.seq}),this.sortMapEntries=typeof s=="function"?s:s===!0?Fme:null}clone(){let e=Object.create(t.prototype,Object.getOwnPropertyDescriptors(this));return e.tags=this.tags.slice(),e}};iB.Schema=qT});var sB=v(oB=>{"use strict";var Lme=De(),HT=gf(),kf=ff();function zme(t,e){let r=[],n=e.directives===!0;if(e.directives!==!1&&t.directives){let c=t.directives.toString(t);c?(r.push(c),n=!0):t.directives.docStart&&(n=!0)}n&&r.push("---");let i=HT.createStringifyContext(t,e),{commentString:o}=i.options;if(t.commentBefore){r.length!==1&&r.unshift("");let c=o(t.commentBefore);r.unshift(kf.indentComment(c,""))}let s=!1,a=null;if(t.contents){if(Lme.isNode(t.contents)){if(t.contents.spaceBefore&&n&&r.push(""),t.contents.commentBefore){let u=o(t.contents.commentBefore);r.push(kf.indentComment(u,""))}i.forceBlockIndent=!!t.comment,a=t.contents.comment}let c=a?void 0:()=>s=!0,l=HT.stringify(t.contents,i,()=>a=null,c);a&&(l+=kf.lineComment(l,"",o(a))),(l[0]==="|"||l[0]===">")&&r[r.length-1]==="---"?r[r.length-1]=`--- ${l}`:r.push(l)}else r.push(HT.stringify(t.contents,i));if(t.directives?.docEnd)if(t.comment){let c=o(t.comment);c.includes(` +`)?(r.push("..."),r.push(kf.indentComment(c,""))):r.push(`... ${c}`)}else r.push("...");else{let c=t.comment;c&&s&&(c=c.replace(/^\n+/,"")),c&&((!s||a)&&r[r.length-1]!==""&&r.push(""),r.push(kf.indentComment(o(c),"")))}return r.join(` `)+` -`}iB.stringifyDocument=Mme});var kf=v(sB=>{"use strict";var Fme=lf(),sl=Ry(),En=De(),Lme=Jo(),zme=Zo(),Ume=BT(),qme=oB(),GT=Ey(),Bme=KA(),Hme=uf(),ZT=WA(),VT=class t{constructor(e,r,n){this.commentBefore=null,this.comment=null,this.errors=[],this.warnings=[],Object.defineProperty(this,En.NODE_TYPE,{value:En.DOC});let i=null;typeof r=="function"||Array.isArray(r)?i=r:n===void 0&&r&&(n=r,r=void 0);let o=Object.assign({intAsBigInt:!1,keepSourceTokens:!1,logLevel:"warn",prettyErrors:!0,strict:!0,stringKeys:!1,uniqueKeys:!0,version:"1.2"},n);this.options=o;let{version:s}=o;n?._directives?(this.directives=n._directives.atDocument(),this.directives.yaml.explicit&&(s=this.directives.yaml.version)):this.directives=new ZT.Directives({version:s}),this.setSchema(s,n),this.contents=e===void 0?null:this.createNode(e,i,n)}clone(){let e=Object.create(t.prototype,{[En.NODE_TYPE]:{value:En.DOC}});return e.commentBefore=this.commentBefore,e.comment=this.comment,e.errors=this.errors.slice(),e.warnings=this.warnings.slice(),e.options=Object.assign({},this.options),this.directives&&(e.directives=this.directives.clone()),e.schema=this.schema.clone(),e.contents=En.isNode(this.contents)?this.contents.clone(e.schema):this.contents,this.range&&(e.range=this.range.slice()),e}add(e){al(this.contents)&&this.contents.add(e)}addIn(e,r){al(this.contents)&&this.contents.addIn(e,r)}createAlias(e,r){if(!e.anchor){let n=GT.anchorNames(this);e.anchor=!r||n.has(r)?GT.findNewAnchor(r||"a",n):r}return new Fme.Alias(e.anchor)}createNode(e,r,n){let i;if(typeof r=="function")e=r.call({"":e},"",e),i=r;else if(Array.isArray(r)){let g=_=>typeof _=="number"||_ instanceof String||_ instanceof Number,b=r.filter(g).map(String);b.length>0&&(r=r.concat(b)),i=r}else n===void 0&&r&&(n=r,r=void 0);let{aliasDuplicateObjects:o,anchorPrefix:s,flow:a,keepUndefined:c,onTagObj:l,tag:u}=n??{},{onAnchor:d,setAnchors:f,sourceObjects:p}=GT.createNodeAnchors(this,s||"a"),m={aliasDuplicateObjects:o??!0,keepUndefined:c??!1,onAnchor:d,onTagObj:l,replacer:i,schema:this.schema,sourceObjects:p},h=Hme.createNode(e,u,m);return a&&En.isCollection(h)&&(h.flow=!0),f(),h}createPair(e,r,n={}){let i=this.createNode(e,null,n),o=this.createNode(r,null,n);return new Lme.Pair(i,o)}delete(e){return al(this.contents)?this.contents.delete(e):!1}deleteIn(e){return sl.isEmptyPath(e)?this.contents==null?!1:(this.contents=null,!0):al(this.contents)?this.contents.deleteIn(e):!1}get(e,r){return En.isCollection(this.contents)?this.contents.get(e,r):void 0}getIn(e,r){return sl.isEmptyPath(e)?!r&&En.isScalar(this.contents)?this.contents.value:this.contents:En.isCollection(this.contents)?this.contents.getIn(e,r):void 0}has(e){return En.isCollection(this.contents)?this.contents.has(e):!1}hasIn(e){return sl.isEmptyPath(e)?this.contents!==void 0:En.isCollection(this.contents)?this.contents.hasIn(e):!1}set(e,r){this.contents==null?this.contents=sl.collectionFromPath(this.schema,[e],r):al(this.contents)&&this.contents.set(e,r)}setIn(e,r){sl.isEmptyPath(e)?this.contents=r:this.contents==null?this.contents=sl.collectionFromPath(this.schema,Array.from(e),r):al(this.contents)&&this.contents.setIn(e,r)}setSchema(e,r={}){typeof e=="number"&&(e=String(e));let n;switch(e){case"1.1":this.directives?this.directives.yaml.version="1.1":this.directives=new ZT.Directives({version:"1.1"}),n={resolveKnownTags:!1,schema:"yaml-1.1"};break;case"1.2":case"next":this.directives?this.directives.yaml.version=e:this.directives=new ZT.Directives({version:e}),n={resolveKnownTags:!0,schema:"core"};break;case null:this.directives&&delete this.directives,n=null;break;default:{let i=JSON.stringify(e);throw new Error(`Expected '1.1', '1.2' or null as first argument, but found: ${i}`)}}if(r.schema instanceof Object)this.schema=r.schema;else if(n)this.schema=new Ume.Schema(Object.assign(n,r));else throw new Error("With a null YAML version, the { schema: Schema } option is required")}toJS({json:e,jsonArg:r,mapAsMap:n,maxAliasCount:i,onAnchor:o,reviver:s}={}){let a={anchors:new Map,doc:this,keep:!e,mapAsMap:n===!0,mapKeyWarned:!1,maxAliasCount:typeof i=="number"?i:100},c=zme.toJS(this.contents,r??"",a);if(typeof o=="function")for(let{count:l,res:u}of a.anchors.values())o(u,l);return typeof s=="function"?Bme.applyReviver(s,{"":c},"",c):c}toJSON(e,r){return this.toJS({json:!0,jsonArg:e,mapAsMap:!1,onAnchor:r})}toString(e={}){if(this.errors.length>0)throw new Error("Document with errors cannot be stringified");if("indent"in e&&(!Number.isInteger(e.indent)||Number(e.indent)<=0)){let r=JSON.stringify(e.indent);throw new Error(`"indent" option must be a positive integer, not ${r}`)}return qme.stringifyDocument(this,e)}};function al(t){if(En.isCollection(t))return!0;throw new Error("Expected a YAML collection as document contents")}sB.Document=VT});var Tf=v(Af=>{"use strict";var Ef=class extends Error{constructor(e,r,n,i){super(),this.name=e,this.code=n,this.message=i,this.pos=r}},WT=class extends Ef{constructor(e,r,n){super("YAMLParseError",e,r,n)}},KT=class extends Ef{constructor(e,r,n){super("YAMLWarning",e,r,n)}},Gme=(t,e)=>r=>{if(r.pos[0]===-1)return;r.linePos=r.pos.map(a=>e.linePos(a));let{line:n,col:i}=r.linePos[0];r.message+=` at line ${n}, column ${i}`;let o=i-1,s=t.substring(e.lineStarts[n-1],e.lineStarts[n]).replace(/[\n\r]+$/,"");if(o>=60&&s.length>80){let a=Math.min(o-39,s.length-79);s="\u2026"+s.substring(a),o-=a-1}if(s.length>80&&(s=s.substring(0,79)+"\u2026"),n>1&&/^ *$/.test(s.substring(0,o))){let a=t.substring(e.lineStarts[n-2],e.lineStarts[n-1]);a.length>80&&(a=a.substring(0,79)+`\u2026 +`}oB.stringifyDocument=zme});var Ef=v(aB=>{"use strict";var Ume=uf(),sl=Ry(),Tn=De(),qme=Jo(),Bme=Zo(),Hme=BT(),Gme=sB(),GT=Ey(),Zme=KA(),Vme=df(),ZT=WA(),VT=class t{constructor(e,r,n){this.commentBefore=null,this.comment=null,this.errors=[],this.warnings=[],Object.defineProperty(this,Tn.NODE_TYPE,{value:Tn.DOC});let i=null;typeof r=="function"||Array.isArray(r)?i=r:n===void 0&&r&&(n=r,r=void 0);let o=Object.assign({intAsBigInt:!1,keepSourceTokens:!1,logLevel:"warn",prettyErrors:!0,strict:!0,stringKeys:!1,uniqueKeys:!0,version:"1.2"},n);this.options=o;let{version:s}=o;n?._directives?(this.directives=n._directives.atDocument(),this.directives.yaml.explicit&&(s=this.directives.yaml.version)):this.directives=new ZT.Directives({version:s}),this.setSchema(s,n),this.contents=e===void 0?null:this.createNode(e,i,n)}clone(){let e=Object.create(t.prototype,{[Tn.NODE_TYPE]:{value:Tn.DOC}});return e.commentBefore=this.commentBefore,e.comment=this.comment,e.errors=this.errors.slice(),e.warnings=this.warnings.slice(),e.options=Object.assign({},this.options),this.directives&&(e.directives=this.directives.clone()),e.schema=this.schema.clone(),e.contents=Tn.isNode(this.contents)?this.contents.clone(e.schema):this.contents,this.range&&(e.range=this.range.slice()),e}add(e){al(this.contents)&&this.contents.add(e)}addIn(e,r){al(this.contents)&&this.contents.addIn(e,r)}createAlias(e,r){if(!e.anchor){let n=GT.anchorNames(this);e.anchor=!r||n.has(r)?GT.findNewAnchor(r||"a",n):r}return new Ume.Alias(e.anchor)}createNode(e,r,n){let i;if(typeof r=="function")e=r.call({"":e},"",e),i=r;else if(Array.isArray(r)){let g=_=>typeof _=="number"||_ instanceof String||_ instanceof Number,b=r.filter(g).map(String);b.length>0&&(r=r.concat(b)),i=r}else n===void 0&&r&&(n=r,r=void 0);let{aliasDuplicateObjects:o,anchorPrefix:s,flow:a,keepUndefined:c,onTagObj:l,tag:u}=n??{},{onAnchor:d,setAnchors:f,sourceObjects:p}=GT.createNodeAnchors(this,s||"a"),m={aliasDuplicateObjects:o??!0,keepUndefined:c??!1,onAnchor:d,onTagObj:l,replacer:i,schema:this.schema,sourceObjects:p},h=Vme.createNode(e,u,m);return a&&Tn.isCollection(h)&&(h.flow=!0),f(),h}createPair(e,r,n={}){let i=this.createNode(e,null,n),o=this.createNode(r,null,n);return new qme.Pair(i,o)}delete(e){return al(this.contents)?this.contents.delete(e):!1}deleteIn(e){return sl.isEmptyPath(e)?this.contents==null?!1:(this.contents=null,!0):al(this.contents)?this.contents.deleteIn(e):!1}get(e,r){return Tn.isCollection(this.contents)?this.contents.get(e,r):void 0}getIn(e,r){return sl.isEmptyPath(e)?!r&&Tn.isScalar(this.contents)?this.contents.value:this.contents:Tn.isCollection(this.contents)?this.contents.getIn(e,r):void 0}has(e){return Tn.isCollection(this.contents)?this.contents.has(e):!1}hasIn(e){return sl.isEmptyPath(e)?this.contents!==void 0:Tn.isCollection(this.contents)?this.contents.hasIn(e):!1}set(e,r){this.contents==null?this.contents=sl.collectionFromPath(this.schema,[e],r):al(this.contents)&&this.contents.set(e,r)}setIn(e,r){sl.isEmptyPath(e)?this.contents=r:this.contents==null?this.contents=sl.collectionFromPath(this.schema,Array.from(e),r):al(this.contents)&&this.contents.setIn(e,r)}setSchema(e,r={}){typeof e=="number"&&(e=String(e));let n;switch(e){case"1.1":this.directives?this.directives.yaml.version="1.1":this.directives=new ZT.Directives({version:"1.1"}),n={resolveKnownTags:!1,schema:"yaml-1.1"};break;case"1.2":case"next":this.directives?this.directives.yaml.version=e:this.directives=new ZT.Directives({version:e}),n={resolveKnownTags:!0,schema:"core"};break;case null:this.directives&&delete this.directives,n=null;break;default:{let i=JSON.stringify(e);throw new Error(`Expected '1.1', '1.2' or null as first argument, but found: ${i}`)}}if(r.schema instanceof Object)this.schema=r.schema;else if(n)this.schema=new Hme.Schema(Object.assign(n,r));else throw new Error("With a null YAML version, the { schema: Schema } option is required")}toJS({json:e,jsonArg:r,mapAsMap:n,maxAliasCount:i,onAnchor:o,reviver:s}={}){let a={anchors:new Map,doc:this,keep:!e,mapAsMap:n===!0,mapKeyWarned:!1,maxAliasCount:typeof i=="number"?i:100},c=Bme.toJS(this.contents,r??"",a);if(typeof o=="function")for(let{count:l,res:u}of a.anchors.values())o(u,l);return typeof s=="function"?Zme.applyReviver(s,{"":c},"",c):c}toJSON(e,r){return this.toJS({json:!0,jsonArg:e,mapAsMap:!1,onAnchor:r})}toString(e={}){if(this.errors.length>0)throw new Error("Document with errors cannot be stringified");if("indent"in e&&(!Number.isInteger(e.indent)||Number(e.indent)<=0)){let r=JSON.stringify(e.indent);throw new Error(`"indent" option must be a positive integer, not ${r}`)}return Gme.stringifyDocument(this,e)}};function al(t){if(Tn.isCollection(t))return!0;throw new Error("Expected a YAML collection as document contents")}aB.Document=VT});var Of=v(Tf=>{"use strict";var Af=class extends Error{constructor(e,r,n,i){super(),this.name=e,this.code=n,this.message=i,this.pos=r}},WT=class extends Af{constructor(e,r,n){super("YAMLParseError",e,r,n)}},KT=class extends Af{constructor(e,r,n){super("YAMLWarning",e,r,n)}},Wme=(t,e)=>r=>{if(r.pos[0]===-1)return;r.linePos=r.pos.map(a=>e.linePos(a));let{line:n,col:i}=r.linePos[0];r.message+=` at line ${n}, column ${i}`;let o=i-1,s=t.substring(e.lineStarts[n-1],e.lineStarts[n]).replace(/[\n\r]+$/,"");if(o>=60&&s.length>80){let a=Math.min(o-39,s.length-79);s="\u2026"+s.substring(a),o-=a-1}if(s.length>80&&(s=s.substring(0,79)+"\u2026"),n>1&&/^ *$/.test(s.substring(0,o))){let a=t.substring(e.lineStarts[n-2],e.lineStarts[n-1]);a.length>80&&(a=a.substring(0,79)+`\u2026 `),s=a+s}if(/[^ ]/.test(s)){let a=1,c=r.linePos[1];c?.line===n&&c.col>i&&(a=Math.max(1,Math.min(c.col-i,80-o)));let l=" ".repeat(o)+"^".repeat(a);r.message+=`: ${s} ${l} -`}};Af.YAMLError=Ef;Af.YAMLParseError=WT;Af.YAMLWarning=KT;Af.prettifyError=Gme});var Of=v(aB=>{"use strict";function Zme(t,{flow:e,indicator:r,next:n,offset:i,onError:o,parentIndent:s,startOnNewline:a}){let c=!1,l=a,u=a,d="",f="",p=!1,m=!1,h=null,g=null,b=null,_=null,S=null,x=null,w=null;for(let A of t)switch(m&&(A.type!=="space"&&A.type!=="newline"&&A.type!=="comma"&&o(A.offset,"MISSING_CHAR","Tags and anchors must be separated from the next token by white space"),m=!1),h&&(l&&A.type!=="comment"&&A.type!=="newline"&&o(h,"TAB_AS_INDENT","Tabs are not allowed as indentation"),h=null),A.type){case"space":!e&&(r!=="doc-start"||n?.type!=="flow-collection")&&A.source.includes(" ")&&(h=A),u=!0;break;case"comment":{u||o(A,"MISSING_CHAR","Comments must be separated from other tokens by white space characters");let D=A.source.substring(1)||" ";d?d+=f+D:d=D,f="",l=!1;break}case"newline":l?d?d+=A.source:(!x||r!=="seq-item-ind")&&(c=!0):f+=A.source,l=!0,p=!0,(g||b)&&(_=A),u=!0;break;case"anchor":g&&o(A,"MULTIPLE_ANCHORS","A node can have at most one anchor"),A.source.endsWith(":")&&o(A.offset+A.source.length-1,"BAD_ALIAS","Anchor ending in : is ambiguous",!0),g=A,w??(w=A.offset),l=!1,u=!1,m=!0;break;case"tag":{b&&o(A,"MULTIPLE_TAGS","A node can have at most one tag"),b=A,w??(w=A.offset),l=!1,u=!1,m=!0;break}case r:(g||b)&&o(A,"BAD_PROP_ORDER",`Anchors and tags must be after the ${A.source} indicator`),x&&o(A,"UNEXPECTED_TOKEN",`Unexpected ${A.source} in ${e??"collection"}`),x=A,l=r==="seq-item-ind"||r==="explicit-key-ind",u=!1;break;case"comma":if(e){S&&o(A,"UNEXPECTED_TOKEN",`Unexpected , in ${e}`),S=A,l=!1,u=!1;break}default:o(A,"UNEXPECTED_TOKEN",`Unexpected ${A.type} token`),l=!1,u=!1}let O=t[t.length-1],T=O?O.offset+O.source.length:i;return m&&n&&n.type!=="space"&&n.type!=="newline"&&n.type!=="comma"&&(n.type!=="scalar"||n.source!=="")&&o(n.offset,"MISSING_CHAR","Tags and anchors must be separated from the next token by white space"),h&&(l&&h.indent<=s||n?.type==="block-map"||n?.type==="block-seq")&&o(h,"TAB_AS_INDENT","Tabs are not allowed as indentation"),{comma:S,found:x,spaceBefore:c,comment:d,hasNewline:p,anchor:g,tag:b,newlineAfterProp:_,end:T,start:w??T}}aB.resolveProps=Zme});var d_=v(cB=>{"use strict";function JT(t){if(!t)return null;switch(t.type){case"alias":case"scalar":case"double-quoted-scalar":case"single-quoted-scalar":if(t.source.includes(` -`))return!0;if(t.end){for(let e of t.end)if(e.type==="newline")return!0}return!1;case"flow-collection":for(let e of t.items){for(let r of e.start)if(r.type==="newline")return!0;if(e.sep){for(let r of e.sep)if(r.type==="newline")return!0}if(JT(e.key)||JT(e.value))return!0}return!1;default:return!0}}cB.containsNewline=JT});var YT=v(lB=>{"use strict";var Vme=d_();function Wme(t,e,r){if(e?.type==="flow-collection"){let n=e.end[0];n.indent===t&&(n.source==="]"||n.source==="}")&&Vme.containsNewline(e)&&r(n,"BAD_INDENT","Flow end indicator should be more indented than parent",!0)}}lB.flowIndentCheck=Wme});var XT=v(dB=>{"use strict";var uB=De();function Kme(t,e,r){let{uniqueKeys:n}=t.options;if(n===!1)return!1;let i=typeof n=="function"?n:(o,s)=>o===s||uB.isScalar(o)&&uB.isScalar(s)&&o.value===s.value;return e.some(o=>i(o.key,r))}dB.mapIncludes=Kme});var yB=v(gB=>{"use strict";var fB=Jo(),Jme=Xo(),pB=Of(),Yme=d_(),mB=YT(),Xme=XT(),hB="All mapping items must start at the same column";function Qme({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??Jme.YAMLMap,a=new s(r.schema);r.atRoot&&(r.atRoot=!1);let c=n.offset,l=null;for(let u of n.items){let{start:d,key:f,sep:p,value:m}=u,h=pB.resolveProps(d,{indicator:"explicit-key-ind",next:f??p?.[0],offset:c,onError:i,parentIndent:n.indent,startOnNewline:!0}),g=!h.found;if(g){if(f&&(f.type==="block-seq"?i(c,"BLOCK_AS_IMPLICIT_KEY","A block sequence may not be used as an implicit map key"):"indent"in f&&f.indent!==n.indent&&i(c,"BAD_INDENT",hB)),!h.anchor&&!h.tag&&!p){l=h.end,h.comment&&(a.comment?a.comment+=` -`+h.comment:a.comment=h.comment);continue}(h.newlineAfterProp||Yme.containsNewline(f))&&i(f??d[d.length-1],"MULTILINE_IMPLICIT_KEY","Implicit keys need to be on a single line")}else h.found?.indent!==n.indent&&i(c,"BAD_INDENT",hB);r.atKey=!0;let b=h.end,_=f?t(r,f,h,i):e(r,b,d,null,h,i);r.schema.compat&&mB.flowIndentCheck(n.indent,f,i),r.atKey=!1,Xme.mapIncludes(r,a.items,_)&&i(b,"DUPLICATE_KEY","Map keys must be unique");let S=pB.resolveProps(p??[],{indicator:"map-value-ind",next:m,offset:_.range[2],onError:i,parentIndent:n.indent,startOnNewline:!f||f.type==="block-scalar"});if(c=S.end,S.found){g&&(m?.type==="block-map"&&!S.hasNewline&&i(c,"BLOCK_AS_IMPLICIT_KEY","Nested mappings are not allowed in compact mappings"),r.options.strict&&h.start{"use strict";var ehe=Qo(),the=Of(),rhe=YT();function nhe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??ehe.YAMLSeq,a=new s(r.schema);r.atRoot&&(r.atRoot=!1),r.atKey&&(r.atKey=!1);let c=n.offset,l=null;for(let{start:u,value:d}of n.items){let f=the.resolveProps(u,{indicator:"seq-item-ind",next:d,offset:c,onError:i,parentIndent:n.indent,startOnNewline:!0});if(!f.found)if(f.anchor||f.tag||d)d?.type==="block-seq"?i(f.end,"BAD_INDENT","All sequence items must start at the same column"):i(c,"MISSING_CHAR","Sequence item without - indicator");else{l=f.end,f.comment&&(a.comment=f.comment);continue}let p=d?t(r,d,f,i):e(r,f.end,u,null,f,i);r.schema.compat&&rhe.flowIndentCheck(n.indent,d,i),c=p.range[2],a.items.push(p)}return a.range=[n.offset,c,l??c],a}_B.resolveBlockSeq=nhe});var cl=v(vB=>{"use strict";function ihe(t,e,r,n){let i="";if(t){let o=!1,s="";for(let a of t){let{source:c,type:l}=a;switch(l){case"space":o=!0;break;case"comment":{r&&!o&&n(a,"MISSING_CHAR","Comments must be separated from other tokens by white space characters");let u=c.substring(1)||" ";i?i+=s+u:i=u,s="";break}case"newline":i&&(s+=c),o=!0;break;default:n(a,"UNEXPECTED_TOKEN",`Unexpected ${l} at node end`)}e+=c.length}}return{comment:i,offset:e}}vB.resolveEnd=ihe});var $B=v(xB=>{"use strict";var ohe=De(),she=Jo(),SB=Xo(),ahe=Qo(),che=cl(),wB=Of(),lhe=d_(),uhe=XT(),QT="Block collections are not allowed within flow collections",eO=t=>t&&(t.type==="block-map"||t.type==="block-seq");function dhe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=n.start.source==="{",a=s?"flow map":"flow sequence",c=o?.nodeClass??(s?SB.YAMLMap:ahe.YAMLSeq),l=new c(r.schema);l.flow=!0;let u=r.atRoot;u&&(r.atRoot=!1),r.atKey&&(r.atKey=!1);let d=n.offset+n.start.source.length;for(let g=0;g0){let g=che.resolveEnd(m,h,r.options.strict,i);g.comment&&(l.comment?l.comment+=` -`+g.comment:l.comment=g.comment),l.range=[n.offset,h,g.offset]}else l.range=[n.offset,h,h];return l}xB.resolveFlowCollection=dhe});var EB=v(kB=>{"use strict";var fhe=De(),phe=Dt(),mhe=Xo(),hhe=Qo(),ghe=yB(),yhe=bB(),_he=$B();function tO(t,e,r,n,i,o){let s=r.type==="block-map"?ghe.resolveBlockMap(t,e,r,n,o):r.type==="block-seq"?yhe.resolveBlockSeq(t,e,r,n,o):_he.resolveFlowCollection(t,e,r,n,o),a=s.constructor;return i==="!"||i===a.tagName?(s.tag=a.tagName,s):(i&&(s.tag=i),s)}function bhe(t,e,r,n,i){let o=n.tag,s=o?e.directives.tagName(o.source,f=>i(o,"TAG_RESOLVE_FAILED",f)):null;if(r.type==="block-seq"){let{anchor:f,newlineAfterProp:p}=n,m=f&&o?f.offset>o.offset?f:o:f??o;m&&(!p||p.offsetf.tag===s&&f.collection===a);if(!c){let f=e.schema.knownTags[s];if(f?.collection===a)e.schema.tags.push(Object.assign({},f,{default:!1})),c=f;else return f?i(o,"BAD_COLLECTION_TYPE",`${f.tag} used for ${a} collection, but expects ${f.collection??"scalar"}`,!0):i(o,"TAG_RESOLVE_FAILED",`Unresolved tag: ${s}`,!0),tO(t,e,r,i,s)}let l=tO(t,e,r,i,s,c),u=c.resolve?.(l,f=>i(o,"TAG_RESOLVE_FAILED",f),e.options)??l,d=fhe.isNode(u)?u:new phe.Scalar(u);return d.range=l.range,d.tag=s,c?.format&&(d.format=c.format),d}kB.composeCollection=bhe});var nO=v(AB=>{"use strict";var rO=Dt();function vhe(t,e,r){let n=e.offset,i=She(e,t.options.strict,r);if(!i)return{value:"",type:null,comment:"",range:[n,n,n]};let o=i.mode===">"?rO.Scalar.BLOCK_FOLDED:rO.Scalar.BLOCK_LITERAL,s=e.source?whe(e.source):[],a=s.length;for(let h=s.length-1;h>=0;--h){let g=s[h][1];if(g===""||g==="\r")a=h;else break}if(a===0){let h=i.chomp==="+"&&s.length>0?` +`}};Tf.YAMLError=Af;Tf.YAMLParseError=WT;Tf.YAMLWarning=KT;Tf.prettifyError=Wme});var Rf=v(cB=>{"use strict";function Kme(t,{flow:e,indicator:r,next:n,offset:i,onError:o,parentIndent:s,startOnNewline:a}){let c=!1,l=a,u=a,d="",f="",p=!1,m=!1,h=null,g=null,b=null,_=null,S=null,x=null,w=null;for(let A of t)switch(m&&(A.type!=="space"&&A.type!=="newline"&&A.type!=="comma"&&o(A.offset,"MISSING_CHAR","Tags and anchors must be separated from the next token by white space"),m=!1),h&&(l&&A.type!=="comment"&&A.type!=="newline"&&o(h,"TAB_AS_INDENT","Tabs are not allowed as indentation"),h=null),A.type){case"space":!e&&(r!=="doc-start"||n?.type!=="flow-collection")&&A.source.includes(" ")&&(h=A),u=!0;break;case"comment":{u||o(A,"MISSING_CHAR","Comments must be separated from other tokens by white space characters");let D=A.source.substring(1)||" ";d?d+=f+D:d=D,f="",l=!1;break}case"newline":l?d?d+=A.source:(!x||r!=="seq-item-ind")&&(c=!0):f+=A.source,l=!0,p=!0,(g||b)&&(_=A),u=!0;break;case"anchor":g&&o(A,"MULTIPLE_ANCHORS","A node can have at most one anchor"),A.source.endsWith(":")&&o(A.offset+A.source.length-1,"BAD_ALIAS","Anchor ending in : is ambiguous",!0),g=A,w??(w=A.offset),l=!1,u=!1,m=!0;break;case"tag":{b&&o(A,"MULTIPLE_TAGS","A node can have at most one tag"),b=A,w??(w=A.offset),l=!1,u=!1,m=!0;break}case r:(g||b)&&o(A,"BAD_PROP_ORDER",`Anchors and tags must be after the ${A.source} indicator`),x&&o(A,"UNEXPECTED_TOKEN",`Unexpected ${A.source} in ${e??"collection"}`),x=A,l=r==="seq-item-ind"||r==="explicit-key-ind",u=!1;break;case"comma":if(e){S&&o(A,"UNEXPECTED_TOKEN",`Unexpected , in ${e}`),S=A,l=!1,u=!1;break}default:o(A,"UNEXPECTED_TOKEN",`Unexpected ${A.type} token`),l=!1,u=!1}let O=t[t.length-1],T=O?O.offset+O.source.length:i;return m&&n&&n.type!=="space"&&n.type!=="newline"&&n.type!=="comma"&&(n.type!=="scalar"||n.source!=="")&&o(n.offset,"MISSING_CHAR","Tags and anchors must be separated from the next token by white space"),h&&(l&&h.indent<=s||n?.type==="block-map"||n?.type==="block-seq")&&o(h,"TAB_AS_INDENT","Tabs are not allowed as indentation"),{comma:S,found:x,spaceBefore:c,comment:d,hasNewline:p,anchor:g,tag:b,newlineAfterProp:_,end:T,start:w??T}}cB.resolveProps=Kme});var d_=v(lB=>{"use strict";function JT(t){if(!t)return null;switch(t.type){case"alias":case"scalar":case"double-quoted-scalar":case"single-quoted-scalar":if(t.source.includes(` +`))return!0;if(t.end){for(let e of t.end)if(e.type==="newline")return!0}return!1;case"flow-collection":for(let e of t.items){for(let r of e.start)if(r.type==="newline")return!0;if(e.sep){for(let r of e.sep)if(r.type==="newline")return!0}if(JT(e.key)||JT(e.value))return!0}return!1;default:return!0}}lB.containsNewline=JT});var YT=v(uB=>{"use strict";var Jme=d_();function Yme(t,e,r){if(e?.type==="flow-collection"){let n=e.end[0];n.indent===t&&(n.source==="]"||n.source==="}")&&Jme.containsNewline(e)&&r(n,"BAD_INDENT","Flow end indicator should be more indented than parent",!0)}}uB.flowIndentCheck=Yme});var XT=v(fB=>{"use strict";var dB=De();function Xme(t,e,r){let{uniqueKeys:n}=t.options;if(n===!1)return!1;let i=typeof n=="function"?n:(o,s)=>o===s||dB.isScalar(o)&&dB.isScalar(s)&&o.value===s.value;return e.some(o=>i(o.key,r))}fB.mapIncludes=Xme});var _B=v(yB=>{"use strict";var pB=Jo(),Qme=Xo(),mB=Rf(),ehe=d_(),hB=YT(),the=XT(),gB="All mapping items must start at the same column";function rhe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??Qme.YAMLMap,a=new s(r.schema);r.atRoot&&(r.atRoot=!1);let c=n.offset,l=null;for(let u of n.items){let{start:d,key:f,sep:p,value:m}=u,h=mB.resolveProps(d,{indicator:"explicit-key-ind",next:f??p?.[0],offset:c,onError:i,parentIndent:n.indent,startOnNewline:!0}),g=!h.found;if(g){if(f&&(f.type==="block-seq"?i(c,"BLOCK_AS_IMPLICIT_KEY","A block sequence may not be used as an implicit map key"):"indent"in f&&f.indent!==n.indent&&i(c,"BAD_INDENT",gB)),!h.anchor&&!h.tag&&!p){l=h.end,h.comment&&(a.comment?a.comment+=` +`+h.comment:a.comment=h.comment);continue}(h.newlineAfterProp||ehe.containsNewline(f))&&i(f??d[d.length-1],"MULTILINE_IMPLICIT_KEY","Implicit keys need to be on a single line")}else h.found?.indent!==n.indent&&i(c,"BAD_INDENT",gB);r.atKey=!0;let b=h.end,_=f?t(r,f,h,i):e(r,b,d,null,h,i);r.schema.compat&&hB.flowIndentCheck(n.indent,f,i),r.atKey=!1,the.mapIncludes(r,a.items,_)&&i(b,"DUPLICATE_KEY","Map keys must be unique");let S=mB.resolveProps(p??[],{indicator:"map-value-ind",next:m,offset:_.range[2],onError:i,parentIndent:n.indent,startOnNewline:!f||f.type==="block-scalar"});if(c=S.end,S.found){g&&(m?.type==="block-map"&&!S.hasNewline&&i(c,"BLOCK_AS_IMPLICIT_KEY","Nested mappings are not allowed in compact mappings"),r.options.strict&&h.start{"use strict";var nhe=Qo(),ihe=Rf(),ohe=YT();function she({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??nhe.YAMLSeq,a=new s(r.schema);r.atRoot&&(r.atRoot=!1),r.atKey&&(r.atKey=!1);let c=n.offset,l=null;for(let{start:u,value:d}of n.items){let f=ihe.resolveProps(u,{indicator:"seq-item-ind",next:d,offset:c,onError:i,parentIndent:n.indent,startOnNewline:!0});if(!f.found)if(f.anchor||f.tag||d)d?.type==="block-seq"?i(f.end,"BAD_INDENT","All sequence items must start at the same column"):i(c,"MISSING_CHAR","Sequence item without - indicator");else{l=f.end,f.comment&&(a.comment=f.comment);continue}let p=d?t(r,d,f,i):e(r,f.end,u,null,f,i);r.schema.compat&&ohe.flowIndentCheck(n.indent,d,i),c=p.range[2],a.items.push(p)}return a.range=[n.offset,c,l??c],a}bB.resolveBlockSeq=she});var cl=v(SB=>{"use strict";function ahe(t,e,r,n){let i="";if(t){let o=!1,s="";for(let a of t){let{source:c,type:l}=a;switch(l){case"space":o=!0;break;case"comment":{r&&!o&&n(a,"MISSING_CHAR","Comments must be separated from other tokens by white space characters");let u=c.substring(1)||" ";i?i+=s+u:i=u,s="";break}case"newline":i&&(s+=c),o=!0;break;default:n(a,"UNEXPECTED_TOKEN",`Unexpected ${l} at node end`)}e+=c.length}}return{comment:i,offset:e}}SB.resolveEnd=ahe});var kB=v($B=>{"use strict";var che=De(),lhe=Jo(),wB=Xo(),uhe=Qo(),dhe=cl(),xB=Rf(),fhe=d_(),phe=XT(),QT="Block collections are not allowed within flow collections",eO=t=>t&&(t.type==="block-map"||t.type==="block-seq");function mhe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=n.start.source==="{",a=s?"flow map":"flow sequence",c=o?.nodeClass??(s?wB.YAMLMap:uhe.YAMLSeq),l=new c(r.schema);l.flow=!0;let u=r.atRoot;u&&(r.atRoot=!1),r.atKey&&(r.atKey=!1);let d=n.offset+n.start.source.length;for(let g=0;g0){let g=dhe.resolveEnd(m,h,r.options.strict,i);g.comment&&(l.comment?l.comment+=` +`+g.comment:l.comment=g.comment),l.range=[n.offset,h,g.offset]}else l.range=[n.offset,h,h];return l}$B.resolveFlowCollection=mhe});var AB=v(EB=>{"use strict";var hhe=De(),ghe=Dt(),yhe=Xo(),_he=Qo(),bhe=_B(),vhe=vB(),She=kB();function tO(t,e,r,n,i,o){let s=r.type==="block-map"?bhe.resolveBlockMap(t,e,r,n,o):r.type==="block-seq"?vhe.resolveBlockSeq(t,e,r,n,o):She.resolveFlowCollection(t,e,r,n,o),a=s.constructor;return i==="!"||i===a.tagName?(s.tag=a.tagName,s):(i&&(s.tag=i),s)}function whe(t,e,r,n,i){let o=n.tag,s=o?e.directives.tagName(o.source,f=>i(o,"TAG_RESOLVE_FAILED",f)):null;if(r.type==="block-seq"){let{anchor:f,newlineAfterProp:p}=n,m=f&&o?f.offset>o.offset?f:o:f??o;m&&(!p||p.offsetf.tag===s&&f.collection===a);if(!c){let f=e.schema.knownTags[s];if(f?.collection===a)e.schema.tags.push(Object.assign({},f,{default:!1})),c=f;else return f?i(o,"BAD_COLLECTION_TYPE",`${f.tag} used for ${a} collection, but expects ${f.collection??"scalar"}`,!0):i(o,"TAG_RESOLVE_FAILED",`Unresolved tag: ${s}`,!0),tO(t,e,r,i,s)}let l=tO(t,e,r,i,s,c),u=c.resolve?.(l,f=>i(o,"TAG_RESOLVE_FAILED",f),e.options)??l,d=hhe.isNode(u)?u:new ghe.Scalar(u);return d.range=l.range,d.tag=s,c?.format&&(d.format=c.format),d}EB.composeCollection=whe});var nO=v(TB=>{"use strict";var rO=Dt();function xhe(t,e,r){let n=e.offset,i=$he(e,t.options.strict,r);if(!i)return{value:"",type:null,comment:"",range:[n,n,n]};let o=i.mode===">"?rO.Scalar.BLOCK_FOLDED:rO.Scalar.BLOCK_LITERAL,s=e.source?khe(e.source):[],a=s.length;for(let h=s.length-1;h>=0;--h){let g=s[h][1];if(g===""||g==="\r")a=h;else break}if(a===0){let h=i.chomp==="+"&&s.length>0?` `.repeat(Math.max(1,s.length-1)):"",g=n+i.length;return e.source&&(g+=e.source.length),{value:h,type:o,comment:i.comment,range:[n,g,g]}}let c=e.indent+i.indent,l=e.offset+i.length,u=0;for(let h=0;hc&&(c=g.length);else{g.length=a;--h)s[h][0].length>c&&(a=h+1);let d="",f="",p=!1;for(let h=0;hc||b[0]===" "?(f===" "?f=` @@ -112,91 +112,91 @@ ${l} `+s[h][0].slice(c);d[d.length-1]!==` `&&(d+=` `);break;default:d+=` -`}let m=n+i.length+e.source.length;return{value:d,type:o,comment:i.comment,range:[n,m,m]}}function She({offset:t,props:e},r,n){if(e[0].type!=="block-scalar-header")return n(e[0],"IMPOSSIBLE","Block scalar header not found"),null;let{source:i}=e[0],o=i[0],s=0,a="",c=-1;for(let f=1;f{"use strict";var iO=Dt(),xhe=cl();function $he(t,e,r){let{offset:n,type:i,source:o,end:s}=t,a,c,l=(f,p,m)=>r(n+f,p,m);switch(i){case"scalar":a=iO.Scalar.PLAIN,c=khe(o,l);break;case"single-quoted-scalar":a=iO.Scalar.QUOTE_SINGLE,c=Ehe(o,l);break;case"double-quoted-scalar":a=iO.Scalar.QUOTE_DOUBLE,c=Ahe(o,l);break;default:return r(t,"UNEXPECTED_TOKEN",`Expected a flow scalar value, but found: ${i}`),{value:"",type:null,comment:"",range:[n,n+o.length,n+o.length]}}let u=n+o.length,d=xhe.resolveEnd(s,u,e,r);return{value:c,type:a,comment:d.comment,range:[n,u,d.offset]}}function khe(t,e){let r="";switch(t[0]){case" ":r="a tab character";break;case",":r="flow indicator character ,";break;case"%":r="directive indicator character %";break;case"|":case">":{r=`block scalar indicator ${t[0]}`;break}case"@":case"`":{r=`reserved character ${t[0]}`;break}}return r&&e(0,"BAD_SCALAR_START",`Plain value cannot start with ${r}`),TB(t)}function Ehe(t,e){return(t[t.length-1]!=="'"||t.length===1)&&e(t.length,"MISSING_CHAR","Missing closing 'quote"),TB(t.slice(1,-1)).replace(/''/g,"'")}function TB(t){let e,r;try{e=new RegExp(`(.*?)(?{"use strict";var iO=Dt(),Ehe=cl();function Ahe(t,e,r){let{offset:n,type:i,source:o,end:s}=t,a,c,l=(f,p,m)=>r(n+f,p,m);switch(i){case"scalar":a=iO.Scalar.PLAIN,c=The(o,l);break;case"single-quoted-scalar":a=iO.Scalar.QUOTE_SINGLE,c=Ohe(o,l);break;case"double-quoted-scalar":a=iO.Scalar.QUOTE_DOUBLE,c=Rhe(o,l);break;default:return r(t,"UNEXPECTED_TOKEN",`Expected a flow scalar value, but found: ${i}`),{value:"",type:null,comment:"",range:[n,n+o.length,n+o.length]}}let u=n+o.length,d=Ehe.resolveEnd(s,u,e,r);return{value:c,type:a,comment:d.comment,range:[n,u,d.offset]}}function The(t,e){let r="";switch(t[0]){case" ":r="a tab character";break;case",":r="flow indicator character ,";break;case"%":r="directive indicator character %";break;case"|":case">":{r=`block scalar indicator ${t[0]}`;break}case"@":case"`":{r=`reserved character ${t[0]}`;break}}return r&&e(0,"BAD_SCALAR_START",`Plain value cannot start with ${r}`),OB(t)}function Ohe(t,e){return(t[t.length-1]!=="'"||t.length===1)&&e(t.length,"MISSING_CHAR","Missing closing 'quote"),OB(t.slice(1,-1)).replace(/''/g,"'")}function OB(t){let e,r;try{e=new RegExp(`(.*?)(?o?t.slice(o,n+1):i)}else r+=i}return(t[t.length-1]!=='"'||t.length===1)&&e(t.length,"MISSING_CHAR",'Missing closing "quote'),r}function The(t,e){let r="",n=t[e+1];for(;(n===" "||n===" "||n===` +`)&&(r+=n>o?t.slice(o,n+1):i)}else r+=i}return(t[t.length-1]!=='"'||t.length===1)&&e(t.length,"MISSING_CHAR",'Missing closing "quote'),r}function Ihe(t,e){let r="",n=t[e+1];for(;(n===" "||n===" "||n===` `||n==="\r")&&!(n==="\r"&&t[e+2]!==` `);)n===` `&&(r+=` -`),e+=1,n=t[e+1];return r||(r=" "),{fold:r,offset:e}}var Ohe={0:"\0",a:"\x07",b:"\b",e:"\x1B",f:"\f",n:` -`,r:"\r",t:" ",v:"\v",N:"\x85",_:"\xA0",L:"\u2028",P:"\u2029"," ":" ",'"':'"',"/":"/","\\":"\\"," ":" "};function Rhe(t,e,r,n){let i=t.substr(e,r),s=i.length===r&&/^[0-9a-fA-F]+$/.test(i)?parseInt(i,16):NaN;try{return String.fromCodePoint(s)}catch{let a=t.substr(e-2,r+2);return n(e-2,"BAD_DQ_ESCAPE",`Invalid escape sequence ${a}`),a}}OB.resolveFlowScalar=$he});var PB=v(IB=>{"use strict";var ha=De(),RB=Dt(),Ihe=nO(),Phe=oO();function Che(t,e,r,n){let{value:i,type:o,comment:s,range:a}=e.type==="block-scalar"?Ihe.resolveBlockScalar(t,e,n):Phe.resolveFlowScalar(e,t.options.strict,n),c=r?t.directives.tagName(r.source,d=>n(r,"TAG_RESOLVE_FAILED",d)):null,l;t.options.stringKeys&&t.atKey?l=t.schema[ha.SCALAR]:c?l=Dhe(t.schema,i,c,r,n):e.type==="scalar"?l=Nhe(t,i,e,n):l=t.schema[ha.SCALAR];let u;try{let d=l.resolve(i,f=>n(r??e,"TAG_RESOLVE_FAILED",f),t.options);u=ha.isScalar(d)?d:new RB.Scalar(d)}catch(d){let f=d instanceof Error?d.message:String(d);n(r??e,"TAG_RESOLVE_FAILED",f),u=new RB.Scalar(i)}return u.range=a,u.source=i,o&&(u.type=o),c&&(u.tag=c),l.format&&(u.format=l.format),s&&(u.comment=s),u}function Dhe(t,e,r,n,i){if(r==="!")return t[ha.SCALAR];let o=[];for(let a of t.tags)if(!a.collection&&a.tag===r)if(a.default&&a.test)o.push(a);else return a;for(let a of o)if(a.test?.test(e))return a;let s=t.knownTags[r];return s&&!s.collection?(t.tags.push(Object.assign({},s,{default:!1,test:void 0})),s):(i(n,"TAG_RESOLVE_FAILED",`Unresolved tag: ${r}`,r!=="tag:yaml.org,2002:str"),t[ha.SCALAR])}function Nhe({atKey:t,directives:e,schema:r},n,i,o){let s=r.tags.find(a=>(a.default===!0||t&&a.default==="key")&&a.test?.test(n))||r[ha.SCALAR];if(r.compat){let a=r.compat.find(c=>c.default&&c.test?.test(n))??r[ha.SCALAR];if(s.tag!==a.tag){let c=e.tagString(s.tag),l=e.tagString(a.tag),u=`Value may be parsed as either ${c} or ${l}`;o(i,"TAG_RESOLVE_FAILED",u,!0)}}return s}IB.composeScalar=Che});var DB=v(CB=>{"use strict";function jhe(t,e,r){if(e){r??(r=e.length);for(let n=r-1;n>=0;--n){let i=e[n];switch(i.type){case"space":case"comment":case"newline":t-=i.source.length;continue}for(i=e[++n];i?.type==="space";)t+=i.source.length,i=e[++n];break}}return t}CB.emptyScalarPosition=jhe});var MB=v(aO=>{"use strict";var Mhe=lf(),Fhe=De(),Lhe=EB(),NB=PB(),zhe=cl(),Uhe=DB(),qhe={composeNode:jB,composeEmptyNode:sO};function jB(t,e,r,n){let i=t.atKey,{spaceBefore:o,comment:s,anchor:a,tag:c}=r,l,u=!0;switch(e.type){case"alias":l=Bhe(t,e,n),(a||c)&&n(e,"ALIAS_PROPS","An alias node must not specify any properties");break;case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":case"block-scalar":l=NB.composeScalar(t,e,c,n),a&&(l.anchor=a.source.substring(1));break;case"block-map":case"block-seq":case"flow-collection":try{l=Lhe.composeCollection(qhe,t,e,r,n),a&&(l.anchor=a.source.substring(1))}catch(d){let f=d instanceof Error?d.message:String(d);n(e,"RESOURCE_EXHAUSTION",f)}break;default:{let d=e.type==="error"?e.message:`Unsupported token (type: ${e.type})`;n(e,"UNEXPECTED_TOKEN",d),u=!1}}return l??(l=sO(t,e.offset,void 0,null,r,n)),a&&l.anchor===""&&n(a,"BAD_ALIAS","Anchor cannot be an empty string"),i&&t.options.stringKeys&&(!Fhe.isScalar(l)||typeof l.value!="string"||l.tag&&l.tag!=="tag:yaml.org,2002:str")&&n(c??e,"NON_STRING_KEY","With stringKeys, all keys must be strings"),o&&(l.spaceBefore=!0),s&&(e.type==="scalar"&&e.source===""?l.comment=s:l.commentBefore=s),t.options.keepSourceTokens&&u&&(l.srcToken=e),l}function sO(t,e,r,n,{spaceBefore:i,comment:o,anchor:s,tag:a,end:c},l){let u={type:"scalar",offset:Uhe.emptyScalarPosition(e,r,n),indent:-1,source:""},d=NB.composeScalar(t,u,a,l);return s&&(d.anchor=s.source.substring(1),d.anchor===""&&l(s,"BAD_ALIAS","Anchor cannot be an empty string")),i&&(d.spaceBefore=!0),o&&(d.comment=o,d.range[2]=c),d}function Bhe({options:t},{offset:e,source:r,end:n},i){let o=new Mhe.Alias(r.substring(1));o.source===""&&i(e,"BAD_ALIAS","Alias cannot be an empty string"),o.source.endsWith(":")&&i(e+r.length-1,"BAD_ALIAS","Alias ending in : is ambiguous",!0);let s=e+r.length,a=zhe.resolveEnd(n,s,t.strict,i);return o.range=[e,s,a.offset],a.comment&&(o.comment=a.comment),o}aO.composeEmptyNode=sO;aO.composeNode=jB});var zB=v(LB=>{"use strict";var Hhe=kf(),FB=MB(),Ghe=cl(),Zhe=Of();function Vhe(t,e,{offset:r,start:n,value:i,end:o},s){let a=Object.assign({_directives:e},t),c=new Hhe.Document(void 0,a),l={atKey:!1,atRoot:!0,directives:c.directives,options:c.options,schema:c.schema},u=Zhe.resolveProps(n,{indicator:"doc-start",next:i??o?.[0],offset:r,onError:s,parentIndent:0,startOnNewline:!0});u.found&&(c.directives.docStart=!0,i&&(i.type==="block-map"||i.type==="block-seq")&&!u.hasNewline&&s(u.end,"MISSING_CHAR","Block collection cannot start on same line with directives-end marker")),c.contents=i?FB.composeNode(l,i,u,s):FB.composeEmptyNode(l,u.end,n,null,u,s);let d=c.contents.range[2],f=Ghe.resolveEnd(o,d,!1,s);return f.comment&&(c.comment=f.comment),c.range=[r,d,f.offset],c}LB.composeDoc=Vhe});var lO=v(BB=>{"use strict";var Whe=Ge("process"),Khe=WA(),Jhe=kf(),Rf=Tf(),UB=De(),Yhe=zB(),Xhe=cl();function If(t){if(typeof t=="number")return[t,t+1];if(Array.isArray(t))return t.length===2?t:[t[0],t[1]];let{offset:e,source:r}=t;return[e,e+(typeof r=="string"?r.length:1)]}function qB(t){let e="",r=!1,n=!1;for(let i=0;i{"use strict";var ha=De(),IB=Dt(),Dhe=nO(),Nhe=oO();function jhe(t,e,r,n){let{value:i,type:o,comment:s,range:a}=e.type==="block-scalar"?Dhe.resolveBlockScalar(t,e,n):Nhe.resolveFlowScalar(e,t.options.strict,n),c=r?t.directives.tagName(r.source,d=>n(r,"TAG_RESOLVE_FAILED",d)):null,l;t.options.stringKeys&&t.atKey?l=t.schema[ha.SCALAR]:c?l=Mhe(t.schema,i,c,r,n):e.type==="scalar"?l=Fhe(t,i,e,n):l=t.schema[ha.SCALAR];let u;try{let d=l.resolve(i,f=>n(r??e,"TAG_RESOLVE_FAILED",f),t.options);u=ha.isScalar(d)?d:new IB.Scalar(d)}catch(d){let f=d instanceof Error?d.message:String(d);n(r??e,"TAG_RESOLVE_FAILED",f),u=new IB.Scalar(i)}return u.range=a,u.source=i,o&&(u.type=o),c&&(u.tag=c),l.format&&(u.format=l.format),s&&(u.comment=s),u}function Mhe(t,e,r,n,i){if(r==="!")return t[ha.SCALAR];let o=[];for(let a of t.tags)if(!a.collection&&a.tag===r)if(a.default&&a.test)o.push(a);else return a;for(let a of o)if(a.test?.test(e))return a;let s=t.knownTags[r];return s&&!s.collection?(t.tags.push(Object.assign({},s,{default:!1,test:void 0})),s):(i(n,"TAG_RESOLVE_FAILED",`Unresolved tag: ${r}`,r!=="tag:yaml.org,2002:str"),t[ha.SCALAR])}function Fhe({atKey:t,directives:e,schema:r},n,i,o){let s=r.tags.find(a=>(a.default===!0||t&&a.default==="key")&&a.test?.test(n))||r[ha.SCALAR];if(r.compat){let a=r.compat.find(c=>c.default&&c.test?.test(n))??r[ha.SCALAR];if(s.tag!==a.tag){let c=e.tagString(s.tag),l=e.tagString(a.tag),u=`Value may be parsed as either ${c} or ${l}`;o(i,"TAG_RESOLVE_FAILED",u,!0)}}return s}PB.composeScalar=jhe});var NB=v(DB=>{"use strict";function Lhe(t,e,r){if(e){r??(r=e.length);for(let n=r-1;n>=0;--n){let i=e[n];switch(i.type){case"space":case"comment":case"newline":t-=i.source.length;continue}for(i=e[++n];i?.type==="space";)t+=i.source.length,i=e[++n];break}}return t}DB.emptyScalarPosition=Lhe});var FB=v(aO=>{"use strict";var zhe=uf(),Uhe=De(),qhe=AB(),jB=CB(),Bhe=cl(),Hhe=NB(),Ghe={composeNode:MB,composeEmptyNode:sO};function MB(t,e,r,n){let i=t.atKey,{spaceBefore:o,comment:s,anchor:a,tag:c}=r,l,u=!0;switch(e.type){case"alias":l=Zhe(t,e,n),(a||c)&&n(e,"ALIAS_PROPS","An alias node must not specify any properties");break;case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":case"block-scalar":l=jB.composeScalar(t,e,c,n),a&&(l.anchor=a.source.substring(1));break;case"block-map":case"block-seq":case"flow-collection":try{l=qhe.composeCollection(Ghe,t,e,r,n),a&&(l.anchor=a.source.substring(1))}catch(d){let f=d instanceof Error?d.message:String(d);n(e,"RESOURCE_EXHAUSTION",f)}break;default:{let d=e.type==="error"?e.message:`Unsupported token (type: ${e.type})`;n(e,"UNEXPECTED_TOKEN",d),u=!1}}return l??(l=sO(t,e.offset,void 0,null,r,n)),a&&l.anchor===""&&n(a,"BAD_ALIAS","Anchor cannot be an empty string"),i&&t.options.stringKeys&&(!Uhe.isScalar(l)||typeof l.value!="string"||l.tag&&l.tag!=="tag:yaml.org,2002:str")&&n(c??e,"NON_STRING_KEY","With stringKeys, all keys must be strings"),o&&(l.spaceBefore=!0),s&&(e.type==="scalar"&&e.source===""?l.comment=s:l.commentBefore=s),t.options.keepSourceTokens&&u&&(l.srcToken=e),l}function sO(t,e,r,n,{spaceBefore:i,comment:o,anchor:s,tag:a,end:c},l){let u={type:"scalar",offset:Hhe.emptyScalarPosition(e,r,n),indent:-1,source:""},d=jB.composeScalar(t,u,a,l);return s&&(d.anchor=s.source.substring(1),d.anchor===""&&l(s,"BAD_ALIAS","Anchor cannot be an empty string")),i&&(d.spaceBefore=!0),o&&(d.comment=o,d.range[2]=c),d}function Zhe({options:t},{offset:e,source:r,end:n},i){let o=new zhe.Alias(r.substring(1));o.source===""&&i(e,"BAD_ALIAS","Alias cannot be an empty string"),o.source.endsWith(":")&&i(e+r.length-1,"BAD_ALIAS","Alias ending in : is ambiguous",!0);let s=e+r.length,a=Bhe.resolveEnd(n,s,t.strict,i);return o.range=[e,s,a.offset],a.comment&&(o.comment=a.comment),o}aO.composeEmptyNode=sO;aO.composeNode=MB});var UB=v(zB=>{"use strict";var Vhe=Ef(),LB=FB(),Whe=cl(),Khe=Rf();function Jhe(t,e,{offset:r,start:n,value:i,end:o},s){let a=Object.assign({_directives:e},t),c=new Vhe.Document(void 0,a),l={atKey:!1,atRoot:!0,directives:c.directives,options:c.options,schema:c.schema},u=Khe.resolveProps(n,{indicator:"doc-start",next:i??o?.[0],offset:r,onError:s,parentIndent:0,startOnNewline:!0});u.found&&(c.directives.docStart=!0,i&&(i.type==="block-map"||i.type==="block-seq")&&!u.hasNewline&&s(u.end,"MISSING_CHAR","Block collection cannot start on same line with directives-end marker")),c.contents=i?LB.composeNode(l,i,u,s):LB.composeEmptyNode(l,u.end,n,null,u,s);let d=c.contents.range[2],f=Whe.resolveEnd(o,d,!1,s);return f.comment&&(c.comment=f.comment),c.range=[r,d,f.offset],c}zB.composeDoc=Jhe});var lO=v(HB=>{"use strict";var Yhe=Ge("process"),Xhe=WA(),Qhe=Ef(),If=Of(),qB=De(),ege=UB(),tge=cl();function Pf(t){if(typeof t=="number")return[t,t+1];if(Array.isArray(t))return t.length===2?t:[t[0],t[1]];let{offset:e,source:r}=t;return[e,e+(typeof r=="string"?r.length:1)]}function BB(t){let e="",r=!1,n=!1;for(let i=0;i{let s=If(r);o?this.warnings.push(new Rf.YAMLWarning(s,n,i)):this.errors.push(new Rf.YAMLParseError(s,n,i))},this.directives=new Khe.Directives({version:e.version||"1.2"}),this.options=e}decorate(e,r){let{comment:n,afterEmptyLine:i}=qB(this.prelude);if(n){let o=e.contents;if(r)e.comment=e.comment?`${e.comment} -${n}`:n;else if(i||e.directives.docStart||!o)e.commentBefore=n;else if(UB.isCollection(o)&&!o.flow&&o.items.length>0){let s=o.items[0];UB.isPair(s)&&(s=s.key);let a=s.commentBefore;s.commentBefore=a?`${n} +`)+(o.substring(1)||" "),r=!0,n=!1;break;case"%":t[i+1]?.[0]!=="#"&&(i+=1),r=!1;break;default:r||(n=!0),r=!1}}return{comment:e,afterEmptyLine:n}}var cO=class{constructor(e={}){this.doc=null,this.atDirectives=!1,this.prelude=[],this.errors=[],this.warnings=[],this.onError=(r,n,i,o)=>{let s=Pf(r);o?this.warnings.push(new If.YAMLWarning(s,n,i)):this.errors.push(new If.YAMLParseError(s,n,i))},this.directives=new Xhe.Directives({version:e.version||"1.2"}),this.options=e}decorate(e,r){let{comment:n,afterEmptyLine:i}=BB(this.prelude);if(n){let o=e.contents;if(r)e.comment=e.comment?`${e.comment} +${n}`:n;else if(i||e.directives.docStart||!o)e.commentBefore=n;else if(qB.isCollection(o)&&!o.flow&&o.items.length>0){let s=o.items[0];qB.isPair(s)&&(s=s.key);let a=s.commentBefore;s.commentBefore=a?`${n} ${a}`:n}else{let s=o.commentBefore;o.commentBefore=s?`${n} -${s}`:n}}if(r){for(let o=0;o{let o=If(e);o[0]+=r,this.onError(o,"BAD_DIRECTIVE",n,i)}),this.prelude.push(e.source),this.atDirectives=!0;break;case"document":{let r=Yhe.composeDoc(this.options,this.directives,e,this.onError);this.atDirectives&&!r.directives.docStart&&this.onError(e,"MISSING_CHAR","Missing directives-end/doc-start indicator line"),this.decorate(r,!1),this.doc&&(yield this.doc),this.doc=r,this.atDirectives=!1;break}case"byte-order-mark":case"space":break;case"comment":case"newline":this.prelude.push(e.source);break;case"error":{let r=e.source?`${e.message}: ${JSON.stringify(e.source)}`:e.message,n=new Rf.YAMLParseError(If(e),"UNEXPECTED_TOKEN",r);this.atDirectives||!this.doc?this.errors.push(n):this.doc.errors.push(n);break}case"doc-end":{if(!this.doc){let n="Unexpected doc-end without preceding document";this.errors.push(new Rf.YAMLParseError(If(e),"UNEXPECTED_TOKEN",n));break}this.doc.directives.docEnd=!0;let r=Xhe.resolveEnd(e.end,e.offset+e.source.length,this.doc.options.strict,this.onError);if(this.decorate(this.doc,!0),r.comment){let n=this.doc.comment;this.doc.comment=n?`${n} -${r.comment}`:r.comment}this.doc.range[2]=r.offset;break}default:this.errors.push(new Rf.YAMLParseError(If(e),"UNEXPECTED_TOKEN",`Unsupported token ${e.type}`))}}*end(e=!1,r=-1){if(this.doc)this.decorate(this.doc,!0),yield this.doc,this.doc=null;else if(e){let n=Object.assign({_directives:this.directives},this.options),i=new Jhe.Document(void 0,n);this.atDirectives&&this.onError(r,"MISSING_CHAR","Missing directives-end indicator line"),i.range=[0,r,r],this.decorate(i,!1),yield i}}};BB.Composer=cO});var ZB=v(f_=>{"use strict";var Qhe=nO(),ege=oO(),tge=Tf(),HB=mf();function rge(t,e=!0,r){if(t){let n=(i,o,s)=>{let a=typeof i=="number"?i:Array.isArray(i)?i[0]:i.offset;if(r)r(a,o,s);else throw new tge.YAMLParseError([a,a+1],o,s)};switch(t.type){case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return ege.resolveFlowScalar(t,e,n);case"block-scalar":return Qhe.resolveBlockScalar({options:{strict:e}},t,n)}}return null}function nge(t,e){let{implicitKey:r=!1,indent:n,inFlow:i=!1,offset:o=-1,type:s="PLAIN"}=e,a=HB.stringifyString({type:s,value:t},{implicitKey:r,indent:n>0?" ".repeat(n):"",inFlow:i,options:{blockQuote:!0,lineWidth:-1}}),c=e.end??[{type:"newline",offset:-1,indent:n,source:` +${s}`:n}}if(r){for(let o=0;o{let o=Pf(e);o[0]+=r,this.onError(o,"BAD_DIRECTIVE",n,i)}),this.prelude.push(e.source),this.atDirectives=!0;break;case"document":{let r=ege.composeDoc(this.options,this.directives,e,this.onError);this.atDirectives&&!r.directives.docStart&&this.onError(e,"MISSING_CHAR","Missing directives-end/doc-start indicator line"),this.decorate(r,!1),this.doc&&(yield this.doc),this.doc=r,this.atDirectives=!1;break}case"byte-order-mark":case"space":break;case"comment":case"newline":this.prelude.push(e.source);break;case"error":{let r=e.source?`${e.message}: ${JSON.stringify(e.source)}`:e.message,n=new If.YAMLParseError(Pf(e),"UNEXPECTED_TOKEN",r);this.atDirectives||!this.doc?this.errors.push(n):this.doc.errors.push(n);break}case"doc-end":{if(!this.doc){let n="Unexpected doc-end without preceding document";this.errors.push(new If.YAMLParseError(Pf(e),"UNEXPECTED_TOKEN",n));break}this.doc.directives.docEnd=!0;let r=tge.resolveEnd(e.end,e.offset+e.source.length,this.doc.options.strict,this.onError);if(this.decorate(this.doc,!0),r.comment){let n=this.doc.comment;this.doc.comment=n?`${n} +${r.comment}`:r.comment}this.doc.range[2]=r.offset;break}default:this.errors.push(new If.YAMLParseError(Pf(e),"UNEXPECTED_TOKEN",`Unsupported token ${e.type}`))}}*end(e=!1,r=-1){if(this.doc)this.decorate(this.doc,!0),yield this.doc,this.doc=null;else if(e){let n=Object.assign({_directives:this.directives},this.options),i=new Qhe.Document(void 0,n);this.atDirectives&&this.onError(r,"MISSING_CHAR","Missing directives-end indicator line"),i.range=[0,r,r],this.decorate(i,!1),yield i}}};HB.Composer=cO});var VB=v(f_=>{"use strict";var rge=nO(),nge=oO(),ige=Of(),GB=hf();function oge(t,e=!0,r){if(t){let n=(i,o,s)=>{let a=typeof i=="number"?i:Array.isArray(i)?i[0]:i.offset;if(r)r(a,o,s);else throw new ige.YAMLParseError([a,a+1],o,s)};switch(t.type){case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return nge.resolveFlowScalar(t,e,n);case"block-scalar":return rge.resolveBlockScalar({options:{strict:e}},t,n)}}return null}function sge(t,e){let{implicitKey:r=!1,indent:n,inFlow:i=!1,offset:o=-1,type:s="PLAIN"}=e,a=GB.stringifyString({type:s,value:t},{implicitKey:r,indent:n>0?" ".repeat(n):"",inFlow:i,options:{blockQuote:!0,lineWidth:-1}}),c=e.end??[{type:"newline",offset:-1,indent:n,source:` `}];switch(a[0]){case"|":case">":{let l=a.indexOf(` `),u=a.substring(0,l),d=a.substring(l+1)+` -`,f=[{type:"block-scalar-header",offset:o,indent:n,source:u}];return GB(f,c)||f.push({type:"newline",offset:-1,indent:n,source:` -`}),{type:"block-scalar",offset:o,indent:n,props:f,source:d}}case'"':return{type:"double-quoted-scalar",offset:o,indent:n,source:a,end:c};case"'":return{type:"single-quoted-scalar",offset:o,indent:n,source:a,end:c};default:return{type:"scalar",offset:o,indent:n,source:a,end:c}}}function ige(t,e,r={}){let{afterKey:n=!1,implicitKey:i=!1,inFlow:o=!1,type:s}=r,a="indent"in t?t.indent:null;if(n&&typeof a=="number"&&(a+=2),!s)switch(t.type){case"single-quoted-scalar":s="QUOTE_SINGLE";break;case"double-quoted-scalar":s="QUOTE_DOUBLE";break;case"block-scalar":{let l=t.props[0];if(l.type!=="block-scalar-header")throw new Error("Invalid block scalar header");s=l.source[0]===">"?"BLOCK_FOLDED":"BLOCK_LITERAL";break}default:s="PLAIN"}let c=HB.stringifyString({type:s,value:e},{implicitKey:i||a===null,indent:a!==null&&a>0?" ".repeat(a):"",inFlow:o,options:{blockQuote:!0,lineWidth:-1}});switch(c[0]){case"|":case">":oge(t,c);break;case'"':uO(t,c,"double-quoted-scalar");break;case"'":uO(t,c,"single-quoted-scalar");break;default:uO(t,c,"scalar")}}function oge(t,e){let r=e.indexOf(` +`,f=[{type:"block-scalar-header",offset:o,indent:n,source:u}];return ZB(f,c)||f.push({type:"newline",offset:-1,indent:n,source:` +`}),{type:"block-scalar",offset:o,indent:n,props:f,source:d}}case'"':return{type:"double-quoted-scalar",offset:o,indent:n,source:a,end:c};case"'":return{type:"single-quoted-scalar",offset:o,indent:n,source:a,end:c};default:return{type:"scalar",offset:o,indent:n,source:a,end:c}}}function age(t,e,r={}){let{afterKey:n=!1,implicitKey:i=!1,inFlow:o=!1,type:s}=r,a="indent"in t?t.indent:null;if(n&&typeof a=="number"&&(a+=2),!s)switch(t.type){case"single-quoted-scalar":s="QUOTE_SINGLE";break;case"double-quoted-scalar":s="QUOTE_DOUBLE";break;case"block-scalar":{let l=t.props[0];if(l.type!=="block-scalar-header")throw new Error("Invalid block scalar header");s=l.source[0]===">"?"BLOCK_FOLDED":"BLOCK_LITERAL";break}default:s="PLAIN"}let c=GB.stringifyString({type:s,value:e},{implicitKey:i||a===null,indent:a!==null&&a>0?" ".repeat(a):"",inFlow:o,options:{blockQuote:!0,lineWidth:-1}});switch(c[0]){case"|":case">":cge(t,c);break;case'"':uO(t,c,"double-quoted-scalar");break;case"'":uO(t,c,"single-quoted-scalar");break;default:uO(t,c,"scalar")}}function cge(t,e){let r=e.indexOf(` `),n=e.substring(0,r),i=e.substring(r+1)+` -`;if(t.type==="block-scalar"){let o=t.props[0];if(o.type!=="block-scalar-header")throw new Error("Invalid block scalar header");o.source=n,t.source=i}else{let{offset:o}=t,s="indent"in t?t.indent:-1,a=[{type:"block-scalar-header",offset:o,indent:s,source:n}];GB(a,"end"in t?t.end:void 0)||a.push({type:"newline",offset:-1,indent:s,source:` -`});for(let c of Object.keys(t))c!=="type"&&c!=="offset"&&delete t[c];Object.assign(t,{type:"block-scalar",indent:s,props:a,source:i})}}function GB(t,e){if(e)for(let r of e)switch(r.type){case"space":case"comment":t.push(r);break;case"newline":return t.push(r),!0}return!1}function uO(t,e,r){switch(t.type){case"scalar":case"double-quoted-scalar":case"single-quoted-scalar":t.type=r,t.source=e;break;case"block-scalar":{let n=t.props.slice(1),i=e.length;t.props[0].type==="block-scalar-header"&&(i-=t.props[0].source.length);for(let o of n)o.offset+=i;delete t.props,Object.assign(t,{type:r,source:e,end:n});break}case"block-map":case"block-seq":{let i={type:"newline",offset:t.offset+e.length,indent:t.indent,source:` -`};delete t.items,Object.assign(t,{type:r,source:e,end:[i]});break}default:{let n="indent"in t?t.indent:-1,i="end"in t&&Array.isArray(t.end)?t.end.filter(o=>o.type==="space"||o.type==="comment"||o.type==="newline"):[];for(let o of Object.keys(t))o!=="type"&&o!=="offset"&&delete t[o];Object.assign(t,{type:r,indent:n,source:e,end:i})}}}f_.createScalarToken=nge;f_.resolveAsScalar=rge;f_.setScalarValue=ige});var WB=v(VB=>{"use strict";var sge=t=>"type"in t?m_(t):p_(t);function m_(t){switch(t.type){case"block-scalar":{let e="";for(let r of t.props)e+=m_(r);return e+t.source}case"block-map":case"block-seq":{let e="";for(let r of t.items)e+=p_(r);return e}case"flow-collection":{let e=t.start.source;for(let r of t.items)e+=p_(r);for(let r of t.end)e+=r.source;return e}case"document":{let e=p_(t);if(t.end)for(let r of t.end)e+=r.source;return e}default:{let e=t.source;if("end"in t&&t.end)for(let r of t.end)e+=r.source;return e}}}function p_({start:t,key:e,sep:r,value:n}){let i="";for(let o of t)i+=o.source;if(e&&(i+=m_(e)),r)for(let o of r)i+=o.source;return n&&(i+=m_(n)),i}VB.stringify=sge});var XB=v(YB=>{"use strict";var dO=Symbol("break visit"),age=Symbol("skip children"),KB=Symbol("remove item");function ga(t,e){"type"in t&&t.type==="document"&&(t={start:t.start,value:t.value}),JB(Object.freeze([]),t,e)}ga.BREAK=dO;ga.SKIP=age;ga.REMOVE=KB;ga.itemAtPath=(t,e)=>{let r=t;for(let[n,i]of e){let o=r?.[n];if(o&&"items"in o)r=o.items[i];else return}return r};ga.parentCollection=(t,e)=>{let r=ga.itemAtPath(t,e.slice(0,-1)),n=e[e.length-1][0],i=r?.[n];if(i&&"items"in i)return i;throw new Error("Parent collection not found")};function JB(t,e,r){let n=r(e,t);if(typeof n=="symbol")return n;for(let i of["key","value"]){let o=e[i];if(o&&"items"in o){for(let s=0;s{"use strict";var fO=ZB(),cge=WB(),lge=XB(),pO="\uFEFF",mO="",hO="",gO="",uge=t=>!!t&&"items"in t,dge=t=>!!t&&(t.type==="scalar"||t.type==="single-quoted-scalar"||t.type==="double-quoted-scalar"||t.type==="block-scalar");function fge(t){switch(t){case pO:return"";case mO:return"";case hO:return"";case gO:return"";default:return JSON.stringify(t)}}function pge(t){switch(t){case pO:return"byte-order-mark";case mO:return"doc-mode";case hO:return"flow-error-end";case gO:return"scalar";case"---":return"doc-start";case"...":return"doc-end";case"":case` +`;if(t.type==="block-scalar"){let o=t.props[0];if(o.type!=="block-scalar-header")throw new Error("Invalid block scalar header");o.source=n,t.source=i}else{let{offset:o}=t,s="indent"in t?t.indent:-1,a=[{type:"block-scalar-header",offset:o,indent:s,source:n}];ZB(a,"end"in t?t.end:void 0)||a.push({type:"newline",offset:-1,indent:s,source:` +`});for(let c of Object.keys(t))c!=="type"&&c!=="offset"&&delete t[c];Object.assign(t,{type:"block-scalar",indent:s,props:a,source:i})}}function ZB(t,e){if(e)for(let r of e)switch(r.type){case"space":case"comment":t.push(r);break;case"newline":return t.push(r),!0}return!1}function uO(t,e,r){switch(t.type){case"scalar":case"double-quoted-scalar":case"single-quoted-scalar":t.type=r,t.source=e;break;case"block-scalar":{let n=t.props.slice(1),i=e.length;t.props[0].type==="block-scalar-header"&&(i-=t.props[0].source.length);for(let o of n)o.offset+=i;delete t.props,Object.assign(t,{type:r,source:e,end:n});break}case"block-map":case"block-seq":{let i={type:"newline",offset:t.offset+e.length,indent:t.indent,source:` +`};delete t.items,Object.assign(t,{type:r,source:e,end:[i]});break}default:{let n="indent"in t?t.indent:-1,i="end"in t&&Array.isArray(t.end)?t.end.filter(o=>o.type==="space"||o.type==="comment"||o.type==="newline"):[];for(let o of Object.keys(t))o!=="type"&&o!=="offset"&&delete t[o];Object.assign(t,{type:r,indent:n,source:e,end:i})}}}f_.createScalarToken=sge;f_.resolveAsScalar=oge;f_.setScalarValue=age});var KB=v(WB=>{"use strict";var lge=t=>"type"in t?m_(t):p_(t);function m_(t){switch(t.type){case"block-scalar":{let e="";for(let r of t.props)e+=m_(r);return e+t.source}case"block-map":case"block-seq":{let e="";for(let r of t.items)e+=p_(r);return e}case"flow-collection":{let e=t.start.source;for(let r of t.items)e+=p_(r);for(let r of t.end)e+=r.source;return e}case"document":{let e=p_(t);if(t.end)for(let r of t.end)e+=r.source;return e}default:{let e=t.source;if("end"in t&&t.end)for(let r of t.end)e+=r.source;return e}}}function p_({start:t,key:e,sep:r,value:n}){let i="";for(let o of t)i+=o.source;if(e&&(i+=m_(e)),r)for(let o of r)i+=o.source;return n&&(i+=m_(n)),i}WB.stringify=lge});var QB=v(XB=>{"use strict";var dO=Symbol("break visit"),uge=Symbol("skip children"),JB=Symbol("remove item");function ga(t,e){"type"in t&&t.type==="document"&&(t={start:t.start,value:t.value}),YB(Object.freeze([]),t,e)}ga.BREAK=dO;ga.SKIP=uge;ga.REMOVE=JB;ga.itemAtPath=(t,e)=>{let r=t;for(let[n,i]of e){let o=r?.[n];if(o&&"items"in o)r=o.items[i];else return}return r};ga.parentCollection=(t,e)=>{let r=ga.itemAtPath(t,e.slice(0,-1)),n=e[e.length-1][0],i=r?.[n];if(i&&"items"in i)return i;throw new Error("Parent collection not found")};function YB(t,e,r){let n=r(e,t);if(typeof n=="symbol")return n;for(let i of["key","value"]){let o=e[i];if(o&&"items"in o){for(let s=0;s{"use strict";var fO=VB(),dge=KB(),fge=QB(),pO="\uFEFF",mO="",hO="",gO="",pge=t=>!!t&&"items"in t,mge=t=>!!t&&(t.type==="scalar"||t.type==="single-quoted-scalar"||t.type==="double-quoted-scalar"||t.type==="block-scalar");function hge(t){switch(t){case pO:return"";case mO:return"";case hO:return"";case gO:return"";default:return JSON.stringify(t)}}function gge(t){switch(t){case pO:return"byte-order-mark";case mO:return"doc-mode";case hO:return"flow-error-end";case gO:return"scalar";case"---":return"doc-start";case"...":return"doc-end";case"":case` `:case`\r -`:return"newline";case"-":return"seq-item-ind";case"?":return"explicit-key-ind";case":":return"map-value-ind";case"{":return"flow-map-start";case"}":return"flow-map-end";case"[":return"flow-seq-start";case"]":return"flow-seq-end";case",":return"comma"}switch(t[0]){case" ":case" ":return"space";case"#":return"comment";case"%":return"directive-line";case"*":return"alias";case"&":return"anchor";case"!":return"tag";case"'":return"single-quoted-scalar";case'"':return"double-quoted-scalar";case"|":case">":return"block-scalar-header"}return null}Dr.createScalarToken=fO.createScalarToken;Dr.resolveAsScalar=fO.resolveAsScalar;Dr.setScalarValue=fO.setScalarValue;Dr.stringify=cge.stringify;Dr.visit=lge.visit;Dr.BOM=pO;Dr.DOCUMENT=mO;Dr.FLOW_END=hO;Dr.SCALAR=gO;Dr.isCollection=uge;Dr.isScalar=dge;Dr.prettyToken=fge;Dr.tokenType=pge});var bO=v(eH=>{"use strict";var Pf=h_();function Jn(t){switch(t){case void 0:case" ":case` -`:case"\r":case" ":return!0;default:return!1}}var QB=new Set("0123456789ABCDEFabcdef"),mge=new Set("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-#;/?:@&=+$_.!~*'()"),g_=new Set(",[]{}"),hge=new Set(` ,[]{} -\r `),yO=t=>!t||hge.has(t),_O=class{constructor(){this.atEnd=!1,this.blockScalarIndent=-1,this.blockScalarKeep=!1,this.buffer="",this.flowKey=!1,this.flowLevel=0,this.indentNext=0,this.indentValue=0,this.lineEndPos=null,this.next=null,this.pos=0}*lex(e,r=!1){if(e){if(typeof e!="string")throw TypeError("source is not a string");this.buffer=this.buffer?this.buffer+e:e,this.lineEndPos=null}this.atEnd=!r;let n=this.next??"stream";for(;n&&(r||this.hasChars(1));)n=yield*this.parseNext(n)}atLineEnd(){let e=this.pos,r=this.buffer[e];for(;r===" "||r===" ";)r=this.buffer[++e];return!r||r==="#"||r===` +`:return"newline";case"-":return"seq-item-ind";case"?":return"explicit-key-ind";case":":return"map-value-ind";case"{":return"flow-map-start";case"}":return"flow-map-end";case"[":return"flow-seq-start";case"]":return"flow-seq-end";case",":return"comma"}switch(t[0]){case" ":case" ":return"space";case"#":return"comment";case"%":return"directive-line";case"*":return"alias";case"&":return"anchor";case"!":return"tag";case"'":return"single-quoted-scalar";case'"':return"double-quoted-scalar";case"|":case">":return"block-scalar-header"}return null}Nr.createScalarToken=fO.createScalarToken;Nr.resolveAsScalar=fO.resolveAsScalar;Nr.setScalarValue=fO.setScalarValue;Nr.stringify=dge.stringify;Nr.visit=fge.visit;Nr.BOM=pO;Nr.DOCUMENT=mO;Nr.FLOW_END=hO;Nr.SCALAR=gO;Nr.isCollection=pge;Nr.isScalar=mge;Nr.prettyToken=hge;Nr.tokenType=gge});var bO=v(tH=>{"use strict";var Cf=h_();function Yn(t){switch(t){case void 0:case" ":case` +`:case"\r":case" ":return!0;default:return!1}}var eH=new Set("0123456789ABCDEFabcdef"),yge=new Set("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-#;/?:@&=+$_.!~*'()"),g_=new Set(",[]{}"),_ge=new Set(` ,[]{} +\r `),yO=t=>!t||_ge.has(t),_O=class{constructor(){this.atEnd=!1,this.blockScalarIndent=-1,this.blockScalarKeep=!1,this.buffer="",this.flowKey=!1,this.flowLevel=0,this.indentNext=0,this.indentValue=0,this.lineEndPos=null,this.next=null,this.pos=0}*lex(e,r=!1){if(e){if(typeof e!="string")throw TypeError("source is not a string");this.buffer=this.buffer?this.buffer+e:e,this.lineEndPos=null}this.atEnd=!r;let n=this.next??"stream";for(;n&&(r||this.hasChars(1));)n=yield*this.parseNext(n)}atLineEnd(){let e=this.pos,r=this.buffer[e];for(;r===" "||r===" ";)r=this.buffer[++e];return!r||r==="#"||r===` `?!0:r==="\r"?this.buffer[e+1]===` `:!1}charAt(e){return this.buffer[this.pos+e]}continueScalar(e){let r=this.buffer[e];if(this.indentNext>0){let n=0;for(;r===" ";)r=this.buffer[++n+e];if(r==="\r"){let i=this.buffer[n+e+1];if(i===` `||!i&&!this.atEnd)return e+n+1}return r===` -`||n>=this.indentNext||!r&&!this.atEnd?e+n:-1}if(r==="-"||r==="."){let n=this.buffer.substr(e,3);if((n==="---"||n==="...")&&Jn(this.buffer[e+3]))return-1}return e}getLine(){let e=this.lineEndPos;return(typeof e!="number"||e!==-1&&ethis.indentValue&&!Jn(this.charAt(1))&&(this.indentNext=this.indentValue),yield*this.parseBlockStart()}*parseBlockStart(){let[e,r]=this.peek(2);if(!r&&!this.atEnd)return this.setNext("block-start");if((e==="-"||e==="?"||e===":")&&Jn(r)){let n=(yield*this.pushCount(1))+(yield*this.pushSpaces(!0));return this.indentNext=this.indentValue+1,this.indentValue+=n,"block-start"}return"doc"}*parseDocument(){yield*this.pushSpaces(!0);let e=this.getLine();if(e===null)return this.setNext("doc");let r=yield*this.pushIndicators();switch(e[r]){case"#":yield*this.pushCount(e.length-r);case void 0:return yield*this.pushNewline(),yield*this.parseLineStart();case"{":case"[":return yield*this.pushCount(1),this.flowKey=!1,this.flowLevel=1,"flow";case"}":case"]":return yield*this.pushCount(1),"doc";case"*":return yield*this.pushUntil(yO),"doc";case'"':case"'":return yield*this.parseQuotedScalar();case"|":case">":return r+=yield*this.parseBlockScalarHeader(),r+=yield*this.pushSpaces(!0),yield*this.pushCount(e.length-r),yield*this.pushNewline(),yield*this.parseBlockScalar();default:return yield*this.parsePlainScalar()}}*parseFlowCollection(){let e,r,n=-1;do e=yield*this.pushNewline(),e>0?(r=yield*this.pushSpaces(!1),this.indentValue=n=r):r=0,r+=yield*this.pushSpaces(!0);while(e+r>0);let i=this.getLine();if(i===null)return this.setNext("flow");if((n!==-1&&n=this.indentNext||!r&&!this.atEnd?e+n:-1}if(r==="-"||r==="."){let n=this.buffer.substr(e,3);if((n==="---"||n==="...")&&Yn(this.buffer[e+3]))return-1}return e}getLine(){let e=this.lineEndPos;return(typeof e!="number"||e!==-1&&ethis.indentValue&&!Yn(this.charAt(1))&&(this.indentNext=this.indentValue),yield*this.parseBlockStart()}*parseBlockStart(){let[e,r]=this.peek(2);if(!r&&!this.atEnd)return this.setNext("block-start");if((e==="-"||e==="?"||e===":")&&Yn(r)){let n=(yield*this.pushCount(1))+(yield*this.pushSpaces(!0));return this.indentNext=this.indentValue+1,this.indentValue+=n,"block-start"}return"doc"}*parseDocument(){yield*this.pushSpaces(!0);let e=this.getLine();if(e===null)return this.setNext("doc");let r=yield*this.pushIndicators();switch(e[r]){case"#":yield*this.pushCount(e.length-r);case void 0:return yield*this.pushNewline(),yield*this.parseLineStart();case"{":case"[":return yield*this.pushCount(1),this.flowKey=!1,this.flowLevel=1,"flow";case"}":case"]":return yield*this.pushCount(1),"doc";case"*":return yield*this.pushUntil(yO),"doc";case'"':case"'":return yield*this.parseQuotedScalar();case"|":case">":return r+=yield*this.parseBlockScalarHeader(),r+=yield*this.pushSpaces(!0),yield*this.pushCount(e.length-r),yield*this.pushNewline(),yield*this.parseBlockScalar();default:return yield*this.parsePlainScalar()}}*parseFlowCollection(){let e,r,n=-1;do e=yield*this.pushNewline(),e>0?(r=yield*this.pushSpaces(!1),this.indentValue=n=r):r=0,r+=yield*this.pushSpaces(!0);while(e+r>0);let i=this.getLine();if(i===null)return this.setNext("flow");if((n!==-1&&n"0"&&r<="9")this.blockScalarIndent=Number(r)-1;else if(r!=="-")break}return yield*this.pushUntil(r=>Jn(r)||r==="#")}*parseBlockScalar(){let e=this.pos-1,r=0,n;e:for(let o=this.pos;n=this.buffer[o];++o)switch(n){case" ":r+=1;break;case` +`,o)}i!==-1&&(r=i-(n[i-1]==="\r"?2:1))}if(r===-1){if(!this.atEnd)return this.setNext("quoted-scalar");r=this.buffer.length}return yield*this.pushToIndex(r+1,!1),this.flowLevel?"flow":"doc"}*parseBlockScalarHeader(){this.blockScalarIndent=-1,this.blockScalarKeep=!1;let e=this.pos;for(;;){let r=this.buffer[++e];if(r==="+")this.blockScalarKeep=!0;else if(r>"0"&&r<="9")this.blockScalarIndent=Number(r)-1;else if(r!=="-")break}return yield*this.pushUntil(r=>Yn(r)||r==="#")}*parseBlockScalar(){let e=this.pos-1,r=0,n;e:for(let o=this.pos;n=this.buffer[o];++o)switch(n){case" ":r+=1;break;case` `:e=o,r=0;break;case"\r":{let s=this.buffer[o+1];if(!s&&!this.atEnd)return this.setNext("block-scalar");if(s===` `)break}default:break e}if(!n&&!this.atEnd)return this.setNext("block-scalar");if(r>=this.indentNext){this.blockScalarIndent===-1?this.indentNext=r:this.indentNext=this.blockScalarIndent+(this.indentNext===0?1:this.indentNext);do{let o=this.continueScalar(e+1);if(o===-1)break;e=this.buffer.indexOf(` `,o)}while(e!==-1);if(e===-1){if(!this.atEnd)return this.setNext("block-scalar");e=this.buffer.length}}let i=e+1;for(n=this.buffer[i];n===" ";)n=this.buffer[++i];if(n===" "){for(;n===" "||n===" "||n==="\r"||n===` `;)n=this.buffer[++i];e=i-1}else if(!this.blockScalarKeep)do{let o=e-1,s=this.buffer[o];s==="\r"&&(s=this.buffer[--o]);let a=o;for(;s===" ";)s=this.buffer[--o];if(s===` -`&&o>=this.pos&&o+1+r>a)e=o;else break}while(!0);return yield Pf.SCALAR,yield*this.pushToIndex(e+1,!0),yield*this.parseLineStart()}*parsePlainScalar(){let e=this.flowLevel>0,r=this.pos-1,n=this.pos-1,i;for(;i=this.buffer[++n];)if(i===":"){let o=this.buffer[n+1];if(Jn(o)||e&&g_.has(o))break;r=n}else if(Jn(i)){let o=this.buffer[n+1];if(i==="\r"&&(o===` +`&&o>=this.pos&&o+1+r>a)e=o;else break}while(!0);return yield Cf.SCALAR,yield*this.pushToIndex(e+1,!0),yield*this.parseLineStart()}*parsePlainScalar(){let e=this.flowLevel>0,r=this.pos-1,n=this.pos-1,i;for(;i=this.buffer[++n];)if(i===":"){let o=this.buffer[n+1];if(Yn(o)||e&&g_.has(o))break;r=n}else if(Yn(i)){let o=this.buffer[n+1];if(i==="\r"&&(o===` `?(n+=1,i=` `,o=this.buffer[n+1]):r=n),o==="#"||e&&g_.has(o))break;if(i===` -`){let s=this.continueScalar(n+1);if(s===-1)break;n=Math.max(n,s-2)}}else{if(e&&g_.has(i))break;r=n}return!i&&!this.atEnd?this.setNext("plain-scalar"):(yield Pf.SCALAR,yield*this.pushToIndex(r+1,!0),e?"flow":"doc")}*pushCount(e){return e>0?(yield this.buffer.substr(this.pos,e),this.pos+=e,e):0}*pushToIndex(e,r){let n=this.buffer.slice(this.pos,e);return n?(yield n,this.pos+=n.length,n.length):(r&&(yield""),0)}*pushIndicators(){let e=0;e:for(;;){switch(this.charAt(0)){case"!":e+=yield*this.pushTag(),e+=yield*this.pushSpaces(!0);continue e;case"&":e+=yield*this.pushUntil(yO),e+=yield*this.pushSpaces(!0);continue e;case"-":case"?":case":":{let r=this.flowLevel>0,n=this.charAt(1);if(Jn(n)||r&&g_.has(n)){r?this.flowKey&&(this.flowKey=!1):this.indentNext=this.indentValue+1,e+=yield*this.pushCount(1),e+=yield*this.pushSpaces(!0);continue e}}}break e}return e}*pushTag(){if(this.charAt(1)==="<"){let e=this.pos+2,r=this.buffer[e];for(;!Jn(r)&&r!==">";)r=this.buffer[++e];return yield*this.pushToIndex(r===">"?e+1:e,!1)}else{let e=this.pos+1,r=this.buffer[e];for(;r;)if(mge.has(r))r=this.buffer[++e];else if(r==="%"&&QB.has(this.buffer[e+1])&&QB.has(this.buffer[e+2]))r=this.buffer[e+=3];else break;return yield*this.pushToIndex(e,!1)}}*pushNewline(){let e=this.buffer[this.pos];return e===` +`){let s=this.continueScalar(n+1);if(s===-1)break;n=Math.max(n,s-2)}}else{if(e&&g_.has(i))break;r=n}return!i&&!this.atEnd?this.setNext("plain-scalar"):(yield Cf.SCALAR,yield*this.pushToIndex(r+1,!0),e?"flow":"doc")}*pushCount(e){return e>0?(yield this.buffer.substr(this.pos,e),this.pos+=e,e):0}*pushToIndex(e,r){let n=this.buffer.slice(this.pos,e);return n?(yield n,this.pos+=n.length,n.length):(r&&(yield""),0)}*pushIndicators(){let e=0;e:for(;;){switch(this.charAt(0)){case"!":e+=yield*this.pushTag(),e+=yield*this.pushSpaces(!0);continue e;case"&":e+=yield*this.pushUntil(yO),e+=yield*this.pushSpaces(!0);continue e;case"-":case"?":case":":{let r=this.flowLevel>0,n=this.charAt(1);if(Yn(n)||r&&g_.has(n)){r?this.flowKey&&(this.flowKey=!1):this.indentNext=this.indentValue+1,e+=yield*this.pushCount(1),e+=yield*this.pushSpaces(!0);continue e}}}break e}return e}*pushTag(){if(this.charAt(1)==="<"){let e=this.pos+2,r=this.buffer[e];for(;!Yn(r)&&r!==">";)r=this.buffer[++e];return yield*this.pushToIndex(r===">"?e+1:e,!1)}else{let e=this.pos+1,r=this.buffer[e];for(;r;)if(yge.has(r))r=this.buffer[++e];else if(r==="%"&&eH.has(this.buffer[e+1])&&eH.has(this.buffer[e+2]))r=this.buffer[e+=3];else break;return yield*this.pushToIndex(e,!1)}}*pushNewline(){let e=this.buffer[this.pos];return e===` `?yield*this.pushCount(1):e==="\r"&&this.charAt(1)===` -`?yield*this.pushCount(2):0}*pushSpaces(e){let r=this.pos-1,n;do n=this.buffer[++r];while(n===" "||e&&n===" ");let i=r-this.pos;return i>0&&(yield this.buffer.substr(this.pos,i),this.pos=r),i}*pushUntil(e){let r=this.pos,n=this.buffer[r];for(;!e(n);)n=this.buffer[++r];return yield*this.pushToIndex(r,!1)}};eH.Lexer=_O});var SO=v(tH=>{"use strict";var vO=class{constructor(){this.lineStarts=[],this.addNewLine=e=>this.lineStarts.push(e),this.linePos=e=>{let r=0,n=this.lineStarts.length;for(;r>1;this.lineStarts[o]{"use strict";var gge=Ge("process"),rH=h_(),yge=bO();function es(t,e){for(let r=0;r=0;)switch(t[e].type){case"doc-start":case"explicit-key-ind":case"map-value-ind":case"seq-item-ind":case"newline":break e}for(;t[++e]?.type==="space";);return t.splice(e,t.length)}function __(t,e){if(e.length<1e5)Array.prototype.push.apply(t,e);else for(let r=0;r0;)yield*this.pop()}get sourceToken(){return{type:this.type,offset:this.offset,indent:this.indent,source:this.source}}*step(){let e=this.peek(1);if(this.type==="doc-end"&&e?.type!=="doc-end"){for(;this.stack.length>0;)yield*this.pop();this.stack.push({type:"doc-end",offset:this.offset,source:this.source});return}if(!e)return yield*this.stream();switch(e.type){case"document":return yield*this.document(e);case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return yield*this.scalar(e);case"block-scalar":return yield*this.blockScalar(e);case"block-map":return yield*this.blockMap(e);case"block-seq":return yield*this.blockSequence(e);case"flow-collection":return yield*this.flowCollection(e);case"doc-end":return yield*this.documentEnd(e)}yield*this.pop()}peek(e){return this.stack[this.stack.length-e]}*pop(e){let r=e??this.stack.pop();if(!r)yield{type:"error",offset:this.offset,source:"",message:"Tried to pop an empty stack"};else if(this.stack.length===0)yield r;else{let n=this.peek(1);switch(r.type==="block-scalar"?r.indent="indent"in n?n.indent:0:r.type==="flow-collection"&&n.type==="document"&&(r.indent=0),r.type==="flow-collection"&&iH(r),n.type){case"document":n.value=r;break;case"block-scalar":n.props.push(r);break;case"block-map":{let i=n.items[n.items.length-1];if(i.value){n.items.push({start:[],key:r,sep:[]}),this.onKeyLine=!0;return}else if(i.sep)i.value=r;else{Object.assign(i,{key:r,sep:[]}),this.onKeyLine=!i.explicitKey;return}break}case"block-seq":{let i=n.items[n.items.length-1];i.value?n.items.push({start:[],value:r}):i.value=r;break}case"flow-collection":{let i=n.items[n.items.length-1];!i||i.value?n.items.push({start:[],key:r,sep:[]}):i.sep?i.value=r:Object.assign(i,{key:r,sep:[]});return}default:yield*this.pop(),yield*this.pop(r)}if((n.type==="document"||n.type==="block-map"||n.type==="block-seq")&&(r.type==="block-map"||r.type==="block-seq")){let i=r.items[r.items.length-1];i&&!i.sep&&!i.value&&i.start.length>0&&nH(i.start)===-1&&(r.indent===0||i.start.every(o=>o.type!=="comment"||o.indent0&&(yield this.buffer.substr(this.pos,i),this.pos=r),i}*pushUntil(e){let r=this.pos,n=this.buffer[r];for(;!e(n);)n=this.buffer[++r];return yield*this.pushToIndex(r,!1)}};tH.Lexer=_O});var SO=v(rH=>{"use strict";var vO=class{constructor(){this.lineStarts=[],this.addNewLine=e=>this.lineStarts.push(e),this.linePos=e=>{let r=0,n=this.lineStarts.length;for(;r>1;this.lineStarts[o]{"use strict";var bge=Ge("process"),nH=h_(),vge=bO();function es(t,e){for(let r=0;r=0;)switch(t[e].type){case"doc-start":case"explicit-key-ind":case"map-value-ind":case"seq-item-ind":case"newline":break e}for(;t[++e]?.type==="space";);return t.splice(e,t.length)}function __(t,e){if(e.length<1e5)Array.prototype.push.apply(t,e);else for(let r=0;r0;)yield*this.pop()}get sourceToken(){return{type:this.type,offset:this.offset,indent:this.indent,source:this.source}}*step(){let e=this.peek(1);if(this.type==="doc-end"&&e?.type!=="doc-end"){for(;this.stack.length>0;)yield*this.pop();this.stack.push({type:"doc-end",offset:this.offset,source:this.source});return}if(!e)return yield*this.stream();switch(e.type){case"document":return yield*this.document(e);case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return yield*this.scalar(e);case"block-scalar":return yield*this.blockScalar(e);case"block-map":return yield*this.blockMap(e);case"block-seq":return yield*this.blockSequence(e);case"flow-collection":return yield*this.flowCollection(e);case"doc-end":return yield*this.documentEnd(e)}yield*this.pop()}peek(e){return this.stack[this.stack.length-e]}*pop(e){let r=e??this.stack.pop();if(!r)yield{type:"error",offset:this.offset,source:"",message:"Tried to pop an empty stack"};else if(this.stack.length===0)yield r;else{let n=this.peek(1);switch(r.type==="block-scalar"?r.indent="indent"in n?n.indent:0:r.type==="flow-collection"&&n.type==="document"&&(r.indent=0),r.type==="flow-collection"&&oH(r),n.type){case"document":n.value=r;break;case"block-scalar":n.props.push(r);break;case"block-map":{let i=n.items[n.items.length-1];if(i.value){n.items.push({start:[],key:r,sep:[]}),this.onKeyLine=!0;return}else if(i.sep)i.value=r;else{Object.assign(i,{key:r,sep:[]}),this.onKeyLine=!i.explicitKey;return}break}case"block-seq":{let i=n.items[n.items.length-1];i.value?n.items.push({start:[],value:r}):i.value=r;break}case"flow-collection":{let i=n.items[n.items.length-1];!i||i.value?n.items.push({start:[],key:r,sep:[]}):i.sep?i.value=r:Object.assign(i,{key:r,sep:[]});return}default:yield*this.pop(),yield*this.pop(r)}if((n.type==="document"||n.type==="block-map"||n.type==="block-seq")&&(r.type==="block-map"||r.type==="block-seq")){let i=r.items[r.items.length-1];i&&!i.sep&&!i.value&&i.start.length>0&&iH(i.start)===-1&&(r.indent===0||i.start.every(o=>o.type!=="comment"||o.indent=e.indent){let n=!this.onKeyLine&&this.indent===e.indent,i=n&&(r.sep||r.explicitKey)&&this.type!=="seq-item-ind",o=[];if(i&&r.sep&&!r.value){let s=[];for(let a=0;ae.indent&&(s.length=0);break;default:s.length=0}}s.length>=2&&(o=r.sep.splice(s[1]))}switch(this.type){case"anchor":case"tag":i||r.value?(o.push(this.sourceToken),e.items.push({start:o}),this.onKeyLine=!0):r.sep?r.sep.push(this.sourceToken):r.start.push(this.sourceToken);return;case"explicit-key-ind":!r.sep&&!r.explicitKey?(r.start.push(this.sourceToken),r.explicitKey=!0):i||r.value?(o.push(this.sourceToken),e.items.push({start:o,explicitKey:!0})):this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken],explicitKey:!0}]}),this.onKeyLine=!0;return;case"map-value-ind":if(r.explicitKey)if(r.sep)if(r.value)e.items.push({start:[],key:null,sep:[this.sourceToken]});else if(es(r.sep,"map-value-ind"))this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:o,key:null,sep:[this.sourceToken]}]});else if(oH(r.key)&&!es(r.sep,"newline")){let s=ll(r.start),a=r.key,c=r.sep;c.push(this.sourceToken),delete r.key,delete r.sep,this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:s,key:a,sep:c}]})}else o.length>0?r.sep=r.sep.concat(o,this.sourceToken):r.sep.push(this.sourceToken);else if(es(r.start,"newline"))Object.assign(r,{key:null,sep:[this.sourceToken]});else{let s=ll(r.start);this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:s,key:null,sep:[this.sourceToken]}]})}else r.sep?r.value||i?e.items.push({start:o,key:null,sep:[this.sourceToken]}):es(r.sep,"map-value-ind")?this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[],key:null,sep:[this.sourceToken]}]}):r.sep.push(this.sourceToken):Object.assign(r,{key:null,sep:[this.sourceToken]});this.onKeyLine=!0;return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let s=this.flowScalar(this.type);i||r.value?(e.items.push({start:o,key:s,sep:[]}),this.onKeyLine=!0):r.sep?this.stack.push(s):(Object.assign(r,{key:s,sep:[]}),this.onKeyLine=!0);return}default:{let s=this.startBlockValue(e);if(s){if(s.type==="block-seq"){if(!r.explicitKey&&r.sep&&!es(r.sep,"newline")){yield*this.pop({type:"error",offset:this.offset,message:"Unexpected block-seq-ind on same line with key",source:this.source});return}}else n&&e.items.push({start:o});this.stack.push(s);return}}}}yield*this.pop(),yield*this.step()}*blockSequence(e){let r=e.items[e.items.length-1];switch(this.type){case"newline":if(r.value){let n="end"in r.value?r.value.end:void 0;(Array.isArray(n)?n[n.length-1]:void 0)?.type==="comment"?n?.push(this.sourceToken):e.items.push({start:[this.sourceToken]})}else r.start.push(this.sourceToken);return;case"space":case"comment":if(r.value)e.items.push({start:[this.sourceToken]});else{if(this.atIndentedComment(r.start,e.indent)){let i=e.items[e.items.length-2]?.value?.end;if(Array.isArray(i)){__(i,r.start),i.push(this.sourceToken),e.items.pop();return}}r.start.push(this.sourceToken)}return;case"anchor":case"tag":if(r.value||this.indent<=e.indent)break;r.start.push(this.sourceToken);return;case"seq-item-ind":if(this.indent!==e.indent)break;r.value||es(r.start,"seq-item-ind")?e.items.push({start:[this.sourceToken]}):r.start.push(this.sourceToken);return}if(this.indent>e.indent){let n=this.startBlockValue(e);if(n){this.stack.push(n);return}}yield*this.pop(),yield*this.step()}*flowCollection(e){let r=e.items[e.items.length-1];if(this.type==="flow-error-end"){let n;do yield*this.pop(),n=this.peek(1);while(n?.type==="flow-collection")}else if(e.end.length===0){switch(this.type){case"comma":case"explicit-key-ind":!r||r.sep?e.items.push({start:[this.sourceToken]}):r.start.push(this.sourceToken);return;case"map-value-ind":!r||r.value?e.items.push({start:[],key:null,sep:[this.sourceToken]}):r.sep?r.sep.push(this.sourceToken):Object.assign(r,{key:null,sep:[this.sourceToken]});return;case"space":case"comment":case"newline":case"anchor":case"tag":!r||r.value?e.items.push({start:[this.sourceToken]}):r.sep?r.sep.push(this.sourceToken):r.start.push(this.sourceToken);return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let i=this.flowScalar(this.type);!r||r.value?e.items.push({start:[],key:i,sep:[]}):r.sep?this.stack.push(i):Object.assign(r,{key:i,sep:[]});return}case"flow-map-end":case"flow-seq-end":e.end.push(this.sourceToken);return}let n=this.startBlockValue(e);n?this.stack.push(n):(yield*this.pop(),yield*this.step())}else{let n=this.peek(2);if(n.type==="block-map"&&(this.type==="map-value-ind"&&n.indent===e.indent||this.type==="newline"&&!n.items[n.items.length-1].sep))yield*this.pop(),yield*this.step();else if(this.type==="map-value-ind"&&n.type!=="flow-collection"){let i=y_(n),o=ll(i);iH(e);let s=e.end.splice(1,e.end.length);s.push(this.sourceToken);let a={type:"block-map",offset:e.offset,indent:e.indent,items:[{start:o,key:e,sep:s}]};this.onKeyLine=!0,this.stack[this.stack.length-1]=a}else yield*this.lineEnd(e)}}flowScalar(e){if(this.onNewLine){let r=this.source.indexOf(` +`,r)+1}yield*this.pop();break;default:yield*this.pop(),yield*this.step()}}*blockMap(e){let r=e.items[e.items.length-1];switch(this.type){case"newline":if(this.onKeyLine=!1,r.value){let n="end"in r.value?r.value.end:void 0;(Array.isArray(n)?n[n.length-1]:void 0)?.type==="comment"?n?.push(this.sourceToken):e.items.push({start:[this.sourceToken]})}else r.sep?r.sep.push(this.sourceToken):r.start.push(this.sourceToken);return;case"space":case"comment":if(r.value)e.items.push({start:[this.sourceToken]});else if(r.sep)r.sep.push(this.sourceToken);else{if(this.atIndentedComment(r.start,e.indent)){let i=e.items[e.items.length-2]?.value?.end;if(Array.isArray(i)){__(i,r.start),i.push(this.sourceToken),e.items.pop();return}}r.start.push(this.sourceToken)}return}if(this.indent>=e.indent){let n=!this.onKeyLine&&this.indent===e.indent,i=n&&(r.sep||r.explicitKey)&&this.type!=="seq-item-ind",o=[];if(i&&r.sep&&!r.value){let s=[];for(let a=0;ae.indent&&(s.length=0);break;default:s.length=0}}s.length>=2&&(o=r.sep.splice(s[1]))}switch(this.type){case"anchor":case"tag":i||r.value?(o.push(this.sourceToken),e.items.push({start:o}),this.onKeyLine=!0):r.sep?r.sep.push(this.sourceToken):r.start.push(this.sourceToken);return;case"explicit-key-ind":!r.sep&&!r.explicitKey?(r.start.push(this.sourceToken),r.explicitKey=!0):i||r.value?(o.push(this.sourceToken),e.items.push({start:o,explicitKey:!0})):this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken],explicitKey:!0}]}),this.onKeyLine=!0;return;case"map-value-ind":if(r.explicitKey)if(r.sep)if(r.value)e.items.push({start:[],key:null,sep:[this.sourceToken]});else if(es(r.sep,"map-value-ind"))this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:o,key:null,sep:[this.sourceToken]}]});else if(sH(r.key)&&!es(r.sep,"newline")){let s=ll(r.start),a=r.key,c=r.sep;c.push(this.sourceToken),delete r.key,delete r.sep,this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:s,key:a,sep:c}]})}else o.length>0?r.sep=r.sep.concat(o,this.sourceToken):r.sep.push(this.sourceToken);else if(es(r.start,"newline"))Object.assign(r,{key:null,sep:[this.sourceToken]});else{let s=ll(r.start);this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:s,key:null,sep:[this.sourceToken]}]})}else r.sep?r.value||i?e.items.push({start:o,key:null,sep:[this.sourceToken]}):es(r.sep,"map-value-ind")?this.stack.push({type:"block-map",offset:this.offset,indent:this.indent,items:[{start:[],key:null,sep:[this.sourceToken]}]}):r.sep.push(this.sourceToken):Object.assign(r,{key:null,sep:[this.sourceToken]});this.onKeyLine=!0;return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let s=this.flowScalar(this.type);i||r.value?(e.items.push({start:o,key:s,sep:[]}),this.onKeyLine=!0):r.sep?this.stack.push(s):(Object.assign(r,{key:s,sep:[]}),this.onKeyLine=!0);return}default:{let s=this.startBlockValue(e);if(s){if(s.type==="block-seq"){if(!r.explicitKey&&r.sep&&!es(r.sep,"newline")){yield*this.pop({type:"error",offset:this.offset,message:"Unexpected block-seq-ind on same line with key",source:this.source});return}}else n&&e.items.push({start:o});this.stack.push(s);return}}}}yield*this.pop(),yield*this.step()}*blockSequence(e){let r=e.items[e.items.length-1];switch(this.type){case"newline":if(r.value){let n="end"in r.value?r.value.end:void 0;(Array.isArray(n)?n[n.length-1]:void 0)?.type==="comment"?n?.push(this.sourceToken):e.items.push({start:[this.sourceToken]})}else r.start.push(this.sourceToken);return;case"space":case"comment":if(r.value)e.items.push({start:[this.sourceToken]});else{if(this.atIndentedComment(r.start,e.indent)){let i=e.items[e.items.length-2]?.value?.end;if(Array.isArray(i)){__(i,r.start),i.push(this.sourceToken),e.items.pop();return}}r.start.push(this.sourceToken)}return;case"anchor":case"tag":if(r.value||this.indent<=e.indent)break;r.start.push(this.sourceToken);return;case"seq-item-ind":if(this.indent!==e.indent)break;r.value||es(r.start,"seq-item-ind")?e.items.push({start:[this.sourceToken]}):r.start.push(this.sourceToken);return}if(this.indent>e.indent){let n=this.startBlockValue(e);if(n){this.stack.push(n);return}}yield*this.pop(),yield*this.step()}*flowCollection(e){let r=e.items[e.items.length-1];if(this.type==="flow-error-end"){let n;do yield*this.pop(),n=this.peek(1);while(n?.type==="flow-collection")}else if(e.end.length===0){switch(this.type){case"comma":case"explicit-key-ind":!r||r.sep?e.items.push({start:[this.sourceToken]}):r.start.push(this.sourceToken);return;case"map-value-ind":!r||r.value?e.items.push({start:[],key:null,sep:[this.sourceToken]}):r.sep?r.sep.push(this.sourceToken):Object.assign(r,{key:null,sep:[this.sourceToken]});return;case"space":case"comment":case"newline":case"anchor":case"tag":!r||r.value?e.items.push({start:[this.sourceToken]}):r.sep?r.sep.push(this.sourceToken):r.start.push(this.sourceToken);return;case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":{let i=this.flowScalar(this.type);!r||r.value?e.items.push({start:[],key:i,sep:[]}):r.sep?this.stack.push(i):Object.assign(r,{key:i,sep:[]});return}case"flow-map-end":case"flow-seq-end":e.end.push(this.sourceToken);return}let n=this.startBlockValue(e);n?this.stack.push(n):(yield*this.pop(),yield*this.step())}else{let n=this.peek(2);if(n.type==="block-map"&&(this.type==="map-value-ind"&&n.indent===e.indent||this.type==="newline"&&!n.items[n.items.length-1].sep))yield*this.pop(),yield*this.step();else if(this.type==="map-value-ind"&&n.type!=="flow-collection"){let i=y_(n),o=ll(i);oH(e);let s=e.end.splice(1,e.end.length);s.push(this.sourceToken);let a={type:"block-map",offset:e.offset,indent:e.indent,items:[{start:o,key:e,sep:s}]};this.onKeyLine=!0,this.stack[this.stack.length-1]=a}else yield*this.lineEnd(e)}}flowScalar(e){if(this.onNewLine){let r=this.source.indexOf(` `)+1;for(;r!==0;)this.onNewLine(this.offset+r),r=this.source.indexOf(` -`,r)+1}return{type:e,offset:this.offset,indent:this.indent,source:this.source}}startBlockValue(e){switch(this.type){case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return this.flowScalar(this.type);case"block-scalar-header":return{type:"block-scalar",offset:this.offset,indent:this.indent,props:[this.sourceToken],source:""};case"flow-map-start":case"flow-seq-start":return{type:"flow-collection",offset:this.offset,indent:this.indent,start:this.sourceToken,items:[],end:[]};case"seq-item-ind":return{type:"block-seq",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken]}]};case"explicit-key-ind":{this.onKeyLine=!0;let r=y_(e),n=ll(r);return n.push(this.sourceToken),{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:n,explicitKey:!0}]}}case"map-value-ind":{this.onKeyLine=!0;let r=y_(e),n=ll(r);return{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:n,key:null,sep:[this.sourceToken]}]}}}return null}atIndentedComment(e,r){return this.type!=="comment"||this.indent<=r?!1:e.every(n=>n.type==="newline"||n.type==="space")}*documentEnd(e){this.type!=="doc-mode"&&(e.end?e.end.push(this.sourceToken):e.end=[this.sourceToken],this.type==="newline"&&(yield*this.pop()))}*lineEnd(e){switch(this.type){case"comma":case"doc-start":case"doc-end":case"flow-seq-end":case"flow-map-end":case"map-value-ind":yield*this.pop(),yield*this.step();break;case"newline":this.onKeyLine=!1;default:e.end?e.end.push(this.sourceToken):e.end=[this.sourceToken],this.type==="newline"&&(yield*this.pop())}}};sH.Parser=wO});var dH=v(Df=>{"use strict";var aH=lO(),_ge=kf(),Cf=Tf(),bge=aT(),vge=De(),Sge=SO(),cH=xO();function lH(t){let e=t.prettyErrors!==!1;return{lineCounter:t.lineCounter||e&&new Sge.LineCounter||null,prettyErrors:e}}function wge(t,e={}){let{lineCounter:r,prettyErrors:n}=lH(e),i=new cH.Parser(r?.addNewLine),o=new aH.Composer(e),s=Array.from(o.compose(i.parse(t)));if(n&&r)for(let a of s)a.errors.forEach(Cf.prettifyError(t,r)),a.warnings.forEach(Cf.prettifyError(t,r));return s.length>0?s:Object.assign([],{empty:!0},o.streamInfo())}function uH(t,e={}){let{lineCounter:r,prettyErrors:n}=lH(e),i=new cH.Parser(r?.addNewLine),o=new aH.Composer(e),s=null;for(let a of o.compose(i.parse(t),!0,t.length))if(!s)s=a;else if(s.options.logLevel!=="silent"){s.errors.push(new Cf.YAMLParseError(a.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}return n&&r&&(s.errors.forEach(Cf.prettifyError(t,r)),s.warnings.forEach(Cf.prettifyError(t,r))),s}function xge(t,e,r){let n;typeof e=="function"?n=e:r===void 0&&e&&typeof e=="object"&&(r=e);let i=uH(t,r);if(!i)return null;if(i.warnings.forEach(o=>bge.warn(i.options.logLevel,o)),i.errors.length>0){if(i.options.logLevel!=="silent")throw i.errors[0];i.errors=[]}return i.toJS(Object.assign({reviver:n},r))}function $ge(t,e,r){let n=null;if(typeof e=="function"||Array.isArray(e)?n=e:r===void 0&&e&&(r=e),typeof r=="string"&&(r=r.length),typeof r=="number"){let i=Math.round(r);r=i<1?void 0:i>8?{indent:8}:{indent:i}}if(t===void 0){let{keepUndefined:i}=r??e??{};if(!i)return}return vge.isDocument(t)&&!n?t.toString(r):new _ge.Document(t,n,r).toString(r)}Df.parse=xge;Df.parseAllDocuments=wge;Df.parseDocument=uH;Df.stringify=$ge});var er=v(Ze=>{"use strict";var kge=lO(),Ege=kf(),Age=BT(),$O=Tf(),Tge=lf(),ts=De(),Oge=Jo(),Rge=Dt(),Ige=Xo(),Pge=Qo(),Cge=h_(),Dge=bO(),Nge=SO(),jge=xO(),b_=dH(),fH=of();Ze.Composer=kge.Composer;Ze.Document=Ege.Document;Ze.Schema=Age.Schema;Ze.YAMLError=$O.YAMLError;Ze.YAMLParseError=$O.YAMLParseError;Ze.YAMLWarning=$O.YAMLWarning;Ze.Alias=Tge.Alias;Ze.isAlias=ts.isAlias;Ze.isCollection=ts.isCollection;Ze.isDocument=ts.isDocument;Ze.isMap=ts.isMap;Ze.isNode=ts.isNode;Ze.isPair=ts.isPair;Ze.isScalar=ts.isScalar;Ze.isSeq=ts.isSeq;Ze.Pair=Oge.Pair;Ze.Scalar=Rge.Scalar;Ze.YAMLMap=Ige.YAMLMap;Ze.YAMLSeq=Pge.YAMLSeq;Ze.CST=Cge;Ze.Lexer=Dge.Lexer;Ze.LineCounter=Nge.LineCounter;Ze.Parser=jge.Parser;Ze.parse=b_.parse;Ze.parseAllDocuments=b_.parseAllDocuments;Ze.parseDocument=b_.parseDocument;Ze.stringify=b_.stringify;Ze.visit=fH.visit;Ze.visitAsync=fH.visitAsync});import{execFileSync as pH}from"node:child_process";import{existsSync as v_}from"node:fs";import{join as S_,resolve as Mge}from"node:path";function Fge(t){try{let e=pH("git",["rev-parse","--git-dir"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return e?Mge(t,e):null}catch{return null}}function kO(t){let e=Fge(t);if(!e)return null;try{if(v_(S_(e,"MERGE_HEAD")))return"merge";if(v_(S_(e,"CHERRY_PICK_HEAD")))return"cherry-pick";if(v_(S_(e,"rebase-merge"))||v_(S_(e,"rebase-apply")))return"rebase"}catch{return null}return null}function ya(t){return kO(t)!==null}function EO(t,e){try{let r=pH("git",["rev-parse","--verify","--quiet",`${e}^{commit}`],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return r.length>0?r:null}catch{return null}}function w_(t,e){return EO(t,e)!==null}var _a=y(()=>{"use strict"});import{execFileSync as Lge}from"node:child_process";import{existsSync as zge,readFileSync as Uge}from"node:fs";import{join as gH}from"node:path";function Nf(t,e){return Lge("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function rs(t){try{let e=Nf(t,["describe","--tags","--abbrev=0"]).trim();if(e.length>0)return e}catch{}throw new Error("changelog: no git tag found to anchor the default range \u2014 pass --since explicitly (e.g. clad changelog --since v1.0.0)")}function ns(t,e){qge(t,e);let r=Nf(t,["rev-parse","HEAD"]).trim(),n=Bge(t,e);return{groups:Hge(t,n),head:r,inventory:{after:hH($_(t,"spec.yaml")),before:hH(AO(t,e,"spec.yaml"))},since:e,unsharded_commits:Wge(t,e)}}function TO(t){if(t.text&&t.text.trim().length>0)return t.text.trim();let e=t.action?.trim();if(!e)return null;let r=t.condition?.trim(),n=t.response?.trim(),i=r?`${r.charAt(0).toUpperCase()}${r.slice(1)}, the system shall ${e}`:`The system shall ${e}`;return n?`${i} \u2014 ${n}.`:`${i}.`}function qge(t,e){let r=(e??"").trim();if(r.length===0)throw new Error("changelog: empty since ref \u2014 pass --since ");if(!w_(t,r))throw new Error(`changelog: '${r}' does not resolve to a commit in this repository \u2014 pass --since that exists. An unknown ref is an error, never a silently empty changelog.`)}function Bge(t,e){let r=Nf(t,["diff","--name-status",`${e}..HEAD`,"--","spec/"]),n=[];for(let i of r.split(` -`)){if(i.trim().length===0)continue;let o=i.split(" "),s=o[0]??"",a=o[1]??"",c=o.length>2?o[2]:a;if(!(!mH(c)&&!mH(a)))if(s.startsWith("A")){let l=x_($_(t,c));if(!l)continue;l.status==="done"?n.push(ul(l,"added-as-done")):l.status==="archived"&&n.push(ul(l,"archived"))}else if(s.startsWith("D")){let l=x_(AO(t,e,a));l&&n.push(ul(l,"archived"))}else{let l=x_($_(t,c));if(!l)continue;let d=x_(AO(t,e,a))?.status;l.status==="done"&&d!=="done"?n.push(ul(l,"flipped-to-done")):l.status==="done"&&d==="done"?n.push(ul(l,"modified-while-done")):l.status==="archived"&&d!=="archived"&&n.push(ul(l,"archived"))}}return n.sort((i,o)=>i.id.localeCompare(o.id)),n}function mH(t){return t.startsWith("spec/features/")&&(t.endsWith(".yaml")||t.endsWith(".yml"))}function ul(t,e){return{acceptance:(t.acceptance_criteria??[]).map(n=>TO(n)).filter(n=>n!==null),change:e,id:t.id,...t.slug?{slug:t.slug}:{},title:t.title}}function x_(t){if(t===null)return null;let e;try{e=(0,k_.parse)(t)}catch{return null}let r=e;return!r||typeof r.id!="string"||typeof r.status!="string"?null:{id:r.id,slug:typeof r.slug=="string"?r.slug:void 0,title:typeof r.title=="string"?r.title:r.id,status:r.status,acceptance_criteria:r.acceptance_criteria}}function $_(t,e){let r=gH(t,e);if(!zge(r))return null;try{return Uge(r,"utf8")}catch{return null}}function AO(t,e,r){try{return Nf(t,["show",`${e}:${r}`])}catch{return null}}function Hge(t,e){let r=Gge(t).filter(s=>typeof s.id=="string"&&s.id.length>0).sort((s,a)=>s.id.localeCompare(a.id)),n=[],i=new Set;for(let s of r){let a=new Set(s.features??[]),c=e.filter(l=>a.has(l.id)&&!i.has(l.id));if(c.length!==0){for(let l of c)i.add(l.id);n.push({capability:s.id,features:c,title:s.title??s.id})}}let o=e.filter(s=>!i.has(s.id));return o.length>0&&n.push({capability:"uncategorized",features:o,title:"Uncategorized"}),n}function Gge(t){let e=$_(t,gH("spec","capabilities.yaml"));if(e===null)return[];try{let r=(0,k_.parse)(e);return Array.isArray(r?.capabilities)?r.capabilities:[]}catch{return[]}}function hH(t){let e={};if(t!==null)try{let n=(0,k_.parse)(t);n&&typeof n.inventory=="object"&&n.inventory!==null&&(e=n.inventory)}catch{}let r=n=>typeof e[n]=="number"?e[n]:0;return{capabilities:r("capabilities"),features:r("features"),scenarios:r("scenarios"),test_files:r("test_files")}}function Wge(t,e){let r=Nf(t,["log",`${e}..HEAD`,"--format=%h%x09%s","--","src/"]),n=[];for(let i of r.split(` -`)){if(i.trim().length===0)continue;let o=i.indexOf(" ");if(o<0)continue;let s=i.slice(0,o),a=i.slice(o+1);Zge.test(a)&&(Vge.test(a)||n.push({hash:s,subject:a}))}return n}var k_,Zge,Vge,dl=y(()=>{"use strict";k_=St(er(),1);_a();Zge=/^(feat|fix)(\([^)]*\))?!?:/,Vge=/\bF-(\d{3,}|[a-f0-9]{6,})\b/});import{execFileSync as yH}from"node:child_process";import{appendFileSync as Kge,existsSync as OO,mkdirSync as Jge,readFileSync as Yge,renameSync as Xge,statSync as Qge}from"node:fs";import{userInfo as eye}from"node:os";import{dirname as tye,join as IO}from"node:path";function PO(t){return IO(t,_H,rye)}function Qr(t,e){let r=PO(t),n=tye(r);OO(n)||Jge(n,{recursive:!0});try{OO(r)&&Qge(r).size>nye&&Xge(r,IO(n,bH))}catch{}Kge(r,`${JSON.stringify(e)} -`,"utf8")}function RO(t){if(!OO(t))return[];let e=Yge(t,"utf8").trim();return e.length===0?[]:e.split(` -`).filter(r=>r.length>0).map(r=>JSON.parse(r))}function ba(t){return RO(PO(t))}function E_(t){return[...RO(IO(t,_H,bH)),...RO(PO(t))]}function en(t,e){return{id:`ev-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,6)}`,timestamp:new Date().toISOString(),type:t,payload:e}}function iye(t){let e;try{e=yH("git",["config","user.name"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{}if(!e)try{e=eye().username}catch{e=void 0}return{author:"human",name:e,timestamp:new Date().toISOString()}}function oye(t){try{return yH("git",["rev-parse","HEAD"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()}catch{return}}function jf(t,e){try{let r=ba(t);for(let n=r.length-1;n>=0;n--)if(r[n].type===e)return r[n]}catch{}return null}function tr(t,e,r){try{let n=oye(t),i=iye(t),o={...r,head:n,identity:i};if(e==="gate_run"){let s=jf(t,"gate_run");if(s&&s.payload.head===n&&s.payload.tier===r.tier&&s.payload.strict===r.strict&&s.payload.worst===r.worst)return}Qr(t,en(e,o))}catch{}}var _H,rye,bH,nye,Nr=y(()=>{"use strict";_H=".cladding",rye="events.log.jsonl",bH="events.log.1.jsonl",nye=5*1024*1024});import{execFileSync as sye}from"node:child_process";import{existsSync as vH,readdirSync as aye,readFileSync as cye,statSync as SH}from"node:fs";import{createHash as lye}from"node:crypto";import{join as CO}from"node:path";function va(t){try{return sye("git",["rev-parse","HEAD"],{cwd:t,stdio:["ignore","pipe","ignore"]}).toString("utf8").trim()||null}catch{return null}}function DO(t){let e=[],r=CO(t,"spec.yaml");vH(r)&&SH(r).isFile()&&e.push(r);for(let i of["features","scenarios"]){let o=CO(t,"spec",i);if(!(!vH(o)||!SH(o).isDirectory()))for(let s of aye(o))s.endsWith(".yaml")&&e.push(CO(o,s))}e.sort();let n=lye("sha256");for(let i of e){let o=i.slice(t.length+1);n.update(`${o}\0`),n.update(cye(i)),n.update("\0")}return n.digest("hex")}function A_(t,e){let r={featureId:e,gitHead:va(t),specDigest:DO(t),timestamp:new Date().toISOString()};return Qr(t,en("feature_checkpoint",{feature:e,git_head:r.gitHead,spec_digest:r.specDigest})),r}function T_(t,e){let r=ba(t);for(let n=r.length-1;n>=0;n--){let i=r[n];if(i.type==="feature_checkpoint"&&i.payload.feature===e)return{featureId:e,gitHead:i.payload.git_head??null,specDigest:String(i.payload.spec_digest??""),timestamp:i.timestamp}}return null}function O_(t,e,r,n){let i=en("feature_rolled_back",{feature:e,to_git_head:r.gitHead,to_spec_digest:r.specDigest,to_checkpoint_at:r.timestamp,reason:n??null});return Qr(t,i),i}var Mf=y(()=>{"use strict";Nr()});import{readFileSync as uye,statSync as dye}from"node:fs";import{extname as fye,resolve as NO,sep as pye}from"node:path";function tn(t){return Math.ceil(t.length/4)}function gye(t,e){let r=NO(e),n=NO(r,t);return n===r||n.startsWith(r+pye)}function xH(t,e,r,n){if(!gye(t,e))return{path:t,omitted:"unsafe-path"};if(!mye.has(fye(t).toLowerCase()))return{path:t,omitted:"unsupported"};let i,o;if(n){let l=n(t);if(l==null)return{path:t,omitted:"missing"};if(i=l,o=Buffer.byteLength(l,"utf8"),o>wH)return{path:t,omitted:"too-large",bytes:o}}else{let l=NO(e,t);try{o=dye(l).size}catch{return{path:t,omitted:"missing"}}if(o>wH)return{path:t,omitted:"too-large",bytes:o};try{i=uye(l,"utf8")}catch{return{path:t,omitted:"missing",bytes:o}}}if(i.includes(hye))return{path:t,omitted:"binary",bytes:o};let s=Math.max(0,Math.floor(r));if(i.length<=s)return{path:t,text:i,bytes:o};let a=` +`,r)+1}return{type:e,offset:this.offset,indent:this.indent,source:this.source}}startBlockValue(e){switch(this.type){case"alias":case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return this.flowScalar(this.type);case"block-scalar-header":return{type:"block-scalar",offset:this.offset,indent:this.indent,props:[this.sourceToken],source:""};case"flow-map-start":case"flow-seq-start":return{type:"flow-collection",offset:this.offset,indent:this.indent,start:this.sourceToken,items:[],end:[]};case"seq-item-ind":return{type:"block-seq",offset:this.offset,indent:this.indent,items:[{start:[this.sourceToken]}]};case"explicit-key-ind":{this.onKeyLine=!0;let r=y_(e),n=ll(r);return n.push(this.sourceToken),{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:n,explicitKey:!0}]}}case"map-value-ind":{this.onKeyLine=!0;let r=y_(e),n=ll(r);return{type:"block-map",offset:this.offset,indent:this.indent,items:[{start:n,key:null,sep:[this.sourceToken]}]}}}return null}atIndentedComment(e,r){return this.type!=="comment"||this.indent<=r?!1:e.every(n=>n.type==="newline"||n.type==="space")}*documentEnd(e){this.type!=="doc-mode"&&(e.end?e.end.push(this.sourceToken):e.end=[this.sourceToken],this.type==="newline"&&(yield*this.pop()))}*lineEnd(e){switch(this.type){case"comma":case"doc-start":case"doc-end":case"flow-seq-end":case"flow-map-end":case"map-value-ind":yield*this.pop(),yield*this.step();break;case"newline":this.onKeyLine=!1;default:e.end?e.end.push(this.sourceToken):e.end=[this.sourceToken],this.type==="newline"&&(yield*this.pop())}}};aH.Parser=wO});var fH=v(Nf=>{"use strict";var cH=lO(),Sge=Ef(),Df=Of(),wge=aT(),xge=De(),$ge=SO(),lH=xO();function uH(t){let e=t.prettyErrors!==!1;return{lineCounter:t.lineCounter||e&&new $ge.LineCounter||null,prettyErrors:e}}function kge(t,e={}){let{lineCounter:r,prettyErrors:n}=uH(e),i=new lH.Parser(r?.addNewLine),o=new cH.Composer(e),s=Array.from(o.compose(i.parse(t)));if(n&&r)for(let a of s)a.errors.forEach(Df.prettifyError(t,r)),a.warnings.forEach(Df.prettifyError(t,r));return s.length>0?s:Object.assign([],{empty:!0},o.streamInfo())}function dH(t,e={}){let{lineCounter:r,prettyErrors:n}=uH(e),i=new lH.Parser(r?.addNewLine),o=new cH.Composer(e),s=null;for(let a of o.compose(i.parse(t),!0,t.length))if(!s)s=a;else if(s.options.logLevel!=="silent"){s.errors.push(new Df.YAMLParseError(a.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}return n&&r&&(s.errors.forEach(Df.prettifyError(t,r)),s.warnings.forEach(Df.prettifyError(t,r))),s}function Ege(t,e,r){let n;typeof e=="function"?n=e:r===void 0&&e&&typeof e=="object"&&(r=e);let i=dH(t,r);if(!i)return null;if(i.warnings.forEach(o=>wge.warn(i.options.logLevel,o)),i.errors.length>0){if(i.options.logLevel!=="silent")throw i.errors[0];i.errors=[]}return i.toJS(Object.assign({reviver:n},r))}function Age(t,e,r){let n=null;if(typeof e=="function"||Array.isArray(e)?n=e:r===void 0&&e&&(r=e),typeof r=="string"&&(r=r.length),typeof r=="number"){let i=Math.round(r);r=i<1?void 0:i>8?{indent:8}:{indent:i}}if(t===void 0){let{keepUndefined:i}=r??e??{};if(!i)return}return xge.isDocument(t)&&!n?t.toString(r):new Sge.Document(t,n,r).toString(r)}Nf.parse=Ege;Nf.parseAllDocuments=kge;Nf.parseDocument=dH;Nf.stringify=Age});var er=v(Ze=>{"use strict";var Tge=lO(),Oge=Ef(),Rge=BT(),$O=Of(),Ige=uf(),ts=De(),Pge=Jo(),Cge=Dt(),Dge=Xo(),Nge=Qo(),jge=h_(),Mge=bO(),Fge=SO(),Lge=xO(),b_=fH(),pH=sf();Ze.Composer=Tge.Composer;Ze.Document=Oge.Document;Ze.Schema=Rge.Schema;Ze.YAMLError=$O.YAMLError;Ze.YAMLParseError=$O.YAMLParseError;Ze.YAMLWarning=$O.YAMLWarning;Ze.Alias=Ige.Alias;Ze.isAlias=ts.isAlias;Ze.isCollection=ts.isCollection;Ze.isDocument=ts.isDocument;Ze.isMap=ts.isMap;Ze.isNode=ts.isNode;Ze.isPair=ts.isPair;Ze.isScalar=ts.isScalar;Ze.isSeq=ts.isSeq;Ze.Pair=Pge.Pair;Ze.Scalar=Cge.Scalar;Ze.YAMLMap=Dge.YAMLMap;Ze.YAMLSeq=Nge.YAMLSeq;Ze.CST=jge;Ze.Lexer=Mge.Lexer;Ze.LineCounter=Fge.LineCounter;Ze.Parser=Lge.Parser;Ze.parse=b_.parse;Ze.parseAllDocuments=b_.parseAllDocuments;Ze.parseDocument=b_.parseDocument;Ze.stringify=b_.stringify;Ze.visit=pH.visit;Ze.visitAsync=pH.visitAsync});import{execFileSync as mH}from"node:child_process";import{existsSync as v_}from"node:fs";import{join as S_,resolve as zge}from"node:path";function Uge(t){try{let e=mH("git",["rev-parse","--git-dir"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return e?zge(t,e):null}catch{return null}}function kO(t){let e=Uge(t);if(!e)return null;try{if(v_(S_(e,"MERGE_HEAD")))return"merge";if(v_(S_(e,"CHERRY_PICK_HEAD")))return"cherry-pick";if(v_(S_(e,"rebase-merge"))||v_(S_(e,"rebase-apply")))return"rebase"}catch{return null}return null}function ya(t){return kO(t)!==null}function EO(t,e){try{let r=mH("git",["rev-parse","--verify","--quiet",`${e}^{commit}`],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return r.length>0?r:null}catch{return null}}function w_(t,e){return EO(t,e)!==null}var _a=y(()=>{"use strict"});import{execFileSync as qge}from"node:child_process";import{existsSync as Bge,readFileSync as Hge}from"node:fs";import{join as yH}from"node:path";function jf(t,e){return qge("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function rs(t){try{let e=jf(t,["describe","--tags","--abbrev=0"]).trim();if(e.length>0)return e}catch{}throw new Error("changelog: no git tag found to anchor the default range \u2014 pass --since explicitly (e.g. clad changelog --since v1.0.0)")}function ns(t,e){Gge(t,e);let r=jf(t,["rev-parse","HEAD"]).trim(),n=Zge(t,e);return{groups:Vge(t,n),head:r,inventory:{after:gH($_(t,"spec.yaml")),before:gH(AO(t,e,"spec.yaml"))},since:e,unsharded_commits:Yge(t,e)}}function TO(t){if(t.text&&t.text.trim().length>0)return t.text.trim();let e=t.action?.trim();if(!e)return null;let r=t.condition?.trim(),n=t.response?.trim(),i=r?`${r.charAt(0).toUpperCase()}${r.slice(1)}, the system shall ${e}`:`The system shall ${e}`;return n?`${i} \u2014 ${n}.`:`${i}.`}function Gge(t,e){let r=(e??"").trim();if(r.length===0)throw new Error("changelog: empty since ref \u2014 pass --since ");if(!w_(t,r))throw new Error(`changelog: '${r}' does not resolve to a commit in this repository \u2014 pass --since that exists. An unknown ref is an error, never a silently empty changelog.`)}function Zge(t,e){let r=jf(t,["diff","--name-status",`${e}..HEAD`,"--","spec/"]),n=[];for(let i of r.split(` +`)){if(i.trim().length===0)continue;let o=i.split(" "),s=o[0]??"",a=o[1]??"",c=o.length>2?o[2]:a;if(!(!hH(c)&&!hH(a)))if(s.startsWith("A")){let l=x_($_(t,c));if(!l)continue;l.status==="done"?n.push(ul(l,"added-as-done")):l.status==="archived"&&n.push(ul(l,"archived"))}else if(s.startsWith("D")){let l=x_(AO(t,e,a));l&&n.push(ul(l,"archived"))}else{let l=x_($_(t,c));if(!l)continue;let d=x_(AO(t,e,a))?.status;l.status==="done"&&d!=="done"?n.push(ul(l,"flipped-to-done")):l.status==="done"&&d==="done"?n.push(ul(l,"modified-while-done")):l.status==="archived"&&d!=="archived"&&n.push(ul(l,"archived"))}}return n.sort((i,o)=>i.id.localeCompare(o.id)),n}function hH(t){return t.startsWith("spec/features/")&&(t.endsWith(".yaml")||t.endsWith(".yml"))}function ul(t,e){return{acceptance:(t.acceptance_criteria??[]).map(n=>TO(n)).filter(n=>n!==null),change:e,id:t.id,...t.slug?{slug:t.slug}:{},title:t.title}}function x_(t){if(t===null)return null;let e;try{e=(0,k_.parse)(t)}catch{return null}let r=e;return!r||typeof r.id!="string"||typeof r.status!="string"?null:{id:r.id,slug:typeof r.slug=="string"?r.slug:void 0,title:typeof r.title=="string"?r.title:r.id,status:r.status,acceptance_criteria:r.acceptance_criteria}}function $_(t,e){let r=yH(t,e);if(!Bge(r))return null;try{return Hge(r,"utf8")}catch{return null}}function AO(t,e,r){try{return jf(t,["show",`${e}:${r}`])}catch{return null}}function Vge(t,e){let r=Wge(t).filter(s=>typeof s.id=="string"&&s.id.length>0).sort((s,a)=>s.id.localeCompare(a.id)),n=[],i=new Set;for(let s of r){let a=new Set(s.features??[]),c=e.filter(l=>a.has(l.id)&&!i.has(l.id));if(c.length!==0){for(let l of c)i.add(l.id);n.push({capability:s.id,features:c,title:s.title??s.id})}}let o=e.filter(s=>!i.has(s.id));return o.length>0&&n.push({capability:"uncategorized",features:o,title:"Uncategorized"}),n}function Wge(t){let e=$_(t,yH("spec","capabilities.yaml"));if(e===null)return[];try{let r=(0,k_.parse)(e);return Array.isArray(r?.capabilities)?r.capabilities:[]}catch{return[]}}function gH(t){let e={};if(t!==null)try{let n=(0,k_.parse)(t);n&&typeof n.inventory=="object"&&n.inventory!==null&&(e=n.inventory)}catch{}let r=n=>typeof e[n]=="number"?e[n]:0;return{capabilities:r("capabilities"),features:r("features"),scenarios:r("scenarios"),test_files:r("test_files")}}function Yge(t,e){let r=jf(t,["log",`${e}..HEAD`,"--format=%h%x09%s","--","src/"]),n=[];for(let i of r.split(` +`)){if(i.trim().length===0)continue;let o=i.indexOf(" ");if(o<0)continue;let s=i.slice(0,o),a=i.slice(o+1);Kge.test(a)&&(Jge.test(a)||n.push({hash:s,subject:a}))}return n}var k_,Kge,Jge,dl=y(()=>{"use strict";k_=St(er(),1);_a();Kge=/^(feat|fix)(\([^)]*\))?!?:/,Jge=/\bF-(\d{3,}|[a-f0-9]{6,})\b/});import{execFileSync as _H}from"node:child_process";import{appendFileSync as Xge,existsSync as OO,mkdirSync as Qge,readFileSync as eye,renameSync as tye,statSync as rye}from"node:fs";import{userInfo as nye}from"node:os";import{dirname as iye,join as IO}from"node:path";function PO(t){return IO(t,bH,oye)}function en(t,e){let r=PO(t),n=iye(r);OO(n)||Qge(n,{recursive:!0});try{OO(r)&&rye(r).size>sye&&tye(r,IO(n,vH))}catch{}Xge(r,`${JSON.stringify(e)} +`,"utf8")}function RO(t){if(!OO(t))return[];let e=eye(t,"utf8").trim();return e.length===0?[]:e.split(` +`).filter(r=>r.length>0).map(r=>JSON.parse(r))}function ba(t){return RO(PO(t))}function E_(t){return[...RO(IO(t,bH,vH)),...RO(PO(t))]}function tn(t,e){return{id:`ev-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,6)}`,timestamp:new Date().toISOString(),type:t,payload:e}}function aye(t){let e;try{e=_H("git",["config","user.name"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{}if(!e)try{e=nye().username}catch{e=void 0}return{author:"human",name:e,timestamp:new Date().toISOString()}}function cye(t){try{return _H("git",["rev-parse","HEAD"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()}catch{return}}function Mf(t,e){try{let r=ba(t);for(let n=r.length-1;n>=0;n--)if(r[n].type===e)return r[n]}catch{}return null}function tr(t,e,r){try{let n=cye(t),i=aye(t),o={...r,head:n,identity:i};if(e==="gate_run"){let s=Mf(t,"gate_run");if(s&&s.payload.head===n&&s.payload.tier===r.tier&&s.payload.strict===r.strict&&s.payload.worst===r.worst)return}en(t,tn(e,o))}catch{}}var bH,oye,vH,sye,jr=y(()=>{"use strict";bH=".cladding",oye="events.log.jsonl",vH="events.log.1.jsonl",sye=5*1024*1024});import{execFileSync as lye}from"node:child_process";import{existsSync as SH,readdirSync as uye,readFileSync as dye,statSync as wH}from"node:fs";import{createHash as fye}from"node:crypto";import{join as CO}from"node:path";function va(t){try{return lye("git",["rev-parse","HEAD"],{cwd:t,stdio:["ignore","pipe","ignore"]}).toString("utf8").trim()||null}catch{return null}}function DO(t){let e=[],r=CO(t,"spec.yaml");SH(r)&&wH(r).isFile()&&e.push(r);for(let i of["features","scenarios"]){let o=CO(t,"spec",i);if(!(!SH(o)||!wH(o).isDirectory()))for(let s of uye(o))s.endsWith(".yaml")&&e.push(CO(o,s))}e.sort();let n=fye("sha256");for(let i of e){let o=i.slice(t.length+1);n.update(`${o}\0`),n.update(dye(i)),n.update("\0")}return n.digest("hex")}function A_(t,e){let r={featureId:e,gitHead:va(t),specDigest:DO(t),timestamp:new Date().toISOString()};return en(t,tn("feature_checkpoint",{feature:e,git_head:r.gitHead,spec_digest:r.specDigest})),r}function T_(t,e){let r=ba(t);for(let n=r.length-1;n>=0;n--){let i=r[n];if(i.type==="feature_checkpoint"&&i.payload.feature===e)return{featureId:e,gitHead:i.payload.git_head??null,specDigest:String(i.payload.spec_digest??""),timestamp:i.timestamp}}return null}function O_(t,e,r,n){let i=tn("feature_rolled_back",{feature:e,to_git_head:r.gitHead,to_spec_digest:r.specDigest,to_checkpoint_at:r.timestamp,reason:n??null});return en(t,i),i}var Ff=y(()=>{"use strict";jr()});import{readFileSync as pye,statSync as mye}from"node:fs";import{extname as hye,resolve as NO,sep as gye}from"node:path";function rn(t){return Math.ceil(t.length/4)}function bye(t,e){let r=NO(e),n=NO(r,t);return n===r||n.startsWith(r+gye)}function $H(t,e,r,n){if(!bye(t,e))return{path:t,omitted:"unsafe-path"};if(!yye.has(hye(t).toLowerCase()))return{path:t,omitted:"unsupported"};let i,o;if(n){let l=n(t);if(l==null)return{path:t,omitted:"missing"};if(i=l,o=Buffer.byteLength(l,"utf8"),o>xH)return{path:t,omitted:"too-large",bytes:o}}else{let l=NO(e,t);try{o=mye(l).size}catch{return{path:t,omitted:"missing"}}if(o>xH)return{path:t,omitted:"too-large",bytes:o};try{i=pye(l,"utf8")}catch{return{path:t,omitted:"missing",bytes:o}}}if(i.includes(_ye))return{path:t,omitted:"binary",bytes:o};let s=Math.max(0,Math.floor(r));if(i.length<=s)return{path:t,text:i,bytes:o};let a=` /* ... clipped (${o} bytes total) ... */ -`,c=Math.max(0,s-a.length);return{path:t,text:i.slice(0,c)+a,truncated:!0,bytes:o}}var mye,wH,hye,R_=y(()=>{"use strict";mye=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".rs",".go",".java",".kt",".kts",".cs",".rb",".php",".swift",".c",".h",".cpp",".hpp",".css",".scss",".sql",".sh",".yaml",".yml",".json",".md",".toml"]),wH=2e6,hye="\0"});function _ye(t){for(let i of yye)if(t.startsWith(i))return null;let e=t.indexOf("#"),n=(e>=0?t.slice(0,e):t).trim();return n.length>0?n:null}function jO(t,e,r){let n=t.get(e);n||(n=new Set,t.set(e,n)),n.add(r)}function bye(t){let e=new Map,r=new Map,n=new Map;for(let i of t.features??[]){let o=i.id;for(let s of i.depends_on??[])jO(e,s,o);for(let s of i.modules??[])jO(r,s,o);for(let s of i.acceptance_criteria??[])for(let a of s.test_refs??[]){let c=_ye(a);c&&jO(n,c,o)}}return{dependents:e,moduleOwners:r,testRefCitations:n}}function An(t){let e=$H.get(t);return e||(e=bye(t),$H.set(t,e)),e}var yye,$H,Sa=y(()=>{"use strict";yye=["derived:","fixture:","script:","self-dogfood:"];$H=new WeakMap});function MO(t,e,r=1/0){let n=new Set,i=new Set(t),o=[...i],s=0;for(;o.length>0&&sn.id===e)??r.find(n=>n.slug===e)??null}function vr(t,e,r={}){let n=r.depth??1/0,i=An(t),o=new Map((t.features??[]).map(_=>[_.id,_])),s=[],a,c=vye(t,e);if(c)s=[c];else{let _=i.moduleOwners.get(e);_&&_.size>0&&(a=e,s=[..._].map(S=>o.get(S)).filter(S=>!!S))}if(s.length===0)return{not_found:e,accepted_forms:["feature id (F-\u2026)","slug","module path (e.g. src/spec/load.ts)"],discovery:"grep spec/index.yaml \u2014 one line per feature (run clad sync if missing); module paths live in each shard\u2019s modules:; if the query is a file, fall back to normal code search \u2014 the graph only knows declared modules"};let l=s.map(_=>_.id),u=MO(l,i.dependents,n),d=[...u].map(_=>o.get(_)).filter(_=>!!_).map(_=>({id:_.id,title:_.title,status:_.status})).sort((_,S)=>_.id.localeCompare(S.id)),f=new Set([...l,...u]),p=[...f].map(_=>o.get(_)).filter(_=>!!_),m=[...new Set(p.flatMap(_=>_.modules??[]))].sort(),h=(t.scenarios??[]).filter(_=>(_.features??[]).some(S=>f.has(S))).map(_=>({id:_.id,title:_.title})).sort((_,S)=>_.id.localeCompare(S.id)),g=[...new Set(p.flatMap(_=>(_.acceptance_criteria??[]).flatMap(S=>S.test_refs??[])))].sort();return{focus:a?{module:a,owners:[...l].sort()}:{id:s[0].id,title:s[0].title,status:s[0].status},impacted:d,impacted_modules:m,scenarios:h,test_refs:g,ledger:FO(i)}}var wa=y(()=>{"use strict";Sa()});function kH(t){return t.impacted.length}function P_(t,e,r={}){let n=r.initialDepth??I_.initialDepth,i=r.maxDepth??I_.maxDepth,o=r.coverageThreshold??I_.coverageThreshold,s=r.marginYieldThreshold??I_.marginYieldThreshold,a=An(t),c=new Map((t.features??[]).map(b=>[b.id,b])),l=[],u=(t.features??[]).find(b=>b.id===e||b.slug===e);if(u)l=[u.id];else{let b=a.moduleOwners.get(e);b&&b.size>0&&(l=[...b].filter(_=>c.has(_)))}if(l.length===0){let b=vr(t,e,{depth:1});return"not_found"in b,b}let d=MO(l,a.dependents,1/0).size;if(d===0){let b=vr(t,e,{depth:n});return"not_found"in b?b:{slice:b,depthUsed:n,stoppedBy:"no-known-dependents",analysis:{frontierExhausted:!0,coverage:null,marginalYields:[0],totalKnownDependents:0}}}let f=[],p=0,m=null;for(let b=n;b<=i;b++){let _=vr(t,e,{depth:b});if("not_found"in _)return _;m=_;let S=kH(_),x=S-p,w=S>0?x/S:0;f.push(w);let O=d>0?S/d:1,T=x===0&&b>n,A={frontierExhausted:T,coverage:O,marginalYields:[...f],totalKnownDependents:d};if(T)return{slice:_,depthUsed:b,stoppedBy:"exhaustion",analysis:A};if(O>=o)return{slice:_,depthUsed:b,stoppedBy:"coverage",analysis:A};if(f.length>=2&&f[f.length-1]0?g/d:1,marginalYields:[...f],totalKnownDependents:d}}}var I_,LO=y(()=>{"use strict";wa();Sa();I_={initialDepth:1,maxDepth:10,coverageThreshold:.9,marginYieldThreshold:.05}});function Sye(t,e){let r=new Set,n=[t];for(;n.length>0;){let i=n.pop();if(!i||r.has(i))continue;r.add(i);let o=e.get(i);for(let s of o?.depends_on??[])n.push(s)}return r}function EH(t,e){let r=new Map(t.features.map(a=>[a.id,a]));if(!r.has(e))return t;let n=Sye(e,r),i=t.features.filter(a=>n.has(a.id)),o=(t.scenarios??[]).filter(a=>(a.features??[]).some(c=>n.has(c)));return{...t,features:i,scenarios:o}}var AH=y(()=>{"use strict"});function wye(t,e){let r=t.features??[];return r.find(n=>n.id===e)??r.find(n=>n.slug===e)??r.find(n=>(n.modules??[]).includes(e))??null}function fl(t,e){let r=wye(t,e);if(!r)return{not_found:e,accepted_forms:["feature id (F-\u2026)","slug","module path (e.g. src/auth/login.ts)"],discovery:"grep spec/index.yaml \u2014 one line per feature (id, slug, status; run clad sync if missing); if the query is a file, fall back to normal code search \u2014 the graph only knows declared modules"};let n=EH(t,r.id),i=(n.features??[]).filter(c=>c.id!==r.id).map(c=>({id:c.id,title:c.title,status:c.status})).sort((c,l)=>c.id.localeCompare(l.id)),o=(n.scenarios??[]).map(c=>({id:c.id,title:c.title})).sort((c,l)=>c.id.localeCompare(l.id)),s=(t.project?.ai_hints?.preferred_patterns??[]).map(c=>({when:c.when,prefer:c.prefer,...c.over!==void 0?{over:c.over}:{}})),a=[...new Set((r.acceptance_criteria??[]).flatMap(c=>c.test_refs??[]))].sort();return{focus:r,ancestors:i,scenarios:o,preferred_patterns:s,test_refs:a}}var C_=y(()=>{"use strict";AH()});import{existsSync as OH,readdirSync as xye,readFileSync as $ye}from"node:fs";import{join as UO}from"node:path";function qO(t,e=Eye){let r=t.trim().replace(/\s+/g," ");return r.length<=e?r:`${r.slice(0,e-1)}\u2026`}function Aye(t){let e=t.payload??{};if(t.type==="drift_detected"){let n=typeof e.gate=="string"&&e.gate?e.gate:"drift";return{detector:n,message:qO(`drift detected at gate ${n}`)}}let r=typeof e.worst=="number"?` (worst ${e.worst})`:"";return{detector:"done_attempted",message:qO(`done reverted \u2014 pre-push strict gate red${r}`)}}function TH(t){let e=Date.parse(t.timestamp);return Number.isFinite(e)?e:0}function Tye(t){let e=[];t.lastFailedGate&&e.push(`failed ${t.lastFailedGate}`),typeof t.retryCount=="number"&&e.push(`${t.retryCount} retries`);let r=e.length?` (${e.join(", ")})`:"",n=t.recovery?`recover: ${t.recovery}${r}`:`rolled back${r}`;return qO(n)}function Oye(t,e,r,n={}){let i=t.filter(m=>m&&m.payload&&m.payload.feature===r),o=e.filter(m=>m&&m.featureId===r).slice().sort((m,h)=>TH(m)-TH(h)),s=i.filter(m=>m.type==="drift_detected"||m.type==="done_attempted"&&m.payload.kept===!1),a=i.filter(m=>m.type==="feature_rolled_back");if(s.length===0&&a.length===0&&o.length===0)return;let c=o.length?o[o.length-1]:void 0,l;for(let m=s.length-1;m>=0;m--){let h=s[m].payload.gate;if(s[m].type==="drift_detected"&&typeof h=="string"&&h){l=h;break}}!l&&c?.lastFailedGate&&(l=c.lastFailedGate);let u=s.slice(-kye).map(Aye),d;for(let m=a.length-1;m>=0;m--){let h=a[m].payload.to_git_head;if(typeof h=="string"&&h){d=h;break}}let f=typeof c?.retryCount=="number"?c.retryCount:void 0,p=c?Tye(c):void 0;return{attempts:s.length,...l?{last_failed_gate:l}:{},...f!==void 0?{retry_count:f}:{},...u.length?{drift_history:u}:{},...d?{rolled_back_at:d}:{},...p?{recovery_hint:p}:{},...n.truncated?{truncated_history:!0}:{}}}function zO(t,e){let r=t.match(e);return r&&r[1]?r[1].trim():void 0}function Rye(t){let e=t.indexOf("## Recommended recovery");if(e<0)return;let r=t.slice(e).match(/```[^\n]*\n([\s\S]*?)```/);return r&&r[1].split(` -`).map(i=>i.trim()).find(i=>i.length>0)||void 0}function Iye(t,e,r){let n=zO(t,/_Rolled back at_\s*`([^`]+)`/),i=zO(t,/Last failed gate:\s*`([^`]+)`/),o=zO(t,/Retry attempts:\s*(\d+)/),s=Rye(t);return{featureId:e,timestamp:n??r,...i?{lastFailedGate:i}:{},...o?{retryCount:Number(o)}:{},...s?{recovery:s}:{}}}function Pye(t,e){let r=UO(t,".cladding","post-mortems");if(!OH(r))return[];let n=`post-mortem-${e}-`,i=[];for(let o of xye(r))if(!(!o.startsWith(n)||!o.endsWith(".md")))try{i.push(Iye($ye(UO(r,o),"utf8"),e,o))}catch{}return i}function RH(t,e){try{let r=E_(t),n=Pye(t,e),i=OH(UO(t,".cladding","events.log.1.jsonl"));return Oye(r,n,e,{truncated:i})}catch{return}}var kye,Eye,IH=y(()=>{"use strict";Nr();kye=5,Eye=120});function D_(t,e,r){return tn(JSON.stringify({...t,needs:e,must_edit:{...t.must_edit,code:r}}))}function xa(t,e,r={}){let n=r.cwd??".",i=r.maxTokens&&r.maxTokens>0?r.maxTokens:Cye,o=e,s,a=An(t).moduleOwners.get(e);if(a&&a.size>0){let se=[...a].sort();o=se[0],se.length>1&&(s=se)}let c=fl(t,o);if("not_found"in c)return c;let l=c.focus,u=RH(n,l.id),d=a&&a.size>0?e:l.id,f=P_(t,d),p="not_found"in f?null:f.slice,m=p?p.impacted:[],h=p?p.test_refs:[],g="not_found"in f?null:{depth:f.depthUsed,stopped_by:f.stoppedBy,coverage:f.analysis.coverage===null?null:Math.round(f.analysis.coverage*100)/100,total_known_dependents:f.analysis.totalKnownDependents},b=l.acceptance_criteria??[],_=b.filter(se=>se.ears==="unwanted"||se.ears==="state").map(se=>({id:se.id,ears:String(se.ears)})),S=[...new Set(b.flatMap(se=>se.oracle_refs??[]))].sort(),x=[],w={must_edit:{id:l.id,title:l.title,status:l.status,modules:l.modules??[],acceptance_criteria:b,code:[],...s?{co_owners:s}:{}},needs:c.ancestors,breaks_if_changed:{impacted:m,regression_tests:h,...g?{radius:g}:{}},verify:{scenarios:c.scenarios,test_refs:c.test_refs,oracle_refs:S,high_risk_acs:_},guidance:{preferred_patterns:c.preferred_patterns},budget:{max_tokens:i,used_tokens:0,truncated:x}},O=[...c.ancestors];for(;O.length>Dye&&D_(w,O,[])>i;)O.pop();O.lengthi){x.push(`code: omitted ${se} (budget)`);continue}A.push(Kt),Kt.truncated&&x.push(`code: clipped ${se}`)}T>i&&x.push("must-edit exceeds budget \u2014 retained in full (focus is never dropped)");let D=(se,Ce)=>({impacted:se,regression_tests:Ce,...g?{radius:g}:{},...p?.ledger?{ledger:p.ledger}:{}}),$=(se,Ce,Kt,dr)=>{let Xt=Kt+dr>0?[`breaks: omitted ${Kt} feature(s) / ${dr} test(s)`]:[],lo={...w,needs:O,must_edit:{...w.must_edit,code:A},breaks_if_changed:D(se,Ce),budget:{...w.budget,truncated:[...x,...Xt]}};return tn(JSON.stringify(lo))>i},re=m,K=h;if($(re,K,0,0)){let se=vr(t,d,{depth:1}),Ce=new Set("not_found"in se?[]:se.impacted.map(de=>de.id)),Kt=new Set("not_found"in se?[]:se.test_refs),Xt=[...m.filter(de=>Ce.has(de.id)),...m.filter(de=>!Ce.has(de.id))],lo=0;for(;Xt.length>Ce.size&&$(Xt,K,lo,0);)Xt=Xt.slice(0,-1),lo++;let $i=[...h],Xr=0;for(;$(Xt,$i,lo,Xr);){let de=-1;for(let uo=$i.length-1;uo>=0;uo--)if(!Kt.has($i[uo])){de=uo;break}if(de<0)break;$i.splice(de,1),Xr++}re=Xt,K=$i,lo+Xr>0&&x.push(`breaks: omitted ${lo} feature(s) / ${Xr} test(s)`),$(re,K,0,0)&&x.push("breaks: direct set retained in full \u2014 exceeds budget")}let xe=D(re,K),C={...w,needs:O,must_edit:{...w.must_edit,code:A},breaks_if_changed:xe},P=C;if(u){let se={...C,prior_attempts:u};tn(JSON.stringify(se))<=i?P=se:x.push("prior_attempts: omitted (budget)")}let Ir=tn(JSON.stringify(P));return{...P,budget:{max_tokens:i,used_tokens:Ir,truncated:x}}}var Cye,Dye,N_=y(()=>{"use strict";R_();C_();LO();IH();wa();Sa();Cye=3e3,Dye=3});function Yn(t){if(t.length===0)return 0;let e=[...t].sort((n,i)=>n-i),r=Math.floor(e.length/2);return e.length%2?e[r]:(e[r-1]+e[r])/2}function Nye(t,e){if(t.length===0)return 0;let r=[...t].sort((n,i)=>n-i);return r[Math.min(r.length-1,Math.floor(e/100*r.length))]}function PH(t,e,r="."){let n=An(t),i=t.features??[],o=[];for(let f of i){let p=xa(t,f.id,{cwd:r,read:e});if("not_found"in p)continue;let m=xa(t,f.id,{cwd:r,read:e,maxTokens:Number.MAX_SAFE_INTEGER}),h=P_(t,f.id),g=!("not_found"in h),b=tn(JSON.stringify(p)),_="not_found"in m?b:tn(JSON.stringify(m)),S=tn(JSON.stringify(f));for(let O of f.modules??[]){let T=e(O);T&&(S+=tn(T))}let x=(f.depends_on??[]).length,w=n.dependents.get(f.id)?.size??0;o.push({id:f.id,sliceTokens:b,structuralTokens:_,naiveTokens:S,contextRatio:S>0?b/S:1,budgetSaturated:p.budget.truncated.length>0,searchDepth:g?h.depthUsed:1,edgesResolved:x+w,stoppedBy:g?h.stoppedBy:"n/a",coverage:g?h.analysis.coverage:1,regressionTests:p.breaks_if_changed.regression_tests.length})}o.sort((f,p)=>f.id.localeCompare(p.id));let s=o.map(f=>f.contextRatio),a=f=>f.filter(p=>p.sliceTokens>0).map(p=>p.naiveTokens/p.sliceTokens),c=o.filter(f=>!f.budgetSaturated),l=o.filter(f=>f.budgetSaturated),u=o.filter(f=>f.naiveTokens>0).map(f=>f.structuralTokens/f.naiveTokens),d={};for(let f of o)d[f.stoppedBy]=(d[f.stoppedBy]??0)+1;return{featureCount:i.length,measured:o.length,context:{medianContextRatio:Math.round(Yn(s)*1e3)/1e3,medianShrinkFactor:Math.round(Yn(a(o))*10)/10,fitsCount:c.length,truncatedCount:l.length,medianShrinkFit:Math.round(Yn(a(c))*10)/10,medianShrinkTruncated:Math.round(Yn(a(l))*10)/10,medianStructuralRatio:Math.round(Yn(u)*100)/100,medianSliceTokens:Math.round(Yn(o.map(f=>f.sliceTokens))),medianNaiveTokens:Math.round(Yn(o.map(f=>f.naiveTokens)))},search:{medianDepth:Yn(o.map(f=>f.searchDepth)),p95Depth:Nye(o.map(f=>f.searchDepth),95),medianEdges:Yn(o.map(f=>f.edgesResolved)),maxEdges:o.reduce((f,p)=>Math.max(f,p.edgesResolved),0)},stability:{byStopReason:d,medianCoverage:Math.round(Yn(o.map(f=>f.coverage).filter(f=>f!==null))*100)/100,medianRegressionTests:Yn(o.map(f=>f.regressionTests))},features:o}}var pl,j_=y(()=>{"use strict";R_();LO();N_();Sa();pl="(deterministic upper bound vs the shard+all-modules baseline \u2014 not an agent-adoption measurement)"});import{appendFileSync as jye,existsSync as BO,mkdirSync as Mye,readFileSync as CH}from"node:fs";import{dirname as Fye,join as Lye}from"node:path";function HO(t){return Lye(t,zye,Uye)}function qye(t,e){return{timestamp:new Date().toISOString(),head:va(t),spec_digest:DO(t),featureCount:e.featureCount,measured:e.measured,context:e.context,search:e.search,stability:e.stability}}function DH(t,e){try{let r=qye(t,e);if(r.head===null)return{appended:!1,reason:"no_head"};let n=GO(t),i=n[n.length-1];if(i&&i.head===r.head&&i.spec_digest===r.spec_digest)return{appended:!1,reason:"deduped"};let o=HO(t),s=Fye(o);return BO(s)||Mye(s,{recursive:!0}),jye(o,`${JSON.stringify(r)} -`,"utf8"),{appended:!0,reason:"appended"}}catch{return{appended:!1,reason:"error"}}}function NH(t){let e=[];for(let r of t.split(` -`)){let n=r.trim();if(n.length!==0)try{let i=JSON.parse(n);i&&typeof i=="object"&&i.context&&i.search&&i.stability&&e.push(i)}catch{}}return e}function GO(t,e){let r=HO(t);if(!BO(r))return[];let n;try{n=CH(r,"utf8")}catch{return[]}let i=NH(n);return typeof e=="number"&&e>=0?i.slice(-e):i}function jH(t){let e=HO(t);if(!BO(e))return{snapshots:[],unreadable:!1};let r;try{r=CH(e,"utf8")}catch{return{snapshots:[],unreadable:!0}}let n=NH(r),i=r.trim().length>0;return{snapshots:n,unreadable:i&&n.length===0}}function Ff(t,e=0){let r=e>0?Math.round(t*10**e)/10**e:Math.round(t),n=r.toFixed(e);return r>0?`+${n}`:n}function MH(t,e=5){let r=Math.max(0,t.length-e),i=[`measure trend \xB7 last ${t.slice(r).length} of ${t.length} snapshot(s)`];for(let o=r;o0?t[o-1]:null,c=(d,f=0)=>a?` (${Ff(d(s)-d(a),f)})`:"",l=s.timestamp.slice(0,19),u=s.head?s.head.slice(0,7):"nogit";i.push(` ${l} ${u} \xB7 ${s.featureCount} feat \xB7 slice ${s.context.medianSliceTokens}${c(d=>d.context.medianSliceTokens)} \xB7 struct ${s.context.medianStructuralRatio.toFixed(2)}${c(d=>d.context.medianStructuralRatio,2)} \xB7 cov ${s.stability.medianCoverage.toFixed(2)}${c(d=>d.stability.medianCoverage,2)} \xB7 p95depth ${s.search.p95Depth}${c(d=>d.search.p95Depth)} \xB7 trunc ${s.context.truncatedCount}${c(d=>d.context.truncatedCount)}`)}return i.push(` ${pl}`),i.join(` -`)}var zye,Uye,Lf=y(()=>{"use strict";Mf();j_();zye=".cladding",Uye="measure.jsonl"});import{existsSync as Bye}from"node:fs";import{join as Hye}from"node:path";function ml(t){if(t.groups.reduce((i,o)=>i+o.features.length,0)===0&&t.unsharded_commits.length===0)return`no shipped changes since ${t.since}`;let r=[`# Changes since ${t.since}`,""];for(let i of t.groups){r.push(`## ${i.title}`,"");for(let o of i.features){r.push(`- **${o.title}** (${Gye[o.change]})`);for(let s of o.acceptance)r.push(` - ${s}`)}r.push("")}if(t.unsharded_commits.length>0){r.push("## Other changes (not yet spec-tracked)","");for(let i of t.unsharded_commits)r.push(`- ${i.subject}`);r.push("")}let n=t.inventory;for((n.before.features!==n.after.features||n.before.scenarios!==n.after.scenarios)&&r.push(`_Spec inventory: ${n.before.features} \u2192 ${n.after.features} features, ${n.before.scenarios} \u2192 ${n.after.scenarios} scenarios._`,"");r[r.length-1]==="";)r.pop();return r.join(` -`)}function LH(t){let e=t.snapshot,r=["## Measured (this release)",""];if(!e||!e.head)return r.push("not measured at this commit \u2014 run clad measure before tagging"),r.join(` -`);let n=e.context,i=e.stability;r.push(`- features measured: ${e.measured} of ${e.featureCount}`),r.push(`- median slice tokens: ${n.medianSliceTokens} vs ${n.medianNaiveTokens} naive`),r.push(`- median structural ratio: ${n.medianStructuralRatio.toFixed(2)}`),r.push(`- median coverage: ${i.medianCoverage.toFixed(2)}`),r.push(`- regression tests surfaced: ${i.medianRegressionTests}`);let o=t.sinceSnapshot;if(o){let s=t.sinceRef??(o.head?o.head.slice(0,7):"previous");r.push(`- since ${s}: slice ${Ff(n.medianSliceTokens-o.context.medianSliceTokens)} \xB7 struct ${Ff(n.medianStructuralRatio-o.context.medianStructuralRatio,2)} \xB7 cov ${Ff(i.medianCoverage-o.stability.medianCoverage,2)}`)}return r.push("",`head ${e.head.slice(0,7)} \xB7 spec_digest ${e.spec_digest}`,`reproduce: git checkout ${e.head} && clad measure`,"",pl),r.join(` -`)}function hl(t,e,r){let n=[`# Audit \u2014 shipped changes since ${t.since}`,"","| feature | AC | EARS | verification refs |","|---|---|---|---|"],i=new Map(e.features.map(o=>[o.id,o]));for(let o of t.groups)for(let s of o.features){let a=i.get(s.id);if(!a){n.push(`| ${s.id} | \u2014 | \u2014 | (removed from spec \u2014 see git history at ${t.since}) |`);continue}let c=a.acceptance_criteria??[];if(c.length===0){n.push(`| ${a.id} | \u2014 | \u2014 | (no acceptance criteria) |`);continue}for(let l of c)n.push(`| ${a.id} | ${l.id} | ${l.ears??"\u2014"} | ${Vye(l,r)} |`)}return n.join(` -`)}function Vye(t,e){let r=[...t.test_refs??[],...t.oracle_refs??[],...t.evidence_refs??[]];return r.length===0?"(none)":r.map(n=>{for(let[o,s]of Zye)if(n.startsWith(o))return`${n} (${s})`;let i=n.split("#",1)[0]??n;return`${Bye(Hye(e,i))?"\u2713":"\u2717"} ${n}`}).join("
")}function gl(t){let e=[`# ${t.project.name} \u2014 capability catalog`,""],r=[...t.capabilities??[]].filter(s=>typeof s.id=="string"&&s.id.length>0).sort((s,a)=>s.id.localeCompare(a.id)),n=new Map(t.features.map(s=>[s.id,s])),i=new Set;for(let s of r){e.push(`## ${s.title??s.id}`,""),s.summary&&e.push(s.summary,"");for(let a of s.features??[]){let c=n.get(a);!c||c.status==="archived"||(i.add(a),FH(e,c))}}let o=t.features.filter(s=>!i.has(s.id)&&s.status!=="archived").sort((s,a)=>s.id.localeCompare(a.id));if(o.length>0){e.push("## Uncategorized","");for(let s of o)FH(e,s)}for(;e[e.length-1]==="";)e.pop();return e.join(` -`)}function FH(t,e){t.push(`### ${e.title}`,"");for(let r of e.acceptance_criteria??[]){let n=TO(r);n&&t.push(`- ${n}`)}t.push("")}var Gye,Zye,M_=y(()=>{"use strict";Lf();j_();dl();Gye={"added-as-done":"new","flipped-to-done":"completed","modified-while-done":"updated",archived:"retired"};Zye=[["derived:","machine-suggested \u2014 not author-confirmed"],["self-dogfood:","verified by cladding running on itself"],["fixture:","conformance fixture"],["script:","npm script"]]});import{readFileSync as Wye}from"node:fs";function Oi(t="./spec.yaml"){let e=Wye(t,"utf8");return(0,zH.parse)(e)}var zH,F_=y(()=>{"use strict";zH=St(er(),1)});var is=v((jr,KO)=>{"use strict";var ZO=jr.ValidationError=function(e,r,n,i,o,s){if(Array.isArray(i)?(this.path=i,this.property=i.reduce(function(c,l){return c+qH(l)},"instance")):i!==void 0&&(this.property=i),e&&(this.message=e),n){var a=n.$id||n.id;this.schema=a||n}r!==void 0&&(this.instance=r),this.name=o,this.argument=s,this.stack=this.toString()};ZO.prototype.toString=function(){return this.property+" "+this.message};var L_=jr.ValidatorResult=function(e,r,n,i){this.instance=e,this.schema=r,this.options=n,this.path=i.path,this.propertyPath=i.propertyPath,this.errors=[],this.throwError=n&&n.throwError,this.throwFirst=n&&n.throwFirst,this.throwAll=n&&n.throwAll,this.disableFormat=n&&n.disableFormat===!0};L_.prototype.addError=function(e){var r;if(typeof e=="string")r=new ZO(e,this.instance,this.schema,this.path);else{if(!e)throw new Error("Missing error detail");if(!e.message)throw new Error("Missing error message");if(!e.name)throw new Error("Missing validator type");r=new ZO(e.message,this.instance,this.schema,this.path,e.name,e.argument)}if(this.errors.push(r),this.throwFirst)throw new $a(this);if(this.throwError)throw r;return r};L_.prototype.importErrors=function(e){typeof e=="string"||e&&e.validatorType?this.addError(e):e&&e.errors&&(this.errors=this.errors.concat(e.errors))};function Kye(t,e){return e+": "+t.toString()+` -`}L_.prototype.toString=function(e){return this.errors.map(Kye).join("")};Object.defineProperty(L_.prototype,"valid",{get:function(){return!this.errors.length}});KO.exports.ValidatorResultError=$a;function $a(t){typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,$a),this.instance=t.instance,this.schema=t.schema,this.options=t.options,this.errors=t.errors}$a.prototype=new Error;$a.prototype.constructor=$a;$a.prototype.name="Validation Error";var UH=jr.SchemaError=function t(e,r){this.message=e,this.schema=r,Error.call(this,e),typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,t)};UH.prototype=Object.create(Error.prototype,{constructor:{value:UH,enumerable:!1},name:{value:"SchemaError",enumerable:!1}});var VO=jr.SchemaContext=function(e,r,n,i,o){this.schema=e,this.options=r,Array.isArray(n)?(this.path=n,this.propertyPath=n.reduce(function(s,a){return s+qH(a)},"instance")):this.propertyPath=n,this.base=i,this.schemas=o};VO.prototype.resolve=function(e){return BH(this.base,e)};VO.prototype.makeChild=function(e,r){var n=r===void 0?this.path:this.path.concat([r]),i=e.$id||e.id;let o=BH(this.base,i||"");var s=new VO(e,this.options,n,o,Object.create(this.schemas));return i&&!s.schemas[o]&&(s.schemas[o]=e),s};var Xn=jr.FORMAT_REGEXPS={"date-time":/^\d{4}-(?:0[0-9]{1}|1[0-2]{1})-(3[01]|0[1-9]|[12][0-9])[tT ](2[0-4]|[01][0-9]):([0-5][0-9]):(60|[0-5][0-9])(\.\d+)?([zZ]|[+-]([0-5][0-9]):(60|[0-5][0-9]))$/,date:/^\d{4}-(?:0[0-9]{1}|1[0-2]{1})-(3[01]|0[1-9]|[12][0-9])$/,time:/^(2[0-4]|[01][0-9]):([0-5][0-9]):(60|[0-5][0-9])$/,duration:/P(T\d+(H(\d+M(\d+S)?)?|M(\d+S)?|S)|\d+(D|M(\d+D)?|Y(\d+M(\d+D)?)?)(T\d+(H(\d+M(\d+S)?)?|M(\d+S)?|S))?|\d+W)/i,email:/^(?:[\w\!\#\$\%\&\'\*\+\-\/\=\?\^\`\{\|\}\~]+\.)*[\w\!\#\$\%\&\'\*\+\-\/\=\?\^\`\{\|\}\~]+@(?:(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9\-](?!\.)){0,61}[a-zA-Z0-9]?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9\-](?!$)){0,61}[a-zA-Z0-9]?)|(?:\[(?:(?:[01]?\d{1,2}|2[0-4]\d|25[0-5])\.){3}(?:[01]?\d{1,2}|2[0-4]\d|25[0-5])\]))$/,"idn-email":/^("(?:[!#-\[\]-\u{10FFFF}]|\\[\t -\u{10FFFF}])*"|[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}](?:\.?[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}])*)@([!#-'*+\-/-9=?A-Z\^-\u{10FFFF}](?:\.?[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}])*|\[[!-Z\^-\u{10FFFF}]*\])$/u,"ip-address":/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,ipv6:/^\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*$/,uri:/^[a-zA-Z][a-zA-Z0-9+.-]*:[^\s]*$/,"uri-reference":/^(((([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|([A-Za-z][+\-.0-9A-Za-z]*:?)?)|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|(\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?)?))#(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|(([A-Za-z][+\-.0-9A-Za-z]*)?%[0-9A-Fa-f]{2}|[!$&-.0-9;=@_~]|[A-Za-z][+\-.0-9A-Za-z]*[!$&-*,;=@_~])(%[0-9A-Fa-f]{2}|[!$&-.0-9;=@-Z_a-z~])*((([/?](%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*)?#|[/?])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*)?|([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+(:\d*)?|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?:\d*|\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)?|[A-Za-z][+\-.0-9A-Za-z]*:?)?$/,iri:/^[a-zA-Z][a-zA-Z0-9+.-]*:[^\s]*$/,"iri-reference":/^(((([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~-\u{10FFFF}]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|([A-Za-z][+\-.0-9A-Za-z]*:?)?)|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|(\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?)?))#(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|(([A-Za-z][+\-.0-9A-Za-z]*)?%[0-9A-Fa-f]{2}|[!$&-.0-9;=@_~-\u{10FFFF}]|[A-Za-z][+\-.0-9A-Za-z]*[!$&-*,;=@_~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-.0-9;=@-Z_a-z~-\u{10FFFF}])*((([/?](%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*)?#|[/?])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*)?|([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~-\u{10FFFF}]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+(:\d*)?|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?:\d*|\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)?|[A-Za-z][+\-.0-9A-Za-z]*:?)?$/u,uuid:/^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i,"uri-template":/(%[0-9a-f]{2}|[!#$&(-;=?@\[\]_a-z~]|\{[!#&+,./;=?@|]?(%[0-9a-f]{2}|[0-9_a-z])(\.?(%[0-9a-f]{2}|[0-9_a-z]))*(:[1-9]\d{0,3}|\*)?(,(%[0-9a-f]{2}|[0-9_a-z])(\.?(%[0-9a-f]{2}|[0-9_a-z]))*(:[1-9]\d{0,3}|\*)?)*\})*/iu,"json-pointer":/^(\/([\x00-\x2e0-@\[-}\x7f]|~[01])*)*$/iu,"relative-json-pointer":/^\d+(#|(\/([\x00-\x2e0-@\[-}\x7f]|~[01])*)*)$/iu,hostname:/^(?=.{1,255}$)[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?(?:\.[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?)*\.?$/,"host-name":/^(?=.{1,255}$)[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?(?:\.[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?)*\.?$/,"utc-millisec":function(t){return typeof t=="string"&&parseFloat(t)===parseInt(t,10)&&!isNaN(t)},regex:function(t){var e=!0;try{new RegExp(t)}catch{e=!1}return e},style:/[\r\n\t ]*[^\r\n\t ][^:]*:[\r\n\t ]*[^\r\n\t ;]*[\r\n\t ]*;?/,color:/^(#?([0-9A-Fa-f]{3}){1,2}\b|aqua|black|blue|fuchsia|gray|green|lime|maroon|navy|olive|orange|purple|red|silver|teal|white|yellow|(rgb\(\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*,\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*,\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*\))|(rgb\(\s*(\d?\d%|100%)+\s*,\s*(\d?\d%|100%)+\s*,\s*(\d?\d%|100%)+\s*\)))$/,phone:/^\+(?:[0-9] ?){6,14}[0-9]$/,alpha:/^[a-zA-Z]+$/,alphanumeric:/^[a-zA-Z0-9]+$/};Xn.regexp=Xn.regex;Xn.pattern=Xn.regex;Xn.ipv4=Xn["ip-address"];jr.isFormat=function(e,r,n){if(typeof e=="string"&&Xn[r]!==void 0){if(Xn[r]instanceof RegExp)return Xn[r].test(e);if(typeof Xn[r]=="function")return Xn[r](e)}else if(n&&n.customFormats&&typeof n.customFormats[r]=="function")return n.customFormats[r](e);return!0};var qH=jr.makeSuffix=function(e){return e=e.toString(),!e.match(/[.\s\[\]]/)&&!e.match(/^[\d]/)?"."+e:e.match(/^\d+$/)?"["+e+"]":"["+JSON.stringify(e)+"]"};jr.deepCompareStrict=function t(e,r){if(typeof e!=typeof r)return!1;if(Array.isArray(e))return!Array.isArray(r)||e.length!==r.length?!1:e.every(function(o,s){return t(e[s],r[s])});if(typeof e=="object"){if(!e||!r)return e===r;var n=Object.keys(e),i=Object.keys(r);return n.length!==i.length?!1:n.every(function(o){return t(e[o],r[o])})}return e===r};function Jye(t,e,r,n){typeof r=="object"?e[n]=WO(t[n],r):t.indexOf(r)===-1&&e.push(r)}function Yye(t,e,r){e[r]=t[r]}function Xye(t,e,r,n){typeof e[n]!="object"||!e[n]?r[n]=e[n]:t[n]?r[n]=WO(t[n],e[n]):r[n]=e[n]}function WO(t,e){var r=Array.isArray(e),n=r&&[]||{};return r?(t=t||[],n=n.concat(t),e.forEach(Jye.bind(null,t,n))):(t&&typeof t=="object"&&Object.keys(t).forEach(Yye.bind(null,t,n)),Object.keys(e).forEach(Xye.bind(null,t,e,n))),n}KO.exports.deepMerge=WO;jr.objectGetPath=function(e,r){for(var n=r.split("/").slice(1),i;typeof(i=n.shift())=="string";){var o=decodeURIComponent(i.replace(/~0/,"~").replace(/~1/g,"/"));if(!(o in e))return;e=e[o]}return e};function Qye(t){return"/"+encodeURIComponent(t).replace(/~/g,"%7E")}jr.encodePath=function(e){return e.map(Qye).join("")};jr.getDecimalPlaces=function(e){var r=0;if(isNaN(e))return r;typeof e!="number"&&(e=Number(e));var n=e.toString().split("e");if(n.length===2){if(n[1][0]!=="-")return r;r=Number(n[1].slice(1))}var i=n[0].split(".");return i.length===2&&(r+=i[1].length),r};jr.isSchema=function(e){return typeof e=="object"&&e||typeof e=="boolean"};var BH=jr.resolveUrl=function(e,r){let n=new URL(r,new URL(e,"resolve://"));if(n.protocol==="resolve:"){let{pathname:i,search:o,hash:s}=n;return i+o+s}return n.toString()}});var VH=v((m7e,ZH)=>{"use strict";var rn=is(),Le=rn.ValidatorResult,os=rn.SchemaError,JO={};JO.ignoreProperties={id:!0,default:!0,description:!0,title:!0,additionalItems:!0,then:!0,else:!0,$schema:!0,$ref:!0,extends:!0};var ze=JO.validators={};ze.type=function(e,r,n,i){if(e===void 0)return null;var o=new Le(e,r,n,i),s=Array.isArray(r.type)?r.type:[r.type];if(!s.some(this.testType.bind(this,e,r,n,i))){var a=s.map(function(c){if(c){var l=c.$id||c.id;return l?"<"+l+">":c+""}});o.addError({name:"type",argument:a,message:"is not of a type(s) "+a})}return o};function YO(t,e,r,n,i){var o=e.throwError,s=e.throwAll;e.throwError=!1,e.throwAll=!1;var a=this.validateSchema(t,i,e,r);return e.throwError=o,e.throwAll=s,!a.valid&&n instanceof Function&&n(a),a.valid}ze.anyOf=function(e,r,n,i){if(e===void 0)return null;var o=new Le(e,r,n,i),s=new Le(e,r,n,i);if(!Array.isArray(r.anyOf))throw new os("anyOf must be an array");if(!r.anyOf.some(YO.bind(this,e,n,i,function(c){s.importErrors(c)}))){var a=r.anyOf.map(function(c,l){var u=c.$id||c.id;return u?"<"+u+">":c.title&&JSON.stringify(c.title)||c.$ref&&"<"+c.$ref+">"||"[subschema "+l+"]"});n.nestedErrors&&o.importErrors(s),o.addError({name:"anyOf",argument:a,message:"is not any of "+a.join(",")})}return o};ze.allOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.allOf))throw new os("allOf must be an array");var o=new Le(e,r,n,i),s=this;return r.allOf.forEach(function(a,c){var l=s.validateSchema(e,a,n,i);if(!l.valid){var u=a.$id||a.id,d=u||a.title&&JSON.stringify(a.title)||a.$ref&&"<"+a.$ref+">"||"[subschema "+c+"]";o.addError({name:"allOf",argument:{id:d,length:l.errors.length,valid:l},message:"does not match allOf schema "+d+" with "+l.errors.length+" error[s]:"}),o.importErrors(l)}}),o};ze.oneOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.oneOf))throw new os("oneOf must be an array");var o=new Le(e,r,n,i),s=new Le(e,r,n,i),a=r.oneOf.filter(YO.bind(this,e,n,i,function(l){s.importErrors(l)})).length,c=r.oneOf.map(function(l,u){var d=l.$id||l.id;return d||l.title&&JSON.stringify(l.title)||l.$ref&&"<"+l.$ref+">"||"[subschema "+u+"]"});return a!==1&&(n.nestedErrors&&o.importErrors(s),o.addError({name:"oneOf",argument:c,message:"is not exactly one from "+c.join(",")})),o};ze.if=function(e,r,n,i){if(e===void 0)return null;if(!rn.isSchema(r.if))throw new Error('Expected "if" keyword to be a schema');var o=YO.call(this,e,n,i,null,r.if),s=new Le(e,r,n,i),a;if(o){if(r.then===void 0)return;if(!rn.isSchema(r.then))throw new Error('Expected "then" keyword to be a schema');a=this.validateSchema(e,r.then,n,i.makeChild(r.then)),s.importErrors(a)}else{if(r.else===void 0)return;if(!rn.isSchema(r.else))throw new Error('Expected "else" keyword to be a schema');a=this.validateSchema(e,r.else,n,i.makeChild(r.else)),s.importErrors(a)}return s};function XO(t,e){if(Object.hasOwnProperty.call(t,e))return t[e];if(e in t){for(;t=Object.getPrototypeOf(t);)if(Object.propertyIsEnumerable.call(t,e))return t[e]}}ze.propertyNames=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.propertyNames!==void 0?r.propertyNames:{};if(!rn.isSchema(s))throw new os('Expected "propertyNames" to be a schema (object or boolean)');for(var a in e)if(XO(e,a)!==void 0){var c=this.validateSchema(a,s,n,i.makeChild(s));o.importErrors(c)}return o}};ze.properties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.properties||{};for(var a in s){var c=s[a];if(c!==void 0){if(c===null)throw new os('Unexpected null, expected schema in "properties"');typeof n.preValidateProperty=="function"&&n.preValidateProperty(e,a,c,n,i);var l=XO(e,a),u=this.validateSchema(l,c,n,i.makeChild(c,a));u.instance!==o.instance[a]&&(o.instance[a]=u.instance),o.importErrors(u)}}return o}};function HH(t,e,r,n,i,o){if(this.types.object(t)&&!(e.properties&&e.properties[i]!==void 0))if(e.additionalProperties===!1)o.addError({name:"additionalProperties",argument:i,message:"is not allowed to have the additional property "+JSON.stringify(i)});else{var s=e.additionalProperties||{};typeof r.preValidateProperty=="function"&&r.preValidateProperty(t,i,s,r,n);var a=this.validateSchema(t[i],s,r,n.makeChild(s,i));a.instance!==o.instance[i]&&(o.instance[i]=a.instance),o.importErrors(a)}}ze.patternProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.patternProperties||{};for(var a in e){var c=!0;for(var l in s){var u=s[l];if(u!==void 0){if(u===null)throw new os('Unexpected null, expected schema in "patternProperties"');try{var d=new RegExp(l,"u")}catch{d=new RegExp(l)}if(d.test(a)){c=!1,typeof n.preValidateProperty=="function"&&n.preValidateProperty(e,a,u,n,i);var f=this.validateSchema(e[a],u,n,i.makeChild(u,a));f.instance!==o.instance[a]&&(o.instance[a]=f.instance),o.importErrors(f)}}}c&&HH.call(this,e,r,n,i,a,o)}return o}};ze.additionalProperties=function(e,r,n,i){if(this.types.object(e)){if(r.patternProperties)return null;var o=new Le(e,r,n,i);for(var s in e)HH.call(this,e,r,n,i,s,o);return o}};ze.minProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=Object.keys(e);return s.length>=r.minProperties||o.addError({name:"minProperties",argument:r.minProperties,message:"does not meet minimum property length of "+r.minProperties}),o}};ze.maxProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=Object.keys(e);return s.length<=r.maxProperties||o.addError({name:"maxProperties",argument:r.maxProperties,message:"does not meet maximum property length of "+r.maxProperties}),o}};ze.items=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.items!==void 0){var s=new Le(e,r,n,i);return e.every(function(a,c){if(Array.isArray(r.items))var l=r.items[c]===void 0?r.additionalItems:r.items[c];else var l=r.items;if(l===void 0)return!0;if(l===!1)return s.addError({name:"items",message:"additionalItems not permitted"}),!1;var u=o.validateSchema(a,l,n,i.makeChild(l,c));return u.instance!==s.instance[c]&&(s.instance[c]=u.instance),s.importErrors(u),!0}),s}};ze.contains=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.contains!==void 0){if(!rn.isSchema(r.contains))throw new Error('Expected "contains" keyword to be a schema');var s=new Le(e,r,n,i),a=e.some(function(c,l){var u=o.validateSchema(c,r.contains,n,i.makeChild(r.contains,l));return u.errors.length===0});return a===!1&&s.addError({name:"contains",argument:r.contains,message:"must contain an item matching given schema"}),s}};ze.minimum=function(e,r,n,i){if(this.types.number(e)){var o=new Le(e,r,n,i);return r.exclusiveMinimum&&r.exclusiveMinimum===!0?e>r.minimum||o.addError({name:"minimum",argument:r.minimum,message:"must be greater than "+r.minimum}):e>=r.minimum||o.addError({name:"minimum",argument:r.minimum,message:"must be greater than or equal to "+r.minimum}),o}};ze.maximum=function(e,r,n,i){if(this.types.number(e)){var o=new Le(e,r,n,i);return r.exclusiveMaximum&&r.exclusiveMaximum===!0?er.exclusiveMinimum;return s||o.addError({name:"exclusiveMinimum",argument:r.exclusiveMinimum,message:"must be strictly greater than "+r.exclusiveMinimum}),o}};ze.exclusiveMaximum=function(e,r,n,i){if(typeof r.exclusiveMaximum!="boolean"&&this.types.number(e)){var o=new Le(e,r,n,i),s=e=r.minLength||o.addError({name:"minLength",argument:r.minLength,message:"does not meet minimum length of "+r.minLength}),o}};ze.maxLength=function(e,r,n,i){if(this.types.string(e)){var o=new Le(e,r,n,i),s=e.match(/[\uDC00-\uDFFF]/g),a=e.length-(s?s.length:0);return a<=r.maxLength||o.addError({name:"maxLength",argument:r.maxLength,message:"does not meet maximum length of "+r.maxLength}),o}};ze.minItems=function(e,r,n,i){if(this.types.array(e)){var o=new Le(e,r,n,i);return e.length>=r.minItems||o.addError({name:"minItems",argument:r.minItems,message:"does not meet minimum length of "+r.minItems}),o}};ze.maxItems=function(e,r,n,i){if(this.types.array(e)){var o=new Le(e,r,n,i);return e.length<=r.maxItems||o.addError({name:"maxItems",argument:r.maxItems,message:"does not meet maximum length of "+r.maxItems}),o}};function e_e(t,e,r){var n,i=r.length;for(n=e+1,i;n{"use strict";var QO=is();eR.exports.SchemaScanResult=WH;function WH(t,e){this.id=t,this.ref=e}eR.exports.scan=function(e,r){function n(c,l){if(!l||typeof l!="object")return;if(l.$ref){let p=QO.resolveUrl(c,l.$ref);a[p]=a[p]?a[p]+1:0;return}var u=l.$id||l.id;let d=QO.resolveUrl(c,u);var f=u?d:c;if(f){if(f.indexOf("#")<0&&(f+="#"),s[f]){if(!QO.deepCompareStrict(s[f],l))throw new Error("Schema <"+f+"> already exists with different definition");return s[f]}s[f]=l,f[f.length-1]=="#"&&(s[f.substring(0,f.length-1)]=l)}i(f+"/items",Array.isArray(l.items)?l.items:[l.items]),i(f+"/extends",Array.isArray(l.extends)?l.extends:[l.extends]),n(f+"/additionalItems",l.additionalItems),o(f+"/properties",l.properties),n(f+"/additionalProperties",l.additionalProperties),o(f+"/definitions",l.definitions),o(f+"/patternProperties",l.patternProperties),o(f+"/dependencies",l.dependencies),i(f+"/disallow",l.disallow),i(f+"/allOf",l.allOf),i(f+"/anyOf",l.anyOf),i(f+"/oneOf",l.oneOf),n(f+"/not",l.not)}function i(c,l){if(Array.isArray(l))for(var u=0;u{"use strict";var KH=VH(),ss=is(),JH=z_().scan,YH=ss.ValidatorResult,t_e=ss.ValidatorResultError,zf=ss.SchemaError,XH=ss.SchemaContext,r_e="/",Jt=function t(){this.customFormats=Object.create(t.prototype.customFormats),this.schemas={},this.unresolvedRefs=[],this.types=Object.create(Ri),this.attributes=Object.create(KH.validators)};Jt.prototype.customFormats={};Jt.prototype.schemas=null;Jt.prototype.types=null;Jt.prototype.attributes=null;Jt.prototype.unresolvedRefs=null;Jt.prototype.addSchema=function(e,r){var n=this;if(!e)return null;var i=JH(r||r_e,e),o=r||e.$id||e.id;for(var s in i.id)this.schemas[s]=i.id[s];for(var s in i.ref)this.unresolvedRefs.push(s);return this.unresolvedRefs=this.unresolvedRefs.filter(function(a){return typeof n.schemas[a]>"u"}),this.schemas[o]};Jt.prototype.addSubSchemaArray=function(e,r){if(Array.isArray(r))for(var n=0;n",e);var a=ss.objectGetPath(n.schemas[s],o.substr(1));if(a===void 0)throw new zf("no such schema "+o+" located in <"+s+">",e);return{subschema:a,switchSchema:r}};Jt.prototype.testType=function(e,r,n,i,o){if(o!==void 0){if(o===null)throw new zf('Unexpected null in "type" keyword');if(typeof this.types[o]=="function")return this.types[o].call(this,e);if(o&&typeof o=="object"){var s=this.validateSchema(e,o,n,i);return s===void 0||!(s&&s.errors.length)}return!0}};var Ri=Jt.prototype.types={};Ri.string=function(e){return typeof e=="string"};Ri.number=function(e){return typeof e=="number"&&isFinite(e)};Ri.integer=function(e){return typeof e=="number"&&e%1===0};Ri.boolean=function(e){return typeof e=="boolean"};Ri.array=function(e){return Array.isArray(e)};Ri.null=function(e){return e===null};Ri.date=function(e){return e instanceof Date};Ri.any=function(e){return!0};Ri.object=function(e){return e&&typeof e=="object"&&!Array.isArray(e)&&!(e instanceof Date)};eG.exports=Jt});var rG=v((y7e,ho)=>{"use strict";var n_e=ho.exports.Validator=tG();ho.exports.ValidatorResult=is().ValidatorResult;ho.exports.ValidatorResultError=is().ValidatorResultError;ho.exports.ValidationError=is().ValidationError;ho.exports.SchemaError=is().SchemaError;ho.exports.SchemaScanResult=z_().SchemaScanResult;ho.exports.scan=z_().scan;ho.exports.validate=function(t,e,r){var n=new n_e;return n.validate(t,e,r)}});import{readFileSync as i_e}from"node:fs";import{dirname as o_e,join as s_e}from"node:path";import{fileURLToPath as a_e}from"node:url";function f_e(t){let e=d_e.validate(t,u_e);return e.valid?{valid:!0,errors:[]}:{valid:!1,errors:e.errors.map(n=>`${n.property}: ${n.message}`)}}function iG(t){let e=f_e(t);if(!e.valid)throw new Error(`spec.yaml invalid: +`,c=Math.max(0,s-a.length);return{path:t,text:i.slice(0,c)+a,truncated:!0,bytes:o}}var yye,xH,_ye,R_=y(()=>{"use strict";yye=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs",".py",".rs",".go",".java",".kt",".kts",".cs",".rb",".php",".swift",".c",".h",".cpp",".hpp",".css",".scss",".sql",".sh",".yaml",".yml",".json",".md",".toml"]),xH=2e6,_ye="\0"});function Sye(t){for(let i of vye)if(t.startsWith(i))return null;let e=t.indexOf("#"),n=(e>=0?t.slice(0,e):t).trim();return n.length>0?n:null}function jO(t,e,r){let n=t.get(e);n||(n=new Set,t.set(e,n)),n.add(r)}function wye(t){let e=new Map,r=new Map,n=new Map;for(let i of t.features??[]){let o=i.id;for(let s of i.depends_on??[])jO(e,s,o);for(let s of i.modules??[])jO(r,s,o);for(let s of i.acceptance_criteria??[])for(let a of s.test_refs??[]){let c=Sye(a);c&&jO(n,c,o)}}return{dependents:e,moduleOwners:r,testRefCitations:n}}function On(t){let e=kH.get(t);return e||(e=wye(t),kH.set(t,e)),e}var vye,kH,Sa=y(()=>{"use strict";vye=["derived:","fixture:","script:","self-dogfood:"];kH=new WeakMap});function MO(t,e,r=1/0){let n=new Set,i=new Set(t),o=[...i],s=0;for(;o.length>0&&sn.id===e)??r.find(n=>n.slug===e)??null}function Sr(t,e,r={}){let n=r.depth??1/0,i=On(t),o=new Map((t.features??[]).map(_=>[_.id,_])),s=[],a,c=xye(t,e);if(c)s=[c];else{let _=i.moduleOwners.get(e);_&&_.size>0&&(a=e,s=[..._].map(S=>o.get(S)).filter(S=>!!S))}if(s.length===0)return{not_found:e,accepted_forms:["feature id (F-\u2026)","slug","module path (e.g. src/spec/load.ts)"],discovery:"grep spec/index.yaml \u2014 one line per feature (run clad sync if missing); module paths live in each shard\u2019s modules:; if the query is a file, fall back to normal code search \u2014 the graph only knows declared modules"};let l=s.map(_=>_.id),u=MO(l,i.dependents,n),d=[...u].map(_=>o.get(_)).filter(_=>!!_).map(_=>({id:_.id,title:_.title,status:_.status})).sort((_,S)=>_.id.localeCompare(S.id)),f=new Set([...l,...u]),p=[...f].map(_=>o.get(_)).filter(_=>!!_),m=[...new Set(p.flatMap(_=>_.modules??[]))].sort(),h=(t.scenarios??[]).filter(_=>(_.features??[]).some(S=>f.has(S))).map(_=>({id:_.id,title:_.title})).sort((_,S)=>_.id.localeCompare(S.id)),g=[...new Set(p.flatMap(_=>(_.acceptance_criteria??[]).flatMap(S=>S.test_refs??[])))].sort();return{focus:a?{module:a,owners:[...l].sort()}:{id:s[0].id,title:s[0].title,status:s[0].status},impacted:d,impacted_modules:m,scenarios:h,test_refs:g,ledger:FO(i)}}var wa=y(()=>{"use strict";Sa()});function EH(t){return t.impacted.length}function P_(t,e,r={}){let n=r.initialDepth??I_.initialDepth,i=r.maxDepth??I_.maxDepth,o=r.coverageThreshold??I_.coverageThreshold,s=r.marginYieldThreshold??I_.marginYieldThreshold,a=On(t),c=new Map((t.features??[]).map(b=>[b.id,b])),l=[],u=(t.features??[]).find(b=>b.id===e||b.slug===e);if(u)l=[u.id];else{let b=a.moduleOwners.get(e);b&&b.size>0&&(l=[...b].filter(_=>c.has(_)))}if(l.length===0){let b=Sr(t,e,{depth:1});return"not_found"in b,b}let d=MO(l,a.dependents,1/0).size;if(d===0){let b=Sr(t,e,{depth:n});return"not_found"in b?b:{slice:b,depthUsed:n,stoppedBy:"no-known-dependents",analysis:{frontierExhausted:!0,coverage:null,marginalYields:[0],totalKnownDependents:0}}}let f=[],p=0,m=null;for(let b=n;b<=i;b++){let _=Sr(t,e,{depth:b});if("not_found"in _)return _;m=_;let S=EH(_),x=S-p,w=S>0?x/S:0;f.push(w);let O=d>0?S/d:1,T=x===0&&b>n,A={frontierExhausted:T,coverage:O,marginalYields:[...f],totalKnownDependents:d};if(T)return{slice:_,depthUsed:b,stoppedBy:"exhaustion",analysis:A};if(O>=o)return{slice:_,depthUsed:b,stoppedBy:"coverage",analysis:A};if(f.length>=2&&f[f.length-1]0?g/d:1,marginalYields:[...f],totalKnownDependents:d}}}var I_,LO=y(()=>{"use strict";wa();Sa();I_={initialDepth:1,maxDepth:10,coverageThreshold:.9,marginYieldThreshold:.05}});function $ye(t,e){let r=new Set,n=[t];for(;n.length>0;){let i=n.pop();if(!i||r.has(i))continue;r.add(i);let o=e.get(i);for(let s of o?.depends_on??[])n.push(s)}return r}function AH(t,e){let r=new Map(t.features.map(a=>[a.id,a]));if(!r.has(e))return t;let n=$ye(e,r),i=t.features.filter(a=>n.has(a.id)),o=(t.scenarios??[]).filter(a=>(a.features??[]).some(c=>n.has(c)));return{...t,features:i,scenarios:o}}var TH=y(()=>{"use strict"});function kye(t,e){let r=t.features??[];return r.find(n=>n.id===e)??r.find(n=>n.slug===e)??r.find(n=>(n.modules??[]).includes(e))??null}function fl(t,e){let r=kye(t,e);if(!r)return{not_found:e,accepted_forms:["feature id (F-\u2026)","slug","module path (e.g. src/auth/login.ts)"],discovery:"grep spec/index.yaml \u2014 one line per feature (id, slug, status; run clad sync if missing); if the query is a file, fall back to normal code search \u2014 the graph only knows declared modules"};let n=AH(t,r.id),i=(n.features??[]).filter(c=>c.id!==r.id).map(c=>({id:c.id,title:c.title,status:c.status})).sort((c,l)=>c.id.localeCompare(l.id)),o=(n.scenarios??[]).map(c=>({id:c.id,title:c.title})).sort((c,l)=>c.id.localeCompare(l.id)),s=(t.project?.ai_hints?.preferred_patterns??[]).map(c=>({when:c.when,prefer:c.prefer,...c.over!==void 0?{over:c.over}:{}})),a=[...new Set((r.acceptance_criteria??[]).flatMap(c=>c.test_refs??[]))].sort();return{focus:r,ancestors:i,scenarios:o,preferred_patterns:s,test_refs:a}}var C_=y(()=>{"use strict";TH()});import{existsSync as RH,readdirSync as Eye,readFileSync as Aye}from"node:fs";import{join as UO}from"node:path";function qO(t,e=Oye){let r=t.trim().replace(/\s+/g," ");return r.length<=e?r:`${r.slice(0,e-1)}\u2026`}function Rye(t){let e=t.payload??{};if(t.type==="drift_detected"){let n=typeof e.gate=="string"&&e.gate?e.gate:"drift";return{detector:n,message:qO(`drift detected at gate ${n}`)}}let r=typeof e.worst=="number"?` (worst ${e.worst})`:"";return{detector:"done_attempted",message:qO(`done reverted \u2014 pre-push strict gate red${r}`)}}function OH(t){let e=Date.parse(t.timestamp);return Number.isFinite(e)?e:0}function Iye(t){let e=[];t.lastFailedGate&&e.push(`failed ${t.lastFailedGate}`),typeof t.retryCount=="number"&&e.push(`${t.retryCount} retries`);let r=e.length?` (${e.join(", ")})`:"",n=t.recovery?`recover: ${t.recovery}${r}`:`rolled back${r}`;return qO(n)}function Pye(t,e,r,n={}){let i=t.filter(m=>m&&m.payload&&m.payload.feature===r),o=e.filter(m=>m&&m.featureId===r).slice().sort((m,h)=>OH(m)-OH(h)),s=i.filter(m=>m.type==="drift_detected"||m.type==="done_attempted"&&m.payload.kept===!1),a=i.filter(m=>m.type==="feature_rolled_back");if(s.length===0&&a.length===0&&o.length===0)return;let c=o.length?o[o.length-1]:void 0,l;for(let m=s.length-1;m>=0;m--){let h=s[m].payload.gate;if(s[m].type==="drift_detected"&&typeof h=="string"&&h){l=h;break}}!l&&c?.lastFailedGate&&(l=c.lastFailedGate);let u=s.slice(-Tye).map(Rye),d;for(let m=a.length-1;m>=0;m--){let h=a[m].payload.to_git_head;if(typeof h=="string"&&h){d=h;break}}let f=typeof c?.retryCount=="number"?c.retryCount:void 0,p=c?Iye(c):void 0;return{attempts:s.length,...l?{last_failed_gate:l}:{},...f!==void 0?{retry_count:f}:{},...u.length?{drift_history:u}:{},...d?{rolled_back_at:d}:{},...p?{recovery_hint:p}:{},...n.truncated?{truncated_history:!0}:{}}}function zO(t,e){let r=t.match(e);return r&&r[1]?r[1].trim():void 0}function Cye(t){let e=t.indexOf("## Recommended recovery");if(e<0)return;let r=t.slice(e).match(/```[^\n]*\n([\s\S]*?)```/);return r&&r[1].split(` +`).map(i=>i.trim()).find(i=>i.length>0)||void 0}function Dye(t,e,r){let n=zO(t,/_Rolled back at_\s*`([^`]+)`/),i=zO(t,/Last failed gate:\s*`([^`]+)`/),o=zO(t,/Retry attempts:\s*(\d+)/),s=Cye(t);return{featureId:e,timestamp:n??r,...i?{lastFailedGate:i}:{},...o?{retryCount:Number(o)}:{},...s?{recovery:s}:{}}}function Nye(t,e){let r=UO(t,".cladding","post-mortems");if(!RH(r))return[];let n=`post-mortem-${e}-`,i=[];for(let o of Eye(r))if(!(!o.startsWith(n)||!o.endsWith(".md")))try{i.push(Dye(Aye(UO(r,o),"utf8"),e,o))}catch{}return i}function IH(t,e){try{let r=E_(t),n=Nye(t,e),i=RH(UO(t,".cladding","events.log.1.jsonl"));return Pye(r,n,e,{truncated:i})}catch{return}}var Tye,Oye,PH=y(()=>{"use strict";jr();Tye=5,Oye=120});function D_(t,e,r){return rn(JSON.stringify({...t,needs:e,must_edit:{...t.must_edit,code:r}}))}function xa(t,e,r={}){let n=r.cwd??".",i=r.maxTokens&&r.maxTokens>0?r.maxTokens:jye,o=e,s,a=On(t).moduleOwners.get(e);if(a&&a.size>0){let se=[...a].sort();o=se[0],se.length>1&&(s=se)}let c=fl(t,o);if("not_found"in c)return c;let l=c.focus,u=IH(n,l.id),d=a&&a.size>0?e:l.id,f=P_(t,d),p="not_found"in f?null:f.slice,m=p?p.impacted:[],h=p?p.test_refs:[],g="not_found"in f?null:{depth:f.depthUsed,stopped_by:f.stoppedBy,coverage:f.analysis.coverage===null?null:Math.round(f.analysis.coverage*100)/100,total_known_dependents:f.analysis.totalKnownDependents},b=l.acceptance_criteria??[],_=b.filter(se=>se.ears==="unwanted"||se.ears==="state").map(se=>({id:se.id,ears:String(se.ears)})),S=[...new Set(b.flatMap(se=>se.oracle_refs??[]))].sort(),x=[],w={must_edit:{id:l.id,title:l.title,status:l.status,modules:l.modules??[],acceptance_criteria:b,code:[],...s?{co_owners:s}:{}},needs:c.ancestors,breaks_if_changed:{impacted:m,regression_tests:h,...g?{radius:g}:{}},verify:{scenarios:c.scenarios,test_refs:c.test_refs,oracle_refs:S,high_risk_acs:_},guidance:{preferred_patterns:c.preferred_patterns},budget:{max_tokens:i,used_tokens:0,truncated:x}},O=[...c.ancestors];for(;O.length>Mye&&D_(w,O,[])>i;)O.pop();O.lengthi){x.push(`code: omitted ${se} (budget)`);continue}A.push(Kt),Kt.truncated&&x.push(`code: clipped ${se}`)}T>i&&x.push("must-edit exceeds budget \u2014 retained in full (focus is never dropped)");let D=(se,Ce)=>({impacted:se,regression_tests:Ce,...g?{radius:g}:{},...p?.ledger?{ledger:p.ledger}:{}}),$=(se,Ce,Kt,dr)=>{let Xt=Kt+dr>0?[`breaks: omitted ${Kt} feature(s) / ${dr} test(s)`]:[],lo={...w,needs:O,must_edit:{...w.must_edit,code:A},breaks_if_changed:D(se,Ce),budget:{...w.budget,truncated:[...x,...Xt]}};return rn(JSON.stringify(lo))>i},re=m,K=h;if($(re,K,0,0)){let se=Sr(t,d,{depth:1}),Ce=new Set("not_found"in se?[]:se.impacted.map(de=>de.id)),Kt=new Set("not_found"in se?[]:se.test_refs),Xt=[...m.filter(de=>Ce.has(de.id)),...m.filter(de=>!Ce.has(de.id))],lo=0;for(;Xt.length>Ce.size&&$(Xt,K,lo,0);)Xt=Xt.slice(0,-1),lo++;let $i=[...h],Qr=0;for(;$(Xt,$i,lo,Qr);){let de=-1;for(let uo=$i.length-1;uo>=0;uo--)if(!Kt.has($i[uo])){de=uo;break}if(de<0)break;$i.splice(de,1),Qr++}re=Xt,K=$i,lo+Qr>0&&x.push(`breaks: omitted ${lo} feature(s) / ${Qr} test(s)`),$(re,K,0,0)&&x.push("breaks: direct set retained in full \u2014 exceeds budget")}let xe=D(re,K),C={...w,needs:O,must_edit:{...w.must_edit,code:A},breaks_if_changed:xe},P=C;if(u){let se={...C,prior_attempts:u};rn(JSON.stringify(se))<=i?P=se:x.push("prior_attempts: omitted (budget)")}let Pr=rn(JSON.stringify(P));return{...P,budget:{max_tokens:i,used_tokens:Pr,truncated:x}}}var jye,Mye,N_=y(()=>{"use strict";R_();C_();LO();PH();wa();Sa();jye=3e3,Mye=3});function Xn(t){if(t.length===0)return 0;let e=[...t].sort((n,i)=>n-i),r=Math.floor(e.length/2);return e.length%2?e[r]:(e[r-1]+e[r])/2}function Fye(t,e){if(t.length===0)return 0;let r=[...t].sort((n,i)=>n-i);return r[Math.min(r.length-1,Math.floor(e/100*r.length))]}function CH(t,e,r="."){let n=On(t),i=t.features??[],o=[];for(let f of i){let p=xa(t,f.id,{cwd:r,read:e});if("not_found"in p)continue;let m=xa(t,f.id,{cwd:r,read:e,maxTokens:Number.MAX_SAFE_INTEGER}),h=P_(t,f.id),g=!("not_found"in h),b=rn(JSON.stringify(p)),_="not_found"in m?b:rn(JSON.stringify(m)),S=rn(JSON.stringify(f));for(let O of f.modules??[]){let T=e(O);T&&(S+=rn(T))}let x=(f.depends_on??[]).length,w=n.dependents.get(f.id)?.size??0;o.push({id:f.id,sliceTokens:b,structuralTokens:_,naiveTokens:S,contextRatio:S>0?b/S:1,budgetSaturated:p.budget.truncated.length>0,searchDepth:g?h.depthUsed:1,edgesResolved:x+w,stoppedBy:g?h.stoppedBy:"n/a",coverage:g?h.analysis.coverage:1,regressionTests:p.breaks_if_changed.regression_tests.length})}o.sort((f,p)=>f.id.localeCompare(p.id));let s=o.map(f=>f.contextRatio),a=f=>f.filter(p=>p.sliceTokens>0).map(p=>p.naiveTokens/p.sliceTokens),c=o.filter(f=>!f.budgetSaturated),l=o.filter(f=>f.budgetSaturated),u=o.filter(f=>f.naiveTokens>0).map(f=>f.structuralTokens/f.naiveTokens),d={};for(let f of o)d[f.stoppedBy]=(d[f.stoppedBy]??0)+1;return{featureCount:i.length,measured:o.length,context:{medianContextRatio:Math.round(Xn(s)*1e3)/1e3,medianShrinkFactor:Math.round(Xn(a(o))*10)/10,fitsCount:c.length,truncatedCount:l.length,medianShrinkFit:Math.round(Xn(a(c))*10)/10,medianShrinkTruncated:Math.round(Xn(a(l))*10)/10,medianStructuralRatio:Math.round(Xn(u)*100)/100,medianSliceTokens:Math.round(Xn(o.map(f=>f.sliceTokens))),medianNaiveTokens:Math.round(Xn(o.map(f=>f.naiveTokens)))},search:{medianDepth:Xn(o.map(f=>f.searchDepth)),p95Depth:Fye(o.map(f=>f.searchDepth),95),medianEdges:Xn(o.map(f=>f.edgesResolved)),maxEdges:o.reduce((f,p)=>Math.max(f,p.edgesResolved),0)},stability:{byStopReason:d,medianCoverage:Math.round(Xn(o.map(f=>f.coverage).filter(f=>f!==null))*100)/100,medianRegressionTests:Xn(o.map(f=>f.regressionTests))},features:o}}var pl,j_=y(()=>{"use strict";R_();LO();N_();Sa();pl="(deterministic upper bound vs the shard+all-modules baseline \u2014 not an agent-adoption measurement)"});import{appendFileSync as Lye,existsSync as BO,mkdirSync as zye,readFileSync as DH}from"node:fs";import{dirname as Uye,join as qye}from"node:path";function HO(t){return qye(t,Bye,Hye)}function Gye(t,e){return{timestamp:new Date().toISOString(),head:va(t),spec_digest:DO(t),featureCount:e.featureCount,measured:e.measured,context:e.context,search:e.search,stability:e.stability}}function NH(t,e){try{let r=Gye(t,e);if(r.head===null)return{appended:!1,reason:"no_head"};let n=GO(t),i=n[n.length-1];if(i&&i.head===r.head&&i.spec_digest===r.spec_digest)return{appended:!1,reason:"deduped"};let o=HO(t),s=Uye(o);return BO(s)||zye(s,{recursive:!0}),Lye(o,`${JSON.stringify(r)} +`,"utf8"),{appended:!0,reason:"appended"}}catch{return{appended:!1,reason:"error"}}}function jH(t){let e=[];for(let r of t.split(` +`)){let n=r.trim();if(n.length!==0)try{let i=JSON.parse(n);i&&typeof i=="object"&&i.context&&i.search&&i.stability&&e.push(i)}catch{}}return e}function GO(t,e){let r=HO(t);if(!BO(r))return[];let n;try{n=DH(r,"utf8")}catch{return[]}let i=jH(n);return typeof e=="number"&&e>=0?i.slice(-e):i}function MH(t){let e=HO(t);if(!BO(e))return{snapshots:[],unreadable:!1};let r;try{r=DH(e,"utf8")}catch{return{snapshots:[],unreadable:!0}}let n=jH(r),i=r.trim().length>0;return{snapshots:n,unreadable:i&&n.length===0}}function Lf(t,e=0){let r=e>0?Math.round(t*10**e)/10**e:Math.round(t),n=r.toFixed(e);return r>0?`+${n}`:n}function FH(t,e=5){let r=Math.max(0,t.length-e),i=[`measure trend \xB7 last ${t.slice(r).length} of ${t.length} snapshot(s)`];for(let o=r;o0?t[o-1]:null,c=(d,f=0)=>a?` (${Lf(d(s)-d(a),f)})`:"",l=s.timestamp.slice(0,19),u=s.head?s.head.slice(0,7):"nogit";i.push(` ${l} ${u} \xB7 ${s.featureCount} feat \xB7 slice ${s.context.medianSliceTokens}${c(d=>d.context.medianSliceTokens)} \xB7 struct ${s.context.medianStructuralRatio.toFixed(2)}${c(d=>d.context.medianStructuralRatio,2)} \xB7 cov ${s.stability.medianCoverage.toFixed(2)}${c(d=>d.stability.medianCoverage,2)} \xB7 p95depth ${s.search.p95Depth}${c(d=>d.search.p95Depth)} \xB7 trunc ${s.context.truncatedCount}${c(d=>d.context.truncatedCount)}`)}return i.push(` ${pl}`),i.join(` +`)}var Bye,Hye,zf=y(()=>{"use strict";Ff();j_();Bye=".cladding",Hye="measure.jsonl"});import{existsSync as Zye}from"node:fs";import{join as Vye}from"node:path";function ml(t){if(t.groups.reduce((i,o)=>i+o.features.length,0)===0&&t.unsharded_commits.length===0)return`no shipped changes since ${t.since}`;let r=[`# Changes since ${t.since}`,""];for(let i of t.groups){r.push(`## ${i.title}`,"");for(let o of i.features){r.push(`- **${o.title}** (${Wye[o.change]})`);for(let s of o.acceptance)r.push(` - ${s}`)}r.push("")}if(t.unsharded_commits.length>0){r.push("## Other changes (not yet spec-tracked)","");for(let i of t.unsharded_commits)r.push(`- ${i.subject}`);r.push("")}let n=t.inventory;for((n.before.features!==n.after.features||n.before.scenarios!==n.after.scenarios)&&r.push(`_Spec inventory: ${n.before.features} \u2192 ${n.after.features} features, ${n.before.scenarios} \u2192 ${n.after.scenarios} scenarios._`,"");r[r.length-1]==="";)r.pop();return r.join(` +`)}function zH(t){let e=t.snapshot,r=["## Measured (this release)",""];if(!e||!e.head)return r.push("not measured at this commit \u2014 run clad measure before tagging"),r.join(` +`);let n=e.context,i=e.stability;r.push(`- features measured: ${e.measured} of ${e.featureCount}`),r.push(`- median slice tokens: ${n.medianSliceTokens} vs ${n.medianNaiveTokens} naive`),r.push(`- median structural ratio: ${n.medianStructuralRatio.toFixed(2)}`),r.push(`- median coverage: ${i.medianCoverage.toFixed(2)}`),r.push(`- regression tests surfaced: ${i.medianRegressionTests}`);let o=t.sinceSnapshot;if(o){let s=t.sinceRef??(o.head?o.head.slice(0,7):"previous");r.push(`- since ${s}: slice ${Lf(n.medianSliceTokens-o.context.medianSliceTokens)} \xB7 struct ${Lf(n.medianStructuralRatio-o.context.medianStructuralRatio,2)} \xB7 cov ${Lf(i.medianCoverage-o.stability.medianCoverage,2)}`)}return r.push("",`head ${e.head.slice(0,7)} \xB7 spec_digest ${e.spec_digest}`,`reproduce: git checkout ${e.head} && clad measure`,"",pl),r.join(` +`)}function hl(t,e,r){let n=[`# Audit \u2014 shipped changes since ${t.since}`,"","| feature | AC | EARS | verification refs |","|---|---|---|---|"],i=new Map(e.features.map(o=>[o.id,o]));for(let o of t.groups)for(let s of o.features){let a=i.get(s.id);if(!a){n.push(`| ${s.id} | \u2014 | \u2014 | (removed from spec \u2014 see git history at ${t.since}) |`);continue}let c=a.acceptance_criteria??[];if(c.length===0){n.push(`| ${a.id} | \u2014 | \u2014 | (no acceptance criteria) |`);continue}for(let l of c)n.push(`| ${a.id} | ${l.id} | ${l.ears??"\u2014"} | ${Jye(l,r)} |`)}return n.join(` +`)}function Jye(t,e){let r=[...t.test_refs??[],...t.oracle_refs??[],...t.evidence_refs??[]];return r.length===0?"(none)":r.map(n=>{for(let[o,s]of Kye)if(n.startsWith(o))return`${n} (${s})`;let i=n.split("#",1)[0]??n;return`${Zye(Vye(e,i))?"\u2713":"\u2717"} ${n}`}).join("
")}function gl(t){let e=[`# ${t.project.name} \u2014 capability catalog`,""],r=[...t.capabilities??[]].filter(s=>typeof s.id=="string"&&s.id.length>0).sort((s,a)=>s.id.localeCompare(a.id)),n=new Map(t.features.map(s=>[s.id,s])),i=new Set;for(let s of r){e.push(`## ${s.title??s.id}`,""),s.summary&&e.push(s.summary,"");for(let a of s.features??[]){let c=n.get(a);!c||c.status==="archived"||(i.add(a),LH(e,c))}}let o=t.features.filter(s=>!i.has(s.id)&&s.status!=="archived").sort((s,a)=>s.id.localeCompare(a.id));if(o.length>0){e.push("## Uncategorized","");for(let s of o)LH(e,s)}for(;e[e.length-1]==="";)e.pop();return e.join(` +`)}function LH(t,e){t.push(`### ${e.title}`,"");for(let r of e.acceptance_criteria??[]){let n=TO(r);n&&t.push(`- ${n}`)}t.push("")}var Wye,Kye,M_=y(()=>{"use strict";zf();j_();dl();Wye={"added-as-done":"new","flipped-to-done":"completed","modified-while-done":"updated",archived:"retired"};Kye=[["derived:","machine-suggested \u2014 not author-confirmed"],["self-dogfood:","verified by cladding running on itself"],["fixture:","conformance fixture"],["script:","npm script"]]});import{readFileSync as Yye}from"node:fs";function Oi(t="./spec.yaml"){let e=Yye(t,"utf8");return(0,UH.parse)(e)}var UH,F_=y(()=>{"use strict";UH=St(er(),1)});var is=v((Mr,KO)=>{"use strict";var ZO=Mr.ValidationError=function(e,r,n,i,o,s){if(Array.isArray(i)?(this.path=i,this.property=i.reduce(function(c,l){return c+BH(l)},"instance")):i!==void 0&&(this.property=i),e&&(this.message=e),n){var a=n.$id||n.id;this.schema=a||n}r!==void 0&&(this.instance=r),this.name=o,this.argument=s,this.stack=this.toString()};ZO.prototype.toString=function(){return this.property+" "+this.message};var L_=Mr.ValidatorResult=function(e,r,n,i){this.instance=e,this.schema=r,this.options=n,this.path=i.path,this.propertyPath=i.propertyPath,this.errors=[],this.throwError=n&&n.throwError,this.throwFirst=n&&n.throwFirst,this.throwAll=n&&n.throwAll,this.disableFormat=n&&n.disableFormat===!0};L_.prototype.addError=function(e){var r;if(typeof e=="string")r=new ZO(e,this.instance,this.schema,this.path);else{if(!e)throw new Error("Missing error detail");if(!e.message)throw new Error("Missing error message");if(!e.name)throw new Error("Missing validator type");r=new ZO(e.message,this.instance,this.schema,this.path,e.name,e.argument)}if(this.errors.push(r),this.throwFirst)throw new $a(this);if(this.throwError)throw r;return r};L_.prototype.importErrors=function(e){typeof e=="string"||e&&e.validatorType?this.addError(e):e&&e.errors&&(this.errors=this.errors.concat(e.errors))};function Xye(t,e){return e+": "+t.toString()+` +`}L_.prototype.toString=function(e){return this.errors.map(Xye).join("")};Object.defineProperty(L_.prototype,"valid",{get:function(){return!this.errors.length}});KO.exports.ValidatorResultError=$a;function $a(t){typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,$a),this.instance=t.instance,this.schema=t.schema,this.options=t.options,this.errors=t.errors}$a.prototype=new Error;$a.prototype.constructor=$a;$a.prototype.name="Validation Error";var qH=Mr.SchemaError=function t(e,r){this.message=e,this.schema=r,Error.call(this,e),typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,t)};qH.prototype=Object.create(Error.prototype,{constructor:{value:qH,enumerable:!1},name:{value:"SchemaError",enumerable:!1}});var VO=Mr.SchemaContext=function(e,r,n,i,o){this.schema=e,this.options=r,Array.isArray(n)?(this.path=n,this.propertyPath=n.reduce(function(s,a){return s+BH(a)},"instance")):this.propertyPath=n,this.base=i,this.schemas=o};VO.prototype.resolve=function(e){return HH(this.base,e)};VO.prototype.makeChild=function(e,r){var n=r===void 0?this.path:this.path.concat([r]),i=e.$id||e.id;let o=HH(this.base,i||"");var s=new VO(e,this.options,n,o,Object.create(this.schemas));return i&&!s.schemas[o]&&(s.schemas[o]=e),s};var Qn=Mr.FORMAT_REGEXPS={"date-time":/^\d{4}-(?:0[0-9]{1}|1[0-2]{1})-(3[01]|0[1-9]|[12][0-9])[tT ](2[0-4]|[01][0-9]):([0-5][0-9]):(60|[0-5][0-9])(\.\d+)?([zZ]|[+-]([0-5][0-9]):(60|[0-5][0-9]))$/,date:/^\d{4}-(?:0[0-9]{1}|1[0-2]{1})-(3[01]|0[1-9]|[12][0-9])$/,time:/^(2[0-4]|[01][0-9]):([0-5][0-9]):(60|[0-5][0-9])$/,duration:/P(T\d+(H(\d+M(\d+S)?)?|M(\d+S)?|S)|\d+(D|M(\d+D)?|Y(\d+M(\d+D)?)?)(T\d+(H(\d+M(\d+S)?)?|M(\d+S)?|S))?|\d+W)/i,email:/^(?:[\w\!\#\$\%\&\'\*\+\-\/\=\?\^\`\{\|\}\~]+\.)*[\w\!\#\$\%\&\'\*\+\-\/\=\?\^\`\{\|\}\~]+@(?:(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9\-](?!\.)){0,61}[a-zA-Z0-9]?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9\-](?!$)){0,61}[a-zA-Z0-9]?)|(?:\[(?:(?:[01]?\d{1,2}|2[0-4]\d|25[0-5])\.){3}(?:[01]?\d{1,2}|2[0-4]\d|25[0-5])\]))$/,"idn-email":/^("(?:[!#-\[\]-\u{10FFFF}]|\\[\t -\u{10FFFF}])*"|[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}](?:\.?[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}])*)@([!#-'*+\-/-9=?A-Z\^-\u{10FFFF}](?:\.?[!#-'*+\-/-9=?A-Z\^-\u{10FFFF}])*|\[[!-Z\^-\u{10FFFF}]*\])$/u,"ip-address":/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,ipv6:/^\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*$/,uri:/^[a-zA-Z][a-zA-Z0-9+.-]*:[^\s]*$/,"uri-reference":/^(((([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|([A-Za-z][+\-.0-9A-Za-z]*:?)?)|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|(\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?)?))#(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|(([A-Za-z][+\-.0-9A-Za-z]*)?%[0-9A-Fa-f]{2}|[!$&-.0-9;=@_~]|[A-Za-z][+\-.0-9A-Za-z]*[!$&-*,;=@_~])(%[0-9A-Fa-f]{2}|[!$&-.0-9;=@-Z_a-z~])*((([/?](%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*)?#|[/?])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*)?|([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~])*|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~])+(:\d*)?|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?:\d*|\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~]+)?|[.0-:A-Fa-f]+)\])?)?|[A-Za-z][+\-.0-9A-Za-z]*:?)?$/,iri:/^[a-zA-Z][a-zA-Z0-9+.-]*:[^\s]*$/,"iri-reference":/^(((([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~-\u{10FFFF}]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|([A-Za-z][+\-.0-9A-Za-z]*:?)?)|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|(\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?)?))#(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|(([A-Za-z][+\-.0-9A-Za-z]*)?%[0-9A-Fa-f]{2}|[!$&-.0-9;=@_~-\u{10FFFF}]|[A-Za-z][+\-.0-9A-Za-z]*[!$&-*,;=@_~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-.0-9;=@-Z_a-z~-\u{10FFFF}])*((([/?](%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*)?#|[/?])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*)?|([A-Za-z][+\-.0-9A-Za-z]*(:%[0-9A-Fa-f]{2}|:[!$&-.0-;=?-Z_a-z~-\u{10FFFF}]|[/?])|\?)(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|([A-Za-z][+\-.0-9A-Za-z]*:)?\/((%[0-9A-Fa-f]{2}|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)(:\d*)?[/?]|[!$&-.0-;=?-Z_a-z~-\u{10FFFF}])(%[0-9A-Fa-f]{2}|[!$&-;=?-Z_a-z~-\u{10FFFF}])*|\/((%[0-9A-Fa-f]{2}|[!$&-.0-9;=A-Z_a-z~-\u{10FFFF}])+(:\d*)?|(\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?:\d*|\[(([Vv][0-9A-Fa-f]+\.[!$&-.0-;=A-Z_a-z~-\u{10FFFF}]+)?|[.0-:A-Fa-f]+)\])?)?|[A-Za-z][+\-.0-9A-Za-z]*:?)?$/u,uuid:/^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i,"uri-template":/(%[0-9a-f]{2}|[!#$&(-;=?@\[\]_a-z~]|\{[!#&+,./;=?@|]?(%[0-9a-f]{2}|[0-9_a-z])(\.?(%[0-9a-f]{2}|[0-9_a-z]))*(:[1-9]\d{0,3}|\*)?(,(%[0-9a-f]{2}|[0-9_a-z])(\.?(%[0-9a-f]{2}|[0-9_a-z]))*(:[1-9]\d{0,3}|\*)?)*\})*/iu,"json-pointer":/^(\/([\x00-\x2e0-@\[-}\x7f]|~[01])*)*$/iu,"relative-json-pointer":/^\d+(#|(\/([\x00-\x2e0-@\[-}\x7f]|~[01])*)*)$/iu,hostname:/^(?=.{1,255}$)[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?(?:\.[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?)*\.?$/,"host-name":/^(?=.{1,255}$)[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?(?:\.[0-9A-Za-z](?:(?:[0-9A-Za-z]|-){0,61}[0-9A-Za-z])?)*\.?$/,"utc-millisec":function(t){return typeof t=="string"&&parseFloat(t)===parseInt(t,10)&&!isNaN(t)},regex:function(t){var e=!0;try{new RegExp(t)}catch{e=!1}return e},style:/[\r\n\t ]*[^\r\n\t ][^:]*:[\r\n\t ]*[^\r\n\t ;]*[\r\n\t ]*;?/,color:/^(#?([0-9A-Fa-f]{3}){1,2}\b|aqua|black|blue|fuchsia|gray|green|lime|maroon|navy|olive|orange|purple|red|silver|teal|white|yellow|(rgb\(\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*,\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*,\s*\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\b\s*\))|(rgb\(\s*(\d?\d%|100%)+\s*,\s*(\d?\d%|100%)+\s*,\s*(\d?\d%|100%)+\s*\)))$/,phone:/^\+(?:[0-9] ?){6,14}[0-9]$/,alpha:/^[a-zA-Z]+$/,alphanumeric:/^[a-zA-Z0-9]+$/};Qn.regexp=Qn.regex;Qn.pattern=Qn.regex;Qn.ipv4=Qn["ip-address"];Mr.isFormat=function(e,r,n){if(typeof e=="string"&&Qn[r]!==void 0){if(Qn[r]instanceof RegExp)return Qn[r].test(e);if(typeof Qn[r]=="function")return Qn[r](e)}else if(n&&n.customFormats&&typeof n.customFormats[r]=="function")return n.customFormats[r](e);return!0};var BH=Mr.makeSuffix=function(e){return e=e.toString(),!e.match(/[.\s\[\]]/)&&!e.match(/^[\d]/)?"."+e:e.match(/^\d+$/)?"["+e+"]":"["+JSON.stringify(e)+"]"};Mr.deepCompareStrict=function t(e,r){if(typeof e!=typeof r)return!1;if(Array.isArray(e))return!Array.isArray(r)||e.length!==r.length?!1:e.every(function(o,s){return t(e[s],r[s])});if(typeof e=="object"){if(!e||!r)return e===r;var n=Object.keys(e),i=Object.keys(r);return n.length!==i.length?!1:n.every(function(o){return t(e[o],r[o])})}return e===r};function Qye(t,e,r,n){typeof r=="object"?e[n]=WO(t[n],r):t.indexOf(r)===-1&&e.push(r)}function e_e(t,e,r){e[r]=t[r]}function t_e(t,e,r,n){typeof e[n]!="object"||!e[n]?r[n]=e[n]:t[n]?r[n]=WO(t[n],e[n]):r[n]=e[n]}function WO(t,e){var r=Array.isArray(e),n=r&&[]||{};return r?(t=t||[],n=n.concat(t),e.forEach(Qye.bind(null,t,n))):(t&&typeof t=="object"&&Object.keys(t).forEach(e_e.bind(null,t,n)),Object.keys(e).forEach(t_e.bind(null,t,e,n))),n}KO.exports.deepMerge=WO;Mr.objectGetPath=function(e,r){for(var n=r.split("/").slice(1),i;typeof(i=n.shift())=="string";){var o=decodeURIComponent(i.replace(/~0/,"~").replace(/~1/g,"/"));if(!(o in e))return;e=e[o]}return e};function r_e(t){return"/"+encodeURIComponent(t).replace(/~/g,"%7E")}Mr.encodePath=function(e){return e.map(r_e).join("")};Mr.getDecimalPlaces=function(e){var r=0;if(isNaN(e))return r;typeof e!="number"&&(e=Number(e));var n=e.toString().split("e");if(n.length===2){if(n[1][0]!=="-")return r;r=Number(n[1].slice(1))}var i=n[0].split(".");return i.length===2&&(r+=i[1].length),r};Mr.isSchema=function(e){return typeof e=="object"&&e||typeof e=="boolean"};var HH=Mr.resolveUrl=function(e,r){let n=new URL(r,new URL(e,"resolve://"));if(n.protocol==="resolve:"){let{pathname:i,search:o,hash:s}=n;return i+o+s}return n.toString()}});var WH=v((y7e,VH)=>{"use strict";var nn=is(),Le=nn.ValidatorResult,os=nn.SchemaError,JO={};JO.ignoreProperties={id:!0,default:!0,description:!0,title:!0,additionalItems:!0,then:!0,else:!0,$schema:!0,$ref:!0,extends:!0};var ze=JO.validators={};ze.type=function(e,r,n,i){if(e===void 0)return null;var o=new Le(e,r,n,i),s=Array.isArray(r.type)?r.type:[r.type];if(!s.some(this.testType.bind(this,e,r,n,i))){var a=s.map(function(c){if(c){var l=c.$id||c.id;return l?"<"+l+">":c+""}});o.addError({name:"type",argument:a,message:"is not of a type(s) "+a})}return o};function YO(t,e,r,n,i){var o=e.throwError,s=e.throwAll;e.throwError=!1,e.throwAll=!1;var a=this.validateSchema(t,i,e,r);return e.throwError=o,e.throwAll=s,!a.valid&&n instanceof Function&&n(a),a.valid}ze.anyOf=function(e,r,n,i){if(e===void 0)return null;var o=new Le(e,r,n,i),s=new Le(e,r,n,i);if(!Array.isArray(r.anyOf))throw new os("anyOf must be an array");if(!r.anyOf.some(YO.bind(this,e,n,i,function(c){s.importErrors(c)}))){var a=r.anyOf.map(function(c,l){var u=c.$id||c.id;return u?"<"+u+">":c.title&&JSON.stringify(c.title)||c.$ref&&"<"+c.$ref+">"||"[subschema "+l+"]"});n.nestedErrors&&o.importErrors(s),o.addError({name:"anyOf",argument:a,message:"is not any of "+a.join(",")})}return o};ze.allOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.allOf))throw new os("allOf must be an array");var o=new Le(e,r,n,i),s=this;return r.allOf.forEach(function(a,c){var l=s.validateSchema(e,a,n,i);if(!l.valid){var u=a.$id||a.id,d=u||a.title&&JSON.stringify(a.title)||a.$ref&&"<"+a.$ref+">"||"[subschema "+c+"]";o.addError({name:"allOf",argument:{id:d,length:l.errors.length,valid:l},message:"does not match allOf schema "+d+" with "+l.errors.length+" error[s]:"}),o.importErrors(l)}}),o};ze.oneOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.oneOf))throw new os("oneOf must be an array");var o=new Le(e,r,n,i),s=new Le(e,r,n,i),a=r.oneOf.filter(YO.bind(this,e,n,i,function(l){s.importErrors(l)})).length,c=r.oneOf.map(function(l,u){var d=l.$id||l.id;return d||l.title&&JSON.stringify(l.title)||l.$ref&&"<"+l.$ref+">"||"[subschema "+u+"]"});return a!==1&&(n.nestedErrors&&o.importErrors(s),o.addError({name:"oneOf",argument:c,message:"is not exactly one from "+c.join(",")})),o};ze.if=function(e,r,n,i){if(e===void 0)return null;if(!nn.isSchema(r.if))throw new Error('Expected "if" keyword to be a schema');var o=YO.call(this,e,n,i,null,r.if),s=new Le(e,r,n,i),a;if(o){if(r.then===void 0)return;if(!nn.isSchema(r.then))throw new Error('Expected "then" keyword to be a schema');a=this.validateSchema(e,r.then,n,i.makeChild(r.then)),s.importErrors(a)}else{if(r.else===void 0)return;if(!nn.isSchema(r.else))throw new Error('Expected "else" keyword to be a schema');a=this.validateSchema(e,r.else,n,i.makeChild(r.else)),s.importErrors(a)}return s};function XO(t,e){if(Object.hasOwnProperty.call(t,e))return t[e];if(e in t){for(;t=Object.getPrototypeOf(t);)if(Object.propertyIsEnumerable.call(t,e))return t[e]}}ze.propertyNames=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.propertyNames!==void 0?r.propertyNames:{};if(!nn.isSchema(s))throw new os('Expected "propertyNames" to be a schema (object or boolean)');for(var a in e)if(XO(e,a)!==void 0){var c=this.validateSchema(a,s,n,i.makeChild(s));o.importErrors(c)}return o}};ze.properties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.properties||{};for(var a in s){var c=s[a];if(c!==void 0){if(c===null)throw new os('Unexpected null, expected schema in "properties"');typeof n.preValidateProperty=="function"&&n.preValidateProperty(e,a,c,n,i);var l=XO(e,a),u=this.validateSchema(l,c,n,i.makeChild(c,a));u.instance!==o.instance[a]&&(o.instance[a]=u.instance),o.importErrors(u)}}return o}};function GH(t,e,r,n,i,o){if(this.types.object(t)&&!(e.properties&&e.properties[i]!==void 0))if(e.additionalProperties===!1)o.addError({name:"additionalProperties",argument:i,message:"is not allowed to have the additional property "+JSON.stringify(i)});else{var s=e.additionalProperties||{};typeof r.preValidateProperty=="function"&&r.preValidateProperty(t,i,s,r,n);var a=this.validateSchema(t[i],s,r,n.makeChild(s,i));a.instance!==o.instance[i]&&(o.instance[i]=a.instance),o.importErrors(a)}}ze.patternProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=r.patternProperties||{};for(var a in e){var c=!0;for(var l in s){var u=s[l];if(u!==void 0){if(u===null)throw new os('Unexpected null, expected schema in "patternProperties"');try{var d=new RegExp(l,"u")}catch{d=new RegExp(l)}if(d.test(a)){c=!1,typeof n.preValidateProperty=="function"&&n.preValidateProperty(e,a,u,n,i);var f=this.validateSchema(e[a],u,n,i.makeChild(u,a));f.instance!==o.instance[a]&&(o.instance[a]=f.instance),o.importErrors(f)}}}c&&GH.call(this,e,r,n,i,a,o)}return o}};ze.additionalProperties=function(e,r,n,i){if(this.types.object(e)){if(r.patternProperties)return null;var o=new Le(e,r,n,i);for(var s in e)GH.call(this,e,r,n,i,s,o);return o}};ze.minProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=Object.keys(e);return s.length>=r.minProperties||o.addError({name:"minProperties",argument:r.minProperties,message:"does not meet minimum property length of "+r.minProperties}),o}};ze.maxProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Le(e,r,n,i),s=Object.keys(e);return s.length<=r.maxProperties||o.addError({name:"maxProperties",argument:r.maxProperties,message:"does not meet maximum property length of "+r.maxProperties}),o}};ze.items=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.items!==void 0){var s=new Le(e,r,n,i);return e.every(function(a,c){if(Array.isArray(r.items))var l=r.items[c]===void 0?r.additionalItems:r.items[c];else var l=r.items;if(l===void 0)return!0;if(l===!1)return s.addError({name:"items",message:"additionalItems not permitted"}),!1;var u=o.validateSchema(a,l,n,i.makeChild(l,c));return u.instance!==s.instance[c]&&(s.instance[c]=u.instance),s.importErrors(u),!0}),s}};ze.contains=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.contains!==void 0){if(!nn.isSchema(r.contains))throw new Error('Expected "contains" keyword to be a schema');var s=new Le(e,r,n,i),a=e.some(function(c,l){var u=o.validateSchema(c,r.contains,n,i.makeChild(r.contains,l));return u.errors.length===0});return a===!1&&s.addError({name:"contains",argument:r.contains,message:"must contain an item matching given schema"}),s}};ze.minimum=function(e,r,n,i){if(this.types.number(e)){var o=new Le(e,r,n,i);return r.exclusiveMinimum&&r.exclusiveMinimum===!0?e>r.minimum||o.addError({name:"minimum",argument:r.minimum,message:"must be greater than "+r.minimum}):e>=r.minimum||o.addError({name:"minimum",argument:r.minimum,message:"must be greater than or equal to "+r.minimum}),o}};ze.maximum=function(e,r,n,i){if(this.types.number(e)){var o=new Le(e,r,n,i);return r.exclusiveMaximum&&r.exclusiveMaximum===!0?er.exclusiveMinimum;return s||o.addError({name:"exclusiveMinimum",argument:r.exclusiveMinimum,message:"must be strictly greater than "+r.exclusiveMinimum}),o}};ze.exclusiveMaximum=function(e,r,n,i){if(typeof r.exclusiveMaximum!="boolean"&&this.types.number(e)){var o=new Le(e,r,n,i),s=e=r.minLength||o.addError({name:"minLength",argument:r.minLength,message:"does not meet minimum length of "+r.minLength}),o}};ze.maxLength=function(e,r,n,i){if(this.types.string(e)){var o=new Le(e,r,n,i),s=e.match(/[\uDC00-\uDFFF]/g),a=e.length-(s?s.length:0);return a<=r.maxLength||o.addError({name:"maxLength",argument:r.maxLength,message:"does not meet maximum length of "+r.maxLength}),o}};ze.minItems=function(e,r,n,i){if(this.types.array(e)){var o=new Le(e,r,n,i);return e.length>=r.minItems||o.addError({name:"minItems",argument:r.minItems,message:"does not meet minimum length of "+r.minItems}),o}};ze.maxItems=function(e,r,n,i){if(this.types.array(e)){var o=new Le(e,r,n,i);return e.length<=r.maxItems||o.addError({name:"maxItems",argument:r.maxItems,message:"does not meet maximum length of "+r.maxItems}),o}};function n_e(t,e,r){var n,i=r.length;for(n=e+1,i;n{"use strict";var QO=is();eR.exports.SchemaScanResult=KH;function KH(t,e){this.id=t,this.ref=e}eR.exports.scan=function(e,r){function n(c,l){if(!l||typeof l!="object")return;if(l.$ref){let p=QO.resolveUrl(c,l.$ref);a[p]=a[p]?a[p]+1:0;return}var u=l.$id||l.id;let d=QO.resolveUrl(c,u);var f=u?d:c;if(f){if(f.indexOf("#")<0&&(f+="#"),s[f]){if(!QO.deepCompareStrict(s[f],l))throw new Error("Schema <"+f+"> already exists with different definition");return s[f]}s[f]=l,f[f.length-1]=="#"&&(s[f.substring(0,f.length-1)]=l)}i(f+"/items",Array.isArray(l.items)?l.items:[l.items]),i(f+"/extends",Array.isArray(l.extends)?l.extends:[l.extends]),n(f+"/additionalItems",l.additionalItems),o(f+"/properties",l.properties),n(f+"/additionalProperties",l.additionalProperties),o(f+"/definitions",l.definitions),o(f+"/patternProperties",l.patternProperties),o(f+"/dependencies",l.dependencies),i(f+"/disallow",l.disallow),i(f+"/allOf",l.allOf),i(f+"/anyOf",l.anyOf),i(f+"/oneOf",l.oneOf),n(f+"/not",l.not)}function i(c,l){if(Array.isArray(l))for(var u=0;u{"use strict";var JH=WH(),ss=is(),YH=z_().scan,XH=ss.ValidatorResult,i_e=ss.ValidatorResultError,Uf=ss.SchemaError,QH=ss.SchemaContext,o_e="/",Jt=function t(){this.customFormats=Object.create(t.prototype.customFormats),this.schemas={},this.unresolvedRefs=[],this.types=Object.create(Ri),this.attributes=Object.create(JH.validators)};Jt.prototype.customFormats={};Jt.prototype.schemas=null;Jt.prototype.types=null;Jt.prototype.attributes=null;Jt.prototype.unresolvedRefs=null;Jt.prototype.addSchema=function(e,r){var n=this;if(!e)return null;var i=YH(r||o_e,e),o=r||e.$id||e.id;for(var s in i.id)this.schemas[s]=i.id[s];for(var s in i.ref)this.unresolvedRefs.push(s);return this.unresolvedRefs=this.unresolvedRefs.filter(function(a){return typeof n.schemas[a]>"u"}),this.schemas[o]};Jt.prototype.addSubSchemaArray=function(e,r){if(Array.isArray(r))for(var n=0;n",e);var a=ss.objectGetPath(n.schemas[s],o.substr(1));if(a===void 0)throw new Uf("no such schema "+o+" located in <"+s+">",e);return{subschema:a,switchSchema:r}};Jt.prototype.testType=function(e,r,n,i,o){if(o!==void 0){if(o===null)throw new Uf('Unexpected null in "type" keyword');if(typeof this.types[o]=="function")return this.types[o].call(this,e);if(o&&typeof o=="object"){var s=this.validateSchema(e,o,n,i);return s===void 0||!(s&&s.errors.length)}return!0}};var Ri=Jt.prototype.types={};Ri.string=function(e){return typeof e=="string"};Ri.number=function(e){return typeof e=="number"&&isFinite(e)};Ri.integer=function(e){return typeof e=="number"&&e%1===0};Ri.boolean=function(e){return typeof e=="boolean"};Ri.array=function(e){return Array.isArray(e)};Ri.null=function(e){return e===null};Ri.date=function(e){return e instanceof Date};Ri.any=function(e){return!0};Ri.object=function(e){return e&&typeof e=="object"&&!Array.isArray(e)&&!(e instanceof Date)};tG.exports=Jt});var nG=v((v7e,ho)=>{"use strict";var s_e=ho.exports.Validator=rG();ho.exports.ValidatorResult=is().ValidatorResult;ho.exports.ValidatorResultError=is().ValidatorResultError;ho.exports.ValidationError=is().ValidationError;ho.exports.SchemaError=is().SchemaError;ho.exports.SchemaScanResult=z_().SchemaScanResult;ho.exports.scan=z_().scan;ho.exports.validate=function(t,e,r){var n=new s_e;return n.validate(t,e,r)}});import{readFileSync as a_e}from"node:fs";import{dirname as c_e,join as l_e}from"node:path";import{fileURLToPath as u_e}from"node:url";function h_e(t){let e=m_e.validate(t,p_e);return e.valid?{valid:!0,errors:[]}:{valid:!1,errors:e.errors.map(n=>`${n.property}: ${n.message}`)}}function oG(t){let e=h_e(t);if(!e.valid)throw new Error(`spec.yaml invalid: ${e.errors.join(` - `)}`)}var nG,c_e,l_e,u_e,d_e,oG=y(()=>{"use strict";nG=St(rG(),1),c_e=o_e(a_e(import.meta.url)),l_e=s_e(c_e,"schema.json"),u_e=JSON.parse(i_e(l_e,"utf8")),d_e=new nG.Validator});import{existsSync as tR,readdirSync as p_e}from"node:fs";import{dirname as m_e,join as ka,resolve as aG}from"node:path";function sG(t){return tR(t)?p_e(t).filter(r=>r.endsWith(".yaml")||r.endsWith(".yml")).map(r=>Oi(ka(t,r))):[]}function Ea(t,e){U_=e?{cwd:aG(t),spec:e}:null}function q(t=".",e="spec.yaml"){return U_&&e==="spec.yaml"&&aG(t)===U_.cwd?U_.spec:h_e(t,e)}function h_e(t,e){let r=ka(t,e),n=Oi(r),i=ka(t,m_e(e),"spec");if(!n.features||n.features.length===0){let o=sG(ka(i,"features"));o.length>0&&(n.features=o)}if(!n.scenarios||n.scenarios.length===0){let o=sG(ka(i,"scenarios"));o.length>0&&(n.scenarios=o)}if(!n.architecture){let o=ka(i,"architecture.yaml");tR(o)&&(n.architecture=Oi(o))}if(!n.capabilities||n.capabilities.length===0){let o=ka(i,"capabilities.yaml");if(tR(o)){let s=Oi(o);s&&Array.isArray(s.capabilities)&&(n.capabilities=s.capabilities)}}return iG(n),n}var U_,Ue=y(()=>{"use strict";F_();oG();U_=null});import yl from"node:process";function iR(){return!!yl.stdout.isTTY}function L(t,e,r=""){let n=cG[t],i=r?` ${r}`:"";iR()?yl.stdout.write(`${rR[t]}${n}${nR} ${e}${i} + `)}`)}var iG,d_e,f_e,p_e,m_e,sG=y(()=>{"use strict";iG=St(nG(),1),d_e=c_e(u_e(import.meta.url)),f_e=l_e(d_e,"schema.json"),p_e=JSON.parse(a_e(f_e,"utf8")),m_e=new iG.Validator});import{existsSync as tR,readdirSync as g_e}from"node:fs";import{dirname as y_e,join as ka,resolve as cG}from"node:path";function aG(t){return tR(t)?g_e(t).filter(r=>r.endsWith(".yaml")||r.endsWith(".yml")).map(r=>Oi(ka(t,r))):[]}function Ea(t,e){U_=e?{cwd:cG(t),spec:e}:null}function q(t=".",e="spec.yaml"){return U_&&e==="spec.yaml"&&cG(t)===U_.cwd?U_.spec:__e(t,e)}function __e(t,e){let r=ka(t,e),n=Oi(r),i=ka(t,y_e(e),"spec");if(!n.features||n.features.length===0){let o=aG(ka(i,"features"));o.length>0&&(n.features=o)}if(!n.scenarios||n.scenarios.length===0){let o=aG(ka(i,"scenarios"));o.length>0&&(n.scenarios=o)}if(!n.architecture){let o=ka(i,"architecture.yaml");tR(o)&&(n.architecture=Oi(o))}if(!n.capabilities||n.capabilities.length===0){let o=ka(i,"capabilities.yaml");if(tR(o)){let s=Oi(o);s&&Array.isArray(s.capabilities)&&(n.capabilities=s.capabilities)}}return oG(n),n}var U_,Ue=y(()=>{"use strict";F_();sG();U_=null});import yl from"node:process";function iR(){return!!yl.stdout.isTTY}function L(t,e,r=""){let n=lG[t],i=r?` ${r}`:"";iR()?yl.stdout.write(`${rR[t]}${n}${nR} ${e}${i} `):yl.stdout.write(`${n} ${e}${i} -`)}function Uf(t,e,r=""){if(!iR())return;let n=r?` ${r}`:"";yl.stdout.write(`${lG}${rR.start}\xB7${nR} ${t} \xB7 ${e}${n}`)}function Aa(t,e,r=""){let n=cG[t],i=r?` ${r}`:"";iR()?yl.stdout.write(`${lG}${rR[t]}${n}${nR} ${e}${i} +`)}function qf(t,e,r=""){if(!iR())return;let n=r?` ${r}`:"";yl.stdout.write(`${uG}${rR.start}\xB7${nR} ${t} \xB7 ${e}${n}`)}function Aa(t,e,r=""){let n=lG[t],i=r?` ${r}`:"";iR()?yl.stdout.write(`${uG}${rR[t]}${n}${nR} ${e}${i} `):yl.stdout.write(`${n} ${e}${i} -`)}var cG,rR,nR,lG,Ii=y(()=>{"use strict";cG={start:"\xB7",pass:"\u2713",fail:"\u2717",skip:"\xB7",note:"\u2139"},rR={start:"\x1B[90m",pass:"\x1B[32m",fail:"\x1B[31m",skip:"\x1B[90m",note:"\x1B[36m"},nR="\x1B[0m",lG="\r\x1B[K"});import{createHash as RG}from"node:crypto";import{existsSync as V_e,readFileSync as aR,writeFileSync as W_e}from"node:fs";import{join as q_}from"node:path";function K_e(t,e){let r=RG("sha256");for(let n of[...e].sort()){r.update(n),r.update("\0");try{r.update(aR(q_(t,n)))}catch{r.update("")}r.update("\0")}return r.digest("hex").slice(0,16)}function PG(t,e){let r=RG("sha256");try{r.update(aR(q_(t,e)))}catch{r.update("")}return r.digest("hex").slice(0,16)}function as(t){let e=q_(t,...IG);if(!V_e(e))return null;let r;try{r=aR(e,"utf8")}catch{return null}let n=null,i=null,o=null,s="other";for(let a of r.split(` -`)){if(a==="attested:"){s="v1",n??=new Map;continue}if(a==="attested_modules:"){s="modules",i??=new Map;continue}if(a==="attested_features:"){s="features",o??=new Set;continue}if(!(a.startsWith("#")||a.trim()==="")){if(s==="v1"){let c=a.match(/^ {2}(F-[\w-]+): ([0-9a-f]{16})$/);c&&n.set(c[1],c[2])}else if(s==="modules"){let c=a.match(/^ {2}(.+): ([0-9a-f]{16})$/);c&&i.set(c[1],c[2])}else if(s==="features"){let c=a.match(/^ {2}(F-[\w-]+): ok$/);c&&o.add(c[1])}}}return{v1:n,modules:i,features:o}}function B_(t){return t.features?.size??t.v1?.size??0}function H_(t,e,r){let n=r.modules??[];if(t.modules!==null||t.features!==null){if(!t.features?.has(r.id))return{state:"unattested"};let o=t.modules??new Map;for(let s of[...n].sort())if(o.get(s)!==PG(e,s))return{state:"stale",module:s};return{state:"fresh"}}let i=t.v1?.get(r.id);return i===void 0?{state:"unattested"}:i===K_e(e,n)?{state:"fresh"}:{state:"stale"}}function CG(t,e){let r=(e.features??[]).filter(a=>a.status==="done"&&(a.modules??[]).length>0);if(r.length===0)return!1;let n=new Set;for(let a of r)for(let c of a.modules??[])n.add(c);let i=[...n].sort().map(a=>` ${a}: ${PG(t,a)}`),o=r.map(a=>` ${a.id}: ok`).sort(),s=J_e+`attested_modules: +`)}var lG,rR,nR,uG,Ii=y(()=>{"use strict";lG={start:"\xB7",pass:"\u2713",fail:"\u2717",skip:"\xB7",note:"\u2139"},rR={start:"\x1B[90m",pass:"\x1B[32m",fail:"\x1B[31m",skip:"\x1B[90m",note:"\x1B[36m"},nR="\x1B[0m",uG="\r\x1B[K"});import{createHash as PG}from"node:crypto";import{existsSync as J_e,readFileSync as aR,writeFileSync as Y_e}from"node:fs";import{join as q_}from"node:path";function X_e(t,e){let r=PG("sha256");for(let n of[...e].sort()){r.update(n),r.update("\0");try{r.update(aR(q_(t,n)))}catch{r.update("")}r.update("\0")}return r.digest("hex").slice(0,16)}function DG(t,e){let r=PG("sha256");try{r.update(aR(q_(t,e)))}catch{r.update("")}return r.digest("hex").slice(0,16)}function as(t){let e=q_(t,...CG);if(!J_e(e))return null;let r;try{r=aR(e,"utf8")}catch{return null}let n=null,i=null,o=null,s="other";for(let a of r.split(` +`)){if(a==="attested:"){s="v1",n??=new Map;continue}if(a==="attested_modules:"){s="modules",i??=new Map;continue}if(a==="attested_features:"){s="features",o??=new Set;continue}if(!(a.startsWith("#")||a.trim()==="")){if(s==="v1"){let c=a.match(/^ {2}(F-[\w-]+): ([0-9a-f]{16})$/);c&&n.set(c[1],c[2])}else if(s==="modules"){let c=a.match(/^ {2}(.+): ([0-9a-f]{16})$/);c&&i.set(c[1],c[2])}else if(s==="features"){let c=a.match(/^ {2}(F-[\w-]+): ok$/);c&&o.add(c[1])}}}return{v1:n,modules:i,features:o}}function B_(t){return t.features?.size??t.v1?.size??0}function H_(t,e,r){let n=r.modules??[];if(t.modules!==null||t.features!==null){if(!t.features?.has(r.id))return{state:"unattested"};let o=t.modules??new Map;for(let s of[...n].sort())if(o.get(s)!==DG(e,s))return{state:"stale",module:s};return{state:"fresh"}}let i=t.v1?.get(r.id);return i===void 0?{state:"unattested"}:i===X_e(e,n)?{state:"fresh"}:{state:"stale"}}function NG(t,e){let r=(e.features??[]).filter(a=>a.status==="done"&&(a.modules??[]).length>0);if(r.length===0)return!1;let n=new Set;for(let a of r)for(let c of a.modules??[])n.add(c);let i=[...n].sort().map(a=>` ${a}: ${DG(t,a)}`),o=r.map(a=>` ${a.id}: ok`).sort(),s=Q_e+`attested_modules: `+i.join(` `)+` attested_features: `+o.join(` `)+` -`;return W_e(q_(t,...IG),s,"utf8"),!0}var IG,J_e,vl=y(()=>{"use strict";IG=["spec","attestation.yaml"];J_e=`# Cladding \xB7 Tier C \u2014 verification attestation (v2). Written ONLY by a GREEN +`;return Y_e(q_(t,...CG),s,"utf8"),!0}var CG,Q_e,vl=y(()=>{"use strict";CG=["spec","attestation.yaml"];Q_e=`# Cladding \xB7 Tier C \u2014 verification attestation (v2). Written ONLY by a GREEN # \`clad check --tier=pre-push --strict\` gate \u2014 the file's one honest author. # Do not edit by hand. # @@ -211,53 +211,53 @@ attested_features: # Merge conflict here? NEVER hand-resolve the hashes \u2014 keep either side and run # \`clad check --tier=pre-push --strict\`; the GREEN gate rewrites the truth. # Content-anchored: survives fresh clones and squash/rebase. -`});import{resolve as cR}from"node:path";function G_(t){cs={cwd:cR(t),results:new Map}}function DG(t,e,r){!cs||cs.cwd!==cR(e)||cs.results.set(t,r)}function Z_(t,e){return!cs||cs.cwd!==cR(e)?null:cs.results.get(t)??null}function V_(){cs=null}var cs,Sl=y(()=>{"use strict";cs=null});function Ot(t){if(typeof t!="object"||t===null)return!1;let e=Object.getPrototypeOf(t);return(e===null||e===Object.prototype||Object.getPrototypeOf(e)===null)&&!(Symbol.toStringTag in t)&&!(Symbol.iterator in t)}var yo=y(()=>{});import{fileURLToPath as Y_e}from"node:url";var wl,X_e,lR,uR,xl=y(()=>{wl=(t,e)=>{let r=uR(X_e(t));if(typeof r!="string")throw new TypeError(`${e} must be a string or a file URL: ${r}.`);return r},X_e=t=>lR(t)?t.toString():t,lR=t=>typeof t!="string"&&t&&Object.getPrototypeOf(t)===String.prototype,uR=t=>t instanceof URL?Y_e(t):t});var W_,dR=y(()=>{yo();xl();W_=(t,e=[],r={})=>{let n=wl(t,"First argument"),[i,o]=Ot(e)?[[],e]:[e,r];if(!Array.isArray(i))throw new TypeError(`Second argument must be either an array of arguments or an options object: ${i}`);if(i.some(c=>typeof c=="object"&&c!==null))throw new TypeError(`Second argument must be an array of strings: ${i}`);let s=i.map(String),a=s.find(c=>c.includes("\0"));if(a!==void 0)throw new TypeError(`Arguments cannot contain null bytes ("\\0"): ${a}`);if(!Ot(o))throw new TypeError(`Last argument must be an options object: ${o}`);return[n,s,o]}});import{StringDecoder as Q_e}from"node:string_decoder";var NG,jG,qt,_o,ebe,MG,tbe,K_,FG,rbe,Bf,nbe,fR,ibe,nn=y(()=>{({toString:NG}=Object.prototype),jG=t=>NG.call(t)==="[object ArrayBuffer]",qt=t=>NG.call(t)==="[object Uint8Array]",_o=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),ebe=new TextEncoder,MG=t=>ebe.encode(t),tbe=new TextDecoder,K_=t=>tbe.decode(t),FG=(t,e)=>rbe(t,e).join(""),rbe=(t,e)=>{if(e==="utf8"&&t.every(o=>typeof o=="string"))return t;let r=new Q_e(e),n=t.map(o=>typeof o=="string"?MG(o):o).map(o=>r.write(o)),i=r.end();return i===""?n:[...n,i]},Bf=t=>t.length===1&&qt(t[0])?t[0]:fR(nbe(t)),nbe=t=>t.map(e=>typeof e=="string"?MG(e):e),fR=t=>{let e=new Uint8Array(ibe(t)),r=0;for(let n of t)e.set(n,r),r+=n.length;return e},ibe=t=>{let e=0;for(let r of t)e+=r.length;return e}});import{ChildProcess as obe}from"node:child_process";var qG,BG,sbe,abe,LG,cbe,zG,UG,lbe,HG=y(()=>{yo();nn();qG=t=>Array.isArray(t)&&Array.isArray(t.raw),BG=(t,e)=>{let r=[];for(let[o,s]of t.entries())r=sbe({templates:t,expressions:e,tokens:r,index:o,template:s});if(r.length===0)throw new TypeError("Template script must not be empty");let[n,...i]=r;return[n,i,{}]},sbe=({templates:t,expressions:e,tokens:r,index:n,template:i})=>{if(i===void 0)throw new TypeError(`Invalid backslash sequence: ${t.raw[n]}`);let{nextTokens:o,leadingWhitespaces:s,trailingWhitespaces:a}=abe(i,t.raw[n]),c=zG(r,o,s);if(n===e.length)return c;let l=e[n],u=Array.isArray(l)?l.map(d=>UG(d)):[UG(l)];return zG(c,u,a)},abe=(t,e)=>{if(e.length===0)return{nextTokens:[],leadingWhitespaces:!1,trailingWhitespaces:!1};let r=[],n=0,i=LG.has(e[0]);for(let s=0,a=0;sr||t.length===0||e.length===0?[...t,...e]:[...t.slice(0,-1),`${t.at(-1)}${e[0]}`,...e.slice(1)],UG=t=>{let e=typeof t;if(e==="string")return t;if(e==="number")return String(t);if(Ot(t)&&("stdout"in t||"isMaxBuffer"in t))return lbe(t);throw t instanceof obe||Object.prototype.toString.call(t)==="[object Promise]"?new TypeError("Unexpected subprocess in template expression. Please use ${await subprocess} instead of ${subprocess}."):new TypeError(`Unexpected "${e}" in template expression`)},lbe=({stdout:t})=>{if(typeof t=="string")return t;if(qt(t))return K_(t);throw t===void 0?new TypeError(`Missing result.stdout in template expression. This is probably due to the previous subprocess' "stdout" option.`):new TypeError(`Unexpected "${typeof t}" stdout in template expression`)}});import pR from"node:process";var Qn,J_,Tn,Y_,bo=y(()=>{Qn=t=>J_.includes(t),J_=[pR.stdin,pR.stdout,pR.stderr],Tn=["stdin","stdout","stderr"],Y_=t=>Tn[t]??`stdio[${t}]`});import{debuglog as ube}from"node:util";var ZG,mR,dbe,fbe,pbe,mbe,GG,hbe,hR,gbe,ybe,_be,bbe,gR,vo,So=y(()=>{yo();bo();ZG=t=>{let e={...t};for(let r of gR)e[r]=mR(t,r);return e},mR=(t,e)=>{let r=Array.from({length:dbe(t)+1}),n=fbe(t[e],r,e);return ybe(n,e)},dbe=({stdio:t})=>Array.isArray(t)?Math.max(t.length,Tn.length):Tn.length,fbe=(t,e,r)=>Ot(t)?pbe(t,e,r):e.fill(t),pbe=(t,e,r)=>{for(let n of Object.keys(t).sort(mbe))for(let i of hbe(n,r,e))e[i]=t[n];return e},mbe=(t,e)=>GG(t)t==="stdout"||t==="stderr"?0:t==="all"?2:1,hbe=(t,e,r)=>{if(t==="ipc")return[r.length-1];let n=hR(t);if(n===void 0||n===0)throw new TypeError(`"${e}.${t}" is invalid. +`});import{resolve as cR}from"node:path";function G_(t){cs={cwd:cR(t),results:new Map}}function jG(t,e,r){!cs||cs.cwd!==cR(e)||cs.results.set(t,r)}function Z_(t,e){return!cs||cs.cwd!==cR(e)?null:cs.results.get(t)??null}function V_(){cs=null}var cs,Sl=y(()=>{"use strict";cs=null});function Ot(t){if(typeof t!="object"||t===null)return!1;let e=Object.getPrototypeOf(t);return(e===null||e===Object.prototype||Object.getPrototypeOf(e)===null)&&!(Symbol.toStringTag in t)&&!(Symbol.iterator in t)}var yo=y(()=>{});import{fileURLToPath as ebe}from"node:url";var wl,tbe,lR,uR,xl=y(()=>{wl=(t,e)=>{let r=uR(tbe(t));if(typeof r!="string")throw new TypeError(`${e} must be a string or a file URL: ${r}.`);return r},tbe=t=>lR(t)?t.toString():t,lR=t=>typeof t!="string"&&t&&Object.getPrototypeOf(t)===String.prototype,uR=t=>t instanceof URL?ebe(t):t});var W_,dR=y(()=>{yo();xl();W_=(t,e=[],r={})=>{let n=wl(t,"First argument"),[i,o]=Ot(e)?[[],e]:[e,r];if(!Array.isArray(i))throw new TypeError(`Second argument must be either an array of arguments or an options object: ${i}`);if(i.some(c=>typeof c=="object"&&c!==null))throw new TypeError(`Second argument must be an array of strings: ${i}`);let s=i.map(String),a=s.find(c=>c.includes("\0"));if(a!==void 0)throw new TypeError(`Arguments cannot contain null bytes ("\\0"): ${a}`);if(!Ot(o))throw new TypeError(`Last argument must be an options object: ${o}`);return[n,s,o]}});import{StringDecoder as rbe}from"node:string_decoder";var MG,FG,qt,_o,nbe,LG,ibe,K_,zG,obe,Hf,sbe,fR,abe,on=y(()=>{({toString:MG}=Object.prototype),FG=t=>MG.call(t)==="[object ArrayBuffer]",qt=t=>MG.call(t)==="[object Uint8Array]",_o=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),nbe=new TextEncoder,LG=t=>nbe.encode(t),ibe=new TextDecoder,K_=t=>ibe.decode(t),zG=(t,e)=>obe(t,e).join(""),obe=(t,e)=>{if(e==="utf8"&&t.every(o=>typeof o=="string"))return t;let r=new rbe(e),n=t.map(o=>typeof o=="string"?LG(o):o).map(o=>r.write(o)),i=r.end();return i===""?n:[...n,i]},Hf=t=>t.length===1&&qt(t[0])?t[0]:fR(sbe(t)),sbe=t=>t.map(e=>typeof e=="string"?LG(e):e),fR=t=>{let e=new Uint8Array(abe(t)),r=0;for(let n of t)e.set(n,r),r+=n.length;return e},abe=t=>{let e=0;for(let r of t)e+=r.length;return e}});import{ChildProcess as cbe}from"node:child_process";var HG,GG,lbe,ube,UG,dbe,qG,BG,fbe,ZG=y(()=>{yo();on();HG=t=>Array.isArray(t)&&Array.isArray(t.raw),GG=(t,e)=>{let r=[];for(let[o,s]of t.entries())r=lbe({templates:t,expressions:e,tokens:r,index:o,template:s});if(r.length===0)throw new TypeError("Template script must not be empty");let[n,...i]=r;return[n,i,{}]},lbe=({templates:t,expressions:e,tokens:r,index:n,template:i})=>{if(i===void 0)throw new TypeError(`Invalid backslash sequence: ${t.raw[n]}`);let{nextTokens:o,leadingWhitespaces:s,trailingWhitespaces:a}=ube(i,t.raw[n]),c=qG(r,o,s);if(n===e.length)return c;let l=e[n],u=Array.isArray(l)?l.map(d=>BG(d)):[BG(l)];return qG(c,u,a)},ube=(t,e)=>{if(e.length===0)return{nextTokens:[],leadingWhitespaces:!1,trailingWhitespaces:!1};let r=[],n=0,i=UG.has(e[0]);for(let s=0,a=0;sr||t.length===0||e.length===0?[...t,...e]:[...t.slice(0,-1),`${t.at(-1)}${e[0]}`,...e.slice(1)],BG=t=>{let e=typeof t;if(e==="string")return t;if(e==="number")return String(t);if(Ot(t)&&("stdout"in t||"isMaxBuffer"in t))return fbe(t);throw t instanceof cbe||Object.prototype.toString.call(t)==="[object Promise]"?new TypeError("Unexpected subprocess in template expression. Please use ${await subprocess} instead of ${subprocess}."):new TypeError(`Unexpected "${e}" in template expression`)},fbe=({stdout:t})=>{if(typeof t=="string")return t;if(qt(t))return K_(t);throw t===void 0?new TypeError(`Missing result.stdout in template expression. This is probably due to the previous subprocess' "stdout" option.`):new TypeError(`Unexpected "${typeof t}" stdout in template expression`)}});import pR from"node:process";var ei,J_,Rn,Y_,bo=y(()=>{ei=t=>J_.includes(t),J_=[pR.stdin,pR.stdout,pR.stderr],Rn=["stdin","stdout","stderr"],Y_=t=>Rn[t]??`stdio[${t}]`});import{debuglog as pbe}from"node:util";var WG,mR,mbe,hbe,gbe,ybe,VG,_be,hR,bbe,vbe,Sbe,wbe,gR,vo,So=y(()=>{yo();bo();WG=t=>{let e={...t};for(let r of gR)e[r]=mR(t,r);return e},mR=(t,e)=>{let r=Array.from({length:mbe(t)+1}),n=hbe(t[e],r,e);return vbe(n,e)},mbe=({stdio:t})=>Array.isArray(t)?Math.max(t.length,Rn.length):Rn.length,hbe=(t,e,r)=>Ot(t)?gbe(t,e,r):e.fill(t),gbe=(t,e,r)=>{for(let n of Object.keys(t).sort(ybe))for(let i of _be(n,r,e))e[i]=t[n];return e},ybe=(t,e)=>VG(t)t==="stdout"||t==="stderr"?0:t==="all"?2:1,_be=(t,e,r)=>{if(t==="ipc")return[r.length-1];let n=hR(t);if(n===void 0||n===0)throw new TypeError(`"${e}.${t}" is invalid. It must be "${e}.stdout", "${e}.stderr", "${e}.all", "${e}.ipc", or "${e}.fd3", "${e}.fd4" (and so on).`);if(n>=r.length)throw new TypeError(`"${e}.${t}" is invalid: that file descriptor does not exist. -Please set the "stdio" option to ensure that file descriptor exists.`);return n==="all"?[1,2]:[n]},hR=t=>{if(t==="all")return t;if(Tn.includes(t))return Tn.indexOf(t);let e=gbe.exec(t);if(e!==null)return Number(e[1])},gbe=/^fd(\d+)$/,ybe=(t,e)=>t.map(r=>r===void 0?bbe[e]:r),_be=ube("execa").enabled?"full":"none",bbe={lines:!1,buffer:!0,maxBuffer:1e3*1e3*100,verbose:_be,stripFinalNewline:!0},gR=["lines","buffer","maxBuffer","verbose","stripFinalNewline"],vo=(t,e)=>e==="ipc"?t.at(-1):t[e]});var $l,kl,VG,yR,vbe,X_,Q_,ls=y(()=>{So();$l=({verbose:t},e)=>yR(t,e)!=="none",kl=({verbose:t},e)=>!["none","short"].includes(yR(t,e)),VG=({verbose:t},e)=>{let r=yR(t,e);return X_(r)?r:void 0},yR=(t,e)=>e===void 0?vbe(t):vo(t,e),vbe=t=>t.find(e=>X_(e))??Q_.findLast(e=>t.includes(e)),X_=t=>typeof t=="function",Q_=["none","short","full"]});import{platform as Sbe}from"node:process";import{stripVTControlCharacters as wbe}from"node:util";var WG,Hf,KG,xbe,$be,kbe,Ebe,Abe,Tbe,Obe,eb=y(()=>{WG=(t,e)=>{let r=[t,...e],n=r.join(" "),i=r.map(o=>Tbe(KG(o))).join(" ");return{command:n,escapedCommand:i}},Hf=t=>wbe(t).split(` -`).map(e=>KG(e)).join(` -`),KG=t=>t.replaceAll(kbe,e=>xbe(e)),xbe=t=>{let e=Ebe[t];if(e!==void 0)return e;let r=t.codePointAt(0),n=r.toString(16);return r<=Abe?`\\u${n.padStart(4,"0")}`:`\\U${n}`},$be=()=>{try{return new RegExp("\\p{Separator}|\\p{Other}","gu")}catch{return/[\s\u0000-\u001F\u007F-\u009F\u00AD]/g}},kbe=$be(),Ebe={" ":" ","\b":"\\b","\f":"\\f","\n":"\\n","\r":"\\r"," ":"\\t"},Abe=65535,Tbe=t=>Obe.test(t)?t:Sbe==="win32"?`"${t.replaceAll('"','""')}"`:`'${t.replaceAll("'","'\\''")}'`,Obe=/^[\w./-]+$/});import JG from"node:process";function _R(){let{env:t}=JG,{TERM:e,TERM_PROGRAM:r}=t;return JG.platform!=="win32"?e!=="linux":!!t.WT_SESSION||!!t.TERMINUS_SUBLIME||t.ConEmuTask==="{cmd::Cmder}"||r==="Terminus-Sublime"||r==="vscode"||e==="xterm-256color"||e==="alacritty"||e==="rxvt-unicode"||e==="rxvt-unicode-256color"||t.TERMINAL_EMULATOR==="JetBrains-JediTerm"}var YG=y(()=>{});var XG,QG,Rbe,Ibe,Pbe,Cbe,Dbe,tb,SQe,eZ=y(()=>{YG();XG={circleQuestionMark:"(?)",questionMarkPrefix:"(?)",square:"\u2588",squareDarkShade:"\u2593",squareMediumShade:"\u2592",squareLightShade:"\u2591",squareTop:"\u2580",squareBottom:"\u2584",squareLeft:"\u258C",squareRight:"\u2590",squareCenter:"\u25A0",bullet:"\u25CF",dot:"\u2024",ellipsis:"\u2026",pointerSmall:"\u203A",triangleUp:"\u25B2",triangleUpSmall:"\u25B4",triangleDown:"\u25BC",triangleDownSmall:"\u25BE",triangleLeftSmall:"\u25C2",triangleRightSmall:"\u25B8",home:"\u2302",heart:"\u2665",musicNote:"\u266A",musicNoteBeamed:"\u266B",arrowUp:"\u2191",arrowDown:"\u2193",arrowLeft:"\u2190",arrowRight:"\u2192",arrowLeftRight:"\u2194",arrowUpDown:"\u2195",almostEqual:"\u2248",notEqual:"\u2260",lessOrEqual:"\u2264",greaterOrEqual:"\u2265",identical:"\u2261",infinity:"\u221E",subscriptZero:"\u2080",subscriptOne:"\u2081",subscriptTwo:"\u2082",subscriptThree:"\u2083",subscriptFour:"\u2084",subscriptFive:"\u2085",subscriptSix:"\u2086",subscriptSeven:"\u2087",subscriptEight:"\u2088",subscriptNine:"\u2089",oneHalf:"\xBD",oneThird:"\u2153",oneQuarter:"\xBC",oneFifth:"\u2155",oneSixth:"\u2159",oneEighth:"\u215B",twoThirds:"\u2154",twoFifths:"\u2156",threeQuarters:"\xBE",threeFifths:"\u2157",threeEighths:"\u215C",fourFifths:"\u2158",fiveSixths:"\u215A",fiveEighths:"\u215D",sevenEighths:"\u215E",line:"\u2500",lineBold:"\u2501",lineDouble:"\u2550",lineDashed0:"\u2504",lineDashed1:"\u2505",lineDashed2:"\u2508",lineDashed3:"\u2509",lineDashed4:"\u254C",lineDashed5:"\u254D",lineDashed6:"\u2574",lineDashed7:"\u2576",lineDashed8:"\u2578",lineDashed9:"\u257A",lineDashed10:"\u257C",lineDashed11:"\u257E",lineDashed12:"\u2212",lineDashed13:"\u2013",lineDashed14:"\u2010",lineDashed15:"\u2043",lineVertical:"\u2502",lineVerticalBold:"\u2503",lineVerticalDouble:"\u2551",lineVerticalDashed0:"\u2506",lineVerticalDashed1:"\u2507",lineVerticalDashed2:"\u250A",lineVerticalDashed3:"\u250B",lineVerticalDashed4:"\u254E",lineVerticalDashed5:"\u254F",lineVerticalDashed6:"\u2575",lineVerticalDashed7:"\u2577",lineVerticalDashed8:"\u2579",lineVerticalDashed9:"\u257B",lineVerticalDashed10:"\u257D",lineVerticalDashed11:"\u257F",lineDownLeft:"\u2510",lineDownLeftArc:"\u256E",lineDownBoldLeftBold:"\u2513",lineDownBoldLeft:"\u2512",lineDownLeftBold:"\u2511",lineDownDoubleLeftDouble:"\u2557",lineDownDoubleLeft:"\u2556",lineDownLeftDouble:"\u2555",lineDownRight:"\u250C",lineDownRightArc:"\u256D",lineDownBoldRightBold:"\u250F",lineDownBoldRight:"\u250E",lineDownRightBold:"\u250D",lineDownDoubleRightDouble:"\u2554",lineDownDoubleRight:"\u2553",lineDownRightDouble:"\u2552",lineUpLeft:"\u2518",lineUpLeftArc:"\u256F",lineUpBoldLeftBold:"\u251B",lineUpBoldLeft:"\u251A",lineUpLeftBold:"\u2519",lineUpDoubleLeftDouble:"\u255D",lineUpDoubleLeft:"\u255C",lineUpLeftDouble:"\u255B",lineUpRight:"\u2514",lineUpRightArc:"\u2570",lineUpBoldRightBold:"\u2517",lineUpBoldRight:"\u2516",lineUpRightBold:"\u2515",lineUpDoubleRightDouble:"\u255A",lineUpDoubleRight:"\u2559",lineUpRightDouble:"\u2558",lineUpDownLeft:"\u2524",lineUpBoldDownBoldLeftBold:"\u252B",lineUpBoldDownBoldLeft:"\u2528",lineUpDownLeftBold:"\u2525",lineUpBoldDownLeftBold:"\u2529",lineUpDownBoldLeftBold:"\u252A",lineUpDownBoldLeft:"\u2527",lineUpBoldDownLeft:"\u2526",lineUpDoubleDownDoubleLeftDouble:"\u2563",lineUpDoubleDownDoubleLeft:"\u2562",lineUpDownLeftDouble:"\u2561",lineUpDownRight:"\u251C",lineUpBoldDownBoldRightBold:"\u2523",lineUpBoldDownBoldRight:"\u2520",lineUpDownRightBold:"\u251D",lineUpBoldDownRightBold:"\u2521",lineUpDownBoldRightBold:"\u2522",lineUpDownBoldRight:"\u251F",lineUpBoldDownRight:"\u251E",lineUpDoubleDownDoubleRightDouble:"\u2560",lineUpDoubleDownDoubleRight:"\u255F",lineUpDownRightDouble:"\u255E",lineDownLeftRight:"\u252C",lineDownBoldLeftBoldRightBold:"\u2533",lineDownLeftBoldRightBold:"\u252F",lineDownBoldLeftRight:"\u2530",lineDownBoldLeftBoldRight:"\u2531",lineDownBoldLeftRightBold:"\u2532",lineDownLeftRightBold:"\u252E",lineDownLeftBoldRight:"\u252D",lineDownDoubleLeftDoubleRightDouble:"\u2566",lineDownDoubleLeftRight:"\u2565",lineDownLeftDoubleRightDouble:"\u2564",lineUpLeftRight:"\u2534",lineUpBoldLeftBoldRightBold:"\u253B",lineUpLeftBoldRightBold:"\u2537",lineUpBoldLeftRight:"\u2538",lineUpBoldLeftBoldRight:"\u2539",lineUpBoldLeftRightBold:"\u253A",lineUpLeftRightBold:"\u2536",lineUpLeftBoldRight:"\u2535",lineUpDoubleLeftDoubleRightDouble:"\u2569",lineUpDoubleLeftRight:"\u2568",lineUpLeftDoubleRightDouble:"\u2567",lineUpDownLeftRight:"\u253C",lineUpBoldDownBoldLeftBoldRightBold:"\u254B",lineUpDownBoldLeftBoldRightBold:"\u2548",lineUpBoldDownLeftBoldRightBold:"\u2547",lineUpBoldDownBoldLeftRightBold:"\u254A",lineUpBoldDownBoldLeftBoldRight:"\u2549",lineUpBoldDownLeftRight:"\u2540",lineUpDownBoldLeftRight:"\u2541",lineUpDownLeftBoldRight:"\u253D",lineUpDownLeftRightBold:"\u253E",lineUpBoldDownBoldLeftRight:"\u2542",lineUpDownLeftBoldRightBold:"\u253F",lineUpBoldDownLeftBoldRight:"\u2543",lineUpBoldDownLeftRightBold:"\u2544",lineUpDownBoldLeftBoldRight:"\u2545",lineUpDownBoldLeftRightBold:"\u2546",lineUpDoubleDownDoubleLeftDoubleRightDouble:"\u256C",lineUpDoubleDownDoubleLeftRight:"\u256B",lineUpDownLeftDoubleRightDouble:"\u256A",lineCross:"\u2573",lineBackslash:"\u2572",lineSlash:"\u2571"},QG={tick:"\u2714",info:"\u2139",warning:"\u26A0",cross:"\u2718",squareSmall:"\u25FB",squareSmallFilled:"\u25FC",circle:"\u25EF",circleFilled:"\u25C9",circleDotted:"\u25CC",circleDouble:"\u25CE",circleCircle:"\u24DE",circleCross:"\u24E7",circlePipe:"\u24BE",radioOn:"\u25C9",radioOff:"\u25EF",checkboxOn:"\u2612",checkboxOff:"\u2610",checkboxCircleOn:"\u24E7",checkboxCircleOff:"\u24BE",pointer:"\u276F",triangleUpOutline:"\u25B3",triangleLeft:"\u25C0",triangleRight:"\u25B6",lozenge:"\u25C6",lozengeOutline:"\u25C7",hamburger:"\u2630",smiley:"\u32E1",mustache:"\u0DF4",star:"\u2605",play:"\u25B6",nodejs:"\u2B22",oneSeventh:"\u2150",oneNinth:"\u2151",oneTenth:"\u2152"},Rbe={tick:"\u221A",info:"i",warning:"\u203C",cross:"\xD7",squareSmall:"\u25A1",squareSmallFilled:"\u25A0",circle:"( )",circleFilled:"(*)",circleDotted:"( )",circleDouble:"( )",circleCircle:"(\u25CB)",circleCross:"(\xD7)",circlePipe:"(\u2502)",radioOn:"(*)",radioOff:"( )",checkboxOn:"[\xD7]",checkboxOff:"[ ]",checkboxCircleOn:"(\xD7)",checkboxCircleOff:"( )",pointer:">",triangleUpOutline:"\u2206",triangleLeft:"\u25C4",triangleRight:"\u25BA",lozenge:"\u2666",lozengeOutline:"\u25CA",hamburger:"\u2261",smiley:"\u263A",mustache:"\u250C\u2500\u2510",star:"\u2736",play:"\u25BA",nodejs:"\u2666",oneSeventh:"1/7",oneNinth:"1/9",oneTenth:"1/10"},Ibe={...XG,...QG},Pbe={...XG,...Rbe},Cbe=_R(),Dbe=Cbe?Ibe:Pbe,tb=Dbe,SQe=Object.entries(QG)});import Nbe from"node:tty";var jbe,be,$Qe,tZ,kQe,EQe,AQe,TQe,OQe,RQe,IQe,PQe,CQe,DQe,NQe,jQe,MQe,FQe,LQe,rb,zQe,UQe,qQe,BQe,HQe,GQe,ZQe,VQe,WQe,rZ,KQe,nZ,JQe,YQe,XQe,QQe,eet,tet,ret,net,iet,oet,set,bR=y(()=>{jbe=Nbe?.WriteStream?.prototype?.hasColors?.()??!1,be=(t,e)=>{if(!jbe)return i=>i;let r=`\x1B[${t}m`,n=`\x1B[${e}m`;return i=>{let o=i+"",s=o.indexOf(n);if(s===-1)return r+o+n;let a=r,c=0,u=(e===22?n:"")+r;for(;s!==-1;)a+=o.slice(c,s)+u,c=s+n.length,s=o.indexOf(n,c);return a+=o.slice(c)+n,a}},$Qe=be(0,0),tZ=be(1,22),kQe=be(2,22),EQe=be(3,23),AQe=be(4,24),TQe=be(53,55),OQe=be(7,27),RQe=be(8,28),IQe=be(9,29),PQe=be(30,39),CQe=be(31,39),DQe=be(32,39),NQe=be(33,39),jQe=be(34,39),MQe=be(35,39),FQe=be(36,39),LQe=be(37,39),rb=be(90,39),zQe=be(40,49),UQe=be(41,49),qQe=be(42,49),BQe=be(43,49),HQe=be(44,49),GQe=be(45,49),ZQe=be(46,49),VQe=be(47,49),WQe=be(100,49),rZ=be(91,39),KQe=be(92,39),nZ=be(93,39),JQe=be(94,39),YQe=be(95,39),XQe=be(96,39),QQe=be(97,39),eet=be(101,49),tet=be(102,49),ret=be(103,49),net=be(104,49),iet=be(105,49),oet=be(106,49),set=be(107,49)});var iZ=y(()=>{bR();bR()});var aZ,Fbe,nb,oZ,Lbe,sZ,zbe,cZ=y(()=>{eZ();iZ();aZ=({type:t,message:e,timestamp:r,piped:n,commandId:i,result:{failed:o=!1}={},options:{reject:s=!0}})=>{let a=Fbe(r),c=Lbe[t]({failed:o,reject:s,piped:n}),l=zbe[t]({reject:s});return`${rb(`[${a}]`)} ${rb(`[${i}]`)} ${l(c)} ${l(e)}`},Fbe=t=>`${nb(t.getHours(),2)}:${nb(t.getMinutes(),2)}:${nb(t.getSeconds(),2)}.${nb(t.getMilliseconds(),3)}`,nb=(t,e)=>String(t).padStart(e,"0"),oZ=({failed:t,reject:e})=>t?e?tb.cross:tb.warning:tb.tick,Lbe={command:({piped:t})=>t?"|":"$",output:()=>" ",ipc:()=>"*",error:oZ,duration:oZ},sZ=t=>t,zbe={command:()=>tZ,output:()=>sZ,ipc:()=>sZ,error:({reject:t})=>t?rZ:nZ,duration:()=>rb}});var lZ,Ube,qbe,uZ=y(()=>{ls();lZ=(t,e,r)=>{let n=VG(e,r);return t.map(({verboseLine:i,verboseObject:o})=>Ube(i,o,n)).filter(i=>i!==void 0).map(i=>qbe(i)).join("")},Ube=(t,e,r)=>{if(r===void 0)return t;let n=r(t,e);if(typeof n=="string")return n},qbe=t=>t.endsWith(` +Please set the "stdio" option to ensure that file descriptor exists.`);return n==="all"?[1,2]:[n]},hR=t=>{if(t==="all")return t;if(Rn.includes(t))return Rn.indexOf(t);let e=bbe.exec(t);if(e!==null)return Number(e[1])},bbe=/^fd(\d+)$/,vbe=(t,e)=>t.map(r=>r===void 0?wbe[e]:r),Sbe=pbe("execa").enabled?"full":"none",wbe={lines:!1,buffer:!0,maxBuffer:1e3*1e3*100,verbose:Sbe,stripFinalNewline:!0},gR=["lines","buffer","maxBuffer","verbose","stripFinalNewline"],vo=(t,e)=>e==="ipc"?t.at(-1):t[e]});var $l,kl,KG,yR,xbe,X_,Q_,ls=y(()=>{So();$l=({verbose:t},e)=>yR(t,e)!=="none",kl=({verbose:t},e)=>!["none","short"].includes(yR(t,e)),KG=({verbose:t},e)=>{let r=yR(t,e);return X_(r)?r:void 0},yR=(t,e)=>e===void 0?xbe(t):vo(t,e),xbe=t=>t.find(e=>X_(e))??Q_.findLast(e=>t.includes(e)),X_=t=>typeof t=="function",Q_=["none","short","full"]});import{platform as $be}from"node:process";import{stripVTControlCharacters as kbe}from"node:util";var JG,Gf,YG,Ebe,Abe,Tbe,Obe,Rbe,Ibe,Pbe,eb=y(()=>{JG=(t,e)=>{let r=[t,...e],n=r.join(" "),i=r.map(o=>Ibe(YG(o))).join(" ");return{command:n,escapedCommand:i}},Gf=t=>kbe(t).split(` +`).map(e=>YG(e)).join(` +`),YG=t=>t.replaceAll(Tbe,e=>Ebe(e)),Ebe=t=>{let e=Obe[t];if(e!==void 0)return e;let r=t.codePointAt(0),n=r.toString(16);return r<=Rbe?`\\u${n.padStart(4,"0")}`:`\\U${n}`},Abe=()=>{try{return new RegExp("\\p{Separator}|\\p{Other}","gu")}catch{return/[\s\u0000-\u001F\u007F-\u009F\u00AD]/g}},Tbe=Abe(),Obe={" ":" ","\b":"\\b","\f":"\\f","\n":"\\n","\r":"\\r"," ":"\\t"},Rbe=65535,Ibe=t=>Pbe.test(t)?t:$be==="win32"?`"${t.replaceAll('"','""')}"`:`'${t.replaceAll("'","'\\''")}'`,Pbe=/^[\w./-]+$/});import XG from"node:process";function _R(){let{env:t}=XG,{TERM:e,TERM_PROGRAM:r}=t;return XG.platform!=="win32"?e!=="linux":!!t.WT_SESSION||!!t.TERMINUS_SUBLIME||t.ConEmuTask==="{cmd::Cmder}"||r==="Terminus-Sublime"||r==="vscode"||e==="xterm-256color"||e==="alacritty"||e==="rxvt-unicode"||e==="rxvt-unicode-256color"||t.TERMINAL_EMULATOR==="JetBrains-JediTerm"}var QG=y(()=>{});var eZ,tZ,Cbe,Dbe,Nbe,jbe,Mbe,tb,$Qe,rZ=y(()=>{QG();eZ={circleQuestionMark:"(?)",questionMarkPrefix:"(?)",square:"\u2588",squareDarkShade:"\u2593",squareMediumShade:"\u2592",squareLightShade:"\u2591",squareTop:"\u2580",squareBottom:"\u2584",squareLeft:"\u258C",squareRight:"\u2590",squareCenter:"\u25A0",bullet:"\u25CF",dot:"\u2024",ellipsis:"\u2026",pointerSmall:"\u203A",triangleUp:"\u25B2",triangleUpSmall:"\u25B4",triangleDown:"\u25BC",triangleDownSmall:"\u25BE",triangleLeftSmall:"\u25C2",triangleRightSmall:"\u25B8",home:"\u2302",heart:"\u2665",musicNote:"\u266A",musicNoteBeamed:"\u266B",arrowUp:"\u2191",arrowDown:"\u2193",arrowLeft:"\u2190",arrowRight:"\u2192",arrowLeftRight:"\u2194",arrowUpDown:"\u2195",almostEqual:"\u2248",notEqual:"\u2260",lessOrEqual:"\u2264",greaterOrEqual:"\u2265",identical:"\u2261",infinity:"\u221E",subscriptZero:"\u2080",subscriptOne:"\u2081",subscriptTwo:"\u2082",subscriptThree:"\u2083",subscriptFour:"\u2084",subscriptFive:"\u2085",subscriptSix:"\u2086",subscriptSeven:"\u2087",subscriptEight:"\u2088",subscriptNine:"\u2089",oneHalf:"\xBD",oneThird:"\u2153",oneQuarter:"\xBC",oneFifth:"\u2155",oneSixth:"\u2159",oneEighth:"\u215B",twoThirds:"\u2154",twoFifths:"\u2156",threeQuarters:"\xBE",threeFifths:"\u2157",threeEighths:"\u215C",fourFifths:"\u2158",fiveSixths:"\u215A",fiveEighths:"\u215D",sevenEighths:"\u215E",line:"\u2500",lineBold:"\u2501",lineDouble:"\u2550",lineDashed0:"\u2504",lineDashed1:"\u2505",lineDashed2:"\u2508",lineDashed3:"\u2509",lineDashed4:"\u254C",lineDashed5:"\u254D",lineDashed6:"\u2574",lineDashed7:"\u2576",lineDashed8:"\u2578",lineDashed9:"\u257A",lineDashed10:"\u257C",lineDashed11:"\u257E",lineDashed12:"\u2212",lineDashed13:"\u2013",lineDashed14:"\u2010",lineDashed15:"\u2043",lineVertical:"\u2502",lineVerticalBold:"\u2503",lineVerticalDouble:"\u2551",lineVerticalDashed0:"\u2506",lineVerticalDashed1:"\u2507",lineVerticalDashed2:"\u250A",lineVerticalDashed3:"\u250B",lineVerticalDashed4:"\u254E",lineVerticalDashed5:"\u254F",lineVerticalDashed6:"\u2575",lineVerticalDashed7:"\u2577",lineVerticalDashed8:"\u2579",lineVerticalDashed9:"\u257B",lineVerticalDashed10:"\u257D",lineVerticalDashed11:"\u257F",lineDownLeft:"\u2510",lineDownLeftArc:"\u256E",lineDownBoldLeftBold:"\u2513",lineDownBoldLeft:"\u2512",lineDownLeftBold:"\u2511",lineDownDoubleLeftDouble:"\u2557",lineDownDoubleLeft:"\u2556",lineDownLeftDouble:"\u2555",lineDownRight:"\u250C",lineDownRightArc:"\u256D",lineDownBoldRightBold:"\u250F",lineDownBoldRight:"\u250E",lineDownRightBold:"\u250D",lineDownDoubleRightDouble:"\u2554",lineDownDoubleRight:"\u2553",lineDownRightDouble:"\u2552",lineUpLeft:"\u2518",lineUpLeftArc:"\u256F",lineUpBoldLeftBold:"\u251B",lineUpBoldLeft:"\u251A",lineUpLeftBold:"\u2519",lineUpDoubleLeftDouble:"\u255D",lineUpDoubleLeft:"\u255C",lineUpLeftDouble:"\u255B",lineUpRight:"\u2514",lineUpRightArc:"\u2570",lineUpBoldRightBold:"\u2517",lineUpBoldRight:"\u2516",lineUpRightBold:"\u2515",lineUpDoubleRightDouble:"\u255A",lineUpDoubleRight:"\u2559",lineUpRightDouble:"\u2558",lineUpDownLeft:"\u2524",lineUpBoldDownBoldLeftBold:"\u252B",lineUpBoldDownBoldLeft:"\u2528",lineUpDownLeftBold:"\u2525",lineUpBoldDownLeftBold:"\u2529",lineUpDownBoldLeftBold:"\u252A",lineUpDownBoldLeft:"\u2527",lineUpBoldDownLeft:"\u2526",lineUpDoubleDownDoubleLeftDouble:"\u2563",lineUpDoubleDownDoubleLeft:"\u2562",lineUpDownLeftDouble:"\u2561",lineUpDownRight:"\u251C",lineUpBoldDownBoldRightBold:"\u2523",lineUpBoldDownBoldRight:"\u2520",lineUpDownRightBold:"\u251D",lineUpBoldDownRightBold:"\u2521",lineUpDownBoldRightBold:"\u2522",lineUpDownBoldRight:"\u251F",lineUpBoldDownRight:"\u251E",lineUpDoubleDownDoubleRightDouble:"\u2560",lineUpDoubleDownDoubleRight:"\u255F",lineUpDownRightDouble:"\u255E",lineDownLeftRight:"\u252C",lineDownBoldLeftBoldRightBold:"\u2533",lineDownLeftBoldRightBold:"\u252F",lineDownBoldLeftRight:"\u2530",lineDownBoldLeftBoldRight:"\u2531",lineDownBoldLeftRightBold:"\u2532",lineDownLeftRightBold:"\u252E",lineDownLeftBoldRight:"\u252D",lineDownDoubleLeftDoubleRightDouble:"\u2566",lineDownDoubleLeftRight:"\u2565",lineDownLeftDoubleRightDouble:"\u2564",lineUpLeftRight:"\u2534",lineUpBoldLeftBoldRightBold:"\u253B",lineUpLeftBoldRightBold:"\u2537",lineUpBoldLeftRight:"\u2538",lineUpBoldLeftBoldRight:"\u2539",lineUpBoldLeftRightBold:"\u253A",lineUpLeftRightBold:"\u2536",lineUpLeftBoldRight:"\u2535",lineUpDoubleLeftDoubleRightDouble:"\u2569",lineUpDoubleLeftRight:"\u2568",lineUpLeftDoubleRightDouble:"\u2567",lineUpDownLeftRight:"\u253C",lineUpBoldDownBoldLeftBoldRightBold:"\u254B",lineUpDownBoldLeftBoldRightBold:"\u2548",lineUpBoldDownLeftBoldRightBold:"\u2547",lineUpBoldDownBoldLeftRightBold:"\u254A",lineUpBoldDownBoldLeftBoldRight:"\u2549",lineUpBoldDownLeftRight:"\u2540",lineUpDownBoldLeftRight:"\u2541",lineUpDownLeftBoldRight:"\u253D",lineUpDownLeftRightBold:"\u253E",lineUpBoldDownBoldLeftRight:"\u2542",lineUpDownLeftBoldRightBold:"\u253F",lineUpBoldDownLeftBoldRight:"\u2543",lineUpBoldDownLeftRightBold:"\u2544",lineUpDownBoldLeftBoldRight:"\u2545",lineUpDownBoldLeftRightBold:"\u2546",lineUpDoubleDownDoubleLeftDoubleRightDouble:"\u256C",lineUpDoubleDownDoubleLeftRight:"\u256B",lineUpDownLeftDoubleRightDouble:"\u256A",lineCross:"\u2573",lineBackslash:"\u2572",lineSlash:"\u2571"},tZ={tick:"\u2714",info:"\u2139",warning:"\u26A0",cross:"\u2718",squareSmall:"\u25FB",squareSmallFilled:"\u25FC",circle:"\u25EF",circleFilled:"\u25C9",circleDotted:"\u25CC",circleDouble:"\u25CE",circleCircle:"\u24DE",circleCross:"\u24E7",circlePipe:"\u24BE",radioOn:"\u25C9",radioOff:"\u25EF",checkboxOn:"\u2612",checkboxOff:"\u2610",checkboxCircleOn:"\u24E7",checkboxCircleOff:"\u24BE",pointer:"\u276F",triangleUpOutline:"\u25B3",triangleLeft:"\u25C0",triangleRight:"\u25B6",lozenge:"\u25C6",lozengeOutline:"\u25C7",hamburger:"\u2630",smiley:"\u32E1",mustache:"\u0DF4",star:"\u2605",play:"\u25B6",nodejs:"\u2B22",oneSeventh:"\u2150",oneNinth:"\u2151",oneTenth:"\u2152"},Cbe={tick:"\u221A",info:"i",warning:"\u203C",cross:"\xD7",squareSmall:"\u25A1",squareSmallFilled:"\u25A0",circle:"( )",circleFilled:"(*)",circleDotted:"( )",circleDouble:"( )",circleCircle:"(\u25CB)",circleCross:"(\xD7)",circlePipe:"(\u2502)",radioOn:"(*)",radioOff:"( )",checkboxOn:"[\xD7]",checkboxOff:"[ ]",checkboxCircleOn:"(\xD7)",checkboxCircleOff:"( )",pointer:">",triangleUpOutline:"\u2206",triangleLeft:"\u25C4",triangleRight:"\u25BA",lozenge:"\u2666",lozengeOutline:"\u25CA",hamburger:"\u2261",smiley:"\u263A",mustache:"\u250C\u2500\u2510",star:"\u2736",play:"\u25BA",nodejs:"\u2666",oneSeventh:"1/7",oneNinth:"1/9",oneTenth:"1/10"},Dbe={...eZ,...tZ},Nbe={...eZ,...Cbe},jbe=_R(),Mbe=jbe?Dbe:Nbe,tb=Mbe,$Qe=Object.entries(tZ)});import Fbe from"node:tty";var Lbe,be,AQe,nZ,TQe,OQe,RQe,IQe,PQe,CQe,DQe,NQe,jQe,MQe,FQe,LQe,zQe,UQe,qQe,rb,BQe,HQe,GQe,ZQe,VQe,WQe,KQe,JQe,YQe,iZ,XQe,oZ,QQe,eet,tet,ret,net,iet,oet,set,aet,cet,uet,bR=y(()=>{Lbe=Fbe?.WriteStream?.prototype?.hasColors?.()??!1,be=(t,e)=>{if(!Lbe)return i=>i;let r=`\x1B[${t}m`,n=`\x1B[${e}m`;return i=>{let o=i+"",s=o.indexOf(n);if(s===-1)return r+o+n;let a=r,c=0,u=(e===22?n:"")+r;for(;s!==-1;)a+=o.slice(c,s)+u,c=s+n.length,s=o.indexOf(n,c);return a+=o.slice(c)+n,a}},AQe=be(0,0),nZ=be(1,22),TQe=be(2,22),OQe=be(3,23),RQe=be(4,24),IQe=be(53,55),PQe=be(7,27),CQe=be(8,28),DQe=be(9,29),NQe=be(30,39),jQe=be(31,39),MQe=be(32,39),FQe=be(33,39),LQe=be(34,39),zQe=be(35,39),UQe=be(36,39),qQe=be(37,39),rb=be(90,39),BQe=be(40,49),HQe=be(41,49),GQe=be(42,49),ZQe=be(43,49),VQe=be(44,49),WQe=be(45,49),KQe=be(46,49),JQe=be(47,49),YQe=be(100,49),iZ=be(91,39),XQe=be(92,39),oZ=be(93,39),QQe=be(94,39),eet=be(95,39),tet=be(96,39),ret=be(97,39),net=be(101,49),iet=be(102,49),oet=be(103,49),set=be(104,49),aet=be(105,49),cet=be(106,49),uet=be(107,49)});var sZ=y(()=>{bR();bR()});var lZ,Ube,nb,aZ,qbe,cZ,Bbe,uZ=y(()=>{rZ();sZ();lZ=({type:t,message:e,timestamp:r,piped:n,commandId:i,result:{failed:o=!1}={},options:{reject:s=!0}})=>{let a=Ube(r),c=qbe[t]({failed:o,reject:s,piped:n}),l=Bbe[t]({reject:s});return`${rb(`[${a}]`)} ${rb(`[${i}]`)} ${l(c)} ${l(e)}`},Ube=t=>`${nb(t.getHours(),2)}:${nb(t.getMinutes(),2)}:${nb(t.getSeconds(),2)}.${nb(t.getMilliseconds(),3)}`,nb=(t,e)=>String(t).padStart(e,"0"),aZ=({failed:t,reject:e})=>t?e?tb.cross:tb.warning:tb.tick,qbe={command:({piped:t})=>t?"|":"$",output:()=>" ",ipc:()=>"*",error:aZ,duration:aZ},cZ=t=>t,Bbe={command:()=>nZ,output:()=>cZ,ipc:()=>cZ,error:({reject:t})=>t?iZ:oZ,duration:()=>rb}});var dZ,Hbe,Gbe,fZ=y(()=>{ls();dZ=(t,e,r)=>{let n=KG(e,r);return t.map(({verboseLine:i,verboseObject:o})=>Hbe(i,o,n)).filter(i=>i!==void 0).map(i=>Gbe(i)).join("")},Hbe=(t,e,r)=>{if(r===void 0)return t;let n=r(t,e);if(typeof n=="string")return n},Gbe=t=>t.endsWith(` `)?t:`${t} -`});import{inspect as Bbe}from"node:util";var Pi,Hbe,Gbe,Zbe,ib,Vbe,El=y(()=>{eb();cZ();uZ();Pi=({type:t,verboseMessage:e,fdNumber:r,verboseInfo:n,result:i})=>{let o=Hbe({type:t,result:i,verboseInfo:n}),s=Gbe(e,o),a=lZ(s,n,r);a!==""&&console.warn(a.slice(0,-1))},Hbe=({type:t,result:e,verboseInfo:{escapedCommand:r,commandId:n,rawOptions:{piped:i=!1,...o}}})=>({type:t,escapedCommand:r,commandId:`${n}`,timestamp:new Date,piped:i,result:e,options:o}),Gbe=(t,e)=>t.split(` -`).map(r=>Zbe({...e,message:r})),Zbe=t=>({verboseLine:aZ(t),verboseObject:t}),ib=t=>{let e=typeof t=="string"?t:Bbe(t);return Hf(e).replaceAll(" "," ".repeat(Vbe))},Vbe=2});var dZ,fZ=y(()=>{ls();El();dZ=(t,e)=>{$l(e)&&Pi({type:"command",verboseMessage:t,verboseInfo:e})}});var pZ,Wbe,Kbe,Jbe,mZ=y(()=>{ls();pZ=(t,e,r)=>{Jbe(t);let n=Wbe(t);return{verbose:t,escapedCommand:e,commandId:n,rawOptions:r}},Wbe=t=>$l({verbose:t})?Kbe++:void 0,Kbe=0n,Jbe=t=>{for(let e of t){if(e===!1)throw new TypeError(`The "verbose: false" option was renamed to "verbose: 'none'".`);if(e===!0)throw new TypeError(`The "verbose: true" option was renamed to "verbose: 'short'".`);if(!Q_.includes(e)&&!X_(e)){let r=Q_.map(n=>`'${n}'`).join(", ");throw new TypeError(`The "verbose" option must not be ${e}. Allowed values are: ${r} or a function.`)}}}});import{hrtime as hZ}from"node:process";var ob,vR,sb=y(()=>{ob=()=>hZ.bigint(),vR=t=>Number(hZ.bigint()-t)/1e6});var ab,SR=y(()=>{fZ();mZ();sb();eb();So();ab=(t,e,r)=>{let n=ob(),{command:i,escapedCommand:o}=WG(t,e),s=mR(r,"verbose"),a=pZ(s,o,{...r});return dZ(o,a),{command:i,escapedCommand:o,startTime:n,verboseInfo:a}}});var vZ=v((Det,bZ)=>{bZ.exports=_Z;_Z.sync=Xbe;var gZ=Ge("fs");function Ybe(t,e){var r=e.pathExt!==void 0?e.pathExt:process.env.PATHEXT;if(!r||(r=r.split(";"),r.indexOf("")!==-1))return!0;for(var n=0;n{$Z.exports=wZ;wZ.sync=Qbe;var SZ=Ge("fs");function wZ(t,e,r){SZ.stat(t,function(n,i){r(n,n?!1:xZ(i,e))})}function Qbe(t,e){return xZ(SZ.statSync(t),e)}function xZ(t,e){return t.isFile()&&eve(t,e)}function eve(t,e){var r=t.mode,n=t.uid,i=t.gid,o=e.uid!==void 0?e.uid:process.getuid&&process.getuid(),s=e.gid!==void 0?e.gid:process.getgid&&process.getgid(),a=parseInt("100",8),c=parseInt("010",8),l=parseInt("001",8),u=a|c,d=r&l||r&c&&i===s||r&a&&n===o||r&u&&o===0;return d}});var AZ=v((Met,EZ)=>{var jet=Ge("fs"),cb;process.platform==="win32"||global.TESTING_WINDOWS?cb=vZ():cb=kZ();EZ.exports=wR;wR.sync=tve;function wR(t,e,r){if(typeof e=="function"&&(r=e,e={}),!r){if(typeof Promise!="function")throw new TypeError("callback not provided");return new Promise(function(n,i){wR(t,e||{},function(o,s){o?i(o):n(s)})})}cb(t,e||{},function(n,i){n&&(n.code==="EACCES"||e&&e.ignoreErrors)&&(n=null,i=!1),r(n,i)})}function tve(t,e){try{return cb.sync(t,e||{})}catch(r){if(e&&e.ignoreErrors||r.code==="EACCES")return!1;throw r}}});var DZ=v((Fet,CZ)=>{var Al=process.platform==="win32"||process.env.OSTYPE==="cygwin"||process.env.OSTYPE==="msys",TZ=Ge("path"),rve=Al?";":":",OZ=AZ(),RZ=t=>Object.assign(new Error(`not found: ${t}`),{code:"ENOENT"}),IZ=(t,e)=>{let r=e.colon||rve,n=t.match(/\//)||Al&&t.match(/\\/)?[""]:[...Al?[process.cwd()]:[],...(e.path||process.env.PATH||"").split(r)],i=Al?e.pathExt||process.env.PATHEXT||".EXE;.CMD;.BAT;.COM":"",o=Al?i.split(r):[""];return Al&&t.indexOf(".")!==-1&&o[0]!==""&&o.unshift(""),{pathEnv:n,pathExt:o,pathExtExe:i}},PZ=(t,e,r)=>{typeof e=="function"&&(r=e,e={}),e||(e={});let{pathEnv:n,pathExt:i,pathExtExe:o}=IZ(t,e),s=[],a=l=>new Promise((u,d)=>{if(l===n.length)return e.all&&s.length?u(s):d(RZ(t));let f=n[l],p=/^".*"$/.test(f)?f.slice(1,-1):f,m=TZ.join(p,t),h=!p&&/^\.[\\\/]/.test(t)?t.slice(0,2)+m:m;u(c(h,l,0))}),c=(l,u,d)=>new Promise((f,p)=>{if(d===i.length)return f(a(u+1));let m=i[d];OZ(l+m,{pathExt:o},(h,g)=>{if(!h&&g)if(e.all)s.push(l+m);else return f(l+m);return f(c(l,u,d+1))})});return r?a(0).then(l=>r(null,l),r):a(0)},nve=(t,e)=>{e=e||{};let{pathEnv:r,pathExt:n,pathExtExe:i}=IZ(t,e),o=[];for(let s=0;s{"use strict";var NZ=(t={})=>{let e=t.env||process.env;return(t.platform||process.platform)!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"};xR.exports=NZ;xR.exports.default=NZ});var zZ=v((zet,LZ)=>{"use strict";var MZ=Ge("path"),ive=DZ(),ove=jZ();function FZ(t,e){let r=t.options.env||process.env,n=process.cwd(),i=t.options.cwd!=null,o=i&&process.chdir!==void 0&&!process.chdir.disabled;if(o)try{process.chdir(t.options.cwd)}catch{}let s;try{s=ive.sync(t.command,{path:r[ove({env:r})],pathExt:e?MZ.delimiter:void 0})}catch{}finally{o&&process.chdir(n)}return s&&(s=MZ.resolve(i?t.options.cwd:"",s)),s}function sve(t){return FZ(t)||FZ(t,!0)}LZ.exports=sve});var UZ=v((Uet,kR)=>{"use strict";var $R=/([()\][%!^"`<>&|;, *?])/g;function ave(t){return t=t.replace($R,"^$1"),t}function cve(t,e){return t=`${t}`,t=t.replace(/(?=(\\+?)?)\1"/g,'$1$1\\"'),t=t.replace(/(?=(\\+?)?)\1$/,"$1$1"),t=`"${t}"`,t=t.replace($R,"^$1"),e&&(t=t.replace($R,"^$1")),t}kR.exports.command=ave;kR.exports.argument=cve});var BZ=v((qet,qZ)=>{"use strict";qZ.exports=/^#!(.*)/});var GZ=v((Bet,HZ)=>{"use strict";var lve=BZ();HZ.exports=(t="")=>{let e=t.match(lve);if(!e)return null;let[r,n]=e[0].replace(/#! ?/,"").split(" "),i=r.split("/").pop();return i==="env"?n:n?`${i} ${n}`:i}});var VZ=v((Het,ZZ)=>{"use strict";var ER=Ge("fs"),uve=GZ();function dve(t){let r=Buffer.alloc(150),n;try{n=ER.openSync(t,"r"),ER.readSync(n,r,0,150,0),ER.closeSync(n)}catch{}return uve(r.toString())}ZZ.exports=dve});var YZ=v((Get,JZ)=>{"use strict";var fve=Ge("path"),WZ=zZ(),KZ=UZ(),pve=VZ(),mve=process.platform==="win32",hve=/\.(?:com|exe)$/i,gve=/node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;function yve(t){t.file=WZ(t);let e=t.file&&pve(t.file);return e?(t.args.unshift(t.file),t.command=e,WZ(t)):t.file}function _ve(t){if(!mve)return t;let e=yve(t),r=!hve.test(e);if(t.options.forceShell||r){let n=gve.test(e);t.command=fve.normalize(t.command),t.command=KZ.command(t.command),t.args=t.args.map(o=>KZ.argument(o,n));let i=[t.command].concat(t.args).join(" ");t.args=["/d","/s","/c",`"${i}"`],t.command=process.env.comspec||"cmd.exe",t.options.windowsVerbatimArguments=!0}return t}function bve(t,e,r){e&&!Array.isArray(e)&&(r=e,e=null),e=e?e.slice(0):[],r=Object.assign({},r);let n={command:t,args:e,options:r,file:void 0,original:{command:t,args:e}};return r.shell?n:_ve(n)}JZ.exports=bve});var e9=v((Zet,QZ)=>{"use strict";var AR=process.platform==="win32";function TR(t,e){return Object.assign(new Error(`${e} ${t.command} ENOENT`),{code:"ENOENT",errno:"ENOENT",syscall:`${e} ${t.command}`,path:t.command,spawnargs:t.args})}function vve(t,e){if(!AR)return;let r=t.emit;t.emit=function(n,i){if(n==="exit"){let o=XZ(i,e);if(o)return r.call(t,"error",o)}return r.apply(t,arguments)}}function XZ(t,e){return AR&&t===1&&!e.file?TR(e.original,"spawn"):null}function Sve(t,e){return AR&&t===1&&!e.file?TR(e.original,"spawnSync"):null}QZ.exports={hookChildProcess:vve,verifyENOENT:XZ,verifyENOENTSync:Sve,notFoundError:TR}});var n9=v((Vet,Tl)=>{"use strict";var t9=Ge("child_process"),OR=YZ(),RR=e9();function r9(t,e,r){let n=OR(t,e,r),i=t9.spawn(n.command,n.args,n.options);return RR.hookChildProcess(i,n),i}function wve(t,e,r){let n=OR(t,e,r),i=t9.spawnSync(n.command,n.args,n.options);return i.error=i.error||RR.verifyENOENTSync(i.status,n),i}Tl.exports=r9;Tl.exports.spawn=r9;Tl.exports.sync=wve;Tl.exports._parse=OR;Tl.exports._enoent=RR});function lb(t={}){let{env:e=process.env,platform:r=process.platform}=t;return r!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"}var i9=y(()=>{});var o9=y(()=>{});import{promisify as xve}from"node:util";import{execFile as $ve,execFileSync as Xet}from"node:child_process";import s9 from"node:path";import{fileURLToPath as kve}from"node:url";function ub(t){return t instanceof URL?kve(t):t}function a9(t){return{*[Symbol.iterator](){let e=s9.resolve(ub(t)),r;for(;r!==e;)yield e,r=e,e=s9.resolve(e,"..")}}}var ttt,rtt,c9=y(()=>{o9();ttt=xve($ve);rtt=10*1024*1024});import db from"node:process";import Oa from"node:path";var Eve,Ave,Tve,l9,u9=y(()=>{i9();c9();Eve=({cwd:t=db.cwd(),path:e=db.env[lb()],preferLocal:r=!0,execPath:n=db.execPath,addExecPath:i=!0}={})=>{let o=Oa.resolve(ub(t)),s=[],a=e.split(Oa.delimiter);return r&&Ave(s,a,o),i&&Tve(s,a,n,o),e===""||e===Oa.delimiter?`${s.join(Oa.delimiter)}${e}`:[...s,e].join(Oa.delimiter)},Ave=(t,e,r)=>{for(let n of a9(r)){let i=Oa.join(n,"node_modules/.bin");e.includes(i)||t.push(i)}},Tve=(t,e,r,n)=>{let i=Oa.resolve(n,ub(r),"..");e.includes(i)||t.push(i)},l9=({env:t=db.env,...e}={})=>{t={...t};let r=lb({env:t});return e.path=t[r],t[r]=Eve(e),t}});var d9,ei,f9,p9,m9,fb,Gf,Zf,Ra=y(()=>{d9=(t,e,r)=>{let n=r?Zf:Gf,i=t instanceof ei?{}:{cause:t};return new n(e,i)},ei=class extends Error{},f9=(t,e)=>{Object.defineProperty(t.prototype,"name",{value:e,writable:!0,enumerable:!1,configurable:!0}),Object.defineProperty(t.prototype,m9,{value:!0,writable:!1,enumerable:!1,configurable:!1})},p9=t=>fb(t)&&m9 in t,m9=Symbol("isExecaError"),fb=t=>Object.prototype.toString.call(t)==="[object Error]",Gf=class extends Error{};f9(Gf,Gf.name);Zf=class extends Error{};f9(Zf,Zf.name)});var h9,Ove,g9,y9,_9=y(()=>{h9=()=>{let t=y9-g9+1;return Array.from({length:t},Ove)},Ove=(t,e)=>({name:`SIGRT${e+1}`,number:g9+e,action:"terminate",description:"Application-specific signal (realtime)",standard:"posix"}),g9=34,y9=64});var b9,v9=y(()=>{b9=[{name:"SIGHUP",number:1,action:"terminate",description:"Terminal closed",standard:"posix"},{name:"SIGINT",number:2,action:"terminate",description:"User interruption with CTRL-C",standard:"ansi"},{name:"SIGQUIT",number:3,action:"core",description:"User interruption with CTRL-\\",standard:"posix"},{name:"SIGILL",number:4,action:"core",description:"Invalid machine instruction",standard:"ansi"},{name:"SIGTRAP",number:5,action:"core",description:"Debugger breakpoint",standard:"posix"},{name:"SIGABRT",number:6,action:"core",description:"Aborted",standard:"ansi"},{name:"SIGIOT",number:6,action:"core",description:"Aborted",standard:"bsd"},{name:"SIGBUS",number:7,action:"core",description:"Bus error due to misaligned, non-existing address or paging error",standard:"bsd"},{name:"SIGEMT",number:7,action:"terminate",description:"Command should be emulated but is not implemented",standard:"other"},{name:"SIGFPE",number:8,action:"core",description:"Floating point arithmetic error",standard:"ansi"},{name:"SIGKILL",number:9,action:"terminate",description:"Forced termination",standard:"posix",forced:!0},{name:"SIGUSR1",number:10,action:"terminate",description:"Application-specific signal",standard:"posix"},{name:"SIGSEGV",number:11,action:"core",description:"Segmentation fault",standard:"ansi"},{name:"SIGUSR2",number:12,action:"terminate",description:"Application-specific signal",standard:"posix"},{name:"SIGPIPE",number:13,action:"terminate",description:"Broken pipe or socket",standard:"posix"},{name:"SIGALRM",number:14,action:"terminate",description:"Timeout or timer",standard:"posix"},{name:"SIGTERM",number:15,action:"terminate",description:"Termination",standard:"ansi"},{name:"SIGSTKFLT",number:16,action:"terminate",description:"Stack is empty or overflowed",standard:"other"},{name:"SIGCHLD",number:17,action:"ignore",description:"Child process terminated, paused or unpaused",standard:"posix"},{name:"SIGCLD",number:17,action:"ignore",description:"Child process terminated, paused or unpaused",standard:"other"},{name:"SIGCONT",number:18,action:"unpause",description:"Unpaused",standard:"posix",forced:!0},{name:"SIGSTOP",number:19,action:"pause",description:"Paused",standard:"posix",forced:!0},{name:"SIGTSTP",number:20,action:"pause",description:'Paused using CTRL-Z or "suspend"',standard:"posix"},{name:"SIGTTIN",number:21,action:"pause",description:"Background process cannot read terminal input",standard:"posix"},{name:"SIGBREAK",number:21,action:"terminate",description:"User interruption with CTRL-BREAK",standard:"other"},{name:"SIGTTOU",number:22,action:"pause",description:"Background process cannot write to terminal output",standard:"posix"},{name:"SIGURG",number:23,action:"ignore",description:"Socket received out-of-band data",standard:"bsd"},{name:"SIGXCPU",number:24,action:"core",description:"Process timed out",standard:"bsd"},{name:"SIGXFSZ",number:25,action:"core",description:"File too big",standard:"bsd"},{name:"SIGVTALRM",number:26,action:"terminate",description:"Timeout or timer",standard:"bsd"},{name:"SIGPROF",number:27,action:"terminate",description:"Timeout or timer",standard:"bsd"},{name:"SIGWINCH",number:28,action:"ignore",description:"Terminal window size changed",standard:"bsd"},{name:"SIGIO",number:29,action:"terminate",description:"I/O is available",standard:"other"},{name:"SIGPOLL",number:29,action:"terminate",description:"Watched event",standard:"other"},{name:"SIGINFO",number:29,action:"ignore",description:"Request for process information",standard:"other"},{name:"SIGPWR",number:30,action:"terminate",description:"Device running out of power",standard:"systemv"},{name:"SIGSYS",number:31,action:"core",description:"Invalid system call",standard:"other"},{name:"SIGUNUSED",number:31,action:"terminate",description:"Invalid system call",standard:"other"}]});import{constants as Rve}from"node:os";var IR,Ive,S9=y(()=>{v9();_9();IR=()=>{let t=h9();return[...b9,...t].map(Ive)},Ive=({name:t,number:e,description:r,action:n,forced:i=!1,standard:o})=>{let{signals:{[t]:s}}=Rve,a=s!==void 0;return{name:t,number:a?s:e,description:r,supported:a,action:n,forced:i,standard:o}}});import{constants as Pve}from"node:os";var Cve,Dve,w9,Nve,jve,Mve,btt,x9=y(()=>{S9();Cve=()=>{let t=IR();return Object.fromEntries(t.map(Dve))},Dve=({name:t,number:e,description:r,supported:n,action:i,forced:o,standard:s})=>[t,{name:t,number:e,description:r,supported:n,action:i,forced:o,standard:s}],w9=Cve(),Nve=()=>{let t=IR(),e=65,r=Array.from({length:e},(n,i)=>jve(i,t));return Object.assign({},...r)},jve=(t,e)=>{let r=Mve(t,e);if(r===void 0)return{};let{name:n,description:i,supported:o,action:s,forced:a,standard:c}=r;return{[t]:{name:n,number:t,description:i,supported:o,action:s,forced:a,standard:c}}},Mve=(t,e)=>{let r=e.find(({name:n})=>Pve.signals[n]===t);return r!==void 0?r:e.find(n=>n.number===t)},btt=Nve()});import{constants as Vf}from"node:os";var k9,E9,A9,Fve,Lve,$9,zve,PR,Uve,qve,pb,Wf=y(()=>{x9();k9=t=>{let e="option `killSignal`";if(t===0)throw new TypeError(`Invalid ${e}: 0 cannot be used.`);return A9(t,e)},E9=t=>t===0?t:A9(t,"`subprocess.kill()`'s argument"),A9=(t,e)=>{if(Number.isInteger(t))return Fve(t,e);if(typeof t=="string")return zve(t,e);throw new TypeError(`Invalid ${e} ${String(t)}: it must be a string or an integer. -${PR()}`)},Fve=(t,e)=>{if($9.has(t))return $9.get(t);throw new TypeError(`Invalid ${e} ${t}: this signal integer does not exist. -${PR()}`)},Lve=()=>new Map(Object.entries(Vf.signals).reverse().map(([t,e])=>[e,t])),$9=Lve(),zve=(t,e)=>{if(t in Vf.signals)return t;throw t.toUpperCase()in Vf.signals?new TypeError(`Invalid ${e} '${t}': please rename it to '${t.toUpperCase()}'.`):new TypeError(`Invalid ${e} '${t}': this signal name does not exist. -${PR()}`)},PR=()=>`Available signal names: ${Uve()}. -Available signal numbers: ${qve()}.`,Uve=()=>Object.keys(Vf.signals).sort().map(t=>`'${t}'`).join(", "),qve=()=>[...new Set(Object.values(Vf.signals).sort((t,e)=>t-e))].join(", "),pb=t=>w9[t].description});import{setTimeout as Bve}from"node:timers/promises";var T9,Hve,O9,Gve,Zve,Vve,CR,mb=y(()=>{Ra();Wf();T9=t=>{if(t===!1)return t;if(t===!0)return Hve;if(!Number.isFinite(t)||t<0)throw new TypeError(`Expected the \`forceKillAfterDelay\` option to be a non-negative integer, got \`${t}\` (${typeof t})`);return t},Hve=1e3*5,O9=({kill:t,options:{forceKillAfterDelay:e,killSignal:r},onInternalError:n,context:i,controller:o},s,a)=>{let{signal:c,error:l}=Gve(s,a,r);Zve(l,n);let u=t(c);return Vve({kill:t,signal:c,forceKillAfterDelay:e,killSignal:r,killResult:u,context:i,controller:o}),u},Gve=(t,e,r)=>{let[n=r,i]=fb(t)?[void 0,t]:[t,e];if(typeof n!="string"&&!Number.isInteger(n))throw new TypeError(`The first argument must be an error instance or a signal name string/integer: ${String(n)}`);if(i!==void 0&&!fb(i))throw new TypeError(`The second argument is optional. If specified, it must be an error instance: ${i}`);return{signal:E9(n),error:i}},Zve=(t,e)=>{t!==void 0&&e.reject(t)},Vve=async({kill:t,signal:e,forceKillAfterDelay:r,killSignal:n,killResult:i,context:o,controller:s})=>{e===n&&i&&CR({kill:t,forceKillAfterDelay:r,context:o,controllerSignal:s.signal})},CR=async({kill:t,forceKillAfterDelay:e,context:r,controllerSignal:n})=>{if(e!==!1)try{await Bve(e,void 0,{signal:n}),t("SIGKILL")&&(r.isForcefullyTerminated??=!0)}catch{}}});import{once as Wve}from"node:events";var hb,DR=y(()=>{hb=async(t,e)=>{t.aborted||await Wve(t,"abort",{signal:e})}});var R9,I9,Kve,NR=y(()=>{DR();R9=({cancelSignal:t})=>{if(t!==void 0&&Object.prototype.toString.call(t)!=="[object AbortSignal]")throw new Error(`The \`cancelSignal\` option must be an AbortSignal: ${String(t)}`)},I9=({subprocess:t,cancelSignal:e,gracefulCancel:r,context:n,controller:i})=>e===void 0||r?[]:[Kve(t,e,n,i)],Kve=async(t,e,r,{signal:n})=>{throw await hb(e,n),r.terminationReason??="cancel",t.kill(),e.reason}});var Ol,Jve,jR,P9,C9,gb,D9,N9,j9,M9,F9,L9,Yve,Xve,Qve,ti,eSe,us,Rl,Il=y(()=>{Ol=({methodName:t,isSubprocess:e,ipc:r,isConnected:n})=>{Jve(t,e,r),jR(t,e,n)},Jve=(t,e,r)=>{if(!r)throw new Error(`${ti(t,e)} can only be used if the \`ipc\` option is \`true\`.`)},jR=(t,e,r)=>{if(!r)throw new Error(`${ti(t,e)} cannot be used: the ${us(e)} has already exited or disconnected.`)},P9=t=>{throw new Error(`${ti("getOneMessage",t)} could not complete: the ${us(t)} exited or disconnected.`)},C9=t=>{throw new Error(`${ti("sendMessage",t)} failed: the ${us(t)} is sending a message too, instead of listening to incoming messages. +`});import{inspect as Zbe}from"node:util";var Pi,Vbe,Wbe,Kbe,ib,Jbe,El=y(()=>{eb();uZ();fZ();Pi=({type:t,verboseMessage:e,fdNumber:r,verboseInfo:n,result:i})=>{let o=Vbe({type:t,result:i,verboseInfo:n}),s=Wbe(e,o),a=dZ(s,n,r);a!==""&&console.warn(a.slice(0,-1))},Vbe=({type:t,result:e,verboseInfo:{escapedCommand:r,commandId:n,rawOptions:{piped:i=!1,...o}}})=>({type:t,escapedCommand:r,commandId:`${n}`,timestamp:new Date,piped:i,result:e,options:o}),Wbe=(t,e)=>t.split(` +`).map(r=>Kbe({...e,message:r})),Kbe=t=>({verboseLine:lZ(t),verboseObject:t}),ib=t=>{let e=typeof t=="string"?t:Zbe(t);return Gf(e).replaceAll(" "," ".repeat(Jbe))},Jbe=2});var pZ,mZ=y(()=>{ls();El();pZ=(t,e)=>{$l(e)&&Pi({type:"command",verboseMessage:t,verboseInfo:e})}});var hZ,Ybe,Xbe,Qbe,gZ=y(()=>{ls();hZ=(t,e,r)=>{Qbe(t);let n=Ybe(t);return{verbose:t,escapedCommand:e,commandId:n,rawOptions:r}},Ybe=t=>$l({verbose:t})?Xbe++:void 0,Xbe=0n,Qbe=t=>{for(let e of t){if(e===!1)throw new TypeError(`The "verbose: false" option was renamed to "verbose: 'none'".`);if(e===!0)throw new TypeError(`The "verbose: true" option was renamed to "verbose: 'short'".`);if(!Q_.includes(e)&&!X_(e)){let r=Q_.map(n=>`'${n}'`).join(", ");throw new TypeError(`The "verbose" option must not be ${e}. Allowed values are: ${r} or a function.`)}}}});import{hrtime as yZ}from"node:process";var ob,vR,sb=y(()=>{ob=()=>yZ.bigint(),vR=t=>Number(yZ.bigint()-t)/1e6});var ab,SR=y(()=>{mZ();gZ();sb();eb();So();ab=(t,e,r)=>{let n=ob(),{command:i,escapedCommand:o}=JG(t,e),s=mR(r,"verbose"),a=hZ(s,o,{...r});return pZ(o,a),{command:i,escapedCommand:o,startTime:n,verboseInfo:a}}});var wZ=v((Met,SZ)=>{SZ.exports=vZ;vZ.sync=tve;var _Z=Ge("fs");function eve(t,e){var r=e.pathExt!==void 0?e.pathExt:process.env.PATHEXT;if(!r||(r=r.split(";"),r.indexOf("")!==-1))return!0;for(var n=0;n{EZ.exports=$Z;$Z.sync=rve;var xZ=Ge("fs");function $Z(t,e,r){xZ.stat(t,function(n,i){r(n,n?!1:kZ(i,e))})}function rve(t,e){return kZ(xZ.statSync(t),e)}function kZ(t,e){return t.isFile()&&nve(t,e)}function nve(t,e){var r=t.mode,n=t.uid,i=t.gid,o=e.uid!==void 0?e.uid:process.getuid&&process.getuid(),s=e.gid!==void 0?e.gid:process.getgid&&process.getgid(),a=parseInt("100",8),c=parseInt("010",8),l=parseInt("001",8),u=a|c,d=r&l||r&c&&i===s||r&a&&n===o||r&u&&o===0;return d}});var OZ=v((zet,TZ)=>{var Let=Ge("fs"),cb;process.platform==="win32"||global.TESTING_WINDOWS?cb=wZ():cb=AZ();TZ.exports=wR;wR.sync=ive;function wR(t,e,r){if(typeof e=="function"&&(r=e,e={}),!r){if(typeof Promise!="function")throw new TypeError("callback not provided");return new Promise(function(n,i){wR(t,e||{},function(o,s){o?i(o):n(s)})})}cb(t,e||{},function(n,i){n&&(n.code==="EACCES"||e&&e.ignoreErrors)&&(n=null,i=!1),r(n,i)})}function ive(t,e){try{return cb.sync(t,e||{})}catch(r){if(e&&e.ignoreErrors||r.code==="EACCES")return!1;throw r}}});var jZ=v((Uet,NZ)=>{var Al=process.platform==="win32"||process.env.OSTYPE==="cygwin"||process.env.OSTYPE==="msys",RZ=Ge("path"),ove=Al?";":":",IZ=OZ(),PZ=t=>Object.assign(new Error(`not found: ${t}`),{code:"ENOENT"}),CZ=(t,e)=>{let r=e.colon||ove,n=t.match(/\//)||Al&&t.match(/\\/)?[""]:[...Al?[process.cwd()]:[],...(e.path||process.env.PATH||"").split(r)],i=Al?e.pathExt||process.env.PATHEXT||".EXE;.CMD;.BAT;.COM":"",o=Al?i.split(r):[""];return Al&&t.indexOf(".")!==-1&&o[0]!==""&&o.unshift(""),{pathEnv:n,pathExt:o,pathExtExe:i}},DZ=(t,e,r)=>{typeof e=="function"&&(r=e,e={}),e||(e={});let{pathEnv:n,pathExt:i,pathExtExe:o}=CZ(t,e),s=[],a=l=>new Promise((u,d)=>{if(l===n.length)return e.all&&s.length?u(s):d(PZ(t));let f=n[l],p=/^".*"$/.test(f)?f.slice(1,-1):f,m=RZ.join(p,t),h=!p&&/^\.[\\\/]/.test(t)?t.slice(0,2)+m:m;u(c(h,l,0))}),c=(l,u,d)=>new Promise((f,p)=>{if(d===i.length)return f(a(u+1));let m=i[d];IZ(l+m,{pathExt:o},(h,g)=>{if(!h&&g)if(e.all)s.push(l+m);else return f(l+m);return f(c(l,u,d+1))})});return r?a(0).then(l=>r(null,l),r):a(0)},sve=(t,e)=>{e=e||{};let{pathEnv:r,pathExt:n,pathExtExe:i}=CZ(t,e),o=[];for(let s=0;s{"use strict";var MZ=(t={})=>{let e=t.env||process.env;return(t.platform||process.platform)!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"};xR.exports=MZ;xR.exports.default=MZ});var qZ=v((Bet,UZ)=>{"use strict";var LZ=Ge("path"),ave=jZ(),cve=FZ();function zZ(t,e){let r=t.options.env||process.env,n=process.cwd(),i=t.options.cwd!=null,o=i&&process.chdir!==void 0&&!process.chdir.disabled;if(o)try{process.chdir(t.options.cwd)}catch{}let s;try{s=ave.sync(t.command,{path:r[cve({env:r})],pathExt:e?LZ.delimiter:void 0})}catch{}finally{o&&process.chdir(n)}return s&&(s=LZ.resolve(i?t.options.cwd:"",s)),s}function lve(t){return zZ(t)||zZ(t,!0)}UZ.exports=lve});var BZ=v((Het,kR)=>{"use strict";var $R=/([()\][%!^"`<>&|;, *?])/g;function uve(t){return t=t.replace($R,"^$1"),t}function dve(t,e){return t=`${t}`,t=t.replace(/(?=(\\+?)?)\1"/g,'$1$1\\"'),t=t.replace(/(?=(\\+?)?)\1$/,"$1$1"),t=`"${t}"`,t=t.replace($R,"^$1"),e&&(t=t.replace($R,"^$1")),t}kR.exports.command=uve;kR.exports.argument=dve});var GZ=v((Get,HZ)=>{"use strict";HZ.exports=/^#!(.*)/});var VZ=v((Zet,ZZ)=>{"use strict";var fve=GZ();ZZ.exports=(t="")=>{let e=t.match(fve);if(!e)return null;let[r,n]=e[0].replace(/#! ?/,"").split(" "),i=r.split("/").pop();return i==="env"?n:n?`${i} ${n}`:i}});var KZ=v((Vet,WZ)=>{"use strict";var ER=Ge("fs"),pve=VZ();function mve(t){let r=Buffer.alloc(150),n;try{n=ER.openSync(t,"r"),ER.readSync(n,r,0,150,0),ER.closeSync(n)}catch{}return pve(r.toString())}WZ.exports=mve});var QZ=v((Wet,XZ)=>{"use strict";var hve=Ge("path"),JZ=qZ(),YZ=BZ(),gve=KZ(),yve=process.platform==="win32",_ve=/\.(?:com|exe)$/i,bve=/node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;function vve(t){t.file=JZ(t);let e=t.file&&gve(t.file);return e?(t.args.unshift(t.file),t.command=e,JZ(t)):t.file}function Sve(t){if(!yve)return t;let e=vve(t),r=!_ve.test(e);if(t.options.forceShell||r){let n=bve.test(e);t.command=hve.normalize(t.command),t.command=YZ.command(t.command),t.args=t.args.map(o=>YZ.argument(o,n));let i=[t.command].concat(t.args).join(" ");t.args=["/d","/s","/c",`"${i}"`],t.command=process.env.comspec||"cmd.exe",t.options.windowsVerbatimArguments=!0}return t}function wve(t,e,r){e&&!Array.isArray(e)&&(r=e,e=null),e=e?e.slice(0):[],r=Object.assign({},r);let n={command:t,args:e,options:r,file:void 0,original:{command:t,args:e}};return r.shell?n:Sve(n)}XZ.exports=wve});var r9=v((Ket,t9)=>{"use strict";var AR=process.platform==="win32";function TR(t,e){return Object.assign(new Error(`${e} ${t.command} ENOENT`),{code:"ENOENT",errno:"ENOENT",syscall:`${e} ${t.command}`,path:t.command,spawnargs:t.args})}function xve(t,e){if(!AR)return;let r=t.emit;t.emit=function(n,i){if(n==="exit"){let o=e9(i,e);if(o)return r.call(t,"error",o)}return r.apply(t,arguments)}}function e9(t,e){return AR&&t===1&&!e.file?TR(e.original,"spawn"):null}function $ve(t,e){return AR&&t===1&&!e.file?TR(e.original,"spawnSync"):null}t9.exports={hookChildProcess:xve,verifyENOENT:e9,verifyENOENTSync:$ve,notFoundError:TR}});var o9=v((Jet,Tl)=>{"use strict";var n9=Ge("child_process"),OR=QZ(),RR=r9();function i9(t,e,r){let n=OR(t,e,r),i=n9.spawn(n.command,n.args,n.options);return RR.hookChildProcess(i,n),i}function kve(t,e,r){let n=OR(t,e,r),i=n9.spawnSync(n.command,n.args,n.options);return i.error=i.error||RR.verifyENOENTSync(i.status,n),i}Tl.exports=i9;Tl.exports.spawn=i9;Tl.exports.sync=kve;Tl.exports._parse=OR;Tl.exports._enoent=RR});function lb(t={}){let{env:e=process.env,platform:r=process.platform}=t;return r!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"}var s9=y(()=>{});var a9=y(()=>{});import{promisify as Eve}from"node:util";import{execFile as Ave,execFileSync as ttt}from"node:child_process";import c9 from"node:path";import{fileURLToPath as Tve}from"node:url";function ub(t){return t instanceof URL?Tve(t):t}function l9(t){return{*[Symbol.iterator](){let e=c9.resolve(ub(t)),r;for(;r!==e;)yield e,r=e,e=c9.resolve(e,"..")}}}var itt,ott,u9=y(()=>{a9();itt=Eve(Ave);ott=10*1024*1024});import db from"node:process";import Oa from"node:path";var Ove,Rve,Ive,d9,f9=y(()=>{s9();u9();Ove=({cwd:t=db.cwd(),path:e=db.env[lb()],preferLocal:r=!0,execPath:n=db.execPath,addExecPath:i=!0}={})=>{let o=Oa.resolve(ub(t)),s=[],a=e.split(Oa.delimiter);return r&&Rve(s,a,o),i&&Ive(s,a,n,o),e===""||e===Oa.delimiter?`${s.join(Oa.delimiter)}${e}`:[...s,e].join(Oa.delimiter)},Rve=(t,e,r)=>{for(let n of l9(r)){let i=Oa.join(n,"node_modules/.bin");e.includes(i)||t.push(i)}},Ive=(t,e,r,n)=>{let i=Oa.resolve(n,ub(r),"..");e.includes(i)||t.push(i)},d9=({env:t=db.env,...e}={})=>{t={...t};let r=lb({env:t});return e.path=t[r],t[r]=Ove(e),t}});var p9,ti,m9,h9,g9,fb,Zf,Vf,Ra=y(()=>{p9=(t,e,r)=>{let n=r?Vf:Zf,i=t instanceof ti?{}:{cause:t};return new n(e,i)},ti=class extends Error{},m9=(t,e)=>{Object.defineProperty(t.prototype,"name",{value:e,writable:!0,enumerable:!1,configurable:!0}),Object.defineProperty(t.prototype,g9,{value:!0,writable:!1,enumerable:!1,configurable:!1})},h9=t=>fb(t)&&g9 in t,g9=Symbol("isExecaError"),fb=t=>Object.prototype.toString.call(t)==="[object Error]",Zf=class extends Error{};m9(Zf,Zf.name);Vf=class extends Error{};m9(Vf,Vf.name)});var y9,Pve,_9,b9,v9=y(()=>{y9=()=>{let t=b9-_9+1;return Array.from({length:t},Pve)},Pve=(t,e)=>({name:`SIGRT${e+1}`,number:_9+e,action:"terminate",description:"Application-specific signal (realtime)",standard:"posix"}),_9=34,b9=64});var S9,w9=y(()=>{S9=[{name:"SIGHUP",number:1,action:"terminate",description:"Terminal closed",standard:"posix"},{name:"SIGINT",number:2,action:"terminate",description:"User interruption with CTRL-C",standard:"ansi"},{name:"SIGQUIT",number:3,action:"core",description:"User interruption with CTRL-\\",standard:"posix"},{name:"SIGILL",number:4,action:"core",description:"Invalid machine instruction",standard:"ansi"},{name:"SIGTRAP",number:5,action:"core",description:"Debugger breakpoint",standard:"posix"},{name:"SIGABRT",number:6,action:"core",description:"Aborted",standard:"ansi"},{name:"SIGIOT",number:6,action:"core",description:"Aborted",standard:"bsd"},{name:"SIGBUS",number:7,action:"core",description:"Bus error due to misaligned, non-existing address or paging error",standard:"bsd"},{name:"SIGEMT",number:7,action:"terminate",description:"Command should be emulated but is not implemented",standard:"other"},{name:"SIGFPE",number:8,action:"core",description:"Floating point arithmetic error",standard:"ansi"},{name:"SIGKILL",number:9,action:"terminate",description:"Forced termination",standard:"posix",forced:!0},{name:"SIGUSR1",number:10,action:"terminate",description:"Application-specific signal",standard:"posix"},{name:"SIGSEGV",number:11,action:"core",description:"Segmentation fault",standard:"ansi"},{name:"SIGUSR2",number:12,action:"terminate",description:"Application-specific signal",standard:"posix"},{name:"SIGPIPE",number:13,action:"terminate",description:"Broken pipe or socket",standard:"posix"},{name:"SIGALRM",number:14,action:"terminate",description:"Timeout or timer",standard:"posix"},{name:"SIGTERM",number:15,action:"terminate",description:"Termination",standard:"ansi"},{name:"SIGSTKFLT",number:16,action:"terminate",description:"Stack is empty or overflowed",standard:"other"},{name:"SIGCHLD",number:17,action:"ignore",description:"Child process terminated, paused or unpaused",standard:"posix"},{name:"SIGCLD",number:17,action:"ignore",description:"Child process terminated, paused or unpaused",standard:"other"},{name:"SIGCONT",number:18,action:"unpause",description:"Unpaused",standard:"posix",forced:!0},{name:"SIGSTOP",number:19,action:"pause",description:"Paused",standard:"posix",forced:!0},{name:"SIGTSTP",number:20,action:"pause",description:'Paused using CTRL-Z or "suspend"',standard:"posix"},{name:"SIGTTIN",number:21,action:"pause",description:"Background process cannot read terminal input",standard:"posix"},{name:"SIGBREAK",number:21,action:"terminate",description:"User interruption with CTRL-BREAK",standard:"other"},{name:"SIGTTOU",number:22,action:"pause",description:"Background process cannot write to terminal output",standard:"posix"},{name:"SIGURG",number:23,action:"ignore",description:"Socket received out-of-band data",standard:"bsd"},{name:"SIGXCPU",number:24,action:"core",description:"Process timed out",standard:"bsd"},{name:"SIGXFSZ",number:25,action:"core",description:"File too big",standard:"bsd"},{name:"SIGVTALRM",number:26,action:"terminate",description:"Timeout or timer",standard:"bsd"},{name:"SIGPROF",number:27,action:"terminate",description:"Timeout or timer",standard:"bsd"},{name:"SIGWINCH",number:28,action:"ignore",description:"Terminal window size changed",standard:"bsd"},{name:"SIGIO",number:29,action:"terminate",description:"I/O is available",standard:"other"},{name:"SIGPOLL",number:29,action:"terminate",description:"Watched event",standard:"other"},{name:"SIGINFO",number:29,action:"ignore",description:"Request for process information",standard:"other"},{name:"SIGPWR",number:30,action:"terminate",description:"Device running out of power",standard:"systemv"},{name:"SIGSYS",number:31,action:"core",description:"Invalid system call",standard:"other"},{name:"SIGUNUSED",number:31,action:"terminate",description:"Invalid system call",standard:"other"}]});import{constants as Cve}from"node:os";var IR,Dve,x9=y(()=>{w9();v9();IR=()=>{let t=y9();return[...S9,...t].map(Dve)},Dve=({name:t,number:e,description:r,action:n,forced:i=!1,standard:o})=>{let{signals:{[t]:s}}=Cve,a=s!==void 0;return{name:t,number:a?s:e,description:r,supported:a,action:n,forced:i,standard:o}}});import{constants as Nve}from"node:os";var jve,Mve,$9,Fve,Lve,zve,wtt,k9=y(()=>{x9();jve=()=>{let t=IR();return Object.fromEntries(t.map(Mve))},Mve=({name:t,number:e,description:r,supported:n,action:i,forced:o,standard:s})=>[t,{name:t,number:e,description:r,supported:n,action:i,forced:o,standard:s}],$9=jve(),Fve=()=>{let t=IR(),e=65,r=Array.from({length:e},(n,i)=>Lve(i,t));return Object.assign({},...r)},Lve=(t,e)=>{let r=zve(t,e);if(r===void 0)return{};let{name:n,description:i,supported:o,action:s,forced:a,standard:c}=r;return{[t]:{name:n,number:t,description:i,supported:o,action:s,forced:a,standard:c}}},zve=(t,e)=>{let r=e.find(({name:n})=>Nve.signals[n]===t);return r!==void 0?r:e.find(n=>n.number===t)},wtt=Fve()});import{constants as Wf}from"node:os";var A9,T9,O9,Uve,qve,E9,Bve,PR,Hve,Gve,pb,Kf=y(()=>{k9();A9=t=>{let e="option `killSignal`";if(t===0)throw new TypeError(`Invalid ${e}: 0 cannot be used.`);return O9(t,e)},T9=t=>t===0?t:O9(t,"`subprocess.kill()`'s argument"),O9=(t,e)=>{if(Number.isInteger(t))return Uve(t,e);if(typeof t=="string")return Bve(t,e);throw new TypeError(`Invalid ${e} ${String(t)}: it must be a string or an integer. +${PR()}`)},Uve=(t,e)=>{if(E9.has(t))return E9.get(t);throw new TypeError(`Invalid ${e} ${t}: this signal integer does not exist. +${PR()}`)},qve=()=>new Map(Object.entries(Wf.signals).reverse().map(([t,e])=>[e,t])),E9=qve(),Bve=(t,e)=>{if(t in Wf.signals)return t;throw t.toUpperCase()in Wf.signals?new TypeError(`Invalid ${e} '${t}': please rename it to '${t.toUpperCase()}'.`):new TypeError(`Invalid ${e} '${t}': this signal name does not exist. +${PR()}`)},PR=()=>`Available signal names: ${Hve()}. +Available signal numbers: ${Gve()}.`,Hve=()=>Object.keys(Wf.signals).sort().map(t=>`'${t}'`).join(", "),Gve=()=>[...new Set(Object.values(Wf.signals).sort((t,e)=>t-e))].join(", "),pb=t=>$9[t].description});import{setTimeout as Zve}from"node:timers/promises";var R9,Vve,I9,Wve,Kve,Jve,CR,mb=y(()=>{Ra();Kf();R9=t=>{if(t===!1)return t;if(t===!0)return Vve;if(!Number.isFinite(t)||t<0)throw new TypeError(`Expected the \`forceKillAfterDelay\` option to be a non-negative integer, got \`${t}\` (${typeof t})`);return t},Vve=1e3*5,I9=({kill:t,options:{forceKillAfterDelay:e,killSignal:r},onInternalError:n,context:i,controller:o},s,a)=>{let{signal:c,error:l}=Wve(s,a,r);Kve(l,n);let u=t(c);return Jve({kill:t,signal:c,forceKillAfterDelay:e,killSignal:r,killResult:u,context:i,controller:o}),u},Wve=(t,e,r)=>{let[n=r,i]=fb(t)?[void 0,t]:[t,e];if(typeof n!="string"&&!Number.isInteger(n))throw new TypeError(`The first argument must be an error instance or a signal name string/integer: ${String(n)}`);if(i!==void 0&&!fb(i))throw new TypeError(`The second argument is optional. If specified, it must be an error instance: ${i}`);return{signal:T9(n),error:i}},Kve=(t,e)=>{t!==void 0&&e.reject(t)},Jve=async({kill:t,signal:e,forceKillAfterDelay:r,killSignal:n,killResult:i,context:o,controller:s})=>{e===n&&i&&CR({kill:t,forceKillAfterDelay:r,context:o,controllerSignal:s.signal})},CR=async({kill:t,forceKillAfterDelay:e,context:r,controllerSignal:n})=>{if(e!==!1)try{await Zve(e,void 0,{signal:n}),t("SIGKILL")&&(r.isForcefullyTerminated??=!0)}catch{}}});import{once as Yve}from"node:events";var hb,DR=y(()=>{hb=async(t,e)=>{t.aborted||await Yve(t,"abort",{signal:e})}});var P9,C9,Xve,NR=y(()=>{DR();P9=({cancelSignal:t})=>{if(t!==void 0&&Object.prototype.toString.call(t)!=="[object AbortSignal]")throw new Error(`The \`cancelSignal\` option must be an AbortSignal: ${String(t)}`)},C9=({subprocess:t,cancelSignal:e,gracefulCancel:r,context:n,controller:i})=>e===void 0||r?[]:[Xve(t,e,n,i)],Xve=async(t,e,r,{signal:n})=>{throw await hb(e,n),r.terminationReason??="cancel",t.kill(),e.reason}});var Ol,Qve,jR,D9,N9,gb,j9,M9,F9,L9,z9,U9,eSe,tSe,rSe,ri,nSe,us,Rl,Il=y(()=>{Ol=({methodName:t,isSubprocess:e,ipc:r,isConnected:n})=>{Qve(t,e,r),jR(t,e,n)},Qve=(t,e,r)=>{if(!r)throw new Error(`${ri(t,e)} can only be used if the \`ipc\` option is \`true\`.`)},jR=(t,e,r)=>{if(!r)throw new Error(`${ri(t,e)} cannot be used: the ${us(e)} has already exited or disconnected.`)},D9=t=>{throw new Error(`${ri("getOneMessage",t)} could not complete: the ${us(t)} exited or disconnected.`)},N9=t=>{throw new Error(`${ri("sendMessage",t)} failed: the ${us(t)} is sending a message too, instead of listening to incoming messages. This can be fixed by both sending a message and listening to incoming messages at the same time: const [receivedMessage] = await Promise.all([ - ${ti("getOneMessage",t)}, - ${ti("sendMessage",t,"message, {strict: true}")}, -]);`)},gb=(t,e)=>new Error(`${ti("sendMessage",e)} failed when sending an acknowledgment response to the ${us(e)}.`,{cause:t}),D9=t=>{throw new Error(`${ti("sendMessage",t)} failed: the ${us(t)} is not listening to incoming messages.`)},N9=t=>{throw new Error(`${ti("sendMessage",t)} failed: the ${us(t)} exited without listening to incoming messages.`)},j9=()=>new Error(`\`cancelSignal\` aborted: the ${us(!0)} disconnected.`),M9=()=>{throw new Error("`getCancelSignal()` cannot be used without setting the `cancelSignal` subprocess option.")},F9=({error:t,methodName:e,isSubprocess:r})=>{if(t.code==="EPIPE")throw new Error(`${ti(e,r)} cannot be used: the ${us(r)} is disconnecting.`,{cause:t})},L9=({error:t,methodName:e,isSubprocess:r,message:n})=>{if(Yve(t))throw new Error(`${ti(e,r)}'s argument type is invalid: the message cannot be serialized: ${String(n)}.`,{cause:t})},Yve=({code:t,message:e})=>Xve.has(t)||Qve.some(r=>e.includes(r)),Xve=new Set(["ERR_MISSING_ARGS","ERR_INVALID_ARG_TYPE"]),Qve=["could not be cloned","circular structure","call stack size exceeded"],ti=(t,e,r="")=>t==="cancelSignal"?"`cancelSignal`'s `controller.abort()`":`${eSe(e)}${t}(${r})`,eSe=t=>t?"":"subprocess.",us=t=>t?"parent process":"subprocess",Rl=t=>{t.connected&&t.disconnect()}});var Ci,Pl=y(()=>{Ci=()=>{let t={},e=new Promise((r,n)=>{Object.assign(t,{resolve:r,reject:n})});return Object.assign(e,t)}});var _b,Cl,Di,z9,tSe,rSe,U9,nSe,q9,Kf,yb,ds=y(()=>{So();_b=(t,e="stdin")=>{let{options:n,fileDescriptors:i}=Di.get(t),o=z9(i,e,!0),s=t.stdio[o];if(s===null)throw new TypeError(U9(o,e,n,!0));return s},Cl=(t,e="stdout")=>{let{options:n,fileDescriptors:i}=Di.get(t),o=z9(i,e,!1),s=o==="all"?t.all:t.stdio[o];if(s==null)throw new TypeError(U9(o,e,n,!1));return s},Di=new WeakMap,z9=(t,e,r)=>{let n=tSe(e,r);return rSe(n,e,r,t),n},tSe=(t,e)=>{let r=hR(t);if(r!==void 0)return r;let{validOptions:n,defaultValue:i}=e?{validOptions:'"stdin"',defaultValue:"stdin"}:{validOptions:'"stdout", "stderr", "all"',defaultValue:"stdout"};throw new TypeError(`"${Kf(e)}" must not be "${t}". + ${ri("getOneMessage",t)}, + ${ri("sendMessage",t,"message, {strict: true}")}, +]);`)},gb=(t,e)=>new Error(`${ri("sendMessage",e)} failed when sending an acknowledgment response to the ${us(e)}.`,{cause:t}),j9=t=>{throw new Error(`${ri("sendMessage",t)} failed: the ${us(t)} is not listening to incoming messages.`)},M9=t=>{throw new Error(`${ri("sendMessage",t)} failed: the ${us(t)} exited without listening to incoming messages.`)},F9=()=>new Error(`\`cancelSignal\` aborted: the ${us(!0)} disconnected.`),L9=()=>{throw new Error("`getCancelSignal()` cannot be used without setting the `cancelSignal` subprocess option.")},z9=({error:t,methodName:e,isSubprocess:r})=>{if(t.code==="EPIPE")throw new Error(`${ri(e,r)} cannot be used: the ${us(r)} is disconnecting.`,{cause:t})},U9=({error:t,methodName:e,isSubprocess:r,message:n})=>{if(eSe(t))throw new Error(`${ri(e,r)}'s argument type is invalid: the message cannot be serialized: ${String(n)}.`,{cause:t})},eSe=({code:t,message:e})=>tSe.has(t)||rSe.some(r=>e.includes(r)),tSe=new Set(["ERR_MISSING_ARGS","ERR_INVALID_ARG_TYPE"]),rSe=["could not be cloned","circular structure","call stack size exceeded"],ri=(t,e,r="")=>t==="cancelSignal"?"`cancelSignal`'s `controller.abort()`":`${nSe(e)}${t}(${r})`,nSe=t=>t?"":"subprocess.",us=t=>t?"parent process":"subprocess",Rl=t=>{t.connected&&t.disconnect()}});var Ci,Pl=y(()=>{Ci=()=>{let t={},e=new Promise((r,n)=>{Object.assign(t,{resolve:r,reject:n})});return Object.assign(e,t)}});var _b,Cl,Di,q9,iSe,oSe,B9,sSe,H9,Jf,yb,ds=y(()=>{So();_b=(t,e="stdin")=>{let{options:n,fileDescriptors:i}=Di.get(t),o=q9(i,e,!0),s=t.stdio[o];if(s===null)throw new TypeError(B9(o,e,n,!0));return s},Cl=(t,e="stdout")=>{let{options:n,fileDescriptors:i}=Di.get(t),o=q9(i,e,!1),s=o==="all"?t.all:t.stdio[o];if(s==null)throw new TypeError(B9(o,e,n,!1));return s},Di=new WeakMap,q9=(t,e,r)=>{let n=iSe(e,r);return oSe(n,e,r,t),n},iSe=(t,e)=>{let r=hR(t);if(r!==void 0)return r;let{validOptions:n,defaultValue:i}=e?{validOptions:'"stdin"',defaultValue:"stdin"}:{validOptions:'"stdout", "stderr", "all"',defaultValue:"stdout"};throw new TypeError(`"${Jf(e)}" must not be "${t}". It must be ${n} or "fd3", "fd4" (and so on). -It is optional and defaults to "${i}".`)},rSe=(t,e,r,n)=>{let i=n[q9(t)];if(i===void 0)throw new TypeError(`"${Kf(r)}" must not be ${e}. That file descriptor does not exist. -Please set the "stdio" option to ensure that file descriptor exists.`);if(i.direction==="input"&&!r)throw new TypeError(`"${Kf(r)}" must not be ${e}. It must be a readable stream, not writable.`);if(i.direction!=="input"&&r)throw new TypeError(`"${Kf(r)}" must not be ${e}. It must be a writable stream, not readable.`)},U9=(t,e,r,n)=>{if(t==="all"&&!r.all)return`The "all" option must be true to use "from: 'all'".`;let{optionName:i,optionValue:o}=nSe(t,r);return`The "${i}: ${yb(o)}" option is incompatible with using "${Kf(n)}: ${yb(e)}". -Please set this option with "pipe" instead.`},nSe=(t,{stdin:e,stdout:r,stderr:n,stdio:i})=>{let o=q9(t);return o===0&&e!==void 0?{optionName:"stdin",optionValue:e}:o===1&&r!==void 0?{optionName:"stdout",optionValue:r}:o===2&&n!==void 0?{optionName:"stderr",optionValue:n}:{optionName:`stdio[${o}]`,optionValue:i[o]}},q9=t=>t==="all"?1:t,Kf=t=>t?"to":"from",yb=t=>typeof t=="string"?`'${t}'`:typeof t=="number"?`${t}`:"Stream"});import{addAbortListener as iSe}from"node:events";var Ia,bb=y(()=>{Ia=(t,e,r)=>{let n=t.getMaxListeners();n===0||n===Number.POSITIVE_INFINITY||(t.setMaxListeners(n+e),iSe(r,()=>{t.setMaxListeners(t.getMaxListeners()-e)}))}});var vb,MR,Sb,FR,B9,H9,Jf=y(()=>{vb=(t,e)=>{e&&MR(t)},MR=t=>{t.refCounted()},Sb=(t,e)=>{e&&FR(t)},FR=t=>{t.unrefCounted()},B9=(t,e)=>{e&&(FR(t),FR(t))},H9=(t,e)=>{e&&(MR(t),MR(t))}});import{once as oSe}from"node:events";import{scheduler as sSe}from"node:timers/promises";var G9,Z9,wb,V9=y(()=>{$b();Jf();xb();kb();G9=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n},i)=>{if(K9(i)||Y9(i))return;wb.has(t)||wb.set(t,[]);let o=wb.get(t);if(o.push(i),!(o.length>1))for(;o.length>0;){await J9(t,n,i),await sSe.yield();let s=await W9({wrappedMessage:o[0],anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n});o.shift(),n.emit("message",s),n.emit("message:done")}},Z9=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n,boundOnMessage:i})=>{LR();let o=wb.get(t);for(;o?.length>0;)await oSe(n,"message:done");t.removeListener("message",i),H9(e,r),n.connected=!1,n.emit("disconnect")},wb=new WeakMap});import{EventEmitter as aSe}from"node:events";var fs,Eb,cSe,Ab,Yf=y(()=>{V9();Jf();fs=(t,e,r)=>{if(Eb.has(t))return Eb.get(t);let n=new aSe;return n.connected=!0,Eb.set(t,n),cSe({ipcEmitter:n,anyProcess:t,channel:e,isSubprocess:r}),n},Eb=new WeakMap,cSe=({ipcEmitter:t,anyProcess:e,channel:r,isSubprocess:n})=>{let i=G9.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t});e.on("message",i),e.once("disconnect",Z9.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t,boundOnMessage:i})),B9(r,n)},Ab=t=>{let e=Eb.get(t);return e===void 0?t.channel!==null:e.connected}});import{once as lSe}from"node:events";var X9,uSe,Q9,W9,K9,eV,Tb,dSe,Ob,tV,xb=y(()=>{Pl();bb();Pb();Il();Yf();$b();X9=({anyProcess:t,channel:e,isSubprocess:r,message:n,strict:i})=>{if(!i)return n;let o=fs(t,e,r),s=Rb(t,o);return{id:uSe++,type:Ob,message:n,hasListeners:s}},uSe=0n,Q9=(t,e)=>{if(!(e?.type!==Ob||e.hasListeners))for(let{id:r}of t)r!==void 0&&Tb[r].resolve({isDeadlock:!0,hasListeners:!1})},W9=async({wrappedMessage:t,anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:i})=>{if(t?.type!==Ob||!e.connected)return t;let{id:o,message:s}=t,a={id:o,type:tV,message:Rb(e,i)};try{await Ib({anyProcess:e,channel:r,isSubprocess:n,ipc:!0},a)}catch(c){i.emit("strict:error",c)}return s},K9=t=>{if(t?.type!==tV)return!1;let{id:e,message:r}=t;return Tb[e]?.resolve({isDeadlock:!1,hasListeners:r}),!0},eV=async(t,e,r)=>{if(t?.type!==Ob)return;let n=Ci();Tb[t.id]=n;let i=new AbortController;try{let{isDeadlock:o,hasListeners:s}=await Promise.race([n,dSe(e,r,i)]);o&&C9(r),s||D9(r)}finally{i.abort(),delete Tb[t.id]}},Tb={},dSe=async(t,e,{signal:r})=>{Ia(t,1,r),await lSe(t,"disconnect",{signal:r}),N9(e)},Ob="execa:ipc:request",tV="execa:ipc:response"});var rV,nV,J9,Xf,Rb,fSe,$b=y(()=>{Pl();So();ds();xb();rV=(t,e,r)=>{Xf.has(t)||Xf.set(t,new Set);let n=Xf.get(t),i=Ci(),o=r?e.id:void 0,s={onMessageSent:i,id:o};return n.add(s),{outgoingMessages:n,outgoingMessage:s}},nV=({outgoingMessages:t,outgoingMessage:e})=>{t.delete(e),e.onMessageSent.resolve()},J9=async(t,e,r)=>{for(;!Rb(t,e)&&Xf.get(t)?.size>0;){let n=[...Xf.get(t)];Q9(n,r),await Promise.all(n.map(({onMessageSent:i})=>i))}},Xf=new WeakMap,Rb=(t,e)=>e.listenerCount("message")>fSe(t),fSe=t=>Di.has(t)&&!vo(Di.get(t).options.buffer,"ipc")?1:0});import{promisify as pSe}from"node:util";var Ib,mSe,UR,hSe,zR,Pb=y(()=>{Il();$b();xb();Ib=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},i,{strict:o=!1}={})=>{let s="sendMessage";return Ol({methodName:s,isSubprocess:r,ipc:n,isConnected:t.connected}),mSe({anyProcess:t,channel:e,methodName:s,isSubprocess:r,message:i,strict:o})},mSe=async({anyProcess:t,channel:e,methodName:r,isSubprocess:n,message:i,strict:o})=>{let s=X9({anyProcess:t,channel:e,isSubprocess:n,message:i,strict:o}),a=rV(t,s,o);try{await UR({anyProcess:t,methodName:r,isSubprocess:n,wrappedMessage:s,message:i})}catch(c){throw Rl(t),c}finally{nV(a)}},UR=async({anyProcess:t,methodName:e,isSubprocess:r,wrappedMessage:n,message:i})=>{let o=hSe(t);try{await Promise.all([eV(n,t,r),o(n)])}catch(s){throw F9({error:s,methodName:e,isSubprocess:r}),L9({error:s,methodName:e,isSubprocess:r,message:i}),s}},hSe=t=>{if(zR.has(t))return zR.get(t);let e=pSe(t.send.bind(t));return zR.set(t,e),e},zR=new WeakMap});import{scheduler as gSe}from"node:timers/promises";var oV,sV,ySe,iV,Y9,aV,LR,qR,kb=y(()=>{Pb();Yf();Il();oV=(t,e)=>{let r="cancelSignal";return jR(r,!1,t.connected),UR({anyProcess:t,methodName:r,isSubprocess:!1,wrappedMessage:{type:aV,message:e},message:e})},sV=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>(await ySe({anyProcess:t,channel:e,isSubprocess:r,ipc:n}),qR.signal),ySe=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>{if(!iV){if(iV=!0,!n){M9();return}if(e===null){LR();return}fs(t,e,r),await gSe.yield()}},iV=!1,Y9=t=>t?.type!==aV?!1:(qR.abort(t.message),!0),aV="execa:ipc:cancel",LR=()=>{qR.abort(j9())},qR=new AbortController});var cV,lV,_Se,bSe,BR=y(()=>{DR();kb();mb();cV=({gracefulCancel:t,cancelSignal:e,ipc:r,serialization:n})=>{if(t){if(e===void 0)throw new Error("The `cancelSignal` option must be defined when setting the `gracefulCancel` option.");if(!r)throw new Error("The `ipc` option cannot be false when setting the `gracefulCancel` option.");if(n==="json")throw new Error("The `serialization` option cannot be 'json' when setting the `gracefulCancel` option.")}},lV=({subprocess:t,cancelSignal:e,gracefulCancel:r,forceKillAfterDelay:n,context:i,controller:o})=>r?[_Se({subprocess:t,cancelSignal:e,forceKillAfterDelay:n,context:i,controller:o})]:[],_Se=async({subprocess:t,cancelSignal:e,forceKillAfterDelay:r,context:n,controller:{signal:i}})=>{await hb(e,i);let o=bSe(e);throw await oV(t,o),CR({kill:t.kill,forceKillAfterDelay:r,context:n,controllerSignal:i}),n.terminationReason??="gracefulCancel",e.reason},bSe=({reason:t})=>{if(!(t instanceof DOMException))return t;let e=new Error(t.message);return Object.defineProperty(e,"stack",{value:t.stack,enumerable:!1,configurable:!0,writable:!0}),e}});import{setTimeout as vSe}from"node:timers/promises";var uV,dV,SSe,HR=y(()=>{Ra();uV=({timeout:t})=>{if(t!==void 0&&(!Number.isFinite(t)||t<0))throw new TypeError(`Expected the \`timeout\` option to be a non-negative integer, got \`${t}\` (${typeof t})`)},dV=(t,e,r,n)=>e===0||e===void 0?[]:[SSe(t,e,r,n)],SSe=async(t,e,r,{signal:n})=>{throw await vSe(e,void 0,{signal:n}),r.terminationReason??="timeout",t.kill(),new ei}});import{execPath as wSe,execArgv as xSe}from"node:process";import fV from"node:path";var pV,mV,GR=y(()=>{xl();pV=({options:t})=>{if(t.node===!1)throw new TypeError('The "node" option cannot be false with `execaNode()`.');return{options:{...t,node:!0}}},mV=(t,e,{node:r=!1,nodePath:n=wSe,nodeOptions:i=xSe.filter(c=>!c.startsWith("--inspect")),cwd:o,execPath:s,...a})=>{if(s!==void 0)throw new TypeError('The "execPath" option has been removed. Please use the "nodePath" option instead.');let c=wl(n,'The "nodePath" option'),l=fV.resolve(o,c),u={...a,nodePath:l,node:r,cwd:o};if(!r)return[t,e,u];if(fV.basename(t,".exe")==="node")throw new TypeError('When the "node" option is true, the first argument does not need to be "node".');return[l,[...i,t,...e],{ipc:!0,...u,shell:!1}]}});import{serialize as $Se}from"node:v8";var hV,kSe,ESe,ASe,gV,ZR=y(()=>{hV=({ipcInput:t,ipc:e,serialization:r})=>{if(t!==void 0){if(!e)throw new Error("The `ipcInput` option cannot be set unless the `ipc` option is `true`.");ASe[r](t)}},kSe=t=>{try{$Se(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with a structured clone.",{cause:e})}},ESe=t=>{try{JSON.stringify(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with JSON.",{cause:e})}},ASe={advanced:kSe,json:ESe},gV=async(t,e)=>{e!==void 0&&await t.sendMessage(e)}});var _V,TSe,on,VR,OSe,yV,Cb,Pa=y(()=>{_V=({encoding:t})=>{if(VR.has(t))return;let e=OSe(t);if(e!==void 0)throw new TypeError(`Invalid option \`encoding: ${Cb(t)}\`. +It is optional and defaults to "${i}".`)},oSe=(t,e,r,n)=>{let i=n[H9(t)];if(i===void 0)throw new TypeError(`"${Jf(r)}" must not be ${e}. That file descriptor does not exist. +Please set the "stdio" option to ensure that file descriptor exists.`);if(i.direction==="input"&&!r)throw new TypeError(`"${Jf(r)}" must not be ${e}. It must be a readable stream, not writable.`);if(i.direction!=="input"&&r)throw new TypeError(`"${Jf(r)}" must not be ${e}. It must be a writable stream, not readable.`)},B9=(t,e,r,n)=>{if(t==="all"&&!r.all)return`The "all" option must be true to use "from: 'all'".`;let{optionName:i,optionValue:o}=sSe(t,r);return`The "${i}: ${yb(o)}" option is incompatible with using "${Jf(n)}: ${yb(e)}". +Please set this option with "pipe" instead.`},sSe=(t,{stdin:e,stdout:r,stderr:n,stdio:i})=>{let o=H9(t);return o===0&&e!==void 0?{optionName:"stdin",optionValue:e}:o===1&&r!==void 0?{optionName:"stdout",optionValue:r}:o===2&&n!==void 0?{optionName:"stderr",optionValue:n}:{optionName:`stdio[${o}]`,optionValue:i[o]}},H9=t=>t==="all"?1:t,Jf=t=>t?"to":"from",yb=t=>typeof t=="string"?`'${t}'`:typeof t=="number"?`${t}`:"Stream"});import{addAbortListener as aSe}from"node:events";var Ia,bb=y(()=>{Ia=(t,e,r)=>{let n=t.getMaxListeners();n===0||n===Number.POSITIVE_INFINITY||(t.setMaxListeners(n+e),aSe(r,()=>{t.setMaxListeners(t.getMaxListeners()-e)}))}});var vb,MR,Sb,FR,G9,Z9,Yf=y(()=>{vb=(t,e)=>{e&&MR(t)},MR=t=>{t.refCounted()},Sb=(t,e)=>{e&&FR(t)},FR=t=>{t.unrefCounted()},G9=(t,e)=>{e&&(FR(t),FR(t))},Z9=(t,e)=>{e&&(MR(t),MR(t))}});import{once as cSe}from"node:events";import{scheduler as lSe}from"node:timers/promises";var V9,W9,wb,K9=y(()=>{$b();Yf();xb();kb();V9=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n},i)=>{if(Y9(i)||Q9(i))return;wb.has(t)||wb.set(t,[]);let o=wb.get(t);if(o.push(i),!(o.length>1))for(;o.length>0;){await X9(t,n,i),await lSe.yield();let s=await J9({wrappedMessage:o[0],anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n});o.shift(),n.emit("message",s),n.emit("message:done")}},W9=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n,boundOnMessage:i})=>{LR();let o=wb.get(t);for(;o?.length>0;)await cSe(n,"message:done");t.removeListener("message",i),Z9(e,r),n.connected=!1,n.emit("disconnect")},wb=new WeakMap});import{EventEmitter as uSe}from"node:events";var fs,Eb,dSe,Ab,Xf=y(()=>{K9();Yf();fs=(t,e,r)=>{if(Eb.has(t))return Eb.get(t);let n=new uSe;return n.connected=!0,Eb.set(t,n),dSe({ipcEmitter:n,anyProcess:t,channel:e,isSubprocess:r}),n},Eb=new WeakMap,dSe=({ipcEmitter:t,anyProcess:e,channel:r,isSubprocess:n})=>{let i=V9.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t});e.on("message",i),e.once("disconnect",W9.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t,boundOnMessage:i})),G9(r,n)},Ab=t=>{let e=Eb.get(t);return e===void 0?t.channel!==null:e.connected}});import{once as fSe}from"node:events";var eV,pSe,tV,J9,Y9,rV,Tb,mSe,Ob,nV,xb=y(()=>{Pl();bb();Pb();Il();Xf();$b();eV=({anyProcess:t,channel:e,isSubprocess:r,message:n,strict:i})=>{if(!i)return n;let o=fs(t,e,r),s=Rb(t,o);return{id:pSe++,type:Ob,message:n,hasListeners:s}},pSe=0n,tV=(t,e)=>{if(!(e?.type!==Ob||e.hasListeners))for(let{id:r}of t)r!==void 0&&Tb[r].resolve({isDeadlock:!0,hasListeners:!1})},J9=async({wrappedMessage:t,anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:i})=>{if(t?.type!==Ob||!e.connected)return t;let{id:o,message:s}=t,a={id:o,type:nV,message:Rb(e,i)};try{await Ib({anyProcess:e,channel:r,isSubprocess:n,ipc:!0},a)}catch(c){i.emit("strict:error",c)}return s},Y9=t=>{if(t?.type!==nV)return!1;let{id:e,message:r}=t;return Tb[e]?.resolve({isDeadlock:!1,hasListeners:r}),!0},rV=async(t,e,r)=>{if(t?.type!==Ob)return;let n=Ci();Tb[t.id]=n;let i=new AbortController;try{let{isDeadlock:o,hasListeners:s}=await Promise.race([n,mSe(e,r,i)]);o&&N9(r),s||j9(r)}finally{i.abort(),delete Tb[t.id]}},Tb={},mSe=async(t,e,{signal:r})=>{Ia(t,1,r),await fSe(t,"disconnect",{signal:r}),M9(e)},Ob="execa:ipc:request",nV="execa:ipc:response"});var iV,oV,X9,Qf,Rb,hSe,$b=y(()=>{Pl();So();ds();xb();iV=(t,e,r)=>{Qf.has(t)||Qf.set(t,new Set);let n=Qf.get(t),i=Ci(),o=r?e.id:void 0,s={onMessageSent:i,id:o};return n.add(s),{outgoingMessages:n,outgoingMessage:s}},oV=({outgoingMessages:t,outgoingMessage:e})=>{t.delete(e),e.onMessageSent.resolve()},X9=async(t,e,r)=>{for(;!Rb(t,e)&&Qf.get(t)?.size>0;){let n=[...Qf.get(t)];tV(n,r),await Promise.all(n.map(({onMessageSent:i})=>i))}},Qf=new WeakMap,Rb=(t,e)=>e.listenerCount("message")>hSe(t),hSe=t=>Di.has(t)&&!vo(Di.get(t).options.buffer,"ipc")?1:0});import{promisify as gSe}from"node:util";var Ib,ySe,UR,_Se,zR,Pb=y(()=>{Il();$b();xb();Ib=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},i,{strict:o=!1}={})=>{let s="sendMessage";return Ol({methodName:s,isSubprocess:r,ipc:n,isConnected:t.connected}),ySe({anyProcess:t,channel:e,methodName:s,isSubprocess:r,message:i,strict:o})},ySe=async({anyProcess:t,channel:e,methodName:r,isSubprocess:n,message:i,strict:o})=>{let s=eV({anyProcess:t,channel:e,isSubprocess:n,message:i,strict:o}),a=iV(t,s,o);try{await UR({anyProcess:t,methodName:r,isSubprocess:n,wrappedMessage:s,message:i})}catch(c){throw Rl(t),c}finally{oV(a)}},UR=async({anyProcess:t,methodName:e,isSubprocess:r,wrappedMessage:n,message:i})=>{let o=_Se(t);try{await Promise.all([rV(n,t,r),o(n)])}catch(s){throw z9({error:s,methodName:e,isSubprocess:r}),U9({error:s,methodName:e,isSubprocess:r,message:i}),s}},_Se=t=>{if(zR.has(t))return zR.get(t);let e=gSe(t.send.bind(t));return zR.set(t,e),e},zR=new WeakMap});import{scheduler as bSe}from"node:timers/promises";var aV,cV,vSe,sV,Q9,lV,LR,qR,kb=y(()=>{Pb();Xf();Il();aV=(t,e)=>{let r="cancelSignal";return jR(r,!1,t.connected),UR({anyProcess:t,methodName:r,isSubprocess:!1,wrappedMessage:{type:lV,message:e},message:e})},cV=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>(await vSe({anyProcess:t,channel:e,isSubprocess:r,ipc:n}),qR.signal),vSe=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>{if(!sV){if(sV=!0,!n){L9();return}if(e===null){LR();return}fs(t,e,r),await bSe.yield()}},sV=!1,Q9=t=>t?.type!==lV?!1:(qR.abort(t.message),!0),lV="execa:ipc:cancel",LR=()=>{qR.abort(F9())},qR=new AbortController});var uV,dV,SSe,wSe,BR=y(()=>{DR();kb();mb();uV=({gracefulCancel:t,cancelSignal:e,ipc:r,serialization:n})=>{if(t){if(e===void 0)throw new Error("The `cancelSignal` option must be defined when setting the `gracefulCancel` option.");if(!r)throw new Error("The `ipc` option cannot be false when setting the `gracefulCancel` option.");if(n==="json")throw new Error("The `serialization` option cannot be 'json' when setting the `gracefulCancel` option.")}},dV=({subprocess:t,cancelSignal:e,gracefulCancel:r,forceKillAfterDelay:n,context:i,controller:o})=>r?[SSe({subprocess:t,cancelSignal:e,forceKillAfterDelay:n,context:i,controller:o})]:[],SSe=async({subprocess:t,cancelSignal:e,forceKillAfterDelay:r,context:n,controller:{signal:i}})=>{await hb(e,i);let o=wSe(e);throw await aV(t,o),CR({kill:t.kill,forceKillAfterDelay:r,context:n,controllerSignal:i}),n.terminationReason??="gracefulCancel",e.reason},wSe=({reason:t})=>{if(!(t instanceof DOMException))return t;let e=new Error(t.message);return Object.defineProperty(e,"stack",{value:t.stack,enumerable:!1,configurable:!0,writable:!0}),e}});import{setTimeout as xSe}from"node:timers/promises";var fV,pV,$Se,HR=y(()=>{Ra();fV=({timeout:t})=>{if(t!==void 0&&(!Number.isFinite(t)||t<0))throw new TypeError(`Expected the \`timeout\` option to be a non-negative integer, got \`${t}\` (${typeof t})`)},pV=(t,e,r,n)=>e===0||e===void 0?[]:[$Se(t,e,r,n)],$Se=async(t,e,r,{signal:n})=>{throw await xSe(e,void 0,{signal:n}),r.terminationReason??="timeout",t.kill(),new ti}});import{execPath as kSe,execArgv as ESe}from"node:process";import mV from"node:path";var hV,gV,GR=y(()=>{xl();hV=({options:t})=>{if(t.node===!1)throw new TypeError('The "node" option cannot be false with `execaNode()`.');return{options:{...t,node:!0}}},gV=(t,e,{node:r=!1,nodePath:n=kSe,nodeOptions:i=ESe.filter(c=>!c.startsWith("--inspect")),cwd:o,execPath:s,...a})=>{if(s!==void 0)throw new TypeError('The "execPath" option has been removed. Please use the "nodePath" option instead.');let c=wl(n,'The "nodePath" option'),l=mV.resolve(o,c),u={...a,nodePath:l,node:r,cwd:o};if(!r)return[t,e,u];if(mV.basename(t,".exe")==="node")throw new TypeError('When the "node" option is true, the first argument does not need to be "node".');return[l,[...i,t,...e],{ipc:!0,...u,shell:!1}]}});import{serialize as ASe}from"node:v8";var yV,TSe,OSe,RSe,_V,ZR=y(()=>{yV=({ipcInput:t,ipc:e,serialization:r})=>{if(t!==void 0){if(!e)throw new Error("The `ipcInput` option cannot be set unless the `ipc` option is `true`.");RSe[r](t)}},TSe=t=>{try{ASe(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with a structured clone.",{cause:e})}},OSe=t=>{try{JSON.stringify(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with JSON.",{cause:e})}},RSe={advanced:TSe,json:OSe},_V=async(t,e)=>{e!==void 0&&await t.sendMessage(e)}});var vV,ISe,sn,VR,PSe,bV,Cb,Pa=y(()=>{vV=({encoding:t})=>{if(VR.has(t))return;let e=PSe(t);if(e!==void 0)throw new TypeError(`Invalid option \`encoding: ${Cb(t)}\`. Please rename it to ${Cb(e)}.`);let r=[...VR].map(n=>Cb(n)).join(", ");throw new TypeError(`Invalid option \`encoding: ${Cb(t)}\`. -Please rename it to one of: ${r}.`)},TSe=new Set(["utf8","utf16le"]),on=new Set(["buffer","hex","base64","base64url","latin1","ascii"]),VR=new Set([...TSe,...on]),OSe=t=>{if(t===null)return"buffer";if(typeof t!="string")return;let e=t.toLowerCase();if(e in yV)return yV[e];if(VR.has(e))return e},yV={"utf-8":"utf8","utf-16le":"utf16le","ucs-2":"utf16le",ucs2:"utf16le",binary:"latin1"},Cb=t=>typeof t=="string"?`"${t}"`:String(t)});import{statSync as RSe}from"node:fs";import ISe from"node:path";import PSe from"node:process";var bV,vV,SV,WR=y(()=>{xl();bV=(t=vV())=>{let e=wl(t,'The "cwd" option');return ISe.resolve(e)},vV=()=>{try{return PSe.cwd()}catch(t){throw t.message=`The current directory does not exist. -${t.message}`,t}},SV=(t,e)=>{if(e===vV())return t;let r;try{r=RSe(e)}catch(n){return`The "cwd" option is invalid: ${e}. +Please rename it to one of: ${r}.`)},ISe=new Set(["utf8","utf16le"]),sn=new Set(["buffer","hex","base64","base64url","latin1","ascii"]),VR=new Set([...ISe,...sn]),PSe=t=>{if(t===null)return"buffer";if(typeof t!="string")return;let e=t.toLowerCase();if(e in bV)return bV[e];if(VR.has(e))return e},bV={"utf-8":"utf8","utf-16le":"utf16le","ucs-2":"utf16le",ucs2:"utf16le",binary:"latin1"},Cb=t=>typeof t=="string"?`"${t}"`:String(t)});import{statSync as CSe}from"node:fs";import DSe from"node:path";import NSe from"node:process";var SV,wV,xV,WR=y(()=>{xl();SV=(t=wV())=>{let e=wl(t,'The "cwd" option');return DSe.resolve(e)},wV=()=>{try{return NSe.cwd()}catch(t){throw t.message=`The current directory does not exist. +${t.message}`,t}},xV=(t,e)=>{if(e===wV())return t;let r;try{r=CSe(e)}catch(n){return`The "cwd" option is invalid: ${e}. ${n.message} ${t}`}return r.isDirectory()?t:`The "cwd" option is not a directory: ${e}. -${t}`}});import CSe from"node:path";import wV from"node:process";var xV,Db,DSe,NSe,KR=y(()=>{xV=St(n9(),1);u9();mb();Wf();NR();BR();HR();GR();ZR();Pa();WR();xl();So();Db=(t,e,r)=>{r.cwd=bV(r.cwd);let[n,i,o]=mV(t,e,r),{command:s,args:a,options:c}=xV.default._parse(n,i,o),l=ZG(c),u=DSe(l);return uV(u),_V(u),hV(u),R9(u),cV(u),u.shell=uR(u.shell),u.env=NSe(u),u.killSignal=k9(u.killSignal),u.forceKillAfterDelay=T9(u.forceKillAfterDelay),u.lines=u.lines.map((d,f)=>d&&!on.has(u.encoding)&&u.buffer[f]),wV.platform==="win32"&&CSe.basename(s,".exe")==="cmd"&&a.unshift("/q"),{file:s,commandArguments:a,options:u}},DSe=({extendEnv:t=!0,preferLocal:e=!1,cwd:r,localDir:n=r,encoding:i="utf8",reject:o=!0,cleanup:s=!0,all:a=!1,windowsHide:c=!0,killSignal:l="SIGTERM",forceKillAfterDelay:u=!0,gracefulCancel:d=!1,ipcInput:f,ipc:p=f!==void 0||d,serialization:m="advanced",...h})=>({...h,extendEnv:t,preferLocal:e,cwd:r,localDirectory:n,encoding:i,reject:o,cleanup:s,all:a,windowsHide:c,killSignal:l,forceKillAfterDelay:u,gracefulCancel:d,ipcInput:f,ipc:p,serialization:m}),NSe=({env:t,extendEnv:e,preferLocal:r,node:n,localDirectory:i,nodePath:o})=>{let s=e?{...wV.env,...t}:t;return r||n?l9({env:s,cwd:i,execPath:o,preferLocal:r,addExecPath:n}):s}});var Nb,JR=y(()=>{Nb=(t,e,r)=>r.shell&&e.length>0?[[t,...e].join(" "),[],r]:[t,e,r]});function Dl(t){if(typeof t=="string")return jSe(t);if(!(ArrayBuffer.isView(t)&&t.BYTES_PER_ELEMENT===1))throw new Error("Input must be a string or a Uint8Array");return MSe(t)}var jSe,MSe,$V,FSe,kV,LSe,YR=y(()=>{jSe=t=>t.at(-1)===$V?t.slice(0,t.at(-2)===kV?-2:-1):t,MSe=t=>t.at(-1)===FSe?t.subarray(0,t.at(-2)===LSe?-2:-1):t,$V=` -`,FSe=$V.codePointAt(0),kV="\r",LSe=kV.codePointAt(0)});function ri(t,{checkOpen:e=!0}={}){return t!==null&&typeof t=="object"&&(t.writable||t.readable||!e||t.writable===void 0&&t.readable===void 0)&&typeof t.pipe=="function"}function XR(t,{checkOpen:e=!0}={}){return ri(t,{checkOpen:e})&&(t.writable||!e)&&typeof t.write=="function"&&typeof t.end=="function"&&typeof t.writable=="boolean"&&typeof t.writableObjectMode=="boolean"&&typeof t.destroy=="function"&&typeof t.destroyed=="boolean"}function Ca(t,{checkOpen:e=!0}={}){return ri(t,{checkOpen:e})&&(t.readable||!e)&&typeof t.read=="function"&&typeof t.readable=="boolean"&&typeof t.readableObjectMode=="boolean"&&typeof t.destroy=="function"&&typeof t.destroyed=="boolean"}function QR(t,e){return XR(t,e)&&Ca(t,e)}var Da=y(()=>{});function EV(){return this[tI].next()}function AV(t){return this[tI].return(t)}function rI({preventCancel:t=!1}={}){let e=this.getReader(),r=new eI(e,t),n=Object.create(USe);return n[tI]=r,n}var zSe,eI,tI,USe,TV=y(()=>{zSe=Object.getPrototypeOf(Object.getPrototypeOf(async function*(){}).prototype),eI=class{#t;#r;#e=!1;#n=void 0;constructor(e,r){this.#t=e,this.#r=r}next(){let e=()=>this.#o();return this.#n=this.#n?this.#n.then(e,e):e(),this.#n}return(e){let r=()=>this.#i(e);return this.#n?this.#n.then(r,r):r()}async#o(){if(this.#e)return{done:!0,value:void 0};let e;try{e=await this.#t.read()}catch(r){throw this.#n=void 0,this.#e=!0,this.#t.releaseLock(),r}return e.done&&(this.#n=void 0,this.#e=!0,this.#t.releaseLock()),e}async#i(e){if(this.#e)return{done:!0,value:e};if(this.#e=!0,!this.#r){let r=this.#t.cancel(e);return this.#t.releaseLock(),await r,{done:!0,value:e}}return this.#t.releaseLock(),{done:!0,value:e}}},tI=Symbol();Object.defineProperty(EV,"name",{value:"next"});Object.defineProperty(AV,"name",{value:"return"});USe=Object.create(zSe,{next:{enumerable:!0,configurable:!0,writable:!0,value:EV},return:{enumerable:!0,configurable:!0,writable:!0,value:AV}})});var OV=y(()=>{});var RV=y(()=>{TV();OV()});var IV,qSe,BSe,HSe,Qf,nI=y(()=>{Da();RV();IV=t=>{if(Ca(t,{checkOpen:!1})&&Qf.on!==void 0)return BSe(t);if(typeof t?.[Symbol.asyncIterator]=="function")return t;if(qSe.call(t)==="[object ReadableStream]")return rI.call(t);throw new TypeError("The first argument must be a Readable, a ReadableStream, or an async iterable.")},{toString:qSe}=Object.prototype,BSe=async function*(t){let e=new AbortController,r={};HSe(t,e,r);try{for await(let[n]of Qf.on(t,"data",{signal:e.signal}))yield n}catch(n){if(r.error!==void 0)throw r.error;if(!e.signal.aborted)throw n}finally{t.destroy()}},HSe=async(t,e,r)=>{try{await Qf.finished(t,{cleanup:!0,readable:!0,writable:!1,error:!1})}catch(n){r.error=n}finally{e.abort()}},Qf={}});var Nl,GSe,DV,PV,ZSe,CV,Ni,ep=y(()=>{nI();Nl=async(t,{init:e,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,finalize:a},{maxBuffer:c=Number.POSITIVE_INFINITY}={})=>{let l=IV(t),u=e();u.length=0;try{for await(let d of l){let f=ZSe(d),p=r[f](d,u);DV({convertedChunk:p,state:u,getSize:n,truncateChunk:i,addChunk:o,maxBuffer:c})}return GSe({state:u,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,maxBuffer:c}),a(u)}catch(d){let f=typeof d=="object"&&d!==null?d:new Error(d);throw f.bufferedData=a(u),f}},GSe=({state:t,getSize:e,truncateChunk:r,addChunk:n,getFinalChunk:i,maxBuffer:o})=>{let s=i(t);s!==void 0&&DV({convertedChunk:s,state:t,getSize:e,truncateChunk:r,addChunk:n,maxBuffer:o})},DV=({convertedChunk:t,state:e,getSize:r,truncateChunk:n,addChunk:i,maxBuffer:o})=>{let s=r(t),a=e.length+s;if(a<=o){PV(t,e,i,a);return}let c=n(t,o-e.length);throw c!==void 0&&PV(c,e,i,o),new Ni},PV=(t,e,r,n)=>{e.contents=r(t,e,n),e.length=n},ZSe=t=>{let e=typeof t;if(e==="string")return"string";if(e!=="object"||t===null)return"others";if(globalThis.Buffer?.isBuffer(t))return"buffer";let r=CV.call(t);return r==="[object ArrayBuffer]"?"arrayBuffer":r==="[object DataView]"?"dataView":Number.isInteger(t.byteLength)&&Number.isInteger(t.byteOffset)&&CV.call(t.buffer)==="[object ArrayBuffer]"?"typedArray":"others"},{toString:CV}=Object.prototype,Ni=class extends Error{name="MaxBufferError";constructor(){super("maxBuffer exceeded")}}});var wo,tp,jb,Mb,Fb,Lb=y(()=>{wo=t=>t,tp=()=>{},jb=({contents:t})=>t,Mb=t=>{throw new Error(`Streams in object mode are not supported: ${String(t)}`)},Fb=t=>t.length});async function zb(t,e){return Nl(t,JSe,e)}var VSe,WSe,KSe,JSe,NV=y(()=>{ep();Lb();VSe=()=>({contents:[]}),WSe=()=>1,KSe=(t,{contents:e})=>(e.push(t),e),JSe={init:VSe,convertChunk:{string:wo,buffer:wo,arrayBuffer:wo,dataView:wo,typedArray:wo,others:wo},getSize:WSe,truncateChunk:tp,addChunk:KSe,getFinalChunk:tp,finalize:jb}});async function Ub(t,e){return Nl(t,owe,e)}var YSe,XSe,QSe,jV,MV,ewe,twe,rwe,nwe,LV,FV,iwe,zV,owe,UV=y(()=>{ep();Lb();YSe=()=>({contents:new ArrayBuffer(0)}),XSe=t=>QSe.encode(t),QSe=new TextEncoder,jV=t=>new Uint8Array(t),MV=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),ewe=(t,e)=>t.slice(0,e),twe=(t,{contents:e,length:r},n)=>{let i=zV()?nwe(e,n):rwe(e,n);return new Uint8Array(i).set(t,r),i},rwe=(t,e)=>{if(e<=t.byteLength)return t;let r=new ArrayBuffer(LV(e));return new Uint8Array(r).set(new Uint8Array(t),0),r},nwe=(t,e)=>{if(e<=t.maxByteLength)return t.resize(e),t;let r=new ArrayBuffer(e,{maxByteLength:LV(e)});return new Uint8Array(r).set(new Uint8Array(t),0),r},LV=t=>FV**Math.ceil(Math.log(t)/Math.log(FV)),FV=2,iwe=({contents:t,length:e})=>zV()?t:t.slice(0,e),zV=()=>"resize"in ArrayBuffer.prototype,owe={init:YSe,convertChunk:{string:XSe,buffer:jV,arrayBuffer:jV,dataView:MV,typedArray:MV,others:Mb},getSize:Fb,truncateChunk:ewe,addChunk:twe,getFinalChunk:tp,finalize:iwe}});async function Bb(t,e){return Nl(t,uwe,e)}var swe,qb,awe,cwe,lwe,uwe,qV=y(()=>{ep();Lb();swe=()=>({contents:"",textDecoder:new TextDecoder}),qb=(t,{textDecoder:e})=>e.decode(t,{stream:!0}),awe=(t,{contents:e})=>e+t,cwe=(t,e)=>t.slice(0,e),lwe=({textDecoder:t})=>{let e=t.decode();return e===""?void 0:e},uwe={init:swe,convertChunk:{string:wo,buffer:qb,arrayBuffer:qb,dataView:qb,typedArray:qb,others:Mb},getSize:Fb,truncateChunk:cwe,addChunk:awe,getFinalChunk:lwe,finalize:jb}});var BV=y(()=>{NV();UV();qV();ep()});import{on as dwe}from"node:events";import{finished as fwe}from"node:stream/promises";var Hb=y(()=>{nI();BV();Object.assign(Qf,{on:dwe,finished:fwe})});var HV,pwe,GV,ZV,mwe,VV,WV,Gb,Na=y(()=>{Hb();bo();So();HV=({error:t,stream:e,readableObjectMode:r,lines:n,encoding:i,fdNumber:o})=>{if(!(t instanceof Ni))throw t;if(o==="all")return t;let s=pwe(r,n,i);throw t.maxBufferInfo={fdNumber:o,unit:s},e.destroy(),t},pwe=(t,e,r)=>t?"objects":e?"lines":r==="buffer"?"bytes":"characters",GV=(t,e,r)=>{if(e.length!==r)return;let n=new Ni;throw n.maxBufferInfo={fdNumber:"ipc"},n},ZV=(t,e)=>{let{streamName:r,threshold:n,unit:i}=mwe(t,e);return`Command's ${r} was larger than ${n} ${i}`},mwe=(t,e)=>{if(t?.maxBufferInfo===void 0)return{streamName:"output",threshold:e[1],unit:"bytes"};let{maxBufferInfo:{fdNumber:r,unit:n}}=t;delete t.maxBufferInfo;let i=vo(e,r);return r==="ipc"?{streamName:"IPC output",threshold:i,unit:"messages"}:{streamName:Y_(r),threshold:i,unit:n}},VV=(t,e,r)=>t?.code==="ENOBUFS"&&e!==null&&e.some(n=>n!==null&&n.length>Gb(r)),WV=(t,e,r)=>{if(!e)return t;let n=Gb(r);return t.length>n?t.slice(0,n):t},Gb=([,t])=>t});import{inspect as hwe}from"node:util";var JV,gwe,ywe,_we,bwe,vwe,KV,YV=y(()=>{YR();nn();WR();eb();Na();Wf();Ra();JV=({stdio:t,all:e,ipcOutput:r,originalError:n,signal:i,signalDescription:o,exitCode:s,escapedCommand:a,timedOut:c,isCanceled:l,isGracefullyCanceled:u,isMaxBuffer:d,isForcefullyTerminated:f,forceKillAfterDelay:p,killSignal:m,maxBuffer:h,timeout:g,cwd:b})=>{let _=n?.code,S=gwe({originalError:n,timedOut:c,timeout:g,isMaxBuffer:d,maxBuffer:h,errorCode:_,signal:i,signalDescription:o,exitCode:s,isCanceled:l,isGracefullyCanceled:u,isForcefullyTerminated:f,forceKillAfterDelay:p,killSignal:m}),x=_we(n,b),w=x===void 0?"":` -${x}`,O=`${S}: ${a}${w}`,T=e===void 0?[t[2],t[1]]:[e],A=[O,...T,...t.slice(3),r.map(D=>bwe(D)).join(` -`)].map(D=>Hf(Dl(vwe(D)))).filter(Boolean).join(` - -`);return{originalMessage:x,shortMessage:O,message:A}},gwe=({originalError:t,timedOut:e,timeout:r,isMaxBuffer:n,maxBuffer:i,errorCode:o,signal:s,signalDescription:a,exitCode:c,isCanceled:l,isGracefullyCanceled:u,isForcefullyTerminated:d,forceKillAfterDelay:f,killSignal:p})=>{let m=ywe(d,f);return e?`Command timed out after ${r} milliseconds${m}`:u?s===void 0?`Command was gracefully canceled with exit code ${c}`:d?`Command was gracefully canceled${m}`:`Command was gracefully canceled with ${s} (${a})`:l?`Command was canceled${m}`:n?`${ZV(t,i)}${m}`:o!==void 0?`Command failed with ${o}${m}`:d?`Command was killed with ${p} (${pb(p)})${m}`:s!==void 0?`Command was killed with ${s} (${a})`:c!==void 0?`Command failed with exit code ${c}`:"Command failed"},ywe=(t,e)=>t?` and was forcefully terminated after ${e} milliseconds`:"",_we=(t,e)=>{if(t instanceof ei)return;let r=p9(t)?t.originalMessage:String(t?.message??t),n=Hf(SV(r,e));return n===""?void 0:n},bwe=t=>typeof t=="string"?t:hwe(t),vwe=t=>Array.isArray(t)?t.map(e=>Dl(KV(e))).filter(Boolean).join(` -`):KV(t),KV=t=>typeof t=="string"?t:qt(t)?K_(t):""});var Zb,jl,rp,Swe,XV,wwe,np=y(()=>{Wf();sb();Ra();YV();Zb=({command:t,escapedCommand:e,stdio:r,all:n,ipcOutput:i,options:{cwd:o},startTime:s})=>XV({command:t,escapedCommand:e,cwd:o,durationMs:vR(s),failed:!1,timedOut:!1,isCanceled:!1,isGracefullyCanceled:!1,isTerminated:!1,isMaxBuffer:!1,isForcefullyTerminated:!1,exitCode:0,stdout:r[1],stderr:r[2],all:n,stdio:r,ipcOutput:i,pipedFrom:[]}),jl=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:s})=>rp({error:t,command:e,escapedCommand:r,startTime:o,timedOut:!1,isCanceled:!1,isGracefullyCanceled:!1,isMaxBuffer:!1,isForcefullyTerminated:!1,stdio:Array.from({length:n.length}),ipcOutput:[],options:i,isSync:s}),rp=({error:t,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,stdio:d,all:f,ipcOutput:p,options:{timeoutDuration:m,timeout:h=m,forceKillAfterDelay:g,killSignal:b,cwd:_,maxBuffer:S},isSync:x})=>{let{exitCode:w,signal:O,signalDescription:T}=wwe(l,u),{originalMessage:A,shortMessage:D,message:$}=JV({stdio:d,all:f,ipcOutput:p,originalError:t,signal:O,signalDescription:T,exitCode:w,escapedCommand:r,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,forceKillAfterDelay:g,killSignal:b,maxBuffer:S,timeout:h,cwd:_}),re=d9(t,$,x);return Object.assign(re,Swe({error:re,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:w,signal:O,signalDescription:T,stdio:d,all:f,ipcOutput:p,cwd:_,originalMessage:A,shortMessage:D})),re},Swe=({error:t,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,signalDescription:d,stdio:f,all:p,ipcOutput:m,cwd:h,originalMessage:g,shortMessage:b})=>XV({shortMessage:b,originalMessage:g,command:e,escapedCommand:r,cwd:h,durationMs:vR(n),failed:!0,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isTerminated:u!==void 0,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,signalDescription:d,code:t.cause?.code,stdout:f[1],stderr:f[2],all:p,stdio:f,ipcOutput:m,pipedFrom:[]}),XV=t=>Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0)),wwe=(t,e)=>{let r=t===null?void 0:t,n=e===null?void 0:e,i=n===void 0?void 0:pb(e);return{exitCode:r,signal:n,signalDescription:i}}});function xwe(t){return{days:Math.trunc(t/864e5),hours:Math.trunc(t/36e5%24),minutes:Math.trunc(t/6e4%60),seconds:Math.trunc(t/1e3%60),milliseconds:Math.trunc(t%1e3),microseconds:Math.trunc(QV(t*1e3)%1e3),nanoseconds:Math.trunc(QV(t*1e6)%1e3)}}function $we(t){return{days:t/86400000n,hours:t/3600000n%24n,minutes:t/60000n%60n,seconds:t/1000n%60n,milliseconds:t%1000n,microseconds:0n,nanoseconds:0n}}function iI(t){switch(typeof t){case"number":{if(Number.isFinite(t))return xwe(t);break}case"bigint":return $we(t)}throw new TypeError("Expected a finite number or bigint")}var QV,eW=y(()=>{QV=t=>Number.isFinite(t)?t:0});function oI(t,e){let r=typeof t=="bigint";if(!r&&!Number.isFinite(t))throw new TypeError("Expected a finite number or bigint");e={...e};let n=t<0?"-":"";t=t<0?-t:t,e.colonNotation&&(e.compact=!1,e.formatSubMilliseconds=!1,e.separateMilliseconds=!1,e.verbose=!1),e.compact&&(e.unitCount=1,e.secondsDecimalDigits=0,e.millisecondsDecimalDigits=0);let i=[],o=(u,d)=>{let f=Math.floor(u*10**d+Awe);return(Math.round(f)/10**d).toFixed(d)},s=(u,d,f,p)=>{if(!((i.length===0||!e.colonNotation)&&kwe(u)&&!(e.colonNotation&&f==="m"))){if(p??=String(u),e.colonNotation){let m=p.includes(".")?p.split(".")[0].length:p.length,h=i.length>0?2:1;p="0".repeat(Math.max(0,h-m))+p}else p+=e.verbose?" "+Ewe(d,u):f;i.push(p)}},a=iI(t),c=BigInt(a.days);if(e.hideYearAndDays?s(BigInt(c)*24n+BigInt(a.hours),"hour","h"):(e.hideYear?s(c,"day","d"):(s(c/365n,"year","y"),s(c%365n,"day","d")),s(Number(a.hours),"hour","h")),s(Number(a.minutes),"minute","m"),!e.hideSeconds)if(e.separateMilliseconds||e.formatSubMilliseconds||!e.colonNotation&&t<1e3&&!e.subSecondsAsDecimals){let u=Number(a.seconds),d=Number(a.milliseconds),f=Number(a.microseconds),p=Number(a.nanoseconds);if(s(u,"second","s"),e.formatSubMilliseconds)s(d,"millisecond","ms"),s(f,"microsecond","\xB5s"),s(p,"nanosecond","ns");else{let m=d+f/1e3+p/1e6,h=typeof e.millisecondsDecimalDigits=="number"?e.millisecondsDecimalDigits:0,g=m>=1?Math.round(m):Math.ceil(m),b=h?m.toFixed(h):g;s(Number.parseFloat(b),"millisecond","ms",b)}}else{let u=(r?Number(t%Twe):t)/1e3%60,d=typeof e.secondsDecimalDigits=="number"?e.secondsDecimalDigits:1,f=o(u,d),p=e.keepDecimalsOnWholeSeconds?f:f.replace(/\.0+$/,"");s(Number.parseFloat(p),"second","s",p)}if(i.length===0)return n+"0"+(e.verbose?" milliseconds":"ms");let l=e.colonNotation?":":" ";return typeof e.unitCount=="number"&&(i=i.slice(0,Math.max(e.unitCount,1))),n+i.join(l)}var kwe,Ewe,Awe,Twe,tW=y(()=>{eW();kwe=t=>t===0||t===0n,Ewe=(t,e)=>e===1||e===1n?t:`${t}s`,Awe=1e-7,Twe=24n*60n*60n*1000n});var rW,nW=y(()=>{El();rW=(t,e)=>{t.failed&&Pi({type:"error",verboseMessage:t.shortMessage,verboseInfo:e,result:t})}});var iW,Owe,oW=y(()=>{tW();ls();El();nW();iW=(t,e)=>{$l(e)&&(rW(t,e),Owe(t,e))},Owe=(t,e)=>{let r=`(done in ${oI(t.durationMs)})`;Pi({type:"duration",verboseMessage:r,verboseInfo:e,result:t})}});var Ml,Vb=y(()=>{oW();Ml=(t,e,{reject:r})=>{if(iW(t,e),t.failed&&r)throw t;return t}});var cW,Rwe,Iwe,lW,uW,sW,Pwe,sI,aW,ja,dW,Cwe,Wb,fW,Dwe,Nwe,aI,pW,jwe,mW,Kb,Mwe,cI,Fwe,Lwe,hW,On,Jb,lI,gW,yW,ps,Sr=y(()=>{Da();yo();nn();cW=(t,e)=>ja(t)?"asyncGenerator":dW(t)?"generator":Wb(t)?"fileUrl":Dwe(t)?"filePath":Mwe(t)?"webStream":ri(t,{checkOpen:!1})?"native":qt(t)?"uint8Array":Fwe(t)?"asyncIterable":Lwe(t)?"iterable":cI(t)?lW({transform:t},e):Cwe(t)?Rwe(t,e):"native",Rwe=(t,e)=>QR(t.transform,{checkOpen:!1})?Iwe(t,e):cI(t.transform)?lW(t,e):Pwe(t,e),Iwe=(t,e)=>(uW(t,e,"Duplex stream"),"duplex"),lW=(t,e)=>(uW(t,e,"web TransformStream"),"webTransform"),uW=({final:t,binary:e,objectMode:r},n,i)=>{sW(t,`${n}.final`,i),sW(e,`${n}.binary`,i),sI(r,`${n}.objectMode`)},sW=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${e}\` option can only be defined when using a generator, not a ${r}.`)},Pwe=({transform:t,final:e,binary:r,objectMode:n},i)=>{if(t!==void 0&&!aW(t))throw new TypeError(`The \`${i}.transform\` option must be a generator, a Duplex stream or a web TransformStream.`);if(QR(e,{checkOpen:!1}))throw new TypeError(`The \`${i}.final\` option must not be a Duplex stream.`);if(cI(e))throw new TypeError(`The \`${i}.final\` option must not be a web TransformStream.`);if(e!==void 0&&!aW(e))throw new TypeError(`The \`${i}.final\` option must be a generator.`);return sI(r,`${i}.binary`),sI(n,`${i}.objectMode`),ja(t)||ja(e)?"asyncGenerator":"generator"},sI=(t,e)=>{if(t!==void 0&&typeof t!="boolean")throw new TypeError(`The \`${e}\` option must use a boolean.`)},aW=t=>ja(t)||dW(t),ja=t=>Object.prototype.toString.call(t)==="[object AsyncGeneratorFunction]",dW=t=>Object.prototype.toString.call(t)==="[object GeneratorFunction]",Cwe=t=>Ot(t)&&(t.transform!==void 0||t.final!==void 0),Wb=t=>Object.prototype.toString.call(t)==="[object URL]",fW=t=>Wb(t)&&t.protocol!=="file:",Dwe=t=>Ot(t)&&Object.keys(t).length>0&&Object.keys(t).every(e=>Nwe.has(e))&&aI(t.file),Nwe=new Set(["file","append"]),aI=t=>typeof t=="string",pW=(t,e)=>t==="native"&&typeof e=="string"&&!jwe.has(e),jwe=new Set(["ipc","ignore","inherit","overlapped","pipe"]),mW=t=>Object.prototype.toString.call(t)==="[object ReadableStream]",Kb=t=>Object.prototype.toString.call(t)==="[object WritableStream]",Mwe=t=>mW(t)||Kb(t),cI=t=>mW(t?.readable)&&Kb(t?.writable),Fwe=t=>hW(t)&&typeof t[Symbol.asyncIterator]=="function",Lwe=t=>hW(t)&&typeof t[Symbol.iterator]=="function",hW=t=>typeof t=="object"&&t!==null,On=new Set(["generator","asyncGenerator","duplex","webTransform"]),Jb=new Set(["fileUrl","filePath","fileNumber"]),lI=new Set(["fileUrl","filePath"]),gW=new Set([...lI,"webStream","nodeStream"]),yW=new Set(["webTransform","duplex"]),ps={generator:"a generator",asyncGenerator:"an async generator",fileUrl:"a file URL",filePath:"a file path string",fileNumber:"a file descriptor number",webStream:"a web stream",nodeStream:"a Node.js stream",webTransform:"a web TransformStream",duplex:"a Duplex stream",native:"any value",iterable:"an iterable",asyncIterable:"an async iterable",string:"a string",uint8Array:"a Uint8Array"}});var uI,zwe,Uwe,_W,dI=y(()=>{Sr();uI=(t,e,r,n)=>n==="output"?zwe(t,e,r):Uwe(t,e,r),zwe=(t,e,r)=>{let n=e!==0&&r[e-1].value.readableObjectMode;return{writableObjectMode:n,readableObjectMode:t??n}},Uwe=(t,e,r)=>{let n=e===0?t===!0:r[e-1].value.readableObjectMode,i=e!==r.length-1&&(t??n);return{writableObjectMode:n,readableObjectMode:i}},_W=(t,e)=>{let r=t.findLast(({type:n})=>On.has(n));return r===void 0?!1:e==="input"?r.value.writableObjectMode:r.value.readableObjectMode}});var bW,qwe,Bwe,Hwe,Gwe,Zwe,Vwe,vW=y(()=>{yo();Pa();Sr();dI();bW=(t,e,r,n)=>[...t.filter(({type:i})=>!On.has(i)),...qwe(t,e,r,n)],qwe=(t,e,r,{encoding:n})=>{let i=t.filter(({type:s})=>On.has(s)),o=Array.from({length:i.length});for(let[s,a]of Object.entries(i))o[s]=Bwe({stdioItem:a,index:Number(s),newTransforms:o,optionName:e,direction:r,encoding:n});return Vwe(o,r)},Bwe=({stdioItem:t,stdioItem:{type:e},index:r,newTransforms:n,optionName:i,direction:o,encoding:s})=>e==="duplex"?Hwe({stdioItem:t,optionName:i}):e==="webTransform"?Gwe({stdioItem:t,index:r,newTransforms:n,direction:o}):Zwe({stdioItem:t,index:r,newTransforms:n,direction:o,encoding:s}),Hwe=({stdioItem:t,stdioItem:{value:{transform:e,transform:{writableObjectMode:r,readableObjectMode:n},objectMode:i=n}},optionName:o})=>{if(i&&!n)throw new TypeError(`The \`${o}.objectMode\` option can only be \`true\` if \`new Duplex({objectMode: true})\` is used.`);if(!i&&n)throw new TypeError(`The \`${o}.objectMode\` option cannot be \`false\` if \`new Duplex({objectMode: true})\` is used.`);return{...t,value:{transform:e,writableObjectMode:r,readableObjectMode:n}}},Gwe=({stdioItem:t,stdioItem:{value:e},index:r,newTransforms:n,direction:i})=>{let{transform:o,objectMode:s}=Ot(e)?e:{transform:e},{writableObjectMode:a,readableObjectMode:c}=uI(s,r,n,i);return{...t,value:{transform:o,writableObjectMode:a,readableObjectMode:c}}},Zwe=({stdioItem:t,stdioItem:{value:e},index:r,newTransforms:n,direction:i,encoding:o})=>{let{transform:s,final:a,binary:c=!1,preserveNewlines:l=!1,objectMode:u}=Ot(e)?e:{transform:e},d=c||on.has(o),{writableObjectMode:f,readableObjectMode:p}=uI(u,r,n,i);return{...t,value:{transform:s,final:a,binary:d,preserveNewlines:l,writableObjectMode:f,readableObjectMode:p}}},Vwe=(t,e)=>e==="input"?t.reverse():t});import fI from"node:process";var SW,Wwe,Kwe,Fl,pI,wW,Jwe,Ywe,xW=y(()=>{Da();Sr();SW=(t,e,r)=>{let n=t.map(i=>Wwe(i,e));if(n.includes("input")&&n.includes("output"))throw new TypeError(`The \`${r}\` option must not be an array of both readable and writable values.`);return n.find(Boolean)??Ywe},Wwe=({type:t,value:e},r)=>Kwe[r]??wW[t](e),Kwe=["input","output","output"],Fl=()=>{},pI=()=>"input",wW={generator:Fl,asyncGenerator:Fl,fileUrl:Fl,filePath:Fl,iterable:pI,asyncIterable:pI,uint8Array:pI,webStream:t=>Kb(t)?"output":"input",nodeStream(t){return Ca(t,{checkOpen:!1})?XR(t,{checkOpen:!1})?void 0:"input":"output"},webTransform:Fl,duplex:Fl,native(t){let e=Jwe(t);if(e!==void 0)return e;if(ri(t,{checkOpen:!1}))return wW.nodeStream(t)}},Jwe=t=>{if([0,fI.stdin].includes(t))return"input";if([1,2,fI.stdout,fI.stderr].includes(t))return"output"},Ywe="output"});var $W,kW=y(()=>{$W=(t,e)=>e&&!t.includes("ipc")?[...t,"ipc"]:t});var EW,Xwe,Qwe,AW,exe,txe,TW=y(()=>{bo();kW();ls();EW=({stdio:t,ipc:e,buffer:r,...n},i,o)=>{let s=Xwe(t,n).map((a,c)=>AW(a,c));return o?exe(s,r,i):$W(s,e)},Xwe=(t,e)=>{if(t===void 0)return Tn.map(n=>e[n]);if(Qwe(e))throw new Error(`It's not possible to provide \`stdio\` in combination with one of ${Tn.map(n=>`\`${n}\``).join(", ")}`);if(typeof t=="string")return[t,t,t];if(!Array.isArray(t))throw new TypeError(`Expected \`stdio\` to be of type \`string\` or \`Array\`, got \`${typeof t}\``);let r=Math.max(t.length,Tn.length);return Array.from({length:r},(n,i)=>t[i])},Qwe=t=>Tn.some(e=>t[e]!==void 0),AW=(t,e)=>Array.isArray(t)?t.map(r=>AW(r,e)):t??(e>=Tn.length?"ignore":"pipe"),exe=(t,e,r)=>t.map((n,i)=>!e[i]&&i!==0&&!kl(r,i)&&txe(n)?"ignore":n),txe=t=>t==="pipe"||Array.isArray(t)&&t.every(e=>e==="pipe")});import{readFileSync as rxe}from"node:fs";import nxe from"node:tty";var RW,ixe,oxe,sxe,axe,OW,IW=y(()=>{Da();bo();nn();ds();RW=({stdioItem:t,stdioItem:{type:e},isStdioArray:r,fdNumber:n,direction:i,isSync:o})=>!r||e!=="native"?t:o?ixe({stdioItem:t,fdNumber:n,direction:i}):axe({stdioItem:t,fdNumber:n}),ixe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n,direction:i})=>{let o=oxe({value:e,optionName:r,fdNumber:n,direction:i});if(o!==void 0)return o;if(ri(e,{checkOpen:!1}))throw new TypeError(`The \`${r}: Stream\` option cannot both be an array and include a stream with synchronous methods.`);return t},oxe=({value:t,optionName:e,fdNumber:r,direction:n})=>{let i=sxe(t,r);if(i!==void 0){if(n==="output")return{type:"fileNumber",value:i,optionName:e};if(nxe.isatty(i))throw new TypeError(`The \`${e}: ${yb(t)}\` option is invalid: it cannot be a TTY with synchronous methods.`);return{type:"uint8Array",value:_o(rxe(i)),optionName:e}}},sxe=(t,e)=>{if(t==="inherit")return e;if(typeof t=="number")return t;let r=J_.indexOf(t);if(r!==-1)return r},axe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n})=>e==="inherit"?{type:"nodeStream",value:OW(n,e,r),optionName:r}:typeof e=="number"?{type:"nodeStream",value:OW(e,e,r),optionName:r}:ri(e,{checkOpen:!1})?{type:"nodeStream",value:e,optionName:r}:t,OW=(t,e,r)=>{let n=J_[t];if(n===void 0)throw new TypeError(`The \`${r}: ${e}\` option is invalid: no such standard stream.`);return n}});var PW,cxe,lxe,uxe,dxe,CW=y(()=>{Da();nn();Sr();PW=({input:t,inputFile:e},r)=>r===0?[...cxe(t),...uxe(e)]:[],cxe=t=>t===void 0?[]:[{type:lxe(t),value:t,optionName:"input"}],lxe=t=>{if(Ca(t,{checkOpen:!1}))return"nodeStream";if(typeof t=="string")return"string";if(qt(t))return"uint8Array";throw new Error("The `input` option must be a string, a Uint8Array or a Node.js Readable stream.")},uxe=t=>t===void 0?[]:[{...dxe(t),optionName:"inputFile"}],dxe=t=>{if(Wb(t))return{type:"fileUrl",value:t};if(aI(t))return{type:"filePath",value:{file:t}};throw new Error("The `inputFile` option must be a file path string or a file URL.")}});var DW,NW,fxe,pxe,jW,mxe,hxe,MW,FW=y(()=>{Sr();DW=t=>t.filter((e,r)=>t.every((n,i)=>e.value!==n.value||r>=i||e.type==="generator"||e.type==="asyncGenerator")),NW=({stdioItem:{type:t,value:e,optionName:r},direction:n,fileDescriptors:i,isSync:o})=>{let s=fxe(i,t);if(s.length!==0){if(o){pxe({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});return}if(gW.has(t))return jW({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});yW.has(t)&&hxe({otherStdioItems:s,type:t,value:e,optionName:r})}},fxe=(t,e)=>t.flatMap(({direction:r,stdioItems:n})=>n.filter(i=>i.type===e).map((i=>({...i,direction:r})))),pxe=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{lI.has(e)&&jW({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})},jW=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{let o=t.filter(a=>mxe(a,r));if(o.length===0)return;let s=o.find(a=>a.direction!==i);return MW(s,n,e),i==="output"?o[0].stream:void 0},mxe=({type:t,value:e},r)=>t==="filePath"?e.file===r.file:t==="fileUrl"?e.href===r.href:e===r,hxe=({otherStdioItems:t,type:e,value:r,optionName:n})=>{let i=t.find(({value:{transform:o}})=>o===r.transform);MW(i,n,e)},MW=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${t.optionName}\` and \`${e}\` options must not target ${ps[r]} that is the same.`)}});var Yb,gxe,yxe,_xe,bxe,vxe,Sxe,wxe,xxe,$xe,kxe,Exe,mI,Axe,Xb=y(()=>{bo();vW();dI();Sr();xW();TW();IW();CW();FW();Yb=(t,e,r,n)=>{let o=EW(e,r,n).map((a,c)=>gxe({stdioOption:a,fdNumber:c,options:e,isSync:n})),s=$xe({initialFileDescriptors:o,addProperties:t,options:e,isSync:n});return e.stdio=s.map(({stdioItems:a})=>Axe(a)),s},gxe=({stdioOption:t,fdNumber:e,options:r,isSync:n})=>{let i=Y_(e),{stdioItems:o,isStdioArray:s}=yxe({stdioOption:t,fdNumber:e,options:r,optionName:i}),a=SW(o,e,i),c=o.map(d=>RW({stdioItem:d,isStdioArray:s,fdNumber:e,direction:a,isSync:n})),l=bW(c,i,a,r),u=_W(l,a);return xxe(l,u),{direction:a,objectMode:u,stdioItems:l}},yxe=({stdioOption:t,fdNumber:e,options:r,optionName:n})=>{let o=[...(Array.isArray(t)?t:[t]).map(c=>_xe(c,n)),...PW(r,e)],s=DW(o),a=s.length>1;return bxe(s,a,n),Sxe(s),{stdioItems:s,isStdioArray:a}},_xe=(t,e)=>({type:cW(t,e),value:t,optionName:e}),bxe=(t,e,r)=>{if(t.length===0)throw new TypeError(`The \`${r}\` option must not be an empty array.`);if(e){for(let{value:n,optionName:i}of t)if(vxe.has(n))throw new Error(`The \`${i}\` option must not include \`${n}\`.`)}},vxe=new Set(["ignore","ipc"]),Sxe=t=>{for(let e of t)wxe(e)},wxe=({type:t,value:e,optionName:r})=>{if(fW(e))throw new TypeError(`The \`${r}: URL\` option must use the \`file:\` scheme. -For example, you can use the \`pathToFileURL()\` method of the \`url\` core module.`);if(pW(t,e))throw new TypeError(`The \`${r}: { file: '...' }\` option must be used instead of \`${r}: '...'\`.`)},xxe=(t,e)=>{if(!e)return;let r=t.find(({type:n})=>Jb.has(n));if(r!==void 0)throw new TypeError(`The \`${r.optionName}\` option cannot use both files and transforms in objectMode.`)},$xe=({initialFileDescriptors:t,addProperties:e,options:r,isSync:n})=>{let i=[];try{for(let o of t)i.push(kxe({fileDescriptor:o,fileDescriptors:i,addProperties:e,options:r,isSync:n}));return i}catch(o){throw mI(i),o}},kxe=({fileDescriptor:{direction:t,objectMode:e,stdioItems:r},fileDescriptors:n,addProperties:i,options:o,isSync:s})=>{let a=r.map(c=>Exe({stdioItem:c,addProperties:i,direction:t,options:o,fileDescriptors:n,isSync:s}));return{direction:t,objectMode:e,stdioItems:a}},Exe=({stdioItem:t,addProperties:e,direction:r,options:n,fileDescriptors:i,isSync:o})=>{let s=NW({stdioItem:t,direction:r,fileDescriptors:i,isSync:o});return s!==void 0?{...t,stream:s}:{...t,...e[r][t.type](t,n)}},mI=t=>{for(let{stdioItems:e}of t)for(let{stream:r}of e)r!==void 0&&!Qn(r)&&r.destroy()},Axe=t=>{if(t.length>1)return t.some(({value:n})=>n==="overlapped")?"overlapped":"pipe";let[{type:e,value:r}]=t;return e==="native"?r:"pipe"}});import{readFileSync as LW}from"node:fs";var UW,ji,Txe,qW,zW,Oxe,BW=y(()=>{nn();Xb();Sr();UW=(t,e)=>Yb(Oxe,t,e,!0),ji=({type:t,optionName:e})=>{qW(e,ps[t])},Txe=({optionName:t,value:e})=>((e==="ipc"||e==="overlapped")&&qW(t,`"${e}"`),{}),qW=(t,e)=>{throw new TypeError(`The \`${t}\` option cannot be ${e} with synchronous methods.`)},zW={generator(){},asyncGenerator:ji,webStream:ji,nodeStream:ji,webTransform:ji,duplex:ji,asyncIterable:ji,native:Txe},Oxe={input:{...zW,fileUrl:({value:t})=>({contents:[_o(LW(t))]}),filePath:({value:{file:t}})=>({contents:[_o(LW(t))]}),fileNumber:ji,iterable:({value:t})=>({contents:[...t]}),string:({value:t})=>({contents:[t]}),uint8Array:({value:t})=>({contents:[t]})},output:{...zW,fileUrl:({value:t})=>({path:t}),filePath:({value:{file:t,append:e}})=>({path:t,append:e}),fileNumber:({value:t})=>({path:t}),iterable:ji,string:ji,uint8Array:ji}}});var xo,hI,ip=y(()=>{YR();xo=(t,{stripFinalNewline:e},r)=>hI(e,r)&&t!==void 0&&!Array.isArray(t)?Dl(t):t,hI=(t,e)=>e==="all"?t[1]||t[2]:t[e]});var Qb,yI,HW,GW,Rxe,Ixe,Pxe,ZW,Cxe,gI,Dxe,Nxe,jxe,ev=y(()=>{Qb=(t,e,r,n)=>t||r?void 0:GW(e,n),yI=(t,e,r)=>r?t.flatMap(n=>HW(n,e)):HW(t,e),HW=(t,e)=>{let{transform:r,final:n}=GW(e,{});return[...r(t),...n()]},GW=(t,e)=>(e.previousChunks="",{transform:Rxe.bind(void 0,e,t),final:Pxe.bind(void 0,e)}),Rxe=function*(t,e,r){if(typeof r!="string"){yield r;return}let{previousChunks:n}=t,i=-1;for(let o=0;o0&&(a=gI(n,a),n=""),yield a,i=o}i!==r.length-1&&(n=gI(n,r.slice(i+1))),t.previousChunks=n},Ixe=(t,e,r,n)=>r?0:(n.isWindowsNewline=e!==0&&t[e-1]==="\r",n.isWindowsNewline?2:1),Pxe=function*({previousChunks:t}){t.length>0&&(yield t)},ZW=({binary:t,preserveNewlines:e,readableObjectMode:r,state:n})=>t||e||r?void 0:{transform:Cxe.bind(void 0,n)},Cxe=function*({isWindowsNewline:t=!1},e){let{unixNewline:r,windowsNewline:n,LF:i,concatBytes:o}=typeof e=="string"?Dxe:jxe;if(e.at(-1)===i){yield e;return}yield o(e,t?n:r)},gI=(t,e)=>`${t}${e}`,Dxe={windowsNewline:`\r +${t}`}});import jSe from"node:path";import $V from"node:process";var kV,Db,MSe,FSe,KR=y(()=>{kV=St(o9(),1);f9();mb();Kf();NR();BR();HR();GR();ZR();Pa();WR();xl();So();Db=(t,e,r)=>{r.cwd=SV(r.cwd);let[n,i,o]=gV(t,e,r),{command:s,args:a,options:c}=kV.default._parse(n,i,o),l=WG(c),u=MSe(l);return fV(u),vV(u),yV(u),P9(u),uV(u),u.shell=uR(u.shell),u.env=FSe(u),u.killSignal=A9(u.killSignal),u.forceKillAfterDelay=R9(u.forceKillAfterDelay),u.lines=u.lines.map((d,f)=>d&&!sn.has(u.encoding)&&u.buffer[f]),$V.platform==="win32"&&jSe.basename(s,".exe")==="cmd"&&a.unshift("/q"),{file:s,commandArguments:a,options:u}},MSe=({extendEnv:t=!0,preferLocal:e=!1,cwd:r,localDir:n=r,encoding:i="utf8",reject:o=!0,cleanup:s=!0,all:a=!1,windowsHide:c=!0,killSignal:l="SIGTERM",forceKillAfterDelay:u=!0,gracefulCancel:d=!1,ipcInput:f,ipc:p=f!==void 0||d,serialization:m="advanced",...h})=>({...h,extendEnv:t,preferLocal:e,cwd:r,localDirectory:n,encoding:i,reject:o,cleanup:s,all:a,windowsHide:c,killSignal:l,forceKillAfterDelay:u,gracefulCancel:d,ipcInput:f,ipc:p,serialization:m}),FSe=({env:t,extendEnv:e,preferLocal:r,node:n,localDirectory:i,nodePath:o})=>{let s=e?{...$V.env,...t}:t;return r||n?d9({env:s,cwd:i,execPath:o,preferLocal:r,addExecPath:n}):s}});var Nb,JR=y(()=>{Nb=(t,e,r)=>r.shell&&e.length>0?[[t,...e].join(" "),[],r]:[t,e,r]});function Dl(t){if(typeof t=="string")return LSe(t);if(!(ArrayBuffer.isView(t)&&t.BYTES_PER_ELEMENT===1))throw new Error("Input must be a string or a Uint8Array");return zSe(t)}var LSe,zSe,EV,USe,AV,qSe,YR=y(()=>{LSe=t=>t.at(-1)===EV?t.slice(0,t.at(-2)===AV?-2:-1):t,zSe=t=>t.at(-1)===USe?t.subarray(0,t.at(-2)===qSe?-2:-1):t,EV=` +`,USe=EV.codePointAt(0),AV="\r",qSe=AV.codePointAt(0)});function ni(t,{checkOpen:e=!0}={}){return t!==null&&typeof t=="object"&&(t.writable||t.readable||!e||t.writable===void 0&&t.readable===void 0)&&typeof t.pipe=="function"}function XR(t,{checkOpen:e=!0}={}){return ni(t,{checkOpen:e})&&(t.writable||!e)&&typeof t.write=="function"&&typeof t.end=="function"&&typeof t.writable=="boolean"&&typeof t.writableObjectMode=="boolean"&&typeof t.destroy=="function"&&typeof t.destroyed=="boolean"}function Ca(t,{checkOpen:e=!0}={}){return ni(t,{checkOpen:e})&&(t.readable||!e)&&typeof t.read=="function"&&typeof t.readable=="boolean"&&typeof t.readableObjectMode=="boolean"&&typeof t.destroy=="function"&&typeof t.destroyed=="boolean"}function QR(t,e){return XR(t,e)&&Ca(t,e)}var Da=y(()=>{});function TV(){return this[tI].next()}function OV(t){return this[tI].return(t)}function rI({preventCancel:t=!1}={}){let e=this.getReader(),r=new eI(e,t),n=Object.create(HSe);return n[tI]=r,n}var BSe,eI,tI,HSe,RV=y(()=>{BSe=Object.getPrototypeOf(Object.getPrototypeOf(async function*(){}).prototype),eI=class{#t;#r;#e=!1;#n=void 0;constructor(e,r){this.#t=e,this.#r=r}next(){let e=()=>this.#o();return this.#n=this.#n?this.#n.then(e,e):e(),this.#n}return(e){let r=()=>this.#i(e);return this.#n?this.#n.then(r,r):r()}async#o(){if(this.#e)return{done:!0,value:void 0};let e;try{e=await this.#t.read()}catch(r){throw this.#n=void 0,this.#e=!0,this.#t.releaseLock(),r}return e.done&&(this.#n=void 0,this.#e=!0,this.#t.releaseLock()),e}async#i(e){if(this.#e)return{done:!0,value:e};if(this.#e=!0,!this.#r){let r=this.#t.cancel(e);return this.#t.releaseLock(),await r,{done:!0,value:e}}return this.#t.releaseLock(),{done:!0,value:e}}},tI=Symbol();Object.defineProperty(TV,"name",{value:"next"});Object.defineProperty(OV,"name",{value:"return"});HSe=Object.create(BSe,{next:{enumerable:!0,configurable:!0,writable:!0,value:TV},return:{enumerable:!0,configurable:!0,writable:!0,value:OV}})});var IV=y(()=>{});var PV=y(()=>{RV();IV()});var CV,GSe,ZSe,VSe,ep,nI=y(()=>{Da();PV();CV=t=>{if(Ca(t,{checkOpen:!1})&&ep.on!==void 0)return ZSe(t);if(typeof t?.[Symbol.asyncIterator]=="function")return t;if(GSe.call(t)==="[object ReadableStream]")return rI.call(t);throw new TypeError("The first argument must be a Readable, a ReadableStream, or an async iterable.")},{toString:GSe}=Object.prototype,ZSe=async function*(t){let e=new AbortController,r={};VSe(t,e,r);try{for await(let[n]of ep.on(t,"data",{signal:e.signal}))yield n}catch(n){if(r.error!==void 0)throw r.error;if(!e.signal.aborted)throw n}finally{t.destroy()}},VSe=async(t,e,r)=>{try{await ep.finished(t,{cleanup:!0,readable:!0,writable:!1,error:!1})}catch(n){r.error=n}finally{e.abort()}},ep={}});var Nl,WSe,jV,DV,KSe,NV,Ni,tp=y(()=>{nI();Nl=async(t,{init:e,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,finalize:a},{maxBuffer:c=Number.POSITIVE_INFINITY}={})=>{let l=CV(t),u=e();u.length=0;try{for await(let d of l){let f=KSe(d),p=r[f](d,u);jV({convertedChunk:p,state:u,getSize:n,truncateChunk:i,addChunk:o,maxBuffer:c})}return WSe({state:u,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,maxBuffer:c}),a(u)}catch(d){let f=typeof d=="object"&&d!==null?d:new Error(d);throw f.bufferedData=a(u),f}},WSe=({state:t,getSize:e,truncateChunk:r,addChunk:n,getFinalChunk:i,maxBuffer:o})=>{let s=i(t);s!==void 0&&jV({convertedChunk:s,state:t,getSize:e,truncateChunk:r,addChunk:n,maxBuffer:o})},jV=({convertedChunk:t,state:e,getSize:r,truncateChunk:n,addChunk:i,maxBuffer:o})=>{let s=r(t),a=e.length+s;if(a<=o){DV(t,e,i,a);return}let c=n(t,o-e.length);throw c!==void 0&&DV(c,e,i,o),new Ni},DV=(t,e,r,n)=>{e.contents=r(t,e,n),e.length=n},KSe=t=>{let e=typeof t;if(e==="string")return"string";if(e!=="object"||t===null)return"others";if(globalThis.Buffer?.isBuffer(t))return"buffer";let r=NV.call(t);return r==="[object ArrayBuffer]"?"arrayBuffer":r==="[object DataView]"?"dataView":Number.isInteger(t.byteLength)&&Number.isInteger(t.byteOffset)&&NV.call(t.buffer)==="[object ArrayBuffer]"?"typedArray":"others"},{toString:NV}=Object.prototype,Ni=class extends Error{name="MaxBufferError";constructor(){super("maxBuffer exceeded")}}});var wo,rp,jb,Mb,Fb,Lb=y(()=>{wo=t=>t,rp=()=>{},jb=({contents:t})=>t,Mb=t=>{throw new Error(`Streams in object mode are not supported: ${String(t)}`)},Fb=t=>t.length});async function zb(t,e){return Nl(t,QSe,e)}var JSe,YSe,XSe,QSe,MV=y(()=>{tp();Lb();JSe=()=>({contents:[]}),YSe=()=>1,XSe=(t,{contents:e})=>(e.push(t),e),QSe={init:JSe,convertChunk:{string:wo,buffer:wo,arrayBuffer:wo,dataView:wo,typedArray:wo,others:wo},getSize:YSe,truncateChunk:rp,addChunk:XSe,getFinalChunk:rp,finalize:jb}});async function Ub(t,e){return Nl(t,cwe,e)}var ewe,twe,rwe,FV,LV,nwe,iwe,owe,swe,UV,zV,awe,qV,cwe,BV=y(()=>{tp();Lb();ewe=()=>({contents:new ArrayBuffer(0)}),twe=t=>rwe.encode(t),rwe=new TextEncoder,FV=t=>new Uint8Array(t),LV=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),nwe=(t,e)=>t.slice(0,e),iwe=(t,{contents:e,length:r},n)=>{let i=qV()?swe(e,n):owe(e,n);return new Uint8Array(i).set(t,r),i},owe=(t,e)=>{if(e<=t.byteLength)return t;let r=new ArrayBuffer(UV(e));return new Uint8Array(r).set(new Uint8Array(t),0),r},swe=(t,e)=>{if(e<=t.maxByteLength)return t.resize(e),t;let r=new ArrayBuffer(e,{maxByteLength:UV(e)});return new Uint8Array(r).set(new Uint8Array(t),0),r},UV=t=>zV**Math.ceil(Math.log(t)/Math.log(zV)),zV=2,awe=({contents:t,length:e})=>qV()?t:t.slice(0,e),qV=()=>"resize"in ArrayBuffer.prototype,cwe={init:ewe,convertChunk:{string:twe,buffer:FV,arrayBuffer:FV,dataView:LV,typedArray:LV,others:Mb},getSize:Fb,truncateChunk:nwe,addChunk:iwe,getFinalChunk:rp,finalize:awe}});async function Bb(t,e){return Nl(t,pwe,e)}var lwe,qb,uwe,dwe,fwe,pwe,HV=y(()=>{tp();Lb();lwe=()=>({contents:"",textDecoder:new TextDecoder}),qb=(t,{textDecoder:e})=>e.decode(t,{stream:!0}),uwe=(t,{contents:e})=>e+t,dwe=(t,e)=>t.slice(0,e),fwe=({textDecoder:t})=>{let e=t.decode();return e===""?void 0:e},pwe={init:lwe,convertChunk:{string:wo,buffer:qb,arrayBuffer:qb,dataView:qb,typedArray:qb,others:Mb},getSize:Fb,truncateChunk:dwe,addChunk:uwe,getFinalChunk:fwe,finalize:jb}});var GV=y(()=>{MV();BV();HV();tp()});import{on as mwe}from"node:events";import{finished as hwe}from"node:stream/promises";var Hb=y(()=>{nI();GV();Object.assign(ep,{on:mwe,finished:hwe})});var ZV,gwe,VV,WV,ywe,KV,JV,Gb,Na=y(()=>{Hb();bo();So();ZV=({error:t,stream:e,readableObjectMode:r,lines:n,encoding:i,fdNumber:o})=>{if(!(t instanceof Ni))throw t;if(o==="all")return t;let s=gwe(r,n,i);throw t.maxBufferInfo={fdNumber:o,unit:s},e.destroy(),t},gwe=(t,e,r)=>t?"objects":e?"lines":r==="buffer"?"bytes":"characters",VV=(t,e,r)=>{if(e.length!==r)return;let n=new Ni;throw n.maxBufferInfo={fdNumber:"ipc"},n},WV=(t,e)=>{let{streamName:r,threshold:n,unit:i}=ywe(t,e);return`Command's ${r} was larger than ${n} ${i}`},ywe=(t,e)=>{if(t?.maxBufferInfo===void 0)return{streamName:"output",threshold:e[1],unit:"bytes"};let{maxBufferInfo:{fdNumber:r,unit:n}}=t;delete t.maxBufferInfo;let i=vo(e,r);return r==="ipc"?{streamName:"IPC output",threshold:i,unit:"messages"}:{streamName:Y_(r),threshold:i,unit:n}},KV=(t,e,r)=>t?.code==="ENOBUFS"&&e!==null&&e.some(n=>n!==null&&n.length>Gb(r)),JV=(t,e,r)=>{if(!e)return t;let n=Gb(r);return t.length>n?t.slice(0,n):t},Gb=([,t])=>t});import{inspect as _we}from"node:util";var XV,bwe,vwe,Swe,wwe,xwe,YV,QV=y(()=>{YR();on();WR();eb();Na();Kf();Ra();XV=({stdio:t,all:e,ipcOutput:r,originalError:n,signal:i,signalDescription:o,exitCode:s,escapedCommand:a,timedOut:c,isCanceled:l,isGracefullyCanceled:u,isMaxBuffer:d,isForcefullyTerminated:f,forceKillAfterDelay:p,killSignal:m,maxBuffer:h,timeout:g,cwd:b})=>{let _=n?.code,S=bwe({originalError:n,timedOut:c,timeout:g,isMaxBuffer:d,maxBuffer:h,errorCode:_,signal:i,signalDescription:o,exitCode:s,isCanceled:l,isGracefullyCanceled:u,isForcefullyTerminated:f,forceKillAfterDelay:p,killSignal:m}),x=Swe(n,b),w=x===void 0?"":` +${x}`,O=`${S}: ${a}${w}`,T=e===void 0?[t[2],t[1]]:[e],A=[O,...T,...t.slice(3),r.map(D=>wwe(D)).join(` +`)].map(D=>Gf(Dl(xwe(D)))).filter(Boolean).join(` + +`);return{originalMessage:x,shortMessage:O,message:A}},bwe=({originalError:t,timedOut:e,timeout:r,isMaxBuffer:n,maxBuffer:i,errorCode:o,signal:s,signalDescription:a,exitCode:c,isCanceled:l,isGracefullyCanceled:u,isForcefullyTerminated:d,forceKillAfterDelay:f,killSignal:p})=>{let m=vwe(d,f);return e?`Command timed out after ${r} milliseconds${m}`:u?s===void 0?`Command was gracefully canceled with exit code ${c}`:d?`Command was gracefully canceled${m}`:`Command was gracefully canceled with ${s} (${a})`:l?`Command was canceled${m}`:n?`${WV(t,i)}${m}`:o!==void 0?`Command failed with ${o}${m}`:d?`Command was killed with ${p} (${pb(p)})${m}`:s!==void 0?`Command was killed with ${s} (${a})`:c!==void 0?`Command failed with exit code ${c}`:"Command failed"},vwe=(t,e)=>t?` and was forcefully terminated after ${e} milliseconds`:"",Swe=(t,e)=>{if(t instanceof ti)return;let r=h9(t)?t.originalMessage:String(t?.message??t),n=Gf(xV(r,e));return n===""?void 0:n},wwe=t=>typeof t=="string"?t:_we(t),xwe=t=>Array.isArray(t)?t.map(e=>Dl(YV(e))).filter(Boolean).join(` +`):YV(t),YV=t=>typeof t=="string"?t:qt(t)?K_(t):""});var Zb,jl,np,$we,eW,kwe,ip=y(()=>{Kf();sb();Ra();QV();Zb=({command:t,escapedCommand:e,stdio:r,all:n,ipcOutput:i,options:{cwd:o},startTime:s})=>eW({command:t,escapedCommand:e,cwd:o,durationMs:vR(s),failed:!1,timedOut:!1,isCanceled:!1,isGracefullyCanceled:!1,isTerminated:!1,isMaxBuffer:!1,isForcefullyTerminated:!1,exitCode:0,stdout:r[1],stderr:r[2],all:n,stdio:r,ipcOutput:i,pipedFrom:[]}),jl=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:s})=>np({error:t,command:e,escapedCommand:r,startTime:o,timedOut:!1,isCanceled:!1,isGracefullyCanceled:!1,isMaxBuffer:!1,isForcefullyTerminated:!1,stdio:Array.from({length:n.length}),ipcOutput:[],options:i,isSync:s}),np=({error:t,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,stdio:d,all:f,ipcOutput:p,options:{timeoutDuration:m,timeout:h=m,forceKillAfterDelay:g,killSignal:b,cwd:_,maxBuffer:S},isSync:x})=>{let{exitCode:w,signal:O,signalDescription:T}=kwe(l,u),{originalMessage:A,shortMessage:D,message:$}=XV({stdio:d,all:f,ipcOutput:p,originalError:t,signal:O,signalDescription:T,exitCode:w,escapedCommand:r,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,forceKillAfterDelay:g,killSignal:b,maxBuffer:S,timeout:h,cwd:_}),re=p9(t,$,x);return Object.assign(re,$we({error:re,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:w,signal:O,signalDescription:T,stdio:d,all:f,ipcOutput:p,cwd:_,originalMessage:A,shortMessage:D})),re},$we=({error:t,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,signalDescription:d,stdio:f,all:p,ipcOutput:m,cwd:h,originalMessage:g,shortMessage:b})=>eW({shortMessage:b,originalMessage:g,command:e,escapedCommand:r,cwd:h,durationMs:vR(n),failed:!0,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isTerminated:u!==void 0,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:l,signal:u,signalDescription:d,code:t.cause?.code,stdout:f[1],stderr:f[2],all:p,stdio:f,ipcOutput:m,pipedFrom:[]}),eW=t=>Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0)),kwe=(t,e)=>{let r=t===null?void 0:t,n=e===null?void 0:e,i=n===void 0?void 0:pb(e);return{exitCode:r,signal:n,signalDescription:i}}});function Ewe(t){return{days:Math.trunc(t/864e5),hours:Math.trunc(t/36e5%24),minutes:Math.trunc(t/6e4%60),seconds:Math.trunc(t/1e3%60),milliseconds:Math.trunc(t%1e3),microseconds:Math.trunc(tW(t*1e3)%1e3),nanoseconds:Math.trunc(tW(t*1e6)%1e3)}}function Awe(t){return{days:t/86400000n,hours:t/3600000n%24n,minutes:t/60000n%60n,seconds:t/1000n%60n,milliseconds:t%1000n,microseconds:0n,nanoseconds:0n}}function iI(t){switch(typeof t){case"number":{if(Number.isFinite(t))return Ewe(t);break}case"bigint":return Awe(t)}throw new TypeError("Expected a finite number or bigint")}var tW,rW=y(()=>{tW=t=>Number.isFinite(t)?t:0});function oI(t,e){let r=typeof t=="bigint";if(!r&&!Number.isFinite(t))throw new TypeError("Expected a finite number or bigint");e={...e};let n=t<0?"-":"";t=t<0?-t:t,e.colonNotation&&(e.compact=!1,e.formatSubMilliseconds=!1,e.separateMilliseconds=!1,e.verbose=!1),e.compact&&(e.unitCount=1,e.secondsDecimalDigits=0,e.millisecondsDecimalDigits=0);let i=[],o=(u,d)=>{let f=Math.floor(u*10**d+Rwe);return(Math.round(f)/10**d).toFixed(d)},s=(u,d,f,p)=>{if(!((i.length===0||!e.colonNotation)&&Twe(u)&&!(e.colonNotation&&f==="m"))){if(p??=String(u),e.colonNotation){let m=p.includes(".")?p.split(".")[0].length:p.length,h=i.length>0?2:1;p="0".repeat(Math.max(0,h-m))+p}else p+=e.verbose?" "+Owe(d,u):f;i.push(p)}},a=iI(t),c=BigInt(a.days);if(e.hideYearAndDays?s(BigInt(c)*24n+BigInt(a.hours),"hour","h"):(e.hideYear?s(c,"day","d"):(s(c/365n,"year","y"),s(c%365n,"day","d")),s(Number(a.hours),"hour","h")),s(Number(a.minutes),"minute","m"),!e.hideSeconds)if(e.separateMilliseconds||e.formatSubMilliseconds||!e.colonNotation&&t<1e3&&!e.subSecondsAsDecimals){let u=Number(a.seconds),d=Number(a.milliseconds),f=Number(a.microseconds),p=Number(a.nanoseconds);if(s(u,"second","s"),e.formatSubMilliseconds)s(d,"millisecond","ms"),s(f,"microsecond","\xB5s"),s(p,"nanosecond","ns");else{let m=d+f/1e3+p/1e6,h=typeof e.millisecondsDecimalDigits=="number"?e.millisecondsDecimalDigits:0,g=m>=1?Math.round(m):Math.ceil(m),b=h?m.toFixed(h):g;s(Number.parseFloat(b),"millisecond","ms",b)}}else{let u=(r?Number(t%Iwe):t)/1e3%60,d=typeof e.secondsDecimalDigits=="number"?e.secondsDecimalDigits:1,f=o(u,d),p=e.keepDecimalsOnWholeSeconds?f:f.replace(/\.0+$/,"");s(Number.parseFloat(p),"second","s",p)}if(i.length===0)return n+"0"+(e.verbose?" milliseconds":"ms");let l=e.colonNotation?":":" ";return typeof e.unitCount=="number"&&(i=i.slice(0,Math.max(e.unitCount,1))),n+i.join(l)}var Twe,Owe,Rwe,Iwe,nW=y(()=>{rW();Twe=t=>t===0||t===0n,Owe=(t,e)=>e===1||e===1n?t:`${t}s`,Rwe=1e-7,Iwe=24n*60n*60n*1000n});var iW,oW=y(()=>{El();iW=(t,e)=>{t.failed&&Pi({type:"error",verboseMessage:t.shortMessage,verboseInfo:e,result:t})}});var sW,Pwe,aW=y(()=>{nW();ls();El();oW();sW=(t,e)=>{$l(e)&&(iW(t,e),Pwe(t,e))},Pwe=(t,e)=>{let r=`(done in ${oI(t.durationMs)})`;Pi({type:"duration",verboseMessage:r,verboseInfo:e,result:t})}});var Ml,Vb=y(()=>{aW();Ml=(t,e,{reject:r})=>{if(sW(t,e),t.failed&&r)throw t;return t}});var uW,Cwe,Dwe,dW,fW,cW,Nwe,sI,lW,ja,pW,jwe,Wb,mW,Mwe,Fwe,aI,hW,Lwe,gW,Kb,zwe,cI,Uwe,qwe,yW,In,Jb,lI,_W,bW,ps,wr=y(()=>{Da();yo();on();uW=(t,e)=>ja(t)?"asyncGenerator":pW(t)?"generator":Wb(t)?"fileUrl":Mwe(t)?"filePath":zwe(t)?"webStream":ni(t,{checkOpen:!1})?"native":qt(t)?"uint8Array":Uwe(t)?"asyncIterable":qwe(t)?"iterable":cI(t)?dW({transform:t},e):jwe(t)?Cwe(t,e):"native",Cwe=(t,e)=>QR(t.transform,{checkOpen:!1})?Dwe(t,e):cI(t.transform)?dW(t,e):Nwe(t,e),Dwe=(t,e)=>(fW(t,e,"Duplex stream"),"duplex"),dW=(t,e)=>(fW(t,e,"web TransformStream"),"webTransform"),fW=({final:t,binary:e,objectMode:r},n,i)=>{cW(t,`${n}.final`,i),cW(e,`${n}.binary`,i),sI(r,`${n}.objectMode`)},cW=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${e}\` option can only be defined when using a generator, not a ${r}.`)},Nwe=({transform:t,final:e,binary:r,objectMode:n},i)=>{if(t!==void 0&&!lW(t))throw new TypeError(`The \`${i}.transform\` option must be a generator, a Duplex stream or a web TransformStream.`);if(QR(e,{checkOpen:!1}))throw new TypeError(`The \`${i}.final\` option must not be a Duplex stream.`);if(cI(e))throw new TypeError(`The \`${i}.final\` option must not be a web TransformStream.`);if(e!==void 0&&!lW(e))throw new TypeError(`The \`${i}.final\` option must be a generator.`);return sI(r,`${i}.binary`),sI(n,`${i}.objectMode`),ja(t)||ja(e)?"asyncGenerator":"generator"},sI=(t,e)=>{if(t!==void 0&&typeof t!="boolean")throw new TypeError(`The \`${e}\` option must use a boolean.`)},lW=t=>ja(t)||pW(t),ja=t=>Object.prototype.toString.call(t)==="[object AsyncGeneratorFunction]",pW=t=>Object.prototype.toString.call(t)==="[object GeneratorFunction]",jwe=t=>Ot(t)&&(t.transform!==void 0||t.final!==void 0),Wb=t=>Object.prototype.toString.call(t)==="[object URL]",mW=t=>Wb(t)&&t.protocol!=="file:",Mwe=t=>Ot(t)&&Object.keys(t).length>0&&Object.keys(t).every(e=>Fwe.has(e))&&aI(t.file),Fwe=new Set(["file","append"]),aI=t=>typeof t=="string",hW=(t,e)=>t==="native"&&typeof e=="string"&&!Lwe.has(e),Lwe=new Set(["ipc","ignore","inherit","overlapped","pipe"]),gW=t=>Object.prototype.toString.call(t)==="[object ReadableStream]",Kb=t=>Object.prototype.toString.call(t)==="[object WritableStream]",zwe=t=>gW(t)||Kb(t),cI=t=>gW(t?.readable)&&Kb(t?.writable),Uwe=t=>yW(t)&&typeof t[Symbol.asyncIterator]=="function",qwe=t=>yW(t)&&typeof t[Symbol.iterator]=="function",yW=t=>typeof t=="object"&&t!==null,In=new Set(["generator","asyncGenerator","duplex","webTransform"]),Jb=new Set(["fileUrl","filePath","fileNumber"]),lI=new Set(["fileUrl","filePath"]),_W=new Set([...lI,"webStream","nodeStream"]),bW=new Set(["webTransform","duplex"]),ps={generator:"a generator",asyncGenerator:"an async generator",fileUrl:"a file URL",filePath:"a file path string",fileNumber:"a file descriptor number",webStream:"a web stream",nodeStream:"a Node.js stream",webTransform:"a web TransformStream",duplex:"a Duplex stream",native:"any value",iterable:"an iterable",asyncIterable:"an async iterable",string:"a string",uint8Array:"a Uint8Array"}});var uI,Bwe,Hwe,vW,dI=y(()=>{wr();uI=(t,e,r,n)=>n==="output"?Bwe(t,e,r):Hwe(t,e,r),Bwe=(t,e,r)=>{let n=e!==0&&r[e-1].value.readableObjectMode;return{writableObjectMode:n,readableObjectMode:t??n}},Hwe=(t,e,r)=>{let n=e===0?t===!0:r[e-1].value.readableObjectMode,i=e!==r.length-1&&(t??n);return{writableObjectMode:n,readableObjectMode:i}},vW=(t,e)=>{let r=t.findLast(({type:n})=>In.has(n));return r===void 0?!1:e==="input"?r.value.writableObjectMode:r.value.readableObjectMode}});var SW,Gwe,Zwe,Vwe,Wwe,Kwe,Jwe,wW=y(()=>{yo();Pa();wr();dI();SW=(t,e,r,n)=>[...t.filter(({type:i})=>!In.has(i)),...Gwe(t,e,r,n)],Gwe=(t,e,r,{encoding:n})=>{let i=t.filter(({type:s})=>In.has(s)),o=Array.from({length:i.length});for(let[s,a]of Object.entries(i))o[s]=Zwe({stdioItem:a,index:Number(s),newTransforms:o,optionName:e,direction:r,encoding:n});return Jwe(o,r)},Zwe=({stdioItem:t,stdioItem:{type:e},index:r,newTransforms:n,optionName:i,direction:o,encoding:s})=>e==="duplex"?Vwe({stdioItem:t,optionName:i}):e==="webTransform"?Wwe({stdioItem:t,index:r,newTransforms:n,direction:o}):Kwe({stdioItem:t,index:r,newTransforms:n,direction:o,encoding:s}),Vwe=({stdioItem:t,stdioItem:{value:{transform:e,transform:{writableObjectMode:r,readableObjectMode:n},objectMode:i=n}},optionName:o})=>{if(i&&!n)throw new TypeError(`The \`${o}.objectMode\` option can only be \`true\` if \`new Duplex({objectMode: true})\` is used.`);if(!i&&n)throw new TypeError(`The \`${o}.objectMode\` option cannot be \`false\` if \`new Duplex({objectMode: true})\` is used.`);return{...t,value:{transform:e,writableObjectMode:r,readableObjectMode:n}}},Wwe=({stdioItem:t,stdioItem:{value:e},index:r,newTransforms:n,direction:i})=>{let{transform:o,objectMode:s}=Ot(e)?e:{transform:e},{writableObjectMode:a,readableObjectMode:c}=uI(s,r,n,i);return{...t,value:{transform:o,writableObjectMode:a,readableObjectMode:c}}},Kwe=({stdioItem:t,stdioItem:{value:e},index:r,newTransforms:n,direction:i,encoding:o})=>{let{transform:s,final:a,binary:c=!1,preserveNewlines:l=!1,objectMode:u}=Ot(e)?e:{transform:e},d=c||sn.has(o),{writableObjectMode:f,readableObjectMode:p}=uI(u,r,n,i);return{...t,value:{transform:s,final:a,binary:d,preserveNewlines:l,writableObjectMode:f,readableObjectMode:p}}},Jwe=(t,e)=>e==="input"?t.reverse():t});import fI from"node:process";var xW,Ywe,Xwe,Fl,pI,$W,Qwe,exe,kW=y(()=>{Da();wr();xW=(t,e,r)=>{let n=t.map(i=>Ywe(i,e));if(n.includes("input")&&n.includes("output"))throw new TypeError(`The \`${r}\` option must not be an array of both readable and writable values.`);return n.find(Boolean)??exe},Ywe=({type:t,value:e},r)=>Xwe[r]??$W[t](e),Xwe=["input","output","output"],Fl=()=>{},pI=()=>"input",$W={generator:Fl,asyncGenerator:Fl,fileUrl:Fl,filePath:Fl,iterable:pI,asyncIterable:pI,uint8Array:pI,webStream:t=>Kb(t)?"output":"input",nodeStream(t){return Ca(t,{checkOpen:!1})?XR(t,{checkOpen:!1})?void 0:"input":"output"},webTransform:Fl,duplex:Fl,native(t){let e=Qwe(t);if(e!==void 0)return e;if(ni(t,{checkOpen:!1}))return $W.nodeStream(t)}},Qwe=t=>{if([0,fI.stdin].includes(t))return"input";if([1,2,fI.stdout,fI.stderr].includes(t))return"output"},exe="output"});var EW,AW=y(()=>{EW=(t,e)=>e&&!t.includes("ipc")?[...t,"ipc"]:t});var TW,txe,rxe,OW,nxe,ixe,RW=y(()=>{bo();AW();ls();TW=({stdio:t,ipc:e,buffer:r,...n},i,o)=>{let s=txe(t,n).map((a,c)=>OW(a,c));return o?nxe(s,r,i):EW(s,e)},txe=(t,e)=>{if(t===void 0)return Rn.map(n=>e[n]);if(rxe(e))throw new Error(`It's not possible to provide \`stdio\` in combination with one of ${Rn.map(n=>`\`${n}\``).join(", ")}`);if(typeof t=="string")return[t,t,t];if(!Array.isArray(t))throw new TypeError(`Expected \`stdio\` to be of type \`string\` or \`Array\`, got \`${typeof t}\``);let r=Math.max(t.length,Rn.length);return Array.from({length:r},(n,i)=>t[i])},rxe=t=>Rn.some(e=>t[e]!==void 0),OW=(t,e)=>Array.isArray(t)?t.map(r=>OW(r,e)):t??(e>=Rn.length?"ignore":"pipe"),nxe=(t,e,r)=>t.map((n,i)=>!e[i]&&i!==0&&!kl(r,i)&&ixe(n)?"ignore":n),ixe=t=>t==="pipe"||Array.isArray(t)&&t.every(e=>e==="pipe")});import{readFileSync as oxe}from"node:fs";import sxe from"node:tty";var PW,axe,cxe,lxe,uxe,IW,CW=y(()=>{Da();bo();on();ds();PW=({stdioItem:t,stdioItem:{type:e},isStdioArray:r,fdNumber:n,direction:i,isSync:o})=>!r||e!=="native"?t:o?axe({stdioItem:t,fdNumber:n,direction:i}):uxe({stdioItem:t,fdNumber:n}),axe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n,direction:i})=>{let o=cxe({value:e,optionName:r,fdNumber:n,direction:i});if(o!==void 0)return o;if(ni(e,{checkOpen:!1}))throw new TypeError(`The \`${r}: Stream\` option cannot both be an array and include a stream with synchronous methods.`);return t},cxe=({value:t,optionName:e,fdNumber:r,direction:n})=>{let i=lxe(t,r);if(i!==void 0){if(n==="output")return{type:"fileNumber",value:i,optionName:e};if(sxe.isatty(i))throw new TypeError(`The \`${e}: ${yb(t)}\` option is invalid: it cannot be a TTY with synchronous methods.`);return{type:"uint8Array",value:_o(oxe(i)),optionName:e}}},lxe=(t,e)=>{if(t==="inherit")return e;if(typeof t=="number")return t;let r=J_.indexOf(t);if(r!==-1)return r},uxe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n})=>e==="inherit"?{type:"nodeStream",value:IW(n,e,r),optionName:r}:typeof e=="number"?{type:"nodeStream",value:IW(e,e,r),optionName:r}:ni(e,{checkOpen:!1})?{type:"nodeStream",value:e,optionName:r}:t,IW=(t,e,r)=>{let n=J_[t];if(n===void 0)throw new TypeError(`The \`${r}: ${e}\` option is invalid: no such standard stream.`);return n}});var DW,dxe,fxe,pxe,mxe,NW=y(()=>{Da();on();wr();DW=({input:t,inputFile:e},r)=>r===0?[...dxe(t),...pxe(e)]:[],dxe=t=>t===void 0?[]:[{type:fxe(t),value:t,optionName:"input"}],fxe=t=>{if(Ca(t,{checkOpen:!1}))return"nodeStream";if(typeof t=="string")return"string";if(qt(t))return"uint8Array";throw new Error("The `input` option must be a string, a Uint8Array or a Node.js Readable stream.")},pxe=t=>t===void 0?[]:[{...mxe(t),optionName:"inputFile"}],mxe=t=>{if(Wb(t))return{type:"fileUrl",value:t};if(aI(t))return{type:"filePath",value:{file:t}};throw new Error("The `inputFile` option must be a file path string or a file URL.")}});var jW,MW,hxe,gxe,FW,yxe,_xe,LW,zW=y(()=>{wr();jW=t=>t.filter((e,r)=>t.every((n,i)=>e.value!==n.value||r>=i||e.type==="generator"||e.type==="asyncGenerator")),MW=({stdioItem:{type:t,value:e,optionName:r},direction:n,fileDescriptors:i,isSync:o})=>{let s=hxe(i,t);if(s.length!==0){if(o){gxe({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});return}if(_W.has(t))return FW({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});bW.has(t)&&_xe({otherStdioItems:s,type:t,value:e,optionName:r})}},hxe=(t,e)=>t.flatMap(({direction:r,stdioItems:n})=>n.filter(i=>i.type===e).map((i=>({...i,direction:r})))),gxe=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{lI.has(e)&&FW({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})},FW=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{let o=t.filter(a=>yxe(a,r));if(o.length===0)return;let s=o.find(a=>a.direction!==i);return LW(s,n,e),i==="output"?o[0].stream:void 0},yxe=({type:t,value:e},r)=>t==="filePath"?e.file===r.file:t==="fileUrl"?e.href===r.href:e===r,_xe=({otherStdioItems:t,type:e,value:r,optionName:n})=>{let i=t.find(({value:{transform:o}})=>o===r.transform);LW(i,n,e)},LW=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${t.optionName}\` and \`${e}\` options must not target ${ps[r]} that is the same.`)}});var Yb,bxe,vxe,Sxe,wxe,xxe,$xe,kxe,Exe,Axe,Txe,Oxe,mI,Rxe,Xb=y(()=>{bo();wW();dI();wr();kW();RW();CW();NW();zW();Yb=(t,e,r,n)=>{let o=TW(e,r,n).map((a,c)=>bxe({stdioOption:a,fdNumber:c,options:e,isSync:n})),s=Axe({initialFileDescriptors:o,addProperties:t,options:e,isSync:n});return e.stdio=s.map(({stdioItems:a})=>Rxe(a)),s},bxe=({stdioOption:t,fdNumber:e,options:r,isSync:n})=>{let i=Y_(e),{stdioItems:o,isStdioArray:s}=vxe({stdioOption:t,fdNumber:e,options:r,optionName:i}),a=xW(o,e,i),c=o.map(d=>PW({stdioItem:d,isStdioArray:s,fdNumber:e,direction:a,isSync:n})),l=SW(c,i,a,r),u=vW(l,a);return Exe(l,u),{direction:a,objectMode:u,stdioItems:l}},vxe=({stdioOption:t,fdNumber:e,options:r,optionName:n})=>{let o=[...(Array.isArray(t)?t:[t]).map(c=>Sxe(c,n)),...DW(r,e)],s=jW(o),a=s.length>1;return wxe(s,a,n),$xe(s),{stdioItems:s,isStdioArray:a}},Sxe=(t,e)=>({type:uW(t,e),value:t,optionName:e}),wxe=(t,e,r)=>{if(t.length===0)throw new TypeError(`The \`${r}\` option must not be an empty array.`);if(e){for(let{value:n,optionName:i}of t)if(xxe.has(n))throw new Error(`The \`${i}\` option must not include \`${n}\`.`)}},xxe=new Set(["ignore","ipc"]),$xe=t=>{for(let e of t)kxe(e)},kxe=({type:t,value:e,optionName:r})=>{if(mW(e))throw new TypeError(`The \`${r}: URL\` option must use the \`file:\` scheme. +For example, you can use the \`pathToFileURL()\` method of the \`url\` core module.`);if(hW(t,e))throw new TypeError(`The \`${r}: { file: '...' }\` option must be used instead of \`${r}: '...'\`.`)},Exe=(t,e)=>{if(!e)return;let r=t.find(({type:n})=>Jb.has(n));if(r!==void 0)throw new TypeError(`The \`${r.optionName}\` option cannot use both files and transforms in objectMode.`)},Axe=({initialFileDescriptors:t,addProperties:e,options:r,isSync:n})=>{let i=[];try{for(let o of t)i.push(Txe({fileDescriptor:o,fileDescriptors:i,addProperties:e,options:r,isSync:n}));return i}catch(o){throw mI(i),o}},Txe=({fileDescriptor:{direction:t,objectMode:e,stdioItems:r},fileDescriptors:n,addProperties:i,options:o,isSync:s})=>{let a=r.map(c=>Oxe({stdioItem:c,addProperties:i,direction:t,options:o,fileDescriptors:n,isSync:s}));return{direction:t,objectMode:e,stdioItems:a}},Oxe=({stdioItem:t,addProperties:e,direction:r,options:n,fileDescriptors:i,isSync:o})=>{let s=MW({stdioItem:t,direction:r,fileDescriptors:i,isSync:o});return s!==void 0?{...t,stream:s}:{...t,...e[r][t.type](t,n)}},mI=t=>{for(let{stdioItems:e}of t)for(let{stream:r}of e)r!==void 0&&!ei(r)&&r.destroy()},Rxe=t=>{if(t.length>1)return t.some(({value:n})=>n==="overlapped")?"overlapped":"pipe";let[{type:e,value:r}]=t;return e==="native"?r:"pipe"}});import{readFileSync as UW}from"node:fs";var BW,ji,Ixe,HW,qW,Pxe,GW=y(()=>{on();Xb();wr();BW=(t,e)=>Yb(Pxe,t,e,!0),ji=({type:t,optionName:e})=>{HW(e,ps[t])},Ixe=({optionName:t,value:e})=>((e==="ipc"||e==="overlapped")&&HW(t,`"${e}"`),{}),HW=(t,e)=>{throw new TypeError(`The \`${t}\` option cannot be ${e} with synchronous methods.`)},qW={generator(){},asyncGenerator:ji,webStream:ji,nodeStream:ji,webTransform:ji,duplex:ji,asyncIterable:ji,native:Ixe},Pxe={input:{...qW,fileUrl:({value:t})=>({contents:[_o(UW(t))]}),filePath:({value:{file:t}})=>({contents:[_o(UW(t))]}),fileNumber:ji,iterable:({value:t})=>({contents:[...t]}),string:({value:t})=>({contents:[t]}),uint8Array:({value:t})=>({contents:[t]})},output:{...qW,fileUrl:({value:t})=>({path:t}),filePath:({value:{file:t,append:e}})=>({path:t,append:e}),fileNumber:({value:t})=>({path:t}),iterable:ji,string:ji,uint8Array:ji}}});var xo,hI,op=y(()=>{YR();xo=(t,{stripFinalNewline:e},r)=>hI(e,r)&&t!==void 0&&!Array.isArray(t)?Dl(t):t,hI=(t,e)=>e==="all"?t[1]||t[2]:t[e]});var Qb,yI,ZW,VW,Cxe,Dxe,Nxe,WW,jxe,gI,Mxe,Fxe,Lxe,ev=y(()=>{Qb=(t,e,r,n)=>t||r?void 0:VW(e,n),yI=(t,e,r)=>r?t.flatMap(n=>ZW(n,e)):ZW(t,e),ZW=(t,e)=>{let{transform:r,final:n}=VW(e,{});return[...r(t),...n()]},VW=(t,e)=>(e.previousChunks="",{transform:Cxe.bind(void 0,e,t),final:Nxe.bind(void 0,e)}),Cxe=function*(t,e,r){if(typeof r!="string"){yield r;return}let{previousChunks:n}=t,i=-1;for(let o=0;o0&&(a=gI(n,a),n=""),yield a,i=o}i!==r.length-1&&(n=gI(n,r.slice(i+1))),t.previousChunks=n},Dxe=(t,e,r,n)=>r?0:(n.isWindowsNewline=e!==0&&t[e-1]==="\r",n.isWindowsNewline?2:1),Nxe=function*({previousChunks:t}){t.length>0&&(yield t)},WW=({binary:t,preserveNewlines:e,readableObjectMode:r,state:n})=>t||e||r?void 0:{transform:jxe.bind(void 0,n)},jxe=function*({isWindowsNewline:t=!1},e){let{unixNewline:r,windowsNewline:n,LF:i,concatBytes:o}=typeof e=="string"?Mxe:Lxe;if(e.at(-1)===i){yield e;return}yield o(e,t?n:r)},gI=(t,e)=>`${t}${e}`,Mxe={windowsNewline:`\r `,unixNewline:` `,LF:` -`,concatBytes:gI},Nxe=(t,e)=>{let r=new Uint8Array(t.length+e.length);return r.set(t,0),r.set(e,t.length),r},jxe={windowsNewline:new Uint8Array([13,10]),unixNewline:new Uint8Array([10]),LF:10,concatBytes:Nxe}});import{Buffer as Mxe}from"node:buffer";var VW,Fxe,WW,Lxe,zxe,KW,JW=y(()=>{nn();VW=(t,e)=>t?void 0:Fxe.bind(void 0,e),Fxe=function*(t,e){if(typeof e!="string"&&!qt(e)&&!Mxe.isBuffer(e))throw new TypeError(`The \`${t}\` option's transform must use "objectMode: true" to receive as input: ${typeof e}.`);yield e},WW=(t,e)=>t?Lxe.bind(void 0,e):zxe.bind(void 0,e),Lxe=function*(t,e){KW(t,e),yield e},zxe=function*(t,e){if(KW(t,e),typeof e!="string"&&!qt(e))throw new TypeError(`The \`${t}\` option's function must yield a string or an Uint8Array, not ${typeof e}.`);yield e},KW=(t,e)=>{if(e==null)throw new TypeError(`The \`${t}\` option's function must not call \`yield ${e}\`. +`,concatBytes:gI},Fxe=(t,e)=>{let r=new Uint8Array(t.length+e.length);return r.set(t,0),r.set(e,t.length),r},Lxe={windowsNewline:new Uint8Array([13,10]),unixNewline:new Uint8Array([10]),LF:10,concatBytes:Fxe}});import{Buffer as zxe}from"node:buffer";var KW,Uxe,JW,qxe,Bxe,YW,XW=y(()=>{on();KW=(t,e)=>t?void 0:Uxe.bind(void 0,e),Uxe=function*(t,e){if(typeof e!="string"&&!qt(e)&&!zxe.isBuffer(e))throw new TypeError(`The \`${t}\` option's transform must use "objectMode: true" to receive as input: ${typeof e}.`);yield e},JW=(t,e)=>t?qxe.bind(void 0,e):Bxe.bind(void 0,e),qxe=function*(t,e){YW(t,e),yield e},Bxe=function*(t,e){if(YW(t,e),typeof e!="string"&&!qt(e))throw new TypeError(`The \`${t}\` option's function must yield a string or an Uint8Array, not ${typeof e}.`);yield e},YW=(t,e)=>{if(e==null)throw new TypeError(`The \`${t}\` option's function must not call \`yield ${e}\`. Instead, \`yield\` should either be called with a value, or not be called at all. For example: - if (condition) { yield value; }`)}});import{Buffer as Uxe}from"node:buffer";import{StringDecoder as qxe}from"node:string_decoder";var tv,Bxe,Hxe,Gxe,_I=y(()=>{nn();tv=(t,e,r)=>{if(r)return;if(t)return{transform:Bxe.bind(void 0,new TextEncoder)};let n=new qxe(e);return{transform:Hxe.bind(void 0,n),final:Gxe.bind(void 0,n)}},Bxe=function*(t,e){Uxe.isBuffer(e)?yield _o(e):typeof e=="string"?yield t.encode(e):yield e},Hxe=function*(t,e){yield qt(e)?t.write(e):e},Gxe=function*(t){let e=t.end();e!==""&&(yield e)}});import{callbackify as YW}from"node:util";var bI,rv,XW,Zxe,QW,Vxe,e3=y(()=>{bI=YW(async(t,e,r,n)=>{e.currentIterable=t(...r);try{for await(let i of e.currentIterable)n.push(i)}finally{delete e.currentIterable}}),rv=async function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Vxe}=e[r];for await(let i of n(t))yield*rv(i,e,r+1)},XW=async function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Zxe(r,Number(e),t)},Zxe=async function*(t,e,r){if(t!==void 0)for await(let n of t())yield*rv(n,r,e+1)},QW=YW(async({currentIterable:t},e)=>{if(t!==void 0){await(e?t.throw(e):t.return());return}if(e)throw e}),Vxe=function*(t){yield t}});var vI,t3,Ma,op,Wxe,Kxe,SI=y(()=>{vI=(t,e,r,n)=>{try{for(let i of t(...e))r.push(i);n()}catch(i){n(i)}},t3=(t,e)=>[...e.flatMap(r=>[...Ma(r,t,0)]),...op(t)],Ma=function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Kxe}=e[r];for(let i of n(t))yield*Ma(i,e,r+1)},op=function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Wxe(r,Number(e),t)},Wxe=function*(t,e,r){if(t!==void 0)for(let n of t())yield*Ma(n,r,e+1)},Kxe=function*(t){yield t}});import{Transform as Jxe,getDefaultHighWaterMark as r3}from"node:stream";var wI,nv,n3,iv=y(()=>{Sr();ev();JW();_I();e3();SI();wI=({value:t,value:{transform:e,final:r,writableObjectMode:n,readableObjectMode:i},optionName:o},{encoding:s})=>{let a={},c=n3(t,s,o),l=ja(e),u=ja(r),d=l?bI.bind(void 0,rv,a):vI.bind(void 0,Ma),f=l||u?bI.bind(void 0,XW,a):vI.bind(void 0,op),p=l||u?QW.bind(void 0,a):void 0;return{stream:new Jxe({writableObjectMode:n,writableHighWaterMark:r3(n),readableObjectMode:i,readableHighWaterMark:r3(i),transform(h,g,b){d([h,c,0],this,b)},flush(h){f([c],this,h)},destroy:p})}},nv=(t,e,r,n)=>{let i=e.filter(({type:s})=>s==="generator"),o=n?i.reverse():i;for(let{value:s,optionName:a}of o){let c=n3(s,r,a);t=t3(c,t)}return t},n3=({transform:t,final:e,binary:r,writableObjectMode:n,readableObjectMode:i,preserveNewlines:o},s,a)=>{let c={};return[{transform:VW(n,a)},tv(r,s,n),Qb(r,o,n,c),{transform:t,final:e},{transform:WW(i,a)},ZW({binary:r,preserveNewlines:o,readableObjectMode:i,state:c})].filter(Boolean)}});var i3,Yxe,Xxe,Qxe,e0e,o3=y(()=>{iv();nn();Sr();i3=(t,e)=>{for(let r of Yxe(t))Xxe(t,r,e)},Yxe=t=>new Set(Object.entries(t).filter(([,{direction:e}])=>e==="input").map(([e])=>Number(e))),Xxe=(t,e,r)=>{let{stdioItems:n}=t[e],i=n.filter(({contents:a})=>a!==void 0);if(i.length===0)return;if(e!==0){let[{type:a,optionName:c}]=i;throw new TypeError(`Only the \`stdin\` option, not \`${c}\`, can be ${ps[a]} with synchronous methods.`)}let s=i.map(({contents:a})=>a).map(a=>Qxe(a,n));r.input=Bf(s)},Qxe=(t,e)=>{let r=nv(t,e,"utf8",!0);return e0e(r),Bf(r)},e0e=t=>{let e=t.find(r=>typeof r!="string"&&!qt(r));if(e!==void 0)throw new TypeError(`The \`stdin\` option is invalid: when passing objects as input, a transform must be used to serialize them to strings or Uint8Arrays: ${e}.`)}});var ov,t0e,r0e,s3,a3,n0e,c3,xI=y(()=>{Pa();Sr();El();ls();ov=({stdioItems:t,encoding:e,verboseInfo:r,fdNumber:n})=>n!=="all"&&kl(r,n)&&!on.has(e)&&t0e(n)&&(t.some(({type:i,value:o})=>i==="native"&&r0e.has(o))||t.every(({type:i})=>On.has(i))),t0e=t=>t===1||t===2,r0e=new Set(["pipe","overlapped"]),s3=async(t,e,r,n)=>{for await(let i of t)n0e(e)||c3(i,r,n)},a3=(t,e,r)=>{for(let n of t)c3(n,e,r)},n0e=t=>t._readableState.pipes.length>0,c3=(t,e,r)=>{let n=ib(t);Pi({type:"output",verboseMessage:n,fdNumber:e,verboseInfo:r})}});import{writeFileSync as i0e,appendFileSync as o0e}from"node:fs";var l3,s0e,a0e,c0e,l0e,u0e,u3=y(()=>{xI();iv();ev();nn();Sr();Na();l3=({fileDescriptors:t,syncResult:{output:e},options:r,isMaxBuffer:n,verboseInfo:i})=>{if(e===null)return{output:Array.from({length:3})};let o={},s=new Set([]);return{output:e.map((c,l)=>s0e({result:c,fileDescriptors:t,fdNumber:l,state:o,outputFiles:s,isMaxBuffer:n,verboseInfo:i},r)),...o}},s0e=({result:t,fileDescriptors:e,fdNumber:r,state:n,outputFiles:i,isMaxBuffer:o,verboseInfo:s},{buffer:a,encoding:c,lines:l,stripFinalNewline:u,maxBuffer:d})=>{if(t===null)return;let f=WV(t,o,d),p=_o(f),{stdioItems:m,objectMode:h}=e[r],g=a0e([p],m,c,n),{serializedResult:b,finalResult:_=b}=c0e({chunks:g,objectMode:h,encoding:c,lines:l,stripFinalNewline:u,fdNumber:r});l0e({serializedResult:b,fdNumber:r,state:n,verboseInfo:s,encoding:c,stdioItems:m,objectMode:h});let S=a[r]?_:void 0;try{return n.error===void 0&&u0e(b,m,i),S}catch(x){return n.error=x,S}},a0e=(t,e,r,n)=>{try{return nv(t,e,r,!1)}catch(i){return n.error=i,t}},c0e=({chunks:t,objectMode:e,encoding:r,lines:n,stripFinalNewline:i,fdNumber:o})=>{if(e)return{serializedResult:t};if(r==="buffer")return{serializedResult:Bf(t)};let s=FG(t,r);return n[o]?{serializedResult:s,finalResult:yI(s,!i[o],e)}:{serializedResult:s}},l0e=({serializedResult:t,fdNumber:e,state:r,verboseInfo:n,encoding:i,stdioItems:o,objectMode:s})=>{if(!ov({stdioItems:o,encoding:i,verboseInfo:n,fdNumber:e}))return;let a=yI(t,!1,s);try{a3(a,e,n)}catch(c){r.error??=c}},u0e=(t,e,r)=>{for(let{path:n,append:i}of e.filter(({type:o})=>Jb.has(o))){let o=typeof n=="string"?n:n.toString();i||r.has(o)?o0e(n,t):(r.add(o),i0e(n,t))}}});var d3,f3=y(()=>{nn();ip();d3=([,t,e],r)=>{if(r.all)return t===void 0?e:e===void 0?t:Array.isArray(t)?Array.isArray(e)?[...t,...e]:[...t,xo(e,r,"all")]:Array.isArray(e)?[xo(t,r,"all"),...e]:qt(t)&&qt(e)?fR([t,e]):`${t}${e}`}});import{once as $I}from"node:events";var p3,d0e,m3,h3,f0e,kI,EI=y(()=>{Ra();p3=async(t,e)=>{let[r,n]=await d0e(t);return e.isForcefullyTerminated??=!1,[r,n]},d0e=async t=>{let[e,r]=await Promise.allSettled([$I(t,"spawn"),$I(t,"exit")]);return e.status==="rejected"?[]:r.status==="rejected"?m3(t):r.value},m3=async t=>{try{return await $I(t,"exit")}catch{return m3(t)}},h3=async t=>{let[e,r]=await t;if(!f0e(e,r)&&kI(e,r))throw new ei;return[e,r]},f0e=(t,e)=>t===void 0&&e===void 0,kI=(t,e)=>t!==0||e!==null});var g3,p0e,y3=y(()=>{Ra();Na();EI();g3=({error:t,status:e,signal:r,output:n},{maxBuffer:i})=>{let o=p0e(t,e,r),s=o?.code==="ETIMEDOUT",a=VV(o,n,i);return{resultError:o,exitCode:e,signal:r,timedOut:s,isMaxBuffer:a}},p0e=(t,e,r)=>t!==void 0?t:kI(e,r)?new ei:void 0});import{spawnSync as m0e}from"node:child_process";var _3,h0e,g0e,y0e,sv,_0e,b0e,v0e,S0e,b3=y(()=>{SR();KR();JR();np();Vb();BW();ip();o3();u3();Na();f3();y3();_3=(t,e,r)=>{let{file:n,commandArguments:i,command:o,escapedCommand:s,startTime:a,verboseInfo:c,options:l,fileDescriptors:u}=h0e(t,e,r),d=_0e({file:n,commandArguments:i,options:l,command:o,escapedCommand:s,verboseInfo:c,fileDescriptors:u,startTime:a});return Ml(d,c,l)},h0e=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ab(t,e,r),a=g0e(r),{file:c,commandArguments:l,options:u}=Db(t,e,a);y0e(u);let d=UW(u,s);return{file:c,commandArguments:l,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},g0e=t=>t.node&&!t.ipc?{...t,ipc:!1}:t,y0e=({ipc:t,ipcInput:e,detached:r,cancelSignal:n})=>{e&&sv("ipcInput"),t&&sv("ipc: true"),r&&sv("detached: true"),n&&sv("cancelSignal")},sv=t=>{throw new TypeError(`The "${t}" option cannot be used with synchronous methods.`)},_0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,verboseInfo:o,fileDescriptors:s,startTime:a})=>{let c=b0e({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:s,startTime:a});if(c.failed)return c;let{resultError:l,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p}=g3(c,r),{output:m,error:h=l}=l3({fileDescriptors:s,syncResult:c,options:r,isMaxBuffer:p,verboseInfo:o}),g=m.map((_,S)=>xo(_,r,S)),b=xo(d3(m,r),r,"all");return S0e({error:h,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p,stdio:g,all:b,options:r,command:n,escapedCommand:i,startTime:a})},b0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:o,startTime:s})=>{try{i3(o,r);let a=v0e(r);return m0e(...Nb(t,e,a))}catch(a){return jl({error:a,command:n,escapedCommand:i,fileDescriptors:o,options:r,startTime:s,isSync:!0})}},v0e=({encoding:t,maxBuffer:e,...r})=>({...r,encoding:"buffer",maxBuffer:Gb(e)}),S0e=({error:t,exitCode:e,signal:r,timedOut:n,isMaxBuffer:i,stdio:o,all:s,options:a,command:c,escapedCommand:l,startTime:u})=>t===void 0?Zb({command:c,escapedCommand:l,stdio:o,all:s,ipcOutput:[],options:a,startTime:u}):rp({error:t,command:c,escapedCommand:l,timedOut:n,isCanceled:!1,isGracefullyCanceled:!1,isMaxBuffer:i,isForcefullyTerminated:!1,exitCode:e,signal:r,stdio:o,all:s,ipcOutput:[],options:a,startTime:u,isSync:!0})});import{once as AI,on as w0e}from"node:events";var v3,x0e,$0e,k0e,E0e,S3=y(()=>{Il();Yf();Jf();v3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0,filter:o}={})=>(Ol({methodName:"getOneMessage",isSubprocess:r,ipc:n,isConnected:Ab(t)}),x0e({anyProcess:t,channel:e,isSubprocess:r,filter:o,reference:i})),x0e=async({anyProcess:t,channel:e,isSubprocess:r,filter:n,reference:i})=>{vb(e,i);let o=fs(t,e,r),s=new AbortController;try{return await Promise.race([$0e(o,n,s),k0e(o,r,s),E0e(o,r,s)])}catch(a){throw Rl(t),a}finally{s.abort(),Sb(e,i)}},$0e=async(t,e,{signal:r})=>{if(e===void 0){let[n]=await AI(t,"message",{signal:r});return n}for await(let[n]of w0e(t,"message",{signal:r}))if(e(n))return n},k0e=async(t,e,{signal:r})=>{await AI(t,"disconnect",{signal:r}),P9(e)},E0e=async(t,e,{signal:r})=>{let[n]=await AI(t,"strict:error",{signal:r});throw gb(n,e)}});import{once as x3,on as A0e}from"node:events";var $3,TI,T0e,O0e,R0e,w3,OI=y(()=>{Il();Yf();Jf();$3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0}={})=>TI({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:!r,reference:i}),TI=({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:i,reference:o})=>{Ol({methodName:"getEachMessage",isSubprocess:r,ipc:n,isConnected:Ab(t)}),vb(e,o);let s=fs(t,e,r),a=new AbortController,c={};return T0e(t,s,a),O0e({ipcEmitter:s,isSubprocess:r,controller:a,state:c}),R0e({anyProcess:t,channel:e,ipcEmitter:s,isSubprocess:r,shouldAwait:i,controller:a,state:c,reference:o})},T0e=async(t,e,r)=>{try{await x3(e,"disconnect",{signal:r.signal}),r.abort()}catch{}},O0e=async({ipcEmitter:t,isSubprocess:e,controller:r,state:n})=>{try{let[i]=await x3(t,"strict:error",{signal:r.signal});n.error=gb(i,e),r.abort()}catch{}},R0e=async function*({anyProcess:t,channel:e,ipcEmitter:r,isSubprocess:n,shouldAwait:i,controller:o,state:s,reference:a}){try{for await(let[c]of A0e(r,"message",{signal:o.signal}))w3(s),yield c}catch{w3(s)}finally{o.abort(),Sb(e,a),n||Rl(t),i&&await t}},w3=({error:t})=>{if(t)throw t}});import k3 from"node:process";var E3,A3,T3,RI=y(()=>{Pb();S3();OI();kb();E3=(t,{ipc:e})=>{Object.assign(t,T3(t,!1,e))},A3=()=>{let t=k3,e=!0,r=k3.channel!==void 0;return{...T3(t,e,r),getCancelSignal:sV.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})}},T3=(t,e,r)=>({sendMessage:Ib.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getOneMessage:v3.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getEachMessage:$3.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})})});import{ChildProcess as I0e}from"node:child_process";import{PassThrough as P0e,Readable as C0e,Writable as D0e,Duplex as N0e}from"node:stream";var O3,j0e,sp,M0e,F0e,L0e,z0e,R3=y(()=>{Xb();np();Vb();O3=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,verboseInfo:s})=>{mI(n);let a=new I0e;j0e(a,n),Object.assign(a,{readable:M0e,writable:F0e,duplex:L0e});let c=jl({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:!1}),l=z0e(c,s,i);return{subprocess:a,promise:l}},j0e=(t,e)=>{let r=sp(),n=sp(),i=sp(),o=Array.from({length:e.length-3},sp),s=sp(),a=[r,n,i,...o];Object.assign(t,{stdin:r,stdout:n,stderr:i,all:s,stdio:a})},sp=()=>{let t=new P0e;return t.end(),t},M0e=()=>new C0e({read(){}}),F0e=()=>new D0e({write(){}}),L0e=()=>new N0e({read(){},write(){}}),z0e=async(t,e,r)=>Ml(t,e,r)});import{createReadStream as I3,createWriteStream as P3}from"node:fs";import{Buffer as U0e}from"node:buffer";import{Readable as ap,Writable as q0e,Duplex as B0e}from"node:stream";var D3,cp,C3,H0e,N3=y(()=>{iv();Xb();Sr();D3=(t,e)=>Yb(H0e,t,e,!1),cp=({type:t,optionName:e})=>{throw new TypeError(`The \`${e}\` option cannot be ${ps[t]}.`)},C3={fileNumber:cp,generator:wI,asyncGenerator:wI,nodeStream:({value:t})=>({stream:t}),webTransform({value:{transform:t,writableObjectMode:e,readableObjectMode:r}}){let n=e||r;return{stream:B0e.fromWeb(t,{objectMode:n})}},duplex:({value:{transform:t}})=>({stream:t}),native(){}},H0e={input:{...C3,fileUrl:({value:t})=>({stream:I3(t)}),filePath:({value:{file:t}})=>({stream:I3(t)}),webStream:({value:t})=>({stream:ap.fromWeb(t)}),iterable:({value:t})=>({stream:ap.from(t)}),asyncIterable:({value:t})=>({stream:ap.from(t)}),string:({value:t})=>({stream:ap.from(t)}),uint8Array:({value:t})=>({stream:ap.from(U0e.from(t))})},output:{...C3,fileUrl:({value:t})=>({stream:P3(t)}),filePath:({value:{file:t,append:e}})=>({stream:P3(t,e?{flags:"a"}:{})}),webStream:({value:t})=>({stream:q0e.fromWeb(t)}),iterable:cp,asyncIterable:cp,string:cp,uint8Array:cp}}});import{on as G0e,once as j3}from"node:events";import{PassThrough as Z0e,getDefaultHighWaterMark as V0e}from"node:stream";import{finished as L3}from"node:stream/promises";function Fa(t){if(!Array.isArray(t))throw new TypeError(`Expected an array, got \`${typeof t}\`.`);for(let i of t)PI(i);let e=t.some(({readableObjectMode:i})=>i),r=W0e(t,e),n=new II({objectMode:e,writableHighWaterMark:r,readableHighWaterMark:r});for(let i of t)n.add(i);return n}var W0e,II,K0e,J0e,Y0e,PI,X0e,Q0e,e$e,t$e,r$e,z3,U3,CI,q3,n$e,av,M3,F3,cv=y(()=>{W0e=(t,e)=>{if(t.length===0)return V0e(e);let r=t.filter(({readableObjectMode:n})=>n===e).map(({readableHighWaterMark:n})=>n);return Math.max(...r)},II=class extends Z0e{#t=new Set([]);#r=new Set([]);#e=new Set([]);#n;#o=Symbol("unpipe");#i=new WeakMap;add(e){if(PI(e),this.#t.has(e))return;this.#t.add(e),this.#n??=K0e(this,this.#t,this.#o);let r=X0e({passThroughStream:this,stream:e,streams:this.#t,ended:this.#r,aborted:this.#e,onFinished:this.#n,unpipeEvent:this.#o});this.#i.set(e,r),e.pipe(this,{end:!1})}async remove(e){if(PI(e),!this.#t.has(e))return!1;let r=this.#i.get(e);return r===void 0?!1:(this.#i.delete(e),e.unpipe(this),await r,!0)}},K0e=async(t,e,r)=>{av(t,M3);let n=new AbortController;try{await Promise.race([J0e(t,n),Y0e(t,e,r,n)])}finally{n.abort(),av(t,-M3)}},J0e=async(t,{signal:e})=>{try{await L3(t,{signal:e,cleanup:!0})}catch(r){throw z3(t,r),r}},Y0e=async(t,e,r,{signal:n})=>{for await(let[i]of G0e(t,"unpipe",{signal:n}))e.has(i)&&i.emit(r)},PI=t=>{if(typeof t?.pipe!="function")throw new TypeError(`Expected a readable stream, got: \`${typeof t}\`.`)},X0e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,onFinished:o,unpipeEvent:s})=>{av(t,F3);let a=new AbortController;try{await Promise.race([Q0e(o,e,a),e$e({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:a}),t$e({stream:e,streams:r,ended:n,aborted:i,unpipeEvent:s,controller:a})])}finally{a.abort(),av(t,-F3)}r.size>0&&r.size===n.size+i.size&&(n.size===0&&i.size>0?CI(t):r$e(t))},Q0e=async(t,e,{signal:r})=>{try{await t,r.aborted||CI(e)}catch(n){r.aborted||z3(e,n)}},e$e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:{signal:o}})=>{try{await L3(e,{signal:o,cleanup:!0,readable:!0,writable:!1}),r.has(e)&&n.add(e)}catch(s){if(o.aborted||!r.has(e))return;U3(s)?i.add(e):q3(t,s)}},t$e=async({stream:t,streams:e,ended:r,aborted:n,unpipeEvent:i,controller:{signal:o}})=>{if(await j3(t,i,{signal:o}),!t.readable)return j3(o,"abort",{signal:o});e.delete(t),r.delete(t),n.delete(t)},r$e=t=>{t.writable&&t.end()},z3=(t,e)=>{U3(e)?CI(t):q3(t,e)},U3=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",CI=t=>{(t.readable||t.writable)&&t.destroy()},q3=(t,e)=>{t.destroyed||(t.once("error",n$e),t.destroy(e))},n$e=()=>{},av=(t,e)=>{let r=t.getMaxListeners();r!==0&&r!==Number.POSITIVE_INFINITY&&t.setMaxListeners(r+e)},M3=2,F3=1});import{finished as B3}from"node:stream/promises";var Ll,i$e,DI,o$e,NI,lv=y(()=>{bo();Ll=(t,e)=>{t.pipe(e),i$e(t,e),o$e(t,e)},i$e=async(t,e)=>{if(!(Qn(t)||Qn(e))){try{await B3(t,{cleanup:!0,readable:!0,writable:!1})}catch{}DI(e)}},DI=t=>{t.writable&&t.end()},o$e=async(t,e)=>{if(!(Qn(t)||Qn(e))){try{await B3(e,{cleanup:!0,readable:!1,writable:!0})}catch{}NI(t)}},NI=t=>{t.readable&&t.destroy()}});var H3,s$e,a$e,c$e,l$e,u$e,G3=y(()=>{cv();bo();bb();Sr();lv();H3=(t,e,r)=>{let n=new Map;for(let[i,{stdioItems:o,direction:s}]of Object.entries(e)){for(let{stream:a}of o.filter(({type:c})=>On.has(c)))s$e(t,a,s,i);for(let{stream:a}of o.filter(({type:c})=>!On.has(c)))c$e({subprocess:t,stream:a,direction:s,fdNumber:i,pipeGroups:n,controller:r})}for(let[i,o]of n.entries()){let s=o.length===1?o[0]:Fa(o);Ll(s,i)}},s$e=(t,e,r,n)=>{r==="output"?Ll(t.stdio[n],e):Ll(e,t.stdio[n]);let i=a$e[n];i!==void 0&&(t[i]=e),t.stdio[n]=e},a$e=["stdin","stdout","stderr"],c$e=({subprocess:t,stream:e,direction:r,fdNumber:n,pipeGroups:i,controller:o})=>{if(e===void 0)return;l$e(e,o);let[s,a]=r==="output"?[e,t.stdio[n]]:[t.stdio[n],e],c=i.get(s)??[];i.set(s,[...c,a])},l$e=(t,{signal:e})=>{Qn(t)&&Ia(t,u$e,e)},u$e=2});var La,Z3=y(()=>{La=[];La.push("SIGHUP","SIGINT","SIGTERM");process.platform!=="win32"&&La.push("SIGALRM","SIGABRT","SIGVTALRM","SIGXCPU","SIGXFSZ","SIGUSR2","SIGTRAP","SIGSYS","SIGQUIT","SIGIOT");process.platform==="linux"&&La.push("SIGIO","SIGPOLL","SIGPWR","SIGSTKFLT")});var uv,jI,MI,d$e,FI,dv,f$e,LI,zI,UI,V3,rat,nat,W3=y(()=>{Z3();uv=t=>!!t&&typeof t=="object"&&typeof t.removeListener=="function"&&typeof t.emit=="function"&&typeof t.reallyExit=="function"&&typeof t.listeners=="function"&&typeof t.kill=="function"&&typeof t.pid=="number"&&typeof t.on=="function",jI=Symbol.for("signal-exit emitter"),MI=globalThis,d$e=Object.defineProperty.bind(Object),FI=class{emitted={afterExit:!1,exit:!1};listeners={afterExit:[],exit:[]};count=0;id=Math.random();constructor(){if(MI[jI])return MI[jI];d$e(MI,jI,{value:this,writable:!1,enumerable:!1,configurable:!1})}on(e,r){this.listeners[e].push(r)}removeListener(e,r){let n=this.listeners[e],i=n.indexOf(r);i!==-1&&(i===0&&n.length===1?n.length=0:n.splice(i,1))}emit(e,r,n){if(this.emitted[e])return!1;this.emitted[e]=!0;let i=!1;for(let o of this.listeners[e])i=o(r,n)===!0||i;return e==="exit"&&(i=this.emit("afterExit",r,n)||i),i}},dv=class{},f$e=t=>({onExit(e,r){return t.onExit(e,r)},load(){return t.load()},unload(){return t.unload()}}),LI=class extends dv{onExit(){return()=>{}}load(){}unload(){}},zI=class extends dv{#t=UI.platform==="win32"?"SIGINT":"SIGHUP";#r=new FI;#e;#n;#o;#i={};#s=!1;constructor(e){super(),this.#e=e,this.#i={};for(let r of La)this.#i[r]=()=>{let n=this.#e.listeners(r),{count:i}=this.#r,o=e;if(typeof o.__signal_exit_emitter__=="object"&&typeof o.__signal_exit_emitter__.count=="number"&&(i+=o.__signal_exit_emitter__.count),n.length===i){this.unload();let s=this.#r.emit("exit",null,r),a=r==="SIGHUP"?this.#t:r;s||e.kill(e.pid,a)}};this.#o=e.reallyExit,this.#n=e.emit}onExit(e,r){if(!uv(this.#e))return()=>{};this.#s===!1&&this.load();let n=r?.alwaysLast?"afterExit":"exit";return this.#r.on(n,e),()=>{this.#r.removeListener(n,e),this.#r.listeners.exit.length===0&&this.#r.listeners.afterExit.length===0&&this.unload()}}load(){if(!this.#s){this.#s=!0,this.#r.count+=1;for(let e of La)try{let r=this.#i[e];r&&this.#e.on(e,r)}catch{}this.#e.emit=(e,...r)=>this.#c(e,...r),this.#e.reallyExit=e=>this.#a(e)}}unload(){this.#s&&(this.#s=!1,La.forEach(e=>{let r=this.#i[e];if(!r)throw new Error("Listener not defined for signal: "+e);try{this.#e.removeListener(e,r)}catch{}}),this.#e.emit=this.#n,this.#e.reallyExit=this.#o,this.#r.count-=1)}#a(e){return uv(this.#e)?(this.#e.exitCode=e||0,this.#r.emit("exit",this.#e.exitCode,null),this.#o.call(this.#e,this.#e.exitCode)):0}#c(e,...r){let n=this.#n;if(e==="exit"&&uv(this.#e)){typeof r[0]=="number"&&(this.#e.exitCode=r[0]);let i=n.call(this.#e,e,...r);return this.#r.emit("exit",this.#e.exitCode,null),i}else return n.call(this.#e,e,...r)}},UI=globalThis.process,{onExit:V3,load:rat,unload:nat}=f$e(uv(UI)?new zI(UI):new LI)});import{addAbortListener as p$e}from"node:events";var K3,J3=y(()=>{W3();K3=(t,{cleanup:e,detached:r},{signal:n})=>{if(!e||r)return;let i=V3(()=>{t.kill()});p$e(n,()=>{i()})}});var X3,m$e,h$e,Y3,g$e,Q3=y(()=>{dR();sb();ds();xl();X3=({source:t,sourcePromise:e,boundOptions:r,createNested:n},...i)=>{let o=ob(),{destination:s,destinationStream:a,destinationError:c,from:l,unpipeSignal:u}=m$e(r,n,i),{sourceStream:d,sourceError:f}=g$e(t,l),{options:p,fileDescriptors:m}=Di.get(t);return{sourcePromise:e,sourceStream:d,sourceOptions:p,sourceError:f,destination:s,destinationStream:a,destinationError:c,unpipeSignal:u,fileDescriptors:m,startTime:o}},m$e=(t,e,r)=>{try{let{destination:n,pipeOptions:{from:i,to:o,unpipeSignal:s}={}}=h$e(t,e,...r),a=_b(n,o);return{destination:n,destinationStream:a,from:i,unpipeSignal:s}}catch(n){return{destinationError:n}}},h$e=(t,e,r,...n)=>{if(Array.isArray(r))return{destination:e(Y3,t)(r,...n),pipeOptions:t};if(typeof r=="string"||r instanceof URL||lR(r)){if(Object.keys(t).length>0)throw new TypeError('Please use .pipe("file", ..., options) or .pipe(execa("file", ..., options)) instead of .pipe(options)("file", ...).');let[i,o,s]=W_(r,...n);return{destination:e(Y3)(i,o,s),pipeOptions:s}}if(Di.has(r)){if(Object.keys(t).length>0)throw new TypeError("Please use .pipe(options)`command` or .pipe($(options)`command`) instead of .pipe(options)($`command`).");return{destination:r,pipeOptions:n[0]}}throw new TypeError(`The first argument must be a template string, an options object, or an Execa subprocess: ${r}`)},Y3=({options:t})=>({options:{...t,stdin:"pipe",piped:!0}}),g$e=(t,e)=>{try{return{sourceStream:Cl(t,e)}}catch(r){return{sourceError:r}}}});var tK,y$e,qI,eK,BI=y(()=>{np();lv();tK=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n,fileDescriptors:i,sourceOptions:o,startTime:s})=>{let a=y$e({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n});if(a!==void 0)throw qI({error:a,fileDescriptors:i,sourceOptions:o,startTime:s})},y$e=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n})=>{if(e!==void 0&&n!==void 0)return n;if(n!==void 0)return NI(t),n;if(e!==void 0)return DI(r),e},qI=({error:t,fileDescriptors:e,sourceOptions:r,startTime:n})=>jl({error:t,command:eK,escapedCommand:eK,fileDescriptors:e,options:r,startTime:n,isSync:!1}),eK="source.pipe(destination)"});var rK,nK=y(()=>{rK=async t=>{let[{status:e,reason:r,value:n=r},{status:i,reason:o,value:s=o}]=await t;if(s.pipedFrom.includes(n)||s.pipedFrom.push(n),i==="rejected")throw s;if(e==="rejected")throw n;return s}});import{finished as _$e}from"node:stream/promises";var iK,b$e,v$e,S$e,fv,w$e,x$e,oK=y(()=>{cv();bb();lv();iK=(t,e,r)=>{let n=fv.has(e)?v$e(t,e):b$e(t,e);return Ia(t,w$e,r.signal),Ia(e,x$e,r.signal),S$e(e),n},b$e=(t,e)=>{let r=Fa([t]);return Ll(r,e),fv.set(e,r),r},v$e=(t,e)=>{let r=fv.get(e);return r.add(t),r},S$e=async t=>{try{await _$e(t,{cleanup:!0,readable:!1,writable:!0})}catch{}fv.delete(t)},fv=new WeakMap,w$e=2,x$e=1});import{aborted as $$e}from"node:util";var sK,k$e,aK=y(()=>{BI();sK=(t,e)=>t===void 0?[]:[k$e(t,e)],k$e=async(t,{sourceStream:e,mergedStream:r,fileDescriptors:n,sourceOptions:i,startTime:o})=>{await $$e(t,e),await r.remove(e);let s=new Error("Pipe canceled by `unpipeSignal` option.");throw qI({error:s,fileDescriptors:n,sourceOptions:i,startTime:o})}});var pv,E$e,A$e,cK=y(()=>{yo();Q3();BI();nK();oK();aK();pv=(t,...e)=>{if(Ot(e[0]))return pv.bind(void 0,{...t,boundOptions:{...t.boundOptions,...e[0]}});let{destination:r,...n}=X3(t,...e),i=E$e({...n,destination:r});return i.pipe=pv.bind(void 0,{...t,source:r,sourcePromise:i,boundOptions:{}}),i},E$e=async({sourcePromise:t,sourceStream:e,sourceOptions:r,sourceError:n,destination:i,destinationStream:o,destinationError:s,unpipeSignal:a,fileDescriptors:c,startTime:l})=>{let u=A$e(t,i);tK({sourceStream:e,sourceError:n,destinationStream:o,destinationError:s,fileDescriptors:c,sourceOptions:r,startTime:l});let d=new AbortController;try{let f=iK(e,o,d);return await Promise.race([rK(u),...sK(a,{sourceStream:e,mergedStream:f,sourceOptions:r,fileDescriptors:c,startTime:l})])}finally{d.abort()}},A$e=(t,e)=>Promise.allSettled([t,e])});import{on as T$e}from"node:events";import{getDefaultHighWaterMark as O$e}from"node:stream";var mv,R$e,HI,I$e,uK,GI,lK,P$e,C$e,hv=y(()=>{_I();ev();SI();mv=({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:n,encoding:i,preserveNewlines:o})=>{let s=new AbortController;return R$e(e,s),uK({stream:t,controller:s,binary:r,shouldEncode:!t.readableObjectMode&&n,encoding:i,shouldSplit:!t.readableObjectMode,preserveNewlines:o})},R$e=async(t,e)=>{try{await t}catch{}finally{e.abort()}},HI=({stream:t,onStreamEnd:e,lines:r,encoding:n,stripFinalNewline:i,allMixed:o})=>{let s=new AbortController;I$e(e,s,t);let a=t.readableObjectMode&&!o;return uK({stream:t,controller:s,binary:n==="buffer",shouldEncode:!a,encoding:n,shouldSplit:!a&&r,preserveNewlines:!i})},I$e=async(t,e,r)=>{try{await t}catch{r.destroy()}finally{e.abort()}},uK=({stream:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})=>{let a=T$e(t,"data",{signal:e.signal,highWaterMark:lK,highWatermark:lK});return P$e({onStdoutChunk:a,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})},GI=O$e(!0),lK=GI,P$e=async function*({onStdoutChunk:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s}){let a=C$e({binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s});try{for await(let[c]of t)yield*Ma(c,a,0)}catch(c){if(!e.signal.aborted)throw c}finally{yield*op(a)}},C$e=({binary:t,shouldEncode:e,encoding:r,shouldSplit:n,preserveNewlines:i})=>[tv(t,r,!e),Qb(t,i,!n,{})].filter(Boolean)});import{setImmediate as D$e}from"node:timers/promises";var dK,N$e,j$e,M$e,ZI,fK,VI=y(()=>{Hb();nn();xI();hv();Na();ip();dK=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,buffer:i,maxBuffer:o,lines:s,allMixed:a,stripFinalNewline:c,verboseInfo:l,streamInfo:u})=>{let d=N$e({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:a,verboseInfo:l,streamInfo:u});if(!i){await Promise.all([j$e(t),d]);return}let f=hI(c,r),p=HI({stream:t,onStreamEnd:e,lines:s,encoding:n,stripFinalNewline:f,allMixed:a}),[m]=await Promise.all([M$e({stream:t,iterable:p,fdNumber:r,encoding:n,maxBuffer:o,lines:s}),d]);return m},N$e=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:i,verboseInfo:o,streamInfo:{fileDescriptors:s}})=>{if(!ov({stdioItems:s[r]?.stdioItems,encoding:n,verboseInfo:o,fdNumber:r}))return;let a=HI({stream:t,onStreamEnd:e,lines:!0,encoding:n,stripFinalNewline:!0,allMixed:i});await s3(a,t,r,o)},j$e=async t=>{await D$e(),t.readableFlowing===null&&t.resume()},M$e=async({stream:t,stream:{readableObjectMode:e},iterable:r,fdNumber:n,encoding:i,maxBuffer:o,lines:s})=>{try{return e||s?await zb(r,{maxBuffer:o}):i==="buffer"?new Uint8Array(await Ub(r,{maxBuffer:o})):await Bb(r,{maxBuffer:o})}catch(a){return fK(HV({error:a,stream:t,readableObjectMode:e,lines:s,encoding:i,fdNumber:n}))}},ZI=async t=>{try{return await t}catch(e){return fK(e)}},fK=({bufferedData:t})=>jG(t)?new Uint8Array(t):t});import{finished as F$e}from"node:stream/promises";var lp,L$e,z$e,U$e,q$e,B$e,WI,gv,pK,yv=y(()=>{lp=async(t,e,r,{isSameDirection:n,stopOnExit:i=!1}={})=>{let o=L$e(t,r),s=new AbortController;try{await Promise.race([...i?[r.exitPromise]:[],F$e(t,{cleanup:!0,signal:s.signal})])}catch(a){o.stdinCleanedUp||q$e(a,e,r,n)}finally{s.abort()}},L$e=(t,{originalStreams:[e],subprocess:r})=>{let n={stdinCleanedUp:!1};return t===e&&z$e(t,r,n),n},z$e=(t,e,r)=>{let{_destroy:n}=t;t._destroy=(...i)=>{U$e(e,r),n.call(t,...i)}},U$e=({exitCode:t,signalCode:e},r)=>{(t!==null||e!==null)&&(r.stdinCleanedUp=!0)},q$e=(t,e,r,n)=>{if(!B$e(t,e,r,n))throw t},B$e=(t,e,r,n=!0)=>r.propagating?pK(t)||gv(t):(r.propagating=!0,WI(r,e)===n?pK(t):gv(t)),WI=({fileDescriptors:t},e)=>e!=="all"&&t[e].direction==="input",gv=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",pK=t=>t?.code==="EPIPE"});var mK,KI,JI=y(()=>{VI();yv();mK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>t.stdio.map((c,l)=>KI({stream:c,fdNumber:l,encoding:e,buffer:r[l],maxBuffer:n[l],lines:i[l],allMixed:!1,stripFinalNewline:o,verboseInfo:s,streamInfo:a})),KI=async({stream:t,fdNumber:e,encoding:r,buffer:n,maxBuffer:i,lines:o,allMixed:s,stripFinalNewline:a,verboseInfo:c,streamInfo:l})=>{if(!t)return;let u=lp(t,e,l);if(WI(l,e)){await u;return}let[d]=await Promise.all([dK({stream:t,onStreamEnd:u,fdNumber:e,encoding:r,buffer:n,maxBuffer:i,lines:o,allMixed:s,stripFinalNewline:a,verboseInfo:c,streamInfo:l}),u]);return d}});var hK,gK,H$e,G$e,YI=y(()=>{cv();JI();hK=({stdout:t,stderr:e},{all:r})=>r&&(t||e)?Fa([t,e].filter(Boolean)):void 0,gK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>KI({...H$e(t,r),fdNumber:"all",encoding:e,maxBuffer:n[1]+n[2],lines:i[1]||i[2],allMixed:G$e(t),stripFinalNewline:o,verboseInfo:s,streamInfo:a}),H$e=({stdout:t,stderr:e,all:r},[,n,i])=>{let o=n||i;return o?n?i?{stream:r,buffer:o}:{stream:t,buffer:o}:{stream:e,buffer:o}:{stream:r,buffer:o}},G$e=({all:t,stdout:e,stderr:r})=>t&&e&&r&&e.readableObjectMode!==r.readableObjectMode});var yK,_K,bK=y(()=>{El();ls();yK=t=>kl(t,"ipc"),_K=(t,e)=>{let r=ib(t);Pi({type:"ipc",verboseMessage:r,fdNumber:"ipc",verboseInfo:e})}});var vK,SK,wK=y(()=>{Na();bK();So();OI();vK=async({subprocess:t,buffer:e,maxBuffer:r,ipc:n,ipcOutput:i,verboseInfo:o})=>{if(!n)return i;let s=yK(o),a=vo(e,"ipc"),c=vo(r,"ipc");for await(let l of TI({anyProcess:t,channel:t.channel,isSubprocess:!1,ipc:n,shouldAwait:!1,reference:!0}))a&&(GV(t,i,c),i.push(l)),s&&_K(l,o);return i},SK=async(t,e)=>(await Promise.allSettled([t]),e)});import{once as Z$e}from"node:events";var xK,V$e,W$e,K$e,$K=y(()=>{Da();HR();NR();BR();bo();Sr();VI();wK();ZR();YI();JI();EI();yv();xK=async({subprocess:t,options:{encoding:e,buffer:r,maxBuffer:n,lines:i,timeoutDuration:o,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,stripFinalNewline:l,ipc:u,ipcInput:d},context:f,verboseInfo:p,fileDescriptors:m,originalStreams:h,onInternalError:g,controller:b})=>{let _=p3(t,f),S={originalStreams:h,fileDescriptors:m,subprocess:t,exitPromise:_,propagating:!1},x=mK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),w=gK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),O=[],T=vK({subprocess:t,buffer:r,maxBuffer:n,ipc:u,ipcOutput:O,verboseInfo:p}),A=V$e(h,t,S),D=W$e(m,S);try{return await Promise.race([Promise.all([{},h3(_),Promise.all(x),w,T,gV(t,d),...A,...D]),g,K$e(t,b),...dV(t,o,f,b),...I9({subprocess:t,cancelSignal:s,gracefulCancel:a,context:f,controller:b}),...lV({subprocess:t,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,context:f,controller:b})])}catch($){return f.terminationReason??="other",Promise.all([{error:$},_,Promise.all(x.map(re=>ZI(re))),ZI(w),SK(T,O),Promise.allSettled(A),Promise.allSettled(D)])}},V$e=(t,e,r)=>t.map((n,i)=>n===e.stdio[i]?void 0:lp(n,i,r)),W$e=(t,e)=>t.flatMap(({stdioItems:r},n)=>r.filter(({value:i,stream:o=i})=>ri(o,{checkOpen:!1})&&!Qn(o)).map(({type:i,value:o,stream:s=o})=>lp(s,n,e,{isSameDirection:On.has(i),stopOnExit:i==="native"}))),K$e=async(t,{signal:e})=>{let[r]=await Z$e(t,"error",{signal:e});throw r}});var kK,up,zl,_v=y(()=>{Pl();kK=()=>({readableDestroy:new WeakMap,writableFinal:new WeakMap,writableDestroy:new WeakMap}),up=(t,e,r)=>{let n=t[r];n.has(e)||n.set(e,[]);let i=n.get(e),o=Ci();return i.push(o),{resolve:o.resolve.bind(o),promises:i}},zl=async({resolve:t,promises:e},r)=>{t();let[n]=await Promise.race([Promise.allSettled([!0,r]),Promise.all([!1,...e])]);return!n}});import{finished as EK}from"node:stream/promises";var XI,AK,QI,eP,bv,vv,tP=y(()=>{yv();XI=async t=>{if(t!==void 0)try{await QI(t)}catch{}},AK=async t=>{if(t!==void 0)try{await eP(t)}catch{}},QI=async t=>{await EK(t,{cleanup:!0,readable:!1,writable:!0})},eP=async t=>{await EK(t,{cleanup:!0,readable:!0,writable:!1})},bv=async(t,e)=>{if(await t,e)throw e},vv=(t,e,r)=>{r&&!gv(r)?t.destroy(r):e&&t.destroy()}});import{Readable as J$e}from"node:stream";import{callbackify as Y$e}from"node:util";var TK,rP,nP,iP,X$e,oP,sP,OK,aP=y(()=>{Pa();ds();hv();Pl();_v();tP();TK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,binary:i=!0,preserveNewlines:o=!0}={})=>{let s=i||on.has(r),{subprocessStdout:a,waitReadableDestroy:c}=rP(t,n,e),{readableEncoding:l,readableObjectMode:u,readableHighWaterMark:d}=nP(a,s),{read:f,onStdoutDataDone:p}=iP({subprocessStdout:a,subprocess:t,binary:s,encoding:r,preserveNewlines:o}),m=new J$e({read:f,destroy:Y$e(sP.bind(void 0,{subprocessStdout:a,subprocess:t,waitReadableDestroy:c})),highWaterMark:d,objectMode:u,encoding:l});return oP({subprocessStdout:a,onStdoutDataDone:p,readable:m,subprocess:t}),m},rP=(t,e,r)=>{let n=Cl(t,e),i=up(r,n,"readableDestroy");return{subprocessStdout:n,waitReadableDestroy:i}},nP=({readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r},n)=>n?{readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r}:{readableEncoding:t,readableObjectMode:!0,readableHighWaterMark:GI},iP=({subprocessStdout:t,subprocess:e,binary:r,encoding:n,preserveNewlines:i})=>{let o=Ci(),s=mv({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:!r,encoding:n,preserveNewlines:i});return{read(){X$e(this,s,o)},onStdoutDataDone:o}},X$e=async(t,e,r)=>{try{let{value:n,done:i}=await e.next();i?r.resolve():t.push(n)}catch{}},oP=async({subprocessStdout:t,onStdoutDataDone:e,readable:r,subprocess:n,subprocessStdin:i})=>{try{await eP(t),await n,await XI(i),await e,r.readable&&r.push(null)}catch(o){await XI(i),OK(r,o)}},sP=async({subprocessStdout:t,subprocess:e,waitReadableDestroy:r},n)=>{await zl(r,e)&&(OK(t,n),await bv(e,n))},OK=(t,e)=>{vv(t,t.readable,e)}});import{Writable as Q$e}from"node:stream";import{callbackify as RK}from"node:util";var IK,cP,lP,eke,tke,uP,dP,PK,fP=y(()=>{ds();_v();tP();IK=({subprocess:t,concurrentStreams:e},{to:r}={})=>{let{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}=cP(t,r,e),s=new Q$e({...lP(n,t,i),destroy:RK(dP.bind(void 0,{subprocessStdin:n,subprocess:t,waitWritableFinal:i,waitWritableDestroy:o})),highWaterMark:n.writableHighWaterMark,objectMode:n.writableObjectMode});return uP(n,s),s},cP=(t,e,r)=>{let n=_b(t,e),i=up(r,n,"writableFinal"),o=up(r,n,"writableDestroy");return{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}},lP=(t,e,r)=>({write:eke.bind(void 0,t),final:RK(tke.bind(void 0,t,e,r))}),eke=(t,e,r,n)=>{t.write(e,r)?n():t.once("drain",n)},tke=async(t,e,r)=>{await zl(r,e)&&(t.writable&&t.end(),await e)},uP=async(t,e,r)=>{try{await QI(t),e.writable&&e.end()}catch(n){await AK(r),PK(e,n)}},dP=async({subprocessStdin:t,subprocess:e,waitWritableFinal:r,waitWritableDestroy:n},i)=>{await zl(r,e),await zl(n,e)&&(PK(t,i),await bv(e,i))},PK=(t,e)=>{vv(t,t.writable,e)}});import{Duplex as rke}from"node:stream";import{callbackify as nke}from"node:util";var CK,ike,DK=y(()=>{Pa();aP();fP();CK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,to:i,binary:o=!0,preserveNewlines:s=!0}={})=>{let a=o||on.has(r),{subprocessStdout:c,waitReadableDestroy:l}=rP(t,n,e),{subprocessStdin:u,waitWritableFinal:d,waitWritableDestroy:f}=cP(t,i,e),{readableEncoding:p,readableObjectMode:m,readableHighWaterMark:h}=nP(c,a),{read:g,onStdoutDataDone:b}=iP({subprocessStdout:c,subprocess:t,binary:a,encoding:r,preserveNewlines:s}),_=new rke({read:g,...lP(u,t,d),destroy:nke(ike.bind(void 0,{subprocessStdout:c,subprocessStdin:u,subprocess:t,waitReadableDestroy:l,waitWritableFinal:d,waitWritableDestroy:f})),readableHighWaterMark:h,writableHighWaterMark:u.writableHighWaterMark,readableObjectMode:m,writableObjectMode:u.writableObjectMode,encoding:p});return oP({subprocessStdout:c,onStdoutDataDone:b,readable:_,subprocess:t,subprocessStdin:u}),uP(u,_,c),_},ike=async({subprocessStdout:t,subprocessStdin:e,subprocess:r,waitReadableDestroy:n,waitWritableFinal:i,waitWritableDestroy:o},s)=>{await Promise.all([sP({subprocessStdout:t,subprocess:r,waitReadableDestroy:n},s),dP({subprocessStdin:e,subprocess:r,waitWritableFinal:i,waitWritableDestroy:o},s)])}});var pP,oke,NK=y(()=>{Pa();ds();hv();pP=(t,e,{from:r,binary:n=!1,preserveNewlines:i=!1}={})=>{let o=n||on.has(e),s=Cl(t,r),a=mv({subprocessStdout:s,subprocess:t,binary:o,shouldEncode:!0,encoding:e,preserveNewlines:i});return oke(a,s,t)},oke=async function*(t,e,r){try{yield*t}finally{e.readable&&e.destroy(),await r}}});var jK,MK=y(()=>{_v();aP();fP();DK();NK();jK=(t,{encoding:e})=>{let r=kK();t.readable=TK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.writable=IK.bind(void 0,{subprocess:t,concurrentStreams:r}),t.duplex=CK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.iterable=pP.bind(void 0,t,e),t[Symbol.asyncIterator]=pP.bind(void 0,t,e,{})}});var FK,ske,ake,LK=y(()=>{FK=(t,e)=>{for(let[r,n]of ake){let i=n.value.bind(e);Reflect.defineProperty(t,r,{...n,value:i})}},ske=(async()=>{})().constructor.prototype,ake=["then","catch","finally"].map(t=>[t,Reflect.getOwnPropertyDescriptor(ske,t)])});import{setMaxListeners as cke}from"node:events";import{spawn as lke}from"node:child_process";var zK,uke,dke,fke,pke,mke,UK=y(()=>{Hb();SR();KR();ds();JR();RI();np();Vb();R3();N3();ip();G3();mb();J3();cK();YI();$K();MK();Pl();LK();zK=(t,e,r,n)=>{let{file:i,commandArguments:o,command:s,escapedCommand:a,startTime:c,verboseInfo:l,options:u,fileDescriptors:d}=uke(t,e,r),{subprocess:f,promise:p}=fke({file:i,commandArguments:o,options:u,startTime:c,verboseInfo:l,command:s,escapedCommand:a,fileDescriptors:d});return f.pipe=pv.bind(void 0,{source:f,sourcePromise:p,boundOptions:{},createNested:n}),FK(f,p),Di.set(f,{options:u,fileDescriptors:d}),f},uke=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ab(t,e,r),{file:a,commandArguments:c,options:l}=Db(t,e,r),u=dke(l),d=D3(u,s);return{file:a,commandArguments:c,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},dke=({timeout:t,signal:e,...r})=>{if(e!==void 0)throw new TypeError('The "signal" option has been renamed to "cancelSignal" instead.');return{...r,timeoutDuration:t}},fke=({file:t,commandArguments:e,options:r,startTime:n,verboseInfo:i,command:o,escapedCommand:s,fileDescriptors:a})=>{let c;try{c=lke(...Nb(t,e,r))}catch(m){return O3({error:m,command:o,escapedCommand:s,fileDescriptors:a,options:r,startTime:n,verboseInfo:i})}let l=new AbortController;cke(Number.POSITIVE_INFINITY,l.signal);let u=[...c.stdio];H3(c,a,l),K3(c,r,l);let d={},f=Ci();c.kill=O9.bind(void 0,{kill:c.kill.bind(c),options:r,onInternalError:f,context:d,controller:l}),c.all=hK(c,r),jK(c,r),E3(c,r);let p=pke({subprocess:c,options:r,startTime:n,verboseInfo:i,fileDescriptors:a,originalStreams:u,command:o,escapedCommand:s,context:d,onInternalError:f,controller:l});return{subprocess:c,promise:p}},pke=async({subprocess:t,options:e,startTime:r,verboseInfo:n,fileDescriptors:i,originalStreams:o,command:s,escapedCommand:a,context:c,onInternalError:l,controller:u})=>{let[d,[f,p],m,h,g]=await xK({subprocess:t,options:e,context:c,verboseInfo:n,fileDescriptors:i,originalStreams:o,onInternalError:l,controller:u});u.abort(),l.resolve();let b=m.map((x,w)=>xo(x,e,w)),_=xo(h,e,"all"),S=mke({errorInfo:d,exitCode:f,signal:p,stdio:b,all:_,ipcOutput:g,context:c,options:e,command:s,escapedCommand:a,startTime:r});return Ml(S,n,e)},mke=({errorInfo:t,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,context:s,options:a,command:c,escapedCommand:l,startTime:u})=>"error"in t?rp({error:t.error,command:c,escapedCommand:l,timedOut:s.terminationReason==="timeout",isCanceled:s.terminationReason==="cancel"||s.terminationReason==="gracefulCancel",isGracefullyCanceled:s.terminationReason==="gracefulCancel",isMaxBuffer:t.error instanceof Ni,isForcefullyTerminated:s.isForcefullyTerminated,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,options:a,startTime:u,isSync:!1}):Zb({command:c,escapedCommand:l,stdio:n,all:i,ipcOutput:o,options:a,startTime:u})});var Sv,hke,gke,qK=y(()=>{yo();So();Sv=(t,e)=>{let r=Object.fromEntries(Object.entries(e).map(([n,i])=>[n,hke(n,t[n],i)]));return{...t,...r}},hke=(t,e,r)=>gke.has(t)&&Ot(e)&&Ot(r)?{...e,...r}:r,gke=new Set(["env",...gR])});var ms,yke,_ke,BK=y(()=>{yo();dR();HG();b3();UK();qK();ms=(t,e,r,n)=>{let i=(s,a,c)=>ms(s,a,r,c),o=(...s)=>yke({mapArguments:t,deepOptions:r,boundOptions:e,setBoundExeca:n,createNested:i},...s);return n!==void 0&&n(o,i,e),o},yke=({mapArguments:t,deepOptions:e={},boundOptions:r={},setBoundExeca:n,createNested:i},o,...s)=>{if(Ot(o))return i(t,Sv(r,o),n);let{file:a,commandArguments:c,options:l,isSync:u}=_ke({mapArguments:t,firstArgument:o,nextArguments:s,deepOptions:e,boundOptions:r});return u?_3(a,c,l):zK(a,c,l,i)},_ke=({mapArguments:t,firstArgument:e,nextArguments:r,deepOptions:n,boundOptions:i})=>{let o=qG(e)?BG(e,r):[e,...r],[s,a,c]=W_(...o),l=Sv(Sv(n,i),c),{file:u=s,commandArguments:d=a,options:f=l,isSync:p=!1}=t({file:s,commandArguments:a,options:l});return{file:u,commandArguments:d,options:f,isSync:p}}});var HK,GK,ZK,bke,vke,VK=y(()=>{HK=({file:t,commandArguments:e})=>ZK(t,e),GK=({file:t,commandArguments:e})=>({...ZK(t,e),isSync:!0}),ZK=(t,e)=>{if(e.length>0)throw new TypeError(`The command and its arguments must be passed as a single string: ${t} ${e}.`);let[r,...n]=bke(t);return{file:r,commandArguments:n}},bke=t=>{if(typeof t!="string")throw new TypeError(`The command must be a string: ${String(t)}.`);let e=t.trim();if(e==="")return[];let r=[];for(let n of e.split(vke)){let i=r.at(-1);i&&i.endsWith("\\")?r[r.length-1]=`${i.slice(0,-1)} ${n}`:r.push(n)}return r},vke=/ +/g});var WK,KK,Ske,JK,wke,YK,XK=y(()=>{WK=(t,e,r)=>{t.sync=e(Ske,r),t.s=t.sync},KK=({options:t})=>JK(t),Ske=({options:t})=>({...JK(t),isSync:!0}),JK=t=>({options:{...wke(t),...t}}),wke=({input:t,inputFile:e,stdio:r})=>t===void 0&&e===void 0&&r===void 0?{stdin:"inherit"}:{},YK={preferLocal:!0}});var Zlt,We,Vlt,Wlt,Klt,Jlt,Ylt,Xlt,Qlt,eut,Mr=y(()=>{BK();VK();GR();XK();RI();Zlt=ms(()=>({})),We=ms(()=>({isSync:!0})),Vlt=ms(HK),Wlt=ms(GK),Klt=ms(pV),Jlt=ms(KK,{},YK,WK),{sendMessage:Ylt,getOneMessage:Xlt,getEachMessage:Qlt,getCancelSignal:eut}=A3()});import{existsSync as wv,statSync as xke}from"node:fs";import{dirname as mP,extname as $ke,isAbsolute as QK,join as hP,relative as gP,resolve as xv,sep as kke}from"node:path";function $v(t){return t==="./gradlew"||t==="gradle"}function Eke(t){return(wv(hP(t,"build.gradle.kts"))||wv(hP(t,"build.gradle")))&&wv(hP(t,"gradle.properties"))}function Ake(t,e){let n=gP(t,e).split(kke).filter(Boolean);return n.length===0?":":`:${n.join(":")}`}function hs(t,e){return t===":"?`:${e}`:`${t}:${e}`}function Tke(t,e){let r=xv(t,e),n=r;wv(r)?xke(r).isFile()&&(n=mP(r)):$ke(r)!==""&&(n=mP(r));let i=gP(t,n);if(i.startsWith("..")||QK(i))return null;let o=n;for(;;){if(Eke(o))return o;if(xv(o)===xv(t))return null;let s=mP(o);if(s===o)return null;let a=gP(t,s);if(a.startsWith("..")||QK(a))return null;o=s}}function kv(t,e){let r=xv(t),n=new Map,i=[];for(let o of e){let s=Tke(r,o);if(!s){i.push(o);continue}let a=Ake(r,s);n.has(a)||n.set(a,{path:a,dir:s})}if(i.length>0)throw new Error(`cannot map module(s) to a Gradle project (no build.gradle[.kts] + gradle.properties ancestor under ${r}): ${i.join(", ")}`);return[...n.values()].sort((o,s)=>o.paths.path?1:0)}var Ev=y(()=>{"use strict"});import{existsSync as _P,readFileSync as Oke}from"node:fs";import{join as Ul}from"node:path";function ql(t="."){let e=Ul(t,".cladding","config.yaml");if(!_P(e))return yP;try{let n=(0,eJ.parse)(Oke(e,"utf8"))?.gate;if(!n)return yP;let i=n.scope==="repo"?"repo":"feature",o=n.coverage==="kover"||n.coverage==="jacoco"?n.coverage:void 0,s=typeof n.test_report=="string"?n.test_report:void 0,a={};if(n.commands&&typeof n.commands=="object")for(let l of Rke){let u=n.commands[l];Array.isArray(u)&&u.every(d=>typeof d=="string")&&(a[l]=u)}let c={scope:i};return Object.keys(a).length>0&&(c.commands=a),o&&(c.coverage=o),s&&(c.testReport=s),c}catch{return yP}}function tJ(t="."){let e=ql(t).testReport,r=e?[e,...bP]:bP;return[...new Set(r.map(n=>Ul(t,n)))]}function rJ(t="."){let e=ql(t).testReport;if(e){let r=Ul(t,e);return _P(r)?r:null}return bP.map(r=>Ul(t,r)).find(r=>_P(r))??null}function nJ(t,e){let r=[],n=!1;for(let i of t){let o=Ike.exec(i);if(o){n=!0;for(let s of e)r.push(hs(s.path,o[1]))}else r.push(i)}return n&&e.length===0||r.length===0?null:{cmd:r[0],args:r.slice(1)}}var eJ,Rke,yP,bP,Ike,dp=y(()=>{"use strict";eJ=St(er(),1);Ev();Rke=["type","lint","test","coverage"],yP={scope:"feature"},bP=["test-report.junit.xml",Ul("coverage","junit.xml"),Ul(".cladding","test-report.junit.xml")];Ike=/^\{modules:([A-Za-z0-9_.:-]+)\}$/});import{existsSync as SP,readFileSync as iJ,readdirSync as Pke,statSync as Cke}from"node:fs";import{join as Av}from"node:path";function $P(t){for(let e of["build.gradle.kts","build.gradle","gradle.properties"]){let r=Av(t,e);if(SP(r))try{if(oJ.test(iJ(r,"utf8")))return!0}catch{}}return!1}function sJ(t){try{return SP(t)&&oJ.test(iJ(t,"utf8"))}catch{return!1}}function aJ(t,e=0){if(e>4||!SP(t))return!1;let r;try{r=Pke(t)}catch{return!1}for(let n of r){let i=Av(t,n),o=!1;try{o=Cke(i).isDirectory()}catch{continue}if(o){if(n==="build"||n===".gradle"||n==="node_modules")continue;if(aJ(i,e+1))return!0}else if(/\.(kts|gradle|toml)$/.test(n)&&sJ(i))return!0}return!1}function jke(t){if($P(t))return!0;for(let e of Dke)if(sJ(Av(t,e)))return!0;for(let e of Nke)if(aJ(Av(t,e)))return!0;return!1}function cJ(t="."){let e=ql(t).coverage;return e||(jke(t)?"kover":"jacoco")}function lJ(t="."){return wP[cJ(t)]}function uJ(t="."){return vP[cJ(t)]}var wP,vP,xP,oJ,Dke,Nke,Tv=y(()=>{"use strict";dp();wP={kover:"koverXmlReport",jacoco:"jacocoTestReport"},vP={kover:"build/reports/kover/report.xml",jacoco:"build/reports/jacoco/test/jacocoTestReport.xml"},xP=[vP.kover,vP.jacoco],oJ=/kover/i;Dke=["build.gradle.kts","build.gradle","settings.gradle.kts","settings.gradle","gradle/libs.versions.toml"],Nke=["buildSrc","build-logic"]});import{existsSync as pp,readFileSync as fJ,readdirSync as pJ}from"node:fs";import{join as gs}from"node:path";function EP(t){return pp(gs(t,"gradlew"))?"./gradlew":"gradle"}function Mke(t){let e=EP(t);return{type:{cmd:e,args:["compileKotlin","compileTestKotlin"]},lint:{cmd:e,args:["ktlintCheck"]},test:{cmd:e,args:["test"]},coverage:{cmd:e,args:[lJ(t)]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}}function Fke(t){let e=!1;try{e=/(^|\n)\s*flutter\s*:|sdk:\s*flutter/.test(fJ(gs(t,"pubspec.yaml"),"utf8"))}catch{}let r={cmd:"dart",args:["format","--output=none","--set-exit-if-changed","."]},n={cmd:"gitleaks",args:["detect","--no-banner"]};return e?{type:{cmd:"flutter",args:["analyze"]},lint:r,test:{cmd:"flutter",args:["test"]},coverage:{cmd:"flutter",args:["test","--coverage"]},secret:n}:{type:{cmd:"dart",args:["analyze"]},lint:r,test:{cmd:"dart",args:["test"]},coverage:{cmd:"dart",args:["test","--coverage=coverage"]},secret:n}}function zke(t,e){let r=[t],n=0,i=4e3;for(;r.length>0&&na.name.endsWith(c)))return!0}return!1}function Bke(t,e){for(let r of e)if(pp(gs(t,r)))return r}function Hke(t,e){try{return pJ(t).find(n=>n.endsWith(e))}catch{return}}function Vke(t){try{return JSON.parse(fJ(gs(t,"package.json"),"utf8"))}catch{return{}}}function fp(t,e){let r=t.scripts?.[e];return typeof r=="string"&&r.trim().length>0?r.trim():void 0}function dJ(t,e){return[t.dependencies,t.devDependencies,t.optionalDependencies,t.peerDependencies].some(r=>r?.[e]!==void 0)}function Wke(t,e,r){if(fp(r,"lint"))return{cmd:"npm",args:["run","--silent","lint"]};for(let n of Gke)if(n.configs.some(i=>pp(gs(t,i))))return n.gate;if(Zke.some(n=>pp(gs(t,n)))||r.eslintConfig!==void 0)return e}function Jke(t,e){return Kke.some(r=>pp(gs(t,r)))?!0:e.jest!==void 0}function Yke(t){if(/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?vitest(?:\s+run)?$/i.test(t))return"vitest";if(/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?jest$/i.test(t))return"jest"}function kP(t,e){let r={...t};return e==="lint"?delete r.lint:delete r.coverage,r}function Xke(t,e){let r=Vke(t),n=e.lint?Wke(t,e.lint,r):void 0,i=n?{...e,lint:n}:kP(e,"lint"),o=fp(r,"test"),s=o?Yke(o):void 0;return o&&!s?(i=kP(i,"coverage"),{...i,test:{cmd:"npm",args:["test"]},...fp(r,"coverage")?{coverage:{cmd:"npm",args:["run","--silent","coverage"]}}:{}}):s==="jest"||!o&&Jke(t,r)?{...i,test:{cmd:"npx",args:[...Mi,"jest"]},coverage:{cmd:"npx",args:[...Mi,"jest","--coverage"]}}:(s==="vitest"&&!fp(r,"coverage")&&!dJ(r,"@vitest/coverage-v8")&&!dJ(r,"@vitest/coverage-istanbul")?i=kP(i,"coverage"):s==="vitest"&&fp(r,"coverage")&&(i={...i,coverage:{cmd:"npm",args:["run","--silent","coverage"]}}),i)}function dt(t="."){for(let e of Uke){let r;for(let o of e.manifests)if(o.startsWith(".")?r=Hke(t,o):r=Bke(t,[o]),r)break;if(!r||e.requiresSource&&!zke(t,e.requiresSource))continue;let n=typeof e.gates=="function"?e.gates(t):e.gates,i=e.language==="typescript"?Xke(t,n):n;return{language:e.language,manifest:r,gates:i}}return qke}var Mi,Lke,Uke,qke,Gke,Zke,Kke,sn=y(()=>{"use strict";Tv();Mi=["--offline","--no-install"];Lke=new Set(["node_modules",".git",".gradle",".idea","build","target","dist","out",".cladding"]);Uke=[{language:"typescript",manifests:["package.json"],gates:{type:{cmd:"npx",args:[...Mi,"tsc","--noEmit"]},lint:{cmd:"npx",args:[...Mi,"eslint","."]},test:{cmd:"npx",args:[...Mi,"vitest","run"]},coverage:{cmd:"npx",args:[...Mi,"vitest","run","--coverage"]},secret:{cmd:"npx",args:[...Mi,"secretlint","**/*"]},arch:{cmd:"npx",args:[...Mi,"madge","--circular","--extensions","ts,tsx,js,jsx","."]},smoke:{cmd:"npm",args:["run","--silent","smoke"]},perf:{cmd:"npm",args:["run","--silent","perf"]},visual:{cmd:"npm",args:["run","--silent","visual"]}}},{language:"python",manifests:["pyproject.toml","setup.py","requirements.txt"],gates:{type:{cmd:"mypy",args:["."]},lint:{cmd:"ruff",args:["check","."]},test:{cmd:"pytest",args:[]},coverage:{cmd:"coverage",args:["run","-m","pytest"]},secret:{cmd:"detect-secrets",args:["scan"]},arch:{cmd:"lint-imports",args:[]}}},{language:"rust",manifests:["Cargo.toml"],gates:{type:{cmd:"cargo",args:["check"]},lint:{cmd:"cargo",args:["clippy","--","-D","warnings"]},test:{cmd:"cargo",args:["test"]},coverage:{cmd:"cargo",args:["llvm-cov"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"go",manifests:["go.mod"],gates:{type:{cmd:"go",args:["vet","./..."]},lint:{cmd:"golangci-lint",args:["run"]},test:{cmd:"go",args:["test","./..."]},coverage:{cmd:"go",args:["test","-cover","./..."]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"kotlin",manifests:["build.gradle.kts","build.gradle","pom.xml"],requiresSource:[".kt",".kts"],gates:Mke},{language:"java",manifests:["pom.xml","build.gradle","build.gradle.kts"],gates:{type:{cmd:"mvn",args:["compile","-q"]},lint:{cmd:"mvn",args:["checkstyle:check","-q"]},test:{cmd:"mvn",args:["test","-q"]},coverage:{cmd:"mvn",args:["jacoco:report","-q"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"php",manifests:["composer.json"],gates:{type:{cmd:"phpstan",args:["analyse"]},lint:{cmd:"phpcs",args:[]},test:{cmd:"phpunit",args:[]},coverage:{cmd:"phpunit",args:["--coverage-text"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"ruby",manifests:["Gemfile"],gates:{type:{cmd:"srb",args:["tc"]},lint:{cmd:"rubocop",args:[]},test:{cmd:"bundle",args:["exec","rspec"]},coverage:{cmd:"bundle",args:["exec","rspec","--format","documentation"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"elixir",manifests:["mix.exs"],gates:{type:{cmd:"mix",args:["dialyzer"]},lint:{cmd:"mix",args:["credo"]},test:{cmd:"mix",args:["test"]},coverage:{cmd:"mix",args:["coveralls"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"dotnet",manifests:[".csproj",".sln",".fsproj"],gates:{type:{cmd:"dotnet",args:["build","--nologo","-v","q"]},lint:{cmd:"dotnet",args:["format","--verify-no-changes"]},test:{cmd:"dotnet",args:["test","--nologo"]},coverage:{cmd:"dotnet",args:["test",'--collect:"XPlat Code Coverage"']},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"swift",manifests:["Package.swift"],gates:{type:{cmd:"swift",args:["build"]},lint:{cmd:"swiftlint",args:["lint"]},test:{cmd:"swift",args:["test"]},coverage:{cmd:"swift",args:["test","--enable-code-coverage"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"dart",manifests:["pubspec.yaml"],gates:Fke}],qke={language:"unknown",manifest:"",gates:{}};Gke=[{configs:["biome.json","biome.jsonc"],gate:{cmd:"npx",args:[...Mi,"biome","lint","."]}},{configs:[".oxlintrc.json",".oxlintrc.jsonc","oxlint.config.ts"],gate:{cmd:"npx",args:[...Mi,"oxlint"]}}],Zke=["eslint.config.js","eslint.config.mjs","eslint.config.cjs","eslint.config.ts","eslint.config.mts","eslint.config.cts",".eslintrc",".eslintrc.js",".eslintrc.cjs",".eslintrc.json",".eslintrc.yaml",".eslintrc.yml"];Kke=["jest.config.js","jest.config.ts","jest.config.mjs","jest.config.cjs","jest.config.json"]});import{existsSync as Qke,readFileSync as eEe}from"node:fs";import{join as tEe}from"node:path";function za(t){return t.code==="ENOENT"}function Ov(t,e,r,n){let i=t.exitCode??1;if(i===0)return[];let o=(t.stderr??"").toString().trim(),s=(t.stdout??"").toString().trim(),a=(o||s||`exit ${i}`).slice(0,200);return mJ.test(o)||mJ.test(s)?[{detector:e,severity:"info",message:n(a)}]:[{detector:e,severity:"error",message:r(a)}]}function Nt(t,e,r,n=[]){if(za(r))return{stage:t,pass:!1,exitCode:2,stderr:`'${e}' not installed`};let i=`${String(r.stderr??"")} -${String(r.stdout??"")}`,o=/ENOTCACHED|ENOTFOUND|EAI_AGAIN|canceled due to missing packages|could not determine executable/i.test(i),a=n.find(l=>l!=="--"&&!l.startsWith("-"))?.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),c=r.exitCode===127&&a!==void 0&&new RegExp(`(?:^|[\\s:])${a}: (?:command )?not found\\b`,"i").test(i);return e==="npx"&&(o||c)?{stage:t,pass:!1,exitCode:2,stderr:"setup gap: 'npx' could not resolve the configured tool without installing it; the inferred tool is not installed or unavailable offline"}:null}function Yt(t,e){if((e.exitCode??1)===0)return{stage:t,pass:!0,exitCode:0};let n=String(e.stderr??"").trim()||String(e.stdout??"").trim();return n?{stage:t,pass:!1,exitCode:1,stderr:n}:{stage:t,pass:!1,exitCode:1}}function Bl(t,e){let r=tEe(t,"package.json");if(!Qke(r))return!1;try{return!!JSON.parse(eEe(r,"utf8")).scripts?.[e]}catch{return!1}}var mJ,Rn=y(()=>{"use strict";mJ=/config (is |file )?not found|no such file|ENOENT|ENOTCACHED|ENOTFOUND|EAI_AGAIN|cannot find (a |the )?(config|module|package|preset)|require[sd]?\b.{0,40}\bconfig|canceled due to missing packages|could not determine executable/i});function rEe(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.arch;if(!n)return[{detector:Rv,severity:"info",message:`no architecture validator registered for language '${r.language}' (compiler may already enforce acyclic imports)`}];let i=We(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Rv,severity:"info",message:`architecture validator '${n.cmd}' not installed`}]:Ov(i,Rv,o=>`${n.cmd} reported architecture violations: ${o}`,o=>`${n.cmd} could not validate (config/setup gap, not a violation): ${o}`)}var Rv,Ua,Iv=y(()=>{"use strict";Mr();sn();Rn();Rv="ARCHITECTURE_VIOLATION";Ua={name:Rv,subprocess:!0,run:rEe}});function nEe(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.secret;if(!n)return[{detector:Pv,severity:"info",message:`no secret scanner registered for language '${r.language}'`}];let i=We(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Pv,severity:"info",message:`secret scanner '${n.cmd}' not installed`}]:Ov(i,Pv,o=>`${n.cmd} reported secrets: ${o}`,o=>`${n.cmd} could not scan (config/setup gap, not a secret): ${o}`)}var Pv,qa,Cv=y(()=>{"use strict";Mr();sn();Rn();Pv="HARDCODED_SECRET";qa={name:Pv,subprocess:!0,run:nEe}});import{existsSync as AP,readdirSync as hJ}from"node:fs";import{join as Dv}from"node:path";function oEe(t,e){let r=Dv(t,e.path);if(!AP(r))return!0;if(e.isDirectory)try{return hJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml")).length===0}catch{return!0}return!1}function sEe(t){let{cwd:e="."}=t,r=[];for(let i of iEe)oEe(e,i)&&r.push({detector:mp,severity:i.severity,path:i.path,message:`${i.path} is absent \u2014 cladding scaffold incomplete (${i.purpose}). Run \`clad init --intent ""\` to populate it.`});let n=Dv(e,"spec.yaml");if(AP(n)){let i=lEe(n),o=i?null:aEe(e);if(i)r.push({detector:mp,severity:"error",path:"spec.yaml",message:`spec.yaml is present but unreadable (${i}) \u2014 cladding is governing nothing. Fix the SSoT root, then \`clad sync\` to validate.`});else if(o)r.push({detector:mp,severity:"error",path:o.path,message:`spec shard '${o.path}' is present but unparseable (${o.reason}) \u2014 loadSpec throws on it, so every spec-gated detector silently passes. Fix it, then \`clad sync\`.`});else{let s=cEe(e);s&&r.push({detector:mp,severity:"error",path:"spec.yaml",message:`spec.yaml is present and parses, but the assembled spec does not load (${s}) \u2014 every spec-gated detector then degrades to non-blocking info, so the gate would pass GREEN on an unloadable SSoT. Fix it, then \`clad sync\` to validate.`})}}return r}function aEe(t){for(let e of["spec/features","spec/scenarios"]){let r=Dv(t,e);if(!AP(r))continue;let n;try{n=hJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml"))}catch{continue}for(let i of[...n].sort())try{Oi(Dv(r,i))}catch(o){return{path:`${e}/${i}`,reason:o.message}}}return null}function cEe(t){try{return q(t),null}catch(e){return e.message}}function lEe(t){let e;try{e=Oi(t)}catch(r){return`unparseable: ${r.message}`}return e===null||typeof e!="object"||Array.isArray(e)?"empty or not a YAML mapping":null}var mp,iEe,gJ,yJ=y(()=>{"use strict";Ue();F_();mp="ABSENCE_OF_GOVERNANCE",iEe=[{path:"spec.yaml",severity:"error",purpose:"SSoT root \u2014 every spec-gated detector needs it"},{path:"spec/architecture.yaml",severity:"warn",purpose:"architecture invariants (layers + forbidden_imports)"},{path:"spec/capabilities.yaml",severity:"warn",purpose:"capability \u2194 feature traceability"},{path:"docs/project-context.md",severity:"warn",purpose:"intent narrative + decision history"},{path:"docs/conventions.md",severity:"info",purpose:"project style guide (recommended)"},{path:"spec/scenarios",severity:"info",purpose:"user-journey scenarios (recommended)",isDirectory:!0}];gJ={name:mp,run:sEe}});function Nv(t){let e=t.trim().match(/^(\S+)/);return e?e[1].toLowerCase():""}function TP(t,e){let r=e?.trim()??"";if(!t)return r.length>0?"condition is present but ears pattern is not declared":null;if(t==="ubiquitous")return r.length>0?`ears='ubiquitous' but condition is present ('${r.slice(0,40)}\u2026')`:null;if(t==="complex"){if(r.length===0)return"ears='complex' requires a 'while' precondition and a 'when' trigger \u2014 empty";let i=Nv(r)==="while",o=dEe.test(r);return i?o?null:"ears='complex' requires a 'when' trigger clause after the 'while' precondition \u2014 none found":`ears='complex' requires the condition to start with 'while' (precondition) \u2014 got '${Nv(r)}'`}let n=uEe[t];return r.length===0?`ears='${t}' requires condition starting with '${n}' \u2014 empty`:Nv(r)!==n?`ears='${t}' requires condition to start with '${n}' \u2014 got '${Nv(r)}'`:null}function fEe(t,e){let r=TP(e.ears,e.condition);return r?[{featureId:t.id,acId:e.id,pattern:e.ears??"unspecified",message:r}]:[]}function _J(t){let e=[];for(let r of t)for(let n of r.acceptance_criteria??[])e.push(...fEe(r,n));return e}var uEe,dEe,OP=y(()=>{"use strict";uEe={event:"when",state:"while",optional:"where",unwanted:"if"},dEe=/\bwhen\b/i});function ge(t,e,r){let n;try{n=q(t)}catch(i){return[{detector:e,severity:"info",message:`spec.yaml not loaded: ${i.message}`}]}return r(n)}var wt=y(()=>{"use strict";Ue()});function pEe(t){let{cwd:e="."}=t;return ge(e,jv,mEe)}function mEe(t){let e=[];for(let r of t.features)for(let n of r.acceptance_criteria??[]){let i=!!n.text?.trim(),o=!!(n.condition?.trim()||n.action?.trim()||n.response?.trim());!i&&!o&&e.push({detector:jv,severity:"error",message:`${r.id}.${n.id} has neither rendered text nor any EARS field (condition/action/response) \u2014 structurally empty AC`})}for(let r of _J(t.features))e.push({detector:jv,severity:"error",message:`${r.featureId}.${r.acId} EARS: ${r.message}`});return e}var jv,bJ,vJ=y(()=>{"use strict";OP();wt();jv="AC_DRIFT";bJ={name:jv,run:pEe}});function Fi(t=".",e){let n=(e??"").trim().toLowerCase()||dt(t).language;return wJ[n]??SJ}var hEe,gEe,yEe,SJ,_Ee,bEe,wJ,vEe,xJ,Ba=y(()=>{"use strict";sn();hEe=/(?:import\s+(?:[\s\S]*?\sfrom\s+)?|import\s*\()['"]([^'"]+)['"]\)?/g,gEe=/^[ \t]*import\s+([\w.]+)/gm,yEe=/^[ \t]*(?:from|import)\s+([\w.]+)/gm,SJ={ext:"ts",extensions:[".ts",".tsx"],sourceRoots:["src"],mainRoot:"src",testGlobs:["tests/**/*.test.ts"],coverageSummary:"coverage/coverage-summary.json",coverageFormat:"istanbul-json",importMatcher:hEe,importStyle:"relative"},_Ee={ext:"kt",extensions:[".kt",".kts"],sourceRoots:["src/main/kotlin","src/test/kotlin"],mainRoot:"src/main/kotlin",testGlobs:["src/test/kotlin/**/*Test.kt","src/test/kotlin/**/*Tests.kt"],coverageSummary:"build/reports/jacoco/test/jacocoTestReport.xml",coverageFormat:"jacoco-xml",importMatcher:gEe,importStyle:"dotted"},bEe={ext:"py",extensions:[".py"],sourceRoots:["."],mainRoot:"src",testGlobs:["tests/test_*.py","tests/**/test_*.py","tests/**/*_test.py"],coverageSummary:"coverage.xml",coverageFormat:"cobertura-xml",importMatcher:yEe,importStyle:"dotted"},wJ={typescript:SJ,kotlin:_Ee,python:bEe},vEe=[".js",".jsx",".mts",".cts",".rs",".go",".java",".rb",".php",".cs",".fs",".ex",".exs"],xJ=new Set([...Object.values(wJ).flatMap(t=>t?.extensions??[]),...vEe].map(t=>t.toLowerCase()))});import{existsSync as SEe,readFileSync as wEe,readdirSync as xEe,statSync as $Ee}from"node:fs";import{join as kJ,relative as $J}from"node:path";function kEe(t,e){if(!SEe(t))return[];let r=[],n=[t];for(;n.length>0;){let i=n.pop(),o;try{o=xEe(i)}catch{continue}for(let s of o){if(s==="node_modules"||s===".cladding"||s.startsWith("."))continue;let a=kJ(i,s),c;try{c=$Ee(a)}catch{continue}c.isDirectory()?n.push(a):e.some(l=>s.endsWith(l))&&r.push(a)}}return r}function EEe(t){let e=t.trim();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("*")}function TEe(t){return AEe.test(t)}function OEe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=r.project.ai_hints?.forbidden_patterns;if(!n||n.length===0)return[];let i=Fi(e,r.project?.language),o=i.sourceRoots.flatMap(a=>kEe(kJ(e,a),i.extensions));if(o.length===0)return[];let s=[];for(let a of o){let c;try{c=wEe(a,"utf8")}catch{continue}let l=c.split(` -`);for(let u=0;u{"use strict";Ue();Ba();EJ="AI_HINTS_FORBIDDEN_PATTERN";AEe=/\/\/\s*cladding-disable[:\s]+AI_HINTS_FORBIDDEN_PATTERN\b/;AJ={name:EJ,run:OEe}});function REe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];for(let i of r.features){let o=(i.acceptance_criteria??[]).map(a=>a.id),s=new Map;for(let a of o)s.set(a,(s.get(a)??0)+1);for(let[a,c]of s)c>1&&n.push({detector:OJ,severity:"error",message:`${i.id}.${a} appears ${c} times \u2014 AC ids must be unique within a feature`})}return n}var OJ,RJ,IJ=y(()=>{"use strict";Ue();OJ="AC_DUPLICATE_WITHIN_FEATURE";RJ={name:OJ,run:REe}});import{createRequire as IEe}from"module";import{basename as PEe,dirname as IP,normalize as CEe,relative as DEe,resolve as NEe,sep as DJ}from"path";import*as jEe from"fs";function MEe(t){let e=CEe(t);return e.length>1&&e[e.length-1]===DJ&&(e=e.substring(0,e.length-1)),e}function NJ(t,e){return t.replace(FEe,e)}function zEe(t){return t==="/"||LEe.test(t)}function RP(t,e){let{resolvePaths:r,normalizePath:n,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(r&&(t=NEe(t)),(n||o)&&(t=MEe(t)),t===".")return"";let s=t[t.length-1]!==i;return NJ(s?t+i:t,i)}function jJ(t,e){return e+t}function UEe(t,e){return function(r,n){return n.startsWith(t)?n.slice(t.length)+r:NJ(DEe(t,n),e.pathSeparator)+e.pathSeparator+r}}function qEe(t){return t}function BEe(t,e,r){return e+t+r}function HEe(t,e){let{relativePaths:r,includeBasePath:n}=e;return r&&t?UEe(t,e):n?jJ:qEe}function GEe(t){return function(e,r){r.push(e.substring(t.length)||".")}}function ZEe(t){return function(e,r,n){let i=e.substring(t.length)||".";n.every(o=>o(i,!0))&&r.push(i)}}function JEe(t,e){let{includeDirs:r,filters:n,relativePaths:i}=e;return r?i?n&&n.length?ZEe(t):GEe(t):n&&n.length?WEe:VEe:KEe}function rAe(t){let{excludeFiles:e,filters:r,onlyCounts:n}=t;return e?tAe:r&&r.length?n?YEe:XEe:n?QEe:eAe}function oAe(t){return t.group?iAe:nAe}function cAe(t){return t.group?sAe:aAe}function dAe(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?uAe:lAe}function MJ(t,e,r){if(r.options.useRealPaths)return fAe(e,r);let n=IP(t),i=1;for(;n!==r.root&&i<2;){let o=r.symlinks.get(n);!!o&&(o===e||o.startsWith(e)||e.startsWith(o))?i++:n=IP(n)}return r.symlinks.set(t,e),i>1}function fAe(t,e){return e.visited.includes(t+e.options.pathSeparator)}function Mv(t,e,r,n){e(t&&!n?t:null,r)}function SAe(t,e){let{onlyCounts:r,group:n,maxFiles:i}=t;return r?e?pAe:yAe:n?e?mAe:vAe:i?e?gAe:bAe:e?hAe:_Ae}function $Ae(t){return t?xAe:wAe}function TAe(t,e){return new Promise((r,n)=>{zJ(t,e,(i,o)=>{if(i)return n(i);r(o)})})}function zJ(t,e,r){new LJ(t,e,r).start()}function OAe(t,e){return new LJ(t,e).start()}var PJ,FEe,LEe,VEe,WEe,KEe,YEe,XEe,QEe,eAe,tAe,nAe,iAe,sAe,aAe,lAe,uAe,pAe,mAe,hAe,gAe,yAe,_Ae,bAe,vAe,FJ,wAe,xAe,kAe,EAe,AAe,LJ,CJ,UJ,qJ,BJ=y(()=>{PJ=IEe(import.meta.url);FEe=/[\\/]/g;LEe=/^[a-z]:[\\/]$/i;VEe=(t,e)=>{e.push(t||".")},WEe=(t,e,r)=>{let n=t||".";r.every(i=>i(n,!0))&&e.push(n)},KEe=()=>{};YEe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&r.files++},XEe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&e.push(t)},QEe=(t,e,r,n)=>{r.files++},eAe=(t,e)=>{e.push(t)},tAe=()=>{};nAe=t=>t,iAe=()=>[""].slice(0,0);sAe=(t,e,r)=>{t.push({directory:e,files:r,dir:e})},aAe=()=>{};lAe=function(t,e,r){let{queue:n,fs:i,options:{suppressErrors:o}}=e;n.enqueue(),i.realpath(t,(s,a)=>{if(s)return n.dequeue(o?null:s,e);i.stat(a,(c,l)=>{if(c)return n.dequeue(o?null:c,e);if(l.isDirectory()&&MJ(t,a,e))return n.dequeue(null,e);r(l,a),n.dequeue(null,e)})})},uAe=function(t,e,r){let{queue:n,fs:i,options:{suppressErrors:o}}=e;n.enqueue();try{let s=i.realpathSync(t),a=i.statSync(s);if(a.isDirectory()&&MJ(t,s,e))return;r(a,s)}catch(s){if(!o)throw s}};pAe=t=>t.counts,mAe=t=>t.groups,hAe=t=>t.paths,gAe=t=>t.paths.slice(0,t.options.maxFiles),yAe=(t,e,r)=>(Mv(e,r,t.counts,t.options.suppressErrors),null),_Ae=(t,e,r)=>(Mv(e,r,t.paths,t.options.suppressErrors),null),bAe=(t,e,r)=>(Mv(e,r,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),vAe=(t,e,r)=>(Mv(e,r,t.groups,t.options.suppressErrors),null);FJ={withFileTypes:!0},wAe=(t,e,r,n,i)=>{if(t.queue.enqueue(),n<0)return t.queue.dequeue(null,t);let{fs:o}=t;t.visited.push(e),t.counts.directories++,o.readdir(e||".",FJ,(s,a=[])=>{i(a,r,n),t.queue.dequeue(t.options.suppressErrors?null:s,t)})},xAe=(t,e,r,n,i)=>{let{fs:o}=t;if(n<0)return;t.visited.push(e),t.counts.directories++;let s=[];try{s=o.readdirSync(e||".",FJ)}catch(a){if(!t.options.suppressErrors)throw a}i(s,r,n)};kAe=class{count=0;constructor(t){this.onQueueEmpty=t}enqueue(){return this.count++,this.count}dequeue(t,e){this.onQueueEmpty&&(--this.count<=0||t)&&(this.onQueueEmpty(t,e),t&&(e.controller.abort(),this.onQueueEmpty=void 0))}},EAe=class{_files=0;_directories=0;set files(t){this._files=t}get files(){return this._files}set directories(t){this._directories=t}get directories(){return this._directories}get dirs(){return this._directories}},AAe=class{aborted=!1;abort(){this.aborted=!0}},LJ=class{root;isSynchronous;state;joinPath;pushDirectory;pushFile;getArray;groupFiles;resolveSymlink;walkDirectory;callbackInvoker;constructor(t,e,r){this.isSynchronous=!r,this.callbackInvoker=SAe(e,this.isSynchronous),this.root=RP(t,e),this.state={root:zEe(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new EAe,options:e,queue:new kAe((n,i)=>this.callbackInvoker(i,n,r)),symlinks:new Map,visited:[""].slice(0,0),controller:new AAe,fs:e.fs||jEe},this.joinPath=HEe(this.root,e),this.pushDirectory=JEe(this.root,e),this.pushFile=rAe(e),this.getArray=oAe(e),this.groupFiles=cAe(e),this.resolveSymlink=dAe(e,this.isSynchronous),this.walkDirectory=$Ae(this.isSynchronous)}start(){return this.pushDirectory(this.root,this.state.paths,this.state.options.filters),this.walkDirectory(this.state,this.root,this.root,this.state.options.maxDepth,this.walk),this.isSynchronous?this.callbackInvoker(this.state,null):null}walk=(t,e,r)=>{let{paths:n,options:{filters:i,resolveSymlinks:o,excludeSymlinks:s,exclude:a,maxFiles:c,signal:l,useRealPaths:u,pathSeparator:d},controller:f}=this.state;if(f.aborted||l&&l.aborted||c&&n.length>c)return;let p=this.getArray(this.state.paths);for(let m=0;m{if(b.isDirectory()){if(_=RP(_,this.state.options),a&&a(h.name,u?_:g+d))return;this.walkDirectory(this.state,_,u?_:g+d,r-1,this.walk)}else{_=u?_:g;let S=PEe(_),x=RP(IP(_),this.state.options);_=this.joinPath(S,x),this.pushFile(_,p,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,p)}};CJ=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return TAe(this.root,this.options)}withCallback(t){zJ(this.root,this.options,t)}sync(){return OAe(this.root,this.options)}},UJ=null;try{PJ.resolve("picomatch"),UJ=PJ("picomatch")}catch{}qJ=class{globCache={};options={maxDepth:1/0,suppressErrors:!0,pathSeparator:DJ,filters:[]};globFunction;constructor(t){this.options={...this.options,...t},this.globFunction=this.options.globFunction}group(){return this.options.group=!0,this}withPathSeparator(t){return this.options.pathSeparator=t,this}withBasePath(){return this.options.includeBasePath=!0,this}withRelativePaths(){return this.options.relativePaths=!0,this}withDirs(){return this.options.includeDirs=!0,this}withMaxDepth(t){return this.options.maxDepth=t,this}withMaxFiles(t){return this.options.maxFiles=t,this}withFullPaths(){return this.options.resolvePaths=!0,this.options.includeBasePath=!0,this}withErrors(){return this.options.suppressErrors=!1,this}withSymlinks({resolvePaths:t=!0}={}){return this.options.resolveSymlinks=!0,this.options.useRealPaths=t,this.withFullPaths()}withAbortSignal(t){return this.options.signal=t,this}normalize(){return this.options.normalizePath=!0,this}filter(t){return this.options.filters.push(t),this}onlyDirs(){return this.options.excludeFiles=!0,this.options.includeDirs=!0,this}exclude(t){return this.options.exclude=t,this}onlyCounts(){return this.options.onlyCounts=!0,this}crawl(t){return new CJ(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options={...this.options,...e},new CJ(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let r=this.globFunction||UJ;if(!r)throw new Error("Please specify a glob function to use glob matching.");var n=this.globCache[t.join("\0")];return n||(n=r(t,...e),this.globCache[t.join("\0")]=n),this.options.filters.push(i=>n(i)),this}}});var hp=v((ndt,WJ)=>{"use strict";var HJ="[^\\\\/]",RAe="(?=.)",GJ="[^/]",PP="(?:\\/|$)",ZJ="(?:^|\\/)",CP=`\\.{1,2}${PP}`,IAe="(?!\\.)",PAe=`(?!${ZJ}${CP})`,CAe=`(?!\\.{0,1}${PP})`,DAe=`(?!${CP})`,NAe="[^.\\/]",jAe=`${GJ}*?`,MAe="/",VJ={DOT_LITERAL:"\\.",PLUS_LITERAL:"\\+",QMARK_LITERAL:"\\?",SLASH_LITERAL:"\\/",ONE_CHAR:RAe,QMARK:GJ,END_ANCHOR:PP,DOTS_SLASH:CP,NO_DOT:IAe,NO_DOTS:PAe,NO_DOT_SLASH:CAe,NO_DOTS_SLASH:DAe,QMARK_NO_DOT:NAe,STAR:jAe,START_ANCHOR:ZJ,SEP:MAe},FAe={...VJ,SLASH_LITERAL:"[\\\\/]",QMARK:HJ,STAR:`${HJ}*?`,DOTS_SLASH:"\\.{1,2}(?:[\\\\/]|$)",NO_DOT:"(?!\\.)",NO_DOTS:"(?!(?:^|[\\\\/])\\.{1,2}(?:[\\\\/]|$))",NO_DOT_SLASH:"(?!\\.{0,1}(?:[\\\\/]|$))",NO_DOTS_SLASH:"(?!\\.{1,2}(?:[\\\\/]|$))",QMARK_NO_DOT:"[^.\\\\/]",START_ANCHOR:"(?:^|[\\\\/])",END_ANCHOR:"(?:[\\\\/]|$)",SEP:"\\"},LAe={__proto__:null,alnum:"a-zA-Z0-9",alpha:"a-zA-Z",ascii:"\\x00-\\x7F",blank:" \\t",cntrl:"\\x00-\\x1F\\x7F",digit:"0-9",graph:"\\x21-\\x7E",lower:"a-z",print:"\\x20-\\x7E ",punct:"\\-!\"#$%&'()\\*+,./:;<=>?@[\\]^_`{|}~",space:" \\t\\r\\n\\v\\f",upper:"A-Z",word:"A-Za-z0-9_",xdigit:"A-Fa-f0-9"};WJ.exports={DEFAULT_MAX_EXTGLOB_RECURSION:0,MAX_LENGTH:1024*64,POSIX_REGEX_SOURCE:LAe,REGEX_BACKSLASH:/\\(?![*+?^${}(|)[\]])/g,REGEX_NON_SPECIAL_CHARS:/^[^@![\].,$*+?^{}()|\\/]+/,REGEX_SPECIAL_CHARS:/[-*+?.^${}(|)[\]]/,REGEX_SPECIAL_CHARS_BACKREF:/(\\?)((\W)(\3*))/g,REGEX_SPECIAL_CHARS_GLOBAL:/([-*+?.^${}(|)[\]])/g,REGEX_REMOVE_BACKSLASH:/(?:\[.*?[^\\]\]|\\(?=.))/g,REPLACEMENTS:{__proto__:null,"***":"*","**/**":"**","**/**/**":"**"},CHAR_0:48,CHAR_9:57,CHAR_UPPERCASE_A:65,CHAR_LOWERCASE_A:97,CHAR_UPPERCASE_Z:90,CHAR_LOWERCASE_Z:122,CHAR_LEFT_PARENTHESES:40,CHAR_RIGHT_PARENTHESES:41,CHAR_ASTERISK:42,CHAR_AMPERSAND:38,CHAR_AT:64,CHAR_BACKWARD_SLASH:92,CHAR_CARRIAGE_RETURN:13,CHAR_CIRCUMFLEX_ACCENT:94,CHAR_COLON:58,CHAR_COMMA:44,CHAR_DOT:46,CHAR_DOUBLE_QUOTE:34,CHAR_EQUAL:61,CHAR_EXCLAMATION_MARK:33,CHAR_FORM_FEED:12,CHAR_FORWARD_SLASH:47,CHAR_GRAVE_ACCENT:96,CHAR_HASH:35,CHAR_HYPHEN_MINUS:45,CHAR_LEFT_ANGLE_BRACKET:60,CHAR_LEFT_CURLY_BRACE:123,CHAR_LEFT_SQUARE_BRACKET:91,CHAR_LINE_FEED:10,CHAR_NO_BREAK_SPACE:160,CHAR_PERCENT:37,CHAR_PLUS:43,CHAR_QUESTION_MARK:63,CHAR_RIGHT_ANGLE_BRACKET:62,CHAR_RIGHT_CURLY_BRACE:125,CHAR_RIGHT_SQUARE_BRACKET:93,CHAR_SEMICOLON:59,CHAR_SINGLE_QUOTE:39,CHAR_SPACE:32,CHAR_TAB:9,CHAR_UNDERSCORE:95,CHAR_VERTICAL_LINE:124,CHAR_ZERO_WIDTH_NOBREAK_SPACE:65279,extglobChars(t){return{"!":{type:"negate",open:"(?:(?!(?:",close:`))${t.STAR})`},"?":{type:"qmark",open:"(?:",close:")?"},"+":{type:"plus",open:"(?:",close:")+"},"*":{type:"star",open:"(?:",close:")*"},"@":{type:"at",open:"(?:",close:")"}}},globChars(t){return t===!0?FAe:VJ}}});var gp=v(Fr=>{"use strict";var{REGEX_BACKSLASH:zAe,REGEX_REMOVE_BACKSLASH:UAe,REGEX_SPECIAL_CHARS:qAe,REGEX_SPECIAL_CHARS_GLOBAL:BAe}=hp();Fr.isObject=t=>t!==null&&typeof t=="object"&&!Array.isArray(t);Fr.hasRegexChars=t=>qAe.test(t);Fr.isRegexChar=t=>t.length===1&&Fr.hasRegexChars(t);Fr.escapeRegex=t=>t.replace(BAe,"\\$1");Fr.toPosixSlashes=t=>t.replace(zAe,"/");Fr.isWindows=()=>{if(typeof navigator<"u"&&navigator.platform){let t=navigator.platform.toLowerCase();return t==="win32"||t==="windows"}return typeof process<"u"&&process.platform?process.platform==="win32":!1};Fr.removeBackslashes=t=>t.replace(UAe,e=>e==="\\"?"":e);Fr.escapeLast=(t,e,r)=>{let n=t.lastIndexOf(e,r);return n===-1?t:t[n-1]==="\\"?Fr.escapeLast(t,e,n-1):`${t.slice(0,n)}\\${t.slice(n)}`};Fr.removePrefix=(t,e={})=>{let r=t;return r.startsWith("./")&&(r=r.slice(2),e.prefix="./"),r};Fr.wrapOutput=(t,e={},r={})=>{let n=r.contains?"":"^",i=r.contains?"":"$",o=`${n}(?:${t})${i}`;return e.negated===!0&&(o=`(?:^(?!${o}).*$)`),o};Fr.basename=(t,{windows:e}={})=>{let r=t.split(e?/[\\/]/:"/"),n=r[r.length-1];return n===""?r[r.length-2]:n}});var r8=v((odt,t8)=>{"use strict";var KJ=gp(),{CHAR_ASTERISK:DP,CHAR_AT:HAe,CHAR_BACKWARD_SLASH:yp,CHAR_COMMA:GAe,CHAR_DOT:NP,CHAR_EXCLAMATION_MARK:jP,CHAR_FORWARD_SLASH:e8,CHAR_LEFT_CURLY_BRACE:MP,CHAR_LEFT_PARENTHESES:FP,CHAR_LEFT_SQUARE_BRACKET:ZAe,CHAR_PLUS:VAe,CHAR_QUESTION_MARK:JJ,CHAR_RIGHT_CURLY_BRACE:WAe,CHAR_RIGHT_PARENTHESES:YJ,CHAR_RIGHT_SQUARE_BRACKET:KAe}=hp(),XJ=t=>t===e8||t===yp,QJ=t=>{t.isPrefix!==!0&&(t.depth=t.isGlobstar?1/0:1)},JAe=(t,e)=>{let r=e||{},n=t.length-1,i=r.parts===!0||r.scanToEnd===!0,o=[],s=[],a=[],c=t,l=-1,u=0,d=0,f=!1,p=!1,m=!1,h=!1,g=!1,b=!1,_=!1,S=!1,x=!1,w=!1,O=0,T,A,D={value:"",depth:0,isGlob:!1},$=()=>l>=n,re=()=>c.charCodeAt(l+1),K=()=>(T=A,c.charCodeAt(++l));for(;l0&&(C=c.slice(0,u),c=c.slice(u),d-=u),xe&&m===!0&&d>0?(xe=c.slice(0,d),P=c.slice(d)):m===!0?(xe="",P=c):xe=c,xe&&xe!==""&&xe!=="/"&&xe!==c&&XJ(xe.charCodeAt(xe.length-1))&&(xe=xe.slice(0,-1)),r.unescape===!0&&(P&&(P=KJ.removeBackslashes(P)),xe&&_===!0&&(xe=KJ.removeBackslashes(xe)));let Ir={prefix:C,input:t,start:u,base:xe,glob:P,isBrace:f,isBracket:p,isGlob:m,isExtglob:h,isGlobstar:g,negated:S,negatedExtglob:x};if(r.tokens===!0&&(Ir.maxDepth=0,XJ(A)||s.push(D),Ir.tokens=s),r.parts===!0||r.tokens===!0){let se;for(let Ce=0;Ce{"use strict";var _p=hp(),an=gp(),{MAX_LENGTH:Fv,POSIX_REGEX_SOURCE:YAe,REGEX_NON_SPECIAL_CHARS:XAe,REGEX_SPECIAL_CHARS_BACKREF:QAe,REPLACEMENTS:n8}=_p,eTe=(t,e)=>{if(typeof e.expandRange=="function")return e.expandRange(...t,e);t.sort();let r=`[${t.join("-")}]`;try{new RegExp(r)}catch{return t.map(i=>an.escapeRegex(i)).join("..")}return r},Hl=(t,e)=>`Missing ${t}: "${e}" - use "\\\\${e}" to match literal characters`,i8=t=>{let e=[],r=0,n=0,i=0,o="",s=!1;for(let a of t){if(s===!0){o+=a,s=!1;continue}if(a==="\\"){o+=a,s=!0;continue}if(a==='"'){i=i===1?0:1,o+=a;continue}if(i===0){if(a==="[")r++;else if(a==="]"&&r>0)r--;else if(r===0){if(a==="(")n++;else if(a===")"&&n>0)n--;else if(a==="|"&&n===0){e.push(o),o="";continue}}}o+=a}return e.push(o),e},tTe=t=>{let e=!1;for(let r of t){if(e===!0){e=!1;continue}if(r==="\\"){e=!0;continue}if(/[?*+@!()[\]{}]/.test(r))return!1}return!0},o8=t=>{let e=t.trim(),r=!0;for(;r===!0;)r=!1,/^@\([^\\()[\]{}|]+\)$/.test(e)&&(e=e.slice(2,-1),r=!0);if(tTe(e))return e.replace(/\\(.)/g,"$1")},rTe=t=>{let e=t.map(o8).filter(Boolean);for(let r=0;r{if(t[0]!=="+"&&t[0]!=="*"||t[1]!=="(")return;let r=0,n=0,i=0,o=!1;for(let s=1;s0){r--;continue}if(!(r>0)){if(a==="("){n++;continue}if(a===")"&&(n--,n===0))return e===!0&&s!==t.length-1?void 0:{type:t[0],body:t.slice(2,s),end:s}}}}},nTe=t=>{let e=0,r=[];for(;ea.trim());if(o.length!==1)return;let s=o8(o[0]);if(!s||s.length!==1)return;r.push(s),e+=i.end+1}return r.length<1?void 0:`${r.length===1?an.escapeRegex(r[0]):`[${r.map(i=>an.escapeRegex(i)).join("")}]`}*`},iTe=t=>{let e=0,r=t.trim(),n=LP(r);for(;n;)e++,r=n.body.trim(),n=LP(r);return e},oTe=(t,e)=>{if(e.maxExtglobRecursion===!1)return{risky:!1};let r=typeof e.maxExtglobRecursion=="number"?e.maxExtglobRecursion:_p.DEFAULT_MAX_EXTGLOB_RECURSION,n=i8(t).map(i=>i.trim());if(n.length>1&&(n.some(i=>i==="")||n.some(i=>/^[*?]+$/.test(i))||rTe(n)))return{risky:!0};for(let i of n){let o=nTe(i);if(o)return{risky:!0,safeOutput:o};if(iTe(i)>r)return{risky:!0}}return{risky:!1}},zP=(t,e)=>{if(typeof t!="string")throw new TypeError("Expected a string");t=n8[t]||t;let r={...e},n=typeof r.maxLength=="number"?Math.min(Fv,r.maxLength):Fv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);let o={type:"bos",value:"",output:r.prepend||""},s=[o],a=r.capture?"":"?:",c=_p.globChars(r.windows),l=_p.extglobChars(c),{DOT_LITERAL:u,PLUS_LITERAL:d,SLASH_LITERAL:f,ONE_CHAR:p,DOTS_SLASH:m,NO_DOT:h,NO_DOT_SLASH:g,NO_DOTS_SLASH:b,QMARK:_,QMARK_NO_DOT:S,STAR:x,START_ANCHOR:w}=c,O=H=>`(${a}(?:(?!${w}${H.dot?m:u}).)*?)`,T=r.dot?"":h,A=r.dot?_:S,D=r.bash===!0?O(r):x;r.capture&&(D=`(${D})`),typeof r.noext=="boolean"&&(r.noextglob=r.noext);let $={input:t,index:-1,start:0,dot:r.dot===!0,consumed:"",output:"",prefix:"",backtrack:!1,negated:!1,brackets:0,braces:0,parens:0,quotes:0,globstar:!1,tokens:s};t=an.removePrefix(t,$),i=t.length;let re=[],K=[],xe=[],C=o,P,Ir=()=>$.index===i-1,se=$.peek=(H=1)=>t[$.index+H],Ce=$.advance=()=>t[++$.index]||"",Kt=()=>t.slice($.index+1),dr=(H="",ht=0)=>{$.consumed+=H,$.index+=ht},Xt=H=>{$.output+=H.output!=null?H.output:H.value,dr(H.value)},lo=()=>{let H=1;for(;se()==="!"&&(se(2)!=="("||se(3)==="?");)Ce(),$.start++,H++;return H%2===0?!1:($.negated=!0,$.start++,!0)},$i=H=>{$[H]++,xe.push(H)},Xr=H=>{$[H]--,xe.pop()},de=H=>{if(C.type==="globstar"){let ht=$.braces>0&&(H.type==="comma"||H.type==="brace"),B=H.extglob===!0||re.length&&(H.type==="pipe"||H.type==="paren");H.type!=="slash"&&H.type!=="paren"&&!ht&&!B&&($.output=$.output.slice(0,-C.output.length),C.type="star",C.value="*",C.output=D,$.output+=C.output)}if(re.length&&H.type!=="paren"&&(re[re.length-1].inner+=H.value),(H.value||H.output)&&Xt(H),C&&C.type==="text"&&H.type==="text"){C.output=(C.output||C.value)+H.value,C.value+=H.value;return}H.prev=C,s.push(H),C=H},uo=(H,ht)=>{let B={...l[ht],conditions:1,inner:""};B.prev=C,B.parens=$.parens,B.output=$.output,B.startIndex=$.index,B.tokensIndex=s.length;let Oe=(r.capture?"(":"")+B.open;$i("parens"),de({type:H,value:ht,output:$.output?"":p}),de({type:"paren",extglob:!0,value:Ce(),output:Oe}),re.push(B)},Mde=H=>{let ht=t.slice(H.startIndex,$.index+1),B=t.slice(H.startIndex+2,$.index),Oe=oTe(B,r);if((H.type==="plus"||H.type==="star")&&Oe.risky){let lt=Oe.safeOutput?(H.output?"":p)+(r.capture?`(${Oe.safeOutput})`:Oe.safeOutput):void 0,ki=s[H.tokensIndex];ki.type="text",ki.value=ht,ki.output=lt||an.escapeRegex(ht);for(let Ei=H.tokensIndex+1;Ei1&&H.inner.includes("/")&&(lt=O(r)),(lt!==D||Ir()||/^\)+$/.test(Kt()))&&(ut=H.close=`)$))${lt}`),H.inner.includes("*")&&(zt=Kt())&&/^\.[^\\/.]+$/.test(zt)){let ki=zP(zt,{...e,fastpaths:!1}).output;ut=H.close=`)${ki})${lt})`}H.prev.type==="bos"&&($.negatedExtglob=!0)}de({type:"paren",extglob:!0,value:P,output:ut}),Xr("parens")};if(r.fastpaths!==!1&&!/(^[*!]|[/()[\]{}"])/.test(t)){let H=!1,ht=t.replace(QAe,(B,Oe,ut,zt,lt,ki)=>zt==="\\"?(H=!0,B):zt==="?"?Oe?Oe+zt+(lt?_.repeat(lt.length):""):ki===0?A+(lt?_.repeat(lt.length):""):_.repeat(ut.length):zt==="."?u.repeat(ut.length):zt==="*"?Oe?Oe+zt+(lt?D:""):D:Oe?B:`\\${B}`);return H===!0&&(r.unescape===!0?ht=ht.replace(/\\/g,""):ht=ht.replace(/\\+/g,B=>B.length%2===0?"\\\\":B?"\\":"")),ht===t&&r.contains===!0?($.output=t,$):($.output=an.wrapOutput(ht,$,e),$)}for(;!Ir();){if(P=Ce(),P==="\0")continue;if(P==="\\"){let B=se();if(B==="/"&&r.bash!==!0||B==="."||B===";")continue;if(!B){P+="\\",de({type:"text",value:P});continue}let Oe=/^\\+/.exec(Kt()),ut=0;if(Oe&&Oe[0].length>2&&(ut=Oe[0].length,$.index+=ut,ut%2!==0&&(P+="\\")),r.unescape===!0?P=Ce():P+=Ce(),$.brackets===0){de({type:"text",value:P});continue}}if($.brackets>0&&(P!=="]"||C.value==="["||C.value==="[^")){if(r.posix!==!1&&P===":"){let B=C.value.slice(1);if(B.includes("[")&&(C.posix=!0,B.includes(":"))){let Oe=C.value.lastIndexOf("["),ut=C.value.slice(0,Oe),zt=C.value.slice(Oe+2),lt=YAe[zt];if(lt){C.value=ut+lt,$.backtrack=!0,Ce(),!o.output&&s.indexOf(C)===1&&(o.output=p);continue}}}(P==="["&&se()!==":"||P==="-"&&se()==="]")&&(P=`\\${P}`),P==="]"&&(C.value==="["||C.value==="[^")&&(P=`\\${P}`),r.posix===!0&&P==="!"&&C.value==="["&&(P="^"),C.value+=P,Xt({value:P});continue}if($.quotes===1&&P!=='"'){P=an.escapeRegex(P),C.value+=P,Xt({value:P});continue}if(P==='"'){$.quotes=$.quotes===1?0:1,r.keepQuotes===!0&&de({type:"text",value:P});continue}if(P==="("){$i("parens"),de({type:"paren",value:P});continue}if(P===")"){if($.parens===0&&r.strictBrackets===!0)throw new SyntaxError(Hl("opening","("));let B=re[re.length-1];if(B&&$.parens===B.parens+1){Mde(re.pop());continue}de({type:"paren",value:P,output:$.parens?")":"\\)"}),Xr("parens");continue}if(P==="["){if(r.nobracket===!0||!Kt().includes("]")){if(r.nobracket!==!0&&r.strictBrackets===!0)throw new SyntaxError(Hl("closing","]"));P=`\\${P}`}else $i("brackets");de({type:"bracket",value:P});continue}if(P==="]"){if(r.nobracket===!0||C&&C.type==="bracket"&&C.value.length===1){de({type:"text",value:P,output:`\\${P}`});continue}if($.brackets===0){if(r.strictBrackets===!0)throw new SyntaxError(Hl("opening","["));de({type:"text",value:P,output:`\\${P}`});continue}Xr("brackets");let B=C.value.slice(1);if(C.posix!==!0&&B[0]==="^"&&!B.includes("/")&&(P=`/${P}`),C.value+=P,Xt({value:P}),r.literalBrackets===!1||an.hasRegexChars(B))continue;let Oe=an.escapeRegex(C.value);if($.output=$.output.slice(0,-C.value.length),r.literalBrackets===!0){$.output+=Oe,C.value=Oe;continue}C.value=`(${a}${Oe}|${C.value})`,$.output+=C.value;continue}if(P==="{"&&r.nobrace!==!0){$i("braces");let B={type:"brace",value:P,output:"(",outputIndex:$.output.length,tokensIndex:$.tokens.length};K.push(B),de(B);continue}if(P==="}"){let B=K[K.length-1];if(r.nobrace===!0||!B){de({type:"text",value:P,output:P});continue}let Oe=")";if(B.dots===!0){let ut=s.slice(),zt=[];for(let lt=ut.length-1;lt>=0&&(s.pop(),ut[lt].type!=="brace");lt--)ut[lt].type!=="dots"&&zt.unshift(ut[lt].value);Oe=eTe(zt,r),$.backtrack=!0}if(B.comma!==!0&&B.dots!==!0){let ut=$.output.slice(0,B.outputIndex),zt=$.tokens.slice(B.tokensIndex);B.value=B.output="\\{",P=Oe="\\}",$.output=ut;for(let lt of zt)$.output+=lt.output||lt.value}de({type:"brace",value:P,output:Oe}),Xr("braces"),K.pop();continue}if(P==="|"){re.length>0&&re[re.length-1].conditions++,de({type:"text",value:P});continue}if(P===","){let B=P,Oe=K[K.length-1];Oe&&xe[xe.length-1]==="braces"&&(Oe.comma=!0,B="|"),de({type:"comma",value:P,output:B});continue}if(P==="/"){if(C.type==="dot"&&$.index===$.start+1){$.start=$.index+1,$.consumed="",$.output="",s.pop(),C=o;continue}de({type:"slash",value:P,output:f});continue}if(P==="."){if($.braces>0&&C.type==="dot"){C.value==="."&&(C.output=u);let B=K[K.length-1];C.type="dots",C.output+=P,C.value+=P,B.dots=!0;continue}if($.braces+$.parens===0&&C.type!=="bos"&&C.type!=="slash"){de({type:"text",value:P,output:u});continue}de({type:"dot",value:P,output:u});continue}if(P==="?"){if(!(C&&C.value==="(")&&r.noextglob!==!0&&se()==="("&&se(2)!=="?"){uo("qmark",P);continue}if(C&&C.type==="paren"){let Oe=se(),ut=P;(C.value==="("&&!/[!=<:]/.test(Oe)||Oe==="<"&&!/<([!=]|\w+>)/.test(Kt()))&&(ut=`\\${P}`),de({type:"text",value:P,output:ut});continue}if(r.dot!==!0&&(C.type==="slash"||C.type==="bos")){de({type:"qmark",value:P,output:S});continue}de({type:"qmark",value:P,output:_});continue}if(P==="!"){if(r.noextglob!==!0&&se()==="("&&(se(2)!=="?"||!/[!=<:]/.test(se(3)))){uo("negate",P);continue}if(r.nonegate!==!0&&$.index===0){lo();continue}}if(P==="+"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){uo("plus",P);continue}if(C&&C.value==="("||r.regex===!1){de({type:"plus",value:P,output:d});continue}if(C&&(C.type==="bracket"||C.type==="paren"||C.type==="brace")||$.parens>0){de({type:"plus",value:P});continue}de({type:"plus",value:d});continue}if(P==="@"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){de({type:"at",extglob:!0,value:P,output:""});continue}de({type:"text",value:P});continue}if(P!=="*"){(P==="$"||P==="^")&&(P=`\\${P}`);let B=XAe.exec(Kt());B&&(P+=B[0],$.index+=B[0].length),de({type:"text",value:P});continue}if(C&&(C.type==="globstar"||C.star===!0)){C.type="star",C.star=!0,C.value+=P,C.output=D,$.backtrack=!0,$.globstar=!0,dr(P);continue}let H=Kt();if(r.noextglob!==!0&&/^\([^?]/.test(H)){uo("star",P);continue}if(C.type==="star"){if(r.noglobstar===!0){dr(P);continue}let B=C.prev,Oe=B.prev,ut=B.type==="slash"||B.type==="bos",zt=Oe&&(Oe.type==="star"||Oe.type==="globstar");if(r.bash===!0&&(!ut||H[0]&&H[0]!=="/")){de({type:"star",value:P,output:""});continue}let lt=$.braces>0&&(B.type==="comma"||B.type==="brace"),ki=re.length&&(B.type==="pipe"||B.type==="paren");if(!ut&&B.type!=="paren"&&!lt&&!ki){de({type:"star",value:P,output:""});continue}for(;H.slice(0,3)==="/**";){let Ei=t[$.index+4];if(Ei&&Ei!=="/")break;H=H.slice(3),dr("/**",3)}if(B.type==="bos"&&Ir()){C.type="globstar",C.value+=P,C.output=O(r),$.output=C.output,$.globstar=!0,dr(P);continue}if(B.type==="slash"&&B.prev.type!=="bos"&&!zt&&Ir()){$.output=$.output.slice(0,-(B.output+C.output).length),B.output=`(?:${B.output}`,C.type="globstar",C.output=O(r)+(r.strictSlashes?")":"|$)"),C.value+=P,$.globstar=!0,$.output+=B.output+C.output,dr(P);continue}if(B.type==="slash"&&B.prev.type!=="bos"&&H[0]==="/"){let Ei=H[1]!==void 0?"|$":"";$.output=$.output.slice(0,-(B.output+C.output).length),B.output=`(?:${B.output}`,C.type="globstar",C.output=`${O(r)}${f}|${f}${Ei})`,C.value+=P,$.output+=B.output+C.output,$.globstar=!0,dr(P+Ce()),de({type:"slash",value:"/",output:""});continue}if(B.type==="bos"&&H[0]==="/"){C.type="globstar",C.value+=P,C.output=`(?:^|${f}|${O(r)}${f})`,$.output=C.output,$.globstar=!0,dr(P+Ce()),de({type:"slash",value:"/",output:""});continue}$.output=$.output.slice(0,-C.output.length),C.type="globstar",C.output=O(r),C.value+=P,$.output+=C.output,$.globstar=!0,dr(P);continue}let ht={type:"star",value:P,output:D};if(r.bash===!0){ht.output=".*?",(C.type==="bos"||C.type==="slash")&&(ht.output=T+ht.output),de(ht);continue}if(C&&(C.type==="bracket"||C.type==="paren")&&r.regex===!0){ht.output=P,de(ht);continue}($.index===$.start||C.type==="slash"||C.type==="dot")&&(C.type==="dot"?($.output+=g,C.output+=g):r.dot===!0?($.output+=b,C.output+=b):($.output+=T,C.output+=T),se()!=="*"&&($.output+=p,C.output+=p)),de(ht)}for(;$.brackets>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing","]"));$.output=an.escapeLast($.output,"["),Xr("brackets")}for(;$.parens>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing",")"));$.output=an.escapeLast($.output,"("),Xr("parens")}for(;$.braces>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing","}"));$.output=an.escapeLast($.output,"{"),Xr("braces")}if(r.strictSlashes!==!0&&(C.type==="star"||C.type==="bracket")&&de({type:"maybe_slash",value:"",output:`${f}?`}),$.backtrack===!0){$.output="";for(let H of $.tokens)$.output+=H.output!=null?H.output:H.value,H.suffix&&($.output+=H.suffix)}return $};zP.fastpaths=(t,e)=>{let r={...e},n=typeof r.maxLength=="number"?Math.min(Fv,r.maxLength):Fv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);t=n8[t]||t;let{DOT_LITERAL:o,SLASH_LITERAL:s,ONE_CHAR:a,DOTS_SLASH:c,NO_DOT:l,NO_DOTS:u,NO_DOTS_SLASH:d,STAR:f,START_ANCHOR:p}=_p.globChars(r.windows),m=r.dot?u:l,h=r.dot?d:l,g=r.capture?"":"?:",b={negated:!1,prefix:""},_=r.bash===!0?".*?":f;r.capture&&(_=`(${_})`);let S=T=>T.noglobstar===!0?_:`(${g}(?:(?!${p}${T.dot?c:o}).)*?)`,x=T=>{switch(T){case"*":return`${m}${a}${_}`;case".*":return`${o}${a}${_}`;case"*.*":return`${m}${_}${o}${a}${_}`;case"*/*":return`${m}${_}${s}${a}${h}${_}`;case"**":return m+S(r);case"**/*":return`(?:${m}${S(r)}${s})?${h}${a}${_}`;case"**/*.*":return`(?:${m}${S(r)}${s})?${h}${_}${o}${a}${_}`;case"**/.*":return`(?:${m}${S(r)}${s})?${o}${a}${_}`;default:{let A=/^(.*?)\.(\w+)$/.exec(T);if(!A)return;let D=x(A[1]);return D?D+o+A[2]:void 0}}},w=an.removePrefix(t,b),O=x(w);return O&&r.strictSlashes!==!0&&(O+=`${s}?`),O};s8.exports=zP});var u8=v((adt,l8)=>{"use strict";var sTe=r8(),UP=a8(),c8=gp(),aTe=hp(),cTe=t=>t&&typeof t=="object"&&!Array.isArray(t),Rt=(t,e,r=!1)=>{if(Array.isArray(t)){let u=t.map(f=>Rt(f,e,r));return f=>{for(let p of u){let m=p(f);if(m)return m}return!1}}let n=cTe(t)&&t.tokens&&t.input;if(t===""||typeof t!="string"&&!n)throw new TypeError("Expected pattern to be a non-empty string");let i=e||{},o=i.windows,s=n?Rt.compileRe(t,e):Rt.makeRe(t,e,!1,!0),a=s.state;delete s.state;let c=()=>!1;if(i.ignore){let u={...e,ignore:null,onMatch:null,onResult:null};c=Rt(i.ignore,u,r)}let l=(u,d=!1)=>{let{isMatch:f,match:p,output:m}=Rt.test(u,s,e,{glob:t,posix:o}),h={glob:t,state:a,regex:s,posix:o,input:u,output:m,match:p,isMatch:f};return typeof i.onResult=="function"&&i.onResult(h),f===!1?(h.isMatch=!1,d?h:!1):c(u)?(typeof i.onIgnore=="function"&&i.onIgnore(h),h.isMatch=!1,d?h:!1):(typeof i.onMatch=="function"&&i.onMatch(h),d?h:!0)};return r&&(l.state=a),l};Rt.test=(t,e,r,{glob:n,posix:i}={})=>{if(typeof t!="string")throw new TypeError("Expected input to be a string");if(t==="")return{isMatch:!1,output:""};let o=r||{},s=o.format||(i?c8.toPosixSlashes:null),a=t===n,c=a&&s?s(t):t;return a===!1&&(c=s?s(t):t,a=c===n),(a===!1||o.capture===!0)&&(o.matchBase===!0||o.basename===!0?a=Rt.matchBase(t,e,r,i):a=e.exec(c)),{isMatch:!!a,match:a,output:c}};Rt.matchBase=(t,e,r)=>(e instanceof RegExp?e:Rt.makeRe(e,r)).test(c8.basename(t));Rt.isMatch=(t,e,r)=>Rt(e,r)(t);Rt.parse=(t,e)=>Array.isArray(t)?t.map(r=>Rt.parse(r,e)):UP(t,{...e,fastpaths:!1});Rt.scan=(t,e)=>sTe(t,e);Rt.compileRe=(t,e,r=!1,n=!1)=>{if(r===!0)return t.output;let i=e||{},o=i.contains?"":"^",s=i.contains?"":"$",a=`${o}(?:${t.output})${s}`;t&&t.negated===!0&&(a=`^(?!${a}).*$`);let c=Rt.toRegex(a,e);return n===!0&&(c.state=t),c};Rt.makeRe=(t,e={},r=!1,n=!1)=>{if(!t||typeof t!="string")throw new TypeError("Expected a non-empty string");let i={negated:!1,fastpaths:!0};return e.fastpaths!==!1&&(t[0]==="."||t[0]==="*")&&(i.output=UP.fastpaths(t,e)),i.output||(i=UP(t,e)),Rt.compileRe(i,e,r,n)};Rt.toRegex=(t,e)=>{try{let r=e||{};return new RegExp(t,r.flags||(r.nocase?"i":""))}catch(r){if(e&&e.debug===!0)throw r;return/$^/}};Rt.constants=aTe;l8.exports=Rt});var m8=v((cdt,p8)=>{"use strict";var d8=u8(),lTe=gp();function f8(t,e,r=!1){return e&&(e.windows===null||e.windows===void 0)&&(e={...e,windows:lTe.isWindows()}),d8(t,e,r)}Object.assign(f8,d8);p8.exports=f8});import{readdir as uTe,readdirSync as dTe,realpath as fTe,realpathSync as pTe,stat as mTe,statSync as hTe}from"fs";import{isAbsolute as gTe,posix as Ha,resolve as yTe}from"path";import{fileURLToPath as _Te}from"url";function STe(t,e={}){let r=t.length,n=Array(r),i=Array(r),o,s;for(o=0;o{let c=a.split("/");if(c[0]===".."&&vTe.test(a))return!0;for(o=0;oo.slice(i,s?-1:void 0)||"."}let n=e.slice(t.length+1);return n?(i,o)=>{if(i===".")return n;let s=`${n}/${i}`;return o?s.slice(0,-1):s}:(i,o)=>o&&i!=="."?i.slice(0,-1):i}return r?n=>Ha.relative(t,n)||".":n=>Ha.relative(t,`${e}/${n}`)||"."}function $Te(t,e){if(e.startsWith(`${t}/`)){let r=e.slice(t.length+1);return n=>`${r}/${n}`}return r=>{let n=Ha.relative(t,`${e}/${r}`);return r[r.length-1]==="/"&&n!==""?`${n}/`:n||"."}}function _8(t){var e;let r=Gl.default.scan(t,kTe);return!((e=r.parts)===null||e===void 0)&&e.length?r.parts:[t]}function ITe(t,e){if(e?.caseSensitiveMatch===!1)return!0;let r=Gl.default.scan(t);return r.isGlob||r.negated}function bp(...t){console.log(`[tinyglobby ${new Date().toLocaleTimeString("es")}]`,...t)}function b8(t){return typeof t=="string"?[t]:t??[]}function qP(t,e,r,n){var i;let o=e.cwd,s=t;t[t.length-1]==="/"&&(s=t.slice(0,-1)),s[s.length-1]!=="*"&&e.expandDirectories&&(s+="/**");let a=RTe(o);s=gTe(s.replace(CTe,""))?Ha.relative(a,s):Ha.normalize(s);let c=(i=PTe.exec(s))===null||i===void 0?void 0:i[0],l=_8(s);if(c){let d=(c.length+1)/3,f=0,p=a.split("/");for(;fm.length&&(r.root=m,r.depthOffset=-d+f)}if(!n&&r.depthOffset>=0){var u;(u=r.commonPath)!==null&&u!==void 0||(r.commonPath=l);let d=[],f=Math.min(r.commonPath.length,l.length);for(let p=0;p0?Ha.join(o,...d):o}return s}function DTe(t,e,r){let n=[],i=[];for(let o of t.ignore)o&&(o[0]!=="!"||o[1]==="(")&&i.push(qP(o,t,r,!0));for(let o of e)o&&(o[0]!=="!"||o[1]==="("?n.push(qP(o,t,r,!1)):(o[1]!=="!"||o[2]==="(")&&i.push(qP(o.slice(1),t,r,!0)));return{match:n,ignore:i}}function NTe(t,e){let r=t.cwd,n={root:r,depthOffset:0},i=DTe(t,e,n);t.debug&&bp("internal processing patterns:",i);let{absolute:o,caseSensitiveMatch:s,debug:a,dot:c,followSymbolicLinks:l,onlyDirectories:u}=t,d=n.root.replace(g8,""),f={dot:c,nobrace:t.braceExpansion===!1,nocase:!s,noextglob:t.extglob===!1,noglobstar:t.globstar===!1,posix:!0},p=(0,Gl.default)(i.match,f),m=(0,Gl.default)(i.ignore,f),h=STe(i.match,f),g=h8(r,d,o),b=o?g:h8(r,d,!0),_=(w,O)=>{let T=b(O,!0);return T!=="."&&!h(T)||m(T)},S;t.deep!==void 0&&(S=Math.round(t.deep-n.depthOffset));let x=new qJ({filters:[a?(w,O)=>{let T=g(w,O),A=p(T)&&!m(T);return A&&bp(`matched ${T}`),A}:(w,O)=>{let T=g(w,O);return p(T)&&!m(T)}],exclude:a?(w,O)=>{let T=_(w,O);return bp(`${T?"skipped":"crawling"} ${O}`),T}:_,fs:t.fs,pathSeparator:"/",relativePaths:!o,resolvePaths:o,includeBasePath:o,resolveSymlinks:l,excludeSymlinks:!l,excludeFiles:u,includeDirs:u||!t.onlyFiles,maxDepth:S,signal:t.signal}).crawl(d);return t.debug&&bp("internal properties:",{...n,root:d}),[x,r!==d&&!o&&$Te(r,d)]}function jTe(t,e){if(e)for(let r=t.length-1;r>=0;r--)t[r]=e(t[r]);return t}function FTe(t){let e={...MTe,...t};return e.cwd=(e.cwd instanceof URL?_Te(e.cwd):yTe(e.cwd)).replace(g8,"/"),e.ignore=b8(e.ignore),e.fs&&(e.fs={readdir:e.fs.readdir||uTe,readdirSync:e.fs.readdirSync||dTe,realpath:e.fs.realpath||fTe,realpathSync:e.fs.realpathSync||pTe,stat:e.fs.stat||mTe,statSync:e.fs.statSync||hTe}),e.debug&&bp("globbing with options:",e),e}function LTe(t,e={}){var r;if(t&&e?.patterns)throw new Error("Cannot pass patterns as both an argument and an option");let n=bTe(t)||typeof t=="string",i=b8((r=n?t:t.patterns)!==null&&r!==void 0?r:"**/*"),o=FTe(n?e:t);return i.length>0?NTe(o,i):[]}function ys(t,e){let[r,n]=LTe(t,e);return r?jTe(r.sync(),n):[]}var Gl,bTe,g8,y8,vTe,wTe,xTe,kTe,ETe,ATe,TTe,OTe,RTe,PTe,CTe,MTe,vp=y(()=>{BJ();Gl=St(m8(),1),bTe=Array.isArray,g8=/\\/g,y8=process.platform==="win32",vTe=/^(\/?\.\.)+$/;wTe=/^[A-Z]:\/$/i,xTe=y8?t=>wTe.test(t):t=>t==="/";kTe={parts:!0};ETe=/(?t.replace(ETe,"\\$&"),OTe=t=>t.replace(ATe,"\\$&"),RTe=y8?OTe:TTe;PTe=/^(\/?\.\.)+/,CTe=/\\(?=[()[\]{}!*+?@|])/g;MTe={caseSensitiveMatch:!0,cwd:process.cwd(),debug:!!process.env.TINYGLOBBY_DEBUG,expandDirectories:!0,followSymbolicLinks:!0,onlyFiles:!0}});import{existsSync as Sp,readFileSync as zTe,readdirSync as UTe,statSync as v8}from"node:fs";import{join as Ga}from"node:path";function qTe(t){let{cwd:e="."}=t,r,n;try{let c=q(e);r=c.architecture,n=c.project?.language}catch{return[]}if(!r)return[];let i=Fi(e,n),o=[],{layers:s,forbiddenImports:a}=BP(r);return(s.size>0||a.length>0)&&!Sp(Ga(e,i.mainRoot))?[{detector:wp,severity:"info",path:`${i.mainRoot}/`,message:`architecture layers declared but ${i.mainRoot}/ not found \u2014 layer checks skipped (flat layout not yet supported)`}]:(s.size>0&&(BTe(e,i,s,o),HTe(e,i,s,o)),a.length>0&>e(e,i,a,o),o)}function BP(t){let e=new Set,r=[];for(let i of t.layers??[])if(Array.isArray(i))for(let o of i)e.add(o);else{let o=i;if(typeof o.name=="string"&&o.name.length>0){e.add(o.name);for(let s of o.forbidden_imports??[])typeof s=="string"&&r.push({from:o.name,to:s})}}let n=t.forbidden_imports??[];return{layers:e,forbiddenImports:[...n,...r]}}function BTe(t,e,r,n){let i=e.mainRoot,o=Ga(t,i);if(Sp(o))for(let s of UTe(o)){let a=Ga(o,s);v8(a).isDirectory()&&(r.has(s)||n.push({detector:wp,severity:"warn",path:`${i}/${s}/`,message:`${i}/${s}/ is not declared in spec/architecture.yaml layers \u2014 add it or remove the directory`}))}}function HTe(t,e,r,n){let i=e.mainRoot,o=Ga(t,i);if(Sp(o))for(let s of r){let a=Ga(o,s);Sp(a)&&v8(a).isDirectory()||n.push({detector:wp,severity:"warn",path:`${i}/${s}/`,message:`spec/architecture.yaml declares layer '${s}' but ${i}/${s}/ does not exist \u2014 fix the spec or create the directory`})}}function GTe(t,e,r,n){let i=e.mainRoot,o=e.importMatcher;for(let s of r){let a=Ga(t,i,s.from);if(!Sp(a))continue;let c=ys([`**/*.${e.ext}`],{cwd:a,dot:!1});for(let l of c){let u=Ga(a,l),d;try{d=zTe(u,"utf8")}catch{continue}let f;for(o.lastIndex=0;(f=o.exec(d))!==null;){let p=f[1];ZTe(p,s.to,e.importStyle)&&n.push({detector:wp,severity:"error",path:`${i}/${s.from}/${l}`,message:`${i}/${s.from}/${l} imports from '${p}' which crosses into the '${s.to}' layer \u2014 spec/architecture.yaml forbids imports from '${s.from}' to '${s.to}'`})}}}}function ZTe(t,e,r){return r==="dotted"?t.split(".").includes(e):t.startsWith(".")?t.split("/").includes(e):!1}var wp,S8,HP=y(()=>{"use strict";vp();Ue();Ba();wp="ARCHITECTURE_FROM_SPEC";S8={name:wp,run:qTe}});import{existsSync as VTe,readFileSync as WTe}from"node:fs";import{join as KTe}from"node:path";function YTe(t){let{cwd:e="."}=t,r=KTe(e,"spec/capabilities.yaml");if(!VTe(r))return[];let n;try{let u=WTe(r,"utf8"),d=w8.default.parse(u);if(!d||typeof d!="object")return[];n=d}catch{return[]}let i=n.capabilities??[];if(i.length===0)return[];let o,s=!1;try{let u=q(e);o=new Set(u.features.map(d=>d.id)),s=u.project.onboarding_seeded===!0}catch{return[]}let a=[],c=new Set,l=s&&o.size{"use strict";w8=St(er(),1);Ue();Lv="CAPABILITIES_FEATURE_MAPPING",JTe=8;x8={name:Lv,run:YTe}});import{existsSync as XTe,readFileSync as QTe}from"node:fs";import{join as eOe}from"node:path";function tOe(t){let e=t.trimStart();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("#")||e.startsWith('"""')||e.startsWith("'''")}function rOe(t){let{cwd:e="."}=t;return ge(e,GP,r=>nOe(r,e))}function nOe(t,e){let r=Fi(e,t.project?.language),n=[];for(let i of t.features)for(let o of i.modules??[]){if(!r.extensions.some(c=>o.endsWith(c)))continue;let s=eOe(e,o);if(!XTe(s))continue;let a=QTe(s,"utf8");tOe(a)||n.push({detector:GP,severity:"warn",path:o,message:`${o} has no file-header comment \u2014 Why>What guardrail recommends a one-line intent`})}return n}var GP,k8,E8=y(()=>{"use strict";Ba();wt();GP="CONVENTION_DRIFT";k8={name:GP,run:rOe}});import{existsSync as ZP,readFileSync as A8}from"node:fs";import{join as zv}from"node:path";function iOe(t){return JSON.parse(t).total?.lines?.pct??0}function T8(t){let e=/]*\bline-rate="([0-9]*\.?[0-9]+)"/.exec(t);return e?Number(e[1])*100:null}function aOe(t,e){if(!$v(dt(t).gates.coverage?.cmd))return null;let r;try{r=kv(t,e)}catch(c){return[{detector:$o,severity:"error",message:c.message}]}let n=0,i=0,o=0,s=[];for(let c of r){let l=xP.find(d=>ZP(zv(c.dir,d)));if(!l){s.push(c.path);continue}let u=T8(A8(zv(c.dir,l),"utf8"));u&&(n+=u.missed,i+=u.covered,o++)}if(o===0)return[{detector:$o,severity:"info",message:`no module coverage report present for ${r.map(c=>c.path).join(", ")} \u2014 run stage_2.2 first`}];let a=O8(n,i);return a0?[{detector:$o,severity:"info",message:`module coverage ${a.toFixed(1)}% OK; no report yet for ${s.join(", ")}`}]:[]}function cOe(t){let{cwd:e="."}=t;if(t.focusModules&&t.focusModules.length>0){let a=aOe(e,t.focusModules);if(a)return a}let r;try{r=q(e).project?.language}catch{}let n=Fi(e,r),i=dt(e).language==="kotlin"?xP.find(a=>ZP(zv(e,a)))??uJ(e):n.coverageSummary,o=zv(e,i);if(!ZP(o))return[{detector:$o,severity:"info",message:`${i} not present \u2014 run stage_2.2 first`}];let s;try{let a=A8(o,"utf8");s=n.coverageFormat==="jacoco-xml"?oOe(a):n.coverageFormat==="cobertura-xml"?sOe(a):iOe(a)}catch(a){return[{detector:$o,severity:"warn",message:`${i} unparseable: ${a.message}`}]}return s===null?n.coverageFormat==="cobertura-xml"?[]:[{detector:$o,severity:"warn",message:`${i} contained no line-coverage counter`}]:s>=Uv?[]:[{detector:$o,severity:"warn",message:`line coverage ${s.toFixed(1)}% < floor ${Uv}%`}]}var $o,Uv,R8,I8=y(()=>{"use strict";Ue();Tv();Ba();Ev();sn();$o="COVERAGE_DROP",Uv=70;R8={name:$o,run:cOe}});import{existsSync as lOe}from"node:fs";import{join as uOe}from"node:path";function fOe(t){let{cwd:e="."}=t;return ge(e,qv,r=>pOe(r,e))}function pOe(t,e){let r=t.project.deliverable,n=t.features.filter(i=>i.status==="done"&&(i.modules?.length??0)>0);if(!r){if(n.length===0)return[];let i=t.project.onboarding_seeded===!0&&t.features.length{"use strict";wt();qv="DELIVERABLE_INTEGRITY",dOe=8;P8={name:qv,run:fOe}});function mOe(t){let e=new Set((t.features??[]).map(n=>n.id)),r=[];for(let n of t.project?.smoke??[]){let i=n.feature;if(i===void 0||e.has(i))continue;let o=(n.run??[]).join(" ")||`kind:${n.kind}`;r.push({detector:Bv,severity:"warn",path:"spec.yaml",message:`smoke probe '${o}' binds feature ${i}, which is not in the spec \u2014 a dangling binding is annotation drift (the bound feature was renamed, archived, or never existed). Fix the id or drop the binding.`})}return r}function hOe(t){let e=mOe(t),r=(t.features??[]).filter(o=>o.status==="done");return r.length===0||!!!t.project?.deliverable||(t.project?.smoke??[]).length>0?e:[...e,{detector:Bv,severity:"warn",path:"spec.yaml",message:`${r.length} feature(s) are done and the project ships a runnable deliverable, but no functional smoke probe is declared (project.smoke) \u2014 an exit-only deliverable is liveness, not AC-verification. Declare a smoke probe with an expect.token so the gate re-executes the shipped entry against its AC result.`}]}function gOe(t){let{cwd:e="."}=t;return ge(e,Bv,r=>hOe(r))}var Bv,D8,N8=y(()=>{"use strict";wt();Bv="SMOKE_PROBE_DEMAND";D8={name:Bv,run:gOe}});function yOe(t){let{cwd:e="."}=t;return ge(e,Hv,r=>_Oe(r,e))}function _Oe(t,e){let r=(t.features??[]).filter(o=>o.status==="done"&&(o.modules??[]).length>0);if(r.length===0)return[];let n=as(e);if(n===null)return[{detector:Hv,severity:"info",path:"spec/attestation.yaml",message:"no verification attestation \u2014 when this tree was last verified is unknown. Run `clad check --tier=pre-push --strict` GREEN once to attest (the gate writes spec/attestation.yaml)."}];let i=[];for(let o of r){let s=H_(n,e,o);s.state!=="fresh"&&i.push({detector:Hv,severity:"warn",path:"spec/attestation.yaml",message:s.state==="unattested"?`${o.id} is done but has no attestation entry \u2014 its modules were never verified by an attested gate. Run \`clad check --tier=pre-push --strict\` to attest.`:s.module?`${o.id}'s module ${s.module} changed since the last attested verification \u2014 shipped code is running ahead of its verification. Run \`clad check --tier=pre-push --strict\` to re-verify and re-attest.`:`${o.id}'s modules changed since the last attested verification \u2014 shipped code is running ahead of its verification. Run \`clad check --tier=pre-push --strict\` to re-verify and re-attest.`})}return i}var Hv,Gv,VP=y(()=>{"use strict";vl();wt();Hv="STALE_ATTESTATION";Gv={name:Hv,run:yOe}});function bOe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}return vOe(r)}function vOe(t){let e=new Set(t.features.map(d=>d.id)),r=new Map;for(let d of t.features)r.set(d.id,(d.depends_on??[]).filter(f=>e.has(f)));let n=0,i=1,o=2,s=new Map;for(let d of r.keys())s.set(d,n);let a=[],c=new Set,l=[];function u(d){s.set(d,i),l.push(d);for(let f of r.get(d)??[]){let p=s.get(f);if(p===i){let m=l.indexOf(f),h=l.slice(m).concat(f),g=[...h].sort().join(",");c.has(g)||(c.add(g),a.push({detector:j8,severity:"error",path:"spec.yaml",message:`circular depends_on cycle: ${h.join(" \u2192 ")} \u2014 these features can never all become ready, so the drive loop deadlocks. Break the cycle by removing one edge.`}))}else p===n&&u(f)}l.pop(),s.set(d,o)}for(let d of r.keys())s.get(d)===n&&u(d);return a}var j8,Zv,WP=y(()=>{"use strict";Ue();j8="DEPENDENCY_CYCLE";Zv={name:j8,run:bOe}});import{appendFileSync as SOe,existsSync as M8,mkdirSync as wOe,readFileSync as xOe}from"node:fs";import{dirname as $Oe,join as kOe}from"node:path";function F8(t){return kOe(t,EOe,AOe)}function L8(t){return KP.add(t),()=>KP.delete(t)}function Za(t,e){let r=F8(t),n=$Oe(r);M8(n)||wOe(n,{recursive:!0}),SOe(r,`${JSON.stringify(e)} -`,"utf8");for(let i of KP)try{i(t,e)}catch{}}function In(t){let e=F8(t);if(!M8(e))return[];let r=xOe(e,"utf8").trim();return r.length===0?[]:r.split(` -`).filter(n=>n.length>0).map(n=>JSON.parse(n))}var EOe,AOe,KP,ni=y(()=>{"use strict";EOe=".cladding",AOe="audit.log.jsonl";KP=new Set});import{existsSync as TOe}from"node:fs";import{join as OOe}from"node:path";function ROe(t){let{cwd:e="."}=t,r=In(e);if(r.length===0)return[{detector:JP,severity:"info",message:"no audit log present \u2014 detector is opt-in on prior stage_4 runs"}];let n=[];for(let i of r)i.artifact&&(TOe(OOe(e,i.artifact))||n.push({detector:JP,severity:"error",path:i.artifact,message:`evidence ${i.id} references missing artifact '${i.artifact}'`}));return n}var JP,z8,U8=y(()=>{"use strict";ni();JP="EVIDENCE_MISMATCH";z8={name:JP,run:ROe}});import{existsSync as IOe,readFileSync as POe}from"node:fs";import{join as COe}from"node:path";function DOe(t){let e=COe(t,G8);if(!IOe(e))return null;try{let n=((0,H8.parse)(POe(e,"utf8"))?.fixtures??[]).map(i=>i.name).filter(Boolean);return new Set(n)}catch{return null}}function*B8(t,e){for(let r of t??[])r.startsWith(q8)&&(yield{ref:r,name:r.slice(q8.length),field:e})}function NOe(t){let{cwd:e="."}=t,r=DOe(e);if(r===null)return[];let n;try{n=q(e)}catch(o){return[{detector:YP,severity:"info",message:`spec.yaml not loaded: ${o.message}`}]}let i=[];for(let o of n.features)for(let s of o.acceptance_criteria??[]){let a=[...B8(s.evidence_refs,"evidence_refs"),...B8(s.test_refs,"test_refs")];for(let{ref:c,name:l,field:u}of a)r.has(l)||i.push({detector:YP,severity:"warn",path:G8,message:`${o.id}.${s.id} cites '${c}' in ${u} but no fixture named '${l}' is registered in conformance/fixtures.yaml`})}return i}var H8,YP,q8,G8,Z8,V8=y(()=>{"use strict";H8=St(er(),1);Ue();YP="FIXTURE_REFERENCE_INVALID",q8="fixture:",G8="conformance/fixtures.yaml";Z8={name:YP,run:NOe}});import{existsSync as Zl,readFileSync as XP}from"node:fs";import{join as Va}from"node:path";function jOe(t){return ys(["src/stages/detectors/*.ts"],{cwd:t,dot:!1}).filter(r=>!/[/\\](index|with-spec|spec-first-window)\.ts$/.test(r)).length}function xp(t){if(!Zl(t))return null;try{return JSON.parse(XP(t,"utf8"))}catch{return null}}function MOe(t,e){let r=Va(t,"plugins","claude-code",".claude-plugin","plugin.json"),n;try{n=JSON.parse(XP(r,"utf8"))}catch(c){e.push({detector:ko,severity:"info",message:`plugin.json not loaded: ${c.message}`});return}let i=n.ironclad?.current?.detectors;if(!i)return;let o=i.match(/^(\d+)\/(\d+)$/);if(!o){e.push({detector:ko,severity:"warn",message:`plugin.json current.detectors='${i}' is not in 'N/M' form`});return}let s=Number(o[1]),a=jOe(t);s!==a&&e.push({detector:ko,severity:"error",message:`plugin.json current.detectors='${i}' but stages/detectors/contains ${a} non-index .ts file(s)`})}function FOe(t,e){for(let r of W8){let n=Va(t,r.path);if(!Zl(n))continue;let i=xp(n);if(!i){e.push({detector:ko,severity:"warn",message:`${r.host}: ${r.path} could not be parsed as JSON`});continue}for(let o of r.required)(i[o]===void 0||i[o]===null||i[o]==="")&&e.push({detector:ko,severity:"error",message:`${r.host}: ${r.path} is missing required field '${String(o)}'`})}}function LOe(t,e){let r=xp(Va(t,"package.json"));if(!r?.version)return;let n=r.version;for(let o of W8){let s=Va(t,o.path);if(!Zl(s))continue;let a=xp(s);a?.version&&a.version!==n&&e.push({detector:ko,severity:"error",message:`${o.host}: ${o.path} version='${a.version}' but package.json version='${n}' \u2014 bump them in lockstep`})}let i=Va(t,".claude-plugin","marketplace.json");if(Zl(i)){let o=xp(i);for(let s of o?.plugins??[])s?.version&&s.version!==n&&e.push({detector:ko,severity:"error",message:`marketplace: .claude-plugin/marketplace.json plugin '${s.name??"?"}' version='${s.version}' but package.json version='${n}' \u2014 the catalog advertises a stale version; bump it in lockstep`})}}function zOe(t){let e=t.match(/TIER_STAGES[\s\S]*?\ball:\s*\[([^\]]*)\]/);return e?[...e[1].matchAll(/['"]([^'"]+)['"]/g)].map(r=>r[1]):[]}function UOe(t,e){let r=Va(t,"src","cli","clad.ts"),n=Va(t,"plugins","claude-code",".claude-plugin","plugin.json");if(!Zl(r)||!Zl(n))return;let i=zOe(XP(r,"utf8"));if(i.length===0)return;let s=xp(n)?.ironclad?.current?.["stages-implemented"];if(!Array.isArray(s))return;let a=new Set(i),c=new Set(s),l=i.filter(f=>!c.has(f)),u=s.filter(f=>!a.has(f));if(l.length===0&&u.length===0)return;let d=[l.length?`missing [${l.join(", ")}]`:"",u.length?`unexpected [${u.join(", ")}]`:""].filter(Boolean).join("; ");e.push({detector:ko,severity:"error",message:`plugins/claude-code/.claude-plugin/plugin.json stages-implemented disagrees with TIER_STAGES.all (src/cli/clad.ts): ${d} \u2014 run \`npm run build:plugin\` to re-derive`})}function qOe(t){let{cwd:e="."}=t,r=[];return MOe(e,r),UOe(e,r),FOe(e,r),LOe(e,r),r}var ko,W8,K8,J8=y(()=>{"use strict";vp();ko="HARNESS_INTEGRITY",W8=[{host:"claude-code",path:"plugins/claude-code/.claude-plugin/plugin.json",required:["name","version"]},{host:"codex",path:"plugins/codex/.codex-plugin/plugin.json",required:["name","version","description"]},{host:"gemini-cli",path:"plugins/gemini-cli/gemini-extension.json",required:["name","version"]}];K8={name:ko,run:qOe}});import{existsSync as BOe,readFileSync as HOe}from"node:fs";import{join as GOe}from"node:path";function VOe(t){let{cwd:e="."}=t;return ge(e,Vv,r=>KOe(r,e))}function WOe(t){let e=GOe(t,"spec/capabilities.yaml");if(!BOe(e))return!1;try{let r=Y8.default.parse(HOe(e,"utf8"));if(!r||typeof r!="object")return!1;let n=r.capabilities;return!Array.isArray(n)||n.length===0}catch{return!1}}function KOe(t,e){let r=t.features.length;if(r{"use strict";Y8=St(er(),1);wt();Vv="HOLLOW_GOVERNANCE",ZOe=8;X8={name:Vv,run:VOe}});import{existsSync as e5,readFileSync as t5}from"node:fs";import{join as r5}from"node:path";function n5(t,e){let r=t.match(e);if(!r)return null;try{let n=JSON.parse(r[1]),i={};for(let[o,s]of Object.entries(n))typeof s=="string"&&(i[o]=s);return i}catch{return null}}function XOe(t){switch(t){case"fail":case"wiring-fail":return 0;case"wiring-ok":case"wiring-only":return 1;case"verified":return 2;default:return null}}function QOe(t){switch(t){case"wiring-only":return 1;case"verified":return 2;default:return null}}function eRe(t){let e=r5(t,"README.md"),r=r5(t,"docs","dogfood","matrix.md");if(!e5(e)||!e5(r))return[];let n=n5(t5(e,"utf8"),JOe),i=n5(t5(r,"utf8"),YOe);if(!n||!i)return[];let o=[];for(let[s,a]of Object.entries(n)){let c=QOe(a);if(c===null)continue;let l=i[s]??"not-run",u=XOe(l);u!==null&&c>u&&o.push({detector:i5,severity:"warn",path:"README.md",message:`README host-claims: '${s}' claims '${a}' but the newest matrix evidence is '${l}' \u2014 the claim exceeds the evidence. Re-run \`clad doctor --hosts\` (with consent) or lower the README claim for '${s}'.`})}return o}function tRe(t){let{cwd:e="."}=t;return eRe(e)}var i5,JOe,YOe,o5,s5=y(()=>{"use strict";i5="HOST_CLAIM_DRIFT",JOe=//,YOe=//;o5={name:i5,run:tRe}});function rRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];return a5(r.features.map(i=>i.id),"feature","spec/features/",n),a5((r.scenarios??[]).map(i=>i.id),"scenario","spec/scenarios/",n),n}function a5(t,e,r,n){let i=new Map;for(let o of t)i.set(o,(i.get(o)??0)+1);for(let[o,s]of i)s>1&&n.push({detector:c5,severity:"error",message:`${e} id '${o}' appears ${s} times across ${r} \u2014 every ${e} must have a unique id; resolve the duplicate`})}var c5,l5,u5=y(()=>{"use strict";Ue();c5="ID_COLLISION";l5={name:c5,run:rRe}});import{existsSync as $p,readFileSync as QP,readdirSync as eC,statSync as nRe,writeFileSync as f5}from"node:fs";import{join as Eo}from"node:path";function d5(t){if(!$p(t))return 0;try{return eC(t).filter(e=>e.endsWith(".yaml")||e.endsWith(".yml")).length}catch{return 0}}function iRe(t){if(!$p(t))return 0;let e=0,r=[t];for(;r.length>0;){let n=r.pop(),i;try{i=eC(n)}catch{continue}for(let o of i){if(o==="node_modules"||o===".cladding"||o.startsWith("."))continue;let s=Eo(n,o),a;try{a=nRe(s)}catch{continue}a.isDirectory()?r.push(s):(o.endsWith(".test.ts")||o.endsWith(".test.tsx"))&&e++}}return e}function oRe(t){let e=Eo(t,"spec","capabilities.yaml");if(!$p(e))return 0;try{let r=Wv.default.parse(QP(e,"utf8"));return Array.isArray(r?.capabilities)?r.capabilities.length:0}catch{return 0}}function _s(t="."){let e=d5(Eo(t,"spec","features")),r=d5(Eo(t,"spec","scenarios")),n=oRe(t),i=iRe(Eo(t,"tests"));return{features:e,scenarios:r,capabilities:n,test_files:i}}function Vl(t,e){let r=Eo(t,"spec.yaml");if(!$p(r))return;let n=QP(r,"utf8"),i=sRe(n,e);i!==n&&f5(r,i)}function sRe(t,e){let r=t.includes(`\r + if (condition) { yield value; }`)}});import{Buffer as Hxe}from"node:buffer";import{StringDecoder as Gxe}from"node:string_decoder";var tv,Zxe,Vxe,Wxe,_I=y(()=>{on();tv=(t,e,r)=>{if(r)return;if(t)return{transform:Zxe.bind(void 0,new TextEncoder)};let n=new Gxe(e);return{transform:Vxe.bind(void 0,n),final:Wxe.bind(void 0,n)}},Zxe=function*(t,e){Hxe.isBuffer(e)?yield _o(e):typeof e=="string"?yield t.encode(e):yield e},Vxe=function*(t,e){yield qt(e)?t.write(e):e},Wxe=function*(t){let e=t.end();e!==""&&(yield e)}});import{callbackify as QW}from"node:util";var bI,rv,e3,Kxe,t3,Jxe,r3=y(()=>{bI=QW(async(t,e,r,n)=>{e.currentIterable=t(...r);try{for await(let i of e.currentIterable)n.push(i)}finally{delete e.currentIterable}}),rv=async function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Jxe}=e[r];for await(let i of n(t))yield*rv(i,e,r+1)},e3=async function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Kxe(r,Number(e),t)},Kxe=async function*(t,e,r){if(t!==void 0)for await(let n of t())yield*rv(n,r,e+1)},t3=QW(async({currentIterable:t},e)=>{if(t!==void 0){await(e?t.throw(e):t.return());return}if(e)throw e}),Jxe=function*(t){yield t}});var vI,n3,Ma,sp,Yxe,Xxe,SI=y(()=>{vI=(t,e,r,n)=>{try{for(let i of t(...e))r.push(i);n()}catch(i){n(i)}},n3=(t,e)=>[...e.flatMap(r=>[...Ma(r,t,0)]),...sp(t)],Ma=function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Xxe}=e[r];for(let i of n(t))yield*Ma(i,e,r+1)},sp=function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Yxe(r,Number(e),t)},Yxe=function*(t,e,r){if(t!==void 0)for(let n of t())yield*Ma(n,r,e+1)},Xxe=function*(t){yield t}});import{Transform as Qxe,getDefaultHighWaterMark as i3}from"node:stream";var wI,nv,o3,iv=y(()=>{wr();ev();XW();_I();r3();SI();wI=({value:t,value:{transform:e,final:r,writableObjectMode:n,readableObjectMode:i},optionName:o},{encoding:s})=>{let a={},c=o3(t,s,o),l=ja(e),u=ja(r),d=l?bI.bind(void 0,rv,a):vI.bind(void 0,Ma),f=l||u?bI.bind(void 0,e3,a):vI.bind(void 0,sp),p=l||u?t3.bind(void 0,a):void 0;return{stream:new Qxe({writableObjectMode:n,writableHighWaterMark:i3(n),readableObjectMode:i,readableHighWaterMark:i3(i),transform(h,g,b){d([h,c,0],this,b)},flush(h){f([c],this,h)},destroy:p})}},nv=(t,e,r,n)=>{let i=e.filter(({type:s})=>s==="generator"),o=n?i.reverse():i;for(let{value:s,optionName:a}of o){let c=o3(s,r,a);t=n3(c,t)}return t},o3=({transform:t,final:e,binary:r,writableObjectMode:n,readableObjectMode:i,preserveNewlines:o},s,a)=>{let c={};return[{transform:KW(n,a)},tv(r,s,n),Qb(r,o,n,c),{transform:t,final:e},{transform:JW(i,a)},WW({binary:r,preserveNewlines:o,readableObjectMode:i,state:c})].filter(Boolean)}});var s3,e0e,t0e,r0e,n0e,a3=y(()=>{iv();on();wr();s3=(t,e)=>{for(let r of e0e(t))t0e(t,r,e)},e0e=t=>new Set(Object.entries(t).filter(([,{direction:e}])=>e==="input").map(([e])=>Number(e))),t0e=(t,e,r)=>{let{stdioItems:n}=t[e],i=n.filter(({contents:a})=>a!==void 0);if(i.length===0)return;if(e!==0){let[{type:a,optionName:c}]=i;throw new TypeError(`Only the \`stdin\` option, not \`${c}\`, can be ${ps[a]} with synchronous methods.`)}let s=i.map(({contents:a})=>a).map(a=>r0e(a,n));r.input=Hf(s)},r0e=(t,e)=>{let r=nv(t,e,"utf8",!0);return n0e(r),Hf(r)},n0e=t=>{let e=t.find(r=>typeof r!="string"&&!qt(r));if(e!==void 0)throw new TypeError(`The \`stdin\` option is invalid: when passing objects as input, a transform must be used to serialize them to strings or Uint8Arrays: ${e}.`)}});var ov,i0e,o0e,c3,l3,s0e,u3,xI=y(()=>{Pa();wr();El();ls();ov=({stdioItems:t,encoding:e,verboseInfo:r,fdNumber:n})=>n!=="all"&&kl(r,n)&&!sn.has(e)&&i0e(n)&&(t.some(({type:i,value:o})=>i==="native"&&o0e.has(o))||t.every(({type:i})=>In.has(i))),i0e=t=>t===1||t===2,o0e=new Set(["pipe","overlapped"]),c3=async(t,e,r,n)=>{for await(let i of t)s0e(e)||u3(i,r,n)},l3=(t,e,r)=>{for(let n of t)u3(n,e,r)},s0e=t=>t._readableState.pipes.length>0,u3=(t,e,r)=>{let n=ib(t);Pi({type:"output",verboseMessage:n,fdNumber:e,verboseInfo:r})}});import{writeFileSync as a0e,appendFileSync as c0e}from"node:fs";var d3,l0e,u0e,d0e,f0e,p0e,f3=y(()=>{xI();iv();ev();on();wr();Na();d3=({fileDescriptors:t,syncResult:{output:e},options:r,isMaxBuffer:n,verboseInfo:i})=>{if(e===null)return{output:Array.from({length:3})};let o={},s=new Set([]);return{output:e.map((c,l)=>l0e({result:c,fileDescriptors:t,fdNumber:l,state:o,outputFiles:s,isMaxBuffer:n,verboseInfo:i},r)),...o}},l0e=({result:t,fileDescriptors:e,fdNumber:r,state:n,outputFiles:i,isMaxBuffer:o,verboseInfo:s},{buffer:a,encoding:c,lines:l,stripFinalNewline:u,maxBuffer:d})=>{if(t===null)return;let f=JV(t,o,d),p=_o(f),{stdioItems:m,objectMode:h}=e[r],g=u0e([p],m,c,n),{serializedResult:b,finalResult:_=b}=d0e({chunks:g,objectMode:h,encoding:c,lines:l,stripFinalNewline:u,fdNumber:r});f0e({serializedResult:b,fdNumber:r,state:n,verboseInfo:s,encoding:c,stdioItems:m,objectMode:h});let S=a[r]?_:void 0;try{return n.error===void 0&&p0e(b,m,i),S}catch(x){return n.error=x,S}},u0e=(t,e,r,n)=>{try{return nv(t,e,r,!1)}catch(i){return n.error=i,t}},d0e=({chunks:t,objectMode:e,encoding:r,lines:n,stripFinalNewline:i,fdNumber:o})=>{if(e)return{serializedResult:t};if(r==="buffer")return{serializedResult:Hf(t)};let s=zG(t,r);return n[o]?{serializedResult:s,finalResult:yI(s,!i[o],e)}:{serializedResult:s}},f0e=({serializedResult:t,fdNumber:e,state:r,verboseInfo:n,encoding:i,stdioItems:o,objectMode:s})=>{if(!ov({stdioItems:o,encoding:i,verboseInfo:n,fdNumber:e}))return;let a=yI(t,!1,s);try{l3(a,e,n)}catch(c){r.error??=c}},p0e=(t,e,r)=>{for(let{path:n,append:i}of e.filter(({type:o})=>Jb.has(o))){let o=typeof n=="string"?n:n.toString();i||r.has(o)?c0e(n,t):(r.add(o),a0e(n,t))}}});var p3,m3=y(()=>{on();op();p3=([,t,e],r)=>{if(r.all)return t===void 0?e:e===void 0?t:Array.isArray(t)?Array.isArray(e)?[...t,...e]:[...t,xo(e,r,"all")]:Array.isArray(e)?[xo(t,r,"all"),...e]:qt(t)&&qt(e)?fR([t,e]):`${t}${e}`}});import{once as $I}from"node:events";var h3,m0e,g3,y3,h0e,kI,EI=y(()=>{Ra();h3=async(t,e)=>{let[r,n]=await m0e(t);return e.isForcefullyTerminated??=!1,[r,n]},m0e=async t=>{let[e,r]=await Promise.allSettled([$I(t,"spawn"),$I(t,"exit")]);return e.status==="rejected"?[]:r.status==="rejected"?g3(t):r.value},g3=async t=>{try{return await $I(t,"exit")}catch{return g3(t)}},y3=async t=>{let[e,r]=await t;if(!h0e(e,r)&&kI(e,r))throw new ti;return[e,r]},h0e=(t,e)=>t===void 0&&e===void 0,kI=(t,e)=>t!==0||e!==null});var _3,g0e,b3=y(()=>{Ra();Na();EI();_3=({error:t,status:e,signal:r,output:n},{maxBuffer:i})=>{let o=g0e(t,e,r),s=o?.code==="ETIMEDOUT",a=KV(o,n,i);return{resultError:o,exitCode:e,signal:r,timedOut:s,isMaxBuffer:a}},g0e=(t,e,r)=>t!==void 0?t:kI(e,r)?new ti:void 0});import{spawnSync as y0e}from"node:child_process";var v3,_0e,b0e,v0e,sv,S0e,w0e,x0e,$0e,S3=y(()=>{SR();KR();JR();ip();Vb();GW();op();a3();f3();Na();m3();b3();v3=(t,e,r)=>{let{file:n,commandArguments:i,command:o,escapedCommand:s,startTime:a,verboseInfo:c,options:l,fileDescriptors:u}=_0e(t,e,r),d=S0e({file:n,commandArguments:i,options:l,command:o,escapedCommand:s,verboseInfo:c,fileDescriptors:u,startTime:a});return Ml(d,c,l)},_0e=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ab(t,e,r),a=b0e(r),{file:c,commandArguments:l,options:u}=Db(t,e,a);v0e(u);let d=BW(u,s);return{file:c,commandArguments:l,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},b0e=t=>t.node&&!t.ipc?{...t,ipc:!1}:t,v0e=({ipc:t,ipcInput:e,detached:r,cancelSignal:n})=>{e&&sv("ipcInput"),t&&sv("ipc: true"),r&&sv("detached: true"),n&&sv("cancelSignal")},sv=t=>{throw new TypeError(`The "${t}" option cannot be used with synchronous methods.`)},S0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,verboseInfo:o,fileDescriptors:s,startTime:a})=>{let c=w0e({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:s,startTime:a});if(c.failed)return c;let{resultError:l,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p}=_3(c,r),{output:m,error:h=l}=d3({fileDescriptors:s,syncResult:c,options:r,isMaxBuffer:p,verboseInfo:o}),g=m.map((_,S)=>xo(_,r,S)),b=xo(p3(m,r),r,"all");return $0e({error:h,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p,stdio:g,all:b,options:r,command:n,escapedCommand:i,startTime:a})},w0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:o,startTime:s})=>{try{s3(o,r);let a=x0e(r);return y0e(...Nb(t,e,a))}catch(a){return jl({error:a,command:n,escapedCommand:i,fileDescriptors:o,options:r,startTime:s,isSync:!0})}},x0e=({encoding:t,maxBuffer:e,...r})=>({...r,encoding:"buffer",maxBuffer:Gb(e)}),$0e=({error:t,exitCode:e,signal:r,timedOut:n,isMaxBuffer:i,stdio:o,all:s,options:a,command:c,escapedCommand:l,startTime:u})=>t===void 0?Zb({command:c,escapedCommand:l,stdio:o,all:s,ipcOutput:[],options:a,startTime:u}):np({error:t,command:c,escapedCommand:l,timedOut:n,isCanceled:!1,isGracefullyCanceled:!1,isMaxBuffer:i,isForcefullyTerminated:!1,exitCode:e,signal:r,stdio:o,all:s,ipcOutput:[],options:a,startTime:u,isSync:!0})});import{once as AI,on as k0e}from"node:events";var w3,E0e,A0e,T0e,O0e,x3=y(()=>{Il();Xf();Yf();w3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0,filter:o}={})=>(Ol({methodName:"getOneMessage",isSubprocess:r,ipc:n,isConnected:Ab(t)}),E0e({anyProcess:t,channel:e,isSubprocess:r,filter:o,reference:i})),E0e=async({anyProcess:t,channel:e,isSubprocess:r,filter:n,reference:i})=>{vb(e,i);let o=fs(t,e,r),s=new AbortController;try{return await Promise.race([A0e(o,n,s),T0e(o,r,s),O0e(o,r,s)])}catch(a){throw Rl(t),a}finally{s.abort(),Sb(e,i)}},A0e=async(t,e,{signal:r})=>{if(e===void 0){let[n]=await AI(t,"message",{signal:r});return n}for await(let[n]of k0e(t,"message",{signal:r}))if(e(n))return n},T0e=async(t,e,{signal:r})=>{await AI(t,"disconnect",{signal:r}),D9(e)},O0e=async(t,e,{signal:r})=>{let[n]=await AI(t,"strict:error",{signal:r});throw gb(n,e)}});import{once as k3,on as R0e}from"node:events";var E3,TI,I0e,P0e,C0e,$3,OI=y(()=>{Il();Xf();Yf();E3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0}={})=>TI({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:!r,reference:i}),TI=({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:i,reference:o})=>{Ol({methodName:"getEachMessage",isSubprocess:r,ipc:n,isConnected:Ab(t)}),vb(e,o);let s=fs(t,e,r),a=new AbortController,c={};return I0e(t,s,a),P0e({ipcEmitter:s,isSubprocess:r,controller:a,state:c}),C0e({anyProcess:t,channel:e,ipcEmitter:s,isSubprocess:r,shouldAwait:i,controller:a,state:c,reference:o})},I0e=async(t,e,r)=>{try{await k3(e,"disconnect",{signal:r.signal}),r.abort()}catch{}},P0e=async({ipcEmitter:t,isSubprocess:e,controller:r,state:n})=>{try{let[i]=await k3(t,"strict:error",{signal:r.signal});n.error=gb(i,e),r.abort()}catch{}},C0e=async function*({anyProcess:t,channel:e,ipcEmitter:r,isSubprocess:n,shouldAwait:i,controller:o,state:s,reference:a}){try{for await(let[c]of R0e(r,"message",{signal:o.signal}))$3(s),yield c}catch{$3(s)}finally{o.abort(),Sb(e,a),n||Rl(t),i&&await t}},$3=({error:t})=>{if(t)throw t}});import A3 from"node:process";var T3,O3,R3,RI=y(()=>{Pb();x3();OI();kb();T3=(t,{ipc:e})=>{Object.assign(t,R3(t,!1,e))},O3=()=>{let t=A3,e=!0,r=A3.channel!==void 0;return{...R3(t,e,r),getCancelSignal:cV.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})}},R3=(t,e,r)=>({sendMessage:Ib.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getOneMessage:w3.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getEachMessage:E3.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})})});import{ChildProcess as D0e}from"node:child_process";import{PassThrough as N0e,Readable as j0e,Writable as M0e,Duplex as F0e}from"node:stream";var I3,L0e,ap,z0e,U0e,q0e,B0e,P3=y(()=>{Xb();ip();Vb();I3=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,verboseInfo:s})=>{mI(n);let a=new D0e;L0e(a,n),Object.assign(a,{readable:z0e,writable:U0e,duplex:q0e});let c=jl({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:!1}),l=B0e(c,s,i);return{subprocess:a,promise:l}},L0e=(t,e)=>{let r=ap(),n=ap(),i=ap(),o=Array.from({length:e.length-3},ap),s=ap(),a=[r,n,i,...o];Object.assign(t,{stdin:r,stdout:n,stderr:i,all:s,stdio:a})},ap=()=>{let t=new N0e;return t.end(),t},z0e=()=>new j0e({read(){}}),U0e=()=>new M0e({write(){}}),q0e=()=>new F0e({read(){},write(){}}),B0e=async(t,e,r)=>Ml(t,e,r)});import{createReadStream as C3,createWriteStream as D3}from"node:fs";import{Buffer as H0e}from"node:buffer";import{Readable as cp,Writable as G0e,Duplex as Z0e}from"node:stream";var j3,lp,N3,V0e,M3=y(()=>{iv();Xb();wr();j3=(t,e)=>Yb(V0e,t,e,!1),lp=({type:t,optionName:e})=>{throw new TypeError(`The \`${e}\` option cannot be ${ps[t]}.`)},N3={fileNumber:lp,generator:wI,asyncGenerator:wI,nodeStream:({value:t})=>({stream:t}),webTransform({value:{transform:t,writableObjectMode:e,readableObjectMode:r}}){let n=e||r;return{stream:Z0e.fromWeb(t,{objectMode:n})}},duplex:({value:{transform:t}})=>({stream:t}),native(){}},V0e={input:{...N3,fileUrl:({value:t})=>({stream:C3(t)}),filePath:({value:{file:t}})=>({stream:C3(t)}),webStream:({value:t})=>({stream:cp.fromWeb(t)}),iterable:({value:t})=>({stream:cp.from(t)}),asyncIterable:({value:t})=>({stream:cp.from(t)}),string:({value:t})=>({stream:cp.from(t)}),uint8Array:({value:t})=>({stream:cp.from(H0e.from(t))})},output:{...N3,fileUrl:({value:t})=>({stream:D3(t)}),filePath:({value:{file:t,append:e}})=>({stream:D3(t,e?{flags:"a"}:{})}),webStream:({value:t})=>({stream:G0e.fromWeb(t)}),iterable:lp,asyncIterable:lp,string:lp,uint8Array:lp}}});import{on as W0e,once as F3}from"node:events";import{PassThrough as K0e,getDefaultHighWaterMark as J0e}from"node:stream";import{finished as U3}from"node:stream/promises";function Fa(t){if(!Array.isArray(t))throw new TypeError(`Expected an array, got \`${typeof t}\`.`);for(let i of t)PI(i);let e=t.some(({readableObjectMode:i})=>i),r=Y0e(t,e),n=new II({objectMode:e,writableHighWaterMark:r,readableHighWaterMark:r});for(let i of t)n.add(i);return n}var Y0e,II,X0e,Q0e,e$e,PI,t$e,r$e,n$e,i$e,o$e,q3,B3,CI,H3,s$e,av,L3,z3,cv=y(()=>{Y0e=(t,e)=>{if(t.length===0)return J0e(e);let r=t.filter(({readableObjectMode:n})=>n===e).map(({readableHighWaterMark:n})=>n);return Math.max(...r)},II=class extends K0e{#t=new Set([]);#r=new Set([]);#e=new Set([]);#n;#o=Symbol("unpipe");#i=new WeakMap;add(e){if(PI(e),this.#t.has(e))return;this.#t.add(e),this.#n??=X0e(this,this.#t,this.#o);let r=t$e({passThroughStream:this,stream:e,streams:this.#t,ended:this.#r,aborted:this.#e,onFinished:this.#n,unpipeEvent:this.#o});this.#i.set(e,r),e.pipe(this,{end:!1})}async remove(e){if(PI(e),!this.#t.has(e))return!1;let r=this.#i.get(e);return r===void 0?!1:(this.#i.delete(e),e.unpipe(this),await r,!0)}},X0e=async(t,e,r)=>{av(t,L3);let n=new AbortController;try{await Promise.race([Q0e(t,n),e$e(t,e,r,n)])}finally{n.abort(),av(t,-L3)}},Q0e=async(t,{signal:e})=>{try{await U3(t,{signal:e,cleanup:!0})}catch(r){throw q3(t,r),r}},e$e=async(t,e,r,{signal:n})=>{for await(let[i]of W0e(t,"unpipe",{signal:n}))e.has(i)&&i.emit(r)},PI=t=>{if(typeof t?.pipe!="function")throw new TypeError(`Expected a readable stream, got: \`${typeof t}\`.`)},t$e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,onFinished:o,unpipeEvent:s})=>{av(t,z3);let a=new AbortController;try{await Promise.race([r$e(o,e,a),n$e({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:a}),i$e({stream:e,streams:r,ended:n,aborted:i,unpipeEvent:s,controller:a})])}finally{a.abort(),av(t,-z3)}r.size>0&&r.size===n.size+i.size&&(n.size===0&&i.size>0?CI(t):o$e(t))},r$e=async(t,e,{signal:r})=>{try{await t,r.aborted||CI(e)}catch(n){r.aborted||q3(e,n)}},n$e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:{signal:o}})=>{try{await U3(e,{signal:o,cleanup:!0,readable:!0,writable:!1}),r.has(e)&&n.add(e)}catch(s){if(o.aborted||!r.has(e))return;B3(s)?i.add(e):H3(t,s)}},i$e=async({stream:t,streams:e,ended:r,aborted:n,unpipeEvent:i,controller:{signal:o}})=>{if(await F3(t,i,{signal:o}),!t.readable)return F3(o,"abort",{signal:o});e.delete(t),r.delete(t),n.delete(t)},o$e=t=>{t.writable&&t.end()},q3=(t,e)=>{B3(e)?CI(t):H3(t,e)},B3=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",CI=t=>{(t.readable||t.writable)&&t.destroy()},H3=(t,e)=>{t.destroyed||(t.once("error",s$e),t.destroy(e))},s$e=()=>{},av=(t,e)=>{let r=t.getMaxListeners();r!==0&&r!==Number.POSITIVE_INFINITY&&t.setMaxListeners(r+e)},L3=2,z3=1});import{finished as G3}from"node:stream/promises";var Ll,a$e,DI,c$e,NI,lv=y(()=>{bo();Ll=(t,e)=>{t.pipe(e),a$e(t,e),c$e(t,e)},a$e=async(t,e)=>{if(!(ei(t)||ei(e))){try{await G3(t,{cleanup:!0,readable:!0,writable:!1})}catch{}DI(e)}},DI=t=>{t.writable&&t.end()},c$e=async(t,e)=>{if(!(ei(t)||ei(e))){try{await G3(e,{cleanup:!0,readable:!1,writable:!0})}catch{}NI(t)}},NI=t=>{t.readable&&t.destroy()}});var Z3,l$e,u$e,d$e,f$e,p$e,V3=y(()=>{cv();bo();bb();wr();lv();Z3=(t,e,r)=>{let n=new Map;for(let[i,{stdioItems:o,direction:s}]of Object.entries(e)){for(let{stream:a}of o.filter(({type:c})=>In.has(c)))l$e(t,a,s,i);for(let{stream:a}of o.filter(({type:c})=>!In.has(c)))d$e({subprocess:t,stream:a,direction:s,fdNumber:i,pipeGroups:n,controller:r})}for(let[i,o]of n.entries()){let s=o.length===1?o[0]:Fa(o);Ll(s,i)}},l$e=(t,e,r,n)=>{r==="output"?Ll(t.stdio[n],e):Ll(e,t.stdio[n]);let i=u$e[n];i!==void 0&&(t[i]=e),t.stdio[n]=e},u$e=["stdin","stdout","stderr"],d$e=({subprocess:t,stream:e,direction:r,fdNumber:n,pipeGroups:i,controller:o})=>{if(e===void 0)return;f$e(e,o);let[s,a]=r==="output"?[e,t.stdio[n]]:[t.stdio[n],e],c=i.get(s)??[];i.set(s,[...c,a])},f$e=(t,{signal:e})=>{ei(t)&&Ia(t,p$e,e)},p$e=2});var La,W3=y(()=>{La=[];La.push("SIGHUP","SIGINT","SIGTERM");process.platform!=="win32"&&La.push("SIGALRM","SIGABRT","SIGVTALRM","SIGXCPU","SIGXFSZ","SIGUSR2","SIGTRAP","SIGSYS","SIGQUIT","SIGIOT");process.platform==="linux"&&La.push("SIGIO","SIGPOLL","SIGPWR","SIGSTKFLT")});var uv,jI,MI,m$e,FI,dv,h$e,LI,zI,UI,K3,oat,sat,J3=y(()=>{W3();uv=t=>!!t&&typeof t=="object"&&typeof t.removeListener=="function"&&typeof t.emit=="function"&&typeof t.reallyExit=="function"&&typeof t.listeners=="function"&&typeof t.kill=="function"&&typeof t.pid=="number"&&typeof t.on=="function",jI=Symbol.for("signal-exit emitter"),MI=globalThis,m$e=Object.defineProperty.bind(Object),FI=class{emitted={afterExit:!1,exit:!1};listeners={afterExit:[],exit:[]};count=0;id=Math.random();constructor(){if(MI[jI])return MI[jI];m$e(MI,jI,{value:this,writable:!1,enumerable:!1,configurable:!1})}on(e,r){this.listeners[e].push(r)}removeListener(e,r){let n=this.listeners[e],i=n.indexOf(r);i!==-1&&(i===0&&n.length===1?n.length=0:n.splice(i,1))}emit(e,r,n){if(this.emitted[e])return!1;this.emitted[e]=!0;let i=!1;for(let o of this.listeners[e])i=o(r,n)===!0||i;return e==="exit"&&(i=this.emit("afterExit",r,n)||i),i}},dv=class{},h$e=t=>({onExit(e,r){return t.onExit(e,r)},load(){return t.load()},unload(){return t.unload()}}),LI=class extends dv{onExit(){return()=>{}}load(){}unload(){}},zI=class extends dv{#t=UI.platform==="win32"?"SIGINT":"SIGHUP";#r=new FI;#e;#n;#o;#i={};#s=!1;constructor(e){super(),this.#e=e,this.#i={};for(let r of La)this.#i[r]=()=>{let n=this.#e.listeners(r),{count:i}=this.#r,o=e;if(typeof o.__signal_exit_emitter__=="object"&&typeof o.__signal_exit_emitter__.count=="number"&&(i+=o.__signal_exit_emitter__.count),n.length===i){this.unload();let s=this.#r.emit("exit",null,r),a=r==="SIGHUP"?this.#t:r;s||e.kill(e.pid,a)}};this.#o=e.reallyExit,this.#n=e.emit}onExit(e,r){if(!uv(this.#e))return()=>{};this.#s===!1&&this.load();let n=r?.alwaysLast?"afterExit":"exit";return this.#r.on(n,e),()=>{this.#r.removeListener(n,e),this.#r.listeners.exit.length===0&&this.#r.listeners.afterExit.length===0&&this.unload()}}load(){if(!this.#s){this.#s=!0,this.#r.count+=1;for(let e of La)try{let r=this.#i[e];r&&this.#e.on(e,r)}catch{}this.#e.emit=(e,...r)=>this.#c(e,...r),this.#e.reallyExit=e=>this.#a(e)}}unload(){this.#s&&(this.#s=!1,La.forEach(e=>{let r=this.#i[e];if(!r)throw new Error("Listener not defined for signal: "+e);try{this.#e.removeListener(e,r)}catch{}}),this.#e.emit=this.#n,this.#e.reallyExit=this.#o,this.#r.count-=1)}#a(e){return uv(this.#e)?(this.#e.exitCode=e||0,this.#r.emit("exit",this.#e.exitCode,null),this.#o.call(this.#e,this.#e.exitCode)):0}#c(e,...r){let n=this.#n;if(e==="exit"&&uv(this.#e)){typeof r[0]=="number"&&(this.#e.exitCode=r[0]);let i=n.call(this.#e,e,...r);return this.#r.emit("exit",this.#e.exitCode,null),i}else return n.call(this.#e,e,...r)}},UI=globalThis.process,{onExit:K3,load:oat,unload:sat}=h$e(uv(UI)?new zI(UI):new LI)});import{addAbortListener as g$e}from"node:events";var Y3,X3=y(()=>{J3();Y3=(t,{cleanup:e,detached:r},{signal:n})=>{if(!e||r)return;let i=K3(()=>{t.kill()});g$e(n,()=>{i()})}});var eK,y$e,_$e,Q3,b$e,tK=y(()=>{dR();sb();ds();xl();eK=({source:t,sourcePromise:e,boundOptions:r,createNested:n},...i)=>{let o=ob(),{destination:s,destinationStream:a,destinationError:c,from:l,unpipeSignal:u}=y$e(r,n,i),{sourceStream:d,sourceError:f}=b$e(t,l),{options:p,fileDescriptors:m}=Di.get(t);return{sourcePromise:e,sourceStream:d,sourceOptions:p,sourceError:f,destination:s,destinationStream:a,destinationError:c,unpipeSignal:u,fileDescriptors:m,startTime:o}},y$e=(t,e,r)=>{try{let{destination:n,pipeOptions:{from:i,to:o,unpipeSignal:s}={}}=_$e(t,e,...r),a=_b(n,o);return{destination:n,destinationStream:a,from:i,unpipeSignal:s}}catch(n){return{destinationError:n}}},_$e=(t,e,r,...n)=>{if(Array.isArray(r))return{destination:e(Q3,t)(r,...n),pipeOptions:t};if(typeof r=="string"||r instanceof URL||lR(r)){if(Object.keys(t).length>0)throw new TypeError('Please use .pipe("file", ..., options) or .pipe(execa("file", ..., options)) instead of .pipe(options)("file", ...).');let[i,o,s]=W_(r,...n);return{destination:e(Q3)(i,o,s),pipeOptions:s}}if(Di.has(r)){if(Object.keys(t).length>0)throw new TypeError("Please use .pipe(options)`command` or .pipe($(options)`command`) instead of .pipe(options)($`command`).");return{destination:r,pipeOptions:n[0]}}throw new TypeError(`The first argument must be a template string, an options object, or an Execa subprocess: ${r}`)},Q3=({options:t})=>({options:{...t,stdin:"pipe",piped:!0}}),b$e=(t,e)=>{try{return{sourceStream:Cl(t,e)}}catch(r){return{sourceError:r}}}});var nK,v$e,qI,rK,BI=y(()=>{ip();lv();nK=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n,fileDescriptors:i,sourceOptions:o,startTime:s})=>{let a=v$e({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n});if(a!==void 0)throw qI({error:a,fileDescriptors:i,sourceOptions:o,startTime:s})},v$e=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n})=>{if(e!==void 0&&n!==void 0)return n;if(n!==void 0)return NI(t),n;if(e!==void 0)return DI(r),e},qI=({error:t,fileDescriptors:e,sourceOptions:r,startTime:n})=>jl({error:t,command:rK,escapedCommand:rK,fileDescriptors:e,options:r,startTime:n,isSync:!1}),rK="source.pipe(destination)"});var iK,oK=y(()=>{iK=async t=>{let[{status:e,reason:r,value:n=r},{status:i,reason:o,value:s=o}]=await t;if(s.pipedFrom.includes(n)||s.pipedFrom.push(n),i==="rejected")throw s;if(e==="rejected")throw n;return s}});import{finished as S$e}from"node:stream/promises";var sK,w$e,x$e,$$e,fv,k$e,E$e,aK=y(()=>{cv();bb();lv();sK=(t,e,r)=>{let n=fv.has(e)?x$e(t,e):w$e(t,e);return Ia(t,k$e,r.signal),Ia(e,E$e,r.signal),$$e(e),n},w$e=(t,e)=>{let r=Fa([t]);return Ll(r,e),fv.set(e,r),r},x$e=(t,e)=>{let r=fv.get(e);return r.add(t),r},$$e=async t=>{try{await S$e(t,{cleanup:!0,readable:!1,writable:!0})}catch{}fv.delete(t)},fv=new WeakMap,k$e=2,E$e=1});import{aborted as A$e}from"node:util";var cK,T$e,lK=y(()=>{BI();cK=(t,e)=>t===void 0?[]:[T$e(t,e)],T$e=async(t,{sourceStream:e,mergedStream:r,fileDescriptors:n,sourceOptions:i,startTime:o})=>{await A$e(t,e),await r.remove(e);let s=new Error("Pipe canceled by `unpipeSignal` option.");throw qI({error:s,fileDescriptors:n,sourceOptions:i,startTime:o})}});var pv,O$e,R$e,uK=y(()=>{yo();tK();BI();oK();aK();lK();pv=(t,...e)=>{if(Ot(e[0]))return pv.bind(void 0,{...t,boundOptions:{...t.boundOptions,...e[0]}});let{destination:r,...n}=eK(t,...e),i=O$e({...n,destination:r});return i.pipe=pv.bind(void 0,{...t,source:r,sourcePromise:i,boundOptions:{}}),i},O$e=async({sourcePromise:t,sourceStream:e,sourceOptions:r,sourceError:n,destination:i,destinationStream:o,destinationError:s,unpipeSignal:a,fileDescriptors:c,startTime:l})=>{let u=R$e(t,i);nK({sourceStream:e,sourceError:n,destinationStream:o,destinationError:s,fileDescriptors:c,sourceOptions:r,startTime:l});let d=new AbortController;try{let f=sK(e,o,d);return await Promise.race([iK(u),...cK(a,{sourceStream:e,mergedStream:f,sourceOptions:r,fileDescriptors:c,startTime:l})])}finally{d.abort()}},R$e=(t,e)=>Promise.allSettled([t,e])});import{on as I$e}from"node:events";import{getDefaultHighWaterMark as P$e}from"node:stream";var mv,C$e,HI,D$e,fK,GI,dK,N$e,j$e,hv=y(()=>{_I();ev();SI();mv=({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:n,encoding:i,preserveNewlines:o})=>{let s=new AbortController;return C$e(e,s),fK({stream:t,controller:s,binary:r,shouldEncode:!t.readableObjectMode&&n,encoding:i,shouldSplit:!t.readableObjectMode,preserveNewlines:o})},C$e=async(t,e)=>{try{await t}catch{}finally{e.abort()}},HI=({stream:t,onStreamEnd:e,lines:r,encoding:n,stripFinalNewline:i,allMixed:o})=>{let s=new AbortController;D$e(e,s,t);let a=t.readableObjectMode&&!o;return fK({stream:t,controller:s,binary:n==="buffer",shouldEncode:!a,encoding:n,shouldSplit:!a&&r,preserveNewlines:!i})},D$e=async(t,e,r)=>{try{await t}catch{r.destroy()}finally{e.abort()}},fK=({stream:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})=>{let a=I$e(t,"data",{signal:e.signal,highWaterMark:dK,highWatermark:dK});return N$e({onStdoutChunk:a,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})},GI=P$e(!0),dK=GI,N$e=async function*({onStdoutChunk:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s}){let a=j$e({binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s});try{for await(let[c]of t)yield*Ma(c,a,0)}catch(c){if(!e.signal.aborted)throw c}finally{yield*sp(a)}},j$e=({binary:t,shouldEncode:e,encoding:r,shouldSplit:n,preserveNewlines:i})=>[tv(t,r,!e),Qb(t,i,!n,{})].filter(Boolean)});import{setImmediate as M$e}from"node:timers/promises";var pK,F$e,L$e,z$e,ZI,mK,VI=y(()=>{Hb();on();xI();hv();Na();op();pK=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,buffer:i,maxBuffer:o,lines:s,allMixed:a,stripFinalNewline:c,verboseInfo:l,streamInfo:u})=>{let d=F$e({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:a,verboseInfo:l,streamInfo:u});if(!i){await Promise.all([L$e(t),d]);return}let f=hI(c,r),p=HI({stream:t,onStreamEnd:e,lines:s,encoding:n,stripFinalNewline:f,allMixed:a}),[m]=await Promise.all([z$e({stream:t,iterable:p,fdNumber:r,encoding:n,maxBuffer:o,lines:s}),d]);return m},F$e=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:i,verboseInfo:o,streamInfo:{fileDescriptors:s}})=>{if(!ov({stdioItems:s[r]?.stdioItems,encoding:n,verboseInfo:o,fdNumber:r}))return;let a=HI({stream:t,onStreamEnd:e,lines:!0,encoding:n,stripFinalNewline:!0,allMixed:i});await c3(a,t,r,o)},L$e=async t=>{await M$e(),t.readableFlowing===null&&t.resume()},z$e=async({stream:t,stream:{readableObjectMode:e},iterable:r,fdNumber:n,encoding:i,maxBuffer:o,lines:s})=>{try{return e||s?await zb(r,{maxBuffer:o}):i==="buffer"?new Uint8Array(await Ub(r,{maxBuffer:o})):await Bb(r,{maxBuffer:o})}catch(a){return mK(ZV({error:a,stream:t,readableObjectMode:e,lines:s,encoding:i,fdNumber:n}))}},ZI=async t=>{try{return await t}catch(e){return mK(e)}},mK=({bufferedData:t})=>FG(t)?new Uint8Array(t):t});import{finished as U$e}from"node:stream/promises";var up,q$e,B$e,H$e,G$e,Z$e,WI,gv,hK,yv=y(()=>{up=async(t,e,r,{isSameDirection:n,stopOnExit:i=!1}={})=>{let o=q$e(t,r),s=new AbortController;try{await Promise.race([...i?[r.exitPromise]:[],U$e(t,{cleanup:!0,signal:s.signal})])}catch(a){o.stdinCleanedUp||G$e(a,e,r,n)}finally{s.abort()}},q$e=(t,{originalStreams:[e],subprocess:r})=>{let n={stdinCleanedUp:!1};return t===e&&B$e(t,r,n),n},B$e=(t,e,r)=>{let{_destroy:n}=t;t._destroy=(...i)=>{H$e(e,r),n.call(t,...i)}},H$e=({exitCode:t,signalCode:e},r)=>{(t!==null||e!==null)&&(r.stdinCleanedUp=!0)},G$e=(t,e,r,n)=>{if(!Z$e(t,e,r,n))throw t},Z$e=(t,e,r,n=!0)=>r.propagating?hK(t)||gv(t):(r.propagating=!0,WI(r,e)===n?hK(t):gv(t)),WI=({fileDescriptors:t},e)=>e!=="all"&&t[e].direction==="input",gv=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",hK=t=>t?.code==="EPIPE"});var gK,KI,JI=y(()=>{VI();yv();gK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>t.stdio.map((c,l)=>KI({stream:c,fdNumber:l,encoding:e,buffer:r[l],maxBuffer:n[l],lines:i[l],allMixed:!1,stripFinalNewline:o,verboseInfo:s,streamInfo:a})),KI=async({stream:t,fdNumber:e,encoding:r,buffer:n,maxBuffer:i,lines:o,allMixed:s,stripFinalNewline:a,verboseInfo:c,streamInfo:l})=>{if(!t)return;let u=up(t,e,l);if(WI(l,e)){await u;return}let[d]=await Promise.all([pK({stream:t,onStreamEnd:u,fdNumber:e,encoding:r,buffer:n,maxBuffer:i,lines:o,allMixed:s,stripFinalNewline:a,verboseInfo:c,streamInfo:l}),u]);return d}});var yK,_K,V$e,W$e,YI=y(()=>{cv();JI();yK=({stdout:t,stderr:e},{all:r})=>r&&(t||e)?Fa([t,e].filter(Boolean)):void 0,_K=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>KI({...V$e(t,r),fdNumber:"all",encoding:e,maxBuffer:n[1]+n[2],lines:i[1]||i[2],allMixed:W$e(t),stripFinalNewline:o,verboseInfo:s,streamInfo:a}),V$e=({stdout:t,stderr:e,all:r},[,n,i])=>{let o=n||i;return o?n?i?{stream:r,buffer:o}:{stream:t,buffer:o}:{stream:e,buffer:o}:{stream:r,buffer:o}},W$e=({all:t,stdout:e,stderr:r})=>t&&e&&r&&e.readableObjectMode!==r.readableObjectMode});var bK,vK,SK=y(()=>{El();ls();bK=t=>kl(t,"ipc"),vK=(t,e)=>{let r=ib(t);Pi({type:"ipc",verboseMessage:r,fdNumber:"ipc",verboseInfo:e})}});var wK,xK,$K=y(()=>{Na();SK();So();OI();wK=async({subprocess:t,buffer:e,maxBuffer:r,ipc:n,ipcOutput:i,verboseInfo:o})=>{if(!n)return i;let s=bK(o),a=vo(e,"ipc"),c=vo(r,"ipc");for await(let l of TI({anyProcess:t,channel:t.channel,isSubprocess:!1,ipc:n,shouldAwait:!1,reference:!0}))a&&(VV(t,i,c),i.push(l)),s&&vK(l,o);return i},xK=async(t,e)=>(await Promise.allSettled([t]),e)});import{once as K$e}from"node:events";var kK,J$e,Y$e,X$e,EK=y(()=>{Da();HR();NR();BR();bo();wr();VI();$K();ZR();YI();JI();EI();yv();kK=async({subprocess:t,options:{encoding:e,buffer:r,maxBuffer:n,lines:i,timeoutDuration:o,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,stripFinalNewline:l,ipc:u,ipcInput:d},context:f,verboseInfo:p,fileDescriptors:m,originalStreams:h,onInternalError:g,controller:b})=>{let _=h3(t,f),S={originalStreams:h,fileDescriptors:m,subprocess:t,exitPromise:_,propagating:!1},x=gK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),w=_K({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),O=[],T=wK({subprocess:t,buffer:r,maxBuffer:n,ipc:u,ipcOutput:O,verboseInfo:p}),A=J$e(h,t,S),D=Y$e(m,S);try{return await Promise.race([Promise.all([{},y3(_),Promise.all(x),w,T,_V(t,d),...A,...D]),g,X$e(t,b),...pV(t,o,f,b),...C9({subprocess:t,cancelSignal:s,gracefulCancel:a,context:f,controller:b}),...dV({subprocess:t,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,context:f,controller:b})])}catch($){return f.terminationReason??="other",Promise.all([{error:$},_,Promise.all(x.map(re=>ZI(re))),ZI(w),xK(T,O),Promise.allSettled(A),Promise.allSettled(D)])}},J$e=(t,e,r)=>t.map((n,i)=>n===e.stdio[i]?void 0:up(n,i,r)),Y$e=(t,e)=>t.flatMap(({stdioItems:r},n)=>r.filter(({value:i,stream:o=i})=>ni(o,{checkOpen:!1})&&!ei(o)).map(({type:i,value:o,stream:s=o})=>up(s,n,e,{isSameDirection:In.has(i),stopOnExit:i==="native"}))),X$e=async(t,{signal:e})=>{let[r]=await K$e(t,"error",{signal:e});throw r}});var AK,dp,zl,_v=y(()=>{Pl();AK=()=>({readableDestroy:new WeakMap,writableFinal:new WeakMap,writableDestroy:new WeakMap}),dp=(t,e,r)=>{let n=t[r];n.has(e)||n.set(e,[]);let i=n.get(e),o=Ci();return i.push(o),{resolve:o.resolve.bind(o),promises:i}},zl=async({resolve:t,promises:e},r)=>{t();let[n]=await Promise.race([Promise.allSettled([!0,r]),Promise.all([!1,...e])]);return!n}});import{finished as TK}from"node:stream/promises";var XI,OK,QI,eP,bv,vv,tP=y(()=>{yv();XI=async t=>{if(t!==void 0)try{await QI(t)}catch{}},OK=async t=>{if(t!==void 0)try{await eP(t)}catch{}},QI=async t=>{await TK(t,{cleanup:!0,readable:!1,writable:!0})},eP=async t=>{await TK(t,{cleanup:!0,readable:!0,writable:!1})},bv=async(t,e)=>{if(await t,e)throw e},vv=(t,e,r)=>{r&&!gv(r)?t.destroy(r):e&&t.destroy()}});import{Readable as Q$e}from"node:stream";import{callbackify as eke}from"node:util";var RK,rP,nP,iP,tke,oP,sP,IK,aP=y(()=>{Pa();ds();hv();Pl();_v();tP();RK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,binary:i=!0,preserveNewlines:o=!0}={})=>{let s=i||sn.has(r),{subprocessStdout:a,waitReadableDestroy:c}=rP(t,n,e),{readableEncoding:l,readableObjectMode:u,readableHighWaterMark:d}=nP(a,s),{read:f,onStdoutDataDone:p}=iP({subprocessStdout:a,subprocess:t,binary:s,encoding:r,preserveNewlines:o}),m=new Q$e({read:f,destroy:eke(sP.bind(void 0,{subprocessStdout:a,subprocess:t,waitReadableDestroy:c})),highWaterMark:d,objectMode:u,encoding:l});return oP({subprocessStdout:a,onStdoutDataDone:p,readable:m,subprocess:t}),m},rP=(t,e,r)=>{let n=Cl(t,e),i=dp(r,n,"readableDestroy");return{subprocessStdout:n,waitReadableDestroy:i}},nP=({readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r},n)=>n?{readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r}:{readableEncoding:t,readableObjectMode:!0,readableHighWaterMark:GI},iP=({subprocessStdout:t,subprocess:e,binary:r,encoding:n,preserveNewlines:i})=>{let o=Ci(),s=mv({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:!r,encoding:n,preserveNewlines:i});return{read(){tke(this,s,o)},onStdoutDataDone:o}},tke=async(t,e,r)=>{try{let{value:n,done:i}=await e.next();i?r.resolve():t.push(n)}catch{}},oP=async({subprocessStdout:t,onStdoutDataDone:e,readable:r,subprocess:n,subprocessStdin:i})=>{try{await eP(t),await n,await XI(i),await e,r.readable&&r.push(null)}catch(o){await XI(i),IK(r,o)}},sP=async({subprocessStdout:t,subprocess:e,waitReadableDestroy:r},n)=>{await zl(r,e)&&(IK(t,n),await bv(e,n))},IK=(t,e)=>{vv(t,t.readable,e)}});import{Writable as rke}from"node:stream";import{callbackify as PK}from"node:util";var CK,cP,lP,nke,ike,uP,dP,DK,fP=y(()=>{ds();_v();tP();CK=({subprocess:t,concurrentStreams:e},{to:r}={})=>{let{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}=cP(t,r,e),s=new rke({...lP(n,t,i),destroy:PK(dP.bind(void 0,{subprocessStdin:n,subprocess:t,waitWritableFinal:i,waitWritableDestroy:o})),highWaterMark:n.writableHighWaterMark,objectMode:n.writableObjectMode});return uP(n,s),s},cP=(t,e,r)=>{let n=_b(t,e),i=dp(r,n,"writableFinal"),o=dp(r,n,"writableDestroy");return{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}},lP=(t,e,r)=>({write:nke.bind(void 0,t),final:PK(ike.bind(void 0,t,e,r))}),nke=(t,e,r,n)=>{t.write(e,r)?n():t.once("drain",n)},ike=async(t,e,r)=>{await zl(r,e)&&(t.writable&&t.end(),await e)},uP=async(t,e,r)=>{try{await QI(t),e.writable&&e.end()}catch(n){await OK(r),DK(e,n)}},dP=async({subprocessStdin:t,subprocess:e,waitWritableFinal:r,waitWritableDestroy:n},i)=>{await zl(r,e),await zl(n,e)&&(DK(t,i),await bv(e,i))},DK=(t,e)=>{vv(t,t.writable,e)}});import{Duplex as oke}from"node:stream";import{callbackify as ske}from"node:util";var NK,ake,jK=y(()=>{Pa();aP();fP();NK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,to:i,binary:o=!0,preserveNewlines:s=!0}={})=>{let a=o||sn.has(r),{subprocessStdout:c,waitReadableDestroy:l}=rP(t,n,e),{subprocessStdin:u,waitWritableFinal:d,waitWritableDestroy:f}=cP(t,i,e),{readableEncoding:p,readableObjectMode:m,readableHighWaterMark:h}=nP(c,a),{read:g,onStdoutDataDone:b}=iP({subprocessStdout:c,subprocess:t,binary:a,encoding:r,preserveNewlines:s}),_=new oke({read:g,...lP(u,t,d),destroy:ske(ake.bind(void 0,{subprocessStdout:c,subprocessStdin:u,subprocess:t,waitReadableDestroy:l,waitWritableFinal:d,waitWritableDestroy:f})),readableHighWaterMark:h,writableHighWaterMark:u.writableHighWaterMark,readableObjectMode:m,writableObjectMode:u.writableObjectMode,encoding:p});return oP({subprocessStdout:c,onStdoutDataDone:b,readable:_,subprocess:t,subprocessStdin:u}),uP(u,_,c),_},ake=async({subprocessStdout:t,subprocessStdin:e,subprocess:r,waitReadableDestroy:n,waitWritableFinal:i,waitWritableDestroy:o},s)=>{await Promise.all([sP({subprocessStdout:t,subprocess:r,waitReadableDestroy:n},s),dP({subprocessStdin:e,subprocess:r,waitWritableFinal:i,waitWritableDestroy:o},s)])}});var pP,cke,MK=y(()=>{Pa();ds();hv();pP=(t,e,{from:r,binary:n=!1,preserveNewlines:i=!1}={})=>{let o=n||sn.has(e),s=Cl(t,r),a=mv({subprocessStdout:s,subprocess:t,binary:o,shouldEncode:!0,encoding:e,preserveNewlines:i});return cke(a,s,t)},cke=async function*(t,e,r){try{yield*t}finally{e.readable&&e.destroy(),await r}}});var FK,LK=y(()=>{_v();aP();fP();jK();MK();FK=(t,{encoding:e})=>{let r=AK();t.readable=RK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.writable=CK.bind(void 0,{subprocess:t,concurrentStreams:r}),t.duplex=NK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.iterable=pP.bind(void 0,t,e),t[Symbol.asyncIterator]=pP.bind(void 0,t,e,{})}});var zK,lke,uke,UK=y(()=>{zK=(t,e)=>{for(let[r,n]of uke){let i=n.value.bind(e);Reflect.defineProperty(t,r,{...n,value:i})}},lke=(async()=>{})().constructor.prototype,uke=["then","catch","finally"].map(t=>[t,Reflect.getOwnPropertyDescriptor(lke,t)])});import{setMaxListeners as dke}from"node:events";import{spawn as fke}from"node:child_process";var qK,pke,mke,hke,gke,yke,BK=y(()=>{Hb();SR();KR();ds();JR();RI();ip();Vb();P3();M3();op();V3();mb();X3();uK();YI();EK();LK();Pl();UK();qK=(t,e,r,n)=>{let{file:i,commandArguments:o,command:s,escapedCommand:a,startTime:c,verboseInfo:l,options:u,fileDescriptors:d}=pke(t,e,r),{subprocess:f,promise:p}=hke({file:i,commandArguments:o,options:u,startTime:c,verboseInfo:l,command:s,escapedCommand:a,fileDescriptors:d});return f.pipe=pv.bind(void 0,{source:f,sourcePromise:p,boundOptions:{},createNested:n}),zK(f,p),Di.set(f,{options:u,fileDescriptors:d}),f},pke=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ab(t,e,r),{file:a,commandArguments:c,options:l}=Db(t,e,r),u=mke(l),d=j3(u,s);return{file:a,commandArguments:c,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},mke=({timeout:t,signal:e,...r})=>{if(e!==void 0)throw new TypeError('The "signal" option has been renamed to "cancelSignal" instead.');return{...r,timeoutDuration:t}},hke=({file:t,commandArguments:e,options:r,startTime:n,verboseInfo:i,command:o,escapedCommand:s,fileDescriptors:a})=>{let c;try{c=fke(...Nb(t,e,r))}catch(m){return I3({error:m,command:o,escapedCommand:s,fileDescriptors:a,options:r,startTime:n,verboseInfo:i})}let l=new AbortController;dke(Number.POSITIVE_INFINITY,l.signal);let u=[...c.stdio];Z3(c,a,l),Y3(c,r,l);let d={},f=Ci();c.kill=I9.bind(void 0,{kill:c.kill.bind(c),options:r,onInternalError:f,context:d,controller:l}),c.all=yK(c,r),FK(c,r),T3(c,r);let p=gke({subprocess:c,options:r,startTime:n,verboseInfo:i,fileDescriptors:a,originalStreams:u,command:o,escapedCommand:s,context:d,onInternalError:f,controller:l});return{subprocess:c,promise:p}},gke=async({subprocess:t,options:e,startTime:r,verboseInfo:n,fileDescriptors:i,originalStreams:o,command:s,escapedCommand:a,context:c,onInternalError:l,controller:u})=>{let[d,[f,p],m,h,g]=await kK({subprocess:t,options:e,context:c,verboseInfo:n,fileDescriptors:i,originalStreams:o,onInternalError:l,controller:u});u.abort(),l.resolve();let b=m.map((x,w)=>xo(x,e,w)),_=xo(h,e,"all"),S=yke({errorInfo:d,exitCode:f,signal:p,stdio:b,all:_,ipcOutput:g,context:c,options:e,command:s,escapedCommand:a,startTime:r});return Ml(S,n,e)},yke=({errorInfo:t,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,context:s,options:a,command:c,escapedCommand:l,startTime:u})=>"error"in t?np({error:t.error,command:c,escapedCommand:l,timedOut:s.terminationReason==="timeout",isCanceled:s.terminationReason==="cancel"||s.terminationReason==="gracefulCancel",isGracefullyCanceled:s.terminationReason==="gracefulCancel",isMaxBuffer:t.error instanceof Ni,isForcefullyTerminated:s.isForcefullyTerminated,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,options:a,startTime:u,isSync:!1}):Zb({command:c,escapedCommand:l,stdio:n,all:i,ipcOutput:o,options:a,startTime:u})});var Sv,_ke,bke,HK=y(()=>{yo();So();Sv=(t,e)=>{let r=Object.fromEntries(Object.entries(e).map(([n,i])=>[n,_ke(n,t[n],i)]));return{...t,...r}},_ke=(t,e,r)=>bke.has(t)&&Ot(e)&&Ot(r)?{...e,...r}:r,bke=new Set(["env",...gR])});var ms,vke,Ske,GK=y(()=>{yo();dR();ZG();S3();BK();HK();ms=(t,e,r,n)=>{let i=(s,a,c)=>ms(s,a,r,c),o=(...s)=>vke({mapArguments:t,deepOptions:r,boundOptions:e,setBoundExeca:n,createNested:i},...s);return n!==void 0&&n(o,i,e),o},vke=({mapArguments:t,deepOptions:e={},boundOptions:r={},setBoundExeca:n,createNested:i},o,...s)=>{if(Ot(o))return i(t,Sv(r,o),n);let{file:a,commandArguments:c,options:l,isSync:u}=Ske({mapArguments:t,firstArgument:o,nextArguments:s,deepOptions:e,boundOptions:r});return u?v3(a,c,l):qK(a,c,l,i)},Ske=({mapArguments:t,firstArgument:e,nextArguments:r,deepOptions:n,boundOptions:i})=>{let o=HG(e)?GG(e,r):[e,...r],[s,a,c]=W_(...o),l=Sv(Sv(n,i),c),{file:u=s,commandArguments:d=a,options:f=l,isSync:p=!1}=t({file:s,commandArguments:a,options:l});return{file:u,commandArguments:d,options:f,isSync:p}}});var ZK,VK,WK,wke,xke,KK=y(()=>{ZK=({file:t,commandArguments:e})=>WK(t,e),VK=({file:t,commandArguments:e})=>({...WK(t,e),isSync:!0}),WK=(t,e)=>{if(e.length>0)throw new TypeError(`The command and its arguments must be passed as a single string: ${t} ${e}.`);let[r,...n]=wke(t);return{file:r,commandArguments:n}},wke=t=>{if(typeof t!="string")throw new TypeError(`The command must be a string: ${String(t)}.`);let e=t.trim();if(e==="")return[];let r=[];for(let n of e.split(xke)){let i=r.at(-1);i&&i.endsWith("\\")?r[r.length-1]=`${i.slice(0,-1)} ${n}`:r.push(n)}return r},xke=/ +/g});var JK,YK,$ke,XK,kke,QK,eJ=y(()=>{JK=(t,e,r)=>{t.sync=e($ke,r),t.s=t.sync},YK=({options:t})=>XK(t),$ke=({options:t})=>({...XK(t),isSync:!0}),XK=t=>({options:{...kke(t),...t}}),kke=({input:t,inputFile:e,stdio:r})=>t===void 0&&e===void 0&&r===void 0?{stdin:"inherit"}:{},QK={preferLocal:!0}});var Klt,We,Jlt,Ylt,Xlt,Qlt,eut,tut,rut,nut,Fr=y(()=>{GK();KK();GR();eJ();RI();Klt=ms(()=>({})),We=ms(()=>({isSync:!0})),Jlt=ms(ZK),Ylt=ms(VK),Xlt=ms(hV),Qlt=ms(YK,{},QK,JK),{sendMessage:eut,getOneMessage:tut,getEachMessage:rut,getCancelSignal:nut}=O3()});import{existsSync as wv,statSync as Eke}from"node:fs";import{dirname as mP,extname as Ake,isAbsolute as tJ,join as hP,relative as gP,resolve as xv,sep as Tke}from"node:path";function $v(t){return t==="./gradlew"||t==="gradle"}function Oke(t){return(wv(hP(t,"build.gradle.kts"))||wv(hP(t,"build.gradle")))&&wv(hP(t,"gradle.properties"))}function Rke(t,e){let n=gP(t,e).split(Tke).filter(Boolean);return n.length===0?":":`:${n.join(":")}`}function hs(t,e){return t===":"?`:${e}`:`${t}:${e}`}function Ike(t,e){let r=xv(t,e),n=r;wv(r)?Eke(r).isFile()&&(n=mP(r)):Ake(r)!==""&&(n=mP(r));let i=gP(t,n);if(i.startsWith("..")||tJ(i))return null;let o=n;for(;;){if(Oke(o))return o;if(xv(o)===xv(t))return null;let s=mP(o);if(s===o)return null;let a=gP(t,s);if(a.startsWith("..")||tJ(a))return null;o=s}}function kv(t,e){let r=xv(t),n=new Map,i=[];for(let o of e){let s=Ike(r,o);if(!s){i.push(o);continue}let a=Rke(r,s);n.has(a)||n.set(a,{path:a,dir:s})}if(i.length>0)throw new Error(`cannot map module(s) to a Gradle project (no build.gradle[.kts] + gradle.properties ancestor under ${r}): ${i.join(", ")}`);return[...n.values()].sort((o,s)=>o.paths.path?1:0)}var Ev=y(()=>{"use strict"});import{existsSync as _P,readFileSync as Pke}from"node:fs";import{join as Ul}from"node:path";function ql(t="."){let e=Ul(t,".cladding","config.yaml");if(!_P(e))return yP;try{let n=(0,rJ.parse)(Pke(e,"utf8"))?.gate;if(!n)return yP;let i=n.scope==="repo"?"repo":"feature",o=n.coverage==="kover"||n.coverage==="jacoco"?n.coverage:void 0,s=typeof n.test_report=="string"?n.test_report:void 0,a={};if(n.commands&&typeof n.commands=="object")for(let l of Cke){let u=n.commands[l];Array.isArray(u)&&u.every(d=>typeof d=="string")&&(a[l]=u)}let c={scope:i};return Object.keys(a).length>0&&(c.commands=a),o&&(c.coverage=o),s&&(c.testReport=s),c}catch{return yP}}function nJ(t="."){let e=ql(t).testReport,r=e?[e,...bP]:bP;return[...new Set(r.map(n=>Ul(t,n)))]}function iJ(t="."){let e=ql(t).testReport;if(e){let r=Ul(t,e);return _P(r)?r:null}return bP.map(r=>Ul(t,r)).find(r=>_P(r))??null}function oJ(t,e){let r=[],n=!1;for(let i of t){let o=Dke.exec(i);if(o){n=!0;for(let s of e)r.push(hs(s.path,o[1]))}else r.push(i)}return n&&e.length===0||r.length===0?null:{cmd:r[0],args:r.slice(1)}}var rJ,Cke,yP,bP,Dke,fp=y(()=>{"use strict";rJ=St(er(),1);Ev();Cke=["type","lint","test","coverage"],yP={scope:"feature"},bP=["test-report.junit.xml",Ul("coverage","junit.xml"),Ul(".cladding","test-report.junit.xml")];Dke=/^\{modules:([A-Za-z0-9_.:-]+)\}$/});import{existsSync as SP,readFileSync as sJ,readdirSync as Nke,statSync as jke}from"node:fs";import{join as Av}from"node:path";function $P(t){for(let e of["build.gradle.kts","build.gradle","gradle.properties"]){let r=Av(t,e);if(SP(r))try{if(aJ.test(sJ(r,"utf8")))return!0}catch{}}return!1}function cJ(t){try{return SP(t)&&aJ.test(sJ(t,"utf8"))}catch{return!1}}function lJ(t,e=0){if(e>4||!SP(t))return!1;let r;try{r=Nke(t)}catch{return!1}for(let n of r){let i=Av(t,n),o=!1;try{o=jke(i).isDirectory()}catch{continue}if(o){if(n==="build"||n===".gradle"||n==="node_modules")continue;if(lJ(i,e+1))return!0}else if(/\.(kts|gradle|toml)$/.test(n)&&cJ(i))return!0}return!1}function Lke(t){if($P(t))return!0;for(let e of Mke)if(cJ(Av(t,e)))return!0;for(let e of Fke)if(lJ(Av(t,e)))return!0;return!1}function uJ(t="."){let e=ql(t).coverage;return e||(Lke(t)?"kover":"jacoco")}function dJ(t="."){return wP[uJ(t)]}function fJ(t="."){return vP[uJ(t)]}var wP,vP,xP,aJ,Mke,Fke,Tv=y(()=>{"use strict";fp();wP={kover:"koverXmlReport",jacoco:"jacocoTestReport"},vP={kover:"build/reports/kover/report.xml",jacoco:"build/reports/jacoco/test/jacocoTestReport.xml"},xP=[vP.kover,vP.jacoco],aJ=/kover/i;Mke=["build.gradle.kts","build.gradle","settings.gradle.kts","settings.gradle","gradle/libs.versions.toml"],Fke=["buildSrc","build-logic"]});import{existsSync as mp,readFileSync as mJ,readdirSync as hJ}from"node:fs";import{join as gs}from"node:path";function EP(t){return mp(gs(t,"gradlew"))?"./gradlew":"gradle"}function zke(t){let e=EP(t);return{type:{cmd:e,args:["compileKotlin","compileTestKotlin"]},lint:{cmd:e,args:["ktlintCheck"]},test:{cmd:e,args:["test"]},coverage:{cmd:e,args:[dJ(t)]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}}function Uke(t){let e=!1;try{e=/(^|\n)\s*flutter\s*:|sdk:\s*flutter/.test(mJ(gs(t,"pubspec.yaml"),"utf8"))}catch{}let r={cmd:"dart",args:["format","--output=none","--set-exit-if-changed","."]},n={cmd:"gitleaks",args:["detect","--no-banner"]};return e?{type:{cmd:"flutter",args:["analyze"]},lint:r,test:{cmd:"flutter",args:["test"]},coverage:{cmd:"flutter",args:["test","--coverage"]},secret:n}:{type:{cmd:"dart",args:["analyze"]},lint:r,test:{cmd:"dart",args:["test"]},coverage:{cmd:"dart",args:["test","--coverage=coverage"]},secret:n}}function Bke(t,e){let r=[t],n=0,i=4e3;for(;r.length>0&&na.name.endsWith(c)))return!0}return!1}function Zke(t,e){for(let r of e)if(mp(gs(t,r)))return r}function Vke(t,e){try{return hJ(t).find(n=>n.endsWith(e))}catch{return}}function Jke(t){try{return JSON.parse(mJ(gs(t,"package.json"),"utf8"))}catch{return{}}}function pp(t,e){let r=t.scripts?.[e];return typeof r=="string"&&r.trim().length>0?r.trim():void 0}function pJ(t,e){return[t.dependencies,t.devDependencies,t.optionalDependencies,t.peerDependencies].some(r=>r?.[e]!==void 0)}function Yke(t,e,r){if(pp(r,"lint"))return{cmd:"npm",args:["run","--silent","lint"]};for(let n of Wke)if(n.configs.some(i=>mp(gs(t,i))))return n.gate;if(Kke.some(n=>mp(gs(t,n)))||r.eslintConfig!==void 0)return e}function Qke(t,e){return Xke.some(r=>mp(gs(t,r)))?!0:e.jest!==void 0}function eEe(t){if(/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?vitest(?:\s+run)?$/i.test(t))return"vitest";if(/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?jest$/i.test(t))return"jest"}function kP(t,e){let r={...t};return e==="lint"?delete r.lint:delete r.coverage,r}function tEe(t,e){let r=Jke(t),n=e.lint?Yke(t,e.lint,r):void 0,i=n?{...e,lint:n}:kP(e,"lint"),o=pp(r,"test"),s=o?eEe(o):void 0;return o&&!s?(i=kP(i,"coverage"),{...i,test:{cmd:"npm",args:["test"]},...pp(r,"coverage")?{coverage:{cmd:"npm",args:["run","--silent","coverage"]}}:{}}):s==="jest"||!o&&Qke(t,r)?{...i,test:{cmd:"npx",args:[...Mi,"jest"]},coverage:{cmd:"npx",args:[...Mi,"jest","--coverage"]}}:(s==="vitest"&&!pp(r,"coverage")&&!pJ(r,"@vitest/coverage-v8")&&!pJ(r,"@vitest/coverage-istanbul")?i=kP(i,"coverage"):s==="vitest"&&pp(r,"coverage")&&(i={...i,coverage:{cmd:"npm",args:["run","--silent","coverage"]}}),i)}function dt(t="."){for(let e of Hke){let r;for(let o of e.manifests)if(o.startsWith(".")?r=Vke(t,o):r=Zke(t,[o]),r)break;if(!r||e.requiresSource&&!Bke(t,e.requiresSource))continue;let n=typeof e.gates=="function"?e.gates(t):e.gates,i=e.language==="typescript"?tEe(t,n):n;return{language:e.language,manifest:r,gates:i}}return Gke}var Mi,qke,Hke,Gke,Wke,Kke,Xke,an=y(()=>{"use strict";Tv();Mi=["--offline","--no-install"];qke=new Set(["node_modules",".git",".gradle",".idea","build","target","dist","out",".cladding"]);Hke=[{language:"typescript",manifests:["package.json"],gates:{type:{cmd:"npx",args:[...Mi,"tsc","--noEmit"]},lint:{cmd:"npx",args:[...Mi,"eslint","."]},test:{cmd:"npx",args:[...Mi,"vitest","run"]},coverage:{cmd:"npx",args:[...Mi,"vitest","run","--coverage"]},secret:{cmd:"npx",args:[...Mi,"secretlint","**/*"]},arch:{cmd:"npx",args:[...Mi,"madge","--circular","--extensions","ts,tsx,js,jsx","."]},smoke:{cmd:"npm",args:["run","--silent","smoke"]},perf:{cmd:"npm",args:["run","--silent","perf"]},visual:{cmd:"npm",args:["run","--silent","visual"]}}},{language:"python",manifests:["pyproject.toml","setup.py","requirements.txt"],gates:{type:{cmd:"mypy",args:["."]},lint:{cmd:"ruff",args:["check","."]},test:{cmd:"pytest",args:[]},coverage:{cmd:"coverage",args:["run","-m","pytest"]},secret:{cmd:"detect-secrets",args:["scan"]},arch:{cmd:"lint-imports",args:[]}}},{language:"rust",manifests:["Cargo.toml"],gates:{type:{cmd:"cargo",args:["check"]},lint:{cmd:"cargo",args:["clippy","--","-D","warnings"]},test:{cmd:"cargo",args:["test"]},coverage:{cmd:"cargo",args:["llvm-cov"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"go",manifests:["go.mod"],gates:{type:{cmd:"go",args:["vet","./..."]},lint:{cmd:"golangci-lint",args:["run"]},test:{cmd:"go",args:["test","./..."]},coverage:{cmd:"go",args:["test","-cover","./..."]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"kotlin",manifests:["build.gradle.kts","build.gradle","pom.xml"],requiresSource:[".kt",".kts"],gates:zke},{language:"java",manifests:["pom.xml","build.gradle","build.gradle.kts"],gates:{type:{cmd:"mvn",args:["compile","-q"]},lint:{cmd:"mvn",args:["checkstyle:check","-q"]},test:{cmd:"mvn",args:["test","-q"]},coverage:{cmd:"mvn",args:["jacoco:report","-q"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"php",manifests:["composer.json"],gates:{type:{cmd:"phpstan",args:["analyse"]},lint:{cmd:"phpcs",args:[]},test:{cmd:"phpunit",args:[]},coverage:{cmd:"phpunit",args:["--coverage-text"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"ruby",manifests:["Gemfile"],gates:{type:{cmd:"srb",args:["tc"]},lint:{cmd:"rubocop",args:[]},test:{cmd:"bundle",args:["exec","rspec"]},coverage:{cmd:"bundle",args:["exec","rspec","--format","documentation"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"elixir",manifests:["mix.exs"],gates:{type:{cmd:"mix",args:["dialyzer"]},lint:{cmd:"mix",args:["credo"]},test:{cmd:"mix",args:["test"]},coverage:{cmd:"mix",args:["coveralls"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"dotnet",manifests:[".csproj",".sln",".fsproj"],gates:{type:{cmd:"dotnet",args:["build","--nologo","-v","q"]},lint:{cmd:"dotnet",args:["format","--verify-no-changes"]},test:{cmd:"dotnet",args:["test","--nologo"]},coverage:{cmd:"dotnet",args:["test",'--collect:"XPlat Code Coverage"']},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"swift",manifests:["Package.swift"],gates:{type:{cmd:"swift",args:["build"]},lint:{cmd:"swiftlint",args:["lint"]},test:{cmd:"swift",args:["test"]},coverage:{cmd:"swift",args:["test","--enable-code-coverage"]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}},{language:"dart",manifests:["pubspec.yaml"],gates:Uke}],Gke={language:"unknown",manifest:"",gates:{}};Wke=[{configs:["biome.json","biome.jsonc"],gate:{cmd:"npx",args:[...Mi,"biome","lint","."]}},{configs:[".oxlintrc.json",".oxlintrc.jsonc","oxlint.config.ts"],gate:{cmd:"npx",args:[...Mi,"oxlint"]}}],Kke=["eslint.config.js","eslint.config.mjs","eslint.config.cjs","eslint.config.ts","eslint.config.mts","eslint.config.cts",".eslintrc",".eslintrc.js",".eslintrc.cjs",".eslintrc.json",".eslintrc.yaml",".eslintrc.yml"];Xke=["jest.config.js","jest.config.ts","jest.config.mjs","jest.config.cjs","jest.config.json"]});import{existsSync as rEe,readFileSync as nEe}from"node:fs";import{join as iEe}from"node:path";function za(t){return t.code==="ENOENT"}function Ov(t,e,r,n){let i=t.exitCode??1;if(i===0)return[];let o=(t.stderr??"").toString().trim(),s=(t.stdout??"").toString().trim(),a=(o||s||`exit ${i}`).slice(0,200);return gJ.test(o)||gJ.test(s)?[{detector:e,severity:"info",message:n(a)}]:[{detector:e,severity:"error",message:r(a)}]}function Nt(t,e,r,n=[]){if(za(r))return{stage:t,pass:!1,exitCode:2,stderr:`'${e}' not installed`};let i=`${String(r.stderr??"")} +${String(r.stdout??"")}`,o=/ENOTCACHED|ENOTFOUND|EAI_AGAIN|canceled due to missing packages|could not determine executable/i.test(i),a=n.find(l=>l!=="--"&&!l.startsWith("-"))?.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),c=r.exitCode===127&&a!==void 0&&new RegExp(`(?:^|[\\s:])${a}: (?:command )?not found\\b`,"i").test(i);return e==="npx"&&(o||c)?{stage:t,pass:!1,exitCode:2,stderr:"setup gap: 'npx' could not resolve the configured tool without installing it; the inferred tool is not installed or unavailable offline"}:null}function Yt(t,e){if((e.exitCode??1)===0)return{stage:t,pass:!0,exitCode:0};let n=String(e.stderr??"").trim()||String(e.stdout??"").trim();return n?{stage:t,pass:!1,exitCode:1,stderr:n}:{stage:t,pass:!1,exitCode:1}}function Bl(t,e){let r=iEe(t,"package.json");if(!rEe(r))return!1;try{return!!JSON.parse(nEe(r,"utf8")).scripts?.[e]}catch{return!1}}var gJ,Pn=y(()=>{"use strict";gJ=/config (is |file )?not found|no such file|ENOENT|ENOTCACHED|ENOTFOUND|EAI_AGAIN|cannot find (a |the )?(config|module|package|preset)|require[sd]?\b.{0,40}\bconfig|canceled due to missing packages|could not determine executable/i});function oEe(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.arch;if(!n)return[{detector:Rv,severity:"info",message:`no architecture validator registered for language '${r.language}' (compiler may already enforce acyclic imports)`}];let i=We(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Rv,severity:"info",message:`architecture validator '${n.cmd}' not installed`}]:Ov(i,Rv,o=>`${n.cmd} reported architecture violations: ${o}`,o=>`${n.cmd} could not validate (config/setup gap, not a violation): ${o}`)}var Rv,Ua,Iv=y(()=>{"use strict";Fr();an();Pn();Rv="ARCHITECTURE_VIOLATION";Ua={name:Rv,subprocess:!0,run:oEe}});function sEe(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.secret;if(!n)return[{detector:Pv,severity:"info",message:`no secret scanner registered for language '${r.language}'`}];let i=We(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Pv,severity:"info",message:`secret scanner '${n.cmd}' not installed`}]:Ov(i,Pv,o=>`${n.cmd} reported secrets: ${o}`,o=>`${n.cmd} could not scan (config/setup gap, not a secret): ${o}`)}var Pv,qa,Cv=y(()=>{"use strict";Fr();an();Pn();Pv="HARDCODED_SECRET";qa={name:Pv,subprocess:!0,run:sEe}});import{existsSync as AP,readdirSync as yJ}from"node:fs";import{join as Dv}from"node:path";function cEe(t,e){let r=Dv(t,e.path);if(!AP(r))return!0;if(e.isDirectory)try{return yJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml")).length===0}catch{return!0}return!1}function lEe(t){let{cwd:e="."}=t,r=[];for(let i of aEe)cEe(e,i)&&r.push({detector:hp,severity:i.severity,path:i.path,message:`${i.path} is absent \u2014 cladding scaffold incomplete (${i.purpose}). Run \`clad init --intent ""\` to populate it.`});let n=Dv(e,"spec.yaml");if(AP(n)){let i=fEe(n),o=i?null:uEe(e);if(i)r.push({detector:hp,severity:"error",path:"spec.yaml",message:`spec.yaml is present but unreadable (${i}) \u2014 cladding is governing nothing. Fix the SSoT root, then \`clad sync\` to validate.`});else if(o)r.push({detector:hp,severity:"error",path:o.path,message:`spec shard '${o.path}' is present but unparseable (${o.reason}) \u2014 loadSpec throws on it, so every spec-gated detector silently passes. Fix it, then \`clad sync\`.`});else{let s=dEe(e);s&&r.push({detector:hp,severity:"error",path:"spec.yaml",message:`spec.yaml is present and parses, but the assembled spec does not load (${s}) \u2014 every spec-gated detector then degrades to non-blocking info, so the gate would pass GREEN on an unloadable SSoT. Fix it, then \`clad sync\` to validate.`})}}return r}function uEe(t){for(let e of["spec/features","spec/scenarios"]){let r=Dv(t,e);if(!AP(r))continue;let n;try{n=yJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml"))}catch{continue}for(let i of[...n].sort())try{Oi(Dv(r,i))}catch(o){return{path:`${e}/${i}`,reason:o.message}}}return null}function dEe(t){try{return q(t),null}catch(e){return e.message}}function fEe(t){let e;try{e=Oi(t)}catch(r){return`unparseable: ${r.message}`}return e===null||typeof e!="object"||Array.isArray(e)?"empty or not a YAML mapping":null}var hp,aEe,_J,bJ=y(()=>{"use strict";Ue();F_();hp="ABSENCE_OF_GOVERNANCE",aEe=[{path:"spec.yaml",severity:"error",purpose:"SSoT root \u2014 every spec-gated detector needs it"},{path:"spec/architecture.yaml",severity:"warn",purpose:"architecture invariants (layers + forbidden_imports)"},{path:"spec/capabilities.yaml",severity:"warn",purpose:"capability \u2194 feature traceability"},{path:"docs/project-context.md",severity:"warn",purpose:"intent narrative + decision history"},{path:"docs/conventions.md",severity:"info",purpose:"project style guide (recommended)"},{path:"spec/scenarios",severity:"info",purpose:"user-journey scenarios (recommended)",isDirectory:!0}];_J={name:hp,run:lEe}});function Nv(t){let e=t.trim().match(/^(\S+)/);return e?e[1].toLowerCase():""}function TP(t,e){let r=e?.trim()??"";if(!t)return r.length>0?"condition is present but ears pattern is not declared":null;if(t==="ubiquitous")return r.length>0?`ears='ubiquitous' but condition is present ('${r.slice(0,40)}\u2026')`:null;if(t==="complex"){if(r.length===0)return"ears='complex' requires a 'while' precondition and a 'when' trigger \u2014 empty";let i=Nv(r)==="while",o=mEe.test(r);return i?o?null:"ears='complex' requires a 'when' trigger clause after the 'while' precondition \u2014 none found":`ears='complex' requires the condition to start with 'while' (precondition) \u2014 got '${Nv(r)}'`}let n=pEe[t];return r.length===0?`ears='${t}' requires condition starting with '${n}' \u2014 empty`:Nv(r)!==n?`ears='${t}' requires condition to start with '${n}' \u2014 got '${Nv(r)}'`:null}function hEe(t,e){let r=TP(e.ears,e.condition);return r?[{featureId:t.id,acId:e.id,pattern:e.ears??"unspecified",message:r}]:[]}function vJ(t){let e=[];for(let r of t)for(let n of r.acceptance_criteria??[])e.push(...hEe(r,n));return e}var pEe,mEe,OP=y(()=>{"use strict";pEe={event:"when",state:"while",optional:"where",unwanted:"if"},mEe=/\bwhen\b/i});function ge(t,e,r){let n;try{n=q(t)}catch(i){return[{detector:e,severity:"info",message:`spec.yaml not loaded: ${i.message}`}]}return r(n)}var wt=y(()=>{"use strict";Ue()});function gEe(t){let{cwd:e="."}=t;return ge(e,jv,yEe)}function yEe(t){let e=[];for(let r of t.features)for(let n of r.acceptance_criteria??[]){let i=!!n.text?.trim(),o=!!(n.condition?.trim()||n.action?.trim()||n.response?.trim());!i&&!o&&e.push({detector:jv,severity:"error",message:`${r.id}.${n.id} has neither rendered text nor any EARS field (condition/action/response) \u2014 structurally empty AC`})}for(let r of vJ(t.features))e.push({detector:jv,severity:"error",message:`${r.featureId}.${r.acId} EARS: ${r.message}`});return e}var jv,SJ,wJ=y(()=>{"use strict";OP();wt();jv="AC_DRIFT";SJ={name:jv,run:gEe}});function Fi(t=".",e){let n=(e??"").trim().toLowerCase()||dt(t).language;return $J[n]??xJ}var _Ee,bEe,vEe,xJ,SEe,wEe,$J,xEe,kJ,Ba=y(()=>{"use strict";an();_Ee=/(?:import\s+(?:[\s\S]*?\sfrom\s+)?|import\s*\()['"]([^'"]+)['"]\)?/g,bEe=/^[ \t]*import\s+([\w.]+)/gm,vEe=/^[ \t]*(?:from|import)\s+([\w.]+)/gm,xJ={ext:"ts",extensions:[".ts",".tsx"],sourceRoots:["src"],mainRoot:"src",testGlobs:["tests/**/*.test.ts"],coverageSummary:"coverage/coverage-summary.json",coverageFormat:"istanbul-json",importMatcher:_Ee,importStyle:"relative"},SEe={ext:"kt",extensions:[".kt",".kts"],sourceRoots:["src/main/kotlin","src/test/kotlin"],mainRoot:"src/main/kotlin",testGlobs:["src/test/kotlin/**/*Test.kt","src/test/kotlin/**/*Tests.kt"],coverageSummary:"build/reports/jacoco/test/jacocoTestReport.xml",coverageFormat:"jacoco-xml",importMatcher:bEe,importStyle:"dotted"},wEe={ext:"py",extensions:[".py"],sourceRoots:["."],mainRoot:"src",testGlobs:["tests/test_*.py","tests/**/test_*.py","tests/**/*_test.py"],coverageSummary:"coverage.xml",coverageFormat:"cobertura-xml",importMatcher:vEe,importStyle:"dotted"},$J={typescript:xJ,kotlin:SEe,python:wEe},xEe=[".js",".jsx",".mts",".cts",".rs",".go",".java",".rb",".php",".cs",".fs",".ex",".exs"],kJ=new Set([...Object.values($J).flatMap(t=>t?.extensions??[]),...xEe].map(t=>t.toLowerCase()))});import{existsSync as $Ee,readFileSync as kEe,readdirSync as EEe,statSync as AEe}from"node:fs";import{join as AJ,relative as EJ}from"node:path";function TEe(t,e){if(!$Ee(t))return[];let r=[],n=[t];for(;n.length>0;){let i=n.pop(),o;try{o=EEe(i)}catch{continue}for(let s of o){if(s==="node_modules"||s===".cladding"||s.startsWith("."))continue;let a=AJ(i,s),c;try{c=AEe(a)}catch{continue}c.isDirectory()?n.push(a):e.some(l=>s.endsWith(l))&&r.push(a)}}return r}function OEe(t){let e=t.trim();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("*")}function IEe(t){return REe.test(t)}function PEe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=r.project.ai_hints?.forbidden_patterns;if(!n||n.length===0)return[];let i=Fi(e,r.project?.language),o=i.sourceRoots.flatMap(a=>TEe(AJ(e,a),i.extensions));if(o.length===0)return[];let s=[];for(let a of o){let c;try{c=kEe(a,"utf8")}catch{continue}let l=c.split(` +`);for(let u=0;u{"use strict";Ue();Ba();TJ="AI_HINTS_FORBIDDEN_PATTERN";REe=/\/\/\s*cladding-disable[:\s]+AI_HINTS_FORBIDDEN_PATTERN\b/;OJ={name:TJ,run:PEe}});function CEe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];for(let i of r.features){let o=(i.acceptance_criteria??[]).map(a=>a.id),s=new Map;for(let a of o)s.set(a,(s.get(a)??0)+1);for(let[a,c]of s)c>1&&n.push({detector:IJ,severity:"error",message:`${i.id}.${a} appears ${c} times \u2014 AC ids must be unique within a feature`})}return n}var IJ,PJ,CJ=y(()=>{"use strict";Ue();IJ="AC_DUPLICATE_WITHIN_FEATURE";PJ={name:IJ,run:CEe}});import{createRequire as DEe}from"module";import{basename as NEe,dirname as IP,normalize as jEe,relative as MEe,resolve as FEe,sep as jJ}from"path";import*as LEe from"fs";function zEe(t){let e=jEe(t);return e.length>1&&e[e.length-1]===jJ&&(e=e.substring(0,e.length-1)),e}function MJ(t,e){return t.replace(UEe,e)}function BEe(t){return t==="/"||qEe.test(t)}function RP(t,e){let{resolvePaths:r,normalizePath:n,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(r&&(t=FEe(t)),(n||o)&&(t=zEe(t)),t===".")return"";let s=t[t.length-1]!==i;return MJ(s?t+i:t,i)}function FJ(t,e){return e+t}function HEe(t,e){return function(r,n){return n.startsWith(t)?n.slice(t.length)+r:MJ(MEe(t,n),e.pathSeparator)+e.pathSeparator+r}}function GEe(t){return t}function ZEe(t,e,r){return e+t+r}function VEe(t,e){let{relativePaths:r,includeBasePath:n}=e;return r&&t?HEe(t,e):n?FJ:GEe}function WEe(t){return function(e,r){r.push(e.substring(t.length)||".")}}function KEe(t){return function(e,r,n){let i=e.substring(t.length)||".";n.every(o=>o(i,!0))&&r.push(i)}}function QEe(t,e){let{includeDirs:r,filters:n,relativePaths:i}=e;return r?i?n&&n.length?KEe(t):WEe(t):n&&n.length?YEe:JEe:XEe}function oAe(t){let{excludeFiles:e,filters:r,onlyCounts:n}=t;return e?iAe:r&&r.length?n?eAe:tAe:n?rAe:nAe}function cAe(t){return t.group?aAe:sAe}function dAe(t){return t.group?lAe:uAe}function mAe(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?pAe:fAe}function LJ(t,e,r){if(r.options.useRealPaths)return hAe(e,r);let n=IP(t),i=1;for(;n!==r.root&&i<2;){let o=r.symlinks.get(n);!!o&&(o===e||o.startsWith(e)||e.startsWith(o))?i++:n=IP(n)}return r.symlinks.set(t,e),i>1}function hAe(t,e){return e.visited.includes(t+e.options.pathSeparator)}function Mv(t,e,r,n){e(t&&!n?t:null,r)}function $Ae(t,e){let{onlyCounts:r,group:n,maxFiles:i}=t;return r?e?gAe:vAe:n?e?yAe:xAe:i?e?bAe:wAe:e?_Ae:SAe}function AAe(t){return t?EAe:kAe}function IAe(t,e){return new Promise((r,n)=>{qJ(t,e,(i,o)=>{if(i)return n(i);r(o)})})}function qJ(t,e,r){new UJ(t,e,r).start()}function PAe(t,e){return new UJ(t,e).start()}var DJ,UEe,qEe,JEe,YEe,XEe,eAe,tAe,rAe,nAe,iAe,sAe,aAe,lAe,uAe,fAe,pAe,gAe,yAe,_Ae,bAe,vAe,SAe,wAe,xAe,zJ,kAe,EAe,TAe,OAe,RAe,UJ,NJ,BJ,HJ,GJ=y(()=>{DJ=DEe(import.meta.url);UEe=/[\\/]/g;qEe=/^[a-z]:[\\/]$/i;JEe=(t,e)=>{e.push(t||".")},YEe=(t,e,r)=>{let n=t||".";r.every(i=>i(n,!0))&&e.push(n)},XEe=()=>{};eAe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&r.files++},tAe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&e.push(t)},rAe=(t,e,r,n)=>{r.files++},nAe=(t,e)=>{e.push(t)},iAe=()=>{};sAe=t=>t,aAe=()=>[""].slice(0,0);lAe=(t,e,r)=>{t.push({directory:e,files:r,dir:e})},uAe=()=>{};fAe=function(t,e,r){let{queue:n,fs:i,options:{suppressErrors:o}}=e;n.enqueue(),i.realpath(t,(s,a)=>{if(s)return n.dequeue(o?null:s,e);i.stat(a,(c,l)=>{if(c)return n.dequeue(o?null:c,e);if(l.isDirectory()&&LJ(t,a,e))return n.dequeue(null,e);r(l,a),n.dequeue(null,e)})})},pAe=function(t,e,r){let{queue:n,fs:i,options:{suppressErrors:o}}=e;n.enqueue();try{let s=i.realpathSync(t),a=i.statSync(s);if(a.isDirectory()&&LJ(t,s,e))return;r(a,s)}catch(s){if(!o)throw s}};gAe=t=>t.counts,yAe=t=>t.groups,_Ae=t=>t.paths,bAe=t=>t.paths.slice(0,t.options.maxFiles),vAe=(t,e,r)=>(Mv(e,r,t.counts,t.options.suppressErrors),null),SAe=(t,e,r)=>(Mv(e,r,t.paths,t.options.suppressErrors),null),wAe=(t,e,r)=>(Mv(e,r,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),xAe=(t,e,r)=>(Mv(e,r,t.groups,t.options.suppressErrors),null);zJ={withFileTypes:!0},kAe=(t,e,r,n,i)=>{if(t.queue.enqueue(),n<0)return t.queue.dequeue(null,t);let{fs:o}=t;t.visited.push(e),t.counts.directories++,o.readdir(e||".",zJ,(s,a=[])=>{i(a,r,n),t.queue.dequeue(t.options.suppressErrors?null:s,t)})},EAe=(t,e,r,n,i)=>{let{fs:o}=t;if(n<0)return;t.visited.push(e),t.counts.directories++;let s=[];try{s=o.readdirSync(e||".",zJ)}catch(a){if(!t.options.suppressErrors)throw a}i(s,r,n)};TAe=class{count=0;constructor(t){this.onQueueEmpty=t}enqueue(){return this.count++,this.count}dequeue(t,e){this.onQueueEmpty&&(--this.count<=0||t)&&(this.onQueueEmpty(t,e),t&&(e.controller.abort(),this.onQueueEmpty=void 0))}},OAe=class{_files=0;_directories=0;set files(t){this._files=t}get files(){return this._files}set directories(t){this._directories=t}get directories(){return this._directories}get dirs(){return this._directories}},RAe=class{aborted=!1;abort(){this.aborted=!0}},UJ=class{root;isSynchronous;state;joinPath;pushDirectory;pushFile;getArray;groupFiles;resolveSymlink;walkDirectory;callbackInvoker;constructor(t,e,r){this.isSynchronous=!r,this.callbackInvoker=$Ae(e,this.isSynchronous),this.root=RP(t,e),this.state={root:BEe(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new OAe,options:e,queue:new TAe((n,i)=>this.callbackInvoker(i,n,r)),symlinks:new Map,visited:[""].slice(0,0),controller:new RAe,fs:e.fs||LEe},this.joinPath=VEe(this.root,e),this.pushDirectory=QEe(this.root,e),this.pushFile=oAe(e),this.getArray=cAe(e),this.groupFiles=dAe(e),this.resolveSymlink=mAe(e,this.isSynchronous),this.walkDirectory=AAe(this.isSynchronous)}start(){return this.pushDirectory(this.root,this.state.paths,this.state.options.filters),this.walkDirectory(this.state,this.root,this.root,this.state.options.maxDepth,this.walk),this.isSynchronous?this.callbackInvoker(this.state,null):null}walk=(t,e,r)=>{let{paths:n,options:{filters:i,resolveSymlinks:o,excludeSymlinks:s,exclude:a,maxFiles:c,signal:l,useRealPaths:u,pathSeparator:d},controller:f}=this.state;if(f.aborted||l&&l.aborted||c&&n.length>c)return;let p=this.getArray(this.state.paths);for(let m=0;m{if(b.isDirectory()){if(_=RP(_,this.state.options),a&&a(h.name,u?_:g+d))return;this.walkDirectory(this.state,_,u?_:g+d,r-1,this.walk)}else{_=u?_:g;let S=NEe(_),x=RP(IP(_),this.state.options);_=this.joinPath(S,x),this.pushFile(_,p,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,p)}};NJ=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return IAe(this.root,this.options)}withCallback(t){qJ(this.root,this.options,t)}sync(){return PAe(this.root,this.options)}},BJ=null;try{DJ.resolve("picomatch"),BJ=DJ("picomatch")}catch{}HJ=class{globCache={};options={maxDepth:1/0,suppressErrors:!0,pathSeparator:jJ,filters:[]};globFunction;constructor(t){this.options={...this.options,...t},this.globFunction=this.options.globFunction}group(){return this.options.group=!0,this}withPathSeparator(t){return this.options.pathSeparator=t,this}withBasePath(){return this.options.includeBasePath=!0,this}withRelativePaths(){return this.options.relativePaths=!0,this}withDirs(){return this.options.includeDirs=!0,this}withMaxDepth(t){return this.options.maxDepth=t,this}withMaxFiles(t){return this.options.maxFiles=t,this}withFullPaths(){return this.options.resolvePaths=!0,this.options.includeBasePath=!0,this}withErrors(){return this.options.suppressErrors=!1,this}withSymlinks({resolvePaths:t=!0}={}){return this.options.resolveSymlinks=!0,this.options.useRealPaths=t,this.withFullPaths()}withAbortSignal(t){return this.options.signal=t,this}normalize(){return this.options.normalizePath=!0,this}filter(t){return this.options.filters.push(t),this}onlyDirs(){return this.options.excludeFiles=!0,this.options.includeDirs=!0,this}exclude(t){return this.options.exclude=t,this}onlyCounts(){return this.options.onlyCounts=!0,this}crawl(t){return new NJ(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options={...this.options,...e},new NJ(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let r=this.globFunction||BJ;if(!r)throw new Error("Please specify a glob function to use glob matching.");var n=this.globCache[t.join("\0")];return n||(n=r(t,...e),this.globCache[t.join("\0")]=n),this.options.filters.push(i=>n(i)),this}}});var gp=v((sdt,JJ)=>{"use strict";var ZJ="[^\\\\/]",CAe="(?=.)",VJ="[^/]",PP="(?:\\/|$)",WJ="(?:^|\\/)",CP=`\\.{1,2}${PP}`,DAe="(?!\\.)",NAe=`(?!${WJ}${CP})`,jAe=`(?!\\.{0,1}${PP})`,MAe=`(?!${CP})`,FAe="[^.\\/]",LAe=`${VJ}*?`,zAe="/",KJ={DOT_LITERAL:"\\.",PLUS_LITERAL:"\\+",QMARK_LITERAL:"\\?",SLASH_LITERAL:"\\/",ONE_CHAR:CAe,QMARK:VJ,END_ANCHOR:PP,DOTS_SLASH:CP,NO_DOT:DAe,NO_DOTS:NAe,NO_DOT_SLASH:jAe,NO_DOTS_SLASH:MAe,QMARK_NO_DOT:FAe,STAR:LAe,START_ANCHOR:WJ,SEP:zAe},UAe={...KJ,SLASH_LITERAL:"[\\\\/]",QMARK:ZJ,STAR:`${ZJ}*?`,DOTS_SLASH:"\\.{1,2}(?:[\\\\/]|$)",NO_DOT:"(?!\\.)",NO_DOTS:"(?!(?:^|[\\\\/])\\.{1,2}(?:[\\\\/]|$))",NO_DOT_SLASH:"(?!\\.{0,1}(?:[\\\\/]|$))",NO_DOTS_SLASH:"(?!\\.{1,2}(?:[\\\\/]|$))",QMARK_NO_DOT:"[^.\\\\/]",START_ANCHOR:"(?:^|[\\\\/])",END_ANCHOR:"(?:[\\\\/]|$)",SEP:"\\"},qAe={__proto__:null,alnum:"a-zA-Z0-9",alpha:"a-zA-Z",ascii:"\\x00-\\x7F",blank:" \\t",cntrl:"\\x00-\\x1F\\x7F",digit:"0-9",graph:"\\x21-\\x7E",lower:"a-z",print:"\\x20-\\x7E ",punct:"\\-!\"#$%&'()\\*+,./:;<=>?@[\\]^_`{|}~",space:" \\t\\r\\n\\v\\f",upper:"A-Z",word:"A-Za-z0-9_",xdigit:"A-Fa-f0-9"};JJ.exports={DEFAULT_MAX_EXTGLOB_RECURSION:0,MAX_LENGTH:1024*64,POSIX_REGEX_SOURCE:qAe,REGEX_BACKSLASH:/\\(?![*+?^${}(|)[\]])/g,REGEX_NON_SPECIAL_CHARS:/^[^@![\].,$*+?^{}()|\\/]+/,REGEX_SPECIAL_CHARS:/[-*+?.^${}(|)[\]]/,REGEX_SPECIAL_CHARS_BACKREF:/(\\?)((\W)(\3*))/g,REGEX_SPECIAL_CHARS_GLOBAL:/([-*+?.^${}(|)[\]])/g,REGEX_REMOVE_BACKSLASH:/(?:\[.*?[^\\]\]|\\(?=.))/g,REPLACEMENTS:{__proto__:null,"***":"*","**/**":"**","**/**/**":"**"},CHAR_0:48,CHAR_9:57,CHAR_UPPERCASE_A:65,CHAR_LOWERCASE_A:97,CHAR_UPPERCASE_Z:90,CHAR_LOWERCASE_Z:122,CHAR_LEFT_PARENTHESES:40,CHAR_RIGHT_PARENTHESES:41,CHAR_ASTERISK:42,CHAR_AMPERSAND:38,CHAR_AT:64,CHAR_BACKWARD_SLASH:92,CHAR_CARRIAGE_RETURN:13,CHAR_CIRCUMFLEX_ACCENT:94,CHAR_COLON:58,CHAR_COMMA:44,CHAR_DOT:46,CHAR_DOUBLE_QUOTE:34,CHAR_EQUAL:61,CHAR_EXCLAMATION_MARK:33,CHAR_FORM_FEED:12,CHAR_FORWARD_SLASH:47,CHAR_GRAVE_ACCENT:96,CHAR_HASH:35,CHAR_HYPHEN_MINUS:45,CHAR_LEFT_ANGLE_BRACKET:60,CHAR_LEFT_CURLY_BRACE:123,CHAR_LEFT_SQUARE_BRACKET:91,CHAR_LINE_FEED:10,CHAR_NO_BREAK_SPACE:160,CHAR_PERCENT:37,CHAR_PLUS:43,CHAR_QUESTION_MARK:63,CHAR_RIGHT_ANGLE_BRACKET:62,CHAR_RIGHT_CURLY_BRACE:125,CHAR_RIGHT_SQUARE_BRACKET:93,CHAR_SEMICOLON:59,CHAR_SINGLE_QUOTE:39,CHAR_SPACE:32,CHAR_TAB:9,CHAR_UNDERSCORE:95,CHAR_VERTICAL_LINE:124,CHAR_ZERO_WIDTH_NOBREAK_SPACE:65279,extglobChars(t){return{"!":{type:"negate",open:"(?:(?!(?:",close:`))${t.STAR})`},"?":{type:"qmark",open:"(?:",close:")?"},"+":{type:"plus",open:"(?:",close:")+"},"*":{type:"star",open:"(?:",close:")*"},"@":{type:"at",open:"(?:",close:")"}}},globChars(t){return t===!0?UAe:KJ}}});var yp=v(Lr=>{"use strict";var{REGEX_BACKSLASH:BAe,REGEX_REMOVE_BACKSLASH:HAe,REGEX_SPECIAL_CHARS:GAe,REGEX_SPECIAL_CHARS_GLOBAL:ZAe}=gp();Lr.isObject=t=>t!==null&&typeof t=="object"&&!Array.isArray(t);Lr.hasRegexChars=t=>GAe.test(t);Lr.isRegexChar=t=>t.length===1&&Lr.hasRegexChars(t);Lr.escapeRegex=t=>t.replace(ZAe,"\\$1");Lr.toPosixSlashes=t=>t.replace(BAe,"/");Lr.isWindows=()=>{if(typeof navigator<"u"&&navigator.platform){let t=navigator.platform.toLowerCase();return t==="win32"||t==="windows"}return typeof process<"u"&&process.platform?process.platform==="win32":!1};Lr.removeBackslashes=t=>t.replace(HAe,e=>e==="\\"?"":e);Lr.escapeLast=(t,e,r)=>{let n=t.lastIndexOf(e,r);return n===-1?t:t[n-1]==="\\"?Lr.escapeLast(t,e,n-1):`${t.slice(0,n)}\\${t.slice(n)}`};Lr.removePrefix=(t,e={})=>{let r=t;return r.startsWith("./")&&(r=r.slice(2),e.prefix="./"),r};Lr.wrapOutput=(t,e={},r={})=>{let n=r.contains?"":"^",i=r.contains?"":"$",o=`${n}(?:${t})${i}`;return e.negated===!0&&(o=`(?:^(?!${o}).*$)`),o};Lr.basename=(t,{windows:e}={})=>{let r=t.split(e?/[\\/]/:"/"),n=r[r.length-1];return n===""?r[r.length-2]:n}});var i8=v((cdt,n8)=>{"use strict";var YJ=yp(),{CHAR_ASTERISK:DP,CHAR_AT:VAe,CHAR_BACKWARD_SLASH:_p,CHAR_COMMA:WAe,CHAR_DOT:NP,CHAR_EXCLAMATION_MARK:jP,CHAR_FORWARD_SLASH:r8,CHAR_LEFT_CURLY_BRACE:MP,CHAR_LEFT_PARENTHESES:FP,CHAR_LEFT_SQUARE_BRACKET:KAe,CHAR_PLUS:JAe,CHAR_QUESTION_MARK:XJ,CHAR_RIGHT_CURLY_BRACE:YAe,CHAR_RIGHT_PARENTHESES:QJ,CHAR_RIGHT_SQUARE_BRACKET:XAe}=gp(),e8=t=>t===r8||t===_p,t8=t=>{t.isPrefix!==!0&&(t.depth=t.isGlobstar?1/0:1)},QAe=(t,e)=>{let r=e||{},n=t.length-1,i=r.parts===!0||r.scanToEnd===!0,o=[],s=[],a=[],c=t,l=-1,u=0,d=0,f=!1,p=!1,m=!1,h=!1,g=!1,b=!1,_=!1,S=!1,x=!1,w=!1,O=0,T,A,D={value:"",depth:0,isGlob:!1},$=()=>l>=n,re=()=>c.charCodeAt(l+1),K=()=>(T=A,c.charCodeAt(++l));for(;l0&&(C=c.slice(0,u),c=c.slice(u),d-=u),xe&&m===!0&&d>0?(xe=c.slice(0,d),P=c.slice(d)):m===!0?(xe="",P=c):xe=c,xe&&xe!==""&&xe!=="/"&&xe!==c&&e8(xe.charCodeAt(xe.length-1))&&(xe=xe.slice(0,-1)),r.unescape===!0&&(P&&(P=YJ.removeBackslashes(P)),xe&&_===!0&&(xe=YJ.removeBackslashes(xe)));let Pr={prefix:C,input:t,start:u,base:xe,glob:P,isBrace:f,isBracket:p,isGlob:m,isExtglob:h,isGlobstar:g,negated:S,negatedExtglob:x};if(r.tokens===!0&&(Pr.maxDepth=0,e8(A)||s.push(D),Pr.tokens=s),r.parts===!0||r.tokens===!0){let se;for(let Ce=0;Ce{"use strict";var bp=gp(),cn=yp(),{MAX_LENGTH:Fv,POSIX_REGEX_SOURCE:eTe,REGEX_NON_SPECIAL_CHARS:tTe,REGEX_SPECIAL_CHARS_BACKREF:rTe,REPLACEMENTS:o8}=bp,nTe=(t,e)=>{if(typeof e.expandRange=="function")return e.expandRange(...t,e);t.sort();let r=`[${t.join("-")}]`;try{new RegExp(r)}catch{return t.map(i=>cn.escapeRegex(i)).join("..")}return r},Hl=(t,e)=>`Missing ${t}: "${e}" - use "\\\\${e}" to match literal characters`,s8=t=>{let e=[],r=0,n=0,i=0,o="",s=!1;for(let a of t){if(s===!0){o+=a,s=!1;continue}if(a==="\\"){o+=a,s=!0;continue}if(a==='"'){i=i===1?0:1,o+=a;continue}if(i===0){if(a==="[")r++;else if(a==="]"&&r>0)r--;else if(r===0){if(a==="(")n++;else if(a===")"&&n>0)n--;else if(a==="|"&&n===0){e.push(o),o="";continue}}}o+=a}return e.push(o),e},iTe=t=>{let e=!1;for(let r of t){if(e===!0){e=!1;continue}if(r==="\\"){e=!0;continue}if(/[?*+@!()[\]{}]/.test(r))return!1}return!0},a8=t=>{let e=t.trim(),r=!0;for(;r===!0;)r=!1,/^@\([^\\()[\]{}|]+\)$/.test(e)&&(e=e.slice(2,-1),r=!0);if(iTe(e))return e.replace(/\\(.)/g,"$1")},oTe=t=>{let e=t.map(a8).filter(Boolean);for(let r=0;r{if(t[0]!=="+"&&t[0]!=="*"||t[1]!=="(")return;let r=0,n=0,i=0,o=!1;for(let s=1;s0){r--;continue}if(!(r>0)){if(a==="("){n++;continue}if(a===")"&&(n--,n===0))return e===!0&&s!==t.length-1?void 0:{type:t[0],body:t.slice(2,s),end:s}}}}},sTe=t=>{let e=0,r=[];for(;ea.trim());if(o.length!==1)return;let s=a8(o[0]);if(!s||s.length!==1)return;r.push(s),e+=i.end+1}return r.length<1?void 0:`${r.length===1?cn.escapeRegex(r[0]):`[${r.map(i=>cn.escapeRegex(i)).join("")}]`}*`},aTe=t=>{let e=0,r=t.trim(),n=LP(r);for(;n;)e++,r=n.body.trim(),n=LP(r);return e},cTe=(t,e)=>{if(e.maxExtglobRecursion===!1)return{risky:!1};let r=typeof e.maxExtglobRecursion=="number"?e.maxExtglobRecursion:bp.DEFAULT_MAX_EXTGLOB_RECURSION,n=s8(t).map(i=>i.trim());if(n.length>1&&(n.some(i=>i==="")||n.some(i=>/^[*?]+$/.test(i))||oTe(n)))return{risky:!0};for(let i of n){let o=sTe(i);if(o)return{risky:!0,safeOutput:o};if(aTe(i)>r)return{risky:!0}}return{risky:!1}},zP=(t,e)=>{if(typeof t!="string")throw new TypeError("Expected a string");t=o8[t]||t;let r={...e},n=typeof r.maxLength=="number"?Math.min(Fv,r.maxLength):Fv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);let o={type:"bos",value:"",output:r.prepend||""},s=[o],a=r.capture?"":"?:",c=bp.globChars(r.windows),l=bp.extglobChars(c),{DOT_LITERAL:u,PLUS_LITERAL:d,SLASH_LITERAL:f,ONE_CHAR:p,DOTS_SLASH:m,NO_DOT:h,NO_DOT_SLASH:g,NO_DOTS_SLASH:b,QMARK:_,QMARK_NO_DOT:S,STAR:x,START_ANCHOR:w}=c,O=H=>`(${a}(?:(?!${w}${H.dot?m:u}).)*?)`,T=r.dot?"":h,A=r.dot?_:S,D=r.bash===!0?O(r):x;r.capture&&(D=`(${D})`),typeof r.noext=="boolean"&&(r.noextglob=r.noext);let $={input:t,index:-1,start:0,dot:r.dot===!0,consumed:"",output:"",prefix:"",backtrack:!1,negated:!1,brackets:0,braces:0,parens:0,quotes:0,globstar:!1,tokens:s};t=cn.removePrefix(t,$),i=t.length;let re=[],K=[],xe=[],C=o,P,Pr=()=>$.index===i-1,se=$.peek=(H=1)=>t[$.index+H],Ce=$.advance=()=>t[++$.index]||"",Kt=()=>t.slice($.index+1),dr=(H="",ht=0)=>{$.consumed+=H,$.index+=ht},Xt=H=>{$.output+=H.output!=null?H.output:H.value,dr(H.value)},lo=()=>{let H=1;for(;se()==="!"&&(se(2)!=="("||se(3)==="?");)Ce(),$.start++,H++;return H%2===0?!1:($.negated=!0,$.start++,!0)},$i=H=>{$[H]++,xe.push(H)},Qr=H=>{$[H]--,xe.pop()},de=H=>{if(C.type==="globstar"){let ht=$.braces>0&&(H.type==="comma"||H.type==="brace"),B=H.extglob===!0||re.length&&(H.type==="pipe"||H.type==="paren");H.type!=="slash"&&H.type!=="paren"&&!ht&&!B&&($.output=$.output.slice(0,-C.output.length),C.type="star",C.value="*",C.output=D,$.output+=C.output)}if(re.length&&H.type!=="paren"&&(re[re.length-1].inner+=H.value),(H.value||H.output)&&Xt(H),C&&C.type==="text"&&H.type==="text"){C.output=(C.output||C.value)+H.value,C.value+=H.value;return}H.prev=C,s.push(H),C=H},uo=(H,ht)=>{let B={...l[ht],conditions:1,inner:""};B.prev=C,B.parens=$.parens,B.output=$.output,B.startIndex=$.index,B.tokensIndex=s.length;let Oe=(r.capture?"(":"")+B.open;$i("parens"),de({type:H,value:ht,output:$.output?"":p}),de({type:"paren",extglob:!0,value:Ce(),output:Oe}),re.push(B)},zde=H=>{let ht=t.slice(H.startIndex,$.index+1),B=t.slice(H.startIndex+2,$.index),Oe=cTe(B,r);if((H.type==="plus"||H.type==="star")&&Oe.risky){let lt=Oe.safeOutput?(H.output?"":p)+(r.capture?`(${Oe.safeOutput})`:Oe.safeOutput):void 0,ki=s[H.tokensIndex];ki.type="text",ki.value=ht,ki.output=lt||cn.escapeRegex(ht);for(let Ei=H.tokensIndex+1;Ei1&&H.inner.includes("/")&&(lt=O(r)),(lt!==D||Pr()||/^\)+$/.test(Kt()))&&(ut=H.close=`)$))${lt}`),H.inner.includes("*")&&(zt=Kt())&&/^\.[^\\/.]+$/.test(zt)){let ki=zP(zt,{...e,fastpaths:!1}).output;ut=H.close=`)${ki})${lt})`}H.prev.type==="bos"&&($.negatedExtglob=!0)}de({type:"paren",extglob:!0,value:P,output:ut}),Qr("parens")};if(r.fastpaths!==!1&&!/(^[*!]|[/()[\]{}"])/.test(t)){let H=!1,ht=t.replace(rTe,(B,Oe,ut,zt,lt,ki)=>zt==="\\"?(H=!0,B):zt==="?"?Oe?Oe+zt+(lt?_.repeat(lt.length):""):ki===0?A+(lt?_.repeat(lt.length):""):_.repeat(ut.length):zt==="."?u.repeat(ut.length):zt==="*"?Oe?Oe+zt+(lt?D:""):D:Oe?B:`\\${B}`);return H===!0&&(r.unescape===!0?ht=ht.replace(/\\/g,""):ht=ht.replace(/\\+/g,B=>B.length%2===0?"\\\\":B?"\\":"")),ht===t&&r.contains===!0?($.output=t,$):($.output=cn.wrapOutput(ht,$,e),$)}for(;!Pr();){if(P=Ce(),P==="\0")continue;if(P==="\\"){let B=se();if(B==="/"&&r.bash!==!0||B==="."||B===";")continue;if(!B){P+="\\",de({type:"text",value:P});continue}let Oe=/^\\+/.exec(Kt()),ut=0;if(Oe&&Oe[0].length>2&&(ut=Oe[0].length,$.index+=ut,ut%2!==0&&(P+="\\")),r.unescape===!0?P=Ce():P+=Ce(),$.brackets===0){de({type:"text",value:P});continue}}if($.brackets>0&&(P!=="]"||C.value==="["||C.value==="[^")){if(r.posix!==!1&&P===":"){let B=C.value.slice(1);if(B.includes("[")&&(C.posix=!0,B.includes(":"))){let Oe=C.value.lastIndexOf("["),ut=C.value.slice(0,Oe),zt=C.value.slice(Oe+2),lt=eTe[zt];if(lt){C.value=ut+lt,$.backtrack=!0,Ce(),!o.output&&s.indexOf(C)===1&&(o.output=p);continue}}}(P==="["&&se()!==":"||P==="-"&&se()==="]")&&(P=`\\${P}`),P==="]"&&(C.value==="["||C.value==="[^")&&(P=`\\${P}`),r.posix===!0&&P==="!"&&C.value==="["&&(P="^"),C.value+=P,Xt({value:P});continue}if($.quotes===1&&P!=='"'){P=cn.escapeRegex(P),C.value+=P,Xt({value:P});continue}if(P==='"'){$.quotes=$.quotes===1?0:1,r.keepQuotes===!0&&de({type:"text",value:P});continue}if(P==="("){$i("parens"),de({type:"paren",value:P});continue}if(P===")"){if($.parens===0&&r.strictBrackets===!0)throw new SyntaxError(Hl("opening","("));let B=re[re.length-1];if(B&&$.parens===B.parens+1){zde(re.pop());continue}de({type:"paren",value:P,output:$.parens?")":"\\)"}),Qr("parens");continue}if(P==="["){if(r.nobracket===!0||!Kt().includes("]")){if(r.nobracket!==!0&&r.strictBrackets===!0)throw new SyntaxError(Hl("closing","]"));P=`\\${P}`}else $i("brackets");de({type:"bracket",value:P});continue}if(P==="]"){if(r.nobracket===!0||C&&C.type==="bracket"&&C.value.length===1){de({type:"text",value:P,output:`\\${P}`});continue}if($.brackets===0){if(r.strictBrackets===!0)throw new SyntaxError(Hl("opening","["));de({type:"text",value:P,output:`\\${P}`});continue}Qr("brackets");let B=C.value.slice(1);if(C.posix!==!0&&B[0]==="^"&&!B.includes("/")&&(P=`/${P}`),C.value+=P,Xt({value:P}),r.literalBrackets===!1||cn.hasRegexChars(B))continue;let Oe=cn.escapeRegex(C.value);if($.output=$.output.slice(0,-C.value.length),r.literalBrackets===!0){$.output+=Oe,C.value=Oe;continue}C.value=`(${a}${Oe}|${C.value})`,$.output+=C.value;continue}if(P==="{"&&r.nobrace!==!0){$i("braces");let B={type:"brace",value:P,output:"(",outputIndex:$.output.length,tokensIndex:$.tokens.length};K.push(B),de(B);continue}if(P==="}"){let B=K[K.length-1];if(r.nobrace===!0||!B){de({type:"text",value:P,output:P});continue}let Oe=")";if(B.dots===!0){let ut=s.slice(),zt=[];for(let lt=ut.length-1;lt>=0&&(s.pop(),ut[lt].type!=="brace");lt--)ut[lt].type!=="dots"&&zt.unshift(ut[lt].value);Oe=nTe(zt,r),$.backtrack=!0}if(B.comma!==!0&&B.dots!==!0){let ut=$.output.slice(0,B.outputIndex),zt=$.tokens.slice(B.tokensIndex);B.value=B.output="\\{",P=Oe="\\}",$.output=ut;for(let lt of zt)$.output+=lt.output||lt.value}de({type:"brace",value:P,output:Oe}),Qr("braces"),K.pop();continue}if(P==="|"){re.length>0&&re[re.length-1].conditions++,de({type:"text",value:P});continue}if(P===","){let B=P,Oe=K[K.length-1];Oe&&xe[xe.length-1]==="braces"&&(Oe.comma=!0,B="|"),de({type:"comma",value:P,output:B});continue}if(P==="/"){if(C.type==="dot"&&$.index===$.start+1){$.start=$.index+1,$.consumed="",$.output="",s.pop(),C=o;continue}de({type:"slash",value:P,output:f});continue}if(P==="."){if($.braces>0&&C.type==="dot"){C.value==="."&&(C.output=u);let B=K[K.length-1];C.type="dots",C.output+=P,C.value+=P,B.dots=!0;continue}if($.braces+$.parens===0&&C.type!=="bos"&&C.type!=="slash"){de({type:"text",value:P,output:u});continue}de({type:"dot",value:P,output:u});continue}if(P==="?"){if(!(C&&C.value==="(")&&r.noextglob!==!0&&se()==="("&&se(2)!=="?"){uo("qmark",P);continue}if(C&&C.type==="paren"){let Oe=se(),ut=P;(C.value==="("&&!/[!=<:]/.test(Oe)||Oe==="<"&&!/<([!=]|\w+>)/.test(Kt()))&&(ut=`\\${P}`),de({type:"text",value:P,output:ut});continue}if(r.dot!==!0&&(C.type==="slash"||C.type==="bos")){de({type:"qmark",value:P,output:S});continue}de({type:"qmark",value:P,output:_});continue}if(P==="!"){if(r.noextglob!==!0&&se()==="("&&(se(2)!=="?"||!/[!=<:]/.test(se(3)))){uo("negate",P);continue}if(r.nonegate!==!0&&$.index===0){lo();continue}}if(P==="+"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){uo("plus",P);continue}if(C&&C.value==="("||r.regex===!1){de({type:"plus",value:P,output:d});continue}if(C&&(C.type==="bracket"||C.type==="paren"||C.type==="brace")||$.parens>0){de({type:"plus",value:P});continue}de({type:"plus",value:d});continue}if(P==="@"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){de({type:"at",extglob:!0,value:P,output:""});continue}de({type:"text",value:P});continue}if(P!=="*"){(P==="$"||P==="^")&&(P=`\\${P}`);let B=tTe.exec(Kt());B&&(P+=B[0],$.index+=B[0].length),de({type:"text",value:P});continue}if(C&&(C.type==="globstar"||C.star===!0)){C.type="star",C.star=!0,C.value+=P,C.output=D,$.backtrack=!0,$.globstar=!0,dr(P);continue}let H=Kt();if(r.noextglob!==!0&&/^\([^?]/.test(H)){uo("star",P);continue}if(C.type==="star"){if(r.noglobstar===!0){dr(P);continue}let B=C.prev,Oe=B.prev,ut=B.type==="slash"||B.type==="bos",zt=Oe&&(Oe.type==="star"||Oe.type==="globstar");if(r.bash===!0&&(!ut||H[0]&&H[0]!=="/")){de({type:"star",value:P,output:""});continue}let lt=$.braces>0&&(B.type==="comma"||B.type==="brace"),ki=re.length&&(B.type==="pipe"||B.type==="paren");if(!ut&&B.type!=="paren"&&!lt&&!ki){de({type:"star",value:P,output:""});continue}for(;H.slice(0,3)==="/**";){let Ei=t[$.index+4];if(Ei&&Ei!=="/")break;H=H.slice(3),dr("/**",3)}if(B.type==="bos"&&Pr()){C.type="globstar",C.value+=P,C.output=O(r),$.output=C.output,$.globstar=!0,dr(P);continue}if(B.type==="slash"&&B.prev.type!=="bos"&&!zt&&Pr()){$.output=$.output.slice(0,-(B.output+C.output).length),B.output=`(?:${B.output}`,C.type="globstar",C.output=O(r)+(r.strictSlashes?")":"|$)"),C.value+=P,$.globstar=!0,$.output+=B.output+C.output,dr(P);continue}if(B.type==="slash"&&B.prev.type!=="bos"&&H[0]==="/"){let Ei=H[1]!==void 0?"|$":"";$.output=$.output.slice(0,-(B.output+C.output).length),B.output=`(?:${B.output}`,C.type="globstar",C.output=`${O(r)}${f}|${f}${Ei})`,C.value+=P,$.output+=B.output+C.output,$.globstar=!0,dr(P+Ce()),de({type:"slash",value:"/",output:""});continue}if(B.type==="bos"&&H[0]==="/"){C.type="globstar",C.value+=P,C.output=`(?:^|${f}|${O(r)}${f})`,$.output=C.output,$.globstar=!0,dr(P+Ce()),de({type:"slash",value:"/",output:""});continue}$.output=$.output.slice(0,-C.output.length),C.type="globstar",C.output=O(r),C.value+=P,$.output+=C.output,$.globstar=!0,dr(P);continue}let ht={type:"star",value:P,output:D};if(r.bash===!0){ht.output=".*?",(C.type==="bos"||C.type==="slash")&&(ht.output=T+ht.output),de(ht);continue}if(C&&(C.type==="bracket"||C.type==="paren")&&r.regex===!0){ht.output=P,de(ht);continue}($.index===$.start||C.type==="slash"||C.type==="dot")&&(C.type==="dot"?($.output+=g,C.output+=g):r.dot===!0?($.output+=b,C.output+=b):($.output+=T,C.output+=T),se()!=="*"&&($.output+=p,C.output+=p)),de(ht)}for(;$.brackets>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing","]"));$.output=cn.escapeLast($.output,"["),Qr("brackets")}for(;$.parens>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing",")"));$.output=cn.escapeLast($.output,"("),Qr("parens")}for(;$.braces>0;){if(r.strictBrackets===!0)throw new SyntaxError(Hl("closing","}"));$.output=cn.escapeLast($.output,"{"),Qr("braces")}if(r.strictSlashes!==!0&&(C.type==="star"||C.type==="bracket")&&de({type:"maybe_slash",value:"",output:`${f}?`}),$.backtrack===!0){$.output="";for(let H of $.tokens)$.output+=H.output!=null?H.output:H.value,H.suffix&&($.output+=H.suffix)}return $};zP.fastpaths=(t,e)=>{let r={...e},n=typeof r.maxLength=="number"?Math.min(Fv,r.maxLength):Fv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);t=o8[t]||t;let{DOT_LITERAL:o,SLASH_LITERAL:s,ONE_CHAR:a,DOTS_SLASH:c,NO_DOT:l,NO_DOTS:u,NO_DOTS_SLASH:d,STAR:f,START_ANCHOR:p}=bp.globChars(r.windows),m=r.dot?u:l,h=r.dot?d:l,g=r.capture?"":"?:",b={negated:!1,prefix:""},_=r.bash===!0?".*?":f;r.capture&&(_=`(${_})`);let S=T=>T.noglobstar===!0?_:`(${g}(?:(?!${p}${T.dot?c:o}).)*?)`,x=T=>{switch(T){case"*":return`${m}${a}${_}`;case".*":return`${o}${a}${_}`;case"*.*":return`${m}${_}${o}${a}${_}`;case"*/*":return`${m}${_}${s}${a}${h}${_}`;case"**":return m+S(r);case"**/*":return`(?:${m}${S(r)}${s})?${h}${a}${_}`;case"**/*.*":return`(?:${m}${S(r)}${s})?${h}${_}${o}${a}${_}`;case"**/.*":return`(?:${m}${S(r)}${s})?${o}${a}${_}`;default:{let A=/^(.*?)\.(\w+)$/.exec(T);if(!A)return;let D=x(A[1]);return D?D+o+A[2]:void 0}}},w=cn.removePrefix(t,b),O=x(w);return O&&r.strictSlashes!==!0&&(O+=`${s}?`),O};c8.exports=zP});var f8=v((udt,d8)=>{"use strict";var lTe=i8(),UP=l8(),u8=yp(),uTe=gp(),dTe=t=>t&&typeof t=="object"&&!Array.isArray(t),Rt=(t,e,r=!1)=>{if(Array.isArray(t)){let u=t.map(f=>Rt(f,e,r));return f=>{for(let p of u){let m=p(f);if(m)return m}return!1}}let n=dTe(t)&&t.tokens&&t.input;if(t===""||typeof t!="string"&&!n)throw new TypeError("Expected pattern to be a non-empty string");let i=e||{},o=i.windows,s=n?Rt.compileRe(t,e):Rt.makeRe(t,e,!1,!0),a=s.state;delete s.state;let c=()=>!1;if(i.ignore){let u={...e,ignore:null,onMatch:null,onResult:null};c=Rt(i.ignore,u,r)}let l=(u,d=!1)=>{let{isMatch:f,match:p,output:m}=Rt.test(u,s,e,{glob:t,posix:o}),h={glob:t,state:a,regex:s,posix:o,input:u,output:m,match:p,isMatch:f};return typeof i.onResult=="function"&&i.onResult(h),f===!1?(h.isMatch=!1,d?h:!1):c(u)?(typeof i.onIgnore=="function"&&i.onIgnore(h),h.isMatch=!1,d?h:!1):(typeof i.onMatch=="function"&&i.onMatch(h),d?h:!0)};return r&&(l.state=a),l};Rt.test=(t,e,r,{glob:n,posix:i}={})=>{if(typeof t!="string")throw new TypeError("Expected input to be a string");if(t==="")return{isMatch:!1,output:""};let o=r||{},s=o.format||(i?u8.toPosixSlashes:null),a=t===n,c=a&&s?s(t):t;return a===!1&&(c=s?s(t):t,a=c===n),(a===!1||o.capture===!0)&&(o.matchBase===!0||o.basename===!0?a=Rt.matchBase(t,e,r,i):a=e.exec(c)),{isMatch:!!a,match:a,output:c}};Rt.matchBase=(t,e,r)=>(e instanceof RegExp?e:Rt.makeRe(e,r)).test(u8.basename(t));Rt.isMatch=(t,e,r)=>Rt(e,r)(t);Rt.parse=(t,e)=>Array.isArray(t)?t.map(r=>Rt.parse(r,e)):UP(t,{...e,fastpaths:!1});Rt.scan=(t,e)=>lTe(t,e);Rt.compileRe=(t,e,r=!1,n=!1)=>{if(r===!0)return t.output;let i=e||{},o=i.contains?"":"^",s=i.contains?"":"$",a=`${o}(?:${t.output})${s}`;t&&t.negated===!0&&(a=`^(?!${a}).*$`);let c=Rt.toRegex(a,e);return n===!0&&(c.state=t),c};Rt.makeRe=(t,e={},r=!1,n=!1)=>{if(!t||typeof t!="string")throw new TypeError("Expected a non-empty string");let i={negated:!1,fastpaths:!0};return e.fastpaths!==!1&&(t[0]==="."||t[0]==="*")&&(i.output=UP.fastpaths(t,e)),i.output||(i=UP(t,e)),Rt.compileRe(i,e,r,n)};Rt.toRegex=(t,e)=>{try{let r=e||{};return new RegExp(t,r.flags||(r.nocase?"i":""))}catch(r){if(e&&e.debug===!0)throw r;return/$^/}};Rt.constants=uTe;d8.exports=Rt});var g8=v((ddt,h8)=>{"use strict";var p8=f8(),fTe=yp();function m8(t,e,r=!1){return e&&(e.windows===null||e.windows===void 0)&&(e={...e,windows:fTe.isWindows()}),p8(t,e,r)}Object.assign(m8,p8);h8.exports=m8});import{readdir as pTe,readdirSync as mTe,realpath as hTe,realpathSync as gTe,stat as yTe,statSync as _Te}from"fs";import{isAbsolute as bTe,posix as Ha,resolve as vTe}from"path";import{fileURLToPath as STe}from"url";function $Te(t,e={}){let r=t.length,n=Array(r),i=Array(r),o,s;for(o=0;o{let c=a.split("/");if(c[0]===".."&&xTe.test(a))return!0;for(o=0;oo.slice(i,s?-1:void 0)||"."}let n=e.slice(t.length+1);return n?(i,o)=>{if(i===".")return n;let s=`${n}/${i}`;return o?s.slice(0,-1):s}:(i,o)=>o&&i!=="."?i.slice(0,-1):i}return r?n=>Ha.relative(t,n)||".":n=>Ha.relative(t,`${e}/${n}`)||"."}function ATe(t,e){if(e.startsWith(`${t}/`)){let r=e.slice(t.length+1);return n=>`${r}/${n}`}return r=>{let n=Ha.relative(t,`${e}/${r}`);return r[r.length-1]==="/"&&n!==""?`${n}/`:n||"."}}function v8(t){var e;let r=Gl.default.scan(t,TTe);return!((e=r.parts)===null||e===void 0)&&e.length?r.parts:[t]}function DTe(t,e){if(e?.caseSensitiveMatch===!1)return!0;let r=Gl.default.scan(t);return r.isGlob||r.negated}function vp(...t){console.log(`[tinyglobby ${new Date().toLocaleTimeString("es")}]`,...t)}function S8(t){return typeof t=="string"?[t]:t??[]}function qP(t,e,r,n){var i;let o=e.cwd,s=t;t[t.length-1]==="/"&&(s=t.slice(0,-1)),s[s.length-1]!=="*"&&e.expandDirectories&&(s+="/**");let a=CTe(o);s=bTe(s.replace(jTe,""))?Ha.relative(a,s):Ha.normalize(s);let c=(i=NTe.exec(s))===null||i===void 0?void 0:i[0],l=v8(s);if(c){let d=(c.length+1)/3,f=0,p=a.split("/");for(;fm.length&&(r.root=m,r.depthOffset=-d+f)}if(!n&&r.depthOffset>=0){var u;(u=r.commonPath)!==null&&u!==void 0||(r.commonPath=l);let d=[],f=Math.min(r.commonPath.length,l.length);for(let p=0;p0?Ha.join(o,...d):o}return s}function MTe(t,e,r){let n=[],i=[];for(let o of t.ignore)o&&(o[0]!=="!"||o[1]==="(")&&i.push(qP(o,t,r,!0));for(let o of e)o&&(o[0]!=="!"||o[1]==="("?n.push(qP(o,t,r,!1)):(o[1]!=="!"||o[2]==="(")&&i.push(qP(o.slice(1),t,r,!0)));return{match:n,ignore:i}}function FTe(t,e){let r=t.cwd,n={root:r,depthOffset:0},i=MTe(t,e,n);t.debug&&vp("internal processing patterns:",i);let{absolute:o,caseSensitiveMatch:s,debug:a,dot:c,followSymbolicLinks:l,onlyDirectories:u}=t,d=n.root.replace(_8,""),f={dot:c,nobrace:t.braceExpansion===!1,nocase:!s,noextglob:t.extglob===!1,noglobstar:t.globstar===!1,posix:!0},p=(0,Gl.default)(i.match,f),m=(0,Gl.default)(i.ignore,f),h=$Te(i.match,f),g=y8(r,d,o),b=o?g:y8(r,d,!0),_=(w,O)=>{let T=b(O,!0);return T!=="."&&!h(T)||m(T)},S;t.deep!==void 0&&(S=Math.round(t.deep-n.depthOffset));let x=new HJ({filters:[a?(w,O)=>{let T=g(w,O),A=p(T)&&!m(T);return A&&vp(`matched ${T}`),A}:(w,O)=>{let T=g(w,O);return p(T)&&!m(T)}],exclude:a?(w,O)=>{let T=_(w,O);return vp(`${T?"skipped":"crawling"} ${O}`),T}:_,fs:t.fs,pathSeparator:"/",relativePaths:!o,resolvePaths:o,includeBasePath:o,resolveSymlinks:l,excludeSymlinks:!l,excludeFiles:u,includeDirs:u||!t.onlyFiles,maxDepth:S,signal:t.signal}).crawl(d);return t.debug&&vp("internal properties:",{...n,root:d}),[x,r!==d&&!o&&ATe(r,d)]}function LTe(t,e){if(e)for(let r=t.length-1;r>=0;r--)t[r]=e(t[r]);return t}function UTe(t){let e={...zTe,...t};return e.cwd=(e.cwd instanceof URL?STe(e.cwd):vTe(e.cwd)).replace(_8,"/"),e.ignore=S8(e.ignore),e.fs&&(e.fs={readdir:e.fs.readdir||pTe,readdirSync:e.fs.readdirSync||mTe,realpath:e.fs.realpath||hTe,realpathSync:e.fs.realpathSync||gTe,stat:e.fs.stat||yTe,statSync:e.fs.statSync||_Te}),e.debug&&vp("globbing with options:",e),e}function qTe(t,e={}){var r;if(t&&e?.patterns)throw new Error("Cannot pass patterns as both an argument and an option");let n=wTe(t)||typeof t=="string",i=S8((r=n?t:t.patterns)!==null&&r!==void 0?r:"**/*"),o=UTe(n?e:t);return i.length>0?FTe(o,i):[]}function ys(t,e){let[r,n]=qTe(t,e);return r?LTe(r.sync(),n):[]}var Gl,wTe,_8,b8,xTe,kTe,ETe,TTe,OTe,RTe,ITe,PTe,CTe,NTe,jTe,zTe,Sp=y(()=>{GJ();Gl=St(g8(),1),wTe=Array.isArray,_8=/\\/g,b8=process.platform==="win32",xTe=/^(\/?\.\.)+$/;kTe=/^[A-Z]:\/$/i,ETe=b8?t=>kTe.test(t):t=>t==="/";TTe={parts:!0};OTe=/(?t.replace(OTe,"\\$&"),PTe=t=>t.replace(RTe,"\\$&"),CTe=b8?PTe:ITe;NTe=/^(\/?\.\.)+/,jTe=/\\(?=[()[\]{}!*+?@|])/g;zTe={caseSensitiveMatch:!0,cwd:process.cwd(),debug:!!process.env.TINYGLOBBY_DEBUG,expandDirectories:!0,followSymbolicLinks:!0,onlyFiles:!0}});import{existsSync as wp,readFileSync as BTe,readdirSync as HTe,statSync as w8}from"node:fs";import{join as Ga}from"node:path";function GTe(t){let{cwd:e="."}=t,r,n;try{let c=q(e);r=c.architecture,n=c.project?.language}catch{return[]}if(!r)return[];let i=Fi(e,n),o=[],{layers:s,forbiddenImports:a}=BP(r);return(s.size>0||a.length>0)&&!wp(Ga(e,i.mainRoot))?[{detector:xp,severity:"info",path:`${i.mainRoot}/`,message:`architecture layers declared but ${i.mainRoot}/ not found \u2014 layer checks skipped (flat layout not yet supported)`}]:(s.size>0&&(ZTe(e,i,s,o),VTe(e,i,s,o)),a.length>0&&WTe(e,i,a,o),o)}function BP(t){let e=new Set,r=[];for(let i of t.layers??[])if(Array.isArray(i))for(let o of i)e.add(o);else{let o=i;if(typeof o.name=="string"&&o.name.length>0){e.add(o.name);for(let s of o.forbidden_imports??[])typeof s=="string"&&r.push({from:o.name,to:s})}}let n=t.forbidden_imports??[];return{layers:e,forbiddenImports:[...n,...r]}}function ZTe(t,e,r,n){let i=e.mainRoot,o=Ga(t,i);if(wp(o))for(let s of HTe(o)){let a=Ga(o,s);w8(a).isDirectory()&&(r.has(s)||n.push({detector:xp,severity:"warn",path:`${i}/${s}/`,message:`${i}/${s}/ is not declared in spec/architecture.yaml layers \u2014 add it or remove the directory`}))}}function VTe(t,e,r,n){let i=e.mainRoot,o=Ga(t,i);if(wp(o))for(let s of r){let a=Ga(o,s);wp(a)&&w8(a).isDirectory()||n.push({detector:xp,severity:"warn",path:`${i}/${s}/`,message:`spec/architecture.yaml declares layer '${s}' but ${i}/${s}/ does not exist \u2014 fix the spec or create the directory`})}}function WTe(t,e,r,n){let i=e.mainRoot,o=e.importMatcher;for(let s of r){let a=Ga(t,i,s.from);if(!wp(a))continue;let c=ys([`**/*.${e.ext}`],{cwd:a,dot:!1});for(let l of c){let u=Ga(a,l),d;try{d=BTe(u,"utf8")}catch{continue}let f;for(o.lastIndex=0;(f=o.exec(d))!==null;){let p=f[1];KTe(p,s.to,e.importStyle)&&n.push({detector:xp,severity:"error",path:`${i}/${s.from}/${l}`,message:`${i}/${s.from}/${l} imports from '${p}' which crosses into the '${s.to}' layer \u2014 spec/architecture.yaml forbids imports from '${s.from}' to '${s.to}'`})}}}}function KTe(t,e,r){return r==="dotted"?t.split(".").includes(e):t.startsWith(".")?t.split("/").includes(e):!1}var xp,x8,HP=y(()=>{"use strict";Sp();Ue();Ba();xp="ARCHITECTURE_FROM_SPEC";x8={name:xp,run:GTe}});import{existsSync as JTe,readFileSync as YTe}from"node:fs";import{join as XTe}from"node:path";function eOe(t){let{cwd:e="."}=t,r=XTe(e,"spec/capabilities.yaml");if(!JTe(r))return[];let n;try{let u=YTe(r,"utf8"),d=$8.default.parse(u);if(!d||typeof d!="object")return[];n=d}catch{return[]}let i=n.capabilities??[];if(i.length===0)return[];let o,s=!1;try{let u=q(e);o=new Set(u.features.map(d=>d.id)),s=u.project.onboarding_seeded===!0}catch{return[]}let a=[],c=new Set,l=s&&o.size{"use strict";$8=St(er(),1);Ue();Lv="CAPABILITIES_FEATURE_MAPPING",QTe=8;k8={name:Lv,run:eOe}});import{existsSync as tOe,readFileSync as rOe}from"node:fs";import{join as nOe}from"node:path";function iOe(t){let e=t.trimStart();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("#")||e.startsWith('"""')||e.startsWith("'''")}function oOe(t){let{cwd:e="."}=t;return ge(e,GP,r=>sOe(r,e))}function sOe(t,e){let r=Fi(e,t.project?.language),n=[];for(let i of t.features)for(let o of i.modules??[]){if(!r.extensions.some(c=>o.endsWith(c)))continue;let s=nOe(e,o);if(!tOe(s))continue;let a=rOe(s,"utf8");iOe(a)||n.push({detector:GP,severity:"warn",path:o,message:`${o} has no file-header comment \u2014 Why>What guardrail recommends a one-line intent`})}return n}var GP,A8,T8=y(()=>{"use strict";Ba();wt();GP="CONVENTION_DRIFT";A8={name:GP,run:oOe}});import{existsSync as ZP,readFileSync as O8}from"node:fs";import{join as zv}from"node:path";function aOe(t){return JSON.parse(t).total?.lines?.pct??0}function R8(t){let e=/]*\bline-rate="([0-9]*\.?[0-9]+)"/.exec(t);return e?Number(e[1])*100:null}function uOe(t,e){if(!$v(dt(t).gates.coverage?.cmd))return null;let r;try{r=kv(t,e)}catch(c){return[{detector:$o,severity:"error",message:c.message}]}let n=0,i=0,o=0,s=[];for(let c of r){let l=xP.find(d=>ZP(zv(c.dir,d)));if(!l){s.push(c.path);continue}let u=R8(O8(zv(c.dir,l),"utf8"));u&&(n+=u.missed,i+=u.covered,o++)}if(o===0)return[{detector:$o,severity:"info",message:`no module coverage report present for ${r.map(c=>c.path).join(", ")} \u2014 run stage_2.2 first`}];let a=I8(n,i);return a0?[{detector:$o,severity:"info",message:`module coverage ${a.toFixed(1)}% OK; no report yet for ${s.join(", ")}`}]:[]}function dOe(t){let{cwd:e="."}=t;if(t.focusModules&&t.focusModules.length>0){let a=uOe(e,t.focusModules);if(a)return a}let r;try{r=q(e).project?.language}catch{}let n=Fi(e,r),i=dt(e).language==="kotlin"?xP.find(a=>ZP(zv(e,a)))??fJ(e):n.coverageSummary,o=zv(e,i);if(!ZP(o))return[{detector:$o,severity:"info",message:`${i} not present \u2014 run stage_2.2 first`}];let s;try{let a=O8(o,"utf8");s=n.coverageFormat==="jacoco-xml"?cOe(a):n.coverageFormat==="cobertura-xml"?lOe(a):aOe(a)}catch(a){return[{detector:$o,severity:"warn",message:`${i} unparseable: ${a.message}`}]}return s===null?n.coverageFormat==="cobertura-xml"?[]:[{detector:$o,severity:"warn",message:`${i} contained no line-coverage counter`}]:s>=Uv?[]:[{detector:$o,severity:"warn",message:`line coverage ${s.toFixed(1)}% < floor ${Uv}%`}]}var $o,Uv,P8,C8=y(()=>{"use strict";Ue();Tv();Ba();Ev();an();$o="COVERAGE_DROP",Uv=70;P8={name:$o,run:dOe}});import{existsSync as fOe}from"node:fs";import{join as pOe}from"node:path";function hOe(t){let{cwd:e="."}=t;return ge(e,qv,r=>gOe(r,e))}function gOe(t,e){let r=t.project.deliverable,n=t.features.filter(i=>i.status==="done"&&(i.modules?.length??0)>0);if(!r){if(n.length===0)return[];let i=t.project.onboarding_seeded===!0&&t.features.length{"use strict";wt();qv="DELIVERABLE_INTEGRITY",mOe=8;D8={name:qv,run:hOe}});function yOe(t){let e=new Set((t.features??[]).map(n=>n.id)),r=[];for(let n of t.project?.smoke??[]){let i=n.feature;if(i===void 0||e.has(i))continue;let o=(n.run??[]).join(" ")||`kind:${n.kind}`;r.push({detector:Bv,severity:"warn",path:"spec.yaml",message:`smoke probe '${o}' binds feature ${i}, which is not in the spec \u2014 a dangling binding is annotation drift (the bound feature was renamed, archived, or never existed). Fix the id or drop the binding.`})}return r}function _Oe(t){let e=yOe(t),r=(t.features??[]).filter(o=>o.status==="done");return r.length===0||!!!t.project?.deliverable||(t.project?.smoke??[]).length>0?e:[...e,{detector:Bv,severity:"warn",path:"spec.yaml",message:`${r.length} feature(s) are done and the project ships a runnable deliverable, but no functional smoke probe is declared (project.smoke) \u2014 an exit-only deliverable is liveness, not AC-verification. Declare a smoke probe with an expect.token so the gate re-executes the shipped entry against its AC result.`}]}function bOe(t){let{cwd:e="."}=t;return ge(e,Bv,r=>_Oe(r))}var Bv,j8,M8=y(()=>{"use strict";wt();Bv="SMOKE_PROBE_DEMAND";j8={name:Bv,run:bOe}});function vOe(t){let{cwd:e="."}=t;return ge(e,Hv,r=>SOe(r,e))}function SOe(t,e){let r=(t.features??[]).filter(o=>o.status==="done"&&(o.modules??[]).length>0);if(r.length===0)return[];let n=as(e);if(n===null)return[{detector:Hv,severity:"info",path:"spec/attestation.yaml",message:"no verification attestation \u2014 when this tree was last verified is unknown. Run `clad check --tier=pre-push --strict` GREEN once to attest (the gate writes spec/attestation.yaml)."}];let i=[];for(let o of r){let s=H_(n,e,o);s.state!=="fresh"&&i.push({detector:Hv,severity:"warn",path:"spec/attestation.yaml",message:s.state==="unattested"?`${o.id} is done but has no attestation entry \u2014 its modules were never verified by an attested gate. Run \`clad check --tier=pre-push --strict\` to attest.`:s.module?`${o.id}'s module ${s.module} changed since the last attested verification \u2014 shipped code is running ahead of its verification. Run \`clad check --tier=pre-push --strict\` to re-verify and re-attest.`:`${o.id}'s modules changed since the last attested verification \u2014 shipped code is running ahead of its verification. Run \`clad check --tier=pre-push --strict\` to re-verify and re-attest.`})}return i}var Hv,Gv,VP=y(()=>{"use strict";vl();wt();Hv="STALE_ATTESTATION";Gv={name:Hv,run:vOe}});function wOe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}return xOe(r)}function xOe(t){let e=new Set(t.features.map(d=>d.id)),r=new Map;for(let d of t.features)r.set(d.id,(d.depends_on??[]).filter(f=>e.has(f)));let n=0,i=1,o=2,s=new Map;for(let d of r.keys())s.set(d,n);let a=[],c=new Set,l=[];function u(d){s.set(d,i),l.push(d);for(let f of r.get(d)??[]){let p=s.get(f);if(p===i){let m=l.indexOf(f),h=l.slice(m).concat(f),g=[...h].sort().join(",");c.has(g)||(c.add(g),a.push({detector:F8,severity:"error",path:"spec.yaml",message:`circular depends_on cycle: ${h.join(" \u2192 ")} \u2014 these features can never all become ready, so the drive loop deadlocks. Break the cycle by removing one edge.`}))}else p===n&&u(f)}l.pop(),s.set(d,o)}for(let d of r.keys())s.get(d)===n&&u(d);return a}var F8,Zv,WP=y(()=>{"use strict";Ue();F8="DEPENDENCY_CYCLE";Zv={name:F8,run:wOe}});import{appendFileSync as $Oe,existsSync as L8,mkdirSync as kOe,readFileSync as EOe}from"node:fs";import{dirname as AOe,join as TOe}from"node:path";function z8(t){return TOe(t,OOe,ROe)}function U8(t){return KP.add(t),()=>KP.delete(t)}function Za(t,e){let r=z8(t),n=AOe(r);L8(n)||kOe(n,{recursive:!0}),$Oe(r,`${JSON.stringify(e)} +`,"utf8");for(let i of KP)try{i(t,e)}catch{}}function fr(t){let e=z8(t);if(!L8(e))return[];let r=EOe(e,"utf8").trim();return r.length===0?[]:r.split(` +`).filter(n=>n.length>0).map(n=>JSON.parse(n))}var OOe,ROe,KP,ln=y(()=>{"use strict";OOe=".cladding",ROe="audit.log.jsonl";KP=new Set});import{existsSync as IOe}from"node:fs";import{join as POe}from"node:path";function COe(t){let{cwd:e="."}=t,r=fr(e);if(r.length===0)return[{detector:JP,severity:"info",message:"no audit log present \u2014 detector is opt-in on prior stage_4 runs"}];let n=[];for(let i of r)i.artifact&&(IOe(POe(e,i.artifact))||n.push({detector:JP,severity:"error",path:i.artifact,message:`evidence ${i.id} references missing artifact '${i.artifact}'`}));return n}var JP,q8,B8=y(()=>{"use strict";ln();JP="EVIDENCE_MISMATCH";q8={name:JP,run:COe}});import{existsSync as DOe,readFileSync as NOe}from"node:fs";import{join as jOe}from"node:path";function MOe(t){let e=jOe(t,V8);if(!DOe(e))return null;try{let n=((0,Z8.parse)(NOe(e,"utf8"))?.fixtures??[]).map(i=>i.name).filter(Boolean);return new Set(n)}catch{return null}}function*G8(t,e){for(let r of t??[])r.startsWith(H8)&&(yield{ref:r,name:r.slice(H8.length),field:e})}function FOe(t){let{cwd:e="."}=t,r=MOe(e);if(r===null)return[];let n;try{n=q(e)}catch(o){return[{detector:YP,severity:"info",message:`spec.yaml not loaded: ${o.message}`}]}let i=[];for(let o of n.features)for(let s of o.acceptance_criteria??[]){let a=[...G8(s.evidence_refs,"evidence_refs"),...G8(s.test_refs,"test_refs")];for(let{ref:c,name:l,field:u}of a)r.has(l)||i.push({detector:YP,severity:"warn",path:V8,message:`${o.id}.${s.id} cites '${c}' in ${u} but no fixture named '${l}' is registered in conformance/fixtures.yaml`})}return i}var Z8,YP,H8,V8,W8,K8=y(()=>{"use strict";Z8=St(er(),1);Ue();YP="FIXTURE_REFERENCE_INVALID",H8="fixture:",V8="conformance/fixtures.yaml";W8={name:YP,run:FOe}});import{existsSync as Zl,readFileSync as XP}from"node:fs";import{join as Va}from"node:path";function LOe(t){return ys(["src/stages/detectors/*.ts"],{cwd:t,dot:!1}).filter(r=>!/[/\\](index|with-spec|spec-first-window)\.ts$/.test(r)).length}function $p(t){if(!Zl(t))return null;try{return JSON.parse(XP(t,"utf8"))}catch{return null}}function zOe(t,e){let r=Va(t,"plugins","claude-code",".claude-plugin","plugin.json"),n;try{n=JSON.parse(XP(r,"utf8"))}catch(c){e.push({detector:ko,severity:"info",message:`plugin.json not loaded: ${c.message}`});return}let i=n.ironclad?.current?.detectors;if(!i)return;let o=i.match(/^(\d+)\/(\d+)$/);if(!o){e.push({detector:ko,severity:"warn",message:`plugin.json current.detectors='${i}' is not in 'N/M' form`});return}let s=Number(o[1]),a=LOe(t);s!==a&&e.push({detector:ko,severity:"error",message:`plugin.json current.detectors='${i}' but stages/detectors/contains ${a} non-index .ts file(s)`})}function UOe(t,e){for(let r of J8){let n=Va(t,r.path);if(!Zl(n))continue;let i=$p(n);if(!i){e.push({detector:ko,severity:"warn",message:`${r.host}: ${r.path} could not be parsed as JSON`});continue}for(let o of r.required)(i[o]===void 0||i[o]===null||i[o]==="")&&e.push({detector:ko,severity:"error",message:`${r.host}: ${r.path} is missing required field '${String(o)}'`})}}function qOe(t,e){let r=$p(Va(t,"package.json"));if(!r?.version)return;let n=r.version;for(let o of J8){let s=Va(t,o.path);if(!Zl(s))continue;let a=$p(s);a?.version&&a.version!==n&&e.push({detector:ko,severity:"error",message:`${o.host}: ${o.path} version='${a.version}' but package.json version='${n}' \u2014 bump them in lockstep`})}let i=Va(t,".claude-plugin","marketplace.json");if(Zl(i)){let o=$p(i);for(let s of o?.plugins??[])s?.version&&s.version!==n&&e.push({detector:ko,severity:"error",message:`marketplace: .claude-plugin/marketplace.json plugin '${s.name??"?"}' version='${s.version}' but package.json version='${n}' \u2014 the catalog advertises a stale version; bump it in lockstep`})}}function BOe(t){let e=t.match(/TIER_STAGES[\s\S]*?\ball:\s*\[([^\]]*)\]/);return e?[...e[1].matchAll(/['"]([^'"]+)['"]/g)].map(r=>r[1]):[]}function HOe(t,e){let r=Va(t,"src","cli","clad.ts"),n=Va(t,"plugins","claude-code",".claude-plugin","plugin.json");if(!Zl(r)||!Zl(n))return;let i=BOe(XP(r,"utf8"));if(i.length===0)return;let s=$p(n)?.ironclad?.current?.["stages-implemented"];if(!Array.isArray(s))return;let a=new Set(i),c=new Set(s),l=i.filter(f=>!c.has(f)),u=s.filter(f=>!a.has(f));if(l.length===0&&u.length===0)return;let d=[l.length?`missing [${l.join(", ")}]`:"",u.length?`unexpected [${u.join(", ")}]`:""].filter(Boolean).join("; ");e.push({detector:ko,severity:"error",message:`plugins/claude-code/.claude-plugin/plugin.json stages-implemented disagrees with TIER_STAGES.all (src/cli/clad.ts): ${d} \u2014 run \`npm run build:plugin\` to re-derive`})}function GOe(t){let{cwd:e="."}=t,r=[];return zOe(e,r),HOe(e,r),UOe(e,r),qOe(e,r),r}var ko,J8,Y8,X8=y(()=>{"use strict";Sp();ko="HARNESS_INTEGRITY",J8=[{host:"claude-code",path:"plugins/claude-code/.claude-plugin/plugin.json",required:["name","version"]},{host:"codex",path:"plugins/codex/.codex-plugin/plugin.json",required:["name","version","description"]},{host:"gemini-cli",path:"plugins/gemini-cli/gemini-extension.json",required:["name","version"]}];Y8={name:ko,run:GOe}});import{existsSync as ZOe,readFileSync as VOe}from"node:fs";import{join as WOe}from"node:path";function JOe(t){let{cwd:e="."}=t;return ge(e,Vv,r=>XOe(r,e))}function YOe(t){let e=WOe(t,"spec/capabilities.yaml");if(!ZOe(e))return!1;try{let r=Q8.default.parse(VOe(e,"utf8"));if(!r||typeof r!="object")return!1;let n=r.capabilities;return!Array.isArray(n)||n.length===0}catch{return!1}}function XOe(t,e){let r=t.features.length;if(r{"use strict";Q8=St(er(),1);wt();Vv="HOLLOW_GOVERNANCE",KOe=8;e5={name:Vv,run:JOe}});import{existsSync as r5,readFileSync as n5}from"node:fs";import{join as i5}from"node:path";function o5(t,e){let r=t.match(e);if(!r)return null;try{let n=JSON.parse(r[1]),i={};for(let[o,s]of Object.entries(n))typeof s=="string"&&(i[o]=s);return i}catch{return null}}function tRe(t){switch(t){case"fail":case"wiring-fail":return 0;case"wiring-ok":case"wiring-only":return 1;case"verified":return 2;default:return null}}function rRe(t){switch(t){case"wiring-only":return 1;case"verified":return 2;default:return null}}function nRe(t){let e=i5(t,"README.md"),r=i5(t,"docs","dogfood","matrix.md");if(!r5(e)||!r5(r))return[];let n=o5(n5(e,"utf8"),QOe),i=o5(n5(r,"utf8"),eRe);if(!n||!i)return[];let o=[];for(let[s,a]of Object.entries(n)){let c=rRe(a);if(c===null)continue;let l=i[s]??"not-run",u=tRe(l);u!==null&&c>u&&o.push({detector:s5,severity:"warn",path:"README.md",message:`README host-claims: '${s}' claims '${a}' but the newest matrix evidence is '${l}' \u2014 the claim exceeds the evidence. Re-run \`clad doctor --hosts\` (with consent) or lower the README claim for '${s}'.`})}return o}function iRe(t){let{cwd:e="."}=t;return nRe(e)}var s5,QOe,eRe,a5,c5=y(()=>{"use strict";s5="HOST_CLAIM_DRIFT",QOe=//,eRe=//;a5={name:s5,run:iRe}});function oRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];return l5(r.features.map(i=>i.id),"feature","spec/features/",n),l5((r.scenarios??[]).map(i=>i.id),"scenario","spec/scenarios/",n),n}function l5(t,e,r,n){let i=new Map;for(let o of t)i.set(o,(i.get(o)??0)+1);for(let[o,s]of i)s>1&&n.push({detector:u5,severity:"error",message:`${e} id '${o}' appears ${s} times across ${r} \u2014 every ${e} must have a unique id; resolve the duplicate`})}var u5,d5,f5=y(()=>{"use strict";Ue();u5="ID_COLLISION";d5={name:u5,run:oRe}});import{existsSync as kp,readFileSync as QP,readdirSync as eC,statSync as sRe,writeFileSync as m5}from"node:fs";import{join as Eo}from"node:path";function p5(t){if(!kp(t))return 0;try{return eC(t).filter(e=>e.endsWith(".yaml")||e.endsWith(".yml")).length}catch{return 0}}function aRe(t){if(!kp(t))return 0;let e=0,r=[t];for(;r.length>0;){let n=r.pop(),i;try{i=eC(n)}catch{continue}for(let o of i){if(o==="node_modules"||o===".cladding"||o.startsWith("."))continue;let s=Eo(n,o),a;try{a=sRe(s)}catch{continue}a.isDirectory()?r.push(s):(o.endsWith(".test.ts")||o.endsWith(".test.tsx"))&&e++}}return e}function cRe(t){let e=Eo(t,"spec","capabilities.yaml");if(!kp(e))return 0;try{let r=Wv.default.parse(QP(e,"utf8"));return Array.isArray(r?.capabilities)?r.capabilities.length:0}catch{return 0}}function _s(t="."){let e=p5(Eo(t,"spec","features")),r=p5(Eo(t,"spec","scenarios")),n=cRe(t),i=aRe(Eo(t,"tests"));return{features:e,scenarios:r,capabilities:n,test_files:i}}function Vl(t,e){let r=Eo(t,"spec.yaml");if(!kp(r))return;let n=QP(r,"utf8"),i=lRe(n,e);i!==n&&m5(r,i)}function lRe(t,e){let r=t.includes(`\r `)?`\r `:` `,n=t.split(/\r?\n/),i=n.findIndex(d=>/^inventory:\s*$/.test(d)),o=["# Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand.","inventory:",` features: ${e.features??0}`,` scenarios: ${e.scenarios??0}`,` capabilities: ${e.capabilities??0}`,` test_files: ${e.test_files??0}`],s=d=>r===`\r @@ -270,51 +270,51 @@ ${o.join(` `)}let a=i;a>0&&/Auto-maintained by `clad sync`/.test(n[a-1])&&(a-=1);let c=i+1;for(;ci+1);)c++;let l=n.slice(0,a),u=n.slice(c);for(;l.length>0&&l[l.length-1].trim()==="";)l.pop();return l.push(""),s([...l,...o,"",...u.filter((d,f)=>!(f===0&&d.trim()===""))].join(` `).replace(/\n{3,}/g,` -`))}function Wa(t="."){let e=Eo(t,"spec","features");if(!$p(e))return!1;let r=[];for(let i of eC(e).sort())if(!(!i.endsWith(".yaml")&&!i.endsWith(".yml")))try{let o=(0,Wv.parse)(QP(Eo(e,i),"utf8"));if(!o?.id)continue;let s=o.slug??i.replace(/\.(ya?ml)$/,"");r.push(` ${o.id}: {slug: ${s}, status: ${o.status??"planned"}, modules: ${(o.modules??[]).length}}`)}catch{continue}r.sort();let n="# Cladding \xB7 Tier C \u2014 generated feature index (`clad sync`). Do not edit by hand.\n# One line per feature \u2192 1-file lookup + line-independent merges\n# (suggested .gitattributes: `spec/index.yaml merge=union`).\nfeatures:\n"+r.join(` +`))}function Wa(t="."){let e=Eo(t,"spec","features");if(!kp(e))return!1;let r=[];for(let i of eC(e).sort())if(!(!i.endsWith(".yaml")&&!i.endsWith(".yml")))try{let o=(0,Wv.parse)(QP(Eo(e,i),"utf8"));if(!o?.id)continue;let s=o.slug??i.replace(/\.(ya?ml)$/,"");r.push(` ${o.id}: {slug: ${s}, status: ${o.status??"planned"}, modules: ${(o.modules??[]).length}}`)}catch{continue}r.sort();let n="# Cladding \xB7 Tier C \u2014 generated feature index (`clad sync`). Do not edit by hand.\n# One line per feature \u2192 1-file lookup + line-independent merges\n# (suggested .gitattributes: `spec/index.yaml merge=union`).\nfeatures:\n"+r.join(` `)+` -`;return f5(Eo(t,"spec","index.yaml"),n,"utf8"),!0}var Wv,kp=y(()=>{"use strict";Wv=St(er(),1)});import{existsSync as p5,readFileSync as m5,readdirSync as aRe}from"node:fs";import{join as tC}from"node:path";function cRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=_s(e),i=r.inventory;if(!i){let s=h5.filter(([c])=>(n[c]??0)>0);if(s.length===0)return rC(e);let a=s.map(([c,l])=>`${n[c]??0} ${l}`).join(", ");return[...rC(e),{detector:Ep,severity:"warn",path:"spec.yaml",message:`spec.yaml has no inventory: block, but the project has ${a} on disk \u2014 run \`clad sync\` to record the inventory so anyone reading spec.yaml sees its real scale.`}]}let o=[];for(let[s,a]of h5){let c=i[s]??0,l=n[s]??0;c!==l&&o.push({detector:Ep,severity:"error",path:"spec.yaml",message:`spec.yaml inventory.${s} declares ${c} but the project has ${l} ${a} on disk \u2014 run \`clad sync\` (a stale inventory hides created/deleted shards from anyone reading spec.yaml).`})}return o.push(...rC(e)),o}function rC(t){let e=tC(t,"spec","index.yaml"),r=tC(t,"spec","features");if(!p5(e)||!p5(r))return[];let n=new Map;try{for(let l of m5(e,"utf8").split(` -`)){let u=l.match(/^ (F-[\w-]+):.*\bstatus:\s*['"]?([\w-]+)['"]?/);if(u){n.set(u[1],u[2]);continue}let d=l.match(/^ (F-[\w-]+):/);d&&n.set(d[1],"planned")}}catch{return[]}let i=new Map;try{for(let l of aRe(r)){if(!l.endsWith(".yaml")&&!l.endsWith(".yml"))continue;let u=m5(tC(r,l),"utf8"),d=u.match(/^id:\s*['"]?(F-[\w-]+)['"]?/m);if(!d)continue;let f=u.match(/^status:\s*['"]?([\w-]+)['"]?/m);i.set(d[1],f?f[1]:"planned")}}catch{return[]}let o=[],s=[...i.keys()].filter(l=>!n.has(l)).sort(),a=[...n.keys()].filter(l=>!i.has(l)).sort();if(s.length>0||a.length>0){let l=[];s.length>0&&l.push(`missing from index: ${s.join(", ")}`),a.length>0&&l.push(`in index but not on disk: ${a.join(", ")}`),o.push({detector:Ep,severity:"error",path:"spec/index.yaml",message:`spec/index.yaml disagrees with spec/features/ (${l.join("; ")}) \u2014 run \`clad sync\` to regenerate (a stale index silently misleads agents that trust it for lookup).`})}let c=[...i.keys()].filter(l=>n.has(l)&&n.get(l)!==i.get(l)).sort().map(l=>`${l} (index: ${n.get(l)}, shard: ${i.get(l)})`);return c.length>0&&o.push({detector:Ep,severity:"error",path:"spec/index.yaml",message:`spec/index.yaml status disagrees with spec/features/ for ${c.join("; ")} \u2014 run \`clad sync\` to regenerate (a stale status silently misleads agents that trust the index).`}),o}var Ep,h5,g5,y5=y(()=>{"use strict";kp();Ue();Ep="INVENTORY_DRIFT",h5=[["features","feature shard(s)"],["scenarios","scenario shard(s)"],["capabilities","capabilit(ies)"],["test_files","test file(s)"]];g5={name:Ep,run:cRe}});import{existsSync as lRe,readFileSync as uRe}from"node:fs";import{join as dRe}from"node:path";function pRe(t){let{cwd:e="."}=t,r=dRe(e,"src","spec","schema.json"),n=[];if(lRe(r)){let i;try{i=JSON.parse(uRe(r,"utf8"))}catch(o){n.push({detector:Ap,severity:"error",message:`spec/schema.json unreadable or invalid JSON: ${o.message}`})}if(i)for(let o of fRe)i.required?.includes(o)||n.push({detector:Ap,severity:"error",message:`spec/schema.json does not require root key '${o}'`}),i.properties?.[o]||n.push({detector:Ap,severity:"error",message:`spec/schema.json does not declare property '${o}'`})}try{let i=q(e);i.schema!==_5&&n.push({detector:Ap,severity:"error",message:`spec.yaml schema='${i.schema}' but supported version is '${_5}'`})}catch{}return n}var Ap,fRe,_5,b5,v5=y(()=>{"use strict";Ue();Ap="META_INTEGRITY",fRe=["schema","project","features"],_5="0.1";b5={name:Ap,run:pRe}});function mRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];return S5(r.features.map(i=>({id:i.id,slug:i.slug})),"features",n),S5((r.scenarios??[]).map(i=>({id:i.id,slug:i.slug})),"scenarios",n),n}function S5(t,e,r){let n=new Map;for(let i of t){if(!i.slug)continue;let o=n.get(i.slug);o?r.push({detector:w5,severity:"error",message:`slug '${i.slug}' is used by both ${o} and ${i.id} in ${e}/ \u2014 two items in the same namespace cannot share a slug; pick a different slug for one`}):n.set(i.slug,i.id)}}var w5,x5,$5=y(()=>{"use strict";Ue();w5="SLUG_CONFLICT";x5={name:w5,run:mRe}});function Wl(t){return t==="planned"||t==="in_progress"}var Kv=y(()=>{"use strict"});import{existsSync as hRe}from"node:fs";import{join as gRe}from"node:path";function yRe(t){let{cwd:e="."}=t;return ge(e,Jv,r=>_Re(r,e))}function _Re(t,e){let r=[];for(let n of t.features)for(let i of n.modules??[]){let o=gRe(e,i);hRe(o)||r.push(bRe(n.id,i,n.status))}return r}function bRe(t,e,r){return Wl(r)?{detector:Jv,severity:"info",path:e,message:`feature ${t}'s module '${e}' is not built yet \u2014 the normal state between authoring the spec entry and implementing it`}:{detector:Jv,severity:"error",path:e,message:`feature ${t} declares module '${e}' but the file does not exist`}}var Jv,Yv,nC=y(()=>{"use strict";Kv();wt();Jv="MISSING_IMPLEMENTATION";Yv={name:Jv,run:yRe}});function vRe(t){let{cwd:e="."}=t;return ge(e,iC,SRe)}function SRe(t){let e=[];for(let r of t.features)if(r.status==="done")for(let n of r.acceptance_criteria??[]){let o=(n.test_refs??[]).filter(c=>!c.startsWith("derived:")).length>0,s=(n.evidence_refs?.length??0)>0,a=!o&&!s&&(n.test_refs?.length??0)>0;!o&&!s&&e.push({detector:iC,severity:"error",message:`${r.id}.${n.id} declares no test_refs or evidence_refs \u2014 AC is unverified`+(a?" (a 'derived:' candidate exists \u2014 confirm it by removing the prefix, or author a real ref)":"")})}return e}var iC,Xv,oC=y(()=>{"use strict";wt();iC="MISSING_TESTS";Xv={name:iC,run:vRe}});import{existsSync as wRe,readFileSync as xRe}from"node:fs";import{join as k5}from"node:path";function E5(t){if(wRe(t))try{return JSON.parse(xRe(t,"utf8"))}catch{return}}function ARe(t){let{cwd:e="."}=t,r=E5(k5(e,$Re)),n=E5(k5(e,kRe));if(!r||!n)return[{detector:sC,severity:"info",message:"perf baseline or current missing \u2014 run stage_3.2 with --record first"}];let i=[];for(let[o,s]of Object.entries(r.metrics??{})){let a=n.metrics?.[o];if(!a||typeof s.value!="number"||typeof a.value!="number"||s.value===0)continue;let c=(a.value-s.value)/s.value*100;c>ERe&&i.push({detector:sC,severity:"warn",message:`${o} regressed ${c.toFixed(1)}% (baseline ${s.value}${s.unit??""} \u2192 current ${a.value}${a.unit??""})`})}return i}var sC,$Re,kRe,ERe,A5,T5=y(()=>{"use strict";sC="PERFORMANCE_DRIFT",$Re="perf/baseline.json",kRe="perf/current.json",ERe=10;A5={name:sC,run:ARe}});import{existsSync as TRe}from"node:fs";import{join as ORe}from"node:path";function IRe(t){let{cwd:e="."}=t;return ge(e,aC,r=>CRe(r,e))}function PRe(t,e){return(t.modules??[]).some(r=>TRe(ORe(e,r)))}function CRe(t,e){let r=[];for(let s of t.features)s.status!=="planned"&&s.status!=="in_progress"||PRe(s,e)||r.push(s.id);let n=RRe;if(r.length<=n)return[];let i=r.slice(0,O5).join(", "),o=r.length>O5?", \u2026":"";return[{detector:aC,severity:"warn",message:`${r.length} planned/in_progress features have NO code on disk (> ${n} tolerated) \u2014 the spec has raced ahead of the code. Work one feature end-to-end before authoring the next (docs/feature-cycle.md). Stalled: ${i}${o}`}]}var aC,RRe,O5,R5,I5=y(()=>{"use strict";wt();aC="PLANNED_BACKLOG",RRe=5,O5=8;R5={name:aC,run:IRe}});import{existsSync as DRe,readFileSync as NRe}from"node:fs";import{join as jRe}from"node:path";function LRe(t){let{cwd:e="."}=t;return ge(e,cC,r=>zRe(r,e))}function zRe(t,e){if(t.features.lengthn.includes(i))?[{detector:cC,severity:"warn",path:"docs/project-context.md",message:`${t.features.length} features but docs/project-context.md is still the unrefined init template (it still carries the placeholder prompts) \u2014 the Why/What/Purpose narrative was never filled in. Fill it in with \`clad clarify\` or by hand.`}]:[]}var cC,MRe,FRe,P5,C5=y(()=>{"use strict";wt();cC="PROJECT_CONTEXT_DRIFT",MRe=8,FRe=["Refine by hand or re-run with LLM available","What gap or pain led to this project","What does success look like"];P5={name:cC,run:LRe}});function D5(t,e,r){return e?e.filter(n=>!t.has(n)).map(n=>({detector:Qv,severity:"error",message:`${r} references unknown id '${n}'`})):[]}function URe(t){let{cwd:e="."}=t;return ge(e,Qv,qRe)}function qRe(t){let e=new Set(t.features.map(n=>n.id)),r=[];for(let n of t.features)r.push(...D5(e,n.depends_on,`feature ${n.id}.depends_on`)),n.superseded_by&&!e.has(n.superseded_by)&&r.push({detector:Qv,severity:"error",message:`feature ${n.id}.superseded_by references unknown id '${n.superseded_by}'`});for(let n of t.scenarios??[])r.push(...D5(e,n.features,`scenario ${n.id}.features`));return r}var Qv,eS,lC=y(()=>{"use strict";wt();Qv="REFERENCE_INTEGRITY";eS={name:Qv,run:URe}});function Tp(t=""){return new RegExp(BRe,t)}var BRe,uC=y(()=>{"use strict";BRe=String.raw`\bF-(?:\d{3,}|[0-9a-f]{6,8})\b`});import{existsSync as HRe,readdirSync as GRe,readFileSync as ZRe,statSync as VRe,writeFileSync as WRe}from"node:fs";import{dirname as KRe,join as Op,normalize as JRe,relative as YRe}from"node:path";function rIe(t){let e=[];for(let r of t.matchAll(tIe))if(!r[1].trim().startsWith("ignore"))for(let n of r[1].match(Tp("g"))??[])e.push(n);return[...new Set(e)].sort()}function nIe(t){return t.replace(/```[\s\S]*?```/g," ").replace(/~~~[\s\S]*?~~~/g," ").replace(/`[^`\n]*`/g," ")}function N5(t){return t.split("\\").join("/")}function iIe(t){return XRe.some(e=>t===e||t.startsWith(`${e}/`))}function oIe(t){let e=Op(t,"docs");if(!HRe(e))return[];let r=[],n=[e];for(;n.length>0;){let i=n.pop(),o;try{o=GRe(i)}catch{continue}for(let s of o){if(s.startsWith("."))continue;let a=Op(i,s),c;try{c=VRe(a)}catch{continue}let l=N5(YRe(t,a));c.isDirectory()?n.push(a):s.endsWith(".md")&&r.push(l)}}return r.sort()}function sIe(t,e){if(/^[a-z]+:/i.test(e))return null;let r=JRe(Op(KRe(t),e));return N5(r)}function Rp(t="."){let e=[];for(let r of oIe(t)){let n;try{n=ZRe(Op(t,r),"utf8")}catch{continue}let i=nIe(n),o=rIe(i);if(iIe(r)){if(o.length===0)continue;e.push({doc:r,features:o,doc_links:[]});continue}let a=n.includes(QRe)?[]:i.match(Tp("g"))??[],c=[...new Set([...a,...o])].sort(),l=new Set;for(let u of i.matchAll(eIe)){let d=sIe(r,u[1]);d&&l.add(d)}e.push({doc:r,features:c,doc_links:[...l].sort()})}return{docs:e}}function j5(t="."){let e=Rp(t);if(e.docs.length===0)return!1;let r=["# Cladding \xB7 Tier C \u2014 generated doc\u2192spec / doc\u2192doc link index (`clad sync`). Do not edit by hand.","# Source of truth is the docs themselves; DOC_LINK_INTEGRITY validates resolution.",'schema: "0.1"',"docs:"];for(let n of e.docs)n.features.length===0&&n.doc_links.length===0||(r.push(` ${JSON.stringify(n.doc)}:`),n.features.length>0&&r.push(` features: [${n.features.join(", ")}]`),n.doc_links.length>0&&r.push(` doc_links: [${n.doc_links.map(i=>JSON.stringify(i)).join(", ")}]`));return WRe(Op(t,"spec","_doc-links.yaml"),`${r.join(` +`;return m5(Eo(t,"spec","index.yaml"),n,"utf8"),!0}var Wv,Ep=y(()=>{"use strict";Wv=St(er(),1)});import{existsSync as h5,readFileSync as g5,readdirSync as uRe}from"node:fs";import{join as tC}from"node:path";function dRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=_s(e),i=r.inventory;if(!i){let s=y5.filter(([c])=>(n[c]??0)>0);if(s.length===0)return rC(e);let a=s.map(([c,l])=>`${n[c]??0} ${l}`).join(", ");return[...rC(e),{detector:Ap,severity:"warn",path:"spec.yaml",message:`spec.yaml has no inventory: block, but the project has ${a} on disk \u2014 run \`clad sync\` to record the inventory so anyone reading spec.yaml sees its real scale.`}]}let o=[];for(let[s,a]of y5){let c=i[s]??0,l=n[s]??0;c!==l&&o.push({detector:Ap,severity:"error",path:"spec.yaml",message:`spec.yaml inventory.${s} declares ${c} but the project has ${l} ${a} on disk \u2014 run \`clad sync\` (a stale inventory hides created/deleted shards from anyone reading spec.yaml).`})}return o.push(...rC(e)),o}function rC(t){let e=tC(t,"spec","index.yaml"),r=tC(t,"spec","features");if(!h5(e)||!h5(r))return[];let n=new Map;try{for(let l of g5(e,"utf8").split(` +`)){let u=l.match(/^ (F-[\w-]+):.*\bstatus:\s*['"]?([\w-]+)['"]?/);if(u){n.set(u[1],u[2]);continue}let d=l.match(/^ (F-[\w-]+):/);d&&n.set(d[1],"planned")}}catch{return[]}let i=new Map;try{for(let l of uRe(r)){if(!l.endsWith(".yaml")&&!l.endsWith(".yml"))continue;let u=g5(tC(r,l),"utf8"),d=u.match(/^id:\s*['"]?(F-[\w-]+)['"]?/m);if(!d)continue;let f=u.match(/^status:\s*['"]?([\w-]+)['"]?/m);i.set(d[1],f?f[1]:"planned")}}catch{return[]}let o=[],s=[...i.keys()].filter(l=>!n.has(l)).sort(),a=[...n.keys()].filter(l=>!i.has(l)).sort();if(s.length>0||a.length>0){let l=[];s.length>0&&l.push(`missing from index: ${s.join(", ")}`),a.length>0&&l.push(`in index but not on disk: ${a.join(", ")}`),o.push({detector:Ap,severity:"error",path:"spec/index.yaml",message:`spec/index.yaml disagrees with spec/features/ (${l.join("; ")}) \u2014 run \`clad sync\` to regenerate (a stale index silently misleads agents that trust it for lookup).`})}let c=[...i.keys()].filter(l=>n.has(l)&&n.get(l)!==i.get(l)).sort().map(l=>`${l} (index: ${n.get(l)}, shard: ${i.get(l)})`);return c.length>0&&o.push({detector:Ap,severity:"error",path:"spec/index.yaml",message:`spec/index.yaml status disagrees with spec/features/ for ${c.join("; ")} \u2014 run \`clad sync\` to regenerate (a stale status silently misleads agents that trust the index).`}),o}var Ap,y5,_5,b5=y(()=>{"use strict";Ep();Ue();Ap="INVENTORY_DRIFT",y5=[["features","feature shard(s)"],["scenarios","scenario shard(s)"],["capabilities","capabilit(ies)"],["test_files","test file(s)"]];_5={name:Ap,run:dRe}});import{existsSync as fRe,readFileSync as pRe}from"node:fs";import{join as mRe}from"node:path";function gRe(t){let{cwd:e="."}=t,r=mRe(e,"src","spec","schema.json"),n=[];if(fRe(r)){let i;try{i=JSON.parse(pRe(r,"utf8"))}catch(o){n.push({detector:Tp,severity:"error",message:`spec/schema.json unreadable or invalid JSON: ${o.message}`})}if(i)for(let o of hRe)i.required?.includes(o)||n.push({detector:Tp,severity:"error",message:`spec/schema.json does not require root key '${o}'`}),i.properties?.[o]||n.push({detector:Tp,severity:"error",message:`spec/schema.json does not declare property '${o}'`})}try{let i=q(e);i.schema!==v5&&n.push({detector:Tp,severity:"error",message:`spec.yaml schema='${i.schema}' but supported version is '${v5}'`})}catch{}return n}var Tp,hRe,v5,S5,w5=y(()=>{"use strict";Ue();Tp="META_INTEGRITY",hRe=["schema","project","features"],v5="0.1";S5={name:Tp,run:gRe}});function yRe(t){let{cwd:e="."}=t,r;try{r=q(e)}catch{return[]}let n=[];return x5(r.features.map(i=>({id:i.id,slug:i.slug})),"features",n),x5((r.scenarios??[]).map(i=>({id:i.id,slug:i.slug})),"scenarios",n),n}function x5(t,e,r){let n=new Map;for(let i of t){if(!i.slug)continue;let o=n.get(i.slug);o?r.push({detector:$5,severity:"error",message:`slug '${i.slug}' is used by both ${o} and ${i.id} in ${e}/ \u2014 two items in the same namespace cannot share a slug; pick a different slug for one`}):n.set(i.slug,i.id)}}var $5,k5,E5=y(()=>{"use strict";Ue();$5="SLUG_CONFLICT";k5={name:$5,run:yRe}});function Wl(t){return t==="planned"||t==="in_progress"}var Kv=y(()=>{"use strict"});import{existsSync as _Re}from"node:fs";import{join as bRe}from"node:path";function vRe(t){let{cwd:e="."}=t;return ge(e,Jv,r=>SRe(r,e))}function SRe(t,e){let r=[];for(let n of t.features)for(let i of n.modules??[]){let o=bRe(e,i);_Re(o)||r.push(wRe(n.id,i,n.status))}return r}function wRe(t,e,r){return Wl(r)?{detector:Jv,severity:"info",path:e,message:`feature ${t}'s module '${e}' is not built yet \u2014 the normal state between authoring the spec entry and implementing it`}:{detector:Jv,severity:"error",path:e,message:`feature ${t} declares module '${e}' but the file does not exist`}}var Jv,Yv,nC=y(()=>{"use strict";Kv();wt();Jv="MISSING_IMPLEMENTATION";Yv={name:Jv,run:vRe}});function xRe(t){let{cwd:e="."}=t;return ge(e,iC,$Re)}function $Re(t){let e=[];for(let r of t.features)if(r.status==="done")for(let n of r.acceptance_criteria??[]){let o=(n.test_refs??[]).filter(c=>!c.startsWith("derived:")).length>0,s=(n.evidence_refs?.length??0)>0,a=!o&&!s&&(n.test_refs?.length??0)>0;!o&&!s&&e.push({detector:iC,severity:"error",message:`${r.id}.${n.id} declares no test_refs or evidence_refs \u2014 AC is unverified`+(a?" (a 'derived:' candidate exists \u2014 confirm it by removing the prefix, or author a real ref)":"")})}return e}var iC,Xv,oC=y(()=>{"use strict";wt();iC="MISSING_TESTS";Xv={name:iC,run:xRe}});import{existsSync as kRe,readFileSync as ERe}from"node:fs";import{join as A5}from"node:path";function T5(t){if(kRe(t))try{return JSON.parse(ERe(t,"utf8"))}catch{return}}function RRe(t){let{cwd:e="."}=t,r=T5(A5(e,ARe)),n=T5(A5(e,TRe));if(!r||!n)return[{detector:sC,severity:"info",message:"perf baseline or current missing \u2014 run stage_3.2 with --record first"}];let i=[];for(let[o,s]of Object.entries(r.metrics??{})){let a=n.metrics?.[o];if(!a||typeof s.value!="number"||typeof a.value!="number"||s.value===0)continue;let c=(a.value-s.value)/s.value*100;c>ORe&&i.push({detector:sC,severity:"warn",message:`${o} regressed ${c.toFixed(1)}% (baseline ${s.value}${s.unit??""} \u2192 current ${a.value}${a.unit??""})`})}return i}var sC,ARe,TRe,ORe,O5,R5=y(()=>{"use strict";sC="PERFORMANCE_DRIFT",ARe="perf/baseline.json",TRe="perf/current.json",ORe=10;O5={name:sC,run:RRe}});import{existsSync as IRe}from"node:fs";import{join as PRe}from"node:path";function DRe(t){let{cwd:e="."}=t;return ge(e,aC,r=>jRe(r,e))}function NRe(t,e){return(t.modules??[]).some(r=>IRe(PRe(e,r)))}function jRe(t,e){let r=[];for(let s of t.features)s.status!=="planned"&&s.status!=="in_progress"||NRe(s,e)||r.push(s.id);let n=CRe;if(r.length<=n)return[];let i=r.slice(0,I5).join(", "),o=r.length>I5?", \u2026":"";return[{detector:aC,severity:"warn",message:`${r.length} planned/in_progress features have NO code on disk (> ${n} tolerated) \u2014 the spec has raced ahead of the code. Work one feature end-to-end before authoring the next (docs/feature-cycle.md). Stalled: ${i}${o}`}]}var aC,CRe,I5,P5,C5=y(()=>{"use strict";wt();aC="PLANNED_BACKLOG",CRe=5,I5=8;P5={name:aC,run:DRe}});import{existsSync as MRe,readFileSync as FRe}from"node:fs";import{join as LRe}from"node:path";function qRe(t){let{cwd:e="."}=t;return ge(e,cC,r=>BRe(r,e))}function BRe(t,e){if(t.features.lengthn.includes(i))?[{detector:cC,severity:"warn",path:"docs/project-context.md",message:`${t.features.length} features but docs/project-context.md is still the unrefined init template (it still carries the placeholder prompts) \u2014 the Why/What/Purpose narrative was never filled in. Fill it in with \`clad clarify\` or by hand.`}]:[]}var cC,zRe,URe,D5,N5=y(()=>{"use strict";wt();cC="PROJECT_CONTEXT_DRIFT",zRe=8,URe=["Refine by hand or re-run with LLM available","What gap or pain led to this project","What does success look like"];D5={name:cC,run:qRe}});function j5(t,e,r){return e?e.filter(n=>!t.has(n)).map(n=>({detector:Qv,severity:"error",message:`${r} references unknown id '${n}'`})):[]}function HRe(t){let{cwd:e="."}=t;return ge(e,Qv,GRe)}function GRe(t){let e=new Set(t.features.map(n=>n.id)),r=[];for(let n of t.features)r.push(...j5(e,n.depends_on,`feature ${n.id}.depends_on`)),n.superseded_by&&!e.has(n.superseded_by)&&r.push({detector:Qv,severity:"error",message:`feature ${n.id}.superseded_by references unknown id '${n.superseded_by}'`});for(let n of t.scenarios??[])r.push(...j5(e,n.features,`scenario ${n.id}.features`));return r}var Qv,eS,lC=y(()=>{"use strict";wt();Qv="REFERENCE_INTEGRITY";eS={name:Qv,run:HRe}});function Op(t=""){return new RegExp(ZRe,t)}var ZRe,uC=y(()=>{"use strict";ZRe=String.raw`\bF-(?:\d{3,}|[0-9a-f]{6,8})\b`});import{existsSync as VRe,readdirSync as WRe,readFileSync as KRe,statSync as JRe,writeFileSync as YRe}from"node:fs";import{dirname as XRe,join as Rp,normalize as QRe,relative as eIe}from"node:path";function oIe(t){let e=[];for(let r of t.matchAll(iIe))if(!r[1].trim().startsWith("ignore"))for(let n of r[1].match(Op("g"))??[])e.push(n);return[...new Set(e)].sort()}function sIe(t){return t.replace(/```[\s\S]*?```/g," ").replace(/~~~[\s\S]*?~~~/g," ").replace(/`[^`\n]*`/g," ")}function M5(t){return t.split("\\").join("/")}function aIe(t){return tIe.some(e=>t===e||t.startsWith(`${e}/`))}function cIe(t){let e=Rp(t,"docs");if(!VRe(e))return[];let r=[],n=[e];for(;n.length>0;){let i=n.pop(),o;try{o=WRe(i)}catch{continue}for(let s of o){if(s.startsWith("."))continue;let a=Rp(i,s),c;try{c=JRe(a)}catch{continue}let l=M5(eIe(t,a));c.isDirectory()?n.push(a):s.endsWith(".md")&&r.push(l)}}return r.sort()}function lIe(t,e){if(/^[a-z]+:/i.test(e))return null;let r=QRe(Rp(XRe(t),e));return M5(r)}function Ip(t="."){let e=[];for(let r of cIe(t)){let n;try{n=KRe(Rp(t,r),"utf8")}catch{continue}let i=sIe(n),o=oIe(i);if(aIe(r)){if(o.length===0)continue;e.push({doc:r,features:o,doc_links:[]});continue}let a=n.includes(rIe)?[]:i.match(Op("g"))??[],c=[...new Set([...a,...o])].sort(),l=new Set;for(let u of i.matchAll(nIe)){let d=lIe(r,u[1]);d&&l.add(d)}e.push({doc:r,features:c,doc_links:[...l].sort()})}return{docs:e}}function F5(t="."){let e=Ip(t);if(e.docs.length===0)return!1;let r=["# Cladding \xB7 Tier C \u2014 generated doc\u2192spec / doc\u2192doc link index (`clad sync`). Do not edit by hand.","# Source of truth is the docs themselves; DOC_LINK_INTEGRITY validates resolution.",'schema: "0.1"',"docs:"];for(let n of e.docs)n.features.length===0&&n.doc_links.length===0||(r.push(` ${JSON.stringify(n.doc)}:`),n.features.length>0&&r.push(` features: [${n.features.join(", ")}]`),n.doc_links.length>0&&r.push(` doc_links: [${n.doc_links.map(i=>JSON.stringify(i)).join(", ")}]`));return YRe(Rp(t,"spec","_doc-links.yaml"),`${r.join(` `)} -`,"utf8"),!0}var XRe,QRe,eIe,tIe,tS=y(()=>{"use strict";uC();XRe=["docs/ab-evaluation","docs/ab-evaluation-extended","docs/dogfood","docs/benchmarks"],QRe="clad-doc-links: ignore",eIe=/\]\(\s*([^)\s]+?\.md)(?:#[^)]*)?\s*\)/g,tIe=/clad-doc-links:[ \t]*([^\n>]*)/g});import{existsSync as aIe}from"node:fs";import{join as cIe}from"node:path";function lIe(t){let{cwd:e="."}=t;return ge(e,rS,r=>uIe(r,e))}function uIe(t,e){let r=new Set((t.features??[]).map(i=>i.id)),n=[];for(let i of Rp(e).docs){for(let o of i.doc_links)aIe(cIe(e,o))||n.push({detector:rS,severity:"error",path:i.doc,message:`doc '${i.doc}' links to missing file '${o}'`});for(let o of i.features)r.has(o)||n.push({detector:rS,severity:"warn",path:i.doc,message:`doc '${i.doc}' references unknown feature '${o}' \u2014 archived/renamed? If it is an illustrative example, add a \`clad-doc-links: ignore\` marker to the doc.`})}return n}var rS,nS,dC=y(()=>{"use strict";tS();wt();rS="DOC_LINK_INTEGRITY";nS={name:rS,run:lIe}});function dIe(t){let{cwd:e="."}=t;return ge(e,Ip,r=>fIe(r))}function fIe(t){let e=[],r=t.features.length,n=t.scenarios??[],i=r>=M5,o=t.project.onboarding_seeded===!0&&!i;r>=M5&&n.length===0&&e.push({detector:Ip,severity:"warn",path:"spec/scenarios/",message:`${r} features but no scenarios declared \u2014 cross-feature user-journey flows are not captured. Author at least one with \`clad_create_scenario\`.`});for(let a of n)(a.features??[]).length===0&&e.push({detector:Ip,severity:o?"info":"warn",path:"spec/scenarios/",message:o?`scenario ${a.id} binds no features yet \u2014 retained as future onboarding intent; bind it when a matching feature lands.`:`scenario ${a.id} binds no features (features: []) \u2014 a scenario must cover at least one feature's flow, or it should be removed.`});let s=new Map(t.features.filter(a=>typeof a.slug=="string"&&a.slug.length>0).map(a=>[a.slug,a.id]));for(let a of n){if(!a.flow)continue;let c=new Set(a.features??[]),l=new Map;for(let u of a.flow.matchAll(/\(([^)]+)\)/g))for(let d of u[1].split(/[,/·]/)){let f=d.trim(),p=s.get(f);p&&!c.has(p)&&l.set(f,p)}if(l.size>0){let u=[...l].map(([d,f])=>`${d} (${f})`).join(", ");e.push({detector:Ip,severity:"warn",path:"spec/scenarios/",message:`scenario ${a.id} flow references ${u} but features[] does not bind ${l.size===1?"it":"them"} \u2014 bind every feature the flow walks, or trim the flow so coverage is not under-stated.`})}}return e}var Ip,M5,F5,L5=y(()=>{"use strict";wt();Ip="SCENARIO_COVERAGE",M5=8;F5={name:Ip,run:dIe}});import{createHash as pIe}from"node:crypto";function mIe(t){return!Number.isFinite(t)||t<=0?0:t>=1?1:t}function Pp(t,e=0){if(t.oracle_policy){let r=t.oracle_policy;return{mandateActive:!0,reportOnly:!1,exhaustive:!1,alwaysEars:new Set(r.always_ears??z5),sample:mIe(r.sample??0)}}return t.require_oracles===!0?{mandateActive:!0,reportOnly:!1,exhaustive:!0,alwaysEars:new Set,sample:1}:t.require_oracles===void 0&&e>=8?{mandateActive:!0,reportOnly:!0,exhaustive:!1,alwaysEars:new Set(z5),sample:0}:{mandateActive:!1,reportOnly:!1,exhaustive:!1,alwaysEars:new Set,sample:0}}function Cp(t){return(t.features??[]).filter(e=>e.status==="done").length}function hIe(t,e){return e<=0?!1:e>=1?!0:parseInt(pIe("sha256").update(t).digest("hex").slice(0,8),16)%1e40})}return r}var z5,iS=y(()=>{"use strict";z5=["unwanted"]});import{chmodSync as gIe,existsSync as q5,readFileSync as yIe,readdirSync as _Ie,statSync as B5,unlinkSync as bIe,utimesSync as vIe,writeFileSync as SIe}from"node:fs";import{join as H5}from"node:path";import G5 from"node:process";function wIe(t){return tJ(t).map(e=>{try{let r=B5(e);return r.isFile()?{path:e,body:yIe(e),mode:r.mode,atime:r.atime,mtime:r.mtime}:{path:e,nonFile:!0}}catch(r){if(r.code==="ENOENT")return{path:e};throw r}})}function xIe(t){let e=[];for(let r of t)if(!r.nonFile)try{if(r.body===void 0){if(!q5(r.path))continue;if(!B5(r.path).isFile()){e.push(`${r.path}: scoped oracle run created a non-file report candidate`);continue}bIe(r.path);continue}SIe(r.path,r.body),r.mode!==void 0&&gIe(r.path,r.mode),r.atime&&r.mtime&&vIe(r.path,r.atime,r.mtime)}catch(n){e.push(`${r.path}: ${n.message}`)}return e}function $Ie(t){let e=!1,r=n=>{for(let i of _Ie(n,{withFileTypes:!0})){if(e)return;let o=H5(n,i.name);i.isDirectory()?r(o):(/\.(test|spec)\.[cm]?[jt]sx?$/.test(i.name)||/_test\.py$/.test(i.name))&&(e=!0)}};try{r(t)}catch{}return e}function fC(t={}){let{cwd:e="."}=t,r=H5(e,bs);if(!q5(r)||!$Ie(r))return{stage:Ka,pass:!1,exitCode:2,stderr:`no spec-conformance oracles under ${bs}/ \u2014 skipped`};let n=dt(e),i=n.gates.test;if(!i?.cmd||!i.args)return{stage:Ka,pass:!1,exitCode:2,stderr:`no test runner registered for language '${n.language}'`};let o;try{o=wIe(e)}catch(d){return{stage:Ka,pass:!1,exitCode:1,stderr:`could not preserve the full test report before the scoped oracle run: ${d.message}`}}let s,a,c=[...i.args,bs];try{s=We(i.cmd,c,{cwd:e,reject:!1})}catch(d){a=d}let l=xIe(o);if(l.length>0)return{stage:Ka,pass:!1,exitCode:1,stderr:`could not restore the full test report after the scoped oracle run: ${l.join("; ")}`};if(a||!s)return{stage:Ka,pass:!1,exitCode:1,stderr:`oracle runner failed to start: ${a?.message??"unknown error"}`};let u=Nt(Ka,i.cmd,s,c);return u||Yt(Ka,s)}var Ka,bs,kIe,pC=y(()=>{"use strict";Mr();sn();dp();Rn();Ka="stage_2.3",bs="tests/oracle";kIe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${G5.argv[1]}`;if(kIe){let t=fC();console.log(JSON.stringify(t)),G5.exit(t.exitCode)}});import{existsSync as EIe}from"node:fs";import{join as AIe}from"node:path";function TIe(t){let{cwd:e="."}=t;return ge(e,ii,r=>OIe(r,e))}function OIe(t,e){let r=[],n=Pp(t.project,Cp(t)),i=n.reportOnly?"info":"error",o=n.mandateActive?In(e):[],s=o.filter(l=>l.kind==="oracle"),a=new Set(["agent:developer","agent:specialists"]),c=l=>o.find(u=>u.featureId===l&&a.has(u.stage))?.identity.name;for(let l of t.features)if(l.status==="done")for(let u of l.acceptance_criteria??[]){let d=u.oracle_refs??[];if(Dp(n,l.id,u)&&d.length===0){let f=n.exhaustive?"project.require_oracles is set":u.ears&&n.alwaysEars.has(u.ears)?`oracle_policy.always_ears includes '${u.ears}'`:"selected by oracle_policy.sample";r.push({detector:ii,severity:i,message:`${l.id}.${u.id} done AC lacks a spec-conformance oracle (${f}; declare oracle_refs under ${bs}/)`+(n.reportOnly?" [report-only \u2014 the graduated default enforces in 0.7]":"")})}for(let f of d){if(!EIe(AIe(e,f))){r.push({detector:ii,severity:"error",path:f,message:`${l.id}.${u.id} oracle_ref '${f}' resolves to nothing on disk`});continue}if(f.startsWith(`${bs}/`)||r.push({detector:ii,severity:"warn",path:f,message:`${l.id}.${u.id} oracle_ref '${f}' lives outside ${bs}/ \u2014 stage_2.3 only runs ${bs}/, so this oracle will not execute`}),!n.mandateActive)continue;let p=s.find(g=>g.featureId===l.id&&g.acId===u.id&&g.artifact===f);if(!p){r.push({detector:ii,severity:"error",path:f,message:`${l.id}.${u.id} oracle '${f}' has no authoring-provenance record \u2014 author it via 'clad oracle' (or clad_author_oracle) so impl-blindness can be verified`});continue}let m=c(l.id);m&&p.identity.name===m?r.push({detector:ii,severity:"error",path:f,message:`${l.id}.${u.id} oracle '${f}' is NOT impl-blind: authored by the implementer ('${m}')`}):m||r.push({detector:ii,severity:"info",message:`${l.id}.${u.id} oracle author\u2260implementer not verified \u2014 no implementer identity recorded (no clad run history to compare)`});let h=(p.readManifest??[]).filter(g=>(l.modules??[]).includes(g));h.length>0&&r.push({detector:ii,severity:"error",path:f,message:`${l.id}.${u.id} oracle '${f}' is NOT impl-blind: author read implementation file(s) the feature owns (${h.join(", ")})`}),p.blind===!1&&r.push({detector:ii,severity:"info",message:`${l.id}.${u.id} oracle '${f}' provenance is self-reported (host-protocol), not cladding-controlled \u2014 manifest checked, blindness unproven`})}}if(n.mandateActive&&!n.exhaustive){let l=t.features.filter(u=>u.status==="done").flatMap(u=>u.acceptance_criteria??[]).filter(u=>!u.ears).length;l>0&&r.push({detector:ii,severity:"info",message:`${l} done AC(s) carry no EARS tag and are invisible to the risk-weighted oracle mandate \u2014 tag them (ubiquitous/event/state/optional/unwanted/complex) for the mandate to mean anything.`})}return r}var ii,Z5,V5=y(()=>{"use strict";ni();iS();pC();wt();ii="SPEC_CONFORMANCE";Z5={name:ii,run:TIe}});function RIe(t){let{cwd:e="."}=t,r=In(e);if(r.length===0)return[{detector:mC,severity:"info",message:"no audit log present \u2014 detector is opt-in on prior stage_4 runs"}];let n=Date.now(),i=[];for(let o of r){let s=Date.parse(o.identity.timestamp);if(Number.isNaN(s))continue;let a=(n-s)/(1e3*60*60*24);a>W5&&i.push({detector:mC,severity:"warn",message:`evidence ${o.id} is ${Math.round(a)} days old (floor ${W5})`})}return i}var mC,W5,K5,J5=y(()=>{"use strict";ni();mC="STALE_EVIDENCE",W5=90;K5={name:mC,run:RIe}});import{existsSync as Y5}from"node:fs";import{join as X5}from"node:path";function IIe(t){let{cwd:e="."}=t;return ge(e,Kl,r=>PIe(r,e))}function PIe(t,e){let r=[];for(let n of t.features){if(n.archived_at&&n.status!=="archived"&&r.push({detector:Kl,severity:"warn",message:`feature ${n.id} has archived_at but status='${n.status}' (expected 'archived')`,suggestion:{action:"propose-archive",args:{featureId:n.id,reason:`archived_at already set but status is '${n.status}'`}}}),n.superseded_by&&!n.archived_at&&r.push({detector:Kl,severity:"warn",message:`feature ${n.id} has superseded_by but no archived_at`,suggestion:{action:"propose-archive",args:{featureId:n.id,reason:`superseded by ${n.superseded_by} but missing archived_at`}}}),n.status==="archived"){let i=(n.modules??[]).filter(o=>Y5(X5(e,o)));i.length>0&&r.push({detector:Kl,severity:"warn",message:`feature ${n.id} is archived but ${i.length} module(s) still exist: ${i.join(", ")}`})}Wl(n.status)&&(n.modules?.length??0)>0&&!(n.modules??[]).some(i=>Y5(X5(e,i)))&&r.push({detector:Kl,severity:"info",message:`feature ${n.id} (status='${n.status}') declares ${n.modules?.length??0} module(s) that aren't built yet \u2014 the normal state while implementing (not stale)`})}return r}var Kl,oS,hC=y(()=>{"use strict";Kv();wt();Kl="STALE_SPECIFICATION";oS={name:Kl,run:IIe}});import{existsSync as Q5,statSync as eY}from"node:fs";import{join as tY}from"node:path";function DIe(t,e){let r=0;for(let n of e){let i=tY(t,n);if(!Q5(i))continue;let o=eY(i).mtimeMs;o>r&&(r=o)}return r}function NIe(t){let{cwd:e="."}=t;return ge(e,gC,r=>jIe(r,e))}function jIe(t,e){let r=Fi(e,t.project?.language),n=t.features.flatMap(a=>a.modules??[]),i=DIe(e,n);if(i===0)return[];let o=ys([...r.testGlobs],{cwd:e,dot:!1});if(o.length===0)return[];let s=[];for(let a of o){let c=tY(e,a);if(!Q5(c))continue;let l=eY(c).mtimeMs,u=(i-l)/(1e3*60*60*24);u>CIe&&s.push({detector:gC,severity:"warn",path:a,message:`${a} is ${Math.round(u)} days older than newest source module`})}return s}var gC,CIe,sS,yC=y(()=>{"use strict";vp();Ba();wt();gC="STALE_TESTS",CIe=30;sS={name:gC,run:NIe}});import{existsSync as MIe}from"node:fs";import{join as FIe}from"node:path";function LIe(t){let{cwd:e="."}=t;return ge(e,Np,r=>zIe(r,e))}function zIe(t,e){let r=[];for(let n of t.features){let i=n.modules??[],o=n.acceptance_criteria??[];if(n.status==="done"&&i.length===0&&o.length===0){r.push({detector:Np,severity:"error",message:`feature ${n.id} status='done' but declares no modules and no acceptance_criteria \u2014 nothing to verify (hollow completion)`});continue}if(i.length===0)continue;let s=i.filter(a=>!MIe(FIe(e,a)));s.length!==0&&(n.status==="done"?r.push({detector:Np,severity:"error",message:`feature ${n.id} status='done' but ${s.length}/${i.length} module(s) missing: ${s.join(", ")}`}):n.status==="in_progress"&&s.length===i.length&&r.push({detector:Np,severity:Wl(n.status)?"info":"warn",message:`feature ${n.id} is in progress and none of its declared modules are built yet \u2014 the normal state while implementing`}))}return r}var Np,aS,_C=y(()=>{"use strict";Kv();wt();Np="STATUS_DRIFT";aS={name:Np,run:LIe}});function UIe(t){let{cwd:e="."}=t;return ge(e,cS,r=>qIe(r,e))}function qIe(t,e){let r=dt(e).language;return r==="unknown"?[{detector:cS,severity:"info",message:"no manifest matched \u2014 language cannot be cross-checked"}]:t.project.language===r?[]:[{detector:cS,severity:"warn",message:`spec.project.language='${t.project.language}' but the manifest chain detects '${r}'`}]}var cS,rY,nY=y(()=>{"use strict";sn();wt();cS="TECH_STACK_MISMATCH";rY={name:cS,run:UIe}});function ZIe(t){if((t.features??[]).length`${i}/${o}/**/*.${n}`)}function VIe(t){let{cwd:e="."}=t;return ge(e,bC,r=>WIe(r,e))}function WIe(t,e){let r=new Set;for(let o of t.features)for(let s of o.modules??[])r.add(s);let n=ys([...ZIe(t)],{cwd:e,dot:!1}),i=[];for(let o of n)r.has(o)||i.push({detector:bC,severity:"error",path:o,message:`file '${o}' is not claimed by any feature in spec.yaml`});return i}var bC,iY,BIe,HIe,GIe,lS,vC=y(()=>{"use strict";vp();HP();wt();bC="UNMAPPED_ARTIFACT",iY=["src/stages/**/*.ts","src/spec/**/*.ts"],BIe={typescript:"ts",javascript:"js",python:"py",rust:"rs",go:"go",kotlin:"kt"},HIe={kotlin:"src/main/kotlin"},GIe=8;lS={name:bC,run:VIe}});import{existsSync as oY}from"node:fs";import{join as sY}from"node:path";function JIe(t){return KIe.some(e=>t.startsWith(e))}function YIe(t){let{cwd:e="."}=t;return ge(e,SC,r=>XIe(r,e))}function XIe(t,e){let r=[];for(let n of t.features)if(n.status==="done")for(let i of n.acceptance_criteria??[])for(let o of i.test_refs??[]){if(JIe(o))continue;let s=o.split("#",1)[0];oY(sY(e,o))||s&&oY(sY(e,s))||r.push({detector:SC,severity:"error",path:o,message:`${n.id}.${i.id} test_ref '${o}' resolves to nothing on disk \u2014 a test_ref must be a real file path (e.g. 'tests/x.test.ts', optionally with a '#' anchor) or a 'self-dogfood: +`}function ate(t){let e=new Map(t.nodes.map(s=>[s.id,s])),r=new Map,n=new Map;for(let s of t.edges)(r.get(s.from)??r.set(s.from,[]).get(s.from)).push({other:s.to,kind:s.kind}),(n.get(s.to)??n.set(s.to,[]).get(s.to)).push({other:s.from,kind:s.kind});let i=s=>{let a=e.get(s);return a?`[[${nte(a)}|${a.label.replace(/[[\]|]/g," ")}]]`:`[[${s.replace(/[[\]|]/g," ")}]]`},o=new Map;for(let s of t.nodes){let a=["---",`kind: ${s.kind}`,...s.tier?[`tier: ${s.tier}`]:[],...s.status?[`status: ${s.status}`]:[],`id: ${JSON.stringify(s.id)}`,"---",`# ${s.label}`,""],c=(r.get(s.id)??[]).slice().sort(ite);if(c.length>0){a.push("## Links");for(let u of c)a.push(`- ${u.kind} \u2192 ${i(u.other)}`);a.push("")}let l=(n.get(s.id)??[]).slice().sort(ite);if(l.length>0){a.push("## Backlinks");for(let u of l)a.push(`- ${i(u.other)} \u2192 ${u.kind}`);a.push("")}o.set(`${s.kind}/${nte(s)}.md`,`${a.join(` +`)}`)}return o}function ite(t,e){return t.kind.localeCompare(e.kind)||t.other.localeCompare(e.other)}import{readFileSync as WUe}from"node:fs";import{dirname as KUe,join as Ej}from"node:path";import{fileURLToPath as JUe}from"node:url";var Aj=KUe(JUe(import.meta.url));function cte(t){for(let e of[Ej(Aj,"viewer",t),Ej(Aj,"..","graph","viewer",t),Ej(Aj,"..","..","dist","viewer",t)])try{return WUe(e,"utf8")}catch{}throw new Error(`cladding: viewer asset not found: ${t}`)}function lte(t){return JSON.stringify(t).replace(/0?` `:"";return` @@ -896,21 +896,21 @@ ${n.report.remainingQuestions} question(s) left. continue with \`clad clarify ${n} -`}WP();dC();nC();oC();lC();VP();yC();_C();vC();wC();Jm();uC();Ue();var WUe=[Xv,uS,Yv,lS,eS,nS,Zv,aS,sS,Gv];function KUe(t,e){if(t.path){let n=t.path.split("#")[0].trim(),i=[qe.module(n),qe.test(n),qe.doc(n)].filter(o=>e.has(o));if(i.length>0)return i}let r=Tp().exec(t.message??"");return r&&e.has(qe.feature(r[0]))?[qe.feature(r[0])]:[]}function Fx(t,e="."){let r=new Set(t.nodes.map(o=>o.id)),n={};try{Ea(e,q(e))}catch{}try{for(let o of WUe){let s=[];try{s=o.run({cwd:e})}catch{continue}for(let a of s)if(!(a.severity!=="error"&&a.severity!=="warn"))for(let c of KUe(a,r)){let l=n[c]??(n[c]={severity:"warn",count:0,detectors:new Set});l.count+=1,l.detectors.add(a.detector),a.severity==="error"&&(l.severity="error")}}}finally{Ea(e,null)}let i={};for(let o of Object.keys(n).sort()){let s=n[o];i[o]={severity:s.severity,count:s.count,detectors:[...s.detectors].sort()}}return i}Aj();Ue();Ii();var YUe=new Set(["mermaid","dot","json","obsidian","html"]);function cte(t={}){try{let e=t.format??"mermaid";if(!YUe.has(e)){L("fail","graph",`unknown --format '${e}' \u2014 use mermaid | dot | json | obsidian | html`),process.exit(1);return}let r=e,n=q(),i=wc(n,".");if(t.focus){let s=Px(n,i,t.focus);if(s.length===0){L("fail","graph",`no node matches '${t.focus}' \u2014 try a feature id (F-\u2026), slug, or module path`),process.exit(1);return}let a=t.depth!==void 0?Number(t.depth):1/0;if(Number.isNaN(a)||a<0){L("fail","graph",`--depth must be a non-negative number, got '${t.depth}'`),process.exit(1);return}i=Ix(i,s,a)}if(r==="obsidian"){let s=t.out??".cladding/graph",a=ite(i);for(let[c,l]of a){let u=JUe(s,c);Tj(Rj(u),{recursive:!0}),Oj(u,l,"utf8")}L("pass","graph",`wrote ${a.size} note(s) to ${s} \u2014 open it as an Obsidian vault`),process.exit(0);return}if(r==="html"){if(!t.out){L("fail","graph","--format html requires --out (a single self-contained .html file)"),process.exit(1);return}let s=Mx(i,Fx(i,"."));Tj(Rj(t.out),{recursive:!0}),Oj(t.out,s,"utf8"),L("pass","graph",`wrote a self-contained viewer to ${t.out} \u2014 open it in a browser (offline)`),process.exit(0);return}let o=r==="dot"?nte(i):r==="json"?jx(i):rte(i);t.out?(Tj(Rj(t.out),{recursive:!0}),Oj(t.out,o,"utf8"),L("pass","graph",`wrote ${r} graph to ${t.out}`),process.exit(0)):process.stdout.write(o,()=>process.exit(0))}catch(e){L("fail","graph",e.message),process.exit(1)}}function lte(){try{let t=wc(q(),".");process.stdout.write(ate(Lx(t)),()=>process.exit(0))}catch(t){L("fail","graph",t.message),process.exit(1)}}Jm();import{createServer as XUe}from"node:http";import{existsSync as QUe,watch as eqe}from"node:fs";import{join as tqe}from"node:path";Ue();Ii();function rqe(t={}){let e=t.cwd??".",r=new Set,n=()=>wc(q(e),e),i=()=>{for(let u of r)try{u.write(`data: refresh +`}WP();dC();nC();oC();lC();VP();yC();_C();vC();wC();Jm();uC();Ue();var YUe=[Xv,uS,Yv,lS,eS,nS,Zv,aS,sS,Gv];function XUe(t,e){if(t.path){let n=t.path.split("#")[0].trim(),i=[qe.module(n),qe.test(n),qe.doc(n)].filter(o=>e.has(o));if(i.length>0)return i}let r=Op().exec(t.message??"");return r&&e.has(qe.feature(r[0]))?[qe.feature(r[0])]:[]}function Fx(t,e="."){let r=new Set(t.nodes.map(o=>o.id)),n={};try{Ea(e,q(e))}catch{}try{for(let o of YUe){let s=[];try{s=o.run({cwd:e})}catch{continue}for(let a of s)if(!(a.severity!=="error"&&a.severity!=="warn"))for(let c of XUe(a,r)){let l=n[c]??(n[c]={severity:"warn",count:0,detectors:new Set});l.count+=1,l.detectors.add(a.detector),a.severity==="error"&&(l.severity="error")}}}finally{Ea(e,null)}let i={};for(let o of Object.keys(n).sort()){let s=n[o];i[o]={severity:s.severity,count:s.count,detectors:[...s.detectors].sort()}}return i}Tj();Ue();Ii();var eqe=new Set(["mermaid","dot","json","obsidian","html"]);function dte(t={}){try{let e=t.format??"mermaid";if(!eqe.has(e)){L("fail","graph",`unknown --format '${e}' \u2014 use mermaid | dot | json | obsidian | html`),process.exit(1);return}let r=e,n=q(),i=wc(n,".");if(t.focus){let s=Px(n,i,t.focus);if(s.length===0){L("fail","graph",`no node matches '${t.focus}' \u2014 try a feature id (F-\u2026), slug, or module path`),process.exit(1);return}let a=t.depth!==void 0?Number(t.depth):1/0;if(Number.isNaN(a)||a<0){L("fail","graph",`--depth must be a non-negative number, got '${t.depth}'`),process.exit(1);return}i=Ix(i,s,a)}if(r==="obsidian"){let s=t.out??".cladding/graph",a=ate(i);for(let[c,l]of a){let u=QUe(s,c);Oj(Ij(u),{recursive:!0}),Rj(u,l,"utf8")}L("pass","graph",`wrote ${a.size} note(s) to ${s} \u2014 open it as an Obsidian vault`),process.exit(0);return}if(r==="html"){if(!t.out){L("fail","graph","--format html requires --out (a single self-contained .html file)"),process.exit(1);return}let s=Mx(i,Fx(i,"."));Oj(Ij(t.out),{recursive:!0}),Rj(t.out,s,"utf8"),L("pass","graph",`wrote a self-contained viewer to ${t.out} \u2014 open it in a browser (offline)`),process.exit(0);return}let o=r==="dot"?ste(i):r==="json"?jx(i):ote(i);t.out?(Oj(Ij(t.out),{recursive:!0}),Rj(t.out,o,"utf8"),L("pass","graph",`wrote ${r} graph to ${t.out}`),process.exit(0)):process.stdout.write(o,()=>process.exit(0))}catch(e){L("fail","graph",e.message),process.exit(1)}}function fte(){try{let t=wc(q(),".");process.stdout.write(ute(Lx(t)),()=>process.exit(0))}catch(t){L("fail","graph",t.message),process.exit(1)}}Jm();import{createServer as tqe}from"node:http";import{existsSync as rqe,watch as nqe}from"node:fs";import{join as iqe}from"node:path";Ue();Ii();function oqe(t={}){let e=t.cwd??".",r=new Set,n=()=>wc(q(e),e),i=()=>{for(let u of r)try{u.write(`data: refresh -`)}catch{r.delete(u)}},o=XUe((u,d)=>{let f=(u.url??"/").split("?")[0],p=(u.headers.host??"").split(":")[0];if(p&&p!=="localhost"&&p!=="127.0.0.1"&&p!=="[::1]"&&p!=="::1"){d.writeHead(403,{"Content-Type":"text/plain"}),d.end("forbidden host");return}try{if(f==="/graph.json"){let m=jx(n());d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/health.json"){let m=JSON.stringify(Fx(n(),e));d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/events"){d.writeHead(200,{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"}),d.write(`: connected +`)}catch{r.delete(u)}},o=tqe((u,d)=>{let f=(u.url??"/").split("?")[0],p=(u.headers.host??"").split(":")[0];if(p&&p!=="localhost"&&p!=="127.0.0.1"&&p!=="[::1]"&&p!=="::1"){d.writeHead(403,{"Content-Type":"text/plain"}),d.end("forbidden host");return}try{if(f==="/graph.json"){let m=jx(n());d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/health.json"){let m=JSON.stringify(Fx(n(),e));d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/events"){d.writeHead(200,{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"}),d.write(`: connected -`),r.add(d),u.on("close",()=>r.delete(d));return}if(f==="/"||f==="/index.html"){let m=Mx(n());d.writeHead(200,{"Content-Type":"text/html; charset=utf-8","Cache-Control":"no-store"}),d.end(m);return}d.writeHead(404,{"Content-Type":"text/plain"}),d.end("not found")}catch(m){if(d.headersSent)try{d.end()}catch{}else{d.writeHead(503,{"Content-Type":"application/json","Cache-Control":"no-store"});try{d.end(JSON.stringify({error:m.message}))}catch{}}}}),s=null,a=()=>{s&&clearTimeout(s),s=setTimeout(i,400)},c=[];for(let u of["spec","docs"]){let d=tqe(e,u);if(QUe(d))try{let f=eqe(d,{recursive:!0},a);f.on("error",()=>{try{f.close()}catch{}}),c.push(f)}catch{}}let l=setInterval(()=>{for(let u of r)try{u.write(`: keep-alive +`),r.add(d),u.on("close",()=>r.delete(d));return}if(f==="/"||f==="/index.html"){let m=Mx(n());d.writeHead(200,{"Content-Type":"text/html; charset=utf-8","Cache-Control":"no-store"}),d.end(m);return}d.writeHead(404,{"Content-Type":"text/plain"}),d.end("not found")}catch(m){if(d.headersSent)try{d.end()}catch{}else{d.writeHead(503,{"Content-Type":"application/json","Cache-Control":"no-store"});try{d.end(JSON.stringify({error:m.message}))}catch{}}}}),s=null,a=()=>{s&&clearTimeout(s),s=setTimeout(i,400)},c=[];for(let u of["spec","docs"]){let d=iqe(e,u);if(rqe(d))try{let f=nqe(d,{recursive:!0},a);f.on("error",()=>{try{f.close()}catch{}}),c.push(f)}catch{}}let l=setInterval(()=>{for(let u of r)try{u.write(`: keep-alive -`)}catch{r.delete(u)}},3e4);return typeof l.unref=="function"&&l.unref(),new Promise((u,d)=>{o.on("error",d),o.listen(t.port??0,"127.0.0.1",()=>{let f=o.address(),p=typeof f=="object"&&f?f.port:t.port??0;u({port:p,broadcast:i,close:()=>new Promise(m=>{s&&clearTimeout(s),clearInterval(l);for(let h of c)try{h.close()}catch{}for(let h of r)try{h.end()}catch{}r.clear(),o.close(()=>m()),typeof o.closeAllConnections=="function"&&o.closeAllConnections()})})})})}async function ute(t={}){let e=t.port!==void 0?Number(t.port):3e3;try{let r=await rqe({port:e,cwd:t.cwd??"."});L("pass","graph",`live graph at http://localhost:${r.port} \u2014 edit spec/ or docs/ and the view auto-reloads (Ctrl-C to stop)`)}catch(r){L("fail","graph",r.message),process.exit(1)}}var nqe=["stage_1.1","stage_2.1","stage_2.3"];function iqe(t){return(t.features??[]).filter(e=>e.status==="done")}function oqe(t,e){let r=iqe(t);switch(e){case"stage_1.1":return!t.project?.language||r.length===0?null:`project.language is '${t.project.language}' and ${r.length} feature(s) are done, but the type checker did not run (skipped) \u2014 type safety of shipped code was never verified. Install the language toolchain; under --strict, an unverifiable 'done' is not GREEN.`;case"stage_2.1":{let n=r.filter(i=>(i.acceptance_criteria??[]).some(o=>(o.test_refs??[]).length>0)).length;return n===0?null:`${n} done feature(s) declare tests but the test runner did not run (skipped) \u2014 the implementation was never verified. Install the test framework; under --strict, an unverifiable 'done' is not GREEN.`}case"stage_2.3":{let n=r.flatMap(i=>i.acceptance_criteria??[]).filter(i=>(i.oracle_refs??[]).length>0).length;return n===0?null:`${n} done AC(s) declare oracle_refs but the conformance runner did not run (skipped) \u2014 the declared oracles never executed. Under --strict, declared-but-unrun verification is not GREEN.`}}}function dte(t,e){let r=[];for(let n of nqe){if(!e.some(s=>s.stage===n&&s.status==="skip"))continue;let o=oqe(t,n);o&&r.push({stage:n,label:"Verification",message:o})}return r}wS();import fte from"node:process";function sqe(t,e){let r=e.filter(i=>i.acId===t),n=r.filter(i=>i.identity.author==="human");return n.length===0?{acId:t,pass:!1,totalEvidence:r.length,humanEvidence:0,reason:r.length===0?"no evidence at all":`${r.length} tool/LLM evidence but 0 human \u2014 anti-self-cert guard blocks`}:{acId:t,pass:!0,totalEvidence:r.length,humanEvidence:n.length}}function zx(t){let e=new Set;for(let n of t)n.acId&&e.add(n.acId);let r=[];for(let n of e){let i=sqe(n,t);i.pass||r.push(i)}return r}ni();var Ij="stage_4.1";function Pj(t={}){let{cwd:e="."}=t,r=In(e);if(r.length===0)return{stage:Ij,pass:!1,exitCode:2,stderr:"no audit log present \u2014 record evidence before running stage_4.1"};let n=zx(r);if(n.length===0)return{stage:Ij,pass:!0,exitCode:0};let i=n.map(o=>`${o.acId}: ${o.reason}`).join("; ");return{stage:Ij,pass:!1,exitCode:1,stderr:`anti-self-cert guard: ${i}`}}var aqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${fte.argv[1]}`;if(aqe){let t=Pj();console.log(JSON.stringify(t)),fte.exit(t.exitCode)}Sl();import{randomBytes as cqe}from"node:crypto";import{unlinkSync as lqe}from"node:fs";import{tmpdir as uqe}from"node:os";import{join as dqe,resolve as Cj}from"node:path";import fqe from"node:process";var qr=null;function pte(t){qr={cwd:Cj(t),run:null,jsonFile:null}}function Dj(){return qr!==null}function Nj(t,e){if(!qr||qr.cwd!==Cj(t))return null;if(qr.run)return qr.run;let r=dqe(uqe(),`clad-shared-vitest-${fqe.pid}-${cqe(6).toString("hex")}.json`);qr.jsonFile=r;let n=e(r);return qr.run={proc:n,jsonFile:r},qr.run}function mte(t){return!qr||qr.cwd!==Cj(t)?null:qr.run}function jj(t){return t.pass&&t.exitCode===0?"reuse-pass":"fallback"}function hte(){let t=qr?.jsonFile;if(qr=null,t)try{lqe(t)}catch{}}Mr();import gte from"node:process";var Ux="stage_1.4";function Mj(t={}){let{cwd:e="."}=t,r;try{r=We("git",["status","--porcelain"],{cwd:e,reject:!1})}catch(i){if(i.code==="ENOENT")return{stage:Ux,pass:!1,exitCode:2,stderr:"git binary not found"};throw i}if(r.exitCode!==0){let i=(r.stderr??"").toString().trim()||"not a git repository";return{stage:Ux,pass:!1,exitCode:2,stderr:i}}let n=(r.stdout??"").toString().trim();return n.length===0?{stage:Ux,pass:!0,exitCode:0}:{stage:Ux,pass:!1,exitCode:1,stderr:`working tree dirty: -${n}`}}var pqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${gte.argv[1]}`;if(pqe){let t=Mj();console.log(JSON.stringify(t)),gte.exit(t.exitCode)}Mr();import yte from"node:process";Ym();Rn();var qx="stage_2.2";function Fj(t={}){let{cwd:e="."}=t,r,n,i;try{({cmd:r,args:n,language:i}=Yi("coverage",t))}catch(c){return{stage:qx,pass:!1,exitCode:1,stderr:c.message}}if(!r||!n)return{stage:qx,pass:!1,exitCode:2,stderr:`no coverage runner registered for language '${i}'`};let o=mte(e),s=o?o.proc:We(r,[...n],{cwd:e,reject:!1}),a=Nt(qx,r,s,n);return a||Yt(qx,s)}var gqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${yte.argv[1]}`;if(gqe){let t=Fj();console.log(JSON.stringify(t)),yte.exit(t.exitCode)}Mp();Lj();Mr();sn();Rn();import bte from"node:process";var Gx="stage_3.2";function zj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.perf,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Gx,pass:!1,exitCode:2,stderr:`no perf runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Gx,pass:!1,exitCode:2,stderr:"perf npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Gx,i,s,o);return a||Yt(Gx,s)}var jqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${bte.argv[1]}`;if(jqe){let t=zj();console.log(JSON.stringify(t)),bte.exit(t.exitCode)}Mr();Ue();Rn();import{existsSync as Mqe}from"node:fs";import{resolve as Ste}from"node:path";import wte from"node:process";var di="stage_2.4",Uj=5e3,Fqe=3e4;function qj(t={}){let{cwd:e="."}=t,r,n=[],i=!1,o=new Map;try{let p=q(e);r=p.project.deliverable,n=p.project.smoke??[],i=p.features.some(m=>m.status==="done"),o=new Map(p.features.map(m=>[m.id,m.status]))}catch{return{stage:di,pass:!1,exitCode:2,stderr:"spec.yaml not loaded \u2014 deliverable smoke skipped"}}if(n.length>0)return zqe(e,n,{anyDone:i,featureStatus:o});if(!r)return{stage:di,pass:!1,exitCode:2,stderr:"no project.deliverable declared \u2014 skipped"};if(r.is_safe_to_smoke!==!0)return{stage:di,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not marked is_safe_to_smoke \u2014 skipped`};if(!i)return{stage:di,pass:!1,exitCode:2,stderr:"no done feature yet \u2014 deliverable smoke skipped"};let s=Ste(e,r.path);if(!Mqe(s))return{stage:di,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not found \u2014 see DELIVERABLE_INTEGRITY`};let a=r.timeout_ms??Uj,c;try{c=We(s,[...r.smoke_args??[]],{cwd:e,reject:!1,timeout:a})}catch(p){c=p}let l=Nt(di,r.path,c);if(l)return l;if(c.timedOut)return{stage:di,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' timed out after ${a}ms (hung or too slow)`};let u=r.expect_exit??0,d=c.exitCode??1;if(d===u)return{stage:di,pass:!0,exitCode:0,disposition:"liveness"};let f=String(c.stderr??"").trim()||String(c.stdout??"").trim();return{stage:di,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' exited ${d}, expected ${u}${f?` \u2014 ${f.slice(0,200)}`:""}`}}var vte={fail:5,advisory:4,pending_env:4,liveness:3,pass:2,na:1,skip:0},Lqe={pass:"\u2713",fail:"\u2717",liveness:"liveness",na:"na",pending_env:"pending_env",advisory:"advisory",skip:"skip"};function zqe(t,e,r){let n=Math.min(e.length*Uj,Fqe),i=Date.now(),o=[];for(let s of e){if(Date.now()-i>=n){o.push({argv:(s.run??[]).join(" ")||"(none)",kind:s.kind,disposition:"pending_env",detail:"stage time ceiling \u2014 not started",feature:s.feature,why:s.why});continue}o.push(Uqe(t,s,r))}return qqe(o)}function Uqe(t,e,r){let n=(e.run??[]).join(" ")||"(none)",i=e.why;if(e.kind==="none")return{argv:"(kind:none)",kind:"none",disposition:"na",detail:"nothing to run (library/static)",why:i};let o=e.feature;if(o!==void 0){let h=r.featureStatus.get(o);if(h!=="done"){let g=h===void 0?`bound feature ${o} not found in spec \u2014 not executed`:`bound feature ${o} is ${h}, not done \u2014 not executed`;return{argv:n,kind:"cli",disposition:"na",detail:g,feature:o,why:i}}}else if(!r.anyDone)return{argv:n,kind:"cli",disposition:"skip",detail:"no done feature yet \u2014 smoke probe skipped",why:i};let s=e.run??[];if(s.length===0)return{argv:"(none)",kind:"cli",disposition:"skip",detail:"cli smoke probe has no run argv \u2014 skipped",feature:o,why:i};let[a,...c]=s,l=a.startsWith(".")||a.startsWith("/")?Ste(t,a):a,u=Uj,d;try{d=We(l,[...c],{cwd:t,reject:!1,timeout:u})}catch(h){d=h}if(za(d))return{argv:n,kind:"cli",disposition:"skip",detail:`'${a}' not installed`,feature:o,why:i};if(d.timedOut)return{argv:n,kind:"cli",disposition:"fail",detail:`timed out after ${u}ms`,feature:o,why:i};let f=e.expect?.exit??0,p=d.exitCode??1;if(p!==f){let h=String(d.stderr??"").trim()||String(d.stdout??"").trim();return{argv:n,kind:"cli",disposition:"fail",detail:`exited ${p}, expected ${f}${h?` \u2014 ${h.slice(0,200)}`:""}`,feature:o,why:i}}let m=e.expect?.token;return m?String(d.stdout??"").includes(m)?{argv:n,kind:"cli",disposition:"pass",detail:`ran clean (exit ${p}), stdout contains ${JSON.stringify(m)}`,feature:o,why:i}:{argv:n,kind:"cli",disposition:"fail",detail:`ran (exit ${p}) but stdout did not contain the AC token ${JSON.stringify(m)}`,feature:o,why:i}:{argv:n,kind:"cli",disposition:"liveness",detail:`ran clean (exit ${p}), no token declared \u2014 exit-only`,feature:o,why:i}}function qqe(t){let e="skip";for(let o of t)vte[o.disposition]>vte[e]&&(e=o.disposition);let r=t.map(o=>{let s=o.why?` \xB7 ${o.why}`:"";return`${Lqe[o.disposition]} ${o.argv} \xB7 ${o.detail}${s}`}).join(` -`),n=t.map((o,s)=>({id:`probe_${s+1}`,kind:o.kind,disposition:o.disposition==="skip"?"na":o.disposition,bindsFeature:o.feature,why:o.why,detail:o.detail}));if(e==="skip")return{stage:di,pass:!1,exitCode:2,stderr:r,probes:n};let i=e==="fail"||e==="pending_env"||e==="advisory";return{stage:di,pass:!i,exitCode:i?1:0,disposition:e,stderr:r,probes:n}}var Bqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${wte.argv[1]}`;if(Bqe){let t=qj();console.log(JSON.stringify(t)),wte.exit(t.exitCode)}Mr();sn();Rn();import xte from"node:process";var Zx="stage_3.1";function Bj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.smoke,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Zx,pass:!1,exitCode:2,stderr:`no smoke runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Zx,pass:!1,exitCode:2,stderr:"smoke npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Zx,i,s,o);return a||Yt(Zx,s)}var Hqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${xte.argv[1]}`;if(Hqe){let t=Bj();console.log(JSON.stringify(t)),xte.exit(t.exitCode)}pC();Hj();Gj();Mr();Bx();import{randomBytes as Yqe}from"node:crypto";import{unlinkSync as Xqe}from"node:fs";import{tmpdir as Qqe}from"node:os";import{join as e4e}from"node:path";import Vj from"node:process";Ym();Rn();Ue();import{readFileSync as Vqe}from"node:fs";import{resolve as Ete}from"node:path";function Wqe(t){let e=t.trim();if(!e.startsWith("{"))return null;let r;try{r=JSON.parse(e)}catch{return null}let n=r.testResults;if(!Array.isArray(n))return null;let i=new Map;for(let o of n){if(typeof o.name!="string"||!o.name)continue;let s=Ete(o.name),a=i.get(s)??0;for(let c of o.assertionResults??[])c.status==="passed"&&(a+=1);i.set(s,a)}return i}function Kqe(t){let e=t.indexOf("#");return(e===-1?t:t.slice(0,e)).trim()}function Jqe(t,e,r){let n=[];for(let i of t.features??[]){if(i.status!=="done")continue;let o=[],s=new Set;for(let u of i.acceptance_criteria??[])for(let d of u.test_refs??[]){let f=Kqe(d);f&&!s.has(f)&&(s.add(f),o.push(f))}if(o.length===0)continue;let a=!0,c=!1;for(let u of o){let d=e.get(Ete(r,u));if(d===void 0){a=!1;break}if(d>0){c=!0;break}}if(c||!a)continue;let l=i.title||i.id;n.push({detector:"VACUOUS_TESTS",severity:"warn",path:o[0],message:`Done feature "${l}" declares tests, but none of its test files executed a passing test (all skipped / todo / empty) \u2014 its behavioral proof never actually ran`})}return n}function Zj(t,e){try{let r=Wqe(Vqe(t,"utf8"));return r?Jqe(q(e),r,e):[]}catch{return[]}}var Br="stage_2.1";function Ate(t,e){return t==="vitest"||t.endsWith("/vitest")||e.includes("vitest")}function Tte(t,e){return[t,...e].some(r=>r==="pytest"||r.endsWith("/pytest"))}function Ote(t){let e=`${String(t.stdout??"")} -${String(t.stderr??"")}`,r=[],n=[/^\s*#\s*tests\s+(\d+)\s*$/gim,/^\s*ℹ\s+tests\s+(\d+)\s*$/gim,/^\s*Tests:\s+.*?\b(\d+)\s+total\b.*$/gim,/^\s*collected\s+(\d+)\s+items?\b.*$/gim];for(let i of n)for(let o of e.matchAll(i))r.push(Number(o[1]));return r.length>0&&r.every(i=>i===0)}function t4e(t,e,r){let n,i;try{({cmd:n,args:i}=Yi("coverage",t))}catch{return null}if(!n||!i||!Ate(n,i))return null;let o=n,s=i,a=Nj(e,d=>We(o,[...s,"--reporter=default","--reporter=json",`--outputFile=${d}`],{cwd:e,reject:!1}));if(!a)return null;let{proc:c,jsonFile:l}=a;if(Nt(Br,n,c,s))return null;let u=Yt(Br,c);if(jj(u)==="fallback")return null;if(r){let d=Zj(l,e);if(d.length>0)return{stage:Br,pass:!1,exitCode:1,findings:d,stderr:d[0].message}}return{stage:Br,pass:!0,exitCode:0}}function r4e(t,e){let{strict:r=!1}=t,n,i;try{({cmd:n,args:i}=Yi("coverage",t))}catch{return null}if(!n||!i||!Tte(n,i))return null;let o=n,s=i,a=Nj(e,()=>We(o,[...s],{cwd:e,reject:!1}));if(!a||Nt(Br,o,a.proc,s))return null;let c=Yt(Br,a.proc);if(jj(c)==="fallback")return null;if(r&&Ote(a.proc)){let l={detector:"VACUOUS_TESTS",severity:"error",message:"The unit test command exited successfully but reported zero executed tests."};return{stage:Br,pass:!1,exitCode:1,findings:[l],stderr:l.message}}return{stage:Br,pass:!0,exitCode:0}}function Wj(t={}){let{cwd:e=".",strict:r=!1}=t,n,i,o;try{({cmd:n,args:i,language:o}=Yi("test",t))}catch(d){return{stage:Br,pass:!1,exitCode:1,stderr:d.message}}if(!n||!i)return{stage:Br,pass:!1,exitCode:2,stderr:`no unit test runner registered for language '${o}'`};let s=Ate(n,i),a=Tte(n,i),c=r&&s;if(Dj()&&s){let d=t4e(t,e,c);if(d)return d}if(Dj()&&a){let d=r4e(t,e);if(d)return d}let l,u=i;c&&(l=e4e(Qqe(),`clad-vitest-${Vj.pid}-${Yqe(6).toString("hex")}.json`),u=[...i,"--reporter=default","--reporter=json",`--outputFile=${l}`]);try{let d=We(n,[...u],{cwd:e,reject:!1}),f=Nt(Br,n,d,u);if(f)return f;let p=Iu("unit",Yt(Br,d),d);if(r&&p.pass&&Ote(d)){let m={detector:"VACUOUS_TESTS",severity:"error",message:"The unit test command exited successfully but reported zero executed tests."};return{stage:Br,pass:!1,exitCode:1,findings:[m],stderr:m.message}}if(c&&p.pass&&l){let m=Zj(l,e);if(m.length>0)return{stage:Br,pass:!1,exitCode:1,findings:m,stderr:m[0].message}}return p}finally{if(l)try{Xqe(l)}catch{}}}var n4e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Vj.argv[1]}`;if(n4e){let t=Wj();console.log(JSON.stringify(t)),Vj.exit(t.exitCode)}Mr();sn();Rn();import Rte from"node:process";var Kx="stage_3.3";function Kj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.visual,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Kx,pass:!1,exitCode:2,stderr:`no visual runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Kx,pass:!1,exitCode:2,stderr:"visual npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Kx,i,s,o);return a||Yt(Kx,s)}var i4e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Rte.argv[1]}`;if(i4e){let t=Kj();console.log(JSON.stringify(t)),Rte.exit(t.exitCode)}hC();Mf();_a();Yj();kp();tS();var Mte=St(er(),1);import{existsSync as Xj,readFileSync as h4e,readdirSync as jte,statSync as g4e,writeFileSync as y4e}from"node:fs";import{basename as rh,join as nh,relative as Nte}from"node:path";var _4e=["self-dogfood:","fixture:","derived:"],Fte=/\.(test|spec)\.[jt]sx?$/;function Lte(t,e=t,r=[]){let n;try{n=jte(e)}catch{return r}for(let i of n){if(i.startsWith("."))continue;let o=nh(e,i);try{g4e(o).isDirectory()?Lte(t,o,r):Fte.test(i)&&r.push(o)}catch{continue}}return r}function zte(t="."){let e=nh(t,"spec","features"),r=nh(t,"tests"),n=[],i=[];if(!Xj(e)||!Xj(r))return{repaired:n,suggested:i};let o=Lte(r),s=new Map;for(let a of o){let c=Nte(t,a).split("\\").join("/"),l=s.get(rh(a))??[];l.push(c),s.set(rh(a),l)}for(let a of jte(e)){if(!a.endsWith(".yaml")&&!a.endsWith(".yml"))continue;let c=nh(e,a),l,u;try{l=h4e(c,"utf8"),u=(0,Mte.parse)(l)}catch{continue}if(!u||u.status!=="done")continue;let d=!1;for(let h of u.acceptance_criteria??[])for(let g of h.test_refs??[]){if(_4e.some(x=>g.startsWith(x)))continue;let b=g.split("#",1)[0];if(Xj(nh(t,b)))continue;let _=s.get(rh(b))??[];if(_.length!==1)continue;let S=g.replace(b,_[0]);S!==g&&l.includes(g)&&(l=l.split(g).join(S),n.push({shard:a,from:g,to:S}),d=!0)}let f=u.slug??"",p=(u.modules??[]).map(h=>rh(h).replace(/\.[jt]sx?$/,"")),m=o.map(h=>Nte(t,h).split("\\").join("/")).find(h=>{let g=rh(h).replace(Fte,"");return f!==""&&g===f||p.includes(g)});if(m)for(let h of u.acceptance_criteria??[]){if((h.test_refs?.length??0)>0||(h.evidence_refs?.length??0)>0||!h.id)continue;let g=new RegExp(`^(([ ]+)- id: ${h.id}\\b.*)$`,"m"),b=l.match(g);if(!b)continue;let _=b[2]+" ";l=l.replace(g,`$1 +`)}catch{r.delete(u)}},3e4);return typeof l.unref=="function"&&l.unref(),new Promise((u,d)=>{o.on("error",d),o.listen(t.port??0,"127.0.0.1",()=>{let f=o.address(),p=typeof f=="object"&&f?f.port:t.port??0;u({port:p,broadcast:i,close:()=>new Promise(m=>{s&&clearTimeout(s),clearInterval(l);for(let h of c)try{h.close()}catch{}for(let h of r)try{h.end()}catch{}r.clear(),o.close(()=>m()),typeof o.closeAllConnections=="function"&&o.closeAllConnections()})})})})}async function pte(t={}){let e=t.port!==void 0?Number(t.port):3e3;try{let r=await oqe({port:e,cwd:t.cwd??"."});L("pass","graph",`live graph at http://localhost:${r.port} \u2014 edit spec/ or docs/ and the view auto-reloads (Ctrl-C to stop)`)}catch(r){L("fail","graph",r.message),process.exit(1)}}var sqe=["stage_1.1","stage_2.1","stage_2.3"];function aqe(t){return(t.features??[]).filter(e=>e.status==="done")}function cqe(t,e){let r=aqe(t);switch(e){case"stage_1.1":return!t.project?.language||r.length===0?null:`project.language is '${t.project.language}' and ${r.length} feature(s) are done, but the type checker did not run (skipped) \u2014 type safety of shipped code was never verified. Install the language toolchain; under --strict, an unverifiable 'done' is not GREEN.`;case"stage_2.1":{let n=r.filter(i=>(i.acceptance_criteria??[]).some(o=>(o.test_refs??[]).length>0)).length;return n===0?null:`${n} done feature(s) declare tests but the test runner did not run (skipped) \u2014 the implementation was never verified. Install the test framework; under --strict, an unverifiable 'done' is not GREEN.`}case"stage_2.3":{let n=r.flatMap(i=>i.acceptance_criteria??[]).filter(i=>(i.oracle_refs??[]).length>0).length;return n===0?null:`${n} done AC(s) declare oracle_refs but the conformance runner did not run (skipped) \u2014 the declared oracles never executed. Under --strict, declared-but-unrun verification is not GREEN.`}}}function mte(t,e){let r=[];for(let n of sqe){if(!e.some(s=>s.stage===n&&s.status==="skip"))continue;let o=cqe(t,n);o&&r.push({stage:n,label:"Verification",message:o})}return r}wS();import hte from"node:process";function lqe(t,e){let r=e.filter(i=>i.acId===t),n=r.filter(i=>i.identity.author==="human");return n.length===0?{acId:t,pass:!1,totalEvidence:r.length,humanEvidence:0,reason:r.length===0?"no evidence at all":`${r.length} tool/LLM evidence but 0 human \u2014 anti-self-cert guard blocks`}:{acId:t,pass:!0,totalEvidence:r.length,humanEvidence:n.length}}function zx(t){let e=new Set;for(let n of t)n.acId&&e.add(n.acId);let r=[];for(let n of e){let i=lqe(n,t);i.pass||r.push(i)}return r}ln();var Pj="stage_4.1";function Cj(t={}){let{cwd:e="."}=t,r=fr(e);if(r.length===0)return{stage:Pj,pass:!1,exitCode:2,stderr:"no audit log present \u2014 record evidence before running stage_4.1"};let n=zx(r);if(n.length===0)return{stage:Pj,pass:!0,exitCode:0};let i=n.map(o=>`${o.acId}: ${o.reason}`).join("; ");return{stage:Pj,pass:!1,exitCode:1,stderr:`anti-self-cert guard: ${i}`}}var uqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${hte.argv[1]}`;if(uqe){let t=Cj();console.log(JSON.stringify(t)),hte.exit(t.exitCode)}Sl();import{randomBytes as dqe}from"node:crypto";import{unlinkSync as fqe}from"node:fs";import{tmpdir as pqe}from"node:os";import{join as mqe,resolve as Dj}from"node:path";import hqe from"node:process";var Br=null;function gte(t){Br={cwd:Dj(t),run:null,jsonFile:null}}function Nj(){return Br!==null}function jj(t,e){if(!Br||Br.cwd!==Dj(t))return null;if(Br.run)return Br.run;let r=mqe(pqe(),`clad-shared-vitest-${hqe.pid}-${dqe(6).toString("hex")}.json`);Br.jsonFile=r;let n=e(r);return Br.run={proc:n,jsonFile:r},Br.run}function yte(t){return!Br||Br.cwd!==Dj(t)?null:Br.run}function Mj(t){return t.pass&&t.exitCode===0?"reuse-pass":"fallback"}function _te(){let t=Br?.jsonFile;if(Br=null,t)try{fqe(t)}catch{}}Fr();import bte from"node:process";var Ux="stage_1.4";function Fj(t={}){let{cwd:e="."}=t,r;try{r=We("git",["status","--porcelain"],{cwd:e,reject:!1})}catch(i){if(i.code==="ENOENT")return{stage:Ux,pass:!1,exitCode:2,stderr:"git binary not found"};throw i}if(r.exitCode!==0){let i=(r.stderr??"").toString().trim()||"not a git repository";return{stage:Ux,pass:!1,exitCode:2,stderr:i}}let n=(r.stdout??"").toString().trim();return n.length===0?{stage:Ux,pass:!0,exitCode:0}:{stage:Ux,pass:!1,exitCode:1,stderr:`working tree dirty: +${n}`}}var gqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${bte.argv[1]}`;if(gqe){let t=Fj();console.log(JSON.stringify(t)),bte.exit(t.exitCode)}Fr();import vte from"node:process";Ym();Pn();var qx="stage_2.2";function Lj(t={}){let{cwd:e="."}=t,r,n,i;try{({cmd:r,args:n,language:i}=Yi("coverage",t))}catch(c){return{stage:qx,pass:!1,exitCode:1,stderr:c.message}}if(!r||!n)return{stage:qx,pass:!1,exitCode:2,stderr:`no coverage runner registered for language '${i}'`};let o=yte(e),s=o?o.proc:We(r,[...n],{cwd:e,reject:!1}),a=Nt(qx,r,s,n);return a||Yt(qx,s)}var bqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${vte.argv[1]}`;if(bqe){let t=Lj();console.log(JSON.stringify(t)),vte.exit(t.exitCode)}Fp();zj();Fr();an();Pn();import wte from"node:process";var Gx="stage_3.2";function Uj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.perf,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Gx,pass:!1,exitCode:2,stderr:`no perf runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Gx,pass:!1,exitCode:2,stderr:"perf npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Gx,i,s,o);return a||Yt(Gx,s)}var Lqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${wte.argv[1]}`;if(Lqe){let t=Uj();console.log(JSON.stringify(t)),wte.exit(t.exitCode)}Fr();Ue();Pn();import{existsSync as zqe}from"node:fs";import{resolve as $te}from"node:path";import kte from"node:process";var di="stage_2.4",qj=5e3,Uqe=3e4;function Bj(t={}){let{cwd:e="."}=t,r,n=[],i=!1,o=new Map;try{let p=q(e);r=p.project.deliverable,n=p.project.smoke??[],i=p.features.some(m=>m.status==="done"),o=new Map(p.features.map(m=>[m.id,m.status]))}catch{return{stage:di,pass:!1,exitCode:2,stderr:"spec.yaml not loaded \u2014 deliverable smoke skipped"}}if(n.length>0)return Bqe(e,n,{anyDone:i,featureStatus:o});if(!r)return{stage:di,pass:!1,exitCode:2,stderr:"no project.deliverable declared \u2014 skipped"};if(r.is_safe_to_smoke!==!0)return{stage:di,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not marked is_safe_to_smoke \u2014 skipped`};if(!i)return{stage:di,pass:!1,exitCode:2,stderr:"no done feature yet \u2014 deliverable smoke skipped"};let s=$te(e,r.path);if(!zqe(s))return{stage:di,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not found \u2014 see DELIVERABLE_INTEGRITY`};let a=r.timeout_ms??qj,c;try{c=We(s,[...r.smoke_args??[]],{cwd:e,reject:!1,timeout:a})}catch(p){c=p}let l=Nt(di,r.path,c);if(l)return l;if(c.timedOut)return{stage:di,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' timed out after ${a}ms (hung or too slow)`};let u=r.expect_exit??0,d=c.exitCode??1;if(d===u)return{stage:di,pass:!0,exitCode:0,disposition:"liveness"};let f=String(c.stderr??"").trim()||String(c.stdout??"").trim();return{stage:di,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' exited ${d}, expected ${u}${f?` \u2014 ${f.slice(0,200)}`:""}`}}var xte={fail:5,advisory:4,pending_env:4,liveness:3,pass:2,na:1,skip:0},qqe={pass:"\u2713",fail:"\u2717",liveness:"liveness",na:"na",pending_env:"pending_env",advisory:"advisory",skip:"skip"};function Bqe(t,e,r){let n=Math.min(e.length*qj,Uqe),i=Date.now(),o=[];for(let s of e){if(Date.now()-i>=n){o.push({argv:(s.run??[]).join(" ")||"(none)",kind:s.kind,disposition:"pending_env",detail:"stage time ceiling \u2014 not started",feature:s.feature,why:s.why});continue}o.push(Hqe(t,s,r))}return Gqe(o)}function Hqe(t,e,r){let n=(e.run??[]).join(" ")||"(none)",i=e.why;if(e.kind==="none")return{argv:"(kind:none)",kind:"none",disposition:"na",detail:"nothing to run (library/static)",why:i};let o=e.feature;if(o!==void 0){let h=r.featureStatus.get(o);if(h!=="done"){let g=h===void 0?`bound feature ${o} not found in spec \u2014 not executed`:`bound feature ${o} is ${h}, not done \u2014 not executed`;return{argv:n,kind:"cli",disposition:"na",detail:g,feature:o,why:i}}}else if(!r.anyDone)return{argv:n,kind:"cli",disposition:"skip",detail:"no done feature yet \u2014 smoke probe skipped",why:i};let s=e.run??[];if(s.length===0)return{argv:"(none)",kind:"cli",disposition:"skip",detail:"cli smoke probe has no run argv \u2014 skipped",feature:o,why:i};let[a,...c]=s,l=a.startsWith(".")||a.startsWith("/")?$te(t,a):a,u=qj,d;try{d=We(l,[...c],{cwd:t,reject:!1,timeout:u})}catch(h){d=h}if(za(d))return{argv:n,kind:"cli",disposition:"skip",detail:`'${a}' not installed`,feature:o,why:i};if(d.timedOut)return{argv:n,kind:"cli",disposition:"fail",detail:`timed out after ${u}ms`,feature:o,why:i};let f=e.expect?.exit??0,p=d.exitCode??1;if(p!==f){let h=String(d.stderr??"").trim()||String(d.stdout??"").trim();return{argv:n,kind:"cli",disposition:"fail",detail:`exited ${p}, expected ${f}${h?` \u2014 ${h.slice(0,200)}`:""}`,feature:o,why:i}}let m=e.expect?.token;return m?String(d.stdout??"").includes(m)?{argv:n,kind:"cli",disposition:"pass",detail:`ran clean (exit ${p}), stdout contains ${JSON.stringify(m)}`,feature:o,why:i}:{argv:n,kind:"cli",disposition:"fail",detail:`ran (exit ${p}) but stdout did not contain the AC token ${JSON.stringify(m)}`,feature:o,why:i}:{argv:n,kind:"cli",disposition:"liveness",detail:`ran clean (exit ${p}), no token declared \u2014 exit-only`,feature:o,why:i}}function Gqe(t){let e="skip";for(let o of t)xte[o.disposition]>xte[e]&&(e=o.disposition);let r=t.map(o=>{let s=o.why?` \xB7 ${o.why}`:"";return`${qqe[o.disposition]} ${o.argv} \xB7 ${o.detail}${s}`}).join(` +`),n=t.map((o,s)=>({id:`probe_${s+1}`,kind:o.kind,disposition:o.disposition==="skip"?"na":o.disposition,bindsFeature:o.feature,why:o.why,detail:o.detail}));if(e==="skip")return{stage:di,pass:!1,exitCode:2,stderr:r,probes:n};let i=e==="fail"||e==="pending_env"||e==="advisory";return{stage:di,pass:!i,exitCode:i?1:0,disposition:e,stderr:r,probes:n}}var Zqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${kte.argv[1]}`;if(Zqe){let t=Bj();console.log(JSON.stringify(t)),kte.exit(t.exitCode)}Fr();an();Pn();import Ete from"node:process";var Zx="stage_3.1";function Hj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.smoke,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Zx,pass:!1,exitCode:2,stderr:`no smoke runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Zx,pass:!1,exitCode:2,stderr:"smoke npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Zx,i,s,o);return a||Yt(Zx,s)}var Vqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Ete.argv[1]}`;if(Vqe){let t=Hj();console.log(JSON.stringify(t)),Ete.exit(t.exitCode)}pC();Gj();Zj();Fr();Bx();import{randomBytes as e4e}from"node:crypto";import{unlinkSync as t4e}from"node:fs";import{tmpdir as r4e}from"node:os";import{join as n4e}from"node:path";import Wj from"node:process";Ym();Pn();Ue();import{readFileSync as Jqe}from"node:fs";import{resolve as Ote}from"node:path";function Yqe(t){let e=t.trim();if(!e.startsWith("{"))return null;let r;try{r=JSON.parse(e)}catch{return null}let n=r.testResults;if(!Array.isArray(n))return null;let i=new Map;for(let o of n){if(typeof o.name!="string"||!o.name)continue;let s=Ote(o.name),a=i.get(s)??0;for(let c of o.assertionResults??[])c.status==="passed"&&(a+=1);i.set(s,a)}return i}function Xqe(t){let e=t.indexOf("#");return(e===-1?t:t.slice(0,e)).trim()}function Qqe(t,e,r){let n=[];for(let i of t.features??[]){if(i.status!=="done")continue;let o=[],s=new Set;for(let u of i.acceptance_criteria??[])for(let d of u.test_refs??[]){let f=Xqe(d);f&&!s.has(f)&&(s.add(f),o.push(f))}if(o.length===0)continue;let a=!0,c=!1;for(let u of o){let d=e.get(Ote(r,u));if(d===void 0){a=!1;break}if(d>0){c=!0;break}}if(c||!a)continue;let l=i.title||i.id;n.push({detector:"VACUOUS_TESTS",severity:"warn",path:o[0],message:`Done feature "${l}" declares tests, but none of its test files executed a passing test (all skipped / todo / empty) \u2014 its behavioral proof never actually ran`})}return n}function Vj(t,e){try{let r=Yqe(Jqe(t,"utf8"));return r?Qqe(q(e),r,e):[]}catch{return[]}}var Hr="stage_2.1";function Rte(t,e){return t==="vitest"||t.endsWith("/vitest")||e.includes("vitest")}function Ite(t,e){return[t,...e].some(r=>r==="pytest"||r.endsWith("/pytest"))}function Pte(t){let e=`${String(t.stdout??"")} +${String(t.stderr??"")}`,r=[],n=[/^\s*#\s*tests\s+(\d+)\s*$/gim,/^\s*ℹ\s+tests\s+(\d+)\s*$/gim,/^\s*Tests:\s+.*?\b(\d+)\s+total\b.*$/gim,/^\s*collected\s+(\d+)\s+items?\b.*$/gim];for(let i of n)for(let o of e.matchAll(i))r.push(Number(o[1]));return r.length>0&&r.every(i=>i===0)}function i4e(t,e,r){let n,i;try{({cmd:n,args:i}=Yi("coverage",t))}catch{return null}if(!n||!i||!Rte(n,i))return null;let o=n,s=i,a=jj(e,d=>We(o,[...s,"--reporter=default","--reporter=json",`--outputFile=${d}`],{cwd:e,reject:!1}));if(!a)return null;let{proc:c,jsonFile:l}=a;if(Nt(Hr,n,c,s))return null;let u=Yt(Hr,c);if(Mj(u)==="fallback")return null;if(r){let d=Vj(l,e);if(d.length>0)return{stage:Hr,pass:!1,exitCode:1,findings:d,stderr:d[0].message}}return{stage:Hr,pass:!0,exitCode:0}}function o4e(t,e){let{strict:r=!1}=t,n,i;try{({cmd:n,args:i}=Yi("coverage",t))}catch{return null}if(!n||!i||!Ite(n,i))return null;let o=n,s=i,a=jj(e,()=>We(o,[...s],{cwd:e,reject:!1}));if(!a||Nt(Hr,o,a.proc,s))return null;let c=Yt(Hr,a.proc);if(Mj(c)==="fallback")return null;if(r&&Pte(a.proc)){let l={detector:"VACUOUS_TESTS",severity:"error",message:"The unit test command exited successfully but reported zero executed tests."};return{stage:Hr,pass:!1,exitCode:1,findings:[l],stderr:l.message}}return{stage:Hr,pass:!0,exitCode:0}}function Kj(t={}){let{cwd:e=".",strict:r=!1}=t,n,i,o;try{({cmd:n,args:i,language:o}=Yi("test",t))}catch(d){return{stage:Hr,pass:!1,exitCode:1,stderr:d.message}}if(!n||!i)return{stage:Hr,pass:!1,exitCode:2,stderr:`no unit test runner registered for language '${o}'`};let s=Rte(n,i),a=Ite(n,i),c=r&&s;if(Nj()&&s){let d=i4e(t,e,c);if(d)return d}if(Nj()&&a){let d=o4e(t,e);if(d)return d}let l,u=i;c&&(l=n4e(r4e(),`clad-vitest-${Wj.pid}-${e4e(6).toString("hex")}.json`),u=[...i,"--reporter=default","--reporter=json",`--outputFile=${l}`]);try{let d=We(n,[...u],{cwd:e,reject:!1}),f=Nt(Hr,n,d,u);if(f)return f;let p=Pu("unit",Yt(Hr,d),d);if(r&&p.pass&&Pte(d)){let m={detector:"VACUOUS_TESTS",severity:"error",message:"The unit test command exited successfully but reported zero executed tests."};return{stage:Hr,pass:!1,exitCode:1,findings:[m],stderr:m.message}}if(c&&p.pass&&l){let m=Vj(l,e);if(m.length>0)return{stage:Hr,pass:!1,exitCode:1,findings:m,stderr:m[0].message}}return p}finally{if(l)try{t4e(l)}catch{}}}var s4e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Wj.argv[1]}`;if(s4e){let t=Kj();console.log(JSON.stringify(t)),Wj.exit(t.exitCode)}Fr();an();Pn();import Cte from"node:process";var Kx="stage_3.3";function Jj(t={}){let{cwd:e="."}=t,r=dt(e),n=r.gates.visual,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:Kx,pass:!1,exitCode:2,stderr:`no visual runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Bl(e,o[o.length-1]))return{stage:Kx,pass:!1,exitCode:2,stderr:"visual npm script not defined"};let s=We(i,[...o],{cwd:e,reject:!1}),a=Nt(Kx,i,s,o);return a||Yt(Kx,s)}var a4e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Cte.argv[1]}`;if(a4e){let t=Jj();console.log(JSON.stringify(t)),Cte.exit(t.exitCode)}hC();Ff();_a();Xj();Ep();tS();var zte=St(er(),1);import{existsSync as Qj,readFileSync as _4e,readdirSync as Lte,statSync as b4e,writeFileSync as v4e}from"node:fs";import{basename as rh,join as nh,relative as Fte}from"node:path";var S4e=["self-dogfood:","fixture:","derived:"],Ute=/\.(test|spec)\.[jt]sx?$/;function qte(t,e=t,r=[]){let n;try{n=Lte(e)}catch{return r}for(let i of n){if(i.startsWith("."))continue;let o=nh(e,i);try{b4e(o).isDirectory()?qte(t,o,r):Ute.test(i)&&r.push(o)}catch{continue}}return r}function Bte(t="."){let e=nh(t,"spec","features"),r=nh(t,"tests"),n=[],i=[];if(!Qj(e)||!Qj(r))return{repaired:n,suggested:i};let o=qte(r),s=new Map;for(let a of o){let c=Fte(t,a).split("\\").join("/"),l=s.get(rh(a))??[];l.push(c),s.set(rh(a),l)}for(let a of Lte(e)){if(!a.endsWith(".yaml")&&!a.endsWith(".yml"))continue;let c=nh(e,a),l,u;try{l=_4e(c,"utf8"),u=(0,zte.parse)(l)}catch{continue}if(!u||u.status!=="done")continue;let d=!1;for(let h of u.acceptance_criteria??[])for(let g of h.test_refs??[]){if(S4e.some(x=>g.startsWith(x)))continue;let b=g.split("#",1)[0];if(Qj(nh(t,b)))continue;let _=s.get(rh(b))??[];if(_.length!==1)continue;let S=g.replace(b,_[0]);S!==g&&l.includes(g)&&(l=l.split(g).join(S),n.push({shard:a,from:g,to:S}),d=!0)}let f=u.slug??"",p=(u.modules??[]).map(h=>rh(h).replace(/\.[jt]sx?$/,"")),m=o.map(h=>Fte(t,h).split("\\").join("/")).find(h=>{let g=rh(h).replace(Ute,"");return f!==""&&g===f||p.includes(g)});if(m)for(let h of u.acceptance_criteria??[]){if((h.test_refs?.length??0)>0||(h.evidence_refs?.length??0)>0||!h.id)continue;let g=new RegExp(`^(([ ]+)- id: ${h.id}\\b.*)$`,"m"),b=l.match(g);if(!b)continue;let _=b[2]+" ";l=l.replace(g,`$1 ${_}test_refs: -${_} - "derived:${m}"`),i.push({shard:a,ref:`derived:${m}`}),d=!0}d&&y4e(c,l,"utf8")}return{repaired:n,suggested:i}}vl();import{existsSync as b4e,readFileSync as v4e}from"node:fs";import{join as S4e}from"node:path";function w4e(t,e){let r=S4e(t,e);if(!b4e(r))return[];let n=[];for(let i of v4e(r,"utf8").split(/\r?\n/)){let o=i.trim();if(!/^export\s+(?:async\s+)?(?:abstract\s+)?(?:function|const|let|class|interface|type|enum)\b/.test(o))continue;let s=o.replace(/\s*[{=].*$/s,"").trim();s&&n.push(s)}return n}function Ute(t,e,r,n){let i=t.features.find(c=>c.id===e);if(!i)return null;let o=(i.acceptance_criteria??[]).filter(c=>!r||c.id===r),s=i.modules??[],a=s.flatMap(c=>w4e(n,c).map(l=>`${c}: ${l}`));return{featureId:e,featureTitle:i.title,acs:o.map(c=>({id:c.id,ears:c.ears,condition:c.condition,action:c.action,response:c.response,text:c.text})),modules:s,signatures:a,readManifest:[...s.map(c=>`signatures-of:${c}`),"spec:acceptance_criteria"]}}function qte(t){let e=[];e.push(`# Impl-blind oracle brief \u2014 ${t.featureId}: ${t.featureTitle}`),e.push("#"),e.push("# Author a conformance TEST SUITE from THIS SPECIFICATION ONLY. You have NOT been"),e.push("# shown the implementation and MUST NOT read it. Assert ONLY what the acceptance"),e.push("# criteria literally require; when the spec is silent on an edge, write a WEAKER"),e.push("# assertion, not a stronger guess (an over-strict oracle falsely fails correct code)."),e.push(""),e.push("## Acceptance criteria (the spec)");for(let r of t.acs)e.push(`- ${r.id}${r.ears?` [${r.ears}]`:""}: ${r.text??""}`.trimEnd()),r.condition&&e.push(` when: ${r.condition}`),r.action&&e.push(` system shall: ${r.action}`),r.response&&e.push(` so that: ${r.response}`);e.push(""),e.push("## Public surface to call (signatures only \u2014 NO implementation shown)"),t.signatures.length===0&&e.push(" (no export signatures extracted \u2014 call the API exactly as the criteria describe)");for(let r of t.signatures)e.push(` ${r}`);return e.push(""),e.push("## Write the suite under tests/oracle/ (the dir stage_2.3 runs), then record it with"),e.push("## the clad_author_oracle MCP tool so its impl-blind provenance is gate-verified."),e.join(` -`)}iS();Ue();Ii();ni();vl();var Qj=["stage_1.1","stage_1.2","stage_1.3","stage_1.4","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_3.1","stage_3.2","stage_3.3","stage_4.1","stage_4.2"],x4e=[...Qj,"att"];function $4e(t,e,r){if(e.startsWith("stage_4")){let n=In(r);if(n.length===0)return"\xB7";let i=(t.acceptance_criteria??[]).map(s=>s.id);return zx(n).filter(s=>i.includes(s.acId)).length>0?"\u2717":"\u2713"}return"-"}function k4e(t,e,r){let n=t.modules??[];return t.status!=="done"||n.length===0?"\xB7":e===null?"-":H_(e,r,t).state==="fresh"?"\u2713":"!"}function Qx(t,e="."){let r=as(e),n=t.features.map(i=>({featureId:i.id,title:i.title||i.id,status:i.status,cells:[...Qj.map(o=>$4e(i,o,e)),k4e(i,r,e)]}));return{columns:x4e,rows:n}}function Bte(t,e=".",r={}){let n=r.internal??!1,i=Qx(t,e),o=[...Qj.map(c=>n?c.replace("stage_",""):E4e(c)),"att"],s=n?`feature ${o.join(" ")}`:`feature${" ".repeat(28)}${o.join(" ")}`,a=i.rows.map(c=>{let l=c.cells.join(" ");return n?`${c.featureId.padEnd(12)} ${l} ${c.title}`:`${c.title.padEnd(35).slice(0,35)} ${l}`});return[s,...a].join(` -`)}function E4e(t){return Ta(t).slice(0,3)}async function Q8e(t){let[{buildServer:e},{StdioServerTransport:r},{setHostMcpServer:n}]=await Promise.all([Promise.resolve().then(()=>(ide(),nde)),Promise.resolve().then(()=>(lde(),cde)),Promise.resolve().then(()=>(Qp(),b7))]),i=e({cwd:t.cwd,onboarding:{renderDraft:s=>Wee(s),prepareInit:({cwd:s,mode:a,intent:c})=>Zee(s,a,c),initialize:mj,prepareClarify:(s,{cwd:a})=>Vee(a,s),clarify:_j,resolveReview:(s,{cwd:a})=>qee(s,{cwd:a})}});n(i.server);let o=new r;G.stderr.write(`\xB7 serve stdio transport \xB7 cwd=${t.cwd??"."} -`),await i.connect(o)}async function e5e(t,e){let r=t&&t.length>0?t.join(" ").trim():void 0,n=await mj({projectName:e.name,force:e.force,scan:e.scan,noLlm:e.noLlm,roots:e.roots?e.roots.split(",").map(o=>o.trim()).filter(Boolean):void 0,intent:r,withHook:e.withHook,withCi:e.withCi});if(e.json){G.stdout.write(`${JSON.stringify(n,null,2)} +${_} - "derived:${m}"`),i.push({shard:a,ref:`derived:${m}`}),d=!0}d&&v4e(c,l,"utf8")}return{repaired:n,suggested:i}}vl();import{existsSync as w4e,readFileSync as x4e}from"node:fs";import{join as $4e}from"node:path";function k4e(t,e){let r=$4e(t,e);if(!w4e(r))return[];let n=[];for(let i of x4e(r,"utf8").split(/\r?\n/)){let o=i.trim();if(!/^export\s+(?:async\s+)?(?:abstract\s+)?(?:function|const|let|class|interface|type|enum)\b/.test(o))continue;let s=o.replace(/\s*[{=].*$/s,"").trim();s&&n.push(s)}return n}function Hte(t,e,r,n){let i=t.features.find(c=>c.id===e);if(!i)return null;let o=(i.acceptance_criteria??[]).filter(c=>!r||c.id===r),s=i.modules??[],a=s.flatMap(c=>k4e(n,c).map(l=>`${c}: ${l}`));return{featureId:e,featureTitle:i.title,acs:o.map(c=>({id:c.id,ears:c.ears,condition:c.condition,action:c.action,response:c.response,text:c.text})),modules:s,signatures:a,readManifest:[...s.map(c=>`signatures-of:${c}`),"spec:acceptance_criteria"]}}function Gte(t){let e=[];e.push(`# Impl-blind oracle brief \u2014 ${t.featureId}: ${t.featureTitle}`),e.push("#"),e.push("# Author a conformance TEST SUITE from THIS SPECIFICATION ONLY. You have NOT been"),e.push("# shown the implementation and MUST NOT read it. Assert ONLY what the acceptance"),e.push("# criteria literally require; when the spec is silent on an edge, write a WEAKER"),e.push("# assertion, not a stronger guess (an over-strict oracle falsely fails correct code)."),e.push(""),e.push("## Acceptance criteria (the spec)");for(let r of t.acs)e.push(`- ${r.id}${r.ears?` [${r.ears}]`:""}: ${r.text??""}`.trimEnd()),r.condition&&e.push(` when: ${r.condition}`),r.action&&e.push(` system shall: ${r.action}`),r.response&&e.push(` so that: ${r.response}`);e.push(""),e.push("## Public surface to call (signatures only \u2014 NO implementation shown)"),t.signatures.length===0&&e.push(" (no export signatures extracted \u2014 call the API exactly as the criteria describe)");for(let r of t.signatures)e.push(` ${r}`);return e.push(""),e.push("## Write the suite under tests/oracle/ (the dir stage_2.3 runs), then record it with"),e.push("## the clad_author_oracle MCP tool so its impl-blind provenance is gate-verified."),e.join(` +`)}iS();Ue();ln();Ii();ln();vl();var eM=["stage_1.1","stage_1.2","stage_1.3","stage_1.4","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_3.1","stage_3.2","stage_3.3","stage_4.1","stage_4.2"],E4e=[...eM,"att"];function A4e(t,e,r){if(e.startsWith("stage_4")){let n=fr(r);if(n.length===0)return"\xB7";let i=(t.acceptance_criteria??[]).map(s=>s.id);return zx(n).filter(s=>i.includes(s.acId)).length>0?"\u2717":"\u2713"}return"-"}function T4e(t,e,r){let n=t.modules??[];return t.status!=="done"||n.length===0?"\xB7":e===null?"-":H_(e,r,t).state==="fresh"?"\u2713":"!"}function Qx(t,e="."){let r=as(e),n=t.features.map(i=>({featureId:i.id,title:i.title||i.id,status:i.status,cells:[...eM.map(o=>A4e(i,o,e)),T4e(i,r,e)]}));return{columns:E4e,rows:n}}function Zte(t,e=".",r={}){let n=r.internal??!1,i=Qx(t,e),o=[...eM.map(c=>n?c.replace("stage_",""):O4e(c)),"att"],s=n?`feature ${o.join(" ")}`:`feature${" ".repeat(28)}${o.join(" ")}`,a=i.rows.map(c=>{let l=c.cells.join(" ");return n?`${c.featureId.padEnd(12)} ${l} ${c.title}`:`${c.title.padEnd(35).slice(0,35)} ${l}`});return[s,...a].join(` +`)}function O4e(t){return Ta(t).slice(0,3)}async function r5e(t){let[{buildServer:e},{StdioServerTransport:r},{setHostMcpServer:n}]=await Promise.all([Promise.resolve().then(()=>(ade(),sde)),Promise.resolve().then(()=>(fde(),dde)),Promise.resolve().then(()=>(Qp(),w7))]),i=e({cwd:t.cwd,onboarding:{renderDraft:s=>Yee(s),prepareInit:({cwd:s,mode:a,intent:c})=>Kee(s,a,c),initialize:hj,prepareClarify:(s,{cwd:a})=>Jee(a,s),clarify:bj,resolveReview:(s,{cwd:a})=>Gee(s,{cwd:a})}});n(i.server);let o=new r;G.stderr.write(`\xB7 serve stdio transport \xB7 cwd=${t.cwd??"."} +`),await i.connect(o)}async function n5e(t,e){let r=t&&t.length>0?t.join(" ").trim():void 0,n=await hj({projectName:e.name,force:e.force,scan:e.scan,noLlm:e.noLlm,roots:e.roots?e.roots.split(",").map(o=>o.trim()).filter(Boolean):void 0,intent:r,withHook:e.withHook,withCi:e.withCi});if(e.json){G.stdout.write(`${JSON.stringify(n,null,2)} `),G.exit(0);return}for(let o of n.created)L("pass",`created ${o}`);for(let o of n.skipped)L("skip",o);for(let o of n.proposals??[])L("note","proposal",o);let i=n.onboardingMode?`language: ${n.language} \xB7 mode: ${n.onboardingMode}`:`language: ${n.language}`;if(L("note","init done",i),n.clarifyingQuestions&&n.clarifyingQuestions.length>0){G.stdout.write(` \u{1F4A1} A few more details would sharpen the spec: `);for(let[o,s]of n.clarifyingQuestions.entries())G.stdout.write(` ${o+1}. ${s} @@ -921,32 +921,32 @@ ${_} - "derived:${m}"`),i.push({shard:a,ref:`derived:${m}`}),d=!0}d&&y4e(c,l,"u `),G.stdout.write(` e.g. clad init payment SaaS for B2B `),G.stdout.write(` The existing seeds divert to .cladding/scan/*.proposal. -`));G.exit(0)}async function t5e(t,e){L("note","run","EXPERIMENTAL \u2014 prefer the host-delegated path (clad serve + your AI host). See docs/feature-cycle.md \xA7 Execution surface.");let{runDriveLoop:r}=await Promise.resolve().then(()=>(Dde(),Cde)),n=await r({cwd:e.cwd,goal:t,budget:{maxIterations:Number(e.maxIterations),maxWallClockMs:Number(e.maxWallClockMs),maxRetriesPerFeature:Number(e.maxRetries)}}),i=n.halt.class==="ALL_FEATURES_DONE"?"pass":"note";if(e.json)L(i,"run",`halt=${n.halt.class} iter=${n.iterations} features=${n.featuresTouched.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`),G.stdout.write(`${JSON.stringify(n,null,2)} -`);else{let s=q(e.cwd??"."),a=n.featuresTouched.map(l=>oR(l,s)),c=`${pG(n.halt,s)} iter=${n.iterations} features=${a.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`;L(i,"run",c),a.length>0&&G.stdout.write(`Touched: ${a.join(", ")} -`)}let o=n.stubsCreated.length>0;o&&L("fail","run",`produced ${n.stubsCreated.length} empty auto-stub(s) and implemented nothing \u2014 the headless code-author needs a real LLM transport (set ANTHROPIC_API_KEY) or use the host-delegated path (clad serve + your AI host). This run did NOT do the work.`),G.exit(n.halt.class==="ALL_FEATURES_DONE"&&!o?0:1)}function r5e(t={}){try{let e=q();if(ya("."))L("note","sync","derived-file writes deferred \u2014 git operation in progress; re-run after the merge/rebase completes.");else{let r=_s(".");Vl(".",r),Wa("."),j5(".");let n=tu(".");n==="created"?L("note","agents.md","wrote a spec-driven AGENTS.md so non-Claude agents share the same guidance."):n==="updated"&&L("note","agents.md","refreshed the AGENTS.md managed block from the current spec.");let i=zte(".");for(let s of i.repaired)L("note","test_refs",`repaired ${s.from} \u2192 ${s.to} (${s.shard})`);for(let s of i.suggested)L("note","test_refs",`suggested ${s.ref} (${s.shard}) \u2014 confirm by removing the 'derived:' prefix`);let o=Xx(".");o&&L("note","deliverable",`auto-detected entry '${o.path}' \u2014 the gate now smoke-tests it. Opt out with is_safe_to_smoke: false.`)}if(t.proposeArchive){let n=oS.run({cwd:"."}).filter(i=>i.suggestion?.action==="propose-archive");if(n.length===0){L("pass","sync",`${e.features.length} features \xB7 0 archive candidates`),G.exit(0);return}for(let i of n){let o=i.suggestion?.args??{},s=String(o.featureId??"?"),a=String(o.reason??i.message);L("note",`propose-archive \xB7 ${s}`,a)}L("pass","sync",`${e.features.length} features \xB7 ${n.length} archive candidate(s)`),G.exit(0);return}L("pass","sync",`${e.features.length} features valid`),G.exit(0)}catch(e){L("fail","sync",e.message),G.exit(1)}}function n5e(t){if(!t){L("fail","checkpoint","feature id required (e.g. clad checkpoint F-001)"),G.exit(2);return}let e=A_(".",t),r=e.gitHead?e.gitHead.slice(0,12):"(no git)";L("pass",`checkpoint \xB7 ${t}`,`head=${r} digest=${e.specDigest.slice(0,12)}`),G.exit(0)}function i5e(t,e={}){if(!t){L("fail","rollback","feature id required (e.g. clad rollback F-001)"),G.exit(2);return}let r=T_(".",t);if(!r){L("fail",`rollback \xB7 ${t}`,"no prior checkpoint recorded"),G.exit(1);return}O_(".",t,r,e.reason);let n=r.gitHead?r.gitHead.slice(0,12):"(no git)";L("note",`rollback \xB7 ${t}`,`recorded \u2014 run the printed command to apply (cladding does not execute git) \xB7 target head=${n} ts=${r.timestamp}`),r.gitHead?G.stdout.write(`Run: git checkout ${r.gitHead} +`));G.exit(0)}async function i5e(t,e){L("note","run","EXPERIMENTAL \u2014 prefer the host-delegated path (clad serve + your AI host). See docs/feature-cycle.md \xA7 Execution surface.");let{runDriveLoop:r}=await Promise.resolve().then(()=>(Mde(),jde)),n=await r({cwd:e.cwd,goal:t,budget:{maxIterations:Number(e.maxIterations),maxWallClockMs:Number(e.maxWallClockMs),maxRetriesPerFeature:Number(e.maxRetries)}}),i=n.halt.class==="ALL_FEATURES_DONE"?"pass":"note";if(e.json)L(i,"run",`halt=${n.halt.class} iter=${n.iterations} features=${n.featuresTouched.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`),G.stdout.write(`${JSON.stringify(n,null,2)} +`);else{let s=q(e.cwd??"."),a=n.featuresTouched.map(l=>oR(l,s)),c=`${mG(n.halt,s)} iter=${n.iterations} features=${a.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`;L(i,"run",c),a.length>0&&G.stdout.write(`Touched: ${a.join(", ")} +`)}let o=n.stubsCreated.length>0;o&&L("fail","run",`produced ${n.stubsCreated.length} empty auto-stub(s) and implemented nothing \u2014 the headless code-author needs a real LLM transport (set ANTHROPIC_API_KEY) or use the host-delegated path (clad serve + your AI host). This run did NOT do the work.`),G.exit(n.halt.class==="ALL_FEATURES_DONE"&&!o?0:1)}function o5e(t={}){try{let e=q();if(ya("."))L("note","sync","derived-file writes deferred \u2014 git operation in progress; re-run after the merge/rebase completes.");else{let r=_s(".");Vl(".",r),Wa("."),F5(".");let n=ru(".");n==="created"?L("note","agents.md","wrote a spec-driven AGENTS.md so non-Claude agents share the same guidance."):n==="updated"&&L("note","agents.md","refreshed the AGENTS.md managed block from the current spec.");let i=Bte(".");for(let s of i.repaired)L("note","test_refs",`repaired ${s.from} \u2192 ${s.to} (${s.shard})`);for(let s of i.suggested)L("note","test_refs",`suggested ${s.ref} (${s.shard}) \u2014 confirm by removing the 'derived:' prefix`);let o=Xx(".");o&&L("note","deliverable",`auto-detected entry '${o.path}' \u2014 the gate now smoke-tests it. Opt out with is_safe_to_smoke: false.`)}if(t.proposeArchive){let n=oS.run({cwd:"."}).filter(i=>i.suggestion?.action==="propose-archive");if(n.length===0){L("pass","sync",`${e.features.length} features \xB7 0 archive candidates`),G.exit(0);return}for(let i of n){let o=i.suggestion?.args??{},s=String(o.featureId??"?"),a=String(o.reason??i.message);L("note",`propose-archive \xB7 ${s}`,a)}L("pass","sync",`${e.features.length} features \xB7 ${n.length} archive candidate(s)`),G.exit(0);return}L("pass","sync",`${e.features.length} features valid`),G.exit(0)}catch(e){L("fail","sync",e.message),G.exit(1)}}function s5e(t){if(!t){L("fail","checkpoint","feature id required (e.g. clad checkpoint F-001)"),G.exit(2);return}let e=A_(".",t),r=e.gitHead?e.gitHead.slice(0,12):"(no git)";L("pass",`checkpoint \xB7 ${t}`,`head=${r} digest=${e.specDigest.slice(0,12)}`),G.exit(0)}function a5e(t,e={}){if(!t){L("fail","rollback","feature id required (e.g. clad rollback F-001)"),G.exit(2);return}let r=T_(".",t);if(!r){L("fail",`rollback \xB7 ${t}`,"no prior checkpoint recorded"),G.exit(1);return}O_(".",t,r,e.reason);let n=r.gitHead?r.gitHead.slice(0,12):"(no git)";L("note",`rollback \xB7 ${t}`,`recorded \u2014 run the printed command to apply (cladding does not execute git) \xB7 target head=${n} ts=${r.timestamp}`),r.gitHead?G.stdout.write(`Run: git checkout ${r.gitHead} `):G.stdout.write(`No git head pinned \u2014 restore spec.yaml manually from VCS history. -`),G.exit(0)}async function o5e(t){let e=t.host?t.host==="all"?["claude","codex","gemini","antigravity","cursor"].slice():[t.host]:void 0,r=await WC({force:t.force,quiet:t.quiet,projectRoot:t.project,hosts:e});G.exit(r.errors.length>0?1:0)}async function s5e(){L("note","update","reconciling the current project after the engine upgrade");let t=await BX(".",{wireHosts:async()=>(await WC({quiet:!0,projectRoot:"."})).errors.length});if(!t.isProject){L("skip","update","no spec.yaml here \u2014 nothing re-wired. Run `clad update` inside a cladding project, or `clad init` to start one."),G.exit(t.code);return}L(t.wiringErrors>0?"fail":"pass","hosts",t.wiringErrors>0?`${t.wiringErrors} wiring error(s)`:"re-wired"),t.inventoryDeferred?L("note","spec",`inventory + index writes deferred \u2014 git operation in progress; re-run \`clad update\` after it completes (${t.features} features seen).`):L("pass","spec",`inventory synced \xB7 ${t.features} features`),L(t.claudeMd==="refreshed-stale"?"note":"pass","CLAUDE.md",t.claudeMd),L(t.agentsMd==="refreshed-stale"?"note":"pass","AGENTS.md",t.agentsMd);for(let r of t.deprecations)L("note","deprecated",r);G.stdout.write(` +`),G.exit(0)}async function c5e(t){let e=t.host?t.host==="all"?["claude","codex","gemini","antigravity","cursor"].slice():[t.host]:void 0,r=await WC({force:t.force,quiet:t.quiet,projectRoot:t.project,hosts:e});G.exit(r.errors.length>0?1:0)}async function l5e(){L("note","update","reconciling the current project after the engine upgrade");let t=await ZX(".",{wireHosts:async()=>(await WC({quiet:!0,projectRoot:"."})).errors.length});if(!t.isProject){L("skip","update","no spec.yaml here \u2014 nothing re-wired. Run `clad update` inside a cladding project, or `clad init` to start one."),G.exit(t.code);return}L(t.wiringErrors>0?"fail":"pass","hosts",t.wiringErrors>0?`${t.wiringErrors} wiring error(s)`:"re-wired"),t.inventoryDeferred?L("note","spec",`inventory + index writes deferred \u2014 git operation in progress; re-run \`clad update\` after it completes (${t.features} features seen).`):L("pass","spec",`inventory synced \xB7 ${t.features} features`),L(t.claudeMd==="refreshed-stale"?"note":"pass","CLAUDE.md",t.claudeMd),L(t.agentsMd==="refreshed-stale"?"note":"pass","AGENTS.md",t.agentsMd);for(let r of t.deprecations)L("note","deprecated",r);G.stdout.write(` \u2192 drift check (report-only \xB7 does not block, does not edit your spec): -`),kA({tier:"pre-commit",strict:!0}).anyFailed?G.stdout.write("\n\u2139 The findings above are the bar this upgrade raised \u2014 not a failed update. Reconcile them in YOUR spec when ready (`clad check --strict` for the full gate).\n"):L("pass","drift","clean against the stricter detectors"),G.exit(t.code)}var a5e={"pre-commit":["stage_1.3","stage_1.5","stage_1.6"],"pre-push":["stage_1.1","stage_1.2","stage_1.3","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_2.3","stage_2.4"],all:["stage_1.1","stage_1.2","stage_1.3","stage_1.4","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_2.3","stage_2.4","stage_3.1","stage_3.2","stage_3.3","stage_4.1","stage_4.2"]};function kA(t){let e=t.tier??"all",r=t.silent===!0,n=a5e[e];if(!n)return t.json&&!r?G.stdout.write(`${JSON.stringify({tier:e,error:`unknown tier '${e}'`,worst:2,anyFailed:!0,stages:[]},null,2)} -`):r||L("fail","check",`unknown --tier '${e}' (expected: pre-commit | pre-push | all)`),{worst:2,anyFailed:!0,stages:[]};let i={focusModules:t.focusModules},s=[["stage_1.1",()=>eh(i)],["stage_1.2",()=>Qm(i)],["stage_1.3",()=>oi({...i,strict:t.strict})],["stage_1.4",Mj],["stage_1.5",rc],["stage_1.6",Zp],["stage_2.1",()=>Wj({...i,strict:t.strict})],["stage_2.2",()=>Fj(i)],["stage_2.3",fC],["stage_2.4",qj],["stage_3.1",Bj],["stage_3.2",zj],["stage_3.3",Kj],["stage_4.1",Pj],["stage_4.2",th]].filter(([d])=>n.includes(d)),a=0,c=!1,l=d=>d==="pass"?"pass":d==="liveness"?"note":d==="na"?"skip":ci(d)?"fail":"skip",u=[];G_("."),pte(".");try{for(let[d,f]of s){let p=f({}),m=t.internal?d:Ta(d),h=RX(p);ci(h)&&(c=!0,a=Math.max(a,IX(p,h))),u.push({stage:d,label:m,status:h,exitCode:p.exitCode,stderr:p.stderr,findings:p.findings}),!t.json&&!r&&(L(l(h),m),ci(h)&&h5e(p))}}finally{V_(),hte()}if(t.strict)try{let d=q();for(let f of dte(d,u))a=Math.max(a,1),c=!0,u.push({stage:f.stage,label:f.label,status:"fail",exitCode:1,stderr:f.message}),!t.json&&!r&&L("fail",f.label,f.message)}catch{}if(t.strict&&(e==="pre-push"||e==="all")){let d=u.find(h=>h.stage==="stage_1.3"),f=(d?.findings??[]).filter(h=>h.severity==="error"||h.severity==="warn"),p=d?.status==="fail"&&f.length>0&&f.every(h=>h.detector==="STALE_ATTESTATION"),m=u.every(h=>h.stage==="stage_1.3"||!ci(h.status));if(p&&m&&d&&(d.status="pass",d.exitCode=0,d.stderr="stale attestation exempted \u2014 this run re-verified and re-attests",c=u.some(h=>ci(h.status)),a=c?Math.max(1,a):0,!t.json&&!r&&L("note","attestation","stale entries re-verified by this run \u2014 re-attesting")),!c&&!r)if(ya("."))t.json||L("note","attestation","deferred \u2014 git operation in progress; run the gate again after the merge/rebase completes.");else try{CG(".",q())&&(t.json||L("note","attestation","spec/attestation.yaml refreshed (verified tree stamped)"))}catch{}}return t.json&&!r?G.stdout.write(`${JSON.stringify({tier:e,worst:a,anyFailed:c,stages:u},null,2)} -`):c&&!r&&G.stdout.write("\n\u2139 Run `clad doctor` for the event log, or `clad sync` to check the spec. The findings above say what drifted and why.\n"),tr(".","gate_run",{tier:e,strict:t.strict===!0,worst:a,anyFailed:c}),{worst:a,anyFailed:c,stages:u}}function c5e(t){try{let e=q(),r=fl(e,t);G.stdout.write(`${JSON.stringify(r,null,2)} -`),G.exit("not_found"in r?1:0)}catch(e){L("fail","context",e.message),G.exit(1)}}function l5e(t,e={}){try{let r=q(),n=e.depth!==void 0?Number(e.depth):void 0,i=vr(r,t,{depth:n});G.stdout.write(`${JSON.stringify(i,null,2)} -`),G.exit("not_found"in i?1:0)}catch(r){L("fail","impact",r.message),G.exit(1)}}function u5e(t={}){try{let e=q(),r=t.ambiguity!==void 0?Number(t.ambiguity):void 0,i=dS(e,o=>{try{return jde(o,"utf8")}catch{return null}},r!==void 0?{maxOwnerAmbiguity:r}:{});G.stdout.write(`${JSON.stringify({suggestions:i.suggestions,new_edges:i.edges.length,already_declared:i.alreadyDeclared.length,dynamic_import_files:i.dynamicImportFiles},null,2)} -`),G.exit(0)}catch(e){L("fail","infer-deps",e.message),G.exit(1)}}function d5e(t={}){try{if(t.sessions){Yee(t);return}if(t.trend!==void 0&&t.trend!==!1){Xee(t);return}let e=q(),n=PH(e,o=>{try{return jde(o,"utf8")}catch{return null}},"."),i=DH(".",n);if(t.json)G.stdout.write(`${JSON.stringify(n,null,2)} +`),kA({tier:"pre-commit",strict:!0}).anyFailed?G.stdout.write("\n\u2139 The findings above are the bar this upgrade raised \u2014 not a failed update. Reconcile them in YOUR spec when ready (`clad check --strict` for the full gate).\n"):L("pass","drift","clean against the stricter detectors"),G.exit(t.code)}var u5e={"pre-commit":["stage_1.3","stage_1.5","stage_1.6"],"pre-push":["stage_1.1","stage_1.2","stage_1.3","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_2.3","stage_2.4"],all:["stage_1.1","stage_1.2","stage_1.3","stage_1.4","stage_1.5","stage_1.6","stage_2.1","stage_2.2","stage_2.3","stage_2.4","stage_3.1","stage_3.2","stage_3.3","stage_4.1","stage_4.2"]};function kA(t){let e=t.tier??"all",r=t.silent===!0,n=u5e[e];if(!n)return t.json&&!r?G.stdout.write(`${JSON.stringify({tier:e,error:`unknown tier '${e}'`,worst:2,anyFailed:!0,stages:[]},null,2)} +`):r||L("fail","check",`unknown --tier '${e}' (expected: pre-commit | pre-push | all)`),{worst:2,anyFailed:!0,stages:[]};let i={focusModules:t.focusModules},s=[["stage_1.1",()=>eh(i)],["stage_1.2",()=>Qm(i)],["stage_1.3",()=>oi({...i,strict:t.strict})],["stage_1.4",Fj],["stage_1.5",rc],["stage_1.6",Vp],["stage_2.1",()=>Kj({...i,strict:t.strict})],["stage_2.2",()=>Lj(i)],["stage_2.3",fC],["stage_2.4",Bj],["stage_3.1",Hj],["stage_3.2",Uj],["stage_3.3",Jj],["stage_4.1",Cj],["stage_4.2",th]].filter(([d])=>n.includes(d)),a=0,c=!1,l=d=>d==="pass"?"pass":d==="liveness"?"note":d==="na"?"skip":ci(d)?"fail":"skip",u=[];G_("."),gte(".");try{for(let[d,f]of s){let p=f({}),m=t.internal?d:Ta(d),h=CX(p);ci(h)&&(c=!0,a=Math.max(a,DX(p,h))),u.push({stage:d,label:m,status:h,exitCode:p.exitCode,stderr:p.stderr,findings:p.findings}),!t.json&&!r&&(L(l(h),m),ci(h)&&_5e(p))}}finally{V_(),_te()}if(t.strict)try{let d=q();for(let f of mte(d,u))a=Math.max(a,1),c=!0,u.push({stage:f.stage,label:f.label,status:"fail",exitCode:1,stderr:f.message}),!t.json&&!r&&L("fail",f.label,f.message)}catch{}if(t.strict&&(e==="pre-push"||e==="all")){let d=u.find(h=>h.stage==="stage_1.3"),f=(d?.findings??[]).filter(h=>h.severity==="error"||h.severity==="warn"),p=d?.status==="fail"&&f.length>0&&f.every(h=>h.detector==="STALE_ATTESTATION"),m=u.every(h=>h.stage==="stage_1.3"||!ci(h.status));if(p&&m&&d&&(d.status="pass",d.exitCode=0,d.stderr="stale attestation exempted \u2014 this run re-verified and re-attests",c=u.some(h=>ci(h.status)),a=c?Math.max(1,a):0,!t.json&&!r&&L("note","attestation","stale entries re-verified by this run \u2014 re-attesting")),!c&&!r)if(ya("."))t.json||L("note","attestation","deferred \u2014 git operation in progress; run the gate again after the merge/rebase completes.");else try{NG(".",q())&&(t.json||L("note","attestation","spec/attestation.yaml refreshed (verified tree stamped)"))}catch{}}return t.json&&!r?G.stdout.write(`${JSON.stringify({tier:e,worst:a,anyFailed:c,stages:u},null,2)} +`):c&&!r&&G.stdout.write("\n\u2139 Run `clad doctor` for the event log, or `clad sync` to check the spec. The findings above say what drifted and why.\n"),tr(".","gate_run",{tier:e,strict:t.strict===!0,worst:a,anyFailed:c}),{worst:a,anyFailed:c,stages:u}}function d5e(t){try{let e=q(),r=fl(e,t);G.stdout.write(`${JSON.stringify(r,null,2)} +`),G.exit("not_found"in r?1:0)}catch(e){L("fail","context",e.message),G.exit(1)}}function f5e(t,e={}){try{let r=q(),n=e.depth!==void 0?Number(e.depth):void 0,i=Sr(r,t,{depth:n});G.stdout.write(`${JSON.stringify(i,null,2)} +`),G.exit("not_found"in i?1:0)}catch(r){L("fail","impact",r.message),G.exit(1)}}function p5e(t={}){try{let e=q(),r=t.ambiguity!==void 0?Number(t.ambiguity):void 0,i=dS(e,o=>{try{return Lde(o,"utf8")}catch{return null}},r!==void 0?{maxOwnerAmbiguity:r}:{});G.stdout.write(`${JSON.stringify({suggestions:i.suggestions,new_edges:i.edges.length,already_declared:i.alreadyDeclared.length,dynamic_import_files:i.dynamicImportFiles},null,2)} +`),G.exit(0)}catch(e){L("fail","infer-deps",e.message),G.exit(1)}}function m5e(t={}){try{if(t.sessions){ete(t);return}if(t.trend!==void 0&&t.trend!==!1){tte(t);return}let e=q(),n=CH(e,o=>{try{return Lde(o,"utf8")}catch{return null}},"."),i=NH(".",n);if(t.json)G.stdout.write(`${JSON.stringify(n,null,2)} `);else{let o=n.context,s=o.truncatedCount>0?`budget enforces ${o.medianShrinkTruncated}x on ${o.truncatedCount} capped feature(s) (cap-driven)`:"no feature hit the budget cap",a=o.fitsCount>0?`${o.medianShrinkFit}x on ${o.fitsCount} fitting`:"none fit untruncated",c=[`graph efficiency \xB7 ${n.measured}/${n.featureCount} features`,` context: working-set ${o.medianSliceTokens} tok vs naive ${o.medianNaiveTokens} tok \u2014 ${s}, ${a}`,` uncapped structural slice = ${o.medianStructuralRatio}x of naive \u2014 the value is the guaranteed budget + wired needs/breaks/verify, not raw shrink`,` search: median ${n.search.medianDepth} hop(s) resolved (p95 ${n.search.p95Depth}), median ${n.search.medianEdges} edge(s)/feature (max hub ${n.search.maxEdges})`,` stability: median blast-radius coverage ${n.stability.medianCoverage}, median ${n.stability.medianRegressionTests} regression test(s) surfaced; stops ${JSON.stringify(n.stability.byStopReason)}`,` ${pl}`];G.stdout.write(`${c.join(` `)} -`),i.appended?L("note","measure","snapshot recorded to .cladding/measure.jsonl \u2014 see `clad measure --trend`"):i.reason==="deduped"?L("note","measure","commit+spec state unchanged since last snapshot \u2014 not recorded"):i.reason==="no_head"&&L("note","measure","no git HEAD \u2014 snapshot not recorded (commit first; a head-less line has no reproduce target)")}G.exit(0)}catch(e){L("fail","measure",e.message),G.exit(1)}}function f5e(t){let e;if(t.feature)try{let i=(q().features??[]).find(o=>o.id===t.feature||o.slug===t.feature);i||(L("fail","check",`no feature '${t.feature}' in spec \u2014 cannot scope gate`),G.exit(1)),e=i.modules}catch(n){L("fail","check",n.message),G.exit(1)}let r=kA({...t,focusModules:e});if(!t.json){let n=uX(".");n&&G.stdout.write(`\u2139 ${n} -`)}G.exitCode=r.worst}function p5e(t){let e=eX(".",t,{checkStages:kA,onIndex:Wa,gitOpInProgress:kO});L(e.ok?"pass":"fail",`done \xB7 ${t}`,e.reason),G.exit(e.code)}function m5e(t,e={}){let r=e.cwd??".",n;try{n=q(r)}catch(o){L("fail","oracle",`spec not loaded: ${o.message}`),G.exit(1);return}if(e.required){t&&G.stdout.write(`(note: --required lists the whole-project worklist; ignoring '${t}') -`);let o=U5(n);if(o.length===0){G.stdout.write(`No oracles required \u2014 set project.oracle_policy or require_oracles, or no done ACs match the policy. +`),i.appended?L("note","measure","snapshot recorded to .cladding/measure.jsonl \u2014 see `clad measure --trend`"):i.reason==="deduped"?L("note","measure","commit+spec state unchanged since last snapshot \u2014 not recorded"):i.reason==="no_head"&&L("note","measure","no git HEAD \u2014 snapshot not recorded (commit first; a head-less line has no reproduce target)")}G.exit(0)}catch(e){L("fail","measure",e.message),G.exit(1)}}function h5e(t){let e;if(t.feature)try{let i=(q().features??[]).find(o=>o.id===t.feature||o.slug===t.feature);i||(L("fail","check",`no feature '${t.feature}' in spec \u2014 cannot scope gate`),G.exit(1)),e=i.modules}catch(n){L("fail","check",n.message),G.exit(1)}let r=kA({...t,focusModules:e});if(!t.json){let n=pX(".");n&&G.stdout.write(`\u2139 ${n} +`)}G.exitCode=r.worst}function g5e(t){let e;try{e={policy:q(".").project.independence_policy??"label",evidence:fr(".")}}catch{e=void 0}let r=nX(".",t,{checkStages:kA,onIndex:Wa,gitOpInProgress:kO,independence:e});if(L(r.ok?"pass":"fail",`done \xB7 ${t}`,r.reason),r.independence){let n=r.independence==="independent"?"independence: independent \u2014 backed by human or independent review":"independence: self-certified \u2014 no independent or human review yet";L("note",`done \xB7 ${t}`,n)}G.exit(r.code)}function y5e(t,e={}){let r=e.cwd??".",n;try{n=q(r)}catch(o){L("fail","oracle",`spec not loaded: ${o.message}`),G.exit(1);return}if(e.required){t&&G.stdout.write(`(note: --required lists the whole-project worklist; ignoring '${t}') +`);let o=B5(n);if(o.length===0){G.stdout.write(`No oracles required \u2014 set project.oracle_policy or require_oracles, or no done ACs match the policy. `),G.exit(0);return}let s=o.filter(a=>!a.hasOracle);for(let a of o){let c=a.hasOracle?"\u2713":"\xB7",l=a.hasOracle?"":" \u2190 needs an impl-blind oracle";G.stdout.write(` ${c} ${a.featureId}.${a.acId} [${a.reason}${a.ears?`:${a.ears}`:""}]${l} `)}G.stdout.write(` ${o.length} AC(s) required, ${s.length} missing an oracle. -`),G.exit(s.length>0?1:0);return}if(!t){L("fail","oracle","provide a to print its blind brief, or --required to list the ACs the policy needs an oracle for"),G.exit(1);return}let i=Ute(n,t,e.ac,r);if(!i||i.acs.length===0){L("fail","oracle",`no acceptance criteria for ${t}${e.ac?`.${e.ac}`:""} \u2014 nothing to author a blind oracle from`),G.exit(1);return}G.stdout.write(`${qte(i)} -`),G.exit(0)}function h5e(t){if(t.findings&&t.findings.length>0){let e=t.findings.filter(i=>i.severity==="error"),r=t.findings.filter(i=>i.severity==="warn"),n=e.length>0?e:r;for(let i of n.slice(0,3)){let o=Nde(_l(i.detector,i.message),140),s=i.path?` \u2014 ${i.path}`:"";G.stdout.write(` ${o}${s} [${i.detector}] +`),G.exit(s.length>0?1:0);return}if(!t){L("fail","oracle","provide a to print its blind brief, or --required to list the ACs the policy needs an oracle for"),G.exit(1);return}let i=Hte(n,t,e.ac,r);if(!i||i.acs.length===0){L("fail","oracle",`no acceptance criteria for ${t}${e.ac?`.${e.ac}`:""} \u2014 nothing to author a blind oracle from`),G.exit(1);return}G.stdout.write(`${Gte(i)} +`),G.exit(0)}function _5e(t){if(t.findings&&t.findings.length>0){let e=t.findings.filter(i=>i.severity==="error"),r=t.findings.filter(i=>i.severity==="warn"),n=e.length>0?e:r;for(let i of n.slice(0,3)){let o=Fde(_l(i.detector,i.message),140),s=i.path?` \u2014 ${i.path}`:"";G.stdout.write(` ${o}${s} [${i.detector}] `)}n.length>3&&G.stdout.write(` \u2026 and ${n.length-3} more finding(s) `),t.hint&&G.stdout.write(` fix: run \`${t.hint}\` `);return}if(t.stderr&&t.stderr.trim().length>0){let e=t.stderr.split(` -`).find(r=>r.trim().length>0);e&&G.stdout.write(` ${Nde(e.trim(),160)} -`)}}function Nde(t,e){return t.length<=e?t:`${t.slice(0,e-1)}\u2026`}function g5e(t){let e=q();if(t.json){G.stdout.write(`${JSON.stringify(Qx(e,"."),null,2)} -`),G.exitCode=0;return}G.stdout.write(`${Bte(e,".",{internal:t.internal})} -`),G.exit(0)}function y5e(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function _5e(t){let e=t.cwd??".",r=(t.out??"").trim();if(r.length===0){L("fail","bundle","missing --out \u2014 the bundle needs a destination path"),G.exit(1);return}let n;try{let i=q(e),o=Qx(i,e),s={gitHead:va(e),version:Xl(),generatedAt:t.now??new Date().toISOString()},a=gl(i),c;try{let l=t.since??rs(e),u=ns(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:ml(u),auditMarkdown:hl(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=kG({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){L("fail","bundle",i.message),G.exit(1);return}try{X8e(r,n,"utf8")}catch(i){L("fail","bundle",`could not write ${r}: ${i.message}`),G.exit(1);return}L("pass","bundle",`${r} \xB7 ${y5e(Buffer.byteLength(n,"utf8"))}`),G.exit(0)}function b5e(t){let e=HA(t);L("note",`route \u2192 ${e}`,t),G.exit(e==="unknown"?1:0)}function v5e(){let t=new x4;t.name("clad").description("Reference Ironclad CLI").version("0.9.1"),t.command("init [intent...]").description("Scaffold a cladding workspace. Pass a free-text project description as positional argument (e.g. `clad init payment SaaS for B2B` \u2014 free text in any language) to drive intent-aware onboarding \u2014 the LLM dispatcher then produces domain-aware capabilities/architecture/project-context plus product-level follow-up questions. Bare `clad init` keeps the v0.3.42 behaviour (greenfield seeds, or observed scan when \u22653 source files exist).").option("-n, --name ","Project name (default: cwd basename)").option("-f, --force","Overwrite existing spec.yaml").option("--scan","Force-walk the existing codebase. Default auto-detects (\u22653 source files trigger scan). Use --no-scan to skip even when source is present.").option("--no-llm","Force the deterministic interpreter (skip the LLM dispatcher chain). Intent text falls back to a deterministic quote in project-context.md.").option("--roots ","Override scanner source roots, comma-separated (e.g. packages/a/src,packages/b/src). Otherwise inferred from manifests + directory heuristics.").option("--with-hook","Install git pre-commit (cheap tier) AND pre-push (strict tier) hooks. Opt-in; cladding never touches .git without it.").option("--with-ci","Scaffold .github/workflows/cladding.yml running the strict pre-push gate \u2014 the authoritative enforcement layer.").option("--json","emit the raw InitResult for tooling; default is the human-readable surface").action(e5e),t.command("run [goal]").description("(experimental) Headless autonomous loop \u2014 iterate ready features, dispatch developer + reviewer personas, run L1 gates, record evidence. The supported, exercised path is host-delegated (clad serve + your AI host loops the cadence); this loop needs a real LLM transport and is not auto-invoked").option("--cwd ","target project directory (default cwd)").option("--max-iterations ","cap iterations (default 50)","50").option("--max-wall-clock-ms ","cap wall clock (default 600000)","600000").option("--max-retries ","cap retries per feature (default 3)","3").option("--json","emit the raw internal result (Iron Core view); default is a plain Soft Shell summary").action(t5e),t.command("sync").description("Validate spec.yaml against schema and report").option("--propose-archive","list STALE_SPECIFICATION findings whose suggestion.action is propose-archive (Phased Decommissioning Tier 2)").action(r5e),t.command("setup").description("Activate Cladding only for the current project (Claude Code / Codex / Gemini / Antigravity / Cursor)").option("--project ","activate a project other than the current directory").option("--host ","activate detected hosts (default), all, or one of: claude, codex, gemini, antigravity, cursor").option("--force","replace an existing conflicting cladding-owned project entry").option("--quiet","suppress stdout output").action(o5e),t.command("update").description("Run from a project dir AFTER `npm update -g cladding`: refresh project host wiring + sync inventory + refresh managed CLAUDE.md/AGENTS.md, then report stricter detector findings").action(s5e),t.command("check").description("Run every Iron Law stage and the drift detector suite").option("--internal","show stage codes (`stage_1.1`) instead of names (`Type`)").option("--strict","promote warn-severity drift findings to errors (CI / pre-publish gate)").option("--tier ","run only the stages for a trigger: pre-commit (drift/arch/secret) | pre-push (+ type/lint/unit/cov/spec-conformance/deliverable-smoke) | all (default; full 15-stage gate, used by CI)").option("--json","emit structured per-stage results (machine-readable: findings with file/line/suggestion, untruncated) \u2014 for agents/CI; cuts RED\u2192fix round-trips").option("--feature ","scope the gate to this feature's modules[] (Gradle monorepos): runs only :project: tasks instead of the root aggregate. No-op for non-Gradle repos or modules-less features").action(f5e),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(n5e),t.command("done ").description("Mark a feature done ONLY if `clad check --tier=pre-push --strict` is GREEN (flip \u2192 gate \u2192 revert-on-red). Keeps `done` honest.").action(p5e),t.command("oracle [featureId]").description("Print the impl-blind oracle authoring brief (acceptance criteria + signatures, never the implementation). Hand it to a fresh blind sub-agent; record the result with clad_author_oracle. cladding calls no LLM. Use --required to list which done ACs the project policy needs an oracle for.").option("--ac ","restrict the brief to a single acceptance criterion").option("--required","list the done ACs the oracle_policy / require_oracles requires an oracle for (worklist), instead of a brief").option("--cwd ","project root (defaults to .)").action((r,n)=>m5e(r,n)),t.command("rollback ").description("Record a rollback event and print the maintainer-runnable git command for the latest checkpoint").option("-r, --reason ","optional free-text reason recorded on the event payload").action(i5e),t.command("status").description("Render the feature \xD7 stage integrity matrix (business titles; use --internal for raw F-NNN ids)").option("--internal","show internal F-NNN ids and stage codes").option("--json","emit the row model as JSON \u2014 the same feature \xD7 stage integrity matrix rendered to the terminal (columns + per-feature glyph cells), one SSoT for terminal, JSON, and the audit bundle").action(g5e),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(c5e),t.command("impact ").description("Print the blast radius for a change \u2014 what depends on a feature/file + the tests to re-run (F-7794a6bc)").option("--depth ","bound the dependent walk to N hops (default: the full transitive radius)").action((r,n)=>l5e(r,n)),t.command("verdict").description("One-poll loop decision: DONE|ITERATE|ESCALATE|BLOCKED|BOOTSTRAP over the pre-push strict gate + feature statuses (F-2e28cc72). Single gate touch; DONE requires \u22651 non-liveness proof.").option("--json","emit the verdict object as JSON").option("--tier ","gate tier (default pre-push)").action(r=>FX(r,{checkStages:kA})),t.command("infer-deps").description("Suggest feature depends_on edges from the code import graph \u2014 the dependency edges cladding never auto-produced (F-2be3e3bb). Prints reviewable suggestions; does not write the spec.").option("--ambiguity ","emit edges for imports owned by \u2264 N features (default 1 = unambiguous single-owner only)").action(r=>u5e(r)),t.command("measure").description("Report the search + context efficiency the graph provides per feature \u2014 working-set tokens vs the naive baseline, dependency depth/edges resolved, regression-set coverage (F-16138071). Deterministic; no agent.").option("--json","emit the full report as JSON").option("--sessions","summarize recorded value-delivery telemetry instead \u2014 impact-card fire rate over eligible edits, the per-reason skip histogram, and MCP read-serve counts. Measures DELIVERY (did the surfaces fire), NOT adoption (F-6ba22c5c).").option("--trend [n]","render the last N (default 5) recorded measure snapshots with signed deltas \u2014 spot efficiency drift over time from the deduped .cladding/measure.jsonl ledger (F-39609db4)").action(r=>d5e(r));let e=t.command("graph").description("Render the spec\u2194code\u2194doc knowledge graph for a viewer, or report its shape (F-569f4b37)");return e.command("export").description("Export the graph: mermaid/dot/json to stdout, or an Obsidian vault to --out").option("--format ","mermaid | dot | json | obsidian | html (default: mermaid). html = a single self-contained offline viewer (requires --out)").option("--focus ","restrict to a feature/file node\u2019s neighborhood (id, slug, or module path)").option("--depth ","neighborhood radius around --focus (default: unbounded)").option("--out ","write to a file (or, for obsidian, a vault dir \u2014 default .cladding/graph)").action(r=>cte(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>lte()),e.command("serve").description("Serve a LIVE graph at localhost \u2014 recomputes on each load + auto-reloads on spec/doc changes (F-64a5c159)").option("--port ","port to listen on (default 3000)").action(r=>{ute(r)}),t.command("changelog").description("Render shipped changes since a git ref into human-facing documents (F-904495a5). Default: capability-grouped markdown from feature titles + acceptance sentences (no internal ids). --json emits the deterministic manifest hosts render release notes from; --audit the id-keeping verification table; --catalog the full capability \u2192 feature \u2192 acceptance catalog.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--json","print the deterministic ChangelogManifest as JSON (byte-identical across runs on the same state)").option("--audit","print the audit table \u2014 feature | AC | EARS | verification refs, each marked resolved \u2713/\u2717").option("--catalog","print the full capability \u2192 feature \u2192 acceptance listing of the living spec (no git range)").option("--measure","embed the release's own re-derivable measurement \u2014 but ONLY a snapshot taken at the current HEAD; no match renders a not-measured notice, never an older snapshot (F-ede6fa75)").action(r=>fG(r)),t.command("report").description("Render one deterministic review packet for a git range (F-f6cc5e5a) \u2014 spec-shard movement (from the changelog), changed source files resolved to their owning features via the reverse index, the deduped regression set, and gate + attestation state. For PR reviewers, team-leads, and auditors: it RENDERS, it gates nothing. Byte-identical across two runs on the same repository state.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--format ","md (default, the four-section markdown packet) | sarif (SARIF 2.1.0 \u2014 one result per error/warn drift finding, for code-scanning UIs) | json (the raw deterministic model)").action(r=>wY(r)),t.command("bundle").description("Write ONE self-contained HTML audit bundle (F-e940fffe) a non-coder can double-click \u2014 offline, zero network, no CDN, no scripts. Contains the project header + inventory, the feature \xD7 stage matrix, the capability catalog, shipped changes for the range, the audit table with resolved refs, and the attestation summary, under a provenance banner (git HEAD, date, version). Deterministic modulo the date stamp. If no anchor ref resolves, the changelog + audit sections show an omitted notice while the rest still renders.").requiredOption("--out ","destination path for the HTML bundle").option("--since ","git ref to diff shipped changes from (default: the latest tag via `git describe --tags --abbrev=0`)").action(r=>_5e(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(b5e),t.command("hook ").description("Host hook protocol adapter \u2014 consume one host lifecycle event (SessionStart | UserPromptSubmit | PreToolUse | PostToolUse | Stop) as stdin JSON and print the protocol response on stdout. Always exits 0 so a hook failure never bricks the host session.").action(OX),t.command("serve").description("Run cladding as an MCP server over stdio \u2014 tools/resources/prompts for any MCP client").option("--cwd ","project directory exposed to the client (default cwd)").action(Q8e),t.command("doctor").description("Summarise .cladding/events.log.jsonl \u2014 sentinel-miss frequency by phase/cause/fallback plus the top missed sentinels (LLM dispatcher health check)").option("--cwd ","project directory to read events from (default cwd)").option("--json","emit the raw DoctorReport for tooling; default is the human-readable surface").option("--hosts","smoke-test host CLIs (Claude Code / Gemini / Antigravity / Codex / Cursor) and project wiring \u2192 dated artifact + docs/dogfood/matrix.md. Live LLM prompts run only with consent (CLAD_HOST_SMOKE=1 or --yes); otherwise not-run").option("--yes","grant live-run consent for --hosts (equivalent to CLAD_HOST_SMOKE=1)").option("--matrix-only","regenerate docs/dogfood/matrix.md from the newest host-smoke artifact without any probing").action(r=>{if(r.hosts||r.matrixOnly){YY({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}kY(r)}),t.command("clarify [answer...]").description("Advance the onboarding Q&A loop. Pass the user's answer to the next pending question as a positional (no quotes needed, free text in any language, e.g. `clad clarify B2B only`); the LLM refines spec/docs based on the full Q-A history and may emit new follow-up questions. Reads/writes `.cladding/onboarding/state.yaml`. Requires `clad init ` to have started a session first.").option("--cwd ","project directory containing .cladding/onboarding/state.yaml (default cwd)").option("--no-llm","force the deterministic interpreter (preserves current artifacts, logs the answer)").option("--json","emit the raw RefineReport for tooling; default is the human-readable surface").action(Gee),t}var S5e=!!globalThis.__CLADDING_BUNDLED,w5e=S5e||import.meta.url===`file://${G.argv[1]}`;w5e&&v5e().parse();export{a5e as TIER_STAGES,v5e as createProgram,_5e as runBundleCommand,f5e as runCheckCommand,kA as runCheckStages,n5e as runCheckpointCommand,c5e as runContextCommand,p5e as runDoneCommand,l5e as runImpactCommand,u5e as runInferDepsCommand,e5e as runInitCommand,d5e as runMeasureCommand,m5e as runOracleCommand,i5e as runRollbackCommand,b5e as runRouteCommand,t5e as runRunCommand,Q8e as runServeCommand,o5e as runSetupCommand,g5e as runStatusCommand,r5e as runSyncCommand,s5e as runUpdateCommand}; +`).find(r=>r.trim().length>0);e&&G.stdout.write(` ${Fde(e.trim(),160)} +`)}}function Fde(t,e){return t.length<=e?t:`${t.slice(0,e-1)}\u2026`}function b5e(t){let e=q();if(t.json){G.stdout.write(`${JSON.stringify(Qx(e,"."),null,2)} +`),G.exitCode=0;return}G.stdout.write(`${Zte(e,".",{internal:t.internal})} +`),G.exit(0)}function v5e(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function S5e(t){let e=t.cwd??".",r=(t.out??"").trim();if(r.length===0){L("fail","bundle","missing --out \u2014 the bundle needs a destination path"),G.exit(1);return}let n;try{let i=q(e),o=Qx(i,e),s={gitHead:va(e),version:Xl(),generatedAt:t.now??new Date().toISOString()},a=gl(i),c;try{let l=t.since??rs(e),u=ns(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:ml(u),auditMarkdown:hl(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=AG({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){L("fail","bundle",i.message),G.exit(1);return}try{t5e(r,n,"utf8")}catch(i){L("fail","bundle",`could not write ${r}: ${i.message}`),G.exit(1);return}L("pass","bundle",`${r} \xB7 ${v5e(Buffer.byteLength(n,"utf8"))}`),G.exit(0)}function w5e(t){let e=HA(t);L("note",`route \u2192 ${e}`,t),G.exit(e==="unknown"?1:0)}function x5e(){let t=new $4;t.name("clad").description("Reference Ironclad CLI").version("0.9.1"),t.command("init [intent...]").description("Scaffold a cladding workspace. Pass a free-text project description as positional argument (e.g. `clad init payment SaaS for B2B` \u2014 free text in any language) to drive intent-aware onboarding \u2014 the LLM dispatcher then produces domain-aware capabilities/architecture/project-context plus product-level follow-up questions. Bare `clad init` keeps the v0.3.42 behaviour (greenfield seeds, or observed scan when \u22653 source files exist).").option("-n, --name ","Project name (default: cwd basename)").option("-f, --force","Overwrite existing spec.yaml").option("--scan","Force-walk the existing codebase. Default auto-detects (\u22653 source files trigger scan). Use --no-scan to skip even when source is present.").option("--no-llm","Force the deterministic interpreter (skip the LLM dispatcher chain). Intent text falls back to a deterministic quote in project-context.md.").option("--roots ","Override scanner source roots, comma-separated (e.g. packages/a/src,packages/b/src). Otherwise inferred from manifests + directory heuristics.").option("--with-hook","Install git pre-commit (cheap tier) AND pre-push (strict tier) hooks. Opt-in; cladding never touches .git without it.").option("--with-ci","Scaffold .github/workflows/cladding.yml running the strict pre-push gate \u2014 the authoritative enforcement layer.").option("--json","emit the raw InitResult for tooling; default is the human-readable surface").action(n5e),t.command("run [goal]").description("(experimental) Headless autonomous loop \u2014 iterate ready features, dispatch developer + reviewer personas, run L1 gates, record evidence. The supported, exercised path is host-delegated (clad serve + your AI host loops the cadence); this loop needs a real LLM transport and is not auto-invoked").option("--cwd ","target project directory (default cwd)").option("--max-iterations ","cap iterations (default 50)","50").option("--max-wall-clock-ms ","cap wall clock (default 600000)","600000").option("--max-retries ","cap retries per feature (default 3)","3").option("--json","emit the raw internal result (Iron Core view); default is a plain Soft Shell summary").action(i5e),t.command("sync").description("Validate spec.yaml against schema and report").option("--propose-archive","list STALE_SPECIFICATION findings whose suggestion.action is propose-archive (Phased Decommissioning Tier 2)").action(o5e),t.command("setup").description("Activate Cladding only for the current project (Claude Code / Codex / Gemini / Antigravity / Cursor)").option("--project ","activate a project other than the current directory").option("--host ","activate detected hosts (default), all, or one of: claude, codex, gemini, antigravity, cursor").option("--force","replace an existing conflicting cladding-owned project entry").option("--quiet","suppress stdout output").action(c5e),t.command("update").description("Run from a project dir AFTER `npm update -g cladding`: refresh project host wiring + sync inventory + refresh managed CLAUDE.md/AGENTS.md, then report stricter detector findings").action(l5e),t.command("check").description("Run every Iron Law stage and the drift detector suite").option("--internal","show stage codes (`stage_1.1`) instead of names (`Type`)").option("--strict","promote warn-severity drift findings to errors (CI / pre-publish gate)").option("--tier ","run only the stages for a trigger: pre-commit (drift/arch/secret) | pre-push (+ type/lint/unit/cov/spec-conformance/deliverable-smoke) | all (default; full 15-stage gate, used by CI)").option("--json","emit structured per-stage results (machine-readable: findings with file/line/suggestion, untruncated) \u2014 for agents/CI; cuts RED\u2192fix round-trips").option("--feature ","scope the gate to this feature's modules[] (Gradle monorepos): runs only :project: tasks instead of the root aggregate. No-op for non-Gradle repos or modules-less features").action(h5e),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(s5e),t.command("done ").description("Mark a feature done ONLY if `clad check --tier=pre-push --strict` is GREEN (flip \u2192 gate \u2192 revert-on-red). Keeps `done` honest.").action(g5e),t.command("oracle [featureId]").description("Print the impl-blind oracle authoring brief (acceptance criteria + signatures, never the implementation). Hand it to a fresh blind sub-agent; record the result with clad_author_oracle. cladding calls no LLM. Use --required to list which done ACs the project policy needs an oracle for.").option("--ac ","restrict the brief to a single acceptance criterion").option("--required","list the done ACs the oracle_policy / require_oracles requires an oracle for (worklist), instead of a brief").option("--cwd ","project root (defaults to .)").action((r,n)=>y5e(r,n)),t.command("rollback ").description("Record a rollback event and print the maintainer-runnable git command for the latest checkpoint").option("-r, --reason ","optional free-text reason recorded on the event payload").action(a5e),t.command("status").description("Render the feature \xD7 stage integrity matrix (business titles; use --internal for raw F-NNN ids)").option("--internal","show internal F-NNN ids and stage codes").option("--json","emit the row model as JSON \u2014 the same feature \xD7 stage integrity matrix rendered to the terminal (columns + per-feature glyph cells), one SSoT for terminal, JSON, and the audit bundle").action(b5e),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(d5e),t.command("impact ").description("Print the blast radius for a change \u2014 what depends on a feature/file + the tests to re-run (F-7794a6bc)").option("--depth ","bound the dependent walk to N hops (default: the full transitive radius)").action((r,n)=>f5e(r,n)),t.command("verdict").description("One-poll loop decision: DONE|ITERATE|ESCALATE|BLOCKED|BOOTSTRAP over the pre-push strict gate + feature statuses (F-2e28cc72). Single gate touch; DONE requires \u22651 non-liveness proof.").option("--json","emit the verdict object as JSON").option("--tier ","gate tier (default pre-push)").action(r=>UX(r,{checkStages:kA})),t.command("infer-deps").description("Suggest feature depends_on edges from the code import graph \u2014 the dependency edges cladding never auto-produced (F-2be3e3bb). Prints reviewable suggestions; does not write the spec.").option("--ambiguity ","emit edges for imports owned by \u2264 N features (default 1 = unambiguous single-owner only)").action(r=>p5e(r)),t.command("measure").description("Report the search + context efficiency the graph provides per feature \u2014 working-set tokens vs the naive baseline, dependency depth/edges resolved, regression-set coverage (F-16138071). Deterministic; no agent.").option("--json","emit the full report as JSON").option("--sessions","summarize recorded value-delivery telemetry instead \u2014 impact-card fire rate over eligible edits, the per-reason skip histogram, and MCP read-serve counts. Measures DELIVERY (did the surfaces fire), NOT adoption (F-6ba22c5c).").option("--trend [n]","render the last N (default 5) recorded measure snapshots with signed deltas \u2014 spot efficiency drift over time from the deduped .cladding/measure.jsonl ledger (F-39609db4)").action(r=>m5e(r));let e=t.command("graph").description("Render the spec\u2194code\u2194doc knowledge graph for a viewer, or report its shape (F-569f4b37)");return e.command("export").description("Export the graph: mermaid/dot/json to stdout, or an Obsidian vault to --out").option("--format ","mermaid | dot | json | obsidian | html (default: mermaid). html = a single self-contained offline viewer (requires --out)").option("--focus ","restrict to a feature/file node\u2019s neighborhood (id, slug, or module path)").option("--depth ","neighborhood radius around --focus (default: unbounded)").option("--out ","write to a file (or, for obsidian, a vault dir \u2014 default .cladding/graph)").action(r=>dte(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>fte()),e.command("serve").description("Serve a LIVE graph at localhost \u2014 recomputes on each load + auto-reloads on spec/doc changes (F-64a5c159)").option("--port ","port to listen on (default 3000)").action(r=>{pte(r)}),t.command("changelog").description("Render shipped changes since a git ref into human-facing documents (F-904495a5). Default: capability-grouped markdown from feature titles + acceptance sentences (no internal ids). --json emits the deterministic manifest hosts render release notes from; --audit the id-keeping verification table; --catalog the full capability \u2192 feature \u2192 acceptance catalog.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--json","print the deterministic ChangelogManifest as JSON (byte-identical across runs on the same state)").option("--audit","print the audit table \u2014 feature | AC | EARS | verification refs, each marked resolved \u2713/\u2717").option("--catalog","print the full capability \u2192 feature \u2192 acceptance listing of the living spec (no git range)").option("--measure","embed the release's own re-derivable measurement \u2014 but ONLY a snapshot taken at the current HEAD; no match renders a not-measured notice, never an older snapshot (F-ede6fa75)").action(r=>pG(r)),t.command("report").description("Render one deterministic review packet for a git range (F-f6cc5e5a) \u2014 spec-shard movement (from the changelog), changed source files resolved to their owning features via the reverse index, the deduped regression set, and gate + attestation state. For PR reviewers, team-leads, and auditors: it RENDERS, it gates nothing. Byte-identical across two runs on the same repository state.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--format ","md (default, the four-section markdown packet) | sarif (SARIF 2.1.0 \u2014 one result per error/warn drift finding, for code-scanning UIs) | json (the raw deterministic model)").action(r=>$Y(r)),t.command("bundle").description("Write ONE self-contained HTML audit bundle (F-e940fffe) a non-coder can double-click \u2014 offline, zero network, no CDN, no scripts. Contains the project header + inventory, the feature \xD7 stage matrix, the capability catalog, shipped changes for the range, the audit table with resolved refs, and the attestation summary, under a provenance banner (git HEAD, date, version). Deterministic modulo the date stamp. If no anchor ref resolves, the changelog + audit sections show an omitted notice while the rest still renders.").requiredOption("--out ","destination path for the HTML bundle").option("--since ","git ref to diff shipped changes from (default: the latest tag via `git describe --tags --abbrev=0`)").action(r=>S5e(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(w5e),t.command("hook ").description("Host hook protocol adapter \u2014 consume one host lifecycle event (SessionStart | UserPromptSubmit | PreToolUse | PostToolUse | Stop) as stdin JSON and print the protocol response on stdout. Always exits 0 so a hook failure never bricks the host session.").action(PX),t.command("serve").description("Run cladding as an MCP server over stdio \u2014 tools/resources/prompts for any MCP client").option("--cwd ","project directory exposed to the client (default cwd)").action(r5e),t.command("doctor").description("Summarise .cladding/events.log.jsonl \u2014 sentinel-miss frequency by phase/cause/fallback plus the top missed sentinels (LLM dispatcher health check)").option("--cwd ","project directory to read events from (default cwd)").option("--json","emit the raw DoctorReport for tooling; default is the human-readable surface").option("--hosts","smoke-test host CLIs (Claude Code / Gemini / Antigravity / Codex / Cursor) and project wiring \u2192 dated artifact + docs/dogfood/matrix.md. Live LLM prompts run only with consent (CLAD_HOST_SMOKE=1 or --yes); otherwise not-run").option("--yes","grant live-run consent for --hosts (equivalent to CLAD_HOST_SMOKE=1)").option("--matrix-only","regenerate docs/dogfood/matrix.md from the newest host-smoke artifact without any probing").action(r=>{if(r.hosts||r.matrixOnly){QY({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}AY(r)}),t.command("clarify [answer...]").description("Advance the onboarding Q&A loop. Pass the user's answer to the next pending question as a positional (no quotes needed, free text in any language, e.g. `clad clarify B2B only`); the LLM refines spec/docs based on the full Q-A history and may emit new follow-up questions. Reads/writes `.cladding/onboarding/state.yaml`. Requires `clad init ` to have started a session first.").option("--cwd ","project directory containing .cladding/onboarding/state.yaml (default cwd)").option("--no-llm","force the deterministic interpreter (preserves current artifacts, logs the answer)").option("--json","emit the raw RefineReport for tooling; default is the human-readable surface").action(Wee),t}var $5e=!!globalThis.__CLADDING_BUNDLED,k5e=$5e||import.meta.url===`file://${G.argv[1]}`;k5e&&x5e().parse();export{u5e as TIER_STAGES,x5e as createProgram,S5e as runBundleCommand,h5e as runCheckCommand,kA as runCheckStages,s5e as runCheckpointCommand,d5e as runContextCommand,g5e as runDoneCommand,f5e as runImpactCommand,p5e as runInferDepsCommand,n5e as runInitCommand,m5e as runMeasureCommand,y5e as runOracleCommand,a5e as runRollbackCommand,w5e as runRouteCommand,i5e as runRunCommand,r5e as runServeCommand,c5e as runSetupCommand,b5e as runStatusCommand,o5e as runSyncCommand,l5e as runUpdateCommand}; diff --git a/plugins/claude-code/dist/schema.json b/plugins/claude-code/dist/schema.json index 6092fd53..ab51e642 100644 --- a/plugins/claude-code/dist/schema.json +++ b/plugins/claude-code/dist/schema.json @@ -60,6 +60,11 @@ } } }, + "independence_policy": { + "type": "string", + "enum": ["label", "require"], + "description": "Independence policy (F-c566f590). 'label' (default when absent) annotates each done feature independent | self-certified. 'require' additionally refuses to keep a self-certified feature done — a GREEN gate no longer suffices; the feature needs human or blind (independent) evidence first." + }, "deliverable": { "type": "object", "additionalProperties": false, diff --git a/spec.yaml b/spec.yaml index 4fcae76c..d5067be3 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 263 + features: 264 scenarios: 2 capabilities: 6 - test_files: 244 + test_files: 247 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index ea220c95..f44bb9e2 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 5279f49be32246a1 - README.ja.md: 7500babce103dd55 - README.ko.html: 68cb46e739415abc - README.ko.md: fe0f25795546c550 - README.md: bd81ec36d52b7118 - README.zh.md: d139855a357f0818 + README.html: 9331b224418db417 + README.ja.md: 0a881dcd6c85e9cb + README.ko.html: ba1c4320790711ee + README.ko.md: cb0e7eeed7a99c2d + README.md: 15b51a731f00c15a + README.zh.md: 82773227bebb9549 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -113,7 +113,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: f03bdc6a66336832 + spec.yaml: 28d9036872b760bf spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -146,11 +146,11 @@ attested_modules: src/cli: a4d0f0eb87fed960 src/cli/benchmark.ts: 77f84d2a898d724f src/cli/changelog.ts: 2de1adb009b89ab4 - src/cli/clad.ts: e882d44ef304fce0 + src/cli/clad.ts: ec45cced5dc7e3ac src/cli/clarify.ts: f17177969d5b75ff src/cli/doctor-hosts.ts: 1f0c2cec5a310b81 src/cli/doctor.ts: b98b955fe75e7f7e - src/cli/done.ts: 7eba807b6ec5a1aa + src/cli/done.ts: b4c8ed409f001487 src/cli/enforcement-advisory.ts: 395c5be696e88b5c src/cli/graph-serve.ts: 23e6e389225d0f98 src/cli/graph.ts: bab410061b8c746a @@ -178,7 +178,7 @@ attested_modules: src/cli/scan/types.ts: ea0170aa88c1c14a src/cli/scan/walker.ts: 33e4448e365e47c6 src/cli/update.ts: b0151396c9a0f6ca - src/cli/verdict.ts: 7aa16b8739ab8e5f + src/cli/verdict.ts: 85a4ef27292b9169 src/core/checkpoint.ts: 63300c2764533b6c src/core/git-ops.ts: 4544bde493a0628f src/core/postmortem.ts: 73be29d5e8a16fd4 @@ -202,6 +202,7 @@ attested_modules: src/hitl/anti-self-cert.ts: 53a714d8e489d00a src/hitl/audit.ts: 79b06e904815469a src/hitl/identity.ts: 52ff84aa666f1dab + src/hitl/independence.ts: 202f4e5ef8bc69e3 src/init/agents-md.ts: 3eb5ed2c7b6edc8c src/init/git-hook.ts: b77910b0df392cbf src/init/host-instructions.ts: c598f8598d8d1cd4 @@ -241,9 +242,9 @@ attested_modules: src/spec/new.ts: 4c91f6d41acaab69 src/spec/parse.ts: 1eab9a28c9359a45 src/spec/reverse-index.ts: d8b003eb8f1918c8 - src/spec/schema.json: 030d3741f2b38159 + src/spec/schema.json: 848951cd01d7f82f src/spec/test-ref-repair.ts: 5ce823b479aaaca3 - src/spec/types.ts: bd5833feabcdb787 + src/spec/types.ts: 5799bc9fc1e00553 src/spec/validate.ts: db88ca6512ab363a src/stages: a4d0f0eb87fed960 src/stages/README.md: c79d2bced8c8b8d8 @@ -327,9 +328,9 @@ attested_modules: src/ui: a4d0f0eb87fed960 src/ui/panel.ts: 8b78cb14dafb28fb src/ui/pulse.ts: ee4255f5c6e49f51 - src/ui/softShell.ts: 57a9b5d02fc94339 + src/ui/softShell.ts: f21a30930c164afd src/verdict/gate-progress.ts: ac75e3082cc97a40 - src/verdict/verdict.ts: 493251b3a2c494d3 + src/verdict/verdict.ts: 2dcfb0e7408bd28d tests/adapters/anthropic.test.ts: fa2fc7faf032a782 tests/adapters/index.test.ts: 4454e6b4ea05a74f tests/adapters/transport.test.ts: 68f22e9e8df7b813 @@ -650,6 +651,7 @@ attested_features: F-c3747d7d: ok F-c48eb2: ok F-c4c5ae: ok + F-c566f590: ok F-c58263b8: ok F-c6a32fff: ok F-c6c3daaf: ok diff --git a/spec/features/independence-label-c566f590.yaml b/spec/features/independence-label-c566f590.yaml new file mode 100644 index 00000000..c6115182 --- /dev/null +++ b/spec/features/independence-label-c566f590.yaml @@ -0,0 +1,41 @@ +id: F-c566f590 +slug: independence-label +title: "clad done/verdict carry an evidence-based independence label" +status: done +modules: + - src/hitl/independence.ts + - src/cli/done.ts + - src/cli/verdict.ts + - src/verdict/verdict.ts + - src/cli/clad.ts + - src/spec/types.ts +acceptance_criteria: + - id: AC-e216b03f + ears: ubiquitous + response: "computeIndependence(featureId, evidence) → {label: 'independent' | 'self-certified', basis}" + text: "computeIndependence shall label a feature 'independent' when at least one of its evidence entries is human-authored or blind-authored (blind: true), and 'self-certified' otherwise — including when the feature has no evidence at all." + test_refs: ["tests/hitl/independence.test.ts"] + - id: AC-d5210389 + ears: event + condition: "when clad done runs" + action: "the DoneResult and the recorded done_attempted event shall carry the feature's computed independence label" + response: "DoneResult.independence + done_attempted payload.independence" + text: "When clad done runs, the DoneResult and the recorded done_attempted event shall carry the feature's computed independence label." + test_refs: ["tests/cli/done-independence.test.ts"] + - id: AC-6f228987 + ears: ubiquitous + response: "clad verdict --json includes independence[] for done features; computeVerdict stays IO-free" + text: "clad verdict shall include per-done-feature independence labels in its --json output, computed in the CLI wrapper from the evidence ledger; the pure reducer computeVerdict shall remain IO-free." + test_refs: ["tests/cli/verdict-independence.test.ts"] + - id: AC-ad5ea48b + ears: state + condition: "while project.independence_policy is 'require'" + action: "clad done shall refuse to keep a self-certified feature done, reverting the spec entry and asking for independent or human review" + response: "runDone refuses (ok: false, shard reverted) under independence_policy: require + self-certified" + text: "While project.independence_policy is 'require', clad done shall refuse to keep a self-certified feature done — reverting the spec entry and asking for independent or human review; under the default 'label' policy the transition completes and is only labeled." + test_refs: ["tests/cli/done-independence.test.ts"] +design_impact: + classification: additive + rationale: "Adds an evidence-derived independence layer (label by default, opt-in require policy) to the done/verdict surfaces. Default-policy behavior of existing projects is unchanged — the label is additive audit data; refusal only activates when a project opts in via project.independence_policy." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index 6c0a8519..cc0a5de0 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -224,6 +224,7 @@ features: F-c3747d7d: {slug: spec-first-window-complete, status: done, modules: 5} F-c48eb2: {slug: scan-source-roots, status: done, modules: 5} F-c4c5ae: {slug: spec-conformance-oracle-stage, status: done, modules: 11} + F-c566f590: {slug: independence-label, status: done, modules: 6} F-c58263b8: {slug: code-compact, status: done, modules: 12} F-c6a32fff: {slug: graph-honest-fallback, status: done, modules: 7} F-c6c3daaf: {slug: kotlin-module-scoped-gate, status: done, modules: 13} diff --git a/src/cli/clad.ts b/src/cli/clad.ts index 5eeac088..8378f636 100644 --- a/src/cli/clad.ts +++ b/src/cli/clad.ts @@ -69,6 +69,7 @@ import {writeAttestation} from '../spec/attestation.js'; import {buildBlindPayload, renderBlindBrief} from '../oracle/payload.js'; import {requiredOracleWorklist} from '../oracle/policy.js'; import {loadSpec} from '../spec/load.js'; +import {readEvidence} from '../hitl/audit.js'; import {pulse, type PulseKind} from '../ui/pulse.js'; import {buildPanelModel, renderPanel} from '../ui/panel.js'; import {featureLabel, gateLabel, haltMessage, plainLead} from '../ui/softShell.js'; @@ -845,8 +846,33 @@ export function runCheckCommand(opts: {internal?: boolean; strict?: boolean; tie * so `done` cannot claim more than the gate verifies. @see cli/done.ts */ export function runDoneCommand(featureId: string): void { - const r = runDone('.', featureId, {checkStages: runCheckStages, onIndex: writeFeatureIndex, gitOpInProgress: gitOperationInProgressName}); + // F-c566f590 — load the project's independence policy + the evidence ledger and + // hand them to runDone as its optional independence seam. A spec that will not + // load simply omits the seam (runDone finds the shard directly and stays on its + // pre-independence path). readEvidence is read-only. + let independence: {policy: 'label' | 'require'; evidence: ReturnType} | undefined; + try { + const spec = loadSpec('.'); + independence = {policy: spec.project.independence_policy ?? 'label', evidence: readEvidence('.')}; + } catch { + independence = undefined; + } + const r = runDone('.', featureId, { + checkStages: runCheckStages, + onIndex: writeFeatureIndex, + gitOpInProgress: gitOperationInProgressName, + independence, + }); pulse(r.ok ? 'pass' : 'fail', `done · ${featureId}`, r.reason); + // Surface the independence label as a concise plain note (only once the gate + // actually ran — the early refusals carry no label). Soft-shell wording. + if (r.independence) { + const line = + r.independence === 'independent' + ? 'independence: independent — backed by human or independent review' + : 'independence: self-certified — no independent or human review yet'; + pulse('note', `done · ${featureId}`, line); + } process.exit(r.code); } diff --git a/src/cli/done.ts b/src/cli/done.ts index ce7e227a..38146ccb 100644 --- a/src/cli/done.ts +++ b/src/cli/done.ts @@ -22,7 +22,9 @@ import {recordEvent} from '../events/log.js'; import {join} from 'node:path'; import {parseSpec} from '../spec/parse.js'; -import {doneRefusalLead} from '../ui/softShell.js'; +import {doneRefusalLead, doneSelfCertRefusalLead} from '../ui/softShell.js'; +import {computeIndependence, type IndependenceLabel} from '../hitl/independence.js'; +import type {Evidence} from '../hitl/identity.js'; import type {GitOperation} from '../core/git-ops.js'; /** Gate runner injected so tests can drive `runDone` without spawning tsc/vitest. */ @@ -49,6 +51,22 @@ export interface DoneDeps { * any shard, index, or attestation write. */ readonly gitOpInProgress?: (cwd: string) => GitOperation | null; + /** + * OPTIONAL independence seam (F-c566f590). When present, runDone computes the + * feature's evidence-based independence label from `evidence` and threads it + * into the DoneResult + the done_attempted event. Under `policy: 'require'` it + * additionally REFUSES to keep a self-certified feature done (revert + re-sync, + * exactly like a red gate). Injected + optional so runDone stays hermetic — no + * loadSpec / readEvidence inside; an omitted dep behaves exactly as before + * (label absent). Wired to project.independence_policy + readEvidence in + * runDoneCommand. + */ + readonly independence?: { + /** 'label' = annotate only (default); 'require' = block a self-certified done. */ + readonly policy: 'label' | 'require'; + /** The evidence ledger slice runDone weighs the feature against. */ + readonly evidence: readonly Evidence[]; + }; } /** Outcome of a `clad done` attempt — `code` is the process exit code. */ @@ -58,6 +76,13 @@ export interface DoneResult { readonly featureId: string; readonly prevStatus?: string; readonly shardPath?: string; + /** + * The feature's evidence-based independence label (F-c566f590). Present only + * once the gate has run with an injected `independence` dep; absent on the + * early refusals (git-op / missing shard / design impact) and when no dep was + * supplied. + */ + readonly independence?: IndependenceLabel; readonly reason: string; } @@ -175,33 +200,74 @@ export function runDone(cwd: string, featureId: string, deps: DoneDeps): DoneRes strict: true, focusModules: hit.modules, }); - // F-b84c38 — every done transition (kept or reverted) is forensic data. - recordEvent(cwd, 'done_attempted', {feature: featureId, worst, anyFailed: anyFailed ?? worst > 0, kept: worst === 0}); - if (worst === 0) { + // F-c566f590 — the evidence-based independence label. Computed once from the + // injected evidence slice (an omitted dep ⇒ undefined ⇒ pre-independence + // behavior). It does NOT depend on the gate: a feature can be GREEN yet still + // be self-certified (no human/blind evidence backs it). + const independence = deps.independence + ? computeIndependence(featureId, deps.independence.evidence).label + : undefined; + // Under the opt-in `require` policy a GREEN gate is necessary but NOT + // sufficient: a self-certified feature must earn independent or human review + // before it keeps done. This refusal reverts exactly like a red gate — but a + // genuinely red gate takes precedence (its message stays unchanged). + const selfCertBlocked = + worst === 0 && deps.independence?.policy === 'require' && independence === 'self-certified'; + const kept = worst === 0 && !selfCertBlocked; + // F-b84c38 — every done transition (kept or reverted) is forensic data; the + // independence label rides along on both paths (F-c566f590). + recordEvent(cwd, 'done_attempted', { + feature: featureId, + worst, + anyFailed: anyFailed ?? worst > 0, + kept, + ...(independence ? {independence} : {}), + }); + if (kept) { return { ok: true, code: 0, featureId, prevStatus: hit.status, shardPath: hit.path, + independence, reason: `strict gate GREEN — status: ${hit.status || 'unset'} → done`, }; } - // Red gate: the feature has not earned done. Revert to exactly what was there. + // Not kept — revert to exactly what was there and re-sync the index + // symmetrically, else it would keep the pre-gate `done` row against a reverted + // shard (inverse staleness). (F-37b4a8) BOTH the red-gate and the + // require-policy refusal share this revert. writeFileSync(hit.path, original); - // Shard restored → re-sync the index symmetrically, else it would keep the - // pre-gate `done` row against a reverted shard (inverse staleness). (F-37b4a8) deps.onIndex?.(cwd); // Plain-first (F-dd8dc994): a plain English lead first; the machine sentence // (kept byte-for-byte) follows as a language-neutral tail so contract pins - // ('not GREEN', 'status left at') survive. The host agent renders the user's - // own language (F-9af291fa). + // survive. The host agent renders the user's own language (F-9af291fa). + if (selfCertBlocked) { + // GREEN gate, but the project requires the independent review this feature + // lacks (AC-ad5ea48b). Same revert as a red gate; a different plain lead. + return { + ok: false, + code: 1, + featureId, + prevStatus: hit.status, + shardPath: hit.path, + independence, + reason: + `${doneSelfCertRefusalLead()}. ` + + `no independent or human review backs this feature — status left at '${hit.status || 'unset'}'.` + + ' Add a human sign-off or an independent (blind) review, then re-run `clad done`.', + }; + } + // Red gate: the feature has not earned done. Contract pins ('not GREEN', + // 'status left at') survive in the machine tail. return { ok: false, code: 1, featureId, prevStatus: hit.status, shardPath: hit.path, + independence, reason: `${doneRefusalLead()}. ` + `strict gate not GREEN — status left at '${hit.status || 'unset'}'.` + diff --git a/src/cli/verdict.ts b/src/cli/verdict.ts index 8cf98710..e7d9be0e 100644 --- a/src/cli/verdict.ts +++ b/src/cli/verdict.ts @@ -17,6 +17,8 @@ import {dirname, join} from 'node:path'; import process from 'node:process'; import {loadSpec} from '../spec/load.js'; +import {readEvidence} from '../hitl/audit.js'; +import {independenceSummary} from '../hitl/independence.js'; import {fingerprintFindings, nextProgress, type ProgressState} from '../verdict/gate-progress.js'; import {computeVerdict, type Verdict, type VerdictOutcome} from '../verdict/verdict.js'; @@ -91,7 +93,13 @@ export function runVerdictCommand(opts: {json?: boolean; tier?: string}, deps: V const prog = nextProgress(currentFp, prior); writeProgress({fingerprint: prog.fingerprint, repeat: prog.repeat}); - const v = computeVerdict({outcome, spec, stuck: prog.stuck}); + // F-c566f590 — annotate each DONE feature with its evidence-based independence + // label, computed HERE (CLI wrapper) from the read-only ledger so the pure + // reducer stays IO-free (AC-6f228987). Reading evidence touches no tracked file + // → the poll-not-mutate lock (module header) holds. + const doneIds = spec.features.filter((f) => f.status === 'done').map((f) => f.id); + const summary = independenceSummary(doneIds, readEvidence(process.cwd())); + const v: Verdict = {...computeVerdict({outcome, spec, stuck: prog.stuck}), independence: summary.labels}; emit(v, opts.json === true); process.exit(0); } @@ -103,5 +111,14 @@ function emit(v: Verdict, json: boolean): void { return; } const tail = v.next_action ? ` — ${v.next_action}` : ''; - process.stdout.write(`verdict: ${v.verdict}${tail}\n`); + // Append the independence split ONLY when at least one done feature is + // self-certified — the signal worth surfacing (an all-independent run stays + // quiet). The counts come straight off the labels the JSON already carries. + const labels = v.independence ?? []; + const selfCertified = labels.filter((l) => l.label === 'self-certified').length; + const indep = + selfCertified > 0 + ? ` — independence: ${labels.length - selfCertified} independent / ${selfCertified} self-certified` + : ''; + process.stdout.write(`verdict: ${v.verdict}${tail}${indep}\n`); } diff --git a/src/hitl/independence.ts b/src/hitl/independence.ts new file mode 100644 index 00000000..5115db89 --- /dev/null +++ b/src/hitl/independence.ts @@ -0,0 +1,94 @@ +// Cladding · HITL · independence label +// +// A companion to the anti-self-cert guard (anti-self-cert.ts). Where that guard +// HARD-BLOCKS an AC that only tool/LLM evidence backs, this module answers the +// softer, always-computable question: for a WHOLE feature, does ANY of its +// evidence come from an independent source? +// +// `independent` — at least one evidence entry is human-authored +// (identity.author === 'human') OR blind-authored +// (blind === true, structurally-guaranteed blindness). +// `self-certified` — everything else, INCLUDING a feature with no evidence +// at all. +// +// `self-certified` is a LABEL, not an accusation: it makes silent self-cert +// visible in the ledger (docs/feature-cycle.md calls this principle +// "independence"). It is deliberately NOT named "attested" — that word is spoken +// for by spec/attestation.yaml (the gate-hash record), a different concept. +// +// Pure + IO-free by contract: the caller passes the evidence slice in. Only +// `human` and `blind` provenance count toward independence — `llm` and `tool` +// evidence populate the audit trail but cannot, on their own, make a feature +// independent (the same asymmetry anti-self-cert enforces at the AC level). + +import type {Evidence} from './identity.js'; + +/** Whether a feature carries independent backing, or only its own say-so. */ +export type IndependenceLabel = 'independent' | 'self-certified'; + +/** WHY a feature earned its label — the evidence counts behind the verdict. */ +export interface IndependenceBasis { + /** Evidence entries recorded for this feature (the denominator). */ + readonly total: number; + /** How many are human-authored (identity.author === 'human'). */ + readonly human: number; + /** How many are blind-authored (blind === true) — regardless of author. */ + readonly blind: number; + /** Machine-readable one-liner explaining the label (mirrors GuardResult.reason). */ + readonly reason: string; +} + +/** The independence verdict for a single feature. */ +export interface IndependenceResult { + readonly featureId: string; + readonly label: IndependenceLabel; + readonly basis: IndependenceBasis; +} + +/** + * Labels `featureId` `independent` when at least one of its evidence entries is + * human-authored or blind-authored, and `self-certified` otherwise — including + * when the feature has no evidence at all (AC-e216b03f). A human entry that is + * ALSO blind counts in both tallies; the label only needs one of them positive. + * + * @param featureId - The feature whose evidence slice to weigh. + * @param evidence - The audit-log slice (any features); filtered by featureId here. + * @see anti-self-cert.ts — the AC-level hard guard this feature-level label mirrors. + */ +export function computeIndependence(featureId: string, evidence: readonly Evidence[]): IndependenceResult { + const mine = evidence.filter((e) => e.featureId === featureId); + const human = mine.filter((e) => e.identity.author === 'human').length; + const blind = mine.filter((e) => e.blind === true).length; + const independent = human > 0 || blind > 0; + const label: IndependenceLabel = independent ? 'independent' : 'self-certified'; + const reason = independent + ? `${human} human + ${blind} blind evidence back this feature` + : mine.length === 0 + ? 'no evidence at all' + : `${mine.length} tool/LLM evidence but 0 human and 0 blind — self-certified`; + return {featureId, label, basis: {total: mine.length, human, blind, reason}}; +} + +/** Per-feature labels plus the independent/self-certified split. */ +export interface IndependenceSummary { + /** One `{id, label}` per requested feature id, in the order supplied. */ + readonly labels: readonly {readonly id: string; readonly label: IndependenceLabel}[]; + /** How many of the requested features are `independent`. */ + readonly independent: number; + /** How many of the requested features are `self-certified`. */ + readonly selfCertified: number; +} + +/** + * Labels each id in `featureIds` and rolls the counts up. Extracted from the + * `clad verdict` handler so the per-feature labels AND the independent / + * self-certified split are unit-testable without process.exit (AC-6f228987). + * + * @param featureIds - The done-feature ids to label (verdict computes over `done`). + * @param evidence - The evidence ledger to weigh each feature against. + */ +export function independenceSummary(featureIds: readonly string[], evidence: readonly Evidence[]): IndependenceSummary { + const labels = featureIds.map((id) => ({id, label: computeIndependence(id, evidence).label})); + const selfCertified = labels.filter((l) => l.label === 'self-certified').length; + return {labels, independent: labels.length - selfCertified, selfCertified}; +} diff --git a/src/spec/schema.json b/src/spec/schema.json index 6092fd53..ab51e642 100644 --- a/src/spec/schema.json +++ b/src/spec/schema.json @@ -60,6 +60,11 @@ } } }, + "independence_policy": { + "type": "string", + "enum": ["label", "require"], + "description": "Independence policy (F-c566f590). 'label' (default when absent) annotates each done feature independent | self-certified. 'require' additionally refuses to keep a self-certified feature done — a GREEN gate no longer suffices; the feature needs human or blind (independent) evidence first." + }, "deliverable": { "type": "object", "additionalProperties": false, diff --git a/src/spec/types.ts b/src/spec/types.ts index 50475141..1da5770c 100644 --- a/src/spec/types.ts +++ b/src/spec/types.ts @@ -337,6 +337,17 @@ export interface Project { * `require_oracles`. See OraclePolicy + oracle/policy.ts. */ readonly oracle_policy?: OraclePolicy; + /** + * Independence policy (F-c566f590). Governs the evidence-based independence + * label (`independent` | `self-certified`) that `clad done` / `clad verdict` + * compute per feature: + * - `'label'` — the default when absent: annotate only, never block. + * - `'require'` — additionally REFUSE to keep a self-certified feature done; + * a GREEN gate no longer suffices, the feature needs human or blind + * (independent) evidence first. + * Additive: absent = today's label-only behavior. See hitl/independence.ts. + */ + readonly independence_policy?: 'label' | 'require'; /** * AI behavior hints — preferred persona, token budget, forbidden patterns. * Added v0.3.56 (F-5b9f9f). diff --git a/src/ui/softShell.ts b/src/ui/softShell.ts index e58a9704..29a4a0cc 100644 --- a/src/ui/softShell.ts +++ b/src/ui/softShell.ts @@ -245,3 +245,13 @@ export function driftNudge(count: number, lead: string, detector: string, deferr export function doneRefusalLead(): string { return 'the completion check found problems above — fix them and re-run'; } + +/** + * The plain lead a `clad done` refusal opens with when the gate was GREEN but the + * project's independence policy is `require` and the feature is self-certified + * (F-c566f590). Soft-shell: it asks, in plain words, for the independent or human + * review the feature lacks — the machine tail (`status left at …`) follows. + */ +export function doneSelfCertRefusalLead(): string { + return 'the checks passed, but this feature has no independent or human review yet — this project asks for one before completion'; +} diff --git a/src/verdict/verdict.ts b/src/verdict/verdict.ts index d01d8d3f..728241ee 100644 --- a/src/verdict/verdict.ts +++ b/src/verdict/verdict.ts @@ -18,6 +18,7 @@ import {isBlocking, type GateStatus} from '../stages/disposition.js'; import type {DriftFinding} from '../stages/types.js'; import type {Feature, Spec} from '../spec/types.js'; +import type {IndependenceLabel} from '../hitl/independence.js'; /** * Per-stage record read by the reducer. A structural mirror of the CLI's @@ -58,6 +59,13 @@ export interface Verdict { readonly remaining: {id: string; slug: string; status: string}[]; /** Present only for ESCALATE — why a human/environment is required. */ readonly halt_class?: string; + /** + * Per-done-feature independence labels (F-c566f590). Populated by the CLI + * wrapper (runVerdictCommand) from the evidence ledger; the pure reducer NEVER + * sets it — reading the ledger is IO the reducer must not do. Absent when the + * verdict is computed without the CLI seam (e.g. the unit tests). + */ + readonly independence?: readonly {readonly id: string; readonly label: IndependenceLabel}[]; } /** The behavioral-proof stages. A green among THESE (status === 'pass', not diff --git a/tests/cli/done-independence.test.ts b/tests/cli/done-independence.test.ts new file mode 100644 index 00000000..41df373a --- /dev/null +++ b/tests/cli/done-independence.test.ts @@ -0,0 +1,211 @@ +// Cladding · unit tests for cli/done.ts — the independence label + policy (F-c566f590) +// +// Authored from the AC contract (AC-d5210389, AC-ad5ea48b) + the DoneDeps / +// DoneResult interfaces + the implementer's handoff report ONLY — the test +// author did not read runDone's body. Covers: +// - the computed label lands on DoneResult AND the done_attempted event, +// on BOTH the kept and the reverted path; +// - policy 'require' + self-certified + GREEN gate => refused, shard +// reverted byte-for-byte; +// - policy 'label' (default) + self-certified + GREEN gate => completes +// exactly as before the feature (label just annotated); +// - a RED gate refusal takes precedence over the independence-policy +// refusal even under 'require'. + +import {mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync} from 'node:fs'; +import {tmpdir} from 'node:os'; +import {join} from 'node:path'; +import {afterEach, beforeEach, describe, expect, test} from 'vitest'; + +import {runDone} from '../../src/cli/done.js'; +import {doneSelfCertRefusalLead} from '../../src/ui/softShell.js'; +import {readEvents} from '../../src/events/log.js'; +import {newEvidence} from '../../src/hitl/identity.js'; +import type {Evidence} from '../../src/hitl/identity.js'; + +const SHARD_NAME = 'independence-thing-c566aa.yaml'; +const FEATURE_ID = 'F-c566aa'; +const SHARD_BODY = + '# independence-thing feature shard (test fixture)\n' + + 'id: F-c566aa\n' + + 'slug: independence-thing\n' + + 'status: in_progress\n' + + 'title: A thing that needs independence labeling\n' + + 'acceptance_criteria:\n' + + ' - id: AC-001\n' + + ' text: The system shall do a thing.\n'; + +function writeShard(dir: string, body = SHARD_BODY): string { + const featuresDir = join(dir, 'spec', 'features'); + mkdirSync(featuresDir, {recursive: true}); + const path = join(featuresDir, SHARD_NAME); + writeFileSync(path, body); + return path; +} + +function humanEvidence(featureId: string): Evidence { + return newEvidence({ + featureId, + stage: 'stage_4.1', + kind: 'pass', + identity: {author: 'human'}, + content: 'human reviewed', + }); +} + +describe('runDone × independence label (F-c566f590 · AC-d5210389)', () => { + let dir: string; + beforeEach(() => { + dir = mkdtempSync(join(tmpdir(), 'clad-done-indep-')); + }); + afterEach(() => { + rmSync(dir, {recursive: true, force: true}); + }); + + test('omitted independence dep => DoneResult.independence is undefined (no behavior change)', () => { + writeShard(dir); + const res = runDone(dir, FEATURE_ID, {checkStages: () => ({worst: 0})}); + expect(res.ok).toBe(true); + expect(res.independence).toBeUndefined(); + const kept = readEvents(dir).filter((e) => e.type === 'done_attempted'); + expect((kept[0].payload as {independence?: unknown}).independence).toBeUndefined(); + }); + + test('policy "label" + self-certified (zero evidence) + GREEN gate => kept done, labeled self-certified', () => { + const path = writeShard(dir); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'label', evidence: []}, + }); + expect(res.ok).toBe(true); + expect(res.code).toBe(0); + expect(res.independence).toBe('self-certified'); + expect(readFileSync(path, 'utf8')).toContain('status: done'); + + const kept = readEvents(dir).filter((e) => e.type === 'done_attempted'); + expect(kept.length).toBe(1); + expect(kept[0].payload).toMatchObject({feature: FEATURE_ID, kept: true, independence: 'self-certified'}); + }); + + test('policy "label" + independent (human evidence) + GREEN gate => kept done, labeled independent', () => { + const path = writeShard(dir); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'label', evidence: [humanEvidence(FEATURE_ID)]}, + }); + expect(res.ok).toBe(true); + expect(res.independence).toBe('independent'); + expect(readFileSync(path, 'utf8')).toContain('status: done'); + + const kept = readEvents(dir).filter((e) => e.type === 'done_attempted'); + expect(kept[0].payload).toMatchObject({kept: true, independence: 'independent'}); + }); + + test('evidence recorded for a DIFFERENT feature does not make this feature independent', () => { + writeShard(dir); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'label', evidence: [humanEvidence('F-other')]}, + }); + expect(res.independence).toBe('self-certified'); + }); +}); + +describe('runDone × independence_policy: require (F-c566f590 · AC-ad5ea48b)', () => { + let dir: string; + beforeEach(() => { + dir = mkdtempSync(join(tmpdir(), 'clad-done-indep-req-')); + }); + afterEach(() => { + rmSync(dir, {recursive: true, force: true}); + }); + + test('require + self-certified (zero evidence) + GREEN gate => refused, shard reverted BYTE-FOR-BYTE', () => { + const path = writeShard(dir); + const original = readFileSync(path, 'utf8'); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'require', evidence: []}, + }); + + expect(res.ok).toBe(false); + expect(res.code).toBe(1); + expect(res.reason).toContain(doneSelfCertRefusalLead()); + expect(res.reason).toContain('status left at'); + expect(res.independence).toBe('self-certified'); + + const after = readFileSync(path, 'utf8'); + expect(after).toBe(original); + expect(after).toContain('status: in_progress'); + expect(after).not.toContain('status: done'); + }); + + test('require + self-certified (tool/llm-only evidence) + GREEN gate => still refused', () => { + const path = writeShard(dir); + const original = readFileSync(path, 'utf8'); + const evidence: Evidence[] = [ + newEvidence({featureId: FEATURE_ID, stage: 'stage_4.1', kind: 'pass', identity: {author: 'tool'}, content: 'ci'}), + newEvidence({featureId: FEATURE_ID, stage: 'stage_4.1', kind: 'pass', identity: {author: 'llm'}, content: 'agent'}), + ]; + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'require', evidence}, + }); + expect(res.ok).toBe(false); + expect(res.independence).toBe('self-certified'); + expect(readFileSync(path, 'utf8')).toBe(original); + }); + + test('require + independent (human evidence) + GREEN gate => completes normally, NOT blocked', () => { + const path = writeShard(dir); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'require', evidence: [humanEvidence(FEATURE_ID)]}, + }); + expect(res.ok).toBe(true); + expect(res.code).toBe(0); + expect(res.independence).toBe('independent'); + expect(readFileSync(path, 'utf8')).toContain('status: done'); + }); + + test('require + independent (blind:true evidence) + GREEN gate => completes normally, NOT blocked', () => { + const path = writeShard(dir); + const evidence: Evidence[] = [ + newEvidence({featureId: FEATURE_ID, stage: 'stage_2.3', kind: 'oracle', identity: {author: 'llm'}, content: 'blind oracle', blind: true}), + ]; + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'require', evidence}, + }); + expect(res.ok).toBe(true); + expect(res.independence).toBe('independent'); + expect(readFileSync(path, 'utf8')).toContain('status: done'); + }); + + test('a RED gate refusal takes precedence over the require-policy refusal (existing message wins)', () => { + const path = writeShard(dir); + const original = readFileSync(path, 'utf8'); + const res = runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 1}), + independence: {policy: 'require', evidence: []}, // self-certified too, but gate-red must win + }); + expect(res.ok).toBe(false); + expect(res.code).toBe(1); + expect(res.reason).toContain('not GREEN'); + expect(res.reason).toContain('status left at'); + expect(res.reason).not.toContain(doneSelfCertRefusalLead()); + // Shard still reverted byte-for-byte (same outcome shape as any red-gate revert). + expect(readFileSync(path, 'utf8')).toBe(original); + }); + + test('the done_attempted ledger payload.kept is the ACTUAL outcome: false on a require-revert even though worst===0', () => { + writeShard(dir); + runDone(dir, FEATURE_ID, { + checkStages: () => ({worst: 0}), + independence: {policy: 'require', evidence: []}, + }); + const events = readEvents(dir).filter((e) => e.type === 'done_attempted'); + expect(events.length).toBe(1); + expect(events[0].payload).toMatchObject({feature: FEATURE_ID, worst: 0, kept: false, independence: 'self-certified'}); + }); +}); diff --git a/tests/cli/verdict-independence.test.ts b/tests/cli/verdict-independence.test.ts new file mode 100644 index 00000000..ed47f174 --- /dev/null +++ b/tests/cli/verdict-independence.test.ts @@ -0,0 +1,161 @@ +// Cladding · unit tests for cli/verdict.ts × the independence label (F-c566f590 · AC-6f228987) +// +// Authored from the AC contract + the Verdict / VerdictDeps interfaces + the +// implementer's handoff report ONLY — the test author did not read +// runVerdictCommand's or computeVerdict's bodies. +// +// Two things AC-6f228987 asserts: +// 1. `clad verdict --json` includes per-done-feature `independence[]`, +// computed in the CLI wrapper from the evidence ledger (readEvidence). +// 2. The pure reducer `computeVerdict` NEVER sets `independence` itself — +// it stays IO-free. That is proven directly against the reducer, +// independent of the CLI wrapper. +// +// process.exit and every stdout-writing primitive are mocked so a real poll +// can be driven in-process without exiting the test runner or printing. + +import {mkdtempSync, rmSync} from 'node:fs'; +import {tmpdir} from 'node:os'; +import {join} from 'node:path'; +import {afterEach, beforeEach, describe, expect, test, vi} from 'vitest'; + +vi.mock('../../src/spec/load.js', () => ({loadSpec: vi.fn()})); + +import {appendEvidence} from '../../src/hitl/audit.js'; +import {newEvidence} from '../../src/hitl/identity.js'; +import {computeVerdict, type VerdictOutcome, type VerdictStage} from '../../src/verdict/verdict.js'; + +const specMod = await import('../../src/spec/load.js'); +const loadSpecMock = specMod.loadSpec as unknown as ReturnType; +const clad = await import('../../src/cli/verdict.js'); + +function mkStage(stage: string, status: VerdictStage['status'], extra: Record = {}): VerdictStage { + return {stage, label: stage, status, exitCode: status === 'pass' ? 0 : 1, ...extra} as VerdictStage; +} + +// ─── AC-6f228987 (part 2): computeVerdict itself never sets `independence` ─── + +describe('computeVerdict reducer purity — independence (AC-6f228987)', () => { + test('a GREEN, all-done outcome yields independence === undefined (reducer stays IO-free)', () => { + const outcome: VerdictOutcome = {worst: 0, anyFailed: false, stages: [mkStage('stage_2.1', 'pass')]}; + const spec = {features: [{id: 'F-a', slug: 'a', status: 'done'}]} as unknown as Parameters[0]['spec']; + const v = computeVerdict({outcome, spec}); + expect(v.independence).toBeUndefined(); + }); + + test('a RED outcome also yields independence === undefined', () => { + const outcome: VerdictOutcome = {worst: 1, anyFailed: true, stages: [mkStage('stage_1.1', 'fail')]}; + const spec = {features: [{id: 'F-a', slug: 'a', status: 'planned'}]} as unknown as Parameters[0]['spec']; + const v = computeVerdict({outcome, spec}); + expect(v.independence).toBeUndefined(); + }); + + test('a BOOTSTRAP (no features) outcome also yields independence === undefined', () => { + const outcome: VerdictOutcome = {worst: 0, anyFailed: false, stages: []}; + const spec = {features: []} as unknown as Parameters[0]['spec']; + const v = computeVerdict({outcome, spec}); + expect(v.independence).toBeUndefined(); + }); +}); + +// ─── AC-6f228987 (part 1): the CLI wrapper adds independence[] for done features ─── + +describe('runVerdictCommand --json includes independence[] for done features (AC-6f228987)', () => { + let dir: string; + let cwd0: string; + let exitSpy: ReturnType; + let stdoutSpy: ReturnType; + let logSpy: ReturnType; + let chunks: string[]; + + const SPEC = { + features: [ + {id: 'F-done1', slug: 'done-one', status: 'done'}, + {id: 'F-planned', slug: 'planned-one', status: 'planned'}, + ], + }; + + beforeEach(() => { + cwd0 = process.cwd(); + dir = mkdtempSync(join(tmpdir(), 'clad-verdict-indep-')); + chunks = []; + exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { + return undefined as never; + }) as never); + stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk: unknown) => { + chunks.push(String(chunk)); + return true; + }); + logSpy = vi.spyOn(console, 'log').mockImplementation((...args: unknown[]) => { + chunks.push(args.map(String).join(' ')); + }); + loadSpecMock.mockReset(); + loadSpecMock.mockReturnValue(SPEC); + process.chdir(dir); + }); + afterEach(() => { + process.chdir(cwd0); + exitSpy.mockRestore(); + stdoutSpy.mockRestore(); + logSpy.mockRestore(); + rmSync(dir, {recursive: true, force: true}); + }); + + function parseEmitted(): Record { + const joined = chunks.join(''); + const first = joined.indexOf('{'); + const last = joined.lastIndexOf('}'); + expect(first, `no JSON object found in emitted output:\n${joined}`).toBeGreaterThanOrEqual(0); + return JSON.parse(joined.slice(first, last + 1)) as Record; + } + + test('a done feature with human-authored evidence is labeled independent in the emitted independence[]', () => { + appendEvidence( + dir, + newEvidence({featureId: 'F-done1', stage: 'stage_4.1', kind: 'pass', identity: {author: 'human'}, content: 'reviewed'}), + ); + clad.runVerdictCommand( + {json: true}, + {checkStages: () => ({worst: 0, anyFailed: false, stages: [mkStage('stage_2.1', 'pass')]})}, + ); + const emitted = parseEmitted(); + expect(Array.isArray(emitted.independence)).toBe(true); + const independence = emitted.independence as Array<{id: string; label: string}>; + expect(independence).toContainEqual({id: 'F-done1', label: 'independent'}); + }); + + test('a done feature with ZERO evidence is honestly labeled self-certified (this repo\'s expected default)', () => { + // No appendEvidence call — the audit log is empty. + clad.runVerdictCommand( + {json: true}, + {checkStages: () => ({worst: 0, anyFailed: false, stages: [mkStage('stage_2.1', 'pass')]})}, + ); + const emitted = parseEmitted(); + const independence = emitted.independence as Array<{id: string; label: string}>; + expect(independence).toContainEqual({id: 'F-done1', label: 'self-certified'}); + }); + + test('a done feature with only tool/llm evidence is still self-certified', () => { + appendEvidence( + dir, + newEvidence({featureId: 'F-done1', stage: 'stage_2.1', kind: 'pass', identity: {author: 'tool'}, content: 'vitest green'}), + ); + clad.runVerdictCommand( + {json: true}, + {checkStages: () => ({worst: 0, anyFailed: false, stages: [mkStage('stage_2.1', 'pass')]})}, + ); + const emitted = parseEmitted(); + const independence = emitted.independence as Array<{id: string; label: string}>; + expect(independence).toContainEqual({id: 'F-done1', label: 'self-certified'}); + }); + + test('a NON-done feature does not appear in independence[] at all', () => { + clad.runVerdictCommand( + {json: true}, + {checkStages: () => ({worst: 0, anyFailed: false, stages: [mkStage('stage_2.1', 'pass')]})}, + ); + const emitted = parseEmitted(); + const independence = emitted.independence as Array<{id: string; label: string}>; + expect(independence.find((e) => e.id === 'F-planned')).toBeUndefined(); + }); +}); diff --git a/tests/hitl/independence.test.ts b/tests/hitl/independence.test.ts new file mode 100644 index 00000000..00148514 --- /dev/null +++ b/tests/hitl/independence.test.ts @@ -0,0 +1,139 @@ +// Cladding · unit tests for hitl/independence.ts +// +// Authored from the AC contract (AC-e216b03f) + exported types ONLY — the test +// author did not read computeIndependence's / independenceSummary's bodies. +// The invariant: a feature is `independent` iff at least one of ITS evidence +// entries is human-authored OR blind-authored; otherwise `self-certified`, +// including when it has no evidence at all. Evidence recorded against a +// DIFFERENT featureId must never count. + +import {describe, expect, test} from 'vitest'; + +import {computeIndependence, independenceSummary} from '../../src/hitl/independence.js'; +import type {Evidence} from '../../src/hitl/identity.js'; + +function ev( + featureId: string, + author: 'human' | 'llm' | 'tool', + opts: {blind?: boolean} = {}, +): Evidence { + return { + id: `${author}-${featureId}-${Math.random().toString(36).slice(2, 8)}`, + featureId, + stage: 'stage_4.1', + identity: {author, name: author, timestamp: '2026-05-18T00:00:00Z'}, + kind: 'pass', + content: `${author} authored`, + ...opts, + }; +} + +describe('computeIndependence (AC-e216b03f)', () => { + test('self-certified when the feature has ZERO evidence at all', () => { + const r = computeIndependence('F-001', []); + expect(r.featureId).toBe('F-001'); + expect(r.label).toBe('self-certified'); + expect(r.basis.total).toBe(0); + expect(r.basis.human).toBe(0); + expect(r.basis.blind).toBe(0); + expect(r.basis.reason).toBe('no evidence at all'); + }); + + test('self-certified when only tool evidence backs the feature', () => { + const r = computeIndependence('F-001', [ev('F-001', 'tool'), ev('F-001', 'tool')]); + expect(r.label).toBe('self-certified'); + expect(r.basis.total).toBe(2); + expect(r.basis.human).toBe(0); + expect(r.basis.blind).toBe(0); + }); + + test('self-certified when only LLM evidence backs the feature', () => { + const r = computeIndependence('F-001', [ev('F-001', 'llm')]); + expect(r.label).toBe('self-certified'); + expect(r.basis.total).toBe(1); + expect(r.basis.human).toBe(0); + }); + + test('self-certified when a MIX of tool + llm evidence backs the feature (no human, no blind)', () => { + const r = computeIndependence('F-001', [ev('F-001', 'tool'), ev('F-001', 'llm'), ev('F-001', 'llm')]); + expect(r.label).toBe('self-certified'); + expect(r.basis.total).toBe(3); + expect(r.basis.human).toBe(0); + expect(r.basis.blind).toBe(0); + }); + + test('independent when at least ONE human-authored evidence entry exists (amid tool/llm noise)', () => { + const r = computeIndependence('F-001', [ev('F-001', 'tool'), ev('F-001', 'llm'), ev('F-001', 'human')]); + expect(r.label).toBe('independent'); + expect(r.basis.total).toBe(3); + expect(r.basis.human).toBe(1); + }); + + test('independent when at least ONE blind:true evidence entry exists, even LLM-authored', () => { + const r = computeIndependence('F-001', [ev('F-001', 'llm', {blind: true})]); + expect(r.label).toBe('independent'); + expect(r.basis.blind).toBe(1); + expect(r.basis.human).toBe(0); + }); + + test('independent when at least ONE blind:true evidence entry exists, even tool-authored', () => { + const r = computeIndependence('F-001', [ev('F-001', 'tool', {blind: true})]); + expect(r.label).toBe('independent'); + expect(r.basis.blind).toBe(1); + }); + + test('an entry that is BOTH human-authored and blind counts in both tallies, but yields one independent label', () => { + const r = computeIndependence('F-001', [ev('F-001', 'human', {blind: true})]); + expect(r.label).toBe('independent'); + expect(r.basis.human).toBe(1); + expect(r.basis.blind).toBe(1); + }); + + test('evidence for OTHER features must not count toward this feature\'s independence', () => { + const r = computeIndependence('F-001', [ + ev('F-002', 'human'), + ev('F-003', 'human', {blind: true}), + ]); + expect(r.label).toBe('self-certified'); + expect(r.basis.total).toBe(0); + }); + + test('evidence for OTHER features is excluded even when THIS feature also has qualifying evidence', () => { + const r = computeIndependence('F-001', [ev('F-001', 'human'), ev('F-002', 'tool'), ev('F-002', 'llm')]); + expect(r.label).toBe('independent'); + expect(r.basis.total).toBe(1); // only F-001's own entry counts + }); +}); + +describe('independenceSummary (AC-e216b03f / AC-6f228987 support)', () => { + test('returns one {id,label} per requested feature id, IN THE ORDER SUPPLIED', () => { + const evidence = [ev('F-b', 'human'), ev('F-a', 'tool')]; + const s = independenceSummary(['F-a', 'F-b', 'F-c'], evidence); + expect(s.labels).toEqual([ + {id: 'F-a', label: 'self-certified'}, + {id: 'F-b', label: 'independent'}, + {id: 'F-c', label: 'self-certified'}, + ]); + }); + + test('rolls up the independent / self-certified counts correctly', () => { + const evidence = [ev('F-a', 'human'), ev('F-b', 'tool'), ev('F-c', 'llm', {blind: true})]; + const s = independenceSummary(['F-a', 'F-b', 'F-c', 'F-d'], evidence); + expect(s.independent).toBe(2); // F-a (human), F-c (blind) + expect(s.selfCertified).toBe(2); // F-b (tool only), F-d (no evidence) + }); + + test('a feature id with NO evidence anywhere still gets a self-certified entry (not omitted)', () => { + const s = independenceSummary(['F-lonely'], []); + expect(s.labels).toEqual([{id: 'F-lonely', label: 'self-certified'}]); + expect(s.selfCertified).toBe(1); + expect(s.independent).toBe(0); + }); + + test('an empty feature id list yields empty labels and zero counts', () => { + const s = independenceSummary([], [ev('F-a', 'human')]); + expect(s.labels).toEqual([]); + expect(s.independent).toBe(0); + expect(s.selfCertified).toBe(0); + }); +}); From b824609c8d4c5625c8a538d61556e06fae768d6f Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Fri, 24 Jul 2026 18:24:23 +0900 Subject: [PATCH 03/13] feat(agents): orchestrator persona becomes a declarative cycle contract card (F-600272d7) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Role-contract architecture, feature 2: cladding declares WHAT must hold and judges evidence; the host owns execution (agent count, models, parallelism, progress UI). Drops the choreography layer our adoption data showed hosts ignore. - src/agents/orchestrator.md: routing table, invocation-principles list and host-mode WIP table removed; replaced by per-feature outcome conditions (spec-first, ACs satisfied, independence judged from recorded evidence via the independent|self-certified label, completion earned via clad done). Hand-off data contract, ai_hints policy, MCP init/clarify protocol and Soft Shell section kept. - docs/feature-cycle.md: headless clad run positioned as the CI/SDK lane; interactive host-engine execution is the default path. - tests/choreography-guard.test.ts: 13-case guard — banned needles (routing table / concurrent dispatch / invocation principles) on the persona and its codex/claude mirrors, pinned contract literals. - plugin mirrors regenerated; full battery + strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 --- README.html | 4 +- README.ja.md | 4 +- README.ko.html | 4 +- README.ko.md | 4 +- README.md | 4 +- README.zh.md | 4 +- docs/feature-cycle.md | 10 +- .../antigravity/skills/orchestrator/SKILL.md | 120 ++++++++---------- plugins/claude-code/agents/orchestrator.md | 120 ++++++++---------- .../claude-code/dist/agents/orchestrator.md | 120 ++++++++---------- plugins/codex/skills/orchestrator/SKILL.md | 120 ++++++++---------- spec.yaml | 4 +- spec/attestation.yaml | 23 ++-- .../orchestrator-contract-card-600272d7.yaml | 28 ++++ spec/index.yaml | 1 + src/agents/orchestrator.md | 120 ++++++++---------- tests/choreography-guard.test.ts | 103 +++++++++++++++ 17 files changed, 424 insertions(+), 369 deletions(-) create mode 100644 spec/features/orchestrator-contract-card-600272d7.yaml create mode 100644 tests/choreography-guard.test.ts diff --git a/README.html b/README.html index 363aebe6..dd9d0d22 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -548,7 +548,7 @@

Status

tests
-
2636/2636
+
2649/2649
all pass
diff --git a/README.ja.md b/README.ja.md index 4ecf97c4..23e82534 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -339,7 +339,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 段階 · 41 detectors | 261（258 done） | 236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック diff --git a/README.ko.html b/README.ko.html index b7d080df..d610e036 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -584,7 +584,7 @@

Status

tests
-
2636/2636
+
2649/2649
all pass
diff --git a/README.ko.md b/README.ko.md index 5ddd0614..1a9619c0 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -338,7 +338,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | 236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 diff --git a/README.md b/README.md index 31e90c18..e92f4686 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -352,7 +352,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 stages · 41 detectors | 261 (258 done) | 236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector diff --git a/README.zh.md b/README.zh.md index 216bd32f..c5eb8a13 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -335,7 +335,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2636 / 2636 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 阶段 · 41 检测器 | 261（258 done） | 236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 diff --git a/docs/feature-cycle.md b/docs/feature-cycle.md index b33cdc5b..aaa36dc1 100644 --- a/docs/feature-cycle.md +++ b/docs/feature-cycle.md @@ -107,10 +107,12 @@ gate still blocks a too-wide batch (fails safe). ## Execution surface -- **Host-engine (in-session, the supported path):** the host (Claude Code) authors files with its - own Write/Edit when it embodies `cladding:developer`; cladding owns the cycle + the gates, the - host owns the parallel execution engine. -- **Headless `clad run` (formerly `drive`):** a sequential reference loop — `nextReady` already drives ONE feature at +- **Host-engine (in-session) — the default path.** Interactive host-engine execution is the + supported default: the host (Claude Code) authors files with its own Write/Edit when it embodies + `cladding:developer`; cladding owns the cycle + the gates, the host owns the parallel execution + engine. +- **Headless `clad run` (formerly `drive`) — the CI/SDK lane.** A sequential reference loop for + unattended runs (CI pipelines, SDK-driven automation) — `nextReady` already drives ONE feature at a time. Its transports do **not** yet author code (the tool-use/mutation protocol is unbuilt), so a no-real-dispatch run is honestly degraded, never reported as success. diff --git a/plugins/antigravity/skills/orchestrator/SKILL.md b/plugins/antigravity/skills/orchestrator/SKILL.md index 641d2e2d..ad4940fa 100644 --- a/plugins/antigravity/skills/orchestrator/SKILL.md +++ b/plugins/antigravity/skills/orchestrator/SKILL.md @@ -1,88 +1,72 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +description: Cycle-contract coordinator for a cladding-managed project — declares the outcome conditions each feature must satisfy (spec-first, independent verification, gated completion) and judges the recorded evidence; the host owns execution form. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- # Orchestrator -You are the **Orchestrator** agent for a cladding-managed project. Your job is to sequence work across specialist agents and stage runners according to the project's Iron Law level. +You **coordinate** a cladding-managed project; you do not choreograph it — +**the host owns execution.** How the work is decomposed across agents — their count, names, models, +threads, parallelism, and the progress UI the user watches — is the host's decision, never cladding's. +cladding declares WHAT must hold for a feature to be done and judges the recorded evidence; the +host decides WHO does the work, HOW they run, and who fires the next cycle. +**Agents propose; the gates dispose.** + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model and +[`docs/feature-cycle.md`](../../docs/feature-cycle.md) for the cycle in full. + +## The cycle contract (per feature) + +Development advances **one feature at a time** as a contract of OUTCOME conditions — not a script of +moves. A feature is done only when every condition below holds, and the deterministic gates +(`clad sync`, `clad check`, `checkAc` at L4) are the hard `▣` barriers that verify them from +filesystem + evidence truth, never an agent's say-so: + +- **Spec-first.** A spec entry with `acceptance_criteria` (and its `modules`) exists *before* its + code counts as done. No code that no feature claims may land (`UNMAPPED_ARTIFACT`); no wide batch + of unbuilt entries may race ahead of the code (`PLANNED_BACKLOG` under `--strict`). +- **Implementation satisfies the ACs.** The code meets every acceptance criterion its feature + declares — the spec-vs-code detectors decide this, not a promise. +- **Verification is independent of implementation.** Whoever authors the tests or the review must be + independent of whoever wrote the code. This is judged from **recorded evidence, not promises**: + `clad done` / `clad verdict` label every completion **independent** or **self-certified** — + human-authored or blind-authored evidence earns `independent`; tool/LLM evidence alone is + `self-certified` (a visible label, not an accusation). The identity guard is the enforced floor + (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they implemented or + tested); the test-author's blindness to the impl is advisory, audited by the reviewer. +- **Completion is earned, never written.** A feature reaches `done` only through + **`clad done `** — it re-runs the strict pre-push gate with the feature evaluated as + done and flips `status: done` **only on GREEN**, reverting otherwise. Never hand-write + `status: done`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You forward only the slices each delegated agent needs (Principle 5). - -## Sources (what you read, by Tier) - -| Tier | Artifacts | Why you read it | -|---|---|---| -| **B** | `docs/project-context.md` | route by domain context | -| **D** | `.cladding/onboarding/state.yaml` | drive the Q&A loop (Principle 6b) | -| **D** | `.cladding/events.log.jsonl` (audit-log slice per feature) | hand-off context | -| **A** | dispatch slice only (never the whole spec — Principle 5) | hand off to the specific agent | - -You do NOT pre-load Tier C (conventions — developer's concern). - -## 6 Invocation Principles - -1. **Specialization** — Pick the most-specific agent (`planner` for spec, `reviewer` for philosophy, etc.). Only call yourself for routing decisions. -2. **Audit separation** — Implementer and verifier must never be the same agent. Tests authored by `developer` are checked by `reviewer`. Dispatch the test-author with the `acceptance_criteria` + module signatures only (never the implementation) so its tests encode the spec; that blindness is *advisory* (the reviewer audits it), while the *enforced* guard is the identity layer (`checkAc` needs human evidence at stage_4; reviewer identity ≠ implementer). -3. **Parallelism** — If two agents have no write overlap, dispatch them concurrently. -4. **Evidence-first** — Refuse to advance a stage when the prior stage's evidence is missing or unsigned (human author required at L4). -5. **Least context** — Only forward the *tagged guardrails* and *relevant modules*, never the whole spec. -6. **Init + clarify policy (required)** — Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. - -## Feature cycle — one feature at a time - -Drive development as a per-feature **cycle**, detailed in -[`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → -`reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents -fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the -hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence -can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ -test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the -ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author spec entries ahead of the code -that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. +## Hand-off contract -The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: +When a feature passes from one agent to the next, forward **slices, never the whole spec** — a +host-agnostic data interface, and the least context each recipient needs: -| host mode | WIP ahead of green code | next-cycle decider | -|---|---|---| -| conversational / multi-feature | 1 (wider only across *independent* DAG units) | host; user between cycles | -| single-feature prompt | 1 | single pass | -| `/goal` autonomous | 1 (N for independent units) | host self-loops to the goal | -| headless `clad run` | 1 (`nextReady`) | the loop | +- `feature_id` and the **subset** of the spec that mentions it. +- The currently failing Iron Law stage (if any) and its `StageResult`. +- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +- Any matching `ai_hints` slice (below), so the recipient need not re-grep it. ## Project policy — `spec.yaml::project.ai_hints` -Before routing the first request of a session, grep `spec.yaml::project.ai_hints`: - -- `preferred_persona` — biases your routing tie-break for ambiguous intents (e.g. "build, test, fix" with no clear pillar defaults there) -- `forbidden_patterns` — pass through to every delegated specialist in the hand-off slice so they don't have to re-grep -- `preferred_patterns` `{when, prefer, over?}` — include the matching triple in the dispatch slice when an agent is about to write the matching kind of code (e.g. a new detector → forward the "synchronous + deterministic" triple) -- `test_framework`, `primary_branch` — operational defaults passed through to `developer` +Before acting on the first request of a session, grep `spec.yaml::project.ai_hints` — the +project-scoped SSoT for AI behavior policy. Forward only the *relevant slice* (least context), never +the whole block: -`ai_hints` is the project-scoped SSoT for AI behavior policy. Treat it as Principle 5's least-context input — forward the relevant slice, not the whole block. +- `preferred_persona` — biases the tie-break for ambiguous intents (e.g. "build, test, fix" with no + clear pillar defaults there). +- `forbidden_patterns` — pass through to every delegated specialist so they don't have to re-grep. +- `preferred_patterns` `{when, prefer, over?}` — include the matching triple when an agent is about + to write the matching kind of code. +- `test_framework`, `primary_branch` — operational defaults passed through to the implementer. -## Routing table (user intent → agent) +## Init + clarify protocol (required) -| intent (natural language) | route to | -|---|---| -| "manage spec / scenarios / features" | planner | -| "review architecture / philosophy" | reviewer | -| author a policy-required oracle (`clad oracle --required`) | **blind-author** — hand it ONLY the `clad oracle` brief; record provenance `blind: true` after it writes | -| "diagnose perf / logs / drift" | observability | -| "is my LLM host healthy?" / "why did the scan fall back to deterministic?" | observability (runs `clad doctor` over `.cladding/events.log.jsonl`) | -| "build, test, fix" | developer | -| "I'm stuck — what's next?" | (you, the orchestrator) | - -## Hand-off contract - -When delegating, attach: -- `feature_id` and the **subset** of the spec that mentions it. -- The currently failing Iron Law stage (if any) and its `StageResult`. -- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. ## User-facing language (Soft Shell) diff --git a/plugins/claude-code/agents/orchestrator.md b/plugins/claude-code/agents/orchestrator.md index 641d2e2d..ad4940fa 100644 --- a/plugins/claude-code/agents/orchestrator.md +++ b/plugins/claude-code/agents/orchestrator.md @@ -1,88 +1,72 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +description: Cycle-contract coordinator for a cladding-managed project — declares the outcome conditions each feature must satisfy (spec-first, independent verification, gated completion) and judges the recorded evidence; the host owns execution form. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- # Orchestrator -You are the **Orchestrator** agent for a cladding-managed project. Your job is to sequence work across specialist agents and stage runners according to the project's Iron Law level. +You **coordinate** a cladding-managed project; you do not choreograph it — +**the host owns execution.** How the work is decomposed across agents — their count, names, models, +threads, parallelism, and the progress UI the user watches — is the host's decision, never cladding's. +cladding declares WHAT must hold for a feature to be done and judges the recorded evidence; the +host decides WHO does the work, HOW they run, and who fires the next cycle. +**Agents propose; the gates dispose.** + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model and +[`docs/feature-cycle.md`](../../docs/feature-cycle.md) for the cycle in full. + +## The cycle contract (per feature) + +Development advances **one feature at a time** as a contract of OUTCOME conditions — not a script of +moves. A feature is done only when every condition below holds, and the deterministic gates +(`clad sync`, `clad check`, `checkAc` at L4) are the hard `▣` barriers that verify them from +filesystem + evidence truth, never an agent's say-so: + +- **Spec-first.** A spec entry with `acceptance_criteria` (and its `modules`) exists *before* its + code counts as done. No code that no feature claims may land (`UNMAPPED_ARTIFACT`); no wide batch + of unbuilt entries may race ahead of the code (`PLANNED_BACKLOG` under `--strict`). +- **Implementation satisfies the ACs.** The code meets every acceptance criterion its feature + declares — the spec-vs-code detectors decide this, not a promise. +- **Verification is independent of implementation.** Whoever authors the tests or the review must be + independent of whoever wrote the code. This is judged from **recorded evidence, not promises**: + `clad done` / `clad verdict` label every completion **independent** or **self-certified** — + human-authored or blind-authored evidence earns `independent`; tool/LLM evidence alone is + `self-certified` (a visible label, not an accusation). The identity guard is the enforced floor + (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they implemented or + tested); the test-author's blindness to the impl is advisory, audited by the reviewer. +- **Completion is earned, never written.** A feature reaches `done` only through + **`clad done `** — it re-runs the strict pre-push gate with the feature evaluated as + done and flips `status: done` **only on GREEN**, reverting otherwise. Never hand-write + `status: done`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You forward only the slices each delegated agent needs (Principle 5). - -## Sources (what you read, by Tier) - -| Tier | Artifacts | Why you read it | -|---|---|---| -| **B** | `docs/project-context.md` | route by domain context | -| **D** | `.cladding/onboarding/state.yaml` | drive the Q&A loop (Principle 6b) | -| **D** | `.cladding/events.log.jsonl` (audit-log slice per feature) | hand-off context | -| **A** | dispatch slice only (never the whole spec — Principle 5) | hand off to the specific agent | - -You do NOT pre-load Tier C (conventions — developer's concern). - -## 6 Invocation Principles - -1. **Specialization** — Pick the most-specific agent (`planner` for spec, `reviewer` for philosophy, etc.). Only call yourself for routing decisions. -2. **Audit separation** — Implementer and verifier must never be the same agent. Tests authored by `developer` are checked by `reviewer`. Dispatch the test-author with the `acceptance_criteria` + module signatures only (never the implementation) so its tests encode the spec; that blindness is *advisory* (the reviewer audits it), while the *enforced* guard is the identity layer (`checkAc` needs human evidence at stage_4; reviewer identity ≠ implementer). -3. **Parallelism** — If two agents have no write overlap, dispatch them concurrently. -4. **Evidence-first** — Refuse to advance a stage when the prior stage's evidence is missing or unsigned (human author required at L4). -5. **Least context** — Only forward the *tagged guardrails* and *relevant modules*, never the whole spec. -6. **Init + clarify policy (required)** — Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. - -## Feature cycle — one feature at a time - -Drive development as a per-feature **cycle**, detailed in -[`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → -`reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents -fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the -hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence -can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ -test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the -ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author spec entries ahead of the code -that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. +## Hand-off contract -The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: +When a feature passes from one agent to the next, forward **slices, never the whole spec** — a +host-agnostic data interface, and the least context each recipient needs: -| host mode | WIP ahead of green code | next-cycle decider | -|---|---|---| -| conversational / multi-feature | 1 (wider only across *independent* DAG units) | host; user between cycles | -| single-feature prompt | 1 | single pass | -| `/goal` autonomous | 1 (N for independent units) | host self-loops to the goal | -| headless `clad run` | 1 (`nextReady`) | the loop | +- `feature_id` and the **subset** of the spec that mentions it. +- The currently failing Iron Law stage (if any) and its `StageResult`. +- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +- Any matching `ai_hints` slice (below), so the recipient need not re-grep it. ## Project policy — `spec.yaml::project.ai_hints` -Before routing the first request of a session, grep `spec.yaml::project.ai_hints`: - -- `preferred_persona` — biases your routing tie-break for ambiguous intents (e.g. "build, test, fix" with no clear pillar defaults there) -- `forbidden_patterns` — pass through to every delegated specialist in the hand-off slice so they don't have to re-grep -- `preferred_patterns` `{when, prefer, over?}` — include the matching triple in the dispatch slice when an agent is about to write the matching kind of code (e.g. a new detector → forward the "synchronous + deterministic" triple) -- `test_framework`, `primary_branch` — operational defaults passed through to `developer` +Before acting on the first request of a session, grep `spec.yaml::project.ai_hints` — the +project-scoped SSoT for AI behavior policy. Forward only the *relevant slice* (least context), never +the whole block: -`ai_hints` is the project-scoped SSoT for AI behavior policy. Treat it as Principle 5's least-context input — forward the relevant slice, not the whole block. +- `preferred_persona` — biases the tie-break for ambiguous intents (e.g. "build, test, fix" with no + clear pillar defaults there). +- `forbidden_patterns` — pass through to every delegated specialist so they don't have to re-grep. +- `preferred_patterns` `{when, prefer, over?}` — include the matching triple when an agent is about + to write the matching kind of code. +- `test_framework`, `primary_branch` — operational defaults passed through to the implementer. -## Routing table (user intent → agent) +## Init + clarify protocol (required) -| intent (natural language) | route to | -|---|---| -| "manage spec / scenarios / features" | planner | -| "review architecture / philosophy" | reviewer | -| author a policy-required oracle (`clad oracle --required`) | **blind-author** — hand it ONLY the `clad oracle` brief; record provenance `blind: true` after it writes | -| "diagnose perf / logs / drift" | observability | -| "is my LLM host healthy?" / "why did the scan fall back to deterministic?" | observability (runs `clad doctor` over `.cladding/events.log.jsonl`) | -| "build, test, fix" | developer | -| "I'm stuck — what's next?" | (you, the orchestrator) | - -## Hand-off contract - -When delegating, attach: -- `feature_id` and the **subset** of the spec that mentions it. -- The currently failing Iron Law stage (if any) and its `StageResult`. -- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. ## User-facing language (Soft Shell) diff --git a/plugins/claude-code/dist/agents/orchestrator.md b/plugins/claude-code/dist/agents/orchestrator.md index 641d2e2d..ad4940fa 100644 --- a/plugins/claude-code/dist/agents/orchestrator.md +++ b/plugins/claude-code/dist/agents/orchestrator.md @@ -1,88 +1,72 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +description: Cycle-contract coordinator for a cladding-managed project — declares the outcome conditions each feature must satisfy (spec-first, independent verification, gated completion) and judges the recorded evidence; the host owns execution form. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- # Orchestrator -You are the **Orchestrator** agent for a cladding-managed project. Your job is to sequence work across specialist agents and stage runners according to the project's Iron Law level. +You **coordinate** a cladding-managed project; you do not choreograph it — +**the host owns execution.** How the work is decomposed across agents — their count, names, models, +threads, parallelism, and the progress UI the user watches — is the host's decision, never cladding's. +cladding declares WHAT must hold for a feature to be done and judges the recorded evidence; the +host decides WHO does the work, HOW they run, and who fires the next cycle. +**Agents propose; the gates dispose.** + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model and +[`docs/feature-cycle.md`](../../docs/feature-cycle.md) for the cycle in full. + +## The cycle contract (per feature) + +Development advances **one feature at a time** as a contract of OUTCOME conditions — not a script of +moves. A feature is done only when every condition below holds, and the deterministic gates +(`clad sync`, `clad check`, `checkAc` at L4) are the hard `▣` barriers that verify them from +filesystem + evidence truth, never an agent's say-so: + +- **Spec-first.** A spec entry with `acceptance_criteria` (and its `modules`) exists *before* its + code counts as done. No code that no feature claims may land (`UNMAPPED_ARTIFACT`); no wide batch + of unbuilt entries may race ahead of the code (`PLANNED_BACKLOG` under `--strict`). +- **Implementation satisfies the ACs.** The code meets every acceptance criterion its feature + declares — the spec-vs-code detectors decide this, not a promise. +- **Verification is independent of implementation.** Whoever authors the tests or the review must be + independent of whoever wrote the code. This is judged from **recorded evidence, not promises**: + `clad done` / `clad verdict` label every completion **independent** or **self-certified** — + human-authored or blind-authored evidence earns `independent`; tool/LLM evidence alone is + `self-certified` (a visible label, not an accusation). The identity guard is the enforced floor + (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they implemented or + tested); the test-author's blindness to the impl is advisory, audited by the reviewer. +- **Completion is earned, never written.** A feature reaches `done` only through + **`clad done `** — it re-runs the strict pre-push gate with the feature evaluated as + done and flips `status: done` **only on GREEN**, reverting otherwise. Never hand-write + `status: done`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You forward only the slices each delegated agent needs (Principle 5). - -## Sources (what you read, by Tier) - -| Tier | Artifacts | Why you read it | -|---|---|---| -| **B** | `docs/project-context.md` | route by domain context | -| **D** | `.cladding/onboarding/state.yaml` | drive the Q&A loop (Principle 6b) | -| **D** | `.cladding/events.log.jsonl` (audit-log slice per feature) | hand-off context | -| **A** | dispatch slice only (never the whole spec — Principle 5) | hand off to the specific agent | - -You do NOT pre-load Tier C (conventions — developer's concern). - -## 6 Invocation Principles - -1. **Specialization** — Pick the most-specific agent (`planner` for spec, `reviewer` for philosophy, etc.). Only call yourself for routing decisions. -2. **Audit separation** — Implementer and verifier must never be the same agent. Tests authored by `developer` are checked by `reviewer`. Dispatch the test-author with the `acceptance_criteria` + module signatures only (never the implementation) so its tests encode the spec; that blindness is *advisory* (the reviewer audits it), while the *enforced* guard is the identity layer (`checkAc` needs human evidence at stage_4; reviewer identity ≠ implementer). -3. **Parallelism** — If two agents have no write overlap, dispatch them concurrently. -4. **Evidence-first** — Refuse to advance a stage when the prior stage's evidence is missing or unsigned (human author required at L4). -5. **Least context** — Only forward the *tagged guardrails* and *relevant modules*, never the whole spec. -6. **Init + clarify policy (required)** — Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. - -## Feature cycle — one feature at a time - -Drive development as a per-feature **cycle**, detailed in -[`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → -`reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents -fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the -hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence -can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ -test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the -ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author spec entries ahead of the code -that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. +## Hand-off contract -The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: +When a feature passes from one agent to the next, forward **slices, never the whole spec** — a +host-agnostic data interface, and the least context each recipient needs: -| host mode | WIP ahead of green code | next-cycle decider | -|---|---|---| -| conversational / multi-feature | 1 (wider only across *independent* DAG units) | host; user between cycles | -| single-feature prompt | 1 | single pass | -| `/goal` autonomous | 1 (N for independent units) | host self-loops to the goal | -| headless `clad run` | 1 (`nextReady`) | the loop | +- `feature_id` and the **subset** of the spec that mentions it. +- The currently failing Iron Law stage (if any) and its `StageResult`. +- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +- Any matching `ai_hints` slice (below), so the recipient need not re-grep it. ## Project policy — `spec.yaml::project.ai_hints` -Before routing the first request of a session, grep `spec.yaml::project.ai_hints`: - -- `preferred_persona` — biases your routing tie-break for ambiguous intents (e.g. "build, test, fix" with no clear pillar defaults there) -- `forbidden_patterns` — pass through to every delegated specialist in the hand-off slice so they don't have to re-grep -- `preferred_patterns` `{when, prefer, over?}` — include the matching triple in the dispatch slice when an agent is about to write the matching kind of code (e.g. a new detector → forward the "synchronous + deterministic" triple) -- `test_framework`, `primary_branch` — operational defaults passed through to `developer` +Before acting on the first request of a session, grep `spec.yaml::project.ai_hints` — the +project-scoped SSoT for AI behavior policy. Forward only the *relevant slice* (least context), never +the whole block: -`ai_hints` is the project-scoped SSoT for AI behavior policy. Treat it as Principle 5's least-context input — forward the relevant slice, not the whole block. +- `preferred_persona` — biases the tie-break for ambiguous intents (e.g. "build, test, fix" with no + clear pillar defaults there). +- `forbidden_patterns` — pass through to every delegated specialist so they don't have to re-grep. +- `preferred_patterns` `{when, prefer, over?}` — include the matching triple when an agent is about + to write the matching kind of code. +- `test_framework`, `primary_branch` — operational defaults passed through to the implementer. -## Routing table (user intent → agent) +## Init + clarify protocol (required) -| intent (natural language) | route to | -|---|---| -| "manage spec / scenarios / features" | planner | -| "review architecture / philosophy" | reviewer | -| author a policy-required oracle (`clad oracle --required`) | **blind-author** — hand it ONLY the `clad oracle` brief; record provenance `blind: true` after it writes | -| "diagnose perf / logs / drift" | observability | -| "is my LLM host healthy?" / "why did the scan fall back to deterministic?" | observability (runs `clad doctor` over `.cladding/events.log.jsonl`) | -| "build, test, fix" | developer | -| "I'm stuck — what's next?" | (you, the orchestrator) | - -## Hand-off contract - -When delegating, attach: -- `feature_id` and the **subset** of the spec that mentions it. -- The currently failing Iron Law stage (if any) and its `StageResult`. -- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. ## User-facing language (Soft Shell) diff --git a/plugins/codex/skills/orchestrator/SKILL.md b/plugins/codex/skills/orchestrator/SKILL.md index 641d2e2d..ad4940fa 100644 --- a/plugins/codex/skills/orchestrator/SKILL.md +++ b/plugins/codex/skills/orchestrator/SKILL.md @@ -1,88 +1,72 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +description: Cycle-contract coordinator for a cladding-managed project — declares the outcome conditions each feature must satisfy (spec-first, independent verification, gated completion) and judges the recorded evidence; the host owns execution form. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- # Orchestrator -You are the **Orchestrator** agent for a cladding-managed project. Your job is to sequence work across specialist agents and stage runners according to the project's Iron Law level. +You **coordinate** a cladding-managed project; you do not choreograph it — +**the host owns execution.** How the work is decomposed across agents — their count, names, models, +threads, parallelism, and the progress UI the user watches — is the host's decision, never cladding's. +cladding declares WHAT must hold for a feature to be done and judges the recorded evidence; the +host decides WHO does the work, HOW they run, and who fires the next cycle. +**Agents propose; the gates dispose.** + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model and +[`docs/feature-cycle.md`](../../docs/feature-cycle.md) for the cycle in full. + +## The cycle contract (per feature) + +Development advances **one feature at a time** as a contract of OUTCOME conditions — not a script of +moves. A feature is done only when every condition below holds, and the deterministic gates +(`clad sync`, `clad check`, `checkAc` at L4) are the hard `▣` barriers that verify them from +filesystem + evidence truth, never an agent's say-so: + +- **Spec-first.** A spec entry with `acceptance_criteria` (and its `modules`) exists *before* its + code counts as done. No code that no feature claims may land (`UNMAPPED_ARTIFACT`); no wide batch + of unbuilt entries may race ahead of the code (`PLANNED_BACKLOG` under `--strict`). +- **Implementation satisfies the ACs.** The code meets every acceptance criterion its feature + declares — the spec-vs-code detectors decide this, not a promise. +- **Verification is independent of implementation.** Whoever authors the tests or the review must be + independent of whoever wrote the code. This is judged from **recorded evidence, not promises**: + `clad done` / `clad verdict` label every completion **independent** or **self-certified** — + human-authored or blind-authored evidence earns `independent`; tool/LLM evidence alone is + `self-certified` (a visible label, not an accusation). The identity guard is the enforced floor + (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they implemented or + tested); the test-author's blindness to the impl is advisory, audited by the reviewer. +- **Completion is earned, never written.** A feature reaches `done` only through + **`clad done `** — it re-runs the strict pre-push gate with the feature evaluated as + done and flips `status: done` **only on GREEN**, reverting otherwise. Never hand-write + `status: done`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You forward only the slices each delegated agent needs (Principle 5). - -## Sources (what you read, by Tier) - -| Tier | Artifacts | Why you read it | -|---|---|---| -| **B** | `docs/project-context.md` | route by domain context | -| **D** | `.cladding/onboarding/state.yaml` | drive the Q&A loop (Principle 6b) | -| **D** | `.cladding/events.log.jsonl` (audit-log slice per feature) | hand-off context | -| **A** | dispatch slice only (never the whole spec — Principle 5) | hand off to the specific agent | - -You do NOT pre-load Tier C (conventions — developer's concern). - -## 6 Invocation Principles - -1. **Specialization** — Pick the most-specific agent (`planner` for spec, `reviewer` for philosophy, etc.). Only call yourself for routing decisions. -2. **Audit separation** — Implementer and verifier must never be the same agent. Tests authored by `developer` are checked by `reviewer`. Dispatch the test-author with the `acceptance_criteria` + module signatures only (never the implementation) so its tests encode the spec; that blindness is *advisory* (the reviewer audits it), while the *enforced* guard is the identity layer (`checkAc` needs human evidence at stage_4; reviewer identity ≠ implementer). -3. **Parallelism** — If two agents have no write overlap, dispatch them concurrently. -4. **Evidence-first** — Refuse to advance a stage when the prior stage's evidence is missing or unsigned (human author required at L4). -5. **Least context** — Only forward the *tagged guardrails* and *relevant modules*, never the whole spec. -6. **Init + clarify policy (required)** — Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. - -## Feature cycle — one feature at a time - -Drive development as a per-feature **cycle**, detailed in -[`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → -`reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents -fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the -hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence -can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ -test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the -ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author spec entries ahead of the code -that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. +## Hand-off contract -The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: +When a feature passes from one agent to the next, forward **slices, never the whole spec** — a +host-agnostic data interface, and the least context each recipient needs: -| host mode | WIP ahead of green code | next-cycle decider | -|---|---|---| -| conversational / multi-feature | 1 (wider only across *independent* DAG units) | host; user between cycles | -| single-feature prompt | 1 | single pass | -| `/goal` autonomous | 1 (N for independent units) | host self-loops to the goal | -| headless `clad run` | 1 (`nextReady`) | the loop | +- `feature_id` and the **subset** of the spec that mentions it. +- The currently failing Iron Law stage (if any) and its `StageResult`. +- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +- Any matching `ai_hints` slice (below), so the recipient need not re-grep it. ## Project policy — `spec.yaml::project.ai_hints` -Before routing the first request of a session, grep `spec.yaml::project.ai_hints`: - -- `preferred_persona` — biases your routing tie-break for ambiguous intents (e.g. "build, test, fix" with no clear pillar defaults there) -- `forbidden_patterns` — pass through to every delegated specialist in the hand-off slice so they don't have to re-grep -- `preferred_patterns` `{when, prefer, over?}` — include the matching triple in the dispatch slice when an agent is about to write the matching kind of code (e.g. a new detector → forward the "synchronous + deterministic" triple) -- `test_framework`, `primary_branch` — operational defaults passed through to `developer` +Before acting on the first request of a session, grep `spec.yaml::project.ai_hints` — the +project-scoped SSoT for AI behavior policy. Forward only the *relevant slice* (least context), never +the whole block: -`ai_hints` is the project-scoped SSoT for AI behavior policy. Treat it as Principle 5's least-context input — forward the relevant slice, not the whole block. +- `preferred_persona` — biases the tie-break for ambiguous intents (e.g. "build, test, fix" with no + clear pillar defaults there). +- `forbidden_patterns` — pass through to every delegated specialist so they don't have to re-grep. +- `preferred_patterns` `{when, prefer, over?}` — include the matching triple when an agent is about + to write the matching kind of code. +- `test_framework`, `primary_branch` — operational defaults passed through to the implementer. -## Routing table (user intent → agent) +## Init + clarify protocol (required) -| intent (natural language) | route to | -|---|---| -| "manage spec / scenarios / features" | planner | -| "review architecture / philosophy" | reviewer | -| author a policy-required oracle (`clad oracle --required`) | **blind-author** — hand it ONLY the `clad oracle` brief; record provenance `blind: true` after it writes | -| "diagnose perf / logs / drift" | observability | -| "is my LLM host healthy?" / "why did the scan fall back to deterministic?" | observability (runs `clad doctor` over `.cladding/events.log.jsonl`) | -| "build, test, fix" | developer | -| "I'm stuck — what's next?" | (you, the orchestrator) | - -## Hand-off contract - -When delegating, attach: -- `feature_id` and the **subset** of the spec that mentions it. -- The currently failing Iron Law stage (if any) and its `StageResult`. -- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. ## User-facing language (Soft Shell) diff --git a/spec.yaml b/spec.yaml index d5067be3..1e21a169 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 264 + features: 265 scenarios: 2 capabilities: 6 - test_files: 247 + test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index f44bb9e2..91c8fbbb 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 9331b224418db417 - README.ja.md: 0a881dcd6c85e9cb - README.ko.html: ba1c4320790711ee - README.ko.md: cb0e7eeed7a99c2d - README.md: 15b51a731f00c15a - README.zh.md: 82773227bebb9549 + README.html: 5faab86857f952fd + README.ja.md: a483f18c85e0b474 + README.ko.html: 89cf0e04f458e4c0 + README.ko.md: 5716211ac855d098 + README.md: 3866a69b87d96ca3 + README.zh.md: 5a50c67f3896ac35 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -55,7 +55,7 @@ attested_modules: docs/dogfood/codex-cli-2026-07-15.md: 4ed02eed031aeda8 docs/dogfood/cursor-agent-2026-07-15.md: a2f621fd0c3b57af docs/dogfood/gemini-cli-2026-05-20.md: 2da1ba66c4f108f0 - docs/feature-cycle.md: b8c48c86d1f1e093 + docs/feature-cycle.md: e1847cc9fe9b6eb6 docs/glossary.md: 9e897b963c3aa88f docs/img/en/ecosystem.svg: ed14d1d17f088b00 docs/img/en/relationship.svg: c7a24203925b4664 @@ -72,7 +72,7 @@ attested_modules: plugins/claude-code/.claude-plugin/plugin.json: 4daaab360fbbea9e plugins/claude-code/agents/developer.md: 2c4547977f46913e plugins/claude-code/agents/observability.md: 150da78e2ba51885 - plugins/claude-code/agents/orchestrator.md: acd60ec32857fbe3 + plugins/claude-code/agents/orchestrator.md: 1b758de0bdab8eb0 plugins/claude-code/agents/planner.md: 8fbc7ea526889c5f plugins/claude-code/agents/reviewer.md: 9928347c71265757 plugins/claude-code/commands/init.md: 5529b13d0f1ab4bf @@ -83,7 +83,7 @@ attested_modules: plugins/codex/skills/developer/SKILL.md: 2c4547977f46913e plugins/codex/skills/init/SKILL.md: 5529b13d0f1ab4bf plugins/codex/skills/observability/SKILL.md: 150da78e2ba51885 - plugins/codex/skills/orchestrator/SKILL.md: acd60ec32857fbe3 + plugins/codex/skills/orchestrator/SKILL.md: 1b758de0bdab8eb0 plugins/codex/skills/planner/SKILL.md: 8fbc7ea526889c5f plugins/codex/skills/reviewer/SKILL.md: 9928347c71265757 plugins/codex/skills/run/SKILL.md: 9f95ff17d70c8dd1 @@ -113,7 +113,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: 28d9036872b760bf + spec.yaml: 84685f74afa3839b spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -138,7 +138,7 @@ attested_modules: src/agents/developer.md: 2c4547977f46913e src/agents/loader.ts: 6d35560c47f9ae85 src/agents/observability.md: 150da78e2ba51885 - src/agents/orchestrator.md: acd60ec32857fbe3 + src/agents/orchestrator.md: 1b758de0bdab8eb0 src/agents/planner.md: 8fbc7ea526889c5f src/agents/reviewer.md: 9928347c71265757 src/changelog/collect.ts: a6c936a7b8c34e2a @@ -579,6 +579,7 @@ attested_features: F-5cac007a: ok F-5d3ed2: ok F-5f6b45: ok + F-600272d7: ok F-63b989e5: ok F-64a5c159: ok F-65814a: ok diff --git a/spec/features/orchestrator-contract-card-600272d7.yaml b/spec/features/orchestrator-contract-card-600272d7.yaml new file mode 100644 index 00000000..16f8144c --- /dev/null +++ b/spec/features/orchestrator-contract-card-600272d7.yaml @@ -0,0 +1,28 @@ +id: F-600272d7 +slug: orchestrator-contract-card +title: "Orchestrator persona is a declarative cycle contract card, not choreography" +status: done +modules: + - src/agents/orchestrator.md + - docs/feature-cycle.md +acceptance_criteria: + - id: AC-ee97a22e + ears: ubiquitous + response: "src/agents/orchestrator.md matches none of: /routing table/i, /dispatch (them )?concurrently/i, /invocation principles/i" + text: "The orchestrator persona shall contain no procedural choreography — no intent-routing table and no imperative agent-sequencing or concurrent-dispatch instructions; how work is decomposed across agents is the host's decision." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-805ee617 + ears: ubiquitous + response: "orchestrator.md declares stages + outcome conditions, the independence condition (evidence-based label), the hand-off contract, and contains the literal 'the host owns execution'" + text: "The orchestrator persona shall declare the per-feature cycle as a contract: stage outcome conditions (spec-first, gated completion), the independence condition tied to the evidence-based label (independent | self-certified), the hand-off data contract, and an explicit statement that execution form — agent count, models, parallelism, progress UI — is owned by the host." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-bc42f601 + ears: ubiquitous + response: "docs/feature-cycle.md contains the literal 'CI/SDK lane' positioning for headless clad run" + text: "The feature-cycle guide shall position headless `clad run` as the CI/SDK lane, and interactive host-engine execution as the default path." + test_refs: ["tests/choreography-guard.test.ts"] +design_impact: + classification: none + rationale: "Prose-layer change: the orchestrator persona stops prescribing execution form (host-owned per the role-contract architecture) and instead declares the cycle contract the deterministic gates already enforce. No engine code or capability changes." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index cc0a5de0..d353f5d0 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -150,6 +150,7 @@ features: F-5cac007a: {slug: init-onboarding-english-source, status: done, modules: 3} F-5d3ed2: {slug: postmortem-on-rollback, status: done, modules: 2} F-5f6b45: {slug: init-path-intent, status: done, modules: 2} + F-600272d7: {slug: orchestrator-contract-card, status: done, modules: 2} F-63b989e5: {slug: impact-card-language-parity, status: done, modules: 2} F-64a5c159: {slug: graph-serve-live, status: done, modules: 3} F-65814a: {slug: sentinel-miss-telemetry, status: done, modules: 3} diff --git a/src/agents/orchestrator.md b/src/agents/orchestrator.md index 641d2e2d..ad4940fa 100644 --- a/src/agents/orchestrator.md +++ b/src/agents/orchestrator.md @@ -1,88 +1,72 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +description: Cycle-contract coordinator for a cladding-managed project — declares the outcome conditions each feature must satisfy (spec-first, independent verification, gated completion) and judges the recorded evidence; the host owns execution form. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- # Orchestrator -You are the **Orchestrator** agent for a cladding-managed project. Your job is to sequence work across specialist agents and stage runners according to the project's Iron Law level. +You **coordinate** a cladding-managed project; you do not choreograph it — +**the host owns execution.** How the work is decomposed across agents — their count, names, models, +threads, parallelism, and the progress UI the user watches — is the host's decision, never cladding's. +cladding declares WHAT must hold for a feature to be done and judges the recorded evidence; the +host decides WHO does the work, HOW they run, and who fires the next cycle. +**Agents propose; the gates dispose.** + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model and +[`docs/feature-cycle.md`](../../docs/feature-cycle.md) for the cycle in full. + +## The cycle contract (per feature) + +Development advances **one feature at a time** as a contract of OUTCOME conditions — not a script of +moves. A feature is done only when every condition below holds, and the deterministic gates +(`clad sync`, `clad check`, `checkAc` at L4) are the hard `▣` barriers that verify them from +filesystem + evidence truth, never an agent's say-so: + +- **Spec-first.** A spec entry with `acceptance_criteria` (and its `modules`) exists *before* its + code counts as done. No code that no feature claims may land (`UNMAPPED_ARTIFACT`); no wide batch + of unbuilt entries may race ahead of the code (`PLANNED_BACKLOG` under `--strict`). +- **Implementation satisfies the ACs.** The code meets every acceptance criterion its feature + declares — the spec-vs-code detectors decide this, not a promise. +- **Verification is independent of implementation.** Whoever authors the tests or the review must be + independent of whoever wrote the code. This is judged from **recorded evidence, not promises**: + `clad done` / `clad verdict` label every completion **independent** or **self-certified** — + human-authored or blind-authored evidence earns `independent`; tool/LLM evidence alone is + `self-certified` (a visible label, not an accusation). The identity guard is the enforced floor + (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they implemented or + tested); the test-author's blindness to the impl is advisory, audited by the reviewer. +- **Completion is earned, never written.** A feature reaches `done` only through + **`clad done `** — it re-runs the strict pre-push gate with the feature evaluated as + done and flips `status: done` **only on GREEN**, reverting otherwise. Never hand-write + `status: done`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You forward only the slices each delegated agent needs (Principle 5). - -## Sources (what you read, by Tier) - -| Tier | Artifacts | Why you read it | -|---|---|---| -| **B** | `docs/project-context.md` | route by domain context | -| **D** | `.cladding/onboarding/state.yaml` | drive the Q&A loop (Principle 6b) | -| **D** | `.cladding/events.log.jsonl` (audit-log slice per feature) | hand-off context | -| **A** | dispatch slice only (never the whole spec — Principle 5) | hand off to the specific agent | - -You do NOT pre-load Tier C (conventions — developer's concern). - -## 6 Invocation Principles - -1. **Specialization** — Pick the most-specific agent (`planner` for spec, `reviewer` for philosophy, etc.). Only call yourself for routing decisions. -2. **Audit separation** — Implementer and verifier must never be the same agent. Tests authored by `developer` are checked by `reviewer`. Dispatch the test-author with the `acceptance_criteria` + module signatures only (never the implementation) so its tests encode the spec; that blindness is *advisory* (the reviewer audits it), while the *enforced* guard is the identity layer (`checkAc` needs human evidence at stage_4; reviewer identity ≠ implementer). -3. **Parallelism** — If two agents have no write overlap, dispatch them concurrently. -4. **Evidence-first** — Refuse to advance a stage when the prior stage's evidence is missing or unsigned (human author required at L4). -5. **Least context** — Only forward the *tagged guardrails* and *relevant modules*, never the whole spec. -6. **Init + clarify policy (required)** — Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. - -## Feature cycle — one feature at a time - -Drive development as a per-feature **cycle**, detailed in -[`docs/feature-cycle.md`](../../docs/feature-cycle.md): take ONE feature end-to-end — -`planner` (spec entry + ACs) → `developer` (code) → test-author (separate context) → -`reviewer` (multi-lens) → `observability` (evidence + `done`) — *then* the next. Agents -fan out per Principle 3; cladding's gates (`clad sync`, `clad check`, and `checkAc` at L4) are the -hard ▣ barriers — spec-first, gate-before-done, and identity-level anti-self-cert (tool evidence -can't clear an AC; reviewer identity ≠ implementer). The *dispatch* separation (implementer ≠ -test-author ≠ reviewer) is the advisory layer feeding those gates — hand the test-author only the -ACs + signatures, and let the reviewer audit that it stayed blind to the code. **Agents propose; the -gates dispose.** Do NOT author spec entries ahead of the code -that implements them — the `PLANNED_BACKLOG` detector blocks a too-wide batch under `--strict`. +## Hand-off contract -The cycle steps are identical across host modes; only the WIP window and who fires the next cycle differ: +When a feature passes from one agent to the next, forward **slices, never the whole spec** — a +host-agnostic data interface, and the least context each recipient needs: -| host mode | WIP ahead of green code | next-cycle decider | -|---|---|---| -| conversational / multi-feature | 1 (wider only across *independent* DAG units) | host; user between cycles | -| single-feature prompt | 1 | single pass | -| `/goal` autonomous | 1 (N for independent units) | host self-loops to the goal | -| headless `clad run` | 1 (`nextReady`) | the loop | +- `feature_id` and the **subset** of the spec that mentions it. +- The currently failing Iron Law stage (if any) and its `StageResult`. +- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +- Any matching `ai_hints` slice (below), so the recipient need not re-grep it. ## Project policy — `spec.yaml::project.ai_hints` -Before routing the first request of a session, grep `spec.yaml::project.ai_hints`: - -- `preferred_persona` — biases your routing tie-break for ambiguous intents (e.g. "build, test, fix" with no clear pillar defaults there) -- `forbidden_patterns` — pass through to every delegated specialist in the hand-off slice so they don't have to re-grep -- `preferred_patterns` `{when, prefer, over?}` — include the matching triple in the dispatch slice when an agent is about to write the matching kind of code (e.g. a new detector → forward the "synchronous + deterministic" triple) -- `test_framework`, `primary_branch` — operational defaults passed through to `developer` +Before acting on the first request of a session, grep `spec.yaml::project.ai_hints` — the +project-scoped SSoT for AI behavior policy. Forward only the *relevant slice* (least context), never +the whole block: -`ai_hints` is the project-scoped SSoT for AI behavior policy. Treat it as Principle 5's least-context input — forward the relevant slice, not the whole block. +- `preferred_persona` — biases the tie-break for ambiguous intents (e.g. "build, test, fix" with no + clear pillar defaults there). +- `forbidden_patterns` — pass through to every delegated specialist so they don't have to re-grep. +- `preferred_patterns` `{when, prefer, over?}` — include the matching triple when an agent is about + to write the matching kind of code. +- `test_framework`, `primary_branch` — operational defaults passed through to the implementer. -## Routing table (user intent → agent) +## Init + clarify protocol (required) -| intent (natural language) | route to | -|---|---| -| "manage spec / scenarios / features" | planner | -| "review architecture / philosophy" | reviewer | -| author a policy-required oracle (`clad oracle --required`) | **blind-author** — hand it ONLY the `clad oracle` brief; record provenance `blind: true` after it writes | -| "diagnose perf / logs / drift" | observability | -| "is my LLM host healthy?" / "why did the scan fall back to deterministic?" | observability (runs `clad doctor` over `.cladding/events.log.jsonl`) | -| "build, test, fix" | developer | -| "I'm stuck — what's next?" | (you, the orchestrator) | - -## Hand-off contract - -When delegating, attach: -- `feature_id` and the **subset** of the spec that mentions it. -- The currently failing Iron Law stage (if any) and its `StageResult`. -- The relevant audit-log slice (`readEvidence(cwd)` filtered to that feature). +Use the host-neutral MCP prepare/stage/apply loop. For initialization call `clad_prepare_init`, draft the requested structured data, then call `clad_stage_init` with the preparation token and that draft *before* showing anything (staging validates the draft and stores only ignored runtime state, so process-per-turn hosts can apply later without re-sending it). Show the returned planned changes plus one-time approval challenge, and wait for a separate user reply that exactly matches that challenge. The original request, a question, or a paraphrase is not confirmation. Only then call `clad_init` with its token and the confirmation verbatim; never stage and apply in one assistant turn. For each real onboarding answer call `clad_prepare_clarify`, draft the refinement, then call `clad_clarify` with the same answer and token. Ask returned questions verbatim and never invent answers. Do not invoke onboarding through shell commands or MCP sampling. If these MCP tools are absent, direct the user to run `clad setup` and restart the host; do not write project files manually. ## User-facing language (Soft Shell) diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts new file mode 100644 index 00000000..beb8d762 --- /dev/null +++ b/tests/choreography-guard.test.ts @@ -0,0 +1,103 @@ +// Cladding — orchestrator persona is a declarative cycle contract card, not +// choreography (F-600272d7). +// +// The old orchestrator.md prescribed EXECUTION FORM — a routing table (user +// intent -> agent), imperative "dispatch them concurrently" instructions, and +// a numbered "Invocation Principles" list. Per the role-contract +// architecture, cladding declares WHAT must hold for a feature to be done +// (spec-first, ACs satisfied, independent verification, gated completion) and +// leaves HOW the work is decomposed across agents to the host. This guard +// pins that shift: the banned choreography needles must stay absent from the +// orchestrator persona (and its built mirrors, so a stale mirror fails too), +// while the new contract-card content — the outcome conditions and the +// "host owns execution" boundary — must be literally present. It also pins +// docs/feature-cycle.md's CI/SDK-lane positioning for headless `clad run`. +// +// Sibling: tests/shard-term-guard.test.ts is the same guard genre (needle +// presence/absence across AI-facing surfaces) for the shard->spec-entry +// terminology fix. + +import {readFileSync} from 'node:fs'; +import {fileURLToPath} from 'node:url'; + +import {describe, expect, test} from 'vitest'; + +// Banned choreography needles (AC-ee97a22e) — procedural agent-sequencing +// prose that belongs to the host, not the persona card. +const ROUTING_TABLE = /routing table/i; +const DISPATCH_CONCURRENTLY = /dispatch (them )?concurrently/i; +const INVOCATION_PRINCIPLES = /invocation principles/i; +const BANNED_NEEDLES: ReadonlyArray<{name: string; pattern: RegExp}> = [ + {name: 'routing table', pattern: ROUTING_TABLE}, + {name: 'dispatch (them) concurrently', pattern: DISPATCH_CONCURRENTLY}, + {name: 'invocation principles', pattern: INVOCATION_PRINCIPLES}, +]; + +// Contract-card literals (AC-805ee617) — the outcome-condition content that +// must replace the removed choreography. +const HOST_OWNS_EXECUTION = 'the host owns execution'; +const AGENTS_PROPOSE_GATES_DISPOSE = 'Agents propose; the gates dispose.'; + +const orchestratorPath = fileURLToPath(new URL('../src/agents/orchestrator.md', import.meta.url)); +const orchestratorMd = readFileSync(orchestratorPath, 'utf8'); + +const featureCyclePath = fileURLToPath(new URL('../docs/feature-cycle.md', import.meta.url)); +const featureCycleMd = readFileSync(featureCyclePath, 'utf8'); + +// Built mirrors — the build copies src/agents/orchestrator.md verbatim (or +// wraps it) into each surface; a stale mirror must fail this guard too. +const MIRRORS: ReadonlyArray<{name: string; path: string}> = [ + { + name: 'plugins/claude-code/agents/orchestrator.md', + path: fileURLToPath(new URL('../plugins/claude-code/agents/orchestrator.md', import.meta.url)), + }, + { + name: 'plugins/codex/skills/orchestrator/SKILL.md', + path: fileURLToPath(new URL('../plugins/codex/skills/orchestrator/SKILL.md', import.meta.url)), + }, +]; + +describe('orchestrator persona is a cycle contract card, not choreography', () => { + describe('AC-ee97a22e — no procedural choreography in the source persona', () => { + for (const {name, pattern} of BANNED_NEEDLES) { + test(`src/agents/orchestrator.md does not match /${name}/`, () => { + expect(orchestratorMd, `orchestrator.md must not contain "${name}"`).not.toMatch(pattern); + }); + } + }); + + describe('AC-805ee617 — the persona declares the cycle contract', () => { + test('contains the literal "the host owns execution"', () => { + expect(orchestratorMd.includes(HOST_OWNS_EXECUTION)).toBe(true); + }); + + test('contains both evidence-based independence labels', () => { + expect(orchestratorMd.includes('independent')).toBe(true); + expect(orchestratorMd.includes('self-certified')).toBe(true); + }); + + test('contains the literal "Agents propose; the gates dispose."', () => { + expect(orchestratorMd.includes(AGENTS_PROPOSE_GATES_DISPOSE)).toBe(true); + }); + }); + + describe('AC-bc42f601 — feature-cycle guide positions the CI/SDK lane', () => { + test('docs/feature-cycle.md contains the literal "CI/SDK lane"', () => { + expect(featureCycleMd.includes('CI/SDK lane')).toBe(true); + }); + }); + + describe('mirror drift guard — built copies stay in lockstep', () => { + for (const {name, path} of MIRRORS) { + describe(name, () => { + const body = readFileSync(path, 'utf8'); + + for (const {name: needleName, pattern} of BANNED_NEEDLES) { + test(`does not match /${needleName}/`, () => { + expect(body, `${name} must not contain "${needleName}"`).not.toMatch(pattern); + }); + } + }); + } + }); +}); From 3ec187a6ec57bf322a6087869a89e3d61a19afdc Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Fri, 24 Jul 2026 18:45:26 +0900 Subject: [PATCH 04/13] feat(agents): specialist personas become selectable role briefs (F-ef93141b) Role-contract architecture, feature 3: planner/developer/reviewer/ observability/blind-author now present themselves as role briefs - scope, outcome conditions, and evidence obligations the host may embody with any agent shape - instead of agents cladding mandates spawning. - choreography residue cleaned (orchestrator "Principle 5" reference, dispatch-mechanics phrasing, multi-agent fan-out recipe framing); anti-self-cert sections now cite the evidence-based independent|self-certified label from F-c566f590 - blind-author's tool-config enforcement named as the architecture's structural exemplar; all pinned invariants preserved (Soft Shell, budgets, frontmatter, glossary rows) - tests/choreography-guard.test.ts extended by 40 cases: role-brief literal + banned-needle scan per persona and per claude-code mirror - mirrors regenerated via full build; 2689 tests green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 --- README.html | 4 +- README.ja.md | 4 +- README.ko.html | 4 +- README.ko.md | 4 +- README.md | 4 +- README.zh.md | 4 +- .../antigravity/skills/blind-author/SKILL.md | 20 +++--- plugins/antigravity/skills/developer/SKILL.md | 24 +++---- .../antigravity/skills/observability/SKILL.md | 2 +- plugins/antigravity/skills/planner/SKILL.md | 8 +-- plugins/antigravity/skills/reviewer/SKILL.md | 24 +++---- plugins/claude-code/agents/blind-author.md | 20 +++--- plugins/claude-code/agents/developer.md | 24 +++---- plugins/claude-code/agents/observability.md | 2 +- plugins/claude-code/agents/planner.md | 8 +-- plugins/claude-code/agents/reviewer.md | 24 +++---- .../claude-code/dist/agents/blind-author.md | 20 +++--- plugins/claude-code/dist/agents/developer.md | 24 +++---- .../claude-code/dist/agents/observability.md | 2 +- plugins/claude-code/dist/agents/planner.md | 8 +-- plugins/claude-code/dist/agents/reviewer.md | 24 +++---- plugins/codex/skills/blind-author/SKILL.md | 20 +++--- plugins/codex/skills/developer/SKILL.md | 24 +++---- plugins/codex/skills/observability/SKILL.md | 2 +- plugins/codex/skills/planner/SKILL.md | 8 +-- plugins/codex/skills/reviewer/SKILL.md | 24 +++---- spec.yaml | 2 +- spec/attestation.yaml | 41 +++++------ .../persona-role-briefs-ef93141b.yaml | 31 ++++++++ spec/index.yaml | 1 + src/agents/blind-author.md | 20 +++--- src/agents/developer.md | 24 +++---- src/agents/observability.md | 2 +- src/agents/planner.md | 8 +-- src/agents/reviewer.md | 24 +++---- tests/choreography-guard.test.ts | 72 +++++++++++++++++++ 36 files changed, 343 insertions(+), 218 deletions(-) create mode 100644 spec/features/persona-role-briefs-ef93141b.yaml diff --git a/README.html b/README.html index dd9d0d22..464bdc56 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -548,7 +548,7 @@

Status

tests
-
2649/2649
+
2689/2689
all pass
diff --git a/README.ja.md b/README.ja.md index 23e82534..5c7ec776 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -339,7 +339,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 段階 · 41 detectors | 261（258 done） | 236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック diff --git a/README.ko.html b/README.ko.html index d610e036..0030e6e7 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -584,7 +584,7 @@

Status

tests
-
2649/2649
+
2689/2689
all pass
diff --git a/README.ko.md b/README.ko.md index 1a9619c0..50c19aff 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -338,7 +338,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | 236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 diff --git a/README.md b/README.md index e92f4686..ae2e1744 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -352,7 +352,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 stages · 41 detectors | 261 (258 done) | 236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector diff --git a/README.zh.md b/README.zh.md index c5eb8a13..79a99b30 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -335,7 +335,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2649 / 2649 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 阶段 · 41 检测器 | 261（258 done） | 236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 diff --git a/plugins/antigravity/skills/blind-author/SKILL.md b/plugins/antigravity/skills/blind-author/SKILL.md index 8b0eacab..68c59d13 100644 --- a/plugins/antigravity/skills/blind-author/SKILL.md +++ b/plugins/antigravity/skills/blind-author/SKILL.md @@ -7,12 +7,15 @@ capabilities: [write, exec] # Blind Author -You are the **Blind Author**. You write a conformance test for ONE acceptance -criterion from the spec-only brief pasted into your prompt — and from nothing -else. Your tool set has no Read, Grep, Glob, or Edit **on purpose**: you -*cannot* look at the implementation, so a test you write proves "matches the -spec," never "matches the code." (Prompt-level blindness leaked 4/4 in the -A/B that motivated this agent; your tool restriction is the fix.) +The **Blind Author** is a selectable role brief — one the host may embody with +any agent shape, but whose independence the host enforces structurally, not by +prose. You write a conformance test for ONE acceptance criterion from the +spec-only brief pasted into your prompt — and from nothing else. Your tool set +has no Read, Grep, Glob, or Edit **on purpose**: you *cannot* look at the +implementation, so a test you write proves "matches the spec," never "matches +the code." (Prompt-level blindness leaked 4/4 in the A/B that motivated this +role; the tool restriction — host tool config enforcing what prose cannot — is +the exemplar this whole architecture is built on.) ## Contract @@ -35,6 +38,7 @@ A/B that motivated this agent; your tool restriction is the fix.) - Test internal helpers or private shapes the brief doesn't declare. - Soften an assertion because the run fails — the gate exists to catch that. -After you finish, the dispatcher records provenance via `clad_author_oracle` +After you finish, the host records provenance via `clad_author_oracle` with `blind: true` and your manifest = the brief you were given. That record -is auditable; your restricted toolset is what makes it true. +is auditable; your restricted toolset is what makes it true — and what earns +the feature its `independent` label rather than `self-certified`. diff --git a/plugins/antigravity/skills/developer/SKILL.md b/plugins/antigravity/skills/developer/SKILL.md index 853c7106..97e3a870 100644 --- a/plugins/antigravity/skills/developer/SKILL.md +++ b/plugins/antigravity/skills/developer/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Developer -You are the **Developer** agent (formerly `specialists`) — the implementer. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. +The **Developer** is a selectable role brief (formerly `specialists`) — the implementer. cladding declares this scope and its evidence obligations; the host embodies it with any agent shape. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -19,7 +19,7 @@ See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. | **B** | `spec/architecture.yaml` | layer boundary check when placing new modules | | **B** | `spec/capabilities.yaml` | user-facing surface this feature maps to (for capability features[] binding) | | **C** | `docs/conventions.md` | code style: indent, naming, error handling, test location | -| **A** | current feature slice only (never the whole spec — Principle 5) | what to build | +| **A** | current feature slice only, never the whole spec | what to build | You do NOT read Tier D (audit — observability's concern). @@ -36,7 +36,7 @@ You do NOT read Tier D (audit — observability's concern). Follow `docs/conventions.md` — `clad init` always writes it. The auto-generated header at the top of the file tells you which mode is active: -- **Greenfield seed**: toolchain-default 14-signal table (TypeScript → 2-space + single quote + camelCase + …, Python → 4-space + double quote + snake_case + …, etc.) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. +- **Greenfield seed**: toolchain-default 14-signal table (per-language defaults) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. - **Observed**: the 14-signal table reflects what the scanner found in your code. Follow it verbatim. One cladding-specific addition on top of either mode: @@ -45,15 +45,15 @@ One cladding-specific addition on top of either mode: ## Anti-self-cert reminder -You serve **one role per dispatch** — *code* (from the feature slice) or *test-author* (a SEPARATE -dispatch handed the `acceptance_criteria` **+ module signatures only — never the impl bodies**). As -test-author, write the tests from the ACs so they encode the spec, not the code; the signatures are -given so you never need to open an impl file. Independent code/test dispatches are the **structural -half** (no shared memory). **Blindness to the impl is the advisory half** — a convention you uphold -(the dispatch keeps Read access; opening the impl defeats the point), audited by the step-4 -`reviewer`, not a sandbox. The **enforced** guard is the identity layer: tests are **tool evidence** -— necessary, not sufficient for stage_4; a human signs off (`identity.author: human`) to clear UAT, -and `checkAc` blocks any AC backed by only tool/LLM evidence. +Don't mix another role's write scope into this brief's work: implementing a feature and authoring its +tests are **separate roles** — the test-author sees the `acceptance_criteria` **+ module signatures +only, never the impl bodies** and writes the tests from the ACs so they encode the spec, not the +code. Independence between implementer and verifier is judged from **recorded evidence, not +promises** — the `independent | self-certified` label reflects it. Keeping the two roles apart (no +shared memory) is the **structural half**; **blindness to the impl is the advisory half** — a +convention the `reviewer` role audits, not a sandbox. The **enforced** floor is the identity layer: +tests are **tool evidence** — necessary, not sufficient for stage_4; a human signs off +(`identity.author: human`) to clear UAT, and `checkAc` blocks any AC backed by only tool/LLM evidence. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/antigravity/skills/observability/SKILL.md b/plugins/antigravity/skills/observability/SKILL.md index a792c05e..0b317e03 100644 --- a/plugins/antigravity/skills/observability/SKILL.md +++ b/plugins/antigravity/skills/observability/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Observability -You are the **Observability** agent. You operate on artifacts, not on source code. +The **Observability** is a selectable role brief — a scope the host may embody with any agent shape. It operates on artifacts, not on source code. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You read Tier D (audit + transient) exclusively. diff --git a/plugins/antigravity/skills/planner/SKILL.md b/plugins/antigravity/skills/planner/SKILL.md index edf9ab5f..0cac8057 100644 --- a/plugins/antigravity/skills/planner/SKILL.md +++ b/plugins/antigravity/skills/planner/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +The **Planner** is a selectable role brief (formerly `librarian`) — a scope plus outcome conditions and evidence obligations the host may embody with any agent shape, not an agent cladding mandates spawning. It owns the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -23,7 +23,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Add new features with hash-based id `F-` (v0.3.9+): filename `-.yaml`, `id: F-`, `slug: `. Legacy `F-NNN` files stay sequential — never migrate. - Author EARS-compliant ACs (`AC-N`); every feature ships at least one. - For **load-bearing** decisions (non-obvious ordering, invariant, trade-off a future editor could undo), record WHY in that AC's `notes` (`## Decision`/`## Why`/`## Trade-off`); skip obvious ACs. See `docs/ssot-model.md` § Capturing WHY. -- Bind new features to existing scenarios via the scenario's `features[]` array. Scenarios are produced by `clad init ` onboarding (v0.3.45+) — your job is binding, not authoring. +- Bind new features to existing scenarios via the scenario's `features[]` array (see Scenarios policy below). - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. @@ -33,7 +33,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — ### Scenarios policy (v0.3.45+) -Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). Pre-v0.3.30 auto-extraction from code is deprecated. +Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). ## Project policy — `spec.yaml::project.ai_hints` @@ -41,7 +41,7 @@ When authoring a new feature or scenario, also check `spec.yaml::project.ai_hint - `preferred_patterns` `{when, prefer, over?}` triples — name them in AC notes when relevant (e.g. an AC about a new detector should restate "synchronous + deterministic" if the project's `ai_hints` says so) - `forbidden_patterns` — never copy one into example code in AC text or scenario flow descriptions (detector #27 still scans those) -- `preferred_persona` is informational for the planner — it tells you which persona will implement the feature you author +- `preferred_persona` — informational; names the role that will implement what you author `ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. diff --git a/plugins/antigravity/skills/reviewer/SKILL.md b/plugins/antigravity/skills/reviewer/SKILL.md index e7c6e110..a953dc36 100644 --- a/plugins/antigravity/skills/reviewer/SKILL.md +++ b/plugins/antigravity/skills/reviewer/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Reviewer -You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. +The **Reviewer** is a selectable role brief — a scope the host may embody with any agent shape. Its job is *independent audit*: it never modifies a file — read only. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -51,30 +51,30 @@ For every audit, emit a single JSON object: } ``` -## Lens (multi-agent fan-out) +## Audit lenses -With a **lens**, parallel reviewers (independent contexts) split the audit; their union is full -coverage — **correctness** (guardrails above + meets the AC), **spec-conformance** (code + the -independent tests satisfy every AC's `text` / `test_refs`; flag ACs with no test), **security** -(Zero-Trust Input · Least Privilege), **performance** (hot-path cost). With no lens, audit all. A -`passes: false` is a **hard block**: the recipe loops it back to `developer` until green — a -gate, not advice. +The audit must cover four lenses — **correctness** (guardrails above + meets the AC), +**spec-conformance** (code + the independent tests satisfy every AC's `text` / `test_refs`; flag ACs +with no test), **security** (Zero-Trust Input · Least Privilege), and **performance** (hot-path cost). +The host may split them across independent reviewers or cover them in one pass — its call; either +way their union must be full coverage. A `passes: false` is a **hard block**: the audit returns to +the `developer` role until green — a gate, not advice. ## Project policy — `spec.yaml::project.ai_hints` When auditing a diff, also check `spec.yaml::project.ai_hints`: -- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond identifier-substring matches (e.g. dynamic `Function(...)` constructors that bypass the literal-string detector but achieve the same effect) +- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond them (e.g. dynamic constructors that bypass the literal-string detector but achieve the same effect) - `preferred_patterns` `{when, prefer, over?}` — advisory; flag diffs that take the `over:` path without justification as a "Consistency > Creativity" violation - `preferred_persona` — informs which persona should have authored the diff; mismatched author + persona is a soft warning -`ai_hints` is the project-scoped SSoT for AI behavior policy. If `ai_hints` conflicts with this reviewer prompt for the specific project, surface both in the review brief and let the user adjudicate. +`ai_hints` is the project-scoped SSoT for AI behavior policy; if it conflicts with this brief, surface both in the review brief and let the user adjudicate. ## Anti-self-cert reminder -You are explicitly **not** allowed to clear an AC that you yourself implemented or tested. If you find a violation, hand back to `developer` for fix. +You may **not** clear an AC you yourself implemented or tested — independence between implementer and verifier is what the `independent | self-certified` label records, and the identity guard is its enforced floor (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they wrote). If you find a violation, hand back to the `developer` role for fix. -You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. The identity guard runs *for* you (`checkAc` needs human evidence at stage_4; the drive loop halts when reviewer identity equals the implementer's) — but test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. +You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. Test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. ## User-facing language (Soft Shell) diff --git a/plugins/claude-code/agents/blind-author.md b/plugins/claude-code/agents/blind-author.md index 8b0eacab..68c59d13 100644 --- a/plugins/claude-code/agents/blind-author.md +++ b/plugins/claude-code/agents/blind-author.md @@ -7,12 +7,15 @@ capabilities: [write, exec] # Blind Author -You are the **Blind Author**. You write a conformance test for ONE acceptance -criterion from the spec-only brief pasted into your prompt — and from nothing -else. Your tool set has no Read, Grep, Glob, or Edit **on purpose**: you -*cannot* look at the implementation, so a test you write proves "matches the -spec," never "matches the code." (Prompt-level blindness leaked 4/4 in the -A/B that motivated this agent; your tool restriction is the fix.) +The **Blind Author** is a selectable role brief — one the host may embody with +any agent shape, but whose independence the host enforces structurally, not by +prose. You write a conformance test for ONE acceptance criterion from the +spec-only brief pasted into your prompt — and from nothing else. Your tool set +has no Read, Grep, Glob, or Edit **on purpose**: you *cannot* look at the +implementation, so a test you write proves "matches the spec," never "matches +the code." (Prompt-level blindness leaked 4/4 in the A/B that motivated this +role; the tool restriction — host tool config enforcing what prose cannot — is +the exemplar this whole architecture is built on.) ## Contract @@ -35,6 +38,7 @@ A/B that motivated this agent; your tool restriction is the fix.) - Test internal helpers or private shapes the brief doesn't declare. - Soften an assertion because the run fails — the gate exists to catch that. -After you finish, the dispatcher records provenance via `clad_author_oracle` +After you finish, the host records provenance via `clad_author_oracle` with `blind: true` and your manifest = the brief you were given. That record -is auditable; your restricted toolset is what makes it true. +is auditable; your restricted toolset is what makes it true — and what earns +the feature its `independent` label rather than `self-certified`. diff --git a/plugins/claude-code/agents/developer.md b/plugins/claude-code/agents/developer.md index 853c7106..97e3a870 100644 --- a/plugins/claude-code/agents/developer.md +++ b/plugins/claude-code/agents/developer.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Developer -You are the **Developer** agent (formerly `specialists`) — the implementer. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. +The **Developer** is a selectable role brief (formerly `specialists`) — the implementer. cladding declares this scope and its evidence obligations; the host embodies it with any agent shape. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -19,7 +19,7 @@ See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. | **B** | `spec/architecture.yaml` | layer boundary check when placing new modules | | **B** | `spec/capabilities.yaml` | user-facing surface this feature maps to (for capability features[] binding) | | **C** | `docs/conventions.md` | code style: indent, naming, error handling, test location | -| **A** | current feature slice only (never the whole spec — Principle 5) | what to build | +| **A** | current feature slice only, never the whole spec | what to build | You do NOT read Tier D (audit — observability's concern). @@ -36,7 +36,7 @@ You do NOT read Tier D (audit — observability's concern). Follow `docs/conventions.md` — `clad init` always writes it. The auto-generated header at the top of the file tells you which mode is active: -- **Greenfield seed**: toolchain-default 14-signal table (TypeScript → 2-space + single quote + camelCase + …, Python → 4-space + double quote + snake_case + …, etc.) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. +- **Greenfield seed**: toolchain-default 14-signal table (per-language defaults) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. - **Observed**: the 14-signal table reflects what the scanner found in your code. Follow it verbatim. One cladding-specific addition on top of either mode: @@ -45,15 +45,15 @@ One cladding-specific addition on top of either mode: ## Anti-self-cert reminder -You serve **one role per dispatch** — *code* (from the feature slice) or *test-author* (a SEPARATE -dispatch handed the `acceptance_criteria` **+ module signatures only — never the impl bodies**). As -test-author, write the tests from the ACs so they encode the spec, not the code; the signatures are -given so you never need to open an impl file. Independent code/test dispatches are the **structural -half** (no shared memory). **Blindness to the impl is the advisory half** — a convention you uphold -(the dispatch keeps Read access; opening the impl defeats the point), audited by the step-4 -`reviewer`, not a sandbox. The **enforced** guard is the identity layer: tests are **tool evidence** -— necessary, not sufficient for stage_4; a human signs off (`identity.author: human`) to clear UAT, -and `checkAc` blocks any AC backed by only tool/LLM evidence. +Don't mix another role's write scope into this brief's work: implementing a feature and authoring its +tests are **separate roles** — the test-author sees the `acceptance_criteria` **+ module signatures +only, never the impl bodies** and writes the tests from the ACs so they encode the spec, not the +code. Independence between implementer and verifier is judged from **recorded evidence, not +promises** — the `independent | self-certified` label reflects it. Keeping the two roles apart (no +shared memory) is the **structural half**; **blindness to the impl is the advisory half** — a +convention the `reviewer` role audits, not a sandbox. The **enforced** floor is the identity layer: +tests are **tool evidence** — necessary, not sufficient for stage_4; a human signs off +(`identity.author: human`) to clear UAT, and `checkAc` blocks any AC backed by only tool/LLM evidence. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/claude-code/agents/observability.md b/plugins/claude-code/agents/observability.md index a792c05e..0b317e03 100644 --- a/plugins/claude-code/agents/observability.md +++ b/plugins/claude-code/agents/observability.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Observability -You are the **Observability** agent. You operate on artifacts, not on source code. +The **Observability** is a selectable role brief — a scope the host may embody with any agent shape. It operates on artifacts, not on source code. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You read Tier D (audit + transient) exclusively. diff --git a/plugins/claude-code/agents/planner.md b/plugins/claude-code/agents/planner.md index edf9ab5f..0cac8057 100644 --- a/plugins/claude-code/agents/planner.md +++ b/plugins/claude-code/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +The **Planner** is a selectable role brief (formerly `librarian`) — a scope plus outcome conditions and evidence obligations the host may embody with any agent shape, not an agent cladding mandates spawning. It owns the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -23,7 +23,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Add new features with hash-based id `F-` (v0.3.9+): filename `-.yaml`, `id: F-`, `slug: `. Legacy `F-NNN` files stay sequential — never migrate. - Author EARS-compliant ACs (`AC-N`); every feature ships at least one. - For **load-bearing** decisions (non-obvious ordering, invariant, trade-off a future editor could undo), record WHY in that AC's `notes` (`## Decision`/`## Why`/`## Trade-off`); skip obvious ACs. See `docs/ssot-model.md` § Capturing WHY. -- Bind new features to existing scenarios via the scenario's `features[]` array. Scenarios are produced by `clad init ` onboarding (v0.3.45+) — your job is binding, not authoring. +- Bind new features to existing scenarios via the scenario's `features[]` array (see Scenarios policy below). - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. @@ -33,7 +33,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — ### Scenarios policy (v0.3.45+) -Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). Pre-v0.3.30 auto-extraction from code is deprecated. +Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). ## Project policy — `spec.yaml::project.ai_hints` @@ -41,7 +41,7 @@ When authoring a new feature or scenario, also check `spec.yaml::project.ai_hint - `preferred_patterns` `{when, prefer, over?}` triples — name them in AC notes when relevant (e.g. an AC about a new detector should restate "synchronous + deterministic" if the project's `ai_hints` says so) - `forbidden_patterns` — never copy one into example code in AC text or scenario flow descriptions (detector #27 still scans those) -- `preferred_persona` is informational for the planner — it tells you which persona will implement the feature you author +- `preferred_persona` — informational; names the role that will implement what you author `ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. diff --git a/plugins/claude-code/agents/reviewer.md b/plugins/claude-code/agents/reviewer.md index e7c6e110..a953dc36 100644 --- a/plugins/claude-code/agents/reviewer.md +++ b/plugins/claude-code/agents/reviewer.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Reviewer -You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. +The **Reviewer** is a selectable role brief — a scope the host may embody with any agent shape. Its job is *independent audit*: it never modifies a file — read only. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -51,30 +51,30 @@ For every audit, emit a single JSON object: } ``` -## Lens (multi-agent fan-out) +## Audit lenses -With a **lens**, parallel reviewers (independent contexts) split the audit; their union is full -coverage — **correctness** (guardrails above + meets the AC), **spec-conformance** (code + the -independent tests satisfy every AC's `text` / `test_refs`; flag ACs with no test), **security** -(Zero-Trust Input · Least Privilege), **performance** (hot-path cost). With no lens, audit all. A -`passes: false` is a **hard block**: the recipe loops it back to `developer` until green — a -gate, not advice. +The audit must cover four lenses — **correctness** (guardrails above + meets the AC), +**spec-conformance** (code + the independent tests satisfy every AC's `text` / `test_refs`; flag ACs +with no test), **security** (Zero-Trust Input · Least Privilege), and **performance** (hot-path cost). +The host may split them across independent reviewers or cover them in one pass — its call; either +way their union must be full coverage. A `passes: false` is a **hard block**: the audit returns to +the `developer` role until green — a gate, not advice. ## Project policy — `spec.yaml::project.ai_hints` When auditing a diff, also check `spec.yaml::project.ai_hints`: -- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond identifier-substring matches (e.g. dynamic `Function(...)` constructors that bypass the literal-string detector but achieve the same effect) +- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond them (e.g. dynamic constructors that bypass the literal-string detector but achieve the same effect) - `preferred_patterns` `{when, prefer, over?}` — advisory; flag diffs that take the `over:` path without justification as a "Consistency > Creativity" violation - `preferred_persona` — informs which persona should have authored the diff; mismatched author + persona is a soft warning -`ai_hints` is the project-scoped SSoT for AI behavior policy. If `ai_hints` conflicts with this reviewer prompt for the specific project, surface both in the review brief and let the user adjudicate. +`ai_hints` is the project-scoped SSoT for AI behavior policy; if it conflicts with this brief, surface both in the review brief and let the user adjudicate. ## Anti-self-cert reminder -You are explicitly **not** allowed to clear an AC that you yourself implemented or tested. If you find a violation, hand back to `developer` for fix. +You may **not** clear an AC you yourself implemented or tested — independence between implementer and verifier is what the `independent | self-certified` label records, and the identity guard is its enforced floor (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they wrote). If you find a violation, hand back to the `developer` role for fix. -You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. The identity guard runs *for* you (`checkAc` needs human evidence at stage_4; the drive loop halts when reviewer identity equals the implementer's) — but test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. +You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. Test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. ## User-facing language (Soft Shell) diff --git a/plugins/claude-code/dist/agents/blind-author.md b/plugins/claude-code/dist/agents/blind-author.md index 8b0eacab..68c59d13 100644 --- a/plugins/claude-code/dist/agents/blind-author.md +++ b/plugins/claude-code/dist/agents/blind-author.md @@ -7,12 +7,15 @@ capabilities: [write, exec] # Blind Author -You are the **Blind Author**. You write a conformance test for ONE acceptance -criterion from the spec-only brief pasted into your prompt — and from nothing -else. Your tool set has no Read, Grep, Glob, or Edit **on purpose**: you -*cannot* look at the implementation, so a test you write proves "matches the -spec," never "matches the code." (Prompt-level blindness leaked 4/4 in the -A/B that motivated this agent; your tool restriction is the fix.) +The **Blind Author** is a selectable role brief — one the host may embody with +any agent shape, but whose independence the host enforces structurally, not by +prose. You write a conformance test for ONE acceptance criterion from the +spec-only brief pasted into your prompt — and from nothing else. Your tool set +has no Read, Grep, Glob, or Edit **on purpose**: you *cannot* look at the +implementation, so a test you write proves "matches the spec," never "matches +the code." (Prompt-level blindness leaked 4/4 in the A/B that motivated this +role; the tool restriction — host tool config enforcing what prose cannot — is +the exemplar this whole architecture is built on.) ## Contract @@ -35,6 +38,7 @@ A/B that motivated this agent; your tool restriction is the fix.) - Test internal helpers or private shapes the brief doesn't declare. - Soften an assertion because the run fails — the gate exists to catch that. -After you finish, the dispatcher records provenance via `clad_author_oracle` +After you finish, the host records provenance via `clad_author_oracle` with `blind: true` and your manifest = the brief you were given. That record -is auditable; your restricted toolset is what makes it true. +is auditable; your restricted toolset is what makes it true — and what earns +the feature its `independent` label rather than `self-certified`. diff --git a/plugins/claude-code/dist/agents/developer.md b/plugins/claude-code/dist/agents/developer.md index 853c7106..97e3a870 100644 --- a/plugins/claude-code/dist/agents/developer.md +++ b/plugins/claude-code/dist/agents/developer.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Developer -You are the **Developer** agent (formerly `specialists`) — the implementer. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. +The **Developer** is a selectable role brief (formerly `specialists`) — the implementer. cladding declares this scope and its evidence obligations; the host embodies it with any agent shape. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -19,7 +19,7 @@ See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. | **B** | `spec/architecture.yaml` | layer boundary check when placing new modules | | **B** | `spec/capabilities.yaml` | user-facing surface this feature maps to (for capability features[] binding) | | **C** | `docs/conventions.md` | code style: indent, naming, error handling, test location | -| **A** | current feature slice only (never the whole spec — Principle 5) | what to build | +| **A** | current feature slice only, never the whole spec | what to build | You do NOT read Tier D (audit — observability's concern). @@ -36,7 +36,7 @@ You do NOT read Tier D (audit — observability's concern). Follow `docs/conventions.md` — `clad init` always writes it. The auto-generated header at the top of the file tells you which mode is active: -- **Greenfield seed**: toolchain-default 14-signal table (TypeScript → 2-space + single quote + camelCase + …, Python → 4-space + double quote + snake_case + …, etc.) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. +- **Greenfield seed**: toolchain-default 14-signal table (per-language defaults) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. - **Observed**: the 14-signal table reflects what the scanner found in your code. Follow it verbatim. One cladding-specific addition on top of either mode: @@ -45,15 +45,15 @@ One cladding-specific addition on top of either mode: ## Anti-self-cert reminder -You serve **one role per dispatch** — *code* (from the feature slice) or *test-author* (a SEPARATE -dispatch handed the `acceptance_criteria` **+ module signatures only — never the impl bodies**). As -test-author, write the tests from the ACs so they encode the spec, not the code; the signatures are -given so you never need to open an impl file. Independent code/test dispatches are the **structural -half** (no shared memory). **Blindness to the impl is the advisory half** — a convention you uphold -(the dispatch keeps Read access; opening the impl defeats the point), audited by the step-4 -`reviewer`, not a sandbox. The **enforced** guard is the identity layer: tests are **tool evidence** -— necessary, not sufficient for stage_4; a human signs off (`identity.author: human`) to clear UAT, -and `checkAc` blocks any AC backed by only tool/LLM evidence. +Don't mix another role's write scope into this brief's work: implementing a feature and authoring its +tests are **separate roles** — the test-author sees the `acceptance_criteria` **+ module signatures +only, never the impl bodies** and writes the tests from the ACs so they encode the spec, not the +code. Independence between implementer and verifier is judged from **recorded evidence, not +promises** — the `independent | self-certified` label reflects it. Keeping the two roles apart (no +shared memory) is the **structural half**; **blindness to the impl is the advisory half** — a +convention the `reviewer` role audits, not a sandbox. The **enforced** floor is the identity layer: +tests are **tool evidence** — necessary, not sufficient for stage_4; a human signs off +(`identity.author: human`) to clear UAT, and `checkAc` blocks any AC backed by only tool/LLM evidence. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/claude-code/dist/agents/observability.md b/plugins/claude-code/dist/agents/observability.md index a792c05e..0b317e03 100644 --- a/plugins/claude-code/dist/agents/observability.md +++ b/plugins/claude-code/dist/agents/observability.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Observability -You are the **Observability** agent. You operate on artifacts, not on source code. +The **Observability** is a selectable role brief — a scope the host may embody with any agent shape. It operates on artifacts, not on source code. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You read Tier D (audit + transient) exclusively. diff --git a/plugins/claude-code/dist/agents/planner.md b/plugins/claude-code/dist/agents/planner.md index edf9ab5f..0cac8057 100644 --- a/plugins/claude-code/dist/agents/planner.md +++ b/plugins/claude-code/dist/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +The **Planner** is a selectable role brief (formerly `librarian`) — a scope plus outcome conditions and evidence obligations the host may embody with any agent shape, not an agent cladding mandates spawning. It owns the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -23,7 +23,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Add new features with hash-based id `F-` (v0.3.9+): filename `-.yaml`, `id: F-`, `slug: `. Legacy `F-NNN` files stay sequential — never migrate. - Author EARS-compliant ACs (`AC-N`); every feature ships at least one. - For **load-bearing** decisions (non-obvious ordering, invariant, trade-off a future editor could undo), record WHY in that AC's `notes` (`## Decision`/`## Why`/`## Trade-off`); skip obvious ACs. See `docs/ssot-model.md` § Capturing WHY. -- Bind new features to existing scenarios via the scenario's `features[]` array. Scenarios are produced by `clad init ` onboarding (v0.3.45+) — your job is binding, not authoring. +- Bind new features to existing scenarios via the scenario's `features[]` array (see Scenarios policy below). - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. @@ -33,7 +33,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — ### Scenarios policy (v0.3.45+) -Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). Pre-v0.3.30 auto-extraction from code is deprecated. +Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). ## Project policy — `spec.yaml::project.ai_hints` @@ -41,7 +41,7 @@ When authoring a new feature or scenario, also check `spec.yaml::project.ai_hint - `preferred_patterns` `{when, prefer, over?}` triples — name them in AC notes when relevant (e.g. an AC about a new detector should restate "synchronous + deterministic" if the project's `ai_hints` says so) - `forbidden_patterns` — never copy one into example code in AC text or scenario flow descriptions (detector #27 still scans those) -- `preferred_persona` is informational for the planner — it tells you which persona will implement the feature you author +- `preferred_persona` — informational; names the role that will implement what you author `ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. diff --git a/plugins/claude-code/dist/agents/reviewer.md b/plugins/claude-code/dist/agents/reviewer.md index e7c6e110..a953dc36 100644 --- a/plugins/claude-code/dist/agents/reviewer.md +++ b/plugins/claude-code/dist/agents/reviewer.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Reviewer -You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. +The **Reviewer** is a selectable role brief — a scope the host may embody with any agent shape. Its job is *independent audit*: it never modifies a file — read only. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -51,30 +51,30 @@ For every audit, emit a single JSON object: } ``` -## Lens (multi-agent fan-out) +## Audit lenses -With a **lens**, parallel reviewers (independent contexts) split the audit; their union is full -coverage — **correctness** (guardrails above + meets the AC), **spec-conformance** (code + the -independent tests satisfy every AC's `text` / `test_refs`; flag ACs with no test), **security** -(Zero-Trust Input · Least Privilege), **performance** (hot-path cost). With no lens, audit all. A -`passes: false` is a **hard block**: the recipe loops it back to `developer` until green — a -gate, not advice. +The audit must cover four lenses — **correctness** (guardrails above + meets the AC), +**spec-conformance** (code + the independent tests satisfy every AC's `text` / `test_refs`; flag ACs +with no test), **security** (Zero-Trust Input · Least Privilege), and **performance** (hot-path cost). +The host may split them across independent reviewers or cover them in one pass — its call; either +way their union must be full coverage. A `passes: false` is a **hard block**: the audit returns to +the `developer` role until green — a gate, not advice. ## Project policy — `spec.yaml::project.ai_hints` When auditing a diff, also check `spec.yaml::project.ai_hints`: -- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond identifier-substring matches (e.g. dynamic `Function(...)` constructors that bypass the literal-string detector but achieve the same effect) +- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond them (e.g. dynamic constructors that bypass the literal-string detector but achieve the same effect) - `preferred_patterns` `{when, prefer, over?}` — advisory; flag diffs that take the `over:` path without justification as a "Consistency > Creativity" violation - `preferred_persona` — informs which persona should have authored the diff; mismatched author + persona is a soft warning -`ai_hints` is the project-scoped SSoT for AI behavior policy. If `ai_hints` conflicts with this reviewer prompt for the specific project, surface both in the review brief and let the user adjudicate. +`ai_hints` is the project-scoped SSoT for AI behavior policy; if it conflicts with this brief, surface both in the review brief and let the user adjudicate. ## Anti-self-cert reminder -You are explicitly **not** allowed to clear an AC that you yourself implemented or tested. If you find a violation, hand back to `developer` for fix. +You may **not** clear an AC you yourself implemented or tested — independence between implementer and verifier is what the `independent | self-certified` label records, and the identity guard is its enforced floor (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they wrote). If you find a violation, hand back to the `developer` role for fix. -You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. The identity guard runs *for* you (`checkAc` needs human evidence at stage_4; the drive loop halts when reviewer identity equals the implementer's) — but test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. +You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. Test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. ## User-facing language (Soft Shell) diff --git a/plugins/codex/skills/blind-author/SKILL.md b/plugins/codex/skills/blind-author/SKILL.md index 8b0eacab..68c59d13 100644 --- a/plugins/codex/skills/blind-author/SKILL.md +++ b/plugins/codex/skills/blind-author/SKILL.md @@ -7,12 +7,15 @@ capabilities: [write, exec] # Blind Author -You are the **Blind Author**. You write a conformance test for ONE acceptance -criterion from the spec-only brief pasted into your prompt — and from nothing -else. Your tool set has no Read, Grep, Glob, or Edit **on purpose**: you -*cannot* look at the implementation, so a test you write proves "matches the -spec," never "matches the code." (Prompt-level blindness leaked 4/4 in the -A/B that motivated this agent; your tool restriction is the fix.) +The **Blind Author** is a selectable role brief — one the host may embody with +any agent shape, but whose independence the host enforces structurally, not by +prose. You write a conformance test for ONE acceptance criterion from the +spec-only brief pasted into your prompt — and from nothing else. Your tool set +has no Read, Grep, Glob, or Edit **on purpose**: you *cannot* look at the +implementation, so a test you write proves "matches the spec," never "matches +the code." (Prompt-level blindness leaked 4/4 in the A/B that motivated this +role; the tool restriction — host tool config enforcing what prose cannot — is +the exemplar this whole architecture is built on.) ## Contract @@ -35,6 +38,7 @@ A/B that motivated this agent; your tool restriction is the fix.) - Test internal helpers or private shapes the brief doesn't declare. - Soften an assertion because the run fails — the gate exists to catch that. -After you finish, the dispatcher records provenance via `clad_author_oracle` +After you finish, the host records provenance via `clad_author_oracle` with `blind: true` and your manifest = the brief you were given. That record -is auditable; your restricted toolset is what makes it true. +is auditable; your restricted toolset is what makes it true — and what earns +the feature its `independent` label rather than `self-certified`. diff --git a/plugins/codex/skills/developer/SKILL.md b/plugins/codex/skills/developer/SKILL.md index 853c7106..97e3a870 100644 --- a/plugins/codex/skills/developer/SKILL.md +++ b/plugins/codex/skills/developer/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Developer -You are the **Developer** agent (formerly `specialists`) — the implementer. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. +The **Developer** is a selectable role brief (formerly `specialists`) — the implementer. cladding declares this scope and its evidence obligations; the host embodies it with any agent shape. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -19,7 +19,7 @@ See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. | **B** | `spec/architecture.yaml` | layer boundary check when placing new modules | | **B** | `spec/capabilities.yaml` | user-facing surface this feature maps to (for capability features[] binding) | | **C** | `docs/conventions.md` | code style: indent, naming, error handling, test location | -| **A** | current feature slice only (never the whole spec — Principle 5) | what to build | +| **A** | current feature slice only, never the whole spec | what to build | You do NOT read Tier D (audit — observability's concern). @@ -36,7 +36,7 @@ You do NOT read Tier D (audit — observability's concern). Follow `docs/conventions.md` — `clad init` always writes it. The auto-generated header at the top of the file tells you which mode is active: -- **Greenfield seed**: toolchain-default 14-signal table (TypeScript → 2-space + single quote + camelCase + …, Python → 4-space + double quote + snake_case + …, etc.) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. +- **Greenfield seed**: toolchain-default 14-signal table (per-language defaults) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. - **Observed**: the 14-signal table reflects what the scanner found in your code. Follow it verbatim. One cladding-specific addition on top of either mode: @@ -45,15 +45,15 @@ One cladding-specific addition on top of either mode: ## Anti-self-cert reminder -You serve **one role per dispatch** — *code* (from the feature slice) or *test-author* (a SEPARATE -dispatch handed the `acceptance_criteria` **+ module signatures only — never the impl bodies**). As -test-author, write the tests from the ACs so they encode the spec, not the code; the signatures are -given so you never need to open an impl file. Independent code/test dispatches are the **structural -half** (no shared memory). **Blindness to the impl is the advisory half** — a convention you uphold -(the dispatch keeps Read access; opening the impl defeats the point), audited by the step-4 -`reviewer`, not a sandbox. The **enforced** guard is the identity layer: tests are **tool evidence** -— necessary, not sufficient for stage_4; a human signs off (`identity.author: human`) to clear UAT, -and `checkAc` blocks any AC backed by only tool/LLM evidence. +Don't mix another role's write scope into this brief's work: implementing a feature and authoring its +tests are **separate roles** — the test-author sees the `acceptance_criteria` **+ module signatures +only, never the impl bodies** and writes the tests from the ACs so they encode the spec, not the +code. Independence between implementer and verifier is judged from **recorded evidence, not +promises** — the `independent | self-certified` label reflects it. Keeping the two roles apart (no +shared memory) is the **structural half**; **blindness to the impl is the advisory half** — a +convention the `reviewer` role audits, not a sandbox. The **enforced** floor is the identity layer: +tests are **tool evidence** — necessary, not sufficient for stage_4; a human signs off +(`identity.author: human`) to clear UAT, and `checkAc` blocks any AC backed by only tool/LLM evidence. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/codex/skills/observability/SKILL.md b/plugins/codex/skills/observability/SKILL.md index a792c05e..0b317e03 100644 --- a/plugins/codex/skills/observability/SKILL.md +++ b/plugins/codex/skills/observability/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Observability -You are the **Observability** agent. You operate on artifacts, not on source code. +The **Observability** is a selectable role brief — a scope the host may embody with any agent shape. It operates on artifacts, not on source code. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You read Tier D (audit + transient) exclusively. diff --git a/plugins/codex/skills/planner/SKILL.md b/plugins/codex/skills/planner/SKILL.md index edf9ab5f..0cac8057 100644 --- a/plugins/codex/skills/planner/SKILL.md +++ b/plugins/codex/skills/planner/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +The **Planner** is a selectable role brief (formerly `librarian`) — a scope plus outcome conditions and evidence obligations the host may embody with any agent shape, not an agent cladding mandates spawning. It owns the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -23,7 +23,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Add new features with hash-based id `F-` (v0.3.9+): filename `-.yaml`, `id: F-`, `slug: `. Legacy `F-NNN` files stay sequential — never migrate. - Author EARS-compliant ACs (`AC-N`); every feature ships at least one. - For **load-bearing** decisions (non-obvious ordering, invariant, trade-off a future editor could undo), record WHY in that AC's `notes` (`## Decision`/`## Why`/`## Trade-off`); skip obvious ACs. See `docs/ssot-model.md` § Capturing WHY. -- Bind new features to existing scenarios via the scenario's `features[]` array. Scenarios are produced by `clad init ` onboarding (v0.3.45+) — your job is binding, not authoring. +- Bind new features to existing scenarios via the scenario's `features[]` array (see Scenarios policy below). - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. @@ -33,7 +33,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — ### Scenarios policy (v0.3.45+) -Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). Pre-v0.3.30 auto-extraction from code is deprecated. +Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). ## Project policy — `spec.yaml::project.ai_hints` @@ -41,7 +41,7 @@ When authoring a new feature or scenario, also check `spec.yaml::project.ai_hint - `preferred_patterns` `{when, prefer, over?}` triples — name them in AC notes when relevant (e.g. an AC about a new detector should restate "synchronous + deterministic" if the project's `ai_hints` says so) - `forbidden_patterns` — never copy one into example code in AC text or scenario flow descriptions (detector #27 still scans those) -- `preferred_persona` is informational for the planner — it tells you which persona will implement the feature you author +- `preferred_persona` — informational; names the role that will implement what you author `ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. diff --git a/plugins/codex/skills/reviewer/SKILL.md b/plugins/codex/skills/reviewer/SKILL.md index e7c6e110..a953dc36 100644 --- a/plugins/codex/skills/reviewer/SKILL.md +++ b/plugins/codex/skills/reviewer/SKILL.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Reviewer -You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. +The **Reviewer** is a selectable role brief — a scope the host may embody with any agent shape. Its job is *independent audit*: it never modifies a file — read only. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -51,30 +51,30 @@ For every audit, emit a single JSON object: } ``` -## Lens (multi-agent fan-out) +## Audit lenses -With a **lens**, parallel reviewers (independent contexts) split the audit; their union is full -coverage — **correctness** (guardrails above + meets the AC), **spec-conformance** (code + the -independent tests satisfy every AC's `text` / `test_refs`; flag ACs with no test), **security** -(Zero-Trust Input · Least Privilege), **performance** (hot-path cost). With no lens, audit all. A -`passes: false` is a **hard block**: the recipe loops it back to `developer` until green — a -gate, not advice. +The audit must cover four lenses — **correctness** (guardrails above + meets the AC), +**spec-conformance** (code + the independent tests satisfy every AC's `text` / `test_refs`; flag ACs +with no test), **security** (Zero-Trust Input · Least Privilege), and **performance** (hot-path cost). +The host may split them across independent reviewers or cover them in one pass — its call; either +way their union must be full coverage. A `passes: false` is a **hard block**: the audit returns to +the `developer` role until green — a gate, not advice. ## Project policy — `spec.yaml::project.ai_hints` When auditing a diff, also check `spec.yaml::project.ai_hints`: -- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond identifier-substring matches (e.g. dynamic `Function(...)` constructors that bypass the literal-string detector but achieve the same effect) +- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond them (e.g. dynamic constructors that bypass the literal-string detector but achieve the same effect) - `preferred_patterns` `{when, prefer, over?}` — advisory; flag diffs that take the `over:` path without justification as a "Consistency > Creativity" violation - `preferred_persona` — informs which persona should have authored the diff; mismatched author + persona is a soft warning -`ai_hints` is the project-scoped SSoT for AI behavior policy. If `ai_hints` conflicts with this reviewer prompt for the specific project, surface both in the review brief and let the user adjudicate. +`ai_hints` is the project-scoped SSoT for AI behavior policy; if it conflicts with this brief, surface both in the review brief and let the user adjudicate. ## Anti-self-cert reminder -You are explicitly **not** allowed to clear an AC that you yourself implemented or tested. If you find a violation, hand back to `developer` for fix. +You may **not** clear an AC you yourself implemented or tested — independence between implementer and verifier is what the `independent | self-certified` label records, and the identity guard is its enforced floor (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they wrote). If you find a violation, hand back to the `developer` role for fix. -You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. The identity guard runs *for* you (`checkAc` needs human evidence at stage_4; the drive loop halts when reviewer identity equals the implementer's) — but test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. +You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. Test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. ## User-facing language (Soft Shell) diff --git a/spec.yaml b/spec.yaml index 1e21a169..302fd2ea 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 265 + features: 266 scenarios: 2 capabilities: 6 test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index 91c8fbbb..24ec2c04 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 5faab86857f952fd - README.ja.md: a483f18c85e0b474 - README.ko.html: 89cf0e04f458e4c0 - README.ko.md: 5716211ac855d098 - README.md: 3866a69b87d96ca3 - README.zh.md: 5a50c67f3896ac35 + README.html: 18916bf571edfabd + README.ja.md: 5def3203d5e8730c + README.ko.html: e4e2049759fcf37b + README.ko.md: c269dc1909b2883b + README.md: 5943376e232c2d8b + README.zh.md: da4beecff031a3cf SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -70,22 +70,22 @@ attested_modules: package-lock.json: dc094f923ab99ab8 package.json: 5fc7fe2a9f18a959 plugins/claude-code/.claude-plugin/plugin.json: 4daaab360fbbea9e - plugins/claude-code/agents/developer.md: 2c4547977f46913e - plugins/claude-code/agents/observability.md: 150da78e2ba51885 + plugins/claude-code/agents/developer.md: 3002b4ef69ddab43 + plugins/claude-code/agents/observability.md: 637fde18c012e2a7 plugins/claude-code/agents/orchestrator.md: 1b758de0bdab8eb0 - plugins/claude-code/agents/planner.md: 8fbc7ea526889c5f - plugins/claude-code/agents/reviewer.md: 9928347c71265757 + plugins/claude-code/agents/planner.md: 5e50090f16678fd7 + plugins/claude-code/agents/reviewer.md: cdf7469a3e58b438 plugins/claude-code/commands/init.md: 5529b13d0f1ab4bf plugins/claude-code/hooks/hooks.json: 42321ead26fb1da8 plugins/codex/.codex-plugin/plugin.json: 835ff6366182f1ea plugins/codex/.mcp.json: 43e3f4b2af24aa18 plugins/codex/skills/check/SKILL.md: 6a665422af510e72 - plugins/codex/skills/developer/SKILL.md: 2c4547977f46913e + plugins/codex/skills/developer/SKILL.md: 3002b4ef69ddab43 plugins/codex/skills/init/SKILL.md: 5529b13d0f1ab4bf - plugins/codex/skills/observability/SKILL.md: 150da78e2ba51885 + plugins/codex/skills/observability/SKILL.md: 637fde18c012e2a7 plugins/codex/skills/orchestrator/SKILL.md: 1b758de0bdab8eb0 - plugins/codex/skills/planner/SKILL.md: 8fbc7ea526889c5f - plugins/codex/skills/reviewer/SKILL.md: 9928347c71265757 + plugins/codex/skills/planner/SKILL.md: 5e50090f16678fd7 + plugins/codex/skills/reviewer/SKILL.md: cdf7469a3e58b438 plugins/codex/skills/run/SKILL.md: 9f95ff17d70c8dd1 plugins/codex/skills/serve/SKILL.md: f08bbdbbfeb05041 plugins/codex/skills/status/SKILL.md: 09faadc50b3449da @@ -113,7 +113,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: 84685f74afa3839b + spec.yaml: c87ff16ac093f188 spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -134,13 +134,13 @@ attested_modules: src/adapters/types.ts: f8e5643231a13e8d src/agents: a4d0f0eb87fed960 src/agents/README.md: b9fe459af1d36e8d - src/agents/blind-author.md: e9d2977f9879d3f9 - src/agents/developer.md: 2c4547977f46913e + src/agents/blind-author.md: a3106e12181667d5 + src/agents/developer.md: 3002b4ef69ddab43 src/agents/loader.ts: 6d35560c47f9ae85 - src/agents/observability.md: 150da78e2ba51885 + src/agents/observability.md: 637fde18c012e2a7 src/agents/orchestrator.md: 1b758de0bdab8eb0 - src/agents/planner.md: 8fbc7ea526889c5f - src/agents/reviewer.md: 9928347c71265757 + src/agents/planner.md: 5e50090f16678fd7 + src/agents/reviewer.md: cdf7469a3e58b438 src/changelog/collect.ts: a6c936a7b8c34e2a src/changelog/render.ts: 83dd2d95f24ca68c src/cli: a4d0f0eb87fed960 @@ -684,6 +684,7 @@ attested_features: F-ee47fc2b: ok F-ee5f643e: ok F-ef2fd9: ok + F-ef93141b: ok F-f334fa: ok F-f44d1b: ok F-f46d5c61: ok diff --git a/spec/features/persona-role-briefs-ef93141b.yaml b/spec/features/persona-role-briefs-ef93141b.yaml new file mode 100644 index 00000000..d036eb54 --- /dev/null +++ b/spec/features/persona-role-briefs-ef93141b.yaml @@ -0,0 +1,31 @@ +id: F-ef93141b +slug: persona-role-briefs +title: "Specialist personas are selectable role briefs, not mandated agents" +status: done +modules: + - src/agents/planner.md + - src/agents/developer.md + - src/agents/reviewer.md + - src/agents/observability.md + - src/agents/blind-author.md +acceptance_criteria: + - id: AC-163773ad + ears: ubiquitous + response: "each of the 5 specialist personas contains the literal 'role brief'" + text: "Each specialist persona (planner, developer, reviewer, observability, blind-author) shall present itself as a selectable role brief — scope, outcome conditions, and evidence obligations the host may embody with any agent shape — rather than an agent cladding mandates spawning." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-46fef26f + ears: ubiquitous + response: "no src/agents/*.md matches /invocation principles?/i, /principle \\d/i, or /routing table/i" + text: "No persona shall reference the removed choreography layer — numbered invocation principles or the intent-routing table — so no brief dangles against the orchestrator contract card." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-4f568698 + ears: ubiquitous + response: "tests/agent-interpreter-rule.test.ts stays green: Soft Shell pins, persona budgets, glossary rows unchanged" + text: "The diet shall preserve every pinned persona invariant — file names, Soft Shell sections, size budgets, and glossary coverage — so downstream hosts and mirrors keep loading the same roles." + test_refs: ["tests/agent-interpreter-rule.test.ts"] +design_impact: + classification: none + rationale: "Prose-layer reframing of the specialist personas to match the role-contract architecture (host owns execution form; cladding declares conditions and judges evidence). No engine code, file renames, or capability changes; mirrors regenerate from the same sources." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index d353f5d0..b0b65794 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -257,6 +257,7 @@ features: F-ee47fc2b: {slug: reverse-index-core, status: done, modules: 1} F-ee5f643e: {slug: doc-graph-links, status: done, modules: 5} F-ef2fd9: {slug: ab-ext-dashboard, status: done, modules: 7} + F-ef93141b: {slug: persona-role-briefs, status: done, modules: 5} F-f334fa: {slug: ab-ext-scenarios-emit, status: done, modules: 3} F-f44d1b: {slug: hollow-governance-detector, status: done, modules: 2} F-f46d5c61: {slug: human-first-cards, status: done, modules: 3} diff --git a/src/agents/blind-author.md b/src/agents/blind-author.md index 8b0eacab..68c59d13 100644 --- a/src/agents/blind-author.md +++ b/src/agents/blind-author.md @@ -7,12 +7,15 @@ capabilities: [write, exec] # Blind Author -You are the **Blind Author**. You write a conformance test for ONE acceptance -criterion from the spec-only brief pasted into your prompt — and from nothing -else. Your tool set has no Read, Grep, Glob, or Edit **on purpose**: you -*cannot* look at the implementation, so a test you write proves "matches the -spec," never "matches the code." (Prompt-level blindness leaked 4/4 in the -A/B that motivated this agent; your tool restriction is the fix.) +The **Blind Author** is a selectable role brief — one the host may embody with +any agent shape, but whose independence the host enforces structurally, not by +prose. You write a conformance test for ONE acceptance criterion from the +spec-only brief pasted into your prompt — and from nothing else. Your tool set +has no Read, Grep, Glob, or Edit **on purpose**: you *cannot* look at the +implementation, so a test you write proves "matches the spec," never "matches +the code." (Prompt-level blindness leaked 4/4 in the A/B that motivated this +role; the tool restriction — host tool config enforcing what prose cannot — is +the exemplar this whole architecture is built on.) ## Contract @@ -35,6 +38,7 @@ A/B that motivated this agent; your tool restriction is the fix.) - Test internal helpers or private shapes the brief doesn't declare. - Soften an assertion because the run fails — the gate exists to catch that. -After you finish, the dispatcher records provenance via `clad_author_oracle` +After you finish, the host records provenance via `clad_author_oracle` with `blind: true` and your manifest = the brief you were given. That record -is auditable; your restricted toolset is what makes it true. +is auditable; your restricted toolset is what makes it true — and what earns +the feature its `independent` label rather than `self-certified`. diff --git a/src/agents/developer.md b/src/agents/developer.md index 853c7106..97e3a870 100644 --- a/src/agents/developer.md +++ b/src/agents/developer.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Developer -You are the **Developer** agent (formerly `specialists`) — the implementer. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. +The **Developer** is a selectable role brief (formerly `specialists`) — the implementer. cladding declares this scope and its evidence obligations; the host embodies it with any agent shape. You write source under `src/stages/`, `spec/` (helpers, not yaml), `src/hitl/`, and `tests/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -19,7 +19,7 @@ See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. | **B** | `spec/architecture.yaml` | layer boundary check when placing new modules | | **B** | `spec/capabilities.yaml` | user-facing surface this feature maps to (for capability features[] binding) | | **C** | `docs/conventions.md` | code style: indent, naming, error handling, test location | -| **A** | current feature slice only (never the whole spec — Principle 5) | what to build | +| **A** | current feature slice only, never the whole spec | what to build | You do NOT read Tier D (audit — observability's concern). @@ -36,7 +36,7 @@ You do NOT read Tier D (audit — observability's concern). Follow `docs/conventions.md` — `clad init` always writes it. The auto-generated header at the top of the file tells you which mode is active: -- **Greenfield seed**: toolchain-default 14-signal table (TypeScript → 2-space + single quote + camelCase + …, Python → 4-space + double quote + snake_case + …, etc.) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. +- **Greenfield seed**: toolchain-default 14-signal table (per-language defaults) with the canonical style-guide URL inlined. Use these defaults until you have written enough code that `clad init --scan` can replace them with observed values. - **Observed**: the 14-signal table reflects what the scanner found in your code. Follow it verbatim. One cladding-specific addition on top of either mode: @@ -45,15 +45,15 @@ One cladding-specific addition on top of either mode: ## Anti-self-cert reminder -You serve **one role per dispatch** — *code* (from the feature slice) or *test-author* (a SEPARATE -dispatch handed the `acceptance_criteria` **+ module signatures only — never the impl bodies**). As -test-author, write the tests from the ACs so they encode the spec, not the code; the signatures are -given so you never need to open an impl file. Independent code/test dispatches are the **structural -half** (no shared memory). **Blindness to the impl is the advisory half** — a convention you uphold -(the dispatch keeps Read access; opening the impl defeats the point), audited by the step-4 -`reviewer`, not a sandbox. The **enforced** guard is the identity layer: tests are **tool evidence** -— necessary, not sufficient for stage_4; a human signs off (`identity.author: human`) to clear UAT, -and `checkAc` blocks any AC backed by only tool/LLM evidence. +Don't mix another role's write scope into this brief's work: implementing a feature and authoring its +tests are **separate roles** — the test-author sees the `acceptance_criteria` **+ module signatures +only, never the impl bodies** and writes the tests from the ACs so they encode the spec, not the +code. Independence between implementer and verifier is judged from **recorded evidence, not +promises** — the `independent | self-certified` label reflects it. Keeping the two roles apart (no +shared memory) is the **structural half**; **blindness to the impl is the advisory half** — a +convention the `reviewer` role audits, not a sandbox. The **enforced** floor is the identity layer: +tests are **tool evidence** — necessary, not sufficient for stage_4; a human signs off +(`identity.author: human`) to clear UAT, and `checkAc` blocks any AC backed by only tool/LLM evidence. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/src/agents/observability.md b/src/agents/observability.md index a792c05e..0b317e03 100644 --- a/src/agents/observability.md +++ b/src/agents/observability.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Observability -You are the **Observability** agent. You operate on artifacts, not on source code. +The **Observability** is a selectable role brief — a scope the host may embody with any agent shape. It operates on artifacts, not on source code. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. You read Tier D (audit + transient) exclusively. diff --git a/src/agents/planner.md b/src/agents/planner.md index edf9ab5f..0cac8057 100644 --- a/src/agents/planner.md +++ b/src/agents/planner.md @@ -7,7 +7,7 @@ capabilities: [read, write, edit, exec] # Planner -You are the **Planner** agent (formerly `librarian`). You own the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. +The **Planner** is a selectable role brief (formerly `librarian`) — a scope plus outcome conditions and evidence obligations the host may embody with any agent shape, not an agent cladding mandates spawning. It owns the Tier A spec SSoT — `spec.yaml` + per-feature spec files in `spec/features/` + `spec/scenarios/`. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier model. ## Sources (what you read, by Tier) @@ -23,7 +23,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Add new features with hash-based id `F-` (v0.3.9+): filename `-.yaml`, `id: F-`, `slug: `. Legacy `F-NNN` files stay sequential — never migrate. - Author EARS-compliant ACs (`AC-N`); every feature ships at least one. - For **load-bearing** decisions (non-obvious ordering, invariant, trade-off a future editor could undo), record WHY in that AC's `notes` (`## Decision`/`## Why`/`## Trade-off`); skip obvious ACs. See `docs/ssot-model.md` § Capturing WHY. -- Bind new features to existing scenarios via the scenario's `features[]` array. Scenarios are produced by `clad init ` onboarding (v0.3.45+) — your job is binding, not authoring. +- Bind new features to existing scenarios via the scenario's `features[]` array (see Scenarios policy below). - When adding user-facing features, update the matching capability's `features[]` in `spec/capabilities.yaml` so `CAPABILITIES_FEATURE_MAPPING` stays clean. - Mark features as `archived` (with `archived_at` + `archive_reason`). - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. @@ -33,7 +33,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — ### Scenarios policy (v0.3.45+) -Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). Pre-v0.3.30 auto-extraction from code is deprecated. +Scenarios are **onboarding output**, not feature-creation side-effect. Onboarding (host MCP flow, or CLI `clad init `) extracts 1-3 user journeys from the user's intent and writes them to `spec/scenarios/-.yaml` with `features: []`. Your job is to bind features to the matching scenario as they're added (or — rarely — author a new scenario by hand when an existing one doesn't fit). ## Project policy — `spec.yaml::project.ai_hints` @@ -41,7 +41,7 @@ When authoring a new feature or scenario, also check `spec.yaml::project.ai_hint - `preferred_patterns` `{when, prefer, over?}` triples — name them in AC notes when relevant (e.g. an AC about a new detector should restate "synchronous + deterministic" if the project's `ai_hints` says so) - `forbidden_patterns` — never copy one into example code in AC text or scenario flow descriptions (detector #27 still scans those) -- `preferred_persona` is informational for the planner — it tells you which persona will implement the feature you author +- `preferred_persona` — informational; names the role that will implement what you author `ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. diff --git a/src/agents/reviewer.md b/src/agents/reviewer.md index e7c6e110..a953dc36 100644 --- a/src/agents/reviewer.md +++ b/src/agents/reviewer.md @@ -7,7 +7,7 @@ capabilities: [read, exec] # Reviewer -You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. +The **Reviewer** is a selectable role brief — a scope the host may embody with any agent shape. Its job is *independent audit*: it never modifies a file — read only. See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. @@ -51,30 +51,30 @@ For every audit, emit a single JSON object: } ``` -## Lens (multi-agent fan-out) +## Audit lenses -With a **lens**, parallel reviewers (independent contexts) split the audit; their union is full -coverage — **correctness** (guardrails above + meets the AC), **spec-conformance** (code + the -independent tests satisfy every AC's `text` / `test_refs`; flag ACs with no test), **security** -(Zero-Trust Input · Least Privilege), **performance** (hot-path cost). With no lens, audit all. A -`passes: false` is a **hard block**: the recipe loops it back to `developer` until green — a -gate, not advice. +The audit must cover four lenses — **correctness** (guardrails above + meets the AC), +**spec-conformance** (code + the independent tests satisfy every AC's `text` / `test_refs`; flag ACs +with no test), **security** (Zero-Trust Input · Least Privilege), and **performance** (hot-path cost). +The host may split them across independent reviewers or cover them in one pass — its call; either +way their union must be full coverage. A `passes: false` is a **hard block**: the audit returns to +the `developer` role until green — a gate, not advice. ## Project policy — `spec.yaml::project.ai_hints` When auditing a diff, also check `spec.yaml::project.ai_hints`: -- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond identifier-substring matches (e.g. dynamic `Function(...)` constructors that bypass the literal-string detector but achieve the same effect) +- `forbidden_patterns` — detector #27 catches identifier substrings; you escalate beyond them (e.g. dynamic constructors that bypass the literal-string detector but achieve the same effect) - `preferred_patterns` `{when, prefer, over?}` — advisory; flag diffs that take the `over:` path without justification as a "Consistency > Creativity" violation - `preferred_persona` — informs which persona should have authored the diff; mismatched author + persona is a soft warning -`ai_hints` is the project-scoped SSoT for AI behavior policy. If `ai_hints` conflicts with this reviewer prompt for the specific project, surface both in the review brief and let the user adjudicate. +`ai_hints` is the project-scoped SSoT for AI behavior policy; if it conflicts with this brief, surface both in the review brief and let the user adjudicate. ## Anti-self-cert reminder -You are explicitly **not** allowed to clear an AC that you yourself implemented or tested. If you find a violation, hand back to `developer` for fix. +You may **not** clear an AC you yourself implemented or tested — independence between implementer and verifier is what the `independent | self-certified` label records, and the identity guard is its enforced floor (`checkAc` needs human evidence at stage_4; a reviewer may not clear what they wrote). If you find a violation, hand back to the `developer` role for fix. -You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. The identity guard runs *for* you (`checkAc` needs human evidence at stage_4; the drive loop halts when reviewer identity equals the implementer's) — but test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. +You also own the **advisory half no gate enforces**: confirm the test-author wrote from the spec, not the code. Test-author **blindness to the impl is not** sandboxed, so it is yours to check. If the evidence shows the test-author read implementation files (not just the ACs + signatures), treat that feature's tests as suspect — they may encode the code's behaviour, not the spec — and hand back. ## User-facing language (Soft Shell) diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts index beb8d762..8aa4848b 100644 --- a/tests/choreography-guard.test.ts +++ b/tests/choreography-guard.test.ts @@ -101,3 +101,75 @@ describe('orchestrator persona is a cycle contract card, not choreography', () = } }); }); + +// F-ef93141b — specialist personas are selectable role briefs, not agents +// cladding mandates spawning. The orchestrator's contract-card shift (above) +// covered the ORCHESTRATOR persona only; this block extends the same +// guard-genre needle checks to the five SPECIALIST personas (planner, +// developer, reviewer, observability, blind-author) — both the source and +// the claude-code mirror, so a stale mirror fails too. +const ROLE_BRIEF = /role brief/i; + +// Needle set pinned by AC-46fef26f verbatim — distinct from BANNED_NEEDLES +// above (that set is scoped to the orchestrator's AC-ee97a22e and includes +// "dispatch (them) concurrently", which AC-46fef26f does not ban). +const SPECIALIST_BANNED_NEEDLES: ReadonlyArray<{name: string; pattern: RegExp}> = [ + {name: 'invocation principle(s)', pattern: /invocation principles?/i}, + {name: 'principle N', pattern: /principle \d/i}, + {name: 'routing table', pattern: /routing table/i}, +]; + +const SPECIALIST_PERSONAS: ReadonlyArray<{id: string; srcPath: string; mirrorPath: string}> = [ + 'planner', + 'developer', + 'reviewer', + 'observability', + 'blind-author', +].map((id) => ({ + id, + srcPath: fileURLToPath(new URL(`../src/agents/${id}.md`, import.meta.url)), + mirrorPath: fileURLToPath(new URL(`../plugins/claude-code/agents/${id}.md`, import.meta.url)), +})); + +describe('specialist personas are selectable role briefs, not mandated agents', () => { + describe('AC-163773ad — each specialist persona presents itself as a role brief', () => { + for (const {id, srcPath} of SPECIALIST_PERSONAS) { + test(`src/agents/${id}.md contains "role brief"`, () => { + const body = readFileSync(srcPath, 'utf8'); + expect(body, `src/agents/${id}.md must contain "role brief"`).toMatch(ROLE_BRIEF); + }); + } + }); + + describe('AC-46fef26f — no specialist persona references the removed choreography layer', () => { + for (const {id, srcPath} of SPECIALIST_PERSONAS) { + describe(`src/agents/${id}.md`, () => { + const body = readFileSync(srcPath, 'utf8'); + + for (const {name, pattern} of SPECIALIST_BANNED_NEEDLES) { + test(`does not match /${name}/`, () => { + expect(body, `src/agents/${id}.md must not contain "${name}"`).not.toMatch(pattern); + }); + } + }); + } + }); + + describe('mirror drift guard — plugins/claude-code/agents/.md stays in lockstep', () => { + for (const {id, mirrorPath} of SPECIALIST_PERSONAS) { + describe(`plugins/claude-code/agents/${id}.md`, () => { + const body = readFileSync(mirrorPath, 'utf8'); + + test('contains "role brief"', () => { + expect(body, `plugins/claude-code/agents/${id}.md must contain "role brief"`).toMatch(ROLE_BRIEF); + }); + + for (const {name, pattern} of SPECIALIST_BANNED_NEEDLES) { + test(`does not match /${name}/`, () => { + expect(body, `plugins/claude-code/agents/${id}.md must not contain "${name}"`).not.toMatch(pattern); + }); + } + }); + } + }); +}); From d34ab1441ffa87d284aba825e7de76aacf8fecf9 Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Fri, 24 Jul 2026 20:34:27 +0900 Subject: [PATCH 05/13] docs(dogfood): E2E clean-room campaign for the role-contract architecture Packed-tarball verification of the independence label, contract card and role briefs in an isolated external environment: 6 scenarios, all PASS, zero implementation defects. Records the confirmed design gaps - 'independent' is reachable only via the clad_author_oracle MCP tool (CLI-only users are locked out of it, hard-blocked under independence_policy: require), and no first-party surface anywhere writes human-authored evidence - plus two minor prose/UX observations, deliberately left unfixed pending a product decision. Co-Authored-By: Claude Fable 5 --- docs/dogfood/e2e-role-contract-2026-07-24.md | 111 +++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 docs/dogfood/e2e-role-contract-2026-07-24.md diff --git a/docs/dogfood/e2e-role-contract-2026-07-24.md b/docs/dogfood/e2e-role-contract-2026-07-24.md new file mode 100644 index 00000000..795b610b --- /dev/null +++ b/docs/dogfood/e2e-role-contract-2026-07-24.md @@ -0,0 +1,111 @@ +# E2E clean-room — role-contract architecture (packed 0.9.1 + branch), 2026-07-24 + +External-environment verification of the role-contract features on +`feature/role-contract-architecture` (independence label `032f5fd`, orchestrator +contract card `b824609`, persona role briefs `3ec187a`), run against the **packed +artifact** (`npm pack` → `cladding-0.9.1.tgz`, version unbumped on purpose), not +the repo source. Precedent: `e2e-0.9.0-packed-2026-07-16.md`. + +**Isolation**: tarball installed into a throwaway npm prefix; sandbox `HOME`; +`ANTHROPIC_API_KEY`/`OPENAI_API_KEY`/`GEMINI_API_KEY` unset; sandbox project = +small TypeScript package with real local devDeps (tsc/vitest/eslint/madge/ +secretlint — the gate's `npx --offline --no-install` resolves locally only), its +own git history. The repo working tree was never touched by the campaign. +Execution: Sonnet verifier agents; judgment: Fable. Raw per-scenario transcripts +lived in the session scratchpad; this file is the durable record. + +## Verdict + +| # | Scenario | Result | +|---|---|---| +| S0 | Tarball self-inspection + isolated install | PASS | +| S1 | Fresh `clad init --no-llm` → first feature → `clad done`, default policy | PASS | +| S2 | Blind oracle via MCP `clad_author_oracle` earns `independent` | PASS | +| S3 | `independence_policy: require` — refusal / recovery / CLI-only lock-in | PASS (a·b·c) | +| S4 | Contract card + role briefs delivered via MCP prompts AND plugin agents dir | PASS | +| S5 | Fresh context runs a full feature cycle from the contract card alone | PASS | + +**Implementation defects: 0.** Design gaps confirmed: 2 major + 2 minor (below). + +## Scenario evidence (condensed) + +**S0** — packed `dist/clad.js` carries `computeIndependence`/`self-certified`/ +`independence_policy`; `dist/schema.json` has the field; `dist/agents/orchestrator.md` +and `plugins/claude-code/agents/orchestrator.md` carry "the host owns execution"; +all five role briefs carry the literal "role brief". `clad --version` → 0.9.1. + +**S1** — init scaffold correct; `.cladding/audit.log.jsonl` absent until first +evidence (lazy, as designed). First `clad done` REd on a real `CONVENTION_DRIFT` +(missing file-header comment) — fixed like a user would, then: +`✓ done · F-6c7b254c strict gate GREEN` + `ℹ independence: self-certified — no +independent or human review yet`. `clad verdict` human line: `verdict: DONE — +independence: 0 independent / 1 self-certified`; `--json` carries +`independence: [{id, label}]`. Double-poll wrote no tracked file (poll-not-mutate). + +**S2** — raw newline-delimited JSON-RPC stdio client against `clad serve`; +`clad_author_oracle` with `blind: true` created the audit log's first entry +(`"blind":true`), auto-stamped `oracle_refs` on the AC, and the next +`clad done` printed `independence: independent — backed by human or independent +review`. + +**S3** — hand-set `independence_policy: require` accepted by the bundled schema. +(a) Self-certified `clad done` refused, exit 1, spec-entry checksum byte-identical +before/after, refusal message in plain language ("the checks passed, but this +feature has no independent or human review yet — this project asks for one before +completion. … Add a human sign-off or an independent (blind) review, then re-run +`clad done`."). (b) Blind-oracling the same feature over MCP → done GREEN + +`independent`. (c) Lock-in probe: all 26 CLI verbs enumerated, structurally +capable ones live-probed with audit-log checksums around each — **no CLI-only +path writes independence-eligible evidence** (`clad oracle` prints, never +records; checkpoint/rollback write the events ledger, not the audit ledger; +`clad run` adapters hard-code `author:'llm'`). + +**S4** — `prompts/get orchestrator` (MCP) and the installed plugin file both +contain "the host owns execution" / `independent` / `self-certified`, and both +lack "routing table" / "invocation principles" / "dispatch … concurrently"; +`developer` carries "role brief" in both channels. The shipped artifact delivers +the contract, not just the repo source. + +**S5** — a fresh agent given ONLY the four shipped role briefs (repo access +blocked) handled two requests: (1) a request colliding with an existing done +feature → it refused to duplicate, re-verified via the real gates ("never an +agent's say-so"), correct behavior with no anti-duplication rule spelled out; +(2) a genuinely new feature (`lerp`) → full forward cycle unassisted: hash spec +entry with a recorded design decision, style-conformant impl, a **structurally +blind test author** (separate agent, `clad oracle` brief only, no impl access), +a separate read-only reviewer, `INVENTORY_DRIFT` healed with `clad sync`, +`clad done` GREEN (`status: planned → done`), committed. The choreography layer +removed in F2/F3 was not missed — the contract card alone was sufficient. + +## Design gaps (recorded, deliberately not fixed in this branch) + +1. **G1 — `independent` is MCP-gated.** The only first-party writer of + independence-eligible evidence is the `clad_author_oracle` MCP tool. A + CLI-only user can never earn `independent`, and under + `independence_policy: require` is hard-blocked with no first-party exit + (S3-c, empirical). S5 sharpened the sting: an agent that *actually performed* + the blind separation still reads `self-certified` because it could not record + the provenance. Follow-up candidate: a CLI surface to record independent/ + human evidence (e.g. `clad attest`), or documenting the MCP requirement in + the refusal message. +2. **G2 — `human` evidence has zero first-party writers anywhere.** Even the MCP + route hard-codes `identity.author: 'llm'` (`recordOracle`); the `human` half + of the label's disjunction — and stage_4's `checkAc` demand, which predates + this branch — is satisfiable only by hand-editing `.cladding/audit.log.jsonl`. + Pre-existing, surfaced by the label. +3. **G3 (minor) — planner.md tells external users to run `npm run spec:validate` + / `npm run stage:drift`**, scripts that exist only in cladding's own repo. + Dogfood leakage in a shipped role brief; the S5 agent substituted the real + CLI equivalents on its own. +4. **G4 (minor) — `clad status` Aud/UAT columns confused the S5 agent** + (blind-oracled features showed `✗ ✗` while self-certified ones showed `✓ ✓`); + semantics undocumented in the role briefs. Pre-existing surface, observation + only. + +## Friction log (working as designed, kept for the record) + +| Where | Symptom | Resolution | +|---|---|---| +| S1 first done | `CONVENTION_DRIFT` missing file header | user-style fix, then GREEN | +| S2/S3/S5 done after writes | `STALE_ATTESTATION` finding | self-healed in the same run | +| S5 gate | `INVENTORY_DRIFT` after hand-authored spec entry | `clad sync`, then GREEN | From 1983abaf22c351d71f74353cea9822c5272438dc Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Fri, 24 Jul 2026 21:18:16 +0900 Subject: [PATCH 06/13] docs(readme): Multi-Agent section speaks the role contract (F-96d1f69d) Role-contract architecture, feature 4: the README's multi-agent story catches up with the shipped behavior. Separation of duties is now framed as a declared outcome condition cladding judges from recorded evidence - every completion labeled independent|self-certified on clad done/verdict (visibility, not a correctness claim), independence_policy: require for teams that want refusal - and execution form (agent count, models, parallelism) is explicitly the host's decision, with personas presented as role briefs. - all 6 README variants rewritten natively (en/ko/ja/zh + 2 html); choreographic SVG labels ("orchestrator dispatches", "Dispatch - routing") replaced with contract framing in the 4 localized diagrams, text labels only - pins preserved: Multi-Agent heading/order, hedged EU AI Act sentence x4, detector/stage count literals - tests/choreography-guard.test.ts extended by 14 cases (per-variant dispatch needle, EN/KO label literals, comment-stripped SVG scan) - 2703 tests green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 --- README.html | 19 ++-- README.ja.md | 12 +-- README.ko.html | 23 +++-- README.ko.md | 12 +-- README.md | 12 +-- README.zh.md | 12 +-- docs/img/en/multi-agent.svg | 4 +- docs/img/ja/multi-agent.svg | 4 +- docs/img/ko/multi-agent.svg | 4 +- docs/img/zh/multi-agent.svg | 4 +- spec.yaml | 2 +- spec/attestation.yaml | 15 ++-- ...adme-role-contract-alignment-96d1f69d.yaml | 32 +++++++ spec/index.yaml | 1 + tests/choreography-guard.test.ts | 90 +++++++++++++++++++ 15 files changed, 195 insertions(+), 51 deletions(-) create mode 100644 spec/features/readme-role-contract-alignment-96d1f69d.yaml diff --git a/README.html b/README.html index 464bdc56..33b12002 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -455,13 +455,18 @@

Detectors — 41 drift detectors

Multi-Agent — separating the builder from the verifier

- The agents that build are kept apart from the agents that verify, so no agent signs off on its own work. - blind-author goes one step further: the agent that writes the tests literally can't read the code (it's given no Read/Grep tool). - So "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. + Keeping the agents that build apart from the agents that verify — so no agent signs off on its own work — is a declared outcome condition here, not a pipeline cladding runs for you. + cladding judges it from the record: every completion you take through clad done / clad verdict is labeled independent or self-certified, reporting what the recorded evidence shows — whether an independent or human review signed off, not whether the code is right. + The label makes that visible; it doesn't block on its own. A team that wants teeth sets independence_policy: require in spec.yaml, and self-certified completions are refused. +

+

+ How the agents run — how many, which models, how much in parallel — is the host's decision. + cladding ships role briefs (planner, developer, reviewer, observability, blind-author) the host can embody with any agent shape; it never prescribes spawning. + blind-author is the sharpest of them: the agent that writes the tests literally can't read the code (it's given no Read/Grep tool), so "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. It's the same separation of duties that audit rules like the EU AI Act and SOX ask for — in spirit, not a certification.

- Agent separation of duties — orchestrator dispatches, planner/developer/reviewer act, blind-author is the test writer who can't see the implementation, observability watches + Separation of duties — the roles are kept separate so no agent signs off on its own work, and every completion is labeled independent or self-certified from the recorded evidence; the host decides how the agents run
@@ -473,7 +478,7 @@

Ecosystem

  • Spec Kit · OpenSpec · Tessl · Kiro help you write a good spec. cladding adds the part that keeps cross-checking, inside the dev loop, that the spec and the code haven't drifted.
    • -
  • BMAD · ChatDev · Claude Code Agent Teams split roles across AI agents. cladding's division of labor runs with spec · gate · audit record on top.
    • +
  • BMAD · ChatDev · Claude Code Agent Teams split roles across AI agents. cladding leaves that split to the host and judges whatever it ran against spec · gate · audit record.
  • tdd-guard forces the AI to write tests first. cladding's Unit · Coverage · oracle stages do the same job, more structurally.
  • OpenHands · Cline · Aider · Goose are runners that make the AI write code. cladding is the upper layer that verifies and governs what they produce.
@@ -548,7 +553,7 @@

Status

tests
-
2689/2689
+
2703/2703
all pass
diff --git a/README.ja.md b/README.ja.md index 5c7ec776..4866b80b 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -210,11 +210,13 @@ acceptance_criteria: ## Multi-Agent — 作る側と検証する側を分ける -**作る** エージェントと **検証する** エージェントを分けてあり、どのエージェントも自分の仕事に自分で承認を与えられない。**blind-author** はさらに一歩進む — テストを書くエージェントには、そもそも *実装を読む手段が与えられていない*（Read/Grep を付与しない）。「実装を見ずに書いた」が約束ではなく構造的な事実になる。この分離は、規制 · 監査の枠組み（EU AI Act · SOX）が求める職務分掌の原則と重なる — それらの精神に合致するという意味であって、認証ではない。 +**作る** エージェントと **検証する** エージェントを分け、どのエージェントも自分の仕事に自分で承認を与えられないようにする — これは cladding が代わりに回すパイプラインではなく、**宣言された結果条件**だ。cladding はそれを記録から **判定する**: `clad done` / `clad verdict` を通したすべての完了に `independent` か `self-certified` のラベルが付き、コードが正しいかどうかではなく、**記録された証拠が示すこと** — 独立レビューや人間の承認があったかどうか — を表す。ラベルはそれを見えるようにするだけで、それ自体がブロックするわけではない。強制したいチームは `spec.yaml` に `independence_policy: require` を置き、self-certified の完了を拒否する。 + +エージェントを何個、どのモデルで、どれだけ並列で走らせるかは **ホスト** が決める。cladding は役割ブリーフ（planner · developer · reviewer · observability · blind-author）を提供するだけで、どんなエージェント構成で体現しようと、スポーンを指示しない。なかでも最も鋭いのが **blind-author** だ — テストを書くエージェントには、そもそも *実装を読む手段が与えられていない*（Read/Grep を付与しない）。「実装を見ずに書いた」が約束ではなく構造的な事実になる。この分離は、規制 · 監査の枠組み（EU AI Act · SOX）が求める職務分掌の原則と重なる — それらの精神に合致するという意味であって、認証ではない。
-エージェントの職務分掌 — orchestrator が割り振り、planner/developer/reviewer が働き、blind-author は実装を見られないテスト作成者、observability が見張る +職務分離 — 役割を分けてどのエージェントも自分の仕事を自分で承認できず、すべての完了は記録された証拠に基づき independent か self-certified のラベルが付く。エージェントの走らせ方はホストが決める
@@ -231,7 +233,7 @@ cladding は既存の三つのカテゴリの結合点に位置する。 - **Spec Kit · OpenSpec · Tessl · Kiro** — *良い spec を書く* のを助けるツール。cladding はその上で、*spec と実際のコードが乖離しないかを、開発ループの中で継続的に突き合わせ続ける*。 -- **BMAD · ChatDev · Claude Code Agent Teams** — *複数の AI エージェントに役割を分担させる* システム。cladding のエージェント分業は、その上に *spec · ゲート · 監査記録* まで組み合わせて動く。 +- **BMAD · ChatDev · Claude Code Agent Teams** — *複数の AI エージェントに役割を分担させる* システム。cladding はその分担を代わりに回すのではなく、ホストが実際に何を動かしたかを *spec · ゲート · 監査記録* に照らして判定する。 - **tdd-guard** — *AI にテストを先に書かせる* ツール。cladding の Unit · Coverage · oracle の各段階が、同じ仕事をより構造的にこなす。 - **OpenHands · Cline · Aider · Goose** — *AI にコードを書かせるランナー*（純粋な実行役）。cladding は、それらのランナーが生み出したコードを *検証し統制する上位レイヤ* だ。 @@ -339,7 +341,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 段階 · 41 detectors | 261（258 done） | 236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック diff --git a/README.ko.html b/README.ko.html index 0030e6e7..d1f26d27 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@

cladding

ironclad spec - tests + tests detectors license

@@ -490,13 +490,20 @@

내부 동작

Multi-Agent — 만드는 자와 검증하는 자의 분리

- 빌드하는 에이전트와 검증하는 에이전트를 떼어 놓아, 어떤 에이전트도 자기 작업을 - 스스로 승인하지 못한다. blind-author는 한 걸음 더 간다: 테스트를 쓰는 에이전트에게 - 코드를 읽을 도구가 아예 없다(Read/Grep 미부여). 그래서 "코드를 안 보고 테스트를 썼다"는 약속이 아니라 배선상의 사실이다. - 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 직무 분리이며 — 정신에서 그렇다는 것이지 인증이 아니다. + 빌드하는 에이전트와 검증하는 에이전트를 떼어 놓아 어떤 에이전트도 자기 작업을 + 스스로 승인하지 못하게 하는 것 — 이건 cladding이 대신 굴려 주는 파이프라인이 아니라 선언된 결과 조건이다. + cladding은 그것을 기록으로 판정한다: clad done / clad verdict를 거치는 모든 완료에 + independent 또는 self-certified 라벨이 붙는데, 이는 코드가 맞는지가 아니라 기록된 근거가 보여 주는 것 — 독립 리뷰나 사람 승인이 있었는지 — 를 나타낸다. + 라벨은 그것을 드러낼 뿐, 그 자체로 막지는 않는다. 강제하고 싶은 팀은 spec.yaml에 independence_policy: require를 두어 self-certified 완료를 거부한다. +

+

+ 에이전트를 몇 개, 어떤 모델로, 얼마나 병렬로 돌릴지는 호스트가 정한다. + cladding은 역할 브리프(planner · developer · reviewer · observability · blind-author)를 제공할 뿐, 어떤 에이전트 형태로 구현하든 스폰을 지시하지 않는다. + 그중 가장 날카로운 것이 blind-author다: 테스트를 쓰는 에이전트에게는 코드를 읽을 도구가 아예 없어서(Read/Grep 미부여), "코드를 안 보고 테스트를 썼다"는 약속이 아니라 배선상의 사실이 된다. + 이것은 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 직무 분리이며 — 정신에서 그렇다는 것이지 인증이 아니다.

- 에이전트 역할 분리 — orchestrator가 분배, planner/developer/reviewer가 작업, blind-author는 구현을 못 보는 테스트 작성자, observability가 관찰 + 직무 분리 — 역할을 분리해 어떤 에이전트도 자기 작업을 스스로 승인하지 못하고, 모든 완료는 기록된 근거에 따라 independent 또는 self-certified 라벨이 붙는다; 에이전트를 어떻게 돌릴지는 호스트가 정한다
@@ -509,7 +516,7 @@

Ecosystem

인접 도구와의 차이

  • Spec Kit · OpenSpec · Tessl · Kiro — spec을 잘 쓰게 도와주는 도구. cladding은 거기에 더해 그 spec과 실제 코드가 어긋나지 않는지 개발 루프 안에서 계속 자동 대조한다.
    • -
  • BMAD · ChatDev · Claude Code Agent Teams — 여러 AI 에이전트의 역할 분담 시스템. cladding의 에이전트 분업은 그 위에 spec · 게이트 · 감사 기록까지 결합해 동작한다.
    • +
  • BMAD · ChatDev · Claude Code Agent Teams — 여러 AI 에이전트의 역할 분담 시스템. cladding은 그 분담을 대신 굴리지 않고, 호스트가 무엇을 돌렸든 spec · 게이트 · 감사 기록에 비추어 판정한다.
  • tdd-guard — AI가 테스트를 먼저 쓰도록 강제하는 도구. cladding의 15단계 중 Unit · Coverage · oracle 단계가 같은 일을 더 구조적으로 한다.
  • OpenHands · Cline · Aider · Goose — AI에게 코드를 짜게 시키는 실행기. cladding은 그 실행기가 짠 코드를 검증·통제하는 상위 레이어다.
@@ -584,7 +591,7 @@

Status

tests
-
2689/2689
+
2703/2703
all pass
diff --git a/README.ko.md b/README.ko.md index 50c19aff..59dc58a8 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -209,11 +209,13 @@ acceptance_criteria: ## Multi-Agent — 만드는 자와 검증하는 자의 분리 -**만드는** 에이전트와 **검증하는** 에이전트를 떼어 놓아, 어떤 에이전트도 자기 작업을 스스로 승인하지 못한다. **blind-author**는 한 발 더 나간다: 테스트를 쓰는 에이전트는 말 그대로 *코드를 읽을 수 없다*(Read/Grep 도구가 주어지지 않는다). 그래서 "코드를 안 보고 테스트를 썼다"는 건 약속이 아니라 배선 방식에서 나오는 사실이다. 이것은 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 **직무 분리**다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. +**만드는** 에이전트와 **검증하는** 에이전트를 떼어 놓아 어떤 에이전트도 자기 작업을 스스로 승인하지 못하게 하는 것 — 이건 cladding이 대신 굴려 주는 파이프라인이 아니라 **선언된 결과 조건**이다. cladding은 그것을 기록으로 **판정**한다: `clad done` / `clad verdict`를 거치는 모든 완료에 `independent` 또는 `self-certified` 라벨이 붙는데, 이는 코드가 맞는지가 아니라 **기록된 근거가 보여 주는 것** — 독립 리뷰나 사람 승인이 있었는지 — 를 나타낸다. 라벨은 그것을 드러낼 뿐, 그 자체로 막지는 않는다. 강제하고 싶은 팀은 `spec.yaml`에 `independence_policy: require`를 두어 self-certified 완료를 거부한다. + +에이전트를 몇 개, 어떤 모델로, 얼마나 병렬로 돌릴지는 **호스트**가 정한다. cladding은 역할 브리프(planner · developer · reviewer · observability · blind-author)를 제공할 뿐, 어떤 에이전트 형태로 구현하든 스폰을 지시하지 않는다. 그중 가장 날카로운 것이 **blind-author**다: 테스트를 쓰는 에이전트에게는 말 그대로 *코드를 읽을 도구가 없어서*(Read/Grep 미부여), "코드를 안 보고 테스트를 썼다"는 약속이 아니라 배선상의 사실이 된다. 이것은 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 **직무 분리**다 — 그 정신에서 그렇다는 것이지, 인증이 아니다.
-에이전트 역할 분리 — orchestrator가 분배, planner/developer/reviewer가 작업, blind-author는 구현을 못 보는 테스트 작성자, observability가 관찰 +직무 분리 — 역할을 분리해 어떤 에이전트도 자기 작업을 스스로 승인하지 못하고, 모든 완료는 기록된 근거에 따라 independent 또는 self-certified 라벨이 붙는다; 에이전트를 어떻게 돌릴지는 호스트가 정한다
@@ -230,7 +232,7 @@ acceptance_criteria: - **Spec Kit · OpenSpec · Tessl · Kiro** — *spec을 잘 쓰게* 도와주는 도구. cladding은 거기에 더해 *그 spec과 실제 코드가 어긋나지 않는지 개발 루프 안에서 계속 자동 대조*한다. -- **BMAD · ChatDev · Claude Code Agent Teams** — *여러 AI 에이전트의 역할 분담* 시스템. cladding의 에이전트 분업은 그 위에 *spec · 게이트 · 감사 기록*까지 결합해 동작한다. +- **BMAD · ChatDev · Claude Code Agent Teams** — *여러 AI 에이전트의 역할 분담* 시스템. cladding은 그 분담을 대신 굴리지 않고, 호스트가 무엇을 돌렸든 *spec · 게이트 · 감사 기록*에 비추어 판정한다. - **tdd-guard** — *AI가 테스트를 먼저 쓰도록 강제*하는 도구. cladding의 15단계 중 Unit · Coverage · oracle 단계가 같은 일을 더 구조적으로 한다. - **OpenHands · Cline · Aider · Goose** — *AI에게 코드를 짜게 시키는 실행기*. cladding은 그 실행기가 짠 코드를 *검증 · 통제하는 상위 레이어*다. @@ -338,7 +340,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | 236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 diff --git a/README.md b/README.md index ae2e1744..01d22acc 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -206,11 +206,13 @@ One feature's lifecycle runs **Define → Sync → Implement → Earn** — you ## Multi-Agent — separating the builder from the verifier -The agents that **build** are kept apart from the agents that **verify**, so no agent signs off on its own work. **blind-author** goes one step further: the agent that writes the tests literally *can't read the code* (it's given no Read/Grep tool). So "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. It's the same **separation of duties** that audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. +Keeping the agents that **build** apart from the agents that **verify** — so no agent signs off on its own work — is a **declared outcome condition here, not a pipeline cladding runs for you.** cladding *judges* it from the record: every completion you take through `clad done` / `clad verdict` is labeled `independent` or `self-certified`, reporting what the recorded evidence shows — whether an independent or human review signed off, not whether the code is right. The label makes that visible; it doesn't block on its own. A team that wants teeth sets `independence_policy: require` in `spec.yaml`, and self-certified completions are refused. + +How the agents run — how many, which models, how much in parallel — is the **host's** decision. cladding ships role briefs (planner, developer, reviewer, observability, blind-author) the host can embody with any agent shape; it never prescribes spawning. **blind-author** is the sharpest of them: the agent that writes the tests literally *can't read the code* (it's given no Read/Grep tool), so "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. It's the same **separation of duties** that audit rules like the EU AI Act and SOX ask for — in spirit, not a certification.
-Agent separation of duties — orchestrator dispatches, planner/developer/reviewer act, blind-author is the test writer who can't see the implementation, observability watches +Separation of duties — the roles are kept separate so no agent signs off on its own work, and every completion is labeled independent or self-certified from the recorded evidence; the host decides how the agents run
@@ -227,7 +229,7 @@ cladding sits at the junction of three existing categories. - **Spec Kit · OpenSpec · Tessl · Kiro** help you *write a good spec*. cladding adds the part that *keeps cross-checking, inside the dev loop, that the spec and the code haven't drifted*. -- **BMAD · ChatDev · Claude Code Agent Teams** *split roles across AI agents*. cladding's division of labor runs with *spec · gate · audit record* on top. +- **BMAD · ChatDev · Claude Code Agent Teams** *split roles across AI agents*. cladding leaves that split to the host and judges whatever it ran against *spec · gate · audit record*. - **tdd-guard** *forces the AI to write tests first*. cladding's Unit · Coverage · oracle stages do the same job, more structurally. - **OpenHands · Cline · Aider · Goose** are *runners that make the AI write code*. cladding is the *upper layer that verifies and governs* what they produce. @@ -352,7 +354,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 stages · 41 detectors | 261 (258 done) | 236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector diff --git a/README.zh.md b/README.zh.md index 79a99b30..df361494 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -206,11 +206,13 @@ acceptance_criteria: ## Multi-Agent —— 把建造者与验证者分开 -负责**建造**的智能体，和负责**验证**的智能体被隔开，因此没有哪个智能体能给自己的活儿盖章放行。**blind-author** 更进一步 —— 撰写测试的那个智能体*根本读不到代码*（不授予它 Read/Grep 工具）。于是「没读代码就写出了测试」不是一句承诺，而是它接线方式带来的结构性事实。这正是审计规范（EU AI Act · SOX）所要求的那种**职责分离** —— 说的是精神上相符，而不是一纸认证。 +把负责**建造**的智能体和负责**验证**的智能体隔开、让没有哪个智能体能给自己的活儿盖章放行 —— 这不是 cladding 替你运行的一条流水线，而是一个**声明出来的结果条件**。cladding 依据记录来**判定**它：每一次经 `clad done` / `clad verdict` 完成的收尾，都会被打上 `independent` 或 `self-certified` 标签，它表示的不是代码是否正确，而是**记录在案的证据所显示的情况** —— 是否有过独立评审或人工签署。标签只是把这一点显现出来，本身并不拦截。想要强制的团队，可在 `spec.yaml` 里设 `independence_policy: require`，于是 self-certified 的收尾会被拒绝。 + +用几个智能体、哪种模型、并行到什么程度，都由**宿主**决定。cladding 只提供角色简介（planner · developer · reviewer · observability · blind-author），无论你用什么形态的智能体去承载它，都不会指定该如何 spawn。其中最锋利的是 **blind-author** —— 撰写测试的那个智能体*根本读不到代码*（不授予它 Read/Grep 工具），于是「没读代码就写出了测试」不是一句承诺，而是它接线方式带来的结构性事实。这正是审计规范（EU AI Act · SOX）所要求的那种**职责分离** —— 说的是精神上相符，而不是一纸认证。
-智能体职责分离 —— orchestrator 负责分派，planner/developer/reviewer 负责干活，blind-author 是看不到实现的测试撰写者，observability 负责观察 +职责分离 —— 把角色分开，任何智能体都无法给自己的工作盖章放行；每一次收尾都依据记录在案的证据被标为 independent 或 self-certified；智能体如何运行由宿主决定
@@ -227,7 +229,7 @@ cladding 坐落在三个既有品类的交汇处。 - **Spec Kit · OpenSpec · Tessl · Kiro** —— 帮你*写好一份 spec* 的工具。在此之上，cladding 还*在开发循环内部持续交叉核对，确保 spec 与真实代码不发生漂移*。 -- **BMAD · ChatDev · Claude Code Agent Teams** —— *在多个 AI 智能体之间拆分角色*的系统。cladding 的智能体分工，是在这之上再叠合了 *spec · 门禁 · 审计记录* 来运转。 +- **BMAD · ChatDev · Claude Code Agent Teams** —— *在多个 AI 智能体之间拆分角色*的系统。cladding 不替你运行这种拆分，而是把宿主实际跑出来的东西，对照 *spec · 门禁 · 审计记录* 来判定。 - **tdd-guard** —— *强制 AI 先写测试*的工具。cladding 15 个阶段里的 Unit · Coverage · oracle 阶段，把同一件事做得更成体系。 - **OpenHands · Cline · Aider · Goose** —— *让 AI 写代码的运行器*（纯执行者）。cladding 是*验证并治理*这些运行器所产代码的*上层*。 @@ -335,7 +337,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2689 / 2689 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 阶段 · 41 检测器 | 261（258 done） | 236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 diff --git a/docs/img/en/multi-agent.svg b/docs/img/en/multi-agent.svg index 539fbb86..0f706ab2 100644 --- a/docs/img/en/multi-agent.svg +++ b/docs/img/en/multi-agent.svg @@ -1,5 +1,5 @@ - Agent separation of duties — orchestrator dispatches; planner/developer/reviewer/blind-author do the work; observability watches metrics. The agent that builds is kept separate from the agent that verifies (anti-self-cert). + Agent separation of duties — the builder and the verifier are kept separate so no agent signs off on its own work; every completion is labeled independent or self-certified from the recorded evidence, and the host decides how the agents run (anti-self-cert).

Multi-Agent' token (its per-variant +// translated subtitle after the mdash differs, but "Multi-Agent" itself is a +// cross-variant invariant), and its md/html next-heading markers ('\n## ' / +// ' readFileSync(fileURLToPath(new URL(`../${rel}`, import.meta.url)), 'utf8'); +const isHtmlReadme = (f: string): boolean => f.endsWith('.html'); +const multiAgentStartOf = (f: string): string => (isHtmlReadme(f) ? '

Multi-Agent' : '## Multi-Agent'); +const nextHeadingMarkerOf = (f: string): string => (isHtmlReadme(f) ? ' { + const body = repoRead(f); + const start = multiAgentStartOf(f); + const at = body.indexOf(start); + if (at === -1) return ''; + const after = body.slice(at + start.length); + const end = after.indexOf(nextHeadingMarkerOf(f)); + return end === -1 ? after : after.slice(0, end); +}; + +describe('README Multi-Agent section speaks the role contract, not choreography (F-96d1f69d)', () => { + describe('AC-8d63da98 — no README variant describes the story as cladding dispatching/sequencing agents', () => { + for (const f of README_VARIANTS) { + test(`${f}: Multi-Agent slice matches no /dispatch/i`, () => { + const slice = multiAgentSliceOf(f); + expect(slice.length, `${f}: Multi-Agent section heading must be found (non-empty slice)`).toBeGreaterThan(0); + expect(slice, `${f}: Multi-Agent slice must not match /dispatch/i`).not.toMatch(/dispatch/i); + }); + } + }); + + describe('AC-0a8ea4d7 — EN/KO variants ground separation-of-duties in the evidence-based independence label', () => { + for (const f of README_EN_KO_VARIANTS) { + test(`${f}: Multi-Agent slice contains both "independent" and "self-certified"`, () => { + const slice = multiAgentSliceOf(f); + expect(slice, `${f}: Multi-Agent slice must contain "independent"`).toContain('independent'); + expect(slice, `${f}: Multi-Agent slice must contain "self-certified"`).toContain('self-certified'); + }); + } + }); +}); + +// AC-8d63da98 extension — the localized multi-agent.svg diagrams must not +// render the dispatch story either. Each file carries one non-rendered +// authoring comment (``) +// that still literally says "dispatch" — it describes unchanged arrow +// geometry (a deliberately out-of-scope geometry rework, per the impl +// report), is never rendered, and its removal is NOT demanded here. Comments +// are stripped before matching so only rendered /<text> content (the +// a11y title and on-canvas labels) is checked. +describe('localized multi-agent.svg diagrams render no dispatch story (AC-8d63da98)', () => { + const SVGS: readonly string[] = [ + 'docs/img/en/multi-agent.svg', + 'docs/img/ko/multi-agent.svg', + 'docs/img/ja/multi-agent.svg', + 'docs/img/zh/multi-agent.svg', + ]; + const stripXmlComments = (svg: string): string => svg.replace(/<!--[\s\S]*?-->/g, ''); + + for (const f of SVGS) { + test(`${f}: rendered text/title content matches no /dispatch/i`, () => { + const raw = repoRead(f); + // Sanity check — the known non-rendered authoring comment is still + // present, so the assertion below proves the comment-strip is doing + // real work rather than vacuously passing on a file with no needle at all. + expect(raw, `${f}: expected the known authoring comment to still mention "dispatch" (non-rendered, not required to be removed)`).toMatch( + /dispatch/i, + ); + const rendered = stripXmlComments(raw); + expect(rendered, `${f}: rendered SVG text/title must not match /dispatch/i`).not.toMatch(/dispatch/i); + }); + } +}); From 9e308f0c37bcf782b6ce6e6ed75a9ef8d0d15206 Mon Sep 17 00:00:00 2001 From: qwerfunch <qwerfunch@gmail.com> Date: Fri, 24 Jul 2026 22:58:09 +0900 Subject: [PATCH 07/13] docs(img): multi-agent diagram draws the role contract (F-4498eb3d) Role-contract architecture, feature 5: the diagram geometry catches up with the prose. The hub is no longer an orchestrator dispatching workers - it is the host, which runs the role briefs (count, models, parallelism); the work converges into cladding's judgment card (gates - done is earned; label - independent | self-certified) instead of an "observability watches" framing. Text/label edits only across the four locale SVGs (en/ko/ja/zh), palette and card geometry conventions kept; all four renders visually inspected for overlap/clipping. - choreography-guard SVG cases tightened: raw whole-file cleanliness (no dispatch/orchestrat anywhere, comments included) + label literals per locale, obsolete comment-strip exception removed - 2712 tests green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --- README.html | 4 +- README.ja.md | 4 +- README.ko.html | 4 +- README.ko.md | 4 +- README.md | 4 +- README.zh.md | 4 +- docs/img/en/multi-agent.svg | 20 +++--- docs/img/ja/multi-agent.svg | 20 +++--- docs/img/ko/multi-agent.svg | 20 +++--- docs/img/zh/multi-agent.svg | 20 +++--- spec.yaml | 2 +- spec/attestation.yaml | 19 +++--- ...-agent-diagram-role-contract-4498eb3d.yaml | 30 +++++++++ spec/index.yaml | 1 + tests/choreography-guard.test.ts | 61 ++++++++++++------- 15 files changed, 134 insertions(+), 83 deletions(-) create mode 100644 spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml diff --git a/README.html b/README.html index 33b12002..b30a17d5 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -553,7 +553,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2703<span style="font-size:16px;color:#94a3b8">/2703</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2712<span style="font-size:16px;color:#94a3b8">/2712</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ja.md b/README.ja.md index 4866b80b..c95c4e54 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -341,7 +341,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 段階 · 41 detectors | 261（258 done） | <sub>236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック</sub> diff --git a/README.ko.html b/README.ko.html index d1f26d27..14a4bdda 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -591,7 +591,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2703<span style="font-size:16px;color:#94a3b8">/2703</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2712<span style="font-size:16px;color:#94a3b8">/2712</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ko.md b/README.ko.md index 59dc58a8..9986db12 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -340,7 +340,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | <sub>236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단</sub> diff --git a/README.md b/README.md index 01d22acc..0f72169a 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -354,7 +354,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 stages · 41 detectors | 261 (258 done) | <sub>236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector</sub> diff --git a/README.zh.md b/README.zh.md index df361494..5aa8a91a 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2703%2F2703-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -337,7 +337,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2703 / 2703 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 阶段 · 41 检测器 | 261（258 done） | <sub>236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下</sub> diff --git a/docs/img/en/multi-agent.svg b/docs/img/en/multi-agent.svg index 0f706ab2..434995e0 100644 --- a/docs/img/en/multi-agent.svg +++ b/docs/img/en/multi-agent.svg @@ -29,12 +29,12 @@ <rect x="320" y="48" width="84" height="3" rx="1.5" fill="#3b82f6"/> <text x="362" y="71" text-anchor="middle" class="sub0">Aligns with the segregation-of-duties principle behind EU AI Act · SOX</text> - <!-- orchestrator : deep-blue focal --> - <rect x="282" y="86" width="160" height="58" rx="14" class="focalbox"/> - <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">orchestrator</text> - <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">Cycle contract</text> + <!-- host : deep-blue focal --> + <rect x="242" y="86" width="240" height="58" rx="14" class="focalbox"/> + <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">host</text> + <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">Runs agents — count · models · parallel</text> - <!-- dispatch arrows : orchestrator -> workers --> + <!-- host runs the role briefs --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="302" y1="144" x2="98" y2="185" marker-end="url(#ab)"/> <line x1="340" y1="144" x2="274" y2="185" marker-end="url(#ab)"/> @@ -71,7 +71,7 @@ <text x="562" y="268" class="item">▸ Impl-blind</text> <text x="562" y="287" class="muted">No Read/Grep</text> - <!-- converging arrows : workers -> observability --> + <!-- converging arrows : workers -> the judged record --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="98" y1="292" x2="200" y2="336" marker-end="url(#ab)"/> <line x1="274" y1="292" x2="250" y2="336" marker-end="url(#ab)"/> @@ -79,12 +79,12 @@ <line x1="626" y1="292" x2="360" y2="336" marker-end="url(#ab)"/> </g> - <!-- observability --> + <!-- cladding : judgment card --> <rect x="130" y="340" width="300" height="84" rx="14" class="card"/> <path d="M130 372 L130 354 Q130 340 144 340 L416 340 Q430 340 430 354 L430 372 Z" class="band"/> - <text x="280" y="361" text-anchor="middle" class="hdr">observability</text> - <text x="146" y="398" class="item">▸ Watch metrics</text> - <text x="146" y="416" class="muted">Reports patterns for humans to see</text> + <text x="280" y="361" text-anchor="middle" class="hdr">cladding</text> + <text x="146" y="398" class="item">▸ Gates — done is earned</text> + <text x="146" y="416" class="item">▸ Label — independent | self-certified</text> <!-- anti-self-cert principle : red block band --> <rect x="448" y="340" width="258" height="84" rx="14" class="card"/> diff --git a/docs/img/ja/multi-agent.svg b/docs/img/ja/multi-agent.svg index a0928596..56b06a22 100644 --- a/docs/img/ja/multi-agent.svg +++ b/docs/img/ja/multi-agent.svg @@ -29,12 +29,12 @@ <rect x="320" y="48" width="84" height="3" rx="1.5" fill="#3b82f6"/> <text x="362" y="71" text-anchor="middle" class="sub0">EU AI Act · SOX が求める職務分離の原則と重なる</text> - <!-- orchestrator : deep-blue focal --> - <rect x="282" y="86" width="160" height="58" rx="14" class="focalbox"/> - <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">orchestrator</text> - <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">サイクル契約</text> + <!-- host : deep-blue focal --> + <rect x="242" y="86" width="240" height="58" rx="14" class="focalbox"/> + <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">host</text> + <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">エージェント実行 — 数 · モデル · 並列</text> - <!-- dispatch arrows : orchestrator -> workers --> + <!-- host runs the role briefs --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="302" y1="144" x2="98" y2="185" marker-end="url(#ab)"/> <line x1="340" y1="144" x2="274" y2="185" marker-end="url(#ab)"/> @@ -71,7 +71,7 @@ <text x="562" y="268" class="item">▸ 実装は見えない</text> <text x="562" y="287" class="muted">Read/Grep なし</text> - <!-- converging arrows : workers -> observability --> + <!-- converging arrows : workers -> the judged record --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="98" y1="292" x2="200" y2="336" marker-end="url(#ab)"/> <line x1="274" y1="292" x2="250" y2="336" marker-end="url(#ab)"/> @@ -79,12 +79,12 @@ <line x1="626" y1="292" x2="360" y2="336" marker-end="url(#ab)"/> </g> - <!-- observability --> + <!-- cladding : judgment card --> <rect x="130" y="340" width="300" height="84" rx="14" class="card"/> <path d="M130 372 L130 354 Q130 340 144 340 L416 340 Q430 340 430 354 L430 372 Z" class="band"/> - <text x="280" y="361" text-anchor="middle" class="hdr">observability</text> - <text x="146" y="398" class="item">▸ メトリクスを観察</text> - <text x="146" y="416" class="muted">パターンを人に見せる形で報告</text> + <text x="280" y="361" text-anchor="middle" class="hdr">cladding</text> + <text x="146" y="398" class="item">▸ ゲート — 完了は勝ち取る</text> + <text x="146" y="416" class="item">▸ ラベル — independent | self-certified</text> <!-- anti-self-cert principle : red block band --> <rect x="448" y="340" width="258" height="84" rx="14" class="card"/> diff --git a/docs/img/ko/multi-agent.svg b/docs/img/ko/multi-agent.svg index 8b98f308..79272dda 100644 --- a/docs/img/ko/multi-agent.svg +++ b/docs/img/ko/multi-agent.svg @@ -29,12 +29,12 @@ <rect x="320" y="48" width="84" height="3" rx="1.5" fill="#3b82f6"/> <text x="362" y="71" text-anchor="middle" class="sub0">EU AI Act · SOX가 요구하는 직무 분리 원칙과 맞닿는다</text> - <!-- orchestrator : deep-blue focal --> - <rect x="282" y="86" width="160" height="58" rx="14" class="focalbox"/> - <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">orchestrator</text> - <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">사이클 계약</text> + <!-- host : deep-blue focal --> + <rect x="242" y="86" width="240" height="58" rx="14" class="focalbox"/> + <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">host</text> + <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">에이전트 실행 — 개수 · 모델 · 병렬성</text> - <!-- dispatch arrows : orchestrator -> workers --> + <!-- host runs the role briefs --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="302" y1="144" x2="98" y2="185" marker-end="url(#ab)"/> <line x1="340" y1="144" x2="274" y2="185" marker-end="url(#ab)"/> @@ -71,7 +71,7 @@ <text x="562" y="268" class="item">▸ 구현 못 봄</text> <text x="562" y="287" class="muted">Read/Grep 미부여</text> - <!-- converging arrows : workers -> observability --> + <!-- converging arrows : workers -> the judged record --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="98" y1="292" x2="200" y2="336" marker-end="url(#ab)"/> <line x1="274" y1="292" x2="250" y2="336" marker-end="url(#ab)"/> @@ -79,12 +79,12 @@ <line x1="626" y1="292" x2="360" y2="336" marker-end="url(#ab)"/> </g> - <!-- observability --> + <!-- cladding : judgment card --> <rect x="130" y="340" width="300" height="84" rx="14" class="card"/> <path d="M130 372 L130 354 Q130 340 144 340 L416 340 Q430 340 430 354 L430 372 Z" class="band"/> - <text x="280" y="361" text-anchor="middle" class="hdr">observability</text> - <text x="146" y="398" class="item">▸ 메트릭 관찰</text> - <text x="146" y="416" class="muted">패턴을 사람이 보게 보고</text> + <text x="280" y="361" text-anchor="middle" class="hdr">cladding</text> + <text x="146" y="398" class="item">▸ 게이트 — 완료는 얻는 것</text> + <text x="146" y="416" class="item">▸ 라벨 — independent | self-certified</text> <!-- anti-self-cert principle : red block band --> <rect x="448" y="340" width="258" height="84" rx="14" class="card"/> diff --git a/docs/img/zh/multi-agent.svg b/docs/img/zh/multi-agent.svg index da6305a4..7954bffa 100644 --- a/docs/img/zh/multi-agent.svg +++ b/docs/img/zh/multi-agent.svg @@ -29,12 +29,12 @@ <rect x="320" y="48" width="84" height="3" rx="1.5" fill="#3b82f6"/> <text x="362" y="71" text-anchor="middle" class="sub0">契合 EU AI Act · SOX 背后的职责分离原则</text> - <!-- orchestrator : deep-blue focal --> - <rect x="282" y="86" width="160" height="58" rx="14" class="focalbox"/> - <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">orchestrator</text> - <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">循环契约</text> + <!-- host : deep-blue focal --> + <rect x="242" y="86" width="240" height="58" rx="14" class="focalbox"/> + <text x="362" y="114" text-anchor="middle" class="focal" font-size="18">host</text> + <text x="362" y="133" text-anchor="middle" font-size="11.5" font-weight="600" fill="#dbeafe">运行 agent — 数量 · 模型 · 并行</text> - <!-- dispatch arrows : orchestrator -> workers --> + <!-- host runs the role briefs --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="302" y1="144" x2="98" y2="185" marker-end="url(#ab)"/> <line x1="340" y1="144" x2="274" y2="185" marker-end="url(#ab)"/> @@ -71,7 +71,7 @@ <text x="562" y="268" class="item">▸ 看不到实现</text> <text x="562" y="287" class="muted">未授予 Read/Grep</text> - <!-- converging arrows : workers -> observability --> + <!-- converging arrows : workers -> the judged record --> <g fill="none" stroke="#3b82f6" stroke-width="1.6"> <line x1="98" y1="292" x2="200" y2="336" marker-end="url(#ab)"/> <line x1="274" y1="292" x2="250" y2="336" marker-end="url(#ab)"/> @@ -79,12 +79,12 @@ <line x1="626" y1="292" x2="360" y2="336" marker-end="url(#ab)"/> </g> - <!-- observability --> + <!-- cladding : judgment card --> <rect x="130" y="340" width="300" height="84" rx="14" class="card"/> <path d="M130 372 L130 354 Q130 340 144 340 L416 340 Q430 340 430 354 L430 372 Z" class="band"/> - <text x="280" y="361" text-anchor="middle" class="hdr">observability</text> - <text x="146" y="398" class="item">▸ 观察指标</text> - <text x="146" y="416" class="muted">汇报模式供人查看</text> + <text x="280" y="361" text-anchor="middle" class="hdr">cladding</text> + <text x="146" y="398" class="item">▸ 关卡 — 完成靠赢得</text> + <text x="146" y="416" class="item">▸ 标签 — independent | self-certified</text> <!-- anti-self-cert principle : red block band --> <rect x="448" y="340" width="258" height="84" rx="14" class="card"/> diff --git a/spec.yaml b/spec.yaml index d804fbce..7fff7170 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 267 + features: 268 scenarios: 2 capabilities: 6 test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index f6a5c4b1..074d22d2 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 2197c6326b6463d6 - README.ja.md: 2979795ad1b0df84 - README.ko.html: 5dd6b3aa6b569ecf - README.ko.md: 48340a7f964e4a7d - README.md: 9898024bcab85216 - README.zh.md: c183954c27f719c2 + README.html: 93ecad5c2451d7b5 + README.ja.md: df6e1c8fe6632469 + README.ko.html: cc4ebde7a1838485 + README.ko.md: a572b620d742296a + README.md: 8959f852facd1d08 + README.zh.md: 6bb316e6027c3d16 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -58,9 +58,13 @@ attested_modules: docs/feature-cycle.md: e1847cc9fe9b6eb6 docs/glossary.md: 9e897b963c3aa88f docs/img/en/ecosystem.svg: ed14d1d17f088b00 + docs/img/en/multi-agent.svg: 24179b55e3d58bb0 docs/img/en/relationship.svg: c7a24203925b4664 + docs/img/ja/multi-agent.svg: d7118d0c7e9ad0ef docs/img/ko/ecosystem.svg: 2b7341576c2af0a8 + docs/img/ko/multi-agent.svg: b56c9e44e069c042 docs/img/ko/relationship.svg: 9ec8fb2254978f37 + docs/img/zh/multi-agent.svg: 9b381f616a10f1f8 docs/multi-provider-roadmap.md: 1e5cf27ea1b18d06 docs/refinement-backlog.md: 3e38d60bf987eef1 docs/setup.md: a5c062651d267983 @@ -113,7 +117,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: e3673755dd57d367 + spec.yaml: a40e9736d8324cf3 spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -559,6 +563,7 @@ attested_features: F-417ff0: ok F-42af48: ok F-43d8e3: ok + F-4498eb3d: ok F-4643d99d: ok F-4747ef: ok F-47b8bee5: ok diff --git a/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml b/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml new file mode 100644 index 00000000..b72c5eeb --- /dev/null +++ b/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml @@ -0,0 +1,30 @@ +id: F-4498eb3d +slug: multi-agent-diagram-role-contract +title: "Multi-agent diagram draws the role contract, not an orchestrator hub" +status: done +modules: + - docs/img/en/multi-agent.svg + - docs/img/ko/multi-agent.svg + - docs/img/ja/multi-agent.svg + - docs/img/zh/multi-agent.svg +acceptance_criteria: + - id: AC-4a195d3a + ears: ubiquitous + response: "each of the four multi-agent.svg files matches no /dispatch/i and no /orchestrat/i anywhere, comments included" + text: "The multi-agent diagram shall no longer depict an orchestrator dispatching workers — neither in rendered text nor in authoring comments; the hub is the host, which runs the role briefs." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-4c5b1cc6 + ears: ubiquitous + response: "each of the four multi-agent.svg files contains the literals 'independent' and 'self-certified'; the en file contains 'host'" + text: "The diagram's convergence point shall be cladding's judgment of the record — gates plus the independence label — so the drawing carries the independent | self-certified vocabulary in every locale." + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-5965394a + ears: ubiquitous + response: "README pin suites and the existing choreography-guard README/persona cases stay green after the diagram + guard-case update" + text: "The geometry rework shall not disturb any README pin; the guard case that tolerated the old dispatch-arrows authoring comment is tightened to whole-file cleanliness." + test_refs: ["tests/choreography-guard.test.ts", "tests/readme-loop-section.test.ts", "tests/readme-record-honesty.test.ts"] +design_impact: + classification: none + rationale: "Documentation diagram alignment: the drawing catches up with the role-contract architecture already shipped in prose (persona cards, README). No engine or capability changes." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index 445e4e61..6596392a 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -130,6 +130,7 @@ features: F-417ff0: {slug: scan-llm-dispatcher-chain, status: done, modules: 5} F-42af48: {slug: architecture-from-spec, status: done, modules: 2} F-43d8e3: {slug: smoke-probe-token-pass, status: done, modules: 3} + F-4498eb3d: {slug: multi-agent-diagram-role-contract, status: done, modules: 4} F-4643d99d: {slug: lint-multi-finding, status: done, modules: 3} F-4747ef: {slug: ssot-lifecycle-tests, status: done, modules: 9} F-47b8bee5: {slug: ts-toolchain-jest-and-multiext-arch, status: done, modules: 1} diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts index 34452033..02704586 100644 --- a/tests/choreography-guard.test.ts +++ b/tests/choreography-guard.test.ts @@ -232,34 +232,49 @@ describe('README Multi-Agent section speaks the role contract, not choreography }); }); -// AC-8d63da98 extension — the localized multi-agent.svg diagrams must not -// render the dispatch story either. Each file carries one non-rendered -// authoring comment (`<!-- dispatch arrows : orchestrator -> workers -->`) -// that still literally says "dispatch" — it describes unchanged arrow -// geometry (a deliberately out-of-scope geometry rework, per the impl -// report), is never rendered, and its removal is NOT demanded here. Comments -// are stripped before matching so only rendered <title>/<text> content (the -// a11y title and on-canvas labels) is checked. -describe('localized multi-agent.svg diagrams render no dispatch story (AC-8d63da98)', () => { +// F-4498eb3d — the localized multi-agent.svg diagrams draw the role +// contract, not an orchestrator dispatching workers. The diagram's hub used +// to be an "orchestrator" box with a "<!-- dispatch arrows : orchestrator -> +// workers -->" authoring comment; both the rendered word and the comment are +// now GONE by design (the hub is "host", which runs the role briefs — see +// the impl report). Since the choreography vocabulary must be absent +// EVERYWHERE (rendered text and authoring comments alike), these checks run +// against the whole raw file — no comment-stripping. +describe('localized multi-agent.svg diagrams draw the role contract (F-4498eb3d)', () => { const SVGS: readonly string[] = [ 'docs/img/en/multi-agent.svg', 'docs/img/ko/multi-agent.svg', 'docs/img/ja/multi-agent.svg', 'docs/img/zh/multi-agent.svg', ]; - const stripXmlComments = (svg: string): string => svg.replace(/<!--[\s\S]*?-->/g, ''); - - for (const f of SVGS) { - test(`${f}: rendered text/title content matches no /dispatch/i`, () => { - const raw = repoRead(f); - // Sanity check — the known non-rendered authoring comment is still - // present, so the assertion below proves the comment-strip is doing - // real work rather than vacuously passing on a file with no needle at all. - expect(raw, `${f}: expected the known authoring comment to still mention "dispatch" (non-rendered, not required to be removed)`).toMatch( - /dispatch/i, - ); - const rendered = stripXmlComments(raw); - expect(rendered, `${f}: rendered SVG text/title must not match /dispatch/i`).not.toMatch(/dispatch/i); + + describe('AC-4a195d3a — no dispatch/orchestrator story anywhere, comments included', () => { + for (const f of SVGS) { + test(`${f}: whole file matches no /dispatch/i`, () => { + const raw = repoRead(f); + expect(raw, `${f}: must not match /dispatch/i anywhere, comments included`).not.toMatch(/dispatch/i); + }); + + test(`${f}: whole file matches no /orchestrat/i`, () => { + const raw = repoRead(f); + expect(raw, `${f}: must not match /orchestrat/i anywhere, comments included`).not.toMatch(/orchestrat/i); + }); + } + }); + + describe('AC-4c5b1cc6 — the convergence point carries the independence label', () => { + for (const f of SVGS) { + test(`${f}: contains both "independent" and "self-certified"`, () => { + const raw = repoRead(f); + expect(raw, `${f}: must contain "independent"`).toContain('independent'); + expect(raw, `${f}: must contain "self-certified"`).toContain('self-certified'); + }); + } + + test('docs/img/en/multi-agent.svg: contains "host" and "cladding"', () => { + const raw = repoRead('docs/img/en/multi-agent.svg'); + expect(raw, 'en file must contain "host"').toContain('host'); + expect(raw, 'en file must contain "cladding"').toContain('cladding'); }); - } + }); }); From a11eb47473b77093ade629b599498d7234f84e70 Mon Sep 17 00:00:00 2001 From: qwerfunch <qwerfunch@gmail.com> Date: Sat, 25 Jul 2026 00:01:11 +0900 Subject: [PATCH 08/13] feat(init): persona map states non-exclusivity; planner brief drops dogfood-only commands (F-9d8ece66) Role-contract architecture, feature 6. The managed AGENTS.md persona map now states the briefs' standing explicitly: touchpoint manuals, not a roster of permitted agents - any host agent may take up any brief, none is needed off cladding surfaces, and the only identity-tied judgment is the independence label (verifier independent of author, never brief membership). The sentence is behavior-validated, not just reviewed: a live A/B/C experiment against fresh agents in the E2E clean-room showed the draft wording ("any agent may do any work, the gates judge only the result") was cited by 2/2 agents to discount the independence label, while this final wording steered 2/2 agents to honest labeling and an explicit refusal to route around the gate. Wording is pinned verbatim by test. Also repairs E2E gap G3: planner.md sent external users to cladding's repo-only npm scripts (spec:validate / stage:drift); it now directs them to clad sync / clad check --strict. Mirrors regenerated. 2715 tests green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --- README.html | 4 +-- README.ja.md | 4 +-- README.ko.html | 4 +-- README.ko.md | 4 +-- README.md | 4 +-- README.zh.md | 4 +-- plugins/antigravity/skills/planner/SKILL.md | 2 +- plugins/claude-code/agents/planner.md | 2 +- plugins/claude-code/dist/agents/planner.md | 2 +- plugins/claude-code/dist/clad.js | 2 +- plugins/codex/skills/planner/SKILL.md | 2 +- spec.yaml | 2 +- spec/attestation.yaml | 23 +++++++-------- .../persona-map-non-exclusivity-9d8ece66.yaml | 28 +++++++++++++++++++ spec/index.yaml | 1 + src/agents/planner.md | 2 +- src/init/agents-md.ts | 2 ++ tests/choreography-guard.test.ts | 27 ++++++++++++++++++ tests/init/agents-md.test.ts | 19 +++++++++++++ 19 files changed, 108 insertions(+), 30 deletions(-) create mode 100644 spec/features/persona-map-non-exclusivity-9d8ece66.yaml diff --git a/README.html b/README.html index b30a17d5..d198b737 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -553,7 +553,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2712<span style="font-size:16px;color:#94a3b8">/2712</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2715<span style="font-size:16px;color:#94a3b8">/2715</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ja.md b/README.ja.md index c95c4e54..82a6d8af 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -341,7 +341,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 段階 · 41 detectors | 261（258 done） | <sub>236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック</sub> diff --git a/README.ko.html b/README.ko.html index 14a4bdda..cd4d426a 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -591,7 +591,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2712<span style="font-size:16px;color:#94a3b8">/2712</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2715<span style="font-size:16px;color:#94a3b8">/2715</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ko.md b/README.ko.md index 9986db12..45dc0427 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -340,7 +340,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | <sub>236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단</sub> diff --git a/README.md b/README.md index 0f72169a..c40ebe82 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -354,7 +354,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 stages · 41 detectors | 261 (258 done) | <sub>236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector</sub> diff --git a/README.zh.md b/README.zh.md index 5aa8a91a..5ad4e7bb 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2712%2F2712-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -337,7 +337,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2712 / 2712 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 阶段 · 41 检测器 | 261（258 done） | <sub>236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下</sub> diff --git a/plugins/antigravity/skills/planner/SKILL.md b/plugins/antigravity/skills/planner/SKILL.md index 0cac8057..74a4755f 100644 --- a/plugins/antigravity/skills/planner/SKILL.md +++ b/plugins/antigravity/skills/planner/SKILL.md @@ -29,7 +29,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. - Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. -- Run `npm run spec:validate` and `npm run stage:drift` after every edit. +- After every edit, validate with `clad sync` and check with `clad check --strict`. ### Scenarios policy (v0.3.45+) diff --git a/plugins/claude-code/agents/planner.md b/plugins/claude-code/agents/planner.md index 0cac8057..74a4755f 100644 --- a/plugins/claude-code/agents/planner.md +++ b/plugins/claude-code/agents/planner.md @@ -29,7 +29,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. - Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. -- Run `npm run spec:validate` and `npm run stage:drift` after every edit. +- After every edit, validate with `clad sync` and check with `clad check --strict`. ### Scenarios policy (v0.3.45+) diff --git a/plugins/claude-code/dist/agents/planner.md b/plugins/claude-code/dist/agents/planner.md index 0cac8057..74a4755f 100644 --- a/plugins/claude-code/dist/agents/planner.md +++ b/plugins/claude-code/dist/agents/planner.md @@ -29,7 +29,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. - Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. -- Run `npm run spec:validate` and `npm run stage:drift` after every edit. +- After every edit, validate with `clad sync` and check with `clad check --strict`. ### Scenarios policy (v0.3.45+) diff --git a/plugins/claude-code/dist/clad.js b/plugins/claude-code/dist/clad.js index 6fa8d623..66897267 100755 --- a/plugins/claude-code/dist/clad.js +++ b/plugins/claude-code/dist/clad.js @@ -697,7 +697,7 @@ ${r.join(` ${n} `:` `,a=qDe.map(([l,u])=>`- ${l} \u2014 ${u}`).join(` -`),c=i?` The default persona for this project is **${i}**.`:"";return["This project is managed by **cladding** \u2014 the Spec-Anchored Agent Harness.","The lines between the `clad:agents-md` markers are generated from `spec.yaml`; edit the spec, not them. Everything OUTSIDE the markers is yours to keep.","",o,s.replace(/\n$/,""),"","## Single source of truth","","- `spec.yaml` is authoritative (Tier A); code must conform to its `features[]` and"," `acceptance_criteria`. Feature detail lives in `spec/features/<slug>-<hash>.yaml` \u2014"," never hand-author `F-NNN` filenames; ask cladding via the `clad` CLI (or"," `clad_create_feature` when your host has cladding wired as an MCP server).","- For shell commands, use `node .cladding/host/serve.cjs <arguments>` when that"," project launcher exists; it pins the CLI to the same engine as MCP. Fall back to"," `clad <arguments>` only when the project has no launcher.","- Run the resolved Cladding command with `check --strict` to verify spec \u2194 code"," across every drift detector.",GDe(e).replace(/\n$/,""),"","## Feature cycle \u2014 one at a time","","Finish ONE feature end-to-end before the next: author its spec entry (`acceptance_criteria`","+ `modules`) \u2192 implement \u2192 author tests in a separate context \u2192 run the declared test","command and confirm it collected relevant tests \u2192 run the resolved Cladding command","with `done <featureId>` (sets `status: done` only when the strict pre-push gate is","GREEN). Package test scripts must not depend on shell-expanded glob patterns. Do not","author spec entries ahead of their code, or hand-write `status: done`.","","## Design evolves with each feature","","Before implementation, classify the feature as: no design impact, an additive","capability/scenario link, or a structural change. Apply deterministic links directly;","preview architecture or project-context changes for the user. Do not finish a feature","while a material design impact remains unresolved, and do not churn design documents","for internal fixes that genuinely have no design impact.",HDe(t).replace(/\n$/,""),"","## Personas \u2014 cross-host capability map (anti-self-cert)","",`The agent that writes a unit of work must not sign off on it.${c} Each`,"persona and the vendor-neutral capabilities it may use \u2014 so Codex, Gemini, and other","AGENTS.md readers receive the same guidance Claude does:","",a,"","## Speak the user's language","","Translate cladding's vocabulary into plain words in the user's own language when you","report progress \u2014 relay gate/hook messages by meaning, and never lead with an internal","id (`F-\u2026`, `AC-\u2026`, `stage_X.Y`): name the feature and the plain outcome instead."].join(` +`),c=i?` The default persona for this project is **${i}**.`:"";return["This project is managed by **cladding** \u2014 the Spec-Anchored Agent Harness.","The lines between the `clad:agents-md` markers are generated from `spec.yaml`; edit the spec, not them. Everything OUTSIDE the markers is yours to keep.","",o,s.replace(/\n$/,""),"","## Single source of truth","","- `spec.yaml` is authoritative (Tier A); code must conform to its `features[]` and"," `acceptance_criteria`. Feature detail lives in `spec/features/<slug>-<hash>.yaml` \u2014"," never hand-author `F-NNN` filenames; ask cladding via the `clad` CLI (or"," `clad_create_feature` when your host has cladding wired as an MCP server).","- For shell commands, use `node .cladding/host/serve.cjs <arguments>` when that"," project launcher exists; it pins the CLI to the same engine as MCP. Fall back to"," `clad <arguments>` only when the project has no launcher.","- Run the resolved Cladding command with `check --strict` to verify spec \u2194 code"," across every drift detector.",GDe(e).replace(/\n$/,""),"","## Feature cycle \u2014 one at a time","","Finish ONE feature end-to-end before the next: author its spec entry (`acceptance_criteria`","+ `modules`) \u2192 implement \u2192 author tests in a separate context \u2192 run the declared test","command and confirm it collected relevant tests \u2192 run the resolved Cladding command","with `done <featureId>` (sets `status: done` only when the strict pre-push gate is","GREEN). Package test scripts must not depend on shell-expanded glob patterns. Do not","author spec entries ahead of their code, or hand-write `status: done`.","","## Design evolves with each feature","","Before implementation, classify the feature as: no design impact, an additive","capability/scenario link, or a structural change. Apply deterministic links directly;","preview architecture or project-context changes for the user. Do not finish a feature","while a material design impact remains unresolved, and do not churn design documents","for internal fixes that genuinely have no design impact.",HDe(t).replace(/\n$/,""),"","## Personas \u2014 cross-host capability map (anti-self-cert)","",`The agent that writes a unit of work must not sign off on it.${c} Each`,"persona and the vendor-neutral capabilities it may use \u2014 so Codex, Gemini, and other","AGENTS.md readers receive the same guidance Claude does:","",a,"","These briefs are manuals for cladding's touchpoints, not a roster of permitted agents: any host agent may take up any of them, and an agent that never touches a cladding surface needs none. The gates judge a result the same way whoever produced it \u2014 the one thing tied to identity is the independence label, which records whether the verifier was independent of the author, never which brief (if any) an agent wore.","","## Speak the user's language","","Translate cladding's vocabulary into plain words in the user's own language when you","report progress \u2014 relay gate/hook messages by meaning, and never lead with an internal","id (`F-\u2026`, `AC-\u2026`, `stage_X.Y`): name the feature and the plain outcome instead."].join(` `).replace(/\n{3,}/g,` `).trim()}function VDe(t,e){let r=t.includes(`\r diff --git a/plugins/codex/skills/planner/SKILL.md b/plugins/codex/skills/planner/SKILL.md index 0cac8057..74a4755f 100644 --- a/plugins/codex/skills/planner/SKILL.md +++ b/plugins/codex/skills/planner/SKILL.md @@ -29,7 +29,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. - Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. -- Run `npm run spec:validate` and `npm run stage:drift` after every edit. +- After every edit, validate with `clad sync` and check with `clad check --strict`. ### Scenarios policy (v0.3.45+) diff --git a/spec.yaml b/spec.yaml index 7fff7170..d3aa785c 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 268 + features: 269 scenarios: 2 capabilities: 6 test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index 074d22d2..551b7ca7 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 93ecad5c2451d7b5 - README.ja.md: df6e1c8fe6632469 - README.ko.html: cc4ebde7a1838485 - README.ko.md: a572b620d742296a - README.md: 8959f852facd1d08 - README.zh.md: 6bb316e6027c3d16 + README.html: a5dcb1c7f06cffaf + README.ja.md: eb269dbdc4799287 + README.ko.html: 5799c10feebfbef9 + README.ko.md: 6804e651e435a932 + README.md: f4ca5b9e77bca21d + README.zh.md: 3ff55eccf72ddb86 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -77,7 +77,7 @@ attested_modules: plugins/claude-code/agents/developer.md: 3002b4ef69ddab43 plugins/claude-code/agents/observability.md: 637fde18c012e2a7 plugins/claude-code/agents/orchestrator.md: 1b758de0bdab8eb0 - plugins/claude-code/agents/planner.md: 5e50090f16678fd7 + plugins/claude-code/agents/planner.md: d1f895a20fb3a3ed plugins/claude-code/agents/reviewer.md: cdf7469a3e58b438 plugins/claude-code/commands/init.md: 5529b13d0f1ab4bf plugins/claude-code/hooks/hooks.json: 42321ead26fb1da8 @@ -88,7 +88,7 @@ attested_modules: plugins/codex/skills/init/SKILL.md: 5529b13d0f1ab4bf plugins/codex/skills/observability/SKILL.md: 637fde18c012e2a7 plugins/codex/skills/orchestrator/SKILL.md: 1b758de0bdab8eb0 - plugins/codex/skills/planner/SKILL.md: 5e50090f16678fd7 + plugins/codex/skills/planner/SKILL.md: d1f895a20fb3a3ed plugins/codex/skills/reviewer/SKILL.md: cdf7469a3e58b438 plugins/codex/skills/run/SKILL.md: 9f95ff17d70c8dd1 plugins/codex/skills/serve/SKILL.md: f08bbdbbfeb05041 @@ -117,7 +117,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: a40e9736d8324cf3 + spec.yaml: 019625b441b6478b spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -143,7 +143,7 @@ attested_modules: src/agents/loader.ts: 6d35560c47f9ae85 src/agents/observability.md: 637fde18c012e2a7 src/agents/orchestrator.md: 1b758de0bdab8eb0 - src/agents/planner.md: 5e50090f16678fd7 + src/agents/planner.md: d1f895a20fb3a3ed src/agents/reviewer.md: cdf7469a3e58b438 src/changelog/collect.ts: a6c936a7b8c34e2a src/changelog/render.ts: 83dd2d95f24ca68c @@ -207,7 +207,7 @@ attested_modules: src/hitl/audit.ts: 79b06e904815469a src/hitl/identity.ts: 52ff84aa666f1dab src/hitl/independence.ts: 202f4e5ef8bc69e3 - src/init/agents-md.ts: 3eb5ed2c7b6edc8c + src/init/agents-md.ts: 698b2a38ddd5d1a6 src/init/git-hook.ts: b77910b0df392cbf src/init/host-instructions.ts: c598f8598d8d1cd4 src/init/host-setup.ts: 158cc9306a746da1 @@ -624,6 +624,7 @@ attested_features: F-9af291fa: ok F-9b643e: ok F-9d168287: ok + F-9d8ece66: ok F-a04cd9: ok F-a4085adf: ok F-a4b512: ok diff --git a/spec/features/persona-map-non-exclusivity-9d8ece66.yaml b/spec/features/persona-map-non-exclusivity-9d8ece66.yaml new file mode 100644 index 00000000..63eb203e --- /dev/null +++ b/spec/features/persona-map-non-exclusivity-9d8ece66.yaml @@ -0,0 +1,28 @@ +id: F-9d8ece66 +slug: persona-map-non-exclusivity +title: "Managed persona map states non-exclusivity; planner brief loses dogfood-only commands" +status: done +modules: + - src/init/agents-md.ts + - src/agents/planner.md +acceptance_criteria: + - id: AC-9255e821 + ears: ubiquitous + text: "The managed AGENTS.md personas section shall state that the briefs are touchpoint manuals, not a roster of permitted agents — any host agent may take up any brief, none is needed off cladding surfaces, and the only identity-tied judgment is the independence label (verifier independent of author, never brief membership)." + response: "renderAgentsMdManagedBlock output contains the literals 'not a roster of permitted agents' and 'independence label'" + test_refs: ["tests/init/agents-md.test.ts"] + - id: AC-65e247dc + ears: ubiquitous + text: "The planner brief shall direct external users to the clad CLI for post-edit validation instead of cladding's own repo-only npm scripts." + response: "src/agents/planner.md matches no /npm run (spec:validate|stage:drift)/" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-bb56efe2 + ears: ubiquitous + text: "Every existing pin on the managed block and personas shall survive — the anti-self-cert and feature-cycle literals, shard-term and choreography needles, persona size budgets, and the repo's own dogfood parity." + response: "agent-interpreter-rule, shard-term-guard and choreography-guard suites stay green" + test_refs: ["tests/agent-interpreter-rule.test.ts", "tests/shard-term-guard.test.ts"] +design_impact: + classification: none + rationale: "Prose-layer: one behavior-validated sentence in the generated persona map (A/B/C-tested against live agents — draft wording measurably steered agents to discount the independence label; the shipped wording steered them to honest labeling), plus removal of dogfood-only command guidance from the planner brief (E2E gap G3). No engine logic changes." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index 6596392a..c390babd 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -193,6 +193,7 @@ features: F-9af291fa: {slug: instruction-led-language, status: done, modules: 3} F-9b643e: {slug: scan-conventions, status: done, modules: 5} F-9d168287: {slug: ears-complex-pattern, status: done, modules: 6} + F-9d8ece66: {slug: persona-map-non-exclusivity, status: done, modules: 2} F-a04cd9: {slug: ac-hash-ids, status: done, modules: 3} F-a4085adf: {slug: spec-driven-agents-md, status: done, modules: 1} F-a4b512: {slug: dependency-cycle-detector, status: done, modules: 2} diff --git a/src/agents/planner.md b/src/agents/planner.md index 0cac8057..74a4755f 100644 --- a/src/agents/planner.md +++ b/src/agents/planner.md @@ -29,7 +29,7 @@ You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — - Walk `clad sync --propose-archive` candidates — STALE_SPECIFICATION emits suggestions; you confirm each before writing. - Split `spec.yaml` into per-feature spec files (`spec/features/*.yaml`) when the master crosses ~1k lines. - Edit `spec/architecture.yaml` and `spec/capabilities.yaml` between scans — Tier B, edit-friendly; next scan diverts new body to `.cladding/scan/*.proposal`. -- Run `npm run spec:validate` and `npm run stage:drift` after every edit. +- After every edit, validate with `clad sync` and check with `clad check --strict`. ### Scenarios policy (v0.3.45+) diff --git a/src/init/agents-md.ts b/src/init/agents-md.ts index 6c362d44..e18d3e0a 100644 --- a/src/init/agents-md.ts +++ b/src/init/agents-md.ts @@ -170,6 +170,8 @@ export function renderAgentsMdManagedBlock(spec: Spec | null, cwd: string = '.') '', personaLines, '', + "These briefs are manuals for cladding's touchpoints, not a roster of permitted agents: any host agent may take up any of them, and an agent that never touches a cladding surface needs none. The gates judge a result the same way whoever produced it — the one thing tied to identity is the independence label, which records whether the verifier was independent of the author, never which brief (if any) an agent wore.", + '', "## Speak the user's language", '', "Translate cladding's vocabulary into plain words in the user's own language when you", diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts index 02704586..dd27941e 100644 --- a/tests/choreography-guard.test.ts +++ b/tests/choreography-guard.test.ts @@ -174,6 +174,33 @@ describe('specialist personas are selectable role briefs, not mandated agents', }); }); +// F-9d8ece66 — planner brief loses dogfood-only npm script commands (E2E gap +// G3): `npm run spec:validate` / `npm run stage:drift` are cladding's own +// package.json scripts, not something an external adopter running clad as a +// dependency has. The planner brief must instead point at the `clad` CLI. +const DOGFOOD_NPM_SCRIPTS = /npm run (spec:validate|stage:drift)/; + +describe('planner brief points external users at the clad CLI, not dogfood-only npm scripts (F-9d8ece66)', () => { + const plannerPersona = SPECIALIST_PERSONAS.find((p) => p.id === 'planner')!; + + describe('AC-65e247dc — no npm run spec:validate / stage:drift guidance remains', () => { + test('src/agents/planner.md matches no /npm run (spec:validate|stage:drift)/', () => { + const body = readFileSync(plannerPersona.srcPath, 'utf8'); + expect(body, 'src/agents/planner.md must not match /npm run (spec:validate|stage:drift)/').not.toMatch( + DOGFOOD_NPM_SCRIPTS, + ); + }); + + test('mirror parity: plugins/claude-code/agents/planner.md matches no /npm run (spec:validate|stage:drift)/', () => { + const body = readFileSync(plannerPersona.mirrorPath, 'utf8'); + expect( + body, + 'plugins/claude-code/agents/planner.md must not match /npm run (spec:validate|stage:drift)/', + ).not.toMatch(DOGFOOD_NPM_SCRIPTS); + }); + }); +}); + // F-96d1f69d — README Multi-Agent section speaks the role contract, not // choreography. Opus's rewrite (all 6 README variants + the 4 localized // docs/img/<lang>/multi-agent.svg diagrams) replaced the "orchestrator diff --git a/tests/init/agents-md.test.ts b/tests/init/agents-md.test.ts index fbba39cb..eb545f17 100644 --- a/tests/init/agents-md.test.ts +++ b/tests/init/agents-md.test.ts @@ -127,6 +127,25 @@ describe('renderAgentsMdManagedBlock — AC-9d3f2e88 (cross-host persona map)', }); }); +describe('renderAgentsMdManagedBlock — AC-9255e821 (personas are not an exclusivity roster)', () => { + test('states the briefs are touchpoint manuals, not a roster of permitted agents, and ties identity only to the independence label', () => { + const withSpecBlock = renderAgentsMdManagedBlock( + { + schema: '0.1', + project: {name: 'x', language: 'typescript'}, + features: [], + } as never, + '.', + ); + const withoutSpecBlock = renderAgentsMdManagedBlock(null, '.'); + + for (const block of [withSpecBlock, withoutSpecBlock]) { + expect(block).toContain('not a roster of permitted agents'); + expect(block).toContain('independence label'); + } + }); +}); + describe('renderAgentsMdManagedBlock — post-init command integrity', () => { test('pins shell commands to the project engine and requires non-vacuous portable tests', () => { const block = renderAgentsMdManagedBlock(null, '.'); From 9e7fc8f1703ca1b53bb50c5372d63a88606c44f1 Mon Sep 17 00:00:00 2001 From: qwerfunch <qwerfunch@gmail.com> Date: Sat, 25 Jul 2026 01:17:49 +0900 Subject: [PATCH 09/13] docs(readme): Multi-Agent section goes prose-only, diagram retired (F-8476ccb1) Role-contract architecture, feature 7. After four diagram drafts the section now carries the inversion in prose alone - user's call: every drawing of roles kept reading as a fixed cast. - all 6 README variants: the section opens by denying the old identity ("not a multi-agent framework" - cladding neither prescribes nor sees the host's agent topology), then a three-bullet contrast (one agent does everything -> self-certified; a blind test author -> independent; a human sign-off -> independent), then label/policy/briefs and the hedged EU AI Act sentence. Native ko/ja/zh rewrites. - docs/img/{en,ko,ja,zh}/multi-agent.svg removed; F-4498eb3d archived (modules: [], superseded_by: F-8476ccb1) per the archive convention - tests/choreography-guard.test.ts: 13 obsolete SVG cases removed, 8 prose-only pins added (identity-denial literal, no multi-agent.svg reference in any variant, three-shape list present) - 2710 tests green, strict pre-push gate GREEN, done earned via clad done Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --- README.html | 24 +++-- README.ja.md | 18 ++-- README.ko.html | 26 +++-- README.ko.md | 18 ++-- README.md | 18 ++-- README.zh.md | 18 ++-- docs/img/en/multi-agent.svg | 98 ------------------- docs/img/ja/multi-agent.svg | 98 ------------------- docs/img/ko/multi-agent.svg | 98 ------------------- docs/img/zh/multi-agent.svg | 98 ------------------- spec.yaml | 2 +- spec/attestation.yaml | 20 ++-- ...-agent-diagram-role-contract-4498eb3d.yaml | 11 +-- .../readme-multiagent-inversion-8476ccb1.yaml | 32 ++++++ spec/index.yaml | 3 +- tests/choreography-guard.test.ts | 65 +++++------- 16 files changed, 133 insertions(+), 514 deletions(-) delete mode 100644 docs/img/en/multi-agent.svg delete mode 100644 docs/img/ja/multi-agent.svg delete mode 100644 docs/img/ko/multi-agent.svg delete mode 100644 docs/img/zh/multi-agent.svg create mode 100644 spec/features/readme-multiagent-inversion-8476ccb1.yaml diff --git a/README.html b/README.html index d198b737..dc37f11d 100644 --- a/README.html +++ b/README.html @@ -233,7 +233,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -453,21 +453,19 @@ <h3>Detectors — 41 drift detectors</h3> <p>One feature's lifecycle runs <strong>Define → Sync → Implement → Earn</strong> — you earn <code>done</code> only by passing every check.</p> <!-- ─────────────── Multi-Agent ─────────────── --> - <h2>Multi-Agent — separating the builder from the verifier</h2> + <h2>Multi-Agent — yours to run, cladding's to judge</h2> <p> - Keeping the agents that <strong>build</strong> apart from the agents that <strong>verify</strong> — so no agent signs off on its own work — is a <strong>declared outcome condition here, not a pipeline cladding runs for you.</strong> - cladding <em>judges</em> it from the record: every completion you take through <code>clad done</code> / <code>clad verdict</code> is labeled <code>independent</code> or <code>self-certified</code>, reporting what the recorded evidence shows — whether an independent or human review signed off, not whether the code is right. - The label makes that visible; it doesn't block on its own. A team that wants teeth sets <code>independence_policy: require</code> in <code>spec.yaml</code>, and self-certified completions are refused. + cladding is not a multi-agent framework: it never spawns, routes, or coordinates agents, and it neither prescribes nor sees how many there are. What it owns is smaller and sharper — whether the builder and the verifier were actually separate, on the record. </p> + <p>The same project can ship three features three different ways:</p> + <ul> + <li>one agent builds, tests, and reviews — labeled <code>self-certified</code></li> + <li>a second agent writes the tests from the spec alone (it has no tool to read the code) — labeled <code>independent</code></li> + <li>a person signs off the review — labeled <code>independent</code></li> + </ul> <p> - How the agents run — how many, which models, how much in parallel — is the <strong>host's</strong> decision. - cladding ships role briefs (planner, developer, reviewer, observability, blind-author) the host can embody with any agent shape; it never prescribes spawning. - <strong>blind-author</strong> is the sharpest of them: the agent that writes the tests literally <em>can't read the code</em> (it's given no Read/Grep tool), so "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. - It's the same <strong>separation of duties</strong> that audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. + The label on <code>clad done</code> / <code>clad verdict</code> reports what each completion's recorded evidence shows — never which agents did the work, how many, or whose. It doesn't block on its own; teams that want teeth set <code>independence_policy: require</code> in <code>spec.yaml</code>, and self-certified completions are refused. The role briefs (planner · developer · reviewer · observability · blind-author) stay optional manuals for cladding's touchpoints, not a fixed cast. It's the same separation of duties audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. </p> - <div class="diagram"> - <img class="diagram-img" src="docs/img/en/multi-agent.svg" alt="Separation of duties — the roles are kept separate so no agent signs off on its own work, and every completion is labeled independent or self-certified from the recorded evidence; the host decides how the agents run" width="700"> - </div> <!-- ─────────────── Ecosystem ─────────────── --> <h2>Ecosystem</h2> @@ -553,7 +551,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2715<span style="font-size:16px;color:#94a3b8">/2715</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2710<span style="font-size:16px;color:#94a3b8">/2710</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ja.md b/README.ja.md index 82a6d8af..1fdefe06 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -208,17 +208,17 @@ acceptance_criteria: <!-- ─────────────── Multi-Agent ─────────────── --> -## Multi-Agent — 作る側と検証する側を分ける +## Multi-Agent — 走らせるのはあなた、判定するのは cladding -**作る** エージェントと **検証する** エージェントを分け、どのエージェントも自分の仕事に自分で承認を与えられないようにする — これは cladding が代わりに回すパイプラインではなく、**宣言された結果条件**だ。cladding はそれを記録から **判定する**: `clad done` / `clad verdict` を通したすべての完了に `independent` か `self-certified` のラベルが付き、コードが正しいかどうかではなく、**記録された証拠が示すこと** — 独立レビューや人間の承認があったかどうか — を表す。ラベルはそれを見えるようにするだけで、それ自体がブロックするわけではない。強制したいチームは `spec.yaml` に `independence_policy: require` を置き、self-certified の完了を拒否する。 +cladding はマルチエージェント・フレームワークではない。エージェントをスポーンも、ルーティングも、調整もしないし、何個走るかを指示することも見ることもない。cladding が握っているのはもっと小さく鋭いもの — 作る側と検証する側が実際に分かれていたか、を記録に残すことだ。 -エージェントを何個、どのモデルで、どれだけ並列で走らせるかは **ホスト** が決める。cladding は役割ブリーフ（planner · developer · reviewer · observability · blind-author）を提供するだけで、どんなエージェント構成で体現しようと、スポーンを指示しない。なかでも最も鋭いのが **blind-author** だ — テストを書くエージェントには、そもそも *実装を読む手段が与えられていない*（Read/Grep を付与しない）。「実装を見ずに書いた」が約束ではなく構造的な事実になる。この分離は、規制 · 監査の枠組み（EU AI Act · SOX）が求める職務分掌の原則と重なる — それらの精神に合致するという意味であって、認証ではない。 +同じプロジェクトが、三つの feature を三通りのやり方で出荷できる： -<div align="center"> - -<img src="docs/img/ja/multi-agent.svg" alt="職務分離 — 役割を分けてどのエージェントも自分の仕事を自分で承認できず、すべての完了は記録された証拠に基づき independent か self-certified のラベルが付く。エージェントの走らせ方はホストが決める" width="700"> +- 一つのエージェントが作り、テストし、レビューする — `self-certified` と表示 +- 二つ目のエージェントが仕様だけを見てテストを書く（コードを読む手段がない） — `independent` と表示 +- 人間がレビューを承認する — `independent` と表示 -</div> +`clad done` / `clad verdict` のラベルは、各完了の記録された証拠が示すものを表すだけで、どのエージェントが、何個で、誰の手で作業したかは決して含まない。ラベル自体はブロックしない。強制したいチームは `spec.yaml` に `independence_policy: require` を置き、self-certified の完了は拒否される。役割ブリーフ（planner · developer · reviewer · observability · blind-author）は cladding の接点のための任意のマニュアルとして残るだけで、固定の配役ではない。これは EU AI Act や SOX のような監査規則が求めるのと同じ職務分掌だ — その精神においてであって、認証ではない。 <!-- ─────────────── Ecosystem ─────────────── --> @@ -341,7 +341,7 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 段階 · 41 detectors | 261（258 done） | <sub>236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック</sub> diff --git a/README.ko.html b/README.ko.html index cd4d426a..f096c516 100644 --- a/README.ko.html +++ b/README.ko.html @@ -275,7 +275,7 @@ <h1>cladding</h1> <p class="badges"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"></a> </p> @@ -488,23 +488,19 @@ <h2>내부 동작</h2> <p>한 기능의 생애주기는 <strong>Define → Sync → Implement → Earn</strong>으로 흐른다 — 모든 검사를 통과해야만 <code>done</code>을 얻는다.</p> <!-- ─────────────── Multi-Agent ─────────────── --> - <h2>Multi-Agent — 만드는 자와 검증하는 자의 분리</h2> + <h2>Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding</h2> <p> - <strong>빌드</strong>하는 에이전트와 <strong>검증</strong>하는 에이전트를 떼어 놓아 어떤 에이전트도 자기 작업을 - 스스로 승인하지 못하게 하는 것 — 이건 cladding이 대신 굴려 주는 파이프라인이 아니라 <strong>선언된 결과 조건</strong>이다. - cladding은 그것을 기록으로 <em>판정</em>한다: <code>clad done</code> / <code>clad verdict</code>를 거치는 모든 완료에 - <code>independent</code> 또는 <code>self-certified</code> 라벨이 붙는데, 이는 코드가 맞는지가 아니라 <strong>기록된 근거가 보여 주는 것</strong> — 독립 리뷰나 사람 승인이 있었는지 — 를 나타낸다. - 라벨은 그것을 드러낼 뿐, 그 자체로 막지는 않는다. 강제하고 싶은 팀은 <code>spec.yaml</code>에 <code>independence_policy: require</code>를 두어 self-certified 완료를 거부한다. + cladding은 멀티에이전트 프레임워크가 아니다: 에이전트를 스폰하거나 라우팅하거나 조율하지 않고, 몇 개가 도는지 지시하지도 보지도 않는다. cladding이 쥐고 있는 건 더 작고 더 날카롭다 — 만드는 자와 검증하는 자가 실제로 분리돼 있었는지를, 기록으로 남기는 것. </p> + <p>같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다:</p> + <ul> + <li>한 에이전트가 만들고, 테스트하고, 리뷰한다 — <code>self-certified</code>로 표시</li> + <li>두 번째 에이전트가 스펙만 보고 테스트를 쓴다(코드를 읽을 도구가 없다) — <code>independent</code>로 표시</li> + <li>사람이 리뷰를 승인한다 — <code>independent</code>로 표시</li> + </ul> <p> - 에이전트를 몇 개, 어떤 모델로, 얼마나 병렬로 돌릴지는 <strong>호스트</strong>가 정한다. - cladding은 역할 브리프(planner · developer · reviewer · observability · blind-author)를 제공할 뿐, 어떤 에이전트 형태로 구현하든 스폰을 지시하지 않는다. - 그중 가장 날카로운 것이 <strong>blind-author</strong>다: 테스트를 쓰는 에이전트에게는 <em>코드를 읽을 도구가 아예 없어서</em>(Read/Grep 미부여), "코드를 안 보고 테스트를 썼다"는 약속이 아니라 배선상의 사실이 된다. - 이것은 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 <strong>직무 분리</strong>이며 — 정신에서 그렇다는 것이지 인증이 아니다. + <code>clad done</code> / <code>clad verdict</code>의 라벨은 각 완료의 기록된 근거가 보여 주는 것을 나타낼 뿐, 어떤 에이전트가 몇 개로 누구의 손으로 그 일을 했는지는 담지 않는다. 라벨 자체로는 막지 않는다; 강제하고 싶은 팀은 <code>spec.yaml</code>에 <code>independence_policy: require</code>를 두고, 그러면 self-certified 완료가 거부된다. 역할 브리프(planner · developer · reviewer · observability · blind-author)는 cladding의 접점을 위한 선택적 매뉴얼로 남을 뿐, 고정된 배역이 아니다. 이건 EU AI Act·SOX 같은 감사 규정이 요구하는 것과 같은 직무 분리다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. </p> - <div class="diagram"> - <img class="diagram-img" src="docs/img/ko/multi-agent.svg" alt="직무 분리 — 역할을 분리해 어떤 에이전트도 자기 작업을 스스로 승인하지 못하고, 모든 완료는 기록된 근거에 따라 independent 또는 self-certified 라벨이 붙는다; 에이전트를 어떻게 돌릴지는 호스트가 정한다" width="700"> - </div> <!-- ─────────────── Ecosystem ─────────────── --> <h2>Ecosystem</h2> @@ -591,7 +587,7 @@ <h2>Status</h2> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> <div style="font-size:11px;color:#64748b;letter-spacing:1.5px;text-transform:uppercase;font-weight:600">tests</div> - <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2715<span style="font-size:16px;color:#94a3b8">/2715</span></div> + <div style="font-size:24px;font-weight:800;color:#0f172a;margin:8px 0;letter-spacing:-0.5px">2710<span style="font-size:16px;color:#94a3b8">/2710</span></div> <div style="font-size:11px;color:#64748b">all pass</div> </td> <td style="text-align:center;width:140px;background:#f8fafc;padding:18px 10px;border-radius:8px;border:none"> diff --git a/README.ko.md b/README.ko.md index 45dc0427..aa7f0224 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -207,17 +207,17 @@ acceptance_criteria: <!-- ─────────────── Multi-Agent ─────────────── --> -## Multi-Agent — 만드는 자와 검증하는 자의 분리 +## Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding -**만드는** 에이전트와 **검증하는** 에이전트를 떼어 놓아 어떤 에이전트도 자기 작업을 스스로 승인하지 못하게 하는 것 — 이건 cladding이 대신 굴려 주는 파이프라인이 아니라 **선언된 결과 조건**이다. cladding은 그것을 기록으로 **판정**한다: `clad done` / `clad verdict`를 거치는 모든 완료에 `independent` 또는 `self-certified` 라벨이 붙는데, 이는 코드가 맞는지가 아니라 **기록된 근거가 보여 주는 것** — 독립 리뷰나 사람 승인이 있었는지 — 를 나타낸다. 라벨은 그것을 드러낼 뿐, 그 자체로 막지는 않는다. 강제하고 싶은 팀은 `spec.yaml`에 `independence_policy: require`를 두어 self-certified 완료를 거부한다. +cladding은 멀티에이전트 프레임워크가 아니다: 에이전트를 스폰하거나 라우팅하거나 조율하지 않고, 몇 개가 도는지 지시하지도 보지도 않는다. cladding이 쥐고 있는 건 더 작고 더 날카롭다 — 만드는 자와 검증하는 자가 실제로 분리돼 있었는지를, 기록으로 남기는 것. -에이전트를 몇 개, 어떤 모델로, 얼마나 병렬로 돌릴지는 **호스트**가 정한다. cladding은 역할 브리프(planner · developer · reviewer · observability · blind-author)를 제공할 뿐, 어떤 에이전트 형태로 구현하든 스폰을 지시하지 않는다. 그중 가장 날카로운 것이 **blind-author**다: 테스트를 쓰는 에이전트에게는 말 그대로 *코드를 읽을 도구가 없어서*(Read/Grep 미부여), "코드를 안 보고 테스트를 썼다"는 약속이 아니라 배선상의 사실이 된다. 이것은 감사 규정(EU AI Act · SOX)이 요구하는 것과 같은 **직무 분리**다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. +같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다: -<div align="center"> - -<img src="docs/img/ko/multi-agent.svg" alt="직무 분리 — 역할을 분리해 어떤 에이전트도 자기 작업을 스스로 승인하지 못하고, 모든 완료는 기록된 근거에 따라 independent 또는 self-certified 라벨이 붙는다; 에이전트를 어떻게 돌릴지는 호스트가 정한다" width="700"> +- 한 에이전트가 만들고, 테스트하고, 리뷰한다 — `self-certified`로 표시 +- 두 번째 에이전트가 스펙만 보고 테스트를 쓴다(코드를 읽을 도구가 없다) — `independent`로 표시 +- 사람이 리뷰를 승인한다 — `independent`로 표시 -</div> +`clad done` / `clad verdict`의 라벨은 각 완료의 기록된 근거가 보여 주는 것을 나타낼 뿐, 어떤 에이전트가 몇 개로 누구의 손으로 그 일을 했는지는 담지 않는다. 라벨 자체로는 막지 않는다; 강제하고 싶은 팀은 `spec.yaml`에 `independence_policy: require`를 두고, 그러면 self-certified 완료가 거부된다. 역할 브리프(planner · developer · reviewer · observability · blind-author)는 cladding의 접점을 위한 선택적 매뉴얼로 남을 뿐, 고정된 배역이 아니다. 이건 EU AI Act·SOX 같은 감사 규정이 요구하는 것과 같은 직무 분리다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. <!-- ─────────────── Ecosystem ─────────────── --> @@ -340,7 +340,7 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | <sub>236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단</sub> diff --git a/README.md b/README.md index c40ebe82..faef69fe 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -204,17 +204,17 @@ One feature's lifecycle runs **Define → Sync → Implement → Earn** — you <!-- ─────────────── Multi-Agent ─────────────── --> -## Multi-Agent — separating the builder from the verifier +## Multi-Agent — yours to run, cladding's to judge -Keeping the agents that **build** apart from the agents that **verify** — so no agent signs off on its own work — is a **declared outcome condition here, not a pipeline cladding runs for you.** cladding *judges* it from the record: every completion you take through `clad done` / `clad verdict` is labeled `independent` or `self-certified`, reporting what the recorded evidence shows — whether an independent or human review signed off, not whether the code is right. The label makes that visible; it doesn't block on its own. A team that wants teeth sets `independence_policy: require` in `spec.yaml`, and self-certified completions are refused. +cladding is not a multi-agent framework: it never spawns, routes, or coordinates agents, and it neither prescribes nor sees how many there are. What it owns is smaller and sharper — whether the builder and the verifier were actually separate, on the record. -How the agents run — how many, which models, how much in parallel — is the **host's** decision. cladding ships role briefs (planner, developer, reviewer, observability, blind-author) the host can embody with any agent shape; it never prescribes spawning. **blind-author** is the sharpest of them: the agent that writes the tests literally *can't read the code* (it's given no Read/Grep tool), so "wrote the tests without looking at the code" is a fact about how it's wired, not a promise. It's the same **separation of duties** that audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. +The same project can ship three features three different ways: -<div align="center"> - -<img src="docs/img/en/multi-agent.svg" alt="Separation of duties — the roles are kept separate so no agent signs off on its own work, and every completion is labeled independent or self-certified from the recorded evidence; the host decides how the agents run" width="700"> +- one agent builds, tests, and reviews — labeled `self-certified` +- a second agent writes the tests from the spec alone (it has no tool to read the code) — labeled `independent` +- a person signs off the review — labeled `independent` -</div> +The label on `clad done` / `clad verdict` reports what each completion's recorded evidence shows — never which agents did the work, how many, or whose. It doesn't block on its own; teams that want teeth set `independence_policy: require` in `spec.yaml`, and self-certified completions are refused. The role briefs (planner · developer · reviewer · observability · blind-author) stay optional manuals for cladding's touchpoints, not a fixed cast. It's the same separation of duties audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. <!-- ─────────────── Ecosystem ─────────────── --> @@ -354,7 +354,7 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 stages · 41 detectors | 261 (258 done) | <sub>236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector</sub> diff --git a/README.zh.md b/README.zh.md index 5ad4e7bb..0bee9613 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@ <p align="center"> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/ironclad-L4%20conformant-brightgreen" alt="ironclad"/></a> <a href="https://github.com/qwerfunch/ironclad"><img src="https://img.shields.io/badge/spec-v0.0.23-blue" alt="spec"/></a> - <img src="https://img.shields.io/badge/tests-2715%2F2715-brightgreen" alt="tests"/> + <img src="https://img.shields.io/badge/tests-2710%2F2710-brightgreen" alt="tests"/> <img src="https://img.shields.io/badge/detectors-41-brightgreen" alt="detectors"/> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="license"/></a> </p> @@ -204,17 +204,17 @@ acceptance_criteria: <!-- ─────────────── Multi-Agent ─────────────── --> -## Multi-Agent —— 把建造者与验证者分开 +## Multi-Agent —— 怎么跑由你，怎么判由 cladding -把负责**建造**的智能体和负责**验证**的智能体隔开、让没有哪个智能体能给自己的活儿盖章放行 —— 这不是 cladding 替你运行的一条流水线，而是一个**声明出来的结果条件**。cladding 依据记录来**判定**它：每一次经 `clad done` / `clad verdict` 完成的收尾，都会被打上 `independent` 或 `self-certified` 标签，它表示的不是代码是否正确，而是**记录在案的证据所显示的情况** —— 是否有过独立评审或人工签署。标签只是把这一点显现出来，本身并不拦截。想要强制的团队，可在 `spec.yaml` 里设 `independence_policy: require`，于是 self-certified 的收尾会被拒绝。 +cladding 不是一个多智能体框架：它从不 spawn、路由或协调智能体，也不规定、更看不到到底有几个。它掌管的东西更小也更锋利 —— 建造者和验证者是否真的分开了，并把这一点记录在案。 -用几个智能体、哪种模型、并行到什么程度，都由**宿主**决定。cladding 只提供角色简介（planner · developer · reviewer · observability · blind-author），无论你用什么形态的智能体去承载它，都不会指定该如何 spawn。其中最锋利的是 **blind-author** —— 撰写测试的那个智能体*根本读不到代码*（不授予它 Read/Grep 工具），于是「没读代码就写出了测试」不是一句承诺，而是它接线方式带来的结构性事实。这正是审计规范（EU AI Act · SOX）所要求的那种**职责分离** —— 说的是精神上相符，而不是一纸认证。 +同一个项目，可以用三种不同的方式交付三个 feature： -<div align="center"> - -<img src="docs/img/zh/multi-agent.svg" alt="职责分离 —— 把角色分开，任何智能体都无法给自己的工作盖章放行；每一次收尾都依据记录在案的证据被标为 independent 或 self-certified；智能体如何运行由宿主决定" width="700"> +- 一个智能体又建造、又测试、又评审 —— 标为 `self-certified` +- 第二个智能体只凭规格写测试（它没有读代码的工具） —— 标为 `independent` +- 由人来签署评审 —— 标为 `independent` -</div> +`clad done` / `clad verdict` 上的标签，只报告每一次收尾记录在案的证据所显示的情况 —— 从不涉及是哪些智能体、用了几个、出自谁手。它本身并不拦截；想要强制的团队，可在 `spec.yaml` 里设 `independence_policy: require`，于是 self-certified 的收尾会被拒绝。角色简介（planner · developer · reviewer · observability · blind-author）只是 cladding 各接触点的可选手册，而非一份固定的班底。这正是 EU AI Act、SOX 这类审计规范所要求的那种职责分离 —— 说的是精神相符，而不是一纸认证。 <!-- ─────────────── Ecosystem ─────────────── --> @@ -337,7 +337,7 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2715 / 2715 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 阶段 · 41 检测器 | 261（258 done） | <sub>236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下</sub> diff --git a/docs/img/en/multi-agent.svg b/docs/img/en/multi-agent.svg deleted file mode 100644 index 434995e0..00000000 --- a/docs/img/en/multi-agent.svg +++ /dev/null @@ -1,98 +0,0 @@ -<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 724 456" width="724" height="456" role="img" aria-labelledby="multi-agent-title" font-family="-apple-system,'Apple SD Gothic Neo','Noto Sans KR',sans-serif"> - <title id="multi-agent-title">Agent separation of duties — the builder and the verifier are kept separate so no agent signs off on its own work; every completion is labeled independent or self-certified from the recorded evidence, and the host decides how the agents run (anti-self-cert). - - - - - - - - - - Agent Separation of Duties - - Aligns with the segregation-of-duties principle behind EU AI Act · SOX - - - - host - Runs agents — count · models · parallel - - - - - - - - - - - - - planner - ▸ Writes spec - SSoT owner - - - - - developer - ▸ Writes code - Impl · tests - - - - - reviewer - ▸ Audit · approve - Independent · read-only - - - - - blind-author - ▸ Test author - ▸ Impl-blind - No Read/Grep - - - - - - - - - - - - - cladding - ▸ Gates — done is earned - ▸ Label — independent | self-certified - - - - - No self-certification - ▸ Author ≠ verifier - anti-self-cert invariant - - - Done is earned only by passing every gate — proof in attestation.yaml - diff --git a/docs/img/ja/multi-agent.svg b/docs/img/ja/multi-agent.svg deleted file mode 100644 index 56b06a22..00000000 --- a/docs/img/ja/multi-agent.svg +++ /dev/null @@ -1,98 +0,0 @@ - - エージェントの役割分離 — 役割を分けてどのエージェントも自分の仕事を自分で承認できず、すべての完了は記録された証拠に基づき independent か self-certified のラベルが付く。エージェントの走らせ方はホストが決める (anti-self-cert)。 - - - - - - - - - - エージェントの役割分離 - - EU AI Act · SOX が求める職務分離の原則と重なる - - - - host - エージェント実行 — 数 · モデル · 並列 - - - - - - - - - - - - - planner - ▸ spec を作成 - SSoT 管理者 - - - - - developer - ▸ コード作成 - 実装 · テスト - - - - - reviewer - ▸ 監査 · 承認 - 独立監査 (読み取り専用) - - - - - blind-author - ▸ テスト作成者 - ▸ 実装は見えない - Read/Grep なし - - - - - - - - - - - - - cladding - ▸ ゲート — 完了は勝ち取る - ▸ ラベル — independent | self-certified - - - - - 自己承認の禁止 - ▸ 作る者 ≠ 検証する者 - anti-self-cert 不変条件 - - - 完了は全ゲート通過でのみ獲得 — 証拠は attestation.yaml - diff --git a/docs/img/ko/multi-agent.svg b/docs/img/ko/multi-agent.svg deleted file mode 100644 index 79272dda..00000000 --- a/docs/img/ko/multi-agent.svg +++ /dev/null @@ -1,98 +0,0 @@ - - 에이전트 역할 분리 — 역할을 분리해 어떤 에이전트도 자기 작업을 스스로 승인하지 못하고, 모든 완료는 기록된 근거에 따라 independent 또는 self-certified 라벨이 붙는다. 에이전트를 어떻게 돌릴지는 호스트가 정한다 (anti-self-cert). - - - - - - - - - - 에이전트 역할 분리 - - EU AI Act · SOX가 요구하는 직무 분리 원칙과 맞닿는다 - - - - host - 에이전트 실행 — 개수 · 모델 · 병렬성 - - - - - - - - - - - - - planner - ▸ spec 작성 - SSoT 관리자 - - - - - developer - ▸ 코드 작성 - 구현 · 테스트 - - - - - reviewer - ▸ 감사 · 승인 - 독립 감사자 (읽기전용) - - - - - blind-author - ▸ 테스트 작성자 - ▸ 구현 못 봄 - Read/Grep 미부여 - - - - - - - - - - - - - cladding - ▸ 게이트 — 완료는 얻는 것 - ▸ 라벨 — independent | self-certified - - - - - 자기 승인 금지 - ▸ 만드는 자 ≠ 검증하는 자 - anti-self-cert 불변식 - - - 완료는 검증 관문 전체 통과로만 획득 — 검증 기록은 attestation.yaml - diff --git a/docs/img/zh/multi-agent.svg b/docs/img/zh/multi-agent.svg deleted file mode 100644 index 7954bffa..00000000 --- a/docs/img/zh/multi-agent.svg +++ /dev/null @@ -1,98 +0,0 @@ - - Agent 职责分离 — 把角色分开，任何 agent 都无法给自己的工作盖章放行；每一次收尾都依据记录在案的证据被标为 independent 或 self-certified；agent 如何运行由宿主决定（anti-self-cert）。 - - - - - - - - - - Agent 职责分离 - - 契合 EU AI Act · SOX 背后的职责分离原则 - - - - host - 运行 agent — 数量 · 模型 · 并行 - - - - - - - - - - - - - planner - ▸ 编写 spec - SSoT 管理者 - - - - - developer - ▸ 编写代码 - 实现 · 测试 - - - - - reviewer - ▸ 审计 · 批准 - 独立审计者 (只读) - - - - - blind-author - ▸ 测试编写者 - ▸ 看不到实现 - 未授予 Read/Grep - - - - - - - - - - - - - cladding - ▸ 关卡 — 完成靠赢得 - ▸ 标签 — independent | self-certified - - - - - 禁止自我认证 - ▸ 构建者 ≠ 验证者 - anti-self-cert 不变式 - - - 完成只能靠通过全部关卡赢得 — 验证记录见 attestation.yaml - diff --git a/spec.yaml b/spec.yaml index d3aa785c..02d0958a 100644 --- a/spec.yaml +++ b/spec.yaml @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 269 + features: 270 scenarios: 2 capabilities: 6 test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index 551b7ca7..d2ede17e 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: a5dcb1c7f06cffaf - README.ja.md: eb269dbdc4799287 - README.ko.html: 5799c10feebfbef9 - README.ko.md: 6804e651e435a932 - README.md: f4ca5b9e77bca21d - README.zh.md: 3ff55eccf72ddb86 + README.html: a67f690654f58b76 + README.ja.md: ead9e640228c48b5 + README.ko.html: d1f44fbb0570dcbc + README.ko.md: 01f559a5544cc0f2 + README.md: 86e82b671a4b00c4 + README.zh.md: 7468d02ccc3c638b SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -58,13 +58,9 @@ attested_modules: docs/feature-cycle.md: e1847cc9fe9b6eb6 docs/glossary.md: 9e897b963c3aa88f docs/img/en/ecosystem.svg: ed14d1d17f088b00 - docs/img/en/multi-agent.svg: 24179b55e3d58bb0 docs/img/en/relationship.svg: c7a24203925b4664 - docs/img/ja/multi-agent.svg: d7118d0c7e9ad0ef docs/img/ko/ecosystem.svg: 2b7341576c2af0a8 - docs/img/ko/multi-agent.svg: b56c9e44e069c042 docs/img/ko/relationship.svg: 9ec8fb2254978f37 - docs/img/zh/multi-agent.svg: 9b381f616a10f1f8 docs/multi-provider-roadmap.md: 1e5cf27ea1b18d06 docs/refinement-backlog.md: 3e38d60bf987eef1 docs/setup.md: a5c062651d267983 @@ -117,7 +113,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: 019625b441b6478b + spec.yaml: 14bbfc4556854fbb spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -563,7 +559,6 @@ attested_features: F-417ff0: ok F-42af48: ok F-43d8e3: ok - F-4498eb3d: ok F-4643d99d: ok F-4747ef: ok F-47b8bee5: ok @@ -608,6 +603,7 @@ attested_features: F-803386ab: ok F-80d19d: ok F-836a90: ok + F-8476ccb1: ok F-876b6f48: ok F-898783ee: ok F-8f419e: ok diff --git a/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml b/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml index b72c5eeb..dd981d7d 100644 --- a/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml +++ b/spec/features/multi-agent-diagram-role-contract-4498eb3d.yaml @@ -1,12 +1,11 @@ id: F-4498eb3d slug: multi-agent-diagram-role-contract title: "Multi-agent diagram draws the role contract, not an orchestrator hub" -status: done -modules: - - docs/img/en/multi-agent.svg - - docs/img/ko/multi-agent.svg - - docs/img/ja/multi-agent.svg - - docs/img/zh/multi-agent.svg +status: archived +archived_at: "2026-07-25T00:00:00Z" +archive_reason: "Superseded by readme-multiagent-inversion (F-8476ccb1): after four diagram drafts (org-chart relabel, contract-boundary, host-frame roster, three-shapes contrast) the user chose a prose-only Multi-Agent section — the three-shapes contrast moved into the README text and the four locale multi-agent.svg files were removed." +superseded_by: F-8476ccb1 +modules: [] acceptance_criteria: - id: AC-4a195d3a ears: ubiquitous diff --git a/spec/features/readme-multiagent-inversion-8476ccb1.yaml b/spec/features/readme-multiagent-inversion-8476ccb1.yaml new file mode 100644 index 00000000..de5a64a9 --- /dev/null +++ b/spec/features/readme-multiagent-inversion-8476ccb1.yaml @@ -0,0 +1,32 @@ +id: F-8476ccb1 +slug: readme-multiagent-inversion +title: "README multi-agent section inverts the frame in prose alone: yours to run, cladding's to judge" +status: done +modules: + - README.md + - README.ko.md + - README.ja.md + - README.zh.md + - README.html + - README.ko.html +acceptance_criteria: + - id: AC-111fb976 + ears: ubiquitous + text: "The Multi-Agent section shall open by denying the old identity — cladding is not a multi-agent framework and neither prescribes nor sees the host's agent topology — and ground the separation claim in the evidence-judged independence label." + response: "README.md Multi-Agent slice contains the literal 'not a multi-agent framework'; EN/KO slices keep 'independent' and 'self-certified'; no variant slice matches /dispatch/i" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-7d433517 + ears: ubiquitous + text: "The section shall carry the story in prose alone — no embedded diagram; the three-shapes contrast (one agent does everything; a blind test author; a human reviewer — each completion labeled for its own record) lives as a compact list in the text." + response: "no README variant matches /multi-agent\\.svg/; the EN slice presents the three-shape contrast as a list" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-a1692ed7 + ears: ubiquitous + text: "Every prior README pin shall survive the inversion — the Multi-Agent heading token and its position after the loop section, the hedged EU AI Act sentence in the four EN/KO variants, and the detector/stage count literals." + response: "readme-loop-section, readme-record-honesty and self-consistency suites stay green" + test_refs: ["tests/readme-loop-section.test.ts", "tests/readme-record-honesty.test.ts", "tests/self-consistency.test.ts"] +design_impact: + classification: none + rationale: "Documentation-layer inversion, prose-only by user decision after four diagram drafts: the section stops resembling a multi-agent team cladding ships; the superseded diagram feature (F-4498eb3d) is archived and its locale SVGs removed. No engine changes." + status: resolved + artifacts: [] diff --git a/spec/index.yaml b/spec/index.yaml index c390babd..5e574abd 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -130,7 +130,7 @@ features: F-417ff0: {slug: scan-llm-dispatcher-chain, status: done, modules: 5} F-42af48: {slug: architecture-from-spec, status: done, modules: 2} F-43d8e3: {slug: smoke-probe-token-pass, status: done, modules: 3} - F-4498eb3d: {slug: multi-agent-diagram-role-contract, status: done, modules: 4} + F-4498eb3d: {slug: multi-agent-diagram-role-contract, status: archived, modules: 0} F-4643d99d: {slug: lint-multi-finding, status: done, modules: 3} F-4747ef: {slug: ssot-lifecycle-tests, status: done, modules: 9} F-47b8bee5: {slug: ts-toolchain-jest-and-multiext-arch, status: done, modules: 1} @@ -176,6 +176,7 @@ features: F-80d19d: {slug: setup-command, status: done, modules: 5} F-8234ec3c: {slug: graph-viewer-galaxy, status: archived, modules: 0} F-836a90: {slug: link-capability-tool, status: done, modules: 2} + F-8476ccb1: {slug: readme-multiagent-inversion, status: done, modules: 6} F-876b6f48: {slug: shard-term-to-spec-entry, status: done, modules: 7} F-898783ee: {slug: self-count-guard, status: done, modules: 17} F-8f419e: {slug: smoke-legacy-liveness, status: done, modules: 1} diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts index dd27941e..d2a2a4b7 100644 --- a/tests/choreography-guard.test.ts +++ b/tests/choreography-guard.test.ts @@ -259,49 +259,38 @@ describe('README Multi-Agent section speaks the role contract, not choreography }); }); -// F-4498eb3d — the localized multi-agent.svg diagrams draw the role -// contract, not an orchestrator dispatching workers. The diagram's hub used -// to be an "orchestrator" box with a "" authoring comment; both the rendered word and the comment are -// now GONE by design (the hub is "host", which runs the role briefs — see -// the impl report). Since the choreography vocabulary must be absent -// EVERYWHERE (rendered text and authoring comments alike), these checks run -// against the whole raw file — no comment-stripping. -describe('localized multi-agent.svg diagrams draw the role contract (F-4498eb3d)', () => { - const SVGS: readonly string[] = [ - 'docs/img/en/multi-agent.svg', - 'docs/img/ko/multi-agent.svg', - 'docs/img/ja/multi-agent.svg', - 'docs/img/zh/multi-agent.svg', - ]; - - describe('AC-4a195d3a — no dispatch/orchestrator story anywhere, comments included', () => { - for (const f of SVGS) { - test(`${f}: whole file matches no /dispatch/i`, () => { - const raw = repoRead(f); - expect(raw, `${f}: must not match /dispatch/i anywhere, comments included`).not.toMatch(/dispatch/i); - }); - - test(`${f}: whole file matches no /orchestrat/i`, () => { - const raw = repoRead(f); - expect(raw, `${f}: must not match /orchestrat/i anywhere, comments included`).not.toMatch(/orchestrat/i); - }); - } +// F-8476ccb1 — README Multi-Agent section inverts the frame in prose alone: +// yours to run, cladding's to judge. Supersedes F-4498eb3d (now archived): +// the four docs/img//multi-agent.svg diagrams are deleted, and the +// three-shape contrast that used to live in the diagram now lives as a +// compact prose list. This block replaces the former SVG-guard describe +// ('localized multi-agent.svg diagrams draw the role contract (F-4498eb3d)') +// which asserted against files that no longer exist. +describe('README Multi-Agent section carries the inversion in prose alone (F-8476ccb1)', () => { + describe('AC-111fb976 — opens by denying the old identity', () => { + test('README.md: Multi-Agent slice contains "not a multi-agent framework"', () => { + const slice = multiAgentSliceOf('README.md'); + expect(slice, 'README.md: Multi-Agent slice must contain "not a multi-agent framework"').toContain( + 'not a multi-agent framework', + ); + }); }); - describe('AC-4c5b1cc6 — the convergence point carries the independence label', () => { - for (const f of SVGS) { - test(`${f}: contains both "independent" and "self-certified"`, () => { - const raw = repoRead(f); - expect(raw, `${f}: must contain "independent"`).toContain('independent'); - expect(raw, `${f}: must contain "self-certified"`).toContain('self-certified'); + describe('AC-7d433517 — the story carries in prose alone, no embedded diagram', () => { + for (const f of README_VARIANTS) { + test(`${f}: does not match /multi-agent\\.svg/`, () => { + const body = repoRead(f); + expect(body, `${f}: must not match /multi-agent\\.svg/`).not.toMatch(/multi-agent\.svg/); }); } - test('docs/img/en/multi-agent.svg: contains "host" and "cladding"', () => { - const raw = repoRead('docs/img/en/multi-agent.svg'); - expect(raw, 'en file must contain "host"').toContain('host'); - expect(raw, 'en file must contain "cladding"').toContain('cladding'); + test('README.md: Multi-Agent slice presents the three-shape contrast as a list (>= 3 lines starting with "- ")', () => { + const slice = multiAgentSliceOf('README.md'); + const listLines = slice.split('\n').filter((line) => line.startsWith('- ')); + expect( + listLines.length, + 'README.md: Multi-Agent slice must contain at least 3 lines starting with "- "', + ).toBeGreaterThanOrEqual(3); }); }); }); From ebd3a005a14b09f38d47e19870594d6cae127f4d Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Sat, 25 Jul 2026 10:21:51 +0900 Subject: [PATCH 10/13] docs(readme): lead the Multi-Agent section with purpose, not denial (F-8476ccb1 follow-up) Paragraph 1 across all 6 variants now opens with what cladding is FOR - "one job: make every done trustworthy," judging verifier independence from recorded evidence - and demotes the not-a-multi-agent-framework denial to a subordinate clause. All guard pins unchanged and green; strict pre-push gate GREEN. Co-Authored-By: Claude Fable 5 --- README.html | 2 +- README.ja.md | 2 +- README.ko.html | 2 +- README.ko.md | 2 +- README.md | 2 +- README.zh.md | 2 +- spec/attestation.yaml | 12 ++++++------ 7 files changed, 12 insertions(+), 12 deletions(-) diff --git a/README.html b/README.html index dc37f11d..32e64872 100644 --- a/README.html +++ b/README.html @@ -455,7 +455,7 @@

Detectors — 41 drift detectors

Multi-Agent — yours to run, cladding's to judge

- cladding is not a multi-agent framework: it never spawns, routes, or coordinates agents, and it neither prescribes nor sees how many there are. What it owns is smaller and sharper — whether the builder and the verifier were actually separate, on the record. + Here cladding has one job: make every done trustworthy — it judges, from recorded evidence, whether the verifier was independent of the author, and labels each completion accordingly. How the agents run is entirely yours: one or many, any models, any host — cladding is not a multi-agent framework and never spawns, routes, or coordinates them.

The same project can ship three features three different ways:

    diff --git a/README.ja.md b/README.ja.md index 1fdefe06..e253ff08 100644 --- a/README.ja.md +++ b/README.ja.md @@ -210,7 +210,7 @@ acceptance_criteria: ## Multi-Agent — 走らせるのはあなた、判定するのは cladding -cladding はマルチエージェント・フレームワークではない。エージェントをスポーンも、ルーティングも、調整もしないし、何個走るかを指示することも見ることもない。cladding が握っているのはもっと小さく鋭いもの — 作る側と検証する側が実際に分かれていたか、を記録に残すことだ。 +ここで cladding の仕事は一つ: すべての `done` を信頼できるものにすることだ — 記録された証拠から、検証する側が作る側から独立していたかを判定し、各完了にそれに応じたラベルを付ける。エージェントをどう走らせるかは完全にあなた次第だ: 一つでも複数でも、どんなモデルでも、どんなホストでも — cladding はマルチエージェント・フレームワークではなく、エージェントをスポーンも、ルーティングも、調整もしない。 同じプロジェクトが、三つの feature を三通りのやり方で出荷できる： diff --git a/README.ko.html b/README.ko.html index f096c516..37d720d5 100644 --- a/README.ko.html +++ b/README.ko.html @@ -490,7 +490,7 @@

    내부 동작

    Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding

    - cladding은 멀티에이전트 프레임워크가 아니다: 에이전트를 스폰하거나 라우팅하거나 조율하지 않고, 몇 개가 도는지 지시하지도 보지도 않는다. cladding이 쥐고 있는 건 더 작고 더 날카롭다 — 만드는 자와 검증하는 자가 실제로 분리돼 있었는지를, 기록으로 남기는 것. + 여기서 cladding의 일은 하나다: 모든 done을 믿을 수 있게 만드는 것 — 기록된 근거로부터 검증하는 자가 만드는 자와 독립적이었는지를 판정하고, 각 완료에 그에 맞는 라벨을 붙인다. 에이전트를 어떻게 돌릴지는 전적으로 당신 몫이다: 하나든 여럿이든, 어떤 모델이든, 어떤 호스트든 — cladding은 멀티에이전트 프레임워크가 아니며 에이전트를 스폰하거나 라우팅하거나 조율하지 않는다.

    같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다:

      diff --git a/README.ko.md b/README.ko.md index aa7f0224..2eaf5323 100644 --- a/README.ko.md +++ b/README.ko.md @@ -209,7 +209,7 @@ acceptance_criteria: ## Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding -cladding은 멀티에이전트 프레임워크가 아니다: 에이전트를 스폰하거나 라우팅하거나 조율하지 않고, 몇 개가 도는지 지시하지도 보지도 않는다. cladding이 쥐고 있는 건 더 작고 더 날카롭다 — 만드는 자와 검증하는 자가 실제로 분리돼 있었는지를, 기록으로 남기는 것. +여기서 cladding의 일은 하나다: 모든 `done`을 믿을 수 있게 만드는 것 — 기록된 근거로부터 검증하는 자가 만드는 자와 독립적이었는지를 판정하고, 각 완료에 그에 맞는 라벨을 붙인다. 에이전트를 어떻게 돌릴지는 전적으로 당신 몫이다: 하나든 여럿이든, 어떤 모델이든, 어떤 호스트든 — cladding은 멀티에이전트 프레임워크가 아니며 에이전트를 스폰하거나 라우팅하거나 조율하지 않는다. 같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다: diff --git a/README.md b/README.md index faef69fe..2d2cce44 100644 --- a/README.md +++ b/README.md @@ -206,7 +206,7 @@ One feature's lifecycle runs **Define → Sync → Implement → Earn** — you ## Multi-Agent — yours to run, cladding's to judge -cladding is not a multi-agent framework: it never spawns, routes, or coordinates agents, and it neither prescribes nor sees how many there are. What it owns is smaller and sharper — whether the builder and the verifier were actually separate, on the record. +Here cladding has one job: make every `done` trustworthy — it judges, from recorded evidence, whether the verifier was independent of the author, and labels each completion accordingly. How the agents run is entirely yours: one or many, any models, any host — cladding is not a multi-agent framework and never spawns, routes, or coordinates them. The same project can ship three features three different ways: diff --git a/README.zh.md b/README.zh.md index 0bee9613..2d0c01b5 100644 --- a/README.zh.md +++ b/README.zh.md @@ -206,7 +206,7 @@ acceptance_criteria: ## Multi-Agent —— 怎么跑由你，怎么判由 cladding -cladding 不是一个多智能体框架：它从不 spawn、路由或协调智能体，也不规定、更看不到到底有几个。它掌管的东西更小也更锋利 —— 建造者和验证者是否真的分开了，并把这一点记录在案。 +在这里，cladding 只有一件事：让每一次 `done` 都值得信赖 —— 它依据记录在案的证据，判定验证者是否独立于建造者，并据此给每一次收尾打上标签。智能体怎么跑，完全由你决定：一个还是多个、哪种模型、哪个宿主都行 —— cladding 不是一个多智能体框架，也从不 spawn、路由或协调它们。 同一个项目，可以用三种不同的方式交付三个 feature： diff --git a/spec/attestation.yaml b/spec/attestation.yaml index d2ede17e..f2ce4bc7 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: a67f690654f58b76 - README.ja.md: ead9e640228c48b5 - README.ko.html: d1f44fbb0570dcbc - README.ko.md: 01f559a5544cc0f2 - README.md: 86e82b671a4b00c4 - README.zh.md: 7468d02ccc3c638b + README.html: e40e74799ed43198 + README.ja.md: b1e12755ee78a7db + README.ko.html: d2e2d8475781823e + README.ko.md: 0351e20595f77867 + README.md: 887dcdc61e4496e2 + README.zh.md: 3c8c204ecefe1775 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 From 1b34e9e7139f01113743c0b3d1c07af687832fe3 Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Sun, 26 Jul 2026 00:45:51 +0900 Subject: [PATCH 11/13] docs(readme): Multi-Agent leads with the stake and draws the label decision (F-3fd220d8) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The section explained what the independence label is and how it is earned, but never why a reader should care, so it read as "a word gets attached to my feature — so what". It now opens with the stake: one AI writing both the code and its tests produces a green run that proves nothing. The three examples move to problem → problem → way out, so the list closes on `independent`, and each carries its own reason instead of deferring to a paragraph below. The two `self-certified` cases sit adjacent with the second marked as sharing the label, which is what stops three examples against two labels from reading as a contradiction. A locale diagram returns at docs/img//independence.svg. It draws the label decision — host band, one question, two outcomes, and the refusal a require policy adds — never a roster of agents; that is why the four earlier multi-agent.svg drafts were retired, and the invariant against restoring them is untouched. AC-7d433517 of F-8476ccb1 is reworded to state that invariant rather than a blanket no-diagram rule. Also corrects stale counts the version-bump script does not cover: 255/252 → 270/266 features, 236 → 248 test files. Guards test the intent, not the wording: the stake precedes the list, the two self-certified items are adjacent and marked, and the list ends on independent. Co-Authored-By: Claude Opus 5 --- README.html | 51 +++--- README.ja.md | 28 ++-- README.ko.html | 53 ++++--- README.ko.md | 30 ++-- README.md | 28 ++-- README.zh.md | 28 ++-- docs/img/en/independence.svg | 85 ++++++++++ docs/img/ja/independence.svg | 85 ++++++++++ docs/img/ko/independence.svg | 85 ++++++++++ docs/img/zh/independence.svg | 85 ++++++++++ spec/_doc-links.yaml | 4 +- .../readme-multiagent-inversion-8476ccb1.yaml | 4 +- ...dme-multiagent-label-diagram-3fd220d8.yaml | 62 ++++++++ tests/choreography-guard.test.ts | 146 +++++++++++++++++- 14 files changed, 687 insertions(+), 87 deletions(-) create mode 100644 docs/img/en/independence.svg create mode 100644 docs/img/ja/independence.svg create mode 100644 docs/img/ko/independence.svg create mode 100644 docs/img/zh/independence.svg create mode 100644 spec/features/readme-multiagent-label-diagram-3fd220d8.yaml diff --git a/README.html b/README.html index 32e64872..d4ec8110 100644 --- a/README.html +++ b/README.html @@ -132,6 +132,8 @@ gap: 16px; margin: 24px 0; } + /* the before · after pair */ + .flow-cards.two { grid-template-columns: repeat(2, 1fr); } .flow-card { border-radius: 12px; padding: 20px 22px; @@ -212,7 +214,7 @@ .container { padding: 32px 16px 64px; } h1 { font-size: 40px; } h2 { font-size: 24px; margin-top: 48px; } - .flow-cards { grid-template-columns: 1fr; } + .flow-cards, .flow-cards.two { grid-template-columns: 1fr; } table { font-size: 13px; } th, td { padding: 10px 12px; } } @@ -233,7 +235,7 @@

      cladding

      ironclad spec - tests + tests detectors license

      @@ -269,7 +271,7 @@

      cladding

      - cladding builds itself with cladding too — 252 of its 255 features cleared this same gate, the first L4 implementation of the Ironclad standard. + cladding builds itself with cladding too — 266 of its 270 features cleared this same gate, the first L4 implementation of the Ironclad standard.

      @@ -300,7 +302,7 @@

      Who it's for

      How cladding wraps your host LLM

      -
      +
      BEFORE — INJECT INTENT
      So the LLM starts with the right context
      @@ -310,9 +312,15 @@

      How cladding wraps your host LLM

    • Team rules applied — the forbidden and preferred patterns you agreed on, as standing instructions every time
    +
    + AFTER — VERIFY THE RESULT +
    So the work is checked against the spec
    +
      +
    • The 15-stage gate and 41 drift detectors — nothing counts as done until they pass
      • +
    • An implementation-blind grader — an agent that checks the work against the spec with no tool to read the implementation, so it can't rubber-stamp what it wrote
      • +
    +
    - -

    After — verify the result: the 15-stage gate, 41 drift detectors, and an implementation-blind grader — an agent that checks the work against the spec with no tool to read the implementation, so it can't rubber-stamp what it wrote.

    Real-time intervention (map injection · instant block · stop block) runs fully on Claude Code. On Codex · Gemini · Antigravity · Cursor the same verification runs through in-conversation tool calls plus the git · CI gate. @@ -453,18 +461,25 @@

    Detectors — 41 drift detectors

    One feature's lifecycle runs Define → Sync → Implement → Earn — you earn done only by passing every check.

    -

    Multi-Agent — yours to run, cladding's to judge

    +

    Multi-Agent

    - Here cladding has one job: make every done trustworthy — it judges, from recorded evidence, whether the verifier was independent of the author, and labels each completion accordingly. How the agents run is entirely yours: one or many, any models, any host — cladding is not a multi-agent framework and never spawns, routes, or coordinates them. + Hand the code to an AI and you usually hand it the tests too. But when the same AI writes both, the tests get shaped around the code it just wrote. The bug is there and the tests still pass. A green run that proves nothing.

    -

    The same project can ship three features three different ways:

    +

    + So cladding asks one thing of every finished feature: were the building and the checking done by different hands? The answer goes on the record with the completion. (How many agents run, and how, is the host's call — cladding is not a multi-agent framework and doesn't arrange them.) +

    + +
    + How a finished feature gets its mark — the host runs the agents (how many, which models, which tool); cladding asks whether anything checked the work without seeing the code, and marks the completion independent or self-certified. By default nothing is blocked; only an independence_policy of require turns a self-certified mark into a refusal. +
    +
      -
    • one agent builds, tests, and reviews — labeled self-certified
      • -
    • a second agent writes the tests from the spec alone (it has no tool to read the code) — labeled independent
      • -
    • a person signs off the review — labeled independent
      • +
    • one agent built it, tested it, and passed its own work — self-certified. It can shape the tests around the code it just wrote, so passing isn't checking.
      • +
    • nobody checked it separately — self-certified as well. It isn't a mark against the work; it means no separate check is on record.
      • +
    • another agent wrote the tests from the spec, with no way to open the code — independent. It never saw the bug, so it can't shape a test around one — what decides the label is what that agent could open, not what anyone promised.

    - The label on clad done / clad verdict reports what each completion's recorded evidence shows — never which agents did the work, how many, or whose. It doesn't block on its own; teams that want teeth set independence_policy: require in spec.yaml, and self-certified completions are refused. The role briefs (planner · developer · reviewer · observability · blind-author) stay optional manuals for cladding's touchpoints, not a fixed cast. It's the same separation of duties audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. + Keep the building and the checking in different hands. It's the same approach as the separation of duties that audit rules like the EU AI Act and SOX ask for — close in spirit, not a certification.

    @@ -541,7 +556,7 @@

    Status

    version
    -
    v0.9.0
    +
    v0.9.2
    2026-07
    @@ -551,7 +566,7 @@

    Status

    tests
    -
    2710/2710
    +
    2736/2736
    all pass
    @@ -561,13 +576,13 @@

    Status

    features
    -
    261
    -
    258 done · self-spec
    +
    270
    +
    266 done · self-spec
    -

    236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector

    +

    248 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector

    Road to Ironclad 1.0 — 1.0 locks only when two independent implementations pass the L4 conformance fixtures (GOVERNANCE § 1). cladding is the first.
    diff --git a/README.ja.md b/README.ja.md index e253ff08..c9f552db 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@

    ironclad spec - tests + tests detectors license

    @@ -31,7 +31,7 @@ - **たどれる** — **出荷されたものは記録に残る**: 何を検証したかはコミットされた内容に刻まれ、誰がいつやったかはローカルのセッション台帳に、なぜかは spec に残る — だから引き継ぎもレビューも、掘り起こさずに済む。 - **拡張しても揺るがない** — 人と AI が増えれば、普通は衝突と乖離も増える。だが全員が一つの spec を基準に働くので、それらは自動でせき止められる — だから規模を広げても崩れない。 -cladding は **自分自身も cladding で作っている** — 255 個の feature のうち 252 個が同じゲートを通過した、[Ironclad](https://github.com/qwerfunch/ironclad) 標準を L4 で実装した最初の事例だ。 +cladding は **自分自身も cladding で作っている** — 270 個の feature のうち 266 個が同じゲートを通過した、[Ironclad](https://github.com/qwerfunch/ironclad) 標準を L4 で実装した最初の事例だ。 @@ -208,17 +208,23 @@ acceptance_criteria: -## Multi-Agent — 走らせるのはあなた、判定するのは cladding +## Multi-Agent -ここで cladding の仕事は一つ: すべての `done` を信頼できるものにすることだ — 記録された証拠から、検証する側が作る側から独立していたかを判定し、各完了にそれに応じたラベルを付ける。エージェントをどう走らせるかは完全にあなた次第だ: 一つでも複数でも、どんなモデルでも、どんなホストでも — cladding はマルチエージェント・フレームワークではなく、エージェントをスポーンも、ルーティングも、調整もしない。 +AI にコードを任せれば、たいていテストも一緒に任せることになる。だが同じ AI が両方を書けば、テストは自分が書いたコードに合わせて形づくられる。バグがあってもテストは通る。**緑が何も証明しない状態**だ。 -同じプロジェクトが、三つの feature を三通りのやり方で出荷できる： +だから cladding は、終わった feature ごとに一つだけ問う: **作った側と確かめた側は、別だったか？** その答えを完了とともに記録に残す。（エージェントを何個どう走らせるかはホストが決める — cladding はマルチエージェント・フレームワークではなく、エージェントを並べることはしない。） -- 一つのエージェントが作り、テストし、レビューする — `self-certified` と表示 -- 二つ目のエージェントが仕様だけを見てテストを書く（コードを読む手段がない） — `independent` と表示 -- 人間がレビューを承認する — `independent` と表示 +
    + +完了した feature に印が付く仕組み — エージェントを走らせるのはホスト（何個、どのモデル、どのツール）で、cladding はコードを見ていない何かが確かめたかを問い、完了に independent または self-certified を残す。既定では何もブロックせず、independence_policy を require にしたときだけ self-certified が拒否に変わる。 + +
    + +- 一つのエージェントが作り、テストし、自分の仕事を自分で通した — `self-certified`。いま自分が書いたコードに合わせてテストを書けるのだから、通ったことは確かめたことにならない。 +- 誰も別に確かめていない — 同様に `self-certified`。仕事を責める印ではない。別に確かめた記録がない、という意味だ。 +- 別のエージェントが、コードは開けないまま仕様だけを見てテストを書いた — `independent`。バグを見ていないのだから、バグに合わせようがない — 印を決めるのは言葉ではなく、そのエージェントが何を開けたかだ。 -`clad done` / `clad verdict` のラベルは、各完了の記録された証拠が示すものを表すだけで、どのエージェントが、何個で、誰の手で作業したかは決して含まない。ラベル自体はブロックしない。強制したいチームは `spec.yaml` に `independence_policy: require` を置き、self-certified の完了は拒否される。役割ブリーフ（planner · developer · reviewer · observability · blind-author）は cladding の接点のための任意のマニュアルとして残るだけで、固定の配役ではない。これは EU AI Act や SOX のような監査規則が求めるのと同じ職務分掌だ — その精神においてであって、認証ではない。 +作る側と確かめる側を別の手に分けておけばいい。EU AI Act や SOX のような監査規則が求める職務分掌と同じ考えだ — 似ているというだけで、認証ではない。 @@ -341,9 +347,9 @@ clad update # 3. プロジェクト接続と派生状態を更新 | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 段階 · 41 detectors | 261（258 done） | +| v0.9.2（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2736 / 2736 | 15 段階 · 41 detectors | 270（266 done） | -236 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック +248 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック > **Ironclad 1.0 への道** — 1.0 は *独立した二つの実装が L4 準拠フィクスチャを通過してはじめて* 確定する（[GOVERNANCE § 1](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md)）。cladding はその一つ目だ。 diff --git a/README.ko.html b/README.ko.html index 37d720d5..cec6e50a 100644 --- a/README.ko.html +++ b/README.ko.html @@ -174,6 +174,8 @@ gap: 16px; margin: 24px 0; } + /* 전 · 후 두 장만 놓는 자리 */ + .flow-cards.two { grid-template-columns: repeat(2, 1fr); } .flow-card { border-radius: 12px; padding: 20px 22px; @@ -254,7 +256,7 @@ .container { padding: 32px 16px 64px; } h1 { font-size: 40px; } h2 { font-size: 24px; margin-top: 48px; } - .flow-cards { grid-template-columns: 1fr; } + .flow-cards, .flow-cards.two { grid-template-columns: 1fr; } table { font-size: 13px; } th, td { padding: 10px 12px; } } @@ -275,7 +277,7 @@

    cladding

    ironclad spec - tests + tests detectors license

    @@ -302,7 +304,7 @@

    cladding

    - cladding은 자기 자신도 cladding으로 만든다 — 기능 255개 중 252개가 같은 게이트를 통과했고, Ironclad 표준을 L4로 구현한 첫 사례다. + cladding은 자기 자신도 cladding으로 만든다 — 기능 270개 중 266개가 같은 게이트를 통과했고, Ironclad 표준을 L4로 구현한 첫 사례다.

    @@ -332,7 +334,7 @@

    누구를 위한 것

    cladding이 호스트 LLM을 감싸는 방식

    -
    +
    전 — 의도를 넣는다
    LLM이 올바른 컨텍스트로 시작하도록
    @@ -342,11 +344,15 @@

    cladding이 호스트 LLM을 감싸는 방식

  • 팀 규칙 적용 — 팀이 합의한 금지·선호 패턴을 매번 표준 지시로
+
+ 후 — 결과를 검증한다 +
나온 결과를 스펙과 대조하도록
+
    +
  • 15단계 게이트 · 41개 어긋남 검출기 — 통과해야만 완료로 인정된다
    • +
  • 구현을 못 보는 채점자 — 구현을 읽을 도구 없이 산출물을 스펙과 대조하는 에이전트라, 자기가 쓴 것에 도장을 찍어 줄 수 없다
    • +
+
- -

- 후 — 결과를 검증한다: 15단계 게이트 · 41개 어긋남 검출기 · 그리고 구현을 못 보는 채점자 — 구현을 읽을 도구 없이 산출물을 스펙과 대조하는 에이전트라, 자기가 쓴 것에 도장을 찍어 줄 수 없다. -

실시간 개입(지도 주입 · 즉시 차단 · 종료 차단)은 Claude Code에서 전부 동작한다. Codex · Gemini · Antigravity · Cursor에서는 같은 검증을 대화 속 도구 호출과 git·CI 관문으로 수행한다. @@ -488,18 +494,25 @@

내부 동작

한 기능의 생애주기는 Define → Sync → Implement → Earn으로 흐른다 — 모든 검사를 통과해야만 done을 얻는다.

-

Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding

+

Multi-Agent

- 여기서 cladding의 일은 하나다: 모든 done을 믿을 수 있게 만드는 것 — 기록된 근거로부터 검증하는 자가 만드는 자와 독립적이었는지를 판정하고, 각 완료에 그에 맞는 라벨을 붙인다. 에이전트를 어떻게 돌릴지는 전적으로 당신 몫이다: 하나든 여럿이든, 어떤 모델이든, 어떤 호스트든 — cladding은 멀티에이전트 프레임워크가 아니며 에이전트를 스폰하거나 라우팅하거나 조율하지 않는다. + AI에게 코드를 맡기면 보통 테스트도 같이 맡긴다. 그런데 같은 AI가 둘 다 쓰면, 테스트는 자기가 쓴 코드에 맞춰진다. 버그가 있어도 테스트는 통과한다. 초록불이 아무것도 증명하지 못하는 상태다.

-

같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다:

+

+ 그래서 cladding은 기능이 끝날 때마다 한 가지를 묻는다: 만든 쪽과 확인한 쪽이 서로 달랐는가? 그 답을 완료에 적어 둔다. (에이전트를 몇 개로 어떻게 돌릴지는 호스트가 정한다 — cladding은 멀티에이전트 프레임워크가 아니고, 에이전트를 배치하지 않는다.) +

+ +
+ 완료된 기능에 표시가 붙는 방식 — 에이전트는 호스트가 돌리고(몇 개, 어떤 모델, 어떤 도구), cladding은 코드를 보지 않은 무언가가 확인했는지를 물어 완료에 independent 또는 self-certified를 남긴다. 기본값에서는 아무것도 막지 않고, independence_policy를 require로 두었을 때만 self-certified가 거부로 바뀐다. +
+
    -
  • 한 에이전트가 만들고, 테스트하고, 리뷰한다 — self-certified로 표시
    • -
  • 두 번째 에이전트가 스펙만 보고 테스트를 쓴다(코드를 읽을 도구가 없다) — independent로 표시
    • -
  • 사람이 리뷰를 승인한다 — independent로 표시
    • +
  • 한 에이전트가 만들고, 테스트하고, 스스로 통과시켰다 — self-certified. 자기가 방금 쓴 코드에 테스트를 맞출 수 있으니, 통과가 곧 확인은 아니다.
    • +
  • 아무도 따로 확인하지 않았다 — 마찬가지로 self-certified. 잘못했다는 뜻이 아니다. 확인한 기록이 없다는 뜻이다.
    • +
  • 다른 에이전트가 코드는 못 본 채 스펙만 보고 테스트를 썼다 — independent. 버그를 못 봤으니 버그에 맞출 수도 없다 — 라벨을 정하는 건 말이 아니라 그 에이전트가 열어 볼 수 있었던 것이다.

- clad done / clad verdict의 라벨은 각 완료의 기록된 근거가 보여 주는 것을 나타낼 뿐, 어떤 에이전트가 몇 개로 누구의 손으로 그 일을 했는지는 담지 않는다. 라벨 자체로는 막지 않는다; 강제하고 싶은 팀은 spec.yaml에 independence_policy: require를 두고, 그러면 self-certified 완료가 거부된다. 역할 브리프(planner · developer · reviewer · observability · blind-author)는 cladding의 접점을 위한 선택적 매뉴얼로 남을 뿐, 고정된 배역이 아니다. 이건 EU AI Act·SOX 같은 감사 규정이 요구하는 것과 같은 직무 분리다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. + 만드는 쪽과 확인하는 쪽을 나눠 두면 된다. EU AI Act·SOX 같은 감사 규정이 요구하는 직무 분리와 같은 방식이지, 정식 인증이 아니다.

@@ -577,7 +590,7 @@

Status

version
-
v0.9.0
+
v0.9.2
2026-07
@@ -587,7 +600,7 @@

Status

tests
-
2710/2710
+
2736/2736
all pass
@@ -597,13 +610,13 @@

Status

features
-
261
-
258 done · 자기 스펙
+
270
+
266 done · 자기 스펙
-

236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단

+

248 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단

Ironclad 1.0까지의 길 — 1.0은 독립적인 두 개의 구현이 L4 검증 셋을 통과해야 잠긴다 (GOVERNANCE § 1). cladding이 첫 번째.
diff --git a/README.ko.md b/README.ko.md index 2eaf5323..b21ce565 100644 --- a/README.ko.md +++ b/README.ko.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ - **추적** — **나간 것은 기록에 남는다**: 무엇을 검증했는지는 커밋된 내용에 새겨지고, 누가·언제는 로컬 세션 로그에, 왜는 스펙에 남아, 인수인계와 리뷰가 파헤치지 않아도 된다. - **확장** — 사람과 AI를 늘리면 보통 충돌과 어긋남도 함께 불어난다. 하지만 모두가 스펙 하나를 기준으로 일하니 그게 자동으로 걸린다 — 그래서 규모를 키워도 무너지지 않는다. -cladding은 **자기 자신도 cladding으로 만든다** — 기능 255개 중 252개가 같은 게이트를 통과했고, [Ironclad](https://github.com/qwerfunch/ironclad) 표준을 L4로 구현한 첫 사례다. +cladding은 **자기 자신도 cladding으로 만든다** — 기능 270개 중 266개가 같은 게이트를 통과했고, [Ironclad](https://github.com/qwerfunch/ironclad) 표준을 L4로 구현한 첫 사례다. @@ -207,17 +207,23 @@ acceptance_criteria: -## Multi-Agent — 돌리는 건 당신, 판정하는 건 cladding +## Multi-Agent -여기서 cladding의 일은 하나다: 모든 `done`을 믿을 수 있게 만드는 것 — 기록된 근거로부터 검증하는 자가 만드는 자와 독립적이었는지를 판정하고, 각 완료에 그에 맞는 라벨을 붙인다. 에이전트를 어떻게 돌릴지는 전적으로 당신 몫이다: 하나든 여럿이든, 어떤 모델이든, 어떤 호스트든 — cladding은 멀티에이전트 프레임워크가 아니며 에이전트를 스폰하거나 라우팅하거나 조율하지 않는다. +AI에게 코드를 맡기면 보통 테스트도 같이 맡긴다. 그런데 같은 AI가 둘 다 쓰면, 테스트는 자기가 쓴 코드에 맞춰진다. 버그가 있어도 테스트는 통과한다. **초록불이 아무것도 증명하지 못하는 상태**다. -같은 프로젝트가 세 기능을 세 가지 다른 방식으로 출하할 수 있다: +그래서 cladding은 기능이 끝날 때마다 한 가지를 묻는다: **만든 쪽과 확인한 쪽이 서로 달랐는가?** 그 답을 완료에 적어 둔다. (에이전트를 몇 개로 어떻게 돌릴지는 호스트가 정한다 — cladding은 멀티에이전트 프레임워크가 아니고, 에이전트를 배치하지 않는다.) -- 한 에이전트가 만들고, 테스트하고, 리뷰한다 — `self-certified`로 표시 -- 두 번째 에이전트가 스펙만 보고 테스트를 쓴다(코드를 읽을 도구가 없다) — `independent`로 표시 -- 사람이 리뷰를 승인한다 — `independent`로 표시 +
+ +완료된 기능에 표시가 붙는 방식 — 에이전트는 호스트가 돌리고(몇 개, 어떤 모델, 어떤 도구), cladding은 코드를 보지 않은 무언가가 확인했는지를 물어 완료에 independent 또는 self-certified를 남긴다. 기본값에서는 아무것도 막지 않고, independence_policy를 require로 두었을 때만 self-certified가 거부로 바뀐다. + +
+ +- 한 에이전트가 만들고, 테스트하고, 스스로 통과시켰다 — `self-certified`. 자기가 방금 쓴 코드에 테스트를 맞출 수 있으니, 통과가 곧 확인은 아니다. +- 아무도 따로 확인하지 않았다 — 마찬가지로 `self-certified`. 잘못했다는 뜻이 아니다. 확인한 기록이 없다는 뜻이다. +- 다른 에이전트가 코드는 못 본 채 스펙만 보고 테스트를 썼다 — `independent`. 버그를 못 봤으니 버그에 맞출 수도 없다 — 라벨을 정하는 건 말이 아니라 그 에이전트가 열어 볼 수 있었던 것이다. -`clad done` / `clad verdict`의 라벨은 각 완료의 기록된 근거가 보여 주는 것을 나타낼 뿐, 어떤 에이전트가 몇 개로 누구의 손으로 그 일을 했는지는 담지 않는다. 라벨 자체로는 막지 않는다; 강제하고 싶은 팀은 `spec.yaml`에 `independence_policy: require`를 두고, 그러면 self-certified 완료가 거부된다. 역할 브리프(planner · developer · reviewer · observability · blind-author)는 cladding의 접점을 위한 선택적 매뉴얼로 남을 뿐, 고정된 배역이 아니다. 이건 EU AI Act·SOX 같은 감사 규정이 요구하는 것과 같은 직무 분리다 — 그 정신에서 그렇다는 것이지, 인증이 아니다. +만드는 쪽과 확인하는 쪽을 나눠 두면 된다. EU AI Act·SOX 같은 감사 규정이 요구하는 직무 분리와 같은 방식이지, 정식 인증이 아니다. @@ -327,7 +333,7 @@ cd # 2. Cladding 프로젝트로 이동 clad update # 3. 프로젝트 연결과 파생 데이터를 함께 갱신 ``` -`clad update`는 업데이트하려는 각 Cladding 프로젝트에서 실행한다. 사용자가 작성한 코드 · 기능/스펙 본문 · 문서는 보존되며, 프로젝트 전용 호스트 연결과 파생 데이터, `AGENTS.md`의 Cladding 관리 블록만 갱신될 수 있다. 새 버전이 어긋남을 발견하면 그 결과를 AI 도구에 넘기면 된다: +`clad update`는 업데이트하려는 각 Cladding 프로젝트에서 실행한다. 사용자가 작성한 코드 · 기능/스펙 본문 · 문서는 보존되며, 프로젝트 전용 호스트 연결과 파생 데이터, Cladding이 관리하는 지시 블록만 갱신될 수 있다. 새 버전이 어긋남을 발견하면 그 결과를 AI 도구에 넘기면 된다: ``` 업데이트가 짚은 어긋남을 정리해줘. @@ -340,9 +346,9 @@ clad update # 3. 프로젝트 연결과 파생 데이터를 함께 | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 · all pass | 15 단계 · 41 detectors | 261 · 258 done · 자기 스펙 | +| v0.9.2 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2736 / 2736 · all pass | 15 단계 · 41 detectors | 270 · 266 done · 자기 스펙 | -236 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 +248 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 > **Ironclad 1.0까지의 길** — 1.0은 *독립적인 두 개의 구현이 L4 검증 셋을 통과해야* 잠긴다 ([GOVERNANCE § 1](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md)). cladding이 첫 번째. diff --git a/README.md b/README.md index 2d2cce44..37c5b8d1 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ So you can ship AI-written code held to **the same standard as human-written cod - **Traced** — **What shipped is on the record**: what was verified is stamped into committed content, who and when land in the local session ledger, and the why lives in the spec — so handoff and review skip the archaeology. - **Scales** — adding people and AIs would normally multiply conflicts and drift; because everyone works from one shared spec, those get caught automatically — so you can grow without it breaking down. -cladding builds **itself** with cladding too — 252 of its 255 features cleared this same gate, the first L4 implementation of the [Ironclad](https://github.com/qwerfunch/ironclad) standard. +cladding builds **itself** with cladding too — 266 of its 270 features cleared this same gate, the first L4 implementation of the [Ironclad](https://github.com/qwerfunch/ironclad) standard. @@ -204,17 +204,23 @@ One feature's lifecycle runs **Define → Sync → Implement → Earn** — you -## Multi-Agent — yours to run, cladding's to judge +## Multi-Agent -Here cladding has one job: make every `done` trustworthy — it judges, from recorded evidence, whether the verifier was independent of the author, and labels each completion accordingly. How the agents run is entirely yours: one or many, any models, any host — cladding is not a multi-agent framework and never spawns, routes, or coordinates them. +Hand the code to an AI and you usually hand it the tests too. But when the same AI writes both, the tests get shaped around the code it just wrote. The bug is there and the tests still pass. **A green run that proves nothing.** -The same project can ship three features three different ways: +So cladding asks one thing of every finished feature: **were the building and the checking done by different hands?** The answer goes on the record with the completion. (How many agents run, and how, is the host's call — cladding is not a multi-agent framework and doesn't arrange them.) -- one agent builds, tests, and reviews — labeled `self-certified` -- a second agent writes the tests from the spec alone (it has no tool to read the code) — labeled `independent` -- a person signs off the review — labeled `independent` +
+ +How a finished feature gets its mark — the host runs the agents (how many, which models, which tool); cladding asks whether anything checked the work without seeing the code, and marks the completion independent or self-certified. By default nothing is blocked; only an independence_policy of require turns a self-certified mark into a refusal. + +
+ +- one agent built it, tested it, and passed its own work — `self-certified`. It can shape the tests around the code it just wrote, so passing isn't checking. +- nobody checked it separately — `self-certified` as well. It isn't a mark against the work; it means no separate check is on record. +- another agent wrote the tests from the spec, with no way to open the code — `independent`. It never saw the bug, so it can't shape a test around one — what decides the label is what that agent could open, not what anyone promised. -The label on `clad done` / `clad verdict` reports what each completion's recorded evidence shows — never which agents did the work, how many, or whose. It doesn't block on its own; teams that want teeth set `independence_policy: require` in `spec.yaml`, and self-certified completions are refused. The role briefs (planner · developer · reviewer · observability · blind-author) stay optional manuals for cladding's touchpoints, not a fixed cast. It's the same separation of duties audit rules like the EU AI Act and SOX ask for — in spirit, not a certification. +Keep the building and the checking in different hands. It's the same approach as the separation of duties that audit rules like the EU AI Act and SOX ask for — close in spirit, not a certification. @@ -354,9 +360,9 @@ Reconcile the drift the update flagged. | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 stages · 41 detectors | 261 (258 done) | +| v0.9.2 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2736 / 2736 | 15 stages · 41 detectors | 270 (266 done) | -236 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector +248 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector > **Road to Ironclad 1.0** — 1.0 locks only when *two independent implementations pass the L4 conformance fixtures* ([GOVERNANCE § 1](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md)). cladding is the first. diff --git a/README.zh.md b/README.zh.md index 2d0c01b5..b8533d80 100644 --- a/README.zh.md +++ b/README.zh.md @@ -12,7 +12,7 @@

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ - **可追溯** —— **交付出去的一切都留有记录**：验证了什么，写进已提交的内容；谁、何时，记在本地会话账本；为什么，留在 spec —— 于是交接与评审无需考古，就能追溯每一个决定。 - **可扩展** —— 人和 AI 越多，通常冲突和漂移也越多。但所有人都以同一份 spec 为基准，这些会被自动挡下 —— 所以不断扩张也不会崩。 -cladding 连**自己**也是用 cladding 造的 —— 255 个 feature 里有 252 个通过了同一道门禁，成为 [Ironclad](https://github.com/qwerfunch/ironclad) 标准的首个 L4 实现。 +cladding 连**自己**也是用 cladding 造的 —— 270 个 feature 里有 266 个通过了同一道门禁，成为 [Ironclad](https://github.com/qwerfunch/ironclad) 标准的首个 L4 实现。 @@ -204,17 +204,23 @@ acceptance_criteria: -## Multi-Agent —— 怎么跑由你，怎么判由 cladding +## Multi-Agent -在这里，cladding 只有一件事：让每一次 `done` 都值得信赖 —— 它依据记录在案的证据，判定验证者是否独立于建造者，并据此给每一次收尾打上标签。智能体怎么跑，完全由你决定：一个还是多个、哪种模型、哪个宿主都行 —— cladding 不是一个多智能体框架，也从不 spawn、路由或协调它们。 +把代码交给 AI，通常也就把测试一起交了出去。可一旦同一个 AI 两样都写，测试就会照着它刚写的代码来长。bug 还在，测试照样通过。**这时候的绿灯什么也证明不了。** -同一个项目，可以用三种不同的方式交付三个 feature： +所以每有一个 feature 完成，cladding 只问一件事：**建造的一方和查验的一方，是不是不同的？** 答案随这次收尾一起记录下来。（用几个智能体、怎么跑，由宿主决定 —— cladding 不是一个多智能体框架，也不负责编排它们。） -- 一个智能体又建造、又测试、又评审 —— 标为 `self-certified` -- 第二个智能体只凭规格写测试（它没有读代码的工具） —— 标为 `independent` -- 由人来签署评审 —— 标为 `independent` +
+ +完成的 feature 如何得到标记 —— 智能体由宿主来跑（用几个、哪种模型、哪个工具），cladding 只问有没有一方没看代码就查过它，并在收尾上留下 independent 或 self-certified。默认不拦截任何东西，只有把 independence_policy 设为 require，self-certified 才会变成拒绝。 + +
+ +- 一个智能体又建造、又测试，又自己放行了自己的活儿 —— `self-certified`。它可以照着自己刚写的代码来写测试，所以通过并不等于查过。 +- 没有人单独查过 —— 同样是 `self-certified`。这不是给活儿记的一笔过，只是说没有单独查验的记录。 +- 另一个智能体打不开代码，只凭规格写了测试 —— `independent`。它没见过那个 bug，也就无从迎合它 —— 决定这个标记的不是谁的承诺，而是那个智能体当时能打开什么。 -`clad done` / `clad verdict` 上的标签，只报告每一次收尾记录在案的证据所显示的情况 —— 从不涉及是哪些智能体、用了几个、出自谁手。它本身并不拦截；想要强制的团队，可在 `spec.yaml` 里设 `independence_policy: require`，于是 self-certified 的收尾会被拒绝。角色简介（planner · developer · reviewer · observability · blind-author）只是 cladding 各接触点的可选手册，而非一份固定的班底。这正是 EU AI Act、SOX 这类审计规范所要求的那种职责分离 —— 说的是精神相符，而不是一纸认证。 +把建造和查验分开就行。这和 EU AI Act、SOX 这类审计规范要求的职责分离是同一个思路 —— 只是相似，并不是一纸认证。 @@ -337,9 +343,9 @@ clad update # 3. 刷新项目连接和派生状态 | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2710 / 2710 | 15 阶段 · 41 检测器 | 261（258 done） | +| v0.9.2（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2736 / 2736 | 15 阶段 · 41 检测器 | 270（266 done） | -236 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 +248 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 > **通往 Ironclad 1.0 之路** —— 只有当*两个独立实现都通过 L4 一致性测试夹具*时，1.0 才会锁定（[GOVERNANCE § 1](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md)）。cladding 是第一个。 diff --git a/docs/img/en/independence.svg b/docs/img/en/independence.svg new file mode 100644 index 00000000..90a42758 --- /dev/null +++ b/docs/img/en/independence.svg @@ -0,0 +1,85 @@ + + What mark a finished feature gets — the host runs the agents; cladding asks whether the building and the checking were done by different hands, and marks the completion independent or self-certified. Only a require policy turns the mark into a refusal. + + + + + + + + + + What mark a finished feature gets + + + + + the host runs the agents + how many · which models · which tool — cladding does not arrange this + + + a feature is finished + + + + Were the building and the checking done by different hands? + cladding reads only what was left on the record — never who, or how many + + + + yes + + no + + + + + independent + ▸ wrote the tests from the spec + ▸ could not open the code + it never saw the bug, so it can't match one + + + + + self-certified + ▸ the builder checked their own work + ▸ or nobody checked it + not a fault — just no separate check on record + + + + only if you switch it on: + independence_policy: require + + + + done is refused + put back to unfinished, like a failed check + + + by default, nothing is blocked + the mark just sits on the record + + + The host decides who works · cladding only reads what's left behind + diff --git a/docs/img/ja/independence.svg b/docs/img/ja/independence.svg new file mode 100644 index 00000000..2f0c4b17 --- /dev/null +++ b/docs/img/ja/independence.svg @@ -0,0 +1,85 @@ + + 終わった feature にどの印が付くか — エージェントを走らせるのはホストで、cladding は作った側と確かめた側が別だったかを問い、完了に independent または self-certified を残す。require ポリシーを置いたときだけ、その印は拒否に変わる。 + + + + + + + + + + 終わった feature にどの印が付くか + + + + + エージェントを走らせるのはホスト + 何個 · どのモデル · どのツール — cladding はここに関与しない + + + feature が終わった + + + + 作った側と確かめた側は、別だったか？ + cladding は残った記録だけを見る — 誰がやったか、何個ついたかは問わない + + + + はい + + いいえ + + + + + independent + ▸ 仕様だけを見てテストを書いた + ▸ コードは開けなかった + バグを見ていないので、バグに合わせたテストも書けない + + + + + self-certified + ▸ 作った側が自分の仕事を確かめた + ▸ または誰も確かめていない + 落ち度ではなく、別の確認が記録にないという意味 + + + + この設定を入れたときだけ: + independence_policy: require + + + + 完了が拒否される + 未完了に戻る — 検査に失敗したときと同じ + + + 既定では何もブロックしない + 印が記録に残るだけだ + + + 誰がやるかはホストが決める · cladding はその結果だけを見る + diff --git a/docs/img/ko/independence.svg b/docs/img/ko/independence.svg new file mode 100644 index 00000000..41e87c22 --- /dev/null +++ b/docs/img/ko/independence.svg @@ -0,0 +1,85 @@ + + 끝난 기능에 어떤 표시가 붙나 — 에이전트는 호스트가 돌리고, cladding은 만든 쪽과 확인한 쪽이 달랐는지를 물어 완료에 independent 또는 self-certified를 남긴다. require 정책을 켰을 때만 그 표시가 거부로 바뀐다. + + + + + + + + + + 끝난 기능에 어떤 표시가 붙나 + + + + + 에이전트는 호스트가 돌린다 + 몇 개 · 어떤 모델 · 어떤 도구 — cladding은 여기 관여하지 않는다 + + + 기능이 끝났다 + + + + 만든 쪽과 확인한 쪽이 달랐는가? + cladding은 남은 기록만 본다 — 누가 했는지, 몇 개가 붙었는지는 묻지 않는다 + + + + 예 + + 아니오 + + + + + independent + ▸ 스펙만 보고 테스트를 썼다 + ▸ 코드는 열어 볼 수 없었다 + 버그를 못 봤으니, 버그에 맞춘 테스트도 못 쓴다 + + + + + self-certified + ▸ 만든 쪽이 자기 것을 확인했다 + ▸ 또는 아무도 확인하지 않았다 + 잘못이 아니라, 따로 확인한 기록이 없다는 뜻 + + + + 이 설정을 켰을 때만: + independence_policy: require + + + + 완료가 거부된다 + 미완료로 되돌아간다 — 검사 실패와 똑같이 + + + 기본값에서는 아무것도 막지 않는다 + 표시만 기록에 남는다 + + + 누가 일할지는 호스트가 정한다 · cladding은 그 결과만 본다 + diff --git a/docs/img/zh/independence.svg b/docs/img/zh/independence.svg new file mode 100644 index 00000000..3c5ac03f --- /dev/null +++ b/docs/img/zh/independence.svg @@ -0,0 +1,85 @@ + + 完成的 feature 会得到哪个标记 —— 智能体由宿主来跑，cladding 只问建造的一方和查验的一方是不是不同的，并在收尾上留下 independent 或 self-certified。只有设了 require 策略，这个标记才会变成拒绝。 + + + + + + + + + + 完成的 feature 会得到哪个标记 + + + + + 智能体由宿主来跑 + 用几个 · 哪种模型 · 哪个工具 —— cladding 不参与这些 + + + 一个 feature 完成了 + + + + 建造的一方和查验的一方，是不是不同的？ + cladding 只看留下的记录 —— 不问是谁做的，也不问用了几个 + + + + 有 + + 没有 + + + + + independent + ▸ 只凭规格写了测试 + ▸ 打不开代码 + 没见过这个 bug，也就写不出迎合它的测试 + + + + + self-certified + ▸ 建造的一方查了自己的活儿 + ▸ 或者根本没人查过 + 不是过错，只是没有单独查验的记录 + + + + 只有打开这项设置时: + independence_policy: require + + + + 收尾被拒绝 + 退回未完成 —— 和检查失败时一样 + + + 默认不拦截任何东西 + 标记只是留在记录上 + + + 谁来做由宿主决定 · cladding 只看它留下的结果 + diff --git a/spec/_doc-links.yaml b/spec/_doc-links.yaml index f019562a..ede2f8f7 100644 --- a/spec/_doc-links.yaml +++ b/spec/_doc-links.yaml @@ -14,6 +14,8 @@ docs: features: [F-06dfdad6, F-7794a6bc] "docs/ab-evaluation/case-iterative-vs-fixed-vapt.md": features: [F-7794a6bc, F-96250595] + "docs/ab-evaluation/case-role-contract-ablation.md": + features: [F-600272d7] "docs/ab-evaluation/case-working-set-landmine.md": features: [F-06dfdad6] "docs/conventions.md": @@ -30,7 +32,7 @@ docs: features: [F-4db939, F-ba2e05] doc_links: ["docs/ab-evaluation/README.md", "docs/ssot-model.md", "docs/ssot-testing.md"] "docs/refinement-backlog.md": - features: [F-066, F-06dfdad6, F-073, F-16138071, F-27e56a00, F-3c2bf8b9, F-d25041ac, F-fe0f7a96] + features: [F-066, F-06dfdad6, F-073, F-16138071, F-27e56a00, F-3c2bf8b9, F-3fd220d8, F-d25041ac, F-fe0f7a96] "docs/ssot-model.md": features: [F-001] "docs/ssot-testing.md": diff --git a/spec/features/readme-multiagent-inversion-8476ccb1.yaml b/spec/features/readme-multiagent-inversion-8476ccb1.yaml index de5a64a9..a54ae033 100644 --- a/spec/features/readme-multiagent-inversion-8476ccb1.yaml +++ b/spec/features/readme-multiagent-inversion-8476ccb1.yaml @@ -17,8 +17,8 @@ acceptance_criteria: test_refs: ["tests/choreography-guard.test.ts"] - id: AC-7d433517 ears: ubiquitous - text: "The section shall carry the story in prose alone — no embedded diagram; the three-shapes contrast (one agent does everything; a blind test author; a human reviewer — each completion labeled for its own record) lives as a compact list in the text." - response: "no README variant matches /multi-agent\\.svg/; the EN slice presents the three-shape contrast as a list" + text: "The retired cast diagram shall not return — four drafts of it each read as a fixed roster of agents cladding ships — and the contrast between completions shall stand on its own as a compact list in the text, legible with no picture at all. (Narrowed by F-3fd220d8, which adds a diagram of the label decision at a different path; the blanket no-diagram wording it replaced was a consequence of those four drafts, not the invariant.)" + response: "no README variant matches /multi-agent\\.svg/; the EN slice presents the contrast as a list" test_refs: ["tests/choreography-guard.test.ts"] - id: AC-a1692ed7 ears: ubiquitous diff --git a/spec/features/readme-multiagent-label-diagram-3fd220d8.yaml b/spec/features/readme-multiagent-label-diagram-3fd220d8.yaml new file mode 100644 index 00000000..403258fa --- /dev/null +++ b/spec/features/readme-multiagent-label-diagram-3fd220d8.yaml @@ -0,0 +1,62 @@ +id: F-3fd220d8 +slug: readme-multiagent-label-diagram +title: "README multi-agent section reads plainly and draws the label decision, not a cast" +status: done +modules: + - README.md + - README.ko.md + - README.ja.md + - README.zh.md + - README.html + - README.ko.html + - docs/img/en/independence.svg + - docs/img/ko/independence.svg + - docs/img/ja/independence.svg + - docs/img/zh/independence.svg +acceptance_criteria: + - id: AC-6b0a1f74 + ears: ubiquitous + text: "The section shall open with the stake a reader can feel — one AI writing both the code and its tests produces a green run that proves nothing — before it names any label, so the reader learns why the question is worth asking before learning what it is called. The two self-certified examples shall sit next to each other, the second of them saying it lands on the same label, and the list shall close on the independent case so the way out is the last thing read." + response: "in every EN/KO variant the Multi-Agent slice states the shaped-around-the-code problem before its first list item; the two adjacent self-certified items are followed by the sameness marker ('as well' / '마찬가지로'), and the final list item ends in independent" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-c1e7a3b5 + ears: ubiquitous + text: "The section shall explain that the independent label follows from what the test-writing agent was able to open rather than from an assurance anyone gives, and shall say plainly that self-certified is the absence of a separate check rather than a mark against the work." + response: "each EN/KO slice states that the test-writing agent had no way to open the code, and contains the non-accusation clause (\"isn't a mark against the work\" / '잘못했다는 뜻이 아니다')" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-4d92c806 + ears: ubiquitous + text: "A locale diagram shall accompany the section in all four languages, drawing the completion's label decision — the host band, the single question, the two labels, and the refusal that only a require policy produces — and never a roster of agents or roles." + response: "docs/img/{en,ko,ja,zh}/independence.svg each exist, contain the literals 'independent' and 'self-certified', and match neither /dispatch/i nor /orchestrat/i anywhere including comments" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-83f1ba27 + ears: ubiquitous + text: "Each README variant shall embed the diagram for its own language, and no variant shall resurrect the retired cast diagram." + response: "README.md/README.html reference docs/img/en/independence.svg, README.ko.md/README.ko.html reference docs/img/ko/independence.svg, README.ja.md and README.zh.md reference their own locale; no variant matches /multi-agent\\.svg/" + test_refs: ["tests/choreography-guard.test.ts"] + - id: AC-0e5cb419 + ears: ubiquitous + text: "Every prior README pin shall survive the rewrite — the Multi-Agent heading token and its position after the loop section, the three-item list in the English slice, the hedged EU AI Act sentence in the four EN/KO variants, and the detector and stage count literals." + response: "choreography-guard, readme-loop-section, readme-record-honesty, terminology-canon and self-consistency suites stay green" + test_refs: + - "tests/choreography-guard.test.ts" + - "tests/readme-loop-section.test.ts" + - "tests/readme-record-honesty.test.ts" + - "tests/terminology-canon.test.ts" + - "tests/self-consistency.test.ts" +design_impact: + classification: none + rationale: >- + Documentation-layer clarity pass. The prior inversion (F-8476ccb1) fixed the framing but left a + reader-facing defect: a yes/no question answered with three examples carrying two labels, with no + statement that two of them share one. This entry restructures the section around the two label + values, lowers the vocabulary (the cast metaphor is dropped; the label values are glossed on first + use in the localized variants), and reinstates a diagram at a new path. The prose-only decision of + F-8476ccb1 was taken after four drafts that all drew roles and all read as a fixed cast; the user + has since asked for a diagram, and this one draws the label decision instead — a host band with no + agent detail, one question, two outcomes, and the refusal a require policy adds. Because it depicts + the judgment rather than a roster, the invariant that mattered (never restore multi-agent.svg) is + untouched, and AC-7d433517 of F-8476ccb1 is reworded to state that invariant rather than a blanket + no-diagram rule. No engine changes. + status: resolved + artifacts: [] diff --git a/tests/choreography-guard.test.ts b/tests/choreography-guard.test.ts index d2a2a4b7..7c314c27 100644 --- a/tests/choreography-guard.test.ts +++ b/tests/choreography-guard.test.ts @@ -276,7 +276,12 @@ describe('README Multi-Agent section carries the inversion in prose alone (F-847 }); }); - describe('AC-7d433517 — the story carries in prose alone, no embedded diagram', () => { + // Narrowed by F-3fd220d8: the invariant is that the RETIRED CAST diagram + // (multi-agent.svg, four drafts of it, each reading as a fixed roster) never + // returns, and that the contrast still stands as a list with no picture at + // all. A diagram of the LABEL DECISION now ships at docs/img// + // independence.svg — a different drawing at a different path, guarded below. + describe('AC-7d433517 — the retired cast diagram stays gone; the contrast stands as a list', () => { for (const f of README_VARIANTS) { test(`${f}: does not match /multi-agent\\.svg/`, () => { const body = repoRead(f); @@ -294,3 +299,142 @@ describe('README Multi-Agent section carries the inversion in prose alone (F-847 }); }); }); + +// F-3fd220d8 — the section reads plainly and draws the label decision. +// +// The prior inversion (F-8476ccb1) fixed the framing but left a comprehension +// defect: a yes/no question ("was it checked by someone else?") answered with +// three examples carrying only two labels, with nothing saying that two of the +// three land on the SAME label. A reader counts three, counts two, and stalls. +// These guards pin the repair — labels named before the examples, the two +// self-certified cases adjacent with the last one marked as sharing the label, +// the mechanism stated as tool reach rather than assurance, and the +// non-accusation clause — plus the new locale diagram of the label decision. +const MULTIAGENT_NEEDLES: Readonly< + Record +> = { + 'README.md': { + stakes: 'proves nothing', + sameness: 'as well', + noCodeAccess: 'no way to open the code', + notAnAccusation: "isn't a mark against the work", + }, + 'README.html': { + stakes: 'proves nothing', + sameness: 'as well', + noCodeAccess: 'no way to open the code', + notAnAccusation: "isn't a mark against the work", + }, + 'README.ko.md': { + stakes: '아무것도 증명하지 못하는', + sameness: '마찬가지로', + noCodeAccess: '코드는 못 본 채', + notAnAccusation: '잘못했다는 뜻이 아니다', + }, + 'README.ko.html': { + stakes: '아무것도 증명하지 못하는', + sameness: '마찬가지로', + noCodeAccess: '코드는 못 본 채', + notAnAccusation: '잘못했다는 뜻이 아니다', + }, +}; + +const INDEPENDENCE_SVG_LOCALES: readonly string[] = ['en', 'ko', 'ja', 'zh']; +const README_TO_LOCALE: Readonly> = { + 'README.md': 'en', + 'README.html': 'en', + 'README.ko.md': 'ko', + 'README.ko.html': 'ko', + 'README.ja.md': 'ja', + 'README.zh.md': 'zh', +}; + +// First list item of a Multi-Agent slice, md ('- ' line) or html ('
  • '). +const firstListItemIndexOf = (f: string, slice: string): number => + isHtmlReadme(f) ? slice.indexOf('
  • ') : slice.indexOf('\n- '); + +// The slice's example items in document order, md ('- ' lines) or html (
  • bodies). +const listItemsOf = (f: string, slice: string): readonly string[] => + isHtmlReadme(f) + ? [...slice.matchAll(/
  • ([\s\S]*?)<\/li>/g)].map((m) => m[1]!) + : slice.split('\n').filter((line) => line.startsWith('- ')); + +describe('README Multi-Agent section reads plainly and draws the label decision (F-3fd220d8)', () => { + describe('AC-6b0a1f74 — the stake lands before any label, and the list ends on the way out', () => { + for (const f of README_EN_KO_VARIANTS) { + test(`${f}: the green-run-proves-nothing problem is stated before the first list item`, () => { + const slice = multiAgentSliceOf(f); + const firstItem = firstListItemIndexOf(f, slice); + const {stakes} = MULTIAGENT_NEEDLES[f]!; + expect(firstItem, `${f}: Multi-Agent slice must contain a list`).toBeGreaterThan(0); + const stakesAt = slice.indexOf(stakes); + expect( + stakesAt, + `${f}: the section must open with why the question matters — one AI writing both code and tests makes a green run prove nothing ("${stakes}")`, + ).toBeGreaterThan(-1); + expect(stakesAt, `${f}: the stake must land before the examples, not after them`).toBeLessThan(firstItem); + }); + + test(`${f}: two adjacent self-certified cases, marked as sharing a label, then independent last`, () => { + const items = listItemsOf(f, multiAgentSliceOf(f)); + const {sameness} = MULTIAGENT_NEEDLES[f]!; + expect(items.length, `${f}: expected at least 3 example items`).toBeGreaterThanOrEqual(3); + const [first, second] = items; + const last = items[items.length - 1]!; + expect(first, `${f}: the first example must land on self-certified`).toContain('self-certified'); + expect(second, `${f}: the second example must also land on self-certified`).toContain('self-certified'); + expect( + second, + `${f}: the second self-certified case must say it shares the label ("${sameness}"), so two examples mapping to one label never reads as a contradiction`, + ).toContain(sameness); + expect( + last, + `${f}: the list must close on the independent case, so the way out is the last thing read`, + ).toContain('independent'); + }); + } + }); + + describe('AC-c1e7a3b5 — independence is explained as tool reach, and self-certified is explained as absence, not fault', () => { + for (const f of README_EN_KO_VARIANTS) { + test(`${f}: states the test writer has no means of opening the code`, () => { + const slice = multiAgentSliceOf(f); + const {noCodeAccess} = MULTIAGENT_NEEDLES[f]!; + expect(slice, `${f}: must explain independence as what the test writer can reach ("${noCodeAccess}")`).toContain( + noCodeAccess, + ); + }); + + test(`${f}: says self-certified is not an accusation`, () => { + const slice = multiAgentSliceOf(f); + const {notAnAccusation} = MULTIAGENT_NEEDLES[f]!; + expect(slice, `${f}: must contain the non-accusation clause ("${notAnAccusation}")`).toContain(notAnAccusation); + }); + } + }); + + describe('AC-4d92c806 — the locale diagram draws the label decision, never a roster', () => { + for (const locale of INDEPENDENCE_SVG_LOCALES) { + const rel = `docs/img/${locale}/independence.svg`; + test(`${rel}: exists, carries both labels, and names no roster`, () => { + const body = repoRead(rel); + expect(body.length, `${rel}: must exist and be non-empty`).toBeGreaterThan(0); + expect(body, `${rel}: must contain "independent"`).toContain('independent'); + expect(body, `${rel}: must contain "self-certified"`).toContain('self-certified'); + expect(body, `${rel}: must not match /dispatch/i anywhere, comments included`).not.toMatch(/dispatch/i); + expect(body, `${rel}: must not match /orchestrat/i anywhere, comments included`).not.toMatch(/orchestrat/i); + }); + } + }); + + describe('AC-83f1ba27 — each variant embeds its own locale diagram', () => { + for (const [f, locale] of Object.entries(README_TO_LOCALE)) { + test(`${f}: references docs/img/${locale}/independence.svg`, () => { + const slice = multiAgentSliceOf(f); + expect(slice, `${f}: Multi-Agent slice must embed docs/img/${locale}/independence.svg`).toContain( + `docs/img/${locale}/independence.svg`, + ); + }); + } + }); +}); From 9c8cd0bc6bfe5fe6c9877223a6722155d3dbb0a7 Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Sun, 26 Jul 2026 00:46:13 +0900 Subject: [PATCH 12/13] =?UTF-8?q?docs(ab):=20pre-registered=20role-contrac?= =?UTF-8?q?t=20ablation=20=E2=80=94=20H1=20confirmed,=20no=20benefit=20cla?= =?UTF-8?q?imable?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The only prior evidence for removing the orchestrator's choreography was the 0.9.1 dogfood S5, which says of itself that it is n=1, single-arm and "not a comparison". This runs the missing control. Single-variable ablation: the current build with only src/agents/orchestrator.md swapped for its pre-change version, so the engine, detectors and specialist briefs are held constant. Six Sonnet 5 agents, n=3/arm, identical isolated fixtures, scored by a hidden oracle against each arm's final implementation — never from transcripts. Result: the planted boundary bug was caught 3/3 in both arms. H1 confirmed — removing the choreography did not weaken real separation. Per the decision rule fixed before the data was read, the H1 NULL branch binds the framing: no benefit may be claimed for the removal in README, CHANGELOG or release notes. Effort favours the contract card (0.85x tokens, 0.68x tool calls at the median) but the ranges overlap, so it is reported as not resolvable at n=3, not as a win. Recorded honestly: a mid-campaign "more separation process" pattern was withdrawn as noise (2/3 vs 1/3) and failed the artifact-only scoring bar anyway; M2 was vacuous by design because the task assigned one feature; Phase 3 was cancelled before spending budget and is marked not measured, never answered. The durable finding is not about the orchestrator: three runs performed genuine blind separation and none could record it, corroborating G1 from outside the dogfood campaign. Backlog entry added for the independence surface — the policy switch has no first-party writer, no persona brief names it, and human-authored evidence has no writer anywhere. Co-Authored-By: Claude Opus 5 --- .../case-role-contract-ablation.md | 278 ++++++++++++++++++ docs/refinement-backlog.md | 1 + 2 files changed, 279 insertions(+) create mode 100644 docs/ab-evaluation/case-role-contract-ablation.md diff --git a/docs/ab-evaluation/case-role-contract-ablation.md b/docs/ab-evaluation/case-role-contract-ablation.md new file mode 100644 index 00000000..396698a4 --- /dev/null +++ b/docs/ab-evaluation/case-role-contract-ablation.md @@ -0,0 +1,278 @@ + + +# A/B — did removing the orchestrator's choreography change behaviour? (pre-registered) + + + + +> **Status: PRE-REGISTERED, NOT YET RUN.** This document is committed BEFORE the experiment runs; +> the decision rules below bind the release framing. Written 2026-07-25. + +**Question.** The role-contract change (F-600272d7) deleted the orchestrator's *prescriptive +choreography* — a 7-row routing table, Invocation Principles 1–5, the named +`planner → developer → test-author → reviewer → observability` chain, the host-mode WIP table, and +the Tier-sources table — and replaced it with four declarative outcome conditions plus +"the host owns execution". Two things have never been measured: + +1. **Does the declarative form still produce the actual implementer/verifier separation** that the + prescriptive form instructed? +2. **Does the cycle discipline hold across consecutively developed features**, or decay? + +The only existing evidence (`docs/dogfood/e2e-role-contract-2026-07-24.md`, S5) is **n=1, +single-arm, no control** — that document says so itself: *"nothing here is a comparison — it is an +existence proof that the new prompt is sufficient."* + +## What this does NOT measure — correctness + +`case-081-cycle-conformance.md` states the standing rule: *"Code quality deliberately NOT measured +(eight prior NULLs)."* Governance↔correctness orthogonality is closed at 6 / 9 / 34 / 48 features +plus the 5th–8th NULLs in `docs/benchmarks/v0.6.0-real-user-verification.md`. This trial measures +**behaviour** (did the separation actually happen) and **discipline** (did the cycle hold), not +whether the code is right. + +## Pre-registered prior — NULL is the most likely outcome + +Recorded before running, so a NULL cannot later be re-narrated as a surprise. Most of what was +deleted is backstopped elsewhere: + +| Deleted from the old orchestrator | Backstop that survives | +|---|---| +| Principle 2 — "implementer ≠ verifier; hand the test-author ACs + signatures only" | **Still present** — `src/agents/orchestrator.md:33` and `src/agents/developer.md:49-50` | +| Host-mode WIP table (1 feature ahead) | **`PLANNED_BACKLOG` detector** blocks a wide batch under `--strict` | +| Named 5-agent chain | Reproduced from the contract card alone in S5 (n=1) | +| Routing table · Tier-sources table | Low stakes — a wrong role choice surfaces as a gate result | + +⇒ The expected finding is **"safe, but not a selling point."** The trial is still worth running +because the opposite result — the declarative form producing *less* real separation than the +prescriptive one — is a regression that can only be reverted before release. + +## Design (pre-registered) + +**Single-variable ablation.** The independent variable is the orchestrator prompt *only*. ARM A is +built by overwriting `src/agents/orchestrator.md` in the **current** build with the pre-change file +(`git show b824609^:src/agents/orchestrator.md`); ARM B is the current build unmodified. Installing +npm `cladding@0.9.1` wholesale would also swap the engine, detectors and CLI — that breaks the +ablation and is explicitly rejected. + +- **ARM A** — old orchestrator (routing table + 6 principles + agent chain + WIP table) +- **ARM B** — new orchestrator (contract card) + +Everything else identical: same engine build, same specialist briefs, same task, same host. + +**Arm identity is verified by content, not version.** The dogfood tarball deliberately left the +version unbumped, so both arms report `clad --version → 0.9.1`. Each run asserts +`grep -c "routing table"` = 1 for ARM A and 0 for ARM B before the agent starts. + +**Model routing.** Code authoring inside the arms runs on **Sonnet 5**; design, adjudication and +verdict are **Opus 5**. Fixed across arms so the model is not a confound. + +**Scoring is artifact-deterministic** — `.cladding/events.log.jsonl` + `git diff` + test exit codes +only. Transcripts are never read for scoring (the `scripts/bench-engagement/score.ts` rule: +"a session counts as engaged only by what it leaves behind"). + +### Phase 0 — instrument validation (deterministic, no agents) + +Prove the blindness landmine discriminates before spending any agent run. The landmine is a +**boundary bug**: the AC requires rejecting `amount <= 0`; the planted implementation rejects only +`amount < 0`, so `amount === 0` is wrongly accepted. + +| Condition | Required outcome | +|---|---| +| correct impl + AC-faithful test | PASS | +| **planted-buggy impl** + AC-faithful test | **FAIL** — a blind author catches it | +| planted-buggy impl + code-derived test | **PASS** — an author who read the code misses it | + +All three rows must hold. **If they do not, the landmine is unscorable and Phase 2 is cancelled** — +per the `case-working-set-landmine.md` precedent, where instrument validation disqualified 2 of 4 +landmines before any agent ran. + +### Phase 1 — deterministic prompt delta (no agents) + +Context cost of each arm's prompt set, via `approxTokens` (`src/cli/benchmark.ts`). Guaranteed +signal, no NULL risk — the same class of measurement as `case-efficiency-measurement.md`. + +### Phase 2 — Q1 live ablation (n = 3 per arm) + +Each agent receives the spec and the **pre-planted buggy implementation**, and is asked to carry the +feature through the cycle. Blind oracle: a hidden AC-faithful test file the arms never see. + +| Metric | Source | Role | +|---|---|---| +| **M1 — blindness held** | does the arm's own authored test fail against the buggy impl? | **primary** | +| M2 — WIP width | max simultaneously non-done spec entries (git history) | secondary | +| M3 — floundering | turns / tokens to the first `feature_created` event | secondary | +| M4 — final verdict | `clad verdict --json` | secondary | + +### Phase 3 — Q2 discipline tripwire (n = 1 per arm) + +Five consecutive features. **n = 1 is deliberate**: this is a tripwire, not an estimate — a single +discipline violation is signal, and a tie is not evidence of equivalence. Escalate to n = 3 only if +a break appears. + +Per feature *i*, from artifacts only: + +- `spec_first` — `feature_created` precedes the first commit touching that feature's modules +- `earned_done` — a `done_attempted` with `kept: true`, and zero hand-written `status: done` +- `gate_runs`, turns, tokens — rising with *i* = drowning; falling = adapting +- independence label — **ARM B only** (the label does not exist in the old build) + +## Decision rules (binding) + +**H1 — removing the choreography does not weaken real separation.** +- Confirmed: M1 ARM B ≥ ARM A. +- **Refuted (blocks the release framing):** ARM B catches the landmine in fewer runs than ARM A. + Restore the separation emphasis in the orchestrator before shipping. +- NULL: equal. Then **no benefit may be claimed** for the removal in README, CHANGELOG or release + notes — it is recorded as safe and neutral. + +**H2 — removing the choreography helps.** +- Confirmed: ARM A measurably worse on M3 (floundering) or wider on M2 (WIP). +- **Refuted:** all metrics tie ⇒ the change was cosmetic. Recorded as such, plainly. + +**H3 — discipline holds across consecutive features.** +- **Refuted:** any `spec_first` or `earned_done` violation in either arm ⇒ a real defect; fix and + re-run rather than ship. + +**Resolution limit, stated up front.** n = 3 resolves only near-total effects (0/3 vs ≥ 2/3). +Anything smaller is reported as **not resolvable at this n**, and a tie is never reported as +equivalence. + +## Safety rules + +- Probe sessions run in isolated tmpdirs and **must not use this repo's `mcp__cladding__*` tools** — + a previous sandbox probe misused them and contaminated the working tree. +- Absolute-path pinning for every arm binary; `case-081` was caught by a stale-`PATH` shadow trap. +- Whatever the outcome, it is committed here. `docs/refinement-backlog.md` B9 makes deleting a NULL + result a policy violation. + +## Results + +### Phase 0 — instrument validation: **PASS, landmine is scorable** + +Boundary landmine: AC requires rejecting `amount <= 0`; planted impl rejects only `amount < 0`, so +`amount === 0` is wrongly accepted. Three deterministic rows, no agents: + +| Condition | Required | Observed | +|---|---|---| +| correct impl + AC-faithful test | PASS | **PASS** | +| planted-buggy impl + AC-faithful test | FAIL | **FAIL** | +| planted-buggy impl + code-derived test | PASS | **PASS** | + +All three hold ⇒ the instrument separates a blind author from one who read the code. +**Phase 2 proceeds.** (Contrast: in `case-working-set-landmine.md` this same phase disqualified +2 of 4 landmines before any agent ran.) + +### Phase 1 — prompt token delta: **the simplification is mostly offset** + +`approxTokens` (`src/cli/benchmark.ts`, `ceil(chars/4)`) over both arms' full persona set: + +| file | ARM A | ARM B | delta | +|---|---:|---:|---:| +| orchestrator | 1776 | 1450 | **−326** | +| planner | 1299 | 1299 | 0 | +| developer | 1318 | 1326 | +8 | +| reviewer | 1201 | 1221 | +20 | +| observability | 852 | 868 | +16 | +| blind-author | 557 | 632 | +75 | +| **total** | **7003** | **6796** | **−207** | + +**Honest finding #1.** The orchestrator did shrink meaningfully — **−18.4%** on its own. But the +five specialist briefs *grew* by +119 tokens combined while being re-framed, so the persona set as a +whole is only **−3.0%**. A 207-token saving across six prompts is not a context-budget argument; +**H2 gains no support from prompt size.** Whatever the change is worth, it is not measured in tokens. + +### Phase 2 — Q1 live ablation: **NULL on the primary metric** + +6 Sonnet 5 agents, n=3/arm, identical isolated fixtures, arms differing only in `ORCHESTRATOR.md`. +Scored by the hidden oracle run against each arm's **final** implementation — never from transcripts. + +| run | arm | M1a oracle | M1b zero-case test | gate runs | done attempts | final status | +|---|---|---|---|---:|---:|---| +| A1 | old | PASS | YES | 17 | 16 | done | +| A2 | old | PASS | YES | 16 | 8 | done | +| A3 | old | PASS | YES | 11 | 4 | done | +| B1 | new | PASS | YES | 18 | 6 | done | +| B2 | new | PASS | YES | 9 | 4 | done | +| B3 | new | PASS | YES | 5 | 3 | done | + +**M1a — the boundary bug was caught 3/3 in both arms.** Every agent, under both prompts, read the AC, +noticed `amount < 0` contradicted "zero or negative", fixed the implementation, and reached a GREEN +`clad done`. **H1 is confirmed: removing the choreography did not weaken real separation.** + +**Per the pre-registered H1 NULL branch, no benefit may be claimed for the removal** in README, +CHANGELOG or release notes. It is recorded as safe and neutral. + +#### M3 — effort favours ARM B but is *not resolvable at this n* + +| | ARM A (old) | ARM B (new) | ratio | +|---|---:|---:|---:| +| median tokens | 139,179 | 117,866 | 0.85 | +| median tool calls | 114 | 77 | 0.68 | +| token range | 121.5k – 176.5k | 89.0k – 125.2k | overlapping | + +The medians favour the contract card, and the ranges very nearly separate — but they *do* overlap +(A3 121.5k < B2 125.2k). The pre-registration fixed the rule before the data: n=3 resolves only +near-total effects, so **this is reported as not resolvable, not as a win.** It is the most +promising direction for a properly powered follow-up, and nothing more. + +#### Honest finding #2 — the apparent "more separation process" pattern is noise + +Mid-campaign it looked as though the old prompt reliably produced blind sub-agent dispatch. Final +tally from the agents' own reports: **ARM A 2/3 (A2, A3), ARM B 1/3 (B2)** — a one-run difference at +n=3. That is noise, and it is withdrawn as a finding. It also fails the scoring bar independently: +host sub-agent dispatch leaves **no artifact**, so it was never measurable here, only self-narrated. + +#### Honest finding #3 — G1 reproduced independently + +Three runs (A2, A3, B2) dispatched genuinely implementation-blind test authors — A3 additionally ran +a separate reviewer that mutation-tested the boundary — and **all three still completed as +`self-certified`**, because no CLI path records that provenance. A3 stated it plainly: *"sub-agent +review evidence isn't recorded through its own oracle/evidence mechanism."* This is independent +corroboration of **G1** from outside the dogfood campaign that first reported it, and it sharpens the +backlog entry: agents that *do* the separation cannot prove it. + +#### Design weakness in this phase (stated, not hidden) + +**M2 (WIP width) had no room to vary** — the task assigned exactly one feature, so all six runs ended +with one feature file. The metric was vacuous as designed and carries no information. WIP is only +testable across a multi-feature sequence, i.e. Phase 3. + +### Phase 3 — Q2 discipline tripwire: **NOT RUN (deliberately)** + +Phase 3 was designed and approved, then **cancelled before spending agent budget**. This is recorded +as *not measured*, never as *answered*. + +Why it was cancelled — the seam it targets is already covered deterministically: + +- The only substantive Q2 risk is the **removed host-mode WIP table** ("1 feature ahead"). Its + backstop, the `PLANNED_BACKLOG` detector, is **already verified by 20 unit cases** + (`tests/stages/planned-backlog.test.ts`); a spec batch racing ahead of the code turns the strict + gate RED regardless of what any prompt says. The prompt used to *advise* it; the engine *enforces* it. +- The `earned_done` axis already scored **6/6 in Phase 2** — every run reached `done` only through + `clad done` on a GREEN gate, and **zero runs hand-wrote `status: done`**. +- Expected cost was 300–500k tokens per arm for a tripwire whose most likely outcome is "both arms + fine" — the same prior that had just proved correct on Q1, in a repo carrying 8+ NULLs on this + class of question. + +**What therefore remains unmeasured**, stated plainly so this document is not read as more than it is: + +- **M2 (WIP width)** was never measured anywhere in this campaign — vacuous in Phase 2 by design + (one feature), and Phase 3 was cancelled. +- **Discipline across a 5-feature sequence** is untested. Phase 2 evidence covers one feature per run. + +## Verdict + +| Hypothesis | Outcome | +|---|---| +| **H1** — removal does not weaken real separation | **CONFIRMED** — 3/3 vs 3/3 on the blind oracle | +| **H2** — removal helps | **NOT RESOLVABLE at n=3** — medians favour ARM B (0.85× tokens, 0.68× tool calls) but the ranges overlap | +| **H3** — discipline holds across consecutive features | **NOT MEASURED** — Phase 3 cancelled (above) | + +**Release consequence.** Nothing here blocks shipping the role-contract change: no regression, gate +GREEN, zero discipline violations observed. But the pre-registered H1 NULL branch binds the framing — +**no benefit may be claimed for the removal in README, CHANGELOG or release notes.** The change is +recorded as *safe and neutral*: it cost nothing and bought nothing measurable at this power. + +**The one durable finding is not about the orchestrator at all.** Three runs performed genuine blind +separation and none could record it (Honest finding #3) — G1, corroborated from outside the dogfood +campaign that first reported it. That is the seam worth an engineering cycle, not further prompt A/Bs. diff --git a/docs/refinement-backlog.md b/docs/refinement-backlog.md index 2204b9a7..fd21bd58 100644 --- a/docs/refinement-backlog.md +++ b/docs/refinement-backlog.md @@ -27,3 +27,4 @@ Survivors of the 2026-07-03 whole-repo audit (baseline: `clad check --strict` 40 - **registerDetector/clearDetectors registry & 1-entry SDK_REGISTRY**: documented extension seam + test affordance; multi-provider roadmap reserves the SDK slots. - **SCALE_GATE=8 constant dedup (4 copies)**: trivial churn, no behavior change. - **Committed who-ledger (attestation ledger lines carrying identity + timestamp) — deferred, not rejected**: what it would be — the per-module attestation (spec/attestation.yaml, v2) gains committed ledger lines carrying author identity + timestamp, so who/when survive in tracked content instead of only in the local `.cladding/events.log.jsonl` (gitignored, single 5MB generation → history beyond it is destroyed; records the git/OS account only, AI-vs-human indistinguishable). Deferred because no external team has demanded audit evidence yet — shipping it now is speculative machinery, so the who/what/why README claim was corrected to its verified level instead (F-3c2bf8b9). Reopen trigger: a real external team requires audit evidence of who/when. +- **Independence has no first-party surface — deferred, not rejected**: the `independent | self-certified` label ships and is judged correctly (`src/hitl/independence.ts`), but nothing in the product lets a user reach it. Three findings, one disease. (a) **The policy switch is read-only from cladding's side** — `independence_policy` appears in `spec/types.ts`, `spec/schema.json`, and one consumer (`src/cli/clad.ts:856`); no CLI verb, MCP tool, or onboarding path ever writes it, so turning enforcement on means hand-editing `spec.yaml`, the one kind of work this product otherwise never asks of a user (the 2026-07-24 E2E had to "hand-set" it — `docs/dogfood/e2e-role-contract-2026-07-24.md:51`). No persona brief, `AGENTS.md`, or `CLAUDE.md` names the key either, so a host AI cannot act on "make completion stricter" without being handed the literal; README.md's Multi-Agent section is currently the setting's only user-facing documentation, which is why the key stays spelled out there. (b) **G1 — `independent` is MCP-gated**: the only first-party writer of independence-eligible evidence is `clad_author_oracle`, so a CLI-only project can perform the separation and still never record it, and under `independence_policy: require` is hard-blocked with no first-party exit. (c) **G2 — `human`-authored evidence has zero writers anywhere**: `recordOracle` hard-codes `identity.author: 'llm'` (`src/oracle/record.ts:105`) and the other two `appendEvidence` call sites write `tool`/adapter identities, so the human half of the label's disjunction — and the `checkAc` demand at stage_4.1, which predates the label — is satisfiable only by hand-editing `.cladding/audit.log.jsonl`. Deferred because no team has asked to enforce independence yet; a CLI attest surface plus a brief mention would be speculative machinery until then, so the README discloses both limits in plain words instead (F-3fd220d8). Reopen trigger: a team tries to turn `independence_policy: require` on, or requires evidence of a person's sign-off. From b4bb9ef45bc5077d16dbbf35740b85f7bd96eaf4 Mon Sep 17 00:00:00 2001 From: qwerfunch Date: Sun, 26 Jul 2026 00:46:54 +0900 Subject: [PATCH 13/13] chore(version): 0.9.2 across the eleven version sites and the four READMEs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Accumulates the unreleased role-contract work onto a patch bump. Run through `npm run version-bump -- 0.9.2` so no site is missed — including the marketplace catalog the host reads to detect "update available", which HARNESS_INTEGRITY guards. The READMEs are not in the script's site list, so their Status tables are moved by hand in all four published variants. Not a release: no tag, no publish, no gh release. Co-Authored-By: Claude Opus 5 --- .claude-plugin/marketplace.json | 2 +- package-lock.json | 4 +- package.json | 2 +- .../claude-code/.claude-plugin/plugin.json | 2 +- plugins/claude-code/dist/clad.js | 4 +- plugins/codex/.codex-plugin/plugin.json | 2 +- plugins/gemini-cli/gemini-extension.json | 2 +- spec.yaml | 4 +- spec/attestation.yaml | 37 +++++++++++-------- spec/index.yaml | 1 + src/cli/clad.ts | 2 +- src/serve/server.ts | 2 +- tests/cli/clad.test.ts | 2 +- 13 files changed, 36 insertions(+), 30 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 425e76f9..99984092 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,7 +9,7 @@ "name": "claude-code", "source": "./plugins/claude-code", "description": "Reference implementation of the Ironclad standard — multi-agent dev harness for Claude Code.", - "version": "0.9.1", + "version": "0.9.2", "author": { "name": "qwerfunch" }, diff --git a/package-lock.json b/package-lock.json index e1025450..2495dd1c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "license": "MIT", "dependencies": { "@anthropic-ai/sdk": "^0.96.0", diff --git a/package.json b/package.json index bec402f0..afb136d5 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "description": "Spec-driven verification layer for AI coding agents — Claude Code · Codex · Gemini · Antigravity · Cursor. Intent in before it writes, result verified against your spec after. Reference implementation of the Ironclad standard.", "type": "module", "license": "MIT", diff --git a/plugins/claude-code/.claude-plugin/plugin.json b/plugins/claude-code/.claude-plugin/plugin.json index 9a3de433..48f15822 100644 --- a/plugins/claude-code/.claude-plugin/plugin.json +++ b/plugins/claude-code/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "description": "Reference implementation of the Ironclad standard — multi-agent dev harness for Claude Code.", "author": { "name": "qwerfunch" diff --git a/plugins/claude-code/dist/clad.js b/plugins/claude-code/dist/clad.js index 66897267..b34f9083 100755 --- a/plugins/claude-code/dist/clad.js +++ b/plugins/claude-code/dist/clad.js @@ -457,7 +457,7 @@ schema: "0.1" source: spec.yaml `});function Yc(t){let e=t.identity.timestamp??new Date().toISOString(),r=`ev-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`;return{...t,id:r,identity:{...t.identity,timestamp:e}}}var yA=y(()=>{"use strict"});import{existsSync as UJe,mkdirSync as qJe,readFileSync as Uue,readdirSync as BJe,writeFileSync as que}from"node:fs";import{dirname as HJe,join as Gq}from"node:path";function ZJe(t,e){return`${GJe}/${t}.${e}.test.ts`}function VJe(t,e){let r=Gq(t,"spec/features");if(!UJe(r))return null;for(let n of BJe(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml"))){let i=Gq(r,n);try{if((0,co.parseDocument)(Uue(i,"utf8")).get("id")===e)return i}catch{}}return null}function WJe(t,e,r,n){let i=VJe(t,e);if(!i)return!1;let o=(0,co.parseDocument)(Uue(i,"utf8")),s=o.get("acceptance_criteria");if(!(0,co.isSeq)(s))return!1;let a=s.items.find(l=>(0,co.isMap)(l)&&l.get("id")===r);if(!a||!(0,co.isMap)(a))return!1;let c=a.get("oracle_refs",!0);if((0,co.isSeq)(c)){if(c.items.some(l=>((0,co.isMap)(l)?void 0:l.value)===n))return!0;c.add(n)}else a.set("oracle_refs",[n]);return que(i,String(o),"utf8"),!0}function Bue(t){let e=t.cwd??".",r=ZJe(t.featureId,t.acId),n=Gq(e,r);qJe(HJe(n),{recursive:!0}),que(n,t.body.endsWith(` `)?t.body:`${t.body} -`,"utf8");let i=Yc({featureId:t.featureId,acId:t.acId,stage:"stage_2.3",identity:{author:"llm",name:t.authorName??"oracle-author"},kind:"oracle",content:`impl-blind oracle authored for ${t.featureId}.${t.acId} (blind=${t.blind===!0})`,artifact:r,readManifest:t.readManifest,blind:t.blind===!0});return Za(e,i),WJe(e,t.featureId,t.acId,r)?{ok:!0,oraclePath:r,evidenceId:i.id}:{ok:!1,oraclePath:r,evidenceId:i.id,reason:`oracle + provenance written, but could not stamp oracle_refs (no shard for ${t.featureId}.${t.acId}) \u2014 add 'oracle_refs: [${r}]' to the AC manually`}}var co,GJe,Hue=y(()=>{"use strict";co=St(er(),1);ln();yA();GJe="tests/oracle"});var sde={};Cr(sde,{PERSONA_IDS:()=>Xue,PERSONA_PROMPT_ALIASES:()=>Que,RESOURCE_URIS:()=>ca,TOOL_NAMES:()=>i8e,buildServer:()=>o8e});import{spawnSync as Gue}from"node:child_process";import{createHash as yy,randomUUID as KJe}from"node:crypto";import{readFileSync as ua,existsSync as En,mkdirSync as Vq,realpathSync as Zue,readdirSync as Yq,rmSync as Xc,statSync as SA,writeFileSync as Jue}from"node:fs";import{basename as JJe,dirname as gy,extname as YJe,isAbsolute as Vue,join as Ct,relative as Yue,resolve as Wq,sep as XJe}from"node:path";import{fileURLToPath as QJe}from"node:url";import{TextDecoder as e8e}from"node:util";import{deflateRawSync as t8e,inflateRawSync as r8e}from"node:zlib";import{tmpdir as n8e}from"node:os";function o8e(t={}){let e=t.cwd??".",r=new mA({name:t.name??"cladding",version:t.version??"0.9.1"},{instructions:"For explicit Cladding onboarding, always call clad_prepare_init first, draft the requested structured data with the current host model, then call clad_stage_init before showing the planned changes. Wait for a separate user confirmation before calling clad_init with the confirmation verbatim. For each real user answer, call clad_prepare_clarify and then clad_clarify only after a new user message supplies the answer. Never infer an answer or call clarify during the initialization approval turn. Never run onboarding shell commands or request MCP sampling. Prepare tools are read-only; apply tools validate and write.",capabilities:{resources:{subscribe:!0}}});return y8e(r,e,t.onboarding),v8e(r,e),S8e(r,e),s8e(r),a8e(r,e),r}function s8e(t){t.server.setRequestHandler(Yz,async()=>({})),t.server.setRequestHandler(Xz,async()=>({}))}function a8e(t,e){U8(r=>{r===e&&t.server.sendResourceUpdated({uri:ca.audit})})}function la(t){try{return{spec:q(t)}}catch(e){return{error:`cladding: spec not loaded \u2014 ${e.message}. Run \`clad init\` to scaffold spec.yaml first.`}}}function c8e(t){return"error"in la(t)?"cladding: not_initialized \u2014 this project has host wiring but no valid spec.yaml; ordinary work must remain ordinary until the user explicitly requests Cladding initialization.":null}function fy(t){let e=c8e(t);return e?{isError:!0,content:[{type:"text",text:e}]}:null}function py(t){try{let e=oi({cwd:t}),r=e.findings.filter(n=>n.severity!=="info").slice(0,3).map(n=>({detector:n.detector,severity:n.severity,message:n.message.slice(0,220)}));return e.pass?{pass:!0,findings:r}:{pass:!1,findings:r,next:"Resolve these findings, then verify with clad_run_gate (or `clad check --strict`) before `clad done`."}}catch{return{pass:!1,unavailable:!0,findings:[],next:"gate could not run \u2014 verify with `clad check --strict`."}}}function Zq(t,e,r,n,i){try{tr(t,"working_set_served",{tool:e,query:r,resolved:n,...i??{}})}catch{}}function Wue(){let t=gy(QJe(import.meta.url));for(let r=0;r<5;r++){let n=Ct(t,"bin","clad");if(En(n))return n;t=gy(t)}let e=process.argv[1];return e&&JJe(e)==="clad.js"&&En(e)?e:null}function u8e(t,e){if(!e.trim())return{error:"document_path is required for document mode"};if(Vue(e))return{error:"document_path must be relative to the connected project"};let r=Zue(Wq(t)),n=Wq(r,e);if(!En(n))return{error:`planning document not found: ${e}`};let i;try{i=Zue(n)}catch(s){return{error:`planning document could not be resolved: ${s.message}`}}let o=Yue(r,i);if(o===".."||o.startsWith(`..${XJe}`)||Vue(o))return{error:"planning document must stay inside the connected project"};if(!SA(i).isFile())return{error:"planning document must be a regular file"};if(!l8e.has(YJe(i).toLowerCase()))return{error:"planning document must be .md, .txt, .yaml, .yml, or .markdown"};try{let s=new e8e("utf-8",{fatal:!0}).decode(ua(i));return{path:o,text:s}}catch(s){return{error:`planning document is not readable UTF-8 text: ${s.message}`}}}function ede(t){let e=t8e(Buffer.from(JSON.stringify(t))).toString("base64url");return`v1.${yy("sha256").update(e).digest("hex").slice(0,24)}.${e}`}function Kq(t){let e=/^v1\.([a-f0-9]{24})\.([A-Za-z0-9_-]+)$/.exec(t);if(!e||yy("sha256").update(e[2]).digest("hex").slice(0,24)!==e[1])return null;try{let r=JSON.parse(r8e(Buffer.from(e[2],"base64url"),{maxOutputLength:bA}).toString("utf8"));return r.kind!=="init"&&r.kind!=="clarify"||typeof r.snapshot!="string"||typeof r.intent!="string"?null:r}catch{return null}}function vA(t,e,r=!1){let n=yy("sha256").update(`${Wq(t)}\0${e}`).digest("hex");return r?Ct(t,".cladding","host","onboarding-pending",`${n}.json`):Ct(n8e(),"cladding-onboarding-pending",`${n}.json`)}function f8e(t){let e;try{e=Yq(t)}catch{return}for(let r of e){if(!r.endsWith(".json"))continue;let n=Ct(t,r);try{let i=JSON.parse(ua(n,"utf8"));(!i.expiresAt||i.expiresAt{if(En(n))for(let i of Yq(n,{withFileTypes:!0}).sort((o,s)=>o.name.localeCompare(s.name))){if(i.name===".git"||i.name===".cladding"||i.name==="node_modules")continue;let o=Ct(n,i.name),s=Yue(t,o);if(i.isDirectory())r(o);else if(i.isFile()){let a=SA(o);e.update(`${s}\0${a.size}\0${a.mtimeMs} +`,"utf8");let i=Yc({featureId:t.featureId,acId:t.acId,stage:"stage_2.3",identity:{author:"llm",name:t.authorName??"oracle-author"},kind:"oracle",content:`impl-blind oracle authored for ${t.featureId}.${t.acId} (blind=${t.blind===!0})`,artifact:r,readManifest:t.readManifest,blind:t.blind===!0});return Za(e,i),WJe(e,t.featureId,t.acId,r)?{ok:!0,oraclePath:r,evidenceId:i.id}:{ok:!1,oraclePath:r,evidenceId:i.id,reason:`oracle + provenance written, but could not stamp oracle_refs (no shard for ${t.featureId}.${t.acId}) \u2014 add 'oracle_refs: [${r}]' to the AC manually`}}var co,GJe,Hue=y(()=>{"use strict";co=St(er(),1);ln();yA();GJe="tests/oracle"});var sde={};Cr(sde,{PERSONA_IDS:()=>Xue,PERSONA_PROMPT_ALIASES:()=>Que,RESOURCE_URIS:()=>ca,TOOL_NAMES:()=>i8e,buildServer:()=>o8e});import{spawnSync as Gue}from"node:child_process";import{createHash as yy,randomUUID as KJe}from"node:crypto";import{readFileSync as ua,existsSync as En,mkdirSync as Vq,realpathSync as Zue,readdirSync as Yq,rmSync as Xc,statSync as SA,writeFileSync as Jue}from"node:fs";import{basename as JJe,dirname as gy,extname as YJe,isAbsolute as Vue,join as Ct,relative as Yue,resolve as Wq,sep as XJe}from"node:path";import{fileURLToPath as QJe}from"node:url";import{TextDecoder as e8e}from"node:util";import{deflateRawSync as t8e,inflateRawSync as r8e}from"node:zlib";import{tmpdir as n8e}from"node:os";function o8e(t={}){let e=t.cwd??".",r=new mA({name:t.name??"cladding",version:t.version??"0.9.2"},{instructions:"For explicit Cladding onboarding, always call clad_prepare_init first, draft the requested structured data with the current host model, then call clad_stage_init before showing the planned changes. Wait for a separate user confirmation before calling clad_init with the confirmation verbatim. For each real user answer, call clad_prepare_clarify and then clad_clarify only after a new user message supplies the answer. Never infer an answer or call clarify during the initialization approval turn. Never run onboarding shell commands or request MCP sampling. Prepare tools are read-only; apply tools validate and write.",capabilities:{resources:{subscribe:!0}}});return y8e(r,e,t.onboarding),v8e(r,e),S8e(r,e),s8e(r),a8e(r,e),r}function s8e(t){t.server.setRequestHandler(Yz,async()=>({})),t.server.setRequestHandler(Xz,async()=>({}))}function a8e(t,e){U8(r=>{r===e&&t.server.sendResourceUpdated({uri:ca.audit})})}function la(t){try{return{spec:q(t)}}catch(e){return{error:`cladding: spec not loaded \u2014 ${e.message}. Run \`clad init\` to scaffold spec.yaml first.`}}}function c8e(t){return"error"in la(t)?"cladding: not_initialized \u2014 this project has host wiring but no valid spec.yaml; ordinary work must remain ordinary until the user explicitly requests Cladding initialization.":null}function fy(t){let e=c8e(t);return e?{isError:!0,content:[{type:"text",text:e}]}:null}function py(t){try{let e=oi({cwd:t}),r=e.findings.filter(n=>n.severity!=="info").slice(0,3).map(n=>({detector:n.detector,severity:n.severity,message:n.message.slice(0,220)}));return e.pass?{pass:!0,findings:r}:{pass:!1,findings:r,next:"Resolve these findings, then verify with clad_run_gate (or `clad check --strict`) before `clad done`."}}catch{return{pass:!1,unavailable:!0,findings:[],next:"gate could not run \u2014 verify with `clad check --strict`."}}}function Zq(t,e,r,n,i){try{tr(t,"working_set_served",{tool:e,query:r,resolved:n,...i??{}})}catch{}}function Wue(){let t=gy(QJe(import.meta.url));for(let r=0;r<5;r++){let n=Ct(t,"bin","clad");if(En(n))return n;t=gy(t)}let e=process.argv[1];return e&&JJe(e)==="clad.js"&&En(e)?e:null}function u8e(t,e){if(!e.trim())return{error:"document_path is required for document mode"};if(Vue(e))return{error:"document_path must be relative to the connected project"};let r=Zue(Wq(t)),n=Wq(r,e);if(!En(n))return{error:`planning document not found: ${e}`};let i;try{i=Zue(n)}catch(s){return{error:`planning document could not be resolved: ${s.message}`}}let o=Yue(r,i);if(o===".."||o.startsWith(`..${XJe}`)||Vue(o))return{error:"planning document must stay inside the connected project"};if(!SA(i).isFile())return{error:"planning document must be a regular file"};if(!l8e.has(YJe(i).toLowerCase()))return{error:"planning document must be .md, .txt, .yaml, .yml, or .markdown"};try{let s=new e8e("utf-8",{fatal:!0}).decode(ua(i));return{path:o,text:s}}catch(s){return{error:`planning document is not readable UTF-8 text: ${s.message}`}}}function ede(t){let e=t8e(Buffer.from(JSON.stringify(t))).toString("base64url");return`v1.${yy("sha256").update(e).digest("hex").slice(0,24)}.${e}`}function Kq(t){let e=/^v1\.([a-f0-9]{24})\.([A-Za-z0-9_-]+)$/.exec(t);if(!e||yy("sha256").update(e[2]).digest("hex").slice(0,24)!==e[1])return null;try{let r=JSON.parse(r8e(Buffer.from(e[2],"base64url"),{maxOutputLength:bA}).toString("utf8"));return r.kind!=="init"&&r.kind!=="clarify"||typeof r.snapshot!="string"||typeof r.intent!="string"?null:r}catch{return null}}function vA(t,e,r=!1){let n=yy("sha256").update(`${Wq(t)}\0${e}`).digest("hex");return r?Ct(t,".cladding","host","onboarding-pending",`${n}.json`):Ct(n8e(),"cladding-onboarding-pending",`${n}.json`)}function f8e(t){let e;try{e=Yq(t)}catch{return}for(let r of e){if(!r.endsWith(".json"))continue;let n=Ct(t,r);try{let i=JSON.parse(ua(n,"utf8"));(!i.expiresAt||i.expiresAt{if(En(n))for(let i of Yq(n,{withFileTypes:!0}).sort((o,s)=>o.name.localeCompare(s.name))){if(i.name===".git"||i.name===".cladding"||i.name==="node_modules")continue;let o=Ct(n,i.name),s=Yue(t,o);if(i.isDirectory())r(o);else if(i.isFile()){let a=SA(o);e.update(`${s}\0${a.size}\0${a.mtimeMs} `)}}};return r(t),e.digest("hex")}function hy(t){let e=yy("sha256").update(m8e(t)),r=Ct(t,".cladding","onboarding","state.yaml");return e.update(En(r)?ua(r):Buffer.from("absent")),e.digest("hex")}function ide(t,e){let r=new Map,n=new Set,i=o=>{let s=Ct(t,o);if(!En(s))return;let a=SA(s);if(a.isFile()){r.set(o,ua(s));return}if(a.isDirectory()){n.add(o);for(let c of Yq(s))i(Ct(o,c))}};for(let o of e)i(o);return{files:r,directories:n}}function ode(t,e,r){for(let n of e)Xc(Ct(t,n),{recursive:!0,force:!0});for(let n of[...r.directories].sort((i,o)=>i.length-o.length))Vq(Ct(t,n),{recursive:!0});for(let[n,i]of r.files)Vq(gy(Ct(t,n)),{recursive:!0}),Jue(Ct(t,n),i)}function h8e(t){return ide(t,nde)}function g8e(t,e){ode(t,nde,e)}function mt(t,e=!1){return{...e?{isError:!0}:{},structuredContent:t,content:[{type:"text",text:JSON.stringify(t,null,2)}]}}function y8e(t,e,r){let n=new Map,i=!1,o=()=>{i||(i=!0,_8e(t,e,n,r))};t.registerTool("clad_prepare_init",{title:"Prepare Cladding onboarding context",description:"Non-destructive first step for every explicit Cladding initialization request: writes no authored project files (only a TTL'd consent cache). Inspect the connected project, then use this tool result to draft the structured input for clad_init. Never run clad init in a shell.",inputSchema:{mode:E.enum(["idea","document","existing"]),intent:E.string().optional(),document_path:E.string().optional(),refresh:E.boolean().optional()},outputSchema:{status:E.string(),changed:E.boolean(),schemaVersion:E.number().optional(),token:E.string().optional(),prompt:E.string().optional(),request:E.object({mode:E.string(),intent:E.string()}).optional(),observation:E.record(E.string(),E.unknown()).optional(),question:E.string().optional(),error:E.string().optional(),plannedChanges:E.array(E.string()).optional(),confirmationQuestion:E.string().optional(),requiresSeparateUserConfirmation:E.boolean().optional(),approvalChallenge:E.string().optional()},annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0}},async s=>{if(!r)return mt({status:"unavailable",changed:!1},!0);if(En(Ct(e,"spec.yaml"))&&!s.refresh)return mt({status:"already_initialized",changed:!1});let a=s.intent?.trim()??"";if(s.mode==="idea"&&!a)return mt({status:"needs_input",changed:!1,question:"What kind of project are you building?"});if(s.mode==="document"){let p=u8e(e,s.document_path??"");if(p.error)return mt({status:"invalid_request",changed:!1,error:p.error},!0);a=p.text}s.mode==="existing"&&!a&&(a="Adopt Cladding into the observed existing project.");let c=r.prepareInit({cwd:e,mode:s.mode,intent:a}),l=p8e(),u=Number(c.observation.source_file_count??0),d={kind:"init",snapshot:hy(e),mode:s.mode,intent:a,refresh:s.refresh,approvalChallenge:l,scan:s.mode==="existing"||u>0},f=ede(d);return n.set(f,d),Jq(e,l,f,d),mt({status:"needs_confirmation",changed:!1,schemaVersion:1,token:f,prompt:c.prompt,request:c.request,observation:c.observation,plannedChanges:s.refresh?["Preserve authored files and write review proposals under .cladding/scan/.","Propose refreshed docs/project-context.md, spec/architecture.yaml, and spec/capabilities.yaml."]:["Create spec.yaml, spec/architecture.yaml, and spec/capabilities.yaml.","Create 1-3 spec/scenarios/*.yaml journey files.","Create docs/project-context.md and docs/conventions.md.","Create .cladding/onboarding/state.yaml and append .cladding/ to .gitignore.","Create a managed AGENTS.md block; preserve an existing unmanaged AGENTS.md.","Preserve any existing CLAUDE.md unchanged; AGENTS.md is the shared host instruction surface."],confirmationQuestion:`To apply these changes, reply with the exact approval phrase: ${l}`,approvalChallenge:l,requiresSeparateUserConfirmation:!0})}),t.registerTool("clad_stage_init",{title:"Stage a Cladding onboarding draft for approval",description:"Validate and temporarily cache the host-model draft from clad_prepare_init before showing the approval phrase. This does not modify project files and lets a later host process apply the exact staged draft.",inputSchema:{token:E.string().min(1).max(bA),draft:_A},outputSchema:{status:E.string(),changed:E.boolean(),approvalChallenge:E.string().optional(),confirmationQuestion:E.string().optional(),error:E.string().optional()},annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0}},async s=>{let a=n.get(s.token)??Kq(s.token);return!a||a.kind!=="init"||!a.approvalChallenge?mt({status:"invalid_token",changed:!1},!0):a.snapshot!==hy(e)?mt({status:"stale_preparation",changed:!1},!0):(Jq(e,a.approvalChallenge,s.token,a,s.draft),mt({status:"staged",changed:!1,approvalChallenge:a.approvalChallenge,confirmationQuestion:`To apply these changes, reply with the exact approval phrase: ${a.approvalChallenge}`}))}),t.registerTool("clad_init",{title:"Apply a validated Cladding onboarding draft",description:"Write Cladding artifacts from the host model draft returned after clad_prepare_init. Use the one-time token when the host retained it; process-per-turn hosts may use the exact approval phrase through the short-lived project runtime cache. Copy the complete user message, including the APPLY CLADDING prefix, into confirmation. Malformed, stale, or replayed requests do not write files.",inputSchema:{token:E.string().min(1).max(bA).optional(),confirmation:E.string().regex(/^APPLY CLADDING [A-F0-9]{6}$/).describe("The complete separate user reply, verbatim, including the APPLY CLADDING prefix"),draft:_A.optional()},outputSchema:{status:E.string(),changed:E.boolean(),created:E.array(E.string()).optional(),skipped:E.array(E.string()).optional(),language:E.string().optional(),proposals:E.array(E.string()).optional(),clarifyingQuestions:E.array(E.string()).optional(),onboardingMode:E.enum(["greenfield","existing-adoption","mixed"]).optional(),onboardingSource:E.string().optional(),nextQuestion:E.string().nullable().optional(),remainingQuestions:E.number().optional(),error:E.string().optional(),confirmation:E.string().optional()},annotations:{readOnlyHint:!1,destructiveHint:!0,idempotentHint:!1}},async s=>{let a=tde(e,s.confirmation.trim()),c=(s.token?n.get(s.token)??Kq(s.token):null)??a?.request;if(!c||c.kind!=="init")return mt({status:"invalid_token",changed:!1},!0);if(!c.approvalChallenge||s.confirmation.trim()!==c.approvalChallenge)return mt({status:"confirmation_required",changed:!1,error:"The exact one-time approval phrase shown in the preview is required."},!0);if(c.snapshot!==hy(e))return mt({status:"stale_preparation",changed:!1},!0);if(!r)return mt({status:"unavailable",changed:!1},!0);let l=s.draft??a?.draft;if(!l)return mt({status:"draft_required",changed:!1,error:"No staged onboarding draft is available. Prepare and stage the draft again before approval."},!0);s.token&&n.delete(s.token),rde(e,s.confirmation.trim());let u=r.renderDraft(l),d=h8e(e),f;try{f=await r.initialize({cwd:e,intent:c.intent,scan:c.scan?!0:void 0,hostDispatcher:async()=>u})}catch(h){return g8e(e,d),mt({status:"failed",changed:!1,error:`Initialization failed; all onboarding files were restored: ${h.message}`},!0)}let p=f.clarifyingQuestions??[],m={status:p.length>0?"needs_answers":"initialized",changed:!0,...f,onboardingSource:"host",confirmation:s.confirmation,nextQuestion:p[0]??null,remainingQuestions:p.length};return o(),mt(m)}),En(Ct(e,"spec.yaml"))&&o()}function _8e(t,e,r,n){t.registerTool("clad_prepare_clarify",{title:"Prepare the next Cladding onboarding answer",description:"Use only after a new user message answers the displayed pending question. Pass that answer verbatim. Never call during the initialization approval turn and never invent an answer.",inputSchema:{answer:E.string().min(1)},outputSchema:{status:E.string(),changed:E.boolean(),schemaVersion:E.number().optional(),token:E.string().optional(),prompt:E.string().optional(),request:E.object({mode:E.string(),intent:E.string()}).optional(),observation:E.record(E.string(),E.unknown()).optional(),error:E.string().optional()},annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!0}},async i=>{if(!n)return mt({status:"unavailable",changed:!1},!0);let o=n.prepareClarify(i.answer,{cwd:e});if("error"in o)return mt({status:"invalid_state",changed:!1,error:o.error},!0);let s={kind:"clarify",snapshot:hy(e),mode:"idea",intent:o.request.intent,answer:i.answer},a=ede(s);return r.set(a,s),Jq(e,`clarify:${i.answer}`,a,s),mt({status:"needs_host_draft",changed:!1,schemaVersion:1,token:a,prompt:o.prompt,request:o.request,observation:o.observation})}),t.registerTool("clad_clarify",{title:"Answer the next Cladding onboarding question",description:"Apply a host-model refinement only for an answer supplied in a new user message after the pending question. Never call during the initialization approval turn; do not invent or alter the user answer.",inputSchema:{answer:E.string().min(1).describe("The user's answer, verbatim"),token:E.string().min(1).max(bA).optional(),draft:_A},outputSchema:{status:E.string(),changed:E.boolean(),cwd:E.string().optional(),answered:E.unknown().optional(),newQuestions:E.array(E.string()).optional(),mode:E.enum(["greenfield","existing-adoption","mixed"]).nullable().optional(),nextQuestion:E.string().nullable().optional(),remainingQuestions:E.number().optional(),refinementSource:E.string().optional(),pendingReview:E.array(E.string()).optional(),error:E.string().optional()},annotations:{readOnlyHint:!1,destructiveHint:!0,idempotentHint:!1}},async i=>{let o=tde(e,`clarify:${i.answer}`),s=(i.token?r.get(i.token)??Kq(i.token):null)??o?.request;if(!s||s.kind!=="clarify"||s.answer!==i.answer)return mt({status:"invalid_token",changed:!1},!0);if(s.snapshot!==hy(e))return mt({status:"stale_preparation",changed:!1},!0);if(!n)return mt({status:"unavailable",changed:!1},!0);i.token&&r.delete(i.token),rde(e,`clarify:${i.answer}`);let a=n.renderDraft(i.draft),c=await n.clarify(i.answer,{cwd:e,hostDispatcher:async()=>a});return c.ok?mt({...c.report??{},changed:!0,refinementSource:"host"}):mt({status:"failed",changed:!1,error:c.error??"onboarding clarification failed"},!0)}),t.registerTool("clad_resolve_onboarding_review",{title:"Apply reviewed onboarding design proposals",description:"After showing proposal diffs and receiving explicit user approval, applies only the selected pending proposal targets. Never call this automatically; authored design is preserved until the user reviews it.",inputSchema:{targets:E.array(E.string()).min(1).describe("Exact active artifact paths returned in pendingReview.")},annotations:{readOnlyHint:!1,destructiveHint:!0,idempotentHint:!1}},async i=>{if(!n)return mt({status:"unavailable",changed:!1},!0);let o=n.resolveReview(i.targets,{cwd:e});return mt({status:o.status??(o.ok?"resolved":"failed"),changed:o.changed,remaining:o.remaining,error:o.error},!o.ok)}),t.registerTool("clad_list_features",{title:"List cladding features",description:"List features from spec.yaml. Optionally filter by status or slug substring, and sort alphabetically (default) or by recent file mtime.",inputSchema:{statusFilter:E.enum(["planned","in_progress","done","archived"]).optional().describe("Limit to features with this status"),slugSubstring:E.string().optional().describe("Case-insensitive substring match on slug (e.g. 'auth')"),sort:E.enum(["alphabetical","recent"]).optional().describe("'alphabetical' (default \u2014 by id) or 'recent' (by file mtime, newest first)")},annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0}},async i=>{let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let a=o.spec.features;if(i.statusFilter&&(a=a.filter(u=>u.status===i.statusFilter)),i.slugSubstring){let u=i.slugSubstring.toLowerCase();a=a.filter(d=>{let f=d.slug;return f?f.toLowerCase().includes(u):!1})}let l=(i.sort==="recent"?b8e(a,e):a).map(u=>({id:u.id,slug:u.slug,title:u.title,status:u.status}));return{content:[{type:"text",text:JSON.stringify({total:l.length,features:l},null,2)}]}}),t.registerTool("clad_get_feature",{title:"Get a cladding feature",description:'Returns one feature record by id (e.g. "F-049" or "F-a3f9c2") or by slug (e.g. "login-flow"). When a slug matches multiple features, all matches are returned.',inputSchema:{id:E.string().optional().describe('Feature id such as "F-049" or "F-a3f9c2"'),slug:E.string().optional().describe("Feature slug such as 'login-flow'")},annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0}},async i=>{if(!i.id&&!i.slug)return{isError:!0,content:[{type:"text",text:"provide either id or slug"}]};let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let s=o.spec.features.filter(c=>!!(i.id&&c.id===i.id||i.slug&&c.slug===i.slug));if(s.length===0)return{isError:!0,content:[{type:"text",text:`no feature with ${i.id?`id "${i.id}"`:`slug "${i.slug}"`} found`}]};let a=s.length===1?s[0]:{matches:s};return{content:[{type:"text",text:JSON.stringify(a,null,2)}]}}),t.registerTool("clad_run_check",{title:"Run cladding drift check",description:"Runs `clad check` drift detection. Returns a TERSE report by default (pass, error/warn counts, top 3 blocking findings) to keep the agent loop cheap; pass verbose:true for every finding incl. info-severity + suggestions.",inputSchema:{strict:E.boolean().optional().describe("Treat warnings as errors when true"),verbose:E.boolean().optional().describe("Return the full report (all findings incl. info + suggestions) instead of the terse top-3 summary")},annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0}},async i=>{let o=oi({strict:i.strict,cwd:e});if(i.verbose)return{content:[{type:"text",text:JSON.stringify(o,null,2)}],isError:!o.pass};let s=o.findings??[],a=s.filter(d=>d.severity==="error"),c=s.filter(d=>d.severity==="warn"),l=(a.length>0?a:c).slice(0,3).map(d=>({detector:d.detector,severity:d.severity,message:d.message,...d.path?{path:d.path}:{},...d.line?{line:d.line}:{}})),u={stage:o.stage,pass:o.pass,errorCount:a.length,warnCount:c.length,findings:l,...a.length+c.length>l.length?{truncated:!0,hint:"call clad_run_check with verbose:true for all findings"}:{}};return{content:[{type:"text",text:JSON.stringify(u,null,2)}],isError:!o.pass}}),t.registerTool("clad_run_gate",{title:"Run the full Iron Law gate",description:"Runs the real `clad check` pipeline for a tier (default pre-commit for latency; pre-push runs type/lint/tests/coverage/conformance/smoke) and returns the untruncated JSON outcome. Strict by default \u2014 this is the verification surface; use clad_run_check for the cheap drift-only view.",inputSchema:{tier:E.enum(["pre-commit","pre-push","all"]).optional().describe("Stage tier (default pre-commit)"),strict:E.boolean().optional().describe("Promote warn findings to blocking (default true)")}},async i=>{let o=Wue();if(!o)return{isError:!0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,error:"cladding engine shim (bin/clad) not found relative to the running server"})}]};let s=i.tier??"pre-commit",a=i.strict!==!1,c=Gue(o,["check",`--tier=${s}`,...a?["--strict"]:[],"--json"],{cwd:e,encoding:"utf8",timeout:3e5});try{let l=JSON.parse(c.stdout||"");return{isError:(l.worst??1)!==0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,...l},null,2)}]}}catch{return{isError:!0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,error:"gate produced no parseable JSON",stderr:(c.stderr??"").slice(0,400)})}]}}}),t.registerTool("clad_verdict",{title:"Poll the loop verdict",description:"One-poll loop decision over the real pre-push strict gate + feature statuses. Runs the gate ONCE and reduces it to {verdict, next_action, remaining} \u2014 call this INSTEAD OF clad_run_gate per loop turn, not in addition. verdict is one of DONE|ITERATE|ESCALATE|BLOCKED|BOOTSTRAP; DONE requires a green gate AND every feature done AND at least one non-liveness behavioral proof.",inputSchema:{tier:E.enum(["pre-commit","pre-push","all"]).optional().describe("Gate tier (default pre-push)")}},async i=>{let o=Wue();if(!o)return{isError:!0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,error:"cladding engine shim (bin/clad) not found relative to the running server"})}]};let s=Gue(o,["verdict","--json",...i.tier?[`--tier=${i.tier}`]:[]],{cwd:e,encoding:"utf8",timeout:3e5});try{let a=JSON.parse(s.stdout||"");return{isError:!1,content:[{type:"text",text:JSON.stringify({schema_version:Lt,...a},null,2)}]}}catch{return{isError:!0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,error:"verdict produced no parseable JSON",stderr:(s.stderr??"").slice(0,400)})}]}}}),t.registerTool("clad_get_context",{title:"Get the context slice for one feature",description:"Returns the working set for ONE feature in one call: the focus feature (full), its transitive depends_on ancestors (title+status), bound scenarios, the matching ai_hints patterns, and the union of the feature's test_refs. Look up by feature id (F-\u2026), slug, or a module path. Prefer this over reading shards by hand \u2014 dispatch the slice, never the whole spec.",inputSchema:{query:E.string().describe("Feature id (F-\u2026), slug, or module path (e.g. src/auth/login.ts)")}},async i=>{try{let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let s=fl(o.spec,i.query),a="not_found"in s;return Zq(e,"clad_get_context",i.query,!a),{isError:a,content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s},null,2)}]}}catch(o){return{isError:!0,content:[{type:"text",text:o.message}]}}}),t.registerTool("clad_get_working_set",{title:"Get the token-budgeted working set for one feature (code + needs + breaks)",description:"Returns ONE token-budgeted working set for a feature/module: must_edit (focus + full ACs + the ACTUAL source code of its modules), needs (forward depends_on), breaks_if_changed (direct dependents + the regression test set), verify (scenarios + tests + oracle_refs + EARS unwanted/state high-risk ACs), guidance (ai_hints), and budget (what was clipped to fit). One call replaces reading the shard + opening each module file + grepping deps/tests. Look up by feature id (F-\u2026), slug, or module path.",inputSchema:{query:E.string().describe("Feature id (F-\u2026), slug, or module path (e.g. src/auth/login.ts)"),max_tokens:E.number().int().positive().max(2e4).optional().describe("Token budget for the payload (default 3000); distant deps then code then tests are clipped to fit")}},async i=>{try{let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let s=xa(o.spec,i.query,{cwd:e,maxTokens:i.max_tokens}),a="not_found"in s?null:{truncated:s.budget.truncated.length>0,sliceTokens:s.budget.used_tokens};return Zq(e,"clad_get_working_set",i.query,a!==null,a??void 0),{isError:"not_found"in s,content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s},null,2)}]}}catch(o){return{isError:!0,content:[{type:"text",text:o.message}]}}}),t.registerTool("clad_get_impact",{title:"Get the blast radius for a change (reverse / impact slice)",description:"Returns what a change to ONE feature or file could break: the transitive dependents (id+title+status), the scenarios bound to any of them, the deduped union of their test_refs (the regression set to re-run), and the modules in the radius. Look up by feature id (F-\u2026), slug, or a module path \u2014 a module fans out to ALL features that touch it. The backward complement of clad_get_context: forward = what this needs, impact = what depends on this. Prefer this over grepping to scope a safe refactor.",inputSchema:{query:E.string().describe("Feature id (F-\u2026), slug, or module path (e.g. src/spec/load.ts)"),max_depth:E.number().int().positive().max(6).optional().describe("Bound the dependent walk to N hops (default: unbounded \u2014 the full transitive radius)")}},async i=>{try{let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let s=Sr(o.spec,i.query,{depth:i.max_depth}),a="not_found"in s;return Zq(e,"clad_get_impact",i.query,!a),{isError:a,content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s},null,2)}]}}catch(o){return{isError:!0,content:[{type:"text",text:o.message}]}}}),t.registerTool("clad_get_graph",{title:"Get the live knowledge graph (focused neighborhood, or a stats summary)",description:"With query: the focus node\u2019s N-hop neighborhood (typed nodes + edges; a path query unions its kind-twins). WITHOUT query: a compact stats summary (counts by kind + top hubs) \u2014 the full graph is tens of thousands of tokens, so use `clad graph export --format json` for a complete dump. Recomputed live, never stale. Node kinds + edge types: docs/knowledge-graph/design.md.",inputSchema:{query:E.string().optional().describe("Focus node: feature id (F-\u2026), slug, or module path. Omit for the stats summary."),max_depth:E.number().int().positive().max(6).optional().describe("Neighborhood radius around the focus node (default: full reachable subgraph from the focus)")}},async i=>{try{let o=la(e);if("error"in o)return{isError:!0,content:[{type:"text",text:o.error}]};let s=o.spec,a=wc(s,e);if(!i.query)return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,summary:!0,stats:Lx(a),hint:"pass query (feature id, slug, or module path) for a neighborhood subgraph; `clad graph export --format json` dumps the full graph"},null,2)}]};let c=Px(s,a,i.query);if(c.length===0)return{isError:!0,content:[{type:"text",text:JSON.stringify({schema_version:Lt,not_found:i.query,accepted_forms:["feature id (F-\u2026)","slug","module path"],discovery:"grep spec/index.yaml \u2014 one line per feature (run clad sync if missing); if the query is a file, fall back to normal code search"},null,2)}]};let l=Ix(a,c,i.max_depth??1/0);return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...l},null,2)}]}}catch(o){return{isError:!0,content:[{type:"text",text:o.message}]}}}),t.registerTool("clad_changelog",{title:"Collect shipped changes since a git ref (changelog manifest)",description:"The deterministic shipped-changes manifest for ..HEAD (default since: latest tag): done-feature shards grouped by capability, the inventory count diff, and feat:/fix: commits naming no feature id. For human release notes, render FROM the manifest \u2014 never invent a change it does not carry. Formats (manifest/markdown/audit/catalog): skills/changelog/SKILL.md.",inputSchema:{since:E.string().optional().describe("Git ref to diff from (default: latest tag via `git describe --tags --abbrev=0`)"),format:E.enum(["manifest","markdown","catalog","audit"]).optional().describe("Payload format (default 'manifest')")}},async i=>{try{let o=i.format??"manifest";if(o==="catalog"){let l=gl(q(e));return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,format:o,content:l},null,2)}]}}let s=i.since??rs(e),a=ns(e,s);if(o==="manifest")return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...a},null,2)}]};let c=o==="audit"?hl(a,q(e),e):ml(a);return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,format:o,content:c},null,2)}]}}catch(o){return{isError:!0,content:[{type:"text",text:o.message}]}}}),t.registerTool("clad_get_events",{title:"Get recent cladding events",description:"Reads .cladding/events.log and returns the most recent entries.",inputSchema:{limit:E.number().int().positive().max(500).optional().describe("Maximum entries to return (default 50)")}},async i=>{let o=i.limit??50,s=Ct(e,".cladding","events.log.jsonl");if(!En(s))return{content:[{type:"text",text:JSON.stringify({events:[],note:"no events log yet"})}]};let l=ua(s,"utf8").split(` `).filter(u=>u.trim().length>0).slice(-o).map(u=>{try{return JSON.parse(u)}catch{return{unparseable:u.slice(0,200)}}});return{content:[{type:"text",text:JSON.stringify({events:l},null,2)}]}}),t.registerTool("clad_create_feature",{title:"Create a new cladding feature",description:"Creates spec/features/.yaml with an auto-generated F- id. Author the feature WITH its acceptance_criteria (and modules) in this one call \u2014 an AC-less feature is a hollow stub that governs nothing. Hash ids are collision-safe across concurrent branches; see docs/spec-ids-multi-dev.md.",inputSchema:{slug:E.string().regex(/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/).describe("Kebab-case slug \u2014 filename + spec.slug field (e.g. 'login-flow')"),title:E.string().optional().describe("Optional human-readable title; defaults to slug"),status:E.enum(["planned","in_progress","done","blocked","archived"]).optional().describe("Optional status; defaults to 'planned'"),modules:E.array(E.string()).optional().describe('Module paths the feature binds to (e.g. ["src/auth/login.ts"]).'),acceptance_criteria:E.array(E.object({ears:E.enum(["ubiquitous","event","state","optional","unwanted","complex"]).optional(),text:E.string().optional().describe('The "The system shall \u2026" statement.'),action:E.string().optional(),response:E.string().optional(),condition:E.string().optional().describe("Trigger/precondition for event/state EARS."),test_refs:E.array(E.string()).optional().describe("Paths to verifying tests."),evidence_refs:E.array(E.string()).optional(),notes:E.string().optional()})).optional().describe("Acceptance criteria authored now (ids auto-assigned AC-001\u2026). Strongly preferred over an empty feature \u2014 this is what makes the feature governable."),design_impact:E.discriminatedUnion("classification",[E.object({classification:E.literal("none"),rationale:E.string().min(1)}),E.object({classification:E.literal("additive"),rationale:E.string().min(1),capability:E.string().regex(/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/),capability_title:E.string().min(1).optional(),scenario:E.string().min(1).optional()}),E.object({classification:E.literal("structural"),rationale:E.string().min(1),artifacts:E.array(E.enum(["spec/architecture.yaml","spec/capabilities.yaml","docs/project-context.md"])).min(1)})]).optional().describe("Optional design-impact decision. Omit for the legacy-compatible create-only path; structural changes remain review_required until resolved.")}},async i=>{let o=fy(e);if(o)return o;let s=ide(e,Kue);try{let a=Fue({slug:i.slug,title:i.title,status:i.status,modules:i.modules,acceptance_criteria:i.acceptance_criteria,design_impact:i.design_impact?{classification:i.design_impact.classification,rationale:i.design_impact.rationale,artifacts:i.design_impact.classification==="structural"?i.design_impact.artifacts:void 0}:void 0,cwd:e});i.design_impact?.classification==="additive"&&(Hq({capability:i.design_impact.capability,feature:a.id,title:i.design_impact.capability_title,cwd:e}),i.design_impact.scenario&&jue({scenario:i.design_impact.scenario,feature:a.id,cwd:e})),my(e);let c=i.design_impact,l={schema_version:Lt,...a,gate:py(e),...c?{designImpact:c.classification==="structural"?{status:"review_required",artifacts:c.artifacts,next:"Preview and apply the listed Tier-B design changes, then call clad_resolve_design_impact."}:{status:"resolved",classification:c.classification}}:{hint:`If this feature is user-facing, link it to a capability with clad_link_capability (capability: , feature: ${a.id}) so the Tier-B design SSoT grows with development instead of being left an empty seed.`}};return{content:[{type:"text",text:JSON.stringify(l,null,2)}]}}catch(a){return ode(e,Kue,s),{isError:!0,content:[{type:"text",text:a.message}]}}}),t.registerTool("clad_resolve_design_impact",{title:"Resolve a reviewed structural design impact",description:"Marks a feature structural design impact resolved only after the user-approved Tier-B changes have been applied. Do not call this merely to clear the gate; verify every artifact listed in the feature first.",inputSchema:{feature:E.string().describe("Feature id whose listed Tier-B design changes are now applied.")}},async i=>{let o=fy(e);if(o)return o;try{let s=Mue({feature:i.feature,cwd:e});return my(e),{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s,gate:py(e)},null,2)}]}}catch(s){return{isError:!0,content:[{type:"text",text:s.message}]}}}),t.registerTool("clad_author_oracle",{title:"Record an impl-blind spec-conformance oracle",description:"Records a host-authored conformance oracle for a feature AC + its impl-blind PROVENANCE, writes the test under tests/oracle/, and stamps oracle_refs so the SPEC_CONFORMANCE gate verifies it. cladding does NOT author the oracle. AUTHOR ONLY ACs on the policy worklist (`clad oracle --required`) \u2014 an empty worklist means do not author unless the user explicitly asks (out-of-policy recordings are labeled voluntary). FIRST run `clad oracle --ac ` for the spec-only brief; spawn a FRESH sub-agent given ONLY that brief (never the implementation); have it write the test; then call this with the body + the manifest of exactly what the sub-agent saw. Blindness is your discipline \u2014 the gate audits the manifest (manifest\u2229modules must be empty) and the author\u2260implementer identity, and records whether you attested a clean (blind) context.",inputSchema:{featureId:E.string().describe("The F- feature id."),acId:E.string().describe("The AC- the oracle verifies."),body:E.string().describe("The authored vitest oracle source (imports the module under test)."),readManifest:E.array(E.string()).describe("EXACTLY what the blind sub-agent was shown (the clad oracle brief: spec/AC + signatures). MUST NOT include an implementation file the feature owns."),blind:E.boolean().optional().describe("True only if the sub-agent saw the spec-only brief and nothing else."),authorName:E.string().optional().describe("Oracle author identity (sub-agent / model id) \u2014 must differ from the implementer for the gate to pass.")}},async i=>{let o=fy(e);if(o)return o;try{let s=Bue({featureId:i.featureId,acId:i.acId,body:i.body,readManifest:i.readManifest,blind:i.blind,authorName:i.authorName,cwd:e});my(e);let a={};try{let c=q(e),l=Cp(c.project,Dp(c)),d=c.features.find(f=>f.id===i.featureId)?.acceptance_criteria?.find(f=>f.id===i.acId);(!d||!Np(l,i.featureId,d))&&(a={voluntary:!0,cost_note:"this AC is not on the project's oracle worklist (`clad oracle --required`) \u2014 recording anyway as voluntary; prefer policy-listed ACs to keep token spend inside the declared verification budget."})}catch{}return{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s,...a,gate:py(e)},null,2)}],isError:!s.ok}}catch(s){return{isError:!0,content:[{type:"text",text:s.message}]}}}),t.registerTool("clad_create_scenario",{title:"Create a new cladding scenario",description:"Creates spec/scenarios/-.yaml with an auto-generated S- id. Same multi-dev safety property as clad_create_feature: two concurrent invocations on separate branches produce distinct hash ids by construction.",inputSchema:{slug:E.string().regex(/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/).describe("Kebab-case slug (e.g. 'checkout-happy-path')"),title:E.string().optional().describe("Optional human-readable title; defaults to slug"),flow:E.string().optional().describe("Prose user-journey flow (what the user does, step by step)."),features:E.array(E.string().regex(/^F-(\d{3,}|[a-f0-9]{6,})$/)).optional().describe("Optional list of feature ids the scenario touches")}},async i=>{let o=fy(e);if(o)return o;try{let s=Lue({slug:i.slug,title:i.title,flow:i.flow,features:i.features,cwd:e});return my(e),{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s,gate:py(e)},null,2)}]}}catch(s){return{isError:!0,content:[{type:"text",text:s.message}]}}}),t.registerTool("clad_link_capability",{title:"Link a feature to a capability",description:"Upserts a feature into spec/capabilities.yaml: creates the capability if absent, else appends the feature to its features[] (deduped). A capability is ACCUMULATIVE, so the verb is link, not create. Use this when a user-facing feature lands so the design tier grows with development instead of being left an empty seed.",inputSchema:{capability:E.string().regex(/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/).describe("Capability id (kebab-slug, e.g. 'auth'). Created if it does not exist yet."),feature:E.string().regex(/^F-(\d{3,}|[a-f0-9]{6,})$/).describe("Feature id to add to the capability"),title:E.string().optional().describe("Title, used only when the capability is newly created"),summary:E.string().optional().describe("Summary, used only when newly created"),surface:E.enum(["feature","platform","tool","infrastructure"]).optional().describe("Surface, used only when newly created")}},async i=>{let o=fy(e);if(o)return o;try{let s=Hq({capability:i.capability,feature:i.feature,title:i.title,summary:i.summary,surface:i.surface,cwd:e});return my(e),{content:[{type:"text",text:JSON.stringify({schema_version:Lt,...s,gate:py(e)},null,2)}]}}catch(s){return{isError:!0,content:[{type:"text",text:s.message}]}}})}function my(t){try{if(En(Ct(t,"spec.yaml"))){if(ya(t))return;Vl(t,_s(t)),Wa(t),Xx(t)}}catch{}}function b8e(t,e){let r=Ct(e,"spec","features"),n=t.map(i=>{let o=i.slug,s=[o?Ct(r,`${o}-${i.id.slice(2)}.yaml`):null,Ct(r,`${i.id}.yaml`)].filter(c=>c!==null),a=0;for(let c of s)try{if(En(c)){a=SA(c).mtimeMs;break}}catch{}return{feature:i,mtime:a}});return n.sort((i,o)=>o.mtime-i.mtime),n.map(i=>i.feature)}function v8e(t,e){t.registerResource("spec",ca.spec,{title:"Cladding spec",description:"The active spec.yaml \u2014 aggregated when sharded.",mimeType:"application/json"},async()=>{let r=la(e),n="error"in r?JSON.stringify({error:r.error},null,2):JSON.stringify(r.spec,null,2);return{contents:[{uri:ca.spec,mimeType:"application/json",text:n}]}}),t.registerResource("events",ca.events,{title:"Cladding events log",description:"Raw JSONL stream of feature_activated, evidence_appended, gate_run, \u2026",mimeType:"application/x-ndjson"},async()=>{let r=Ct(e,".cladding","events.log.jsonl"),n=En(r)?ua(r,"utf8"):"";return{contents:[{uri:ca.events,mimeType:"application/x-ndjson",text:n}]}}),t.registerResource("audit",ca.audit,{title:"Cladding audit log",description:"HITL audit log \u2014 every persona dispatch and human signoff.",mimeType:"application/x-ndjson"},async()=>{let r=Ct(e,".cladding","audit.log.jsonl"),n=En(r)?ua(r,"utf8"):"";return{contents:[{uri:ca.audit,mimeType:"application/x-ndjson",text:n}]}})}function S8e(t,e){let r=(n,i,o)=>{t.registerPrompt(n,{title:`Cladding persona \u2014 ${i}`,description:o,argsSchema:{featureId:E.string().optional().describe("Optional feature id to interpolate into the persona context")}},s=>{let a=cy(i),c=s.featureId?` Active feature: ${s.featureId} @@ -949,4 +949,4 @@ ${o.length} AC(s) required, ${s.length} missing an oracle. `).find(r=>r.trim().length>0);e&&G.stdout.write(` ${Fde(e.trim(),160)} `)}}function Fde(t,e){return t.length<=e?t:`${t.slice(0,e-1)}\u2026`}function b5e(t){let e=q();if(t.json){G.stdout.write(`${JSON.stringify(Qx(e,"."),null,2)} `),G.exitCode=0;return}G.stdout.write(`${Zte(e,".",{internal:t.internal})} -`),G.exit(0)}function v5e(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function S5e(t){let e=t.cwd??".",r=(t.out??"").trim();if(r.length===0){L("fail","bundle","missing --out \u2014 the bundle needs a destination path"),G.exit(1);return}let n;try{let i=q(e),o=Qx(i,e),s={gitHead:va(e),version:Xl(),generatedAt:t.now??new Date().toISOString()},a=gl(i),c;try{let l=t.since??rs(e),u=ns(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:ml(u),auditMarkdown:hl(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=AG({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){L("fail","bundle",i.message),G.exit(1);return}try{t5e(r,n,"utf8")}catch(i){L("fail","bundle",`could not write ${r}: ${i.message}`),G.exit(1);return}L("pass","bundle",`${r} \xB7 ${v5e(Buffer.byteLength(n,"utf8"))}`),G.exit(0)}function w5e(t){let e=HA(t);L("note",`route \u2192 ${e}`,t),G.exit(e==="unknown"?1:0)}function x5e(){let t=new $4;t.name("clad").description("Reference Ironclad CLI").version("0.9.1"),t.command("init [intent...]").description("Scaffold a cladding workspace. Pass a free-text project description as positional argument (e.g. `clad init payment SaaS for B2B` \u2014 free text in any language) to drive intent-aware onboarding \u2014 the LLM dispatcher then produces domain-aware capabilities/architecture/project-context plus product-level follow-up questions. Bare `clad init` keeps the v0.3.42 behaviour (greenfield seeds, or observed scan when \u22653 source files exist).").option("-n, --name ","Project name (default: cwd basename)").option("-f, --force","Overwrite existing spec.yaml").option("--scan","Force-walk the existing codebase. Default auto-detects (\u22653 source files trigger scan). Use --no-scan to skip even when source is present.").option("--no-llm","Force the deterministic interpreter (skip the LLM dispatcher chain). Intent text falls back to a deterministic quote in project-context.md.").option("--roots ","Override scanner source roots, comma-separated (e.g. packages/a/src,packages/b/src). Otherwise inferred from manifests + directory heuristics.").option("--with-hook","Install git pre-commit (cheap tier) AND pre-push (strict tier) hooks. Opt-in; cladding never touches .git without it.").option("--with-ci","Scaffold .github/workflows/cladding.yml running the strict pre-push gate \u2014 the authoritative enforcement layer.").option("--json","emit the raw InitResult for tooling; default is the human-readable surface").action(n5e),t.command("run [goal]").description("(experimental) Headless autonomous loop \u2014 iterate ready features, dispatch developer + reviewer personas, run L1 gates, record evidence. The supported, exercised path is host-delegated (clad serve + your AI host loops the cadence); this loop needs a real LLM transport and is not auto-invoked").option("--cwd ","target project directory (default cwd)").option("--max-iterations ","cap iterations (default 50)","50").option("--max-wall-clock-ms ","cap wall clock (default 600000)","600000").option("--max-retries ","cap retries per feature (default 3)","3").option("--json","emit the raw internal result (Iron Core view); default is a plain Soft Shell summary").action(i5e),t.command("sync").description("Validate spec.yaml against schema and report").option("--propose-archive","list STALE_SPECIFICATION findings whose suggestion.action is propose-archive (Phased Decommissioning Tier 2)").action(o5e),t.command("setup").description("Activate Cladding only for the current project (Claude Code / Codex / Gemini / Antigravity / Cursor)").option("--project ","activate a project other than the current directory").option("--host ","activate detected hosts (default), all, or one of: claude, codex, gemini, antigravity, cursor").option("--force","replace an existing conflicting cladding-owned project entry").option("--quiet","suppress stdout output").action(c5e),t.command("update").description("Run from a project dir AFTER `npm update -g cladding`: refresh project host wiring + sync inventory + refresh managed CLAUDE.md/AGENTS.md, then report stricter detector findings").action(l5e),t.command("check").description("Run every Iron Law stage and the drift detector suite").option("--internal","show stage codes (`stage_1.1`) instead of names (`Type`)").option("--strict","promote warn-severity drift findings to errors (CI / pre-publish gate)").option("--tier ","run only the stages for a trigger: pre-commit (drift/arch/secret) | pre-push (+ type/lint/unit/cov/spec-conformance/deliverable-smoke) | all (default; full 15-stage gate, used by CI)").option("--json","emit structured per-stage results (machine-readable: findings with file/line/suggestion, untruncated) \u2014 for agents/CI; cuts RED\u2192fix round-trips").option("--feature ","scope the gate to this feature's modules[] (Gradle monorepos): runs only :project: tasks instead of the root aggregate. No-op for non-Gradle repos or modules-less features").action(h5e),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(s5e),t.command("done ").description("Mark a feature done ONLY if `clad check --tier=pre-push --strict` is GREEN (flip \u2192 gate \u2192 revert-on-red). Keeps `done` honest.").action(g5e),t.command("oracle [featureId]").description("Print the impl-blind oracle authoring brief (acceptance criteria + signatures, never the implementation). Hand it to a fresh blind sub-agent; record the result with clad_author_oracle. cladding calls no LLM. Use --required to list which done ACs the project policy needs an oracle for.").option("--ac ","restrict the brief to a single acceptance criterion").option("--required","list the done ACs the oracle_policy / require_oracles requires an oracle for (worklist), instead of a brief").option("--cwd ","project root (defaults to .)").action((r,n)=>y5e(r,n)),t.command("rollback ").description("Record a rollback event and print the maintainer-runnable git command for the latest checkpoint").option("-r, --reason ","optional free-text reason recorded on the event payload").action(a5e),t.command("status").description("Render the feature \xD7 stage integrity matrix (business titles; use --internal for raw F-NNN ids)").option("--internal","show internal F-NNN ids and stage codes").option("--json","emit the row model as JSON \u2014 the same feature \xD7 stage integrity matrix rendered to the terminal (columns + per-feature glyph cells), one SSoT for terminal, JSON, and the audit bundle").action(b5e),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(d5e),t.command("impact ").description("Print the blast radius for a change \u2014 what depends on a feature/file + the tests to re-run (F-7794a6bc)").option("--depth ","bound the dependent walk to N hops (default: the full transitive radius)").action((r,n)=>f5e(r,n)),t.command("verdict").description("One-poll loop decision: DONE|ITERATE|ESCALATE|BLOCKED|BOOTSTRAP over the pre-push strict gate + feature statuses (F-2e28cc72). Single gate touch; DONE requires \u22651 non-liveness proof.").option("--json","emit the verdict object as JSON").option("--tier ","gate tier (default pre-push)").action(r=>UX(r,{checkStages:kA})),t.command("infer-deps").description("Suggest feature depends_on edges from the code import graph \u2014 the dependency edges cladding never auto-produced (F-2be3e3bb). Prints reviewable suggestions; does not write the spec.").option("--ambiguity ","emit edges for imports owned by \u2264 N features (default 1 = unambiguous single-owner only)").action(r=>p5e(r)),t.command("measure").description("Report the search + context efficiency the graph provides per feature \u2014 working-set tokens vs the naive baseline, dependency depth/edges resolved, regression-set coverage (F-16138071). Deterministic; no agent.").option("--json","emit the full report as JSON").option("--sessions","summarize recorded value-delivery telemetry instead \u2014 impact-card fire rate over eligible edits, the per-reason skip histogram, and MCP read-serve counts. Measures DELIVERY (did the surfaces fire), NOT adoption (F-6ba22c5c).").option("--trend [n]","render the last N (default 5) recorded measure snapshots with signed deltas \u2014 spot efficiency drift over time from the deduped .cladding/measure.jsonl ledger (F-39609db4)").action(r=>m5e(r));let e=t.command("graph").description("Render the spec\u2194code\u2194doc knowledge graph for a viewer, or report its shape (F-569f4b37)");return e.command("export").description("Export the graph: mermaid/dot/json to stdout, or an Obsidian vault to --out").option("--format ","mermaid | dot | json | obsidian | html (default: mermaid). html = a single self-contained offline viewer (requires --out)").option("--focus ","restrict to a feature/file node\u2019s neighborhood (id, slug, or module path)").option("--depth ","neighborhood radius around --focus (default: unbounded)").option("--out ","write to a file (or, for obsidian, a vault dir \u2014 default .cladding/graph)").action(r=>dte(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>fte()),e.command("serve").description("Serve a LIVE graph at localhost \u2014 recomputes on each load + auto-reloads on spec/doc changes (F-64a5c159)").option("--port ","port to listen on (default 3000)").action(r=>{pte(r)}),t.command("changelog").description("Render shipped changes since a git ref into human-facing documents (F-904495a5). Default: capability-grouped markdown from feature titles + acceptance sentences (no internal ids). --json emits the deterministic manifest hosts render release notes from; --audit the id-keeping verification table; --catalog the full capability \u2192 feature \u2192 acceptance catalog.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--json","print the deterministic ChangelogManifest as JSON (byte-identical across runs on the same state)").option("--audit","print the audit table \u2014 feature | AC | EARS | verification refs, each marked resolved \u2713/\u2717").option("--catalog","print the full capability \u2192 feature \u2192 acceptance listing of the living spec (no git range)").option("--measure","embed the release's own re-derivable measurement \u2014 but ONLY a snapshot taken at the current HEAD; no match renders a not-measured notice, never an older snapshot (F-ede6fa75)").action(r=>pG(r)),t.command("report").description("Render one deterministic review packet for a git range (F-f6cc5e5a) \u2014 spec-shard movement (from the changelog), changed source files resolved to their owning features via the reverse index, the deduped regression set, and gate + attestation state. For PR reviewers, team-leads, and auditors: it RENDERS, it gates nothing. Byte-identical across two runs on the same repository state.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--format ","md (default, the four-section markdown packet) | sarif (SARIF 2.1.0 \u2014 one result per error/warn drift finding, for code-scanning UIs) | json (the raw deterministic model)").action(r=>$Y(r)),t.command("bundle").description("Write ONE self-contained HTML audit bundle (F-e940fffe) a non-coder can double-click \u2014 offline, zero network, no CDN, no scripts. Contains the project header + inventory, the feature \xD7 stage matrix, the capability catalog, shipped changes for the range, the audit table with resolved refs, and the attestation summary, under a provenance banner (git HEAD, date, version). Deterministic modulo the date stamp. If no anchor ref resolves, the changelog + audit sections show an omitted notice while the rest still renders.").requiredOption("--out ","destination path for the HTML bundle").option("--since ","git ref to diff shipped changes from (default: the latest tag via `git describe --tags --abbrev=0`)").action(r=>S5e(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(w5e),t.command("hook ").description("Host hook protocol adapter \u2014 consume one host lifecycle event (SessionStart | UserPromptSubmit | PreToolUse | PostToolUse | Stop) as stdin JSON and print the protocol response on stdout. Always exits 0 so a hook failure never bricks the host session.").action(PX),t.command("serve").description("Run cladding as an MCP server over stdio \u2014 tools/resources/prompts for any MCP client").option("--cwd ","project directory exposed to the client (default cwd)").action(r5e),t.command("doctor").description("Summarise .cladding/events.log.jsonl \u2014 sentinel-miss frequency by phase/cause/fallback plus the top missed sentinels (LLM dispatcher health check)").option("--cwd ","project directory to read events from (default cwd)").option("--json","emit the raw DoctorReport for tooling; default is the human-readable surface").option("--hosts","smoke-test host CLIs (Claude Code / Gemini / Antigravity / Codex / Cursor) and project wiring \u2192 dated artifact + docs/dogfood/matrix.md. Live LLM prompts run only with consent (CLAD_HOST_SMOKE=1 or --yes); otherwise not-run").option("--yes","grant live-run consent for --hosts (equivalent to CLAD_HOST_SMOKE=1)").option("--matrix-only","regenerate docs/dogfood/matrix.md from the newest host-smoke artifact without any probing").action(r=>{if(r.hosts||r.matrixOnly){QY({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}AY(r)}),t.command("clarify [answer...]").description("Advance the onboarding Q&A loop. Pass the user's answer to the next pending question as a positional (no quotes needed, free text in any language, e.g. `clad clarify B2B only`); the LLM refines spec/docs based on the full Q-A history and may emit new follow-up questions. Reads/writes `.cladding/onboarding/state.yaml`. Requires `clad init ` to have started a session first.").option("--cwd ","project directory containing .cladding/onboarding/state.yaml (default cwd)").option("--no-llm","force the deterministic interpreter (preserves current artifacts, logs the answer)").option("--json","emit the raw RefineReport for tooling; default is the human-readable surface").action(Wee),t}var $5e=!!globalThis.__CLADDING_BUNDLED,k5e=$5e||import.meta.url===`file://${G.argv[1]}`;k5e&&x5e().parse();export{u5e as TIER_STAGES,x5e as createProgram,S5e as runBundleCommand,h5e as runCheckCommand,kA as runCheckStages,s5e as runCheckpointCommand,d5e as runContextCommand,g5e as runDoneCommand,f5e as runImpactCommand,p5e as runInferDepsCommand,n5e as runInitCommand,m5e as runMeasureCommand,y5e as runOracleCommand,a5e as runRollbackCommand,w5e as runRouteCommand,i5e as runRunCommand,r5e as runServeCommand,c5e as runSetupCommand,b5e as runStatusCommand,o5e as runSyncCommand,l5e as runUpdateCommand}; +`),G.exit(0)}function v5e(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function S5e(t){let e=t.cwd??".",r=(t.out??"").trim();if(r.length===0){L("fail","bundle","missing --out \u2014 the bundle needs a destination path"),G.exit(1);return}let n;try{let i=q(e),o=Qx(i,e),s={gitHead:va(e),version:Xl(),generatedAt:t.now??new Date().toISOString()},a=gl(i),c;try{let l=t.since??rs(e),u=ns(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:ml(u),auditMarkdown:hl(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=AG({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){L("fail","bundle",i.message),G.exit(1);return}try{t5e(r,n,"utf8")}catch(i){L("fail","bundle",`could not write ${r}: ${i.message}`),G.exit(1);return}L("pass","bundle",`${r} \xB7 ${v5e(Buffer.byteLength(n,"utf8"))}`),G.exit(0)}function w5e(t){let e=HA(t);L("note",`route \u2192 ${e}`,t),G.exit(e==="unknown"?1:0)}function x5e(){let t=new $4;t.name("clad").description("Reference Ironclad CLI").version("0.9.2"),t.command("init [intent...]").description("Scaffold a cladding workspace. Pass a free-text project description as positional argument (e.g. `clad init payment SaaS for B2B` \u2014 free text in any language) to drive intent-aware onboarding \u2014 the LLM dispatcher then produces domain-aware capabilities/architecture/project-context plus product-level follow-up questions. Bare `clad init` keeps the v0.3.42 behaviour (greenfield seeds, or observed scan when \u22653 source files exist).").option("-n, --name ","Project name (default: cwd basename)").option("-f, --force","Overwrite existing spec.yaml").option("--scan","Force-walk the existing codebase. Default auto-detects (\u22653 source files trigger scan). Use --no-scan to skip even when source is present.").option("--no-llm","Force the deterministic interpreter (skip the LLM dispatcher chain). Intent text falls back to a deterministic quote in project-context.md.").option("--roots ","Override scanner source roots, comma-separated (e.g. packages/a/src,packages/b/src). Otherwise inferred from manifests + directory heuristics.").option("--with-hook","Install git pre-commit (cheap tier) AND pre-push (strict tier) hooks. Opt-in; cladding never touches .git without it.").option("--with-ci","Scaffold .github/workflows/cladding.yml running the strict pre-push gate \u2014 the authoritative enforcement layer.").option("--json","emit the raw InitResult for tooling; default is the human-readable surface").action(n5e),t.command("run [goal]").description("(experimental) Headless autonomous loop \u2014 iterate ready features, dispatch developer + reviewer personas, run L1 gates, record evidence. The supported, exercised path is host-delegated (clad serve + your AI host loops the cadence); this loop needs a real LLM transport and is not auto-invoked").option("--cwd ","target project directory (default cwd)").option("--max-iterations ","cap iterations (default 50)","50").option("--max-wall-clock-ms ","cap wall clock (default 600000)","600000").option("--max-retries ","cap retries per feature (default 3)","3").option("--json","emit the raw internal result (Iron Core view); default is a plain Soft Shell summary").action(i5e),t.command("sync").description("Validate spec.yaml against schema and report").option("--propose-archive","list STALE_SPECIFICATION findings whose suggestion.action is propose-archive (Phased Decommissioning Tier 2)").action(o5e),t.command("setup").description("Activate Cladding only for the current project (Claude Code / Codex / Gemini / Antigravity / Cursor)").option("--project ","activate a project other than the current directory").option("--host ","activate detected hosts (default), all, or one of: claude, codex, gemini, antigravity, cursor").option("--force","replace an existing conflicting cladding-owned project entry").option("--quiet","suppress stdout output").action(c5e),t.command("update").description("Run from a project dir AFTER `npm update -g cladding`: refresh project host wiring + sync inventory + refresh managed CLAUDE.md/AGENTS.md, then report stricter detector findings").action(l5e),t.command("check").description("Run every Iron Law stage and the drift detector suite").option("--internal","show stage codes (`stage_1.1`) instead of names (`Type`)").option("--strict","promote warn-severity drift findings to errors (CI / pre-publish gate)").option("--tier ","run only the stages for a trigger: pre-commit (drift/arch/secret) | pre-push (+ type/lint/unit/cov/spec-conformance/deliverable-smoke) | all (default; full 15-stage gate, used by CI)").option("--json","emit structured per-stage results (machine-readable: findings with file/line/suggestion, untruncated) \u2014 for agents/CI; cuts RED\u2192fix round-trips").option("--feature ","scope the gate to this feature's modules[] (Gradle monorepos): runs only :project: tasks instead of the root aggregate. No-op for non-Gradle repos or modules-less features").action(h5e),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(s5e),t.command("done ").description("Mark a feature done ONLY if `clad check --tier=pre-push --strict` is GREEN (flip \u2192 gate \u2192 revert-on-red). Keeps `done` honest.").action(g5e),t.command("oracle [featureId]").description("Print the impl-blind oracle authoring brief (acceptance criteria + signatures, never the implementation). Hand it to a fresh blind sub-agent; record the result with clad_author_oracle. cladding calls no LLM. Use --required to list which done ACs the project policy needs an oracle for.").option("--ac ","restrict the brief to a single acceptance criterion").option("--required","list the done ACs the oracle_policy / require_oracles requires an oracle for (worklist), instead of a brief").option("--cwd ","project root (defaults to .)").action((r,n)=>y5e(r,n)),t.command("rollback ").description("Record a rollback event and print the maintainer-runnable git command for the latest checkpoint").option("-r, --reason ","optional free-text reason recorded on the event payload").action(a5e),t.command("status").description("Render the feature \xD7 stage integrity matrix (business titles; use --internal for raw F-NNN ids)").option("--internal","show internal F-NNN ids and stage codes").option("--json","emit the row model as JSON \u2014 the same feature \xD7 stage integrity matrix rendered to the terminal (columns + per-feature glyph cells), one SSoT for terminal, JSON, and the audit bundle").action(b5e),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(d5e),t.command("impact ").description("Print the blast radius for a change \u2014 what depends on a feature/file + the tests to re-run (F-7794a6bc)").option("--depth ","bound the dependent walk to N hops (default: the full transitive radius)").action((r,n)=>f5e(r,n)),t.command("verdict").description("One-poll loop decision: DONE|ITERATE|ESCALATE|BLOCKED|BOOTSTRAP over the pre-push strict gate + feature statuses (F-2e28cc72). Single gate touch; DONE requires \u22651 non-liveness proof.").option("--json","emit the verdict object as JSON").option("--tier ","gate tier (default pre-push)").action(r=>UX(r,{checkStages:kA})),t.command("infer-deps").description("Suggest feature depends_on edges from the code import graph \u2014 the dependency edges cladding never auto-produced (F-2be3e3bb). Prints reviewable suggestions; does not write the spec.").option("--ambiguity ","emit edges for imports owned by \u2264 N features (default 1 = unambiguous single-owner only)").action(r=>p5e(r)),t.command("measure").description("Report the search + context efficiency the graph provides per feature \u2014 working-set tokens vs the naive baseline, dependency depth/edges resolved, regression-set coverage (F-16138071). Deterministic; no agent.").option("--json","emit the full report as JSON").option("--sessions","summarize recorded value-delivery telemetry instead \u2014 impact-card fire rate over eligible edits, the per-reason skip histogram, and MCP read-serve counts. Measures DELIVERY (did the surfaces fire), NOT adoption (F-6ba22c5c).").option("--trend [n]","render the last N (default 5) recorded measure snapshots with signed deltas \u2014 spot efficiency drift over time from the deduped .cladding/measure.jsonl ledger (F-39609db4)").action(r=>m5e(r));let e=t.command("graph").description("Render the spec\u2194code\u2194doc knowledge graph for a viewer, or report its shape (F-569f4b37)");return e.command("export").description("Export the graph: mermaid/dot/json to stdout, or an Obsidian vault to --out").option("--format ","mermaid | dot | json | obsidian | html (default: mermaid). html = a single self-contained offline viewer (requires --out)").option("--focus ","restrict to a feature/file node\u2019s neighborhood (id, slug, or module path)").option("--depth ","neighborhood radius around --focus (default: unbounded)").option("--out ","write to a file (or, for obsidian, a vault dir \u2014 default .cladding/graph)").action(r=>dte(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>fte()),e.command("serve").description("Serve a LIVE graph at localhost \u2014 recomputes on each load + auto-reloads on spec/doc changes (F-64a5c159)").option("--port ","port to listen on (default 3000)").action(r=>{pte(r)}),t.command("changelog").description("Render shipped changes since a git ref into human-facing documents (F-904495a5). Default: capability-grouped markdown from feature titles + acceptance sentences (no internal ids). --json emits the deterministic manifest hosts render release notes from; --audit the id-keeping verification table; --catalog the full capability \u2192 feature \u2192 acceptance catalog.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--json","print the deterministic ChangelogManifest as JSON (byte-identical across runs on the same state)").option("--audit","print the audit table \u2014 feature | AC | EARS | verification refs, each marked resolved \u2713/\u2717").option("--catalog","print the full capability \u2192 feature \u2192 acceptance listing of the living spec (no git range)").option("--measure","embed the release's own re-derivable measurement \u2014 but ONLY a snapshot taken at the current HEAD; no match renders a not-measured notice, never an older snapshot (F-ede6fa75)").action(r=>pG(r)),t.command("report").description("Render one deterministic review packet for a git range (F-f6cc5e5a) \u2014 spec-shard movement (from the changelog), changed source files resolved to their owning features via the reverse index, the deduped regression set, and gate + attestation state. For PR reviewers, team-leads, and auditors: it RENDERS, it gates nothing. Byte-identical across two runs on the same repository state.").option("--since ","git ref to diff from (default: the latest tag via `git describe --tags --abbrev=0`)").option("--format ","md (default, the four-section markdown packet) | sarif (SARIF 2.1.0 \u2014 one result per error/warn drift finding, for code-scanning UIs) | json (the raw deterministic model)").action(r=>$Y(r)),t.command("bundle").description("Write ONE self-contained HTML audit bundle (F-e940fffe) a non-coder can double-click \u2014 offline, zero network, no CDN, no scripts. Contains the project header + inventory, the feature \xD7 stage matrix, the capability catalog, shipped changes for the range, the audit table with resolved refs, and the attestation summary, under a provenance banner (git HEAD, date, version). Deterministic modulo the date stamp. If no anchor ref resolves, the changelog + audit sections show an omitted notice while the rest still renders.").requiredOption("--out ","destination path for the HTML bundle").option("--since ","git ref to diff shipped changes from (default: the latest tag via `git describe --tags --abbrev=0`)").action(r=>S5e(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(w5e),t.command("hook ").description("Host hook protocol adapter \u2014 consume one host lifecycle event (SessionStart | UserPromptSubmit | PreToolUse | PostToolUse | Stop) as stdin JSON and print the protocol response on stdout. Always exits 0 so a hook failure never bricks the host session.").action(PX),t.command("serve").description("Run cladding as an MCP server over stdio \u2014 tools/resources/prompts for any MCP client").option("--cwd ","project directory exposed to the client (default cwd)").action(r5e),t.command("doctor").description("Summarise .cladding/events.log.jsonl \u2014 sentinel-miss frequency by phase/cause/fallback plus the top missed sentinels (LLM dispatcher health check)").option("--cwd ","project directory to read events from (default cwd)").option("--json","emit the raw DoctorReport for tooling; default is the human-readable surface").option("--hosts","smoke-test host CLIs (Claude Code / Gemini / Antigravity / Codex / Cursor) and project wiring \u2192 dated artifact + docs/dogfood/matrix.md. Live LLM prompts run only with consent (CLAD_HOST_SMOKE=1 or --yes); otherwise not-run").option("--yes","grant live-run consent for --hosts (equivalent to CLAD_HOST_SMOKE=1)").option("--matrix-only","regenerate docs/dogfood/matrix.md from the newest host-smoke artifact without any probing").action(r=>{if(r.hosts||r.matrixOnly){QY({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}AY(r)}),t.command("clarify [answer...]").description("Advance the onboarding Q&A loop. Pass the user's answer to the next pending question as a positional (no quotes needed, free text in any language, e.g. `clad clarify B2B only`); the LLM refines spec/docs based on the full Q-A history and may emit new follow-up questions. Reads/writes `.cladding/onboarding/state.yaml`. Requires `clad init ` to have started a session first.").option("--cwd ","project directory containing .cladding/onboarding/state.yaml (default cwd)").option("--no-llm","force the deterministic interpreter (preserves current artifacts, logs the answer)").option("--json","emit the raw RefineReport for tooling; default is the human-readable surface").action(Wee),t}var $5e=!!globalThis.__CLADDING_BUNDLED,k5e=$5e||import.meta.url===`file://${G.argv[1]}`;k5e&&x5e().parse();export{u5e as TIER_STAGES,x5e as createProgram,S5e as runBundleCommand,h5e as runCheckCommand,kA as runCheckStages,s5e as runCheckpointCommand,d5e as runContextCommand,g5e as runDoneCommand,f5e as runImpactCommand,p5e as runInferDepsCommand,n5e as runInitCommand,m5e as runMeasureCommand,y5e as runOracleCommand,a5e as runRollbackCommand,w5e as runRouteCommand,i5e as runRunCommand,r5e as runServeCommand,c5e as runSetupCommand,b5e as runStatusCommand,o5e as runSyncCommand,l5e as runUpdateCommand}; diff --git a/plugins/codex/.codex-plugin/plugin.json b/plugins/codex/.codex-plugin/plugin.json index 8f3a1e0a..5751c097 100644 --- a/plugins/codex/.codex-plugin/plugin.json +++ b/plugins/codex/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "description": "Reference implementation of the Ironclad standard — multi-agent dev harness for OpenAI Codex CLI / IDE / cloud. Exposes spec validation, drift detection, the Iron Law stage runner, and 5 agent personas as Codex skills + an auto-launched MCP server.", "author": { "name": "qwerfunch", diff --git a/plugins/gemini-cli/gemini-extension.json b/plugins/gemini-cli/gemini-extension.json index a20d7a36..a00d0f3b 100644 --- a/plugins/gemini-cli/gemini-extension.json +++ b/plugins/gemini-cli/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.9.1", + "version": "0.9.2", "description": "Reference implementation of the Ironclad standard — multi-agent dev harness for Gemini CLI. Exposes spec validation, drift detection, 15 Iron Law stages, and 5 agent personas as custom commands + an auto-launched MCP server.", "contextFileName": "GEMINI.md", "mcpServers": { diff --git a/spec.yaml b/spec.yaml index 02d0958a..d584a432 100644 --- a/spec.yaml +++ b/spec.yaml @@ -11,7 +11,7 @@ project: name: cladding language: typescript description: "Reference implementation of the Ironclad harness for AI-coupled software." - version: "0.9.1" + version: "0.9.2" repository: "https://github.com/qwerfunch/cladding" intent_summary: "Make AI-coupled development measurably safer and more honest — 41 drift detectors + 4-tier SSoT governance + A/B-measurable cladding-vs-vanilla evaluation." deliverable: @@ -54,7 +54,7 @@ project: # Auto-maintained by `clad sync` (F-5b9f9f). Do not edit by hand. inventory: - features: 270 + features: 271 scenarios: 2 capabilities: 6 test_files: 248 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index f2ce4bc7..5a5b26fd 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -20,12 +20,12 @@ attested_modules: CHANGELOG.md: c3353cc4baf17ec7 CLAUDE.md: 9f2fa4edd5c6df80 GOVERNANCE.md: 21cc28eaaf637a20 - README.html: e40e74799ed43198 - README.ja.md: b1e12755ee78a7db - README.ko.html: d2e2d8475781823e - README.ko.md: 0351e20595f77867 - README.md: 887dcdc61e4496e2 - README.zh.md: 3c8c204ecefe1775 + README.html: 490eab86b9c0d208 + README.ja.md: 3c4f3453ba97a3a6 + README.ko.html: dd48adf81a1d382c + README.ko.md: 383011eabecf55a2 + README.md: c84d37f3d8726f5c + README.zh.md: 014fe3859fdbb8dc SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -58,18 +58,22 @@ attested_modules: docs/feature-cycle.md: e1847cc9fe9b6eb6 docs/glossary.md: 9e897b963c3aa88f docs/img/en/ecosystem.svg: ed14d1d17f088b00 + docs/img/en/independence.svg: 1b3048b3b5206483 docs/img/en/relationship.svg: c7a24203925b4664 + docs/img/ja/independence.svg: 833069d091d4606c docs/img/ko/ecosystem.svg: 2b7341576c2af0a8 + docs/img/ko/independence.svg: 7921a18eb9478462 docs/img/ko/relationship.svg: 9ec8fb2254978f37 + docs/img/zh/independence.svg: 073303a42e601f7c docs/multi-provider-roadmap.md: 1e5cf27ea1b18d06 - docs/refinement-backlog.md: 3e38d60bf987eef1 + docs/refinement-backlog.md: 918426e582bf2739 docs/setup.md: a5c062651d267983 docs/spec-ids-multi-dev.md: 28d58e84879f58b1 docs/ssot-model.md: 66b9439e2f71ac4b docs/ssot-testing.md: abf3b2bd5acb29a1 - package-lock.json: dc094f923ab99ab8 - package.json: 5fc7fe2a9f18a959 - plugins/claude-code/.claude-plugin/plugin.json: 4daaab360fbbea9e + package-lock.json: efa9090e0ef4bf1f + package.json: 00272205b48b15df + plugins/claude-code/.claude-plugin/plugin.json: fcfe09c82ca6492b plugins/claude-code/agents/developer.md: 3002b4ef69ddab43 plugins/claude-code/agents/observability.md: 637fde18c012e2a7 plugins/claude-code/agents/orchestrator.md: 1b758de0bdab8eb0 @@ -77,7 +81,7 @@ attested_modules: plugins/claude-code/agents/reviewer.md: cdf7469a3e58b438 plugins/claude-code/commands/init.md: 5529b13d0f1ab4bf plugins/claude-code/hooks/hooks.json: 42321ead26fb1da8 - plugins/codex/.codex-plugin/plugin.json: 835ff6366182f1ea + plugins/codex/.codex-plugin/plugin.json: da272fa283026dc2 plugins/codex/.mcp.json: 43e3f4b2af24aa18 plugins/codex/skills/check/SKILL.md: 6a665422af510e72 plugins/codex/skills/developer/SKILL.md: 3002b4ef69ddab43 @@ -93,7 +97,7 @@ attested_modules: plugins/gemini-cli/GEMINI.md: ba08eaf2cd557a65 plugins/gemini-cli/commands/README.md: 3527d771578431bd plugins/gemini-cli/commands/init.toml: e7f310fd7af23f95 - plugins/gemini-cli/gemini-extension.json: 85ff27830d2db32e + plugins/gemini-cli/gemini-extension.json: 729b2c69fdc0b650 scripts/build-plugin.mjs: 7fabe2b6301b142a scripts/build.mjs: 3a4b204063024ef1 scripts/migrate-dogfood-v0.3.16.mjs: 1e265fb370019996 @@ -113,7 +117,7 @@ attested_modules: skills/serve/SKILL.md: f08bbdbbfeb05041 skills/status/SKILL.md: 09faadc50b3449da skills/sync/SKILL.md: 775c0f990a52a3d9 - spec.yaml: 14bbfc4556854fbb + spec.yaml: ea944be3d843f018 spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -146,7 +150,7 @@ attested_modules: src/cli: a4d0f0eb87fed960 src/cli/benchmark.ts: 77f84d2a898d724f src/cli/changelog.ts: 2de1adb009b89ab4 - src/cli/clad.ts: ec45cced5dc7e3ac + src/cli/clad.ts: 0501f16f74b2a8dc src/cli/clarify.ts: f17177969d5b75ff src/cli/doctor-hosts.ts: 1f0c2cec5a310b81 src/cli/doctor.ts: b98b955fe75e7f7e @@ -229,7 +233,7 @@ attested_modules: src/report/sarif.ts: 71e97aceeb0a4473 src/router: a4d0f0eb87fed960 src/router/intent.ts: 430590f761b891a6 - src/serve/server.ts: db452db2b4366605 + src/serve/server.ts: a63dde88609a6abe src/spec: a4d0f0eb87fed960 src/spec/attestation.ts: 294a1e99c42d4aef src/spec/cli.ts: 7a9bcd0f66677810 @@ -336,7 +340,7 @@ attested_modules: tests/adapters/transport.test.ts: 68f22e9e8df7b813 tests/agents/loader.test.ts: a7df7b1c9a95d37d tests/cli/benchmark.test.ts: b4a87289605ee75f - tests/cli/clad.test.ts: 7c61f7d2e759f792 + tests/cli/clad.test.ts: d559fff3bd530bad tests/cli/gate-golden-matrix.test.ts: 39cf615407a55abe tests/cli/init.test.ts: 3428a89708fc9330 tests/cli/intent-onboarding.test.ts: 0681b98ce2e74c22 @@ -555,6 +559,7 @@ attested_features: F-3a5339: ok F-3b3690: ok F-3c2bf8b9: ok + F-3fd220d8: ok F-40327b: ok F-417ff0: ok F-42af48: ok diff --git a/spec/index.yaml b/spec/index.yaml index 5e574abd..90a96aa8 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -126,6 +126,7 @@ features: F-3a5339: {slug: spec-yaml-metadata, status: done, modules: 5} F-3b3690: {slug: multi-agent-orchestration, status: done, modules: 4} F-3c2bf8b9: {slug: readme-record-honesty, status: done, modules: 5} + F-3fd220d8: {slug: readme-multiagent-label-diagram, status: done, modules: 10} F-40327b: {slug: persona-skill-md-cleanup, status: done, modules: 14} F-417ff0: {slug: scan-llm-dispatcher-chain, status: done, modules: 5} F-42af48: {slug: architecture-from-spec, status: done, modules: 2} diff --git a/src/cli/clad.ts b/src/cli/clad.ts index 8378f636..c8475424 100644 --- a/src/cli/clad.ts +++ b/src/cli/clad.ts @@ -1076,7 +1076,7 @@ export function runRouteCommand(prompt: string): void { */ export function createProgram(): Command { const program = new Command(); - program.name('clad').description('Reference Ironclad CLI').version('0.9.1'); + program.name('clad').description('Reference Ironclad CLI').version('0.9.2'); program .command('init [intent...]') diff --git a/src/serve/server.ts b/src/serve/server.ts index 76869c80..c340949a 100644 --- a/src/serve/server.ts +++ b/src/serve/server.ts @@ -174,7 +174,7 @@ export function buildServer(opts: ServerOptions = {}): McpServer { const server = new McpServer( { name: opts.name ?? 'cladding', - version: opts.version ?? '0.9.1', + version: opts.version ?? '0.9.2', }, { instructions: diff --git a/tests/cli/clad.test.ts b/tests/cli/clad.test.ts index 8399728d..2364cfc1 100644 --- a/tests/cli/clad.test.ts +++ b/tests/cli/clad.test.ts @@ -561,7 +561,7 @@ describe('cli/clad — createProgram', () => { test('program version matches current package version', () => { const program = clad.createProgram(); - expect(program.version()).toBe('0.9.1'); + expect(program.version()).toBe('0.9.2'); }); });