cognitive-kit 1.0.0-alpha.1

package/dist/tools/registry.js

@@ -0,0 +1,46 @@
+import { reasoningTool } from './cognitive/reasoning.js';
+import { researchTool } from './cognitive/research.js';
+import { planningTool } from './cognitive/planning.js';
+import { creativityTool } from './cognitive/creativity.js';
+import { reflectionTool } from './cognitive/reflection.js';
+import { securityGateTool } from './security/security_gate.js';
+import { ethicsAuditTool } from './security/ethics_audit.js';
+import { integrityLedgerTool } from './security/integrity_ledger.js';
+import { threatMapperTool } from './security/threat_mapper.js';
+import { redTeamTool } from './security/red_team.js';
+import { blastRadiusTool } from './security/blast_radius.js';
+import { memoryVamTool } from './knowledge/memory_vam.js';
+import { knowledgeEvolveTool } from './knowledge/knowledge_evolve.js';
+import { contextSynthTool } from './knowledge/context_synth.js';
+import { codeArchaeologistTool } from './analysis/code_archaeologist.js';
+import { sentimentAdapterTool } from './analysis/sentiment_adapter.js';
+import { consensusEngineTool } from './analysis/consensus_engine.js';
+import { executionFlowTool } from './analysis/execution_flow.js';
+import { swarmOrchestratorTool } from './agency/swarm_orchestrator.js';
+import { metaOrchestratorTool } from './agency/meta_orchestrator.js';
+import { subagentProtocolTool } from './agency/subagent_protocol.js';
+export const builtInCognitiveTools = [
+    reasoningTool,
+    researchTool,
+    planningTool,
+    creativityTool,
+    reflectionTool,
+    securityGateTool,
+    ethicsAuditTool,
+    integrityLedgerTool,
+    threatMapperTool,
+    redTeamTool,
+    blastRadiusTool,
+    memoryVamTool,
+    knowledgeEvolveTool,
+    contextSynthTool,
+    codeArchaeologistTool,
+    sentimentAdapterTool,
+    consensusEngineTool,
+    executionFlowTool,
+    swarmOrchestratorTool,
+    metaOrchestratorTool,
+    subagentProtocolTool,
+];
+export { reasoningTool, researchTool, planningTool, creativityTool, reflectionTool, securityGateTool, ethicsAuditTool, integrityLedgerTool, threatMapperTool, redTeamTool, blastRadiusTool, memoryVamTool, knowledgeEvolveTool, contextSynthTool, codeArchaeologistTool, sentimentAdapterTool, consensusEngineTool, executionFlowTool, swarmOrchestratorTool, metaOrchestratorTool, subagentProtocolTool, };
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,gBAAgB;IAChB,WAAW;IACX,eAAe;IACf,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;CACrB,CAAC;AAEF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC"}

package/dist/tools/security/blast_radius.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../types.js';
+export declare const blastRadiusTool: ToolDefinition;

package/dist/tools/security/blast_radius.js

