@agent-loom/loom 1.0.0

package/dist/renderers/claude.js

@@ -0,0 +1,180 @@
+/**
+ * Claude Code Renderer
+ *
+ * Generates Claude Code workspace configuration files from a ResolvedManifest:
+ *   CLAUDE.md                    — combined instructions
+ *   .claude/settings.json        — MCP servers + settings
+ *   .claude/agents/<name>.md     — subagents (plain markdown)
+ *   .mcp.json                    — project-level MCP config
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Render a resolved manifest into Claude Code workspace configuration files.
+ */
+export async function renderClaude(manifest, outputDir) {
+    await Promise.all([
+        renderClaudeMd(manifest.instructions, manifest.repos, outputDir),
+        renderSettings(manifest.mcp, outputDir),
+        renderMcpJson(manifest.mcp, outputDir),
+        renderAgents(manifest.agents, outputDir),
+        renderPrompts(manifest.prompts, outputDir),
+    ]);
+}
+// ---------------------------------------------------------------------------
+// CLAUDE.md
+// ---------------------------------------------------------------------------
+async function renderClaudeMd(instructions, repos, outputDir) {
+    const hasInstructions = instructions.length > 0;
+    const hasRepos = repos.length > 0;
+    if (!hasInstructions && !hasRepos)
+        return;
+    const sections = [];
+    // Global instructions first
+    const globals = instructions.filter((i) => i.scope === 'global');
+    for (const instr of globals) {
+        sections.push(instr.content);
+    }
+    // Scoped instructions with a scope header
+    const scoped = instructions.filter((i) => i.scope !== 'global');
+    for (const instr of scoped) {
+        sections.push(`<!-- scope: ${instr.scope} -->\n${instr.content}`);
+    }
+    // Repos section
+    if (hasRepos) {
+        sections.push(buildReposSection(repos));
+    }
+    await mkdir(outputDir, { recursive: true });
+    await writeFile(join(outputDir, 'CLAUDE.md'), sections.join('\n\n'), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// .claude/settings.json
+// ---------------------------------------------------------------------------
+async function renderSettings(servers, outputDir) {
+    if (servers.length === 0)
+        return;
+    const claudeDir = join(outputDir, '.claude');
+    await mkdir(claudeDir, { recursive: true });
+    const mcpServers = {};
+    for (const server of servers) {
+        const entry = { type: server.type };
+        if (server.type === 'stdio') {
+            if (server.command)
+                entry.command = server.command;
+            if (server.args && server.args.length > 0)
+                entry.args = server.args;
+            if (server.env && Object.keys(server.env).length > 0)
+                entry.env = server.env;
+        }
+        else if (server.type === 'http' || server.type === 'sse') {
+            if (server.url)
+                entry.url = server.url;
+        }
+        mcpServers[server.id] = entry;
+    }
+    const settings = { mcpServers };
+    await writeFile(join(claudeDir, 'settings.json'), JSON.stringify(settings, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// .mcp.json (project-level)
+// ---------------------------------------------------------------------------
+async function renderMcpJson(servers, outputDir) {
+    if (servers.length === 0)
+        return;
+    const mcpServers = {};
+    for (const server of servers) {
+        const entry = { type: server.type };
+        if (server.type === 'stdio') {
+            if (server.command)
+                entry.command = server.command;
+            if (server.args && server.args.length > 0)
+                entry.args = server.args;
+            if (server.env && Object.keys(server.env).length > 0)
+                entry.env = server.env;
+        }
+        else if (server.type === 'http' || server.type === 'sse') {
+            if (server.url)
+                entry.url = server.url;
+        }
+        mcpServers[server.id] = entry;
+    }
+    await mkdir(outputDir, { recursive: true });
+    await writeFile(join(outputDir, '.mcp.json'), JSON.stringify({ mcpServers }, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Agents
+// ---------------------------------------------------------------------------
+async function renderAgents(agents, outputDir) {
+    if (agents.length === 0)
+        return;
+    const agentDir = join(outputDir, '.claude', 'agents');
+    await mkdir(agentDir, { recursive: true });
+    for (const agent of agents) {
+        // Claude agents are plain markdown — no frontmatter required
+        await writeFile(join(agentDir, `${agent.name}.md`), agent.content, 'utf-8');
+    }
+}
+// ---------------------------------------------------------------------------
+// Prompts → .claude/skills/<name>/SKILL.md
+// ---------------------------------------------------------------------------
+async function renderPrompts(prompts, outputDir) {
+    // Filter out shared prompts — they are referenced by other prompts, not standalone
+    const standalone = prompts.filter((p) => !p.shared);
+    if (standalone.length === 0)
+        return;
+    for (const prompt of standalone) {
+        const skillDir = join(outputDir, '.claude', 'skills', prompt.name);
+        await mkdir(skillDir, { recursive: true });
+        // Build Claude SKILL.md with converted frontmatter
+        const content = buildClaudeSkillMd(prompt);
+        await writeFile(join(skillDir, 'SKILL.md'), content, 'utf-8');
+    }
+}
+/**
+ * Convert a ResolvedPrompt to Claude SKILL.md format.
+ * Transforms Copilot frontmatter fields to Claude equivalents.
+ */
+function buildClaudeSkillMd(prompt) {
+    const lines = ['---'];
+    lines.push(`name: ${prompt.name}`);
+    if (prompt.description) {
+        lines.push(`description: ${prompt.description}`);
+    }
+    if (prompt.disableAutoInvoke) {
+        lines.push('disable-model-invocation: true');
+    }
+    if (prompt.tools && prompt.tools.length > 0) {
+        lines.push('allowed-tools:');
+        for (const tool of prompt.tools) {
+            lines.push(`  - ${tool}`);
+        }
+    }
+    if (prompt.model) {
+        lines.push(`model: ${prompt.model}`);
+    }
+    lines.push('---');
+    lines.push('');
+    // Strip original frontmatter from content and append body
+    const body = prompt.content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n*/, '').trim();
+    lines.push(body);
+    return lines.join('\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Repos section builder
+// ---------------------------------------------------------------------------
+function buildReposSection(repos) {
+    const lines = ['## Related Repositories', ''];
+    for (const repo of repos) {
+        const repoName = repo.name ?? repo.url.replace(/\.git$/, '').split('/').slice(-2).join('/');
+        const desc = repo.description ? ` — ${repo.description}` : '';
+        if (repo.large) {
+            const note = repo.note ? ` (${repo.note})` : '';
+            lines.push(`- ⚠️ [${repoName}](${repo.url}) — LARGE${desc}${note}`);
+        }
+        else {
+            lines.push(`- [${repoName}](${repo.url})${desc}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=claude.js.map

package/dist/renderers/claude.js.map

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

package/dist/renderers/copilot.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copilot Renderer
+ *
+ * Generates GitHub Copilot workspace configuration files from a ResolvedManifest:
+ *   .github/copilot-instructions.md   — global instructions
+ *   .github/instructions/*.instructions.md — scoped instructions (applyTo)
+ *   .github/agents/*.agent.md         — custom agents with frontmatter
+ *   .github/skills/<name>/SKILL.md    — local skills
+ *   .vscode/mcp.json                  — MCP server definitions
+ */
+import type { ResolvedManifest } from '../types.js';
+/**
+ * Render a resolved manifest into Copilot workspace configuration files.
+ */
+export declare function renderCopilot(manifest: ResolvedManifest, outputDir: string): Promise<void>;
+//# sourceMappingURL=copilot.d.ts.map

package/dist/renderers/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../src/renderers/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAOjB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhG"}

package/dist/renderers/copilot.js

@@ -0,0 +1,191 @@
+/**
+ * Copilot Renderer
+ *
+ * Generates GitHub Copilot workspace configuration files from a ResolvedManifest:
+ *   .github/copilot-instructions.md   — global instructions
+ *   .github/instructions/*.instructions.md — scoped instructions (applyTo)
+ *   .github/agents/*.agent.md         — custom agents with frontmatter
+ *   .github/skills/<name>/SKILL.md    — local skills
+ *   .vscode/mcp.json                  — MCP server definitions
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, basename, dirname, extname } from 'node:path';
+/**
+ * Render a resolved manifest into Copilot workspace configuration files.
+ */
+export async function renderCopilot(manifest, outputDir) {
+    const githubDir = join(outputDir, '.github');
+    await mkdir(githubDir, { recursive: true });
+    await Promise.all([
+        renderInstructions(manifest.instructions, manifest.repos, githubDir),
+        renderAgents(manifest.agents, githubDir),
+        renderMcp(manifest.mcp, outputDir),
+        renderSkills(manifest.skills, githubDir),
+        renderPrompts(manifest.prompts, githubDir),
+    ]);
+}
+// ---------------------------------------------------------------------------
+// Instructions
+// ---------------------------------------------------------------------------
+async function renderInstructions(instructions, repos, githubDir) {
+    const globals = instructions.filter((i) => i.scope === 'global');
+    const scoped = instructions.filter((i) => i.scope !== 'global');
+    // Global instructions → .github/copilot-instructions.md
+    const hasGlobals = globals.length > 0;
+    const hasRepos = repos.length > 0;
+    if (hasGlobals || hasRepos) {
+        const sections = [];
+        if (hasGlobals) {
+            sections.push(globals.map((i) => i.content).join('\n\n'));
+        }
+        if (hasRepos) {
+            sections.push(buildReposSection(repos));
+        }
+        await writeFile(join(githubDir, 'copilot-instructions.md'), sections.join('\n\n'), 'utf-8');
+    }
+    // Scoped instructions → .github/instructions/<name>.instructions.md
+    if (scoped.length > 0) {
+        const instrDir = join(githubDir, 'instructions');
+        await mkdir(instrDir, { recursive: true });
+        for (const instr of scoped) {
+            const name = deriveInstructionName(instr.sourcePath);
+            const frontmatter = `---\napplyTo: '${instr.scope}'\n---\n`;
+            const content = frontmatter + instr.content;
+            await writeFile(join(instrDir, `${name}.instructions.md`), content, 'utf-8');
+        }
+    }
+}
+/**
+ * Derive instruction filename from source path.
+ * e.g. "kusto.md" → "kusto", "instructions/dotnet.md" → "dotnet"
+ */
+function deriveInstructionName(sourcePath) {
+    const base = basename(sourcePath, extname(sourcePath));
+    return base.replace(/\.instructions$/, '');
+}
+// ---------------------------------------------------------------------------
+// Agents
+// ---------------------------------------------------------------------------
+async function renderAgents(agents, githubDir) {
+    if (agents.length === 0)
+        return;
+    const agentDir = join(githubDir, 'agents');
+    await mkdir(agentDir, { recursive: true });
+    for (const agent of agents) {
+        const slug = slugify(agent.name);
+        const frontmatter = buildAgentFrontmatter(agent);
+        const content = `${frontmatter}${agent.content}`;
+        await writeFile(join(agentDir, `${slug}.agent.md`), content, 'utf-8');
+    }
+}
+function buildAgentFrontmatter(agent) {
+    const lines = ['---'];
+    lines.push(`name: ${agent.name}`);
+    if (agent.description) {
+        lines.push(`description: ${agent.description}`);
+    }
+    if (agent.model) {
+        lines.push(`model: ${agent.model}`);
+    }
+    if (agent.tools.length > 0) {
+        lines.push('tools:');
+        for (const tool of agent.tools) {
+            lines.push(`  - ${tool}`);
+        }
+    }
+    lines.push('---');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Convert "Live Site" → "live-site" for filename.
+ */
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+// ---------------------------------------------------------------------------
+// MCP
+// ---------------------------------------------------------------------------
+async function renderMcp(servers, outputDir) {
+    if (servers.length === 0)
+        return;
+    const vscodeDir = join(outputDir, '.vscode');
+    await mkdir(vscodeDir, { recursive: true });
+    const mcpConfig = { servers: {} };
+    for (const server of servers) {
+        const entry = { type: server.type };
+        if (server.type === 'stdio') {
+            if (server.command)
+                entry.command = server.command;
+            if (server.args && server.args.length > 0)
+                entry.args = server.args;
+            if (server.env && Object.keys(server.env).length > 0)
+                entry.env = server.env;
+        }
+        else if (server.type === 'http' || server.type === 'sse') {
+            if (server.url)
+                entry.url = server.url;
+        }
+        mcpConfig.servers[server.id] = entry;
+    }
+    await writeFile(join(vscodeDir, 'mcp.json'), JSON.stringify(mcpConfig, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Skills
+// ---------------------------------------------------------------------------
+async function renderSkills(skills, githubDir) {
+    const localSkills = skills.filter((s) => s.type === 'local' && s.content);
+    if (localSkills.length === 0)
+        return;
+    const skillsDir = join(githubDir, 'skills');
+    for (const skill of localSkills) {
+        const name = skill.name ?? 'unnamed-skill';
+        const dir = join(skillsDir, name);
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, 'SKILL.md'), skill.content, 'utf-8');
+        if (skill.extraFiles) {
+            for (const extra of skill.extraFiles) {
+                const extraPath = join(dir, extra.relativePath);
+                await mkdir(dirname(extraPath), { recursive: true });
+                await writeFile(extraPath, extra.content, 'utf-8');
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Prompts
+// ---------------------------------------------------------------------------
+async function renderPrompts(prompts, githubDir) {
+    if (prompts.length === 0)
+        return;
+    const promptsDir = join(githubDir, 'prompts');
+    await mkdir(promptsDir, { recursive: true });
+    for (const prompt of prompts) {
+        const filename = `${prompt.name}.prompt.md`;
+        // Write the original content as-is (Copilot format)
+        await writeFile(join(promptsDir, filename), prompt.content, 'utf-8');
+    }
+}
+// ---------------------------------------------------------------------------
+// Repos section builder (shared)
+// ---------------------------------------------------------------------------
+function buildReposSection(repos) {
+    const lines = ['## Related Repositories', ''];
+    for (const repo of repos) {
+        // Extract repo name from URL
+        const repoName = repo.name ?? repo.url.replace(/\.git$/, '').split('/').slice(-2).join('/');
+        const desc = repo.description ? ` — ${repo.description}` : '';
+        if (repo.large) {
+            const note = repo.note ? `: ${repo.note}` : '';
+            lines.push(`- ⚠️ [${repoName}](${repo.url}) — LARGE${desc}${note ? ` (${repo.note})` : ''}`);
+        }
+        else {
+            lines.push(`- [${repoName}](${repo.url})${desc}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=copilot.js.map

package/dist/renderers/copilot.js.map

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

package/dist/repo-clone.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Repo Clone — Clones manifest repos into the workspace directory.
+ *
+ * Handles different repo types with appropriate strategies:
+ * - Normal GitHub repos → `gh repo clone` (parallel, up to concurrency limit)
+ * - ADO repos → `git clone` (interactive prompt, sequential)
+ * - Large repos → prompt user (clone / provide existing path / defer to agent)
+ * - Sparse repos → `git clone --filter=blob:none --sparse` + sparse-checkout
+ * - Skip strategy → skip with message
+ *
+ * Normal repos are cloned in parallel (default 4 concurrent).
+ * Large/ADO repos that require user interaction are processed sequentially.
+ * Directory junctions are only created when a user provides an external path
+ * for a large/ADO repo — not for repos cloned directly into the workspace.
+ */
+import type { ResolvedRepo } from './types.js';
+export interface CloneRepoOptions {
+    /** Resolved repos from the template manifest */
+    repos: ResolvedRepo[];
+    /** Workspace directory where repos will be cloned */
+    workspaceDir: string;
+    /** Clone mode:
+     *  - 'auto': clone non-large, prompt for large
+     *  - 'all': clone everything without prompting
+     *  - 'none': skip all (dry-run / list only)
+     */
+    mode: 'auto' | 'all' | 'none';
+    /** Maximum concurrent clone operations (default: 4) */
+    concurrency?: number;
+    /** Inject exec function for testing. Supports sync or async.
+     *  Default: async exec via child_process.exec */
+    execFn?: (cmd: string) => void | Promise<void>;
+    /** Prompt function for interactive decisions (large/ADO repos).
+     *  Returns user choice: 'clone', 'skip', or a filesystem path to an existing clone.
+     */
+    promptFn?: (message: string, choices: string[]) => Promise<string>;
+    /** Inject link function for creating directory junctions/symlinks.
+     *  Called with (target, linkPath). Only used for external-path junctions.
+     */
+    linkFn?: (target: string, linkPath: string) => Promise<void>;
+}
+export interface CloneRepoResult {
+    /** Repos that were successfully cloned or linked */
+    cloned: Array<{
+        repo: ResolvedRepo;
+        path: string;
+        linkPath?: string;
+    }>;
+    /** Repos that were skipped (already exist, cloneStrategy:skip, mode:none) */
+    skipped: Array<{
+        repo: ResolvedRepo;
+        reason: string;
+    }>;
+    /** Repos deferred to the agent (large repo with no promptFn, user chose skip, etc.) */
+    deferred: Array<{
+        repo: ResolvedRepo;
+        reason: string;
+    }>;
+}
+/**
+ * Derive a directory name from a repo URL (or override with id/name).
+ */
+export declare function deriveRepoDir(url: string, id?: string): string;
+/**
+ * Clone all manifest repos into the workspace directory.
+ *
+ * Phase 1: Categorize repos (skip, auto-clone, interactive).
+ * Phase 2: Clone auto-clone repos in parallel (batched by concurrency limit).
+ * Phase 3: Process interactive repos sequentially (user prompts).
+ */
+export declare function cloneManifestRepos(options: CloneRepoOptions): Promise<CloneRepoResult>;
+//# sourceMappingURL=repo-clone.d.ts.map

package/dist/repo-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-clone.d.ts","sourceRoot":"","sources":["../src/repo-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;qDACiD;IACjD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,6EAA6E;IAC7E,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,uFAAuF;IACvF,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9D;AAoBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4F5F"}