@ddse/acm-aicoder 0.5.0 → 0.5.2

package/bin/interactive.tsx

@@ -1,232 +0,0 @@
-#!/usr/bin/env node
-
-// ACM AI Coder - Phase 2 Interactive CLI
-// Full-screen TUI with three-column layout
-// Requires: --provider, --model, and --workspace (optional --base-url)
-
-import React from 'react';
-import { render } from 'ink';
-import { ExternalContextProviderAdapter } from '@ddse/acm-sdk';
-import { createOllamaClient, createVLLMClient } from '@ddse/acm-llm';
-import { App } from '../src/ui/App.js';
-import { AppStore } from '../src/ui/store.js';
-import { InteractiveRuntime } from '../src/runtime/interactive-runtime.js';
-import { parseCliArgs, validateAndNormalizeConfig } from '../src/config/session.js';
-import {
-  SimpleCapabilityRegistry,
-  SimpleToolRegistry,
-  SimplePolicyEngine,
-  // V2 Tools
-  FileStatTool,
-  FileReadToolV2,
-  CodeSearchTool,
-  GrepTool,
-  DiffTool,
-  CodeEditToolV2,
-  RunTestsToolV2,
-  WorkspaceContextRetrievalTool,
-  type WorkspaceContextOperation,
-  BuildTool,
-  // V2 Tasks
-  AnalyzeWorkspaceTask,
-  CollectContextPackTask,
-  SearchCodeTask,
-  FindSymbolDefinitionTask,
-  ImplementFunctionTask,
-  RefactorRenameSymbolTask,
-  FixTypeErrorTask,
-  GenerateUnitTestsTask,
-} from '../src/index.js';
-
-function buildWorkspaceContextInput(
-  directive: string,
-  goalIntent?: string
-): {
-  directive: string;
-  goal?: string;
-  operations: WorkspaceContextOperation[];
-} {
-  const separatorIndex = directive.indexOf(':');
-  const payload = separatorIndex >= 0 ? directive.slice(separatorIndex + 1).trim() : '';
-  const operations: WorkspaceContextOperation[] = [];
-
-  if (payload.length > 0) {
-    if (payload.startsWith('{')) {
-      try {
-        const parsed = JSON.parse(payload);
-        if (Array.isArray(parsed.operations)) {
-          return {
-            directive,
-            goal: goalIntent,
-            operations: parsed.operations as WorkspaceContextOperation[],
-          };
-        }
-        if (typeof parsed.query === 'string' && parsed.query.length > 0) {
-          operations.push({ type: 'search', query: parsed.query, includeContext: true });
-        }
-        if (typeof parsed.pattern === 'string' && parsed.pattern.length > 0) {
-          operations.push({ type: 'grep', pattern: parsed.pattern, maxResults: 20 });
-        }
-      } catch {
-        // Fall through to textual parsing
-      }
-    }
-
-    if (operations.length === 0) {
-      operations.push({ type: 'search', query: payload, includeContext: true });
-      operations.push({ type: 'grep', pattern: payload, maxResults: 20 });
-    }
-  }
-
-  return {
-    directive,
-    goal: goalIntent,
-    operations,
-  };
-}
-
-async function main() {
-  try {
-    // Parse and validate CLI arguments
-    const args = parseCliArgs(process.argv.slice(2));
-  const config = validateAndNormalizeConfig(args);
-
-  // Ensure the process operates within the validated workspace
-  process.chdir(config.workspace);
-
-    // Create LLM client based on provider selection
-    const llm = config.provider === 'vllm'
-      ? createVLLMClient(config.model, config.baseUrl)
-      : createOllamaClient(config.model, config.baseUrl);
-    
-    // Setup registries
-    const toolRegistry = new SimpleToolRegistry();
-    const capabilityRegistry = new SimpleCapabilityRegistry();
-    const policyEngine = new SimplePolicyEngine();
-    const contextProvider = new ExternalContextProviderAdapter();
-
-    // Register tools
-    const fileStatTool = new FileStatTool(config.workspace);
-    const fileReadTool = new FileReadToolV2(config.workspace);
-    const codeSearchTool = new CodeSearchTool(config.workspace);
-    const grepTool = new GrepTool(config.workspace);
-    const diffTool = new DiffTool(config.workspace);
-    const codeEditTool = new CodeEditToolV2(config.workspace);
-    const runTestsTool = new RunTestsToolV2(config.workspace);
-    const buildTool = new BuildTool(config.workspace);
-    const workspaceContextTool = new WorkspaceContextRetrievalTool(config.workspace);
-
-    toolRegistry.register(fileStatTool);
-    toolRegistry.register(fileReadTool);
-    toolRegistry.register(codeSearchTool);
-    toolRegistry.register(grepTool);
-    toolRegistry.register(diffTool);
-    toolRegistry.register(codeEditTool);
-    toolRegistry.register(runTestsTool);
-    toolRegistry.register(buildTool);
-    toolRegistry.register(workspaceContextTool);
-
-    contextProvider.register(workspaceContextTool, {
-      match: directive =>
-        directive.startsWith('workspace.context') || directive.startsWith('workspace_context'),
-      buildInput: (directive, ctx) =>
-        buildWorkspaceContextInput(directive, ctx.runContext?.goal.intent),
-      describe:
-        'Retrieve relevant workspace snippets, grep matches, and metadata to satisfy context requests.',
-      autoPromote: true,
-      maxArtifacts: 32,
-    });
-    
-    // Register capabilities (tasks)
-    capabilityRegistry.register(
-      { name: 'analyze_workspace', sideEffects: false },
-      new AnalyzeWorkspaceTask()
-    );
-    capabilityRegistry.register(
-      { name: 'collect_context_pack', sideEffects: false },
-      new CollectContextPackTask()
-    );
-    capabilityRegistry.register(
-      { name: 'search_code', sideEffects: false },
-      new SearchCodeTask()
-    );
-    capabilityRegistry.register(
-      { name: 'find_symbol_definition', sideEffects: false },
-      new FindSymbolDefinitionTask()
-    );
-    capabilityRegistry.register(
-      { name: 'implement_function', sideEffects: true },
-      new ImplementFunctionTask()
-    );
-    capabilityRegistry.register(
-      { name: 'refactor_rename_symbol', sideEffects: true },
-      new RefactorRenameSymbolTask()
-    );
-    capabilityRegistry.register(
-      { name: 'fix_type_error', sideEffects: true },
-      new FixTypeErrorTask()
-    );
-    capabilityRegistry.register(
-      { name: 'generate_unit_tests', sideEffects: true },
-      new GenerateUnitTestsTask()
-    );
-    
-    // Allow workspace operations
-  policyEngine.setAllowedPaths([config.workspace]);
-    
-    // Create app store and runtime
-    const store = new AppStore();
-    const runtime = new InteractiveRuntime({
-      config,
-      llm,
-      capabilityRegistry,
-      toolRegistry,
-      policyEngine,
-      store,
-      contextProvider,
-    });
-
-    const initialBudget = runtime.getBudgetManager().getStatus();
-    
-    // Welcome message
-    store.addMessage('system', 
-      `Welcome to ACM AI Coder (Phase 2)\n\n` +
-  `Configuration:\n` +
-  `  Provider: ${config.provider}\n` +
-      `  Model: ${config.model}\n` +
-      (config.baseUrl ? `  Base URL: ${config.baseUrl}\n` : '') +
-  `  Workspace: ${config.workspace}\n` +
-      (initialBudget.maxTokens !== undefined ? `  Token allowance: ${initialBudget.maxTokens}\n` : '') +
-      `\n` +
-      `Type your goal to start planning, or /help for commands.`
-    );
-    
-    // Update initial budget status
-    store.updateBudgetStatus(initialBudget);
-    
-    // Handle commands from UI
-    const handleCommand = async (command: string) => {
-      if (command.startsWith('/')) {
-        // Already handled by UI component
-        return;
-      }
-      
-      // Process as goal
-      await runtime.processGoal(command);
-    };
-    
-    // Render TUI
-    render(<App store={store} onCommand={handleCommand} />);
-    
-  } catch (error: any) {
-    console.error('Error starting ACM AI Coder:');
-    console.error(error.message);
-    console.error('\nFor help, run: acm-aicoder --help');
-    process.exit(1);
-  }
-}
-
-main().catch(err => {
-  console.error('Fatal error:', err);
-  process.exit(1);
-});

