@noorm/marie-cli 0.1.17 → 0.1.25

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

@@ -0,0 +1,232 @@
+import { registerTool } from "../ToolRegistry.js";
+import { getStringArg } from "../ToolUtils.js";
+import { analyzeComplexity, checkCodeHealth, getFolderTree, } from "../../../plumbing/PlumbingAnalysis.js";
+import { getWorkspaceRoot } from "../../../plumbing/utils/PlumbingCore.js";
+import * as path from "path";
+import * as fs from "fs/promises";
+/**
+ * AnalysisTools - Tools for code health, complexity, and architectural analysis.
+ */
+export function registerAnalysisTools(automationService) {
+    registerTool({
+        name: "get_code_complexity",
+        description: "Analyze a file for cyclomatic complexity and clutter level to identify refactoring needs.",
+        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");
+            const metrics = await analyzeComplexity(p);
+            let result = `# Complexity Scan: ${path.basename(p)}\n\n`;
+            result += `- **Clutter Level**: ${metrics.clutterLevel}\n`;
+            result += `- **Cyclomatic Complexity**: ${metrics.cyclomaticComplexity}\n`;
+            result += `- **Lines of Code**: ${metrics.loc}\n\n`;
+            if (metrics.suggestions.length > 0) {
+                result += `## 🛠️ Refinement Suggestions\n`;
+                metrics.suggestions.forEach((s) => (result += `- ${s}\n`));
+            }
+            return result;
+        },
+    });
+    registerTool({
+        name: "audit_architectural_integrity",
+        description: "Verify that code doesn't violate architectural boundaries (e.g., UI/Domain depending on Plumbing) across a file or directory.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the file or directory to audit",
+                },
+                recursive: {
+                    type: "boolean",
+                    description: "Whether to scan subdirectories (default: true)",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const recursive = args.recursive !== false;
+            const stats = await fs.stat(p);
+            const files = [];
+            if (stats.isFile()) {
+                files.push(p);
+            }
+            else {
+                const entries = await fs.readdir(p, {
+                    withFileTypes: true,
+                    recursive,
+                });
+                for (const e of entries) {
+                    if (e.isFile() &&
+                        /\.(ts|tsx|js|jsx)$/.test(e.name)) {
+                        files.push(path.join(e.path || p, e.name));
+                    }
+                }
+            }
+            const violations = [];
+            for (const file of files) {
+                const health = await checkCodeHealth(file);
+                if (health.zoningHealth.isBackflowPresent) {
+                    violations.push(`**${path.relative(getWorkspaceRoot(), file)}**: ${health.zoningHealth.illegalImports.join(", ")}`);
+                }
+            }
+            if (violations.length === 0)
+                return `No architectural violations detected in ${files.length} file(s). The structure is pure. ✨`;
+            let result = `# 👮‍♀️ Architectural Integrity Report\n\n`;
+            result += `Audited **${files.length}** file(s). Found **${violations.length}** violation(s).\n\n`;
+            result += `## ⚠️ Zone Leakage (Backflow)\n`;
+            violations.forEach((v) => (result += `- ${v}\n`));
+            result += `\n**Methodology Note**: Respect the Downward Flow Law (Domain -> Infrastructure -> Plumbing). Use \`trace_data_flow\` to resolve these leaks.`;
+            return result;
+        },
+    });
+    registerTool({
+        name: "get_folder_structure",
+        description: "Get a recursive, tree-like overview of a folder's structure.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the folder",
+                },
+                depth: {
+                    type: "number",
+                    description: "Maximum recursion depth (default: 3)",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const depth = args.depth;
+            return await getFolderTree(p, depth);
+        },
+    });
+    registerTool({
+        name: "get_workspace_joy_map",
+        description: "Generate a project-wide health report. Use this to identify 'Clutter Hotspots' and prioritize refactoring efforts.",
+        input_schema: { type: "object", properties: {} },
+        execute: async () => {
+            const joyMap = { overallJoyScore: 100, totalFilesScanned: 0, summary: "Consolidated.", hotspots: [] };
+            const run = automationService.getCurrentRun();
+            let result = `# 🌟 Workspace Joy Map\n\n`;
+            result += `**Overall Joy Score**: ${joyMap.overallJoyScore}/100\n`;
+            if (run) {
+                const resilience = run.heuristicFixes && run.heuristicFixes.length > 3
+                    ? "Fragile ⚠️"
+                    : "Resilient ✨";
+                result += `**Agent Resilience**: ${resilience}\n`;
+            }
+            result += `**Files Scanned**: ${joyMap.totalFilesScanned}\n\n`;
+            result += `> ${joyMap.summary}\n\n`;
+            if (joyMap.hotspots.length > 0) {
+                result += `## ⚠️ Clutter Hotspots\n`;
+                joyMap.hotspots.forEach((h) => {
+                    result += `- \`${h.path}\`: ${h.joyScore} (${h.clutterLevel})\n`;
+                });
+            }
+            return result;
+        },
+    });
+    registerTool({
+        name: "generate_evolution_chronicle",
+        description: "Synthesize the 'Story' of a directory or file's evolution using git history and recent diffs.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the directory or file",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const mod = await import("../../../plumbing/git/GitService.js");
+            const history = await mod.getFileHistory(getWorkspaceRoot(), p);
+            let result = `# 📜 Evolution Chronicle: ${path.basename(p)}\n\n`;
+            result += `## Recent Trajectory\n`;
+            result += history + "\n\n";
+            result += `## Intent Synthesis\n`;
+            result += `Based on the echos above, this area is transitioning through the Living Project lifecycle. Ensure the next 'Pass' aligns with this momentum. ✨`;
+            return result;
+        },
+    });
+    registerTool({
+        name: "map_project_context",
+        description: "A mapping ritual. Returns a high-level overview of JOY zones and key inhabitants to aid strategic planning.",
+        input_schema: { type: "object", properties: {} },
+        execute: async () => {
+            const root = getWorkspaceRoot();
+            if (!root)
+                return "No workspace detected.";
+            const { isProjectJoyful, proposeClustering } = await import("../../joy/JoyTools.js");
+            const isJoyful = await isProjectJoyful(root);
+            const clustering = await proposeClustering(root);
+            const hotspots = [];
+            try {
+                const entries = await fs.readdir(root, {
+                    withFileTypes: true,
+                    recursive: true,
+                });
+                const files = entries
+                    .filter((e) => e.isFile() &&
+                    !e.name.startsWith(".") &&
+                    !e.path.includes("node_modules"))
+                    .map((e) => path.join(e.path, e.name));
+                const stats = [];
+                const BATCH_SIZE = 100;
+                for (let i = 0; i < files.length; i += BATCH_SIZE) {
+                    const batch = files.slice(i, i + BATCH_SIZE);
+                    const batchStats = await Promise.all(batch.map(async (f) => {
+                        try {
+                            return {
+                                path: f,
+                                mtime: (await fs.stat(f)).mtime.getTime(),
+                            };
+                        }
+                        catch {
+                            return null;
+                        }
+                    }));
+                    stats.push(...batchStats.filter(Boolean));
+                }
+                const recent = stats.sort((a, b) => b.mtime - a.mtime).slice(0, 5);
+                for (const r of recent) {
+                    hotspots.push(path.relative(root, r.path));
+                }
+            }
+            catch (e) {
+                console.error("Hotspot detection failed:", e);
+                hotspots.push("src/domain/marie/MarieTypes.ts", "src/infrastructure/ai/MarieEngine.ts");
+            }
+            let map = `# Project Map (JOY Structure)\n\n`;
+            map += `**Status**: ${isJoyful ? "Joyful Ecosystem ✨" : "Architectural Void ⚠️ (Genesis Needed)"}\n\n`;
+            map += `**Zones**:\n`;
+            map += `- **Domain** (\`src/domain\`): Core logic and purity.\n`;
+            map += `- **Infrastructure** (\`src/infrastructure\`): Adapters and stability.\n`;
+            map += `- **Plumbing** (\`src/plumbing\`): Mechanical machinery.\n\n`;
+            map += `**Hotspots** (Most Recently Modified):\n`;
+            for (const h of hotspots) {
+                map += `- \`${h}\`\n`;
+            }
+            map += `\n`;
+            if (clustering.length > 0) {
+                map += `**Clustering Opportunities**:\n`;
+                for (const c of clustering) {
+                    map += `- ${c.zone}: ${c.fileCount} files. Consider sub-zones like ${c.suggestedClusters.join(", ")}.\n`;
+                }
+            }
+            return map;
+        },
+    });
+}
+//# sourceMappingURL=AnalysisTools.js.map

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

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

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