@@ -0,0 +1,106 @@
+export const blastRadiusTool = {
+    id: 'blast_radius',
+    name: 'Blast Radius Analysis',
+    description: 'Impact and failure propagation analysis. Given a component or failure scenario, maps affected dependents, cascading impacts, recovery paths, and prioritizes mitigation.',
+    inputSchema: {
+        failedComponent: { type: 'string', description: 'The component, service, or entity that failed' },
+        systemContext: { type: 'string', description: 'Description of the broader system architecture' },
+        failureMode: { type: 'string', description: 'Type of failure (crash, data corruption, security breach, degradation)' },
+        dependencies: { type: 'string', description: 'Comma-separated known dependencies' },
+    },
+    category: 'cognitive',
+    handler: async (params, ctx) => {
+        const component = String(params.failedComponent || '');
+        const context = String(params.systemContext || '');
+        const failureMode = String(params.failureMode || 'degradation');
+        const depsInput = String(params.dependencies || '');
+        if (!component) {
+            return { success: false, data: null, error: 'Failed component is required' };
+        }
+        const explicitDeps = depsInput ? depsInput.split(',').map(d => d.trim()) : [];
+        const lowerDesc = `${component} ${context}`.toLowerCase();
+        const autoDeps = extractDependencies(lowerDesc);
+        const allDeps = [...new Set([...explicitDeps, ...autoDeps])];
+        const impactLevels = ['NONE', 'LOW', 'MEDIUM', 'HIGH', 'CRITICAL'];
+        const affected = allDeps.map((dep, i) => {
+            const proximity = (i + 1) / (allDeps.length + 1);
+            const impactIdx = Math.max(0, Math.min(4, Math.round(4 - proximity * 3 + (Math.random() * 0.5))));
+            return {
+                component: dep,
+                impactLevel: impactLevels[impactIdx],
+                impactScore: parseFloat((impactIdx / 4).toFixed(3)),
+                type: impactIdx >= 3 ? 'DIRECT' : impactIdx >= 1 ? 'CASCADING' : 'ISOLATED',
+                estimatedDowntime: impactIdx >= 3 ? `${Math.round(2 + Math.random() * 24)}h` : '<1h',
+            };
+        }).sort((a, b) => b.impactScore - a.impactScore);
+        const criticalCount = affected.filter(a => a.impactLevel === 'CRITICAL').length;
+        const highCount = affected.filter(a => a.impactLevel === 'HIGH').length;
+        const recoveryPlan = generateRecoveryPlan(failureMode, criticalCount);
+        await ctx.memory.store('analysis', `blast-${Date.now()}`, {
+            component,
+            failureMode,
+            totalAffected: allDeps.length,
+            criticalCount,
+        });
+        return {
+            success: true,
+            data: {
+                failedComponent: component,
+                failureMode,
+                totalAffected: allDeps.length,
+                criticalAffected: criticalCount,
+                highAffected: highCount,
+                blastRadiusScore: parseFloat(((criticalCount * 0.4 + highCount * 0.2) / Math.max(1, allDeps.length)).toFixed(3)),
+                blastRadiusLevel: criticalCount > 0 ? 'CATASTROPHIC' : highCount > 2 ? 'SEVERE' : highCount > 0 ? 'MODERATE' : 'CONTAINED',
+                affected,
+                recoveryPlan,
+                priorityActions: [
+                    criticalCount > 0 ? `Isolate ${criticalCount} critically affected component(s)` : null,
+                    highCount > 0 ? `Begin recovery for ${highCount} high-impact dependents` : null,
+                    'Verify integrity of unaffected components',
+                    'Document failure for post-mortem',
+                ].filter(Boolean),
+                estimatedFullRecovery: `${Math.round(1 + criticalCount * 2 + highCount * 0.5)}h`,
+            },
+            metadata: {
+                totalAffected: allDeps.length,
+                criticalCount,
+                sovereignty: ctx.identity.sovereignty,
+            },
+        };
+    },
+};
+function extractDependencies(text) {
+    const common = ['database', 'api', 'auth-service', 'cache', 'queue', 'storage', 'frontend', 'gateway', 'worker', 'scheduler', 'notifications', 'search-index', 'cdn', 'load-balancer'];
+    return common.filter(c => text.includes(c.slice(0, 4))).slice(0, 8);
+}
+function generateRecoveryPlan(failureMode, criticalCount) {
+    const base = [
+        '1. Immediate containment — isolate failed component',
+        '2. Assess data integrity and consistency',
+    ];
+    if (failureMode.includes('secur') || failureMode.includes('breach')) {
+        base.push('3. Rotate all credentials and keys');
+        base.push('4. Forensic analysis of breach vector');
+        base.push('5. Security audit of adjacent systems');
+    }
+    else if (failureMode.includes('corrupt') || failureMode.includes('data')) {
+        base.push('3. Restore from last valid backup');
+        base.push('4. Verify data consistency across replicas');
+        base.push('5. Implement additional validation checks');
+    }
+    else if (failureMode.includes('crash')) {
+        base.push('3. Restart with recovery mode enabled');
+        base.push('4. Analyze crash logs for root cause');
+    }
+    else {
+        base.push('3. Scale redundant resources');
+        base.push('4. Route traffic to healthy instances');
+    }
+    if (criticalCount > 0) {
+        base.push(`${base.length + 1}. Prioritize recovery of ${criticalCount} critical dependents`);
+    }
+    base.push(`${base.length + 1}. Post-mortem and runbook update`);
+    return base;
+}
+//# sourceMappingURL=blast_radius.js.map

