pm-orchestrator-runner 1.0.8 → 1.0.10

package/dist/trace/trace-pack.d.ts

@@ -0,0 +1,182 @@
+/**
+ * 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
+ */
+/**
+ * Trace entry types
+ */
+export type TraceEventType = 'SESSION_START' | 'SESSION_END' | 'TASK_GROUP_START' | 'TASK_GROUP_END' | 'TASK_START' | 'TASK_STATE_CHANGE' | 'TASK_END' | 'EXECUTOR_CALL' | 'EXECUTOR_RESULT' | 'VERIFICATION_START' | 'VERIFICATION_RESULT' | 'ERROR' | 'WARNING';
+/**
+ * Base trace entry structure
+ */
+export interface TraceEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Event type */
+    event: TraceEventType;
+    /** Session identifier */
+    session_id: string;
+    /** Task group identifier (optional) */
+    task_group_id?: string;
+    /** Task identifier (optional) */
+    task_id?: string;
+    /** Previous state (for state transitions) */
+    from_state?: string;
+    /** New state (for state transitions) */
+    to_state?: string;
+    /** Additional data */
+    data?: Record<string, unknown>;
+    /** Verification result (for verification events) */
+    verification_result?: {
+        passed: boolean;
+        checks: Array<{
+            name: string;
+            passed: boolean;
+            message?: string;
+        }>;
+    };
+    /** Error information */
+    error?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+}
+/**
+ * Trace Pack configuration
+ */
+export interface TracePackConfig {
+    /** Output directory for trace files */
+    outputDir: string;
+    /** Session ID */
+    sessionId: string;
+    /** Whether to buffer writes */
+    buffered?: boolean;
+    /** Max buffer size before flush */
+    maxBufferSize?: number;
+}
+/**
+ * Trace Pack - JSONL logger for session/task state transitions
+ */
+export declare class TracePack {
+    private config;
+    private outputPath;
+    private buffer;
+    private writeStream;
+    constructor(config: TracePackConfig);
+    /**
+     * Get the output file path
+     */
+    getOutputPath(): string;
+    /**
+     * Log a trace entry
+     */
+    log(entry: Omit<TraceEntry, 'timestamp' | 'session_id'>): void;
+    /**
+     * Log session start
+     */
+    sessionStart(data?: Record<string, unknown>): void;
+    /**
+     * Log session end
+     */
+    sessionEnd(data?: Record<string, unknown>): void;
+    /**
+     * Log task group start
+     */
+    taskGroupStart(taskGroupId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task group end
+     */
+    taskGroupEnd(taskGroupId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task start
+     */
+    taskStart(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task state change
+     */
+    taskStateChange(taskGroupId: string, taskId: string, fromState: string, toState: string, data?: Record<string, unknown>): void;
+    /**
+     * Log task end
+     */
+    taskEnd(taskGroupId: string, taskId: string, finalState: string, data?: Record<string, unknown>): void;
+    /**
+     * Log executor call
+     */
+    executorCall(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log executor result
+     */
+    executorResult(taskGroupId: string, taskId: string, status: string, data?: Record<string, unknown>): void;
+    /**
+     * Log verification start
+     */
+    verificationStart(taskGroupId: string, taskId: string, data?: Record<string, unknown>): void;
+    /**
+     * Log verification result
+     */
+    verificationResult(taskGroupId: string, taskId: string, passed: boolean, checks: Array<{
+        name: string;
+        passed: boolean;
+        message?: string;
+    }>, data?: Record<string, unknown>): void;
+    /**
+     * Log error
+     */
+    error(message: string, code?: string, taskGroupId?: string, taskId?: string): void;
+    /**
+     * Log warning
+     */
+    warning(message: string, taskGroupId?: string, taskId?: string): void;
+    /**
+     * Flush buffer to file
+     */
+    flush(): void;
+    /**
+     * Write single entry to file
+     */
+    private writeEntry;
+    /**
+     * Close the trace pack
+     */
+    close(): void;
+}
+/**
+ * Verify trace file format compliance
+ */
+export interface VerifyResult {
+    valid: boolean;
+    entryCount: number;
+    errors: Array<{
+        line: number;
+        error: string;
+    }>;
+    warnings: Array<{
+        line: number;
+        warning: string;
+    }>;
+    summary: {
+        sessionStarts: number;
+        sessionEnds: number;
+        taskGroupStarts: number;
+        taskGroupEnds: number;
+        taskStarts: number;
+        taskEnds: number;
+        stateChanges: number;
+        verificationResults: number;
+        errors: number;
+    };
+}
+/**
+ * Verify a trace file for format compliance
+ */
+export declare function verifyTraceFile(filePath: string): VerifyResult;
+/**
+ * Read and parse a trace file
+ */
+export declare function readTraceFile(filePath: string): TraceEntry[];
+//# sourceMappingURL=trace-pack.d.ts.map

package/dist/trace/trace-pack.d.ts.map

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

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/package.json

@@ -1,10 +1,10 @@
 {
   "name": "pm-orchestrator-runner",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "CLI tool that enforces controlled execution of Claude Code through mandatory orchestration",
   "main": "dist/cli/index.js",
   "bin": {
-    "pm-orchestrator": "dist/cli/index.js"
+    "pm": "dist/cli/index.js"
   },
   "files": [
     "dist",