@fractary/faber 2.4.0 → 2.4.1

package/dist/index.d.ts

@@ -15,6 +15,7 @@
 export * from './types.js';
 export * from './errors.js';
 export * from './config.js';
+export * from './paths.js';
 export * from './work/index.js';
 export * from './repo/index.js';
 export * from './logs/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAG5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAG3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -16,6 +16,7 @@
 export * from './types.js';
 export * from './errors.js';
 export * from './config.js';
+export * from './paths.js';
 // Module exports
 export * from './work/index.js';
 export * from './repo/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,cAAc;AACd,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,cAAc;AACd,cAAc,iBAAiB,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Centralized path definitions for FABER
+ *
+ * This module provides the single source of truth for all FABER run-related paths.
+ * All run files (plan.json, state.json) are stored in a unified directory structure:
+ * .fractary/faber/runs/{run_id}/
+ *
+ * These paths are committable (not gitignored) to enable:
+ * - Workflow state persistence across sessions
+ * - Team visibility into workflow progress
+ * - Historical tracking of workflow runs
+ */
+/**
+ * Base directory for all FABER runs (relative to project root)
+ */
+export declare const FABER_RUNS_DIR = ".fractary/faber/runs";
+/**
+ * Get the runs directory path
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the runs directory
+ */
+export declare function getRunsDir(projectRoot?: string): string;
+/**
+ * Get the directory path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the run directory
+ */
+export declare function getRunDir(runId: string, projectRoot?: string): string;
+/**
+ * Get the plan file path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the plan.json file
+ */
+export declare function getPlanPath(runId: string, projectRoot?: string): string;
+/**
+ * Get the state file path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the state.json file
+ */
+export declare function getStatePath(runId: string, projectRoot?: string): string;
+/**
+ * Get relative path constants (for documentation and gitignore)
+ */
+export declare const RELATIVE_PATHS: {
+    /** Relative path to runs directory from project root */
+    readonly RUNS_DIR: ".fractary/faber/runs";
+    /** Template for run directory path */
+    readonly RUN_DIR_TEMPLATE: ".fractary/faber/runs/{run_id}";
+    /** Template for plan file path */
+    readonly PLAN_PATH_TEMPLATE: ".fractary/faber/runs/{run_id}/plan.json";
+    /** Template for state file path */
+    readonly STATE_PATH_TEMPLATE: ".fractary/faber/runs/{run_id}/state.json";
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,eAAO,MAAM,cAAc,yBAAyB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,wDAAwD;;IAExD,sCAAsC;;IAEtC,kCAAkC;;IAElC,mCAAmC;;CAE3B,CAAC"}

package/dist/paths.js

@@ -0,0 +1,68 @@
+/**
+ * Centralized path definitions for FABER
+ *
+ * This module provides the single source of truth for all FABER run-related paths.
+ * All run files (plan.json, state.json) are stored in a unified directory structure:
+ * .fractary/faber/runs/{run_id}/
+ *
+ * These paths are committable (not gitignored) to enable:
+ * - Workflow state persistence across sessions
+ * - Team visibility into workflow progress
+ * - Historical tracking of workflow runs
+ */
+import * as path from 'path';
+/**
+ * Base directory for all FABER runs (relative to project root)
+ */
+export const FABER_RUNS_DIR = '.fractary/faber/runs';
+/**
+ * Get the runs directory path
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the runs directory
+ */
+export function getRunsDir(projectRoot) {
+    const root = projectRoot || process.cwd();
+    return path.join(root, FABER_RUNS_DIR);
+}
+/**
+ * Get the directory path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the run directory
+ */
+export function getRunDir(runId, projectRoot) {
+    const root = projectRoot || process.cwd();
+    return path.join(root, FABER_RUNS_DIR, runId);
+}
+/**
+ * Get the plan file path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the plan.json file
+ */
+export function getPlanPath(runId, projectRoot) {
+    return path.join(getRunDir(runId, projectRoot), 'plan.json');
+}
+/**
+ * Get the state file path for a specific run
+ * @param runId - The run identifier
+ * @param projectRoot - Optional project root path (defaults to current working directory)
+ * @returns Absolute path to the state.json file
+ */
+export function getStatePath(runId, projectRoot) {
+    return path.join(getRunDir(runId, projectRoot), 'state.json');
+}
+/**
+ * Get relative path constants (for documentation and gitignore)
+ */
+export const RELATIVE_PATHS = {
+    /** Relative path to runs directory from project root */
+    RUNS_DIR: FABER_RUNS_DIR,
+    /** Template for run directory path */
+    RUN_DIR_TEMPLATE: `${FABER_RUNS_DIR}/{run_id}`,
+    /** Template for plan file path */
+    PLAN_PATH_TEMPLATE: `${FABER_RUNS_DIR}/{run_id}/plan.json`,
+    /** Template for state file path */
+    STATE_PATH_TEMPLATE: `${FABER_RUNS_DIR}/{run_id}/state.json`,
+};
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,WAAoB;IAC7C,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,WAAoB;IAC3D,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,WAAoB;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,WAAoB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,wDAAwD;IACxD,QAAQ,EAAE,cAAc;IACxB,sCAAsC;IACtC,gBAAgB,EAAE,GAAG,cAAc,WAAW;IAC9C,kCAAkC;IAClC,kBAAkB,EAAE,GAAG,cAAc,qBAAqB;IAC1D,mCAAmC;IACnC,mBAAmB,EAAE,GAAG,cAAc,sBAAsB;CACpD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/faber",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "FABER SDK - Development toolkit for AI-assisted workflows",
   "type": "module",
   "main": "dist/index.js",