@fractary/faber-cli 1.5.13 → 1.5.14

package/dist/commands/runs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs command - Query FABER run paths
+ *
+ * This command provides access to run directory and file paths for scripts and tools.
+ * It uses the SDK's centralized path definitions, ensuring consistency across all tools.
+ *
+ * All run files are stored in: .fractary/faber/runs/{run_id}/
+ * - plan.json: The execution plan
+ * - state.json: The workflow state
+ */
+import { Command } from 'commander';
+export declare function createRunsCommand(): Command;
+//# sourceMappingURL=runs.d.ts.map

package/dist/commands/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,iBAAiB,IAAI,OAAO,CAkH3C"}

package/dist/commands/runs.js

@@ -0,0 +1,127 @@
+/**
+ * Runs command - Query FABER run paths
+ *
+ * This command provides access to run directory and file paths for scripts and tools.
+ * It uses the SDK's centralized path definitions, ensuring consistency across all tools.
+ *
+ * All run files are stored in: .fractary/faber/runs/{run_id}/
+ * - plan.json: The execution plan
+ * - state.json: The workflow state
+ */
+import { Command } from 'commander';
+import { FABER_RUNS_DIR, getRunsDir, getRunDir, getPlanPath, getStatePath, RELATIVE_PATHS, } from '@fractary/faber';
+export function createRunsCommand() {
+    const runsCmd = new Command('runs')
+        .description('Query FABER run paths');
+    runsCmd
+        .command('dir')
+        .description('Show runs directory path or specific run directory')
+        .argument('[run_id]', 'Run ID (optional - omit for base runs directory)')
+        .option('--relative', 'Output relative path instead of absolute')
+        .option('--json', 'Output as JSON')
+        .action((runId, options) => {
+        try {
+            if (runId) {
+                // Specific run directory
+                const absPath = getRunDir(runId);
+                const relPath = `${FABER_RUNS_DIR}/${runId}`;
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        run_id: runId,
+                        absolute: absPath,
+                        relative: relPath,
+                    }, null, 2));
+                }
+                else {
+                    console.log(options.relative ? relPath : absPath);
+                }
+            }
+            else {
+                // Base runs directory
+                const absPath = getRunsDir();
+                if (options.json) {
+                    console.log(JSON.stringify({
+                        absolute: absPath,
+                        relative: FABER_RUNS_DIR,
+                    }, null, 2));
+                }
+                else {
+                    console.log(options.relative ? FABER_RUNS_DIR : absPath);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    runsCmd
+        .command('plan-path')
+        .description('Show plan file path for a run')
+        .argument('<run_id>', 'Run ID')
+        .option('--relative', 'Output relative path instead of absolute')
+        .option('--json', 'Output as JSON')
+        .action((runId, options) => {
+        try {
+            const absPath = getPlanPath(runId);
+            const relPath = `${FABER_RUNS_DIR}/${runId}/plan.json`;
+            if (options.json) {
+                console.log(JSON.stringify({
+                    run_id: runId,
+                    absolute: absPath,
+                    relative: relPath,
+                }, null, 2));
+            }
+            else {
+                console.log(options.relative ? relPath : absPath);
+            }
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    runsCmd
+        .command('state-path')
+        .description('Show state file path for a run')
+        .argument('<run_id>', 'Run ID')
+        .option('--relative', 'Output relative path instead of absolute')
+        .option('--json', 'Output as JSON')
+        .action((runId, options) => {
+        try {
+            const absPath = getStatePath(runId);
+            const relPath = `${FABER_RUNS_DIR}/${runId}/state.json`;
+            if (options.json) {
+                console.log(JSON.stringify({
+                    run_id: runId,
+                    absolute: absPath,
+                    relative: relPath,
+                }, null, 2));
+            }
+            else {
+                console.log(options.relative ? relPath : absPath);
+            }
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    runsCmd
+        .command('paths')
+        .description('Show all path templates')
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        if (options.json) {
+            console.log(JSON.stringify(RELATIVE_PATHS, null, 2));
+        }
+        else {
+            console.log('FABER Run Path Templates:');
+            console.log(`  Runs Directory:  ${RELATIVE_PATHS.RUNS_DIR}`);
+            console.log(`  Run Directory:   ${RELATIVE_PATHS.RUN_DIR_TEMPLATE}`);
+            console.log(`  Plan File:       ${RELATIVE_PATHS.PLAN_PATH_TEMPLATE}`);
+            console.log(`  State File:      ${RELATIVE_PATHS.STATE_PATH_TEMPLATE}`);
+        }
+    });
+    return runsCmd;
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA0KxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA2KxC"}

package/dist/index.js

@@ -19,11 +19,12 @@ import { createMigrateCommand } from './commands/migrate.js';
 import { createPlanCommand } from './commands/plan/index.js';
 import { createAuthCommand } from './commands/auth/index.js';
 import { createConfigCommand } from './commands/config.js';
+import { createRunsCommand } from './commands/runs.js';
 // Force unbuffered output to prevent buffering issues in terminals
 if (process.stdout.isTTY) {
     process.stdout._handle?.setBlocking?.(true);
 }
-const version = '1.5.13';
+const version = '1.5.14';
 /**
  * Create and configure the main CLI program
  */
@@ -39,6 +40,7 @@ export function createFaberCLI() {
     program.addCommand(createInitCommand()); // init
     program.addCommand(createMigrateCommand()); // migrate
     program.addCommand(createConfigCommand()); // config get/path/exists
+    program.addCommand(createRunsCommand()); // runs dir/plan-path/state-path
     program.addCommand(createPlanCommand()); // plan
     program.addCommand(createRunCommand()); // workflow-run
     program.addCommand(createStatusCommand()); // run-inspect

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/faber-cli",
-  "version": "1.5.13",
+  "version": "1.5.14",
   "description": "FABER CLI - Command-line interface for FABER development toolkit",
   "main": "dist/index.js",
   "bin": {
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@fractary/core": "^0.5.0",
-    "@fractary/faber": "^2.3.0",
+    "@fractary/faber": "^2.4.0",
     "ajv": "^8.12.0",
     "chalk": "^5.0.0",
     "commander": "^12.0.0",