engineering-intelligence 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Engineering Intelligence OS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# Engineering Intelligence OS
+
+`engineering-intelligence` installs a reusable, graph-backed engineering-orchestration toolkit into a software repository for AI coding IDEs. The installed skills and workflows teach the IDE agent how to initialize an evidence-based project knowledge base, map architecture, analyze change impact, and keep intelligence synchronized while implementing engineering work.
+
+The installer does **not** inspect the target source code, call an AI model, or generate documentation itself. That work occurs later inside the selected IDE when a developer invokes the installed workflow.
+
+## Supported IDEs
+
+| IDE adapter | Installed integration | Invocation |
+| --- | --- | --- |
+| Antigravity | `.agents/skills`, `.agents/rules`, `.agents/workflows` | Native slash workflows |
+| Codex | `.agents/skills`, managed `AGENTS.md` guidance | Mention the installed `$skill-name` in chat |
+| Claude Code | `.claude/skills`, `.claude/agents`, `.claude/commands`, managed `CLAUDE.md` | Native slash workflows |
+| Cursor | `.cursor/rules`, `.cursor/commands` | Native slash workflows |
+| GitHub Copilot | `.github/skills`, `.github/agents`, `.github/prompts`, managed instructions | Use supported skills/prompts or ask for the workflow in chat |
+| Gemini CLI | `.agents/skills`, `.gemini/commands`, managed `GEMINI.md` | Native slash workflows |
+| Generic | `.agents/skills`, managed `AGENTS.md` | Ask the agent to invoke the named workflow |
+
+## Install
+
+From the repository that should receive the toolkit:
+
+```bash
+npx engineering-intelligence
+```
+
+For repeatable or multi-IDE setup:
+
+```bash
+npx engineering-intelligence install . --ide antigravity --ide codex --ide cursor --yes
+npx engineering-intelligence install ./my-project --ide claude-code,gemini-cli --dry-run
+```
+
+With no `--ide` in an interactive terminal, the CLI prompts for one or more adapters. In noninteractive use, `--yes` without an adapter installs the `generic` adapter.
+
+## Use In A Target Repository
+
+Initialize project understanding through the selected AI IDE:
+
+```text
+/initialize-engineering-intelligence
+```
+
+Then use the engineering workflow for implementation requests:
+
+```text
+/engineering-intelligence Add rate limiting to public authentication endpoints
+```
+
+V2 adds four read-only-with-respect-to-product-code workflows:
+
+```text
+/map-architecture
+/analyze-impact Introduce a checkout service boundary
+/sync-engineering-intelligence Review the current working-tree diff
+/review-engineering-change Review the current working-tree diff
+```
+
+`/map-architecture` writes graph intelligence, `/analyze-impact` writes impact reports, `/sync-engineering-intelligence` updates intelligence artifacts, and `/review-engineering-change` writes findings. Only `/engineering-intelligence` is intended to implement product-code changes.
+
+Where a host does not expose native custom slash commands, mention the installed skill name or request the same workflow in chat.
+
+The IDE agent, not this installer, creates and maintains:
+
+```text
+knowledge-base/
+.engineering-intelligence/memory/
+.engineering-intelligence/context/
+.engineering-intelligence/events/
+.engineering-intelligence/graph/
+.engineering-intelligence/reports/
+.changes/
+```
+
+Graph intelligence includes `dependency-graph.json`, `service-graph.json`, `runtime-graph.json`, `business-flow-graph.json`, and a Mermaid-backed `architecture-map.md`. Impact and review results are stored as `IMP-XXX-*.md` and `REV-XXX-*.md` reports.
+
+The installer reserves only `.engineering-intelligence/install-manifest.json` for safe lifecycle management.
+
+## Lifecycle Commands
+
+```bash
+npx engineering-intelligence update . --dry-run
+npx engineering-intelligence update .
+npx engineering-intelligence doctor .
+npx engineering-intelligence doctor . --json
+npx engineering-intelligence uninstall . --dry-run
+npx engineering-intelligence uninstall .
+```
+
+Installation and update track managed content hashes. Files created by the package are updated only when they still match their installed version. Shared instruction documents such as `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` receive a marked managed block; content outside that block remains user-owned. Locally modified managed content is reported as a conflict and preserved unless `--force` is explicitly provided.
+
+`doctor` validates installed files, manifest drift, template paths, and obsolete legacy `.agent` folders.
+
+Repositories installed with V1 can adopt V2 safely:
+
+```bash
+npx engineering-intelligence update .
+```
+
+The update adds graph/impact skills and workflows and updates untouched managed instruction blocks; locally edited managed files remain protected by conflict reporting.
+
+## Toolkit Contents
+
+The default package installs only engineering-intelligence capabilities:
+
+- initialization, knowledge extraction, and validation
+- impact and testing intelligence
+- evidence-backed JSON architecture graphs and Mermaid architecture mapping
+- standalone impact, synchronization, and read-only engineering review workflows
+- incremental knowledge, memory, and context synchronization
+- change history, architecture review, and refactoring planning
+- engineering orchestrator, change, quality, and knowledge roles
+
+Earlier experimental trading, PDF, and unrelated workflow assets in this development repository are not exported in the package and are never installed into a target project.
+
+## Development
+
+```bash
+npm install
+npm test
+npm pack
+```
+
+The source repository is organized as:
+
+```text
+src/adapters/      native IDE renderers
+src/installer/     install, update, conflict, and uninstall behavior
+src/manifest/      managed-content tracking
+src/validation/    doctor and content checks
+templates/canonical/ host-neutral engineering toolkit source
+test/              adapter and installer lifecycle tests
+```
+
+To add an IDE adapter:
+
+1. Add a renderer in `src/adapters/index.ts` using documented native locations and formats.
+2. Reuse canonical skills and workflow meaning rather than duplicating host-specific logic.
+3. Extend adapter and lifecycle tests to cover generated paths, multi-adapter compatibility, and update/uninstall behavior.
+4. Document the host’s actual invocation support in the supported IDE table.
+
+To improve workflow behavior, edit canonical templates under `templates/canonical/` and keep generated runtime paths host-neutral.