package/docs/INTERACTIVE_CLI_GUIDE.md

@@ -1,201 +0,0 @@
-# ACM AI Coder - Phase 2 Interactive CLI Guide
-
-## Architecture
-
-The Phase 2 AI Coder is built entirely on ACM v0.5 framework primitives:
-
-```
-┌─────────────────────────────────────────────────────────┐
-│              Full-Screen Terminal UI (Ink)              │
-├───────────────┬─────────────────────────┬───────────────┤
-│ Chat Pane     │ Goals/Tasks/Budget      │ Event Stream  │
-│ (40% width)   │ (30% width)             │ (30% width)   │
-├───────────────┴─────────────────────────┴───────────────┤
-│                   Command Input                          │
-└─────────────────────────────────────────────────────────┘
-                           │
-                           ▼
-              ┌─────────────────────────┐
-              │   InteractiveRuntime    │
-              └─────────────────────────┘
-                           │
-        ┌──────────────────┼──────────────────┐
-        ▼                  ▼                  ▼
-  ┌──────────┐      ┌──────────┐      ┌──────────┐
-  │ Planner  │      │ Runtime  │      │  Budget  │
-  │ (LLM)    │      │ (Tasks)  │      │ Manager  │
-  └──────────┘      └──────────┘      └──────────┘
-        │                  │                  │
-        └──────────────────┼──────────────────┘
-                           ▼
-                    ┌────────────┐
-                    │   Ledger   │
-                    │ (Replay)   │
-                    └────────────┘
-```
-
-## Quick Start
-
-### Start Interactive Mode
-
-```bash
-acm-aicoder \
-  --provider vllm \
-  --model Qwen/Qwen3-Coder-30B-A3B-Instruct-FP8 \
-  --base-url http://localhost:8001/v1 \
-  --workspace /path/to/your/project
-```
-
-### Available Commands
-
-| Command | Description |
-|---------|-------------|
-| `/exit`, `/quit` | Exit the application |
-| `/help` | Show available commands |
-| `/budget` | Display detailed budget information |
-| `/context` | Show current context packet info |
-| `/reset` | Reset session (clear goal, tasks) |
-| `#path/to/file` | Reference workspace files in chat |
-
-## Components
-
-### Budget Governance
-
-- Pre-inference cost checks using provider metadata
-- Live spend tracking with warnings
-- Hard limits with override prompts
-- Token estimation: ~4 chars per token
-
-### Streaming Reasoning
-
-- Planner thoughts appear in Chat pane as they generate
-- Nucleus inferences show reasoning process
-- Real-time task status updates
-
-### Memory Lifecycle
-
-After each goal:
-
-- Replay bundle saved to `.aicoder/replays/{timestamp}/`
-- Budget reset for next goal
-- Chat and events preserved
-
-## Configuration
-
-### Required Parameters
-
-- `--provider` - LLM provider (`ollama` or `vllm`, default: `ollama`)
-- `--model` - Model identifier published by the provider
-- `--workspace` - Project root directory (must already exist)
-
-- `--base-url` - Override provider endpoint
-- `--temperature` - LLM temperature 0-2 (default: 0.7)
-- `--seed` - Random seed for reproducibility
-- `--plans` - Number of plans to generate, 1 or 2 (default: 1)
-
-## Extending
-
-### Add a New Task
-
-```typescript
-export class MyTask extends Task<{ input: string }, { output: string }> {
-  constructor() {
-    super('my-task', 'my_capability');
-  }
-
-  async execute(ctx: RunContext, input: { input: string }) {
-    // Implementation
-    return { output: 'result' };
-  }
-}
-```
-
-Register in `bin/interactive.tsx`:
-
-```typescript
-capabilityRegistry.register(
-  { name: 'my_capability', sideEffects: false },
-  new MyTask()
-);
-```
-
-### Add a New Tool
-
-```typescript
-export class MyTool extends Tool<{ input: string }, { result: string }> {
-  name() { return 'my_tool'; }
-  description() { return 'My custom tool'; }
-
-  async _call(args: { input: string }) {
-    return { result: 'processed' };
-  }
-}
-```
-
-Register in `bin/interactive.tsx`:
-
-```typescript
-toolRegistry.register(new MyTool());
-```
-
-## Example Sessions
-
-### Local vLLM (Qwen)
-
-```bash
-python -m vllm.entrypoints.openai.api_server \
-  --model Qwen/Qwen3-Coder-30B-A3B-Instruct-FP8 \
-  --port 8001
-
-acm-aicoder \
-  --provider vllm \
-  --model Qwen/Qwen3-Coder-30B-A3B-Instruct-FP8 \
-  --base-url http://localhost:8001/v1 \
-  --workspace ~/project
-```
-
-### OpenAI
-
-```bash
-export OPENAI_API_KEY="sk-..."
-
-acm-aicoder \
-  --provider vllm \
-  --model gpt-4o \
-  --base-url https://api.openai.com \
-  --workspace ~/project
-```
-
-## Capabilities
-
-### Analysis (No Side Effects)
-
-- `analyze_workspace` - Deep codebase analysis
-- `collect_context_pack` - Generate context for planning
-- `search_code` - BM25-based code search
-- `find_symbol_definition` - Locate symbols
-
-### Development (Side Effects)
-
-- `implement_function` - Create implementations
-- `refactor_rename_symbol` - Rename with tracking
-- `fix_type_error` - Fix TypeScript errors
-- `generate_unit_tests` - Generate test scaffolding
-
-## Troubleshooting
-
-### Missing Parameters
-
-Ensure all required flags are provided. Check error message for details.
-
-### Budget Exceeded
-
-- Use a model with a higher token allowance or adjust provider configuration
-- Run locally: `--provider vllm --model Qwen/Qwen3-Coder-30B-A3B-Instruct-FP8 --base-url http://localhost:8001/v1`
-
-### Layout Issues
-
-- Terminal must be ≥80 columns wide
-- Use standard terminal emulators
-
-For more details, see [AICODER_IMPLEMENTATION_PLAN_PHASE2.md](../AICODER_IMPLEMENTATION_PLAN_PHASE2.md)

