cognitive-kit 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabriel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# cognitive-kit
+
+Pluggable cognitive layer — embeddable MCP server with 27+ tools for reasoning, research, planning, creativity, reflection, security, knowledge, analysis, agency orchestration, and adaptive pipelines.
+
+## Quick Start
+
+```bash
+npx cognitive-kit
+```
+
+Connect any MCP client (VS Code, Cursor, Claude Desktop, custom) via stdio.
+
+## Usage as Library
+
+```typescript
+import { CognitiveKit } from 'cognitive-kit';
+
+const kit = new CognitiveKit({
+  host: { type: 'cli', name: 'My App', capabilities: ['filesystem'] },
+  storage: { type: 'memory' },
+  transport: { type: 'stdio' },
+  sovereignty: { hostId: 'my-host', hostName: 'My App' },
+});
+
+await kit.start();
+```
+
+## Tools (27)
+
+### Cognitive
+- `cognitive_reason` — Deductive, inductive, abductive, counterfactual logic
+- `cognitive_research` — Multi-perspective analysis (architect, guardian, executor, strategic)
+- `cognitive_plan` — 8-phase ARM planning pipeline
+- `cognitive_create` — Divergent, convergent, analogical, random ideation
+- `cognitive_reflect` — Meta-reflection, intent drift detection, reconciliation
+
+### Security & Ethics
+- `security_gate` — Zero-trust payload evaluation (SQLi, XSS, path traversal, secrets)
+- `ethics_audit` — Utilitarian, deontological, virtue ethics scoring
+- `integrity_ledger` — Immutable audit trail with cryptographic seals
+- `threat_mapper` — STRIDE-based threat modeling
+- `red_team` — Adversarial simulation across attack vectors
+- `blast_radius` — Failure propagation and impact analysis
+
+### Knowledge & Memory
+- `memory_vam` — Associative memory with store/recall/search/associate
+- `knowledge_evolve` — Knowledge graph gap analysis and evolution paths
+- `context_synth` — Multi-source context fusion and conflict resolution
+
+### Analysis
+- `code_archaeologist` — Structural patterns, complexity, anti-patterns, dependencies
+- `sentiment_adapter` — Multi-dimensional sentiment, tone, emotion analysis
+- `consensus_engine` — 5 models: unanimous, majority, supermajority, weighted, lazy
+- `execution_flow` — Process decomposition, critical path, bottleneck detection
+
+### Agency
+- `swarm_orchestrator` — Multi-agent swarm with role assignment
+- `meta_orchestrator` — Recursive orchestration at configurable depth
+- `subagent_protocol` — Hierarchical delegation with sovereignty propagation
+- `agency_execute` — Adaptive pipeline (auto-selects phases + agents from objectives)
+
+### Guardian
+- `guardian_status` — System metrics, firewall stats, sovereignty operations
+- `guardian_freeze` — Emergency stop (requires sovereignty ≥0.9)
+- `guardian_unfreeze` — Resume operations
+
+### Forge
+- `skill_forge` — Auto-generate skills from detected usage patterns
+- `skill_list_forged` — List all forged skills
+
+## Architecture
+
+```
+                    CognitiveKit
+                   /    |    |    \
+          MCP Server  Guardian  Agency  Forge
+              |        Gate    Orch.   Registry
+          ToolRegistry   |       |        |
+        (27 tools)  Sovereignty Adaptive Pattern
+                     +Firewall Pipeline Detector
+                     +State    +8 Agents +Forger
+                      Guardian
+```
+
+## Host Adapters
+
+- **CLI** (default): stdio MCP server
+- **VS Code**: read files, get editor selection, execute commands
+- **Generic**: bring your own `HostAdapter`
+
+```typescript
+const kit = new CognitiveKit({
+  host: new MyCustomAdapter(),
+  transport: { type: 'sse', port: 3100 },
+});
+```
+
+## Configuration
+
+```typescript
+interface KitConfig {
+  host: HostAdapter | HostProfile;
+  storage?: { type: 'sqlite' | 'memory'; path?: string };
+  transport?: { type: 'stdio' | 'sse' | 'direct'; port?: number };
+  sovereignty?: { hostId: string; hostName: string; hostKey?: string };
+  tools?: { autoLoad?: boolean; additional?: ToolDefinition[] };
+}
+```
+
+Environment variables: `KIT_HOST_ID`, `KIT_HOST_NAME`, `KIT_SOVEREIGN_KEY`.

