@amsterdamdatalabs/enact-extensions 0.1.42 → 0.1.47

package/README.md

@@ -2,161 +2,120 @@
 
 Multi-surface **plugin manifest** tooling for Enact: schemas, validation, sync, and the plugin-dev toolkit for ENACT-native bundles plus derived Claude Code, Codex, and Cursor projections.
 
-**Repository:** https://dev.azure.com/amsterdamdatalabs/Enact/_git/enact-extensions
-**Package:** `@amsterdamdatalabs/enact-extensions`
-**CLI:** `enact-extensions`
+- **Repository:** https://dev.azure.com/amsterdamdatalabs/Enact/_git/enact-extensions
+- **Package:** `@amsterdamdatalabs/enact-extensions`
+- **CLI:** `enact-extensions`
 
-## Scope
+## What this repo is
 
-This repo is the manifest tooling package (`@amsterdamdatalabs/enact-extensions`) plus a set of self-contained plugin bundles under `extensions/`. It owns:
+This package owns the manifest tooling and a set of self-contained plugin bundles under `extensions/`:
 
-- `spec/` — JSON schemas (canonical: `enact.json`) + per-host schemas (`claude-plugin.json`, `codex-plugin.json`, `cursor-plugin.json`) + `index.json` (discovery index schema)
-- `src/` — `create/*`, `validate/*`, and `install` TypeScript library
-- `scripts/` — CLI: `enact-extensions` (`validate` | `sync` | `install` | `uninstall` | `list` | `index` | `log` | `outdated` | `update` | `serve`, path defaults to cwd)
-- `extensions/<plugin>/` — one self-contained bundle per plugin (e.g. `plugin-dev`, `cmux`, `devops`, `dev-state`, `net-revenue-management`), each with a canonical `.agents/plugin.json` + skills/agents/hooks
-- `web/` — vendored ADL design assets (`web/assets/tokens/*.css`, `web/assets/logo-*.png`) + `web/index.html` (the management UI served by `serve`)
+- `spec/` — JSON schemas (`enact.json` canonical; per-host schemas for claude/codex/cursor)
+- `src/` — TypeScript library for manifest derivation (`create/`), validation (`validate/`), and repo-local projection (`projection.ts`)
+- `scripts/` — CLI: `enact-extensions` (`validate` | `sync` | `list` | `index` | `install --repo` | `uninstall --repo` | `doctor enact-repo --repo`)
+- `extensions/<plugin>/` — one bundle per plugin (e.g. `plugin-dev`, `enact-core`, `enact-factory`, `net-revenue-management`), each with a canonical `.agents/plugin.json`
 
-Distribution is **install-only**: there is no pre-built marketplace artifact and no central registry. `enact-extensions install <bundle>` projects the per-surface manifest from `.agents/plugin.json` on the fly, copies the bundle into the target home, and enables it.
+**Scope: repo-local agent setup only.** `enact-extensions install <bundle> --repo <path>` projects host files from `.agents/plugin.json` into a git repository as committed, relative files. This package never installs into host global homes (`~/.claude`, `~/.codex`, `~/.cursor`, `~/.kimi-code`, `~/.enact`), keeps no global install ledger, and never rewrites global agent files (`CLAUDE.md` / `AGENTS.md`); everything global belongs to `enact-vps`, whose global surface sweep also removes legacy global installs made by older versions of this CLI. There is no npm `postinstall`.
 
-## Surface Contract
+## Surface contract
 
-Each `extensions/<plugin>/.agents/plugin.json` is the canonical source manifest. `enact-extensions sync` (and `install`) derive `.claude-plugin/`, `.codex-plugin/`, and `.cursor-plugin/` from that source — those projections are generated, never committed.
+Each `extensions/<plugin>/.agents/plugin.json` is the canonical source. `sync` and `install --repo` derive `.claude-plugin/`, `.codex-plugin/`, `.cursor-plugin/`, and `.kimi-plugin/` from it — these projections are generated and never committed.
 
-Author skills, commands, and hooks so they are valid on **all projected surfaces by default**:
+Author skills so they are valid on **all projected surfaces by default**. Use surface-neutral workflow language, treat `.agents/plugin.json` as the source of truth, and isolate host-specific details only when required.
 
-- Prefer surface-neutral workflow language in `SKILL.md` and hook prompts.
-- Treat ENACT-native `.agents/plugin.json` as the source of truth, not a sidecar.
-- Only use host-specific details when they are truly required, and isolate them clearly in references or host-specific examples.
-- Do not assume a Claude-only tool, env var, or lifecycle quirk unless the same contract exists on Codex and ENACT, or the skill explicitly scopes that instruction.
-
-Do not add ad-hoc sibling packages here (for example legacy `enact-feed-*` MCP prototypes).
-
-## Clone
+## Install / build
 
 ```bash
 git clone https://amsterdamdatalabs@dev.azure.com/amsterdamdatalabs/Enact/_git/enact-extensions
-```
-
-This repo has no submodules of its own. Sibling product packages are submoduled by `enact-os/`, not by `enact-extensions/`.
-
-## Workspace commands
-
-```bash
+cd enact-extensions
 npm install
 npm run build
-npm run validate       # validate the plugin-dev bundle
-npm run sync           # regenerate host manifests for plugin-dev from .agents/plugin.json
 ```
 
