whitesmith 0.0.0

package/dist/providers/issue-provider.d.ts

@@ -0,0 +1,59 @@
+import type { Issue } from '../types.js';
+/**
+ * Interface for issue sources.
+ * Implementations can back this with GitHub Issues, GitLab, Jira, etc.
+ */
+export interface IssueProvider {
+    /**
+     * List open issues, optionally filtered by labels
+     */
+    listIssues(options?: {
+        labels?: string[];
+        noLabels?: string[];
+    }): Promise<Issue[]>;
+    /**
+     * Get a single issue by number
+     */
+    getIssue(number: number): Promise<Issue>;
+    /**
+     * Add a label to an issue
+     */
+    addLabel(number: number, label: string): Promise<void>;
+    /**
+     * Remove a label from an issue
+     */
+    removeLabel(number: number, label: string): Promise<void>;
+    /**
+     * Post a comment on an issue
+     */
+    comment(number: number, body: string): Promise<void>;
+    /**
+     * Close an issue
+     */
+    closeIssue(number: number): Promise<void>;
+    /**
+     * Create a pull request and return its URL
+     */
+    createPR(options: {
+        head: string;
+        base: string;
+        title: string;
+        body: string;
+    }): Promise<string>;
+    /**
+     * Check if a remote branch exists
+     */
+    remoteBranchExists(branch: string): Promise<boolean>;
+    /**
+     * Check if there's an open or merged PR for a given head branch
+     */
+    getPRForBranch(branch: string): Promise<{
+        state: 'open' | 'merged' | 'closed';
+        url: string;
+    } | null>;
+    /**
+     * Ensure required labels exist in the repo (create if missing)
+     */
+    ensureLabels(labels: string[]): Promise<void>;
+}
+//# sourceMappingURL=issue-provider.d.ts.map

package/dist/providers/issue-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-provider.d.ts","sourceRoot":"","sources":["../../src/providers/issue-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAEjF;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9F;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;OAEG;IACH,cAAc,CACb,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/providers/issue-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=issue-provider.js.map

package/dist/providers/issue-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-provider.js","sourceRoot":"","sources":["../../src/providers/issue-provider.ts"],"names":[],"mappings":""}

package/dist/task-manager.d.ts

@@ -0,0 +1,57 @@
+import type { Task, TaskFrontmatter } from './types.js';
+/**
+ * Manages task files in the tasks/ directory.
+ *
+ * Task files live at: tasks/<issue-number>/<seq>-<slug>.md
+ * Each file has YAML frontmatter with id, issue, title, depends_on.
+ */
+export declare class TaskManager {
+    private workDir;
+    constructor(workDir: string);
+    /**
+     * Get the tasks directory path
+     */
+    getTasksDir(): string;
+    /**
+     * Get the directory for a specific issue's tasks
+     */
+    getIssueTasksDir(issueNumber: number): string;
+    /**
+     * List all pending tasks for an issue (files in tasks/<issue>/)
+     */
+    listTasks(issueNumber: number): Task[];
+    /**
+     * List all pending tasks across all issues
+     */
+    listAllTasks(): Task[];
+    /**
+     * Check if an issue has any remaining (pending) tasks
+     */
+    hasRemainingTasks(issueNumber: number): boolean;
+    /**
+     * Get issue numbers that have task files
+     */
+    getIssuesWithTasks(): number[];
+    /**
+     * Read and parse a single task file
+     */
+    readTask(filePath: string): Task;
+    /**
+     * Write a task file
+     */
+    writeTask(issueNumber: number, seq: number, slug: string, frontmatter: TaskFrontmatter, body: string): string;
+    /**
+     * Delete a task file (called when task is implemented)
+     */
+    deleteTask(taskFilePath: string): void;
+    /**
+     * Check if all dependencies of a task are satisfied
+     * (i.e. their task files have been deleted from the tasks directory)
+     */
+    areDependenciesSatisfied(task: Task): boolean;
+    /**
+     * Parse YAML frontmatter from a markdown file
+     */
+    private parseFrontmatter;
+}
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../src/task-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAItD;;;;;GAKG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE;IAYtC;;OAEG;IACH,YAAY,IAAI,IAAI,EAAE;IAoBtB;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAc9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAehC;;OAEG;IACH,SAAS,CACR,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,GACV,MAAM;IAcT;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAiBtC;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAU7C;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAexB"}

