sudocode 1.1.16 → 1.1.18-dev.0

package/node_modules/@sudocode-ai/mcp/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@sudocode-ai/mcp",
+  "version": "0.1.17",
+  "description": "MCP server for sudocode, git-native context management for AI-assisted development",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "sudocode-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sudocode",
+    "project-management",
+    "specs",
+    "context-as-code",
+    "specifications",
+    "spec-driven-development",
+    "issues",
+    "issue-tracking",
+    "ai-assisted-development",
+    "coding-agent",
+    "git-native"
+  ],
+  "author": "sudocode AI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudocode-ai/sudocode.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://sudocode.ai",
+  "bugs": {
+    "url": "https://github.com/sudocode-ai/sudocode/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@sudocode-ai/cli": "^0.1.17",
+    "@sudocode-ai/types": "^0.1.17",
+    "vite": "^6.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.6",
+    "esbuild": "^0.27.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  }
+}

package/node_modules/@sudocode-ai/types/README.md

@@ -0,0 +1,7 @@
+# @sudocode-ai/types
+
+TypeScript type definitions for [sudocode](https://github.com/sudocode-ai/sudocode) - Git-native spec and issue management for AI-assisted software development.
+
+## Overview
+
+This package provides shared TypeScript types used across all sudocode packages. It includes type definitions for specs, issues, relationships, feedback, events, and JSONL interchange formats.

package/node_modules/@sudocode-ai/types/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@sudocode-ai/types",
+  "version": "0.1.17",
+  "description": "TypeScript type definitions for sudocode",
+  "types": "src/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.d.ts"
+    },
+    "./events": {
+      "types": "./src/events.d.ts",
+      "default": "./src/events.d.ts"
+    },
+    "./agents": {
+      "types": "./src/agents.d.ts",
+      "default": "./src/agents.d.ts"
+    },
+    "./workflows": {
+      "types": "./src/workflows.d.ts",
+      "default": "./src/workflows.d.ts"
+    },
+    "./integrations": {
+      "types": "./src/integrations.d.ts",
+      "default": "./src/integrations.d.ts"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations.d.ts",
+      "default": "./dist/migrations.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:run": "vitest --run"
+  },
+  "keywords": [
+    "sudocode",
+    "types",
+    "typescript"
+  ],
+  "author": "sudocode AI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudocode-ai/sudocode.git",
+    "directory": "types"
+  },
+  "homepage": "https://sudocode.ai",
+  "bugs": {
+    "url": "https://github.com/sudocode-ai/sudocode/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/index.d.ts",
+    "src/events.d.ts",
+    "src/agents.d.ts",
+    "src/artifacts.d.ts",
+    "src/workflows.d.ts",
+    "src/integrations.d.ts",
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "better-sqlite3": "^11.7.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  }
+}

