@cjvana/claude-auto 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,11 +1,23 @@
-import { Document } from 'yaml';
-import { z } from 'zod';
-import Database from 'better-sqlite3';
+import { Document } from "yaml";
+import { z } from "zod";
+import Database from "better-sqlite3";
 
-type CliCommand = "create" | "check-repo" | "list" | "logs" | "report" | "pause" | "resume" | "remove" | "edit" | "cost" | "dashboard" | "help";
+type CliCommand =
+	| "create"
+	| "check-repo"
+	| "list"
+	| "logs"
+	| "report"
+	| "pause"
+	| "resume"
+	| "remove"
+	| "edit"
+	| "cost"
+	| "dashboard"
+	| "help";
 interface ParsedCommand {
-    command: CliCommand;
-    args: Record<string, string | number | boolean | undefined>;
+	command: CliCommand;
+	args: Record<string, string | number | boolean | undefined>;
 }
 type CommandHandler = (args: ParsedCommand["args"]) => Promise<void>;
 declare const COMMANDS: Record<string, string>;
@@ -25,7 +37,9 @@ declare function checkRepoCommand(args: ParsedCommand["args"]): Promise<void>;
  *
  * @param args - Parsed CLI arguments (jobId?: string, json?: boolean)
  */
-declare function costCommand(args: Record<string, string | number | boolean | undefined>): Promise<void>;
+declare function costCommand(
+	args: Record<string, string | number | boolean | undefined>,
+): Promise<void>;
 
 /**
  * Create a new autonomous cron job. Validates all inputs, optionally clones the repo,
@@ -109,103 +123,179 @@ declare function parseCommand(argv: string[]): ParsedCommand;
  */
 declare function runCli(argv: string[]): Promise<void>;
 
