siclaw 0.1.0 → 0.1.2

package/dist/tools/deep-search/types.d.ts

@@ -31,6 +31,8 @@ export interface InvestigationResult {
     totalDurationMs: number;
     timedOut: boolean;
     debugTracePath?: string;
+    /** ID of the investigation record stored in SQLite (for feedback). */
+    investigationId?: string;
 }
 export interface DeepSearchBudget {
     maxContextCalls: number;

package/dist/tools/deep-search/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/deep-search/types.ts"],"names":[],"mappings":"AAiDA,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,qBAAqB,EAAE,EAAE;IACzB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,OAAO,EAAE,YAAY;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,OAAO,EAAE,YAAY;CACrC,CAAC;AAEF,8BAA8B;AAE9B,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,2BAA2B;AAE3B;;sDAEsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/deep-search/types.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,qBAAqB,EAAE,EAAE;IACzB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,OAAO,EAAE,YAAY;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,OAAO,EAAE,YAAY;CACrC,CAAC;AAEF,8BAA8B;AAE9B,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,2BAA2B;AAE3B;;sDAEsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC"}

package/dist/tools/dp-tools.js

@@ -109,9 +109,22 @@ export function createProposeHypothesesTool(dpState) {
             "Works both inside and outside Deep Investigation mode. " +
             "Always prefer this tool over plain-text hypotheses — it renders a proper interactive card.",
         parameters: Type.Object({
-            hypotheses: Type.String({
-                description: "Formatted hypothesis list in markdown. Each hypothesis should include: " +
-                    "description, validation method (skill script paths), and confidence percentage.",
+            hypotheses: Type.Array(Type.Object({
+                id: Type.String({ description: "Hypothesis identifier: H1, H2, H3, etc." }),
+                text: Type.String({
+                    description: "A specific, testable hypothesis statement (one sentence). " +
+                        "NOT a title, category name, or group heading. " +
+                        'Good: "Firewall rules blocking inter-node communication on port 6443". ' +
+                        'Bad: "Check cluster demo".',
+                }),
+                confidence: Type.Number({ description: "Prior confidence 0-100" }),
+                description: Type.Optional(Type.String({
+                    description: "Brief explanation: why this hypothesis is plausible and how to validate it. " +
+                        "Include relevant technical context, affected components, and key validation commands.",
+                })),
+            }), {
+                description: "Each element is one distinct, independent hypothesis. " +
+                    "Do NOT include overall titles or summary items — only concrete hypotheses.",
             }),
         }),
         async execute(_toolCallId, params) {
@@ -119,13 +132,24 @@ export function createProposeHypothesesTool(dpState) {
             if (!dpState.checklist) {
                 // Outside DP mode — don't create a checklist, just present hypotheses
             }
-            const { hypotheses: hypothesesText } = params;
+            const { hypotheses: rawHypotheses } = params;
+            // Post-validation: filter out non-hypothesis items the model sometimes includes
+            const hypotheses = rawHypotheses.filter((h) => {
+                const text = h.text.trim();
+                // Markdown table rows / headers
+                if (text.startsWith("|"))
+                    return false;
+                // Meta-text about the hypotheses themselves (titles, proposal headings)
+                if (/假设提案|(?:revised|proposed|updated)\s*hypothes[ei]s/i.test(text))
+                    return false;
+                return true;
+            });
             const responseText = isDpMode
                 ? "Hypotheses presented. In DP mode — consider waiting for user confirmation before proceeding to deep_search."
                 : "Hypotheses presented to user. Decide whether to proceed based on user engagement.";
             return {
                 content: [{ type: "text", text: responseText }],
-                details: { hypotheses: hypothesesText },
+                details: { hypotheses },
             };
         },
     };

package/dist/tools/dp-tools.js.map

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

package/dist/tools/exec-utils.d.ts

@@ -0,0 +1,85 @@
+import type { KubeconfigRef } from "../core/agent-factory.js";
+/** Valid node name: RFC 1123 — alphanumeric, hyphens, dots. */
+export declare const NODE_NAME_RE: RegExp;
+/** Valid pod name: RFC 1123 subdomain — lowercase alphanumeric, hyphens, dots. */
+export declare const POD_NAME_RE: RegExp;
+export declare function validateNodeName(node: string): string | null;
+export declare function validatePodName(pod: string): string | null;
+export interface ExecEnv {
+    childEnv: NodeJS.ProcessEnv;
+    kubeconfigPath: string | null;
+    kubeconfigArgs: string[];
+}
+/**
+ * Build a sanitised child-process environment with kubeconfig resolution.
+ * Sets KUBECONFIG=/dev/null to block default ~/.kube/config; passes
+ * explicit --kubeconfig= via kubeconfigArgs when credentials are available.
+ */
+export declare function prepareExecEnv(kubeconfigRef?: KubeconfigRef): ExecEnv;
+/**
+ * Spawn a child process and collect stdout/stderr.
+ * Supports timeout and AbortSignal for cancellation.
+ */
+export declare function spawnAsync(cmd: string, args: string[], timeout: number, env?: NodeJS.ProcessEnv, signal?: AbortSignal): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Filter out kubectl run informational lines from stderr
+ * (e.g. 'pod "node-debug-xxx" deleted').
+ */
+export declare function filterPodNoise(stderr: string): string;
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+/**
+ * Format an ExecResult into a standard tool result shape.
+ * Applies filterPodNoise and processToolOutput.
+ */
+export declare function formatExecOutput(result: ExecResult): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: {
+        exitCode: number | null;
+        error?: boolean;
+    };
+};
+export interface DebugPodSpec {
+    nodeName: string;
+    /** Full command array for the container (including nsenter if needed). */
+    command: string[];
+    image?: string;
+}
+/**
+ * Run a command inside a privileged debug pod on a specific node.
+ *
+ * Manages the full 5-phase lifecycle:
+ *   1. Create pod (kubectl run)
+ *   2. Wait for terminal phase (Succeeded / Failed)
+ *   3. Fetch logs
+ *   4. Get exit code
+ *   5. Cleanup (delete pod)
+ */
+export declare function runInDebugPod(spec: DebugPodSpec, env: ExecEnv, opts: {
+    timeoutMs: number;
+    signal?: AbortSignal;
+}): Promise<ExecResult>;
+/**
+ * Resolve the network namespace of a container inside a pod.
+ * Returns the node name and container ID needed to construct nsenter commands.
+ *
+ * Steps:
+ *   1. Verify pod is Running, get its node name
+ *   2. Verify node is Ready
+ *   3. Get container ID, strip runtime prefix
+ */
+export declare function resolveContainerNetns(pod: string, namespace: string, container: string | undefined, env: ExecEnv): Promise<{
+    nodeName: string;
+    containerID: string;
+} | {
+    error: string;
+}>;

package/dist/tools/exec-utils.js

@@ -0,0 +1,294 @@
+/**
+ * Execution infrastructure shared by all remote execution tools.
+ *
+ * Consolidates: process spawning, environment setup, name validation,
+ * debug pod lifecycle, container netns resolution, and output formatting.
+ */
+import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { resolveKubeconfigPath } from "./kubeconfig-resolver.js";
+import { sanitizeEnv } from "./sanitize-env.js";
+import { processToolOutput } from "./tool-render.js";
+import { checkNodeReady, waitForPodDone } from "./k8s-checks.js";
+import { loadConfig } from "../core/config.js";
+// ── Name validators ──────────────────────────────────────────────────
+/** Valid node name: RFC 1123 — alphanumeric, hyphens, dots. */
+export const NODE_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9.\-]*$/;
+/** Valid pod name: RFC 1123 subdomain — lowercase alphanumeric, hyphens, dots. */
+export const POD_NAME_RE = /^[a-z0-9][a-z0-9.\-]*$/;
+export function validateNodeName(node) {
+    if (!node || !node.trim()) {
+        return "Node name must not be empty.";
+    }
+    if (!NODE_NAME_RE.test(node)) {
+        return `Invalid node name "${node}". Node names may only contain letters, digits, hyphens, and dots.`;
+    }
+    return null;
+}
+export function validatePodName(pod) {
+    if (!pod || !pod.trim()) {
+        return "Pod name must not be empty.";
+    }
+    if (!POD_NAME_RE.test(pod)) {
+        return `Invalid pod name "${pod}". Pod names may only contain lowercase letters, digits, hyphens, and dots.`;
+    }
+    return null;
+}
+/**
+ * Build a sanitised child-process environment with kubeconfig resolution.
+ * Sets KUBECONFIG=/dev/null to block default ~/.kube/config; passes
+ * explicit --kubeconfig= via kubeconfigArgs when credentials are available.
+ */
+export function prepareExecEnv(kubeconfigRef) {
+    const kubeconfigPath = resolveKubeconfigPath(kubeconfigRef?.credentialsDir);
+    return {
+        childEnv: {
+            ...sanitizeEnv(process.env),
+            ...(kubeconfigRef?.credentialsDir
+                ? { SICLAW_CREDENTIALS_DIR: kubeconfigRef.credentialsDir }
+                : {}),
+            KUBECONFIG: "/dev/null",
+        },
+        kubeconfigPath,
+        kubeconfigArgs: kubeconfigPath ? [`--kubeconfig=${kubeconfigPath}`] : [],
+    };
+}
+// ── Process utilities ────────────────────────────────────────────────
+/**
+ * Spawn a child process and collect stdout/stderr.
+ * Supports timeout and AbortSignal for cancellation.
+ */
+export function spawnAsync(cmd, args, timeout, env, signal) {
+    return new Promise((resolve, reject) => {
+        let stdout = "";
+        let stderr = "";
+        const child = spawn(cmd, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            env,
+        });
+        const onAbort = () => child.kill("SIGKILL");
+        signal?.addEventListener("abort", onAbort, { once: true });
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGKILL");
+        }, timeout);
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+            if (code === 0)
+                resolve({ stdout, stderr });
+            else
+                reject(Object.assign(new Error(`exit ${code}`), { code, stdout, stderr }));
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+    });
+}
+/**
+ * Filter out kubectl run informational lines from stderr
+ * (e.g. 'pod "node-debug-xxx" deleted').
+ */
+export function filterPodNoise(stderr) {
+    return stderr
+        .split("\n")
+        .filter((line) => !line.match(/^pod "node-debug-.*" deleted$/))
+        .join("\n")
+        .trim();
+}
+/**
+ * Format an ExecResult into a standard tool result shape.
+ * Applies filterPodNoise and processToolOutput.
+ */
+export function formatExecOutput(result) {
+    const filteredStderr = filterPodNoise(result.stderr);
+    const output = result.stdout.trim() +
+        (filteredStderr ? `\n\nSTDERR:\n${filteredStderr}` : "");
+    if (result.exitCode === 0 || (result.exitCode === null && result.stdout.trim())) {
+        return {
+            content: [{ type: "text", text: processToolOutput(output) }],
+            details: { exitCode: result.exitCode ?? 0 },
+        };
+    }
+    else {
+        const errOutput = `Exit code: ${result.exitCode ?? "unknown"}\n${output}`;
+        return {
+            content: [{ type: "text", text: processToolOutput(errOutput) }],
+            details: { exitCode: result.exitCode, error: true },
+        };
+    }
+}
+/**
+ * Run a command inside a privileged debug pod on a specific node.
+ *
+ * Manages the full 5-phase lifecycle:
+ *   1. Create pod (kubectl run)
+ *   2. Wait for terminal phase (Succeeded / Failed)
+ *   3. Fetch logs
+ *   4. Get exit code
+ *   5. Cleanup (delete pod)
+ */
+export async function runInDebugPod(spec, env, opts) {
+    const image = spec.image || loadConfig().debugImage;
+    const podId = randomBytes(4).toString("hex");
+    const podName = `node-debug-${podId}`;
+    const cleanup = () => {
+        spawnAsync("kubectl", [...env.kubeconfigArgs, "delete", "pod", podName, "--force", "--grace-period=0"], 10_000, env.childEnv).catch(() => { });
+    };
+    const overrides = JSON.stringify({
+        spec: {
+            nodeName: spec.nodeName,
+            hostPID: true,
+            hostNetwork: true,
+            containers: [{
+                    name: podName,
+                    image,
+                    securityContext: { privileged: true },
+                    command: spec.command,
+                }],
+            restartPolicy: "Never",
+        },
+    });
+    try {
+        // Phase 1: Create pod
+        await spawnAsync("kubectl", [
+            ...env.kubeconfigArgs,
+            "run", podName,
+            "--restart=Never",
+            `--image=${image}`,
+            `--overrides=${overrides}`,
+        ], 30_000, env.childEnv, opts.signal);
+        // Phase 2: Wait for pod to reach terminal phase (Succeeded or Failed)
+        try {
+            await waitForPodDone(podName, opts.timeoutMs, env.childEnv, opts.signal, env.kubeconfigPath ?? undefined);
+        }
+        catch {
+            // Timed out — still fetch logs before cleanup
+        }
+        if (opts.signal?.aborted) {
+            cleanup();
+            return { stdout: "", stderr: "Aborted.", exitCode: null };
+        }
+        // Phase 3: Fetch logs
+        let stdout = "";
+        let stderr = "";
+        try {
+            const logsResult = await spawnAsync("kubectl", [...env.kubeconfigArgs, "logs", podName], 10_000, env.childEnv);
+            stdout = logsResult.stdout;
+            stderr = logsResult.stderr;
+        }
+        catch (logErr) {
+            stdout = logErr.stdout ?? "";
+            stderr = logErr.stderr ?? "";
+        }
+        // Phase 4: Get exit code from pod status
+        let exitCode = null;
+        try {
+            const statusResult = await spawnAsync("kubectl", [
+                ...env.kubeconfigArgs, "get", "pod", podName,
+                "-o", "jsonpath={.status.containerStatuses[0].state.terminated.exitCode}",
+            ], 5_000, env.childEnv);
+            const code = parseInt(statusResult.stdout.trim(), 10);
+            if (!isNaN(code))
+                exitCode = code;
+        }
+        catch {
+            // ignore — exitCode stays null
+        }
+        // Phase 5: Cleanup
+        cleanup();
+        return { stdout, stderr, exitCode };
+    }
+    catch (err) {
+        cleanup();
+        return {
+            stdout: err.stdout?.trim() ?? "",
+            stderr: err.stderr?.trim() ?? err.message,
+            exitCode: typeof err.code === "number" ? err.code : null,
+        };
+    }
+}
+// ── Container netns resolution ───────────────────────────────────────
+/**
+ * Resolve the network namespace of a container inside a pod.
+ * Returns the node name and container ID needed to construct nsenter commands.
+ *
+ * Steps:
+ *   1. Verify pod is Running, get its node name
+ *   2. Verify node is Ready
+ *   3. Get container ID, strip runtime prefix
+ */
+export async function resolveContainerNetns(pod, namespace, container, env) {
+    // Step 1: Get pod phase + node
+    let nodeName;
+    try {
+        const result = await spawnAsync("kubectl", [
+            ...env.kubeconfigArgs,
+            "get", "pod", pod, "-n", namespace,
+            "-o", "jsonpath={.status.phase},{.spec.nodeName}",
+        ], 10_000, env.childEnv);
+        const parts = result.stdout.trim().split(",");
+        const phase = parts[0];
+        nodeName = parts[1] || "";
+        if (phase !== "Running") {
+            return {
+                error: `Pod "${pod}" in namespace "${namespace}" is not Running (phase: ${phase || "unknown"}). Cannot enter its network namespace.`,
+            };
+        }
+        if (!nodeName) {
+            return {
+                error: `Could not determine node for pod "${pod}" in namespace "${namespace}".`,
+            };
+        }
+    }
+    catch (err) {
+        const stderr = (err.stderr?.trim() || err.message);
+        if (stderr.includes("not found")) {
+            return {
+                error: `Pod "${pod}" not found in namespace "${namespace}". Check the pod name and namespace.`,
+            };
+        }
+        return { error: `Failed to get pod info: ${stderr}` };
+    }
+    // Step 2: Check node is Ready
+    const nodeCheckErr = await checkNodeReady(nodeName, env.childEnv, env.kubeconfigPath ?? undefined);
+    if (nodeCheckErr) {
+        return { error: nodeCheckErr };
+    }
+    // Step 3: Get container ID
+    try {
+        const jsonpathExpr = container?.trim()
+            ? `{.status.containerStatuses[?(@.name=="${container.trim()}")].containerID}`
+            : "{.status.containerStatuses[0].containerID}";
+        const result = await spawnAsync("kubectl", [
+            ...env.kubeconfigArgs,
+            "get", "pod", pod, "-n", namespace,
+            "-o", `jsonpath=${jsonpathExpr}`,
+        ], 10_000, env.childEnv);
+        let containerID = result.stdout.trim();
+        if (!containerID) {
+            return {
+                error: `Could not determine container ID for pod "${pod}". Is the pod running?`,
+            };
+        }
+        // Strip the runtime prefix (e.g. "containerd://")
+        const prefixIdx = containerID.indexOf("://");
+        if (prefixIdx !== -1) {
+            containerID = containerID.slice(prefixIdx + 3);
+        }
+        return { nodeName, containerID };
+    }
+    catch (err) {
+        return {
+            error: `Failed to get container ID: ${err.stderr?.trim() || err.message}`,
+        };
+    }
+}
+//# sourceMappingURL=exec-utils.js.map

