@event4u/agent-config 16.4.0 → 17.0.0

package/dist/agent-src/skills/project-analysis-hypothesis-driven/SKILL.md

@@ -1,6 +1,6 @@
 ---
 model_tier: high
-context: large
+context_window: large
 name: project-analysis-hypothesis-driven
 description: "Use when a bug has multiple plausible causes across layers — competing hypotheses, validation loops, evidence-based conclusions — even when the user just says 'why is this happening?'."
 domain: discovery

package/dist/agent-src/skills/project-analyzer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 model_tier: high
-context: large
+context_window: large
 name: project-analyzer
 description: "Single-pass tech-stack detection with an agents/evidence/analysis/ write-up; explicit request only. Deep multi-pass audit → universal-project-analysis. Raw primitives → project-analysis-core."
 domain: discovery
@@ -39,6 +39,19 @@ A **project analysis** is a systematic walkthrough of the entire codebase that:
 
 It orchestrates other skills and commands to produce a comprehensive picture.
 
+[`procedure.yaml`](procedure.yaml) holds the order: run phases one at a time, each only after the previous met its exit. A `judgement` exit is sequenced, not verified: state your decision first. Phase 3–6 without its layer writes `not-applicable.md` (Phase 6: `service-map.md`) saying why — an absent layer is a finding, not a skip.
+
+1. [Phase 1: Project overview](references/steps/01-project-overview.md) — exit: `check: analysis-overview-matches-manifests`
+2. [Phase 2: Architecture](references/steps/02-architecture.md) — exit: `exists: agents/evidence/analysis/architecture`
+3. [Phase 3: Data layer](references/steps/03-data-layer.md) — exit: `exists: agents/evidence/analysis/models`
+4. [Phase 4: Business domains](references/steps/04-business-domains.md) — exit: `exists: agents/evidence/analysis/domains`
+5. [Phase 5: API surface](references/steps/05-api-surface.md) — exit: `exists: agents/evidence/analysis/api`
+6. [Phase 6: Service map](references/steps/06-service-map.md) — exit: `exists: agents/evidence/analysis/services/service-map.md`
+7. [Phase 7: Module inventory (if modules exist)](references/steps/07-module-inventory.md) — exit: `judgement`
+8. [Phase 8: Infrastructure & testing](references/steps/08-infrastructure-and-testing.md) — exit: `exists: agents/evidence/analysis/testing/test-map.md`
+9. [Phase 9: Agent docs audit](references/steps/09-agent-docs-audit.md) — exit: `judgement`
+10. [Phase 10: Gap analysis & action plan](references/steps/10-gap-analysis.md) — exit: `judgement`
+
 ## Analysis output
 
 All analysis results are written to `agents/evidence/analysis/` in a structured directory layout.
@@ -244,80 +257,6 @@ After detecting **any** match, record the stack in the analysis output and selec
 | Code review   | `CODEOWNERS`, PR templates (`.github/pull_request_template.md`)                                                                                                     |
 | Dependencies  | Lockfile presence: `composer.lock`, `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`, `poetry.lock`, `uv.lock`, `go.sum`, `Cargo.lock`                            |
 
