@noorm/marie-cli 0.1.17 → 0.1.18

package/dist/monolith/infrastructure/tools/definitions/NavigationTools.js

@@ -0,0 +1,348 @@
+import * as vscode from "vscode";
+import { getStringArg } from "../ToolUtils.js";
+import { SymbolService } from "../../../plumbing/lsp/SymbolService.js";
+import { DependencyService } from "../../../plumbing/analysis/DependencyService.js";
+import { withTimeout } from "../../../plumbing/utils/TimeoutUtils.js";
+import { writeFile } from "../../../plumbing/filesystem/FileService.js";
+import { foldCode } from "../../joy/JoyTools.js";
+import * as path from "path";
+import * as fs from "fs/promises";
+/**
+ * NavigationTools - Tools for navigating the codebase and performing semantic transformations.
+ */
+export function registerNavigationTools(registry) {
+    registry.register({
+        name: "get_symbol_definition",
+        description: "Find the definition of a symbol at the specified position. Helps navigate complex codebases.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "The absolute path to the file" },
+                line: { type: "number", description: "The line number (1-indexed)" },
+                character: {
+                    type: "number",
+                    description: "The character position (1-indexed)",
+                },
+            },
+            required: ["path", "line", "character"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const line = args.line - 1;
+            const char = args.character - 1;
+            const uri = vscode.Uri.file(p);
+            const pos = new vscode.Position(line, char);
+            return await SymbolService.getDefinitions(uri, pos);
+        },
+    });
+    registry.register({
+        name: "get_file_dependencies",
+        description: "Map the structural network of a file (imports/exports) to understand its dependencies and role.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "The absolute path to the file" },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            return await DependencyService.getFileNetwork(p);
+        },
+    });
+    registry.register({
+        name: "find_symbol_references",
+        description: "Find all references/usages of a symbol across the workspace.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the file containing the symbol",
+                },
+                line: { type: "number", description: "The line number (1-indexed)" },
+                character: {
+                    type: "number",
+                    description: "The character position (1-indexed)",
+                },
+            },
+            required: ["path", "line", "character"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const line = args.line - 1;
+            const char = args.character - 1;
+            const uri = vscode.Uri.file(p);
+            const pos = new vscode.Position(line, char);
+            const refs = await vscode.commands.executeCommand("vscode.executeReferenceProvider", uri, pos);
+            if (!refs || refs.length === 0)
+                return "No references found.";
+            let result = `Found ${refs.length} reference(s):\n`;
+            refs.slice(0, 50).forEach((r) => {
+                result += `- ${r.uri.fsPath} [L${r.range.start.line + 1}:C${r.range.start.character + 1}]\n`;
+            });
+            if (refs.length > 50)
+                result += `\n... AND ${refs.length - 50} MORE.`;
+            return result;
+        },
+    });
+    registry.register({
+        name: "list_workspace_symbols",
+        description: "Search for symbols (classes, functions, etc.) across the entire workspace.",
+        input_schema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The symbol name or partial name to search for",
+                },
+            },
+            required: ["query"],
+        },
+        execute: async (args) => {
+            const query = getStringArg(args, "query");
+            const symbols = await vscode.commands.executeCommand("vscode.executeWorkspaceSymbolProvider", query);
+            if (!symbols || symbols.length === 0)
+                return "No symbols found matching the query.";
+            let result = `Found ${symbols.length} symbol(s) matching \`${query}\`:\n`;
+            symbols.slice(0, 50).forEach((s) => {
+                const kind = vscode.SymbolKind[s.kind];
+                result += `- [${kind}] \`${s.name}\` in \`${s.location.uri.fsPath}\`\n`;
+            });
+            if (symbols.length > 50)
+                result += `\n... AND ${symbols.length - 50} MORE.`;
+            return result;
+        },
+    });
+    registry.register({
+        name: "execute_semantic_rename",
+        description: "Perform a workspace-wide, compiler-safe rename of a symbol using the LSP.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the file containing the symbol",
+                },
+                line: {
+                    type: "integer",
+                    description: "The line number of the symbol (1-indexed)",
+                },
+                column: {
+                    type: "integer",
+                    description: "The column number of the symbol (1-indexed)",
+                },
+                newName: { type: "string", description: "The new name for the symbol" },
+            },
+            required: ["path", "line", "column", "newName"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const line = args.line;
+            const col = args.column;
+            const newName = getStringArg(args, "newName");
+            const uri = vscode.Uri.file(p);
+            const pos = new vscode.Position(line - 1, col - 1);
+            try {
+                const edit = await vscode.commands.executeCommand("vscode.executeRenameProvider", uri, pos, newName);
+                if (!edit)
+                    return `LSP could not find a renameable symbol at ${p}:${line}:${col}.`;
+                const success = await vscode.workspace.applyEdit(edit);
+                if (!success)
+                    return "Failed to apply workspace-wide semantic rename.";
+                return `Successfully renamed symbol to \`${newName}\` across the entire workspace. ✨`;
+            }
+            catch (error) {
+                return `Semantic rename failed: ${error}`;
+            }
+        },
+    });
+    registry.register({
+        name: "execute_semantic_move",
+        description: "Move a symbol (function/class) to a new file and attempt to update imports throughout the workspace.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                sourcePath: {
+                    type: "string",
+                    description: "Absolute path to source file",
+                },
+                targetPath: {
+                    type: "string",
+                    description: "Absolute path to target file",
+                },
+                symbolName: {
+                    type: "string",
+                    description: "Name of the symbol to move",
+                },
+            },
+            required: ["sourcePath", "targetPath", "symbolName"],
+        },
+        execute: async (args, onProgress, signal) => {
+            const src = getStringArg(args, "sourcePath");
+            const dest = getStringArg(args, "targetPath");
+            const sym = getStringArg(args, "symbolName");
+            try {
+                const symbols = await withTimeout(vscode.commands.executeCommand("vscode.executeDocumentSymbolProvider", vscode.Uri.file(src)), 5000, "LSP Document Symbol Provider");
+                const targetSym = symbols?.find((s) => s.name === sym);
+                if (!targetSym)
+                    return `Could not find symbol \`${sym}\` in source file.`;
+                const content = await fs.readFile(src, "utf-8");
+                const lines = content.split("\n");
+                const symContent = lines
+                    .slice(targetSym.location.range.start.line, targetSym.location.range.end.line + 1)
+                    .join("\n");
+                const importLines = lines.filter((l) => l.trim().startsWith("import "));
+                const neededImports = importLines.filter((l) => {
+                    const match = l.match(/\{([^}]+)\}/);
+                    if (match) {
+                        const idents = match[1].split(",").map((i) => i.trim());
+                        return idents.some((i) => symContent.includes(i));
+                    }
+                    return false;
+                });
+                const newSrcContent = [
+                    ...lines.slice(0, targetSym.location.range.start.line),
+                    ...lines.slice(targetSym.location.range.end.line + 1),
+                ].join("\n");
+                await writeFile(src, newSrcContent, signal);
+                let destContent = "";
+                try {
+                    destContent = await fs.readFile(dest, "utf-8");
+                }
+                catch (e) {
+                    destContent = `// Created for moved symbol ${sym}\n`;
+                }
+                const finalDestContent = neededImports.join("\n") + "\n\n" + destContent + "\n\n" + symContent;
+                await writeFile(dest, finalDestContent, signal);
+                const refs = await withTimeout(vscode.commands.executeCommand("vscode.executeReferenceProvider", vscode.Uri.file(src), targetSym.location.range.start), 5000, "LSP Reference Provider");
+                const externalRefs = refs.filter((r) => r.uri.fsPath !== src && r.uri.fsPath !== dest);
+                const updatedFiles = [];
+                if (externalRefs.length > 0) {
+                    const refFiles = Array.from(new Set(externalRefs.map((r) => r.uri.fsPath)));
+                    for (const refFile of refFiles) {
+                        const refContent = await fs.readFile(refFile, "utf-8");
+                        const srcRel = path
+                            .relative(path.dirname(refFile), src)
+                            .replace(/\.[^.]+$/, "")
+                            .replace(/\\/g, "/");
+                        const destRel = path
+                            .relative(path.dirname(refFile), dest)
+                            .replace(/\.[^.]+$/, "")
+                            .replace(/\\/g, "/");
+                        const oldImportPath = srcRel.startsWith(".")
+                            ? srcRel
+                            : `./${srcRel}`;
+                        const newImportPath = destRel.startsWith(".")
+                            ? destRel
+                            : `./${destRel}`;
+                        if (refContent.includes(oldImportPath)) {
+                            const newRefContent = refContent.replace(new RegExp(`from\\s+['"]${oldImportPath}['"]`, "g"), `from '${newImportPath}'`);
+                            if (newRefContent !== refContent) {
+                                await fs.writeFile(refFile, newRefContent);
+                                updatedFiles.push(path.basename(refFile));
+                            }
+                        }
+                    }
+                }
+                await foldCode(src);
+                await foldCode(dest);
+                return (`Successfully moved \`${sym}\` to \`${dest.split("/").pop()}\`. 🗡️\n\n` +
+                    `**Methodology Complete**: Required imports were identified and copied to the destination.\n` +
+                    (updatedFiles.length > 0
+                        ? `**Downstream Migration**: Automatically updated imports in ${updatedFiles.length} file(s): ${updatedFiles.join(", ")}. ✨`
+                        : `**Mirror Polishing**: No external downstream imports required migration.`) +
+                    `\n\n**Autonomy Note**: Post-execution tidying completed for both source and destination. 🌸`);
+            }
+            catch (error) {
+                return `Semantic move failed: ${error.message}`;
+            }
+        },
+    });
+    registry.register({
+        name: "trace_data_flow",
+        description: "Analyze how a specific type or interface is used across multiple layers.",
+        input_schema: {
+            type: "object",
+            properties: {
+                typeName: {
+                    type: "string",
+                    description: "The name of the type/interface to trace",
+                },
+                filePath: {
+                    type: "string",
+                    description: "Path to the file where the type is defined",
+                },
+            },
+            required: ["typeName", "filePath"],
+        },
+        execute: async (args) => {
+            const type = getStringArg(args, "typeName");
+            const p = getStringArg(args, "filePath");
+            const uri = vscode.Uri.file(p);
+            const symbols = await vscode.commands.executeCommand("vscode.executeDocumentSymbolProvider", uri);
+            const target = symbols?.find((s) => s.name === type);
+            const pos = target?.location.range.start || new vscode.Position(0, 0);
+            const refs = await vscode.commands.executeCommand("vscode.executeReferenceProvider", uri, pos);
+            if (!refs || refs.length === 0)
+                return `Type \`${type}\` appears to be isolated. ✨`;
+            const uniqueFiles = Array.from(new Set(refs.map((r) => r.uri.fsPath)));
+            let result = `# 🔮 Data Flow Trace: \`${type}\`\n\n`;
+            result += `Found usages in **${uniqueFiles.length}** files.\n\n`;
+            const layers = uniqueFiles.map((f) => {
+                if (f.includes("/infrastructure/"))
+                    return "Infrastructure 🏛️";
+                if (f.includes("/domain/"))
+                    return "Domain 🧠";
+                if (f.includes("/plumbing/"))
+                    return "Plumbing 🔧";
+                return "UI/External 🎨";
+            });
+            const layerCounts = layers.reduce((acc, l) => {
+                acc[l] = (acc[l] || 0) + 1;
+                return acc;
+            }, {});
+            result += `## Layer Distribution\n`;
+            Object.entries(layerCounts).forEach(([layer, count]) => {
+                result += `- **${layer}**: ${count} files\n`;
+            });
+            if (layerCounts["Domain 🧠"] && layerCounts["Infrastructure 🏛️"]) {
+                result += `\n> [!NOTE]\n> This type crosses the Domain/Infrastructure boundary. Ensure strict mapping is in place to maintain Joyful purity. ✨`;
+            }
+            return result;
+        },
+    });
+    registry.register({
+        name: "find_files",
+        description: "Search for files across the workspace using a glob pattern (e.g., '**/*.test.ts').",
+        input_schema: {
+            type: "object",
+            properties: {
+                pattern: {
+                    type: "string",
+                    description: "The glob pattern to search for",
+                },
+                exclude: {
+                    type: "string",
+                    description: "Optional glob pattern for files to exclude",
+                },
+            },
+            required: ["pattern"],
+        },
+        execute: async (args) => {
+            const pattern = getStringArg(args, "pattern");
+            const exclude = args.exclude;
+            const files = await vscode.workspace.findFiles(pattern, exclude);
+            if (files.length === 0)
+                return "No files found matching the pattern.";
+            let result = `Found ${files.length} file(s) matching \`${pattern}\`:\n`;
+            files.slice(0, 50).forEach((f) => (result += `- \`${f.fsPath}\`\n`));
+            if (files.length > 50)
+                result += `\n... AND ${files.length - 50} MORE.`;
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=NavigationTools.js.map

package/dist/monolith/infrastructure/tools/definitions/NavigationTools.js.map

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

package/dist/monolith/infrastructure/tools/definitions/PlanningTools.js

@@ -0,0 +1,297 @@
+import { getStringArg, getArrayArg } from "../ToolUtils.js";
+import * as path from "path";
+import * as fs from "fs/promises";
+import { getWorkspaceRoot } from "../../../plumbing/utils/EnvironmentUtils.js";
+/**
+ * PlanningTools - Tools for strategic planning, roadmapping, and pass management.
+ */
+export function registerPlanningTools(registry) {
+    registry.register({
+        name: "perform_strategic_planning",
+        description: "A mandatory planning ritual. Call this at the start of any complex task.",
+        input_schema: {
+            type: "object",
+            properties: {
+                intent: { type: "string" },
+                joyZone: {
+                    type: "string",
+                    enum: ["joyful", "infrastructure", "plumbing"],
+                },
+                projectName: { type: "string" },
+                lifecycleStage: {
+                    type: "string",
+                    enum: ["sprout", "bloom", "compost"],
+                },
+                objectives: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string" },
+                            label: { type: "string" },
+                            status: {
+                                type: "string",
+                                enum: ["pending", "in_progress", "completed", "blocked"],
+                            },
+                        },
+                        required: ["id", "label", "status"],
+                    },
+                },
+                ritualChecked: { type: "boolean" },
+                gratitudeMoment: { type: "string" },
+                dependencyRisk: { type: "string" },
+                totalPasses: {
+                    type: "number",
+                    description: "Total number of passes (1-4)",
+                },
+                passFocus: { type: "string", description: "Initial focus of Pass 1" },
+            },
+            required: [
+                "intent",
+                "joyZone",
+                "projectName",
+                "lifecycleStage",
+                "ritualChecked",
+                "gratitudeMoment",
+                "totalPasses",
+                "passFocus",
+            ],
+        },
+        execute: async (args, onProgress) => {
+            const intent = getStringArg(args, "intent");
+            const joyZone = getStringArg(args, "joyZone");
+            const projectName = getStringArg(args, "projectName");
+            const lifecycleStage = getStringArg(args, "lifecycleStage");
+            const objectives = getArrayArg(args, "objectives");
+            const gratitude = getStringArg(args, "gratitudeMoment");
+            onProgress?.({
+                context: `Mindfulness: ${intent} [Zone: ${joyZone}]`,
+                completedObjectiveIds: [],
+                activeObjectiveId: objectives[0]?.id,
+                achieved: [
+                    `Aligned with ${joyZone} zone protocols`,
+                    `Planning for ${projectName} (${lifecycleStage})`,
+                    `Ritual: ${gratitude}`,
+                ],
+                lifecycleStage,
+                ritualComplete: true,
+                currentPass: 1,
+                totalPasses: args.totalPasses || 1,
+                passFocus: getStringArg(args, "passFocus"),
+            });
+            return `Strategic Plan for '${projectName}' accepted. The KonMari Waterfall (Domain -> Infrastructure -> Plumbing) has been aligned. ✨`;
+        },
+    });
+    registry.register({
+        name: "checkpoint_pass",
+        description: "Explicitly end a pass, summarize achievements, and orient for the next pass.",
+        input_schema: {
+            type: "object",
+            properties: {
+                summary: {
+                    type: "string",
+                    description: "What was achieved in this pass",
+                },
+                reflection: {
+                    type: "string",
+                    description: "What sparked joy or was learned in this pass? (KonMari Reflection)",
+                },
+                nextPassFocus: {
+                    type: "string",
+                    description: "The focus for the upcoming pass",
+                },
+                zoneSolidification: {
+                    type: "boolean",
+                    description: "Confirm that all new code follows JOY zoning protocols.",
+                },
+                tidyChecked: {
+                    type: "boolean",
+                    description: "Confirm that Joyful Tidying (fold_file) has been performed.",
+                },
+                isFinalPass: { type: "boolean" },
+            },
+            required: [
+                "summary",
+                "reflection",
+                "nextPassFocus",
+                "zoneSolidification",
+                "tidyChecked",
+                "isFinalPass",
+            ],
+        },
+        execute: async (args, onProgress) => {
+            const summary = getStringArg(args, "summary");
+            const reflection = getStringArg(args, "reflection");
+            const nextFocus = getStringArg(args, "nextPassFocus");
+            const solidified = args.zoneSolidification;
+            const isFinal = args.isFinalPass;
+            if (!solidified) {
+                return "Error: Zone Solidification check failed. Please ensure all new code is correctly zoned before ending the pass.";
+            }
+            if (!args.tidyChecked) {
+                return "Error: Joyful Tidying check failed. Please perform 'fold_file' on modified files to ensure code health.";
+            }
+            onProgress?.({
+                context: `Checkpoint: ${summary} (Reflection: ${reflection})`,
+                achieved: [`Completed Pass: ${summary}`],
+                passHistory: [{ pass: args.currentPass || 1, summary, reflection }],
+                currentPass: isFinal ? null : undefined,
+                passFocus: isFinal ? undefined : nextFocus,
+            });
+            return `Pass internal checkpoint reached. Focus shifting to: ${nextFocus}. Reflection: ${reflection}`;
+        },
+    });
+    registry.register({
+        name: "update_run_objectives",
+        description: "Update the current run's objectives and progress context.",
+        input_schema: {
+            type: "object",
+            properties: {
+                context: { type: "string" },
+                completedObjectiveIds: { type: "array", items: { type: "string" } },
+                activeObjectiveId: { type: "string" },
+                achieved: { type: "array", items: { type: "string" } },
+                totalPasses: { type: "number" },
+            },
+            required: ["context"],
+        },
+        execute: async (args, onProgress) => {
+            const context = getStringArg(args, "context");
+            const completedObjectiveIds = getArrayArg(args, "completedObjectiveIds");
+            const activeObjectiveId = getStringArg(args, "activeObjectiveId");
+            const achieved = getArrayArg(args, "achieved");
+            const totalPasses = args.totalPasses;
+            onProgress?.({
+                context,
+                completedObjectiveIds,
+                activeObjectiveId,
+                achieved,
+                totalPasses,
+            });
+            return `Progress updated: ${context}${totalPasses ? ` (Total Passes: ${totalPasses})` : ""}`;
+        },
+    });
+    registry.register({
+        name: "augment_roadmap",
+        description: "Insert a new pass into the current roadmap. Use this when significant unexpected complexity is discovered.",
+        input_schema: {
+            type: "object",
+            properties: {
+                addedPassCount: {
+                    type: "number",
+                    description: "How many passes to add (usually 1)",
+                },
+                newPassFocus: {
+                    type: "string",
+                    description: "The focus for the upcoming augmented pass",
+                },
+                reason: {
+                    type: "string",
+                    description: "Why is the roadmap being augmented? (Mindfulness discovery)",
+                },
+            },
+            required: ["addedPassCount", "newPassFocus", "reason"],
+        },
+        execute: async (args, onProgress) => {
+            const count = args.addedPassCount;
+            const focus = getStringArg(args, "newPassFocus");
+            const reason = getStringArg(args, "reason");
+            onProgress?.({
+                context: `Roadmap Augmented: ${reason}`,
+                achieved: [`Calibrated roadmap: +${count} pass(es)`],
+                totalPasses: count,
+                passFocus: focus,
+            });
+            return `Roadmap augmented with ${count} additional pass(es). Reason: ${reason}`;
+        },
+    });
+    registry.register({
+        name: "generate_migration_plan",
+        description: "Generate a step-by-step 'Blueprint' for migrating code from an old pattern to a new one.",
+        input_schema: {
+            type: "object",
+            properties: {
+                fromPattern: {
+                    type: "string",
+                    description: "The pattern being replaced",
+                },
+                toPattern: { type: "string", description: "The new target pattern" },
+                files: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of files to migrate",
+                },
+            },
+            required: ["fromPattern", "toPattern", "files"],
+        },
+        execute: async (args) => {
+            const files = args.files;
+            let result = `# 📐 Migration Blueprint\n\n`;
+            result += `**Trajectory**: From \`${args.fromPattern}\` to \`${args.toPattern}\`\n\n`;
+            result += `## 🗺️ Execution Steps\n`;
+            result += `1. **Analysis**: Map all instances of old pattern in ${files.length} files.\n`;
+            result += `2. **Transformation**: Apply structural replacements using \`replace_in_file\`.\n`;
+            result += `3. **Verification**: Run \`check_ripple_health\` and \`run_test_suite\`.\n\n`;
+            result += `## 🗂️ Target Garden\n`;
+            files
+                .slice(0, 10)
+                .forEach((f) => (result += `- \`${f.split("/").pop()}\`\n`));
+            if (files.length > 10)
+                result += `- ... and ${files.length - 10} more.\n`;
+            return result;
+        },
+    });
+    registry.register({
+        name: "generate_architectural_decision",
+        description: "Generate a structured ADR (Architectural Decision Record) to document a major shift in the project.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Concise title of the decision" },
+                context: {
+                    type: "string",
+                    description: "The problem or context driving this change",
+                },
+                decision: {
+                    type: "string",
+                    description: "The chosen solution and rationale",
+                },
+                consequences: {
+                    type: "string",
+                    description: "Impact on the system moving forward",
+                },
+            },
+            required: ["title", "context", "decision", "consequences"],
+        },
+        execute: async (args) => {
+            const root = getWorkspaceRoot();
+            if (!root)
+                return "No workspace detected.";
+            const id = `ADR-${Math.round(Date.now() / 1000)}`;
+            const adrDir = path.join(root, ".marie", "decisions");
+            const adrPath = path.join(adrDir, `${id}.md`);
+            const title = getStringArg(args, "title");
+            const historyContext = title.includes("Refactor")
+                ? `\n## Historical Context\n> This decision aligns with the trajectory identified in the Evolution Chronicle. ✨\n`
+                : "";
+            const adrContent = `# 🛡️ ${id}: ${title}\n\n` +
+                `**Date**: ${new Date().toLocaleDateString()}\n` +
+                `**Status**: Accepted\n\n` +
+                historyContext +
+                `## Context\n${getStringArg(args, "context")}\n\n` +
+                `## Decision\n${getStringArg(args, "decision")}\n\n` +
+                `## Consequences\n${getStringArg(args, "consequences")}\n\n` +
+                `--- \nGenerated by Marie Autonomous Agent ✨`;
+            try {
+                await fs.mkdir(adrDir, { recursive: true });
+                await fs.writeFile(adrPath, adrContent);
+                return `Architectural Decision Record saved to \`.marie/decisions/${id}.md\`. History preserved. 🛡️`;
+            }
+            catch (e) {
+                return `Failed to save ADR: ${e}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=PlanningTools.js.map