@fractary/faber 0.1.1 → 1.0.0

package/dist/spec/templates.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fractary/faber - Spec Templates
+ *
+ * Built-in specification templates for different work types.
+ */
+import { SpecTemplate, SpecTemplateType } from './types';
+/**
+ * All built-in templates
+ */
+export declare const templates: Record<SpecTemplateType, SpecTemplate>;
+/**
+ * Get a template by type
+ */
+export declare function getTemplate(type: SpecTemplateType): SpecTemplate;
+/**
+ * List all available templates
+ */
+export declare function listTemplates(): SpecTemplate[];
+/**
+ * Generate spec content from a template
+ */
+export declare function generateSpecContent(template: SpecTemplate, options: {
+    title: string;
+    workId?: string;
+    workType: string;
+    context?: string;
+}): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/spec/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/spec/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyRzD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAM5D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,CA0CR"}

package/dist/spec/templates.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * @fractary/faber - Spec Templates
+ *
+ * Built-in specification templates for different work types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templates = void 0;
+exports.getTemplate = getTemplate;
+exports.listTemplates = listTemplates;
+exports.generateSpecContent = generateSpecContent;
+/**
+ * Basic template - minimal structure for simple tasks
+ */
+const basicTemplate = {
+    id: 'basic',
+    name: 'Basic',
+    description: 'Minimal template for simple tasks and quick changes',
+    sections: [
+        {
+            id: 'objective',
+            title: 'Objective',
+            required: true,
+            description: 'What needs to be accomplished',
+            defaultContent: '<!-- Describe the main goal -->',
+        },
+        {
+            id: 'requirements',
+            title: 'Requirements',
+            required: true,
+            description: 'List of specific requirements',
+            defaultContent: '- [ ] Requirement 1\n- [ ] Requirement 2',
+        },
+        {
+            id: 'acceptance-criteria',
+            title: 'Acceptance Criteria',
+            required: true,
+            description: 'How to verify the work is complete',
+            defaultContent: '- [ ] Criterion 1\n- [ ] Criterion 2',
+        },
+    ],
+};
+/**
+ * Feature template - comprehensive structure for new features
+ */
+const featureTemplate = {
+    id: 'feature',
+    name: 'Feature',
+    description: 'Comprehensive template for new feature development',
+    sections: [
+        {
+            id: 'overview',
+            title: 'Overview',
+            required: true,
+            description: 'High-level description of the feature',
+            defaultContent: '<!-- Describe the feature and its value -->',
+        },
+        {
+            id: 'user-stories',
+            title: 'User Stories',
+            required: true,
+            description: 'User stories or use cases',
+            defaultContent: '- As a [user type], I want [goal] so that [benefit]',
+        },
+        {
+            id: 'requirements',
+            title: 'Requirements',
+            required: true,
+            description: 'Functional and non-functional requirements',
+            defaultContent: '### Functional\n- [ ] Requirement 1\n\n### Non-Functional\n- [ ] Requirement 1',
+        },
+        {
+            id: 'technical-design',
+            title: 'Technical Design',
+            required: false,
+            description: 'Technical approach and architecture decisions',
+            defaultContent: '<!-- Describe the technical approach -->',
+        },
+        {
+            id: 'api-changes',
+            title: 'API Changes',
+            required: false,
+            description: 'Any API changes or additions',
+            defaultContent: '<!-- Document any API changes -->',
+        },
+        {
+            id: 'data-model',
+            title: 'Data Model',
+            required: false,
+            description: 'Database or data structure changes',
+            defaultContent: '<!-- Document data model changes -->',
+        },
+        {
+            id: 'acceptance-criteria',
+            title: 'Acceptance Criteria',
+            required: true,
+            description: 'How to verify the feature is complete',
+            defaultContent: '- [ ] Criterion 1\n- [ ] Criterion 2',
+        },
+        {
+            id: 'testing',
+            title: 'Testing Strategy',
+            required: true,
+            description: 'How the feature will be tested',
+            defaultContent: '### Unit Tests\n- [ ] Test 1\n\n### Integration Tests\n- [ ] Test 1',
+        },
+        {
+            id: 'rollout',
+            title: 'Rollout Plan',
+            required: false,
+            description: 'How the feature will be deployed',
+            defaultContent: '<!-- Describe rollout strategy -->',
+        },
+    ],
+};
+/**
+ * Bug template - structure for bug fixes
+ */
+const bugTemplate = {
+    id: 'bug',
+    name: 'Bug Fix',
+    description: 'Template for bug investigation and fixes',
+    sections: [
+        {
+            id: 'description',
+            title: 'Bug Description',
+            required: true,
+            description: 'Description of the bug and its impact',
+            defaultContent: '<!-- Describe the bug -->',
+        },
+        {
+            id: 'reproduction',
+            title: 'Steps to Reproduce',
+            required: true,
+            description: 'How to reproduce the bug',
+            defaultContent: '1. Step 1\n2. Step 2\n3. Expected: ...\n4. Actual: ...',
+        },
+        {
+            id: 'root-cause',
+            title: 'Root Cause Analysis',
+            required: false,
+            description: 'Investigation findings',
+            defaultContent: '<!-- Document root cause -->',
+        },
+        {
+            id: 'solution',
+            title: 'Proposed Solution',
+            required: true,
+            description: 'How the bug will be fixed',
+            defaultContent: '<!-- Describe the fix -->',
+        },
+        {
+            id: 'affected-areas',
+            title: 'Affected Areas',
+            required: true,
+            description: 'What parts of the system are affected',
+            defaultContent: '- [ ] Component 1\n- [ ] Component 2',
+        },
+        {
+            id: 'testing',
+            title: 'Testing',
+            required: true,
+            description: 'How to verify the fix',
+            defaultContent: '- [ ] Regression test\n- [ ] Edge case tests',
+        },
+    ],
+};
+/**
+ * Infrastructure template - for infrastructure and DevOps work
+ */
+const infrastructureTemplate = {
+    id: 'infrastructure',
+    name: 'Infrastructure',
+    description: 'Template for infrastructure and DevOps changes',
+    sections: [
+        {
+            id: 'objective',
+            title: 'Objective',
+            required: true,
+            description: 'What infrastructure change is needed',
+            defaultContent: '<!-- Describe the objective -->',
+        },
+        {
+            id: 'current-state',
+            title: 'Current State',
+            required: true,
+            description: 'Current infrastructure configuration',
+            defaultContent: '<!-- Describe current state -->',
+        },
+        {
+            id: 'proposed-changes',
+            title: 'Proposed Changes',
+            required: true,
+            description: 'What changes will be made',
+            defaultContent: '- [ ] Change 1\n- [ ] Change 2',
+        },
+        {
+            id: 'security',
+            title: 'Security Considerations',
+            required: true,
+            description: 'Security implications and mitigations',
+            defaultContent: '<!-- Document security considerations -->',
+        },
+        {
+            id: 'rollback',
+            title: 'Rollback Plan',
+            required: true,
+            description: 'How to rollback if something goes wrong',
+            defaultContent: '<!-- Document rollback procedure -->',
+        },
+        {
+            id: 'monitoring',
+            title: 'Monitoring & Alerts',
+            required: false,
+            description: 'What monitoring will be added',
+            defaultContent: '<!-- Document monitoring changes -->',
+        },
+        {
+            id: 'verification',
+            title: 'Verification',
+            required: true,
+            description: 'How to verify the changes are working',
+            defaultContent: '- [ ] Verification step 1\n- [ ] Verification step 2',
+        },
+    ],
+};
+/**
+ * API template - for API design and implementation
+ */
+const apiTemplate = {
+    id: 'api',
+    name: 'API',
+    description: 'Template for API design and implementation',
+    sections: [
+        {
+            id: 'overview',
+            title: 'Overview',
+            required: true,
+            description: 'High-level description of the API',
+            defaultContent: '<!-- Describe the API purpose -->',
+        },
+        {
+            id: 'endpoints',
+            title: 'Endpoints',
+            required: true,
+            description: 'API endpoint specifications',
+            defaultContent: '### `GET /api/v1/resource`\n\n**Description:** ...\n\n**Parameters:**\n- `param1` (string, required): ...\n\n**Response:**\n```json\n{\n  "data": []\n}\n```',
+        },
+        {
+            id: 'authentication',
+            title: 'Authentication',
+            required: true,
+            description: 'How the API is authenticated',
+            defaultContent: '<!-- Document auth requirements -->',
+        },
+        {
+            id: 'error-handling',
+            title: 'Error Handling',
+            required: true,
+            description: 'Error codes and responses',
+            defaultContent: '| Code | Message | Description |\n|------|---------|-------------|\n| 400 | Bad Request | ... |',
+        },
+        {
+            id: 'rate-limiting',
+            title: 'Rate Limiting',
+            required: false,
+            description: 'Rate limiting configuration',
+            defaultContent: '<!-- Document rate limits -->',
+        },
+        {
+            id: 'versioning',
+            title: 'Versioning',
+            required: false,
+            description: 'API versioning strategy',
+            defaultContent: '<!-- Document versioning approach -->',
+        },
+        {
+            id: 'testing',
+            title: 'Testing',
+            required: true,
+            description: 'API testing strategy',
+            defaultContent: '- [ ] Unit tests\n- [ ] Integration tests\n- [ ] Contract tests',
+        },
+    ],
+};
+/**
+ * All built-in templates
+ */
+exports.templates = {
+    basic: basicTemplate,
+    feature: featureTemplate,
+    bug: bugTemplate,
+    infrastructure: infrastructureTemplate,
+    api: apiTemplate,
+};
+/**
+ * Get a template by type
+ */
+function getTemplate(type) {
+    return exports.templates[type] || exports.templates.basic;
+}
+/**
+ * List all available templates
+ */
+function listTemplates() {
+    return Object.values(exports.templates);
+}
+/**
+ * Generate spec content from a template
+ */
+function generateSpecContent(template, options) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`id: ${generateSpecId()}`);
+    lines.push(`title: "${options.title}"`);
+    if (options.workId) {
+        lines.push(`work_id: "${options.workId}"`);
+    }
+    lines.push(`work_type: ${options.workType}`);
+    lines.push(`template: ${template.id}`);
+    lines.push(`created_at: ${new Date().toISOString()}`);
+    lines.push(`updated_at: ${new Date().toISOString()}`);
+    lines.push(`validation_status: not_validated`);
+    lines.push(`source: conversation`);
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# ${options.title}`);
+    lines.push('');
+    // Context if provided
+    if (options.context) {
+        lines.push('## Context');
+        lines.push('');
+        lines.push(options.context);
+        lines.push('');
+    }
+    // Template sections
+    for (const section of template.sections) {
+        lines.push(`## ${section.title}`);
+        lines.push('');
+        if (section.defaultContent) {
+            lines.push(section.defaultContent);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a unique spec ID
+ */
+function generateSpecId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 6);
+    return `SPEC-${timestamp}-${random}`.toUpperCase();
+}
+//# sourceMappingURL=templates.js.map

