@kamkom/awb-mcp 0.0.2 → 0.0.3

package/AGENTS.md

@@ -0,0 +1,3 @@
+# Agents
+
+This repo uses agentic workflows. Prefer repo scripts, write tests, and avoid destructive commands.

package/README.md

@@ -0,0 +1,72 @@
+# AWB MCP
+
+AWB MCP Server — bootstrap agentic-ready repos via the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP). Use it from VS Code, Cursor, or any MCP-capable client over stdio.
+
+## Install
+
+- **Global install** (recommended for VS Code/Cursor):
+  ```bash
+  npm i -g @kamkom/awb-mcp
+  ```
+  The `awb-mcp` command will be on your PATH.
+
+- **Run with npx** (no install):
+  ```bash
+  npx @kamkom/awb-mcp
+  ```
+
+**Requirements:** Node.js 18 or later (see `engines` in `package.json`).
+
+## VS Code / Cursor MCP config
+
+Add the server to your MCP settings with **only the command** — no env vars or args required for basic use.
+
+Example (e.g. in Cursor: **Settings → MCP**, or in `settings.json` under `mcpServers`):
+
+```json
+{
+  "mcpServers": {
+    "awb-mcp": {
+      "command": "awb-mcp"
+    }
+  }
+}
+```
+
+If you use `npx` instead of a global install:
+
+```json
+{
+  "mcpServers": {
+    "awb-mcp": {
+      "command": "npx",
+      "args": ["@kamkom/awb-mcp"]
+    }
+  }
+}
+```
+
+## Platforms
+
+- **Windows and macOS** are the primary supported platforms.
+- **Linux** is supported on a best-effort basis for v0.1; we do not guarantee fixing Linux-only issues in this milestone.
+
+## Tools
+
+The server exposes AWB tools over stdio, including:
+
+- `awb_plan_bootstrap` — compute a plan of file operations (create/update/skip) for bootstrapping an agentic-ready repo.
+- `awb_apply_bootstrap` — apply a previously returned plan to disk (atomic writes, idempotent behavior).
+
+## Development
+
+```bash
+npm install
+npm run build    # compile and chmod +x dist/server.js
+npm run start    # run with tsx: npx tsx src/server.ts
+npm run dev      # watch mode
+```
+
+## License
+
+ISC

package/dist/server.js

