@cstack-protocol/pingala 1.0.0

package/build/pingala-mcp/src/core/consent-manager.js

@@ -0,0 +1,104 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import process from "node:process";
+import yaml from "js-yaml";
+export class ConsentManager {
+    static dataDir = process.env.CSTACK_DATA_DIR || path.join(os.homedir(), ".cstack-data");
+    static globalConsentFile = "consent-state.json";
+    static workspacePath = null;
+    static setWorkspace(workspacePath) {
+        this.workspacePath = workspacePath;
+    }
+    static getFilePath() {
+        if (this.workspacePath) {
+            const agentDir = path.join(this.workspacePath, ".agent");
+            if (fs.existsSync(agentDir)) {
+                return path.join(agentDir, "governance.yaml");
+            }
+        }
+        if (!fs.existsSync(this.dataDir)) {
+            fs.mkdirSync(this.dataDir, { recursive: true });
+        }
+        return path.join(this.dataDir, this.globalConsentFile);
+    }
+    static getConsentState() {
+        const filePath = this.getFilePath();
+        const defaultState = {
+            l2_accepted: false,
+            l3_accepted: false
+        };
+        if (fs.existsSync(filePath)) {
+            try {
+                const content = fs.readFileSync(filePath, "utf-8");
+                if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+                    const parsed = yaml.load(content);
+                    return {
+                        l2_accepted: parsed?.consent?.l2_accepted ?? false,
+                        l2_accepted_at: parsed?.consent?.l2_accepted_at,
+                        l3_accepted: parsed?.consent?.l3_accepted ?? false,
+                        l3_accepted_at: parsed?.consent?.l3_accepted_at
+                    };
+                }
+                else {
+                    return JSON.parse(content);
+                }
+            }
+            catch (e) {
+                console.error(`[ConsentManager] Error reading consent from ${filePath}:`, e);
+                return defaultState;
+            }
+        }
+        return defaultState;
+    }
+    static setConsent(level, accepted) {
+        const filePath = this.getFilePath();
+        const state = this.getConsentState();
+        if (level === 'L2') {
+            state.l2_accepted = accepted;
+            if (accepted)
+                state.l2_accepted_at = new Date().toISOString();
+        }
+        else if (level === 'L3') {
+            state.l3_accepted = accepted;
+            if (accepted)
+                state.l3_accepted_at = new Date().toISOString();
+        }
+        try {
+            if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+                let existing = {};
+                if (fs.existsSync(filePath)) {
+                    existing = yaml.load(fs.readFileSync(filePath, "utf-8")) || {};
+                }
+                existing.consent = state;
+                fs.writeFileSync(filePath, yaml.dump(existing, { indent: 2 }));
+            }
+            else {
+                fs.writeFileSync(filePath, JSON.stringify(state, null, 2));
+            }
+        }
+        catch (e) {
+            console.error(`[ConsentManager] Error writing consent to ${filePath}:`, e);
+        }
+    }
+    static isAuthorized(level, practitionerOverride = false) {
+        if (level === 'L1')
+            return true;
+        const state = this.getConsentState();
+        if (level === 'L2') {
+            return practitionerOverride || state.l2_accepted;
+        }
+        if (level === 'L3') {
+            return practitionerOverride || (this.isAuthorized('L2', false) && state.l3_accepted);
+        }
+        return false;
+    }
+    static getCurrentConsentLevel() {
+        if (this.isAuthorized('L3'))
+            return 3;
+        if (this.isAuthorized('L2'))
+            return 2;
+        return 1;
+    }
+}
+//# sourceMappingURL=consent-manager.js.map

package/build/pingala-mcp/src/core/consent-manager.js.map

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

package/build/pingala-mcp/src/core/csp.d.ts

@@ -0,0 +1,12 @@
+import { type ValidationResult as RuleValidation } from './531-rule.js';
+export interface CSPCompliance {
+    version: '1.0';
+    is_compliant: boolean;
+    rule_validation: RuleValidation;
+    consent_level: number;
+    maturity_level: number;
+}
+export declare class ConsciousStackProtocol {
+    static readonly VERSION = "1.0";
+    static getCompliance(): CSPCompliance;
+}

package/build/pingala-mcp/src/core/csp.js

