forge-dev-framework 1.0.1

package/dist/utils/config.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * FORGE Error Classes
+ */
+export declare class ForgeError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class ConfigError extends ForgeError {
+    constructor(message: string);
+}
+export declare class StateError extends ForgeError {
+    constructor(message: string);
+}
+export declare class ValidationError extends ForgeError {
+    readonly validationErrors: string[];
+    constructor(message: string, validationErrors: string[]);
+}
+export declare class ProjectNotFoundError extends ForgeError {
+    constructor(projectRoot: string);
+}
+/**
+ * Format error for user-friendly display
+ */
+export declare function formatError(error: Error): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,UAAW,SAAQ,KAAK;aACU,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAK1D;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,UAAU;aACA,gBAAgB,EAAE,MAAM,EAAE;gBAA3D,OAAO,EAAE,MAAM,EAAkB,gBAAgB,EAAE,MAAM,EAAE;CAIxE;AAED,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,WAAW,EAAE,MAAM;CAIhC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAKhD"}

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+/**
+ * FORGE Error Classes
+ */
+export class ForgeError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ForgeError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+export class ConfigError extends ForgeError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+        this.name = 'ConfigError';
+    }
+}
+export class StateError extends ForgeError {
+    constructor(message) {
+        super(message, 'STATE_ERROR');
+        this.name = 'StateError';
+    }
+}
+export class ValidationError extends ForgeError {
+    validationErrors;
+    constructor(message, validationErrors) {
+        super(message, 'VALIDATION_ERROR');
+        this.validationErrors = validationErrors;
+        this.name = 'ValidationError';
+    }
+}
+export class ProjectNotFoundError extends ForgeError {
+    constructor(projectRoot) {
+        super(`No FORGE project found at ${projectRoot}`, 'PROJECT_NOT_FOUND');
+        this.name = 'ProjectNotFoundError';
+    }
+}
+/**
+ * Format error for user-friendly display
+ */
+export function formatError(error) {
+    if (error instanceof ForgeError) {
+        return `${error.name}: ${error.message}`;
+    }
+    return `Error: ${error.message}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACU;IAA7C,YAAY,OAAe,EAAkB,IAAY;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,SAAI,GAAJ,IAAI,CAAQ;QAEvD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACA;IAA7C,YAAY,OAAe,EAAkB,gBAA0B;QACrE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QADQ,qBAAgB,GAAhB,gBAAgB,CAAU;QAErE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,WAAmB;QAC7B,KAAK,CAAC,6BAA6B,WAAW,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FORGE Utility Exports
+ */
+export * from './config';
+export * from './errors';
+export * from './logger';
+export * from './state-api';
+export * from './template-client';
+export type { ForgeConfig, ForgeMode, ForgeDepth, GitStrategy, AgentProfile } from '../types/config.js';
+export type { ForgeState, Task, TaskStatus, Contract, EventPayload, EventType } from '../types/state.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAGlC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * FORGE Utility Exports
+ */
+export * from './config';
+export * from './errors';
+export * from './logger';
+export * from './state-api';
+export * from './template-client';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * FORGE Logger - User-friendly output formatting
+ */
+export declare class Logger {
+    private quiet;
+    constructor(quiet?: boolean);
+    info(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    /**
+     * Display a section header
+     */
+    header(title: string): void;
+    /**
+     * Display a bullet point
+     */
+    bullet(message: string, indent?: number): void;
+    /**
+     * Display a list item with number
+     */
+    numbered(message: string, index: number): void;
+    /**
+     * Display a code block or path
+     */
+    code(text: string): void;
+    /**
+     * Empty line for spacing
+     */
+    newline(): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAU;gBAEX,KAAK,GAAE,OAAe;IAIlC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO3B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;IAOjD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM9C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+/**
+ * FORGE Logger - User-friendly output formatting
+ */
+export class Logger {
+    quiet;
+    constructor(quiet = false) {
+        this.quiet = quiet;
+    }
+    info(message) {
+        if (!this.quiet)
+            console.log(chalk.blue('ℹ'), message);
+    }
+    success(message) {
+        if (!this.quiet)
+            console.log(chalk.green('✓'), message);
+    }
+    warning(message) {
+        if (!this.quiet)
+            console.log(chalk.yellow('⚠'), message);
+    }
+    error(message) {
+        console.error(chalk.red('✗'), message);
+    }
+    debug(message) {
+        if (process.env.DEBUG && !this.quiet) {
+            console.log(chalk.gray('[debug]'), message);
+        }
+    }
+    /**
+     * Display a section header
+     */
+    header(title) {
+        if (!this.quiet) {
+            console.log('\n' + chalk.bold.cyan(title));
+            console.log(chalk.cyan('─'.repeat(title.length)));
+        }
+    }
+    /**
+     * Display a bullet point
+     */
+    bullet(message, indent = 0) {
+        if (!this.quiet) {
+            const prefix = '  '.repeat(indent);
+            console.log(prefix + chalk.gray('•'), message);
+        }
+    }
+    /**
+     * Display a list item with number
+     */
+    numbered(message, index) {
+        if (!this.quiet) {
+            console.log(chalk.gray(`${index}.`), message);
+        }
+    }
+    /**
+     * Display a code block or path
+     */
+    code(text) {
+        if (!this.quiet) {
+            console.log(chalk.gray(text));
+        }
+    }
+    /**
+     * Empty line for spacing
+     */
+    newline() {
+        if (!this.quiet)
+            console.log();
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AAEH,MAAM,OAAO,MAAM;IACT,KAAK,CAAU;IAEvB,YAAY,QAAiB,KAAK;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,SAAiB,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe,EAAE,KAAa;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/state-api.d.ts

@@ -0,0 +1,128 @@
+/**
+ * FORGE State Access API
+ * Interface between CLI-ENGINE and STATE-ENGINE
+ *
+ * This provides the API contract specified in state/STATE_API_SPEC.md
+ */
+export interface Task {
+    id: string;
+    title: string;
+    ownerRole: string;
+    status: string;
+    deps: string[];
+    allowedPaths: string[];
+    acceptance: string[];
+    verify: string[];
+    commit: string | null;
+    requests: string[];
+    priority: number;
+    blockedBy: string[];
+    blocks: string[];
+    assignedTo: string | null;
+    createdAt?: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+}
+export interface Contract {
+    id: string;
+    path: string;
+    version: string;
+    publishedBy: string;
+    consumers: string[];
+    publishedAt?: string;
+    status: 'draft' | 'published' | 'deprecated';
+}
+export interface ProjectMetadata {
+    name: string;
+    status: string;
+    currentMilestone: string;
+    currentPhase: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface StateMetadata {
+    schemaVersion: string;
+    lastEventId: string;
+    eventCount: number;
+}
+export interface State {
+    project: ProjectMetadata;
+    tasks: Task[];
+    contracts: Contract[];
+    eventsPointer: string;
+    metadata?: StateMetadata;
+}
+export interface EventPayload {
+    commitHash?: string;
+    filesChanged?: string[];
+    testsRun?: number;
+    testsPassed?: number;
+    blockingTasks?: string[];
+    reason?: string;
+    contractId?: string;
+    contractPath?: string;
+    requestedBy?: string;
+    requestedFor?: string;
+    version?: string;
+    severity?: 'P0' | 'P1' | 'P2';
+    finding?: string;
+    requirementRef?: string;
+    resolvedBy?: string;
+    resolution?: string;
+    publishedBy?: string;
+    consumers?: string[];
+    [key: string]: unknown;
+}
+export type EventType = 'TASK_STARTED' | 'TASK_COMPLETED' | 'TASK_BLOCKED' | 'TASK_FAILED' | 'TASK_CANCELLED' | 'REQUEST_CONTRACT' | 'CONTRACT_PUBLISHED' | 'REVIEW_FINDING' | 'REVIEW_RESOLVED';
+export interface Event {
+    eventId: string;
+    timestamp: string;
+    taskId: string | null;
+    actor: string;
+    type: EventType;
+    payload: EventPayload;
+}
+export interface MergeResult {
+    eventCount: number;
+    errors: string[];
+}
+/**
+ * Load canonical STATE.json
+ */
+export declare function getState(projectRoot?: string): State | null;
+/**
+ * Get a specific task by ID
+ */
+export declare function getTask(taskId: string, projectRoot?: string): Task | undefined;
+/**
+ * Get all tasks owned by a specific role
+ */
+export declare function getTasksByOwner(ownerRole: string, projectRoot?: string): Task[];
+/**
+ * Get all contracts, optionally filtered by consumer
+ */
+export declare function getContracts(consumerRole?: string | undefined, projectRoot?: string): Contract[];
+/**
+ * Generate a unique event ID
+ * Format: evt-{ISO8601_timestamp}-{agent_name}-{sequence_number}
+ */
+export declare function generateEventId(actor: string): string;
+/**
+ * Submit an event to the event log
+ * This is append-only and concurrency-safe
+ */
+export declare function submitEvent(event: Event, projectRoot?: string): Promise<void>;
+/**
+ * Trigger State Steward to merge events into STATE.json
+ * This runs state/merge.ts
+ */
+export declare function mergeState(projectRoot?: string): Promise<MergeResult>;
+/**
+ * Check if we're in a FORGE project
+ */
+export declare function isForgeProject(projectRoot?: string): boolean;
+/**
+ * Initialize a new FORGE project state
+ */
+export declare function initializeState(projectName: string, projectRoot?: string): State;
+//# sourceMappingURL=state-api.d.ts.map

package/dist/utils/state-api.d.ts.map

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

package/dist/utils/state-api.js

@@ -0,0 +1,170 @@
+/**
+ * FORGE State Access API
+ * Interface between CLI-ENGINE and STATE-ENGINE
+ *
+ * This provides the API contract specified in state/STATE_API_SPEC.md
+ */
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+const STATE_PATH = 'state/STATE.json';
+const EVENTS_DIR = 'state/events';
+const MERGE_SCRIPT = 'state/merge.ts';
+/**
+ * Load canonical STATE.json
+ */
+export function getState(projectRoot = process.cwd()) {
+    const statePath = path.join(projectRoot, STATE_PATH);
+    if (!fs.existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(statePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to load state from ${statePath}: ${error}`);
+    }
+}
+/**
+ * Get a specific task by ID
+ */
+export function getTask(taskId, projectRoot = process.cwd()) {
+    const state = getState(projectRoot);
+    if (!state) {
+        return undefined;
+    }
+    return state.tasks.find((t) => t.id === taskId);
+}
+/**
+ * Get all tasks owned by a specific role
+ */
+export function getTasksByOwner(ownerRole, projectRoot = process.cwd()) {
+    const state = getState(projectRoot);
+    if (!state) {
+        return [];
+    }
+    return state.tasks.filter((t) => t.ownerRole === ownerRole);
+}
+/**
+ * Get all contracts, optionally filtered by consumer
+ */
+export function getContracts(consumerRole = undefined, projectRoot = process.cwd()) {
+    const state = getState(projectRoot);
+    if (!state) {
+        return [];
+    }
+    if (!consumerRole) {
+        return state.contracts;
+    }
+    return state.contracts.filter((c) => c.consumers.includes(consumerRole));
+}
+/**
+ * Generate a unique event ID
+ * Format: evt-{ISO8601_timestamp}-{agent_name}-{sequence_number}
+ */
+export function generateEventId(actor) {
+    const timestamp = new Date().toISOString();
+    const sequence = Math.floor(Math.random() * 1000).toString().padStart(3, '0');
+    return `evt-${timestamp}-${actor}-${sequence}`;
+}
+/**
+ * Submit an event to the event log
+ * This is append-only and concurrency-safe
+ */
+export async function submitEvent(event, projectRoot = process.cwd()) {
+    const eventsDir = path.join(projectRoot, EVENTS_DIR);
+    // Ensure events directory exists
+    if (!fs.existsSync(eventsDir)) {
+        fs.mkdirSync(eventsDir, { recursive: true });
+    }
+    // Validate event structure
+    if (!event.eventId || !event.timestamp || !event.actor || !event.type) {
+        throw new Error('Invalid event: missing required fields');
+    }
+    // Write event file
+    const filename = `${event.eventId}.json`;
+    const eventPath = path.join(eventsDir, filename);
+    try {
+        fs.writeFileSync(eventPath, JSON.stringify(event, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to write event to ${eventPath}: ${error}`);
+    }
+}
+/**
+ * Trigger State Steward to merge events into STATE.json
+ * This runs state/merge.ts
+ */
+export async function mergeState(projectRoot = process.cwd()) {
+    const mergeScriptPath = path.join(projectRoot, MERGE_SCRIPT);
+    if (!fs.existsSync(mergeScriptPath)) {
+        throw new Error(`Merge script not found at ${mergeScriptPath}`);
+    }
+    try {
+        // Run merge script using bun (as specified in state/README.md)
+        const output = execSync(`bun run ${mergeScriptPath}`, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+        });
+        // Parse output to extract event count and errors
+        // The merge script should output JSON or structured text
+        return {
+            eventCount: 0,
+            errors: [],
+        };
+    }
+    catch (error) {
+        // If merge fails, return errors
+        return {
+            eventCount: 0,
+            errors: [String(error)],
+        };
+    }
+}
+/**
+ * Check if we're in a FORGE project
+ */
+export function isForgeProject(projectRoot = process.cwd()) {
+    const statePath = path.join(projectRoot, STATE_PATH);
+    return fs.existsSync(statePath);
+}
+/**
+ * Initialize a new FORGE project state
+ */
+export function initializeState(projectName, projectRoot = process.cwd()) {
+    const now = new Date().toISOString();
+    const state = {
+        project: {
+            name: projectName,
+            status: 'initialized',
+            currentMilestone: 'v1.0',
+            currentPhase: 0,
+            createdAt: now,
+            updatedAt: now,
+        },
+        tasks: [],
+        contracts: [],
+        eventsPointer: 'state/events/',
+        metadata: {
+            schemaVersion: '1.0.0',
+            lastEventId: '',
+            eventCount: 0,
+        },
+    };
+    // Ensure state directory exists
+    const stateDir = path.join(projectRoot, 'state');
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    // Write STATE.json
+    const statePath = path.join(projectRoot, STATE_PATH);
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf-8');
+    // Ensure events directory exists
+    const eventsDir = path.join(projectRoot, EVENTS_DIR);
+    if (!fs.existsSync(eventsDir)) {
+        fs.mkdirSync(eventsDir, { recursive: true });
+    }
+    return state;
+}
+//# sourceMappingURL=state-api.js.map

package/dist/utils/state-api.js.map

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

package/dist/utils/template-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * FORGE Template Client
+ * Wrapper for TEMPLATES integration with CLI-ENGINE
+ */
+import { type TemplateContext, type RenderResult, type XmlTaskSpec } from '../generators/index.js';
+import { type RequiredFieldSet } from '../generators/index.js';
+/**
+ * Template Client Configuration
+ */
+export interface TemplateClientConfig {
+    projectRoot: string;
+    templatesDir?: string;
+    outputDir?: string;
+    interactive?: boolean;
+}
+/**
+ * Template Client for FORGE CLI
+ */
+export declare class TemplateClient {
+    private engine;
+    private projectRoot;
+    private interactive;
+    private outputDir;
+    constructor(config: TemplateClientConfig);
+    /**
+     * Validate that context has all required fields for a template
+     */
+    validateContext(context: Partial<TemplateContext>, fieldSet: RequiredFieldSet): {
+        valid: boolean;
+        missing: string[];
+    };
+    /**
+     * Get required fields for a specific template
+     */
+    getRequiredFields(fieldSet: RequiredFieldSet): string[];
+    /**
+     * Render a template with the given context
+     */
+    renderTemplate(templateName: string, context: Partial<TemplateContext>): Promise<RenderResult>;
+    /**
+     * Render and write a template to disk
+     */
+    generateArtifact(templateName: string, context: Partial<TemplateContext>, outputFilename: string): Promise<void>;
+    /**
+     * Generate XML task specs
+     */
+    generateXmlTasks(tasks: XmlTaskSpec[]): string;
+    /**
+     * Handle token limit warnings
+     */
+    private handleTokenLimitWarning;
+    /**
+     * Get token limit for a template
+     */
+    private getTemplateLimit;
+    /**
+     * Check if file exists
+     */
+    private fileExists;
+    /**
+     * Backup existing file
+     */
+    private backupFile;
+    /**
+     * Prompt user to proceed despite warnings
+     */
+    private shouldProceed;
+}
+/**
+ * Create a template client instance
+ */
+export declare function createTemplateClient(config: TemplateClientConfig): TemplateClient;
+//# sourceMappingURL=template-client.d.ts.map

package/dist/utils/template-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-client.d.ts","sourceRoot":"","sources":["../../src/utils/template-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAA6C,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE9I,OAAO,EAA2C,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGxG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,oBAAoB;IAkBxC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAIrH;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAIvD;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBpG;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtH;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;IAM9C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,UAAU;IAMxB;;OAEG;YACW,aAAa;CAS5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAEjF"}