@doidor/agentrig 0.5.3

package/dist/commands/update.js

@@ -0,0 +1,176 @@
+import { readFileSync, existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { spawnSync } from "node:child_process";
+import { writeState, readState } from "../core/state.js";
+import { loadManifest, refreshPolicy } from "../core/knowledge.js";
+import { install, baseVars, addOnlyCopy } from "../core/install.js";
+import { linkSurfaces } from "../core/surfaces.js";
+import { compileSurfaces } from "../core/compile.js";
+import { resolveSrc } from "../core/knowledge.js";
+import { auditHarness } from "../core/audit.js";
+import { color, log } from "../core/logger.js";
+import { ActivityMonitor } from "../core/activity.js";
+import { getProvider } from "../agent/index.js";
+import { buildUpdatePrompt, SYSTEM_MESSAGE } from "../prompts/index.js";
+import { renderAudit } from "./eval.js";
+import { join } from "../core/fsutil.js";
+import pkg from "../version.js";
+function hashFile(path) {
+    if (!existsSync(path))
+        return null;
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+/** Read-only: show how preserved (tailorable) files differ from the latest canonical version. */
+function diffPreserved(repoRoot) {
+    const manifest = loadManifest();
+    const preserved = manifest.artifacts.filter((a) => a.kind !== "template" && refreshPolicy(a) === "preserve");
+    let any = false;
+    for (const a of preserved) {
+        const { drifted } = addOnlyCopy(repoRoot, resolveSrc(a.src), join(repoRoot, a.dest), a.mode, false);
+        for (const relPath of drifted) {
+            any = true;
+            const repoFile = join(repoRoot, relPath);
+            // Map the drifted repo-relative path back to its canonical source file.
+            const sub = relPath.slice(a.dest.length).replace(/^\//, "");
+            const canonical = sub ? join(resolveSrc(a.src), sub) : resolveSrc(a.src);
+            log.info(color.bold(`\n• ${relPath}`) + color.dim("  (preserved; canonical drifted)"));
+            const res = spawnSync("diff", ["-u", "--label", "canonical", canonical, "--label", relPath, repoFile], { encoding: "utf8" });
+            log.info(res.stdout ? res.stdout.trimEnd() : color.dim("  (binary or unreadable diff)"));
+        }
+    }
+    if (!any)
+        log.ok("no preserved files have drifted from canonical.");
+    return 0;
+}
+/**
+ * Re-sync the latest canonical best practices into a repo. Machinery files are overwritten;
+ * tailorable artifacts are refreshed add-only (new files added, existing ones preserved) with any
+ * canonical drift handed to the agent reconcile. Templates (AGENTS.md) are reconciled by the agent.
+ */
+export async function updateCommand(repoRoot, options) {
+    const state = readState(repoRoot);
+    if (!state) {
+        log.error("No AgentRig harness here. Run `agentrig init` first.");
+        return 1;
+    }
+    if (options.diff) {
+        log.info(color.bold("AgentRig — drift of preserved files vs canonical\n"));
+        return diffPreserved(repoRoot);
+    }
+    const manifest = loadManifest();
+    const versionBump = state.knowledgeVersion !== manifest.knowledgeVersion;
+    const refreshable = manifest.artifacts.filter((a) => a.kind !== "template");
+    const templates = manifest.artifacts.filter((a) => a.kind === "template").map((a) => a.dest);
+    // Split by refresh policy. `overwrite` = AgentRig-owned machinery/docs (replace to stay current);
+    // `preserve` = tailorable content (add-only; never clobber existing files).
+    const toOverwrite = [];
+    for (const a of refreshable.filter((a) => refreshPolicy(a) === "overwrite")) {
+        if (a.kind === "dir") {
+            if (versionBump)
+                toOverwrite.push(a);
+        }
+        else if (hashFile(resolveSrc(a.src)) !== hashFile(join(repoRoot, a.dest))) {
+            toOverwrite.push(a);
+        }
+    }
+    // Add-only refresh for preserved artifacts: classify first (apply only when not a dry run).
+    const added = [];
+    const drifted = [];
+    for (const a of refreshable.filter((a) => refreshPolicy(a) === "preserve")) {
+        const r = addOnlyCopy(repoRoot, resolveSrc(a.src), join(repoRoot, a.dest), a.mode, !options.dryRun);
+        added.push(...r.added);
+        drifted.push(...r.drifted);
+    }
+    log.info(color.bold(`AgentRig — updating harness (knowledge ${state.knowledgeVersion} → ${manifest.knowledgeVersion})\n`));
+    if (toOverwrite.length === 0 && added.length === 0 && drifted.length === 0 && !versionBump) {
+        log.ok("already up to date — nothing to refresh.");
+        return 0;
+    }
+    if (options.dryRun) {
+        if (toOverwrite.length) {
+            log.step("dry run — would overwrite (AgentRig-owned):");
+            for (const a of toOverwrite)
+                log.info(`  ${a.dest}`);
+        }
+        if (added.length) {
+            log.step("dry run — would add new files:");
+            for (const f of added)
+                log.info(`  ${f}`);
+        }
+        if (drifted.length) {
+            log.step("dry run — preserved (local edits kept); agent would reconcile canonical drift:");
+            for (const f of drifted)
+                log.info(color.dim(`  ${f}`));
+        }
+        log.step("dry run — agent would reconcile templates:");
+        for (const t of templates)
+            log.info(color.dim(`  ${t}`));
+        return 0;
+    }
+    // Apply: overwrite machinery (preserved files were already add-only-applied above).
+    log.step("refreshing harness…");
+    const onlyOverwrite = { ...manifest, artifacts: toOverwrite };
+    const { installed } = install(repoRoot, onlyOverwrite, { vars: baseVars(repoRoot) });
+    log.ok(`overwrote ${installed.length} owned file(s); added ${added.length} new file(s); preserved ${drifted.length} edited file(s)`);
+    // Ensure vendor-surface symlinks exist (added in later knowledge versions).
+    const surfaces = linkSurfaces(repoRoot);
+    if (surfaces.created.length)
+        log.ok(`linked surfaces: ${surfaces.created.join(", ")} → .agents`);
+    // Re-project the canonical source into every agent surface (local + remote).
+    const compiled = compileSurfaces(repoRoot);
+    log.ok(`compiled ${compiled.generated.length} agent-surface file(s)`);
+    // The agent reconciles templates plus any preserved files whose canonical version drifted.
+    const reconcileList = [...drifted, ...templates];
+    if (!options.skipAgent) {
+        const provider = getProvider();
+        const pre = await provider.preflight();
+        if (pre.ok) {
+            log.ok(`agent ready (${pre.detail})`);
+            log.step("reconciling repo-specific content…");
+            const monitor = new ActivityMonitor().start();
+            const convo = await provider.startConversation({
+                cwd: repoRoot,
+                ...(options.model ? { model: options.model } : {}),
+                systemMessage: SYSTEM_MESSAGE,
+                onEvent: monitor.handle,
+            });
+            try {
+                const summary = await convo.send(buildUpdatePrompt(reconcileList));
+                monitor.stop();
+                log.ok("reconciliation complete");
+                if (options.verbose)
+                    log.info(color.dim(summary));
+            }
+            finally {
+                monitor.stop();
+                await convo.end();
+            }
+        }
+        else {
+            log.warn(`agent unavailable (${pre.detail}); skipped reconciliation.`);
+        }
+    }
+    else if (drifted.length) {
+        log.warn(`--skip-agent: ${drifted.length} edited file(s) were preserved; canonical updates to them were NOT applied.`);
+        log.warn("Run `agentrig update` (with the agent) to reconcile them, or diff against the templates manually.");
+    }
+    // Merge installed records: every refreshable artifact is present/current after update.
+    const now = new Date().toISOString();
+    const byId = new Map(state.installed.map((i) => [i.id, i]));
+    for (const a of refreshable) {
+        byId.set(a.id, { id: a.id, dest: a.dest, knowledgeVersion: manifest.knowledgeVersion, installedAt: now });
+    }
+    const newState = {
+        ...state,
+        agentrigVersion: pkg.version,
+        knowledgeVersion: manifest.knowledgeVersion,
+        updatedAt: now,
+        installed: [...byId.values()],
+    };
+    writeState(repoRoot, newState);
+    log.ok("updated .agentrig/state.json");
+    log.info("");
+    renderAudit(auditHarness(repoRoot));
+    return 0;
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/core/activity.js

@@ -0,0 +1,80 @@
+import { color, log, isVerbose } from "./logger.js";
+function truncate(s, n) {
+    const oneLine = s.replace(/\s+/g, " ").trim();
+    return oneLine.length > n ? oneLine.slice(0, n - 1) + "…" : oneLine;
+}
+/**
+ * Renders the agent's live activity (intents, tool calls, reasoning, narration) as timestamped
+ * lines, and emits a heartbeat so long, quiet steps never look frozen. Pass its `handle` as the
+ * conversation's `onEvent`.
+ */
+export class ActivityMonitor {
+    heartbeatSeconds;
+    startMs = Date.now();
+    lastEventMs = Date.now();
+    toolCount = 0;
+    lastLabel = "thinking…";
+    timer = null;
+    verbose = isVerbose();
+    constructor(heartbeatSeconds = 15) {
+        this.heartbeatSeconds = heartbeatSeconds;
+    }
+    elapsed() {
+        const s = Math.floor((Date.now() - this.startMs) / 1000);
+        return s < 60 ? `${s}s` : `${Math.floor(s / 60)}m${String(s % 60).padStart(2, "0")}s`;
+    }
+    line(symbol, text) {
+        log.activity(`[${this.elapsed()}] ${symbol} ${text}`);
+    }
+    /** Start the heartbeat. Call `stop()` when the step completes. */
+    start() {
+        this.timer = setInterval(() => {
+            const quietFor = Math.floor((Date.now() - this.lastEventMs) / 1000);
+            if (quietFor >= this.heartbeatSeconds) {
+                this.line("·", `still working — ${this.toolCount} tool calls so far, last: ${this.lastLabel}`);
+                this.lastEventMs = Date.now();
+            }
+        }, this.heartbeatSeconds * 1000);
+        if (this.timer.unref)
+            this.timer.unref();
+        return this;
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** Bind for use as `onEvent`. */
+    handle = (e) => {
+        this.lastEventMs = Date.now();
+        switch (e.type) {
+            case "intent":
+                this.lastLabel = truncate(e.text, 50);
+                this.line(color.cyan("▸"), truncate(e.text, 100));
+                break;
+            case "tool_start":
+                this.toolCount++;
+                this.lastLabel = e.text;
+                this.line("⚙", `${e.text}${e.detail ? color.dim(" · " + truncate(e.detail, 60)) : ""}`);
+                break;
+            case "tool_done":
+                if (e.ok === false)
+                    this.line(color.red("✗"), `tool failed: ${truncate(e.text, 80)}`);
+                else if (this.verbose)
+                    this.line(color.dim("✓"), "ok");
+                break;
+            case "assistant":
+                // Intermediate narration between tool batches — show a short summary.
+                this.line(color.dim("…"), truncate(e.text, 100));
+                break;
+            case "reasoning":
+                if (this.verbose)
+                    this.line(color.dim("~"), truncate(e.text, 100));
+                break;
+            case "compaction":
+                this.line(color.yellow("⟳"), e.text);
+                break;
+        }
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/core/activity.js.map

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

package/dist/core/audit.js

@@ -0,0 +1,112 @@
+import { existsSync, statSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { readText } from "./fsutil.js";
+import { loadCanonicalChecks } from "./knowledge.js";
+function frontmatter(text) {
+    if (!text || !text.startsWith("---"))
+        return null;
+    const end = text.indexOf("\n---", 3);
+    return end < 0 ? null : text.slice(3, end);
+}
+function extractValue(text, key) {
+    if (!text)
+        return null;
+    const m = text.match(new RegExp("^\\s*" + key + "\\s*:\\s*(.+)\\s*$", "m"));
+    return m ? m[1].trim() : null;
+}
+function scoreCheck(repoRoot, c) {
+    const rel = (p) => resolve(repoRoot, p);
+    const read = (p) => readText(rel(p));
+    switch (c.type) {
+        case "path-exists": {
+            const p = String(c.path);
+            return existsSync(rel(p)) ? { score: 1, evidence: "" } : { score: 0, evidence: `missing ${p}` };
+        }
+        case "file-contains": {
+            const p = String(c.path);
+            const text = read(p);
+            if (text == null)
+                return { score: 0, evidence: `missing ${p}` };
+            const patterns = c.patterns ?? [];
+            const missing = patterns.filter((x) => !text.includes(x));
+            return missing.length === 0
+                ? { score: 1, evidence: "" }
+                : { score: 0.5, evidence: `present but missing markers: ${missing.join(", ")}` };
+        }
+        case "dir-min": {
+            const p = String(c.path);
+            const abs = rel(p);
+            if (!existsSync(abs) || !statSync(abs).isDirectory())
+                return { score: 0, evidence: `missing dir ${p}` };
+            const n = readdirSync(abs).filter((e) => !e.startsWith(".")).length;
+            const min = Number(c.min ?? 1);
+            return n >= min ? { score: 1, evidence: "" } : { score: 0.5, evidence: `${n} entries, need ${min}` };
+        }
+        case "frontmatter-keys": {
+            const p = String(c.path);
+            const fm = frontmatter(read(p));
+            if (fm == null)
+                return { score: 0, evidence: `no frontmatter in ${p}` };
+            const keys = c.keys ?? [];
+            const missing = keys.filter((k) => !new RegExp("^\\s*" + k + "\\s*:", "m").test(fm));
+            return missing.length === 0
+                ? { score: 1, evidence: "" }
+                : { score: 0.5, evidence: `missing keys: ${missing.join(", ")}` };
+        }
+        case "roles-distinct-models": {
+            const key = String(c.key ?? "model");
+            const dev = extractValue(read(String(c.developer)), key);
+            const rev = extractValue(read(String(c.reviewer)), key);
+            if (!dev || !rev)
+                return { score: 0, evidence: "developer/reviewer model not declared" };
+            return dev !== rev
+                ? { score: 1, evidence: "" }
+                : { score: 0.5, evidence: `developer and reviewer share model "${dev}"` };
+        }
+        default:
+            return { score: 0, evidence: `unknown check type ${c.type}` };
+    }
+}
+/** Resolve which checks to use: prefer the repo's installed checks.json, else AgentRig canonical. */
+function resolveChecks(repoRoot) {
+    const repoChecks = readText(join(repoRoot, ".agentrig", "eval", "checks.json"));
+    if (repoChecks) {
+        try {
+            return { checks: (JSON.parse(repoChecks).checks ?? []), source: "repo" };
+        }
+        catch {
+            /* fall through to canonical */
+        }
+    }
+    return { checks: loadCanonicalChecks(), source: "canonical" };
+}
+export function auditHarness(repoRoot) {
+    const { checks, source } = resolveChecks(repoRoot);
+    const results = checks.map((c) => {
+        const { score, evidence } = scoreCheck(repoRoot, c);
+        return { id: c.id, principle: c.principle, title: c.title, score, evidence };
+    });
+    let wSum = 0;
+    let wScore = 0;
+    const principleAcc = new Map();
+    for (let i = 0; i < results.length; i++) {
+        const w = Number(checks[i].weight ?? 1);
+        wSum += w;
+        wScore += w * results[i].score;
+        const acc = principleAcc.get(results[i].principle) ?? { sum: 0, n: 0 };
+        acc.sum += results[i].score;
+        acc.n += 1;
+        principleAcc.set(results[i].principle, acc);
+    }
+    const aggregate = wSum ? wScore / wSum : 0;
+    return {
+        harnessScore: Math.round(aggregate * 1000) / 10,
+        aggregate,
+        results,
+        byPrinciple: [...principleAcc.entries()]
+            .sort((a, b) => a[0] - b[0])
+            .map(([principle, v]) => ({ principle, score: v.sum / v.n })),
+        source,
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/core/audit.js.map

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

package/dist/core/compile.js

@@ -0,0 +1,250 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { ensureDir } from "./fsutil.js";
+const GEN_MD = "<!-- Generated by AgentRig from AGENTS.md + .agents/rules/. Do not edit here — edit the source and run `agentrig compile`. -->";
+const GEN_HASH = "# Generated by AgentRig. Do not edit here — edit the source and run `agentrig compile`.";
+/** Extract a section from AGENTS.md: prefer the AGENTRIG marker block, fall back to a `## Heading`. */
+function extractAgentsSection(text, marker, heading) {
+    const start = `<!-- AGENTRIG:${marker}:start -->`;
+    const end = `<!-- AGENTRIG:${marker}:end -->`;
+    const si = text.indexOf(start);
+    const ei = text.indexOf(end);
+    if (si >= 0 && ei > si)
+        return text.slice(si + start.length, ei).trim();
+    // Heading fallback: from "## <heading>" to the next "## ".
+    const h = new RegExp(`^##\\s+${heading}.*$`, "mi");
+    const m = h.exec(text);
+    if (!m)
+        return "";
+    const after = text.slice(m.index + m[0].length);
+    const nextH = after.search(/^##\s+/m);
+    return (nextH < 0 ? after : after.slice(0, nextH)).trim();
+}
+/** Drop lines still containing unfilled {{PLACEHOLDER}} template tokens. */
+function dropPlaceholders(text) {
+    return text
+        .split("\n")
+        .filter((l) => !/\{\{[A-Z0-9_]+\}\}/.test(l))
+        .join("\n")
+        .trim();
+}
+function parseGlobs(raw) {
+    if (!raw)
+        return ["**/*"];
+    const arr = raw.match(/\[(.*)\]/);
+    const inner = arr ? arr[1] : raw;
+    const globs = inner
+        .split(",")
+        .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+        .filter(Boolean);
+    return globs.length ? globs : ["**/*"];
+}
+function loadRules(repoRoot) {
+    const dir = join(repoRoot, ".agents", "rules");
+    if (!existsSync(dir))
+        return [];
+    const rules = [];
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith(".md") || file === "README.md")
+            continue;
+        const text = readFileSync(join(dir, file), "utf8");
+        const fm = text.startsWith("---") ? text.slice(3, text.indexOf("\n---", 3)) : "";
+        const body = text.startsWith("---") ? text.slice(text.indexOf("\n---", 3) + 4).trim() : text.trim();
+        const globs = parseGlobs((fm.match(/^\s*globs\s*:\s*(.+)$/m) || [])[1]);
+        const description = ((fm.match(/^\s*description\s*:\s*(.+)$/m) || [])[1] || file.replace(/\.md$/, "")).trim();
+        rules.push({ name: file.replace(/\.md$/, ""), globs, description, body });
+    }
+    return rules;
+}
+function detectSetup(repoRoot) {
+    const has = (f) => existsSync(join(repoRoot, f));
+    if (has("package.json")) {
+        let install = "npm install";
+        let cache = "npm";
+        if (has("pnpm-lock.yaml")) {
+            install = "corepack enable && pnpm install --frozen-lockfile";
+            cache = "pnpm";
+        }
+        else if (has("yarn.lock")) {
+            install = "corepack enable && yarn install --frozen-lockfile";
+            cache = "yarn";
+        }
+        else if (has("package-lock.json")) {
+            install = "npm ci";
+            cache = "npm";
+        }
+        return {
+            name: "Node.js",
+            steps: `      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "${cache}"
+      - name: Install dependencies
+        run: ${install}`,
+        };
+    }
+    if (has("pyproject.toml") || has("requirements.txt")) {
+        return {
+            name: "Python",
+            steps: `      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - name: Install dependencies
+        run: pip install -e . || pip install -r requirements.txt`,
+        };
+    }
+    if (has("go.mod")) {
+        return {
+            name: "Go",
+            steps: `      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "stable"
+      - name: Download modules
+        run: go mod download`,
+        };
+    }
+    return {
+        name: "generic",
+        steps: `      # TODO: set up your toolchain and install dependencies here so Copilot's
+      # ephemeral environment is ready before it starts working.`,
+    };
+}
+function write(repoRoot, rel, content, result) {
+    const abs = join(repoRoot, rel);
+    ensureDir(join(abs, ".."));
+    writeFileSync(abs, content.endsWith("\n") ? content : content + "\n");
+    result.generated.push(rel);
+}
+/**
+ * Project the canonical source (AGENTS.md + .agents/rules/) into every agent ecosystem's NATIVE
+ * surface — local and remote — so any agent benefits without lock-in. Idempotent. Pure projections
+ * are regenerated each run; `copilot-setup-steps.yml` is scaffolded once (user-owned).
+ */
+export function compileSurfaces(repoRoot) {
+    const result = { generated: [], skipped: [] };
+    const agentsPath = join(repoRoot, "AGENTS.md");
+    if (!existsSync(agentsPath)) {
+        result.skipped.push({ path: "AGENTS.md", reason: "missing — run `agentrig init` first" });
+        return result;
+    }
+    const agents = readFileSync(agentsPath, "utf8");
+    const critical = extractAgentsSection(agents, "critical-rules", "Critical Rules");
+    const context = dropPlaceholders(extractAgentsSection(agents, "context", "What this repository is"));
+    const rules = loadRules(repoRoot);
+    // --- GitHub Copilot (remote coding agent + IDE): repo-wide custom instructions ---
+    write(repoRoot, ".github/copilot-instructions.md", [
+        GEN_MD,
+        "",
+        "# Copilot instructions",
+        "",
+        critical || "See AGENTS.md for the project's agent instructions.",
+        "",
+        context ? "## About this repository\n\n" + context + "\n" : "",
+        "The full agent guide is in [AGENTS.md](../AGENTS.md). Path-specific rules live in",
+        "`.github/instructions/`.",
+    ].join("\n"), result);
+    // --- GitHub path-scoped instructions, one per rule (applyTo = the rule's globs) ---
+    for (const rule of rules) {
+        write(repoRoot, `.github/instructions/${rule.name}.instructions.md`, [
+            "---",
+            `applyTo: "${rule.globs.join(",")}"`,
+            "---",
+            GEN_MD,
+            "",
+            rule.body,
+        ].join("\n"), result);
+    }
+    // --- Cursor: .cursor/rules/*.mdc, one per rule ---
+    for (const rule of rules) {
+        const alwaysApply = rule.globs.length === 1 && rule.globs[0] === "**/*";
+        write(repoRoot, `.cursor/rules/${rule.name}.mdc`, [
+            "---",
+            `description: ${rule.description}`,
+            `globs: ${rule.globs.join(",")}`,
+            `alwaysApply: ${alwaysApply}`,
+            "---",
+            GEN_MD,
+            "",
+            rule.body,
+        ].join("\n"), result);
+    }
+    // --- Claude Code: CLAUDE.md imports AGENTS.md + inlines the critical rules ---
+    write(repoRoot, "CLAUDE.md", [
+        GEN_MD,
+        "",
+        "# Claude Code instructions",
+        "",
+        "@AGENTS.md",
+        "",
+        critical ? "## Critical rules\n\n" + critical : "",
+    ].join("\n"), result);
+    // --- MCP: project .mcp.json to the surfaces that read their own location ---
+    const mcpPath = join(repoRoot, ".mcp.json");
+    if (existsSync(mcpPath)) {
+        try {
+            const mcp = JSON.parse(readFileSync(mcpPath, "utf8"));
+            const servers = mcp.mcpServers ?? mcp.servers ?? {};
+            // VS Code reads `.vscode/mcp.json` with a top-level `servers` key.
+            write(repoRoot, ".vscode/mcp.json", JSON.stringify({ servers }, null, 2), result);
+            // Reference for the GitHub Copilot coding agent (also configurable in repo settings).
+            write(repoRoot, ".github/copilot/mcp.json", JSON.stringify({
+                $comment: "AgentRig: MCP servers for the Copilot coding agent. Add these in Settings → Copilot → coding agent if not auto-loaded.",
+                mcpServers: servers,
+            }, null, 2), result);
+        }
+        catch {
+            result.skipped.push({ path: ".vscode/mcp.json", reason: "could not parse .mcp.json" });
+        }
+    }
+    // --- Remote env: copilot-setup-steps.yml (scaffold once; user-owned thereafter) ---
+    const setupRel = ".github/workflows/copilot-setup-steps.yml";
+    if (existsSync(join(repoRoot, setupRel))) {
+        result.skipped.push({ path: setupRel, reason: "exists (user-owned; left untouched)" });
+    }
+    else {
+        const setup = detectSetup(repoRoot);
+        write(repoRoot, setupRel, `name: "Copilot Setup Steps"
+${GEN_HASH}
+# Prepares the Copilot coding agent's ephemeral environment (detected stack: ${setup.name}).
+# Customize freely — this file is yours after the first scaffold.
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be named \`copilot-setup-steps\` or Copilot will not pick it up.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+${setup.steps}
+`, result);
+    }
+    return result;
+}
+/** Files compileSurfaces is responsible for (used by audit/checks awareness). */
+export function compiledSurfacePaths(repoRoot) {
+    const paths = [
+        ".github/copilot-instructions.md",
+        "CLAUDE.md",
+        ".vscode/mcp.json",
+        ".github/workflows/copilot-setup-steps.yml",
+    ];
+    const instr = join(repoRoot, ".github", "instructions");
+    if (existsSync(instr) && statSync(instr).isDirectory())
+        paths.push(".github/instructions");
+    return paths;
+}
+//# sourceMappingURL=compile.js.map