@ariacode/cli 0.2.2 → 0.2.3

package/dist/actions.d.ts

@@ -8,6 +8,7 @@
  * - Agent loop execution
  * - Terminal output
  */
+import type { SessionStatus } from "./storage.js";
 /**
  * Options parsed from CLI flags for the ask command.
  */
@@ -26,20 +27,21 @@ export interface AskOptions {
     provider?: string;
     /** Override model (v0.2.2) */
     model?: string;
+    /** Output format (v0.2.3) */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
 }
 /**
  * Execute the ask command.
  *
  * Flow:
- * 1. Load configuration and detect project type          (Req 9.1)
- * 2. Create or resume session with mode: "plan"          (Req 9.2, 9.9)
- * 3. Build system prompt from ask.md template            (Req 9.3)
- * 4. Expose only read-only tools                         (Req 9.4)
- * 5. Execute agent loop                                  (Req 9.5, 9.6)
- * 6. Render response to terminal                         (Req 9.7)
- * 7. Persist session to database                         (Req 9.8)
+ * 1. Load configuration and detect project type
+ * 2. Create or resume session with mode: "plan"
+ * 3. Build system prompt from ask.md template
+ * 4. Expose only read-only tools
+ * 5. Execute agent loop
+ * 6. Render response to terminal
+ * 7. Persist session to database
  *
- * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8, 9.9
  */
 export declare function runAsk(options: AskOptions): Promise<void>;
 /**
@@ -60,21 +62,22 @@ export interface PlanOptions {
     provider?: string;
     /** Override model (v0.2.2) */
     model?: string;
+    /** Output format (v0.2.3) */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
 }
 /**
  * Execute the plan command.
  *
  * Flow:
- * 1. Load configuration and detect project type          (Req 10.1)
- * 2. Create or resume session with mode: "plan"          (Req 10.2, 10.8)
- * 3. Build system prompt from plan.md template           (Req 10.3)
- * 4. Expose only read-only tools                         (Req 10.4)
- * 5. Execute agent loop                                  (Req 10.5)
- * 6. Render structured plan to terminal                  (Req 10.6)
- * 7. Save to file if --output flag provided              (Req 10.7)
- * 8. Persist session to database                         (Req 10.8)
+ * 1. Load configuration and detect project type
+ * 2. Create or resume session with mode: "plan"
+ * 3. Build system prompt from plan.md template
+ * 4. Expose only read-only tools
+ * 5. Execute agent loop
+ * 6. Render structured plan to terminal
+ * 7. Save to file if --output flag provided
+ * 8. Persist session to database
  *
- * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5, 10.6, 10.7, 10.8
  */
 export declare function runPlan(options: PlanOptions): Promise<void>;
 /**
@@ -97,26 +100,29 @@ export interface PatchOptions {
     provider?: string;
     /** Override model (v0.2.2) */
     model?: string;
+    /** Render diff in side-by-side layout when terminal is wide enough */
+    split?: boolean;
+    /** Output format */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
 }
 /**
  * Execute the patch command.
  *
  * Flow:
- * 1. Load configuration and detect project type          (Req 11.1)
- * 2. Create session with mode: "build"                   (Req 11.2)
- * 3. Build system prompt from patch.md template          (Req 11.3)
- * 4. Expose read-only + mutation tools                   (Req 11.4)
- * 5. Execute agent loop — agent calls propose_diff       (Req 11.4, 11.5)
- * 6. Render diff preview with syntax highlighting        (Req 11.6)
- * 7. Render mutation summary                             (Req 11.7)
- * 8. If --dry-run, exit with code 0                      (Req 11.8, 17.3, 17.4)
- * 9. If not --yes, prompt for confirmation               (Req 11.9, 17.5)
- * 10. Agent calls apply_diff atomically                  (Req 11.10, 11.11, 11.12)
- * 11. Log mutation to database                           (Req 11.11)
- * 12. Display rollback hints                             (Req 11.12, 17.9)
- * 13. Persist session to database                        (Req 11.13)
+ * 1. Load configuration and detect project type
+ * 2. Create session with mode: "build"
+ * 3. Build system prompt from patch.md template
+ * 4. Expose read-only + mutation tools
+ * 5. Execute agent loop — agent calls propose_diff
+ * 6. Render diff preview with syntax highlighting
+ * 7. Render mutation summary
+ * 8. If --dry-run, exit with code 0
+ * 9. If not --yes, prompt for confirmation
+ * 10. Agent calls apply_diff atomically
+ * 11. Log mutation to database
+ * 12. Display rollback hints
+ * 13. Persist session to database
  *
- * Requirements: 11.1–11.13, 17.1–17.9
  */
 export declare function runPatch(options: PatchOptions): Promise<void>;
 /**
@@ -127,8 +133,8 @@ export interface ReviewOptions {
     unstaged?: boolean;
     /** Compare current branch to specified base branch */
     branch?: string;
-    /** Output format: "text" (default) or "json" */
-    format?: "text" | "json";
+    /** Output format */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
     /** Suppress non-essential output */
     quiet?: boolean;
     /** Project root (defaults to process.cwd()) */