package/dist/spec/templates.js.map

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

package/dist/spec/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fractary/faber - Spec Module Types
+ *
+ * Re-exports from main types + spec-specific interfaces.
+ */
+import type { SpecTemplateType } from '../types';
+export type { SpecConfig, SpecTemplateType, Specification, SpecMetadata, SpecPhase, SpecTask, SpecCreateOptions, SpecListOptions, SpecValidateResult, SpecRefineResult, RefinementQuestion, WorkType, } from '../types';
+/**
+ * Template definition
+ */
+export interface SpecTemplate {
+    id: SpecTemplateType;
+    name: string;
+    description: string;
+    sections: TemplateSection[];
+}
+export interface TemplateSection {
+    id: string;
+    title: string;
+    required: boolean;
+    description: string;
+    defaultContent?: string;
+}
+/**
+ * Spec file frontmatter
+ */
+export interface SpecFrontmatter {
+    id: string;
+    title: string;
+    work_id?: string;
+    work_type: string;
+    template: string;
+    created_at: string;
+    updated_at: string;
+    validation_status?: string;
+    source: string;
+}
+/**
+ * Phase update options
+ */
+export interface PhaseUpdateOptions {
+    status?: 'not_started' | 'in_progress' | 'complete';
+    objective?: string;
+    notes?: string[];
+}
+/**
+ * Task update options
+ */
+export interface TaskUpdateOptions {
+    text?: string;
+    completed?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/spec/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/spec/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,GACT,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/spec/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * @fractary/faber - Spec Module Types
+ *
+ * Re-exports from main types + spec-specific interfaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/spec/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/spec/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/state/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fractary/faber - State Module
+ *
+ * Workflow state persistence and recovery.
+ */
+export { StateManager } from './manager';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,cAAc,SAAS,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @fractary/faber - State Module
+ *
+ * Workflow state persistence and recovery.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateManager = void 0;
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "StateManager", { enumerable: true, get: function () { return manager_1.StateManager; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AACrB,0CAAwB"}

package/dist/state/manager.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fractary/faber - State Manager
+ *
+ * Workflow state persistence and recovery.
+ */
+import { StateConfig, FaberPhase, WorkflowState, PhaseState, RunManifest, PhaseManifest, ArtifactManifest, Checkpoint, StateUpdateOptions, StateQueryOptions, RecoveryOptions } from './types';
+/**
+ * State Manager
+ *
+ * Handles workflow state persistence, checkpoints, and recovery.
+ */
+export declare class StateManager {
+    private config;
+    private stateDir;
+    constructor(config?: StateConfig);
+    /**
+     * Ensure state directory exists
+     */
+    private ensureStateDir;
+    /**
+     * Get path for a state file
+     */
+    private getStatePath;
+    /**
+     * Create a new workflow state
+     */
+    createWorkflow(workId: string): WorkflowState;
+    /**
+     * Save workflow state
+     */
+    saveWorkflow(state: WorkflowState): void;
+    /**
+     * Get workflow state by ID
+     */
+    getWorkflow(workflowId: string): WorkflowState | null;
+    /**
+     * Get active workflow for a work item
+     */
+    getActiveWorkflow(workId: string): WorkflowState | null;
+    /**
+     * List all workflows
+     */
+    listWorkflows(options?: StateQueryOptions): WorkflowState[];
+    /**
+     * Update workflow phase
+     */
+    updatePhase(workflowId: string, phase: FaberPhase, updates: Partial<PhaseState>, options?: StateUpdateOptions): WorkflowState;
+    /**
+     * Start a phase
+     */
+    startPhase(workflowId: string, phase: FaberPhase): WorkflowState;
+    /**
+     * Complete a phase
+     */
+    completePhase(workflowId: string, phase: FaberPhase, outputs?: Record<string, unknown>): WorkflowState;
+    /**
+     * Fail a phase
+     */
+    failPhase(workflowId: string, phase: FaberPhase, error: string): WorkflowState;
+    /**
+     * Skip a phase
+     */
+    skipPhase(workflowId: string, phase: FaberPhase, reason?: string): WorkflowState;
+    /**
+     * Pause workflow
+     */
+    pauseWorkflow(workflowId: string): WorkflowState;
+    /**
+     * Resume workflow
+     */
+    resumeWorkflow(workflowId: string): WorkflowState;
+    /**
+     * Create a checkpoint
+     */
+    createCheckpoint(workflowId: string, phase: string, step: string, data: Record<string, unknown>): Checkpoint;
+    /**
+     * Get checkpoint by ID
+     */
+    getCheckpoint(checkpointId: string): Checkpoint | null;
+    /**
+     * List checkpoints for a workflow
+     */
+    listCheckpoints(workflowId: string): Checkpoint[];
+    /**
+     * Get latest checkpoint for a workflow
+     */
+    getLatestCheckpoint(workflowId: string): Checkpoint | null;
+    /**
+     * Create a run manifest
+     */
+    createManifest(workflowId: string, workId: string): RunManifest;
+    /**
+     * Save run manifest
+     */
+    saveManifest(manifest: RunManifest): void;
+    /**
+     * Get run manifest
+     */
+    getManifest(manifestId: string): RunManifest | null;
+    /**
+     * Add phase to manifest
+     */
+    addPhaseToManifest(manifestId: string, phaseManifest: PhaseManifest): void;
+    /**
+     * Add artifact to manifest
+     */
+    addArtifactToManifest(manifestId: string, artifact: ArtifactManifest): void;
+    /**
+     * Complete manifest
+     */
+    completeManifest(manifestId: string, status: 'completed' | 'failed'): RunManifest;
+    /**
+     * Recover a workflow from a checkpoint or phase
+     */
+    recoverWorkflow(workflowId: string, options?: RecoveryOptions): WorkflowState;
+    /**
+     * Delete workflow state
+     */
+    deleteWorkflow(workflowId: string): boolean;
+    /**
+     * Clean up old workflows and checkpoints
+     */
+    cleanup(maxAgeDays?: number): {
+        deleted: number;
+        errors: string[];
+    };
+    /**
+     * Get state directory path
+     */
+    getStateDir(): string;
+}
+//# sourceMappingURL=manager.d.ts.map

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

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