package/node_modules/@sudocode-ai/types/src/agents.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Agent configuration types for sudocode
+ *
+ * Defines agent types and their specific configuration interfaces.
+ * Each agent config extends BaseAgentConfig from agent-execution-engine.
+ *
+ * @example
+ * ```typescript
+ * // Import from main package
+ * import type { AgentType, AgentConfig } from '@sudocode-ai/types';
+ *
+ * // Or import directly from agents
+ * import type { ClaudeCodeConfig } from '@sudocode-ai/types/agents';
+ *
+ * const agentType: AgentType = 'claude-code';
+ * const config: ClaudeCodeConfig = {
+ *   workDir: '/path/to/project',
+ *   claudePath: 'claude',
+ *   print: true,
+ *   outputFormat: 'stream-json',
+ * };
+ * ```
+ *
+ * @module @sudocode-ai/types/agents
+ */
+
+/**
+ * Agent types supported for execution
+ */
+export type AgentType = "claude-code" | "codex" | "copilot" | "cursor";
+
+/**
+ * Execution modes supported by agents
+ * Aligns with ExecutionMode from agent-execution-engine
+ */
+export type ExecutionMode = "structured" | "interactive" | "hybrid";
+
+/**
+ * Base configuration options that all agents should support
+ * Aligns with BaseAgentConfig from agent-execution-engine
+ */
+export interface BaseAgentConfig {
+  /** Path to the agent's CLI executable */
+  executablePath?: string;
+  /** Working directory for execution */
+  workDir: string;
+  /** Environment variables to pass to the process */
+  env?: Record<string, string>;
+  /** Maximum execution time in milliseconds */
+  timeout?: number;
+  /** Execution mode (if agent supports multiple modes) */
+  mode?: ExecutionMode;
+}
+
+/**
+ * Claude Code specific configuration
+ */
+export interface ClaudeCodeConfig extends BaseAgentConfig {
+  /** Path to Claude Code CLI executable (default: 'claude') */
+  claudePath?: string;
+  /** Run in non-interactive print mode */
+  print?: boolean;
+  /** Output format (stream-json recommended for parsing) */
+  outputFormat?: "stream-json" | "json" | "text";
+  /** Enable verbose output (required for stream-json with print mode) */
+  verbose?: boolean;
+  /** Skip permission prompts */
+  dangerouslySkipPermissions?: boolean;
+  /** Enable bypassing permission checks as an option without enabling by default */
+  allowDangerouslySkipPermissions?: boolean;
+  /** Permission mode setting (acceptEdits, bypassPermissions, default, dontAsk, plan) */
+  permissionMode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+
+  // === Model Configuration ===
+  /** Model for the session (alias like 'sonnet', 'opus' or full name like 'claude-sonnet-4-5-20250929') */
+  model?: string;
+  /** Fallback model when default is overloaded (only works with --print) */
+  fallbackModel?: string;
+
+  // === Tool Permissions ===
+  /** Comma or space-separated list of tool names to allow (e.g., "Bash(git:*) Edit") */
+  allowedTools?: string[];
+  /** Specify available tools from built-in set. Use "" to disable all, "default" for all, or tool names */
+  tools?: string[];
+  /** Comma or space-separated list of tool names to deny (e.g., "Bash(git:*) Edit") */
+  disallowedTools?: string[];
+
+  // === System Prompt ===
+  /** System prompt to use for the session */
+  systemPrompt?: string;
+  /** Append a system prompt to the default system prompt */
+  appendSystemPrompt?: string;
+
+  // === Directory & Context ===
+  /** Additional directories to allow tool access to */
+  addDir?: string[];
+
+  // === MCP Configuration ===
+  /** Load MCP servers from JSON files or strings (space-separated) */
+  mcpConfig?: string[];
+  /** Only use MCP servers from --mcp-config, ignoring all other MCP configurations */
+  strictMcpConfig?: boolean;
+
+  // === Session Management ===
+  /** Continue the most recent conversation */
+  continue?: boolean;
+  /** Resume a conversation - provide a session ID or leave empty for interactive selection */
+  resume?: string;
+  /** When resuming, create a new session ID instead of reusing the original */
+  forkSession?: boolean;
+  /** Use a specific session ID for the conversation (must be a valid UUID) */
+  sessionId?: string;
+
+  // === Output Configuration ===
+  /** JSON Schema for structured output validation */
+  jsonSchema?: string;
+  /** Include partial message chunks as they arrive (only with --print and --output-format=stream-json) */
+  includePartialMessages?: boolean;
+
+  // === Advanced ===
+  /** Path to a settings JSON file or a JSON string to load additional settings from */
+  settings?: string;
+  /** Comma-separated list of setting sources to load (user, project, local) */
+  settingSources?: string;
+  /** Enable debug mode with optional category filtering */
+  debug?: string | boolean;
+
+  // === Process Management ===
+  /** Maximum idle time before cleanup (pool only) */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+  /** Prompt to send to Claude Code */
+  prompt?: string;
+
+  // === Directory Restriction ===
+  /**
+   * Restrict file operations to the working directory
+   *
+   * When enabled, a PreToolUse hook is configured to block Read, Write, Edit,
+   * Glob, and Grep operations that target files outside the working directory.
+   *
+   * This provides security isolation when running agents in worktrees or
+   * sandboxed environments.
+   *
+   * @default false
+   */
+  restrictToWorkDir?: boolean;
+  /**
+   * Path to the directory guard hook script
+   *
+   * Only used when restrictToWorkDir is enabled. If not specified,
+   * the executor will use the bundled hook script from agent-execution-engine.
+   */
+  directoryGuardHookPath?: string;
+}
+
+/**
+ * OpenAI Codex specific configuration (CLI-based)
+ */
+export interface CodexConfig extends BaseAgentConfig {
+  /** Path to Codex CLI executable */
+  codexPath?: string;
+  /** Use 'codex exec' for non-interactive execution */
+  exec?: boolean;
+  /** Emit newline-delimited JSON events */
+  json?: boolean;
+  /** Use experimental JSON output format */
+  experimentalJson?: boolean;
+  /** Write final assistant message to file */
+  outputLastMessage?: string;
+  /** Override configured model (e.g., 'gpt-5-codex', 'gpt-5') */
+  model?: string;
+  /** Sandbox policy */
+  sandbox?: "read-only" | "workspace-write" | "danger-full-access";
+  /** Approval policy */
+  askForApproval?: "untrusted" | "on-failure" | "on-request" | "never";
+  /** Shortcut combining workspace-write sandbox + on-failure approvals */
+  fullAuto?: boolean;
+  /** Allow execution outside Git repositories */
+  skipGitRepoCheck?: boolean;
+  /** Control ANSI color output */
+  color?: "always" | "never" | "auto";
+  /** Enable web browsing capability */
+  search?: boolean;
+  /** Attach image files to the prompt */
+  image?: string[];
+  /** Load configuration profile from config.toml */
+  profile?: string;
+  /** Additional directories to grant write access */
+  addDir?: string[];
+  /** Disable all safety checks (isolated environments only) */
+  yolo?: boolean;
+  /** Maximum idle time before cleanup */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+  /** Prompt to send to Codex */
+  prompt?: string;
+}
+
+/**
+ * GitHub Copilot CLI specific configuration
+ *
+ * @see https://github.com/github/copilot
+ */
+export interface CopilotConfig extends BaseAgentConfig {
+  /** Path to Copilot CLI executable (default: 'copilot') */
+  copilotPath?: string;
+  /** Copilot CLI version to use (only with npx, default: 'latest') */
+  copilotVersion?: string;
+  /** Model to use (e.g., 'gpt-4o', 'gpt-5', 'claude-sonnet-4.5') */
+  model?: string;
+  /** Allow all tools without prompting */
+  allowAllTools?: boolean;
+  /** Comma-separated list of allowed tools */
+  allowTool?: string;
+  /** Comma-separated list of denied tools */
+  denyTool?: string;
+  /** Additional directories to include in context */
+  addDir?: string[];
+  /** MCP servers to disable for this execution */
+  disableMcpServer?: string[];
+  /** System prompt to prepend to user prompt */
+  systemPrompt?: string;
+  /** Prompt to send to Copilot */
+  prompt?: string;
+  /** Maximum idle time before cleanup */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+}
+
+/**
+ * Cursor specific configuration (cursor-agent CLI)
+ */
+export interface CursorConfig extends BaseAgentConfig {
+  /** Path to cursor-agent CLI executable */
+  cursorPath?: string;
+  /** Auto-approve all tool executions (adds --force flag) */
+  force?: boolean;
+  /** Model to use for code generation */
+  model?: string;
+  /** Additional text to append to user prompts */
+  appendPrompt?: string;
+  /**
+   * Automatically approve all MCP servers.
+   * Only works with --print/headless mode.
+   */
+  approveMcps?: boolean;
+  /** Maximum idle time before cleanup */
+  idleTimeout?: number;
+  /** Retry configuration for failed spawns */
+  retry?: {
+    maxAttempts: number;
+    backoffMs: number;
+  };
+  /** Prompt to send to Cursor */
+  prompt?: string;
+}
+
+/**
+ * Discriminated union of all agent configurations
+ */
+export type AgentConfig =
+  | ClaudeCodeConfig
+  | CodexConfig
+  | CopilotConfig
+  | CursorConfig;