-## Analysis phases
-
-### Phase 1: Project overview
-
-- Read `AGENTS.md`, `.github/copilot-instructions.md`, `README.md`
-- Detect framework, version, tech stack
-- Identify build tools and quality tooling
-- Classify: legacy vs. modern, monolith vs. modular
-- **Output:** `agents/evidence/analysis/overview.md`
-
-### Phase 2: Architecture
-
-- Map directory structure (top 3 levels)
-- Identify architectural patterns (MVC, modules, services, repositories)
-- Detect multi-tenancy, queue system, caching
-- Count: models, controllers, services, jobs, commands
-- **Output:** `agents/evidence/analysis/architecture/*.md`
-
-### Phase 3: Data layer
-
-- List all models with their connections, tables, and key relationships
-- Map database schema: tables, foreign keys, indexes
-- Document multi-tenant split (which tables in which DB)
-- **Output:** `agents/evidence/analysis/models/api-database.md`, `customer-database.md`
-
-### Phase 4: Business domains
-
-- Identify domains from models, services, routes, and directory structure
-- For each domain: map models → services → controllers → jobs → events
-- Document business rules and data flows
-- Document inter-domain dependencies
-- **Output:** `agents/evidence/analysis/domains/{domain}.md` (one per domain)
-
-### Phase 5: API surface
-
-- List all endpoints with controller, request, resource, OpenAPI attributes
-- Document request/response contracts (field names, types, validation rules)
-- Map version differences (v1 vs v2)
-- **Output:** `agents/evidence/analysis/api/endpoints-v1.md`, `endpoints-v2.md`, `contracts.md`
-
-### Phase 6: Service map
-
-- List all services with purpose, key methods, and dependencies
-- Map service → repository → model relationships
-- Identify God services (too many responsibilities)
-- **Output:** `agents/evidence/analysis/services/service-map.md`
-
-### Phase 7: Module inventory (if modules exist)
-
-- List all modules with purpose
-- For each module: structure, public API, internal components, tests
-- Check for module-level agent docs
-- **Output:** `agents/evidence/analysis/modules/{module}.md` (one per module)
-
-### Phase 8: Infrastructure & testing
-
-- Docker setup, CI/CD pipelines, deployment
-- Test suites, coverage areas, test data strategy
-- **Output:** `agents/evidence/analysis/architecture/infrastructure.md`, `agents/evidence/analysis/testing/test-map.md`
-
-### Phase 9: Agent docs audit
-
-- List all existing docs in `agents/reference/docs/`, `agents/settings/contexts/`, module `agents/`
-- Check for outdated docs (reference deleted files/classes)
-- Identify undocumented areas
-- Check for stale roadmaps
-
-### Phase 10: Gap analysis & action plan
-
-- Modules without context docs → offer `/context-create`
-- Complex services without docs → offer `/context-create`
-- Existing docs that reference deleted code → offer `/context-refactor`
-- Stale roadmaps (all steps done) → suggest archiving
-
 ## Integration with other skills
 
 | Skill              | How it's used                                               |

package/dist/agent-src/skills/project-analyzer/procedure.yaml

@@ -0,0 +1,39 @@
+schema_version: 1
+brief:
+  goal: Write a structured analysis of the project under agents/evidence/analysis/ that someone could
+    rebuild it from.
+  inputs:
+  - the project tree
+  - AGENTS.md, README.md and the package manifests
+  done_when: Every in-scope phase has written its output file and the gap analysis names its follow-ups.
+steps:
+- id: project-overview
+  file: references/steps/01-project-overview.md
+  exit: 'check: analysis-overview-matches-manifests'
+- id: architecture
+  file: references/steps/02-architecture.md
+  exit: 'exists: agents/evidence/analysis/architecture'
+- id: data-layer
+  file: references/steps/03-data-layer.md
+  exit: 'exists: agents/evidence/analysis/models'
+- id: business-domains
+  file: references/steps/04-business-domains.md
+  exit: 'exists: agents/evidence/analysis/domains'
+- id: api-surface
+  file: references/steps/05-api-surface.md
+  exit: 'exists: agents/evidence/analysis/api'
+- id: service-map
+  file: references/steps/06-service-map.md
+  exit: 'exists: agents/evidence/analysis/services/service-map.md'
+- id: module-inventory
+  file: references/steps/07-module-inventory.md
+  exit: judgement
+- id: infrastructure-and-testing
+  file: references/steps/08-infrastructure-and-testing.md
+  exit: 'exists: agents/evidence/analysis/testing/test-map.md'
+- id: agent-docs-audit
+  file: references/steps/09-agent-docs-audit.md
+  exit: judgement
+- id: gap-analysis
+  file: references/steps/10-gap-analysis.md
+  exit: judgement

package/dist/agent-src/skills/project-analyzer/references/steps/01-project-overview.md

