@bridge_gpt/mcp-server 0.2.67 → 0.2.68

package/build/init.js

@@ -13,13 +13,9 @@ import { writeFile, mkdir, readFile, stat } from "fs/promises";
 import { execFile } from "child_process";
 import path from "path";
 import os from "os";
-import { COMMANDS } from "./commands.generated.js";
-import { renderCommandForHost } from "./command-host.js";
-import { CODEX_SKILLS_DIR, codexSkillAssets } from "./codex-skill-adapter.js";
-import { AGENTS } from "./agents.generated.js";
-import { DOCS } from "./docs.generated.js";
+import { buildPackagedAssetCatalog } from "./generated-assets-catalog.js";
+import { recordProvisionedAssets } from "./generated-assets-inventory.js";
 import { VERSION, LAUNCHER_ARGS } from "./version.generated.js";
-import { reconstructAgentMarkdown, translateAgentToCopilot, translateCommandToCopilot, } from "./agent-utils.js";
 import { BRIDGE_CONFIG_TEAMMATE_NOTICE_LINES, validateBridgeConfigRepoNameRepresentability, validateRepoName, resolveRepoNameForProjectRoot, } from "./bridge-config.js";
 import { ensureGitignored as ensureGitignoredShared } from "./git-ignore-utils.js";
 import { resolveBapiCredentials } from "./credential-store.js";