@@ -153,18 +159,17 @@ export interface ReviewResult {
  * Execute the review command.
  *
  * Flow:
- * 1. Parse flags and load configuration                  (Req 12.1)
- * 2. Detect project type                                 (Req 12.1)
- * 3. Create session with mode: "plan"                    (Req 12.2)
- * 4. Read git diff (staged / unstaged / branch)          (Req 12.3, 12.4, 12.5)
- * 5. Build system prompt from review.md template         (Req 12.6)
- * 6. Send diff + project context to provider             (Req 12.6)
- * 7. Parse structured review (summary, issues, suggestions) (Req 12.7)
- * 8. Render review to terminal                           (Req 12.8)
- * 9. Output JSON if --format json                        (Req 12.9)
- * 10. Persist session to database                        (Req 12.10)
+ * 1. Parse flags and load configuration
+ * 2. Detect project type
+ * 3. Create session with mode: "plan"
+ * 4. Read git diff (staged / unstaged / branch)
+ * 5. Build system prompt from review.md template
+ * 6. Send diff + project context to provider
+ * 7. Parse structured review (summary, issues, suggestions)
+ * 8. Render review to terminal
+ * 9. Output JSON if --format json
+ * 10. Persist session to database
  *
- * Requirements: 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 12.7, 12.8, 12.9, 12.10
  */
 export declare function runReview(options: ReviewOptions): Promise<void>;
 /**
@@ -183,24 +188,25 @@ export interface ExploreOptions {
     provider?: string;
     /** Override model (v0.2.2) */
     model?: string;
+    /** Output format (v0.2.3) */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
 }
 /**
  * Execute the explore command.
  *
  * Flow:
- * 1. Parse flags and load configuration                  (Req 13.1)
- * 2. Detect project type                                 (Req 13.1)
- * 3. Create session with mode: "plan"                    (Req 13.2)
- * 4. Scan repository structure respecting .gitignore     (Req 13.3)
- * 5. Detect frameworks and key configuration files       (Req 13.4)
- * 6. Identify entry points based on project type         (Req 13.5)
- * 7. Build system prompt from explore.md template        (Req 13.3–13.6)
- * 8. Execute agent loop to summarize structure/patterns  (Req 13.6)
- * 9. Render exploration summary to terminal              (Req 13.7)
- * 10. Save to ./.aria/explore.md if --save flag          (Req 13.8)
- * 11. Persist session to database                        (Req 13.10)
+ * 1. Parse flags and load configuration
+ * 2. Detect project type
+ * 3. Create session with mode: "plan"
+ * 4. Scan repository structure respecting .gitignore
+ * 5. Detect frameworks and key configuration files
+ * 6. Identify entry points based on project type
+ * 7. Build system prompt from explore.md template
+ * 8. Execute agent loop to summarize structure/patterns
+ * 9. Render exploration summary to terminal
+ * 10. Save to ./.aria/explore.md if --save flag
+ * 11. Persist session to database
  *
- * Requirements: 13.1, 13.2, 13.3, 13.4, 13.5, 13.6, 13.7, 13.8, 13.9, 13.10
  */
 export declare function runExplore(options: ExploreOptions): Promise<void>;
 /**
@@ -217,18 +223,29 @@ export interface HistoryOptions {
     quiet?: boolean;
     /** Project root (defaults to process.cwd()) */
     projectRoot?: string;
+    /** Full-text search query across session content  */
+    search?: string;
+    /** Filter by command name  */
+    command?: string;
+    /** Filter by date expression, e.g. "3 days ago"  */
+    since?: string;
+    /** Filter by session status */
+    status?: SessionStatus;
+    /** Export session transcript to markdown file at this path */
+    export?: string;
+    /** Output format */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
 }
 /**
  * Execute the history command.
  *
  * Flow:
- * 1. If no --session flag: list recent sessions in a table  (Req 14.2, 14.3, 14.4)
- * 2. If --session flag: display full session log            (Req 14.5)
- * 3. If --tree flag: render tool execution tree             (Req 14.6)
- * 4. Format timestamps in human-readable format             (Req 14.7)
- * 5. Support pagination for large result sets               (Req 14.8)
+ * 1. If no --session flag: list recent sessions in a table
+ * 2. If --session flag: display full session log
+ * 3. If --tree flag: render tool execution tree
+ * 4. Format timestamps in human-readable format
+ * 5. Support pagination for large result sets
  *
- * Requirements: 14.1, 14.2, 14.3, 14.4, 14.5, 14.6, 14.7, 14.8
  */
 export declare function runHistory(options: HistoryOptions): Promise<void>;
 /**
@@ -254,21 +271,20 @@ export interface ConfigOptions {
  * Execute the config command.
  *
  * Subcommands:
- * - (none): Display effective configuration with precedence sources  (Req 15.2)
- * - get <key>: Display value for specified key                       (Req 15.3)
- * - set <key> <value>: Write key-value to ~/.aria/config.toml        (Req 15.4–15.6, 15.10)
- * - path: Display configuration file resolution paths               (Req 15.7)
- * - init: Create ./.aria.toml with default values                   (Req 15.8, 15.9)
+ * - (none): Display effective configuration with precedence sources
+ * - get <key>: Display value for specified key
+ * - set <key> <value>: Write key-value to ~/.aria/config.toml
+ * - path: Display configuration file resolution paths
+ * - init: Create ./.aria.toml with default values
  *
- * Requirements: 15.1–15.10
  */
 export declare function runConfig(options: ConfigOptions): Promise<void>;
 /**
  * Options parsed from CLI flags for the doctor command.
  */
 export interface DoctorOptions {
-    /** Output format: "text" (default) or "json" */
-    format?: "text" | "json";
+    /** Output format */
+    format?: 'text' | 'json' | 'ndjson' | 'plain';
     /** Project root (defaults to process.cwd()) */
     projectRoot?: string;
 }
@@ -286,6 +302,5 @@ export interface DiagnosticCheck {
  * Runs a series of environment diagnostic checks and reports results.
  * Exits with code 1 if any critical check fails.
  *
- * Requirements: 16.1–16.13
  */
 export declare function runDoctor(options?: DoctorOptions): Promise<void>;