@event4u/agent-config 3.3.0 → 4.1.0

package/dist/install/bridges/index.js

@@ -0,0 +1,88 @@
+/**
+ * Bridge registry — Phase A6 entrypoint.
+ *
+ * Maps stable tool IDs to pure builder functions. Callers pass a
+ * {@link BridgeContext} plus a list of enabled tool IDs and receive a
+ * flat list of {@link BridgeOutput}s ready for the apply layer.
+ *
+ * Order of `generateProjectBridges` output is **stable** — it follows
+ * the registration order below, which mirrors the Python install order
+ * (`scripts/install.py:_deploy_tool_content` dispatch table). Snapshot
+ * tests rely on this ordering.
+ *
+ * To add a tool:
+ *   1. Implement a `buildXxxBridge: BridgeBuilder` in `bridges/xxx.ts`.
+ *   2. Register it under its stable tool ID in {@link BRIDGE_REGISTRY}.
+ *   3. Add a snapshot fixture under `tests/install/bridges/__snapshots__/`.
+ */
+import { buildAugmentBridge } from './augment.js';
+import { buildClaudeBridge } from './claude.js';
+import { buildClineBridge } from './cline.js';
+import { buildCopilotBridge } from './copilot.js';
+import { buildCursorBridge } from './cursor.js';
+import { buildGeminiBridge } from './gemini.js';
+import { buildAiderBridge, buildClaudeDesktopBridge, buildCodexBridge, buildContinueBridge, buildJetbrainsBridge, buildKilocodeBridge, buildKiroBridge, buildRoocodeBridge, buildZedBridge, } from './markers.js';
+import { buildVscodeBridge } from './vscode.js';
+import { buildWindsurfBridge } from './windsurf.js';
+/**
+ * Stable tool ID → builder map. Order matches Python install dispatch.
+ *
+ * Using a tuple list (not a plain object) keeps iteration order
+ * deterministic across runtimes and survives accidental key reordering
+ * by tooling.
+ */
+export const BRIDGE_REGISTRY = [
+    // Substrate / plugin enablement.
+    ['vscode', buildVscodeBridge],
+    ['augment', buildAugmentBridge],
+    // Hook dispatchers (JSON).
+    ['claude', buildClaudeBridge],
+    ['cursor', buildCursorBridge],
+    ['windsurf', buildWindsurfBridge],
+    ['gemini', buildGeminiBridge],
+    // Multi-script.
+    ['cline', buildClineBridge],
+    // Plugin registration.
+    ['copilot', buildCopilotBridge],
+    // Informational markers.
+    ['roocode', buildRoocodeBridge],
+    ['claude-desktop', buildClaudeDesktopBridge],
+    ['aider', buildAiderBridge],
+    ['codex', buildCodexBridge],
+    ['continue', buildContinueBridge],
+    ['kilocode', buildKilocodeBridge],
+    ['zed', buildZedBridge],
+    ['jetbrains', buildJetbrainsBridge],
+    ['kiro', buildKiroBridge],
+];
+/** Set of every registered tool ID (cached for fast membership tests). */
+export const KNOWN_TOOL_IDS = new Set(BRIDGE_REGISTRY.map(([id]) => id));
+/**
+ * Generate the full list of bridge outputs for a project.
+ *
+ * @param ctx        Project root + package type.
+ * @param enabledIds Tool IDs to include. Unknown IDs are silently
+ *                   ignored — the detect/plan layer is the gatekeeper
+ *                   for enable/disable decisions, not the registry.
+ * @returns          Flat list of outputs in registry order. Cline (and
+ *                   any future multi-output builder) contributes
+ *                   multiple entries; all others contribute one.
+ */
+export function generateProjectBridges(ctx, enabledIds) {
+    const enabled = enabledIds instanceof Set ? enabledIds : new Set(enabledIds);
+    const out = [];
+    for (const [toolId, builder] of BRIDGE_REGISTRY) {
+        if (!enabled.has(toolId))
+            continue;
+        const result = builder(ctx);
+        if (Array.isArray(result)) {
+            out.push(...result);
+        }
+        else {
+            out.push(result);
+        }
+    }
+    return out;
+}
+export { dispatchCommand, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/install/bridges/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/install/bridges/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACH,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoD;IAC5E,iCAAiC;IACjC,CAAC,QAAQ,EAAU,iBAAiB,CAAC;IACrC,CAAC,SAAS,EAAS,kBAAkB,CAAC;IACtC,2BAA2B;IAC3B,CAAC,QAAQ,EAAU,iBAAiB,CAAC;IACrC,CAAC,QAAQ,EAAU,iBAAiB,CAAC;IACrC,CAAC,UAAU,EAAQ,mBAAmB,CAAC;IACvC,CAAC,QAAQ,EAAU,iBAAiB,CAAC;IACrC,gBAAgB;IAChB,CAAC,OAAO,EAAW,gBAAgB,CAAC;IACpC,uBAAuB;IACvB,CAAC,SAAS,EAAS,kBAAkB,CAAC;IACtC,yBAAyB;IACzB,CAAC,SAAS,EAAS,kBAAkB,CAAC;IACtC,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IAC5C,CAAC,OAAO,EAAW,gBAAgB,CAAC;IACpC,CAAC,OAAO,EAAW,gBAAgB,CAAC;IACpC,CAAC,UAAU,EAAQ,mBAAmB,CAAC;IACvC,CAAC,UAAU,EAAQ,mBAAmB,CAAC;IACvC,CAAC,KAAK,EAAa,cAAc,CAAC;IAClC,CAAC,WAAW,EAAO,oBAAoB,CAAC;IACxC,CAAC,MAAM,EAAY,eAAe,CAAC;CACtC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CACtD,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CACpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAClC,GAAkB,EAClB,UAAuD;IAEvD,MAAM,OAAO,GAAG,UAAU,YAAY,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,IAAI,CAAC,MAAsB,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAGD,OAAO,EAEH,eAAe,GAIlB,MAAM,YAAY,CAAC"}

package/dist/install/bridges/marker-content.js

@@ -0,0 +1,153 @@
+/**
+ * Marker content — verbatim payload for every marker-style bridge.
+ *
+ * Mirror of the `*_MARKER` string constants in
+ * `scripts/install.py` (lines 1561–1896). Kept in a separate module so
+ * snapshot tests can pin copy without dragging the builder closures in.
+ */
+export const ROOCODE_MARKER = `# Agent Config bridge
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Roo Code reads \`.roo/rules/*.md\` as system-level instructions. The
+canonical rule and skill source lives under \`.augment/\` (Augment
+portability mirror — see \`AGENTS.md\` for orientation).
+
+## How to use
+
+- These rules load automatically on every Roo Code session — no
+  manual action required.
+- Switch Roo Code modes (Architect / Code / Ask / Debug / Custom)
+  via the mode switcher to invoke different cognition profiles;
+  every mode still sees these rules.
+- Slash commands and skills live under \`.augment/commands/\` and
+  \`.augment/skills/\`. Roo Code does not register them natively —
+  invoke them by name in chat (e.g. *"run the create-pr command"*).
+
+See \`docs/setup/per-ide/roocode.md\` for the full activation guide.
+
+Run \`./agent-config --help\` for available commands.
+`;
+export const CLAUDE_DESKTOP_MARKER = `# Agent Config bridge — Claude Desktop
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Claude Desktop is a **global-scope** tool — it reads config from
+\`~/Library/Application Support/Claude/\` (macOS) and does not
+auto-discover project files. This marker is informational only.
+
+To wire Claude Desktop to this project's rules, run:
+\`npx @event4u/agent-config init --ai claude-desktop --global\`
+
+Canonical rule and skill source: \`.augment/\` (see \`AGENTS.md\`).
+`;
+export const AIDER_MARKER = `# Agent Config bridge — Aider
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Aider does not auto-discover this file. To activate it, add the
+following to \`.aider.conf.yml\` (create if missing):
+
+\`\`\`yaml
+read:
+  - .aider/agent-config.md
+\`\`\`
+
+Or pass \`--read .aider/agent-config.md\` on the command line.
+
+Canonical rule and skill source: \`.augment/\` (see \`AGENTS.md\`).
+`;
+export const CODEX_MARKER = `# Agent Config bridge — Codex CLI
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Codex CLI auto-discovers \`AGENTS.md\` at the project root — that file
+is the canonical entry point. This marker is informational and tells
+developers where the rules and skills live.
+
+Canonical rule and skill source: \`.augment/\` (see project \`AGENTS.md\`).
+`;
+export const CONTINUE_MARKER = `# Agent Config bridge — Continue.dev
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Continue.dev auto-discovers \`.continue/rules/*.md\` as system-level
+rules per session. The canonical rule and skill source lives under
+\`.augment/\` (Augment portability mirror — see \`AGENTS.md\` for
+orientation).
+`;
+export const KILOCODE_MARKER = `# Agent Config bridge — Kilo Code
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Kilo Code auto-discovers \`.kilocode/rules/*.md\` as system-level rules
+per session. The canonical rule and skill source lives under
+\`.augment/\` (Augment portability mirror — see \`AGENTS.md\` for
+orientation).
+
+## How to use
+
+- These rules load automatically on every Kilo Code session — no
+  manual action required.
+- Switch Kilo Code modes (Architect / Code / Ask / Debug /
+  Orchestrator) via the mode switcher to invoke different
+  cognition profiles; every mode still sees these rules.
+- Slash commands and skills live under \`.augment/commands/\` and
+  \`.augment/skills/\`. Kilo Code does not register them natively —
+  invoke them by name in chat (e.g. *"run the create-pr command"*).
+
+See \`docs/setup/per-ide/kilocode.md\` for the full activation guide.
+`;
+export const ZED_MARKER = `# Agent Config bridge — Zed
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Zed reads \`.rules\` at the project root as system-level instructions —
+that file is the canonical entry point. This marker is informational
+and tells developers where the rules and skills live.
+
+To activate agent-config under Zed, point Zed's \`.rules\` at the
+canonical source (or symlink it):
+
+\`\`\`
+# Append to .rules at project root
+@.augment/AGENTS.md
+\`\`\`
+
+Canonical rule and skill source: \`.augment/\` (see \`AGENTS.md\`).
+`;
+export const JETBRAINS_MARKER = `# Agent Config bridge — JetBrains AI Assistant
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+JetBrains AI Assistant reads custom prompts and guidelines from
+project-level config (\`.idea/\`) and user-scope settings. This marker
+is informational — to wire agent-config into JetBrains AI, point the
+assistant's custom-prompts path at \`.augment/\` or copy the relevant
+rules into your JetBrains profile.
+
+Canonical rule and skill source: \`.augment/\` (see \`AGENTS.md\`).
+`;
+export const KIRO_MARKER = `# Agent Config bridge — Kiro
+
+This file marks the project as an \`event4u/agent-config\` consumer.
+
+Kiro auto-discovers \`.kiro/steering/*.md\` as steering documents per
+session. The canonical rule and skill source lives under \`.augment/\`
+(Augment portability mirror — see \`AGENTS.md\` for orientation).
+
+## How to use
+
+- Steering documents load automatically on every Kiro session — no
+  manual action required.
+- For structured, plan-first work, use Kiro's **Spec** workflow
+  (the agent produces a spec → tasks → implementation under your
+  review). For free-form work, use **Vibe**. Both honor these
+  steering documents.
+- Slash commands and skills live under \`.augment/commands/\` and
+  \`.augment/skills/\`. Kiro does not register them natively —
+  invoke them by name in chat (e.g. *"run the create-pr command"*).
+
+See \`docs/setup/per-ide/kiro.md\` for the full activation guide.
+`;
+//# sourceMappingURL=marker-content.js.map

package/dist/install/bridges/marker-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-content.js","sourceRoot":"","sources":["../../../src/install/bridges/marker-content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsB7B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;CAYpC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;CAe3B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;CAS3B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;CAQ9B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB9B,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;CAiBzB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;CAW/B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB1B,CAAC"}

package/dist/install/bridges/markers.js

@@ -0,0 +1,42 @@
+/**
+ * Marker bridges — informational `.md` files for AI tools without a
+ * programmatic hook surface (or with one we deliberately do not touch).
+ *
+ * Each builder drops a single UTF-8 marker pointing developers at the
+ * canonical rule source under `.augment/`. Markers are static — no
+ * dispatcher wiring, no JSON merge. Content lives next to the builder
+ * so snapshot tests pin both shape and copy verbatim.
+ *
+ * Mirrors `scripts/install.py:ensure_{roocode,claude_desktop,aider,
+ * codex,continue,kilocode,zed,jetbrains,kiro}_bridge` (lines 1555–1913).
+ */
+import { join } from 'node:path';
+import { AIDER_MARKER, CLAUDE_DESKTOP_MARKER, CODEX_MARKER, CONTINUE_MARKER, JETBRAINS_MARKER, KILOCODE_MARKER, KIRO_MARKER, ROOCODE_MARKER, ZED_MARKER, } from './marker-content.js';
+function marker(toolId, relPath, content) {
+    return (ctx) => ({
+        kind: 'marker',
+        toolId,
+        target: join(ctx.projectRoot, ...relPath),
+        content,
+        label: relPath.join('/'),
+    });
+}
+/** `.roo/rules/agent-config.md` — Roo Code marker. */
+export const buildRoocodeBridge = marker('roocode', ['.roo', 'rules', 'agent-config.md'], ROOCODE_MARKER);
+/** `.claude-desktop/agent-config.md` — Claude Desktop informational marker. */
+export const buildClaudeDesktopBridge = marker('claude-desktop', ['.claude-desktop', 'agent-config.md'], CLAUDE_DESKTOP_MARKER);
+/** `.aider/agent-config.md` — Aider marker (no `.aider.conf.yml` mutation). */
+export const buildAiderBridge = marker('aider', ['.aider', 'agent-config.md'], AIDER_MARKER);
+/** `.codex/agent-config.md` — OpenAI Codex CLI marker (AGENTS.md is canonical). */
+export const buildCodexBridge = marker('codex', ['.codex', 'agent-config.md'], CODEX_MARKER);
+/** `.continue/rules/agent-config.md` — Continue.dev marker. */
+export const buildContinueBridge = marker('continue', ['.continue', 'rules', 'agent-config.md'], CONTINUE_MARKER);
+/** `.kilocode/rules/agent-config.md` — Kilo Code marker. */
+export const buildKilocodeBridge = marker('kilocode', ['.kilocode', 'rules', 'agent-config.md'], KILOCODE_MARKER);
+/** `.zed/agent-config.md` — Zed informational marker. */
+export const buildZedBridge = marker('zed', ['.zed', 'agent-config.md'], ZED_MARKER);
+/** `.jetbrains/agent-config.md` — JetBrains AI informational marker. */
+export const buildJetbrainsBridge = marker('jetbrains', ['.jetbrains', 'agent-config.md'], JETBRAINS_MARKER);
+/** `.kiro/steering/agent-config.md` — Kiro marker. */
+export const buildKiroBridge = marker('kiro', ['.kiro', 'steering', 'agent-config.md'], KIRO_MARKER);
+//# sourceMappingURL=markers.js.map

package/dist/install/bridges/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../../src/install/bridges/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EACH,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,cAAc,EACd,UAAU,GACb,MAAM,qBAAqB,CAAC;AAE7B,SAAS,MAAM,CACX,MAAc,EACd,OAA8B,EAC9B,OAAe;IAEf,OAAO,CAAC,GAAG,EAAsB,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC;QACzC,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;KAC3B,CAAC,CAAC;AACP,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CACpC,SAAS,EACT,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,EACpC,cAAc,CACjB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAC1C,gBAAgB,EAChB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EACtC,qBAAqB,CACxB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAClC,OAAO,EACP,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC7B,YAAY,CACf,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAClC,OAAO,EACP,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC7B,YAAY,CACf,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CACrC,UAAU,EACV,CAAC,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,EACzC,eAAe,CAClB,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CACrC,UAAU,EACV,CAAC,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,EACzC,eAAe,CAClB,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAChC,KAAK,EACL,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3B,UAAU,CACb,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CACtC,WAAW,EACX,CAAC,YAAY,EAAE,iBAAiB,CAAC,EACjC,gBAAgB,CACnB,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CACjC,MAAM,EACN,CAAC,OAAO,EAAE,UAAU,EAAE,iBAAiB,CAAC,EACxC,WAAW,CACd,CAAC"}

package/dist/install/bridges/types.js

@@ -0,0 +1,31 @@
+/**
+ * Bridge builder contract — Phase A6.
+ *
+ * Each AI tool (Claude Code, Cursor, Cline, Windsurf, Copilot, …) gets
+ * one builder function that takes a {@link BridgeContext} and returns a
+ * {@link BridgeOutput}. Output is **declarative** — the apply layer
+ * decides between byte-merge (`mergeJsonContent`) and overwrite based
+ * on the {@link BridgeOutput.kind} discriminator.
+ *
+ * Pure functions:
+ *   - No filesystem reads inside builders.
+ *   - No string interpolation against env-vars or `Date.now()` — the
+ *     snapshot tests rely on deterministic output.
+ *   - Path resolution uses `bridges/paths.ts` helpers, not `path.join`
+ *     scattered across bridges.
+ *
+ * Mirrors `scripts/install.py:749-1913` (the `# --- Bridge generators ---`
+ * block). Side effects from the Python `merge_json_file` / `write_file`
+ * calls move into the apply layer (Phase A4 + A5).
+ */
+/**
+ * Shape of the `./agent-config dispatch:hook` invocation embedded in
+ * every hook-dispatcher bridge.
+ *
+ * Single source of truth so the snapshot tests can assert the command
+ * string contract without re-implementing the formatter per bridge.
+ */
+export function dispatchCommand(platform, acEvent, native) {
+    return `./agent-config dispatch:hook --platform ${platform} --event ${acEvent} --native-event ${native}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/install/bridges/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/install/bridges/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA+EH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAgB,EAAE,MAAc;IAC9E,OAAO,2CAA2C,QAAQ,YAAY,OAAO,mBAAmB,MAAM,EAAE,CAAC;AAC7G,CAAC"}

package/dist/install/bridges/vscode.js

@@ -0,0 +1,26 @@
+/**
+ * VSCode bridge — `.vscode/settings.json` plugin location wiring.
+ *
+ * Substrate bridge — declares the chat plugin location based on the
+ * detected package type. NPM consumers resolve through node_modules;
+ * other ecosystems use the bundled `./plugin/agent-config` directory.
+ *
+ * Mirror of `scripts/install.py:ensure_vscode_bridge` (lines 876–885).
+ */
+import { join } from 'node:path';
+const PLUGIN_PATHS = {
+    npm: './node_modules/@event4u/agent-config/plugin/agent-config',
+};
+const DEFAULT_PLUGIN_PATH = './plugin/agent-config';
+/** Builder for the VSCode project-scope bridge. */
+export const buildVscodeBridge = (ctx) => {
+    const pluginPath = PLUGIN_PATHS[ctx.packageType] ?? DEFAULT_PLUGIN_PATH;
+    return {
+        kind: 'json',
+        toolId: 'vscode',
+        target: join(ctx.projectRoot, '.vscode', 'settings.json'),
+        payload: { 'chat.pluginLocations': { [pluginPath]: true } },
+        label: '.vscode/settings.json',
+    };
+};
+//# sourceMappingURL=vscode.js.map

package/dist/install/bridges/vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../../src/install/bridges/vscode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,YAAY,GAAqC;IACnD,GAAG,EAAE,0DAA0D;CAClE,CAAC;AAEF,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAEpD,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAkB,CAAC,GAAG,EAAoB,EAAE;IACtE,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC;IACxE,OAAO;QACH,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,eAAe,CAAC;QACzD,OAAO,EAAE,EAAE,sBAAsB,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE;QAC3D,KAAK,EAAE,uBAAuB;KACjC,CAAC;AACN,CAAC,CAAC"}

package/dist/install/bridges/windsurf.js

@@ -0,0 +1,35 @@
+/**
+ * Windsurf bridge — `.windsurf/hooks.json` project-scope hooks.
+ *
+ * Cascade fires project hooks with the workspace as cwd, so no
+ * trampoline is needed. `show_output: false` keeps post hooks silent
+ * (per Windsurf docs); concerns stream their own output via
+ * `agents/runtime/state/.dispatcher/`.
+ *
+ * Mirror of `scripts/install.py:ensure_windsurf_bridge` (lines 1331–1356).
+ */
+import { join } from 'node:path';
+import { dispatchCommand, } from './types.js';
+export const WINDSURF_BINDINGS = [
+    ['session_start', 'post_setup_worktree'],
+    ['user_prompt_submit', 'pre_user_prompt'],
+    ['stop', 'post_cascade_response'],
+];
+/** Builder for the Windsurf project-scope bridge. */
+export const buildWindsurfBridge = (ctx) => {
+    const hooks = {};
+    for (const [acEvent, native] of WINDSURF_BINDINGS) {
+        (hooks[native] ??= []).push({
+            command: dispatchCommand('windsurf', acEvent, native),
+            show_output: false,
+        });
+    }
+    return {
+        kind: 'json',
+        toolId: 'windsurf',
+        target: join(ctx.projectRoot, '.windsurf', 'hooks.json'),
+        payload: { hooks },
+        label: '.windsurf/hooks.json',
+    };
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/install/bridges/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/install/bridges/windsurf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAGH,eAAe,GAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,iBAAiB,GAA8C;IACxE,CAAC,eAAe,EAAO,qBAAqB,CAAC;IAC7C,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;IACzC,CAAC,MAAM,EAAgB,uBAAuB,CAAC;CAClD,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAkB,CAAC,GAAG,EAAoB,EAAE;IACxE,MAAM,KAAK,GAAiC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAChD,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;YACxB,OAAO,EAAE,eAAe,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;YACrD,WAAW,EAAE,KAAK;SACrB,CAAC,CAAC;IACP,CAAC;IACD,OAAO;QACH,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC;QACxD,OAAO,EAAE,EAAE,KAAK,EAAE;QAClB,KAAK,EAAE,sBAAsB;KAChC,CAAC;AACN,CAAC,CAAC"}

package/dist/install/conflict.js

@@ -0,0 +1,196 @@
+/**
+ * Conflict resolution — Phase A5 (simplified, three modes).
+ *
+ * Three decisions only, replacing the legacy `prompt → write / skip /
+ * abort` triple from `scripts/install.py:_resolve_file_conflict`:
+ *
+ * - `write`   — target either does not exist OR policy authorises overwrite.
+ * - `skip`    — target exists, known path, not forced: leave it alone.
+ * - `surface` — foreign collision: defer to the wizard's conflict screen
+ *               (Phase B3). Headless callers translate `surface` to `skip`
+ *               unless `policy.force` is true.
+ *
+ * JSON-aware deep-merge stays: callers that detect a `.json` target with
+ * matching `knownPointers` route through {@link mergeJsonContent} instead
+ * of byte-equality.
+ */
+import { existsSync } from 'node:fs';
+import { sha256File } from './plan.js';
+/**
+ * Decide what to do with a single planned target.
+ *
+ * Decision matrix (mirrors the Python legacy with the 3-option prompt
+ * collapsed into `surface`):
+ *
+ * | Exists? | Idempotent? | Known? | Force? | → Outcome  |
+ * |---------|-------------|--------|--------|------------|
+ * | no      | —           | —      | —      | `write`    |
+ * | yes     | yes         | —      | —      | `skip`     |
+ * | yes     | no          | yes    | no     | `skip`     |
+ * | yes     | no          | yes    | yes    | `write`    |
+ * | yes     | no          | no     | yes    | `write`    |
+ * | yes     | no          | no     | no     | `surface`  |
+ *
+ * Headless callers (B1 CLI) collapse `surface` to `skip` automatically
+ * because there is no UI to defer to; the apply layer records the entry
+ * under {@link ApplyResult.conflicts} so the wizard can pick it up next.
+ */
+export function resolveFileConflict(inputs) {
+    const { targetPath, idempotent, exists, policy } = inputs;
+    if (!exists)
+        return 'write';
+    if (idempotent)
+        return 'skip';
+    const isKnown = policy.knownPaths.has(targetPath);
+    if (isKnown) {
+        return policy.force ? 'write' : 'skip';
+    }
+    if (policy.force)
+        return 'write';
+    return 'surface';
+}
+/**
+ * Recursive object merge — overlay wins, nested dicts merged, arrays replaced.
+ *
+ * Mirrors `scripts/install.py:deep_merge`. Arrays do **not** concatenate;
+ * Claude / Cursor / Cline hook configs rely on whole-array replacement to
+ * stay idempotent across re-runs.
+ *
+ * Returns a fresh object — both inputs remain untouched.
+ */
+export function deepMerge(base, overlay) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(overlay)) {
+        const prev = out[key];
+        if (isPlainObject(prev) && isPlainObject(value)) {
+            out[key] = deepMerge(prev, value);
+        }
+        else {
+            out[key] = cloneValue(value);
+        }
+    }
+    return out;
+}
+/**
+ * Merge `overlay` into `existing` and return the canonical 4-space JSON.
+ *
+ * Format matches `write_json_file` in the Python installer (4-space indent,
+ * trailing newline, no ASCII-escape) so the apply layer can compare bytes
+ * to detect idempotent merges and skip the write.
+ */
+export function mergeJsonContent(existing, overlay) {
+    const merged = deepMerge(existing, overlay);
+    return `${JSON.stringify(merged, null, 4)}\n`;
+}
+/**
+ * Parse JSON bytes leniently — invalid / non-object payloads collapse to `{}`.
+ *
+ * Matches `read_json_file` in the legacy script: corrupt JSON is treated
+ * as an empty doc rather than a hard failure, so the merge step always
+ * produces a well-formed output even when an upstream tool wrote a
+ * truncated config.
+ */
+export function parseJsonLenient(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* fall through — treat as empty */
+    }
+    return {};
+}
+/** Heuristic for routing a {@link FileEntry} through JSON merge. */
+export function isJsonTarget(entry) {
+    return entry.kind === 'deployed' && entry.path.endsWith('.json');
+}
+/**
+ * Threshold at which the wizard switches the conflict screen from
+ * single-pick to batch-resolution mode (council Finding #19).
+ *
+ * Below the threshold the user picks a resolution per row; at or above
+ * it the screen renders a summary table + global CTAs to dodge the
+ * 50-click stale-tree problem.
+ */
+export const CONFLICT_BATCH_THRESHOLD = 5;
+/**
+ * Walk an {@link InstallPlan} and return one {@link ConflictEntry} per
+ * planned target the policy would `surface` to the UI.
+ *
+ * Pure-ish — reads from the filesystem only to compute idempotency
+ * (`existsSync` + `sha256File`). Skips bridges (`sha256 === null`) since
+ * bridge writers own a separate idempotency model. Skips entries whose
+ * `path` is in `policy.knownPaths`, and skips entries that are
+ * byte-equal to the planned content. Returns an empty array when
+ * `policy.force` is true — overwrite mode silences the screen.
+ */
+export function computeConflicts(plan) {
+    if (plan.policy.force)
+        return [];
+    const out = [];
+    for (const entries of Object.values(plan.filesByTool)) {
+        for (const entry of entries) {
+            if (entry.kind === 'bridge')
+                continue;
+            if (entry.sha256 === null)
+                continue;
+            if (!existsSync(entry.path))
+                continue;
+            if (plan.policy.knownPaths.has(entry.path))
+                continue;
+            const onDisk = sha256File(entry.path);
+            if (onDisk === entry.sha256)
+                continue;
+            out.push({
+                path: entry.path,
+                kind: entry.kind,
+                plannedSha256: entry.sha256,
+                existingSha256: onDisk,
+                mergeable: isJsonTarget(entry),
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Expand a batch choice into a per-path {@link ConflictResolution} map.
+ *
+ * The wizard sends either `resolutions` directly (single-pick mode) or
+ * a `batchChoice` (≥ 5 conflicts) that the server fans out across every
+ * surfaced entry. `merge-json` maps non-JSON entries to `skip` since
+ * deep-merge is JSON-only — the council picked skip over overwrite so a
+ * single non-JSON file in a batch never silently overwrites.
+ */
+export function expandBatchChoice(conflicts, choice) {
+    const out = {};
+    for (const c of conflicts) {
+        if (choice === 'skip-all') {
+            out[c.path] = 'skip';
+        }
+        else if (choice === 'overwrite-all') {
+            out[c.path] = 'overwrite';
+        }
+        else {
+            out[c.path] = c.mergeable ? 'merge' : 'skip';
+        }
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function cloneValue(v) {
+    if (Array.isArray(v)) {
+        return v.map(cloneValue);
+    }
+    if (isPlainObject(v)) {
+        const out = {};
+        for (const [k, val] of Object.entries(v))
+            out[k] = cloneValue(val);
+        return out;
+    }
+    return v;
+}
+//# sourceMappingURL=conflict.js.map

package/dist/install/conflict.js.map

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