package/node_modules/@sudocode-ai/types/src/artifacts.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Execution artifacts types
+ *
+ * Types for artifacts created during executions (code changes, outputs, etc.)
+ */
+
+/**
+ * File change statistics for execution diff
+ */
+export interface FileChangeStat {
+  path: string;
+  additions: number;
+  deletions: number;
+  status: 'A' | 'M' | 'D' | 'R'; // Added, Modified, Deleted, Renamed
+}
+
+/**
+ * Changes snapshot at a specific point in time
+ */
+export interface ChangesSnapshot {
+  files: FileChangeStat[];
+  summary: {
+    totalFiles: number;
+    totalAdditions: number;
+    totalDeletions: number;
+  };
+  commitRange: {
+    before: string;
+    after: string;
+  } | null;
+  uncommitted: boolean;
+}
+
+/**
+ * Result of execution changes calculation
+ */
+export interface ExecutionChangesResult {
+  available: boolean;
+  reason?: 'missing_commits' | 'commits_not_found' | 'incomplete_execution' | 'git_error' | 'worktree_deleted_with_uncommitted_changes' | 'branch_deleted';
+
+  // Captured state: changes at execution completion time
+  captured?: ChangesSnapshot;
+
+  // Uncommitted changes at execution completion time (if any)
+  // This allows displaying both committed and uncommitted changes separately
+  uncommittedSnapshot?: ChangesSnapshot;
+
+  // Current state: changes at current branch HEAD (if different from captured)
+  current?: ChangesSnapshot;
+
+  // Branch and worktree metadata
+  branchName?: string; // Branch associated with execution
+  branchExists?: boolean; // Whether branch still exists
+  worktreeExists?: boolean; // Whether worktree still exists
+  additionalCommits?: number; // Number of commits since execution completed (current - captured)
+  commitsAhead?: number; // Number of commits the branch is ahead of target branch (for merge action visibility)
+  executionMode?: 'worktree' | 'local' | null; // Execution mode - helps distinguish between local and worktree executions
+
+  // Legacy compatibility (deprecated - use captured instead)
+  changes?: ChangesSnapshot;
+  commitRange?: {
+    before: string;
+    after: string;
+  } | null;
+  uncommitted?: boolean;
+}

