pm-orchestrator-runner 1.0.7 → 1.0.9

package/dist/trace/trace-pack.js

@@ -0,0 +1,407 @@
+"use strict";
+/**
+ * Trace Pack - Minimal JSONL logging for session/task state transitions
+ *
+ * Per spec:
+ * - JSONL format (one JSON object per line)
+ * - Records: session_id, task_group_id, task_id, state transitions, verification results
+ * - Verify function for output format compliance
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracePack = void 0;
+exports.verifyTraceFile = verifyTraceFile;
+exports.readTraceFile = readTraceFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Trace Pack - JSONL logger for session/task state transitions
+ */
+class TracePack {
+    config;
+    outputPath;
+    buffer = [];
+    writeStream = null;
+    constructor(config) {
+        this.config = {
+            buffered: true,
+            maxBufferSize: 100,
+            ...config,
+        };
+        // Ensure output directory exists
+        if (!fs.existsSync(this.config.outputDir)) {
+            fs.mkdirSync(this.config.outputDir, { recursive: true });
+        }
+        // Create trace file path
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        this.outputPath = path.join(this.config.outputDir, 'trace-' + this.config.sessionId + '-' + timestamp + '.jsonl');
+    }
+    /**
+     * Get the output file path
+     */
+    getOutputPath() {
+        return this.outputPath;
+    }
+    /**
+     * Log a trace entry
+     */
+    log(entry) {
+        const fullEntry = {
+            timestamp: new Date().toISOString(),
+            session_id: this.config.sessionId,
+            ...entry,
+        };
+        if (this.config.buffered) {
+            this.buffer.push(fullEntry);
+            if (this.buffer.length >= (this.config.maxBufferSize || 100)) {
+                this.flush();
+            }
+        }
+        else {
+            this.writeEntry(fullEntry);
+        }
+    }
+    /**
+     * Log session start
+     */
+    sessionStart(data) {
+        this.log({
+            event: 'SESSION_START',
+            data,
+        });
+    }
+    /**
+     * Log session end
+     */
+    sessionEnd(data) {
+        this.log({
+            event: 'SESSION_END',
+            data,
+        });
+        this.flush();
+    }
+    /**
+     * Log task group start
+     */
+    taskGroupStart(taskGroupId, data) {
+        this.log({
+            event: 'TASK_GROUP_START',
+            task_group_id: taskGroupId,
+            data,
+        });
+    }
+    /**
+     * Log task group end
+     */
+    taskGroupEnd(taskGroupId, data) {
+        this.log({
+            event: 'TASK_GROUP_END',
+            task_group_id: taskGroupId,
+            data,
+        });
+    }
+    /**
+     * Log task start
+     */
+    taskStart(taskGroupId, taskId, data) {
+        this.log({
+            event: 'TASK_START',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            data,
+        });
+    }
+    /**
+     * Log task state change
+     */
+    taskStateChange(taskGroupId, taskId, fromState, toState, data) {
+        this.log({
+            event: 'TASK_STATE_CHANGE',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            from_state: fromState,
+            to_state: toState,
+            data,
+        });
+    }
+    /**
+     * Log task end
+     */
+    taskEnd(taskGroupId, taskId, finalState, data) {
+        this.log({
+            event: 'TASK_END',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            to_state: finalState,
+            data,
+        });
+    }
+    /**
+     * Log executor call
+     */
+    executorCall(taskGroupId, taskId, data) {
+        this.log({
+            event: 'EXECUTOR_CALL',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            data,
+        });
+    }
+    /**
+     * Log executor result
+     */
+    executorResult(taskGroupId, taskId, status, data) {
+        this.log({
+            event: 'EXECUTOR_RESULT',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            to_state: status,
+            data,
+        });
+    }
+    /**
+     * Log verification start
+     */
+    verificationStart(taskGroupId, taskId, data) {
+        this.log({
+            event: 'VERIFICATION_START',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            data,
+        });
+    }
+    /**
+     * Log verification result
+     */
+    verificationResult(taskGroupId, taskId, passed, checks, data) {
+        this.log({
+            event: 'VERIFICATION_RESULT',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            verification_result: { passed, checks },
+            data,
+        });
+    }
+    /**
+     * Log error
+     */
+    error(message, code, taskGroupId, taskId) {
+        this.log({
+            event: 'ERROR',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            error: { message, code },
+        });
+    }
+    /**
+     * Log warning
+     */
+    warning(message, taskGroupId, taskId) {
+        this.log({
+            event: 'WARNING',
+            task_group_id: taskGroupId,
+            task_id: taskId,
+            data: { message },
+        });
+    }
+    /**
+     * Flush buffer to file
+     */
+    flush() {
+        if (this.buffer.length === 0)
+            return;
+        const entries = this.buffer.splice(0, this.buffer.length);
+        for (const entry of entries) {
+            this.writeEntry(entry);
+        }
+    }
+    /**
+     * Write single entry to file
+     */
+    writeEntry(entry) {
+        const line = JSON.stringify(entry) + '\n';
+        fs.appendFileSync(this.outputPath, line, 'utf-8');
+    }
+    /**
+     * Close the trace pack
+     */
+    close() {
+        this.flush();
+        if (this.writeStream) {
+            this.writeStream.end();
+            this.writeStream = null;
+        }
+    }
+}
+exports.TracePack = TracePack;
+/**
+ * Verify a trace file for format compliance
+ */
+function verifyTraceFile(filePath) {
+    const result = {
+        valid: true,
+        entryCount: 0,
+        errors: [],
+        warnings: [],
+        summary: {
+            sessionStarts: 0,
+            sessionEnds: 0,
+            taskGroupStarts: 0,
+            taskGroupEnds: 0,
+            taskStarts: 0,
+            taskEnds: 0,
+            stateChanges: 0,
+            verificationResults: 0,
+            errors: 0,
+        },
+    };
+    if (!fs.existsSync(filePath)) {
+        result.valid = false;
+        result.errors.push({ line: 0, error: 'File does not exist' });
+        return result;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').filter((line) => line.trim().length > 0);
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        const line = lines[i];
+        try {
+            const entry = JSON.parse(line);
+            result.entryCount++;
+            // Validate required fields
+            if (!entry.timestamp) {
+                result.errors.push({ line: lineNum, error: 'Missing timestamp' });
+                result.valid = false;
+            }
+            if (!entry.event) {
+                result.errors.push({ line: lineNum, error: 'Missing event type' });
+                result.valid = false;
+            }
+            if (!entry.session_id) {
+                result.errors.push({ line: lineNum, error: 'Missing session_id' });
+                result.valid = false;
+            }
+            // Validate timestamp format
+            if (entry.timestamp && isNaN(Date.parse(entry.timestamp))) {
+                result.errors.push({ line: lineNum, error: 'Invalid timestamp format' });
+                result.valid = false;
+            }
+            // Count event types
+            switch (entry.event) {
+                case 'SESSION_START':
+                    result.summary.sessionStarts++;
+                    break;
+                case 'SESSION_END':
+                    result.summary.sessionEnds++;
+                    break;
+                case 'TASK_GROUP_START':
+                    result.summary.taskGroupStarts++;
+                    break;
+                case 'TASK_GROUP_END':
+                    result.summary.taskGroupEnds++;
+                    break;
+                case 'TASK_START':
+                    result.summary.taskStarts++;
+                    break;
+                case 'TASK_END':
+                    result.summary.taskEnds++;
+                    break;
+                case 'TASK_STATE_CHANGE':
+                    result.summary.stateChanges++;
+                    break;
+                case 'VERIFICATION_RESULT':
+                    result.summary.verificationResults++;
+                    break;
+                case 'ERROR':
+                    result.summary.errors++;
+                    break;
+            }
+            // Validate state change events have from_state and to_state
+            if (entry.event === 'TASK_STATE_CHANGE') {
+                if (!entry.from_state) {
+                    result.warnings.push({ line: lineNum, warning: 'State change missing from_state' });
+                }
+                if (!entry.to_state) {
+                    result.warnings.push({ line: lineNum, warning: 'State change missing to_state' });
+                }
+            }
+            // Validate verification result events have verification_result
+            if (entry.event === 'VERIFICATION_RESULT' && !entry.verification_result) {
+                result.warnings.push({ line: lineNum, warning: 'Verification result event missing verification_result' });
+            }
+            // Validate error events have error
+            if (entry.event === 'ERROR' && !entry.error) {
+                result.warnings.push({ line: lineNum, warning: 'Error event missing error details' });
+            }
+        }
+        catch (e) {
+            result.valid = false;
+            const errMsg = e.message;
+            result.errors.push({ line: lineNum, error: 'Invalid JSON: ' + errMsg });
+        }
+    }
+    // Check for balanced starts/ends
+    if (result.summary.sessionStarts !== result.summary.sessionEnds) {
+        result.warnings.push({
+            line: 0,
+            warning: 'Unbalanced sessions: ' + result.summary.sessionStarts + ' starts, ' + result.summary.sessionEnds + ' ends',
+        });
+    }
+    if (result.summary.taskGroupStarts !== result.summary.taskGroupEnds) {
+        result.warnings.push({
+            line: 0,
+            warning: 'Unbalanced task groups: ' + result.summary.taskGroupStarts + ' starts, ' + result.summary.taskGroupEnds + ' ends',
+        });
+    }
+    if (result.summary.taskStarts !== result.summary.taskEnds) {
+        result.warnings.push({
+            line: 0,
+            warning: 'Unbalanced tasks: ' + result.summary.taskStarts + ' starts, ' + result.summary.taskEnds + ' ends',
+        });
+    }
+    return result;
+}
+/**
+ * Read and parse a trace file
+ */
+function readTraceFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').filter((line) => line.trim().length > 0);
+    return lines.map((line) => JSON.parse(line));
+}
+//# sourceMappingURL=trace-pack.js.map