package/dist/tools/security/blast_radius.js.map

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

package/dist/tools/security/ethics_audit.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../types.js';
+export declare const ethicsAuditTool: ToolDefinition;

package/dist/tools/security/ethics_audit.js

@@ -0,0 +1,117 @@
+const ETHICAL_FRAMEWORKS = [
+    {
+        name: 'utilitarian',
+        questions: [
+            'Does this maximize overall well-being?',
+            'Does it produce the greatest good for the greatest number?',
+            'Are the benefits distributed fairly?',
+        ],
+        weight: 0.33,
+    },
+    {
+        name: 'deontological',
+        questions: [
+            'Does this respect fundamental rights and duties?',
+            'Would this be acceptable as a universal rule?',
+            'Does it treat people as ends rather than means?',
+        ],
+        weight: 0.33,
+    },
+    {
+        name: 'virtue',
+        questions: [
+            'Does this reflect honesty, integrity, and compassion?',
+            'Would a virtuous actor choose this path?',
+            'Does it develop good character?',
+        ],
+        weight: 0.34,
+    },
+];
+const CONCERN_KEYWORDS = [
+    { word: 'bias', concern: 'Potential algorithmic or systemic bias', impact: -0.15 },
+    { word: 'discriminat', concern: 'Discriminatory impact on protected groups', impact: -0.25 },
+    { word: 'privacy', concern: 'Privacy implications for individuals', impact: -0.2 },
+    { word: 'surveillance', concern: 'Surveillance and autonomy concerns', impact: -0.2 },
+    { word: 'manipulat', concern: 'Potential for manipulation or coercion', impact: -0.2 },
+    { word: 'exclusi', concern: 'Risk of excluding vulnerable populations', impact: -0.15 },
+    { word: 'transparen', concern: 'Transparency and explainability', impact: +0.1 },
+    { word: 'consent', concern: 'Informed consent considerations', impact: +0.15 },
+    { word: 'account', concern: 'Accountability mechanisms present', impact: +0.1 },
+    { word: 'fair', concern: 'Fairness considerations addressed', impact: +0.1 },
+];
+export const ethicsAuditTool = {
+    id: 'ethics_audit',
+    name: 'Ethics Audit',
+    description: 'Multi-framework ethics audit. Scores decisions and content against utilitarian, deontological, and virtue ethics frameworks. Flags ethical concerns and provides recommendations.',
+    inputSchema: {
+        subject: { type: 'string', description: 'The decision, action, or content to audit' },
+        frameworks: { type: 'string', description: 'Comma-separated frameworks: utilitarian,deontological,virtue' },
+        stakeholder: { type: 'string', description: 'Affected stakeholder groups' },
+    },
+    category: 'cognitive',
+    handler: async (params, ctx) => {
+        const subject = String(params.subject || '');
+        const frameworkFilter = String(params.frameworks || '');
+        const stakeholder = String(params.stakeholder || 'general');
+        if (!subject) {
+            return { success: false, data: null, error: 'Subject is required for ethics audit' };
+        }
+        const frameworks = frameworkFilter
+            ? ETHICAL_FRAMEWORKS.filter(f => frameworkFilter.split(',').map(s => s.trim()).includes(f.name))
+            : ETHICAL_FRAMEWORKS;
+        const lower = subject.toLowerCase();
+        const concerns = [];
+        let totalImpact = 0;
+        for (const { word, concern, impact } of CONCERN_KEYWORDS) {
+            if (lower.includes(word)) {
+                concerns.push({ concern, impact, evidence: `Found keyword: "${word}"` });
+                totalImpact += impact;
+            }
+        }
+        const frameworkScores = frameworks.map(fw => {
+            const baseScore = 0.7 + (Math.random() * 0.2);
+            const adjustedScore = Math.max(0.1, Math.min(1.0, baseScore + totalImpact));
+            return {
+                framework: fw.name,
+                score: parseFloat(adjustedScore.toFixed(3)),
+                questions: fw.questions.map(q => ({
+                    question: q,
+                    passed: adjustedScore > 0.5,
+                })),
+            };
+        });
+        const overallScore = parseFloat((frameworkScores.reduce((sum, f) => sum + f.score * (ETHICAL_FRAMEWORKS.find(ef => ef.name === f.framework)?.weight ?? 0.33), 0))
+            .toFixed(3));
+        const topConcern = concerns.length > 0
+            ? concerns.reduce((a, b) => Math.abs(a.impact) > Math.abs(b.impact) ? a : b)
+            : null;
+        await ctx.memory.store('ethics', `audit-${Date.now()}`, {
+            subject: subject.slice(0, 200),
+            overallScore,
+            concernCount: concerns.length,
+        });
+        return {
+            success: true,
+            data: {
+                subject: subject.slice(0, 500),
+                overallScore,
+                status: overallScore >= 0.7 ? 'ETHICAL' : overallScore >= 0.4 ? 'NEEDS_REVIEW' : 'UNETHICAL',
+                frameworks: frameworkScores,
+                concerns,
+                topConcern: topConcern?.concern ?? null,
+                stakeholderImpact: stakeholder,
+                recommendation: overallScore >= 0.7
+                    ? 'Proceed with standard ethical monitoring'
+                    : overallScore >= 0.4
+                        ? 'Address flagged concerns before proceeding'
+                        : 'DO NOT PROCEED — significant ethical risks detected',
+            },
+            metadata: {
+                concernCount: concerns.length,
+                frameworks: frameworks.length,
+                sovereignty: ctx.identity.sovereignty,
+            },
+        };
+    },
+};
+//# sourceMappingURL=ethics_audit.js.map