package/cli-wrapper.cjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('./dist/cli.js').catch(function(err) {
+  console.error('Failed to start cognitive-kit:', err.message);
+  process.exit(1);
+});

package/dist/Kit.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from 'node:events';
+import type { KitConfig, HostProfile, ToolDefinition } from './types.js';
+import { AgencyOrchestrator } from './agencies/AgencyOrchestrator.js';
+import { GuardianGate } from './security/GuardianGate.js';
+import { SovereigntyManager } from './security/SovereigntyManager.js';
+import { ForgeRegistry } from './forge/ForgeRegistry.js';
+import { FederationManager } from './federation/FederationManager.js';
+export declare class CognitiveKit extends EventEmitter {
+    private config;
+    private identity;
+    private memory;
+    private toolRegistry;
+    private mcpServer;
+    private transport;
+    private hostAdapter;
+    private skills;
+    private agencyRegistry;
+    private agencyOrchestrator;
+    private guardianGate;
+    private sovereigntyManager;
+    private forgeRegistry;
+    private forgeInterval?;
+    private federation;
+    private initialized;
+    constructor(config: KitConfig);
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    registerTool(tool: ToolDefinition): void;
+    registerTools(tools: ToolDefinition[]): void;
+    get hostProfile(): HostProfile | null;
+    get toolCount(): number;
+    get skillCount(): number;
+    get isRunning(): boolean;
+    get identityInfo(): string;
+    private resolveHostAdapter;
+    private loadTools;
+    private createTransport;
+    private getToolContext;
+    private createServer;
+    executeAgency(objective: string, options?: {
+        context?: string;
+        mode?: 'sequential' | 'parallel' | 'hybrid' | 'adaptive';
+        phases?: import('./agencies/AgentDefinition.js').AgencyPhase[];
+        agents?: string[];
+    }): Promise<import('./agencies/AgentDefinition.js').AgencyResult>;
+    get agency(): AgencyOrchestrator;
+    get guardian(): GuardianGate;
+    get sovereignty(): SovereigntyManager;
+    get forge(): ForgeRegistry;
+    get federationManager(): FederationManager;
+}

package/dist/Kit.js