-declare const JobConfigSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    repo: z.ZodObject<{
-        path: z.ZodString;
-        branch: z.ZodDefault<z.ZodString>;
-        remote: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>;
-    schedule: z.ZodObject<{
-        cron: z.ZodString;
-        timezone: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>;
-    focus: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        "open-issues": "open-issues";
-        "bug-discovery": "bug-discovery";
-        features: "features";
-        documentation: "documentation";
-    }>>>;
-    systemPrompt: z.ZodOptional<z.ZodString>;
-    guardrails: z.ZodDefault<z.ZodObject<{
-        maxTurns: z.ZodDefault<z.ZodNumber>;
-        maxBudgetUsd: z.ZodDefault<z.ZodNumber>;
-        noNewDependencies: z.ZodDefault<z.ZodBoolean>;
-        noArchitectureChanges: z.ZodDefault<z.ZodBoolean>;
-        bugFixOnly: z.ZodDefault<z.ZodBoolean>;
-        restrictToPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    notifications: z.ZodDefault<z.ZodObject<{
-        discord: z.ZodOptional<z.ZodObject<{
-            webhookUrl: z.ZodString;
-            onSuccess: z.ZodDefault<z.ZodBoolean>;
-            onFailure: z.ZodDefault<z.ZodBoolean>;
-            onNoChanges: z.ZodDefault<z.ZodBoolean>;
-            onLocked: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        slack: z.ZodOptional<z.ZodObject<{
-            webhookUrl: z.ZodString;
-            onSuccess: z.ZodDefault<z.ZodBoolean>;
-            onFailure: z.ZodDefault<z.ZodBoolean>;
-            onNoChanges: z.ZodDefault<z.ZodBoolean>;
-            onLocked: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        telegram: z.ZodOptional<z.ZodObject<{
-            botToken: z.ZodString;
-            chatId: z.ZodString;
-            onSuccess: z.ZodDefault<z.ZodBoolean>;
-            onFailure: z.ZodDefault<z.ZodBoolean>;
-            onNoChanges: z.ZodDefault<z.ZodBoolean>;
-            onLocked: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        default: "default";
-        sonnet: "sonnet";
-        opus: "opus";
-        haiku: "haiku";
-        opusplan: "opusplan";
-    }>, z.ZodString]>>;
-    budget: z.ZodOptional<z.ZodObject<{
-        dailyUsd: z.ZodOptional<z.ZodNumber>;
-        weeklyUsd: z.ZodOptional<z.ZodNumber>;
-        monthlyUsd: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    maxFeedbackRounds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-    pipeline: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        planModel: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
-            default: "default";
-            sonnet: "sonnet";
-            opus: "opus";
-            haiku: "haiku";
-            opusplan: "opusplan";
-        }>, z.ZodString]>>;
-        implementModel: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
-            default: "default";
-            sonnet: "sonnet";
-            opus: "opus";
-            haiku: "haiku";
-            opusplan: "opusplan";
-        }>, z.ZodString]>>;
-        reviewModel: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
-            default: "default";
-            sonnet: "sonnet";
-            opus: "opus";
-            haiku: "haiku";
-            opusplan: "opusplan";
-        }>, z.ZodString]>>;
-        maxReviewRounds: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+declare const JobConfigSchema: z.ZodObject<
+	{
+		id: z.ZodString;
+		name: z.ZodString;
+		repo: z.ZodObject<
+			{
+				path: z.ZodString;
+				branch: z.ZodDefault<z.ZodString>;
+				remote: z.ZodDefault<z.ZodString>;
+			},
+			z.core.$strip
+		>;
+		schedule: z.ZodObject<
+			{
+				cron: z.ZodString;
+				timezone: z.ZodDefault<z.ZodString>;
+			},
+			z.core.$strip
+		>;
+		focus: z.ZodDefault<
+			z.ZodArray<
+				z.ZodEnum<{
+					"open-issues": "open-issues";
+					"bug-discovery": "bug-discovery";
+					features: "features";
+					documentation: "documentation";
+				}>
+			>
+		>;
+		systemPrompt: z.ZodOptional<z.ZodString>;
+		guardrails: z.ZodDefault<
+			z.ZodObject<
+				{
+					maxTurns: z.ZodDefault<z.ZodNumber>;
+					maxBudgetUsd: z.ZodDefault<z.ZodNumber>;
+					noNewDependencies: z.ZodDefault<z.ZodBoolean>;
+					noArchitectureChanges: z.ZodDefault<z.ZodBoolean>;
+					bugFixOnly: z.ZodDefault<z.ZodBoolean>;
+					restrictToPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+				},
+				z.core.$strip
+			>
+		>;
+		notifications: z.ZodDefault<
+			z.ZodObject<
+				{
+					discord: z.ZodOptional<
+						z.ZodObject<
+							{
+								webhookUrl: z.ZodString;
+								onSuccess: z.ZodDefault<z.ZodBoolean>;
+								onFailure: z.ZodDefault<z.ZodBoolean>;
+								onNoChanges: z.ZodDefault<z.ZodBoolean>;
+								onLocked: z.ZodDefault<z.ZodBoolean>;
+							},
+							z.core.$strip
+						>
+					>;
+					slack: z.ZodOptional<
+						z.ZodObject<
+							{
+								webhookUrl: z.ZodString;
+								onSuccess: z.ZodDefault<z.ZodBoolean>;
+								onFailure: z.ZodDefault<z.ZodBoolean>;
+								onNoChanges: z.ZodDefault<z.ZodBoolean>;
+								onLocked: z.ZodDefault<z.ZodBoolean>;
+							},
+							z.core.$strip
+						>
+					>;
+					telegram: z.ZodOptional<
+						z.ZodObject<
+							{
+								botToken: z.ZodString;
+								chatId: z.ZodString;
+								onSuccess: z.ZodDefault<z.ZodBoolean>;
+								onFailure: z.ZodDefault<z.ZodBoolean>;
+								onNoChanges: z.ZodDefault<z.ZodBoolean>;
+								onLocked: z.ZodDefault<z.ZodBoolean>;
+							},
+							z.core.$strip
+						>
+					>;
+				},
+				z.core.$strip
+			>
+		>;
+		enabled: z.ZodDefault<z.ZodBoolean>;
+		model: z.ZodOptional<
+			z.ZodUnion<
+				readonly [
+					z.ZodEnum<{
+						default: "default";
+						sonnet: "sonnet";
+						opus: "opus";
+						haiku: "haiku";
+						opusplan: "opusplan";
+					}>,
+					z.ZodString,
+				]
+			>
+		>;
+		budget: z.ZodOptional<
+			z.ZodObject<
+				{
+					dailyUsd: z.ZodOptional<z.ZodNumber>;
+					weeklyUsd: z.ZodOptional<z.ZodNumber>;
+					monthlyUsd: z.ZodOptional<z.ZodNumber>;
+				},
+				z.core.$strip
+			>
+		>;
+		maxFeedbackRounds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+		pipeline: z.ZodOptional<
+			z.ZodObject<
+				{
+					enabled: z.ZodDefault<z.ZodBoolean>;
+					planModel: z.ZodDefault<
+						z.ZodUnion<
+							readonly [
+								z.ZodEnum<{
+									default: "default";
+									sonnet: "sonnet";
+									opus: "opus";
+									haiku: "haiku";
+									opusplan: "opusplan";
+								}>,
+								z.ZodString,
+							]
+						>
+					>;
+					implementModel: z.ZodDefault<
+						z.ZodUnion<
+							readonly [
+								z.ZodEnum<{
+									default: "default";
+									sonnet: "sonnet";
+									opus: "opus";
+									haiku: "haiku";
+									opusplan: "opusplan";
+								}>,
+								z.ZodString,
+							]
+						>
+					>;
+					reviewModel: z.ZodDefault<
+						z.ZodUnion<
+							readonly [
+								z.ZodEnum<{
+									default: "default";
+									sonnet: "sonnet";
+									opus: "opus";
+									haiku: "haiku";
+									opusplan: "opusplan";
+								}>,
+								z.ZodString,
+							]
+						>
+					>;
+					maxReviewRounds: z.ZodDefault<z.ZodNumber>;
+				},
+				z.core.$strip
+			>
+		>;
+	},
+	z.core.$strip
+>;
 type JobConfig = z.infer<typeof JobConfigSchema>;
 interface ScheduleInfo {
-    cron: string;
-    timezone: string;
-    humanReadable: string;
-    nextRuns: Date[];
+	cron: string;
+	timezone: string;
+	humanReadable: string;
+	nextRuns: Date[];
 }
 
 /**
@@ -268,7 +358,10 @@ declare function readJob(jobId: string): Promise<JobConfig>;
  * Update specified fields of a job config while preserving YAML comments.
  * Validates the result before writing. Rejects invalid updates.
  */
