@tayo-dev/rtl 1.0.0 → 1.2.0

package/README.md

@@ -1,73 +1,124 @@
 # Taro
 
-Generate React Testing Library tests from Chrome Recorder recordings — automatically.
+Install Taro into Claude Code, OpenCode, Gemini CLI, or Codex, then generate React Testing Library tests from Chrome Recorder recordings.
 
-## Introduction
+Taro ships as an installer-first package. The package entrypoint bootstraps runtime-native commands or skills into your agent environment, and the generated runtime surface still routes back to `taro generate` when you want Recorder-to-RTL output.
 
-Taro is a CLI tool that reads Chrome DevTools Recorder exports (JSON) and Testing Library Recorder JS files and generates RTL test files. It scores its own output, learns your project's test conventions from existing files, and stores per-project state in a local `.taro/` directory. No server, no cloud — just files.
+## Getting Started
 
-### Who it is for
+```bash
+npx @tayo-dev/rtl@latest
+```
 
-- React developers who write tests with `@testing-library/react`
-- Developers who use Chrome DevTools Recorder to capture user flows
-- Teams that want test coverage without spending hours writing boilerplate
+The installer prompts you to choose:
 
-### The problem it solves
+1. **Runtime** — Claude Code, OpenCode, Gemini CLI, Codex, or all
+2. **Location** — Global (all projects) or local (current project only)
 
-Recording a user flow in Chrome takes 30 seconds. Translating that recording into a well-structured RTL test takes 20–40 minutes and requires knowing which queries to use, how to assert, and how to match your project's test conventions. Taro closes that gap.
+Verify the install with the runtime-native help command:
 
-### How it works
+- Claude Code: `/@tayo-dev/rtl:help`
+- Gemini CLI: `/@tayo-dev/rtl:help`
+- OpenCode: `/@tayo-dev/rtl-help`
+- Codex: `$@tayo-dev/rtl-help`
 
-1. Record a user flow in Chrome DevTools → Recorder panel.
-2. Export via the Testing Library Recorder extension (`.js`) or as native Chrome Recorder JSON (`.json`).
-3. Run `taro generate ./recording.js`.
-4. Taro writes a `.test.tsx` file next to your recording, scored and convention-aware.
+> [!NOTE]
+> Codex installation uses skills under `skills/@tayo-dev/rtl-*/SKILL.md`, not prompt files.
 
-## Quick Start
+## Staying Updated
 
-### Prerequisites
+Re-run the installer package to refresh owned assets and repair missing ones:
 
-- Node.js 18 or later
-- A React project using `@testing-library/react`
-- Chrome DevTools Recorder (built into Chrome — no extension needed for JSON exports)
+```bash
+npx @tayo-dev/rtl@latest
+```
+
+Taro refreshes unchanged owned files automatically, restores missing owned files, and protects manual edits instead of overwriting them silently.
 
-### Step 1 — Install
+## Non-interactive Install
+
+Use runtime flags plus exactly one location flag to skip prompts:
 
 ```bash
-npm install --save-dev @tayo-dev/rtl
-# or use npx to skip install entirely
-npx @tayo-dev/rtl generate ./my-recording.js
+# Claude Code
+npx @tayo-dev/rtl@latest --claude --global
+npx @tayo-dev/rtl@latest --claude --local
+
+# OpenCode
+npx @tayo-dev/rtl@latest --opencode --global
+npx @tayo-dev/rtl@latest --opencode --local
+
+# Gemini CLI
+npx @tayo-dev/rtl@latest --gemini --global
+npx @tayo-dev/rtl@latest --gemini --local
+
+# Codex
+npx @tayo-dev/rtl@latest --codex --global
+npx @tayo-dev/rtl@latest --codex --local
+
+# All runtimes
+npx @tayo-dev/rtl@latest --all --global
+npx @tayo-dev/rtl@latest --all --local
 ```
 
-### Step 2 — Record a user flow
+Local installs write to hidden runtime directories in the current project:
 
-Open Chrome DevTools → Recorder panel → click "Start new recording" → perform your user flow (clicks, form fills, navigation) → click "End recording". Then either:
+- Claude Code: `./.claude/`
+- OpenCode: `./.opencode/`
+- Gemini CLI: `./.gemini/`
+- Codex: `./.codex/`
 