package/dist/trace/trace-pack.js.map

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

package/dist/web/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Web Module
+ * Per spec/19_WEB_UI.md
+ *
+ * Exports:
+ * - WebServer: Express HTTP server
+ * - createApp: Express app factory
+ * - createNamespacedWebServer: Factory for namespace-separated WebServer
+ */
+export { WebServer, WebServerConfig, WebServerState, createApp, } from './server';
+import { WebServer } from './server';
+import { QueueStore } from '../queue';
+/**
+ * Namespace configuration for WebServer
+ * Per spec/21_STABLE_DEV.md
+ */
+export interface NamespaceWebConfig {
+    /** Namespace name (e.g., 'stable', 'dev') */
+    namespace: string;
+    /** Port number derived from namespace */
+    port: number;
+}
+/**
+ * Create a WebServer instance with namespace separation
+ * Per spec/21_STABLE_DEV.md
+ *
+ * @param namespaceConfig - Namespace configuration with port
+ * @param queueStore - QueueStore instance to use
+ * @param sessionId - Session ID for new tasks
+ * @param host - Optional host (default: localhost)
+ * @returns Configured WebServer instance
+ *
+ * @example
+ * ```typescript
+ * const namespaceConfig = buildNamespaceConfig({ namespace: 'dev', projectRoot: '/path' });
+ * const store = createNamespacedQueueStore({ ... });
+ * const server = createNamespacedWebServer(
+ *   { namespace: namespaceConfig.namespace, port: namespaceConfig.port },
+ *   store,
+ *   'session-123'
+ * );
+ * ```
+ */
+export declare function createNamespacedWebServer(namespaceConfig: NamespaceWebConfig, queueStore: QueueStore, sessionId: string, host?: string): WebServer;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,kBAAkB,EACnC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAOX"}