-declare function updateJob(jobId: string, updates: Partial<Omit<JobConfig, "id">>): Promise<JobConfig>;
+declare function updateJob(
+	jobId: string,
+	updates: Partial<Omit<JobConfig, "id">>,
+): Promise<JobConfig>;
 /**
  * Delete a job and its entire directory.
  * Idempotent: does not throw if the job doesn't exist.
@@ -301,89 +394,97 @@ declare function getNextRuns(cronExpr: string, timezone: string, count?: number)
 declare function validateAndDescribeSchedule(cronExpr: string, timezone: string): ScheduleInfo;
 
 interface SpawnOptions {
-    cwd: string;
-    prompt: string;
-    maxTurns: number;
-    maxBudgetUsd: number;
-    allowedTools: string[];
-    appendSystemPrompt?: string;
-    model?: string;
-    env?: Record<string, string>;
+	cwd: string;
+	prompt: string;
+	maxTurns: number;
+	maxBudgetUsd: number;
+	allowedTools: string[];
+	appendSystemPrompt?: string;
+	model?: string;
+	env?: Record<string, string>;
 }
 interface SpawnResult {
-    success: boolean;
-    result: string;
-    summary: string;
-    sessionId: string;
-    costUsd: number;
-    numTurns: number;
-    durationMs: number;
-    isError: boolean;
-    subtype: string;
-    errors?: string[];
+	success: boolean;
+	result: string;
+	summary: string;
+	sessionId: string;
+	costUsd: number;
+	numTurns: number;
+	durationMs: number;
+	isError: boolean;
+	subtype: string;
+	errors?: string[];
 }
-type RunStatus = "success" | "no-changes" | "error" | "locked" | "git-error" | "paused" | "budget-exceeded" | "needs-human-review" | "merge-conflict";
+type RunStatus =
+	| "success"
+	| "no-changes"
+	| "error"
+	| "locked"
+	| "git-error"
+	| "paused"
+	| "budget-exceeded"
+	| "needs-human-review"
+	| "merge-conflict";
 interface RunResult {
-    status: RunStatus;
-    jobId: string;
-    runId: string;
-    startedAt: string;
-    completedAt: string;
-    durationMs: number;
-    prUrl?: string;
-    summary?: string;
-    costUsd?: number;
-    numTurns?: number;
-    sessionId?: string;
-    error?: string;
-    branchName?: string;
-    issueNumber?: number;
-    model?: string;
-    feedbackRound?: number;
-    prNumber?: number;
-    pipelineStages?: Array<{
-        stage: string;
-        costUsd: number;
-        durationMs: number;
-        numTurns: number;
-    }>;
-}
-interface RunLogEntry extends RunResult {
+	status: RunStatus;
+	jobId: string;
+	runId: string;
+	startedAt: string;
+	completedAt: string;
+	durationMs: number;
+	prUrl?: string;
+	summary?: string;
+	costUsd?: number;
+	numTurns?: number;
+	sessionId?: string;
+	error?: string;
+	branchName?: string;
+	issueNumber?: number;
+	model?: string;
+	feedbackRound?: number;
+	prNumber?: number;
+	pipelineStages?: Array<{
+		stage: string;
+		costUsd: number;
+		durationMs: number;
+		numTurns: number;
+	}>;
 }
+interface RunLogEntry extends RunResult {}
 interface ReviewThread {
-    id: string;
-    isResolved: boolean;
-    comments: Array<{
-        body: string;
-        author: {
-            login: string;
-        };
-    }>;
+	id: string;
+	isResolved: boolean;
+	comments: Array<{
+		body: string;
+		author: {
+			login: string;
+		};
+	}>;
 }
 interface PRFeedbackContext {
-    number: number;
-    title: string;
-    headRefName: string;
-    url: string;
-    reviewDecision: string;
-    unresolvedThreads: ReviewThread[];
-    currentRound: number;
+	number: number;
+	title: string;
+	headRefName: string;
+	url: string;
+	reviewDecision: string;
+	unresolvedThreads: ReviewThread[];
+	currentRound: number;
 }
 interface PipelineStageResult {
-    stage: "plan" | "implement" | "review" | "fix";
-    spawnResult: SpawnResult;
+	stage: "plan" | "implement" | "review" | "fix";
+	spawnResult: SpawnResult;
 }
 interface PipelineResult {
-    stages: PipelineStageResult[];
-    reviewVerdict: "pass" | "fail" | "skipped";
-    totalCostUsd: number;
-    totalDurationMs: number;
-    summary: string;
+	stages: PipelineStageResult[];
+	reviewVerdict: "pass" | "fail" | "skipped";
+	totalCostUsd: number;
+	totalDurationMs: number;
+	summary: string;
 }
 interface RebaseResult {
-    diverged: boolean;
-    rebased: boolean;
-    conflicts: string[];
+	diverged: boolean;
+	rebased: boolean;
+	conflicts: string[];
 }
 
 /**
@@ -394,29 +495,37 @@ interface RebaseResult {
  */
 declare function sendNotifications(config: JobConfig, result: RunResult): Promise<void>;
 