-- Export as JSON: click the export button → "JSON" → save as `recording.json`
-- Export via Testing Library Recorder extension: install the extension, click its export button, save as `recording.js`
+## Development Installation
 
-### Step 3 — Generate the test
+When you want to test the installer from a local checkout instead of the published package:
 
 ```bash
-# Using npx (no install required)
-npx @tayo-dev/rtl generate ./recording.js
+# Build the CLI
+npm run build
+
+# Exercise the installer from the built package entrypoint
+node dist/index.js --all --local
+
+# Or verify the publish boundary with a tarball
+env NPM_CONFIG_CACHE=/tmp/taro-npm-cache npm pack --pack-destination /tmp/taro-pack
+npx /tmp/taro-pack/tayo-dev-rtl-1.0.0.tgz --codex --local
+```
+
+The tarball flow is the closest match to what end users get from npm.
+
+## Generate RTL Tests
+
+After installation, use `taro generate` directly or call the runtime-native installed command/skill that routes to it.
+
+### Prerequisites
+
+- Node.js 18 or later
+- A React project using `@testing-library/react`
+- Chrome DevTools Recorder (built into Chrome — no extension needed for JSON exports)
+
+### Record a user flow
+
+Open Chrome DevTools → Recorder panel → click "Start new recording" → perform your user flow → click "End recording". Then either:
 
-# Or if installed globally
+- Export as JSON and save as `recording.json`
+- Export via Testing Library Recorder extension and save as `recording.js`
+
+### Generate the test
+
+```bash
 taro generate ./recording.js
 ```
 
 Expected output:
 