@@ -0,0 +1,9 @@
+# Analysis phases
+
+## Phase 1: Project overview
+
+- Read `AGENTS.md`, `.github/copilot-instructions.md`, `README.md`
+- Detect framework, version, tech stack
+- Identify build tools and quality tooling
+- Classify: legacy vs. modern, monolith vs. modular
+- **Output:** `agents/evidence/analysis/overview.md`

package/dist/agent-src/skills/project-analyzer/references/steps/02-architecture.md

@@ -0,0 +1,7 @@
+# Phase 2: Architecture
+
+- Map directory structure (top 3 levels)
+- Identify architectural patterns (MVC, modules, services, repositories)
+- Detect multi-tenancy, queue system, caching
+- Count: models, controllers, services, jobs, commands
+- **Output:** `agents/evidence/analysis/architecture/*.md`

package/dist/agent-src/skills/project-analyzer/references/steps/03-data-layer.md

@@ -0,0 +1,6 @@
+# Phase 3: Data layer
+
+- List all models with their connections, tables, and key relationships
+- Map database schema: tables, foreign keys, indexes
+- Document multi-tenant split (which tables in which DB)
+- **Output:** `agents/evidence/analysis/models/api-database.md`, `customer-database.md`

package/dist/agent-src/skills/project-analyzer/references/steps/04-business-domains.md

@@ -0,0 +1,7 @@
+# Phase 4: Business domains
+
+- Identify domains from models, services, routes, and directory structure
+- For each domain: map models → services → controllers → jobs → events
+- Document business rules and data flows
+- Document inter-domain dependencies
+- **Output:** `agents/evidence/analysis/domains/{domain}.md` (one per domain)

package/dist/agent-src/skills/project-analyzer/references/steps/05-api-surface.md

@@ -0,0 +1,6 @@
+# Phase 5: API surface
+
+- List all endpoints with controller, request, resource, OpenAPI attributes
+- Document request/response contracts (field names, types, validation rules)
+- Map version differences (v1 vs v2)
+- **Output:** `agents/evidence/analysis/api/endpoints-v1.md`, `endpoints-v2.md`, `contracts.md`

package/dist/agent-src/skills/project-analyzer/references/steps/06-service-map.md

@@ -0,0 +1,6 @@
+# Phase 6: Service map
+
+- List all services with purpose, key methods, and dependencies
+- Map service → repository → model relationships
+- Identify God services (too many responsibilities)
+- **Output:** `agents/evidence/analysis/services/service-map.md`

package/dist/agent-src/skills/project-analyzer/references/steps/07-module-inventory.md

@@ -0,0 +1,6 @@
+# Phase 7: Module inventory (if modules exist)
+
+- List all modules with purpose
+- For each module: structure, public API, internal components, tests
+- Check for module-level agent docs
+- **Output:** `agents/evidence/analysis/modules/{module}.md` (one per module)

package/dist/agent-src/skills/project-analyzer/references/steps/08-infrastructure-and-testing.md

@@ -0,0 +1,5 @@
+# Phase 8: Infrastructure & testing
+
+- Docker setup, CI/CD pipelines, deployment
+- Test suites, coverage areas, test data strategy
+- **Output:** `agents/evidence/analysis/architecture/infrastructure.md`, `agents/evidence/analysis/testing/test-map.md`

package/dist/agent-src/skills/project-analyzer/references/steps/09-agent-docs-audit.md

@@ -0,0 +1,6 @@
+# Phase 9: Agent docs audit
+
+- List all existing docs in `agents/reference/docs/`, `agents/settings/contexts/`, module `agents/`
+- Check for outdated docs (reference deleted files/classes)
+- Identify undocumented areas
+- Check for stale roadmaps

package/dist/agent-src/skills/project-analyzer/references/steps/10-gap-analysis.md

@@ -0,0 +1,6 @@
+# Phase 10: Gap analysis & action plan
+
+- Modules without context docs → offer `/context-create`
+- Complex services without docs → offer `/context-create`
+- Existing docs that reference deleted code → offer `/context-refactor`
+- Stale roadmaps (all steps done) → suggest archiving