-type NotificationEvent = "success" | "no-changes" | "error" | "locked" | "git-error" | "budget-exceeded" | "merge-conflict" | "needs-human-review";
+type NotificationEvent =
+	| "success"
+	| "no-changes"
+	| "error"
+	| "locked"
+	| "git-error"
+	| "budget-exceeded"
+	| "merge-conflict"
+	| "needs-human-review";
 interface NotificationPayload {
-    event: NotificationEvent;
-    jobId: string;
-    jobName: string;
-    runId: string;
-    repoPath: string;
-    branch: string;
-    startedAt: string;
-    completedAt: string;
-    durationMs: number;
-    prUrl?: string;
-    summary?: string;
-    costUsd?: number;
-    numTurns?: number;
-    error?: string;
-    branchName?: string;
+	event: NotificationEvent;
+	jobId: string;
+	jobName: string;
+	runId: string;
+	repoPath: string;
+	branch: string;
+	startedAt: string;
+	completedAt: string;
+	durationMs: number;
+	prUrl?: string;
+	summary?: string;
+	costUsd?: number;
+	numTurns?: number;
+	error?: string;
+	branchName?: string;
 }
 interface EventTriggers {
-    onSuccess?: boolean;
-    onFailure?: boolean;
-    onNoChanges?: boolean;
-    onLocked?: boolean;
+	onSuccess?: boolean;
+	onFailure?: boolean;
+	onNoChanges?: boolean;
+	onLocked?: boolean;
 }
 /**
  * Determines whether a notification should be sent for a given run status
@@ -458,13 +567,13 @@ declare function formatTelegram(payload: NotificationPayload, chatId: string): o
  */
 declare function extractIssueNumber(text: string): number | undefined;
 interface PostIssueCommentOptions {
-    repoPath: string;
-    issueNumber: number;
-    status: RunStatus;
-    prUrl?: string;
-    summary?: string;
-    error?: string;
-    jobName: string;
+	repoPath: string;
+	issueNumber: number;
+	status: RunStatus;
+	prUrl?: string;
+	summary?: string;
+	error?: string;
+	jobName: string;
 }
 /**
  * Post a comment on a GitHub issue about the run result.
@@ -475,15 +584,15 @@ interface PostIssueCommentOptions {
 declare function postIssueComment(options: PostIssueCommentOptions): Promise<void>;
 
 interface RegisteredJob {
-    jobId: string;
-    schedule: string;
-    command: string;
+	jobId: string;
+	schedule: string;
+	command: string;
 }
 interface Scheduler {
-    register(job: JobConfig, env?: Record<string, string>): Promise<void>;
-    unregister(jobId: string): Promise<void>;
-    isRegistered(jobId: string): Promise<boolean>;
-    list(): Promise<RegisteredJob[]>;
+	register(job: JobConfig, env?: Record<string, string>): Promise<void>;
+	unregister(jobId: string): Promise<void>;
+	isRegistered(jobId: string): Promise<boolean>;
+	list(): Promise<RegisteredJob[]>;
 }
 /**
  * Factory function that returns the correct Scheduler implementation
@@ -497,10 +606,10 @@ declare function createScheduler(): Promise<Scheduler>;
  * Uses comment-tagged crontab entries for identification and CRUD.
  */
 declare class CrontabScheduler implements Scheduler {
-    register(job: JobConfig, _env?: Record<string, string>): Promise<void>;
-    unregister(jobId: string): Promise<void>;
-    isRegistered(jobId: string): Promise<boolean>;
-    list(): Promise<RegisteredJob[]>;
+	register(job: JobConfig, _env?: Record<string, string>): Promise<void>;
+	unregister(jobId: string): Promise<void>;
+	isRegistered(jobId: string): Promise<boolean>;
+	list(): Promise<RegisteredJob[]>;
 }
 
 type Platform = "linux" | "darwin" | "win32";