package/dist/task-manager.js

@@ -0,0 +1,158 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+const TASKS_DIR = 'tasks';
+/**
+ * Manages task files in the tasks/ directory.
+ *
+ * Task files live at: tasks/<issue-number>/<seq>-<slug>.md
+ * Each file has YAML frontmatter with id, issue, title, depends_on.
+ */
+export class TaskManager {
+    workDir;
+    constructor(workDir) {
+        this.workDir = workDir;
+    }
+    /**
+     * Get the tasks directory path
+     */
+    getTasksDir() {
+        return path.join(this.workDir, TASKS_DIR);
+    }
+    /**
+     * Get the directory for a specific issue's tasks
+     */
+    getIssueTasksDir(issueNumber) {
+        return path.join(this.workDir, TASKS_DIR, String(issueNumber));
+    }
+    /**
+     * List all pending tasks for an issue (files in tasks/<issue>/)
+     */
+    listTasks(issueNumber) {
+        const dir = this.getIssueTasksDir(issueNumber);
+        if (!fs.existsSync(dir))
+            return [];
+        const files = fs
+            .readdirSync(dir)
+            .filter((f) => f.endsWith('.md'))
+            .sort();
+        return files.map((f) => this.readTask(path.join(dir, f)));
+    }
+    /**
+     * List all pending tasks across all issues
+     */
+    listAllTasks() {
+        const tasksDir = this.getTasksDir();
+        if (!fs.existsSync(tasksDir))
+            return [];
+        const issueDirs = fs
+            .readdirSync(tasksDir)
+            .filter((d) => {
+            const fullPath = path.join(tasksDir, d);
+            return fs.statSync(fullPath).isDirectory() && /^\d+$/.test(d);
+        })
+            .sort();
+        const tasks = [];
+        for (const issueDir of issueDirs) {
+            const issueNumber = parseInt(issueDir, 10);
+            tasks.push(...this.listTasks(issueNumber));
+        }
+        return tasks;
+    }
+    /**
+     * Check if an issue has any remaining (pending) tasks
+     */
+    hasRemainingTasks(issueNumber) {
+        return this.listTasks(issueNumber).length > 0;
+    }
+    /**
+     * Get issue numbers that have task files
+     */
+    getIssuesWithTasks() {
+        const tasksDir = this.getTasksDir();
+        if (!fs.existsSync(tasksDir))
+            return [];
+        return fs
+            .readdirSync(tasksDir)
+            .filter((d) => {
+            const fullPath = path.join(tasksDir, d);
+            return fs.statSync(fullPath).isDirectory() && /^\d+$/.test(d);
+        })
+            .map((d) => parseInt(d, 10))
+            .sort((a, b) => a - b);
+    }
+    /**
+     * Read and parse a single task file
+     */
+    readTask(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const frontmatter = this.parseFrontmatter(content);
+        const relativePath = path.relative(this.workDir, filePath);
+        return {
+            id: frontmatter.id,
+            issue: frontmatter.issue,
+            title: frontmatter.title,
+            dependsOn: frontmatter.depends_on || [],
+            content,
+            filePath: relativePath,
+        };
+    }
+    /**
+     * Write a task file
+     */
+    writeTask(issueNumber, seq, slug, frontmatter, body) {
+        const dir = this.getIssueTasksDir(issueNumber);
+        fs.mkdirSync(dir, { recursive: true });
+        const seqStr = String(seq).padStart(3, '0');
+        const fileName = `${seqStr}-${slug}.md`;
+        const filePath = path.join(dir, fileName);
+        const content = `---\n${stringifyYaml(frontmatter).trim()}\n---\n\n${body}`;
+        fs.writeFileSync(filePath, content, 'utf-8');
+        return path.relative(this.workDir, filePath);
+    }
+    /**
+     * Delete a task file (called when task is implemented)
+     */
+    deleteTask(taskFilePath) {
+        const fullPath = path.resolve(this.workDir, taskFilePath);
+        if (fs.existsSync(fullPath)) {
+            fs.unlinkSync(fullPath);
+        }
+        // Clean up empty issue directory
+        const dir = path.dirname(fullPath);
+        if (fs.existsSync(dir)) {
+            const remaining = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+            if (remaining.length === 0) {
+                // Remove directory if no more task files
+                fs.rmSync(dir, { recursive: true, force: true });
+            }
+        }
+    }
+    /**
+     * Check if all dependencies of a task are satisfied
+     * (i.e. their task files have been deleted from the tasks directory)
+     */
+    areDependenciesSatisfied(task) {
+        if (task.dependsOn.length === 0)
+            return true;
+        const allTasks = this.listAllTasks();
+        const pendingIds = new Set(allTasks.map((t) => t.id));
+        // A dependency is satisfied if its task file no longer exists (deleted = completed)
+        return task.dependsOn.every((depId) => !pendingIds.has(depId));
+    }
+    /**
+     * Parse YAML frontmatter from a markdown file
+     */
+    parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error('Task file is missing YAML frontmatter');
+        }
+        const parsed = parseYaml(match[1]);
+        if (!parsed.id || parsed.issue === undefined || !parsed.title) {
+            throw new Error(`Task frontmatter is missing required fields (id, issue, title). Got: ${JSON.stringify(parsed)}`);
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/task-manager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * A GitHub issue (or equivalent) created by a human.
+ * Represents a problem, feature request, or improvement.
+ */
+export interface Issue {
+    /** Issue number (e.g. 42) */
+    number: number;
+    /** Issue title */
+    title: string;
+    /** Issue body/description (markdown) */
+    body: string;
+    /** Current labels on the issue */
+    labels: string[];
+    /** Issue URL */
+    url: string;
+}
+/**
+ * A task generated from an issue.
+ * Each task represents a single PR's worth of work.
+ */
+export interface Task {
+    /** Unique task ID: "<issue>-<seq>" e.g. "42-001" */
+    id: string;
+    /** Parent issue number */
+    issue: number;
+    /** Human-readable title */
+    title: string;
+    /** Task IDs this depends on (must be completed first) */
+    dependsOn: string[];
+    /** Full markdown content of the task file (including frontmatter) */
+    content: string;
+    /** File path relative to repo root */
+    filePath: string;
+}
+/**
+ * Parsed frontmatter from a task file
+ */
+export interface TaskFrontmatter {
+    id: string;
+    issue: number;
+    title: string;
+    depends_on?: string[];
+}
+/**
+ * Labels used by whitesmith to track issue state
+ */
+export declare const LABELS: {
+    /** Agent is generating tasks for this issue */
+    readonly INVESTIGATING: "whitesmith:investigating";
+    /** A PR with generated tasks has been opened */
+    readonly TASKS_PROPOSED: "whitesmith:tasks-proposed";
+    /** Task PR has been merged — tasks are on main */
+    readonly TASKS_ACCEPTED: "whitesmith:tasks-accepted";
+    /** All tasks for this issue have been completed */
+    readonly COMPLETED: "whitesmith:completed";
+};
+/**
+ * Configuration for whitesmith
+ */
+export interface DevPulseConfig {
+    /** Command to run the agent harness */
+    agentCmd: string;
+    /** Maximum iterations per run */
+    maxIterations: number;
+    /** Working directory (the repo) */
+    workDir: string;
+    /** Skip pushing branches and creating PRs */
+    noPush: boolean;
+    /** Skip sleep between iterations (for testing) */
+    noSleep: boolean;
+    /** Log file path */
+    logFile?: string;
+    /** GitHub repo in "owner/repo" format (auto-detected if not set) */
+    repo?: string;
+}
+/**
+ * What the orchestrator should do next
+ */
+export type Action = {
+    type: 'reconcile';
+    issue: Issue;
+} | {
+    type: 'investigate';
+    issue: Issue;
+} | {
+    type: 'implement';
+    task: Task;
+    issue: Issue;
+} | {
+    type: 'idle';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,KAAK;IACrB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACpB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IAClB,+CAA+C;;IAE/C,gDAAgD;;IAEhD,kDAAkD;;IAElD,mDAAmD;;CAE1C,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GACf;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,GACjC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,GACnC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,GAC7C;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Labels used by whitesmith to track issue state
+ */
+export const LABELS = {
+    /** Agent is generating tasks for this issue */
+    INVESTIGATING: 'whitesmith:investigating',
+    /** A PR with generated tasks has been opened */
+    TASKS_PROPOSED: 'whitesmith:tasks-proposed',
+    /** Task PR has been merged — tasks are on main */
+    TASKS_ACCEPTED: 'whitesmith:tasks-accepted',
+    /** All tasks for this issue have been completed */
+    COMPLETED: 'whitesmith:completed',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8CA;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,+CAA+C;IAC/C,aAAa,EAAE,0BAA0B;IACzC,gDAAgD;IAChD,cAAc,EAAE,2BAA2B;IAC3C,kDAAkD;IAClD,cAAc,EAAE,2BAA2B;IAC3C,mDAAmD;IACnD,SAAS,EAAE,sBAAsB;CACxB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+	"name": "whitesmith",
+	"version": "0.0.0",
+	"publishConfig": {
+		"access": "public"
+	},
+	"type": "module",
+	"bin": {
+		"whitesmith": "./dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"dependencies": {
+		"commander": "^14.0.3",
+		"simple-git": "^3.33.0",
+		"yaml": "^2.7.1"
+	},
+	"devDependencies": {
+		"@changesets/cli": "^2.29.8",
+		"@types/node": "^25.2.0",
+		"as-soon": "^0.1.5",
+		"cross-env": "^10.1.0",
+		"prettier": "^3.8.0",
+		"tsx": "^4.21.0",
+		"typescript": "^5.3.3",
+		"vitest": "^4.0.18"
+	},
+	"scripts": {
+		"prepublishOnly": "pnpm format:check && pnpm build",
+		"release": "pnpm prepublishOnly && git push --all && pnpm changeset publish && git push --tags",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"build": "tsc",
+		"dev": "as-soon -w src pnpm build",
+		"test": "vitest run",
+		"test:watch": "vitest"
+	}
+}

package/src/cli.ts

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+import {Command} from 'commander';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import type {DevPulseConfig} from './types.js';
+import {LABELS} from './types.js';
+import {Orchestrator} from './orchestrator.js';
+import {GitHubProvider} from './providers/github.js';
+import {PiHarness} from './harnesses/pi.js';
+import {TaskManager} from './task-manager.js';
+import pkg from '../package.json' with {type: 'json'};
+
+const DEFAULT_AGENT_CMD = 'pi';
+const DEFAULT_MAX_ITERATIONS = 10;
+
+function createOrchestrator(config: DevPulseConfig): Orchestrator {
+	const issues = new GitHubProvider(config.workDir, config.repo);
+	const agent = new PiHarness(config.agentCmd);
+	return new Orchestrator(config, issues, agent);
+}
+
+const packageName = pkg.name;
+const binName = typeof pkg.bin === 'string' ? pkg.bin : Object.keys(pkg.bin)[0];
+
+export function buildCli(): Command {
+	const program = new Command();
+
+	program.name(binName).description('AI-powered issue-to-PR pipeline').version('0.0.0');
+
+	// --- run ---
+	program
+		.command('run')
+		.description('Run the main whitesmith loop: investigate issues, implement tasks')
+		.argument('[work_dir]', 'Working directory', '.')
+		.option('--agent-cmd <cmd>', 'Agent harness command', DEFAULT_AGENT_CMD)
+		.option('--max-iterations <n>', 'Max iterations', String(DEFAULT_MAX_ITERATIONS))
+		.option('--repo <owner/repo>', 'GitHub repo (auto-detected if omitted)')
+		.option('--log-file <path>', 'Log agent output to file')
+		.option('--no-push', 'Skip pushing and PR creation')
+		.option('--no-sleep', 'Skip sleep between iterations')
+		.action(async (workDir: string, opts) => {
+			const config: DevPulseConfig = {
+				agentCmd: opts.agentCmd,
+				maxIterations: parseInt(opts.maxIterations, 10),
+				workDir: path.resolve(workDir),
+				noPush: opts.push === false,
+				noSleep: opts.sleep === false,
+				logFile: opts.logFile,
+				repo: opts.repo,
+			};
+
+			if (!fs.existsSync(config.workDir)) {
+				console.error(`ERROR: Directory '${config.workDir}' does not exist`);
+				process.exit(1);
+			}
+
+			process.chdir(config.workDir);
+			const orchestrator = createOrchestrator(config);
+
+			try {
+				await orchestrator.run();
+			} catch (error) {
+				console.error('ERROR:', error instanceof Error ? error.message : error);
+				process.exit(1);
+			}
+		});
+
+	// --- status ---
+	program
+		.command('status')
+		.description('Show current status of issues and tasks')
+		.argument('[work_dir]', 'Working directory', '.')
+		.option('--repo <owner/repo>', 'GitHub repo')
+		.action(async (workDir: string, opts) => {
+			const resolvedDir = path.resolve(workDir);
+			const issues = new GitHubProvider(resolvedDir, opts.repo);
+			const taskMgr = new TaskManager(resolvedDir);
+
+			console.log('=== whitesmith status ===\n');
+
+			// Show issues by state
+			for (const [name, label] of Object.entries(LABELS)) {
+				const list = await issues.listIssues({labels: [label]});
+				if (list.length > 0) {
+					console.log(`${name} (${label}):`);
+					for (const issue of list) {
+						console.log(`  #${issue.number} - ${issue.title}`);
+					}
+					console.log('');
+				}
+			}
+
+			// Show new issues (no whitesmith labels)
+			const allLabels = Object.values(LABELS);
+			const newIssues = await issues.listIssues({noLabels: allLabels});
+			if (newIssues.length > 0) {
+				console.log('NEW (no label):');
+				for (const issue of newIssues) {
+					console.log(`  #${issue.number} - ${issue.title}`);
+				}
+				console.log('');
+			}
+
+			// Show pending tasks
+			const allTasks = taskMgr.listAllTasks();
+			if (allTasks.length > 0) {
+				console.log('PENDING TASKS:');
+				for (const task of allTasks) {
+					const deps = task.dependsOn.length > 0 ? ` (depends: ${task.dependsOn.join(', ')})` : '';
+					console.log(`  ${task.id} - ${task.title}${deps}`);
+				}
+				console.log('');
+			}
+		});
+
+	// --- reconcile ---
+	program
+		.command('reconcile')
+		.description('Check for completed issues and close them (no AI needed)')
+		.argument('[work_dir]', 'Working directory', '.')
+		.option('--repo <owner/repo>', 'GitHub repo')
+		.action(async (workDir: string, opts) => {
+			const resolvedDir = path.resolve(workDir);
+			const issues = new GitHubProvider(resolvedDir, opts.repo);
+			const taskMgr = new TaskManager(resolvedDir);
+
+			console.log('=== whitesmith reconcile ===\n');
+
+			// Also handle tasks-proposed → tasks-accepted transition
+			// When a PR is merged, the tasks land on main, so if we see tasks on disk
+			// for an issue labeled tasks-proposed, it means the PR was merged
+			const proposedIssues = await issues.listIssues({labels: [LABELS.TASKS_PROPOSED]});
+			for (const issue of proposedIssues) {
+				if (taskMgr.hasRemainingTasks(issue.number)) {
+					// Tasks exist on main = PR was merged
+					console.log(`Issue #${issue.number}: tasks PR merged, marking as accepted`);
+					await issues.removeLabel(issue.number, LABELS.TASKS_PROPOSED);
+					await issues.addLabel(issue.number, LABELS.TASKS_ACCEPTED);
+				}
+			}
+
+			// Check accepted issues for completion
+			const acceptedIssues = await issues.listIssues({labels: [LABELS.TASKS_ACCEPTED]});
+			for (const issue of acceptedIssues) {
+				if (!taskMgr.hasRemainingTasks(issue.number)) {
+					console.log(`Issue #${issue.number}: all tasks done, closing`);
+					await issues.addLabel(issue.number, LABELS.COMPLETED);
+					await issues.removeLabel(issue.number, LABELS.TASKS_ACCEPTED);
+					await issues.comment(
+						issue.number,
+						'✅ All tasks for this issue have been implemented and merged. Closing.',
+					);
+					await issues.closeIssue(issue.number);
+				}
+			}
+
+			console.log('Reconcile complete.');
+		});
+
+	return program;
+}
+
+export async function main(args: string[] = process.argv): Promise<void> {
+	const program = buildCli();
+	await program.parseAsync(args);
+}
+
+main().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});