package/dist/agent-src/skills/quality-tools/references/js-ts-tools.md

@@ -1,5 +1,15 @@
 # quality-tools — JS/TS quality tools
 
+<!-- reference-toc:start (generated by generate_reference_toc — do not edit) -->
+**Contents**
+
+- [Detection](#detection)
+- [Biome — Linting + Formatting](#biome--linting--formatting)
+- [TypeScript — Type Checking](#typescript--type-checking)
+- [Jest / Vitest — Testing](#jest--vitest--testing)
+- [JS/TS Quality Workflow](#jsts-quality-workflow)
+<!-- reference-toc:end -->
+
 > Mode body of the [`quality-tools`](../SKILL.md) skill (router-head
 > retrofit, 2026-08-20). Content moved VERBATIM from SKILL.md — load this
 > file when the mode table in SKILL.md routes here.

package/dist/agent-src/skills/quality-tools/references/php-tools.md

@@ -1,5 +1,18 @@
 # quality-tools — PHP quality tools
 
+<!-- reference-toc:start (generated by generate_reference_toc — do not edit) -->
+**Contents**
+
+- [Tool Detection](#tool-detection)
+- [Commands](#commands)
+- [Procedure: Run quality checks](#procedure-run-quality-checks)
+- [Configuration](#configuration)
+- [Baseline policy](#baseline-policy)
+- [PHPStan error handling](#phpstan-error-handling)
+- [Testing framework](#testing-framework)
+- [Git-aware execution](#git-aware-execution)
+<!-- reference-toc:end -->
+
 > Mode body of the [`quality-tools`](../SKILL.md) skill (router-head
 > retrofit, 2026-08-20). Content moved VERBATIM from SKILL.md — load this
 > file when the mode table in SKILL.md routes here.

package/dist/agent-src/skills/quality-tools/references/python-tools.md

@@ -1,5 +1,16 @@
 # quality-tools — Python quality tools
 
+<!-- reference-toc:start (generated by generate_reference_toc — do not edit) -->
+**Contents**
+
+- [Detection](#detection)
+- [Ruff — linting and formatting](#ruff--linting-and-formatting)
+- [mypy — type checking](#mypy--type-checking)
+- [pytest — the test runner](#pytest--the-test-runner)
+- [Workflow sequence](#workflow-sequence)
+- [Gotchas](#gotchas)
+<!-- reference-toc:end -->
+
 > Mode body of the [`quality-tools`](../SKILL.md) skill. Load this file when
 > the mode table in SKILL.md routes here. The cross-mode material — execution
 > policy, environment, output discipline — stays in SKILL.md and is NOT

package/dist/agent-src/skills/react-native-setup/SKILL.md

@@ -51,10 +51,15 @@ Before installing or upgrading anything, inspect what's already there — modify
 6. **Validate** — app launches, fast refresh works, Metro bundler runs without warnings.
 7. **On failure** — apply the matching pattern from "Common setup issues" below.
 
-## Prerequisites (2025 baseline)
+## Prerequisites
 
 **Node.js**
-- Node 20.x minimum (Node 18 EOL April 2025); Node 22 LTS recommended.
+- The floor is the project's own file — `.nvmrc`, `.node-version`, or
+  `engines.node`. None: a release still in Active LTS or Maintenance, with
+  the date you read the schedule. A version named here instead expired
+  unnoticed once already, which is why it is no longer named here.
+- The Xcode and Android floors below are from the 2025 baseline this heading
+  used to claim, and were not re-checked with this bullet.
 - `node --version && npm --version`.
 - npm, yarn, pnpm, bun all supported. Corepack for yarn:
   `corepack enable && corepack prepare yarn@stable --activate`.

package/dist/agent-src/skills/react-shadcn-ui/SKILL.md

@@ -30,13 +30,17 @@ execution:
 # react-shadcn-ui
 
 > **Grounded stack guidance:** pull idiomatic Do/Don't + docs URLs via
-> `./scripts-run <skills-root>/corpus-grounding/scripts/ground search
+> `node <skills-root>/corpus-grounding/scripts/ground.mjs search
 > --manifest <skills-root>/design-intelligence/data/manifest.json
 > --stack shadcn "<topic>"` (also `--stack react`, `--stack nextjs`). See
 > [`design-intelligence`](../design-intelligence/SKILL.md).
 
 ## Component installer — `scripts/shadcn_add.ts` (gated, assisted)
 
+```bash
+node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs [--list] [--dry-run] [<component> …]
+```
+
 Bundled installer (Apache-2.0-derived, see header + `design-intelligence/ATTRIBUTION.md`)
 wraps `npx shadcn@latest add <components>` — **the only subprocess+network
 surface in the adopted suite**. Per `runtime-safety` + the `execution`

package/dist/agent-src/skills/react-shadcn-ui/references/registry.md

@@ -59,3 +59,16 @@ merge `cssVars` into the project's token layer (reconcile, do not overwrite).
 updated registry) · `info --json` (project context — see the SKILL handshake)
 · `build` (publish a registry). Inspect with `view` before `add` — evidence
 before action.
+
+**A namespaced or third-party item is audited, not only viewed.** Before `add`,
+take an `@ns/item` from any registry outside the project's own through
+[`supply-chain-intake`](../../supply-chain-intake/SKILL.md), and check what
+`view` returns for:
+
+- network calls (`fetch`, `XMLHttpRequest`, WebSocket, beacon URLs);
+- environment reads (`process.env`, `import.meta.env`) beyond the item's
+  documented config;
+- `eval`, `new Function` or a dynamic `import()` of a computed specifier;
+- install scripts or added dependencies with their own lifecycle hooks.
+
+After `add`, run `diff` and read every file the item wrote.

package/dist/agent-src/skills/react-shadcn-ui/scripts/shadcn_add.mjs

@@ -0,0 +1,315 @@
+#!/usr/bin/env tsx
+
+// src/skills/react-shadcn-ui/scripts/shadcn_add.ts
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import process from "node:process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+var ShadcnInstaller = class {
+  projectRoot;
+  dryRun;
+  componentsJson;
+  constructor(projectRoot = null, dryRun = false) {
+    this.projectRoot = projectRoot ?? process.cwd();
+    this.dryRun = dryRun;
+    this.componentsJson = path.join(this.projectRoot, "components.json");
+  }
+  /** Check if shadcn is initialized — components.json exists. */
+  checkShadcnConfig() {
+    return fs.existsSync(this.componentsJson);
+  }
+  /** Get list of already installed components (unsorted, mirrors .py). */
+  getInstalledComponents() {
+    if (!this.checkShadcnConfig()) {
+      return [];
+    }
+    try {
+      const config = JSON.parse(fs.readFileSync(this.componentsJson, "utf-8"));
+      const aliasesRaw = config && typeof config === "object" && "aliases" in config ? config.aliases : void 0;
+      const aliases = aliasesRaw && typeof aliasesRaw === "object" ? aliasesRaw : {};
+      const componentsAlias = typeof aliases.components === "string" ? aliases.components : "components";
+      const componentsDir = path.join(this.projectRoot, componentsAlias.replace("@/", ""));
+      const uiDir = path.join(componentsDir, "ui");
+      if (!fs.existsSync(uiDir)) {
+        return [];
+      }
+      return _globTsxStems(uiDir);
+    } catch {
+      return [];
+    }
+  }
+  /** Add shadcn/ui components → [success, message]. */
+  addComponents(components, overwrite = false) {
+    if (components.length === 0) {
+      return [false, "No components specified"];
+    }
+    if (!this.checkShadcnConfig()) {
+      return [false, "shadcn not initialized. Run 'npx shadcn@latest init' first"];
+    }
+    const installed = this.getInstalledComponents();
+    const alreadyInstalled = components.filter((c) => installed.includes(c));
+    if (alreadyInstalled.length > 0 && !overwrite) {
+      return [
+        false,
+        `Components already installed: ${alreadyInstalled.join(", ")}. Use --overwrite to reinstall`
+      ];
+    }
+    const cmd = ["npx", "shadcn@latest", "add", ...components];
+    if (overwrite) {
+      cmd.push("--overwrite");
+    }
+    if (this.dryRun) {
+      return [true, `Would run: ${cmd.join(" ")}`];
+    }
+    return this._runAdd(cmd, `Successfully added components: ${components.join(", ")}`);
+  }
+  /** Add all available shadcn/ui components → [success, message]. */
+  addAllComponents(overwrite = false) {
+    if (!this.checkShadcnConfig()) {
+      return [false, "shadcn not initialized. Run 'npx shadcn@latest init' first"];
+    }
+    const cmd = ["npx", "shadcn@latest", "add", "--all"];
+    if (overwrite) {
+      cmd.push("--overwrite");
+    }
+    if (this.dryRun) {
+      return [true, `Would run: ${cmd.join(" ")}`];
+    }
+    return this._runAdd(cmd, "Successfully added all components", true);
+  }
+  /**
+   * Mirror the subprocess.run(..., check=True) try/except for both add paths.
+   * `failAll` toggles the "Failed to add all components" vs "Failed to add
+   * components" prefix.
+   */
+  _runAdd(cmd, successBase, failAll = false) {
+    const result = spawnSync(cmd[0], cmd.slice(1), {
+      cwd: this.projectRoot,
+      encoding: "utf-8"
+    });
+    if (result.error && result.error.code === "ENOENT") {
+      return [false, "npx not found. Ensure Node.js is installed"];
+    }
+    const stdout = result.stdout ?? "";
+    const stderr = result.stderr ?? "";
+    const status = result.status;
+    if (status === 0) {
+      let successMsg = successBase;
+      if (stdout) {
+        successMsg += `
+
+Output:
+${stdout}`;
+      }
+      return [true, successMsg];
+    }
+    const detail = stderr || stdout || _calledProcessError(cmd, status, result.signal);
+    const prefix = failAll ? "Failed to add all components" : "Failed to add components";
+    return [false, `${prefix}: ${detail}`];
+  }
+  /** List installed components → [success, message]. */
+  listInstalled() {
+    if (!this.checkShadcnConfig()) {
+      return [false, "shadcn not initialized"];
+    }
+    const installed = this.getInstalledComponents();
+    if (installed.length === 0) {
+      return [true, "No components installed"];
+    }
+    const sorted = [...installed].sort(_pyStrCmp);
+    return [true, "Installed components:\n" + sorted.map((c) => `  - ${c}`).join("\n")];
+  }
+};
+function _pyStrCmp(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function _globTsxStems(uiDir) {
+  let entries;
+  try {
+    entries = fs.readdirSync(uiDir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const e of entries) {
+    if (!e.name.endsWith(".tsx")) {
+      continue;
+    }
+    let isFile = e.isFile();
+    if (e.isSymbolicLink()) {
+      try {
+        isFile = fs.statSync(path.join(uiDir, e.name)).isFile();
+      } catch {
+        isFile = false;
+      }
+    }
+    if (isFile) {
+      out.push(e.name.slice(0, -".tsx".length));
+    }
+  }
+  return out;
+}
+function _calledProcessError(cmd, status, signal) {
+  const cmdRepr = "[" + cmd.map((c) => `'${c}'`).join(", ") + "]";
+  if (signal) {
+    return `Command ${cmdRepr} died with ${signal}.`;
+  }
+  return `Command ${cmdRepr} returned non-zero exit status ${status}.`;
+}
+var PROG = "shadcn_add";
+var HELP = `usage: ${PROG} [-h] [--all] [--overwrite] [--dry-run] [--list]
+                     [--project-root PROJECT_ROOT]
+                     [components ...]
+
+Add shadcn/ui components to your project
+
+positional arguments:
+  components            Component names to add (e.g., button, card, dialog)
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --all                 Add all available components
+  --overwrite           Overwrite existing components
+  --dry-run             Show what would be done without executing
+  --list                List installed components
+  --project-root PROJECT_ROOT
+                        Project root directory (default: current directory)
+
+Examples:
+  # Add single component
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs button
+
+  # Add multiple components
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs button card dialog
+
+  # Add all components
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs --all
+
+  # Overwrite existing components
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs button --overwrite
+
+  # Dry run (show what would be done)
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs button card --dry-run
+
+  # List installed components
+  node <skills-root>/react-shadcn-ui/scripts/shadcn_add.mjs --list
+        
+`;
+var USAGE = `usage: ${PROG} [-h] [--all] [--overwrite] [--dry-run] [--list]
+                     [--project-root PROJECT_ROOT]
+                     [components ...]
+`;
+var ArgExit = class extends Error {
+  constructor(code) {
+    super("argexit");
+    this.code = code;
+  }
+  code;
+};
+function argError(message) {
+  process.stderr.write(USAGE);
+  process.stderr.write(`${PROG}: error: ${message}
+`);
+  throw new ArgExit(2);
+}
+function parseArgs(argv) {
+  const args = {
+    components: [],
+    all: false,
+    overwrite: false,
+    dry_run: false,
+    list: false,
+    project_root: null
+  };
+  let i = 0;
+  while (i < argv.length) {
+    let a = argv[i];
+    let inlineValue = null;
+    const eq = a.indexOf("=");
+    if (a.startsWith("--") && eq !== -1) {
+      inlineValue = a.slice(eq + 1);
+      a = a.slice(0, eq);
+    }
+    if (a === "-h" || a === "--help") {
+      process.stdout.write(HELP);
+      throw new ArgExit(0);
+    } else if (a === "--all") {
+      args.all = true;
+    } else if (a === "--overwrite") {
+      args.overwrite = true;
+    } else if (a === "--dry-run") {
+      args.dry_run = true;
+    } else if (a === "--list") {
+      args.list = true;
+    } else if (a === "--project-root") {
+      const v = inlineValue ?? argv[++i];
+      if (v === void 0) {
+        argError("argument --project-root: expected one argument");
+      }
+      args.project_root = v;
+    } else if (a.startsWith("-") && a !== "-") {
+      argError(`unrecognized arguments: ${argv[i]}`);
+    } else {
+      args.components.push(argv[i]);
+    }
+    i += 1;
+  }
+  return args;
+}
+function main(argv = process.argv.slice(2)) {
+  let args;
+  try {
+    args = parseArgs(argv);
+  } catch (e) {
+    if (e instanceof ArgExit) {
+      return e.code;
+    }
+    throw e;
+  }
+  const installer = new ShadcnInstaller(args.project_root, args.dry_run);
+  if (args.list) {
+    const [success2, message2] = installer.listInstalled();
+    process.stdout.write(`${message2}
+`);
+    return success2 ? 0 : 1;
+  }
+  if (args.all) {
+    const [success2, message2] = installer.addAllComponents(args.overwrite);
+    process.stdout.write(`${message2}
+`);
+    return success2 ? 0 : 1;
+  }
+  if (args.components.length === 0) {
+    process.stdout.write(HELP);
+    return 1;
+  }
+  const [success, message] = installer.addComponents(args.components, args.overwrite);
+  process.stdout.write(`${message}
+`);
+  return success ? 0 : 1;
+}
+function _isCliEntry() {
+  if (process.argv[1] === void 0) {
+    return false;
+  }
+  const argvUrl = pathToFileURL(path.resolve(process.argv[1])).href;
+  if (import.meta.url === argvUrl) {
+    return true;
+  }
+  try {
+    const here = fs.realpathSync(fileURLToPath(import.meta.url));
+    const argv = fs.realpathSync(path.resolve(process.argv[1]));
+    return here === argv;
+  } catch {
+    return false;
+  }
+}
+var _invokedDirectly = _isCliEntry();
+if (_invokedDirectly) {
+  process.exitCode = main();
+}
+export {
+  ShadcnInstaller,
+  main
+};