claude-ws 0.5.1-beta.4 → 0.5.1-beta.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-ws",
-  "version": "0.5.1-beta.4",
+  "version": "0.5.1-beta.6",
   "private": false,
   "description": "AI-powered workspace for solo CEOs and indie builders — manage your entire business with AI agents, not just code. Kanban board, code editor, Git integration, claw agent hub, local-first SQLite.",
   "keywords": [

package/packages/butler/MEMORY.md

@@ -4,24 +4,30 @@
 
 ## Workspace Rules
 
+### Butler CLI — Environment Resolution
+- **Dev**: `pnpm butler <command>` (pnpm workspace script)
+- **Prod**: `claude-ws butler <command>` (auto-replaced by postinstall)
+- **Runtime (scheduler/monitor)**: auto-resolved by `resolveButlerCliPrefix()` in `packages/butler/src/cli/utils/resolve-butler-cli-prefix.ts`
+- This file ships with `pnpm butler` as default. Postinstall replaces with `claude-ws butler` in non-workspace installs.
+
 ### Task Delegation (CRITICAL)
 ALL task execution (code changes, research, analysis, planning) must go through kanban workflow — NEVER execute directly in Butler context:
-1. Use `claude-ws butler kanban run` to create + execute in 1 step (default)
-2. Or `claude-ws butler kanban create` for backlog/planning only, then `claude-ws butler kanban start` later
+1. Use `pnpm butler kanban run` to create + execute in 1 step (default)
+2. Or `pnpm butler kanban create` for backlog/planning only, then `pnpm butler kanban start` later
 3. Keep Butler context clean for orchestration, monitoring, communication
 4. Butler ONLY does: task CRUD, project CRUD, notifications, scheduler, monitoring
 
-CLI: `claude-ws butler <command>` (prod) | `pnpm butler <command>` (dev). Skills: `sync.claude/skills/`.
-- **Run (default)**: `claude-ws butler kanban run "<title>" "<description>" [project_id] [prompt]` — create + execute + monitor. Auto-worktree for code projects.
-- Start existing: `claude-ws butler kanban start <task_id> "<prompt>"` — execute previously created task. Auto-worktree for code projects.
-- Create only: `claude-ws butler kanban create "<title>" "<description>" [status] [project_id]` — backlog/planning only
-- List: `claude-ws butler kanban list [project_id]`
-- Update: `claude-ws butler kanban update <task_id> <status>`
-- Monitor: `claude-ws butler kanban monitor` — auto-called by scheduler
+CLI: `pnpm butler <command>`. Skills: `sync.claude/skills/`.
+- **Run (default)**: `pnpm butler kanban run "<title>" "<description>" [project_id] [prompt]` — create + execute + monitor. Auto-worktree for code projects.
+- Start existing: `pnpm butler kanban start <task_id> "<prompt>"` — execute previously created task. Auto-worktree for code projects.
+- Create only: `pnpm butler kanban create "<title>" "<description>" [status] [project_id]` — backlog/planning only
+- List: `pnpm butler kanban list [project_id]`
+- Update: `pnpm butler kanban update <task_id> <status>`
+- Monitor: `pnpm butler kanban monitor` — auto-called by scheduler
 
 ### Task-Project Separation (CRITICAL — MUST specify project_id)
-- Code changes to claude-ws source (src/, server.ts, etc.) → `claude-ws butler kanban create "title" "desc" todo iMHZ_0aCSK3_0z0Kn6zQ1`
-- Butler operational tasks (monitoring, communication) → `claude-ws butler kanban create "title" "desc"` (defaults to Butler project)
+- Code changes to claude-ws source (src/, server.ts, etc.) → `pnpm butler kanban create "title" "desc" todo iMHZ_0aCSK3_0z0Kn6zQ1`
+- Butler operational tasks (monitoring, communication) → `pnpm butler kanban create "title" "desc"` (defaults to Butler project)
 - **NEVER** create code change tasks on Butler project — always pass claude-ws project ID
 
 ### Check Workspace DB First
@@ -59,13 +65,13 @@ Butler must proactively monitor tasks and communicate via browser notifications
 ### Task Management
 - **Smart delegation** — Simple tasks (1-2 files, clear scope) → execute in-chat; complex tasks → kanban workflow.
 - **Proactive reports** — Always check results + provide summary when tasks complete: status, files, compilation, commits, next steps.
-- **Reuse task for follow-up** — `claude-ws butler kanban start <existing_task_id> "<prompt>"` instead of creating new task for same issue.
+- **Reuse task for follow-up** — `pnpm butler kanban start <existing_task_id> "<prompt>"` instead of creating new task for same issue.
 - **No pre-task scouting** — Don't Explore/scout before creating tasks. DO read results (diff, response) after completion.
 - **Monitor is task-centric** — monitor takes task_id (not attempt_id), queries DB for all attempts, waits until none active.
 
 ### Technical Rules
-- **Use butler scheduler** — ALL cron/scheduling via butler scheduler REST API (`/api/butler/schedules`), or `claude-ws butler scheduler` CLI. Never CronCreate or RemoteTrigger.
-- **Use butler CLI** — All kanban + scheduler ops via `claude-ws butler` (prod) or `pnpm butler` (dev). TypeScript CLI in `packages/butler/`. Runtime prefix auto-resolved by `resolveButlerCliPrefix()`.
+- **Use butler scheduler** — ALL cron/scheduling via butler scheduler REST API (`/api/butler/schedules`), or `pnpm butler scheduler` CLI. Never CronCreate or RemoteTrigger.
+- **Use pnpm butler CLI** — All kanban + scheduler ops via `pnpm butler` commands (TypeScript CLI in `packages/butler/`). Runtime prefix auto-resolved by `resolveButlerCliPrefix()`.
 - **.claude → sync.claude** — Use `sync.claude/` paths with normal Edit/Write tools for skill files and config.
 - **Write memory to project path** — Save to `data/butler/memory/`, NOT `~/.claude/projects/.../memory/`.
 - **No git push without permission** — NEVER push to git without user's explicit approval.
@@ -83,8 +89,8 @@ Butler must proactively monitor tasks and communicate via browser notifications
 - Runs inside claude-ws server (pm2 `claudews`), NOT separate process.
 - Env auto-detected by `packages/butler/src/cli/utils/resolve-env.ts`.
 - Endpoints: GET/POST/PATCH/DELETE `/api/butler/schedules`.
-- CLI: `claude-ws butler scheduler create/list/delete`.
-- Monitor needs scheduler_id for self-delete → two-step create+update pattern (handled by `claude-ws butler kanban start`).
+- CLI: `pnpm butler scheduler create/list/delete`.
+- Monitor needs scheduler_id for self-delete → two-step create+update pattern (handled by `pnpm butler kanban start`).
 
 ### Monitor Callback Flow
 1. Task agent completes → monitor cron detects all attempts terminal
@@ -97,4 +103,3 @@ Butler must proactively monitor tasks and communicate via browser notifications
 - `script_locks` table in claude-ws.db for tracking background script execution.
 - Library: `packages/butler/src/cli/utils/script-lock.ts` — acquire/release/isRunning/listActive/cleanup.
 - 3-day TTL auto-expires crashed scripts. Always release in try/finally.
-

package/packages/butler/src/cli/utils/resolve-butler-cli-prefix.ts

@@ -1,8 +1,7 @@
 /**
  * Resolve the butler CLI command prefix for the current environment.
- * Dev (pnpm workspace): uses tsx directly with absolute paths.
- * Prod (npm global install): uses `claude-ws butler` binary.
- * Ensures scheduler-stored commands work regardless of environment.
+ * Primary: absolute tsx + butler-cli.ts path (works in both dev and prod).
+ * Fallback: `claude-ws butler` (global binary).
  */
 import { existsSync } from 'fs';
 import { join } from 'path';
@@ -20,7 +19,5 @@ export function resolveButlerCliPrefix(claudeWsRoot: string): string {
     }
   }
 
