@cstack-protocol/pingala 1.0.0

package/build/tools/cs-audit.js

@@ -0,0 +1,330 @@
+import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { PingalaEngine } from "../core/pingala.js";
+import { MethodologyLoader } from "../core/methodology.js";
+import { Governor } from "../core/governor.js";
+import { EngagementAnalyzer } from "../core/engagement-analyzer.js";
+import { ConsentManager } from "../core/consent-manager.js";
+import { BaguaMapper, DiamondMapper } from "../core/life-area-mapper.js";
+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()
+});
+export const csAuditTool = {
+    name: "cs_audit",
+    description: "Audits a stack as a Cognitive Mirror, not just a rule checker. Analyzes ENGAGEMENT REALITY—distinguishing high-engagement hubs from passive utilities—and flags fragmentation (multiple tools per function).",
+    schema: {
+        tools: z.array(ToolSchema).optional().describe("List of tools to audit"),
+        path: z.string().optional().describe("Path to a vault.yaml or .agent directory"),
+        image_uri: z.string().optional().describe("URI to a screenshot of a stack (parsed via LLM vision if available)"),
+        proposed_tool: z.string().optional().describe("A new tool being considered for addition"),
+        current_phase: z.string().optional().describe("Current work phase (e.g., 'pre-launch', 'scale', 'maintenance')"),
+        depth_level: z.enum(["L1", "L2", "L3"]).default("L1").describe("The requested depth level of auditing"),
+        practitioner_mode: z.boolean().optional().describe("If true, overrides consent gates and exposes internal jargon")
+    },
+    handler: async (args) => {
+        const depth = args.depth_level || "L1";
+        const practitionerMode = args.practitioner_mode || false;
+        if (args.path) {
+            ConsentManager.setWorkspace(args.path);
+        }
+        if (!ConsentManager.isAuthorized(depth, practitionerMode)) {
+            const prompts = MethodologyLoader.loadConsentPrompts();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "consent_request",
+                            level: depth,
+                            message: depth === "L2" ? prompts.l2 : prompts.l3,
+                            hint: "Consent will be saved for this workspace."
+                        }, null, 2)
+                    }]
+            };
+        }
+        let toolList = [];
+        if (args.tools && args.tools.length > 0) {
+            const rawList = args.tools.map(t => ({
+                name: t.name,
+                category: t.category || "Uncategorized",
+                role: t.role || "Supporting",
+                avgDailyMinutes: t.avgDailyMinutes,
+                usagePattern: t.usagePattern,
+                functionId: t.functionId,
+                contexts: t.contexts || (t.device ? [t.device] : undefined),
+                isAdapter: t.isAdapter ?? t.contextual_adapter,
+                substack: t.substack ?? t.substacks
+            }));
+            toolList = rawList;
+        }
+        else if (args.path) {
+            const vaultPath = path.join(args.path, "vault.yaml");
+            if (fs.existsSync(vaultPath)) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                type: "clarification",
+                                message: "Vault detected. Please provide tools as a list for now (vault parsing coming soon).",
+                                vault_path: vaultPath
+                            }, null, 2)
+                        }]
+                };
+            }
+            else {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                type: "clarification",
+                                message: `No vault.yaml found at ${args.path}. Please provide tools as a list.`
+                            }, null, 2)
+                        }]
+                };
+            }
+        }
+        else if (args.image_uri) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "clarification",
+                            message: "Image received. LLM vision parsing not yet implemented. Please provide tools as a list.",
+                            image_uri: args.image_uri
+                        }, null, 2)
+                    }]
+            };
+        }
+        else {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "clarification",
+                            step: 2,
+                            question: "What tools are currently in your stack?",
+                            hint: "List each tool with its name. Optionally include role (Anchor/Active/Supporting) and category."
+                        }, null, 2)
+                    }]
+            };
+        }
+        const engagement = EngagementAnalyzer.classifyByEngagement(toolList);
+        const fragmentation = EngagementAnalyzer.detectFragmentation(toolList);
+        const anomalies = EngagementAnalyzer.flagAnomalies(toolList);
+        const anchorCheck = EngagementAnalyzer.identifyAnchorEnvironment(toolList);
+        const cognitivelyActiveTools = engagement.high_engagement.length + fragmentation.length;
+        if (cognitivelyActiveTools > 9) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "intervention",
+                            step: 1,
+                            status: "HARD_STOP",
+                            message: `Your high-engagement stack has ${cognitivelyActiveTools} Active Hubs. The 5:3:1 Protocol limits you to 9. You are in a state of cognitive debt.`,
+                            active_hubs: cognitivelyActiveTools,
+                            max_allowed: 9,
+                            fragmentation_clusters: fragmentation.map(f => f.functionId)
+                        }, null, 2)
+                    }]
+            };
+        }
+        const anchors = toolList.filter(t => t.role === "Anchor");
+        const active = toolList.filter(t => t.role === "Active");
+        const supporting = toolList.filter(t => t.role === "Supporting");
+        const unassigned = toolList.filter(t => !t.role);
+        if (unassigned.length > 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "clarification",
+                            step: 2,
+                            question: "Some tools don't have roles assigned. Please classify these:",
+                            unassigned_tools: unassigned.map(t => t.name),
+                            valid_roles: ["Anchor", "Active", "Supporting"],
+                            rule: "You need exactly 1 Anchor, up to 3 Active, and up to 5 Supporting."
+                        }, null, 2)
+                    }]
+            };
+        }
+        const structureIssues = [];
+        if (anchors.length !== 1) {
+            structureIssues.push(`Expected 1 Anchor, found ${anchors.length}.`);
+        }
+        if (active.length > 3) {
+            structureIssues.push(`Expected max 3 Active, found ${active.length}.`);
+        }
+        if (supporting.length > 5) {
+            structureIssues.push(`Expected max 5 Supporting, found ${supporting.length}.`);
+        }
+        if (!anchorCheck.hasAnchor) {
+            structureIssues.push(anchorCheck.observation || "No clear Anchor environment detected.");
+        }
+        if (structureIssues.length > 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "intervention",
+                            step: 2,
+                            status: "STRUCTURE_VIOLATION",
+                            issues: structureIssues,
+                            hint: anchorCheck.hint,
+                            current_structure: {
+                                anchors: anchors.map(t => t.name),
+                                active: active.map(t => t.name),
+                                supporting: supporting.map(t => t.name)
+                            }
+                        }, null, 2)
+                    }]
+            };
+        }
+        if (fragmentation.length > 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "intervention",
+                            step: 3,
+                            status: "FRAGMENTATION_DETECTED",
+                            message: "You have multiple tools serving the same function. This creates obligation anxiety and check-in loops.",
+                            clusters: fragmentation,
+                            recommendation: "Consolidate to a single tool per function, or explicitly acknowledge the split as intentional."
+                        }, null, 2)
+                    }]
+            };
+        }
+        if (args.proposed_tool) {
+            const overlap = toolList.find(t => t.name.toLowerCase().includes(args.proposed_tool.toLowerCase()) ||
+                args.proposed_tool.toLowerCase().includes(t.name.toLowerCase()));
+            if (overlap) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                type: "intervention",
+                                step: 3,
+                                status: "REDUNDANCY_CHECK",
+                                question: `You already have '${overlap.name}'. How is '${args.proposed_tool}' different?`,
+                                existing_tool: overlap.name,
+                                proposed_tool: args.proposed_tool,
+                                hint: "If they serve the same function, this addition violates Stack Substitution rules."
+                            }, null, 2)
+                        }]
+                };
+            }
+            if (!args.current_phase) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                type: "clarification",
+                                step: 4,
+                                question: "What is your current work phase?",
+                                hint: "e.g., 'pre-launch', 'growth', 'scale', 'maintenance'",
+                                context: `You're considering adding '${args.proposed_tool}'. Is it needed for your current phase, or a future one?`
+                            }, null, 2)
+                        }]
+                };
+            }
+            if (toolList.length >= 9) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                type: "intervention",
+                                step: 5,
+                                status: "SUBSTITUTION_REQUIRED",
+                                question: `Your stack is at capacity (${toolList.length}/9). If '${args.proposed_tool}' joins, what gets removed?`,
+                                current_stack: toolList.map(t => t.name),
+                                proposed_tool: args.proposed_tool,
+                                rule: "No addition without subtraction."
+                            }, null, 2)
+                        }]
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            type: "intervention",
+                            step: 6,
+                            status: "REFLECTION",
+                            question: "Before adding this tool, pause: What internal pattern is driving this consideration?",
+                            prompts: [
+                                "Is this FOMO?",
+                                "Are you in 'expansion-through-addition' mode?",
+                                "What are you avoiding by considering this right now?"
+                            ],
+                            proposed_tool: args.proposed_tool,
+                            current_phase: args.current_phase,
+                            message: "The intervention isn't 'No, don't do that.' It's: Here's your own protocol and how it applies to what you're doing in real-time."
+                        }, null, 2)
+                    }]
+            };
+        }
+        const diagnosis = await PingalaEngine.diagnose({
+            tools: toolList
+        });
+        const rules = MethodologyLoader.load531Rules();
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        type: "diagnosis",
+                        version: "0.4.5 (Horizon 1.5)",
+                        protocol_metadata: {
+                            name: "5:3:1 Protocol",
+                            mapping: rules.rawDescription || "1 Anchor, 3 Active, 5 Supporting",
+                            total_limit: rules.maxTools
+                        },
+                        functional_geometry: {
+                            clusters: toolList.reduce((acc, tool) => {
+                                const fid = tool.functionId || "Unclassified";
+                                if (!acc[fid])
+                                    acc[fid] = { id: fid, primary: tool.name, nodes: [] };
+                                acc[fid].nodes.push({
+                                    name: tool.name,
+                                    context: tool.context,
+                                    is_adapter: tool.isAdapter
+                                });
+                                return acc;
+                            }, {})
+                        },
+                        engagement_reality: {
+                            high_engagement_hubs: engagement.high_engagement.map(t => t.name),
+                            contextual_utilities: engagement.contextual_utility.map(t => t.name),
+                            passive_background: engagement.passive_background.map(t => t.name),
+                            fragmentation_clusters: fragmentation.map(f => f.functionId),
+                            anomalies: anomalies
+                        },
+                        stack_structure: {
+                            anchor: anchors.map(t => t.name),
+                            active: active.map(t => t.name),
+                            supporting: supporting.map(t => t.name)
+                        },
+                        total_tools: toolList.length,
+                        active_hubs: cognitivelyActiveTools,
+                        diagnosis,
+                        life_area_mapping: depth !== "L1" ? new BaguaMapper().mapToolsToAreas(toolList, practitionerMode) : undefined,
+                        inner_diamond: depth === "L3" ? new DiamondMapper().mapToDiamond(toolList, practitionerMode) : undefined,
+                        progression_offer: (depth === "L1" && !ConsentManager.isAuthorized("L2") && Governor.getGovernanceContext().progression.is_l2_eligible) ? {
+                            level: "L2",
+                            message: MethodologyLoader.loadConsentPrompts().l2,
+                            reason: "You have improved your CSI by 10+ points. You've earned a deeper look."
+                        } : undefined,
+                        the_real_question: depth === "L3" ?
+                            "What are you choosing not to see by maintaining this specific friction?" :
+                            "Which 3 apps actually create value in your life, and which are just installed because 'I might need it someday'?"
+                    }, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=cs-audit.js.map

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

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