-To validate, install, list, or index any bundle:
+## Tests
 
 ```bash
-npm run build
-node scripts/enact-extensions.mjs validate extensions/net-revenue-management
-node scripts/enact-extensions.mjs install extensions/net-revenue-management --platform enact --global
-node scripts/enact-extensions.mjs install extensions/net-revenue-management --platform enact --local
-
-# Install by bare name (resolves from extensions/ tree)
-node scripts/enact-extensions.mjs install net-revenue-management --platform enact --global
-
-# Install to multiple platforms at once
-node scripts/enact-extensions.mjs install net-revenue-management --platform all
-node scripts/enact-extensions.mjs install net-revenue-management --platform claude,cursor
-
-# List available bundles
-node scripts/enact-extensions.mjs list
-node scripts/enact-extensions.mjs list --json
-
-# Generate local discovery index (gitignored artifact; spec/index.json is the committed schema)
-node scripts/enact-extensions.mjs index
-node scripts/enact-extensions.mjs index --stdout
+npm test
+```
 
-# Uninstall a plugin (full remove: files + marketplace entry + config.toml entry)
-node scripts/enact-extensions.mjs uninstall net-revenue-management --platform enact
-node scripts/enact-extensions.mjs uninstall net-revenue-management --platform all
+This runs the full validation suite: principle checks, hook checks, TypeScript build, skill standard validation, and the Node test suite.
 
-# View the install ledger (most recent first)
-node scripts/enact-extensions.mjs log
-node scripts/enact-extensions.mjs log --json
+## Usage
 
-# Check freshness drift (installed vs canonical source, per plugin+surface)
-node scripts/enact-extensions.mjs outdated
-node scripts/enact-extensions.mjs outdated --json
+Validate, sync, or list bundles:
 
-# Refresh outdated plugins (ledger-driven, per-surface)
-node scripts/enact-extensions.mjs update --all
-node scripts/enact-extensions.mjs update net-revenue-management
-node scripts/enact-extensions.mjs update --all --dry-run
+```bash
+npm run build
 
-# Install/update enact-core so the drift-check hook is bundle-owned
-node scripts/enact-extensions.mjs install enact-core --platform all
-node scripts/enact-extensions.mjs install enact-core --platform claude,codex
+node scripts/enact-extensions.mjs validate extensions/net-revenue-management
+node scripts/enact-extensions.mjs sync extensions/plugin-dev
 
-# Start the localhost management UI + API
-node scripts/enact-extensions.mjs serve
-node scripts/enact-extensions.mjs serve --port 43217 --open
+node scripts/enact-extensions.mjs list
 ```
 
-## CLI (`enact-extensions`)
+`install` / `uninstall` / `doctor` only accept plugin names listed in
+[`bundled-extensions.json`](bundled-extensions.json) — today that is **`enact-repo`**
+only — and only in repo-local `--repo <path>` form. Any other name is refused with a
+clear error before anything is touched. `scripts/lib/allowed-plugins.mjs` is the CLI's
+allow-list gate; the repo-local install library stays name-agnostic.
 
-Published from `@amsterdamdatalabs/enact-extensions`. Path defaults to **cwd**:
+### Repo-local install (`--repo`)
 
-```bash
-cd extensions/enact-factory
-enact-extensions validate
-enact-extensions sync
-```
-
-Subcommands: `validate` | `sync` | `install` | `uninstall` | `list` | `index` | `log` | `outdated` | `update` | `serve`.
-
-Link locally:
+Install a bundle **into a git repository** as committed, relative files, following each host's documented project-scope standard. Nothing is written under `$HOME`, and no absolute path is written into any file. (This replaces the removed `--local` fake-home scope.)
 
 ```bash
-npm run build && npm link
+enact-extensions install enact-repo --repo <path> [--host claude,codex,cursor,kimi,opencode] [--force]
+enact-extensions install enact-repo --repo <path> --dry-run    # preview; writes nothing
+enact-extensions uninstall enact-repo --repo <path> [--purge] [--force]
+enact-extensions uninstall enact-repo --repo <path> --dry-run [--purge]   # preview; writes nothing
+enact-extensions doctor enact-repo --repo <path> [--json]      # read-only health check
 ```
 
-## Freshness
+`<path>` must be the git repository root (not a subdirectory, not `$HOME`). `--host` defaults to every repo host the bundle targets.
 
-The freshness loop keeps installed plugins in sync with their canonical source without requiring manual tracking:
+`--dry-run` prints exactly what would be written, merged, removed, or restored — one line per file, naming the action and the reason (including a drift/conflict refusal, if the real run would refuse) — and exits with the same success/failure a real run would, without touching the filesystem.
 