package/node_modules/@sudocode-ai/types/src/events.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Event types for the watcher system
+ * These events are emitted by the CLI watcher and consumed by the server
+ */
+
+import type { Spec, Issue } from "./index.js";
+
+/**
+ * Event fired when an entity is synced between database and markdown
+ */
+export interface EntitySyncEvent {
+  /** Type of entity that was synced */
+  entityType: "spec" | "issue";
+
+  /** ID of the entity (e.g., 'i-x7k9', 's-14sh') */
+  entityId: string;
+
+  /** Action that was performed */
+  action: "created" | "updated" | "deleted" | "no-change";
+
+  /** Absolute path to the markdown file */
+  filePath: string;
+
+  /** Absolute path to the .sudocode directory (for project identification) */
+  baseDir: string;
+
+  /** Source of the change that triggered sync */
+  source: "markdown" | "jsonl" | "database";
+
+  /** Timestamp when event occurred */
+  timestamp: Date;
+
+  /** Optional: Full entity data (avoids DB query in server) */
+  entity?: Spec | Issue;
+
+  /** Optional: Duration of sync operation in milliseconds */
+  duration?: number;
+
+  /** Optional: Whether a merge conflict was resolved */
+  conflictResolved?: boolean;
+
+  /** Version of event format */
+  version: 1;
+}
+
+/**
+ * Event fired when a file change is detected (before sync)
+ */
+export interface FileChangeEvent {
+  /** Absolute path to the file */
+  filePath: string;
+
+  /** Absolute path to the .sudocode directory */
+  baseDir: string;
+
+  /** Type of file system event */
+  event: "add" | "change" | "unlink";
+
+  /** Detected entity type (if applicable) */
+  entityType?: "spec" | "issue";
+
+  /** Detected entity ID (if applicable) */
+  entityId?: string;
+
+  /** Timestamp */
+  timestamp: Date;
+
+  /** Version of event format */
+  version: 1;
+}