-```
+```text
 Parsed: my user flow — 8 steps
 [taro] Score: 78/100 (B) — query: 80, assertions: 70, structure: 85
 Created: src/components/MyComponent.test.tsx
 [taro] ✓ post-write verified
 ```
 
-### What happens next
-
-Taro writes a `.test.tsx` file. On subsequent runs in the same project, it reads `.taro/conventions.json` to match your test style (import style, mock pattern, folder structure) automatically.
+On subsequent runs in the same project, Taro reads `.taro/conventions.json` to match your test style automatically.
 
 ## CLI Reference
 
@@ -185,59 +236,11 @@ describe('login flow', () => {
 
 > **Note:** The component import path (`../LoginPage`) is a placeholder. Taro generates a comment in the file indicating where to update it.
 
-## Using Taro as a Claude Code Skill
-
-### Overview
-
-Taro works naturally as a Claude Code skill. You can instruct Claude to run `taro generate` on a recording file and it will generate the test, report the score, and surface any quality hints — all in a single agent turn.
-
-### Option A: Direct invocation (no setup required)
-
-Claude Code can invoke Taro directly using the Bash tool. No skill configuration is needed — Claude calls npx inline. Simply give Claude a prompt like:
-
-```
-Run: npx @tayo-dev/rtl generate ./recordings/checkout-flow.js
-Then report the score and the path of the generated file.
-```
-
-### Option B: Register as a Claude Code skill
-
-Registering Taro as a skill lets Claude invoke it by name without knowing the full command.
+## Agent Usage
 
-**Step 1** — Create the skill file at `.claude/skills/taro/SKILL.md` in your project:
-
-```markdown
-# Taro — RTL Test Generator
-
-## Purpose
-Generate a React Testing Library test from a Chrome Recorder export.
-
-## Invocation
-Run: taro generate <recording-file>
-
-## Flags
-- `--dry-run` (-d): Preview the generated test without writing to disk
-- `--output <path>` (-o): Override the output file path
-- `--force` (-f): Overwrite an existing test file
-
-## Output
-Writes `{recording-name}.test.tsx` next to the recording file.
-Reports score (0-100) and any quality hints.
-```
-
-**Step 2** — Ensure Taro is installed in the project:
-
-```bash
-npm install --save-dev @tayo-dev/rtl
-```
-
-**Step 3** — Ask Claude to use the skill:
-
-```
-Use the taro skill to generate a test from ./recordings/login-flow.js
-```
+After installation, each runtime gets a namespaced help entrypoint plus a generate command or skill that routes back to `taro generate`.
 
-### Tips for agent use
+### Tips
 
 - Use `--dry-run` first to preview output before committing generated files
 - If you record multiple flows, run Taro on each to build up convention state in `.taro/conventions.json` — later runs benefit from earlier ones

package/assets/claude/commands/@tayo-dev/rtl/generate.md

@@ -0,0 +1,15 @@
+---
+name: "@tayo-dev/rtl:generate"
+description: "Generate RTL tests from Chrome Recorder exports with Taro"
+---
+
+<objective>
+Generate a React Testing Library test from a Chrome Recorder export.
+</objective>
+
+<process>
+1. Confirm the recording path before running anything destructive.
+2. Run `taro generate <recording-file>` by default.
+3. Add `--dry-run`, `--output <path>`, or `--force` only when the user asks for them or the context requires them.
+4. Report the generated file path and score output.
+</process>

package/assets/claude/commands/@tayo-dev/rtl/help.md

@@ -0,0 +1,16 @@
+---
+name: "@tayo-dev/rtl:help"
+description: "Show @tayo-dev/rtl install and generation help"
+---
+
+<objective>
+Help the user install and use @tayo-dev/rtl from Claude Code.
+</objective>
+
+<process>
+1. Explain that `/@tayo-dev/rtl:help` is the installed help entrypoint for @tayo-dev/rtl.
+2. For installation or updates, tell the user to run `npx @tayo-dev/rtl@latest`.
+3. For test generation, use `/@tayo-dev/rtl:generate` or run `taro generate <recording-file>`.
+4. Mention `--dry-run`, `--output <path>`, and `--force` only when they fit the request.
+5. When generation runs, report the score and generated file path.
+</process>

package/assets/codex/@tayo-dev/rtl-conventions/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: "@tayo-dev/rtl-conventions"
+description: "Explain how Tayo learns project test conventions and how to keep them stable."
+---
+
+# Tayo Conventions
+
+Use `$@tayo-dev/rtl-conventions` when the user asks why generated tests follow a certain style or how `.taro/conventions.json` affects output.
+
+## Focus
+
+- explain that Tayo learns local test conventions from the codebase
+- call out when `.taro/conventions.json` will influence generated imports, mocks, and file placement
+- recommend `--dry-run` when the user wants to inspect convention alignment before writing files
+
+## Guardrails
+
+- prefer existing project conventions over generic defaults
+- surface missing context instead of inventing project-specific patterns

package/assets/codex/@tayo-dev/rtl-generate/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: "@tayo-dev/rtl-generate"
+description: "Generate React Testing Library tests from Recorder exports with Tayo."
+---
+
+# Tayo Generate
+
+Use `$@tayo-dev/rtl-generate` when the user wants to turn a Chrome Recorder export into a React Testing Library test.
+
+## Inputs
+
+- path to the recording file
+- optional `--output <path>`
+- optional `--dry-run`
+- optional `--force`
+
+## Execution
+
+Run `taro generate <recording-file>` with the requested flags.
+
+## Response contract
+
+Report:
+
+- the generated test path
+- the Tayo score
+- any follow-up work required to fix component imports or flaky selectors

package/assets/codex/@tayo-dev/rtl-help/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: "@tayo-dev/rtl-help"
+description: "Show the packaged Tayo Codex skill surface and the expected help entrypoint."
+---
+
+# Tayo Codex Help
+
+Use this skill when you need the Codex-facing entrypoint for Tayo or you need to route the user to the right packaged skill.
+
+## Entrypoint
+
+Invoke this skill with `$@tayo-dev/rtl-help`.
+
+## Installed skill surface
+
+- `$@tayo-dev/rtl-generate` for Recorder-to-RTL generation
+- `$@tayo-dev/rtl-conventions` for convention-aware generation guidance
+- `$@tayo-dev/rtl-mocks` for mock and fixture review
+
+## Default workflow
+
+1. Confirm the recording path or test target.
+2. Choose the matching packaged Tayo skill.
+3. If direct CLI execution is appropriate, run `taro generate <recording-file>` with any requested flags.
+4. Report the generated file path, score, and any blocking issues.

package/assets/codex/@tayo-dev/rtl-mocks/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: "@tayo-dev/rtl-mocks"
+description: "Review mock targets, fixture shape, and post-generation follow-up for Tayo output."
+---
+
+# Tayo Mocks
+
+Use `$@tayo-dev/rtl-mocks` when the user needs help understanding mock recommendations or fixture strategy around generated RTL tests.
+
+## Focus
+
+- identify the API or data boundaries that need mocks
+- explain whether the mock should stay inline or move to a shared fixture
+- keep recommendations aligned with the project's current test stack
+
+## Output
+
+Summarize:
+
+- the mock targets that matter
+- the preferred mocking pattern
+- any manual follow-up still required after generation

package/assets/gemini/commands/@tayo-dev/rtl/generate.toml

@@ -0,0 +1,10 @@
+description = "Generate RTL tests from Chrome Recorder exports with Taro"
+prompt = """
+You are the installed /@tayo-dev/rtl:generate command for @tayo-dev/rtl.
+
+Generate a React Testing Library test from a Chrome Recorder export.
+1. Confirm the recording path before running anything destructive.
+2. Run `taro generate <recording-file>` by default.
+3. Add `--dry-run`, `--output <path>`, or `--force` only when the user asks for them or the context requires them.
+4. Report the generated file path and score output.
+"""

package/assets/gemini/commands/@tayo-dev/rtl/help.toml

@@ -0,0 +1,11 @@
+description = "Show @tayo-dev/rtl install and generation help"
+prompt = """
+You are the installed /@tayo-dev/rtl:help command for @tayo-dev/rtl.
+
+When the user wants help:
+1. Explain that /@tayo-dev/rtl:help is the runtime-native help entrypoint.
+2. For installation or updates, tell them to run `npx @tayo-dev/rtl@latest`.
+3. For generation, direct them to /@tayo-dev/rtl:generate or `taro generate <recording-file>`.
+4. Mention `--dry-run`, `--output <path>`, and `--force` only when they match the request.
+5. When generation runs, report the score and generated file path.
+"""

package/assets/opencode/commands/@tayo-dev/rtl-generate.md

@@ -0,0 +1,11 @@
+---
+description: Generate RTL tests from Chrome Recorder exports with Taro
+---
+
+You are the installed `/@tayo-dev/rtl-generate` command for `@tayo-dev/rtl`.
+
+Generate a React Testing Library test from a Chrome Recorder export.
+1. Confirm the recording path before running anything destructive.
+2. Run `taro generate <recording-file>` by default.
+3. Add `--dry-run`, `--output <path>`, or `--force` only when the user asks for them or the context requires them.
+4. Report the generated file path and score output.

package/assets/opencode/commands/@tayo-dev/rtl-help.md

@@ -0,0 +1,12 @@
+---
+description: Show @tayo-dev/rtl install and generation help
+---
+
+You are the installed `/@tayo-dev/rtl-help` command for `@tayo-dev/rtl`.
+
+When the user wants help:
+1. Explain that `/@tayo-dev/rtl-help` is the runtime-native help entrypoint.
+2. For installation or updates, tell them to run `npx @tayo-dev/rtl@latest`.
+3. For generation, direct them to `/@tayo-dev/rtl-generate` or `taro generate <recording-file>`.
+4. Mention `--dry-run`, `--output <path>`, and `--force` only when they match the request.
+5. When generation runs, report the score and generated file path.

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import type { InstallCommandOptions } from '../../install/types.js';
+interface PromptCapability {
+    input?: Pick<typeof process.stdin, 'isTTY'>;
+    output?: Pick<typeof process.stdout, 'isTTY'>;
+}
+interface PromptIO {
+    input?: typeof process.stdin;
+    output?: typeof process.stdout;
+}
+interface InstallCommandContext {
+    cwd?: string;
+    home?: string;
+    logger?: Pick<typeof console, 'log' | 'error'>;
+    promptCapability?: PromptCapability;
+    promptIO?: PromptIO;
+}
+export declare function applyInstallOptions(command: Command): Command;
+export declare function runInstallCommand(options?: InstallCommandOptions, context?: InstallCommandContext): Promise<void>;
+export declare function createInstallCommand(): Command;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgBnC,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,wBAAwB,CAAA;AAErF,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC3C,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9C;AAED,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,KAAK,CAAA;IAC5B,MAAM,CAAC,EAAE,OAAO,OAAO,CAAC,MAAM,CAAA;CAC/B;AAED,UAAU,qBAAqB;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;IAC9C,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS7D;AAyBD,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,qBAA0B,EACnC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C"}

package/dist/cli/commands/install.js

@@ -0,0 +1,69 @@
+import { Command } from 'commander';
+import pc from 'picocolors';
+import { executeInstallPlan } from '../../install/executor.js';
+import { InstallValidationError, normalizeInstallOptions, toInstallSelection, } from '../../install/options.js';
+import { buildInstallPlan } from '../../install/planner.js';
+import { promptForInstallChoices } from '../../install/prompts.js';
+import { confirmInstallPlan, renderInstallCancelledMessage, renderInstallExecutionResult, renderInstallSummary, } from '../../install/summary.js';
+export function applyInstallOptions(command) {
+    return command
+        .option('--claude', 'Install Taro assets for Claude Code')
+        .option('--opencode', 'Install Taro assets for OpenCode')
+        .option('--gemini', 'Install Taro assets for Gemini CLI')
+        .option('--codex', 'Install Taro assets for Codex')
+        .option('--all', 'Install Taro assets for all supported runtimes')
+        .option('--global', 'Install into the runtime global configuration directory')
+        .option('--local', 'Install into the current project only');
+}
+async function resolveInstallSelection(options, context) {
+    const normalized = normalizeInstallOptions(options, context.promptCapability);
+    if (normalized.mode === 'interactive') {
+        return promptForInstallChoices(normalized, context.promptIO);
+    }
+    return toInstallSelection(normalized);
+}
+function printInstallError(error, logger) {
+    if (error instanceof InstallValidationError) {
+        logger.error(pc.red(`Error: ${error.message}`));
+        process.exitCode = 1;
+        return;
+    }
+    throw error;
+}
+export async function runInstallCommand(options = {}, context = {}) {
+    const logger = context.logger ?? console;
+    try {
+        const selection = await resolveInstallSelection(options, context);
+        const plan = buildInstallPlan(selection, {
+            cwd: context.cwd,
+            home: context.home,
+        });
+        logger.log(renderInstallSummary(plan));
+        if (selection.mode === 'interactive') {
+            const confirmed = await confirmInstallPlan(plan, context.promptIO);
+            if (!confirmed) {
+                logger.log(pc.yellow(renderInstallCancelledMessage()));
+                return;
+            }
+        }
+        const result = await executeInstallPlan(plan);
+        logger.log(renderInstallExecutionResult(result));
+        if (result.status !== 'installed') {
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        printInstallError(error, logger);
+    }
+}
+export function createInstallCommand() {
+    const install = new Command('install');
+    applyInstallOptions(install);
+    install
+        .description('Install Taro into Claude Code, OpenCode, Gemini CLI, or Codex')
+        .action(async (options) => {
+        await runInstallCommand(options);
+    });
+    return install;
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Taro CLI entry point
- * Generates React Testing Library tests from Chrome Recorder exports.
+ * Installer-first package surface with generator access preserved under `generate`.
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,18 +1,24 @@
 #!/usr/bin/env node
 /**
  * Taro CLI entry point
- * Generates React Testing Library tests from Chrome Recorder exports.
+ * Installer-first package surface with generator access preserved under `generate`.
  */
 import { Command } from 'commander';
 import pc from 'picocolors';
 import { createGenerateCommand } from './cli/commands/generate.js';
+import { applyInstallOptions, createInstallCommand, runInstallCommand, } from './cli/commands/install.js';
 const program = new Command();
+applyInstallOptions(program);
 program
     .name('taro')
-    .description(pc.bold('Taro') +
-    ' — Generate React Testing Library tests from Chrome Recorder exports')
+    .description(`${pc.bold('@tayo-dev/rtl')} — Install Taro into Claude Code, OpenCode, Gemini CLI, or Codex`)
     .version('1.0.0', '-v, --version', 'Output the current version')
-    .helpOption('-h, --help', 'Display help for command');
+    .helpOption('-h, --help', 'Display help for command')
+    .addHelpText('after', `\nExisting capability:\n  ${pc.bold('taro generate <file>')}  Generate RTL tests from Chrome Recorder exports`)
+    .action(async () => {
+    await runInstallCommand(program.optsWithGlobals());
+});
+program.addCommand(createInstallCommand());
 program.addCommand(createGenerateCommand());
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CACV,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IACb,sEAAsE,CACzE;KACA,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,4BAA4B,CAAC;KAC/D,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAA;AAEvD,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAA;AAE3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAA;AAGlC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,mBAAmB,CAAC,OAAO,CAAC,CAAA;AAE5B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CACV,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,kEAAkE,CAC9F;KACA,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,4BAA4B,CAAC;KAC/D,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC;KACpD,WAAW,CACV,OAAO,EACP,6BAA6B,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,mDAAmD,CAChH;KACA,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,iBAAiB,CAAC,OAAO,CAAC,eAAe,EAA2B,CAAC,CAAA;AAC7E,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAA;AAE3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/install/assets.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeTarget } from './types.js';
+export declare function resolvePackageRoot(fromModuleUrl?: string): string;
+export declare function resolveAssetsRoot(fromModuleUrl?: string): string;
+export declare function resolveAssetSource(runtime: RuntimeTarget, sourceSegments?: string[], fromModuleUrl?: string): string;
+//# sourceMappingURL=assets.d.ts.map

package/dist/install/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/install/assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,MAAwB,GAAG,MAAM,CAelF;AAED,wBAAgB,iBAAiB,CAAC,aAAa,GAAE,MAAwB,GAAG,MAAM,CAEjF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,cAAc,GAAE,MAAM,EAAO,EAC7B,aAAa,GAAE,MAAwB,GACtC,MAAM,CAER"}

package/dist/install/assets.js

@@ -0,0 +1,23 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function resolvePackageRoot(fromModuleUrl = import.meta.url) {
+    let current = dirname(fileURLToPath(fromModuleUrl));
+    while (true) {
+        if (existsSync(join(current, 'package.json'))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            throw new Error(`Unable to locate package root from ${fromModuleUrl}.`);
+        }
+        current = parent;
+    }
+}
+export function resolveAssetsRoot(fromModuleUrl = import.meta.url) {
+    return join(resolvePackageRoot(fromModuleUrl), 'assets');
+}
+export function resolveAssetSource(runtime, sourceSegments = [], fromModuleUrl = import.meta.url) {
+    return join(resolveAssetsRoot(fromModuleUrl), runtime, ...sourceSegments);
+}
+//# sourceMappingURL=assets.js.map

package/dist/install/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/install/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC,MAAM,UAAU,kBAAkB,CAAC,gBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG;IACxE,IAAI,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAA;IAEnD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,aAAa,GAAG,CAAC,CAAA;QACzE,CAAC;QAED,OAAO,GAAG,MAAM,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,gBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG;IACvE,OAAO,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,iBAA2B,EAAE,EAC7B,gBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG;IAEvC,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAA;AAC3E,CAAC"}

package/dist/install/executor.d.ts

@@ -0,0 +1,4 @@
+import type { InstallExecutionResult, InstallPlan } from './types.js';
+import type { WriteInstallPlanOptions } from './writer.js';
+export declare function executeInstallPlan(plan: InstallPlan, options?: WriteInstallPlanOptions): Promise<InstallExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/install/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/install/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA+BjC"}

package/dist/install/executor.js

@@ -0,0 +1,26 @@
+import { verifyInstalledRuntime } from './verification.js';
+import { writeInstallPlan } from './writer.js';
+export async function executeInstallPlan(plan, options = {}) {
+    const targets = await Promise.all(plan.targets.map(async (target) => {
+        const result = await writeInstallPlan(target, {
+            confirmReplace: options.confirmReplace,
+            generatedAt: options.generatedAt,
+        });
+        if (result.status === 'blocked') {
+            return result;
+        }
+        const verification = await verifyInstalledRuntime(target);
+        return {
+            ...result,
+            verification,
+        };
+    }));
+    const hasSuccessfulWrites = targets.some((target) => target.status !== 'blocked');
+    const hasFailures = targets.some((target) => target.status === 'blocked' || target.verification?.status === 'missing-installed-assets');
+    return {
+        packageName: plan.packageName,
+        status: hasFailures ? (hasSuccessfulWrites ? 'partial' : 'blocked') : 'installed',
+        targets,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/install/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/install/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAiB,EACjB,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAA;QACzD,OAAO;YACL,GAAG,MAAM;YACT,YAAY;SACb,CAAA;IACH,CAAC,CAAC,CACH,CAAA;IAED,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAC9B,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,EAAE,MAAM,KAAK,0BAA0B,CAC5F,CAAA;IAED,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW;QACjF,OAAO;KACR,CAAA;AACH,CAAC"}