package/build/tools/get-governance-context.d.ts

@@ -0,0 +1,11 @@
+export declare const getGovernanceContextTool: {
+    name: string;
+    description: string;
+    schema: {};
+    handler: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/tools/get-governance-context.js

@@ -0,0 +1,61 @@
+import { Governor } from "../core/governor.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);
+export const getGovernanceContextTool = {
+    name: "get_governance_context",
+    description: "Returns current stack state for context injection. Use this before making AI suggestions to ensure compliance with user's constraints.",
+    schema: {},
+    handler: async () => {
+        const apiKey = process.env.CSTACK_API_KEY;
+        let context;
+        if (apiKey) {
+            try {
+                const latest = await client.query("stacks:getLatestStack", { operatorHash: apiKey });
+                if (latest) {
+                    const tools = latest.tree;
+                    const slots = {};
+                    tools.forEach(t => {
+                        const fid = t.functionId || "Unclassified";
+                        if (!slots[fid])
+                            slots[fid] = [];
+                        slots[fid].push(t);
+                    });
+                    context = {
+                        core_geometry: latest.geometry.core,
+                        contextual_geometry: latest.geometry.contexts,
+                        functional_slots: Object.entries(slots).map(([id, tools]) => ({
+                            id,
+                            primary_role: tools.find(t => t.role === "Anchor" || t.role === "Active")?.role || "Supporting",
+                            tools: tools.map(t => ({
+                                name: t.name,
+                                role: t.role,
+                                context: t.context,
+                                is_parent: t.is_parent,
+                                is_substack: t.is_substack,
+                                parent_name: t.parent_name
+                            }))
+                        })),
+                        source: "CSTACK API (Convex)"
+                    };
+                }
+            }
+            catch (e) {
+                console.error("Failed to fetch stack from Convex:", e);
+            }
+        }
+        if (!context) {
+            context = {
+                ...Governor.getGovernanceContext(),
+                source: "Local (Fallback)"
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(context, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=get-governance-context.js.map

package/build/tools/get-governance-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-governance-context.js","sourceRoot":"","sources":["../../src/tools/get-governance-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,6CAA6C,CAAC;AAC3F,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,wIAAwI;IACrJ,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,OAAO,CAAC;QAEZ,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,uBAA8B,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC5F,IAAI,MAAM,EAAE,CAAC;oBAET,MAAM,KAAK,GAAG,MAAM,CAAC,IAAa,CAAC;oBAGnC,MAAM,KAAK,GAA0B,EAAE,CAAC;oBACxC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;wBACd,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,IAAI,cAAc,CAAC;wBAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;4BAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;wBACjC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACvB,CAAC,CAAC,CAAC;oBAEH,OAAO,GAAG;wBACN,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;wBACnC,mBAAmB,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;wBAC7C,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC1D,EAAE;4BACF,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,IAAI,IAAI,YAAY;4BAC/F,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gCACnB,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gCAClB,SAAS,EAAE,CAAC,CAAC,SAAS;gCACtB,WAAW,EAAE,CAAC,CAAC,WAAW;gCAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;6BAC7B,CAAC,CAAC;yBACN,CAAC,CAAC;wBACH,MAAM,EAAE,qBAAqB;qBAChC,CAAC;gBACN,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC;QACL,CAAC;QAGD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,GAAG;gBACN,GAAG,QAAQ,CAAC,oBAAoB,EAAE;gBAClC,MAAM,EAAE,kBAAkB;aAC7B,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzC,CAAC;SACL,CAAC;IACN,CAAC;CACJ,CAAC"}

package/build/tools/validate-stack-change.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const validateStackChangeTool: {
+    name: string;
+    description: string;
+    schema: {
+        change_type: z.ZodEnum<{
+            add_tool: "add_tool";
+            remove_tool: "remove_tool";
+            change_role: "change_role";
+            change_anchor: "change_anchor";
+        }>;
+        tool_name: z.ZodString;
+        proposed_role: z.ZodOptional<z.ZodEnum<{
+            Anchor: "Anchor";
+            Active: "Active";
+            Supporting: "Supporting";
+        }>>;
+        function_id: z.ZodOptional<z.ZodString>;
+        contexts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        is_adapter: z.ZodOptional<z.ZodBoolean>;
+        replaces_existing: z.ZodOptional<z.ZodBoolean>;
+        replaced_tool: z.ZodOptional<z.ZodString>;
+        justification: z.ZodOptional<z.ZodString>;
+    };
+    handler: (args: {
+        change_type: "add_tool" | "remove_tool" | "change_role" | "change_anchor";
+        tool_name: string;
+        proposed_role?: "Anchor" | "Active" | "Supporting";
+        function_id?: string;
+        contexts?: string[];
+        is_adapter?: boolean;
+        replaces_existing?: boolean;
+        replaced_tool?: string;
+        justification?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

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

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { Governor } from "../core/governor.js";
+import { flushTelemetry } from "../core/sdk-adapter.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);
+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) => {
+        const apiKey = process.env.CSTACK_API_KEY;
+        let currentStack;
+        if (apiKey) {
+            try {
+                const latest = await client.query("stacks:getLatestStack", { operatorHash: apiKey });
+                if (latest) {
+                    currentStack = latest.tree;
+                }
+            }
+            catch (e) {
+                console.error("Failed to fetch stack for change validation:", e);
+            }
+        }
+        Governor.recordValidation(!!args.justification);
+        const result = Governor.validateStackChange({
+            ...args,
+            type: args.change_type,
+            functionId: args.function_id,
+            isAdapter: args.is_adapter
+        }, currentStack);
+        flushTelemetry().catch((err) => console.error("Telemetry sync failed", err));
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        ...result,
+                        source: currentStack ? "CSTACK API (Convex)" : "Local (Fallback)"
+                    }, null, 2)
+                }]
+        };
+    }
+};
+//# sourceMappingURL=validate-stack-change.js.map

package/build/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":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@cstack-protocol/pingala",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "pingala": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "Faiabrand Pte Ltd",
+  "license": "ISC",
+  "description": "The official governance layer for the Conscious Stack ecosystem.",
+  "dependencies": {
+    "@cstack-protocol/sdk": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "convex": "^1.31.7",
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/cloud-bridge.js

@@ -0,0 +1,62 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+/**
+ * Pingala Cloud Bridge
+ * Connects Claude Desktop (Stdio) to Vercel (SSE).
+ */
+
+async function main() {
+    const token = process.env.PINGALA_TOKEN;
+    const url = "https://mcp.consciousstack.com/sse";
+
+    if (!token) {
+        console.error("Error: PINGALA_TOKEN environment variable is required.");
+        process.exit(1);
+    }
+
+    try {
+        // 1. Connect to the Remote SSE Server
+        const transport = new SSEClientTransport(new URL(url), {
+            eventSourceInitDict: {
+                headers: {
+                    "Authorization": `Bearer ${token}`
+                }
+            }
+        });
+
+        const client = new Client({
+            name: "pingala-cloud-proxy",
+            version: "1.0.0"
+        }, {
+            capabilities: {}
+        });
+
+        await client.connect(transport);
+
+        // 2. Create a local Proxy Server that Claude talks to via Stdio
+        const server = new Server({
+            name: "pingala-cloud",
+            version: "1.0.0"
+        }, {
+            capabilities: client.getServerCapabilities() || {}
+        });
+
+        // Proxy all requests
+        server.setRequestHandler(null, async (request) => {
+            return await client.request(request, request.schema);
+        });
+
+        const stdioTransport = new StdioServerTransport();
+        await server.connect(stdioTransport);
+
+        console.error("📡 Pingala Cloud Bridge: Active & Connected.");
+    } catch (err) {
+        console.error("❌ Pingala Cloud Bridge: Connection failed.", err);
+        process.exit(1);
+    }
+}
+
+main().catch(console.error);

package/scripts/generate-token.js

@@ -0,0 +1,13 @@
+import { randomBytes } from 'node:crypto';
+
+/**
+ * Generates a random token for Inner Circle access.
+ */
+const generateToken = () => {
+    return randomBytes(16).toString('hex');
+};
+
+console.log("--- New Pingala Governance Token ---");
+console.log(generateToken());
+console.log("------------------------------------");
+console.log("Add this to your Vercel env: VALID_TOKENS=token1,token2");