@@ -511,11 +620,11 @@ type Platform = "linux" | "darwin" | "win32";
 declare function detectPlatform(): Platform;
 
 interface CalendarInterval {
-    Month?: number;
-    Day?: number;
-    Weekday?: number;
-    Hour?: number;
-    Minute?: number;
+	Month?: number;
+	Day?: number;
+	Weekday?: number;
+	Hour?: number;
+	Minute?: number;
 }
 /**
  * Convert a 5-field cron expression to launchd scheduling config.
@@ -526,23 +635,23 @@ interface CalendarInterval {
  * Throws if the expression would produce more than 50 calendar intervals.
  */
 declare function cronToCalendarIntervals(cronExpr: string): {
-    calendarIntervals?: CalendarInterval[];
-    startInterval?: number;
+	calendarIntervals?: CalendarInterval[];
+	startInterval?: number;
 };
 /**
  * LaunchdScheduler implements the Scheduler interface for macOS.
  * Uses plist files in ~/Library/LaunchAgents/ and modern launchctl bootstrap/bootout.
  */
 declare class LaunchdScheduler implements Scheduler {
-    register(job: JobConfig, env?: Record<string, string>): Promise<void>;
-    unregister(jobId: string): Promise<void>;
-    isRegistered(jobId: string): Promise<boolean>;
-    list(): Promise<RegisteredJob[]>;
+	register(job: JobConfig, env?: Record<string, string>): Promise<void>;
+	unregister(jobId: string): Promise<void>;
+	isRegistered(jobId: string): Promise<boolean>;
+	list(): Promise<RegisteredJob[]>;
 }
 
 interface SchtasksSchedule {
-    args: string[];
-    description: string;
+	args: string[];
+	description: string;
 }
 /**
  * Translate a 5-field cron expression into schtasks /SC schedule parameters.
@@ -565,10 +674,10 @@ declare function cronToSchtasks(cronExpr: string): SchtasksSchedule;
  * Task name format: `claude-auto-{jobId}`
  */
 declare class SchtasksScheduler implements Scheduler {
-    register(job: JobConfig, _env?: Record<string, string>): Promise<void>;
-    unregister(jobId: string): Promise<void>;
-    isRegistered(jobId: string): Promise<boolean>;
-    list(): Promise<RegisteredJob[]>;
+	register(job: JobConfig, _env?: Record<string, string>): Promise<void>;
+	unregister(jobId: string): Promise<void>;
+	isRegistered(jobId: string): Promise<boolean>;
+	list(): Promise<RegisteredJob[]>;
 }
 
 /**
@@ -576,13 +685,13 @@ declare class SchtasksScheduler implements Scheduler {
  * (issue numbers, PR URLs, branch names) -- never raw narrative summaries.
  */
 interface RunContext {
-    id: string;
-    status: string;
-    pr_url: string | null;
-    branch_name: string | null;
-    issue_number: number | null;
-    summary: string | null;
-    started_at: string;
+	id: string;
+	status: string;
+	pr_url: string | null;
+	branch_name: string | null;
+	issue_number: number | null;
+	summary: string | null;
+	started_at: string;
 }
 /**
  * Persist a run log entry to the SQLite database.
@@ -617,28 +726,28 @@ declare function formatContextWindow(context: RunContext[]): string;
  * before spawning a new run.
  */
 interface BudgetConfig {
-    dailyUsd?: number;
-    weeklyUsd?: number;
-    monthlyUsd?: number;
+	dailyUsd?: number;
+	weeklyUsd?: number;
+	monthlyUsd?: number;
 }
 /**
  * Per-job cost summary row returned by getCostSummary() when no jobId is specified.
  */
 interface CostSummaryRow {
-    job_id: string;
-    runs: number;
-    total_cost: number;
-    avg_cost: number;
-    total_turns: number;
+	job_id: string;
+	runs: number;
+	total_cost: number;
+	avg_cost: number;
+	total_turns: number;
 }
 /**
  * Per-day cost breakdown row returned by getCostSummary(jobId).
  */
 interface DailyCostRow {
-    day: string;
-    runs: number;
-    total_cost: number;
-    total_turns: number;
+	day: string;
+	runs: number;
+	total_cost: number;
+	total_turns: number;
 }
 /**
  * Check whether cumulative cost for a job exceeds any configured budget cap.
@@ -697,7 +806,13 @@ declare function checkoutExistingBranch(repoPath: string, branchName: string): P
  * Create a pull request via GitHub CLI.
  * Returns the PR URL.
  */
-declare function createPR(repoPath: string, branchName: string, baseBranch: string, title: string, body: string): Promise<string>;
+declare function createPR(
+	repoPath: string,
+	branchName: string,
+	baseBranch: string,
+	title: string,
+	body: string,
+): Promise<string>;
 /**
  * Check if the target branch has diverged from the current branch.
  * Fetches the remote base branch first, then uses git merge-base --is-ancestor
@@ -705,13 +820,21 @@ declare function createPR(repoPath: string, branchName: string, baseBranch: stri
  *
  * @returns true if diverged (remote base has commits not in current branch), false otherwise
  */
-declare function checkDivergence(repoPath: string, baseBranch: string, remote: string): Promise<boolean>;
+declare function checkDivergence(
+	repoPath: string,
+	baseBranch: string,
+	remote: string,
+): Promise<boolean>;
 /**
  * Attempt to rebase the current branch onto the remote base branch.
  * First checks for divergence; if not diverged, returns early.
  * If diverged, attempts rebase. On conflict, aborts cleanly and returns conflict list.
  */
-declare function attemptRebase(repoPath: string, baseBranch: string, remote: string): Promise<RebaseResult>;
+declare function attemptRebase(
+	repoPath: string,
+	baseBranch: string,
+	remote: string,
+): Promise<RebaseResult>;
 /**
  * Get the diff between the base branch and HEAD.
  * Best-effort: returns empty string on error.
@@ -723,12 +846,12 @@ declare function getDiffFromBase(repoPath: string, baseBranch: string): Promise<
  * Body is truncated to 1000 chars to reduce token usage.
  */
 interface ScoredIssue {
-    number: number;
-    title: string;
-    body: string;
-    labels: string[];
-    score: number;
-    skipReason?: string;
+	number: number;
+	title: string;
+	body: string;
+	labels: string[];
+	score: number;
+	skipReason?: string;
 }
 /**
  * Triage GitHub issues for a repository by scoring and filtering them
@@ -818,7 +941,13 @@ declare function executeRun(jobId: string): Promise<RunResult>;
  * @param triaged - Pre-scored issues from triage
  * @returns PipelineResult with all stage results aggregated
  */