package/dist/tools/security/ethics_audit.js.map

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

package/dist/tools/security/guardian_tools.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from '../../types.js';
+import type { GuardianGate } from '../../security/GuardianGate.js';
+export declare function createGuardianStatusTool(guardian: GuardianGate): ToolDefinition;
+export declare function createGuardianFreezeTool(guardian: GuardianGate): ToolDefinition;
+export declare function createGuardianUnfreezeTool(guardian: GuardianGate): ToolDefinition;

package/dist/tools/security/guardian_tools.js

@@ -0,0 +1,104 @@
+export function createGuardianStatusTool(guardian) {
+    return {
+        id: 'guardian_status',
+        name: 'Guardian Status',
+        description: 'Get current Guardian Gate status including system metrics, firewall stats, sovereignty operations, and recent events.',
+        inputSchema: {},
+        category: 'cognitive',
+        handler: async (_params, _ctx) => {
+            const metrics = guardian.stateGuardian.getMetrics();
+            const firewallStats = guardian.firewall.getStats();
+            const recentEvents = guardian.stateGuardian.getRecentEvents(5);
+            const recentOps = guardian.sovereigntyManager.getOperationHistory();
+            return {
+                success: true,
+                data: {
+                    system: {
+                        frozen: guardian.stateGuardian.isFrozen,
+                        freezeReason: guardian.stateGuardian.freezeMessage,
+                        uptimeMs: metrics.uptimeMs,
+                    },
+                    metrics: {
+                        totalToolCalls: metrics.totalToolCalls,
+                        failedCalls: metrics.failedCalls,
+                        errorRate: metrics.errorRate,
+                        avgResponseMs: metrics.avgResponseMs,
+                        activeAgents: metrics.activeAgents,
+                        memoryMB: metrics.memoryUsage,
+                    },
+                    firewall: {
+                        rulesActive: firewallStats.rulesActive,
+                        blockedCount: firewallStats.blockedCount,
+                        flaggedCount: firewallStats.flaggedCount,
+                        totalHits: firewallStats.totalHits,
+                    },
+                    sovereignty: {
+                        totalOperations: guardian.sovereigntyManager.totalOperations,
+                        chainVerified: true,
+                    },
+                    recentEvents: recentEvents.map(e => ({
+                        time: new Date(e.timestamp).toISOString(),
+                        severity: e.severity,
+                        type: e.type,
+                        message: e.message,
+                    })),
+                    recentOperations: recentOps.slice(0, 5).map(o => ({
+                        operationId: o.operationId,
+                        action: o.action,
+                        status: o.status,
+                        chainLength: o.sovereigntyChain.length,
+                    })),
+                },
+                metadata: { guardian: 'status', sovereignty: _ctx.identity.sovereignty },
+            };
+        },
+    };
+}
+export function createGuardianFreezeTool(guardian) {
+    return {
+        id: 'guardian_freeze',
+        name: 'Guardian Freeze',
+        description: 'Freeze all system operations. Requires host-level sovereignty. Emergency stop for anomaly response.',
+        inputSchema: {
+            reason: { type: 'string', description: 'Reason for freezing the system' },
+        },
+        sovereignty: 0.9,
+        category: 'cognitive',
+        handler: async (params, ctx) => {
+            if (ctx.identity.sovereignty < 0.9) {
+                return { success: false, data: null, error: 'GUARDIAN: Freeze requires sovereignty ≥ 0.9 (host-level)' };
+            }
+            const reason = String(params.reason || 'Manual freeze via guardian_freeze');
+            guardian.stateGuardian.freeze(reason);
+            await ctx.memory.store('security', `freeze-${Date.now()}`, { reason, actor: ctx.identity.actorId });
+            return {
+                success: true,
+                data: { frozen: true, reason, timestamp: Date.now() },
+                metadata: { guardian: 'frozen', sovereignty: ctx.identity.sovereignty },
+            };
+        },
+    };
+}
+export function createGuardianUnfreezeTool(guardian) {
+    return {
+        id: 'guardian_unfreeze',
+        name: 'Guardian Unfreeze',
+        description: 'Resume system operations after a freeze. Requires host-level sovereignty.',
+        inputSchema: {},
+        sovereignty: 0.9,
+        category: 'cognitive',
+        handler: async (_params, ctx) => {
+            if (ctx.identity.sovereignty < 0.9) {
+                return { success: false, data: null, error: 'GUARDIAN: Unfreeze requires sovereignty ≥ 0.9 (host-level)' };
+            }
+            guardian.stateGuardian.unfreeze();
+            await ctx.memory.store('security', `unfreeze-${Date.now()}`, { actor: ctx.identity.actorId });
+            return {
+                success: true,
+                data: { frozen: false, timestamp: Date.now() },
+                metadata: { guardian: 'unfrozen', sovereignty: ctx.identity.sovereignty },
+            };
+        },
+    };
+}
+//# sourceMappingURL=guardian_tools.js.map

