cognitive-modules-cli 2.2.0 → 2.2.5

package/src/commands/update.ts

@@ -1,130 +0,0 @@
-/**
- * Update command - Update installed modules to latest version
- * 
- * cog update code-simplifier
- * cog update code-simplifier --tag v2.0.0
- */
-
-import { existsSync, rmSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-import type { CommandContext, CommandResult } from '../types.js';
-import { add, getInstallInfo } from './add.js';
-
-const USER_MODULES_DIR = join(homedir(), '.cognitive', 'modules');
-
-export interface UpdateOptions {
-  tag?: string;
-}
-
-/**
- * Get module version from installed module
- */
-async function getInstalledVersion(moduleName: string): Promise<string | undefined> {
-  const modulePath = join(USER_MODULES_DIR, moduleName);
-  
-  if (!existsSync(modulePath)) {
-    return undefined;
-  }
-  
-  const yaml = await import('js-yaml');
-  
-  // Try v2 format
-  const yamlPath = join(modulePath, 'module.yaml');
-  if (existsSync(yamlPath)) {
-    const content = await readFile(yamlPath, 'utf-8');
-    const data = yaml.load(content) as { version?: string };
-    return data?.version;
-  }
-  
-  // Try v1 format
-  const mdPath = existsSync(join(modulePath, 'MODULE.md'))
-    ? join(modulePath, 'MODULE.md')
-    : join(modulePath, 'module.md');
-  
-  if (existsSync(mdPath)) {
-    const content = await readFile(mdPath, 'utf-8');
-    if (content.startsWith('---')) {
-      const parts = content.split('---');
-      if (parts.length >= 3) {
-        const meta = yaml.load(parts[1]) as { version?: string };
-        return meta?.version;
-      }
-    }
-  }
-  
-  return undefined;
-}
-
-/**
- * Update an installed module
- */
-export async function update(
-  moduleName: string,
-  ctx: CommandContext,
-  options: UpdateOptions = {}
-): Promise<CommandResult> {
-  // Get installation info
-  const info = await getInstallInfo(moduleName);
-  
-  if (!info) {
-    return {
-      success: false,
-      error: `Module not found or not installed from GitHub: ${moduleName}. Only modules installed with 'cog add' can be updated.`,
-    };
-  }
-  
-  if (!info.githubUrl) {
-    return {
-      success: false,
-      error: `Module was not installed from GitHub: ${moduleName}`,
-    };
-  }
-  
-  // Get current version
-  const oldVersion = await getInstalledVersion(moduleName);
-  
-  // Determine what ref to use
-  const tag = options.tag || info.tag;
-  const branch = info.branch || 'main';
-  
-  // Re-install from source
-  const result = await add(info.githubUrl, ctx, {
-    module: info.modulePath,
-    name: moduleName,
-    tag,
-    branch: tag ? undefined : branch,
-  });
-  
-  if (!result.success) {
-    return result;
-  }
-  
-  const data = result.data as { version?: string };
-  const newVersion = data.version;
-  
-  // Determine message
-  let message: string;
-  if (oldVersion && newVersion) {
-    if (oldVersion === newVersion) {
-      message = `Already up to date: ${moduleName} v${newVersion}`;
-    } else {
-      message = `Updated: ${moduleName} v${oldVersion} → v${newVersion}`;
-    }
-  } else if (newVersion) {
-    message = `Updated: ${moduleName} to v${newVersion}`;
-  } else {
-    message = `Updated: ${moduleName}`;
-  }
-  
-  return {
-    success: true,
-    data: {
-      message,
-      name: moduleName,
-      oldVersion,
-      newVersion,
-    },
-  };
-}

package/src/commands/versions.ts

@@ -1,79 +0,0 @@
-/**
- * Versions command - List available versions from GitHub
- * 
- * cog versions ziel-io/cognitive-modules
- */
-
-import type { CommandContext, CommandResult } from '../types.js';
-
-export interface VersionsOptions {
-  limit?: number;
-}
-
-/**
- * Parse GitHub URL or shorthand
- */
-function parseGitHubUrl(url: string): { org: string; repo: string } {
-  if (!url.startsWith('http')) {
-    url = `https://github.com/${url}`;
-  }
-  
-  const match = url.match(/https:\/\/github\.com\/([^\/]+)\/([^\/]+)\/?/);
-  if (!match) {
-    throw new Error(`Invalid GitHub URL: ${url}`);
-  }
-  
-  return {
-    org: match[1],
-    repo: match[2].replace(/\.git$/, ''),
-  };
-}
-
-/**
- * List available versions (tags) from GitHub
- */
-export async function versions(
-  url: string,
-  ctx: CommandContext,
-  options: VersionsOptions = {}
-): Promise<CommandResult> {
-  const { limit = 10 } = options;
-  
-  try {
-    const { org, repo } = parseGitHubUrl(url);
-    
-    // Fetch tags from GitHub API
-    const apiUrl = `https://api.github.com/repos/${org}/${repo}/tags?per_page=${limit}`;
-    
-    const response = await fetch(apiUrl, {
-      headers: {
-        'User-Agent': 'cognitive-runtime/1.0',
-        'Accept': 'application/vnd.github.v3+json',
-      },
-    });
-    
-    if (!response.ok) {
-      if (response.status === 404) {
-        throw new Error(`Repository not found: ${org}/${repo}`);
-      }
-      throw new Error(`GitHub API error: ${response.status}`);
-    }
-    
-    const data = await response.json() as Array<{ name: string }>;
-    const tags = data.map(t => t.name);
-    
-    return {
-      success: true,
-      data: {
-        repository: `${org}/${repo}`,
-        tags,
-        count: tags.length,
-      },
-    };
-  } catch (error) {
-    return {
-      success: false,
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-}

package/src/index.ts

@@ -1,55 +0,0 @@
-/**
- * Cognitive Runtime - Main Entry Point
- * 
- * Exports all public APIs for programmatic use.
- */
-
-// Types
-export type {
-  Provider,
-  InvokeParams,
-  InvokeResult,
-  Message,
-  CognitiveModule,
-  ModuleResult,
-  ModuleInput,
-  ModuleConstraints,
-  ToolsPolicy,
-  OutputContract,
-  FailureContract,
-  CommandContext,
-  CommandResult,
-} from './types.js';
-
-// Providers
-export {
-  getProvider,
-  listProviders,
-  GeminiProvider,
-  OpenAIProvider,
-  AnthropicProvider,
-  BaseProvider,
-} from './providers/index.js';
-
-// Modules
-export {
-  loadModule,
-  findModule,
-  listModules,
-  getDefaultSearchPaths,
-  runModule,
-  // Subagent
-  SubagentOrchestrator,
-  runWithSubagents,
-  parseCalls,
-  createContext,
-} from './modules/index.js';
-
-// Server
-export { serve as serveHttp, createServer } from './server/index.js';
-
-// MCP
-export { serve as serveMcp } from './mcp/index.js';
-
-// Commands
-export { run, list, pipe } from './commands/index.js';

package/src/mcp/index.ts

@@ -1,5 +0,0 @@
-/**
- * MCP Server - Re-export all MCP functionality
- */
-
-export { serve } from './server.js';

package/src/mcp/server.ts

@@ -1,403 +0,0 @@
-/**
- * Cognitive Modules MCP Server
- * 
- * Provides MCP (Model Context Protocol) interface for Claude Code, Cursor, etc.
- * 
- * Start with:
- *   cog mcp
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  ListResourcesRequestSchema,
-  ReadResourceRequestSchema,
-  ListPromptsRequestSchema,
-  GetPromptRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
-
-import { loadModule, findModule, listModules, getDefaultSearchPaths } from '../modules/loader.js';
-import { runModule } from '../modules/runner.js';
-import { getProvider } from '../providers/index.js';
-import type { CognitiveModule, ModuleResult } from '../types.js';
-
-// =============================================================================
-// Server Setup
-// =============================================================================
-
-const server = new Server(
-  {
-    name: 'cognitive-modules',
-    version: '1.3.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-      resources: {},
-      prompts: {},
-    },
-  }
-);
-
-const cwd = process.cwd();
-const searchPaths = getDefaultSearchPaths(cwd);
-
-// =============================================================================
-// Tools
-// =============================================================================
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: 'cognitive_run',
-        description: 'Run a Cognitive Module to get structured AI analysis results',
-        inputSchema: {
-          type: 'object',
-          properties: {
-            module: {
-              type: 'string',
-              description: 'Module name, e.g. "code-reviewer", "task-prioritizer"',
-            },
-            args: {
-              type: 'string',
-              description: 'Input arguments, e.g. code snippet or task list',
-            },
-            provider: {
-              type: 'string',
-              description: 'LLM provider (optional), e.g. "openai", "anthropic"',
-            },
-            model: {
-              type: 'string',
-              description: 'Model name (optional), e.g. "gpt-4o", "claude-3-5-sonnet"',
-            },
-          },
-          required: ['module', 'args'],
-        },
-      },
-      {
-        name: 'cognitive_list',
-        description: 'List all installed Cognitive Modules',
-        inputSchema: {
-          type: 'object',
-          properties: {},
-        },
-      },
-      {
-        name: 'cognitive_info',
-        description: 'Get detailed information about a Cognitive Module',
-        inputSchema: {
-          type: 'object',
-          properties: {
-            module: {
-              type: 'string',
-              description: 'Module name',
-            },
-          },
-          required: ['module'],
-        },
-      },
-    ],
-  };
-});
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    switch (name) {
-      case 'cognitive_run': {
-        const { module: moduleName, args: inputArgs, provider: providerName, model } = args as {
-          module: string;
-          args: string;
-          provider?: string;
-          model?: string;
-        };
-
-        // Find module
-        const moduleData = await findModule(moduleName, searchPaths);
-        if (!moduleData) {
-          return {
-            content: [
-              {
-                type: 'text',
-                text: JSON.stringify({ ok: false, error: `Module '${moduleName}' not found` }),
-              },
-            ],
-          };
-        }
-
-        // Create provider
-        const provider = getProvider(providerName, model);
-
-        // Run module
-        const result = await runModule(moduleData, provider, {
-          input: { query: inputArgs, code: inputArgs },
-          useV22: true,
-        });
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(result, null, 2),
-            },
-          ],
-        };
-      }
-
-      case 'cognitive_list': {
-        const modules = await listModules(searchPaths);
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(
-                {
-                  modules: modules.map((m) => ({
-                    name: m.name,
-                    location: m.location,
-                    format: m.format,
-                    tier: m.tier,
-                  })),
-                  count: modules.length,
-                },
-                null,
-                2
-              ),
-            },
-          ],
-        };
-      }
-
-      case 'cognitive_info': {
-        const { module: moduleName } = args as { module: string };
-
-        const moduleData = await findModule(moduleName, searchPaths);
-        if (!moduleData) {
-          return {
-            content: [
-              {
-                type: 'text',
-                text: JSON.stringify({ ok: false, error: `Module '${moduleName}' not found` }),
-              },
-            ],
-          };
-        }
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(
-                {
-                  ok: true,
-                  name: moduleData.name,
-                  version: moduleData.version,
-                  responsibility: moduleData.responsibility,
-                  tier: moduleData.tier,
-                  format: moduleData.format,
-                  inputSchema: moduleData.inputSchema,
-                  outputSchema: moduleData.outputSchema,
-                },
-                null,
-                2
-              ),
-            },
-          ],
-        };
-      }
-
-      default:
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify({ ok: false, error: `Unknown tool: ${name}` }),
-            },
-          ],
-        };
-    }
-  } catch (error) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: JSON.stringify({
-            ok: false,
-            error: error instanceof Error ? error.message : String(error),
-          }),
-        },
-      ],
-    };
-  }
-});
-
-// =============================================================================
-// Resources
-// =============================================================================
-
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-  const modules = await listModules(searchPaths);
-  
-  return {
-    resources: [
-      {
-        uri: 'cognitive://modules',
-        name: 'All Modules',
-        description: 'List of all installed Cognitive Modules',
-        mimeType: 'application/json',
-      },
-      ...modules.map((m) => ({
-        uri: `cognitive://module/${m.name}`,
-        name: m.name,
-        description: m.responsibility || `Cognitive Module: ${m.name}`,
-        mimeType: 'text/markdown',
-      })),
-    ],
-  };
-});
-
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-  const { uri } = request.params;
-
-  if (uri === 'cognitive://modules') {
-    const modules = await listModules(searchPaths);
-    return {
-      contents: [
-        {
-          uri,
-          mimeType: 'application/json',
-          text: JSON.stringify(modules.map((m) => m.name), null, 2),
-        },
-      ],
-    };
-  }
-
-  const match = uri.match(/^cognitive:\/\/module\/(.+)$/);
-  if (match) {
-    const moduleName = match[1];
-    const moduleData = await findModule(moduleName, searchPaths);
-
-    if (!moduleData) {
-      return {
-        contents: [
-          {
-            uri,
-            mimeType: 'text/plain',
-            text: `Module '${moduleName}' not found`,
-          },
-        ],
-      };
-    }
-
-    return {
-      contents: [
-        {
-          uri,
-          mimeType: 'text/markdown',
-          text: moduleData.prompt,
-        },
-      ],
-    };
-  }
-
-  return {
-    contents: [
-      {
-        uri,
-        mimeType: 'text/plain',
-        text: `Unknown resource: ${uri}`,
-      },
-    ],
-  };
-});
-
-// =============================================================================
-// Prompts
-// =============================================================================
-
-server.setRequestHandler(ListPromptsRequestSchema, async () => {
-  return {
-    prompts: [
-      {
-        name: 'code_review',
-        description: 'Generate a code review prompt',
-        arguments: [
-          {
-            name: 'code',
-            description: 'The code to review',
-            required: true,
-          },
-        ],
-      },
-      {
-        name: 'task_prioritize',
-        description: 'Generate a task prioritization prompt',
-        arguments: [
-          {
-            name: 'tasks',
-            description: 'The tasks to prioritize',
-            required: true,
-          },
-        ],
-      },
-    ],
-  };
-});
-
-server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  switch (name) {
-    case 'code_review': {
-      const code = args?.code ?? '';
-      return {
-        messages: [
-          {
-            role: 'user',
-            content: {
-              type: 'text',
-              text: `Please use the cognitive_run tool to review the following code:\n\n\`\`\`\n${code}\n\`\`\`\n\nCall: cognitive_run("code-reviewer", "${code.slice(0, 100)}...")`,
-            },
-          },
-        ],
-      };
-    }
-
-    case 'task_prioritize': {
-      const tasks = args?.tasks ?? '';
-      return {
-        messages: [
-          {
-            role: 'user',
-            content: {
-              type: 'text',
-              text: `Please use the cognitive_run tool to prioritize the following tasks:\n\n${tasks}\n\nCall: cognitive_run("task-prioritizer", "${tasks}")`,
-            },
-          },
-        ],
-      };
-    }
-
-    default:
-      throw new Error(`Unknown prompt: ${name}`);
-  }
-});
-
-// =============================================================================
-// Server Start
-// =============================================================================
-
-export async function serve(): Promise<void> {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('Cognitive Modules MCP Server started');
-}
-
-// Allow running directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  serve().catch(console.error);
-}

package/src/modules/index.ts

@@ -1,7 +0,0 @@
-/**
- * Modules - Re-export all module functionality
- */
-
-export * from './loader.js';
-export * from './runner.js';
-export * from './subagent.js';