-declare function runPipeline(config: JobConfig, repoPath: string, _branchName: string, runContext: RunContext[], triaged: ScoredIssue[]): Promise<PipelineResult>;
+declare function runPipeline(
+	config: JobConfig,
+	repoPath: string,
+	_branchName: string,
+	runContext: RunContext[],
+	triaged: ScoredIssue[],
+): Promise<PipelineResult>;
 
 /**
  * Build a read-only tool set for plan and review stages.
@@ -839,7 +968,11 @@ declare function buildReadOnlyTools(_config: JobConfig): string[];
  * @param context - Prior run context for duplicate avoidance
  * @returns Multi-section plan prompt string
  */
-declare function buildPlanPrompt(config: JobConfig, triaged: ScoredIssue[], context: RunContext[]): string;
+declare function buildPlanPrompt(
+	config: JobConfig,
+	triaged: ScoredIssue[],
+	context: RunContext[],
+): string;
 /**
  * Build the system prompt for the PLAN stage.
  *
@@ -857,7 +990,11 @@ declare function buildPlanSystemPrompt(config: JobConfig): string;
  * @param context - Prior run context for duplicate avoidance
  * @returns Multi-section implement prompt string
  */
-declare function buildImplementPrompt(config: JobConfig, planResult: SpawnResult, context: RunContext[]): string;
+declare function buildImplementPrompt(
+	config: JobConfig,
+	planResult: SpawnResult,
+	context: RunContext[],
+): string;
 /**
  * Build the system prompt for the IMPLEMENT stage.
  *
@@ -874,7 +1011,11 @@ declare function buildImplementSystemPrompt(config: JobConfig): string;
  * @param diffOutput - Git diff of implementation changes
  * @returns Multi-section review prompt string
  */
-declare function buildReviewPrompt(_config: JobConfig, planText: string, diffOutput: string): string;
+declare function buildReviewPrompt(
+	_config: JobConfig,
+	planText: string,
+	diffOutput: string,
+): string;
 /**
  * Build the system prompt for the REVIEW stage.
  *
@@ -914,11 +1055,11 @@ declare function parseReviewVerdict(reviewResult: SpawnResult): "pass" | "fail";
  * Not exported -- external consumers use PRFeedbackContext.
  */
 interface PRWithFeedback {
-    number: number;
-    title: string;
-    headRefName: string;
-    reviewDecision: string;
-    url: string;
+	number: number;
+	title: string;
+	headRefName: string;
+	reviewDecision: string;
+	url: string;
 }
 /**
  * List open PRs authored by the current user that match this job's branch prefix.
@@ -928,7 +1069,10 @@ interface PRWithFeedback {
  * @param jobId - Job identifier used to filter branches by prefix
  * @returns Array of PRs matching the claude-auto/{jobId}/ branch prefix
  */
-declare function listOpenPRsWithFeedback(repoPath: string, jobId: string): Promise<PRWithFeedback[]>;
+declare function listOpenPRsWithFeedback(
+	repoPath: string,
+	jobId: string,
+): Promise<PRWithFeedback[]>;
 /**
  * Get the owner and name of the repository from `gh repo view`.
  *
@@ -936,8 +1080,8 @@ declare function listOpenPRsWithFeedback(repoPath: string, jobId: string): Promi
  * @returns Object with owner (login) and name of the repository
  */
 declare function getRepoOwnerName(repoPath: string): Promise<{
-    owner: string;
-    name: string;
+	owner: string;
+	name: string;
 }>;
 /**
  * Fetch unresolved review threads for a PR using the GitHub GraphQL API.
@@ -985,7 +1129,11 @@ declare function getFeedbackRound(jobId: string, prNumber: number): number;
  * @param maxRounds - Maximum number of feedback rounds allowed
  * @returns PRFeedbackContext if there's actionable feedback, null otherwise
  */
-declare function checkPendingPRFeedback(repoPath: string, jobId: string, maxRounds: number): Promise<PRFeedbackContext | null>;
+declare function checkPendingPRFeedback(
+	repoPath: string,
+	jobId: string,
+	maxRounds: number,
+): Promise<PRFeedbackContext | null>;
 
 /**
  * Build the system prompt for Claude, including research instructions
@@ -1020,7 +1168,11 @@ declare function buildWorkPrompt(config: JobConfig, context?: RunContext[]): str
  * @param context - Optional array of prior run context
  * @returns Multi-section feedback prompt string
  */
-declare function buildFeedbackPrompt(config: JobConfig, feedback: PRFeedbackContext, context?: RunContext[]): string;
+declare function buildFeedbackPrompt(
+	config: JobConfig,
+	feedback: PRFeedbackContext,
+	context?: RunContext[],
+): string;
 /**
  * Build a work prompt enhanced with pre-triaged issue candidates.
  *
@@ -1033,7 +1185,11 @@ declare function buildFeedbackPrompt(config: JobConfig, feedback: PRFeedbackCont
  * @param context - Optional array of prior run context
  * @returns Multi-section work prompt string
  */
