diff --git a/.agents/mcp_config.json b/.agents/mcp_config.json new file mode 100644 index 00000000..8b0e5a18 --- /dev/null +++ b/.agents/mcp_config.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "cladding": { + "command": "node", + "args": [ + ".cladding/host/serve.cjs" + ] + } + } +} diff --git a/.agents/skills/cladding-init/SKILL.md b/.agents/skills/cladding-init/SKILL.md new file mode 100644 index 00000000..28e0fb25 --- /dev/null +++ b/.agents/skills/cladding-init/SKILL.md @@ -0,0 +1,28 @@ +--- +name: cladding-init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. +--- + +# Cladding init + +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. + +## Required host workflow + +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. + +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. + +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. + +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. + +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index dcc42728..67986288 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.8.3", + "version": "0.9.0", "author": { "name": "qwerfunch" }, diff --git a/.claude/skills/cladding-init/SKILL.md b/.claude/skills/cladding-init/SKILL.md new file mode 100644 index 00000000..28e0fb25 --- /dev/null +++ b/.claude/skills/cladding-init/SKILL.md @@ -0,0 +1,28 @@ +--- +name: cladding-init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. +--- + +# Cladding init + +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. + +## Required host workflow + +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. + +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. + +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. + +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. + +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/.codex/config.toml b/.codex/config.toml new file mode 100644 index 00000000..e4fc8293 --- /dev/null +++ b/.codex/config.toml @@ -0,0 +1,5 @@ +[mcp_servers.cladding] +command = "node" +args = [ ".cladding/host/serve.cjs" ] +description = "cladding MCP server (project-scoped by `clad setup`)" +default_tools_approval_mode = "writes" diff --git a/.cursor/cli.json b/.cursor/cli.json new file mode 100644 index 00000000..cdd5d86e --- /dev/null +++ b/.cursor/cli.json @@ -0,0 +1,10 @@ +{ + "permissions": { + "allow": [ + "Mcp(cladding:clad_list_features)", + "Mcp(cladding:clad_get_feature)", + "Mcp(cladding:clad_run_check)" + ], + "deny": [] + } +} diff --git a/.cursor/mcp.json b/.cursor/mcp.json new file mode 100644 index 00000000..8b0e5a18 --- /dev/null +++ b/.cursor/mcp.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "cladding": { + "command": "node", + "args": [ + ".cladding/host/serve.cjs" + ] + } + } +} diff --git a/.cursor/rules/cladding-bootstrap.mdc b/.cursor/rules/cladding-bootstrap.mdc new file mode 100644 index 00000000..a243edb0 --- /dev/null +++ b/.cursor/rules/cladding-bootstrap.mdc @@ -0,0 +1,7 @@ +--- +description: Cladding bootstrap boundary +alwaysApply: true +--- + +Cladding is available only in this project. Do not initialize or invoke Cladding for ordinary work. +Use the cladding-init skill only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it. diff --git a/.cursor/skills/cladding-init/SKILL.md b/.cursor/skills/cladding-init/SKILL.md new file mode 100644 index 00000000..28e0fb25 --- /dev/null +++ b/.cursor/skills/cladding-init/SKILL.md @@ -0,0 +1,28 @@ +--- +name: cladding-init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. +--- + +# Cladding init + +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. + +## Required host workflow + +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. + +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. + +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. + +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. + +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/.gemini/settings.json b/.gemini/settings.json new file mode 100644 index 00000000..8b0e5a18 --- /dev/null +++ b/.gemini/settings.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "cladding": { + "command": "node", + "args": [ + ".cladding/host/serve.cjs" + ] + } + } +} diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 00000000..8b0e5a18 --- /dev/null +++ b/.mcp.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "cladding": { + "command": "node", + "args": [ + ".cladding/host/serve.cjs" + ] + } + } +} diff --git a/CHANGELOG.md b/CHANGELOG.md index afeb89b6..00b81e63 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,53 @@ All notable changes to Cladding are documented here. Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/). Versioning: [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html). +## [0.9.0] — Project-scoped natural-language onboarding (2026-07-16) + +**In one line:** apply Cladding from ordinary conversation without a shell command, while project-local discovery, a read-only preview, an exact approval phrase, and atomic recovery keep onboarding bounded. + +### MCP host (clad serve) + +- **Start from an idea, a complete UTF-8 planning document, or an existing codebase.** The host reuses the CLI onboarding engine, keeps the full document and observed source evidence, and asks at most three material follow-up questions only when decisions remain open. +- **Preview before any authored file changes.** Initialization requires the exact one-time phrase shown after validation and staging; malformed, stale, replayed, or partially applied drafts leave the project at its pre-apply content. +- **Resume across host restarts.** Process-per-turn hosts retain the exact staged draft in ignored project runtime state instead of reconstructing intent from an approval code. +- **Keep activation inside the selected project.** Setup no longer exposes Cladding tools to unrelated projects, removes only provably owned legacy global wiring, and uses the same project runtime for MCP and later shell validation. +- **Expose only the initialization bootstrap before `spec.yaml` exists.** The ordinary development tool surface becomes available after successful initialization. + +### Spec governance (4-tier SSoT) + +- **Onboarding now seeds capabilities and user journeys into the governed design.** Early generated links remain informational until the shared maturity threshold, while invalid references and under-bound flows still block. +- **Completed onboarding hands off to ordinary natural-language development** and distinguishes on-demand checks from opt-in hook or CI enforcement. + +### Gate and toolchain fidelity + +- **JavaScript projects follow their declared tools.** Custom scripts win; Jest, Vitest, ESLint, Biome, and Oxlint are selected from project evidence, and architecture checks include TSX, JSX, JavaScript, and TypeScript. +- **A missing runnable deliverable stays honest.** Safe declared entries run, broken entries block, and an early onboarding seed is not forced to invent an unsafe smoke command. +- **Verification evidence remains non-vacuous.** Done features must execute a passing declared test, spec-conformance oracles preserve full-suite evidence, and unavailable tools remain skips rather than false passes. + +### Hardened by the packed-tarball E2E campaign (2026-07-16) + +A live campaign installed the packed 0.9.0 tarball in isolation and drove real init scenarios through all five host CLIs (report: `docs/dogfood/e2e-0.9.0-packed-2026-07-16.md`). The consent boundary held on every host that ran; these defects were found and fixed: + +- **Setup wires only detected hosts by default.** Previously every project received all five hosts' config files regardless of what was installed; `clad setup --host all` remains the explicit override. +- **Antigravity actually connects now.** agy reads MCP config machine-wide only (a negative control proved the project file is never loaded), so setup also writes an ownership-guarded `~/.gemini/config/plugins/cladding/` wire — the one stated exception to project-local activation; sessions still resolve the project from their working directory. +- **`clad update` outside a cladding project writes nothing.** It used to scaffold host wiring into any directory and could reach an account-wide legacy plugin uninstall. +- **Abandoned onboarding preparations no longer accumulate.** Expired consent-cache envelopes are swept on staging (hundreds had piled up in the shared temp dir), and a tampered staged draft is now re-validated and rejected cleanly instead of surfacing a raw crash. +- **Legacy cleanup preserves your global config formatting.** The codex `config.toml` entry is now spliced out textually (comments and ordering survive, parse-verified), and cursor cleanup no longer leaves an orphan empty `mcpServers`. +- **`clad doctor --hosts` probes match the project-local model** (project-MCP approval for the consented Claude probe, project-directory Antigravity probe, Codex approvals bypass, and a realistic gate timeout). + +### Also changed + +- The deterministic collector found nine onboarding commit subjects that do not name a spec feature. Their user-visible behavior is covered by the spec-backed notes above, but their commit-to-spec linkage remains absent. + +### 한국어 요약 + +**한 줄 요약:** 이제 셸 명령 없이 자연어로 Cladding을 적용할 수 있으며, 프로젝트 로컬 연결·읽기 전용 미리보기·정확한 승인 문구·원자적 복구가 온보딩 변경 범위를 지킵니다. + +- 아이디어·전체 UTF-8 기획 문서·기존 코드 중 어디서든 시작하고, 결정이 남은 경우에만 최대 3개의 핵심 질문을 받습니다. +- 초기화 전에는 준비용 MCP 도구 3개만 노출되며, 정확한 일회용 승인 문구로 적용한 뒤 전체 개발 도구가 열립니다. +- 실제 5개 호스트 CLI에 패키징된 tarball을 설치해 검증하는 E2E 캠페인을 거쳤습니다 — 설치된 호스트만 배선, Antigravity 연결 수리, 임시 파일 잔존 정리 등 캠페인이 찾은 결함을 모두 수정했습니다. +- 호스트가 재시작돼도 검토한 초안을 그대로 적용하고, 실패·오래된 요청·재사용 요청은 프로젝트를 부분 변경 상태로 남기지 않습니다. + ## [0.8.3] — Agent loops that stop honestly, a guard against unverified "done", and a faster check (2026-07-12) This release helps you build AI agent loops that stop when the work is genuinely finished, closes a hole where a feature could look done without its tests ever running, makes the pre-push check faster, and ships native Japanese and Chinese documentation. diff --git a/CLAUDE.md b/CLAUDE.md index 0a98634d..e3cf087d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -25,7 +25,7 @@ Files `F-082` ~ `F-090` were the *drift period* (authored after v0.3.9 but bypas ## Version bumps — use the script -Don't hand-edit version strings. There are nine sites (incl. `.claude-plugin/marketplace.json`, the marketplace *catalog* the Claude Code host reads to detect "update available"); missing one breaks `HARNESS_INTEGRITY` (which now also guards the marketplace catalog version). Run: +Don't hand-edit version strings. There are eleven sites (incl. `.claude-plugin/marketplace.json`, the marketplace *catalog* the Claude Code host reads to detect "update available"); missing one breaks `HARNESS_INTEGRITY` (which now also guards the marketplace catalog version). Run: ```bash npm run version-bump -- 0.3.X @@ -46,7 +46,7 @@ When you add a drift detector under `src/stages/detectors/`: A user-explicit instruction ("release vX.Y.Z") triggers the ritual: -1. `npm run version-bump -- X.Y.Z` (all nine sites) + `npm install` (refresh the committed `package-lock.json` to the new version — CI's `npm ci` fails on a stale lock) + `npm run build` + GREEN `npm test` / `clad check --strict` +1. `npm run version-bump -- X.Y.Z` (all eleven sites) + `npm install` (refresh the committed `package-lock.json` to the new version — CI's `npm ci` fails on a stale lock) + `npm run build` + GREEN `npm test` / `clad check --strict` 2. open a **PR `develop → main`** and merge it with the GitHub **"Create a merge commit"** button — NEVER squash, NEVER rebase (see the squash-ban below) 3. `git tag vX.Y.Z` on main's merge commit 4. push main + tag, then **back-merge `main → develop`** (`git checkout develop && git merge origin/main && git push`) so develop keeps the release commit in its ancestry — skip this and the next release PR phantom-conflicts diff --git a/README.html b/README.html index 7dc6b71a..38cf2bbd 100644 --- a/README.html +++ b/README.html @@ -227,13 +227,13 @@

cladding

To trust AI with coding, an organization needs three things — that the code can be trusted, that it's traced, and that it holds up as you scale. cladding builds those three.
- True to its name (cladding = the outer layer), it wraps your host LLM (Claude Code · Codex · Gemini · Cursor): before it starts, cladding feeds it the project's intent; after it finishes, cladding verifies the result with 41 detectors and a 15-stage gate. + True to its name (cladding = the outer layer), it wraps your host LLM (Claude Code · Codex · Gemini · Antigravity · Cursor): before it starts, cladding feeds it the project's intent; after it finishes, cladding verifies the result with 41 detectors and a 15-stage gate.

ironclad spec - tests + tests detectors license

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

cladding

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

@@ -285,7 +285,7 @@

What changes

Ending a session in a failing stateexits as-is, forgotten next timethe exit is blocked once, the failing checks handed off as a repair card Two devs add a feature at the same timemerge conflicthash-8 IDs · separate files → 0 conflicts Who verifies the AI-written code?the AI that wrote it self-certifies (risky)an implementation-blind grader + the mechanical gate - Switching AI toolsreconfigure per toolone spec → 4 hosts wired automatically + Switching AI toolsreconfigure per toolone spec → 5 hosts wired automatically @@ -315,7 +315,7 @@

How cladding wraps your host LLM

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 · Cursor the same verification runs through in-conversation tool calls plus the git · CI gate. + On Codex · Gemini · Antigravity · Cursor the same verification runs through in-conversation tool calls plus the git · CI gate.

@@ -481,40 +481,55 @@

Ecosystem

Install

- 
npm install -g cladding   # the cladding CLI
-cd <project>              # your project
-clad setup                # auto-wire your AI tools (Claude · Codex · Gemini · Cursor)
+

1. Install once on your machine

+ 
npm install -g cladding   # install only the cladding CLI
-

Each host wires cladding as an MCP server the AI calls on its own — there's no /mcp command and no manual connect step; you just chat.

+

This command may be run from any directory. It does not add Cladding to any AI model's context.

-

Then, once per project, call init inside your AI tool:

- 
[inside your AI tool] /cladding:init "B2B payment SaaS"
+

2. Activate one project, then start your AI tool

+ 
cd <project>
+clad setup                # connect Cladding only to this project
 
-  
It creates the project's spec.yaml and supporting docs. After that, just develop as usual — cladding runs the before/after loop in the background, with nothing to memorize. Raise enforcement with clad init --with-hook (pre-commit + pre-push git hooks) or clad init --with-ci (scaffold the CI gate, where true enforcement lives).

+# Choose exactly one and remove its leading '#':
+# codex          # Codex
+# claude         # Claude Code
+# gemini         # Gemini CLI
+# agy            # Antigravity
+# cursor-agent   # Cursor Agent
+

clad setup connects the AI tools it detects on your machine (Claude Code, Codex, Gemini, Antigravity, Cursor) to this project only — Antigravity is the one exception, wired machine-wide because it reads no project-local MCP config (details in setup). It does not expose Cladding skills or MCP tools in projects where setup was not run. Use only the command for your AI tool; for Cursor IDE, open <project> as the workspace. Start a new AI session from this folder after setup so the host discovers the project-local connection. When Codex first opens a Git repository, approve its normal project-trust prompt; Codex intentionally ignores project MCP config until the repository is trusted.

- - - - - - - - - -
Starting pointCommandWhat happens
An idea, nothing else/cladding:init "I'm going to build a B2B payment SaaS"the LLM analyzes the domain → spec · docs · policies + 2–3 follow-up questions
A planning doc/cladding:init docs/plan.mdloads the file and uses its contents as intent
An existing project/cladding:init "apply cladding to this project"scans the existing code → observed patterns merged with your intent
+

3. Apply Cladding once

+

Choose the starting point that fits and say it naturally in your AI tool.

+

Cladding first inspects the project without changing it. Your AI shows the exact file operations and a one-time approval phrase; initialization begins only when you repeat that phrase in a separate reply. Opening a project or asking a question about Cladding never authorizes file changes. This exact-match step prevents accidental application; MCP cannot prove which user produced a tool argument, so it is not a sandbox against a malicious or compromised host.

+ +

An idea, nothing else

+ 
Start this B2B payment SaaS with Cladding.
+

The LLM analyzes the domain and creates the spec, docs, and policies. It asks up to three follow-up questions only when an important product decision is still unresolved; a complete plan asks none.

+ +

A planning document

+ 
Apply Cladding using docs/plan.md.
+

Cladding loads the file and uses its contents as the project intent.

+ +

An existing project

+ 
Analyze this project and apply Cladding.
+

Cladding scans the existing code and combines the observed patterns with your intent.

-

Host support (honest): Claude Code is fully verified through real-usage campaigns (incl. real-time intervention). Codex · Gemini CLI wire automatically; their behavior isn't verified yet. Cursor wires automatically, but real-usage verification is still pending. → setup details · host wiring · MCP · upgrading

+

Once initialization is complete, keep developing in the same conversation. Ask for the next feature in plain language; the AI uses the generated spec and docs and keeps material design changes aligned as the project grows. Checks run when the host invokes them; use the optional Git hooks or CI gate when you want automatic enforcement.

+ 
Implement email sign-in, including tests.
+

There is nothing new to memorize. For host-specific invocation, stricter Git/CI enforcement, and verified host status, see setup details.

Update

-

Staying current is two commands — or one line to your AI tool.

- 
npm update -g cladding   # 1. get the new version
-cd <project>             # 2. your project
-clad update              # 3. bring it in line
-

Your code · spec.yaml · docs are left untouched — a stricter version only points things out, it never blocks or fixes on its own. If those two commands flag fresh drift, hand it to your AI tool:

- 
[inside your AI tool] reconcile the drift the update flagged
-

…or skip the commands and just ask, the same way you ran init — it runs the update for you:

- 
[inside your AI tool] update cladding to the latest version
+

Ask your AI tool (recommended)

+

From your project, say:

+ 
Update cladding to the latest version.
+

If the AI tool has terminal and global-install permission, it updates the CLI, refreshes host wiring, updates the current project, and explains any new drift. Otherwise, it shows the commands for you to approve or run.

+

Or update from the terminal

+ 
npm update -g cladding   # 1. get the new CLI version
+cd <project>              # 2. enter one Cladding project
+clad update               # 3. refresh its host wiring and derived state
+

Run clad update in each Cladding project you want to upgrade. It also performs the project-scoped setup refresh, so a separate clad setup is unnecessary. It preserves authored code, feature/spec content, and documentation; only derived data and Cladding-managed instruction blocks may be refreshed. If the new version reports drift, hand that result to your AI tool:

+ 
Reconcile the drift the update flagged.

Status

@@ -523,7 +538,7 @@

Status

version
-
v0.8.3
+
v0.9.0
2026-07
@@ -533,7 +548,7 @@

Status

tests
-
2497/2497
+
2561/2561
all pass
@@ -543,13 +558,13 @@

Status

features
-
254
-
251 done · self-spec
+
255
+
252 done · self-spec
-

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

+

236 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 f82cceac..ca22b939 100644 --- a/README.ja.md +++ b/README.ja.md @@ -6,13 +6,13 @@

AI にコーディングを任せるには、組織に三つの条件が要る —
コードを信頼でき、その足跡をたどれ、規模が大きくなっても揺るがないこと。cladding はその三つを築く。
- その名（外装材）のとおりホスト LLM（Claude Code · Codex · Gemini · Cursor）を包み込む — 作業を 始める前 に、cladding がプロジェクトの意図を渡し、作業を 終えた後 に、41 個の検出器と 15 段階のゲートで結果を検証する。 + その名（外装材）のとおりホスト LLM（Claude Code · Codex · Gemini · Antigravity · Cursor）を包み込む — 作業を 始める前 に、cladding がプロジェクトの意図を渡し、作業を 終えた後 に、41 個の検出器と 15 段階のゲートで結果を検証する。

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ - **たどれる** — **出荷されたものは記録に残る**: 何を検証したかはコミットされた内容に刻まれ、誰がいつやったかはローカルのセッション台帳に、なぜかは spec に残る — だから引き継ぎもレビューも、掘り起こさずに済む。 - **拡張しても揺るがない** — 人と AI が増えれば、普通は衝突と乖離も増える。だが全員が一つの spec を基準に働くので、それらは自動でせき止められる — だから規模を広げても崩れない。 -cladding は **自分自身も cladding で作っている** — 254 個の feature のうち 251 個が同じゲートを通過した、[Ironclad](https://github.com/qwerfunch/ironclad) 標準を L4 で実装した最初の事例だ。 +cladding は **自分自身も cladding で作っている** — 255 個の feature のうち 252 個が同じゲートを通過した、[Ironclad](https://github.com/qwerfunch/ironclad) 標準を L4 で実装した最初の事例だ。 @@ -46,7 +46,7 @@ cladding は **自分自身も cladding で作っている** — 254 個の feat | **失敗した状態でセッションを終える** | そのまま終了し、次回には忘れられる | 終了を一度止め、失敗したチェックを修正カードとして引き継ぐ | | **二人が同時に feature を追加する** | merge conflict | hash-8 ID · ファイル分離 → 衝突 0 | | **AI が書いたコードは誰が検証する？** | 書いた AI が自分で検証する（危うい） | 実装を見ない採点者 + 機械的なゲート | -| **AI ツールを乗り換える** | ツールごとに再設定 | 1 つの spec → 4 つの host へ自動配線 | +| **AI ツールを乗り換える** | ツールごとに再設定 | 1 つの spec → 5 つの host へ自動配線 | ## 誰のためのものか @@ -66,7 +66,7 @@ cladding は **自分自身も cladding で作っている** — 254 個の feat **後 — 検証する:** 15 段階のゲート、41 個の乖離検出器、そして **実装を見ない採点者** — spec に照らして作業を検査するエージェントで、*実装を読む手段を一切持たない* ため、自分が書いたものにお墨付きを与えることはできない。 -リアルタイム介入（マップ注入 · 即時ブロック · 終了ブロック）は Claude Code ですべて動作する。Codex · Gemini · Cursor では同じ検証を、会話中のツール呼び出しと git · CI のゲートで通す。 +リアルタイム介入（マップ注入 · 即時ブロック · 終了ブロック）は Claude Code ですべて動作する。Codex · Gemini · Antigravity · Cursor では同じ検証を、会話中のツール呼び出しと git · CI のゲートで通す。 @@ -241,63 +241,107 @@ cladding の差別化点は *組み合わせ* にある — 上のカテゴリ ## Install +### 1. マシンに一度インストールする + ```bash npm install -g cladding # cladding CLI をインストール -cd # プロジェクトへ移動 -clad setup # AI ツールを自動配線（Claude · Codex · Gemini · Cursor） ``` -各ホストは cladding を MCP サーバーとして接続し、AI が自分で呼び出す — `/mcp` コマンドも手動での接続手順もなく、ただ普通に会話するだけでいい。 +このコマンドはどのディレクトリからでも実行できる。CLI だけをインストールし、AI モデルのコンテキストにはまだ Cladding を追加しない。 + +### 2. 使用するプロジェクトだけを有効化し、AI ツールを起動する + +```bash +cd +clad setup # このプロジェクトだけに Cladding を接続する + +# 一つだけ選び、先頭の「#」を外して実行する: +# codex # Codex +# claude # Claude Code +# gemini # Gemini CLI +# agy # Antigravity +# cursor-agent # Cursor Agent +``` + +`clad setup` はこのマシンで検出された AI ツール（Claude Code・Codex・Gemini・Antigravity・Cursor）を現在のプロジェクト内だけに接続する — ただし Antigravity はプロジェクトローカルの MCP 設定を読まないホストのため、唯一マシン単位で接続される（詳細は [setup ドキュメント](docs/setup.md)）。setup を実行していない別プロジェクトのモデルコンテキストには、Cladding の skill や MCP ツールは入らない。使用する AI ツールのコマンドを一つだけ実行し、Cursor IDE では `` をワークスペースとして開く。setup 後はこのフォルダから新しい AI セッションを開始する。Codex や Gemini がプロジェクトの信頼確認を表示した場合は、それぞれの通常のセキュリティ境界に従って承認する。信頼されるまでプロジェクトローカルの MCP 設定は意図的に読み込まれない。 + +### 3. Cladding を一度適用する + +自分の出発点に合う依頼を AI ツールへ自然な言葉で伝える。 + +Cladding はまずプロジェクトを読み取り専用で調査する。AI が正確なファイル操作と一度限りの承認フレーズを示し、ユーザーが別の返信でそのフレーズをそのまま入力した場合にだけ初期化を開始する。プロジェクトを開いたり Cladding について質問したりするだけでは、ファイルは変更されない。 +この完全一致の手順は偶発的な適用を防ぐが、MCP はツール引数を実際にどのユーザーが作成したかを証明できない。そのため、悪意のある、または侵害されたホストに対するサンドボックスではない。 + +#### アイデアだけがある場合 + +``` +B2B 決済 SaaS を cladding で始めて。 +``` + +LLM がドメインを分析し、spec・ドキュメント・ポリシーを作成する。重要なプロダクト判断が未解決の場合にだけ最大 3 個の追加質問を行い、完成した計画には質問しない。 -続いて、プロジェクトにつき一度だけ、AI ツールの中から init を呼び出す: +#### 企画ドキュメントがある場合 ``` -[AI ツールの中で] /cladding:init "B2B 決済 SaaS" +docs/plan.md を基に cladding を適用して。 ``` -プロジェクトの `spec.yaml` と関連ドキュメントが作られる。あとはいつも通り開発するだけ — cladding が前 / 後のループを裏で回すので、覚えるコマンドはない。強制力を上げたいときは `clad init --with-hook`（pre-commit + pre-push の git hook）または `clad init --with-ci`（CI ゲートの雛形を生成 — 本当の強制は CI にある）。 +ファイルを読み込み、その内容をプロジェクトの intent として使用する。 -| 出発点 | コマンド | 何が起きるか | -|---|---|---| -| **アイデアだけがある** | `/cladding:init "B2B 決済 SaaS を作る"` | LLM がドメインを分析 → spec · ドキュメント · ポリシーを自動生成 + 2〜3 個の追加質問 | -| **企画ドキュメントがある** | `/cladding:init docs/plan.md` | ファイルを読み込み、その内容を intent として使う | -| **既存プロジェクトへ導入する** | `/cladding:init "このプロジェクトに cladding を適用して"` | 既存コードをスキャン → 観察したパターンと intent を結合 | +#### 既存プロジェクトへ導入する場合 -**host サポート（正直な注記）:** Claude Code は実利用キャンペーン（リアルタイム介入を含む）で全機能を検証済み。Codex · Gemini CLI は配線は自動だが、動作はまだ未検証だ。Cursor は配線は自動だが、実利用での検証はまだこれから。→ [セットアップ詳細 · host 配線 · MCP · アップグレード](docs/setup.md) +``` +現在のコードを分析して cladding を適用して。 +``` + +既存コードをスキャンし、観察したパターンとユーザーの intent を組み合わせる。 + +> **初期化が完了したら、同じ会話でそのまま開発を続ければよい。** 次の機能を自然な言葉で依頼すると、AI は生成された spec とドキュメントを基準に開発し、重要な設計変更もプロジェクトの成長に合わせて反映する。検査はホストが呼び出した時に実行され、自動強制が必要なら任意の Git hook または CI gate を使用する。 + +``` +メールログイン機能をテスト込みで実装して。 +``` + +新しく覚えるコマンドはない。ホスト別の明示的な呼び出し方、より強い Git/CI 適用、検証済みホストの状況は [セットアップ詳細](docs/setup.md) を参照。 ## Update -最新に保つのはコマンド二つ — あるいは AI ツールに一言頼むだけでいい。 +### AI ツールに依頼する（推奨） -```bash -npm update -g cladding # 1. 新しいバージョンを入れる -cd # 2. プロジェクトへ移動 -clad update # 3. 足並みをそろえる +プロジェクトで次のように伝える: + +``` +cladding を最新版に更新して。 ``` -あなたのコード · `spec.yaml` · ドキュメントには手を触れない — より厳しいバージョンは、指摘すべきことがあっても **指摘するだけ** で、自分でブロックも修正もしない。上の二つのコマンドが新たな乖離を指摘したら、それは AI ツールに渡せばいい: +AI ツールにターミナルとグローバルインストールの権限があれば、CLI の更新、ホスト配線の更新、現在のプロジェクトの更新を実行し、新たな乖離を説明する。権限がなければ、承認または手動実行するコマンドを案内する。 -``` -[AI ツールの中で] 更新で指摘された乖離を解消して +### またはターミナルで直接更新する + +```bash +npm update -g cladding # 1. 新しいバージョンを入れる +cd # 2. Cladding プロジェクトへ移動 +clad update # 3. プロジェクト接続と派生状態を更新する ``` -…あるいは二つのコマンドを飛ばして、init のときと同じように頼むだけでもいい — 更新まで代わりにやってくれる: +`clad update` は更新する各 Cladding プロジェクトで実行する。プロジェクト単位の setup も同時に更新するため、別途 `clad setup` を実行する必要はない。ユーザーが作成したコード・機能や spec の本文・ドキュメントは保持され、派生データと Cladding 管理の指示ブロックだけが更新される場合がある。新しいバージョンが乖離を報告したら、その結果を AI ツールに渡せばよい: ``` -[AI ツールの中で] cladding を最新版に更新して +更新で指摘された乖離を解消して。 ``` + ## Status | Version | 準拠レベル | Tests | Gate | Features | |---|---|---|---|---| -| v0.8.3（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2497 / 2497 | 15 段階 · 41 detectors | 254（251 done） | +| v0.9.0（2026-07） | L4 · [自己申告](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2561 / 2561 | 15 段階 · 41 detectors | 255（252 done） | -234 test files · capability 6 個 · カバレッジ低下は COVERAGE_DROP detector がブロック +236 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 88bc9f2a..d2a07c1c 100644 --- a/README.ko.html +++ b/README.ko.html @@ -269,13 +269,13 @@

cladding

기업이 AI에게 코딩을 맡기려면 세 가지가 필요하다 —
믿을 수 있고, 추적되고, 규모가 커져도 흔들리지 않아야 한다. cladding이 그 셋을 만든다.
- cladding(외장재)이라는 이름 그대로, 호스트 LLM(Claude Code · Codex · Gemini · Cursor)을 감싼다: 일을 시작하기 전엔 프로젝트의 의도를 넣어 주고, 마친 후엔 41개 검출기와 15단계 게이트로 결과를 검증한다. + cladding(외장재)이라는 이름 그대로, 호스트 LLM(Claude Code · Codex · Gemini · Antigravity · Cursor)을 감싼다: 일을 시작하기 전엔 프로젝트의 의도를 넣어 주고, 마친 후엔 41개 검출기와 15단계 게이트로 결과를 검증한다.

ironclad spec - tests + tests detectors license

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

cladding

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

@@ -349,7 +349,7 @@

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

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

@@ -517,41 +517,55 @@

인접 도구와의 차이

Install

- 
npm install -g cladding   # cladding CLI 설치
-cd <project>              # 프로젝트로 이동
-clad setup                # AI 도구 자동 연결 (Claude · Codex · Gemini · Cursor)
+

1. 컴퓨터에 한 번 설치하기

+ 
npm install -g cladding   # cladding CLI 설치
-

각 호스트는 cladding을 AI가 알아서 호출하는 MCP 서버로 연결한다 — /mcp 명령도 수동 연결 단계도 없이, 그냥 대화하면 된다.

+

이 단계는 어느 디렉터리에서 실행해도 된다. CLI만 설치하며 AI 도구에는 아직 Cladding 정보가 들어가지 않는다.

-

그다음, 프로젝트당 한 번, AI 도구 안에서 init을 호출한다:

- 
[AI 도구 안] /cladding:init "B2B 결제 SaaS"
-

프로젝트의 spec.yaml 과 관련 문서가 만들어진다. 그 뒤론 평소처럼 개발하면 된다 — cladding이 배경에서 전·후 루프를 돌리니 따로 외울 것은 없다. 강제력을 높이려면 clad init --with-hook(pre-commit + pre-push git hook) 이나 clad init --with-ci(CI 게이트 스캐폴드 — 진짜 강제는 CI에서 산다).

+

2. 사용할 프로젝트만 연결하고 AI 도구 실행하기

+ 
cd <project>
+clad setup                # 이 프로젝트에만 AI 도구 연결
 
-  
-    
-      
-    
-    
-      
-      
-      
-    
-  
시작 상황명령무엇이 일어나는가
아이디어만 있을 때/cladding:init "B2B 결제 SaaS 만들거야"LLM이 도메인 분석 → spec · 문서 · 정책 자동 생성 + 후속 질문 2–3개
기획 문서가 있을 때/cladding:init docs/plan.md파일을 로드해 내용을 intent로 사용
기존 프로젝트 도입/cladding:init "이 프로젝트에 cladding 적용해줘"기존 코드 스캔 → 관찰한 패턴을 intent와 결합

+# 정확히 하나를 골라 앞의 '#'을 지우고 실행한다:
+# codex          # Codex
+# claude         # Claude Code
+# gemini         # Gemini CLI
+# agy            # Antigravity
+# cursor-agent   # Cursor Agent
+

clad setup은 이 머신에서 감지된 AI 도구(Claude Code · Codex · Gemini · Antigravity · Cursor)를 현재 프로젝트에만 연결한다 — 단 Antigravity는 프로젝트-로컬 MCP 설정을 읽지 않는 호스트라 유일하게 머신 단위로 연결된다(자세한 내용은 setup 문서). 설정하지 않은 다른 프로젝트의 모델 컨텍스트에는 Cladding skill이나 MCP 도구가 들어가지 않는다. Cursor IDE는 <project> 폴더를 작업공간으로 연다. setup 뒤에는 반드시 이 폴더에서 AI 도구를 새 세션으로 시작한다. Codex와 Gemini가 프로젝트 신뢰 여부를 물으면 각 호스트의 정상 보안 경계에 따라 승인한다. 신뢰하기 전에는 프로젝트 로컬 MCP 설정이 의도적으로 적용되지 않는다.

-

- 호스트 지원 현황(정직 고지): Claude Code는 실사용 캠페인으로 전 기능 검증됨(실시간 개입 포함). Codex · Gemini CLI는 연결은 자동이지만, 동작은 아직 검증 전이다. Cursor는 연결은 자동이지만 실사용 검증이 아직이다. → 설치 상세 · 호스트 배선 · MCP · 업그레이드 -

+

3. 프로젝트에 Cladding 한 번 적용하기

+

자신의 시작 상황에 맞는 요청을 AI 도구에 자연스럽게 말한다.

+

Cladding은 먼저 프로젝트를 읽기 전용으로 조사한다. AI가 정확한 파일 작업과 일회용 승인 문구를 보여주며, 사용자가 별도 답변에서 그 문구를 그대로 입력해야만 초기화가 시작된다. 프로젝트를 열거나 Cladding에 관해 질문하는 것만으로는 어떤 파일도 변경되지 않는다. 이 정확 일치 단계는 우발적인 적용을 막지만, MCP는 도구 인자를 실제로 어느 사용자가 만들었는지 증명할 수 없다. 따라서 악의적이거나 침해된 호스트를 격리하는 샌드박스로 보아서는 안 된다.

+ +

아이디어만 있을 때

+ 
B2B 결제 SaaS를 cladding으로 시작해줘.
+

LLM이 도메인을 분석해 spec · 문서 · 정책을 만든다. 중요한 제품 결정이 실제로 비어 있을 때만 후속 질문을 최대 3개 하며, 완성된 기획에는 질문하지 않는다.

+ +

기획 문서가 있을 때

+ 
docs/plan.md를 기준으로 cladding을 적용해줘.
+

파일을 읽고 그 내용을 프로젝트 intent로 사용한다.

+ +

기존 프로젝트에 도입할 때

+ 
현재 코드를 분석해서 cladding을 적용해줘.
+

기존 코드를 스캔하고, 관찰한 패턴을 사용자의 intent와 결합한다.

+ +

초기화가 끝나면 같은 대화에서 바로 개발을 이어가면 된다. 다음 기능을 자연어로 요청하면 AI가 생성된 spec과 문서를 기준으로 개발하고, 중요한 설계 변경도 프로젝트 성장에 맞춰 함께 반영한다. 검사는 호스트가 호출할 때 실행되며, 자동 강제가 필요하면 선택형 Git hook이나 CI 게이트를 사용한다.

+ 
이메일 로그인 기능을 테스트까지 포함해서 구현해줘.
+

새로 외울 명령은 없다. 호스트별 명시 호출법, 더 강한 Git/CI 적용, 검증된 호스트 현황은 설치 상세에서 확인할 수 있다.

Update

-

최신 상태 유지는 두 명령 — 아니면 AI 도구에게 한 줄이면 된다.

+

AI 도구에 요청하기 (추천)

+

프로젝트에서 다음과 같이 말한다:

+ 
cladding을 최신 버전으로 업데이트해줘.
+

AI 도구에 터미널 및 전역 설치 권한이 있으면 CLI 업데이트, 호스트 배선 갱신, 현재 프로젝트 업데이트를 수행하고 새로 발견한 어긋남을 설명한다. 권한이 없으면 승인하거나 직접 실행할 명령을 안내한다.

+

또는 터미널에서 직접 업데이트하기

npm update -g cladding   # 1. 새 버전 받기
-cd <project>             # 2. 프로젝트로 이동
-clad update              # 3. 맞춰 정렬
-

코드 · spec.yaml · 문서는 그대로 둔다 — 더 엄격해진 버전은 짚어만 준다, 스스로 막거나 고치지 않는다. 위 두 명령이 새 어긋남을 짚으면, 그건 AI 도구에 넘기면 된다:

- 
[AI 도구 안] 업데이트가 짚은 어긋남을 정리해줘
-

…아니면 두 명령을 건너뛰고 init 때처럼 그냥 말해도 된다 — 업데이트까지 알아서 해준다:

- 
[AI 도구 안] cladding 최신 버전으로 업데이트해줘
+cd <project> # 2. Cladding 프로젝트로 이동 +clad update # 3. 프로젝트 연결과 파생 데이터를 함께 갱신 +

clad update는 업데이트하려는 각 Cladding 프로젝트에서 실행한다. 프로젝트 전용 setup 갱신까지 함께 수행하므로 별도의 clad setup은 필요 없다. 사용자가 작성한 코드 · 기능/스펙 본문 · 문서는 보존되며, 파생 데이터와 Cladding 관리 지침 블록만 갱신될 수 있다. 새 버전이 어긋남을 발견하면 그 결과를 AI 도구에 넘기면 된다:

+ 
업데이트가 짚은 어긋남을 정리해줘.

Status

@@ -560,7 +574,7 @@

Status

version
-
v0.8.3
+
v0.9.0
2026-07
@@ -570,7 +584,7 @@

Status

tests
-
2497/2497
+
2561/2561
all pass
@@ -580,13 +594,13 @@

Status

features
-
254
-
251 done · 자기 스펙
+
255
+
252 done · 자기 스펙
-

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

+

236 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 452c6bf3..427e761c 100644 --- a/README.ko.md +++ b/README.ko.md @@ -6,13 +6,13 @@

기업이 AI에게 코딩을 맡기려면 세 가지가 필요하다 —
믿을 수 있고, 추적되고, 규모가 커져도 흔들리지 않아야 한다. cladding이 그 셋을 만든다.
- cladding(외장재)이라는 이름 그대로, 호스트 LLM(Claude Code · Codex · Gemini · Cursor)을 감싼다: 일을 시작하기 전엔 프로젝트의 의도를 넣어 주고, 마친 후엔 41개 검출기와 15단계 게이트로 결과를 검증한다. + cladding(외장재)이라는 이름 그대로, 호스트 LLM(Claude Code · Codex · Gemini · Antigravity · Cursor)을 감싼다: 일을 시작하기 전엔 프로젝트의 의도를 넣어 주고, 마친 후엔 41개 검출기와 15단계 게이트로 결과를 검증한다.

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ - **추적** — **나간 것은 기록에 남는다**: 무엇을 검증했는지는 커밋된 내용에 새겨지고, 누가·언제는 로컬 세션 로그에, 왜는 스펙에 남아, 인수인계와 리뷰가 파헤치지 않아도 된다. - **확장** — 사람과 AI를 늘리면 보통 충돌과 어긋남도 함께 불어난다. 하지만 모두가 스펙 하나를 기준으로 일하니 그게 자동으로 걸린다 — 그래서 규모를 키워도 무너지지 않는다. -cladding은 **자기 자신도 cladding으로 만든다** — 기능 254개 중 251개가 같은 게이트를 통과했고, [Ironclad](https://github.com/qwerfunch/ironclad) 표준을 L4로 구현한 첫 사례다. +cladding은 **자기 자신도 cladding으로 만든다** — 기능 255개 중 252개가 같은 게이트를 통과했고, [Ironclad](https://github.com/qwerfunch/ironclad) 표준을 L4로 구현한 첫 사례다. @@ -46,7 +46,7 @@ cladding은 **자기 자신도 cladding으로 만든다** — 기능 254개 중 | **세션을 실패 상태로 끝낼 때** | 그대로 종료, 다음에 잊힘 | 종료를 한 번 막고, 실패한 검사를 수리 카드로 인계 | | **두 명이 동시에 feature 추가** | merge conflict | hash-8 ID · 파일 분리 → 충돌 0 | | **AI가 짠 코드를 누가 검증?** | 작성한 AI가 자기 검증 (위험) | 구현을 못 보는 채점자 + 기계 관문 | -| **AI 도구를 바꿀 때** | 도구마다 재구성 | 1 spec → 4 host 자동 연결 | +| **AI 도구를 바꿀 때** | 도구마다 재구성 | 1 spec → 5 host 자동 연결 | ## 누구를 위한 것 @@ -66,7 +66,7 @@ cladding은 **자기 자신도 cladding으로 만든다** — 기능 254개 중 **후 — 결과를 검증한다:** 15단계 게이트 · 41개 어긋남 검출기 · 그리고 **구현을 못 보는 채점자** — 구현을 읽을 도구 없이 산출물을 스펙과 대조하는 에이전트라, 자기가 쓴 것에 도장을 찍어 줄 수 없다. -실시간 개입(지도 주입 · 즉시 차단 · 종료 차단)은 Claude Code에서 전부 동작한다. Codex · Gemini · Cursor에서는 같은 검증을 대화 속 도구 호출과 git · CI 관문으로 수행한다. +실시간 개입(지도 주입 · 즉시 차단 · 종료 차단)은 Claude Code에서 전부 동작한다. Codex · Gemini · Antigravity · Cursor에서는 같은 검증을 대화 속 도구 호출과 git · CI 관문으로 수행한다. @@ -240,63 +240,107 @@ cladding의 차별점은 *결합* — 위 카테고리의 핵심을 *하나의 ## Install +### 1. 컴퓨터에 한 번 설치하기 + ```bash npm install -g cladding # cladding CLI 설치 -cd # 프로젝트로 이동 -clad setup # AI 도구 자동 연결 (Claude · Codex · Gemini · Cursor) ``` -각 호스트는 cladding을 AI가 알아서 호출하는 MCP 서버로 연결한다 — `/mcp` 명령도 수동 연결 단계도 없이, 그냥 대화하면 된다. +이 단계는 어느 디렉터리에서 실행해도 된다. CLI만 설치하며 AI 도구에는 아직 Cladding 정보가 들어가지 않는다. + +### 2. 사용할 프로젝트만 연결하고 AI 도구 실행하기 + +```bash +cd +clad setup # 이 프로젝트에만 AI 도구 연결 + +# 정확히 하나를 골라 앞의 '#'을 지우고 실행한다: +# codex # Codex +# claude # Claude Code +# gemini # Gemini CLI +# agy # Antigravity +# cursor-agent # Cursor Agent +``` + +`clad setup`은 이 머신에서 감지된 AI 도구(Claude Code · Codex · Gemini · Antigravity · Cursor)를 현재 프로젝트에만 연결한다 — 단 Antigravity는 프로젝트-로컬 MCP 설정을 읽지 않는 호스트라 유일하게 머신 단위로 연결된다(자세한 내용은 [setup 문서](docs/setup.md)). 설정하지 않은 다른 프로젝트의 모델 컨텍스트에는 Cladding skill이나 MCP 도구가 들어가지 않는다. Cursor IDE는 `` 폴더를 작업공간으로 연다. setup 뒤에는 반드시 이 폴더에서 AI 도구를 새 세션으로 시작한다. Codex와 Gemini가 프로젝트 신뢰 여부를 물으면 각 호스트의 정상 보안 경계에 따라 승인한다. 신뢰하기 전에는 프로젝트 로컬 MCP 설정이 의도적으로 적용되지 않는다. + +### 3. 프로젝트에 Cladding 한 번 적용하기 + +자신의 시작 상황에 맞는 요청을 AI 도구에 자연스럽게 말한다. + +Cladding은 먼저 프로젝트를 읽기 전용으로 조사한다. AI가 정확한 파일 작업과 일회용 승인 문구를 보여주며, 사용자가 별도 답변에서 그 문구를 그대로 입력해야만 초기화가 시작된다. 프로젝트를 열거나 Cladding에 관해 질문하는 것만으로는 어떤 파일도 변경되지 않는다. +이 정확 일치 단계는 우발적인 적용을 막지만, MCP는 도구 인자를 실제로 어느 사용자가 만들었는지 증명할 수 없다. 따라서 악의적이거나 침해된 호스트를 격리하는 샌드박스로 보아서는 안 된다. + +#### 아이디어만 있을 때 + +``` +B2B 결제 SaaS를 cladding으로 시작해줘. +``` + +LLM이 도메인을 분석해 spec · 문서 · 정책을 만든다. 중요한 제품 결정이 실제로 비어 있을 때만 후속 질문을 최대 3개 하며, 완성된 기획에는 질문하지 않는다. -그다음, 프로젝트당 한 번, AI 도구 안에서 init을 호출한다: +#### 기획 문서가 있을 때 ``` -[AI 도구 안] /cladding:init "B2B 결제 SaaS" +docs/plan.md를 기준으로 cladding을 적용해줘. ``` -프로젝트의 `spec.yaml` 과 관련 문서가 만들어진다. 그 뒤론 평소처럼 개발하면 된다 — cladding이 배경에서 전 · 후 루프를 돌리니 따로 외울 것은 없다. 강제력을 높이려면 `clad init --with-hook`(pre-commit + pre-push git hook) 이나 `clad init --with-ci`(CI 게이트 스캐폴드 — 진짜 강제는 CI에서 산다). +파일을 읽고 그 내용을 프로젝트 intent로 사용한다. -| 시작 상황 | 명령 | 무엇이 일어나는가 | -|---|---|---| -| **아이디어만 있을 때** | `/cladding:init "B2B 결제 SaaS 만들거야"` | LLM이 도메인 분석 → spec · 문서 · 정책 자동 생성 + 후속 질문 2–3개 | -| **기획 문서가 있을 때** | `/cladding:init docs/plan.md` | 파일을 로드해 내용을 intent로 사용 | -| **기존 프로젝트 도입** | `/cladding:init "이 프로젝트에 cladding 적용해줘"` | 기존 코드 스캔 → 관찰한 패턴을 intent와 결합 | +#### 기존 프로젝트에 도입할 때 -**호스트 지원 현황(정직 고지):** Claude Code는 실사용 캠페인으로 전 기능 검증됨(실시간 개입 포함). Codex · Gemini CLI는 연결은 자동이지만, 동작은 아직 검증 전이다. Cursor는 연결은 자동이지만 실사용 검증이 아직이다. → [설치 상세 · 호스트 배선 · MCP · 업그레이드](docs/setup.md) +``` +현재 코드를 분석해서 cladding을 적용해줘. +``` + +기존 코드를 스캔하고, 관찰한 패턴을 사용자의 intent와 결합한다. + +> **초기화가 끝나면 같은 대화에서 바로 개발을 이어가면 된다.** 다음 기능을 자연어로 요청하면 AI가 생성된 spec과 문서를 기준으로 개발하고, 중요한 설계 변경도 프로젝트 성장에 맞춰 함께 반영한다. 검사는 호스트가 호출할 때 실행되며, 자동 강제가 필요하면 선택형 Git hook이나 CI 게이트를 사용한다. + +``` +이메일 로그인 기능을 테스트까지 포함해서 구현해줘. +``` + +새로 외울 명령은 없다. 호스트별 명시 호출법, 더 강한 Git/CI 적용, 검증된 호스트 현황은 [설치 상세](docs/setup.md)에서 확인할 수 있다. ## Update -최신 상태 유지는 두 명령 — 아니면 AI 도구에게 한 줄이면 된다. +### AI 도구에 요청하기 (추천) -```bash -npm update -g cladding # 1. 새 버전 받기 -cd # 2. 프로젝트로 이동 -clad update # 3. 맞춰 정렬 +프로젝트에서 다음과 같이 말한다: + +``` +cladding을 최신 버전으로 업데이트해줘. ``` -코드 · `spec.yaml` · 문서는 그대로 둔다 — 더 엄격해진 버전은 **짚어만 준다**, 스스로 막거나 고치지 않는다. 위 두 명령이 새 어긋남을 짚으면, 그건 AI 도구에 넘기면 된다: +AI 도구에 터미널 및 전역 설치 권한이 있으면 CLI 업데이트, 호스트 배선 갱신, 현재 프로젝트 업데이트를 수행하고 새로 발견한 어긋남을 설명한다. 권한이 없으면 승인하거나 직접 실행할 명령을 안내한다. -``` -[AI 도구 안] 업데이트가 짚은 어긋남을 정리해줘 +### 또는 터미널에서 직접 업데이트하기 + +```bash +npm update -g cladding # 1. 새 버전 받기 +cd # 2. Cladding 프로젝트로 이동 +clad update # 3. 프로젝트 연결과 파생 데이터를 함께 갱신 ``` -…아니면 두 명령을 건너뛰고 init 때처럼 그냥 말해도 된다 — 업데이트까지 알아서 해준다: +`clad update`는 업데이트하려는 각 Cladding 프로젝트에서 실행한다. 사용자가 작성한 코드 · 기능/스펙 본문 · 문서는 보존되며, 프로젝트 전용 호스트 연결과 파생 데이터, `AGENTS.md`의 Cladding 관리 블록만 갱신될 수 있다. 새 버전이 어긋남을 발견하면 그 결과를 AI 도구에 넘기면 된다: ``` -[AI 도구 안] cladding 최신 버전으로 업데이트해줘 +업데이트가 짚은 어긋남을 정리해줘. ``` + ## Status | version | 준수 등급 | tests | gate | features | |---|---|---|---|---| -| v0.8.3 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2497 / 2497 · all pass | 15 단계 · 41 detectors | 254 · 251 done · 자기 스펙 | +| v0.9.0 · 2026-07 | L4 · [L0–L4 중 최고 · 자가 선언](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2561 / 2561 · all pass | 15 단계 · 41 detectors | 255 · 252 done · 자기 스펙 | -234 test files · capability 6개 · coverage는 COVERAGE_DROP detector가 하락 차단 +236 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 ee2d2a8a..5a874322 100644 --- a/README.md +++ b/README.md @@ -6,13 +6,13 @@

To trust AI with coding, an organization needs three things — that the code can be trusted,
that it's traced, and that it holds up as you scale. cladding builds those three.
- True to its name (cladding = the outer layer), it wraps your host LLM (Claude Code · Codex · Gemini · Cursor): before it starts, cladding feeds it the project's intent; after it finishes, cladding verifies the result with 41 detectors and a 15-stage gate. + True to its name (cladding = the outer layer), it wraps your host LLM (Claude Code · Codex · Gemini · Antigravity · Cursor): before it starts, cladding feeds it the project's intent; after it finishes, cladding verifies the result with 41 detectors and a 15-stage gate.

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 — 251 of its 254 features cleared this same gate, the first L4 implementation of the [Ironclad](https://github.com/qwerfunch/ironclad) standard. +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. @@ -46,7 +46,7 @@ The same situation, in a *vanilla AI setup* and in cladding. | **Ending a session in a failing state** | exits as-is, forgotten next time | the exit is blocked once, the failing checks handed off as a repair card | | **Two devs add a feature at the same time** | merge conflict | hash-8 IDs · separate files → 0 conflicts | | **Who verifies the AI-written code?** | the AI that wrote it self-certifies (risky) | an implementation-blind grader + the mechanical gate | -| **Switching AI tools** | reconfigure per tool | one spec → 4 hosts wired automatically | +| **Switching AI tools** | reconfigure per tool | one spec → 5 hosts wired automatically | ## Who it's for @@ -66,7 +66,7 @@ The same situation, in a *vanilla AI setup* and in cladding. **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 · Cursor the same verification runs through in-conversation tool calls plus the git · CI gate. +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. @@ -237,65 +237,124 @@ The distinction is the *combination* — binding those cores into *one verificat ## Install +### 1. Install once on your machine + ```bash -npm install -g cladding # the cladding CLI -cd # your project -clad setup # auto-wire your AI tools (Claude · Codex · Gemini · Cursor) +npm install -g cladding # install only the cladding CLI ``` -Each host wires cladding as an MCP server the AI calls on its own — there's no `/mcp` command and no manual connect step; you just chat. +This command may be run from any directory. It does not add Cladding to any AI model's context. -Then, once per project, call init inside your AI tool: +### 2. Activate one project, then start your AI tool +```bash +cd +clad setup # connect Cladding only to this project + +# Choose exactly one and remove its leading '#': +# codex # Codex +# claude # Claude Code +# gemini # Gemini CLI +# agy # Antigravity +# cursor-agent # Cursor Agent ``` -[inside your AI tool] /cladding:init "B2B payment SaaS" + +`clad setup` connects the AI tools it detects on your machine (Claude Code, Codex, Gemini, Antigravity, +Cursor) to this project only — Antigravity is the one exception, wired machine-wide because it reads no +project-local MCP config (details in [setup](docs/setup.md)). It does not expose Cladding skills or MCP +tools in projects where setup was not run. Use only the command +for your AI tool; for Cursor IDE, open `` as the workspace. Start a new AI session from this +folder after setup so the host discovers the project-local connection. When Codex first opens a Git +repository, approve its normal project-trust prompt; Codex intentionally ignores project MCP config +until the repository is trusted. + +### 3. Apply Cladding once + +Choose the starting point that fits and say it naturally in your AI tool. + +Cladding first inspects the project without changing it. Your AI shows the exact file operations and +a one-time approval phrase; initialization begins only when you repeat that phrase in a separate reply. +Opening a project or asking a question about Cladding never authorizes file changes. +This exact-match step prevents accidental application; MCP cannot prove which user produced a tool +argument, so it is not a sandbox against a malicious or compromised host. + +#### An idea, nothing else + ``` +Start this B2B payment SaaS with Cladding. +``` + +The LLM analyzes the domain and creates the spec, docs, and policies. It asks up to three follow-up +questions only when an important product decision is still unresolved; a complete plan asks none. -It creates the project's `spec.yaml` and supporting docs. After that, just develop as usual — cladding runs the before/after loop in the background, with nothing to memorize. Raise enforcement with `clad init --with-hook` (pre-commit + pre-push git hooks) or `clad init --with-ci` (scaffold the CI gate, where true enforcement lives). +#### A planning document -| Starting point | Command | What happens | -|---|---|---| -| **An idea, nothing else** | `/cladding:init "I'm going to build a B2B payment SaaS"` | the LLM analyzes the domain → spec · docs · policies + 2–3 follow-up questions | -| **A planning doc** | `/cladding:init docs/plan.md` | loads the file and uses its contents as intent | -| **An existing project** | `/cladding:init "apply cladding to this project"` | scans the existing code → observed patterns merged with your intent | +``` +Apply Cladding using docs/plan.md. +``` -**Host support (honest):** Claude Code is fully verified through real-usage campaigns (incl. real-time intervention). Codex · Gemini CLI wire automatically; their behavior isn't verified yet. Cursor wires automatically, but real-usage verification is still pending. → [setup details · host wiring · MCP · upgrading](docs/setup.md) +Cladding loads the file and uses its contents as the project intent. - +#### An existing project + +``` +Analyze this project and apply Cladding. +``` + +Cladding scans the existing code and combines the observed patterns with your intent. + +> **Once initialization is complete, keep developing in the same conversation.** Ask for the next feature in plain language; the AI uses the generated spec and docs and keeps material design changes aligned as the project grows. Checks run when the host invokes them; use the optional Git hooks or CI gate when you want automatic enforcement. + +``` +Implement email sign-in, including tests. +``` + +There is nothing new to memorize. For host-specific invocation, stricter Git/CI enforcement, and verified host status, see [setup details](docs/setup.md). + + ## Update -Staying current is two commands — or one line to your AI tool. +### Ask your AI tool (recommended) + +From your project, say: -```bash -npm update -g cladding # 1. get the new version -cd # 2. your project -clad update # 3. bring it in line +``` +Update cladding to the latest version. ``` -Your code · `spec.yaml` · docs are left untouched — a stricter version only **points things out**, it never blocks or fixes on its own. If those two commands flag fresh drift, hand it to your AI tool: +If the AI tool has terminal and global-install permission, it updates the CLI, refreshes host wiring, +updates the current project, and explains any new drift. Otherwise, it shows the commands for you to approve or run. -``` -[inside your AI tool] reconcile the drift the update flagged +### Or update from the terminal + +```bash +npm update -g cladding # 1. get the new CLI version +cd # 2. enter one Cladding project +clad update # 3. refresh its host wiring and derived state ``` -…or skip the commands and just ask, the same way you ran init — it runs the update for you: +Run `clad update` in each Cladding project you want to upgrade. It also performs the project-scoped +setup refresh, so a separate `clad setup` is unnecessary. It preserves authored code, feature/spec +content, and documentation; only derived data and Cladding-managed instruction blocks may be refreshed. If the new version reports drift, +hand that result to your AI tool: ``` -[inside your AI tool] update cladding to the latest version +Reconcile the drift the update flagged. ``` + ## Status | Version | Conformance | Tests | Gate | Features | |---|---|---|---|---| -| v0.8.3 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2497 / 2497 | 15 stages · 41 detectors | 254 (251 done) | +| v0.9.0 (2026-07) | L4 · [self-declared](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2561 / 2561 | 15 stages · 41 detectors | 255 (252 done) | -234 test files · 6 capabilities · coverage drop blocked by the COVERAGE_DROP detector +236 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 ffdd6f36..92561978 100644 --- a/README.zh.md +++ b/README.zh.md @@ -6,13 +6,13 @@

要放心把编码交给 AI，一个组织需要三样东西 ——
代码可信、过程可追溯、规模扩张时依然稳固。cladding 把这三样一手做齐。
- 正如其名（cladding = 外覆层），它包裹住你的宿主 LLM（Claude Code · Codex · Gemini · Cursor）：在它动手之前，cladding 先把项目的意图喂给它；在它收尾之后，cladding 用 41 个检测器和 15 阶段门禁验证结果。 + 正如其名（cladding = 外覆层），它包裹住你的宿主 LLM（Claude Code · Codex · Gemini · Antigravity · Cursor）：在它动手之前，cladding 先把项目的意图喂给它；在它收尾之后，cladding 用 41 个检测器和 15 阶段门禁验证结果。

ironclad spec - tests + tests detectors license

@@ -31,7 +31,7 @@ - **可追溯** —— **交付出去的一切都留有记录**：验证了什么，写进已提交的内容；谁、何时，记在本地会话账本；为什么，留在 spec —— 于是交接与评审无需考古，就能追溯每一个决定。 - **可扩展** —— 人和 AI 越多，通常冲突和漂移也越多。但所有人都以同一份 spec 为基准，这些会被自动挡下 —— 所以不断扩张也不会崩。 -cladding 连**自己**也是用 cladding 造的 —— 254 个 feature 里有 251 个通过了同一道门禁，成为 [Ironclad](https://github.com/qwerfunch/ironclad) 标准的首个 L4 实现。 +cladding 连**自己**也是用 cladding 造的 —— 255 个 feature 里有 252 个通过了同一道门禁，成为 [Ironclad](https://github.com/qwerfunch/ironclad) 标准的首个 L4 实现。 @@ -46,7 +46,7 @@ cladding 连**自己**也是用 cladding 造的 —— 254 个 feature 里有 25 | **在失败状态下结束会话** | 原样退出，下次就忘了 | 退出被拦一次，把失败的检查作为修复卡片交接下去 | | **两名开发者同时新增 feature** | 合并冲突 | 8 位 hash ID · 各自成文件 → 零冲突 | | **AI 写的代码谁来验证？** | 谁写谁自证（有风险） | 一个看不到实现的评分者 + 机械门禁 | -| **切换 AI 工具** | 每换一个工具就重配一次 | 一份 spec → 自动接通 4 个宿主 | +| **切换 AI 工具** | 每换一个工具就重配一次 | 一份 spec → 自动接通 5 个宿主 | ## 适合谁 @@ -66,7 +66,7 @@ cladding 连**自己**也是用 cladding 造的 —— 254 个 feature 里有 25 **之后 —— 验证结果：** 15 阶段门禁、41 个漂移检测器，外加一个**看不到实现的评分者** —— 这个智能体对照 spec 核查成果，却*没有任何读取实现的工具*，因此无法给自己写下的东西盖章放行。 -实时干预（注入地图 · 当场拦截 · 退出拦截）在 Claude Code 上全部可用。在 Codex · Gemini · Cursor 上，同样的验证通过对话中的工具调用，再加 git · CI 门禁来完成。 +实时干预（注入地图 · 当场拦截 · 退出拦截）在 Claude Code 上全部可用。在 Codex · Gemini · Antigravity · Cursor 上，同样的验证通过对话中的工具调用，再加 git · CI 门禁来完成。 @@ -237,63 +237,107 @@ cladding 的独到之处在于*组合* —— 把上述品类的内核，绑进* ## Install +### 1. 在电脑上安装一次 + ```bash npm install -g cladding # 安装 cladding CLI -cd # 进入项目目录 -clad setup # 自动接通你的 AI 工具（Claude · Codex · Gemini · Cursor） ``` -每个宿主都把 cladding 接为一台 MCP 服务器，由 AI 自行调用 —— 没有 `/mcp` 命令，也无需手动连接，照常对话即可。 +这条命令可以在任何目录运行。它只安装 CLI，不会把 Cladding 加入任何 AI 模型的上下文。 + +### 2. 只激活要使用的项目，然后启动 AI 工具 + +```bash +cd +clad setup # 只为这个项目连接 Cladding + +# 只选择一个，并删除行首的“#”后运行： +# codex # Codex +# claude # Claude Code +# gemini # Gemini CLI +# agy # Antigravity +# cursor-agent # Cursor Agent +``` + +`clad setup` 只把本机检测到的 AI 工具（Claude Code、Codex、Gemini、Antigravity、Cursor）连接到当前项目 —— 唯一的例外是 Antigravity：它不读取项目本地的 MCP 配置，因此只能按机器级别连接（详见 [setup 文档](docs/setup.md)）。没有运行 setup 的其他项目，其模型上下文不会出现 Cladding skill 或 MCP 工具。只需运行自己所用 AI 工具对应的一条命令；使用 Cursor IDE 时，把 `` 作为工作区打开。setup 后请从此文件夹启动新的 AI 会话。Codex 或 Gemini 询问是否信任项目时，请按照各自主机的正常安全边界确认；在此之前，项目本地 MCP 配置会被有意忽略。 + +### 3. 为项目应用一次 Cladding + +根据自己的起点，用自然语言告诉 AI 工具。 + +Cladding 会先以只读方式检查项目。AI 会展示准确的文件操作和一次性批准短语；只有当用户在单独回复中原样输入该短语时，初始化才会开始。仅仅打开项目或询问 Cladding 不会修改任何文件。 +这种精确匹配可防止意外应用，但 MCP 无法证明工具参数实际上由哪位用户提供；因此它不是隔离恶意或已受侵主机的沙箱。 + +#### 只有一个想法时 + +``` +用 cladding 开始这个 B2B 支付 SaaS。 +``` + +LLM 会分析领域并创建 spec、文档和策略。只有关键产品决策尚未明确时才会提出最多 3 个后续问题；完整的规划不会被强制追问。 -随后，每个项目一次，在你的 AI 工具中调用 init： +#### 已有规划文档时 ``` -[在你的 AI 工具中] /cladding:init "B2B 支付 SaaS" +根据 docs/plan.md 应用 cladding。 ``` -它会创建项目的 `spec.yaml` 与配套文档。此后照常开发即可 —— cladding 会在后台跑那套「之前 / 之后」循环，没有需要记的命令。想提高强制力：`clad init --with-hook`（安装 pre-commit + pre-push git 钩子）或 `clad init --with-ci`（搭好 CI 门禁的脚手架 —— 真正的强制力在 CI 里）。 +Cladding 会加载该文件，并将其内容作为项目意图。 -| 起点 | 命令 | 会发生什么 | -|---|---|---| -| **只有一个想法，别无其他** | `/cladding:init "我要做一个 B2B 支付 SaaS"` | LLM 分析领域 → 生成 spec · 文档 · 策略 + 2–3 个追问 | -| **已有一份规划文档** | `/cladding:init docs/plan.md` | 加载该文件，用其内容作为意图 | -| **接入已有项目** | `/cladding:init "把 cladding 应用到这个项目"` | 扫描现有代码 → 把观察到的模式与你的意图融合 | +#### 接入已有项目时 -**宿主支持（诚实说明）：** Claude Code 已通过真实使用的实测（含实时干预）全面验证。Codex · Gemini CLI 已自动接线，但行为尚未验证。Cursor 会自动接线，但真实使用的验证仍待补。→ [安装细节 · 宿主接线 · MCP · 升级](docs/setup.md) +``` +分析当前代码并应用 cladding。 +``` + +Cladding 会扫描现有代码，并把观察到的模式与你的意图结合起来。 + +> **初始化完成后，直接在同一段对话中继续开发即可。** 用自然语言提出下一个功能，AI 会依据生成的 spec 和文档开发，并让重要设计随项目成长同步演进。检查会在宿主调用时运行；如需自动强制，请启用可选的 Git hook 或 CI gate。 + +``` +实现邮箱登录功能，并包含测试。 +``` + +无需再记新的命令。宿主专用调用方式、更严格的 Git/CI 执行方式以及已验证的宿主状态，请参阅[安装细节](docs/setup.md)。 ## Update -保持最新只需两条命令 —— 或者对你的 AI 工具说一句话。 +### 让 AI 工具更新（推荐） -```bash -npm update -g cladding # 1. 取得新版本 -cd # 2. 进入项目目录 -clad update # 3. 与新版对齐 +在项目中这样说： + +``` +把 cladding 更新到最新版本。 ``` -你的代码 · `spec.yaml` · 文档都原封不动 —— 更严格的版本只是把东西**指出来**，既不拦截，也不擅自修改。若上面这两条命令标出了新的漂移，把它交给你的 AI 工具即可： +如果 AI 工具有终端和全局安装权限，它会更新 CLI、刷新宿主接线、更新当前项目，并解释新发现的漂移；否则，它会给出需要批准或手动执行的命令。 -``` -[在你的 AI 工具中] 修复这次更新标出的漂移 +### 或在终端中直接更新 + +```bash +npm update -g cladding # 1. 取得新版本 +cd # 2. 进入 Cladding 项目 +clad update # 3. 刷新项目连接和派生状态 ``` -…或者跳过这两条命令，像你当初跑 init 那样直接说一句 —— 它会连更新一起帮你做： +`clad update` 需要在每个要升级的 Cladding 项目中运行。它会同时刷新项目级 setup，因此不必另外运行 `clad setup`。用户编写的代码、功能/spec 正文和文档会保留；只有派生数据和 Cladding 管理的指令区块可能被刷新。如果新版本报告了漂移，把结果交给 AI 工具即可： ``` -[在你的 AI 工具中] 把 cladding 更新到最新版本 +修复这次更新标出的漂移。 ``` + ## Status | 版本 | 一致性 | Tests | Gate | Features | |---|---|---|---|---| -| v0.8.3（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2497 / 2497 | 15 阶段 · 41 检测器 | 254（251 done） | +| v0.9.0（2026-07） | L4 · [自我声明](https://github.com/qwerfunch/ironclad/blob/main/GOVERNANCE.md) | 2561 / 2561 | 15 阶段 · 41 检测器 | 255（252 done） | -234 个测试文件 · 6 项 capability · 覆盖率下降由 COVERAGE_DROP 检测器拦下 +236 个测试文件 · 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/ab-evaluation/case-existing-adoption.md b/docs/ab-evaluation/case-existing-adoption.md index 673575a0..54cd6394 100644 --- a/docs/ab-evaluation/case-existing-adoption.md +++ b/docs/ab-evaluation/case-existing-adoption.md @@ -41,8 +41,8 @@ No spec, no architecture invariants — just code on the existing tree. | Architecture layers | 3 | 0 | +3 | | Forbidden-import rules | 0 | 0 | +0 | | Detector errors | 0 | 1 | -1 | -| Detector warnings | 5 | 3 | +2 | -| Detector infos | 6 | 28 | -22 | +| Detector warnings | 1 | 3 | -2 | +| Detector infos | 10 | 28 | -18 | | Tiered doc files | 2 | 0 | +2 | | Tiered docs (lines) | 139 | 0 | +139 | | Other doc files | 1 | 1 | +0 | @@ -51,13 +51,13 @@ No spec, no architecture invariants — just code on the existing tree. | Test files | 1 | 1 | +0 | | Test LoC | 14 | 14 | +0 | | Test cases | 1 | 1 | +0 | -| Total chars (artifacts + code) | 10843 | 3864 | +6979 | -| Estimated tokens | 2713 | 967 | +1746 | +| Total chars (artifacts + code) | 11268 | 3864 | +7404 | +| Estimated tokens | 2819 | 967 | +1852 | **Detector outcomes** (META_INTEGRITY + HARDCODED_SECRET excluded — toolchain-only checks): ``` -A (Cladding) — errors: 0 warns: 5 infos: 6 +A (Cladding) — errors: 0 warns: 1 infos: 10 B (Vanilla) — errors: 1 warns: 3 infos: 28 Sample errors: @@ -80,8 +80,8 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 | Architecture layers | 3 | 0 | +3 | | Forbidden-import rules | 0 | 0 | +0 | | Detector errors | 1 | 1 | +0 | -| Detector warnings | 5 | 3 | +2 | -| Detector infos | 7 | 28 | -21 | +| Detector warnings | 1 | 3 | -2 | +| Detector infos | 11 | 28 | -17 | | Tiered doc files | 2 | 0 | +2 | | Tiered docs (lines) | 139 | 0 | +139 | | Other doc files | 1 | 1 | +0 | @@ -90,13 +90,13 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 | Test files | 2 | 2 | +0 | | Test LoC | 27 | 27 | +0 | | Test cases | 3 | 3 | +0 | -| Total chars (artifacts + code) | 12386 | 5115 | +7271 | -| Estimated tokens | 3099 | 1280 | +1819 | +| Total chars (artifacts + code) | 12811 | 5115 | +7696 | +| Estimated tokens | 3205 | 1280 | +1925 | **Detector outcomes** (META_INTEGRITY + HARDCODED_SECRET excluded — toolchain-only checks): ``` -A (Cladding) — errors: 1 warns: 5 infos: 7 +A (Cladding) — errors: 1 warns: 1 infos: 11 Sample errors: - [AC_DRIFT] F-4db939.AC-002 EARS: ears='unwanted' requires condition starting with 'if' — empty @@ -110,8 +110,8 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 - **Structured artifacts**: cladding produces 8 tier-banner-bearing files vs vanilla's 0. - **Spec ↔ code traceability**: cladding emits 1 feature(s), 2 AC(s), 1 scenario(s), 3 capability(s); vanilla has 0 of each. - **Architecture enforcement**: cladding declares 3 layer(s) with 0 forbidden-import rule(s); vanilla has 0. -- **Detector behavior**: cladding-managed tree → 1 error(s) / 5 warn(s) / 7 info(s). Vanilla tree → 1 / 3 / 28. The detectors that gate against spec (REFERENCE_INTEGRITY, MISSING_IMPLEMENTATION, ARCHITECTURE_FROM_SPEC, CAPABILITIES_FEATURE_MAPPING) need cladding's artifacts to evaluate — without them they silently pass. The "0 errors on vanilla" therefore is **absence of signal**, not absence of drift. -- **Token cost**: cladding's cumulative artifact + code consumes ~3099 tokens vs vanilla's ~1280 (heuristic chars/4) — Δ ≈ 1819 tokens, the price of structure. +- **Detector behavior**: cladding-managed tree → 1 error(s) / 1 warn(s) / 11 info(s). Vanilla tree → 1 / 3 / 28. The detectors that gate against spec (REFERENCE_INTEGRITY, MISSING_IMPLEMENTATION, ARCHITECTURE_FROM_SPEC, CAPABILITIES_FEATURE_MAPPING) need cladding's artifacts to evaluate — without them they silently pass. The "0 errors on vanilla" therefore is **absence of signal**, not absence of drift. +- **Token cost**: cladding's cumulative artifact + code consumes ~3205 tokens vs vanilla's ~1280 (heuristic chars/4) — Δ ≈ 1925 tokens, the price of structure. - **Code surface**: vanilla writes 9 source file(s) / 144 LoC + 2 test file(s) / 3 test case(s); cladding writes 9 / 128 + 2 / 3. (Vanilla front-loads code, cladding front-loads spec — both converge by M2.) ## Outcome Quality (F-ba2e05) diff --git a/docs/ab-evaluation/case-payment-saas.md b/docs/ab-evaluation/case-payment-saas.md index de6ac103..549a169b 100644 --- a/docs/ab-evaluation/case-payment-saas.md +++ b/docs/ab-evaluation/case-payment-saas.md @@ -40,8 +40,8 @@ no spec, no scenarios, no architecture invariants. | Architecture layers | 3 | 0 | +3 | | Forbidden-import rules | 2 | 0 | +2 | | Detector errors | 0 | 1 | -1 | -| Detector warnings | 6 | 3 | +3 | -| Detector infos | 8 | 28 | -20 | +| Detector warnings | 1 | 3 | -2 | +| Detector infos | 13 | 28 | -15 | | Tiered doc files | 2 | 0 | +2 | | Tiered docs (lines) | 61 | 0 | +61 | | Other doc files | 0 | 1 | -1 | @@ -50,13 +50,13 @@ no spec, no scenarios, no architecture invariants. | Test files | 0 | 1 | -1 | | Test LoC | 0 | 20 | -20 | | Test cases | 0 | 2 | -2 | -| Total chars (artifacts + code) | 6175 | 3463 | +2712 | -| Estimated tokens | 1545 | 867 | +678 | +| Total chars (artifacts + code) | 6708 | 3463 | +3245 | +| Estimated tokens | 1679 | 867 | +812 | **Detector outcomes** (META_INTEGRITY + HARDCODED_SECRET excluded — toolchain-only checks): ``` -A (Cladding) — errors: 0 warns: 6 infos: 8 +A (Cladding) — errors: 0 warns: 1 infos: 13 B (Vanilla) — errors: 1 warns: 3 infos: 28 Sample errors: @@ -79,8 +79,8 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 | Architecture layers | 3 | 0 | +3 | | Forbidden-import rules | 2 | 0 | +2 | | Detector errors | 1 | 1 | +0 | -| Detector warnings | 9 | 3 | +6 | -| Detector infos | 9 | 28 | -19 | +| Detector warnings | 3 | 3 | +0 | +| Detector infos | 15 | 28 | -13 | | Tiered doc files | 2 | 0 | +2 | | Tiered docs (lines) | 61 | 0 | +61 | | Other doc files | 0 | 1 | -1 | @@ -89,13 +89,13 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 | Test files | 1 | 2 | -1 | | Test LoC | 8 | 33 | -25 | | Test cases | 1 | 4 | -3 | -| Total chars (artifacts + code) | 7339 | 5592 | +1747 | -| Estimated tokens | 1836 | 1399 | +437 | +| Total chars (artifacts + code) | 7872 | 5592 | +2280 | +| Estimated tokens | 1970 | 1399 | +571 | **Detector outcomes** (META_INTEGRITY + HARDCODED_SECRET excluded — toolchain-only checks): ``` -A (Cladding) — errors: 1 warns: 9 infos: 9 +A (Cladding) — errors: 1 warns: 3 infos: 15 Sample errors: - [AC_DRIFT] F-4db939.AC-002 EARS: ears='unwanted' requires condition starting with 'if' — empty @@ -109,8 +109,8 @@ B (Vanilla) — errors: 1 warns: 3 infos: 28 - **Structured artifacts**: cladding produces 9 tier-banner-bearing files vs vanilla's 0. - **Spec ↔ code traceability**: cladding emits 1 feature(s), 2 AC(s), 2 scenario(s), 3 capability(s); vanilla has 0 of each. - **Architecture enforcement**: cladding declares 3 layer(s) with 2 forbidden-import rule(s); vanilla has 0. -- **Detector behavior**: cladding-managed tree → 1 error(s) / 9 warn(s) / 9 info(s). Vanilla tree → 1 / 3 / 28. The detectors that gate against spec (REFERENCE_INTEGRITY, MISSING_IMPLEMENTATION, ARCHITECTURE_FROM_SPEC, CAPABILITIES_FEATURE_MAPPING) need cladding's artifacts to evaluate — without them they silently pass. The "0 errors on vanilla" therefore is **absence of signal**, not absence of drift. -- **Token cost**: cladding's cumulative artifact + code consumes ~1836 tokens vs vanilla's ~1399 (heuristic chars/4) — Δ ≈ 437 tokens, the price of structure. +- **Detector behavior**: cladding-managed tree → 1 error(s) / 3 warn(s) / 15 info(s). Vanilla tree → 1 / 3 / 28. The detectors that gate against spec (REFERENCE_INTEGRITY, MISSING_IMPLEMENTATION, ARCHITECTURE_FROM_SPEC, CAPABILITIES_FEATURE_MAPPING) need cladding's artifacts to evaluate — without them they silently pass. The "0 errors on vanilla" therefore is **absence of signal**, not absence of drift. +- **Token cost**: cladding's cumulative artifact + code consumes ~1970 tokens vs vanilla's ~1399 (heuristic chars/4) — Δ ≈ 571 tokens, the price of structure. - **Code surface**: vanilla writes 5 source file(s) / 126 LoC + 2 test file(s) / 4 test case(s); cladding writes 1 / 11 + 1 / 1. (Vanilla front-loads code, cladding front-loads spec — both converge by M2.) ## Outcome Quality (F-ba2e05) diff --git a/docs/dogfood/antigravity-cli-2026-07-14.md b/docs/dogfood/antigravity-cli-2026-07-14.md new file mode 100644 index 00000000..c26e83dd --- /dev/null +++ b/docs/dogfood/antigravity-cli-2026-07-14.md @@ -0,0 +1,19 @@ +# Antigravity CLI onboarding campaign — 2026-07-14 + +- Host: Antigravity CLI (`agy`) 1.1.0 +- Plugin: `plugins/antigravity` (19 skills, one MCP server) +- Transport: stdio MCP through `clad serve` +- Result: verified + +## Live cases + +| Case | Preview before writes | Separate exact approval | Result | +|---|---:|---:|---| +| Idea only | pass | pass | initialized; unresolved KYB/KYC choice returned to the user without inventing an answer | +| Planning document | pass | pass | initialized from `plan.md` with no unnecessary follow-up | +| Existing project | pass | pass | observed ES modules, two-space indentation, JSDoc, and the Node test runner before adoption | +| Uninitialized control | n/a | n/a | ordinary file request created only the requested file; no Cladding artifacts or intervention | + +AGY runs each printed turn in a separate process. The campaign therefore also verifies the +machine-local, short-lived approval cache used when a host does not retain the opaque preparation +token between turns. The approval phrase remains exact, single-use, and expires after 30 minutes. diff --git a/docs/dogfood/antigravity-cli-2026-07-15.md b/docs/dogfood/antigravity-cli-2026-07-15.md new file mode 100644 index 00000000..1742370a --- /dev/null +++ b/docs/dogfood/antigravity-cli-2026-07-15.md @@ -0,0 +1,26 @@ +# Antigravity CLI project-scoped onboarding campaign — 2026-07-15 + +- Host: Antigravity CLI `1.1.2` +- Transport: `.agents/mcp_config.json` → project `.cladding/host/serve.cjs` +- Result: verified + +The legacy 0.8.3 global plugin was backed up and temporarily disabled so it could not make the project wiring pass vacuously. A shell trap restored the plugin and its configuration after the campaign; the before/after configuration diff was empty. + +| Case | Result | +|---|---| +| No setup control | only the requested `greeting.txt` was created | +| Setup-only control | ordinary request completed without initialization or Cladding commentary | +| Idea | staged draft applied after a separate exact phrase; two material product questions returned | +| Complete `plan.md` | initialized with the document intent and no follow-up questions | +| Existing code | existing-adoption initialized while preserving source and tests | + +All three initialization cases passed `clad sync`, left no staged cache after apply, and wrote no authored onboarding artifact before approval. + +## Post-initialization ordinary development + +- Isolation: Antigravity kept its authenticated HOME, but the imported user-global Cladding plugin was disabled and all 25 user-global `cladding-*` skill links were moved to a temporary backup for the live run. The active count was independently observed as zero; the trap restored all 25 links and re-enabled the plugin afterward. +- Live task: the host added the **Note favorites** feature using only the initialized project's `AGENTS.md`, MCP configuration, init skill, and runtime launcher. The main conversation was `480c524f-6b7e-40e3-a8c5-342409f63648`, and the process exited normally. +- Independent contexts: conversation `50cdbfb0-39e2-4e05-bd89-a56a9c071ab9` authored the tests, and conversation `e65fbd5d-ee3a-4ac8-9070-bd5c4c571cb5` performed the final review. The reviewer approved the result. +- Design and completion: the feature was classified additive, linked to the note-favorites capability and the find-and-manage-note journey, and marked done through the project-local completion command. +- Test collection: `npm test` used the explicit paths `dist/tests/noteArchive.test.js` and `dist/tests/noteFavorites.test.js`; 12/12 tests passed. The same paths passed 12/12 under an independently selected Node 20 runtime. +- Clean gate: the host created implementation, attestation, and completion commits (`3d19430`, `d90f31d`, `23bd356`). An independent strict check passed every configured stage on a clean tree, and `git diff --check` reported no whitespace errors. diff --git a/docs/dogfood/claude-code-2026-07-15.md b/docs/dogfood/claude-code-2026-07-15.md new file mode 100644 index 00000000..e8f3d6c7 --- /dev/null +++ b/docs/dogfood/claude-code-2026-07-15.md @@ -0,0 +1,9 @@ +# Claude Code project-scoped onboarding campaign — 2026-07-15 + +- Host: Claude Code `2.1.207` +- Authentication: OAuth login present +- Result: live model campaign blocked by the host quota + +Claude reported that the weekly model limit had been reached and would reset on July 17 at 17:00 Asia/Seoul. This is recorded as `not-run`, not a pass or a Cladding failure. + +The free structural checks did pass: project setup produced only `.claude/skills/cladding-init`, `.mcp.json`, and the ignored launcher; a direct stdio initialize + `tools/list` handshake reached that launcher and exposed `clad_stage_init`. The natural-language control and three initialization scenarios must be rerun after quota reset before this release can claim a live Claude onboarding pass. diff --git a/docs/dogfood/codex-cli-2026-07-15.md b/docs/dogfood/codex-cli-2026-07-15.md new file mode 100644 index 00000000..dcf9bb30 --- /dev/null +++ b/docs/dogfood/codex-cli-2026-07-15.md @@ -0,0 +1,61 @@ +# Codex CLI project-scoped onboarding campaign — 2026-07-15 + +- Host: Codex CLI `0.144.3` +- Authentication: ChatGPT subscription in an isolated `CODEX_HOME` +- Transport: trusted-repository `.codex/config.toml` → project `.cladding/host/serve.cjs` +- Result: onboarding and the first ordinary post-init feature cycle verified + +## Live cases + +| Case | Result | +|---|---| +| No setup control | ordinary `greeting.txt` request completed; zero Cladding files or intervention | +| Setup-only control | ordinary request completed; only project wiring/runtime files plus `greeting.txt` existed | +| Idea | prepare → stage → separate exact approval → greenfield initialization passed | +| Complete `plan.md` | prepare → stage → fresh-process approval passed; intent preserved and no follow-up question | +| Existing code | observed adoption passed and preserved the source/test fixture | +| Ordinary post-init development | feature creation → implementation → independent tests/review → strict gate → `done` passed | + +Every final run had no `spec.yaml` before approval, created it only after the exact phrase, removed the staged cache after apply, and passed `clad sync`. + +## Defect found and fixed + +Codex headless resume reloads without project MCP, while a fresh process loses the host-model draft. The old short-lived `/tmp` cache retained only the preparation request, so a new model turn could reinterpret the approval code as project intent. The campaign added `clad_stage_init`: the reviewed draft is now validated and retained under ignored project runtime state, and the approval tool requires the complete `APPLY CLADDING XXXXXX` reply. A fresh-process replay then applied only the staged `plan.md` draft. + +## Post-init development + +The original archive-feature session was manually aborted 0.8 seconds after it +started its final verification command. The preserved event log therefore shows +an external cancellation, not a hung Codex process. Its shell-expanded +`dist/tests/**/*.test.js` script happened to collect six tests on the original +macOS shell; the real defect was portability—quoted/literal globs fail on Node +20, and Windows shells do not expand them. The earlier “zero tests” wording was +not supported by the preserved output. + +Forensic replay exposed four independent post-init integration gaps: + +1. MCP used the project-pinned branch engine while shell `clad` resolved an + older global build with the same version string. The ignored project launcher + now serves MCP with no arguments and forwards explicit CLI arguments to that + exact engine. +2. Fresh onboarding capabilities and scenarios intentionally had no feature + links, but strict mode promoted their warnings and made the first `done` + unreachable. Empty links are informational before the shared eight-feature + maturity boundary; dangling links still block. +3. TypeScript gate detection substituted ESLint, Vitest, and Vitest coverage for + an explicit Node built-in test workflow. Project scripts are now authoritative; + undeclared lint/coverage gates skip honestly, and inferred npx tools run + offline so a missing optional tool cannot stall or become a false finding. +4. The first domain slice had no runnable entry point yet, but the advisory + deliverable warning was promoted by strict mode. That unresolved decision is + informational before the same maturity boundary and becomes a warning once + the project grows. + +The final fresh Codex CLI run (`019f6457-c9c6-7f51-880f-0a9d6f799ba7`) ended +naturally with exit 0. It first demonstrated that `node --test dist/tests` fails, +then replaced it with the shell-portable explicit target +`dist/tests/noteArchive.test.js`. Six tests passed under both the host Node and +Node 20.20.2. The project-local strict pre-push gate passed, independent review +passed, the attestation refreshed, and “Note archival” transitioned from +`in_progress` to `done`. Lint, coverage, formal oracle, and deliverable smoke +remained visible skips because the project had not configured those workflows. diff --git a/docs/dogfood/cursor-agent-2026-07-14.md b/docs/dogfood/cursor-agent-2026-07-14.md new file mode 100644 index 00000000..acdb17db --- /dev/null +++ b/docs/dogfood/cursor-agent-2026-07-14.md @@ -0,0 +1,21 @@ +# Cursor Agent onboarding campaign — 2026-07-14 + +- Host: Cursor Agent `2026.07.09-a3815c0` +- Interface: headless CLI (`cursor-agent --print --resume`) +- Transport: global stdio MCP through `~/.cursor/mcp.json` +- Exposed tools: 21 +- Result: verified + +## Live cases + +| Case | Preview before writes | Separate exact approval | Result | +|---|---:|---:|---| +| Idea only | pass | pass | initialized; two unresolved product choices returned to the user without inventing answers | +| Planning document | pass | pass | initialized from `plan.md` with no unnecessary follow-up | +| Existing project | pass | pass | observed ESM, two-space indentation, JSDoc, immutability, and the Node test runner before adoption | +| Uninitialized control | n/a | n/a | ordinary file request created only the requested file; no Cladding artifacts or intervention | + +The campaign ran with Cursor's force and MCP auto-approval flags inside isolated temporary +workspaces. Even with host-side tool permission granted, Cladding made no project changes before +the exact approval phrase was supplied in a resumed conversation. The control workspace contained +only `greeting.txt` afterward. diff --git a/docs/dogfood/cursor-agent-2026-07-15.md b/docs/dogfood/cursor-agent-2026-07-15.md new file mode 100644 index 00000000..6bbe22b9 --- /dev/null +++ b/docs/dogfood/cursor-agent-2026-07-15.md @@ -0,0 +1,36 @@ +# Cursor Agent project-scoped onboarding campaign — 2026-07-15 + +- Host: Cursor Agent `2026.07.09-a3815c0` +- Interface: headless `cursor-agent --print --trust --approve-mcps --force` +- Transport: `.cursor/mcp.json` → project `.cladding/host/serve.cjs` +- Result: verified + +| Case | Result | +|---|---| +| No setup control | only the requested `greeting.txt` was created | +| Setup-only control | ordinary request completed without initialization or Cladding commentary | +| Idea | staged draft applied after a separate exact phrase; three material product questions returned | +| Complete `plan.md` | initialized with the document intent and no follow-up questions | +| Existing code | existing-adoption initialized while preserving source and tests | + +All three initialization cases passed `clad sync`, left no staged cache after apply, and wrote no authored onboarding artifact before approval. + +## Post-initialization ordinary development + +- Isolation: a fresh HOME contained no user-global Cladding skills; Cursor authentication was passed to the process through its memory-only credential store. The project-local MCP launcher and generated `AGENTS.md` were the only Cladding guidance. +- Live task: the host added the **Note reminders** feature, kept the capability, journey, project context, and feature shard aligned, and exited normally (session `e23c4638-ec07-40c6-a325-913bc5162fbd`). +- Independent contexts: Cursor created one blind test-author transcript and one read-only reviewer transcript. The reviewer approved all six acceptance behaviors and the design linkage. +- Test collection: `npm test` used the explicit paths `dist/tests/noteArchive.test.js` and `dist/tests/noteReminders.test.js`; 13/13 tests passed. The same two paths passed 13/13 under an independently selected Node 20 runtime. +- Completion: the feature completion command marked **Note reminders** done. The host left its changes uncommitted, so an immediate project-wide strict check reported only the expected dirty-tree finding; after an evidence-only commit (`a735825`), all configured stages passed and the tree was clean. +- Diff hygiene: `git diff --check` passed, and the final package script contained no shell-expanded glob. + +## Project permission follow-up + +The setup path now writes `.cursor/cli.json` with exact allow entries for only +`clad_list_features`, `clad_get_feature`, and `clad_run_check`. Cursor's own +configuration parser accepted the file, `cursor-agent mcp list` reported +`cladding: ready`, and `cursor-agent mcp list-tools cladding` returned all 22 +tools. The three exact entries let the doctor remain in read-only ask mode; +write-capable Cladding tools are not allowlisted. A model-backed replay of that +permission correction remains pending because the account usage limit was +reached first. diff --git a/docs/dogfood/e2e-0.9.0-packed-2026-07-16.md b/docs/dogfood/e2e-0.9.0-packed-2026-07-16.md new file mode 100644 index 00000000..409ddc85 --- /dev/null +++ b/docs/dogfood/e2e-0.9.0-packed-2026-07-16.md @@ -0,0 +1,74 @@ +# 0.9.0 packed-tarball E2E campaign — 2026-07-16 + +- Engine under test: `cladding-0.9.0.tgz` packed from this branch, installed into an isolated npm + prefix (`clad --version` = 0.9.0; `dist/clad.js` sha256-identical to the repo build). The stale + global 0.8.3 at `/opt/homebrew` was never invoked. +- Scope: the project-local onboarding rewrite — deterministic CLI cells, per-host MCP source + isolation, live natural-language consent flows, and the legacy 0.8.3 → 0.9.0 real-home migration. +- Isolation: every `clad` cell ran under a sandbox `HOME` with LLM API keys unset; host CLIs ran + with their real authentication against throwaway projects, wrapped in before/after snapshots of + the six global config surfaces cladding may touch. + +## Deterministic cells (sandbox HOME, packed engine) — all passed + +| Cell | Result | +|---|---| +| Bare / Korean-intent / planning-doc / `--scan` init | scaffold correct; deterministic-stub warning loud; Korean preserved; authored files byte-unchanged with `.cladding/scan/*.proposal` divert | +| MCP consent protocol | exactly 3 bootstrap tools pre-init; paraphrase and well-formed-but-wrong challenge both rejected without writes; exact phrase applies and registers the full tool surface | +| Cross-process staging | prepare / stage / apply in three separate processes; bare-challenge apply resolved the staged draft from the durable cache | +| Tampered staged cache | never silently applied; workspace intact (initially surfaced as a raw TypeError — fixed, now `draft_required`, regression-tested) | +| Legacy migration (fixture home) | ownership-proven symlinks/entries removed; foreign entries semantically preserved; second run byte-identical; the account-wide `claude plugin uninstall` argv captured via a PATH shim | +| Global-config blast radius | exotic TOML (datetime / inline table / dotted keys) semantically preserved; unparseable file left byte-identical; comment destruction found → fixed via text-splice with parse-verification, regression-tested | +| Post-init dev flow | `clad_create_feature` (hash id) → `done` refused for real causes (missing test proof, no type checker, convention, architecture) → after fixes strict gate GREEN → `done` | +| Refresh boundary | `already_initialized` without the refresh flag; refresh apply left a hand-edited `spec.yaml` sha256-identical, content diverted to proposals | + +## Per-host verdicts (source-isolated) + +| Host | Wire read | Live consent flow | +|---|---|---| +| Claude Code 2.1.211 | project `.mcp.json` (held at per-project approval gate) | PASS — stop at preview, paraphrase refused, exact phrase applied; clarify loop; model-driven feature creation | +| Codex CLI 0.144.4 | project `.codex/config.toml` (trusted repo only; absent when untrusted) | PASS — full consent script plus a fresh-process apply from the durable cache | +| Antigravity 1.1.2 | **machine-wide only** — negative control proved the project `.agents/mcp_config.json` is never read | PASS via the machine-wide wire (engine build identical); consent + clarify loop | +| Gemini CLI 0.42.0 | project `.gemini/settings.json` after folder trust (Connected; tools registered) | not-run — `IneligibleTierError`, individual tier discontinued by Google | +| Cursor Agent 2026.07.09 | project `.cursor/mcp.json` (`ready`, 22 tools; vanishes when the file is renamed) | not-run — account usage limit | + +The consent boundary — the one property no unit test can enforce, because the approval token is an +integrity hash the model could forge — held on every host that ran: with all permission bypasses +enabled, no model applied on the initial request or on a "yes go ahead" paraphrase. + +## Defects found → fixed on this branch (each with a regression test) + +1. `clad setup` wired all five hosts regardless of what is installed, diverging from its own spec + (AC-001) whose twelve `test_refs` had all gone dangling in the 0.9.0 rewrite. Default now wires + detected hosts only; `--host all` stays explicit; the shard was rewritten to the project-scoped + contract with live test references. +2. Antigravity's project wire was a dead file (above). Setup now also writes the + `~/.gemini/config/plugins/cladding/` wire agy actually loads, ownership-guarded and reported as + the one deliberate exception to project-local activation. +3. `clad update` in a non-project directory scaffolded 13 host-wiring files and could reach the + account-wide `claude plugin uninstall`. It now writes nothing outside a cladding project. +4. Abandoned `clad_prepare_init` flows leaked 0600 consent-cache envelopes into the shared temp dir + (644 had accumulated on the reference machine). Staging now sweeps expired envelopes. +5. A tampered durable-cache draft reached `renderDraft` unvalidated (crash-shaped rejection). + Drafts are now schema-revalidated on load. +6. Codex legacy cleanup re-serialized the whole `~/.codex/config.toml`, destroying user comments; + Cursor cleanup left an orphan empty `mcpServers`. Both fixed (text splice with parse + verification; emptied-object removal). + +## Behavioral observations (host-side, not cladding defects) + +- Codex `exec` auto-denies the onboarding tools under the shipped `default_tools_approval_mode = + "writes"` because cladding annotates them honestly as non-read-only; interactive Codex shows a + normal approval prompt. Documented in `docs/setup.md`. +- With no MCP available and permission bypass on, the Antigravity model fabricated a plausible + feature id via shell workarounds — a live demonstration that behavioral transcripts are + inadmissible as wiring evidence without a source-isolating negative control. +- On Claude, one user reply was relayed verbatim into two distinct clarify questions (the first of + which it did not answer); the review-divert design contained the effect to proposals. + +## Real-home migration (consented) + +Executed with the packed engine from a scratch directory: legacy user-scope Claude plugin +uninstalled, 25 `~/.agents/skills/cladding-*` symlinks and the Gemini extension removed, the +`~/.codex/config.toml` entry excised (real-file diff was whitespace-only), the agy-imported plugin +directory correctly preserved and reported. Post-run residue scan showed only host-attributed churn. diff --git a/docs/dogfood/gemini-cli-2026-07-16.md b/docs/dogfood/gemini-cli-2026-07-16.md new file mode 100644 index 00000000..4971ec19 --- /dev/null +++ b/docs/dogfood/gemini-cli-2026-07-16.md @@ -0,0 +1,29 @@ +# Gemini CLI project-local setup verification — 2026-07-16 + +- Host: Gemini CLI `0.42.0` +- Isolation: temporary HOME with no user-global Cladding extension or skill +- Transport: project `.gemini/settings.json` → project `.cladding/host/serve.cjs` +- Skill: project `.agents/skills/cladding-init/SKILL.md` +- Result: project-local discovery and MCP connectivity verified; model surfaces not-run + +`clad setup --host gemini` was run from a temporary Git project. It created the +Gemini settings file and shared project skill under that project, while the +isolated HOME remained free of Cladding configuration. Gemini reported +`cladding-init` enabled from `.agents/skills` and reported the `cladding` stdio +server connected through `.cladding/host/serve.cjs`. + +The headless probe command uses Gemini Plan Mode plus the ignored project policy +`.cladding/host/gemini-doctor-policy.toml`. That policy matches the `cladding` +server, the three doctor tools, and their `readOnlyHint`; it does not enable +YOLO mode. Gemini accepted the policy arguments before reaching its account +precondition. + +The model-backed probes could not run under the available Google login. Gemini +returned `IneligibleTierError` with `UNSUPPORTED_CLIENT` and directed the account +to Antigravity before any Cladding tool call occurred. No API-key environment +variable was available. Those surfaces are therefore recorded as `not-run`, not +as a pass and not as a project-wiring failure. + +This supersedes the old global-extension setup recipe for current installation +guidance. The earlier report remains only as historical evidence; current setup +is project-scoped. diff --git a/docs/dogfood/matrix.md b/docs/dogfood/matrix.md index dbc1bda0..7d92f647 100644 --- a/docs/dogfood/matrix.md +++ b/docs/dogfood/matrix.md @@ -1,28 +1,28 @@ # Host support matrix - + -- Cladding version: `0.7.1` -- Generated: 2026-07-03T02:42:22.205Z +- Cladding version: `0.9.0` +- Generated: 2026-07-16T07:48:44.436Z | Host | list-features | get-feature | run-check | wiring | Grade | |---|---|---|---|---|---| | claude | pass | pass | pass | — | verified | | gemini | fail | fail | fail | — | fail | -| codex | not-run | not-run | not-run | — | not-run | -| cursor | — | — | — | — | not-run | +| antigravity | pass | pass | pass | — | verified | +| codex | pass | pass | pass | — | verified | +| cursor | fail | fail | fail | pass | fail | **Legend** - `verified` — every probed surface passed its sentinel end-to-end. -- `wiring-only` (Cursor) — no headless verification surface exists, so the host is graded only on whether the MCP wire is written **and** `clad serve` answers a tools list over stdio (`wiring-ok` / `wiring-fail`). +- `wiring` — Cursor additionally verifies that its configured `clad serve` answers a tools list over stdio. - `not-run` — absence of evidence (binary absent from PATH, no live-run consent, or host not wired here). Never rendered as a pass — the matrix records absence honestly. **Why not-run / fail** - `gemini`: list-features, get-feature, run-check failed — e:///opt/homebrew/Cellar/gemini-cli/0.42.0/libexec/lib/node_modules/@google/gemini-cli/bundle/chunk-7VVHSNDQ.js:273233:5) at process.processTicksAndRejections (node:internal/process/task_queues:104:5) -- `codex`: binary not on PATH -- `cursor`: Cursor not detected (~/.cursor absent) — run `clad setup` to wire +- `cursor`: list-features, get-feature, run-check failed — exit 1: ActionRequiredError: You've hit your usage limit Get Cursor Pro for more Agent usage, unlimited Tab, and more. -> Live grades land when a human runs `clad doctor --hosts` with consent (`CLAD_HOST_SMOKE=1` or `--yes`). Without consent this baseline records only what is checkable for free — Cursor wiring — and leaves the LLM-driven surfaces `not-run`. +> Live grades land when a human runs `clad doctor --hosts` with consent (`CLAD_HOST_SMOKE=1` or `--yes`). Without consent this baseline records only what is checkable for free — Cursor wiring — and leaves all LLM-driven surfaces `not-run`. diff --git a/docs/feature-cycle.md b/docs/feature-cycle.md index caefe03c..b33cdc5b 100644 --- a/docs/feature-cycle.md +++ b/docs/feature-cycle.md @@ -22,6 +22,11 @@ say-so alone, never skip a `▣`. `test_refs`) + the `modules` you're about to build + any scenario it needs — in one `clad_create_feature` call (the tool takes ACs/modules). Not the whole backlog; just the feature you're about to build. + Classify its design impact in the same call: `none` for a genuinely internal change, + `additive` to bind it to a capability and optional existing scenario, or `structural` when + architecture/project context must change. Additive links land with the shard. Structural impact + stays `review_required`; show the Tier-B diff and call `clad_resolve_design_impact` only after the + listed artifacts actually changed with user approval. - ▣ **Barrier:** `clad sync` — the shard itself must be valid (schema, EARS shape, consistent inventory) before any code. **Spec-first is the hard rule:** you author the shard *before* the code, and no code that no feature claims may land (`UNMAPPED_ARTIFACT` blocks that at step 3's @@ -61,7 +66,8 @@ say-so alone, never skip a `▣`. the feature to done with **`clad done `** — it re-runs the pre-push strict gate with the feature evaluated as done and writes `status: done` **only if that gate is GREEN**, reverting otherwise. Do not hand-write `status: done`: the verb is what keeps "done" from claiming more than - the gate verifies. `clad sync` keeps the inventory honest. Sign-off identity ≠ any implementer + the gate verifies. An unresolved structural design impact is refused before the gate runs. + `clad sync` keeps the inventory honest. Sign-off identity ≠ any implementer (independent agent, or a human at L4 / UAT). **Then start the next feature's cycle.** ## Parallelism = N concurrent instances of this same cycle diff --git a/docs/glossary.md b/docs/glossary.md index bf15d3f7..91bff1a7 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -56,7 +56,7 @@ | `work` | removed (0.6.0) | Was a permanently not-implemented reserved stub (always exit 2) — dishonest surface; `run` owns the slot. | (제거됨) | | `serve` | stable | Start the MCP server over stdio. | MCP 서버 | | `oracle` | stable | Print the impl-blind authoring brief for a feature/AC. | 오라클 브리프 | -| `setup` | stable | Wire cladding into installed AI hosts (Claude/Codex/Gemini/Cursor). | 호스트 연결 | +| `setup` | stable | Wire cladding into detected AI hosts (Claude/Codex/Gemini/Antigravity/Cursor). | 호스트 연결 | | `update` | stable | Post-upgrade reconciliation (re-wire, sync, report-only drift). | 업그레이드 정리 | | `doctor` | stable | Diagnose dispatcher/telemetry health from the events log (brew/npm `doctor` convention). | 환경 진단 | | `checkpoint` | stable | Record a feature checkpoint event (git HEAD + spec digest). | 체크포인트 기록 | @@ -86,11 +86,18 @@ | Tool | Meaning | |---|---| +| `clad_prepare_init` | Read the project and return a bounded briefing plus one-time token; never writes files. | +| `clad_stage_init` | Validate the host-model onboarding draft and cache it only as ignored project runtime state for a later approval turn. | +| `clad_init` | Validate and apply the host model's structured onboarding draft. | +| `clad_prepare_clarify` | Read current onboarding state and prepare a real user answer for host-model refinement. | +| `clad_clarify` | Validate and apply the host model's structured refinement draft. | +| `clad_resolve_onboarding_review` | Apply only the onboarding proposal targets the user explicitly reviewed and approved. | | `clad_list_features` | Query features by status/slug. | | `clad_get_feature` | Fetch one feature + ACs by id or slug. | | `clad_run_check` | Run drift detection in-process (terse by default). | | `clad_get_events` | Tail the lifecycle event log. | -| `clad_create_feature` | Author a feature shard with hash id + ACs. | +| `clad_create_feature` | Author a feature shard with hash id + ACs + a durable design-impact decision. | +| `clad_resolve_design_impact` | Mark structural design impact resolved after every listed Tier-B artifact actually changed. | | `clad_create_scenario` | Author a scenario shard with hash id. | | `clad_link_capability` | Upsert a capability ↔ feature binding (Tier B). | | `clad_author_oracle` | Record a host-authored impl-blind oracle + provenance. | @@ -147,7 +154,7 @@ four distinct Korean words too, so the conflation cannot survive translation: `stage_started` · `stage_completed` · `feature_activated` · `feature_completed` · `evidence_recorded` · `drift_detected` · `feature_checkpoint` · `feature_rolled_back` · `sentinel_miss` -Added 0.6.0 (F-b84c38 — payloads carry `identity` + `head`): `feature_created` (spec shard authored) · `scenario_created` · `done_attempted` (gated flip, kept or reverted) · `gate_run` (tier verification outcome; deduped per identical HEAD/tier/strict/worst) · `stop_blocked` (F-1d23a6 — the Stop host hook blocked a session end on a fresh failure fingerprint; identical fingerprints demote without an event). +Added 0.6.0 (F-b84c38 — payloads carry `identity` + `head`): `feature_created` (spec shard authored) · `scenario_created` · `done_attempted` (gated flip, kept or reverted) · `gate_run` (tier verification outcome; deduped per identical HEAD/tier/strict/worst) · `stop_blocked` (F-1d23a6 — the Stop host hook blocked a session end on a fresh failure fingerprint; identical fingerprints demote without an event). `design_impact_resolved` records that a structural feature's reviewed Tier-B changes were applied. Added 0.8.0 (F-6ba22c5c — value-delivery telemetry, so a silent surface is distinguishable from an unwired one): `impact_card_fired` (a PostToolUse impact card produced output — payload file/feature/impacted/tests/unledgered) · `impact_card_skipped` (the card was skipped — `reason` ∈ a closed enum, one per degrade branch; the two high-frequency reasons are aggregated to one event per debounce window) · `session_card_rendered` (a non-empty SessionStart card — payload bytes) · `prompt_suggestion_served` (a non-empty UserPromptSubmit suggestion — payload kind) · `working_set_served` (an MCP read serve of `clad_get_working_set` / `clad_get_context` / `clad_get_impact` — payload tool/query/resolved). Summarized by `clad measure --sessions` as DELIVERY (did the surfaces fire), never adoption. diff --git a/docs/setup.md b/docs/setup.md index b391201f..994aa4be 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -2,41 +2,106 @@ # Setup details — host wiring, MCP, and upgrading -The README covers the two commands you need (`clad setup` → `/cladding:init`). This page is +The README covers the setup command and the natural-language request that follows it. This page is the detail behind them: where each host is wired, how the MCP server works, and how to upgrade. -## Where `clad setup` connects (4 hosts · 5 wire points) +## Project activation boundary -| Host (when detected) | Wired location | Auto-activation | -|---|---|---| -| Claude Code (`~/.claude/`) | `~/.claude/plugins/cladding` | `claude plugin marketplace add` + `install` | -| Codex CLI skills (`~/.agents/`) | `~/.agents/skills/cladding-*` | (auto on Codex restart) | -| Codex CLI MCP server (`~/.codex/`) | `[mcp_servers.cladding]` in `~/.codex/config.toml` | (TOML entry itself) | -| Gemini CLI (`~/.gemini/`) | `~/.gemini/extensions/cladding` | `gemini extensions link` | -| Cursor (`~/.cursor/`) | `mcpServers.cladding` in `~/.cursor/mcp.json` | (JSON entry itself) | +`npm install -g cladding` installs only the CLI. Run `clad setup` **inside each project that should use Cladding**. Nothing is installed into a host's global skill or MCP catalog. + +| Host | Project-scoped location | +|---|---| +| Claude Code | `.claude/skills/cladding-init` + `.mcp.json` | +| Codex CLI | `.agents/skills/cladding-init` + `.codex/config.toml` | +| Gemini CLI | `.agents/skills/cladding-init` + `.gemini/settings.json` | +| Antigravity (`agy`) | `.agents/skills/cladding-init` + `.agents/mcp_config.json` (forward-compat) + machine-wide `~/.gemini/config/plugins/cladding/` — see the Antigravity note below | +| Cursor | `.cursor/skills/cladding-init` + `.cursor/mcp.json` + `.cursor/cli.json` read-only tool allowlist + bootstrap rule | + +The only machine-specific path lives in `.cladding/host/serve.cjs`, which is ignored project runtime state. Re-run setup on each developer machine. Host config files use the portable relative launcher path and preserve unrelated entries. With no arguments the launcher starts MCP; with arguments it forwards a normal CLI command to that exact same engine. Generated project guidance therefore uses `node .cladding/host/serve.cjs check --strict` and similar shell calls when the launcher exists, preventing a different global installation from silently validating the project with another build. + +With no `--host` option, setup wires only the hosts whose home markers exist on the machine and +reports the rest as `not selected`; `clad setup --host all` forces every channel, `--host ` +exactly one. + +Codex loads `.codex/config.toml` only for a trusted Git repository. Accept Codex's normal project-trust prompt when opening the repository; this is a Codex security boundary and `clad setup` does not bypass or pre-approve it. One consequence for scripted use: the project config asks Codex to approve write-capable tools, and Cladding annotates its onboarding tools honestly as non-read-only, so non-interactive `codex exec` auto-denies the onboarding prepare/stage/apply calls. Interactive Codex simply shows its approval prompt; headless automation must pass Codex's own approvals-bypass flag. + +**Antigravity is the one deliberate exception to project-local activation.** `agy` 1.1.2 reads MCP +config only from machine-wide locations (`~/.gemini/config/mcp_config.json` or +`~/.gemini/config/plugins//`) — it does not load a project `.agents/mcp_config.json` +(verified live in the 0.9.0 campaign, including a negative control). Setup therefore also writes +`~/.gemini/config/plugins/cladding/{plugin.json,mcp_config.json}` with an engine-absolute launch; +agy spawns MCP servers with each session's working directory, so the single machine-wide wire stays +project-aware. The project file is kept for forward compatibility, and the setup report calls the +exception out. A foreign directory already at that path is preserved unless `--force` is given. -`clad setup` invokes each host's activation command automatically when the `claude` / `gemini` -binaries are on PATH. It is safe to re-run after an upgrade or after installing a new AI tool. +Gemini likewise loads project skills and settings only after its normal folder-trust boundary is satisfied. Interactive use keeps that prompt intact; the explicitly consented doctor smoke uses Gemini's session-only trust override so a fresh verification fixture can exercise the project-local MCP connection without changing persistent trust settings. +That smoke stays in Gemini Plan Mode and loads an ignored project policy permitting only the three +annotated read-only doctor tools; it does not enable YOLO mode. -**Verification level (honesty note).** Claude Code is fully verified through real-usage -campaigns (including real-time intervention). Codex · Gemini CLI wire automatically; their behavior isn't verified yet. Cursor wires automatically, but real-usage verification is still pending — -to be updated as it lands. (The machine-readable claim lives in the README's `clad:host-claims` -fence, which `HOST_CLAIM_DRIFT` polices against `docs/dogfood/matrix.md`.) +Cursor's project CLI configuration allowlists only the three read-only doctor tools. It does not +add a server-wide wildcard, and it preserves unrelated project allow/deny entries; write-capable +Cladding tools retain Cursor's normal approval boundary. + +On upgrade, setup removes legacy global Cladding wires only when their ownership is provable. Ambiguous or hand-edited files are preserved and reported. If an old Claude user plugin remains, run `claude plugin uninstall claude-code@cladding --scope user --keep-data`. + +**Verification level (honesty note, 0.9.0 packed-tarball campaign).** Claude Code `2.1.211` is +live-verified end-to-end from a packed 0.9.0 install: project `.mcp.json` discovery behind the +per-project approval gate, the full natural-language consent flow (stop at preview, paraphrase +rejected, exact phrase applies), the clarify loop, and model-driven feature creation. Codex CLI +`0.144.4` is live-verified for the same consent flow in a trusted repository, including a +fresh-process apply that resolved the staged draft from the durable cache. Antigravity `1.1.2` is +live-verified for the consent flow and clarify loop, but only through the machine-wide wire — a +negative control proved it never reads the project MCP file, which is why setup writes the +machine-wide wire described above. Gemini's project-local MCP connection and tool registration are +structurally verified after folder trust; its model surfaces remain `not-run` because the available +individual-tier login is rejected by Gemini CLI (`IneligibleTierError`). Cursor Agent +`2026.07.09-a3815c0` passed structural verification (server ready, 22 tools enumerated, negative +control) but its model replay is `not-run` for this campaign (account usage limit). (The +machine-readable claim lives in the README's `clad:host-claims` fence, which `HOST_CLAIM_DRIFT` +polices against `docs/dogfood/matrix.md`; its `verified` grade covers the doctor surfaces listed in +that matrix, not every release-specific onboarding campaign.) ## About the MCP server -All 4 hosts wire cladding as an MCP server — only the wire *location* differs. MCP is not -something you invoke directly: there is no `/mcp` slash and no manual connect step. The AI in -each host calls cladding's tools on its own in response to *natural-language requests*; you only -type `/cladding:init` once and then chat normally. +All 5 hosts wire cladding as an MCP server — only the wire *location* differs. MCP is not +something you invoke directly and there is no manual connect step. A host may provide an `/mcp` +diagnostic view, but normal use starts by asking the AI to apply Cladding to the open project. + +Every host follows the same portable onboarding protocol under the surface: Cladding first returns +a read-only, bounded project briefing; the host's own model drafts structured onboarding data; then +Cladding validates and stages that draft before showing the approval phrase. Staging writes only an +opaque, short-lived cache under the ignored `.cladding/host/` runtime boundary. A later host process +can therefore apply the exact reviewed draft without reconstructing it from the approval code. +Follow-up answers use the same prepare/apply safety boundary. This requires only standard MCP tool +calls—not server-side sampling—and prevents incomplete, stale, or replayed drafts from partially +changing the project. + +Initialization never writes immediately from the first natural-language request. The host previews +the planned file operations and shows a one-time approval phrase; only a separate user reply that +exactly repeats that phrase authorizes the write step. Questions, paraphrases, merely opening a +project, asking about Cladding, or running `clad setup` are not consent. +Exact matching prevents accidental application, but standard MCP does not prove which user produced +a tool argument. Treat the host as part of the trust boundary; this confirmation is not a sandbox +against a malicious or compromised host. + +| Host | Primary request | Optional explicit invocation | +|---|---|---| +| Claude Code | `Apply Cladding to this project` | `/cladding:init` | +| Codex | `Apply Cladding to this project` | Type `$cladding`, then choose `init (cladding)` | +| Gemini CLI | `Apply Cladding to this project` | Select the project-local `cladding-init` skill | +| Antigravity | `Apply Cladding to this project` | Select the project-local `cladding-init` skill | +| Cursor IDE / Agent | `Apply Cladding to this project` | Natural language routes through the connected onboarding tool | ## Upgrading ```bash npm update -g cladding # 1. install the new version -cd # 2. once per project -clad update # 3. bring it in line with the new version +cd # 2. select one Cladding project +clad update # 3. refresh project wiring + derived state ``` -Your code · `spec.yaml` · docs are left untouched, so it is safe. If the newer version is -stricter and has something to flag, it just **points it out** — it won't block or fix anything. +Your authored code, feature/spec content, and documentation are preserved. The command may refresh +derived inventory/index data and the Cladding-managed blocks in `AGENTS.md` and `CLAUDE.md`. +Onboarding itself does not create or change `CLAUDE.md`; the update command retains its established +Claude-specific refresh for existing users while preserving their prose. If the +newer version is stricter, it only **points out** drift — it does not rewrite authored project intent. diff --git a/docs/ssot-model.md b/docs/ssot-model.md index d1fe251e..8d064616 100644 --- a/docs/ssot-model.md +++ b/docs/ssot-model.md @@ -35,7 +35,7 @@ A Tier B artifact must answer: **who reads this and what decision do they make?* Orphan artifacts get demoted (move to Tier D as historical reference) or removed. This cycle resolves the v0.3.45 orphans: - `spec/capabilities.yaml` gains the `CAPABILITIES_FEATURE_MAPPING` detector - `docs/project-context.md` becomes the scenario generator's source (clear, named role) -- `spec/scenarios/*.yaml` gains a clear producer (onboarding / `clad_create_scenario`) and consumer (the reference detectors + the host AI). *(NOTE v0.4.x: an earlier draft claimed `clad_create_feature` binds scenarios; it does not — `createFeature` in `src/spec/new.ts` takes no scenario argument. Scenarios are authored independently via `clad_create_scenario`.)* +- `spec/scenarios/*.yaml` gains a clear producer (onboarding / `clad_create_scenario`) and consumer (the reference detectors + the host AI). The public `clad_create_feature` transaction may bind an existing scenario when its design impact is additive; the lower-level `createFeature` helper stays single-purpose. ## Artifact registry @@ -45,7 +45,7 @@ Orphan artifacts get demoted (move to Tier D as historical reference) or removed |---|---|---|---| | `spec.yaml` | `clad_create_feature` / hand-edit | `spec/load.ts` → every detector + MCP server + CLI verbs | manual edit; `clad sync` validates | | `spec/features/-.yaml` | `clad_create_feature` | merged into `Spec.features[]` on load | manual edit + validation | -| `spec/scenarios/-.yaml` | `clad init ` onboarding (NEW v0.3.45) OR `clad_create_scenario` OR hand-edit | `REFERENCE_INTEGRITY` / `SLUG_CONFLICT` / `ID_COLLISION` / `SCENARIO_COVERAGE` detectors | onboarding 7th sentinel emits; refine refreshes; `clad_create_scenario` adds. *(`clad_create_feature` does NOT bind scenarios — corrected v0.4.x.)* | +| `spec/scenarios/-.yaml` | `clad init ` onboarding (NEW v0.3.45) OR `clad_create_scenario` OR hand-edit | `REFERENCE_INTEGRITY` / `SLUG_CONFLICT` / `ID_COLLISION` / `SCENARIO_COVERAGE` detectors | onboarding 7th sentinel emits; clarify refreshes; `clad_create_scenario` adds. *(`clad_create_feature` does NOT bind scenarios — corrected v0.4.x.)* | ### Tier B — Design SSoT @@ -53,7 +53,7 @@ Orphan artifacts get demoted (move to Tier D as historical reference) or removed |---|---|---|---| | `spec/architecture.yaml` | `clad init --scan` (observed) OR `clad init ` (LLM) OR `clad clarify` OR hand-edit | `ARCHITECTURE_FROM_SPEC` detector + `reviewer` (Layered Integrity guardrail) + `developer` (layer boundary check when placing modules) | re-scan diverts to `.cladding/scan/*.proposal` | | `spec/capabilities.yaml` | `clad init ` (LLM) OR `clad clarify` OR hand-edit | **schema-validated + merged into `Spec.capabilities` on load (v0.4.x, J2)** + `CAPABILITIES_FEATURE_MAPPING` (reference validity) + `HOLLOW_GOVERNANCE` (empty-tier guard, v0.4.x) | re-scan diverts to proposal | -| `docs/project-context.md` | `clad init` (template/LLM-refined) OR `clad clarify` OR hand-edit | AI personas (orchestrator/developer) as Why/What/Purpose context input + **scenario generator (NEW v0.3.45) uses prose for user-journey extraction** + human onboarding readers | LLM-refined on init/refine; hand-edits preserved between | +| `docs/project-context.md` | `clad init` (template/LLM-refined) OR `clad clarify` OR hand-edit | AI personas (orchestrator/developer) as Why/What/Purpose context input + **scenario generator (NEW v0.3.45) uses prose for user-journey extraction** + human onboarding readers | LLM-refined on init/clarify; hand-edits preserved between | ### Tier C — Derived / Observable @@ -84,11 +84,10 @@ single-responsibility (and keeps a tool's name honest as it grows). | **refine** | holistic DOCUMENT (one per project, not enumerated) | LLM/manual rewrite | `clad clarify` (formerly `refine`) → `architecture.yaml`, `project-context.md`, `conventions.md` | A capability is **accumulative** (created once, then features land on it over time), -so its verb is `link`, not `create` — re-"creating" an existing capability would -collide. `clad_create_feature` therefore does NOT grow capabilities as a side effect -(that would make its name lie); instead its result carries a non-mutating `hint` to -call `clad_link_capability`. This is the deterministic development-time firing path -for the Tier-B design SSoT, complementing the onboarding-time `clad clarify` path. +so its underlying verb remains `link`, not `create`. The public `clad_create_feature` +transaction requires a design-impact decision: `additive` composes that link (and an +optional scenario link) with feature creation; `structural` records the affected Tier-B +artifacts as `review_required` until their approved contents actually change. ## Capturing WHY — the decision micro-format (Tier A content) @@ -188,13 +187,14 @@ Detector-enforced (today + this cycle): - `ARCHITECTURE_FROM_SPEC`: imports don't cross `forbidden_imports` boundaries - `REFERENCE_INTEGRITY`: scenario `features[]`, feature `depends_on[]`, `superseded_by` resolve (existence) - `HARNESS_INTEGRITY`: plugin manifest version sync, detector count -- **`CAPABILITIES_FEATURE_MAPPING` (NEW v0.3.45)**: capability `features[]` resolve to real features +- **`CAPABILITIES_FEATURE_MAPPING` (NEW v0.3.45)**: capability `features[]` resolve to real features; + unbound capabilities remain warnings unless the project carries Cladding's onboarding-seeded marker; marked seeds are informational below eight features and graduate to warnings once the project is grown - **`INVENTORY_DRIFT` (v0.4.x)**: the `inventory:` counts match the on-disk shard reality - **`PLANNED_BACKLOG` (v0.4.x)**: too many `planned`/`in_progress` features with no code on disk (the spec racing ahead of the code) - **`HOLLOW_GOVERNANCE` (v0.4.x, J1)**: a grown project with a present-but-empty `capabilities`/`architecture` design tier - **`DEPENDENCY_CYCLE` (v0.4.x, J3)**: `features[].depends_on` is acyclic (pairs with `REFERENCE_INTEGRITY`'s existence check) - **`AI_HINTS_FORBIDDEN_PATTERN` (v0.3.57)**: code avoids `ai_hints.forbidden_patterns` -- **`SCENARIO_COVERAGE` (v0.4.x, S-b)**: a grown project declares ≥1 scenario, no scenario binds an empty `features[]`, and no scenario under-states its coverage (its `flow` names a feature slug it doesn't bind) +- **`SCENARIO_COVERAGE` (v0.4.x, S-b)**: a grown project declares ≥1 scenario, no grown-project scenario binds an empty `features[]`, and no scenario under-states its coverage (its `flow` names a feature slug it doesn't bind); only explicitly marked onboarding journeys stay informational below eight features, while unmarked projects keep the established warning - **`PROJECT_CONTEXT_DRIFT` (v0.4.x, S-c)**: a grown project's `project-context.md` is not still the unrefined init template Detector-enforced (deferred to future cycles): @@ -213,8 +213,8 @@ Conflict resolution (when same information lives in multiple tiers): | `clad init` (bare, greenfield) | spec.yaml seed, .cladding/, .gitignore, project-context template, scenarios README, conventions/architecture/capabilities greenfield seeds | new files only — existing files skip via idempotency | | `clad init ` (onboarding) | + project-context.md (LLM-refined), capabilities.yaml (LLM-inferred), architecture.yaml (LLM-inferred), spec.yaml F-001 title, **scenarios stubs (NEW v0.3.45)**, onboarding state.yaml | existing files divert to `.cladding/scan/*.proposal` | | `clad init --scan` (existing-project) | conventions.md (observed), architecture.yaml (observed), capabilities.yaml (README headings), project-context.md (LLM-refined) | existing files divert to proposal | -| `clad clarify ` | project-context.md, capabilities.yaml, architecture.yaml, scenarios stubs (refined Q-A history) | existing files divert to proposal | -| `clad_create_feature` MCP tool | spec/features/-.yaml + binds to existing scenario via `features[]` | rejects on collision | +| `clad clarify ` | project-context.md, capabilities.yaml, architecture.yaml, scenarios stubs (refined Q-A history) | untouched generated design updates in place; user-edited design diverts to proposal and remains `needs_review` until explicitly accepted | +| `clad_create_feature` MCP tool | spec/features/-.yaml + durable design-impact decision; additive capability/scenario links | structural impact remains review-required and blocks `clad done` | | append-only (Tier D) | events.log, audit.log entries | no divert — strict append | ## Quick decision flowchart for adding a new artifact diff --git a/docs/ssot-testing.md b/docs/ssot-testing.md index 6e45e442..dad9879f 100644 --- a/docs/ssot-testing.md +++ b/docs/ssot-testing.md @@ -16,7 +16,7 @@ Empty tmpdir + user intent "결제 SaaS for B2B": | Stage | What happens | What we assert | |---|---|---| | **S1** | `clad init ` with LLM-mocked onboarding response | All 4 tiers present, every artifact's first line is the standard Tier banner, F-001 title is intent-derived, 2 scenarios shards land | -| **S2** | `clad clarify 법인 사업자만` | First pending question marked answered, existing artifacts diverted to `.cladding/scan/*.proposal`, capabilities grow by 1 | +| **S2** | `clad clarify 법인 사업자만` | First pending question marked answered; untouched generated design updates in place, while user-edited design stays preserved with review proposals | | **S3** | Test writes 3+ TS files matching the architecture's suggested layers | (no command — simulates real-world development) | | **S4** | Cross-tier consistency check (`assertCrossTierClean`) | `CAPABILITIES_FEATURE_MAPPING` + `ARCHITECTURE_FROM_SPEC` + `REFERENCE_INTEGRITY` emit zero errors | | **S5** | `clad init --scan` re-runs after code was written | `docs/conventions.md` + `spec/architecture.yaml` diverted to proposal; live files preserve onboarding seed | @@ -118,7 +118,7 @@ PR #131's claim is that the 4-tier model improves development output quality. Th 2. **Cross-document drift errors → 0** — every detector emits clean at end-of-lifecycle. `CAPABILITIES_FEATURE_MAPPING` confirms the capability ↔ feature link in Case 2 S5. -3. **Refresh policy preserved** — re-running `clad init --scan` (Greenfield S5) and `clad clarify` (S2) diverts to `.cladding/scan/*.proposal` instead of overwriting user edits. `assertProposalDivert` codifies this. +3. **Refresh policy preserved** — re-running `clad init --scan` (Greenfield S5) diverts to `.cladding/scan/*.proposal`. During active onboarding, `clad clarify` updates byte-identical generated design directly; if a user edited it, the answer remains `needs_review` and proposal-diverts until explicitly accepted. If these three signals stay green across the full lifecycle, the SSoT model is delivering the promised quality improvement. If any regress, the failing test names the gap. diff --git a/eslint.config.js b/eslint.config.js index a2e61cd8..7850bc9c 100644 --- a/eslint.config.js +++ b/eslint.config.js @@ -8,7 +8,9 @@ import tseslint from 'typescript-eslint'; export default tseslint.config( { - ignores: ['node_modules/**', 'dist/**', 'plugins/**/dist/**', 'src/graph/viewer/**'], + // .cladding/ is machine-local runtime state (e.g. the generated host + // launcher serve.cjs) — never authored source, so never linted. + ignores: ['node_modules/**', 'dist/**', 'plugins/**/dist/**', 'src/graph/viewer/**', '.cladding/**'], }, ...tseslint.configs.recommended, { diff --git a/package-lock.json b/package-lock.json index d2e2dffd..425017f9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "cladding", - "version": "0.8.3", + "version": "0.9.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "cladding", - "version": "0.8.3", + "version": "0.9.0", "license": "MIT", "dependencies": { "@anthropic-ai/sdk": "^0.96.0", diff --git a/package.json b/package.json index da9960da..d63f320f 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "cladding", - "version": "0.8.3", - "description": "Spec-driven verification layer for AI coding agents — Claude Code · Codex · Gemini · Cursor. Intent in before it writes, result verified against your spec after. Reference implementation of the Ironclad standard.", + "version": "0.9.0", + "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", "author": "qwerfunch", @@ -18,7 +18,7 @@ "spec-driven-development", "governance", "ironclad", "drift-detection", "multi-agent", "loop-engineering", "verification", "ai-coding", "compliance", "architecture-enforcement", - "claude-code", "codex-cli", "gemini-cli", "cursor", + "claude-code", "codex-cli", "gemini-cli", "antigravity-cli", "cursor", "mcp-server", "claude-code-plugin" ], "bin": { @@ -60,10 +60,11 @@ "test": "vitest run", "typecheck": "tsc --noEmit", "lint": "eslint .", - "build": "node scripts/build.mjs && node scripts/build-plugin.mjs", + "build": "node scripts/test-count.mjs --check && node scripts/build.mjs && node scripts/build-plugin.mjs", "build:plugin": "node scripts/build-plugin.mjs", "watch": "node --watch-path=./src scripts/build.mjs", "version-bump": "node scripts/version-bump.mjs", + "test-count": "node scripts/test-count.mjs", "prepare": "node -e \"require('node:fs').existsSync('dist/clad.js') || require('node:child_process').execSync('npm run build', {stdio: 'inherit'})\"", "prepublishOnly": "npm run build" }, diff --git a/plugins/antigravity/mcp_config.json b/plugins/antigravity/mcp_config.json new file mode 100644 index 00000000..ba7f7845 --- /dev/null +++ b/plugins/antigravity/mcp_config.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "cladding": { + "command": "clad", + "args": ["serve"] + } + } +} diff --git a/plugins/antigravity/plugin.json b/plugins/antigravity/plugin.json new file mode 100644 index 00000000..7d67e331 --- /dev/null +++ b/plugins/antigravity/plugin.json @@ -0,0 +1,5 @@ +{ + "$schema": "https://antigravity.google/schemas/v1/plugin.json", + "name": "cladding", + "description": "Spec-driven verification and onboarding for Antigravity CLI." +} diff --git a/plugins/antigravity/skills/blind-author/SKILL.md b/plugins/antigravity/skills/blind-author/SKILL.md new file mode 100644 index 00000000..8b0eacab --- /dev/null +++ b/plugins/antigravity/skills/blind-author/SKILL.md @@ -0,0 +1,40 @@ +--- +name: blind-author +description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +tools: Write, Bash +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.) + +## Contract + +1. **Input** — the brief from `clad oracle --ac `: the AC's + EARS text, the module paths' *declared signatures* (never bodies), and the + target path under `tests/oracle/`. If the brief is missing or names files + for you to open, STOP and say so — opening files is outside your charter. +2. **Output** — exactly one test file, written with Write to the target path + the brief names (`tests/oracle/..test.ts`). Import the + module under test by its declared path; exercise the BEHAVIOR the AC + states, including the failure direction for `unwanted` ACs. +3. **Verify** — run only your own file: `npx --no-install vitest run `. + A failing oracle on a done feature is a FINDING, not your bug — report the + failure verbatim; do not weaken the test to make it pass. +4. **No Edit** — to revise, Write the whole file again. + +## What you never do + +- Open, list, or search any file (you can't — by design). +- 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` +with `blind: true` and your manifest = the brief you were given. That record +is auditable; your restricted toolset is what makes it true. diff --git a/plugins/antigravity/skills/changelog/SKILL.md b/plugins/antigravity/skills/changelog/SKILL.md new file mode 100644 index 00000000..a518a6b0 --- /dev/null +++ b/plugins/antigravity/skills/changelog/SKILL.md @@ -0,0 +1,38 @@ +--- +description: Render release notes / a changelog from the cladding spec. Use when the user asks for release notes, a changelog, 릴리즈 노트, 변경 이력, or "what changed (since )" — run `clad changelog --json` for the deterministic shipped-changes manifest, then write the human-facing notes FROM it, sourcing every claim from a feature title or acceptance sentence. For audit asks, print the --audit table verbatim. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding changelog — release notes from the spec + +The spec is the SSoT, so "what shipped?" is *collected*, never recalled. `clad changelog` turns +`..HEAD` into a deterministic manifest: feature shards classified (`added-as-done` / +`flipped-to-done` / `modified-while-done` / `archived`), grouped by capability (plus an +`uncategorized` bucket — itself a drift signal), the spec inventory diff, and conventional +`feat:`/`fix:` commits that name no feature id (work that shipped *outside* the spec — report it +honestly, don't hide it). + +## Protocol + +1. **Collect.** Run `clad changelog --json --since ` (omit `--since` to use the latest tag; + if the repo has no tags the command says so — ask the user for a ref). +2. **Render EN + KO release notes from the manifest, in the CHANGELOG.md house style:** + - Open with a `**In one line:**` abstract (what a user gains, one breath). + - Group by the manifest's capability groups; use **user-impact verbs** ("the gate now runs + your entry point"), not implementation verbs ("refactored stage runner"). + - **No `F-…`/`AC-…` ids in prose** (Soft Shell policy) — ids belong to the audit surface only. + - **Source every claim from the manifest** — a feature `title` or an `acceptance[]` sentence. + Never invent a change, never embellish beyond what an AC states. If the manifest is empty, + say "no shipped changes since " — that line is the honest deliverable. + - Put `unsharded_commits` under an "Also changed" section, marked as not yet spec-tracked. +3. **Audit asks** ("show verification", "어디까지 검증됐어?") → print + `clad changelog --audit --since ` **verbatim** — that table keeps ids and marks every + verification ref resolved ✓ / unresolved ✗ (a ✗ is spec-annotation drift worth reporting). +4. **Catalog asks** ("what does this project do, in full?") → `clad changelog --catalog` prints + the whole capability → feature → acceptance listing of the living spec. + +``` +clad changelog # markdown since the latest tag (deterministic fallback) +clad changelog --json --since v0.5.2 # the manifest you render notes from +clad changelog --audit --since v0.5.2 +clad changelog --catalog +``` diff --git a/plugins/antigravity/skills/check/SKILL.md b/plugins/antigravity/skills/check/SKILL.md new file mode 100644 index 00000000..fe7bb3ea --- /dev/null +++ b/plugins/antigravity/skills/check/SKILL.md @@ -0,0 +1,32 @@ +--- +description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding check + +Run `clad check` from the project root. Runs the 15 Iron Law stages — Type / Lint / Drift / Commit / Arch / Secret / Unit / Coverage / Spec-conformance / Deliverable-smoke / Smoke / Performance / Visual / Audit / UAT — and aggregates the worst exit code. + +- `0` — every stage cleared or skipped clean. +- `1` — at least one stage actually failed (fix-required). +- `2` — every result is skip (no fail-required input on the project yet). + +`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` — `npm run build:plugin` Phase D recounts them and writes the integer into each plugin manifest (e.g. `plugins/claude-code/.claude-plugin/plugin.json`), so the number is never hand-maintained. + +`--internal` shows stage codes (`stage_1.1`) instead of business names (`Type`). Default is the business-name surface; the audit log keeps internal ids regardless. + +``` +clad check +clad check --strict +clad check --internal +``` + +## Gate economy (tiers) + +Pick the cheapest tier that answers your question — the full pre-push suite is expensive and grows with +the project: + +- `clad check --tier=pre-commit` — drift / arch / secret only (spec-vs-code, no full unit suite). Use for + fast inner-loop feedback while implementing. +- `clad check --tier=pre-push --strict` — the full gate (type / lint / unit / cov + drift). This is what + `clad done ` already runs, so do NOT run it separately right before `clad done` — one + authoritative full gate per feature, not two. See `docs/feature-cycle.md` § Gate economy. diff --git a/plugins/antigravity/skills/checkpoint/SKILL.md b/plugins/antigravity/skills/checkpoint/SKILL.md new file mode 100644 index 00000000..fd5cec9c --- /dev/null +++ b/plugins/antigravity/skills/checkpoint/SKILL.md @@ -0,0 +1,31 @@ +--- +description: Record a feature checkpoint event pinning the current git HEAD plus a spec digest, so a later rollback can restore the exact pre-change state. Use before a non-trivial feature implementation, before a refactor that touches many files, or whenever the user wants a known-good safety net the autonomous drive loop can fall back to. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding checkpoint + +Run `clad checkpoint ` from the project root. Iron Law backbone Phase 1 (iron-law.md §2.5) — the verb only **stamps** the audit-log entry; it never mutates the working tree or invokes `git commit`. The maintainer keeps the option to freeze the state with a normal git commit on top. + +The checkpoint event payload carries: + +- `featureId` — the spec id, accepts both `F-NNN` legacy and `F-` (v0.3.9+) shapes. +- `gitHead` — full 40-char commit sha at the time of the call (or `null` when the project is not a git repository). +- `specDigest` — sha-256 over the merged spec for replay verification. +- `timestamp` — ISO 8601. + +``` +clad checkpoint F-001 +clad checkpoint F-a3f9c2 +``` + +The output is a single Pulse line: `✓ checkpoint · head= digest=`. The event lands in `.cladding/events.log.jsonl` as `type: "feature_checkpoint"` and can be inspected with `clad doctor --json` or `clad_get_events` over MCP. + +## When to use + +- Before invoking `clad run` on a single feature so the loop's `RETRY_THRESHOLD` halt has a target to roll back to. +- Before a manual refactor large enough that `git stash` is unwieldy. +- Right after `clad sync` reports the spec is valid, so the checkpoint pins exactly the validated spec digest the implementation will start from. + +## Pair with + +`clad rollback ` — prints the maintainer-runnable `git checkout ` for the latest checkpoint and stamps a `feature_rolled_back` event. The pair forms the v0.3.X Iron Law backbone for safe autonomous progress; see `skills/rollback/SKILL.md`. diff --git a/plugins/antigravity/skills/clarify/SKILL.md b/plugins/antigravity/skills/clarify/SKILL.md new file mode 100644 index 00000000..30f51495 --- /dev/null +++ b/plugins/antigravity/skills/clarify/SKILL.md @@ -0,0 +1,18 @@ +--- +description: Advance Cladding onboarding after the user answers a pending product question. Use the MCP prepare/apply flow, preserve the answer verbatim, and never invent answers. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding clarify + +Use this workflow only for an answer contained in a new user message after Cladding displayed the pending question. Never infer, synthesize, or reuse an answer from an initialization turn. If no new user answer exists, stop without calling either clarify tool. + +Use this workflow only after Cladding initialization returned a pending question and the user has answered it. + +1. Call `clad_prepare_clarify` with the user's answer verbatim. +2. Read the returned prompt, current state, and artifacts. Draft the structured refinement required by `clad_clarify` using the current host model. +3. Call `clad_clarify` with the same answer, the one-time token, and the draft. +4. Ask `nextQuestion` verbatim when one remains. +5. If the result is `needs_review`, show the proposal diffs for every `pendingReview` target and wait for explicit user approval. Only then call `clad_resolve_onboarding_review` with the approved targets. Never describe onboarding as complete while review remains. +6. Report completion only when the returned status is `done`. + +Do not run `clad clarify` in a shell from an AI host. Do not use MCP sampling. Never answer a product question on the user's behalf. A stale, malformed, replayed, or answer-mismatched apply request is a no-op and must be prepared again. diff --git a/plugins/antigravity/skills/developer/SKILL.md b/plugins/antigravity/skills/developer/SKILL.md new file mode 100644 index 00000000..7393b7cf --- /dev/null +++ b/plugins/antigravity/skills/developer/SKILL.md @@ -0,0 +1,85 @@ +--- +name: developer +description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. 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 +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/`. + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. + +## Sources (what you read, by Tier) + +| Tier | Artifacts | Why you read it | +|---|---|---| +| **B** | `docs/project-context.md` | intent / Why/What/Purpose to align implementation | +| **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 | + +You do NOT read Tier D (audit — observability's concern). + +## Boundary + +| what you do | what you don't | +|---|---| +| Write code · tests · migrations | Modify `spec.yaml` (that's `planner`) | +| Run `npm test` · `npm run stage:*` | Sign off on your own code (that's `reviewer`) | +| Refactor for clarity | Bypass the Iron Law gates | +| Add new stage runners | Invent new evidence shapes (the schema is fixed) | + +## Code policy + +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. +- **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: + +- Error as Data — return `{pass, exitCode, stderr?}` shapes, not throws (except boundaries) + +## 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. + +## Project policy — `spec.yaml::project.ai_hints` + +Before writing code, grep `spec.yaml::project.ai_hints`: + +- Honor `preferred_patterns` `{when, prefer, over?}` triples — domain practices the project chose +- Avoid `forbidden_patterns` substrings — detector `AI_HINTS_FORBIDDEN_PATTERN` (#27) will block `clad check --strict` +- Default to `preferred_persona`, `test_framework`, `primary_branch` when applicable + +`ai_hints` is the project-scoped SSoT for AI behavior policy. When `ai_hints` conflicts with this persona prompt for a specific project, `ai_hints` wins. + +## Hand-off triggers + +- Spec change needed → file for `planner`. +- Style / philosophy concern → file for `reviewer`. +- Production metric anomaly → file for `observability`. + +## Graph-context tools (advisory) + +Before a non-trivial edit, pull the working set instead of reading the whole spec or grepping blind: + +- **`clad_get_working_set `** — ONE call returns the focus feature + its acceptance criteria + the actual **source code** of its modules + what it depends on (needs) + **what breaks if you change it** + the tests to run + the conventions, token-budgeted. Your default orientation for a feature. +- **`clad_get_impact `** — scope a refactor's blast radius: transitive dependents + the regression set to re-run. + +Advisory (no detector enforces it) — but after your edits the hook auto-surfaces the impact (the PostToolUse card), so the blast radius is never invisible. + +## 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. diff --git a/plugins/antigravity/skills/doctor/SKILL.md b/plugins/antigravity/skills/doctor/SKILL.md new file mode 100644 index 00000000..10214faa --- /dev/null +++ b/plugins/antigravity/skills/doctor/SKILL.md @@ -0,0 +1,40 @@ +--- +description: Summarise .cladding/events.log.jsonl — sentinel-miss frequency by phase × cause × fallback plus the top missed sentinels. Use when the user asks whether their LLM dispatcher (MCP sampling host, Anthropic SDK, …) is healthy, when scan / drive results look thinner than expected, or as a one-shot triage before tuning model / max_tokens / temperature. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding doctor + +Run `clad doctor` from the project root. The verb is observability — it never mutates the working tree. + +- `--cwd ` — read events from a project directory other than the current one (default cwd). +- `--json` — emit the raw `DoctorReport` shape instead of the formatted text surface; the shape (`{cwd, events, sentinelMiss}`) is the stable wire format for MCP clients and follow-up tooling. + +The text surface prints: + +1. One pulse line with total events and total sentinel-miss count (`pass` when zero misses, `note` otherwise). +2. An event-type breakdown line (one `=` token per non-zero `EventType`). +3. When sentinel-miss events exist: + - `by phase` / `by cause` / `by fallback` aggregates from the v0.3.39 telemetry payload. + - Top-5 missed sentinels (`CONVENTIONS_MD` / `ARCHITECTURE_YAML` / `SCENARIO_FLOWS` / `CAPABILITIES_YAML` / `WHY` / `WHAT` / `PURPOSE`) sorted by count desc, name asc. + - Last 3 unique dispatcher error strings (most recent first; errors are truncated to 200 chars at the emit site). + - A one-line tuning hint. + +## Exit codes + +- `0` — events.log was either missing (greenfield) or readable. A greenfield workspace prints a friendly note and exits 0; a healthy host with zero misses also exits 0 with a `pass` line. +- `1` — `events.log.jsonl` exists but cannot be parsed as JSONL (corrupt telemetry). + +## When to run + +- After `clad init --scan` to confirm the scan refinement ran with full LLM coverage (no `sentinel_miss` events). +- After `clad run` to confirm the autonomous loop received refined replies from the configured host. +- Periodically in CI to track miss rate across sampling-policy changes. +- Before reporting "the LLM seems off" to a host (Claude Code / Cursor / Continue) — the breakdown tells you whether the issue is dispatcher transport (`cause: dispatcher_error`) or model output quality (`cause: blank_section`). + +``` +clad doctor +clad doctor --cwd /path/to/project +clad doctor --json +``` + +Configured-no-LLM runs (no MCP host, no `ANTHROPIC_API_KEY`, or `--no-llm` flag on `clad init`) do not emit `sentinel_miss` — those are deliberate offline runs, not misses. A doctor pass with zero events on a workspace that never reached the LLM path is therefore expected, not a problem. diff --git a/plugins/antigravity/skills/init/SKILL.md b/plugins/antigravity/skills/init/SKILL.md new file mode 100644 index 00000000..1de064d0 --- /dev/null +++ b/plugins/antigravity/skills/init/SKILL.md @@ -0,0 +1,28 @@ +--- +name: init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. +--- + +# Cladding init + +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. + +## Required host workflow + +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. + +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. + +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. + +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. + +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/plugins/antigravity/skills/observability/SKILL.md b/plugins/antigravity/skills/observability/SKILL.md new file mode 100644 index 00000000..5beb1a28 --- /dev/null +++ b/plugins/antigravity/skills/observability/SKILL.md @@ -0,0 +1,50 @@ +--- +name: observability +description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +tools: Read, Bash +capabilities: [read, exec] +--- + +# Observability + +You are the **Observability** agent. You operate 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. + +## Sources (Tier D only) + +| artifact | tier | content | +|---|---|---| +| `.cladding/events.log.jsonl` | D | every lifecycle transition (stage_started / stage_completed, feature_activated / feature_completed, feature_checkpoint / feature_rolled_back, drift_detected, evidence_recorded, **sentinel_miss**) | +| `.cladding/audit.log.jsonl` | D | every evidence entry (identity, kind, stage) | +| `perf/baseline.json` / `perf/current.json` | D | performance budget snapshots | +| `coverage/coverage-summary.json` | D | line / statement / branch coverage | +| `stage:drift` output | D | every active drift detector's findings | + +You do NOT read Tier A/B/C — those are other personas' concerns. + +## Reports you produce + +- **Sentinel-miss summary** — `clad doctor` consumes `events.log.jsonl` and groups `sentinel_miss` events by phase × cause × fallback plus the top-5 missed sentinels. Use this to tune the host's sampling policy (model · max_tokens · MCP transport health). `clad doctor --json` emits the stable `DoctorReport` shape for downstream tooling. +- **Evidence age histogram** — bucketed by stage, surfaces STALE_EVIDENCE candidates before the detector escalates them. +- **Author-mix per feature** — count of human vs llm vs tool evidence; flags anti-self-cert risk early. +- **Detector heatmap** — which detectors fire most often; informs the next refinement priority. +- **Perf-regression timeline** — current vs baseline diff per metric. + +## Project policy — `spec.yaml::project.ai_hints` + +When summarising or labelling reports, also read `spec.yaml::project.ai_hints`: + +- `preferred_persona` — when reporting author-mix, highlight cases where the de-facto author persona drifts from `preferred_persona` +- `forbidden_patterns` — `AI_HINTS_FORBIDDEN_PATTERN` (#27) shows up in the detector heatmap; track its rate as a leading indicator of AI hygiene +- `preferred_patterns` — purely informational here (no detector); use it for narrative context when the user asks why the heatmap shifts + +`ai_hints` is the project-scoped SSoT for AI behavior policy. Report what the artifacts show first, contextualise via `ai_hints` second. + +## Out of scope +- You do not modify spec or code. +- You do not invent new metrics — only aggregate from the four artifacts above. + +## 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. diff --git a/plugins/antigravity/skills/oracle/SKILL.md b/plugins/antigravity/skills/oracle/SKILL.md new file mode 100644 index 00000000..578e37ef --- /dev/null +++ b/plugins/antigravity/skills/oracle/SKILL.md @@ -0,0 +1,69 @@ +--- +description: Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`) demands — an empty worklist means don't author unless the user explicitly asks. YOU spawn a blind sub-agent from a spec-only brief, then record it. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding oracle — impl-blind conformance authoring + +A SPEC_CONFORMANCE oracle is a conformance test authored **without seeing the implementation**, so a passing +oracle means "matches the spec," not "matches the code." The A/B that motivated this: a blind oracle caught +bugs a code-peeking (sighted) oracle rubber-stamped (7/8 vs 4/8). cladding owns no LLM — the blinding is **your +discipline as the host**; cladding produces the brief, records provenance, and the gate audits it. + +## Which ACs need an oracle? (the policy) + +A project sets its requirement under `spec.yaml::project`: +- **`oracle_policy: { always_ears: [unwanted], sample: 0.2 }`** (RECOMMENDED) — risk-weighted: author an oracle + for every done AC whose EARS category is in `always_ears` (default `['unwanted']` — error/edge handling), + PLUS a deterministic ~`sample` fraction of the rest. v8 showed exhaustive per-AC oracles add ~0 quality at + ~30% cost, so spot-check the bulk and concentrate verification where failures cluster. +- **`require_oracles: true`** — EXHAUSTIVE (every done AC). Highest assurance, highest cost. `oracle_policy` + takes precedence when both are set. +- **Neither** — no mandate (an authored oracle still runs + is recorded; a missing one is not forced). + +Run **`clad oracle --required`** to print the worklist — exactly which done ACs the policy demands an oracle +for, which already have one, and why (`always:` / `sample` / `exhaustive`). Author oracles for the +`← needs an impl-blind oracle` rows only; do NOT author for ACs the policy did not select. + +## Protocol (three steps — do them in order) + +1. **Get the spec-only brief.** Run `clad oracle --ac `. It prints the acceptance criterion + + the module's declaration-only signatures — and NEVER an implementation body. This is the *only* thing the + author may see. + +2. **Spawn a FRESH, blind sub-agent** (the Task tool / a new sub-agent context) handed ONLY that brief. It MUST + NOT read `src/` or any implementation file. Instruct it to write a vitest conformance suite that asserts + **only what the criterion literally requires** — when the spec is silent on an edge, a WEAKER assertion, not + a stronger guess (an over-strict oracle falsely fails correct code). The sub-agent's identity must differ + from whoever implemented the feature. + +3. **Record it.** Call the `clad_author_oracle` MCP tool with: + - `featureId`, `acId`, `body` (the authored test source), + - `readManifest`: **exactly** what the sub-agent was shown — the brief's spec/AC + signatures. It MUST NOT + list an implementation file the feature owns (the gate fails on `manifest ∩ modules`). + - `blind: true` only if the sub-agent's context was the brief and nothing else, + - `authorName`: the sub-agent's identity (≠ the implementer). + + cladding writes `tests/oracle/..test.ts`, records `kind:'oracle'` provenance, and stamps + `oracle_refs` onto the AC. The SPEC_CONFORMANCE gate (stage_2.3 + the detector) then RUNS the oracle against + the real code and AUDITS author≠implementer + manifest∩modules=∅. + +``` +clad oracle F-1a2b3c --ac AC-004 # 1. print the blind brief +# 2. spawn a blind sub-agent with ONLY that brief → it writes the oracle +# 3. clad_author_oracle { featureId, acId, body, readManifest, blind:true, authorName } +``` + +## Honest boundaries (read these) + +- **Blindness is enforced by YOU, not cladding.** cladding cannot see or restrict a sub-agent's file reads + (sub-agent tool perms belong to the host). Hand the sub-agent ONLY the brief; do not let it open `src/`. The + gate audits the manifest you report — it catches an honestly-reported impl read, not a lie. `blind:false` + records an unattested (self-reported) manifest and the gate surfaces it as `info`. +- **First RED is ambiguous.** When a brand-new oracle fails on the current code, it is EITHER a real spec bug in + the code (keep the oracle, fix the code) OR an over-strict oracle (the spec doesn't require it — revise/reject + it). cladding cannot tell which without you. Decide deliberately; never auto-accept or auto-discard. +- **Opt-in + risk-weighted.** The presence + provenance rules bind under `project.oracle_policy` (risk-weighted, + recommended) or the legacy `project.require_oracles: true` (exhaustive). Without either, an authored oracle + still runs (stage_2.3) and its provenance is still recorded, but a missing oracle is not forced. Prefer + `oracle_policy` — exhaustive verification bought ~0 quality at ~30% cost in v8; concentrate the premium on the + high-risk (`unwanted`) ACs + a sample. diff --git a/plugins/antigravity/skills/orchestrator/SKILL.md b/plugins/antigravity/skills/orchestrator/SKILL.md new file mode 100644 index 00000000..bf8d0c1e --- /dev/null +++ b/plugins/antigravity/skills/orchestrator/SKILL.md @@ -0,0 +1,89 @@ +--- +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. +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. + +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` (shard + 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 +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: + +| 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 | + +## 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` + +`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. + +## Routing table (user intent → agent) + +| 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). + +## 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. diff --git a/plugins/antigravity/skills/planner/SKILL.md b/plugins/antigravity/skills/planner/SKILL.md new file mode 100644 index 00000000..7736e7b7 --- /dev/null +++ b/plugins/antigravity/skills/planner/SKILL.md @@ -0,0 +1,73 @@ +--- +name: planner +description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. 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 +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. + +## Sources (what you read, by Tier) + +| Tier | Artifacts | Why you read it | +|---|---|---| +| **A** | `spec.yaml`, `spec/features/-.yaml`, `spec/scenarios/-.yaml` | your write target | +| **B** | `spec/architecture.yaml`, `spec/capabilities.yaml`, `docs/project-context.md` | cross-validate when editing A; e.g., new `features[]` binding in capabilities.yaml ↔ feature you just added | + +You do NOT read Tier C (conventions — developer owns it) or Tier D (audit — observability owns it). + +## What you do + +- 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. +- 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. +- 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. + +### 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. + +## Project policy — `spec.yaml::project.ai_hints` + +When authoring a new feature or scenario, also check `spec.yaml::project.ai_hints`: + +- `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 + +`ai_hints` is the project-scoped SSoT for AI behavior policy and overrides this prompt for the specific project. + +## Graph-context tools (advisory) + +Before reshaping a feature or scoping a new one, slice the graph instead of reading the whole spec: **`clad_get_working_set `** for a feature's focus + needs + breaks + tests in one call, and **`clad_get_impact `** to see what a change would ripple into. Advisory — it keeps your spec edits anchored to the real dependency structure. + +## What you don't do +- You do not write production code or tests (`developer` does). +- You do not pass philosophical judgement (`reviewer` does). +- You do not silently drop ACs — every removal needs an `archive_reason`. + +## EARS reminder + +| pattern | trigger | +|---|---| +| ubiquitous | (no condition) | +| event | "when …" | +| state | "while …" | +| optional | "where …" | +| unwanted | "if …" | + +## Boundary + +Touching `src/stages/`, `src/hitl/`, or production code is **out of scope**. If a spec edit reveals an implementation gap, file an entry for `developer` and stop. + +## 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. diff --git a/plugins/antigravity/skills/reviewer/SKILL.md b/plugins/antigravity/skills/reviewer/SKILL.md new file mode 100644 index 00000000..837d92e0 --- /dev/null +++ b/plugins/antigravity/skills/reviewer/SKILL.md @@ -0,0 +1,81 @@ +--- +name: reviewer +description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +tools: Read, Bash +capabilities: [read, exec] +--- + +# Reviewer + +You are the **Reviewer** agent. Your job is *independent audit*. You never modify a file — read only. + +See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the 4-tier SSoT model. + +## Sources (what you read, by Tier) + +Reviewer reads broadly because audit covers all layers. Conflict resolution: when same information appears in multiple tiers, **Tier A wins over Tier B over Tier C**. + +| Tier | Artifacts | Why you read it | +|---|---|---| +| **A** | `spec.yaml`, `spec/features/*`, `spec/scenarios/*` | what was declared | +| **B** | `spec/architecture.yaml`, `spec/capabilities.yaml`, `docs/project-context.md` | layer model + user-facing surface + intent — cross-validate against A | +| **C** | `docs/conventions.md` | Consistency > Creativity guardrail | +| **D** | `.cladding/audit.log.jsonl` (evidence chain) | anti-self-cert validation | + +## Guardrails you check + +| category | rule | +|---|---| +| Structure | Layered Integrity — no reverse imports between UI / logic / data | +| Structure | Domain Isolation — pure functions, no framework leak | +| Coding | Immutability First — no mutable shared state | +| Coding | Explicit Intent — no magic numbers, no terse names | +| Coding | Documentation Why>What — comments explain decision, not behavior | +| Coding | Error as Data — `Result` or equivalent, not bare `throw` | +| Security | Zero-Trust Input — validate at boundary | +| Security | Least Privilege — minimum scope per module | +| UX | Fail-Fast — surface errors immediately, no silent swallow | +| UX | Consistency > Creativity — match project style first | + +## Output + +For every audit, emit a single JSON object: +```json +{ + "feature": "F-NNN", + "stage": "stage_X.Y", + "violations": [ + {"file": "stages/...", "line": N, "guardrail": "Layered Integrity", "message": "..."} + ], + "passes": true +} +``` + +## Lens (multi-agent fan-out) + +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. + +## 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) +- `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. + +## 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 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. + +## 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. diff --git a/plugins/antigravity/skills/rollback/SKILL.md b/plugins/antigravity/skills/rollback/SKILL.md new file mode 100644 index 00000000..80cfe7b4 --- /dev/null +++ b/plugins/antigravity/skills/rollback/SKILL.md @@ -0,0 +1,39 @@ +--- +description: Record a rollback event and print the maintainer-runnable git command for the most recent checkpoint of a feature. Use when an implementation attempt failed, an autonomous drive loop hit RETRY_THRESHOLD, or the user wants to abandon the current attempt and restore the pre-checkpoint state. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding rollback + +Run `clad rollback ` from the project root. The verb is the partner of `clad checkpoint` (iron-law.md §2.5 Iron Law backbone Phase 1) — it stamps a `feature_rolled_back` event into `.cladding/events.log.jsonl` and prints the `git checkout ` command the maintainer can run. **Cladding does not run the checkout itself** — the host's branch policy, dirty-working-tree state, or detached-HEAD concerns may demand a non-default strategy, so the decision stays with the maintainer. + +- `-r, --reason ` — optional free-text reason recorded on the event payload. Useful for post-mortems and the Librarian's archival flow. + +``` +clad rollback F-001 +clad rollback F-a3f9c2 --reason "specialist dispatched a regression on the L1 lint gate" +``` + +The output is a single Pulse line plus the restoration command: + +``` +✓ rollback · F-a3f9c2 target head= ts= +Run: git checkout +``` + +When the latest checkpoint has no `gitHead` (the project is not a git repo), the verb prints `No git head pinned — restore spec.yaml manually from VCS history.` instead. + +## Exit codes + +- `0` — rollback event stamped, restoration command printed. +- `1` — no prior checkpoint exists for the feature; nothing to roll back to. Run `clad checkpoint ` next time before mutating. +- `2` — feature id argument missing. + +## When to use + +- After an autonomous drive iteration that ended in `RETRY_THRESHOLD`, `GATE_NO_PROGRESS`, or `UNCAUGHT_ERROR`. +- After a manual implementation attempt that introduced a regression you don't want to bisect. +- Before re-running `clad run` on the same feature so the loop starts from a known-good HEAD instead of an in-progress mess. + +## Pair with + +`clad checkpoint ` — stamps the safety net rollback restores from. See `skills/checkpoint/SKILL.md`. diff --git a/plugins/antigravity/skills/route/SKILL.md b/plugins/antigravity/skills/route/SKILL.md new file mode 100644 index 00000000..ebe706b0 --- /dev/null +++ b/plugins/antigravity/skills/route/SKILL.md @@ -0,0 +1,28 @@ +--- +description: Classify a natural-language prompt to one of cladding's verbs. Use when the user describes work in their own words and you want to see which built-in verb cladding's intent classifier would pick — primarily a debugging tool for the orchestrator persona and for verifying the router's coverage after adding new verbs. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding route + +Run `clad route ` from anywhere — the verb is read-only and does not require a workspace. It calls `classifyIntent(prompt)` from `src/router/intent.js` and emits the resolved verb name as a Pulse note. Exit code is `0` on a confident match and `1` when the intent resolves to `unknown`. + +``` +clad route "scan my codebase and write the conventions doc" +clad route "is the LLM host healthy?" +clad route "I'm stuck, what's next?" +``` + +The verb is the smallest surface that exercises the router in isolation. Production callers typically reach the router indirectly through the orchestrator persona (`src/agents/orchestrator.md`) or through `clad_route` over MCP. + +## When to use + +- Debugging why a natural-language prompt routed (or failed to route) to the verb you expected. +- Confirming a new verb's intent patterns are reachable after adding them to `src/router/intent.js`. +- Smoke-testing the router during local development before publishing a plugin update. + +The classifier is intentionally conservative — when no rule matches strongly enough, the result is `unknown` and the verb exits `1` so callers can fall back to an explicit verb lookup instead of guessing. + +## Out of scope + +- This verb is **not** the entry point for "do the work" — for that the user picks a concrete verb (`init`, `sync`, `check`, `drive`, …) directly, or the orchestrator persona does the routing inside a Claude Code session. +- Free-form prompts that span multiple verbs (`"sync then check then drive"`) collapse to whichever single verb best matches; the router does not split intent. diff --git a/plugins/antigravity/skills/run/SKILL.md b/plugins/antigravity/skills/run/SKILL.md new file mode 100644 index 00000000..28684de2 --- /dev/null +++ b/plugins/antigravity/skills/run/SKILL.md @@ -0,0 +1,34 @@ +--- +description: Run cladding's autonomous loop — iterate ready features, dispatch the developer + reviewer personas through the active host adapter, run L1 gates, halt on HUMAN_REQUIRED or transport failure. Use only when the user explicitly asks for autonomous progress; the loop will modify files. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding run (formerly `drive`) + +Run `clad run` from the project root. The autonomous loop: + +1. Pre-flight `adapter.healthCheck()` — fails fast on missing credentials or unreachable host. +2. For each ready feature (status `planned`, `depends_on` satisfied): + - Specialist dispatch authors the implementation. + - Apply mutations to the working tree. + - L1 gates: Type / Lint / Arch. + - Reviewer dispatch — `HUMAN_REQUIRED` halt if reviewer identity equals specialist (anti-self-cert barrier). + - UAT requires a human-pass evidence entry; missing → `HUMAN_REQUIRED` halt. +3. Halt class is one of the 13 enumerated reasons (`ALL_FEATURES_DONE`, `MAX_ITERATIONS`, `WALL_CLOCK`, `BUDGET_EXCEEDED`, `BLOCKED_FEATURE`, `RETRY_THRESHOLD`, `GATE_NO_PROGRESS`, `HUMAN_REQUIRED`, `TRANSPORT_AUTH_FAILED`, `TRANSPORT_RATE_LIMITED`, `TRANSPORT_NETWORK`, `LLM_UNAVAILABLE`, `UNCAUGHT_ERROR`). + +Budget flags: `--max-iterations`, `--max-wall-clock-ms`, `--max-retries`. `--cwd ` targets a project directory other than the current one. `--json` emits the raw Iron Core result; default is the plain Soft Shell summary. + +``` +clad run +clad run --cwd /path/to/project +clad run --max-iterations 10 +clad run --json +``` + +**Heads-up — `run` needs a real LLM, and is for unattended/headless use only.** The host AI (Claude Code, Cursor, …) drives work *naturally in-session*; `clad run` is the entry point for the **opposite** case — autonomous, no-human-in-the-loop progress (CI/cron/SDK). Two requirements: + +- **A real dispatch must be available**: either run inside `clad serve` (MCP sampling) or use SDK mode (`agent.mode = sdk` + an API key). With **neither**, the loop falls back to the **Mock transport** and produces empty module *stubs*, not real implementations — yet still reports a normal halt. Treat a standalone `clad run` with no MCP server and no SDK key as **not doing real work**; verify with `clad doctor` afterward (a deterministic/Mock run is a red flag, not success). +- `run` modifies the working tree. + +> Known gap (tracked): standalone `run` on the Mock fallback should hard-fail with `LLM_UNAVAILABLE` rather than silently stubbing. That change reconciles the adapter `healthCheck` parity contract (F-049 AC-089, which currently treats the Mock fallback as "ready") and is a deliberate follow-up, not yet shipped. + +After a run session, run `clad doctor` over the same `--cwd` to confirm the LLM dispatcher behaved — any `sentinel_miss` events surface as a health summary so you can tell whether the loop ran with full LLM refinement or fell back to deterministic per-artifact. diff --git a/plugins/antigravity/skills/serve/SKILL.md b/plugins/antigravity/skills/serve/SKILL.md new file mode 100644 index 00000000..db8c10e1 --- /dev/null +++ b/plugins/antigravity/skills/serve/SKILL.md @@ -0,0 +1,20 @@ +--- +description: Boot cladding as an MCP server over stdio. Use only when the user wants to expose cladding's tools, resources, and persona prompts to a separate MCP client. Most users don't run this directly — the plugin's .mcp.json launches it automatically. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding serve + +Run `clad serve` from the project root. Boots an MCP server over stdio that exposes: + +- **Tools**: the full development surface (feature/graph/context queries, checks, gate, changelog) plus the natural-language onboarding flow — `clad_prepare_init` / `clad_stage_init` / `clad_init` and the clarify pair. Before `spec.yaml` exists only the three onboarding bootstrap tools are exposed. +- **Resources**: `cladding://spec`, `cladding://events`, `cladding://audit`. +- **Prompts**: 5 personas (orchestrator, planner, reviewer, observability, developer). +- **Live audit notifications**: `notifications/resources/updated` fires for `cladding://audit` whenever a new evidence entry lands — a subscribed client can live-tail the audit log without polling. + +Registers itself in cladding's sampling context so the host adapters (`generic-mcp`, `claude-code`) route LLM dispatch through `McpSamplingTransport` instead of the Mock fallback. + +``` +clad serve --cwd /path/to/project +``` + +**Most users don't run this directly.** Cladding's plugin manifest (`.mcp.json`) launches `clad serve` automatically when the plugin is enabled. Invoke this skill only for debugging the MCP server in isolation. diff --git a/plugins/antigravity/skills/status/SKILL.md b/plugins/antigravity/skills/status/SKILL.md new file mode 100644 index 00000000..3544f4e5 --- /dev/null +++ b/plugins/antigravity/skills/status/SKILL.md @@ -0,0 +1,18 @@ +--- +description: Render the feature × stage integrity matrix — every feature vs every Iron Law stage with pass/skip/fail markers. Use when the user wants a project-wide status board, a release-readiness view, or to spot which features are still behind which stage. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding status (formerly `panel`) + +Run `clad status` from the project root. Renders an ASCII matrix: + +- Rows: features (business titles by default; raw ids with `--internal` — legacy `F-NNN` for pre-v0.3.9 features, `F-` for v0.3.9+). +- Columns: 15 Iron Law stages. +- Cells: pass · skip · fail · not-yet-attempted. + +Use this after `clad check` to see *which features* failed *which stages* at a glance, not just the aggregate exit code. + +``` +clad status +clad status --internal +``` diff --git a/plugins/antigravity/skills/sync/SKILL.md b/plugins/antigravity/skills/sync/SKILL.md new file mode 100644 index 00000000..963f625d --- /dev/null +++ b/plugins/antigravity/skills/sync/SKILL.md @@ -0,0 +1,33 @@ +--- +description: Validate the active spec.yaml against the Ironclad schema and refresh the inventory. Rarely needed manually — clad_create_feature already auto-syncs the inventory and clad check / clad done self-validate the spec, so do NOT run it as a reflexive pre-flight before those. Use it only after you have directly hand-edited a shard file (spec/features/*.yaml or spec.yaml). Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. +--- + +# Cladding sync + +Run `clad sync` from the project root. The command: + +- Loads `spec.yaml` (or its sharded form under `spec/features/*.yaml`). +- Validates against `src/spec/schema.json` (JSONSchema). +- Reports the feature count and any validation failures. +- Exits non-zero when the spec is invalid so CI can gate on it. + +Spec must be valid before `clad check`, `clad run`, or any stage runner produces meaningful output. If `sync` fails, fix the reported issues first. + +``` +clad sync +``` + +## When you actually need it (don't reflex-sync) + +You rarely need to run this MANUALLY — and a reflexive "just-in-case" sync after every +operation is wasted work (in an A/B measurement, 28 of 30 manual `clad sync` calls found +nothing to fix). The inventory + validation are already maintained for you: + +- **`clad_create_feature` auto-syncs the inventory** after each feature it writes (and rejects a + malformed AC at creation), so you don't need to sync after creating features. +- **`clad check` / `clad done` validate the spec themselves** (drift stage), so you don't need + to pre-sync before them — a real drift surfaces in that gate anyway. + +Run `clad sync` only when you have **hand-edited a shard file directly** (`Edit`/`Write` on +`spec/features/*.yaml` or `spec.yaml`), to refresh the inventory and re-validate that edit. +Prefer `clad_create_feature` over hand-editing in the first place — then even this is unneeded. diff --git a/plugins/claude-code/.claude-plugin/plugin.json b/plugins/claude-code/.claude-plugin/plugin.json index 43bbdcdd..9afa72c4 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.8.3", + "version": "0.9.0", "description": "Reference implementation of the Ironclad standard — multi-agent dev harness for Claude Code.", "author": { "name": "qwerfunch" diff --git a/plugins/claude-code/agents/blind-author.md b/plugins/claude-code/agents/blind-author.md index dac74eea..8b0eacab 100644 --- a/plugins/claude-code/agents/blind-author.md +++ b/plugins/claude-code/agents/blind-author.md @@ -1,6 +1,6 @@ --- name: blind-author -description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. +description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Write, Bash capabilities: [write, exec] --- diff --git a/plugins/claude-code/agents/developer.md b/plugins/claude-code/agents/developer.md index 6d1c2835..7393b7cf 100644 --- a/plugins/claude-code/agents/developer.md +++ b/plugins/claude-code/agents/developer.md @@ -1,6 +1,6 @@ --- name: developer -description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. +description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. 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 capabilities: [read, write, edit, exec] --- diff --git a/plugins/claude-code/agents/observability.md b/plugins/claude-code/agents/observability.md index da1e4251..5beb1a28 100644 --- a/plugins/claude-code/agents/observability.md +++ b/plugins/claude-code/agents/observability.md @@ -1,6 +1,6 @@ --- name: observability -description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. +description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/claude-code/agents/orchestrator.md b/plugins/claude-code/agents/orchestrator.md index 49b89e79..bf8d0c1e 100644 --- a/plugins/claude-code/agents/orchestrator.md +++ b/plugins/claude-code/agents/orchestrator.md @@ -1,6 +1,6 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. +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. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- @@ -29,17 +29,7 @@ You do NOT pre-load Tier C (conventions — developer's concern). 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 + refine policy (의무)** — Two-step Q&A loop that captures intent and refines spec/docs through the user's own answers. - - **Step 6a (init).** Before calling `clad init` on a greenfield project (empty directory or `<3` source files), **ASK THE USER for their project intent in one line**. A natural question is enough: "어떤 종류의 프로젝트인가요? 한 줄로 설명해주세요". Forward the user's reply as the positional intent: `clad init ` (no quotes needed — commander treats trailing tokens as variadic). The init handler routes the LLM to produce a domain-aware project-context + capabilities + architecture + a real first-feature title (used when the AI later registers the first feature via `clad_create_feature`) + 2-3 product-level clarifying questions, and writes `.cladding/onboarding/state.yaml` with the questions marked pending. DO NOT call bare `clad init` on a greenfield workspace — the result is a generic toolchain scaffold that misses the user's actual intent. (For an existing project ≥3 source files, bare `clad init` is fine — the observed scan path captures the codebase shape directly.) - - **Step 6b (clarify loop).** After init, drive the Q&A loop until the onboarding state file is marked `status: done`: - - Read `.cladding/onboarding/state.yaml` and find the first `answer: null` entry. - - Ask the user that exact question in chat, verbatim. Do NOT rephrase technical-sounding questions into your own words — the LLM calibrated them at product-owner vocabulary level. - - When the user replies, run `clad clarify ` (no quotes needed). The handler marks the question answered, calls the LLM with the full Q-A history, refines `docs/project-context.md` + `spec/capabilities.yaml` + `spec/architecture.yaml`, and may add new follow-up questions. - - Loop until `clad clarify --json` reports `status: "done"` OR the user says they have enough. Never invent extra questions — only the LLM's questions are sanctioned for this loop. - - If the user declines to answer a question, accept that and skip it (they can revisit via `clad clarify ` later, since pending state persists). +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 diff --git a/plugins/claude-code/agents/planner.md b/plugins/claude-code/agents/planner.md index b2f7ed45..7736e7b7 100644 --- a/plugins/claude-code/agents/planner.md +++ b/plugins/claude-code/agents/planner.md @@ -1,6 +1,6 @@ --- name: planner -description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. +description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. 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 capabilities: [read, write, edit, exec] --- @@ -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. `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). Pre-v0.3.30 auto-extraction from code is deprecated. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/claude-code/agents/reviewer.md b/plugins/claude-code/agents/reviewer.md index 99246fc8..837d92e0 100644 --- a/plugins/claude-code/agents/reviewer.md +++ b/plugins/claude-code/agents/reviewer.md @@ -1,6 +1,6 @@ --- name: reviewer -description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. +description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/claude-code/commands/init.md b/plugins/claude-code/commands/init.md index 3b5bec99..1de064d0 100644 --- a/plugins/claude-code/commands/init.md +++ b/plugins/claude-code/commands/init.md @@ -1,101 +1,28 @@ --- -description: Scaffold a cladding workspace. Pass a free-text project description as positional argument to drive intent-aware onboarding — the LLM produces domain-aware spec/docs plus product-level follow-up questions. Use when the user wants to start a new Ironclad project, adopt cladding into an existing repo, or refresh artifacts via re-scan. +name: init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. --- # Cladding init -Run `clad init` from the directory where the cladding workspace should live. Idempotent — skips files that already exist unless `--force` is supplied. +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. -## Artifacts produced (by Tier) +## Required host workflow -| Tier | File | Authority | -|---|---|---| -| A | `spec.yaml` (seed) | Spec SSoT (Iron Law sealed) | -| A | `spec/scenarios/-.yaml` (v0.3.45+, intent path only) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` | Design SSoT | -| B | `spec/capabilities.yaml` | Design SSoT | -| B | `docs/project-context.md` | Design SSoT (intent + Why/What/Purpose) | -| C | `docs/conventions.md` | derived from observed code OR greenfield seed | -| D | `.cladding/onboarding/state.yaml` (intent path only) | transient — Q&A audit | +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier governance. +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. -## Intent-aware onboarding (v0.3.43+) +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. -The strongest path is to pass the user's project intent as positional argument (no `--intent` keyword, no quotes needed): +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. -``` -clad init 결제 SaaS for B2B Stripe Toss 지원 -clad init AI 코드 리뷰 봇 만들거야 -clad init 이 프로젝트 분석해서 클래딩 적용해줘 -``` - -The LLM dispatcher then produces **domain-aware** artifacts that exceed what the user explicitly stated: - -- `docs/project-context.md` — Why/What/Purpose with inferred domain context (compliance norms, scale assumptions, common patterns) -- `spec/capabilities.yaml` — user-stated + inferred capabilities (3-8 entries; payment → idempotency, webhook signing; ML → data lineage, eval harness; SaaS → multi-tenancy, audit log) -- `spec/architecture.yaml` — layers tailored to domain + language -- 2-3 follow-up clarifying questions printed to stdout as CLI hints (product/business level — not technical jargon) - -**AI orchestrators MUST ask the user for intent before invoking `clad init` on a greenfield workspace** (see `src/agents/orchestrator.md` principle 6). A bare `clad init` on a brand-new project falls back to generic toolchain seeds and misses the user's intent. For existing projects (≥3 source files) bare `clad init` is fine — the observed scan path captures shape directly. - -## Flags - -- `--name ` — override the project name (default: cwd basename). -- `--force` — overwrite an existing `spec.yaml`. -- `--scan` — force-walk the existing codebase to write observed artifacts. Default auto-detects (≥3 source files trigger scan); use `--no-scan` to skip even when source is present. Orthogonal to positional intent — can combine (`clad init 결제 SaaS --scan`). -- `--no-llm` — force the deterministic interpreter. Intent text still routes but falls back to a deterministic body quoting the intent verbatim. -- `--roots ` — comma-separated source-root override (e.g. `packages/a/src,packages/b/src`). Otherwise inferred from manifests + directory heuristics. - -When `--scan` runs (or auto-runs on a codebase with ≥3 source files) it writes: - -- `docs/conventions.md` — observed indent / quote / naming / error-handling / test-location conventions plus a representative module quote. -- `spec/architecture.yaml` — observed layers + forbidden-import candidates derived from the import graph. -- `spec/capabilities.yaml` — README `##` headings rendered as capability candidates (v0.3.38+). -- `docs/project-context.md` — forest-level Why / What / Purpose; LLM-refined when a dispatcher is available, deterministic template otherwise. -- `spec/scenarios/README.md` — explains the scenarios-are-intent policy (v0.3.30+). - -Existing files are diverted to `.cladding/scan/*.proposal` rather than overwritten. - -### Greenfield seeds (v0.3.42+) - -When `--scan` does **not** fire (brand-new project with <3 source files), `clad init` still writes the same three artifacts as **greenfield seeds** so the spec/docs surface is always complete: - -- `docs/conventions.md` — toolchain-default 14-signal table. TypeScript → 2-space + single quote + camelCase + `tests-dir` test layout, Python → 4-space + double quote + snake_case, Go → tab + PascalCase + `sibling-test`, Rust → 4-space + snake_case + result-pattern, etc. Each seed inlines a one-line link to the canonical style guide (Google TS / PEP 8 / Effective Go / Google Java / …). -- `spec/architecture.yaml` — `version: "0.1"` + empty `layers: []` + a language-specific baseline suggestion in the header comment (TypeScript → `src/cli/` / `src/core/` / `src/lib/` / `src/ui/`, Python → `src//` / `tests/`, Go → `cmd/` / `pkg/` / `internal/`, …). -- `spec/capabilities.yaml` — `schema: "0.1"` + `source: README.md` + empty `capabilities: []` + guidance comment on the per-entry shape. - -Each seed carries a header marking it as a greenfield template. After you write initial code (and optionally a README), re-run `clad init --scan`; the observed bodies divert to `.cladding/scan/.proposal` so you can diff seed vs reality and merge the parts you want. Personas downstream (`developer`, `planner`) therefore treat every scan artifact as **always present**, with the SEED header telling them which mode is live. - -After init: - -1. Edit `spec.yaml` (project metadata). Features are added on demand — ask the AI in natural language ("add a feature for login flow"), call the `clad_create_feature` MCP tool, or use the `clad` CLI. Feature shards always use the hash-based id `F-` (v0.3.9+) — filename `-.yaml`, `id: F-`, `slug: `. `clad init` does **not** write a legacy `F-001` placeholder for external users (v0.4.0+). -2. Run `clad sync` to verify the spec is valid. -3. Run `clad check` to see which Iron Law stages are wired up for the toolchain cladding detects in the cwd. -4. (Optional) Run `clad doctor` to confirm `.cladding/events.log.jsonl` shows no `sentinel_miss` events from the scan refinement. - -``` -clad init # bare (greenfield seeds + hint, or observed scan) -clad init 결제 SaaS for B2B # intent-aware onboarding (positional, no quotes needed) -clad init "AI 코드 리뷰 봇" # quotes OK too -clad init 이 프로젝트 분석해서 클래딩 적용해줘 # intent that signals existing adoption -clad init docs/plan.md # path-aware intent (v0.3.61+) — file contents auto-loaded as intent -clad init /absolute/path/spec.md # absolute path also supported (same .md/.txt/.yaml/.yml/.markdown rule) -clad init --name my-project -clad init --force -clad init --scan --no-llm -clad init --roots packages/a/src,packages/b/src -``` - -## Path-aware intent (v0.3.61+, F-5f6b45) - -When the positional argument looks like a text-file path (recognized extension `.md` / `.txt` / `.yaml` / `.yml` / `.markdown`) and the file exists under cwd, cladding loads the file body and forwards *that* to the onboarding LLM dispatcher — not the literal path string. This closes the gap where `clad init "$(cat docs/plan.md)"` (shell substitution) was the only way to feed a planning document into onboarding. - -Behavior: - -- **Existing text file** → contents become the intent. stderr prints `loaded intent from ` for transparency. -- **Missing file** with a path-like extension → stderr warning + free-text fallback (the literal argument is forwarded as intent so onboarding still runs). -- **Directory** ending in `.md` (rare) → stderr warning + free-text fallback. -- **Non-text argument** (e.g. `결제 SaaS 만들거야`) → existing free-text behavior, zero regression. - -Plugin invocations (`/cladding init docs/plan.md` from Claude Code · Codex CLI · Gemini CLI marketplace installs) inherit this behavior automatically — every plugin skill shells out to the same `clad init` CLI. +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/plugins/claude-code/dist/agents/README.md b/plugins/claude-code/dist/agents/README.md index db8e0af1..5b8c01c5 100644 --- a/plugins/claude-code/dist/agents/README.md +++ b/plugins/claude-code/dist/agents/README.md @@ -8,7 +8,7 @@ ironclad-track: T9 (multi-agent orchestrator) ## [CLAIM] -The 5 agent personas — orchestrator · planner (formerly `librarian`) · reviewer · observability · developer (formerly `specialists`) — each shipped as a Claude Code subagent (frontmatter + system prompt). Their canonical source lives in this directory; `npm run build:plugin` mirrors them into `agents/`, `plugins/codex/skills/`, and `plugins/gemini-cli/commands/`. +The 6 agent personas — orchestrator · planner (formerly `librarian`) · reviewer · observability · developer (formerly `specialists`) · blind-author — each shipped as a Claude Code subagent (frontmatter + system prompt). Their canonical source lives in this directory; `npm run build:plugin` mirrors them into `plugins/claude-code/agents/`, `plugins/codex/skills/`, and `plugins/antigravity/skills/`. ## [PERSONAS] @@ -21,6 +21,7 @@ Each persona's individual `.md` carries a "Sources (what you read, by Tier)" sec | `reviewer` | Philosophical guardrails; independent audit | Read, Bash | A + B + C + D evidence | (none — audit only) | | `observability` | Log + metrics analyst | Read, Bash | D only (events.log, audit.log, perf, coverage) | (reports only) | | `developer` | Implementer (code, tests, migrations) | Read, Write, Edit, Bash | B (project-context, architecture, capabilities) + C (conventions) + A (current feature slice) | stages/, tests/, hitl/ | +| `blind-author` | Impl-blind test/oracle author (no Read/Grep/Glob/Edit by construction) | Write, Bash | A (acceptance criteria + module signatures only — never the implementation) | tests/ (conformance oracles) | ## [INVOCATION_PRINCIPLES] @@ -56,4 +57,4 @@ Cross-boundary rules: ## [TBD] -- Routing config (`src/agents/routing.yaml`) with intent → agent mapping. `commands/clad.md` is the single user-facing verb manifest today; per-verb skills live under `skills//SKILL.md` (auto-mirrored to `commands/.md`, `plugins/codex/skills/.md`, `plugins/gemini-cli/commands/.md`). +- Routing config (`src/agents/routing.yaml`) with intent → agent mapping. Per-verb skills live under `skills//SKILL.md`, auto-mirrored to `plugins/codex/skills//` and `plugins/antigravity/skills//` (Gemini receives only the init command as `plugins/gemini-cli/commands/init.toml`). diff --git a/plugins/claude-code/dist/agents/blind-author.md b/plugins/claude-code/dist/agents/blind-author.md index dac74eea..8b0eacab 100644 --- a/plugins/claude-code/dist/agents/blind-author.md +++ b/plugins/claude-code/dist/agents/blind-author.md @@ -1,6 +1,6 @@ --- name: blind-author -description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. +description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Write, Bash capabilities: [write, exec] --- diff --git a/plugins/claude-code/dist/agents/developer.md b/plugins/claude-code/dist/agents/developer.md index 6d1c2835..7393b7cf 100644 --- a/plugins/claude-code/dist/agents/developer.md +++ b/plugins/claude-code/dist/agents/developer.md @@ -1,6 +1,6 @@ --- name: developer -description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. +description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. 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 capabilities: [read, write, edit, exec] --- diff --git a/plugins/claude-code/dist/agents/observability.md b/plugins/claude-code/dist/agents/observability.md index da1e4251..5beb1a28 100644 --- a/plugins/claude-code/dist/agents/observability.md +++ b/plugins/claude-code/dist/agents/observability.md @@ -1,6 +1,6 @@ --- name: observability -description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. +description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/claude-code/dist/agents/orchestrator.md b/plugins/claude-code/dist/agents/orchestrator.md index 49b89e79..bf8d0c1e 100644 --- a/plugins/claude-code/dist/agents/orchestrator.md +++ b/plugins/claude-code/dist/agents/orchestrator.md @@ -1,6 +1,6 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. +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. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- @@ -29,17 +29,7 @@ You do NOT pre-load Tier C (conventions — developer's concern). 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 + refine policy (의무)** — Two-step Q&A loop that captures intent and refines spec/docs through the user's own answers. - - **Step 6a (init).** Before calling `clad init` on a greenfield project (empty directory or `<3` source files), **ASK THE USER for their project intent in one line**. A natural question is enough: "어떤 종류의 프로젝트인가요? 한 줄로 설명해주세요". Forward the user's reply as the positional intent: `clad init ` (no quotes needed — commander treats trailing tokens as variadic). The init handler routes the LLM to produce a domain-aware project-context + capabilities + architecture + a real first-feature title (used when the AI later registers the first feature via `clad_create_feature`) + 2-3 product-level clarifying questions, and writes `.cladding/onboarding/state.yaml` with the questions marked pending. DO NOT call bare `clad init` on a greenfield workspace — the result is a generic toolchain scaffold that misses the user's actual intent. (For an existing project ≥3 source files, bare `clad init` is fine — the observed scan path captures the codebase shape directly.) - - **Step 6b (clarify loop).** After init, drive the Q&A loop until the onboarding state file is marked `status: done`: - - Read `.cladding/onboarding/state.yaml` and find the first `answer: null` entry. - - Ask the user that exact question in chat, verbatim. Do NOT rephrase technical-sounding questions into your own words — the LLM calibrated them at product-owner vocabulary level. - - When the user replies, run `clad clarify ` (no quotes needed). The handler marks the question answered, calls the LLM with the full Q-A history, refines `docs/project-context.md` + `spec/capabilities.yaml` + `spec/architecture.yaml`, and may add new follow-up questions. - - Loop until `clad clarify --json` reports `status: "done"` OR the user says they have enough. Never invent extra questions — only the LLM's questions are sanctioned for this loop. - - If the user declines to answer a question, accept that and skip it (they can revisit via `clad clarify ` later, since pending state persists). +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 diff --git a/plugins/claude-code/dist/agents/planner.md b/plugins/claude-code/dist/agents/planner.md index b2f7ed45..7736e7b7 100644 --- a/plugins/claude-code/dist/agents/planner.md +++ b/plugins/claude-code/dist/agents/planner.md @@ -1,6 +1,6 @@ --- name: planner -description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. +description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. 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 capabilities: [read, write, edit, exec] --- @@ -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. `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). Pre-v0.3.30 auto-extraction from code is deprecated. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/claude-code/dist/agents/reviewer.md b/plugins/claude-code/dist/agents/reviewer.md index 99246fc8..837d92e0 100644 --- a/plugins/claude-code/dist/agents/reviewer.md +++ b/plugins/claude-code/dist/agents/reviewer.md @@ -1,6 +1,6 @@ --- name: reviewer -description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. +description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/claude-code/dist/clad.js b/plugins/claude-code/dist/clad.js index a3eb6b3c..fe80975a 100755 --- a/plugins/claude-code/dist/clad.js +++ b/plugins/claude-code/dist/clad.js @@ -4,102 +4,102 @@ 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 $ue=Object.create;var HE=Object.defineProperty;var kue=Object.getOwnPropertyDescriptor;var Eue=Object.getOwnPropertyNames;var Aue=Object.getPrototypeOf,Tue=Object.prototype.hasOwnProperty;var He=(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),Ir=(t,e)=>{for(var r in e)HE(t,r,{get:e[r],enumerable:!0})},Oue=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Eue(e))!Tue.call(t,i)&&i!==r&&HE(t,i,{get:()=>e[i],enumerable:!(n=kue(e,i))||n.enumerable});return t};var Et=(t,e,r)=>(r=t!=null?$ue(Aue(t)):{},Oue(e||!t||!t.__esModule?HE(r,"default",{value:t,enumerable:!0}):r,t));var Ld=v(ZE=>{var qg=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}},GE=class extends qg{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};ZE.CommanderError=qg;ZE.InvalidArgumentError=GE});var Bg=v(WE=>{var{InvalidArgumentError:Rue}=Ld(),VE=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 Rue(`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 Iue(t){let e=t.name()+(t.variadic===!0?"...":"");return t.required?"<"+e+">":"["+e+"]"}WE.Argument=VE;WE.humanReadableArgName=Iue});var YE=v(JE=>{var{humanReadableArgName:Pue}=Bg(),KE=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=>Pue(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 pq(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),Pr=(t,e)=>{for(var r in e)$A(t,r,{get:e[r],enumerable:!0})},Nde=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Pde(e))!Dde.call(t,i)&&i!==r&&$A(t,i,{get:()=>e[i],enumerable:!(n=Ide(e,i))||n.enumerable});return t};var St=(t,e,r)=>(r=t!=null?Rde(Cde(t)):{},Nde(e||!t||!t.__esModule?$A(r,"default",{value:t,enumerable:!0}):r,t));var rf=v(EA=>{var yy=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}},kA=class extends yy{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};EA.CommanderError=yy;EA.InvalidArgumentError=kA});var _y=v(TA=>{var{InvalidArgumentError:jde}=rf(),AA=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 jde(`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 Mde(t){let e=t.name()+(t.variadic===!0?"...":"");return t.required?"<"+e+">":"["+e+"]"}TA.Argument=AA;TA.humanReadableArgName=Mde});var IA=v(RA=>{var{humanReadableArgName:Fde}=_y(),OA=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=>Fde(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 i4(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 pq(t){let e=/\x1b\[\d*(;\d*)*m/g;return t.replace(e,"")}JE.Help=KE;JE.stripColor=pq});var tA=v(eA=>{var{InvalidArgumentError:Cue}=Ld(),XE=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=Due(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 Cue(`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?mq(this.name().replace(/^no-/,"")):mq(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}},QE=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 mq(t){return t.split("-").reduce((e,r)=>e+r[0].toUpperCase()+r.slice(1))}function Due(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 i4(t){let e=/\x1b\[\d*(;\d*)*m/g;return t.replace(e,"")}RA.Help=OA;RA.stripColor=i4});var NA=v(DA=>{var{InvalidArgumentError:Lde}=rf(),PA=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=zde(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 Lde(`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?o4(this.name().replace(/^no-/,"")):o4(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}},CA=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 o4(t){return t.split("-").reduce((e,r)=>e+r[0].toUpperCase()+r.slice(1))}function zde(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}}eA.Option=XE;eA.DualOptions=QE});var gq=v(hq=>{function Nue(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 jue(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=Nue(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}}DA.Option=PA;DA.DualOptions=CA});var a4=v(s4=>{function Ude(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=Ude(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]}?)`:""}hq.suggestSimilar=jue});var vq=v(sA=>{var Mue=He("node:events").EventEmitter,rA=He("node:child_process"),no=He("node:path"),Hg=He("node:fs"),Ue=He("node:process"),{Argument:Fue,humanReadableArgName:Lue}=Bg(),{CommanderError:nA}=Ld(),{Help:zue,stripColor:Uue}=YE(),{Option:yq,DualOptions:que}=tA(),{suggestSimilar:_q}=gq(),iA=class t extends Mue{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=>Ue.stdout.write(r),writeErr:r=>Ue.stderr.write(r),outputError:(r,n)=>n(r),getOutHelpWidth:()=>Ue.stdout.isTTY?Ue.stdout.columns:void 0,getErrHelpWidth:()=>Ue.stderr.isTTY?Ue.stderr.columns:void 0,getOutHasColors:()=>oA()??(Ue.stdout.isTTY&&Ue.stdout.hasColors?.()),getErrHasColors:()=>oA()??(Ue.stderr.isTTY&&Ue.stderr.hasColors?.()),stripColor:r=>Uue(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 zue,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 Fue(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 nA(e,r,n)),Ue.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 yq(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 yq)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){Ue.versions?.electron&&(r.from="electron");let i=Ue.execArgv??[];(i.includes("-e")||i.includes("--eval")||i.includes("-p")||i.includes("--print"))&&(r.from="eval")}e===void 0&&(e=Ue.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":Ue.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(Hg.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 +(Did you mean ${n[0]}?)`:""}s4.suggestSimilar=qde});var d4=v(zA=>{var Bde=Ge("node:events").EventEmitter,jA=Ge("node:child_process"),uo=Ge("node:path"),by=Ge("node:fs"),qe=Ge("node:process"),{Argument:Hde,humanReadableArgName:Gde}=_y(),{CommanderError:MA}=rf(),{Help:Zde,stripColor:Vde}=IA(),{Option:c4,DualOptions:Wde}=NA(),{suggestSimilar:l4}=a4(),FA=class t extends Bde{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=>qe.stdout.write(r),writeErr:r=>qe.stderr.write(r),outputError:(r,n)=>n(r),getOutHelpWidth:()=>qe.stdout.isTTY?qe.stdout.columns:void 0,getErrHelpWidth:()=>qe.stderr.isTTY?qe.stderr.columns:void 0,getOutHasColors:()=>LA()??(qe.stdout.isTTY&&qe.stdout.hasColors?.()),getErrHasColors:()=>LA()??(qe.stderr.isTTY&&qe.stderr.hasColors?.()),stripColor:r=>Vde(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 Zde,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 Hde(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 MA(e,r,n)),qe.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 c4(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 c4)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){qe.versions?.electron&&(r.from="electron");let i=qe.execArgv??[];(i.includes("-e")||i.includes("--eval")||i.includes("-p")||i.includes("--print"))&&(r.from="eval")}e===void 0&&(e=qe.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":qe.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(by.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=no.resolve(u,d);if(Hg.existsSync(f))return f;if(i.includes(no.extname(d)))return;let p=i.find(m=>Hg.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=Hg.realpathSync(this._scriptPath)}catch{u=this._scriptPath}a=no.resolve(no.dirname(u),a)}if(a){let u=o(a,s);if(!u&&!e._executableFile&&this._scriptPath){let d=no.basename(this._scriptPath,no.extname(this._scriptPath));d!==this._name&&(u=o(a,`${d}-${e._name}`))}s=u||s}n=i.includes(no.extname(s));let c;Ue.platform!=="win32"?n?(r.unshift(s),r=bq(Ue.execArgv).concat(r),c=rA.spawn(Ue.argv[0],r,{stdio:"inherit"})):c=rA.spawn(s,r,{stdio:"inherit"}):(this._checkForMissingExecutable(s,a,e._name),r.unshift(s),r=bq(Ue.execArgv).concat(r),c=rA.spawn(Ue.execPath,r,{stdio:"inherit"})),c.killed||["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach(d=>{Ue.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 nA(u,"commander.executeSubCommandAsync","(close)")):Ue.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)Ue.exit(1);else{let d=new nA(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=uo.resolve(u,d);if(by.existsSync(f))return f;if(i.includes(uo.extname(d)))return;let p=i.find(m=>by.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=by.realpathSync(this._scriptPath)}catch{u=this._scriptPath}a=uo.resolve(uo.dirname(u),a)}if(a){let u=o(a,s);if(!u&&!e._executableFile&&this._scriptPath){let d=uo.basename(this._scriptPath,uo.extname(this._scriptPath));d!==this._name&&(u=o(a,`${d}-${e._name}`))}s=u||s}n=i.includes(uo.extname(s));let c;qe.platform!=="win32"?n?(r.unshift(s),r=u4(qe.execArgv).concat(r),c=jA.spawn(qe.argv[0],r,{stdio:"inherit"})):c=jA.spawn(s,r,{stdio:"inherit"}):(this._checkForMissingExecutable(s,a,e._name),r.unshift(s),r=u4(qe.execArgv).concat(r),c=jA.spawn(qe.execPath,r,{stdio:"inherit"})),c.killed||["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach(d=>{qe.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 MA(u,"commander.executeSubCommandAsync","(close)")):qe.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)qe.exit(1);else{let d=new MA(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 Ue.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()}`,Ue.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new que(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=_q(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=_q(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=>Lue(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=no.basename(e,no.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(Ue.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 qe.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()}`,qe.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new Wde(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=l4(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=l4(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=>Gde(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=uo.basename(e,uo.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(qe.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 bq(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 oA(){if(Ue.env.NO_COLOR||Ue.env.FORCE_COLOR==="0"||Ue.env.FORCE_COLOR==="false")return!1;if(Ue.env.FORCE_COLOR||Ue.env.CLICOLOR_FORCE!==void 0)return!0}sA.Command=iA;sA.useColor=oA});var $q=v(Sn=>{var{Argument:Sq}=Bg(),{Command:aA}=vq(),{CommanderError:Bue,InvalidArgumentError:wq}=Ld(),{Help:Hue}=YE(),{Option:xq}=tA();Sn.program=new aA;Sn.createCommand=t=>new aA(t);Sn.createOption=(t,e)=>new xq(t,e);Sn.createArgument=(t,e)=>new Sq(t,e);Sn.Command=aA;Sn.Option=xq;Sn.Argument=Sq;Sn.Help=Hue;Sn.CommanderError=Bue;Sn.InvalidArgumentError=wq;Sn.InvalidOptionArgumentError=wq});var Ce=v(Jt=>{"use strict";var lA=Symbol.for("yaml.alias"),Tq=Symbol.for("yaml.document"),Gg=Symbol.for("yaml.map"),Oq=Symbol.for("yaml.pair"),uA=Symbol.for("yaml.scalar"),Zg=Symbol.for("yaml.seq"),io=Symbol.for("yaml.node.type"),Jue=t=>!!t&&typeof t=="object"&&t[io]===lA,Yue=t=>!!t&&typeof t=="object"&&t[io]===Tq,Xue=t=>!!t&&typeof t=="object"&&t[io]===Gg,Que=t=>!!t&&typeof t=="object"&&t[io]===Oq,Rq=t=>!!t&&typeof t=="object"&&t[io]===uA,ede=t=>!!t&&typeof t=="object"&&t[io]===Zg;function Iq(t){if(t&&typeof t=="object")switch(t[io]){case Gg:case Zg:return!0}return!1}function tde(t){if(t&&typeof t=="object")switch(t[io]){case lA:case Gg:case uA:case Zg:return!0}return!1}var rde=t=>(Rq(t)||Iq(t))&&!!t.anchor;Jt.ALIAS=lA;Jt.DOC=Tq;Jt.MAP=Gg;Jt.NODE_TYPE=io;Jt.PAIR=Oq;Jt.SCALAR=uA;Jt.SEQ=Zg;Jt.hasAnchor=rde;Jt.isAlias=Jue;Jt.isCollection=Iq;Jt.isDocument=Yue;Jt.isMap=Xue;Jt.isNode=tde;Jt.isPair=Que;Jt.isScalar=Rq;Jt.isSeq=ede});var zd=v(dA=>{"use strict";var Mt=Ce(),Pr=Symbol("break visit"),Pq=Symbol("skip children"),vi=Symbol("remove node");function Vg(t,e){let r=Cq(e);Mt.isDocument(t)?Nc(null,t.contents,r,Object.freeze([t]))===vi&&(t.contents=null):Nc(null,t,r,Object.freeze([]))}Vg.BREAK=Pr;Vg.SKIP=Pq;Vg.REMOVE=vi;function Nc(t,e,r,n){let i=Dq(t,e,r,n);if(Mt.isNode(i)||Mt.isPair(i))return Nq(t,n,i),Nc(t,i,r,n);if(typeof i!="symbol"){if(Mt.isCollection(e)){n=Object.freeze(n.concat(e));for(let o=0;o{"use strict";var jq=Ce(),nde=zd(),ide={"!":"%21",",":"%2C","[":"%5B","]":"%5D","{":"%7B","}":"%7D"},ode=t=>t.replace(/[!,[\]{}]/g,e=>ide[e]),Ud=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+ode(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&&jq.isNode(e.contents)){let o={};nde.visit(e.contents,(s,a)=>{jq.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(` -`)}};Ud.defaultYaml={explicit:!1,version:"1.2"};Ud.defaultTags={"!!":"tag:yaml.org,2002:"};Mq.Directives=Ud});var Kg=v(qd=>{"use strict";var Fq=Ce(),sde=zd();function ade(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 Lq(t){let e=new Set;return sde.visit(t,{Value(r,n){n.anchor&&e.add(n.anchor)}}),e}function zq(t,e){for(let r=1;;++r){let n=`${t}${r}`;if(!e.has(n))return n}}function cde(t,e){let r=[],n=new Map,i=null;return{onAnchor:o=>{r.push(o),i??(i=Lq(t));let s=zq(e,i);return i.add(s),s},setAnchors:()=>{for(let o of r){let s=n.get(o);if(typeof s=="object"&&s.anchor&&(Fq.isScalar(s.node)||Fq.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}}qd.anchorIsValid=ade;qd.anchorNames=Lq;qd.createNodeAnchors=cde;qd.findNewAnchor=zq});var pA=v(Uq=>{"use strict";function Bd(t,e,r,n){if(n&&typeof n=="object")if(Array.isArray(n))for(let i=0,o=n.length;i{"use strict";var lde=Ce();function qq(t,e,r){if(Array.isArray(t))return t.map((n,i)=>qq(n,String(i),r));if(t&&typeof t.toJSON=="function"){if(!r||!lde.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}Bq.toJS=qq});var Jg=v(Gq=>{"use strict";var ude=pA(),Hq=Ce(),dde=Fo(),mA=class{constructor(e){Object.defineProperty(this,Hq.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(!Hq.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=dde.toJS(this,"",s);if(typeof i=="function")for(let{count:c,res:l}of s.anchors.values())i(l,c);return typeof o=="function"?ude.applyReviver(o,{"":a},"",a):a}};Gq.NodeBase=mA});var Hd=v(Zq=>{"use strict";var fde=Kg(),pde=zd(),Mc=Ce(),mde=Jg(),hde=Fo(),hA=class extends mde.NodeBase{constructor(e){super(Mc.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=[],pde.visit(e,{Node:(o,s)=>{(Mc.isAlias(s)||Mc.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||(hde.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=Yg(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(fde.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 Yg(t,e,r){if(Mc.isAlias(e)){let n=e.resolve(t),i=r&&n&&r.get(n);return i?i.count*i.aliasCount:0}else if(Mc.isCollection(e)){let n=0;for(let i of e.items){let o=Yg(t,i,r);o>n&&(n=o)}return n}else if(Mc.isPair(e)){let n=Yg(t,e.key,r),i=Yg(t,e.value,r);return Math.max(n,i)}return 1}Zq.Alias=hA});var It=v(gA=>{"use strict";var gde=Ce(),yde=Jg(),_de=Fo(),bde=t=>!t||typeof t!="function"&&typeof t!="object",Lo=class extends yde.NodeBase{constructor(e){super(gde.SCALAR),this.value=e}toJSON(e,r){return r?.keep?this.value:_de.toJS(this.value,e,r)}toString(){return String(this.value)}};Lo.BLOCK_FOLDED="BLOCK_FOLDED";Lo.BLOCK_LITERAL="BLOCK_LITERAL";Lo.PLAIN="PLAIN";Lo.QUOTE_DOUBLE="QUOTE_DOUBLE";Lo.QUOTE_SINGLE="QUOTE_SINGLE";gA.Scalar=Lo;gA.isScalarValue=bde});var Gd=v(Wq=>{"use strict";var vde=Hd(),ta=Ce(),Vq=It(),Sde="tag:yaml.org,2002:";function wde(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 xde(t,e,r){if(ta.isDocument(t)&&(t=t.contents),ta.isNode(t))return t;if(ta.isPair(t)){let d=r.schema[ta.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 vde.Alias(c.anchor);c={anchor:null,node:null},a.set(t,c)}e?.startsWith("!!")&&(e=Sde+e.slice(2));let l=wde(t,e,s.tags);if(!l){if(t&&typeof t.toJSON=="function"&&(t=t.toJSON()),!t||typeof t!="object"){let d=new Vq.Scalar(t);return c&&(c.node=d),d}l=t instanceof Map?s[ta.MAP]:Symbol.iterator in Object(t)?s[ta.SEQ]:s[ta.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 Vq.Scalar(t);return e?u.tag=e:l.default||(u.tag=l.tag),c&&(c.node=u),u}Wq.createNode=xde});var Qg=v(Xg=>{"use strict";var $de=Gd(),Si=Ce(),kde=Jg();function yA(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 $de.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 Kq=t=>t==null||typeof t=="object"&&!!t[Symbol.iterator]().next().done,_A=class extends kde.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=>Si.isNode(n)||Si.isPair(n)?n.clone(e):n),this.range&&(r.range=this.range.slice()),r}addIn(e,r){if(Kq(e))this.add(r);else{let[n,...i]=e,o=this.get(n,!0);if(Si.isCollection(o))o.addIn(i,r);else if(o===void 0&&this.schema)this.set(n,yA(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(Si.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&&Si.isScalar(o)?o.value:o:Si.isCollection(o)?o.getIn(i,r):void 0}hasAllNullValues(e){return this.items.every(r=>{if(!Si.isPair(r))return!1;let n=r.value;return n==null||e&&Si.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 Si.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(Si.isCollection(o))o.setIn(i,r);else if(o===void 0&&this.schema)this.set(n,yA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}};Xg.Collection=_A;Xg.collectionFromPath=yA;Xg.isEmptyPath=Kq});var Zd=v(ey=>{"use strict";var Ede=t=>t.replace(/^(?!$)(?: $)?/gm,"#");function bA(t,e){return/^\n+$/.test(t)?t.substring(1):e?t.replace(/^(?! *$)/gm,e):t}var Ade=(t,e,r)=>t.endsWith(` -`)?bA(r,e):r.includes(` +`)}),this}_outputHelpIfRequested(e){let r=this._getHelpOption();r&&e.find(i=>r.is(i))&&(this.outputHelp(),this._exit(0,"commander.helpDisplayed","(outputHelp)"))}};function u4(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 LA(){if(qe.env.NO_COLOR||qe.env.FORCE_COLOR==="0"||qe.env.FORCE_COLOR==="false")return!1;if(qe.env.FORCE_COLOR||qe.env.CLICOLOR_FORCE!==void 0)return!0}zA.Command=FA;zA.useColor=LA});var h4=v($n=>{var{Argument:f4}=_y(),{Command:UA}=d4(),{CommanderError:Kde,InvalidArgumentError:p4}=rf(),{Help:Jde}=IA(),{Option:m4}=NA();$n.program=new UA;$n.createCommand=t=>new UA(t);$n.createOption=(t,e)=>new m4(t,e);$n.createArgument=(t,e)=>new f4(t,e);$n.Command=UA;$n.Option=m4;$n.Argument=f4;$n.Help=Jde;$n.CommanderError=Kde;$n.InvalidArgumentError=p4;$n.InvalidOptionArgumentError=p4});var De=v(Xt=>{"use strict";var BA=Symbol.for("yaml.alias"),b4=Symbol.for("yaml.document"),vy=Symbol.for("yaml.map"),v4=Symbol.for("yaml.pair"),HA=Symbol.for("yaml.scalar"),Sy=Symbol.for("yaml.seq"),fo=Symbol.for("yaml.node.type"),rfe=t=>!!t&&typeof t=="object"&&t[fo]===BA,nfe=t=>!!t&&typeof t=="object"&&t[fo]===b4,ife=t=>!!t&&typeof t=="object"&&t[fo]===vy,ofe=t=>!!t&&typeof t=="object"&&t[fo]===v4,S4=t=>!!t&&typeof t=="object"&&t[fo]===HA,sfe=t=>!!t&&typeof t=="object"&&t[fo]===Sy;function w4(t){if(t&&typeof t=="object")switch(t[fo]){case vy:case Sy:return!0}return!1}function afe(t){if(t&&typeof t=="object")switch(t[fo]){case BA:case vy:case HA:case Sy:return!0}return!1}var cfe=t=>(S4(t)||w4(t))&&!!t.anchor;Xt.ALIAS=BA;Xt.DOC=b4;Xt.MAP=vy;Xt.NODE_TYPE=fo;Xt.PAIR=v4;Xt.SCALAR=HA;Xt.SEQ=Sy;Xt.hasAnchor=cfe;Xt.isAlias=rfe;Xt.isCollection=w4;Xt.isDocument=nfe;Xt.isMap=ife;Xt.isNode=afe;Xt.isPair=ofe;Xt.isScalar=S4;Xt.isSeq=sfe});var nf=v(GA=>{"use strict";var zt=De(),Cr=Symbol("break visit"),x4=Symbol("skip children"),ki=Symbol("remove node");function wy(t,e){let r=$4(e);zt.isDocument(t)?Jc(null,t.contents,r,Object.freeze([t]))===ki&&(t.contents=null):Jc(null,t,r,Object.freeze([]))}wy.BREAK=Cr;wy.SKIP=x4;wy.REMOVE=ki;function Jc(t,e,r,n){let i=k4(t,e,r,n);if(zt.isNode(i)||zt.isPair(i))return E4(t,n,i),Jc(t,i,r,n);if(typeof i!="symbol"){if(zt.isCollection(e)){n=Object.freeze(n.concat(e));for(let o=0;o{"use strict";var A4=De(),lfe=nf(),ufe={"!":"%21",",":"%2C","[":"%5B","]":"%5D","{":"%7B","}":"%7D"},dfe=t=>t.replace(/[!,[\]{}]/g,e=>ufe[e]),of=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+dfe(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&&A4.isNode(e.contents)){let o={};lfe.visit(e.contents,(s,a)=>{A4.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(` +`)}};of.defaultYaml={explicit:!1,version:"1.2"};of.defaultTags={"!!":"tag:yaml.org,2002:"};T4.Directives=of});var $y=v(sf=>{"use strict";var O4=De(),ffe=nf();function pfe(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 R4(t){let e=new Set;return ffe.visit(t,{Value(r,n){n.anchor&&e.add(n.anchor)}}),e}function I4(t,e){for(let r=1;;++r){let n=`${t}${r}`;if(!e.has(n))return n}}function mfe(t,e){let r=[],n=new Map,i=null;return{onAnchor:o=>{r.push(o),i??(i=R4(t));let s=I4(e,i);return i.add(s),s},setAnchors:()=>{for(let o of r){let s=n.get(o);if(typeof s=="object"&&s.anchor&&(O4.isScalar(s.node)||O4.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}}sf.anchorIsValid=pfe;sf.anchorNames=R4;sf.createNodeAnchors=mfe;sf.findNewAnchor=I4});var VA=v(P4=>{"use strict";function af(t,e,r,n){if(n&&typeof n=="object")if(Array.isArray(n))for(let i=0,o=n.length;i{"use strict";var hfe=De();function C4(t,e,r){if(Array.isArray(t))return t.map((n,i)=>C4(n,String(i),r));if(t&&typeof t.toJSON=="function"){if(!r||!hfe.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}D4.toJS=C4});var ky=v(j4=>{"use strict";var gfe=VA(),N4=De(),yfe=Zo(),WA=class{constructor(e){Object.defineProperty(this,N4.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(!N4.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=yfe.toJS(this,"",s);if(typeof i=="function")for(let{count:c,res:l}of s.anchors.values())i(l,c);return typeof o=="function"?gfe.applyReviver(o,{"":a},"",a):a}};j4.NodeBase=WA});var cf=v(M4=>{"use strict";var _fe=$y(),bfe=nf(),Xc=De(),vfe=ky(),Sfe=Zo(),KA=class extends vfe.NodeBase{constructor(e){super(Xc.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=[],bfe.visit(e,{Node:(o,s)=>{(Xc.isAlias(s)||Xc.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||(Sfe.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=Ey(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(_fe.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 Ey(t,e,r){if(Xc.isAlias(e)){let n=e.resolve(t),i=r&&n&&r.get(n);return i?i.count*i.aliasCount:0}else if(Xc.isCollection(e)){let n=0;for(let i of e.items){let o=Ey(t,i,r);o>n&&(n=o)}return n}else if(Xc.isPair(e)){let n=Ey(t,e.key,r),i=Ey(t,e.value,r);return Math.max(n,i)}return 1}M4.Alias=KA});var Dt=v(JA=>{"use strict";var wfe=De(),xfe=ky(),$fe=Zo(),kfe=t=>!t||typeof t!="function"&&typeof t!="object",Vo=class extends xfe.NodeBase{constructor(e){super(wfe.SCALAR),this.value=e}toJSON(e,r){return r?.keep?this.value:$fe.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";JA.Scalar=Vo;JA.isScalarValue=kfe});var lf=v(L4=>{"use strict";var Efe=cf(),da=De(),F4=Dt(),Afe="tag:yaml.org,2002:";function Tfe(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 Ofe(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 Efe.Alias(c.anchor);c={anchor:null,node:null},a.set(t,c)}e?.startsWith("!!")&&(e=Afe+e.slice(2));let l=Tfe(t,e,s.tags);if(!l){if(t&&typeof t.toJSON=="function"&&(t=t.toJSON()),!t||typeof t!="object"){let d=new F4.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 F4.Scalar(t);return e?u.tag=e:l.default||(u.tag=l.tag),c&&(c.node=u),u}L4.createNode=Ofe});var Ty=v(Ay=>{"use strict";var Rfe=lf(),Ei=De(),Ife=ky();function YA(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 Rfe.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,XA=class extends Ife.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=>Ei.isNode(n)||Ei.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(Ei.isCollection(o))o.addIn(i,r);else if(o===void 0&&this.schema)this.set(n,YA(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(Ei.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&&Ei.isScalar(o)?o.value:o:Ei.isCollection(o)?o.getIn(i,r):void 0}hasAllNullValues(e){return this.items.every(r=>{if(!Ei.isPair(r))return!1;let n=r.value;return n==null||e&&Ei.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 Ei.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(Ei.isCollection(o))o.setIn(i,r);else if(o===void 0&&this.schema)this.set(n,YA(this.schema,i,r));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}};Ay.Collection=XA;Ay.collectionFromPath=YA;Ay.isEmptyPath=z4});var uf=v(Oy=>{"use strict";var Pfe=t=>t.replace(/^(?!$)(?: $)?/gm,"#");function QA(t,e){return/^\n+$/.test(t)?t.substring(1):e?t.replace(/^(?! *$)/gm,e):t}var Cfe=(t,e,r)=>t.endsWith(` +`)?QA(r,e):r.includes(` `)?` -`+bA(r,e):(t.endsWith(" ")?"":" ")+r;ey.indentComment=bA;ey.lineComment=Ade;ey.stringifyComment=Ede});var Yq=v(Vd=>{"use strict";var Tde="flow",vA="block",ty="quoted";function Ode(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===vA&&(h=Jq(t,h,e.length),h!==-1&&(d=h+c));for(let S;S=t[h+=1];){if(r===ty&&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===vA&&(h=Jq(t,h,e.length)),d=h+e.length+c,f=void 0;else{if(S===" "&&p&&p!==" "&&p!==` +`+QA(r,e):(t.endsWith(" ")?"":" ")+r;Oy.indentComment=QA;Oy.lineComment=Cfe;Oy.stringifyComment=Pfe});var q4=v(df=>{"use strict";var Dfe="flow",eT="block",Ry="quoted";function Nfe(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===eT&&(h=U4(t,h,e.length),h!==-1&&(d=h+c));for(let S;S=t[h+=1];){if(r===Ry&&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===eT&&(h=U4(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===ty){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 Hn=It(),zo=Yq(),ny=(t,e)=>({indentAtStart:e?t.indent.length:t.indentAtStart,lineWidth:t.options.lineWidth,minContentWidth:t.options.minContentWidth}),iy=t=>/^(%|---|\.\.\.)/m.test(t);function Rde(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 Wd(t,e){let r=JSON.stringify(t);if(e.options.doubleQuotedAsJSON)return r;let{implicitKey:n}=e,i=e.options.doubleQuotedMinMultiLineLength,o=e.indent||(iy(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=d)if(f)l.push(f),d=f+c,f=void 0;else if(r===Ry){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 Wn=Dt(),Wo=q4(),Py=(t,e)=>({indentAtStart:e?t.indent.length:t.indentAtStart,lineWidth:t.options.lineWidth,minContentWidth:t.options.minContentWidth}),Cy=t=>/^(%|---|\.\.\.)/m.test(t);function jfe(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 ff(t,e){let r=JSON.stringify(t);if(e.options.doubleQuotedAsJSON)return r;let{implicitKey:n}=e,i=e.options.doubleQuotedMinMultiLineLength,o=e.indent||(Cy(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(wA,`$&${l}`));let h=!1,g,b=-1;for(g=0;g{O=!0});let E=zo.foldFlowLines(`${_}${w}${p}`,l,zo.FOLD_BLOCK,A);if(!O)return`>${x} -${l}${E}`}return r=r.replace(/\n+/g,`$&${l}`),`|${x} -${l}${_}${r}${p}`}function Ide(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 Fc(o,e);if(/^[\n\t ,[\]{}#&*!|>'"%@`]|^[?-]$|^[?-][ \t]|[\n:][ \t]|[ \t]\n|[\n\t ]#|[\n\t :]$/.test(o))return a||u||!o.includes(` -`)?Fc(o,e):ry(t,e,r,n);if(!a&&!u&&i!==Hn.Scalar.PLAIN&&o.includes(` -`))return ry(t,e,r,n);if(iy(o)){if(c==="")return e.forceBlockIndent=!0,ry(t,e,r,n);if(a&&c===l)return Fc(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 Fc(o,e)}return a?d:zo.foldFlowLines(d,c,zo.FOLD_FLOW,ny(e,!1))}function Pde(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!==Hn.Scalar.QUOTE_DOUBLE&&/[\x00-\x08\x0b-\x1f\x7f-\x9f\u{D800}-\u{DFFF}]/u.test(s.value)&&(a=Hn.Scalar.QUOTE_DOUBLE);let c=u=>{switch(u){case Hn.Scalar.BLOCK_FOLDED:case Hn.Scalar.BLOCK_LITERAL:return i||o?Fc(s.value,e):ry(s,e,r,n);case Hn.Scalar.QUOTE_DOUBLE:return Wd(s.value,e);case Hn.Scalar.QUOTE_SINGLE:return SA(s.value,e);case Hn.Scalar.PLAIN:return Ide(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}Xq.stringifyString=Pde});var Jd=v(xA=>{"use strict";var Cde=Kg(),Uo=Ce(),Dde=Zd(),Nde=Kd();function jde(t,e){let r=Object.assign({blockQuote:!0,commentString:Dde.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 Mde(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(Uo.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 Fde(t,e,{anchors:r,doc:n}){if(!n.directives)return"";let i=[],o=(Uo.isScalar(t)||Uo.isCollection(t))&&t.anchor;o&&Cde.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 Lde(t,e,r,n){if(Uo.isPair(t))return t.toString(e,r,n);if(Uo.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=Uo.isNode(t)?t:e.doc.createNode(t,{onTagObj:c=>i=c});i??(i=Mde(e.doc.schema.tags,o));let s=Fde(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):Uo.isScalar(o)?Nde.stringifyString(o,e,r,n):o.toString(e,r,n);return s?Uo.isScalar(o)||a[0]==="{"||a[0]==="["?`${s} ${a}`:`${s} -${e.indent}${a}`:a}xA.createStringifyContext=jde;xA.stringify=Lde});var r4=v(t4=>{"use strict";var oo=Ce(),Qq=It(),e4=Jd(),Yd=Zd();function zde({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=oo.isNode(t)&&t.comment||null;if(d){if(f)throw new Error("With simple keys, key nodes cannot have comments");if(oo.isCollection(t)||!oo.isNode(t)&&typeof t=="object"){let A="With simple keys, collection cannot be used as a key value";throw new Error(A)}}let p=!d&&(!t||f&&e==null&&!r.inFlow||oo.isCollection(t)||(oo.isScalar(t)?t.type===Qq.Scalar.BLOCK_FOLDED||t.type===Qq.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=e4.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+=Yd.lineComment(g,r.indent,l(f)):h&&i&&i(),g;m&&(f=null),p?(f&&(g+=Yd.lineComment(g,r.indent,l(f))),g=`? ${g} -${a}:`):(g=`${g}:`,f&&(g+=Yd.lineComment(g,r.indent,l(f))));let b,_,S;oo.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&&oo.isScalar(e)&&(r.indentAtStart=g.length+1),h=!1,!u&&c.length>=2&&!r.inFlow&&!p&&oo.isSeq(e)&&!e.flow&&!e.tag&&!e.anchor&&(r.indent=r.indent.substring(2));let x=!1,w=e4.stringify(e,r,()=>x=!0,()=>h=!0),O=" ";if(f||b||_){if(O=b?` -`:"",_){let A=l(_);O+=` -${Yd.indentComment(A,r.indent)}`}w===""&&!r.inFlow?O===` +$&`).replace(/(?:^|\n)([\t ].*)(?:([\n\t ]*)\n(?![\n\t ]))?/g,"$1$2").replace(/\n+/g,`$&${l}`),O=!1,T=Py(n,!0);s!=="folded"&&e!==Wn.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 Mfe(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 Qc(o,e);if(/^[\n\t ,[\]{}#&*!|>'"%@`]|^[?-]$|^[?-][ \t]|[\n:][ \t]|[ \t]\n|[\n\t ]#|[\n\t :]$/.test(o))return a||u||!o.includes(` +`)?Qc(o,e):Iy(t,e,r,n);if(!a&&!u&&i!==Wn.Scalar.PLAIN&&o.includes(` +`))return Iy(t,e,r,n);if(Cy(o)){if(c==="")return e.forceBlockIndent=!0,Iy(t,e,r,n);if(a&&c===l)return Qc(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 Qc(o,e)}return a?d:Wo.foldFlowLines(d,c,Wo.FOLD_FLOW,Py(e,!1))}function Ffe(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!==Wn.Scalar.QUOTE_DOUBLE&&/[\x00-\x08\x0b-\x1f\x7f-\x9f\u{D800}-\u{DFFF}]/u.test(s.value)&&(a=Wn.Scalar.QUOTE_DOUBLE);let c=u=>{switch(u){case Wn.Scalar.BLOCK_FOLDED:case Wn.Scalar.BLOCK_LITERAL:return i||o?Qc(s.value,e):Iy(s,e,r,n);case Wn.Scalar.QUOTE_DOUBLE:return ff(s.value,e);case Wn.Scalar.QUOTE_SINGLE:return tT(s.value,e);case Wn.Scalar.PLAIN:return Mfe(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}B4.stringifyString=Ffe});var mf=v(nT=>{"use strict";var Lfe=$y(),Ko=De(),zfe=uf(),Ufe=pf();function qfe(t,e){let r=Object.assign({blockQuote:!0,commentString:zfe.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 Bfe(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 Hfe(t,e,{anchors:r,doc:n}){if(!n.directives)return"";let i=[],o=(Ko.isScalar(t)||Ko.isCollection(t))&&t.anchor;o&&Lfe.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 Gfe(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=Bfe(e.doc.schema.tags,o));let s=Hfe(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)?Ufe.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}nT.createStringifyContext=qfe;nT.stringify=Gfe});var V4=v(Z4=>{"use strict";var po=De(),H4=Dt(),G4=mf(),hf=uf();function Zfe({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=po.isNode(t)&&t.comment||null;if(d){if(f)throw new Error("With simple keys, key nodes cannot have comments");if(po.isCollection(t)||!po.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||po.isCollection(t)||(po.isScalar(t)?t.type===H4.Scalar.BLOCK_FOLDED||t.type===H4.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=G4.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+=hf.lineComment(g,r.indent,l(f)):h&&i&&i(),g;m&&(f=null),p?(f&&(g+=hf.lineComment(g,r.indent,l(f))),g=`? ${g} +${a}:`):(g=`${g}:`,f&&(g+=hf.lineComment(g,r.indent,l(f))));let b,_,S;po.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&&po.isScalar(e)&&(r.indentAtStart=g.length+1),h=!1,!u&&c.length>=2&&!r.inFlow&&!p&&po.isSeq(e)&&!e.flow&&!e.tag&&!e.anchor&&(r.indent=r.indent.substring(2));let x=!1,w=G4.stringify(e,r,()=>x=!0,()=>h=!0),O=" ";if(f||b||_){if(O=b?` +`:"",_){let T=l(_);O+=` +${hf.indentComment(T,r.indent)}`}w===""&&!r.inFlow?O===` `&&S&&(O=` `):O+=` -${r.indent}`}else if(!p&&oo.isCollection(e)){let A=w[0],E=w.indexOf(` -`),C=E!==-1,k=r.inFlow??e.flow??e.items.length===0;if(C||!k){let q=!1;if(C&&(A==="&"||A==="!")){let X=w.indexOf(" ");A==="&"&&X!==-1&&X{"use strict";var n4=He("process");function Ude(t,...e){t==="debug"&&console.log(...e)}function qde(t,e){(t==="debug"||t==="warn")&&(typeof n4.emitWarning=="function"?n4.emitWarning(e):console.warn(e))}$A.debug=Ude;$A.warn=qde});var ly=v(cy=>{"use strict";var ay=Ce(),i4=It(),oy="<<",sy={identify:t=>t===oy||typeof t=="symbol"&&t.description===oy,default:"key",tag:"tag:yaml.org,2002:merge",test:/^<<$/,resolve:()=>Object.assign(new i4.Scalar(Symbol(oy)),{addToJSMap:o4}),stringify:()=>oy},Bde=(t,e)=>(sy.identify(e)||ay.isScalar(e)&&(!e.type||e.type===i4.Scalar.PLAIN)&&sy.identify(e.value))&&t?.doc.schema.tags.some(r=>r.tag===sy.tag&&r.default);function o4(t,e,r){let n=s4(t,r);if(ay.isSeq(n))for(let i of n.items)EA(t,e,i);else if(Array.isArray(n))for(let i of n)EA(t,e,i);else EA(t,e,n)}function EA(t,e,r){let n=s4(t,r);if(!ay.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 s4(t,e){return t&&ay.isAlias(e)?e.resolve(t.doc,t):e}cy.addMergeToJSMap=o4;cy.isMergeKey=Bde;cy.merge=sy});var TA=v(l4=>{"use strict";var Hde=kA(),a4=ly(),Gde=Jd(),c4=Ce(),AA=Fo();function Zde(t,e,{key:r,value:n}){if(c4.isNode(r)&&r.addToJSMap)r.addToJSMap(t,e,n);else if(a4.isMergeKey(t,r))a4.addMergeToJSMap(t,e,n);else{let i=AA.toJS(r,"",t);if(e instanceof Map)e.set(i,AA.toJS(n,i,t));else if(e instanceof Set)e.add(i);else{let o=Vde(r,i,t),s=AA.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 Vde(t,e,r){if(e===null)return"";if(typeof e!="object")return String(e);if(c4.isNode(t)&&r?.doc){let n=Gde.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)+'..."'),Hde.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)}l4.addPairToJSMap=Zde});var qo=v(OA=>{"use strict";var u4=Gd(),Wde=r4(),Kde=TA(),uy=Ce();function Jde(t,e,r){let n=u4.createNode(t,void 0,r),i=u4.createNode(e,void 0,r);return new dy(n,i)}var dy=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 Kde.addPairToJSMap(r,n,this)}toString(e,r,n){return e?.doc?Wde.stringifyPair(this,e,r,n):JSON.stringify(this)}};OA.Pair=dy;OA.createPair=Jde});var RA=v(f4=>{"use strict";var ra=Ce(),d4=Jd(),fy=Zd();function Yde(t,e,r){return(e.inFlow??t.flow?Qde:Xde)(t,e,r)}function Xde({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+=fy.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 W4=Ge("process");function Vfe(t,...e){t==="debug"&&console.log(...e)}function Wfe(t,e){(t==="debug"||t==="warn")&&(typeof W4.emitWarning=="function"?W4.emitWarning(e):console.warn(e))}iT.debug=Vfe;iT.warn=Wfe});var Fy=v(My=>{"use strict";var jy=De(),K4=Dt(),Dy="<<",Ny={identify:t=>t===Dy||typeof t=="symbol"&&t.description===Dy,default:"key",tag:"tag:yaml.org,2002:merge",test:/^<<$/,resolve:()=>Object.assign(new K4.Scalar(Symbol(Dy)),{addToJSMap:J4}),stringify:()=>Dy},Kfe=(t,e)=>(Ny.identify(e)||jy.isScalar(e)&&(!e.type||e.type===K4.Scalar.PLAIN)&&Ny.identify(e.value))&&t?.doc.schema.tags.some(r=>r.tag===Ny.tag&&r.default);function J4(t,e,r){let n=Y4(t,r);if(jy.isSeq(n))for(let i of n.items)sT(t,e,i);else if(Array.isArray(n))for(let i of n)sT(t,e,i);else sT(t,e,n)}function sT(t,e,r){let n=Y4(t,r);if(!jy.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 Y4(t,e){return t&&jy.isAlias(e)?e.resolve(t.doc,t):e}My.addMergeToJSMap=J4;My.isMergeKey=Kfe;My.merge=Ny});var cT=v(e6=>{"use strict";var Jfe=oT(),X4=Fy(),Yfe=mf(),Q4=De(),aT=Zo();function Xfe(t,e,{key:r,value:n}){if(Q4.isNode(r)&&r.addToJSMap)r.addToJSMap(t,e,n);else if(X4.isMergeKey(t,r))X4.addMergeToJSMap(t,e,n);else{let i=aT.toJS(r,"",t);if(e instanceof Map)e.set(i,aT.toJS(n,i,t));else if(e instanceof Set)e.add(i);else{let o=Qfe(r,i,t),s=aT.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 Qfe(t,e,r){if(e===null)return"";if(typeof e!="object")return String(e);if(Q4.isNode(t)&&r?.doc){let n=Yfe.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)+'..."'),Jfe.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)}e6.addPairToJSMap=Xfe});var Jo=v(lT=>{"use strict";var t6=lf(),epe=V4(),tpe=cT(),Ly=De();function rpe(t,e,r){let n=t6.createNode(t,void 0,r),i=t6.createNode(e,void 0,r);return new zy(n,i)}var zy=class t{constructor(e,r=null){Object.defineProperty(this,Ly.NODE_TYPE,{value:Ly.PAIR}),this.key=e,this.value=r}clone(e){let{key:r,value:n}=this;return Ly.isNode(r)&&(r=r.clone(e)),Ly.isNode(n)&&(n=n.clone(e)),new t(r,n)}toJSON(e,r){let n=r?.mapAsMap?new Map:{};return tpe.addPairToJSMap(r,n,this)}toString(e,r,n){return e?.doc?epe.stringifyPair(this,e,r,n):JSON.stringify(this)}};lT.Pair=zy;lT.createPair=rpe});var uT=v(n6=>{"use strict";var fa=De(),r6=mf(),Uy=uf();function npe(t,e,r){return(e.inFlow??t.flow?ope:ipe)(t,e,r)}function ipe({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+=Uy.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(` -`)),m0&&(l||(l=d.reduce((_,S)=>_+S.length+2,2)+(b.length+2)>e.options.lineWidth)),l&&(b+=",")),g&&(b+=fy.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?` +`+Uy.indentComment(l(t),c),a&&a()):d&&s&&s(),p}function ope({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+=Uy.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 py({indent:t,options:{commentString:e}},r,n,i){if(n&&i&&(n=n.replace(/^\n+/,"")),n){let o=fy.indentComment(e(n),t);r.push(o.trimStart())}}f4.stringifyCollection=Yde});var Ho=v(PA=>{"use strict";var efe=RA(),tfe=TA(),rfe=Qg(),Bo=Ce(),my=qo(),nfe=It();function Xd(t,e){let r=Bo.isScalar(e)?e.value:e;for(let n of t)if(Bo.isPair(n)&&(n.key===e||n.key===r||Bo.isScalar(n.key)&&n.key.value===r))return n}var IA=class extends rfe.Collection{static get tagName(){return"tag:yaml.org,2002:map"}constructor(e){super(Bo.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(my.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;Bo.isPair(e)?n=e:!e||typeof e!="object"||!("key"in e)?n=new my.Pair(e,e?.value):n=new my.Pair(e.key,e.value);let i=Xd(this.items,n.key),o=this.schema?.sortMapEntries;if(i){if(!r)throw new Error(`Key ${n.key} already set`);Bo.isScalar(i.value)&&nfe.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=Xd(this.items,e);return r?this.items.splice(this.items.indexOf(r),1).length>0:!1}get(e,r){let i=Xd(this.items,e)?.value;return(!r&&Bo.isScalar(i)?i.value:i)??void 0}has(e){return!!Xd(this.items,e)}set(e,r){this.add(new my.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)tfe.addPairToJSMap(r,i,o);return i}toString(e,r,n){if(!e)return JSON.stringify(this);for(let i of this.items)if(!Bo.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})),efe.stringifyCollection(this,e,{blockItemPrefix:"",flowChars:{start:"{",end:"}"},itemIndent:e.indent||"",onChompKeep:n,onComment:r})}};PA.YAMLMap=IA;PA.findPair=Xd});var Lc=v(m4=>{"use strict";var ife=Ce(),p4=Ho(),ofe={collection:"map",default:!0,nodeClass:p4.YAMLMap,tag:"tag:yaml.org,2002:map",resolve(t,e){return ife.isMap(t)||e("Expected a mapping for this tag"),t},createNode:(t,e,r)=>p4.YAMLMap.from(t,e,r)};m4.map=ofe});var Go=v(h4=>{"use strict";var sfe=Gd(),afe=RA(),cfe=Qg(),gy=Ce(),lfe=It(),ufe=Fo(),CA=class extends cfe.Collection{static get tagName(){return"tag:yaml.org,2002:seq"}constructor(e){super(gy.SEQ,e),this.items=[]}add(e){this.items.push(e)}delete(e){let r=hy(e);return typeof r!="number"?!1:this.items.splice(r,1).length>0}get(e,r){let n=hy(e);if(typeof n!="number")return;let i=this.items[n];return!r&&gy.isScalar(i)?i.value:i}has(e){let r=hy(e);return typeof r=="number"&&r=0?e:null}h4.YAMLSeq=CA});var zc=v(y4=>{"use strict";var dfe=Ce(),g4=Go(),ffe={collection:"seq",default:!0,nodeClass:g4.YAMLSeq,tag:"tag:yaml.org,2002:seq",resolve(t,e){return dfe.isSeq(t)||e("Expected a sequence for this tag"),t},createNode:(t,e,r)=>g4.YAMLSeq.from(t,e,r)};y4.seq=ffe});var Qd=v(_4=>{"use strict";var pfe=Kd(),mfe={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),pfe.stringifyString(t,e,r,n)}};_4.string=mfe});var yy=v(S4=>{"use strict";var b4=It(),v4={identify:t=>t==null,createNode:()=>new b4.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^(?:~|[Nn]ull|NULL)?$/,resolve:()=>new b4.Scalar(null),stringify:({source:t},e)=>typeof t=="string"&&v4.test.test(t)?t:e.options.nullStr};S4.nullTag=v4});var DA=v(x4=>{"use strict";var hfe=It(),w4={identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:[Tt]rue|TRUE|[Ff]alse|FALSE)$/,resolve:t=>new hfe.Scalar(t[0]==="t"||t[0]==="T"),stringify({source:t,value:e},r){if(t&&w4.test.test(t)){let n=t[0]==="t"||t[0]==="T";if(e===n)return t}return e?r.options.trueStr:r.options.falseStr}};x4.boolTag=w4});var Uc=v($4=>{"use strict";function gfe({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}$4.stringifyNumber=gfe});var jA=v(_y=>{"use strict";var yfe=It(),NA=Uc(),_fe={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:NA.stringifyNumber},bfe={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():NA.stringifyNumber(t)}},vfe={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 yfe.Scalar(parseFloat(t)),r=t.indexOf(".");return r!==-1&&t[t.length-1]==="0"&&(e.minFractionDigits=t.length-r-1),e},stringify:NA.stringifyNumber};_y.float=vfe;_y.floatExp=bfe;_y.floatNaN=_fe});var FA=v(vy=>{"use strict";var k4=Uc(),by=t=>typeof t=="bigint"||Number.isInteger(t),MA=(t,e,r,{intAsBigInt:n})=>n?BigInt(t):parseInt(t.substring(e),r);function E4(t,e,r){let{value:n}=t;return by(n)&&n>=0?r+n.toString(e):k4.stringifyNumber(t)}var Sfe={identify:t=>by(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^0o[0-7]+$/,resolve:(t,e,r)=>MA(t,2,8,r),stringify:t=>E4(t,8,"0o")},wfe={identify:by,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9]+$/,resolve:(t,e,r)=>MA(t,0,10,r),stringify:k4.stringifyNumber},xfe={identify:t=>by(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^0x[0-9a-fA-F]+$/,resolve:(t,e,r)=>MA(t,2,16,r),stringify:t=>E4(t,16,"0x")};vy.int=wfe;vy.intHex=xfe;vy.intOct=Sfe});var T4=v(A4=>{"use strict";var $fe=Lc(),kfe=yy(),Efe=zc(),Afe=Qd(),Tfe=DA(),LA=jA(),zA=FA(),Ofe=[$fe.map,Efe.seq,Afe.string,kfe.nullTag,Tfe.boolTag,zA.intOct,zA.int,zA.intHex,LA.floatNaN,LA.floatExp,LA.float];A4.schema=Ofe});var I4=v(R4=>{"use strict";var Rfe=It(),Ife=Lc(),Pfe=zc();function O4(t){return typeof t=="bigint"||Number.isInteger(t)}var Sy=({value:t})=>JSON.stringify(t),Cfe=[{identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify:Sy},{identify:t=>t==null,createNode:()=>new Rfe.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^null$/,resolve:()=>null,stringify:Sy},{identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^true$|^false$/,resolve:t=>t==="true",stringify:Sy},{identify:O4,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})=>O4(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:Sy}],Dfe={default:!0,tag:"",test:/^/,resolve(t,e){return e(`Unresolved plain scalar ${JSON.stringify(t)}`),t}},Nfe=[Ife.map,Pfe.seq].concat(Cfe,Dfe);R4.schema=Nfe});var qA=v(P4=>{"use strict";var ef=He("buffer"),UA=It(),jfe=Kd(),Mfe={identify:t=>t instanceof Uint8Array,default:!1,tag:"tag:yaml.org,2002:binary",resolve(t,e){if(typeof ef.Buffer=="function")return ef.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 wy=Ce(),BA=qo(),Ffe=It(),Lfe=Go();function C4(t,e){if(wy.isSeq(t))for(let r=0;r1&&e("Each pair must have its own sequence indicator");let i=n.items[0]||new BA.Pair(new Ffe.Scalar(null));if(n.commentBefore&&(i.key.commentBefore=i.key.commentBefore?`${n.commentBefore} +${i}${p}`}else return`${f}${s}${d.join(" ")}${s}${p}`}function qy({indent:t,options:{commentString:e}},r,n,i){if(n&&i&&(n=n.replace(/^\n+/,"")),n){let o=Uy.indentComment(e(n),t);r.push(o.trimStart())}}n6.stringifyCollection=npe});var Xo=v(fT=>{"use strict";var spe=uT(),ape=cT(),cpe=Ty(),Yo=De(),By=Jo(),lpe=Dt();function gf(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 dT=class extends cpe.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(By.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 By.Pair(e,e?.value):n=new By.Pair(e.key,e.value);let i=gf(this.items,n.key),o=this.schema?.sortMapEntries;if(i){if(!r)throw new Error(`Key ${n.key} already set`);Yo.isScalar(i.value)&&lpe.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=gf(this.items,e);return r?this.items.splice(this.items.indexOf(r),1).length>0:!1}get(e,r){let i=gf(this.items,e)?.value;return(!r&&Yo.isScalar(i)?i.value:i)??void 0}has(e){return!!gf(this.items,e)}set(e,r){this.add(new By.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)ape.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})),spe.stringifyCollection(this,e,{blockItemPrefix:"",flowChars:{start:"{",end:"}"},itemIndent:e.indent||"",onChompKeep:n,onComment:r})}};fT.YAMLMap=dT;fT.findPair=gf});var el=v(o6=>{"use strict";var upe=De(),i6=Xo(),dpe={collection:"map",default:!0,nodeClass:i6.YAMLMap,tag:"tag:yaml.org,2002:map",resolve(t,e){return upe.isMap(t)||e("Expected a mapping for this tag"),t},createNode:(t,e,r)=>i6.YAMLMap.from(t,e,r)};o6.map=dpe});var Qo=v(s6=>{"use strict";var fpe=lf(),ppe=uT(),mpe=Ty(),Gy=De(),hpe=Dt(),gpe=Zo(),pT=class extends mpe.Collection{static get tagName(){return"tag:yaml.org,2002:seq"}constructor(e){super(Gy.SEQ,e),this.items=[]}add(e){this.items.push(e)}delete(e){let r=Hy(e);return typeof r!="number"?!1:this.items.splice(r,1).length>0}get(e,r){let n=Hy(e);if(typeof n!="number")return;let i=this.items[n];return!r&&Gy.isScalar(i)?i.value:i}has(e){let r=Hy(e);return typeof r=="number"&&r=0?e:null}s6.YAMLSeq=pT});var tl=v(c6=>{"use strict";var ype=De(),a6=Qo(),_pe={collection:"seq",default:!0,nodeClass:a6.YAMLSeq,tag:"tag:yaml.org,2002:seq",resolve(t,e){return ype.isSeq(t)||e("Expected a sequence for this tag"),t},createNode:(t,e,r)=>a6.YAMLSeq.from(t,e,r)};c6.seq=_pe});var yf=v(l6=>{"use strict";var bpe=pf(),vpe={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),bpe.stringifyString(t,e,r,n)}};l6.string=vpe});var Zy=v(f6=>{"use strict";var u6=Dt(),d6={identify:t=>t==null,createNode:()=>new u6.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^(?:~|[Nn]ull|NULL)?$/,resolve:()=>new u6.Scalar(null),stringify:({source:t},e)=>typeof t=="string"&&d6.test.test(t)?t:e.options.nullStr};f6.nullTag=d6});var mT=v(m6=>{"use strict";var Spe=Dt(),p6={identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^(?:[Tt]rue|TRUE|[Ff]alse|FALSE)$/,resolve:t=>new Spe.Scalar(t[0]==="t"||t[0]==="T"),stringify({source:t,value:e},r){if(t&&p6.test.test(t)){let n=t[0]==="t"||t[0]==="T";if(e===n)return t}return e?r.options.trueStr:r.options.falseStr}};m6.boolTag=p6});var rl=v(h6=>{"use strict";function wpe({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}h6.stringifyNumber=wpe});var gT=v(Vy=>{"use strict";var xpe=Dt(),hT=rl(),$pe={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:hT.stringifyNumber},kpe={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():hT.stringifyNumber(t)}},Epe={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 xpe.Scalar(parseFloat(t)),r=t.indexOf(".");return r!==-1&&t[t.length-1]==="0"&&(e.minFractionDigits=t.length-r-1),e},stringify:hT.stringifyNumber};Vy.float=Epe;Vy.floatExp=kpe;Vy.floatNaN=$pe});var _T=v(Ky=>{"use strict";var g6=rl(),Wy=t=>typeof t=="bigint"||Number.isInteger(t),yT=(t,e,r,{intAsBigInt:n})=>n?BigInt(t):parseInt(t.substring(e),r);function y6(t,e,r){let{value:n}=t;return Wy(n)&&n>=0?r+n.toString(e):g6.stringifyNumber(t)}var Ape={identify:t=>Wy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^0o[0-7]+$/,resolve:(t,e,r)=>yT(t,2,8,r),stringify:t=>y6(t,8,"0o")},Tpe={identify:Wy,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9]+$/,resolve:(t,e,r)=>yT(t,0,10,r),stringify:g6.stringifyNumber},Ope={identify:t=>Wy(t)&&t>=0,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^0x[0-9a-fA-F]+$/,resolve:(t,e,r)=>yT(t,2,16,r),stringify:t=>y6(t,16,"0x")};Ky.int=Tpe;Ky.intHex=Ope;Ky.intOct=Ape});var b6=v(_6=>{"use strict";var Rpe=el(),Ipe=Zy(),Ppe=tl(),Cpe=yf(),Dpe=mT(),bT=gT(),vT=_T(),Npe=[Rpe.map,Ppe.seq,Cpe.string,Ipe.nullTag,Dpe.boolTag,vT.intOct,vT.int,vT.intHex,bT.floatNaN,bT.floatExp,bT.float];_6.schema=Npe});var w6=v(S6=>{"use strict";var jpe=Dt(),Mpe=el(),Fpe=tl();function v6(t){return typeof t=="bigint"||Number.isInteger(t)}var Jy=({value:t})=>JSON.stringify(t),Lpe=[{identify:t=>typeof t=="string",default:!0,tag:"tag:yaml.org,2002:str",resolve:t=>t,stringify:Jy},{identify:t=>t==null,createNode:()=>new jpe.Scalar(null),default:!0,tag:"tag:yaml.org,2002:null",test:/^null$/,resolve:()=>null,stringify:Jy},{identify:t=>typeof t=="boolean",default:!0,tag:"tag:yaml.org,2002:bool",test:/^true$|^false$/,resolve:t=>t==="true",stringify:Jy},{identify:v6,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})=>v6(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:Jy}],zpe={default:!0,tag:"",test:/^/,resolve(t,e){return e(`Unresolved plain scalar ${JSON.stringify(t)}`),t}},Upe=[Mpe.map,Fpe.seq].concat(Lpe,zpe);S6.schema=Upe});var wT=v(x6=>{"use strict";var _f=Ge("buffer"),ST=Dt(),qpe=pf(),Bpe={identify:t=>t instanceof Uint8Array,default:!1,tag:"tag:yaml.org,2002:binary",resolve(t,e){if(typeof _f.Buffer=="function")return _f.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 Yy=De(),xT=Jo(),Hpe=Dt(),Gpe=Qo();function $6(t,e){if(Yy.isSeq(t))for(let r=0;r1&&e("Each pair must have its own sequence indicator");let i=n.items[0]||new xT.Pair(new Hpe.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]=wy.isPair(n)?n:new BA.Pair(n)}}else e("Expected a sequence for this tag");return t}function D4(t,e,r){let{replacer:n}=r,i=new Lfe.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(BA.createPair(a,c,r))}return i}var zfe={collection:"seq",default:!1,tag:"tag:yaml.org,2002:pairs",resolve:C4,createNode:D4};xy.createPairs=D4;xy.pairs=zfe;xy.resolvePairs=C4});var ZA=v(GA=>{"use strict";var N4=Ce(),HA=Fo(),tf=Ho(),Ufe=Go(),j4=$y(),na=class t extends Ufe.YAMLSeq{constructor(){super(),this.add=tf.YAMLMap.prototype.add.bind(this),this.delete=tf.YAMLMap.prototype.delete.bind(this),this.get=tf.YAMLMap.prototype.get.bind(this),this.has=tf.YAMLMap.prototype.has.bind(this),this.set=tf.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(N4.isPair(i)?(o=HA.toJS(i.key,"",r),s=HA.toJS(i.value,o,r)):o=HA.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=j4.createPairs(e,r,n),o=new this;return o.items=i.items,o}};na.tag="tag:yaml.org,2002:omap";var qfe={collection:"seq",identify:t=>t instanceof Map,nodeClass:na,default:!1,tag:"tag:yaml.org,2002:omap",resolve(t,e){let r=j4.resolvePairs(t,e),n=[];for(let{key:i}of r.items)N4.isScalar(i)&&(n.includes(i.value)?e(`Ordered maps must not include duplicate keys: ${i.value}`):n.push(i.value));return Object.assign(new na,r)},createNode:(t,e,r)=>na.from(t,e,r)};GA.YAMLOMap=na;GA.omap=qfe});var U4=v(VA=>{"use strict";var M4=It();function F4({value:t,source:e},r){return e&&(t?L4:z4).test.test(e)?e:t?r.options.trueStr:r.options.falseStr}var L4={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 M4.Scalar(!0),stringify:F4},z4={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 M4.Scalar(!1),stringify:F4};VA.falseTag=z4;VA.trueTag=L4});var q4=v(ky=>{"use strict";var Bfe=It(),WA=Uc(),Hfe={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:WA.stringifyNumber},Gfe={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():WA.stringifyNumber(t)}},Zfe={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 Bfe.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:WA.stringifyNumber};ky.float=Zfe;ky.floatExp=Gfe;ky.floatNaN=Hfe});var H4=v(nf=>{"use strict";var B4=Uc(),rf=t=>typeof t=="bigint"||Number.isInteger(t);function Ey(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 KA(t,e,r){let{value:n}=t;if(rf(n)){let i=n.toString(e);return n<0?"-"+r+i.substr(1):r+i}return B4.stringifyNumber(t)}var Vfe={identify:rf,default:!0,tag:"tag:yaml.org,2002:int",format:"BIN",test:/^[-+]?0b[0-1_]+$/,resolve:(t,e,r)=>Ey(t,2,2,r),stringify:t=>KA(t,2,"0b")},Wfe={identify:rf,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^[-+]?0[0-7_]+$/,resolve:(t,e,r)=>Ey(t,1,8,r),stringify:t=>KA(t,8,"0")},Kfe={identify:rf,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9][0-9_]*$/,resolve:(t,e,r)=>Ey(t,0,10,r),stringify:B4.stringifyNumber},Jfe={identify:rf,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^[-+]?0x[0-9a-fA-F_]+$/,resolve:(t,e,r)=>Ey(t,2,16,r),stringify:t=>KA(t,16,"0x")};nf.int=Kfe;nf.intBin=Vfe;nf.intHex=Jfe;nf.intOct=Wfe});var YA=v(JA=>{"use strict";var Oy=Ce(),Ay=qo(),Ty=Ho(),ia=class t extends Ty.YAMLMap{constructor(e){super(e),this.tag=t.tag}add(e){let r;Oy.isPair(e)?r=e:e&&typeof e=="object"&&"key"in e&&"value"in e&&e.value===null?r=new Ay.Pair(e.key,null):r=new Ay.Pair(e,null),Ty.findPair(this.items,r.key)||this.items.push(r)}get(e,r){let n=Ty.findPair(this.items,e);return!r&&Oy.isPair(n)?Oy.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=Ty.findPair(this.items,e);n&&!r?this.items.splice(this.items.indexOf(n),1):!n&&r&&this.items.push(new Ay.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(Ay.createPair(s,null,n));return o}};ia.tag="tag:yaml.org,2002:set";var Yfe={collection:"map",identify:t=>t instanceof Set,nodeClass:ia,default:!1,tag:"tag:yaml.org,2002:set",createNode:(t,e,r)=>ia.from(t,e,r),resolve(t,e){if(Oy.isMap(t)){if(t.hasAllNullValues(!0))return Object.assign(new ia,t);e("Set items must all have null values")}else e("Expected a mapping for this tag");return t}};JA.YAMLSet=ia;JA.set=Yfe});var QA=v(Ry=>{"use strict";var Xfe=Uc();function XA(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 G4(t){let{value:e}=t,r=s=>s;if(typeof e=="bigint")r=s=>BigInt(s);else if(isNaN(e)||!isFinite(e))return Xfe.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 Qfe={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})=>XA(t,r),stringify:G4},epe={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=>XA(t,!1),stringify:G4},Z4={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(Z4.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=XA(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$/,"")??""};Ry.floatTime=epe;Ry.intTime=Qfe;Ry.timestamp=Z4});var K4=v(W4=>{"use strict";var tpe=Lc(),rpe=yy(),npe=zc(),ipe=Qd(),ope=qA(),V4=U4(),eT=q4(),Iy=H4(),spe=ly(),ape=ZA(),cpe=$y(),lpe=YA(),tT=QA(),upe=[tpe.map,npe.seq,ipe.string,rpe.nullTag,V4.trueTag,V4.falseTag,Iy.intBin,Iy.intOct,Iy.int,Iy.intHex,eT.floatNaN,eT.floatExp,eT.float,ope.binary,spe.merge,ape.omap,cpe.pairs,lpe.set,tT.intTime,tT.floatTime,tT.timestamp];W4.schema=upe});var o6=v(iT=>{"use strict";var Q4=Lc(),dpe=yy(),e6=zc(),fpe=Qd(),ppe=DA(),rT=jA(),nT=FA(),mpe=T4(),hpe=I4(),t6=qA(),of=ly(),r6=ZA(),n6=$y(),J4=K4(),i6=YA(),Py=QA(),Y4=new Map([["core",mpe.schema],["failsafe",[Q4.map,e6.seq,fpe.string]],["json",hpe.schema],["yaml11",J4.schema],["yaml-1.1",J4.schema]]),X4={binary:t6.binary,bool:ppe.boolTag,float:rT.float,floatExp:rT.floatExp,floatNaN:rT.floatNaN,floatTime:Py.floatTime,int:nT.int,intHex:nT.intHex,intOct:nT.intOct,intTime:Py.intTime,map:Q4.map,merge:of.merge,null:dpe.nullTag,omap:r6.omap,pairs:n6.pairs,seq:e6.seq,set:i6.set,timestamp:Py.timestamp},gpe={"tag:yaml.org,2002:binary":t6.binary,"tag:yaml.org,2002:merge":of.merge,"tag:yaml.org,2002:omap":r6.omap,"tag:yaml.org,2002:pairs":n6.pairs,"tag:yaml.org,2002:set":i6.set,"tag:yaml.org,2002:timestamp":Py.timestamp};function ype(t,e,r){let n=Y4.get(e);if(n&&!t)return r&&!n.includes(of.merge)?n.concat(of.merge):n.slice();let i=n;if(!i)if(Array.isArray(t))i=[];else{let o=Array.from(Y4.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(of.merge)),i.reduce((o,s)=>{let a=typeof s=="string"?X4[s]:s;if(!a){let c=JSON.stringify(s),l=Object.keys(X4).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},[])}iT.coreKnownTags=gpe;iT.getTags=ype});var aT=v(s6=>{"use strict";var oT=Ce(),_pe=Lc(),bpe=zc(),vpe=Qd(),Cy=o6(),Spe=(t,e)=>t.keye.key?1:0,sT=class t{constructor({compat:e,customTags:r,merge:n,resolveKnownTags:i,schema:o,sortMapEntries:s,toStringDefaults:a}){this.compat=Array.isArray(e)?Cy.getTags(e,"compat"):e?Cy.getTags(null,e):null,this.name=typeof o=="string"&&o||"core",this.knownTags=i?Cy.coreKnownTags:{},this.tags=Cy.getTags(r,this.name,n),this.toStringOptions=a??null,Object.defineProperty(this,oT.MAP,{value:_pe.map}),Object.defineProperty(this,oT.SCALAR,{value:vpe.string}),Object.defineProperty(this,oT.SEQ,{value:bpe.seq}),this.sortMapEntries=typeof s=="function"?s:s===!0?Spe:null}clone(){let e=Object.create(t.prototype,Object.getOwnPropertyDescriptors(this));return e.tags=this.tags.slice(),e}};s6.Schema=sT});var c6=v(a6=>{"use strict";var wpe=Ce(),cT=Jd(),sf=Zd();function xpe(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=cT.createStringifyContext(t,e),{commentString:o}=i.options;if(t.commentBefore){r.length!==1&&r.unshift("");let c=o(t.commentBefore);r.unshift(sf.indentComment(c,""))}let s=!1,a=null;if(t.contents){if(wpe.isNode(t.contents)){if(t.contents.spaceBefore&&n&&r.push(""),t.contents.commentBefore){let u=o(t.contents.commentBefore);r.push(sf.indentComment(u,""))}i.forceBlockIndent=!!t.comment,a=t.contents.comment}let c=a?void 0:()=>s=!0,l=cT.stringify(t.contents,i,()=>a=null,c);a&&(l+=sf.lineComment(l,"",o(a))),(l[0]==="|"||l[0]===">")&&r[r.length-1]==="---"?r[r.length-1]=`--- ${l}`:r.push(l)}else r.push(cT.stringify(t.contents,i));if(t.directives?.docEnd)if(t.comment){let c=o(t.comment);c.includes(` -`)?(r.push("..."),r.push(sf.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(sf.indentComment(o(c),"")))}return r.join(` +${o.comment}`:n.comment}n=i}t.items[r]=Yy.isPair(n)?n:new xT.Pair(n)}}else e("Expected a sequence for this tag");return t}function k6(t,e,r){let{replacer:n}=r,i=new Gpe.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(xT.createPair(a,c,r))}return i}var Zpe={collection:"seq",default:!1,tag:"tag:yaml.org,2002:pairs",resolve:$6,createNode:k6};Xy.createPairs=k6;Xy.pairs=Zpe;Xy.resolvePairs=$6});var ET=v(kT=>{"use strict";var E6=De(),$T=Zo(),bf=Xo(),Vpe=Qo(),A6=Qy(),pa=class t extends Vpe.YAMLSeq{constructor(){super(),this.add=bf.YAMLMap.prototype.add.bind(this),this.delete=bf.YAMLMap.prototype.delete.bind(this),this.get=bf.YAMLMap.prototype.get.bind(this),this.has=bf.YAMLMap.prototype.has.bind(this),this.set=bf.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(E6.isPair(i)?(o=$T.toJS(i.key,"",r),s=$T.toJS(i.value,o,r)):o=$T.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=A6.createPairs(e,r,n),o=new this;return o.items=i.items,o}};pa.tag="tag:yaml.org,2002:omap";var Wpe={collection:"seq",identify:t=>t instanceof Map,nodeClass:pa,default:!1,tag:"tag:yaml.org,2002:omap",resolve(t,e){let r=A6.resolvePairs(t,e),n=[];for(let{key:i}of r.items)E6.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)};kT.YAMLOMap=pa;kT.omap=Wpe});var P6=v(AT=>{"use strict";var T6=Dt();function O6({value:t,source:e},r){return e&&(t?R6:I6).test.test(e)?e:t?r.options.trueStr:r.options.falseStr}var R6={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 T6.Scalar(!0),stringify:O6},I6={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 T6.Scalar(!1),stringify:O6};AT.falseTag=I6;AT.trueTag=R6});var C6=v(e_=>{"use strict";var Kpe=Dt(),TT=rl(),Jpe={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:TT.stringifyNumber},Ype={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():TT.stringifyNumber(t)}},Xpe={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 Kpe.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:TT.stringifyNumber};e_.float=Xpe;e_.floatExp=Ype;e_.floatNaN=Jpe});var N6=v(Sf=>{"use strict";var D6=rl(),vf=t=>typeof t=="bigint"||Number.isInteger(t);function t_(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 OT(t,e,r){let{value:n}=t;if(vf(n)){let i=n.toString(e);return n<0?"-"+r+i.substr(1):r+i}return D6.stringifyNumber(t)}var Qpe={identify:vf,default:!0,tag:"tag:yaml.org,2002:int",format:"BIN",test:/^[-+]?0b[0-1_]+$/,resolve:(t,e,r)=>t_(t,2,2,r),stringify:t=>OT(t,2,"0b")},eme={identify:vf,default:!0,tag:"tag:yaml.org,2002:int",format:"OCT",test:/^[-+]?0[0-7_]+$/,resolve:(t,e,r)=>t_(t,1,8,r),stringify:t=>OT(t,8,"0")},tme={identify:vf,default:!0,tag:"tag:yaml.org,2002:int",test:/^[-+]?[0-9][0-9_]*$/,resolve:(t,e,r)=>t_(t,0,10,r),stringify:D6.stringifyNumber},rme={identify:vf,default:!0,tag:"tag:yaml.org,2002:int",format:"HEX",test:/^[-+]?0x[0-9a-fA-F_]+$/,resolve:(t,e,r)=>t_(t,2,16,r),stringify:t=>OT(t,16,"0x")};Sf.int=tme;Sf.intBin=Qpe;Sf.intHex=rme;Sf.intOct=eme});var IT=v(RT=>{"use strict";var i_=De(),r_=Jo(),n_=Xo(),ma=class t extends n_.YAMLMap{constructor(e){super(e),this.tag=t.tag}add(e){let r;i_.isPair(e)?r=e:e&&typeof e=="object"&&"key"in e&&"value"in e&&e.value===null?r=new r_.Pair(e.key,null):r=new r_.Pair(e,null),n_.findPair(this.items,r.key)||this.items.push(r)}get(e,r){let n=n_.findPair(this.items,e);return!r&&i_.isPair(n)?i_.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=n_.findPair(this.items,e);n&&!r?this.items.splice(this.items.indexOf(n),1):!n&&r&&this.items.push(new r_.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(r_.createPair(s,null,n));return o}};ma.tag="tag:yaml.org,2002:set";var nme={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(i_.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}};RT.YAMLSet=ma;RT.set=nme});var CT=v(o_=>{"use strict";var ime=rl();function PT(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 j6(t){let{value:e}=t,r=s=>s;if(typeof e=="bigint")r=s=>BigInt(s);else if(isNaN(e)||!isFinite(e))return ime.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 ome={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})=>PT(t,r),stringify:j6},sme={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=>PT(t,!1),stringify:j6},M6={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(M6.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=PT(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$/,"")??""};o_.floatTime=sme;o_.intTime=ome;o_.timestamp=M6});var z6=v(L6=>{"use strict";var ame=el(),cme=Zy(),lme=tl(),ume=yf(),dme=wT(),F6=P6(),DT=C6(),s_=N6(),fme=Fy(),pme=ET(),mme=Qy(),hme=IT(),NT=CT(),gme=[ame.map,lme.seq,ume.string,cme.nullTag,F6.trueTag,F6.falseTag,s_.intBin,s_.intOct,s_.int,s_.intHex,DT.floatNaN,DT.floatExp,DT.float,dme.binary,fme.merge,pme.omap,mme.pairs,hme.set,NT.intTime,NT.floatTime,NT.timestamp];L6.schema=gme});var J6=v(FT=>{"use strict";var H6=el(),yme=Zy(),G6=tl(),_me=yf(),bme=mT(),jT=gT(),MT=_T(),vme=b6(),Sme=w6(),Z6=wT(),wf=Fy(),V6=ET(),W6=Qy(),U6=z6(),K6=IT(),a_=CT(),q6=new Map([["core",vme.schema],["failsafe",[H6.map,G6.seq,_me.string]],["json",Sme.schema],["yaml11",U6.schema],["yaml-1.1",U6.schema]]),B6={binary:Z6.binary,bool:bme.boolTag,float:jT.float,floatExp:jT.floatExp,floatNaN:jT.floatNaN,floatTime:a_.floatTime,int:MT.int,intHex:MT.intHex,intOct:MT.intOct,intTime:a_.intTime,map:H6.map,merge:wf.merge,null:yme.nullTag,omap:V6.omap,pairs:W6.pairs,seq:G6.seq,set:K6.set,timestamp:a_.timestamp},wme={"tag:yaml.org,2002:binary":Z6.binary,"tag:yaml.org,2002:merge":wf.merge,"tag:yaml.org,2002:omap":V6.omap,"tag:yaml.org,2002:pairs":W6.pairs,"tag:yaml.org,2002:set":K6.set,"tag:yaml.org,2002:timestamp":a_.timestamp};function xme(t,e,r){let n=q6.get(e);if(n&&!t)return r&&!n.includes(wf.merge)?n.concat(wf.merge):n.slice();let i=n;if(!i)if(Array.isArray(t))i=[];else{let o=Array.from(q6.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(wf.merge)),i.reduce((o,s)=>{let a=typeof s=="string"?B6[s]:s;if(!a){let c=JSON.stringify(s),l=Object.keys(B6).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},[])}FT.coreKnownTags=wme;FT.getTags=xme});var UT=v(Y6=>{"use strict";var LT=De(),$me=el(),kme=tl(),Eme=yf(),c_=J6(),Ame=(t,e)=>t.keye.key?1:0,zT=class t{constructor({compat:e,customTags:r,merge:n,resolveKnownTags:i,schema:o,sortMapEntries:s,toStringDefaults:a}){this.compat=Array.isArray(e)?c_.getTags(e,"compat"):e?c_.getTags(null,e):null,this.name=typeof o=="string"&&o||"core",this.knownTags=i?c_.coreKnownTags:{},this.tags=c_.getTags(r,this.name,n),this.toStringOptions=a??null,Object.defineProperty(this,LT.MAP,{value:$me.map}),Object.defineProperty(this,LT.SCALAR,{value:Eme.string}),Object.defineProperty(this,LT.SEQ,{value:kme.seq}),this.sortMapEntries=typeof s=="function"?s:s===!0?Ame:null}clone(){let e=Object.create(t.prototype,Object.getOwnPropertyDescriptors(this));return e.tags=this.tags.slice(),e}};Y6.Schema=zT});var Q6=v(X6=>{"use strict";var Tme=De(),qT=mf(),xf=uf();function Ome(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=qT.createStringifyContext(t,e),{commentString:o}=i.options;if(t.commentBefore){r.length!==1&&r.unshift("");let c=o(t.commentBefore);r.unshift(xf.indentComment(c,""))}let s=!1,a=null;if(t.contents){if(Tme.isNode(t.contents)){if(t.contents.spaceBefore&&n&&r.push(""),t.contents.commentBefore){let u=o(t.contents.commentBefore);r.push(xf.indentComment(u,""))}i.forceBlockIndent=!!t.comment,a=t.contents.comment}let c=a?void 0:()=>s=!0,l=qT.stringify(t.contents,i,()=>a=null,c);a&&(l+=xf.lineComment(l,"",o(a))),(l[0]==="|"||l[0]===">")&&r[r.length-1]==="---"?r[r.length-1]=`--- ${l}`:r.push(l)}else r.push(qT.stringify(t.contents,i));if(t.directives?.docEnd)if(t.comment){let c=o(t.comment);c.includes(` +`)?(r.push("..."),r.push(xf.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(xf.indentComment(o(c),"")))}return r.join(` `)+` -`}a6.stringifyDocument=xpe});var af=v(l6=>{"use strict";var $pe=Hd(),qc=Qg(),wn=Ce(),kpe=qo(),Epe=Fo(),Ape=aT(),Tpe=c6(),lT=Kg(),Ope=pA(),Rpe=Gd(),uT=fA(),dT=class t{constructor(e,r,n){this.commentBefore=null,this.comment=null,this.errors=[],this.warnings=[],Object.defineProperty(this,wn.NODE_TYPE,{value:wn.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 uT.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,{[wn.NODE_TYPE]:{value:wn.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=wn.isNode(this.contents)?this.contents.clone(e.schema):this.contents,this.range&&(e.range=this.range.slice()),e}add(e){Bc(this.contents)&&this.contents.add(e)}addIn(e,r){Bc(this.contents)&&this.contents.addIn(e,r)}createAlias(e,r){if(!e.anchor){let n=lT.anchorNames(this);e.anchor=!r||n.has(r)?lT.findNewAnchor(r||"a",n):r}return new $pe.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}=lT.createNodeAnchors(this,s||"a"),m={aliasDuplicateObjects:o??!0,keepUndefined:c??!1,onAnchor:d,onTagObj:l,replacer:i,schema:this.schema,sourceObjects:p},h=Rpe.createNode(e,u,m);return a&&wn.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 kpe.Pair(i,o)}delete(e){return Bc(this.contents)?this.contents.delete(e):!1}deleteIn(e){return qc.isEmptyPath(e)?this.contents==null?!1:(this.contents=null,!0):Bc(this.contents)?this.contents.deleteIn(e):!1}get(e,r){return wn.isCollection(this.contents)?this.contents.get(e,r):void 0}getIn(e,r){return qc.isEmptyPath(e)?!r&&wn.isScalar(this.contents)?this.contents.value:this.contents:wn.isCollection(this.contents)?this.contents.getIn(e,r):void 0}has(e){return wn.isCollection(this.contents)?this.contents.has(e):!1}hasIn(e){return qc.isEmptyPath(e)?this.contents!==void 0:wn.isCollection(this.contents)?this.contents.hasIn(e):!1}set(e,r){this.contents==null?this.contents=qc.collectionFromPath(this.schema,[e],r):Bc(this.contents)&&this.contents.set(e,r)}setIn(e,r){qc.isEmptyPath(e)?this.contents=r:this.contents==null?this.contents=qc.collectionFromPath(this.schema,Array.from(e),r):Bc(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 uT.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 uT.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 Ape.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=Epe.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"?Ope.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 Tpe.stringifyDocument(this,e)}};function Bc(t){if(wn.isCollection(t))return!0;throw new Error("Expected a YAML collection as document contents")}l6.Document=dT});var uf=v(lf=>{"use strict";var cf=class extends Error{constructor(e,r,n,i){super(),this.name=e,this.code=n,this.message=i,this.pos=r}},fT=class extends cf{constructor(e,r,n){super("YAMLParseError",e,r,n)}},pT=class extends cf{constructor(e,r,n){super("YAMLWarning",e,r,n)}},Ipe=(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 +`}X6.stringifyDocument=Ome});var $f=v(eB=>{"use strict";var Rme=cf(),nl=Ty(),kn=De(),Ime=Jo(),Pme=Zo(),Cme=UT(),Dme=Q6(),BT=$y(),Nme=VA(),jme=lf(),HT=ZA(),GT=class t{constructor(e,r,n){this.commentBefore=null,this.comment=null,this.errors=[],this.warnings=[],Object.defineProperty(this,kn.NODE_TYPE,{value:kn.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 HT.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,{[kn.NODE_TYPE]:{value:kn.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=kn.isNode(this.contents)?this.contents.clone(e.schema):this.contents,this.range&&(e.range=this.range.slice()),e}add(e){il(this.contents)&&this.contents.add(e)}addIn(e,r){il(this.contents)&&this.contents.addIn(e,r)}createAlias(e,r){if(!e.anchor){let n=BT.anchorNames(this);e.anchor=!r||n.has(r)?BT.findNewAnchor(r||"a",n):r}return new Rme.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}=BT.createNodeAnchors(this,s||"a"),m={aliasDuplicateObjects:o??!0,keepUndefined:c??!1,onAnchor:d,onTagObj:l,replacer:i,schema:this.schema,sourceObjects:p},h=jme.createNode(e,u,m);return a&&kn.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 Ime.Pair(i,o)}delete(e){return il(this.contents)?this.contents.delete(e):!1}deleteIn(e){return nl.isEmptyPath(e)?this.contents==null?!1:(this.contents=null,!0):il(this.contents)?this.contents.deleteIn(e):!1}get(e,r){return kn.isCollection(this.contents)?this.contents.get(e,r):void 0}getIn(e,r){return nl.isEmptyPath(e)?!r&&kn.isScalar(this.contents)?this.contents.value:this.contents:kn.isCollection(this.contents)?this.contents.getIn(e,r):void 0}has(e){return kn.isCollection(this.contents)?this.contents.has(e):!1}hasIn(e){return nl.isEmptyPath(e)?this.contents!==void 0:kn.isCollection(this.contents)?this.contents.hasIn(e):!1}set(e,r){this.contents==null?this.contents=nl.collectionFromPath(this.schema,[e],r):il(this.contents)&&this.contents.set(e,r)}setIn(e,r){nl.isEmptyPath(e)?this.contents=r:this.contents==null?this.contents=nl.collectionFromPath(this.schema,Array.from(e),r):il(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 HT.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 HT.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 Cme.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=Pme.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"?Nme.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 Dme.stringifyDocument(this,e)}};function il(t){if(kn.isCollection(t))return!0;throw new Error("Expected a YAML collection as document contents")}eB.Document=GT});var Af=v(Ef=>{"use strict";var kf=class extends Error{constructor(e,r,n,i){super(),this.name=e,this.code=n,this.message=i,this.pos=r}},ZT=class extends kf{constructor(e,r,n){super("YAMLParseError",e,r,n)}},VT=class extends kf{constructor(e,r,n){super("YAMLWarning",e,r,n)}},Mme=(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} -`}};lf.YAMLError=cf;lf.YAMLParseError=fT;lf.YAMLWarning=pT;lf.prettifyError=Ipe});var df=v(u6=>{"use strict";function Ppe(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 E of t)switch(m&&(E.type!=="space"&&E.type!=="newline"&&E.type!=="comma"&&o(E.offset,"MISSING_CHAR","Tags and anchors must be separated from the next token by white space"),m=!1),h&&(l&&E.type!=="comment"&&E.type!=="newline"&&o(h,"TAB_AS_INDENT","Tabs are not allowed as indentation"),h=null),E.type){case"space":!e&&(r!=="doc-start"||n?.type!=="flow-collection")&&E.source.includes(" ")&&(h=E),u=!0;break;case"comment":{u||o(E,"MISSING_CHAR","Comments must be separated from other tokens by white space characters");let C=E.source.substring(1)||" ";d?d+=f+C:d=C,f="",l=!1;break}case"newline":l?d?d+=E.source:(!x||r!=="seq-item-ind")&&(c=!0):f+=E.source,l=!0,p=!0,(g||b)&&(_=E),u=!0;break;case"anchor":g&&o(E,"MULTIPLE_ANCHORS","A node can have at most one anchor"),E.source.endsWith(":")&&o(E.offset+E.source.length-1,"BAD_ALIAS","Anchor ending in : is ambiguous",!0),g=E,w??(w=E.offset),l=!1,u=!1,m=!0;break;case"tag":{b&&o(E,"MULTIPLE_TAGS","A node can have at most one tag"),b=E,w??(w=E.offset),l=!1,u=!1,m=!0;break}case r:(g||b)&&o(E,"BAD_PROP_ORDER",`Anchors and tags must be after the ${E.source} indicator`),x&&o(E,"UNEXPECTED_TOKEN",`Unexpected ${E.source} in ${e??"collection"}`),x=E,l=r==="seq-item-ind"||r==="explicit-key-ind",u=!1;break;case"comma":if(e){S&&o(E,"UNEXPECTED_TOKEN",`Unexpected , in ${e}`),S=E,l=!1,u=!1;break}default:o(E,"UNEXPECTED_TOKEN",`Unexpected ${E.type} token`),l=!1,u=!1}let O=t[t.length-1],A=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:A,start:w??A}}u6.resolveProps=Ppe});var Dy=v(d6=>{"use strict";function mT(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(mT(e.key)||mT(e.value))return!0}return!1;default:return!0}}d6.containsNewline=mT});var hT=v(f6=>{"use strict";var Cpe=Dy();function Dpe(t,e,r){if(e?.type==="flow-collection"){let n=e.end[0];n.indent===t&&(n.source==="]"||n.source==="}")&&Cpe.containsNewline(e)&&r(n,"BAD_INDENT","Flow end indicator should be more indented than parent",!0)}}f6.flowIndentCheck=Dpe});var gT=v(m6=>{"use strict";var p6=Ce();function Npe(t,e,r){let{uniqueKeys:n}=t.options;if(n===!1)return!1;let i=typeof n=="function"?n:(o,s)=>o===s||p6.isScalar(o)&&p6.isScalar(s)&&o.value===s.value;return e.some(o=>i(o.key,r))}m6.mapIncludes=Npe});var v6=v(b6=>{"use strict";var h6=qo(),jpe=Ho(),g6=df(),Mpe=Dy(),y6=hT(),Fpe=gT(),_6="All mapping items must start at the same column";function Lpe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??jpe.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=g6.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",_6)),!h.anchor&&!h.tag&&!p){l=h.end,h.comment&&(a.comment?a.comment+=` -`+h.comment:a.comment=h.comment);continue}(h.newlineAfterProp||Mpe.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",_6);r.atKey=!0;let b=h.end,_=f?t(r,f,h,i):e(r,b,d,null,h,i);r.schema.compat&&y6.flowIndentCheck(n.indent,f,i),r.atKey=!1,Fpe.mapIncludes(r,a.items,_)&&i(b,"DUPLICATE_KEY","Map keys must be unique");let S=g6.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 zpe=Go(),Upe=df(),qpe=hT();function Bpe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??zpe.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=Upe.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&&qpe.flowIndentCheck(n.indent,d,i),c=p.range[2],a.items.push(p)}return a.range=[n.offset,c,l??c],a}S6.resolveBlockSeq=Bpe});var Hc=v(x6=>{"use strict";function Hpe(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}}x6.resolveEnd=Hpe});var A6=v(E6=>{"use strict";var Gpe=Ce(),Zpe=qo(),$6=Ho(),Vpe=Go(),Wpe=Hc(),k6=df(),Kpe=Dy(),Jpe=gT(),yT="Block collections are not allowed within flow collections",_T=t=>t&&(t.type==="block-map"||t.type==="block-seq");function Ype({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=n.start.source==="{",a=s?"flow map":"flow sequence",c=o?.nodeClass??(s?$6.YAMLMap:Vpe.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=Wpe.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}E6.resolveFlowCollection=Ype});var O6=v(T6=>{"use strict";var Xpe=Ce(),Qpe=It(),eme=Ho(),tme=Go(),rme=v6(),nme=w6(),ime=A6();function bT(t,e,r,n,i,o){let s=r.type==="block-map"?rme.resolveBlockMap(t,e,r,n,o):r.type==="block-seq"?nme.resolveBlockSeq(t,e,r,n,o):ime.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 ome(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),bT(t,e,r,i,s)}let l=bT(t,e,r,i,s,c),u=c.resolve?.(l,f=>i(o,"TAG_RESOLVE_FAILED",f),e.options)??l,d=Xpe.isNode(u)?u:new Qpe.Scalar(u);return d.range=l.range,d.tag=s,c?.format&&(d.format=c.format),d}T6.composeCollection=ome});var ST=v(R6=>{"use strict";var vT=It();function sme(t,e,r){let n=e.offset,i=ame(e,t.options.strict,r);if(!i)return{value:"",type:null,comment:"",range:[n,n,n]};let o=i.mode===">"?vT.Scalar.BLOCK_FOLDED:vT.Scalar.BLOCK_LITERAL,s=e.source?cme(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?` +`}};Ef.YAMLError=kf;Ef.YAMLParseError=ZT;Ef.YAMLWarning=VT;Ef.prettifyError=Mme});var Tf=v(tB=>{"use strict";function Fme(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}}tB.resolveProps=Fme});var l_=v(rB=>{"use strict";function WT(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(WT(e.key)||WT(e.value))return!0}return!1;default:return!0}}rB.containsNewline=WT});var KT=v(nB=>{"use strict";var Lme=l_();function zme(t,e,r){if(e?.type==="flow-collection"){let n=e.end[0];n.indent===t&&(n.source==="]"||n.source==="}")&&Lme.containsNewline(e)&&r(n,"BAD_INDENT","Flow end indicator should be more indented than parent",!0)}}nB.flowIndentCheck=zme});var JT=v(oB=>{"use strict";var iB=De();function Ume(t,e,r){let{uniqueKeys:n}=t.options;if(n===!1)return!1;let i=typeof n=="function"?n:(o,s)=>o===s||iB.isScalar(o)&&iB.isScalar(s)&&o.value===s.value;return e.some(o=>i(o.key,r))}oB.mapIncludes=Ume});var dB=v(uB=>{"use strict";var sB=Jo(),qme=Xo(),aB=Tf(),Bme=l_(),cB=KT(),Hme=JT(),lB="All mapping items must start at the same column";function Gme({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=aB.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",lB)),!h.anchor&&!h.tag&&!p){l=h.end,h.comment&&(a.comment?a.comment+=` +`+h.comment:a.comment=h.comment);continue}(h.newlineAfterProp||Bme.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",lB);r.atKey=!0;let b=h.end,_=f?t(r,f,h,i):e(r,b,d,null,h,i);r.schema.compat&&cB.flowIndentCheck(n.indent,f,i),r.atKey=!1,Hme.mapIncludes(r,a.items,_)&&i(b,"DUPLICATE_KEY","Map keys must be unique");let S=aB.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 Zme=Qo(),Vme=Tf(),Wme=KT();function Kme({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=o?.nodeClass??Zme.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=Vme.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&&Wme.flowIndentCheck(n.indent,d,i),c=p.range[2],a.items.push(p)}return a.range=[n.offset,c,l??c],a}fB.resolveBlockSeq=Kme});var ol=v(mB=>{"use strict";function Jme(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}}mB.resolveEnd=Jme});var _B=v(yB=>{"use strict";var Yme=De(),Xme=Jo(),hB=Xo(),Qme=Qo(),ehe=ol(),gB=Tf(),the=l_(),rhe=JT(),YT="Block collections are not allowed within flow collections",XT=t=>t&&(t.type==="block-map"||t.type==="block-seq");function nhe({composeNode:t,composeEmptyNode:e},r,n,i,o){let s=n.start.source==="{",a=s?"flow map":"flow sequence",c=o?.nodeClass??(s?hB.YAMLMap:Qme.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=ehe.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}yB.resolveFlowCollection=nhe});var vB=v(bB=>{"use strict";var ihe=De(),ohe=Dt(),she=Xo(),ahe=Qo(),che=dB(),lhe=pB(),uhe=_B();function QT(t,e,r,n,i,o){let s=r.type==="block-map"?che.resolveBlockMap(t,e,r,n,o):r.type==="block-seq"?lhe.resolveBlockSeq(t,e,r,n,o):uhe.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 dhe(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),QT(t,e,r,i,s)}let l=QT(t,e,r,i,s,c),u=c.resolve?.(l,f=>i(o,"TAG_RESOLVE_FAILED",f),e.options)??l,d=ihe.isNode(u)?u:new ohe.Scalar(u);return d.range=l.range,d.tag=s,c?.format&&(d.format=c.format),d}bB.composeCollection=dhe});var tO=v(SB=>{"use strict";var eO=Dt();function fhe(t,e,r){let n=e.offset,i=phe(e,t.options.strict,r);if(!i)return{value:"",type:null,comment:"",range:[n,n,n]};let o=i.mode===">"?eO.Scalar.BLOCK_FOLDED:eO.Scalar.BLOCK_LITERAL,s=e.source?mhe(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=` `:!p&&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 ame({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 wT=It(),lme=Hc();function ume(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=wT.Scalar.PLAIN,c=dme(o,l);break;case"single-quoted-scalar":a=wT.Scalar.QUOTE_SINGLE,c=fme(o,l);break;case"double-quoted-scalar":a=wT.Scalar.QUOTE_DOUBLE,c=pme(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=lme.resolveEnd(s,u,e,r);return{value:c,type:a,comment:d.comment,range:[n,u,d.offset]}}function dme(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}`),I6(t)}function fme(t,e){return(t[t.length-1]!=="'"||t.length===1)&&e(t.length,"MISSING_CHAR","Missing closing 'quote"),I6(t.slice(1,-1)).replace(/''/g,"'")}function I6(t){let e,r;try{e=new RegExp(`(.*?)(?{"use strict";var rO=Dt(),hhe=ol();function ghe(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=rO.Scalar.PLAIN,c=yhe(o,l);break;case"single-quoted-scalar":a=rO.Scalar.QUOTE_SINGLE,c=_he(o,l);break;case"double-quoted-scalar":a=rO.Scalar.QUOTE_DOUBLE,c=bhe(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=hhe.resolveEnd(s,u,e,r);return{value:c,type:a,comment:d.comment,range:[n,u,d.offset]}}function yhe(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}`),wB(t)}function _he(t,e){return(t[t.length-1]!=="'"||t.length===1)&&e(t.length,"MISSING_CHAR","Missing closing 'quote"),wB(t.slice(1,-1)).replace(/''/g,"'")}function wB(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 mme(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 vhe(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 hme={0:"\0",a:"\x07",b:"\b",e:"\x1B",f:"\f",n:` -`,r:"\r",t:" ",v:"\v",N:"\x85",_:"\xA0",L:"\u2028",P:"\u2029"," ":" ",'"':'"',"/":"/","\\":"\\"," ":" "};function gme(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}}P6.resolveFlowScalar=ume});var N6=v(D6=>{"use strict";var oa=Ce(),C6=It(),yme=ST(),_me=xT();function bme(t,e,r,n){let{value:i,type:o,comment:s,range:a}=e.type==="block-scalar"?yme.resolveBlockScalar(t,e,n):_me.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[oa.SCALAR]:c?l=vme(t.schema,i,c,r,n):e.type==="scalar"?l=Sme(t,i,e,n):l=t.schema[oa.SCALAR];let u;try{let d=l.resolve(i,f=>n(r??e,"TAG_RESOLVE_FAILED",f),t.options);u=oa.isScalar(d)?d:new C6.Scalar(d)}catch(d){let f=d instanceof Error?d.message:String(d);n(r??e,"TAG_RESOLVE_FAILED",f),u=new C6.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 vme(t,e,r,n,i){if(r==="!")return t[oa.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[oa.SCALAR])}function Sme({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[oa.SCALAR];if(r.compat){let a=r.compat.find(c=>c.default&&c.test?.test(n))??r[oa.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}D6.composeScalar=bme});var M6=v(j6=>{"use strict";function wme(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}j6.emptyScalarPosition=wme});var z6=v(kT=>{"use strict";var xme=Hd(),$me=Ce(),kme=O6(),F6=N6(),Eme=Hc(),Ame=M6(),Tme={composeNode:L6,composeEmptyNode:$T};function L6(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=Ome(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=F6.composeScalar(t,e,c,n),a&&(l.anchor=a.source.substring(1));break;case"block-map":case"block-seq":case"flow-collection":try{l=kme.composeCollection(Tme,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=$T(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&&(!$me.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 $T(t,e,r,n,{spaceBefore:i,comment:o,anchor:s,tag:a,end:c},l){let u={type:"scalar",offset:Ame.emptyScalarPosition(e,r,n),indent:-1,source:""},d=F6.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 Ome({options:t},{offset:e,source:r,end:n},i){let o=new xme.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=Eme.resolveEnd(n,s,t.strict,i);return o.range=[e,s,a.offset],a.comment&&(o.comment=a.comment),o}kT.composeEmptyNode=$T;kT.composeNode=L6});var B6=v(q6=>{"use strict";var Rme=af(),U6=z6(),Ime=Hc(),Pme=df();function Cme(t,e,{offset:r,start:n,value:i,end:o},s){let a=Object.assign({_directives:e},t),c=new Rme.Document(void 0,a),l={atKey:!1,atRoot:!0,directives:c.directives,options:c.options,schema:c.schema},u=Pme.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?U6.composeNode(l,i,u,s):U6.composeEmptyNode(l,u.end,n,null,u,s);let d=c.contents.range[2],f=Ime.resolveEnd(o,d,!1,s);return f.comment&&(c.comment=f.comment),c.range=[r,d,f.offset],c}q6.composeDoc=Cme});var AT=v(Z6=>{"use strict";var Dme=He("process"),Nme=fA(),jme=af(),ff=uf(),H6=Ce(),Mme=B6(),Fme=Hc();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 G6(t){let e="",r=!1,n=!1;for(let i=0;i{"use strict";var ha=De(),$B=Dt(),xhe=tO(),$he=nO();function khe(t,e,r,n){let{value:i,type:o,comment:s,range:a}=e.type==="block-scalar"?xhe.resolveBlockScalar(t,e,n):$he.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=Ehe(t.schema,i,c,r,n):e.type==="scalar"?l=Ahe(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 $B.Scalar(d)}catch(d){let f=d instanceof Error?d.message:String(d);n(r??e,"TAG_RESOLVE_FAILED",f),u=new $B.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 Ehe(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 Ahe({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}kB.composeScalar=khe});var TB=v(AB=>{"use strict";function The(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}AB.emptyScalarPosition=The});var IB=v(oO=>{"use strict";var Ohe=cf(),Rhe=De(),Ihe=vB(),OB=EB(),Phe=ol(),Che=TB(),Dhe={composeNode:RB,composeEmptyNode:iO};function RB(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=Nhe(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=OB.composeScalar(t,e,c,n),a&&(l.anchor=a.source.substring(1));break;case"block-map":case"block-seq":case"flow-collection":try{l=Ihe.composeCollection(Dhe,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=iO(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&&(!Rhe.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 iO(t,e,r,n,{spaceBefore:i,comment:o,anchor:s,tag:a,end:c},l){let u={type:"scalar",offset:Che.emptyScalarPosition(e,r,n),indent:-1,source:""},d=OB.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 Nhe({options:t},{offset:e,source:r,end:n},i){let o=new Ohe.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=Phe.resolveEnd(n,s,t.strict,i);return o.range=[e,s,a.offset],a.comment&&(o.comment=a.comment),o}oO.composeEmptyNode=iO;oO.composeNode=RB});var DB=v(CB=>{"use strict";var jhe=$f(),PB=IB(),Mhe=ol(),Fhe=Tf();function Lhe(t,e,{offset:r,start:n,value:i,end:o},s){let a=Object.assign({_directives:e},t),c=new jhe.Document(void 0,a),l={atKey:!1,atRoot:!0,directives:c.directives,options:c.options,schema:c.schema},u=Fhe.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?PB.composeNode(l,i,u,s):PB.composeEmptyNode(l,u.end,n,null,u,s);let d=c.contents.range[2],f=Mhe.resolveEnd(o,d,!1,s);return f.comment&&(c.comment=f.comment),c.range=[r,d,f.offset],c}CB.composeDoc=Lhe});var aO=v(MB=>{"use strict";var zhe=Ge("process"),Uhe=ZA(),qhe=$f(),Of=Af(),NB=De(),Bhe=DB(),Hhe=ol();function Rf(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 jB(t){let e="",r=!1,n=!1;for(let i=0;i{let s=pf(r);o?this.warnings.push(new ff.YAMLWarning(s,n,i)):this.errors.push(new ff.YAMLParseError(s,n,i))},this.directives=new Nme.Directives({version:e.version||"1.2"}),this.options=e}decorate(e,r){let{comment:n,afterEmptyLine:i}=G6(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(H6.isCollection(o)&&!o.flow&&o.items.length>0){let s=o.items[0];H6.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 sO=class{constructor(e={}){this.doc=null,this.atDirectives=!1,this.prelude=[],this.errors=[],this.warnings=[],this.onError=(r,n,i,o)=>{let s=Rf(r);o?this.warnings.push(new Of.YAMLWarning(s,n,i)):this.errors.push(new Of.YAMLParseError(s,n,i))},this.directives=new Uhe.Directives({version:e.version||"1.2"}),this.options=e}decorate(e,r){let{comment:n,afterEmptyLine:i}=jB(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(NB.isCollection(o)&&!o.flow&&o.items.length>0){let s=o.items[0];NB.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=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=Mme.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 ff.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 ff.YAMLParseError(pf(e),"UNEXPECTED_TOKEN",n));break}this.doc.directives.docEnd=!0;let r=Fme.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 ff.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 jme.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}}};Z6.Composer=ET});var K6=v(Ny=>{"use strict";var Lme=ST(),zme=xT(),Ume=uf(),V6=Kd();function qme(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 Ume.YAMLParseError([a,a+1],o,s)};switch(t.type){case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return zme.resolveFlowScalar(t,e,n);case"block-scalar":return Lme.resolveBlockScalar({options:{strict:e}},t,n)}}return null}function Bme(t,e){let{implicitKey:r=!1,indent:n,inFlow:i=!1,offset:o=-1,type:s="PLAIN"}=e,a=V6.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=Rf(e);o[0]+=r,this.onError(o,"BAD_DIRECTIVE",n,i)}),this.prelude.push(e.source),this.atDirectives=!0;break;case"document":{let r=Bhe.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 Of.YAMLParseError(Rf(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 Of.YAMLParseError(Rf(e),"UNEXPECTED_TOKEN",n));break}this.doc.directives.docEnd=!0;let r=Hhe.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 Of.YAMLParseError(Rf(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}}};MB.Composer=sO});var zB=v(u_=>{"use strict";var Ghe=tO(),Zhe=nO(),Vhe=Af(),FB=pf();function Whe(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 Vhe.YAMLParseError([a,a+1],o,s)};switch(t.type){case"scalar":case"single-quoted-scalar":case"double-quoted-scalar":return Zhe.resolveFlowScalar(t,e,n);case"block-scalar":return Ghe.resolveBlockScalar({options:{strict:e}},t,n)}}return null}function Khe(t,e){let{implicitKey:r=!1,indent:n,inFlow:i=!1,offset:o=-1,type:s="PLAIN"}=e,a=FB.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 W6(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 Hme(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=V6.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">":Gme(t,c);break;case'"':TT(t,c,"double-quoted-scalar");break;case"'":TT(t,c,"single-quoted-scalar");break;default:TT(t,c,"scalar")}}function Gme(t,e){let r=e.indexOf(` +`,f=[{type:"block-scalar-header",offset:o,indent:n,source:u}];return LB(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 Jhe(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=FB.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">":Yhe(t,c);break;case'"':cO(t,c,"double-quoted-scalar");break;case"'":cO(t,c,"single-quoted-scalar");break;default:cO(t,c,"scalar")}}function Yhe(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}];W6(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 W6(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 TT(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})}}}Ny.createScalarToken=Bme;Ny.resolveAsScalar=qme;Ny.setScalarValue=Hme});var Y6=v(J6=>{"use strict";var Zme=t=>"type"in t?My(t):jy(t);function My(t){switch(t.type){case"block-scalar":{let e="";for(let r of t.props)e+=My(r);return e+t.source}case"block-map":case"block-seq":{let e="";for(let r of t.items)e+=jy(r);return e}case"flow-collection":{let e=t.start.source;for(let r of t.items)e+=jy(r);for(let r of t.end)e+=r.source;return e}case"document":{let e=jy(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 jy({start:t,key:e,sep:r,value:n}){let i="";for(let o of t)i+=o.source;if(e&&(i+=My(e)),r)for(let o of r)i+=o.source;return n&&(i+=My(n)),i}J6.stringify=Zme});var tB=v(eB=>{"use strict";var OT=Symbol("break visit"),Vme=Symbol("skip children"),X6=Symbol("remove item");function sa(t,e){"type"in t&&t.type==="document"&&(t={start:t.start,value:t.value}),Q6(Object.freeze([]),t,e)}sa.BREAK=OT;sa.SKIP=Vme;sa.REMOVE=X6;sa.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};sa.parentCollection=(t,e)=>{let r=sa.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 Q6(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 RT=K6(),Wme=Y6(),Kme=tB(),IT="\uFEFF",PT="",CT="",DT="",Jme=t=>!!t&&"items"in t,Yme=t=>!!t&&(t.type==="scalar"||t.type==="single-quoted-scalar"||t.type==="double-quoted-scalar"||t.type==="block-scalar");function Xme(t){switch(t){case IT:return"";case PT:return"";case CT:return"";case DT:return"";default:return JSON.stringify(t)}}function Qme(t){switch(t){case IT:return"byte-order-mark";case PT:return"doc-mode";case CT:return"flow-error-end";case DT: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}];LB(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 LB(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 cO(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})}}}u_.createScalarToken=Khe;u_.resolveAsScalar=Whe;u_.setScalarValue=Jhe});var qB=v(UB=>{"use strict";var Xhe=t=>"type"in t?f_(t):d_(t);function f_(t){switch(t.type){case"block-scalar":{let e="";for(let r of t.props)e+=f_(r);return e+t.source}case"block-map":case"block-seq":{let e="";for(let r of t.items)e+=d_(r);return e}case"flow-collection":{let e=t.start.source;for(let r of t.items)e+=d_(r);for(let r of t.end)e+=r.source;return e}case"document":{let e=d_(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 d_({start:t,key:e,sep:r,value:n}){let i="";for(let o of t)i+=o.source;if(e&&(i+=f_(e)),r)for(let o of r)i+=o.source;return n&&(i+=f_(n)),i}UB.stringify=Xhe});var ZB=v(GB=>{"use strict";var lO=Symbol("break visit"),Qhe=Symbol("skip children"),BB=Symbol("remove item");function ga(t,e){"type"in t&&t.type==="document"&&(t={start:t.start,value:t.value}),HB(Object.freeze([]),t,e)}ga.BREAK=lO;ga.SKIP=Qhe;ga.REMOVE=BB;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 HB(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 uO=zB(),ege=qB(),tge=ZB(),dO="\uFEFF",fO="",pO="",mO="",rge=t=>!!t&&"items"in t,nge=t=>!!t&&(t.type==="scalar"||t.type==="single-quoted-scalar"||t.type==="double-quoted-scalar"||t.type==="block-scalar");function ige(t){switch(t){case dO:return"";case fO:return"";case pO:return"";case mO:return"";default:return JSON.stringify(t)}}function oge(t){switch(t){case dO:return"byte-order-mark";case fO:return"doc-mode";case pO:return"flow-error-end";case mO: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}Cr.createScalarToken=RT.createScalarToken;Cr.resolveAsScalar=RT.resolveAsScalar;Cr.setScalarValue=RT.setScalarValue;Cr.stringify=Wme.stringify;Cr.visit=Kme.visit;Cr.BOM=IT;Cr.DOCUMENT=PT;Cr.FLOW_END=CT;Cr.SCALAR=DT;Cr.isCollection=Jme;Cr.isScalar=Yme;Cr.prettyToken=Xme;Cr.tokenType=Qme});var MT=v(nB=>{"use strict";var mf=Fy();function Gn(t){switch(t){case void 0:case" ":case` -`:case"\r":case" ":return!0;default:return!1}}var rB=new Set("0123456789ABCDEFabcdef"),ehe=new Set("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-#;/?:@&=+$_.!~*'()"),Ly=new Set(",[]{}"),the=new Set(` ,[]{} -\r `),NT=t=>!t||the.has(t),jT=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}Dr.createScalarToken=uO.createScalarToken;Dr.resolveAsScalar=uO.resolveAsScalar;Dr.setScalarValue=uO.setScalarValue;Dr.stringify=ege.stringify;Dr.visit=tge.visit;Dr.BOM=dO;Dr.DOCUMENT=fO;Dr.FLOW_END=pO;Dr.SCALAR=mO;Dr.isCollection=rge;Dr.isScalar=nge;Dr.prettyToken=ige;Dr.tokenType=oge});var yO=v(WB=>{"use strict";var If=p_();function Kn(t){switch(t){case void 0:case" ":case` +`:case"\r":case" ":return!0;default:return!1}}var VB=new Set("0123456789ABCDEFabcdef"),sge=new Set("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-#;/?:@&=+$_.!~*'()"),m_=new Set(",[]{}"),age=new Set(` ,[]{} +\r `),hO=t=>!t||age.has(t),gO=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==="...")&&Gn(this.buffer[e+3]))return-1}return e}getLine(){let e=this.lineEndPos;return(typeof e!="number"||e!==-1&&ethis.indentValue&&!Gn(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===":")&&Gn(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(NT),"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==="...")&&Kn(this.buffer[e+3]))return-1}return e}getLine(){let e=this.lineEndPos;return(typeof e!="number"||e!==-1&&ethis.indentValue&&!Kn(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===":")&&Kn(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(hO),"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=>Gn(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=>Kn(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 mf.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(Gn(o)||e&&Ly.has(o))break;r=n}else if(Gn(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 If.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(Kn(o)||e&&m_.has(o))break;r=n}else if(Kn(i)){let o=this.buffer[n+1];if(i==="\r"&&(o===` `?(n+=1,i=` -`,o=this.buffer[n+1]):r=n),o==="#"||e&&Ly.has(o))break;if(i===` -`){let s=this.continueScalar(n+1);if(s===-1)break;n=Math.max(n,s-2)}}else{if(e&&Ly.has(i))break;r=n}return!i&&!this.atEnd?this.setNext("plain-scalar"):(yield mf.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(NT),e+=yield*this.pushSpaces(!0);continue e;case"-":case"?":case":":{let r=this.flowLevel>0,n=this.charAt(1);if(Gn(n)||r&&Ly.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(;!Gn(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(ehe.has(r))r=this.buffer[++e];else if(r==="%"&&rB.has(this.buffer[e+1])&&rB.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===` +`,o=this.buffer[n+1]):r=n),o==="#"||e&&m_.has(o))break;if(i===` +`){let s=this.continueScalar(n+1);if(s===-1)break;n=Math.max(n,s-2)}}else{if(e&&m_.has(i))break;r=n}return!i&&!this.atEnd?this.setNext("plain-scalar"):(yield If.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(hO),e+=yield*this.pushSpaces(!0);continue e;case"-":case"?":case":":{let r=this.flowLevel>0,n=this.charAt(1);if(Kn(n)||r&&m_.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(;!Kn(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(sge.has(r))r=this.buffer[++e];else if(r==="%"&&VB.has(this.buffer[e+1])&&VB.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)}};nB.Lexer=jT});var LT=v(iB=>{"use strict";var FT=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 rhe=He("process"),oB=Fy(),nhe=MT();function Zo(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 Uy(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"&&aB(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&&sB(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)}};WB.Lexer=gO});var bO=v(KB=>{"use strict";var _O=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 cge=Ge("process"),JB=p_(),lge=yO();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 g_(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"&&XB(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&&YB(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(Zo(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(cB(r.key)&&!Zo(r.sep,"newline")){let s=Gc(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(Zo(r.start,"newline"))Object.assign(r,{key:null,sep:[this.sourceToken]});else{let s=Gc(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]}):Zo(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&&!Zo(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)){Uy(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||Zo(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=zy(n),o=Gc(i);aB(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)){g_(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(QB(r.key)&&!es(r.sep,"newline")){let s=sl(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=sl(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)){g_(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=h_(n),o=sl(i);XB(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=zy(e),n=Gc(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=zy(e),n=Gc(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())}}};lB.Parser=zT});var mB=v(gf=>{"use strict";var uB=AT(),ihe=af(),hf=uf(),ohe=kA(),she=Ce(),ahe=LT(),dB=UT();function fB(t){let e=t.prettyErrors!==!1;return{lineCounter:t.lineCounter||e&&new ahe.LineCounter||null,prettyErrors:e}}function che(t,e={}){let{lineCounter:r,prettyErrors:n}=fB(e),i=new dB.Parser(r?.addNewLine),o=new uB.Composer(e),s=Array.from(o.compose(i.parse(t)));if(n&&r)for(let a of s)a.errors.forEach(hf.prettifyError(t,r)),a.warnings.forEach(hf.prettifyError(t,r));return s.length>0?s:Object.assign([],{empty:!0},o.streamInfo())}function pB(t,e={}){let{lineCounter:r,prettyErrors:n}=fB(e),i=new dB.Parser(r?.addNewLine),o=new uB.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 hf.YAMLParseError(a.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}return n&&r&&(s.errors.forEach(hf.prettifyError(t,r)),s.warnings.forEach(hf.prettifyError(t,r))),s}function lhe(t,e,r){let n;typeof e=="function"?n=e:r===void 0&&e&&typeof e=="object"&&(r=e);let i=pB(t,r);if(!i)return null;if(i.warnings.forEach(o=>ohe.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 uhe(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 she.isDocument(t)&&!n?t.toString(r):new ihe.Document(t,n,r).toString(r)}gf.parse=lhe;gf.parseAllDocuments=che;gf.parseDocument=pB;gf.stringify=uhe});var cr=v(Ge=>{"use strict";var dhe=AT(),fhe=af(),phe=aT(),qT=uf(),mhe=Hd(),Vo=Ce(),hhe=qo(),ghe=It(),yhe=Ho(),_he=Go(),bhe=Fy(),vhe=MT(),She=LT(),whe=UT(),qy=mB(),hB=zd();Ge.Composer=dhe.Composer;Ge.Document=fhe.Document;Ge.Schema=phe.Schema;Ge.YAMLError=qT.YAMLError;Ge.YAMLParseError=qT.YAMLParseError;Ge.YAMLWarning=qT.YAMLWarning;Ge.Alias=mhe.Alias;Ge.isAlias=Vo.isAlias;Ge.isCollection=Vo.isCollection;Ge.isDocument=Vo.isDocument;Ge.isMap=Vo.isMap;Ge.isNode=Vo.isNode;Ge.isPair=Vo.isPair;Ge.isScalar=Vo.isScalar;Ge.isSeq=Vo.isSeq;Ge.Pair=hhe.Pair;Ge.Scalar=ghe.Scalar;Ge.YAMLMap=yhe.YAMLMap;Ge.YAMLSeq=_he.YAMLSeq;Ge.CST=bhe;Ge.Lexer=vhe.Lexer;Ge.LineCounter=She.LineCounter;Ge.Parser=whe.Parser;Ge.parse=qy.parse;Ge.parseAllDocuments=qy.parseAllDocuments;Ge.parseDocument=qy.parseDocument;Ge.stringify=qy.stringify;Ge.visit=hB.visit;Ge.visitAsync=hB.visitAsync});import{execFileSync as gB}from"node:child_process";import{existsSync as By}from"node:fs";import{join as Hy,resolve as xhe}from"node:path";function $he(t){try{let e=gB("git",["rev-parse","--git-dir"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return e?xhe(t,e):null}catch{return null}}function BT(t){let e=$he(t);if(!e)return null;try{if(By(Hy(e,"MERGE_HEAD")))return"merge";if(By(Hy(e,"CHERRY_PICK_HEAD")))return"cherry-pick";if(By(Hy(e,"rebase-merge"))||By(Hy(e,"rebase-apply")))return"rebase"}catch{return null}return null}function aa(t){return BT(t)!==null}function HT(t,e){try{let r=gB("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 Gy(t,e){return HT(t,e)!==null}var ca=y(()=>{"use strict"});import{execFileSync as khe}from"node:child_process";import{existsSync as Ehe,readFileSync as Ahe}from"node:fs";import{join as bB}from"node:path";function yf(t,e){return khe("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function Wo(t){try{let e=yf(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 Ko(t,e){The(t,e);let r=yf(t,["rev-parse","HEAD"]).trim(),n=Ohe(t,e);return{groups:Rhe(t,n),head:r,inventory:{after:_B(Vy(t,"spec.yaml")),before:_B(GT(t,e,"spec.yaml"))},since:e,unsharded_commits:Dhe(t,e)}}function ZT(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 The(t,e){let r=(e??"").trim();if(r.length===0)throw new Error("changelog: empty since ref \u2014 pass --since ");if(!Gy(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 Ohe(t,e){let r=yf(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(!(!yB(c)&&!yB(a)))if(s.startsWith("A")){let l=Zy(Vy(t,c));if(!l)continue;l.status==="done"?n.push(Zc(l,"added-as-done")):l.status==="archived"&&n.push(Zc(l,"archived"))}else if(s.startsWith("D")){let l=Zy(GT(t,e,a));l&&n.push(Zc(l,"archived"))}else{let l=Zy(Vy(t,c));if(!l)continue;let d=Zy(GT(t,e,a))?.status;l.status==="done"&&d!=="done"?n.push(Zc(l,"flipped-to-done")):l.status==="done"&&d==="done"?n.push(Zc(l,"modified-while-done")):l.status==="archived"&&d!=="archived"&&n.push(Zc(l,"archived"))}}return n.sort((i,o)=>i.id.localeCompare(o.id)),n}function yB(t){return t.startsWith("spec/features/")&&(t.endsWith(".yaml")||t.endsWith(".yml"))}function Zc(t,e){return{acceptance:(t.acceptance_criteria??[]).map(n=>ZT(n)).filter(n=>n!==null),change:e,id:t.id,...t.slug?{slug:t.slug}:{},title:t.title}}function Zy(t){if(t===null)return null;let e;try{e=(0,Wy.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 Vy(t,e){let r=bB(t,e);if(!Ehe(r))return null;try{return Ahe(r,"utf8")}catch{return null}}function GT(t,e,r){try{return yf(t,["show",`${e}:${r}`])}catch{return null}}function Rhe(t,e){let r=Ihe(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 Ihe(t){let e=Vy(t,bB("spec","capabilities.yaml"));if(e===null)return[];try{let r=(0,Wy.parse)(e);return Array.isArray(r?.capabilities)?r.capabilities:[]}catch{return[]}}function _B(t){let e={};if(t!==null)try{let n=(0,Wy.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 Dhe(t,e){let r=yf(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);Phe.test(a)&&(Che.test(a)||n.push({hash:s,subject:a}))}return n}var Wy,Phe,Che,Vc=y(()=>{"use strict";Wy=Et(cr(),1);ca();Phe=/^(feat|fix)(\([^)]*\))?!?:/,Che=/\bF-(\d{3,}|[a-f0-9]{6,})\b/});import{execFileSync as vB}from"node:child_process";import{appendFileSync as Nhe,existsSync as VT,mkdirSync as jhe,readFileSync as Mhe,renameSync as Fhe,statSync as Lhe}from"node:fs";import{userInfo as zhe}from"node:os";import{dirname as Uhe,join as KT}from"node:path";function JT(t){return KT(t,SB,qhe)}function Yr(t,e){let r=JT(t),n=Uhe(r);VT(n)||jhe(n,{recursive:!0});try{VT(r)&&Lhe(r).size>Bhe&&Fhe(r,KT(n,wB))}catch{}Nhe(r,`${JSON.stringify(e)} -`,"utf8")}function WT(t){if(!VT(t))return[];let e=Mhe(t,"utf8").trim();return e.length===0?[]:e.split(` -`).filter(r=>r.length>0).map(r=>JSON.parse(r))}function la(t){return WT(JT(t))}function Ky(t){return[...WT(KT(t,SB,wB)),...WT(JT(t))]}function Xr(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 Hhe(t){let e;try{e=vB("git",["config","user.name"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{}if(!e)try{e=zhe().username}catch{e=void 0}return{author:"human",name:e,timestamp:new Date().toISOString()}}function Ghe(t){try{return vB("git",["rev-parse","HEAD"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()}catch{return}}function _f(t,e){try{let r=la(t);for(let n=r.length-1;n>=0;n--)if(r[n].type===e)return r[n]}catch{}return null}function lr(t,e,r){try{let n=Ghe(t),i=Hhe(t),o={...r,head:n,identity:i};if(e==="gate_run"){let s=_f(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}Yr(t,Xr(e,o))}catch{}}var SB,qhe,wB,Bhe,Dr=y(()=>{"use strict";SB=".cladding",qhe="events.log.jsonl",wB="events.log.1.jsonl",Bhe=5*1024*1024});import{execFileSync as Zhe}from"node:child_process";import{existsSync as xB,readdirSync as Vhe,readFileSync as Whe,statSync as $B}from"node:fs";import{createHash as Khe}from"node:crypto";import{join as YT}from"node:path";function ua(t){try{return Zhe("git",["rev-parse","HEAD"],{cwd:t,stdio:["ignore","pipe","ignore"]}).toString("utf8").trim()||null}catch{return null}}function XT(t){let e=[],r=YT(t,"spec.yaml");xB(r)&&$B(r).isFile()&&e.push(r);for(let i of["features","scenarios"]){let o=YT(t,"spec",i);if(!(!xB(o)||!$B(o).isDirectory()))for(let s of Vhe(o))s.endsWith(".yaml")&&e.push(YT(o,s))}e.sort();let n=Khe("sha256");for(let i of e){let o=i.slice(t.length+1);n.update(`${o}\0`),n.update(Whe(i)),n.update("\0")}return n.digest("hex")}function Jy(t,e){let r={featureId:e,gitHead:ua(t),specDigest:XT(t),timestamp:new Date().toISOString()};return Yr(t,Xr("feature_checkpoint",{feature:e,git_head:r.gitHead,spec_digest:r.specDigest})),r}function Yy(t,e){let r=la(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 Xy(t,e,r,n){let i=Xr("feature_rolled_back",{feature:e,to_git_head:r.gitHead,to_spec_digest:r.specDigest,to_checkpoint_at:r.timestamp,reason:n??null});return Yr(t,i),i}var bf=y(()=>{"use strict";Dr()});import{readFileSync as Jhe,statSync as Yhe}from"node:fs";import{extname as Xhe,resolve as QT,sep as Qhe}from"node:path";function Qr(t){return Math.ceil(t.length/4)}function rge(t,e){let r=QT(e),n=QT(r,t);return n===r||n.startsWith(r+Qhe)}function EB(t,e,r,n){if(!rge(t,e))return{path:t,omitted:"unsafe-path"};if(!ege.has(Xhe(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>kB)return{path:t,omitted:"too-large",bytes:o}}else{let l=QT(e,t);try{o=Yhe(l).size}catch{return{path:t,omitted:"missing"}}if(o>kB)return{path:t,omitted:"too-large",bytes:o};try{i=Jhe(l,"utf8")}catch{return{path:t,omitted:"missing",bytes:o}}}if(i.includes(tge))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=h_(e),n=sl(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=h_(e),n=sl(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())}}};eH.Parser=vO});var oH=v(Cf=>{"use strict";var tH=aO(),uge=$f(),Pf=Af(),dge=oT(),fge=De(),pge=bO(),rH=SO();function nH(t){let e=t.prettyErrors!==!1;return{lineCounter:t.lineCounter||e&&new pge.LineCounter||null,prettyErrors:e}}function mge(t,e={}){let{lineCounter:r,prettyErrors:n}=nH(e),i=new rH.Parser(r?.addNewLine),o=new tH.Composer(e),s=Array.from(o.compose(i.parse(t)));if(n&&r)for(let a of s)a.errors.forEach(Pf.prettifyError(t,r)),a.warnings.forEach(Pf.prettifyError(t,r));return s.length>0?s:Object.assign([],{empty:!0},o.streamInfo())}function iH(t,e={}){let{lineCounter:r,prettyErrors:n}=nH(e),i=new rH.Parser(r?.addNewLine),o=new tH.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 Pf.YAMLParseError(a.range.slice(0,2),"MULTIPLE_DOCS","Source contains multiple documents; please use YAML.parseAllDocuments()"));break}return n&&r&&(s.errors.forEach(Pf.prettifyError(t,r)),s.warnings.forEach(Pf.prettifyError(t,r))),s}function hge(t,e,r){let n;typeof e=="function"?n=e:r===void 0&&e&&typeof e=="object"&&(r=e);let i=iH(t,r);if(!i)return null;if(i.warnings.forEach(o=>dge.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 gge(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 fge.isDocument(t)&&!n?t.toString(r):new uge.Document(t,n,r).toString(r)}Cf.parse=hge;Cf.parseAllDocuments=mge;Cf.parseDocument=iH;Cf.stringify=gge});var Qt=v(Ze=>{"use strict";var yge=aO(),_ge=$f(),bge=UT(),wO=Af(),vge=cf(),ts=De(),Sge=Jo(),wge=Dt(),xge=Xo(),$ge=Qo(),kge=p_(),Ege=yO(),Age=bO(),Tge=SO(),y_=oH(),sH=nf();Ze.Composer=yge.Composer;Ze.Document=_ge.Document;Ze.Schema=bge.Schema;Ze.YAMLError=wO.YAMLError;Ze.YAMLParseError=wO.YAMLParseError;Ze.YAMLWarning=wO.YAMLWarning;Ze.Alias=vge.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=Sge.Pair;Ze.Scalar=wge.Scalar;Ze.YAMLMap=xge.YAMLMap;Ze.YAMLSeq=$ge.YAMLSeq;Ze.CST=kge;Ze.Lexer=Ege.Lexer;Ze.LineCounter=Age.LineCounter;Ze.Parser=Tge.Parser;Ze.parse=y_.parse;Ze.parseAllDocuments=y_.parseAllDocuments;Ze.parseDocument=y_.parseDocument;Ze.stringify=y_.stringify;Ze.visit=sH.visit;Ze.visitAsync=sH.visitAsync});import{execFileSync as aH}from"node:child_process";import{existsSync as __}from"node:fs";import{join as b_,resolve as Oge}from"node:path";function Rge(t){try{let e=aH("git",["rev-parse","--git-dir"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return e?Oge(t,e):null}catch{return null}}function xO(t){let e=Rge(t);if(!e)return null;try{if(__(b_(e,"MERGE_HEAD")))return"merge";if(__(b_(e,"CHERRY_PICK_HEAD")))return"cherry-pick";if(__(b_(e,"rebase-merge"))||__(b_(e,"rebase-apply")))return"rebase"}catch{return null}return null}function ya(t){return xO(t)!==null}function $O(t,e){try{let r=aH("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 v_(t,e){return $O(t,e)!==null}var _a=y(()=>{"use strict"});import{execFileSync as Ige}from"node:child_process";import{existsSync as Pge,readFileSync as Cge}from"node:fs";import{join as uH}from"node:path";function Df(t,e){return Ige("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function rs(t){try{let e=Df(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){Dge(t,e);let r=Df(t,["rev-parse","HEAD"]).trim(),n=Nge(t,e);return{groups:jge(t,n),head:r,inventory:{after:lH(w_(t,"spec.yaml")),before:lH(kO(t,e,"spec.yaml"))},since:e,unsharded_commits:zge(t,e)}}function EO(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 Dge(t,e){let r=(e??"").trim();if(r.length===0)throw new Error("changelog: empty since ref \u2014 pass --since ");if(!v_(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 Nge(t,e){let r=Df(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(!(!cH(c)&&!cH(a)))if(s.startsWith("A")){let l=S_(w_(t,c));if(!l)continue;l.status==="done"?n.push(al(l,"added-as-done")):l.status==="archived"&&n.push(al(l,"archived"))}else if(s.startsWith("D")){let l=S_(kO(t,e,a));l&&n.push(al(l,"archived"))}else{let l=S_(w_(t,c));if(!l)continue;let d=S_(kO(t,e,a))?.status;l.status==="done"&&d!=="done"?n.push(al(l,"flipped-to-done")):l.status==="done"&&d==="done"?n.push(al(l,"modified-while-done")):l.status==="archived"&&d!=="archived"&&n.push(al(l,"archived"))}}return n.sort((i,o)=>i.id.localeCompare(o.id)),n}function cH(t){return t.startsWith("spec/features/")&&(t.endsWith(".yaml")||t.endsWith(".yml"))}function al(t,e){return{acceptance:(t.acceptance_criteria??[]).map(n=>EO(n)).filter(n=>n!==null),change:e,id:t.id,...t.slug?{slug:t.slug}:{},title:t.title}}function S_(t){if(t===null)return null;let e;try{e=(0,x_.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 w_(t,e){let r=uH(t,e);if(!Pge(r))return null;try{return Cge(r,"utf8")}catch{return null}}function kO(t,e,r){try{return Df(t,["show",`${e}:${r}`])}catch{return null}}function jge(t,e){let r=Mge(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 Mge(t){let e=w_(t,uH("spec","capabilities.yaml"));if(e===null)return[];try{let r=(0,x_.parse)(e);return Array.isArray(r?.capabilities)?r.capabilities:[]}catch{return[]}}function lH(t){let e={};if(t!==null)try{let n=(0,x_.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 zge(t,e){let r=Df(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);Fge.test(a)&&(Lge.test(a)||n.push({hash:s,subject:a}))}return n}var x_,Fge,Lge,cl=y(()=>{"use strict";x_=St(Qt(),1);_a();Fge=/^(feat|fix)(\([^)]*\))?!?:/,Lge=/\bF-(\d{3,}|[a-f0-9]{6,})\b/});import{execFileSync as dH}from"node:child_process";import{appendFileSync as Uge,existsSync as AO,mkdirSync as qge,readFileSync as Bge,renameSync as Hge,statSync as Gge}from"node:fs";import{userInfo as Zge}from"node:os";import{dirname as Vge,join as OO}from"node:path";function RO(t){return OO(t,fH,Wge)}function Xr(t,e){let r=RO(t),n=Vge(r);AO(n)||qge(n,{recursive:!0});try{AO(r)&&Gge(r).size>Kge&&Hge(r,OO(n,pH))}catch{}Uge(r,`${JSON.stringify(e)} +`,"utf8")}function TO(t){if(!AO(t))return[];let e=Bge(t,"utf8").trim();return e.length===0?[]:e.split(` +`).filter(r=>r.length>0).map(r=>JSON.parse(r))}function ba(t){return TO(RO(t))}function $_(t){return[...TO(OO(t,fH,pH)),...TO(RO(t))]}function Qr(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 Jge(t){let e;try{e=dH("git",["config","user.name"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{}if(!e)try{e=Zge().username}catch{e=void 0}return{author:"human",name:e,timestamp:new Date().toISOString()}}function Yge(t){try{return dH("git",["rev-parse","HEAD"],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim()}catch{return}}function Nf(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 er(t,e,r){try{let n=Yge(t),i=Jge(t),o={...r,head:n,identity:i};if(e==="gate_run"){let s=Nf(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}Xr(t,Qr(e,o))}catch{}}var fH,Wge,pH,Kge,Nr=y(()=>{"use strict";fH=".cladding",Wge="events.log.jsonl",pH="events.log.1.jsonl",Kge=5*1024*1024});import{execFileSync as Xge}from"node:child_process";import{existsSync as mH,readdirSync as Qge,readFileSync as eye,statSync as hH}from"node:fs";import{createHash as tye}from"node:crypto";import{join as IO}from"node:path";function va(t){try{return Xge("git",["rev-parse","HEAD"],{cwd:t,stdio:["ignore","pipe","ignore"]}).toString("utf8").trim()||null}catch{return null}}function PO(t){let e=[],r=IO(t,"spec.yaml");mH(r)&&hH(r).isFile()&&e.push(r);for(let i of["features","scenarios"]){let o=IO(t,"spec",i);if(!(!mH(o)||!hH(o).isDirectory()))for(let s of Qge(o))s.endsWith(".yaml")&&e.push(IO(o,s))}e.sort();let n=tye("sha256");for(let i of e){let o=i.slice(t.length+1);n.update(`${o}\0`),n.update(eye(i)),n.update("\0")}return n.digest("hex")}function k_(t,e){let r={featureId:e,gitHead:va(t),specDigest:PO(t),timestamp:new Date().toISOString()};return Xr(t,Qr("feature_checkpoint",{feature:e,git_head:r.gitHead,spec_digest:r.specDigest})),r}function E_(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 A_(t,e,r,n){let i=Qr("feature_rolled_back",{feature:e,to_git_head:r.gitHead,to_spec_digest:r.specDigest,to_checkpoint_at:r.timestamp,reason:n??null});return Xr(t,i),i}var jf=y(()=>{"use strict";Nr()});import{readFileSync as rye,statSync as nye}from"node:fs";import{extname as iye,resolve as CO,sep as oye}from"node:path";function en(t){return Math.ceil(t.length/4)}function cye(t,e){let r=CO(e),n=CO(r,t);return n===r||n.startsWith(r+oye)}function yH(t,e,r,n){if(!cye(t,e))return{path:t,omitted:"unsafe-path"};if(!sye.has(iye(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>gH)return{path:t,omitted:"too-large",bytes:o}}else{let l=CO(e,t);try{o=nye(l).size}catch{return{path:t,omitted:"missing"}}if(o>gH)return{path:t,omitted:"too-large",bytes:o};try{i=rye(l,"utf8")}catch{return{path:t,omitted:"missing",bytes:o}}}if(i.includes(aye))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 ege,kB,tge,Qy=y(()=>{"use strict";ege=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"]),kB=2e6,tge="\0"});function ige(t){for(let i of nge)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 eO(t,e,r){let n=t.get(e);n||(n=new Set,t.set(e,n)),n.add(r)}function oge(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??[])eO(e,s,o);for(let s of i.modules??[])eO(r,s,o);for(let s of i.acceptance_criteria??[])for(let a of s.test_refs??[]){let c=ige(a);c&&eO(n,c,o)}}return{dependents:e,moduleOwners:r,testRefCitations:n}}function xn(t){let e=AB.get(t);return e||(e=oge(t),AB.set(t,e)),e}var nge,AB,da=y(()=>{"use strict";nge=["derived:","fixture:","script:","self-dogfood:"];AB=new WeakMap});function tO(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 yr(t,e,r={}){let n=r.depth??1/0,i=xn(t),o=new Map((t.features??[]).map(_=>[_.id,_])),s=[],a,c=sge(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=tO(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:rO(i)}}var fa=y(()=>{"use strict";da()});function TB(t){return t.impacted.length}function t_(t,e,r={}){let n=r.initialDepth??e_.initialDepth,i=r.maxDepth??e_.maxDepth,o=r.coverageThreshold??e_.coverageThreshold,s=r.marginYieldThreshold??e_.marginYieldThreshold,a=xn(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=yr(t,e,{depth:1});return"not_found"in b,b}let d=tO(l,a.dependents,1/0).size;if(d===0){let b=yr(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 _=yr(t,e,{depth:b});if("not_found"in _)return _;m=_;let S=TB(_),x=S-p,w=S>0?x/S:0;f.push(w);let O=d>0?S/d:1,A=x===0&&b>n,E={frontierExhausted:A,coverage:O,marginalYields:[...f],totalKnownDependents:d};if(A)return{slice:_,depthUsed:b,stoppedBy:"exhaustion",analysis:E};if(O>=o)return{slice:_,depthUsed:b,stoppedBy:"coverage",analysis:E};if(f.length>=2&&f[f.length-1]0?g/d:1,marginalYields:[...f],totalKnownDependents:d}}}var e_,nO=y(()=>{"use strict";fa();da();e_={initialDepth:1,maxDepth:10,coverageThreshold:.9,marginYieldThreshold:.05}});function age(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 OB(t,e){let r=new Map(t.features.map(a=>[a.id,a]));if(!r.has(e))return t;let n=age(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 RB=y(()=>{"use strict"});function cge(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 Wc(t,e){let r=cge(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=OB(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 r_=y(()=>{"use strict";RB()});import{existsSync as PB,readdirSync as lge,readFileSync as uge}from"node:fs";import{join as oO}from"node:path";function sO(t,e=fge){let r=t.trim().replace(/\s+/g," ");return r.length<=e?r:`${r.slice(0,e-1)}\u2026`}function pge(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:sO(`drift detected at gate ${n}`)}}let r=typeof e.worst=="number"?` (worst ${e.worst})`:"";return{detector:"done_attempted",message:sO(`done reverted \u2014 pre-push strict gate red${r}`)}}function IB(t){let e=Date.parse(t.timestamp);return Number.isFinite(e)?e:0}function mge(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 sO(n)}function hge(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)=>IB(m)-IB(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(-dge).map(pge),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?mge(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 iO(t,e){let r=t.match(e);return r&&r[1]?r[1].trim():void 0}function gge(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 yge(t,e,r){let n=iO(t,/_Rolled back at_\s*`([^`]+)`/),i=iO(t,/Last failed gate:\s*`([^`]+)`/),o=iO(t,/Retry attempts:\s*(\d+)/),s=gge(t);return{featureId:e,timestamp:n??r,...i?{lastFailedGate:i}:{},...o?{retryCount:Number(o)}:{},...s?{recovery:s}:{}}}function _ge(t,e){let r=oO(t,".cladding","post-mortems");if(!PB(r))return[];let n=`post-mortem-${e}-`,i=[];for(let o of lge(r))if(!(!o.startsWith(n)||!o.endsWith(".md")))try{i.push(yge(uge(oO(r,o),"utf8"),e,o))}catch{}return i}function CB(t,e){try{let r=Ky(t),n=_ge(t,e),i=PB(oO(t,".cladding","events.log.1.jsonl"));return hge(r,n,e,{truncated:i})}catch{return}}var dge,fge,DB=y(()=>{"use strict";Dr();dge=5,fge=120});function n_(t,e,r){return Qr(JSON.stringify({...t,needs:e,must_edit:{...t.must_edit,code:r}}))}function pa(t,e,r={}){let n=r.cwd??".",i=r.maxTokens&&r.maxTokens>0?r.maxTokens:bge,o=e,s,a=xn(t).moduleOwners.get(e);if(a&&a.size>0){let se=[...a].sort();o=se[0],se.length>1&&(s=se)}let c=Wc(t,o);if("not_found"in c)return c;let l=c.focus,u=CB(n,l.id),d=a&&a.size>0?e:l.id,f=t_(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>vge&&n_(w,O,[])>i;)O.pop();O.lengthi){x.push(`code: omitted ${se} (budget)`);continue}E.push(Vt),Vt.truncated&&x.push(`code: clipped ${se}`)}A>i&&x.push("must-edit exceeds budget \u2014 retained in full (focus is never dropped)");let C=(se,Pe)=>({impacted:se,regression_tests:Pe,...g?{radius:g}:{},...p?.ledger?{ledger:p.ledger}:{}}),k=(se,Pe,Vt,ar)=>{let Kt=Vt+ar>0?[`breaks: omitted ${Vt} feature(s) / ${ar} test(s)`]:[],to={...w,needs:O,must_edit:{...w.must_edit,code:E},breaks_if_changed:C(se,Pe),budget:{...w.budget,truncated:[...x,...Kt]}};return Qr(JSON.stringify(to))>i},q=m,X=h;if(k(q,X,0,0)){let se=yr(t,d,{depth:1}),Pe=new Set("not_found"in se?[]:se.impacted.map(de=>de.id)),Vt=new Set("not_found"in se?[]:se.test_refs),Kt=[...m.filter(de=>Pe.has(de.id)),...m.filter(de=>!Pe.has(de.id))],to=0;for(;Kt.length>Pe.size&&k(Kt,X,to,0);)Kt=Kt.slice(0,-1),to++;let yi=[...h],Jr=0;for(;k(Kt,yi,to,Jr);){let de=-1;for(let ro=yi.length-1;ro>=0;ro--)if(!Vt.has(yi[ro])){de=ro;break}if(de<0)break;yi.splice(de,1),Jr++}q=Kt,X=yi,to+Jr>0&&x.push(`breaks: omitted ${to} feature(s) / ${Jr} test(s)`),k(q,X,0,0)&&x.push("breaks: direct set retained in full \u2014 exceeds budget")}let Se=C(q,X),I={...w,needs:O,must_edit:{...w.must_edit,code:E},breaks_if_changed:Se},P=I;if(u){let se={...I,prior_attempts:u};Qr(JSON.stringify(se))<=i?P=se:x.push("prior_attempts: omitted (budget)")}let Rr=Qr(JSON.stringify(P));return{...P,budget:{max_tokens:i,used_tokens:Rr,truncated:x}}}var bge,vge,i_=y(()=>{"use strict";Qy();r_();nO();DB();fa();da();bge=3e3,vge=3});function Zn(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 Sge(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 NB(t,e,r="."){let n=xn(t),i=t.features??[],o=[];for(let f of i){let p=pa(t,f.id,{cwd:r,read:e});if("not_found"in p)continue;let m=pa(t,f.id,{cwd:r,read:e,maxTokens:Number.MAX_SAFE_INTEGER}),h=t_(t,f.id),g=!("not_found"in h),b=Qr(JSON.stringify(p)),_="not_found"in m?b:Qr(JSON.stringify(m)),S=Qr(JSON.stringify(f));for(let O of f.modules??[]){let A=e(O);A&&(S+=Qr(A))}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(Zn(s)*1e3)/1e3,medianShrinkFactor:Math.round(Zn(a(o))*10)/10,fitsCount:c.length,truncatedCount:l.length,medianShrinkFit:Math.round(Zn(a(c))*10)/10,medianShrinkTruncated:Math.round(Zn(a(l))*10)/10,medianStructuralRatio:Math.round(Zn(u)*100)/100,medianSliceTokens:Math.round(Zn(o.map(f=>f.sliceTokens))),medianNaiveTokens:Math.round(Zn(o.map(f=>f.naiveTokens)))},search:{medianDepth:Zn(o.map(f=>f.searchDepth)),p95Depth:Sge(o.map(f=>f.searchDepth),95),medianEdges:Zn(o.map(f=>f.edgesResolved)),maxEdges:o.reduce((f,p)=>Math.max(f,p.edgesResolved),0)},stability:{byStopReason:d,medianCoverage:Math.round(Zn(o.map(f=>f.coverage).filter(f=>f!==null))*100)/100,medianRegressionTests:Zn(o.map(f=>f.regressionTests))},features:o}}var Kc,o_=y(()=>{"use strict";Qy();nO();i_();da();Kc="(deterministic upper bound vs the shard+all-modules baseline \u2014 not an agent-adoption measurement)"});import{appendFileSync as wge,existsSync as aO,mkdirSync as xge,readFileSync as jB}from"node:fs";import{dirname as $ge,join as kge}from"node:path";function cO(t){return kge(t,Ege,Age)}function Tge(t,e){return{timestamp:new Date().toISOString(),head:ua(t),spec_digest:XT(t),featureCount:e.featureCount,measured:e.measured,context:e.context,search:e.search,stability:e.stability}}function MB(t,e){try{let r=Tge(t,e);if(r.head===null)return{appended:!1,reason:"no_head"};let n=lO(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=cO(t),s=$ge(o);return aO(s)||xge(s,{recursive:!0}),wge(o,`${JSON.stringify(r)} -`,"utf8"),{appended:!0,reason:"appended"}}catch{return{appended:!1,reason:"error"}}}function FB(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 lO(t,e){let r=cO(t);if(!aO(r))return[];let n;try{n=jB(r,"utf8")}catch{return[]}let i=FB(n);return typeof e=="number"&&e>=0?i.slice(-e):i}function LB(t){let e=cO(t);if(!aO(e))return{snapshots:[],unreadable:!1};let r;try{r=jB(e,"utf8")}catch{return{snapshots:[],unreadable:!0}}let n=FB(r),i=r.trim().length>0;return{snapshots:n,unreadable:i&&n.length===0}}function vf(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 zB(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?` (${vf(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(` ${Kc}`),i.join(` -`)}var Ege,Age,Sf=y(()=>{"use strict";bf();o_();Ege=".cladding",Age="measure.jsonl"});import{existsSync as Oge}from"node:fs";import{join as Rge}from"node:path";function Jc(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}** (${Ige[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 qB(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 ${vf(n.medianSliceTokens-o.context.medianSliceTokens)} \xB7 struct ${vf(n.medianStructuralRatio-o.context.medianStructuralRatio,2)} \xB7 cov ${vf(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`,"",Kc),r.join(` -`)}function Yc(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"} | ${Cge(l,r)} |`)}return n.join(` -`)}function Cge(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 Pge)if(n.startsWith(o))return`${n} (${s})`;let i=n.split("#",1)[0]??n;return`${Oge(Rge(e,i))?"\u2713":"\u2717"} ${n}`}).join("
")}function Xc(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),UB(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)UB(e,s)}for(;e[e.length-1]==="";)e.pop();return e.join(` -`)}function UB(t,e){t.push(`### ${e.title}`,"");for(let r of e.acceptance_criteria??[]){let n=ZT(r);n&&t.push(`- ${n}`)}t.push("")}var Ige,Pge,s_=y(()=>{"use strict";Sf();o_();Vc();Ige={"added-as-done":"new","flipped-to-done":"completed","modified-while-done":"updated",archived:"retired"};Pge=[["derived:","machine-suggested \u2014 not author-confirmed"],["self-dogfood:","verified by cladding running on itself"],["fixture:","conformance fixture"],["script:","npm script"]]});import{readFileSync as Dge}from"node:fs";function wi(t="./spec.yaml"){let e=Dge(t,"utf8");return(0,BB.parse)(e)}var BB,a_=y(()=>{"use strict";BB=Et(cr(),1)});var Jo=v((Nr,pO)=>{"use strict";var uO=Nr.ValidationError=function(e,r,n,i,o,s){if(Array.isArray(i)?(this.path=i,this.property=i.reduce(function(c,l){return c+GB(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()};uO.prototype.toString=function(){return this.property+" "+this.message};var c_=Nr.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};c_.prototype.addError=function(e){var r;if(typeof e=="string")r=new uO(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 uO(e.message,this.instance,this.schema,this.path,e.name,e.argument)}if(this.errors.push(r),this.throwFirst)throw new ma(this);if(this.throwError)throw r;return r};c_.prototype.importErrors=function(e){typeof e=="string"||e&&e.validatorType?this.addError(e):e&&e.errors&&(this.errors=this.errors.concat(e.errors))};function Nge(t,e){return e+": "+t.toString()+` -`}c_.prototype.toString=function(e){return this.errors.map(Nge).join("")};Object.defineProperty(c_.prototype,"valid",{get:function(){return!this.errors.length}});pO.exports.ValidatorResultError=ma;function ma(t){typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,ma),this.instance=t.instance,this.schema=t.schema,this.options=t.options,this.errors=t.errors}ma.prototype=new Error;ma.prototype.constructor=ma;ma.prototype.name="Validation Error";var HB=Nr.SchemaError=function t(e,r){this.message=e,this.schema=r,Error.call(this,e),typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,t)};HB.prototype=Object.create(Error.prototype,{constructor:{value:HB,enumerable:!1},name:{value:"SchemaError",enumerable:!1}});var dO=Nr.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+GB(a)},"instance")):this.propertyPath=n,this.base=i,this.schemas=o};dO.prototype.resolve=function(e){return ZB(this.base,e)};dO.prototype.makeChild=function(e,r){var n=r===void 0?this.path:this.path.concat([r]),i=e.$id||e.id;let o=ZB(this.base,i||"");var s=new dO(e,this.options,n,o,Object.create(this.schemas));return i&&!s.schemas[o]&&(s.schemas[o]=e),s};var Vn=Nr.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]+$/};Vn.regexp=Vn.regex;Vn.pattern=Vn.regex;Vn.ipv4=Vn["ip-address"];Nr.isFormat=function(e,r,n){if(typeof e=="string"&&Vn[r]!==void 0){if(Vn[r]instanceof RegExp)return Vn[r].test(e);if(typeof Vn[r]=="function")return Vn[r](e)}else if(n&&n.customFormats&&typeof n.customFormats[r]=="function")return n.customFormats[r](e);return!0};var GB=Nr.makeSuffix=function(e){return e=e.toString(),!e.match(/[.\s\[\]]/)&&!e.match(/^[\d]/)?"."+e:e.match(/^\d+$/)?"["+e+"]":"["+JSON.stringify(e)+"]"};Nr.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 jge(t,e,r,n){typeof r=="object"?e[n]=fO(t[n],r):t.indexOf(r)===-1&&e.push(r)}function Mge(t,e,r){e[r]=t[r]}function Fge(t,e,r,n){typeof e[n]!="object"||!e[n]?r[n]=e[n]:t[n]?r[n]=fO(t[n],e[n]):r[n]=e[n]}function fO(t,e){var r=Array.isArray(e),n=r&&[]||{};return r?(t=t||[],n=n.concat(t),e.forEach(jge.bind(null,t,n))):(t&&typeof t=="object"&&Object.keys(t).forEach(Mge.bind(null,t,n)),Object.keys(e).forEach(Fge.bind(null,t,e,n))),n}pO.exports.deepMerge=fO;Nr.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 Lge(t){return"/"+encodeURIComponent(t).replace(/~/g,"%7E")}Nr.encodePath=function(e){return e.map(Lge).join("")};Nr.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};Nr.isSchema=function(e){return typeof e=="object"&&e||typeof e=="boolean"};var ZB=Nr.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 JB=v((oYe,KB)=>{"use strict";var en=Jo(),Fe=en.ValidatorResult,Yo=en.SchemaError,mO={};mO.ignoreProperties={id:!0,default:!0,description:!0,title:!0,additionalItems:!0,then:!0,else:!0,$schema:!0,$ref:!0,extends:!0};var Le=mO.validators={};Le.type=function(e,r,n,i){if(e===void 0)return null;var o=new Fe(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 hO(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}Le.anyOf=function(e,r,n,i){if(e===void 0)return null;var o=new Fe(e,r,n,i),s=new Fe(e,r,n,i);if(!Array.isArray(r.anyOf))throw new Yo("anyOf must be an array");if(!r.anyOf.some(hO.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};Le.allOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.allOf))throw new Yo("allOf must be an array");var o=new Fe(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};Le.oneOf=function(e,r,n,i){if(e===void 0)return null;if(!Array.isArray(r.oneOf))throw new Yo("oneOf must be an array");var o=new Fe(e,r,n,i),s=new Fe(e,r,n,i),a=r.oneOf.filter(hO.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};Le.if=function(e,r,n,i){if(e===void 0)return null;if(!en.isSchema(r.if))throw new Error('Expected "if" keyword to be a schema');var o=hO.call(this,e,n,i,null,r.if),s=new Fe(e,r,n,i),a;if(o){if(r.then===void 0)return;if(!en.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(!en.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 gO(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]}}Le.propertyNames=function(e,r,n,i){if(this.types.object(e)){var o=new Fe(e,r,n,i),s=r.propertyNames!==void 0?r.propertyNames:{};if(!en.isSchema(s))throw new Yo('Expected "propertyNames" to be a schema (object or boolean)');for(var a in e)if(gO(e,a)!==void 0){var c=this.validateSchema(a,s,n,i.makeChild(s));o.importErrors(c)}return o}};Le.properties=function(e,r,n,i){if(this.types.object(e)){var o=new Fe(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 Yo('Unexpected null, expected schema in "properties"');typeof n.preValidateProperty=="function"&&n.preValidateProperty(e,a,c,n,i);var l=gO(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 VB(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)}}Le.patternProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Fe(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 Yo('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&&VB.call(this,e,r,n,i,a,o)}return o}};Le.additionalProperties=function(e,r,n,i){if(this.types.object(e)){if(r.patternProperties)return null;var o=new Fe(e,r,n,i);for(var s in e)VB.call(this,e,r,n,i,s,o);return o}};Le.minProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Fe(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}};Le.maxProperties=function(e,r,n,i){if(this.types.object(e)){var o=new Fe(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}};Le.items=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.items!==void 0){var s=new Fe(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}};Le.contains=function(e,r,n,i){var o=this;if(this.types.array(e)&&r.contains!==void 0){if(!en.isSchema(r.contains))throw new Error('Expected "contains" keyword to be a schema');var s=new Fe(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}};Le.minimum=function(e,r,n,i){if(this.types.number(e)){var o=new Fe(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}};Le.maximum=function(e,r,n,i){if(this.types.number(e)){var o=new Fe(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}};Le.exclusiveMaximum=function(e,r,n,i){if(typeof r.exclusiveMaximum!="boolean"&&this.types.number(e)){var o=new Fe(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}};Le.maxLength=function(e,r,n,i){if(this.types.string(e)){var o=new Fe(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}};Le.minItems=function(e,r,n,i){if(this.types.array(e)){var o=new Fe(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}};Le.maxItems=function(e,r,n,i){if(this.types.array(e)){var o=new Fe(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 zge(t,e,r){var n,i=r.length;for(n=e+1,i;n{"use strict";var yO=Jo();_O.exports.SchemaScanResult=YB;function YB(t,e){this.id=t,this.ref=e}_O.exports.scan=function(e,r){function n(c,l){if(!l||typeof l!="object")return;if(l.$ref){let p=yO.resolveUrl(c,l.$ref);a[p]=a[p]?a[p]+1:0;return}var u=l.$id||l.id;let d=yO.resolveUrl(c,u);var f=u?d:c;if(f){if(f.indexOf("#")<0&&(f+="#"),s[f]){if(!yO.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 XB=JB(),Xo=Jo(),QB=l_().scan,eH=Xo.ValidatorResult,Uge=Xo.ValidatorResultError,wf=Xo.SchemaError,tH=Xo.SchemaContext,qge="/",Wt=function t(){this.customFormats=Object.create(t.prototype.customFormats),this.schemas={},this.unresolvedRefs=[],this.types=Object.create(xi),this.attributes=Object.create(XB.validators)};Wt.prototype.customFormats={};Wt.prototype.schemas=null;Wt.prototype.types=null;Wt.prototype.attributes=null;Wt.prototype.unresolvedRefs=null;Wt.prototype.addSchema=function(e,r){var n=this;if(!e)return null;var i=QB(r||qge,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]};Wt.prototype.addSubSchemaArray=function(e,r){if(Array.isArray(r))for(var n=0;n",e);var a=Xo.objectGetPath(n.schemas[s],o.substr(1));if(a===void 0)throw new wf("no such schema "+o+" located in <"+s+">",e);return{subschema:a,switchSchema:r}};Wt.prototype.testType=function(e,r,n,i,o){if(o!==void 0){if(o===null)throw new wf('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 xi=Wt.prototype.types={};xi.string=function(e){return typeof e=="string"};xi.number=function(e){return typeof e=="number"&&isFinite(e)};xi.integer=function(e){return typeof e=="number"&&e%1===0};xi.boolean=function(e){return typeof e=="boolean"};xi.array=function(e){return Array.isArray(e)};xi.null=function(e){return e===null};xi.date=function(e){return e instanceof Date};xi.any=function(e){return!0};xi.object=function(e){return e&&typeof e=="object"&&!Array.isArray(e)&&!(e instanceof Date)};nH.exports=Wt});var oH=v((cYe,so)=>{"use strict";var Bge=so.exports.Validator=iH();so.exports.ValidatorResult=Jo().ValidatorResult;so.exports.ValidatorResultError=Jo().ValidatorResultError;so.exports.ValidationError=Jo().ValidationError;so.exports.SchemaError=Jo().SchemaError;so.exports.SchemaScanResult=l_().SchemaScanResult;so.exports.scan=l_().scan;so.exports.validate=function(t,e,r){var n=new Bge;return n.validate(t,e,r)}});import{readFileSync as Hge}from"node:fs";import{dirname as Gge,join as Zge}from"node:path";import{fileURLToPath as Vge}from"node:url";function Xge(t){let e=Yge.validate(t,Jge);return e.valid?{valid:!0,errors:[]}:{valid:!1,errors:e.errors.map(n=>`${n.property}: ${n.message}`)}}function aH(t){let e=Xge(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 sye,gH,aye,T_=y(()=>{"use strict";sye=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"]),gH=2e6,aye="\0"});function uye(t){for(let i of lye)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 DO(t,e,r){let n=t.get(e);n||(n=new Set,t.set(e,n)),n.add(r)}function dye(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??[])DO(e,s,o);for(let s of i.modules??[])DO(r,s,o);for(let s of i.acceptance_criteria??[])for(let a of s.test_refs??[]){let c=uye(a);c&&DO(n,c,o)}}return{dependents:e,moduleOwners:r,testRefCitations:n}}function En(t){let e=_H.get(t);return e||(e=dye(t),_H.set(t,e)),e}var lye,_H,Sa=y(()=>{"use strict";lye=["derived:","fixture:","script:","self-dogfood:"];_H=new WeakMap});function NO(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 br(t,e,r={}){let n=r.depth??1/0,i=En(t),o=new Map((t.features??[]).map(_=>[_.id,_])),s=[],a,c=fye(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=NO(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:jO(i)}}var wa=y(()=>{"use strict";Sa()});function bH(t){return t.impacted.length}function R_(t,e,r={}){let n=r.initialDepth??O_.initialDepth,i=r.maxDepth??O_.maxDepth,o=r.coverageThreshold??O_.coverageThreshold,s=r.marginYieldThreshold??O_.marginYieldThreshold,a=En(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=br(t,e,{depth:1});return"not_found"in b,b}let d=NO(l,a.dependents,1/0).size;if(d===0){let b=br(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 _=br(t,e,{depth:b});if("not_found"in _)return _;m=_;let S=bH(_),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 O_,MO=y(()=>{"use strict";wa();Sa();O_={initialDepth:1,maxDepth:10,coverageThreshold:.9,marginYieldThreshold:.05}});function pye(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 vH(t,e){let r=new Map(t.features.map(a=>[a.id,a]));if(!r.has(e))return t;let n=pye(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 SH=y(()=>{"use strict"});function mye(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 ll(t,e){let r=mye(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=vH(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 I_=y(()=>{"use strict";SH()});import{existsSync as xH,readdirSync as hye,readFileSync as gye}from"node:fs";import{join as LO}from"node:path";function zO(t,e=_ye){let r=t.trim().replace(/\s+/g," ");return r.length<=e?r:`${r.slice(0,e-1)}\u2026`}function bye(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:zO(`drift detected at gate ${n}`)}}let r=typeof e.worst=="number"?` (worst ${e.worst})`:"";return{detector:"done_attempted",message:zO(`done reverted \u2014 pre-push strict gate red${r}`)}}function wH(t){let e=Date.parse(t.timestamp);return Number.isFinite(e)?e:0}function vye(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 zO(n)}function Sye(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)=>wH(m)-wH(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(-yye).map(bye),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?vye(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 FO(t,e){let r=t.match(e);return r&&r[1]?r[1].trim():void 0}function wye(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 xye(t,e,r){let n=FO(t,/_Rolled back at_\s*`([^`]+)`/),i=FO(t,/Last failed gate:\s*`([^`]+)`/),o=FO(t,/Retry attempts:\s*(\d+)/),s=wye(t);return{featureId:e,timestamp:n??r,...i?{lastFailedGate:i}:{},...o?{retryCount:Number(o)}:{},...s?{recovery:s}:{}}}function $ye(t,e){let r=LO(t,".cladding","post-mortems");if(!xH(r))return[];let n=`post-mortem-${e}-`,i=[];for(let o of hye(r))if(!(!o.startsWith(n)||!o.endsWith(".md")))try{i.push(xye(gye(LO(r,o),"utf8"),e,o))}catch{}return i}function $H(t,e){try{let r=$_(t),n=$ye(t,e),i=xH(LO(t,".cladding","events.log.1.jsonl"));return Sye(r,n,e,{truncated:i})}catch{return}}var yye,_ye,kH=y(()=>{"use strict";Nr();yye=5,_ye=120});function P_(t,e,r){return en(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:kye,o=e,s,a=En(t).moduleOwners.get(e);if(a&&a.size>0){let se=[...a].sort();o=se[0],se.length>1&&(s=se)}let c=ll(t,o);if("not_found"in c)return c;let l=c.focus,u=$H(n,l.id),d=a&&a.size>0?e:l.id,f=R_(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>Eye&&P_(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 Yt=Kt+dr>0?[`breaks: omitted ${Kt} feature(s) / ${dr} test(s)`]:[],co={...w,needs:O,must_edit:{...w.must_edit,code:A},breaks_if_changed:D(se,Ce),budget:{...w.budget,truncated:[...x,...Yt]}};return en(JSON.stringify(co))>i},ie=m,K=h;if($(ie,K,0,0)){let se=br(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),Yt=[...m.filter(de=>Ce.has(de.id)),...m.filter(de=>!Ce.has(de.id))],co=0;for(;Yt.length>Ce.size&&$(Yt,K,co,0);)Yt=Yt.slice(0,-1),co++;let wi=[...h],Yr=0;for(;$(Yt,wi,co,Yr);){let de=-1;for(let lo=wi.length-1;lo>=0;lo--)if(!Kt.has(wi[lo])){de=lo;break}if(de<0)break;wi.splice(de,1),Yr++}ie=Yt,K=wi,co+Yr>0&&x.push(`breaks: omitted ${co} feature(s) / ${Yr} test(s)`),$(ie,K,0,0)&&x.push("breaks: direct set retained in full \u2014 exceeds budget")}let xe=D(ie,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};en(JSON.stringify(se))<=i?P=se:x.push("prior_attempts: omitted (budget)")}let Ir=en(JSON.stringify(P));return{...P,budget:{max_tokens:i,used_tokens:Ir,truncated:x}}}var kye,Eye,C_=y(()=>{"use strict";T_();I_();MO();kH();wa();Sa();kye=3e3,Eye=3});function Jn(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 Aye(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 EH(t,e,r="."){let n=En(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=R_(t,f.id),g=!("not_found"in h),b=en(JSON.stringify(p)),_="not_found"in m?b:en(JSON.stringify(m)),S=en(JSON.stringify(f));for(let O of f.modules??[]){let T=e(O);T&&(S+=en(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(Jn(s)*1e3)/1e3,medianShrinkFactor:Math.round(Jn(a(o))*10)/10,fitsCount:c.length,truncatedCount:l.length,medianShrinkFit:Math.round(Jn(a(c))*10)/10,medianShrinkTruncated:Math.round(Jn(a(l))*10)/10,medianStructuralRatio:Math.round(Jn(u)*100)/100,medianSliceTokens:Math.round(Jn(o.map(f=>f.sliceTokens))),medianNaiveTokens:Math.round(Jn(o.map(f=>f.naiveTokens)))},search:{medianDepth:Jn(o.map(f=>f.searchDepth)),p95Depth:Aye(o.map(f=>f.searchDepth),95),medianEdges:Jn(o.map(f=>f.edgesResolved)),maxEdges:o.reduce((f,p)=>Math.max(f,p.edgesResolved),0)},stability:{byStopReason:d,medianCoverage:Math.round(Jn(o.map(f=>f.coverage).filter(f=>f!==null))*100)/100,medianRegressionTests:Jn(o.map(f=>f.regressionTests))},features:o}}var ul,D_=y(()=>{"use strict";T_();MO();C_();Sa();ul="(deterministic upper bound vs the shard+all-modules baseline \u2014 not an agent-adoption measurement)"});import{appendFileSync as Tye,existsSync as UO,mkdirSync as Oye,readFileSync as AH}from"node:fs";import{dirname as Rye,join as Iye}from"node:path";function qO(t){return Iye(t,Pye,Cye)}function Dye(t,e){return{timestamp:new Date().toISOString(),head:va(t),spec_digest:PO(t),featureCount:e.featureCount,measured:e.measured,context:e.context,search:e.search,stability:e.stability}}function TH(t,e){try{let r=Dye(t,e);if(r.head===null)return{appended:!1,reason:"no_head"};let n=BO(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=qO(t),s=Rye(o);return UO(s)||Oye(s,{recursive:!0}),Tye(o,`${JSON.stringify(r)} +`,"utf8"),{appended:!0,reason:"appended"}}catch{return{appended:!1,reason:"error"}}}function OH(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 BO(t,e){let r=qO(t);if(!UO(r))return[];let n;try{n=AH(r,"utf8")}catch{return[]}let i=OH(n);return typeof e=="number"&&e>=0?i.slice(-e):i}function RH(t){let e=qO(t);if(!UO(e))return{snapshots:[],unreadable:!1};let r;try{r=AH(e,"utf8")}catch{return{snapshots:[],unreadable:!0}}let n=OH(r),i=r.trim().length>0;return{snapshots:n,unreadable:i&&n.length===0}}function Mf(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 IH(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?` (${Mf(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(` ${ul}`),i.join(` +`)}var Pye,Cye,Ff=y(()=>{"use strict";jf();D_();Pye=".cladding",Cye="measure.jsonl"});import{existsSync as Nye}from"node:fs";import{join as jye}from"node:path";function dl(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}** (${Mye[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 CH(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 ${Mf(n.medianSliceTokens-o.context.medianSliceTokens)} \xB7 struct ${Mf(n.medianStructuralRatio-o.context.medianStructuralRatio,2)} \xB7 cov ${Mf(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`,"",ul),r.join(` +`)}function fl(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"} | ${Lye(l,r)} |`)}return n.join(` +`)}function Lye(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 Fye)if(n.startsWith(o))return`${n} (${s})`;let i=n.split("#",1)[0]??n;return`${Nye(jye(e,i))?"\u2713":"\u2717"} ${n}`}).join("
")}function pl(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),PH(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)PH(e,s)}for(;e[e.length-1]==="";)e.pop();return e.join(` +`)}function PH(t,e){t.push(`### ${e.title}`,"");for(let r of e.acceptance_criteria??[]){let n=EO(r);n&&t.push(`- ${n}`)}t.push("")}var Mye,Fye,N_=y(()=>{"use strict";Ff();D_();cl();Mye={"added-as-done":"new","flipped-to-done":"completed","modified-while-done":"updated",archived:"retired"};Fye=[["derived:","machine-suggested \u2014 not author-confirmed"],["self-dogfood:","verified by cladding running on itself"],["fixture:","conformance fixture"],["script:","npm script"]]});import{readFileSync as zye}from"node:fs";function Ai(t="./spec.yaml"){let e=zye(t,"utf8");return(0,DH.parse)(e)}var DH,j_=y(()=>{"use strict";DH=St(Qt(),1)});var is=v((jr,VO)=>{"use strict";var HO=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+jH(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()};HO.prototype.toString=function(){return this.property+" "+this.message};var M_=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};M_.prototype.addError=function(e){var r;if(typeof e=="string")r=new HO(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 HO(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};M_.prototype.importErrors=function(e){typeof e=="string"||e&&e.validatorType?this.addError(e):e&&e.errors&&(this.errors=this.errors.concat(e.errors))};function Uye(t,e){return e+": "+t.toString()+` +`}M_.prototype.toString=function(e){return this.errors.map(Uye).join("")};Object.defineProperty(M_.prototype,"valid",{get:function(){return!this.errors.length}});VO.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 NH=jr.SchemaError=function t(e,r){this.message=e,this.schema=r,Error.call(this,e),typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,t)};NH.prototype=Object.create(Error.prototype,{constructor:{value:NH,enumerable:!1},name:{value:"SchemaError",enumerable:!1}});var GO=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+jH(a)},"instance")):this.propertyPath=n,this.base=i,this.schemas=o};GO.prototype.resolve=function(e){return MH(this.base,e)};GO.prototype.makeChild=function(e,r){var n=r===void 0?this.path:this.path.concat([r]),i=e.$id||e.id;let o=MH(this.base,i||"");var s=new GO(e,this.options,n,o,Object.create(this.schemas));return i&&!s.schemas[o]&&(s.schemas[o]=e),s};var Yn=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]+$/};Yn.regexp=Yn.regex;Yn.pattern=Yn.regex;Yn.ipv4=Yn["ip-address"];jr.isFormat=function(e,r,n){if(typeof e=="string"&&Yn[r]!==void 0){if(Yn[r]instanceof RegExp)return Yn[r].test(e);if(typeof Yn[r]=="function")return Yn[r](e)}else if(n&&n.customFormats&&typeof n.customFormats[r]=="function")return n.customFormats[r](e);return!0};var jH=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 qye(t,e,r,n){typeof r=="object"?e[n]=ZO(t[n],r):t.indexOf(r)===-1&&e.push(r)}function Bye(t,e,r){e[r]=t[r]}function Hye(t,e,r,n){typeof e[n]!="object"||!e[n]?r[n]=e[n]:t[n]?r[n]=ZO(t[n],e[n]):r[n]=e[n]}function ZO(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(Bye.bind(null,t,n)),Object.keys(e).forEach(Hye.bind(null,t,e,n))),n}VO.exports.deepMerge=ZO;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 Gye(t){return"/"+encodeURIComponent(t).replace(/~/g,"%7E")}jr.encodePath=function(e){return e.map(Gye).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 MH=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 UH=v((VXe,zH)=>{"use strict";var tn=is(),Le=tn.ValidatorResult,os=tn.SchemaError,WO={};WO.ignoreProperties={id:!0,default:!0,description:!0,title:!0,additionalItems:!0,then:!0,else:!0,$schema:!0,$ref:!0,extends:!0};var ze=WO.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 KO(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(KO.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(KO.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(!tn.isSchema(r.if))throw new Error('Expected "if" keyword to be a schema');var o=KO.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(!tn.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(!tn.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 JO(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(!tn.isSchema(s))throw new os('Expected "propertyNames" to be a schema (object or boolean)');for(var a in e)if(JO(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=JO(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 FH(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&&FH.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)FH.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(!tn.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 Zye(t,e,r){var n,i=r.length;for(n=e+1,i;n{"use strict";var YO=is();XO.exports.SchemaScanResult=qH;function qH(t,e){this.id=t,this.ref=e}XO.exports.scan=function(e,r){function n(c,l){if(!l||typeof l!="object")return;if(l.$ref){let p=YO.resolveUrl(c,l.$ref);a[p]=a[p]?a[p]+1:0;return}var u=l.$id||l.id;let d=YO.resolveUrl(c,u);var f=u?d:c;if(f){if(f.indexOf("#")<0&&(f+="#"),s[f]){if(!YO.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 BH=UH(),ss=is(),HH=F_().scan,GH=ss.ValidatorResult,Vye=ss.ValidatorResultError,Lf=ss.SchemaError,ZH=ss.SchemaContext,Wye="/",Jt=function t(){this.customFormats=Object.create(t.prototype.customFormats),this.schemas={},this.unresolvedRefs=[],this.types=Object.create(Ti),this.attributes=Object.create(BH.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=HH(r||Wye,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 Lf("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 Lf('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 Ti=Jt.prototype.types={};Ti.string=function(e){return typeof e=="string"};Ti.number=function(e){return typeof e=="number"&&isFinite(e)};Ti.integer=function(e){return typeof e=="number"&&e%1===0};Ti.boolean=function(e){return typeof e=="boolean"};Ti.array=function(e){return Array.isArray(e)};Ti.null=function(e){return e===null};Ti.date=function(e){return e instanceof Date};Ti.any=function(e){return!0};Ti.object=function(e){return e&&typeof e=="object"&&!Array.isArray(e)&&!(e instanceof Date)};WH.exports=Jt});var JH=v((JXe,mo)=>{"use strict";var Kye=mo.exports.Validator=KH();mo.exports.ValidatorResult=is().ValidatorResult;mo.exports.ValidatorResultError=is().ValidatorResultError;mo.exports.ValidationError=is().ValidationError;mo.exports.SchemaError=is().SchemaError;mo.exports.SchemaScanResult=F_().SchemaScanResult;mo.exports.scan=F_().scan;mo.exports.validate=function(t,e,r){var n=new Kye;return n.validate(t,e,r)}});import{readFileSync as Jye}from"node:fs";import{dirname as Yye,join as Xye}from"node:path";import{fileURLToPath as Qye}from"node:url";function i_e(t){let e=n_e.validate(t,r_e);return e.valid?{valid:!0,errors:[]}:{valid:!1,errors:e.errors.map(n=>`${n.property}: ${n.message}`)}}function XH(t){let e=i_e(t);if(!e.valid)throw new Error(`spec.yaml invalid: ${e.errors.join(` - `)}`)}var sH,Wge,Kge,Jge,Yge,cH=y(()=>{"use strict";sH=Et(oH(),1),Wge=Gge(Vge(import.meta.url)),Kge=Zge(Wge,"schema.json"),Jge=JSON.parse(Hge(Kge,"utf8")),Yge=new sH.Validator});import{existsSync as bO,readdirSync as Qge}from"node:fs";import{dirname as eye,join as ha,resolve as uH}from"node:path";function lH(t){return bO(t)?Qge(t).filter(r=>r.endsWith(".yaml")||r.endsWith(".yml")).map(r=>wi(ha(t,r))):[]}function ga(t,e){u_=e?{cwd:uH(t),spec:e}:null}function H(t=".",e="spec.yaml"){return u_&&e==="spec.yaml"&&uH(t)===u_.cwd?u_.spec:tye(t,e)}function tye(t,e){let r=ha(t,e),n=wi(r),i=ha(t,eye(e),"spec");if(!n.features||n.features.length===0){let o=lH(ha(i,"features"));o.length>0&&(n.features=o)}if(!n.scenarios||n.scenarios.length===0){let o=lH(ha(i,"scenarios"));o.length>0&&(n.scenarios=o)}if(!n.architecture){let o=ha(i,"architecture.yaml");bO(o)&&(n.architecture=wi(o))}if(!n.capabilities||n.capabilities.length===0){let o=ha(i,"capabilities.yaml");if(bO(o)){let s=wi(o);s&&Array.isArray(s.capabilities)&&(n.capabilities=s.capabilities)}}return aH(n),n}var u_,qe=y(()=>{"use strict";a_();cH();u_=null});import Qc from"node:process";function wO(){return!!Qc.stdout.isTTY}function M(t,e,r=""){let n=dH[t],i=r?` ${r}`:"";wO()?Qc.stdout.write(`${vO[t]}${n}${SO} ${e}${i} -`):Qc.stdout.write(`${n} ${e}${i} -`)}function xf(t,e,r=""){if(!wO())return;let n=r?` ${r}`:"";Qc.stdout.write(`${fH}${vO.start}\xB7${SO} ${t} \xB7 ${e}${n}`)}function ya(t,e,r=""){let n=dH[t],i=r?` ${r}`:"";wO()?Qc.stdout.write(`${fH}${vO[t]}${n}${SO} ${e}${i} -`):Qc.stdout.write(`${n} ${e}${i} -`)}var dH,vO,SO,fH,$i=y(()=>{"use strict";dH={start:"\xB7",pass:"\u2713",fail:"\u2717",skip:"\xB7",note:"\u2139"},vO={start:"\x1B[90m",pass:"\x1B[32m",fail:"\x1B[31m",skip:"\x1B[90m",note:"\x1B[36m"},SO="\x1B[0m",fH="\r\x1B[K"});import{createHash as CH}from"node:crypto";import{existsSync as Cye,readFileSync as kO,writeFileSync as Dye}from"node:fs";import{join as d_}from"node:path";function Nye(t,e){let r=CH("sha256");for(let n of[...e].sort()){r.update(n),r.update("\0");try{r.update(kO(d_(t,n)))}catch{r.update("")}r.update("\0")}return r.digest("hex").slice(0,16)}function NH(t,e){let r=CH("sha256");try{r.update(kO(d_(t,e)))}catch{r.update("")}return r.digest("hex").slice(0,16)}function Qo(t){let e=d_(t,...DH);if(!Cye(e))return null;let r;try{r=kO(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 f_(t){return t.features?.size??t.v1?.size??0}function p_(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)!==NH(e,s))return{state:"stale",module:s};return{state:"fresh"}}let i=t.v1?.get(r.id);return i===void 0?{state:"unattested"}:i===Nye(e,n)?{state:"fresh"}:{state:"stale"}}function jH(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}: ${NH(t,a)}`),o=r.map(a=>` ${a.id}: ok`).sort(),s=jye+`attested_modules: + `)}`)}var YH,e_e,t_e,r_e,n_e,QH=y(()=>{"use strict";YH=St(JH(),1),e_e=Yye(Qye(import.meta.url)),t_e=Xye(e_e,"schema.json"),r_e=JSON.parse(Jye(t_e,"utf8")),n_e=new YH.Validator});import{existsSync as QO,readdirSync as o_e}from"node:fs";import{dirname as s_e,join as ka,resolve as tG}from"node:path";function eG(t){return QO(t)?o_e(t).filter(r=>r.endsWith(".yaml")||r.endsWith(".yml")).map(r=>Ai(ka(t,r))):[]}function Ea(t,e){L_=e?{cwd:tG(t),spec:e}:null}function H(t=".",e="spec.yaml"){return L_&&e==="spec.yaml"&&tG(t)===L_.cwd?L_.spec:a_e(t,e)}function a_e(t,e){let r=ka(t,e),n=Ai(r),i=ka(t,s_e(e),"spec");if(!n.features||n.features.length===0){let o=eG(ka(i,"features"));o.length>0&&(n.features=o)}if(!n.scenarios||n.scenarios.length===0){let o=eG(ka(i,"scenarios"));o.length>0&&(n.scenarios=o)}if(!n.architecture){let o=ka(i,"architecture.yaml");QO(o)&&(n.architecture=Ai(o))}if(!n.capabilities||n.capabilities.length===0){let o=ka(i,"capabilities.yaml");if(QO(o)){let s=Ai(o);s&&Array.isArray(s.capabilities)&&(n.capabilities=s.capabilities)}}return XH(n),n}var L_,Be=y(()=>{"use strict";j_();QH();L_=null});import ml from"node:process";function rR(){return!!ml.stdout.isTTY}function L(t,e,r=""){let n=rG[t],i=r?` ${r}`:"";rR()?ml.stdout.write(`${eR[t]}${n}${tR} ${e}${i} +`):ml.stdout.write(`${n} ${e}${i} +`)}function zf(t,e,r=""){if(!rR())return;let n=r?` ${r}`:"";ml.stdout.write(`${nG}${eR.start}\xB7${tR} ${t} \xB7 ${e}${n}`)}function Aa(t,e,r=""){let n=rG[t],i=r?` ${r}`:"";rR()?ml.stdout.write(`${nG}${eR[t]}${n}${tR} ${e}${i} +`):ml.stdout.write(`${n} ${e}${i} +`)}var rG,eR,tR,nG,Oi=y(()=>{"use strict";rG={start:"\xB7",pass:"\u2713",fail:"\u2717",skip:"\xB7",note:"\u2139"},eR={start:"\x1B[90m",pass:"\x1B[32m",fail:"\x1B[31m",skip:"\x1B[90m",note:"\x1B[36m"},tR="\x1B[0m",nG="\r\x1B[K"});import{createHash as $G}from"node:crypto";import{existsSync as L_e,readFileSync as oR,writeFileSync as z_e}from"node:fs";import{join as z_}from"node:path";function U_e(t,e){let r=$G("sha256");for(let n of[...e].sort()){r.update(n),r.update("\0");try{r.update(oR(z_(t,n)))}catch{r.update("")}r.update("\0")}return r.digest("hex").slice(0,16)}function EG(t,e){let r=$G("sha256");try{r.update(oR(z_(t,e)))}catch{r.update("")}return r.digest("hex").slice(0,16)}function as(t){let e=z_(t,...kG);if(!L_e(e))return null;let r;try{r=oR(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 U_(t){return t.features?.size??t.v1?.size??0}function q_(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)!==EG(e,s))return{state:"stale",module:s};return{state:"fresh"}}let i=t.v1?.get(r.id);return i===void 0?{state:"unattested"}:i===U_e(e,n)?{state:"fresh"}:{state:"stale"}}function AG(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}: ${EG(t,a)}`),o=r.map(a=>` ${a.id}: ok`).sort(),s=q_e+`attested_modules: `+i.join(` `)+` attested_features: `+o.join(` `)+` -`;return Dye(d_(t,...DH),s,"utf8"),!0}var DH,jye,tl=y(()=>{"use strict";DH=["spec","attestation.yaml"];jye=`# Cladding \xB7 Tier C \u2014 verification attestation (v2). Written ONLY by a GREEN +`;return z_e(z_(t,...kG),s,"utf8"),!0}var kG,q_e,gl=y(()=>{"use strict";kG=["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,52 +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 EO}from"node:path";function m_(t){es={cwd:EO(t),results:new Map}}function MH(t,e,r){!es||es.cwd!==EO(e)||es.results.set(t,r)}function h_(t,e){return!es||es.cwd!==EO(e)?null:es.results.get(t)??null}function g_(){es=null}var es,rl=y(()=>{"use strict";es=null});function At(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 co=y(()=>{});import{fileURLToPath as Mye}from"node:url";var nl,Fye,AO,TO,il=y(()=>{nl=(t,e)=>{let r=TO(Fye(t));if(typeof r!="string")throw new TypeError(`${e} must be a string or a file URL: ${r}.`);return r},Fye=t=>AO(t)?t.toString():t,AO=t=>typeof t!="string"&&t&&Object.getPrototypeOf(t)===String.prototype,TO=t=>t instanceof URL?Mye(t):t});var y_,OO=y(()=>{co();il();y_=(t,e=[],r={})=>{let n=nl(t,"First argument"),[i,o]=At(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(!At(o))throw new TypeError(`Last argument must be an options object: ${o}`);return[n,s,o]}});import{StringDecoder as Lye}from"node:string_decoder";var FH,LH,Ft,lo,zye,zH,Uye,__,UH,qye,Ef,Bye,RO,Hye,tn=y(()=>{({toString:FH}=Object.prototype),LH=t=>FH.call(t)==="[object ArrayBuffer]",Ft=t=>FH.call(t)==="[object Uint8Array]",lo=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),zye=new TextEncoder,zH=t=>zye.encode(t),Uye=new TextDecoder,__=t=>Uye.decode(t),UH=(t,e)=>qye(t,e).join(""),qye=(t,e)=>{if(e==="utf8"&&t.every(o=>typeof o=="string"))return t;let r=new Lye(e),n=t.map(o=>typeof o=="string"?zH(o):o).map(o=>r.write(o)),i=r.end();return i===""?n:[...n,i]},Ef=t=>t.length===1&&Ft(t[0])?t[0]:RO(Bye(t)),Bye=t=>t.map(e=>typeof e=="string"?zH(e):e),RO=t=>{let e=new Uint8Array(Hye(t)),r=0;for(let n of t)e.set(n,r),r+=n.length;return e},Hye=t=>{let e=0;for(let r of t)e+=r.length;return e}});import{ChildProcess as Gye}from"node:child_process";var GH,ZH,Zye,Vye,qH,Wye,BH,HH,Kye,VH=y(()=>{co();tn();GH=t=>Array.isArray(t)&&Array.isArray(t.raw),ZH=(t,e)=>{let r=[];for(let[o,s]of t.entries())r=Zye({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,{}]},Zye=({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}=Vye(i,t.raw[n]),c=BH(r,o,s);if(n===e.length)return c;let l=e[n],u=Array.isArray(l)?l.map(d=>HH(d)):[HH(l)];return BH(c,u,a)},Vye=(t,e)=>{if(e.length===0)return{nextTokens:[],leadingWhitespaces:!1,trailingWhitespaces:!1};let r=[],n=0,i=qH.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)],HH=t=>{let e=typeof t;if(e==="string")return t;if(e==="number")return String(t);if(At(t)&&("stdout"in t||"isMaxBuffer"in t))return Kye(t);throw t instanceof Gye||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`)},Kye=({stdout:t})=>{if(typeof t=="string")return t;if(Ft(t))return __(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 IO from"node:process";var Wn,b_,$n,v_,uo=y(()=>{Wn=t=>b_.includes(t),b_=[IO.stdin,IO.stdout,IO.stderr],$n=["stdin","stdout","stderr"],v_=t=>$n[t]??`stdio[${t}]`});import{debuglog as Jye}from"node:util";var KH,PO,Yye,Xye,Qye,e_e,WH,t_e,CO,r_e,n_e,i_e,o_e,DO,fo,po=y(()=>{co();uo();KH=t=>{let e={...t};for(let r of DO)e[r]=PO(t,r);return e},PO=(t,e)=>{let r=Array.from({length:Yye(t)+1}),n=Xye(t[e],r,e);return n_e(n,e)},Yye=({stdio:t})=>Array.isArray(t)?Math.max(t.length,$n.length):$n.length,Xye=(t,e,r)=>At(t)?Qye(t,e,r):e.fill(t),Qye=(t,e,r)=>{for(let n of Object.keys(t).sort(e_e))for(let i of t_e(n,r,e))e[i]=t[n];return e},e_e=(t,e)=>WH(t)t==="stdout"||t==="stderr"?0:t==="all"?2:1,t_e=(t,e,r)=>{if(t==="ipc")return[r.length-1];let n=CO(t);if(n===void 0||n===0)throw new TypeError(`"${e}.${t}" is invalid. +`});import{resolve as sR}from"node:path";function B_(t){cs={cwd:sR(t),results:new Map}}function TG(t,e,r){!cs||cs.cwd!==sR(e)||cs.results.set(t,r)}function H_(t,e){return!cs||cs.cwd!==sR(e)?null:cs.results.get(t)??null}function G_(){cs=null}var cs,yl=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 go=y(()=>{});import{fileURLToPath as B_e}from"node:url";var _l,H_e,aR,cR,bl=y(()=>{_l=(t,e)=>{let r=cR(H_e(t));if(typeof r!="string")throw new TypeError(`${e} must be a string or a file URL: ${r}.`);return r},H_e=t=>aR(t)?t.toString():t,aR=t=>typeof t!="string"&&t&&Object.getPrototypeOf(t)===String.prototype,cR=t=>t instanceof URL?B_e(t):t});var Z_,lR=y(()=>{go();bl();Z_=(t,e=[],r={})=>{let n=_l(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 G_e}from"node:string_decoder";var OG,RG,Ut,yo,Z_e,IG,V_e,V_,PG,W_e,Bf,K_e,uR,J_e,rn=y(()=>{({toString:OG}=Object.prototype),RG=t=>OG.call(t)==="[object ArrayBuffer]",Ut=t=>OG.call(t)==="[object Uint8Array]",yo=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),Z_e=new TextEncoder,IG=t=>Z_e.encode(t),V_e=new TextDecoder,V_=t=>V_e.decode(t),PG=(t,e)=>W_e(t,e).join(""),W_e=(t,e)=>{if(e==="utf8"&&t.every(o=>typeof o=="string"))return t;let r=new G_e(e),n=t.map(o=>typeof o=="string"?IG(o):o).map(o=>r.write(o)),i=r.end();return i===""?n:[...n,i]},Bf=t=>t.length===1&&Ut(t[0])?t[0]:uR(K_e(t)),K_e=t=>t.map(e=>typeof e=="string"?IG(e):e),uR=t=>{let e=new Uint8Array(J_e(t)),r=0;for(let n of t)e.set(n,r),r+=n.length;return e},J_e=t=>{let e=0;for(let r of t)e+=r.length;return e}});import{ChildProcess as Y_e}from"node:child_process";var jG,MG,X_e,Q_e,CG,ebe,DG,NG,tbe,FG=y(()=>{go();rn();jG=t=>Array.isArray(t)&&Array.isArray(t.raw),MG=(t,e)=>{let r=[];for(let[o,s]of t.entries())r=X_e({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,{}]},X_e=({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}=Q_e(i,t.raw[n]),c=DG(r,o,s);if(n===e.length)return c;let l=e[n],u=Array.isArray(l)?l.map(d=>NG(d)):[NG(l)];return DG(c,u,a)},Q_e=(t,e)=>{if(e.length===0)return{nextTokens:[],leadingWhitespaces:!1,trailingWhitespaces:!1};let r=[],n=0,i=CG.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)],NG=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 tbe(t);throw t instanceof Y_e||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`)},tbe=({stdout:t})=>{if(typeof t=="string")return t;if(Ut(t))return V_(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 dR from"node:process";var Xn,W_,An,K_,_o=y(()=>{Xn=t=>W_.includes(t),W_=[dR.stdin,dR.stdout,dR.stderr],An=["stdin","stdout","stderr"],K_=t=>An[t]??`stdio[${t}]`});import{debuglog as rbe}from"node:util";var zG,fR,nbe,ibe,obe,sbe,LG,abe,pR,cbe,lbe,ube,dbe,mR,bo,vo=y(()=>{go();_o();zG=t=>{let e={...t};for(let r of mR)e[r]=fR(t,r);return e},fR=(t,e)=>{let r=Array.from({length:nbe(t)+1}),n=ibe(t[e],r,e);return lbe(n,e)},nbe=({stdio:t})=>Array.isArray(t)?Math.max(t.length,An.length):An.length,ibe=(t,e,r)=>Ot(t)?obe(t,e,r):e.fill(t),obe=(t,e,r)=>{for(let n of Object.keys(t).sort(sbe))for(let i of abe(n,r,e))e[i]=t[n];return e},sbe=(t,e)=>LG(t)t==="stdout"||t==="stderr"?0:t==="all"?2:1,abe=(t,e,r)=>{if(t==="ipc")return[r.length-1];let n=pR(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]},CO=t=>{if(t==="all")return t;if($n.includes(t))return $n.indexOf(t);let e=r_e.exec(t);if(e!==null)return Number(e[1])},r_e=/^fd(\d+)$/,n_e=(t,e)=>t.map(r=>r===void 0?o_e[e]:r),i_e=Jye("execa").enabled?"full":"none",o_e={lines:!1,buffer:!0,maxBuffer:1e3*1e3*100,verbose:i_e,stripFinalNewline:!0},DO=["lines","buffer","maxBuffer","verbose","stripFinalNewline"],fo=(t,e)=>e==="ipc"?t.at(-1):t[e]});var ol,sl,JH,NO,s_e,S_,w_,ts=y(()=>{po();ol=({verbose:t},e)=>NO(t,e)!=="none",sl=({verbose:t},e)=>!["none","short"].includes(NO(t,e)),JH=({verbose:t},e)=>{let r=NO(t,e);return S_(r)?r:void 0},NO=(t,e)=>e===void 0?s_e(t):fo(t,e),s_e=t=>t.find(e=>S_(e))??w_.findLast(e=>t.includes(e)),S_=t=>typeof t=="function",w_=["none","short","full"]});import{platform as a_e}from"node:process";import{stripVTControlCharacters as c_e}from"node:util";var YH,Af,XH,l_e,u_e,d_e,f_e,p_e,m_e,h_e,x_=y(()=>{YH=(t,e)=>{let r=[t,...e],n=r.join(" "),i=r.map(o=>m_e(XH(o))).join(" ");return{command:n,escapedCommand:i}},Af=t=>c_e(t).split(` -`).map(e=>XH(e)).join(` -`),XH=t=>t.replaceAll(d_e,e=>l_e(e)),l_e=t=>{let e=f_e[t];if(e!==void 0)return e;let r=t.codePointAt(0),n=r.toString(16);return r<=p_e?`\\u${n.padStart(4,"0")}`:`\\U${n}`},u_e=()=>{try{return new RegExp("\\p{Separator}|\\p{Other}","gu")}catch{return/[\s\u0000-\u001F\u007F-\u009F\u00AD]/g}},d_e=u_e(),f_e={" ":" ","\b":"\\b","\f":"\\f","\n":"\\n","\r":"\\r"," ":"\\t"},p_e=65535,m_e=t=>h_e.test(t)?t:a_e==="win32"?`"${t.replaceAll('"','""')}"`:`'${t.replaceAll("'","'\\''")}'`,h_e=/^[\w./-]+$/});import QH from"node:process";function jO(){let{env:t}=QH,{TERM:e,TERM_PROGRAM:r}=t;return QH.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 eG=y(()=>{});var tG,rG,g_e,y_e,__e,b_e,v_e,$_,fXe,nG=y(()=>{eG();tG={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"},rG={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"},g_e={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"},y_e={...tG,...rG},__e={...tG,...g_e},b_e=jO(),v_e=b_e?y_e:__e,$_=v_e,fXe=Object.entries(rG)});import S_e from"node:tty";var w_e,_e,hXe,iG,gXe,yXe,_Xe,bXe,vXe,SXe,wXe,xXe,$Xe,kXe,EXe,AXe,TXe,OXe,RXe,k_,IXe,PXe,CXe,DXe,NXe,jXe,MXe,FXe,LXe,oG,zXe,sG,UXe,qXe,BXe,HXe,GXe,ZXe,VXe,WXe,KXe,JXe,YXe,MO=y(()=>{w_e=S_e?.WriteStream?.prototype?.hasColors?.()??!1,_e=(t,e)=>{if(!w_e)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}},hXe=_e(0,0),iG=_e(1,22),gXe=_e(2,22),yXe=_e(3,23),_Xe=_e(4,24),bXe=_e(53,55),vXe=_e(7,27),SXe=_e(8,28),wXe=_e(9,29),xXe=_e(30,39),$Xe=_e(31,39),kXe=_e(32,39),EXe=_e(33,39),AXe=_e(34,39),TXe=_e(35,39),OXe=_e(36,39),RXe=_e(37,39),k_=_e(90,39),IXe=_e(40,49),PXe=_e(41,49),CXe=_e(42,49),DXe=_e(43,49),NXe=_e(44,49),jXe=_e(45,49),MXe=_e(46,49),FXe=_e(47,49),LXe=_e(100,49),oG=_e(91,39),zXe=_e(92,39),sG=_e(93,39),UXe=_e(94,39),qXe=_e(95,39),BXe=_e(96,39),HXe=_e(97,39),GXe=_e(101,49),ZXe=_e(102,49),VXe=_e(103,49),WXe=_e(104,49),KXe=_e(105,49),JXe=_e(106,49),YXe=_e(107,49)});var aG=y(()=>{MO();MO()});var uG,$_e,E_,cG,k_e,lG,E_e,dG=y(()=>{nG();aG();uG=({type:t,message:e,timestamp:r,piped:n,commandId:i,result:{failed:o=!1}={},options:{reject:s=!0}})=>{let a=$_e(r),c=k_e[t]({failed:o,reject:s,piped:n}),l=E_e[t]({reject:s});return`${k_(`[${a}]`)} ${k_(`[${i}]`)} ${l(c)} ${l(e)}`},$_e=t=>`${E_(t.getHours(),2)}:${E_(t.getMinutes(),2)}:${E_(t.getSeconds(),2)}.${E_(t.getMilliseconds(),3)}`,E_=(t,e)=>String(t).padStart(e,"0"),cG=({failed:t,reject:e})=>t?e?$_.cross:$_.warning:$_.tick,k_e={command:({piped:t})=>t?"|":"$",output:()=>" ",ipc:()=>"*",error:cG,duration:cG},lG=t=>t,E_e={command:()=>iG,output:()=>lG,ipc:()=>lG,error:({reject:t})=>t?oG:sG,duration:()=>k_}});var fG,A_e,T_e,pG=y(()=>{ts();fG=(t,e,r)=>{let n=JH(e,r);return t.map(({verboseLine:i,verboseObject:o})=>A_e(i,o,n)).filter(i=>i!==void 0).map(i=>T_e(i)).join("")},A_e=(t,e,r)=>{if(r===void 0)return t;let n=r(t,e);if(typeof n=="string")return n},T_e=t=>t.endsWith(` +Please set the "stdio" option to ensure that file descriptor exists.`);return n==="all"?[1,2]:[n]},pR=t=>{if(t==="all")return t;if(An.includes(t))return An.indexOf(t);let e=cbe.exec(t);if(e!==null)return Number(e[1])},cbe=/^fd(\d+)$/,lbe=(t,e)=>t.map(r=>r===void 0?dbe[e]:r),ube=rbe("execa").enabled?"full":"none",dbe={lines:!1,buffer:!0,maxBuffer:1e3*1e3*100,verbose:ube,stripFinalNewline:!0},mR=["lines","buffer","maxBuffer","verbose","stripFinalNewline"],bo=(t,e)=>e==="ipc"?t.at(-1):t[e]});var vl,Sl,UG,hR,fbe,J_,Y_,ls=y(()=>{vo();vl=({verbose:t},e)=>hR(t,e)!=="none",Sl=({verbose:t},e)=>!["none","short"].includes(hR(t,e)),UG=({verbose:t},e)=>{let r=hR(t,e);return J_(r)?r:void 0},hR=(t,e)=>e===void 0?fbe(t):bo(t,e),fbe=t=>t.find(e=>J_(e))??Y_.findLast(e=>t.includes(e)),J_=t=>typeof t=="function",Y_=["none","short","full"]});import{platform as pbe}from"node:process";import{stripVTControlCharacters as mbe}from"node:util";var qG,Hf,BG,hbe,gbe,ybe,_be,bbe,vbe,Sbe,X_=y(()=>{qG=(t,e)=>{let r=[t,...e],n=r.join(" "),i=r.map(o=>vbe(BG(o))).join(" ");return{command:n,escapedCommand:i}},Hf=t=>mbe(t).split(` +`).map(e=>BG(e)).join(` +`),BG=t=>t.replaceAll(ybe,e=>hbe(e)),hbe=t=>{let e=_be[t];if(e!==void 0)return e;let r=t.codePointAt(0),n=r.toString(16);return r<=bbe?`\\u${n.padStart(4,"0")}`:`\\U${n}`},gbe=()=>{try{return new RegExp("\\p{Separator}|\\p{Other}","gu")}catch{return/[\s\u0000-\u001F\u007F-\u009F\u00AD]/g}},ybe=gbe(),_be={" ":" ","\b":"\\b","\f":"\\f","\n":"\\n","\r":"\\r"," ":"\\t"},bbe=65535,vbe=t=>Sbe.test(t)?t:pbe==="win32"?`"${t.replaceAll('"','""')}"`:`'${t.replaceAll("'","'\\''")}'`,Sbe=/^[\w./-]+$/});import HG from"node:process";function gR(){let{env:t}=HG,{TERM:e,TERM_PROGRAM:r}=t;return HG.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 GG=y(()=>{});var ZG,VG,wbe,xbe,$be,kbe,Ebe,Q_,eQe,WG=y(()=>{GG();ZG={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"},VG={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"},wbe={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"},xbe={...ZG,...VG},$be={...ZG,...wbe},kbe=gR(),Ebe=kbe?xbe:$be,Q_=Ebe,eQe=Object.entries(VG)});import Abe from"node:tty";var Tbe,be,nQe,KG,iQe,oQe,sQe,aQe,cQe,lQe,uQe,dQe,fQe,pQe,mQe,hQe,gQe,yQe,_Qe,eb,bQe,vQe,SQe,wQe,xQe,$Qe,kQe,EQe,AQe,JG,TQe,YG,OQe,RQe,IQe,PQe,CQe,DQe,NQe,jQe,MQe,FQe,LQe,yR=y(()=>{Tbe=Abe?.WriteStream?.prototype?.hasColors?.()??!1,be=(t,e)=>{if(!Tbe)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}},nQe=be(0,0),KG=be(1,22),iQe=be(2,22),oQe=be(3,23),sQe=be(4,24),aQe=be(53,55),cQe=be(7,27),lQe=be(8,28),uQe=be(9,29),dQe=be(30,39),fQe=be(31,39),pQe=be(32,39),mQe=be(33,39),hQe=be(34,39),gQe=be(35,39),yQe=be(36,39),_Qe=be(37,39),eb=be(90,39),bQe=be(40,49),vQe=be(41,49),SQe=be(42,49),wQe=be(43,49),xQe=be(44,49),$Qe=be(45,49),kQe=be(46,49),EQe=be(47,49),AQe=be(100,49),JG=be(91,39),TQe=be(92,39),YG=be(93,39),OQe=be(94,39),RQe=be(95,39),IQe=be(96,39),PQe=be(97,39),CQe=be(101,49),DQe=be(102,49),NQe=be(103,49),jQe=be(104,49),MQe=be(105,49),FQe=be(106,49),LQe=be(107,49)});var XG=y(()=>{yR();yR()});var tZ,Rbe,tb,QG,Ibe,eZ,Pbe,rZ=y(()=>{WG();XG();tZ=({type:t,message:e,timestamp:r,piped:n,commandId:i,result:{failed:o=!1}={},options:{reject:s=!0}})=>{let a=Rbe(r),c=Ibe[t]({failed:o,reject:s,piped:n}),l=Pbe[t]({reject:s});return`${eb(`[${a}]`)} ${eb(`[${i}]`)} ${l(c)} ${l(e)}`},Rbe=t=>`${tb(t.getHours(),2)}:${tb(t.getMinutes(),2)}:${tb(t.getSeconds(),2)}.${tb(t.getMilliseconds(),3)}`,tb=(t,e)=>String(t).padStart(e,"0"),QG=({failed:t,reject:e})=>t?e?Q_.cross:Q_.warning:Q_.tick,Ibe={command:({piped:t})=>t?"|":"$",output:()=>" ",ipc:()=>"*",error:QG,duration:QG},eZ=t=>t,Pbe={command:()=>KG,output:()=>eZ,ipc:()=>eZ,error:({reject:t})=>t?JG:YG,duration:()=>eb}});var nZ,Cbe,Dbe,iZ=y(()=>{ls();nZ=(t,e,r)=>{let n=UG(e,r);return t.map(({verboseLine:i,verboseObject:o})=>Cbe(i,o,n)).filter(i=>i!==void 0).map(i=>Dbe(i)).join("")},Cbe=(t,e,r)=>{if(r===void 0)return t;let n=r(t,e);if(typeof n=="string")return n},Dbe=t=>t.endsWith(` `)?t:`${t} -`});import{inspect as O_e}from"node:util";var ki,R_e,I_e,P_e,A_,C_e,al=y(()=>{x_();dG();pG();ki=({type:t,verboseMessage:e,fdNumber:r,verboseInfo:n,result:i})=>{let o=R_e({type:t,result:i,verboseInfo:n}),s=I_e(e,o),a=fG(s,n,r);a!==""&&console.warn(a.slice(0,-1))},R_e=({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}),I_e=(t,e)=>t.split(` -`).map(r=>P_e({...e,message:r})),P_e=t=>({verboseLine:uG(t),verboseObject:t}),A_=t=>{let e=typeof t=="string"?t:O_e(t);return Af(e).replaceAll(" "," ".repeat(C_e))},C_e=2});var mG,hG=y(()=>{ts();al();mG=(t,e)=>{ol(e)&&ki({type:"command",verboseMessage:t,verboseInfo:e})}});var gG,D_e,N_e,j_e,yG=y(()=>{ts();gG=(t,e,r)=>{j_e(t);let n=D_e(t);return{verbose:t,escapedCommand:e,commandId:n,rawOptions:r}},D_e=t=>ol({verbose:t})?N_e++:void 0,N_e=0n,j_e=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(!w_.includes(e)&&!S_(e)){let r=w_.map(n=>`'${n}'`).join(", ");throw new TypeError(`The "verbose" option must not be ${e}. Allowed values are: ${r} or a function.`)}}}});import{hrtime as _G}from"node:process";var T_,FO,O_=y(()=>{T_=()=>_G.bigint(),FO=t=>Number(_G.bigint()-t)/1e6});var R_,LO=y(()=>{hG();yG();O_();x_();po();R_=(t,e,r)=>{let n=T_(),{command:i,escapedCommand:o}=YH(t,e),s=PO(r,"verbose"),a=gG(s,o,{...r});return mG(o,a),{command:i,escapedCommand:o,startTime:n,verboseInfo:a}}});var xG=v((x7e,wG)=>{wG.exports=SG;SG.sync=F_e;var bG=He("fs");function M_e(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{AG.exports=kG;kG.sync=L_e;var $G=He("fs");function kG(t,e,r){$G.stat(t,function(n,i){r(n,n?!1:EG(i,e))})}function L_e(t,e){return EG($G.statSync(t),e)}function EG(t,e){return t.isFile()&&z_e(t,e)}function z_e(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 RG=v((E7e,OG)=>{var k7e=He("fs"),I_;process.platform==="win32"||global.TESTING_WINDOWS?I_=xG():I_=TG();OG.exports=zO;zO.sync=U_e;function zO(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){zO(t,e||{},function(o,s){o?i(o):n(s)})})}I_(t,e||{},function(n,i){n&&(n.code==="EACCES"||e&&e.ignoreErrors)&&(n=null,i=!1),r(n,i)})}function U_e(t,e){try{return I_.sync(t,e||{})}catch(r){if(e&&e.ignoreErrors||r.code==="EACCES")return!1;throw r}}});var MG=v((A7e,jG)=>{var cl=process.platform==="win32"||process.env.OSTYPE==="cygwin"||process.env.OSTYPE==="msys",IG=He("path"),q_e=cl?";":":",PG=RG(),CG=t=>Object.assign(new Error(`not found: ${t}`),{code:"ENOENT"}),DG=(t,e)=>{let r=e.colon||q_e,n=t.match(/\//)||cl&&t.match(/\\/)?[""]:[...cl?[process.cwd()]:[],...(e.path||process.env.PATH||"").split(r)],i=cl?e.pathExt||process.env.PATHEXT||".EXE;.CMD;.BAT;.COM":"",o=cl?i.split(r):[""];return cl&&t.indexOf(".")!==-1&&o[0]!==""&&o.unshift(""),{pathEnv:n,pathExt:o,pathExtExe:i}},NG=(t,e,r)=>{typeof e=="function"&&(r=e,e={}),e||(e={});let{pathEnv:n,pathExt:i,pathExtExe:o}=DG(t,e),s=[],a=l=>new Promise((u,d)=>{if(l===n.length)return e.all&&s.length?u(s):d(CG(t));let f=n[l],p=/^".*"$/.test(f)?f.slice(1,-1):f,m=IG.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];PG(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)},B_e=(t,e)=>{e=e||{};let{pathEnv:r,pathExt:n,pathExtExe:i}=DG(t,e),o=[];for(let s=0;s{"use strict";var FG=(t={})=>{let e=t.env||process.env;return(t.platform||process.platform)!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"};UO.exports=FG;UO.exports.default=FG});var BG=v((O7e,qG)=>{"use strict";var zG=He("path"),H_e=MG(),G_e=LG();function UG(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=H_e.sync(t.command,{path:r[G_e({env:r})],pathExt:e?zG.delimiter:void 0})}catch{}finally{o&&process.chdir(n)}return s&&(s=zG.resolve(i?t.options.cwd:"",s)),s}function Z_e(t){return UG(t)||UG(t,!0)}qG.exports=Z_e});var HG=v((R7e,BO)=>{"use strict";var qO=/([()\][%!^"`<>&|;, *?])/g;function V_e(t){return t=t.replace(qO,"^$1"),t}function W_e(t,e){return t=`${t}`,t=t.replace(/(?=(\\+?)?)\1"/g,'$1$1\\"'),t=t.replace(/(?=(\\+?)?)\1$/,"$1$1"),t=`"${t}"`,t=t.replace(qO,"^$1"),e&&(t=t.replace(qO,"^$1")),t}BO.exports.command=V_e;BO.exports.argument=W_e});var ZG=v((I7e,GG)=>{"use strict";GG.exports=/^#!(.*)/});var WG=v((P7e,VG)=>{"use strict";var K_e=ZG();VG.exports=(t="")=>{let e=t.match(K_e);if(!e)return null;let[r,n]=e[0].replace(/#! ?/,"").split(" "),i=r.split("/").pop();return i==="env"?n:n?`${i} ${n}`:i}});var JG=v((C7e,KG)=>{"use strict";var HO=He("fs"),J_e=WG();function Y_e(t){let r=Buffer.alloc(150),n;try{n=HO.openSync(t,"r"),HO.readSync(n,r,0,150,0),HO.closeSync(n)}catch{}return J_e(r.toString())}KG.exports=Y_e});var eZ=v((D7e,QG)=>{"use strict";var X_e=He("path"),YG=BG(),XG=HG(),Q_e=JG(),ebe=process.platform==="win32",tbe=/\.(?:com|exe)$/i,rbe=/node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;function nbe(t){t.file=YG(t);let e=t.file&&Q_e(t.file);return e?(t.args.unshift(t.file),t.command=e,YG(t)):t.file}function ibe(t){if(!ebe)return t;let e=nbe(t),r=!tbe.test(e);if(t.options.forceShell||r){let n=rbe.test(e);t.command=X_e.normalize(t.command),t.command=XG.command(t.command),t.args=t.args.map(o=>XG.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 obe(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:ibe(n)}QG.exports=obe});var nZ=v((N7e,rZ)=>{"use strict";var GO=process.platform==="win32";function ZO(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 sbe(t,e){if(!GO)return;let r=t.emit;t.emit=function(n,i){if(n==="exit"){let o=tZ(i,e);if(o)return r.call(t,"error",o)}return r.apply(t,arguments)}}function tZ(t,e){return GO&&t===1&&!e.file?ZO(e.original,"spawn"):null}function abe(t,e){return GO&&t===1&&!e.file?ZO(e.original,"spawnSync"):null}rZ.exports={hookChildProcess:sbe,verifyENOENT:tZ,verifyENOENTSync:abe,notFoundError:ZO}});var sZ=v((j7e,ll)=>{"use strict";var iZ=He("child_process"),VO=eZ(),WO=nZ();function oZ(t,e,r){let n=VO(t,e,r),i=iZ.spawn(n.command,n.args,n.options);return WO.hookChildProcess(i,n),i}function cbe(t,e,r){let n=VO(t,e,r),i=iZ.spawnSync(n.command,n.args,n.options);return i.error=i.error||WO.verifyENOENTSync(i.status,n),i}ll.exports=oZ;ll.exports.spawn=oZ;ll.exports.sync=cbe;ll.exports._parse=VO;ll.exports._enoent=WO});function P_(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 aZ=y(()=>{});var cZ=y(()=>{});import{promisify as lbe}from"node:util";import{execFile as ube,execFileSync as U7e}from"node:child_process";import lZ from"node:path";import{fileURLToPath as dbe}from"node:url";function C_(t){return t instanceof URL?dbe(t):t}function uZ(t){return{*[Symbol.iterator](){let e=lZ.resolve(C_(t)),r;for(;r!==e;)yield e,r=e,e=lZ.resolve(e,"..")}}}var H7e,G7e,dZ=y(()=>{cZ();H7e=lbe(ube);G7e=10*1024*1024});import D_ from"node:process";import ba from"node:path";var fbe,pbe,mbe,fZ,pZ=y(()=>{aZ();dZ();fbe=({cwd:t=D_.cwd(),path:e=D_.env[P_()],preferLocal:r=!0,execPath:n=D_.execPath,addExecPath:i=!0}={})=>{let o=ba.resolve(C_(t)),s=[],a=e.split(ba.delimiter);return r&&pbe(s,a,o),i&&mbe(s,a,n,o),e===""||e===ba.delimiter?`${s.join(ba.delimiter)}${e}`:[...s,e].join(ba.delimiter)},pbe=(t,e,r)=>{for(let n of uZ(r)){let i=ba.join(n,"node_modules/.bin");e.includes(i)||t.push(i)}},mbe=(t,e,r,n)=>{let i=ba.resolve(n,C_(r),"..");e.includes(i)||t.push(i)},fZ=({env:t=D_.env,...e}={})=>{t={...t};let r=P_({env:t});return e.path=t[r],t[r]=fbe(e),t}});var mZ,Kn,hZ,gZ,yZ,N_,Tf,Of,va=y(()=>{mZ=(t,e,r)=>{let n=r?Of:Tf,i=t instanceof Kn?{}:{cause:t};return new n(e,i)},Kn=class extends Error{},hZ=(t,e)=>{Object.defineProperty(t.prototype,"name",{value:e,writable:!0,enumerable:!1,configurable:!0}),Object.defineProperty(t.prototype,yZ,{value:!0,writable:!1,enumerable:!1,configurable:!1})},gZ=t=>N_(t)&&yZ in t,yZ=Symbol("isExecaError"),N_=t=>Object.prototype.toString.call(t)==="[object Error]",Tf=class extends Error{};hZ(Tf,Tf.name);Of=class extends Error{};hZ(Of,Of.name)});var _Z,hbe,bZ,vZ,SZ=y(()=>{_Z=()=>{let t=vZ-bZ+1;return Array.from({length:t},hbe)},hbe=(t,e)=>({name:`SIGRT${e+1}`,number:bZ+e,action:"terminate",description:"Application-specific signal (realtime)",standard:"posix"}),bZ=34,vZ=64});var wZ,xZ=y(()=>{wZ=[{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 gbe}from"node:os";var KO,ybe,$Z=y(()=>{xZ();SZ();KO=()=>{let t=_Z();return[...wZ,...t].map(ybe)},ybe=({name:t,number:e,description:r,action:n,forced:i=!1,standard:o})=>{let{signals:{[t]:s}}=gbe,a=s!==void 0;return{name:t,number:a?s:e,description:r,supported:a,action:n,forced:i,standard:o}}});import{constants as _be}from"node:os";var bbe,vbe,kZ,Sbe,wbe,xbe,cQe,EZ=y(()=>{$Z();bbe=()=>{let t=KO();return Object.fromEntries(t.map(vbe))},vbe=({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}],kZ=bbe(),Sbe=()=>{let t=KO(),e=65,r=Array.from({length:e},(n,i)=>wbe(i,t));return Object.assign({},...r)},wbe=(t,e)=>{let r=xbe(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}}},xbe=(t,e)=>{let r=e.find(({name:n})=>_be.signals[n]===t);return r!==void 0?r:e.find(n=>n.number===t)},cQe=Sbe()});import{constants as Rf}from"node:os";var TZ,OZ,RZ,$be,kbe,AZ,Ebe,JO,Abe,Tbe,j_,If=y(()=>{EZ();TZ=t=>{let e="option `killSignal`";if(t===0)throw new TypeError(`Invalid ${e}: 0 cannot be used.`);return RZ(t,e)},OZ=t=>t===0?t:RZ(t,"`subprocess.kill()`'s argument"),RZ=(t,e)=>{if(Number.isInteger(t))return $be(t,e);if(typeof t=="string")return Ebe(t,e);throw new TypeError(`Invalid ${e} ${String(t)}: it must be a string or an integer. -${JO()}`)},$be=(t,e)=>{if(AZ.has(t))return AZ.get(t);throw new TypeError(`Invalid ${e} ${t}: this signal integer does not exist. -${JO()}`)},kbe=()=>new Map(Object.entries(Rf.signals).reverse().map(([t,e])=>[e,t])),AZ=kbe(),Ebe=(t,e)=>{if(t in Rf.signals)return t;throw t.toUpperCase()in Rf.signals?new TypeError(`Invalid ${e} '${t}': please rename it to '${t.toUpperCase()}'.`):new TypeError(`Invalid ${e} '${t}': this signal name does not exist. -${JO()}`)},JO=()=>`Available signal names: ${Abe()}. -Available signal numbers: ${Tbe()}.`,Abe=()=>Object.keys(Rf.signals).sort().map(t=>`'${t}'`).join(", "),Tbe=()=>[...new Set(Object.values(Rf.signals).sort((t,e)=>t-e))].join(", "),j_=t=>kZ[t].description});import{setTimeout as Obe}from"node:timers/promises";var IZ,Rbe,PZ,Ibe,Pbe,Cbe,YO,M_=y(()=>{va();If();IZ=t=>{if(t===!1)return t;if(t===!0)return Rbe;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},Rbe=1e3*5,PZ=({kill:t,options:{forceKillAfterDelay:e,killSignal:r},onInternalError:n,context:i,controller:o},s,a)=>{let{signal:c,error:l}=Ibe(s,a,r);Pbe(l,n);let u=t(c);return Cbe({kill:t,signal:c,forceKillAfterDelay:e,killSignal:r,killResult:u,context:i,controller:o}),u},Ibe=(t,e,r)=>{let[n=r,i]=N_(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&&!N_(i))throw new TypeError(`The second argument is optional. If specified, it must be an error instance: ${i}`);return{signal:OZ(n),error:i}},Pbe=(t,e)=>{t!==void 0&&e.reject(t)},Cbe=async({kill:t,signal:e,forceKillAfterDelay:r,killSignal:n,killResult:i,context:o,controller:s})=>{e===n&&i&&YO({kill:t,forceKillAfterDelay:r,context:o,controllerSignal:s.signal})},YO=async({kill:t,forceKillAfterDelay:e,context:r,controllerSignal:n})=>{if(e!==!1)try{await Obe(e,void 0,{signal:n}),t("SIGKILL")&&(r.isForcefullyTerminated??=!0)}catch{}}});import{once as Dbe}from"node:events";var F_,XO=y(()=>{F_=async(t,e)=>{t.aborted||await Dbe(t,"abort",{signal:e})}});var CZ,DZ,Nbe,QO=y(()=>{XO();CZ=({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)}`)},DZ=({subprocess:t,cancelSignal:e,gracefulCancel:r,context:n,controller:i})=>e===void 0||r?[]:[Nbe(t,e,n,i)],Nbe=async(t,e,r,{signal:n})=>{throw await F_(e,n),r.terminationReason??="cancel",t.kill(),e.reason}});var ul,jbe,eR,NZ,jZ,L_,MZ,FZ,LZ,zZ,UZ,qZ,Mbe,Fbe,Lbe,Jn,zbe,rs,dl,fl=y(()=>{ul=({methodName:t,isSubprocess:e,ipc:r,isConnected:n})=>{jbe(t,e,r),eR(t,e,n)},jbe=(t,e,r)=>{if(!r)throw new Error(`${Jn(t,e)} can only be used if the \`ipc\` option is \`true\`.`)},eR=(t,e,r)=>{if(!r)throw new Error(`${Jn(t,e)} cannot be used: the ${rs(e)} has already exited or disconnected.`)},NZ=t=>{throw new Error(`${Jn("getOneMessage",t)} could not complete: the ${rs(t)} exited or disconnected.`)},jZ=t=>{throw new Error(`${Jn("sendMessage",t)} failed: the ${rs(t)} is sending a message too, instead of listening to incoming messages. +`});import{inspect as Nbe}from"node:util";var Ri,jbe,Mbe,Fbe,rb,Lbe,wl=y(()=>{X_();rZ();iZ();Ri=({type:t,verboseMessage:e,fdNumber:r,verboseInfo:n,result:i})=>{let o=jbe({type:t,result:i,verboseInfo:n}),s=Mbe(e,o),a=nZ(s,n,r);a!==""&&console.warn(a.slice(0,-1))},jbe=({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}),Mbe=(t,e)=>t.split(` +`).map(r=>Fbe({...e,message:r})),Fbe=t=>({verboseLine:tZ(t),verboseObject:t}),rb=t=>{let e=typeof t=="string"?t:Nbe(t);return Hf(e).replaceAll(" "," ".repeat(Lbe))},Lbe=2});var oZ,sZ=y(()=>{ls();wl();oZ=(t,e)=>{vl(e)&&Ri({type:"command",verboseMessage:t,verboseInfo:e})}});var aZ,zbe,Ube,qbe,cZ=y(()=>{ls();aZ=(t,e,r)=>{qbe(t);let n=zbe(t);return{verbose:t,escapedCommand:e,commandId:n,rawOptions:r}},zbe=t=>vl({verbose:t})?Ube++:void 0,Ube=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(!Y_.includes(e)&&!J_(e)){let r=Y_.map(n=>`'${n}'`).join(", ");throw new TypeError(`The "verbose" option must not be ${e}. Allowed values are: ${r} or a function.`)}}}});import{hrtime as lZ}from"node:process";var nb,_R,ib=y(()=>{nb=()=>lZ.bigint(),_R=t=>Number(lZ.bigint()-t)/1e6});var ob,bR=y(()=>{sZ();cZ();ib();X_();vo();ob=(t,e,r)=>{let n=nb(),{command:i,escapedCommand:o}=qG(t,e),s=fR(r,"verbose"),a=aZ(s,o,{...r});return oZ(o,a),{command:i,escapedCommand:o,startTime:n,verboseInfo:a}}});var mZ=v((fet,pZ)=>{pZ.exports=fZ;fZ.sync=Hbe;var uZ=Ge("fs");function Bbe(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=gZ;gZ.sync=Gbe;var hZ=Ge("fs");function gZ(t,e,r){hZ.stat(t,function(n,i){r(n,n?!1:yZ(i,e))})}function Gbe(t,e){return yZ(hZ.statSync(t),e)}function yZ(t,e){return t.isFile()&&Zbe(t,e)}function Zbe(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 SZ=v((het,vZ)=>{var met=Ge("fs"),sb;process.platform==="win32"||global.TESTING_WINDOWS?sb=mZ():sb=bZ();vZ.exports=vR;vR.sync=Vbe;function vR(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){vR(t,e||{},function(o,s){o?i(o):n(s)})})}sb(t,e||{},function(n,i){n&&(n.code==="EACCES"||e&&e.ignoreErrors)&&(n=null,i=!1),r(n,i)})}function Vbe(t,e){try{return sb.sync(t,e||{})}catch(r){if(e&&e.ignoreErrors||r.code==="EACCES")return!1;throw r}}});var TZ=v((get,AZ)=>{var xl=process.platform==="win32"||process.env.OSTYPE==="cygwin"||process.env.OSTYPE==="msys",wZ=Ge("path"),Wbe=xl?";":":",xZ=SZ(),$Z=t=>Object.assign(new Error(`not found: ${t}`),{code:"ENOENT"}),kZ=(t,e)=>{let r=e.colon||Wbe,n=t.match(/\//)||xl&&t.match(/\\/)?[""]:[...xl?[process.cwd()]:[],...(e.path||process.env.PATH||"").split(r)],i=xl?e.pathExt||process.env.PATHEXT||".EXE;.CMD;.BAT;.COM":"",o=xl?i.split(r):[""];return xl&&t.indexOf(".")!==-1&&o[0]!==""&&o.unshift(""),{pathEnv:n,pathExt:o,pathExtExe:i}},EZ=(t,e,r)=>{typeof e=="function"&&(r=e,e={}),e||(e={});let{pathEnv:n,pathExt:i,pathExtExe:o}=kZ(t,e),s=[],a=l=>new Promise((u,d)=>{if(l===n.length)return e.all&&s.length?u(s):d($Z(t));let f=n[l],p=/^".*"$/.test(f)?f.slice(1,-1):f,m=wZ.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];xZ(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)},Kbe=(t,e)=>{e=e||{};let{pathEnv:r,pathExt:n,pathExtExe:i}=kZ(t,e),o=[];for(let s=0;s{"use strict";var OZ=(t={})=>{let e=t.env||process.env;return(t.platform||process.platform)!=="win32"?"PATH":Object.keys(e).reverse().find(n=>n.toUpperCase()==="PATH")||"Path"};SR.exports=OZ;SR.exports.default=OZ});var DZ=v((_et,CZ)=>{"use strict";var IZ=Ge("path"),Jbe=TZ(),Ybe=RZ();function PZ(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=Jbe.sync(t.command,{path:r[Ybe({env:r})],pathExt:e?IZ.delimiter:void 0})}catch{}finally{o&&process.chdir(n)}return s&&(s=IZ.resolve(i?t.options.cwd:"",s)),s}function Xbe(t){return PZ(t)||PZ(t,!0)}CZ.exports=Xbe});var NZ=v((bet,xR)=>{"use strict";var wR=/([()\][%!^"`<>&|;, *?])/g;function Qbe(t){return t=t.replace(wR,"^$1"),t}function eve(t,e){return t=`${t}`,t=t.replace(/(?=(\\+?)?)\1"/g,'$1$1\\"'),t=t.replace(/(?=(\\+?)?)\1$/,"$1$1"),t=`"${t}"`,t=t.replace(wR,"^$1"),e&&(t=t.replace(wR,"^$1")),t}xR.exports.command=Qbe;xR.exports.argument=eve});var MZ=v((vet,jZ)=>{"use strict";jZ.exports=/^#!(.*)/});var LZ=v((wet,FZ)=>{"use strict";var tve=MZ();FZ.exports=(t="")=>{let e=t.match(tve);if(!e)return null;let[r,n]=e[0].replace(/#! ?/,"").split(" "),i=r.split("/").pop();return i==="env"?n:n?`${i} ${n}`:i}});var UZ=v((xet,zZ)=>{"use strict";var $R=Ge("fs"),rve=LZ();function nve(t){let r=Buffer.alloc(150),n;try{n=$R.openSync(t,"r"),$R.readSync(n,r,0,150,0),$R.closeSync(n)}catch{}return rve(r.toString())}zZ.exports=nve});var GZ=v(($et,HZ)=>{"use strict";var ive=Ge("path"),qZ=DZ(),BZ=NZ(),ove=UZ(),sve=process.platform==="win32",ave=/\.(?:com|exe)$/i,cve=/node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;function lve(t){t.file=qZ(t);let e=t.file&&ove(t.file);return e?(t.args.unshift(t.file),t.command=e,qZ(t)):t.file}function uve(t){if(!sve)return t;let e=lve(t),r=!ave.test(e);if(t.options.forceShell||r){let n=cve.test(e);t.command=ive.normalize(t.command),t.command=BZ.command(t.command),t.args=t.args.map(o=>BZ.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 dve(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:uve(n)}HZ.exports=dve});var WZ=v((ket,VZ)=>{"use strict";var kR=process.platform==="win32";function ER(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 fve(t,e){if(!kR)return;let r=t.emit;t.emit=function(n,i){if(n==="exit"){let o=ZZ(i,e);if(o)return r.call(t,"error",o)}return r.apply(t,arguments)}}function ZZ(t,e){return kR&&t===1&&!e.file?ER(e.original,"spawn"):null}function pve(t,e){return kR&&t===1&&!e.file?ER(e.original,"spawnSync"):null}VZ.exports={hookChildProcess:fve,verifyENOENT:ZZ,verifyENOENTSync:pve,notFoundError:ER}});var YZ=v((Eet,$l)=>{"use strict";var KZ=Ge("child_process"),AR=GZ(),TR=WZ();function JZ(t,e,r){let n=AR(t,e,r),i=KZ.spawn(n.command,n.args,n.options);return TR.hookChildProcess(i,n),i}function mve(t,e,r){let n=AR(t,e,r),i=KZ.spawnSync(n.command,n.args,n.options);return i.error=i.error||TR.verifyENOENTSync(i.status,n),i}$l.exports=JZ;$l.exports.spawn=JZ;$l.exports.sync=mve;$l.exports._parse=AR;$l.exports._enoent=TR});function ab(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 XZ=y(()=>{});var QZ=y(()=>{});import{promisify as hve}from"node:util";import{execFile as gve,execFileSync as Iet}from"node:child_process";import e9 from"node:path";import{fileURLToPath as yve}from"node:url";function cb(t){return t instanceof URL?yve(t):t}function t9(t){return{*[Symbol.iterator](){let e=e9.resolve(cb(t)),r;for(;r!==e;)yield e,r=e,e=e9.resolve(e,"..")}}}var Det,Net,r9=y(()=>{QZ();Det=hve(gve);Net=10*1024*1024});import lb from"node:process";import Oa from"node:path";var _ve,bve,vve,n9,i9=y(()=>{XZ();r9();_ve=({cwd:t=lb.cwd(),path:e=lb.env[ab()],preferLocal:r=!0,execPath:n=lb.execPath,addExecPath:i=!0}={})=>{let o=Oa.resolve(cb(t)),s=[],a=e.split(Oa.delimiter);return r&&bve(s,a,o),i&&vve(s,a,n,o),e===""||e===Oa.delimiter?`${s.join(Oa.delimiter)}${e}`:[...s,e].join(Oa.delimiter)},bve=(t,e,r)=>{for(let n of t9(r)){let i=Oa.join(n,"node_modules/.bin");e.includes(i)||t.push(i)}},vve=(t,e,r,n)=>{let i=Oa.resolve(n,cb(r),"..");e.includes(i)||t.push(i)},n9=({env:t=lb.env,...e}={})=>{t={...t};let r=ab({env:t});return e.path=t[r],t[r]=_ve(e),t}});var o9,Qn,s9,a9,c9,ub,Gf,Zf,Ra=y(()=>{o9=(t,e,r)=>{let n=r?Zf:Gf,i=t instanceof Qn?{}:{cause:t};return new n(e,i)},Qn=class extends Error{},s9=(t,e)=>{Object.defineProperty(t.prototype,"name",{value:e,writable:!0,enumerable:!1,configurable:!0}),Object.defineProperty(t.prototype,c9,{value:!0,writable:!1,enumerable:!1,configurable:!1})},a9=t=>ub(t)&&c9 in t,c9=Symbol("isExecaError"),ub=t=>Object.prototype.toString.call(t)==="[object Error]",Gf=class extends Error{};s9(Gf,Gf.name);Zf=class extends Error{};s9(Zf,Zf.name)});var l9,Sve,u9,d9,f9=y(()=>{l9=()=>{let t=d9-u9+1;return Array.from({length:t},Sve)},Sve=(t,e)=>({name:`SIGRT${e+1}`,number:u9+e,action:"terminate",description:"Application-specific signal (realtime)",standard:"posix"}),u9=34,d9=64});var p9,m9=y(()=>{p9=[{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 wve}from"node:os";var OR,xve,h9=y(()=>{m9();f9();OR=()=>{let t=l9();return[...p9,...t].map(xve)},xve=({name:t,number:e,description:r,action:n,forced:i=!1,standard:o})=>{let{signals:{[t]:s}}=wve,a=s!==void 0;return{name:t,number:a?s:e,description:r,supported:a,action:n,forced:i,standard:o}}});import{constants as $ve}from"node:os";var kve,Eve,g9,Ave,Tve,Ove,Xet,y9=y(()=>{h9();kve=()=>{let t=OR();return Object.fromEntries(t.map(Eve))},Eve=({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}],g9=kve(),Ave=()=>{let t=OR(),e=65,r=Array.from({length:e},(n,i)=>Tve(i,t));return Object.assign({},...r)},Tve=(t,e)=>{let r=Ove(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}}},Ove=(t,e)=>{let r=e.find(({name:n})=>$ve.signals[n]===t);return r!==void 0?r:e.find(n=>n.number===t)},Xet=Ave()});import{constants as Vf}from"node:os";var b9,v9,S9,Rve,Ive,_9,Pve,RR,Cve,Dve,db,Wf=y(()=>{y9();b9=t=>{let e="option `killSignal`";if(t===0)throw new TypeError(`Invalid ${e}: 0 cannot be used.`);return S9(t,e)},v9=t=>t===0?t:S9(t,"`subprocess.kill()`'s argument"),S9=(t,e)=>{if(Number.isInteger(t))return Rve(t,e);if(typeof t=="string")return Pve(t,e);throw new TypeError(`Invalid ${e} ${String(t)}: it must be a string or an integer. +${RR()}`)},Rve=(t,e)=>{if(_9.has(t))return _9.get(t);throw new TypeError(`Invalid ${e} ${t}: this signal integer does not exist. +${RR()}`)},Ive=()=>new Map(Object.entries(Vf.signals).reverse().map(([t,e])=>[e,t])),_9=Ive(),Pve=(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. +${RR()}`)},RR=()=>`Available signal names: ${Cve()}. +Available signal numbers: ${Dve()}.`,Cve=()=>Object.keys(Vf.signals).sort().map(t=>`'${t}'`).join(", "),Dve=()=>[...new Set(Object.values(Vf.signals).sort((t,e)=>t-e))].join(", "),db=t=>g9[t].description});import{setTimeout as Nve}from"node:timers/promises";var w9,jve,x9,Mve,Fve,Lve,IR,fb=y(()=>{Ra();Wf();w9=t=>{if(t===!1)return t;if(t===!0)return jve;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},jve=1e3*5,x9=({kill:t,options:{forceKillAfterDelay:e,killSignal:r},onInternalError:n,context:i,controller:o},s,a)=>{let{signal:c,error:l}=Mve(s,a,r);Fve(l,n);let u=t(c);return Lve({kill:t,signal:c,forceKillAfterDelay:e,killSignal:r,killResult:u,context:i,controller:o}),u},Mve=(t,e,r)=>{let[n=r,i]=ub(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&&!ub(i))throw new TypeError(`The second argument is optional. If specified, it must be an error instance: ${i}`);return{signal:v9(n),error:i}},Fve=(t,e)=>{t!==void 0&&e.reject(t)},Lve=async({kill:t,signal:e,forceKillAfterDelay:r,killSignal:n,killResult:i,context:o,controller:s})=>{e===n&&i&&IR({kill:t,forceKillAfterDelay:r,context:o,controllerSignal:s.signal})},IR=async({kill:t,forceKillAfterDelay:e,context:r,controllerSignal:n})=>{if(e!==!1)try{await Nve(e,void 0,{signal:n}),t("SIGKILL")&&(r.isForcefullyTerminated??=!0)}catch{}}});import{once as zve}from"node:events";var pb,PR=y(()=>{pb=async(t,e)=>{t.aborted||await zve(t,"abort",{signal:e})}});var $9,k9,Uve,CR=y(()=>{PR();$9=({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)}`)},k9=({subprocess:t,cancelSignal:e,gracefulCancel:r,context:n,controller:i})=>e===void 0||r?[]:[Uve(t,e,n,i)],Uve=async(t,e,r,{signal:n})=>{throw await pb(e,n),r.terminationReason??="cancel",t.kill(),e.reason}});var kl,qve,DR,E9,A9,mb,T9,O9,R9,I9,P9,C9,Bve,Hve,Gve,ei,Zve,us,El,Al=y(()=>{kl=({methodName:t,isSubprocess:e,ipc:r,isConnected:n})=>{qve(t,e,r),DR(t,e,n)},qve=(t,e,r)=>{if(!r)throw new Error(`${ei(t,e)} can only be used if the \`ipc\` option is \`true\`.`)},DR=(t,e,r)=>{if(!r)throw new Error(`${ei(t,e)} cannot be used: the ${us(e)} has already exited or disconnected.`)},E9=t=>{throw new Error(`${ei("getOneMessage",t)} could not complete: the ${us(t)} exited or disconnected.`)},A9=t=>{throw new Error(`${ei("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([ - ${Jn("getOneMessage",t)}, - ${Jn("sendMessage",t,"message, {strict: true}")}, -]);`)},L_=(t,e)=>new Error(`${Jn("sendMessage",e)} failed when sending an acknowledgment response to the ${rs(e)}.`,{cause:t}),MZ=t=>{throw new Error(`${Jn("sendMessage",t)} failed: the ${rs(t)} is not listening to incoming messages.`)},FZ=t=>{throw new Error(`${Jn("sendMessage",t)} failed: the ${rs(t)} exited without listening to incoming messages.`)},LZ=()=>new Error(`\`cancelSignal\` aborted: the ${rs(!0)} disconnected.`),zZ=()=>{throw new Error("`getCancelSignal()` cannot be used without setting the `cancelSignal` subprocess option.")},UZ=({error:t,methodName:e,isSubprocess:r})=>{if(t.code==="EPIPE")throw new Error(`${Jn(e,r)} cannot be used: the ${rs(r)} is disconnecting.`,{cause:t})},qZ=({error:t,methodName:e,isSubprocess:r,message:n})=>{if(Mbe(t))throw new Error(`${Jn(e,r)}'s argument type is invalid: the message cannot be serialized: ${String(n)}.`,{cause:t})},Mbe=({code:t,message:e})=>Fbe.has(t)||Lbe.some(r=>e.includes(r)),Fbe=new Set(["ERR_MISSING_ARGS","ERR_INVALID_ARG_TYPE"]),Lbe=["could not be cloned","circular structure","call stack size exceeded"],Jn=(t,e,r="")=>t==="cancelSignal"?"`cancelSignal`'s `controller.abort()`":`${zbe(e)}${t}(${r})`,zbe=t=>t?"":"subprocess.",rs=t=>t?"parent process":"subprocess",dl=t=>{t.connected&&t.disconnect()}});var Ei,pl=y(()=>{Ei=()=>{let t={},e=new Promise((r,n)=>{Object.assign(t,{resolve:r,reject:n})});return Object.assign(e,t)}});var U_,ml,Ai,BZ,Ube,qbe,HZ,Bbe,GZ,Pf,z_,ns=y(()=>{po();U_=(t,e="stdin")=>{let{options:n,fileDescriptors:i}=Ai.get(t),o=BZ(i,e,!0),s=t.stdio[o];if(s===null)throw new TypeError(HZ(o,e,n,!0));return s},ml=(t,e="stdout")=>{let{options:n,fileDescriptors:i}=Ai.get(t),o=BZ(i,e,!1),s=o==="all"?t.all:t.stdio[o];if(s==null)throw new TypeError(HZ(o,e,n,!1));return s},Ai=new WeakMap,BZ=(t,e,r)=>{let n=Ube(e,r);return qbe(n,e,r,t),n},Ube=(t,e)=>{let r=CO(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(`"${Pf(e)}" must not be "${t}". + ${ei("getOneMessage",t)}, + ${ei("sendMessage",t,"message, {strict: true}")}, +]);`)},mb=(t,e)=>new Error(`${ei("sendMessage",e)} failed when sending an acknowledgment response to the ${us(e)}.`,{cause:t}),T9=t=>{throw new Error(`${ei("sendMessage",t)} failed: the ${us(t)} is not listening to incoming messages.`)},O9=t=>{throw new Error(`${ei("sendMessage",t)} failed: the ${us(t)} exited without listening to incoming messages.`)},R9=()=>new Error(`\`cancelSignal\` aborted: the ${us(!0)} disconnected.`),I9=()=>{throw new Error("`getCancelSignal()` cannot be used without setting the `cancelSignal` subprocess option.")},P9=({error:t,methodName:e,isSubprocess:r})=>{if(t.code==="EPIPE")throw new Error(`${ei(e,r)} cannot be used: the ${us(r)} is disconnecting.`,{cause:t})},C9=({error:t,methodName:e,isSubprocess:r,message:n})=>{if(Bve(t))throw new Error(`${ei(e,r)}'s argument type is invalid: the message cannot be serialized: ${String(n)}.`,{cause:t})},Bve=({code:t,message:e})=>Hve.has(t)||Gve.some(r=>e.includes(r)),Hve=new Set(["ERR_MISSING_ARGS","ERR_INVALID_ARG_TYPE"]),Gve=["could not be cloned","circular structure","call stack size exceeded"],ei=(t,e,r="")=>t==="cancelSignal"?"`cancelSignal`'s `controller.abort()`":`${Zve(e)}${t}(${r})`,Zve=t=>t?"":"subprocess.",us=t=>t?"parent process":"subprocess",El=t=>{t.connected&&t.disconnect()}});var Ii,Tl=y(()=>{Ii=()=>{let t={},e=new Promise((r,n)=>{Object.assign(t,{resolve:r,reject:n})});return Object.assign(e,t)}});var gb,Ol,Pi,D9,Vve,Wve,N9,Kve,j9,Kf,hb,ds=y(()=>{vo();gb=(t,e="stdin")=>{let{options:n,fileDescriptors:i}=Pi.get(t),o=D9(i,e,!0),s=t.stdio[o];if(s===null)throw new TypeError(N9(o,e,n,!0));return s},Ol=(t,e="stdout")=>{let{options:n,fileDescriptors:i}=Pi.get(t),o=D9(i,e,!1),s=o==="all"?t.all:t.stdio[o];if(s==null)throw new TypeError(N9(o,e,n,!1));return s},Pi=new WeakMap,D9=(t,e,r)=>{let n=Vve(e,r);return Wve(n,e,r,t),n},Vve=(t,e)=>{let r=pR(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}". It must be ${n} or "fd3", "fd4" (and so on). -It is optional and defaults to "${i}".`)},qbe=(t,e,r,n)=>{let i=n[GZ(t)];if(i===void 0)throw new TypeError(`"${Pf(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(`"${Pf(r)}" must not be ${e}. It must be a readable stream, not writable.`);if(i.direction!=="input"&&r)throw new TypeError(`"${Pf(r)}" must not be ${e}. It must be a writable stream, not readable.`)},HZ=(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}=Bbe(t,r);return`The "${i}: ${z_(o)}" option is incompatible with using "${Pf(n)}: ${z_(e)}". -Please set this option with "pipe" instead.`},Bbe=(t,{stdin:e,stdout:r,stderr:n,stdio:i})=>{let o=GZ(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]}},GZ=t=>t==="all"?1:t,Pf=t=>t?"to":"from",z_=t=>typeof t=="string"?`'${t}'`:typeof t=="number"?`${t}`:"Stream"});import{addAbortListener as Hbe}from"node:events";var Sa,q_=y(()=>{Sa=(t,e,r)=>{let n=t.getMaxListeners();n===0||n===Number.POSITIVE_INFINITY||(t.setMaxListeners(n+e),Hbe(r,()=>{t.setMaxListeners(t.getMaxListeners()-e)}))}});var B_,tR,H_,rR,ZZ,VZ,Cf=y(()=>{B_=(t,e)=>{e&&tR(t)},tR=t=>{t.refCounted()},H_=(t,e)=>{e&&rR(t)},rR=t=>{t.unrefCounted()},ZZ=(t,e)=>{e&&(rR(t),rR(t))},VZ=(t,e)=>{e&&(tR(t),tR(t))}});import{once as Gbe}from"node:events";import{scheduler as Zbe}from"node:timers/promises";var WZ,KZ,G_,JZ=y(()=>{V_();Cf();Z_();W_();WZ=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n},i)=>{if(XZ(i)||e9(i))return;G_.has(t)||G_.set(t,[]);let o=G_.get(t);if(o.push(i),!(o.length>1))for(;o.length>0;){await QZ(t,n,i),await Zbe.yield();let s=await YZ({wrappedMessage:o[0],anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n});o.shift(),n.emit("message",s),n.emit("message:done")}},KZ=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n,boundOnMessage:i})=>{nR();let o=G_.get(t);for(;o?.length>0;)await Gbe(n,"message:done");t.removeListener("message",i),VZ(e,r),n.connected=!1,n.emit("disconnect")},G_=new WeakMap});import{EventEmitter as Vbe}from"node:events";var is,K_,Wbe,J_,Df=y(()=>{JZ();Cf();is=(t,e,r)=>{if(K_.has(t))return K_.get(t);let n=new Vbe;return n.connected=!0,K_.set(t,n),Wbe({ipcEmitter:n,anyProcess:t,channel:e,isSubprocess:r}),n},K_=new WeakMap,Wbe=({ipcEmitter:t,anyProcess:e,channel:r,isSubprocess:n})=>{let i=WZ.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t});e.on("message",i),e.once("disconnect",KZ.bind(void 0,{anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:t,boundOnMessage:i})),ZZ(r,n)},J_=t=>{let e=K_.get(t);return e===void 0?t.channel!==null:e.connected}});import{once as Kbe}from"node:events";var t9,Jbe,r9,YZ,XZ,n9,Y_,Ybe,X_,i9,Z_=y(()=>{pl();q_();tb();fl();Df();V_();t9=({anyProcess:t,channel:e,isSubprocess:r,message:n,strict:i})=>{if(!i)return n;let o=is(t,e,r),s=Q_(t,o);return{id:Jbe++,type:X_,message:n,hasListeners:s}},Jbe=0n,r9=(t,e)=>{if(!(e?.type!==X_||e.hasListeners))for(let{id:r}of t)r!==void 0&&Y_[r].resolve({isDeadlock:!0,hasListeners:!1})},YZ=async({wrappedMessage:t,anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:i})=>{if(t?.type!==X_||!e.connected)return t;let{id:o,message:s}=t,a={id:o,type:i9,message:Q_(e,i)};try{await eb({anyProcess:e,channel:r,isSubprocess:n,ipc:!0},a)}catch(c){i.emit("strict:error",c)}return s},XZ=t=>{if(t?.type!==i9)return!1;let{id:e,message:r}=t;return Y_[e]?.resolve({isDeadlock:!1,hasListeners:r}),!0},n9=async(t,e,r)=>{if(t?.type!==X_)return;let n=Ei();Y_[t.id]=n;let i=new AbortController;try{let{isDeadlock:o,hasListeners:s}=await Promise.race([n,Ybe(e,r,i)]);o&&jZ(r),s||MZ(r)}finally{i.abort(),delete Y_[t.id]}},Y_={},Ybe=async(t,e,{signal:r})=>{Sa(t,1,r),await Kbe(t,"disconnect",{signal:r}),FZ(e)},X_="execa:ipc:request",i9="execa:ipc:response"});var o9,s9,QZ,Nf,Q_,Xbe,V_=y(()=>{pl();po();ns();Z_();o9=(t,e,r)=>{Nf.has(t)||Nf.set(t,new Set);let n=Nf.get(t),i=Ei(),o=r?e.id:void 0,s={onMessageSent:i,id:o};return n.add(s),{outgoingMessages:n,outgoingMessage:s}},s9=({outgoingMessages:t,outgoingMessage:e})=>{t.delete(e),e.onMessageSent.resolve()},QZ=async(t,e,r)=>{for(;!Q_(t,e)&&Nf.get(t)?.size>0;){let n=[...Nf.get(t)];r9(n,r),await Promise.all(n.map(({onMessageSent:i})=>i))}},Nf=new WeakMap,Q_=(t,e)=>e.listenerCount("message")>Xbe(t),Xbe=t=>Ai.has(t)&&!fo(Ai.get(t).options.buffer,"ipc")?1:0});import{promisify as Qbe}from"node:util";var eb,eve,oR,tve,iR,tb=y(()=>{fl();V_();Z_();eb=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},i,{strict:o=!1}={})=>{let s="sendMessage";return ul({methodName:s,isSubprocess:r,ipc:n,isConnected:t.connected}),eve({anyProcess:t,channel:e,methodName:s,isSubprocess:r,message:i,strict:o})},eve=async({anyProcess:t,channel:e,methodName:r,isSubprocess:n,message:i,strict:o})=>{let s=t9({anyProcess:t,channel:e,isSubprocess:n,message:i,strict:o}),a=o9(t,s,o);try{await oR({anyProcess:t,methodName:r,isSubprocess:n,wrappedMessage:s,message:i})}catch(c){throw dl(t),c}finally{s9(a)}},oR=async({anyProcess:t,methodName:e,isSubprocess:r,wrappedMessage:n,message:i})=>{let o=tve(t);try{await Promise.all([n9(n,t,r),o(n)])}catch(s){throw UZ({error:s,methodName:e,isSubprocess:r}),qZ({error:s,methodName:e,isSubprocess:r,message:i}),s}},tve=t=>{if(iR.has(t))return iR.get(t);let e=Qbe(t.send.bind(t));return iR.set(t,e),e},iR=new WeakMap});import{scheduler as rve}from"node:timers/promises";var c9,l9,nve,a9,e9,u9,nR,sR,W_=y(()=>{tb();Df();fl();c9=(t,e)=>{let r="cancelSignal";return eR(r,!1,t.connected),oR({anyProcess:t,methodName:r,isSubprocess:!1,wrappedMessage:{type:u9,message:e},message:e})},l9=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>(await nve({anyProcess:t,channel:e,isSubprocess:r,ipc:n}),sR.signal),nve=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>{if(!a9){if(a9=!0,!n){zZ();return}if(e===null){nR();return}is(t,e,r),await rve.yield()}},a9=!1,e9=t=>t?.type!==u9?!1:(sR.abort(t.message),!0),u9="execa:ipc:cancel",nR=()=>{sR.abort(LZ())},sR=new AbortController});var d9,f9,ive,ove,aR=y(()=>{XO();W_();M_();d9=({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.")}},f9=({subprocess:t,cancelSignal:e,gracefulCancel:r,forceKillAfterDelay:n,context:i,controller:o})=>r?[ive({subprocess:t,cancelSignal:e,forceKillAfterDelay:n,context:i,controller:o})]:[],ive=async({subprocess:t,cancelSignal:e,forceKillAfterDelay:r,context:n,controller:{signal:i}})=>{await F_(e,i);let o=ove(e);throw await c9(t,o),YO({kill:t.kill,forceKillAfterDelay:r,context:n,controllerSignal:i}),n.terminationReason??="gracefulCancel",e.reason},ove=({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 sve}from"node:timers/promises";var p9,m9,ave,cR=y(()=>{va();p9=({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})`)},m9=(t,e,r,n)=>e===0||e===void 0?[]:[ave(t,e,r,n)],ave=async(t,e,r,{signal:n})=>{throw await sve(e,void 0,{signal:n}),r.terminationReason??="timeout",t.kill(),new Kn}});import{execPath as cve,execArgv as lve}from"node:process";import h9 from"node:path";var g9,y9,lR=y(()=>{il();g9=({options:t})=>{if(t.node===!1)throw new TypeError('The "node" option cannot be false with `execaNode()`.');return{options:{...t,node:!0}}},y9=(t,e,{node:r=!1,nodePath:n=cve,nodeOptions:i=lve.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=nl(n,'The "nodePath" option'),l=h9.resolve(o,c),u={...a,nodePath:l,node:r,cwd:o};if(!r)return[t,e,u];if(h9.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 uve}from"node:v8";var _9,dve,fve,pve,b9,uR=y(()=>{_9=({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`.");pve[r](t)}},dve=t=>{try{uve(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with a structured clone.",{cause:e})}},fve=t=>{try{JSON.stringify(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with JSON.",{cause:e})}},pve={advanced:dve,json:fve},b9=async(t,e)=>{e!==void 0&&await t.sendMessage(e)}});var S9,mve,rn,dR,hve,v9,rb,wa=y(()=>{S9=({encoding:t})=>{if(dR.has(t))return;let e=hve(t);if(e!==void 0)throw new TypeError(`Invalid option \`encoding: ${rb(t)}\`. -Please rename it to ${rb(e)}.`);let r=[...dR].map(n=>rb(n)).join(", ");throw new TypeError(`Invalid option \`encoding: ${rb(t)}\`. -Please rename it to one of: ${r}.`)},mve=new Set(["utf8","utf16le"]),rn=new Set(["buffer","hex","base64","base64url","latin1","ascii"]),dR=new Set([...mve,...rn]),hve=t=>{if(t===null)return"buffer";if(typeof t!="string")return;let e=t.toLowerCase();if(e in v9)return v9[e];if(dR.has(e))return e},v9={"utf-8":"utf8","utf-16le":"utf16le","ucs-2":"utf16le",ucs2:"utf16le",binary:"latin1"},rb=t=>typeof t=="string"?`"${t}"`:String(t)});import{statSync as gve}from"node:fs";import yve from"node:path";import _ve from"node:process";var w9,x9,$9,fR=y(()=>{il();w9=(t=x9())=>{let e=nl(t,'The "cwd" option');return yve.resolve(e)},x9=()=>{try{return _ve.cwd()}catch(t){throw t.message=`The current directory does not exist. -${t.message}`,t}},$9=(t,e)=>{if(e===x9())return t;let r;try{r=gve(e)}catch(n){return`The "cwd" option is invalid: ${e}. +It is optional and defaults to "${i}".`)},Wve=(t,e,r,n)=>{let i=n[j9(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.`)},N9=(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}=Kve(t,r);return`The "${i}: ${hb(o)}" option is incompatible with using "${Kf(n)}: ${hb(e)}". +Please set this option with "pipe" instead.`},Kve=(t,{stdin:e,stdout:r,stderr:n,stdio:i})=>{let o=j9(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]}},j9=t=>t==="all"?1:t,Kf=t=>t?"to":"from",hb=t=>typeof t=="string"?`'${t}'`:typeof t=="number"?`${t}`:"Stream"});import{addAbortListener as Jve}from"node:events";var Ia,yb=y(()=>{Ia=(t,e,r)=>{let n=t.getMaxListeners();n===0||n===Number.POSITIVE_INFINITY||(t.setMaxListeners(n+e),Jve(r,()=>{t.setMaxListeners(t.getMaxListeners()-e)}))}});var _b,NR,bb,jR,M9,F9,Jf=y(()=>{_b=(t,e)=>{e&&NR(t)},NR=t=>{t.refCounted()},bb=(t,e)=>{e&&jR(t)},jR=t=>{t.unrefCounted()},M9=(t,e)=>{e&&(jR(t),jR(t))},F9=(t,e)=>{e&&(NR(t),NR(t))}});import{once as Yve}from"node:events";import{scheduler as Xve}from"node:timers/promises";var L9,z9,vb,U9=y(()=>{wb();Jf();Sb();xb();L9=async({anyProcess:t,channel:e,isSubprocess:r,ipcEmitter:n},i)=>{if(B9(i)||G9(i))return;vb.has(t)||vb.set(t,[]);let o=vb.get(t);if(o.push(i),!(o.length>1))for(;o.length>0;){await H9(t,n,i),await Xve.yield();let s=await q9({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})=>{MR();let o=vb.get(t);for(;o?.length>0;)await Yve(n,"message:done");t.removeListener("message",i),F9(e,r),n.connected=!1,n.emit("disconnect")},vb=new WeakMap});import{EventEmitter as Qve}from"node:events";var fs,$b,eSe,kb,Yf=y(()=>{U9();Jf();fs=(t,e,r)=>{if($b.has(t))return $b.get(t);let n=new Qve;return n.connected=!0,$b.set(t,n),eSe({ipcEmitter:n,anyProcess:t,channel:e,isSubprocess:r}),n},$b=new WeakMap,eSe=({ipcEmitter:t,anyProcess:e,channel:r,isSubprocess:n})=>{let i=L9.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})),M9(r,n)},kb=t=>{let e=$b.get(t);return e===void 0?t.channel!==null:e.connected}});import{once as tSe}from"node:events";var Z9,rSe,V9,q9,B9,W9,Eb,nSe,Ab,K9,Sb=y(()=>{Tl();yb();Rb();Al();Yf();wb();Z9=({anyProcess:t,channel:e,isSubprocess:r,message:n,strict:i})=>{if(!i)return n;let o=fs(t,e,r),s=Tb(t,o);return{id:rSe++,type:Ab,message:n,hasListeners:s}},rSe=0n,V9=(t,e)=>{if(!(e?.type!==Ab||e.hasListeners))for(let{id:r}of t)r!==void 0&&Eb[r].resolve({isDeadlock:!0,hasListeners:!1})},q9=async({wrappedMessage:t,anyProcess:e,channel:r,isSubprocess:n,ipcEmitter:i})=>{if(t?.type!==Ab||!e.connected)return t;let{id:o,message:s}=t,a={id:o,type:K9,message:Tb(e,i)};try{await Ob({anyProcess:e,channel:r,isSubprocess:n,ipc:!0},a)}catch(c){i.emit("strict:error",c)}return s},B9=t=>{if(t?.type!==K9)return!1;let{id:e,message:r}=t;return Eb[e]?.resolve({isDeadlock:!1,hasListeners:r}),!0},W9=async(t,e,r)=>{if(t?.type!==Ab)return;let n=Ii();Eb[t.id]=n;let i=new AbortController;try{let{isDeadlock:o,hasListeners:s}=await Promise.race([n,nSe(e,r,i)]);o&&A9(r),s||T9(r)}finally{i.abort(),delete Eb[t.id]}},Eb={},nSe=async(t,e,{signal:r})=>{Ia(t,1,r),await tSe(t,"disconnect",{signal:r}),O9(e)},Ab="execa:ipc:request",K9="execa:ipc:response"});var J9,Y9,H9,Xf,Tb,iSe,wb=y(()=>{Tl();vo();ds();Sb();J9=(t,e,r)=>{Xf.has(t)||Xf.set(t,new Set);let n=Xf.get(t),i=Ii(),o=r?e.id:void 0,s={onMessageSent:i,id:o};return n.add(s),{outgoingMessages:n,outgoingMessage:s}},Y9=({outgoingMessages:t,outgoingMessage:e})=>{t.delete(e),e.onMessageSent.resolve()},H9=async(t,e,r)=>{for(;!Tb(t,e)&&Xf.get(t)?.size>0;){let n=[...Xf.get(t)];V9(n,r),await Promise.all(n.map(({onMessageSent:i})=>i))}},Xf=new WeakMap,Tb=(t,e)=>e.listenerCount("message")>iSe(t),iSe=t=>Pi.has(t)&&!bo(Pi.get(t).options.buffer,"ipc")?1:0});import{promisify as oSe}from"node:util";var Ob,sSe,LR,aSe,FR,Rb=y(()=>{Al();wb();Sb();Ob=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},i,{strict:o=!1}={})=>{let s="sendMessage";return kl({methodName:s,isSubprocess:r,ipc:n,isConnected:t.connected}),sSe({anyProcess:t,channel:e,methodName:s,isSubprocess:r,message:i,strict:o})},sSe=async({anyProcess:t,channel:e,methodName:r,isSubprocess:n,message:i,strict:o})=>{let s=Z9({anyProcess:t,channel:e,isSubprocess:n,message:i,strict:o}),a=J9(t,s,o);try{await LR({anyProcess:t,methodName:r,isSubprocess:n,wrappedMessage:s,message:i})}catch(c){throw El(t),c}finally{Y9(a)}},LR=async({anyProcess:t,methodName:e,isSubprocess:r,wrappedMessage:n,message:i})=>{let o=aSe(t);try{await Promise.all([W9(n,t,r),o(n)])}catch(s){throw P9({error:s,methodName:e,isSubprocess:r}),C9({error:s,methodName:e,isSubprocess:r,message:i}),s}},aSe=t=>{if(FR.has(t))return FR.get(t);let e=oSe(t.send.bind(t));return FR.set(t,e),e},FR=new WeakMap});import{scheduler as cSe}from"node:timers/promises";var Q9,eV,lSe,X9,G9,tV,MR,zR,xb=y(()=>{Rb();Yf();Al();Q9=(t,e)=>{let r="cancelSignal";return DR(r,!1,t.connected),LR({anyProcess:t,methodName:r,isSubprocess:!1,wrappedMessage:{type:tV,message:e},message:e})},eV=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>(await lSe({anyProcess:t,channel:e,isSubprocess:r,ipc:n}),zR.signal),lSe=async({anyProcess:t,channel:e,isSubprocess:r,ipc:n})=>{if(!X9){if(X9=!0,!n){I9();return}if(e===null){MR();return}fs(t,e,r),await cSe.yield()}},X9=!1,G9=t=>t?.type!==tV?!1:(zR.abort(t.message),!0),tV="execa:ipc:cancel",MR=()=>{zR.abort(R9())},zR=new AbortController});var rV,nV,uSe,dSe,UR=y(()=>{PR();xb();fb();rV=({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.")}},nV=({subprocess:t,cancelSignal:e,gracefulCancel:r,forceKillAfterDelay:n,context:i,controller:o})=>r?[uSe({subprocess:t,cancelSignal:e,forceKillAfterDelay:n,context:i,controller:o})]:[],uSe=async({subprocess:t,cancelSignal:e,forceKillAfterDelay:r,context:n,controller:{signal:i}})=>{await pb(e,i);let o=dSe(e);throw await Q9(t,o),IR({kill:t.kill,forceKillAfterDelay:r,context:n,controllerSignal:i}),n.terminationReason??="gracefulCancel",e.reason},dSe=({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 fSe}from"node:timers/promises";var iV,oV,pSe,qR=y(()=>{Ra();iV=({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})`)},oV=(t,e,r,n)=>e===0||e===void 0?[]:[pSe(t,e,r,n)],pSe=async(t,e,r,{signal:n})=>{throw await fSe(e,void 0,{signal:n}),r.terminationReason??="timeout",t.kill(),new Qn}});import{execPath as mSe,execArgv as hSe}from"node:process";import sV from"node:path";var aV,cV,BR=y(()=>{bl();aV=({options:t})=>{if(t.node===!1)throw new TypeError('The "node" option cannot be false with `execaNode()`.');return{options:{...t,node:!0}}},cV=(t,e,{node:r=!1,nodePath:n=mSe,nodeOptions:i=hSe.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=_l(n,'The "nodePath" option'),l=sV.resolve(o,c),u={...a,nodePath:l,node:r,cwd:o};if(!r)return[t,e,u];if(sV.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 gSe}from"node:v8";var lV,ySe,_Se,bSe,uV,HR=y(()=>{lV=({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`.");bSe[r](t)}},ySe=t=>{try{gSe(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with a structured clone.",{cause:e})}},_Se=t=>{try{JSON.stringify(t)}catch(e){throw new Error("The `ipcInput` option is not serializable with JSON.",{cause:e})}},bSe={advanced:ySe,json:_Se},uV=async(t,e)=>{e!==void 0&&await t.sendMessage(e)}});var fV,vSe,nn,GR,SSe,dV,Ib,Pa=y(()=>{fV=({encoding:t})=>{if(GR.has(t))return;let e=SSe(t);if(e!==void 0)throw new TypeError(`Invalid option \`encoding: ${Ib(t)}\`. +Please rename it to ${Ib(e)}.`);let r=[...GR].map(n=>Ib(n)).join(", ");throw new TypeError(`Invalid option \`encoding: ${Ib(t)}\`. +Please rename it to one of: ${r}.`)},vSe=new Set(["utf8","utf16le"]),nn=new Set(["buffer","hex","base64","base64url","latin1","ascii"]),GR=new Set([...vSe,...nn]),SSe=t=>{if(t===null)return"buffer";if(typeof t!="string")return;let e=t.toLowerCase();if(e in dV)return dV[e];if(GR.has(e))return e},dV={"utf-8":"utf8","utf-16le":"utf16le","ucs-2":"utf16le",ucs2:"utf16le",binary:"latin1"},Ib=t=>typeof t=="string"?`"${t}"`:String(t)});import{statSync as wSe}from"node:fs";import xSe from"node:path";import $Se from"node:process";var pV,mV,hV,ZR=y(()=>{bl();pV=(t=mV())=>{let e=_l(t,'The "cwd" option');return xSe.resolve(e)},mV=()=>{try{return $Se.cwd()}catch(t){throw t.message=`The current directory does not exist. +${t.message}`,t}},hV=(t,e)=>{if(e===mV())return t;let r;try{r=wSe(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 bve from"node:path";import k9 from"node:process";var E9,nb,vve,Sve,pR=y(()=>{E9=Et(sZ(),1);pZ();M_();If();QO();aR();cR();lR();uR();wa();fR();il();po();nb=(t,e,r)=>{r.cwd=w9(r.cwd);let[n,i,o]=y9(t,e,r),{command:s,args:a,options:c}=E9.default._parse(n,i,o),l=KH(c),u=vve(l);return p9(u),S9(u),_9(u),CZ(u),d9(u),u.shell=TO(u.shell),u.env=Sve(u),u.killSignal=TZ(u.killSignal),u.forceKillAfterDelay=IZ(u.forceKillAfterDelay),u.lines=u.lines.map((d,f)=>d&&!rn.has(u.encoding)&&u.buffer[f]),k9.platform==="win32"&&bve.basename(s,".exe")==="cmd"&&a.unshift("/q"),{file:s,commandArguments:a,options:u}},vve=({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}),Sve=({env:t,extendEnv:e,preferLocal:r,node:n,localDirectory:i,nodePath:o})=>{let s=e?{...k9.env,...t}:t;return r||n?fZ({env:s,cwd:i,execPath:o,preferLocal:r,addExecPath:n}):s}});var ib,mR=y(()=>{ib=(t,e,r)=>r.shell&&e.length>0?[[t,...e].join(" "),[],r]:[t,e,r]});function hl(t){if(typeof t=="string")return wve(t);if(!(ArrayBuffer.isView(t)&&t.BYTES_PER_ELEMENT===1))throw new Error("Input must be a string or a Uint8Array");return xve(t)}var wve,xve,A9,$ve,T9,kve,hR=y(()=>{wve=t=>t.at(-1)===A9?t.slice(0,t.at(-2)===T9?-2:-1):t,xve=t=>t.at(-1)===$ve?t.subarray(0,t.at(-2)===kve?-2:-1):t,A9=` -`,$ve=A9.codePointAt(0),T9="\r",kve=T9.codePointAt(0)});function Yn(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 gR(t,{checkOpen:e=!0}={}){return Yn(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 xa(t,{checkOpen:e=!0}={}){return Yn(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 yR(t,e){return gR(t,e)&&xa(t,e)}var $a=y(()=>{});function O9(){return this[bR].next()}function R9(t){return this[bR].return(t)}function vR({preventCancel:t=!1}={}){let e=this.getReader(),r=new _R(e,t),n=Object.create(Ave);return n[bR]=r,n}var Eve,_R,bR,Ave,I9=y(()=>{Eve=Object.getPrototypeOf(Object.getPrototypeOf(async function*(){}).prototype),_R=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}}},bR=Symbol();Object.defineProperty(O9,"name",{value:"next"});Object.defineProperty(R9,"name",{value:"return"});Ave=Object.create(Eve,{next:{enumerable:!0,configurable:!0,writable:!0,value:O9},return:{enumerable:!0,configurable:!0,writable:!0,value:R9}})});var P9=y(()=>{});var C9=y(()=>{I9();P9()});var D9,Tve,Ove,Rve,jf,SR=y(()=>{$a();C9();D9=t=>{if(xa(t,{checkOpen:!1})&&jf.on!==void 0)return Ove(t);if(typeof t?.[Symbol.asyncIterator]=="function")return t;if(Tve.call(t)==="[object ReadableStream]")return vR.call(t);throw new TypeError("The first argument must be a Readable, a ReadableStream, or an async iterable.")},{toString:Tve}=Object.prototype,Ove=async function*(t){let e=new AbortController,r={};Rve(t,e,r);try{for await(let[n]of jf.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()}},Rve=async(t,e,r)=>{try{await jf.finished(t,{cleanup:!0,readable:!0,writable:!1,error:!1})}catch(n){r.error=n}finally{e.abort()}},jf={}});var gl,Ive,M9,N9,Pve,j9,Ti,Mf=y(()=>{SR();gl=async(t,{init:e,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,finalize:a},{maxBuffer:c=Number.POSITIVE_INFINITY}={})=>{let l=D9(t),u=e();u.length=0;try{for await(let d of l){let f=Pve(d),p=r[f](d,u);M9({convertedChunk:p,state:u,getSize:n,truncateChunk:i,addChunk:o,maxBuffer:c})}return Ive({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}},Ive=({state:t,getSize:e,truncateChunk:r,addChunk:n,getFinalChunk:i,maxBuffer:o})=>{let s=i(t);s!==void 0&&M9({convertedChunk:s,state:t,getSize:e,truncateChunk:r,addChunk:n,maxBuffer:o})},M9=({convertedChunk:t,state:e,getSize:r,truncateChunk:n,addChunk:i,maxBuffer:o})=>{let s=r(t),a=e.length+s;if(a<=o){N9(t,e,i,a);return}let c=n(t,o-e.length);throw c!==void 0&&N9(c,e,i,o),new Ti},N9=(t,e,r,n)=>{e.contents=r(t,e,n),e.length=n},Pve=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=j9.call(t);return r==="[object ArrayBuffer]"?"arrayBuffer":r==="[object DataView]"?"dataView":Number.isInteger(t.byteLength)&&Number.isInteger(t.byteOffset)&&j9.call(t.buffer)==="[object ArrayBuffer]"?"typedArray":"others"},{toString:j9}=Object.prototype,Ti=class extends Error{name="MaxBufferError";constructor(){super("maxBuffer exceeded")}}});var mo,Ff,ob,sb,ab,cb=y(()=>{mo=t=>t,Ff=()=>{},ob=({contents:t})=>t,sb=t=>{throw new Error(`Streams in object mode are not supported: ${String(t)}`)},ab=t=>t.length});async function lb(t,e){return gl(t,jve,e)}var Cve,Dve,Nve,jve,F9=y(()=>{Mf();cb();Cve=()=>({contents:[]}),Dve=()=>1,Nve=(t,{contents:e})=>(e.push(t),e),jve={init:Cve,convertChunk:{string:mo,buffer:mo,arrayBuffer:mo,dataView:mo,typedArray:mo,others:mo},getSize:Dve,truncateChunk:Ff,addChunk:Nve,getFinalChunk:Ff,finalize:ob}});async function ub(t,e){return gl(t,Gve,e)}var Mve,Fve,Lve,L9,z9,zve,Uve,qve,Bve,q9,U9,Hve,B9,Gve,H9=y(()=>{Mf();cb();Mve=()=>({contents:new ArrayBuffer(0)}),Fve=t=>Lve.encode(t),Lve=new TextEncoder,L9=t=>new Uint8Array(t),z9=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),zve=(t,e)=>t.slice(0,e),Uve=(t,{contents:e,length:r},n)=>{let i=B9()?Bve(e,n):qve(e,n);return new Uint8Array(i).set(t,r),i},qve=(t,e)=>{if(e<=t.byteLength)return t;let r=new ArrayBuffer(q9(e));return new Uint8Array(r).set(new Uint8Array(t),0),r},Bve=(t,e)=>{if(e<=t.maxByteLength)return t.resize(e),t;let r=new ArrayBuffer(e,{maxByteLength:q9(e)});return new Uint8Array(r).set(new Uint8Array(t),0),r},q9=t=>U9**Math.ceil(Math.log(t)/Math.log(U9)),U9=2,Hve=({contents:t,length:e})=>B9()?t:t.slice(0,e),B9=()=>"resize"in ArrayBuffer.prototype,Gve={init:Mve,convertChunk:{string:Fve,buffer:L9,arrayBuffer:L9,dataView:z9,typedArray:z9,others:sb},getSize:ab,truncateChunk:zve,addChunk:Uve,getFinalChunk:Ff,finalize:Hve}});async function fb(t,e){return gl(t,Jve,e)}var Zve,db,Vve,Wve,Kve,Jve,G9=y(()=>{Mf();cb();Zve=()=>({contents:"",textDecoder:new TextDecoder}),db=(t,{textDecoder:e})=>e.decode(t,{stream:!0}),Vve=(t,{contents:e})=>e+t,Wve=(t,e)=>t.slice(0,e),Kve=({textDecoder:t})=>{let e=t.decode();return e===""?void 0:e},Jve={init:Zve,convertChunk:{string:mo,buffer:db,arrayBuffer:db,dataView:db,typedArray:db,others:sb},getSize:ab,truncateChunk:Wve,addChunk:Vve,getFinalChunk:Kve,finalize:ob}});var Z9=y(()=>{F9();H9();G9();Mf()});import{on as Yve}from"node:events";import{finished as Xve}from"node:stream/promises";var pb=y(()=>{SR();Z9();Object.assign(jf,{on:Yve,finished:Xve})});var V9,Qve,W9,K9,eSe,J9,Y9,mb,ka=y(()=>{pb();uo();po();V9=({error:t,stream:e,readableObjectMode:r,lines:n,encoding:i,fdNumber:o})=>{if(!(t instanceof Ti))throw t;if(o==="all")return t;let s=Qve(r,n,i);throw t.maxBufferInfo={fdNumber:o,unit:s},e.destroy(),t},Qve=(t,e,r)=>t?"objects":e?"lines":r==="buffer"?"bytes":"characters",W9=(t,e,r)=>{if(e.length!==r)return;let n=new Ti;throw n.maxBufferInfo={fdNumber:"ipc"},n},K9=(t,e)=>{let{streamName:r,threshold:n,unit:i}=eSe(t,e);return`Command's ${r} was larger than ${n} ${i}`},eSe=(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=fo(e,r);return r==="ipc"?{streamName:"IPC output",threshold:i,unit:"messages"}:{streamName:v_(r),threshold:i,unit:n}},J9=(t,e,r)=>t?.code==="ENOBUFS"&&e!==null&&e.some(n=>n!==null&&n.length>mb(r)),Y9=(t,e,r)=>{if(!e)return t;let n=mb(r);return t.length>n?t.slice(0,n):t},mb=([,t])=>t});import{inspect as tSe}from"node:util";var Q9,rSe,nSe,iSe,oSe,sSe,X9,eV=y(()=>{hR();tn();fR();x_();ka();If();va();Q9=({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=rSe({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=iSe(n,b),w=x===void 0?"":` -${x}`,O=`${S}: ${a}${w}`,A=e===void 0?[t[2],t[1]]:[e],E=[O,...A,...t.slice(3),r.map(C=>oSe(C)).join(` -`)].map(C=>Af(hl(sSe(C)))).filter(Boolean).join(` - -`);return{originalMessage:x,shortMessage:O,message:E}},rSe=({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=nSe(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?`${K9(t,i)}${m}`:o!==void 0?`Command failed with ${o}${m}`:d?`Command was killed with ${p} (${j_(p)})${m}`:s!==void 0?`Command was killed with ${s} (${a})`:c!==void 0?`Command failed with exit code ${c}`:"Command failed"},nSe=(t,e)=>t?` and was forcefully terminated after ${e} milliseconds`:"",iSe=(t,e)=>{if(t instanceof Kn)return;let r=gZ(t)?t.originalMessage:String(t?.message??t),n=Af($9(r,e));return n===""?void 0:n},oSe=t=>typeof t=="string"?t:tSe(t),sSe=t=>Array.isArray(t)?t.map(e=>hl(X9(e))).filter(Boolean).join(` -`):X9(t),X9=t=>typeof t=="string"?t:Ft(t)?__(t):""});var hb,yl,Lf,aSe,tV,cSe,zf=y(()=>{If();O_();va();eV();hb=({command:t,escapedCommand:e,stdio:r,all:n,ipcOutput:i,options:{cwd:o},startTime:s})=>tV({command:t,escapedCommand:e,cwd:o,durationMs:FO(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:[]}),yl=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:s})=>Lf({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}),Lf=({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:A}=cSe(l,u),{originalMessage:E,shortMessage:C,message:k}=Q9({stdio:d,all:f,ipcOutput:p,originalError:t,signal:O,signalDescription:A,exitCode:w,escapedCommand:r,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,forceKillAfterDelay:g,killSignal:b,maxBuffer:S,timeout:h,cwd:_}),q=mZ(t,k,x);return Object.assign(q,aSe({error:q,command:e,escapedCommand:r,startTime:n,timedOut:i,isCanceled:o,isGracefullyCanceled:s,isMaxBuffer:a,isForcefullyTerminated:c,exitCode:w,signal:O,signalDescription:A,stdio:d,all:f,ipcOutput:p,cwd:_,originalMessage:E,shortMessage:C})),q},aSe=({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})=>tV({shortMessage:b,originalMessage:g,command:e,escapedCommand:r,cwd:h,durationMs:FO(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:[]}),tV=t=>Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0)),cSe=(t,e)=>{let r=t===null?void 0:t,n=e===null?void 0:e,i=n===void 0?void 0:j_(e);return{exitCode:r,signal:n,signalDescription:i}}});function lSe(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(rV(t*1e3)%1e3),nanoseconds:Math.trunc(rV(t*1e6)%1e3)}}function uSe(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 wR(t){switch(typeof t){case"number":{if(Number.isFinite(t))return lSe(t);break}case"bigint":return uSe(t)}throw new TypeError("Expected a finite number or bigint")}var rV,nV=y(()=>{rV=t=>Number.isFinite(t)?t:0});function xR(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+pSe);return(Math.round(f)/10**d).toFixed(d)},s=(u,d,f,p)=>{if(!((i.length===0||!e.colonNotation)&&dSe(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?" "+fSe(d,u):f;i.push(p)}},a=wR(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%mSe):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 dSe,fSe,pSe,mSe,iV=y(()=>{nV();dSe=t=>t===0||t===0n,fSe=(t,e)=>e===1||e===1n?t:`${t}s`,pSe=1e-7,mSe=24n*60n*60n*1000n});var oV,sV=y(()=>{al();oV=(t,e)=>{t.failed&&ki({type:"error",verboseMessage:t.shortMessage,verboseInfo:e,result:t})}});var aV,hSe,cV=y(()=>{iV();ts();al();sV();aV=(t,e)=>{ol(e)&&(oV(t,e),hSe(t,e))},hSe=(t,e)=>{let r=`(done in ${xR(t.durationMs)})`;ki({type:"duration",verboseMessage:r,verboseInfo:e,result:t})}});var _l,gb=y(()=>{cV();_l=(t,e,{reject:r})=>{if(aV(t,e),t.failed&&r)throw t;return t}});var dV,gSe,ySe,fV,pV,lV,_Se,$R,uV,Ea,mV,bSe,yb,hV,vSe,SSe,kR,gV,wSe,yV,_b,xSe,ER,$Se,kSe,_V,kn,bb,AR,bV,vV,os,_r=y(()=>{$a();co();tn();dV=(t,e)=>Ea(t)?"asyncGenerator":mV(t)?"generator":yb(t)?"fileUrl":vSe(t)?"filePath":xSe(t)?"webStream":Yn(t,{checkOpen:!1})?"native":Ft(t)?"uint8Array":$Se(t)?"asyncIterable":kSe(t)?"iterable":ER(t)?fV({transform:t},e):bSe(t)?gSe(t,e):"native",gSe=(t,e)=>yR(t.transform,{checkOpen:!1})?ySe(t,e):ER(t.transform)?fV(t,e):_Se(t,e),ySe=(t,e)=>(pV(t,e,"Duplex stream"),"duplex"),fV=(t,e)=>(pV(t,e,"web TransformStream"),"webTransform"),pV=({final:t,binary:e,objectMode:r},n,i)=>{lV(t,`${n}.final`,i),lV(e,`${n}.binary`,i),$R(r,`${n}.objectMode`)},lV=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${e}\` option can only be defined when using a generator, not a ${r}.`)},_Se=({transform:t,final:e,binary:r,objectMode:n},i)=>{if(t!==void 0&&!uV(t))throw new TypeError(`The \`${i}.transform\` option must be a generator, a Duplex stream or a web TransformStream.`);if(yR(e,{checkOpen:!1}))throw new TypeError(`The \`${i}.final\` option must not be a Duplex stream.`);if(ER(e))throw new TypeError(`The \`${i}.final\` option must not be a web TransformStream.`);if(e!==void 0&&!uV(e))throw new TypeError(`The \`${i}.final\` option must be a generator.`);return $R(r,`${i}.binary`),$R(n,`${i}.objectMode`),Ea(t)||Ea(e)?"asyncGenerator":"generator"},$R=(t,e)=>{if(t!==void 0&&typeof t!="boolean")throw new TypeError(`The \`${e}\` option must use a boolean.`)},uV=t=>Ea(t)||mV(t),Ea=t=>Object.prototype.toString.call(t)==="[object AsyncGeneratorFunction]",mV=t=>Object.prototype.toString.call(t)==="[object GeneratorFunction]",bSe=t=>At(t)&&(t.transform!==void 0||t.final!==void 0),yb=t=>Object.prototype.toString.call(t)==="[object URL]",hV=t=>yb(t)&&t.protocol!=="file:",vSe=t=>At(t)&&Object.keys(t).length>0&&Object.keys(t).every(e=>SSe.has(e))&&kR(t.file),SSe=new Set(["file","append"]),kR=t=>typeof t=="string",gV=(t,e)=>t==="native"&&typeof e=="string"&&!wSe.has(e),wSe=new Set(["ipc","ignore","inherit","overlapped","pipe"]),yV=t=>Object.prototype.toString.call(t)==="[object ReadableStream]",_b=t=>Object.prototype.toString.call(t)==="[object WritableStream]",xSe=t=>yV(t)||_b(t),ER=t=>yV(t?.readable)&&_b(t?.writable),$Se=t=>_V(t)&&typeof t[Symbol.asyncIterator]=="function",kSe=t=>_V(t)&&typeof t[Symbol.iterator]=="function",_V=t=>typeof t=="object"&&t!==null,kn=new Set(["generator","asyncGenerator","duplex","webTransform"]),bb=new Set(["fileUrl","filePath","fileNumber"]),AR=new Set(["fileUrl","filePath"]),bV=new Set([...AR,"webStream","nodeStream"]),vV=new Set(["webTransform","duplex"]),os={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 TR,ESe,ASe,SV,OR=y(()=>{_r();TR=(t,e,r,n)=>n==="output"?ESe(t,e,r):ASe(t,e,r),ESe=(t,e,r)=>{let n=e!==0&&r[e-1].value.readableObjectMode;return{writableObjectMode:n,readableObjectMode:t??n}},ASe=(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}},SV=(t,e)=>{let r=t.findLast(({type:n})=>kn.has(n));return r===void 0?!1:e==="input"?r.value.writableObjectMode:r.value.readableObjectMode}});var wV,TSe,OSe,RSe,ISe,PSe,CSe,xV=y(()=>{co();wa();_r();OR();wV=(t,e,r,n)=>[...t.filter(({type:i})=>!kn.has(i)),...TSe(t,e,r,n)],TSe=(t,e,r,{encoding:n})=>{let i=t.filter(({type:s})=>kn.has(s)),o=Array.from({length:i.length});for(let[s,a]of Object.entries(i))o[s]=OSe({stdioItem:a,index:Number(s),newTransforms:o,optionName:e,direction:r,encoding:n});return CSe(o,r)},OSe=({stdioItem:t,stdioItem:{type:e},index:r,newTransforms:n,optionName:i,direction:o,encoding:s})=>e==="duplex"?RSe({stdioItem:t,optionName:i}):e==="webTransform"?ISe({stdioItem:t,index:r,newTransforms:n,direction:o}):PSe({stdioItem:t,index:r,newTransforms:n,direction:o,encoding:s}),RSe=({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}}},ISe=({stdioItem:t,stdioItem:{value:e},index:r,newTransforms:n,direction:i})=>{let{transform:o,objectMode:s}=At(e)?e:{transform:e},{writableObjectMode:a,readableObjectMode:c}=TR(s,r,n,i);return{...t,value:{transform:o,writableObjectMode:a,readableObjectMode:c}}},PSe=({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}=At(e)?e:{transform:e},d=c||rn.has(o),{writableObjectMode:f,readableObjectMode:p}=TR(u,r,n,i);return{...t,value:{transform:s,final:a,binary:d,preserveNewlines:l,writableObjectMode:f,readableObjectMode:p}}},CSe=(t,e)=>e==="input"?t.reverse():t});import RR from"node:process";var $V,DSe,NSe,bl,IR,kV,jSe,MSe,EV=y(()=>{$a();_r();$V=(t,e,r)=>{let n=t.map(i=>DSe(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)??MSe},DSe=({type:t,value:e},r)=>NSe[r]??kV[t](e),NSe=["input","output","output"],bl=()=>{},IR=()=>"input",kV={generator:bl,asyncGenerator:bl,fileUrl:bl,filePath:bl,iterable:IR,asyncIterable:IR,uint8Array:IR,webStream:t=>_b(t)?"output":"input",nodeStream(t){return xa(t,{checkOpen:!1})?gR(t,{checkOpen:!1})?void 0:"input":"output"},webTransform:bl,duplex:bl,native(t){let e=jSe(t);if(e!==void 0)return e;if(Yn(t,{checkOpen:!1}))return kV.nodeStream(t)}},jSe=t=>{if([0,RR.stdin].includes(t))return"input";if([1,2,RR.stdout,RR.stderr].includes(t))return"output"},MSe="output"});var AV,TV=y(()=>{AV=(t,e)=>e&&!t.includes("ipc")?[...t,"ipc"]:t});var OV,FSe,LSe,RV,zSe,USe,IV=y(()=>{uo();TV();ts();OV=({stdio:t,ipc:e,buffer:r,...n},i,o)=>{let s=FSe(t,n).map((a,c)=>RV(a,c));return o?zSe(s,r,i):AV(s,e)},FSe=(t,e)=>{if(t===void 0)return $n.map(n=>e[n]);if(LSe(e))throw new Error(`It's not possible to provide \`stdio\` in combination with one of ${$n.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,$n.length);return Array.from({length:r},(n,i)=>t[i])},LSe=t=>$n.some(e=>t[e]!==void 0),RV=(t,e)=>Array.isArray(t)?t.map(r=>RV(r,e)):t??(e>=$n.length?"ignore":"pipe"),zSe=(t,e,r)=>t.map((n,i)=>!e[i]&&i!==0&&!sl(r,i)&&USe(n)?"ignore":n),USe=t=>t==="pipe"||Array.isArray(t)&&t.every(e=>e==="pipe")});import{readFileSync as qSe}from"node:fs";import BSe from"node:tty";var CV,HSe,GSe,ZSe,VSe,PV,DV=y(()=>{$a();uo();tn();ns();CV=({stdioItem:t,stdioItem:{type:e},isStdioArray:r,fdNumber:n,direction:i,isSync:o})=>!r||e!=="native"?t:o?HSe({stdioItem:t,fdNumber:n,direction:i}):VSe({stdioItem:t,fdNumber:n}),HSe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n,direction:i})=>{let o=GSe({value:e,optionName:r,fdNumber:n,direction:i});if(o!==void 0)return o;if(Yn(e,{checkOpen:!1}))throw new TypeError(`The \`${r}: Stream\` option cannot both be an array and include a stream with synchronous methods.`);return t},GSe=({value:t,optionName:e,fdNumber:r,direction:n})=>{let i=ZSe(t,r);if(i!==void 0){if(n==="output")return{type:"fileNumber",value:i,optionName:e};if(BSe.isatty(i))throw new TypeError(`The \`${e}: ${z_(t)}\` option is invalid: it cannot be a TTY with synchronous methods.`);return{type:"uint8Array",value:lo(qSe(i)),optionName:e}}},ZSe=(t,e)=>{if(t==="inherit")return e;if(typeof t=="number")return t;let r=b_.indexOf(t);if(r!==-1)return r},VSe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n})=>e==="inherit"?{type:"nodeStream",value:PV(n,e,r),optionName:r}:typeof e=="number"?{type:"nodeStream",value:PV(e,e,r),optionName:r}:Yn(e,{checkOpen:!1})?{type:"nodeStream",value:e,optionName:r}:t,PV=(t,e,r)=>{let n=b_[t];if(n===void 0)throw new TypeError(`The \`${r}: ${e}\` option is invalid: no such standard stream.`);return n}});var NV,WSe,KSe,JSe,YSe,jV=y(()=>{$a();tn();_r();NV=({input:t,inputFile:e},r)=>r===0?[...WSe(t),...JSe(e)]:[],WSe=t=>t===void 0?[]:[{type:KSe(t),value:t,optionName:"input"}],KSe=t=>{if(xa(t,{checkOpen:!1}))return"nodeStream";if(typeof t=="string")return"string";if(Ft(t))return"uint8Array";throw new Error("The `input` option must be a string, a Uint8Array or a Node.js Readable stream.")},JSe=t=>t===void 0?[]:[{...YSe(t),optionName:"inputFile"}],YSe=t=>{if(yb(t))return{type:"fileUrl",value:t};if(kR(t))return{type:"filePath",value:{file:t}};throw new Error("The `inputFile` option must be a file path string or a file URL.")}});var MV,FV,XSe,QSe,LV,ewe,twe,zV,UV=y(()=>{_r();MV=t=>t.filter((e,r)=>t.every((n,i)=>e.value!==n.value||r>=i||e.type==="generator"||e.type==="asyncGenerator")),FV=({stdioItem:{type:t,value:e,optionName:r},direction:n,fileDescriptors:i,isSync:o})=>{let s=XSe(i,t);if(s.length!==0){if(o){QSe({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});return}if(bV.has(t))return LV({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});vV.has(t)&&twe({otherStdioItems:s,type:t,value:e,optionName:r})}},XSe=(t,e)=>t.flatMap(({direction:r,stdioItems:n})=>n.filter(i=>i.type===e).map((i=>({...i,direction:r})))),QSe=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{AR.has(e)&&LV({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})},LV=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{let o=t.filter(a=>ewe(a,r));if(o.length===0)return;let s=o.find(a=>a.direction!==i);return zV(s,n,e),i==="output"?o[0].stream:void 0},ewe=({type:t,value:e},r)=>t==="filePath"?e.file===r.file:t==="fileUrl"?e.href===r.href:e===r,twe=({otherStdioItems:t,type:e,value:r,optionName:n})=>{let i=t.find(({value:{transform:o}})=>o===r.transform);zV(i,n,e)},zV=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${t.optionName}\` and \`${e}\` options must not target ${os[r]} that is the same.`)}});var vb,rwe,nwe,iwe,owe,swe,awe,cwe,lwe,uwe,dwe,fwe,PR,pwe,Sb=y(()=>{uo();xV();OR();_r();EV();IV();DV();jV();UV();vb=(t,e,r,n)=>{let o=OV(e,r,n).map((a,c)=>rwe({stdioOption:a,fdNumber:c,options:e,isSync:n})),s=uwe({initialFileDescriptors:o,addProperties:t,options:e,isSync:n});return e.stdio=s.map(({stdioItems:a})=>pwe(a)),s},rwe=({stdioOption:t,fdNumber:e,options:r,isSync:n})=>{let i=v_(e),{stdioItems:o,isStdioArray:s}=nwe({stdioOption:t,fdNumber:e,options:r,optionName:i}),a=$V(o,e,i),c=o.map(d=>CV({stdioItem:d,isStdioArray:s,fdNumber:e,direction:a,isSync:n})),l=wV(c,i,a,r),u=SV(l,a);return lwe(l,u),{direction:a,objectMode:u,stdioItems:l}},nwe=({stdioOption:t,fdNumber:e,options:r,optionName:n})=>{let o=[...(Array.isArray(t)?t:[t]).map(c=>iwe(c,n)),...NV(r,e)],s=MV(o),a=s.length>1;return owe(s,a,n),awe(s),{stdioItems:s,isStdioArray:a}},iwe=(t,e)=>({type:dV(t,e),value:t,optionName:e}),owe=(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(swe.has(n))throw new Error(`The \`${i}\` option must not include \`${n}\`.`)}},swe=new Set(["ignore","ipc"]),awe=t=>{for(let e of t)cwe(e)},cwe=({type:t,value:e,optionName:r})=>{if(hV(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(gV(t,e))throw new TypeError(`The \`${r}: { file: '...' }\` option must be used instead of \`${r}: '...'\`.`)},lwe=(t,e)=>{if(!e)return;let r=t.find(({type:n})=>bb.has(n));if(r!==void 0)throw new TypeError(`The \`${r.optionName}\` option cannot use both files and transforms in objectMode.`)},uwe=({initialFileDescriptors:t,addProperties:e,options:r,isSync:n})=>{let i=[];try{for(let o of t)i.push(dwe({fileDescriptor:o,fileDescriptors:i,addProperties:e,options:r,isSync:n}));return i}catch(o){throw PR(i),o}},dwe=({fileDescriptor:{direction:t,objectMode:e,stdioItems:r},fileDescriptors:n,addProperties:i,options:o,isSync:s})=>{let a=r.map(c=>fwe({stdioItem:c,addProperties:i,direction:t,options:o,fileDescriptors:n,isSync:s}));return{direction:t,objectMode:e,stdioItems:a}},fwe=({stdioItem:t,addProperties:e,direction:r,options:n,fileDescriptors:i,isSync:o})=>{let s=FV({stdioItem:t,direction:r,fileDescriptors:i,isSync:o});return s!==void 0?{...t,stream:s}:{...t,...e[r][t.type](t,n)}},PR=t=>{for(let{stdioItems:e}of t)for(let{stream:r}of e)r!==void 0&&!Wn(r)&&r.destroy()},pwe=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 qV}from"node:fs";var HV,Oi,mwe,GV,BV,hwe,ZV=y(()=>{tn();Sb();_r();HV=(t,e)=>vb(hwe,t,e,!0),Oi=({type:t,optionName:e})=>{GV(e,os[t])},mwe=({optionName:t,value:e})=>((e==="ipc"||e==="overlapped")&&GV(t,`"${e}"`),{}),GV=(t,e)=>{throw new TypeError(`The \`${t}\` option cannot be ${e} with synchronous methods.`)},BV={generator(){},asyncGenerator:Oi,webStream:Oi,nodeStream:Oi,webTransform:Oi,duplex:Oi,asyncIterable:Oi,native:mwe},hwe={input:{...BV,fileUrl:({value:t})=>({contents:[lo(qV(t))]}),filePath:({value:{file:t}})=>({contents:[lo(qV(t))]}),fileNumber:Oi,iterable:({value:t})=>({contents:[...t]}),string:({value:t})=>({contents:[t]}),uint8Array:({value:t})=>({contents:[t]})},output:{...BV,fileUrl:({value:t})=>({path:t}),filePath:({value:{file:t,append:e}})=>({path:t,append:e}),fileNumber:({value:t})=>({path:t}),iterable:Oi,string:Oi,uint8Array:Oi}}});var ho,CR,Uf=y(()=>{hR();ho=(t,{stripFinalNewline:e},r)=>CR(e,r)&&t!==void 0&&!Array.isArray(t)?hl(t):t,CR=(t,e)=>e==="all"?t[1]||t[2]:t[e]});var wb,NR,VV,WV,gwe,ywe,_we,KV,bwe,DR,vwe,Swe,wwe,xb=y(()=>{wb=(t,e,r,n)=>t||r?void 0:WV(e,n),NR=(t,e,r)=>r?t.flatMap(n=>VV(n,e)):VV(t,e),VV=(t,e)=>{let{transform:r,final:n}=WV(e,{});return[...r(t),...n()]},WV=(t,e)=>(e.previousChunks="",{transform:gwe.bind(void 0,e,t),final:_we.bind(void 0,e)}),gwe=function*(t,e,r){if(typeof r!="string"){yield r;return}let{previousChunks:n}=t,i=-1;for(let o=0;o0&&(a=DR(n,a),n=""),yield a,i=o}i!==r.length-1&&(n=DR(n,r.slice(i+1))),t.previousChunks=n},ywe=(t,e,r,n)=>r?0:(n.isWindowsNewline=e!==0&&t[e-1]==="\r",n.isWindowsNewline?2:1),_we=function*({previousChunks:t}){t.length>0&&(yield t)},KV=({binary:t,preserveNewlines:e,readableObjectMode:r,state:n})=>t||e||r?void 0:{transform:bwe.bind(void 0,n)},bwe=function*({isWindowsNewline:t=!1},e){let{unixNewline:r,windowsNewline:n,LF:i,concatBytes:o}=typeof e=="string"?vwe:wwe;if(e.at(-1)===i){yield e;return}yield o(e,t?n:r)},DR=(t,e)=>`${t}${e}`,vwe={windowsNewline:`\r +${t}`}});import kSe from"node:path";import gV from"node:process";var yV,Pb,ESe,ASe,VR=y(()=>{yV=St(YZ(),1);i9();fb();Wf();CR();UR();qR();BR();HR();Pa();ZR();bl();vo();Pb=(t,e,r)=>{r.cwd=pV(r.cwd);let[n,i,o]=cV(t,e,r),{command:s,args:a,options:c}=yV.default._parse(n,i,o),l=zG(c),u=ESe(l);return iV(u),fV(u),lV(u),$9(u),rV(u),u.shell=cR(u.shell),u.env=ASe(u),u.killSignal=b9(u.killSignal),u.forceKillAfterDelay=w9(u.forceKillAfterDelay),u.lines=u.lines.map((d,f)=>d&&!nn.has(u.encoding)&&u.buffer[f]),gV.platform==="win32"&&kSe.basename(s,".exe")==="cmd"&&a.unshift("/q"),{file:s,commandArguments:a,options:u}},ESe=({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}),ASe=({env:t,extendEnv:e,preferLocal:r,node:n,localDirectory:i,nodePath:o})=>{let s=e?{...gV.env,...t}:t;return r||n?n9({env:s,cwd:i,execPath:o,preferLocal:r,addExecPath:n}):s}});var Cb,WR=y(()=>{Cb=(t,e,r)=>r.shell&&e.length>0?[[t,...e].join(" "),[],r]:[t,e,r]});function Rl(t){if(typeof t=="string")return TSe(t);if(!(ArrayBuffer.isView(t)&&t.BYTES_PER_ELEMENT===1))throw new Error("Input must be a string or a Uint8Array");return OSe(t)}var TSe,OSe,_V,RSe,bV,ISe,KR=y(()=>{TSe=t=>t.at(-1)===_V?t.slice(0,t.at(-2)===bV?-2:-1):t,OSe=t=>t.at(-1)===RSe?t.subarray(0,t.at(-2)===ISe?-2:-1):t,_V=` +`,RSe=_V.codePointAt(0),bV="\r",ISe=bV.codePointAt(0)});function ti(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 JR(t,{checkOpen:e=!0}={}){return ti(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 ti(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 YR(t,e){return JR(t,e)&&Ca(t,e)}var Da=y(()=>{});function vV(){return this[QR].next()}function SV(t){return this[QR].return(t)}function eI({preventCancel:t=!1}={}){let e=this.getReader(),r=new XR(e,t),n=Object.create(CSe);return n[QR]=r,n}var PSe,XR,QR,CSe,wV=y(()=>{PSe=Object.getPrototypeOf(Object.getPrototypeOf(async function*(){}).prototype),XR=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}}},QR=Symbol();Object.defineProperty(vV,"name",{value:"next"});Object.defineProperty(SV,"name",{value:"return"});CSe=Object.create(PSe,{next:{enumerable:!0,configurable:!0,writable:!0,value:vV},return:{enumerable:!0,configurable:!0,writable:!0,value:SV}})});var xV=y(()=>{});var $V=y(()=>{wV();xV()});var kV,DSe,NSe,jSe,Qf,tI=y(()=>{Da();$V();kV=t=>{if(Ca(t,{checkOpen:!1})&&Qf.on!==void 0)return NSe(t);if(typeof t?.[Symbol.asyncIterator]=="function")return t;if(DSe.call(t)==="[object ReadableStream]")return eI.call(t);throw new TypeError("The first argument must be a Readable, a ReadableStream, or an async iterable.")},{toString:DSe}=Object.prototype,NSe=async function*(t){let e=new AbortController,r={};jSe(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()}},jSe=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 Il,MSe,TV,EV,FSe,AV,Ci,ep=y(()=>{tI();Il=async(t,{init:e,convertChunk:r,getSize:n,truncateChunk:i,addChunk:o,getFinalChunk:s,finalize:a},{maxBuffer:c=Number.POSITIVE_INFINITY}={})=>{let l=kV(t),u=e();u.length=0;try{for await(let d of l){let f=FSe(d),p=r[f](d,u);TV({convertedChunk:p,state:u,getSize:n,truncateChunk:i,addChunk:o,maxBuffer:c})}return MSe({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}},MSe=({state:t,getSize:e,truncateChunk:r,addChunk:n,getFinalChunk:i,maxBuffer:o})=>{let s=i(t);s!==void 0&&TV({convertedChunk:s,state:t,getSize:e,truncateChunk:r,addChunk:n,maxBuffer:o})},TV=({convertedChunk:t,state:e,getSize:r,truncateChunk:n,addChunk:i,maxBuffer:o})=>{let s=r(t),a=e.length+s;if(a<=o){EV(t,e,i,a);return}let c=n(t,o-e.length);throw c!==void 0&&EV(c,e,i,o),new Ci},EV=(t,e,r,n)=>{e.contents=r(t,e,n),e.length=n},FSe=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=AV.call(t);return r==="[object ArrayBuffer]"?"arrayBuffer":r==="[object DataView]"?"dataView":Number.isInteger(t.byteLength)&&Number.isInteger(t.byteOffset)&&AV.call(t.buffer)==="[object ArrayBuffer]"?"typedArray":"others"},{toString:AV}=Object.prototype,Ci=class extends Error{name="MaxBufferError";constructor(){super("maxBuffer exceeded")}}});var So,tp,Db,Nb,jb,Mb=y(()=>{So=t=>t,tp=()=>{},Db=({contents:t})=>t,Nb=t=>{throw new Error(`Streams in object mode are not supported: ${String(t)}`)},jb=t=>t.length});async function Fb(t,e){return Il(t,qSe,e)}var LSe,zSe,USe,qSe,OV=y(()=>{ep();Mb();LSe=()=>({contents:[]}),zSe=()=>1,USe=(t,{contents:e})=>(e.push(t),e),qSe={init:LSe,convertChunk:{string:So,buffer:So,arrayBuffer:So,dataView:So,typedArray:So,others:So},getSize:zSe,truncateChunk:tp,addChunk:USe,getFinalChunk:tp,finalize:Db}});async function Lb(t,e){return Il(t,YSe,e)}var BSe,HSe,GSe,RV,IV,ZSe,VSe,WSe,KSe,CV,PV,JSe,DV,YSe,NV=y(()=>{ep();Mb();BSe=()=>({contents:new ArrayBuffer(0)}),HSe=t=>GSe.encode(t),GSe=new TextEncoder,RV=t=>new Uint8Array(t),IV=t=>new Uint8Array(t.buffer,t.byteOffset,t.byteLength),ZSe=(t,e)=>t.slice(0,e),VSe=(t,{contents:e,length:r},n)=>{let i=DV()?KSe(e,n):WSe(e,n);return new Uint8Array(i).set(t,r),i},WSe=(t,e)=>{if(e<=t.byteLength)return t;let r=new ArrayBuffer(CV(e));return new Uint8Array(r).set(new Uint8Array(t),0),r},KSe=(t,e)=>{if(e<=t.maxByteLength)return t.resize(e),t;let r=new ArrayBuffer(e,{maxByteLength:CV(e)});return new Uint8Array(r).set(new Uint8Array(t),0),r},CV=t=>PV**Math.ceil(Math.log(t)/Math.log(PV)),PV=2,JSe=({contents:t,length:e})=>DV()?t:t.slice(0,e),DV=()=>"resize"in ArrayBuffer.prototype,YSe={init:BSe,convertChunk:{string:HSe,buffer:RV,arrayBuffer:RV,dataView:IV,typedArray:IV,others:Nb},getSize:jb,truncateChunk:ZSe,addChunk:VSe,getFinalChunk:tp,finalize:JSe}});async function Ub(t,e){return Il(t,rwe,e)}var XSe,zb,QSe,ewe,twe,rwe,jV=y(()=>{ep();Mb();XSe=()=>({contents:"",textDecoder:new TextDecoder}),zb=(t,{textDecoder:e})=>e.decode(t,{stream:!0}),QSe=(t,{contents:e})=>e+t,ewe=(t,e)=>t.slice(0,e),twe=({textDecoder:t})=>{let e=t.decode();return e===""?void 0:e},rwe={init:XSe,convertChunk:{string:So,buffer:zb,arrayBuffer:zb,dataView:zb,typedArray:zb,others:Nb},getSize:jb,truncateChunk:ewe,addChunk:QSe,getFinalChunk:twe,finalize:Db}});var MV=y(()=>{OV();NV();jV();ep()});import{on as nwe}from"node:events";import{finished as iwe}from"node:stream/promises";var qb=y(()=>{tI();MV();Object.assign(Qf,{on:nwe,finished:iwe})});var FV,owe,LV,zV,swe,UV,qV,Bb,Na=y(()=>{qb();_o();vo();FV=({error:t,stream:e,readableObjectMode:r,lines:n,encoding:i,fdNumber:o})=>{if(!(t instanceof Ci))throw t;if(o==="all")return t;let s=owe(r,n,i);throw t.maxBufferInfo={fdNumber:o,unit:s},e.destroy(),t},owe=(t,e,r)=>t?"objects":e?"lines":r==="buffer"?"bytes":"characters",LV=(t,e,r)=>{if(e.length!==r)return;let n=new Ci;throw n.maxBufferInfo={fdNumber:"ipc"},n},zV=(t,e)=>{let{streamName:r,threshold:n,unit:i}=swe(t,e);return`Command's ${r} was larger than ${n} ${i}`},swe=(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=bo(e,r);return r==="ipc"?{streamName:"IPC output",threshold:i,unit:"messages"}:{streamName:K_(r),threshold:i,unit:n}},UV=(t,e,r)=>t?.code==="ENOBUFS"&&e!==null&&e.some(n=>n!==null&&n.length>Bb(r)),qV=(t,e,r)=>{if(!e)return t;let n=Bb(r);return t.length>n?t.slice(0,n):t},Bb=([,t])=>t});import{inspect as awe}from"node:util";var HV,cwe,lwe,uwe,dwe,fwe,BV,GV=y(()=>{KR();rn();ZR();X_();Na();Wf();Ra();HV=({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=cwe({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=uwe(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=>dwe(D)).join(` +`)].map(D=>Hf(Rl(fwe(D)))).filter(Boolean).join(` + +`);return{originalMessage:x,shortMessage:O,message:A}},cwe=({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=lwe(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} (${db(p)})${m}`:s!==void 0?`Command was killed with ${s} (${a})`:c!==void 0?`Command failed with exit code ${c}`:"Command failed"},lwe=(t,e)=>t?` and was forcefully terminated after ${e} milliseconds`:"",uwe=(t,e)=>{if(t instanceof Qn)return;let r=a9(t)?t.originalMessage:String(t?.message??t),n=Hf(hV(r,e));return n===""?void 0:n},dwe=t=>typeof t=="string"?t:awe(t),fwe=t=>Array.isArray(t)?t.map(e=>Rl(BV(e))).filter(Boolean).join(` +`):BV(t),BV=t=>typeof t=="string"?t:Ut(t)?V_(t):""});var Hb,Pl,rp,pwe,ZV,mwe,np=y(()=>{Wf();ib();Ra();GV();Hb=({command:t,escapedCommand:e,stdio:r,all:n,ipcOutput:i,options:{cwd:o},startTime:s})=>ZV({command:t,escapedCommand:e,cwd:o,durationMs:_R(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:[]}),Pl=({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}=mwe(l,u),{originalMessage:A,shortMessage:D,message:$}=HV({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:_}),ie=o9(t,$,x);return Object.assign(ie,pwe({error:ie,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})),ie},pwe=({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})=>ZV({shortMessage:b,originalMessage:g,command:e,escapedCommand:r,cwd:h,durationMs:_R(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:[]}),ZV=t=>Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0)),mwe=(t,e)=>{let r=t===null?void 0:t,n=e===null?void 0:e,i=n===void 0?void 0:db(e);return{exitCode:r,signal:n,signalDescription:i}}});function hwe(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(VV(t*1e3)%1e3),nanoseconds:Math.trunc(VV(t*1e6)%1e3)}}function gwe(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 rI(t){switch(typeof t){case"number":{if(Number.isFinite(t))return hwe(t);break}case"bigint":return gwe(t)}throw new TypeError("Expected a finite number or bigint")}var VV,WV=y(()=>{VV=t=>Number.isFinite(t)?t:0});function nI(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+bwe);return(Math.round(f)/10**d).toFixed(d)},s=(u,d,f,p)=>{if(!((i.length===0||!e.colonNotation)&&ywe(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?" "+_we(d,u):f;i.push(p)}},a=rI(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%vwe):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 ywe,_we,bwe,vwe,KV=y(()=>{WV();ywe=t=>t===0||t===0n,_we=(t,e)=>e===1||e===1n?t:`${t}s`,bwe=1e-7,vwe=24n*60n*60n*1000n});var JV,YV=y(()=>{wl();JV=(t,e)=>{t.failed&&Ri({type:"error",verboseMessage:t.shortMessage,verboseInfo:e,result:t})}});var XV,Swe,QV=y(()=>{KV();ls();wl();YV();XV=(t,e)=>{vl(e)&&(JV(t,e),Swe(t,e))},Swe=(t,e)=>{let r=`(done in ${nI(t.durationMs)})`;Ri({type:"duration",verboseMessage:r,verboseInfo:e,result:t})}});var Cl,Gb=y(()=>{QV();Cl=(t,e,{reject:r})=>{if(XV(t,e),t.failed&&r)throw t;return t}});var rW,wwe,xwe,nW,iW,eW,$we,iI,tW,ja,oW,kwe,Zb,sW,Ewe,Awe,oI,aW,Twe,cW,Vb,Owe,sI,Rwe,Iwe,lW,Tn,Wb,aI,uW,dW,ps,vr=y(()=>{Da();go();rn();rW=(t,e)=>ja(t)?"asyncGenerator":oW(t)?"generator":Zb(t)?"fileUrl":Ewe(t)?"filePath":Owe(t)?"webStream":ti(t,{checkOpen:!1})?"native":Ut(t)?"uint8Array":Rwe(t)?"asyncIterable":Iwe(t)?"iterable":sI(t)?nW({transform:t},e):kwe(t)?wwe(t,e):"native",wwe=(t,e)=>YR(t.transform,{checkOpen:!1})?xwe(t,e):sI(t.transform)?nW(t,e):$we(t,e),xwe=(t,e)=>(iW(t,e,"Duplex stream"),"duplex"),nW=(t,e)=>(iW(t,e,"web TransformStream"),"webTransform"),iW=({final:t,binary:e,objectMode:r},n,i)=>{eW(t,`${n}.final`,i),eW(e,`${n}.binary`,i),iI(r,`${n}.objectMode`)},eW=(t,e,r)=>{if(t!==void 0)throw new TypeError(`The \`${e}\` option can only be defined when using a generator, not a ${r}.`)},$we=({transform:t,final:e,binary:r,objectMode:n},i)=>{if(t!==void 0&&!tW(t))throw new TypeError(`The \`${i}.transform\` option must be a generator, a Duplex stream or a web TransformStream.`);if(YR(e,{checkOpen:!1}))throw new TypeError(`The \`${i}.final\` option must not be a Duplex stream.`);if(sI(e))throw new TypeError(`The \`${i}.final\` option must not be a web TransformStream.`);if(e!==void 0&&!tW(e))throw new TypeError(`The \`${i}.final\` option must be a generator.`);return iI(r,`${i}.binary`),iI(n,`${i}.objectMode`),ja(t)||ja(e)?"asyncGenerator":"generator"},iI=(t,e)=>{if(t!==void 0&&typeof t!="boolean")throw new TypeError(`The \`${e}\` option must use a boolean.`)},tW=t=>ja(t)||oW(t),ja=t=>Object.prototype.toString.call(t)==="[object AsyncGeneratorFunction]",oW=t=>Object.prototype.toString.call(t)==="[object GeneratorFunction]",kwe=t=>Ot(t)&&(t.transform!==void 0||t.final!==void 0),Zb=t=>Object.prototype.toString.call(t)==="[object URL]",sW=t=>Zb(t)&&t.protocol!=="file:",Ewe=t=>Ot(t)&&Object.keys(t).length>0&&Object.keys(t).every(e=>Awe.has(e))&&oI(t.file),Awe=new Set(["file","append"]),oI=t=>typeof t=="string",aW=(t,e)=>t==="native"&&typeof e=="string"&&!Twe.has(e),Twe=new Set(["ipc","ignore","inherit","overlapped","pipe"]),cW=t=>Object.prototype.toString.call(t)==="[object ReadableStream]",Vb=t=>Object.prototype.toString.call(t)==="[object WritableStream]",Owe=t=>cW(t)||Vb(t),sI=t=>cW(t?.readable)&&Vb(t?.writable),Rwe=t=>lW(t)&&typeof t[Symbol.asyncIterator]=="function",Iwe=t=>lW(t)&&typeof t[Symbol.iterator]=="function",lW=t=>typeof t=="object"&&t!==null,Tn=new Set(["generator","asyncGenerator","duplex","webTransform"]),Wb=new Set(["fileUrl","filePath","fileNumber"]),aI=new Set(["fileUrl","filePath"]),uW=new Set([...aI,"webStream","nodeStream"]),dW=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 cI,Pwe,Cwe,fW,lI=y(()=>{vr();cI=(t,e,r,n)=>n==="output"?Pwe(t,e,r):Cwe(t,e,r),Pwe=(t,e,r)=>{let n=e!==0&&r[e-1].value.readableObjectMode;return{writableObjectMode:n,readableObjectMode:t??n}},Cwe=(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}},fW=(t,e)=>{let r=t.findLast(({type:n})=>Tn.has(n));return r===void 0?!1:e==="input"?r.value.writableObjectMode:r.value.readableObjectMode}});var pW,Dwe,Nwe,jwe,Mwe,Fwe,Lwe,mW=y(()=>{go();Pa();vr();lI();pW=(t,e,r,n)=>[...t.filter(({type:i})=>!Tn.has(i)),...Dwe(t,e,r,n)],Dwe=(t,e,r,{encoding:n})=>{let i=t.filter(({type:s})=>Tn.has(s)),o=Array.from({length:i.length});for(let[s,a]of Object.entries(i))o[s]=Nwe({stdioItem:a,index:Number(s),newTransforms:o,optionName:e,direction:r,encoding:n});return Lwe(o,r)},Nwe=({stdioItem:t,stdioItem:{type:e},index:r,newTransforms:n,optionName:i,direction:o,encoding:s})=>e==="duplex"?jwe({stdioItem:t,optionName:i}):e==="webTransform"?Mwe({stdioItem:t,index:r,newTransforms:n,direction:o}):Fwe({stdioItem:t,index:r,newTransforms:n,direction:o,encoding:s}),jwe=({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}}},Mwe=({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}=cI(s,r,n,i);return{...t,value:{transform:o,writableObjectMode:a,readableObjectMode:c}}},Fwe=({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||nn.has(o),{writableObjectMode:f,readableObjectMode:p}=cI(u,r,n,i);return{...t,value:{transform:s,final:a,binary:d,preserveNewlines:l,writableObjectMode:f,readableObjectMode:p}}},Lwe=(t,e)=>e==="input"?t.reverse():t});import uI from"node:process";var hW,zwe,Uwe,Dl,dI,gW,qwe,Bwe,yW=y(()=>{Da();vr();hW=(t,e,r)=>{let n=t.map(i=>zwe(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)??Bwe},zwe=({type:t,value:e},r)=>Uwe[r]??gW[t](e),Uwe=["input","output","output"],Dl=()=>{},dI=()=>"input",gW={generator:Dl,asyncGenerator:Dl,fileUrl:Dl,filePath:Dl,iterable:dI,asyncIterable:dI,uint8Array:dI,webStream:t=>Vb(t)?"output":"input",nodeStream(t){return Ca(t,{checkOpen:!1})?JR(t,{checkOpen:!1})?void 0:"input":"output"},webTransform:Dl,duplex:Dl,native(t){let e=qwe(t);if(e!==void 0)return e;if(ti(t,{checkOpen:!1}))return gW.nodeStream(t)}},qwe=t=>{if([0,uI.stdin].includes(t))return"input";if([1,2,uI.stdout,uI.stderr].includes(t))return"output"},Bwe="output"});var _W,bW=y(()=>{_W=(t,e)=>e&&!t.includes("ipc")?[...t,"ipc"]:t});var vW,Hwe,Gwe,SW,Zwe,Vwe,wW=y(()=>{_o();bW();ls();vW=({stdio:t,ipc:e,buffer:r,...n},i,o)=>{let s=Hwe(t,n).map((a,c)=>SW(a,c));return o?Zwe(s,r,i):_W(s,e)},Hwe=(t,e)=>{if(t===void 0)return An.map(n=>e[n]);if(Gwe(e))throw new Error(`It's not possible to provide \`stdio\` in combination with one of ${An.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,An.length);return Array.from({length:r},(n,i)=>t[i])},Gwe=t=>An.some(e=>t[e]!==void 0),SW=(t,e)=>Array.isArray(t)?t.map(r=>SW(r,e)):t??(e>=An.length?"ignore":"pipe"),Zwe=(t,e,r)=>t.map((n,i)=>!e[i]&&i!==0&&!Sl(r,i)&&Vwe(n)?"ignore":n),Vwe=t=>t==="pipe"||Array.isArray(t)&&t.every(e=>e==="pipe")});import{readFileSync as Wwe}from"node:fs";import Kwe from"node:tty";var $W,Jwe,Ywe,Xwe,Qwe,xW,kW=y(()=>{Da();_o();rn();ds();$W=({stdioItem:t,stdioItem:{type:e},isStdioArray:r,fdNumber:n,direction:i,isSync:o})=>!r||e!=="native"?t:o?Jwe({stdioItem:t,fdNumber:n,direction:i}):Qwe({stdioItem:t,fdNumber:n}),Jwe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n,direction:i})=>{let o=Ywe({value:e,optionName:r,fdNumber:n,direction:i});if(o!==void 0)return o;if(ti(e,{checkOpen:!1}))throw new TypeError(`The \`${r}: Stream\` option cannot both be an array and include a stream with synchronous methods.`);return t},Ywe=({value:t,optionName:e,fdNumber:r,direction:n})=>{let i=Xwe(t,r);if(i!==void 0){if(n==="output")return{type:"fileNumber",value:i,optionName:e};if(Kwe.isatty(i))throw new TypeError(`The \`${e}: ${hb(t)}\` option is invalid: it cannot be a TTY with synchronous methods.`);return{type:"uint8Array",value:yo(Wwe(i)),optionName:e}}},Xwe=(t,e)=>{if(t==="inherit")return e;if(typeof t=="number")return t;let r=W_.indexOf(t);if(r!==-1)return r},Qwe=({stdioItem:t,stdioItem:{value:e,optionName:r},fdNumber:n})=>e==="inherit"?{type:"nodeStream",value:xW(n,e,r),optionName:r}:typeof e=="number"?{type:"nodeStream",value:xW(e,e,r),optionName:r}:ti(e,{checkOpen:!1})?{type:"nodeStream",value:e,optionName:r}:t,xW=(t,e,r)=>{let n=W_[t];if(n===void 0)throw new TypeError(`The \`${r}: ${e}\` option is invalid: no such standard stream.`);return n}});var EW,exe,txe,rxe,nxe,AW=y(()=>{Da();rn();vr();EW=({input:t,inputFile:e},r)=>r===0?[...exe(t),...rxe(e)]:[],exe=t=>t===void 0?[]:[{type:txe(t),value:t,optionName:"input"}],txe=t=>{if(Ca(t,{checkOpen:!1}))return"nodeStream";if(typeof t=="string")return"string";if(Ut(t))return"uint8Array";throw new Error("The `input` option must be a string, a Uint8Array or a Node.js Readable stream.")},rxe=t=>t===void 0?[]:[{...nxe(t),optionName:"inputFile"}],nxe=t=>{if(Zb(t))return{type:"fileUrl",value:t};if(oI(t))return{type:"filePath",value:{file:t}};throw new Error("The `inputFile` option must be a file path string or a file URL.")}});var TW,OW,ixe,oxe,RW,sxe,axe,IW,PW=y(()=>{vr();TW=t=>t.filter((e,r)=>t.every((n,i)=>e.value!==n.value||r>=i||e.type==="generator"||e.type==="asyncGenerator")),OW=({stdioItem:{type:t,value:e,optionName:r},direction:n,fileDescriptors:i,isSync:o})=>{let s=ixe(i,t);if(s.length!==0){if(o){oxe({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});return}if(uW.has(t))return RW({otherStdioItems:s,type:t,value:e,optionName:r,direction:n});dW.has(t)&&axe({otherStdioItems:s,type:t,value:e,optionName:r})}},ixe=(t,e)=>t.flatMap(({direction:r,stdioItems:n})=>n.filter(i=>i.type===e).map((i=>({...i,direction:r})))),oxe=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{aI.has(e)&&RW({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})},RW=({otherStdioItems:t,type:e,value:r,optionName:n,direction:i})=>{let o=t.filter(a=>sxe(a,r));if(o.length===0)return;let s=o.find(a=>a.direction!==i);return IW(s,n,e),i==="output"?o[0].stream:void 0},sxe=({type:t,value:e},r)=>t==="filePath"?e.file===r.file:t==="fileUrl"?e.href===r.href:e===r,axe=({otherStdioItems:t,type:e,value:r,optionName:n})=>{let i=t.find(({value:{transform:o}})=>o===r.transform);IW(i,n,e)},IW=(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 Kb,cxe,lxe,uxe,dxe,fxe,pxe,mxe,hxe,gxe,yxe,_xe,fI,bxe,Jb=y(()=>{_o();mW();lI();vr();yW();wW();kW();AW();PW();Kb=(t,e,r,n)=>{let o=vW(e,r,n).map((a,c)=>cxe({stdioOption:a,fdNumber:c,options:e,isSync:n})),s=gxe({initialFileDescriptors:o,addProperties:t,options:e,isSync:n});return e.stdio=s.map(({stdioItems:a})=>bxe(a)),s},cxe=({stdioOption:t,fdNumber:e,options:r,isSync:n})=>{let i=K_(e),{stdioItems:o,isStdioArray:s}=lxe({stdioOption:t,fdNumber:e,options:r,optionName:i}),a=hW(o,e,i),c=o.map(d=>$W({stdioItem:d,isStdioArray:s,fdNumber:e,direction:a,isSync:n})),l=pW(c,i,a,r),u=fW(l,a);return hxe(l,u),{direction:a,objectMode:u,stdioItems:l}},lxe=({stdioOption:t,fdNumber:e,options:r,optionName:n})=>{let o=[...(Array.isArray(t)?t:[t]).map(c=>uxe(c,n)),...EW(r,e)],s=TW(o),a=s.length>1;return dxe(s,a,n),pxe(s),{stdioItems:s,isStdioArray:a}},uxe=(t,e)=>({type:rW(t,e),value:t,optionName:e}),dxe=(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(fxe.has(n))throw new Error(`The \`${i}\` option must not include \`${n}\`.`)}},fxe=new Set(["ignore","ipc"]),pxe=t=>{for(let e of t)mxe(e)},mxe=({type:t,value:e,optionName:r})=>{if(sW(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(aW(t,e))throw new TypeError(`The \`${r}: { file: '...' }\` option must be used instead of \`${r}: '...'\`.`)},hxe=(t,e)=>{if(!e)return;let r=t.find(({type:n})=>Wb.has(n));if(r!==void 0)throw new TypeError(`The \`${r.optionName}\` option cannot use both files and transforms in objectMode.`)},gxe=({initialFileDescriptors:t,addProperties:e,options:r,isSync:n})=>{let i=[];try{for(let o of t)i.push(yxe({fileDescriptor:o,fileDescriptors:i,addProperties:e,options:r,isSync:n}));return i}catch(o){throw fI(i),o}},yxe=({fileDescriptor:{direction:t,objectMode:e,stdioItems:r},fileDescriptors:n,addProperties:i,options:o,isSync:s})=>{let a=r.map(c=>_xe({stdioItem:c,addProperties:i,direction:t,options:o,fileDescriptors:n,isSync:s}));return{direction:t,objectMode:e,stdioItems:a}},_xe=({stdioItem:t,addProperties:e,direction:r,options:n,fileDescriptors:i,isSync:o})=>{let s=OW({stdioItem:t,direction:r,fileDescriptors:i,isSync:o});return s!==void 0?{...t,stream:s}:{...t,...e[r][t.type](t,n)}},fI=t=>{for(let{stdioItems:e}of t)for(let{stream:r}of e)r!==void 0&&!Xn(r)&&r.destroy()},bxe=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 CW}from"node:fs";var NW,Di,vxe,jW,DW,Sxe,MW=y(()=>{rn();Jb();vr();NW=(t,e)=>Kb(Sxe,t,e,!0),Di=({type:t,optionName:e})=>{jW(e,ps[t])},vxe=({optionName:t,value:e})=>((e==="ipc"||e==="overlapped")&&jW(t,`"${e}"`),{}),jW=(t,e)=>{throw new TypeError(`The \`${t}\` option cannot be ${e} with synchronous methods.`)},DW={generator(){},asyncGenerator:Di,webStream:Di,nodeStream:Di,webTransform:Di,duplex:Di,asyncIterable:Di,native:vxe},Sxe={input:{...DW,fileUrl:({value:t})=>({contents:[yo(CW(t))]}),filePath:({value:{file:t}})=>({contents:[yo(CW(t))]}),fileNumber:Di,iterable:({value:t})=>({contents:[...t]}),string:({value:t})=>({contents:[t]}),uint8Array:({value:t})=>({contents:[t]})},output:{...DW,fileUrl:({value:t})=>({path:t}),filePath:({value:{file:t,append:e}})=>({path:t,append:e}),fileNumber:({value:t})=>({path:t}),iterable:Di,string:Di,uint8Array:Di}}});var wo,pI,ip=y(()=>{KR();wo=(t,{stripFinalNewline:e},r)=>pI(e,r)&&t!==void 0&&!Array.isArray(t)?Rl(t):t,pI=(t,e)=>e==="all"?t[1]||t[2]:t[e]});var Yb,hI,FW,LW,wxe,xxe,$xe,zW,kxe,mI,Exe,Axe,Txe,Xb=y(()=>{Yb=(t,e,r,n)=>t||r?void 0:LW(e,n),hI=(t,e,r)=>r?t.flatMap(n=>FW(n,e)):FW(t,e),FW=(t,e)=>{let{transform:r,final:n}=LW(e,{});return[...r(t),...n()]},LW=(t,e)=>(e.previousChunks="",{transform:wxe.bind(void 0,e,t),final:$xe.bind(void 0,e)}),wxe=function*(t,e,r){if(typeof r!="string"){yield r;return}let{previousChunks:n}=t,i=-1;for(let o=0;o0&&(a=mI(n,a),n=""),yield a,i=o}i!==r.length-1&&(n=mI(n,r.slice(i+1))),t.previousChunks=n},xxe=(t,e,r,n)=>r?0:(n.isWindowsNewline=e!==0&&t[e-1]==="\r",n.isWindowsNewline?2:1),$xe=function*({previousChunks:t}){t.length>0&&(yield t)},zW=({binary:t,preserveNewlines:e,readableObjectMode:r,state:n})=>t||e||r?void 0:{transform:kxe.bind(void 0,n)},kxe=function*({isWindowsNewline:t=!1},e){let{unixNewline:r,windowsNewline:n,LF:i,concatBytes:o}=typeof e=="string"?Exe:Txe;if(e.at(-1)===i){yield e;return}yield o(e,t?n:r)},mI=(t,e)=>`${t}${e}`,Exe={windowsNewline:`\r `,unixNewline:` `,LF:` -`,concatBytes:DR},Swe=(t,e)=>{let r=new Uint8Array(t.length+e.length);return r.set(t,0),r.set(e,t.length),r},wwe={windowsNewline:new Uint8Array([13,10]),unixNewline:new Uint8Array([10]),LF:10,concatBytes:Swe}});import{Buffer as xwe}from"node:buffer";var JV,$we,YV,kwe,Ewe,XV,QV=y(()=>{tn();JV=(t,e)=>t?void 0:$we.bind(void 0,e),$we=function*(t,e){if(typeof e!="string"&&!Ft(e)&&!xwe.isBuffer(e))throw new TypeError(`The \`${t}\` option's transform must use "objectMode: true" to receive as input: ${typeof e}.`);yield e},YV=(t,e)=>t?kwe.bind(void 0,e):Ewe.bind(void 0,e),kwe=function*(t,e){XV(t,e),yield e},Ewe=function*(t,e){if(XV(t,e),typeof e!="string"&&!Ft(e))throw new TypeError(`The \`${t}\` option's function must yield a string or an Uint8Array, not ${typeof e}.`);yield e},XV=(t,e)=>{if(e==null)throw new TypeError(`The \`${t}\` option's function must not call \`yield ${e}\`. +`,concatBytes:mI},Axe=(t,e)=>{let r=new Uint8Array(t.length+e.length);return r.set(t,0),r.set(e,t.length),r},Txe={windowsNewline:new Uint8Array([13,10]),unixNewline:new Uint8Array([10]),LF:10,concatBytes:Axe}});import{Buffer as Oxe}from"node:buffer";var UW,Rxe,qW,Ixe,Pxe,BW,HW=y(()=>{rn();UW=(t,e)=>t?void 0:Rxe.bind(void 0,e),Rxe=function*(t,e){if(typeof e!="string"&&!Ut(e)&&!Oxe.isBuffer(e))throw new TypeError(`The \`${t}\` option's transform must use "objectMode: true" to receive as input: ${typeof e}.`);yield e},qW=(t,e)=>t?Ixe.bind(void 0,e):Pxe.bind(void 0,e),Ixe=function*(t,e){BW(t,e),yield e},Pxe=function*(t,e){if(BW(t,e),typeof e!="string"&&!Ut(e))throw new TypeError(`The \`${t}\` option's function must yield a string or an Uint8Array, not ${typeof e}.`);yield e},BW=(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 Awe}from"node:buffer";import{StringDecoder as Twe}from"node:string_decoder";var $b,Owe,Rwe,Iwe,jR=y(()=>{tn();$b=(t,e,r)=>{if(r)return;if(t)return{transform:Owe.bind(void 0,new TextEncoder)};let n=new Twe(e);return{transform:Rwe.bind(void 0,n),final:Iwe.bind(void 0,n)}},Owe=function*(t,e){Awe.isBuffer(e)?yield lo(e):typeof e=="string"?yield t.encode(e):yield e},Rwe=function*(t,e){yield Ft(e)?t.write(e):e},Iwe=function*(t){let e=t.end();e!==""&&(yield e)}});import{callbackify as eW}from"node:util";var MR,kb,tW,Pwe,rW,Cwe,nW=y(()=>{MR=eW(async(t,e,r,n)=>{e.currentIterable=t(...r);try{for await(let i of e.currentIterable)n.push(i)}finally{delete e.currentIterable}}),kb=async function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Cwe}=e[r];for await(let i of n(t))yield*kb(i,e,r+1)},tW=async function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Pwe(r,Number(e),t)},Pwe=async function*(t,e,r){if(t!==void 0)for await(let n of t())yield*kb(n,r,e+1)},rW=eW(async({currentIterable:t},e)=>{if(t!==void 0){await(e?t.throw(e):t.return());return}if(e)throw e}),Cwe=function*(t){yield t}});var FR,iW,Aa,qf,Dwe,Nwe,LR=y(()=>{FR=(t,e,r,n)=>{try{for(let i of t(...e))r.push(i);n()}catch(i){n(i)}},iW=(t,e)=>[...e.flatMap(r=>[...Aa(r,t,0)]),...qf(t)],Aa=function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Nwe}=e[r];for(let i of n(t))yield*Aa(i,e,r+1)},qf=function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Dwe(r,Number(e),t)},Dwe=function*(t,e,r){if(t!==void 0)for(let n of t())yield*Aa(n,r,e+1)},Nwe=function*(t){yield t}});import{Transform as jwe,getDefaultHighWaterMark as oW}from"node:stream";var zR,Eb,sW,Ab=y(()=>{_r();xb();QV();jR();nW();LR();zR=({value:t,value:{transform:e,final:r,writableObjectMode:n,readableObjectMode:i},optionName:o},{encoding:s})=>{let a={},c=sW(t,s,o),l=Ea(e),u=Ea(r),d=l?MR.bind(void 0,kb,a):FR.bind(void 0,Aa),f=l||u?MR.bind(void 0,tW,a):FR.bind(void 0,qf),p=l||u?rW.bind(void 0,a):void 0;return{stream:new jwe({writableObjectMode:n,writableHighWaterMark:oW(n),readableObjectMode:i,readableHighWaterMark:oW(i),transform(h,g,b){d([h,c,0],this,b)},flush(h){f([c],this,h)},destroy:p})}},Eb=(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=sW(s,r,a);t=iW(c,t)}return t},sW=({transform:t,final:e,binary:r,writableObjectMode:n,readableObjectMode:i,preserveNewlines:o},s,a)=>{let c={};return[{transform:JV(n,a)},$b(r,s,n),wb(r,o,n,c),{transform:t,final:e},{transform:YV(i,a)},KV({binary:r,preserveNewlines:o,readableObjectMode:i,state:c})].filter(Boolean)}});var aW,Mwe,Fwe,Lwe,zwe,cW=y(()=>{Ab();tn();_r();aW=(t,e)=>{for(let r of Mwe(t))Fwe(t,r,e)},Mwe=t=>new Set(Object.entries(t).filter(([,{direction:e}])=>e==="input").map(([e])=>Number(e))),Fwe=(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 ${os[a]} with synchronous methods.`)}let s=i.map(({contents:a})=>a).map(a=>Lwe(a,n));r.input=Ef(s)},Lwe=(t,e)=>{let r=Eb(t,e,"utf8",!0);return zwe(r),Ef(r)},zwe=t=>{let e=t.find(r=>typeof r!="string"&&!Ft(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 Tb,Uwe,qwe,lW,uW,Bwe,dW,UR=y(()=>{wa();_r();al();ts();Tb=({stdioItems:t,encoding:e,verboseInfo:r,fdNumber:n})=>n!=="all"&&sl(r,n)&&!rn.has(e)&&Uwe(n)&&(t.some(({type:i,value:o})=>i==="native"&&qwe.has(o))||t.every(({type:i})=>kn.has(i))),Uwe=t=>t===1||t===2,qwe=new Set(["pipe","overlapped"]),lW=async(t,e,r,n)=>{for await(let i of t)Bwe(e)||dW(i,r,n)},uW=(t,e,r)=>{for(let n of t)dW(n,e,r)},Bwe=t=>t._readableState.pipes.length>0,dW=(t,e,r)=>{let n=A_(t);ki({type:"output",verboseMessage:n,fdNumber:e,verboseInfo:r})}});import{writeFileSync as Hwe,appendFileSync as Gwe}from"node:fs";var fW,Zwe,Vwe,Wwe,Kwe,Jwe,pW=y(()=>{UR();Ab();xb();tn();_r();ka();fW=({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)=>Zwe({result:c,fileDescriptors:t,fdNumber:l,state:o,outputFiles:s,isMaxBuffer:n,verboseInfo:i},r)),...o}},Zwe=({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=Y9(t,o,d),p=lo(f),{stdioItems:m,objectMode:h}=e[r],g=Vwe([p],m,c,n),{serializedResult:b,finalResult:_=b}=Wwe({chunks:g,objectMode:h,encoding:c,lines:l,stripFinalNewline:u,fdNumber:r});Kwe({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&&Jwe(b,m,i),S}catch(x){return n.error=x,S}},Vwe=(t,e,r,n)=>{try{return Eb(t,e,r,!1)}catch(i){return n.error=i,t}},Wwe=({chunks:t,objectMode:e,encoding:r,lines:n,stripFinalNewline:i,fdNumber:o})=>{if(e)return{serializedResult:t};if(r==="buffer")return{serializedResult:Ef(t)};let s=UH(t,r);return n[o]?{serializedResult:s,finalResult:NR(s,!i[o],e)}:{serializedResult:s}},Kwe=({serializedResult:t,fdNumber:e,state:r,verboseInfo:n,encoding:i,stdioItems:o,objectMode:s})=>{if(!Tb({stdioItems:o,encoding:i,verboseInfo:n,fdNumber:e}))return;let a=NR(t,!1,s);try{uW(a,e,n)}catch(c){r.error??=c}},Jwe=(t,e,r)=>{for(let{path:n,append:i}of e.filter(({type:o})=>bb.has(o))){let o=typeof n=="string"?n:n.toString();i||r.has(o)?Gwe(n,t):(r.add(o),Hwe(n,t))}}});var mW,hW=y(()=>{tn();Uf();mW=([,t,e],r)=>{if(r.all)return t===void 0?e:e===void 0?t:Array.isArray(t)?Array.isArray(e)?[...t,...e]:[...t,ho(e,r,"all")]:Array.isArray(e)?[ho(t,r,"all"),...e]:Ft(t)&&Ft(e)?RO([t,e]):`${t}${e}`}});import{once as qR}from"node:events";var gW,Ywe,yW,_W,Xwe,BR,HR=y(()=>{va();gW=async(t,e)=>{let[r,n]=await Ywe(t);return e.isForcefullyTerminated??=!1,[r,n]},Ywe=async t=>{let[e,r]=await Promise.allSettled([qR(t,"spawn"),qR(t,"exit")]);return e.status==="rejected"?[]:r.status==="rejected"?yW(t):r.value},yW=async t=>{try{return await qR(t,"exit")}catch{return yW(t)}},_W=async t=>{let[e,r]=await t;if(!Xwe(e,r)&&BR(e,r))throw new Kn;return[e,r]},Xwe=(t,e)=>t===void 0&&e===void 0,BR=(t,e)=>t!==0||e!==null});var bW,Qwe,vW=y(()=>{va();ka();HR();bW=({error:t,status:e,signal:r,output:n},{maxBuffer:i})=>{let o=Qwe(t,e,r),s=o?.code==="ETIMEDOUT",a=J9(o,n,i);return{resultError:o,exitCode:e,signal:r,timedOut:s,isMaxBuffer:a}},Qwe=(t,e,r)=>t!==void 0?t:BR(e,r)?new Kn:void 0});import{spawnSync as exe}from"node:child_process";var SW,txe,rxe,nxe,Ob,ixe,oxe,sxe,axe,wW=y(()=>{LO();pR();mR();zf();gb();ZV();Uf();cW();pW();ka();hW();vW();SW=(t,e,r)=>{let{file:n,commandArguments:i,command:o,escapedCommand:s,startTime:a,verboseInfo:c,options:l,fileDescriptors:u}=txe(t,e,r),d=ixe({file:n,commandArguments:i,options:l,command:o,escapedCommand:s,verboseInfo:c,fileDescriptors:u,startTime:a});return _l(d,c,l)},txe=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=R_(t,e,r),a=rxe(r),{file:c,commandArguments:l,options:u}=nb(t,e,a);nxe(u);let d=HV(u,s);return{file:c,commandArguments:l,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},rxe=t=>t.node&&!t.ipc?{...t,ipc:!1}:t,nxe=({ipc:t,ipcInput:e,detached:r,cancelSignal:n})=>{e&&Ob("ipcInput"),t&&Ob("ipc: true"),r&&Ob("detached: true"),n&&Ob("cancelSignal")},Ob=t=>{throw new TypeError(`The "${t}" option cannot be used with synchronous methods.`)},ixe=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,verboseInfo:o,fileDescriptors:s,startTime:a})=>{let c=oxe({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}=bW(c,r),{output:m,error:h=l}=fW({fileDescriptors:s,syncResult:c,options:r,isMaxBuffer:p,verboseInfo:o}),g=m.map((_,S)=>ho(_,r,S)),b=ho(mW(m,r),r,"all");return axe({error:h,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p,stdio:g,all:b,options:r,command:n,escapedCommand:i,startTime:a})},oxe=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:o,startTime:s})=>{try{aW(o,r);let a=sxe(r);return exe(...ib(t,e,a))}catch(a){return yl({error:a,command:n,escapedCommand:i,fileDescriptors:o,options:r,startTime:s,isSync:!0})}},sxe=({encoding:t,maxBuffer:e,...r})=>({...r,encoding:"buffer",maxBuffer:mb(e)}),axe=({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?hb({command:c,escapedCommand:l,stdio:o,all:s,ipcOutput:[],options:a,startTime:u}):Lf({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 GR,on as cxe}from"node:events";var xW,lxe,uxe,dxe,fxe,$W=y(()=>{fl();Df();Cf();xW=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0,filter:o}={})=>(ul({methodName:"getOneMessage",isSubprocess:r,ipc:n,isConnected:J_(t)}),lxe({anyProcess:t,channel:e,isSubprocess:r,filter:o,reference:i})),lxe=async({anyProcess:t,channel:e,isSubprocess:r,filter:n,reference:i})=>{B_(e,i);let o=is(t,e,r),s=new AbortController;try{return await Promise.race([uxe(o,n,s),dxe(o,r,s),fxe(o,r,s)])}catch(a){throw dl(t),a}finally{s.abort(),H_(e,i)}},uxe=async(t,e,{signal:r})=>{if(e===void 0){let[n]=await GR(t,"message",{signal:r});return n}for await(let[n]of cxe(t,"message",{signal:r}))if(e(n))return n},dxe=async(t,e,{signal:r})=>{await GR(t,"disconnect",{signal:r}),NZ(e)},fxe=async(t,e,{signal:r})=>{let[n]=await GR(t,"strict:error",{signal:r});throw L_(n,e)}});import{once as EW,on as pxe}from"node:events";var AW,ZR,mxe,hxe,gxe,kW,VR=y(()=>{fl();Df();Cf();AW=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0}={})=>ZR({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:!r,reference:i}),ZR=({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:i,reference:o})=>{ul({methodName:"getEachMessage",isSubprocess:r,ipc:n,isConnected:J_(t)}),B_(e,o);let s=is(t,e,r),a=new AbortController,c={};return mxe(t,s,a),hxe({ipcEmitter:s,isSubprocess:r,controller:a,state:c}),gxe({anyProcess:t,channel:e,ipcEmitter:s,isSubprocess:r,shouldAwait:i,controller:a,state:c,reference:o})},mxe=async(t,e,r)=>{try{await EW(e,"disconnect",{signal:r.signal}),r.abort()}catch{}},hxe=async({ipcEmitter:t,isSubprocess:e,controller:r,state:n})=>{try{let[i]=await EW(t,"strict:error",{signal:r.signal});n.error=L_(i,e),r.abort()}catch{}},gxe=async function*({anyProcess:t,channel:e,ipcEmitter:r,isSubprocess:n,shouldAwait:i,controller:o,state:s,reference:a}){try{for await(let[c]of pxe(r,"message",{signal:o.signal}))kW(s),yield c}catch{kW(s)}finally{o.abort(),H_(e,a),n||dl(t),i&&await t}},kW=({error:t})=>{if(t)throw t}});import TW from"node:process";var OW,RW,IW,WR=y(()=>{tb();$W();VR();W_();OW=(t,{ipc:e})=>{Object.assign(t,IW(t,!1,e))},RW=()=>{let t=TW,e=!0,r=TW.channel!==void 0;return{...IW(t,e,r),getCancelSignal:l9.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})}},IW=(t,e,r)=>({sendMessage:eb.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getOneMessage:xW.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getEachMessage:AW.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})})});import{ChildProcess as yxe}from"node:child_process";import{PassThrough as _xe,Readable as bxe,Writable as vxe,Duplex as Sxe}from"node:stream";var PW,wxe,Bf,xxe,$xe,kxe,Exe,CW=y(()=>{Sb();zf();gb();PW=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,verboseInfo:s})=>{PR(n);let a=new yxe;wxe(a,n),Object.assign(a,{readable:xxe,writable:$xe,duplex:kxe});let c=yl({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:!1}),l=Exe(c,s,i);return{subprocess:a,promise:l}},wxe=(t,e)=>{let r=Bf(),n=Bf(),i=Bf(),o=Array.from({length:e.length-3},Bf),s=Bf(),a=[r,n,i,...o];Object.assign(t,{stdin:r,stdout:n,stderr:i,all:s,stdio:a})},Bf=()=>{let t=new _xe;return t.end(),t},xxe=()=>new bxe({read(){}}),$xe=()=>new vxe({write(){}}),kxe=()=>new Sxe({read(){},write(){}}),Exe=async(t,e,r)=>_l(t,e,r)});import{createReadStream as DW,createWriteStream as NW}from"node:fs";import{Buffer as Axe}from"node:buffer";import{Readable as Hf,Writable as Txe,Duplex as Oxe}from"node:stream";var MW,Gf,jW,Rxe,FW=y(()=>{Ab();Sb();_r();MW=(t,e)=>vb(Rxe,t,e,!1),Gf=({type:t,optionName:e})=>{throw new TypeError(`The \`${e}\` option cannot be ${os[t]}.`)},jW={fileNumber:Gf,generator:zR,asyncGenerator:zR,nodeStream:({value:t})=>({stream:t}),webTransform({value:{transform:t,writableObjectMode:e,readableObjectMode:r}}){let n=e||r;return{stream:Oxe.fromWeb(t,{objectMode:n})}},duplex:({value:{transform:t}})=>({stream:t}),native(){}},Rxe={input:{...jW,fileUrl:({value:t})=>({stream:DW(t)}),filePath:({value:{file:t}})=>({stream:DW(t)}),webStream:({value:t})=>({stream:Hf.fromWeb(t)}),iterable:({value:t})=>({stream:Hf.from(t)}),asyncIterable:({value:t})=>({stream:Hf.from(t)}),string:({value:t})=>({stream:Hf.from(t)}),uint8Array:({value:t})=>({stream:Hf.from(Axe.from(t))})},output:{...jW,fileUrl:({value:t})=>({stream:NW(t)}),filePath:({value:{file:t,append:e}})=>({stream:NW(t,e?{flags:"a"}:{})}),webStream:({value:t})=>({stream:Txe.fromWeb(t)}),iterable:Gf,asyncIterable:Gf,string:Gf,uint8Array:Gf}}});import{on as Ixe,once as LW}from"node:events";import{PassThrough as Pxe,getDefaultHighWaterMark as Cxe}from"node:stream";import{finished as qW}from"node:stream/promises";function Ta(t){if(!Array.isArray(t))throw new TypeError(`Expected an array, got \`${typeof t}\`.`);for(let i of t)JR(i);let e=t.some(({readableObjectMode:i})=>i),r=Dxe(t,e),n=new KR({objectMode:e,writableHighWaterMark:r,readableHighWaterMark:r});for(let i of t)n.add(i);return n}var Dxe,KR,Nxe,jxe,Mxe,JR,Fxe,Lxe,zxe,Uxe,qxe,BW,HW,YR,GW,Bxe,Rb,zW,UW,Ib=y(()=>{Dxe=(t,e)=>{if(t.length===0)return Cxe(e);let r=t.filter(({readableObjectMode:n})=>n===e).map(({readableHighWaterMark:n})=>n);return Math.max(...r)},KR=class extends Pxe{#t=new Set([]);#r=new Set([]);#e=new Set([]);#n;#o=Symbol("unpipe");#i=new WeakMap;add(e){if(JR(e),this.#t.has(e))return;this.#t.add(e),this.#n??=Nxe(this,this.#t,this.#o);let r=Fxe({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(JR(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)}},Nxe=async(t,e,r)=>{Rb(t,zW);let n=new AbortController;try{await Promise.race([jxe(t,n),Mxe(t,e,r,n)])}finally{n.abort(),Rb(t,-zW)}},jxe=async(t,{signal:e})=>{try{await qW(t,{signal:e,cleanup:!0})}catch(r){throw BW(t,r),r}},Mxe=async(t,e,r,{signal:n})=>{for await(let[i]of Ixe(t,"unpipe",{signal:n}))e.has(i)&&i.emit(r)},JR=t=>{if(typeof t?.pipe!="function")throw new TypeError(`Expected a readable stream, got: \`${typeof t}\`.`)},Fxe=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,onFinished:o,unpipeEvent:s})=>{Rb(t,UW);let a=new AbortController;try{await Promise.race([Lxe(o,e,a),zxe({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:a}),Uxe({stream:e,streams:r,ended:n,aborted:i,unpipeEvent:s,controller:a})])}finally{a.abort(),Rb(t,-UW)}r.size>0&&r.size===n.size+i.size&&(n.size===0&&i.size>0?YR(t):qxe(t))},Lxe=async(t,e,{signal:r})=>{try{await t,r.aborted||YR(e)}catch(n){r.aborted||BW(e,n)}},zxe=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:{signal:o}})=>{try{await qW(e,{signal:o,cleanup:!0,readable:!0,writable:!1}),r.has(e)&&n.add(e)}catch(s){if(o.aborted||!r.has(e))return;HW(s)?i.add(e):GW(t,s)}},Uxe=async({stream:t,streams:e,ended:r,aborted:n,unpipeEvent:i,controller:{signal:o}})=>{if(await LW(t,i,{signal:o}),!t.readable)return LW(o,"abort",{signal:o});e.delete(t),r.delete(t),n.delete(t)},qxe=t=>{t.writable&&t.end()},BW=(t,e)=>{HW(e)?YR(t):GW(t,e)},HW=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",YR=t=>{(t.readable||t.writable)&&t.destroy()},GW=(t,e)=>{t.destroyed||(t.once("error",Bxe),t.destroy(e))},Bxe=()=>{},Rb=(t,e)=>{let r=t.getMaxListeners();r!==0&&r!==Number.POSITIVE_INFINITY&&t.setMaxListeners(r+e)},zW=2,UW=1});import{finished as ZW}from"node:stream/promises";var vl,Hxe,XR,Gxe,QR,Pb=y(()=>{uo();vl=(t,e)=>{t.pipe(e),Hxe(t,e),Gxe(t,e)},Hxe=async(t,e)=>{if(!(Wn(t)||Wn(e))){try{await ZW(t,{cleanup:!0,readable:!0,writable:!1})}catch{}XR(e)}},XR=t=>{t.writable&&t.end()},Gxe=async(t,e)=>{if(!(Wn(t)||Wn(e))){try{await ZW(e,{cleanup:!0,readable:!1,writable:!0})}catch{}QR(t)}},QR=t=>{t.readable&&t.destroy()}});var VW,Zxe,Vxe,Wxe,Kxe,Jxe,WW=y(()=>{Ib();uo();q_();_r();Pb();VW=(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})=>kn.has(c)))Zxe(t,a,s,i);for(let{stream:a}of o.filter(({type:c})=>!kn.has(c)))Wxe({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]:Ta(o);vl(s,i)}},Zxe=(t,e,r,n)=>{r==="output"?vl(t.stdio[n],e):vl(e,t.stdio[n]);let i=Vxe[n];i!==void 0&&(t[i]=e),t.stdio[n]=e},Vxe=["stdin","stdout","stderr"],Wxe=({subprocess:t,stream:e,direction:r,fdNumber:n,pipeGroups:i,controller:o})=>{if(e===void 0)return;Kxe(e,o);let[s,a]=r==="output"?[e,t.stdio[n]]:[t.stdio[n],e],c=i.get(s)??[];i.set(s,[...c,a])},Kxe=(t,{signal:e})=>{Wn(t)&&Sa(t,Jxe,e)},Jxe=2});var Oa,KW=y(()=>{Oa=[];Oa.push("SIGHUP","SIGINT","SIGTERM");process.platform!=="win32"&&Oa.push("SIGALRM","SIGABRT","SIGVTALRM","SIGXCPU","SIGXFSZ","SIGUSR2","SIGTRAP","SIGSYS","SIGQUIT","SIGIOT");process.platform==="linux"&&Oa.push("SIGIO","SIGPOLL","SIGPWR","SIGSTKFLT")});var Cb,eI,tI,Yxe,rI,Db,Xxe,nI,iI,oI,JW,Vit,Wit,YW=y(()=>{KW();Cb=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",eI=Symbol.for("signal-exit emitter"),tI=globalThis,Yxe=Object.defineProperty.bind(Object),rI=class{emitted={afterExit:!1,exit:!1};listeners={afterExit:[],exit:[]};count=0;id=Math.random();constructor(){if(tI[eI])return tI[eI];Yxe(tI,eI,{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}},Db=class{},Xxe=t=>({onExit(e,r){return t.onExit(e,r)},load(){return t.load()},unload(){return t.unload()}}),nI=class extends Db{onExit(){return()=>{}}load(){}unload(){}},iI=class extends Db{#t=oI.platform==="win32"?"SIGINT":"SIGHUP";#r=new rI;#e;#n;#o;#i={};#s=!1;constructor(e){super(),this.#e=e,this.#i={};for(let r of Oa)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(!Cb(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 Oa)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,Oa.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 Cb(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"&&Cb(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)}},oI=globalThis.process,{onExit:JW,load:Vit,unload:Wit}=Xxe(Cb(oI)?new iI(oI):new nI)});import{addAbortListener as Qxe}from"node:events";var XW,QW=y(()=>{YW();XW=(t,{cleanup:e,detached:r},{signal:n})=>{if(!e||r)return;let i=JW(()=>{t.kill()});Qxe(n,()=>{i()})}});var tK,e0e,t0e,eK,r0e,rK=y(()=>{OO();O_();ns();il();tK=({source:t,sourcePromise:e,boundOptions:r,createNested:n},...i)=>{let o=T_(),{destination:s,destinationStream:a,destinationError:c,from:l,unpipeSignal:u}=e0e(r,n,i),{sourceStream:d,sourceError:f}=r0e(t,l),{options:p,fileDescriptors:m}=Ai.get(t);return{sourcePromise:e,sourceStream:d,sourceOptions:p,sourceError:f,destination:s,destinationStream:a,destinationError:c,unpipeSignal:u,fileDescriptors:m,startTime:o}},e0e=(t,e,r)=>{try{let{destination:n,pipeOptions:{from:i,to:o,unpipeSignal:s}={}}=t0e(t,e,...r),a=U_(n,o);return{destination:n,destinationStream:a,from:i,unpipeSignal:s}}catch(n){return{destinationError:n}}},t0e=(t,e,r,...n)=>{if(Array.isArray(r))return{destination:e(eK,t)(r,...n),pipeOptions:t};if(typeof r=="string"||r instanceof URL||AO(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]=y_(r,...n);return{destination:e(eK)(i,o,s),pipeOptions:s}}if(Ai.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}`)},eK=({options:t})=>({options:{...t,stdin:"pipe",piped:!0}}),r0e=(t,e)=>{try{return{sourceStream:ml(t,e)}}catch(r){return{sourceError:r}}}});var iK,n0e,sI,nK,aI=y(()=>{zf();Pb();iK=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n,fileDescriptors:i,sourceOptions:o,startTime:s})=>{let a=n0e({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n});if(a!==void 0)throw sI({error:a,fileDescriptors:i,sourceOptions:o,startTime:s})},n0e=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n})=>{if(e!==void 0&&n!==void 0)return n;if(n!==void 0)return QR(t),n;if(e!==void 0)return XR(r),e},sI=({error:t,fileDescriptors:e,sourceOptions:r,startTime:n})=>yl({error:t,command:nK,escapedCommand:nK,fileDescriptors:e,options:r,startTime:n,isSync:!1}),nK="source.pipe(destination)"});var oK,sK=y(()=>{oK=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 i0e}from"node:stream/promises";var aK,o0e,s0e,a0e,Nb,c0e,l0e,cK=y(()=>{Ib();q_();Pb();aK=(t,e,r)=>{let n=Nb.has(e)?s0e(t,e):o0e(t,e);return Sa(t,c0e,r.signal),Sa(e,l0e,r.signal),a0e(e),n},o0e=(t,e)=>{let r=Ta([t]);return vl(r,e),Nb.set(e,r),r},s0e=(t,e)=>{let r=Nb.get(e);return r.add(t),r},a0e=async t=>{try{await i0e(t,{cleanup:!0,readable:!1,writable:!0})}catch{}Nb.delete(t)},Nb=new WeakMap,c0e=2,l0e=1});import{aborted as u0e}from"node:util";var lK,d0e,uK=y(()=>{aI();lK=(t,e)=>t===void 0?[]:[d0e(t,e)],d0e=async(t,{sourceStream:e,mergedStream:r,fileDescriptors:n,sourceOptions:i,startTime:o})=>{await u0e(t,e),await r.remove(e);let s=new Error("Pipe canceled by `unpipeSignal` option.");throw sI({error:s,fileDescriptors:n,sourceOptions:i,startTime:o})}});var jb,f0e,p0e,dK=y(()=>{co();rK();aI();sK();cK();uK();jb=(t,...e)=>{if(At(e[0]))return jb.bind(void 0,{...t,boundOptions:{...t.boundOptions,...e[0]}});let{destination:r,...n}=tK(t,...e),i=f0e({...n,destination:r});return i.pipe=jb.bind(void 0,{...t,source:r,sourcePromise:i,boundOptions:{}}),i},f0e=async({sourcePromise:t,sourceStream:e,sourceOptions:r,sourceError:n,destination:i,destinationStream:o,destinationError:s,unpipeSignal:a,fileDescriptors:c,startTime:l})=>{let u=p0e(t,i);iK({sourceStream:e,sourceError:n,destinationStream:o,destinationError:s,fileDescriptors:c,sourceOptions:r,startTime:l});let d=new AbortController;try{let f=aK(e,o,d);return await Promise.race([oK(u),...lK(a,{sourceStream:e,mergedStream:f,sourceOptions:r,fileDescriptors:c,startTime:l})])}finally{d.abort()}},p0e=(t,e)=>Promise.allSettled([t,e])});import{on as m0e}from"node:events";import{getDefaultHighWaterMark as h0e}from"node:stream";var Mb,g0e,cI,y0e,pK,lI,fK,_0e,b0e,Fb=y(()=>{jR();xb();LR();Mb=({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:n,encoding:i,preserveNewlines:o})=>{let s=new AbortController;return g0e(e,s),pK({stream:t,controller:s,binary:r,shouldEncode:!t.readableObjectMode&&n,encoding:i,shouldSplit:!t.readableObjectMode,preserveNewlines:o})},g0e=async(t,e)=>{try{await t}catch{}finally{e.abort()}},cI=({stream:t,onStreamEnd:e,lines:r,encoding:n,stripFinalNewline:i,allMixed:o})=>{let s=new AbortController;y0e(e,s,t);let a=t.readableObjectMode&&!o;return pK({stream:t,controller:s,binary:n==="buffer",shouldEncode:!a,encoding:n,shouldSplit:!a&&r,preserveNewlines:!i})},y0e=async(t,e,r)=>{try{await t}catch{r.destroy()}finally{e.abort()}},pK=({stream:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})=>{let a=m0e(t,"data",{signal:e.signal,highWaterMark:fK,highWatermark:fK});return _0e({onStdoutChunk:a,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})},lI=h0e(!0),fK=lI,_0e=async function*({onStdoutChunk:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s}){let a=b0e({binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s});try{for await(let[c]of t)yield*Aa(c,a,0)}catch(c){if(!e.signal.aborted)throw c}finally{yield*qf(a)}},b0e=({binary:t,shouldEncode:e,encoding:r,shouldSplit:n,preserveNewlines:i})=>[$b(t,r,!e),wb(t,i,!n,{})].filter(Boolean)});import{setImmediate as v0e}from"node:timers/promises";var mK,S0e,w0e,x0e,uI,hK,dI=y(()=>{pb();tn();UR();Fb();ka();Uf();mK=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=S0e({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:a,verboseInfo:l,streamInfo:u});if(!i){await Promise.all([w0e(t),d]);return}let f=CR(c,r),p=cI({stream:t,onStreamEnd:e,lines:s,encoding:n,stripFinalNewline:f,allMixed:a}),[m]=await Promise.all([x0e({stream:t,iterable:p,fdNumber:r,encoding:n,maxBuffer:o,lines:s}),d]);return m},S0e=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:i,verboseInfo:o,streamInfo:{fileDescriptors:s}})=>{if(!Tb({stdioItems:s[r]?.stdioItems,encoding:n,verboseInfo:o,fdNumber:r}))return;let a=cI({stream:t,onStreamEnd:e,lines:!0,encoding:n,stripFinalNewline:!0,allMixed:i});await lW(a,t,r,o)},w0e=async t=>{await v0e(),t.readableFlowing===null&&t.resume()},x0e=async({stream:t,stream:{readableObjectMode:e},iterable:r,fdNumber:n,encoding:i,maxBuffer:o,lines:s})=>{try{return e||s?await lb(r,{maxBuffer:o}):i==="buffer"?new Uint8Array(await ub(r,{maxBuffer:o})):await fb(r,{maxBuffer:o})}catch(a){return hK(V9({error:a,stream:t,readableObjectMode:e,lines:s,encoding:i,fdNumber:n}))}},uI=async t=>{try{return await t}catch(e){return hK(e)}},hK=({bufferedData:t})=>LH(t)?new Uint8Array(t):t});import{finished as $0e}from"node:stream/promises";var Zf,k0e,E0e,A0e,T0e,O0e,fI,Lb,gK,zb=y(()=>{Zf=async(t,e,r,{isSameDirection:n,stopOnExit:i=!1}={})=>{let o=k0e(t,r),s=new AbortController;try{await Promise.race([...i?[r.exitPromise]:[],$0e(t,{cleanup:!0,signal:s.signal})])}catch(a){o.stdinCleanedUp||T0e(a,e,r,n)}finally{s.abort()}},k0e=(t,{originalStreams:[e],subprocess:r})=>{let n={stdinCleanedUp:!1};return t===e&&E0e(t,r,n),n},E0e=(t,e,r)=>{let{_destroy:n}=t;t._destroy=(...i)=>{A0e(e,r),n.call(t,...i)}},A0e=({exitCode:t,signalCode:e},r)=>{(t!==null||e!==null)&&(r.stdinCleanedUp=!0)},T0e=(t,e,r,n)=>{if(!O0e(t,e,r,n))throw t},O0e=(t,e,r,n=!0)=>r.propagating?gK(t)||Lb(t):(r.propagating=!0,fI(r,e)===n?gK(t):Lb(t)),fI=({fileDescriptors:t},e)=>e!=="all"&&t[e].direction==="input",Lb=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",gK=t=>t?.code==="EPIPE"});var yK,pI,mI=y(()=>{dI();zb();yK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>t.stdio.map((c,l)=>pI({stream:c,fdNumber:l,encoding:e,buffer:r[l],maxBuffer:n[l],lines:i[l],allMixed:!1,stripFinalNewline:o,verboseInfo:s,streamInfo:a})),pI=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=Zf(t,e,l);if(fI(l,e)){await u;return}let[d]=await Promise.all([mK({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 _K,bK,R0e,I0e,hI=y(()=>{Ib();mI();_K=({stdout:t,stderr:e},{all:r})=>r&&(t||e)?Ta([t,e].filter(Boolean)):void 0,bK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>pI({...R0e(t,r),fdNumber:"all",encoding:e,maxBuffer:n[1]+n[2],lines:i[1]||i[2],allMixed:I0e(t),stripFinalNewline:o,verboseInfo:s,streamInfo:a}),R0e=({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}},I0e=({all:t,stdout:e,stderr:r})=>t&&e&&r&&e.readableObjectMode!==r.readableObjectMode});var vK,SK,wK=y(()=>{al();ts();vK=t=>sl(t,"ipc"),SK=(t,e)=>{let r=A_(t);ki({type:"ipc",verboseMessage:r,fdNumber:"ipc",verboseInfo:e})}});var xK,$K,kK=y(()=>{ka();wK();po();VR();xK=async({subprocess:t,buffer:e,maxBuffer:r,ipc:n,ipcOutput:i,verboseInfo:o})=>{if(!n)return i;let s=vK(o),a=fo(e,"ipc"),c=fo(r,"ipc");for await(let l of ZR({anyProcess:t,channel:t.channel,isSubprocess:!1,ipc:n,shouldAwait:!1,reference:!0}))a&&(W9(t,i,c),i.push(l)),s&&SK(l,o);return i},$K=async(t,e)=>(await Promise.allSettled([t]),e)});import{once as P0e}from"node:events";var EK,C0e,D0e,N0e,AK=y(()=>{$a();cR();QO();aR();uo();_r();dI();kK();uR();hI();mI();HR();zb();EK=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 _=gW(t,f),S={originalStreams:h,fileDescriptors:m,subprocess:t,exitPromise:_,propagating:!1},x=yK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),w=bK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),O=[],A=xK({subprocess:t,buffer:r,maxBuffer:n,ipc:u,ipcOutput:O,verboseInfo:p}),E=C0e(h,t,S),C=D0e(m,S);try{return await Promise.race([Promise.all([{},_W(_),Promise.all(x),w,A,b9(t,d),...E,...C]),g,N0e(t,b),...m9(t,o,f,b),...DZ({subprocess:t,cancelSignal:s,gracefulCancel:a,context:f,controller:b}),...f9({subprocess:t,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,context:f,controller:b})])}catch(k){return f.terminationReason??="other",Promise.all([{error:k},_,Promise.all(x.map(q=>uI(q))),uI(w),$K(A,O),Promise.allSettled(E),Promise.allSettled(C)])}},C0e=(t,e,r)=>t.map((n,i)=>n===e.stdio[i]?void 0:Zf(n,i,r)),D0e=(t,e)=>t.flatMap(({stdioItems:r},n)=>r.filter(({value:i,stream:o=i})=>Yn(o,{checkOpen:!1})&&!Wn(o)).map(({type:i,value:o,stream:s=o})=>Zf(s,n,e,{isSameDirection:kn.has(i),stopOnExit:i==="native"}))),N0e=async(t,{signal:e})=>{let[r]=await P0e(t,"error",{signal:e});throw r}});var TK,Vf,Sl,Ub=y(()=>{pl();TK=()=>({readableDestroy:new WeakMap,writableFinal:new WeakMap,writableDestroy:new WeakMap}),Vf=(t,e,r)=>{let n=t[r];n.has(e)||n.set(e,[]);let i=n.get(e),o=Ei();return i.push(o),{resolve:o.resolve.bind(o),promises:i}},Sl=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 OK}from"node:stream/promises";var gI,RK,yI,_I,qb,Bb,bI=y(()=>{zb();gI=async t=>{if(t!==void 0)try{await yI(t)}catch{}},RK=async t=>{if(t!==void 0)try{await _I(t)}catch{}},yI=async t=>{await OK(t,{cleanup:!0,readable:!1,writable:!0})},_I=async t=>{await OK(t,{cleanup:!0,readable:!0,writable:!1})},qb=async(t,e)=>{if(await t,e)throw e},Bb=(t,e,r)=>{r&&!Lb(r)?t.destroy(r):e&&t.destroy()}});import{Readable as j0e}from"node:stream";import{callbackify as M0e}from"node:util";var IK,vI,SI,wI,F0e,xI,$I,PK,kI=y(()=>{wa();ns();Fb();pl();Ub();bI();IK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,binary:i=!0,preserveNewlines:o=!0}={})=>{let s=i||rn.has(r),{subprocessStdout:a,waitReadableDestroy:c}=vI(t,n,e),{readableEncoding:l,readableObjectMode:u,readableHighWaterMark:d}=SI(a,s),{read:f,onStdoutDataDone:p}=wI({subprocessStdout:a,subprocess:t,binary:s,encoding:r,preserveNewlines:o}),m=new j0e({read:f,destroy:M0e($I.bind(void 0,{subprocessStdout:a,subprocess:t,waitReadableDestroy:c})),highWaterMark:d,objectMode:u,encoding:l});return xI({subprocessStdout:a,onStdoutDataDone:p,readable:m,subprocess:t}),m},vI=(t,e,r)=>{let n=ml(t,e),i=Vf(r,n,"readableDestroy");return{subprocessStdout:n,waitReadableDestroy:i}},SI=({readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r},n)=>n?{readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r}:{readableEncoding:t,readableObjectMode:!0,readableHighWaterMark:lI},wI=({subprocessStdout:t,subprocess:e,binary:r,encoding:n,preserveNewlines:i})=>{let o=Ei(),s=Mb({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:!r,encoding:n,preserveNewlines:i});return{read(){F0e(this,s,o)},onStdoutDataDone:o}},F0e=async(t,e,r)=>{try{let{value:n,done:i}=await e.next();i?r.resolve():t.push(n)}catch{}},xI=async({subprocessStdout:t,onStdoutDataDone:e,readable:r,subprocess:n,subprocessStdin:i})=>{try{await _I(t),await n,await gI(i),await e,r.readable&&r.push(null)}catch(o){await gI(i),PK(r,o)}},$I=async({subprocessStdout:t,subprocess:e,waitReadableDestroy:r},n)=>{await Sl(r,e)&&(PK(t,n),await qb(e,n))},PK=(t,e)=>{Bb(t,t.readable,e)}});import{Writable as L0e}from"node:stream";import{callbackify as CK}from"node:util";var DK,EI,AI,z0e,U0e,TI,OI,NK,RI=y(()=>{ns();Ub();bI();DK=({subprocess:t,concurrentStreams:e},{to:r}={})=>{let{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}=EI(t,r,e),s=new L0e({...AI(n,t,i),destroy:CK(OI.bind(void 0,{subprocessStdin:n,subprocess:t,waitWritableFinal:i,waitWritableDestroy:o})),highWaterMark:n.writableHighWaterMark,objectMode:n.writableObjectMode});return TI(n,s),s},EI=(t,e,r)=>{let n=U_(t,e),i=Vf(r,n,"writableFinal"),o=Vf(r,n,"writableDestroy");return{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}},AI=(t,e,r)=>({write:z0e.bind(void 0,t),final:CK(U0e.bind(void 0,t,e,r))}),z0e=(t,e,r,n)=>{t.write(e,r)?n():t.once("drain",n)},U0e=async(t,e,r)=>{await Sl(r,e)&&(t.writable&&t.end(),await e)},TI=async(t,e,r)=>{try{await yI(t),e.writable&&e.end()}catch(n){await RK(r),NK(e,n)}},OI=async({subprocessStdin:t,subprocess:e,waitWritableFinal:r,waitWritableDestroy:n},i)=>{await Sl(r,e),await Sl(n,e)&&(NK(t,i),await qb(e,i))},NK=(t,e)=>{Bb(t,t.writable,e)}});import{Duplex as q0e}from"node:stream";import{callbackify as B0e}from"node:util";var jK,H0e,MK=y(()=>{wa();kI();RI();jK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,to:i,binary:o=!0,preserveNewlines:s=!0}={})=>{let a=o||rn.has(r),{subprocessStdout:c,waitReadableDestroy:l}=vI(t,n,e),{subprocessStdin:u,waitWritableFinal:d,waitWritableDestroy:f}=EI(t,i,e),{readableEncoding:p,readableObjectMode:m,readableHighWaterMark:h}=SI(c,a),{read:g,onStdoutDataDone:b}=wI({subprocessStdout:c,subprocess:t,binary:a,encoding:r,preserveNewlines:s}),_=new q0e({read:g,...AI(u,t,d),destroy:B0e(H0e.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 xI({subprocessStdout:c,onStdoutDataDone:b,readable:_,subprocess:t,subprocessStdin:u}),TI(u,_,c),_},H0e=async({subprocessStdout:t,subprocessStdin:e,subprocess:r,waitReadableDestroy:n,waitWritableFinal:i,waitWritableDestroy:o},s)=>{await Promise.all([$I({subprocessStdout:t,subprocess:r,waitReadableDestroy:n},s),OI({subprocessStdin:e,subprocess:r,waitWritableFinal:i,waitWritableDestroy:o},s)])}});var II,G0e,FK=y(()=>{wa();ns();Fb();II=(t,e,{from:r,binary:n=!1,preserveNewlines:i=!1}={})=>{let o=n||rn.has(e),s=ml(t,r),a=Mb({subprocessStdout:s,subprocess:t,binary:o,shouldEncode:!0,encoding:e,preserveNewlines:i});return G0e(a,s,t)},G0e=async function*(t,e,r){try{yield*t}finally{e.readable&&e.destroy(),await r}}});var LK,zK=y(()=>{Ub();kI();RI();MK();FK();LK=(t,{encoding:e})=>{let r=TK();t.readable=IK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.writable=DK.bind(void 0,{subprocess:t,concurrentStreams:r}),t.duplex=jK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.iterable=II.bind(void 0,t,e),t[Symbol.asyncIterator]=II.bind(void 0,t,e,{})}});var UK,Z0e,V0e,qK=y(()=>{UK=(t,e)=>{for(let[r,n]of V0e){let i=n.value.bind(e);Reflect.defineProperty(t,r,{...n,value:i})}},Z0e=(async()=>{})().constructor.prototype,V0e=["then","catch","finally"].map(t=>[t,Reflect.getOwnPropertyDescriptor(Z0e,t)])});import{setMaxListeners as W0e}from"node:events";import{spawn as K0e}from"node:child_process";var BK,J0e,Y0e,X0e,Q0e,e$e,HK=y(()=>{pb();LO();pR();ns();mR();WR();zf();gb();CW();FW();Uf();WW();M_();QW();dK();hI();AK();zK();pl();qK();BK=(t,e,r,n)=>{let{file:i,commandArguments:o,command:s,escapedCommand:a,startTime:c,verboseInfo:l,options:u,fileDescriptors:d}=J0e(t,e,r),{subprocess:f,promise:p}=X0e({file:i,commandArguments:o,options:u,startTime:c,verboseInfo:l,command:s,escapedCommand:a,fileDescriptors:d});return f.pipe=jb.bind(void 0,{source:f,sourcePromise:p,boundOptions:{},createNested:n}),UK(f,p),Ai.set(f,{options:u,fileDescriptors:d}),f},J0e=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=R_(t,e,r),{file:a,commandArguments:c,options:l}=nb(t,e,r),u=Y0e(l),d=MW(u,s);return{file:a,commandArguments:c,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},Y0e=({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}},X0e=({file:t,commandArguments:e,options:r,startTime:n,verboseInfo:i,command:o,escapedCommand:s,fileDescriptors:a})=>{let c;try{c=K0e(...ib(t,e,r))}catch(m){return PW({error:m,command:o,escapedCommand:s,fileDescriptors:a,options:r,startTime:n,verboseInfo:i})}let l=new AbortController;W0e(Number.POSITIVE_INFINITY,l.signal);let u=[...c.stdio];VW(c,a,l),XW(c,r,l);let d={},f=Ei();c.kill=PZ.bind(void 0,{kill:c.kill.bind(c),options:r,onInternalError:f,context:d,controller:l}),c.all=_K(c,r),LK(c,r),OW(c,r);let p=Q0e({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}},Q0e=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 EK({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)=>ho(x,e,w)),_=ho(h,e,"all"),S=e$e({errorInfo:d,exitCode:f,signal:p,stdio:b,all:_,ipcOutput:g,context:c,options:e,command:s,escapedCommand:a,startTime:r});return _l(S,n,e)},e$e=({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?Lf({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 Ti,isForcefullyTerminated:s.isForcefullyTerminated,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,options:a,startTime:u,isSync:!1}):hb({command:c,escapedCommand:l,stdio:n,all:i,ipcOutput:o,options:a,startTime:u})});var Hb,t$e,r$e,GK=y(()=>{co();po();Hb=(t,e)=>{let r=Object.fromEntries(Object.entries(e).map(([n,i])=>[n,t$e(n,t[n],i)]));return{...t,...r}},t$e=(t,e,r)=>r$e.has(t)&&At(e)&&At(r)?{...e,...r}:r,r$e=new Set(["env",...DO])});var ss,n$e,i$e,ZK=y(()=>{co();OO();VH();wW();HK();GK();ss=(t,e,r,n)=>{let i=(s,a,c)=>ss(s,a,r,c),o=(...s)=>n$e({mapArguments:t,deepOptions:r,boundOptions:e,setBoundExeca:n,createNested:i},...s);return n!==void 0&&n(o,i,e),o},n$e=({mapArguments:t,deepOptions:e={},boundOptions:r={},setBoundExeca:n,createNested:i},o,...s)=>{if(At(o))return i(t,Hb(r,o),n);let{file:a,commandArguments:c,options:l,isSync:u}=i$e({mapArguments:t,firstArgument:o,nextArguments:s,deepOptions:e,boundOptions:r});return u?SW(a,c,l):BK(a,c,l,i)},i$e=({mapArguments:t,firstArgument:e,nextArguments:r,deepOptions:n,boundOptions:i})=>{let o=GH(e)?ZH(e,r):[e,...r],[s,a,c]=y_(...o),l=Hb(Hb(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 VK,WK,KK,o$e,s$e,JK=y(()=>{VK=({file:t,commandArguments:e})=>KK(t,e),WK=({file:t,commandArguments:e})=>({...KK(t,e),isSync:!0}),KK=(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]=o$e(t);return{file:r,commandArguments:n}},o$e=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(s$e)){let i=r.at(-1);i&&i.endsWith("\\")?r[r.length-1]=`${i.slice(0,-1)} ${n}`:r.push(n)}return r},s$e=/ +/g});var YK,XK,a$e,QK,c$e,e3,t3=y(()=>{YK=(t,e,r)=>{t.sync=e(a$e,r),t.s=t.sync},XK=({options:t})=>QK(t),a$e=({options:t})=>({...QK(t),isSync:!0}),QK=t=>({options:{...c$e(t),...t}}),c$e=({input:t,inputFile:e,stdio:r})=>t===void 0&&e===void 0&&r===void 0?{stdin:"inherit"}:{},e3={preferLocal:!0}});var Mat,Je,Fat,Lat,zat,Uat,qat,Bat,Hat,Gat,jr=y(()=>{ZK();JK();lR();t3();WR();Mat=ss(()=>({})),Je=ss(()=>({isSync:!0})),Fat=ss(VK),Lat=ss(WK),zat=ss(g9),Uat=ss(XK,{},e3,YK),{sendMessage:qat,getOneMessage:Bat,getEachMessage:Hat,getCancelSignal:Gat}=RW()});import{existsSync as Gb,statSync as l$e}from"node:fs";import{dirname as PI,extname as u$e,isAbsolute as r3,join as CI,relative as DI,resolve as Zb,sep as d$e}from"node:path";function Vb(t){return t==="./gradlew"||t==="gradle"}function f$e(t){return(Gb(CI(t,"build.gradle.kts"))||Gb(CI(t,"build.gradle")))&&Gb(CI(t,"gradle.properties"))}function p$e(t,e){let n=DI(t,e).split(d$e).filter(Boolean);return n.length===0?":":`:${n.join(":")}`}function as(t,e){return t===":"?`:${e}`:`${t}:${e}`}function m$e(t,e){let r=Zb(t,e),n=r;Gb(r)?l$e(r).isFile()&&(n=PI(r)):u$e(r)!==""&&(n=PI(r));let i=DI(t,n);if(i.startsWith("..")||r3(i))return null;let o=n;for(;;){if(f$e(o))return o;if(Zb(o)===Zb(t))return null;let s=PI(o);if(s===o)return null;let a=DI(t,s);if(a.startsWith("..")||r3(a))return null;o=s}}function Wb(t,e){let r=Zb(t),n=new Map,i=[];for(let o of e){let s=m$e(r,o);if(!s){i.push(o);continue}let a=p$e(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 Kb=y(()=>{"use strict"});import{existsSync as h$e,readFileSync as g$e}from"node:fs";import{join as y$e}from"node:path";function wl(t="."){let e=y$e(t,".cladding","config.yaml");if(!h$e(e))return NI;try{let n=(0,n3.parse)(g$e(e,"utf8"))?.gate;if(!n)return NI;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 _$e){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 NI}}function i3(t,e){let r=[],n=!1;for(let i of t){let o=b$e.exec(i);if(o){n=!0;for(let s of e)r.push(as(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 n3,_$e,NI,b$e,Jb=y(()=>{"use strict";n3=Et(cr(),1);Kb();_$e=["type","lint","test","coverage"],NI={scope:"feature"};b$e=/^\{modules:([A-Za-z0-9_.:-]+)\}$/});import{existsSync as MI,readFileSync as o3,readdirSync as v$e,statSync as S$e}from"node:fs";import{join as Yb}from"node:path";function zI(t){for(let e of["build.gradle.kts","build.gradle","gradle.properties"]){let r=Yb(t,e);if(MI(r))try{if(s3.test(o3(r,"utf8")))return!0}catch{}}return!1}function a3(t){try{return MI(t)&&s3.test(o3(t,"utf8"))}catch{return!1}}function c3(t,e=0){if(e>4||!MI(t))return!1;let r;try{r=v$e(t)}catch{return!1}for(let n of r){let i=Yb(t,n),o=!1;try{o=S$e(i).isDirectory()}catch{continue}if(o){if(n==="build"||n===".gradle"||n==="node_modules")continue;if(c3(i,e+1))return!0}else if(/\.(kts|gradle|toml)$/.test(n)&&a3(i))return!0}return!1}function $$e(t){if(zI(t))return!0;for(let e of w$e)if(a3(Yb(t,e)))return!0;for(let e of x$e)if(c3(Yb(t,e)))return!0;return!1}function l3(t="."){let e=wl(t).coverage;return e||($$e(t)?"kover":"jacoco")}function u3(t="."){return FI[l3(t)]}function d3(t="."){return jI[l3(t)]}var FI,jI,LI,s3,w$e,x$e,Xb=y(()=>{"use strict";Jb();FI={kover:"koverXmlReport",jacoco:"jacocoTestReport"},jI={kover:"build/reports/kover/report.xml",jacoco:"build/reports/jacoco/test/jacocoTestReport.xml"},LI=[jI.kover,jI.jacoco],s3=/kover/i;w$e=["build.gradle.kts","build.gradle","settings.gradle.kts","settings.gradle","gradle/libs.versions.toml"],x$e=["buildSrc","build-logic"]});import{existsSync as Qb,readFileSync as f3,readdirSync as p3}from"node:fs";import{join as Ra}from"node:path";function UI(t){return Qb(Ra(t,"gradlew"))?"./gradlew":"gradle"}function k$e(t){let e=UI(t);return{type:{cmd:e,args:["compileKotlin","compileTestKotlin"]},lint:{cmd:e,args:["ktlintCheck"]},test:{cmd:e,args:["test"]},coverage:{cmd:e,args:[u3(t)]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}}function E$e(t){let e=!1;try{e=/(^|\n)\s*flutter\s*:|sdk:\s*flutter/.test(f3(Ra(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 T$e(t,e){let r=[t],n=0,i=4e3;for(;r.length>0&&na.name.endsWith(c)))return!0}return!1}function I$e(t,e){for(let r of e)if(Qb(Ra(t,r)))return r}function P$e(t,e){try{return p3(t).find(n=>n.endsWith(e))}catch{return}}function D$e(t,e){for(let r of C$e)if(r.configs.some(n=>Qb(Ra(t,n))))return r.gate;return e}function j$e(t){if(N$e.some(e=>Qb(Ra(t,e))))return!0;try{return JSON.parse(f3(Ra(t,"package.json"),"utf8")).jest!==void 0}catch{return!1}}function M$e(t,e){let r=e.lint?{...e,lint:D$e(t,e.lint)}:{...e};return e.test&&e.coverage&&j$e(t)?{...r,test:{cmd:"npx",args:["--no-install","jest"]},coverage:{cmd:"npx",args:["--no-install","jest","--coverage"]}}:r}function ht(t="."){for(let e of O$e){let r;for(let o of e.manifests)if(o.startsWith(".")?r=P$e(t,o):r=I$e(t,[o]),r)break;if(!r||e.requiresSource&&!T$e(t,e.requiresSource))continue;let n=typeof e.gates=="function"?e.gates(t):e.gates,i=e.language==="typescript"?M$e(t,n):n;return{language:e.language,manifest:r,gates:i}}return R$e}var A$e,O$e,R$e,C$e,N$e,En=y(()=>{"use strict";Xb();A$e=new Set(["node_modules",".git",".gradle",".idea","build","target","dist","out",".cladding"]);O$e=[{language:"typescript",manifests:["package.json"],gates:{type:{cmd:"npx",args:["--no-install","tsc","--noEmit"]},lint:{cmd:"npx",args:["--no-install","eslint","."]},test:{cmd:"npx",args:["--no-install","vitest","run"]},coverage:{cmd:"npx",args:["--no-install","vitest","run","--coverage"]},secret:{cmd:"npx",args:["--no-install","secretlint","**/*"]},arch:{cmd:"npx",args:["--no-install","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:k$e},{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:E$e}],R$e={language:"unknown",manifest:"",gates:{}};C$e=[{configs:["biome.json","biome.jsonc"],gate:{cmd:"npx",args:["--no-install","biome","lint","."]}},{configs:[".oxlintrc.json",".oxlintrc.jsonc","oxlint.config.ts"],gate:{cmd:"npx",args:["--no-install","oxlint"]}}];N$e=["jest.config.js","jest.config.ts","jest.config.mjs","jest.config.cjs","jest.config.json"]});import{existsSync as F$e,readFileSync as L$e}from"node:fs";import{join as z$e}from"node:path";function Ia(t){return t.code==="ENOENT"}function ev(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 m3.test(o)||m3.test(s)?[{detector:e,severity:"info",message:n(a)}]:[{detector:e,severity:"error",message:r(a)}]}function Lt(t,e,r){return Ia(r)?{stage:t,pass:!1,exitCode:2,stderr:`'${e}' not installed`}: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 xl(t,e){let r=z$e(t,"package.json");if(!F$e(r))return!1;try{return!!JSON.parse(L$e(r,"utf8")).scripts?.[e]}catch{return!1}}var m3,An=y(()=>{"use strict";m3=/config (is |file )?not found|no such file|ENOENT|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 U$e(t){let{cwd:e="."}=t,r=ht(e),n=r.gates.arch;if(!n)return[{detector:tv,severity:"info",message:`no architecture validator registered for language '${r.language}' (compiler may already enforce acyclic imports)`}];let i=Je(n.cmd,[...n.args],{cwd:e,reject:!1});return Ia(i)?[{detector:tv,severity:"info",message:`architecture validator '${n.cmd}' not installed`}]:ev(i,tv,o=>`${n.cmd} reported architecture violations: ${o}`,o=>`${n.cmd} could not validate (config/setup gap, not a violation): ${o}`)}var tv,Pa,rv=y(()=>{"use strict";jr();En();An();tv="ARCHITECTURE_VIOLATION";Pa={name:tv,subprocess:!0,run:U$e}});function q$e(t){let{cwd:e="."}=t,r=ht(e),n=r.gates.secret;if(!n)return[{detector:nv,severity:"info",message:`no secret scanner registered for language '${r.language}'`}];let i=Je(n.cmd,[...n.args],{cwd:e,reject:!1});return Ia(i)?[{detector:nv,severity:"info",message:`secret scanner '${n.cmd}' not installed`}]:ev(i,nv,o=>`${n.cmd} reported secrets: ${o}`,o=>`${n.cmd} could not scan (config/setup gap, not a secret): ${o}`)}var nv,Ca,iv=y(()=>{"use strict";jr();En();An();nv="HARDCODED_SECRET";Ca={name:nv,subprocess:!0,run:q$e}});import{existsSync as qI,readdirSync as h3}from"node:fs";import{join as ov}from"node:path";function H$e(t,e){let r=ov(t,e.path);if(!qI(r))return!0;if(e.isDirectory)try{return h3(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml")).length===0}catch{return!0}return!1}function G$e(t){let{cwd:e="."}=t,r=[];for(let i of B$e)H$e(e,i)&&r.push({detector:Wf,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=ov(e,"spec.yaml");if(qI(n)){let i=W$e(n),o=i?null:Z$e(e);if(i)r.push({detector:Wf,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:Wf,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=V$e(e);s&&r.push({detector:Wf,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 Z$e(t){for(let e of["spec/features","spec/scenarios"]){let r=ov(t,e);if(!qI(r))continue;let n;try{n=h3(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml"))}catch{continue}for(let i of[...n].sort())try{wi(ov(r,i))}catch(o){return{path:`${e}/${i}`,reason:o.message}}}return null}function V$e(t){try{return H(t),null}catch(e){return e.message}}function W$e(t){let e;try{e=wi(t)}catch(r){return`unparseable: ${r.message}`}return e===null||typeof e!="object"||Array.isArray(e)?"empty or not a YAML mapping":null}var Wf,B$e,g3,y3=y(()=>{"use strict";qe();a_();Wf="ABSENCE_OF_GOVERNANCE",B$e=[{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}];g3={name:Wf,run:G$e}});function sv(t){let e=t.trim().match(/^(\S+)/);return e?e[1].toLowerCase():""}function BI(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=sv(r)==="while",o=J$e.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 '${sv(r)}'`}let n=K$e[t];return r.length===0?`ears='${t}' requires condition starting with '${n}' \u2014 empty`:sv(r)!==n?`ears='${t}' requires condition to start with '${n}' \u2014 got '${sv(r)}'`:null}function Y$e(t,e){let r=BI(e.ears,e.condition);return r?[{featureId:t.id,acId:e.id,pattern:e.ears??"unspecified",message:r}]:[]}function _3(t){let e=[];for(let r of t)for(let n of r.acceptance_criteria??[])e.push(...Y$e(r,n));return e}var K$e,J$e,HI=y(()=>{"use strict";K$e={event:"when",state:"while",optional:"where",unwanted:"if"},J$e=/\bwhen\b/i});function he(t,e,r){let n;try{n=H(t)}catch(i){return[{detector:e,severity:"info",message:`spec.yaml not loaded: ${i.message}`}]}return r(n)}var bt=y(()=>{"use strict";qe()});function X$e(t){let{cwd:e="."}=t;return he(e,av,Q$e)}function Q$e(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:av,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 _3(t.features))e.push({detector:av,severity:"error",message:`${r.featureId}.${r.acId} EARS: ${r.message}`});return e}var av,b3,v3=y(()=>{"use strict";HI();bt();av="AC_DRIFT";b3={name:av,run:X$e}});function Ri(t=".",e){let n=(e??"").trim().toLowerCase()||ht(t).language;return w3[n]??S3}var eke,tke,rke,S3,nke,ike,w3,oke,x3,Da=y(()=>{"use strict";En();eke=/(?:import\s+(?:[\s\S]*?\sfrom\s+)?|import\s*\()['"]([^'"]+)['"]\)?/g,tke=/^[ \t]*import\s+([\w.]+)/gm,rke=/^[ \t]*(?:from|import)\s+([\w.]+)/gm,S3={ext:"ts",extensions:[".ts",".tsx"],sourceRoots:["src"],mainRoot:"src",testGlobs:["tests/**/*.test.ts"],coverageSummary:"coverage/coverage-summary.json",coverageFormat:"istanbul-json",importMatcher:eke,importStyle:"relative"},nke={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:tke,importStyle:"dotted"},ike={ext:"py",extensions:[".py"],sourceRoots:["."],mainRoot:"src",testGlobs:["tests/test_*.py","tests/**/test_*.py","tests/**/*_test.py"],coverageSummary:"coverage.xml",coverageFormat:"cobertura-xml",importMatcher:rke,importStyle:"dotted"},w3={typescript:S3,kotlin:nke,python:ike},oke=[".js",".jsx",".mts",".cts",".rs",".go",".java",".rb",".php",".cs",".fs",".ex",".exs"],x3=new Set([...Object.values(w3).flatMap(t=>t?.extensions??[]),...oke].map(t=>t.toLowerCase()))});import{existsSync as ske,readFileSync as ake,readdirSync as cke,statSync as lke}from"node:fs";import{join as k3,relative as $3}from"node:path";function uke(t,e){if(!ske(t))return[];let r=[],n=[t];for(;n.length>0;){let i=n.pop(),o;try{o=cke(i)}catch{continue}for(let s of o){if(s==="node_modules"||s===".cladding"||s.startsWith("."))continue;let a=k3(i,s),c;try{c=lke(a)}catch{continue}c.isDirectory()?n.push(a):e.some(l=>s.endsWith(l))&&r.push(a)}}return r}function dke(t){let e=t.trim();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("*")}function pke(t){return fke.test(t)}function mke(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=r.project.ai_hints?.forbidden_patterns;if(!n||n.length===0)return[];let i=Ri(e,r.project?.language),o=i.sourceRoots.flatMap(a=>uke(k3(e,a),i.extensions));if(o.length===0)return[];let s=[];for(let a of o){let c;try{c=ake(a,"utf8")}catch{continue}let l=c.split(` -`);for(let u=0;u{"use strict";qe();Da();E3="AI_HINTS_FORBIDDEN_PATTERN";fke=/\/\/\s*cladding-disable[:\s]+AI_HINTS_FORBIDDEN_PATTERN\b/;A3={name:E3,run:mke}});function hke(t){let{cwd:e="."}=t,r;try{r=H(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:O3,severity:"error",message:`${i.id}.${a} appears ${c} times \u2014 AC ids must be unique within a feature`})}return n}var O3,R3,I3=y(()=>{"use strict";qe();O3="AC_DUPLICATE_WITHIN_FEATURE";R3={name:O3,run:hke}});import{createRequire as gke}from"module";import{basename as yke,dirname as ZI,normalize as _ke,relative as bke,resolve as vke,sep as D3}from"path";import*as Ske from"fs";function wke(t){let e=_ke(t);return e.length>1&&e[e.length-1]===D3&&(e=e.substring(0,e.length-1)),e}function N3(t,e){return t.replace(xke,e)}function kke(t){return t==="/"||$ke.test(t)}function GI(t,e){let{resolvePaths:r,normalizePath:n,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(r&&(t=vke(t)),(n||o)&&(t=wke(t)),t===".")return"";let s=t[t.length-1]!==i;return N3(s?t+i:t,i)}function j3(t,e){return e+t}function Eke(t,e){return function(r,n){return n.startsWith(t)?n.slice(t.length)+r:N3(bke(t,n),e.pathSeparator)+e.pathSeparator+r}}function Ake(t){return t}function Tke(t,e,r){return e+t+r}function Oke(t,e){let{relativePaths:r,includeBasePath:n}=e;return r&&t?Eke(t,e):n?j3:Ake}function Rke(t){return function(e,r){r.push(e.substring(t.length)||".")}}function Ike(t){return function(e,r,n){let i=e.substring(t.length)||".";n.every(o=>o(i,!0))&&r.push(i)}}function Nke(t,e){let{includeDirs:r,filters:n,relativePaths:i}=e;return r?i?n&&n.length?Ike(t):Rke(t):n&&n.length?Cke:Pke:Dke}function Uke(t){let{excludeFiles:e,filters:r,onlyCounts:n}=t;return e?zke:r&&r.length?n?jke:Mke:n?Fke:Lke}function Hke(t){return t.group?Bke:qke}function Vke(t){return t.group?Gke:Zke}function Jke(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?Kke:Wke}function M3(t,e,r){if(r.options.useRealPaths)return Yke(e,r);let n=ZI(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=ZI(n)}return r.symlinks.set(t,e),i>1}function Yke(t,e){return e.visited.includes(t+e.options.pathSeparator)}function cv(t,e,r,n){e(t&&!n?t:null,r)}function sEe(t,e){let{onlyCounts:r,group:n,maxFiles:i}=t;return r?e?Xke:rEe:n?e?Qke:oEe:i?e?tEe:iEe:e?eEe:nEe}function lEe(t){return t?cEe:aEe}function pEe(t,e){return new Promise((r,n)=>{z3(t,e,(i,o)=>{if(i)return n(i);r(o)})})}function z3(t,e,r){new L3(t,e,r).start()}function mEe(t,e){return new L3(t,e).start()}var P3,xke,$ke,Pke,Cke,Dke,jke,Mke,Fke,Lke,zke,qke,Bke,Gke,Zke,Wke,Kke,Xke,Qke,eEe,tEe,rEe,nEe,iEe,oEe,F3,aEe,cEe,uEe,dEe,fEe,L3,C3,U3,q3,B3=y(()=>{P3=gke(import.meta.url);xke=/[\\/]/g;$ke=/^[a-z]:[\\/]$/i;Pke=(t,e)=>{e.push(t||".")},Cke=(t,e,r)=>{let n=t||".";r.every(i=>i(n,!0))&&e.push(n)},Dke=()=>{};jke=(t,e,r,n)=>{n.every(i=>i(t,!1))&&r.files++},Mke=(t,e,r,n)=>{n.every(i=>i(t,!1))&&e.push(t)},Fke=(t,e,r,n)=>{r.files++},Lke=(t,e)=>{e.push(t)},zke=()=>{};qke=t=>t,Bke=()=>[""].slice(0,0);Gke=(t,e,r)=>{t.push({directory:e,files:r,dir:e})},Zke=()=>{};Wke=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()&&M3(t,a,e))return n.dequeue(null,e);r(l,a),n.dequeue(null,e)})})},Kke=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()&&M3(t,s,e))return;r(a,s)}catch(s){if(!o)throw s}};Xke=t=>t.counts,Qke=t=>t.groups,eEe=t=>t.paths,tEe=t=>t.paths.slice(0,t.options.maxFiles),rEe=(t,e,r)=>(cv(e,r,t.counts,t.options.suppressErrors),null),nEe=(t,e,r)=>(cv(e,r,t.paths,t.options.suppressErrors),null),iEe=(t,e,r)=>(cv(e,r,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),oEe=(t,e,r)=>(cv(e,r,t.groups,t.options.suppressErrors),null);F3={withFileTypes:!0},aEe=(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||".",F3,(s,a=[])=>{i(a,r,n),t.queue.dequeue(t.options.suppressErrors?null:s,t)})},cEe=(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||".",F3)}catch(a){if(!t.options.suppressErrors)throw a}i(s,r,n)};uEe=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))}},dEe=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}},fEe=class{aborted=!1;abort(){this.aborted=!0}},L3=class{root;isSynchronous;state;joinPath;pushDirectory;pushFile;getArray;groupFiles;resolveSymlink;walkDirectory;callbackInvoker;constructor(t,e,r){this.isSynchronous=!r,this.callbackInvoker=sEe(e,this.isSynchronous),this.root=GI(t,e),this.state={root:kke(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new dEe,options:e,queue:new uEe((n,i)=>this.callbackInvoker(i,n,r)),symlinks:new Map,visited:[""].slice(0,0),controller:new fEe,fs:e.fs||Ske},this.joinPath=Oke(this.root,e),this.pushDirectory=Nke(this.root,e),this.pushFile=Uke(e),this.getArray=Hke(e),this.groupFiles=Vke(e),this.resolveSymlink=Jke(e,this.isSynchronous),this.walkDirectory=lEe(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(_=GI(_,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=yke(_),x=GI(ZI(_),this.state.options);_=this.joinPath(S,x),this.pushFile(_,p,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,p)}};C3=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return pEe(this.root,this.options)}withCallback(t){z3(this.root,this.options,t)}sync(){return mEe(this.root,this.options)}},U3=null;try{P3.resolve("picomatch"),U3=P3("picomatch")}catch{}q3=class{globCache={};options={maxDepth:1/0,suppressErrors:!0,pathSeparator:D3,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 C3(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options={...this.options,...e},new C3(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let r=this.globFunction||U3;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 Kf=v((Wct,W3)=>{"use strict";var H3="[^\\\\/]",hEe="(?=.)",G3="[^/]",VI="(?:\\/|$)",Z3="(?:^|\\/)",WI=`\\.{1,2}${VI}`,gEe="(?!\\.)",yEe=`(?!${Z3}${WI})`,_Ee=`(?!\\.{0,1}${VI})`,bEe=`(?!${WI})`,vEe="[^.\\/]",SEe=`${G3}*?`,wEe="/",V3={DOT_LITERAL:"\\.",PLUS_LITERAL:"\\+",QMARK_LITERAL:"\\?",SLASH_LITERAL:"\\/",ONE_CHAR:hEe,QMARK:G3,END_ANCHOR:VI,DOTS_SLASH:WI,NO_DOT:gEe,NO_DOTS:yEe,NO_DOT_SLASH:_Ee,NO_DOTS_SLASH:bEe,QMARK_NO_DOT:vEe,STAR:SEe,START_ANCHOR:Z3,SEP:wEe},xEe={...V3,SLASH_LITERAL:"[\\\\/]",QMARK:H3,STAR:`${H3}*?`,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:"\\"},$Ee={__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"};W3.exports={DEFAULT_MAX_EXTGLOB_RECURSION:0,MAX_LENGTH:1024*64,POSIX_REGEX_SOURCE:$Ee,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?xEe:V3}}});var Jf=v(Mr=>{"use strict";var{REGEX_BACKSLASH:kEe,REGEX_REMOVE_BACKSLASH:EEe,REGEX_SPECIAL_CHARS:AEe,REGEX_SPECIAL_CHARS_GLOBAL:TEe}=Kf();Mr.isObject=t=>t!==null&&typeof t=="object"&&!Array.isArray(t);Mr.hasRegexChars=t=>AEe.test(t);Mr.isRegexChar=t=>t.length===1&&Mr.hasRegexChars(t);Mr.escapeRegex=t=>t.replace(TEe,"\\$1");Mr.toPosixSlashes=t=>t.replace(kEe,"/");Mr.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};Mr.removeBackslashes=t=>t.replace(EEe,e=>e==="\\"?"":e);Mr.escapeLast=(t,e,r)=>{let n=t.lastIndexOf(e,r);return n===-1?t:t[n-1]==="\\"?Mr.escapeLast(t,e,n-1):`${t.slice(0,n)}\\${t.slice(n)}`};Mr.removePrefix=(t,e={})=>{let r=t;return r.startsWith("./")&&(r=r.slice(2),e.prefix="./"),r};Mr.wrapOutput=(t,e={},r={})=>{let n=r.contains?"":"^",i=r.contains?"":"$",o=`${n}(?:${t})${i}`;return e.negated===!0&&(o=`(?:^(?!${o}).*$)`),o};Mr.basename=(t,{windows:e}={})=>{let r=t.split(e?/[\\/]/:"/"),n=r[r.length-1];return n===""?r[r.length-2]:n}});var rJ=v((Jct,tJ)=>{"use strict";var K3=Jf(),{CHAR_ASTERISK:KI,CHAR_AT:OEe,CHAR_BACKWARD_SLASH:Yf,CHAR_COMMA:REe,CHAR_DOT:JI,CHAR_EXCLAMATION_MARK:YI,CHAR_FORWARD_SLASH:eJ,CHAR_LEFT_CURLY_BRACE:XI,CHAR_LEFT_PARENTHESES:QI,CHAR_LEFT_SQUARE_BRACKET:IEe,CHAR_PLUS:PEe,CHAR_QUESTION_MARK:J3,CHAR_RIGHT_CURLY_BRACE:CEe,CHAR_RIGHT_PARENTHESES:Y3,CHAR_RIGHT_SQUARE_BRACKET:DEe}=Kf(),X3=t=>t===eJ||t===Yf,Q3=t=>{t.isPrefix!==!0&&(t.depth=t.isGlobstar?1/0:1)},NEe=(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,A,E,C={value:"",depth:0,isGlob:!1},k=()=>l>=n,q=()=>c.charCodeAt(l+1),X=()=>(A=E,c.charCodeAt(++l));for(;l0&&(I=c.slice(0,u),c=c.slice(u),d-=u),Se&&m===!0&&d>0?(Se=c.slice(0,d),P=c.slice(d)):m===!0?(Se="",P=c):Se=c,Se&&Se!==""&&Se!=="/"&&Se!==c&&X3(Se.charCodeAt(Se.length-1))&&(Se=Se.slice(0,-1)),r.unescape===!0&&(P&&(P=K3.removeBackslashes(P)),Se&&_===!0&&(Se=K3.removeBackslashes(Se)));let Rr={prefix:I,input:t,start:u,base:Se,glob:P,isBrace:f,isBracket:p,isGlob:m,isExtglob:h,isGlobstar:g,negated:S,negatedExtglob:x};if(r.tokens===!0&&(Rr.maxDepth=0,X3(E)||s.push(C),Rr.tokens=s),r.parts===!0||r.tokens===!0){let se;for(let Pe=0;Pe{"use strict";var Xf=Kf(),nn=Jf(),{MAX_LENGTH:lv,POSIX_REGEX_SOURCE:jEe,REGEX_NON_SPECIAL_CHARS:MEe,REGEX_SPECIAL_CHARS_BACKREF:FEe,REPLACEMENTS:nJ}=Xf,LEe=(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=>nn.escapeRegex(i)).join("..")}return r},$l=(t,e)=>`Missing ${t}: "${e}" - use "\\\\${e}" to match literal characters`,iJ=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},zEe=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},oJ=t=>{let e=t.trim(),r=!0;for(;r===!0;)r=!1,/^@\([^\\()[\]{}|]+\)$/.test(e)&&(e=e.slice(2,-1),r=!0);if(zEe(e))return e.replace(/\\(.)/g,"$1")},UEe=t=>{let e=t.map(oJ).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}}}}},qEe=t=>{let e=0,r=[];for(;ea.trim());if(o.length!==1)return;let s=oJ(o[0]);if(!s||s.length!==1)return;r.push(s),e+=i.end+1}return r.length<1?void 0:`${r.length===1?nn.escapeRegex(r[0]):`[${r.map(i=>nn.escapeRegex(i)).join("")}]`}*`},BEe=t=>{let e=0,r=t.trim(),n=eP(r);for(;n;)e++,r=n.body.trim(),n=eP(r);return e},HEe=(t,e)=>{if(e.maxExtglobRecursion===!1)return{risky:!1};let r=typeof e.maxExtglobRecursion=="number"?e.maxExtglobRecursion:Xf.DEFAULT_MAX_EXTGLOB_RECURSION,n=iJ(t).map(i=>i.trim());if(n.length>1&&(n.some(i=>i==="")||n.some(i=>/^[*?]+$/.test(i))||UEe(n)))return{risky:!0};for(let i of n){let o=qEe(i);if(o)return{risky:!0,safeOutput:o};if(BEe(i)>r)return{risky:!0}}return{risky:!1}},tP=(t,e)=>{if(typeof t!="string")throw new TypeError("Expected a string");t=nJ[t]||t;let r={...e},n=typeof r.maxLength=="number"?Math.min(lv,r.maxLength):lv,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=Xf.globChars(r.windows),l=Xf.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=B=>`(${a}(?:(?!${w}${B.dot?m:u}).)*?)`,A=r.dot?"":h,E=r.dot?_:S,C=r.bash===!0?O(r):x;r.capture&&(C=`(${C})`),typeof r.noext=="boolean"&&(r.noextglob=r.noext);let k={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=nn.removePrefix(t,k),i=t.length;let q=[],X=[],Se=[],I=o,P,Rr=()=>k.index===i-1,se=k.peek=(B=1)=>t[k.index+B],Pe=k.advance=()=>t[++k.index]||"",Vt=()=>t.slice(k.index+1),ar=(B="",ft=0)=>{k.consumed+=B,k.index+=ft},Kt=B=>{k.output+=B.output!=null?B.output:B.value,ar(B.value)},to=()=>{let B=1;for(;se()==="!"&&(se(2)!=="("||se(3)==="?");)Pe(),k.start++,B++;return B%2===0?!1:(k.negated=!0,k.start++,!0)},yi=B=>{k[B]++,Se.push(B)},Jr=B=>{k[B]--,Se.pop()},de=B=>{if(I.type==="globstar"){let ft=k.braces>0&&(B.type==="comma"||B.type==="brace"),U=B.extglob===!0||q.length&&(B.type==="pipe"||B.type==="paren");B.type!=="slash"&&B.type!=="paren"&&!ft&&!U&&(k.output=k.output.slice(0,-I.output.length),I.type="star",I.value="*",I.output=C,k.output+=I.output)}if(q.length&&B.type!=="paren"&&(q[q.length-1].inner+=B.value),(B.value||B.output)&&Kt(B),I&&I.type==="text"&&B.type==="text"){I.output=(I.output||I.value)+B.value,I.value+=B.value;return}B.prev=I,s.push(B),I=B},ro=(B,ft)=>{let U={...l[ft],conditions:1,inner:""};U.prev=I,U.parens=k.parens,U.output=k.output,U.startIndex=k.index,U.tokensIndex=s.length;let Te=(r.capture?"(":"")+U.open;yi("parens"),de({type:B,value:ft,output:k.output?"":p}),de({type:"paren",extglob:!0,value:Pe(),output:Te}),q.push(U)},xue=B=>{let ft=t.slice(B.startIndex,k.index+1),U=t.slice(B.startIndex+2,k.index),Te=HEe(U,r);if((B.type==="plus"||B.type==="star")&&Te.risky){let ct=Te.safeOutput?(B.output?"":p)+(r.capture?`(${Te.safeOutput})`:Te.safeOutput):void 0,_i=s[B.tokensIndex];_i.type="text",_i.value=ft,_i.output=ct||nn.escapeRegex(ft);for(let bi=B.tokensIndex+1;bi1&&B.inner.includes("/")&&(ct=O(r)),(ct!==C||Rr()||/^\)+$/.test(Vt()))&&(lt=B.close=`)$))${ct}`),B.inner.includes("*")&&(jt=Vt())&&/^\.[^\\/.]+$/.test(jt)){let _i=tP(jt,{...e,fastpaths:!1}).output;lt=B.close=`)${_i})${ct})`}B.prev.type==="bos"&&(k.negatedExtglob=!0)}de({type:"paren",extglob:!0,value:P,output:lt}),Jr("parens")};if(r.fastpaths!==!1&&!/(^[*!]|[/()[\]{}"])/.test(t)){let B=!1,ft=t.replace(FEe,(U,Te,lt,jt,ct,_i)=>jt==="\\"?(B=!0,U):jt==="?"?Te?Te+jt+(ct?_.repeat(ct.length):""):_i===0?E+(ct?_.repeat(ct.length):""):_.repeat(lt.length):jt==="."?u.repeat(lt.length):jt==="*"?Te?Te+jt+(ct?C:""):C:Te?U:`\\${U}`);return B===!0&&(r.unescape===!0?ft=ft.replace(/\\/g,""):ft=ft.replace(/\\+/g,U=>U.length%2===0?"\\\\":U?"\\":"")),ft===t&&r.contains===!0?(k.output=t,k):(k.output=nn.wrapOutput(ft,k,e),k)}for(;!Rr();){if(P=Pe(),P==="\0")continue;if(P==="\\"){let U=se();if(U==="/"&&r.bash!==!0||U==="."||U===";")continue;if(!U){P+="\\",de({type:"text",value:P});continue}let Te=/^\\+/.exec(Vt()),lt=0;if(Te&&Te[0].length>2&&(lt=Te[0].length,k.index+=lt,lt%2!==0&&(P+="\\")),r.unescape===!0?P=Pe():P+=Pe(),k.brackets===0){de({type:"text",value:P});continue}}if(k.brackets>0&&(P!=="]"||I.value==="["||I.value==="[^")){if(r.posix!==!1&&P===":"){let U=I.value.slice(1);if(U.includes("[")&&(I.posix=!0,U.includes(":"))){let Te=I.value.lastIndexOf("["),lt=I.value.slice(0,Te),jt=I.value.slice(Te+2),ct=jEe[jt];if(ct){I.value=lt+ct,k.backtrack=!0,Pe(),!o.output&&s.indexOf(I)===1&&(o.output=p);continue}}}(P==="["&&se()!==":"||P==="-"&&se()==="]")&&(P=`\\${P}`),P==="]"&&(I.value==="["||I.value==="[^")&&(P=`\\${P}`),r.posix===!0&&P==="!"&&I.value==="["&&(P="^"),I.value+=P,Kt({value:P});continue}if(k.quotes===1&&P!=='"'){P=nn.escapeRegex(P),I.value+=P,Kt({value:P});continue}if(P==='"'){k.quotes=k.quotes===1?0:1,r.keepQuotes===!0&&de({type:"text",value:P});continue}if(P==="("){yi("parens"),de({type:"paren",value:P});continue}if(P===")"){if(k.parens===0&&r.strictBrackets===!0)throw new SyntaxError($l("opening","("));let U=q[q.length-1];if(U&&k.parens===U.parens+1){xue(q.pop());continue}de({type:"paren",value:P,output:k.parens?")":"\\)"}),Jr("parens");continue}if(P==="["){if(r.nobracket===!0||!Vt().includes("]")){if(r.nobracket!==!0&&r.strictBrackets===!0)throw new SyntaxError($l("closing","]"));P=`\\${P}`}else yi("brackets");de({type:"bracket",value:P});continue}if(P==="]"){if(r.nobracket===!0||I&&I.type==="bracket"&&I.value.length===1){de({type:"text",value:P,output:`\\${P}`});continue}if(k.brackets===0){if(r.strictBrackets===!0)throw new SyntaxError($l("opening","["));de({type:"text",value:P,output:`\\${P}`});continue}Jr("brackets");let U=I.value.slice(1);if(I.posix!==!0&&U[0]==="^"&&!U.includes("/")&&(P=`/${P}`),I.value+=P,Kt({value:P}),r.literalBrackets===!1||nn.hasRegexChars(U))continue;let Te=nn.escapeRegex(I.value);if(k.output=k.output.slice(0,-I.value.length),r.literalBrackets===!0){k.output+=Te,I.value=Te;continue}I.value=`(${a}${Te}|${I.value})`,k.output+=I.value;continue}if(P==="{"&&r.nobrace!==!0){yi("braces");let U={type:"brace",value:P,output:"(",outputIndex:k.output.length,tokensIndex:k.tokens.length};X.push(U),de(U);continue}if(P==="}"){let U=X[X.length-1];if(r.nobrace===!0||!U){de({type:"text",value:P,output:P});continue}let Te=")";if(U.dots===!0){let lt=s.slice(),jt=[];for(let ct=lt.length-1;ct>=0&&(s.pop(),lt[ct].type!=="brace");ct--)lt[ct].type!=="dots"&&jt.unshift(lt[ct].value);Te=LEe(jt,r),k.backtrack=!0}if(U.comma!==!0&&U.dots!==!0){let lt=k.output.slice(0,U.outputIndex),jt=k.tokens.slice(U.tokensIndex);U.value=U.output="\\{",P=Te="\\}",k.output=lt;for(let ct of jt)k.output+=ct.output||ct.value}de({type:"brace",value:P,output:Te}),Jr("braces"),X.pop();continue}if(P==="|"){q.length>0&&q[q.length-1].conditions++,de({type:"text",value:P});continue}if(P===","){let U=P,Te=X[X.length-1];Te&&Se[Se.length-1]==="braces"&&(Te.comma=!0,U="|"),de({type:"comma",value:P,output:U});continue}if(P==="/"){if(I.type==="dot"&&k.index===k.start+1){k.start=k.index+1,k.consumed="",k.output="",s.pop(),I=o;continue}de({type:"slash",value:P,output:f});continue}if(P==="."){if(k.braces>0&&I.type==="dot"){I.value==="."&&(I.output=u);let U=X[X.length-1];I.type="dots",I.output+=P,I.value+=P,U.dots=!0;continue}if(k.braces+k.parens===0&&I.type!=="bos"&&I.type!=="slash"){de({type:"text",value:P,output:u});continue}de({type:"dot",value:P,output:u});continue}if(P==="?"){if(!(I&&I.value==="(")&&r.noextglob!==!0&&se()==="("&&se(2)!=="?"){ro("qmark",P);continue}if(I&&I.type==="paren"){let Te=se(),lt=P;(I.value==="("&&!/[!=<:]/.test(Te)||Te==="<"&&!/<([!=]|\w+>)/.test(Vt()))&&(lt=`\\${P}`),de({type:"text",value:P,output:lt});continue}if(r.dot!==!0&&(I.type==="slash"||I.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)))){ro("negate",P);continue}if(r.nonegate!==!0&&k.index===0){to();continue}}if(P==="+"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){ro("plus",P);continue}if(I&&I.value==="("||r.regex===!1){de({type:"plus",value:P,output:d});continue}if(I&&(I.type==="bracket"||I.type==="paren"||I.type==="brace")||k.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 U=MEe.exec(Vt());U&&(P+=U[0],k.index+=U[0].length),de({type:"text",value:P});continue}if(I&&(I.type==="globstar"||I.star===!0)){I.type="star",I.star=!0,I.value+=P,I.output=C,k.backtrack=!0,k.globstar=!0,ar(P);continue}let B=Vt();if(r.noextglob!==!0&&/^\([^?]/.test(B)){ro("star",P);continue}if(I.type==="star"){if(r.noglobstar===!0){ar(P);continue}let U=I.prev,Te=U.prev,lt=U.type==="slash"||U.type==="bos",jt=Te&&(Te.type==="star"||Te.type==="globstar");if(r.bash===!0&&(!lt||B[0]&&B[0]!=="/")){de({type:"star",value:P,output:""});continue}let ct=k.braces>0&&(U.type==="comma"||U.type==="brace"),_i=q.length&&(U.type==="pipe"||U.type==="paren");if(!lt&&U.type!=="paren"&&!ct&&!_i){de({type:"star",value:P,output:""});continue}for(;B.slice(0,3)==="/**";){let bi=t[k.index+4];if(bi&&bi!=="/")break;B=B.slice(3),ar("/**",3)}if(U.type==="bos"&&Rr()){I.type="globstar",I.value+=P,I.output=O(r),k.output=I.output,k.globstar=!0,ar(P);continue}if(U.type==="slash"&&U.prev.type!=="bos"&&!jt&&Rr()){k.output=k.output.slice(0,-(U.output+I.output).length),U.output=`(?:${U.output}`,I.type="globstar",I.output=O(r)+(r.strictSlashes?")":"|$)"),I.value+=P,k.globstar=!0,k.output+=U.output+I.output,ar(P);continue}if(U.type==="slash"&&U.prev.type!=="bos"&&B[0]==="/"){let bi=B[1]!==void 0?"|$":"";k.output=k.output.slice(0,-(U.output+I.output).length),U.output=`(?:${U.output}`,I.type="globstar",I.output=`${O(r)}${f}|${f}${bi})`,I.value+=P,k.output+=U.output+I.output,k.globstar=!0,ar(P+Pe()),de({type:"slash",value:"/",output:""});continue}if(U.type==="bos"&&B[0]==="/"){I.type="globstar",I.value+=P,I.output=`(?:^|${f}|${O(r)}${f})`,k.output=I.output,k.globstar=!0,ar(P+Pe()),de({type:"slash",value:"/",output:""});continue}k.output=k.output.slice(0,-I.output.length),I.type="globstar",I.output=O(r),I.value+=P,k.output+=I.output,k.globstar=!0,ar(P);continue}let ft={type:"star",value:P,output:C};if(r.bash===!0){ft.output=".*?",(I.type==="bos"||I.type==="slash")&&(ft.output=A+ft.output),de(ft);continue}if(I&&(I.type==="bracket"||I.type==="paren")&&r.regex===!0){ft.output=P,de(ft);continue}(k.index===k.start||I.type==="slash"||I.type==="dot")&&(I.type==="dot"?(k.output+=g,I.output+=g):r.dot===!0?(k.output+=b,I.output+=b):(k.output+=A,I.output+=A),se()!=="*"&&(k.output+=p,I.output+=p)),de(ft)}for(;k.brackets>0;){if(r.strictBrackets===!0)throw new SyntaxError($l("closing","]"));k.output=nn.escapeLast(k.output,"["),Jr("brackets")}for(;k.parens>0;){if(r.strictBrackets===!0)throw new SyntaxError($l("closing",")"));k.output=nn.escapeLast(k.output,"("),Jr("parens")}for(;k.braces>0;){if(r.strictBrackets===!0)throw new SyntaxError($l("closing","}"));k.output=nn.escapeLast(k.output,"{"),Jr("braces")}if(r.strictSlashes!==!0&&(I.type==="star"||I.type==="bracket")&&de({type:"maybe_slash",value:"",output:`${f}?`}),k.backtrack===!0){k.output="";for(let B of k.tokens)k.output+=B.output!=null?B.output:B.value,B.suffix&&(k.output+=B.suffix)}return k};tP.fastpaths=(t,e)=>{let r={...e},n=typeof r.maxLength=="number"?Math.min(lv,r.maxLength):lv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);t=nJ[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}=Xf.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=A=>A.noglobstar===!0?_:`(${g}(?:(?!${p}${A.dot?c:o}).)*?)`,x=A=>{switch(A){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 E=/^(.*?)\.(\w+)$/.exec(A);if(!E)return;let C=x(E[1]);return C?C+o+E[2]:void 0}}},w=nn.removePrefix(t,b),O=x(w);return O&&r.strictSlashes!==!0&&(O+=`${s}?`),O};sJ.exports=tP});var uJ=v((Xct,lJ)=>{"use strict";var GEe=rJ(),rP=aJ(),cJ=Jf(),ZEe=Kf(),VEe=t=>t&&typeof t=="object"&&!Array.isArray(t),Tt=(t,e,r=!1)=>{if(Array.isArray(t)){let u=t.map(f=>Tt(f,e,r));return f=>{for(let p of u){let m=p(f);if(m)return m}return!1}}let n=VEe(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?Tt.compileRe(t,e):Tt.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=Tt(i.ignore,u,r)}let l=(u,d=!1)=>{let{isMatch:f,match:p,output:m}=Tt.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};Tt.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?cJ.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=Tt.matchBase(t,e,r,i):a=e.exec(c)),{isMatch:!!a,match:a,output:c}};Tt.matchBase=(t,e,r)=>(e instanceof RegExp?e:Tt.makeRe(e,r)).test(cJ.basename(t));Tt.isMatch=(t,e,r)=>Tt(e,r)(t);Tt.parse=(t,e)=>Array.isArray(t)?t.map(r=>Tt.parse(r,e)):rP(t,{...e,fastpaths:!1});Tt.scan=(t,e)=>GEe(t,e);Tt.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=Tt.toRegex(a,e);return n===!0&&(c.state=t),c};Tt.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=rP.fastpaths(t,e)),i.output||(i=rP(t,e)),Tt.compileRe(i,e,r,n)};Tt.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/$^/}};Tt.constants=ZEe;lJ.exports=Tt});var mJ=v((Qct,pJ)=>{"use strict";var dJ=uJ(),WEe=Jf();function fJ(t,e,r=!1){return e&&(e.windows===null||e.windows===void 0)&&(e={...e,windows:WEe.isWindows()}),dJ(t,e,r)}Object.assign(fJ,dJ);pJ.exports=fJ});import{readdir as KEe,readdirSync as JEe,realpath as YEe,realpathSync as XEe,stat as QEe,statSync as eAe}from"fs";import{isAbsolute as tAe,posix as Na,resolve as rAe}from"path";import{fileURLToPath as nAe}from"url";function sAe(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]===".."&&oAe.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=>Na.relative(t,n)||".":n=>Na.relative(t,`${e}/${n}`)||"."}function lAe(t,e){if(e.startsWith(`${t}/`)){let r=e.slice(t.length+1);return n=>`${r}/${n}`}return r=>{let n=Na.relative(t,`${e}/${r}`);return r[r.length-1]==="/"&&n!==""?`${n}/`:n||"."}}function _J(t){var e;let r=kl.default.scan(t,uAe);return!((e=r.parts)===null||e===void 0)&&e.length?r.parts:[t]}function gAe(t,e){if(e?.caseSensitiveMatch===!1)return!0;let r=kl.default.scan(t);return r.isGlob||r.negated}function Qf(...t){console.log(`[tinyglobby ${new Date().toLocaleTimeString("es")}]`,...t)}function bJ(t){return typeof t=="string"?[t]:t??[]}function nP(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=hAe(o);s=tAe(s.replace(_Ae,""))?Na.relative(a,s):Na.normalize(s);let c=(i=yAe.exec(s))===null||i===void 0?void 0:i[0],l=_J(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?Na.join(o,...d):o}return s}function bAe(t,e,r){let n=[],i=[];for(let o of t.ignore)o&&(o[0]!=="!"||o[1]==="(")&&i.push(nP(o,t,r,!0));for(let o of e)o&&(o[0]!=="!"||o[1]==="("?n.push(nP(o,t,r,!1)):(o[1]!=="!"||o[2]==="(")&&i.push(nP(o.slice(1),t,r,!0)));return{match:n,ignore:i}}function vAe(t,e){let r=t.cwd,n={root:r,depthOffset:0},i=bAe(t,e,n);t.debug&&Qf("internal processing patterns:",i);let{absolute:o,caseSensitiveMatch:s,debug:a,dot:c,followSymbolicLinks:l,onlyDirectories:u}=t,d=n.root.replace(gJ,""),f={dot:c,nobrace:t.braceExpansion===!1,nocase:!s,noextglob:t.extglob===!1,noglobstar:t.globstar===!1,posix:!0},p=(0,kl.default)(i.match,f),m=(0,kl.default)(i.ignore,f),h=sAe(i.match,f),g=hJ(r,d,o),b=o?g:hJ(r,d,!0),_=(w,O)=>{let A=b(O,!0);return A!=="."&&!h(A)||m(A)},S;t.deep!==void 0&&(S=Math.round(t.deep-n.depthOffset));let x=new q3({filters:[a?(w,O)=>{let A=g(w,O),E=p(A)&&!m(A);return E&&Qf(`matched ${A}`),E}:(w,O)=>{let A=g(w,O);return p(A)&&!m(A)}],exclude:a?(w,O)=>{let A=_(w,O);return Qf(`${A?"skipped":"crawling"} ${O}`),A}:_,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&&Qf("internal properties:",{...n,root:d}),[x,r!==d&&!o&&lAe(r,d)]}function SAe(t,e){if(e)for(let r=t.length-1;r>=0;r--)t[r]=e(t[r]);return t}function xAe(t){let e={...wAe,...t};return e.cwd=(e.cwd instanceof URL?nAe(e.cwd):rAe(e.cwd)).replace(gJ,"/"),e.ignore=bJ(e.ignore),e.fs&&(e.fs={readdir:e.fs.readdir||KEe,readdirSync:e.fs.readdirSync||JEe,realpath:e.fs.realpath||YEe,realpathSync:e.fs.realpathSync||XEe,stat:e.fs.stat||QEe,statSync:e.fs.statSync||eAe}),e.debug&&Qf("globbing with options:",e),e}function $Ae(t,e={}){var r;if(t&&e?.patterns)throw new Error("Cannot pass patterns as both an argument and an option");let n=iAe(t)||typeof t=="string",i=bJ((r=n?t:t.patterns)!==null&&r!==void 0?r:"**/*"),o=xAe(n?e:t);return i.length>0?vAe(o,i):[]}function cs(t,e){let[r,n]=$Ae(t,e);return r?SAe(r.sync(),n):[]}var kl,iAe,gJ,yJ,oAe,aAe,cAe,uAe,dAe,fAe,pAe,mAe,hAe,yAe,_Ae,wAe,ep=y(()=>{B3();kl=Et(mJ(),1),iAe=Array.isArray,gJ=/\\/g,yJ=process.platform==="win32",oAe=/^(\/?\.\.)+$/;aAe=/^[A-Z]:\/$/i,cAe=yJ?t=>aAe.test(t):t=>t==="/";uAe={parts:!0};dAe=/(?t.replace(dAe,"\\$&"),mAe=t=>t.replace(fAe,"\\$&"),hAe=yJ?mAe:pAe;yAe=/^(\/?\.\.)+/,_Ae=/\\(?=[()[\]{}!*+?@|])/g;wAe={caseSensitiveMatch:!0,cwd:process.cwd(),debug:!!process.env.TINYGLOBBY_DEBUG,expandDirectories:!0,followSymbolicLinks:!0,onlyFiles:!0}});import{existsSync as tp,readFileSync as kAe,readdirSync as EAe,statSync as vJ}from"node:fs";import{join as ja}from"node:path";function AAe(t){let{cwd:e="."}=t,r,n;try{let c=H(e);r=c.architecture,n=c.project?.language}catch{return[]}if(!r)return[];let i=Ri(e,n),o=[],{layers:s,forbiddenImports:a}=iP(r);return(s.size>0||a.length>0)&&!tp(ja(e,i.mainRoot))?[{detector:rp,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&&(TAe(e,i,s,o),OAe(e,i,s,o)),a.length>0&&RAe(e,i,a,o),o)}function iP(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 TAe(t,e,r,n){let i=e.mainRoot,o=ja(t,i);if(tp(o))for(let s of EAe(o)){let a=ja(o,s);vJ(a).isDirectory()&&(r.has(s)||n.push({detector:rp,severity:"warn",path:`${i}/${s}/`,message:`${i}/${s}/ is not declared in spec/architecture.yaml layers \u2014 add it or remove the directory`}))}}function OAe(t,e,r,n){let i=e.mainRoot,o=ja(t,i);if(tp(o))for(let s of r){let a=ja(o,s);tp(a)&&vJ(a).isDirectory()||n.push({detector:rp,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 RAe(t,e,r,n){let i=e.mainRoot,o=e.importMatcher;for(let s of r){let a=ja(t,i,s.from);if(!tp(a))continue;let c=cs([`**/*.${e.ext}`],{cwd:a,dot:!1});for(let l of c){let u=ja(a,l),d;try{d=kAe(u,"utf8")}catch{continue}let f;for(o.lastIndex=0;(f=o.exec(d))!==null;){let p=f[1];IAe(p,s.to,e.importStyle)&&n.push({detector:rp,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 IAe(t,e,r){return r==="dotted"?t.split(".").includes(e):t.startsWith(".")?t.split("/").includes(e):!1}var rp,SJ,oP=y(()=>{"use strict";ep();qe();Da();rp="ARCHITECTURE_FROM_SPEC";SJ={name:rp,run:AAe}});import{existsSync as PAe,readFileSync as CAe}from"node:fs";import{join as DAe}from"node:path";function NAe(t){let{cwd:e="."}=t,r=DAe(e,"spec/capabilities.yaml");if(!PAe(r))return[];let n;try{let c=CAe(r,"utf8"),l=wJ.default.parse(c);if(!l||typeof l!="object")return[];n=l}catch{return[]}let i=n.capabilities??[];if(i.length===0)return[];let o;try{let c=H(e);o=new Set(c.features.map(l=>l.id))}catch{return[]}let s=[],a=new Set;for(let c of i){if(typeof c!="object"||c===null)continue;let l=String(c.id??"(unnamed)"),u=Array.isArray(c.features)?c.features:[];if(u.length===0){s.push({detector:uv,severity:"warn",path:"spec/capabilities.yaml",message:`capability "${l}" has no features mapped \u2014 bind at least one feature via the features[] field, or remove the capability if it's no longer relevant`});continue}for(let d of u){let f=String(d);o.has(f)?a.add(f):s.push({detector:uv,severity:"error",path:"spec/capabilities.yaml",message:`capability "${l}" references feature ${f} which does not exist in spec.yaml \u2014 either add the feature or remove it from this capability's features[]`})}}for(let c of o)a.has(c)||s.push({detector:uv,severity:"info",path:"spec.yaml",message:`feature ${c} is not claimed by any capability \u2014 if it's user-facing, consider adding it to a capability's features[] in spec/capabilities.yaml`});return s}var wJ,uv,xJ,$J=y(()=>{"use strict";wJ=Et(cr(),1);qe();uv="CAPABILITIES_FEATURE_MAPPING";xJ={name:uv,run:NAe}});import{existsSync as jAe,readFileSync as MAe}from"node:fs";import{join as FAe}from"node:path";function LAe(t){let e=t.trimStart();return e.startsWith("//")||e.startsWith("/*")}function zAe(t){let{cwd:e="."}=t;return he(e,sP,r=>UAe(r,e))}function UAe(t,e){let r=Ri(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=FAe(e,o);if(!jAe(s))continue;let a=MAe(s,"utf8");LAe(a)||n.push({detector:sP,severity:"warn",path:o,message:`${o} has no file-header comment \u2014 Why>What guardrail recommends a one-line intent`})}return n}var sP,kJ,EJ=y(()=>{"use strict";Da();bt();sP="CONVENTION_DRIFT";kJ={name:sP,run:zAe}});import{existsSync as aP,readFileSync as AJ}from"node:fs";import{join as dv}from"node:path";function qAe(t){return JSON.parse(t).total?.lines?.pct??0}function TJ(t){let e=/]*\bline-rate="([0-9]*\.?[0-9]+)"/.exec(t);return e?Number(e[1])*100:null}function GAe(t,e){if(!Vb(ht(t).gates.coverage?.cmd))return null;let r;try{r=Wb(t,e)}catch(c){return[{detector:go,severity:"error",message:c.message}]}let n=0,i=0,o=0,s=[];for(let c of r){let l=LI.find(d=>aP(dv(c.dir,d)));if(!l){s.push(c.path);continue}let u=TJ(AJ(dv(c.dir,l),"utf8"));u&&(n+=u.missed,i+=u.covered,o++)}if(o===0)return[{detector:go,severity:"info",message:`no module coverage report present for ${r.map(c=>c.path).join(", ")} \u2014 run stage_2.2 first`}];let a=OJ(n,i);return a0?[{detector:go,severity:"info",message:`module coverage ${a.toFixed(1)}% OK; no report yet for ${s.join(", ")}`}]:[]}function ZAe(t){let{cwd:e="."}=t;if(t.focusModules&&t.focusModules.length>0){let a=GAe(e,t.focusModules);if(a)return a}let r;try{r=H(e).project?.language}catch{}let n=Ri(e,r),i=ht(e).language==="kotlin"?LI.find(a=>aP(dv(e,a)))??d3(e):n.coverageSummary,o=dv(e,i);if(!aP(o))return[{detector:go,severity:"info",message:`${i} not present \u2014 run stage_2.2 first`}];let s;try{let a=AJ(o,"utf8");s=n.coverageFormat==="jacoco-xml"?BAe(a):n.coverageFormat==="cobertura-xml"?HAe(a):qAe(a)}catch(a){return[{detector:go,severity:"warn",message:`${i} unparseable: ${a.message}`}]}return s===null?n.coverageFormat==="cobertura-xml"?[]:[{detector:go,severity:"warn",message:`${i} contained no line-coverage counter`}]:s>=fv?[]:[{detector:go,severity:"warn",message:`line coverage ${s.toFixed(1)}% < floor ${fv}%`}]}var go,fv,RJ,IJ=y(()=>{"use strict";qe();Xb();Da();Kb();En();go="COVERAGE_DROP",fv=70;RJ={name:go,run:ZAe}});import{existsSync as VAe}from"node:fs";import{join as WAe}from"node:path";function KAe(t){let{cwd:e="."}=t;return he(e,pv,r=>JAe(r,e))}function JAe(t,e){let r=t.project.deliverable,n=t.features.filter(i=>i.status==="done"&&(i.modules?.length??0)>0);return r?VAe(WAe(e,r.path))?[]:[{detector:pv,severity:"error",path:r.path,message:`project.deliverable.path '${r.path}' is declared but does not exist on disk.`}]:n.length===0?[]:[{detector:pv,severity:"warn",message:`${n.length} done feature(s) ship modules but project.deliverable is not declared \u2014 the gate cannot smoke-test the shipped entry, so a broken entry point could ship green. Declare project.deliverable {path, is_safe_to_smoke: true} to enable DELIVERABLE_SMOKE (stage_2.4).`}]}var pv,PJ,CJ=y(()=>{"use strict";bt();pv="DELIVERABLE_INTEGRITY";PJ={name:pv,run:KAe}});function YAe(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:mv,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 XAe(t){let e=YAe(t),r=(t.features??[]).filter(o=>o.status==="done");return r.length===0||!!!t.project?.deliverable||(t.project?.smoke??[]).length>0?e:[...e,{detector:mv,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 QAe(t){let{cwd:e="."}=t;return he(e,mv,r=>XAe(r))}var mv,DJ,NJ=y(()=>{"use strict";bt();mv="SMOKE_PROBE_DEMAND";DJ={name:mv,run:QAe}});function eTe(t){let{cwd:e="."}=t;return he(e,hv,r=>tTe(r,e))}function tTe(t,e){let r=(t.features??[]).filter(o=>o.status==="done"&&(o.modules??[]).length>0);if(r.length===0)return[];let n=Qo(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=p_(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,cP=y(()=>{"use strict";tl();bt();hv="STALE_ATTESTATION";gv={name:hv,run:eTe}});function rTe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}return nTe(r)}function nTe(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:jJ,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 jJ,yv,lP=y(()=>{"use strict";qe();jJ="DEPENDENCY_CYCLE";yv={name:jJ,run:rTe}});import{appendFileSync as iTe,existsSync as MJ,mkdirSync as oTe,readFileSync as sTe}from"node:fs";import{dirname as aTe,join as cTe}from"node:path";function FJ(t){return cTe(t,lTe,uTe)}function LJ(t){return uP.add(t),()=>uP.delete(t)}function Ma(t,e){let r=FJ(t),n=aTe(r);MJ(n)||oTe(n,{recursive:!0}),iTe(r,`${JSON.stringify(e)} -`,"utf8");for(let i of uP)try{i(t,e)}catch{}}function Tn(t){let e=FJ(t);if(!MJ(e))return[];let r=sTe(e,"utf8").trim();return r.length===0?[]:r.split(` -`).filter(n=>n.length>0).map(n=>JSON.parse(n))}var lTe,uTe,uP,Xn=y(()=>{"use strict";lTe=".cladding",uTe="audit.log.jsonl";uP=new Set});import{existsSync as dTe}from"node:fs";import{join as fTe}from"node:path";function pTe(t){let{cwd:e="."}=t,r=Tn(e);if(r.length===0)return[{detector:dP,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&&(dTe(fTe(e,i.artifact))||n.push({detector:dP,severity:"error",path:i.artifact,message:`evidence ${i.id} references missing artifact '${i.artifact}'`}));return n}var dP,zJ,UJ=y(()=>{"use strict";Xn();dP="EVIDENCE_MISMATCH";zJ={name:dP,run:pTe}});import{existsSync as mTe,readFileSync as hTe}from"node:fs";import{join as gTe}from"node:path";function yTe(t){let e=gTe(t,GJ);if(!mTe(e))return null;try{let n=((0,HJ.parse)(hTe(e,"utf8"))?.fixtures??[]).map(i=>i.name).filter(Boolean);return new Set(n)}catch{return null}}function*BJ(t,e){for(let r of t??[])r.startsWith(qJ)&&(yield{ref:r,name:r.slice(qJ.length),field:e})}function _Te(t){let{cwd:e="."}=t,r=yTe(e);if(r===null)return[];let n;try{n=H(e)}catch(o){return[{detector:fP,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=[...BJ(s.evidence_refs,"evidence_refs"),...BJ(s.test_refs,"test_refs")];for(let{ref:c,name:l,field:u}of a)r.has(l)||i.push({detector:fP,severity:"warn",path:GJ,message:`${o.id}.${s.id} cites '${c}' in ${u} but no fixture named '${l}' is registered in conformance/fixtures.yaml`})}return i}var HJ,fP,qJ,GJ,ZJ,VJ=y(()=>{"use strict";HJ=Et(cr(),1);qe();fP="FIXTURE_REFERENCE_INVALID",qJ="fixture:",GJ="conformance/fixtures.yaml";ZJ={name:fP,run:_Te}});import{existsSync as El,readFileSync as pP}from"node:fs";import{join as Fa}from"node:path";function bTe(t){return cs(["src/stages/detectors/*.ts"],{cwd:t,dot:!1}).filter(r=>!/[/\\](index|with-spec|spec-first-window)\.ts$/.test(r)).length}function np(t){if(!El(t))return null;try{return JSON.parse(pP(t,"utf8"))}catch{return null}}function vTe(t,e){let r=Fa(t,"plugins","claude-code",".claude-plugin","plugin.json"),n;try{n=JSON.parse(pP(r,"utf8"))}catch(c){e.push({detector:yo,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:yo,severity:"warn",message:`plugin.json current.detectors='${i}' is not in 'N/M' form`});return}let s=Number(o[1]),a=bTe(t);s!==a&&e.push({detector:yo,severity:"error",message:`plugin.json current.detectors='${i}' but stages/detectors/contains ${a} non-index .ts file(s)`})}function STe(t,e){for(let r of WJ){let n=Fa(t,r.path);if(!El(n))continue;let i=np(n);if(!i){e.push({detector:yo,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:yo,severity:"error",message:`${r.host}: ${r.path} is missing required field '${String(o)}'`})}}function wTe(t,e){let r=np(Fa(t,"package.json"));if(!r?.version)return;let n=r.version;for(let o of WJ){let s=Fa(t,o.path);if(!El(s))continue;let a=np(s);a?.version&&a.version!==n&&e.push({detector:yo,severity:"error",message:`${o.host}: ${o.path} version='${a.version}' but package.json version='${n}' \u2014 bump them in lockstep`})}let i=Fa(t,".claude-plugin","marketplace.json");if(El(i)){let o=np(i);for(let s of o?.plugins??[])s?.version&&s.version!==n&&e.push({detector:yo,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 xTe(t){let e=t.match(/TIER_STAGES[\s\S]*?\ball:\s*\[([^\]]*)\]/);return e?[...e[1].matchAll(/['"]([^'"]+)['"]/g)].map(r=>r[1]):[]}function $Te(t,e){let r=Fa(t,"src","cli","clad.ts"),n=Fa(t,"plugins","claude-code",".claude-plugin","plugin.json");if(!El(r)||!El(n))return;let i=xTe(pP(r,"utf8"));if(i.length===0)return;let s=np(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:yo,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 kTe(t){let{cwd:e="."}=t,r=[];return vTe(e,r),$Te(e,r),STe(e,r),wTe(e,r),r}var yo,WJ,KJ,JJ=y(()=>{"use strict";ep();yo="HARNESS_INTEGRITY",WJ=[{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"]}];KJ={name:yo,run:kTe}});import{existsSync as ETe,readFileSync as ATe}from"node:fs";import{join as TTe}from"node:path";function RTe(t){let{cwd:e="."}=t;return he(e,_v,r=>PTe(r,e))}function ITe(t){let e=TTe(t,"spec/capabilities.yaml");if(!ETe(e))return!1;try{let r=YJ.default.parse(ATe(e,"utf8"));if(!r||typeof r!="object")return!1;let n=r.capabilities;return!Array.isArray(n)||n.length===0}catch{return!1}}function PTe(t,e){let r=t.features.length;if(r{"use strict";YJ=Et(cr(),1);bt();_v="HOLLOW_GOVERNANCE",OTe=8;XJ={name:_v,run:RTe}});import{existsSync as e8,readFileSync as t8}from"node:fs";import{join as r8}from"node:path";function n8(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 NTe(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 jTe(t){switch(t){case"wiring-only":return 1;case"verified":return 2;default:return null}}function MTe(t){let e=r8(t,"README.md"),r=r8(t,"docs","dogfood","matrix.md");if(!e8(e)||!e8(r))return[];let n=n8(t8(e,"utf8"),CTe),i=n8(t8(r,"utf8"),DTe);if(!n||!i)return[];let o=[];for(let[s,a]of Object.entries(n)){let c=jTe(a);if(c===null)continue;let l=i[s]??"not-run",u=NTe(l);u!==null&&c>u&&o.push({detector:i8,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 FTe(t){let{cwd:e="."}=t;return MTe(e)}var i8,CTe,DTe,o8,s8=y(()=>{"use strict";i8="HOST_CLAIM_DRIFT",CTe=//,DTe=//;o8={name:i8,run:FTe}});function LTe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=[];return a8(r.features.map(i=>i.id),"feature","spec/features/",n),a8((r.scenarios??[]).map(i=>i.id),"scenario","spec/scenarios/",n),n}function a8(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:c8,severity:"error",message:`${e} id '${o}' appears ${s} times across ${r} \u2014 every ${e} must have a unique id; resolve the duplicate`})}var c8,l8,u8=y(()=>{"use strict";qe();c8="ID_COLLISION";l8={name:c8,run:LTe}});import{existsSync as ip,readFileSync as mP,readdirSync as hP,statSync as zTe,writeFileSync as f8}from"node:fs";import{join as _o}from"node:path";function d8(t){if(!ip(t))return 0;try{return hP(t).filter(e=>e.endsWith(".yaml")||e.endsWith(".yml")).length}catch{return 0}}function UTe(t){if(!ip(t))return 0;let e=0,r=[t];for(;r.length>0;){let n=r.pop(),i;try{i=hP(n)}catch{continue}for(let o of i){if(o==="node_modules"||o===".cladding"||o.startsWith("."))continue;let s=_o(n,o),a;try{a=zTe(s)}catch{continue}a.isDirectory()?r.push(s):(o.endsWith(".test.ts")||o.endsWith(".test.tsx"))&&e++}}return e}function qTe(t){let e=_o(t,"spec","capabilities.yaml");if(!ip(e))return 0;try{let r=bv.default.parse(mP(e,"utf8"));return Array.isArray(r?.capabilities)?r.capabilities.length:0}catch{return 0}}function ls(t="."){let e=d8(_o(t,"spec","features")),r=d8(_o(t,"spec","scenarios")),n=qTe(t),i=UTe(_o(t,"tests"));return{features:e,scenarios:r,capabilities:n,test_files:i}}function Al(t,e){let r=_o(t,"spec.yaml");if(!ip(r))return;let n=mP(r,"utf8"),i=BTe(n,e);i!==n&&f8(r,i)}function BTe(t,e){let r=t.includes(`\r + if (condition) { yield value; }`)}});import{Buffer as Cxe}from"node:buffer";import{StringDecoder as Dxe}from"node:string_decoder";var Qb,Nxe,jxe,Mxe,gI=y(()=>{rn();Qb=(t,e,r)=>{if(r)return;if(t)return{transform:Nxe.bind(void 0,new TextEncoder)};let n=new Dxe(e);return{transform:jxe.bind(void 0,n),final:Mxe.bind(void 0,n)}},Nxe=function*(t,e){Cxe.isBuffer(e)?yield yo(e):typeof e=="string"?yield t.encode(e):yield e},jxe=function*(t,e){yield Ut(e)?t.write(e):e},Mxe=function*(t){let e=t.end();e!==""&&(yield e)}});import{callbackify as GW}from"node:util";var yI,ev,ZW,Fxe,VW,Lxe,WW=y(()=>{yI=GW(async(t,e,r,n)=>{e.currentIterable=t(...r);try{for await(let i of e.currentIterable)n.push(i)}finally{delete e.currentIterable}}),ev=async function*(t,e,r){if(r===e.length){yield t;return}let{transform:n=Lxe}=e[r];for await(let i of n(t))yield*ev(i,e,r+1)},ZW=async function*(t){for(let[e,{final:r}]of Object.entries(t))yield*Fxe(r,Number(e),t)},Fxe=async function*(t,e,r){if(t!==void 0)for await(let n of t())yield*ev(n,r,e+1)},VW=GW(async({currentIterable:t},e)=>{if(t!==void 0){await(e?t.throw(e):t.return());return}if(e)throw e}),Lxe=function*(t){yield t}});var _I,KW,Ma,op,zxe,Uxe,bI=y(()=>{_I=(t,e,r,n)=>{try{for(let i of t(...e))r.push(i);n()}catch(i){n(i)}},KW=(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=Uxe}=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*zxe(r,Number(e),t)},zxe=function*(t,e,r){if(t!==void 0)for(let n of t())yield*Ma(n,r,e+1)},Uxe=function*(t){yield t}});import{Transform as qxe,getDefaultHighWaterMark as JW}from"node:stream";var vI,tv,YW,rv=y(()=>{vr();Xb();HW();gI();WW();bI();vI=({value:t,value:{transform:e,final:r,writableObjectMode:n,readableObjectMode:i},optionName:o},{encoding:s})=>{let a={},c=YW(t,s,o),l=ja(e),u=ja(r),d=l?yI.bind(void 0,ev,a):_I.bind(void 0,Ma),f=l||u?yI.bind(void 0,ZW,a):_I.bind(void 0,op),p=l||u?VW.bind(void 0,a):void 0;return{stream:new qxe({writableObjectMode:n,writableHighWaterMark:JW(n),readableObjectMode:i,readableHighWaterMark:JW(i),transform(h,g,b){d([h,c,0],this,b)},flush(h){f([c],this,h)},destroy:p})}},tv=(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=YW(s,r,a);t=KW(c,t)}return t},YW=({transform:t,final:e,binary:r,writableObjectMode:n,readableObjectMode:i,preserveNewlines:o},s,a)=>{let c={};return[{transform:UW(n,a)},Qb(r,s,n),Yb(r,o,n,c),{transform:t,final:e},{transform:qW(i,a)},zW({binary:r,preserveNewlines:o,readableObjectMode:i,state:c})].filter(Boolean)}});var XW,Bxe,Hxe,Gxe,Zxe,QW=y(()=>{rv();rn();vr();XW=(t,e)=>{for(let r of Bxe(t))Hxe(t,r,e)},Bxe=t=>new Set(Object.entries(t).filter(([,{direction:e}])=>e==="input").map(([e])=>Number(e))),Hxe=(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=>Gxe(a,n));r.input=Bf(s)},Gxe=(t,e)=>{let r=tv(t,e,"utf8",!0);return Zxe(r),Bf(r)},Zxe=t=>{let e=t.find(r=>typeof r!="string"&&!Ut(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 nv,Vxe,Wxe,e3,t3,Kxe,r3,SI=y(()=>{Pa();vr();wl();ls();nv=({stdioItems:t,encoding:e,verboseInfo:r,fdNumber:n})=>n!=="all"&&Sl(r,n)&&!nn.has(e)&&Vxe(n)&&(t.some(({type:i,value:o})=>i==="native"&&Wxe.has(o))||t.every(({type:i})=>Tn.has(i))),Vxe=t=>t===1||t===2,Wxe=new Set(["pipe","overlapped"]),e3=async(t,e,r,n)=>{for await(let i of t)Kxe(e)||r3(i,r,n)},t3=(t,e,r)=>{for(let n of t)r3(n,e,r)},Kxe=t=>t._readableState.pipes.length>0,r3=(t,e,r)=>{let n=rb(t);Ri({type:"output",verboseMessage:n,fdNumber:e,verboseInfo:r})}});import{writeFileSync as Jxe,appendFileSync as Yxe}from"node:fs";var n3,Xxe,Qxe,e0e,t0e,r0e,i3=y(()=>{SI();rv();Xb();rn();vr();Na();n3=({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)=>Xxe({result:c,fileDescriptors:t,fdNumber:l,state:o,outputFiles:s,isMaxBuffer:n,verboseInfo:i},r)),...o}},Xxe=({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=qV(t,o,d),p=yo(f),{stdioItems:m,objectMode:h}=e[r],g=Qxe([p],m,c,n),{serializedResult:b,finalResult:_=b}=e0e({chunks:g,objectMode:h,encoding:c,lines:l,stripFinalNewline:u,fdNumber:r});t0e({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&&r0e(b,m,i),S}catch(x){return n.error=x,S}},Qxe=(t,e,r,n)=>{try{return tv(t,e,r,!1)}catch(i){return n.error=i,t}},e0e=({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=PG(t,r);return n[o]?{serializedResult:s,finalResult:hI(s,!i[o],e)}:{serializedResult:s}},t0e=({serializedResult:t,fdNumber:e,state:r,verboseInfo:n,encoding:i,stdioItems:o,objectMode:s})=>{if(!nv({stdioItems:o,encoding:i,verboseInfo:n,fdNumber:e}))return;let a=hI(t,!1,s);try{t3(a,e,n)}catch(c){r.error??=c}},r0e=(t,e,r)=>{for(let{path:n,append:i}of e.filter(({type:o})=>Wb.has(o))){let o=typeof n=="string"?n:n.toString();i||r.has(o)?Yxe(n,t):(r.add(o),Jxe(n,t))}}});var o3,s3=y(()=>{rn();ip();o3=([,t,e],r)=>{if(r.all)return t===void 0?e:e===void 0?t:Array.isArray(t)?Array.isArray(e)?[...t,...e]:[...t,wo(e,r,"all")]:Array.isArray(e)?[wo(t,r,"all"),...e]:Ut(t)&&Ut(e)?uR([t,e]):`${t}${e}`}});import{once as wI}from"node:events";var a3,n0e,c3,l3,i0e,xI,$I=y(()=>{Ra();a3=async(t,e)=>{let[r,n]=await n0e(t);return e.isForcefullyTerminated??=!1,[r,n]},n0e=async t=>{let[e,r]=await Promise.allSettled([wI(t,"spawn"),wI(t,"exit")]);return e.status==="rejected"?[]:r.status==="rejected"?c3(t):r.value},c3=async t=>{try{return await wI(t,"exit")}catch{return c3(t)}},l3=async t=>{let[e,r]=await t;if(!i0e(e,r)&&xI(e,r))throw new Qn;return[e,r]},i0e=(t,e)=>t===void 0&&e===void 0,xI=(t,e)=>t!==0||e!==null});var u3,o0e,d3=y(()=>{Ra();Na();$I();u3=({error:t,status:e,signal:r,output:n},{maxBuffer:i})=>{let o=o0e(t,e,r),s=o?.code==="ETIMEDOUT",a=UV(o,n,i);return{resultError:o,exitCode:e,signal:r,timedOut:s,isMaxBuffer:a}},o0e=(t,e,r)=>t!==void 0?t:xI(e,r)?new Qn:void 0});import{spawnSync as s0e}from"node:child_process";var f3,a0e,c0e,l0e,iv,u0e,d0e,f0e,p0e,p3=y(()=>{bR();VR();WR();np();Gb();MW();ip();QW();i3();Na();s3();d3();f3=(t,e,r)=>{let{file:n,commandArguments:i,command:o,escapedCommand:s,startTime:a,verboseInfo:c,options:l,fileDescriptors:u}=a0e(t,e,r),d=u0e({file:n,commandArguments:i,options:l,command:o,escapedCommand:s,verboseInfo:c,fileDescriptors:u,startTime:a});return Cl(d,c,l)},a0e=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ob(t,e,r),a=c0e(r),{file:c,commandArguments:l,options:u}=Pb(t,e,a);l0e(u);let d=NW(u,s);return{file:c,commandArguments:l,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},c0e=t=>t.node&&!t.ipc?{...t,ipc:!1}:t,l0e=({ipc:t,ipcInput:e,detached:r,cancelSignal:n})=>{e&&iv("ipcInput"),t&&iv("ipc: true"),r&&iv("detached: true"),n&&iv("cancelSignal")},iv=t=>{throw new TypeError(`The "${t}" option cannot be used with synchronous methods.`)},u0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,verboseInfo:o,fileDescriptors:s,startTime:a})=>{let c=d0e({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}=u3(c,r),{output:m,error:h=l}=n3({fileDescriptors:s,syncResult:c,options:r,isMaxBuffer:p,verboseInfo:o}),g=m.map((_,S)=>wo(_,r,S)),b=wo(o3(m,r),r,"all");return p0e({error:h,exitCode:u,signal:d,timedOut:f,isMaxBuffer:p,stdio:g,all:b,options:r,command:n,escapedCommand:i,startTime:a})},d0e=({file:t,commandArguments:e,options:r,command:n,escapedCommand:i,fileDescriptors:o,startTime:s})=>{try{XW(o,r);let a=f0e(r);return s0e(...Cb(t,e,a))}catch(a){return Pl({error:a,command:n,escapedCommand:i,fileDescriptors:o,options:r,startTime:s,isSync:!0})}},f0e=({encoding:t,maxBuffer:e,...r})=>({...r,encoding:"buffer",maxBuffer:Bb(e)}),p0e=({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?Hb({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 kI,on as m0e}from"node:events";var m3,h0e,g0e,y0e,_0e,h3=y(()=>{Al();Yf();Jf();m3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0,filter:o}={})=>(kl({methodName:"getOneMessage",isSubprocess:r,ipc:n,isConnected:kb(t)}),h0e({anyProcess:t,channel:e,isSubprocess:r,filter:o,reference:i})),h0e=async({anyProcess:t,channel:e,isSubprocess:r,filter:n,reference:i})=>{_b(e,i);let o=fs(t,e,r),s=new AbortController;try{return await Promise.race([g0e(o,n,s),y0e(o,r,s),_0e(o,r,s)])}catch(a){throw El(t),a}finally{s.abort(),bb(e,i)}},g0e=async(t,e,{signal:r})=>{if(e===void 0){let[n]=await kI(t,"message",{signal:r});return n}for await(let[n]of m0e(t,"message",{signal:r}))if(e(n))return n},y0e=async(t,e,{signal:r})=>{await kI(t,"disconnect",{signal:r}),E9(e)},_0e=async(t,e,{signal:r})=>{let[n]=await kI(t,"strict:error",{signal:r});throw mb(n,e)}});import{once as y3,on as b0e}from"node:events";var _3,EI,v0e,S0e,w0e,g3,AI=y(()=>{Al();Yf();Jf();_3=({anyProcess:t,channel:e,isSubprocess:r,ipc:n},{reference:i=!0}={})=>EI({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:!r,reference:i}),EI=({anyProcess:t,channel:e,isSubprocess:r,ipc:n,shouldAwait:i,reference:o})=>{kl({methodName:"getEachMessage",isSubprocess:r,ipc:n,isConnected:kb(t)}),_b(e,o);let s=fs(t,e,r),a=new AbortController,c={};return v0e(t,s,a),S0e({ipcEmitter:s,isSubprocess:r,controller:a,state:c}),w0e({anyProcess:t,channel:e,ipcEmitter:s,isSubprocess:r,shouldAwait:i,controller:a,state:c,reference:o})},v0e=async(t,e,r)=>{try{await y3(e,"disconnect",{signal:r.signal}),r.abort()}catch{}},S0e=async({ipcEmitter:t,isSubprocess:e,controller:r,state:n})=>{try{let[i]=await y3(t,"strict:error",{signal:r.signal});n.error=mb(i,e),r.abort()}catch{}},w0e=async function*({anyProcess:t,channel:e,ipcEmitter:r,isSubprocess:n,shouldAwait:i,controller:o,state:s,reference:a}){try{for await(let[c]of b0e(r,"message",{signal:o.signal}))g3(s),yield c}catch{g3(s)}finally{o.abort(),bb(e,a),n||El(t),i&&await t}},g3=({error:t})=>{if(t)throw t}});import b3 from"node:process";var v3,S3,w3,TI=y(()=>{Rb();h3();AI();xb();v3=(t,{ipc:e})=>{Object.assign(t,w3(t,!1,e))},S3=()=>{let t=b3,e=!0,r=b3.channel!==void 0;return{...w3(t,e,r),getCancelSignal:eV.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r})}},w3=(t,e,r)=>({sendMessage:Ob.bind(void 0,{anyProcess:t,channel:t.channel,isSubprocess:e,ipc:r}),getOneMessage:m3.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 x0e}from"node:child_process";import{PassThrough as $0e,Readable as k0e,Writable as E0e,Duplex as A0e}from"node:stream";var x3,T0e,sp,O0e,R0e,I0e,P0e,$3=y(()=>{Jb();np();Gb();x3=({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,verboseInfo:s})=>{fI(n);let a=new x0e;T0e(a,n),Object.assign(a,{readable:O0e,writable:R0e,duplex:I0e});let c=Pl({error:t,command:e,escapedCommand:r,fileDescriptors:n,options:i,startTime:o,isSync:!1}),l=P0e(c,s,i);return{subprocess:a,promise:l}},T0e=(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 $0e;return t.end(),t},O0e=()=>new k0e({read(){}}),R0e=()=>new E0e({write(){}}),I0e=()=>new A0e({read(){},write(){}}),P0e=async(t,e,r)=>Cl(t,e,r)});import{createReadStream as k3,createWriteStream as E3}from"node:fs";import{Buffer as C0e}from"node:buffer";import{Readable as ap,Writable as D0e,Duplex as N0e}from"node:stream";var T3,cp,A3,j0e,O3=y(()=>{rv();Jb();vr();T3=(t,e)=>Kb(j0e,t,e,!1),cp=({type:t,optionName:e})=>{throw new TypeError(`The \`${e}\` option cannot be ${ps[t]}.`)},A3={fileNumber:cp,generator:vI,asyncGenerator:vI,nodeStream:({value:t})=>({stream:t}),webTransform({value:{transform:t,writableObjectMode:e,readableObjectMode:r}}){let n=e||r;return{stream:N0e.fromWeb(t,{objectMode:n})}},duplex:({value:{transform:t}})=>({stream:t}),native(){}},j0e={input:{...A3,fileUrl:({value:t})=>({stream:k3(t)}),filePath:({value:{file:t}})=>({stream:k3(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(C0e.from(t))})},output:{...A3,fileUrl:({value:t})=>({stream:E3(t)}),filePath:({value:{file:t,append:e}})=>({stream:E3(t,e?{flags:"a"}:{})}),webStream:({value:t})=>({stream:D0e.fromWeb(t)}),iterable:cp,asyncIterable:cp,string:cp,uint8Array:cp}}});import{on as M0e,once as R3}from"node:events";import{PassThrough as F0e,getDefaultHighWaterMark as L0e}from"node:stream";import{finished as C3}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)RI(i);let e=t.some(({readableObjectMode:i})=>i),r=z0e(t,e),n=new OI({objectMode:e,writableHighWaterMark:r,readableHighWaterMark:r});for(let i of t)n.add(i);return n}var z0e,OI,U0e,q0e,B0e,RI,H0e,G0e,Z0e,V0e,W0e,D3,N3,II,j3,K0e,ov,I3,P3,sv=y(()=>{z0e=(t,e)=>{if(t.length===0)return L0e(e);let r=t.filter(({readableObjectMode:n})=>n===e).map(({readableHighWaterMark:n})=>n);return Math.max(...r)},OI=class extends F0e{#t=new Set([]);#r=new Set([]);#e=new Set([]);#n;#o=Symbol("unpipe");#i=new WeakMap;add(e){if(RI(e),this.#t.has(e))return;this.#t.add(e),this.#n??=U0e(this,this.#t,this.#o);let r=H0e({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(RI(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)}},U0e=async(t,e,r)=>{ov(t,I3);let n=new AbortController;try{await Promise.race([q0e(t,n),B0e(t,e,r,n)])}finally{n.abort(),ov(t,-I3)}},q0e=async(t,{signal:e})=>{try{await C3(t,{signal:e,cleanup:!0})}catch(r){throw D3(t,r),r}},B0e=async(t,e,r,{signal:n})=>{for await(let[i]of M0e(t,"unpipe",{signal:n}))e.has(i)&&i.emit(r)},RI=t=>{if(typeof t?.pipe!="function")throw new TypeError(`Expected a readable stream, got: \`${typeof t}\`.`)},H0e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,onFinished:o,unpipeEvent:s})=>{ov(t,P3);let a=new AbortController;try{await Promise.race([G0e(o,e,a),Z0e({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:a}),V0e({stream:e,streams:r,ended:n,aborted:i,unpipeEvent:s,controller:a})])}finally{a.abort(),ov(t,-P3)}r.size>0&&r.size===n.size+i.size&&(n.size===0&&i.size>0?II(t):W0e(t))},G0e=async(t,e,{signal:r})=>{try{await t,r.aborted||II(e)}catch(n){r.aborted||D3(e,n)}},Z0e=async({passThroughStream:t,stream:e,streams:r,ended:n,aborted:i,controller:{signal:o}})=>{try{await C3(e,{signal:o,cleanup:!0,readable:!0,writable:!1}),r.has(e)&&n.add(e)}catch(s){if(o.aborted||!r.has(e))return;N3(s)?i.add(e):j3(t,s)}},V0e=async({stream:t,streams:e,ended:r,aborted:n,unpipeEvent:i,controller:{signal:o}})=>{if(await R3(t,i,{signal:o}),!t.readable)return R3(o,"abort",{signal:o});e.delete(t),r.delete(t),n.delete(t)},W0e=t=>{t.writable&&t.end()},D3=(t,e)=>{N3(e)?II(t):j3(t,e)},N3=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",II=t=>{(t.readable||t.writable)&&t.destroy()},j3=(t,e)=>{t.destroyed||(t.once("error",K0e),t.destroy(e))},K0e=()=>{},ov=(t,e)=>{let r=t.getMaxListeners();r!==0&&r!==Number.POSITIVE_INFINITY&&t.setMaxListeners(r+e)},I3=2,P3=1});import{finished as M3}from"node:stream/promises";var Nl,J0e,PI,Y0e,CI,av=y(()=>{_o();Nl=(t,e)=>{t.pipe(e),J0e(t,e),Y0e(t,e)},J0e=async(t,e)=>{if(!(Xn(t)||Xn(e))){try{await M3(t,{cleanup:!0,readable:!0,writable:!1})}catch{}PI(e)}},PI=t=>{t.writable&&t.end()},Y0e=async(t,e)=>{if(!(Xn(t)||Xn(e))){try{await M3(e,{cleanup:!0,readable:!1,writable:!0})}catch{}CI(t)}},CI=t=>{t.readable&&t.destroy()}});var F3,X0e,Q0e,e$e,t$e,r$e,L3=y(()=>{sv();_o();yb();vr();av();F3=(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})=>Tn.has(c)))X0e(t,a,s,i);for(let{stream:a}of o.filter(({type:c})=>!Tn.has(c)))e$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);Nl(s,i)}},X0e=(t,e,r,n)=>{r==="output"?Nl(t.stdio[n],e):Nl(e,t.stdio[n]);let i=Q0e[n];i!==void 0&&(t[i]=e),t.stdio[n]=e},Q0e=["stdin","stdout","stderr"],e$e=({subprocess:t,stream:e,direction:r,fdNumber:n,pipeGroups:i,controller:o})=>{if(e===void 0)return;t$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])},t$e=(t,{signal:e})=>{Xn(t)&&Ia(t,r$e,e)},r$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 cv,DI,NI,n$e,jI,lv,i$e,MI,FI,LI,U3,Nst,jst,q3=y(()=>{z3();cv=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",DI=Symbol.for("signal-exit emitter"),NI=globalThis,n$e=Object.defineProperty.bind(Object),jI=class{emitted={afterExit:!1,exit:!1};listeners={afterExit:[],exit:[]};count=0;id=Math.random();constructor(){if(NI[DI])return NI[DI];n$e(NI,DI,{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}},lv=class{},i$e=t=>({onExit(e,r){return t.onExit(e,r)},load(){return t.load()},unload(){return t.unload()}}),MI=class extends lv{onExit(){return()=>{}}load(){}unload(){}},FI=class extends lv{#t=LI.platform==="win32"?"SIGINT":"SIGHUP";#r=new jI;#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(!cv(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 cv(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"&&cv(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)}},LI=globalThis.process,{onExit:U3,load:Nst,unload:jst}=i$e(cv(LI)?new FI(LI):new MI)});import{addAbortListener as o$e}from"node:events";var B3,H3=y(()=>{q3();B3=(t,{cleanup:e,detached:r},{signal:n})=>{if(!e||r)return;let i=U3(()=>{t.kill()});o$e(n,()=>{i()})}});var Z3,s$e,a$e,G3,c$e,V3=y(()=>{lR();ib();ds();bl();Z3=({source:t,sourcePromise:e,boundOptions:r,createNested:n},...i)=>{let o=nb(),{destination:s,destinationStream:a,destinationError:c,from:l,unpipeSignal:u}=s$e(r,n,i),{sourceStream:d,sourceError:f}=c$e(t,l),{options:p,fileDescriptors:m}=Pi.get(t);return{sourcePromise:e,sourceStream:d,sourceOptions:p,sourceError:f,destination:s,destinationStream:a,destinationError:c,unpipeSignal:u,fileDescriptors:m,startTime:o}},s$e=(t,e,r)=>{try{let{destination:n,pipeOptions:{from:i,to:o,unpipeSignal:s}={}}=a$e(t,e,...r),a=gb(n,o);return{destination:n,destinationStream:a,from:i,unpipeSignal:s}}catch(n){return{destinationError:n}}},a$e=(t,e,r,...n)=>{if(Array.isArray(r))return{destination:e(G3,t)(r,...n),pipeOptions:t};if(typeof r=="string"||r instanceof URL||aR(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]=Z_(r,...n);return{destination:e(G3)(i,o,s),pipeOptions:s}}if(Pi.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}`)},G3=({options:t})=>({options:{...t,stdin:"pipe",piped:!0}}),c$e=(t,e)=>{try{return{sourceStream:Ol(t,e)}}catch(r){return{sourceError:r}}}});var K3,l$e,zI,W3,UI=y(()=>{np();av();K3=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n,fileDescriptors:i,sourceOptions:o,startTime:s})=>{let a=l$e({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n});if(a!==void 0)throw zI({error:a,fileDescriptors:i,sourceOptions:o,startTime:s})},l$e=({sourceStream:t,sourceError:e,destinationStream:r,destinationError:n})=>{if(e!==void 0&&n!==void 0)return n;if(n!==void 0)return CI(t),n;if(e!==void 0)return PI(r),e},zI=({error:t,fileDescriptors:e,sourceOptions:r,startTime:n})=>Pl({error:t,command:W3,escapedCommand:W3,fileDescriptors:e,options:r,startTime:n,isSync:!1}),W3="source.pipe(destination)"});var J3,Y3=y(()=>{J3=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 u$e}from"node:stream/promises";var X3,d$e,f$e,p$e,uv,m$e,h$e,Q3=y(()=>{sv();yb();av();X3=(t,e,r)=>{let n=uv.has(e)?f$e(t,e):d$e(t,e);return Ia(t,m$e,r.signal),Ia(e,h$e,r.signal),p$e(e),n},d$e=(t,e)=>{let r=Fa([t]);return Nl(r,e),uv.set(e,r),r},f$e=(t,e)=>{let r=uv.get(e);return r.add(t),r},p$e=async t=>{try{await u$e(t,{cleanup:!0,readable:!1,writable:!0})}catch{}uv.delete(t)},uv=new WeakMap,m$e=2,h$e=1});import{aborted as g$e}from"node:util";var eK,y$e,tK=y(()=>{UI();eK=(t,e)=>t===void 0?[]:[y$e(t,e)],y$e=async(t,{sourceStream:e,mergedStream:r,fileDescriptors:n,sourceOptions:i,startTime:o})=>{await g$e(t,e),await r.remove(e);let s=new Error("Pipe canceled by `unpipeSignal` option.");throw zI({error:s,fileDescriptors:n,sourceOptions:i,startTime:o})}});var dv,_$e,b$e,rK=y(()=>{go();V3();UI();Y3();Q3();tK();dv=(t,...e)=>{if(Ot(e[0]))return dv.bind(void 0,{...t,boundOptions:{...t.boundOptions,...e[0]}});let{destination:r,...n}=Z3(t,...e),i=_$e({...n,destination:r});return i.pipe=dv.bind(void 0,{...t,source:r,sourcePromise:i,boundOptions:{}}),i},_$e=async({sourcePromise:t,sourceStream:e,sourceOptions:r,sourceError:n,destination:i,destinationStream:o,destinationError:s,unpipeSignal:a,fileDescriptors:c,startTime:l})=>{let u=b$e(t,i);K3({sourceStream:e,sourceError:n,destinationStream:o,destinationError:s,fileDescriptors:c,sourceOptions:r,startTime:l});let d=new AbortController;try{let f=X3(e,o,d);return await Promise.race([J3(u),...eK(a,{sourceStream:e,mergedStream:f,sourceOptions:r,fileDescriptors:c,startTime:l})])}finally{d.abort()}},b$e=(t,e)=>Promise.allSettled([t,e])});import{on as v$e}from"node:events";import{getDefaultHighWaterMark as S$e}from"node:stream";var fv,w$e,qI,x$e,iK,BI,nK,$$e,k$e,pv=y(()=>{gI();Xb();bI();fv=({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:n,encoding:i,preserveNewlines:o})=>{let s=new AbortController;return w$e(e,s),iK({stream:t,controller:s,binary:r,shouldEncode:!t.readableObjectMode&&n,encoding:i,shouldSplit:!t.readableObjectMode,preserveNewlines:o})},w$e=async(t,e)=>{try{await t}catch{}finally{e.abort()}},qI=({stream:t,onStreamEnd:e,lines:r,encoding:n,stripFinalNewline:i,allMixed:o})=>{let s=new AbortController;x$e(e,s,t);let a=t.readableObjectMode&&!o;return iK({stream:t,controller:s,binary:n==="buffer",shouldEncode:!a,encoding:n,shouldSplit:!a&&r,preserveNewlines:!i})},x$e=async(t,e,r)=>{try{await t}catch{r.destroy()}finally{e.abort()}},iK=({stream:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})=>{let a=v$e(t,"data",{signal:e.signal,highWaterMark:nK,highWatermark:nK});return $$e({onStdoutChunk:a,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s})},BI=S$e(!0),nK=BI,$$e=async function*({onStdoutChunk:t,controller:e,binary:r,shouldEncode:n,encoding:i,shouldSplit:o,preserveNewlines:s}){let a=k$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)}},k$e=({binary:t,shouldEncode:e,encoding:r,shouldSplit:n,preserveNewlines:i})=>[Qb(t,r,!e),Yb(t,i,!n,{})].filter(Boolean)});import{setImmediate as E$e}from"node:timers/promises";var oK,A$e,T$e,O$e,HI,sK,GI=y(()=>{qb();rn();SI();pv();Na();ip();oK=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=A$e({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:a,verboseInfo:l,streamInfo:u});if(!i){await Promise.all([T$e(t),d]);return}let f=pI(c,r),p=qI({stream:t,onStreamEnd:e,lines:s,encoding:n,stripFinalNewline:f,allMixed:a}),[m]=await Promise.all([O$e({stream:t,iterable:p,fdNumber:r,encoding:n,maxBuffer:o,lines:s}),d]);return m},A$e=async({stream:t,onStreamEnd:e,fdNumber:r,encoding:n,allMixed:i,verboseInfo:o,streamInfo:{fileDescriptors:s}})=>{if(!nv({stdioItems:s[r]?.stdioItems,encoding:n,verboseInfo:o,fdNumber:r}))return;let a=qI({stream:t,onStreamEnd:e,lines:!0,encoding:n,stripFinalNewline:!0,allMixed:i});await e3(a,t,r,o)},T$e=async t=>{await E$e(),t.readableFlowing===null&&t.resume()},O$e=async({stream:t,stream:{readableObjectMode:e},iterable:r,fdNumber:n,encoding:i,maxBuffer:o,lines:s})=>{try{return e||s?await Fb(r,{maxBuffer:o}):i==="buffer"?new Uint8Array(await Lb(r,{maxBuffer:o})):await Ub(r,{maxBuffer:o})}catch(a){return sK(FV({error:a,stream:t,readableObjectMode:e,lines:s,encoding:i,fdNumber:n}))}},HI=async t=>{try{return await t}catch(e){return sK(e)}},sK=({bufferedData:t})=>RG(t)?new Uint8Array(t):t});import{finished as R$e}from"node:stream/promises";var lp,I$e,P$e,C$e,D$e,N$e,ZI,mv,aK,hv=y(()=>{lp=async(t,e,r,{isSameDirection:n,stopOnExit:i=!1}={})=>{let o=I$e(t,r),s=new AbortController;try{await Promise.race([...i?[r.exitPromise]:[],R$e(t,{cleanup:!0,signal:s.signal})])}catch(a){o.stdinCleanedUp||D$e(a,e,r,n)}finally{s.abort()}},I$e=(t,{originalStreams:[e],subprocess:r})=>{let n={stdinCleanedUp:!1};return t===e&&P$e(t,r,n),n},P$e=(t,e,r)=>{let{_destroy:n}=t;t._destroy=(...i)=>{C$e(e,r),n.call(t,...i)}},C$e=({exitCode:t,signalCode:e},r)=>{(t!==null||e!==null)&&(r.stdinCleanedUp=!0)},D$e=(t,e,r,n)=>{if(!N$e(t,e,r,n))throw t},N$e=(t,e,r,n=!0)=>r.propagating?aK(t)||mv(t):(r.propagating=!0,ZI(r,e)===n?aK(t):mv(t)),ZI=({fileDescriptors:t},e)=>e!=="all"&&t[e].direction==="input",mv=t=>t?.code==="ERR_STREAM_PREMATURE_CLOSE",aK=t=>t?.code==="EPIPE"});var cK,VI,WI=y(()=>{GI();hv();cK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>t.stdio.map((c,l)=>VI({stream:c,fdNumber:l,encoding:e,buffer:r[l],maxBuffer:n[l],lines:i[l],allMixed:!1,stripFinalNewline:o,verboseInfo:s,streamInfo:a})),VI=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(ZI(l,e)){await u;return}let[d]=await Promise.all([oK({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 lK,uK,j$e,M$e,KI=y(()=>{sv();WI();lK=({stdout:t,stderr:e},{all:r})=>r&&(t||e)?Fa([t,e].filter(Boolean)):void 0,uK=({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:o,verboseInfo:s,streamInfo:a})=>VI({...j$e(t,r),fdNumber:"all",encoding:e,maxBuffer:n[1]+n[2],lines:i[1]||i[2],allMixed:M$e(t),stripFinalNewline:o,verboseInfo:s,streamInfo:a}),j$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}},M$e=({all:t,stdout:e,stderr:r})=>t&&e&&r&&e.readableObjectMode!==r.readableObjectMode});var dK,fK,pK=y(()=>{wl();ls();dK=t=>Sl(t,"ipc"),fK=(t,e)=>{let r=rb(t);Ri({type:"ipc",verboseMessage:r,fdNumber:"ipc",verboseInfo:e})}});var mK,hK,gK=y(()=>{Na();pK();vo();AI();mK=async({subprocess:t,buffer:e,maxBuffer:r,ipc:n,ipcOutput:i,verboseInfo:o})=>{if(!n)return i;let s=dK(o),a=bo(e,"ipc"),c=bo(r,"ipc");for await(let l of EI({anyProcess:t,channel:t.channel,isSubprocess:!1,ipc:n,shouldAwait:!1,reference:!0}))a&&(LV(t,i,c),i.push(l)),s&&fK(l,o);return i},hK=async(t,e)=>(await Promise.allSettled([t]),e)});import{once as F$e}from"node:events";var yK,L$e,z$e,U$e,_K=y(()=>{Da();qR();CR();UR();_o();vr();GI();gK();HR();KI();WI();$I();hv();yK=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 _=a3(t,f),S={originalStreams:h,fileDescriptors:m,subprocess:t,exitPromise:_,propagating:!1},x=cK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),w=uK({subprocess:t,encoding:e,buffer:r,maxBuffer:n,lines:i,stripFinalNewline:l,verboseInfo:p,streamInfo:S}),O=[],T=mK({subprocess:t,buffer:r,maxBuffer:n,ipc:u,ipcOutput:O,verboseInfo:p}),A=L$e(h,t,S),D=z$e(m,S);try{return await Promise.race([Promise.all([{},l3(_),Promise.all(x),w,T,uV(t,d),...A,...D]),g,U$e(t,b),...oV(t,o,f,b),...k9({subprocess:t,cancelSignal:s,gracefulCancel:a,context:f,controller:b}),...nV({subprocess:t,cancelSignal:s,gracefulCancel:a,forceKillAfterDelay:c,context:f,controller:b})])}catch($){return f.terminationReason??="other",Promise.all([{error:$},_,Promise.all(x.map(ie=>HI(ie))),HI(w),hK(T,O),Promise.allSettled(A),Promise.allSettled(D)])}},L$e=(t,e,r)=>t.map((n,i)=>n===e.stdio[i]?void 0:lp(n,i,r)),z$e=(t,e)=>t.flatMap(({stdioItems:r},n)=>r.filter(({value:i,stream:o=i})=>ti(o,{checkOpen:!1})&&!Xn(o)).map(({type:i,value:o,stream:s=o})=>lp(s,n,e,{isSameDirection:Tn.has(i),stopOnExit:i==="native"}))),U$e=async(t,{signal:e})=>{let[r]=await F$e(t,"error",{signal:e});throw r}});var bK,up,jl,gv=y(()=>{Tl();bK=()=>({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=Ii();return i.push(o),{resolve:o.resolve.bind(o),promises:i}},jl=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 vK}from"node:stream/promises";var JI,SK,YI,XI,yv,_v,QI=y(()=>{hv();JI=async t=>{if(t!==void 0)try{await YI(t)}catch{}},SK=async t=>{if(t!==void 0)try{await XI(t)}catch{}},YI=async t=>{await vK(t,{cleanup:!0,readable:!1,writable:!0})},XI=async t=>{await vK(t,{cleanup:!0,readable:!0,writable:!1})},yv=async(t,e)=>{if(await t,e)throw e},_v=(t,e,r)=>{r&&!mv(r)?t.destroy(r):e&&t.destroy()}});import{Readable as q$e}from"node:stream";import{callbackify as B$e}from"node:util";var wK,eP,tP,rP,H$e,nP,iP,xK,oP=y(()=>{Pa();ds();pv();Tl();gv();QI();wK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,binary:i=!0,preserveNewlines:o=!0}={})=>{let s=i||nn.has(r),{subprocessStdout:a,waitReadableDestroy:c}=eP(t,n,e),{readableEncoding:l,readableObjectMode:u,readableHighWaterMark:d}=tP(a,s),{read:f,onStdoutDataDone:p}=rP({subprocessStdout:a,subprocess:t,binary:s,encoding:r,preserveNewlines:o}),m=new q$e({read:f,destroy:B$e(iP.bind(void 0,{subprocessStdout:a,subprocess:t,waitReadableDestroy:c})),highWaterMark:d,objectMode:u,encoding:l});return nP({subprocessStdout:a,onStdoutDataDone:p,readable:m,subprocess:t}),m},eP=(t,e,r)=>{let n=Ol(t,e),i=up(r,n,"readableDestroy");return{subprocessStdout:n,waitReadableDestroy:i}},tP=({readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r},n)=>n?{readableEncoding:t,readableObjectMode:e,readableHighWaterMark:r}:{readableEncoding:t,readableObjectMode:!0,readableHighWaterMark:BI},rP=({subprocessStdout:t,subprocess:e,binary:r,encoding:n,preserveNewlines:i})=>{let o=Ii(),s=fv({subprocessStdout:t,subprocess:e,binary:r,shouldEncode:!r,encoding:n,preserveNewlines:i});return{read(){H$e(this,s,o)},onStdoutDataDone:o}},H$e=async(t,e,r)=>{try{let{value:n,done:i}=await e.next();i?r.resolve():t.push(n)}catch{}},nP=async({subprocessStdout:t,onStdoutDataDone:e,readable:r,subprocess:n,subprocessStdin:i})=>{try{await XI(t),await n,await JI(i),await e,r.readable&&r.push(null)}catch(o){await JI(i),xK(r,o)}},iP=async({subprocessStdout:t,subprocess:e,waitReadableDestroy:r},n)=>{await jl(r,e)&&(xK(t,n),await yv(e,n))},xK=(t,e)=>{_v(t,t.readable,e)}});import{Writable as G$e}from"node:stream";import{callbackify as $K}from"node:util";var kK,sP,aP,Z$e,V$e,cP,lP,EK,uP=y(()=>{ds();gv();QI();kK=({subprocess:t,concurrentStreams:e},{to:r}={})=>{let{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}=sP(t,r,e),s=new G$e({...aP(n,t,i),destroy:$K(lP.bind(void 0,{subprocessStdin:n,subprocess:t,waitWritableFinal:i,waitWritableDestroy:o})),highWaterMark:n.writableHighWaterMark,objectMode:n.writableObjectMode});return cP(n,s),s},sP=(t,e,r)=>{let n=gb(t,e),i=up(r,n,"writableFinal"),o=up(r,n,"writableDestroy");return{subprocessStdin:n,waitWritableFinal:i,waitWritableDestroy:o}},aP=(t,e,r)=>({write:Z$e.bind(void 0,t),final:$K(V$e.bind(void 0,t,e,r))}),Z$e=(t,e,r,n)=>{t.write(e,r)?n():t.once("drain",n)},V$e=async(t,e,r)=>{await jl(r,e)&&(t.writable&&t.end(),await e)},cP=async(t,e,r)=>{try{await YI(t),e.writable&&e.end()}catch(n){await SK(r),EK(e,n)}},lP=async({subprocessStdin:t,subprocess:e,waitWritableFinal:r,waitWritableDestroy:n},i)=>{await jl(r,e),await jl(n,e)&&(EK(t,i),await yv(e,i))},EK=(t,e)=>{_v(t,t.writable,e)}});import{Duplex as W$e}from"node:stream";import{callbackify as K$e}from"node:util";var AK,J$e,TK=y(()=>{Pa();oP();uP();AK=({subprocess:t,concurrentStreams:e,encoding:r},{from:n,to:i,binary:o=!0,preserveNewlines:s=!0}={})=>{let a=o||nn.has(r),{subprocessStdout:c,waitReadableDestroy:l}=eP(t,n,e),{subprocessStdin:u,waitWritableFinal:d,waitWritableDestroy:f}=sP(t,i,e),{readableEncoding:p,readableObjectMode:m,readableHighWaterMark:h}=tP(c,a),{read:g,onStdoutDataDone:b}=rP({subprocessStdout:c,subprocess:t,binary:a,encoding:r,preserveNewlines:s}),_=new W$e({read:g,...aP(u,t,d),destroy:K$e(J$e.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 nP({subprocessStdout:c,onStdoutDataDone:b,readable:_,subprocess:t,subprocessStdin:u}),cP(u,_,c),_},J$e=async({subprocessStdout:t,subprocessStdin:e,subprocess:r,waitReadableDestroy:n,waitWritableFinal:i,waitWritableDestroy:o},s)=>{await Promise.all([iP({subprocessStdout:t,subprocess:r,waitReadableDestroy:n},s),lP({subprocessStdin:e,subprocess:r,waitWritableFinal:i,waitWritableDestroy:o},s)])}});var dP,Y$e,OK=y(()=>{Pa();ds();pv();dP=(t,e,{from:r,binary:n=!1,preserveNewlines:i=!1}={})=>{let o=n||nn.has(e),s=Ol(t,r),a=fv({subprocessStdout:s,subprocess:t,binary:o,shouldEncode:!0,encoding:e,preserveNewlines:i});return Y$e(a,s,t)},Y$e=async function*(t,e,r){try{yield*t}finally{e.readable&&e.destroy(),await r}}});var RK,IK=y(()=>{gv();oP();uP();TK();OK();RK=(t,{encoding:e})=>{let r=bK();t.readable=wK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.writable=kK.bind(void 0,{subprocess:t,concurrentStreams:r}),t.duplex=AK.bind(void 0,{subprocess:t,concurrentStreams:r,encoding:e}),t.iterable=dP.bind(void 0,t,e),t[Symbol.asyncIterator]=dP.bind(void 0,t,e,{})}});var PK,X$e,Q$e,CK=y(()=>{PK=(t,e)=>{for(let[r,n]of Q$e){let i=n.value.bind(e);Reflect.defineProperty(t,r,{...n,value:i})}},X$e=(async()=>{})().constructor.prototype,Q$e=["then","catch","finally"].map(t=>[t,Reflect.getOwnPropertyDescriptor(X$e,t)])});import{setMaxListeners as eke}from"node:events";import{spawn as tke}from"node:child_process";var DK,rke,nke,ike,oke,ske,NK=y(()=>{qb();bR();VR();ds();WR();TI();np();Gb();$3();O3();ip();L3();fb();H3();rK();KI();_K();IK();Tl();CK();DK=(t,e,r,n)=>{let{file:i,commandArguments:o,command:s,escapedCommand:a,startTime:c,verboseInfo:l,options:u,fileDescriptors:d}=rke(t,e,r),{subprocess:f,promise:p}=ike({file:i,commandArguments:o,options:u,startTime:c,verboseInfo:l,command:s,escapedCommand:a,fileDescriptors:d});return f.pipe=dv.bind(void 0,{source:f,sourcePromise:p,boundOptions:{},createNested:n}),PK(f,p),Pi.set(f,{options:u,fileDescriptors:d}),f},rke=(t,e,r)=>{let{command:n,escapedCommand:i,startTime:o,verboseInfo:s}=ob(t,e,r),{file:a,commandArguments:c,options:l}=Pb(t,e,r),u=nke(l),d=T3(u,s);return{file:a,commandArguments:c,command:n,escapedCommand:i,startTime:o,verboseInfo:s,options:u,fileDescriptors:d}},nke=({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}},ike=({file:t,commandArguments:e,options:r,startTime:n,verboseInfo:i,command:o,escapedCommand:s,fileDescriptors:a})=>{let c;try{c=tke(...Cb(t,e,r))}catch(m){return x3({error:m,command:o,escapedCommand:s,fileDescriptors:a,options:r,startTime:n,verboseInfo:i})}let l=new AbortController;eke(Number.POSITIVE_INFINITY,l.signal);let u=[...c.stdio];F3(c,a,l),B3(c,r,l);let d={},f=Ii();c.kill=x9.bind(void 0,{kill:c.kill.bind(c),options:r,onInternalError:f,context:d,controller:l}),c.all=lK(c,r),RK(c,r),v3(c,r);let p=oke({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}},oke=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 yK({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)=>wo(x,e,w)),_=wo(h,e,"all"),S=ske({errorInfo:d,exitCode:f,signal:p,stdio:b,all:_,ipcOutput:g,context:c,options:e,command:s,escapedCommand:a,startTime:r});return Cl(S,n,e)},ske=({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 Ci,isForcefullyTerminated:s.isForcefullyTerminated,exitCode:e,signal:r,stdio:n,all:i,ipcOutput:o,options:a,startTime:u,isSync:!1}):Hb({command:c,escapedCommand:l,stdio:n,all:i,ipcOutput:o,options:a,startTime:u})});var bv,ake,cke,jK=y(()=>{go();vo();bv=(t,e)=>{let r=Object.fromEntries(Object.entries(e).map(([n,i])=>[n,ake(n,t[n],i)]));return{...t,...r}},ake=(t,e,r)=>cke.has(t)&&Ot(e)&&Ot(r)?{...e,...r}:r,cke=new Set(["env",...mR])});var ms,lke,uke,MK=y(()=>{go();lR();FG();p3();NK();jK();ms=(t,e,r,n)=>{let i=(s,a,c)=>ms(s,a,r,c),o=(...s)=>lke({mapArguments:t,deepOptions:r,boundOptions:e,setBoundExeca:n,createNested:i},...s);return n!==void 0&&n(o,i,e),o},lke=({mapArguments:t,deepOptions:e={},boundOptions:r={},setBoundExeca:n,createNested:i},o,...s)=>{if(Ot(o))return i(t,bv(r,o),n);let{file:a,commandArguments:c,options:l,isSync:u}=uke({mapArguments:t,firstArgument:o,nextArguments:s,deepOptions:e,boundOptions:r});return u?f3(a,c,l):DK(a,c,l,i)},uke=({mapArguments:t,firstArgument:e,nextArguments:r,deepOptions:n,boundOptions:i})=>{let o=jG(e)?MG(e,r):[e,...r],[s,a,c]=Z_(...o),l=bv(bv(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 FK,LK,zK,dke,fke,UK=y(()=>{FK=({file:t,commandArguments:e})=>zK(t,e),LK=({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]=dke(t);return{file:r,commandArguments:n}},dke=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(fke)){let i=r.at(-1);i&&i.endsWith("\\")?r[r.length-1]=`${i.slice(0,-1)} ${n}`:r.push(n)}return r},fke=/ +/g});var qK,BK,pke,HK,mke,GK,ZK=y(()=>{qK=(t,e,r)=>{t.sync=e(pke,r),t.s=t.sync},BK=({options:t})=>HK(t),pke=({options:t})=>({...HK(t),isSync:!0}),HK=t=>({options:{...mke(t),...t}}),mke=({input:t,inputFile:e,stdio:r})=>t===void 0&&e===void 0&&r===void 0?{stdin:"inherit"}:{},GK={preferLocal:!0}});var klt,Ye,Elt,Alt,Tlt,Olt,Rlt,Ilt,Plt,Clt,Mr=y(()=>{MK();UK();BR();ZK();TI();klt=ms(()=>({})),Ye=ms(()=>({isSync:!0})),Elt=ms(FK),Alt=ms(LK),Tlt=ms(aV),Olt=ms(BK,{},GK,qK),{sendMessage:Rlt,getOneMessage:Ilt,getEachMessage:Plt,getCancelSignal:Clt}=S3()});import{existsSync as vv,statSync as hke}from"node:fs";import{dirname as fP,extname as gke,isAbsolute as VK,join as pP,relative as mP,resolve as Sv,sep as yke}from"node:path";function wv(t){return t==="./gradlew"||t==="gradle"}function _ke(t){return(vv(pP(t,"build.gradle.kts"))||vv(pP(t,"build.gradle")))&&vv(pP(t,"gradle.properties"))}function bke(t,e){let n=mP(t,e).split(yke).filter(Boolean);return n.length===0?":":`:${n.join(":")}`}function hs(t,e){return t===":"?`:${e}`:`${t}:${e}`}function vke(t,e){let r=Sv(t,e),n=r;vv(r)?hke(r).isFile()&&(n=fP(r)):gke(r)!==""&&(n=fP(r));let i=mP(t,n);if(i.startsWith("..")||VK(i))return null;let o=n;for(;;){if(_ke(o))return o;if(Sv(o)===Sv(t))return null;let s=fP(o);if(s===o)return null;let a=mP(t,s);if(a.startsWith("..")||VK(a))return null;o=s}}function xv(t,e){let r=Sv(t),n=new Map,i=[];for(let o of e){let s=vke(r,o);if(!s){i.push(o);continue}let a=bke(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 $v=y(()=>{"use strict"});import{existsSync as gP,readFileSync as Ske}from"node:fs";import{join as Ml}from"node:path";function Fl(t="."){let e=Ml(t,".cladding","config.yaml");if(!gP(e))return hP;try{let n=(0,WK.parse)(Ske(e,"utf8"))?.gate;if(!n)return hP;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 wke){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 hP}}function KK(t="."){let e=Fl(t).testReport,r=e?[e,...yP]:yP;return[...new Set(r.map(n=>Ml(t,n)))]}function JK(t="."){let e=Fl(t).testReport;if(e){let r=Ml(t,e);return gP(r)?r:null}return yP.map(r=>Ml(t,r)).find(r=>gP(r))??null}function YK(t,e){let r=[],n=!1;for(let i of t){let o=xke.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 WK,wke,hP,yP,xke,dp=y(()=>{"use strict";WK=St(Qt(),1);$v();wke=["type","lint","test","coverage"],hP={scope:"feature"},yP=["test-report.junit.xml",Ml("coverage","junit.xml"),Ml(".cladding","test-report.junit.xml")];xke=/^\{modules:([A-Za-z0-9_.:-]+)\}$/});import{existsSync as bP,readFileSync as XK,readdirSync as $ke,statSync as kke}from"node:fs";import{join as kv}from"node:path";function wP(t){for(let e of["build.gradle.kts","build.gradle","gradle.properties"]){let r=kv(t,e);if(bP(r))try{if(QK.test(XK(r,"utf8")))return!0}catch{}}return!1}function eJ(t){try{return bP(t)&&QK.test(XK(t,"utf8"))}catch{return!1}}function tJ(t,e=0){if(e>4||!bP(t))return!1;let r;try{r=$ke(t)}catch{return!1}for(let n of r){let i=kv(t,n),o=!1;try{o=kke(i).isDirectory()}catch{continue}if(o){if(n==="build"||n===".gradle"||n==="node_modules")continue;if(tJ(i,e+1))return!0}else if(/\.(kts|gradle|toml)$/.test(n)&&eJ(i))return!0}return!1}function Tke(t){if(wP(t))return!0;for(let e of Eke)if(eJ(kv(t,e)))return!0;for(let e of Ake)if(tJ(kv(t,e)))return!0;return!1}function rJ(t="."){let e=Fl(t).coverage;return e||(Tke(t)?"kover":"jacoco")}function nJ(t="."){return vP[rJ(t)]}function iJ(t="."){return _P[rJ(t)]}var vP,_P,SP,QK,Eke,Ake,Ev=y(()=>{"use strict";dp();vP={kover:"koverXmlReport",jacoco:"jacocoTestReport"},_P={kover:"build/reports/kover/report.xml",jacoco:"build/reports/jacoco/test/jacocoTestReport.xml"},SP=[_P.kover,_P.jacoco],QK=/kover/i;Eke=["build.gradle.kts","build.gradle","settings.gradle.kts","settings.gradle","gradle/libs.versions.toml"],Ake=["buildSrc","build-logic"]});import{existsSync as pp,readFileSync as sJ,readdirSync as aJ}from"node:fs";import{join as gs}from"node:path";function $P(t){return pp(gs(t,"gradlew"))?"./gradlew":"gradle"}function Oke(t){let e=$P(t);return{type:{cmd:e,args:["compileKotlin","compileTestKotlin"]},lint:{cmd:e,args:["ktlintCheck"]},test:{cmd:e,args:["test"]},coverage:{cmd:e,args:[nJ(t)]},secret:{cmd:"gitleaks",args:["detect","--no-banner"]}}}function Rke(t){let e=!1;try{e=/(^|\n)\s*flutter\s*:|sdk:\s*flutter/.test(sJ(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 Pke(t,e){let r=[t],n=0,i=4e3;for(;r.length>0&&na.name.endsWith(c)))return!0}return!1}function Nke(t,e){for(let r of e)if(pp(gs(t,r)))return r}function jke(t,e){try{return aJ(t).find(n=>n.endsWith(e))}catch{return}}function Lke(t){try{return JSON.parse(sJ(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 oJ(t,e){return[t.dependencies,t.devDependencies,t.optionalDependencies,t.peerDependencies].some(r=>r?.[e]!==void 0)}function zke(t,e,r){if(fp(r,"lint"))return{cmd:"npm",args:["run","--silent","lint"]};for(let n of Mke)if(n.configs.some(i=>pp(gs(t,i))))return n.gate;if(Fke.some(n=>pp(gs(t,n)))||r.eslintConfig!==void 0)return e}function qke(t,e){return Uke.some(r=>pp(gs(t,r)))?!0:e.jest!==void 0}function Bke(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 xP(t,e){let r={...t};return e==="lint"?delete r.lint:delete r.coverage,r}function Hke(t,e){let r=Lke(t),n=e.lint?zke(t,e.lint,r):void 0,i=n?{...e,lint:n}:xP(e,"lint"),o=fp(r,"test"),s=o?Bke(o):void 0;return o&&!s?(i=xP(i,"coverage"),{...i,test:{cmd:"npm",args:["test"]},...fp(r,"coverage")?{coverage:{cmd:"npm",args:["run","--silent","coverage"]}}:{}}):s==="jest"||!o&&qke(t,r)?{...i,test:{cmd:"npx",args:[...Ni,"jest"]},coverage:{cmd:"npx",args:[...Ni,"jest","--coverage"]}}:(s==="vitest"&&!fp(r,"coverage")&&!oJ(r,"@vitest/coverage-v8")&&!oJ(r,"@vitest/coverage-istanbul")?i=xP(i,"coverage"):s==="vitest"&&fp(r,"coverage")&&(i={...i,coverage:{cmd:"npm",args:["run","--silent","coverage"]}}),i)}function dt(t="."){for(let e of Cke){let r;for(let o of e.manifests)if(o.startsWith(".")?r=jke(t,o):r=Nke(t,[o]),r)break;if(!r||e.requiresSource&&!Pke(t,e.requiresSource))continue;let n=typeof e.gates=="function"?e.gates(t):e.gates,i=e.language==="typescript"?Hke(t,n):n;return{language:e.language,manifest:r,gates:i}}return Dke}var Ni,Ike,Cke,Dke,Mke,Fke,Uke,on=y(()=>{"use strict";Ev();Ni=["--offline","--no-install"];Ike=new Set(["node_modules",".git",".gradle",".idea","build","target","dist","out",".cladding"]);Cke=[{language:"typescript",manifests:["package.json"],gates:{type:{cmd:"npx",args:[...Ni,"tsc","--noEmit"]},lint:{cmd:"npx",args:[...Ni,"eslint","."]},test:{cmd:"npx",args:[...Ni,"vitest","run"]},coverage:{cmd:"npx",args:[...Ni,"vitest","run","--coverage"]},secret:{cmd:"npx",args:[...Ni,"secretlint","**/*"]},arch:{cmd:"npx",args:[...Ni,"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:Oke},{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:Rke}],Dke={language:"unknown",manifest:"",gates:{}};Mke=[{configs:["biome.json","biome.jsonc"],gate:{cmd:"npx",args:[...Ni,"biome","lint","."]}},{configs:[".oxlintrc.json",".oxlintrc.jsonc","oxlint.config.ts"],gate:{cmd:"npx",args:[...Ni,"oxlint"]}}],Fke=["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"];Uke=["jest.config.js","jest.config.ts","jest.config.mjs","jest.config.cjs","jest.config.json"]});import{existsSync as Gke,readFileSync as Zke}from"node:fs";import{join as Vke}from"node:path";function za(t){return t.code==="ENOENT"}function Av(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 cJ.test(o)||cJ.test(s)?[{detector:e,severity:"info",message:n(a)}]:[{detector:e,severity:"error",message:r(a)}]}function qt(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 tr(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 Ll(t,e){let r=Vke(t,"package.json");if(!Gke(r))return!1;try{return!!JSON.parse(Zke(r,"utf8")).scripts?.[e]}catch{return!1}}var cJ,On=y(()=>{"use strict";cJ=/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 Wke(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.arch;if(!n)return[{detector:Tv,severity:"info",message:`no architecture validator registered for language '${r.language}' (compiler may already enforce acyclic imports)`}];let i=Ye(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Tv,severity:"info",message:`architecture validator '${n.cmd}' not installed`}]:Av(i,Tv,o=>`${n.cmd} reported architecture violations: ${o}`,o=>`${n.cmd} could not validate (config/setup gap, not a violation): ${o}`)}var Tv,Ua,Ov=y(()=>{"use strict";Mr();on();On();Tv="ARCHITECTURE_VIOLATION";Ua={name:Tv,subprocess:!0,run:Wke}});function Kke(t){let{cwd:e="."}=t,r=dt(e),n=r.gates.secret;if(!n)return[{detector:Rv,severity:"info",message:`no secret scanner registered for language '${r.language}'`}];let i=Ye(n.cmd,[...n.args],{cwd:e,reject:!1});return za(i)?[{detector:Rv,severity:"info",message:`secret scanner '${n.cmd}' not installed`}]:Av(i,Rv,o=>`${n.cmd} reported secrets: ${o}`,o=>`${n.cmd} could not scan (config/setup gap, not a secret): ${o}`)}var Rv,qa,Iv=y(()=>{"use strict";Mr();on();On();Rv="HARDCODED_SECRET";qa={name:Rv,subprocess:!0,run:Kke}});import{existsSync as kP,readdirSync as lJ}from"node:fs";import{join as Pv}from"node:path";function Yke(t,e){let r=Pv(t,e.path);if(!kP(r))return!0;if(e.isDirectory)try{return lJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml")).length===0}catch{return!0}return!1}function Xke(t){let{cwd:e="."}=t,r=[];for(let i of Jke)Yke(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=Pv(e,"spec.yaml");if(kP(n)){let i=tEe(n),o=i?null:Qke(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=eEe(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 Qke(t){for(let e of["spec/features","spec/scenarios"]){let r=Pv(t,e);if(!kP(r))continue;let n;try{n=lJ(r).filter(i=>i.endsWith(".yaml")||i.endsWith(".yml"))}catch{continue}for(let i of[...n].sort())try{Ai(Pv(r,i))}catch(o){return{path:`${e}/${i}`,reason:o.message}}}return null}function eEe(t){try{return H(t),null}catch(e){return e.message}}function tEe(t){let e;try{e=Ai(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,Jke,uJ,dJ=y(()=>{"use strict";Be();j_();mp="ABSENCE_OF_GOVERNANCE",Jke=[{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}];uJ={name:mp,run:Xke}});function Cv(t){let e=t.trim().match(/^(\S+)/);return e?e[1].toLowerCase():""}function EP(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=Cv(r)==="while",o=nEe.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 '${Cv(r)}'`}let n=rEe[t];return r.length===0?`ears='${t}' requires condition starting with '${n}' \u2014 empty`:Cv(r)!==n?`ears='${t}' requires condition to start with '${n}' \u2014 got '${Cv(r)}'`:null}function iEe(t,e){let r=EP(e.ears,e.condition);return r?[{featureId:t.id,acId:e.id,pattern:e.ears??"unspecified",message:r}]:[]}function fJ(t){let e=[];for(let r of t)for(let n of r.acceptance_criteria??[])e.push(...iEe(r,n));return e}var rEe,nEe,AP=y(()=>{"use strict";rEe={event:"when",state:"while",optional:"where",unwanted:"if"},nEe=/\bwhen\b/i});function ge(t,e,r){let n;try{n=H(t)}catch(i){return[{detector:e,severity:"info",message:`spec.yaml not loaded: ${i.message}`}]}return r(n)}var wt=y(()=>{"use strict";Be()});function oEe(t){let{cwd:e="."}=t;return ge(e,Dv,sEe)}function sEe(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:Dv,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 fJ(t.features))e.push({detector:Dv,severity:"error",message:`${r.featureId}.${r.acId} EARS: ${r.message}`});return e}var Dv,pJ,mJ=y(()=>{"use strict";AP();wt();Dv="AC_DRIFT";pJ={name:Dv,run:oEe}});function ji(t=".",e){let n=(e??"").trim().toLowerCase()||dt(t).language;return gJ[n]??hJ}var aEe,cEe,lEe,hJ,uEe,dEe,gJ,fEe,yJ,Ba=y(()=>{"use strict";on();aEe=/(?:import\s+(?:[\s\S]*?\sfrom\s+)?|import\s*\()['"]([^'"]+)['"]\)?/g,cEe=/^[ \t]*import\s+([\w.]+)/gm,lEe=/^[ \t]*(?:from|import)\s+([\w.]+)/gm,hJ={ext:"ts",extensions:[".ts",".tsx"],sourceRoots:["src"],mainRoot:"src",testGlobs:["tests/**/*.test.ts"],coverageSummary:"coverage/coverage-summary.json",coverageFormat:"istanbul-json",importMatcher:aEe,importStyle:"relative"},uEe={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:cEe,importStyle:"dotted"},dEe={ext:"py",extensions:[".py"],sourceRoots:["."],mainRoot:"src",testGlobs:["tests/test_*.py","tests/**/test_*.py","tests/**/*_test.py"],coverageSummary:"coverage.xml",coverageFormat:"cobertura-xml",importMatcher:lEe,importStyle:"dotted"},gJ={typescript:hJ,kotlin:uEe,python:dEe},fEe=[".js",".jsx",".mts",".cts",".rs",".go",".java",".rb",".php",".cs",".fs",".ex",".exs"],yJ=new Set([...Object.values(gJ).flatMap(t=>t?.extensions??[]),...fEe].map(t=>t.toLowerCase()))});import{existsSync as pEe,readFileSync as mEe,readdirSync as hEe,statSync as gEe}from"node:fs";import{join as bJ,relative as _J}from"node:path";function yEe(t,e){if(!pEe(t))return[];let r=[],n=[t];for(;n.length>0;){let i=n.pop(),o;try{o=hEe(i)}catch{continue}for(let s of o){if(s==="node_modules"||s===".cladding"||s.startsWith("."))continue;let a=bJ(i,s),c;try{c=gEe(a)}catch{continue}c.isDirectory()?n.push(a):e.some(l=>s.endsWith(l))&&r.push(a)}}return r}function _Ee(t){let e=t.trim();return e.startsWith("//")||e.startsWith("/*")||e.startsWith("*")}function vEe(t){return bEe.test(t)}function SEe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=r.project.ai_hints?.forbidden_patterns;if(!n||n.length===0)return[];let i=ji(e,r.project?.language),o=i.sourceRoots.flatMap(a=>yEe(bJ(e,a),i.extensions));if(o.length===0)return[];let s=[];for(let a of o){let c;try{c=mEe(a,"utf8")}catch{continue}let l=c.split(` +`);for(let u=0;u{"use strict";Be();Ba();vJ="AI_HINTS_FORBIDDEN_PATTERN";bEe=/\/\/\s*cladding-disable[:\s]+AI_HINTS_FORBIDDEN_PATTERN\b/;SJ={name:vJ,run:SEe}});function wEe(t){let{cwd:e="."}=t,r;try{r=H(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:xJ,severity:"error",message:`${i.id}.${a} appears ${c} times \u2014 AC ids must be unique within a feature`})}return n}var xJ,$J,kJ=y(()=>{"use strict";Be();xJ="AC_DUPLICATE_WITHIN_FEATURE";$J={name:xJ,run:wEe}});import{createRequire as xEe}from"module";import{basename as $Ee,dirname as OP,normalize as kEe,relative as EEe,resolve as AEe,sep as TJ}from"path";import*as TEe from"fs";function OEe(t){let e=kEe(t);return e.length>1&&e[e.length-1]===TJ&&(e=e.substring(0,e.length-1)),e}function OJ(t,e){return t.replace(REe,e)}function PEe(t){return t==="/"||IEe.test(t)}function TP(t,e){let{resolvePaths:r,normalizePath:n,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(r&&(t=AEe(t)),(n||o)&&(t=OEe(t)),t===".")return"";let s=t[t.length-1]!==i;return OJ(s?t+i:t,i)}function RJ(t,e){return e+t}function CEe(t,e){return function(r,n){return n.startsWith(t)?n.slice(t.length)+r:OJ(EEe(t,n),e.pathSeparator)+e.pathSeparator+r}}function DEe(t){return t}function NEe(t,e,r){return e+t+r}function jEe(t,e){let{relativePaths:r,includeBasePath:n}=e;return r&&t?CEe(t,e):n?RJ:DEe}function MEe(t){return function(e,r){r.push(e.substring(t.length)||".")}}function FEe(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?FEe(t):MEe(t):n&&n.length?zEe:LEe:UEe}function WEe(t){let{excludeFiles:e,filters:r,onlyCounts:n}=t;return e?VEe:r&&r.length?n?BEe:HEe:n?GEe:ZEe}function YEe(t){return t.group?JEe:KEe}function eAe(t){return t.group?XEe:QEe}function nAe(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?rAe:tAe}function IJ(t,e,r){if(r.options.useRealPaths)return iAe(e,r);let n=OP(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=OP(n)}return r.symlinks.set(t,e),i>1}function iAe(t,e){return e.visited.includes(t+e.options.pathSeparator)}function Nv(t,e,r,n){e(t&&!n?t:null,r)}function pAe(t,e){let{onlyCounts:r,group:n,maxFiles:i}=t;return r?e?oAe:lAe:n?e?sAe:fAe:i?e?cAe:dAe:e?aAe:uAe}function gAe(t){return t?hAe:mAe}function vAe(t,e){return new Promise((r,n)=>{DJ(t,e,(i,o)=>{if(i)return n(i);r(o)})})}function DJ(t,e,r){new CJ(t,e,r).start()}function SAe(t,e){return new CJ(t,e).start()}var EJ,REe,IEe,LEe,zEe,UEe,BEe,HEe,GEe,ZEe,VEe,KEe,JEe,XEe,QEe,tAe,rAe,oAe,sAe,aAe,cAe,lAe,uAe,dAe,fAe,PJ,mAe,hAe,yAe,_Ae,bAe,CJ,AJ,NJ,jJ,MJ=y(()=>{EJ=xEe(import.meta.url);REe=/[\\/]/g;IEe=/^[a-z]:[\\/]$/i;LEe=(t,e)=>{e.push(t||".")},zEe=(t,e,r)=>{let n=t||".";r.every(i=>i(n,!0))&&e.push(n)},UEe=()=>{};BEe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&r.files++},HEe=(t,e,r,n)=>{n.every(i=>i(t,!1))&&e.push(t)},GEe=(t,e,r,n)=>{r.files++},ZEe=(t,e)=>{e.push(t)},VEe=()=>{};KEe=t=>t,JEe=()=>[""].slice(0,0);XEe=(t,e,r)=>{t.push({directory:e,files:r,dir:e})},QEe=()=>{};tAe=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()&&IJ(t,a,e))return n.dequeue(null,e);r(l,a),n.dequeue(null,e)})})},rAe=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()&&IJ(t,s,e))return;r(a,s)}catch(s){if(!o)throw s}};oAe=t=>t.counts,sAe=t=>t.groups,aAe=t=>t.paths,cAe=t=>t.paths.slice(0,t.options.maxFiles),lAe=(t,e,r)=>(Nv(e,r,t.counts,t.options.suppressErrors),null),uAe=(t,e,r)=>(Nv(e,r,t.paths,t.options.suppressErrors),null),dAe=(t,e,r)=>(Nv(e,r,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),fAe=(t,e,r)=>(Nv(e,r,t.groups,t.options.suppressErrors),null);PJ={withFileTypes:!0},mAe=(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||".",PJ,(s,a=[])=>{i(a,r,n),t.queue.dequeue(t.options.suppressErrors?null:s,t)})},hAe=(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||".",PJ)}catch(a){if(!t.options.suppressErrors)throw a}i(s,r,n)};yAe=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))}},_Ae=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}},bAe=class{aborted=!1;abort(){this.aborted=!0}},CJ=class{root;isSynchronous;state;joinPath;pushDirectory;pushFile;getArray;groupFiles;resolveSymlink;walkDirectory;callbackInvoker;constructor(t,e,r){this.isSynchronous=!r,this.callbackInvoker=pAe(e,this.isSynchronous),this.root=TP(t,e),this.state={root:PEe(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new _Ae,options:e,queue:new yAe((n,i)=>this.callbackInvoker(i,n,r)),symlinks:new Map,visited:[""].slice(0,0),controller:new bAe,fs:e.fs||TEe},this.joinPath=jEe(this.root,e),this.pushDirectory=qEe(this.root,e),this.pushFile=WEe(e),this.getArray=YEe(e),this.groupFiles=eAe(e),this.resolveSymlink=nAe(e,this.isSynchronous),this.walkDirectory=gAe(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(_=TP(_,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=$Ee(_),x=TP(OP(_),this.state.options);_=this.joinPath(S,x),this.pushFile(_,p,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,p)}};AJ=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return vAe(this.root,this.options)}withCallback(t){DJ(this.root,this.options,t)}sync(){return SAe(this.root,this.options)}},NJ=null;try{EJ.resolve("picomatch"),NJ=EJ("picomatch")}catch{}jJ=class{globCache={};options={maxDepth:1/0,suppressErrors:!0,pathSeparator:TJ,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 AJ(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options={...this.options,...e},new AJ(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let r=this.globFunction||NJ;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((jut,qJ)=>{"use strict";var FJ="[^\\\\/]",wAe="(?=.)",LJ="[^/]",RP="(?:\\/|$)",zJ="(?:^|\\/)",IP=`\\.{1,2}${RP}`,xAe="(?!\\.)",$Ae=`(?!${zJ}${IP})`,kAe=`(?!\\.{0,1}${RP})`,EAe=`(?!${IP})`,AAe="[^.\\/]",TAe=`${LJ}*?`,OAe="/",UJ={DOT_LITERAL:"\\.",PLUS_LITERAL:"\\+",QMARK_LITERAL:"\\?",SLASH_LITERAL:"\\/",ONE_CHAR:wAe,QMARK:LJ,END_ANCHOR:RP,DOTS_SLASH:IP,NO_DOT:xAe,NO_DOTS:$Ae,NO_DOT_SLASH:kAe,NO_DOTS_SLASH:EAe,QMARK_NO_DOT:AAe,STAR:TAe,START_ANCHOR:zJ,SEP:OAe},RAe={...UJ,SLASH_LITERAL:"[\\\\/]",QMARK:FJ,STAR:`${FJ}*?`,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:"\\"},IAe={__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"};qJ.exports={DEFAULT_MAX_EXTGLOB_RECURSION:0,MAX_LENGTH:1024*64,POSIX_REGEX_SOURCE:IAe,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?RAe:UJ}}});var gp=v(Fr=>{"use strict";var{REGEX_BACKSLASH:PAe,REGEX_REMOVE_BACKSLASH:CAe,REGEX_SPECIAL_CHARS:DAe,REGEX_SPECIAL_CHARS_GLOBAL:NAe}=hp();Fr.isObject=t=>t!==null&&typeof t=="object"&&!Array.isArray(t);Fr.hasRegexChars=t=>DAe.test(t);Fr.isRegexChar=t=>t.length===1&&Fr.hasRegexChars(t);Fr.escapeRegex=t=>t.replace(NAe,"\\$1");Fr.toPosixSlashes=t=>t.replace(PAe,"/");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(CAe,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 JJ=v((Fut,KJ)=>{"use strict";var BJ=gp(),{CHAR_ASTERISK:PP,CHAR_AT:jAe,CHAR_BACKWARD_SLASH:yp,CHAR_COMMA:MAe,CHAR_DOT:CP,CHAR_EXCLAMATION_MARK:DP,CHAR_FORWARD_SLASH:WJ,CHAR_LEFT_CURLY_BRACE:NP,CHAR_LEFT_PARENTHESES:jP,CHAR_LEFT_SQUARE_BRACKET:FAe,CHAR_PLUS:LAe,CHAR_QUESTION_MARK:HJ,CHAR_RIGHT_CURLY_BRACE:zAe,CHAR_RIGHT_PARENTHESES:GJ,CHAR_RIGHT_SQUARE_BRACKET:UAe}=hp(),ZJ=t=>t===WJ||t===yp,VJ=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,ie=()=>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&&ZJ(xe.charCodeAt(xe.length-1))&&(xe=xe.slice(0,-1)),r.unescape===!0&&(P&&(P=BJ.removeBackslashes(P)),xe&&_===!0&&(xe=BJ.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,ZJ(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(),sn=gp(),{MAX_LENGTH:jv,POSIX_REGEX_SOURCE:BAe,REGEX_NON_SPECIAL_CHARS:HAe,REGEX_SPECIAL_CHARS_BACKREF:GAe,REPLACEMENTS:YJ}=_p,ZAe=(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=>sn.escapeRegex(i)).join("..")}return r},zl=(t,e)=>`Missing ${t}: "${e}" - use "\\\\${e}" to match literal characters`,XJ=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},VAe=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},QJ=t=>{let e=t.trim(),r=!0;for(;r===!0;)r=!1,/^@\([^\\()[\]{}|]+\)$/.test(e)&&(e=e.slice(2,-1),r=!0);if(VAe(e))return e.replace(/\\(.)/g,"$1")},WAe=t=>{let e=t.map(QJ).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}}}}},KAe=t=>{let e=0,r=[];for(;ea.trim());if(o.length!==1)return;let s=QJ(o[0]);if(!s||s.length!==1)return;r.push(s),e+=i.end+1}return r.length<1?void 0:`${r.length===1?sn.escapeRegex(r[0]):`[${r.map(i=>sn.escapeRegex(i)).join("")}]`}*`},JAe=t=>{let e=0,r=t.trim(),n=MP(r);for(;n;)e++,r=n.body.trim(),n=MP(r);return e},YAe=(t,e)=>{if(e.maxExtglobRecursion===!1)return{risky:!1};let r=typeof e.maxExtglobRecursion=="number"?e.maxExtglobRecursion:_p.DEFAULT_MAX_EXTGLOB_RECURSION,n=XJ(t).map(i=>i.trim());if(n.length>1&&(n.some(i=>i==="")||n.some(i=>/^[*?]+$/.test(i))||WAe(n)))return{risky:!0};for(let i of n){let o=KAe(i);if(o)return{risky:!0,safeOutput:o};if(JAe(i)>r)return{risky:!0}}return{risky:!1}},FP=(t,e)=>{if(typeof t!="string")throw new TypeError("Expected a string");t=YJ[t]||t;let r={...e},n=typeof r.maxLength=="number"?Math.min(jv,r.maxLength):jv,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=B=>`(${a}(?:(?!${w}${B.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=sn.removePrefix(t,$),i=t.length;let ie=[],K=[],xe=[],C=o,P,Ir=()=>$.index===i-1,se=$.peek=(B=1)=>t[$.index+B],Ce=$.advance=()=>t[++$.index]||"",Kt=()=>t.slice($.index+1),dr=(B="",ht=0)=>{$.consumed+=B,$.index+=ht},Yt=B=>{$.output+=B.output!=null?B.output:B.value,dr(B.value)},co=()=>{let B=1;for(;se()==="!"&&(se(2)!=="("||se(3)==="?");)Ce(),$.start++,B++;return B%2===0?!1:($.negated=!0,$.start++,!0)},wi=B=>{$[B]++,xe.push(B)},Yr=B=>{$[B]--,xe.pop()},de=B=>{if(C.type==="globstar"){let ht=$.braces>0&&(B.type==="comma"||B.type==="brace"),q=B.extglob===!0||ie.length&&(B.type==="pipe"||B.type==="paren");B.type!=="slash"&&B.type!=="paren"&&!ht&&!q&&($.output=$.output.slice(0,-C.output.length),C.type="star",C.value="*",C.output=D,$.output+=C.output)}if(ie.length&&B.type!=="paren"&&(ie[ie.length-1].inner+=B.value),(B.value||B.output)&&Yt(B),C&&C.type==="text"&&B.type==="text"){C.output=(C.output||C.value)+B.value,C.value+=B.value;return}B.prev=C,s.push(B),C=B},lo=(B,ht)=>{let q={...l[ht],conditions:1,inner:""};q.prev=C,q.parens=$.parens,q.output=$.output,q.startIndex=$.index,q.tokensIndex=s.length;let Oe=(r.capture?"(":"")+q.open;wi("parens"),de({type:B,value:ht,output:$.output?"":p}),de({type:"paren",extglob:!0,value:Ce(),output:Oe}),ie.push(q)},Ode=B=>{let ht=t.slice(B.startIndex,$.index+1),q=t.slice(B.startIndex+2,$.index),Oe=YAe(q,r);if((B.type==="plus"||B.type==="star")&&Oe.risky){let lt=Oe.safeOutput?(B.output?"":p)+(r.capture?`(${Oe.safeOutput})`:Oe.safeOutput):void 0,xi=s[B.tokensIndex];xi.type="text",xi.value=ht,xi.output=lt||sn.escapeRegex(ht);for(let $i=B.tokensIndex+1;$i1&&B.inner.includes("/")&&(lt=O(r)),(lt!==D||Ir()||/^\)+$/.test(Kt()))&&(ut=B.close=`)$))${lt}`),B.inner.includes("*")&&(Lt=Kt())&&/^\.[^\\/.]+$/.test(Lt)){let xi=FP(Lt,{...e,fastpaths:!1}).output;ut=B.close=`)${xi})${lt})`}B.prev.type==="bos"&&($.negatedExtglob=!0)}de({type:"paren",extglob:!0,value:P,output:ut}),Yr("parens")};if(r.fastpaths!==!1&&!/(^[*!]|[/()[\]{}"])/.test(t)){let B=!1,ht=t.replace(GAe,(q,Oe,ut,Lt,lt,xi)=>Lt==="\\"?(B=!0,q):Lt==="?"?Oe?Oe+Lt+(lt?_.repeat(lt.length):""):xi===0?A+(lt?_.repeat(lt.length):""):_.repeat(ut.length):Lt==="."?u.repeat(ut.length):Lt==="*"?Oe?Oe+Lt+(lt?D:""):D:Oe?q:`\\${q}`);return B===!0&&(r.unescape===!0?ht=ht.replace(/\\/g,""):ht=ht.replace(/\\+/g,q=>q.length%2===0?"\\\\":q?"\\":"")),ht===t&&r.contains===!0?($.output=t,$):($.output=sn.wrapOutput(ht,$,e),$)}for(;!Ir();){if(P=Ce(),P==="\0")continue;if(P==="\\"){let q=se();if(q==="/"&&r.bash!==!0||q==="."||q===";")continue;if(!q){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 q=C.value.slice(1);if(q.includes("[")&&(C.posix=!0,q.includes(":"))){let Oe=C.value.lastIndexOf("["),ut=C.value.slice(0,Oe),Lt=C.value.slice(Oe+2),lt=BAe[Lt];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,Yt({value:P});continue}if($.quotes===1&&P!=='"'){P=sn.escapeRegex(P),C.value+=P,Yt({value:P});continue}if(P==='"'){$.quotes=$.quotes===1?0:1,r.keepQuotes===!0&&de({type:"text",value:P});continue}if(P==="("){wi("parens"),de({type:"paren",value:P});continue}if(P===")"){if($.parens===0&&r.strictBrackets===!0)throw new SyntaxError(zl("opening","("));let q=ie[ie.length-1];if(q&&$.parens===q.parens+1){Ode(ie.pop());continue}de({type:"paren",value:P,output:$.parens?")":"\\)"}),Yr("parens");continue}if(P==="["){if(r.nobracket===!0||!Kt().includes("]")){if(r.nobracket!==!0&&r.strictBrackets===!0)throw new SyntaxError(zl("closing","]"));P=`\\${P}`}else wi("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(zl("opening","["));de({type:"text",value:P,output:`\\${P}`});continue}Yr("brackets");let q=C.value.slice(1);if(C.posix!==!0&&q[0]==="^"&&!q.includes("/")&&(P=`/${P}`),C.value+=P,Yt({value:P}),r.literalBrackets===!1||sn.hasRegexChars(q))continue;let Oe=sn.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){wi("braces");let q={type:"brace",value:P,output:"(",outputIndex:$.output.length,tokensIndex:$.tokens.length};K.push(q),de(q);continue}if(P==="}"){let q=K[K.length-1];if(r.nobrace===!0||!q){de({type:"text",value:P,output:P});continue}let Oe=")";if(q.dots===!0){let ut=s.slice(),Lt=[];for(let lt=ut.length-1;lt>=0&&(s.pop(),ut[lt].type!=="brace");lt--)ut[lt].type!=="dots"&&Lt.unshift(ut[lt].value);Oe=ZAe(Lt,r),$.backtrack=!0}if(q.comma!==!0&&q.dots!==!0){let ut=$.output.slice(0,q.outputIndex),Lt=$.tokens.slice(q.tokensIndex);q.value=q.output="\\{",P=Oe="\\}",$.output=ut;for(let lt of Lt)$.output+=lt.output||lt.value}de({type:"brace",value:P,output:Oe}),Yr("braces"),K.pop();continue}if(P==="|"){ie.length>0&&ie[ie.length-1].conditions++,de({type:"text",value:P});continue}if(P===","){let q=P,Oe=K[K.length-1];Oe&&xe[xe.length-1]==="braces"&&(Oe.comma=!0,q="|"),de({type:"comma",value:P,output:q});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 q=K[K.length-1];C.type="dots",C.output+=P,C.value+=P,q.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)!=="?"){lo("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)))){lo("negate",P);continue}if(r.nonegate!==!0&&$.index===0){co();continue}}if(P==="+"){if(r.noextglob!==!0&&se()==="("&&se(2)!=="?"){lo("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 q=HAe.exec(Kt());q&&(P+=q[0],$.index+=q[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 B=Kt();if(r.noextglob!==!0&&/^\([^?]/.test(B)){lo("star",P);continue}if(C.type==="star"){if(r.noglobstar===!0){dr(P);continue}let q=C.prev,Oe=q.prev,ut=q.type==="slash"||q.type==="bos",Lt=Oe&&(Oe.type==="star"||Oe.type==="globstar");if(r.bash===!0&&(!ut||B[0]&&B[0]!=="/")){de({type:"star",value:P,output:""});continue}let lt=$.braces>0&&(q.type==="comma"||q.type==="brace"),xi=ie.length&&(q.type==="pipe"||q.type==="paren");if(!ut&&q.type!=="paren"&&!lt&&!xi){de({type:"star",value:P,output:""});continue}for(;B.slice(0,3)==="/**";){let $i=t[$.index+4];if($i&&$i!=="/")break;B=B.slice(3),dr("/**",3)}if(q.type==="bos"&&Ir()){C.type="globstar",C.value+=P,C.output=O(r),$.output=C.output,$.globstar=!0,dr(P);continue}if(q.type==="slash"&&q.prev.type!=="bos"&&!Lt&&Ir()){$.output=$.output.slice(0,-(q.output+C.output).length),q.output=`(?:${q.output}`,C.type="globstar",C.output=O(r)+(r.strictSlashes?")":"|$)"),C.value+=P,$.globstar=!0,$.output+=q.output+C.output,dr(P);continue}if(q.type==="slash"&&q.prev.type!=="bos"&&B[0]==="/"){let $i=B[1]!==void 0?"|$":"";$.output=$.output.slice(0,-(q.output+C.output).length),q.output=`(?:${q.output}`,C.type="globstar",C.output=`${O(r)}${f}|${f}${$i})`,C.value+=P,$.output+=q.output+C.output,$.globstar=!0,dr(P+Ce()),de({type:"slash",value:"/",output:""});continue}if(q.type==="bos"&&B[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(zl("closing","]"));$.output=sn.escapeLast($.output,"["),Yr("brackets")}for(;$.parens>0;){if(r.strictBrackets===!0)throw new SyntaxError(zl("closing",")"));$.output=sn.escapeLast($.output,"("),Yr("parens")}for(;$.braces>0;){if(r.strictBrackets===!0)throw new SyntaxError(zl("closing","}"));$.output=sn.escapeLast($.output,"{"),Yr("braces")}if(r.strictSlashes!==!0&&(C.type==="star"||C.type==="bracket")&&de({type:"maybe_slash",value:"",output:`${f}?`}),$.backtrack===!0){$.output="";for(let B of $.tokens)$.output+=B.output!=null?B.output:B.value,B.suffix&&($.output+=B.suffix)}return $};FP.fastpaths=(t,e)=>{let r={...e},n=typeof r.maxLength=="number"?Math.min(jv,r.maxLength):jv,i=t.length;if(i>n)throw new SyntaxError(`Input length: ${i}, exceeds maximum allowed length: ${n}`);t=YJ[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=sn.removePrefix(t,b),O=x(w);return O&&r.strictSlashes!==!0&&(O+=`${s}?`),O};e8.exports=FP});var i8=v((zut,n8)=>{"use strict";var XAe=JJ(),LP=t8(),r8=gp(),QAe=hp(),eTe=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=eTe(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?r8.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(r8.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)):LP(t,{...e,fastpaths:!1});Rt.scan=(t,e)=>XAe(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=LP.fastpaths(t,e)),i.output||(i=LP(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=QAe;n8.exports=Rt});var c8=v((Uut,a8)=>{"use strict";var o8=i8(),tTe=gp();function s8(t,e,r=!1){return e&&(e.windows===null||e.windows===void 0)&&(e={...e,windows:tTe.isWindows()}),o8(t,e,r)}Object.assign(s8,o8);a8.exports=s8});import{readdir as rTe,readdirSync as nTe,realpath as iTe,realpathSync as oTe,stat as sTe,statSync as aTe}from"fs";import{isAbsolute as cTe,posix as Ha,resolve as lTe}from"path";import{fileURLToPath as uTe}from"url";function pTe(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]===".."&&fTe.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 gTe(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 f8(t){var e;let r=Ul.default.scan(t,yTe);return!((e=r.parts)===null||e===void 0)&&e.length?r.parts:[t]}function xTe(t,e){if(e?.caseSensitiveMatch===!1)return!0;let r=Ul.default.scan(t);return r.isGlob||r.negated}function bp(...t){console.log(`[tinyglobby ${new Date().toLocaleTimeString("es")}]`,...t)}function p8(t){return typeof t=="string"?[t]:t??[]}function zP(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=wTe(o);s=cTe(s.replace(kTe,""))?Ha.relative(a,s):Ha.normalize(s);let c=(i=$Te.exec(s))===null||i===void 0?void 0:i[0],l=f8(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 ETe(t,e,r){let n=[],i=[];for(let o of t.ignore)o&&(o[0]!=="!"||o[1]==="(")&&i.push(zP(o,t,r,!0));for(let o of e)o&&(o[0]!=="!"||o[1]==="("?n.push(zP(o,t,r,!1)):(o[1]!=="!"||o[2]==="(")&&i.push(zP(o.slice(1),t,r,!0)));return{match:n,ignore:i}}function ATe(t,e){let r=t.cwd,n={root:r,depthOffset:0},i=ETe(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(u8,""),f={dot:c,nobrace:t.braceExpansion===!1,nocase:!s,noextglob:t.extglob===!1,noglobstar:t.globstar===!1,posix:!0},p=(0,Ul.default)(i.match,f),m=(0,Ul.default)(i.ignore,f),h=pTe(i.match,f),g=l8(r,d,o),b=o?g:l8(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 jJ({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&&gTe(r,d)]}function TTe(t,e){if(e)for(let r=t.length-1;r>=0;r--)t[r]=e(t[r]);return t}function RTe(t){let e={...OTe,...t};return e.cwd=(e.cwd instanceof URL?uTe(e.cwd):lTe(e.cwd)).replace(u8,"/"),e.ignore=p8(e.ignore),e.fs&&(e.fs={readdir:e.fs.readdir||rTe,readdirSync:e.fs.readdirSync||nTe,realpath:e.fs.realpath||iTe,realpathSync:e.fs.realpathSync||oTe,stat:e.fs.stat||sTe,statSync:e.fs.statSync||aTe}),e.debug&&bp("globbing with options:",e),e}function ITe(t,e={}){var r;if(t&&e?.patterns)throw new Error("Cannot pass patterns as both an argument and an option");let n=dTe(t)||typeof t=="string",i=p8((r=n?t:t.patterns)!==null&&r!==void 0?r:"**/*"),o=RTe(n?e:t);return i.length>0?ATe(o,i):[]}function ys(t,e){let[r,n]=ITe(t,e);return r?TTe(r.sync(),n):[]}var Ul,dTe,u8,d8,fTe,mTe,hTe,yTe,_Te,bTe,vTe,STe,wTe,$Te,kTe,OTe,vp=y(()=>{MJ();Ul=St(c8(),1),dTe=Array.isArray,u8=/\\/g,d8=process.platform==="win32",fTe=/^(\/?\.\.)+$/;mTe=/^[A-Z]:\/$/i,hTe=d8?t=>mTe.test(t):t=>t==="/";yTe={parts:!0};_Te=/(?t.replace(_Te,"\\$&"),STe=t=>t.replace(bTe,"\\$&"),wTe=d8?STe:vTe;$Te=/^(\/?\.\.)+/,kTe=/\\(?=[()[\]{}!*+?@|])/g;OTe={caseSensitiveMatch:!0,cwd:process.cwd(),debug:!!process.env.TINYGLOBBY_DEBUG,expandDirectories:!0,followSymbolicLinks:!0,onlyFiles:!0}});import{existsSync as Sp,readFileSync as PTe,readdirSync as CTe,statSync as m8}from"node:fs";import{join as Ga}from"node:path";function DTe(t){let{cwd:e="."}=t,r,n;try{let c=H(e);r=c.architecture,n=c.project?.language}catch{return[]}if(!r)return[];let i=ji(e,n),o=[],{layers:s,forbiddenImports:a}=UP(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&&(NTe(e,i,s,o),jTe(e,i,s,o)),a.length>0&&MTe(e,i,a,o),o)}function UP(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 NTe(t,e,r,n){let i=e.mainRoot,o=Ga(t,i);if(Sp(o))for(let s of CTe(o)){let a=Ga(o,s);m8(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 jTe(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)&&m8(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 MTe(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=PTe(u,"utf8")}catch{continue}let f;for(o.lastIndex=0;(f=o.exec(d))!==null;){let p=f[1];FTe(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 FTe(t,e,r){return r==="dotted"?t.split(".").includes(e):t.startsWith(".")?t.split("/").includes(e):!1}var wp,h8,qP=y(()=>{"use strict";vp();Be();Ba();wp="ARCHITECTURE_FROM_SPEC";h8={name:wp,run:DTe}});import{existsSync as LTe,readFileSync as zTe}from"node:fs";import{join as UTe}from"node:path";function BTe(t){let{cwd:e="."}=t,r=UTe(e,"spec/capabilities.yaml");if(!LTe(r))return[];let n;try{let u=zTe(r,"utf8"),d=g8.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=H(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";g8=St(Qt(),1);Be();Mv="CAPABILITIES_FEATURE_MAPPING",qTe=8;y8={name:Mv,run:BTe}});import{existsSync as HTe,readFileSync as GTe}from"node:fs";import{join as ZTe}from"node:path";function VTe(t){let e=t.trimStart();return e.startsWith("//")||e.startsWith("/*")}function WTe(t){let{cwd:e="."}=t;return ge(e,BP,r=>KTe(r,e))}function KTe(t,e){let r=ji(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=ZTe(e,o);if(!HTe(s))continue;let a=GTe(s,"utf8");VTe(a)||n.push({detector:BP,severity:"warn",path:o,message:`${o} has no file-header comment \u2014 Why>What guardrail recommends a one-line intent`})}return n}var BP,b8,v8=y(()=>{"use strict";Ba();wt();BP="CONVENTION_DRIFT";b8={name:BP,run:WTe}});import{existsSync as HP,readFileSync as S8}from"node:fs";import{join as Fv}from"node:path";function JTe(t){return JSON.parse(t).total?.lines?.pct??0}function w8(t){let e=/]*\bline-rate="([0-9]*\.?[0-9]+)"/.exec(t);return e?Number(e[1])*100:null}function QTe(t,e){if(!wv(dt(t).gates.coverage?.cmd))return null;let r;try{r=xv(t,e)}catch(c){return[{detector:xo,severity:"error",message:c.message}]}let n=0,i=0,o=0,s=[];for(let c of r){let l=SP.find(d=>HP(Fv(c.dir,d)));if(!l){s.push(c.path);continue}let u=w8(S8(Fv(c.dir,l),"utf8"));u&&(n+=u.missed,i+=u.covered,o++)}if(o===0)return[{detector:xo,severity:"info",message:`no module coverage report present for ${r.map(c=>c.path).join(", ")} \u2014 run stage_2.2 first`}];let a=x8(n,i);return a0?[{detector:xo,severity:"info",message:`module coverage ${a.toFixed(1)}% OK; no report yet for ${s.join(", ")}`}]:[]}function eOe(t){let{cwd:e="."}=t;if(t.focusModules&&t.focusModules.length>0){let a=QTe(e,t.focusModules);if(a)return a}let r;try{r=H(e).project?.language}catch{}let n=ji(e,r),i=dt(e).language==="kotlin"?SP.find(a=>HP(Fv(e,a)))??iJ(e):n.coverageSummary,o=Fv(e,i);if(!HP(o))return[{detector:xo,severity:"info",message:`${i} not present \u2014 run stage_2.2 first`}];let s;try{let a=S8(o,"utf8");s=n.coverageFormat==="jacoco-xml"?YTe(a):n.coverageFormat==="cobertura-xml"?XTe(a):JTe(a)}catch(a){return[{detector:xo,severity:"warn",message:`${i} unparseable: ${a.message}`}]}return s===null?n.coverageFormat==="cobertura-xml"?[]:[{detector:xo,severity:"warn",message:`${i} contained no line-coverage counter`}]:s>=Lv?[]:[{detector:xo,severity:"warn",message:`line coverage ${s.toFixed(1)}% < floor ${Lv}%`}]}var xo,Lv,$8,k8=y(()=>{"use strict";Be();Ev();Ba();$v();on();xo="COVERAGE_DROP",Lv=70;$8={name:xo,run:eOe}});import{existsSync as tOe}from"node:fs";import{join as rOe}from"node:path";function iOe(t){let{cwd:e="."}=t;return ge(e,zv,r=>oOe(r,e))}function oOe(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();zv="DELIVERABLE_INTEGRITY",nOe=8;E8={name:zv,run:iOe}});function sOe(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:Uv,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 aOe(t){let e=sOe(t),r=(t.features??[]).filter(o=>o.status==="done");return r.length===0||!!!t.project?.deliverable||(t.project?.smoke??[]).length>0?e:[...e,{detector:Uv,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 cOe(t){let{cwd:e="."}=t;return ge(e,Uv,r=>aOe(r))}var Uv,T8,O8=y(()=>{"use strict";wt();Uv="SMOKE_PROBE_DEMAND";T8={name:Uv,run:cOe}});function lOe(t){let{cwd:e="."}=t;return ge(e,qv,r=>uOe(r,e))}function uOe(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:qv,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=q_(n,e,o);s.state!=="fresh"&&i.push({detector:qv,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 qv,Bv,GP=y(()=>{"use strict";gl();wt();qv="STALE_ATTESTATION";Bv={name:qv,run:lOe}});function dOe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}return fOe(r)}function fOe(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:R8,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 R8,Hv,ZP=y(()=>{"use strict";Be();R8="DEPENDENCY_CYCLE";Hv={name:R8,run:dOe}});import{appendFileSync as pOe,existsSync as I8,mkdirSync as mOe,readFileSync as hOe}from"node:fs";import{dirname as gOe,join as yOe}from"node:path";function P8(t){return yOe(t,_Oe,bOe)}function C8(t){return VP.add(t),()=>VP.delete(t)}function Za(t,e){let r=P8(t),n=gOe(r);I8(n)||mOe(n,{recursive:!0}),pOe(r,`${JSON.stringify(e)} +`,"utf8");for(let i of VP)try{i(t,e)}catch{}}function Rn(t){let e=P8(t);if(!I8(e))return[];let r=hOe(e,"utf8").trim();return r.length===0?[]:r.split(` +`).filter(n=>n.length>0).map(n=>JSON.parse(n))}var _Oe,bOe,VP,ri=y(()=>{"use strict";_Oe=".cladding",bOe="audit.log.jsonl";VP=new Set});import{existsSync as vOe}from"node:fs";import{join as SOe}from"node:path";function wOe(t){let{cwd:e="."}=t,r=Rn(e);if(r.length===0)return[{detector:WP,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&&(vOe(SOe(e,i.artifact))||n.push({detector:WP,severity:"error",path:i.artifact,message:`evidence ${i.id} references missing artifact '${i.artifact}'`}));return n}var WP,D8,N8=y(()=>{"use strict";ri();WP="EVIDENCE_MISMATCH";D8={name:WP,run:wOe}});import{existsSync as xOe,readFileSync as $Oe}from"node:fs";import{join as kOe}from"node:path";function EOe(t){let e=kOe(t,L8);if(!xOe(e))return null;try{let n=((0,F8.parse)($Oe(e,"utf8"))?.fixtures??[]).map(i=>i.name).filter(Boolean);return new Set(n)}catch{return null}}function*M8(t,e){for(let r of t??[])r.startsWith(j8)&&(yield{ref:r,name:r.slice(j8.length),field:e})}function AOe(t){let{cwd:e="."}=t,r=EOe(e);if(r===null)return[];let n;try{n=H(e)}catch(o){return[{detector:KP,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=[...M8(s.evidence_refs,"evidence_refs"),...M8(s.test_refs,"test_refs")];for(let{ref:c,name:l,field:u}of a)r.has(l)||i.push({detector:KP,severity:"warn",path:L8,message:`${o.id}.${s.id} cites '${c}' in ${u} but no fixture named '${l}' is registered in conformance/fixtures.yaml`})}return i}var F8,KP,j8,L8,z8,U8=y(()=>{"use strict";F8=St(Qt(),1);Be();KP="FIXTURE_REFERENCE_INVALID",j8="fixture:",L8="conformance/fixtures.yaml";z8={name:KP,run:AOe}});import{existsSync as ql,readFileSync as JP}from"node:fs";import{join as Va}from"node:path";function TOe(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(!ql(t))return null;try{return JSON.parse(JP(t,"utf8"))}catch{return null}}function OOe(t,e){let r=Va(t,"plugins","claude-code",".claude-plugin","plugin.json"),n;try{n=JSON.parse(JP(r,"utf8"))}catch(c){e.push({detector:$o,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:$o,severity:"warn",message:`plugin.json current.detectors='${i}' is not in 'N/M' form`});return}let s=Number(o[1]),a=TOe(t);s!==a&&e.push({detector:$o,severity:"error",message:`plugin.json current.detectors='${i}' but stages/detectors/contains ${a} non-index .ts file(s)`})}function ROe(t,e){for(let r of q8){let n=Va(t,r.path);if(!ql(n))continue;let i=xp(n);if(!i){e.push({detector:$o,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:$o,severity:"error",message:`${r.host}: ${r.path} is missing required field '${String(o)}'`})}}function IOe(t,e){let r=xp(Va(t,"package.json"));if(!r?.version)return;let n=r.version;for(let o of q8){let s=Va(t,o.path);if(!ql(s))continue;let a=xp(s);a?.version&&a.version!==n&&e.push({detector:$o,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(ql(i)){let o=xp(i);for(let s of o?.plugins??[])s?.version&&s.version!==n&&e.push({detector:$o,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 POe(t){let e=t.match(/TIER_STAGES[\s\S]*?\ball:\s*\[([^\]]*)\]/);return e?[...e[1].matchAll(/['"]([^'"]+)['"]/g)].map(r=>r[1]):[]}function COe(t,e){let r=Va(t,"src","cli","clad.ts"),n=Va(t,"plugins","claude-code",".claude-plugin","plugin.json");if(!ql(r)||!ql(n))return;let i=POe(JP(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:$o,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 DOe(t){let{cwd:e="."}=t,r=[];return OOe(e,r),COe(e,r),ROe(e,r),IOe(e,r),r}var $o,q8,B8,H8=y(()=>{"use strict";vp();$o="HARNESS_INTEGRITY",q8=[{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"]}];B8={name:$o,run:DOe}});import{existsSync as NOe,readFileSync as jOe}from"node:fs";import{join as MOe}from"node:path";function LOe(t){let{cwd:e="."}=t;return ge(e,Gv,r=>UOe(r,e))}function zOe(t){let e=MOe(t,"spec/capabilities.yaml");if(!NOe(e))return!1;try{let r=G8.default.parse(jOe(e,"utf8"));if(!r||typeof r!="object")return!1;let n=r.capabilities;return!Array.isArray(n)||n.length===0}catch{return!1}}function UOe(t,e){let r=t.features.length;if(r{"use strict";G8=St(Qt(),1);wt();Gv="HOLLOW_GOVERNANCE",FOe=8;Z8={name:Gv,run:LOe}});import{existsSync as W8,readFileSync as K8}from"node:fs";import{join as J8}from"node:path";function Y8(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 HOe(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 GOe(t){switch(t){case"wiring-only":return 1;case"verified":return 2;default:return null}}function ZOe(t){let e=J8(t,"README.md"),r=J8(t,"docs","dogfood","matrix.md");if(!W8(e)||!W8(r))return[];let n=Y8(K8(e,"utf8"),qOe),i=Y8(K8(r,"utf8"),BOe);if(!n||!i)return[];let o=[];for(let[s,a]of Object.entries(n)){let c=GOe(a);if(c===null)continue;let l=i[s]??"not-run",u=HOe(l);u!==null&&c>u&&o.push({detector:X8,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 VOe(t){let{cwd:e="."}=t;return ZOe(e)}var X8,qOe,BOe,Q8,e5=y(()=>{"use strict";X8="HOST_CLAIM_DRIFT",qOe=//,BOe=//;Q8={name:X8,run:VOe}});function WOe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=[];return t5(r.features.map(i=>i.id),"feature","spec/features/",n),t5((r.scenarios??[]).map(i=>i.id),"scenario","spec/scenarios/",n),n}function t5(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:r5,severity:"error",message:`${e} id '${o}' appears ${s} times across ${r} \u2014 every ${e} must have a unique id; resolve the duplicate`})}var r5,n5,i5=y(()=>{"use strict";Be();r5="ID_COLLISION";n5={name:r5,run:WOe}});import{existsSync as $p,readFileSync as YP,readdirSync as XP,statSync as KOe,writeFileSync as s5}from"node:fs";import{join as ko}from"node:path";function o5(t){if(!$p(t))return 0;try{return XP(t).filter(e=>e.endsWith(".yaml")||e.endsWith(".yml")).length}catch{return 0}}function JOe(t){if(!$p(t))return 0;let e=0,r=[t];for(;r.length>0;){let n=r.pop(),i;try{i=XP(n)}catch{continue}for(let o of i){if(o==="node_modules"||o===".cladding"||o.startsWith("."))continue;let s=ko(n,o),a;try{a=KOe(s)}catch{continue}a.isDirectory()?r.push(s):(o.endsWith(".test.ts")||o.endsWith(".test.tsx"))&&e++}}return e}function YOe(t){let e=ko(t,"spec","capabilities.yaml");if(!$p(e))return 0;try{let r=Zv.default.parse(YP(e,"utf8"));return Array.isArray(r?.capabilities)?r.capabilities.length:0}catch{return 0}}function _s(t="."){let e=o5(ko(t,"spec","features")),r=o5(ko(t,"spec","scenarios")),n=YOe(t),i=JOe(ko(t,"tests"));return{features:e,scenarios:r,capabilities:n,test_files:i}}function Bl(t,e){let r=ko(t,"spec.yaml");if(!$p(r))return;let n=YP(r,"utf8"),i=XOe(n,e);i!==n&&s5(r,i)}function XOe(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 @@ -269,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 La(t="."){let e=_o(t,"spec","features");if(!ip(e))return!1;let r=[];for(let i of hP(e).sort())if(!(!i.endsWith(".yaml")&&!i.endsWith(".yml")))try{let o=(0,bv.parse)(mP(_o(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=ko(t,"spec","features");if(!$p(e))return!1;let r=[];for(let i of XP(e).sort())if(!(!i.endsWith(".yaml")&&!i.endsWith(".yml")))try{let o=(0,Zv.parse)(YP(ko(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 f8(_o(t,"spec","index.yaml"),n,"utf8"),!0}var bv,op=y(()=>{"use strict";bv=Et(cr(),1)});import{existsSync as p8,readFileSync as m8,readdirSync as HTe}from"node:fs";import{join as gP}from"node:path";function GTe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=ls(e),i=r.inventory;if(!i){let s=h8.filter(([c])=>(n[c]??0)>0);if(s.length===0)return yP(e);let a=s.map(([c,l])=>`${n[c]??0} ${l}`).join(", ");return[...yP(e),{detector:sp,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 h8){let c=i[s]??0,l=n[s]??0;c!==l&&o.push({detector:sp,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(...yP(e)),o}function yP(t){let e=gP(t,"spec","index.yaml"),r=gP(t,"spec","features");if(!p8(e)||!p8(r))return[];let n=new Map;try{for(let l of m8(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 HTe(r)){if(!l.endsWith(".yaml")&&!l.endsWith(".yml"))continue;let u=m8(gP(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:sp,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:sp,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 sp,h8,g8,y8=y(()=>{"use strict";op();qe();sp="INVENTORY_DRIFT",h8=[["features","feature shard(s)"],["scenarios","scenario shard(s)"],["capabilities","capabilit(ies)"],["test_files","test file(s)"]];g8={name:sp,run:GTe}});import{existsSync as ZTe,readFileSync as VTe}from"node:fs";import{join as WTe}from"node:path";function JTe(t){let{cwd:e="."}=t,r=WTe(e,"src","spec","schema.json"),n=[];if(ZTe(r)){let i;try{i=JSON.parse(VTe(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 KTe)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=H(e);i.schema!==_8&&n.push({detector:ap,severity:"error",message:`spec.yaml schema='${i.schema}' but supported version is '${_8}'`})}catch{}return n}var ap,KTe,_8,b8,v8=y(()=>{"use strict";qe();ap="META_INTEGRITY",KTe=["schema","project","features"],_8="0.1";b8={name:ap,run:JTe}});function YTe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=[];return S8(r.features.map(i=>({id:i.id,slug:i.slug})),"features",n),S8((r.scenarios??[]).map(i=>({id:i.id,slug:i.slug})),"scenarios",n),n}function S8(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:w8,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 w8,x8,$8=y(()=>{"use strict";qe();w8="SLUG_CONFLICT";x8={name:w8,run:YTe}});function Tl(t){return t==="planned"||t==="in_progress"}var vv=y(()=>{"use strict"});import{existsSync as XTe}from"node:fs";import{join as QTe}from"node:path";function eOe(t){let{cwd:e="."}=t;return he(e,Sv,r=>tOe(r,e))}function tOe(t,e){let r=[];for(let n of t.features)for(let i of n.modules??[]){let o=QTe(e,i);XTe(o)||r.push(rOe(n.id,i,n.status))}return r}function rOe(t,e,r){return Tl(r)?{detector:Sv,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:Sv,severity:"error",path:e,message:`feature ${t} declares module '${e}' but the file does not exist`}}var Sv,wv,_P=y(()=>{"use strict";vv();bt();Sv="MISSING_IMPLEMENTATION";wv={name:Sv,run:eOe}});function nOe(t){let{cwd:e="."}=t;return he(e,bP,iOe)}function iOe(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:bP,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 bP,xv,vP=y(()=>{"use strict";bt();bP="MISSING_TESTS";xv={name:bP,run:nOe}});import{existsSync as oOe,readFileSync as sOe}from"node:fs";import{join as k8}from"node:path";function E8(t){if(oOe(t))try{return JSON.parse(sOe(t,"utf8"))}catch{return}}function uOe(t){let{cwd:e="."}=t,r=E8(k8(e,aOe)),n=E8(k8(e,cOe));if(!r||!n)return[{detector:SP,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>lOe&&i.push({detector:SP,severity:"warn",message:`${o} regressed ${c.toFixed(1)}% (baseline ${s.value}${s.unit??""} \u2192 current ${a.value}${a.unit??""})`})}return i}var SP,aOe,cOe,lOe,A8,T8=y(()=>{"use strict";SP="PERFORMANCE_DRIFT",aOe="perf/baseline.json",cOe="perf/current.json",lOe=10;A8={name:SP,run:uOe}});import{existsSync as dOe}from"node:fs";import{join as fOe}from"node:path";function mOe(t){let{cwd:e="."}=t;return he(e,wP,r=>gOe(r,e))}function hOe(t,e){return(t.modules??[]).some(r=>dOe(fOe(e,r)))}function gOe(t,e){let r=[];for(let s of t.features)s.status!=="planned"&&s.status!=="in_progress"||hOe(s,e)||r.push(s.id);let n=pOe;if(r.length<=n)return[];let i=r.slice(0,O8).join(", "),o=r.length>O8?", \u2026":"";return[{detector:wP,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 wP,pOe,O8,R8,I8=y(()=>{"use strict";bt();wP="PLANNED_BACKLOG",pOe=5,O8=8;R8={name:wP,run:mOe}});import{existsSync as yOe,readFileSync as _Oe}from"node:fs";import{join as bOe}from"node:path";function wOe(t){let{cwd:e="."}=t;return he(e,xP,r=>xOe(r,e))}function xOe(t,e){if(t.features.lengthn.includes(i))?[{detector:xP,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 xP,vOe,SOe,P8,C8=y(()=>{"use strict";bt();xP="PROJECT_CONTEXT_DRIFT",vOe=8,SOe=["Refine by hand or re-run with LLM available","What gap or pain led to this project","What does success look like"];P8={name:xP,run:wOe}});function D8(t,e,r){return e?e.filter(n=>!t.has(n)).map(n=>({detector:$v,severity:"error",message:`${r} references unknown id '${n}'`})):[]}function $Oe(t){let{cwd:e="."}=t;return he(e,$v,kOe)}function kOe(t){let e=new Set(t.features.map(n=>n.id)),r=[];for(let n of t.features)r.push(...D8(e,n.depends_on,`feature ${n.id}.depends_on`)),n.superseded_by&&!e.has(n.superseded_by)&&r.push({detector:$v,severity:"error",message:`feature ${n.id}.superseded_by references unknown id '${n.superseded_by}'`});for(let n of t.scenarios??[])r.push(...D8(e,n.features,`scenario ${n.id}.features`));return r}var $v,kv,$P=y(()=>{"use strict";bt();$v="REFERENCE_INTEGRITY";kv={name:$v,run:$Oe}});function cp(t=""){return new RegExp(EOe,t)}var EOe,kP=y(()=>{"use strict";EOe=String.raw`\bF-(?:\d{3,}|[0-9a-f]{6,8})\b`});import{existsSync as AOe,readdirSync as TOe,readFileSync as OOe,statSync as ROe,writeFileSync as IOe}from"node:fs";import{dirname as POe,join as lp,normalize as COe,relative as DOe}from"node:path";function LOe(t){let e=[];for(let r of t.matchAll(FOe))if(!r[1].trim().startsWith("ignore"))for(let n of r[1].match(cp("g"))??[])e.push(n);return[...new Set(e)].sort()}function zOe(t){return t.replace(/```[\s\S]*?```/g," ").replace(/~~~[\s\S]*?~~~/g," ").replace(/`[^`\n]*`/g," ")}function N8(t){return t.split("\\").join("/")}function UOe(t){return NOe.some(e=>t===e||t.startsWith(`${e}/`))}function qOe(t){let e=lp(t,"docs");if(!AOe(e))return[];let r=[],n=[e];for(;n.length>0;){let i=n.pop(),o;try{o=TOe(i)}catch{continue}for(let s of o){if(s.startsWith("."))continue;let a=lp(i,s),c;try{c=ROe(a)}catch{continue}let l=N8(DOe(t,a));c.isDirectory()?n.push(a):s.endsWith(".md")&&r.push(l)}}return r.sort()}function BOe(t,e){if(/^[a-z]+:/i.test(e))return null;let r=COe(lp(POe(t),e));return N8(r)}function up(t="."){let e=[];for(let r of qOe(t)){let n;try{n=OOe(lp(t,r),"utf8")}catch{continue}let i=zOe(n),o=LOe(i);if(UOe(r)){if(o.length===0)continue;e.push({doc:r,features:o,doc_links:[]});continue}let a=n.includes(jOe)?[]:i.match(cp("g"))??[],c=[...new Set([...a,...o])].sort(),l=new Set;for(let u of i.matchAll(MOe)){let d=BOe(r,u[1]);d&&l.add(d)}e.push({doc:r,features:c,doc_links:[...l].sort()})}return{docs:e}}function j8(t="."){let e=up(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 IOe(lp(t,"spec","_doc-links.yaml"),`${r.join(` +`;return s5(ko(t,"spec","index.yaml"),n,"utf8"),!0}var Zv,kp=y(()=>{"use strict";Zv=St(Qt(),1)});import{existsSync as a5,readFileSync as c5,readdirSync as QOe}from"node:fs";import{join as QP}from"node:path";function eRe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=_s(e),i=r.inventory;if(!i){let s=l5.filter(([c])=>(n[c]??0)>0);if(s.length===0)return eC(e);let a=s.map(([c,l])=>`${n[c]??0} ${l}`).join(", ");return[...eC(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 l5){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(...eC(e)),o}function eC(t){let e=QP(t,"spec","index.yaml"),r=QP(t,"spec","features");if(!a5(e)||!a5(r))return[];let n=new Map;try{for(let l of c5(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 QOe(r)){if(!l.endsWith(".yaml")&&!l.endsWith(".yml"))continue;let u=c5(QP(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,l5,u5,d5=y(()=>{"use strict";kp();Be();Ep="INVENTORY_DRIFT",l5=[["features","feature shard(s)"],["scenarios","scenario shard(s)"],["capabilities","capabilit(ies)"],["test_files","test file(s)"]];u5={name:Ep,run:eRe}});import{existsSync as tRe,readFileSync as rRe}from"node:fs";import{join as nRe}from"node:path";function oRe(t){let{cwd:e="."}=t,r=nRe(e,"src","spec","schema.json"),n=[];if(tRe(r)){let i;try{i=JSON.parse(rRe(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 iRe)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=H(e);i.schema!==f5&&n.push({detector:Ap,severity:"error",message:`spec.yaml schema='${i.schema}' but supported version is '${f5}'`})}catch{}return n}var Ap,iRe,f5,p5,m5=y(()=>{"use strict";Be();Ap="META_INTEGRITY",iRe=["schema","project","features"],f5="0.1";p5={name:Ap,run:oRe}});function sRe(t){let{cwd:e="."}=t,r;try{r=H(e)}catch{return[]}let n=[];return h5(r.features.map(i=>({id:i.id,slug:i.slug})),"features",n),h5((r.scenarios??[]).map(i=>({id:i.id,slug:i.slug})),"scenarios",n),n}function h5(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:g5,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 g5,y5,_5=y(()=>{"use strict";Be();g5="SLUG_CONFLICT";y5={name:g5,run:sRe}});function Hl(t){return t==="planned"||t==="in_progress"}var Vv=y(()=>{"use strict"});import{existsSync as aRe}from"node:fs";import{join as cRe}from"node:path";function lRe(t){let{cwd:e="."}=t;return ge(e,Wv,r=>uRe(r,e))}function uRe(t,e){let r=[];for(let n of t.features)for(let i of n.modules??[]){let o=cRe(e,i);aRe(o)||r.push(dRe(n.id,i,n.status))}return r}function dRe(t,e,r){return Hl(r)?{detector:Wv,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:Wv,severity:"error",path:e,message:`feature ${t} declares module '${e}' but the file does not exist`}}var Wv,Kv,tC=y(()=>{"use strict";Vv();wt();Wv="MISSING_IMPLEMENTATION";Kv={name:Wv,run:lRe}});function fRe(t){let{cwd:e="."}=t;return ge(e,rC,pRe)}function pRe(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:rC,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 rC,Jv,nC=y(()=>{"use strict";wt();rC="MISSING_TESTS";Jv={name:rC,run:fRe}});import{existsSync as mRe,readFileSync as hRe}from"node:fs";import{join as b5}from"node:path";function v5(t){if(mRe(t))try{return JSON.parse(hRe(t,"utf8"))}catch{return}}function bRe(t){let{cwd:e="."}=t,r=v5(b5(e,gRe)),n=v5(b5(e,yRe));if(!r||!n)return[{detector:iC,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>_Re&&i.push({detector:iC,severity:"warn",message:`${o} regressed ${c.toFixed(1)}% (baseline ${s.value}${s.unit??""} \u2192 current ${a.value}${a.unit??""})`})}return i}var iC,gRe,yRe,_Re,S5,w5=y(()=>{"use strict";iC="PERFORMANCE_DRIFT",gRe="perf/baseline.json",yRe="perf/current.json",_Re=10;S5={name:iC,run:bRe}});import{existsSync as vRe}from"node:fs";import{join as SRe}from"node:path";function xRe(t){let{cwd:e="."}=t;return ge(e,oC,r=>kRe(r,e))}function $Re(t,e){return(t.modules??[]).some(r=>vRe(SRe(e,r)))}function kRe(t,e){let r=[];for(let s of t.features)s.status!=="planned"&&s.status!=="in_progress"||$Re(s,e)||r.push(s.id);let n=wRe;if(r.length<=n)return[];let i=r.slice(0,x5).join(", "),o=r.length>x5?", \u2026":"";return[{detector:oC,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 oC,wRe,x5,$5,k5=y(()=>{"use strict";wt();oC="PLANNED_BACKLOG",wRe=5,x5=8;$5={name:oC,run:xRe}});import{existsSync as ERe,readFileSync as ARe}from"node:fs";import{join as TRe}from"node:path";function IRe(t){let{cwd:e="."}=t;return ge(e,sC,r=>PRe(r,e))}function PRe(t,e){if(t.features.lengthn.includes(i))?[{detector:sC,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 sC,ORe,RRe,E5,A5=y(()=>{"use strict";wt();sC="PROJECT_CONTEXT_DRIFT",ORe=8,RRe=["Refine by hand or re-run with LLM available","What gap or pain led to this project","What does success look like"];E5={name:sC,run:IRe}});function T5(t,e,r){return e?e.filter(n=>!t.has(n)).map(n=>({detector:Yv,severity:"error",message:`${r} references unknown id '${n}'`})):[]}function CRe(t){let{cwd:e="."}=t;return ge(e,Yv,DRe)}function DRe(t){let e=new Set(t.features.map(n=>n.id)),r=[];for(let n of t.features)r.push(...T5(e,n.depends_on,`feature ${n.id}.depends_on`)),n.superseded_by&&!e.has(n.superseded_by)&&r.push({detector:Yv,severity:"error",message:`feature ${n.id}.superseded_by references unknown id '${n.superseded_by}'`});for(let n of t.scenarios??[])r.push(...T5(e,n.features,`scenario ${n.id}.features`));return r}var Yv,Xv,aC=y(()=>{"use strict";wt();Yv="REFERENCE_INTEGRITY";Xv={name:Yv,run:CRe}});function Tp(t=""){return new RegExp(NRe,t)}var NRe,cC=y(()=>{"use strict";NRe=String.raw`\bF-(?:\d{3,}|[0-9a-f]{6,8})\b`});import{existsSync as jRe,readdirSync as MRe,readFileSync as FRe,statSync as LRe,writeFileSync as zRe}from"node:fs";import{dirname as URe,join as Op,normalize as qRe,relative as BRe}from"node:path";function WRe(t){let e=[];for(let r of t.matchAll(VRe))if(!r[1].trim().startsWith("ignore"))for(let n of r[1].match(Tp("g"))??[])e.push(n);return[...new Set(e)].sort()}function KRe(t){return t.replace(/```[\s\S]*?```/g," ").replace(/~~~[\s\S]*?~~~/g," ").replace(/`[^`\n]*`/g," ")}function O5(t){return t.split("\\").join("/")}function JRe(t){return HRe.some(e=>t===e||t.startsWith(`${e}/`))}function YRe(t){let e=Op(t,"docs");if(!jRe(e))return[];let r=[],n=[e];for(;n.length>0;){let i=n.pop(),o;try{o=MRe(i)}catch{continue}for(let s of o){if(s.startsWith("."))continue;let a=Op(i,s),c;try{c=LRe(a)}catch{continue}let l=O5(BRe(t,a));c.isDirectory()?n.push(a):s.endsWith(".md")&&r.push(l)}}return r.sort()}function XRe(t,e){if(/^[a-z]+:/i.test(e))return null;let r=qRe(Op(URe(t),e));return O5(r)}function Rp(t="."){let e=[];for(let r of YRe(t)){let n;try{n=FRe(Op(t,r),"utf8")}catch{continue}let i=KRe(n),o=WRe(i);if(JRe(r)){if(o.length===0)continue;e.push({doc:r,features:o,doc_links:[]});continue}let a=n.includes(GRe)?[]:i.match(Tp("g"))??[],c=[...new Set([...a,...o])].sort(),l=new Set;for(let u of i.matchAll(ZRe)){let d=XRe(r,u[1]);d&&l.add(d)}e.push({doc:r,features:c,doc_links:[...l].sort()})}return{docs:e}}function R5(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 zRe(Op(t,"spec","_doc-links.yaml"),`${r.join(` `)} -`,"utf8"),!0}var NOe,jOe,MOe,FOe,Ev=y(()=>{"use strict";kP();NOe=["docs/ab-evaluation","docs/ab-evaluation-extended","docs/dogfood","docs/benchmarks"],jOe="clad-doc-links: ignore",MOe=/\]\(\s*([^)\s]+?\.md)(?:#[^)]*)?\s*\)/g,FOe=/clad-doc-links:[ \t]*([^\n>]*)/g});import{existsSync as HOe}from"node:fs";import{join as GOe}from"node:path";function ZOe(t){let{cwd:e="."}=t;return he(e,Av,r=>VOe(r,e))}function VOe(t,e){let r=new Set((t.features??[]).map(i=>i.id)),n=[];for(let i of up(e).docs){for(let o of i.doc_links)HOe(GOe(e,o))||n.push({detector:Av,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:Av,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 Av,Tv,EP=y(()=>{"use strict";Ev();bt();Av="DOC_LINK_INTEGRITY";Tv={name:Av,run:ZOe}});function KOe(t){let{cwd:e="."}=t;return he(e,dp,r=>JOe(r))}function JOe(t){let e=[],r=t.features.length,n=t.scenarios??[];r>=WOe&&n.length===0&&e.push({detector:dp,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 o of n)(o.features??[]).length===0&&e.push({detector:dp,severity:"warn",path:"spec/scenarios/",message:`scenario ${o.id} binds no features (features: []) \u2014 a scenario must cover at least one feature's flow, or it should be removed.`});let i=new Map(t.features.filter(o=>typeof o.slug=="string"&&o.slug.length>0).map(o=>[o.slug,o.id]));for(let o of n){if(!o.flow)continue;let s=new Set(o.features??[]),a=new Map;for(let c of o.flow.matchAll(/\(([^)]+)\)/g))for(let l of c[1].split(/[,/·]/)){let u=l.trim(),d=i.get(u);d&&!s.has(d)&&a.set(u,d)}if(a.size>0){let c=[...a].map(([l,u])=>`${l} (${u})`).join(", ");e.push({detector:dp,severity:"warn",path:"spec/scenarios/",message:`scenario ${o.id} flow references ${c} but features[] does not bind ${a.size===1?"it":"them"} \u2014 bind every feature the flow walks, or trim the flow so coverage is not under-stated.`})}}return e}var dp,WOe,M8,F8=y(()=>{"use strict";bt();dp="SCENARIO_COVERAGE",WOe=8;M8={name:dp,run:KOe}});import{createHash as YOe}from"node:crypto";function XOe(t){return!Number.isFinite(t)||t<=0?0:t>=1?1:t}function fp(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??L8),sample:XOe(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(L8),sample:0}:{mandateActive:!1,reportOnly:!1,exhaustive:!1,alwaysEars:new Set,sample:0}}function pp(t){return(t.features??[]).filter(e=>e.status==="done").length}function QOe(t,e){return e<=0?!1:e>=1?!0:parseInt(YOe("sha256").update(t).digest("hex").slice(0,8),16)%1e40})}return r}var L8,Ov=y(()=>{"use strict";L8=["unwanted"]});import{existsSync as eRe,readdirSync as tRe}from"node:fs";import{join as U8}from"node:path";import q8 from"node:process";function rRe(t){let e=!1,r=n=>{for(let i of tRe(n,{withFileTypes:!0})){if(e)return;let o=U8(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 AP(t={}){let{cwd:e="."}=t,r=U8(e,us);if(!eRe(r)||!rRe(r))return{stage:Rv,pass:!1,exitCode:2,stderr:`no spec-conformance oracles under ${us}/ \u2014 skipped`};let n=ht(e),i=n.gates.test;if(!i?.cmd||!i.args)return{stage:Rv,pass:!1,exitCode:2,stderr:`no test runner registered for language '${n.language}'`};let o=Je(i.cmd,[...i.args,us],{cwd:e,reject:!1}),s=Lt(Rv,i.cmd,o);return s||Yt(Rv,o)}var Rv,us,nRe,TP=y(()=>{"use strict";jr();En();An();Rv="stage_2.3",us="tests/oracle";nRe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${q8.argv[1]}`;if(nRe){let t=AP();console.log(JSON.stringify(t)),q8.exit(t.exitCode)}});import{existsSync as iRe}from"node:fs";import{join as oRe}from"node:path";function sRe(t){let{cwd:e="."}=t;return he(e,Qn,r=>aRe(r,e))}function aRe(t,e){let r=[],n=fp(t.project,pp(t)),i=n.reportOnly?"info":"error",o=n.mandateActive?Tn(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(mp(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:Qn,severity:i,message:`${l.id}.${u.id} done AC lacks a spec-conformance oracle (${f}; declare oracle_refs under ${us}/)`+(n.reportOnly?" [report-only \u2014 the graduated default enforces in 0.7]":"")})}for(let f of d){if(!iRe(oRe(e,f))){r.push({detector:Qn,severity:"error",path:f,message:`${l.id}.${u.id} oracle_ref '${f}' resolves to nothing on disk`});continue}if(f.startsWith(`${us}/`)||r.push({detector:Qn,severity:"warn",path:f,message:`${l.id}.${u.id} oracle_ref '${f}' lives outside ${us}/ \u2014 stage_2.3 only runs ${us}/, 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:Qn,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:Qn,severity:"error",path:f,message:`${l.id}.${u.id} oracle '${f}' is NOT impl-blind: authored by the implementer ('${m}')`}):m||r.push({detector:Qn,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:Qn,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:Qn,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:Qn,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 Qn,B8,H8=y(()=>{"use strict";Xn();Ov();TP();bt();Qn="SPEC_CONFORMANCE";B8={name:Qn,run:sRe}});function cRe(t){let{cwd:e="."}=t,r=Tn(e);if(r.length===0)return[{detector:OP,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>G8&&i.push({detector:OP,severity:"warn",message:`evidence ${o.id} is ${Math.round(a)} days old (floor ${G8})`})}return i}var OP,G8,Z8,V8=y(()=>{"use strict";Xn();OP="STALE_EVIDENCE",G8=90;Z8={name:OP,run:cRe}});import{existsSync as W8}from"node:fs";import{join as K8}from"node:path";function lRe(t){let{cwd:e="."}=t;return he(e,Ol,r=>uRe(r,e))}function uRe(t,e){let r=[];for(let n of t.features){if(n.archived_at&&n.status!=="archived"&&r.push({detector:Ol,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:Ol,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=>W8(K8(e,o)));i.length>0&&r.push({detector:Ol,severity:"warn",message:`feature ${n.id} is archived but ${i.length} module(s) still exist: ${i.join(", ")}`})}Tl(n.status)&&(n.modules?.length??0)>0&&!(n.modules??[]).some(i=>W8(K8(e,i)))&&r.push({detector:Ol,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 Ol,Iv,RP=y(()=>{"use strict";vv();bt();Ol="STALE_SPECIFICATION";Iv={name:Ol,run:lRe}});import{existsSync as J8,statSync as Y8}from"node:fs";import{join as X8}from"node:path";function fRe(t,e){let r=0;for(let n of e){let i=X8(t,n);if(!J8(i))continue;let o=Y8(i).mtimeMs;o>r&&(r=o)}return r}function pRe(t){let{cwd:e="."}=t;return he(e,IP,r=>mRe(r,e))}function mRe(t,e){let r=Ri(e,t.project?.language),n=t.features.flatMap(a=>a.modules??[]),i=fRe(e,n);if(i===0)return[];let o=cs([...r.testGlobs],{cwd:e,dot:!1});if(o.length===0)return[];let s=[];for(let a of o){let c=X8(e,a);if(!J8(c))continue;let l=Y8(c).mtimeMs,u=(i-l)/(1e3*60*60*24);u>dRe&&s.push({detector:IP,severity:"warn",path:a,message:`${a} is ${Math.round(u)} days older than newest source module`})}return s}var IP,dRe,Pv,PP=y(()=>{"use strict";ep();Da();bt();IP="STALE_TESTS",dRe=30;Pv={name:IP,run:pRe}});import{existsSync as hRe}from"node:fs";import{join as gRe}from"node:path";function yRe(t){let{cwd:e="."}=t;return he(e,hp,r=>_Re(r,e))}function _Re(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:hp,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=>!hRe(gRe(e,a)));s.length!==0&&(n.status==="done"?r.push({detector:hp,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:hp,severity:Tl(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 hp,Cv,CP=y(()=>{"use strict";vv();bt();hp="STATUS_DRIFT";Cv={name:hp,run:yRe}});function bRe(t){let{cwd:e="."}=t;return he(e,Dv,r=>vRe(r,e))}function vRe(t,e){let r=ht(e).language;return r==="unknown"?[{detector:Dv,severity:"info",message:"no manifest matched \u2014 language cannot be cross-checked"}]:t.project.language===r?[]:[{detector:Dv,severity:"warn",message:`spec.project.language='${t.project.language}' but the manifest chain detects '${r}'`}]}var Dv,Q8,e5=y(()=>{"use strict";En();bt();Dv="TECH_STACK_MISMATCH";Q8={name:Dv,run:bRe}});function $Re(t){if((t.features??[]).length`${i}/${o}/**/*.${n}`)}function kRe(t){let{cwd:e="."}=t;return he(e,DP,r=>ERe(r,e))}function ERe(t,e){let r=new Set;for(let o of t.features)for(let s of o.modules??[])r.add(s);let n=cs([...$Re(t)],{cwd:e,dot:!1}),i=[];for(let o of n)r.has(o)||i.push({detector:DP,severity:"error",path:o,message:`file '${o}' is not claimed by any feature in spec.yaml`});return i}var DP,t5,SRe,wRe,xRe,Nv,NP=y(()=>{"use strict";ep();oP();bt();DP="UNMAPPED_ARTIFACT",t5=["src/stages/**/*.ts","src/spec/**/*.ts"],SRe={typescript:"ts",javascript:"js",python:"py",rust:"rs",go:"go",kotlin:"kt"},wRe={kotlin:"src/main/kotlin"},xRe=8;Nv={name:DP,run:kRe}});import{existsSync as r5}from"node:fs";import{join as n5}from"node:path";function TRe(t){return ARe.some(e=>t.startsWith(e))}function ORe(t){let{cwd:e="."}=t;return he(e,jP,r=>RRe(r,e))}function RRe(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(TRe(o))continue;let s=o.split("#",1)[0];r5(n5(e,o))||s&&r5(n5(e,s))||r.push({detector:jP,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 Cx(t){return`${JSON.stringify(t,null,2)} +`}function Kee(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?`[[${Gee(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(Zee);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(Zee);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}/${Gee(s)}.md`,`${a.join(` +`)}`)}return o}function Zee(t,e){return t.kind.localeCompare(e.kind)||t.other.localeCompare(e.other)}import{readFileSync as AUe}from"node:fs";import{dirname as TUe,join as wj}from"node:path";import{fileURLToPath as OUe}from"node:url";var xj=TUe(OUe(import.meta.url));function Jee(t){for(let e of[wj(xj,"viewer",t),wj(xj,"..","graph","viewer",t),wj(xj,"..","..","dist","viewer",t)])try{return AUe(e,"utf8")}catch{}throw new Error(`cladding: viewer asset not found: ${t}`)}function Yee(t){return JSON.stringify(t).replace(/0?` `:"";return` @@ -867,20 +895,22 @@ ${g.length} question(s) left. continue with \`clad clarify \`. ${o} -`}lP();EP();_P();vP();$P();cP();PP();CP();NP();MP();Om();kP();qe();var o2e=[xv,jv,wv,Nv,kv,Tv,yv,Cv,Pv,gv];function s2e(t,e){if(t.path){let n=t.path.split("#")[0].trim(),i=[ze.module(n),ze.test(n),ze.doc(n)].filter(o=>e.has(o));if(i.length>0)return i}let r=cp().exec(t.message??"");return r&&e.has(ze.feature(r[0]))?[ze.feature(r[0])]:[]}function ix(t,e="."){let r=new Set(t.nodes.map(o=>o.id)),n={};try{ga(e,H(e))}catch{}try{for(let o of o2e){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 s2e(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{ga(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}NN();qe();$i();var c2e=new Set(["mermaid","dot","json","obsidian","html"]);function iee(t={}){try{let e=t.format??"mermaid";if(!c2e.has(e)){M("fail","graph",`unknown --format '${e}' \u2014 use mermaid | dot | json | obsidian | html`),process.exit(1);return}let r=e,n=H(),i=oc(n,".");if(t.focus){let s=Xw(n,i,t.focus);if(s.length===0){M("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){M("fail","graph",`--depth must be a non-negative number, got '${t.depth}'`),process.exit(1);return}i=Yw(i,s,a)}if(r==="obsidian"){let s=t.out??".cladding/graph",a=eee(i);for(let[c,l]of a){let u=a2e(s,c);jN(FN(u),{recursive:!0}),MN(u,l,"utf8")}M("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){M("fail","graph","--format html requires --out (a single self-contained .html file)"),process.exit(1);return}let s=nx(i,ix(i,"."));jN(FN(t.out),{recursive:!0}),MN(t.out,s,"utf8"),M("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"?QQ(i):r==="json"?rx(i):XQ(i);t.out?(jN(FN(t.out),{recursive:!0}),MN(t.out,o,"utf8"),M("pass","graph",`wrote ${r} graph to ${t.out}`),process.exit(0)):process.stdout.write(o,()=>process.exit(0))}catch(e){M("fail","graph",e.message),process.exit(1)}}function oee(){try{let t=oc(H(),".");process.stdout.write(nee(ox(t)),()=>process.exit(0))}catch(t){M("fail","graph",t.message),process.exit(1)}}Om();import{createServer as l2e}from"node:http";import{existsSync as u2e,watch as d2e}from"node:fs";import{join as f2e}from"node:path";qe();$i();function p2e(t={}){let e=t.cwd??".",r=new Set,n=()=>oc(H(e),e),i=()=>{for(let u of r)try{u.write(`data: refresh +`}ZP();lC();tC();nC();aC();GP();hC();gC();_C();vC();Km();cC();Be();var RUe=[Jv,cS,Kv,aS,Xv,tS,Hv,oS,iS,Bv];function IUe(t,e){if(t.path){let n=t.path.split("#")[0].trim(),i=[Ue.module(n),Ue.test(n),Ue.doc(n)].filter(o=>e.has(o));if(i.length>0)return i}let r=Tp().exec(t.message??"");return r&&e.has(Ue.feature(r[0]))?[Ue.feature(r[0])]:[]}function Nx(t,e="."){let r=new Set(t.nodes.map(o=>o.id)),n={};try{Ea(e,H(e))}catch{}try{for(let o of RUe){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 IUe(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}$j();Be();Oi();var CUe=new Set(["mermaid","dot","json","obsidian","html"]);function Qee(t={}){try{let e=t.format??"mermaid";if(!CUe.has(e)){L("fail","graph",`unknown --format '${e}' \u2014 use mermaid | dot | json | obsidian | html`),process.exit(1);return}let r=e,n=H(),i=bc(n,".");if(t.focus){let s=Ox(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=Tx(i,s,a)}if(r==="obsidian"){let s=t.out??".cladding/graph",a=Kee(i);for(let[c,l]of a){let u=PUe(s,c);kj(Aj(u),{recursive:!0}),Ej(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=Dx(i,Nx(i,"."));kj(Aj(t.out),{recursive:!0}),Ej(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"?Wee(i):r==="json"?Cx(i):Vee(i);t.out?(kj(Aj(t.out),{recursive:!0}),Ej(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 ete(){try{let t=bc(H(),".");process.stdout.write(Xee(jx(t)),()=>process.exit(0))}catch(t){L("fail","graph",t.message),process.exit(1)}}Km();import{createServer as DUe}from"node:http";import{existsSync as NUe,watch as jUe}from"node:fs";import{join as MUe}from"node:path";Be();Oi();function FUe(t={}){let e=t.cwd??".",r=new Set,n=()=>bc(H(e),e),i=()=>{for(let u of r)try{u.write(`data: refresh -`)}catch{r.delete(u)}},o=l2e((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=rx(n());d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/health.json"){let m=JSON.stringify(ix(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=DUe((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=Cx(n());d.writeHead(200,{"Content-Type":"application/json","Cache-Control":"no-store"}),d.end(m);return}if(f==="/health.json"){let m=JSON.stringify(Nx(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=nx(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=f2e(e,u);if(u2e(d))try{let f=d2e(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=Dx(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=MUe(e,u);if(NUe(d))try{let f=jUe(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 see(t={}){let e=t.port!==void 0?Number(t.port):3e3;try{let r=await p2e({port:e,cwd:t.cwd??"."});M("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){M("fail","graph",r.message),process.exit(1)}}var m2e=["stage_1.1","stage_2.1","stage_2.3"];function h2e(t){return(t.features??[]).filter(e=>e.status==="done")}function g2e(t,e){let r=h2e(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 aee(t,e){let r=[];for(let n of m2e){if(!e.some(s=>s.stage===n&&s.status==="skip"))continue;let o=g2e(t,n);o&&r.push({stage:n,label:"Verification",message:o})}return r}Zv();import cee from"node:process";function y2e(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 sx(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=y2e(n,t);i.pass||r.push(i)}return r}Xn();var LN="stage_4.1";function zN(t={}){let{cwd:e="."}=t,r=Tn(e);if(r.length===0)return{stage:LN,pass:!1,exitCode:2,stderr:"no audit log present \u2014 record evidence before running stage_4.1"};let n=sx(r);if(n.length===0)return{stage:LN,pass:!0,exitCode:0};let i=n.map(o=>`${o.acId}: ${o.reason}`).join("; ");return{stage:LN,pass:!1,exitCode:1,stderr:`anti-self-cert guard: ${i}`}}var _2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${cee.argv[1]}`;if(_2e){let t=zN();console.log(JSON.stringify(t)),cee.exit(t.exitCode)}rl();import{randomBytes as b2e}from"node:crypto";import{unlinkSync as v2e}from"node:fs";import{tmpdir as S2e}from"node:os";import{join as w2e,resolve as UN}from"node:path";import x2e from"node:process";var Ur=null;function lee(t){Ur={cwd:UN(t),run:null,jsonFile:null}}function uee(){return Ur!==null}function dee(t,e){if(!Ur||Ur.cwd!==UN(t))return null;if(Ur.run)return Ur.run;let r=w2e(S2e(),`clad-shared-vitest-${x2e.pid}-${b2e(6).toString("hex")}.json`);Ur.jsonFile=r;let n=e(r);return Ur.run={proc:n,jsonFile:r},Ur.run}function fee(t){return!Ur||Ur.cwd!==UN(t)?null:Ur.run}function pee(t){return t.pass&&t.exitCode===0?"reuse-pass":"fallback"}function mee(){let t=Ur?.jsonFile;if(Ur=null,t)try{v2e(t)}catch{}}jr();import hee from"node:process";var ax="stage_1.4";function qN(t={}){let{cwd:e="."}=t,r;try{r=Je("git",["status","--porcelain"],{cwd:e,reject:!1})}catch(i){if(i.code==="ENOENT")return{stage:ax,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:ax,pass:!1,exitCode:2,stderr:i}}let n=(r.stdout??"").toString().trim();return n.length===0?{stage:ax,pass:!0,exitCode:0}:{stage:ax,pass:!1,exitCode:1,stderr:`working tree dirty: -${n}`}}var $2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${hee.argv[1]}`;if($2e){let t=qN();console.log(JSON.stringify(t)),hee.exit(t.exitCode)}jr();import gee from"node:process";Rm();An();var cx="stage_2.2";function BN(t={}){let{cwd:e="."}=t,r,n,i;try{({cmd:r,args:n,language:i}=Eo("coverage",t))}catch(c){return{stage:cx,pass:!1,exitCode:1,stderr:c.message}}if(!r||!n)return{stage:cx,pass:!1,exitCode:2,stderr:`no coverage runner registered for language '${i}'`};let o=fee(e),s=o?o.proc:Je(r,[...n],{cwd:e,reject:!1}),a=Lt(cx,r,s);return a||Yt(cx,s)}var A2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${gee.argv[1]}`;if(A2e){let t=BN();console.log(JSON.stringify(t)),gee.exit(t.exitCode)}yp();HN();jr();En();An();import _ee from"node:process";var fx="stage_3.2";function GN(t={}){let{cwd:e="."}=t,r=ht(e),n=r.gates.perf,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:fx,pass:!1,exitCode:2,stderr:`no perf runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!xl(e,o[o.length-1]))return{stage:fx,pass:!1,exitCode:2,stderr:"perf npm script not defined"};let s=Je(i,[...o],{cwd:e,reject:!1}),a=Lt(fx,i,s);return a||Yt(fx,s)}var H2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${_ee.argv[1]}`;if(H2e){let t=GN();console.log(JSON.stringify(t)),_ee.exit(t.exitCode)}jr();qe();An();import{existsSync as G2e}from"node:fs";import{resolve as vee}from"node:path";import See from"node:process";var ii="stage_2.4",ZN=5e3,Z2e=3e4;function VN(t={}){let{cwd:e="."}=t,r,n=[],i=!1,o=new Map;try{let p=H(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:ii,pass:!1,exitCode:2,stderr:"spec.yaml not loaded \u2014 deliverable smoke skipped"}}if(n.length>0)return W2e(e,n,{anyDone:i,featureStatus:o});if(!r)return{stage:ii,pass:!1,exitCode:2,stderr:"no project.deliverable declared \u2014 skipped"};if(r.is_safe_to_smoke!==!0)return{stage:ii,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not marked is_safe_to_smoke \u2014 skipped`};if(!i)return{stage:ii,pass:!1,exitCode:2,stderr:"no done feature yet \u2014 deliverable smoke skipped"};let s=vee(e,r.path);if(!G2e(s))return{stage:ii,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not found \u2014 see DELIVERABLE_INTEGRITY`};let a=r.timeout_ms??ZN,c;try{c=Je(s,[...r.smoke_args??[]],{cwd:e,reject:!1,timeout:a})}catch(p){c=p}let l=Lt(ii,r.path,c);if(l)return l;if(c.timedOut)return{stage:ii,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:ii,pass:!0,exitCode:0,disposition:"liveness"};let f=String(c.stderr??"").trim()||String(c.stdout??"").trim();return{stage:ii,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' exited ${d}, expected ${u}${f?` \u2014 ${f.slice(0,200)}`:""}`}}var bee={fail:5,advisory:4,pending_env:4,liveness:3,pass:2,na:1,skip:0},V2e={pass:"\u2713",fail:"\u2717",liveness:"liveness",na:"na",pending_env:"pending_env",advisory:"advisory",skip:"skip"};function W2e(t,e,r){let n=Math.min(e.length*ZN,Z2e),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(K2e(t,s,r))}return J2e(o)}function K2e(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("/")?vee(t,a):a,u=ZN,d;try{d=Je(l,[...c],{cwd:t,reject:!1,timeout:u})}catch(h){d=h}if(Ia(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 J2e(t){let e="skip";for(let o of t)bee[o.disposition]>bee[e]&&(e=o.disposition);let r=t.map(o=>{let s=o.why?` \xB7 ${o.why}`:"";return`${V2e[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:ii,pass:!1,exitCode:2,stderr:r,probes:n};let i=e==="fail"||e==="pending_env"||e==="advisory";return{stage:ii,pass:!i,exitCode:i?1:0,disposition:e,stderr:r,probes:n}}var Y2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${See.argv[1]}`;if(Y2e){let t=VN();console.log(JSON.stringify(t)),See.exit(t.exitCode)}jr();En();An();import wee from"node:process";var px="stage_3.1";function WN(t={}){let{cwd:e="."}=t,r=ht(e),n=r.gates.smoke,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:px,pass:!1,exitCode:2,stderr:`no smoke runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!xl(e,o[o.length-1]))return{stage:px,pass:!1,exitCode:2,stderr:"smoke npm script not defined"};let s=Je(i,[...o],{cwd:e,reject:!1}),a=Lt(px,i,s);return a||Yt(px,s)}var X2e=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${wee.argv[1]}`;if(X2e){let t=WN();console.log(JSON.stringify(t)),wee.exit(t.exitCode)}TP();KN();JN();jr();ux();import{randomBytes as oUe}from"node:crypto";import{unlinkSync as sUe}from"node:fs";import{tmpdir as aUe}from"node:os";import{join as cUe}from"node:path";import XN from"node:process";Rm();An();qe();import{readFileSync as tUe}from"node:fs";import{resolve as kee}from"node:path";function rUe(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=kee(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 nUe(t){let e=t.indexOf("#");return(e===-1?t:t.slice(0,e)).trim()}function iUe(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=nUe(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(kee(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 YN(t,e){try{let r=rUe(tUe(t,"utf8"));return r?iUe(H(e),r,e):[]}catch{return[]}}var Ao="stage_2.1";function Eee(t,e){return t==="vitest"||t.endsWith("/vitest")||e.includes("vitest")}function lUe(t,e,r){let n,i;try{({cmd:n,args:i}=Eo("coverage",t))}catch{return null}if(!n||!i||!Eee(n,i))return null;let o=n,s=i,a=dee(e,d=>Je(o,[...s,"--reporter=default","--reporter=json",`--outputFile=${d}`],{cwd:e,reject:!1}));if(!a)return null;let{proc:c,jsonFile:l}=a;if(Lt(Ao,n,c))return null;let u=Yt(Ao,c);if(pee(u)==="fallback")return null;if(r){let d=YN(l,e);if(d.length>0)return{stage:Ao,pass:!1,exitCode:1,findings:d,stderr:d[0].message}}return{stage:Ao,pass:!0,exitCode:0}}function QN(t={}){let{cwd:e=".",strict:r=!1}=t,n,i,o;try{({cmd:n,args:i,language:o}=Eo("test",t))}catch(u){return{stage:Ao,pass:!1,exitCode:1,stderr:u.message}}if(!n||!i)return{stage:Ao,pass:!1,exitCode:2,stderr:`no unit test runner registered for language '${o}'`};let s=Eee(n,i),a=r&&s;if(uee()&&s){let u=lUe(t,e,a);if(u)return u}let c,l=i;a&&(c=cUe(aUe(),`clad-vitest-${XN.pid}-${oUe(6).toString("hex")}.json`),l=[...i,"--reporter=default","--reporter=json",`--outputFile=${c}`]);try{let u=Je(n,[...l],{cwd:e,reject:!1}),d=Lt(Ao,n,u);if(d)return d;let f=du("unit",Yt(Ao,u),u);if(a&&f.pass&&c){let p=YN(c,e);if(p.length>0)return{stage:Ao,pass:!1,exitCode:1,findings:p,stderr:p[0].message}}return f}finally{if(c)try{sUe(c)}catch{}}}var uUe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${XN.argv[1]}`;if(uUe){let t=QN();console.log(JSON.stringify(t)),XN.exit(t.exitCode)}jr();En();An();import Aee from"node:process";var gx="stage_3.3";function ej(t={}){let{cwd:e="."}=t,r=ht(e),n=r.gates.visual,i=t.cmd??n?.cmd,o=t.args??n?.args;if(!i||!o)return{stage:gx,pass:!1,exitCode:2,stderr:`no visual runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!xl(e,o[o.length-1]))return{stage:gx,pass:!1,exitCode:2,stderr:"visual npm script not defined"};let s=Je(i,[...o],{cwd:e,reject:!1}),a=Lt(gx,i,s);return a||Yt(gx,s)}var dUe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Aee.argv[1]}`;if(dUe){let t=ej();console.log(JSON.stringify(t)),Aee.exit(t.exitCode)}RP();bf();ca();rj();op();Ev();var Dee=Et(cr(),1);import{existsSync as nj,readFileSync as wUe,readdirSync as Cee,statSync as xUe,writeFileSync as $Ue}from"node:fs";import{basename as Dm,join as Nm,relative as Pee}from"node:path";var kUe=["self-dogfood:","fixture:","derived:"],Nee=/\.(test|spec)\.[jt]sx?$/;function jee(t,e=t,r=[]){let n;try{n=Cee(e)}catch{return r}for(let i of n){if(i.startsWith("."))continue;let o=Nm(e,i);try{xUe(o).isDirectory()?jee(t,o,r):Nee.test(i)&&r.push(o)}catch{continue}}return r}function Mee(t="."){let e=Nm(t,"spec","features"),r=Nm(t,"tests"),n=[],i=[];if(!nj(e)||!nj(r))return{repaired:n,suggested:i};let o=jee(r),s=new Map;for(let a of o){let c=Pee(t,a).split("\\").join("/"),l=s.get(Dm(a))??[];l.push(c),s.set(Dm(a),l)}for(let a of Cee(e)){if(!a.endsWith(".yaml")&&!a.endsWith(".yml"))continue;let c=Nm(e,a),l,u;try{l=wUe(c,"utf8"),u=(0,Dee.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(kUe.some(x=>g.startsWith(x)))continue;let b=g.split("#",1)[0];if(nj(Nm(t,b)))continue;let _=s.get(Dm(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=>Dm(h).replace(/\.[jt]sx?$/,"")),m=o.map(h=>Pee(t,h).split("\\").join("/")).find(h=>{let g=Dm(h).replace(Nee,"");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 tte(t={}){let e=t.port!==void 0?Number(t.port):3e3;try{let r=await FUe({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 LUe=["stage_1.1","stage_2.1","stage_2.3"];function zUe(t){return(t.features??[]).filter(e=>e.status==="done")}function UUe(t,e){let r=zUe(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 rte(t,e){let r=[];for(let n of LUe){if(!e.some(s=>s.stage===n&&s.status==="skip"))continue;let o=UUe(t,n);o&&r.push({stage:n,label:"Verification",message:o})}return r}bS();import nte from"node:process";function qUe(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 Mx(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=qUe(n,t);i.pass||r.push(i)}return r}ri();var Tj="stage_4.1";function Oj(t={}){let{cwd:e="."}=t,r=Rn(e);if(r.length===0)return{stage:Tj,pass:!1,exitCode:2,stderr:"no audit log present \u2014 record evidence before running stage_4.1"};let n=Mx(r);if(n.length===0)return{stage:Tj,pass:!0,exitCode:0};let i=n.map(o=>`${o.acId}: ${o.reason}`).join("; ");return{stage:Tj,pass:!1,exitCode:1,stderr:`anti-self-cert guard: ${i}`}}var BUe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${nte.argv[1]}`;if(BUe){let t=Oj();console.log(JSON.stringify(t)),nte.exit(t.exitCode)}yl();import{randomBytes as HUe}from"node:crypto";import{unlinkSync as GUe}from"node:fs";import{tmpdir as ZUe}from"node:os";import{join as VUe,resolve as Rj}from"node:path";import WUe from"node:process";var qr=null;function ite(t){qr={cwd:Rj(t),run:null,jsonFile:null}}function ote(){return qr!==null}function ste(t,e){if(!qr||qr.cwd!==Rj(t))return null;if(qr.run)return qr.run;let r=VUe(ZUe(),`clad-shared-vitest-${WUe.pid}-${HUe(6).toString("hex")}.json`);qr.jsonFile=r;let n=e(r);return qr.run={proc:n,jsonFile:r},qr.run}function ate(t){return!qr||qr.cwd!==Rj(t)?null:qr.run}function cte(t){return t.pass&&t.exitCode===0?"reuse-pass":"fallback"}function lte(){let t=qr?.jsonFile;if(qr=null,t)try{GUe(t)}catch{}}Mr();import ute from"node:process";var Fx="stage_1.4";function Ij(t={}){let{cwd:e="."}=t,r;try{r=Ye("git",["status","--porcelain"],{cwd:e,reject:!1})}catch(i){if(i.code==="ENOENT")return{stage:Fx,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:Fx,pass:!1,exitCode:2,stderr:i}}let n=(r.stdout??"").toString().trim();return n.length===0?{stage:Fx,pass:!0,exitCode:0}:{stage:Fx,pass:!1,exitCode:1,stderr:`working tree dirty: +${n}`}}var KUe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${ute.argv[1]}`;if(KUe){let t=Ij();console.log(JSON.stringify(t)),ute.exit(t.exitCode)}Mr();import dte from"node:process";Jm();On();var Lx="stage_2.2";function Pj(t={}){let{cwd:e="."}=t,r,n,i;try{({cmd:r,args:n,language:i}=No("coverage",t))}catch(c){return{stage:Lx,pass:!1,exitCode:1,stderr:c.message}}if(!r||!n)return{stage:Lx,pass:!1,exitCode:2,stderr:`no coverage runner registered for language '${i}'`};let o=ate(e),s=o?o.proc:Ye(r,[...n],{cwd:e,reject:!1}),a=qt(Lx,r,s,n);return a||tr(Lx,s)}var XUe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${dte.argv[1]}`;if(XUe){let t=Pj();console.log(JSON.stringify(t)),dte.exit(t.exitCode)}Mp();Cj();Mr();on();On();import pte from"node:process";var Bx="stage_3.2";function Dj(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:Bx,pass:!1,exitCode:2,stderr:`no perf runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Ll(e,o[o.length-1]))return{stage:Bx,pass:!1,exitCode:2,stderr:"perf npm script not defined"};let s=Ye(i,[...o],{cwd:e,reject:!1}),a=qt(Bx,i,s,o);return a||tr(Bx,s)}var hqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${pte.argv[1]}`;if(hqe){let t=Dj();console.log(JSON.stringify(t)),pte.exit(t.exitCode)}Mr();Be();On();import{existsSync as gqe}from"node:fs";import{resolve as hte}from"node:path";import gte from"node:process";var li="stage_2.4",Nj=5e3,yqe=3e4;function jj(t={}){let{cwd:e="."}=t,r,n=[],i=!1,o=new Map;try{let p=H(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:li,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:li,pass:!1,exitCode:2,stderr:"no project.deliverable declared \u2014 skipped"};if(r.is_safe_to_smoke!==!0)return{stage:li,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not marked is_safe_to_smoke \u2014 skipped`};if(!i)return{stage:li,pass:!1,exitCode:2,stderr:"no done feature yet \u2014 deliverable smoke skipped"};let s=hte(e,r.path);if(!gqe(s))return{stage:li,pass:!1,exitCode:2,stderr:`deliverable '${r.path}' not found \u2014 see DELIVERABLE_INTEGRITY`};let a=r.timeout_ms??Nj,c;try{c=Ye(s,[...r.smoke_args??[]],{cwd:e,reject:!1,timeout:a})}catch(p){c=p}let l=qt(li,r.path,c);if(l)return l;if(c.timedOut)return{stage:li,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:li,pass:!0,exitCode:0,disposition:"liveness"};let f=String(c.stderr??"").trim()||String(c.stdout??"").trim();return{stage:li,pass:!1,exitCode:1,stderr:`deliverable '${r.path}' exited ${d}, expected ${u}${f?` \u2014 ${f.slice(0,200)}`:""}`}}var mte={fail:5,advisory:4,pending_env:4,liveness:3,pass:2,na:1,skip:0},_qe={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*Nj,yqe),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(vqe(t,s,r))}return Sqe(o)}function vqe(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("/")?hte(t,a):a,u=Nj,d;try{d=Ye(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 Sqe(t){let e="skip";for(let o of t)mte[o.disposition]>mte[e]&&(e=o.disposition);let r=t.map(o=>{let s=o.why?` \xB7 ${o.why}`:"";return`${_qe[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:li,pass:!1,exitCode:2,stderr:r,probes:n};let i=e==="fail"||e==="pending_env"||e==="advisory";return{stage:li,pass:!i,exitCode:i?1:0,disposition:e,stderr:r,probes:n}}var wqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${gte.argv[1]}`;if(wqe){let t=jj();console.log(JSON.stringify(t)),gte.exit(t.exitCode)}Mr();on();On();import yte from"node:process";var Hx="stage_3.1";function Mj(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:Hx,pass:!1,exitCode:2,stderr:`no smoke runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Ll(e,o[o.length-1]))return{stage:Hx,pass:!1,exitCode:2,stderr:"smoke npm script not defined"};let s=Ye(i,[...o],{cwd:e,reject:!1}),a=qt(Hx,i,s,o);return a||tr(Hx,s)}var xqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${yte.argv[1]}`;if(xqe){let t=Mj();console.log(JSON.stringify(t)),yte.exit(t.exitCode)}dC();Fj();Lj();Mr();Ux();import{randomBytes as Rqe}from"node:crypto";import{unlinkSync as Iqe}from"node:fs";import{tmpdir as Pqe}from"node:os";import{join as Cqe}from"node:path";import Uj from"node:process";Jm();On();Be();import{readFileSync as Eqe}from"node:fs";import{resolve as vte}from"node:path";function Aqe(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=vte(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 Tqe(t){let e=t.indexOf("#");return(e===-1?t:t.slice(0,e)).trim()}function Oqe(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=Tqe(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(vte(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=Aqe(Eqe(t,"utf8"));return r?Oqe(H(e),r,e):[]}catch{return[]}}var Ji="stage_2.1";function Ste(t,e){return t==="vitest"||t.endsWith("/vitest")||e.includes("vitest")}function Dqe(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];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 Nqe(t,e,r){let n,i;try{({cmd:n,args:i}=No("coverage",t))}catch{return null}if(!n||!i||!Ste(n,i))return null;let o=n,s=i,a=ste(e,d=>Ye(o,[...s,"--reporter=default","--reporter=json",`--outputFile=${d}`],{cwd:e,reject:!1}));if(!a)return null;let{proc:c,jsonFile:l}=a;if(qt(Ji,n,c,s))return null;let u=tr(Ji,c);if(cte(u)==="fallback")return null;if(r){let d=zj(l,e);if(d.length>0)return{stage:Ji,pass:!1,exitCode:1,findings:d,stderr:d[0].message}}return{stage:Ji,pass:!0,exitCode:0}}function qj(t={}){let{cwd:e=".",strict:r=!1}=t,n,i,o;try{({cmd:n,args:i,language:o}=No("test",t))}catch(u){return{stage:Ji,pass:!1,exitCode:1,stderr:u.message}}if(!n||!i)return{stage:Ji,pass:!1,exitCode:2,stderr:`no unit test runner registered for language '${o}'`};let s=Ste(n,i),a=r&&s;if(ote()&&s){let u=Nqe(t,e,a);if(u)return u}let c,l=i;a&&(c=Cqe(Pqe(),`clad-vitest-${Uj.pid}-${Rqe(6).toString("hex")}.json`),l=[...i,"--reporter=default","--reporter=json",`--outputFile=${c}`]);try{let u=Ye(n,[...l],{cwd:e,reject:!1}),d=qt(Ji,n,u,l);if(d)return d;let f=Ru("unit",tr(Ji,u),u);if(r&&f.pass&&Dqe(u)){let p={detector:"VACUOUS_TESTS",severity:"error",message:"The unit test command exited successfully but reported zero executed tests."};return{stage:Ji,pass:!1,exitCode:1,findings:[p],stderr:p.message}}if(a&&f.pass&&c){let p=zj(c,e);if(p.length>0)return{stage:Ji,pass:!1,exitCode:1,findings:p,stderr:p[0].message}}return f}finally{if(c)try{Iqe(c)}catch{}}}var jqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${Uj.argv[1]}`;if(jqe){let t=qj();console.log(JSON.stringify(t)),Uj.exit(t.exitCode)}Mr();on();On();import wte from"node:process";var Vx="stage_3.3";function Bj(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:Vx,pass:!1,exitCode:2,stderr:`no visual runner registered for language '${r.language}'`};if(i==="npm"&&o[0]==="run"&&!Ll(e,o[o.length-1]))return{stage:Vx,pass:!1,exitCode:2,stderr:"visual npm script not defined"};let s=Ye(i,[...o],{cwd:e,reject:!1}),a=qt(Vx,i,s,o);return a||tr(Vx,s)}var Mqe=!globalThis.__CLADDING_BUNDLED&&import.meta.url===`file://${wte.argv[1]}`;if(Mqe){let t=Bj();console.log(JSON.stringify(t)),wte.exit(t.exitCode)}pC();jf();_a();Gj();kp();Qv();var Ote=St(Qt(),1);import{existsSync as Zj,readFileSync as Wqe,readdirSync as Tte,statSync as Kqe,writeFileSync as Jqe}from"node:fs";import{basename as eh,join as th,relative as Ate}from"node:path";var Yqe=["self-dogfood:","fixture:","derived:"],Rte=/\.(test|spec)\.[jt]sx?$/;function Ite(t,e=t,r=[]){let n;try{n=Tte(e)}catch{return r}for(let i of n){if(i.startsWith("."))continue;let o=th(e,i);try{Kqe(o).isDirectory()?Ite(t,o,r):Rte.test(i)&&r.push(o)}catch{continue}}return r}function Pte(t="."){let e=th(t,"spec","features"),r=th(t,"tests"),n=[],i=[];if(!Zj(e)||!Zj(r))return{repaired:n,suggested:i};let o=Ite(r),s=new Map;for(let a of o){let c=Ate(t,a).split("\\").join("/"),l=s.get(eh(a))??[];l.push(c),s.set(eh(a),l)}for(let a of Tte(e)){if(!a.endsWith(".yaml")&&!a.endsWith(".yml"))continue;let c=th(e,a),l,u;try{l=Wqe(c,"utf8"),u=(0,Ote.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(Yqe.some(x=>g.startsWith(x)))continue;let b=g.split("#",1)[0];if(Zj(th(t,b)))continue;let _=s.get(eh(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=>eh(h).replace(/\.[jt]sx?$/,"")),m=o.map(h=>Ate(t,h).split("\\").join("/")).find(h=>{let g=eh(h).replace(Rte,"");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&&$Ue(c,l,"utf8")}return{repaired:n,suggested:i}}tl();import{existsSync as EUe,readFileSync as AUe}from"node:fs";import{join as TUe}from"node:path";function OUe(t,e){let r=TUe(t,e);if(!EUe(r))return[];let n=[];for(let i of AUe(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 Fee(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=>OUe(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 Lee(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(` -`)}Ov();qe();$i();Xn();tl();var ij=["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"],RUe=[...ij,"att"];function IUe(t,e,r){if(e.startsWith("stage_4")){let n=Tn(r);if(n.length===0)return"\xB7";let i=(t.acceptance_criteria??[]).map(s=>s.id);return sx(n).filter(s=>i.includes(s.acId)).length>0?"\u2717":"\u2713"}return"-"}function PUe(t,e,r){let n=t.modules??[];return t.status!=="done"||n.length===0?"\xB7":e===null?"-":p_(e,r,t).state==="fresh"?"\u2713":"!"}function vx(t,e="."){let r=Qo(e),n=t.features.map(i=>({featureId:i.id,title:i.title||i.id,status:i.status,cells:[...ij.map(o=>IUe(i,o,e)),PUe(i,r,e)]}));return{columns:RUe,rows:n}}function zee(t,e=".",r={}){let n=r.internal??!1,i=vx(t,e),o=[...ij.map(c=>n?c.replace("stage_",""):CUe(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 CUe(t){return _a(t).slice(0,3)}async function H3e(t){let[{buildServer:e},{StdioServerTransport:r},{setHostMcpServer:n}]=await Promise.all([Promise.resolve().then(()=>(Hle(),Ble)),Promise.resolve().then(()=>(Kle(),Wle)),Promise.resolve().then(()=>(Cp(),fX))]),i=e({cwd:t.cwd});n(i.server);let o=new r;V.stderr.write(`\xB7 serve stdio transport \xB7 cwd=${t.cwd??"."} -`),await i.connect(o)}async function G3e(t,e){let r=t&&t.length>0?t.join(" ").trim():void 0,n=await FQ({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});for(let o of n.created)M("pass",`created ${o}`);for(let o of n.skipped)M("skip",o);for(let o of n.proposals??[])M("note","proposal",o);let i=n.onboardingMode?`language: ${n.language} \xB7 mode: ${n.onboardingMode}`:`language: ${n.language}`;if(M("note","init done",i),n.clarifyingQuestions&&n.clarifyingQuestions.length>0){V.stdout.write(` +${_} - "derived:${m}"`),i.push({shard:a,ref:`derived:${m}`}),d=!0}d&&Jqe(c,l,"utf8")}return{repaired:n,suggested:i}}gl();import{existsSync as Xqe,readFileSync as Qqe}from"node:fs";import{join as e4e}from"node:path";function t4e(t,e){let r=e4e(t,e);if(!Xqe(r))return[];let n=[];for(let i of Qqe(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 Cte(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=>t4e(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 Dte(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(` +`)}rS();Be();Oi();ri();gl();var Vj=["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"],r4e=[...Vj,"att"];function n4e(t,e,r){if(e.startsWith("stage_4")){let n=Rn(r);if(n.length===0)return"\xB7";let i=(t.acceptance_criteria??[]).map(s=>s.id);return Mx(n).filter(s=>i.includes(s.acId)).length>0?"\u2717":"\u2713"}return"-"}function i4e(t,e,r){let n=t.modules??[];return t.status!=="done"||n.length===0?"\xB7":e===null?"-":q_(e,r,t).state==="fresh"?"\u2713":"!"}function Yx(t,e="."){let r=as(e),n=t.features.map(i=>({featureId:i.id,title:i.title||i.id,status:i.status,cells:[...Vj.map(o=>n4e(i,o,e)),i4e(i,r,e)]}));return{columns:r4e,rows:n}}function Nte(t,e=".",r={}){let n=r.internal??!1,i=Yx(t,e),o=[...Vj.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 P8e(t){let[{buildServer:e},{StdioServerTransport:r},{setHostMcpServer:n}]=await Promise.all([Promise.resolve().then(()=>(Jue(),Kue)),Promise.resolve().then(()=>(tde(),ede)),Promise.resolve().then(()=>(Xp(),s7))]),i=e({cwd:t.cwd,onboarding:{renderDraft:s=>Lee(s),prepareInit:({cwd:s,mode:a,intent:c})=>Mee(s,a,c),initialize:dj,prepareClarify:(s,{cwd:a})=>Fee(a,s),clarify:hj,resolveReview:(s,{cwd:a})=>Cee(s,{cwd:a})}});n(i.server);let o=new r;V.stderr.write(`\xB7 serve stdio transport \xB7 cwd=${t.cwd??"."} +`),await i.connect(o)}async function C8e(t,e){let r=t&&t.length>0?t.join(" ").trim():void 0,n=await dj({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){V.stdout.write(`${JSON.stringify(n,null,2)} +`),V.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){V.stdout.write(` \u{1F4A1} A few more details would sharpen the spec: `);for(let[o,s]of n.clarifyingQuestions.entries())V.stdout.write(` ${o+1}. ${s} `);V.stdout.write(` @@ -890,30 +920,30 @@ ${_} - "derived:${m}"`),i.push({shard:a,ref:`derived:${m}`}),d=!0}d&&$Ue(c,l,"u `),V.stdout.write(` e.g. clad init payment SaaS for B2B `),V.stdout.write(` The existing seeds divert to .cladding/scan/*.proposal. -`));V.exit(0)}async function Z3e(t,e){M("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(()=>(vue(),bue)),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)M(i,"run",`halt=${n.halt.class} iter=${n.iterations} features=${n.featuresTouched.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`),V.stdout.write(`${JSON.stringify(n,null,2)} -`);else{let s=H(e.cwd??"."),a=n.featuresTouched.map(l=>xO(l,s)),c=`${gH(n.halt,s)} iter=${n.iterations} features=${a.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`;M(i,"run",c),a.length>0&&V.stdout.write(`Touched: ${a.join(", ")} -`)}let o=n.stubsCreated.length>0;o&&M("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.`),V.exit(n.halt.class==="ALL_FEATURES_DONE"&&!o?0:1)}function V3e(t={}){try{let e=H();if(aa("."))M("note","sync","derived-file writes deferred \u2014 git operation in progress; re-run after the merge/rebase completes.");else{let r=ls(".");Al(".",r),La("."),j8(".");let n=Ml(".");n==="created"?M("note","agents.md","wrote a spec-driven AGENTS.md so non-Claude agents share the same guidance."):n==="updated"&&M("note","agents.md","refreshed the AGENTS.md managed block from the current spec.");let i=Mee(".");for(let s of i.repaired)M("note","test_refs",`repaired ${s.from} \u2192 ${s.to} (${s.shard})`);for(let s of i.suggested)M("note","test_refs",`suggested ${s.ref} (${s.shard}) \u2014 confirm by removing the 'derived:' prefix`);let o=bx(".");o&&M("note","deliverable",`auto-detected entry '${o.path}' \u2014 the gate now smoke-tests it (stage_2.4). Opt out with is_safe_to_smoke: false.`)}if(t.proposeArchive){let n=Iv.run({cwd:"."}).filter(i=>i.suggestion?.action==="propose-archive");if(n.length===0){M("pass","sync",`${e.features.length} features \xB7 0 archive candidates`),V.exit(0);return}for(let i of n){let o=i.suggestion?.args??{},s=String(o.featureId??"?"),a=String(o.reason??i.message);M("note",`propose-archive \xB7 ${s}`,a)}M("pass","sync",`${e.features.length} features \xB7 ${n.length} archive candidate(s)`),V.exit(0);return}M("pass","sync",`${e.features.length} features valid`),V.exit(0)}catch(e){M("fail","sync",e.message),V.exit(1)}}function W3e(t){if(!t){M("fail","checkpoint","feature id required (e.g. clad checkpoint F-001)"),V.exit(2);return}let e=Jy(".",t),r=e.gitHead?e.gitHead.slice(0,12):"(no git)";M("pass",`checkpoint \xB7 ${t}`,`head=${r} digest=${e.specDigest.slice(0,12)}`),V.exit(0)}function K3e(t,e={}){if(!t){M("fail","rollback","feature id required (e.g. clad rollback F-001)"),V.exit(2);return}let r=Yy(".",t);if(!r){M("fail",`rollback \xB7 ${t}`,"no prior checkpoint recorded"),V.exit(1);return}Xy(".",t,r,e.reason);let n=r.gitHead?r.gitHead.slice(0,12):"(no git)";M("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?V.stdout.write(`Run: git checkout ${r.gitHead} +`));V.exit(0)}async function D8e(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(()=>(Ede(),kde)),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}`),V.stdout.write(`${JSON.stringify(n,null,2)} +`);else{let s=H(e.cwd??"."),a=n.featuresTouched.map(l=>nR(l,s)),c=`${aG(n.halt,s)} iter=${n.iterations} features=${a.length} stubs=${n.stubsCreated.length} gates=${n.gateRuns}`;L(i,"run",c),a.length>0&&V.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.`),V.exit(n.halt.class==="ALL_FEATURES_DONE"&&!o?0:1)}function N8e(t={}){try{let e=H();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(".");Bl(".",r),Wa("."),R5(".");let n=eu(".");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=Pte(".");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=Jx(".");o&&L("note","deliverable",`auto-detected entry '${o.path}' \u2014 the gate now smoke-tests it (stage_2.4). Opt out with is_safe_to_smoke: false.`)}if(t.proposeArchive){let n=nS.run({cwd:"."}).filter(i=>i.suggestion?.action==="propose-archive");if(n.length===0){L("pass","sync",`${e.features.length} features \xB7 0 archive candidates`),V.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)`),V.exit(0);return}L("pass","sync",`${e.features.length} features valid`),V.exit(0)}catch(e){L("fail","sync",e.message),V.exit(1)}}function j8e(t){if(!t){L("fail","checkpoint","feature id required (e.g. clad checkpoint F-001)"),V.exit(2);return}let e=k_(".",t),r=e.gitHead?e.gitHead.slice(0,12):"(no git)";L("pass",`checkpoint \xB7 ${t}`,`head=${r} digest=${e.specDigest.slice(0,12)}`),V.exit(0)}function M8e(t,e={}){if(!t){L("fail","rollback","feature id required (e.g. clad rollback F-001)"),V.exit(2);return}let r=E_(".",t);if(!r){L("fail",`rollback \xB7 ${t}`,"no prior checkpoint recorded"),V.exit(1);return}A_(".",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?V.stdout.write(`Run: git checkout ${r.gitHead} `):V.stdout.write(`No git head pinned \u2014 restore spec.yaml manually from VCS history. -`),V.exit(0)}async function J3e(t){let e=await aC({force:t.force,quiet:t.quiet});V.exit(e.errors.length>0?1:0)}async function Y3e(){M("note","update","reconciling the current project after the engine upgrade");let t=await PY(".",{wireHosts:async()=>(await aC({quiet:!0})).errors.length});if(M(t.wiringErrors>0?"fail":"pass","hosts",t.wiringErrors>0?`${t.wiringErrors} wiring error(s)`:"re-wired"),!t.isProject){M("skip","spec","no spec.yaml here \u2014 run `clad init` to put this project under cladding"),V.exit(t.code);return}t.inventoryDeferred?M("note","spec",`inventory + index writes deferred \u2014 git operation in progress; re-run \`clad update\` after it completes (${t.features} features seen).`):M("pass","spec",`inventory synced \xB7 ${t.features} features`),M(t.claudeMd==="refreshed-stale"?"note":"pass","CLAUDE.md",t.claudeMd),M(t.agentsMd==="refreshed-stale"?"note":"pass","AGENTS.md",t.agentsMd);for(let r of t.deprecations)M("note","deprecated",r);V.stdout.write(` +`),V.exit(0)}async function F8e(t){let e=t.host?t.host==="all"?["claude","codex","gemini","antigravity","cursor"].slice():[t.host]:void 0,r=await ZC({force:t.force,quiet:t.quiet,projectRoot:t.project,hosts:e});V.exit(r.errors.length>0?1:0)}async function L8e(){L("note","update","reconciling the current project after the engine upgrade");let t=await EX(".",{wireHosts:async()=>(await ZC({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."),V.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);V.stdout.write(` \u2192 drift check (report-only \xB7 does not block, does not edit your spec): -`),BE({tier:"pre-commit",strict:!0}).anyFailed?V.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"):M("pass","drift","clean against the stricter detectors"),V.exit(t.code)}var X3e={"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 BE(t){let e=t.tier??"all",r=t.silent===!0,n=X3e[e];if(!n)return t.json&&!r?V.stdout.write(`${JSON.stringify({tier:e,error:`unknown tier '${e}'`,worst:2,anyFailed:!0,stages:[]},null,2)} -`):r||M("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",()=>Pm(i)],["stage_1.2",()=>Im(i)],["stage_1.3",()=>ei({...i,strict:t.strict})],["stage_1.4",qN],["stage_1.5",Ha],["stage_1.6",Ep],["stage_2.1",()=>QN({...i,strict:t.strict})],["stage_2.2",()=>BN(i)],["stage_2.3",AP],["stage_2.4",VN],["stage_3.1",WN],["stage_3.2",GN],["stage_3.3",ej],["stage_4.1",zN],["stage_4.2",Cm]].filter(([d])=>n.includes(d)),a=0,c=!1,l=d=>d==="pass"?"pass":d==="liveness"?"note":d==="na"?"skip":ti(d)?"fail":"skip",u=[];m_("."),lee(".");try{for(let[d,f]of s){let p=f({}),m=t.internal?d:_a(d),h=vY(p);ti(h)&&(c=!0,a=Math.max(a,SY(p,h))),u.push({stage:d,label:m,status:h,exitCode:p.exitCode,stderr:p.stderr,findings:p.findings}),!t.json&&!r&&(M(l(h),m),ti(h)&&sJe(p))}}finally{g_(),mee()}if(t.strict)try{let d=H();for(let f of aee(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&&M("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"||!ti(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=>ti(h.status)),a=c?Math.max(1,a):0,!t.json&&!r&&M("note","attestation","stale entries re-verified by this run \u2014 re-attesting")),!c&&!r)if(aa("."))t.json||M("note","attestation","deferred \u2014 git operation in progress; run the gate again after the merge/rebase completes.");else try{jH(".",H())&&(t.json||M("note","attestation","spec/attestation.yaml refreshed (verified tree stamped)"))}catch{}}return t.json&&!r?V.stdout.write(`${JSON.stringify({tier:e,worst:a,anyFailed:c,stages:u},null,2)} -`):c&&!r&&V.stdout.write("\n\u2139 Run `clad doctor` for the event log, or `clad sync` to validate spec shards. Drift findings above name the offending detector.\n"),lr(".","gate_run",{tier:e,strict:t.strict===!0,worst:a,anyFailed:c}),{worst:a,anyFailed:c,stages:u}}function Q3e(t){try{let e=H(),r=Wc(e,t);V.stdout.write(`${JSON.stringify(r,null,2)} -`),V.exit("not_found"in r?1:0)}catch(e){M("fail","context",e.message),V.exit(1)}}function eJe(t,e={}){try{let r=H(),n=e.depth!==void 0?Number(e.depth):void 0,i=yr(r,t,{depth:n});V.stdout.write(`${JSON.stringify(i,null,2)} -`),V.exit("not_found"in i?1:0)}catch(r){M("fail","impact",r.message),V.exit(1)}}function tJe(t={}){try{let e=H(),r=t.ambiguity!==void 0?Number(t.ambiguity):void 0,i=Mv(e,o=>{try{return wue(o,"utf8")}catch{return null}},r!==void 0?{maxOwnerAmbiguity:r}:{});V.stdout.write(`${JSON.stringify({suggestions:i.suggestions,new_edges:i.edges.length,already_declared:i.alreadyDeclared.length,dynamic_import_files:i.dynamicImportFiles},null,2)} -`),V.exit(0)}catch(e){M("fail","infer-deps",e.message),V.exit(1)}}function rJe(t={}){try{if(t.sessions){VQ(t);return}if(t.trend!==void 0&&t.trend!==!1){WQ(t);return}let e=H(),n=NB(e,o=>{try{return wue(o,"utf8")}catch{return null}},"."),i=MB(".",n);if(t.json)V.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)}`,` ${Kc}`];V.stdout.write(`${c.join(` +`),xA({tier:"pre-commit",strict:!0}).anyFailed?V.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"),V.exit(t.code)}var z8e={"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 xA(t){let e=t.tier??"all",r=t.silent===!0,n=z8e[e];if(!n)return t.json&&!r?V.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",()=>Xm(i)],["stage_1.2",()=>Ym(i)],["stage_1.3",()=>ii({...i,strict:t.strict})],["stage_1.4",Ij],["stage_1.5",rc],["stage_1.6",Gp],["stage_2.1",()=>qj({...i,strict:t.strict})],["stage_2.2",()=>Pj(i)],["stage_2.3",uC],["stage_2.4",jj],["stage_3.1",Mj],["stage_3.2",Dj],["stage_3.3",Bj],["stage_4.1",Oj],["stage_4.2",Qm]].filter(([d])=>n.includes(d)),a=0,c=!1,l=d=>d==="pass"?"pass":d==="liveness"?"note":d==="na"?"skip":si(d)?"fail":"skip",u=[];B_("."),ite(".");try{for(let[d,f]of s){let p=f({}),m=t.internal?d:Ta(d),h=pX(p);si(h)&&(c=!0,a=Math.max(a,mX(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),si(h)&&W8e(p))}}finally{G_(),lte()}if(t.strict)try{let d=H();for(let f of rte(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"||!si(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=>si(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{AG(".",H())&&(t.json||L("note","attestation","spec/attestation.yaml refreshed (verified tree stamped)"))}catch{}}return t.json&&!r?V.stdout.write(`${JSON.stringify({tier:e,worst:a,anyFailed:c,stages:u},null,2)} +`):c&&!r&&V.stdout.write("\n\u2139 Run `clad doctor` for the event log, or `clad sync` to validate spec shards. Drift findings above name the offending detector.\n"),er(".","gate_run",{tier:e,strict:t.strict===!0,worst:a,anyFailed:c}),{worst:a,anyFailed:c,stages:u}}function U8e(t){try{let e=H(),r=ll(e,t);V.stdout.write(`${JSON.stringify(r,null,2)} +`),V.exit("not_found"in r?1:0)}catch(e){L("fail","context",e.message),V.exit(1)}}function q8e(t,e={}){try{let r=H(),n=e.depth!==void 0?Number(e.depth):void 0,i=br(r,t,{depth:n});V.stdout.write(`${JSON.stringify(i,null,2)} +`),V.exit("not_found"in i?1:0)}catch(r){L("fail","impact",r.message),V.exit(1)}}function B8e(t={}){try{let e=H(),r=t.ambiguity!==void 0?Number(t.ambiguity):void 0,i=lS(e,o=>{try{return Tde(o,"utf8")}catch{return null}},r!==void 0?{maxOwnerAmbiguity:r}:{});V.stdout.write(`${JSON.stringify({suggestions:i.suggestions,new_edges:i.edges.length,already_declared:i.alreadyDeclared.length,dynamic_import_files:i.dynamicImportFiles},null,2)} +`),V.exit(0)}catch(e){L("fail","infer-deps",e.message),V.exit(1)}}function H8e(t={}){try{if(t.sessions){qee(t);return}if(t.trend!==void 0&&t.trend!==!1){Bee(t);return}let e=H(),n=EH(e,o=>{try{return Tde(o,"utf8")}catch{return null}},"."),i=TH(".",n);if(t.json)V.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)}`,` ${ul}`];V.stdout.write(`${c.join(` `)} -`),i.appended?M("note","measure","snapshot recorded to .cladding/measure.jsonl \u2014 see `clad measure --trend`"):i.reason==="deduped"?M("note","measure","commit+spec state unchanged since last snapshot \u2014 not recorded"):i.reason==="no_head"&&M("note","measure","no git HEAD \u2014 snapshot not recorded (commit first; a head-less line has no reproduce target)")}V.exit(0)}catch(e){M("fail","measure",e.message),V.exit(1)}}function nJe(t){let e;if(t.feature)try{let n=(H().features??[]).find(i=>i.id===t.feature||i.slug===t.feature);n||(M("fail","check",`no feature '${t.feature}' in spec \u2014 cannot scope gate`),V.exit(1)),e=n.modules}catch(r){M("fail","check",r.message),V.exit(1)}V.exitCode=BE({...t,focusModules:e}).worst}function iJe(t){let e=tY(".",t,{checkStages:BE,onIndex:La,gitOpInProgress:BT});M(e.ok?"pass":"fail",`done \xB7 ${t}`,e.reason),V.exit(e.code)}function oJe(t,e={}){let r=e.cwd??".",n;try{n=H(r)}catch(o){M("fail","oracle",`spec not loaded: ${o.message}`),V.exit(1);return}if(e.required){t&&V.stdout.write(`(note: --required lists the whole-project worklist; ignoring '${t}') -`);let o=z8(n);if(o.length===0){V.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)")}V.exit(0)}catch(e){L("fail","measure",e.message),V.exit(1)}}function G8e(t){let e;if(t.feature)try{let n=(H().features??[]).find(i=>i.id===t.feature||i.slug===t.feature);n||(L("fail","check",`no feature '${t.feature}' in spec \u2014 cannot scope gate`),V.exit(1)),e=n.modules}catch(r){L("fail","check",r.message),V.exit(1)}V.exitCode=xA({...t,focusModules:e}).worst}function Z8e(t){let e=WY(".",t,{checkStages:xA,onIndex:Wa,gitOpInProgress:xO});L(e.ok?"pass":"fail",`done \xB7 ${t}`,e.reason),V.exit(e.code)}function V8e(t,e={}){let r=e.cwd??".",n;try{n=H(r)}catch(o){L("fail","oracle",`spec not loaded: ${o.message}`),V.exit(1);return}if(e.required){t&&V.stdout.write(`(note: --required lists the whole-project worklist; ignoring '${t}') +`);let o=N5(n);if(o.length===0){V.stdout.write(`No oracles required \u2014 set project.oracle_policy or require_oracles, or no done ACs match the policy. `),V.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";V.stdout.write(` ${c} ${a.featureId}.${a.acId} [${a.reason}${a.ears?`:${a.ears}`:""}]${l} `)}V.stdout.write(` ${o.length} AC(s) required, ${s.length} missing an oracle. -`),V.exit(s.length>0?1:0);return}if(!t){M("fail","oracle","provide a to print its blind brief, or --required to list the ACs the policy needs an oracle for"),V.exit(1);return}let i=Fee(n,t,e.ac,r);if(!i||i.acs.length===0){M("fail","oracle",`no acceptance criteria for ${t}${e.ac?`.${e.ac}`:""} \u2014 nothing to author a blind oracle from`),V.exit(1);return}V.stdout.write(`${Lee(i)} -`),V.exit(0)}function sJe(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=Sue($f(i.detector,i.message),140),s=i.path?` \u2014 ${i.path}`:"";V.stdout.write(` ${o}${s} [${i.detector}] +`),V.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"),V.exit(1);return}let i=Cte(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`),V.exit(1);return}V.stdout.write(`${Dte(i)} +`),V.exit(0)}function W8e(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=Ade(Uf(i.detector,i.message),140),s=i.path?` \u2014 ${i.path}`:"";V.stdout.write(` ${o}${s} [${i.detector}] `)}n.length>3&&V.stdout.write(` \u2026 and ${n.length-3} more finding(s) `);return}if(t.stderr&&t.stderr.trim().length>0){let e=t.stderr.split(` -`).find(r=>r.trim().length>0);e&&V.stdout.write(` ${Sue(e.trim(),160)} -`)}}function Sue(t,e){return t.length<=e?t:`${t.slice(0,e-1)}\u2026`}function aJe(t){let e=H();if(t.json){V.stdout.write(`${JSON.stringify(vx(e,"."),null,2)} -`),V.exitCode=0;return}V.stdout.write(`${zee(e,".",{internal:t.internal})} -`),V.exit(0)}function cJe(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function lJe(t){let e=t.cwd??".",r=(t.out??"").trim();if(r.length===0){M("fail","bundle","missing --out \u2014 the bundle needs a destination path"),V.exit(1);return}let n;try{let i=H(e),o=vx(i,e),s={gitHead:ua(e),version:Pl(),generatedAt:t.now??new Date().toISOString()},a=Xc(i),c;try{let l=t.since??Wo(e),u=Ko(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:Jc(u),auditMarkdown:Yc(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=TH({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){M("fail","bundle",i.message),V.exit(1);return}try{B3e(r,n,"utf8")}catch(i){M("fail","bundle",`could not write ${r}: ${i.message}`),V.exit(1);return}M("pass","bundle",`${r} \xB7 ${cJe(Buffer.byteLength(n,"utf8"))}`),V.exit(0)}function uJe(t){let e=cA(t);M("note",`route \u2192 ${e}`,t),V.exit(e==="unknown"?1:0)}function dJe(){let t=new Eq;t.name("clad").description("Reference Ironclad CLI").version("0.8.3"),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.").action(G3e),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(Z3e),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(V3e),t.command("setup").description("Wire cladding into installed AI tool host channels (Claude Code / Codex / Gemini)").option("--force","overwrite directory-copy wires (Windows fallback) even when changes detected").option("--quiet","suppress stdout output").action(J3e),t.command("update").description("Run from a project dir AFTER `npm update -g cladding`: re-wire hosts + sync inventory + refresh the managed CLAUDE.md/AGENTS.md section, then report (without blocking) what the now-stricter detectors flag").action(Y3e),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(nJe),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(W3e),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(iJe),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)=>oJe(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(K3e),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(aJe),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(Q3e),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)=>eJe(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=>TY(r,{checkStages:BE})),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=>tJe(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=>rJe(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=>iee(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>oee()),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=>{see(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=>hH(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=>v5(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=>lJe(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(uJe),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(bY),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(H3e),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/gemini/codex) + Cursor 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){X5({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}x5(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(HQ),t}var fJe=!!globalThis.__CLADDING_BUNDLED,pJe=fJe||import.meta.url===`file://${V.argv[1]}`;pJe&&dJe().parse();export{X3e as TIER_STAGES,dJe as createProgram,lJe as runBundleCommand,nJe as runCheckCommand,BE as runCheckStages,W3e as runCheckpointCommand,Q3e as runContextCommand,iJe as runDoneCommand,eJe as runImpactCommand,tJe as runInferDepsCommand,G3e as runInitCommand,rJe as runMeasureCommand,oJe as runOracleCommand,K3e as runRollbackCommand,uJe as runRouteCommand,Z3e as runRunCommand,H3e as runServeCommand,J3e as runSetupCommand,aJe as runStatusCommand,V3e as runSyncCommand,Y3e as runUpdateCommand}; +`).find(r=>r.trim().length>0);e&&V.stdout.write(` ${Ade(e.trim(),160)} +`)}}function Ade(t,e){return t.length<=e?t:`${t.slice(0,e-1)}\u2026`}function K8e(t){let e=H();if(t.json){V.stdout.write(`${JSON.stringify(Yx(e,"."),null,2)} +`),V.exitCode=0;return}V.stdout.write(`${Nte(e,".",{internal:t.internal})} +`),V.exit(0)}function J8e(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(2)} MB`}function Y8e(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"),V.exit(1);return}let n;try{let i=H(e),o=Yx(i,e),s={gitHead:va(e),version:Wl(),generatedAt:t.now??new Date().toISOString()},a=pl(i),c;try{let l=t.since??rs(e),u=ns(e,l);c={kind:"present",sinceRef:l,changelogMarkdown:dl(u),auditMarkdown:fl(u,i,e)}}catch(l){c={kind:"omitted",reason:l.message}}n=bG({spec:i,panel:o,provenance:s,catalogMarkdown:a,changes:c})}catch(i){L("fail","bundle",i.message),V.exit(1);return}try{I8e(r,n,"utf8")}catch(i){L("fail","bundle",`could not write ${r}: ${i.message}`),V.exit(1);return}L("pass","bundle",`${r} \xB7 ${J8e(Buffer.byteLength(n,"utf8"))}`),V.exit(0)}function X8e(t){let e=qA(t);L("note",`route \u2192 ${e}`,t),V.exit(e==="unknown"?1:0)}function Q8e(){let t=new y4;t.name("clad").description("Reference Ironclad CLI").version("0.9.0"),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(C8e),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(D8e),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(N8e),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(F8e),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(L8e),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(G8e),t.command("checkpoint ").description("Record a checkpoint event pinning git HEAD + spec digest for the feature (iron-law \xA72.5)").action(j8e),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(Z8e),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)=>V8e(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(M8e),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(K8e),t.command("context ").description("Print the context slice for one feature \u2014 id (F-\u2026), slug, or module path (F-d2c806)").action(U8e),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)=>q8e(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=>SX(r,{checkStages:xA})),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=>B8e(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=>H8e(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=>Qee(r)),e.command("stats").description("Report node/edge counts by kind and the top hubs by degree").action(()=>ete()),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=>{tte(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=>sG(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=>gY(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=>Y8e(r)),t.command("route ").description("Classify a natural-language prompt to a verb").action(X8e),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(fX),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(P8e),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){GY({cwd:r.cwd,yes:r.yes,matrixOnly:r.matrixOnly});return}bY(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(jee),t}var e5e=!!globalThis.__CLADDING_BUNDLED,t5e=e5e||import.meta.url===`file://${V.argv[1]}`;t5e&&Q8e().parse();export{z8e as TIER_STAGES,Q8e as createProgram,Y8e as runBundleCommand,G8e as runCheckCommand,xA as runCheckStages,j8e as runCheckpointCommand,U8e as runContextCommand,Z8e as runDoneCommand,q8e as runImpactCommand,B8e as runInferDepsCommand,C8e as runInitCommand,H8e as runMeasureCommand,V8e as runOracleCommand,M8e as runRollbackCommand,X8e as runRouteCommand,D8e as runRunCommand,P8e as runServeCommand,F8e as runSetupCommand,K8e as runStatusCommand,N8e as runSyncCommand,L8e as runUpdateCommand}; diff --git a/plugins/claude-code/dist/schema.json b/plugins/claude-code/dist/schema.json index 9a588552..6092fd53 100644 --- a/plugins/claude-code/dist/schema.json +++ b/plugins/claude-code/dist/schema.json @@ -18,6 +18,10 @@ "properties": { "name": {"type": "string", "minLength": 1}, "language": {"type": "string", "minLength": 1}, + "onboarding_seeded": { + "type": "boolean", + "description": "True only when Cladding init authored the initial governance seeds. Used to scope early-project advisory findings without changing legacy-project behavior." + }, "description": { "type": "string", "description": "One-line summary of what the project is for. Used as the spec.yaml 'front door' hint." @@ -194,6 +198,18 @@ "type": "array", "items": {"$ref": "#/definitions/acceptance_criterion"} }, + "design_impact": { + "type": "object", + "required": ["classification", "rationale", "status"], + "additionalProperties": false, + "properties": { + "classification": {"type": "string", "enum": ["none", "additive", "structural"]}, + "rationale": {"type": "string", "minLength": 1}, + "status": {"type": "string", "enum": ["resolved", "review_required"]}, + "artifacts": {"type": "array", "items": {"type": "string"}}, + "baseline_digests": {"type": "object", "additionalProperties": {"type": "string"}} + } + }, "depends_on": { "type": "array", "items": {"type": "string", "pattern": "^F-(\\d{3,}|[a-f0-9]{6,})$"} diff --git a/plugins/codex/.codex-plugin/plugin.json b/plugins/codex/.codex-plugin/plugin.json index 7542c329..f2d4db20 100644 --- a/plugins/codex/.codex-plugin/plugin.json +++ b/plugins/codex/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.8.3", + "version": "0.9.0", "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/codex/skills/blind-author/SKILL.md b/plugins/codex/skills/blind-author/SKILL.md index dac74eea..8b0eacab 100644 --- a/plugins/codex/skills/blind-author/SKILL.md +++ b/plugins/codex/skills/blind-author/SKILL.md @@ -1,6 +1,6 @@ --- name: blind-author -description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. +description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Write, Bash capabilities: [write, exec] --- diff --git a/plugins/codex/skills/changelog/SKILL.md b/plugins/codex/skills/changelog/SKILL.md index e118076c..a518a6b0 100644 --- a/plugins/codex/skills/changelog/SKILL.md +++ b/plugins/codex/skills/changelog/SKILL.md @@ -1,5 +1,5 @@ --- -description: Render release notes / a changelog from the cladding spec. Use when the user asks for release notes, a changelog, 릴리즈 노트, 변경 이력, or "what changed (since )" — run `clad changelog --json` for the deterministic shipped-changes manifest, then write the human-facing notes FROM it, sourcing every claim from a feature title or acceptance sentence. For audit asks, print the --audit table verbatim. +description: Render release notes / a changelog from the cladding spec. Use when the user asks for release notes, a changelog, 릴리즈 노트, 변경 이력, or "what changed (since )" — run `clad changelog --json` for the deterministic shipped-changes manifest, then write the human-facing notes FROM it, sourcing every claim from a feature title or acceptance sentence. For audit asks, print the --audit table verbatim. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding changelog — release notes from the spec diff --git a/plugins/codex/skills/check/SKILL.md b/plugins/codex/skills/check/SKILL.md index f0b82fcb..fe7bb3ea 100644 --- a/plugins/codex/skills/check/SKILL.md +++ b/plugins/codex/skills/check/SKILL.md @@ -1,5 +1,5 @@ --- -description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. +description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding check @@ -10,7 +10,7 @@ Run `clad check` from the project root. Runs the 15 Iron Law stages — Type / L - `1` — at least one stage actually failed (fix-required). - `2` — every result is skip (no fail-required input on the project yet). -`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` (37/37 as of v0.6.1 — `npm run build:plugin` Phase D recounts and writes the integer into `.claude-plugin/plugin.json`). +`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` — `npm run build:plugin` Phase D recounts them and writes the integer into each plugin manifest (e.g. `plugins/claude-code/.claude-plugin/plugin.json`), so the number is never hand-maintained. `--internal` shows stage codes (`stage_1.1`) instead of business names (`Type`). Default is the business-name surface; the audit log keeps internal ids regardless. diff --git a/plugins/codex/skills/checkpoint/SKILL.md b/plugins/codex/skills/checkpoint/SKILL.md index 8f46d20c..fd5cec9c 100644 --- a/plugins/codex/skills/checkpoint/SKILL.md +++ b/plugins/codex/skills/checkpoint/SKILL.md @@ -1,5 +1,5 @@ --- -description: Record a feature checkpoint event pinning the current git HEAD plus a spec digest, so a later rollback can restore the exact pre-change state. Use before a non-trivial feature implementation, before a refactor that touches many files, or whenever the user wants a known-good safety net the autonomous drive loop can fall back to. +description: Record a feature checkpoint event pinning the current git HEAD plus a spec digest, so a later rollback can restore the exact pre-change state. Use before a non-trivial feature implementation, before a refactor that touches many files, or whenever the user wants a known-good safety net the autonomous drive loop can fall back to. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding checkpoint diff --git a/plugins/codex/skills/clarify/SKILL.md b/plugins/codex/skills/clarify/SKILL.md index f92b3a3c..30f51495 100644 --- a/plugins/codex/skills/clarify/SKILL.md +++ b/plugins/codex/skills/clarify/SKILL.md @@ -1,83 +1,18 @@ --- -description: Advance the onboarding Q&A loop after `clad init `. Pass the user's answer to the next pending question as a positional argument; 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`. Use when the user is mid-onboarding and you have collected their reply to one clarifying question — never invent answers. +description: Advance Cladding onboarding after the user answers a pending product question. Use the MCP prepare/apply flow, preserve the answer verbatim, and never invent answers. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- -# Cladding clarify (formerly `refine`) +# Cladding clarify -Drives the **iterative onboarding loop** initiated by `clad init `. The init pass writes `.cladding/onboarding/state.yaml` with 2–3 clarifying questions; `clad clarify ` advances the loop one question at a time. +Use this workflow only for an answer contained in a new user message after Cladding displayed the pending question. Never infer, synthesize, or reuse an answer from an initialization turn. If no new user answer exists, stop without calling either clarify tool. -## Artifacts produced (by Tier) +Use this workflow only after Cladding initialization returned a pending question and the user has answered it. -| Tier | File | Authority | -|---|---|---| -| A | `spec/scenarios/-.yaml` (refined, v0.3.45+) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` (refined) | Design SSoT | -| B | `spec/capabilities.yaml` (refined) | Design SSoT | -| B | `docs/project-context.md` (refined) | Design SSoT | -| D | `.cladding/onboarding/state.yaml` (Q&A history updated) | transient audit | +1. Call `clad_prepare_clarify` with the user's answer verbatim. +2. Read the returned prompt, current state, and artifacts. Draft the structured refinement required by `clad_clarify` using the current host model. +3. Call `clad_clarify` with the same answer, the one-time token, and the draft. +4. Ask `nextQuestion` verbatim when one remains. +5. If the result is `needs_review`, show the proposal diffs for every `pendingReview` target and wait for explicit user approval. Only then call `clad_resolve_onboarding_review` with the approved targets. Never describe onboarding as complete while review remains. +6. Report completion only when the returned status is `done`. -Existing files divert to `.cladding/scan/*.proposal` per the SSoT model's refresh policy. See [`docs/ssot-model.md`](../../docs/ssot-model.md). - -## Flow - -1. `clad init ` → produces initial artifacts + writes `state.yaml` with pending questions -2. Orchestrator asks the user the **first pending question verbatim** -3. User replies -4. Orchestrator runs `clad clarify ` (positional, no quotes needed) -5. `clad clarify` marks the question answered, re-runs the LLM with the full Q-A history, refines artifacts, may add new follow-up questions -6. Loop until `status: done` - -## Variadic positional - -``` -clad clarify 법인 사업자만 (개인사업자 제외) -clad clarify "한국 시장 위주" -clad clarify 카드 + 간편결제 우선 -``` - -All tokens are joined with spaces — quoting is optional. - -## Flags - -- `--cwd ` — directory containing `.cladding/onboarding/state.yaml` (default cwd) -- `--no-llm` — force deterministic interpreter; current artifact bodies are preserved and the answer is logged as a Q&A footnote in `docs/project-context.md` -- `--json` — emit a `RefineReport` JSON (`{cwd, answered, newQuestions, mode, status}`) instead of the formatted text - -## Output (text mode) - -- Pulse summary line — `✓ clarify answered · mode: greenfield · source: llm` -- Created / proposal entries for refined artifacts (existing files divert to `.cladding/scan/*.proposal`) -- New clarifying questions printed as a numbered list (if any) -- Closing line — `남은 질문: N 개. clad clarify <답변> 으로 계속.` OR `✓ 모든 질문에 답변 완료 — 온보딩 종료.` - -## Exit codes - -- `0` — answer accepted (or no-op when state is already done) -- `1` — fatal error (corrupt state file) -- `2` — usage error (no state file present, or no answer provided) - -## State file - -`.cladding/onboarding/state.yaml` shape: - -```yaml -intent: "결제 SaaS for B2B" -language: typescript -projectName: payment-saas -mode: greenfield -startedAt: 2026-05-21T12:34:56.789Z -status: active -qa: - - question: "주 사용자가 개인? 사업자?" - answer: "법인 사업자만" - - question: "어떤 결제수단 우선?" - answer: null -``` - -`status: done` is set once every question has an answer AND the latest refinement returned no new questions. The file stays on disk as an audit log of the onboarding decisions. - -## When NOT to invoke - -- `state.yaml` does not exist → exit 2. Run `clad init ` first. -- The user has not replied yet — never invent answers. Wait for their actual response. -- The user is asking about an unrelated topic — pause the loop and resume later when they're ready. +Do not run `clad clarify` in a shell from an AI host. Do not use MCP sampling. Never answer a product question on the user's behalf. A stale, malformed, replayed, or answer-mismatched apply request is a no-op and must be prepared again. diff --git a/plugins/codex/skills/developer/SKILL.md b/plugins/codex/skills/developer/SKILL.md index 6d1c2835..7393b7cf 100644 --- a/plugins/codex/skills/developer/SKILL.md +++ b/plugins/codex/skills/developer/SKILL.md @@ -1,6 +1,6 @@ --- name: developer -description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. +description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. 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 capabilities: [read, write, edit, exec] --- diff --git a/plugins/codex/skills/doctor/SKILL.md b/plugins/codex/skills/doctor/SKILL.md index 46d6c487..10214faa 100644 --- a/plugins/codex/skills/doctor/SKILL.md +++ b/plugins/codex/skills/doctor/SKILL.md @@ -1,5 +1,5 @@ --- -description: Summarise .cladding/events.log.jsonl — sentinel-miss frequency by phase × cause × fallback plus the top missed sentinels. Use when the user asks whether their LLM dispatcher (MCP sampling host, Anthropic SDK, …) is healthy, when scan / drive results look thinner than expected, or as a one-shot triage before tuning model / max_tokens / temperature. +description: Summarise .cladding/events.log.jsonl — sentinel-miss frequency by phase × cause × fallback plus the top missed sentinels. Use when the user asks whether their LLM dispatcher (MCP sampling host, Anthropic SDK, …) is healthy, when scan / drive results look thinner than expected, or as a one-shot triage before tuning model / max_tokens / temperature. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding doctor diff --git a/plugins/codex/skills/init/SKILL.md b/plugins/codex/skills/init/SKILL.md index 3b5bec99..1de064d0 100644 --- a/plugins/codex/skills/init/SKILL.md +++ b/plugins/codex/skills/init/SKILL.md @@ -1,101 +1,28 @@ --- -description: Scaffold a cladding workspace. Pass a free-text project description as positional argument to drive intent-aware onboarding — the LLM produces domain-aware spec/docs plus product-level follow-up questions. Use when the user wants to start a new Ironclad project, adopt cladding into an existing repo, or refresh artifacts via re-scan. +name: init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. --- # Cladding init -Run `clad init` from the directory where the cladding workspace should live. Idempotent — skips files that already exist unless `--force` is supplied. +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. -## Artifacts produced (by Tier) +## Required host workflow -| Tier | File | Authority | -|---|---|---| -| A | `spec.yaml` (seed) | Spec SSoT (Iron Law sealed) | -| A | `spec/scenarios/-.yaml` (v0.3.45+, intent path only) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` | Design SSoT | -| B | `spec/capabilities.yaml` | Design SSoT | -| B | `docs/project-context.md` | Design SSoT (intent + Why/What/Purpose) | -| C | `docs/conventions.md` | derived from observed code OR greenfield seed | -| D | `.cladding/onboarding/state.yaml` (intent path only) | transient — Q&A audit | +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier governance. +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. -## Intent-aware onboarding (v0.3.43+) +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. -The strongest path is to pass the user's project intent as positional argument (no `--intent` keyword, no quotes needed): +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. -``` -clad init 결제 SaaS for B2B Stripe Toss 지원 -clad init AI 코드 리뷰 봇 만들거야 -clad init 이 프로젝트 분석해서 클래딩 적용해줘 -``` - -The LLM dispatcher then produces **domain-aware** artifacts that exceed what the user explicitly stated: - -- `docs/project-context.md` — Why/What/Purpose with inferred domain context (compliance norms, scale assumptions, common patterns) -- `spec/capabilities.yaml` — user-stated + inferred capabilities (3-8 entries; payment → idempotency, webhook signing; ML → data lineage, eval harness; SaaS → multi-tenancy, audit log) -- `spec/architecture.yaml` — layers tailored to domain + language -- 2-3 follow-up clarifying questions printed to stdout as CLI hints (product/business level — not technical jargon) - -**AI orchestrators MUST ask the user for intent before invoking `clad init` on a greenfield workspace** (see `src/agents/orchestrator.md` principle 6). A bare `clad init` on a brand-new project falls back to generic toolchain seeds and misses the user's intent. For existing projects (≥3 source files) bare `clad init` is fine — the observed scan path captures shape directly. - -## Flags - -- `--name ` — override the project name (default: cwd basename). -- `--force` — overwrite an existing `spec.yaml`. -- `--scan` — force-walk the existing codebase to write observed artifacts. Default auto-detects (≥3 source files trigger scan); use `--no-scan` to skip even when source is present. Orthogonal to positional intent — can combine (`clad init 결제 SaaS --scan`). -- `--no-llm` — force the deterministic interpreter. Intent text still routes but falls back to a deterministic body quoting the intent verbatim. -- `--roots ` — comma-separated source-root override (e.g. `packages/a/src,packages/b/src`). Otherwise inferred from manifests + directory heuristics. - -When `--scan` runs (or auto-runs on a codebase with ≥3 source files) it writes: - -- `docs/conventions.md` — observed indent / quote / naming / error-handling / test-location conventions plus a representative module quote. -- `spec/architecture.yaml` — observed layers + forbidden-import candidates derived from the import graph. -- `spec/capabilities.yaml` — README `##` headings rendered as capability candidates (v0.3.38+). -- `docs/project-context.md` — forest-level Why / What / Purpose; LLM-refined when a dispatcher is available, deterministic template otherwise. -- `spec/scenarios/README.md` — explains the scenarios-are-intent policy (v0.3.30+). - -Existing files are diverted to `.cladding/scan/*.proposal` rather than overwritten. - -### Greenfield seeds (v0.3.42+) - -When `--scan` does **not** fire (brand-new project with <3 source files), `clad init` still writes the same three artifacts as **greenfield seeds** so the spec/docs surface is always complete: - -- `docs/conventions.md` — toolchain-default 14-signal table. TypeScript → 2-space + single quote + camelCase + `tests-dir` test layout, Python → 4-space + double quote + snake_case, Go → tab + PascalCase + `sibling-test`, Rust → 4-space + snake_case + result-pattern, etc. Each seed inlines a one-line link to the canonical style guide (Google TS / PEP 8 / Effective Go / Google Java / …). -- `spec/architecture.yaml` — `version: "0.1"` + empty `layers: []` + a language-specific baseline suggestion in the header comment (TypeScript → `src/cli/` / `src/core/` / `src/lib/` / `src/ui/`, Python → `src//` / `tests/`, Go → `cmd/` / `pkg/` / `internal/`, …). -- `spec/capabilities.yaml` — `schema: "0.1"` + `source: README.md` + empty `capabilities: []` + guidance comment on the per-entry shape. - -Each seed carries a header marking it as a greenfield template. After you write initial code (and optionally a README), re-run `clad init --scan`; the observed bodies divert to `.cladding/scan/.proposal` so you can diff seed vs reality and merge the parts you want. Personas downstream (`developer`, `planner`) therefore treat every scan artifact as **always present**, with the SEED header telling them which mode is live. - -After init: - -1. Edit `spec.yaml` (project metadata). Features are added on demand — ask the AI in natural language ("add a feature for login flow"), call the `clad_create_feature` MCP tool, or use the `clad` CLI. Feature shards always use the hash-based id `F-` (v0.3.9+) — filename `-.yaml`, `id: F-`, `slug: `. `clad init` does **not** write a legacy `F-001` placeholder for external users (v0.4.0+). -2. Run `clad sync` to verify the spec is valid. -3. Run `clad check` to see which Iron Law stages are wired up for the toolchain cladding detects in the cwd. -4. (Optional) Run `clad doctor` to confirm `.cladding/events.log.jsonl` shows no `sentinel_miss` events from the scan refinement. - -``` -clad init # bare (greenfield seeds + hint, or observed scan) -clad init 결제 SaaS for B2B # intent-aware onboarding (positional, no quotes needed) -clad init "AI 코드 리뷰 봇" # quotes OK too -clad init 이 프로젝트 분석해서 클래딩 적용해줘 # intent that signals existing adoption -clad init docs/plan.md # path-aware intent (v0.3.61+) — file contents auto-loaded as intent -clad init /absolute/path/spec.md # absolute path also supported (same .md/.txt/.yaml/.yml/.markdown rule) -clad init --name my-project -clad init --force -clad init --scan --no-llm -clad init --roots packages/a/src,packages/b/src -``` - -## Path-aware intent (v0.3.61+, F-5f6b45) - -When the positional argument looks like a text-file path (recognized extension `.md` / `.txt` / `.yaml` / `.yml` / `.markdown`) and the file exists under cwd, cladding loads the file body and forwards *that* to the onboarding LLM dispatcher — not the literal path string. This closes the gap where `clad init "$(cat docs/plan.md)"` (shell substitution) was the only way to feed a planning document into onboarding. - -Behavior: - -- **Existing text file** → contents become the intent. stderr prints `loaded intent from ` for transparency. -- **Missing file** with a path-like extension → stderr warning + free-text fallback (the literal argument is forwarded as intent so onboarding still runs). -- **Directory** ending in `.md` (rare) → stderr warning + free-text fallback. -- **Non-text argument** (e.g. `결제 SaaS 만들거야`) → existing free-text behavior, zero regression. - -Plugin invocations (`/cladding init docs/plan.md` from Claude Code · Codex CLI · Gemini CLI marketplace installs) inherit this behavior automatically — every plugin skill shells out to the same `clad init` CLI. +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/plugins/codex/skills/observability/SKILL.md b/plugins/codex/skills/observability/SKILL.md index da1e4251..5beb1a28 100644 --- a/plugins/codex/skills/observability/SKILL.md +++ b/plugins/codex/skills/observability/SKILL.md @@ -1,6 +1,6 @@ --- name: observability -description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. +description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/codex/skills/oracle/SKILL.md b/plugins/codex/skills/oracle/SKILL.md index 12bad6aa..578e37ef 100644 --- a/plugins/codex/skills/oracle/SKILL.md +++ b/plugins/codex/skills/oracle/SKILL.md @@ -1,5 +1,5 @@ --- -description: Author an IMPL-BLIND spec-conformance oracle for a feature's acceptance criterion, so the gate verifies the code matches the SPEC (not just the author's own tests). cladding calls no LLM — YOU spawn a blind sub-agent from a spec-only brief, then record it. Author ONLY what `clad oracle --required` lists (the policy worklist) — an empty worklist means do not author unless the user explicitly asks; out-of-policy recordings are labeled voluntary and spend beyond the project's declared verification budget. +description: Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`) demands — an empty worklist means don't author unless the user explicitly asks. YOU spawn a blind sub-agent from a spec-only brief, then record it. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding oracle — impl-blind conformance authoring diff --git a/plugins/codex/skills/orchestrator/SKILL.md b/plugins/codex/skills/orchestrator/SKILL.md index 49b89e79..bf8d0c1e 100644 --- a/plugins/codex/skills/orchestrator/SKILL.md +++ b/plugins/codex/skills/orchestrator/SKILL.md @@ -1,6 +1,6 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. +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. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- @@ -29,17 +29,7 @@ You do NOT pre-load Tier C (conventions — developer's concern). 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 + refine policy (의무)** — Two-step Q&A loop that captures intent and refines spec/docs through the user's own answers. - - **Step 6a (init).** Before calling `clad init` on a greenfield project (empty directory or `<3` source files), **ASK THE USER for their project intent in one line**. A natural question is enough: "어떤 종류의 프로젝트인가요? 한 줄로 설명해주세요". Forward the user's reply as the positional intent: `clad init ` (no quotes needed — commander treats trailing tokens as variadic). The init handler routes the LLM to produce a domain-aware project-context + capabilities + architecture + a real first-feature title (used when the AI later registers the first feature via `clad_create_feature`) + 2-3 product-level clarifying questions, and writes `.cladding/onboarding/state.yaml` with the questions marked pending. DO NOT call bare `clad init` on a greenfield workspace — the result is a generic toolchain scaffold that misses the user's actual intent. (For an existing project ≥3 source files, bare `clad init` is fine — the observed scan path captures the codebase shape directly.) - - **Step 6b (clarify loop).** After init, drive the Q&A loop until the onboarding state file is marked `status: done`: - - Read `.cladding/onboarding/state.yaml` and find the first `answer: null` entry. - - Ask the user that exact question in chat, verbatim. Do NOT rephrase technical-sounding questions into your own words — the LLM calibrated them at product-owner vocabulary level. - - When the user replies, run `clad clarify ` (no quotes needed). The handler marks the question answered, calls the LLM with the full Q-A history, refines `docs/project-context.md` + `spec/capabilities.yaml` + `spec/architecture.yaml`, and may add new follow-up questions. - - Loop until `clad clarify --json` reports `status: "done"` OR the user says they have enough. Never invent extra questions — only the LLM's questions are sanctioned for this loop. - - If the user declines to answer a question, accept that and skip it (they can revisit via `clad clarify ` later, since pending state persists). +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 diff --git a/plugins/codex/skills/planner/SKILL.md b/plugins/codex/skills/planner/SKILL.md index b2f7ed45..7736e7b7 100644 --- a/plugins/codex/skills/planner/SKILL.md +++ b/plugins/codex/skills/planner/SKILL.md @@ -1,6 +1,6 @@ --- name: planner -description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. +description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. 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 capabilities: [read, write, edit, exec] --- @@ -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. `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). Pre-v0.3.30 auto-extraction from code is deprecated. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/plugins/codex/skills/reviewer/SKILL.md b/plugins/codex/skills/reviewer/SKILL.md index 99246fc8..837d92e0 100644 --- a/plugins/codex/skills/reviewer/SKILL.md +++ b/plugins/codex/skills/reviewer/SKILL.md @@ -1,6 +1,6 @@ --- name: reviewer -description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. +description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/plugins/codex/skills/rollback/SKILL.md b/plugins/codex/skills/rollback/SKILL.md index be861be3..80cfe7b4 100644 --- a/plugins/codex/skills/rollback/SKILL.md +++ b/plugins/codex/skills/rollback/SKILL.md @@ -1,5 +1,5 @@ --- -description: Record a rollback event and print the maintainer-runnable git command for the most recent checkpoint of a feature. Use when an implementation attempt failed, an autonomous drive loop hit RETRY_THRESHOLD, or the user wants to abandon the current attempt and restore the pre-checkpoint state. +description: Record a rollback event and print the maintainer-runnable git command for the most recent checkpoint of a feature. Use when an implementation attempt failed, an autonomous drive loop hit RETRY_THRESHOLD, or the user wants to abandon the current attempt and restore the pre-checkpoint state. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding rollback diff --git a/plugins/codex/skills/route/SKILL.md b/plugins/codex/skills/route/SKILL.md index 2210cbfa..ebe706b0 100644 --- a/plugins/codex/skills/route/SKILL.md +++ b/plugins/codex/skills/route/SKILL.md @@ -1,5 +1,5 @@ --- -description: Classify a natural-language prompt to one of cladding's verbs. Use when the user describes work in their own words and you want to see which built-in verb cladding's intent classifier would pick — primarily a debugging tool for the orchestrator persona and for verifying the router's coverage after adding new verbs. +description: Classify a natural-language prompt to one of cladding's verbs. Use when the user describes work in their own words and you want to see which built-in verb cladding's intent classifier would pick — primarily a debugging tool for the orchestrator persona and for verifying the router's coverage after adding new verbs. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding route diff --git a/plugins/codex/skills/run/SKILL.md b/plugins/codex/skills/run/SKILL.md index 7c4cdb5b..28684de2 100644 --- a/plugins/codex/skills/run/SKILL.md +++ b/plugins/codex/skills/run/SKILL.md @@ -1,5 +1,5 @@ --- -description: Run cladding's autonomous loop — iterate ready features, dispatch the developer + reviewer personas through the active host adapter, run L1 gates, halt on HUMAN_REQUIRED or transport failure. Use only when the user explicitly asks for autonomous progress; the loop will modify files. +description: Run cladding's autonomous loop — iterate ready features, dispatch the developer + reviewer personas through the active host adapter, run L1 gates, halt on HUMAN_REQUIRED or transport failure. Use only when the user explicitly asks for autonomous progress; the loop will modify files. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding run (formerly `drive`) diff --git a/plugins/codex/skills/serve/SKILL.md b/plugins/codex/skills/serve/SKILL.md index 7f7a2677..db8c10e1 100644 --- a/plugins/codex/skills/serve/SKILL.md +++ b/plugins/codex/skills/serve/SKILL.md @@ -1,12 +1,12 @@ --- -description: Boot cladding as an MCP server over stdio. Use only when the user wants to expose cladding's tools, resources, and persona prompts to a separate MCP client. Most users don't run this directly — the plugin's .mcp.json launches it automatically. +description: Boot cladding as an MCP server over stdio. Use only when the user wants to expose cladding's tools, resources, and persona prompts to a separate MCP client. Most users don't run this directly — the plugin's .mcp.json launches it automatically. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding serve Run `clad serve` from the project root. Boots an MCP server over stdio that exposes: -- **Tools**: `clad_list_features`, `clad_get_feature`, `clad_run_check`, `clad_get_events`. +- **Tools**: the full development surface (feature/graph/context queries, checks, gate, changelog) plus the natural-language onboarding flow — `clad_prepare_init` / `clad_stage_init` / `clad_init` and the clarify pair. Before `spec.yaml` exists only the three onboarding bootstrap tools are exposed. - **Resources**: `cladding://spec`, `cladding://events`, `cladding://audit`. - **Prompts**: 5 personas (orchestrator, planner, reviewer, observability, developer). - **Live audit notifications**: `notifications/resources/updated` fires for `cladding://audit` whenever a new evidence entry lands — a subscribed client can live-tail the audit log without polling. diff --git a/plugins/codex/skills/status/SKILL.md b/plugins/codex/skills/status/SKILL.md index 94bd0f20..3544f4e5 100644 --- a/plugins/codex/skills/status/SKILL.md +++ b/plugins/codex/skills/status/SKILL.md @@ -1,5 +1,5 @@ --- -description: Render the feature × stage integrity matrix — every feature vs every Iron Law stage with pass/skip/fail markers. Use when the user wants a project-wide status board, a release-readiness view, or to spot which features are still behind which stage. +description: Render the feature × stage integrity matrix — every feature vs every Iron Law stage with pass/skip/fail markers. Use when the user wants a project-wide status board, a release-readiness view, or to spot which features are still behind which stage. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding status (formerly `panel`) diff --git a/plugins/codex/skills/sync/SKILL.md b/plugins/codex/skills/sync/SKILL.md index 6dacb4e7..963f625d 100644 --- a/plugins/codex/skills/sync/SKILL.md +++ b/plugins/codex/skills/sync/SKILL.md @@ -1,5 +1,5 @@ --- -description: Validate the active spec.yaml against the Ironclad schema and refresh the inventory. Rarely needed manually — clad_create_feature already auto-syncs the inventory and clad check / clad done self-validate the spec, so do NOT run it as a reflexive pre-flight before those. Use it only after you have directly hand-edited a shard file (spec/features/*.yaml or spec.yaml). +description: Validate the active spec.yaml against the Ironclad schema and refresh the inventory. Rarely needed manually — clad_create_feature already auto-syncs the inventory and clad check / clad done self-validate the spec, so do NOT run it as a reflexive pre-flight before those. Use it only after you have directly hand-edited a shard file (spec/features/*.yaml or spec.yaml). Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding sync diff --git a/plugins/gemini-cli/commands/init.toml b/plugins/gemini-cli/commands/init.toml index b7390df4..9548cf16 100644 --- a/plugins/gemini-cli/commands/init.toml +++ b/plugins/gemini-cli/commands/init.toml @@ -1,100 +1,26 @@ -description = "Scaffold a cladding workspace. Pass a free-text project description as positional argument to drive intent-aware onboarding — the LLM produces domain-aware spec/docs plus product-level follow-up questions. Use when the user wants to start a new Ironclad project, adopt cladding into an existing repo, or refresh artifacts via re-scan." +description = "Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow." prompt = ''' # Cladding init -Run `clad init` from the directory where the cladding workspace should live. Idempotent — skips files that already exist unless `--force` is supplied. +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. -## Artifacts produced (by Tier) +## Required host workflow -| Tier | File | Authority | -|---|---|---| -| A | `spec.yaml` (seed) | Spec SSoT (Iron Law sealed) | -| A | `spec/scenarios/-.yaml` (v0.3.45+, intent path only) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` | Design SSoT | -| B | `spec/capabilities.yaml` | Design SSoT | -| B | `docs/project-context.md` | Design SSoT (intent + Why/What/Purpose) | -| C | `docs/conventions.md` | derived from observed code OR greenfield seed | -| D | `.cladding/onboarding/state.yaml` (intent path only) | transient — Q&A audit | +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier governance. +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. -## Intent-aware onboarding (v0.3.43+) +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. -The strongest path is to pass the user's project intent as positional argument (no `--intent` keyword, no quotes needed): +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. -``` -clad init 결제 SaaS for B2B Stripe Toss 지원 -clad init AI 코드 리뷰 봇 만들거야 -clad init 이 프로젝트 분석해서 클래딩 적용해줘 -``` - -The LLM dispatcher then produces **domain-aware** artifacts that exceed what the user explicitly stated: - -- `docs/project-context.md` — Why/What/Purpose with inferred domain context (compliance norms, scale assumptions, common patterns) -- `spec/capabilities.yaml` — user-stated + inferred capabilities (3-8 entries; payment → idempotency, webhook signing; ML → data lineage, eval harness; SaaS → multi-tenancy, audit log) -- `spec/architecture.yaml` — layers tailored to domain + language -- 2-3 follow-up clarifying questions printed to stdout as CLI hints (product/business level — not technical jargon) - -**AI orchestrators MUST ask the user for intent before invoking `clad init` on a greenfield workspace** (see `src/agents/orchestrator.md` principle 6). A bare `clad init` on a brand-new project falls back to generic toolchain seeds and misses the user's intent. For existing projects (≥3 source files) bare `clad init` is fine — the observed scan path captures shape directly. - -## Flags - -- `--name ` — override the project name (default: cwd basename). -- `--force` — overwrite an existing `spec.yaml`. -- `--scan` — force-walk the existing codebase to write observed artifacts. Default auto-detects (≥3 source files trigger scan); use `--no-scan` to skip even when source is present. Orthogonal to positional intent — can combine (`clad init 결제 SaaS --scan`). -- `--no-llm` — force the deterministic interpreter. Intent text still routes but falls back to a deterministic body quoting the intent verbatim. -- `--roots ` — comma-separated source-root override (e.g. `packages/a/src,packages/b/src`). Otherwise inferred from manifests + directory heuristics. - -When `--scan` runs (or auto-runs on a codebase with ≥3 source files) it writes: - -- `docs/conventions.md` — observed indent / quote / naming / error-handling / test-location conventions plus a representative module quote. -- `spec/architecture.yaml` — observed layers + forbidden-import candidates derived from the import graph. -- `spec/capabilities.yaml` — README `##` headings rendered as capability candidates (v0.3.38+). -- `docs/project-context.md` — forest-level Why / What / Purpose; LLM-refined when a dispatcher is available, deterministic template otherwise. -- `spec/scenarios/README.md` — explains the scenarios-are-intent policy (v0.3.30+). - -Existing files are diverted to `.cladding/scan/*.proposal` rather than overwritten. - -### Greenfield seeds (v0.3.42+) - -When `--scan` does **not** fire (brand-new project with <3 source files), `clad init` still writes the same three artifacts as **greenfield seeds** so the spec/docs surface is always complete: - -- `docs/conventions.md` — toolchain-default 14-signal table. TypeScript → 2-space + single quote + camelCase + `tests-dir` test layout, Python → 4-space + double quote + snake_case, Go → tab + PascalCase + `sibling-test`, Rust → 4-space + snake_case + result-pattern, etc. Each seed inlines a one-line link to the canonical style guide (Google TS / PEP 8 / Effective Go / Google Java / …). -- `spec/architecture.yaml` — `version: "0.1"` + empty `layers: []` + a language-specific baseline suggestion in the header comment (TypeScript → `src/cli/` / `src/core/` / `src/lib/` / `src/ui/`, Python → `src//` / `tests/`, Go → `cmd/` / `pkg/` / `internal/`, …). -- `spec/capabilities.yaml` — `schema: "0.1"` + `source: README.md` + empty `capabilities: []` + guidance comment on the per-entry shape. - -Each seed carries a header marking it as a greenfield template. After you write initial code (and optionally a README), re-run `clad init --scan`; the observed bodies divert to `.cladding/scan/.proposal` so you can diff seed vs reality and merge the parts you want. Personas downstream (`developer`, `planner`) therefore treat every scan artifact as **always present**, with the SEED header telling them which mode is live. - -After init: - -1. Edit `spec.yaml` (project metadata). Features are added on demand — ask the AI in natural language ("add a feature for login flow"), call the `clad_create_feature` MCP tool, or use the `clad` CLI. Feature shards always use the hash-based id `F-` (v0.3.9+) — filename `-.yaml`, `id: F-`, `slug: `. `clad init` does **not** write a legacy `F-001` placeholder for external users (v0.4.0+). -2. Run `clad sync` to verify the spec is valid. -3. Run `clad check` to see which Iron Law stages are wired up for the toolchain cladding detects in the cwd. -4. (Optional) Run `clad doctor` to confirm `.cladding/events.log.jsonl` shows no `sentinel_miss` events from the scan refinement. - -``` -clad init # bare (greenfield seeds + hint, or observed scan) -clad init 결제 SaaS for B2B # intent-aware onboarding (positional, no quotes needed) -clad init "AI 코드 리뷰 봇" # quotes OK too -clad init 이 프로젝트 분석해서 클래딩 적용해줘 # intent that signals existing adoption -clad init docs/plan.md # path-aware intent (v0.3.61+) — file contents auto-loaded as intent -clad init /absolute/path/spec.md # absolute path also supported (same .md/.txt/.yaml/.yml/.markdown rule) -clad init --name my-project -clad init --force -clad init --scan --no-llm -clad init --roots packages/a/src,packages/b/src -``` - -## Path-aware intent (v0.3.61+, F-5f6b45) - -When the positional argument looks like a text-file path (recognized extension `.md` / `.txt` / `.yaml` / `.yml` / `.markdown`) and the file exists under cwd, cladding loads the file body and forwards *that* to the onboarding LLM dispatcher — not the literal path string. This closes the gap where `clad init "$(cat docs/plan.md)"` (shell substitution) was the only way to feed a planning document into onboarding. - -Behavior: - -- **Existing text file** → contents become the intent. stderr prints `loaded intent from ` for transparency. -- **Missing file** with a path-like extension → stderr warning + free-text fallback (the literal argument is forwarded as intent so onboarding still runs). -- **Directory** ending in `.md` (rare) → stderr warning + free-text fallback. -- **Non-text argument** (e.g. `결제 SaaS 만들거야`) → existing free-text behavior, zero regression. - -Plugin invocations (`/cladding init docs/plan.md` from Claude Code · Codex CLI · Gemini CLI marketplace installs) inherit this behavior automatically — every plugin skill shells out to the same `clad init` CLI. +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. ''' diff --git a/plugins/gemini-cli/gemini-extension.json b/plugins/gemini-cli/gemini-extension.json index e44a0f31..bf5cf111 100644 --- a/plugins/gemini-cli/gemini-extension.json +++ b/plugins/gemini-cli/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "cladding", - "version": "0.8.3", + "version": "0.9.0", "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/scripts/build-plugin.mjs b/scripts/build-plugin.mjs index f807524d..37db48f3 100644 --- a/scripts/build-plugin.mjs +++ b/scripts/build-plugin.mjs @@ -15,11 +15,13 @@ // .mcp.json ← already authored under plugins/codex/ // .codex-plugin/plugin.json ← already authored // -// Gemini CLI (plugins/gemini-cli/, v0.3.6, F-081): +// Legacy Gemini CLI (plugins/gemini-cli/, v0.3.6, F-081): // commands/.toml ← transpiled from repo-root skills//SKILL.md // (frontmatter.description → toml `description`, // body → toml `prompt` as a literal multi-line) // gemini-extension.json + GEMINI.md already authored. +// Retained only so existing installations do not break during migration; +// new setup, verification, and support claims target Antigravity instead. // // The src side stays canonical — every loadPersona() call in the // runtime reads from src/agents. The drift detector enforces lockstep. @@ -28,6 +30,7 @@ import { chmodSync, + cpSync, copyFileSync, existsSync, mkdirSync, @@ -255,6 +258,26 @@ console.log( `cladding plugin · codex: copied ${codexVerbCount} verbs + ${codexPersonaCount} personas → ${CODEX_SKILLS}/`, ); +// --- Phase B2 — Antigravity plugin skills mirror -------------------- + +const ANTIGRAVITY_SKILLS = 'plugins/antigravity/skills'; +mkdirSync(ANTIGRAVITY_SKILLS, {recursive: true}); +for (const entry of readdirSync(CODEX_SKILLS)) { + if (entry === 'README.md') continue; + const src = join(CODEX_SKILLS, entry); + if (!statSync(src).isDirectory()) continue; + const dst = join(ANTIGRAVITY_SKILLS, entry); + rmSync(dst, {recursive: true, force: true}); + cpSync(src, dst, {recursive: true}); +} +for (const entry of readdirSync(ANTIGRAVITY_SKILLS)) { + if (!codexExpected.has(entry)) rmSync(join(ANTIGRAVITY_SKILLS, entry), {recursive: true, force: true}); +} +rmSync(join(ANTIGRAVITY_SKILLS, 'README.md'), {force: true}); +console.log( + `cladding plugin · antigravity: copied ${codexVerbCount} verbs + ${codexPersonaCount} personas → ${ANTIGRAVITY_SKILLS}/`, +); + // --- Phase C — Gemini CLI mirror (plugins/gemini-cli/commands/) ------- const GEMINI_COMMANDS = 'plugins/gemini-cli/commands'; diff --git a/scripts/test-count.d.mts b/scripts/test-count.d.mts new file mode 100644 index 00000000..dbcac956 --- /dev/null +++ b/scripts/test-count.d.mts @@ -0,0 +1,52 @@ +/** A public all-pass claim represented as `[passed, total]`. */ +export type TestCountPair = readonly [number, number]; + +/** + * Extracts the badge and release-status claim pairs from a README variant. + * + * @param body README source text. + * @param kind README representation. + * @returns Public pass and total pairs. + */ +export function claimPairs(body: string, kind: 'markdown' | 'html'): TestCountPair[]; + +/** + * Validates a README variant against the collected test total. + * + * @param body README source text. + * @param kind README representation. + * @param expected Collected Vitest total. + * @param file Diagnostic file label. + * @throws When the public claim is missing, partial, or stale. + */ +export function checkClaimText( + body: string, + kind: 'markdown' | 'html', + expected: number, + file?: string, +): void; + +/** + * Rewrites both public claims in a validated README variant. + * + * @param body README source text. + * @param kind README representation. + * @param expected Collected Vitest total. + * @param file Diagnostic file label. + * @returns README text with both claims updated. + * @throws When the existing public claim is malformed or partial. + */ +export function rewriteClaimText( + body: string, + kind: 'markdown' | 'html', + expected: number, + file?: string, +): string; + +/** + * Returns the number of tests currently collected by Vitest. + * + * @returns Number of collected Vitest tests. + * @throws When collection fails or returns an empty suite. + */ +export function collectTestCount(): number; diff --git a/scripts/test-count.mjs b/scripts/test-count.mjs new file mode 100644 index 00000000..10dd35b3 --- /dev/null +++ b/scripts/test-count.mjs @@ -0,0 +1,140 @@ +#!/usr/bin/env node +// Cladding · public test-count consistency guard (F-898783ee). +// +// Public test totals are derived from Vitest collection rather than a manually +// remembered number. `--check` is release-safe and read-only; `--write` updates +// every published README variant only after all six claim sites validate. + +import {spawnSync} from 'node:child_process'; +import {readFileSync, writeFileSync} from 'node:fs'; +import {dirname, join, resolve} from 'node:path'; +import process from 'node:process'; +import {fileURLToPath} from 'node:url'; + +const ROOT = dirname(dirname(fileURLToPath(import.meta.url))); +const SITES = [ + {file: 'README.md', kind: 'markdown'}, + {file: 'README.ko.md', kind: 'markdown'}, + {file: 'README.ja.md', kind: 'markdown'}, + {file: 'README.zh.md', kind: 'markdown'}, + {file: 'README.html', kind: 'html'}, + {file: 'README.ko.html', kind: 'html'}, +]; + +const BADGE_RE = /tests-(\d+)%2F(\d+)-brightgreen/g; +const MARKDOWN_STATUS_RE = /\|\s*(\d+)\s*\/\s*(\d+)(?=\s*(?:\||·))/g; +const HTML_STATUS_RE = />(\d+)\/(\d+)<\/span>/g; + +/** + * Returns the two public pass/total pairs from one README variant. + * + * @param {string} body README source text. + * @param {'markdown'|'html'} kind README representation. + * @returns {Array<[number, number]>} Public pass and total pairs. + */ +export function claimPairs(body, kind) { + const badge = [...body.matchAll(BADGE_RE)].map((match) => [Number(match[1]), Number(match[2])]); + const statusPattern = kind === 'html' ? HTML_STATUS_RE : MARKDOWN_STATUS_RE; + const status = [...body.matchAll(statusPattern)].map((match) => [Number(match[1]), Number(match[2])]); + return [...badge, ...status]; +} + +/** + * Validates one README claim surface against the collected test count. + * + * @param {string} body README source text. + * @param {'markdown'|'html'} kind README representation. + * @param {number} expected Collected Vitest total. + * @param {string} file Diagnostic file label. + * @returns {void} + * @throws {Error} When the public claim is missing, partial, or stale. + */ +export function checkClaimText(body, kind, expected, file = '') { + const pairs = claimPairs(body, kind); + if (pairs.length !== 2) { + throw new Error(`${file}: expected one test badge and one status total; found ${pairs.length} claims`); + } + for (const [passed, total] of pairs) { + if (passed !== total) throw new Error(`${file}: public test claim is not all-pass (${passed}/${total})`); + if (total !== expected) throw new Error(`${file}: claims ${total} tests; Vitest collects ${expected}`); + } +} + +/** + * Rewrites one already-valid README claim surface to a new collected total. + * + * @param {string} body README source text. + * @param {'markdown'|'html'} kind README representation. + * @param {number} expected Collected Vitest total. + * @param {string} file Diagnostic file label. + * @returns {string} README text with both claims updated. + * @throws {Error} When the existing public claim is malformed or partial. + */ +export function rewriteClaimText(body, kind, expected, file = '') { + const pairs = claimPairs(body, kind); + if (pairs.length !== 2 || pairs.some(([passed, total]) => passed !== total)) { + throw new Error(`${file}: refusing to rewrite malformed or partial test-count claims`); + } + const statusPattern = kind === 'html' ? HTML_STATUS_RE : MARKDOWN_STATUS_RE; + const badgeUpdated = body.replace(BADGE_RE, `tests-${expected}%2F${expected}-brightgreen`); + return badgeUpdated.replace(statusPattern, (match) => { + if (kind === 'html') { + return `>${expected}/${expected}`; + } + return match.replace(/\d+\s*\/\s*\d+/, `${expected} / ${expected}`); + }); +} + +/** + * Collects the exact number of tests Vitest would execute without running them. + * + * @returns {number} Number of collected Vitest tests. + * @throws {Error} When collection fails or returns an empty suite. + */ +export function collectTestCount() { + const vitest = join(ROOT, 'node_modules', 'vitest', 'vitest.mjs'); + const result = spawnSync(process.execPath, [vitest, 'list', '--json'], { + cwd: ROOT, + encoding: 'utf8', + maxBuffer: 16 * 1024 * 1024, + }); + if (result.status !== 0) { + throw new Error(`Vitest collection failed: ${(result.stderr || result.stdout).trim()}`); + } + const collected = JSON.parse(result.stdout); + if (!Array.isArray(collected) || collected.length === 0) { + throw new Error('Vitest collection returned no tests'); + } + return collected.length; +} + +function main() { + const mode = process.argv[2] ?? '--check'; + if (!['--check', '--write'].includes(mode) || process.argv.length > 3) { + throw new Error('usage: node scripts/test-count.mjs [--check|--write]'); + } + const expected = collectTestCount(); + const bodies = new Map(); + for (const site of SITES) { + const body = readFileSync(join(ROOT, site.file), 'utf8'); + bodies.set(site.file, body); + if (mode === '--check') checkClaimText(body, site.kind, expected, site.file); + else rewriteClaimText(body, site.kind, expected, site.file); + } + if (mode === '--write') { + for (const site of SITES) { + const next = rewriteClaimText(bodies.get(site.file), site.kind, expected, site.file); + writeFileSync(join(ROOT, site.file), next, 'utf8'); + } + } + process.stdout.write(`cladding test-count: ${expected} tests · ${mode.slice(2)} passed\n`); +} + +if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) { + try { + main(); + } catch (error) { + process.stderr.write(`cladding test-count: ${(error).message}\n`); + process.exit(1); + } +} diff --git a/scripts/version-bump.mjs b/scripts/version-bump.mjs index 07968feb..f5e67625 100644 --- a/scripts/version-bump.mjs +++ b/scripts/version-bump.mjs @@ -1,7 +1,7 @@ #!/usr/bin/env node // Cladding · version bump script (v0.3.15, F-090). // -// Atomically bumps the version string across the nine files where +// Atomically bumps the version string across the eleven sites where // it lives so two contributors don't have to manually hand-edit each // location and risk drifting them. HARNESS_INTEGRITY already catches // post-hoc drift, but doing the bump in one shot avoids the catch @@ -14,7 +14,7 @@ // The script: // 1. validates the target version against SemVer (major.minor.patch) // 2. reads the current version from package.json -// 3. updates all nine sites with a literal string replace +// 3. validates all eleven sites before writing any file // 4. prints a summary of what changed // // It does NOT touch CHANGELOG.md, git, or run the build. Those are @@ -45,52 +45,64 @@ const SITES = [ /"version": "(\d+\.\d+\.\d+)"/, (v) => `"version": "${v}"`, ), - // 2. plugins/claude-code/.claude-plugin/plugin.json + // 2-3. package-lock.json — npm mirrors the root package version at the + // top level and in packages[""]. Both must move with package.json. + siteFor( + 'package-lock.json', + /\{\n "name": "cladding",\n "version": "(\d+\.\d+\.\d+)"/, + (v) => `{\n "name": "cladding",\n "version": "${v}"`, + ), + siteFor( + 'package-lock.json', + /"packages": \{\n "": \{\n "name": "cladding",\n "version": "(\d+\.\d+\.\d+)"/, + (v) => `"packages": {\n "": {\n "name": "cladding",\n "version": "${v}"`, + ), + // 4. plugins/claude-code/.claude-plugin/plugin.json // (root .claude-plugin/ holds marketplace.json; the Claude plugin - // manifest lives under plugins/claude-code/, mirroring codex at SITE 3. + // manifest lives under plugins/claude-code/, mirroring codex at SITE 5. // The old root path was stale and made `version-bump` error on the repo.) siteFor( 'plugins/claude-code/.claude-plugin/plugin.json', /"version": "(\d+\.\d+\.\d+)"/, (v) => `"version": "${v}"`, ), - // 3. plugins/codex/.codex-plugin/plugin.json + // 5. plugins/codex/.codex-plugin/plugin.json siteFor( 'plugins/codex/.codex-plugin/plugin.json', /"version": "(\d+\.\d+\.\d+)"/, (v) => `"version": "${v}"`, ), - // 4. plugins/gemini-cli/gemini-extension.json + // 6. plugins/gemini-cli/gemini-extension.json siteFor( 'plugins/gemini-cli/gemini-extension.json', /"version": "(\d+\.\d+\.\d+)"/, (v) => `"version": "${v}"`, ), - // 5. src/cli/clad.ts — `.version('X.Y.Z')` chain on commander Program + // 7. src/cli/clad.ts — `.version('X.Y.Z')` chain on commander Program siteFor( 'src/cli/clad.ts', /\.version\('(\d+\.\d+\.\d+)'\)/, (v) => `.version('${v}')`, ), - // 6. src/serve/server.ts — fallback `version: opts.version ?? 'X.Y.Z'` + // 8. src/serve/server.ts — fallback `version: opts.version ?? 'X.Y.Z'` siteFor( 'src/serve/server.ts', /version: opts\.version \?\? '(\d+\.\d+\.\d+)'/, (v) => `version: opts.version ?? '${v}'`, ), - // 7. tests/cli/clad.test.ts — `expect(program.version()).toBe('X.Y.Z')` + // 9. tests/cli/clad.test.ts — `expect(program.version()).toBe('X.Y.Z')` siteFor( 'tests/cli/clad.test.ts', /expect\(program\.version\(\)\)\.toBe\('(\d+\.\d+\.\d+)'\)/, (v) => `expect(program.version()).toBe('${v}')`, ), - // 8. spec.yaml — project.version (Tier A SSoT must track the binary) + // 10. spec.yaml — project.version (Tier A SSoT must track the binary) siteFor( 'spec.yaml', / version: "(\d+\.\d+\.\d+)"/, (v) => ` version: "${v}"`, ), - // 9. .claude-plugin/marketplace.json — the marketplace CATALOG entry the + // 11. .claude-plugin/marketplace.json — the marketplace CATALOG entry the // Claude Code host reads to detect "update available". Nested under // plugins[0].version; it is the only "version" key in the file, so the // shared anchor is unambiguous. It is NOT a HOST manifest, so @@ -120,13 +132,20 @@ function main() { const changes = []; const errors = []; + const originalBodies = new Map(); + const nextBodies = new Map(); for (const site of SITES) { let body; - try { - body = readFileSync(site.file, 'utf8'); - } catch (err) { - errors.push(`${site.file}: cannot read (${err.message})`); - continue; + if (nextBodies.has(site.file)) { + body = nextBodies.get(site.file); + } else { + try { + body = readFileSync(site.file, 'utf8'); + originalBodies.set(site.file, body); + } catch (err) { + errors.push(`${site.file}: cannot read (${err.message})`); + continue; + } } const match = site.anchor.exec(body); if (!match) { @@ -144,7 +163,7 @@ function main() { errors.push(`${site.file}: replacement matched anchor but produced no diff — bug in formatNew`); continue; } - writeFileSync(site.file, next, 'utf8'); + nextBodies.set(site.file, next); changes.push(`${site.file}: ${oldVersion} → ${newVersion}`); } @@ -154,7 +173,34 @@ function main() { for (const e of errors) process.stderr.write(` ${e}\n`); process.exit(1); } - process.stdout.write(`\ncladding version-bump: ${changes.length} files updated to ${newVersion}\n`); + let writtenFiles = 0; + const attemptedFiles = []; + try { + for (const [file, body] of nextBodies) { + if (body === originalBodies.get(file)) continue; + writeFileSync(file, body, 'utf8'); + attemptedFiles.push(file); + writtenFiles++; + } + } catch (error) { + const rollbackErrors = []; + for (const file of attemptedFiles.reverse()) { + try { + writeFileSync(file, originalBodies.get(file), 'utf8'); + } catch (rollbackError) { + rollbackErrors.push(`${file}: ${rollbackError.message}`); + } + } + process.stderr.write(`\nwrite failed; version files restored: ${error.message}\n`); + for (const rollbackError of rollbackErrors) { + process.stderr.write(` rollback failed — ${rollbackError}\n`); + } + process.exit(1); + } + process.stdout.write( + `\ncladding version-bump: ${changes.length} version sites checked; ` + + `${writtenFiles} files updated to ${newVersion}\n`, + ); } main(); diff --git a/skills/changelog/SKILL.md b/skills/changelog/SKILL.md index e118076c..a518a6b0 100644 --- a/skills/changelog/SKILL.md +++ b/skills/changelog/SKILL.md @@ -1,5 +1,5 @@ --- -description: Render release notes / a changelog from the cladding spec. Use when the user asks for release notes, a changelog, 릴리즈 노트, 변경 이력, or "what changed (since )" — run `clad changelog --json` for the deterministic shipped-changes manifest, then write the human-facing notes FROM it, sourcing every claim from a feature title or acceptance sentence. For audit asks, print the --audit table verbatim. +description: Render release notes / a changelog from the cladding spec. Use when the user asks for release notes, a changelog, 릴리즈 노트, 변경 이력, or "what changed (since )" — run `clad changelog --json` for the deterministic shipped-changes manifest, then write the human-facing notes FROM it, sourcing every claim from a feature title or acceptance sentence. For audit asks, print the --audit table verbatim. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding changelog — release notes from the spec diff --git a/skills/check/SKILL.md b/skills/check/SKILL.md index f0b82fcb..fe7bb3ea 100644 --- a/skills/check/SKILL.md +++ b/skills/check/SKILL.md @@ -1,5 +1,5 @@ --- -description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. +description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding check @@ -10,7 +10,7 @@ Run `clad check` from the project root. Runs the 15 Iron Law stages — Type / L - `1` — at least one stage actually failed (fix-required). - `2` — every result is skip (no fail-required input on the project yet). -`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` (37/37 as of v0.6.1 — `npm run build:plugin` Phase D recounts and writes the integer into `.claude-plugin/plugin.json`). +`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` — `npm run build:plugin` Phase D recounts them and writes the integer into each plugin manifest (e.g. `plugins/claude-code/.claude-plugin/plugin.json`), so the number is never hand-maintained. `--internal` shows stage codes (`stage_1.1`) instead of business names (`Type`). Default is the business-name surface; the audit log keeps internal ids regardless. diff --git a/skills/checkpoint/SKILL.md b/skills/checkpoint/SKILL.md index 8f46d20c..fd5cec9c 100644 --- a/skills/checkpoint/SKILL.md +++ b/skills/checkpoint/SKILL.md @@ -1,5 +1,5 @@ --- -description: Record a feature checkpoint event pinning the current git HEAD plus a spec digest, so a later rollback can restore the exact pre-change state. Use before a non-trivial feature implementation, before a refactor that touches many files, or whenever the user wants a known-good safety net the autonomous drive loop can fall back to. +description: Record a feature checkpoint event pinning the current git HEAD plus a spec digest, so a later rollback can restore the exact pre-change state. Use before a non-trivial feature implementation, before a refactor that touches many files, or whenever the user wants a known-good safety net the autonomous drive loop can fall back to. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding checkpoint diff --git a/skills/clarify/SKILL.md b/skills/clarify/SKILL.md index f92b3a3c..30f51495 100644 --- a/skills/clarify/SKILL.md +++ b/skills/clarify/SKILL.md @@ -1,83 +1,18 @@ --- -description: Advance the onboarding Q&A loop after `clad init `. Pass the user's answer to the next pending question as a positional argument; 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`. Use when the user is mid-onboarding and you have collected their reply to one clarifying question — never invent answers. +description: Advance Cladding onboarding after the user answers a pending product question. Use the MCP prepare/apply flow, preserve the answer verbatim, and never invent answers. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- -# Cladding clarify (formerly `refine`) +# Cladding clarify -Drives the **iterative onboarding loop** initiated by `clad init `. The init pass writes `.cladding/onboarding/state.yaml` with 2–3 clarifying questions; `clad clarify ` advances the loop one question at a time. +Use this workflow only for an answer contained in a new user message after Cladding displayed the pending question. Never infer, synthesize, or reuse an answer from an initialization turn. If no new user answer exists, stop without calling either clarify tool. -## Artifacts produced (by Tier) +Use this workflow only after Cladding initialization returned a pending question and the user has answered it. -| Tier | File | Authority | -|---|---|---| -| A | `spec/scenarios/-.yaml` (refined, v0.3.45+) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` (refined) | Design SSoT | -| B | `spec/capabilities.yaml` (refined) | Design SSoT | -| B | `docs/project-context.md` (refined) | Design SSoT | -| D | `.cladding/onboarding/state.yaml` (Q&A history updated) | transient audit | +1. Call `clad_prepare_clarify` with the user's answer verbatim. +2. Read the returned prompt, current state, and artifacts. Draft the structured refinement required by `clad_clarify` using the current host model. +3. Call `clad_clarify` with the same answer, the one-time token, and the draft. +4. Ask `nextQuestion` verbatim when one remains. +5. If the result is `needs_review`, show the proposal diffs for every `pendingReview` target and wait for explicit user approval. Only then call `clad_resolve_onboarding_review` with the approved targets. Never describe onboarding as complete while review remains. +6. Report completion only when the returned status is `done`. -Existing files divert to `.cladding/scan/*.proposal` per the SSoT model's refresh policy. See [`docs/ssot-model.md`](../../docs/ssot-model.md). - -## Flow - -1. `clad init ` → produces initial artifacts + writes `state.yaml` with pending questions -2. Orchestrator asks the user the **first pending question verbatim** -3. User replies -4. Orchestrator runs `clad clarify ` (positional, no quotes needed) -5. `clad clarify` marks the question answered, re-runs the LLM with the full Q-A history, refines artifacts, may add new follow-up questions -6. Loop until `status: done` - -## Variadic positional - -``` -clad clarify 법인 사업자만 (개인사업자 제외) -clad clarify "한국 시장 위주" -clad clarify 카드 + 간편결제 우선 -``` - -All tokens are joined with spaces — quoting is optional. - -## Flags - -- `--cwd ` — directory containing `.cladding/onboarding/state.yaml` (default cwd) -- `--no-llm` — force deterministic interpreter; current artifact bodies are preserved and the answer is logged as a Q&A footnote in `docs/project-context.md` -- `--json` — emit a `RefineReport` JSON (`{cwd, answered, newQuestions, mode, status}`) instead of the formatted text - -## Output (text mode) - -- Pulse summary line — `✓ clarify answered · mode: greenfield · source: llm` -- Created / proposal entries for refined artifacts (existing files divert to `.cladding/scan/*.proposal`) -- New clarifying questions printed as a numbered list (if any) -- Closing line — `남은 질문: N 개. clad clarify <답변> 으로 계속.` OR `✓ 모든 질문에 답변 완료 — 온보딩 종료.` - -## Exit codes - -- `0` — answer accepted (or no-op when state is already done) -- `1` — fatal error (corrupt state file) -- `2` — usage error (no state file present, or no answer provided) - -## State file - -`.cladding/onboarding/state.yaml` shape: - -```yaml -intent: "결제 SaaS for B2B" -language: typescript -projectName: payment-saas -mode: greenfield -startedAt: 2026-05-21T12:34:56.789Z -status: active -qa: - - question: "주 사용자가 개인? 사업자?" - answer: "법인 사업자만" - - question: "어떤 결제수단 우선?" - answer: null -``` - -`status: done` is set once every question has an answer AND the latest refinement returned no new questions. The file stays on disk as an audit log of the onboarding decisions. - -## When NOT to invoke - -- `state.yaml` does not exist → exit 2. Run `clad init ` first. -- The user has not replied yet — never invent answers. Wait for their actual response. -- The user is asking about an unrelated topic — pause the loop and resume later when they're ready. +Do not run `clad clarify` in a shell from an AI host. Do not use MCP sampling. Never answer a product question on the user's behalf. A stale, malformed, replayed, or answer-mismatched apply request is a no-op and must be prepared again. diff --git a/skills/doctor/SKILL.md b/skills/doctor/SKILL.md index 46d6c487..10214faa 100644 --- a/skills/doctor/SKILL.md +++ b/skills/doctor/SKILL.md @@ -1,5 +1,5 @@ --- -description: Summarise .cladding/events.log.jsonl — sentinel-miss frequency by phase × cause × fallback plus the top missed sentinels. Use when the user asks whether their LLM dispatcher (MCP sampling host, Anthropic SDK, …) is healthy, when scan / drive results look thinner than expected, or as a one-shot triage before tuning model / max_tokens / temperature. +description: Summarise .cladding/events.log.jsonl — sentinel-miss frequency by phase × cause × fallback plus the top missed sentinels. Use when the user asks whether their LLM dispatcher (MCP sampling host, Anthropic SDK, …) is healthy, when scan / drive results look thinner than expected, or as a one-shot triage before tuning model / max_tokens / temperature. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding doctor diff --git a/skills/init/SKILL.md b/skills/init/SKILL.md index 3b5bec99..1de064d0 100644 --- a/skills/init/SKILL.md +++ b/skills/init/SKILL.md @@ -1,101 +1,28 @@ --- -description: Scaffold a cladding workspace. Pass a free-text project description as positional argument to drive intent-aware onboarding — the LLM produces domain-aware spec/docs plus product-level follow-up questions. Use when the user wants to start a new Ironclad project, adopt cladding into an existing repo, or refresh artifacts via re-scan. +name: init +description: Use only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it; never use for an ordinary project creation or implementation request. Scaffold from an idea, planning document, or existing project through the MCP prepare/apply flow. --- # Cladding init -Run `clad init` from the directory where the cladding workspace should live. Idempotent — skips files that already exist unless `--force` is supplied. +Use this workflow only when the user explicitly asks to initialize, adopt, or refresh Cladding. Opening a repository alone is not consent to initialize it. -## Artifacts produced (by Tier) +## Required host workflow -| Tier | File | Authority | -|---|---|---| -| A | `spec.yaml` (seed) | Spec SSoT (Iron Law sealed) | -| A | `spec/scenarios/-.yaml` (v0.3.45+, intent path only) | Spec SSoT (onboarding output) | -| B | `spec/architecture.yaml` | Design SSoT | -| B | `spec/capabilities.yaml` | Design SSoT | -| B | `docs/project-context.md` | Design SSoT (intent + Why/What/Purpose) | -| C | `docs/conventions.md` | derived from observed code OR greenfield seed | -| D | `.cladding/onboarding/state.yaml` (intent path only) | transient — Q&A audit | +If the current user message itself matches `APPLY CLADDING XXXXXX`, do not call prepare or stage again. Call `clad_init` once and copy the entire user message, including the `APPLY CLADDING` prefix, into `confirmation`. -See [`docs/ssot-model.md`](../../docs/ssot-model.md) for the full 4-tier governance. +1. If a greenfield request has no project intent, ask for one short description. +2. Call `clad_prepare_init` with exactly one starting mode: + - `idea` with the user's description. + - `document` with a project-relative planning-document path. + - `existing` for an existing codebase; include an optional adoption goal. +3. Read the returned prompt and observations. Draft the structured object required by `clad_init` using the current host model, then call `clad_stage_init` with the preparation token and that draft. Staging validates the draft and stores only ignored runtime state under `.cladding/host/`; it does not modify authored project files. +4. Show `plannedChanges`, the staged `confirmationQuestion`, and its one-time `approvalChallenge` to the user, then stop and wait for a separate reply. The original initialization request is not confirmation. +5. Only when the user's separate reply exactly matches `approvalChallenge`, call `clad_init` with the entire reply verbatim as `confirmation`—never strip the `APPLY CLADDING` prefix. Include the draft and token when the host retained them; process-per-turn hosts may omit both because Cladding resolves the exact staged draft from its short-lived machine-local cache. Questions, paraphrases, and generic acknowledgements are not approval. +6. If `nextQuestion` is present, show it verbatim and end the assistant turn immediately. Never answer it, infer an answer, or call either clarify tool during the initialization-approval turn. Continue with the Cladding clarify workflow only after a new user message supplies the answer. If no question remains, report that ordinary development can begin. -## Intent-aware onboarding (v0.3.43+) +Do not run `clad init` in a shell from an AI-host onboarding session. Do not use MCP sampling. If the MCP tools are absent, tell the user to run `clad setup`, restart the AI host in the project directory, and stop without writing project files. -The strongest path is to pass the user's project intent as positional argument (no `--intent` keyword, no quotes needed): +`clad_prepare_init` does not modify the workspace, and `clad_stage_init` writes only ignored runtime state. Never call stage and apply in the same assistant turn. Only `clad_init` writes authored artifacts, after explicit user confirmation plus schema and freshness validation. A stale, malformed, or replayed apply request must be prepared again. -``` -clad init 결제 SaaS for B2B Stripe Toss 지원 -clad init AI 코드 리뷰 봇 만들거야 -clad init 이 프로젝트 분석해서 클래딩 적용해줘 -``` - -The LLM dispatcher then produces **domain-aware** artifacts that exceed what the user explicitly stated: - -- `docs/project-context.md` — Why/What/Purpose with inferred domain context (compliance norms, scale assumptions, common patterns) -- `spec/capabilities.yaml` — user-stated + inferred capabilities (3-8 entries; payment → idempotency, webhook signing; ML → data lineage, eval harness; SaaS → multi-tenancy, audit log) -- `spec/architecture.yaml` — layers tailored to domain + language -- 2-3 follow-up clarifying questions printed to stdout as CLI hints (product/business level — not technical jargon) - -**AI orchestrators MUST ask the user for intent before invoking `clad init` on a greenfield workspace** (see `src/agents/orchestrator.md` principle 6). A bare `clad init` on a brand-new project falls back to generic toolchain seeds and misses the user's intent. For existing projects (≥3 source files) bare `clad init` is fine — the observed scan path captures shape directly. - -## Flags - -- `--name ` — override the project name (default: cwd basename). -- `--force` — overwrite an existing `spec.yaml`. -- `--scan` — force-walk the existing codebase to write observed artifacts. Default auto-detects (≥3 source files trigger scan); use `--no-scan` to skip even when source is present. Orthogonal to positional intent — can combine (`clad init 결제 SaaS --scan`). -- `--no-llm` — force the deterministic interpreter. Intent text still routes but falls back to a deterministic body quoting the intent verbatim. -- `--roots ` — comma-separated source-root override (e.g. `packages/a/src,packages/b/src`). Otherwise inferred from manifests + directory heuristics. - -When `--scan` runs (or auto-runs on a codebase with ≥3 source files) it writes: - -- `docs/conventions.md` — observed indent / quote / naming / error-handling / test-location conventions plus a representative module quote. -- `spec/architecture.yaml` — observed layers + forbidden-import candidates derived from the import graph. -- `spec/capabilities.yaml` — README `##` headings rendered as capability candidates (v0.3.38+). -- `docs/project-context.md` — forest-level Why / What / Purpose; LLM-refined when a dispatcher is available, deterministic template otherwise. -- `spec/scenarios/README.md` — explains the scenarios-are-intent policy (v0.3.30+). - -Existing files are diverted to `.cladding/scan/*.proposal` rather than overwritten. - -### Greenfield seeds (v0.3.42+) - -When `--scan` does **not** fire (brand-new project with <3 source files), `clad init` still writes the same three artifacts as **greenfield seeds** so the spec/docs surface is always complete: - -- `docs/conventions.md` — toolchain-default 14-signal table. TypeScript → 2-space + single quote + camelCase + `tests-dir` test layout, Python → 4-space + double quote + snake_case, Go → tab + PascalCase + `sibling-test`, Rust → 4-space + snake_case + result-pattern, etc. Each seed inlines a one-line link to the canonical style guide (Google TS / PEP 8 / Effective Go / Google Java / …). -- `spec/architecture.yaml` — `version: "0.1"` + empty `layers: []` + a language-specific baseline suggestion in the header comment (TypeScript → `src/cli/` / `src/core/` / `src/lib/` / `src/ui/`, Python → `src//` / `tests/`, Go → `cmd/` / `pkg/` / `internal/`, …). -- `spec/capabilities.yaml` — `schema: "0.1"` + `source: README.md` + empty `capabilities: []` + guidance comment on the per-entry shape. - -Each seed carries a header marking it as a greenfield template. After you write initial code (and optionally a README), re-run `clad init --scan`; the observed bodies divert to `.cladding/scan/.proposal` so you can diff seed vs reality and merge the parts you want. Personas downstream (`developer`, `planner`) therefore treat every scan artifact as **always present**, with the SEED header telling them which mode is live. - -After init: - -1. Edit `spec.yaml` (project metadata). Features are added on demand — ask the AI in natural language ("add a feature for login flow"), call the `clad_create_feature` MCP tool, or use the `clad` CLI. Feature shards always use the hash-based id `F-` (v0.3.9+) — filename `-.yaml`, `id: F-`, `slug: `. `clad init` does **not** write a legacy `F-001` placeholder for external users (v0.4.0+). -2. Run `clad sync` to verify the spec is valid. -3. Run `clad check` to see which Iron Law stages are wired up for the toolchain cladding detects in the cwd. -4. (Optional) Run `clad doctor` to confirm `.cladding/events.log.jsonl` shows no `sentinel_miss` events from the scan refinement. - -``` -clad init # bare (greenfield seeds + hint, or observed scan) -clad init 결제 SaaS for B2B # intent-aware onboarding (positional, no quotes needed) -clad init "AI 코드 리뷰 봇" # quotes OK too -clad init 이 프로젝트 분석해서 클래딩 적용해줘 # intent that signals existing adoption -clad init docs/plan.md # path-aware intent (v0.3.61+) — file contents auto-loaded as intent -clad init /absolute/path/spec.md # absolute path also supported (same .md/.txt/.yaml/.yml/.markdown rule) -clad init --name my-project -clad init --force -clad init --scan --no-llm -clad init --roots packages/a/src,packages/b/src -``` - -## Path-aware intent (v0.3.61+, F-5f6b45) - -When the positional argument looks like a text-file path (recognized extension `.md` / `.txt` / `.yaml` / `.yml` / `.markdown`) and the file exists under cwd, cladding loads the file body and forwards *that* to the onboarding LLM dispatcher — not the literal path string. This closes the gap where `clad init "$(cat docs/plan.md)"` (shell substitution) was the only way to feed a planning document into onboarding. - -Behavior: - -- **Existing text file** → contents become the intent. stderr prints `loaded intent from ` for transparency. -- **Missing file** with a path-like extension → stderr warning + free-text fallback (the literal argument is forwarded as intent so onboarding still runs). -- **Directory** ending in `.md` (rare) → stderr warning + free-text fallback. -- **Non-text argument** (e.g. `결제 SaaS 만들거야`) → existing free-text behavior, zero regression. - -Plugin invocations (`/cladding init docs/plan.md` from Claude Code · Codex CLI · Gemini CLI marketplace installs) inherit this behavior automatically — every plugin skill shells out to the same `clad init` CLI. +The raw CLI remains available for terminal, CI, offline, and explicitly configured SDK automation; it is not the primary host onboarding path. diff --git a/skills/oracle/SKILL.md b/skills/oracle/SKILL.md index 12bad6aa..578e37ef 100644 --- a/skills/oracle/SKILL.md +++ b/skills/oracle/SKILL.md @@ -1,5 +1,5 @@ --- -description: Author an IMPL-BLIND spec-conformance oracle for a feature's acceptance criterion, so the gate verifies the code matches the SPEC (not just the author's own tests). cladding calls no LLM — YOU spawn a blind sub-agent from a spec-only brief, then record it. Author ONLY what `clad oracle --required` lists (the policy worklist) — an empty worklist means do not author unless the user explicitly asks; out-of-policy recordings are labeled voluntary and spend beyond the project's declared verification budget. +description: Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`) demands — an empty worklist means don't author unless the user explicitly asks. YOU spawn a blind sub-agent from a spec-only brief, then record it. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding oracle — impl-blind conformance authoring diff --git a/skills/rollback/SKILL.md b/skills/rollback/SKILL.md index be861be3..80cfe7b4 100644 --- a/skills/rollback/SKILL.md +++ b/skills/rollback/SKILL.md @@ -1,5 +1,5 @@ --- -description: Record a rollback event and print the maintainer-runnable git command for the most recent checkpoint of a feature. Use when an implementation attempt failed, an autonomous drive loop hit RETRY_THRESHOLD, or the user wants to abandon the current attempt and restore the pre-checkpoint state. +description: Record a rollback event and print the maintainer-runnable git command for the most recent checkpoint of a feature. Use when an implementation attempt failed, an autonomous drive loop hit RETRY_THRESHOLD, or the user wants to abandon the current attempt and restore the pre-checkpoint state. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding rollback diff --git a/skills/route/SKILL.md b/skills/route/SKILL.md index 2210cbfa..ebe706b0 100644 --- a/skills/route/SKILL.md +++ b/skills/route/SKILL.md @@ -1,5 +1,5 @@ --- -description: Classify a natural-language prompt to one of cladding's verbs. Use when the user describes work in their own words and you want to see which built-in verb cladding's intent classifier would pick — primarily a debugging tool for the orchestrator persona and for verifying the router's coverage after adding new verbs. +description: Classify a natural-language prompt to one of cladding's verbs. Use when the user describes work in their own words and you want to see which built-in verb cladding's intent classifier would pick — primarily a debugging tool for the orchestrator persona and for verifying the router's coverage after adding new verbs. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding route diff --git a/skills/run/SKILL.md b/skills/run/SKILL.md index 7c4cdb5b..28684de2 100644 --- a/skills/run/SKILL.md +++ b/skills/run/SKILL.md @@ -1,5 +1,5 @@ --- -description: Run cladding's autonomous loop — iterate ready features, dispatch the developer + reviewer personas through the active host adapter, run L1 gates, halt on HUMAN_REQUIRED or transport failure. Use only when the user explicitly asks for autonomous progress; the loop will modify files. +description: Run cladding's autonomous loop — iterate ready features, dispatch the developer + reviewer personas through the active host adapter, run L1 gates, halt on HUMAN_REQUIRED or transport failure. Use only when the user explicitly asks for autonomous progress; the loop will modify files. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding run (formerly `drive`) diff --git a/skills/serve/SKILL.md b/skills/serve/SKILL.md index 7f7a2677..db8c10e1 100644 --- a/skills/serve/SKILL.md +++ b/skills/serve/SKILL.md @@ -1,12 +1,12 @@ --- -description: Boot cladding as an MCP server over stdio. Use only when the user wants to expose cladding's tools, resources, and persona prompts to a separate MCP client. Most users don't run this directly — the plugin's .mcp.json launches it automatically. +description: Boot cladding as an MCP server over stdio. Use only when the user wants to expose cladding's tools, resources, and persona prompts to a separate MCP client. Most users don't run this directly — the plugin's .mcp.json launches it automatically. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding serve Run `clad serve` from the project root. Boots an MCP server over stdio that exposes: -- **Tools**: `clad_list_features`, `clad_get_feature`, `clad_run_check`, `clad_get_events`. +- **Tools**: the full development surface (feature/graph/context queries, checks, gate, changelog) plus the natural-language onboarding flow — `clad_prepare_init` / `clad_stage_init` / `clad_init` and the clarify pair. Before `spec.yaml` exists only the three onboarding bootstrap tools are exposed. - **Resources**: `cladding://spec`, `cladding://events`, `cladding://audit`. - **Prompts**: 5 personas (orchestrator, planner, reviewer, observability, developer). - **Live audit notifications**: `notifications/resources/updated` fires for `cladding://audit` whenever a new evidence entry lands — a subscribed client can live-tail the audit log without polling. diff --git a/skills/status/SKILL.md b/skills/status/SKILL.md index 94bd0f20..3544f4e5 100644 --- a/skills/status/SKILL.md +++ b/skills/status/SKILL.md @@ -1,5 +1,5 @@ --- -description: Render the feature × stage integrity matrix — every feature vs every Iron Law stage with pass/skip/fail markers. Use when the user wants a project-wide status board, a release-readiness view, or to spot which features are still behind which stage. +description: Render the feature × stage integrity matrix — every feature vs every Iron Law stage with pass/skip/fail markers. Use when the user wants a project-wide status board, a release-readiness view, or to spot which features are still behind which stage. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding status (formerly `panel`) diff --git a/skills/sync/SKILL.md b/skills/sync/SKILL.md index 6dacb4e7..963f625d 100644 --- a/skills/sync/SKILL.md +++ b/skills/sync/SKILL.md @@ -1,5 +1,5 @@ --- -description: Validate the active spec.yaml against the Ironclad schema and refresh the inventory. Rarely needed manually — clad_create_feature already auto-syncs the inventory and clad check / clad done self-validate the spec, so do NOT run it as a reflexive pre-flight before those. Use it only after you have directly hand-edited a shard file (spec/features/*.yaml or spec.yaml). +description: Validate the active spec.yaml against the Ironclad schema and refresh the inventory. Rarely needed manually — clad_create_feature already auto-syncs the inventory and clad check / clad done self-validate the spec, so do NOT run it as a reflexive pre-flight before those. Use it only after you have directly hand-edited a shard file (spec/features/*.yaml or spec.yaml). Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. --- # Cladding sync diff --git a/spec.yaml b/spec.yaml index fa015e0a..89d69eca 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.8.3" + version: "0.9.0" 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: 254 + features: 255 scenarios: 2 capabilities: 6 - test_files: 234 + test_files: 237 diff --git a/spec/attestation.yaml b/spec/attestation.yaml index 7eb31850..533e67e2 100644 --- a/spec/attestation.yaml +++ b/spec/attestation.yaml @@ -14,17 +14,18 @@ # `clad check --tier=pre-push --strict`; the GREEN gate rewrites the truth. # Content-anchored: survives fresh clones and squash/rebase. attested_modules: - .claude-plugin/marketplace.json: 0dd39261bb5468e3 .claude/settings.json: d0bba3583aef0960 .github/workflows/ci.yml: 8ea99219cb80df60 .gitignore: 1294975ba3b47043 - CHANGELOG.md: d437104f3e6b98c3 - CLAUDE.md: d81d8832976cd5ee + CHANGELOG.md: 1524903097b4f9b0 + CLAUDE.md: 16212c1749e6005d GOVERNANCE.md: 21cc28eaaf637a20 - README.html: 879094d34b157bdf - README.ko.html: 4cf3fa280dc89f5e - README.ko.md: 46cb7908fde99f14 - README.md: ff1cdcdb5e4ce99b + README.html: dd6c44fc6c151ad4 + README.ja.md: d4de131ac59941f8 + README.ko.html: a494606ab7bfce8e + README.ko.md: 45c1a27b3f25c983 + README.md: 5831410ed5c38337 + README.zh.md: a6aef09c240f2b62 SECURITY.md: df1d0c80304b2f28 bin/clad: 77b80666665dd1b0 conformance/fixtures.yaml: 4b1b94dae1cd20b0 @@ -37,10 +38,10 @@ attested_modules: docs/ab-evaluation/README.md: 2467808b9871dcf0 docs/ab-evaluation/case-doverunner-scale.md: 2a435b6855823d41 docs/ab-evaluation/case-efficiency-measurement.md: 348aca146a7b2faa - docs/ab-evaluation/case-existing-adoption.md: 8e86e9a3e60c64fe + docs/ab-evaluation/case-existing-adoption.md: ec78b64f115d9c91 docs/ab-evaluation/case-graph-efficiency.md: 83d3956d14a1517d docs/ab-evaluation/case-iterative-vs-fixed-vapt.md: 1d242b8b6071f343 - docs/ab-evaluation/case-payment-saas.md: 0ecb089a576de638 + docs/ab-evaluation/case-payment-saas.md: ca1a9a22b933c5cf docs/ab-evaluation/case-working-set-landmine.md: b4f44dc463e99722 docs/ab-evaluation/summary.md: 59e527a531f13209 docs/b1-adoption-protocol.md: a041d8ad5ba1447f @@ -49,63 +50,70 @@ attested_modules: docs/benchmarks/v0.4.0-consistency-bench.md: e49a0dc671ff6672 docs/benchmarks/v0.6.0-real-user-verification.md: 9af806f48f681d1a docs/code-style.md: f1fd100fa0d11c5e + docs/dogfood/antigravity-cli-2026-07-15.md: c7191d8548535998 docs/dogfood/claude-code-2026-05-20.md: 04870d41e75576d6 + 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: 6af4ff8fe15db28a - docs/glossary.md: a098105826459c02 + docs/feature-cycle.md: b8c48c86d1f1e093 + docs/glossary.md: 9e897b963c3aa88f docs/img/en/ecosystem.svg: ed14d1d17f088b00 docs/img/en/relationship.svg: c7a24203925b4664 docs/img/ko/ecosystem.svg: 2b7341576c2af0a8 docs/img/ko/relationship.svg: 9ec8fb2254978f37 docs/multi-provider-roadmap.md: 1e5cf27ea1b18d06 docs/refinement-backlog.md: 3e38d60bf987eef1 + docs/setup.md: a5c062651d267983 docs/spec-ids-multi-dev.md: 28d58e84879f58b1 - docs/ssot-model.md: 2ecedd961ce4f721 - docs/ssot-testing.md: a067d2b99852db9a - package.json: 0bb13c2629d681a4 - plugins/claude-code/.claude-plugin/plugin.json: 7493e69dee9ae24d - plugins/claude-code/agents/developer.md: b0ef3775132d159a - plugins/claude-code/agents/observability.md: 81f73e284ee9b3ba - plugins/claude-code/agents/orchestrator.md: d30919c2b78b88e4 - plugins/claude-code/agents/planner.md: 9514f785ba65a58c - plugins/claude-code/agents/reviewer.md: 91922293457a3d6a - plugins/claude-code/commands/init.md: b7b5beedee6ddafb + docs/ssot-model.md: 66b9439e2f71ac4b + docs/ssot-testing.md: abf3b2bd5acb29a1 + package-lock.json: 84fce6dd31da5308 + package.json: fb5fc393fb3f5e49 + plugins/claude-code/.claude-plugin/plugin.json: 3ece00e95ac4e232 + 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/commands/init.md: bf567f3b4e22069a plugins/claude-code/hooks/hooks.json: 42321ead26fb1da8 - plugins/codex/.codex-plugin/plugin.json: e2898491a8fd62b8 + plugins/codex/.codex-plugin/plugin.json: 26d1bc595d1b996a plugins/codex/.mcp.json: 43e3f4b2af24aa18 - plugins/codex/skills/check/SKILL.md: 355826df90846d2f - plugins/codex/skills/developer/SKILL.md: b0ef3775132d159a - plugins/codex/skills/init/SKILL.md: b7b5beedee6ddafb - plugins/codex/skills/observability/SKILL.md: 81f73e284ee9b3ba - plugins/codex/skills/orchestrator/SKILL.md: d30919c2b78b88e4 - plugins/codex/skills/planner/SKILL.md: 9514f785ba65a58c - plugins/codex/skills/reviewer/SKILL.md: 91922293457a3d6a - plugins/codex/skills/run/SKILL.md: 43683062ac062846 - plugins/codex/skills/serve/SKILL.md: 4cee65dfb691e3b0 - plugins/codex/skills/status/SKILL.md: b3cb6e7a12bf4023 - plugins/codex/skills/sync/SKILL.md: 709c20212aa5627e + plugins/codex/skills/check/SKILL.md: 6a665422af510e72 + plugins/codex/skills/developer/SKILL.md: 40af2943253f6c72 + plugins/codex/skills/init/SKILL.md: bf567f3b4e22069a + 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/run/SKILL.md: 9f95ff17d70c8dd1 + plugins/codex/skills/serve/SKILL.md: f08bbdbbfeb05041 + plugins/codex/skills/status/SKILL.md: 09faadc50b3449da + plugins/codex/skills/sync/SKILL.md: 775c0f990a52a3d9 plugins/gemini-cli/GEMINI.md: ba08eaf2cd557a65 plugins/gemini-cli/commands/README.md: 3527d771578431bd - plugins/gemini-cli/commands/init.toml: fbf24f25bb8cf921 - plugins/gemini-cli/gemini-extension.json: 47685e98f1f67e11 - scripts/build-plugin.mjs: 57ffa3f0e6317a6b + plugins/gemini-cli/commands/init.toml: e44c7ead9bd927b2 + plugins/gemini-cli/gemini-extension.json: 9d2f839716b55869 + scripts/build-plugin.mjs: 7fabe2b6301b142a scripts/build.mjs: 3a4b204063024ef1 scripts/migrate-dogfood-v0.3.16.mjs: 1e265fb370019996 scripts/shard-spec.ts: 0c728bbc1e869421 - scripts/version-bump.mjs: 05a3aa76667ed9ce - skills/check/SKILL.md: 355826df90846d2f - skills/checkpoint/SKILL.md: 97bde8bd4553d38f - skills/clarify/SKILL.md: 4b1e37af84817586 - skills/doctor/SKILL.md: 5363d3b34e69c516 - skills/init/SKILL.md: b7b5beedee6ddafb - skills/oracle/SKILL.md: 3fc7f21e0309dad3 - skills/rollback/SKILL.md: 2597ab798e61ded8 - skills/route/SKILL.md: 624a6cf60db7960d - skills/run/SKILL.md: 43683062ac062846 - skills/serve/SKILL.md: 4cee65dfb691e3b0 - skills/status/SKILL.md: b3cb6e7a12bf4023 - skills/sync/SKILL.md: 709c20212aa5627e - spec.yaml: d16fcb27b7afb3c6 + scripts/test-count.d.mts: a392f5dea372a40e + scripts/test-count.mjs: aea2620221c8d5ff + scripts/version-bump.mjs: 770b066b8279db39 + skills/check/SKILL.md: 6a665422af510e72 + skills/checkpoint/SKILL.md: f723e8cfb8286a64 + skills/clarify/SKILL.md: 5d08bbb821258d03 + skills/doctor/SKILL.md: 6581c6c900c72d68 + skills/init/SKILL.md: bf567f3b4e22069a + skills/oracle/SKILL.md: 11e111ac0a4963c1 + skills/rollback/SKILL.md: d472dc3a562b347b + skills/route/SKILL.md: 5958830fef280c67 + skills/run/SKILL.md: 9f95ff17d70c8dd1 + skills/serve/SKILL.md: f08bbdbbfeb05041 + skills/status/SKILL.md: 09faadc50b3449da + skills/sync/SKILL.md: 775c0f990a52a3d9 + spec.yaml: 59840b10bd055d32 spec/README.md: 7c257426396d435c spec/architecture.yaml: f0888480405a13a8 spec/features/: a4d0f0eb87fed960 @@ -125,28 +133,29 @@ attested_modules: src/adapters/sdk/anthropic.ts: 9debe5cc61f039f1 src/adapters/types.ts: f8e5643231a13e8d src/agents: a4d0f0eb87fed960 - src/agents/README.md: 9f41809958439db2 - src/agents/blind-author.md: c4c89882adce01ce - src/agents/developer.md: b0ef3775132d159a + src/agents/README.md: b9fe459af1d36e8d + src/agents/blind-author.md: e9d2977f9879d3f9 + src/agents/developer.md: 40af2943253f6c72 src/agents/loader.ts: 6d35560c47f9ae85 - src/agents/observability.md: 81f73e284ee9b3ba - src/agents/orchestrator.md: d30919c2b78b88e4 - src/agents/planner.md: 9514f785ba65a58c - src/agents/reviewer.md: 91922293457a3d6a + src/agents/observability.md: 5ea8f14b1c9b4a61 + src/agents/orchestrator.md: 443c6e13ade590cf + src/agents/planner.md: 5750002ebdfb43f1 + src/agents/reviewer.md: 9c4e095e60040473 src/changelog/collect.ts: a6c936a7b8c34e2a src/changelog/render.ts: 83dd2d95f24ca68c src/cli: a4d0f0eb87fed960 src/cli/benchmark.ts: 77f84d2a898d724f src/cli/changelog.ts: 2de1adb009b89ab4 - src/cli/clad.ts: aa1c4687e89be1f4 - src/cli/clarify.ts: ff084951de081592 - src/cli/doctor-hosts.ts: 1ad79105b47fd8e5 + src/cli/clad.ts: 00d049c7acb5f761 + src/cli/clarify.ts: 393cc93a6feb698a + src/cli/doctor-hosts.ts: 1f0c2cec5a310b81 src/cli/doctor.ts: b98b955fe75e7f7e - src/cli/done.ts: ad2b2d49034296bd + src/cli/done.ts: 02bd4397eaf34fa1 src/cli/graph-serve.ts: 23e6e389225d0f98 src/cli/graph.ts: bab410061b8c746a - src/cli/hook.ts: a856ab95e025bb75 - src/cli/init.ts: 5e55fd44c53a93b9 + src/cli/hook.ts: 201f82f4c89e173f + src/cli/host-onboarding.ts: b046571d4be7280c + src/cli/init.ts: ccd14da690621d88 src/cli/intent-from-path.ts: e69862821d979f22 src/cli/measure.ts: 3a562f16589e26c2 src/cli/report.ts: 911f859b2446834b @@ -158,16 +167,16 @@ attested_modules: src/cli/scan/greenfield-seeds.ts: ff462b4a19f081f3 src/cli/scan/helpers.ts: 396c73992ded0e22 src/cli/scan/index.ts: c23f21c487c8abcb - src/cli/scan/intent-onboarding.ts: bfc6960b621e0966 + src/cli/scan/intent-onboarding.ts: 2172608a4df3b866 src/cli/scan/llm.ts: e6a91e97f9873531 - src/cli/scan/onboarding-state.ts: a5e8513fc8355e6e + src/cli/scan/onboarding-state.ts: 2353e89f3c64c563 src/cli/scan/roots.ts: 7475eed8c9836531 src/cli/scan/scenarios.ts: 6c2a4ce3b469a668 src/cli/scan/stats.ts: 00c737b7b7acad97 src/cli/scan/thresholds.ts: ec0047b894a6aa6a src/cli/scan/types.ts: ea0170aa88c1c14a src/cli/scan/walker.ts: 33e4448e365e47c6 - src/cli/update.ts: bbd9c97bfc2b99ff + src/cli/update.ts: b0151396c9a0f6ca src/cli/verdict.ts: 7aa16b8739ab8e5f src/core/checkpoint.ts: 63300c2764533b6c src/core/git-ops.ts: 4544bde493a0628f @@ -178,7 +187,7 @@ attested_modules: src/drive/halt.ts: 386dd57f84f8e297 src/drive/loop.ts: c37e15ece8e2ae41 src/events: a4d0f0eb87fed960 - src/events/log.ts: dcef5c4cccd5ed9c + src/events/log.ts: ed70cf9bfeb2eaf0 src/events/session-report.ts: d0b34f848c360334 src/graph/layout3d.ts: fdbf08bacad2c049 src/graph/model.ts: 9dfae1cb48bfe3d5 @@ -192,10 +201,10 @@ attested_modules: src/hitl/anti-self-cert.ts: 53a714d8e489d00a src/hitl/audit.ts: 79b06e904815469a src/hitl/identity.ts: 52ff84aa666f1dab - src/init/agents-md.ts: c411aaa8b724d496 + src/init/agents-md.ts: 7dc05f6d82e5c3ce src/init/git-hook.ts: 4e02f177b3764ae8 - src/init/host-instructions.ts: f6d10695ef0c4763 - src/init/host-setup.ts: ee6bca9c8fbc2fb2 + src/init/host-instructions.ts: 7a066c646f0b6133 + src/init/host-setup.ts: 158cc9306a746da1 src/optimizer: a4d0f0eb87fed960 src/optimizer/code-excerpt.ts: e2c4598efcd28d2a src/optimizer/context-slice.ts: b5864aaed1e7ae48 @@ -218,7 +227,7 @@ attested_modules: src/report/sarif.ts: 71e97aceeb0a4473 src/router: a4d0f0eb87fed960 src/router/intent.ts: 430590f761b891a6 - src/serve/server.ts: 0586a1785106e8d0 + src/serve/server.ts: 4b2d0b94854d3fb5 src/spec: a4d0f0eb87fed960 src/spec/attestation.ts: 294a1e99c42d4aef src/spec/cli.ts: 7a9bcd0f66677810 @@ -228,31 +237,32 @@ attested_modules: src/spec/feature-id.ts: 2b6335aac848a3de src/spec/inventory.ts: 2cd34dfb665f422f src/spec/load.ts: 9fe2fe74053bf7e3 - src/spec/new.ts: ae698bb51309c05e + src/spec/new.ts: 4c91f6d41acaab69 src/spec/parse.ts: 1eab9a28c9359a45 src/spec/reverse-index.ts: d8b003eb8f1918c8 - src/spec/schema.json: 7e26bc66cb0fc359 + src/spec/schema.json: 030d3741f2b38159 src/spec/test-ref-repair.ts: 5ce823b479aaaca3 - src/spec/types.ts: 8279f66aed33d569 + src/spec/types.ts: bd5833feabcdb787 src/spec/validate.ts: db88ca6512ab363a src/stages: a4d0f0eb87fed960 + src/stages/README.md: c79d2bced8c8b8d8 src/stages/arch.ts: 268422e53c6d20bb src/stages/audit.ts: 3ba117606f8a81a1 src/stages/commit.ts: f6b6836af0a4d96c - src/stages/cov.ts: 9797f9316e391a55 + src/stages/cov.ts: 3dbe8381e374e8c0 src/stages/deliverable-smoke.ts: 9ecfd4210e6ec5c0 src/stages/detector-result-cache.ts: 93ea6af02ef361c5 - src/stages/detectors/README.md: 2e136e4f61e6d6bb + src/stages/detectors/README.md: 12e8d24351eef05c src/stages/detectors/absence-of-governance.ts: 954d8ce5c45b3b32 src/stages/detectors/ac-drift.ts: 1bceeae9ee99080b src/stages/detectors/ac-duplicate-within-feature.ts: 652ad48c8cd1ab2e src/stages/detectors/ai-hints-forbidden-pattern.ts: 96b225595ffd4d0a src/stages/detectors/architecture-from-spec.ts: ee36fa5f94a5be2a src/stages/detectors/architecture-violation.ts: b5035317a61e5ebe - src/stages/detectors/capabilities-feature-mapping.ts: c969d5dfa45851e1 + src/stages/detectors/capabilities-feature-mapping.ts: fa245f053f98a78a src/stages/detectors/convention-drift.ts: 450cb86924dfcf82 src/stages/detectors/coverage-drop.ts: 809d13599596793e - src/stages/detectors/deliverable-integrity.ts: 2d14f1064eeb41a7 + src/stages/detectors/deliverable-integrity.ts: d0fbc1dd05bd245a src/stages/detectors/dependency-cycle.ts: 873c8fdde00aa48b src/stages/detectors/doc-reference-integrity.ts: ac693db9c4bed946 src/stages/detectors/evidence-mismatch.ts: c633778b8f9ec0af @@ -272,7 +282,7 @@ attested_modules: src/stages/detectors/planned-backlog.ts: a6850576b00d4a44 src/stages/detectors/project-context-drift.ts: d3643f369537a8e8 src/stages/detectors/reference-integrity.ts: 8883766a4bf69c61 - src/stages/detectors/scenario-coverage.ts: ff4cc3aa721abe26 + src/stages/detectors/scenario-coverage.ts: 53f90149b1f152d6 src/stages/detectors/slug-conflict.ts: 5d9b8feec12dce07 src/stages/detectors/smoke-probe-demand.ts: 792b6d0d07f82a16 src/stages/detectors/spec-conformance.ts: 8c74460349f0acef @@ -285,38 +295,38 @@ attested_modules: src/stages/detectors/tech-stack-mismatch.ts: 099162aff2c2966b src/stages/detectors/unmapped-artifact.ts: b29f7e277d8187ae src/stages/detectors/untested-ac.ts: 90725ef1fc9245d8 - src/stages/detectors/unverified-ac.ts: d78913ae463c88d6 + src/stages/detectors/unverified-ac.ts: 6887c4d699afaad5 src/stages/detectors/with-spec.ts: dcf3205e8d563574 src/stages/disposition.ts: b7fd2e591235a326 src/stages/drift.ts: d3993f3b168ceb34 src/stages/finding-parser.ts: 19a10c5fe216059c src/stages/graph-health.ts: a294f06796b0e293 src/stages/junit-report.ts: f8466dc1e00140f1 - src/stages/lint.ts: 2f316b14e048eafb - src/stages/perf.ts: 17888e913435e0fa + src/stages/lint.ts: c1513a7c710fb13b + src/stages/perf.ts: 2b27c12427f65b2e src/stages/secret.ts: b90abc0e00c86219 src/stages/skip-policy.ts: 1a6412d708561cf0 - src/stages/smoke.ts: 486205cd691a2b0d - src/stages/spec-conformance.ts: ba68465c4715cc65 + src/stages/smoke.ts: cbe55596f6b0a49e + src/stages/spec-conformance.ts: 1e9b052a2a268d7a src/stages/test-run-cache.ts: 46df49ab73a1a72e src/stages/toolchain/coverage-tool.ts: 310883060ed6d92e - src/stages/toolchain/detect.ts: 33e2f90c954a6c10 - src/stages/toolchain/gate-config.ts: 35c31716191a3dee + src/stages/toolchain/detect.ts: 36d4947e5567bd5f + src/stages/toolchain/gate-config.ts: 818a0a549d875581 src/stages/toolchain/language-config.ts: 65175718559b0710 src/stages/toolchain/module-scope.ts: 88358ec3b84eedd3 src/stages/toolchain/scoped-command.ts: f2dd6410c063279f src/stages/toolchain/types.ts: 05f018fb3dddc321 - src/stages/type.ts: abe900ea8236d37f + src/stages/type.ts: 0ac37e45b407446d src/stages/types.ts: 24b4dc30ec7d7f33 src/stages/uat.ts: 62ec3e37a124f8c5 - src/stages/unit.ts: f25add219b764f03 - src/stages/util.ts: 7943e14136ec2da7 + src/stages/unit.ts: fe5bf9e4bec1de77 + src/stages/util.ts: a024afe34884d653 src/stages/vacuous-tests.ts: 8e71b81e151325af - src/stages/visual.ts: 48bbb6e77f09ed63 + src/stages/visual.ts: 2b60dd991fa8124e src/ui: a4d0f0eb87fed960 src/ui/panel.ts: 8b78cb14dafb28fb src/ui/pulse.ts: ee4255f5c6e49f51 - src/ui/softShell.ts: c095f4185ab3d624 + src/ui/softShell.ts: 6db9d46de2d2e1b0 src/verdict/gate-progress.ts: ac75e3082cc97a40 src/verdict/verdict.ts: 493251b3a2c494d3 tests/adapters/anthropic.test.ts: fa2fc7faf032a782 @@ -324,7 +334,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: 6515b07cfd168433 + tests/cli/clad.test.ts: 19a2f5950d84da42 tests/cli/gate-golden-matrix.test.ts: 39cf615407a55abe tests/cli/init.test.ts: 3428a89708fc9330 tests/cli/intent-onboarding.test.ts: 0681b98ce2e74c22 @@ -361,8 +371,10 @@ attested_modules: tests/scenarios/ab/_vanilla-sim.ts: 1d7407f97cfc5e48 tests/scenarios/ab/case-existing-adoption.test.ts: 430e095a4f08fec6 tests/scenarios/ab/case-payment-saas.test.ts: 280404fbbfd0e6a3 - tests/scenarios/existing-adoption-lifecycle.test.ts: 23011bf2cf1e1bfb - tests/scenarios/greenfield-lifecycle.test.ts: a3f3cefd204f03cf + tests/scenarios/existing-adoption-lifecycle.test.ts: c1641cbe818087df + tests/scenarios/greenfield-lifecycle.test.ts: 434b58e6722aad1e + tests/scripts/test-count.test.ts: b00f58edc018f9d4 + tests/scripts/version-bump.test.ts: 560ec3095887f192 tests/self-consistency.test.ts: e7fbd651f0c60c4a tests/serve/description-budget.test.ts: e1501907eff9b923 tests/spec/ears.test.ts: e7385918da1d8c7a @@ -391,7 +403,7 @@ attested_modules: tests/stages/hardcoded-secret.test.ts: bf6adf480abdc4e0 tests/stages/harness-integrity.test.ts: 72e1770566c8e877 tests/stages/inventory-drift.test.ts: 5641e9bdfadb2d52 - tests/stages/lint.test.ts: 7bb84adc4f4e0820 + tests/stages/lint.test.ts: a5106351ff7aeabc tests/stages/meta-integrity.test.ts: f0781f010e95edd0 tests/stages/missing-implementation.test.ts: 2cf79871685fbdf4 tests/stages/missing-tests.test.ts: feb49f3af71cc1af @@ -400,18 +412,19 @@ attested_modules: tests/stages/reference-integrity.test.ts: 0f919c06f0ff96f3 tests/stages/secret.test.ts: 06291c1daf9df45c tests/stages/smoke.test.ts: 99f97875d29ac5d3 - tests/stages/spec-conformance.test.ts: 9f6ac08e09d7b10b + tests/stages/spec-conformance.test.ts: e3d809bcd00263a2 tests/stages/stale-evidence.test.ts: 8e8622f17eb7f955 tests/stages/stale-specification.test.ts: 09bd06db377d890c tests/stages/stale-tests.test.ts: 1467ceedb8019e86 tests/stages/status-drift.test.ts: cff1092eeb23c268 tests/stages/tech-stack-mismatch.test.ts: 878436ffd2f94c97 - tests/stages/toolchain.test.ts: 13b2229e49d1eaba + tests/stages/toolchain.test.ts: 04e12be4ac1dee5c + tests/stages/toolchain/gate-config.test.ts: aef5813a6591b153 tests/stages/type.test.ts: b57cf7455cae3b32 tests/stages/uat.test.ts: 29c5bf3e7f3abc35 - tests/stages/unit.test.ts: cb1eea0a14681948 + tests/stages/unit.test.ts: 97781210eb81bb25 tests/stages/unmapped-artifact.test.ts: 6bfdae66990fd63a - tests/stages/util.test.ts: 6e0e86140028f336 + tests/stages/util.test.ts: dd95144b36bfd2b1 tests/stages/visual.test.ts: dd819e7d25586b92 tests/ui/panel.test.ts: ad9ea207f34b1c51 tests/ui/pulse.test.ts: 30f1d091de9093ad @@ -508,6 +521,7 @@ attested_features: F-0e84628e: ok F-0ed2db: ok F-0f2984d0: ok + F-0f4dd6: ok F-10cc42d1: ok F-12d740: ok F-15999130: ok diff --git a/spec/capabilities.yaml b/spec/capabilities.yaml index a2f975a8..88b62505 100644 --- a/spec/capabilities.yaml +++ b/spec/capabilities.yaml @@ -27,7 +27,7 @@ capabilities: title: "MCP host (clad serve)" summary: "Exposes cladding's verbs as MCP tools for AI agents to drive directly" surface: tool - features: [F-bb15e6, F-836a90] + features: [F-bb15e6, F-836a90, F-0f4dd6] - id: ab-evaluation title: "A/B evaluation framework" summary: "Measures cladding vs vanilla Claude Code across 8 structural + 2 outcome dimensions" diff --git a/spec/features/agent-interpreter-rule-723c81dd.yaml b/spec/features/agent-interpreter-rule-723c81dd.yaml index 38d09642..0144b761 100644 --- a/spec/features/agent-interpreter-rule-723c81dd.yaml +++ b/spec/features/agent-interpreter-rule-723c81dd.yaml @@ -13,7 +13,7 @@ modules: acceptance_criteria: - id: AC-ad928912 ears: ubiquitous - text: "The injected CLAUDE.md section and the AGENTS.md template shall carry an interpreter rule: when reporting to the user, translate cladding terms into plain words in the user's own language and never lead with internal ids — with both freshness literals preserved verbatim." + text: "The injected CLAUDE.md section and the spec-driven AGENTS.md managed block shall carry an interpreter rule: when reporting to the user, translate cladding terms into plain words in the user's own language and never lead with internal ids — with both freshness literals preserved verbatim." notes: "## Why\nThe adopter screenshot shows the agent saying 'Shard AC 3개 추가 완료' — cladding's injected instructions teach shard-vocabulary and nothing tells the agent to translate. The rule is the third layer: hooks render plain (U2), cards drop jargon (U3), and the agent's own sentences translate (U4)." test_refs: [tests/agent-interpreter-rule.test.ts] - id: AC-6bf501f8 diff --git a/spec/features/deliverable-smoke-9064ff.yaml b/spec/features/deliverable-smoke-9064ff.yaml index d650307e..bc699d95 100644 --- a/spec/features/deliverable-smoke-9064ff.yaml +++ b/spec/features/deliverable-smoke-9064ff.yaml @@ -62,15 +62,16 @@ acceptance_criteria: test_refs: - tests/stages/detectors/deliverable-integrity.test.ts - id: AC-864efe - ears: optional - condition: "where done features ship modules but no deliverable is declared" - action: "leave an auditable advisory" - response: "DELIVERABLE_INTEGRITY emits a non-blocking warning" - text: "Where done features ship modules but no project.deliverable is declared, DELIVERABLE_INTEGRITY shall emit a non-blocking warning so that silencing the smoke (omitting the declaration) always leaves an auditable signal." + ears: state + condition: "while done features ship modules but no deliverable is declared" + action: "emit the established warning, relaxing only explicitly marked onboarding seeds to information before the shared eight-feature maturity boundary" + response: "generated early domain or library slices can complete without changing the signal for legacy or hand-authored projects" + text: "While done features ship modules but no project.deliverable is declared, DELIVERABLE_INTEGRITY shall warn, except that a project explicitly marked as onboarding-seeded shall receive information before the eight-feature maturity boundary and a warning at or after it." notes: | ## Decision - Warn (not error) so legacy projects without a declared deliverable are not retro-failed, - while still nudging adoption — the deterministic floor is complementary to, not a - replacement for, the impl-blind oracle (stage_2.3), which alone catches "runs but wrong". + Marker-scoped information keeps the first strict `done` reachable before an executable entry exists; + warning after the shared maturity boundary nudges adoption without weakening existing projects. The deterministic floor is + complementary to, not a replacement for, the impl-blind oracle (stage_2.3), which alone + catches "runs but wrong". test_refs: - tests/stages/detectors/deliverable-integrity.test.ts diff --git a/spec/features/host-smoke-matrix-5283985e.yaml b/spec/features/host-smoke-matrix-5283985e.yaml index 4ea20975..99869d12 100644 --- a/spec/features/host-smoke-matrix-5283985e.yaml +++ b/spec/features/host-smoke-matrix-5283985e.yaml @@ -5,12 +5,14 @@ status: done modules: - src/cli/doctor-hosts.ts - src/cli/clad.ts + - src/serve/server.ts + - src/init/host-setup.ts - src/stages/detectors/host-claim-drift.ts acceptance_criteria: - id: AC-87ebd442 ears: event condition: "when clad doctor --hosts runs with live-run consent (CLAD_HOST_SMOKE=1 or interactive confirmation)" - text: "When host smoke runs with consent, the system shall execute at most 3 canned one-shot prompts per host CLI found on PATH (claude, gemini, codex) and record per-host pass, fail, or not-run with the observed sentinel evidence into a dated artifact under .cladding/audit/." + text: "When host smoke runs with consent, the system shall execute at most 3 canned one-shot prompts per supported host CLI found on PATH (Claude Code, Gemini, Antigravity, Codex, and Cursor) and record per-host pass, fail, or not-run with the observed sentinel evidence into a dated artifact under .cladding/audit/." notes: "WHY: host verification is two hand-written dogfood docs pinned to v0.3.x — five minor versions stale; Codex explicitly deferred, Gemini drive-loop never exercised. Claims need dated receipts." test_refs: [tests/cli/doctor-hosts.test.ts] - id: AC-8dfa9cc4 @@ -33,6 +35,26 @@ acceptance_criteria: test_refs: [tests/stages/detectors/host-claim-drift.test.ts] - id: AC-6cbe51fc ears: ubiquitous - text: "The system shall grade hosts without a headless verification surface (Cursor) as wiring-only in the matrix, asserting only that the MCP wiring file is written and clad serve answers a tools list over stdio." - notes: "WHY: honest grading — wiring-only is a real, checkable claim; end-to-end is not checkable headlessly for Cursor." + text: "The system shall headlessly prompt-probe Cursor Agent alongside Claude Code, Gemini, Antigravity, and Codex, and shall additionally record whether Cursor's configured clad serve answers a tools list over stdio." + notes: "WHY: Cursor Agent now provides a headless CLI, so retaining the old wiring-only ceiling would understate directly observed end-to-end evidence." + test_refs: [tests/cli/doctor-hosts.test.ts] + - id: AC-0d93bc + ears: event + condition: "when a committed host-smoke artifact predates a newly separated host row" + action: "load the recorded rows without relabeling their evidence and synthesize an honest not-run fallback for the absent host" + response: "matrix regeneration remains compatible while each host claim keeps its original provenance" + text: "When an older host-smoke artifact omits Gemini or Antigravity, the system shall preserve every recorded host row and represent the missing host as not-run instead of copying evidence between hosts." + test_refs: [tests/cli/doctor-hosts.test.ts] + - id: AC-4a71e2 + ears: ubiquitous + action: "advertise the doctor MCP surfaces as read-only and configure project-local Codex, Gemini, and Cursor wiring to auto-approve only those read-only tools" + response: "headless verification can call the intended tools without granting a model unrestricted write access" + text: "The system shall mark list-features, get-feature, and drift-check MCP tools as read-only and shall keep write-capable tools approval-gated in project-local Codex, Gemini, and Cursor configuration." + test_refs: [tests/serve/server.test.ts, tests/cli/setup.test.ts] + - id: AC-8bf019 + ears: unwanted + condition: "if a host refusal or cancellation echoes a requested feature id or the word findings" + action: "classify the surface as failed before applying the positive sentinel matcher" + response: "a denied MCP call cannot become a vacuous pass by paraphrasing the prompt" + text: "If a host rejects or cancels an MCP call, the system shall record that surface as failed even when the response repeats its expected sentinel." test_refs: [tests/cli/doctor-hosts.test.ts] diff --git a/spec/features/lint-config-detection-b2094740.yaml b/spec/features/lint-config-detection-b2094740.yaml index 08963ee4..8fd7d25c 100644 --- a/spec/features/lint-config-detection-b2094740.yaml +++ b/spec/features/lint-config-detection-b2094740.yaml @@ -9,8 +9,8 @@ acceptance_criteria: - id: AC-7bf859 ears: ubiquitous action: "resolve the TypeScript/JavaScript lint gate from the linter the project actually configured" - response: "detectToolchain selects biome when biome.json/biome.jsonc is present, oxlint when any of its config files (.oxlintrc.json/.oxlintrc.jsonc/oxlint.config.ts) is present (biome winning when both are), and keeps the eslint default when no linter config is present — so prior eslint and config-less projects behave exactly as before" - text: "The system shall resolve the stage_1.2 lint gate for a TypeScript/JavaScript project from the linter that project configured — selecting biome on a biome.json/biome.jsonc, oxlint on any oxlint config file (.oxlintrc.json / .oxlintrc.jsonc / oxlint.config.ts, all auto-detected by oxlint), with biome taking precedence when both exist, and falling back to the eslint default when no linter config is present — so a biome- or oxlint-based project gates natively without an eslint shim, while eslint and config-less projects keep their existing behavior." + response: "detectToolchain runs scripts.lint when declared, otherwise selects biome, oxlint, or eslint from explicit configuration, and leaves an undeclared lint gate unregistered" + text: "The system shall resolve the stage_1.2 lint gate for a TypeScript/JavaScript project from the workflow that project declared — preferring scripts.lint, otherwise selecting biome on biome configuration, oxlint on oxlint configuration, or eslint on eslint configuration, and leaving lint unregistered when none is declared." notes: | ## Why stage_1.2 is the polyglot lint gate that `clad done` must pass, and it @@ -19,14 +19,19 @@ acceptance_criteria: bridging eslint in. The JS/TS ecosystem has several mainstream linters; the honest gate runs the one the project declared, read from its config file, not a single assumed default. + This criterion also owns the project-script precedence requirement that + was first discovered during onboarding handoff verification; it applies + to every TypeScript or JavaScript project, not only initialized ones. test_refs: - "tests/stages/toolchain.test.ts#typescript + biome.json → lint gate is biome" - "tests/stages/toolchain.test.ts#typescript + .oxlintrc.json → lint gate is oxlint" - "tests/stages/toolchain.test.ts#typescript + .oxlintrc.jsonc → lint gate is oxlint" - "tests/stages/toolchain.test.ts#typescript + oxlint.config.ts → lint gate is oxlint" - - "tests/stages/toolchain.test.ts#typescript with no linter config → lint gate stays eslint (default preserved)" + - "tests/stages/toolchain.test.ts#typescript with no lint script or config → lint gate is honestly unconfigured" + - "tests/stages/toolchain.test.ts#typescript scripts.lint → lint gate runs the exact project-owned workflow" + - "tests/stages/toolchain.test.ts#typescript eslint config without lint script → lint gate is eslint" - "tests/stages/toolchain.test.ts#biome takes precedence over oxlint when both configs present" - - "tests/stages/toolchain.test.ts#selection follows config presence — add biome.json swaps to biome, remove it falls back to eslint" + - "tests/stages/toolchain.test.ts#selection follows declarations — add biome.json enables biome, remove it leaves lint unconfigured" - id: AC-86822d ears: unwanted condition: "if a non-TypeScript project carries a stray linter config, or the resolved linter is not installed" diff --git a/spec/features/natural-language-init-0f4dd6.yaml b/spec/features/natural-language-init-0f4dd6.yaml new file mode 100644 index 00000000..77e5899c --- /dev/null +++ b/spec/features/natural-language-init-0f4dd6.yaml @@ -0,0 +1,400 @@ +id: F-0f4dd6 +slug: natural-language-init +title: "Natural-language init across skill and MCP hosts" +status: done +modules: + - src/serve/server.ts + - src/cli/init.ts + - src/cli/clarify.ts + - src/cli/host-onboarding.ts + - src/cli/hook.ts + - src/ui/softShell.ts + - src/init/host-setup.ts + - src/init/agents-md.ts + - src/init/host-instructions.ts + - skills/init/SKILL.md + - src/cli/update.ts + - src/cli/clad.ts + - src/spec/new.ts + - src/spec/schema.json + - src/spec/types.ts + - src/cli/done.ts + - src/events/log.ts + - src/stages/detectors/capabilities-feature-mapping.ts + - src/stages/detectors/scenario-coverage.ts + - src/stages/detectors/deliverable-integrity.ts + - README.md + - docs/setup.md + - docs/glossary.md + - docs/ssot-model.md + - docs/dogfood/codex-cli-2026-07-15.md + - docs/dogfood/cursor-agent-2026-07-15.md + - docs/dogfood/antigravity-cli-2026-07-15.md + - src/stages/detectors/README.md + - src/stages/README.md +depends_on: [ F-56abaa, F-5f6b45, F-80d19d ] +acceptance_criteria: + - id: AC-001 + ears: ubiquitous + action: expose project initialization and onboarding answers as MCP tools that + reuse the CLI core + response: MCP hosts can complete init and its follow-up Q&A without asking the + user to run a shell command + text: The system shall expose project initialization and onboarding answers as + MCP tools that reuse the CLI core, so MCP hosts can complete init and its + follow-up Q&A without asking the user to run a shell command. + test_refs: [ tests/serve/server.test.ts, tests/serve/init-tools.test.ts ] + - id: AC-002 + ears: event + condition: when a new-project initialization request omits the project idea + action: return a needs-input result before creating any project artifact + response: the host asks for intent instead of producing a generic scaffold + text: When a new-project initialization request omits the project idea, the + system shall return a needs-input result before creating any project + artifact, so the host asks for intent instead of producing a generic + scaffold. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-003 + ears: event + condition: when initialization uses a planning document + action: read a recognized UTF-8 text file confined to the connected project root + and pass its complete body through the existing intent-aware onboarding + path + response: the planning document is neither truncated nor mistaken for literal intent + text: When initialization uses a planning document, the system shall read a + recognized UTF-8 text file confined to the connected project root and pass + its complete body through the existing intent-aware onboarding path, so + the planning document is neither truncated nor mistaken for literal + intent. + test_refs: [ tests/serve/init-tools.test.ts ] + notes: "WHY: Node's permissive utf8 string decoder replaces malformed bytes; the MCP boundary uses a fatal UTF-8 decoder so a binary or corrupt document cannot silently become different intent." + - id: AC-004 + ears: event + condition: when initialization adopts an existing project + action: force the observed scan path even when the project contains fewer than + three source files + response: sparse existing projects are not treated as greenfield ideas + text: When initialization adopts an existing project, the system shall force the + observed scan path even when the project contains fewer than three source + files, so sparse existing projects are not treated as greenfield ideas. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-005 + ears: unwanted + condition: if the connected project already contains spec.yaml and refresh was + not explicitly requested + action: return an already-initialized result without creating proposals or + changing project files + response: repeated natural-language requests remain non-destructive + text: If the connected project already contains spec.yaml and refresh was not + explicitly requested, the system shall return an already-initialized + result without creating proposals or changing project files, so repeated + natural-language requests remain non-destructive. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-006 + ears: event + condition: when init or clarify returns pending product questions + action: include the next question and onboarding status in structured MCP output + response: the host can continue one answer at a time until onboarding is complete + text: When init or clarify returns pending product questions, the system shall + include the next question and onboarding status in structured MCP output, + so the host can continue one answer at a time until onboarding is + complete. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-007 + ears: state + condition: while clad setup activates host integrations + action: write discovery configuration only inside the selected project and keep + every other project free of Cladding skills and MCP tools + response: installing Cladding globally cannot influence unrelated host sessions + text: While clad setup activates host integrations, the system shall write + discovery configuration only inside the selected project and keep every + other project free of Cladding skills and MCP tools, so installing + Cladding globally cannot influence unrelated host sessions. + test_refs: [ tests/cli/setup.test.ts ] + notes: | + ## Decision + The npm package remains global, but host discovery is project-scoped. + ## Why + Host models receive every globally discovered skill description and MCP tool even when they never invoke it; prompt wording cannot provide a context-level isolation guarantee. + ## Trade-off + Each developer runs `clad setup` once per project and machine, gaining structural isolation at the cost of one explicit activation step. + - id: AC-008 + ears: ubiquitous + action: document natural-language init as the primary path and describe each + host's optional explicit invocation syntax accurately + response: Claude Code, Codex, Gemini, Antigravity, and Cursor receive accurate + project-scoped startup guidance + text: The system shall document natural-language init as the primary path and + describe each host's project-scoped startup accurately, so Claude Code, + Codex, Gemini, Antigravity, and Cursor receive accurate project-scoped startup + guidance. + evidence_refs: [ README.md, docs/setup.md ] + notes: | + ## Decision + Keep raw `clad init` as a compatibility and automation surface, not the primary onboarding UX. + ## Why + A host-neutral natural-language entry point preserves the product model while host-specific syntax remains an optional accelerator. + ## Trade-off + MCP init and clarify tools are required to make that promise deterministic for hosts without a bundled skill. + - id: AC-009 + ears: unwanted + condition: if an initialization request has not been followed by a separate + affirmative user confirmation after the read-only preview + action: reject the apply step without creating project artifacts + response: opening a project, asking about Cladding, or making the initial + natural-language request cannot silently authorize file changes + text: If an initialization request has not been followed by a separate + affirmative user confirmation after the read-only preview, the system + shall reject the apply step without creating project artifacts, so opening + a project, asking about Cladding, or making the initial natural-language + request cannot silently authorize file changes. + test_refs: [ tests/serve/init-tools.test.ts ] + notes: | + ## Decision + Natural language may start the read-only preparation, but a distinct user turn authorizes the write. + ## Why + All supported MCP hosts can call tools, but they do not expose a common cryptographic user-consent primitive. + ## Trade-off + The host instruction and verbatim confirmation field provide the strongest portable boundary; a malicious host could still fabricate consent, so this is not presented as a sandbox guarantee. + - id: AC-010 + ears: unwanted + condition: if the apply request does not carry the exact one-time approval + challenge shown in the read-only preview + action: reject initialization without writing project artifacts + response: questions, acknowledgements, and model-invented confirmations cannot + be mistaken for user consent + text: If the apply request does not carry the exact one-time approval challenge + shown in the read-only preview, the system shall reject initialization + without writing project artifacts, so questions, acknowledgements, and + model-invented confirmations cannot be mistaken for user consent. + test_refs: [ tests/serve/init-tools.test.ts ] + notes: | + ## Decision + Use a short preview-bound approval challenge rather than attempting to classify arbitrary affirmative prose across languages. + ## Why + MCP has no portable proof of which user turn produced an argument; exact challenge matching is the strongest host-neutral check available and makes accidental application materially harder. + ## Trade-off + Initialization is a one-time destructive boundary, so one explicit copy/confirm step is preferred over a lower-friction but ambiguous yes/no classifier. + - id: AC-011 + ears: event + condition: when the supplied idea, planning document, and observed project + already resolve the important product decisions + action: emit no follow-up questions + response: complete inputs can move directly into development while incomplete + inputs receive at most three material product questions + text: When the supplied idea, planning document, and observed project already + resolve the important product decisions, the system shall emit no + follow-up questions, so complete inputs can move directly into development + while incomplete inputs receive at most three material product questions. + test_refs: [ tests/serve/init-tools.test.ts, tests/cli/intent-onboarding.test.ts ] + - id: AC-012 + ears: event + condition: when a planning document and existing source code are both present + action: combine the complete project-local document with an observed code scan + in one onboarding preparation + response: hybrid projects do not have to discard either declared intent or + sparse implementation evidence + text: When a planning document and existing source code are both present, the + system shall combine the complete project-local document with an observed + code scan in one onboarding preparation, so hybrid projects do not have to + discard either declared intent or sparse implementation evidence. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-013 + ears: event + condition: when a follow-up answer refines untouched Cladding-generated + onboarding artifacts + action: update those artifacts atomically and keep onboarding active until every + answer is represented in the active design + response: onboarding cannot report completion while the accepted answer exists + only in a review proposal + text: When a follow-up answer refines untouched Cladding-generated onboarding + artifacts, the system shall update those artifacts atomically and keep + onboarding active until every answer is represented in the active design, + so onboarding cannot report completion while the accepted answer exists + only in a review proposal. + test_refs: [ tests/serve/init-tools.test.ts, tests/cli/clarify.test.ts ] + - id: AC-014 + ears: unwanted + condition: if an onboarding artifact changed after the read-only preparation or + a write fails while applying the draft + action: leave every authored project file at its pre-apply content and return a + stale or failed result + response: initialization and clarification never leave a partially applied design + text: If an onboarding artifact changed after the read-only preparation or a + write fails while applying the draft, the system shall leave every + authored project file at its pre-apply content and return a stale or + failed result, so initialization and clarification never leave a partially + applied design. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-015 + ears: event + condition: when onboarding completes + action: report that ordinary natural-language development may continue, + distinguish on-demand checks from opt-in hook or CI enforcement, and + require each material feature to resolve its design impact before done + response: the handoff is truthful and Tier-B design grows selectively with the + project + text: When onboarding completes, the system shall report that ordinary + natural-language development may continue, distinguish on-demand checks + from opt-in hook or CI enforcement, and require each material feature to + resolve its design impact before done, so the handoff is truthful and + Tier-B design grows selectively with the project. + test_refs: [ tests/serve/server.test.ts, tests/cli/done.test.ts ] + evidence_refs: [ README.md, src/init/agents-md.ts, src/serve/server.ts ] + - id: AC-016 + ears: event + condition: when a host restarts its MCP server between the read-only preview and + the user's separate approval reply + action: validate a restart-safe approval envelope against the current workspace + snapshot + response: headless and process-per-turn hosts can apply the approved preview + while stale or replayed envelopes remain non-destructive + text: When a host restarts its MCP server between the read-only preview and the + user's separate approval reply, the system shall validate a restart-safe + approval envelope against the current workspace snapshot, so headless and + process-per-turn hosts can apply the approved preview while stale or + replayed envelopes remain non-destructive. + test_refs: [ tests/serve/init-tools.test.ts ] + - id: AC-017 + ears: state + condition: while an activated project has no spec.yaml and the user has not + explicitly named Cladding + action: expose only the narrowly described init bootstrap and reject non-init + mutations before writing + response: ordinary development remains ordinary even after setup but before + explicit initialization + text: While an activated project has no spec.yaml and the user has not + explicitly named Cladding, the system shall expose only the narrowly + described init bootstrap and reject non-init mutations before writing, so + ordinary development remains ordinary even after setup but before explicit + initialization. + test_refs: + [ + tests/init/skill-activation.test.ts, + tests/cli/setup.test.ts, + tests/serve/server.test.ts, + tests/serve/init-tools.test.ts + ] + notes: "WHY: hiding post-init MCP tools removes their descriptions from pre-init model context; rejecting only at execution time did not satisfy the narrow-bootstrap context boundary." + - id: AC-018 + ears: event + condition: when project-scoped setup finds a legacy global Cladding integration + action: remove only entries whose ownership is proven by a known Cladding + package root or managed launch signature and preserve every ambiguous file + response: upgrading stops unrelated-project influence without deleting user + configuration + text: When project-scoped setup finds a legacy global Cladding integration, the + system shall remove only entries whose ownership is proven by a known + Cladding package root or managed launch signature and preserve every + ambiguous file, so upgrading stops unrelated-project influence without + deleting user configuration. + test_refs: [ tests/cli/setup.test.ts ] + - id: AC-019 + ears: ubiquitous + action: use AGENTS.md as the onboarding-generated cross-host instruction + surface while preserving the established update behavior for CLAUDE.md + response: init avoids a new host-specific copy and existing update users retain + their managed Claude guidance + text: The system shall generate AGENTS.md during onboarding without creating or + changing CLAUDE.md, while clad update shall retain its established managed + CLAUDE.md refresh, so init has one shared guidance source without breaking + existing update workflows. + test_refs: [ tests/cli/update.test.ts, tests/cli/init-onboarding-english-source.test.ts ] + - id: AC-020 + ears: event + condition: when a process-per-turn host stages a validated onboarding draft + before showing the approval challenge + action: retain that exact draft only as ignored project runtime state and apply + it after the complete approval phrase without asking the model to + reconstruct intent + response: MCP process restarts cannot replace a planning document or observed + project intent with an approval code + text: When a process-per-turn host stages a validated onboarding draft before + showing the approval challenge, the system shall retain that exact draft + only as ignored project runtime state and apply it after the complete + approval phrase without asking the model to reconstruct intent, so MCP + process restarts cannot replace a planning document or observed project + intent with an approval code. + test_refs: [ tests/serve/init-tools.test.ts ] + notes: | + ## Decision + Add a read-only staging tool between host-model drafting and the destructive apply tool. + ## Why + Real Codex headless sessions reload MCP per turn and may isolate temporary directories; without a durable staged draft, a new model turn can reconstruct the wrong intent from the approval code. + ## Trade-off + Staging writes an opaque short-lived cache under the already ignored `.cladding/host/` runtime boundary, while authored spec and documentation remain untouched until exact approval. + - id: AC-021 + ears: event + condition: when an activated project's ignored runtime launcher receives shell + command arguments after initialization + action: forward those arguments to the exact engine used for MCP while retaining + no-argument MCP startup + response: post-init shell validation cannot silently use a different global + build from the connected MCP server + text: When the project runtime launcher receives shell command arguments, the + system shall forward them to the same engine used for MCP while preserving + no-argument MCP startup, so post-init validation cannot silently use + another build. + test_refs: [ tests/cli/setup.test.ts ] + notes: | + ## Decision + Make the existing ignored Node launcher dual-purpose instead of adding a second machine-specific command surface. + ## Why + The live Codex campaign connected MCP to the branch build but resolved shell `clad` to an older global build carrying the same version string, so schema validation disagreed without an obvious version warning. + ## Trade-off + The launcher's historical `serve.cjs` name remains slightly narrower than its role, but existing host configurations stay compatible and every argument is forwarded without shell interpolation. + - id: AC-022 + ears: state + condition: while the generated AGENTS.md guides ordinary development after + initialization + action: prefer the project runtime for Cladding shell commands and require the + declared test command to collect relevant tests without shell-expanded + glob dependencies + response: agents use one engine and cannot treat a vacuous or host-specific test + invocation as completion evidence + text: While generated project guidance directs ordinary development, the system + shall prefer the project Cladding runtime and require non-vacuous, + shell-portable test execution, so engine skew and host-specific test globs + cannot masquerade as completion. + test_refs: [ tests/init/agents-md.test.ts ] + - id: AC-023 + ears: state + condition: while a project marked as onboarding-seeded is below the shared + eight-feature design-maturity threshold and retains unbound onboarding + capabilities or scenarios + action: report those future design links as information while continuing to + block dangling references and under-bound flows + response: the first ordinary feature can earn a strict done result without + deleting valid future intent + text: While a project explicitly marked as onboarding-seeded is below the + design-maturity threshold, the system shall treat unbound onboarding + capabilities and scenarios as informational future intent while retaining + blocking checks for invalid links, so an early feature can complete without + changing the warning behavior of legacy or hand-authored projects. + test_refs: + [ + tests/stages/capabilities-feature-mapping.test.ts, + tests/stages/scenario-coverage.test.ts + ] + notes: | + ## Decision + Persist an onboarding-seeded marker and graduate only those generated empty-link findings from information to warning at the existing eight-feature maturity boundary. + ## Why + Onboarding intentionally authors three to eight future capabilities and one to three future journeys with empty feature links, while strict mode promotes every warning to an error. Treating those intentional seeds as warnings made the first `clad done` impossible. + ## Trade-off + Onboarding-seeded small projects may retain visibly informational future design; once the project reaches eight features, unresolved empty links become strict-gate blockers again. Projects without the marker keep the established warning at every size. + - id: AC-027 + ears: state + condition: while a project marked as onboarding-seeded is below the shared + eight-feature design-maturity threshold and its first completed domain or + library slice has no runnable entry point yet + action: report the missing deliverable decision as information and retain the + warning after the maturity boundary + response: the first feature can complete without inventing an unsafe smoke + target while grown products must resolve the entry-point obligation + text: While a project explicitly marked as onboarding-seeded is below the + design-maturity threshold and has no runnable entry point yet, the system + shall treat the missing deliverable decision as information and restore the + warning after the threshold, so the first feature can complete without + changing the warning behavior of legacy or hand-authored projects. + test_refs: [ tests/stages/detectors/deliverable-integrity.test.ts ] diff --git a/spec/features/no-vacuous-green-gate-contract-af96b1.yaml b/spec/features/no-vacuous-green-gate-contract-af96b1.yaml index e5a0c327..fad1f5cc 100644 --- a/spec/features/no-vacuous-green-gate-contract-af96b1.yaml +++ b/spec/features/no-vacuous-green-gate-contract-af96b1.yaml @@ -4,6 +4,14 @@ slug: no-vacuous-green-gate-contract title: No Vacuous Green — honest gate exit-contract, shared spec-load seam, ambient hook (v0.4.x) status: done modules: + - src/stages/util.ts + - src/stages/type.ts + - src/stages/lint.ts + - src/stages/unit.ts + - src/stages/cov.ts + - src/stages/smoke.ts + - src/stages/perf.ts + - src/stages/visual.ts - src/stages/detectors/with-spec.ts - src/init/git-hook.ts - .github/workflows/ci.yml @@ -37,3 +45,13 @@ acceptance_criteria: response: 'tests/self-consistency.test.ts asserts the corrected self-drift fixes (counts, version, banners), and .github/workflows/ci.yml runs `npm test` plus the strict spec-native self-gate (`clad check --tier=pre-commit --strict`) on every push/PR so any future regression actually fails CI rather than the lock being a vacuous claim; these are cladding-self checks, not shipped detectors, so an adopting project may legitimately diverge without being false-failed' text: The system shall enforce cladding's own self-consistency (detector-count claims, spec/package version parity, tier banners) as CI-locked tests so the drift-prevention tool cannot silently drift against itself. test_refs: [tests/self-consistency.test.ts] + - id: AC-005 + ears: event + condition: when a locally constrained npx invocation cannot resolve its requested executable without registry access + action: classify only that unresolved target as a visible setup gap while preserving failures from tools that did start + response: missing optional tooling neither stalls offline work nor hides a real nested-command failure + text: When an offline local-only npx invocation cannot resolve its requested executable, the system shall report a setup gap without contacting the registry, while a tool that started and failed internally shall remain a blocking failure. + notes: | + This general stage exit-contract rule was isolated from onboarding handoff + verification because it applies equally to legacy and hand-authored projects. + test_refs: [tests/stages/util.test.ts] diff --git a/spec/features/scenario-coverage-detector-315fd7.yaml b/spec/features/scenario-coverage-detector-315fd7.yaml index 1a7a0dfb..506032d7 100644 --- a/spec/features/scenario-coverage-detector-315fd7.yaml +++ b/spec/features/scenario-coverage-detector-315fd7.yaml @@ -19,14 +19,14 @@ acceptance_criteria: - id: AC-002 ears: unwanted condition: if a scenario declares an empty features[] list - action: 'warn that the scenario binds no features regardless of project size' - text: If a scenario binds no features, the system shall warn that it is hollow — a scenario must cover at least one feature's flow. + action: 'report that the scenario binds no features as a warning, relaxing only marked onboarding seeds to information below the maturity threshold' + text: If a scenario binds no features, the system shall warn about the unresolved link, except that a project explicitly marked as onboarding-seeded may retain it as information until the design-maturity threshold. test_refs: [tests/stages/scenario-coverage.test.ts] - id: AC-003 ears: ubiquitous - action: 'classify both signals warn so a small or genuinely flow-free project is not hard-broken, while a push/CI under --strict blocks' - response: 'the signal rides the existing warn/strict dial; a small project under the threshold with no scenarios is silent' - text: The system shall classify scenario-coverage findings as warn — advisory locally, blocking under --strict. + action: 'classify grown-project scenario-coverage findings as warn while retaining only explicitly marked early onboarding seeds as info' + response: 'the grown-project signal rides the existing warn/strict dial, while generated future journeys do not alter the established behavior of legacy or hand-authored projects' + text: The system shall make grown-project scenario-coverage gaps blocking under strict mode while keeping explicitly marked early onboarding seeds informational and all unmarked hollow scenarios advisory. test_refs: [tests/stages/scenario-coverage.test.ts] - id: AC-004 ears: event diff --git a/spec/features/self-count-guard-898783ee.yaml b/spec/features/self-count-guard-898783ee.yaml index 3bd8355a..8f527524 100644 --- a/spec/features/self-count-guard-898783ee.yaml +++ b/spec/features/self-count-guard-898783ee.yaml @@ -4,6 +4,16 @@ title: "Self-consistency guard for public counts + doc drift repair" status: done modules: - tests/self-consistency.test.ts + - scripts/test-count.mjs + - scripts/test-count.d.mts + - tests/scripts/test-count.test.ts + - package.json + - README.md + - README.ko.md + - README.ja.md + - README.zh.md + - README.html + - README.ko.html - src/stages/detectors/README.md - docs/README.md - docs/img/en/ecosystem.svg @@ -33,3 +43,9 @@ acceptance_criteria: text: "docs/README.md tier index shall list every live doc under docs/ (adding the previously missing rows: glossary, feature-cycle, gate-scope, ssot-testing, knowledge-graph/design)." evidence_refs: ["docs/README.md"] notes: "WHY: the index omissions made live docs read as orphaned; several deletion candidates in the 2026-07 audit were misjudged dead partly because the index never listed them." + - id: AC-8ded2bb9 + ears: event + condition: "when Vitest's collected test total differs from a public README badge or release-status total" + text: "The release build shall fail with the file and collected total, while the explicit write mode shall update all six Markdown and HTML README variants only after every claim surface validates." + test_refs: ["tests/scripts/test-count.test.ts"] + notes: "WHY: the public 2522/2522 claim lagged the live 2551-test suite; deriving the number at build time prevents the reference implementation from publishing another stale all-pass total." diff --git a/spec/features/setup-command-80d19d.yaml b/spec/features/setup-command-80d19d.yaml index f44d69be..049d0250 100644 --- a/spec/features/setup-command-80d19d.yaml +++ b/spec/features/setup-command-80d19d.yaml @@ -1,103 +1,93 @@ id: F-80d19d slug: setup-command -title: "clad setup command — explicit host wire (replaces F-90d054 postinstall hook)" +title: "clad setup command — project-scoped host wire (0.9.0 model; replaced the 0.3.x global symlink wire)" status: done modules: - src/init/host-setup.ts - src/init/host-instructions.ts - src/cli/clad.ts - src/cli/init.ts - - plugins/claude-code/.claude-plugin/plugin.json - - .claude-plugin/marketplace.json - .claude/settings.json acceptance_criteria: - id: AC-001 ears: event - condition: when the user runs `clad setup` and one or more of the four supported AI tool home directories exist (`~/.claude/`, `~/.gemini/`, `~/.codex/`, `~/.agents/`) - action: wire only the detected channels (Claude plugin / Gemini extension / Codex skills / Codex MCP) and leave undetected hosts untouched - response: the user gets host channels wired exclusively for AI tools they actually have installed, with no surprise directories created in `$HOME` - text: When the user runs `clad setup` and one or more of the four supported AI - tool home directories exist, the system shall wire only the detected - channels and leave undetected hosts untouched, so the user gets host - channels wired exclusively for installed AI tools with no surprise - directories created in $HOME. - + condition: when the user runs `clad setup` with no `--host` option + action: wire only the host channels whose home markers exist on this machine (`~/.claude/`, `~/.codex/`, `~/.gemini/`, `~/.gemini/config` or `~/.gemini/antigravity-cli` for Antigravity, `~/.cursor/`), report the rest as `not selected`, and warn plus write only the shared project runtime when nothing is detected + response: projects gain wiring exclusively for AI tools the developer actually has; `--host all` remains the explicit way to force every channel + text: When the user runs `clad setup` with no `--host` option, the system + shall wire only the detected host channels and leave undetected hosts + untouched (warning when none are detected), so projects gain wiring only + for AI tools actually installed while `--host all` stays available as an + explicit override. test_refs: - - "tests/cli/setup.test.ts#wires only the host channels whose home directory exists" + - "tests/cli/setup.test.ts#writes only project-local host discovery files" + - "tests/cli/setup.test.ts#default detection wires nothing on a machine with no supported host" - id: AC-002 ears: state - condition: while every detected host channel is already wired to the current cladding root (target match) - action: report each channel as "already wired" and perform no filesystem changes - response: idempotent re-run prints a clean "Nothing to do" summary - text: While every detected host channel is already wired to the current - cladding root, the system shall report each channel as already wired and - perform no filesystem changes, so idempotent re-runs print a clean - summary without side effects. - + condition: while every selected host channel is already wired for the current engine root + action: report each channel as already ready and perform no filesystem changes + response: idempotent re-runs are safe and visibly no-ops + text: While every selected host channel is already wired for the current + engine root, the system shall report each channel as already ready and + perform no filesystem changes, so idempotent re-runs are safe. test_refs: - - "tests/cli/setup.test.ts#second run reports already-wired without re-creating links" + - "tests/cli/setup.test.ts#is idempotent and stores setup status under the project" - id: AC-003 ears: event condition: when the user runs `clad setup` after installing a new AI tool that was not detected on the previous run - action: wire only the newly detected channel (delta wire) while leaving previously wired channels untouched + action: wire only the newly detected channel while leaving previously wired channels untouched response: the new tool gets a cladding channel without re-touching the already-wired ones text: When the user runs `clad setup` after installing a new AI tool that was not detected on the previous run, the system shall wire only the newly detected channel while leaving previously wired channels untouched, so the new tool gets a cladding channel without re-touching the already-wired ones. - test_refs: - - "tests/cli/setup.test.ts#delta-wires a host that was not installed on the previous run" + - "tests/cli/setup.test.ts#delta-wires a host that appears after the first run, leaving wired ones untouched" - id: AC-004 ears: event - condition: when the user runs `clad setup` after upgrading cladding to a new version whose package root resolves to a different absolute path than the existing symlink target - action: replace the symlink target with the new cladding root (re-wire) - response: host channels point at the upgraded cladding without manual cleanup - text: When the user runs `clad setup` after upgrading cladding to a new - version whose package root differs from the existing symlink target, - the system shall replace the symlink target with the new cladding - root, so host channels point at the upgraded cladding without manual - cleanup. - + condition: when the user runs `clad setup` after upgrading cladding so the engine package root differs from the one baked into the project runtime launcher + action: regenerate `.cladding/host/serve.cjs` against the new engine root + response: host channels launch the upgraded engine without manual cleanup, because every host config points at the stable project-relative launcher + text: When the user runs `clad setup` after upgrading cladding so the + engine root differs from the one baked into the project runtime + launcher, the system shall regenerate `.cladding/host/serve.cjs` + against the new root, so host channels launch the upgraded engine + without manual cleanup. test_refs: - - "tests/cli/setup.test.ts#re-wires when the symlink target no longer matches the current cladding root" + - "tests/cli/setup.test.ts#re-wires the project runtime when the engine root changes (upgrade path)" - id: AC-005 ears: event - condition: when the user runs `clad setup` and one or more channel symlinks have been deleted (host AI may have reset its plugin directory, or the user removed them) - action: re-create the missing symlinks (same effect as a first-time wire for those channels) + condition: when the user runs `clad setup` and the project runtime launcher has been deleted + action: re-create the missing launcher (same effect as a first-time wire for that file) response: "`clad setup` works as a repair command without a separate flag" - text: When the user runs `clad setup` and one or more channel symlinks - have been deleted, the system shall re-create the missing symlinks, - so `clad setup` works as a repair command without a separate flag. - + text: When the user runs `clad setup` and the project runtime launcher has + been deleted, the system shall re-create it, so `clad setup` works as a + repair command without a separate flag. test_refs: - - "tests/cli/setup.test.ts#re-creates a missing symlink as a repair" + - "tests/cli/setup.test.ts#re-creates a deleted project runtime as a repair, no separate flag" - id: AC-006 ears: state - condition: while `clad init` runs in a project and no `~/.cladding/setup-status.json` exists (user never ran `clad setup`) - action: print a friendly skipped notice ("host channels not wired yet — run `clad setup` to enable `/cladding init` from Claude Code / Codex / Gemini") and continue with spec generation - response: missing host wire does not block spec creation; user is guided to the next step - text: While `clad init` runs and no setup-status.json exists, the system + condition: while `clad init` runs in a project whose `.cladding/setup-status.json` does not exist (the user never ran `clad setup` here) + action: print a friendly skipped notice naming `clad setup` and continue with spec generation + response: missing host wire does not block spec creation; the user is guided to the next step + text: While `clad init` runs and no project setup-status exists, the system shall print a friendly skipped notice naming `clad setup` and continue with spec generation, so missing host wire does not block spec creation and the user is guided to the next step. - test_refs: - - "tests/cli/setup.test.ts#hostWireNotice points at clad setup when no setup-status exists" + - "tests/cli/setup.test.ts#hostWireNotice guides toward clad setup and surfaces version skew without blocking" - id: AC-007 ears: state - condition: while `clad init` runs and the cladding binary version differs from the version recorded in `~/.cladding/setup-status.json` from the last `clad setup` run - action: print a friendly skipped notice that symlinks usually auto-follow but `clad setup` can be re-run to be sure, and continue with spec generation - response: version-skew is surfaced without blocking; the user can choose whether to re-run setup - text: While `clad init` runs and the cladding binary version differs from - the version recorded in setup-status.json, the system shall print a - friendly skipped notice and continue with spec generation, so version - skew is surfaced without blocking and the user can choose whether to - re-run setup. - + condition: while `clad init` runs and the engine version differs from the version recorded in the project's `.cladding/setup-status.json` + action: print a friendly notice suggesting `clad setup` be re-run in this project, and continue with spec generation + response: version skew is surfaced without blocking; the user chooses whether to refresh the wire + text: While `clad init` runs and the engine version differs from the + version recorded in the project's setup-status, the system shall print + a friendly notice and continue with spec generation, so version skew is + surfaced without blocking. test_refs: - - "tests/cli/setup.test.ts#hostWireNotice flags version skew between wire and binary" + - "tests/cli/setup.test.ts#hostWireNotice guides toward clad setup and surfaces version skew without blocking" - id: AC-008 ears: unwanted condition: if a user runs `npm install -g cladding` (or `--ignore-scripts`, or any npm install flavour) @@ -106,71 +96,67 @@ acceptance_criteria: text: If a user runs `npm install -g cladding`, the system shall not execute any host-wiring side effects during install, so `npm install` is pure binary installation with zero filesystem side effects in $HOME. - - test_refs: - - "tests/cli/setup.test.ts#importing host-setup does not wire anything on its own" + evidence_refs: + - package.json - id: AC-009 ears: unwanted - condition: if a channel link exists as a directory copy (Windows non-admin fallback) and its mtime/contents diverge from the cladding root (user may have customised in place) - action: emit a `skipped-different` / `conflict` notice in the report and refuse to overwrite unless `--force` is supplied - response: user customisations under host plugin directories are preserved unless the user explicitly opts in to overwrite - text: If a channel link is a directory copy and its contents diverge from - the cladding root, the system shall emit a conflict notice and refuse - to overwrite unless `--force` is supplied, so user customisations are - preserved unless explicitly overridden. - + condition: if a host config already carries a `cladding` MCP entry that setup does not recognize as its own launch shape + action: emit a `skipped-different` conflict notice and refuse to overwrite unless `--force` is supplied + response: user customisations are preserved unless the user explicitly opts in to overwrite + text: If a host config already carries a cladding MCP entry that setup + does not recognize as its own launch shape, the system shall emit a + conflict notice and refuse to overwrite unless `--force` is supplied, + so user customisations are preserved unless explicitly overridden. test_refs: - - "tests/cli/setup.test.ts#refuses to overwrite a non-symlink wire without --force" + - "tests/cli/setup.test.ts#preserves a conflicting user MCP entry unless force is explicit" + - "tests/cli/setup.test.ts#Gemini setup preserves a conflicting Cladding entry unless force is explicit" - id: AC-010 ears: event - condition: when `clad setup` finishes successfully (any combination of created / unchanged / rewired / copied / skipped-not-installed) - action: print a numbered "다음 단계" guidance block (open AI tool → cd to project → `/cladding init "..."` → start coding) as the last stdout block + condition: when `clad setup` finishes successfully (any combination of wired / already ready / not selected) + action: end the report with a numbered next-steps block (start a new AI session in the project → ask to apply Cladding → reply with the exact approval phrase → develop normally) response: the user always sees a concrete next-step recipe at the end of the report - text: When `clad setup` finishes successfully, the system shall print a - numbered "다음 단계" guidance block as the last stdout block, so the - user always sees a concrete next-step recipe at the end of the - report. - + text: When `clad setup` finishes successfully, the system shall end the + report with a numbered next-steps block, so the user always sees a + concrete next-step recipe. test_refs: - - "tests/cli/setup.test.ts#renderSetupReport ends with the numbered 다음 단계 guidance block" + - "tests/cli/setup.test.ts#report explains the project boundary and normal post-init development" - id: AC-011 ears: event - condition: when `clad setup` runs on a machine where `~/.cursor/` exists (Cursor IDE installed) - action: write or merge the `mcpServers.cladding` entry into `~/.cursor/mcp.json` (JSON merge, preserving other entries) so Cursor picks up cladding as an MCP server on restart - response: Cursor users get cladding wired without manual JSON edits - text: When `clad setup` runs and `~/.cursor/` exists, the system shall - merge `mcpServers.cladding = {command, args}` into `~/.cursor/mcp.json` - so Cursor users get cladding wired without manual JSON edits. - + condition: when `clad setup` wires the Cursor channel + action: write project-local `.cursor/mcp.json` (JSON merge preserving other entries), `.cursor/cli.json` read-only MCP permissions, the bootstrap rule, and the project skill copy + response: Cursor users get cladding wired per-project without manual JSON edits + text: When `clad setup` wires the Cursor channel, the system shall write + the project-local Cursor MCP config, permissions, bootstrap rule, and + skill copy while preserving unrelated entries, so Cursor users get + cladding wired per-project without manual JSON edits. test_refs: - - "tests/cli/setup.test.ts#wires Cursor mcp.json with the absolute engine, preserving existing servers" + - "tests/cli/setup.test.ts#Cursor permissions preserve unrelated allow and deny entries" + - "tests/cli/setup.test.ts#writes only project-local host discovery files" - id: AC-012 ears: event - condition: when `clad setup` finishes wiring a host channel AND the corresponding host CLI binary (claude / gemini) is on PATH - action: invoke the host's plugin activation command non-interactively (`claude plugin marketplace add` + `claude plugin install claude-code@cladding`, `gemini extensions link`); on failure fall back to printing the manual command in the activation hint - response: users with a host CLI binary on PATH get the plugin enabled in one command; users without one get a precise manual command - text: When `clad setup` finishes wiring a channel and the corresponding - host CLI binary is on PATH, the system shall invoke the host's plugin - activation command non-interactively, so users get the plugin enabled - in one command, and otherwise fall back to printing the manual command. - + condition: when `clad setup` runs on a machine that still carries pre-0.9.0 global wires (plugin symlinks, `~/.agents/skills/cladding-*`, `~/.codex/config.toml` / `~/.cursor/mcp.json` entries) + action: remove only the entries whose ownership is provable (symlink target inside a known cladding root, or a recognized launch shape), preserving everything else byte-for-byte where possible + response: legacy global installs migrate to the project-scoped model without destroying user configuration + text: When `clad setup` runs on a machine with pre-0.9.0 global wires, + the system shall remove only ownership-proven entries and preserve + everything else, so legacy installs migrate without destroying user + configuration. test_refs: - - "tests/cli/setup.test.ts#invokes the claude activator with the wired plugin path" - - "tests/cli/setup.test.ts#activate:false suppresses activation even when channels are wired" + - "tests/cli/setup.test.ts#removes only provably-owned legacy global wires" + - "tests/cli/setup.test.ts#preserves unowned global files with Cladding-like names" + - "tests/cli/setup.test.ts#codex legacy cleanup preserves user comments and formatting outside the cladding entry" + - "tests/cli/setup.test.ts#cursor legacy cleanup drops an emptied mcpServers object instead of leaving an orphan" - id: AC-013 ears: event - condition: when `clad init` runs and a project-local AGENTS.md or CLAUDE.md exists that carries v0.3.x markers (e.g. `_meta.enrichment_status`, `first-task enrichment rule`, lone `clad_create_feature` MCP tool wording with no `clad` CLI qualifier) - action: refresh the stale file in place (AGENTS.md replaced wholesale; CLAUDE.md replaces only the `## cladding` section while preserving user content outside that marker block) + condition: when `clad init` runs and a project-local CLAUDE.md exists whose `## cladding` section carries v0.3.x markers (e.g. `_meta.enrichment_status`, `first-task enrichment rule`, lone `clad_create_feature` MCP tool wording with no `clad` CLI qualifier) + action: refresh only the `## cladding` section in place while preserving user content outside that marker block (AGENTS.md is handled separately by the spec-driven managed block, which treats markerless files as user-owned and never rewrites them wholesale) response: AI sessions opened in projects scaffolded by older cladding versions do not surface stale "use the MCP tool" guidance that triggers spurious MCP-server prompts in hosts where cladding is not wired as an MCP server (e.g. Claude Code) - text: When `clad init` runs and an existing AGENTS.md or CLAUDE.md carries - v0.3.x markers, the system shall refresh the stale file in place - without requiring `--force` (AGENTS.md replaced wholesale; CLAUDE.md - replaces only the `## cladding` section while preserving outside - content), so AI sessions do not surface stale guidance that confuses - hosts where cladding is not wired as an MCP server. - + text: When `clad init` runs and an existing CLAUDE.md `## cladding` + section carries v0.3.x markers, the system shall refresh that section + in place without requiring `--force` while preserving user content + outside the marker block, so AI sessions do not surface stale guidance + that confuses hosts where cladding is not wired as an MCP server. test_refs: - - "tests/init/host-instructions.test.ts#refreshes stale v0.3.x AGENTS.md without --force" - "tests/init/host-instructions.test.ts#refreshes only the ## cladding section when v0.3.x markers are present" - id: AC-014 ears: state @@ -182,6 +168,19 @@ acceptance_criteria: with `enabledPlugins["claude-code@cladding"] = true` so Claude Code activates the local cladding plugin on entry without a separate maintainer-only setup step. - evidence_refs: - - ".claude/settings.json" \ No newline at end of file + - ".claude/settings.json" + - id: AC-015 + ears: event + condition: when `clad setup` wires the Antigravity channel (agy reads MCP config only from machine-wide locations, never from the project — verified live in the 0.9.0 E2E campaign) + action: write the machine-wide wire at `~/.gemini/config/plugins/cladding/` with an engine-absolute launch (the project is still resolved from each session's working directory), keep the forward-compat project `.agents/mcp_config.json`, refuse to write through a surviving unowned symlink or over a foreign real directory without `--force`, and say so in the report + response: Antigravity actually connects to cladding, the single documented exception to project-local activation is loudly reported, and foreign installs are never clobbered + text: When `clad setup` wires the Antigravity channel, the system shall + write the machine-wide wire agy actually reads (engine-absolute launch; + project resolved per session working directory), keep the forward-compat + project file, refuse foreign or symlinked targets without `--force`, + and report the exception, so Antigravity connects without silently + breaking the project-local activation story. + test_refs: + - "tests/cli/setup.test.ts#writes only project-local host discovery files" + - "tests/cli/setup.test.ts#a foreign real directory at the antigravity plugin path is preserved and reported" diff --git a/spec/features/spec-conformance-oracle-stage-c4c5ae.yaml b/spec/features/spec-conformance-oracle-stage-c4c5ae.yaml index 0f559bfa..65f86bf2 100644 --- a/spec/features/spec-conformance-oracle-stage-c4c5ae.yaml +++ b/spec/features/spec-conformance-oracle-stage-c4c5ae.yaml @@ -6,6 +6,9 @@ status: done modules: - src/stages/spec-conformance.ts - tests/stages/spec-conformance.test.ts + - src/stages/toolchain/gate-config.ts + - tests/stages/toolchain/gate-config.test.ts + - src/stages/detectors/unverified-ac.ts - src/stages/detectors/spec-conformance.ts - tests/stages/detectors/spec-conformance.test.ts - src/oracle/payload.ts @@ -64,3 +67,17 @@ acceptance_criteria: response: the recorded provenance is what the SPEC_CONFORMANCE gate audits (author≠implementer, manifest∩modules=∅); the shard edit goes through the yaml Document API so comments and layout survive text: When clad_author_oracle is called, the system shall write the oracle, record its impl-blind provenance, and stamp oracle_refs without malforming the shard. test_refs: [tests/oracle-record.test.ts] + - id: AC-008 + ears: event + condition: when the spec-conformance stage runs only the impl-blind oracle suite and the project reporter shares a result path with the full unit suite + action: preserve every configured or conventional full-suite test report across the scoped oracle invocation + response: a later strict gate cannot mistake the oracle-only selection for the project's complete test evidence + text: When spec conformance runs only the impl-blind oracle suite, the system shall preserve shared full-suite test reports across that scoped invocation, so a later strict gate cannot misread partial oracle results as complete test evidence. + notes: | + ## Decision + Snapshot configured and conventional test-report candidates before the oracle-only command, then restore existing files and remove candidates created only by that partial run. + ## Why + The oracle stage appends `tests/oracle` to the project runner, while reporters may still overwrite the shared full-suite result path. Without restoration, the next strict gate can report false unverified-acceptance findings. + ## Trade-off + Report preservation holds existing report bytes for the scoped run; restoration failures block instead of leaving misleading evidence. + test_refs: [tests/stages/spec-conformance.test.ts, tests/stages/toolchain/gate-config.test.ts] diff --git a/spec/features/spec-driven-agents-md-a4085adf.yaml b/spec/features/spec-driven-agents-md-a4085adf.yaml index 9e96bdc6..15fec3b7 100644 --- a/spec/features/spec-driven-agents-md-a4085adf.yaml +++ b/spec/features/spec-driven-agents-md-a4085adf.yaml @@ -11,7 +11,7 @@ acceptance_criteria: ears: state condition: "while an adopting project's spec declares project.ai_hints" text: "While an adopting project's spec declares project.ai_hints, clad init and clad sync shall render the AGENTS.md managed block from that spec — the project's test framework, primary branch, forbidden and preferred patterns, and preferred persona — instead of a static template." - notes: "Today src/init/host-instructions.ts writes a static AGENTS_MD_TEMPLATE with zero spec interpolation. Source fields: spec.yaml::project.ai_hints (F-5b9f9f/F-32b1e0) + project name/intent." + notes: "Historical: pre-0.9.0 host-instructions.ts wrote a static template with zero spec interpolation; it was removed once this managed block became the sole AGENTS.md writer. Source fields: spec.yaml::project.ai_hints (F-5b9f9f/F-32b1e0) + project name/intent." - id: AC-2c8b5f61 test_refs: - tests/init/agents-md.test.ts diff --git a/spec/features/ssot-governance-d12edf.yaml b/spec/features/ssot-governance-d12edf.yaml index 8f6dbb8b..a3f5bfc6 100644 --- a/spec/features/ssot-governance-d12edf.yaml +++ b/spec/features/ssot-governance-d12edf.yaml @@ -41,9 +41,10 @@ acceptance_criteria: - id: AC-003 ears: ubiquitous action: resolve the spec/capabilities.yaml orphan by introducing the CAPABILITIES_FEATURE_MAPPING detector so the Tier B artifact gains an actual consumer - response: 'src/stages/detectors/capabilities-feature-mapping.ts exports a detector that loads spec/capabilities.yaml and spec.yaml, then emits error findings for capability features[] entries that reference a non-existent feature id, warn findings for capabilities whose features[] is empty or missing (orphan capability), and info findings for spec.yaml features that no capability claims; detector skips silently when capabilities.yaml is missing or capabilities array is empty (adoption hasn`t reached this artifact yet); registered in src/stages/detectors/index.ts (24 → 25 detectors)' + response: 'src/stages/detectors/capabilities-feature-mapping.ts exports a detector that loads spec/capabilities.yaml and spec.yaml, then emits error findings for capability features[] entries that reference a non-existent feature id, keeps the established warning for unbound capabilities, relaxes only Cladding-authored onboarding seeds to information below eight features, and emits info findings for spec.yaml features that no capability claims; detector skips silently when capabilities.yaml is missing or capabilities array is empty (adoption hasn`t reached this artifact yet); registered in src/stages/detectors/index.ts (24 → 25 detectors)' text: The system shall resolve the spec/capabilities.yaml orphan by introducing the CAPABILITIES_FEATURE_MAPPING detector so the Tier B artifact gains an actual consumer. test_refs: [tests/stages/capabilities-feature-mapping.test.ts] + notes: "The optional project.onboarding_seeded marker scopes the maturity grace to generated future intent; missing markers retain the established warning behavior." - id: AC-004 ears: ubiquitous action: close the docs/project-context.md ↔ spec/scenarios loop by extending intent-aware onboarding to extract user-journey scenarios from the project-context prose diff --git a/spec/features/ts-toolchain-jest-and-multiext-arch-47b8bee5.yaml b/spec/features/ts-toolchain-jest-and-multiext-arch-47b8bee5.yaml index f663a021..5ab87a44 100644 --- a/spec/features/ts-toolchain-jest-and-multiext-arch-47b8bee5.yaml +++ b/spec/features/ts-toolchain-jest-and-multiext-arch-47b8bee5.yaml @@ -14,10 +14,20 @@ acceptance_criteria: test_refs: ["tests/stages/toolchain.test.ts"] - id: AC-a3be7a76 ears: event - condition: "when no jest config file is present in a detected TypeScript/JavaScript project" + condition: "when no jest config and no custom test script is present in a detected TypeScript/JavaScript project" action: "keep the vitest test and coverage gate defaults unchanged" - response: "config-less and vitest projects behave exactly as before (backward compatible)" - text: "When no jest config file is present in a detected TypeScript/JavaScript project, the system shall keep the vitest `run` test gate and `run --coverage` coverage gate defaults unchanged." + response: "legacy config-less projects behave exactly as before while explicit custom runners remain authoritative" + text: "When no jest config and no custom test script is present in a detected TypeScript/JavaScript project, the system shall keep the vitest `run` test and `run --coverage` defaults unchanged." + test_refs: ["tests/stages/toolchain.test.ts"] + - id: AC-4f0c9d + ears: event + condition: "when a TypeScript or JavaScript project declares a non-canonical test script or an explicit coverage script" + action: "run those project-owned workflows instead of substituting an inferred test runner, and omit coverage when neither a script nor supported runner coverage is available" + response: "Node's built-in test runner and other custom workflows remain authoritative without creating a false optional coverage gate" + text: "When a TypeScript or JavaScript project declares a custom test or coverage workflow, the system shall run the project-owned script before inferred ecosystem defaults and shall leave unsupported optional coverage unregistered." + notes: | + This general toolchain rule was isolated from onboarding handoff work so + its ownership and compatibility boundary are explicit for every project. test_refs: ["tests/stages/toolchain.test.ts"] - id: AC-3a899053 ears: ubiquitous diff --git a/spec/features/vacuous-test-guard-b81d203e.yaml b/spec/features/vacuous-test-guard-b81d203e.yaml index bf145a55..93c3e7a8 100644 --- a/spec/features/vacuous-test-guard-b81d203e.yaml +++ b/spec/features/vacuous-test-guard-b81d203e.yaml @@ -4,6 +4,7 @@ title: "vacuous-test guard — a done feature's declared tests must actually exe status: done modules: - src/stages/vacuous-tests.ts + - src/stages/unit.ts acceptance_criteria: - id: AC-41e112d3 test_refs: @@ -24,9 +25,9 @@ acceptance_criteria: test_refs: - tests/stages/vacuous-tests.test.ts ears: unwanted - condition: "if the per-test data cannot be parsed or the test runner is unsupported" + condition: "if neither per-test data nor a definitive aggregate execution count can be parsed, or the test runner is unsupported" response: "fall back to the existing exit-code behavior with no error" - text: "If the per-test data cannot be parsed or the test runner is unsupported, the system shall fall back to the exit-code behavior without failing the gate." + text: "If neither per-test data nor a definitive aggregate execution count can be parsed, or the test runner is unsupported, the system shall fall back to the exit-code behavior without failing the gate." notes: "DEFENSIVE (non-negotiable): a parse failure must NEVER fail the gate. Guard fires only when we are confident." - id: AC-d7a9568e test_refs: @@ -41,3 +42,11 @@ acceptance_criteria: ears: ubiquitous text: "The guard shall apply only to done features and shall preserve the test runner's human-readable output." notes: "Planned/in-progress features are legitimately incomplete. Dual-reporter (json to file + default to stdout) so clad check output stays readable." + - id: AC-0e76a1b2 + test_refs: + - tests/stages/unit.test.ts + ears: unwanted + condition: "if a successful test command definitively reports zero executed tests" + response: "emit a blocking VACUOUS_TESTS finding under strict mode" + text: "If a successful test command definitively reports zero executed tests, the system shall emit a blocking VACUOUS_TESTS finding under strict mode." + notes: "This runner-independent aggregate guard owns the zero-test case discovered during onboarding handoff verification; it is not scoped to initialized projects." diff --git a/spec/features/version-bump-script-6d943d.yaml b/spec/features/version-bump-script-6d943d.yaml index 3d81a0bd..03e7eead 100644 --- a/spec/features/version-bump-script-6d943d.yaml +++ b/spec/features/version-bump-script-6d943d.yaml @@ -1,17 +1,19 @@ id: F-6d943d slug: version-bump-script -title: Atomic version-bump script — single command for 7 sync sites (v0.3.15) +title: Atomic version-bump script — single command for 11 sync sites status: done modules: - scripts/version-bump.mjs - package.json + - package-lock.json + - tests/scripts/version-bump.test.ts depends_on: [F-080] acceptance_criteria: - id: AC-001 ears: ubiquitous - action: ship a single-command script that atomically bumps the cladding version across all seven sites where it lives - response: 'scripts/version-bump.mjs accepts a single SemVer argument (major.minor.patch) and replaces the literal version string in package.json, .claude-plugin/plugin.json, plugins/codex/.codex-plugin/plugin.json, plugins/gemini-cli/gemini-extension.json, src/cli/clad.ts, src/serve/server.ts, and tests/cli/clad.test.ts; prints a per-file summary; exits non-zero on any error' - text: The system shall ship scripts/version-bump.mjs that atomically bumps the cladding version across all seven sites where it lives (package.json · 3 host manifests · src/cli/clad.ts · src/serve/server.ts · tests/cli/clad.test.ts) so the manual seven-edit ritual collapses into a single command and the HARNESS_INTEGRITY drift risk is eliminated at the source. + action: ship a single-command script that atomically bumps the cladding version across all eleven sites where it lives + response: 'scripts/version-bump.mjs accepts a single SemVer argument (major.minor.patch), validates all 11 version sites across 10 files including both package-lock.json copies, and writes only after every site validates; prints a per-site summary; exits non-zero without partial writes on any error' + text: The system shall ship scripts/version-bump.mjs that atomically bumps the cladding version across all eleven sites where it lives, including both package-lock.json copies and every host manifest, so the manual edit ritual collapses into a single command and version drift is eliminated at the source. test_refs: [tests/scripts/version-bump.test.ts] - id: AC-002 ears: ubiquitous @@ -35,8 +37,8 @@ acceptance_criteria: test_refs: [tests/scripts/version-bump.test.ts] - id: AC-005 ears: state - condition: while one of the seven files has its anchor pattern broken (e.g. the version field renamed) - action: report which file is broken and exit non-zero without touching the other six - response: the script collects per-file errors and prints them under an `errors:` heading after the change summary; the other six files are bumped successfully but the exit code is non-zero so the user knows to investigate - text: While one of the seven files has its anchor pattern broken, the system shall report which file is broken and exit non-zero so a refactor that moves the version string is caught at the next bump rather than silently leaving one site stale. + condition: while one of the eleven version sites has its anchor pattern broken (e.g. the version field renamed) + action: report which file is broken and exit non-zero without writing any version-bearing file + response: the script validates every site before its write phase, prints errors under an `errors:` heading, leaves all 10 files unchanged, and exits non-zero + text: While one of the eleven version sites has its anchor pattern broken, the system shall report which file is broken and exit non-zero without partial writes, so a refactor that moves a version string cannot leave a half-bumped release. test_refs: [tests/scripts/version-bump.test.ts] diff --git a/spec/index.yaml b/spec/index.yaml index 7cbadbcf..1daf12cb 100644 --- a/spec/index.yaml +++ b/spec/index.yaml @@ -94,6 +94,7 @@ features: F-0e84628e: {slug: merge-ritual-docs, status: done, modules: 2} F-0ed2db: {slug: ai-hints-consumer-instructions, status: done, modules: 11} F-0f2984d0: {slug: infer-deps-dynamic-flag, status: done, modules: 2} + F-0f4dd6: {slug: natural-language-init, status: done, modules: 29} F-10cc42d1: {slug: git-op-write-guard, status: done, modules: 5} F-12d740: {slug: atomic-ac-evidence-fanout, status: done, modules: 1} F-15999130: {slug: inferable-depends-on-detector, status: done, modules: 2} @@ -135,7 +136,7 @@ features: F-4db939: {slug: ab-evaluation, status: done, modules: 9} F-4ef09f38: {slug: multi-probe-smoke, status: done, modules: 3} F-50ff43: {slug: meta-integrity-skip-when-absent, status: done, modules: 2} - F-5283985e: {slug: host-smoke-matrix, status: done, modules: 3} + F-5283985e: {slug: host-smoke-matrix, status: done, modules: 5} F-551a1c: {slug: oracle-cost-lever, status: done, modules: 4} F-569f4b37: {slug: graph-export-viz, status: done, modules: 5} F-56abaa: {slug: intent-aware-init, status: done, modules: 5} @@ -153,7 +154,7 @@ features: F-67d2e9: {slug: strict-skip-policy, status: done, modules: 2} F-67e33f: {slug: spec-id-multi-dev-safety, status: done, modules: 7} F-6ba22c5c: {slug: value-telemetry, status: done, modules: 5} - F-6d943d: {slug: version-bump-script, status: done, modules: 2} + F-6d943d: {slug: version-bump-script, status: done, modules: 4} F-6e49fd24: {slug: inventory-churn-diet, status: done, modules: 1} F-6ed216f3: {slug: interactive-drift-profile, status: done, modules: 5} F-6f80e7: {slug: claude-code-dogfood, status: done, modules: 1} @@ -167,10 +168,10 @@ features: F-7ce18e: {slug: glossary-naming-convention, status: done, modules: 7} F-7fa4a7: {slug: mcp-sampling-dispatcher, status: done, modules: 1} F-803386ab: {slug: python-first-class, status: done, modules: 3} - F-80d19d: {slug: setup-command, status: done, modules: 7} + 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-898783ee: {slug: self-count-guard, 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} F-9064ff: {slug: deliverable-smoke, status: done, modules: 8} @@ -194,7 +195,7 @@ features: F-aee1da: {slug: scan-residuals, status: done, modules: 3} F-aee61f: {slug: scan-roots-from-architecture, status: done, modules: 1} F-af45042a: {slug: graph-live-health, status: done, modules: 5} - F-af96b1: {slug: no-vacuous-green-gate-contract, status: done, modules: 6} + F-af96b1: {slug: no-vacuous-green-gate-contract, status: done, modules: 14} F-b010427b: {slug: detector-layer-purity, status: done, modules: 2} F-b0c8ba2c: {slug: gate-no-progress, status: done, modules: 1} F-b0f898a6: {slug: attestation-v2-per-module, status: done, modules: 3} @@ -202,7 +203,7 @@ features: F-b43066: {slug: model-defaults-refresh, status: done, modules: 6} F-b61449: {slug: gemini-cli-dogfood, status: done, modules: 1} F-b7873005: {slug: gate-error-parser, status: done, modules: 1} - F-b81d203e: {slug: vacuous-test-guard, status: done, modules: 1} + F-b81d203e: {slug: vacuous-test-guard, status: done, modules: 2} F-b84c38: {slug: lifecycle-events-identity, status: done, modules: 4} F-b8d74801: {slug: verb-rename-residue-sweep, status: done, modules: 6} F-b99577: {slug: stale-archive-suggestion, status: done, modules: 4} @@ -217,7 +218,7 @@ features: F-c2c996: {slug: checkpoint-events, status: done, modules: 3} 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: 8} + F-c4c5ae: {slug: spec-conformance-oracle-stage, status: done, modules: 11} 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/agents/README.md b/src/agents/README.md index db8e0af1..5b8c01c5 100644 --- a/src/agents/README.md +++ b/src/agents/README.md @@ -8,7 +8,7 @@ ironclad-track: T9 (multi-agent orchestrator) ## [CLAIM] -The 5 agent personas — orchestrator · planner (formerly `librarian`) · reviewer · observability · developer (formerly `specialists`) — each shipped as a Claude Code subagent (frontmatter + system prompt). Their canonical source lives in this directory; `npm run build:plugin` mirrors them into `agents/`, `plugins/codex/skills/`, and `plugins/gemini-cli/commands/`. +The 6 agent personas — orchestrator · planner (formerly `librarian`) · reviewer · observability · developer (formerly `specialists`) · blind-author — each shipped as a Claude Code subagent (frontmatter + system prompt). Their canonical source lives in this directory; `npm run build:plugin` mirrors them into `plugins/claude-code/agents/`, `plugins/codex/skills/`, and `plugins/antigravity/skills/`. ## [PERSONAS] @@ -21,6 +21,7 @@ Each persona's individual `.md` carries a "Sources (what you read, by Tier)" sec | `reviewer` | Philosophical guardrails; independent audit | Read, Bash | A + B + C + D evidence | (none — audit only) | | `observability` | Log + metrics analyst | Read, Bash | D only (events.log, audit.log, perf, coverage) | (reports only) | | `developer` | Implementer (code, tests, migrations) | Read, Write, Edit, Bash | B (project-context, architecture, capabilities) + C (conventions) + A (current feature slice) | stages/, tests/, hitl/ | +| `blind-author` | Impl-blind test/oracle author (no Read/Grep/Glob/Edit by construction) | Write, Bash | A (acceptance criteria + module signatures only — never the implementation) | tests/ (conformance oracles) | ## [INVOCATION_PRINCIPLES] @@ -56,4 +57,4 @@ Cross-boundary rules: ## [TBD] -- Routing config (`src/agents/routing.yaml`) with intent → agent mapping. `commands/clad.md` is the single user-facing verb manifest today; per-verb skills live under `skills//SKILL.md` (auto-mirrored to `commands/.md`, `plugins/codex/skills/.md`, `plugins/gemini-cli/commands/.md`). +- Routing config (`src/agents/routing.yaml`) with intent → agent mapping. Per-verb skills live under `skills//SKILL.md`, auto-mirrored to `plugins/codex/skills//` and `plugins/antigravity/skills//` (Gemini receives only the init command as `plugins/gemini-cli/commands/init.toml`). diff --git a/src/agents/blind-author.md b/src/agents/blind-author.md index dac74eea..8b0eacab 100644 --- a/src/agents/blind-author.md +++ b/src/agents/blind-author.md @@ -1,6 +1,6 @@ --- name: blind-author -description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. +description: Impl-blind test/oracle author — writes conformance tests from a spec-only brief. Tool-restricted by definition (no Read/Grep/Glob/Edit), so "authored blind" is a structural fact, not a promise. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Write, Bash capabilities: [write, exec] --- diff --git a/src/agents/developer.md b/src/agents/developer.md index 6d1c2835..7393b7cf 100644 --- a/src/agents/developer.md +++ b/src/agents/developer.md @@ -1,6 +1,6 @@ --- name: developer -description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. +description: Implementer — writes production code, tests, and migrations. The "generic engineer" fallback when no narrower specialist exists. 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 capabilities: [read, write, edit, exec] --- diff --git a/src/agents/observability.md b/src/agents/observability.md index da1e4251..5beb1a28 100644 --- a/src/agents/observability.md +++ b/src/agents/observability.md @@ -1,6 +1,6 @@ --- name: observability -description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. +description: Log and metrics analyst — reads .cladding/audit.log.jsonl, perf/baseline.json, and drift reports; surfaces patterns the human can act on. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/src/agents/orchestrator.md b/src/agents/orchestrator.md index 49b89e79..bf8d0c1e 100644 --- a/src/agents/orchestrator.md +++ b/src/agents/orchestrator.md @@ -1,6 +1,6 @@ --- name: orchestrator -description: Workflow conductor — sequences agents based on the 5 invocation principles. Routes user intent to the right persona. +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. tools: Read, Write, Edit, Bash, Agent capabilities: [read, write, edit, exec, dispatch] --- @@ -29,17 +29,7 @@ You do NOT pre-load Tier C (conventions — developer's concern). 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 + refine policy (의무)** — Two-step Q&A loop that captures intent and refines spec/docs through the user's own answers. - - **Step 6a (init).** Before calling `clad init` on a greenfield project (empty directory or `<3` source files), **ASK THE USER for their project intent in one line**. A natural question is enough: "어떤 종류의 프로젝트인가요? 한 줄로 설명해주세요". Forward the user's reply as the positional intent: `clad init ` (no quotes needed — commander treats trailing tokens as variadic). The init handler routes the LLM to produce a domain-aware project-context + capabilities + architecture + a real first-feature title (used when the AI later registers the first feature via `clad_create_feature`) + 2-3 product-level clarifying questions, and writes `.cladding/onboarding/state.yaml` with the questions marked pending. DO NOT call bare `clad init` on a greenfield workspace — the result is a generic toolchain scaffold that misses the user's actual intent. (For an existing project ≥3 source files, bare `clad init` is fine — the observed scan path captures the codebase shape directly.) - - **Step 6b (clarify loop).** After init, drive the Q&A loop until the onboarding state file is marked `status: done`: - - Read `.cladding/onboarding/state.yaml` and find the first `answer: null` entry. - - Ask the user that exact question in chat, verbatim. Do NOT rephrase technical-sounding questions into your own words — the LLM calibrated them at product-owner vocabulary level. - - When the user replies, run `clad clarify ` (no quotes needed). The handler marks the question answered, calls the LLM with the full Q-A history, refines `docs/project-context.md` + `spec/capabilities.yaml` + `spec/architecture.yaml`, and may add new follow-up questions. - - Loop until `clad clarify --json` reports `status: "done"` OR the user says they have enough. Never invent extra questions — only the LLM's questions are sanctioned for this loop. - - If the user declines to answer a question, accept that and skip it (they can revisit via `clad clarify ` later, since pending state persists). +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 diff --git a/src/agents/planner.md b/src/agents/planner.md index b2f7ed45..7736e7b7 100644 --- a/src/agents/planner.md +++ b/src/agents/planner.md @@ -1,6 +1,6 @@ --- name: planner -description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. +description: SSoT custodian — keeps spec.yaml structurally clean. Adds features, archives them, and ensures EARS pattern compliance. 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 capabilities: [read, write, edit, exec] --- @@ -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. `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). Pre-v0.3.30 auto-extraction from code is deprecated. ## Project policy — `spec.yaml::project.ai_hints` diff --git a/src/agents/reviewer.md b/src/agents/reviewer.md index 99246fc8..837d92e0 100644 --- a/src/agents/reviewer.md +++ b/src/agents/reviewer.md @@ -1,6 +1,6 @@ --- name: reviewer -description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. +description: Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects. tools: Read, Bash capabilities: [read, exec] --- diff --git a/src/cli/clad.ts b/src/cli/clad.ts index 04ae5a01..6cffdd98 100644 --- a/src/cli/clad.ts +++ b/src/cli/clad.ts @@ -24,7 +24,8 @@ import {runHookCommand} from './hook.js'; import {runVerdictCommand} from './verdict.js'; import {runUpdate} from './update.js'; import {runInit} from './init.js'; -import {runClarifyCommand} from './clarify.js'; +import {refineOnboarding, resolveOnboardingReview, runClarifyCommand} from './clarify.js'; +import {prepareHostClarify, prepareHostInit, renderHostDraft} from './host-onboarding.js'; import {getCurrentCladdingVersion, runHostSetup} from '../init/host-setup.js'; import {recordEvent} from '../events/log.js'; import {buildContextSlice} from '../optimizer/context-slice.js'; @@ -80,7 +81,17 @@ export async function runServeCommand(opts: {cwd?: string}): Promise { import('@modelcontextprotocol/sdk/server/stdio.js'), import('../adapters/host/sampling-context.js'), ]); - const server = buildServer({cwd: opts.cwd}); + const server = buildServer({ + cwd: opts.cwd, + onboarding: { + renderDraft: (draft) => renderHostDraft(draft as Parameters[0]), + prepareInit: ({cwd, mode, intent}) => prepareHostInit(cwd, mode, intent), + initialize: runInit, + prepareClarify: (answer, {cwd}) => prepareHostClarify(cwd, answer), + clarify: refineOnboarding, + resolveReview: (targets, {cwd}) => resolveOnboardingReview(targets, {cwd}), + }, + }); // v0.2.26 (F-075): register the server in the sampling context so // the host adapters (`generic-mcp`, `claude-code`) automatically // route LLM dispatch through McpSamplingTransport instead of the @@ -122,6 +133,7 @@ export async function runInitCommand( roots?: string; withHook?: boolean; withCi?: boolean; + json?: boolean; }, ): Promise { const intent = intentTokens && intentTokens.length > 0 ? intentTokens.join(' ').trim() : undefined; @@ -135,6 +147,11 @@ export async function runInitCommand( withHook: opts.withHook, withCi: opts.withCi, }); + if (opts.json) { + process.stdout.write(`${JSON.stringify(result, null, 2)}\n`); + process.exit(0); + return; + } for (const c of result.created) pulse('pass', `created ${c}`); for (const s of result.skipped) pulse('skip', s); for (const p of result.proposals ?? []) pulse('note', 'proposal', p); @@ -371,16 +388,27 @@ export function runRollbackCommand(featureId: string, opts: {reason?: string} = process.exit(0); } -/** Handler for `clad setup`. Wires cladding into installed AI tool host channels. */ -export async function runSetupCommand(opts: {force?: boolean; quiet?: boolean}): Promise { - const result = await runHostSetup({force: opts.force, quiet: opts.quiet}); +/** Handler for `clad setup`. Activates Cladding only for one project. */ +export async function runSetupCommand(opts: {force?: boolean; quiet?: boolean; project?: string; host?: string}): Promise { + // No --host → detected hosts only (spec AC-001); --host all → every channel. + const hosts = !opts.host + ? undefined + : opts.host === 'all' + ? (['claude', 'codex', 'gemini', 'antigravity', 'cursor'] as const).slice() + : [opts.host as 'claude' | 'codex' | 'gemini' | 'antigravity' | 'cursor']; + const result = await runHostSetup({ + force: opts.force, + quiet: opts.quiet, + projectRoot: opts.project, + hosts, + }); process.exit(result.errors.length > 0 ? 1 : 0); } /** * Handler for `clad update`. The one-command "after you upgraded the engine" - * step, run from INSIDE the project you want to reconcile: re-wire hosts + - * reconcile the spec inventory + refresh the managed CLAUDE.md/AGENTS.md section + * step, run from INSIDE the project you want to reconcile: refresh its host + * wiring + reconcile the spec inventory + refresh the managed CLAUDE.md/AGENTS.md section * (all safe + idempotent — see cli/update.ts), THEN run the now-stricter * detectors in REPORT mode. The drift report never blocks and never edits the * user's spec — it only surfaces the bar the upgrade raised, so `clad update` @@ -393,14 +421,14 @@ export async function runSetupCommand(opts: {force?: boolean; quiet?: boolean}): export async function runUpdateCommand(): Promise { pulse('note', 'update', 'reconciling the current project after the engine upgrade'); const r = await runUpdate('.', { - wireHosts: async () => (await runHostSetup({quiet: true})).errors.length, + wireHosts: async () => (await runHostSetup({quiet: true, projectRoot: '.'})).errors.length, }); - pulse(r.wiringErrors > 0 ? 'fail' : 'pass', 'hosts', r.wiringErrors > 0 ? `${r.wiringErrors} wiring error(s)` : 're-wired'); if (!r.isProject) { - pulse('skip', 'spec', 'no spec.yaml here — run `clad init` to put this project under cladding'); + pulse('skip', 'update', 'no spec.yaml here — nothing re-wired. Run `clad update` inside a cladding project, or `clad init` to start one.'); process.exit(r.code); return; } + pulse(r.wiringErrors > 0 ? 'fail' : 'pass', 'hosts', r.wiringErrors > 0 ? `${r.wiringErrors} wiring error(s)` : 're-wired'); if (r.inventoryDeferred) { pulse('note', 'spec', `inventory + index writes deferred — git operation in progress; re-run \`clad update\` after it completes (${r.features} features seen).`); } else { @@ -1010,7 +1038,7 @@ export function runRouteCommand(prompt: string): void { */ export function createProgram(): Command { const program = new Command(); - program.name('clad').description('Reference Ironclad CLI').version('0.8.3'); + program.name('clad').description('Reference Ironclad CLI').version('0.9.0'); program .command('init [intent...]') @@ -1027,6 +1055,7 @@ export function createProgram(): Command { .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 — the authoritative enforcement layer.') + .option('--json', 'emit the raw InitResult for tooling; default is the human-readable surface') .action(runInitCommand); program @@ -1050,14 +1079,16 @@ export function createProgram(): Command { program .command('setup') - .description('Wire cladding into installed AI tool host channels (Claude Code / Codex / Gemini)') - .option('--force', 'overwrite directory-copy wires (Windows fallback) even when changes detected') + .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(runSetupCommand); program .command('update') - .description('Run from a project dir AFTER `npm update -g cladding`: re-wire hosts + sync inventory + refresh the managed CLAUDE.md/AGENTS.md section, then report (without blocking) what the now-stricter detectors flag') + .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(runUpdateCommand); program @@ -1234,7 +1265,7 @@ export function createProgram(): Command { .description('Summarise .cladding/events.log.jsonl — 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/gemini/codex) + Cursor wiring → dated artifact + docs/dogfood/matrix.md. Live LLM prompts run only with consent (CLAD_HOST_SMOKE=1 or --yes); otherwise not-run') + .option('--hosts', 'smoke-test host CLIs (Claude Code / Gemini / Antigravity / Codex / Cursor) and project wiring → 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((opts) => { diff --git a/src/cli/clarify.ts b/src/cli/clarify.ts index 7199616e..71e522c6 100644 --- a/src/cli/clarify.ts +++ b/src/cli/clarify.ts @@ -18,13 +18,15 @@ // The handler never throws — telemetry under `phase: 'onboarding'` // captures every fallback path so `clad doctor` surfaces the gap. -import {existsSync, mkdirSync, readFileSync, writeFileSync} from 'node:fs'; +import {existsSync, mkdirSync, readFileSync, rmSync, writeFileSync} from 'node:fs'; import {basename, dirname, join, resolve} from 'node:path'; import process from 'node:process'; import {selectDispatcher} from './scan/dispatcher.js'; import { appendNewQuestions, + artifactsAreUntouched, + captureArtifactDigests, firstPendingIndex, isComplete, loadState, @@ -41,6 +43,7 @@ import { type RefinementQa, } from './scan/intent-onboarding.js'; import {pulse} from '../ui/pulse.js'; +import type {ScanLlmDispatcher} from './scan/llm.js'; export interface RefineCommandOptions { readonly cwd?: string; @@ -48,6 +51,8 @@ export interface RefineCommandOptions { readonly json?: boolean; /** Force the deterministic interpreter (matches `clad init --no-llm`). */ readonly noLlm?: boolean; + /** Host-produced refinement response; used by the MCP prepare/apply flow. */ + readonly hostDispatcher?: ScanLlmDispatcher; } /** Wire format for `clad clarify --json`. */ @@ -57,77 +62,88 @@ export interface RefineReport { readonly newQuestions: readonly string[]; readonly mode: OnboardingResult['mode'] | null; readonly status: OnboardingState['status']; + readonly nextQuestion: string | null; + readonly remainingQuestions: number; + readonly pendingReview?: readonly string[]; } -/** - * Handler for `clad clarify [answer...]`. The positional argument is - * joined with spaces so users can pass natural-language answers in any - * language without quoting: `clad clarify B2B only (no sole proprietors)`. - * - * Exit codes: - * 0 — answer accepted (or no-op when state is already `status: done`) - * 1 — fatal error (corrupt state file) - * 2 — usage error (no state file present, or no answer provided - * while a pending question exists) - */ -export async function runClarifyCommand( - answerTokens: readonly string[] | undefined, - opts: RefineCommandOptions = {}, -): Promise { +/** Process-independent result used by both the CLI and MCP boundaries. */ +export interface RefineOutcome { + readonly ok: boolean; + readonly code: 0 | 1 | 2; + readonly report?: RefineReport; + readonly error?: string; + readonly message?: string; + readonly source?: OnboardingResult['source']; + readonly created: readonly string[]; + readonly proposals: readonly string[]; +} + +export interface ResolveOnboardingReviewOutcome { + readonly ok: boolean; + readonly changed: boolean; + readonly status?: OnboardingState['status']; + readonly remaining?: readonly string[]; + readonly error?: string; +} + +/** Applies one onboarding answer without writing to stdout or exiting. */ +export async function refineOnboarding( + answer: string, + opts: Omit = {}, +): Promise { const cwd = opts.cwd ?? '.'; let state: OnboardingState | null; try { state = loadState(cwd); } catch (err) { - pulse('fail', 'clarify', (err as Error).message); - process.exit(1); - return; + return {ok: false, code: 1, error: (err as Error).message, created: [], proposals: []}; } if (state === null) { - pulse( - 'fail', - 'clarify', - 'no onboarding session — run `clad init ` first to start the Q&A loop', - ); - process.exit(2); - return; + return { + ok: false, + code: 2, + error: 'no onboarding session — initialize Cladding with a project intent first', + created: [], + proposals: [], + }; } - if (state.status === 'done') { - pulse('note', 'clarify', 'onboarding already complete (state.yaml status: done)'); - if (opts.json) { - process.stdout.write(`${JSON.stringify(buildReport(cwd, null, [], null, state), null, 2)}\n`); - } - process.exit(0); - return; + return { + ok: true, + code: 0, + message: 'onboarding already complete (state.yaml status: done)', + report: buildReport(cwd, null, [], null, state), + created: [], + proposals: [], + }; } const pendingIdx = firstPendingIndex(state); if (pendingIdx === -1) { - // Every existing question is answered but `isComplete` may still be - // false if the LLM was about to emit new questions; mark done. const done = markDone(state); saveState(cwd, done); - pulse('pass', 'clarify', 'onboarding complete · state.yaml marked done'); - if (opts.json) { - process.stdout.write(`${JSON.stringify(buildReport(cwd, null, [], null, done), null, 2)}\n`); - } - process.exit(0); - return; + return { + ok: true, + code: 0, + message: 'onboarding complete · state.yaml marked done', + report: buildReport(cwd, null, [], null, done), + created: [], + proposals: [], + }; } - - const answer = (answerTokens ?? []).join(' ').trim(); - if (answer.length === 0) { - pulse( - 'fail', - 'clarify', - `provide an answer for: "${state.qa[pendingIdx].question}" (usage: \`clad clarify \`)`, - ); - process.exit(2); - return; + if (!answer.trim()) { + return { + ok: false, + code: 2, + error: `provide an answer for: "${state.qa[pendingIdx].question}"`, + created: [], + proposals: [], + }; } - const stateAfterAnswer = markFirstPendingAnswered(state, answer); + const normalizedAnswer = answer.trim(); + const stateAfterAnswer = markFirstPendingAnswered(state, normalizedAnswer); const projectName = stateAfterAnswer.projectName || basename(resolve(cwd)); const observed: OnboardingObserved = { cwdBasename: basename(resolve(cwd)), @@ -141,8 +157,7 @@ export async function runClarifyCommand( const qaHistory: RefinementQa[] = stateAfterAnswer.qa.flatMap((qa) => qa.answer === null ? [] : [{question: qa.question, answer: qa.answer}], ); - - const dispatcher = selectDispatcher({noLlm: opts.noLlm}); + const dispatcher = opts.hostDispatcher ?? selectDispatcher({noLlm: opts.noLlm}); const refined = await interpretRefinementWithFallback( stateAfterAnswer.intent, observed, @@ -152,73 +167,194 @@ export async function runClarifyCommand( cwd, ); - // Write the refined artifacts. The existing `writeArtifact` divert - // pattern is inlined here so `clarify` does not depend on `init.ts`; - // refresh on a populated file lands the new body in - // `.cladding/scan/.proposal` instead of overwriting hand - // edits. const proposals: string[] = []; const created: string[] = []; - writeArtifact(cwd, 'docs/project-context.md', refined.projectContextMd, created, proposals); - writeArtifact(cwd, 'spec/architecture.yaml', refined.architectureYaml, created, proposals); - writeArtifact(cwd, 'spec/capabilities.yaml', refined.capabilitiesYaml, created, proposals); - // v0.3.45 (F-d12edf) — refined scenarios land in spec/scenarios/ - // alongside the other refined artifacts; existing scenario files - // divert to .cladding/scan/.proposal so the planner + - // user can diff before promotion. - for (const scenario of refined.scenarios) { - const hash = scenario.id.replace(/^S-/, ''); - const filename = `spec/scenarios/${scenario.slug}-${hash}.yaml`; - const body = renderScenarioYaml(scenario); - writeArtifact(cwd, filename, body, created, proposals); - } + const applyToActiveDesign = artifactsAreUntouched(cwd, state); + const scenarioPaths = refined.scenarios.map((scenario) => + `spec/scenarios/${scenario.slug}-${scenario.id.replace(/^S-/, '')}.yaml`); + const writePaths = [ + 'docs/project-context.md', 'spec/architecture.yaml', 'spec/capabilities.yaml', + ...scenarioPaths, + '.cladding/onboarding/state.yaml', + ...(!applyToActiveDesign + ? ['project-context.md', 'architecture.yaml', 'capabilities.yaml', ...scenarioPaths.map((path) => basename(path))] + .map((name) => `.cladding/scan/${name}.proposal`) + : []), + ]; + const rollback = captureFiles(cwd, writePaths); + let updated: OnboardingState; + try { + writeArtifact(cwd, 'docs/project-context.md', refined.projectContextMd, created, proposals, applyToActiveDesign); + writeArtifact(cwd, 'spec/architecture.yaml', refined.architectureYaml, created, proposals, applyToActiveDesign); + writeArtifact(cwd, 'spec/capabilities.yaml', refined.capabilitiesYaml, created, proposals, applyToActiveDesign); + refined.scenarios.forEach((scenario, index) => { + writeArtifact(cwd, scenarioPaths[index], renderScenarioYaml(scenario), created, proposals, applyToActiveDesign); + }); - // Persist state: add new questions (de-dup), mark done when no more - // questions and every existing question is answered. - let updated = appendNewQuestions(stateAfterAnswer, refined.clarifyingQuestions); - if (refined.clarifyingQuestions.length === 0 && isComplete(updated)) { - updated = markDone(updated); + updated = appendNewQuestions(stateAfterAnswer, refined.clarifyingQuestions); + if (applyToActiveDesign) { + updated = {...updated, artifactDigests: captureArtifactDigests(cwd)}; + if (refined.clarifyingQuestions.length === 0 && isComplete(updated)) updated = markDone(updated); + } else { + updated = { + ...updated, + status: 'needs_review', + pendingReview: ['docs/project-context.md', 'spec/architecture.yaml', 'spec/capabilities.yaml', ...scenarioPaths], + }; + } + saveState(cwd, updated); + } catch (error) { + restoreFiles(cwd, writePaths, rollback); + return { + ok: false, code: 1, + error: `onboarding refinement failed; active design was restored: ${(error as Error).message}`, + created: [], proposals: [], + }; } - saveState(cwd, updated); - - // Output - if (opts.json) { - const answeredQa = stateAfterAnswer.qa[pendingIdx]; - const report = buildReport( + const answeredQa = stateAfterAnswer.qa[pendingIdx]; + return { + ok: true, + code: 0, + report: buildReport( cwd, - // safe — we just set this entry's answer via markFirstPendingAnswered - {question: answeredQa.question, answer: answer}, + {question: answeredQa.question, answer: normalizedAnswer}, refined.clarifyingQuestions, refined.mode, updated, - ); - process.stdout.write(`${JSON.stringify(report, null, 2)}\n`); + ), + source: refined.source, + created, + proposals, + }; +} + +/** Applies explicitly reviewed proposal bodies and re-enters or completes onboarding. */ +export function resolveOnboardingReview( + targets: readonly string[], + opts: {readonly cwd?: string} = {}, +): ResolveOnboardingReviewOutcome { + const cwd = opts.cwd ?? '.'; + const state = loadState(cwd); + if (!state || state.status !== 'needs_review' || !state.pendingReview?.length) { + return {ok: false, changed: false, error: 'no onboarding design review is pending'}; + } + const requested = [...new Set(targets)]; + if (requested.length === 0 || requested.some((target) => !state.pendingReview!.includes(target))) { + return {ok: false, changed: false, error: 'targets must be selected from the pending onboarding review'}; + } + if (requested.some((target) => !isOnboardingReviewTarget(target))) { + return {ok: false, changed: false, error: 'review targets must be Cladding onboarding design artifacts'}; + } + const pairs = requested.map((target) => ({ + target, + proposal: `.cladding/scan/${basename(target)}.proposal`, + })); + const missing = pairs.filter(({proposal}) => !existsSync(join(cwd, proposal))).map(({target}) => target); + if (missing.length > 0) { + return {ok: false, changed: false, error: `proposal missing for: ${missing.join(', ')}`}; + } + const statePath = '.cladding/onboarding/state.yaml'; + const paths = [statePath, ...pairs.flatMap(({target, proposal}) => [target, proposal])]; + const rollback = captureFiles(cwd, paths); + try { + for (const {target, proposal} of pairs) { + mkdirSync(dirname(join(cwd, target)), {recursive: true}); + writeFileSync(join(cwd, target), readFileSync(join(cwd, proposal))); + rmSync(join(cwd, proposal), {force: true}); + } + const remaining = state.pendingReview.filter((target) => !requested.includes(target)); + let updated: OnboardingState = { + ...state, + status: remaining.length > 0 ? 'needs_review' : firstPendingIndex(state) >= 0 ? 'active' : 'done', + pendingReview: remaining.length > 0 ? remaining : undefined, + }; + updated = {...updated, artifactDigests: captureArtifactDigests(cwd)}; + saveState(cwd, updated); + return {ok: true, changed: true, status: updated.status, remaining}; + } catch (error) { + restoreFiles(cwd, paths, rollback); + return {ok: false, changed: false, error: `review apply failed; files were restored: ${(error as Error).message}`}; + } +} + +function isOnboardingReviewTarget(target: string): boolean { + return target === 'docs/project-context.md' || + target === 'spec/architecture.yaml' || + target === 'spec/capabilities.yaml' || + /^spec\/scenarios\/[a-z0-9][a-z0-9-]*-[a-f0-9]{6}\.yaml$/.test(target); +} + +function captureFiles(cwd: string, relativePaths: readonly string[]): ReadonlyMap { + return new Map(relativePaths.map((relativePath) => { + const path = join(cwd, relativePath); + return [relativePath, existsSync(path) ? readFileSync(path) : null] as const; + })); +} + +function restoreFiles( + cwd: string, + relativePaths: readonly string[], + snapshot: ReadonlyMap, +): void { + for (const relativePath of relativePaths) { + const path = join(cwd, relativePath); + const body = snapshot.get(relativePath); + if (body === null || body === undefined) rmSync(path, {force: true}); + else { + mkdirSync(dirname(path), {recursive: true}); + writeFileSync(path, body); + } + } +} + +/** + * Handler for `clad clarify [answer...]`. The positional argument is + * joined with spaces so users can pass natural-language answers in any + * language without quoting: `clad clarify B2B only (no sole proprietors)`. + * + * Exit codes: + * 0 — answer accepted (or no-op when state is already `status: done`) + * 1 — fatal error (corrupt state file) + * 2 — usage error (no state file present, or no answer provided + * while a pending question exists) + */ +export async function runClarifyCommand( + answerTokens: readonly string[] | undefined, + opts: RefineCommandOptions = {}, +): Promise { + const answer = (answerTokens ?? []).join(' ').trim(); + const outcome = await refineOnboarding(answer, {cwd: opts.cwd, noLlm: opts.noLlm}); + if (!outcome.ok) { + pulse('fail', 'clarify', outcome.error!); + process.exit(outcome.code); + return; + } + if (opts.json) { + process.stdout.write(`${JSON.stringify(outcome.report, null, 2)}\n`); process.exit(0); return; } + if (outcome.message) pulse('note', 'clarify', outcome.message); + if (outcome.source && outcome.report) { + pulse('pass', 'clarify', `answered · mode: ${outcome.report.mode} · source: ${outcome.source}`); + } + for (const c of outcome.created) pulse('pass', `created ${c}`); + for (const p of outcome.proposals) pulse('note', 'proposal', p); - pulse('pass', 'clarify', `answered · mode: ${refined.mode} · source: ${refined.source}`); - for (const c of created) pulse('pass', `created ${c}`); - for (const p of proposals) pulse('note', 'proposal', p); - - if (refined.clarifyingQuestions.length > 0) { + const newQuestions = outcome.report?.newQuestions ?? []; + if (newQuestions.length > 0) { process.stdout.write('\n💡 Next questions:\n'); - for (const [i, q] of refined.clarifyingQuestions.entries()) { + for (const [i, q] of newQuestions.entries()) { process.stdout.write(` ${i + 1}. ${q}\n`); } - const remaining = updated.qa.filter((q) => q.answer === null); - if (remaining.length > 0) { - process.stdout.write(`\n${remaining.length} question(s) left · continue with \`clad clarify \`.\n\n`); + if ((outcome.report?.remainingQuestions ?? 0) > 0) { + process.stdout.write(`\n${outcome.report!.remainingQuestions} question(s) left · continue with \`clad clarify \`.\n\n`); } - } else if (updated.status === 'done') { + } else if (outcome.report?.status === 'done') { process.stdout.write('\n✓ All questions answered — onboarding complete. state.yaml status: done.\n\n'); - } else { - const remaining = updated.qa.filter((q) => q.answer === null); - if (remaining.length > 0) { - process.stdout.write(`\n${remaining.length} question(s) left. continue with \`clad clarify \`.\n\n`); - } + } else if ((outcome.report?.remainingQuestions ?? 0) > 0) { + process.stdout.write(`\n${outcome.report!.remainingQuestions} question(s) left. continue with \`clad clarify \`.\n\n`); } - process.exit(0); } @@ -235,6 +371,9 @@ function buildReport( newQuestions, mode, status: state.status, + nextQuestion: state.qa.find((qa) => qa.answer === null)?.question ?? null, + remainingQuestions: state.qa.filter((qa) => qa.answer === null).length, + pendingReview: state.pendingReview, }; } @@ -258,9 +397,15 @@ function writeArtifact( body: string, created: string[], proposals: string[], + overwriteGenerated = false, ): void { const target = join(cwd, relPath); if (existsSync(target)) { + if (overwriteGenerated) { + writeFileSync(target, body); + created.push(`${relPath} (refined)`); + return; + } const proposal = join(cwd, '.cladding', 'scan', `${basename(relPath)}.proposal`); mkdirSync(dirname(proposal), {recursive: true}); writeFileSync(proposal, body); diff --git a/src/cli/doctor-hosts.ts b/src/cli/doctor-hosts.ts index 2f54bade..b69279b5 100644 --- a/src/cli/doctor-hosts.ts +++ b/src/cli/doctor-hosts.ts @@ -1,13 +1,12 @@ // Cladding · `clad doctor --hosts` — host-support smoke matrix (F-5283985e) // -// Host verification used to be two hand-written dogfood docs pinned to v0.3.x -// (docs/dogfood/{claude-code,gemini-cli}-2026-05-20.md) — five minor versions -// stale, with Codex deferred and Cursor once over-claimed in the README table. +// Host verification used to rely on hand-written dogfood docs that could go +// stale, leave supported hosts deferred, or over-claim a README table row. // This module makes every host-support claim trace to a DATED, machine-produced // smoke artifact instead of prose: // -// • runHostSmoke — probes claude / gemini / codex CLIs (≤3 canned one-shot -// prompts each) and Cursor (wiring-only), recording per-host +// • runHostSmoke — probes claude / gemini / agy / codex / cursor-agent CLIs (≤3 canned +// one-shot prompts each), recording per-host // pass / fail / not-run with the observed sentinel evidence. // • renderHostMatrix — pure renderer → docs/dogfood/matrix.md. // • parseHostOutput — PURE sentinel matcher, split out so committed transcript @@ -17,9 +16,8 @@ // - Absence of evidence renders as `not-run`, NEVER `pass`. A binary that is // not on PATH, or a run without consent, is not-run — not a silent green. // - Live prompts run ONLY with explicit consent (CLAD_HOST_SMOKE=1 or --yes). -// - Cursor has no headless verification surface, so it is graded `wiring-only`: -// we assert only that the MCP wire is written AND `clad serve` answers a -// tools list over stdio — end-to-end behaviour is not headlessly checkable. +// - Cursor's headless Agent CLI is prompt-probed like every other supported +// host; its MCP wiring is additionally checked without spending model tokens. import {spawnSync} from 'node:child_process'; import {existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync} from 'node:fs'; @@ -27,7 +25,7 @@ import {homedir, platform} from 'node:os'; import {join} from 'node:path'; import process from 'node:process'; -import {getCurrentCladdingVersion} from '../init/host-setup.js'; +import {GEMINI_DOCTOR_POLICY_RELATIVE, getCurrentCladdingVersion} from '../init/host-setup.js'; import {loadSpec} from '../spec/load.js'; import {pulse} from '../ui/pulse.js'; @@ -45,7 +43,7 @@ export type SurfaceResultKind = 'pass' | 'fail' | 'not-run'; export type HostGrade = 'verified' | 'fail' | 'not-run' | 'wiring-ok' | 'wiring-fail'; /** The prompt-probed CLI hosts (each has a headless one-shot surface). */ -export const PROMPT_HOSTS = ['claude', 'gemini', 'codex'] as const; +export const PROMPT_HOSTS = ['claude', 'gemini', 'antigravity', 'codex', 'cursor'] as const; export type PromptHost = (typeof PROMPT_HOSTS)[number]; /** Result of matching one surface's output against its sentinel. */ @@ -80,6 +78,7 @@ export interface HostSmokeArtifact { readonly hosts: { readonly claude: HostRecord; readonly gemini: HostRecord; + readonly antigravity: HostRecord; readonly codex: HostRecord; readonly cursor: HostRecord; }; @@ -127,6 +126,15 @@ export function tail(text: string, max = 200): string { * generic feature-id pattern. */ export function parseHostOutput(surface: SurfaceName, text: string, expectedId?: string): SurfaceParse { + const refusal = + /\b(?:MCP|tool|clad_[a-z0-9_]+)(?:\s+tool)?(?:\s+calls?)?[^.\n]{0,80}\b(?:rejected|denied|refused|cancelled|canceled|not approved)\b|\buser cancelle?d MCP tool call\b|\bno tool payload\b|\bdon't have a findings count\b|\bre-approve the cladding MCP tool\b/i; + if (refusal.test(text)) { + return { + result: 'fail', + sentinel: SURFACE_SENTINELS[surface].label, + evidence: tail(text), + }; + } let pattern = SURFACE_SENTINELS[surface].pattern; let label = SURFACE_SENTINELS[surface].label; if (surface === 'get-feature' && expectedId) { @@ -147,8 +155,8 @@ export function parseHostOutput(surface: SurfaceName, text: string, expectedId?: // ──────────────────────────────────────────────────────────────────────────── /** - * The canned prompts, derived from the Gemini dogfood recipes - * (docs/dogfood/gemini-cli-2026-05-20.md), then hardened after the first live + * The canned prompts, derived from the original host dogfood recipes, then + * hardened after the first live * run: an open-ended "list the first 3 features" invited the host to explore * project context instead of calling the tool, grading a healthy host `fail`. * Maximally directive + context-proof: name the exact MCP tool, demand the @@ -163,22 +171,53 @@ export const SURFACE_PROMPTS: Readonly strin }; /** - * How each host CLI runs a single non-interactive prompt: - * - claude → `claude -p "" --output-format text` - * - gemini → `gemini --approval-mode yolo -o text -p ""` (dogfood recipe) - * - codex → `codex exec ""` (Codex's non-interactive one-shot analog) + * How each host CLI runs a single non-interactive prompt. The smoke only ever + * fires behind explicit consent (CLAD_HOST_SMOKE=1 / --yes), which is why the + * non-interactive approval bypasses below are acceptable here and nowhere else: + * a headless probe cannot answer a host's approval prompt, and each probed + * cladding tool is one of the three read-only doctor surfaces. + * - claude → `claude -p "" --output-format text --settings ` + * - gemini → `gemini --skip-trust --approval-mode plan --policy -o text -p ""` + * - antigravity → `agy --dangerously-skip-permissions -p ""` (in the project cwd — agy's + * machine-wide wire resolves the project from the session directory) + * - codex → `codex exec --dangerously-bypass-approvals-and-sandbox ""` + * - cursor → `cursor-agent -p --mode ask --trust --approve-mcps ""` */ export function buildPromptCommand(host: PromptHost, prompt: string): {command: string; args: string[]} { switch (host) { case 'claude': - return {command: 'claude', args: ['-p', prompt, '--output-format', 'text']}; + return {command: 'claude', args: ['-p', prompt, '--output-format', 'text', '--settings', '{"enableAllProjectMcpServers":true}']}; case 'gemini': - return {command: 'gemini', args: ['--approval-mode', 'yolo', '-o', 'text', '-p', prompt]}; + return { + command: 'gemini', + args: [ + '--skip-trust', + '--approval-mode', + 'plan', + '--policy', + GEMINI_DOCTOR_POLICY_RELATIVE, + '--allowed-mcp-server-names', + 'cladding', + '-o', + 'text', + '-p', + prompt, + ], + }; + case 'antigravity': + return {command: 'agy', args: ['--dangerously-skip-permissions', '-p', prompt]}; case 'codex': - return {command: 'codex', args: ['exec', prompt]}; + return {command: 'codex', args: ['exec', '--dangerously-bypass-approvals-and-sandbox', prompt]}; + case 'cursor': + return {command: 'cursor-agent', args: ['-p', '--mode', 'ask', '--trust', '--approve-mcps', prompt]}; } } +/** Executable name corresponding to a public host key. */ +function hostBinary(host: PromptHost): string { + return host === 'antigravity' ? 'agy' : host === 'cursor' ? 'cursor-agent' : host; +} + // ──────────────────────────────────────────────────────────────────────────── // Injectable runners — the seams that keep runHostSmoke unit-testable without // spawning real host CLIs or a real MCP server. @@ -212,7 +251,7 @@ export type ServeProber = (command: string, args: readonly string[], cwd: string export interface HostSmokeOptions { /** Live prompts run only when true (CLAD_HOST_SMOKE=1 or --yes). */ readonly consent?: boolean; - /** Home directory holding ~/.cursor/mcp.json (default os.homedir()). */ + /** Home directory used only for host binary discovery and legacy diagnostics. */ readonly home?: string; /** Clock injection for deterministic artifact timestamps in tests. */ readonly now?: Date; @@ -226,7 +265,13 @@ export interface HostSmokeOptions { readonly probeServe?: ServeProber; } -const PROMPT_TIMEOUT_MS = 60_000; +/** run-check executes the project's full gate inside the host turn — give it + * the room a real repository needs instead of grading slowness as failure. */ +const PROMPT_TIMEOUT_MS: Readonly> = { + 'list-features': 120_000, + 'get-feature': 120_000, + 'run-check': 300_000, +}; const SERVE_TIMEOUT_MS = 10_000; function defaultHasBinary(name: string): boolean { @@ -356,20 +401,20 @@ function probePromptHost( } const prompt = SURFACE_PROMPTS[name](featureId ?? ''); const {command, args} = buildPromptCommand(host, prompt); - const r = runPrompt(command, args, {cwd, timeoutMs: PROMPT_TIMEOUT_MS}); + const r = runPrompt(command, args, {cwd, timeoutMs: PROMPT_TIMEOUT_MS[name]}); if (r.timedOut) { surfaces.push({ name, result: 'fail', sentinel: SURFACE_SENTINELS[name].label, - evidence: tail(`timed out after ${PROMPT_TIMEOUT_MS / 1000}s: ${r.stderr || r.stdout}`), + evidence: tail(`timed out after ${PROMPT_TIMEOUT_MS[name] / 1000}s: ${r.stderr || r.stdout}`), }); continue; } if (r.code !== 0) { // Exit-code gate — a crashed/refused CLI can never pass, no matter what - // its output text accidentally matches (first live run: gemini 0.42.0 - // crashed with exit 1 and the trace still matched a loose sentinel). + // its output text accidentally matches (a live host crash once emitted a + // trace that still matched a loose sentinel). surfaces.push({ name, result: 'fail', @@ -389,31 +434,30 @@ function probePromptHost( } /** - * Cursor wiring-only probe (AC-6cbe51fc). No consent needed — it is free and - * local. Grades: - * - not-run — ~/.cursor absent (Cursor not installed here) OR no cladding - * MCP entry (not wired). Absence of evidence, never a pass. + * Cursor wiring probe (AC-6cbe51fc). No consent needed — it is free and local. + * The prompt probe supplies the overall host grade; this adds structural MCP + * evidence and catches a dead configured server before spending model tokens. + * Wiring grades: + * - not-run — no project-local Cladding MCP entry. Absence of evidence, + * never a pass. * - wiring-fail — cladding IS wired but `clad serve` does not answer tools/list. * - wiring-ok — wired AND `clad serve` answers a tools list over stdio. */ -function probeCursor(home: string, cwd: string, probeServe: ServeProber): HostRecord { - const cursorDir = join(home, '.cursor'); +function probeCursorWiring(_home: string, cwd: string, probeServe: ServeProber): HostRecord { + const cursorDir = join(cwd, '.cursor'); const mcpPath = join(cursorDir, 'mcp.json'); - if (!existsSync(cursorDir)) { - return {grade: 'not-run', surfaces: [], reason: 'Cursor not detected (~/.cursor absent) — run `clad setup` to wire'}; - } if (!existsSync(mcpPath)) { - return {grade: 'not-run', surfaces: [], reason: 'no ~/.cursor/mcp.json — run `clad setup` to wire cladding'}; + return {grade: 'not-run', surfaces: [], reason: 'no project .cursor/mcp.json — run `clad setup` in this project'}; } let entry: {command?: string; args?: unknown} | undefined; try { const parsed = JSON.parse(readFileSync(mcpPath, 'utf8')) as {mcpServers?: Record}; entry = parsed.mcpServers?.cladding as {command?: string; args?: unknown} | undefined; } catch { - return {grade: 'not-run', surfaces: [], reason: '~/.cursor/mcp.json is not valid JSON'}; + return {grade: 'not-run', surfaces: [], reason: 'project .cursor/mcp.json is not valid JSON'}; } if (!entry || typeof entry.command !== 'string') { - return {grade: 'not-run', surfaces: [], reason: 'no cladding MCP entry in ~/.cursor/mcp.json — run `clad setup`'}; + return {grade: 'not-run', surfaces: [], reason: 'no Cladding entry in project .cursor/mcp.json — run `clad setup`'}; } const args = Array.isArray(entry.args) ? (entry.args as string[]) : []; const probe = probeServe(entry.command, args, cwd); @@ -425,13 +469,13 @@ function probeCursor(home: string, cwd: string, probeServe: ServeProber): HostRe }; return probe.ok ? {grade: 'wiring-ok', surfaces: [surface]} - : {grade: 'wiring-fail', surfaces: [surface], reason: 'cladding is wired in ~/.cursor/mcp.json but `clad serve` did not answer tools/list'}; + : {grade: 'wiring-fail', surfaces: [surface], reason: 'Cladding is wired in project .cursor/mcp.json but its launcher did not answer tools/list'}; } /** * Runs the host smoke matrix. Live host-CLI prompts run only with consent; - * absent-binary and no-consent both render `not-run` (never pass). The Cursor - * wiring check is free/local and always runs. + * absent-binary and no-consent both render `not-run` (never pass). Cursor's + * wiring check is free/local and always runs in addition to its headless probe. */ export function runHostSmoke(cwd: string, opts: HostSmokeOptions = {}): HostSmokeArtifact { const consent = opts.consent ?? false; @@ -445,7 +489,7 @@ export function runHostSmoke(cwd: string, opts: HostSmokeOptions = {}): HostSmok const promptRecords = {} as Record; for (const host of PROMPT_HOSTS) { - if (!hasBinary(host)) { + if (!hasBinary(hostBinary(host))) { promptRecords[host] = notRunPromptHost('binary not on PATH'); } else if (!consent) { promptRecords[host] = notRunPromptHost('consent not given (set CLAD_HOST_SMOKE=1)'); @@ -454,14 +498,28 @@ export function runHostSmoke(cwd: string, opts: HostSmokeOptions = {}): HostSmok } } + const cursorPrompt = promptRecords.cursor; + const cursorWiring = probeCursorWiring(home, cwd, probeServe); + const cursor: HostRecord = { + grade: + cursorWiring.grade === 'wiring-fail' + ? 'fail' + : cursorPrompt.grade, + surfaces: [...cursorPrompt.surfaces, ...cursorWiring.surfaces], + ...((cursorPrompt.reason || cursorWiring.reason) + ? {reason: [cursorPrompt.reason, cursorWiring.reason].filter(Boolean).join('; ')} + : {}), + }; + return { version, generatedAt: now.toISOString(), hosts: { claude: promptRecords.claude, gemini: promptRecords.gemini, + antigravity: promptRecords.antigravity, codex: promptRecords.codex, - cursor: probeCursor(home, cwd, probeServe), + cursor, }, }; } @@ -475,6 +533,7 @@ export function matrixGradesFence(artifact: HostSmokeArtifact): string { const grades = { claude: artifact.hosts.claude.grade, gemini: artifact.hosts.gemini.grade, + antigravity: artifact.hosts.antigravity.grade, codex: artifact.hosts.codex.grade, cursor: artifact.hosts.cursor.grade, }; @@ -488,7 +547,7 @@ function surfaceCell(record: HostRecord, name: string): string { /** * Renders docs/dogfood/matrix.md from an artifact — host × surface × result × - * date × cladding version, plus the wiring-only legend and a machine-readable + * date × cladding version, plus the evidence legend and a machine-readable * grades fence for the drift detector. */ export function renderHostMatrix(artifact: HostSmokeArtifact): string { @@ -508,8 +567,12 @@ export function renderHostMatrix(artifact: HostSmokeArtifact): string { `| ${name} | ${surfaceCell(r, 'list-features')} | ${surfaceCell(r, 'get-feature')} | ${surfaceCell(r, 'run-check')} | — | ${r.grade} |`; lines.push(promptRow('claude', hosts.claude)); lines.push(promptRow('gemini', hosts.gemini)); + lines.push(promptRow('antigravity', hosts.antigravity)); lines.push(promptRow('codex', hosts.codex)); - lines.push(`| cursor | — | — | — | ${surfaceCell(hosts.cursor, 'wiring')} | ${hosts.cursor.grade} |`); + lines.push( + `| cursor | ${surfaceCell(hosts.cursor, 'list-features')} | ${surfaceCell(hosts.cursor, 'get-feature')} | ` + + `${surfaceCell(hosts.cursor, 'run-check')} | ${surfaceCell(hosts.cursor, 'wiring')} | ${hosts.cursor.grade} |`, + ); lines.push(''); lines.push('**Legend**'); lines.push(''); @@ -517,8 +580,7 @@ export function renderHostMatrix(artifact: HostSmokeArtifact): string { '- `verified` — every probed surface passed its sentinel end-to-end.', ); lines.push( - '- `wiring-only` (Cursor) — no headless verification surface exists, so the host is graded only on ' + - 'whether the MCP wire is written **and** `clad serve` answers a tools list over stdio (`wiring-ok` / `wiring-fail`).', + '- `wiring` — Cursor additionally verifies that its configured `clad serve` answers a tools list over stdio.', ); lines.push( '- `not-run` — absence of evidence (binary absent from PATH, no live-run consent, or host not wired here). ' + @@ -535,7 +597,7 @@ export function renderHostMatrix(artifact: HostSmokeArtifact): string { lines.push( '> Live grades land when a human runs `clad doctor --hosts` with consent ' + '(`CLAD_HOST_SMOKE=1` or `--yes`). Without consent this baseline records only what is checkable ' + - 'for free — Cursor wiring — and leaves the LLM-driven surfaces `not-run`.', + 'for free — Cursor wiring — and leaves all LLM-driven surfaces `not-run`.', ); lines.push(''); return lines.join('\n'); @@ -596,7 +658,28 @@ export function readNewestArtifact(cwd: string): HostSmokeArtifact | null { .reverse(); for (const f of files) { try { - return JSON.parse(readFileSync(join(dir, f), 'utf8')) as HostSmokeArtifact; + const parsed = JSON.parse(readFileSync(join(dir, f), 'utf8')) as { + version?: unknown; + generatedAt?: unknown; + hosts?: Record; + }; + if (typeof parsed.version !== 'string' || typeof parsed.generatedAt !== 'string' || !parsed.hosts) continue; + const fallback = notRunPromptHost('legacy artifact predates this host probe; run `clad doctor --hosts --yes`'); + const claude = parsed.hosts.claude; + const codex = parsed.hosts.codex; + const cursor = parsed.hosts.cursor; + if (!claude || !codex || !cursor) continue; + return { + version: parsed.version, + generatedAt: parsed.generatedAt, + hosts: { + claude, + gemini: parsed.hosts.gemini ?? fallback, + antigravity: parsed.hosts.antigravity ?? fallback, + codex, + cursor, + }, + }; } catch { continue; } @@ -652,7 +735,10 @@ export function runDoctorHosts(opts: DoctorHostsOptions = {}): void { ? `host smoke complete → ${artifactFile}` : 'no live-run consent — LLM surfaces recorded not-run (set CLAD_HOST_SMOKE=1 to probe)', ); - process.stdout.write(` claude: ${g.claude.grade} gemini: ${g.gemini.grade} codex: ${g.codex.grade} cursor: ${g.cursor.grade}\n`); + process.stdout.write( + ` claude: ${g.claude.grade} gemini: ${g.gemini.grade} antigravity: ${g.antigravity.grade} ` + + `codex: ${g.codex.grade} cursor: ${g.cursor.grade}\n`, + ); process.stdout.write(` artifact: ${artifactFile}\n`); process.stdout.write(` matrix: ${matrixFile}\n`); process.exit(0); diff --git a/src/cli/done.ts b/src/cli/done.ts index 9fae4615..9ea18a65 100644 --- a/src/cli/done.ts +++ b/src/cli/done.ts @@ -66,6 +66,7 @@ interface ShardHit { readonly status: string; /** The feature's declared `modules[]` — forwarded to scope the gate. */ readonly modules: readonly string[]; + readonly designImpactStatus?: string; } /** @@ -85,12 +86,17 @@ export function findShardFile(cwd: string, featureId: string): ShardHit | null { } catch { continue; } - const rec = doc as {id?: unknown; status?: unknown; modules?: unknown}; + const rec = doc as {id?: unknown; status?: unknown; modules?: unknown; design_impact?: {status?: unknown}}; if (rec && rec.id === featureId) { const modules = Array.isArray(rec.modules) ? rec.modules.filter((m): m is string => typeof m === 'string') : []; - return {path, status: typeof rec.status === 'string' ? rec.status : '', modules}; + return { + path, + status: typeof rec.status === 'string' ? rec.status : '', + modules, + designImpactStatus: typeof rec.design_impact?.status === 'string' ? rec.design_impact.status : undefined, + }; } } return null; @@ -143,6 +149,16 @@ export function runDone(cwd: string, featureId: string, deps: DoneDeps): DoneRes ' (inline features: edit spec.yaml then run `clad check --tier=pre-push --strict` manually)', }; } + if (hit.designImpactStatus === 'review_required') { + return { + ok: false, + code: 1, + featureId, + reason: + 'structural design impact still needs review — apply the listed architecture, capability, or project-context changes, ' + + 'then resolve the design impact before marking this feature done.', + }; + } const original = readFileSync(hit.path, 'utf8'); // Flip to done BEFORE gating so the done-aware detectors evaluate this // feature's test evidence (see module header). diff --git a/src/cli/hook.ts b/src/cli/hook.ts index f88af7e0..9cf62490 100644 --- a/src/cli/hook.ts +++ b/src/cli/hook.ts @@ -222,7 +222,7 @@ const INTENT_HINTS: Readonly>> = { run: 'feature cycle: spec entry → implement → tests → clad done', check: 'verify with clad check --strict', sync: 'clad sync validates + heals the spec', - init: 'scaffold with /cladding:init', + init: 'apply Cladding to this project', }; // Completion claims were the WEAKEST measured engagement surface (the 0.6.0 @@ -252,7 +252,8 @@ function classifyPromptSuggestion(input: unknown): {readonly kind: string; reado const intent = suggestIntent(prompt); const hint = intent ? INTENT_HINTS[intent] : undefined; if (!intent || !hint) return null; - return {kind: intent, text: `cladding: this looks like ${intent} work — ${hint}`}; + const workLabel = intent === 'init' ? 'project setup' : `${intent} work`; + return {kind: intent, text: `cladding: this looks like ${workLabel} — ${hint}`}; } // --- PreToolUse — structural guard on spec edits ------------------------ diff --git a/src/cli/host-onboarding.ts b/src/cli/host-onboarding.ts new file mode 100644 index 00000000..dbf3e692 --- /dev/null +++ b/src/cli/host-onboarding.ts @@ -0,0 +1,135 @@ +/** Host-model prepare/apply bridge for onboarding (F-0f4dd6). */ + +import {basename, join, resolve} from 'node:path'; +import {existsSync, readFileSync} from 'node:fs'; + +import yaml from 'yaml'; + +import {detectToolchain} from '../stages/toolchain/detect.js'; +import {scanRoot} from './scan/index.js'; +import {loadState} from './scan/onboarding-state.js'; + +export interface HostOnboardingDraft { + readonly mode: 'greenfield' | 'existing-adoption' | 'mixed'; + readonly project_context: { + readonly why: string; + readonly problem: string; + readonly purpose: string; + }; + readonly capabilities: ReadonlyArray<{ + readonly id: string; + readonly title: string; + readonly summary: string; + readonly surface: 'feature' | 'platform' | 'tool' | 'infrastructure'; + }>; + readonly architecture: { + readonly layers: ReadonlyArray<{readonly name: string; readonly forbidden_imports: readonly string[]}>; + }; + readonly scenarios: ReadonlyArray<{ + readonly slug: string; + readonly title: string; + readonly flow: string; + }>; + readonly questions: readonly string[]; + readonly ai_hints?: Record; +} + +export interface HostPreparation { + readonly prompt: string; + readonly request: {readonly mode: string; readonly intent: string}; + readonly observation: Record; +} + +function compactScan(cwd: string): Record { + const scan = scanRoot({cwd}); + return { + project_name: basename(resolve(cwd)), + language: scan.stats.dominantLanguage === 'unknown' ? detectToolchain(cwd) : scan.stats.dominantLanguage, + source_file_count: scan.stats.filesScanned, + readme_first_paragraph: scan.projectContext?.readmeFirstParagraph ?? null, + readme_headings: (scan.projectContext?.readmeHeadings ?? []).slice(0, 10), + layers: scan.architecture.layers.slice(0, 12).map((layer) => ({name: layer.name, modules: layer.moduleCount})), + import_edges: scan.architecture.importGraph.slice(0, 12), + conventions: scan.conventions, + public_signatures: scan.examples.slice(0, 6).map((example) => ({ + layer: example.layer, + module: example.modulePath, + signature: example.moduleContent.split('\n').filter((line) => /\b(export|class|interface|function)\b/.test(line)).slice(0, 3), + })), + }; +} + +/** Builds a bounded, read-only briefing for the current host model. */ +export function prepareHostInit(cwd: string, mode: string, intent: string): HostPreparation { + const observation = compactScan(cwd); + const prompt = [ + 'Draft Cladding onboarding data from the user request and observations below.', + 'Return one object matching the supplied MCP draft schema; do not edit files or run shell commands.', + 'Use the user language. Infer useful domain practices, but keep questions at product/business level.', + 'Produce 3-8 capabilities and 1-3 user-journey scenarios.', + 'Ask 0-3 product questions only for material decisions that the intent and observations do not already resolve.', + 'A complete planning document must produce zero questions; record deferrable uncertainty in the draft instead of blocking development.', + 'Architecture layers must be lean and use kebab-case capability/scenario identifiers.', + '', + `Starting mode: ${mode}`, + 'User intent:', + intent, + '', + 'Observed project:', + JSON.stringify(observation, null, 2), + ].join('\n'); + return {prompt, request: {mode, intent}, observation}; +} + +/** Builds a read-only refinement briefing without consuming the answer. */ +export function prepareHostClarify(cwd: string, answer: string): HostPreparation | {readonly error: string} { + const state = loadState(cwd); + if (!state) return {error: 'no onboarding session'}; + const pending = state.qa.find((qa) => qa.answer === null); + if (!pending) return {error: 'onboarding is already complete'}; + const current = { + project_context: readOptional(join(cwd, 'docs/project-context.md')), + capabilities: readOptional(join(cwd, 'spec/capabilities.yaml')), + architecture: readOptional(join(cwd, 'spec/architecture.yaml')), + }; + const observation = {state, current}; + const prompt = [ + 'Refine the Cladding onboarding draft using the user answer below.', + 'Return one object matching the supplied MCP draft schema; preserve decisions that the answer does not change.', + 'Do not edit files or run shell commands. Ask 0-3 new product-level questions only when needed.', + '', + `Pending question: ${pending.question}`, + `User answer (verbatim): ${answer}`, + '', + 'Current onboarding state and artifacts:', + JSON.stringify(observation, null, 2), + ].join('\n'); + return {prompt, request: {mode: state.mode, intent: state.intent}, observation}; +} + +function readOptional(path: string): string { + return existsSync(path) ? readFileSync(path, 'utf8') : ''; +} + +/** Converts validated host data into the existing sentinel interpreter input. */ +export function renderHostDraft(draft: HostOnboardingDraft): string { + const context = [ + '## 1. Why does this project exist?', '', draft.project_context.why, + '', '## 2. What problem does it solve?', '', draft.project_context.problem, + '', '## 3. What is its purpose?', '', draft.project_context.purpose, + ].join('\n'); + const capabilities = yaml.stringify({schema: '0.1', source: 'intent', capabilities: draft.capabilities}, {lineWidth: 0}).trim(); + const architecture = yaml.stringify({layers: draft.architecture.layers}, {lineWidth: 0}).trim(); + const scenarios = yaml.stringify(draft.scenarios.map((scenario) => ({...scenario, features: []})), {lineWidth: 0}).trim(); + const metadata = draft.ai_hints ? yaml.stringify(draft.ai_hints, {lineWidth: 0}).trim() : ''; + return [ + '=== ONBOARDING_MODE ===', draft.mode, + '=== PROJECT_CONTEXT_MD ===', context, + '=== CAPABILITIES_YAML ===', capabilities, + '=== ARCHITECTURE_YAML ===', architecture, + '=== SPEC_SEED_TITLE ===', draft.project_context.purpose, + '=== SCENARIOS_YAML ===', scenarios, + '=== PROJECT_METADATA ===', metadata, + '=== CLARIFYING_QUESTIONS ===', ...draft.questions.map((question) => `- ${question}`), + ].join('\n'); +} diff --git a/src/cli/init.ts b/src/cli/init.ts index f2bb3873..c6875eed 100644 --- a/src/cli/init.ts +++ b/src/cli/init.ts @@ -32,9 +32,9 @@ import { type OnboardingObserved, type OnboardingResult, } from './scan/intent-onboarding.js'; -import {saveState, type OnboardingState} from './scan/onboarding-state.js'; +import type {ScanLlmDispatcher} from './scan/llm.js'; +import {captureArtifactDigests, loadState, saveState, type OnboardingState} from './scan/onboarding-state.js'; import {detectToolchain} from '../stages/toolchain/detect.js'; -import {writeClaudeMdSection} from '../init/host-instructions.js'; import {writeSpecDrivenAgentsMd} from '../init/agents-md.js'; import {getCurrentCladdingVersion, getLastSetupVersion} from '../init/host-setup.js'; import {installGitHook} from '../init/git-hook.js'; @@ -67,6 +67,8 @@ export interface InitOptions { readonly withHook?: boolean; /** Scaffold the authoritative CI gate workflow (F-16746b). */ readonly withCi?: boolean; + /** Host-produced onboarding response; used by the MCP prepare/apply flow. */ + readonly hostDispatcher?: ScanLlmDispatcher; } export interface InitResult { @@ -83,6 +85,8 @@ export interface InitResult { readonly clarifyingQuestions?: readonly string[]; /** Mode the onboarding pass classified the project as (intent path only). */ readonly onboardingMode?: OnboardingResult['mode']; + /** Reports whether intent onboarding used the host LLM or a fallback. */ + readonly onboardingSource?: OnboardingResult['source']; } // v0.3.30 — Scenarios in cladding capture *user journeys* (business @@ -196,6 +200,7 @@ function specSeed( const projectLines = [ ` name: ${projectName}`, ` language: ${language}`, + ' onboarding_seeded: true', ]; if (metadata?.description) { projectLines.push(` description: ${quoted(metadata.description)}`); @@ -304,10 +309,10 @@ export function scaffoldCiWorkflow(cwd: string): 'created' | 'exists' { * Returns null when the wire state matches the running binary (no notice). */ export function hostWireNotice(lastSetup: string | null, pkgVersion: string | null): string | null { if (lastSetup == null) { - return 'host channels not wired yet — run `clad setup` to enable `/cladding init` from Claude Code / Codex / Gemini'; + return 'host channels not wired yet — run `clad setup`, restart your AI tool, then ask it to apply Cladding to this project'; } if (pkgVersion && lastSetup !== pkgVersion) { - return `host wire was set up at v${lastSetup} (current binary v${pkgVersion}) — symlinks usually auto-follow, but run \`clad setup\` to be sure`; + return `this project's host wiring was set up at v${lastSetup} (current binary v${pkgVersion}) — run \`clad setup\` in this project to refresh its local runtime`; } return null; } @@ -376,7 +381,7 @@ export async function runInit(opts: InitOptions = {}): Promise { // dispatcher both fall back to a deterministic variant that quotes // the intent verbatim. let onboarding: OnboardingResult | null = null; - const dispatcher = selectDispatcher({noLlm: opts.noLlm}); + const dispatcher = opts.hostDispatcher ?? selectDispatcher({noLlm: opts.noLlm}); if (intent && intent.length > 0) { const observed: OnboardingObserved = { cwdBasename: basename(resolve(cwd)), @@ -585,13 +590,9 @@ export async function runInit(opts: InitOptions = {}): Promise { } } - // F-90d054 — project-local host AI instruction surfaces. - // AGENTS.md is the cross-tool entry point (Codex · Cursor · Continue · - // Copilot · Aider). CLAUDE.md is Claude Code's project memory — appended - // idempotently so existing user content is preserved. v0.4.0 — when the - // existing file carries v0.3.x markers (e.g. `_meta.enrichment_status`, - // lone `clad_create_feature MCP tool`), it is refreshed in place so AI - // sessions don't see stale guidance. + // F-90d054 — AGENTS.md is the single cross-host instruction surface. + // Existing CLAUDE.md files belong to the user and are never created or + // changed by onboarding; Claude Code reads AGENTS.md as well. // F-a4085adf (#199) — the adopter's AGENTS.md is now spec-driven: its managed // block is rendered from spec.yaml (test framework, branch, forbidden/preferred // patterns, preferred persona) + the cross-host persona→capability map, instead @@ -608,22 +609,11 @@ export async function runInit(opts: InitOptions = {}): Promise { } else { skipped.push('AGENTS.md (managed block already current)'); } - const claudeResult = writeClaudeMdSection(cwd, {force}); - if (claudeResult === 'created') { - created.push('CLAUDE.md'); - } else if (claudeResult === 'appended') { - created.push('CLAUDE.md (## cladding section appended)'); - } else if (claudeResult === 'refreshed-stale') { - created.push('CLAUDE.md (## cladding section refreshed — v0.3.x guidance replaced)'); - } else { - skipped.push('CLAUDE.md (## cladding section already present)'); - } - // F-80d19d — friendly warning when host channels were never wired or are // out of sync with the current cladding binary. `clad setup` is the explicit // command for wiring; this is informational only and does not block init. const pkgVersion = getCurrentCladdingVersion(); - const wireNotice = hostWireNotice(getLastSetupVersion(), pkgVersion); + const wireNotice = hostWireNotice(getLastSetupVersion(cwd), pkgVersion); if (wireNotice) skipped.push(wireNotice); // Phase 2 (opt-in) — ambient enforcement via a git pre-commit hook. Off @@ -667,6 +657,14 @@ export async function runInit(opts: InitOptions = {}): Promise { } } + // The Q&A loop may overwrite only byte-identical Cladding-generated design. + // Capture after every initial artifact has landed so later user edits are + // diverted for review rather than silently replaced. + if (onboarding) { + const state = loadState(cwd); + if (state) saveState(cwd, {...state, artifactDigests: captureArtifactDigests(cwd)}); + } + return { created, skipped, @@ -674,6 +672,7 @@ export async function runInit(opts: InitOptions = {}): Promise { proposals: proposals.length ? proposals : undefined, clarifyingQuestions: onboarding?.clarifyingQuestions.length ? [...onboarding.clarifyingQuestions] : undefined, onboardingMode: onboarding?.mode, + onboardingSource: onboarding?.source, }; } diff --git a/src/cli/scan/intent-onboarding.ts b/src/cli/scan/intent-onboarding.ts index 2b7fd253..1d654aa5 100644 --- a/src/cli/scan/intent-onboarding.ts +++ b/src/cli/scan/intent-onboarding.ts @@ -105,7 +105,7 @@ export interface OnboardingResult { readonly architectureYaml: string; /** Suggested title for the placeholder F-001 in `spec.yaml`. */ readonly specSeedTitle: string; - /** 2-3 product/business-level questions the orchestrator can ask next. */ + /** 0-3 unresolved product/business-level questions the orchestrator can ask next. */ readonly clarifyingQuestions: readonly string[]; /** * 1-3 user-journey scenarios extracted by the LLM from the intent @@ -263,9 +263,10 @@ export function buildOnboardingPrompt( '- Leave the block EMPTY (no keys) if the intent is too vague to infer anything useful.', '', '=== CLARIFYING_QUESTIONS ===', - '2-3 PRODUCT/BUSINESS-level questions to ask the user next, one per', + '0-3 PRODUCT/BUSINESS-level questions to ask the user next, one per', 'line. RULES (mandatory):', - '- Ask GOAL / AUDIENCE / SCOPE questions, not implementation choices.', + '- Ask only about material GOAL / AUDIENCE / SCOPE gaps, not implementation choices.', + '- If the supplied intent already resolves the important decisions, emit no questions.', '- Match vocabulary to what the user used in their intent.', ' - Casual intent ("결제 SaaS", "쇼핑몰") → plain-language questions.', ' - Technical intent ("PCI-DSS gateway") → deeper questions OK.', diff --git a/src/cli/scan/onboarding-state.ts b/src/cli/scan/onboarding-state.ts index dfa768ca..95837642 100644 --- a/src/cli/scan/onboarding-state.ts +++ b/src/cli/scan/onboarding-state.ts @@ -13,7 +13,8 @@ // during the onboarding window; once `qa[].every(answered)` AND no new // questions emerge, the file is marked `status: done` (kept as audit). -import {existsSync, mkdirSync, readFileSync, writeFileSync} from 'node:fs'; +import {createHash} from 'node:crypto'; +import {existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync} from 'node:fs'; import {dirname, join} from 'node:path'; import yaml from 'yaml'; @@ -46,9 +47,13 @@ export interface OnboardingState { * LLM emits no further questions AND every existing question has an * answer. The file stays on disk after `done` as an audit log. */ - readonly status: 'active' | 'done'; + readonly status: 'active' | 'needs_review' | 'done'; /** Q-A history in arrival order; `answer: null` entries are still pending. */ readonly qa: readonly OnboardingQa[]; + /** Digests of the generated design last accepted into the active SSoT. */ + readonly artifactDigests?: Readonly>; + /** Authored targets whose generated refinements await explicit review. */ + readonly pendingReview?: readonly string[]; } function statePath(cwd: string): string { @@ -73,7 +78,7 @@ export function loadState(cwd: string): OnboardingState | null { ? (parsed.mode as OnboardingState['mode']) : 'greenfield', startedAt: String(parsed.startedAt ?? new Date().toISOString()), - status: parsed.status === 'done' ? 'done' : 'active', + status: parsed.status === 'done' ? 'done' : parsed.status === 'needs_review' ? 'needs_review' : 'active', qa: Array.isArray(parsed.qa) ? parsed.qa.map((entry) => ({ question: String((entry as OnboardingQa)?.question ?? ''), @@ -84,6 +89,11 @@ export function loadState(cwd: string): OnboardingState | null { : String((entry as OnboardingQa).answer), })) : [], + artifactDigests: + parsed.artifactDigests && typeof parsed.artifactDigests === 'object' + ? Object.fromEntries(Object.entries(parsed.artifactDigests).map(([path, digest]) => [path, String(digest)])) + : undefined, + pendingReview: Array.isArray(parsed.pendingReview) ? parsed.pendingReview.map(String) : undefined, }; } @@ -156,3 +166,33 @@ export function isComplete(state: OnboardingState): boolean { export function markDone(state: OnboardingState): OnboardingState { return {...state, status: 'done'}; } + +/** Tier-A/B artifacts whose accepted contents must include every onboarding answer. */ +export const ONBOARDING_DESIGN_ARTIFACTS = [ + 'docs/project-context.md', + 'spec/architecture.yaml', + 'spec/capabilities.yaml', +] as const; + +/** Captures byte digests used to distinguish untouched generated design from user edits. */ +export function captureArtifactDigests(cwd: string): Readonly> { + const scenarioDir = join(cwd, 'spec', 'scenarios'); + const scenarios = existsSync(scenarioDir) + ? readdirSync(scenarioDir) + .filter((name) => name.endsWith('.yaml')) + .map((name) => `spec/scenarios/${name}`) + : []; + return Object.fromEntries([...ONBOARDING_DESIGN_ARTIFACTS, ...scenarios].flatMap((relativePath) => { + const path = join(cwd, relativePath); + if (!existsSync(path)) return []; + return [[relativePath, createHash('sha256').update(readFileSync(path)).digest('hex')]]; + })); +} + +/** True only when every previously accepted design artifact is still byte-identical. */ +export function artifactsAreUntouched(cwd: string, state: OnboardingState): boolean { + const expected = state.artifactDigests; + if (!expected || Object.keys(expected).length === 0) return false; + const current = captureArtifactDigests(cwd); + return Object.entries(expected).every(([path, digest]) => current[path] === digest); +} diff --git a/src/cli/update.ts b/src/cli/update.ts index c621f4a5..51eb9d62 100644 --- a/src/cli/update.ts +++ b/src/cli/update.ts @@ -38,9 +38,10 @@ import {computeInventory, writeInventoryToSpecYaml, writeFeatureIndex} from '../ import {gitOperationInProgress} from '../core/git-ops.js'; /** - * Injected so `runUpdate` is unit-testable without touching the global home - * dir. The drift REPORT is deliberately NOT here — it is report-only and lives - * in the command wrapper, so `runUpdate` only ever does safe mutations. + * Injected so `runUpdate` is unit-testable without running the real host + * wiring (project-local since 0.9.0). The drift REPORT is deliberately NOT + * here — it is report-only and lives in the command wrapper, so `runUpdate` + * only ever does safe mutations. */ export interface UpdateDeps { /** Re-wire host channels (wraps `runHostSetup`); resolves to the wiring-error count. */ @@ -48,7 +49,7 @@ export interface UpdateDeps { } export interface UpdateResult { - /** False when `cwd` has no spec.yaml — only the global re-wire ran. */ + /** False when `cwd` has no spec.yaml — only the host re-wire ran. */ readonly isProject: boolean; /** Count of host channels that failed to wire (0 = clean). */ readonly wiringErrors: number; @@ -93,21 +94,25 @@ function mapAgentsMdResult(r: SpecAgentsMdResult): AgentsMdResult { * stricter-detector REPORT is the caller's job (report-only, never blocks). */ export async function runUpdate(cwd: string, deps: UpdateDeps): Promise { - // 1. Re-wire hosts (global, idempotent) — useful even outside a project. - const wiringErrors = await deps.wireHosts(); - + // 0. Outside a cladding project, write NOTHING: no host wiring into an + // arbitrary cwd, and no legacy-cleanup side effects (which include an + // account-wide `claude plugin uninstall`). Wiring belongs to projects. if (!existsSync(join(cwd, 'spec.yaml'))) { return { isProject: false, - wiringErrors, + wiringErrors: 0, claudeMd: 'n/a', agentsMd: 'n/a', features: 0, - code: wiringErrors > 0 ? 1 : 0, + code: 0, deprecations: [], }; } + // 1. Re-wire host channels into the project (idempotent, project-local + // since 0.9.0). + const wiringErrors = await deps.wireHosts(); + // 2. Reconcile the spec.yaml inventory snapshot (deterministic). Skip the // writes (keep the read-only count for the report) while a git operation // is in progress, so a merge/rebase sees no surprise derived-file edits. @@ -118,14 +123,17 @@ export async function runUpdate(cwd: string, deps: UpdateDeps): Promise-.yaml` —', ' 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).', - '- Run `clad check --strict` to verify spec ↔ code across every drift detector.', + '- 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 ↔ code', + ' across every drift detector.', renderDocPointers(cwd).replace(/\n$/, ''), '', '## Feature cycle — one at a time', '', 'Finish ONE feature end-to-end before the next: author its shard (`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). Do not', + '+ `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`.', + '', + '## 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.', renderConventions(spec).replace(/\n$/, ''), '', '## Personas — cross-host capability map (anti-self-cert)', diff --git a/src/init/host-instructions.ts b/src/init/host-instructions.ts index d5f85efc..ddda2c65 100644 --- a/src/init/host-instructions.ts +++ b/src/init/host-instructions.ts @@ -1,66 +1,19 @@ // F-90d054 — project-local host AI instruction writers. // // Writes: -// • /AGENTS.md — cross-tool (Codex/Cursor/Continue/Copilot/Aider) // • /CLAUDE.md — Claude Code memory (idempotent append) // -// Does NOT write `.claude-plugin/plugin.json`, `.mcp.json`, or -// `.codex/config.toml` to the project — those live globally under the user's -// home directory and are populated by the npm postinstall hook (and the -// `clad init` fallback retry for users who ran with `--ignore-scripts`). +// AGENTS.md is NOT written here anymore: the spec-driven managed block +// (src/init/agents-md.ts, F-a4085adf) replaced the old static template, and a +// markerless file is treated as user-owned and never rewritten. +// +// Does NOT write `.mcp.json`, `.codex/config.toml`, or the other host MCP +// wiring files — those are project-local since 0.9.0 and are written by +// `clad setup` (src/init/host-setup.ts), never at npm install time. import { existsSync, readFileSync, writeFileSync } from 'node:fs'; import { join } from 'node:path'; -export const AGENTS_MD_TEMPLATE = `# AGENTS.md - -This project is managed by **cladding** — the Spec-Anchored Agent Harness. - -## Single Source of Truth - -- \`spec.yaml\` is the authoritative spec (Tier A). Code must conform. -- \`spec/features/-.yaml\` holds individual feature shards. - Never hand-author \`F-NNN\` filenames — ask cladding via the \`clad\` - CLI (or, when your host has cladding wired as an MCP server, - \`clad_create_feature\`). -- \`docs/project-context.md\` is the Tier B design SSoT. -- Run \`clad check --strict\` to verify spec ↔ code drift across every - drift detector. - -## Feature cycle — one at a time - -Work ONE feature end-to-end before starting the next: author its shard -**with** \`acceptance_criteria\` (+ \`modules\`) → implement → author its -tests in a separate context → mark it done with \`clad done \` -(it sets \`status: done\` ONLY when \`clad check --tier=pre-push --strict\` -is GREEN, reverting otherwise) → only then the next feature. Do NOT author -feature shards ahead of the code, and do NOT hand-write \`status: done\`. -Independent features (no shared \`modules\`) may run as parallel instances -of this same cycle. Enforced by the \`PLANNED_BACKLOG\` detector; rationale -in \`docs/feature-cycle.md\`. - -## Persona separation (anti-self-cert) - -The agent that writes a unit of work must not be the agent that signs off -on it. planner writes spec, reviewer audits, developer implements. - -## Speak the user's language - -When you report progress to the user, translate cladding's vocabulary into -plain words in the user's own language — a shard is a spec entry, an -attestation is a signed sign-off, a detector finding is what drifted and why -it matters. This includes cladding's own gate and hook messages: relay them in -the user's language, by meaning, rather than echoing the raw text. Never lead -with an internal id (\`F-…\`, \`AC-…\`, \`stage_X.Y\`): name the feature and the -plain outcome instead. - -## More - -See \`CLAUDE.md\` for Claude Code-specific memory, and -\`spec/architecture.yaml\` for the layer / \`forbidden_imports\` invariants -enforced by \`ARCHITECTURE_FROM_SPEC\`. -`; - export const CLAUDE_MD_SECTION_MARKER = '## cladding'; export const CLAUDE_MD_SECTION = `## cladding @@ -134,28 +87,6 @@ export type ClaudeMdResult = | 'unchanged' | 'refreshed-stale'; -export function writeAgentsMd( - targetDir: string, - opts: { readonly force?: boolean } = {}, -): AgentsMdResult { - const path = join(targetDir, 'AGENTS.md'); - const existed = existsSync(path); - if (!existed) { - writeFileSync(path, AGENTS_MD_TEMPLATE); - return 'created'; - } - if (opts.force) { - writeFileSync(path, AGENTS_MD_TEMPLATE); - return 'overwritten'; - } - const existing = readFileSync(path, 'utf8'); - if (isStaleInstructions(existing)) { - writeFileSync(path, AGENTS_MD_TEMPLATE); - return 'refreshed-stale'; - } - return 'skipped-exists'; -} - export function writeClaudeMdSection( targetDir: string, opts: { readonly force?: boolean } = {}, diff --git a/src/init/host-setup.ts b/src/init/host-setup.ts index d043f1ba..dfe87fe7 100644 --- a/src/init/host-setup.ts +++ b/src/init/host-setup.ts @@ -1,37 +1,23 @@ -// F-80d19d host setup — explicit `clad setup` command (replaces F-90d054 postinstall). +// F-80d19d / F-0f4dd6 — explicit, project-scoped host setup. // -// Wires up to four host AI auto-discovery channels, one symlink per channel: -// 1. ~/.claude/plugins/cladding → cladding pkg root -// 2. ~/.gemini/extensions/cladding → cladding/plugins/gemini-cli -// 3. ~/.agents/skills/cladding- → cladding/plugins/codex/skills/ -// 4. ~/.codex/config.toml → [mcp_servers.cladding] table merge -// -// One command handles six scenarios: -// - first wire — symlink absent → create -// - update — symlink target differs from current cladding root → re-wire -// - delta host — host AI newly installed since last setup → add wire -// - repair — symlink missing → create (same as first wire) -// - no-op — symlink target matches → skip -// - conflict — directory copy with manual changes → warn, --force required -// -// Detection — host AI is "installed" iff its home directory exists (~/.claude/, ~/.gemini/, -// ~/.agents/, ~/.codex/). Undetected hosts are skipped (no directories created). +// Installing the CLI globally must not make Cladding visible to every AI +// session on the machine. `clad setup` therefore writes only project-local +// discovery files. A small ignored launcher carries the machine-specific +// package path; the checked-in host configs remain portable. import { cpSync, existsSync, lstatSync, mkdirSync, - readdirSync, readFileSync, readlinkSync, + readdirSync, rmSync, - statSync, - symlinkSync, writeFileSync, } from 'node:fs'; import {homedir, platform} from 'node:os'; -import {dirname, join, resolve} from 'node:path'; +import {basename, dirname, isAbsolute, join, relative, resolve} from 'node:path'; import {fileURLToPath} from 'node:url'; import {spawnSync} from 'node:child_process'; @@ -39,26 +25,44 @@ export type ChannelResult = | 'created' | 'unchanged' | 'rewired' - | 'copied' + | 'removed' | 'skipped-different' - | 'skipped-not-installed' + | 'skipped-not-selected' + | 'manual-required' | 'failed'; -export interface CodexSkillResult { - readonly verb: string; - readonly result: ChannelResult; - readonly message?: string; +export type SetupHost = 'claude' | 'codex' | 'gemini' | 'antigravity' | 'cursor'; + +export interface HostDetection { + readonly claude: boolean; + readonly gemini: boolean; + readonly antigravity: boolean; + readonly codex: boolean; + readonly agents: boolean; + readonly cursor: boolean; } export interface SetupResult { + readonly projectRoot: string; readonly wiring: { + readonly runtime: ChannelResult; + readonly shared_init_skill: ChannelResult; + readonly claude: ChannelResult; + readonly codex: ChannelResult; + readonly gemini: ChannelResult; + readonly antigravity: ChannelResult; + readonly cursor: ChannelResult; + }; + readonly legacyCleanup: { readonly claude_plugin: ChannelResult; readonly gemini_extension: ChannelResult; - readonly codex_skills: ReadonlyArray; + readonly antigravity_plugin: ChannelResult; + readonly codex_skills: ChannelResult; readonly codex_mcp: ChannelResult; readonly cursor_mcp: ChannelResult; }; readonly errors: ReadonlyArray<{step: string; message: string}>; + readonly warnings: ReadonlyArray<{step: string; message: string}>; readonly statusFile: string; readonly cladding_root: string; readonly cladding_version: string; @@ -70,619 +74,674 @@ export interface SetupOptions { readonly quiet?: boolean; readonly home?: string; readonly pkgRoot?: string; + readonly projectRoot?: string; readonly version?: string; - /** Run host CLI activation commands after wiring (default true). Tests must - * pass false: activation invokes the REAL `claude`/`gemini` binaries, which - * mutate the developer's actual host config — not the mocked home. */ + readonly hosts?: readonly SetupHost[]; + /** Host CLI cleanup is disabled by tests so no developer configuration is touched. */ readonly activate?: boolean; - /** Injectable activation runners so AC-012 is testable without spawning - * real host CLIs. Defaults to the real claude/gemini activators. */ - readonly activators?: { - readonly claude?: (pluginPath: string) => ActivationResult; - readonly gemini?: (extensionPath: string) => ActivationResult; - }; -} - -export interface HostDetection { - readonly claude: boolean; - readonly gemini: boolean; - readonly codex: boolean; - readonly agents: boolean; - readonly cursor: boolean; } interface SetupStatus { - cladding_root: string; - cladding_version: string; - last_run: string; - wiring: SetupResult['wiring']; - errors: SetupResult['errors']; + readonly project_root: string; + readonly cladding_root: string; + readonly cladding_version: string; + readonly last_run: string; } const STATUS_FILENAME = 'setup-status.json'; - -function detectHosts(home: string): HostDetection { - return { - claude: existsSync(join(home, '.claude')), - gemini: existsSync(join(home, '.gemini')), - codex: existsSync(join(home, '.codex')), - agents: existsSync(join(home, '.agents')), - cursor: existsSync(join(home, '.cursor')), - }; -} - -function ensureDir(p: string): void { - mkdirSync(p, {recursive: true}); -} - -function resolveSymlink(linkPath: string): string | null { +const RUNTIME_RELATIVE = join('.cladding', 'host', 'serve.cjs'); +/** + * Project-local Gemini policy used only by the explicitly consented read-only host smoke. + * + * @see spec/features/host-smoke-matrix-5283985e.yaml AC-4a71e2 + */ +export const GEMINI_DOCTOR_POLICY_RELATIVE = '.cladding/host/gemini-doctor-policy.toml'; +const ALL_HOSTS: readonly SetupHost[] = ['claude', 'codex', 'gemini', 'antigravity', 'cursor']; +const CURSOR_READONLY_MCP_PERMISSIONS = [ + 'Mcp(cladding:clad_list_features)', + 'Mcp(cladding:clad_get_feature)', + 'Mcp(cladding:clad_run_check)', +] as const; + +function ensureDir(path: string): void { + mkdirSync(path, {recursive: true}); +} + +function readText(path: string): string | null { try { - const target = readlinkSync(linkPath); - return resolve(dirname(linkPath), target); + return readFileSync(path, 'utf8'); } catch { return null; } } -function isSymlink(linkPath: string): boolean { +function writeIfChanged(path: string, body: string): ChannelResult { + const previous = readText(path); + if (previous === body) return 'unchanged'; + ensureDir(dirname(path)); + writeFileSync(path, body, 'utf8'); + return previous == null ? 'created' : 'rewired'; +} + +function isSymlink(path: string): boolean { try { - const stat = lstatSync(linkPath); - return stat.isSymbolicLink(); + return lstatSync(path).isSymbolicLink(); } catch { return false; } } -/** Like existsSync but also returns true for dangling symlinks (existsSync follows targets). */ -function pathExists(linkPath: string): boolean { +function resolvedSymlink(path: string): string | null { try { - lstatSync(linkPath); - return true; + return resolve(dirname(path), readlinkSync(path)); } catch { - return false; + return null; } } -function wireChannel(target: string, link: string, opts: {force: boolean; isWin: boolean}): ChannelResult { - if (pathExists(link)) { - if (isSymlink(link)) { - const existing = resolveSymlink(link); - if (existing === target) return 'unchanged'; - // Symlink with different target → re-wire (safe, no user data loss) - try { - rmSync(link); - } catch { - return 'failed'; - } - // fall through to create - } else { - // Directory copy or other — could contain user customizations - if (!opts.force) return 'skipped-different'; - try { - rmSync(link, {recursive: true, force: true}); - } catch { - return 'failed'; - } - } - } - ensureDir(dirname(link)); - try { - symlinkSync(target, link, opts.isWin ? 'junction' : 'dir'); - return existsSync(link) ? (isSymlink(link) ? 'created' : 'created') : 'failed'; - } catch (e: unknown) { - const err = e as NodeJS.ErrnoException; - if (opts.isWin && (err.code === 'EPERM' || err.code === 'EACCES')) { - try { - cpSync(target, link, {recursive: true, dereference: true}); - return 'copied'; - } catch { - return 'failed'; - } - } - return 'failed'; - } +function pathInside(path: string, root: string): boolean { + const delta = relative(resolve(root), resolve(path)); + return delta === '' || (!delta.startsWith('..') && !isAbsolute(delta)); } -function wireClaude(home: string, pkgRoot: string, opts: {force: boolean; isWin: boolean}): ChannelResult { - return wireChannel(pkgRoot, join(home, '.claude', 'plugins', 'cladding'), opts); -} - -// Gemini stays npm-delegated (needs the PATH-global `clad`): its extension -// manifest (plugins/gemini-cli/gemini-extension.json) declares `command: "clad"` -// and is wired by SYMLINK into ~/.gemini/extensions/, so the host reads the shared -// repo copy directly. Making this lane self-contained would mean patching that -// manifest to a per-machine bundled-engine path — but patching a symlinked file -// mutates the shared copy for every project. Until Gemini moves to a copy+patch -// wire model (as the Claude Code lane did in 0.5.2, pointing MCP at the bundled -// engine via ${CLAUDE_PLUGIN_ROOT}), it requires `npm install -g cladding`. -function wireGemini(home: string, pkgRoot: string, opts: {force: boolean; isWin: boolean}): ChannelResult { - return wireChannel(join(pkgRoot, 'plugins', 'gemini-cli'), join(home, '.gemini', 'extensions', 'cladding'), opts); -} - -function wireCodexSkills( - home: string, - pkgRoot: string, - opts: {force: boolean; isWin: boolean}, -): CodexSkillResult[] { - const out: CodexSkillResult[] = []; - const codexSkillsDir = join(pkgRoot, 'plugins', 'codex', 'skills'); - if (!existsSync(codexSkillsDir)) return out; - for (const verb of readdirSync(codexSkillsDir)) { - const verbPath = join(codexSkillsDir, verb); +/** + * Ownership roots for legacy-cleanup gating. The HOME-tier status file is a + * frozen pre-0.9.0 artifact: only the old global installer wrote it, 0.9.0+ + * setup writes the PROJECT-tier status file and never updates the home one — + * it is read here purely so wires created by that old install stay provably + * ours across engine moves. + */ +function knownRoots(home: string, pkgRoot: string): string[] { + const roots = [resolve(pkgRoot)]; + const legacy = readText(join(home, '.cladding', STATUS_FILENAME)); + if (legacy) { try { - if (!statSync(verbPath).isDirectory()) continue; + const parsed = JSON.parse(legacy) as {cladding_root?: unknown}; + if (typeof parsed.cladding_root === 'string') roots.push(resolve(parsed.cladding_root)); } catch { - continue; - } - const linkPath = join(home, '.agents', 'skills', `cladding-${verb}`); - try { - const result = wireChannel(verbPath, linkPath, opts); - out.push({verb, result}); - } catch (e: unknown) { - const err = e as Error; - out.push({verb, result: 'failed', message: err.message}); + // A malformed advisory status file cannot establish ownership. } } - return out; -} - -/** How a host should launch the MCP server. Hosts spawn MCP servers with a - * minimal PATH, so a bare `clad` breaks for marketplace-only installs (the - * dead-server bug the Claude Code lane fixed by bundling, F-102). Prefer the - * absolute built engine under this package root — per-machine configs - * (~/.codex/config.toml, ~/.cursor/mcp.json) can carry machine paths safely. - * Fall back to the PATH-resolved verb only when no built engine exists. */ -export function resolveServeLaunch(pkgRoot: string): {command: string; args: string[]} { - const engine = join(pkgRoot, 'dist', 'clad.js'); - if (existsSync(engine)) return {command: 'node', args: [engine, 'serve']}; - return {command: 'clad', args: ['serve']}; + return [...new Set(roots)]; } -function wireCursorMcp(home: string, launch: {command: string; args: string[]}): ChannelResult { +function removeOwnedSymlink(path: string, roots: readonly string[]): ChannelResult { + if (!existsSync(path) && !isSymlink(path)) return 'unchanged'; + if (!isSymlink(path)) return 'skipped-different'; + const target = resolvedSymlink(path); + if (!target || !roots.some((root) => pathInside(target, root))) return 'skipped-different'; try { - const cursorConfigPath = join(home, '.cursor', 'mcp.json'); - ensureDir(dirname(cursorConfigPath)); - const existing = existsSync(cursorConfigPath) - ? (JSON.parse(readFileSync(cursorConfigPath, 'utf8')) as Record) - : {}; - if (!existing.mcpServers || typeof existing.mcpServers !== 'object') { - existing.mcpServers = {}; - } - const mcpServers = existing.mcpServers as Record; - const ourEntry = { - command: launch.command, - args: launch.args, - }; - const current = mcpServers.cladding as {command?: string; args?: unknown} | undefined; - const isSame = - current && - current.command === ourEntry.command && - JSON.stringify(current.args) === JSON.stringify(ourEntry.args); - if (isSame) return 'unchanged'; - const hadCurrent = current != null; - mcpServers.cladding = ourEntry; - writeFileSync(cursorConfigPath, JSON.stringify(existing, null, 2)); - return hadCurrent ? 'rewired' : 'created'; + rmSync(path, {force: true}); + return 'removed'; } catch { return 'failed'; } } -async function wireCodexMcp(home: string, launch: {command: string; args: string[]}): Promise { +function removeOwnedCodexSkills(home: string, roots: readonly string[]): ChannelResult { + const skillsRoot = join(home, '.agents', 'skills'); + if (!existsSync(skillsRoot)) return 'unchanged'; + let removed = 0; + let conflicts = 0; + for (const name of readdirSync(skillsRoot)) { + if (!name.startsWith('cladding-')) continue; + const result = removeOwnedSymlink(join(skillsRoot, name), roots); + if (result === 'removed') removed++; + if (result === 'skipped-different') conflicts++; + } + if (conflicts > 0) return 'skipped-different'; + return removed > 0 ? 'removed' : 'unchanged'; +} + +function isKnownLaunch(value: unknown, roots: readonly string[]): boolean { + if (!value || typeof value !== 'object') return false; + const entry = value as {command?: unknown; args?: unknown; description?: unknown}; + const args = Array.isArray(entry.args) ? entry.args : []; + if (entry.command === 'clad' && args[0] === 'serve') return true; + if (typeof entry.description === 'string' && entry.description.includes('wired by `clad setup`')) return true; + if (typeof entry.description === 'string' && entry.description.includes('project-scoped by `clad setup`')) return true; + if (entry.command === 'node' && args[0] === RUNTIME_RELATIVE) return true; + return entry.command === 'node' && typeof args[0] === 'string' && roots.some((root) => pathInside(args[0] as string, root)); +} + +/** + * Deletes the `[mcp_servers.cladding]` section from the raw TOML text without + * re-serializing the document, so the user's comments, ordering, and formatting + * everywhere else survive. Returns null when the section boundaries cannot be + * identified textually (caller falls back to the lossy stringify path). + */ +function spliceTomlSection(raw: string, header: string): string | null { + const lines = raw.split('\n'); + const start = lines.findIndex((l) => l.trim() === header); + if (start === -1) return null; + let end = lines.length; + for (let i = start + 1; i < lines.length; i++) { + const t = lines[i].trim(); + if (t.startsWith('[') && !t.startsWith('#')) { + end = i; + break; + } + } + // Also drop blank lines directly above the removed section so no gap pile-up. + let cut = start; + while (cut > 0 && lines[cut - 1].trim() === '') cut--; + return [...lines.slice(0, cut), ...lines.slice(end)].join('\n'); +} + +async function removeOwnedCodexMcp(home: string, roots: readonly string[]): Promise { + const path = join(home, '.codex', 'config.toml'); + const raw = readText(path); + if (raw == null) return 'unchanged'; try { - const codexConfigPath = join(home, '.codex', 'config.toml'); - ensureDir(dirname(codexConfigPath)); const {parse, stringify} = await import('smol-toml'); - const existing = existsSync(codexConfigPath) - ? (parse(readFileSync(codexConfigPath, 'utf8')) as Record) - : {}; - if (!existing.mcp_servers || typeof existing.mcp_servers !== 'object') { - existing.mcp_servers = {}; + const doc = parse(raw) as Record; + const servers = doc.mcp_servers as Record | undefined; + if (!servers?.cladding) return 'unchanged'; + if (!isKnownLaunch(servers.cladding, roots)) return 'skipped-different'; + delete servers.cladding; + if (Object.keys(servers).length === 0) delete doc.mcp_servers; + // Prefer a text-level splice (preserves the user's comments/format across + // the rest of the file); verify by parsing before trusting it, and fall + // back to the canonical re-serialization only when the splice is unsound. + const spliced = spliceTomlSection(raw, '[mcp_servers.cladding]'); + if (spliced != null) { + try { + if (JSON.stringify(parse(spliced)) === JSON.stringify(doc)) { + writeFileSync(path, spliced, 'utf8'); + return 'removed'; + } + } catch { + // fall through to the stringify path + } } - const mcpServers = existing.mcp_servers as Record; - const ourEntry = { - command: launch.command, - args: launch.args, - description: 'cladding MCP server (wired by `clad setup`)', - }; - const current = mcpServers.cladding as {command?: string; args?: unknown} | undefined; - const isSame = - current && - current.command === ourEntry.command && - JSON.stringify(current.args) === JSON.stringify(ourEntry.args); - if (isSame) return 'unchanged'; - const hadCurrent = current != null; - mcpServers.cladding = ourEntry; - writeFileSync(codexConfigPath, stringify(existing)); - return hadCurrent ? 'rewired' : 'created'; + writeFileSync(path, stringify(doc), 'utf8'); + return 'removed'; } catch { return 'failed'; } } -function readLastSetupVersion(statusFile: string): string | null { +function removeOwnedCursorMcp(home: string, roots: readonly string[]): ChannelResult { + const path = join(home, '.cursor', 'mcp.json'); + const raw = readText(path); + if (raw == null) return 'unchanged'; try { - const raw = readFileSync(statusFile, 'utf8'); - const parsed = JSON.parse(raw) as Partial; - return parsed.cladding_version ?? null; + const doc = JSON.parse(raw) as Record; + const servers = doc.mcpServers as Record | undefined; + if (!servers?.cladding) return 'unchanged'; + if (!isKnownLaunch(servers.cladding, roots)) return 'skipped-different'; + delete servers.cladding; + if (Object.keys(servers).length === 0) delete doc.mcpServers; + writeFileSync(path, `${JSON.stringify(doc, null, 2)}\n`, 'utf8'); + return 'removed'; } catch { - return null; + return 'failed'; } } -function writeStatus(statusFile: string, status: SetupStatus): void { +/** + * Antigravity (agy 1.1.x) reads MCP config ONLY from machine-wide locations + * (`~/.gemini/config/mcp_config.json` or `~/.gemini/config/plugins//`), + * never from the project — verified live in the 0.9.0 E2E campaign. It does + * spawn MCP servers with the session's working directory, so one machine-wide + * wire pointing at the engine stays project-aware. This is the one deliberate + * exception to project-local activation, and the setup report says so. + */ +function wireAntigravityGlobal(home: string, pkgRoot: string, force: boolean): ChannelResult { + const dir = join(home, '.gemini', 'config', 'plugins', 'cladding'); + // An unowned legacy symlink survived cleanup — never write through it. + if (isSymlink(dir)) return 'skipped-different'; + const launch = {command: 'node', args: [join(pkgRoot, 'dist', 'clad.js'), 'serve']}; + const mcp = mergeJsonMcp(join(dir, 'mcp_config.json'), launch, force); + if (mcp === 'skipped-different' || mcp === 'failed') return mcp; + const manifest = `${JSON.stringify({ + $schema: 'https://antigravity.google/schemas/v1/plugin.json', + name: 'cladding', + description: 'Spec-driven verification and onboarding for Antigravity CLI (machine-wide MCP wire; the project is resolved from each session’s working directory).', + }, null, 2)}\n`; + return combine([mcp, writeIfChanged(join(dir, 'plugin.json'), manifest)]); +} + +/** + * Legacy-cleanup gate for `~/.gemini/config/plugins/cladding`: the pre-0.9.0 + * install left a SYMLINK here (owned → removed); 0.9.0 setup writes a REAL + * directory as the managed Antigravity wire (recognized launch → kept). A real + * directory with an unrecognized launch is foreign and is never removed. + */ +function cleanupAntigravityPlugin(home: string, roots: readonly string[]): ChannelResult { + const dir = join(home, '.gemini', 'config', 'plugins', 'cladding'); + if (isSymlink(dir)) return removeOwnedSymlink(dir, roots); + const cfg = readText(join(dir, 'mcp_config.json')); + if (cfg == null) return 'unchanged'; try { - ensureDir(dirname(statusFile)); - writeFileSync(statusFile, JSON.stringify(status, null, 2)); + const servers = (JSON.parse(cfg) as {mcpServers?: Record}).mcpServers; + if (servers?.cladding && !isKnownLaunch(servers.cladding, roots)) return 'skipped-different'; + return 'unchanged'; } catch { - // status file is advisory; failure here is not user-visible. + return 'skipped-different'; } } -function formatChannelLine(name: string, result: ChannelResult, target?: string): string { - const icon = - result === 'created' || result === 'rewired' || result === 'copied' || result === 'unchanged' - ? '✓' - : result === 'skipped-not-installed' - ? '-' - : result === 'skipped-different' - ? '⚠' - : '✗'; - const label = - result === 'created' - ? 'wired' - : result === 'rewired' - ? 're-wired (updated)' - : result === 'copied' - ? 'wired (directory copy, Windows fallback)' - : result === 'unchanged' - ? 'already wired' - : result === 'skipped-not-installed' - ? 'not installed, skipped' - : result === 'skipped-different' - ? 'conflict — manual change detected, use --force' - : 'failed'; - return ` ${icon} ${name.padEnd(28)} → ${label}${target ? ` (${target})` : ''}`; -} - -const WIRED_STATES: ReadonlySet = new Set(['created', 'rewired', 'unchanged', 'copied']); - -/** Check whether a binary exists in PATH using `which` (POSIX) or `where` (Win). */ function detectBinary(name: string): boolean { - const cmd = platform() === 'win32' ? 'where' : 'which'; - const result = spawnSync(cmd, [name], {stdio: 'ignore'}); - return result.status === 0; -} - -/** Run a non-interactive activation command, return true on success. */ -function runActivation(command: string, args: readonly string[]): {ok: boolean; stderr: string} { - // shell:true on Windows — the host CLIs (claude/gemini/codex) install as `.cmd` - // shims that spawnSync cannot resolve without a shell, so without this the - // activation ENOENTs even though `where ` (detectBinary) found it. - const result = spawnSync(command, args, { - encoding: 'utf8', - timeout: 30_000, - shell: platform() === 'win32', - }); - return {ok: result.status === 0, stderr: result.stderr ?? ''}; -} - -export interface ActivationResult { - readonly attempted: boolean; - readonly success: boolean; - readonly stderr?: string; -} - -function activateClaude(pluginPath: string): ActivationResult { - if (!detectBinary('claude')) return {attempted: false, success: false}; - const add = runActivation('claude', ['plugin', 'marketplace', 'add', pluginPath, '--scope', 'user']); - if (!add.ok) return {attempted: true, success: false, stderr: add.stderr}; - const install = runActivation('claude', ['plugin', 'install', 'claude-code@cladding', '--scope', 'user']); - return {attempted: true, success: install.ok, stderr: install.stderr}; -} - -function activateGemini(extensionPath: string): ActivationResult { - if (!detectBinary('gemini')) return {attempted: false, success: false}; - // Check if cladding extension is already installed/enabled — `gemini extensions - // list` writes its output to stderr (verified against gemini 0.42.0), so we - // grep both streams. - const list = spawnSync('gemini', ['extensions', 'list'], { - encoding: 'utf8', - timeout: 10_000, - shell: platform() === 'win32', // `gemini` is a `.cmd` shim on Windows - }); - const combined = (list.stdout ?? '') + (list.stderr ?? ''); - if (list.status === 0 && /\bcladding\b/.test(combined)) { - return {attempted: true, success: true}; + const command = platform() === 'win32' ? 'where' : 'which'; + return spawnSync(command, [name], {stdio: 'ignore'}).status === 0; +} + +function cleanupClaudeUserPlugin(enabled: boolean): ChannelResult { + if (!enabled || !detectBinary('claude')) return 'manual-required'; + const result = spawnSync( + 'claude', + ['plugin', 'uninstall', 'claude-code@cladding', '--scope', 'user', '--keep-data'], + {encoding: 'utf8', timeout: 30_000, shell: platform() === 'win32'}, + ); + if (result.status === 0) return 'removed'; + const combined = `${result.stdout ?? ''}\n${result.stderr ?? ''}`; + return /not installed|not found/i.test(combined) ? 'unchanged' : 'manual-required'; +} + +function runtimeBody(pkgRoot: string): string { + const engine = join(pkgRoot, 'dist', 'clad.js'); + return [ + "'use strict';", + "const {spawn} = require('node:child_process');", + `const engine = ${JSON.stringify(engine)};`, + "const requested = process.argv.slice(2);", + "const args = requested.length > 0 ? requested : ['serve'];", + "const child = spawn(process.execPath, [engine, ...args], {cwd: process.cwd(), stdio: 'inherit'});", + "for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => child.kill(signal));", + "child.on('error', (error) => { console.error(`cladding project launcher: ${error.message}`); process.exitCode = 1; });", + "child.on('exit', (code, signal) => { process.exitCode = code ?? (signal ? 1 : 0); });", + '', + ].join('\n'); +} + +/** Allow only the annotated read-only doctor surfaces while Gemini is in Plan Mode. */ +function geminiDoctorPolicyBody(): string { + return [ + '[[rule]]', + 'mcpName = "cladding"', + 'toolName = "*"', + 'decision = "deny"', + 'priority = 100', + 'modes = ["plan"]', + 'interactive = false', + '', + '[[rule]]', + 'mcpName = "cladding"', + 'toolName = ["clad_list_features", "clad_get_feature", "clad_run_check"]', + 'toolAnnotations = { readOnlyHint = true }', + 'decision = "allow"', + 'priority = 200', + 'modes = ["plan"]', + 'interactive = false', + '', + '[[rule]]', + 'toolName = "exit_plan_mode"', + 'decision = "deny"', + 'priority = 200', + 'modes = ["plan"]', + 'interactive = false', + '', + ].join('\n'); +} + +/** Keep machine-specific setup state out of a Git worktree without editing the shared .gitignore. */ +function ignoreLocalRuntime(projectRoot: string): void { + const exclude = join(projectRoot, '.git', 'info', 'exclude'); + if (!existsSync(dirname(exclude))) return; + const entries = ['/.cladding/host/', '/.cladding/setup-status.json']; + const current = readText(exclude) ?? ''; + const lines = current.split(/\r?\n/); + const missing = entries.filter((entry) => !lines.includes(entry)); + if (missing.length === 0) return; + const separator = current.length > 0 && !current.endsWith('\n') ? '\n' : ''; + writeFileSync(exclude, `${current}${separator}${missing.join('\n')}\n`, 'utf8'); +} + +function mcpLaunch(): {command: string; args: string[]} { + return {command: 'node', args: [RUNTIME_RELATIVE]}; +} + +function copyManagedSkill(source: string, destination: string, force: boolean): ChannelResult { + if (!existsSync(source)) return 'failed'; + const sourceBody = readText(join(source, 'SKILL.md')); + if (sourceBody == null || !sourceBody.startsWith('---\n')) return 'failed'; + const destinationName = basename(destination); + const expected = /^name:\s*.*$/m.test(sourceBody) + ? sourceBody.replace(/^name:\s*.*$/m, `name: ${destinationName}`) + : sourceBody.replace(/^---\n/, `---\nname: ${destinationName}\n`); + if (existsSync(destination)) { + const current = readText(join(destination, 'SKILL.md')); + if (current === expected) return 'unchanged'; + if (!force && current != null && !current.includes('# Cladding init')) return 'skipped-different'; + rmSync(destination, {recursive: true, force: true}); } - const link = runActivation('gemini', ['extensions', 'link', extensionPath]); - return {attempted: true, success: link.ok, stderr: link.stderr}; + ensureDir(dirname(destination)); + cpSync(source, destination, {recursive: true, dereference: true}); + writeFileSync(join(destination, 'SKILL.md'), expected, 'utf8'); + return 'created'; } -export interface ActivationContext { - readonly claude?: ActivationResult; - readonly gemini?: ActivationResult; +function mergeJsonMcp(path: string, launch: {command: string; args: string[]}, force: boolean): ChannelResult { + try { + const raw = readText(path); + const doc = raw == null ? {} : (JSON.parse(raw) as Record); + if (!doc.mcpServers || typeof doc.mcpServers !== 'object') doc.mcpServers = {}; + const servers = doc.mcpServers as Record; + const current = servers.cladding; + const next = {command: launch.command, args: launch.args}; + if (JSON.stringify(current) === JSON.stringify(next)) return 'unchanged'; + if (current && !force && !isKnownLaunch(current, [])) return 'skipped-different'; + servers.cladding = next; + return writeIfChanged(path, `${JSON.stringify(doc, null, 2)}\n`); + } catch { + return 'failed'; + } } -function pushActivationHint( - lines: string[], - channel: 'claude' | 'gemini' | 'codex-skills' | 'codex-mcp' | 'cursor', - wired: boolean, - activation?: ActivationContext, -): void { - if (!wired) return; - switch (channel) { - case 'claude': { - const a = activation?.claude; - if (a?.attempted && a.success) { - lines.push(' ↳ Activate: ✓ claude plugin marketplace add + install done automatically (applies after Claude Code restart)'); - } else if (a?.attempted && !a.success) { - lines.push(' ↳ Activate: ✗ auto attempt failed — manual:'); - lines.push(' `claude plugin marketplace add ~/.claude/plugins/cladding`'); - lines.push(' then `claude plugin install claude-code@cladding --scope user`'); - } else { - lines.push(' ↳ Activate (no claude binary): manual:'); - lines.push(' `claude plugin marketplace add ~/.claude/plugins/cladding`'); - lines.push(' then `claude plugin install claude-code@cladding --scope user`'); - } - break; +/** Allow only Cladding's read-only doctor tools in project-local Cursor CLI sessions. */ +function mergeCursorCliPermissions(path: string): ChannelResult { + try { + const raw = readText(path); + const doc = raw == null ? {} : (JSON.parse(raw) as Record); + const currentPermissions = doc.permissions; + if ( + currentPermissions !== undefined && + (typeof currentPermissions !== 'object' || currentPermissions === null || Array.isArray(currentPermissions)) + ) { + return 'skipped-different'; } - case 'gemini': { - const a = activation?.gemini; - if (a?.attempted && a.success) { - lines.push(' ↳ Activate: ✓ gemini extensions link done automatically (applies after Gemini CLI restart)'); - } else if (a?.attempted && !a.success) { - lines.push(' ↳ Activate: ✗ auto attempt failed — manual:'); - lines.push(' `gemini extensions link ~/.gemini/extensions/cladding`'); - } else { - lines.push(' ↳ Activate (no gemini binary): manual:'); - lines.push(' `gemini extensions link ~/.gemini/extensions/cladding`'); - } - break; + const permissions = (currentPermissions ?? {}) as Record; + const currentAllow = permissions.allow; + if ( + currentAllow !== undefined && + (!Array.isArray(currentAllow) || currentAllow.some((entry) => typeof entry !== 'string')) + ) { + return 'skipped-different'; } - case 'codex-skills': - lines.push(' ↳ Codex CLI auto-detects ~/.agents/skills/ (applies after restart)'); - break; - case 'codex-mcp': - lines.push(' ↳ the TOML entry itself registers it — no separate activation needed'); - break; - case 'cursor': - lines.push(' ↳ ~/.cursor/mcp.json itself registers it — applies after Cursor restart'); - break; + const currentDeny = permissions.deny; + if ( + currentDeny !== undefined && + (!Array.isArray(currentDeny) || currentDeny.some((entry) => typeof entry !== 'string')) + ) { + return 'skipped-different'; + } + const allow = (currentAllow ?? []) as string[]; + const deny = (currentDeny ?? []) as string[]; + const nextAllow = [...allow]; + for (const permission of CURSOR_READONLY_MCP_PERMISSIONS) { + if (!nextAllow.includes(permission)) nextAllow.push(permission); + } + if (nextAllow.length === allow.length && currentDeny !== undefined) return 'unchanged'; + permissions.allow = nextAllow; + permissions.deny = deny; + doc.permissions = permissions; + return writeIfChanged(path, `${JSON.stringify(doc, null, 2)}\n`); + } catch { + return 'failed'; } } -function printReport( - result: SetupResult, - detection: HostDetection, - activation: ActivationContext, - opts: {quiet?: boolean}, -): void { - if (opts.quiet) return; - process.stdout.write(renderSetupReport(result, detection, activation) + '\n'); -} - -/** Pure renderer for the setup report (AC-010 — the numbered "Next steps" block). - * Separated from printReport so the guidance contract is unit-testable. */ -export function renderSetupReport( - result: SetupResult, - detection: HostDetection, - activation: ActivationContext, -): string { - const lines: string[] = []; - lines.push('cladding setup — wiring detected AI tools'); - lines.push(''); - - const claudeState = detection.claude ? result.wiring.claude_plugin : 'skipped-not-installed'; - lines.push(formatChannelLine('Claude Code', claudeState)); - pushActivationHint(lines, 'claude', WIRED_STATES.has(claudeState), activation); - - const geminiState = detection.gemini ? result.wiring.gemini_extension : 'skipped-not-installed'; - lines.push(formatChannelLine('Gemini CLI', geminiState)); - pushActivationHint(lines, 'gemini', WIRED_STATES.has(geminiState), activation); - - const skillsSummary = detection.agents - ? summarizeSkills(result.wiring.codex_skills) - : 'skipped-not-installed'; - lines.push( - detection.agents - ? ` ✓ ${'Codex skills'.padEnd(28)} → ${skillsSummary}` - : formatChannelLine('Codex skills', 'skipped-not-installed'), - ); - const skillsWired = detection.agents && result.wiring.codex_skills.some((s) => WIRED_STATES.has(s.result)); - pushActivationHint(lines, 'codex-skills', skillsWired); - - const codexMcpState = detection.codex ? result.wiring.codex_mcp : 'skipped-not-installed'; - lines.push(formatChannelLine('Codex MCP', codexMcpState)); - pushActivationHint(lines, 'codex-mcp', WIRED_STATES.has(codexMcpState)); - - const cursorState = detection.cursor ? result.wiring.cursor_mcp : 'skipped-not-installed'; - lines.push(formatChannelLine('Cursor', cursorState)); - pushActivationHint(lines, 'cursor', WIRED_STATES.has(cursorState)); - - lines.push(''); - const wiredCount = countWired(result.wiring, detection); - const detectedCount = countDetected(detection); - if (wiredCount === detectedCount && detectedCount > 0) { - lines.push(`${wiredCount}/${detectedCount} detected channels wired. Status: ${result.statusFile}`); - } else if (detectedCount === 0) { - lines.push('No AI tools detected. Install one of Claude Code / Codex / Gemini CLI / Cursor, then run this again.'); - } else { - lines.push(`${wiredCount}/${detectedCount} detected channels wired (some skipped/failed). Status: ${result.statusFile}`); - } - if (result.last_setup_version && result.last_setup_version !== result.cladding_version) { - lines.push(''); - lines.push(`(version change detected: ${result.last_setup_version} → ${result.cladding_version})`); +async function mergeCodexMcp(path: string, launch: {command: string; args: string[]}, force: boolean): Promise { + try { + const {parse, stringify} = await import('smol-toml'); + const raw = readText(path); + const doc = raw == null ? {} : (parse(raw) as Record); + if (!doc.mcp_servers || typeof doc.mcp_servers !== 'object') doc.mcp_servers = {}; + const servers = doc.mcp_servers as Record; + const current = servers.cladding; + const next = { + command: launch.command, + args: launch.args, + description: 'cladding MCP server (project-scoped by `clad setup`)', + default_tools_approval_mode: 'writes', + }; + if (JSON.stringify(current) === JSON.stringify(next)) return 'unchanged'; + if (current && !force && !isKnownLaunch(current, [])) return 'skipped-different'; + servers.cladding = next; + return writeIfChanged(path, stringify(doc)); + } catch { + return 'failed'; } - lines.push(''); - lines.push('Next steps:'); - lines.push(' 1. Restart your AI tool (Claude Code / Codex / Gemini / Cursor)'); - lines.push(' 2. Open the project directory'); - lines.push(' 3. Type /cladding init "..." (inside the LLM) or `clad init "..."` (terminal)'); - lines.push(' 4. Start building — cladding checks that spec ↔ code stay in sync on every commit'); - return lines.join('\n'); } -function summarizeSkills(skills: ReadonlyArray): string { - if (skills.length === 0) return '0 verbs (skipped)'; - const counts = skills.reduce>((acc, s) => { - acc[s.result] = (acc[s.result] ?? 0) + 1; - return acc; - }, {}); - const parts: string[] = []; - if (counts.created) parts.push(`${counts.created} created`); - if (counts.rewired) parts.push(`${counts.rewired} re-wired`); - if (counts.unchanged) parts.push(`${counts.unchanged} already wired`); - if (counts.copied) parts.push(`${counts.copied} copied`); - if (counts.failed) parts.push(`${counts.failed} failed`); - if (counts['skipped-different']) parts.push(`${counts['skipped-different']} conflict`); - return `${skills.length} verb${skills.length === 1 ? '' : 's'} — ${parts.join(', ')}`; -} - -function countDetected(detection: HostDetection): number { - return ( - (detection.claude ? 1 : 0) + - (detection.gemini ? 1 : 0) + - (detection.agents ? 1 : 0) + - (detection.codex ? 1 : 0) + - (detection.cursor ? 1 : 0) - ); +function writeCursorBootstrap(projectRoot: string): ChannelResult { + const body = [ + '---', + 'description: Cladding bootstrap boundary', + 'alwaysApply: true', + '---', + '', + 'Cladding is available only in this project. Do not initialize or invoke Cladding for ordinary work.', + 'Use the cladding-init skill only when the user explicitly names Cladding and asks to initialize, adopt, or refresh it.', + '', + ].join('\n'); + return writeIfChanged(join(projectRoot, '.cursor', 'rules', 'cladding-bootstrap.mdc'), body); } -function countWired(wiring: SetupResult['wiring'], detection: HostDetection): number { - let n = 0; - const wiredStates = new Set(['created', 'rewired', 'unchanged', 'copied']); - if (detection.claude && wiredStates.has(wiring.claude_plugin)) n++; - if (detection.gemini && wiredStates.has(wiring.gemini_extension)) n++; - if (detection.agents && wiring.codex_skills.some((s) => wiredStates.has(s.result))) n++; - if (detection.codex && wiredStates.has(wiring.codex_mcp)) n++; - if (detection.cursor && wiredStates.has(wiring.cursor_mcp)) n++; - return n; +function combine(results: readonly ChannelResult[]): ChannelResult { + if (results.includes('failed')) return 'failed'; + if (results.includes('skipped-different')) return 'skipped-different'; + if (results.includes('manual-required')) return 'manual-required'; + if (results.includes('removed')) return 'removed'; + if (results.includes('rewired')) return 'rewired'; + if (results.includes('created')) return 'created'; + return 'unchanged'; +} + +function readLastSetupVersion(statusFile: string): string | null { + try { + return (JSON.parse(readFileSync(statusFile, 'utf8')) as SetupStatus).cladding_version ?? null; + } catch { + return null; + } +} + +function collectIssue( + result: ChannelResult, + step: string, + errors: Array<{step: string; message: string}>, + warnings: Array<{step: string; message: string}>, +): void { + if (result === 'failed') errors.push({step, message: 'project wiring failed'}); + if (result === 'skipped-different') warnings.push({step, message: 'existing non-Cladding configuration was preserved; use --force to replace only the cladding entry'}); + if (result === 'manual-required') warnings.push({step, message: 'run `claude plugin uninstall claude-code@cladding --scope user --keep-data` to remove the legacy user plugin'}); } -/** Run the `clad setup` host wiring (install + update + delta + repair). */ +/** Wire Cladding only into one project and remove provably-owned legacy globals. */ export async function runHostSetup(opts: SetupOptions = {}): Promise { const home = opts.home ?? homedir(); + const projectRoot = resolve(opts.projectRoot ?? process.cwd()); const pkgRoot = opts.pkgRoot ?? resolveDefaultPkgRoot(); - const version = opts.version ?? readCladingVersion(pkgRoot); - const isWin = platform() === 'win32'; + const version = opts.version ?? readCladdingVersion(pkgRoot); + // Default to the hosts actually present on this machine (spec AC-001: + // "wire only the detected channels"); `--host all` forces every channel. + const detected = detectHosts(home); + const hosts = new Set(opts.hosts ?? ALL_HOSTS.filter((h) => detected[h])); const force = opts.force ?? false; - const statusFile = join(home, '.cladding', STATUS_FILENAME); - + const statusFile = join(projectRoot, '.cladding', STATUS_FILENAME); const lastVersion = readLastSetupVersion(statusFile); - const detection = detectHosts(home); const errors: Array<{step: string; message: string}> = []; - - const claude_plugin = detection.claude - ? wireClaude(home, pkgRoot, {force, isWin}) - : 'skipped-not-installed'; - const gemini_extension = detection.gemini - ? wireGemini(home, pkgRoot, {force, isWin}) - : 'skipped-not-installed'; - const codex_skills = detection.agents ? wireCodexSkills(home, pkgRoot, {force, isWin}) : []; - const serveLaunch = resolveServeLaunch(pkgRoot); - const codex_mcp: ChannelResult = detection.codex - ? await wireCodexMcp(home, serveLaunch) - : 'skipped-not-installed'; - const cursor_mcp: ChannelResult = detection.cursor - ? wireCursorMcp(home, serveLaunch) - : 'skipped-not-installed'; - - for (const state of [claude_plugin, gemini_extension, codex_mcp, cursor_mcp]) { - if (state === 'failed') errors.push({step: state, message: 'wire failed'}); + const warnings: Array<{step: string; message: string}> = []; + + ensureDir(projectRoot); + ignoreLocalRuntime(projectRoot); + const runtimeParts: ChannelResult[] = [ + writeIfChanged(join(projectRoot, RUNTIME_RELATIVE), runtimeBody(pkgRoot)), + ]; + if (hosts.has('gemini')) { + runtimeParts.push( + writeIfChanged(join(projectRoot, GEMINI_DOCTOR_POLICY_RELATIVE), geminiDoctorPolicyBody()), + ); } - for (const s of codex_skills) { - if (s.result === 'failed') errors.push({step: `codex_skill:${s.verb}`, message: s.message ?? 'wire failed'}); + const runtime = combine(runtimeParts); + const initSource = join(pkgRoot, 'plugins', 'codex', 'skills', 'init'); + const sharedSkill = hosts.has('codex') || hosts.has('gemini') || hosts.has('antigravity') + ? copyManagedSkill(initSource, join(projectRoot, '.agents', 'skills', 'cladding-init'), force) + : 'unchanged'; + const launch = mcpLaunch(); + + // Legacy cleanup runs BEFORE wiring: the antigravity channel writes a + // machine-wide dir at the same path the pre-0.9.0 symlink occupied, and a + // merge through a still-present symlink would write into the legacy package. + const roots = knownRoots(home, pkgRoot); + const claudePluginLink = removeOwnedSymlink(join(home, '.claude', 'plugins', 'cladding'), roots); + const claudePluginInstall = claudePluginLink === 'removed' + ? cleanupClaudeUserPlugin(opts.activate ?? true) + : 'unchanged'; + const legacyCleanup = { + claude_plugin: combine([claudePluginLink, claudePluginInstall]), + gemini_extension: removeOwnedSymlink(join(home, '.gemini', 'extensions', 'cladding'), roots), + antigravity_plugin: cleanupAntigravityPlugin(home, roots), + codex_skills: removeOwnedCodexSkills(home, roots), + codex_mcp: await removeOwnedCodexMcp(home, roots), + cursor_mcp: removeOwnedCursorMcp(home, roots), + } as const; + + const codex = hosts.has('codex') + ? await mergeCodexMcp(join(projectRoot, '.codex', 'config.toml'), launch, force) + : 'skipped-not-selected'; + const gemini = hosts.has('gemini') + ? mergeJsonMcp(join(projectRoot, '.gemini', 'settings.json'), launch, force) + : 'skipped-not-selected'; + const antigravity = hosts.has('antigravity') + ? combine([ + // Forward-compat project file (agy 1.1.x does not read it yet) … + mergeJsonMcp(join(projectRoot, '.agents', 'mcp_config.json'), launch, force), + // … plus the machine-wide wire agy actually loads (see wireAntigravityGlobal). + wireAntigravityGlobal(home, pkgRoot, force), + ]) + : 'skipped-not-selected'; + const claude = hosts.has('claude') + ? combine([ + copyManagedSkill(initSource, join(projectRoot, '.claude', 'skills', 'cladding-init'), force), + mergeJsonMcp(join(projectRoot, '.mcp.json'), launch, force), + ]) + : 'skipped-not-selected'; + const cursor = hosts.has('cursor') + ? combine([ + copyManagedSkill(initSource, join(projectRoot, '.cursor', 'skills', 'cladding-init'), force), + mergeJsonMcp(join(projectRoot, '.cursor', 'mcp.json'), launch, force), + mergeCursorCliPermissions(join(projectRoot, '.cursor', 'cli.json')), + writeCursorBootstrap(projectRoot), + ]) + : 'skipped-not-selected'; + + const wiring = {runtime, shared_init_skill: sharedSkill, claude, codex, gemini, antigravity, cursor}; + if (hosts.size === 0) { + warnings.push({ + step: 'hosts', + message: 'no supported AI host detected on this machine — only the shared runtime was written; use `clad setup --host ` to wire explicitly', + }); } + for (const [step, state] of Object.entries(wiring)) collectIssue(state, step, errors, warnings); + for (const [step, state] of Object.entries(legacyCleanup)) collectIssue(state, `legacy:${step}`, errors, warnings); - // Auto-activation — runs after symlink wire succeeds. Each host CLI command - // is invoked non-interactively; failures fall back to stdout instructions. - // Guarded by opts.activate: the real activators mutate the machine's actual - // host config (not the mocked home), so tests/CI must opt out. - const shouldActivate = opts.activate ?? true; - const claudeActivator = opts.activators?.claude ?? activateClaude; - const geminiActivator = opts.activators?.gemini ?? activateGemini; - const activation: ActivationContext = shouldActivate - ? { - ...(WIRED_STATES.has(claude_plugin) - ? {claude: claudeActivator(join(home, '.claude', 'plugins', 'cladding'))} - : {}), - ...(WIRED_STATES.has(gemini_extension) - ? {gemini: geminiActivator(join(home, '.gemini', 'extensions', 'cladding'))} - : {}), - } - : {}; + ensureDir(dirname(statusFile)); + writeFileSync(statusFile, `${JSON.stringify({ + project_root: projectRoot, + cladding_root: pkgRoot, + cladding_version: version, + last_run: new Date().toISOString(), + }, null, 2)}\n`, 'utf8'); const result: SetupResult = { - wiring: {claude_plugin, gemini_extension, codex_skills, codex_mcp, cursor_mcp}, + projectRoot, + wiring, + legacyCleanup, errors, + warnings, statusFile, cladding_root: pkgRoot, cladding_version: version, last_setup_version: lastVersion, }; + if (!opts.quiet) process.stdout.write(`${renderSetupReport(result)}\n`); + return result; +} - writeStatus(statusFile, { - cladding_root: pkgRoot, - cladding_version: version, - last_run: new Date().toISOString(), - wiring: result.wiring, - errors, - }); +function stateLabel(state: ChannelResult): string { + switch (state) { + case 'created': return 'wired'; + case 'rewired': return 'updated'; + case 'unchanged': return 'already ready'; + case 'removed': return 'legacy global removed'; + case 'skipped-not-selected': return 'not selected'; + case 'skipped-different': return 'preserved conflict'; + case 'manual-required': return 'manual cleanup required'; + default: return 'failed'; + } +} - printReport(result, detection, activation, {quiet: opts.quiet}); - return result; +/** Render a host-neutral setup summary without exposing internal package paths. */ +export function renderSetupReport(result: SetupResult, _detection?: HostDetection): string { + void _detection; + const lines = [ + `cladding setup — project activation: ${result.projectRoot}`, + '', + ` Claude Code → ${stateLabel(result.wiring.claude)}`, + ` Codex → ${stateLabel(result.wiring.codex)}`, + ` Gemini CLI → ${stateLabel(result.wiring.gemini)}`, + ` Antigravity → ${stateLabel(result.wiring.antigravity)}`, + ` Cursor → ${stateLabel(result.wiring.cursor)}`, + ]; + if (result.wiring.antigravity === 'created' || result.wiring.antigravity === 'rewired') { + lines.push('', ' Note: Antigravity reads MCP config machine-wide only, so its wire lives in ~/.gemini/config/plugins/cladding (each session still resolves the project from its working directory).'); + } + const cleaned = Object.values(result.legacyCleanup).filter((state) => state === 'removed').length; + if (cleaned > 0) lines.push('', `Removed ${cleaned} legacy global Cladding wire(s).`); + for (const warning of result.warnings) lines.push(` ! ${warning.step}: ${warning.message}`); + lines.push( + '', + 'Next steps:', + ' 1. Start a new AI session in this project directory', + ' 2. Ask: "Apply Cladding to this project"', + ' 3. Review the preview and reply with its exact approval phrase', + ' 4. After initialization, develop normally in natural language', + ); + return lines.join('\n'); } function resolveDefaultPkgRoot(): string { - // Resolves the cladding package root from this file's location. - // ESM build outputs a single bundled dist/clad.js (see scripts/build.mjs), - // so we walk up from that file's location until we find a package.json - // whose name is "cladding". This is robust to bundlers, symlinks, and any - // future restructuring of the dist/ output. - try { - const here = fileURLToPath(import.meta.url); - let cur = dirname(here); - for (let depth = 0; depth < 6; depth++) { - const pkgPath = join(cur, 'package.json'); - try { - const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as {name?: string}; - if (pkg.name === 'cladding') return cur; - } catch { - // fallthrough - } - const parent = dirname(cur); - if (parent === cur) break; - cur = parent; + const here = fileURLToPath(import.meta.url); + let current = dirname(here); + for (let depth = 0; depth < 7; depth++) { + try { + const pkg = JSON.parse(readFileSync(join(current, 'package.json'), 'utf8')) as {name?: string}; + if (pkg.name === 'cladding') return current; + } catch { + // Continue towards the filesystem root. } - // Fallback: assume two levels up from this file (src/init/x.ts pattern). - return resolve(dirname(here), '..', '..'); - } catch { - return process.cwd(); + current = dirname(current); } + return resolve(dirname(here), '..'); } -function readCladingVersion(pkgRoot: string): string { +function readCladdingVersion(pkgRoot: string): string { try { - const pkg = JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf8')) as {version: string}; - return pkg.version; + return (JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf8')) as {version?: string}).version ?? 'unknown'; } catch { return 'unknown'; } } -/** Read the version recorded by the last `clad setup` run, or null if never run. */ -export function getLastSetupVersion(home: string = homedir()): string | null { - return readLastSetupVersion(join(home, '.cladding', STATUS_FILENAME)); +export function getCurrentCladdingVersion(): string | null { + const version = readCladdingVersion(resolveDefaultPkgRoot()); + return version === 'unknown' ? null : version; } -/** Read the current cladding binary's package.json version, or null if unreadable. */ -export function getCurrentCladdingVersion(): string | null { - try { - const pkgRoot = resolveDefaultPkgRoot(); - const v = readCladingVersion(pkgRoot); - return v === 'unknown' ? null : v; - } catch { - return null; - } +export function getLastSetupVersion(projectRoot: string = process.cwd()): string | null { + return readLastSetupVersion(join(resolve(projectRoot), '.cladding', STATUS_FILENAME)); +} + +/** Exported for diagnostics and tests; setup writes all selected hosts regardless of installation. */ +export function detectHosts(home: string = homedir()): HostDetection { + return { + claude: existsSync(join(home, '.claude')), + gemini: existsSync(join(home, '.gemini')), + antigravity: existsSync(join(home, '.gemini', 'config')) || existsSync(join(home, '.gemini', 'antigravity-cli')), + codex: existsSync(join(home, '.codex')), + agents: existsSync(join(home, '.agents')), + cursor: existsSync(join(home, '.cursor')), + }; } diff --git a/src/serve/server.ts b/src/serve/server.ts index bd3450c7..eebae42f 100644 --- a/src/serve/server.ts +++ b/src/serve/server.ts @@ -19,9 +19,13 @@ // @see spec/features/F-073.yaml — server scaffold AC matrix. import {spawnSync} from 'node:child_process'; -import {readFileSync, existsSync, statSync} from 'node:fs'; -import {dirname, join} from 'node:path'; +import {createHash, randomUUID} from 'node:crypto'; +import {readFileSync, existsSync, mkdirSync, realpathSync, readdirSync, rmSync, statSync, writeFileSync} from 'node:fs'; +import {basename, dirname, extname, isAbsolute, join, relative, resolve, sep} from 'node:path'; import {fileURLToPath} from 'node:url'; +import {TextDecoder} from 'node:util'; +import {deflateRawSync, inflateRawSync} from 'node:zlib'; +import {tmpdir} from 'node:os'; import {McpServer} from '@modelcontextprotocol/sdk/server/mcp.js'; import { @@ -37,7 +41,7 @@ import {renderAuditTable, renderCatalog, renderChangelogMarkdown} from '../chang import {subscribeAudit} from '../hitl/audit.js'; import {loadSpec} from '../spec/load.js'; import type {Spec} from '../spec/types.js'; -import {createFeature, createScenario, linkCapability} from '../spec/new.js'; +import {createFeature, createScenario, linkCapability, linkScenario, resolveDesignImpact} from '../spec/new.js'; import {recordOracle} from '../oracle/record.js'; import {doneFeatureCount, oracleRequired, resolveOraclePolicy} from '../oracle/policy.js'; import {maintainDeliverable} from '../spec/deliverable-detect.js'; @@ -71,11 +75,18 @@ export const PERSONA_PROMPT_ALIASES: Readonly> = { /** Tool names cladding's MCP server exposes (stable wire identifiers). */ export const TOOL_NAMES = [ + 'clad_prepare_init', + 'clad_stage_init', + 'clad_init', + 'clad_prepare_clarify', + 'clad_clarify', + 'clad_resolve_onboarding_review', 'clad_list_features', 'clad_get_feature', 'clad_run_check', 'clad_get_events', 'clad_create_feature', + 'clad_resolve_design_impact', 'clad_create_scenario', 'clad_link_capability', 'clad_author_oracle', @@ -102,6 +113,50 @@ export interface ServerOptions { readonly name?: string; /** Server version advertised to clients. */ readonly version?: string; + /** In-process onboarding operations supplied by the CLI composition root. */ + readonly onboarding?: OnboardingOperations; +} + +/** Process-independent onboarding contract injected at the serve boundary. */ +export interface OnboardingOperations { + readonly renderDraft: (draft: unknown) => string; + readonly prepareInit: (opts: {cwd: string; mode: string; intent: string}) => { + readonly prompt: string; + readonly request: {readonly mode: string; readonly intent: string}; + readonly observation: Record; + }; + readonly initialize: (opts: { + cwd: string; + intent?: string; + scan?: boolean; + noLlm?: boolean; + hostDispatcher?: (prompt: string) => Promise; + }) => Promise<{ + readonly created?: readonly string[]; + readonly skipped?: readonly string[]; + readonly language?: string; + readonly proposals?: readonly string[]; + readonly clarifyingQuestions?: readonly string[]; + readonly onboardingMode?: 'greenfield' | 'existing-adoption' | 'mixed'; + readonly onboardingSource?: 'llm' | 'hybrid' | 'deterministic'; + }>; + readonly prepareClarify: ( + answer: string, + opts: {cwd: string}, + ) => {readonly prompt: string; readonly request: {readonly mode: string; readonly intent: string}; readonly observation: Record} | {readonly error: string}; + readonly clarify: ( + answer: string, + opts: {cwd: string; noLlm?: boolean; hostDispatcher?: (prompt: string) => Promise}, + ) => Promise<{ + readonly ok: boolean; + readonly error?: string; + readonly report?: unknown; + readonly source?: 'llm' | 'hybrid' | 'deterministic'; + }>; + readonly resolveReview: ( + targets: readonly string[], + opts: {cwd: string}, + ) => {readonly ok: boolean; readonly changed: boolean; readonly status?: string; readonly remaining?: readonly string[]; readonly error?: string}; } /** @@ -119,9 +174,16 @@ export function buildServer(opts: ServerOptions = {}): McpServer { const server = new McpServer( { name: opts.name ?? 'cladding', - version: opts.version ?? '0.8.3', + version: opts.version ?? '0.9.0', }, { + 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.', // Declare subscribe support so clients can subscribe to // cladding://audit and receive notifications/resources/updated // when new evidence lands. The wire-level handlers themselves @@ -132,7 +194,7 @@ export function buildServer(opts: ServerOptions = {}): McpServer { }, ); - registerTools(server, cwd); + registerTools(server, cwd, opts.onboarding); registerResources(server, cwd); registerPrompts(server, cwd); registerSubscribeHandlers(server); @@ -202,6 +264,19 @@ function loadSpecOrError(cwd: string): {readonly spec: Spec} | {readonly error: } } +/** Deterministic mutation boundary for a setup-only workspace. */ +function requireInitialized(cwd: string): string | null { + const loaded = loadSpecOrError(cwd); + if (!('error' in loaded)) return null; + return 'cladding: not_initialized — this project has host wiring but no valid spec.yaml; ' + + 'ordinary work must remain ordinary until the user explicitly requests Cladding initialization.'; +} + +function initializedMutationBoundary(cwd: string): {isError: true; content: Array<{type: 'text'; text: string}>} | null { + const error = requireInitialized(cwd); + return error ? {isError: true, content: [{type: 'text', text: error}]} : null; +} + /** Frozen wire field (F-570a3f): bump when a tool's payload shape changes. */ const PAYLOAD_SCHEMA_VERSION = 1; @@ -257,8 +332,7 @@ function recordServe( } } -/** Locate the engine's bin shim relative to this module — works in the dist - * bundle (dist/clad.js → ../bin/clad) and the dev tree (src/serve/ → ../../bin/clad). */ +/** Locates the CLI shim for legacy MCP tools that still wrap CLI verbs. */ function engineShim(): string | null { let dir = dirname(fileURLToPath(import.meta.url)); for (let i = 0; i < 5; i++) { @@ -266,10 +340,597 @@ function engineShim(): string | null { if (existsSync(candidate)) return candidate; dir = dirname(dir); } + const runningEntry = process.argv[1]; + return runningEntry && basename(runningEntry) === 'clad.js' && existsSync(runningEntry) + ? runningEntry + : null; +} + +const INTENT_FILE_EXTENSIONS = new Set(['.md', '.txt', '.yaml', '.yml', '.markdown']); + +/** + * Rejects ambiguous document paths and bytes before they reach the host model. + * + * @see spec/features/natural-language-init-0f4dd6.yaml AC-003 + */ +function projectIntentPath(cwd: string, requested: string): {path?: string; text?: string; error?: string} { + if (!requested.trim()) return {error: 'document_path is required for document mode'}; + if (isAbsolute(requested)) return {error: 'document_path must be relative to the connected project'}; + const root = realpathSync(resolve(cwd)); + const candidate = resolve(root, requested); + if (!existsSync(candidate)) return {error: `planning document not found: ${requested}`}; + let target: string; + try { + target = realpathSync(candidate); + } catch (error) { + return {error: `planning document could not be resolved: ${(error as Error).message}`}; + } + const rel = relative(root, target); + if (rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) { + return {error: 'planning document must stay inside the connected project'}; + } + if (!statSync(target).isFile()) return {error: 'planning document must be a regular file'}; + if (!INTENT_FILE_EXTENSIONS.has(extname(target).toLowerCase())) { + return {error: 'planning document must be .md, .txt, .yaml, .yml, or .markdown'}; + } + try { + const text = new TextDecoder('utf-8', {fatal: true}).decode(readFileSync(target)); + return {path: rel, text}; + } catch (error) { + return {error: `planning document is not readable UTF-8 text: ${(error as Error).message}`}; + } +} + +const hostDraftSchema = z.object({ + mode: z.enum(['greenfield', 'existing-adoption', 'mixed']), + project_context: z.object({why: z.string().min(1), problem: z.string().min(1), purpose: z.string().min(1)}), + capabilities: z.array(z.object({ + id: z.string().min(1), + title: z.string().min(1), + summary: z.string().min(1), + surface: z.enum(['feature', 'platform', 'tool', 'infrastructure']), + })).min(3).max(8), + architecture: z.object({layers: z.array(z.object({name: z.string().min(1), forbidden_imports: z.array(z.string())}))}), + scenarios: z.array(z.object({slug: z.string().min(1), title: z.string().min(1), flow: z.string().min(1)})).min(1).max(3), + questions: z.array(z.string().min(1)).max(3), + ai_hints: z.record(z.string(), z.unknown()).optional(), +}); +type HostDraft = z.infer; + +interface PreparedOnboarding { + readonly kind: 'init' | 'clarify'; + readonly snapshot: string; + readonly mode: 'idea' | 'document' | 'existing'; + readonly intent: string; + readonly answer?: string; + readonly refresh?: boolean; + /** Exact preview-bound phrase required at the destructive init boundary. */ + readonly approvalChallenge?: string; + /** Force scan when any source code was observed, including document-led adoption. */ + readonly scan?: boolean; +} + +const MAX_APPROVAL_ENVELOPE_BYTES = 1_000_000; +const PREPARATION_TTL_MS = 30 * 60 * 1000; + +/** + * Carries preparation state across host process restarts. + * + * The digest detects truncation/corruption; authorization still comes from the + * separately displayed exact challenge. Workspace freshness makes a consumed + * envelope stale after the first successful write. Prepare writes no authored + * project files, but it does persist a TTL'd consent-cache envelope: under the + * OS temp dir (owner-only 0600) until a draft is staged, then under the + * ignored `.cladding/host/onboarding-pending/`. + */ +function encodePreparedOnboarding(request: PreparedOnboarding): string { + const body = deflateRawSync(Buffer.from(JSON.stringify(request))).toString('base64url'); + const digest = createHash('sha256').update(body).digest('hex').slice(0, 24); + return `v1.${digest}.${body}`; +} + +function decodePreparedOnboarding(token: string): PreparedOnboarding | null { + const match = /^v1\.([a-f0-9]{24})\.([A-Za-z0-9_-]+)$/.exec(token); + if (!match) return null; + if (createHash('sha256').update(match[2]).digest('hex').slice(0, 24) !== match[1]) return null; + try { + const value = JSON.parse(inflateRawSync(Buffer.from(match[2], 'base64url'), { + maxOutputLength: MAX_APPROVAL_ENVELOPE_BYTES, + }).toString('utf8')) as PreparedOnboarding; + if ((value.kind !== 'init' && value.kind !== 'clarify') || typeof value.snapshot !== 'string' || typeof value.intent !== 'string') { + return null; + } + return value; + } catch { + return null; + } +} + +function pendingPreparationPath(cwd: string, key: string, durable = false): string { + const id = createHash('sha256').update(`${resolve(cwd)}\0${key}`).digest('hex'); + return durable + ? join(cwd, '.cladding', 'host', 'onboarding-pending', `${id}.json`) + : join(tmpdir(), 'cladding-onboarding-pending', `${id}.json`); +} + +/** + * Removes every expired consent-cache envelope in `dir`, not just the current + * key's: abandoned prepare flows used to leave 0600 envelopes behind until the + * next same-key load — on a shared machine the temp tier accumulated hundreds. + */ +function purgeExpiredPreparations(dir: string): void { + let names: string[]; + try { + names = readdirSync(dir); + } catch { + return; + } + for (const name of names) { + if (!name.endsWith('.json')) continue; + const path = join(dir, name); + try { + const parsed = JSON.parse(readFileSync(path, 'utf8')) as {expiresAt?: number}; + if (!parsed.expiresAt || parsed.expiresAt < Date.now()) rmSync(path, {force: true}); + } catch { + rmSync(path, {force: true}); + } + } +} + +function persistPendingPreparation( + cwd: string, + key: string, + token: string, + request: PreparedOnboarding, + draft?: HostDraft, +): void { + const path = pendingPreparationPath(cwd, key, draft != null); + mkdirSync(dirname(path), {recursive: true, mode: 0o700}); + purgeExpiredPreparations(dirname(path)); + writeFileSync(path, JSON.stringify({expiresAt: Date.now() + PREPARATION_TTL_MS, token, request, draft}), {mode: 0o600}); +} + +function loadPendingPreparation( + cwd: string, + key: string, +): {readonly token: string; readonly request: PreparedOnboarding; readonly draft?: HostDraft} | null { + for (const durable of [true, false]) { + const path = pendingPreparationPath(cwd, key, durable); + try { + const parsed = JSON.parse(readFileSync(path, 'utf8')) as { + expiresAt?: number; + token?: string; + request?: PreparedOnboarding; + draft?: HostDraft; + }; + if (!parsed.expiresAt || parsed.expiresAt < Date.now() || !parsed.token || !parsed.request) { + rmSync(path, {force: true}); + continue; + } + if (parsed.draft !== undefined) { + // The durable cache crosses process boundaries, so a staged draft is + // re-validated on load — a tampered/corrupted cache must surface as + // draft_required, never reach renderDraft (AC-014 extension). + const revalidated = hostDraftSchema.safeParse(parsed.draft); + if (!revalidated.success) { + rmSync(path, {force: true}); + continue; + } + return {token: parsed.token, request: parsed.request, draft: revalidated.data}; + } + return {token: parsed.token, request: parsed.request}; + } catch { + // Try the other cache tier. A missing durable cache is normal before staging. + } + } return null; } -function registerTools(server: McpServer, cwd: string): void { +function removePendingPreparation(cwd: string, key: string): void { + rmSync(pendingPreparationPath(cwd, key), {force: true}); + rmSync(pendingPreparationPath(cwd, key, true), {force: true}); +} + +/** Returns a short, one-time phrase that is easy for a human to verify and hard to pass accidentally. */ +function approvalChallenge(): string { + return `APPLY CLADDING ${randomUUID().slice(0, 6).toUpperCase()}`; +} + +function workspaceSnapshot(cwd: string): string { + const hash = createHash('sha256'); + const visit = (dir: string): void => { + if (!existsSync(dir)) return; + for (const entry of readdirSync(dir, {withFileTypes: true}).sort((a, b) => a.name.localeCompare(b.name))) { + if (entry.name === '.git' || entry.name === '.cladding' || entry.name === 'node_modules') continue; + const path = join(dir, entry.name); + const rel = relative(cwd, path); + if (entry.isDirectory()) visit(path); + else if (entry.isFile()) { + const stat = statSync(path); + hash.update(`${rel}\0${stat.size}\0${stat.mtimeMs}\n`); + } + } + }; + visit(cwd); + return hash.digest('hex'); +} + +/** Binds approval to authored files plus the active onboarding conversation. */ +function onboardingPreparationSnapshot(cwd: string): string { + const hash = createHash('sha256').update(workspaceSnapshot(cwd)); + const statePath = join(cwd, '.cladding', 'onboarding', 'state.yaml'); + hash.update(existsSync(statePath) ? readFileSync(statePath) : Buffer.from('absent')); + return hash.digest('hex'); +} + +const ONBOARDING_WRITE_ROOTS = [ + 'spec.yaml', '.gitignore', 'AGENTS.md', + 'docs/conventions.md', 'docs/project-context.md', + 'spec/architecture.yaml', 'spec/capabilities.yaml', 'spec/scenarios', + '.cladding/onboarding', '.cladding/scan', +] as const; + +interface OnboardingRollback { + readonly files: ReadonlyMap; + readonly directories: ReadonlySet; +} + +const FEATURE_TRANSACTION_ROOTS = [ + 'spec/features', 'spec/capabilities.yaml', 'spec/scenarios', + 'spec.yaml', 'spec/index.yaml', '.cladding/events.log.jsonl', +] as const; + +function capturePathRollback(cwd: string, roots: readonly string[]): OnboardingRollback { + const files = new Map(); + const directories = new Set(); + const visit = (relativePath: string): void => { + const path = join(cwd, relativePath); + if (!existsSync(path)) return; + const stat = statSync(path); + if (stat.isFile()) { + files.set(relativePath, readFileSync(path)); + return; + } + if (!stat.isDirectory()) return; + directories.add(relativePath); + for (const name of readdirSync(path)) visit(join(relativePath, name)); + }; + for (const root of roots) visit(root); + return {files, directories}; +} + +function restorePathRollback(cwd: string, roots: readonly string[], rollback: OnboardingRollback): void { + for (const root of roots) rmSync(join(cwd, root), {recursive: true, force: true}); + for (const directory of [...rollback.directories].sort((a, b) => a.length - b.length)) { + mkdirSync(join(cwd, directory), {recursive: true}); + } + for (const [relativePath, body] of rollback.files) { + mkdirSync(dirname(join(cwd, relativePath)), {recursive: true}); + writeFileSync(join(cwd, relativePath), body); + } +} + +/** Captures only paths the MCP onboarding core is allowed to mutate. */ +function captureOnboardingRollback(cwd: string): OnboardingRollback { + return capturePathRollback(cwd, ONBOARDING_WRITE_ROOTS); +} + +/** Restores the bounded onboarding surface after any failed multi-file apply. */ +function restoreOnboardingRollback(cwd: string, rollback: OnboardingRollback): void { + restorePathRollback(cwd, ONBOARDING_WRITE_ROOTS, rollback); +} + +function mcpPayload(payload: Record, isError = false): { + readonly isError?: boolean; + readonly structuredContent: Record; + readonly content: Array<{readonly type: 'text'; readonly text: string}>; +} { + return { + ...(isError ? {isError: true} : {}), + structuredContent: payload, + content: [{type: 'text', text: JSON.stringify(payload, null, 2)}], + }; +} + +function registerTools(server: McpServer, cwd: string, onboarding?: OnboardingOperations): void { + const prepared = new Map(); + let initializedToolsRegistered = false; + const registerInitialized = (): void => { + if (initializedToolsRegistered) return; + initializedToolsRegistered = true; + registerInitializedTools(server, cwd, prepared, onboarding); + }; + + server.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: z.enum(['idea', 'document', 'existing']), + intent: z.string().optional(), + document_path: z.string().optional(), + refresh: z.boolean().optional(), + }, + outputSchema: { + status: z.string(), changed: z.boolean(), schemaVersion: z.number().optional(), token: z.string().optional(), + prompt: z.string().optional(), request: z.object({mode: z.string(), intent: z.string()}).optional(), + observation: z.record(z.string(), z.unknown()).optional(), question: z.string().optional(), error: z.string().optional(), + plannedChanges: z.array(z.string()).optional(), confirmationQuestion: z.string().optional(), + requiresSeparateUserConfirmation: z.boolean().optional(), + approvalChallenge: z.string().optional(), + }, + annotations: {readOnlyHint: false, destructiveHint: false, idempotentHint: true}, + }, + async (args) => { + if (!onboarding) return mcpPayload({status: 'unavailable', changed: false}, true); + if (existsSync(join(cwd, 'spec.yaml')) && !args.refresh) { + return mcpPayload({status: 'already_initialized', changed: false}); + } + let intent = args.intent?.trim() ?? ''; + if (args.mode === 'idea' && !intent) { + return mcpPayload({status: 'needs_input', changed: false, question: 'What kind of project are you building?'}); + } + if (args.mode === 'document') { + const resolved = projectIntentPath(cwd, args.document_path ?? ''); + if (resolved.error) return mcpPayload({status: 'invalid_request', changed: false, error: resolved.error}, true); + intent = resolved.text!; + } + if (args.mode === 'existing' && !intent) intent = 'Adopt Cladding into the observed existing project.'; + const briefing = onboarding.prepareInit({cwd, mode: args.mode, intent}); + const challenge = approvalChallenge(); + const observedSourceCount = Number(briefing.observation.source_file_count ?? 0); + const request: PreparedOnboarding = { + kind: 'init', snapshot: onboardingPreparationSnapshot(cwd), mode: args.mode, intent, refresh: args.refresh, + approvalChallenge: challenge, + scan: args.mode === 'existing' || observedSourceCount > 0, + }; + const token = encodePreparedOnboarding(request); + prepared.set(token, request); + persistPendingPreparation(cwd, challenge, token, request); + return mcpPayload({ + status: 'needs_confirmation', changed: false, schemaVersion: 1, token, + prompt: briefing.prompt, request: briefing.request, observation: briefing.observation, + plannedChanges: args.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: ${challenge}`, + approvalChallenge: challenge, + requiresSeparateUserConfirmation: true, + }); + }, + ); + + server.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: z.string().min(1).max(MAX_APPROVAL_ENVELOPE_BYTES), + draft: hostDraftSchema, + }, + outputSchema: { + status: z.string(), changed: z.boolean(), approvalChallenge: z.string().optional(), + confirmationQuestion: z.string().optional(), error: z.string().optional(), + }, + annotations: {readOnlyHint: false, destructiveHint: false, idempotentHint: true}, + }, + async (args) => { + const request = prepared.get(args.token) ?? decodePreparedOnboarding(args.token); + if (!request || request.kind !== 'init' || !request.approvalChallenge) { + return mcpPayload({status: 'invalid_token', changed: false}, true); + } + if (request.snapshot !== onboardingPreparationSnapshot(cwd)) { + return mcpPayload({status: 'stale_preparation', changed: false}, true); + } + persistPendingPreparation(cwd, request.approvalChallenge, args.token, request, args.draft); + return mcpPayload({ + status: 'staged', + changed: false, + approvalChallenge: request.approvalChallenge, + confirmationQuestion: `To apply these changes, reply with the exact approval phrase: ${request.approvalChallenge}`, + }); + }, + ); + + server.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: z.string().min(1).max(MAX_APPROVAL_ENVELOPE_BYTES).optional(), + confirmation: z.string().regex(/^APPLY CLADDING [A-F0-9]{6}$/).describe( + 'The complete separate user reply, verbatim, including the APPLY CLADDING prefix', + ), + draft: hostDraftSchema.optional(), + }, + outputSchema: { + status: z.string(), changed: z.boolean(), created: z.array(z.string()).optional(), skipped: z.array(z.string()).optional(), + language: z.string().optional(), proposals: z.array(z.string()).optional(), clarifyingQuestions: z.array(z.string()).optional(), + onboardingMode: z.enum(['greenfield', 'existing-adoption', 'mixed']).optional(), onboardingSource: z.string().optional(), + nextQuestion: z.string().nullable().optional(), remainingQuestions: z.number().optional(), error: z.string().optional(), + confirmation: z.string().optional(), + }, + annotations: {readOnlyHint: false, destructiveHint: true, idempotentHint: false}, + }, + async (args) => { + const pending = loadPendingPreparation(cwd, args.confirmation.trim()); + const request = (args.token + ? prepared.get(args.token) ?? decodePreparedOnboarding(args.token) + : null) ?? pending?.request; + if (!request || request.kind !== 'init') return mcpPayload({status: 'invalid_token', changed: false}, true); + if (!request.approvalChallenge || args.confirmation.trim() !== request.approvalChallenge) { + return mcpPayload({ + status: 'confirmation_required', changed: false, + error: 'The exact one-time approval phrase shown in the preview is required.', + }, true); + } + if (request.snapshot !== onboardingPreparationSnapshot(cwd)) return mcpPayload({status: 'stale_preparation', changed: false}, true); + if (!onboarding) return mcpPayload({status: 'unavailable', changed: false}, true); + const draft = args.draft ?? pending?.draft; + if (!draft) { + return mcpPayload({ + status: 'draft_required', changed: false, + error: 'No staged onboarding draft is available. Prepare and stage the draft again before approval.', + }, true); + } + if (args.token) prepared.delete(args.token); + removePendingPreparation(cwd, args.confirmation.trim()); + const response = onboarding.renderDraft(draft); + const rollback = captureOnboardingRollback(cwd); + let init: Awaited>; + try { + init = await onboarding.initialize({ + cwd, intent: request.intent, scan: request.scan ? true : undefined, + hostDispatcher: async () => response, + }); + } catch (error) { + restoreOnboardingRollback(cwd, rollback); + return mcpPayload({ + status: 'failed', changed: false, + error: `Initialization failed; all onboarding files were restored: ${(error as Error).message}`, + }, true); + } + const questions = init.clarifyingQuestions ?? []; + const payload = { + status: questions.length > 0 ? 'needs_answers' : 'initialized', changed: true, + ...init, + onboardingSource: 'host', + confirmation: args.confirmation, + nextQuestion: questions[0] ?? null, + remainingQuestions: questions.length, + }; + registerInitialized(); + return mcpPayload(payload); + }, + ); + + if (existsSync(join(cwd, 'spec.yaml'))) registerInitialized(); +} + +/** + * Keeps ordinary development tool descriptions out of pre-init model context. + * + * @see spec/features/natural-language-init-0f4dd6.yaml AC-017 + */ +function registerInitializedTools( + server: McpServer, + cwd: string, + prepared: Map, + onboarding?: OnboardingOperations, +): void { + server.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: z.string().min(1)}, + outputSchema: { + status: z.string(), changed: z.boolean(), schemaVersion: z.number().optional(), token: z.string().optional(), + prompt: z.string().optional(), request: z.object({mode: z.string(), intent: z.string()}).optional(), + observation: z.record(z.string(), z.unknown()).optional(), error: z.string().optional(), + }, + annotations: {readOnlyHint: false, destructiveHint: false, idempotentHint: true}, + }, + async (args) => { + if (!onboarding) return mcpPayload({status: 'unavailable', changed: false}, true); + const briefing = onboarding.prepareClarify(args.answer, {cwd}); + if ('error' in briefing) return mcpPayload({status: 'invalid_state', changed: false, error: briefing.error}, true); + const request: PreparedOnboarding = { + kind: 'clarify', snapshot: onboardingPreparationSnapshot(cwd), mode: 'idea', intent: briefing.request.intent, answer: args.answer, + }; + const token = encodePreparedOnboarding(request); + prepared.set(token, request); + persistPendingPreparation(cwd, `clarify:${args.answer}`, token, request); + return mcpPayload({status: 'needs_host_draft', changed: false, schemaVersion: 1, token, prompt: briefing.prompt, request: briefing.request, observation: briefing.observation}); + }, + ); + + server.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: z.string().min(1).describe('The user\'s answer, verbatim'), + token: z.string().min(1).max(MAX_APPROVAL_ENVELOPE_BYTES).optional(), + draft: hostDraftSchema, + }, + outputSchema: { + status: z.string(), changed: z.boolean(), cwd: z.string().optional(), answered: z.unknown().optional(), + newQuestions: z.array(z.string()).optional(), mode: z.enum(['greenfield', 'existing-adoption', 'mixed']).nullable().optional(), + nextQuestion: z.string().nullable().optional(), remainingQuestions: z.number().optional(), refinementSource: z.string().optional(), + pendingReview: z.array(z.string()).optional(), + error: z.string().optional(), + }, + annotations: {readOnlyHint: false, destructiveHint: true, idempotentHint: false}, + }, + async (args) => { + const pending = loadPendingPreparation(cwd, `clarify:${args.answer}`); + const request = (args.token + ? prepared.get(args.token) ?? decodePreparedOnboarding(args.token) + : null) ?? pending?.request; + if (!request || request.kind !== 'clarify' || request.answer !== args.answer) return mcpPayload({status: 'invalid_token', changed: false}, true); + if (request.snapshot !== onboardingPreparationSnapshot(cwd)) return mcpPayload({status: 'stale_preparation', changed: false}, true); + if (!onboarding) return mcpPayload({status: 'unavailable', changed: false}, true); + if (args.token) prepared.delete(args.token); + removePendingPreparation(cwd, `clarify:${args.answer}`); + const response = onboarding.renderDraft(args.draft); + const outcome = await onboarding.clarify(args.answer, {cwd, hostDispatcher: async () => response}); + if (!outcome.ok) return mcpPayload({status: 'failed', changed: false, error: outcome.error ?? 'onboarding clarification failed'}, true); + return mcpPayload({...((outcome.report ?? {}) as object), changed: true, refinementSource: 'host'}); + }, + ); + + server.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: z.array(z.string()).min(1).describe('Exact active artifact paths returned in pendingReview.'), + }, + annotations: {readOnlyHint: false, destructiveHint: true, idempotentHint: false}, + }, + async (args) => { + if (!onboarding) return mcpPayload({status: 'unavailable', changed: false}, true); + const result = onboarding.resolveReview(args.targets, {cwd}); + return mcpPayload({ + status: result.status ?? (result.ok ? 'resolved' : 'failed'), + changed: result.changed, + remaining: result.remaining, + error: result.error, + }, !result.ok); + }, + ); + // clad_list_features — list features in the active spec. // v0.3.10 (F-085) — slug_substring + sort options. server.registerTool( @@ -293,6 +954,7 @@ function registerTools(server: McpServer, cwd: string): void { .optional() .describe("'alphabetical' (default — by id) or 'recent' (by file mtime, newest first)"), }, + annotations: {readOnlyHint: true, destructiveHint: false, idempotentHint: true}, }, async (args) => { const loaded = loadSpecOrError(cwd); @@ -337,6 +999,7 @@ function registerTools(server: McpServer, cwd: string): void { id: z.string().optional().describe('Feature id such as "F-049" or "F-a3f9c2"'), slug: z.string().optional().describe("Feature slug such as 'login-flow'"), }, + annotations: {readOnlyHint: true, destructiveHint: false, idempotentHint: true}, }, async (args) => { if (!args.id && !args.slug) { @@ -381,6 +1044,7 @@ function registerTools(server: McpServer, cwd: string): void { strict: z.boolean().optional().describe('Treat warnings as errors when true'), verbose: z.boolean().optional().describe('Return the full report (all findings incl. info + suggestions) instead of the terse top-3 summary'), }, + annotations: {readOnlyHint: true, destructiveHint: false, idempotentHint: true}, }, async (args) => { const result = runDrift({strict: args.strict, cwd}); @@ -882,9 +1546,35 @@ function registerTools(server: McpServer, cwd: string): void { 'Acceptance criteria authored now (ids auto-assigned AC-001…). Strongly ' + 'preferred over an empty feature — this is what makes the feature governable.', ), + design_impact: z.discriminatedUnion('classification', [ + z.object({ + classification: z.literal('none'), + rationale: z.string().min(1), + }), + z.object({ + classification: z.literal('additive'), + rationale: z.string().min(1), + capability: z.string().regex(/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/), + capability_title: z.string().min(1).optional(), + scenario: z.string().min(1).optional(), + }), + z.object({ + classification: z.literal('structural'), + rationale: z.string().min(1), + artifacts: z.array(z.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 (args) => { + const boundary = initializedMutationBoundary(cwd); + if (boundary) return boundary; + const rollback = capturePathRollback(cwd, FEATURE_TRANSACTION_ROOTS); try { const result = createFeature({ slug: args.slug, @@ -892,24 +1582,58 @@ function registerTools(server: McpServer, cwd: string): void { status: args.status, modules: args.modules, acceptance_criteria: args.acceptance_criteria, + design_impact: args.design_impact + ? { + classification: args.design_impact.classification, + rationale: args.design_impact.rationale, + artifacts: args.design_impact.classification === 'structural' + ? args.design_impact.artifacts + : undefined, + } + : undefined, cwd, }); + if (args.design_impact?.classification === 'additive') { + linkCapability({ + capability: args.design_impact.capability, + feature: result.id, + title: args.design_impact.capability_title, + cwd, + }); + if (args.design_impact.scenario) { + linkScenario({scenario: args.design_impact.scenario, feature: result.id, cwd}); + } + } syncInventory(cwd); // Non-mutating firing-path nudge: travels as a `hint` FIELD (keeps the // payload valid JSON), never a silent write to capabilities.yaml. + const designImpact = args.design_impact; const withHint = { schema_version: PAYLOAD_SCHEMA_VERSION, ...result, gate: gateFooter(cwd), - hint: - 'If this feature is user-facing, link it to a capability with clad_link_capability ' + - `(capability: , feature: ${result.id}) so the Tier-B design SSoT grows with ` + - 'development instead of being left an empty seed.', + ...(designImpact + ? { + designImpact: designImpact.classification === 'structural' + ? { + status: 'review_required', + artifacts: designImpact.artifacts, + next: 'Preview and apply the listed Tier-B design changes, then call clad_resolve_design_impact.', + } + : {status: 'resolved', classification: designImpact.classification}, + } + : { + hint: + 'If this feature is user-facing, link it to a capability with clad_link_capability ' + + `(capability: , feature: ${result.id}) so the Tier-B design SSoT grows with ` + + 'development instead of being left an empty seed.', + }), }; return { content: [{type: 'text', text: JSON.stringify(withHint, null, 2)}], }; } catch (err) { + restorePathRollback(cwd, FEATURE_TRANSACTION_ROOTS, rollback); return { isError: true, content: [{type: 'text', text: (err as Error).message}], @@ -918,6 +1642,34 @@ function registerTools(server: McpServer, cwd: string): void { }, ); + server.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: z.string().describe('Feature id whose listed Tier-B design changes are now applied.'), + }, + }, + async (args) => { + const boundary = initializedMutationBoundary(cwd); + if (boundary) return boundary; + try { + const result = resolveDesignImpact({feature: args.feature, cwd}); + syncInventory(cwd); + return {content: [{type: 'text', text: JSON.stringify({ + schema_version: PAYLOAD_SCHEMA_VERSION, + ...result, + gate: gateFooter(cwd), + }, null, 2)}]}; + } catch (error) { + return {isError: true, content: [{type: 'text', text: (error as Error).message}]}; + } + }, + ); + // clad_author_oracle — record a host-authored impl-blind oracle + its // provenance (Phase 2). cladding authors NO LLM call: the host runs // `clad oracle` for the spec-only brief, dispatches a blind sub-agent, then @@ -946,6 +1698,8 @@ function registerTools(server: McpServer, cwd: string): void { }, }, async (args) => { + const boundary = initializedMutationBoundary(cwd); + if (boundary) return boundary; try { const result = recordOracle({ featureId: args.featureId, @@ -1013,6 +1767,8 @@ function registerTools(server: McpServer, cwd: string): void { }, }, async (args) => { + const boundary = initializedMutationBoundary(cwd); + if (boundary) return boundary; try { const result = createScenario({ slug: args.slug, @@ -1066,6 +1822,8 @@ function registerTools(server: McpServer, cwd: string): void { }, }, async (args) => { + const boundary = initializedMutationBoundary(cwd); + if (boundary) return boundary; try { const result = linkCapability({ capability: args.capability, diff --git a/src/spec/new.ts b/src/spec/new.ts index dd5e0473..c337af49 100644 --- a/src/spec/new.ts +++ b/src/spec/new.ts @@ -20,7 +20,7 @@ // @see spec/features/F-084.yaml — this feature. import {createHash} from 'node:crypto'; -import {existsSync, mkdirSync, readFileSync, writeFileSync} from 'node:fs'; +import {existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync} from 'node:fs'; import {recordEvent} from '../events/log.js'; import {hostname, userInfo} from 'node:os'; @@ -76,6 +76,12 @@ export interface CreateFeatureOptions { readonly modules?: readonly string[]; /** Acceptance criteria authored at creation. Omitted → `acceptance_criteria: []`. */ readonly acceptance_criteria?: readonly AcceptanceCriterionInput[]; + /** Optional durable Tier-B impact decision for hosts that support the richer authoring path. */ + readonly design_impact?: { + readonly classification: 'none' | 'additive' | 'structural'; + readonly rationale: string; + readonly artifacts?: readonly string[]; + }; /** Project root. Defaults to `.`. */ readonly cwd?: string; } @@ -91,6 +97,80 @@ export interface CreateFeatureResult { readonly note?: string; } +export interface ResolveDesignImpactResult { + readonly feature: string; + readonly changed: boolean; + readonly path: string; +} + +/** Adds a feature to an existing scenario without changing its authored prose. */ +export function linkScenario(opts: {readonly scenario: string; readonly feature: string; readonly cwd?: string}): string { + const cwd = opts.cwd ?? '.'; + const directory = join(cwd, 'spec', 'scenarios'); + if (!existsSync(directory)) throw new Error(`cladding: unknown scenario '${opts.scenario}'`); + for (const name of readdirSync(directory)) { + if (!name.endsWith('.yaml') && !name.endsWith('.yml')) continue; + const path = join(directory, name); + const body = readFileSync(path, 'utf8'); + const parsed = yaml.parse(body) as {id?: string; slug?: string; features?: string[]}; + if (parsed?.id !== opts.scenario && parsed?.slug !== opts.scenario) continue; + if (parsed.features?.includes(opts.feature)) return path; + let next: string; + if (/^features:\s*\[\]\s*$/m.test(body)) { + next = body.replace(/^features:\s*\[\]\s*$/m, `features:\n - ${opts.feature}`); + } else if (/^features:\s*$/m.test(body)) { + next = body.replace(/^(features:\s*\n(?:\s+-[^\n]*\n)*)/m, `$1 - ${opts.feature}\n`); + } else { + next = `${body.replace(/\n?$/, '\n')}features:\n - ${opts.feature}\n`; + } + writeFileSync(path, next, 'utf8'); + return path; + } + throw new Error(`cladding: unknown scenario '${opts.scenario}'`); +} + +/** Marks a reviewed structural design impact resolved without rewriting the shard. */ +export function resolveDesignImpact(opts: {readonly feature: string; readonly cwd?: string}): ResolveDesignImpactResult { + const cwd = opts.cwd ?? '.'; + const directory = join(cwd, 'spec', 'features'); + if (!existsSync(directory)) throw new Error(`cladding: unknown feature '${opts.feature}'`); + for (const name of readdirSync(directory)) { + if (!name.endsWith('.yaml') && !name.endsWith('.yml')) continue; + const path = join(directory, name); + const body = readFileSync(path, 'utf8'); + const parsed = yaml.parse(body) as {id?: string; design_impact?: { + classification?: string; + status?: string; + artifacts?: string[]; + baseline_digests?: Record; + }}; + if (parsed?.id !== opts.feature) continue; + if (parsed.design_impact?.classification !== 'structural') { + throw new Error('cladding: only a structural design impact requires explicit resolution'); + } + if (parsed.design_impact.status === 'resolved') return {feature: opts.feature, changed: false, path}; + const unchanged = (parsed.design_impact.artifacts ?? []).filter((relativePath) => { + const artifact = join(cwd, relativePath); + const current = existsSync(artifact) + ? createHash('sha256').update(readFileSync(artifact)).digest('hex') + : 'absent'; + return current === parsed.design_impact?.baseline_digests?.[relativePath]; + }); + if (unchanged.length > 0) { + throw new Error(`cladding: design impact is not resolved — unchanged artifact(s): ${unchanged.join(', ')}`); + } + const next = body.replace( + /(design_impact:\n(?:(?: .*\n)*?) status:\s*)review_required\b/, + '$1resolved', + ); + if (next === body) throw new Error('cladding: malformed structural design_impact block'); + writeFileSync(path, next, 'utf8'); + recordEvent(cwd, 'design_impact_resolved', {feature: opts.feature}); + return {feature: opts.feature, changed: true, path}; + } + throw new Error(`cladding: unknown feature '${opts.feature}'`); +} + /** * Creates a new sharded feature file at `spec/features/-.yaml` * where `` is the 6-char hex tail of the auto-generated id. @@ -156,6 +236,18 @@ export function createFeature(opts: CreateFeatureOptions): CreateFeatureResult { // and the PreToolUse hand-flip hook entirely. Downgrade with a visible note. const requestedDone = opts.status === 'done'; const status = requestedDone ? 'in_progress' : (opts.status ?? 'planned'); + const designImpact = opts.design_impact?.classification === 'structural' + ? { + ...opts.design_impact, + baseline_digests: Object.fromEntries((opts.design_impact.artifacts ?? []).map((relativePath) => { + const artifact = join(cwd, relativePath); + const digest = existsSync(artifact) + ? createHash('sha256').update(readFileSync(artifact)).digest('hex') + : 'absent'; + return [relativePath, digest]; + })), + } + : opts.design_impact; const yaml = renderYaml({ id, slug, @@ -163,6 +255,7 @@ export function createFeature(opts: CreateFeatureOptions): CreateFeatureResult { status, modules: opts.modules, acceptance_criteria: opts.acceptance_criteria, + design_impact: designImpact, }); writeFileSync(filePath, yaml, 'utf8'); // F-b84c38 — spec authorship lands in the ledger (best-effort). @@ -201,6 +294,9 @@ function renderYaml(args: { status: string; modules?: readonly string[]; acceptance_criteria?: readonly AcceptanceCriterionInput[]; + design_impact?: CreateFeatureOptions['design_impact'] & { + readonly baseline_digests?: Readonly>; + }; }): string { const lines = [ `id: ${args.id}`, @@ -239,6 +335,22 @@ function renderYaml(args: { }); } + if (args.design_impact) { + lines.push('design_impact:'); + lines.push(` classification: ${args.design_impact.classification}`); + lines.push(` rationale: ${JSON.stringify(args.design_impact.rationale)}`); + lines.push(` status: ${args.design_impact.classification === 'structural' ? 'review_required' : 'resolved'}`); + const artifacts = args.design_impact.artifacts ?? []; + if (artifacts.length === 0) lines.push(' artifacts: []'); + else lines.push(` artifacts: [${artifacts.map((path) => JSON.stringify(path)).join(', ')}]`); + if (args.design_impact.baseline_digests && Object.keys(args.design_impact.baseline_digests).length > 0) { + lines.push(' baseline_digests:'); + for (const [path, digest] of Object.entries(args.design_impact.baseline_digests)) { + lines.push(` ${JSON.stringify(path)}: ${JSON.stringify(digest)}`); + } + } + } + lines.push(''); return lines.join('\n'); } diff --git a/src/spec/schema.json b/src/spec/schema.json index 9a588552..6092fd53 100644 --- a/src/spec/schema.json +++ b/src/spec/schema.json @@ -18,6 +18,10 @@ "properties": { "name": {"type": "string", "minLength": 1}, "language": {"type": "string", "minLength": 1}, + "onboarding_seeded": { + "type": "boolean", + "description": "True only when Cladding init authored the initial governance seeds. Used to scope early-project advisory findings without changing legacy-project behavior." + }, "description": { "type": "string", "description": "One-line summary of what the project is for. Used as the spec.yaml 'front door' hint." @@ -194,6 +198,18 @@ "type": "array", "items": {"$ref": "#/definitions/acceptance_criterion"} }, + "design_impact": { + "type": "object", + "required": ["classification", "rationale", "status"], + "additionalProperties": false, + "properties": { + "classification": {"type": "string", "enum": ["none", "additive", "structural"]}, + "rationale": {"type": "string", "minLength": 1}, + "status": {"type": "string", "enum": ["resolved", "review_required"]}, + "artifacts": {"type": "array", "items": {"type": "string"}}, + "baseline_digests": {"type": "object", "additionalProperties": {"type": "string"}} + } + }, "depends_on": { "type": "array", "items": {"type": "string", "pattern": "^F-(\\d{3,}|[a-f0-9]{6,})$"} diff --git a/src/spec/types.ts b/src/spec/types.ts index 11cdf8a3..50475141 100644 --- a/src/spec/types.ts +++ b/src/spec/types.ts @@ -94,6 +94,14 @@ export interface Feature { /** File paths this feature touches. */ readonly modules?: readonly string[]; readonly acceptance_criteria?: readonly AcceptanceCriterion[]; + /** Feature-bound decision recording whether Tier-B design must evolve. */ + readonly design_impact?: { + readonly classification: 'none' | 'additive' | 'structural'; + readonly rationale: string; + readonly status: 'resolved' | 'review_required'; + readonly artifacts?: readonly string[]; + readonly baseline_digests?: Readonly>; + }; /** Feature ids this one depends on. */ readonly depends_on?: readonly string[]; readonly archived_at?: string; @@ -292,6 +300,12 @@ export interface SmokeProbe { export interface Project { readonly name: string; readonly language: string; + /** + * True only for workspaces scaffolded by Cladding onboarding. Detectors use + * this durable marker to distinguish intentional future-design seeds from + * empty governance in legacy or hand-authored projects. + */ + readonly onboarding_seeded?: boolean; /** * One-line summary of what the project is for. Renders as the * spec.yaml "front door" hint. Optional — kept opt-in so legacy diff --git a/src/stages/README.md b/src/stages/README.md index 4974bb27..6bfaaab3 100644 --- a/src/stages/README.md +++ b/src/stages/README.md @@ -42,12 +42,12 @@ Ironclad iron-law stage implementations. One module per stage. Shared types in ` | stage | file | pass criteria (Ironclad spec) | determinism | default tool | |---|---|---|---|---| | stage_1.1 Type | `type.ts` | type checker exit 0, no errors | deterministic | polyglot chain (TS→tsc · Py→mypy · Rust→cargo check · …) | -| stage_1.2 Lint | `lint.ts` | linter exit 0, no errors | deterministic | polyglot chain (TS→eslint · Py→ruff · Rust→clippy · …) | +| stage_1.2 Lint | `lint.ts` | linter exit 0, no errors | deterministic | project script/config, then polyglot chain (TS→eslint/biome/oxlint · Py→ruff · …) | | stage_1.3 Drift (core) | `drift.ts` | zero error-severity findings | deterministic | plug-in registry (1/19 detector wired) | | stage_1.4 Commit | `commit.ts` | working tree + index both clean | deterministic | `git status --porcelain` (language-agnostic) | | stage_1.5 Arch | `arch.ts` | no architecture rule violations | deterministic | toolchain chain (TS→madge --circular · Python→lint-imports) | | stage_1.6 Secret | `secret.ts` | no hardcoded secrets in tracked code | deterministic | toolchain chain (TS→secretlint · others→gitleaks) | -| stage_2.1 Unit | `unit.ts` | unit-test runner exit 0 | deterministic | toolchain chain (TS→vitest · Python→pytest · Rust→cargo test · …) | +| stage_2.1 Unit | `unit.ts` | runner exit 0 and, under strict mode, a non-zero executed-test count | deterministic | project script, then toolchain chain (TS→vitest/jest · Python→pytest · …) | ## [INTERFACE] @@ -122,6 +122,12 @@ Output: one-line JSON on stdout, exit code matches stage result. Runtime: zero. Each stage module defers heavy lifting to the project's own toolchain (resolved by `toolchain/detect.ts`). +For TypeScript/JavaScript projects, an explicit `scripts.lint` or a non-Jest/Vitest +`scripts.test` is authoritative. Cladding invokes that npm workflow verbatim; +it does not substitute ESLint or Vitest. Coverage is registered for a custom +test runner only when `scripts.coverage` exists. An undeclared lint or coverage +workflow is reported as skipped, not guessed from the presence of package.json. + ## [POLYGLOT] Cladding is language-agnostic. Stages `type`, `lint`, `test`, `coverage`, `secret` resolve the actual tool by scanning the project for a recognized manifest, in priority order: diff --git a/src/stages/cov.ts b/src/stages/cov.ts index 3753d933..7b7afff5 100644 --- a/src/stages/cov.ts +++ b/src/stages/cov.ts @@ -46,7 +46,7 @@ export function runCov(opts: CommandStageOptions = {}): StageResult { const proc = shared ? shared.proc : execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing tool skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The tool RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/stages/detectors/README.md b/src/stages/detectors/README.md index 870a8c4b..aff64994 100644 --- a/src/stages/detectors/README.md +++ b/src/stages/detectors/README.md @@ -38,13 +38,13 @@ ironclad_spec_ref: https://github.com/qwerfunch/ironclad/blob/main/detectors.sch | 23 | `SLUG_CONFLICT` *(cladding extension)* | within-spec | `slug-conflict.ts` | error | blind | | 24 | `AC_DUPLICATE_WITHIN_FEATURE` *(cladding extension)* | within-spec | `ac-duplicate-within-feature.ts` | error | blind | | 25 | `ARCHITECTURE_FROM_SPEC` *(cladding extension, v0.3.13)* | spec ↔ code | `architecture-from-spec.ts` | graduated (error / warn) | blind | -| 26 | `CAPABILITIES_FEATURE_MAPPING` *(cladding extension)* | spec ↔ spec | `capabilities-feature-mapping.ts` | graduated (error / warn / info) | blind | +| 26 | `CAPABILITIES_FEATURE_MAPPING` *(cladding extension)* | spec ↔ spec | `capabilities-feature-mapping.ts` | graduated (error / grown warn / info) | blind | | 27 | `AI_HINTS_FORBIDDEN_PATTERN` *(cladding extension, v0.3.57)* | spec ↔ code | `ai-hints-forbidden-pattern.ts` | error | blind | | 28 | `INVENTORY_DRIFT` *(cladding extension, v0.4.x)* | spec ↔ spec | `inventory-drift.ts` | error | blind | | 29 | `PLANNED_BACKLOG` *(cladding extension, v0.4.x)* | spec ↔ code | `planned-backlog.ts` | warn | **aware** *(planned-state)* | | 30 | `HOLLOW_GOVERNANCE` *(cladding extension, v0.4.x)* | spec ↔ spec | `hollow-governance.ts` | warn | blind *(scale-gated)* | | 31 | `DEPENDENCY_CYCLE` *(cladding extension, v0.4.x)* | spec ↔ spec | `dependency-cycle.ts` | error | blind | -| 32 | `SCENARIO_COVERAGE` *(cladding extension, v0.4.x)* | spec ↔ spec | `scenario-coverage.ts` | warn | blind *(scale-gated)* | +| 32 | `SCENARIO_COVERAGE` *(cladding extension, v0.4.x)* | spec ↔ spec | `scenario-coverage.ts` | grown warn / early info | blind *(scale-gated)* | | 33 | `PROJECT_CONTEXT_DRIFT` *(cladding extension, v0.4.x)* | spec ↔ doc | `project-context-drift.ts` | warn | blind *(scale-gated)* | | 34 | `SPEC_CONFORMANCE` *(cladding extension, v0.5.x)* | spec ↔ test | `spec-conformance.ts` | error | **aware** *(done-direction)* | | 35 | `DELIVERABLE_INTEGRITY` *(cladding extension, v0.5.x)* | spec ↔ code | `deliverable-integrity.ts` | error/warn | **aware** *(done-direction)* | diff --git a/src/stages/detectors/capabilities-feature-mapping.ts b/src/stages/detectors/capabilities-feature-mapping.ts index 5ff82c02..fa697181 100644 --- a/src/stages/detectors/capabilities-feature-mapping.ts +++ b/src/stages/detectors/capabilities-feature-mapping.ts @@ -14,11 +14,11 @@ // typo or a feature that was deleted without updating the // capability registry. // -// 2. **Orphan capability (warn)** — a capability whose `features[]` -// is empty (or missing) is not yet bound to any feature. -// Acceptable during early onboarding (clad init may emit -// capability stubs before features land), but should be -// resolved before release. +// 2. **Orphan capability (graduated)** — a capability whose `features[]` +// is empty (or missing) is not yet bound to any feature. Intent-aware +// onboarding deliberately emits future capability seeds before features +// land. An explicit onboarding marker scopes information-level grace to +// those seeds; every unmarked project retains the warning at any size. // // 3. **Unmapped feature (info)** — a feature in spec.yaml that no // capability claims via its `features[]`. Acceptable for @@ -45,6 +45,9 @@ import type {CommandStageOptions, DriftDetector, DriftFinding} from '../types.js const NAME = 'CAPABILITIES_FEATURE_MAPPING'; +/** Shared maturity boundary for explicitly marked onboarding design seeds. */ +export const DEFAULT_MIN_FEATURES_FOR_CAPABILITY_BINDINGS = 8; + interface CapabilityEntry { readonly id: string; readonly title?: string; @@ -80,9 +83,11 @@ function run(opts: CommandStageOptions): readonly DriftFinding[] { // separately; CAPABILITIES_FEATURE_MAPPING just exits silently when it // cannot load. let featureIds: Set; + let onboardingSeeded = false; try { const spec = loadSpec(cwd); featureIds = new Set(spec.features.map((f) => f.id)); + onboardingSeeded = spec.project.onboarding_seeded === true; } catch { // Load-failure policy (see detectors/with-spec.ts): within-spec-validity // detector — no spec means no capability↔feature links to validate; @@ -92,6 +97,8 @@ function run(opts: CommandStageOptions): readonly DriftFinding[] { const findings: DriftFinding[] = []; const featuresClaimedByCapabilities = new Set(); + const onboardingGrace = + onboardingSeeded && featureIds.size < DEFAULT_MIN_FEATURES_FOR_CAPABILITY_BINDINGS; for (const cap of capabilities) { if (typeof cap !== 'object' || cap === null) continue; @@ -101,11 +108,13 @@ function run(opts: CommandStageOptions): readonly DriftFinding[] { if (features.length === 0) { findings.push({ detector: NAME, - severity: 'warn', + severity: onboardingGrace ? 'info' : 'warn', path: 'spec/capabilities.yaml', - message: - `capability "${capId}" has no features mapped — bind at least one feature via the features[] field, ` + - `or remove the capability if it's no longer relevant`, + message: onboardingGrace + ? `capability "${capId}" has no features mapped yet — retained as future onboarding intent; ` + + `bind it when a matching feature lands` + : `capability "${capId}" has no features mapped — bind at least one feature via the features[] field, ` + + `or remove the capability if it's no longer relevant`, }); continue; } diff --git a/src/stages/detectors/deliverable-integrity.ts b/src/stages/detectors/deliverable-integrity.ts index 612aeb3d..13524848 100644 --- a/src/stages/detectors/deliverable-integrity.ts +++ b/src/stages/detectors/deliverable-integrity.ts @@ -4,11 +4,13 @@ // — it NEVER executes anything (that is the stage's job). Two checks, done-only: // - project.deliverable.path declared but ABSENT on disk → error (blocking): a // project that has shipped a `done` feature must have its declared entry present. -// - done features ship modules[] but NO project.deliverable is declared → warn: +// - done features ship modules[] but NO project.deliverable is declared → warn, +// with info-level grace only for explicitly marked onboarding seeds before +// the shared eight-feature maturity boundary: // the gate cannot smoke-test the shipped entry, so a broken entry could ship -// green (the Mini-Lang S5 failure). Warn (not error) keeps it advisory — legacy -// projects without a declared deliverable are not retro-failed — while ensuring -// silencing the smoke (omitting the declaration) always leaves an auditable signal. +// green (the Mini-Lang S5 failure). The graduated signal keeps early +// domain/library slices completable while ensuring a grown project's omitted +// smoke decision remains auditable and strict-gate actionable. // // BOUNDARY: presence/absence only. Whether the entry RUNS is stage_2.4; whether it // is CORRECT per spec is the impl-blind oracle (stage_2.3). @@ -22,6 +24,9 @@ import {withSpec} from './with-spec.js'; const NAME = 'DELIVERABLE_INTEGRITY'; +/** Shared maturity boundary for explicitly marked onboarding slices. */ +export const DEFAULT_MIN_FEATURES_FOR_DELIVERABLE = 8; + function runDeliverableIntegrity(opts: CommandStageOptions): readonly DriftFinding[] { const {cwd = '.'} = opts; return withSpec(cwd, NAME, (spec) => detect(spec, cwd)); @@ -32,10 +37,13 @@ function detect(spec: Spec, cwd: string): readonly DriftFinding[] { const doneWithModules = spec.features.filter((f) => f.status === 'done' && (f.modules?.length ?? 0) > 0); if (!deliverable) { if (doneWithModules.length === 0) return []; + const onboardingGrace = + spec.project.onboarding_seeded === true && + spec.features.length < DEFAULT_MIN_FEATURES_FOR_DELIVERABLE; return [ { detector: NAME, - severity: 'warn', + severity: onboardingGrace ? 'info' : 'warn', message: `${doneWithModules.length} done feature(s) ship modules but project.deliverable is not declared — ` + 'the gate cannot smoke-test the shipped entry, so a broken entry point could ship green. ' + diff --git a/src/stages/detectors/scenario-coverage.ts b/src/stages/detectors/scenario-coverage.ts index af760eca..6fa50255 100644 --- a/src/stages/detectors/scenario-coverage.ts +++ b/src/stages/detectors/scenario-coverage.ts @@ -12,8 +12,9 @@ // scenarios, warn: a non-trivial product with zero captured cross-feature // flows is under-specified. (status-blind on total feature count, like // HOLLOW_GOVERNANCE — the gap appeared on all-`done` builds.) -// 2. UNCONDITIONAL HOLLOW — a scenario whose `features[]` is empty is hollow (it -// claims to cover a flow but binds nothing), warn regardless of size. +// 2. GRADUATED HOLLOW — onboarding intentionally creates future journeys with +// empty `features[]`. Explicitly marked seeds are info while small, then +// warn at the maturity threshold; unmarked projects always retain warn. // 3. UNDER-BOUND — a scenario whose `flow` names a feature by its slug (the // `(feature-slug)` convention) that it doesn't bind in `features[]`, so its // declared coverage under-states the flow it walks. Exact-slug match only, so @@ -30,7 +31,7 @@ import {withSpec} from './with-spec.js'; const NAME = 'SCENARIO_COVERAGE'; -/** Below this feature count a project may legitimately have no scenarios yet. */ +/** Below this count explicitly marked onboarding scenarios receive grace. */ export const DEFAULT_MIN_FEATURES_FOR_SCENARIOS = 8; function runScenarioCoverage(opts: CommandStageOptions): readonly DriftFinding[] { @@ -42,6 +43,8 @@ function detect(spec: Spec): readonly DriftFinding[] { const findings: DriftFinding[] = []; const featureCount = spec.features.length; const scenarios = spec.scenarios ?? []; + const isGrown = featureCount >= DEFAULT_MIN_FEATURES_FOR_SCENARIOS; + const onboardingGrace = spec.project.onboarding_seeded === true && !isGrown; // 1. Grown project with no cross-feature flows captured. if (featureCount >= DEFAULT_MIN_FEATURES_FOR_SCENARIOS && scenarios.length === 0) { @@ -55,16 +58,19 @@ function detect(spec: Spec): readonly DriftFinding[] { }); } - // 2. A scenario that binds no features is hollow (claims a flow, covers nothing). + // 2. A marked empty onboarding scenario is future design until the project + // grows; unmarked scenarios preserve the established strict-mode warning. for (const s of scenarios) { if ((s.features ?? []).length === 0) { findings.push({ detector: NAME, - severity: 'warn', + severity: onboardingGrace ? 'info' : 'warn', path: 'spec/scenarios/', - message: - `scenario ${s.id} binds no features (features: []) — a scenario must cover at least ` + - "one feature's flow, or it should be removed.", + message: onboardingGrace + ? `scenario ${s.id} binds no features yet — retained as future onboarding intent; ` + + 'bind it when a matching feature lands.' + : `scenario ${s.id} binds no features (features: []) — a scenario must cover at least ` + + "one feature's flow, or it should be removed.", }); } } diff --git a/src/stages/detectors/unverified-ac.ts b/src/stages/detectors/unverified-ac.ts index 6de2abbb..adff630e 100644 --- a/src/stages/detectors/unverified-ac.ts +++ b/src/stages/detectors/unverified-ac.ts @@ -18,38 +18,25 @@ // - a test_ref ABSENT from a present report → `warn` (a partial/scoped run is // legitimate; --strict promotes it). Status policy: done features only. -import {existsSync, readFileSync} from 'node:fs'; -import {join} from 'node:path'; +import {readFileSync} from 'node:fs'; import type {Spec} from '../../spec/types.js'; import {parseJUnitReport, lookupTestRef, isPathLike, type JUnitReport} from '../junit-report.js'; -import {readGateConfig} from '../toolchain/gate-config.js'; +import {resolveTestReportPath} from '../toolchain/gate-config.js'; import type {CommandStageOptions, DriftDetector, DriftFinding} from '../types.js'; import {withSpec} from './with-spec.js'; const NAME = 'UNVERIFIED_AC'; // Same non-file pseudo-refs UNTESTED_AC skips — they carry no observable test. const SKIPPABLE_PREFIXES = ['self-dogfood:', 'fixture:', 'derived:']; -// Tried in order when `gate.test_report` is unset; first existing one wins. -const DEFAULT_REPORT_CANDIDATES = ['test-report.junit.xml', join('coverage', 'junit.xml'), join('.cladding', 'test-report.junit.xml')]; function isSkippable(ref: string): boolean { return SKIPPABLE_PREFIXES.some((p) => ref.startsWith(p)); } -/** Resolve the JUnit report path: explicit config first, then conventions. Null = none present. */ -function resolveReportPath(cwd: string): string | null { - const configured = readGateConfig(cwd).testReport; - if (configured) return existsSync(join(cwd, configured)) ? join(cwd, configured) : null; - for (const candidate of DEFAULT_REPORT_CANDIDATES) { - if (existsSync(join(cwd, candidate))) return join(cwd, candidate); - } - return null; -} - function runUnverifiedAc(opts: CommandStageOptions): readonly DriftFinding[] { const {cwd = '.'} = opts; - const reportPath = resolveReportPath(cwd); + const reportPath = resolveTestReportPath(cwd); if (!reportPath) return []; // graceful skip — no report to verify against let report: JUnitReport; try { diff --git a/src/stages/lint.ts b/src/stages/lint.ts index 3c7ceb80..9c51e235 100644 --- a/src/stages/lint.ts +++ b/src/stages/lint.ts @@ -54,7 +54,7 @@ export function runLint(opts: CommandStageOptions = {}): StageResult { const proc = execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing tool skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The tool RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/stages/perf.ts b/src/stages/perf.ts index aa5134ca..2d83c91c 100644 --- a/src/stages/perf.ts +++ b/src/stages/perf.ts @@ -38,7 +38,7 @@ export function runPerf(opts: CommandStageOptions = {}): StageResult { const proc = execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing runner skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The runner RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/stages/smoke.ts b/src/stages/smoke.ts index 76b9155a..77266e10 100644 --- a/src/stages/smoke.ts +++ b/src/stages/smoke.ts @@ -43,7 +43,7 @@ export function runSmoke(opts: CommandStageOptions = {}): StageResult { const proc = execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing runner skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The runner RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/stages/spec-conformance.ts b/src/stages/spec-conformance.ts index 2265988a..80a397cb 100644 --- a/src/stages/spec-conformance.ts +++ b/src/stages/spec-conformance.ts @@ -18,13 +18,23 @@ // enforced separately by the SPEC_CONFORMANCE drift detector, so this stage // never false-passes by silence — it only reports on oracles that exist. -import {existsSync, readdirSync} from 'node:fs'; +import { + chmodSync, + existsSync, + readFileSync, + readdirSync, + statSync, + unlinkSync, + utimesSync, + writeFileSync, +} from 'node:fs'; import {join} from 'node:path'; import process from 'node:process'; import {execaSync} from 'execa'; import {detectToolchain} from './toolchain/detect.js'; +import {testReportCandidatePaths} from './toolchain/gate-config.js'; import type {CommandStageOptions, StageResult} from './types.js'; import {missingToolSkip, ranToolResult} from './util.js'; @@ -32,6 +42,62 @@ const STAGE = 'stage_2.3'; /** Where spec-derived oracle suites live (relative to project root). */ export const ORACLE_DIR = 'tests/oracle'; +interface TestReportSnapshot { + readonly path: string; + /** Undefined means the candidate did not exist before the scoped run. */ + readonly body?: Buffer; + readonly mode?: number; + readonly atime?: Date; + readonly mtime?: Date; + /** A directory or other non-file candidate is never modified by restoration. */ + readonly nonFile?: boolean; +} + +/** Capture report bytes and observable file metadata before the partial run. */ +function snapshotTestReports(cwd: string): readonly TestReportSnapshot[] { + return testReportCandidatePaths(cwd).map((path) => { + try { + const stat = statSync(path); + if (!stat.isFile()) return {path, nonFile: true}; + return { + path, + body: readFileSync(path), + mode: stat.mode, + atime: stat.atime, + mtime: stat.mtime, + }; + } catch (error) { + if ((error as NodeJS.ErrnoException).code === 'ENOENT') return {path}; + throw error; + } + }); +} + +/** Restore existing reports and remove reports created only by the partial run. */ +function restoreTestReports(snapshots: readonly TestReportSnapshot[]): readonly string[] { + const errors: string[] = []; + for (const snapshot of snapshots) { + if (snapshot.nonFile) continue; + try { + if (snapshot.body === undefined) { + if (!existsSync(snapshot.path)) continue; + if (!statSync(snapshot.path).isFile()) { + errors.push(`${snapshot.path}: scoped oracle run created a non-file report candidate`); + continue; + } + unlinkSync(snapshot.path); + continue; + } + writeFileSync(snapshot.path, snapshot.body); + if (snapshot.mode !== undefined) chmodSync(snapshot.path, snapshot.mode); + if (snapshot.atime && snapshot.mtime) utimesSync(snapshot.path, snapshot.atime, snapshot.mtime); + } catch (error) { + errors.push(`${snapshot.path}: ${(error as Error).message}`); + } + } + return errors; +} + /** True when `dir` contains at least one test/spec file (any nesting depth). */ function hasOracle(dir: string): boolean { let found = false; @@ -60,6 +126,7 @@ function hasOracle(dir: string): boolean { * @param opts - Optional cwd override. * @returns A stage result. * @see stages/detectors/spec-conformance.ts — the presence/provenance guard. + * @see spec/features/spec-conformance-oracle-stage-c4c5ae.yaml AC-008 */ export function runSpecConformance(opts: CommandStageOptions = {}): StageResult { const {cwd = '.'} = opts; @@ -74,8 +141,49 @@ export function runSpecConformance(opts: CommandStageOptions = {}): StageResult } // Point the detected test runner at the oracle dir only (npx vitest run // tests/oracle · pytest tests/oracle · …) — never the agent's own suite. - const proc = execaSync(test.cmd, [...test.args, ORACLE_DIR], {cwd, reject: false}); - const skip = missingToolSkip(STAGE, test.cmd, proc); + // + // A project reporter can write every invocation to one authoritative JUnit + // path. Without isolation, this deliberately-partial oracle run replaces the + // full unit report; the NEXT strict gate then misreads every ordinary test_ref + // as unexecuted. Preserve every configured/conventional report candidate so + // stage_2.3 cannot leak its narrower selection into another stage or run. + let snapshots: readonly TestReportSnapshot[]; + try { + snapshots = snapshotTestReports(cwd); + } catch (error) { + return { + stage: STAGE, + pass: false, + exitCode: 1, + stderr: `could not preserve the full test report before the scoped oracle run: ${(error as Error).message}`, + }; + } + let proc: ReturnType | undefined; + let runError: unknown; + const runArgs = [...test.args, ORACLE_DIR]; + try { + proc = execaSync(test.cmd, runArgs, {cwd, reject: false}); + } catch (error) { + runError = error; + } + const restoreErrors = restoreTestReports(snapshots); + if (restoreErrors.length > 0) { + return { + stage: STAGE, + pass: false, + exitCode: 1, + stderr: `could not restore the full test report after the scoped oracle run: ${restoreErrors.join('; ')}`, + }; + } + if (runError || !proc) { + return { + stage: STAGE, + pass: false, + exitCode: 1, + stderr: `oracle runner failed to start: ${(runError as Error)?.message ?? 'unknown error'}`, + }; + } + const skip = missingToolSkip(STAGE, test.cmd, proc, runArgs); if (skip) return skip; return ranToolResult(STAGE, proc); } diff --git a/src/stages/toolchain/detect.ts b/src/stages/toolchain/detect.ts index ca4de93f..a52a3a5b 100644 --- a/src/stages/toolchain/detect.ts +++ b/src/stages/toolchain/detect.ts @@ -4,9 +4,9 @@ // Cargo.toml → go.mod → pom.xml → build.gradle → composer.json → mix.exs → // .csproj → Gemfile` and returns the first match. Each language has a // curated default per gate (chosen as the *most common* tool, not the only -// one — users override per-stage via `CommandStageOptions`). The TS/JS lint -// gate additionally auto-selects biome/oxlint over the eslint default by -// linter config-file presence (`resolveTsLint`); detection never installs. +// one — users override per-stage via `CommandStageOptions`). For TS/JS, +// explicit package scripts and config files refine those defaults so Cladding +// runs the workflow the project declared; detection never installs. // // This is the polyglot adapter: cladding itself stays language-agnostic; // the *user project* decides which language tools run. @@ -37,6 +37,20 @@ interface Entry { readonly requiresSource?: readonly string[]; } +/** package.json fields that affect TS/JS gate selection. */ +interface PackageManifest { + readonly scripts?: Readonly>; + readonly dependencies?: Readonly>; + readonly devDependencies?: Readonly>; + readonly optionalDependencies?: Readonly>; + readonly peerDependencies?: Readonly>; + readonly eslintConfig?: unknown; + readonly jest?: unknown; +} + +/** npx must resolve only already-installed/cacheable tools and never touch the network. */ +const NPX_LOCAL_ONLY = ['--offline', '--no-install'] as const; + /** * Prefers the committed Gradle wrapper (`./gradlew`) over a bare `gradle` * on PATH. The wrapper pins the Gradle version per project and is the @@ -140,23 +154,23 @@ const CHAIN: readonly Entry[] = [ language: 'typescript', manifests: ['package.json'], gates: { - // --no-install everywhere (0.6.0, battery NOTE 1): a bare `npx tsc` + // --offline + --no-install everywhere: a bare `npx tsc` // AUTO-INSTALLS the typosquat package `tsc@2.0.4` (not TypeScript) on // toolchain-less machines — the gate must never fetch and execute an // unpinned third-party package. Absent tool → npx exits non-zero with // "not found" → the stage's missing-tool classification → skip (exit 2), // which the strict demand table (F-67d2e9) escalates when the spec // relies on the stage. - type: {cmd: 'npx', args: ['--no-install', 'tsc', '--noEmit']}, - lint: {cmd: 'npx', args: ['--no-install', 'eslint', '.']}, - test: {cmd: 'npx', args: ['--no-install', 'vitest', 'run']}, - coverage: {cmd: 'npx', args: ['--no-install', 'vitest', 'run', '--coverage']}, - secret: {cmd: 'npx', args: ['--no-install', 'secretlint', '**/*']}, + type: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'tsc', '--noEmit']}, + lint: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'eslint', '.']}, + test: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'vitest', 'run']}, + coverage: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'vitest', 'run', '--coverage']}, + secret: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'secretlint', '**/*']}, // .tsx/.jsx/.js alongside .ts so circular-dependency detection covers // React/JSX component trees, not only plain .ts (F-47b8bee5). madge // excludes node_modules by default, so widening extensions does not pull // the dependency tree into the scan. - arch: {cmd: 'npx', args: ['--no-install', 'madge', '--circular', '--extensions', 'ts,tsx,js,jsx', '.']}, + arch: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, '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']}, @@ -313,14 +327,13 @@ function hasExtensionFile(cwd: string, suffix: string): string | undefined { * TypeScript/JavaScript linter resolution by config-file presence (F-b2094740). * * `package.json` maps to one language ('typescript'), but the JS/TS ecosystem - * has several common linters. Rather than hardcode eslint, detect the linter - * the project actually configured and gate with THAT — so a biome/oxlint - * project passes stage_1.2 natively, no eslint shim. Precedence: biome → - * oxlint → eslint (the default, also used when no linter config is present, so - * eslint and config-less projects behave exactly as before). + * has several common linters. Rather than hardcode eslint, run the project's + * explicit `scripts.lint` first, then detect a configured biome/oxlint/eslint. + * With no declaration, omit the gate: a package.json alone is not evidence + * that ESLint is installed or configured. * - * `--no-install` is kept on every gate: detection only decides WHICH tool to - * invoke, it NEVER installs one. A configured-but-absent linter still resolves + * `--offline --no-install` is kept on every gate: detection only decides WHICH + * tool to invoke, it NEVER installs one or contacts a registry. An absent linter resolves * to skip via stage_1.2's missing-tool path (lint.ts), which `--strict`'s * skip-policy escalates when the spec relies on lint. * @@ -331,17 +344,57 @@ function hasExtensionFile(cwd: string, suffix: string): string | undefined { * with a different tool overrides via CommandStageOptions (the cmd/args seam). */ const TS_LINTERS: ReadonlyArray<{readonly configs: readonly string[]; readonly gate: ToolSpec}> = [ - {configs: ['biome.json', 'biome.jsonc'], gate: {cmd: 'npx', args: ['--no-install', 'biome', 'lint', '.']}}, + {configs: ['biome.json', 'biome.jsonc'], gate: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'biome', 'lint', '.']}}, // oxlint auto-detects all three filenames in cwd (oxc.rs config reference). - {configs: ['.oxlintrc.json', '.oxlintrc.jsonc', 'oxlint.config.ts'], gate: {cmd: 'npx', args: ['--no-install', 'oxlint']}}, + {configs: ['.oxlintrc.json', '.oxlintrc.jsonc', 'oxlint.config.ts'], gate: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'oxlint']}}, +]; + +const ESLINT_CONFIGS: readonly string[] = [ + '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', ]; -/** The project's configured TS/JS lint gate, or `fallback` (eslint) when none. */ -function resolveTsLint(cwd: string, fallback: ToolSpec): ToolSpec { +/** Reads package.json once for gate refinement; malformed input declares nothing. */ +function readPackageManifest(cwd: string): PackageManifest { + try { + return JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8')) as PackageManifest; + } catch { + return {}; + } +} + +/** True when a non-empty npm script is explicitly declared. */ +function packageScript(pkg: PackageManifest, name: string): string | undefined { + const script = pkg.scripts?.[name]; + return typeof script === 'string' && script.trim().length > 0 ? script.trim() : undefined; +} + +/** True when package.json declares a dependency in any installable section. */ +function hasPackageDependency(pkg: PackageManifest, name: string): boolean { + return [pkg.dependencies, pkg.devDependencies, pkg.optionalDependencies, pkg.peerDependencies] + .some((group) => group?.[name] !== undefined); +} + +/** The project's declared TS/JS lint gate, or undefined when lint is unconfigured. */ +function resolveTsLint(cwd: string, eslintDefault: ToolSpec, pkg: PackageManifest): ToolSpec | undefined { + if (packageScript(pkg, 'lint')) return {cmd: 'npm', args: ['run', '--silent', 'lint']}; for (const linter of TS_LINTERS) { if (linter.configs.some((c) => existsSync(join(cwd, c)))) return linter.gate; } - return fallback; + if (ESLINT_CONFIGS.some((c) => existsSync(join(cwd, c))) || pkg.eslintConfig !== undefined) { + return eslintDefault; + } + return undefined; } /** @@ -350,14 +403,15 @@ function resolveTsLint(cwd: string, fallback: ToolSpec): ToolSpec { * * `package.json` maps to one language, but the test gate defaulted to vitest * unconditionally — so a Jest project (CRA, React Native, classic React) hit - * `npx --no-install vitest`, found nothing, and SILENTLY SKIPPED stage_2.1 / + * the Vitest fallback, found nothing, and SILENTLY SKIPPED stage_2.1 / * stage_2.2. Detect the Jest the project actually configured and gate with - * THAT. Precedence: jest config present → jest; else vitest (the default, also - * used config-less, so vitest and config-less projects behave exactly as - * before). + * THAT. An explicit non-Jest/Vitest `scripts.test` is authoritative and runs + * through npm (preserving build steps and Node's built-in runner); its coverage + * gate exists only when `scripts.coverage` is also declared. Otherwise the + * historical Jest-config → Jest → Vitest-default chain remains intact. * - * `--no-install` is kept: detection only decides WHICH runner to invoke, never - * installs one. A configured-but-absent jest still resolves to skip via the + * `--offline --no-install` is kept: detection only decides WHICH runner to + * invoke, never installs one or contacts a registry. An absent Jest resolves to skip via the * stage's missing-tool path, which `--strict`'s skip-policy escalates. * * CAVEAT — by config PRESENCE, not content (mirrors `resolveTsLint`). A project @@ -369,14 +423,28 @@ const JEST_CONFIGS: readonly string[] = [ ]; /** True when the project configures Jest — a jest.config.* file or a `jest` key in package.json. */ -function hasJestConfig(cwd: string): boolean { +function hasJestConfig(cwd: string, pkg: PackageManifest): boolean { if (JEST_CONFIGS.some((c) => existsSync(join(cwd, c)))) return true; - try { - const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8')) as {jest?: unknown}; - return pkg.jest !== undefined; - } catch { - return false; + return pkg.jest !== undefined; +} + +/** Runner scripts simple enough to preserve the native Vitest/Jest gate path. */ +function simpleTestRunner(script: string): 'vitest' | 'jest' | undefined { + if (/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?vitest(?:\s+run)?$/i.test(script)) { + return 'vitest'; } + if (/^(?:(?:npx|npm exec)\s+(?:--offline\s+)?(?:--no-install\s+)?(?:--\s+)?)?jest$/i.test(script)) { + return 'jest'; + } + return undefined; +} + +/** Drops one optional gate without mutating the curated base object. */ +function withoutGate(base: ToolchainGates, gate: 'lint' | 'coverage'): ToolchainGates { + const rest = {...base}; + if (gate === 'lint') delete rest.lint; + else delete rest.coverage; + return rest; } /** @@ -385,14 +453,38 @@ function hasJestConfig(cwd: string): boolean { * `hasJestConfig`). Other gates pass through unchanged. */ function resolveTsGates(cwd: string, base: ToolchainGates): ToolchainGates { - const out: ToolchainGates = base.lint ? {...base, lint: resolveTsLint(cwd, base.lint)} : {...base}; - if (base.test && base.coverage && hasJestConfig(cwd)) { + const pkg = readPackageManifest(cwd); + const lint = base.lint ? resolveTsLint(cwd, base.lint, pkg) : undefined; + let out: ToolchainGates = lint ? {...base, lint} : withoutGate(base, 'lint'); + const testScript = packageScript(pkg, 'test'); + const runner = testScript ? simpleTestRunner(testScript) : undefined; + + if (testScript && !runner) { + out = withoutGate(out, 'coverage'); + return { + ...out, + test: {cmd: 'npm', args: ['test']}, + ...(packageScript(pkg, 'coverage') + ? {coverage: {cmd: 'npm', args: ['run', '--silent', 'coverage']}} + : {}), + }; + } + + if (runner === 'jest' || (!testScript && hasJestConfig(cwd, pkg))) { return { ...out, - test: {cmd: 'npx', args: ['--no-install', 'jest']}, - coverage: {cmd: 'npx', args: ['--no-install', 'jest', '--coverage']}, + test: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'jest']}, + coverage: {cmd: 'npx', args: [...NPX_LOCAL_ONLY, 'jest', '--coverage']}, }; } + + if (runner === 'vitest' && !packageScript(pkg, 'coverage') + && !hasPackageDependency(pkg, '@vitest/coverage-v8') + && !hasPackageDependency(pkg, '@vitest/coverage-istanbul')) { + out = withoutGate(out, 'coverage'); + } else if (runner === 'vitest' && packageScript(pkg, 'coverage')) { + out = {...out, coverage: {cmd: 'npm', args: ['run', '--silent', 'coverage']}}; + } return out; } @@ -426,9 +518,8 @@ export function detectToolchain(cwd: string = '.'): Toolchain { if (entry.requiresSource && !hasSourceFile(cwd, entry.requiresSource)) continue; // Kotlin gates are a function of cwd (gradlew vs gradle); resolve first. const baseGates = typeof entry.gates === 'function' ? entry.gates(cwd) : entry.gates; - // TS/JS: pick the linter (biome/oxlint) and test runner (jest) the project - // configured over the eslint/vitest defaults, so a non-eslint / Jest project - // gates natively. Other languages keep their single curated default. + // TS/JS: prefer declared npm workflows, then configured ecosystem tools. + // Other languages keep their single curated default. const gates = entry.language === 'typescript' ? resolveTsGates(cwd, baseGates) : baseGates; return {language: entry.language, manifest, gates}; } diff --git a/src/stages/toolchain/gate-config.ts b/src/stages/toolchain/gate-config.ts index c0591df9..6b0c4a3a 100644 --- a/src/stages/toolchain/gate-config.ts +++ b/src/stages/toolchain/gate-config.ts @@ -52,6 +52,20 @@ export interface GateConfig { const DEFAULT: GateConfig = {scope: 'feature'}; +/** + * Conventional JUnit paths inspected when `gate.test_report` is not explicit. + * + * Kept beside the gate config resolver so the detector that consumes a report + * and any scoped test stage that must preserve it share exactly one path set. + * + * @see spec/features/spec-conformance-oracle-stage-c4c5ae.yaml AC-008 + */ +export const DEFAULT_TEST_REPORT_CANDIDATES = [ + 'test-report.junit.xml', + join('coverage', 'junit.xml'), + join('.cladding', 'test-report.junit.xml'), +] as const; + /** Reads `.cladding/config.yaml::gate`, returning the default on any absence/error. */ export function readGateConfig(cwd: string = '.'): GateConfig { const path = join(cwd, '.cladding', 'config.yaml'); @@ -85,6 +99,44 @@ export function readGateConfig(cwd: string = '.'): GateConfig { } } +/** + * Returns every test-report path a scoped test run must leave untouched. + * + * The explicit `gate.test_report`, when present, is returned first, followed by + * every conventional candidate. A scoped runner can still write its framework + * default in addition to the configured evidence path, so report preservation + * must cover both sets even though the detector consumes only the explicit one. + * + * @param cwd - Project root. + * @returns Absolute-or-cwd-joined report paths in detector precedence order. + * @see spec/features/spec-conformance-oracle-stage-c4c5ae.yaml AC-008 + */ +export function testReportCandidatePaths(cwd: string = '.'): readonly string[] { + const configured = readGateConfig(cwd).testReport; + const candidates = configured + ? [configured, ...DEFAULT_TEST_REPORT_CANDIDATES] + : DEFAULT_TEST_REPORT_CANDIDATES; + return [...new Set(candidates.map((candidate) => join(cwd, candidate)))]; +} + +/** + * Resolves the first existing report using the detector's precedence rules. + * + * @param cwd - Project root. + * @returns The selected report path, or null when no report exists. + * @see spec/features/spec-conformance-oracle-stage-c4c5ae.yaml AC-008 + */ +export function resolveTestReportPath(cwd: string = '.'): string | null { + const configured = readGateConfig(cwd).testReport; + if (configured) { + const path = join(cwd, configured); + return existsSync(path) ? path : null; + } + return DEFAULT_TEST_REPORT_CANDIDATES + .map((candidate) => join(cwd, candidate)) + .find((candidate) => existsSync(candidate)) ?? null; +} + // `{modules:TASK}` — TASK is a Gradle task name (letters/digits/_.:- ). const MODULE_TOKEN = /^\{modules:([A-Za-z0-9_.:-]+)\}$/; diff --git a/src/stages/type.ts b/src/stages/type.ts index 9a195631..b8cf5f61 100644 --- a/src/stages/type.ts +++ b/src/stages/type.ts @@ -58,7 +58,7 @@ export function runType(opts: CommandStageOptions = {}): StageResult { const proc = execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing tool skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The tool RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/stages/unit.ts b/src/stages/unit.ts index c846cc00..39a60079 100644 --- a/src/stages/unit.ts +++ b/src/stages/unit.ts @@ -41,6 +41,25 @@ function isVitestRunner(cmd: string, args: readonly string[]): boolean { return cmd === 'vitest' || cmd.endsWith('/vitest') || args.includes('vitest'); } +/** + * Returns true only when a successful runner output definitively reports that + * every aggregate test count was zero. Multiple summaries can occur in npm + * workspaces; any positive count prevents a false alarm. + */ +function reportsZeroExecutedTests(proc: {readonly stdout?: unknown; readonly stderr?: unknown}): boolean { + const output = `${String(proc.stdout ?? '')}\n${String(proc.stderr ?? '')}`; + const counts: number[] = []; + const patterns = [ + /^\s*#\s*tests\s+(\d+)\s*$/gim, + /^\s*ℹ\s+tests\s+(\d+)\s*$/gim, + /^\s*Tests:\s+.*?\b(\d+)\s+total\b.*$/gim, + ]; + for (const pattern of patterns) { + for (const match of output.matchAll(pattern)) counts.push(Number(match[1])); + } + return counts.length > 0 && counts.every((count) => count === 0); +} + /** * Gate-scoped dedup fast path (F-49f6f2d2). On a primed vitest gate, the unit * stage reuses the ONE shared coverage+dual-json vitest run the coverage stage @@ -86,7 +105,7 @@ function tryReuseSharedRun(opts: UnitStageOptions, cwd: string, guardOn: boolean if (!shared) return null; // cwd mismatch / unprimed → own run const {proc, jsonFile} = shared; // Missing binary → let the own-run path surface the honest skip (exit 2). - if (missingToolSkip(STAGE, covCmd, proc)) return null; + if (missingToolSkip(STAGE, covCmd, proc, baseArgs)) return null; const covResult = ranToolResult(STAGE, proc); if (unitActionFromCoverage(covResult) === 'fallback') return null; // not green → own tests-only run // reuse-pass: the shared run is GREEN. Under --strict the vacuous-test guard @@ -158,13 +177,21 @@ export function runUnit(opts: UnitStageOptions = {}): StageResult { const proc = execaSync(cmd, [...runArgs], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing tool skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, runArgs); if (skip) return skip; // The tool RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). // ADDITIVE (F-b7873005): on failure, attach structured findings parsed from // the test runner's own output — the raw stderr is preserved unchanged. const base = withFindings('unit', ranToolResult(STAGE, proc), proc); + if (strict && base.pass && reportsZeroExecutedTests(proc)) { + const finding = { + detector: 'VACUOUS_TESTS', + severity: 'error' as const, + message: 'The unit test command exited successfully but reported zero executed tests.', + }; + return {stage: STAGE, pass: false, exitCode: 1, findings: [finding], stderr: finding.message}; + } // Vacuous-test guard (F-b81d203e): only escalate an otherwise-GREEN run — a // failing suite already blocks; a vacuous run exits 0 (skips don't fail) yet // must not read as verified. vacuousDoneFindings is total (never throws). diff --git a/src/stages/util.ts b/src/stages/util.ts index 9ef8d223..b0fec62d 100644 --- a/src/stages/util.ts +++ b/src/stages/util.ts @@ -53,7 +53,7 @@ export function isMissingBinary(proc: {readonly code?: string}): boolean { * ARCHITECTURE_VIOLATION error (breaking the committed A/B report baselines). */ const SCANNER_SETUP_FAILURE = - /config (is |file )?not found|no such file|ENOENT|cannot find (a |the )?(config|module|package|preset)|require[sd]?\b.{0,40}\bconfig|canceled due to missing packages|could not determine executable/i; + /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; export function classifyScannerExit( proc: {readonly exitCode?: number | null; readonly stdout?: unknown; readonly stderr?: unknown}, @@ -72,14 +72,50 @@ export function classifyScannerExit( return [{detector, severity: 'error', message: foundMsg(detail)}]; } +/** + * Maps an unavailable command or unresolved offline npx target to a setup gap. + * + * The npx shell-level fallback is bound to the requested executable. A tool + * that starts successfully and then misses one of its own helper commands must + * remain a real failure instead of being hidden as an installation gap. + * + * @param stage - Ironclad stage id for the result. + * @param cmd - Command that was attempted. + * @param proc - Completed process result. + * @param args - Arguments passed to the command, used to identify an npx target. + * @returns A skipped setup-gap result, or null when the command actually ran. + */ export function missingToolSkip( stage: string, cmd: string, - proc: {readonly code?: string; readonly exitCode?: number | null}, + proc: { + readonly code?: string; + readonly exitCode?: number | null; + readonly stdout?: unknown; + readonly stderr?: unknown; + }, + args: readonly string[] = [], ): StageResult | null { if (isMissingBinary(proc)) { return {stage, pass: false, exitCode: 2, stderr: `'${cmd}' not installed`}; } + const output = `${String(proc.stderr ?? '')}\n${String(proc.stdout ?? '')}`; + const npxResolutionFailure = + /ENOTCACHED|ENOTFOUND|EAI_AGAIN|canceled due to missing packages|could not determine executable/i.test(output); + const npxTarget = args.find((arg) => arg !== '--' && !arg.startsWith('-')); + const escapedTarget = npxTarget?.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); + const npxShellMissing = proc.exitCode === 127 && escapedTarget !== undefined && + new RegExp(`(?:^|[\\s:])${escapedTarget}: (?:command )?not found\\b`, 'i').test(output); + if (cmd === 'npx' && (npxResolutionFailure || npxShellMissing)) { + return { + stage, + pass: false, + exitCode: 2, + stderr: + "setup gap: 'npx' could not resolve the configured tool without installing it; " + + 'the inferred tool is not installed or unavailable offline', + }; + } return null; } diff --git a/src/stages/visual.ts b/src/stages/visual.ts index ecf4c2b7..8fb36ba0 100644 --- a/src/stages/visual.ts +++ b/src/stages/visual.ts @@ -38,7 +38,7 @@ export function runVisual(opts: CommandStageOptions = {}): StageResult { const proc = execaSync(cmd, [...args], {cwd, reject: false}); // execaSync(reject:false) RETURNS (does not throw) on a missing binary; // detect ENOENT on the result so a missing runner skips, not false-fails. - const skip = missingToolSkip(STAGE, cmd, proc); + const skip = missingToolSkip(STAGE, cmd, proc, args); if (skip) return skip; // The runner RAN. Map its result to cladding's pass/fail/skip contract: // any non-zero exit → blocking fail (1), never the tool's raw 2 (= skip). diff --git a/src/ui/softShell.ts b/src/ui/softShell.ts index 0fe74c23..62d4cd7d 100644 --- a/src/ui/softShell.ts +++ b/src/ui/softShell.ts @@ -169,13 +169,13 @@ export const DETECTOR_PLAIN: Readonly> = { AC_DUPLICATE_WITHIN_FEATURE: {lead: 'The same criterion id appears twice inside one feature', action: 'renumber or remove the duplicate criterion'}, ARCHITECTURE_FROM_SPEC: {lead: 'The code imports across layers in a way the architecture rules forbid', action: 'remove the cross-layer import or update the architecture rules'}, CAPABILITIES_FEATURE_MAPPING: {lead: 'A capability lists a feature id that does not exist', action: 'fix the capability feature list'}, - ABSENCE_OF_GOVERNANCE: {lead: 'This project has no cladding spec set up, so the checks have nothing to inspect', action: 'run `clad init` to set up the spec'}, + ABSENCE_OF_GOVERNANCE: {lead: 'This project has no cladding spec set up, so the checks have nothing to inspect', action: 'ask your AI tool to apply Cladding to this project'}, AI_HINTS_FORBIDDEN_PATTERN: {lead: 'The code uses a pattern the project rules told the AI never to use', action: 'remove the forbidden pattern named in the project ai_hints'}, PLANNED_BACKLOG: {lead: 'Several features are specced but have no code yet — the plan has run ahead of the work', action: 'implement the pending features before adding more'}, HOLLOW_GOVERNANCE: {lead: 'The design files exist but are still empty templates', action: 'fill in the capabilities and architecture files'}, DEPENDENCY_CYCLE: {lead: 'Features depend on each other in a loop, so none of them can ever start', action: 'break the dependency loop between the features'}, SCENARIO_COVERAGE: {lead: 'This project defines no user-journey scenarios, or a scenario links no features', action: 'add a scenario, or bind features to the empty one'}, - PROJECT_CONTEXT_DRIFT: {lead: 'The project why-it-exists document is still the empty starter stub', action: 'write docs/project-context.md, or re-run `clad init`'}, + PROJECT_CONTEXT_DRIFT: {lead: 'The project why-it-exists document is still the empty starter stub', action: 'write docs/project-context.md, or ask your AI tool to refresh the Cladding project context'}, SPEC_CONFORMANCE: {lead: 'A finished feature is missing the spec-derived test that should prove it', action: 'add the required oracle test — `clad oracle ` prints the brief'}, DELIVERABLE_INTEGRITY: {lead: 'The declared entry point is missing, or a shipped feature declares none to smoke-test', action: 'fix project.deliverable.path, or declare the entry point'}, SMOKE_PROBE_DEMAND: {lead: 'A shipped, runnable project has no smoke check proving its entry point actually runs', action: 'add a smoke probe under project.smoke'}, diff --git a/tests/agent-interpreter-rule.test.ts b/tests/agent-interpreter-rule.test.ts index c3763d43..525a7b59 100644 --- a/tests/agent-interpreter-rule.test.ts +++ b/tests/agent-interpreter-rule.test.ts @@ -6,7 +6,7 @@ // never told the agent to translate it for the human. This suite pins the // three-layer fix's agent-facing layer (hooks render plain = U2, cards drop // jargon = U3, the agent's own sentences translate = U4, this feature): -// - AC-ad928912: CLAUDE_MD_SECTION + AGENTS_MD_TEMPLATE both carry the +// - AC-ad928912: CLAUDE_MD_SECTION + AGENTS_MD_BLOCK both carry the // interpreter rule, both freshness literals still survive verbatim // (isStaleInstructions must not self-flag a fresh emission), and // CLAUDE_MD_SECTION stays under the (deliberately raised) byte ceiling. @@ -30,7 +30,12 @@ import {readFileSync} from 'node:fs'; import {join} from 'node:path'; import {describe, expect, test} from 'vitest'; -import {AGENTS_MD_TEMPLATE, CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {renderAgentsMdManagedBlock} from '../src/init/agents-md.js'; + +// The live cross-host surface: the spec-driven AGENTS.md managed block +// (F-a4085adf) replaced the old static AGENTS_MD_BLOCK in 0.9.0. +const AGENTS_MD_BLOCK = renderAgentsMdManagedBlock(null); import {checkBudget, PERSONA_BUDGETS} from './scenarios/_size-budgets.js'; import {measureFile} from './scenarios/_token-meter.js'; @@ -53,7 +58,7 @@ const NEVER_LEAD_WITH_IDS = /never lead with(?: an)?(?: internal)? ids?/i; const ATTESTATION_EQUIV = /attestation\s*=\s*(a\s+)?(signed\s+)?sign-off/i; const FINDING_EQUIV = /finding\s*=\s*what drifted/i; -describe('AC-ad928912 · CLAUDE_MD_SECTION + AGENTS_MD_TEMPLATE carry the interpreter rule', () => { +describe('AC-ad928912 · CLAUDE_MD_SECTION + the AGENTS.md managed block carry the interpreter rule', () => { test('CLAUDE_MD_SECTION leads with the "Speak the user\'s language" anchor', () => { expect(CLAUDE_MD_SECTION).toContain("**Speak the user's language**"); }); @@ -66,15 +71,15 @@ describe('AC-ad928912 · CLAUDE_MD_SECTION + AGENTS_MD_TEMPLATE carry the interp expect(flat).toContain('plain words'); }); - test('AGENTS_MD_TEMPLATE carries the equivalent "Speak the user\'s language" section', () => { - expect(AGENTS_MD_TEMPLATE).toContain("## Speak the user's language"); - const flat = norm(AGENTS_MD_TEMPLATE); + test('the AGENTS.md managed block carries the equivalent "Speak the user\'s language" section', () => { + expect(AGENTS_MD_BLOCK).toContain("## Speak the user's language"); + const flat = norm(AGENTS_MD_BLOCK); expect(flat).toMatch(USERS_OWN_LANGUAGE); expect(flat).toMatch(NEVER_LEAD_WITH_IDS); }); test('both freshness literals survive verbatim in both templates', () => { - for (const tpl of [CLAUDE_MD_SECTION, AGENTS_MD_TEMPLATE]) { + for (const tpl of [CLAUDE_MD_SECTION, AGENTS_MD_BLOCK]) { expect(tpl).toContain('anti-self-cert'); expect(tpl).toContain('Feature cycle — one at a time'); } @@ -82,7 +87,7 @@ describe('AC-ad928912 · CLAUDE_MD_SECTION + AGENTS_MD_TEMPLATE carry the interp test('round trip holds: a freshly emitted section of either template is NOT stale (no re-sync churn)', () => { expect(isStaleInstructions(CLAUDE_MD_SECTION)).toBe(false); - expect(isStaleInstructions(AGENTS_MD_TEMPLATE)).toBe(false); + expect(isStaleInstructions(AGENTS_MD_BLOCK)).toBe(false); }); test('CLAUDE_MD_SECTION stays under the 1250-byte ceiling (measured in bytes, not UTF-16 code units)', () => { diff --git a/tests/claude-md-diet.test.ts b/tests/claude-md-diet.test.ts index bac68358..643c2311 100644 --- a/tests/claude-md-diet.test.ts +++ b/tests/claude-md-diet.test.ts @@ -19,7 +19,10 @@ import {readFileSync} from 'node:fs'; import {join} from 'node:path'; import {describe, expect, test} from 'vitest'; -import {AGENTS_MD_TEMPLATE, CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {renderAgentsMdManagedBlock} from '../src/init/agents-md.js'; + +const AGENTS_MD_BLOCK = renderAgentsMdManagedBlock(null); const ROOT = process.cwd(); const read = (rel: string): string => readFileSync(join(ROOT, rel), 'utf8'); @@ -33,12 +36,12 @@ describe('AC-b07dce5d · both freshness literals survive verbatim in the emitted expect(CLAUDE_MD_SECTION).toContain('Feature cycle — one at a time'); }); - // Symmetric pin: AGENTS_MD_TEMPLATE is out of scope for the diet but carries - // the same signature literal today (checked directly, not assumed) — if a - // future edit drops it there too, isStaleInstructions would misjudge a - // cladding-authored AGENTS.md as arbitrary user prose and never re-sync it. - test('AGENTS_MD_TEMPLATE also carries the anti-self-cert signature literal', () => { - expect(AGENTS_MD_TEMPLATE).toContain('anti-self-cert'); + // Symmetric pin: the spec-driven AGENTS.md managed block is out of scope for + // the diet but carries the same signature literal today (checked directly, + // not assumed) — the anti-self-cert wording is the cross-host freshness + // signature shared by both instruction surfaces. + test('the AGENTS.md managed block also carries the anti-self-cert signature literal', () => { + expect(AGENTS_MD_BLOCK).toContain('anti-self-cert'); }); }); diff --git a/tests/cli/clad.test.ts b/tests/cli/clad.test.ts index cd4700b0..3e54a8a5 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.8.3'); + expect(program.version()).toBe('0.9.0'); }); }); @@ -577,7 +577,17 @@ describe('cli/clad — runServeCommand', () => { StdioMock.mockClear(); setMock.mockClear(); await clad.runServeCommand({cwd: '/tmp/probe'}); - expect(buildMock).toHaveBeenCalledWith({cwd: '/tmp/probe'}); + expect(buildMock).toHaveBeenCalledWith({ + cwd: '/tmp/probe', + onboarding: { + renderDraft: expect.any(Function), + prepareInit: expect.any(Function), + initialize: expect.any(Function), + prepareClarify: expect.any(Function), + clarify: expect.any(Function), + resolveReview: expect.any(Function), + }, + }); expect(StdioMock).toHaveBeenCalledOnce(); // v0.2.26 (F-075): clad serve registers its own server so host // adapters route through McpSamplingTransport. diff --git a/tests/cli/clarify.test.ts b/tests/cli/clarify.test.ts index 8cb771b7..3026b901 100644 --- a/tests/cli/clarify.test.ts +++ b/tests/cli/clarify.test.ts @@ -15,8 +15,8 @@ vi.mock('../../src/cli/scan/dispatcher.js', () => ({ selectDispatcher: vi.fn((opts: {noLlm?: boolean}) => (opts?.noLlm ? null : dispatchMock)), })); -const {runClarifyCommand} = await import('../../src/cli/clarify.js'); -const {saveState, loadState} = await import('../../src/cli/scan/onboarding-state.js'); +const {resolveOnboardingReview, runClarifyCommand} = await import('../../src/cli/clarify.js'); +const {captureArtifactDigests, saveState, loadState} = await import('../../src/cli/scan/onboarding-state.js'); function seedState(cwd: string, qa: Array<{question: string; answer: string | null}>): void { saveState(cwd, { @@ -39,6 +39,7 @@ function seedArtifacts(cwd: string): void { 'schema: "0.1"\nsource: README.md\ncapabilities: []\n', ); writeFileSync(join(cwd, 'spec', 'architecture.yaml'), 'version: "0.1"\nlayers: []\n'); + saveState(cwd, {...loadState(cwd)!, artifactDigests: captureArtifactDigests(cwd)}); } describe('runClarifyCommand', () => { @@ -74,6 +75,18 @@ describe('runClarifyCommand', () => { expect(exitCalls).toEqual([2]); }); + test('review resolution rejects a state-injected path outside onboarding artifacts', () => { + seedState(dir, []); + saveState(dir, { + ...loadState(dir)!, + status: 'needs_review', + pendingReview: ['../escape.yaml'], + }); + const result = resolveOnboardingReview(['../escape.yaml'], {cwd: dir}); + expect(result).toMatchObject({ok: false, changed: false}); + expect(result.error).toMatch(/onboarding design artifacts/); + }); + test('exit 2 when no answer is provided but pending questions exist', async () => { seedState(dir, [{question: 'Q1?', answer: null}]); seedArtifacts(dir); @@ -99,17 +112,12 @@ describe('runClarifyCommand', () => { const after = loadState(dir)!; expect(after.qa[0].answer).toBe('법인 사업자만'); expect(after.qa[1].answer).toBeNull(); - // capabilities + architecture untouched on disk because deterministic - // refinement preserves them — proposal file should not exist - expect(existsSync(join(dir, '.cladding', 'scan', 'capabilities.yaml.proposal'))).toBe(true); - // project-context gets a Q&A footnote appended; the proposal carries - // the new body - const proposal = readFileSync( - join(dir, '.cladding', 'scan', 'project-context.md.proposal'), - 'utf8', - ); - expect(proposal).toContain('Q&A log (refinement, LLM unavailable)'); - expect(proposal).toContain('법인 사업자만'); + // Untouched Cladding-generated design is refined in place so the active + // context—not a detached proposal—contains the accepted answer. + expect(existsSync(join(dir, '.cladding', 'scan', 'capabilities.yaml.proposal'))).toBe(false); + const context = readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8'); + expect(context).toContain('Q&A log (refinement, LLM unavailable)'); + expect(context).toContain('법인 사업자만'); }); test('LLM success refines artifacts, adds new questions, keeps status active', async () => { @@ -146,12 +154,20 @@ describe('runClarifyCommand', () => { // New questions appended (de-duped against existing) expect(after.qa.map((q) => q.question)).toEqual(['Q1?', 'Q2?', 'Q3?', 'Q4?']); expect(after.status).toBe('active'); - // Existing artifacts diverted to proposal - const proposal = readFileSync( - join(dir, '.cladding', 'scan', 'project-context.md.proposal'), - 'utf8', - ); - expect(proposal).toContain('refined context'); + expect(readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8')).toContain('refined context'); + expect(existsSync(join(dir, '.cladding', 'scan', 'project-context.md.proposal'))).toBe(false); + }); + + test('a user-edited design is preserved and onboarding remains in review', async () => { + seedState(dir, [{question: 'Q1?', answer: null}]); + seedArtifacts(dir); + writeFileSync(join(dir, 'docs', 'project-context.md'), '# user-authored context\n'); + + await runClarifyCommand(['A1'], {cwd: dir, noLlm: true}); + + expect(readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8')).toBe('# user-authored context\n'); + expect(existsSync(join(dir, '.cladding', 'scan', 'project-context.md.proposal'))).toBe(true); + expect(loadState(dir)!.status).toBe('needs_review'); }); test('LLM returns no new questions AND every existing question is answered → marks done', async () => { diff --git a/tests/cli/doctor-hosts.test.ts b/tests/cli/doctor-hosts.test.ts index cc9c7d2b..453b5850 100644 --- a/tests/cli/doctor-hosts.test.ts +++ b/tests/cli/doctor-hosts.test.ts @@ -11,7 +11,7 @@ // AC-87ebd442 · consent → ≤3 canned prompts/host, record pass/fail/not-run + evidence // AC-8dfa9cc4 · absent binary OR no consent → not-run, NEVER pass; dated artifact // AC-57ab708c · newest-artifact matrix render; parser vs committed fixtures -// AC-6cbe51fc · Cursor graded wiring-only (never verified) via clad serve tools/list +// AC-6cbe51fc · Cursor headless verification plus clad serve tools/list wiring evidence import { mkdirSync, @@ -31,6 +31,7 @@ import { type PromptResult, type PromptRunner, type SurfaceName, + buildPromptCommand, matrixGradesFence, parseHostOutput, parseServeToolsList, @@ -64,7 +65,7 @@ const ok = (stdout: string): PromptResult => ({stdout, stderr: '', timedOut: fal // ─── AC-57ab708c / AC-87ebd442 · the PURE sentinel parser vs committed fixtures ── describe('parseHostOutput — zero-LLM sentinel matcher against committed transcripts (AC-57ab708c)', () => { - test('list-features: a gemini listing with real F-ids passes', () => { + test('list-features: a committed host listing with real F-ids passes', () => { const p = parseHostOutput('list-features', fixture('gemini-list-features.txt')); expect(p.result).toBe('pass'); expect(p.sentinel).toMatch(/feature id/i); @@ -96,6 +97,28 @@ describe('parseHostOutput — zero-LLM sentinel matcher against committed transc } }); + test('a host rejection cannot pass by echoing the requested id or findings token', () => { + expect(parseHostOutput( + 'get-feature', + 'Both clad_get_feature MCP calls were rejected. Requested id: F-5283985e', + 'F-5283985e', + ).result).toBe('fail'); + expect(parseHostOutput( + 'run-check', + "Both clad_run_check MCP calls were rejected, so I don't have a findings count to report.", + ).result).toBe('fail'); + expect(parseHostOutput( + 'get-feature', + 'mcp: cladding/clad_get_feature (failed) user cancelled MCP tool call F-5283985e', + 'F-5283985e', + ).result).toBe('fail'); + expect(parseHostOutput( + 'get-feature', + 'F-5283985e (`clad_get_feature` was rejected by the host, so no payload was returned.)', + 'F-5283985e', + ).result).toBe('fail'); + }); + test('empty / whitespace output (timeout garbage) fails, never a silent pass', () => { expect(parseHostOutput('list-features', '').result).toBe('fail'); expect(parseHostOutput('run-check', ' \n\t ').result).toBe('fail'); @@ -115,6 +138,34 @@ describe('parseHostOutput — zero-LLM sentinel matcher against committed transc }); }); +describe('host command construction', () => { + test('Gemini uses its non-interactive project-aware prompt command', () => { + expect(buildPromptCommand('gemini', 'probe')).toEqual({ + command: 'gemini', + args: [ + '--skip-trust', + '--approval-mode', + 'plan', + '--policy', + '.cladding/host/gemini-doctor-policy.toml', + '--allowed-mcp-server-names', + 'cladding', + '-o', + 'text', + '-p', + 'probe', + ], + }); + }); + + test('Cursor stays read-only and relies on the exact project MCP allowlist', () => { + expect(buildPromptCommand('cursor', 'probe')).toEqual({ + command: 'cursor-agent', + args: ['-p', '--mode', 'ask', '--trust', '--approve-mcps', 'probe'], + }); + }); +}); + // ─── AC-87ebd442 · consent → ≤3 canned prompts/host, recorded pass/fail ────────── describe('runHostSmoke with consent — canned probing (AC-87ebd442)', () => { @@ -158,13 +209,15 @@ describe('runHostSmoke with consent — canned probing (AC-87ebd442)', () => { }); // ≤3 canned prompts per host CLI found on PATH. - for (const host of ['claude', 'gemini', 'codex']) { - expect(calls.filter((c) => c.command === host)).toHaveLength(3); + for (const command of ['claude', 'gemini', 'agy', 'codex', 'cursor-agent']) { + expect(calls.filter((c) => c.command === command)).toHaveLength(3); } // All three surfaces passed their sentinel → verified. expect(artifact.hosts.claude.grade).toBe('verified'); expect(artifact.hosts.gemini.grade).toBe('verified'); + expect(artifact.hosts.antigravity.grade).toBe('verified'); expect(artifact.hosts.codex.grade).toBe('verified'); + expect(artifact.hosts.cursor.grade).toBe('verified'); // Every surface carries its recorded pass + evidence. const claudeSurfaces = artifact.hosts.claude.surfaces; expect(claudeSurfaces.map((s) => s.name)).toEqual(['list-features', 'get-feature', 'run-check']); @@ -194,9 +247,9 @@ describe('runHostSmoke with consent — canned probing (AC-87ebd442)', () => { runPrompt: cannedRunner(calls, fixture('refusal.txt')), home, }); - const list = artifact.hosts.gemini.surfaces.find((s) => s.name === 'list-features'); + const list = artifact.hosts.antigravity.surfaces.find((s) => s.name === 'list-features'); expect(list?.result).toBe('fail'); - expect(artifact.hosts.gemini.grade).toBe('fail'); + expect(artifact.hosts.antigravity.grade).toBe('fail'); }); }); @@ -219,7 +272,7 @@ describe('not-run honesty — absence never renders as a pass (AC-8dfa9cc4)', () test('no consent (binary present) → every prompt host not-run with the consent reason', () => { const artifact = runHostSmoke(dir, {consent: false, hasBinary: () => true, home, version: 'x'}); - for (const host of ['claude', 'gemini', 'codex'] as const) { + for (const host of ['claude', 'gemini', 'antigravity', 'codex', 'cursor'] as const) { const rec = artifact.hosts[host]; expect(rec.grade).toBe('not-run'); expect(rec.reason).toMatch(/consent not given/i); @@ -230,7 +283,7 @@ describe('not-run honesty — absence never renders as a pass (AC-8dfa9cc4)', () test('binary absent from PATH → not-run "binary not on PATH", even with consent', () => { const artifact = runHostSmoke(dir, {consent: true, hasBinary: () => false, home}); - for (const host of ['claude', 'gemini', 'codex'] as const) { + for (const host of ['claude', 'gemini', 'antigravity', 'codex', 'cursor'] as const) { expect(artifact.hosts[host].grade).toBe('not-run'); expect(artifact.hosts[host].reason).toMatch(/not on PATH/i); } @@ -287,6 +340,7 @@ function mkArtifact(over: Partial = {}): HostSmokeArtifact { ], }, gemini: {grade: 'not-run', surfaces: [], reason: 'consent not given (set CLAD_HOST_SMOKE=1)'}, + antigravity: {grade: 'not-run', surfaces: [], reason: 'consent not given (set CLAD_HOST_SMOKE=1)'}, codex: {grade: 'not-run', surfaces: [], reason: 'binary not on PATH'}, cursor: { grade: 'wiring-ok', @@ -298,7 +352,7 @@ function mkArtifact(over: Partial = {}): HostSmokeArtifact { } describe('renderHostMatrix — pure matrix generator (AC-57ab708c)', () => { - test('emits host × surface × result × date × version + grades fence + wiring-only legend', () => { + test('emits host × surface × result × date × version + grades fence + wiring evidence legend', () => { const md = renderHostMatrix(mkArtifact()); expect(md).toContain('# Host support matrix'); expect(md).toContain('| Host | list-features | get-feature | run-check | wiring | Grade |'); @@ -306,19 +360,20 @@ describe('renderHostMatrix — pure matrix generator (AC-57ab708c)', () => { expect(md).toContain('Generated: 2026-07-01T12:00:00.000Z'); // Per-host rows carry the recorded result cells + grade. expect(md).toMatch(/\| claude \| pass \| pass \| pass \| — \| verified \|/); + expect(md).toMatch(/\| gemini \| — \| — \| — \| — \| not-run \|/); expect(md).toMatch(/\| cursor \| — \| — \| — \| pass \| wiring-ok \|/); // The machine-readable fence the detector reads. expect(md).toContain(matrixGradesFence(mkArtifact())); - // The wiring-only legend (Cursor honesty note). - expect(md).toContain('wiring-only'); + expect(md).toContain('Cursor additionally verifies'); }); - test('matrixGradesFence is the four host grades as a parseable JSON comment', () => { + test('matrixGradesFence includes every supported host as parseable JSON', () => { const fence = matrixGradesFence(mkArtifact()); const json = fence.replace('', ''); expect(JSON.parse(json)).toEqual({ claude: 'verified', gemini: 'not-run', + antigravity: 'not-run', codex: 'not-run', cursor: 'wiring-ok', }); @@ -353,6 +408,35 @@ describe('newest-artifact selection + --matrix-only (AC-57ab708c)', () => { expect(newest?.generatedAt).toBe('2026-07-01T00:00:00.000Z'); }); + test('legacy Gemini artifacts load without relabeling old evidence as Antigravity', () => { + const auditDir = join(dir, '.cladding', 'audit'); + const legacy = mkArtifact() as unknown as {version: string; generatedAt: string; hosts: Record}; + legacy.hosts.gemini = legacy.hosts.antigravity; + delete legacy.hosts.antigravity; + legacy.generatedAt = '2026-08-01T00:00:00.000Z'; + writeFileSync(join(auditDir, 'host-smoke-2026-08-01.json'), JSON.stringify(legacy, null, 2)); + + const newest = readNewestArtifact(dir); + + expect(newest?.hosts.antigravity.grade).toBe('not-run'); + expect(newest?.hosts.antigravity.reason).toMatch(/legacy artifact/i); + }); + + test('interim Antigravity-only artifacts load with an honest Gemini fallback', () => { + const auditDir = join(dir, '.cladding', 'audit'); + const interim = mkArtifact() as unknown as {version: string; generatedAt: string; hosts: Record}; + delete interim.hosts.gemini; + interim.generatedAt = '2026-08-02T00:00:00.000Z'; + writeFileSync(join(auditDir, 'host-smoke-2026-08-02.json'), JSON.stringify(interim, null, 2)); + + const newest = readNewestArtifact(dir); + + expect(newest?.hosts.gemini.grade).toBe('not-run'); + expect(newest?.hosts.gemini.reason).toMatch(/legacy artifact/i); + expect(newest?.hosts.antigravity.grade).toBe('not-run'); + expect(newest?.hosts.antigravity.reason).toMatch(/consent not given/i); + }); + test('--matrix-only regenerates from the newest artifact and is idempotent', () => { const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => undefined) as never); const stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true); @@ -373,7 +457,7 @@ describe('newest-artifact selection + --matrix-only (AC-57ab708c)', () => { }); }); -// ─── AC-6cbe51fc · Cursor wiring-only (never verified) ─────────────────────────── +// ─── AC-6cbe51fc · Cursor headless prompt + wiring evidence ───────────────────── describe('parseServeToolsList — the clad serve tools/list probe (AC-6cbe51fc)', () => { test('a tools/list response containing clad_list_features → ok (wiring-ok)', () => { @@ -397,7 +481,7 @@ describe('parseServeToolsList — the clad serve tools/list probe (AC-6cbe51fc)' }); }); -describe('Cursor is graded wiring-only, never verified (AC-6cbe51fc)', () => { +describe('Cursor is headlessly verified and carries separate wiring evidence (AC-6cbe51fc)', () => { let dir: string; let home: string; @@ -413,56 +497,64 @@ describe('Cursor is graded wiring-only, never verified (AC-6cbe51fc)', () => { }); const wireCursor = (): void => { - mkdirSync(join(home, '.cursor'), {recursive: true}); + mkdirSync(join(dir, '.cursor'), {recursive: true}); writeFileSync( - join(home, '.cursor', 'mcp.json'), - JSON.stringify({mcpServers: {cladding: {command: 'clad', args: ['serve']}}}), + join(dir, '.cursor', 'mcp.json'), + JSON.stringify({mcpServers: {cladding: {command: 'node', args: ['.cladding/host/serve.cjs']}}}), ); }; - test('wired + serve answers tools/list → wiring-ok (a checkable wiring claim, not verified)', () => { + const passingRunner: PromptRunner = (_command, args) => { + const joined = args.join(' '); + if (joined.includes('clad_list_features')) return ok(fixture('gemini-list-features.txt')); + if (joined.includes('clad_get_feature')) return ok(fixture('get-feature-echo.txt')); + if (joined.includes('clad_run_check')) return ok(fixture('run-check-drift.txt')); + return ok(''); + }; + + test('headless prompts pass and wired serve answers tools/list → verified', () => { wireCursor(); const artifact = runHostSmoke(dir, { consent: true, - hasBinary: () => false, + hasBinary: () => true, + runPrompt: passingRunner, home, probeServe: () => ({ok: true, toolCount: 4, evidence: 'tools/list → 4 tools'}), }); - expect(artifact.hosts.cursor.grade).toBe('wiring-ok'); - expect(artifact.hosts.cursor.grade).not.toBe('verified'); + expect(artifact.hosts.cursor.grade).toBe('verified'); const wiring = artifact.hosts.cursor.surfaces.find((s) => s.name === 'wiring'); expect(wiring?.result).toBe('pass'); + expect(artifact.hosts.cursor.surfaces.filter((s) => s.name !== 'wiring').every((s) => s.result === 'pass')).toBe(true); }); - test('wired but serve does not answer → wiring-fail, never verified', () => { + test('headless prompts pass but configured serve does not answer → fail', () => { wireCursor(); const artifact = runHostSmoke(dir, { consent: true, - hasBinary: () => false, + hasBinary: () => true, + runPrompt: passingRunner, home, probeServe: () => ({ok: false, toolCount: 0, evidence: 'no tools/list response'}), }); - expect(artifact.hosts.cursor.grade).toBe('wiring-fail'); - expect(artifact.hosts.cursor.grade).not.toBe('verified'); + expect(artifact.hosts.cursor.grade).toBe('fail'); }); - test('not wired here (~/.cursor absent) → not-run, never a silent pass', () => { + test('binary absent and not wired here → not-run, never a silent pass', () => { const artifact = runHostSmoke(dir, {consent: true, hasBinary: () => false, home}); expect(artifact.hosts.cursor.grade).toBe('not-run'); - expect(artifact.hosts.cursor.reason).toMatch(/Cursor not detected/i); + expect(artifact.hosts.cursor.reason).toMatch(/binary not on PATH/i); }); - test('the rendered matrix never grades cursor verified', () => { + test('the rendered matrix records Cursor prompt surfaces and wiring', () => { wireCursor(); const artifact = runHostSmoke(dir, { consent: true, - hasBinary: () => false, + hasBinary: () => true, + runPrompt: passingRunner, home, probeServe: () => ({ok: true, toolCount: 4, evidence: 'ok'}), }); const md = renderHostMatrix(artifact); - // cursor row exists and its grade cell is a wiring-* class, never verified. - expect(md).toMatch(/\| cursor \|.*\| (wiring-ok|wiring-fail|not-run) \|/); - expect(md).not.toMatch(/\| cursor \|.*\| verified \|/); + expect(md).toMatch(/\| cursor \| pass \| pass \| pass \| pass \| verified \|/); }); }); diff --git a/tests/cli/done.test.ts b/tests/cli/done.test.ts index c9d27da4..60430275 100644 --- a/tests/cli/done.test.ts +++ b/tests/cli/done.test.ts @@ -174,6 +174,24 @@ describe('runDone', () => { expect(readFileSync(path, 'utf8')).toContain('status: done'); }); + test('an unresolved structural design impact blocks done before the gate runs', () => { + const body = SHARD_BODY + + 'design_impact:\n' + + ' classification: structural\n' + + ' rationale: "new service boundary"\n' + + ' status: review_required\n' + + ' artifacts: ["spec/architecture.yaml"]\n'; + const path = writeShard(dir, body); + const checkStages = vi.fn(() => ({worst: 0})); + + const result = runDone(dir, FEATURE_ID, {checkStages}); + + expect(result.ok).toBe(false); + expect(result.reason).toContain('design impact still needs review'); + expect(checkStages).not.toHaveBeenCalled(); + expect(readFileSync(path, 'utf8')).toBe(body); + }); + test('RED gate reverts the shard byte-for-byte', () => { const path = writeShard(dir); const original = readFileSync(path, 'utf8'); diff --git a/tests/cli/init-onboarding-english-source.test.ts b/tests/cli/init-onboarding-english-source.test.ts index e88d6d40..a74bb763 100644 --- a/tests/cli/init-onboarding-english-source.test.ts +++ b/tests/cli/init-onboarding-english-source.test.ts @@ -60,14 +60,11 @@ describe('init-onboarding-english-source (F-5cac007a)', () => { describe('AC-002 — renderSetupReport is English single-source', () => { const result = { - wiring: { - claude_plugin: 'created', - gemini_extension: 'skipped-not-installed', - codex_skills: [], - codex_mcp: 'skipped-not-installed', - cursor_mcp: 'skipped-not-installed', - }, + projectRoot: '/tmp/project', + wiring: {runtime: 'created', shared_init_skill: 'created', claude: 'created', codex: 'created', gemini: 'created', antigravity: 'created', cursor: 'created'}, + legacyCleanup: {claude_plugin: 'unchanged', gemini_extension: 'unchanged', antigravity_plugin: 'unchanged', codex_skills: 'unchanged', codex_mcp: 'unchanged', cursor_mcp: 'unchanged'}, errors: [], + warnings: [], statusFile: '/tmp/status.json', cladding_root: '/tmp/pkg', cladding_version: '0.8.1', @@ -75,18 +72,17 @@ describe('init-onboarding-english-source (F-5cac007a)', () => { } as const; test('the wiring report ends with an English "Next steps:" block, no Hangul', () => { - const detection = {claude: true, gemini: false, codex: false, agents: false, cursor: false}; - const report = renderSetupReport(result, detection, {claude: {attempted: true, success: true}}); + const detection = {claude: true, gemini: false, antigravity: false, codex: false, agents: false, cursor: false}; + const report = renderSetupReport(result, detection); expect(report).toContain('Next steps:'); - expect(report).toContain('1. Restart your AI tool'); - expect(report).toContain('Activate: ✓'); // English activation hint, not 활성화 + expect(report).toContain('1. Start a new AI session in this project directory'); expect(HANGUL.test(report)).toBe(false); }); test('the "no AI tools detected" branch is English, no Hangul', () => { - const detection = {claude: false, gemini: false, codex: false, agents: false, cursor: false}; - const report = renderSetupReport(result, detection, {}); - expect(report).toContain('No AI tools detected'); + const detection = {claude: false, gemini: false, antigravity: false, codex: false, agents: false, cursor: false}; + const report = renderSetupReport(result, detection); + expect(report).toContain('project activation'); expect(HANGUL.test(report)).toBe(false); }); }); diff --git a/tests/cli/setup.test.ts b/tests/cli/setup.test.ts index 6b826631..f04c57e3 100644 --- a/tests/cli/setup.test.ts +++ b/tests/cli/setup.test.ts @@ -1,356 +1,420 @@ -// Cladding · unit tests for src/init/host-setup.ts (F-80d19d) -// -// `clad setup` is the explicit replacement for F-90d054's npm postinstall hook. -// Each AC drives at least one test case. The host home is mocked via `mkdtempSync` -// so the suite is fully isolated from the developer's real `~/.claude` etc. +// Cladding · project-scoped setup and legacy-global migration tests. import {existsSync, mkdirSync, mkdtempSync, readFileSync, readlinkSync, rmSync, symlinkSync, writeFileSync} from 'node:fs'; +import {spawnSync} from 'node:child_process'; import {tmpdir} from 'node:os'; import {join, resolve} from 'node:path'; import {afterEach, beforeEach, describe, expect, test} from 'vitest'; -import {getCurrentCladdingVersion, getLastSetupVersion, renderSetupReport, resolveServeLaunch, runHostSetup} from '../../src/init/host-setup.js'; +import {getLastSetupVersion, renderSetupReport, runHostSetup} from '../../src/init/host-setup.js'; import {hostWireNotice} from '../../src/cli/init.js'; -describe('runHostSetup', () => { +describe('project-scoped runHostSetup', () => { let home: string; + let project: string; let pkgRoot: string; beforeEach(() => { - home = mkdtempSync(join(tmpdir(), 'clad-setup-home-')); - pkgRoot = mkdtempSync(join(tmpdir(), 'clad-setup-pkg-')); - // Minimal pkg skeleton mirroring the real cladding layout the wirer expects. - mkdirSync(join(pkgRoot, 'plugins', 'gemini-cli'), {recursive: true}); + home = mkdtempSync(join(tmpdir(), 'clad-home-')); + // Seed every host's home marker so default detection selects all five + // channels (AC-001: wire only detected hosts). + for (const marker of ['.claude', '.codex', join('.gemini', 'config'), '.cursor', '.agents']) { + mkdirSync(join(home, marker), {recursive: true}); + } + project = mkdtempSync(join(tmpdir(), 'clad-project-')); + pkgRoot = mkdtempSync(join(tmpdir(), 'clad-pkg-')); + mkdirSync(join(pkgRoot, 'dist'), {recursive: true}); mkdirSync(join(pkgRoot, 'plugins', 'codex', 'skills', 'init'), {recursive: true}); - mkdirSync(join(pkgRoot, 'plugins', 'codex', 'skills', 'check'), {recursive: true}); - writeFileSync(join(pkgRoot, 'package.json'), JSON.stringify({version: '0.4.0'})); + writeFileSync(join(pkgRoot, 'dist', 'clad.js'), 'process.stdout.write(JSON.stringify(process.argv.slice(2)));\n'); + writeFileSync(join(pkgRoot, 'package.json'), JSON.stringify({name: 'cladding', version: '0.9.0'})); + writeFileSync( + join(pkgRoot, 'plugins', 'codex', 'skills', 'init', 'SKILL.md'), + '---\nname: init\ndescription: Use only when the user explicitly names Cladding and asks to initialize it.\n---\n\n# Cladding init\n', + ); }); afterEach(() => { rmSync(home, {recursive: true, force: true}); + rmSync(project, {recursive: true, force: true}); rmSync(pkgRoot, {recursive: true, force: true}); }); - // AC-001 — detected hosts wired, undetected ones skipped (no surprise dirs). - test('wires only the host channels whose home directory exists', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - mkdirSync(join(home, '.agents'), {recursive: true}); - // .gemini and .codex intentionally absent. - - const result = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - - expect(result.wiring.claude_plugin).toBe('created'); - expect(result.wiring.gemini_extension).toBe('skipped-not-installed'); - expect(result.wiring.codex_mcp).toBe('skipped-not-installed'); - expect(result.wiring.codex_skills.length).toBeGreaterThan(0); - expect(existsSync(join(home, '.gemini'))).toBe(false); - expect(existsSync(join(home, '.codex'))).toBe(false); + test('writes only project-local host discovery files', async () => { + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + + expect(result.errors).toEqual([]); + expect(existsSync(join(project, '.codex', 'config.toml'))).toBe(true); + expect(existsSync(join(project, '.gemini', 'settings.json'))).toBe(true); + expect(existsSync(join(project, '.agents', 'mcp_config.json'))).toBe(true); + expect(existsSync(join(project, '.cursor', 'mcp.json'))).toBe(true); + expect(existsSync(join(project, '.cursor', 'cli.json'))).toBe(true); + expect(existsSync(join(project, '.cladding', 'host', 'gemini-doctor-policy.toml'))).toBe(true); + expect(existsSync(join(project, '.mcp.json'))).toBe(true); + expect(existsSync(join(project, '.agents', 'skills', 'cladding-init', 'SKILL.md'))).toBe(true); + expect(existsSync(join(project, '.claude', 'skills', 'cladding-init', 'SKILL.md'))).toBe(true); + expect(existsSync(join(project, '.gemini', 'skills'))).toBe(false); + expect(readFileSync(join(project, '.agents', 'skills', 'cladding-init', 'SKILL.md'), 'utf8')) + .toContain('name: cladding-init'); + expect(existsSync(join(project, '.cursor', 'skills', 'cladding-init', 'SKILL.md'))).toBe(true); + // Home gains ONLY the Antigravity machine-wide wire (agy reads no project + // MCP config — verified live); every other host stays project-local. + expect(existsSync(join(home, '.agents', 'skills'))).toBe(false); + expect(existsSync(join(home, '.codex', 'config.toml'))).toBe(false); + expect(existsSync(join(home, '.gemini', 'settings.json'))).toBe(false); + const agyWire = join(home, '.gemini', 'config', 'plugins', 'cladding'); + expect(existsSync(join(agyWire, 'plugin.json'))).toBe(true); + const agyMcp = JSON.parse(readFileSync(join(agyWire, 'mcp_config.json'), 'utf8')); + expect(agyMcp.mcpServers.cladding.args).toEqual([join(pkgRoot, 'dist', 'clad.js'), 'serve']); }); - // AC-002 — re-running on already-wired host yields no filesystem changes. - test('second run reports already-wired without re-creating links', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - - await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - const result2 = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - - expect(result2.wiring.claude_plugin).toBe('unchanged'); - expect(result2.errors.length).toBe(0); + test('default detection wires nothing on a machine with no supported host', async () => { + const bareHome = mkdtempSync(join(tmpdir(), 'clad-barehome-')); + try { + const result = await runHostSetup({home: bareHome, projectRoot: project, pkgRoot, quiet: true, activate: false}); + expect(result.wiring.claude).toBe('skipped-not-selected'); + expect(result.wiring.codex).toBe('skipped-not-selected'); + expect(result.wiring.gemini).toBe('skipped-not-selected'); + expect(result.wiring.antigravity).toBe('skipped-not-selected'); + expect(result.wiring.cursor).toBe('skipped-not-selected'); + expect(existsSync(join(project, '.codex'))).toBe(false); + expect(existsSync(join(project, '.cursor'))).toBe(false); + expect(result.warnings.some((w) => w.step === 'hosts')).toBe(true); + // The shared runtime still lands, so explicit wiring stays one command away. + expect(existsSync(join(project, '.cladding', 'host', 'serve.cjs'))).toBe(true); + } finally { + rmSync(bareHome, {recursive: true, force: true}); + } }); - // AC-003 — delta: previously undetected host added later → wired on next run. - test('delta-wires a host that was not installed on the previous run', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - const first = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - expect(first.wiring.gemini_extension).toBe('skipped-not-installed'); + test('keeps machine-specific runtime state out of a Git worktree', async () => { + mkdirSync(join(project, '.git', 'info'), {recursive: true}); + writeFileSync(join(project, '.git', 'info', 'exclude'), '# local excludes\n', 'utf8'); - // Simulate: user installs Gemini CLI between the two runs. - mkdirSync(join(home, '.gemini'), {recursive: true}); - const second = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); + await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); - expect(second.wiring.gemini_extension).toBe('created'); - expect(second.wiring.claude_plugin).toBe('unchanged'); + const exclude = readFileSync(join(project, '.git', 'info', 'exclude'), 'utf8'); + expect(exclude).toContain('/.cladding/host/'); + expect(exclude).toContain('/.cladding/setup-status.json'); }); - // AC-004 — update: symlink target changed (cladding upgraded to a new path). - test('re-wires when the symlink target no longer matches the current cladding root', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - const oldPkg = mkdtempSync(join(tmpdir(), 'clad-old-pkg-')); - writeFileSync(join(oldPkg, 'package.json'), JSON.stringify({version: '0.3.60'})); - mkdirSync(join(home, '.claude', 'plugins'), {recursive: true}); - symlinkSync(oldPkg, join(home, '.claude', 'plugins', 'cladding'), 'dir'); - - const result = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - - expect(['created', 'rewired']).toContain(result.wiring.claude_plugin); - const linked = readlinkSync(join(home, '.claude', 'plugins', 'cladding')); - expect(resolve(linked)).toBe(resolve(pkgRoot)); - - rmSync(oldPkg, {recursive: true, force: true}); + test('host configs use the portable project runtime rather than an npm absolute path', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + + const codex = readFileSync(join(project, '.codex', 'config.toml'), 'utf8'); + const gemini = readFileSync(join(project, '.gemini', 'settings.json'), 'utf8'); + const cursor = readFileSync(join(project, '.cursor', 'mcp.json'), 'utf8'); + const cursorCli = readFileSync(join(project, '.cursor', 'cli.json'), 'utf8'); + const runtime = readFileSync(join(project, '.cladding', 'host', 'serve.cjs'), 'utf8'); + const geminiPolicy = readFileSync( + join(project, '.cladding', 'host', 'gemini-doctor-policy.toml'), + 'utf8', + ); + expect(codex).toContain('.cladding/host/serve.cjs'); + expect(codex).toContain('default_tools_approval_mode = "writes"'); + expect(gemini).toContain('.cladding/host/serve.cjs'); + expect(cursor).toContain('.cladding/host/serve.cjs'); + expect(cursorCli).toContain('Mcp(cladding:clad_list_features)'); + expect(cursorCli).toContain('Mcp(cladding:clad_get_feature)'); + expect(cursorCli).toContain('Mcp(cladding:clad_run_check)'); + expect(cursorCli).not.toContain('Mcp(cladding:*)'); + expect(JSON.parse(cursorCli).permissions.deny).toEqual([]); + expect(codex).not.toContain(pkgRoot); + expect(runtime).toContain(join(pkgRoot, 'dist', 'clad.js')); + expect(geminiPolicy).toContain('toolAnnotations = { readOnlyHint = true }'); + expect(geminiPolicy).toContain('modes = ["plan"]'); + expect(geminiPolicy).toContain('toolName = "exit_plan_mode"'); + expect(geminiPolicy).toMatch(/mcpName = "cladding"[\s\S]*toolName = "\*"[\s\S]*decision = "deny"/); + expect(geminiPolicy).not.toContain('yolo'); }); - // AC-005 — repair: symlink deleted → re-create on next run. - test('re-creates a missing symlink as a repair', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); + test('project runtime pins MCP and shell commands to the same engine', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); - rmSync(join(home, '.claude', 'plugins', 'cladding'), {force: true}); - expect(existsSync(join(home, '.claude', 'plugins', 'cladding'))).toBe(false); + const runtime = join(project, '.cladding', 'host', 'serve.cjs'); + const mcp = spawnSync(process.execPath, [runtime], {cwd: project, encoding: 'utf8'}); + const cli = spawnSync(process.execPath, [runtime, 'check', '--strict'], {cwd: project, encoding: 'utf8'}); - const result = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - expect(result.wiring.claude_plugin).toBe('created'); - expect(existsSync(join(home, '.claude', 'plugins', 'cladding'))).toBe(true); + expect(mcp.status).toBe(0); + expect(mcp.stdout).toBe('["serve"]'); + expect(cli.status).toBe(0); + expect(cli.stdout).toBe('["check","--strict"]'); }); - // AC-008 — npm install must not run any wiring code (no postinstall hook). - // This is enforced at package.json level; we sanity-check by confirming the - // exported runner is opt-in (importing the module has no filesystem effect). - test('importing host-setup does not wire anything on its own', () => { - // The module is already imported at the top of this file. If importing - // had wired anything, ~/.cladding/ would exist on the test machine — but - // this test runs against a fresh tmp home where nothing should exist - // until runHostSetup is explicitly invoked. - expect(existsSync(join(home, '.cladding'))).toBe(false); - }); - - // AC-009 — directory-copy fallback with diverged contents → skipped unless --force. - test('refuses to overwrite a non-symlink wire without --force', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - const linkParent = join(home, '.claude', 'plugins'); - mkdirSync(linkParent, {recursive: true}); - // Simulate Win directory-copy fallback: a real directory at the link path. - mkdirSync(join(linkParent, 'cladding'), {recursive: true}); - writeFileSync(join(linkParent, 'cladding', 'user-customised.txt'), 'do not lose this'); + test('is idempotent and stores setup status under the project', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, version: '0.9.0', quiet: true, activate: false}); + const second = await runHostSetup({home, projectRoot: project, pkgRoot, version: '0.9.0', quiet: true, activate: false}); - const result = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); + expect(second.wiring.runtime).toBe('unchanged'); + expect(second.wiring.codex).toBe('unchanged'); + expect(second.wiring.gemini).toBe('unchanged'); + expect(second.wiring.cursor).toBe('unchanged'); + expect(getLastSetupVersion(project)).toBe('0.9.0'); + expect(second.statusFile).toBe(join(resolve(project), '.cladding', 'setup-status.json')); + }); - expect(result.wiring.claude_plugin).toBe('skipped-different'); - // User customisation is preserved. - expect(existsSync(join(linkParent, 'cladding', 'user-customised.txt'))).toBe(true); + test('one-host setup limits the generated surfaces', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, hosts: ['codex'], quiet: true, activate: false}); - // --force overwrites it. - const forced = await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, force: true, activate: false}); - expect(['created', 'rewired']).toContain(forced.wiring.claude_plugin); + expect(existsSync(join(project, '.codex', 'config.toml'))).toBe(true); + expect(existsSync(join(project, '.agents', 'skills', 'cladding-init', 'SKILL.md'))).toBe(true); + expect(existsSync(join(project, '.cursor'))).toBe(false); + expect(existsSync(join(project, '.cladding', 'host', 'gemini-doctor-policy.toml'))).toBe(false); + expect(existsSync(join(project, '.mcp.json'))).toBe(false); }); - // Status file is written + readable via getLastSetupVersion. - test('writes setup-status.json and exposes last version via getLastSetupVersion', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); + test('Gemini-only setup writes the shared project skill and Gemini MCP settings only', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, hosts: ['gemini'], quiet: true, activate: false}); - await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - - const statusFile = join(home, '.cladding', 'setup-status.json'); - expect(existsSync(statusFile)).toBe(true); - const parsed = JSON.parse(readFileSync(statusFile, 'utf8')); - expect(parsed.cladding_version).toBe('0.4.0'); - expect(getLastSetupVersion(home)).toBe('0.4.0'); + expect(existsSync(join(project, '.gemini', 'settings.json'))).toBe(true); + expect(existsSync(join(project, '.cladding', 'host', 'gemini-doctor-policy.toml'))).toBe(true); + expect(existsSync(join(project, '.agents', 'skills', 'cladding-init', 'SKILL.md'))).toBe(true); + expect(existsSync(join(project, '.codex'))).toBe(false); + expect(existsSync(join(project, '.cursor'))).toBe(false); + expect(existsSync(join(project, '.mcp.json'))).toBe(false); }); - // AC-007 — version skew between setup-status.json and binary is observable. - test('records the version used at setup time so init can detect skew', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - - await runHostSetup({home, pkgRoot, version: '0.4.0', quiet: true, activate: false}); - expect(getLastSetupVersion(home)).toBe('0.4.0'); + test('Gemini setup preserves unrelated settings and MCP servers', async () => { + mkdirSync(join(project, '.gemini'), {recursive: true}); + writeFileSync( + join(project, '.gemini', 'settings.json'), + JSON.stringify({theme: 'system', mcpServers: {other: {command: 'other'}}}), + ); - // The next "setup" pretends a newer binary; the previously recorded version - // is what init reads back for the skew warning. - expect(getLastSetupVersion(home)).not.toBe('0.5.0'); - }); -}); + await runHostSetup({home, projectRoot: project, pkgRoot, hosts: ['gemini'], quiet: true, activate: false}); -describe('getCurrentCladdingVersion', () => { - // Smoke-only — resolves the real package.json from the cladding repo root. - test('returns a non-null version when run from the cladding repo', () => { - const v = getCurrentCladdingVersion(); - // Either the real version or null (CI sandboxes may not expose pkg). - expect(v === null || /^\d+\.\d+\.\d+/.test(v)).toBe(true); + const settings = JSON.parse(readFileSync(join(project, '.gemini', 'settings.json'), 'utf8')) as { + theme?: string; + mcpServers?: Record; + }; + expect(settings.theme).toBe('system'); + expect(settings.mcpServers?.other?.command).toBe('other'); + expect(settings.mcpServers?.cladding?.args).toEqual(['.cladding/host/serve.cjs']); }); -}); -// ─── F-80d19d AC-011 / AC-012 / AC-010 / AC-006 / AC-007 + serve-launch (F-102 follow-up) ─── + test('Gemini setup preserves a conflicting Cladding entry unless force is explicit', async () => { + mkdirSync(join(project, '.gemini'), {recursive: true}); + const settingsPath = join(project, '.gemini', 'settings.json'); + writeFileSync(settingsPath, JSON.stringify({mcpServers: {cladding: {command: 'custom'}}})); -describe('MCP serve launch resolution', () => { - let home: string; - let pkgRoot: string; - - beforeEach(() => { - home = mkdtempSync(join(tmpdir(), 'clad-setup-home-')); - pkgRoot = mkdtempSync(join(tmpdir(), 'clad-setup-pkg-')); - mkdirSync(join(pkgRoot, 'plugins', 'gemini-cli'), {recursive: true}); - mkdirSync(join(pkgRoot, 'plugins', 'codex', 'skills', 'init'), {recursive: true}); - writeFileSync(join(pkgRoot, 'package.json'), JSON.stringify({version: '0.6.0'})); - }); + const safe = await runHostSetup({ + home, + projectRoot: project, + pkgRoot, + hosts: ['gemini'], + quiet: true, + activate: false, + }); + expect(safe.wiring.gemini).toBe('skipped-different'); + expect(readFileSync(settingsPath, 'utf8')).toContain('custom'); - afterEach(() => { - rmSync(home, {recursive: true, force: true}); - rmSync(pkgRoot, {recursive: true, force: true}); + const forced = await runHostSetup({ + home, + projectRoot: project, + pkgRoot, + hosts: ['gemini'], + force: true, + quiet: true, + activate: false, + }); + expect(['created', 'rewired']).toContain(forced.wiring.gemini); + expect(readFileSync(settingsPath, 'utf8')).toContain('.cladding/host/serve.cjs'); }); - test('resolves to the absolute bundled engine when dist/clad.js exists', () => { - mkdirSync(join(pkgRoot, 'dist'), {recursive: true}); - writeFileSync(join(pkgRoot, 'dist', 'clad.js'), '// bundled engine stub\n'); - - const launch = resolveServeLaunch(pkgRoot); + test('preserves a conflicting user MCP entry unless force is explicit', async () => { + mkdirSync(join(project, '.cursor'), {recursive: true}); + writeFileSync(join(project, '.cursor', 'mcp.json'), JSON.stringify({mcpServers: {cladding: {command: 'custom'}}})); - expect(launch.command).toBe('node'); - expect(launch.args[0]).toBe(join(pkgRoot, 'dist', 'clad.js')); - expect(launch.args[1]).toBe('serve'); - }); + const safe = await runHostSetup({home, projectRoot: project, pkgRoot, hosts: ['cursor'], quiet: true, activate: false}); + expect(safe.wiring.cursor).toBe('skipped-different'); + expect(readFileSync(join(project, '.cursor', 'mcp.json'), 'utf8')).toContain('custom'); - test('falls back to PATH-resolved clad when no built engine exists', () => { - const launch = resolveServeLaunch(pkgRoot); - expect(launch).toEqual({command: 'clad', args: ['serve']}); + const forced = await runHostSetup({home, projectRoot: project, pkgRoot, hosts: ['cursor'], force: true, quiet: true, activate: false}); + expect(['created', 'rewired']).toContain(forced.wiring.cursor); + expect(readFileSync(join(project, '.cursor', 'mcp.json'), 'utf8')).toContain('.cladding/host/serve.cjs'); }); - // AC-011 — Cursor wire merges mcpServers.cladding while preserving other entries. - test('wires Cursor mcp.json with the absolute engine, preserving existing servers', async () => { - mkdirSync(join(pkgRoot, 'dist'), {recursive: true}); - writeFileSync(join(pkgRoot, 'dist', 'clad.js'), '// bundled engine stub\n'); - mkdirSync(join(home, '.cursor'), {recursive: true}); + test('Cursor permissions preserve unrelated allow and deny entries', async () => { + mkdirSync(join(project, '.cursor'), {recursive: true}); writeFileSync( - join(home, '.cursor', 'mcp.json'), - JSON.stringify({mcpServers: {other: {command: 'other-server', args: []}}}), + join(project, '.cursor', 'cli.json'), + JSON.stringify({permissions: {allow: ['Shell(git)'], deny: ['Shell(rm)']}, theme: 'dark'}), ); - const result = await runHostSetup({home, pkgRoot, version: '0.6.0', quiet: true, activate: false}); + await runHostSetup({ + home, + projectRoot: project, + pkgRoot, + hosts: ['cursor'], + quiet: true, + activate: false, + }); - expect(result.wiring.cursor_mcp).toBe('created'); - const written = JSON.parse(readFileSync(join(home, '.cursor', 'mcp.json'), 'utf8')) as { - mcpServers: Record; + const config = JSON.parse(readFileSync(join(project, '.cursor', 'cli.json'), 'utf8')) as { + permissions: {allow: string[]; deny: string[]}; + theme: string; }; - expect(written.mcpServers.other.command).toBe('other-server'); - expect(written.mcpServers.cladding.command).toBe('node'); - expect(written.mcpServers.cladding.args[0]).toBe(join(pkgRoot, 'dist', 'clad.js')); + expect(config.theme).toBe('dark'); + expect(config.permissions.deny).toEqual(['Shell(rm)']); + expect(config.permissions.allow).toEqual([ + 'Shell(git)', + 'Mcp(cladding:clad_list_features)', + 'Mcp(cladding:clad_get_feature)', + 'Mcp(cladding:clad_run_check)', + ]); }); - // The dead-server bug: a PATH-resolved `clad` entry from an older setup is - // re-wired to the absolute engine on the next run. - test('re-wires a legacy PATH-resolved codex entry to the absolute engine', async () => { - mkdirSync(join(pkgRoot, 'dist'), {recursive: true}); - writeFileSync(join(pkgRoot, 'dist', 'clad.js'), '// bundled engine stub\n'); + test('removes only provably-owned legacy global wires', async () => { + mkdirSync(join(home, '.agents', 'skills'), {recursive: true}); + mkdirSync(join(home, '.gemini', 'config', 'plugins'), {recursive: true}); + mkdirSync(join(home, '.gemini', 'extensions'), {recursive: true}); + symlinkSync(join(pkgRoot, 'plugins', 'codex', 'skills', 'init'), join(home, '.agents', 'skills', 'cladding-init')); + symlinkSync(pkgRoot, join(home, '.gemini', 'config', 'plugins', 'cladding')); + symlinkSync(pkgRoot, join(home, '.gemini', 'extensions', 'cladding')); mkdirSync(join(home, '.codex'), {recursive: true}); writeFileSync( join(home, '.codex', 'config.toml'), - '[mcp_servers.cladding]\ncommand = "clad"\nargs = ["serve"]\n', + `[mcp_servers.other]\ncommand = "other"\n\n[mcp_servers.cladding]\ncommand = "node"\nargs = [${JSON.stringify(join(pkgRoot, 'dist', 'clad.js'))}, "serve"]\n`, ); - const result = await runHostSetup({home, pkgRoot, version: '0.6.0', quiet: true, activate: false}); + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); - expect(result.wiring.codex_mcp).toBe('rewired'); - const toml = readFileSync(join(home, '.codex', 'config.toml'), 'utf8'); - expect(toml).toContain(join(pkgRoot, 'dist', 'clad.js')); - expect(toml).toContain('"node"'); + expect(result.legacyCleanup.codex_skills).toBe('removed'); + expect(result.legacyCleanup.gemini_extension).toBe('removed'); + expect(result.legacyCleanup.antigravity_plugin).toBe('removed'); + expect(result.legacyCleanup.codex_mcp).toBe('removed'); + expect(existsSync(join(home, '.agents', 'skills', 'cladding-init'))).toBe(false); + expect(existsSync(join(home, '.gemini', 'extensions', 'cladding'))).toBe(false); + expect(readFileSync(join(home, '.codex', 'config.toml'), 'utf8')).toContain('other'); }); -}); -describe('activation (AC-012) — non-interactive, injectable, opt-out', () => { - let home: string; - let pkgRoot: string; + test('delta-wires a host that appears after the first run, leaving wired ones untouched', async () => { + rmSync(join(home, '.cursor'), {recursive: true, force: true}); + const first = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + expect(first.wiring.cursor).toBe('skipped-not-selected'); + expect(existsSync(join(project, '.cursor'))).toBe(false); - beforeEach(() => { - home = mkdtempSync(join(tmpdir(), 'clad-setup-home-')); - pkgRoot = mkdtempSync(join(tmpdir(), 'clad-setup-pkg-')); - mkdirSync(join(pkgRoot, 'plugins', 'gemini-cli'), {recursive: true}); - writeFileSync(join(pkgRoot, 'package.json'), JSON.stringify({version: '0.6.0'})); + mkdirSync(join(home, '.cursor'), {recursive: true}); + const second = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + expect(second.wiring.cursor).toBe('created'); + expect(second.wiring.codex).toBe('unchanged'); + expect(existsSync(join(project, '.cursor', 'mcp.json'))).toBe(true); }); - afterEach(() => { - rmSync(home, {recursive: true, force: true}); - rmSync(pkgRoot, {recursive: true, force: true}); + test('re-wires the project runtime when the engine root changes (upgrade path)', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + const pkgRoot2 = mkdtempSync(join(tmpdir(), 'clad-pkg2-')); + try { + mkdirSync(join(pkgRoot2, 'dist'), {recursive: true}); + mkdirSync(join(pkgRoot2, 'plugins', 'codex', 'skills', 'init'), {recursive: true}); + writeFileSync(join(pkgRoot2, 'dist', 'clad.js'), 'process.stdout.write("v2");\n'); + writeFileSync(join(pkgRoot2, 'package.json'), JSON.stringify({name: 'cladding', version: '0.9.1'})); + writeFileSync(join(pkgRoot2, 'plugins', 'codex', 'skills', 'init', 'SKILL.md'), '---\nname: init\ndescription: x\n---\n'); + + const result = await runHostSetup({home, projectRoot: project, pkgRoot: pkgRoot2, quiet: true, activate: false}); + expect(result.wiring.runtime).toBe('rewired'); + expect(readFileSync(join(project, '.cladding', 'host', 'serve.cjs'), 'utf8')) + .toContain(join(pkgRoot2, 'dist', 'clad.js')); + } finally { + rmSync(pkgRoot2, {recursive: true, force: true}); + } }); - test('invokes the claude activator with the wired plugin path', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - const calls: string[] = []; - - await runHostSetup({ - home, - pkgRoot, - version: '0.6.0', - quiet: true, - activators: {claude: (p) => (calls.push(p), {attempted: true, success: true})}, - }); - - expect(calls).toEqual([join(home, '.claude', 'plugins', 'cladding')]); + test('re-creates a deleted project runtime as a repair, no separate flag', async () => { + await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + rmSync(join(project, '.cladding', 'host', 'serve.cjs')); + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + expect(result.wiring.runtime).toBe('created'); + expect(existsSync(join(project, '.cladding', 'host', 'serve.cjs'))).toBe(true); }); - test('does not activate channels that were not wired', async () => { - // No host dirs at all — nothing wired, nothing activated. - const calls: string[] = []; - - await runHostSetup({ - home, - pkgRoot, - version: '0.6.0', - quiet: true, - activators: { - claude: (p) => (calls.push(p), {attempted: true, success: true}), - gemini: (p) => (calls.push(p), {attempted: true, success: true}), - }, - }); + test('hostWireNotice guides toward clad setup and surfaces version skew without blocking', () => { + expect(hostWireNotice(null, '0.9.0')).toContain('clad setup'); + const skew = hostWireNotice('0.8.3', '0.9.0'); + expect(skew).toContain('0.8.3'); + expect(skew).toContain('0.9.0'); + expect(hostWireNotice('0.9.0', '0.9.0')).toBeNull(); + }); - expect(calls).toEqual([]); + test('codex legacy cleanup preserves user comments and formatting outside the cladding entry', async () => { + mkdirSync(join(home, '.codex'), {recursive: true}); + const before = [ + '# precious top comment', + 'model = "gpt-x" # inline note', + '', + '[mcp_servers.other]', + 'command = "other"', + '', + '# cladding block below', + '[mcp_servers.cladding]', + 'command = "node"', + `args = [${JSON.stringify(join(pkgRoot, 'dist', 'clad.js'))}, "serve"]`, + '', + ].join('\n'); + writeFileSync(join(home, '.codex', 'config.toml'), before); + + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false, hosts: ['claude']}); + + expect(result.legacyCleanup.codex_mcp).toBe('removed'); + const after = readFileSync(join(home, '.codex', 'config.toml'), 'utf8'); + expect(after).toContain('# precious top comment'); + expect(after).toContain('model = "gpt-x" # inline note'); + expect(after).toContain('[mcp_servers.other]'); + // The section is gone; user prose (even a comment mentioning cladding) stays. + expect(after).not.toContain('[mcp_servers.cladding]'); + expect(after).not.toContain('dist/clad.js'); + expect(after).toContain('# cladding block below'); }); - test('activate:false suppresses activation even when channels are wired', async () => { - mkdirSync(join(home, '.claude'), {recursive: true}); - const calls: string[] = []; + test('cursor legacy cleanup drops an emptied mcpServers object instead of leaving an orphan', async () => { + mkdirSync(join(home, '.cursor'), {recursive: true}); + writeFileSync(join(home, '.cursor', 'mcp.json'), `${JSON.stringify({ + mcpServers: {cladding: {command: 'node', args: [join(pkgRoot, 'dist', 'clad.js'), 'serve']}}, + }, null, 2)}\n`); - await runHostSetup({ - home, - pkgRoot, - version: '0.6.0', - quiet: true, - activate: false, - activators: {claude: (p) => (calls.push(p), {attempted: true, success: true})}, - }); + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false, hosts: ['claude']}); - expect(calls).toEqual([]); + expect(result.legacyCleanup.cursor_mcp).toBe('removed'); + const after = JSON.parse(readFileSync(join(home, '.cursor', 'mcp.json'), 'utf8')); + expect(after.mcpServers).toBeUndefined(); }); -}); -describe('setup report (AC-010) and init wire notices (AC-006/AC-007)', () => { - test('renderSetupReport ends with the numbered "Next steps" guidance block', () => { - const result = { - wiring: { - claude_plugin: 'created', - gemini_extension: 'skipped-not-installed', - codex_skills: [], - codex_mcp: 'skipped-not-installed', - cursor_mcp: 'skipped-not-installed', - }, - errors: [], - statusFile: '/tmp/status.json', - cladding_root: '/tmp/pkg', - cladding_version: '0.6.0', - last_setup_version: null, - } as const; - const detection = {claude: true, gemini: false, codex: false, agents: false, cursor: false}; - - const report = renderSetupReport(result, detection, {}); - - expect(report).toContain('Next steps:'); - expect(report).toContain('1. Restart your AI tool'); - expect(report).toContain('2. Open the project directory'); - expect(report).toContain('3. Type /cladding init'); - expect(report).toContain('4. Start building'); - }); + test('a foreign real directory at the antigravity plugin path is preserved and reported', async () => { + const dir = join(home, '.gemini', 'config', 'plugins', 'cladding'); + mkdirSync(dir, {recursive: true}); + writeFileSync(join(dir, 'mcp_config.json'), `${JSON.stringify({ + mcpServers: {cladding: {command: 'node', args: ['/somewhere/else/engine.js', 'serve']}}, + }, null, 2)}\n`); + + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false, hosts: ['antigravity']}); - // AC-006 — never ran `clad setup`. - test('hostWireNotice points at clad setup when no setup-status exists', () => { - expect(hostWireNotice(null, '0.6.0')).toContain('run `clad setup`'); + expect(result.legacyCleanup.antigravity_plugin).toBe('skipped-different'); + expect(result.wiring.antigravity).toBe('skipped-different'); + const kept = JSON.parse(readFileSync(join(dir, 'mcp_config.json'), 'utf8')); + expect(kept.mcpServers.cladding.args[0]).toBe('/somewhere/else/engine.js'); }); - // AC-007 — wired at an older binary version. - test('hostWireNotice flags version skew between wire and binary', () => { - const notice = hostWireNotice('0.5.1', '0.6.0'); - expect(notice).toContain('v0.5.1'); - expect(notice).toContain('v0.6.0'); - expect(notice).toContain('clad setup'); + test('preserves unowned global files with Cladding-like names', async () => { + const custom = mkdtempSync(join(tmpdir(), 'custom-plugin-')); + try { + mkdirSync(join(home, '.agents', 'skills'), {recursive: true}); + mkdirSync(join(home, '.gemini', 'extensions'), {recursive: true}); + symlinkSync(custom, join(home, '.agents', 'skills', 'cladding-custom')); + symlinkSync(custom, join(home, '.gemini', 'extensions', 'cladding')); + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + expect(result.legacyCleanup.codex_skills).toBe('skipped-different'); + expect(result.legacyCleanup.gemini_extension).toBe('skipped-different'); + expect(resolve(readlinkSync(join(home, '.agents', 'skills', 'cladding-custom')))).toBe(resolve(custom)); + expect(resolve(readlinkSync(join(home, '.gemini', 'extensions', 'cladding')))).toBe(resolve(custom)); + } finally { + rmSync(custom, {recursive: true, force: true}); + } }); - test('hostWireNotice is silent when wire matches the running binary', () => { - expect(hostWireNotice('0.6.0', '0.6.0')).toBeNull(); + test('report explains the project boundary and normal post-init development', async () => { + const result = await runHostSetup({home, projectRoot: project, pkgRoot, quiet: true, activate: false}); + const report = renderSetupReport(result); + expect(report).toContain('project activation'); + expect(report).toContain('Start a new AI session in this project directory'); + expect(report).toContain('After initialization, develop normally in natural language'); }); }); diff --git a/tests/cli/update.test.ts b/tests/cli/update.test.ts index 66c4ce0b..e436bb57 100644 --- a/tests/cli/update.test.ts +++ b/tests/cli/update.test.ts @@ -23,27 +23,32 @@ describe('runUpdate', () => { }); afterEach(() => rmSync(dir, {recursive: true, force: true})); - test('no spec.yaml → re-wires only, isProject false, no project files written', async () => { - const r = await runUpdate(dir, {wireHosts: okWire}); + test('no spec.yaml → nothing runs: no wiring call, isProject false, no writes', async () => { + let wireCalled = false; + const r = await runUpdate(dir, {wireHosts: async () => { wireCalled = true; return 0; }}); + expect(wireCalled).toBe(false); // wiring (and its legacy cleanup) must not fire outside a project expect(r.isProject).toBe(false); + expect(r.wiringErrors).toBe(0); expect(r.claudeMd).toBe('n/a'); expect(r.agentsMd).toBe('n/a'); expect(r.code).toBe(0); }); test('host wiring failure → exit code 1 (the one thing that blocks)', async () => { + writeFileSync(join(dir, 'spec.yaml'), SPEC); const r = await runUpdate(dir, {wireHosts: async () => 2}); expect(r.wiringErrors).toBe(2); expect(r.code).toBe(1); }); - test('fresh project → inventory written, CLAUDE.md + AGENTS.md created, code 0', async () => { + test('fresh project → inventory and both established host instruction surfaces are written', async () => { writeFileSync(join(dir, 'spec.yaml'), SPEC); const r = await runUpdate(dir, {wireHosts: okWire}); expect(r.isProject).toBe(true); expect(r.features).toBe(0); expect(r.claudeMd).toBe('created'); expect(r.agentsMd).toBe('created'); + expect(existsSync(join(dir, 'CLAUDE.md'))).toBe(true); expect(r.code).toBe(0); // inventory block was materialized into spec.yaml expect(readFileSync(join(dir, 'spec.yaml'), 'utf8')).toContain('inventory:'); @@ -53,7 +58,7 @@ describe('runUpdate', () => { writeFileSync(join(dir, 'spec.yaml'), SPEC); await runUpdate(dir, {wireHosts: okWire}); const r2 = await runUpdate(dir, {wireHosts: okWire}); - expect(r2.claudeMd).toBe('unchanged'); // section already present + fresh + expect(r2.claudeMd).toBe('unchanged'); expect(r2.agentsMd).toBe('skipped-exists'); // existing, non-stale expect(r2.code).toBe(0); }); diff --git a/tests/docs-prune.test.ts b/tests/docs-prune.test.ts index 5431abed..b3475daf 100644 --- a/tests/docs-prune.test.ts +++ b/tests/docs-prune.test.ts @@ -132,14 +132,14 @@ describe('AC-4c28425b · deleted docs leave zero dangling references outside his } }); - test('src/init/host-setup.ts carries the Gemini npm-delegation WHY directly above wireGemini', () => { + test('src/init/host-setup.ts carries the project-scoped Antigravity boundary directly', () => { const hostSetup = read('src/init/host-setup.ts'); - const fnIdx = hostSetup.indexOf('function wireGemini('); - expect(fnIdx, 'wireGemini function present').toBeGreaterThan(-1); - const before = hostSetup.slice(Math.max(0, fnIdx - 1200), fnIdx); - expect(before, 'load-bearing WHY: the symlink-mutation hazard').toContain('mutates the shared copy for every project'); - expect(before, 'names the mechanism: symlink wiring').toContain('SYMLINK'); - expect(before, 'relocates the reasoning, not just a pointer to the deleted doc').not.toContain(MARKETPLACE_DOC); + expect(hostSetup, 'load-bearing WHY: global install must not leak context').toContain( + 'Installing the CLI globally must not make Cladding visible to every AI', + ); + expect(hostSetup, 'AGY uses its project MCP discovery file').toContain("'.agents', 'mcp_config.json'"); + expect(hostSetup, 'AGY shares only the project init skill').toContain("'.agents', 'skills', 'cladding-init'"); + expect(hostSetup, 'does not point back to the deleted marketplace design').not.toContain(MARKETPLACE_DOC); }); test('src/spec/types.ts J5b comment cites the ac-hash-ids shard, not the deleted doc', () => { diff --git a/tests/init/agents-md.test.ts b/tests/init/agents-md.test.ts index 0365d778..fbba39cb 100644 --- a/tests/init/agents-md.test.ts +++ b/tests/init/agents-md.test.ts @@ -127,6 +127,17 @@ describe('renderAgentsMdManagedBlock — AC-9d3f2e88 (cross-host persona map)', }); }); +describe('renderAgentsMdManagedBlock — post-init command integrity', () => { + test('pins shell commands to the project engine and requires non-vacuous portable tests', () => { + const block = renderAgentsMdManagedBlock(null, '.'); + + expect(block).toContain('node .cladding/host/serve.cjs '); + expect(block).toContain('same engine as MCP'); + expect(block).toContain('confirm it collected relevant tests'); + expect(block).toContain('must not depend on shell-expanded glob patterns'); + }); +}); + describe('renderAgentsMdManagedBlock — AC-4b6c1a97 (graceful degrade, never throws)', () => { test('null spec renders the generic block without throwing', () => { expect(() => renderAgentsMdManagedBlock(null, '.')).not.toThrow(); diff --git a/tests/init/host-instructions.test.ts b/tests/init/host-instructions.test.ts index 6416947c..fcdf49eb 100644 --- a/tests/init/host-instructions.test.ts +++ b/tests/init/host-instructions.test.ts @@ -4,83 +4,19 @@ // and AC-010 (CLAUDE.md `## cladding` section appended idempotently when // present). -import {existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync} from 'node:fs'; +import {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 {renderAgentsMdManagedBlock} from '../../src/init/agents-md.js'; import { - AGENTS_MD_TEMPLATE, - CLAUDE_MD_SECTION, + CLAUDE_MD_SECTION, CLAUDE_MD_SECTION_MARKER, isStaleInstructions, - writeAgentsMd, writeClaudeMdSection, } from '../../src/init/host-instructions.js'; -describe('writeAgentsMd (F-90d054 AC-008)', () => { - let dir: string; - beforeEach(() => { - dir = mkdtempSync(join(tmpdir(), 'clad-host-instr-')); - }); - afterEach(() => { - rmSync(dir, {recursive: true, force: true}); - }); - - test('creates AGENTS.md when absent', () => { - const r = writeAgentsMd(dir); - expect(r).toBe('created'); - expect(existsSync(join(dir, 'AGENTS.md'))).toBe(true); - expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toBe(AGENTS_MD_TEMPLATE); - }); - - test('skips when AGENTS.md already exists (no --force)', () => { - writeFileSync(join(dir, 'AGENTS.md'), '# user-authored\n'); - const r = writeAgentsMd(dir); - expect(r).toBe('skipped-exists'); - expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toBe('# user-authored\n'); - }); - - test('overwrites when --force', () => { - writeFileSync(join(dir, 'AGENTS.md'), '# user-authored\n'); - const r = writeAgentsMd(dir, {force: true}); - expect(r).toBe('overwritten'); - expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toBe(AGENTS_MD_TEMPLATE); - }); - - // F-80d19d (v0.4.0) — removed F-90d054's `enrichment_status` rule from the - // AGENTS.md template since project-scope plugin auto-activation now - // guarantees an AI session at `clad init` time. - - test('refreshes stale v0.3.x AGENTS.md without --force', () => { - const stale = [ - '# AGENTS.md', - '', - 'This project is managed by **cladding**.', - '', - '## cladding — first-task enrichment rule', - '', - 'If `spec.yaml._meta.enrichment_status` equals "pending", run enrichment.', - '', - '- Never hand-author `F-NNN` filenames — use `clad_create_feature` MCP', - ' tool.', - '', - ].join('\n'); - writeFileSync(join(dir, 'AGENTS.md'), stale); - const r = writeAgentsMd(dir); - expect(r).toBe('refreshed-stale'); - expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toBe(AGENTS_MD_TEMPLATE); - }); - - test('does not refresh AGENTS.md that lacks v0.3.x markers', () => { - const userBody = '# AGENTS.md\n\nMy own notes — nothing about cladding.\n'; - writeFileSync(join(dir, 'AGENTS.md'), userBody); - const r = writeAgentsMd(dir); - expect(r).toBe('skipped-exists'); - expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toBe(userBody); - }); -}); - describe('writeClaudeMdSection (F-90d054 AC-009 + AC-010)', () => { let dir: string; beforeEach(() => { @@ -187,8 +123,8 @@ describe('isStaleInstructions', () => { ).toBe(true); }); - test('does not flag the v0.4.0 conditional wording', () => { - expect(isStaleInstructions(AGENTS_MD_TEMPLATE)).toBe(false); + test('does not flag the current emitted surfaces (no re-sync churn)', () => { + expect(isStaleInstructions(renderAgentsMdManagedBlock(null))).toBe(false); expect(isStaleInstructions(CLAUDE_MD_SECTION)).toBe(false); }); @@ -205,8 +141,8 @@ describe('isStaleInstructions', () => { expect(isStaleInstructions(preCadence)).toBe(true); }); - test('both v0.4.x templates carry the feature-cycle cadence marker', () => { - expect(AGENTS_MD_TEMPLATE).toContain('Feature cycle — one at a time'); + test('both emitted surfaces carry the feature-cycle cadence marker', () => { + expect(renderAgentsMdManagedBlock(null)).toContain('Feature cycle — one at a time'); expect(CLAUDE_MD_SECTION).toContain('Feature cycle — one at a time'); }); diff --git a/tests/init/skill-activation.test.ts b/tests/init/skill-activation.test.ts new file mode 100644 index 00000000..9743eeca --- /dev/null +++ b/tests/init/skill-activation.test.ts @@ -0,0 +1,29 @@ +// Cladding · globally installed skill activation boundary (F-0f4dd6 AC-017). + +import {readFileSync, readdirSync} from 'node:fs'; +import {join} from 'node:path'; + +import {describe, expect, test} from 'vitest'; + +const ACTIVATION_GUARD = + 'Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects.'; + +describe('Cladding skill activation boundary', () => { + test('the canonical init skill name matches its parent directory', () => { + const initSkill = readFileSync(join('skills', 'init', 'SKILL.md'), 'utf8'); + expect(initSkill).toMatch(/^---\nname: init\ndescription: /); + }); + + test('every non-init verb and persona description excludes unrelated uninitialized projects', () => { + const verbFiles = readdirSync('skills') + .filter((name) => name !== 'init') + .map((name) => join('skills', name, 'SKILL.md')); + const personaFiles = readdirSync('src/agents') + .filter((name) => name.endsWith('.md') && name !== 'README.md') + .map((name) => join('src/agents', name)); + + for (const path of [...verbFiles, ...personaFiles]) { + expect(readFileSync(path, 'utf8'), path).toContain(ACTIVATION_GUARD); + } + }); +}); diff --git a/tests/instruction-led-language.test.ts b/tests/instruction-led-language.test.ts index b12aab15..6cda393b 100644 --- a/tests/instruction-led-language.test.ts +++ b/tests/instruction-led-language.test.ts @@ -11,7 +11,7 @@ // a hardcoded count), templates carry no locale parameter, and // the plain-lead-first render order is unchanged. // AC-ddb938fb — the interpreter instruction (CLAUDE_MD_SECTION + -// AGENTS_MD_TEMPLATE) explicitly directs the agent to relay +// AGENTS_MD_BLOCK) explicitly directs the agent to relay // cladding's own gate/hook messages by meaning, both freshness // literals survive, and the size guard is respected. // AC-3f34759a — unwanted-behaviour: no locale-machinery symbol may reappear @@ -55,7 +55,11 @@ import {join, relative} from 'node:path'; import {describe, expect, test} from 'vitest'; import {allDetectors} from '../src/stages/detectors/index.js'; -import {AGENTS_MD_TEMPLATE, CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {CLAUDE_MD_SECTION, isStaleInstructions} from '../src/init/host-instructions.js'; +import {renderAgentsMdManagedBlock} from '../src/init/agents-md.js'; + +// Live 0.9.0 surface for cross-host guidance (replaced AGENTS_MD_BLOCK). +const AGENTS_MD_BLOCK = renderAgentsMdManagedBlock(null); import { DETECTOR_PLAIN, doneRefusalLead, @@ -169,17 +173,17 @@ describe('AC-71ce42e5 — English-only catalog + templates, no locale machinery, // AC-ddb938fb — interpreter relay clause, freshness literals, size guard. // ═══════════════════════════════════════════════════════════════════════ describe('AC-ddb938fb — interpreter relay clause, freshness literals, size guard', () => { - const GATE_AND_HOOK = /gate and hook messages/i; - const RELAY_BY_MEANING = /relay them(?: in the user's language,)? by meaning/i; + const GATE_AND_HOOK = /gate(?:\/| and )hook messages/i; + const RELAY_BY_MEANING = /relay (?:them|gate\/hook messages)(?: in the user's language,)? by meaning/i; test('CLAUDE_MD_SECTION explicitly directs relaying cladding\'s own gate/hook messages, by meaning', () => { expect(CLAUDE_MD_SECTION).toMatch(GATE_AND_HOOK); expect(norm(CLAUDE_MD_SECTION)).toMatch(RELAY_BY_MEANING); }); - test('AGENTS_MD_TEMPLATE carries the equivalent relay clause', () => { - expect(AGENTS_MD_TEMPLATE).toMatch(GATE_AND_HOOK); - expect(norm(AGENTS_MD_TEMPLATE)).toMatch(RELAY_BY_MEANING); + test('the AGENTS.md managed block carries the equivalent relay clause', () => { + expect(AGENTS_MD_BLOCK).toMatch(GATE_AND_HOOK); + expect(norm(AGENTS_MD_BLOCK)).toMatch(RELAY_BY_MEANING); }); test('planted-needle control: a stub anchor lacking the relay clause misses; the real sentence matches (both patterns)', () => { @@ -197,7 +201,7 @@ describe('AC-ddb938fb — interpreter relay clause, freshness literals, size gua }); test('both freshness literals survive verbatim in both templates', () => { - for (const tpl of [CLAUDE_MD_SECTION, AGENTS_MD_TEMPLATE]) { + for (const tpl of [CLAUDE_MD_SECTION, AGENTS_MD_BLOCK]) { expect(tpl).toContain('anti-self-cert'); expect(tpl).toContain('Feature cycle — one at a time'); } @@ -205,7 +209,7 @@ describe('AC-ddb938fb — interpreter relay clause, freshness literals, size gua test('round trip holds: a freshly emitted section of either template is NOT stale (no re-sync churn)', () => { expect(isStaleInstructions(CLAUDE_MD_SECTION)).toBe(false); - expect(isStaleInstructions(AGENTS_MD_TEMPLATE)).toBe(false); + expect(isStaleInstructions(AGENTS_MD_BLOCK)).toBe(false); }); test('CLAUDE_MD_SECTION stays under the ceiling declared in tests/claude-md-diet.test.ts (derived, not a duplicated magic number)', () => { diff --git a/tests/scenarios/existing-adoption-lifecycle.test.ts b/tests/scenarios/existing-adoption-lifecycle.test.ts index 4ca4766d..505caa08 100644 --- a/tests/scenarios/existing-adoption-lifecycle.test.ts +++ b/tests/scenarios/existing-adoption-lifecycle.test.ts @@ -45,7 +45,6 @@ const {mkScenarioCwd, copyFixture, writeUnderCwd, EXISTING_S2_RESPONSE} = await const { assertArtifactsPresent, assertCrossTierClean, - assertProposalDivert, assertSpecCompleteness, assertTierBanner, assertNoBudgetOverages, @@ -141,10 +140,10 @@ describe('existing-adoption lifecycle — "이 프로젝트 분석해서 클래 // No proposal for spec.yaml — refine doesn't write to Tier A directly. expect(existsSync(join(scenario.path, '.cladding/scan/spec.yaml.proposal'))).toBe(false); - // Tier B artifacts diverted to proposal (refine re-wrote them). - assertProposalDivert(scenario.path, 'docs/project-context.md'); - assertProposalDivert(scenario.path, 'spec/capabilities.yaml'); - assertProposalDivert(scenario.path, 'spec/architecture.yaml'); + // Untouched generated Tier B artifacts are the active refined design. + expect(existsSync(join(scenario.path, '.cladding/scan/project-context.md.proposal'))).toBe(false); + expect(existsSync(join(scenario.path, '.cladding/scan/capabilities.yaml.proposal'))).toBe(false); + expect(existsSync(join(scenario.path, '.cladding/scan/architecture.yaml.proposal'))).toBe(false); }); test('S4 simulate new feature: hand-authored shard registers cleanly', async () => { diff --git a/tests/scenarios/greenfield-lifecycle.test.ts b/tests/scenarios/greenfield-lifecycle.test.ts index 9fd66023..709ca0e4 100644 --- a/tests/scenarios/greenfield-lifecycle.test.ts +++ b/tests/scenarios/greenfield-lifecycle.test.ts @@ -15,6 +15,7 @@ import {afterEach, beforeEach, describe, expect, test, vi} from 'vitest'; import {fileURLToPath} from 'node:url'; import {dirname, join} from 'node:path'; +import {existsSync} from 'node:fs'; vi.mock('../../src/ui/pulse.js', () => ({pulse: vi.fn()})); const dispatchMock = vi.fn<(p: string) => Promise>(); @@ -104,7 +105,7 @@ describe('greenfield lifecycle — 결제 SaaS for B2B intent', () => { expect(projectContext).toContain('결제'); }); - test('S1 → S2 refine: state advances, proposal divert fires, capabilities grow', async () => { + test('S1 → S2 refine: state advances and untouched generated design grows in place', async () => { dispatchMock.mockResolvedValueOnce(GREENFIELD_S1_RESPONSE); await runInit({cwd: scenario.path, intent: '결제 SaaS for B2B'}); @@ -118,14 +119,14 @@ describe('greenfield lifecycle — 결제 SaaS for B2B intent', () => { ); expect(stateBody).toContain('법인 사업자만'); - // Existing artifacts diverted to proposal (refine touches all four). - assertProposalDivert(scenario.path, 'docs/project-context.md'); - assertProposalDivert(scenario.path, 'spec/capabilities.yaml'); - assertProposalDivert(scenario.path, 'spec/architecture.yaml'); + // Byte-identical generated artifacts update in place; no detached design. + expect(existsSync(join(scenario.path, '.cladding/scan/project-context.md.proposal'))).toBe(false); + expect(existsSync(join(scenario.path, '.cladding/scan/capabilities.yaml.proposal'))).toBe(false); + expect(existsSync(join(scenario.path, '.cladding/scan/architecture.yaml.proposal'))).toBe(false); // Capabilities count grew (4 in S2 response vs 3 in S1). const proposalCapsBody = (await import('node:fs')).readFileSync( - join(scenario.path, '.cladding/scan/capabilities.yaml.proposal'), + join(scenario.path, 'spec/capabilities.yaml'), 'utf8', ); expect(proposalCapsBody).toContain('compliance'); diff --git a/tests/scripts/test-count.test.ts b/tests/scripts/test-count.test.ts new file mode 100644 index 00000000..6b92fb16 --- /dev/null +++ b/tests/scripts/test-count.test.ts @@ -0,0 +1,27 @@ +// Cladding · public test-count consistency guard (F-898783ee). + +import {describe, expect, test} from 'vitest'; + +import {checkClaimText, rewriteClaimText} from '../../scripts/test-count.mjs'; + +const markdown = 'tests\n| release | 10 / 10 | green |\n'; +const html = 'tests\n
10/10
\n'; + +describe('test-count.mjs (F-898783ee)', () => { + test('accepts matching Markdown and HTML claims', () => { + expect(() => checkClaimText(markdown, 'markdown', 10)).not.toThrow(); + expect(() => checkClaimText(html, 'html', 10)).not.toThrow(); + }); + + test('rejects a stale or partial public claim', () => { + expect(() => checkClaimText(markdown, 'markdown', 11)).toThrow(/collects 11/); + expect(() => checkClaimText(markdown.replace('10 / 10', '9 / 10'), 'markdown', 10)).toThrow(/not all-pass/); + }); + + test('rewrites both claims without changing surrounding content', () => { + const updated = rewriteClaimText(html, 'html', 12); + expect(updated).toContain('tests-12%2F12-brightgreen'); + expect(updated).toContain('>12/12'); + expect(() => checkClaimText(updated, 'html', 12)).not.toThrow(); + }); +}); diff --git a/tests/scripts/version-bump.test.ts b/tests/scripts/version-bump.test.ts index 179ba02f..ecf43b23 100644 --- a/tests/scripts/version-bump.test.ts +++ b/tests/scripts/version-bump.test.ts @@ -1,15 +1,15 @@ // Cladding · unit tests for scripts/version-bump.mjs (F-090) // // Tests run the script in a synthetic project tree (tmpdir with the -// nine version-bearing files at exactly the same relative paths the +// ten version-bearing files at exactly the same relative paths the // real script expects). Verifies: -// - all nine files updated atomically +// - all eleven version sites updated atomically // - idempotent (running with current version is a no-op) // - invalid SemVer rejected // - missing anchor in a file raises a clear error import {execFileSync, type ExecFileSyncOptions} from 'node:child_process'; -import {mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync} from 'node:fs'; +import {chmodSync, 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'; @@ -19,7 +19,11 @@ const SCRIPT_PATH = join(process.cwd(), 'scripts', 'version-bump.mjs'); function seedProject(dir: string, version: string): void { writeFileSync( join(dir, 'package.json'), - `{\n "name": "probe",\n "version": "${version}"\n}\n`, + `{\n "name": "cladding",\n "version": "${version}"\n}\n`, + ); + writeFileSync( + join(dir, 'package-lock.json'), + `{\n "name": "cladding",\n "version": "${version}",\n "lockfileVersion": 3,\n "packages": {\n "": {\n "name": "cladding",\n "version": "${version}"\n }\n }\n}\n`, ); mkdirSync(join(dir, 'plugins', 'claude-code', '.claude-plugin'), {recursive: true}); writeFileSync( @@ -92,13 +96,14 @@ describe('version-bump.mjs (F-090, v0.3.15)', () => { rmSync(dir, {recursive: true, force: true}); }); - test('happy path — bumps all nine files atomically', () => { + test('happy path — bumps all eleven version sites atomically', () => { seedProject(dir, '0.3.14'); const result = runScript(dir, ['0.3.15']); expect(result.status).toBe(0); - expect(result.stdout).toContain('9 files updated to 0.3.15'); + expect(result.stdout).toContain('11 version sites checked; 10 files updated to 0.3.15'); expect(readFileSync(join(dir, 'package.json'), 'utf8')).toContain('"version": "0.3.15"'); + expect(readFileSync(join(dir, 'package-lock.json'), 'utf8').match(/"version": "0\.3\.15"/g)).toHaveLength(2); expect(readFileSync(join(dir, 'plugins', 'claude-code', '.claude-plugin', 'plugin.json'), 'utf8')).toContain('"version": "0.3.15"'); expect(readFileSync(join(dir, 'plugins', 'codex', '.codex-plugin', 'plugin.json'), 'utf8')).toContain('"version": "0.3.15"'); expect(readFileSync(join(dir, 'plugins', 'gemini-cli', 'gemini-extension.json'), 'utf8')).toContain('"version": "0.3.15"'); @@ -145,5 +150,20 @@ describe('version-bump.mjs (F-090, v0.3.15)', () => { expect(result.status).not.toBe(0); expect(result.stderr).toContain('package.json'); expect(result.stderr).toContain('anchor'); + expect(readFileSync(join(dir, 'src', 'cli', 'clad.ts'), 'utf8')).toContain(".version('0.3.14')"); + }); + + test.skipIf(process.platform === 'win32')('a write failure restores files written earlier in the transaction', () => { + seedProject(dir, '0.3.14'); + const blocked = join(dir, 'plugins', 'codex', '.codex-plugin', 'plugin.json'); + chmodSync(blocked, 0o444); + const result = runScript(dir, ['0.3.15']); + chmodSync(blocked, 0o644); + + expect(result.status).not.toBe(0); + expect(result.stderr).toContain('version files restored'); + expect(readFileSync(join(dir, 'package.json'), 'utf8')).toContain('"version": "0.3.14"'); + expect(readFileSync(join(dir, 'package-lock.json'), 'utf8').match(/"version": "0\.3\.14"/g)).toHaveLength(2); + expect(readFileSync(blocked, 'utf8')).toContain('"version": "0.3.14"'); }); }); diff --git a/tests/serve/gate-footer-unavailable.test.ts b/tests/serve/gate-footer-unavailable.test.ts index c984f7c7..fc88003a 100644 --- a/tests/serve/gate-footer-unavailable.test.ts +++ b/tests/serve/gate-footer-unavailable.test.ts @@ -28,7 +28,11 @@ describe('gateFooter — engine fault fails closed, never a fabricated GREEN', ( beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'clad-gatefooter-')); - writeFileSync(join(dir, 'spec.yaml'), 'schema: "0.1"\nproject:\n name: fixture\n', 'utf8'); + writeFileSync( + join(dir, 'spec.yaml'), + 'schema: "0.1"\nproject:\n name: fixture\n language: typescript\nfeatures: []\nscenarios: []\ncapabilities: []\n', + 'utf8', + ); mkdirSync(join(dir, 'spec', 'features'), {recursive: true}); }); @@ -44,7 +48,7 @@ describe('gateFooter — engine fault fails closed, never a fabricated GREEN', ( try { const res = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'probe-feature', title: 'Probe'}, + arguments: {slug: 'probe-feature', title: 'Probe', design_impact: {classification: 'none', rationale: 'test-only feature'}}, }); const doc = JSON.parse((res.content as Array<{type: string; text: string}>)[0].text) as { gate: {pass: boolean; unavailable?: boolean; findings: unknown[]; next?: string}; diff --git a/tests/serve/init-tools.test.ts b/tests/serve/init-tools.test.ts new file mode 100644 index 00000000..fe3c7cdd --- /dev/null +++ b/tests/serve/init-tools.test.ts @@ -0,0 +1,542 @@ +// Cladding · natural-language init MCP boundary (F-0f4dd6). + +import {existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync} from 'node:fs'; +import {tmpdir} from 'node:os'; +import {dirname, join} from 'node:path'; + +import {Client} from '@modelcontextprotocol/sdk/client/index.js'; +import {InMemoryTransport} from '@modelcontextprotocol/sdk/inMemory.js'; +import {afterEach, beforeEach, describe, expect, test} from 'vitest'; +import {refineOnboarding, resolveOnboardingReview} from '../../src/cli/clarify.js'; +import {prepareHostClarify, prepareHostInit, renderHostDraft} from '../../src/cli/host-onboarding.js'; +import {runInit} from '../../src/cli/init.js'; +import {captureArtifactDigests, loadState, saveState} from '../../src/cli/scan/onboarding-state.js'; +import {buildServer, TOOL_NAMES} from '../../src/serve/server.js'; + +interface Pair { + readonly client: Client; + readonly cleanup: () => Promise; +} + +async function makePair(cwd: string, initialize: typeof runInit = runInit): Promise { + const server = buildServer({ + cwd, + name: 'cladding-init-test', + version: '0.0.0-test', + onboarding: { + renderDraft: (value) => renderHostDraft(value as Parameters[0]), + prepareInit: ({cwd: root, mode, intent}) => prepareHostInit(root, mode, intent), + initialize, + prepareClarify: (answer, {cwd: root}) => prepareHostClarify(root, answer), + clarify: refineOnboarding, + resolveReview: (targets, {cwd: root}) => resolveOnboardingReview(targets, {cwd: root}), + }, + }); + const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair(); + const client = new Client({name: 'cladding-init-client', version: '0.0.0-test'}); + await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]); + return { + client, + cleanup: async () => { + await client.close(); + await server.close(); + }, + }; +} + +function payload(result: Awaited>): Record { + const text = (result.content as Array<{type: string; text: string}>)[0].text; + return JSON.parse(text) as Record; +} + +const draft = { + mode: 'greenfield', + project_context: {why: 'Enable reliable B2B payments.', problem: 'Payment operations are fragmented.', purpose: 'Give operators one safe workflow.'}, + capabilities: [ + {id: 'payments', title: 'Payments', summary: 'Process payments safely.', surface: 'feature'}, + {id: 'audit', title: 'Audit', summary: 'Trace operator actions.', surface: 'platform'}, + {id: 'webhooks', title: 'Webhooks', summary: 'Deliver signed events.', surface: 'infrastructure'}, + ], + architecture: {layers: [{name: 'core', forbidden_imports: ['adapters']}]}, + scenarios: [{slug: 'payment-flow', title: 'Payment flow', flow: 'An operator requests and confirms a payment.'}], + questions: ['Which market launches first?'], +} as const; +async function prepare(client: Client, arguments_: Record): Promise<{token: string; confirmation: string}> { + const result = await client.callTool({name: 'clad_prepare_init', arguments: arguments_}); + const prepared = payload(result); + return {token: prepared.token as string, confirmation: prepared.approvalChallenge as string}; +} + +describe('serve/server — natural-language init tools', () => { + let dir: string; + + beforeEach(() => { + dir = mkdtempSync(join(tmpdir(), 'clad-mcp-init-')); + }); + + afterEach(() => { + rmSync(dir, {recursive: true, force: true}); + }); + + test('idea mode asks for intent before writing any project artifact', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {tools} = await client.listTools(); + expect(tools.map((tool) => tool.name).sort()).toEqual([ + 'clad_init', + 'clad_prepare_init', + 'clad_stage_init', + ]); + const result = await client.callTool({name: 'clad_prepare_init', arguments: {mode: 'idea'}}); + expect(payload(result)).toMatchObject({status: 'needs_input', changed: false}); + expect(readdirSync(dir)).toEqual([]); + } finally { + await cleanup(); + } + }); + + test('idea mode initializes through the shared engine and writes only AGENTS.md after spec', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const result = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(result.isError).not.toBe(true); + expect(payload(result)).toMatchObject({ + status: 'needs_answers', + changed: true, + onboardingSource: 'host', + }); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(true); + expect(readFileSync(join(dir, 'spec.yaml'), 'utf8')).toContain('onboarding_seeded: true'); + expect(existsSync(join(dir, 'AGENTS.md'))).toBe(true); + expect(existsSync(join(dir, 'CLAUDE.md'))).toBe(false); + const {tools} = await client.listTools(); + expect(tools.map((tool) => tool.name).sort()).toEqual([...TOOL_NAMES].sort()); + } finally { + await cleanup(); + } + }); + + test('approval envelope survives an MCP server restart without prepare writing files', async () => { + const first = await makePair(dir); + const prepared = await prepare(first.client, {mode: 'idea', intent: 'B2B payment SaaS'}); + await first.cleanup(); + expect(readdirSync(dir)).toEqual([]); + + const second = await makePair(dir); + try { + const result = await second.client.callTool({name: 'clad_init', arguments: { + token: prepared.token, + confirmation: prepared.confirmation, + draft, + }}); + expect(result.isError).not.toBe(true); + expect(payload(result)).toMatchObject({changed: true, onboardingSource: 'host'}); + } finally { + await second.cleanup(); + } + }); + + test('process-per-turn hosts can apply by exact challenge when they discard opaque tool tokens', async () => { + const first = await makePair(dir); + const prepared = await prepare(first.client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const staged = await first.client.callTool({name: 'clad_stage_init', arguments: { + token: prepared.token, + draft, + }}); + expect(payload(staged)).toMatchObject({ + status: 'staged', + changed: false, + approvalChallenge: prepared.confirmation, + }); + await first.cleanup(); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + expect(existsSync(join(dir, 'AGENTS.md'))).toBe(false); + expect(existsSync(join(dir, '.cladding', 'host', 'onboarding-pending'))).toBe(true); + + const second = await makePair(dir); + try { + const result = await second.client.callTool({name: 'clad_init', arguments: { + confirmation: prepared.confirmation, + }}); + expect(result.isError).not.toBe(true); + expect(payload(result)).toMatchObject({changed: true, onboardingSource: 'host'}); + } finally { + await second.cleanup(); + } + }); + + test('a tampered staged draft is rejected as draft_required, never rendered', async () => { + const first = await makePair(dir); + const prepared = await prepare(first.client, {mode: 'idea', intent: 'B2B payment SaaS'}); + await first.client.callTool({name: 'clad_stage_init', arguments: {token: prepared.token, draft}}); + await first.cleanup(); + + const cacheDir = join(dir, '.cladding', 'host', 'onboarding-pending'); + const [entry] = readdirSync(cacheDir); + const cachePath = join(cacheDir, entry); + const cached = JSON.parse(readFileSync(cachePath, 'utf8')) as {draft: Record}; + cached.draft.project_context = null; // the crash-shape a raw renderDraft would hit + cached.draft.capabilities = 'garbage-not-an-array'; + writeFileSync(cachePath, JSON.stringify(cached)); + + const second = await makePair(dir); + try { + const result = await second.client.callTool({name: 'clad_init', arguments: { + confirmation: prepared.confirmation, + }}); + expect(result.isError).toBe(true); + expect(payload(result)).toMatchObject({status: 'draft_required', changed: false}); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await second.cleanup(); + } + }); + + test('staging sweeps expired consent-cache envelopes left by abandoned flows', async () => { + const cacheDir = join(dir, '.cladding', 'host', 'onboarding-pending'); + mkdirSync(cacheDir, {recursive: true}); + const stale = join(cacheDir, 'deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef.json'); + writeFileSync(stale, JSON.stringify({expiresAt: Date.now() - 60_000, token: 'x', request: {}})); + + const {client, cleanup} = await makePair(dir); + try { + const prepared = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + await client.callTool({name: 'clad_stage_init', arguments: {token: prepared.token, draft}}); + expect(existsSync(stale)).toBe(false); + expect(readdirSync(cacheDir).length).toBe(1); // only the live envelope remains + } finally { + await cleanup(); + } + }); + + test('approval without a direct or staged draft fails closed', async () => { + const first = await makePair(dir); + const prepared = await prepare(first.client, {mode: 'document', document_path: (() => { + mkdirSync(join(dir, 'docs'), {recursive: true}); + writeFileSync(join(dir, 'docs', 'plan.md'), 'Complete payment product plan.'); + return 'docs/plan.md'; + })()}); + await first.cleanup(); + + const second = await makePair(dir); + try { + const result = await second.client.callTool({name: 'clad_init', arguments: { + confirmation: prepared.confirmation, + }}); + expect(result.isError).toBe(true); + expect(payload(result)).toMatchObject({status: 'draft_required', changed: false}); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await second.cleanup(); + } + }); + + test('initial request is not accepted as the separate write confirmation', async () => { + const {client, cleanup} = await makePair(dir); + try { + const intent = 'B2B payment SaaS'; + const preparation = await client.callTool({name: 'clad_prepare_init', arguments: {mode: 'idea', intent}}); + expect(payload(preparation)).toMatchObject({ + status: 'needs_confirmation', + changed: false, + requiresSeparateUserConfirmation: true, + }); + const token = payload(preparation).token as string; + const result = await client.callTool({name: 'clad_init', arguments: {token, confirmation: intent, draft}}); + expect(result.isError).toBe(true); + expect((result.content as Array<{text: string}>)[0].text).toContain('Invalid arguments'); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await cleanup(); + } + }); + + test('an arbitrary reply after preview is not accepted as approval', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const result = await client.callTool({name: 'clad_init', arguments: { + token, + confirmation: 'Which files will be created?', + draft, + }}); + expect(result.isError).toBe(true); + expect((result.content as Array<{text: string}>)[0].text).toContain('Invalid arguments'); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await cleanup(); + } + }); + + test('a malformed host draft is rejected before any write', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const result = await client.callTool({name: 'clad_init', arguments: { + token, + confirmation, + draft: {...draft, capabilities: []}, + }}); + expect(result.isError).toBe(true); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + expect(readdirSync(dir)).toEqual([]); + } finally { + await cleanup(); + } + }); + + test('a failed multi-file apply restores the pre-initialization workspace', async () => { + writeFileSync(join(dir, '.gitignore'), 'user-entry\n'); + const failingInit = (async ({cwd}: {cwd?: string}) => { + writeFileSync(join(cwd!, 'spec.yaml'), 'partial\n'); + writeFileSync(join(cwd!, '.gitignore'), 'clobbered\n'); + throw new Error('injected write failure'); + }) as typeof runInit; + const {client, cleanup} = await makePair(dir, failingInit); + try { + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const result = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(result.isError).toBe(true); + expect(payload(result)).toMatchObject({status: 'failed', changed: false}); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + expect(readFileSync(join(dir, '.gitignore'), 'utf8')).toBe('user-entry\n'); + } finally { + await cleanup(); + } + }); + + test('tools-only MCP client drives init and clarify without sampling', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const initialized = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(payload(initialized)).toMatchObject({ + status: 'needs_answers', + onboardingSource: 'host', + nextQuestion: 'Which market launches first?', + }); + + const preparedClarify = await client.callTool({name: 'clad_prepare_clarify', arguments: {answer: 'Korea'}}); + const clarifyToken = payload(preparedClarify).token as string; + const clarified = await client.callTool({name: 'clad_clarify', arguments: { + answer: 'Korea', token: clarifyToken, draft: {...draft, questions: []}, + }}); + expect(payload(clarified)).toMatchObject({ + status: 'done', + remainingQuestions: 0, + refinementSource: 'host', + }); + } finally { + await cleanup(); + } + }); + + test('user-edited onboarding design requires review before accepted proposals complete onboarding', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + writeFileSync(join(dir, 'docs', 'project-context.md'), '# User-owned context\n'); + + const prepared = await client.callTool({name: 'clad_prepare_clarify', arguments: {answer: 'Korea'} }); + const clarifyToken = payload(prepared).token as string; + const clarified = await client.callTool({name: 'clad_clarify', arguments: { + answer: 'Korea', token: clarifyToken, draft: {...draft, questions: []}, + }}); + const review = payload(clarified); + expect(review.status).toBe('needs_review'); + expect(readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8')).toBe('# User-owned context\n'); + expect(review.pendingReview).toContain('docs/project-context.md'); + + const resolved = await client.callTool({name: 'clad_resolve_onboarding_review', arguments: { + targets: review.pendingReview, + }}); + expect(payload(resolved)).toMatchObject({status: 'done', changed: true, remaining: []}); + expect(readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8')).toContain('Enable reliable B2B payments.'); + } finally { + await cleanup(); + } + }); + + test('document mode loads the full project-local planning document', async () => { + mkdirSync(join(dir, 'docs')); + mkdirSync(join(dir, 'src')); + writeFileSync(join(dir, 'src', 'index.ts'), 'export const existing = true;\n'); + const plan = Array.from({length: 40}, (_, i) => `Section ${i}: payment requirement`).join('\n'); + writeFileSync(join(dir, 'docs', 'plan.md'), plan); + const {client, cleanup} = await makePair(dir); + try { + const preparation = await client.callTool({name: 'clad_prepare_init', arguments: {mode: 'document', document_path: 'docs/plan.md'}}); + const preparedPayload = payload(preparation); + expect(preparedPayload.prompt).toContain(plan); + const token = preparedPayload.token as string; + const confirmation = preparedPayload.approvalChallenge as string; + const result = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(result.isError).not.toBe(true); + expect(readFileSync(join(dir, 'docs', 'project-context.md'), 'utf8')).toContain('Enable reliable B2B payments.'); + expect(readFileSync(join(dir, 'docs', 'conventions.md'), 'utf8')).toContain('derived from observed code'); + } finally { + await cleanup(); + } + }); + + test('document mode rejects a path that escapes the connected project', async () => { + const outside = join(dirname(dir), 'outside-plan.md'); + writeFileSync(outside, 'outside'); + const {client, cleanup} = await makePair(dir); + try { + const result = await client.callTool({ + name: 'clad_prepare_init', + arguments: {mode: 'document', document_path: '../outside-plan.md', no_llm: true}, + }); + expect(result.isError).toBe(true); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await cleanup(); + rmSync(outside, {force: true}); + } + }); + + test('document mode rejects malformed UTF-8 before preparing or writing', async () => { + mkdirSync(join(dir, 'docs')); + writeFileSync(join(dir, 'docs', 'plan.md'), Buffer.from([0xc3, 0x28])); + const {client, cleanup} = await makePair(dir); + try { + const result = await client.callTool({ + name: 'clad_prepare_init', + arguments: {mode: 'document', document_path: 'docs/plan.md'}, + }); + expect(result.isError).toBe(true); + expect(payload(result)).toMatchObject({status: 'invalid_request', changed: false}); + expect(payload(result).error).toMatch(/UTF-8/); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + } finally { + await cleanup(); + } + }); + + test('existing mode forces observed scanning for a sparse codebase', async () => { + mkdirSync(join(dir, 'src')); + writeFileSync(join(dir, 'src', 'index.ts'), 'export const value = 1;\n'); + const {client, cleanup} = await makePair(dir); + try { + const {token, confirmation} = await prepare(client, {mode: 'existing'}); + const result = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft: {...draft, mode: 'existing-adoption'}}}); + expect(result.isError).not.toBe(true); + const conventions = readFileSync(join(dir, 'docs', 'conventions.md'), 'utf8'); + expect(conventions).toContain('derived from observed code'); + expect(conventions).toContain('## Observed style'); + } finally { + await cleanup(); + } + }); + + test('an initialized project returns without changing files unless refresh is explicit', async () => { + writeFileSync(join(dir, 'spec.yaml'), 'sentinel\n'); + const {client, cleanup} = await makePair(dir); + try { + const before = readFileSync(join(dir, 'spec.yaml'), 'utf8'); + const result = await client.callTool({name: 'clad_prepare_init', arguments: {mode: 'existing'}}); + expect(payload(result)).toEqual({status: 'already_initialized', changed: false}); + expect(readFileSync(join(dir, 'spec.yaml'), 'utf8')).toBe(before); + expect(readdirSync(dir)).toEqual(['spec.yaml']); + } finally { + await cleanup(); + } + }); + + test('stale and replayed apply tokens never write twice', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {token: staleToken, confirmation: staleConfirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + writeFileSync(join(dir, 'README.md'), '# changed after prepare\n'); + const stale = await client.callTool({name: 'clad_init', arguments: {token: staleToken, confirmation: staleConfirmation, draft}}); + expect(payload(stale)).toMatchObject({status: 'stale_preparation', changed: false}); + expect(existsSync(join(dir, 'spec.yaml'))).toBe(false); + + const {token, confirmation} = await prepare(client, {mode: 'idea', intent: 'B2B payment SaaS'}); + const first = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(payload(first)).toMatchObject({changed: true}); + const specBeforeReplay = readFileSync(join(dir, 'spec.yaml'), 'utf8'); + const replay = await client.callTool({name: 'clad_init', arguments: {token, confirmation, draft}}); + expect(payload(replay)).toMatchObject({status: 'stale_preparation', changed: false}); + expect(readFileSync(join(dir, 'spec.yaml'), 'utf8')).toBe(specBeforeReplay); + } finally { + await cleanup(); + } + }); + + test('clarify returns the next pending question as structured output', async () => { + saveState(dir, { + intent: 'B2B payment SaaS', + language: 'typescript', + projectName: 'demo', + mode: 'greenfield', + startedAt: '2026-07-14T00:00:00.000Z', + status: 'active', + qa: [ + {question: 'Who is the primary user?', answer: null}, + {question: 'Which market launches first?', answer: null}, + ], + }); + mkdirSync(join(dir, 'docs'), {recursive: true}); + mkdirSync(join(dir, 'spec'), {recursive: true}); + writeFileSync(join(dir, 'spec.yaml'), 'schema: "0.1"\nproject:\n name: demo\n language: typescript\nfeatures: []\n'); + writeFileSync(join(dir, 'docs', 'project-context.md'), '# Context\n'); + writeFileSync(join(dir, 'spec', 'capabilities.yaml'), 'schema: "0.1"\ncapabilities: []\n'); + writeFileSync(join(dir, 'spec', 'architecture.yaml'), 'version: "0.1"\nlayers: []\n'); + saveState(dir, {...loadState(dir)!, artifactDigests: captureArtifactDigests(dir)}); + + const {client, cleanup} = await makePair(dir); + try { + const preparedClarify = await client.callTool({name: 'clad_prepare_clarify', arguments: {answer: 'Business operators'}}); + const token = payload(preparedClarify).token as string; + const result = await client.callTool({name: 'clad_clarify', arguments: { + answer: 'Business operators', token, draft: {...draft, questions: []}, + }}); + expect(result.isError).not.toBe(true); + expect(payload(result)).toMatchObject({ + status: 'active', + nextQuestion: 'Which market launches first?', + remainingQuestions: 1, + }); + } finally { + await cleanup(); + } + }); + + test('clarify preparation becomes stale when another session advances onboarding state', async () => { + saveState(dir, { + intent: 'B2B payment SaaS', + language: 'typescript', + projectName: 'demo', + mode: 'greenfield', + startedAt: '2026-07-14T00:00:00.000Z', + status: 'active', + qa: [{question: 'Who is the primary user?', answer: null}], + }); + mkdirSync(join(dir, 'docs'), {recursive: true}); + mkdirSync(join(dir, 'spec'), {recursive: true}); + writeFileSync(join(dir, 'spec.yaml'), 'schema: "0.1"\nproject:\n name: demo\n language: typescript\nfeatures: []\n'); + writeFileSync(join(dir, 'docs', 'project-context.md'), '# Context\n'); + writeFileSync(join(dir, 'spec', 'capabilities.yaml'), 'schema: "0.1"\ncapabilities: []\n'); + writeFileSync(join(dir, 'spec', 'architecture.yaml'), 'version: "0.1"\nlayers: []\n'); + + const {client, cleanup} = await makePair(dir); + try { + const preparation = await client.callTool({ + name: 'clad_prepare_clarify', + arguments: {answer: 'Business operators'}, + }); + const token = payload(preparation).token as string; + saveState(dir, {...loadState(dir)!, qa: [{question: 'Who is the primary user?', answer: 'Another answer'}]}); + const result = await client.callTool({name: 'clad_clarify', arguments: { + answer: 'Business operators', token, draft: {...draft, questions: []}, + }}); + expect(payload(result)).toMatchObject({status: 'stale_preparation', changed: false}); + } finally { + await cleanup(); + } + }); +}); diff --git a/tests/serve/server.test.ts b/tests/serve/server.test.ts index 092237a5..9e67f01c 100644 --- a/tests/serve/server.test.ts +++ b/tests/serve/server.test.ts @@ -47,6 +47,8 @@ features: text: probe AC two `; +const NO_DESIGN_IMPACT = {classification: 'none', rationale: 'test-only internal feature'} as const; + interface Pair { client: Client; cleanup: () => Promise; @@ -194,38 +196,55 @@ describe('serve/server — MCP read surface', () => { } }); - test('read surfaces degrade gracefully when spec.yaml is absent (no crash)', async () => { - // A project that has not run `clad init` yet — spec.yaml is absent, so - // loadSpec throws. The read tools must return an isError reply (and the - // spec resource an error payload), not crash the MCP call. + test('a project without spec.yaml exposes only the initialization bootstrap', async () => { const bare = mkdtempSync(join(tmpdir(), 'clad-serve-bare-')); const {client, cleanup} = await makePair(bare); try { - const list = await client.callTool({name: 'clad_list_features', arguments: {}}); - expect(list.isError).toBe(true); - expect((list.content as Array<{text: string}>)[0].text).toContain('spec not loaded'); - - const get = await client.callTool({name: 'clad_get_feature', arguments: {id: 'F-001'}}); - expect(get.isError).toBe(true); + const {tools} = await client.listTools(); + expect(tools.map((tool) => tool.name).sort()).toEqual([ + 'clad_init', + 'clad_prepare_init', + 'clad_stage_init', + ]); const res = await client.readResource({uri: RESOURCE_URIS.spec}); const text = (res.contents as Array<{text: string}>)[0].text; expect(JSON.parse(text).error).toContain('spec not loaded'); - // F-c6a32fff: the four graph tools carry the same recovery guidance — - // they used to surface a raw ENOENT with no way forward. - for (const name of ['clad_get_context', 'clad_get_working_set', 'clad_get_impact', 'clad_get_graph']) { - const r = await client.callTool({name, arguments: name === 'clad_get_graph' ? {} : {query: 'F-001'}}); - expect(r.isError, `${name} must fail on an absent spec`).toBe(true); - const msg = (r.content as Array<{text: string}>)[0].text; - expect(msg, `${name} must carry the clad-init guidance`).toContain('clad init'); - } + const mutation = await client.callTool({ + name: 'clad_create_feature', + arguments: { + slug: 'must-not-exist', + design_impact: {classification: 'none', rationale: 'boundary probe'}, + }, + }); + expect(mutation.isError).toBe(true); + expect((mutation.content as Array<{text: string}>)[0].text).toMatch(/not found/i); + expect(existsSync(join(bare, 'spec'))).toBe(false); } finally { await cleanup(); rmSync(bare, {recursive: true, force: true}); } }); + test('doctor surfaces advertise read-only MCP annotations', async () => { + const {client, cleanup} = await makePair(dir); + try { + const {tools} = await client.listTools(); + for (const name of ['clad_list_features', 'clad_get_feature', 'clad_run_check']) { + const tool = tools.find((candidate) => candidate.name === name); + expect(tool?.annotations).toMatchObject({ + readOnlyHint: true, + destructiveHint: false, + idempotentHint: true, + }); + } + expect(tools.find((tool) => tool.name === 'clad_init')?.annotations?.readOnlyHint).toBe(false); + } finally { + await cleanup(); + } + }); + test('clad_list_features slugSubstring filter (F-085, v0.3.10)', async () => { const {client, cleanup} = await makePair(dir); try { @@ -381,7 +400,7 @@ describe('serve/server — MCP read surface', () => { try { const result = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'new-login-flow', title: 'New login flow', status: 'planned'}, + arguments: {slug: 'new-login-flow', title: 'New login flow', status: 'planned', design_impact: NO_DESIGN_IMPACT}, }); const text = (result.content as Array<{type: string; text: string}>)[0].text; const parsed = JSON.parse(text); @@ -396,6 +415,118 @@ describe('serve/server — MCP read surface', () => { } }); + test('clad_create_feature keeps the established create-only request compatible', async () => { + const {client, cleanup} = await makePair(dir); + try { + const result = await client.callTool({ + name: 'clad_create_feature', + arguments: {slug: 'compatible-create', title: 'Compatible create', status: 'planned'}, + }); + expect(result.isError).not.toBe(true); + const payload = JSON.parse((result.content as Array<{type: string; text: string}>)[0].text) as { + path: string; + hint?: string; + designImpact?: unknown; + }; + expect(payload.hint).toContain('clad_link_capability'); + expect(payload.designImpact).toBeUndefined(); + expect(readFileSync(payload.path, 'utf8')).not.toContain('design_impact:'); + } finally { + await cleanup(); + } + }); + + test('feature creation resolves additive design and gates structural design until review', async () => { + const {client, cleanup} = await makePair(dir); + try { + mkdirSync(join(dir, 'spec', 'scenarios'), {recursive: true}); + writeFileSync( + join(dir, 'spec', 'scenarios', 'reporting-flow-a1b2c3.yaml'), + 'id: S-a1b2c3\nslug: reporting-flow\ntitle: Reporting flow\nfeatures: []\n', + ); + const additive = await client.callTool({ + name: 'clad_create_feature', + arguments: { + slug: 'payment-export', + design_impact: { + classification: 'additive', + rationale: 'Extends the existing reporting surface.', + capability: 'reporting', + capability_title: 'Reporting', + scenario: 'reporting-flow', + }, + }, + }); + const additivePayload = JSON.parse((additive.content as Array<{type: string; text: string}>)[0].text); + expect(additivePayload.designImpact.status).toBe('resolved'); + expect(readFileSync(join(dir, 'spec', 'capabilities.yaml'), 'utf8')).toContain(additivePayload.id); + expect(readFileSync(join(dir, 'spec', 'scenarios', 'reporting-flow-a1b2c3.yaml'), 'utf8')).toContain(additivePayload.id); + + const structural = await client.callTool({ + name: 'clad_create_feature', + arguments: { + slug: 'payment-service-boundary', + design_impact: { + classification: 'structural', + rationale: 'Introduces a separately deployed payment service.', + artifacts: ['spec/architecture.yaml', 'docs/project-context.md'], + }, + }, + }); + const structuralPayload = JSON.parse((structural.content as Array<{type: string; text: string}>)[0].text); + expect(structuralPayload.designImpact.status).toBe('review_required'); + expect(readFileSync(structuralPayload.path, 'utf8')).toContain('status: review_required'); + + const premature = await client.callTool({ + name: 'clad_resolve_design_impact', + arguments: {feature: structuralPayload.id}, + }); + expect(premature.isError).toBe(true); + + mkdirSync(join(dir, 'docs'), {recursive: true}); + writeFileSync(join(dir, 'spec', 'architecture.yaml'), 'layers: []\n'); + writeFileSync(join(dir, 'docs', 'project-context.md'), '# Approved service boundary\n'); + + const resolved = await client.callTool({ + name: 'clad_resolve_design_impact', + arguments: {feature: structuralPayload.id}, + }); + expect(resolved.isError).not.toBe(true); + expect(readFileSync(structuralPayload.path, 'utf8')).toContain('status: resolved'); + } finally { + await cleanup(); + } + }); + + test('feature creation rolls back every write when an additive design link fails', async () => { + const {client, cleanup} = await makePair(dir); + try { + const capabilitiesPath = join(dir, 'spec', 'capabilities.yaml'); + const beforeCapabilities = existsSync(capabilitiesPath) + ? readFileSync(capabilitiesPath, 'utf8') + : null; + const featuresPath = join(dir, 'spec', 'features'); + const beforeFeatures = existsSync(featuresPath) ? readdirSync(featuresPath).sort() : null; + const result = await client.callTool({ + name: 'clad_create_feature', + arguments: { + slug: 'atomic-additive-feature', + design_impact: { + classification: 'additive', + rationale: 'Must connect to the declared journey atomically.', + capability: 'atomic-capability', + scenario: 'missing-scenario', + }, + }, + }); + expect(result.isError).toBe(true); + expect(existsSync(featuresPath) ? readdirSync(featuresPath).sort() : null).toEqual(beforeFeatures); + expect(existsSync(capabilitiesPath) ? readFileSync(capabilitiesPath, 'utf8') : null).toBe(beforeCapabilities); + } finally { + await cleanup(); + } + }); + // Lever ① — clad_create_feature surfaces a malformed-EARS AC as an MCP error // AT CREATION (the end-to-end path that makes the shift-left lever actually // reach the agent), and writes no shard. @@ -407,6 +538,7 @@ describe('serve/server — MCP read surface', () => { arguments: { slug: 'bad-ears-flow', title: 'x', + design_impact: NO_DESIGN_IMPACT, acceptance_criteria: [{ears: 'ubiquitous', condition: 'when the user logs in', text: 't'}], }, }); @@ -430,7 +562,7 @@ describe('serve/server — MCP read surface', () => { try { const created = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'widget', title: 'Widget', status: 'done', acceptance_criteria: [{text: 'does the thing'}]}, + arguments: {slug: 'widget', title: 'Widget', status: 'done', design_impact: NO_DESIGN_IMPACT, acceptance_criteria: [{text: 'does the thing'}]}, }); const createdParsed = JSON.parse((created.content as Array<{type: string; text: string}>)[0].text); const featureId = createdParsed.id as string; @@ -583,7 +715,7 @@ describe('MCP structural channel (F-570a3f)', () => { try { const res = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'gate-footer-probe', acceptance_criteria: [{ears: 'ubiquitous', text: 'probe'}]}, + arguments: {slug: 'gate-footer-probe', design_impact: NO_DESIGN_IMPACT, acceptance_criteria: [{ears: 'ubiquitous', text: 'probe'}]}, }); const text = (res.content as Array<{type: string; text: string}>)[0].text; const parsed = JSON.parse(text) as {schema_version?: number; gate?: {pass: boolean; findings: unknown[]}}; @@ -623,7 +755,7 @@ describe('voluntary oracle labeling (F-551a1c)', () => { try { const created = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'vol-probe', status: 'done', acceptance_criteria: [{ears: 'ubiquitous', text: 'probe', test_refs: ['spec.yaml']}]}, + arguments: {slug: 'vol-probe', status: 'done', design_impact: NO_DESIGN_IMPACT, acceptance_criteria: [{ears: 'ubiquitous', text: 'probe', test_refs: ['spec.yaml']}]}, }); const feature = JSON.parse((created.content as Array<{type: string; text: string}>)[0].text) as {id: string; path: string}; const shard = readFileSync(feature.path, 'utf8'); // result path is already absolute @@ -823,7 +955,7 @@ describe('MCP syncInventory git-operation write guard (F-10cc42d1 · AC-28d60113 try { const res = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'mid-merge-feature', title: 'Mid merge', status: 'planned'}, + arguments: {slug: 'mid-merge-feature', title: 'Mid merge', status: 'planned', design_impact: NO_DESIGN_IMPACT}, }); // The create itself succeeds — only the DERIVED inventory sync is guarded. expect(res.isError).not.toBe(true); @@ -846,7 +978,7 @@ describe('MCP syncInventory git-operation write guard (F-10cc42d1 · AC-28d60113 try { const res = await client.callTool({ name: 'clad_create_feature', - arguments: {slug: 'settled-feature', title: 'Settled', status: 'planned'}, + arguments: {slug: 'settled-feature', title: 'Settled', status: 'planned', design_impact: NO_DESIGN_IMPACT}, }); expect(res.isError).not.toBe(true); expect(readFileSync(join(dir, 'spec.yaml'), 'utf8')).toContain('inventory:'); diff --git a/tests/stages/capabilities-feature-mapping.test.ts b/tests/stages/capabilities-feature-mapping.test.ts index 4a2d2167..8fd17b33 100644 --- a/tests/stages/capabilities-feature-mapping.test.ts +++ b/tests/stages/capabilities-feature-mapping.test.ts @@ -4,7 +4,7 @@ // `capabilities[].features[]` against Tier A `spec.yaml` feature ids. // Three findings: // - dangling feature id → error -// - orphan capability → warn +// - orphan capability → info while small, warn once grown // - feature without cap → info // // Detector skips silently when capabilities.yaml is missing or @@ -16,15 +16,23 @@ import {tmpdir} from 'node:os'; import {join} from 'node:path'; import {afterEach, beforeEach, describe, expect, test} from 'vitest'; -import {capabilitiesFeatureMapping} from '../../src/stages/detectors/capabilities-feature-mapping.js'; +import { + capabilitiesFeatureMapping, + DEFAULT_MIN_FEATURES_FOR_CAPABILITY_BINDINGS, +} from '../../src/stages/detectors/capabilities-feature-mapping.js'; -function writeSpec(dir: string, featureIds: readonly string[]): void { +function writeSpec( + dir: string, + featureIds: readonly string[], + onboardingSeeded = false, +): void { const features = featureIds .map((id) => ` - id: ${id}\n title: "f"\n status: planned\n modules: []\n acceptance_criteria:\n - id: AC-001\n ears: ubiquitous\n text: "x"`) .join('\n'); writeFileSync( join(dir, 'spec.yaml'), - `schema: "0.1"\nproject: {name: x, language: typescript}\nfeatures:\n${features || '[]'}\n`, + `schema: "0.1"\nproject: {name: x, language: typescript, onboarding_seeded: ${onboardingSeeded}}\n` + + `features:\n${features || '[]'}\n`, ); } @@ -97,8 +105,8 @@ describe('CAPABILITIES_FEATURE_MAPPING detector', () => { expect(errors[0].message).toContain('does not exist'); }); - test('orphan capability (features: []) → warn finding', () => { - writeSpec(dir, ['F-001']); + test('orphan capability below the maturity threshold → informational future intent', () => { + writeSpec(dir, ['F-001'], true); writeCapabilities( dir, [ @@ -112,14 +120,13 @@ describe('CAPABILITIES_FEATURE_MAPPING detector', () => { ].join('\n'), ); const findings = capabilitiesFeatureMapping.run({cwd: dir}); - const warns = findings.filter((f) => f.severity === 'warn'); - expect(warns.length).toBe(1); - expect(warns[0].message).toContain('orphan-cap'); - expect(warns[0].message).toContain('no features mapped'); + const infos = findings.filter((f) => f.severity === 'info'); + expect(infos.length).toBe(2); // orphan capability + F-001 not claimed + expect(infos.some((f) => f.message.includes('orphan-cap') && f.message.includes('future onboarding intent'))).toBe(true); }); - test('capability without features field → warn (treated as orphan)', () => { - writeSpec(dir, ['F-001']); + test('capability without features field below the threshold → info (treated as future intent)', () => { + writeSpec(dir, ['F-001'], true); writeCapabilities( dir, [ @@ -132,9 +139,31 @@ describe('CAPABILITIES_FEATURE_MAPPING detector', () => { ].join('\n'), ); const findings = capabilitiesFeatureMapping.run({cwd: dir}); + const infos = findings.filter((f) => f.severity === 'info'); + expect(infos.some((f) => f.message.includes('missing-features-field'))).toBe(true); + }); + + test('orphan capability at the maturity threshold → warn finding', () => { + const ids = Array.from( + {length: DEFAULT_MIN_FEATURES_FOR_CAPABILITY_BINDINGS}, + (_, index) => `F-${String(index + 1).padStart(3, '0')}`, + ); + writeSpec(dir, ids, true); + writeCapabilities( + dir, + [ + 'schema: "0.1"', + 'source: intent', + 'capabilities:', + ' - id: overdue-binding', + ' features: []', + '', + ].join('\n'), + ); + const findings = capabilitiesFeatureMapping.run({cwd: dir}); const warns = findings.filter((f) => f.severity === 'warn'); - expect(warns.length).toBe(1); - expect(warns[0].message).toContain('missing-features-field'); + expect(warns).toHaveLength(1); + expect(warns[0].message).toContain('overdue-binding'); }); test('feature without capability → info finding', () => { @@ -160,8 +189,8 @@ describe('CAPABILITIES_FEATURE_MAPPING detector', () => { ])); }); - test('mixed findings: orphan + dangling + info', () => { - writeSpec(dir, ['F-001', 'F-002']); + test('mixed findings: early orphan info + dangling error + unclaimed-feature info', () => { + writeSpec(dir, ['F-001', 'F-002'], true); writeCapabilities( dir, [ @@ -187,9 +216,29 @@ describe('CAPABILITIES_FEATURE_MAPPING detector', () => { info: findings.filter((f) => f.severity === 'info'), }; expect(bySev.error.length).toBe(1); - expect(bySev.warn.length).toBe(1); - expect(bySev.info.length).toBe(1); // F-002 unclaimed - expect(bySev.info[0].message).toContain('F-002'); + expect(bySev.warn.length).toBe(0); + expect(bySev.info.length).toBe(2); // early orphan + F-002 unclaimed + expect(bySev.info.some((f) => f.message.includes('F-002'))).toBe(true); + }); + + test('legacy project below the threshold retains the established orphan warning', () => { + writeSpec(dir, ['F-001']); + writeCapabilities( + dir, + [ + 'schema: "0.1"', + 'source: README.md', + 'capabilities:', + ' - id: unresolved-capability', + ' features: []', + '', + ].join('\n'), + ); + + const findings = capabilitiesFeatureMapping.run({cwd: dir}); + expect(findings.some((finding) => + finding.severity === 'warn' && finding.message.includes('unresolved-capability'), + )).toBe(true); }); test('malformed YAML → skip silently (other detectors flag corruption)', () => { diff --git a/tests/stages/detectors/deliverable-integrity.test.ts b/tests/stages/detectors/deliverable-integrity.test.ts index 49984226..e2a39394 100644 --- a/tests/stages/detectors/deliverable-integrity.test.ts +++ b/tests/stages/detectors/deliverable-integrity.test.ts @@ -10,7 +10,10 @@ import {tmpdir} from 'node:os'; import {join} from 'node:path'; import {afterEach, beforeEach, describe, expect, test} from 'vitest'; -import {deliverableIntegrity} from '../../../src/stages/detectors/deliverable-integrity.js'; +import { + DEFAULT_MIN_FEATURES_FOR_DELIVERABLE, + deliverableIntegrity, +} from '../../../src/stages/detectors/deliverable-integrity.js'; let dir: string; beforeEach(() => { @@ -20,15 +23,30 @@ afterEach(() => { rmSync(dir, {recursive: true, force: true}); }); -function writeSpec(opts: {deliverable?: string; done?: boolean; modules?: boolean} = {}): void { +function writeSpec(opts: { + deliverable?: string; + done?: boolean; + modules?: boolean; + featureCount?: number; + onboardingSeeded?: boolean; +} = {}): void { const done = opts.done ?? true; const deliverable = opts.deliverable ?? ''; const modules = (opts.modules ?? true) ? ' modules: [src/x.ts]\n' : ''; + const featureCount = opts.featureCount ?? 1; + const features = Array.from({length: featureCount}, (_, index) => + ` - id: F-${String(index + 1).padStart(3, '0')}\n` + + ` title: f${index + 1}\n` + + ` status: ${done ? 'done' : 'planned'}\n` + + modules + + ` acceptance_criteria:\n - id: AC-${String(index + 1).padStart(3, '0')}\n` + + ' ears: ubiquitous\n text: t\n', + ).join(''); writeFileSync( join(dir, 'spec.yaml'), - `schema: "0.1"\nproject:\n name: t\n language: typescript\n${deliverable}` + - `features:\n - id: F-001\n title: f\n status: ${done ? 'done' : 'planned'}\n${modules}` + - ' acceptance_criteria:\n - id: AC-001\n ears: ubiquitous\n text: t\n', + 'schema: "0.1"\nproject:\n name: t\n language: typescript\n' + + ` onboarding_seeded: ${opts.onboardingSeeded ?? false}\n${deliverable}` + + `features:\n${features}`, ); } function run(): readonly {detector: string; severity: string; message: string}[] { @@ -36,14 +54,29 @@ function run(): readonly {detector: string; severity: string; message: string}[] } describe('DELIVERABLE_INTEGRITY detector', () => { - test('WARN when done features ship modules but no deliverable is declared', () => { - writeSpec(); + test('INFO when an early project ships modules before declaring a deliverable', () => { + writeSpec({onboardingSeeded: true}); + const findings = run(); + expect(findings).toHaveLength(1); + expect(findings[0].severity).toBe('info'); + expect(findings[0].message).toMatch(/ship modules but project.deliverable is not declared/); + }); + + test('WARN once a grown project still ships modules without a deliverable decision', () => { + writeSpec({featureCount: DEFAULT_MIN_FEATURES_FOR_DELIVERABLE, onboardingSeeded: true}); const findings = run(); expect(findings).toHaveLength(1); expect(findings[0].severity).toBe('warn'); expect(findings[0].message).toMatch(/ship modules but project.deliverable is not declared/); }); + test('WARN for a legacy early project without an onboarding marker', () => { + writeSpec(); + const findings = run(); + expect(findings).toHaveLength(1); + expect(findings[0].severity).toBe('warn'); + }); + test('ERROR when deliverable.path is declared but missing on disk', () => { writeSpec({deliverable: ' deliverable:\n path: ./run\n'}); // no ./run written const findings = run(); diff --git a/tests/stages/lint.test.ts b/tests/stages/lint.test.ts index 229b55d7..aad3f3f5 100644 --- a/tests/stages/lint.test.ts +++ b/tests/stages/lint.test.ts @@ -28,6 +28,9 @@ const execaSyncMock = execaMod.execaSync as unknown as ReturnType; describe('runLint (stage_1.2)', () => { let dir: string; + const seedLintProject = () => { + writeFileSync(join(dir, 'package.json'), '{"name":"x","scripts":{"lint":"eslint ."}}\n'); + }; beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'clad-lint-stage-')); execaSyncMock.mockReset(); @@ -45,8 +48,8 @@ describe('runLint (stage_1.2)', () => { expect(execaSyncMock).not.toHaveBeenCalled(); }); - test('package.json present + tool exits 0 → pass=true', () => { - writeFileSync(join(dir, 'package.json'), '{"name":"x"}\n'); + test('declared lint workflow + tool exits 0 → pass=true', () => { + seedLintProject(); execaSyncMock.mockReturnValueOnce({exitCode: 0, stdout: '', stderr: ''}); const r = runLint({cwd: dir}); expect(r.pass).toBe(true); @@ -54,7 +57,7 @@ describe('runLint (stage_1.2)', () => { }); test('tool non-zero exit + stderr → pass=false with stderr', () => { - writeFileSync(join(dir, 'package.json'), '{"name":"x"}\n'); + seedLintProject(); execaSyncMock.mockReturnValueOnce({ exitCode: 1, stdout: '', @@ -66,7 +69,7 @@ describe('runLint (stage_1.2)', () => { }); test('tool non-zero exit + no stderr → pass=false, no stderr field', () => { - writeFileSync(join(dir, 'package.json'), '{"name":"x"}\n'); + seedLintProject(); execaSyncMock.mockReturnValueOnce({exitCode: 1, stdout: '', stderr: ''}); const r = runLint({cwd: dir}); expect(r.pass).toBe(false); @@ -81,7 +84,7 @@ describe('runLint (stage_1.2)', () => { }); test('null exit code defaults to 1', () => { - writeFileSync(join(dir, 'package.json'), '{"name":"x"}\n'); + seedLintProject(); execaSyncMock.mockReturnValueOnce({exitCode: null, stdout: '', stderr: 'killed'}); expect(runLint({cwd: dir}).exitCode).toBe(1); }); diff --git a/tests/stages/scenario-coverage.test.ts b/tests/stages/scenario-coverage.test.ts index 29c1c96e..b1f264ab 100644 --- a/tests/stages/scenario-coverage.test.ts +++ b/tests/stages/scenario-coverage.test.ts @@ -8,9 +8,9 @@ // scenarios, a single WARN fires (the integration tier never started). // Below the threshold the size guard dominates and this check is silent. // -// 2. Unconditional "hollow scenario": for every scenario whose features[] -// binds nothing (`features: []` or absent), one WARN fires regardless of -// feature count — a scenario that names no features is integration theatre. +// 2. Graduated "hollow scenario": an empty onboarding scenario is INFO below +// the threshold and WARN once grown, so future journeys do not block the +// first feature while mature projects cannot leave them unresolved. // // On spec-load failure it emits one `info` finding (the shared withSpec seam, // same policy as STATUS_DRIFT / PLANNED_BACKLOG / HOLLOW_GOVERNANCE). @@ -26,7 +26,10 @@ import { scenarioCoverage, } from '../../src/stages/detectors/scenario-coverage.js'; -const SPEC_HEADER = 'schema: "0.1"\n' + 'project: {name: x, language: typescript}\n'; +function specHeader(onboardingSeeded = false): string { + return 'schema: "0.1"\n' + + `project: {name: x, language: typescript, onboarding_seeded: ${onboardingSeeded}}\n`; +} /** Render N minimal inline feature entries (status-blind: all 'planned'). */ function inlineFeatures(n: number): string { @@ -38,8 +41,8 @@ function inlineFeatures(n: number): string { } /** Write spec.yaml with N inline features into `dir`. */ -function writeSpec(dir: string, featureCount: number): void { - writeFileSync(join(dir, 'spec.yaml'), SPEC_HEADER + inlineFeatures(featureCount)); +function writeSpec(dir: string, featureCount: number, onboardingSeeded = false): void { + writeFileSync(join(dir, 'spec.yaml'), specHeader(onboardingSeeded) + inlineFeatures(featureCount)); } /** @@ -96,18 +99,27 @@ describe('SCENARIO_COVERAGE detector', () => { expect(scenarioCoverage.run({cwd: dir})).toEqual([]); }); - test('hollow scenario below threshold: 2 features + 1 scenario binding nothing → exactly 1 warn (hollow check only)', () => { - writeSpec(dir, 2); + test('hollow scenario below threshold → exactly 1 informational future-intent finding', () => { + writeSpec(dir, 2, true); writeScenario(dir, 1, []); // features: [] → hollow const findings = scenarioCoverage.run({cwd: dir}); // Check 1 cannot fire: only 2 features AND a scenario exists. expect(findings).toHaveLength(1); - expect(findings[0].severity).toBe('warn'); + expect(findings[0].severity).toBe('info'); expect(findings[0].message).toContain('S-001'); - expect(findings[0].message).toContain('binds no features'); + expect(findings[0].message).toContain('future onboarding intent'); expect(findings[0].path).toBe('spec/scenarios/'); }); + test('legacy project below threshold retains the established hollow-scenario warning', () => { + writeSpec(dir, 2); + writeScenario(dir, 1, []); + const findings = scenarioCoverage.run({cwd: dir}); + expect(findings).toHaveLength(1); + expect(findings[0].severity).toBe('warn'); + expect(findings[0].message).not.toContain('future onboarding intent'); + }); + test('two hollow scenarios at threshold: 8 features + 2 hollow scenarios → exactly 2 warns (no "no scenarios" finding)', () => { writeSpec(dir, 8); writeScenario(dir, 1, []); // hollow @@ -172,7 +184,7 @@ describe('SCENARIO_COVERAGE under-bound flow (check 3)', () => { // 3 features WITH slugs. writeFileSync( join(dir, 'spec.yaml'), - SPEC_HEADER + + specHeader() + 'features:\n' + ' - {id: F-001, slug: auth-register, title: t, status: planned}\n' + ' - {id: F-002, slug: auth-login, title: t, status: planned}\n' + diff --git a/tests/stages/spec-conformance.test.ts b/tests/stages/spec-conformance.test.ts index aba38049..4fa47605 100644 --- a/tests/stages/spec-conformance.test.ts +++ b/tests/stages/spec-conformance.test.ts @@ -5,7 +5,16 @@ // directory otherwise, and maps a real oracle failure to a blocking exit 1 // (so GREEN can fail on latent non-conformance). execaSync is mocked. -import {mkdirSync, mkdtempSync, rmSync, writeFileSync} from 'node:fs'; +import { + existsSync, + mkdirSync, + mkdtempSync, + readFileSync, + rmSync, + statSync, + utimesSync, + writeFileSync, +} from 'node:fs'; import {tmpdir} from 'node:os'; import {join} from 'node:path'; import {afterEach, beforeEach, describe, expect, test, vi} from 'vitest'; @@ -62,6 +71,69 @@ describe('runSpecConformance (stage_2.3)', () => { expect(runSpecConformance({cwd: dir}).pass).toBe(true); }); + test('oracle-only run restores the prior full JUnit report byte-for-byte', () => { + seedTs(dir); + seedOracle(dir); + const report = join(dir, '.cladding', 'test-report.junit.xml'); + mkdirSync(join(dir, '.cladding'), {recursive: true}); + writeFileSync(report, '\n'); + const fixedTime = new Date('2026-07-15T00:00:00.000Z'); + utimesSync(report, fixedTime, fixedTime); + const original = readFileSync(report); + const originalMtime = statSync(report).mtimeMs; + execaSyncMock.mockImplementationOnce(() => { + writeFileSync(report, '\n'); + return {exitCode: 0, stdout: '', stderr: ''}; + }); + + expect(runSpecConformance({cwd: dir}).pass).toBe(true); + + expect(readFileSync(report)).toEqual(original); + expect(statSync(report).mtimeMs).toBe(originalMtime); + }); + + test('oracle-only run removes a conventional JUnit report that it alone created', () => { + seedTs(dir); + seedOracle(dir); + const report = join(dir, '.cladding', 'test-report.junit.xml'); + execaSyncMock.mockImplementationOnce(() => { + mkdirSync(join(dir, '.cladding'), {recursive: true}); + writeFileSync(report, '\n'); + return {exitCode: 0, stdout: '', stderr: ''}; + }); + + expect(runSpecConformance({cwd: dir}).pass).toBe(true); + + expect(existsSync(report)).toBe(false); + }); + + test('oracle-only run preserves both an explicit report and a framework-default report', () => { + seedTs(dir); + seedOracle(dir); + const configured = join(dir, 'reports', 'authoritative.xml'); + const conventional = join(dir, '.cladding', 'test-report.junit.xml'); + mkdirSync(join(dir, 'reports'), {recursive: true}); + mkdirSync(join(dir, '.cladding'), {recursive: true}); + writeFileSync( + join(dir, '.cladding', 'config.yaml'), + 'gate:\n test_report: reports/authoritative.xml\n', + ); + writeFileSync(configured, '\n'); + writeFileSync(conventional, '\n'); + const configuredBefore = readFileSync(configured); + const conventionalBefore = readFileSync(conventional); + execaSyncMock.mockImplementationOnce(() => { + writeFileSync(configured, '\n'); + writeFileSync(conventional, '\n'); + return {exitCode: 0, stdout: '', stderr: ''}; + }); + + expect(runSpecConformance({cwd: dir}).pass).toBe(true); + + expect(readFileSync(configured)).toEqual(configuredBefore); + expect(readFileSync(conventional)).toEqual(conventionalBefore); + }); + test('oracle present + suite fails → blocking exit 1 with stderr (GREEN can fail)', () => { seedTs(dir); seedOracle(dir); @@ -77,7 +149,11 @@ describe('runSpecConformance (stage_2.3)', () => { seedOracle(dir); execaSyncMock.mockReturnValueOnce({exitCode: 0, stdout: '', stderr: ''}); runSpecConformance({cwd: dir}); - expect(execaSyncMock).toHaveBeenCalledWith('npx', ['--no-install', 'vitest', 'run', ORACLE_DIR], expect.any(Object)); + expect(execaSyncMock).toHaveBeenCalledWith( + 'npx', + ['--offline', '--no-install', 'vitest', 'run', ORACLE_DIR], + expect.any(Object), + ); }); test('missing runner binary (ENOENT) → skipped, not a false failure', () => { diff --git a/tests/stages/toolchain.test.ts b/tests/stages/toolchain.test.ts index a76f5f68..59fecb89 100644 --- a/tests/stages/toolchain.test.ts +++ b/tests/stages/toolchain.test.ts @@ -121,42 +121,52 @@ describe('detectToolchain', () => { writeFileSync(join(dir, 'biome.json'), '{}'); const tc = detectToolchain(dir); expect(tc.language).toBe('typescript'); - expect(tc.gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'biome', 'lint', '.']}); + expect(tc.gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'biome', 'lint', '.']}); }); test('typescript + .oxlintrc.json → lint gate is oxlint', () => { writeFileSync(join(dir, 'package.json'), '{}'); writeFileSync(join(dir, '.oxlintrc.json'), '{}'); - expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'oxlint']}); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'oxlint']}); }); test('typescript + .oxlintrc.jsonc → lint gate is oxlint', () => { writeFileSync(join(dir, 'package.json'), '{}'); writeFileSync(join(dir, '.oxlintrc.jsonc'), '{}'); - expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'oxlint']}); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'oxlint']}); }); test('typescript + oxlint.config.ts → lint gate is oxlint', () => { writeFileSync(join(dir, 'package.json'), '{}'); writeFileSync(join(dir, 'oxlint.config.ts'), 'export default {}'); - expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'oxlint']}); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'oxlint']}); }); - test('selection follows config presence — add biome.json swaps to biome, remove it falls back to eslint', () => { + test('selection follows declarations — add biome.json enables biome, remove it leaves lint unconfigured', () => { // State-transition: proves resolveTsLint actually reads the filesystem each call, // not a hard-coded return (defeats the one-way-test critique). writeFileSync(join(dir, 'package.json'), '{}'); - const eslintGate = {cmd: 'npx', args: ['--no-install', 'eslint', '.']}; - expect(detectToolchain(dir).gates.lint).toEqual(eslintGate); + expect(detectToolchain(dir).gates.lint).toBeUndefined(); writeFileSync(join(dir, 'biome.json'), '{}'); - expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'biome', 'lint', '.']}); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'biome', 'lint', '.']}); rmSync(join(dir, 'biome.json')); - expect(detectToolchain(dir).gates.lint).toEqual(eslintGate); + expect(detectToolchain(dir).gates.lint).toBeUndefined(); }); - test('typescript with no linter config → lint gate stays eslint (default preserved)', () => { + test('typescript with no lint script or config → lint gate is honestly unconfigured', () => { writeFileSync(join(dir, 'package.json'), '{}'); - expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--no-install', 'eslint', '.']}); + expect(detectToolchain(dir).gates.lint).toBeUndefined(); + }); + + test('typescript scripts.lint → lint gate runs the exact project-owned workflow', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"lint":"eslint src --max-warnings=0"}}'); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npm', args: ['run', '--silent', 'lint']}); + }); + + test('typescript eslint config without lint script → lint gate is eslint', () => { + writeFileSync(join(dir, 'package.json'), '{}'); + writeFileSync(join(dir, 'eslint.config.js'), 'export default []'); + expect(detectToolchain(dir).gates.lint).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'eslint', '.']}); }); test('biome takes precedence over oxlint when both configs present', () => { @@ -170,8 +180,8 @@ describe('detectToolchain', () => { writeFileSync(join(dir, 'package.json'), '{}'); writeFileSync(join(dir, 'biome.json'), '{}'); const tc = detectToolchain(dir); - expect(tc.gates.type).toEqual({cmd: 'npx', args: ['--no-install', 'tsc', '--noEmit']}); - expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--no-install', 'vitest', 'run']}); + expect(tc.gates.type).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'tsc', '--noEmit']}); + expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run']}); }); test('biome.json does not leak into a non-TS language', () => { @@ -189,8 +199,8 @@ describe('detectToolchain', () => { writeFileSync(join(dir, 'package.json'), '{}'); writeFileSync(join(dir, 'jest.config.js'), 'module.exports = {}'); const tc = detectToolchain(dir); - expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--no-install', 'jest']}); - expect(tc.gates.coverage).toEqual({cmd: 'npx', args: ['--no-install', 'jest', '--coverage']}); + expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'jest']}); + expect(tc.gates.coverage).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'jest', '--coverage']}); }); for (const cfg of ['jest.config.ts', 'jest.config.mjs', 'jest.config.cjs', 'jest.config.json']) { @@ -203,24 +213,55 @@ describe('detectToolchain', () => { test('package.json with a top-level "jest" key and no jest.config.* → test gate is jest', () => { writeFileSync(join(dir, 'package.json'), '{"jest":{}}'); - expect(detectToolchain(dir).gates.test).toEqual({cmd: 'npx', args: ['--no-install', 'jest']}); + expect(detectToolchain(dir).gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'jest']}); }); test('typescript with no jest config → test/coverage stay vitest (default preserved)', () => { writeFileSync(join(dir, 'package.json'), '{}'); const tc = detectToolchain(dir); - expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--no-install', 'vitest', 'run']}); - expect(tc.gates.coverage).toEqual({cmd: 'npx', args: ['--no-install', 'vitest', 'run', '--coverage']}); + expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run']}); + expect(tc.gates.coverage).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run', '--coverage']}); + }); + + test('custom scripts.test → npm test and no assumed coverage runner', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"test":"npm run build && node --test dist/tests/app.test.js"}}'); + const tc = detectToolchain(dir); + expect(tc.gates.test).toEqual({cmd: 'npm', args: ['test']}); + expect(tc.gates.coverage).toBeUndefined(); + }); + + test('custom test and coverage scripts → both exact project-owned workflows', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"test":"node --test","coverage":"c8 npm test"}}'); + const tc = detectToolchain(dir); + expect(tc.gates.test).toEqual({cmd: 'npm', args: ['test']}); + expect(tc.gates.coverage).toEqual({cmd: 'npm', args: ['run', '--silent', 'coverage']}); + }); + + test('simple vitest script without a coverage provider keeps unit native but omits coverage', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"test":"vitest run"},"devDependencies":{"vitest":"^4.0.0"}}'); + const tc = detectToolchain(dir); + expect(tc.gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run']}); + expect(tc.gates.coverage).toBeUndefined(); + }); + + test('simple vitest script with a coverage provider preserves the native coverage gate', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"test":"vitest run"},"devDependencies":{"vitest":"^4.0.0","@vitest/coverage-v8":"^4.0.0"}}'); + expect(detectToolchain(dir).gates.coverage).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run', '--coverage']}); + }); + + test('simple jest script selects jest without requiring a config file', () => { + writeFileSync(join(dir, 'package.json'), '{"scripts":{"test":"jest"}}'); + expect(detectToolchain(dir).gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'jest']}); }); test('test runner selection follows config presence — add jest.config.js swaps to jest, remove it falls back to vitest', () => { // State-transition: proves the test-runner resolution reads the filesystem each call, // not a hard-coded return. writeFileSync(join(dir, 'package.json'), '{}'); - const vitestGate = {cmd: 'npx', args: ['--no-install', 'vitest', 'run']}; + const vitestGate = {cmd: 'npx', args: ['--offline', '--no-install', 'vitest', 'run']}; expect(detectToolchain(dir).gates.test).toEqual(vitestGate); writeFileSync(join(dir, 'jest.config.js'), 'module.exports = {}'); - expect(detectToolchain(dir).gates.test).toEqual({cmd: 'npx', args: ['--no-install', 'jest']}); + expect(detectToolchain(dir).gates.test).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'jest']}); rmSync(join(dir, 'jest.config.js')); expect(detectToolchain(dir).gates.test).toEqual(vitestGate); }); @@ -236,7 +277,7 @@ describe('detectToolchain', () => { test('typescript arch gate scans ts,tsx,js,jsx extensions', () => { writeFileSync(join(dir, 'package.json'), '{}'); - expect(detectToolchain(dir).gates.arch).toEqual({cmd: 'npx', args: ['--no-install', 'madge', '--circular', '--extensions', 'ts,tsx,js,jsx', '.']}); + expect(detectToolchain(dir).gates.arch).toEqual({cmd: 'npx', args: ['--offline', '--no-install', 'madge', '--circular', '--extensions', 'ts,tsx,js,jsx', '.']}); }); // ─── Swift (SPM) + Flutter/Dart toolchain (F-e4159959) ─── diff --git a/tests/stages/toolchain/gate-config.test.ts b/tests/stages/toolchain/gate-config.test.ts index 8468c635..0bfab82b 100644 --- a/tests/stages/toolchain/gate-config.test.ts +++ b/tests/stages/toolchain/gate-config.test.ts @@ -10,7 +10,12 @@ import {tmpdir} from 'node:os'; import {join} from 'node:path'; import {afterEach, beforeEach, describe, expect, test} from 'vitest'; -import {expandModuleTokens, readGateConfig} from '../../../src/stages/toolchain/gate-config.js'; +import { + expandModuleTokens, + readGateConfig, + resolveTestReportPath, + testReportCandidatePaths, +} from '../../../src/stages/toolchain/gate-config.js'; import type {GradleProject} from '../../../src/stages/toolchain/module-scope.js'; let dir: string; @@ -60,6 +65,32 @@ describe('readGateConfig', () => { }); }); +describe('test report paths', () => { + test('defaults preserve every conventional report candidate in detector order', () => { + expect(testReportCandidatePaths(dir)).toEqual([ + join(dir, 'test-report.junit.xml'), + join(dir, 'coverage', 'junit.xml'), + join(dir, '.cladding', 'test-report.junit.xml'), + ]); + }); + + test('an explicit report is first while conventional runner outputs remain protected', () => { + writeConfig('gate:\n test_report: reports/authoritative.xml\n'); + expect(testReportCandidatePaths(dir)).toEqual([ + join(dir, 'reports', 'authoritative.xml'), + join(dir, 'test-report.junit.xml'), + join(dir, 'coverage', 'junit.xml'), + join(dir, '.cladding', 'test-report.junit.xml'), + ]); + }); + + test('a missing explicit report does not silently fall back to a conventional report', () => { + writeConfig('gate:\n test_report: reports/missing.xml\n'); + writeFileSync(join(dir, 'test-report.junit.xml'), '\n'); + expect(resolveTestReportPath(dir)).toBeNull(); + }); +}); + describe('expandModuleTokens', () => { test('expands {modules:TASK} to one :project:task per project', () => { const out = expandModuleTokens(['./gradlew', '{modules:test}'], [A, B]); diff --git a/tests/stages/toolchain/scoped-command.test.ts b/tests/stages/toolchain/scoped-command.test.ts index f87f964c..c7b070da 100644 --- a/tests/stages/toolchain/scoped-command.test.ts +++ b/tests/stages/toolchain/scoped-command.test.ts @@ -53,7 +53,7 @@ describe('resolveStageCommand — repo fallback', () => { writeFileSync(join(dir, 'package.json'), '{"name":"x"}'); const r = resolveStageCommand('test', {cwd: dir, focusModules: ['a']}); expect(r.cmd).toBe('npx'); - expect(r.args).toEqual(['--no-install', 'vitest', 'run']); + expect(r.args).toEqual(['--offline', '--no-install', 'vitest', 'run']); }); }); diff --git a/tests/stages/unit.test.ts b/tests/stages/unit.test.ts index 26e0a30f..1e802fbf 100644 --- a/tests/stages/unit.test.ts +++ b/tests/stages/unit.test.ts @@ -71,4 +71,22 @@ describe('runUnit (stage_2.1)', () => { execaSyncMock.mockReturnValueOnce({exitCode: null, stdout: '', stderr: ''}); expect(runUnit({cwd: dir}).exitCode).toBe(1); }); + + test('strict mode rejects a successful runner that definitively reports zero tests', () => { + execaSyncMock.mockReturnValueOnce({exitCode: 0, stdout: '# tests 0\n# pass 0', stderr: ''}); + const r = runUnit({cwd: dir, cmd: 'npm', args: ['test'], strict: true}); + expect(r.pass).toBe(false); + expect(r.exitCode).toBe(1); + expect(r.findings?.[0]?.detector).toBe('VACUOUS_TESTS'); + }); + + test('zero-test summary remains backward-compatible outside strict mode', () => { + execaSyncMock.mockReturnValueOnce({exitCode: 0, stdout: '# tests 0', stderr: ''}); + expect(runUnit({cwd: dir, cmd: 'npm', args: ['test']}).pass).toBe(true); + }); + + test('multiple workspace summaries do not false-fail when any tests executed', () => { + execaSyncMock.mockReturnValueOnce({exitCode: 0, stdout: '# tests 0\n# tests 3', stderr: ''}); + expect(runUnit({cwd: dir, cmd: 'npm', args: ['test'], strict: true}).pass).toBe(true); + }); }); diff --git a/tests/stages/util.test.ts b/tests/stages/util.test.ts index 3d4038f6..c957a48f 100644 --- a/tests/stages/util.test.ts +++ b/tests/stages/util.test.ts @@ -78,6 +78,54 @@ describe('missingToolSkip — ENOENT is the ONLY exit-2 (skip) path', () => { expect(missingToolSkip('stage_x', 'mytool', {exitCode: 1})).toBeNull(); expect(missingToolSkip('stage_x', 'mytool', {exitCode: 0})).toBeNull(); }); + + test('npx refusal under --no-install → skip because the configured tool never ran', () => { + const r = missingToolSkip('stage_x', 'npx', { + exitCode: 1, + stderr: 'npm error npx canceled due to missing packages and no YES option: ["eslint@9"]', + }); + expect(r?.exitCode).toBe(2); + expect(r?.stderr).toContain('could not resolve'); + }); + + test('offline npx cache miss → skip immediately instead of becoming a tool failure', () => { + const r = missingToolSkip('stage_x', 'npx', { + exitCode: 1, + stderr: "npm error code ENOTCACHED\nnpm error cache mode is 'only-if-cached'", + }); + expect(r?.exitCode).toBe(2); + }); + + test('offline npx shell-level command miss → visible setup gap', () => { + const r = missingToolSkip('stage_x', 'npx', { + exitCode: 127, + stderr: '/bin/sh: vitest: command not found', + }, ['--offline', '--no-install', 'vitest', 'run']); + expect(r?.exitCode).toBe(2); + expect(r?.stderr).toContain('setup gap'); + expect(r?.stderr).toContain('not installed'); + }); + + test('missing helper inside a resolved npx tool remains a failure', () => { + expect(missingToolSkip('stage_x', 'npx', { + exitCode: 127, + stderr: '/bin/sh: project-helper: command not found', + }, ['--offline', '--no-install', 'vitest', 'run'])).toBeNull(); + }); + + test('shell-level command miss from a project-owned npm script remains a failure', () => { + expect(missingToolSkip('stage_x', 'npm', { + exitCode: 127, + stderr: '/bin/sh: project-helper: command not found', + })).toBeNull(); + }); + + test('the same text from a project-owned npm script is still a real failure', () => { + expect(missingToolSkip('stage_x', 'npm', { + exitCode: 1, + stderr: 'could not determine executable to run', + })).toBeNull(); + }); }); // Fix ② — a scanner (secretlint / arch validator) that RAN but exited non-zero: @@ -134,4 +182,12 @@ describe('classifyScannerExit — finding vs config/setup gap', () => { ); expect(out[0].severity).toBe('info'); }); + + test('offline npx cache miss → INFO setup gap, never a scanner finding', () => { + const out = classifyScannerExit( + {exitCode: 1, stderr: 'npm error code ENOTCACHED'}, + 'ARCHITECTURE_VIOLATION', found, skipped, + ); + expect(out[0].severity).toBe('info'); + }); });