@4da/mcp-server 3.2.0 → 4.1.0

package/dist/tools/decision-memory.js

@@ -0,0 +1,345 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
+/**
+ * decision_memory tool
+ *
+ * Manage developer decisions - record, list, check alignment, update, and supersede.
+ * Decisions persist and inform signal classification, tech radar, and agent context.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const decisionMemoryTool = {
+    name: "decision_memory",
+    description: "Manage developer decisions. Actions: record (create new decision), list (query decisions), check_alignment (check if tech/pattern conflicts with decisions), update (modify a decision), supersede (replace old decision with new one).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["record", "list", "check_alignment", "update", "supersede"],
+                description: "Action to perform",
+            },
+            decision_type: {
+                type: "string",
+                enum: [
+                    "tech_choice",
+                    "architecture",
+                    "workflow",
+                    "pattern",
+                    "dependency",
+                ],
+                description: "Type of decision (for record)",
+            },
+            subject: {
+                type: "string",
+                description: "Subject of the decision (for record, check_alignment)",
+            },
+            decision: {
+                type: "string",
+                description: "The decision text (for record)",
+            },
+            rationale: {
+                type: "string",
+                description: "Why this decision was made (for record)",
+            },
+            alternatives_rejected: {
+                type: "array",
+                items: { type: "string" },
+                description: "Alternatives that were considered and rejected (for record)",
+            },
+            context_tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Tags for categorization (for record)",
+            },
+            confidence: {
+                type: "number",
+                description: "Confidence level 0-1 (for record)",
+            },
+            filter_type: {
+                type: "string",
+                description: "Filter by decision type (for list)",
+            },
+            filter_status: {
+                type: "string",
+                description: "Filter by status: active, superseded, reconsidering (for list)",
+            },
+            limit: {
+                type: "number",
+                description: "Max results to return (for list)",
+            },
+            technology: {
+                type: "string",
+                description: "Technology to check alignment for",
+            },
+            pattern: {
+                type: "string",
+                description: "Pattern to check alignment for",
+            },
+            id: {
+                type: "number",
+                description: "Decision ID (for update)",
+            },
+            new_decision: {
+                type: "string",
+                description: "Updated decision text (for update)",
+            },
+            new_rationale: {
+                type: "string",
+                description: "Updated rationale (for update)",
+            },
+            new_status: {
+                type: "string",
+                enum: ["active", "superseded", "reconsidering"],
+                description: "Updated status (for update)",
+            },
+            new_confidence: {
+                type: "number",
+                description: "Updated confidence (for update)",
+            },
+            old_id: {
+                type: "number",
+                description: "ID of decision to supersede (for supersede)",
+            },
+            new_id: {
+                type: "number",
+                description: "ID of new decision that replaces old (for supersede)",
+            },
+        },
+        required: ["action"],
+    },
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+function parseDecisionRow(row) {
+    return {
+        ...row,
+        alternatives_rejected: JSON.parse(row.alternatives_rejected || "[]"),
+        context_tags: JSON.parse(row.context_tags || "[]"),
+    };
+}
+// ============================================================================
+// Execute
+// ============================================================================
+export function executeDecisionMemory(db, params) {
+    const rawDb = db.getRawDb();
+    switch (params.action) {
+        case "record": {
+            if (!params.subject || !params.decision) {
+                return {
+                    error: "subject and decision are required for record action",
+                };
+            }
+            const stmt = rawDb.prepare(`INSERT INTO developer_decisions
+           (decision_type, subject, decision, rationale,
+            alternatives_rejected, context_tags, confidence, status)
+         VALUES (?, ?, ?, ?, ?, ?, ?, 'active')`);
+            const result = stmt.run(params.decision_type || "tech_choice", params.subject, params.decision, params.rationale || null, JSON.stringify(params.alternatives_rejected || []), JSON.stringify(params.context_tags || []), params.confidence ?? 0.8);
+            // Bridge to AWE Wisdom Graph: forward decision for wisdom tracking.
+            // Non-blocking — AWE sync is best-effort, doesn't affect 4DA recording.
+            try {
+                const aweBin = findAweBinary();
+                if (aweBin) {
+                    // Sanitize inputs before passing to external process
+                    const safeSubject = (params.subject || "").slice(0, 500).replace(/\0/g, '');
+                    const safeDecision = (params.decision || "").slice(0, 2000).replace(/\0/g, '');
+                    const query = `${safeSubject}: ${safeDecision}`;
+                    const domain = mapDecisionTypeToDomain(params.decision_type || "tech_choice");
+                    // AWE bridge: persist decisions to Wisdom Graph for compounding
+                    // Context file auto-assembled by AWE MCP server's buildContextFile()
+                    const contextFile = process.platform === "win32"
+                        ? `${process.env.APPDATA || ""}\\awe\\identity.json`
+                        : `${process.env.HOME || ""}/.local/share/awe/identity.json`;
+                    const contextArgs = existsSync(contextFile) ? ["--context_file", contextFile] : [];
+                    const child = execFile(aweBin, [
+                        "transmute", query,
+                        "--domain", domain,
+                        "--json",
+                        ...contextArgs,
+                    ], { timeout: 30_000 }, () => {
+                        // Callback required — ignore result (fire-and-forget)
+                    });
+                    child.unref();
+                }
+            }
+            catch {
+                // AWE bridge is optional
+            }
+            return {
+                success: true,
+                id: result.lastInsertRowid,
+                message: `Decision recorded: ${params.subject}`,
+            };
+        }
+        case "list": {
+            let sql = `SELECT id, decision_type, subject, decision, rationale,
+                        alternatives_rejected, context_tags, confidence,
+                        status, superseded_by, created_at, updated_at
+                 FROM developer_decisions WHERE 1=1`;
+            const sqlParams = [];
+            if (params.filter_type) {
+                sql += ` AND decision_type = ?`;
+                sqlParams.push(params.filter_type);
+            }
+            if (params.filter_status) {
+                sql += ` AND status = ?`;
+                sqlParams.push(params.filter_status);
+            }
+            sql += ` ORDER BY updated_at DESC LIMIT ?`;
+            sqlParams.push(params.limit || 20);
+            const rows = rawDb
+                .prepare(sql)
+                .all(...sqlParams);
+            return {
+                decisions: rows.map(parseDecisionRow),
+                count: rows.length,
+            };
+        }
+        case "check_alignment": {
+            if (!params.technology) {
+                return {
+                    error: "technology is required for check_alignment action",
+                };
+            }
+            const search = `%${params.technology.toLowerCase()}%`;
+            const rows = rawDb
+                .prepare(`SELECT id, decision_type, subject, decision, rationale,
+                  alternatives_rejected, context_tags, confidence,
+                  status, created_at
+           FROM developer_decisions
+           WHERE status = 'active'
+             AND (LOWER(subject) LIKE ?
+               OR LOWER(context_tags) LIKE ?
+               OR LOWER(alternatives_rejected) LIKE ?)`)
+                .all(search, search, search);
+            const conflicts = [];
+            const relevant = [];
+            for (const row of rows) {
+                const alts = JSON.parse(row.alternatives_rejected || "[]");
+                const isRejected = alts.some((alt) => alt.toLowerCase().includes(params.technology.toLowerCase()));
+                if (isRejected) {
+                    conflicts.push({
+                        decision_id: row.id,
+                        subject: row.subject,
+                        reason: `'${params.technology}' was rejected in favor of '${row.decision}' (rationale: ${row.rationale || "none"})`,
+                    });
+                }
+                relevant.push(parseDecisionRow(row));
+            }
+            return {
+                aligned: conflicts.length === 0,
+                relevant_decisions: relevant,
+                conflicts,
+                confidence: relevant.length > 0
+                    ? Math.max(...relevant.map((r) => r.confidence))
+                    : 0.5,
+            };
+        }
+        case "update": {
+            if (!params.id) {
+                return { error: "id is required for update action" };
+            }
+            const sets = [];
+            const values = [];
+            if (params.new_decision) {
+                sets.push("decision = ?");
+                values.push(params.new_decision);
+            }
+            if (params.new_rationale) {
+                sets.push("rationale = ?");
+                values.push(params.new_rationale);
+            }
+            if (params.new_status) {
+                sets.push("status = ?");
+                values.push(params.new_status);
+            }
+            if (params.new_confidence !== undefined) {
+                sets.push("confidence = ?");
+                values.push(params.new_confidence);
+            }
+            if (sets.length === 0) {
+                return { error: "No fields to update" };
+            }
+            sets.push("updated_at = datetime('now')");
+            values.push(params.id);
+            rawDb
+                .prepare(`UPDATE developer_decisions SET ${sets.join(", ")} WHERE id = ?`)
+                .run(...values);
+            return {
+                success: true,
+                message: `Decision ${params.id} updated`,
+            };
+        }
+        case "supersede": {
+            if (!params.old_id || !params.new_id) {
+                return {
+                    error: "old_id and new_id are required for supersede action",
+                };
+            }
+            rawDb
+                .prepare(`UPDATE developer_decisions
+           SET status = 'superseded',
+               superseded_by = ?,
+               updated_at = datetime('now')
+           WHERE id = ?`)
+                .run(params.new_id, params.old_id);
+            return {
+                success: true,
+                message: `Decision ${params.old_id} superseded by ${params.new_id}`,
+            };
+        }
+        default:
+            return { error: `Unknown action: ${params.action}` };
+    }
+}
+// ============================================================================
+// AWE Bridge Helpers
+// ============================================================================
+/** Map 4DA decision types to AWE domains. */
+function mapDecisionTypeToDomain(type) {
+    switch (type) {
+        case "architecture":
+        case "pattern":
+            return "software-engineering";
+        case "dependency":
+            return "software-engineering";
+        case "workflow":
+            return "workflow";
+        default:
+            return "software-engineering";
+    }
+}
+/** Find AWE binary — checks env var, platform defaults, then PATH fallback. */
+export function findAweBinary() {
+    // 1. Explicit env var takes priority
+    const envPath = process.env.FOURDA_AWE_PATH || process.env.AWE_BIN;
+    if (envPath && existsSync(envPath))
+        return envPath;
+    // 2. Platform-specific default install locations
+    const home = homedir();
+    const os = platform();
+    const candidates = [];
+    if (os === "win32") {
+        const appData = process.env.APPDATA || join(home, "AppData", "Roaming");
+        candidates.push(join(appData, "awe", "awe.exe"));
+    }
+    else if (os === "darwin") {
+        candidates.push(join(home, "Library", "Application Support", "awe", "awe"));
+    }
+    else {
+        // Linux and other Unix
+        candidates.push(join(home, ".local", "share", "awe", "awe"));
+    }
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    // 3. Fall back to bare command name (relies on PATH)
+    return "awe";
+}
+//# sourceMappingURL=decision-memory.js.map