-declare function buildTriagedWorkPrompt(config: JobConfig, triaged: ScoredIssue[], context?: RunContext[]): string;
+declare function buildTriagedWorkPrompt(
+	config: JobConfig,
+	triaged: ScoredIssue[],
+	context?: RunContext[],
+): string;
 
 /**
  * Build the list of allowed tools for Claude based on job config guardrails.
@@ -1060,78 +1216,218 @@ declare function spawnClaude(options: SpawnOptions): Promise<SpawnResult>;
 declare function launchDashboard(): Promise<void>;
 
 declare class ConfigParseError extends Error {
-    readonly filePath: string;
-    readonly parseErrors: Array<{
-        message: string;
-    }>;
-    name: "ConfigParseError";
-    constructor(filePath: string, parseErrors: Array<{
-        message: string;
-    }>);
+	readonly filePath: string;
+	readonly parseErrors: Array<{
+		message: string;
+	}>;
+	name: "ConfigParseError";
+	constructor(
+		filePath: string,
+		parseErrors: Array<{
+			message: string;
+		}>,
+	);
 }
 declare class ConfigValidationError extends Error {
-    readonly filePath: string;
-    readonly validationMessage: string;
-    name: "ConfigValidationError";
-    constructor(filePath: string, validationMessage: string);
+	readonly filePath: string;
+	readonly validationMessage: string;
+	name: "ConfigValidationError";
+	constructor(filePath: string, validationMessage: string);
 }
 declare class SchedulerError extends Error {
-    readonly platform: string;
-    readonly cause?: Error | undefined;
-    name: "SchedulerError";
-    constructor(platform: string, message: string, cause?: Error | undefined);
+	readonly platform: string;
+	readonly cause?: Error | undefined;
+	name: "SchedulerError";
+	constructor(platform: string, message: string, cause?: Error | undefined);
 }
 declare class CronValidationError extends Error {
-    readonly expression: string;
-    name: "CronValidationError";
-    constructor(expression: string, message: string);
+	readonly expression: string;
+	name: "CronValidationError";
+	constructor(expression: string, message: string);
 }
 declare class GitOpsError extends Error {
-    readonly operation: string;
-    readonly repoPath: string;
-    readonly cause?: Error | undefined;
-    name: "GitOpsError";
-    constructor(operation: string, repoPath: string, message: string, cause?: Error | undefined);
+	readonly operation: string;
+	readonly repoPath: string;
+	readonly cause?: Error | undefined;
+	name: "GitOpsError";
+	constructor(operation: string, repoPath: string, message: string, cause?: Error | undefined);
 }
 declare class LockError extends Error {
-    readonly jobId: string;
-    name: "LockError";
-    constructor(jobId: string, message: string);
+	readonly jobId: string;
+	name: "LockError";
+	constructor(jobId: string, message: string);
 }
 declare class SpawnError extends Error {
-    readonly exitCode?: number | undefined;
-    name: "SpawnError";
-    constructor(message: string, exitCode?: number | undefined);
+	readonly exitCode?: number | undefined;
+	name: "SpawnError";
+	constructor(message: string, exitCode?: number | undefined);
 }
 
 interface ExecResult {
-    stdout: string;
-    stderr: string;
+	stdout: string;
+	stderr: string;
 }
 /**
  * Execute a command and return stdout/stderr.
  * Throws if the command exits with non-zero status.
  */
-declare function execCommand(command: string, args: string[], options?: {
-    stdin?: string;
-    cwd?: string;
-}): Promise<ExecResult>;
+declare function execCommand(
+	command: string,
+	args: string[],
+	options?: {
+		stdin?: string;
+		cwd?: string;
+	},
+): Promise<ExecResult>;
 
 declare function writeFileSafe(filePath: string, content: string): Promise<void>;
 
 declare const paths: {
-    readonly base: string;
-    readonly jobs: string;
-    readonly jobDir: (jobId: string) => string;
-    readonly jobConfig: (jobId: string) => string;
-    readonly logs: string;
-    readonly jobLogs: (jobId: string) => string;
-    readonly jobLog: (jobId: string, runId: string) => string;
-    readonly jobLock: (jobId: string) => string;
-    readonly plistDir: string;
-    readonly plistPath: (jobId: string) => string;
-    readonly crontabLock: string;
-    readonly database: string;
+	readonly base: string;
+	readonly jobs: string;
+	readonly jobDir: (jobId: string) => string;
+	readonly jobConfig: (jobId: string) => string;
+	readonly logs: string;
+	readonly jobLogs: (jobId: string) => string;
+	readonly jobLog: (jobId: string, runId: string) => string;
+	readonly jobLock: (jobId: string) => string;
+	readonly plistDir: string;
+	readonly plistPath: (jobId: string) => string;
+	readonly crontabLock: string;
+	readonly database: string;
 };
 