-1. **Install records a content hash** — `enact-extensions install` writes a sha256 hash of the canonical bundle into the ledger entry alongside the version.
-2. **`outdated` detects drift per surface** — compares the recorded hash against the current canonical source hash for each `(plugin, surface)` pair. Status values: `fresh` / `outdated` / `orphaned`. Exit 0 always (report only).
-3. **`update` refreshes the installed surfaces** — driven by the ledger; only the surfaces a plugin is actually installed on are updated. `--all` refreshes every outdated surface; `<name>` refreshes that plugin's outdated surfaces; `--dry-run` shows what would change without touching anything.
-4. **Session-start hook (optional)** — `enact-core` owns the advisory `SessionStart` hook (`enact-extensions hook session-start`). Installing `enact-core` on a surface makes the drift check bundle-owned and removes stale pre-bundle standalone drift-hook entries there.
+`doctor enact-repo --repo <path>` is a read-only report: installed?; installed version vs. the current bundle version (outdated?), plus any managed file whose content has drifted from what the current bundle would generate; lock integrity (every managed file present and hash-matching; missing/drifted files listed); per-host status — Claude (marketplace + settings present, with the trust / "start a new session" note above), Codex (files present, plus a read-only check of `~/.codex/config.toml`'s `projects."<path>".trust_level` for this exact repo), Cursor (files present, with an MCP-approval note), Kimi (`.kimi-code/mcp.json` present; whether `~/.kimi-code/config.toml` has the global `# BEGIN ENACT KIMI HOOKS` block installed by enact-vps; and a **Kimi Code workspace-trust** check — Kimi only loads project MCP servers, `.kimi-code/mcp.json` included, once you've opened the repo in Kimi Code and accepted "Trust this folder", so doctor reports trusted/NOT trusted by reading `${KIMI_CODE_HOME:-~/.kimi-code}/workspace-trust/wd_<slug>_<hash>` — never writes it), OpenCode (plugin file present and generated from the current bundle); the required global binaries on `PATH` (`enact-hook`, `lean-ctx`, `crg`/`code-review-graph`, `azure-devops-mcp`) with versions; the root `enact-config.toml` marker (present, parses as TOML, has a `[skills]` table; other tools' tables are never inspected), plus a stale leftover `.agents/enact-repo.toml` reported for information only (never read); an `enact-hook doctor --repo` passthrough when that sub-command is available; and the `enact-hook` per-repo logs — `.agents/hooks/hooks.log` (deny log CSV: `timestamp,surface,reason_id,command,agent_message`) and `.agents/hooks/hooks-activity.log` (activity log CSV: those columns plus `host,kind,event,tool,session,downstream,duration_ms`) — reporting each log's path, whether it exists, its row count, and (deny log only) the last 5 rows, parsed with a CSV reader that handles quoted commas and already-flattened fields. It never writes anything and exits non-zero only when a hard requirement fails (not installed, lock integrity failure, a missing required binary, or a missing, unparseable or `[skills]`-less `enact-config.toml`) — an outdated version, a host trust/approval note, a stale `.agents/enact-repo.toml`, or the hook-log summary is informational only.
 
-**npm postinstall:** when you `npm install @amsterdamdatalabs/enact-extensions` in an interactive terminal, a TTY-aware postinstall script installs `enact-core` on all host surfaces. In non-interactive terminals and CI environments it prints a one-line notice (`Run enact-extensions install enact-core --platform all …`) and exits immediately — it never blocks installs or hangs pipelines.
+| Host | Files written in the repo |
+| --- | --- |
+| Claude Code | `.claude-plugin/enact-repo/` (plugin root: `.claude-plugin/plugin.json`, `skills/`, `hooks/hooks.json` with `--host=claude`, `.mcp.json`); `.claude-plugin/marketplace.json` (marketplace `enact-repo-local`, plugin `"source": "./.claude-plugin/enact-repo"`); `.claude/settings.json` merged with `extraKnownMarketplaces.enact-repo-local = {"source": {"source": "directory", "path": "./"}}` and `enabledPlugins["enact-repo@enact-repo-local"] = true`. Loads only after you trust the folder — **and, per live testing, not necessarily in that very first trusted session**: the marketplace registers on first launch but hooks/skills may not finish activating until the *second* Claude Code session in the folder. If hooks/skills seem missing right after install, start a new Claude Code session in this folder before assuming the install failed. |
+| Codex | `.codex/config.toml` `[mcp_servers.<name>]` tables in a marker-delimited block (your TOML and comments are untouched); `.codex/hooks.json` (nested schema, `--host=codex`). Loads only after you trust the project (exact path, no parent inheritance) and review hooks with `/hooks`. No repo marketplace (Codex does not auto-discover one). |
+| Cursor | `.cursor/hooks.json` (`version: 1`, Cursor event names, `--host=cursor`); `.cursor/mcp.json` (`type: "stdio"`). |
+| Kimi Code | `.kimi-code/mcp.json`. Kimi hooks are global-only and are installed by enact-vps, not here. |
+| OpenCode | `.opencode/plugins/enact-repo.ts` (hooks with `--host=opencode`, MCP servers via the `config` hook; no skills path, because OpenCode reads `.agents/skills/` natively). |
 
-## Web UI (`serve`)
+Skills: Codex, Cursor, Kimi, and OpenCode share one copy in `.agents/skills/<skill>/`. Claude uses the copy bundled in its plugin. An existing skill dir with the same name that the bundle does not manage is never overwritten, even with `--force`.
 
-`enact-extensions serve` starts a dependency-free localhost management UI at `http://127.0.0.1:43217` (default port). From the UI you can browse all available extensions and one-click install or uninstall them to any platform surface. Pass `--open` to launch the browser automatically.
+`lean-ctx` config: regardless of `--host`, the bundle's baseline `lean-ctx/config.toml` and `lean-ctx/layout.toml` are installed as managed whole files at `.agents/lean-ctx/config/lean-ctx/` — every host's `.mcp.json`/hooks equivalent runs `enact-hook lean-ctx ...`, which resolves its config from this repo-local path. Managed like any other whole file: drift is detected, `--force` takes over and records a pre-existing user `config.toml`/`layout.toml` for byte-exact restore on uninstall.
 
-The server binds to `127.0.0.1` only — it is never reachable from other machines. API routes: `GET /` (UI), `GET /assets/*` (static assets), `GET /api/index` (discovery index), `GET /api/installed` (current installs), `POST /api/install`, `POST /api/uninstall`.
+Always written: the `[skills]` table of root `enact-config.toml` (the managed-repo marker the `enact-hook` runtime checks; the file is shared, and each root table has one owner — `version`/`[hooks]`/`[rules]`/`[repo]` enact-hook, `[skills]` enact-extensions, `[controls]` enact-repo-controls). If the file is missing, install creates it with `version = 1` plus `[skills]`. If it lacks `[skills]`, install appends a `[skills]` block (`version = 1`) as text, leaving every other byte intact. If `[skills]` already exists, install leaves it alone. Install never writes `[hooks]`, refuses to append to a file that is not valid TOML, and no longer creates `.agents/enact-repo.toml`; the baseline `lean-ctx` config (`config.toml`, `layout.toml`) as managed whole files at `.agents/lean-ctx/config/lean-ctx/`; six managed lines in `.agents/.gitignore` — `/lean-ctx/data/`, `/lean-ctx/cache/`, `/lean-ctx/state/`, `/lean-ctx/bin/` (lean-ctx's runtime-generated dirs stay out of git; `config/` itself is committed), plus `/hooks/hooks.log` and `/hooks/hooks-activity.log` (the `enact-hook` runtime's own deny/activity logs under `.agents/hooks/`, same treatment: a plain uninstall keeps these two lines while either log file still exists on disk, `--purge` removes the log files themselves first); and `.agents/enact-repo.lock.json`. Commit all of it except what `.gitignore` excludes.
 
-## Install ledger
+The lock records every managed file (sha256), every entry merged into a user file, and the plugin version, all as relative paths:
 
-Every install and uninstall is appended to a single global JSONL file at `~/.enact/extensions/ledger.jsonl`. Each record contains `{ts, action, name, version, platform, scope, home, path, hash}`. The `hash` field is a sha256 content hash of the canonical bundle at install time — this is the drift detector used by `outdated` to catch content changes even without a version bump. The ledger is best-effort: a write failure never fails the install/uninstall operation. View it with:
+- **Re-runs are idempotent.** An unchanged bundle produces no diff. Narrowing `--host` removes the dropped hosts' managed content.
+- **Merged user files are edited surgically.** `.claude/settings.json`, `.cursor/hooks.json`, `.cursor/mcp.json`, `.kimi-code/mcp.json`, `.codex/hooks.json`, and `.codex/config.toml` only gain or lose the bundle's own entries. Key order and indentation are preserved.
+- **Refusals (override with `--force`).** Install stops if a managed file or entry was edited since the last install, or if a same-named MCP server or marketplace entry exists that the bundle does not own. The error names each file.
+- **Uninstall removes exactly what the lock records.** It deletes a merged file only if install created it and it is now empty, then deletes the lock. `enact-config.toml` stays unless you pass `--purge`. `--purge` cuts only the `[skills]` block install wrote, at text level; it refuses if that block was edited (with `--force`, it keeps the block). It deletes the file only if install created it and nothing but `version = 1` remains.
+
+Install the CLI itself globally (the CLI binary only — no plugins, no host config):
 
 ```bash
-enact-extensions log           # human-readable, newest first
-enact-extensions log --json    # raw JSON array
+bash dev-install-and-run.sh        # npm install, build, npm pack + npm install -g, verify
+enact-extensions doctor enact-repo --repo <path>
 ```
 
+The published package ships `bundled-extensions.json`, `dist/`, `spec/`, the CLI scripts, and `extensions/enact-repo` only (`tests/package-contents.test.mjs` pins this and installs the packed tarball into a temp prefix).
+
 ## Layout
 
 ```text
-enact-extensions/                    # @amsterdamdatalabs/enact-extensions package root
-├── src/ spec/ scripts/              # manifest library + CLI (validate | sync | install | uninstall | list | index | log | outdated | update | serve)
-├── web/                             # management UI — web/index.html + web/assets/tokens/*.css + web/assets/logo-*.png
-├── generated/                       # gitignored — local discovery artifacts (e.g. index.json)
-└── extensions/                      # self-contained plugin bundles
-    ├── plugin-dev/                  #   plugin authoring toolkit
-    ├── cmux/ devops/ dev-state/     #   first-party skill bundles
-    ├── enact-context/ enact-factory/ enact-loop/ enact-wiki/
-    └── net-revenue-management/      #   product and platform bundles
+enact-extensions/
+├── src/ spec/ scripts/   # manifest library + CLI
+├── generated/            # gitignored discovery artifacts
+└── extensions/           # self-contained plugin bundles
 ```
 
 ## enact-os integration
 
-`enact-os` submodules **this** repo at `enact-extensions/` for manifest tooling, and separately submodules the product packages (`enact-context`, `enact-factory`, `enact-wiki`) at top level. Factory and config paths in `enact-os/config.toml` target each product package by its top-level path.
-
-Host plugin delivery now lives in this repo for the shipped bundles under `extensions/`, including `enact-context`, `enact-factory`, `enact-loop`, and `enact-wiki`. **enact-loop is the default/recommended loop and contract-runner product.** Product runtimes still live in their own repos; use `enact-extensions install <name> --platform <surface>` for host registration, while repo-local commands such as `enact-factory setup` or `enact-factory plugins delivery` persist local runtime state.
+`enact-os` submodules this repo at `enact-extensions/` for manifest tooling and separately submodules product packages at top level. This package is repo-local agent setup only (`enact-repo` — see [`bundled-extensions.json`](bundled-extensions.json)); anything global belongs to `enact-vps`. Repo-local commands such as `enact-factory setup` manage runtime state.

package/bundled-extensions.json

@@ -0,0 +1,6 @@
+{
+  "bundled": [
+    "enact-repo",
+    "enact-loop"
+  ]
+}

package/dist/create/enact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enact.d.ts","sourceRoot":"","sources":["../../src/create/enact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CA6B3E"}
+{"version":3,"file":"enact.d.ts","sourceRoot":"","sources":["../../src/create/enact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CA8B3E"}

package/dist/create/enact.js

@@ -27,6 +27,8 @@ export function createEnactManifest(input) {
         manifest.factory = input.factory;
     if (input.operator)
         manifest.operator = input.operator;
+    if (input.principles)
+        manifest.principles = input.principles;
     return manifest;
 }
 //# sourceMappingURL=enact.js.map

package/dist/create/enact.js.map

@@ -1 +1 @@
-{"version":3,"file":"enact.js","sourceRoot":"","sources":["../../src/create/enact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,2DAA2D,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAmB;QAC/B,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;QACjC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG,IAAI,2BAA2B;QACpE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;QACrD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,YAAY;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC,GAAG,eAAe,CAAC;QAC9C,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;KAC5C,CAAC;IAEF,IAAI,KAAK,CAAC,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACvD,IAAI,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC7D,IAAI,KAAK,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC1D,IAAI,KAAK,CAAC,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACpD,IAAI,KAAK,CAAC,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAEvD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"enact.js","sourceRoot":"","sources":["../../src/create/enact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,2DAA2D,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAmB;QAC/B,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;QACjC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG,IAAI,2BAA2B;QACpE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;QACrD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,YAAY;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC,GAAG,eAAe,CAAC;QAC9C,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;KAC5C,CAAC;IAEF,IAAI,KAAK,CAAC,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACvD,IAAI,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAC7D,IAAI,KAAK,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC1D,IAAI,KAAK,CAAC,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACpD,IAAI,KAAK,CAAC,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACvD,IAAI,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAE7D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/create/index.d.ts

@@ -3,6 +3,9 @@ export { createEnactManifest } from "./enact.js";
 export { deriveClaudeManifest } from "./claude.js";
 export { deriveCodexManifest } from "./codex.js";
 export { deriveCursorManifest } from "./cursor.js";
+export { deriveKimiManifest } from "./kimi.js";
+export { deriveOpenCodeManifest, deriveOpenCodeMcp, deriveOpenCodePlugin, unmappedOpenCodeHookEvents, fallbackOpenCodeHookEvents, } from "./opencode.js";
+export type { OpenCodeLocalMcpServer, OpenCodeHookFallback, OpenCodePluginSource } from "./opencode.js";
 export declare function deriveManifest(platform: ProjectionPlatform, enact: PluginManifest): PluginManifest;
 export declare function resolveTargets(enact: PluginManifest): TargetPlatform[];
 export declare function resolveProjectionTargets(enact: PluginManifest): ProjectionPlatform[];

package/dist/create/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,cAAc,EACf,MAAM,sBAAsB,CAAC;AAa9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAWnD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,GACpB,cAAc,CAEhB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,CAMtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,EAAE,CAMpF;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAIF,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG;IACxD,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB,CASA;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAAE,GAC7B,UAAU,EAAE,CASd;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,GACpB,cAAc,CAKhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,cAAc,EACf,MAAM,sBAAsB,CAAC;AAe9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAaxG,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,GACpB,cAAc,CAEhB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,CAMtE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,EAAE,CAMpF;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAIF,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG;IACxD,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB,CASA;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAAE,GAC7B,UAAU,EAAE,CASd;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,GACpB,cAAc,CAKhB"}

package/dist/create/index.js

@@ -6,14 +6,20 @@ import { createEnactManifest } from "./enact.js";
 import { deriveClaudeManifest } from "./claude.js";
 import { deriveCodexManifest } from "./codex.js";
 import { deriveCursorManifest } from "./cursor.js";
+import { deriveKimiManifest } from "./kimi.js";
+import { deriveOpenCodeManifest } from "./opencode.js";
 export { createEnactManifest } from "./enact.js";
 export { deriveClaudeManifest } from "./claude.js";
 export { deriveCodexManifest } from "./codex.js";
 export { deriveCursorManifest } from "./cursor.js";
+export { deriveKimiManifest } from "./kimi.js";
+export { deriveOpenCodeManifest, deriveOpenCodeMcp, deriveOpenCodePlugin, unmappedOpenCodeHookEvents, fallbackOpenCodeHookEvents, } from "./opencode.js";
 const DERIVERS = {
     claude: deriveClaudeManifest,
     codex: deriveCodexManifest,
     cursor: deriveCursorManifest,
+    kimi: deriveKimiManifest,
+    opencode: deriveOpenCodeManifest,
 };
 export function deriveManifest(platform, enact) {
     return DERIVERS[platform](enact);

package/dist/create/index.js.map

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

package/dist/create/kimi.d.ts

@@ -0,0 +1,16 @@
+import type { PluginManifest } from "../internal/types.js";
+/**
+ * Derive the Kimi manifest (`.kimi-plugin/plugin.json`) from the canonical
+ * Enact manifest.
+ *
+ * v2 scope is project metadata + skills + commands. `hooks` and `mcpServers`
+ * are NOT inlined here — they need file reads from the plugin root (canonical
+ * `hooks` is a nested wrapper, `mcpServers` is a path). `installKimiPluginBundle`
+ * finalizes the manifest by inlining them after projecting the bundle onto disk.
+ * `agents` is still omitted because Kimi has no such field.
+ *
+ * Unlike Claude and Cursor, the default `skills` path is NOT stripped: Kimi has
+ * no skills auto-discovery, so an omitted `skills` field means zero skills.
+ */
+export declare function deriveKimiManifest(enact: PluginManifest): PluginManifest;
+//# sourceMappingURL=kimi.d.ts.map

package/dist/create/kimi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../src/create/kimi.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiC3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAiCxE"}

package/dist/create/kimi.js

@@ -0,0 +1,87 @@
+import { DEFAULT_PATHS, MANIFEST_FIELDS } from "../internal/platform.js";
+import { pickManifestFields, withPlatformKeyword } from "../internal/pick.js";
+/** The only `interface` keys Kimi's manifest parser reads (readInterface). */
+const KIMI_INTERFACE_FIELDS = [
+    "displayName",
+    "shortDescription",
+    "longDescription",
+    "developerName",
+    "websiteURL",
+];
+/**
+ * Project the canonical Enact `interface` block onto the five keys Kimi reads.
+ * Enact-only keys (category, capabilities, composerIcon, logo) are dropped —
+ * Kimi ignores them, and the derived manifest schema is closed.
+ * Returns undefined when nothing survives, so the field is omitted entirely.
+ */
+function kimiInterface(raw, homepage) {
+    const source = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+    const out = {};
+    for (const key of KIMI_INTERFACE_FIELDS) {
+        const value = source[key];
+        if (typeof value === "string" && value.trim())
+            out[key] = value;
+    }
+    // Enact has no `websiteURL`; Kimi shows it as the plugin's link, so fall back
+    // to the manifest's homepage.
+    if (out.websiteURL === undefined && typeof homepage === "string" && homepage.trim()) {
+        out.websiteURL = homepage;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Derive the Kimi manifest (`.kimi-plugin/plugin.json`) from the canonical
+ * Enact manifest.
+ *
+ * v2 scope is project metadata + skills + commands. `hooks` and `mcpServers`
+ * are NOT inlined here — they need file reads from the plugin root (canonical
+ * `hooks` is a nested wrapper, `mcpServers` is a path). `installKimiPluginBundle`
+ * finalizes the manifest by inlining them after projecting the bundle onto disk.
+ * `agents` is still omitted because Kimi has no such field.
+ *
+ * Unlike Claude and Cursor, the default `skills` path is NOT stripped: Kimi has
+ * no skills auto-discovery, so an omitted `skills` field means zero skills.
+ */
+export function deriveKimiManifest(enact) {
+    const picked = pickManifestFields(enact, MANIFEST_FIELDS.kimi);
+    const iface = kimiInterface(enact.interface, enact.homepage);
+    const manifest = {
+        ...picked,
+        description: (typeof picked.description === "string" ? picked.description : undefined) ??
+            `${enact.name} plugin for Kimi.`,
+        keywords: withPlatformKeyword(Array.isArray(picked.keywords) ? picked.keywords : undefined, "kimi"),
+        // Kimi requires component paths to start with "./" and to resolve inside the
+        // plugin root; anything else is an error diagnostic.
+        skills: normalizeKimiPath(picked.skills) ?? DEFAULT_PATHS.skills,
+    };
+    const commands = normalizeKimiPath(picked.commands);
+    if (commands)
+        manifest.commands = commands;
+    else
+        delete manifest.commands;
+    // Hooks and MCP servers are finalized at install time (see
+    // installKimiPluginBundle). Strip any raw canonical values so the derived
+    // manifest is valid for `validateKimiManifest` and sync projections.
+    delete manifest.hooks;
+    delete manifest.mcpServers;
+    delete manifest.skillInstructions;
+    if (iface)
+        manifest.interface = iface;
+    else
+        delete manifest.interface;
+    return manifest;
+}
+/** Coerce a manifest path to Kimi's required leading-"./" form. */
+function normalizeKimiPath(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.startsWith("./"))
+        return trimmed;
+    if (trimmed.startsWith("../") || trimmed.startsWith("/"))
+        return undefined;
+    return `./${trimmed}`;
+}
+//# sourceMappingURL=kimi.js.map

package/dist/create/kimi.js.map

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

package/dist/create/opencode.d.ts

@@ -0,0 +1,129 @@
+import type { PluginManifest } from "../internal/types.js";
+/**
+ * Derive the OpenCode descriptor (`.opencode-plugin/plugin.json`) from the
+ * canonical Enact manifest. OpenCode has no documented plugin manifest file of
+ * its own — this descriptor is Enact-internal bookkeeping (validated by
+ * spec/opencode.json) that records project metadata plus the canonical
+ * `hooks`/`mcpServers` SOURCE PATHS (not their resolved content). A future
+ * installer reads those paths, loads the referenced JSON, and calls
+ * {@link deriveOpenCodeMcp} / {@link deriveOpenCodePlugin} to generate the
+ * real OpenCode artifacts: a root `opencode.json` MCP fragment and a
+ * `.opencode/plugins/<name>.ts` file.
+ */
+export declare function deriveOpenCodeManifest(enact: PluginManifest): PluginManifest;
+export interface OpenCodeLocalMcpServer {
+    type: "local";
+    command: string[];
+    environment?: Record<string, string>;
+    cwd?: string;
+    enabled: true;
+}
+/**
+ * Project a canonical `.mcp.json` document
+ * (`{mcpServers:{name:{command,args,env,cwd?}}}`) into OpenCode's root
+ * `opencode.json` MCP fragment.
+ *
+ * Source (verified 2026-09-14, this session): https://opencode.ai/docs —
+ * OpenCode MCP servers are declared directly under `"mcp"` in `opencode.json`
+ * as `{"<name>": {"type":"local", "command":["cmd", ...args],
+ * "environment": {...}, "cwd": "...", "enabled": true}}`. There is no
+ * `servers` wrapper (unlike the canonical `mcpServers` key) and no `disabled`
+ * key — OpenCode uses `enabled` and we always emit `enabled: true` for a
+ * server the canonical manifest declares (a disabled server simply would not
+ * be declared).
+ *
+ * Servers without a `command` (e.g. a remote/HTTP-only definition) have no
+ * documented OpenCode "local" equivalent here and are skipped rather than
+ * guessed at.
+ */
+export declare function deriveOpenCodeMcp(canonicalMcp: unknown): {
+    mcp: Record<string, OpenCodeLocalMcpServer>;
+};
+/**
+ * Project a canonical matcher (e.g. `"Bash"`, or
+ * `"Write|Edit|MultiEdit|StrReplace|str_replace_editor|..."`) into an
+ * OpenCode-tool-id alternation (e.g. `"bash"`, `"write|edit"`), deduping
+ * repeated targets. A token with no known canonical mapping is kept
+ * (lowercased) as a passthrough rather than dropped -- combined with the
+ * case-insensitive ANCHORED matching {@link emitToolMethod} generates, this
+ * is a safety net that still matches an already-OpenCode-shaped or unknown
+ * matcher instead of silently never firing.
+ */
+export declare function projectMatcherToOpenCode(matcher: string): string;
+/**
+ * Return canonical hook events that declare active commands but have no
+ * documented OpenCode equivalent in {@link OPENCODE_HOOK_EVENT_MAP} AND no
+ * entry in {@link OPENCODE_HOOK_EVENT_FALLBACK} (a fallback-projected event
+ * is not "unmapped" — see {@link fallbackOpenCodeHookEvents}).
+ */
+export declare function unmappedOpenCodeHookEvents(canonicalHooks: unknown): string[];
+/** One canonical event projected via {@link OPENCODE_HOOK_EVENT_FALLBACK}. */
+export interface OpenCodeHookFallback {
+    /** The canonical event with no direct OpenCode equivalent (e.g. "SessionEnd"). */
+    from: string;
+    /** The canonical event whose OpenCode handler it was folded into (e.g. "SessionIdle"). */
+    to: string;
+}
+/**
+ * Return the canonical hook events projected via
+ * {@link OPENCODE_HOOK_EVENT_FALLBACK} that declare active commands — e.g.
+ * `[{from:"SessionEnd", to:"SessionIdle"}]`. These are NOT reported by
+ * {@link unmappedOpenCodeHookEvents}: they run, just on a substitute event.
+ */
+export declare function fallbackOpenCodeHookEvents(canonicalHooks: unknown): OpenCodeHookFallback[];
+/** Input to {@link deriveOpenCodePlugin}: the three canonical bundle sources a generated OpenCode plugin carries. */
+export interface OpenCodePluginSource {
+    /** Canonical hooks.json document, i.e. `{hooks:{EventName:[...]}}`. */
+    hooks?: unknown;
+    /** Canonical .mcp.json document, i.e. `{mcpServers:{name:{command,args,env,cwd?}}}`. */
+    mcpServers?: unknown;
+    /**
+     * Plugin-relative path to the bundle's skills directory (e.g. `"./skills"`),
+     * if the bundle has one. Resolved at runtime as `join(directory, skillsDir)`
+     * — `directory` is the OpenCode-supplied project root, never
+     * `${CLAUDE_PLUGIN_ROOT}` (OpenCode does not set that env var).
+     */
+    skillsDir?: string;
+}
+/**
+ * Generate the TypeScript source for a SINGLE OpenCode project plugin
+ * (`.opencode/plugins/<pluginName>.ts`) that carries a bundle's hooks, MCP
+ * servers AND skills together — see the module-level owner-decision comment
+ * above for the live-evidence basis of every mapping choice below.
+ *
+ * Runtime choice: OpenCode plugins run on Bun. This generated file uses
+ * `Bun.spawn` rather than the Bun Shell `$` helper because `Bun.spawn` has a
+ * documented `timeout` + `killSignal` option
+ * (https://bun.com/docs/api/spawn, verified 2026-09-14) needed to honor each
+ * canonical hook command's `timeout` (seconds), and gives direct access to
+ * `stdin`, `exitCode`, `stdout`/`stderr` text.
+ *
+ * Truthful failures: a hook command that crashes (e.g. `Bun.spawn` itself
+ * throws) or exits non-zero for a reason other than a PreToolUse deny is
+ * logged to stderr with the plugin's name — never silently swallowed, and
+ * never treated as a block (fail open). The PreToolUse deny throw itself
+ * happens OUTSIDE any try/catch in the generated code, so it can never be
+ * caught and swallowed by error handling elsewhere in the same method.
+ *
+ * PreToolUse (`tool.execute.before`) deny contract: the configured command
+ * receives `{hook_event_name, tool_name, tool_input, cwd, session_id}` as
+ * JSON on stdin. The call is blocked (the generated hook throws) when the
+ * command exits with code 2, or its stdout parses as JSON with
+ * `hookSpecificOutput.permissionDecision === "deny"`.
+ *
+ * UserPromptSubmit (`chat.message` + `experimental.chat.system.transform`):
+ * the configured command receives `{hook_event_name:"UserPromptSubmit",
+ * prompt, cwd, session_id}` as JSON on stdin. Its `hookSpecificOutput.additionalContext`
+ * (or, failing that, its raw stdout) is stored keyed by session id and
+ * injected into `output.system` the next time `experimental.chat.system.transform`
+ * fires for that same session — see the module comment for why this replaced
+ * a direct `output.parts` push.
+ *
+ * Canonical events with no documented OpenCode equivalent and no fallback are
+ * NOT wired into any hook; call {@link unmappedOpenCodeHookEvents} to get
+ * that list. Events projected via {@link OPENCODE_HOOK_EVENT_FALLBACK} (e.g.
+ * SessionEnd -> SessionIdle) ARE wired in, under their fallback target's
+ * bucket; call {@link fallbackOpenCodeHookEvents} to get that list.
+ */
+export declare function deriveOpenCodePlugin(source: OpenCodePluginSource, pluginName: string): string;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/create/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/create/opencode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAY5E;AAMD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;CACf;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;CAAE,CAmCxG;AAmJD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYhE;AA2DD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAS5E;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAO1F;AA8JD,qHAAqH;AACrH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAsO7F"}