@iloom/cli 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -287,6 +287,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         model?: "opus" | "sonnet" | "haiku" | undefined;
     }>>;
     capabilities: z.ZodOptional<z.ZodObject<{
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<["cli", "web"]>, "many">>;
         web: z.ZodOptional<z.ZodObject<{
             basePort: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
@@ -308,6 +309,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         database?: {
             databaseUrlEnvVarName: string;
         } | undefined;
+        capabilities?: ("cli" | "web")[] | undefined;
     }, {
         web?: {
             basePort?: number | undefined;
@@ -315,6 +317,7 @@ declare const IloomSettingsSchema: z.ZodObject<{
         database?: {
             databaseUrlEnvVarName?: string | undefined;
         } | undefined;
+        capabilities?: ("cli" | "web")[] | undefined;
     }>>;
     databaseProviders: z.ZodOptional<z.ZodObject<{
         neon: z.ZodOptional<z.ZodObject<{
@@ -412,6 +415,15 @@ declare const IloomSettingsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sourceEnvOnStart: boolean;
     attribution: "off" | "upstreamOnly" | "on";
+    capabilities?: {
+        web?: {
+            basePort?: number | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName: string;
+        } | undefined;
+        capabilities?: ("cli" | "web")[] | undefined;
+    } | undefined;
     mainBranch?: string | undefined;
     worktreePrefix?: string | undefined;
     protectedBranches?: string[] | undefined;
@@ -454,14 +466,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
     summary?: {
         model: "opus" | "sonnet" | "haiku";
     } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName: string;
-        } | undefined;
-    } | undefined;
     databaseProviders?: {
         neon?: {
             projectId: string;
@@ -491,6 +495,15 @@ declare const IloomSettingsSchema: z.ZodObject<{
         vscode: boolean;
     } | undefined;
 }, {
+    capabilities?: {
+        web?: {
+            basePort?: number | undefined;
+        } | undefined;
+        database?: {
+            databaseUrlEnvVarName?: string | undefined;
+        } | undefined;
+        capabilities?: ("cli" | "web")[] | undefined;
+    } | undefined;
     mainBranch?: string | undefined;
     sourceEnvOnStart?: boolean | undefined;
     worktreePrefix?: string | undefined;
@@ -534,14 +547,6 @@ declare const IloomSettingsSchema: z.ZodObject<{
     summary?: {
         model?: "opus" | "sonnet" | "haiku" | undefined;
     } | undefined;
-    capabilities?: {
-        web?: {
-            basePort?: number | undefined;
-        } | undefined;
-        database?: {
-            databaseUrlEnvVarName?: string | undefined;
-        } | undefined;
-    } | undefined;
     databaseProviders?: {
         neon?: {
             projectId: string;
@@ -1195,6 +1200,8 @@ interface CleanupOptions {
     dryRun?: boolean;
     /** Output result as JSON */
     json?: boolean;
+    /** Wait specified milliseconds before cleanup execution */
+    defer?: number;
 }
 interface ListOptions {
     json?: boolean;
@@ -1282,9 +1289,12 @@ interface ValidationResult {
 interface CommitOptions {
     dryRun?: boolean;
     issueNumber?: string | number;
+    issuePrefix: string;
     message?: string;
     noReview?: boolean;
     skipVerify?: boolean;
+    skipVerifySilent?: boolean;
+    trailerType?: 'Refs' | 'Fixes';
 }
 /**
  * Error thrown when user aborts a commit operation
@@ -1437,6 +1447,7 @@ declare class EnvironmentManager {
      * Implements:
      * - Issue/PR: 3000 + issue/PR number
      * - Branch: 3000 + deterministic hash offset (1-999)
+     * Delegates to calculatePortFromIdentifier for the core calculation.
      */
     calculatePort(options: PortAssignmentOptions): number;
     /**
@@ -1561,16 +1572,9 @@ declare class PromptTemplateManager {
      */
     loadTemplate(templateName: 'issue' | 'pr' | 'regular' | 'init' | 'session-summary'): Promise<string>;
     /**
-     * Substitute variables in a template string
+     * Substitute variables in a template string using Handlebars
      */
     substituteVariables(template: string, variables: TemplateVariables): string;
-    /**
-     * Process conditional sections in template
-     * Format: {{#IF ONE_SHOT_MODE}}content{{/IF ONE_SHOT_MODE}}
-     *
-     * Note: /s flag allows . to match newlines
-     */
-    private processConditionalSections;
     /**
      * Get a fully processed prompt for a workflow type
      */
@@ -1653,6 +1657,7 @@ interface WriteMetadataInput {
     issueUrls: Record<string, string>;
     prUrls: Record<string, string>;
     draftPrNumber?: number;
+    capabilities: ProjectCapability[];
     parentLoom?: {
         type: 'issue' | 'pr' | 'branch';
         identifier: string | number;
@@ -1665,6 +1670,8 @@ interface WriteMetadataInput {
  * Result of reading metadata for a worktree
  */
 interface LoomMetadata {
+    status?: 'active' | 'finished';
+    finishedAt?: string | null;
     description: string;
     created_at: string | null;
     branchName: string | null;
@@ -1679,6 +1686,7 @@ interface LoomMetadata {
     issueUrls: Record<string, string>;
     prUrls: Record<string, string>;
     draftPrNumber: number | null;
+    capabilities: ProjectCapability[];
     parentLoom: {
         type: 'issue' | 'pr' | 'branch';
         identifier: string | number;
@@ -1700,7 +1708,12 @@ interface LoomMetadata {
  */
 declare class MetadataManager {
     private readonly loomsDir;
+    private readonly finishedDir;
     constructor();
+    /**
+     * Convert MetadataFile to LoomMetadata with default values for optional fields
+     */
+    private toMetadata;
     /**
      * Convert worktree path to filename slug per spec section 2.2
      *
@@ -1757,11 +1770,42 @@ declare class MetadataManager {
      * @param worktreePath - Absolute path to the worktree
      */
     deleteMetadata(worktreePath: string): Promise<void>;
+    /**
+     * Archive metadata for a finished worktree
+     *
+     * Moves the metadata file to the finished/ subdirectory and adds
+     * status: 'finished' and finishedAt timestamp fields.
+     *
+     * Idempotent: silently succeeds if source file doesn't exist
+     * Non-fatal: logs warning on errors but doesn't throw
+     *
+     * @param worktreePath - Absolute path to the worktree
+     */
+    archiveMetadata(worktreePath: string): Promise<void>;
+    /**
+     * List all finished loom metadata files
+     *
+     * Returns an array of LoomMetadata objects for all finished looms
+     * in the finished/ subdirectory, sorted by finishedAt in descending order
+     * (most recently finished first).
+     *
+     * @returns Array of LoomMetadata objects from finished files, sorted by finishedAt desc
+     */
+    listFinishedMetadata(): Promise<LoomMetadata[]>;
 }
 
+/**
+ * Custom error class for Git command failures
+ * Preserves exit code and stderr for precise error handling
+ */
+declare class GitCommandError extends Error {
+    readonly exitCode: number | undefined;
+    readonly stderr: string;
+    constructor(message: string, exitCode: number | undefined, stderr: string);
+}
 /**
  * Execute a Git command and return the stdout result
- * Throws an error if the command fails
+ * Throws a GitCommandError if the command fails
  */
 declare function executeGitCommand(args: string[], options?: {
     cwd?: string;
@@ -2001,7 +2045,7 @@ declare function getMergeTargetBranch(worktreePath?: string, options?: {
  * Created during il start to enable draft PR creation (GitHub requires at least one commit ahead of base).
  * Removed during il finish before the final push to maintain clean commit history.
  */
-declare const PLACEHOLDER_COMMIT_PREFIX = "[iloom-temp]";
+declare const PLACEHOLDER_COMMIT_PREFIX = "[iloom]";
 /**
  * Check if HEAD commit is a placeholder commit
  * @param cwd - Working directory (defaults to process.cwd())
@@ -2223,4 +2267,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, 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, 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 };