@@ -0,0 +1,20 @@
+import { Rule531 } from './531-rule.js';
+import { Governor } from './governor.js';
+import { ConsentManager } from './consent-manager.js';
+export class ConsciousStackProtocol {
+    static VERSION = '1.0';
+    static getCompliance() {
+        const stack = Governor.getStack();
+        const ruleValidation = Rule531.validate({ tools: stack });
+        const maturityState = Governor.getMaturityState();
+        const consentLevel = ConsentManager.getCurrentConsentLevel();
+        return {
+            version: this.VERSION,
+            is_compliant: ruleValidation.isValid,
+            rule_validation: ruleValidation,
+            consent_level: consentLevel,
+            maturity_level: maturityState.level
+        };
+    }
+}
+//# sourceMappingURL=csp.js.map

package/build/pingala-mcp/src/core/csp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp.js","sourceRoot":"","sources":["../../../../src/core/csp.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAA2C,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUtD,MAAM,OAAO,sBAAsB;IAC/B,MAAM,CAAU,OAAO,GAAG,KAAK,CAAC;IAMhC,MAAM,CAAC,aAAa;QAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,cAAc,CAAC,sBAAsB,EAAE,CAAC;QAE7D,OAAO;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,cAAc,CAAC,OAAO;YACpC,eAAe,EAAE,cAAc;YAC/B,aAAa,EAAE,YAAY;YAC3B,cAAc,EAAE,aAAa,CAAC,KAAK;SACtC,CAAC;IACN,CAAC"}

package/build/pingala-mcp/src/core/engagement-analyzer.d.ts

@@ -0,0 +1,42 @@
+import { type ToolInstance } from "./531-rule.js";
+export interface EngagementProfile {
+    tier: 'high_engagement' | 'contextual_utility' | 'passive_background' | 'fragmentation_risk';
+    avgDailyMinutes?: number;
+    usagePattern?: 'consistent' | 'sporadic' | 'single_spike';
+    anomalyFlag?: boolean;
+    anomalyNote?: string;
+}
+export interface ToolWithEngagement extends ToolInstance {
+    avgDailyMinutes?: number;
+    usagePattern?: 'consistent' | 'sporadic' | 'single_spike';
+    engagement?: EngagementProfile;
+}
+export interface EngagementAnalysis {
+    high_engagement: ToolWithEngagement[];
+    contextual_utility: ToolWithEngagement[];
+    passive_background: ToolWithEngagement[];
+    fragmentation_risk: ToolWithEngagement[];
+}
+export declare class EngagementAnalyzer {
+    static classifyByEngagement(tools: ToolWithEngagement[]): EngagementAnalysis;
+    static detectFragmentation(tools: ToolWithEngagement[]): {
+        functionId: string;
+        tools: string[];
+        primary: string;
+    }[];
+    static flagAnomalies(tools: ToolWithEngagement[]): {
+        tool: string;
+        anomaly: string;
+        note: string;
+    }[];
+    static identifyAnchorEnvironment(tools: ToolWithEngagement[]): {
+        hasAnchor: boolean;
+        observation: string;
+        hint: string;
+    } | {
+        hasAnchor: boolean;
+        observation?: undefined;
+        hint?: undefined;
+    };
+    static getFragmentationScore(tools: ToolWithEngagement[]): number;
+}

package/build/pingala-mcp/src/core/engagement-analyzer.js

@@ -0,0 +1,71 @@
+export class EngagementAnalyzer {
+    static classifyByEngagement(tools) {
+        const analysis = {
+            high_engagement: [],
+            contextual_utility: [],
+            passive_background: [],
+            fragmentation_risk: []
+        };
+        tools.forEach(tool => {
+            const minutes = tool.avgDailyMinutes ?? 0;
+            const pattern = tool.usagePattern ?? 'sporadic';
+            if (minutes >= 15 || (minutes >= 10 && pattern === 'consistent')) {
+                analysis.high_engagement.push(tool);
+            }
+            else if (minutes > 5 || (minutes > 0 && pattern === 'consistent')) {
+                analysis.contextual_utility.push(tool);
+            }
+            else {
+                analysis.passive_background.push(tool);
+            }
+        });
+        return analysis;
+    }
+    static detectFragmentation(tools) {
+        const clusters = {};
+        tools.forEach(tool => {
+            const functionKey = tool.functionId || tool.category || "Uncategorized";
+            if (functionKey === "Uncategorized")
+                return;
+            if (!clusters[functionKey])
+                clusters[functionKey] = [];
+            clusters[functionKey].push(tool);
+        });
+        return Object.entries(clusters)
+            .filter(([_, t]) => t.length > 1)
+            .map(([id, t]) => ({
+            functionId: id,
+            tools: t.map(tool => tool.name),
+            primary: t.reduce((prev, current) => (prev.avgDailyMinutes || 0) > (current.avgDailyMinutes || 0) ? prev : current).name
+        }));
+    }
+    static flagAnomalies(tools) {
+        return tools
+            .filter(t => t.usagePattern === 'single_spike' && (t.avgDailyMinutes || 0) > 60)
+            .map(t => ({
+            tool: t.name,
+            anomaly: `${t.avgDailyMinutes} min spike detected`,
+            note: "Likely a contextual event (meeting, interview, accident) rather than a persistent stack requirement."
+        }));
+    }
+    static identifyAnchorEnvironment(tools) {
+        const hasChromeOrDesktopAnchor = tools.some(t => t.role === 'Anchor' &&
+            (t.name.toLowerCase().includes('chrome') || t.contexts?.includes('desktop')));
+        const highUseMobile = tools.filter(t => (t.avgDailyMinutes || 0) > 20);
+        if (!hasChromeOrDesktopAnchor && highUseMobile.length > 0) {
+            return {
+                hasAnchor: false,
+                observation: "System appears mobile-native or fragmented. No clear 'Anchor' environment detected.",
+                hint: "Is your work moving through intentional slots, or are you operating in a reactive mobile-check-in loop?"
+            };
+        }
+        return { hasAnchor: true };
+    }
+    static getFragmentationScore(tools) {
+        const fragClusters = this.detectFragmentation(tools);
+        if (fragClusters.length === 0)
+            return 100;
+        return Math.max(0, 100 - (fragClusters.length * 20));
+    }
+}
+//# sourceMappingURL=engagement-analyzer.js.map

