@fractary/faber 2.4.41 → 2.4.42

package/dist/faber/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/faber/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,YAAY,EACV,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGhE,YAAY,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGhE,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/faber/index.js

@@ -0,0 +1,15 @@
+/**
+ * @fractary/faber - FABER Plugin SDK
+ *
+ * SDK for FABER workflow state and configuration management.
+ *
+ * Note: Common types like FaberPhase, WorkflowStatus, AutonomyLevel are
+ * exported from the main '@fractary/faber' module to avoid conflicts.
+ * Import them from '@fractary/faber' instead of '@fractary/faber/faber'.
+ */
+// Export managers
+export { FaberStateManager } from './state-manager';
+export { FaberConfigManager } from './config-manager';
+// Export utility functions
+export { createDefaultPhaseState, createDefaultPhases, getNextPhase, getPreviousPhase, FABER_PHASE_ORDER, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/faber/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/faber/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA4CtD,2BAA2B;AAC3B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/faber/state-manager.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @fractary/faber - FABER State Manager
+ *
+ * Manages FABER workflow state for per-run tracking.
+ * State is stored at: .fractary/plugins/faber/runs/{run_id}/state.json
+ */
+import { FaberState, FaberPhase, FaberError, WorkflowStatus, CreateStateOptions, UpdateStateOptions, StateListFilters, TransitionResult, FaberStateManagerConfig } from './types';
+/**
+ * FaberStateManager - Manages FABER workflow state
+ *
+ * Provides CRUD operations for workflow state with atomic file operations
+ * and support for phase transitions.
+ */
+export declare class FaberStateManager {
+    private readonly stateDir;
+    private readonly runsDir;
+    constructor(config?: FaberStateManagerConfig);
+    /**
+     * Get state file path for a run
+     */
+    private getStatePath;
+    /**
+     * Get run directory path
+     */
+    private getRunDir;
+    /**
+     * Ensure directory exists
+     */
+    private ensureDir;
+    /**
+     * Generate ISO timestamp
+     */
+    private timestamp;
+    /**
+     * Read state from file with validation
+     */
+    private readState;
+    /**
+     * Write state to file atomically
+     * Uses write to temp file + rename for atomic operation
+     */
+    private writeState;
+    /**
+     * Get workflow state for a run
+     */
+    get(runId: string): Promise<FaberState | null>;
+    /**
+     * Create new workflow state
+     */
+    create(runId: string, target: string, options?: CreateStateOptions): Promise<FaberState>;
+    /**
+     * Update workflow state
+     */
+    update(runId: string, updates: Partial<FaberState>, options?: UpdateStateOptions): Promise<FaberState>;
+    /**
+     * Delete workflow state
+     */
+    delete(runId: string): Promise<void>;
+    /**
+     * Start a phase
+     */
+    startPhase(runId: string, phase: FaberPhase): Promise<FaberState>;
+    /**
+     * Complete a phase
+     */
+    completePhase(runId: string, phase: FaberPhase, artifacts?: Record<string, string>): Promise<FaberState>;
+    /**
+     * Fail a phase
+     */
+    failPhase(runId: string, phase: FaberPhase, error: Omit<FaberError, 'phase' | 'timestamp'>): Promise<FaberState>;
+    /**
+     * Skip a phase
+     */
+    skipPhase(runId: string, phase: FaberPhase): Promise<FaberState>;
+    /**
+     * Update current step within a phase
+     */
+    setCurrentStep(runId: string, phase: FaberPhase, stepName: string): Promise<FaberState>;
+    /**
+     * Mark a step as completed
+     */
+    completeStep(runId: string, phase: FaberPhase, stepName: string): Promise<FaberState>;
+    /**
+     * Transition workflow to a new status
+     */
+    transition(runId: string, toStatus: WorkflowStatus): Promise<TransitionResult>;
+    /**
+     * List workflow states with optional filters
+     */
+    list(filters?: StateListFilters): Promise<FaberState[]>;
+    /**
+     * Get the latest workflow state for a work ID
+     */
+    getLatestForWorkId(workId: string): Promise<FaberState | null>;
+    /**
+     * Get active (in_progress) workflow state for a work ID
+     */
+    getActiveForWorkId(workId: string): Promise<FaberState | null>;
+    /**
+     * Check if a run exists
+     */
+    exists(runId: string): Promise<boolean>;
+    /**
+     * Add an artifact to the workflow state
+     */
+    addArtifact(runId: string, key: string, value: string): Promise<FaberState>;
+    /**
+     * Add a commit to the workflow artifacts
+     */
+    addCommit(runId: string, commitSha: string): Promise<FaberState>;
+    /**
+     * Record an error
+     */
+    recordError(runId: string, error: Omit<FaberError, 'timestamp'>): Promise<FaberState>;
+    /**
+     * Add a pending approval request
+     */
+    requestApproval(runId: string, phase: FaberPhase, reason: string): Promise<FaberState>;
+    /**
+     * Clear pending approvals and resume
+     */
+    clearApproval(runId: string): Promise<FaberState>;
+}
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/faber/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/faber/state-manager.ts"],"names":[],"mappings":"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"}