-export { type BudgetConfig, COMMANDS, type CalendarInterval, type CliCommand, type CommandHandler, ConfigParseError, ConfigValidationError, type CostSummaryRow, CronValidationError, CrontabScheduler, type DailyCostRow, type EventTriggers, GitOpsError, type JobConfig, JobConfigSchema, LaunchdScheduler, LockError, type NotificationEvent, type NotificationPayload, type PRFeedbackContext, type ParsedCommand, type PipelineResult, type PipelineStageResult, type Platform, type RebaseResult, type RegisteredJob, type ReviewThread, type RunContext, type RunLogEntry, type RunResult, type RunStatus, STALE_THRESHOLD, type ScheduleInfo, type Scheduler, SchedulerError, SchtasksScheduler, type ScoredIssue, SpawnError, type SpawnOptions, type SpawnResult, acquireLock, attemptRebase, buildAllowedTools, buildFeedbackPrompt, buildFixPrompt, buildFixSystemPrompt, buildImplementPrompt, buildImplementSystemPrompt, buildPayload, buildPlanPrompt, buildPlanSystemPrompt, buildReadOnlyTools, buildReviewPrompt, buildReviewSystemPrompt, buildSystemPrompt, buildTriagedWorkPrompt, buildWorkPrompt, checkBudget, checkDivergence, checkPendingPRFeedback, checkRepoCommand, checkoutExistingBranch, closeDatabase, costCommand, createBranch, createCommand, createJob, createPR, createScheduler, cronToCalendarIntervals, cronToSchtasks, deleteJob, describeSchedule, detectPlatform, editCommand, execCommand, executeRun, extractIssueNumber, formatContextWindow, formatDiscord, formatDuration, formatRelativeTime, formatSlack, formatTable, formatTelegram, getCostSummary, getDatabase, getDiffFromBase, getFeedbackRound, getNextRuns, getRepoOwnerName, getUnresolvedThreads, hasChanges, launchDashboard, listCommand, listJobs, listOpenPRsWithFeedback, listRunLogs, loadJobConfig, loadRunContext, logsCommand, parseCommand, parseReviewVerdict, paths, pauseCommand, postIssueComment, postPRComment, pullLatest, pushBranch, readConfigDocument, readJob, readRunLog, removeCommand, reportCommand, resumeCommand, runCli, runPipeline, saveJobConfig, saveRunContext, sendNotifications, shouldNotify, spawnClaude, statusBadge, triageIssues, updateConfigField, updateJob, validateAndDescribeSchedule, validateConfig, validateCronExpression, writeConfigDocument, writeFileSafe, writeRunLog };
+export {
+	type BudgetConfig,
+	COMMANDS,
+	type CalendarInterval,
+	type CliCommand,
+	type CommandHandler,
+	ConfigParseError,
+	ConfigValidationError,
+	type CostSummaryRow,
+	CronValidationError,
+	CrontabScheduler,
+	type DailyCostRow,
+	type EventTriggers,
+	GitOpsError,
+	type JobConfig,
+	JobConfigSchema,
+	LaunchdScheduler,
+	LockError,
+	type NotificationEvent,
+	type NotificationPayload,
+	type PRFeedbackContext,
+	type ParsedCommand,
+	type PipelineResult,
+	type PipelineStageResult,
+	type Platform,
+	type RebaseResult,
+	type RegisteredJob,
+	type ReviewThread,
+	type RunContext,
+	type RunLogEntry,
+	type RunResult,
+	type RunStatus,
+	STALE_THRESHOLD,
+	type ScheduleInfo,
+	type Scheduler,
+	SchedulerError,
+	SchtasksScheduler,
+	type ScoredIssue,
+	SpawnError,
+	type SpawnOptions,
+	type SpawnResult,
+	acquireLock,
+	attemptRebase,
+	buildAllowedTools,
+	buildFeedbackPrompt,
+	buildFixPrompt,
+	buildFixSystemPrompt,
+	buildImplementPrompt,
+	buildImplementSystemPrompt,
+	buildPayload,
+	buildPlanPrompt,
+	buildPlanSystemPrompt,
+	buildReadOnlyTools,
+	buildReviewPrompt,
+	buildReviewSystemPrompt,
+	buildSystemPrompt,
+	buildTriagedWorkPrompt,
+	buildWorkPrompt,
+	checkBudget,
+	checkDivergence,
+	checkPendingPRFeedback,
+	checkRepoCommand,
+	checkoutExistingBranch,
+	closeDatabase,
+	costCommand,
+	createBranch,
+	createCommand,
+	createJob,
+	createPR,
+	createScheduler,
+	cronToCalendarIntervals,
+	cronToSchtasks,
+	deleteJob,
+	describeSchedule,
+	detectPlatform,
+	editCommand,
+	execCommand,
+	executeRun,
+	extractIssueNumber,
+	formatContextWindow,
+	formatDiscord,
+	formatDuration,
+	formatRelativeTime,
+	formatSlack,
+	formatTable,
+	formatTelegram,
+	getCostSummary,
+	getDatabase,
+	getDiffFromBase,
+	getFeedbackRound,
+	getNextRuns,
+	getRepoOwnerName,
+	getUnresolvedThreads,
+	hasChanges,
+	launchDashboard,
+	listCommand,
+	listJobs,
+	listOpenPRsWithFeedback,
+	listRunLogs,
+	loadJobConfig,
+	loadRunContext,
+	logsCommand,
+	parseCommand,
+	parseReviewVerdict,
+	paths,
+	pauseCommand,
+	postIssueComment,
+	postPRComment,
+	pullLatest,
+	pushBranch,
+	readConfigDocument,
+	readJob,
+	readRunLog,
+	removeCommand,
+	reportCommand,
+	resumeCommand,
+	runCli,
+	runPipeline,
+	saveJobConfig,
+	saveRunContext,
+	sendNotifications,
+	shouldNotify,
+	spawnClaude,
+	statusBadge,
+	triageIssues,
+	updateConfigField,
+	updateJob,
+	validateAndDescribeSchedule,
+	validateConfig,
+	validateCronExpression,
+	writeConfigDocument,
+	writeFileSafe,
+	writeRunLog,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cjvana/claude-auto",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "Autonomous Claude Code cron jobs for continuous codebase improvement",
 	"type": "module",
 	"engines": {