package/build/pingala-mcp/src/core/engagement-analyzer.js.map

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

package/build/pingala-mcp/src/core/governor.d.ts

@@ -0,0 +1,104 @@
+import { type ToolInstance } from "./531-rule.js";
+export interface MaturityState {
+    level: number;
+    level_name: string;
+    stability_days: number;
+    last_changed_at: string;
+    definition?: string;
+    primary_action?: string;
+    telemetry?: {
+        attention_depth: number;
+        dependency_exposure: number;
+        last_updated: string;
+    };
+    decision_stats?: {
+        total_validations: number;
+        justified_validations: number;
+    };
+    csi_baseline?: number;
+    csi_latest?: number;
+}
+export interface ProposedChange {
+    type: 'add_tool' | 'remove_tool' | 'change_role' | 'change_anchor' | 'audit';
+    tool_name: string;
+    proposed_role?: 'Anchor' | 'Active' | 'Supporting';
+    functionId?: string;
+    contexts?: string[];
+    isAdapter?: boolean;
+    replaces_existing?: boolean;
+    replaced_tool?: string;
+    justification?: string;
+}
+export interface GovernanceContext {
+    current_stack: {
+        anchor: ToolInstance | null;
+        active: ToolInstance[];
+        supporting: ToolInstance[];
+    };
+    functional_nodes: {
+        id: string;
+        role: string;
+        tools: string[];
+    }[];
+    maturity_level: number;
+    maturity_name: string;
+    stability_days: number;
+    csi_latest: number;
+    allowed_actions: string[];
+    blocked_actions: string[];
+    progression: {
+        can_level_up: boolean;
+        next_level: number | null;
+        days_remaining: number;
+        csi_delta: number;
+        is_l2_eligible: boolean;
+    };
+}
+export declare class Governor {
+    private static dataDir;
+    private static getFilePath;
+    static getStack(): ToolInstance[];
+    static saveStack(tools: ToolInstance[]): void;
+    static getMaturityState(): MaturityState;
+    static saveMaturityState(state: MaturityState): void;
+    static recordTelemetry(data: {
+        attention_depth?: number;
+        dependency_exposure?: number;
+    }): void;
+    static recordValidation(justified: boolean): void;
+    static updateCsi(score: number): void;
+    static getDecisionProvenanceScore(): number;
+    static getStackDriftScore(): {
+        score: number;
+        signals: string[];
+        summary: string;
+    };
+    static validateStackChange(change: ProposedChange): {
+        allowed: boolean;
+        reason: string;
+        alternatives: string[];
+    } | {
+        allowed: boolean;
+        reason?: undefined;
+        alternatives?: undefined;
+    } | {
+        allowed: boolean;
+        reason?: undefined;
+        gate_requirements?: undefined;
+    } | {
+        allowed: boolean;
+        reason: string;
+        gate_requirements: any;
+    } | {
+        allowed: boolean;
+        reason: string;
+        impact: {
+            stability_reset: boolean;
+            new_stability_days: number;
+        };
+    };
+    private static check531Rules;
+    private static enforceMaturityGates;
+    static getGovernanceContext(): GovernanceContext;
+    private static getNextGateRequiredDays;
+}