package/dist/tools/decision-memory.js.map

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

package/dist/tools/decision-windows.d.ts

@@ -0,0 +1,37 @@
+/**
+ * decision_windows tool
+ *
+ * View and manage decision windows — time-bounded opportunities
+ * detected from content intelligence requiring attention.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface DecisionWindowsParams {
+    action?: string;
+    window_id?: number;
+    outcome?: string;
+}
+export declare const decisionWindowsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            window_id: {
+                type: string;
+                description: string;
+            };
+            outcome: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare function executeDecisionWindows(db: FourDADatabase, params: DecisionWindowsParams): object;
+//# sourceMappingURL=decision-windows.d.ts.map

package/dist/tools/decision-windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-windows.d.ts","sourceRoot":"","sources":["../../src/tools/decision-windows.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAuB/B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA8ChG"}

package/dist/tools/decision-windows.js

@@ -0,0 +1,67 @@
+export const decisionWindowsTool = {
+    name: "decision_windows",
+    description: "View and manage decision windows — time-bounded opportunities detected from content intelligence. List open windows, mark as acted on, or close.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["list", "act", "close"],
+                description: "Action to perform. Default: list",
+                default: "list",
+            },
+            window_id: {
+                type: "number",
+                description: "Window ID (required for 'act' or 'close' actions)",
+            },
+            outcome: {
+                type: "string",
+                description: "Outcome description when acting on a window",
+            },
+        },
+    },
+};
+export function executeDecisionWindows(db, params) {
+    const rawDb = db.getRawDb();
+    const action = params.action ?? "list";
+    if (action === "act") {
+        if (!params.window_id)
+            return { error: "window_id is required for 'act' action" };
+        try {
+            rawDb.prepare(`UPDATE decision_windows SET status = 'acted', acted_at = datetime('now'), outcome = ? WHERE id = ?`).run(params.outcome ?? null, params.window_id);
+        }
+        catch (err) {
+            return { error: `Failed to act on window: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+    else if (action === "close") {
+        if (!params.window_id)
+            return { error: "window_id is required for 'close' action" };
+        try {
+            rawDb.prepare(`UPDATE decision_windows SET status = 'closed', closed_at = datetime('now') WHERE id = ?`).run(params.window_id);
+        }
+        catch (err) {
+            return { error: `Failed to close window: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+    // Always return open windows after any action
+    let openWindows = [];
+    try {
+        openWindows = rawDb.prepare(`SELECT id, title, description, urgency, source_item_id, status,
+              opens_at, closes_at, acted_at, closed_at, outcome, created_at
+       FROM decision_windows WHERE status = 'open'
+       ORDER BY urgency DESC, created_at DESC`).all();
+    }
+    catch { /* Table may not exist yet */ }
+    const actionMsg = action === "act" ? `Window ${params.window_id} marked as acted`
+        : action === "close" ? `Window ${params.window_id} closed` : null;
+    return {
+        ...(actionMsg ? { action_result: actionMsg } : {}),
+        open_windows: openWindows,
+        count: openWindows.length,
+        summary: openWindows.length === 0
+            ? "No open decision windows. The system will surface time-sensitive opportunities as they are detected."
+            : `${openWindows.length} open decision window${openWindows.length !== 1 ? "s" : ""} requiring attention`,
+    };
+}
+//# sourceMappingURL=decision-windows.js.map

package/dist/tools/decision-windows.js.map

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

package/dist/tools/delegation-score.d.ts

@@ -0,0 +1,34 @@
+/**
+ * delegation_score tool
+ *
+ * AI-delegatability assessment. AI agents use this to self-assess:
+ * "Should I proceed autonomously or ask the human?"
+ *
+ * Computes a composite score from pattern stability, security sensitivity,
+ * decision density, and AI track record to produce a delegation recommendation.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface DelegationScoreParams {
+    subject: string;
+    task_description?: string;
+}
+export declare const delegationScoreTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            subject: {
+                type: string;
+                description: string;
+            };
+            task_description: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeDelegationScore(db: FourDADatabase, params: DelegationScoreParams): object;
+//# sourceMappingURL=delegation-score.d.ts.map

package/dist/tools/delegation-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-score.d.ts","sourceRoot":"","sources":["../../src/tools/delegation-score.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkCD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AAiLF,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAgFR"}