millhouse 0.3.9 → 1.0.1

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 export interface WorkItem {
     id: number;
     title: string;
@@ -22,6 +21,8 @@ export interface AnalyzedIssue extends GitHubIssue {
     affectedPaths: string[];
     dependencies: number[];
     analyzedAt: string;
+    githubIssueNumber?: number;
+    noWorkNeeded?: boolean;
 }
 export declare function issueToWorkItem(issue: AnalyzedIssue): AnalyzedWorkItem;
 export type TaskStatus = 'queued' | 'blocked' | 'ready' | 'in-progress' | 'completed' | 'failed';
@@ -57,75 +58,29 @@ export interface WorktreeInfo {
     branch: string;
     createdAt: string;
 }
-export declare const ConfigSchema: z.ZodObject<{
-    execution: z.ZodDefault<z.ZodObject<{
-        concurrency: z.ZodDefault<z.ZodNumber>;
-        baseBranch: z.ZodDefault<z.ZodString>;
-        maxBudgetPerIssue: z.ZodDefault<z.ZodNumber>;
-        maxTotalBudget: z.ZodDefault<z.ZodNumber>;
-        continueOnError: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        concurrency: number;
-        baseBranch: string;
-        maxBudgetPerIssue: number;
-        maxTotalBudget: number;
-        continueOnError: boolean;
-    }, {
-        concurrency?: number | undefined;
-        baseBranch?: string | undefined;
-        maxBudgetPerIssue?: number | undefined;
-        maxTotalBudget?: number | undefined;
-        continueOnError?: boolean | undefined;
-    }>>;
-    pullRequests: z.ZodDefault<z.ZodObject<{
-        createAsDraft: z.ZodDefault<z.ZodBoolean>;
-        mergeStrategy: z.ZodDefault<z.ZodEnum<["merge", "squash", "rebase"]>>;
-        branchPrefix: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        createAsDraft: boolean;
-        mergeStrategy: "merge" | "squash" | "rebase";
-        branchPrefix: string;
-    }, {
-        createAsDraft?: boolean | undefined;
-        mergeStrategy?: "merge" | "squash" | "rebase" | undefined;
-        branchPrefix?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    execution: {
-        concurrency: number;
-        baseBranch: string;
-        maxBudgetPerIssue: number;
-        maxTotalBudget: number;
-        continueOnError: boolean;
-    };
-    pullRequests: {
-        createAsDraft: boolean;
-        mergeStrategy: "merge" | "squash" | "rebase";
-        branchPrefix: string;
-    };
-}, {
-    execution?: {
-        concurrency?: number | undefined;
-        baseBranch?: string | undefined;
-        maxBudgetPerIssue?: number | undefined;
-        maxTotalBudget?: number | undefined;
-        continueOnError?: boolean | undefined;
-    } | undefined;
-    pullRequests?: {
-        createAsDraft?: boolean | undefined;
-        mergeStrategy?: "merge" | "squash" | "rebase" | undefined;
-        branchPrefix?: string | undefined;
-    } | undefined;
-}>;
-export type Config = z.infer<typeof ConfigSchema>;
-export declare const MILLHOUSE_LABELS: {
-    readonly QUEUED: "millhouse:queued";
-    readonly IN_PROGRESS: "millhouse:in-progress";
-    readonly BLOCKED: "millhouse:blocked";
-    readonly FAILED: "millhouse:failed";
-    readonly DONE: "millhouse:done";
-};
-export type MillhouseLabel = typeof MILLHOUSE_LABELS[keyof typeof MILLHOUSE_LABELS];
+export type WorklistItemStatus = 'pending' | 'completed' | 'failed';
+export interface WorklistItem {
+    id: number;
+    title: string;
+    body: string;
+    dependencies: number[];
+    status: WorklistItemStatus;
+    githubIssueNumber?: number;
+    noWorkNeeded?: boolean;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+}
+export interface Worklist {
+    version: 1;
+    createdAt: string;
+    updatedAt: string;
+    source: 'plan' | 'github';
+    title?: string;
+    description?: string;
+    indexIssueNumber?: number;
+    items: WorklistItem[];
+}
 export type SchedulerEvent = {
     type: 'task-started';
     issueNumber: number;
@@ -141,4 +96,17 @@ export type SchedulerEvent = {
     type: 'tasks-unblocked';
     issueNumbers: number[];
 };
+export interface JsonPlanItem {
+    id: number;
+    title: string;
+    body: string;
+    dependencies: number[];
+}
+export interface JsonPlan {
+    version: 1;
+    name?: string;
+    createdAt: string;
+    sourcePlan?: string;
+    items: JsonPlanItem[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,4 +1,6 @@
-import { z } from 'zod';
+// =============================================================================
+// Work Items (abstraction for both GitHub issues and local items)
+// =============================================================================
 // Convert AnalyzedIssue to AnalyzedWorkItem
 export function issueToWorkItem(issue) {
     return {
@@ -10,27 +12,4 @@ export function issueToWorkItem(issue) {
         analyzedAt: issue.analyzedAt,
     };
 }
-// Configuration schema
-export const ConfigSchema = z.object({
-    execution: z.object({
-        concurrency: z.number().min(1).max(16).default(8),
-        baseBranch: z.string().default('main'),
-        maxBudgetPerIssue: z.number().positive().default(5.0),
-        maxTotalBudget: z.number().positive().default(100.0),
-        continueOnError: z.boolean().default(true),
-    }).default({}),
-    pullRequests: z.object({
-        createAsDraft: z.boolean().default(true),
-        mergeStrategy: z.enum(['merge', 'squash', 'rebase']).default('squash'),
-        branchPrefix: z.string().default('millhouse/issue-'),
-    }).default({}),
-});
-// Millhouse labels
-export const MILLHOUSE_LABELS = {
-    QUEUED: 'millhouse:queued',
-    IN_PROGRESS: 'millhouse:in-progress',
-    BLOCKED: 'millhouse:blocked',
-    FAILED: 'millhouse:failed',
-    DONE: 'millhouse:done',
-};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAiDD,uBAAuB;AACvB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;QACrD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACpD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KAC3C,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACd,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;KACrD,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAIH,mBAAmB;AACnB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,kBAAkB;IAC1B,WAAW,EAAE,uBAAuB;IACpC,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,gBAAgB;CACd,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAwChF,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "millhouse",
-  "version": "0.3.9",
-  "description": "Orchestrate parallel Claude Code instances to implement GitHub issues or plan files",
+  "version": "1.0.1",
+  "description": "Orchestrate parallel Claude Code instances to implement work items",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,7 +9,6 @@
   },
   "files": [
     "dist",
-    "commands",
     "prompts"
   ],
   "scripts": {
@@ -36,8 +35,7 @@
     "commander": "^12.1.0",
     "graphlib": "^2.1.8",
     "ora": "^8.0.1",
-    "string-width": "^8.1.0",
-    "zod": "^3.23.0"
+    "string-width": "^8.1.0"
   },
   "devDependencies": {
     "@types/graphlib": "^2.1.12",

package/prompts/issue-analysis.prompt.md

@@ -1,4 +1,4 @@
-Analyze these GitHub issues and determine their dependencies and execution order.
+Analyze these GitHub issues to determine their dependencies and optimal execution order.
 
 ## Issues to Analyze
 
@@ -8,27 +8,61 @@ Analyze these GitHub issues and determine their dependencies and execution order
 
 ## Your Task
 
-Analyze each issue and determine:
+**DO NOT use TodoWrite, TaskCreate, or any task/todo tools. Only use Read, Glob, Grep, and Bash.**
+
+1. First, use Read, Glob, and Grep to explore the codebase structure
+2. Then analyze each issue semantically to determine dependencies
+
+For each issue determine:
 1. **dependencies**: Which issues MUST be completed BEFORE this issue can start
 2. **affectedPaths**: File paths this issue will likely create or modify
+3. **noWorkNeeded**: True if this is a meta/index issue that requires no actual code changes (e.g., tracking issues, index issues that just link to other issues, documentation-only issues)
+
+Also provide a summary title and description for this entire set of issues.
+
+## Dependency Analysis Guidelines
+
+Analyze the **semantic meaning** of each issue, not just explicit keywords. Consider:
+
+- **Explicit mentions**: "depends on #X", "after #X", "blocked by #X", "requires #X"
+- **Logical ordering**: If issue A creates something that issue B uses, B depends on A
+- **Feature flow**: Setup/infrastructure issues before features that use them
+- **Data dependencies**: Schema/model changes before code that uses those models
+- **API dependencies**: API endpoints before UI that calls them
+
+Issues written by humans may not have explicit dependency markers - use your understanding of software development to infer the correct order.
+
+---
+
+## Required Output Format
+
+After exploring the codebase, output ONLY a JSON object. No other text after the JSON.
+
+```json
+{
+  "title": "Short summary title for all issues (e.g. 'Add user authentication')",
+  "description": "A 1-2 sentence summary of what these issues accomplish together.",
+  "issues": [
+    {
+      "issueNumber": 1,
+      "dependencies": [],
+      "affectedPaths": ["src/path/to/file.ts"],
+      "noWorkNeeded": false
+    },
+    {
+      "issueNumber": 2,
+      "dependencies": [1],
+      "affectedPaths": ["src/other/file.ts"],
+      "noWorkNeeded": false
+    },
+    {
+      "issueNumber": 3,
+      "dependencies": [1, 2],
+      "affectedPaths": [],
+      "noWorkNeeded": true
+    }
+  ]
+}
+```
 
-Respond with ONLY a JSON array (no markdown, no explanation):
-[
-  {
-    "issueNumber": 1,
-    "dependencies": [],
-    "affectedPaths": ["src/path/to/file.ts"]
-  },
-  {
-    "issueNumber": 2,
-    "dependencies": [1],
-    "affectedPaths": ["src/other/file.ts"]
-  }
-]
-
-Rules:
-- Look for explicit dependency mentions: "depends on #X", "after #X", "blocked by #X", "requires #X"
-- Also infer logical dependencies (e.g., if issue B imports from a file that issue A creates)
-- Only include dependencies between issues in this list
-- affectedPaths should be specific file paths mentioned or implied
-- Respond with ONLY valid JSON, nothing else
+The JSON must be valid. Only include dependencies between issues in this list.

package/prompts/plan-analysis.prompt.md

@@ -1,18 +1,56 @@
-IMPORTANT: Your response must be ONLY a valid JSON array. No explanations, no markdown, no other text.
+Break this plan into discrete work items for parallel execution.
 
-Break this plan into discrete work items:
+## Plan
 
 {{plan}}
 
 ---
 
-Output a JSON array where each item has:
-- "id": number (starting from 1)
-- "title": string (short title)
-- "body": string (full implementation details, file paths, acceptance criteria)
-- "dependencies": number[] (IDs of prerequisite work items)
+## Your Task
 
-RESPOND WITH ONLY THE JSON ARRAY. Example format:
-[{"id":1,"title":"First task","body":"Details...","dependencies":[]},{"id":2,"title":"Second task","body":"Details...","dependencies":[1]}]
+1. Use Read, Glob, and Grep tools to explore the codebase
+2. Output a JSON object with summary and work items
 
-DO NOT include any text before or after the JSON. DO NOT use markdown code blocks. ONLY output the JSON array.
+**DO NOT use TodoWrite, TaskCreate, or any task/todo tools. Only use Read, Glob, Grep, and Bash.**
+
+## Context
+
+Work items will be executed by parallel Claude instances in isolated contexts. Each item must be completely self-contained with all information needed.
+
+## Work Item Guidelines
+
+- Each item should be completable in one session
+- Include exact file paths, function signatures, patterns to follow
+- Use `"dependencies": [1, 2]` for prerequisite items
+- Only add dependencies that are truly required
+
+---
+
+## Required Output Format
+
+After exploring the codebase, output ONLY a JSON object. No other text after the JSON.
+
+Use \n for newlines in body text. Keep body content concise.
+
+```json
+{
+  "title": "Short summary title for the whole plan (e.g. 'Add user authentication')",
+  "description": "A 1-2 sentence summary of what this plan accomplishes overall.",
+  "items": [
+    {
+      "id": 1,
+      "title": "Short title",
+      "body": "Implementation details. File: src/foo.ts. Pattern: follow existing style.",
+      "dependencies": []
+    },
+    {
+      "id": 2,
+      "title": "Another task",
+      "body": "More details here.",
+      "dependencies": [1]
+    }
+  ]
+}
+```
+
+The JSON must be valid. Use \n for newlines, escape quotes with backslash.

package/commands/millhouse.md

@@ -1,223 +0,0 @@
-# Millhouse
-
-Orchestrate parallel Claude Code instances to implement work items.
-
-## Usage
-
-Parse $ARGUMENTS to determine the subcommand:
-
-- `/millhouse plan [plan-file]` - Refine a plan for millhouse execution
-- `/millhouse issues [plan-file]` - Create GitHub issues from a plan
-
----
-
-## /millhouse plan
-
-Refine and improve a plan to make it suitable for millhouse execution. This should be fast and unattended - don't ask clarifying questions, just improve the plan.
-
-### Context
-
-Millhouse executes work items in **parallel using separate Claude Code instances**, each running **unattended in its own context window**. This means:
-
-- Each work item is a fresh start with no memory of previous work
-- Work items must be completely self-contained
-- Nothing can be assumed or left implicit
-
-### Instructions
-
-1. Read the plan from the file path argument. If no file given, look for plan.md or ask for the filename only.
-2. Analyze the plan and rewrite it following the guidelines below
-3. Save the improved plan to the same file (overwrite), or `plan.md` if it was a new plan
-4. **Do not ask questions about features, scope, or implementation details** - work with what's given
-5. **Do not suggest additions** - only restructure and clarify what's already in the plan
-
-### Plan Improvement Guidelines
-
-Transform the plan to be millhouse-ready:
-
-**1. Separate work items clearly**
-- Each work item should be a distinct section
-- Work items will run in separate contexts, stage by stage
-- Make boundaries between items obvious
-
-**2. Split into appropriately-sized tasks**
-- Break large tasks into smaller sub-tasks where necessary
-- Each task should be small enough to complete in one go, unattended
-- A task that's "create an entire application" is too big
-- A task that's "create a function that adds two numbers" might be too small (unless it's a dependency)
-
-**3. Make each task self-contained**
-- Include ALL context needed to implement the task
-- Specify exact file paths to create or modify
-- Include function signatures, types, interfaces
-- Don't assume knowledge from other tasks
-
-**4. Add thorough acceptance criteria**
-- How do we know this task is done?
-- What commands verify it works? (e.g., `npm test`, `go build`)
-- What should the output look like?
-- What edge cases should be handled?
-
-**5. Add testing instructions**
-- Specific test commands to run
-- Expected results
-- How to verify integration with other components
-
-**6. Make dependencies explicit**
-- Which tasks must complete before this one can start?
-- What does this task need from its dependencies? (files, exports, etc.)
-- Use clear language like "This requires the math utilities from task 1"
-
-### Important: Be Non-Interactive
-
-- **Don't ask** if the user wants to add features, tests, or documentation
-- **Don't suggest** expanding scope or adding "nice to haves"
-- **Just restructure** the existing plan into millhouse-ready format
-- If something is ambiguous, make a reasonable assumption and note it in the task
-
-### Example Transformation
-
-**Before (too vague):**
-```markdown
-# My App
-- Build a calculator
-- Add tests
-```
-
-**After (millhouse-ready):**
-```markdown
-# Calculator App
-
-## 1. Initialize TypeScript Project
-Create the project structure with TypeScript configuration.
-
-### Implementation
-- Create `package.json` with name "calculator", typescript and vitest as dev dependencies
-- Create `tsconfig.json` with strict mode, ES2020 target, NodeNext module resolution
-- Create `src/` directory
-
-### Testing
-Run `npm install` and `npx tsc --noEmit` - should complete without errors.
-
-### Acceptance Criteria
-- [ ] `package.json` exists with correct dependencies
-- [ ] `tsconfig.json` exists with strict mode enabled
-- [ ] `src/` directory exists
-- [ ] `npm install && npx tsc --noEmit` succeeds
-
-## 2. Create Math Utilities
-Create basic arithmetic functions used by the calculator.
-
-**Depends on task 1** - needs the TypeScript project structure.
-
-### Implementation
-Create `src/math.ts` with:
-- `add(a: number, b: number): number` - returns sum
-- `subtract(a: number, b: number): number` - returns difference
-- `multiply(a: number, b: number): number` - returns product
-- `divide(a: number, b: number): number` - returns quotient, throws on division by zero
-
-### Testing
-Create `src/math.test.ts` with vitest tests for all functions including edge cases.
-Run `npx vitest run` - all tests should pass.
-
-### Acceptance Criteria
-- [ ] `src/math.ts` exports all four functions
-- [ ] `src/math.test.ts` has tests for each function
-- [ ] Tests cover division by zero error case
-- [ ] `npx vitest run` passes all tests
-```
-
----
-
-## /millhouse issues
-
-Convert a plan into GitHub issues formatted for Millhouse.
-
-### Critical Context
-
-These issues will be implemented by Claude Code instances running **unattended in separate context windows**. Each issue is a fresh start with no memory of previous conversations. This means:
-
-- Every issue must be completely self-contained
-- All relevant context, requirements, and constraints must be explicitly stated
-- Nothing can be assumed or left implicit
-
-### Instructions
-
-1. Read the plan from the file path argument, or ask the user to describe it
-2. Break it into discrete, implementable issues
-3. For each issue, identify dependencies on other issues
-4. Create issues in order using `gh issue create`, starting with issues that have no dependencies
-5. Use the actual issue numbers returned by GitHub for dependency references
-6. After creating all issues, create an **index issue** that lists them all (see below)
-
-### Issue Content Requirements
-
-Each issue MUST include:
-
-**Implementation Details**
-- Specific file paths to create or modify
-- Function signatures, types, or interfaces expected
-- Any specific libraries or patterns to use
-
-**Testing & Verification**
-- How to verify the implementation works
-- Specific test commands to run (e.g., `npm test`, `npm run build`)
-- Expected output or behavior
-
-**Acceptance Criteria**
-- Clear, checkable criteria for when the issue is "done"
-- Edge cases to handle
-- Error conditions to consider
-
-**Dependencies**
-- `**Depends on #N**` if it depends on another issue
-- What specifically it needs from that dependency (files, exports, etc.)
-
-### Example Issue Body
-
-```markdown
-Create `src/utils/math.ts` with basic arithmetic functions.
-
-## Implementation
-- Export functions: `add(a: number, b: number): number` and `multiply(a: number, b: number): number`
-- Use ES module syntax (export, not module.exports)
-- No external dependencies
-
-## Testing
-Run `npx tsc --noEmit` to verify no type errors.
-
-## Acceptance Criteria
-- [ ] File exists at `src/utils/math.ts`
-- [ ] Both functions are exported
-- [ ] TypeScript compiles without errors
-```
-
-### Index Issue
-
-After creating all implementation issues, create a final **index issue** that serves as an overview. Title it something like "Implement [feature name]" and include:
-
-- A one-line summary of the overall goal
-- A list of all created issues with their numbers and a brief description
-- The command to run: `millhouse run issues <index-number>`
-
-Example:
-
-```markdown
-Implement a calculator library with math utilities.
-
-## Issues
-
-- #1 Create math utilities (`src/utils/math.ts`)
-- #2 Create string helpers (`src/utils/string.ts`)
-- #3 Create calculator class (`src/calculator.ts`)
-- #4 Create main entry point (`src/index.ts`)
-
-## Run
-
-\`\`\`bash
-millhouse run issues <this-issue-number>
-\`\`\`
-```
-
-The index issue should **not** include detailed dependency information—Millhouse will discover dependencies from the individual issues.