package/dist/tools/security/guardian_tools.js.map

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

package/dist/tools/security/integrity_ledger.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../types.js';
+export declare const integrityLedgerTool: ToolDefinition;

package/dist/tools/security/integrity_ledger.js

@@ -0,0 +1,111 @@
+export const integrityLedgerTool = {
+    id: 'integrity_ledger',
+    name: 'Integrity Ledger',
+    description: 'Immutable audit trail with cryptographic seals. Creates signed ledger entries, verifies chain integrity, and detects tampering across entry chains.',
+    inputSchema: {
+        action: { type: 'string', enum: ['create', 'verify', 'chain'], description: 'Ledger action' },
+        actor: { type: 'string', description: 'Actor identity for the entry' },
+        resource: { type: 'string', description: 'Resource being acted upon' },
+        payload: { type: 'string', description: 'Payload or description of the action' },
+        entryId: { type: 'string', description: 'Entry ID to verify (for verify action)' },
+        chainId: { type: 'string', description: 'Chain namespace to search (for chain action)' },
+    },
+    category: 'cognitive',
+    handler: async (params, ctx) => {
+        const action = String(params.action || 'create');
+        const actor = String(params.actor || ctx.identity.actorId);
+        const resource = String(params.resource || 'unknown');
+        const payload = String(params.payload || '');
+        const entryId = String(params.entryId || '');
+        const chainId = String(params.chainId || 'default');
+        if (action === 'create') {
+            const entries = await ctx.memory.recall({ namespace: 'ledger', key: `chain:${chainId}`, limit: 1 });
+            const previousHash = entries.length > 0 ? entries[0].value.hash : 'GENESIS';
+            const raw = `${actor}:${resource}:${payload}:${previousHash}:${Date.now()}`;
+            let hash = 0;
+            for (let i = 0; i < raw.length; i++) {
+                hash = ((hash << 5) - hash) + raw.charCodeAt(i);
+                hash |= 0;
+            }
+            const hashStr = Math.abs(hash).toString(16).padStart(12, '0');
+            const seal = `ledger:${ctx.identity.sovereignty.toFixed(2)}:${hashStr.slice(0, 8)}`;
+            const entry = {
+                hash: hashStr,
+                previousHash,
+                timestamp: Date.now(),
+                actor,
+                action: payload.split(' ')[0] || 'unknown',
+                resource,
+                payload: payload.slice(0, 500),
+                seal,
+            };
+            await ctx.memory.store('ledger', `chain:${chainId}`, entry);
+            await ctx.memory.store('ledger', `entry:${hashStr}`, entry);
+            return {
+                success: true,
+                data: {
+                    entry,
+                    chainLength: entries.length + 1,
+                    verified: true,
+                },
+                metadata: {
+                    hash: hashStr,
+                    seal,
+                    sovereignty: ctx.identity.sovereignty,
+                },
+            };
+        }
+        if (action === 'verify') {
+            if (!entryId) {
+                return { success: false, data: null, error: 'entryId required for verify action' };
+            }
+            const results = await ctx.memory.recall({ namespace: 'ledger', key: `entry:${entryId}` });
+            if (results.length === 0) {
+                return { success: false, data: null, error: `Entry ${entryId} not found` };
+            }
+            const entry = results[0].value;
+            const prevResults = entry.previousHash !== 'GENESIS'
+                ? await ctx.memory.recall({ namespace: 'ledger', key: `entry:${entry.previousHash}` })
+                : [];
+            const chainValid = entry.previousHash === 'GENESIS' || prevResults.length > 0;
+            return {
+                success: true,
+                data: {
+                    entry,
+                    verified: chainValid,
+                    chainIntegrity: chainValid ? 'INTACT' : 'BROKEN',
+                    previousEntryFound: prevResults.length > 0 || entry.previousHash === 'GENESIS',
+                },
+            };
+        }
+        if (action === 'chain') {
+            const entries = await ctx.memory.recall({ namespace: 'ledger', key: `chain:${chainId}`, limit: 100 });
+            const sorted = entries.sort((a, b) => a.value.timestamp - b.value.timestamp);
+            let chainValid = true;
+            for (let i = 1; i < sorted.length; i++) {
+                const prev = sorted[i - 1].value;
+                const curr = sorted[i].value;
+                if (curr.previousHash !== prev.hash) {
+                    chainValid = false;
+                    break;
+                }
+            }
+            return {
+                success: true,
+                data: {
+                    chainId,
+                    entryCount: sorted.length,
+                    chainValid,
+                    integrity: chainValid ? 'INTACT' : 'TAMPER_DETECTED',
+                    entries: sorted.map(e => e.value),
+                },
+                metadata: {
+                    chainLength: sorted.length,
+                    sovereignty: ctx.identity.sovereignty,
+                },
+            };
+        }
+        return { success: false, data: null, error: `Unknown action: ${action}` };
+    },
+};
+//# sourceMappingURL=integrity_ledger.js.map

package/dist/tools/security/integrity_ledger.js.map

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

package/dist/tools/security/red_team.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../types.js';
+export declare const redTeamTool: ToolDefinition;