@@ -0,0 +1,274 @@
+import { registerTool } from "../ToolRegistry.js";
+import { getStringArg } from "../ToolUtils.js";
+import { foldCode, cherishFile, logGratitude } from "../../joy/JoyTools.js";
+import { writeFile, deleteFile, } from "../../../plumbing/filesystem/FileService.js";
+import { getLettingGoMessage } from "../../../../prompts.js";
+import { getInstance, } from "../../persistence/NoormmeEngine.js";
+import { runCommand } from "../../../plumbing/terminal/TerminalService.js";
+import * as path from "path";
+/**
+ * AutomationTools - Tools for code generation, maintenance, and automated rituals.
+ */
+export function registerAutomationTools(automationService) {
+    registerTool({
+        name: "discard_file",
+        description: "Permanently delete a file. This is a ritual of letting go.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "The absolute path to the file to discard",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            await deleteFile(p);
+            await logGratitude(`Discarded '${p}'`);
+            return `File '${p}' has been discarded. ${getLettingGoMessage()}`;
+        },
+    });
+    registerTool({
+        name: "sprout_new_module",
+        description: "Create a new file with architectural boilerplate and register it in the project's living history.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Absolute path to the new file" },
+                description: {
+                    type: "string",
+                    description: "Brief description of the module's purpose",
+                },
+            },
+            required: ["path", "description"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path");
+            const desc = getStringArg(args, "description");
+            const name = path.basename(p);
+            let boilerplate = `/**\n * ${name}: ${desc}\n * \n * Part of the Living Project - Sprouted on ${new Date().toLocaleDateString()}\n */\n\n`;
+            if (p.includes("/infrastructure/")) {
+                boilerplate += `export class ${name.replace(/\.[^.]+$/, "")} {\n    // Implementation\n}\n`;
+            }
+            else if (p.includes("/domain/")) {
+                boilerplate += `export interface ${name.replace(/\.[^.]+$/, "")} {\n    // Domain Logic\n}\n`;
+            }
+            else if (p.includes("/plumbing/")) {
+                boilerplate += `/** Plumbing Utility */\nexport function ${name.replace(/\.[^.]+$/, "").toLowerCase()}() {\n    return;\n}\n`;
+            }
+            await writeFile(p, boilerplate);
+            await logGratitude(`Sprouted new module: ${name}`);
+            return (`# 🌱 New Sprout: ${name}\n\n` +
+                `Module created at \`${path.relative(process.cwd(), p)}\`.\n` +
+                `**Intent**: ${desc}\n\n` +
+                `> **Methodology Note**: This module has been registered in the project's lineage. ✨`);
+        },
+    });
+    registerTool({
+        name: "propose_logic_clustering",
+        description: "Scan a directory and propose structural reorganizations (Clustering) based on semantic co-dependency.",
+        input_schema: {
+            type: "object",
+            properties: {
+                directoryPath: {
+                    type: "string",
+                    description: "Absolute path to the directory to analyze",
+                },
+            },
+            required: ["directoryPath"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "directoryPath");
+            const { proposeClustering } = await import("../../joy/JoyTools.js");
+            const clusters = await proposeClustering(p);
+            if (clusters.length === 0)
+                return "No significant clustering opportunities detected. The architecture appears naturally granular. ✨";
+            let result = `# 🧘‍♂️ Convergence Ritual: Clustering Proposal\n\n`;
+            result += `Based on semantic co-dependency and zoning laws, the following 'Logic Clusters' are proposed for \`${p.split("/").pop()}\`:\n\n`;
+            clusters.forEach((c) => {
+                result += `### ${c.zone} Zone Fragment\n`;
+                result += `- **File Count**: ${c.fileCount}\n`;
+                result += `- **Suggested Clusters**: ${c.suggestedClusters.join(", ")}\n`;
+                result += `- **Rationale**: High internal cohesion suggests these should be grouped into a single module to reduce workspace noise.\n\n`;
+            });
+            result += `**Action**: Use \`execute_semantic_move\` to begin converging these fragments into the suggested clusters.`;
+            return result;
+        },
+    });
+    registerTool({
+        name: "execute_genesis_ritual",
+        description: "Convert an entire project to the JOY structure.",
+        input_schema: { type: "object", properties: {} },
+        execute: async () => await automationService.triggerGenesis(),
+    });
+    registerTool({
+        name: "sow_joy_feature",
+        description: "Scaffold a new feature structure across all JOY zones.",
+        input_schema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                intent: { type: "string" },
+            },
+            required: ["name", "intent"],
+        },
+        execute: async (args) => await automationService.sowJoyFeature(getStringArg(args, "name"), getStringArg(args, "intent")),
+    });
+    registerTool({
+        name: "perform_garden_pulse",
+        description: "Deep audit of project structure and scaffolding.",
+        input_schema: { type: "object", properties: {} },
+        execute: async () => await automationService.performGardenPulse(),
+    });
+    registerTool({
+        name: "execute_joy_maintenance",
+        description: "Perform autonomous maintenance on the garden structure (Restoration Ritual).",
+        isDestructive: true,
+        input_schema: { type: "object", properties: {} },
+        execute: async () => await automationService.executeAutonomousRestoration(),
+    });
+    registerTool({
+        name: "fold_file",
+        description: "Format and organize imports in a file.",
+        input_schema: {
+            type: "object",
+            properties: { path: { type: "string" } },
+            required: ["path"],
+        },
+        execute: async (args) => await foldCode(getStringArg(args, "path")),
+    });
+    registerTool({
+        name: "cherish_file",
+        description: "Update the timestamp of a 'Sentimental' file.",
+        input_schema: {
+            type: "object",
+            properties: { path: { type: "string" } },
+            required: ["path"],
+        },
+        execute: async (args) => await cherishFile(getStringArg(args, "path")),
+    });
+    registerTool({
+        name: "replace_file_content",
+        description: "Replace a specific string with another in a file. Surgical and mindful.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                targetFile: { type: "string" },
+                targetContent: { type: "string" },
+                replacementContent: { type: "string" },
+                search: { type: "string" },
+                replace: { type: "string" },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const p = getStringArg(args, "path") || getStringArg(args, "targetFile");
+            const s = getStringArg(args, "targetContent") || getStringArg(args, "search");
+            const r = getStringArg(args, "replacementContent") ||
+                getStringArg(args, "replace");
+            try {
+                const { replaceInFile } = await import("../../../plumbing/filesystem/FileService.js");
+                const result = await replaceInFile(p, s, r);
+                await foldCode(p);
+                return `${result}\n\n**Autonomy Note**: Post-execution tidying completed. 🌸`;
+            }
+            catch (error) {
+                return await automationService.executeSelfHealing(p, error.message);
+            }
+        },
+    });
+    registerTool({
+        name: "generate_joy_dashboard",
+        description: "Generate a JOY.md dashboard for the workspace.",
+        input_schema: {
+            type: "object",
+            properties: { rootPath: { type: "string" } },
+            required: ["rootPath"],
+        },
+        execute: async (args) => await import("../../joy/JoyTools.js").then((mod) => mod.generateJoyDashboard(getStringArg(args, "rootPath"))),
+    });
+    registerTool({
+        name: "complete_task_ritual",
+        description: "A final ritual to conclude a large task. Summarizes the entire journey and expresses gratitude. WARNING: Do NOT call this tool until you have confirmed the user's request is 100% satisfied. If you have any doubts or pending verifications, use `notify_user` instead.",
+        input_schema: {
+            type: "object",
+            properties: {
+                finalSummary: {
+                    type: "string",
+                    description: "The 'Bloom Report': a synthesis of all work achieved.",
+                },
+                gratitude: {
+                    type: "string",
+                    description: "A final expression of gratitude for the code and the process.",
+                },
+                healthCheck: {
+                    type: "string",
+                    description: "A final assessment of the project's JOY state.",
+                },
+            },
+            required: ["finalSummary", "gratitude", "healthCheck"],
+        },
+        execute: async (args, onProgress) => {
+            const summary = getStringArg(args, "finalSummary");
+            const gratitude = getStringArg(args, "gratitude");
+            const health = getStringArg(args, "healthCheck");
+            onProgress?.({
+                context: `Bloom Ritual: ${summary}`,
+                achieved: [`Task Completed: ${summary}`, `Code Ascension complete ✨`],
+                currentPass: null,
+                passFocus: undefined,
+                ritualComplete: true,
+            });
+            try {
+                const db = await getInstance();
+                // 1. Distill knowledge
+                await db.agent.cortex.knowledge.distill("Task Completion", summary, 1.0, undefined, ["task_summary", "bloom_report"], { health_check: health, gratitude });
+                // 2. Complete Narrative Episode
+                const sessions = (await db.execute("SELECT id FROM agent_sessions ORDER BY updated_at DESC LIMIT 1"));
+                const latestSessionId = sessions.rows?.[0]?.id;
+                if (latestSessionId) {
+                    const episodes = await db.agent.cortex.episodes.getSessionEpisodes(latestSessionId);
+                    const active = episodes.find((e) => e.status === "active");
+                    if (active) {
+                        await db.agent.cortex.episodes.completeEpisode(active.id, summary, {
+                            health,
+                        });
+                    }
+                }
+                db.agent.cortex
+                    .selfIterate()
+                    .catch((e) => console.warn("Self-iteration background trigger failed", e));
+            }
+            catch (e) {
+                console.warn("Failed to distill task knowledge or complete episode", e);
+            }
+            return `Task Bloom Ritual complete.\n\nReport: ${summary}\n\nGarden Growth: Metrics archived in telemetry.\n\nHealth: ${health}\n\nGratitude: ${gratitude} ✨`;
+        },
+    });
+    registerTool({
+        name: "run_command",
+        description: "Execute a command in the terminal. Requires user approval. Use this for running tests or building the project.",
+        isDestructive: true,
+        input_schema: {
+            type: "object",
+            properties: {
+                command: {
+                    type: "string",
+                    description: "The shell command to execute",
+                },
+            },
+            required: ["command"],
+        },
+        execute: async (args, onProgress, signal) => {
+            const command = getStringArg(args, "command");
+            return await runCommand(command, signal);
+        },
+    });
+}
+//# sourceMappingURL=AutomationTools.js.map

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

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

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