@@ -2,6 +2,7 @@
 import process from "node:process";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerAwbTools } from "./tools/index.js";
 process.on("uncaughtException", (err) => {
     console.error("[awb-mcp] uncaughtException:", err?.message ?? err);
     process.exitCode = 1;
@@ -17,11 +18,7 @@ const server = new McpServer({
     version: "0.0.1",
     description: "AWB MCP Server — bootstrap agentic-ready repos via MCP",
 });
-server.registerTool("hello", {
-    description: "Returns a hello world message",
-}, async () => ({
-    content: [{ type: "text", text: "Hello, World!" }],
-}));
+registerAwbTools(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IACnE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,wDAAwD;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;IAC3B,WAAW,EAAE,+BAA+B;CAC7C,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;CACnD,CAAC,CAAC,CAAC;AAEJ,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IACnE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,wDAAwD;CACtE,CAAC,CAAC;AAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/templates/.github/agents/architect.agent.md

@@ -0,0 +1,3 @@
+# Architect agent
+
+Focus on design and structure. Don't guess; prefer repo conventions and existing patterns.

package/dist/templates/.github/agents/implementer.agent.md

@@ -0,0 +1,3 @@
+# Implementer agent
+
+Implement changes per spec. Use repo scripts; write tests; avoid destructive commands.

package/dist/templates/.github/agents/reviewer.agent.md

@@ -0,0 +1,3 @@
+# Reviewer agent
+
+Review for correctness and safety. Prefer repo scripts and tests; flag destructive or risky changes.

package/dist/templates/.github/copilot-instructions.md

@@ -0,0 +1,3 @@
+# Copilot instructions
+
+Use repo scripts when available. Prefer existing test commands. Avoid destructive operations.

package/dist/templates/.github/instructions/general.instructions.md

@@ -0,0 +1,3 @@
+# General instructions
+
+Don't guess; prefer repo scripts and documented behavior. Write tests when changing behavior.

package/dist/templates/.github/instructions/testing.instructions.md

@@ -0,0 +1,3 @@
+# Testing instructions
+
+Prefer the project's test runner and existing test commands. Avoid destructive commands.

package/dist/templates/.github/prompts/change-summary.prompt.md

@@ -0,0 +1,3 @@
+# Change summary prompt
+
+Use this prompt to summarize changes. Be concise and reference actual edits.

package/dist/templates/.github/prompts/onboarding.prompt.md

@@ -0,0 +1,3 @@
+# Onboarding prompt
+
+Use this prompt for onboarding new contributors. Reference repo scripts and docs.

package/dist/templates/.github/prompts/readme.prompt.md

@@ -0,0 +1,3 @@
+# README prompt
+
+Use this prompt to generate or update README content. Prefer repo conventions.

package/dist/templates/AGENTS.md

@@ -0,0 +1,3 @@
+# Agents
+
+This repo uses agentic workflows. Prefer repo scripts, write tests, and avoid destructive commands.

package/dist/tools/applyBootstrap.d.ts

@@ -0,0 +1,28 @@
+export type ApplyBootstrapApplyOptions = {
+    dryRun?: boolean;
+    writeMode?: "atomic";
+    failOnConflict?: boolean;
+};
+export type ApplyBootstrapArgs = {
+    rootPath: string;
+    planId?: string;
+    operations?: unknown[];
+    applyOptions?: unknown;
+};
+export type ApplyBootstrapResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export type ApplyResultItem = {
+    path: string;
+    status: "WRITTEN" | "SKIPPED" | "FAILED";
+    details?: string;
+};
+export type ApplyBootstrapSuccess = {
+    results: ApplyResultItem[];
+};
+export declare function handleApplyBootstrap(args: ApplyBootstrapArgs): Promise<ApplyBootstrapResult>;
+//# sourceMappingURL=applyBootstrap.d.ts.map

package/dist/tools/applyBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyBootstrap.d.ts","sourceRoot":"","sources":["../../src/tools/applyBootstrap.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AA8CF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA4H/B"}

package/dist/tools/applyBootstrap.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { validateRootPath } from "./validateRootPath.js";
+const applyOptionsSchema = z.object({
+    dryRun: z.boolean().default(false),
+    writeMode: z.enum(["atomic"]).default("atomic"),
+    failOnConflict: z.boolean().default(true),
+});
+const operationSchema = z.object({
+    path: z.string(),
+    action: z.enum(["CREATE", "UPDATE_MANAGED", "SKIP"]),
+    content: z.string().optional(),
+    reason: z.string().optional(),
+    warnings: z.array(z.string()).default([]),
+});
+function parseApplyOptions(options) {
+    const parsed = applyOptionsSchema.safeParse(options ?? {});
+    if (!parsed.success) {
+        return { dryRun: false, writeMode: "atomic", failOnConflict: true };
+    }
+    return parsed.data;
+}
+function isUnderRoot(fullPath, resolvedRoot) {
+    const normalized = path.resolve(fullPath);
+    const root = path.resolve(resolvedRoot);
+    return normalized === root || normalized.startsWith(root + path.sep);
+}
+function parseOperation(raw) {
+    const parsed = operationSchema.safeParse(raw);
+    if (!parsed.success) {
+        const pathStr = typeof raw?.path === "string" ? raw.path : "<unknown>";
+        return { ok: false, path: pathStr, error: "Invalid operation shape." };
+    }
+    return {
+        ok: true,
+        op: {
+            path: parsed.data.path,
+            action: parsed.data.action,
+            content: parsed.data.content,
+            reason: parsed.data.reason,
+            warnings: parsed.data.warnings,
+        },
+    };
+}
+function atomicWrite(fullPath, content) {
+    const dir = path.dirname(fullPath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmpPath = fullPath + ".tmp";
+    fs.writeFileSync(tmpPath, content, "utf8");
+    fs.renameSync(tmpPath, fullPath);
+}
+export async function handleApplyBootstrap(args) {
+    try {
+        const error = validateRootPath(args?.rootPath);
+        if (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+                isError: true,
+            };
+        }
+        const rootPath = args.rootPath;
+        const resolvedRoot = path.resolve(rootPath);
+        const rawOperations = Array.isArray(args?.operations) ? args.operations : [];
+        if (rawOperations.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No operations to apply. Call plan_bootstrap first and pass the returned operations array to apply_bootstrap.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const applyOptions = parseApplyOptions(args?.applyOptions);
+        const results = [];
+        for (let i = 0; i < rawOperations.length; i++) {
+            const raw = rawOperations[i];
+            const parsed = parseOperation(raw);
+            if (!parsed.ok) {
+                if (applyOptions.failOnConflict) {
+                    results.push({
+                        path: parsed.path,
+                        status: "FAILED",
+                        details: parsed.error,
+                    });
+                }
+                continue;
+            }
+            const op = parsed.op;
+            const fullPath = path.resolve(resolvedRoot, path.normalize(op.path));
+            if (!isUnderRoot(fullPath, resolvedRoot)) {
+                if (applyOptions.failOnConflict) {
+                    results.push({
+                        path: op.path,
+                        status: "FAILED",
+                        details: "Path is outside repository root.",
+                    });
+                }
+                continue;
+            }
+            if (op.action === "SKIP") {
+                results.push({
+                    path: op.path,
+                    status: "SKIPPED",
+                    details: op.reason ?? "Skipped.",
+                });
+                continue;
+            }
+            // CREATE or UPDATE_MANAGED
+            if (op.action === "CREATE" || op.action === "UPDATE_MANAGED") {
+                const content = op.content;
+                if (content === undefined || typeof content !== "string") {
+                    if (applyOptions.failOnConflict) {
+                        results.push({
+                            path: op.path,
+                            status: "FAILED",
+                            details: "Missing or invalid content for CREATE/UPDATE_MANAGED.",
+                        });
+                    }
+                    continue;
+                }
+                if (applyOptions.dryRun) {
+                    results.push({
+                        path: op.path,
+                        status: "WRITTEN",
+                        details: "Would write (dry run).",
+                    });
+                    continue;
+                }
+                try {
+                    atomicWrite(fullPath, content);
+                    results.push({
+                        path: op.path,
+                        status: "WRITTEN",
+                        details: undefined,
+                    });
+                }
+                catch (err) {
+                    results.push({
+                        path: op.path,
+                        status: "FAILED",
+                        details: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        const success = { results };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(success, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=applyBootstrap.js.map

package/dist/tools/applyBootstrap.js.map

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

package/dist/tools/baseline.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Baseline scaffold paths and AWB managed-block detection.
+ * Paths are relative to repo root. See Story 5 for the full baseline tree.
+ */
+export declare const BASELINE_PATHS: readonly string[];
+/**
+ * Returns true if content contains both AWB managed block markers (managed).
+ * Malformed or partial (e.g. only start marker) is treated as unmanaged.
+ */
+export declare function hasAwbManagedBlock(content: string): boolean;
+//# sourceMappingURL=baseline.d.ts.map

package/dist/tools/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../src/tools/baseline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAWlC,CAAC;AAMX;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/tools/baseline.js

@@ -0,0 +1,27 @@
+/**
+ * Baseline scaffold paths and AWB managed-block detection.
+ * Paths are relative to repo root. See Story 5 for the full baseline tree.
+ */
+export const BASELINE_PATHS = [
+    ".github/copilot-instructions.md",
+    ".github/instructions/general.instructions.md",
+    ".github/instructions/testing.instructions.md",
+    ".github/prompts/readme.prompt.md",
+    ".github/prompts/onboarding.prompt.md",
+    ".github/prompts/change-summary.prompt.md",
+    ".github/agents/architect.agent.md",
+    ".github/agents/implementer.agent.md",
+    ".github/agents/reviewer.agent.md",
+    "AGENTS.md",
+];
+/** AWB managed block markers (both must be present for file to be considered managed). */
+const AWB_MANAGED_BEGIN = "<!-- AWB MANAGED BEGIN -->";
+const AWB_MANAGED_END = "<!-- AWB MANAGED END -->";
+/**
+ * Returns true if content contains both AWB managed block markers (managed).
+ * Malformed or partial (e.g. only start marker) is treated as unmanaged.
+ */
+export function hasAwbManagedBlock(content) {
+    return (content.includes(AWB_MANAGED_BEGIN) && content.includes(AWB_MANAGED_END));
+}
+//# sourceMappingURL=baseline.js.map

package/dist/tools/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../src/tools/baseline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,iCAAiC;IACjC,8CAA8C;IAC9C,8CAA8C;IAC9C,kCAAkC;IAClC,sCAAsC;IACtC,0CAA0C;IAC1C,mCAAmC;IACnC,qCAAqC;IACrC,kCAAkC;IAClC,WAAW;CACH,CAAC;AAEX,0FAA0F;AAC1F,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AACvD,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CACzE,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAwbTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6CxD"}

package/dist/tools/index.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { handlePlanBootstrap } from "./planBootstrap.js";
+import { handleApplyBootstrap } from "./applyBootstrap.js";
+export function registerAwbTools(server) {
+    server.registerTool("awb_plan_bootstrap", {
+        description: "Compute a deterministic plan of file operations (create/update/skip) for bootstrapping an agentic-ready repo.",
+        inputSchema: {
+            rootPath: z.string().describe("Repository root directory path"),
+            options: z
+                .object({
+                mode: z.enum(["static", "prompt"]).optional(),
+                includeReadmeProposal: z.boolean().optional(),
+                overwritePolicy: z
+                    .enum(["skip", "managed-only", "overwrite"])
+                    .optional(),
+                files: z.array(z.string()).optional(),
+            })
+                .optional()
+                .describe("Optional: mode, includeReadmeProposal, overwritePolicy, files allowlist"),
+        },
+    }, async (args) => handlePlanBootstrap(args));
+    server.registerTool("awb_apply_bootstrap", {
+        description: "Apply a previously returned bootstrap plan to disk (atomic writes, idempotent behavior). Requires the operations array from a prior plan_bootstrap call.",
+        inputSchema: {
+            rootPath: z.string().describe("Repository root directory path"),
+            planId: z.string().optional().describe("Plan ID from plan_bootstrap"),
+            operations: z.array(z.unknown()).optional().describe("Operations to apply"),
+            applyOptions: z
+                .object({
+                dryRun: z.boolean().optional(),
+                writeMode: z.enum(["atomic"]).optional(),
+                failOnConflict: z.boolean().optional(),
+            })
+                .optional()
+                .describe("Optional: dryRun, writeMode (atomic), failOnConflict"),
+        },
+    }, async (args) => handleApplyBootstrap(args));
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAA0B,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAA2B,MAAM,qBAAqB,CAAC;AAEpF,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,+GAA+G;QACjH,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC/D,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC;gBACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC7C,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;gBAC7C,eAAe,EAAE,CAAC;qBACf,IAAI,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;qBAC3C,QAAQ,EAAE;gBACb,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aACtC,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;SACvF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAyB,CAAC,CAC/D,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,0JAA0J;QAC5J,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YACrE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC3E,YAAY,EAAE,CAAC;iBACZ,MAAM,CAAC;gBACN,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;gBAC9B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACxC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aACvC,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAA0B,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/tools/loadTemplates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns template content for a baseline relative path (e.g. ".github/copilot-instructions.md").
+ * Uses forward slashes in path; normalizes for the current platform.
+ */
+export declare function getTemplateContent(relativePath: string): string;
+//# sourceMappingURL=loadTemplates.d.ts.map

package/dist/tools/loadTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTemplates.d.ts","sourceRoot":"","sources":["../../src/tools/loadTemplates.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO/D"}

package/dist/tools/loadTemplates.js

@@ -0,0 +1,29 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+let templatesDir = null;
+/**
+ * Resolves the templates directory (dist/templates when built).
+ * Expects templates to be copied to dist/templates by the build.
+ */
+function getTemplatesDir() {
+    if (templatesDir === null) {
+        const dir = path.dirname(fileURLToPath(import.meta.url));
+        templatesDir = path.join(dir, "..", "templates");
+    }
+    return templatesDir;
+}
+/**
+ * Returns template content for a baseline relative path (e.g. ".github/copilot-instructions.md").
+ * Uses forward slashes in path; normalizes for the current platform.
+ */
+export function getTemplateContent(relativePath) {
+    const fullPath = path.join(getTemplatesDir(), relativePath);
+    try {
+        return fs.readFileSync(fullPath, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=loadTemplates.js.map

package/dist/tools/loadTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTemplates.js","sourceRoot":"","sources":["../../src/tools/loadTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;;GAGG;AACH,SAAS,eAAe;IACtB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/planBootstrap.d.ts

@@ -0,0 +1,33 @@
+export type PlanBootstrapOptions = {
+    mode: "static" | "prompt";
+    includeReadmeProposal: boolean;
+    overwritePolicy: "skip" | "managed-only" | "overwrite";
+    files?: string[];
+};
+export type PlanBootstrapArgs = {
+    rootPath: string;
+    options?: unknown;
+};
+export type BootstrapAction = "CREATE" | "UPDATE_MANAGED" | "SKIP";
+export type PlanOperation = {
+    path: string;
+    action: BootstrapAction;
+    content?: string;
+    reason?: string;
+    warnings: string[];
+};
+export type PlanBootstrapResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export type PlanBootstrapSuccess = {
+    planId: string;
+    operations: PlanOperation[];
+    repoHints?: Record<string, unknown>;
+    readmeProposal?: string | null;
+};
+export declare function handlePlanBootstrap(args: PlanBootstrapArgs): Promise<PlanBootstrapResult>;
+//# sourceMappingURL=planBootstrap.d.ts.map

package/dist/tools/planBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planBootstrap.d.ts","sourceRoot":"","sources":["../../src/tools/planBootstrap.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AA8GF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAsD9B"}