package/docs/TUI_MOCKUP.md

@@ -1,180 +0,0 @@
-# ACM AI Coder - Interactive TUI Mockup
-
-```
-╔═══════════════════════════════════════════════════════════════════════════════╗
-║               ACM AI Coder - Interactive Mode                      ⟳ Processing║
-╠═════════════════════════╤═════════════════════════════╤═════════════════════════╣
-║                         │                             │                         ║
-║  ┌─────────────────┐    │  ┌─────────────────────┐   │  ┌─────────────────┐   ║
-║  │      Chat       │    │  │ Goal/Tasks/Progress │   │  │   Event Stream  │   ║
-║  └─────────────────┘    │  └─────────────────────┘   │  └─────────────────┘   ║
-║                         │                             │                         ║
-║  System:                │  Goal:                      │  [14:23:45] GOAL_      ║
-║  Welcome to ACM AI      │  Analyze src/index.ts       │  CREATED: goal-123     ║
-║  Coder (Phase 2)        │  and find bugs              │                         ║
-║                         │                             │  [14:23:46] BUDGET_    ║
-║  Configuration:         │  Tasks:                     │  CHECK: $0.0024        ║
-║    Model: gpt-4o        │  ○ analyze_workspace        │                         ║
-║    Engine: langgraph    │  ○ collect_context_pack     │  [14:23:47] PLAN_      ║
-║    Workspace: /project  │  ○ search_code              │  SELECTED: plan-456    ║
-║    Budget: $10.00       │                             │                         ║
-║                         │  Budget:                    │  [14:23:48] TASK_      ║
-║  Type your goal to      │  Spent: $0.0024 / $10.00    │  START: task-0         ║
-║  start planning.        │  Used: 0.0%                 │                         ║
-║                         │  Remaining: $9.9976         │  [14:23:49] CONTEXT_   ║
-║  You:                   │  Calls: 1                   │  INTERNALIZED: 3 files ║
-║  Analyze src/index.ts   │                             │                         ║
-║  and find bugs          │                             │  [14:23:50] TASK_      ║
-║                         │                             │  END: task-0           ║
-║  Planner (streaming...):│                             │                         ║
-║  I'll analyze the file  │                             │  [14:23:51] NUCLEUS_   ║
-║  by first collecting    │                             │  INFERENCE: context ok ║
-║  context from the       │                             │                         ║
-║  workspace, then...     │                             │                         ║
-║                         │                             │                         ║
-║                         │                             │                         ║
-║                         │                             │                         ║
-╠═════════════════════════╧═════════════════════════════╧═════════════════════════╣
-║  > Type your goal or command (e.g., /help)...                                   ║
-╚═══════════════════════════════════════════════════════════════════════════════╝
-```
-
-## Layout Breakdown
-
-### Left Column (40%) - Chat Pane
-- **Purpose:** User messages, planner reasoning, nucleus thoughts, system messages
-- **Colors:**
-  - User: white
-  - Planner: yellow (streaming indicator when active)
-  - Nucleus: magenta
-  - System: gray
-- **Scrolling:** Shows most recent messages that fit in viewport
-
-### Middle Column (30%) - Goals/Tasks/Progress
-- **Goal Section:** Current goal intent
-- **Tasks Section:** Live task list with status icons
-  - ○ pending (gray)
-  - ◐ running (yellow)
-  - ● succeeded (green)
-  - ✗ failed (red)
-  - ⟳ retrying (yellow)
-- **Budget Section:** Real-time spend tracking
-  - Total spent vs. limit
-  - Percentage used (color-coded)
-  - Remaining budget
-  - API call count
-
-### Right Column (30%) - Event Stream
-- **Purpose:** Ledger entries, tool calls, context updates, policy decisions
-- **Format:** [timestamp] TYPE: data
-- **Colors:**
-  - PLAN_SELECTED, TASK_END: green
-  - TASK_START: blue
-  - ERROR: red
-  - POLICY_DECISION: yellow
-  - Others: gray
-- **Pruning:** Keeps last 100 events
-
-### Bottom - Command Input
-- **Text input:** Accepts goals or commands
-- **Commands:** /exit, /help, /budget, /context, /reset
-- **File mentions:** #path/to/file syntax
-- **Submit:** Press Enter to send
-
-## Example Session Flow
-
-### 1. Startup
-```
-> acm-aicoder --provider vllm --model gpt-4o --base-url https://api.openai.com \
-              --workspace /myproject
-
-[TUI launches with welcome message]
-```
-
-### 2. User Types Goal
-```
-> Find all TypeScript errors in src/ directory
-[ENTER]
-```
-
-### 3. Budget Check
-```
-Event Stream:
-[14:25:01] BUDGET_CHECK: estimated $0.0035, 1200 tokens
-```
-
-### 4. Planner Streams Reasoning
-```
-Chat Pane:
-Planner (streaming...):
-First, I'll analyze the TypeScript files in src/...
-Then I'll run the type checker...
-Finally, I'll categorize the errors...
-```
-
-### 5. Tasks Execute
-```
-Tasks Pane:
-◐ analyze_workspace (running)
-○ collect_context_pack
-○ fix_type_error
-
-Event Stream:
-[14:25:02] TASK_START: task-0
-[14:25:03] CONTEXT_INTERNALIZED: 15 files
-[14:25:04] TASK_END: task-0
-```
-
-### 6. Completion
-```
-System:
-Goal completed successfully!
-Replay bundle saved to: /myproject/.aicoder/replays/2025-01-04T14-25-05
-```
-
-## Interactive Commands
-
-### /help
-Shows available commands and usage examples.
-
-### /budget
-```
-Budget Status:
-  Total Spent: $0.0124
-  Limit: $10.00
-  Remaining: $9.9876
-  Used: 0.1%
-  API Calls: 4
-```
-
-### /context
-```
-Current Context:
-  ID: ctx-1735998305123
-  Facts: 3 entries
-```
-
-### /reset
-Clears current goal and tasks, resets budget, keeps chat history.
-
-### /exit or /quit
-Saves replay bundle and exits cleanly.
-
-## Visual Styling
-
-- **Borders:** Single-line for panes, double-line for header/footer
-- **Colors:** ANSI terminal colors (cyan, yellow, green, red, blue, magenta)
-- **Responsive:** Adjusts to terminal size (minimum 80 columns)
-- **Updates:** Real-time re-renders on state changes
-
-## Terminal Requirements
-
-- **Minimum Width:** 80 columns
-- **Minimum Height:** 24 rows
-- **Terminal Type:** xterm-compatible (supports ANSI colors)
-- **Not Recommended:** tmux/screen nested sessions (may cause layout issues)
-
----
-
-This mockup represents the actual TUI layout implemented in Phase 2.
-All components are functional and wired to the ACM framework.