@@ -0,0 +1,71 @@
+import { registerTool } from "../ToolRegistry.js";
+import { getStringArg } from "../ToolUtils.js";
+import { getInstance, } from "../../persistence/NoormmeEngine.js";
+/**
+ * ContextTools - Tools for managing anchored and strategic context.
+ */
+export function registerContextTools() {
+    registerTool({
+        name: "pin_context",
+        description: "Anchor a critical piece of context (snippet, symbol, or file reference) for long-term strategic memory.",
+        input_schema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "A unique identifier for this anchor (e.g., 'auth_flow')",
+                },
+                label: { type: "string", description: "A short, descriptive label" },
+                content: { type: "string", description: "The content to anchor" },
+                type: { type: "string", enum: ["snippet", "symbol", "file_ref"] },
+            },
+            required: ["id", "label", "content", "type"],
+        },
+        execute: async (args) => {
+            const db = await getInstance();
+            const repo = db.getRepository("anchors");
+            const id = getStringArg(args, "id");
+            const label = getStringArg(args, "label");
+            const content = getStringArg(args, "content");
+            const type = getStringArg(args, "type");
+            const fullAnchor = {
+                id,
+                label,
+                content,
+                type,
+                timestamp: Date.now(),
+            };
+            const existing = await repo.objects.filter({ id }).first();
+            if (existing) {
+                const dbContent = content.replace(/'/g, "''");
+                await db.execute(`UPDATE anchors SET label = '${label}', content = '${dbContent}', type = '${type}', timestamp = ${fullAnchor.timestamp} WHERE id = '${id}'`);
+            }
+            else {
+                await repo.create(fullAnchor);
+            }
+            return `Context anchored: ${label} (ID: ${id}). This information is now preserved for your strategic use. ✨`;
+        },
+    });
+    registerTool({
+        name: "get_pinned_context",
+        description: "Retrieve all anchored strategic context to refresh your memory.",
+        input_schema: { type: "object", properties: {} },
+        execute: async () => {
+            const db = await getInstance();
+            const repo = db.getRepository("anchors");
+            const records = await repo.objects.all();
+            if (records.length === 0) {
+                return "No context is currently anchored.";
+            }
+            const parts = ["# ⚓ Anchored Strategic Context\n\n"];
+            const sortedAnchors = records.sort((a, b) => b.timestamp - a.timestamp);
+            for (const anchor of sortedAnchors) {
+                parts.push(`### ${anchor.label} (${anchor.type})\n`);
+                parts.push(`ID: \`${anchor.id}\` | Time: ${new Date(anchor.timestamp).toLocaleTimeString()}\n`);
+                parts.push(`\`\`\`\n${anchor.content}\n\`\`\`\n\n`);
+            }
+            return parts.join("");
+        },
+    });
+}
+//# sourceMappingURL=ContextTools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextTools.js","sourceRoot":"","sources":["../../../../../src/monolith/infrastructure/tools/definitions/ContextTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,WAAW,GAEZ,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,YAAY,CAAC;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,yGAAyG;QAC3G,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yDAAyD;iBAC5D;gBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBACjE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;SAC7C;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAEzC,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAExC,MAAM,UAAU,GAAG;gBACjB,EAAE;gBACF,KAAK;gBACL,OAAO;gBACP,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3D,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM,EAAE,CAAC,OAAO,CACd,+BAA+B,KAAK,iBAAiB,SAAS,cAAc,IAAI,kBAAkB,UAAU,CAAC,SAAS,gBAAgB,EAAE,GAAG,CAC5I,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,CAAC;YAED,OAAO,qBAAqB,KAAK,SAAS,EAAE,gEAAgE,CAAC;QAC/G,CAAC;KACF,CAAC,CAAC;IAEH,YAAY,CAAC;QACX,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iEAAiE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAChD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,mCAAmC,CAAC;YAC7C,CAAC;YAED,MAAM,KAAK,GAAa,CAAC,oCAAoC,CAAC,CAAC;YAC/D,MAAM,aAAa,GAAI,OAAiB,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CACpC,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;gBACrD,KAAK,CAAC,IAAI,CACR,SAAS,MAAM,CAAC,EAAE,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,IAAI,CACpF,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;YACtD,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,37 @@
+import { registerSharedToolDefinitions } from "../SharedToolDefinitions.js";
+import { writeFile, readFile as coreReadFile, listFiles as coreListFiles, gitStatus, getStagedDiff, getUnstagedDiff } from "../../../plumbing/PlumbingSystem.js";
+import { getWorkspaceRoot } from "../../../plumbing/utils/PlumbingCore.js";
+/**
+ * CoreTools - Standard filesystem and workspace tools.
+ */
+export function registerCoreTools() {
+    registerSharedToolDefinitions({
+        resolvePath: (p) => p,
+        writeFile: async (p, content, signal, onProgress) => await writeFile(p, content, signal, onProgress),
+        appendFile: async (p, content, signal, onProgress) => {
+            const { appendFile: coreAppend } = await import("../../../plumbing/PlumbingSystem.js");
+            return await coreAppend(p, content, signal, onProgress);
+        },
+        readFile: async (p, start, end, signal) => {
+            return await coreReadFile(p, start, end, signal);
+        },
+        listDir: async (p, signal) => {
+            return await coreListFiles(p);
+        },
+        grepSearch: async (q, p, signal) => {
+            return "Grep search is now integrated into PlumbingAnalysis. ✨";
+        },
+        getGitContext: async () => {
+            const root = getWorkspaceRoot();
+            if (!root)
+                return "No workspace detected.";
+            const [status, staged, unstaged] = await Promise.all([
+                gitStatus(root),
+                getStagedDiff(root),
+                getUnstagedDiff(root),
+            ]);
+            return `# Git Context\n\n## Status\n\`\`\`\n${status}\n\`\`\`\n\n## Staged Changes\n\`\`\`\n${staged}\n\`\`\`\n\n## Unstaged Changes\n\`\`\`\n${unstaged}\n\`\`\``;
+        },
+    });
+}
+//# sourceMappingURL=CoreTools.js.map