@@ -219,21 +215,23 @@ export async function resolveInitScaffoldAssets(options) {
     const ide = await detectInitIdes({ ...options, env });
     const pipelinesDir = resolveInitPipelinesDir(cwd, env);
     const instructionsDir = path.join(path.dirname(pipelinesDir), "instructions");
+    const catalog = buildPackagedAssetCatalog();
+    const hostKinds = [["claude", "command"], ...(ide.cursor ? [["cursor", "command"]] : []),
+        ["codex", "skill"], ...(ide.vscode ? [["copilot", "prompt"], ["copilot", "skill"]] : []),
+        ["claude", "agent"], ...(ide.vscode ? [["copilot", "agent"]] : [])];
+    const catalogDirectories = hostKinds.flatMap(([host, kind]) => {
+        const asset = catalog.assets.find(a => a.kind === kind && a.hosts.includes(host));
+        return asset ? [asset.destination.split("/").slice(0, 2).join("/")] : [];
+    });
     const commitSafePaths = [
         displayScaffoldPath(cwd, path.join(cwd, ".bridge", "config"), false),
         displayScaffoldPath(cwd, path.join(pipelinesDir, "README.md"), false),
         displayScaffoldPath(cwd, path.join(pipelinesDir, "example-pipeline.json"), false),
         displayScaffoldPath(cwd, instructionsDir, true),
-        displayScaffoldPath(cwd, path.join(cwd, ".claude", "commands"), true),
-        ...(ide.cursor ? [displayScaffoldPath(cwd, path.join(cwd, ".cursor", "commands"), true)] : []),
-        displayScaffoldPath(cwd, path.join(cwd, CODEX_SKILLS_DIR), true),
-        ...(ide.vscode ? [displayScaffoldPath(cwd, path.join(cwd, ".github", "prompts"), true)] : []),
-        ...(ide.vscode ? [displayScaffoldPath(cwd, path.join(cwd, ".github", "skills"), true)] : []),
-        displayScaffoldPath(cwd, path.join(cwd, ".claude", "agents"), true),
-        ...(ide.vscode ? [displayScaffoldPath(cwd, path.join(cwd, ".github", "agents"), true)] : []),
+        ...catalogDirectories.map(directory => displayScaffoldPath(cwd, path.join(cwd, directory), true)),
         // Sourced from the bundled DOCS map, so a new scaffolded doc is covered
         // automatically rather than needing a second edit here.
-        ...Object.keys(DOCS)
+        ...catalog.assets.filter(a => a.kind === "document").map(a => a.destination)
             .slice()
             .sort()
             .map((target) => displayScaffoldPath(cwd, path.join(cwd, target), false)),
@@ -844,173 +842,52 @@ export async function runInit(cwd, options = {}) {
         }
         warn(`  Fix with: npx -y ${MCP_PACKAGE_NAME} install   (or set BAPI_REPO_NAME and store a key with the install flow)`);
     }
-    // ---- Phase 4: Scaffold slash command directories ----
-    const commandDirs = [path.join(cwd, ".claude", "commands")];
-    if (ideDetection.cursor) {
-        commandDirs.push(path.join(cwd, ".cursor", "commands"));
-    }
-    const writtenFiles = new Set();
-    const skippedFiles = new Set();
-    const overwrittenFiles = new Set();
-    const commandEntries = Object.entries(COMMANDS);
-    for (const dir of commandDirs) {
-        await mkdir(dir, { recursive: true });
-        // Per-file read/compare/write runs concurrently; outcomes are applied to the
-        // Sets afterward in entry order so the summary counts are unchanged.
-        const outcomes = await Promise.all(commandEntries.map(([filename, content]) => scaffoldFile(path.join(dir, filename), renderCommandForHost(filename, content, dir === path.join(cwd, ".cursor", "commands") ? "cursor" : "claude-code"))));
-        commandEntries.forEach(([filename], i) => {
-            const outcome = outcomes[i];
-            if (outcome === "skipped") {
-                skippedFiles.add(filename);
-                return;
-            }
-            if (outcome === "overwritten")
-                overwrittenFiles.add(filename);
-            writtenFiles.add(filename);
-        });
-    }
-    // A file written in any directory takes priority over skipped
-    for (const f of writtenFiles)
-        skippedFiles.delete(f);
-    const total = Object.keys(COMMANDS).length;
-    const dirNames = commandDirs.map((d) => path.relative(cwd, d)).join(" and ");
-    console.log(`\nSlash commands: scaffolded ${total} commands into ${commandDirs.length} director${commandDirs.length === 1 ? "y" : "ies"}`);
-    if (writtenFiles.size > 0)
-        console.log(`  Written: ${writtenFiles.size}`);
-    if (overwrittenFiles.size > 0)
-        console.log(`  Overwritten (content changed): ${overwrittenFiles.size}`);
-    if (skippedFiles.size > 0)
-        console.log(`  Skipped (unchanged): ${skippedFiles.size}`);
-    console.log(`  ${dirNames}`);
-    // ---- Phase 4a: Scaffold Codex-native repository skills ----
-    // Codex skills are a project-local, commit-safe surface. They intentionally
-    // do not participate in the global Codex MCP registration at
-    // ~/.codex/config.toml; that registration is owned by install-bridge.
-    const codexAssets = codexSkillAssets(COMMANDS);
-    const codexOutcomes = await Promise.all(codexAssets.map((asset) => {
-        const target = path.join(cwd, asset.relativePath);
-        return scaffoldFile(target, asset.content, path.dirname(target));
-    }));
-    const codexWritten = codexOutcomes.filter((outcome) => outcome !== "skipped").length;
-    const codexOverwritten = codexOutcomes.filter((outcome) => outcome === "overwritten").length;
-    const codexSkipped = codexOutcomes.filter((outcome) => outcome === "skipped").length;
-    console.log(`\nCodex skills: scaffolded ${codexAssets.length} skills into ${CODEX_SKILLS_DIR}/`);
-    if (codexWritten > 0)
-        console.log(`  Written: ${codexWritten}`);
-    if (codexOverwritten > 0)
-        console.log(`  Overwritten (content changed): ${codexOverwritten}`);
-    if (codexSkipped > 0)
-        console.log(`  Skipped (unchanged): ${codexSkipped}`);
-    // ---- Phase 4a: Scaffold GitHub Copilot command artifacts ----
-    // VS Code Local agent discovers prompt files; Agent Host discovers project
-    // skills. Both artifacts are rendered from COMMANDS above, never a second
-    // Copilot-specific command catalog. Each representation reports its own
-    // counts, so a written prompt never implies its skill exists (or vice versa).
-    if (ideDetection.vscode) {
-        const promptsDir = path.join(cwd, ".github", "prompts");
-        const skillsDir = path.join(cwd, ".github", "skills");
-        const artifacts = commandEntries.map(([filename, content]) => ({
-            commandName: filename.replace(/\.md$/, ""),
-            ...translateCommandToCopilot(filename, content),
+    // ---- Phases 4–5: Catalog-owned packaged assets ----
+    const catalog = buildPackagedAssetCatalog();
+    if (catalog.packageProblems.length)
+        throw new Error("Packaged asset catalog is incomplete; rebuild or reinstall the package.");
+    const hosts = ["claude", "codex"];
+    if (ideDetection.cursor)
+        hosts.push("cursor");
+    if (ideDetection.vscode)
+        hosts.push("copilot");
+    const provisioned = catalog.assets.filter(a => a.hosts.some(h => hosts.includes(h)));
+    const successful = [];
+    let scaffoldFailed = false;
+    const categories = [
+        ["Slash commands", provisioned.filter(a => a.kind === "command")],
+        ["Codex skills", provisioned.filter(a => a.kind === "skill" && a.hosts.includes("codex"))],
+        ["VS Code Local-agent prompt files", provisioned.filter(a => a.kind === "prompt")],
+        ["Agent Host skills", provisioned.filter(a => a.kind === "skill" && a.hosts.includes("copilot"))],
+        ["Documentation", provisioned.filter(a => a.kind === "document")],
+        ["Agents", provisioned.filter(a => a.kind === "agent")],
+    ];
+    for (const [label, assets] of categories) {
+        if (!assets.length)
+            continue;
+        const outcomes = await Promise.allSettled(assets.map(async (asset) => {
+            const target = path.join(cwd, asset.destination);
+            const outcome = await scaffoldFile(target, asset.content, path.dirname(target));
+            successful.push(asset);
+            return outcome;
         }));
-        const promptOutcomes = await Promise.all(artifacts.map(({ commandName, prompt }) => scaffoldFile(path.join(promptsDir, `${commandName}.prompt.md`), prompt, promptsDir)));
-        const skillOutcomes = await Promise.all(artifacts.map(({ commandName, skill }) => scaffoldFile(path.join(skillsDir, commandName, "SKILL.md"), skill, path.join(skillsDir, commandName))));
-        const copilotReports = [
-            ["VS Code Local-agent prompt files", ".github/prompts/", promptOutcomes],
-            ["Agent Host skills", ".github/skills/", skillOutcomes],
-        ];
-        for (const [label, dir, outcomes] of copilotReports) {
-            const written = outcomes.filter((outcome) => outcome !== "skipped").length;
-            const overwritten = outcomes.filter((outcome) => outcome === "overwritten").length;
-            const skipped = outcomes.filter((outcome) => outcome === "skipped").length;
-            console.log(`\n${label}: scaffolded ${outcomes.length} into ${dir}`);
-            if (written > 0)
-                console.log(`  Written: ${written}`);
-            if (overwritten > 0)
-                console.log(`  Overwritten (content changed): ${overwritten}`);
-            if (skipped > 0)
-                console.log(`  Skipped (unchanged): ${skipped}`);
-        }
+        const completed = outcomes.flatMap(o => o.status === "fulfilled" ? [o.value] : []);
+        scaffoldFailed ||= completed.length !== assets.length;
+        const destinationLabel = assets[0]?.hosts.includes("copilot") && (assets[0].kind === "prompt" || assets[0].kind === "skill")
+            ? `into ${assets[0].destination.split("/").slice(0, 2).join("/")}/` : "assets";
+        console.log(`\n${label}: scaffolded ${completed.length} ${destinationLabel}`);
+        console.log(`  Written: ${completed.filter(o => o !== "skipped").length}`);
+        console.log(`  Overwritten (content changed): ${completed.filter(o => o === "overwritten").length}`);
+        console.log(`  Skipped (unchanged): ${completed.filter(o => o === "skipped").length}`);
     }
-    // ---- Phase 4b: Scaffold shipped documentation assets ----
-    // Every doc asset the /install-bridge capability report points a human at,
-    // so no pointer it prints dangles inside an installed project: the
-    // capability catalog (docs/mcp-tool-integrations.md) that explains each
-    // gate's human "why", and the SFCC integration guide
-    // (docs/install/sfcc-integration.md) that the report's SFCC configure_in
-    // pointer names by path. Keyed by target path RELATIVE to the consumer
-    // project root; content is never secret.
-    const docsWritten = new Set();
-    const docsSkipped = new Set();
-    const docEntries = Object.entries(DOCS);
-    // Each doc target may live in a different subdir, so mkdir(dirname) happens
-    // per-file inside scaffoldFile. Outcomes applied in entry order below preserve
-    // the insertion order of the joined summary list.
-    const docOutcomes = await Promise.all(docEntries.map(([relTarget, content]) => {
-        const target = path.join(cwd, relTarget);
-        return scaffoldFile(target, content, path.dirname(target));
-    }));
-    docEntries.forEach(([relTarget], i) => {
-        // DOCS tracks only written vs skipped; an overwrite counts as written.
-        if (docOutcomes[i] === "skipped")
-            docsSkipped.add(relTarget);
-        else
-            docsWritten.add(relTarget);
-    });
-    const docsTotal = Object.keys(DOCS).length;
-    if (docsTotal > 0) {
-        console.log(`\nDocumentation: scaffolded ${docsTotal} doc asset${docsTotal === 1 ? "" : "s"}`);
-        if (docsWritten.size > 0)
-            console.log(`  Written: ${[...docsWritten].join(", ")}`);
-        if (docsSkipped.size > 0)
-            console.log(`  Skipped (unchanged): ${[...docsSkipped].join(", ")}`);
+    try {
+        await recordProvisionedAssets(cwd, successful, hosts);
     }
-    // ---- Phase 5: Scaffold agent directories ----
-    const agentWritten = new Set();
-    const agentSkipped = new Set();
-    const agentOverwritten = new Set();
-    // Always scaffold to .claude/agents/
-    const claudeAgentsDir = path.join(cwd, ".claude", "agents");
-    await mkdir(claudeAgentsDir, { recursive: true });
-    const agentEntries = Object.entries(AGENTS);
-    // Apply a batch of ordered outcomes to the agent Sets (same branches as the
-    // original per-file loop: skipped → skipped; overwritten → overwritten+written;
-    // written → written).
-    const applyAgentOutcomes = (filenames, outcomes) => {
-        filenames.forEach((filename, i) => {
-            const outcome = outcomes[i];
-            if (outcome === "skipped") {
-                agentSkipped.add(filename);
-                return;
-            }
-            if (outcome === "overwritten")
-                agentOverwritten.add(filename);
-            agentWritten.add(filename);
-        });
-    };
-    const claudeAgentFilenames = agentEntries.map(([key]) => `${key}.md`);
-    const claudeAgentOutcomes = await Promise.all(agentEntries.map(([key, agent]) => scaffoldFile(path.join(claudeAgentsDir, `${key}.md`), reconstructAgentMarkdown(agent.frontmatter, agent.body))));
-    applyAgentOutcomes(claudeAgentFilenames, claudeAgentOutcomes);
-    // Scaffold to .github/agents/ for VS Code / Copilot
-    if (ideDetection.vscode) {
-        const copilotAgentsDir = path.join(cwd, ".github", "agents");
-        await mkdir(copilotAgentsDir, { recursive: true });
-        const copilotAgentFilenames = agentEntries.map(([key]) => `${key}.agent.md`);
-        const copilotAgentOutcomes = await Promise.all(agentEntries.map(([key, agent]) => scaffoldFile(path.join(copilotAgentsDir, `${key}.agent.md`), translateAgentToCopilot(agent.frontmatter, agent.body))));
-        applyAgentOutcomes(copilotAgentFilenames, copilotAgentOutcomes);
+    catch {
+        warn("Packaged workflow inventory could not be safely recorded; discovery will remain conservative.");
     }
-    // TODO: Add Cursor agent scaffolding when Cursor publishes a formal agent spec
-    // A file written in any directory takes priority over skipped
-    for (const f of agentWritten)
-        agentSkipped.delete(f);
-    const agentTotal = Object.keys(AGENTS).length;
-    console.log(`\nAgents: scaffolded ${agentTotal} agent${agentTotal === 1 ? "" : "s"}`);
-    if (agentWritten.size > 0)
-        console.log(`  Written: ${agentWritten.size}`);
-    if (agentOverwritten.size > 0)
-        console.log(`  Overwritten (content changed): ${agentOverwritten.size}`);
-    if (agentSkipped.size > 0)
-        console.log(`  Skipped (unchanged): ${agentSkipped.size}`);
+    if (scaffoldFailed)
+        throw new Error("Some packaged workflow assets could not be scaffolded.");
     // ---- Phase 6: Scaffold custom pipeline directories ----
     // BAPI-708: shared with `resolveInitScaffoldAssets`, so a `BAPI_PIPELINES_DIR`
     // override moves the scaffold and the commit-safe manifest in lockstep.