bobs-workshop 0.1.4

package/dist/validation/schemas.js

@@ -0,0 +1,299 @@
+// src/validation/schemas.ts
+import { z } from "zod";
+// Enhanced Activity Schema for unified logging
+export const EnhancedActivitySchema = z.object({
+    id: z.string(),
+    timestamp: z.string().datetime(),
+    role: z.enum(['architect', 'engineer', 'debugger', 'reviewer', 'system']),
+    type: z.enum(['role_update', 'layer_progress', 'clarification', 'file_change', 'mcp_operation', 'phase_completion']),
+    summary: z.string(),
+    details: z.string().optional(),
+    architect_data: z.object({
+        phase: z.enum(['research', 'design', 'clarification', 'planning']).optional(),
+        sections_completed: z.array(z.string()).optional(),
+        research_findings: z.array(z.string()).optional(),
+        design_decisions: z.array(z.string()).optional(),
+        clarifications: z.array(z.object({
+            question: z.string(),
+            answer: z.string().optional(),
+            status: z.enum(['pending', 'answered'])
+        })).optional()
+    }).optional(),
+    engineer_data: z.object({
+        layer: z.enum(['database', 'backend', 'frontend', 'integration', 'testing']).optional(),
+        tasks_completed: z.array(z.string()).optional(),
+        tasks_remaining: z.array(z.string()).optional(),
+        completion_percentage: z.number().optional(),
+        build_status: z.enum(['success', 'failed', 'skipped']).optional(),
+        test_status: z.enum(['passed', 'failed', 'skipped']).optional()
+    }).optional(),
+    debugger_data: z.object({
+        issue: z.string().optional(),
+        root_cause: z.string().optional(),
+        fix: z.string().optional(),
+        confidence: z.enum(['high', 'medium', 'low']).optional(),
+        affected_systems: z.array(z.string()).optional()
+    }).optional(),
+    reviewer_data: z.object({
+        review_type: z.enum(['code', 'architecture', 'security', 'performance']).optional(),
+        findings: z.array(z.object({
+            severity: z.enum(['high', 'medium', 'low']),
+            description: z.string(),
+            file: z.string().optional()
+        })).optional(),
+        approval_status: z.enum(['approved', 'conditional', 'rejected']).optional()
+    }).optional(),
+    files_changed: z.array(z.object({
+        path: z.string(),
+        change_type: z.enum(['added', 'modified', 'deleted']),
+        lines_added: z.number(),
+        lines_removed: z.number(),
+        diff_summary: z.string(),
+        category: z.enum(['backend', 'frontend', 'test', 'config', 'docs', 'other'])
+    }))
+});
+// Manual Schema from the correction document (with enhanced_activities added)
+export const SpecManualSchema = z.object({
+    spec_id: z.string().regex(/^SPEC-[0-9]{8}-.+$/),
+    executive_summary: z.string(),
+    product_specifications: z.string(),
+    architecture_analysis: z.string(),
+    implementation_plan: z.array(z.object({
+        task_id: z.string(),
+        description: z.string()
+    })),
+    testing: z.string(),
+    risk_assessment: z.string(),
+    execution_logs: z.array(z.object({
+        timestamp: z.string().datetime(),
+        engineer: z.string(),
+        action: z.string(),
+        task_id: z.string(),
+        files_changed: z.array(z.string()),
+        commit_hash: z.string(),
+        note: z.string()
+    })),
+    debug_logs: z.array(z.object({
+        timestamp: z.string().datetime(),
+        issue: z.string(),
+        root_cause: z.string(),
+        fix: z.string(),
+        confidence: z.enum(["High", "Medium", "Low"])
+    })),
+    // New enhanced activities array (backward compatible - optional)
+    enhanced_activities: z.array(EnhancedActivitySchema).optional()
+});
+// Role output validation schemas
+export const ArchitectOutputSchema = z.object({
+    action: z.literal("plan"),
+    spec_id: z.string(),
+    sections_completed: z.array(z.string()),
+    research_conducted: z.boolean()
+});
+export const EngineerOutputSchema = z.object({
+    action: z.literal("implement"),
+    spec_id: z.string(),
+    tasks_completed: z.array(z.string()),
+    execution_logs_count: z.number(),
+    files_modified: z.array(z.string())
+});
+export const DebuggerOutputSchema = z.object({
+    action: z.literal("debug"),
+    spec_id: z.string(),
+    issue: z.string(),
+    root_cause: z.string(),
+    resolution_status: z.enum(["fixed", "escalated", "pending"])
+});
+export const ReviewerOutputSchema = z.object({
+    action: z.literal("review"),
+    spec_id: z.string(),
+    improvement_spec_id: z.string(),
+    categories_covered: z.array(z.enum(["Security", "Performance", "Quality"])),
+    findings_with_severity: z.boolean()
+});
+// Orchestrator schema
+export const OrchestratorInputSchema = z.object({
+    problem: z.string().min(5).describe("Problem statement or task description"),
+    mode: z.enum(["architect", "engineer", "debugger", "reviewer"]).optional().describe("Preferred mode (optional - will be auto-determined)"),
+    spec_id: z.string().optional().describe("Continue existing manual (optional)"),
+    clarifications: z.record(z.string()).optional().describe("Answers to previous clarifying questions"),
+    user_approval: z.boolean().optional().describe("User approval for spec or implementation"),
+    user_satisfaction: z.boolean().optional().describe("User satisfaction with completed work")
+});
+export const OrchestratorOutputSchema = z.object({
+    spec_id: z.string(),
+    action: z.enum(["clarify", "route", "continue", "await_approval", "proceed", "complete"]),
+    clarify_questions: z.array(z.string()).optional(),
+    next_mode: z.string().optional(),
+    dashboard_url: z.string().optional(),
+    prompt_context: z.string().optional(),
+    workflow_step: z.enum([
+        "questioning", "spec_review", "approved", "implementation",
+        "user_review", "completed", "routed_to_architect", "routed_to_engineer",
+        "routed_to_debugger", "routed_to_reviewer"
+    ]).optional(),
+    requires_user_input: z.boolean().optional(),
+    approval_message: z.string().optional()
+});
+// User Approval Schemas
+export const UserApprovalSchema = z.object({
+    spec_id: z.string(),
+    approval_type: z.enum(["spec_approval", "implementation_approval", "completion_confirmation"]),
+    approved: z.boolean(),
+    feedback: z.string().optional(),
+    timestamp: z.string().datetime()
+});
+export const StateTransitionSchema = z.object({
+    from_state: z.enum(["draft", "ready", "engineered", "done"]),
+    to_state: z.enum(["draft", "ready", "engineered", "done"]),
+    trigger: z.enum(["user_input", "clarification_provided", "spec_generated", "user_approved", "implementation_complete", "review_complete", "user_satisfied", "merge_complete"]),
+    timestamp: z.string().datetime(),
+    spec_id: z.string()
+});
+// Enhanced Architect Output for Approval-Driven Planning
+export const EnhancedArchitectOutputSchema = z.object({
+    action: z.enum(["plan", "await_approval", "revise"]),
+    spec_id: z.string(),
+    sections_completed: z.array(z.string()),
+    research_conducted: z.boolean(),
+    requires_user_approval: z.boolean().optional(),
+    approval_request_message: z.string().optional(),
+    dashboard_url: z.string().optional()
+});
+// Enhanced Engineer Output for Implementation Tracking
+export const EnhancedEngineerOutputSchema = z.object({
+    action: z.enum(["implement", "progress_update", "implementation_complete"]),
+    spec_id: z.string(),
+    tasks_completed: z.array(z.string()),
+    tasks_remaining: z.array(z.string()).optional(),
+    execution_logs_count: z.number(),
+    files_modified: z.array(z.string()),
+    ready_for_user_review: z.boolean().optional(),
+    implementation_summary: z.string().optional()
+});
+// Validation function
+export function validateRoleOutput(role, output, enhanced = false) {
+    let schema;
+    switch (role.toLowerCase()) {
+        case "architect":
+            schema = enhanced ? EnhancedArchitectOutputSchema : ArchitectOutputSchema;
+            break;
+        case "engineer":
+            schema = enhanced ? EnhancedEngineerOutputSchema : EngineerOutputSchema;
+            break;
+        case "debugger":
+            schema = DebuggerOutputSchema;
+            break;
+        case "reviewer":
+            schema = ReviewerOutputSchema;
+            break;
+        case "orchestrator":
+            schema = OrchestratorOutputSchema;
+            break;
+        default:
+            throw new Error(`Unknown role: ${role}`);
+    }
+    const result = schema.safeParse(output);
+    if (!result.success) {
+        throw new Error(`Role output validation failed for ${role}: ${result.error.message}`);
+    }
+    return result.data;
+}
+// State transition validation
+export function validateStateTransition(transition) {
+    const result = StateTransitionSchema.safeParse(transition);
+    if (!result.success) {
+        throw new Error(`State transition validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+// User approval validation
+export function validateUserApproval(approval) {
+    const result = UserApprovalSchema.safeParse(approval);
+    if (!result.success) {
+        throw new Error(`User approval validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+// Manual validation function
+export function validateSpecDocument(spec) {
+    const result = SpecManualSchema.safeParse(spec);
+    if (!result.success) {
+        throw new Error(`Manual validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+// Enhanced 3-Gate Approval System Schemas
+export const ApprovalGateSchema = z.object({
+    gate_number: z.enum(["1", "2", "3"]),
+    gate_name: z.enum(["qa_clarification", "spec_approval", "implementation_approval"]),
+    spec_id: z.string(),
+    required_confidence: z.number().min(0).max(1),
+    current_state: z.enum(["pending", "ready", "approved", "blocked"]),
+    blocking_reason: z.string().optional(),
+    timestamp: z.string().datetime()
+});
+export const StateTransitionValidationSchema = z.object({
+    transition: z.object({
+        from: z.enum(["questioning", "spec_review", "approved", "implementation", "user_review", "completed"]),
+        to: z.enum(["questioning", "spec_review", "approved", "implementation", "user_review", "completed"]),
+        gate_passed: z.enum(["1", "2", "3"]).optional()
+    }),
+    requirements_met: z.object({
+        confidence_threshold: z.boolean(),
+        search_enforcement: z.boolean().optional(),
+        reviewer_completed: z.boolean().optional(),
+        user_approval: z.boolean().optional()
+    }),
+    spec_id: z.string(),
+    timestamp: z.string().datetime()
+});
+export const SearchEnforcementSchema = z.object({
+    spec_id: z.string(),
+    mode: z.enum(["debugger", "architect", "engineer", "reviewer"]),
+    search_calls_required: z.number().min(1),
+    search_calls_completed: z.number().min(0),
+    enforcement_active: z.boolean(),
+    blocked_operations: z.array(z.string()).optional(),
+    timestamp: z.string().datetime()
+});
+// 3-Gate Validation Functions
+export function validateApprovalGate(gate) {
+    const result = ApprovalGateSchema.safeParse(gate);
+    if (!result.success) {
+        throw new Error(`Approval gate validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+export function validateEnhancedStateTransition(transition, requirements) {
+    const validationData = {
+        transition,
+        requirements_met: requirements,
+        spec_id: transition.spec_id || "",
+        timestamp: new Date().toISOString()
+    };
+    const result = StateTransitionValidationSchema.safeParse(validationData);
+    if (!result.success) {
+        throw new Error(`State transition validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+export function validateSearchEnforcement(enforcement) {
+    const result = SearchEnforcementSchema.safeParse(enforcement);
+    if (!result.success) {
+        throw new Error(`Search enforcement validation failed: ${result.error.message}`);
+    }
+    return result.data;
+}
+// Gate-specific validation helpers
+export function validateGate1(confidence, questions) {
+    return confidence >= 0.95 && questions.length === 0;
+}
+export function validateGate2(specApproved, sectionsComplete) {
+    const requiredSections = ["executive_summary", "product_specifications", "architecture_analysis", "implementation_plan"];
+    return specApproved && requiredSections.every(section => sectionsComplete.includes(section));
+}
+export function validateGate3(testsPass, reviewerComplete, userApproval) {
+    return testsPass && reviewerComplete && userApproval;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/validation/schemas.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "bobs-workshop",
+  "version": "0.1.4",
+  "description": "Bob's Workshop — agentic development helper with observability, guard rails, research, and review capabilities",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bobs": "./bin/bobs-mcp.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "dashboard": "node dist/dashboard/server.js",
+    "postinstall": "npm run build && node scripts/install-search-tools.js && node scripts/init-workspace.js",
+    "install-search-tools": "node scripts/install-search-tools.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/multer": "^2.0.0",
+    "chokidar": "^4.0.3",
+    "express": "^4.x",
+    "fs-extra": "^11.x",
+    "multer": "^2.0.2",
+    "simple-git": "^3.x",
+    "uuid": "^9.x",
+    "zod": "^3.x"
+  },
+  "optionalDependencies": {
+    "@lvce-editor/ripgrep": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/chokidar": "^1.7.5",
+    "@types/express": "^5.0.3",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.x",
+    "@types/node": "^20.x",
+    "@types/uuid": "^10.0.0",
+    "eslint": "^8.x",
+    "jest": "^29.x",
+    "ts-jest": "^29.x",
+    "tsx": "^4.x",
+    "typescript": "^5.x"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "developer-tools",
+    "workshop",
+    "cli",
+    "dashboard",
+    "spec-driven",
+    "development",
+    "typescript",
+    "developer-experience"
+  ],
+  "author": "Bob's Workshop Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/bobs-workshop.git"
+  },
+  "homepage": "https://github.com/your-org/bobs-workshop#readme",
+  "bugs": {
+    "url": "https://github.com/your-org/bobs-workshop/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "bin/**/*",
+    "scripts/**/*",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/init-workspace.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import fs from 'fs-extra';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function initializeWorkspace() {
+  console.log('🔧 Initializing Bob\'s Workshop workspace...');
+
+  try {
+    const projectRoot = join(__dirname, '..');
+    const bobDir = join(projectRoot, '.bob');
+    const specsDir = join(bobDir, 'specs');
+    const manualsDir = join(bobDir, 'manuals');
+    const worktreesDir = join(bobDir, 'worktrees');
+    const indexFile = join(specsDir, 'index.json');
+
+    // Create all necessary directories
+    await fs.ensureDir(specsDir);
+    await fs.ensureDir(manualsDir);
+    await fs.ensureDir(worktreesDir);
+
+    // Create specs index if it doesn't exist (preserve existing data)
+    if (!await fs.pathExists(indexFile)) {
+      await fs.writeJson(indexFile, {
+        specs: [],
+        created_at: new Date().toISOString(),
+        version: "1.0"
+      }, { spaces: 2 });
+      console.log('📁 Created new specs index');
+    } else {
+      console.log('📁 Existing specs index preserved');
+    }
+
+    // Create .gitkeep files to ensure directories are preserved in git
+    const gitkeepFiles = [
+      join(manualsDir, '.gitkeep'),
+      join(worktreesDir, '.gitkeep')
+    ];
+
+    for (const gitkeepFile of gitkeepFiles) {
+      if (!await fs.pathExists(gitkeepFile)) {
+        await fs.writeFile(gitkeepFile, '# This file ensures the directory is preserved in git\n');
+      }
+    }
+
+    console.log('✅ Bob\'s Workshop workspace initialized');
+    console.log('');
+    console.log('🚀 Ready to use! Try:');
+    console.log('   bobs workshop    # Launch dashboard');
+    console.log('   bobs --help      # See all commands');
+    console.log('');
+
+  } catch (error) {
+    console.error('⚠️  Workspace initialization failed:', error.message);
+    console.log('💡 This won\'t prevent Bob\'s Workshop from working');
+  }
+}
+
+initializeWorkspace();

package/scripts/install-search-tools.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { existsSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const execAsync = promisify(exec);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+console.log('🔧 Setting up Bob\'s MCP search tools...\n');
+
+async function checkCommand(command, name) {
+  try {
+    await execAsync(`${command} --version`);
+    console.log(`✅ ${name} is already installed`);
+    return true;
+  } catch (error) {
+    console.log(`❌ ${name} not found`);
+    return false;
+  }
+}
+
+async function installSemgrep() {
+  console.log('📦 Installing semgrep...');
+
+  // Try different installation methods
+  const methods = [
+    {
+      cmd: 'brew install semgrep',
+      name: 'Homebrew',
+      check: () => execAsync('which brew')
+    },
+    {
+      cmd: 'pip3 install semgrep',
+      name: 'pip3',
+      check: () => execAsync('which pip3')
+    },
+    {
+      cmd: 'python3 -m pip install semgrep',
+      name: 'Python pip',
+      check: () => execAsync('which python3')
+    }
+  ];
+
+  for (const method of methods) {
+    try {
+      await method.check();
+      console.log(`📦 Trying to install semgrep via ${method.name}...`);
+      await execAsync(method.cmd);
+
+      // Verify installation
+      if (await checkCommand('semgrep', 'semgrep')) {
+        console.log(`✅ Successfully installed semgrep via ${method.name}`);
+        return true;
+      }
+    } catch (error) {
+      console.log(`⚠️  ${method.name} installation failed or not available`);
+      continue;
+    }
+  }
+
+  console.log(`⚠️  Could not automatically install semgrep. Please install manually:
+    • macOS: brew install semgrep
+    • Linux/other: pip3 install semgrep
+    • Or visit: https://semgrep.dev/docs/getting-started/`);
+  return false;
+}
+
+async function checkRipgrep() {
+  console.log('📦 Checking ripgrep...');
+
+  // Check if the npm package is available
+  const ripgrepPkgPath = path.resolve(__dirname, '../node_modules/@lvce-editor/ripgrep');
+  if (existsSync(ripgrepPkgPath)) {
+    console.log('✅ Ripgrep installed via npm package (@lvce-editor/ripgrep)');
+    return true;
+  }
+
+  // Check if ripgrep is available in system PATH
+  if (await checkCommand('rg', 'ripgrep')) {
+    return true;
+  }
+
+  console.log(`⚠️  Ripgrep not found. This is usually provided by Claude Code.
+  If you need to install it manually:
+    • macOS: brew install ripgrep
+    • Linux: apt install ripgrep / yum install ripgrep
+    • Or visit: https://github.com/BurntSushi/ripgrep`);
+  return false;
+}
+
+async function main() {
+  let semgrepOk = await checkCommand('semgrep', 'semgrep');
+  let ripgrepOk = await checkRipgrep();
+
+  if (!semgrepOk) {
+    semgrepOk = await installSemgrep();
+  }
+
+  console.log('\n📊 Setup Summary:');
+  console.log(`   Semgrep: ${semgrepOk ? '✅ Ready' : '❌ Not available'}`);
+  console.log(`   Ripgrep: ${ripgrepOk ? '✅ Ready' : '❌ Not available'}`);
+
+  if (semgrepOk && ripgrepOk) {
+    console.log('\n🎉 All search tools are ready! Bob\'s MCP can now perform advanced code searches.');
+  } else {
+    console.log('\n⚠️  Some search tools are missing. Bob\'s MCP will work with limited search functionality.');
+    console.log('   Run `npm run install-search-tools` again after installing missing tools.');
+  }
+
+  console.log('\n🚀 Run `npm run dev` or `npm start` to start Bob\'s MCP server.');
+}
+
+main().catch(console.error);