@@ -0,0 +1,250 @@
+import { EventEmitter } from 'node:events';
+import { ConfigurationManager } from './config/ConfigurationManager.js';
+import { IdentityManager } from './identity/IdentityManager.js';
+import { MemoryManager } from './memory/MemoryManager.js';
+import { ToolRegistry } from './mcp/ToolRegistry.js';
+import { MCPServer } from './mcp/MCPServer.js';
+import { StdioTransport } from './mcp/transports/StdioTransport.js';
+import { DirectTransport } from './mcp/transports/DirectTransport.js';
+import { SSETransport } from './mcp/transports/SSETransport.js';
+import { SkillRegistry } from './skills/SkillRegistry.js';
+import { builtInCognitiveTools } from './tools/registry.js';
+import { AgencyRegistry } from './agencies/AgencyRegistry.js';
+import { AgencyOrchestrator } from './agencies/AgencyOrchestrator.js';
+import { createAgencyExecuteTool } from './tools/agency/agency_execute.js';
+import { createGuardianStatusTool, createGuardianFreezeTool, createGuardianUnfreezeTool } from './tools/security/guardian_tools.js';
+import { createSkillForgeTool, createForgedSkillsListTool } from './tools/forge_tools.js';
+import { createFederationTools } from './tools/federation_tools.js';
+import { GuardianGate } from './security/GuardianGate.js';
+import { SovereigntyManager } from './security/SovereigntyManager.js';
+import { PatternDetector } from './forge/PatternDetector.js';
+import { SkillForger } from './forge/SkillForger.js';
+import { ForgeRegistry } from './forge/ForgeRegistry.js';
+import { FederationManager } from './federation/FederationManager.js';
+export class CognitiveKit extends EventEmitter {
+    config;
+    identity;
+    memory;
+    toolRegistry;
+    mcpServer;
+    transport;
+    hostAdapter = null;
+    skills;
+    agencyRegistry;
+    agencyOrchestrator;
+    guardianGate;
+    sovereigntyManager;
+    forgeRegistry;
+    forgeInterval;
+    federation;
+    initialized = false;
+    constructor(config) {
+        super();
+        this.config = new ConfigurationManager(config);
+        this.identity = new IdentityManager(this.config.sovereignty);
+        this.toolRegistry = new ToolRegistry();
+        this.skills = new SkillRegistry();
+        this.hostAdapter = this.resolveHostAdapter(config.host);
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        const startTime = Date.now();
+        if (this.hostAdapter) {
+            await this.hostAdapter.initialize();
+        }
+        this.memory = new MemoryManager(this.config.storage);
+        await this.memory.initialize();
+        this.loadTools();
+        this.agencyRegistry = new AgencyRegistry();
+        const contextFn = () => this.getToolContext();
+        this.agencyOrchestrator = new AgencyOrchestrator(this.agencyRegistry, this.toolRegistry, contextFn);
+        this.toolRegistry.register(createAgencyExecuteTool(this.agencyOrchestrator));
+        this.sovereigntyManager = new SovereigntyManager(this.config.sovereignty);
+        this.guardianGate = new GuardianGate(this.toolRegistry, this.sovereigntyManager, {
+            enableFirewall: true,
+            enableSovereignty: true,
+            enableStateGuardian: true,
+        });
+        this.toolRegistry.register(createGuardianStatusTool(this.guardianGate));
+        this.toolRegistry.register(createGuardianFreezeTool(this.guardianGate));
+        this.toolRegistry.register(createGuardianUnfreezeTool(this.guardianGate));
+        const patternDetector = new PatternDetector();
+        const skillForger = new SkillForger(this.toolRegistry);
+        this.forgeRegistry = new ForgeRegistry(this.skills, patternDetector, skillForger);
+        this.toolRegistry.register(createSkillForgeTool(this.forgeRegistry));
+        this.toolRegistry.register(createForgedSkillsListTool(this.forgeRegistry));
+        if (this.forgeInterval)
+            clearInterval(this.forgeInterval);
+        this.forgeInterval = setInterval(() => {
+            const newSkills = this.forgeRegistry.autoForge();
+            if (newSkills.length > 0) {
+                console.error(`[forge] Auto-forged ${newSkills.length} new skill(s): ${newSkills.map(s => s.name).join(', ')}`);
+                this.emit('skills-forged', newSkills);
+            }
+        }, 120000);
+        this.federation = new FederationManager({
+            peerId: this.config.sovereignty.hostId,
+            hostName: this.config.sovereignty.hostName,
+            enableServer: true,
+            serverPort: parseInt(process.env.KIT_FEDERATION_PORT ?? '4200'),
+            knownPeers: process.env.KIT_FEDERATION_PEERS
+                ? process.env.KIT_FEDERATION_PEERS.split(',').map(s => s.trim())
+                : [],
+        }, this.toolRegistry, () => this.getToolContext());
+        const fedTools = createFederationTools(this.federation);
+        this.toolRegistry.registerMany(fedTools);
+        this.transport = this.createTransport();
+        this.mcpServer = this.createServer();
+        this.initialized = true;
+        const elapsed = Date.now() - startTime;
+        console.error(`[cognitive-kit] Initialized in ${elapsed}ms`);
+        console.error(`[cognitive-kit] Identity: ${this.identity.sovereignty}`);
+        console.error(`[cognitive-kit] Storage: ${this.memory.providerName}`);
+        console.error(`[cognitive-kit] Tools: ${this.toolRegistry.count()}`);
+        console.error(`[cognitive-kit] Skills: ${this.skills.count()}`);
+        this.emit('initialized', {
+            host: this.hostProfile,
+            toolCount: this.toolRegistry.count(),
+            skillCount: this.skills.count(),
+            storage: this.memory.providerName,
+            sovereignty: this.identity.sovereignty,
+        });
+    }
+    async start() {
+        if (!this.initialized)
+            await this.initialize();
+        await this.mcpServer.start();
+        try {
+            await this.federation.start();
+        }
+        catch (err) {
+            console.error(`[cognitive-kit] Federation not available: ${err instanceof Error ? err.message : err}`);
+        }
+        console.error('[cognitive-kit] MCP server started');
+        this.emit('started');
+    }
+    async stop() {
+        if (this.forgeInterval) {
+            clearInterval(this.forgeInterval);
+            this.forgeInterval = undefined;
+        }
+        await this.federation?.stop();
+        await this.mcpServer?.stop();
+        await this.memory?.shutdown();
+        await this.hostAdapter?.shutdown();
+        this.initialized = false;
+        this.emit('stopped');
+    }
+    registerTool(tool) {
+        this.toolRegistry.register(tool);
+    }
+    registerTools(tools) {
+        for (const t of tools)
+            this.registerTool(t);
+    }
+    get hostProfile() {
+        return this.hostAdapter?.profile ?? null;
+    }
+    get toolCount() {
+        return this.toolRegistry.count();
+    }
+    get skillCount() {
+        return this.skills.count();
+    }
+    get isRunning() {
+        return this.mcpServer?.isRunning ?? false;
+    }
+    get identityInfo() {
+        return this.identity.sovereignty;
+    }
+    resolveHostAdapter(hostConfig) {
+        if (!hostConfig)
+            return null;
+        if (typeof hostConfig === 'object' && 'profile' in hostConfig) {
+            return hostConfig;
+        }
+        if (typeof hostConfig === 'object' && 'type' in hostConfig) {
+            return new GenericHostAdapter(hostConfig);
+        }
+        return null;
+    }
+    loadTools() {
+        if (this.config.toolsConfig.autoLoad) {
+            this.toolRegistry.registerMany(builtInCognitiveTools);
+        }
+        if (this.hostAdapter) {
+            const hostTools = this.hostAdapter.getHostTools();
+            this.toolRegistry.registerMany(hostTools);
+        }
+        if (this.config.toolsConfig.additional?.length) {
+            this.toolRegistry.registerMany(this.config.toolsConfig.additional);
+        }
+    }
+    createTransport() {
+        switch (this.config.transport.type) {
+            case 'sse':
+                return new SSETransport(this.config.transport.port);
+            case 'direct':
+                return new DirectTransport();
+            case 'stdio':
+            default:
+                return new StdioTransport();
+        }
+    }
+    getToolContext() {
+        return {
+            identity: this.identity.kitInternalIdentity,
+            host: this.hostProfile ?? { type: 'generic', name: 'unknown', capabilities: [] },
+            memory: this.memory,
+        };
+    }
+    createServer() {
+        const contextProvider = () => this.getToolContext();
+        const guardedExecute = async (toolId, params, ctx) => {
+            const result = await this.guardianGate.executeTool(toolId, params, ctx);
+            this.forgeRegistry.recordUsage(toolId, result.success, params);
+            return result;
+        };
+        return new MCPServer(this.toolRegistry, this.transport, contextProvider, {
+            name: `GCS Cognitive Kit (${this.hostProfile?.name ?? 'standalone'})`,
+            version: '1.0.0-alpha',
+            instructions: `Cognitive kit installed in ${this.hostProfile?.name ?? 'unknown host'}. Provides reasoning, research, planning, creativity, and reflection capabilities. Sovereign on internal operations, operates within host boundaries.`,
+        }, guardedExecute);
+    }
+    async executeAgency(objective, options) {
+        return this.agencyOrchestrator.executeMission(objective, options);
+    }
+    get agency() {
+        return this.agencyOrchestrator;
+    }
+    get guardian() {
+        return this.guardianGate;
+    }
+    get sovereignty() {
+        return this.sovereigntyManager;
+    }
+    get forge() {
+        return this.forgeRegistry;
+    }
+    get federationManager() {
+        return this.federation;
+    }
+}
+class GenericHostAdapter {
+    profile;
+    constructor(profile) {
+        this.profile = profile;
+    }
+    async initialize() {
+        console.error(`[cognitive-kit] Generic adapter for: ${this.profile.name} (${this.profile.type})`);
+    }
+    async shutdown() { }
+    getHostTools() {
+        return [];
+    }
+    getCapabilities() {
+        return this.profile.capabilities;
+    }
+}
+//# sourceMappingURL=Kit.js.map

package/dist/Kit.js.map

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

package/dist/agencies/AgencyOrchestrator.d.ts

@@ -0,0 +1,24 @@
+import type { ToolRegistry } from '../mcp/ToolRegistry.js';
+import type { ToolContext } from '../types.js';
+import { AgencyRegistry } from './AgencyRegistry.js';
+import type { AgencyResult, AgencyPhase } from './AgentDefinition.js';
+import { EventEmitter } from 'node:events';
+export declare class AgencyOrchestrator extends EventEmitter {
+    private registry;
+    private toolRegistry;
+    private contextProvider;
+    constructor(registry: AgencyRegistry, toolRegistry: ToolRegistry, contextProvider: () => ToolContext);
+    executeMission(objective: string, options?: {
+        context?: string;
+        mode?: 'sequential' | 'parallel' | 'hybrid' | 'adaptive';
+        phases?: AgencyPhase[];
+        agents?: string[];
+    }): Promise<AgencyResult>;
+    private detectMode;
+    private selectBestAgent;
+    private executePhase;
+    private selectToolForPhase;
+    private buildToolParams;
+    private buildDependencyGraph;
+    get registry_(): AgencyRegistry;
+}