@iloom/cli 0.8.3 → 0.9.0

package/dist/index.d.ts

@@ -269,14 +269,17 @@ declare const IloomSettingsSchema: z.ZodObject<{
         model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         providers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["claude", "gemini", "codex"]>, z.ZodString>>;
+        review: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         model?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
     }, {
         model?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
     }>>>>;
     spin: z.ZodOptional<z.ZodObject<{
         model: z.ZodDefault<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
@@ -406,12 +409,15 @@ declare const IloomSettingsSchema: z.ZodObject<{
     mergeBehavior: z.ZodOptional<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<["local", "github-pr", "github-draft-pr"]>>;
         remote: z.ZodOptional<z.ZodString>;
+        autoCommitPush: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         mode: "local" | "github-pr" | "github-draft-pr";
         remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
     }, {
         remote?: string | undefined;
         mode?: "local" | "github-pr" | "github-draft-pr" | undefined;
+        autoCommitPush?: boolean | undefined;
     }>>;
     ide: z.ZodOptional<z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]>>;
@@ -485,6 +491,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         model?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
     }> | null | undefined;
     spin?: {
         model: "opus" | "sonnet" | "haiku";
@@ -512,6 +519,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
     mergeBehavior?: {
         mode: "local" | "github-pr" | "github-draft-pr";
         remote?: string | undefined;
+        autoCommitPush?: boolean | undefined;
     } | undefined;
     ide?: {
         type: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity";
@@ -573,6 +581,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         model?: "opus" | "sonnet" | "haiku" | undefined;
         enabled?: boolean | undefined;
         providers?: Partial<Record<"claude" | "gemini" | "codex", string>> | undefined;
+        review?: boolean | undefined;
     }> | null | undefined;
     spin?: {
         model?: "opus" | "sonnet" | "haiku" | undefined;
@@ -600,6 +609,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
     mergeBehavior?: {
         remote?: string | undefined;
         mode?: "local" | "github-pr" | "github-draft-pr" | undefined;
+        autoCommitPush?: boolean | undefined;
     } | undefined;
     ide?: {
         type?: "vscode" | "cursor" | "webstorm" | "sublime" | "intellij" | "windsurf" | "antigravity" | undefined;
@@ -916,7 +926,7 @@ interface CleanupResult {
  */
 interface OperationResult {
     /** Type of operation performed */
-    type: 'dev-server' | 'worktree' | 'branch' | 'database' | 'cli-symlinks';
+    type: 'dev-server' | 'worktree' | 'branch' | 'database' | 'cli-symlinks' | 'recap' | 'metadata';
     /** Whether operation succeeded */
     success: boolean;
     /** Human-readable message */
@@ -1616,8 +1626,11 @@ interface TemplateVariables {
     COMPACT_SUMMARIES?: string;
     RECAP_DATA?: string;
     DRAFT_PR_NUMBER?: number;
+    DRAFT_PR_URL?: string;
     DRAFT_PR_MODE?: boolean;
+    AUTO_COMMIT_PUSH?: boolean;
     STANDARD_ISSUE_MODE?: boolean;
+    STANDARD_BRANCH_MODE?: boolean;
     IS_VSCODE_MODE?: boolean;
     HAS_PACKAGE_JSON?: boolean;
     NO_PACKAGE_JSON?: boolean;
@@ -1628,6 +1641,19 @@ interface TemplateVariables {
     HAS_REVIEW_CLAUDE?: boolean;
     HAS_REVIEW_GEMINI?: boolean;
     HAS_REVIEW_CODEX?: boolean;
+    ARTIFACT_REVIEW_ENABLED?: boolean;
+    ARTIFACT_REVIEW_CLAUDE_MODEL?: string;
+    ARTIFACT_REVIEW_GEMINI_MODEL?: string;
+    ARTIFACT_REVIEW_CODEX_MODEL?: string;
+    HAS_ARTIFACT_REVIEW_CLAUDE?: boolean;
+    HAS_ARTIFACT_REVIEW_GEMINI?: boolean;
+    HAS_ARTIFACT_REVIEW_CODEX?: boolean;
+    ENHANCER_REVIEW_ENABLED?: boolean;
+    ANALYZER_REVIEW_ENABLED?: boolean;
+    PLANNER_REVIEW_ENABLED?: boolean;
+    ANALYZE_AND_PLAN_REVIEW_ENABLED?: boolean;
+    IMPLEMENTER_REVIEW_ENABLED?: boolean;
+    COMPLEXITY_REVIEW_ENABLED?: boolean;
     EXISTING_ISSUE_MODE?: boolean;
     FRESH_PLANNING_MODE?: boolean;
     PARENT_ISSUE_NUMBER?: string | undefined;
@@ -1644,6 +1670,7 @@ interface TemplateVariables {
     USE_GEMINI_REVIEWER?: boolean;
     USE_CODEX_REVIEWER?: boolean;
     HAS_REVIEWER?: boolean;
+    GIT_REMOTE?: string;
 }
 declare class PromptTemplateManager {
     private templateDir;
@@ -2030,6 +2057,14 @@ declare function ensureRepositoryHasCommits(path?: string): Promise<void>;
 declare function pushBranchToRemote(branchName: string, worktreePath: string, options?: {
     dryRun?: boolean;
 }): Promise<void>;
+/**
+ * Fetch from origin to ensure we have latest refs
+ * Used before branching and rebasing operations to stay current with remote
+ *
+ * @param cwd - Working directory to run git command in
+ * @throws Error if fetch fails (network issues, access denied, etc.)
+ */
+declare function fetchOrigin(cwd: string): Promise<void>;
 /**
  * Check if a file is tracked by git
  * Uses git ls-files to check if file is in the index
@@ -2350,4 +2385,4 @@ declare class TableFormatter {
     static previewFormatting(headers: string[], options?: TableFormatterOptions): string;
 }
 
-export { type AddIssueOptions, type AddIssueResult, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, type BranchGenerationOptions, type BranchNameStrategy, type Capability, type ClaudeContext, ClaudeContextManager, type CleanupOptions, type CleanupResult, type ColorData, type CommitOptions, type Config, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type FeedbackOptions, type FinishOptions, type FinishResult, GitCommandError, GitHubService, type GitStatus, type GitWorktree, GitWorktreeManager, type InstallationMethod, type Issue, type IssueTracker, IssueTrackerFactory, type IssueTrackerInputDetection, type IssueTrackerProviderType, type LaunchMode, LinearMarkupConverter, type ListOptions, type Logger, type LoggerOptions, type Loom, type LoomSummary, type MergeOptions, type MergeResult, type MockOptions, type OneShotMode, type OperationResult, PLACEHOLDER_COMMIT_PREFIX, type PRWorktreePattern, type Platform, type PortAssignmentOptions, type ProcessInfo, type ProjectCapability, type PullRequest, type RemoteBranchStatus, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type StartOptions, type StartResult, type SummaryResult, TableFormatter, type TableFormatterOptions, type TableGenerationOptions, type UpdateCheckCache, type UpdateCheckResult, UserAbortedCommitError, type ValidationOptions, type ValidationResult, type ValidationStepResult, type Workspace, type WorkspaceInput, WorkspaceManager, type WorkspaceSummary, type Worktree, type WorktreeCleanupOptions, type WorktreeCreateOptions, type WorktreeListOptions, type WorktreeOperationResult, type WorktreeStatus, type WorktreeValidation, branchExists, checkRemoteBranchStatus, createLogger, createStderrLogger, ensureRepositoryHasCommits, executeGitCommand, extractIssueNumber, extractPRNumber, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, findPlaceholderCommitSha, findWorktreeForBranch, generateWorktreePath, getCurrentBranch, getDefaultBranch, getMergeTargetBranch, getRepoRoot, getThemeMode, getWorktreeRoot, hasUncommittedChanges, isBranchMergedIntoMain, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isPlaceholderCommit, isRemoteBranchUpToDate, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote, removePlaceholderCommitFromHead, removePlaceholderCommitFromHistory, setThemeMode };
+export { type AddIssueOptions, type AddIssueResult, type BatchCleanupResult, type BranchCleanupTarget, type BranchDeleteOptions, type BranchGenerationOptions, type BranchNameStrategy, type Capability, type ClaudeContext, ClaudeContextManager, type CleanupOptions, type CleanupResult, type ColorData, type CommitOptions, type Config, type CreateLoomInput, type DatabaseDeletionResult, DatabaseManager, type DatabaseProvider, type EnhanceOptions, type EnhanceResult, type EnvFileOptions, type EnvOperationResult, type EnvVariable, EnvironmentManager, type FeedbackOptions, type FinishOptions, type FinishResult, GitCommandError, GitHubService, type GitStatus, type GitWorktree, GitWorktreeManager, type InstallationMethod, type Issue, type IssueTracker, IssueTrackerFactory, type IssueTrackerInputDetection, type IssueTrackerProviderType, type LaunchMode, LinearMarkupConverter, type ListOptions, type Logger, type LoggerOptions, type Loom, type LoomSummary, type MergeOptions, type MergeResult, type MockOptions, type OneShotMode, type OperationResult, PLACEHOLDER_COMMIT_PREFIX, type PRWorktreePattern, type Platform, type PortAssignmentOptions, type ProcessInfo, type ProjectCapability, type PullRequest, type RemoteBranchStatus, type ResourceCleanupOptions, type RgbColor, type SafetyCheck, type StartOptions, type StartResult, type SummaryResult, TableFormatter, type TableFormatterOptions, type TableGenerationOptions, type UpdateCheckCache, type UpdateCheckResult, UserAbortedCommitError, type ValidationOptions, type ValidationResult, type ValidationStepResult, type Workspace, type WorkspaceInput, WorkspaceManager, type WorkspaceSummary, type Worktree, type WorktreeCleanupOptions, type WorktreeCreateOptions, type WorktreeListOptions, type WorktreeOperationResult, type WorktreeStatus, type WorktreeValidation, branchExists, checkRemoteBranchStatus, createLogger, createStderrLogger, ensureRepositoryHasCommits, executeGitCommand, extractIssueNumber, extractPRNumber, fetchOrigin, findAllBranchesForIssue, findMainWorktreePath, findMainWorktreePathWithSettings, findPlaceholderCommitSha, findWorktreeForBranch, generateWorktreePath, getCurrentBranch, getDefaultBranch, getMergeTargetBranch, getRepoRoot, getThemeMode, getWorktreeRoot, hasUncommittedChanges, isBranchMergedIntoMain, isEmptyRepository, isFileGitignored, isFileTrackedByGit, isPRBranch, isPlaceholderCommit, isRemoteBranchUpToDate, isValidGitRepo, isWorktreePath, logger, parseWorktreeList, pushBranchToRemote, removePlaceholderCommitFromHead, removePlaceholderCommitFromHistory, setThemeMode };

package/dist/index.js

@@ -507,7 +507,8 @@ var init_SettingsManager = __esm({
       providers: z.record(
         z.enum(["claude", "gemini", "codex"]),
         z.string()
-      ).optional().describe('Map of review providers to model names. Keys: claude, gemini, codex. Values: model name strings (e.g., "sonnet", "gemini-3-pro-preview", "gpt-5.2-codex")')
+      ).optional().describe('Map of review providers to model names. Keys: claude, gemini, codex. Values: model name strings (e.g., "sonnet", "gemini-3-pro-preview", "gpt-5.2-codex")'),
+      review: z.boolean().optional().describe("Whether artifacts from this agent should be reviewed before posting (defaults to false)")
     });
     SpinAgentSettingsSchema = z.object({
       model: z.enum(["sonnet", "opus", "haiku"]).default("opus").describe("Claude model shorthand for spin orchestrator")
@@ -605,7 +606,7 @@ var init_SettingsManager = __esm({
       copyGitIgnoredPatterns: z.array(z.string().min(1, "Pattern cannot be empty")).optional().describe(`Glob patterns for gitignored files to copy to looms (e.g., ["*.db", "data/*.sqlite"]). Great for local dbs and large test data files that are too big to commit to git. Note: .env (dotenv-flow) files, iloom's and claude's local settings are automatically copied and do not need to be specified here.`),
       workflows: WorkflowsSettingsSchema.describe("Per-workflow-type permission configurations"),
       agents: z.record(z.string(), AgentSettingsSchema).optional().nullable().describe(
-        "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements)"
+        "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting)"
       ),
       spin: SpinAgentSettingsSchema.optional().describe(
         "Spin orchestrator configuration. Model defaults to opus when not configured."
@@ -619,6 +620,7 @@ var init_SettingsManager = __esm({
       capabilities: CapabilitiesSettingsSchema.describe("Project capability configurations"),
       databaseProviders: DatabaseProvidersSettingsSchema.describe("Database provider configurations"),
       issueManagement: z.object({
+        // SYNC: If this default changes, update displayDefaultsBox() in src/utils/first-run-setup.ts
         provider: z.enum(["github", "linear"]).optional().default("github").describe("Issue tracker provider (github, linear)"),
         github: z.object({
           remote: z.string().min(1, "Remote name cannot be empty").describe("Git remote name to use for GitHub operations")
@@ -630,10 +632,15 @@ var init_SettingsManager = __esm({
         }).optional()
       }).optional().describe("Issue management configuration"),
       mergeBehavior: z.object({
+        // SYNC: If this default changes, update displayDefaultsBox() in src/utils/first-run-setup.ts
         mode: z.enum(["local", "github-pr", "github-draft-pr"]).default("local"),
-        remote: z.string().optional()
+        remote: z.string().optional(),
+        autoCommitPush: z.boolean().optional().describe(
+          "Auto-commit and push after code review in draft PR mode. Defaults to true when mode is github-draft-pr."
+        )
       }).optional().describe("Merge behavior configuration: local (merge locally), github-pr (create PR), or github-draft-pr (create draft PR at start, mark ready on finish)"),
       ide: z.object({
+        // SYNC: If this default changes, update displayDefaultsBox() in src/utils/first-run-setup.ts
         type: z.enum(["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]).default("vscode").describe(
           "IDE to launch when starting a loom. Options: vscode (Visual Studio Code), cursor (Cursor AI editor), webstorm (JetBrains WebStorm), sublime (Sublime Text), intellij (JetBrains IntelliJ IDEA), windsurf (Windsurf editor), antigravity (Antigravity IDE)."
         )
@@ -680,7 +687,7 @@ var init_SettingsManager = __esm({
       copyGitIgnoredPatterns: z.array(z.string().min(1, "Pattern cannot be empty")).optional().describe(`Glob patterns for gitignored files to copy to looms (e.g., ["*.db", "data/*.sqlite"]). Great for local dbs and large test data files that are too big to commit to git. Note: .env (dotenv-flow) files, iloom's and claude's local settings are automatically copied and do not need to be specified here.`),
       workflows: WorkflowsSettingsSchemaNoDefaults.describe("Per-workflow-type permission configurations"),
       agents: z.record(z.string(), AgentSettingsSchema).optional().nullable().describe(
-        "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements)"
+        "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting)"
       ),
       spin: z.object({
         model: z.enum(["sonnet", "opus", "haiku"]).optional()
@@ -708,7 +715,10 @@ var init_SettingsManager = __esm({
       }).optional().describe("Issue management configuration"),
       mergeBehavior: z.object({
         mode: z.enum(["local", "github-pr", "github-draft-pr"]).optional(),
-        remote: z.string().optional()
+        remote: z.string().optional(),
+        autoCommitPush: z.boolean().optional().describe(
+          "Auto-commit and push after code review in draft PR mode. Defaults to true when mode is github-draft-pr."
+        )
       }).optional().describe("Merge behavior configuration: local (merge locally), github-pr (create PR), or github-draft-pr (create draft PR at start, mark ready on finish)"),
       ide: z.object({
         type: z.enum(["vscode", "cursor", "webstorm", "sublime", "intellij", "windsurf", "antigravity"]).optional().describe(
@@ -1987,6 +1997,22 @@ async function pushBranchToRemote(branchName, worktreePath, options) {
     throw new Error(`Failed to push to remote: ${errorMessage}`);
   }
 }
+async function fetchOrigin(cwd) {
+  try {
+    await executeGitCommand(["fetch", "origin"], {
+      cwd,
+      timeout: 6e4
+      // 60 second timeout for fetch operations
+    });
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Failed to fetch from origin: ${errorMessage}
+
+Check your network connection and repository access.`
+    );
+  }
+}
 async function isFileTrackedByGit(filePath, cwd = process.cwd()) {
   try {
     const result = await executeGitCommand(
@@ -2261,7 +2287,7 @@ var GitWorktreeManager = class {
     } else if (options.baseBranch) {
       args.push(options.baseBranch);
     }
-    await executeGitCommand(args, { cwd: this._workingDirectory });
+    await executeGitCommand(args, { cwd: this._workingDirectory, timeout: 3e5 });
     return absolutePath;
   }
   /**
@@ -3911,13 +3937,16 @@ function parseJsonStreamOutput(output) {
   }
 }
 async function launchClaude(prompt, options = {}) {
-  const { model, permissionMode, addDir, headless = false, appendSystemPrompt, mcpConfig, allowedTools, disallowedTools, agents, sessionId, noSessionPersistence } = options;
+  const { model, permissionMode, addDir, headless = false, appendSystemPrompt, mcpConfig, allowedTools, disallowedTools, agents, sessionId, noSessionPersistence, outputFormat, verbose, jsonMode } = options;
   const log = getLogger();
   const args = [];
   if (headless) {
     args.push("-p");
-    args.push("--output-format", "stream-json");
-    args.push("--verbose");
+    const effectiveOutputFormat = outputFormat ?? "stream-json";
+    args.push("--output-format", effectiveOutputFormat);
+    if (verbose !== false) {
+      args.push("--verbose");
+    }
   }
   if (model) {
     args.push("--model", model);
@@ -3975,7 +4004,10 @@ async function launchClaude(prompt, options = {}) {
         subprocess.stdout.on("data", (chunk) => {
           const text = chunk.toString();
           outputBuffer += text;
-          if (isDebugMode) {
+          if (jsonMode === "stream") {
+            process.stdout.write(text);
+          } else if (jsonMode === "json") {
+          } else if (isDebugMode) {
             log.stdout.write(text);
           } else {
             if (isFirstProgress) {
@@ -3990,7 +4022,7 @@ async function launchClaude(prompt, options = {}) {
       const result = await subprocess;
       if (isStreaming) {
         const rawOutput = outputBuffer.trim();
-        if (!isDebugMode) {
+        if (!isDebugMode && !jsonMode) {
           log.stdout.write("\n");
         }
         return isJsonStreamFormat ? parseJsonStreamOutput(rawOutput) : rawOutput;
@@ -4075,7 +4107,10 @@ async function launchClaude(prompt, options = {}) {
             subprocess.stdout.on("data", (chunk) => {
               const text = chunk.toString();
               outputBuffer += text;
-              if (isDebugMode) {
+              if (jsonMode === "stream") {
+                process.stdout.write(text);
+              } else if (jsonMode === "json") {
+              } else if (isDebugMode) {
                 log.stdout.write(text);
               } else {
                 if (isFirstProgress) {
@@ -4090,7 +4125,7 @@ async function launchClaude(prompt, options = {}) {
           const result = await subprocess;
           if (isStreaming) {
             const rawOutput = outputBuffer.trim();
-            if (!isDebugMode) {
+            if (!isDebugMode && !jsonMode) {
               log.stdout.write("\n");
             }
             return isJsonStreamFormat ? parseJsonStreamOutput(rawOutput) : rawOutput;
@@ -4725,6 +4760,7 @@ export {
   executeGitCommand,
   extractIssueNumber,
   extractPRNumber,
+  fetchOrigin,
   findAllBranchesForIssue,
   findMainWorktreePath,
   findMainWorktreePathWithSettings,