@cstack-protocol/pingala 1.0.0

package/build/src/tools/validate-stack-change.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { Governor } from "../core/governor.js";
+import { flushTelemetry } from "../core/sdk-adapter.js";
+export const validateStackChangeTool = {
+    name: "validate_stack_change",
+    description: "Validates any proposed stack change against 5:3:1 Protocol, CSI thresholds, and maturity gates. Call this BEFORE suggesting tool additions, role changes, or anchor modifications.",
+    schema: {
+        change_type: z.enum(["add_tool", "remove_tool", "change_role", "change_anchor"]).describe("Type of stack modification"),
+        tool_name: z.string().describe("Name of the tool being added/modified"),
+        proposed_role: z.enum(["Anchor", "Active", "Supporting"]).optional().describe("Intended role in 5:3:1 hierarchy"),
+        function_id: z.string().optional().describe("The functional node/Bāguà room this tool belongs to (e.g., 'browser', 'comms')"),
+        contexts: z.array(z.string()).optional().describe("Contexts where this tool is used (e.g., ['mobile', 'desktop'])"),
+        is_adapter: z.boolean().optional().describe("Set to true if this is a contextual window into another node"),
+        replaces_existing: z.boolean().optional().describe("Whether this replaces an existing tool"),
+        replaced_tool: z.string().optional().describe("Name of tool being replaced (if applicable)"),
+        justification: z.string().optional().describe("User's reasoning for the change")
+    },
+    handler: async (args) => {
+        Governor.recordValidation(!!args.justification);
+        const result = Governor.validateStackChange({
+            ...args,
+            type: args.change_type,
+            functionId: args.function_id,
+            isAdapter: args.is_adapter
+        });
+        flushTelemetry().catch((err) => console.error("Telemetry sync failed", err));
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=validate-stack-change.js.map

package/build/src/tools/validate-stack-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-stack-change.js","sourceRoot":"","sources":["../../../src/tools/validate-stack-change.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAuB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,oLAAoL;IACjM,MAAM,EAAE;QACJ,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACvH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACvE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACjH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;QAC7H,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;QACnH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;QAC3G,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QAC5F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC5F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACnF;IACD,OAAO,EAAE,KAAK,EAAE,IAUf,EAAE,EAAE;QAED,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,mBAAmB,CAAC;YACxC,GAAG,IAAI;YACP,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,SAAS,EAAE,IAAI,CAAC,UAAU;SAC7B,CAAC,CAAC;QAGH,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC,CAAC;QAElF,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC,CAAC;SACL,CAAC;IACN,CAAC;CACJ,CAAC"}

package/build/test-l3.d.ts

@@ -0,0 +1 @@
+export {};

package/build/test-l3.js

@@ -0,0 +1,35 @@
+import { csAuditTool } from "./tools/cs-audit.js";
+import { MethodologyLoader } from "./core/methodology.js";
+import { ConsentManager } from "./core/consent-manager.js";
+async function test_l3_audit() {
+    process.env.CSTACK_AGENT_CORE_PATH = "/Users/georgesiosi/Documents/GitHub/conscious-stack/_active/cs-agent-core";
+    MethodologyLoader.init();
+    const workspacePath = "/Users/georgesiosi/Documents/GitHub/conscious-stack/_active/cs-mcp-core";
+    ConsentManager.setWorkspace(workspacePath);
+    const tools = [
+        { name: "FocusMonitor", role: "Anchor", functionId: "Tai Ji", category: "OS" },
+        { name: "Cursor", role: "Active", functionId: "Gen", category: "Development" },
+        { name: "Notion", role: "Active", functionId: "Qian", category: "Knowledge" },
+        { name: "Obsidian", role: "Active", functionId: "Dui", category: "Knowledge" },
+        { name: "Slack", role: "Supporting", functionId: "Li", category: "Communication" },
+        { name: "Linear", role: "Supporting", functionId: "Kan", category: "Task" }
+    ];
+    console.log("--- TEST 1: L3 Audit Without Consent ---");
+    const result1 = await csAuditTool.handler({
+        tools,
+        path: workspacePath,
+        depth_level: "L3"
+    });
+    console.log(JSON.stringify(result1, null, 2));
+    console.log("\n--- TEST 2: L3 Audit WITH CONSENT ---");
+    ConsentManager.setConsent("L2", true);
+    ConsentManager.setConsent("L3", true);
+    const result2 = await csAuditTool.handler({
+        tools,
+        path: workspacePath,
+        depth_level: "L3"
+    });
+    console.log(JSON.stringify(result2, null, 2));
+}
+test_l3_audit().catch(console.error);
+//# sourceMappingURL=test-l3.js.map

package/build/test-l3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-l3.js","sourceRoot":"","sources":["../src/test-l3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,KAAK,UAAU,aAAa;IACxB,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,2EAA2E,CAAC;IACjH,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAGzB,MAAM,aAAa,GAAG,yEAAyE,CAAC;IAChG,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAG3C,MAAM,KAAK,GAAG;QACV,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE;QAC9E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE;QAC7E,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE;QAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE;QAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC9E,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC;QACtC,KAAK;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,IAAI;KACpB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAEvD,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC;QACtC,KAAK;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,IAAI;KACpB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/build/tools/analyze-stack.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export declare const analyzeStackTool: {
+    name: string;
+    description: string;
+    schema: {
+        tools: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodEnum<{
+                Anchor: "Anchor";
+                Active: "Active";
+                Supporting: "Supporting";
+            }>;
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+            functionId: z.ZodOptional<z.ZodString>;
+            is_parent: z.ZodOptional<z.ZodBoolean>;
+            is_substack: z.ZodOptional<z.ZodBoolean>;
+            parent_name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        context: z.ZodOptional<z.ZodObject<{
+            user_intent: z.ZodOptional<z.ZodString>;
+            attention_depth: z.ZodOptional<z.ZodNumber>;
+            dependency_exposure: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    };
+    handler: (args: {
+        tools: any[];
+        context?: {
+            user_intent?: string;
+            attention_depth?: number;
+            dependency_exposure?: number;
+        };
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/tools/analyze-stack.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { PingalaEngine } from "../core/pingala.js";
+import { Governor } from "../core/governor.js";
+import { Rule531 } from "../core/531-rule.js";
+import { EngagementAnalyzer } from "../core/engagement-analyzer.js";
+import { DiamondMapper } from "../core/life-area-mapper.js";
+import { ConvexHttpClient } from "convex/browser";
+const CONVEX_URL = process.env.CONVEX_URL || "https://impressive-hamster-318.convex.cloud";
+const client = new ConvexHttpClient(CONVEX_URL);
+const ToolSchema = z.object({
+    name: z.string(),
+    role: z.enum(["Anchor", "Active", "Supporting"]),
+    category: z.string().optional(),
+    description: z.string().optional(),
+    context: z.string().optional(),
+    functionId: z.string().optional(),
+    is_parent: z.boolean().optional(),
+    is_substack: z.boolean().optional(),
+    parent_name: z.string().optional()
+});
+export const analyzeStackTool = {
+    name: "analyze_stack",
+    description: "Validates a tool stack against the 5:3:1 Clean Architecture Protocol. Requires a structured list of tools with assigned roles.",
+    schema: {
+        tools: z.array(ToolSchema).describe("List of tools to analyze. MINIMUM REQUIREMENT: { name, role } per tool."),
+        context: z.object({
+            user_intent: z.string().optional(),
+            attention_depth: z.number().min(0).max(100).optional(),
+            dependency_exposure: z.number().min(0).max(100).optional()
+        }).optional()
+    },
+    handler: async (args) => {
+        const toolList = args.tools.map(t => ({
+            name: t.name,
+            role: t.role,
+            category: t.category,
+            context: t.context,
+            functionId: t.functionId,
+            is_parent: t.is_parent,
+            is_substack: t.is_substack,
+            parent_name: t.parent_name
+        }));
+        let validation;
+        let diffSource = "Local (Fallback)";
+        try {
+            const apiKey = process.env.CSTACK_API_KEY || "anonymous";
+            validation = await client.mutation("stacks:validateAndStore", {
+                operatorHash: apiKey,
+                tools: toolList,
+                agentId: "Pingala-MCP-v1"
+            });
+            diffSource = "CSTACK API (Convex)";
+        }
+        catch (e) {
+            console.error("API Validation Failed, falling back to local:", e);
+            validation = Rule531.validate({ tools: toolList });
+        }
+        const { geometry } = validation;
+        const strain_signals = validation.violations;
+        const engagement = EngagementAnalyzer.classifyByEngagement(toolList);
+        const fragmentation = EngagementAnalyzer.detectFragmentation(toolList);
+        const diagnosis = await PingalaEngine.diagnose({
+            tools: toolList,
+            scores: {
+                attention_depth: args.context?.attention_depth || 50,
+                dependency_exposure: args.context?.dependency_exposure || 50
+            }
+        });
+        const context = Governor.getGovernanceContext();
+        const maturity = {
+            level: context.maturity_level,
+            name: context.maturity_name,
+            guidance: `Validated via ${diffSource}. Monitor your Strain Signals to maintain Crystalline Norms.`
+        };
+        const report = {
+            type: "governance_report",
+            version: "0.5.0 (Stability Norms)",
+            timestamp: new Date().toISOString(),
+            csi_score: diagnosis.csi_score,
+            functional_geometry: {
+                core: geometry.core,
+                contexts: geometry.contexts,
+                slots: toolList.reduce((acc, tool) => {
+                    const fid = tool.functionId || "Unclassified";
+                    if (!acc[fid])
+                        acc[fid] = { id: fid, primary_role: tool.role, nodes: [] };
+                    acc[fid].nodes.push({
+                        name: tool.name,
+                        role: tool.role,
+                        context: tool.context,
+                        is_parent: tool.is_parent,
+                        is_substack: tool.is_substack,
+                        parent_name: tool.parent_name
+                    });
+                    return acc;
+                }, {})
+            },
+            audit_result: {
+                isValid: validation.isValid && fragmentation.length === 0,
+                strain_signals,
+                recommendations: [
+                    strain_signals.length > 0 ? "Strain detected. Adjust stack to align with Crystalline Norms." : "Structure is coherent.",
+                    fragmentation.length > 0 ? "Consolidate your functional nodes to reduce context switching." : "No fragmentation detected."
+                ]
+            },
+            engagement_reality: {
+                high_engagement_hubs: engagement.high_engagement.map(t => t.name),
+                fragmentation_clusters: fragmentation.map(f => f.functionId)
+            },
+            maturity_assessment: maturity,
+            inner_diamond: new DiamondMapper().mapToDiamond(toolList, false)
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(report, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=analyze-stack.js.map

package/build/tools/analyze-stack.js.map

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

package/build/tools/audit-workspace.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const auditWorkspaceTool: {
+    name: string;
+    description: string;
+    schema: {
+        path: z.ZodString;
+    };
+    handler: (args: {
+        path: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/tools/audit-workspace.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { PingalaEngine } from "../core/pingala.js";
+export const auditWorkspaceTool = {
+    name: "audit_workspace",
+    description: "Scans a workspace for .agent configuration and evaluates 5:3:1 protocol alignment (CSI/SAS).",
+    schema: {
+        path: z.string().describe("The absolute path to the workspace directory to audit.")
+    },
+    handler: async (args) => {
+        const workspacePath = args.path;
+        const agentPath = path.join(workspacePath, ".agent");
+        const report = {
+            workspace: workspacePath,
+            agent_found: fs.existsSync(agentPath),
+            timestamp: new Date().toISOString()
+        };
+        if (!report.agent_found) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Pingala Analysis: Workspace '${workspacePath}' is unmapped. No '.agent' directory found. High risk of cognitive erosion.`
+                    }]
+            };
+        }
+        const mockTools = [
+            { name: "Claude/Antigravity", category: "Intelligence", role: "Anchor" }
+        ];
+        const diagnosis = PingalaEngine.diagnose({ tools: mockTools });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ ...report, diagnosis }, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=audit-workspace.js.map

package/build/tools/audit-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-workspace.js","sourceRoot":"","sources":["../../src/tools/audit-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,8FAA8F;IAC3G,MAAM,EAAE;QACJ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KACtF;IACD,OAAO,EAAE,KAAK,EAAE,IAAsB,EAAE,EAAE;QACtC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAErD,MAAM,MAAM,GAAQ;YAChB,SAAS,EAAE,aAAa;YACxB,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YACrC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACH,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gCAAgC,aAAa,6EAA6E;qBACnI,CAAC;aACL,CAAC;QACN,CAAC;QAID,MAAM,SAAS,GAAmB;YAC9B,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3E,CAAC;QAEF,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAE/D,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC1D,CAAC;SACL,CAAC;IACN,CAAC;CACJ,CAAC"}

package/build/tools/calculate-csi.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const calculateCsiTool: {
+    name: string;
+    description: string;
+    schema: {
+        attention_depth: z.ZodOptional<z.ZodNumber>;
+        dependency_exposure: z.ZodOptional<z.ZodNumber>;
+        time_window: z.ZodOptional<z.ZodEnum<{
+            "7d": "7d";
+            "30d": "30d";
+            "90d": "90d";
+        }>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    };
+    handler: (args: {
+        attention_depth?: number;
+        dependency_exposure?: number;
+        time_window?: string;
+        tools?: any[];
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/tools/calculate-csi.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { Governor } from "../core/governor.js";
+import { PingalaEngine } from "../core/pingala.js";
+export const calculateCsiTool = {
+    name: "calculate_csi",
+    description: "Computes current Cognitive Sovereignty Index (0-100) from telemetry scores. Allows recording of Attention Depth and Dependency Exposure.",
+    schema: {
+        attention_depth: z.number().min(0).max(100).optional().describe("0-100 score for attention quality/deep work"),
+        dependency_exposure: z.number().min(0).max(100).optional().describe("0-100 score for workflow independence from AI"),
+        time_window: z.enum(["7d", "30d", "90d"]).optional().describe("Lookback period (default 7d)"),
+        tools: z.array(z.any()).optional().describe("Optional list of tools to calculate CSI for (Stateless Mode)")
+    },
+    handler: async (args) => {
+        if (args.attention_depth !== undefined || args.dependency_exposure !== undefined) {
+            Governor.recordTelemetry({
+                attention_depth: args.attention_depth,
+                dependency_exposure: args.dependency_exposure
+            });
+        }
+        const stack = args.tools || Governor.getStack();
+        const diagnosis = await PingalaEngine.diagnose({ tools: stack });
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(diagnosis, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=calculate-csi.js.map

package/build/tools/calculate-csi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-csi.js","sourceRoot":"","sources":["../../src/tools/calculate-csi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,0IAA0I;IACvJ,MAAM,EAAE;QACJ,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC9G,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QACpH,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC7F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;KAC9G;IACD,OAAO,EAAE,KAAK,EAAE,IAKf,EAAE,EAAE;QAED,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC/E,QAAQ,CAAC,eAAe,CAAC;gBACrB,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;aAChD,CAAC,CAAC;QACP,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC3C,CAAC;SACL,CAAC;IACN,CAAC;CACJ,CAAC"}

package/build/tools/cs-audit.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+export declare const csAuditTool: {
+    name: string;
+    description: string;
+    schema: {
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodEnum<{
+                Anchor: "Anchor";
+                Active: "Active";
+                Supporting: "Supporting";
+            }>;
+            category: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+            functionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        path: z.ZodOptional<z.ZodString>;
+        image_uri: z.ZodOptional<z.ZodString>;
+        proposed_tool: z.ZodOptional<z.ZodString>;
+        current_phase: z.ZodOptional<z.ZodString>;
+        depth_level: z.ZodDefault<z.ZodEnum<{
+            L2: "L2";
+            L3: "L3";
+            L1: "L1";
+        }>>;
+        practitioner_mode: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: (args: {
+        tools?: Array<any>;
+        path?: string;
+        image_uri?: string;
+        proposed_tool?: string;
+        current_phase?: string;
+        depth_level?: "L1" | "L2" | "L3";
+        practitioner_mode?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};