-  // Fallback: dev → pnpm, prod → claude-ws
-  const isPnpmWorkspace = existsSync(join(claudeWsRoot, 'pnpm-lock.yaml'));
-  return isPnpmWorkspace ? 'pnpm butler' : 'claude-ws butler';
+  return 'claude-ws butler';
 }

package/scripts/postinstall-optional-native-deps.js

@@ -12,6 +12,24 @@
 const path = require('path');
 const fs = require('fs');
 
+// ── Butler MEMORY.md env resolution ──────────────────────────────────
+// MEMORY.md uses `pnpm butler` (dev default). In production installs
+// (no pnpm workspace), replace with `claude-ws butler`.
+const pkgRoot = path.join(__dirname, '..');
+const memoryPath = path.join(pkgRoot, 'packages', 'butler', 'MEMORY.md');
+const hasPnpmWorkspace = fs.existsSync(path.join(pkgRoot, 'pnpm-workspace.yaml'));
+
+if (!hasPnpmWorkspace && fs.existsSync(memoryPath)) {
+  try {
+    const content = fs.readFileSync(memoryPath, 'utf-8');
+    const updated = content.replace(/pnpm butler/g, 'claude-ws butler');
+    if (updated !== content) {
+      fs.writeFileSync(memoryPath, updated);
+    }
+  } catch { /* non-critical — skip silently */ }
+}
+// ── End MEMORY.md resolution ─────────────────────────────────────────
+
 const PKG = '@homebridge/node-pty-prebuilt-multiarch';
 const PKG_DIR = path.join(__dirname, '..', 'node_modules', '@homebridge', 'node-pty-prebuilt-multiarch');
 

package/server.ts

@@ -60,7 +60,7 @@ import { createAutopilotManager, appendQuestionAnswer, appendSubagentEnded, appe
 import type { AutopilotMode } from './src/lib/autopilot';
 import { createButlerManager, type ButlerManager } from './src/lib/butler';
 import { ensureButlerMemoryFile, BUTLER_PROJECT_ID } from './src/lib/butler/butler-project-initializer';
-import { createTaskService } from '@agentic-sdk/services/task/task-crud-and-reorder';
+import { createTaskService } from './packages/agentic-sdk/src/services/task/task-crud-and-reorder';
 import { createTaskServiceWithSocketEmit } from './src/lib/services/task-service-with-socket-emit';
 
 import { getPort, getHostname } from './src/lib/server-port-configuration';

package/src/lib/autopilot/autopilot-manager.ts

@@ -14,7 +14,7 @@ import {
 } from './autopilot-prompt-builder';
 import type { AutopilotMode } from './autopilot-prompt-builder';
 import { isValidModelId } from '../models';
-import { createTaskService } from '@agentic-sdk/services/task/task-crud-and-reorder';
+import { createTaskService } from '../../../packages/agentic-sdk/src/services/task/task-crud-and-reorder';
 import { createTaskServiceWithSocketEmit } from '../services/task-service-with-socket-emit';
 
 export type { AutopilotMode };