package/dist/tools/exec-utils.js.map

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

package/dist/tools/fork-skill.js

@@ -15,10 +15,22 @@ This tool outputs a structured fork definition that the user can preview and sav
 
 **When to use this tool vs others:**
 - \`fork_skill\`: Fork an existing builtin/team skill to personal (with or without modifications)
-- \`create_skill\`: Create a brand-new skill from scratch
+- \`create_skill\`: Create a brand-new skill from scratch (only when no existing skill covers the same functionality)
 - \`update_skill\`: Update an existing personal skill
 
-**IMPORTANT**: Before calling this tool, check the Skill Scripts Reference in your context and read the source skill's SKILL.md to understand its current content. You need the exact skill name.
+**IMPORTANT**: Before calling this tool, check \`<available_skills>\` in your system prompt and read the source skill's SKILL.md to understand its current content. You need the exact skill name.
+
+**Prefer forking over creating**: If a user wants to create a skill that overlaps with an existing builtin or team skill, recommend forking instead. This avoids duplicate skills that confuse the model. Fork lets them customize while keeping a clear lineage.
+
+## Environments and Approval Workflow
+
+| Environment | Behavior |
+|-------------|----------|
+| **Dev / Test** | Forked skill (draft) is immediately visible and testable. |
+| **Production** | Forked skill must be **approved** before it appears. |
+
+- Forked skills with scripts require admin approval before production use.
+- In dev/test, the forked copy is available immediately for testing.
 
 Parameters:
 - source: The exact name of the builtin or team skill to fork (e.g. "find-node", "roce-perftest-pod")

package/dist/tools/fork-skill.js.map

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

package/dist/tools/investigation-feedback.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+import type { MemoryRef } from "./deep-search/tool.js";
+export declare function createInvestigationFeedbackTool(memoryRef: MemoryRef): ToolDefinition;

package/dist/tools/investigation-feedback.js

@@ -0,0 +1,71 @@
+import { Type } from "@sinclair/typebox";
+import { FEEDBACK_SIGNALS } from "../memory/types.js";
+export function createInvestigationFeedbackTool(memoryRef) {
+    return {
+        name: "investigation_feedback",
+        label: "Investigation Feedback",
+        description: `Submit feedback on a completed investigation's diagnosis accuracy.
+This adjusts retrieval weighting so correct diagnoses get boosted and wrong ones get suppressed in future investigations.
+
+Use after presenting deep_search findings when the user confirms, corrects, or rejects the diagnosis.
+The investigationId comes from the deep_search result details.`,
+        parameters: Type.Object({
+            investigationId: Type.String({ description: "ID from the deep_search result" }),
+            status: Type.Union([
+                Type.Literal("confirmed"),
+                Type.Literal("corrected"),
+                Type.Literal("rejected"),
+            ], { description: "confirmed = diagnosis was correct, corrected = partially right but root cause was different, rejected = diagnosis was wrong" }),
+            correctedRootCause: Type.Optional(Type.String({ description: "The actual root cause (when status is 'corrected')" })),
+            note: Type.Optional(Type.String({ description: "Additional context about the feedback" })),
+        }),
+        async execute(_toolCallId, rawParams) {
+            const params = rawParams;
+            const indexer = memoryRef.indexer;
+            if (!indexer) {
+                return {
+                    content: [{ type: "text", text: "Memory indexer not available. Feedback not saved." }],
+                    details: { error: true },
+                };
+            }
+            // Validate that the investigation exists
+            const record = indexer.getInvestigationById(params.investigationId);
+            if (!record) {
+                return {
+                    content: [{ type: "text", text: `Investigation not found: ${params.investigationId}` }],
+                    details: { error: true },
+                };
+            }
+            // Build feedback note: encode status + optional correction/note
+            const signal = FEEDBACK_SIGNALS[params.status];
+            let note = params.status;
+            if (params.status === "corrected" && params.correctedRootCause) {
+                note = `corrected: ${params.correctedRootCause}`;
+            }
+            if (params.note) {
+                note += ` | ${params.note}`;
+            }
+            const updated = indexer.updateInvestigationFeedback(params.investigationId, signal, note);
+            if (!updated) {
+                return {
+                    content: [{ type: "text", text: "Failed to update investigation feedback." }],
+                    details: { error: true },
+                };
+            }
+            const statusLabels = {
+                confirmed: `Diagnosis confirmed (weight boosted to ${signal}x)`,
+                corrected: `Diagnosis corrected (weight reduced to ${signal}x)`,
+                rejected: `Diagnosis rejected (weight reduced to ${signal}x)`,
+            };
+            return {
+                content: [{ type: "text", text: `Feedback recorded: ${statusLabels[params.status]}. Future investigations will be adjusted accordingly.` }],
+                details: {
+                    investigationId: params.investigationId,
+                    status: params.status,
+                    signal,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=investigation-feedback.js.map

package/dist/tools/investigation-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-feedback.js","sourceRoot":"","sources":["../../src/tools/investigation-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAC;AAU3E,MAAM,UAAU,+BAA+B,CAAC,SAAoB;IAClE,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;;;;+DAI8C;QAC3D,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;YAC/E,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;aACzB,EAAE,EAAE,WAAW,EAAE,6HAA6H,EAAE,CAAC;YAClJ,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC,CAAC;YACrH,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAAC;SAC3F,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS;YAClC,MAAM,MAAM,GAAG,SAA2B,CAAC;YAE3C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mDAAmD,EAAE,CAAC;oBACtF,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;iBACzB,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,MAAM,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC;oBACvF,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;iBACzB,CAAC;YACJ,CAAC;YAED,gEAAgE;YAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,IAAI,GAAG,MAAM,CAAC,MAAgB,CAAC;YACnC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/D,IAAI,GAAG,cAAc,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACnD,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,IAAI,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,2BAA2B,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1F,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0CAA0C,EAAE,CAAC;oBAC7E,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;iBACzB,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAmC;gBACnD,SAAS,EAAE,0CAA0C,MAAM,IAAI;gBAC/D,SAAS,EAAE,0CAA0C,MAAM,IAAI;gBAC/D,QAAQ,EAAE,yCAAyC,MAAM,IAAI;aAC9D,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,uDAAuD,EAAE,CAAC;gBAC3I,OAAO,EAAE;oBACP,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM;iBACP;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}