package/dist/adapters/index.d.ts

@@ -0,0 +1,4 @@
+import { type IdeId, type RenderedFile } from "../types.js";
+export declare function isIdeId(input: string): input is IdeId;
+export declare function renderAdapters(ides: IdeId[]): Promise<RenderedFile[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AA0JrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,KAAK,CAErD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAI3E"}

package/dist/adapters/index.js

@@ -0,0 +1,125 @@
+import { AGENT_NAMES, SKILL_NAMES, WORKFLOW_NAMES, readTemplate } from "../templates.js";
+import { IDE_IDS } from "../types.js";
+const BLOCK_ID = "engineering-intelligence";
+const sharedInstructions = `# Engineering Intelligence OS
+
+This repository uses installed engineering intelligence workflows.
+
+- For initial understanding and documentation, invoke \`initialize-engineering-intelligence\` or ask the agent to initialize engineering intelligence.
+- For implementation work, invoke \`engineering-intelligence\` with the request or ask the agent to apply the engineering intelligence workflow.
+- For architecture mapping, impact analysis, synchronization, or review, invoke \`map-architecture\`, \`analyze-impact\`, \`sync-engineering-intelligence\`, or \`review-engineering-change\`; these workflows do not modify product code.
+- Canonical generated outputs live in \`knowledge-base/\`, \`.engineering-intelligence/memory/\`, \`.engineering-intelligence/context/\`, \`.engineering-intelligence/events/\`, \`.engineering-intelligence/graph/\`, \`.engineering-intelligence/reports/\`, and \`.changes/\`.
+- Before non-trivial edits, write an impact report; after edits, validate and incrementally synchronize only affected intelligence and graph artifacts.
+- Base documentation claims on repository evidence and identify unknowns explicitly.
+`;
+function file(path, content, owner) {
+    return { path, content, kind: "file", owners: [owner] };
+}
+function block(path, content, owner) {
+    return { path, content, kind: "block", blockId: BLOCK_ID, owners: [owner] };
+}
+async function skillsAt(directory, owner) {
+    return Promise.all(SKILL_NAMES.map(async (name) => file(`${directory}/${name}/SKILL.md`, await readTemplate("skills", name), owner)));
+}
+async function workflowsAt(directory, owner) {
+    return Promise.all(WORKFLOW_NAMES.map(async (name) => file(`${directory}/${name}.md`, await readTemplate("workflows", name), owner)));
+}
+async function agentsAt(directory, owner) {
+    return Promise.all(AGENT_NAMES.map(async (name) => file(`${directory}/${name}.md`, await readTemplate("agents", name), owner)));
+}
+async function renderAdapter(ide) {
+    switch (ide) {
+        case "antigravity":
+            return [
+                ...(await skillsAt(".agents/skills", ide)),
+                ...(await workflowsAt(".agents/workflows", ide)),
+                file(".agents/rules/engineering-intelligence.md", await readTemplate("rules", "engineering-intelligence"), ide),
+            ];
+        case "codex":
+            return [...(await skillsAt(".agents/skills", ide)), block("AGENTS.md", sharedInstructions, ide)];
+        case "generic":
+            return [...(await skillsAt(".agents/skills", ide)), block("AGENTS.md", sharedInstructions, ide)];
+        case "claude-code":
+            return [
+                ...(await skillsAt(".claude/skills", ide)),
+                ...(await agentsAt(".claude/agents", ide)),
+                ...(await workflowsAt(".claude/commands", ide)),
+                block("CLAUDE.md", sharedInstructions, ide),
+            ];
+        case "cursor": {
+            const rule = `---\ndescription: Engineering Intelligence orchestration and synchronization rules\nalwaysApply: true\n---\n\n${await readTemplate("rules", "engineering-intelligence")}`;
+            return [
+                file(".cursor/rules/engineering-intelligence.mdc", rule, ide),
+                ...(await workflowsAt(".cursor/commands", ide)),
+            ];
+        }
+        case "github-copilot": {
+            const agentFiles = await agentsAt(".github/agents", ide);
+            const promptFiles = await Promise.all(WORKFLOW_NAMES.map(async (name) => file(`.github/prompts/${name}.prompt.md`, await readTemplate("workflows", name), ide)));
+            return [
+                ...(await skillsAt(".github/skills", ide)),
+                ...agentFiles,
+                ...promptFiles,
+                block(".github/copilot-instructions.md", sharedInstructions, ide),
+            ];
+        }
+        case "gemini-cli": {
+            const workflowDescriptions = {
+                "initialize-engineering-intelligence": "Initialize engineering intelligence for this project.",
+                "engineering-intelligence": "Implement a request using engineering intelligence.",
+                "map-architecture": "Build or refresh evidence-backed architecture graph intelligence.",
+                "analyze-impact": "Analyze an intended change or existing diff without modifying product code.",
+                "sync-engineering-intelligence": "Synchronize affected project intelligence without modifying product code.",
+                "review-engineering-change": "Review an engineering change without applying fixes.",
+            };
+            const inputWorkflows = new Set([
+                "engineering-intelligence",
+                "analyze-impact",
+                "sync-engineering-intelligence",
+                "review-engineering-change",
+            ]);
+            const commands = await Promise.all(WORKFLOW_NAMES.map(async (name) => {
+                const workflow = await readTemplate("workflows", name);
+                const prompt = inputWorkflows.has(name)
+                    ? `${workflow}\n\nUser supplied scope or request: {{args}}`
+                    : workflow;
+                return file(`.gemini/commands/${name}.toml`, toGeminiCommand(workflowDescriptions[name], prompt), ide);
+            }));
+            return [
+                ...(await skillsAt(".agents/skills", ide)),
+                ...commands,
+                block("GEMINI.md", sharedInstructions, ide),
+            ];
+        }
+    }
+}
+function toGeminiCommand(description, prompt) {
+    const escaped = prompt.replaceAll('"""', '\\"\\"\\"');
+    return `description = ${JSON.stringify(description)}\nprompt = """\n${escaped}\n"""\n`;
+}
+function mergeRenderedFiles(files) {
+    const merged = new Map();
+    for (const candidate of files) {
+        const existing = merged.get(candidate.path);
+        if (!existing) {
+            merged.set(candidate.path, candidate);
+            continue;
+        }
+        if (existing.kind !== candidate.kind ||
+            existing.content !== candidate.content ||
+            existing.blockId !== candidate.blockId) {
+            throw new Error(`Adapters produce incompatible managed content for ${candidate.path}`);
+        }
+        existing.owners = [...new Set([...existing.owners, ...candidate.owners])];
+    }
+    return [...merged.values()].sort((left, right) => left.path.localeCompare(right.path));
+}
+export function isIdeId(input) {
+    return IDE_IDS.includes(input);
+}
+export async function renderAdapters(ides) {
+    const unique = [...new Set(ides)];
+    const outputs = await Promise.all(unique.map(renderAdapter));
+    return mergeRenderedFiles(outputs.flat());
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { fileURLToPath } from "node:url";
+import { isIdeId } from "../adapters/index.js";
+import { install, uninstall, update } from "../installer/index.js";
+import { doctor } from "../validation/index.js";
+import { IDE_IDS } from "../types.js";
+async function packageVersion() {
+    const packageJson = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
+    const parsed = JSON.parse(await readFile(packageJson, "utf8"));
+    return parsed.version;
+}
+function usage() {
+    return `engineering-intelligence
+
+Install engineering intelligence orchestration assets for AI coding IDEs.
+
+Usage:
+  engineering-intelligence [install] [path] [--ide <id>...] [--yes] [--dry-run] [--force]
+  engineering-intelligence update [path] [--dry-run] [--force]
+  engineering-intelligence doctor [path] [--json]
+  engineering-intelligence uninstall [path] [--dry-run] [--force]
+
+IDE ids: ${IDE_IDS.join(", ")}
+`;
+}
+function parseArgs(args) {
+    let command = "install";
+    const remaining = [...args];
+    if (remaining[0] && ["install", "update", "doctor", "uninstall"].includes(remaining[0])) {
+        command = remaining.shift();
+    }
+    if (remaining.includes("--help") || remaining.includes("-h")) {
+        output.write(usage());
+        process.exit(0);
+    }
+    const ides = [];
+    let target;
+    let yes = false;
+    let dryRun = false;
+    let force = false;
+    let json = false;
+    for (let index = 0; index < remaining.length; index += 1) {
+        const arg = remaining[index];
+        if (arg === "--ide") {
+            const value = remaining[++index];
+            if (!value) {
+                throw new Error("--ide requires a value.");
+            }
+            for (const ide of value.split(",")) {
+                if (!isIdeId(ide)) {
+                    throw new Error(`Unknown IDE "${ide}". Supported: ${IDE_IDS.join(", ")}.`);
+                }
+                ides.push(ide);
+            }
+        }
+        else if (arg.startsWith("--ide=")) {
+            const value = arg.slice("--ide=".length);
+            for (const ide of value.split(",")) {
+                if (!isIdeId(ide)) {
+                    throw new Error(`Unknown IDE "${ide}". Supported: ${IDE_IDS.join(", ")}.`);
+                }
+                ides.push(ide);
+            }
+        }
+        else if (arg === "--yes" || arg === "-y") {
+            yes = true;
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else if (arg === "--force") {
+            force = true;
+        }
+        else if (arg === "--json") {
+            json = true;
+        }
+        else if (arg.startsWith("-")) {
+            throw new Error(`Unknown option "${arg}".`);
+        }
+        else if (!target) {
+            target = arg;
+        }
+        else {
+            throw new Error(`Unexpected argument "${arg}".`);
+        }
+    }
+    return {
+        command,
+        root: path.resolve(target ?? process.cwd()),
+        ides: [...new Set(ides)],
+        yes,
+        dryRun,
+        force,
+        json,
+    };
+}
+async function selectIdes(options) {
+    if (options.command !== "install" || options.ides.length > 0) {
+        return options.ides;
+    }
+    if (options.yes || !input.isTTY) {
+        return ["generic"];
+    }
+    const readline = createInterface({ input, output });
+    output.write(`Select one or more IDE adapters:\n${IDE_IDS.map((ide, i) => `  ${i + 1}. ${ide}`).join("\n")}\n`);
+    const answer = await readline.question("Adapter numbers or ids, comma separated [generic]: ");
+    readline.close();
+    const choices = answer.trim().length === 0 ? ["generic"] : answer.split(",").map((part) => part.trim());
+    return [...new Set(choices.map((choice) => {
+            const numbered = Number.parseInt(choice, 10);
+            const candidate = Number.isNaN(numbered) ? choice : IDE_IDS[numbered - 1];
+            if (!candidate || !isIdeId(candidate)) {
+                throw new Error(`Unknown IDE selection "${choice}".`);
+            }
+            return candidate;
+        }))];
+}
+function printActions(actions) {
+    for (const action of actions) {
+        const detail = action.message ? ` - ${action.message}` : "";
+        output.write(`${action.status.padEnd(9)} ${action.path}${detail}\n`);
+    }
+}
+function printResult(label, result, dryRun) {
+    printActions(result.actions);
+    const prefix = dryRun ? "Dry run:" : `${label}:`;
+    output.write(`${prefix} ${result.changed} changed, ${result.conflicts} conflict(s).\n`);
+}
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    const version = await packageVersion();
+    if (options.command === "doctor") {
+        const actions = await doctor(options.root);
+        if (options.json) {
+            output.write(`${JSON.stringify(actions, null, 2)}\n`);
+        }
+        else {
+            printActions(actions);
+        }
+        process.exitCode = actions.some((action) => action.status === "error") ? 1 : 0;
+        return;
+    }
+    if (options.command === "uninstall") {
+        const result = await uninstall(options.root, { dryRun: options.dryRun, force: options.force, packageVersion: version });
+        printResult("Uninstall complete", result, options.dryRun);
+        process.exitCode = result.conflicts > 0 ? 1 : 0;
+        return;
+    }
+    if (options.command === "update") {
+        const result = await update(options.root, { dryRun: options.dryRun, force: options.force, packageVersion: version });
+        printResult("Update complete", result, options.dryRun);
+        process.exitCode = result.conflicts > 0 ? 1 : 0;
+        return;
+    }
+    const ides = await selectIdes(options);
+    const result = await install(options.root, ides, {
+        dryRun: options.dryRun,
+        force: options.force,
+        packageVersion: version,
+    });
+    printResult(`Installed ${ides.join(", ")}`, result, options.dryRun);
+    if (!options.dryRun && result.conflicts === 0) {
+        output.write("Open your selected AI IDE and invoke the installed initialization workflow.\n");
+    }
+    process.exitCode = result.conflicts > 0 ? 1 : 0;
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Error: ${message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAqD,MAAM,aAAa,CAAC;AAczF,KAAK,UAAU,cAAc;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAwB,CAAC;IACtF,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,SAAS,KAAK;IACZ,OAAO;;;;;;;;;;WAUE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;CAC5B,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,OAAO,GAAY,SAAS,CAAC;IACjC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,GAAG,SAAS,CAAC,KAAK,EAAa,CAAC;IACzC,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAY,EAAE,CAAC;IACzB,IAAI,MAA0B,CAAC;IAC/B,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7E,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7E,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC3C,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,CAAC;QACf,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,GAAG;QACH,MAAM;QACN,KAAK;QACL,IAAI;KACL,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAgB;IACxC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,qCAAqC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,qDAAqD,CAAC,CAAC;IAC9F,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,IAAI,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,OAAqB;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,MAAuB,EAAE,MAAe;IAC1E,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;IACjD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC,SAAS,iBAAiB,CAAC,CAAC;AAC1F,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QACxH,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QACrH,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE;QAC/C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO;KACxB,CAAC,CAAC;IACH,WAAW,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/installer/blocks.d.ts

@@ -0,0 +1,5 @@
+export declare function managedBlock(content: string, id: string): string;
+export declare function readManagedBlock(source: string, id: string): string | undefined;
+export declare function upsertManagedBlock(source: string, content: string, id: string): string;
+export declare function removeManagedBlock(source: string, id: string): string;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/installer/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/installer/blocks.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAUtF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrE"}

package/dist/installer/blocks.js

@@ -0,0 +1,27 @@
+const START = (id) => `<!-- ${id}:start -->`;
+const END = (id) => `<!-- ${id}:end -->`;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function managedBlock(content, id) {
+    return `${START(id)}\n${content.trimEnd()}\n${END(id)}`;
+}
+export function readManagedBlock(source, id) {
+    const expression = new RegExp(`${escapeRegExp(START(id))}\\n([\\s\\S]*?)\\n${escapeRegExp(END(id))}`);
+    return expression.exec(source)?.[1];
+}
+export function upsertManagedBlock(source, content, id) {
+    const replacement = managedBlock(content, id);
+    const expression = new RegExp(`${escapeRegExp(START(id))}\\n[\\s\\S]*?\\n${escapeRegExp(END(id))}`);
+    if (expression.test(source)) {
+        return source.replace(expression, replacement);
+    }
+    const prefix = source.length === 0 ? "" : `${source.trimEnd()}\n\n`;
+    return `${prefix}${replacement}\n`;
+}
+export function removeManagedBlock(source, id) {
+    const expression = new RegExp(`\\n?${escapeRegExp(START(id))}\\n[\\s\\S]*?\\n${escapeRegExp(END(id))}\\n?`);
+    const remaining = source.replace(expression, "\n").trimEnd();
+    return remaining.length > 0 ? `${remaining}\n` : "";
+}
+//# sourceMappingURL=blocks.js.map

package/dist/installer/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../src/installer/blocks.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;AAC7D,MAAM,GAAG,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;AAEzD,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,EAAU;IACtD,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,EAAU;IACzD,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,qBAAqB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CACvE,CAAC;IACF,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,OAAe,EAAE,EAAU;IAC5E,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,mBAAmB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CACrE,CAAC;IACF,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IACpE,OAAO,GAAG,MAAM,GAAG,WAAW,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,EAAU;IAC3D,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,mBAAmB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAC7E,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/installer/index.d.ts

@@ -0,0 +1,10 @@
+import type { IdeId, OperationResult } from "../types.js";
+export interface MutationOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    packageVersion: string;
+}
+export declare function install(root: string, requestedAdapters: IdeId[], options: MutationOptions): Promise<OperationResult>;
+export declare function update(root: string, options: MutationOptions): Promise<OperationResult>;
+export declare function uninstall(root: string, options: MutationOptions): Promise<OperationResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,KAAK,EAGL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAgID,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,KAAK,EAAE,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CAqD1B;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAM7F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAyBhG"}