package/dist/web/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Web Module
+ * Per spec/19_WEB_UI.md
+ *
+ * Exports:
+ * - WebServer: Express HTTP server
+ * - createApp: Express app factory
+ * - createNamespacedWebServer: Factory for namespace-separated WebServer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = exports.WebServer = void 0;
+exports.createNamespacedWebServer = createNamespacedWebServer;
+var server_1 = require("./server");
+Object.defineProperty(exports, "WebServer", { enumerable: true, get: function () { return server_1.WebServer; } });
+Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return server_1.createApp; } });
+const server_2 = require("./server");
+/**
+ * Create a WebServer instance with namespace separation
+ * Per spec/21_STABLE_DEV.md
+ *
+ * @param namespaceConfig - Namespace configuration with port
+ * @param queueStore - QueueStore instance to use
+ * @param sessionId - Session ID for new tasks
+ * @param host - Optional host (default: localhost)
+ * @returns Configured WebServer instance
+ *
+ * @example
+ * ```typescript
+ * const namespaceConfig = buildNamespaceConfig({ namespace: 'dev', projectRoot: '/path' });
+ * const store = createNamespacedQueueStore({ ... });
+ * const server = createNamespacedWebServer(
+ *   { namespace: namespaceConfig.namespace, port: namespaceConfig.port },
+ *   store,
+ *   'session-123'
+ * );
+ * ```
+ */
+function createNamespacedWebServer(namespaceConfig, queueStore, sessionId, host) {
+    return new server_2.WebServer({
+        port: namespaceConfig.port,
+        host,
+        queueStore,
+        sessionId,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA4CH,8DAYC;AAtDD,mCAKkB;AAJhB,mGAAA,SAAS,OAAA;AAGT,mGAAA,SAAS,OAAA;AAGX,qCAAsD;AActD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,yBAAyB,CACvC,eAAmC,EACnC,UAAsB,EACtB,SAAiB,EACjB,IAAa;IAEb,OAAO,IAAI,kBAAS,CAAC;QACnB,IAAI,EAAE,eAAe,CAAC,IAAI;QAC1B,IAAI;QACJ,UAAU;QACV,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/web/server.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Web Server - Express HTTP server
+ * Per spec/19_WEB_UI.md
+ *
+ * Provides:
+ * - REST API for queue operations (read/write to QueueStore)
+ * - Static file serving for frontend
+ * - Same process as Runner (integrated)
+ *
+ * IMPORTANT: Web UI does NOT directly command Runner.
+ * Submit = queue insert only.
+ */
+import { Express } from 'express';
+import { QueueStore } from '../queue';
+/**
+ * Web Server configuration
+ */
+export interface WebServerConfig {
+    /** Port number (default: 3000) */
+    port?: number;
+    /** Host (default: localhost) */
+    host?: string;
+    /** QueueStore instance */
+    queueStore: QueueStore;
+    /** Session ID for new tasks */
+    sessionId: string;
+}
+/**
+ * Web Server state
+ */
+export interface WebServerState {
+    isRunning: boolean;
+    port: number;
+    host: string;
+}
+/**
+ * Create configured Express app
+ */
+export declare function createApp(config: WebServerConfig): Express;
+/**
+ * Web Server
+ * Manages Express server lifecycle
+ */
+export declare class WebServer {
+    private readonly app;
+    private readonly port;
+    private readonly host;
+    private server;
+    constructor(config: WebServerConfig);
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get server state
+     */
+    getState(): WebServerState;
+    /**
+     * Get Express app (for testing)
+     */
+    getApp(): Express;
+    /**
+     * Get server URL
+     */
+    getUrl(): string;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/web/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAgB,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CA8P1D;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA8C;gBAEhD,MAAM,EAAE,eAAe;IAMnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B;;OAEG;IACH,QAAQ,IAAI,cAAc;IAQ1B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,MAAM,IAAI,MAAM;CAGjB"}