@supaku/agentfactory 0.1.0

package/dist/src/orchestrator/parse-work-result.d.ts

@@ -0,0 +1,16 @@
+import type { AgentWorkType } from '@supaku/agentfactory-linear';
+import type { AgentWorkResult } from './types';
+/**
+ * Parse the agent's result message to determine whether the work passed or failed.
+ *
+ * Detection priority:
+ * 1. Structured marker: `<!-- WORK_RESULT:passed/failed -->`
+ * 2. Heuristic heading/pattern matching scoped to the work type
+ * 3. Returns 'unknown' if nothing matches (safe default: no transition)
+ *
+ * @param resultMessage - The agent's final output message
+ * @param workType - The type of work performed (qa, acceptance, etc.)
+ * @returns 'passed', 'failed', or 'unknown'
+ */
+export declare function parseWorkResult(resultMessage: string | undefined, workType: AgentWorkType): AgentWorkResult;
+//# sourceMappingURL=parse-work-result.d.ts.map

package/dist/src/orchestrator/parse-work-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-work-result.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/parse-work-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAuC9C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,GACtB,eAAe,CAgCjB"}

package/dist/src/orchestrator/parse-work-result.js

@@ -0,0 +1,73 @@
+/**
+ * Structured marker pattern embedded in agent output.
+ * Agents are instructed to include this marker in their final output.
+ *
+ * Format: <!-- WORK_RESULT:passed --> or <!-- WORK_RESULT:failed -->
+ */
+const STRUCTURED_MARKER_RE = /<!--\s*WORK_RESULT:(passed|failed)\s*-->/i;
+/**
+ * Heuristic patterns for detecting QA pass/fail when structured marker is absent.
+ * Patterns are checked case-insensitively against the result message.
+ */
+const QA_PASS_PATTERNS = [
+    /##\s*QA\s+Passed/i,
+    /QA\s+Result:\s*Pass/i,
+    /QA\s+Status:\s*Passed/i,
+];
+const QA_FAIL_PATTERNS = [
+    /##\s*QA\s+Failed/i,
+    /QA\s+Result:\s*Fail/i,
+    /QA\s+Status:\s*Failed/i,
+];
+const ACCEPTANCE_PASS_PATTERNS = [
+    /##\s*Acceptance\s+Complete/i,
+    /Acceptance\s+Result:\s*Pass/i,
+    /PR\s+has\s+been\s+merged\s+successfully/i,
+];
+const ACCEPTANCE_FAIL_PATTERNS = [
+    /##\s*Acceptance\s+(?:Processing\s+)?Failed/i,
+    /Acceptance\s+(?:Processing\s+)?Blocked/i,
+    /Acceptance\s+Result:\s*Fail/i,
+    /Cannot\s+merge\s+PR/i,
+];
+/**
+ * Parse the agent's result message to determine whether the work passed or failed.
+ *
+ * Detection priority:
+ * 1. Structured marker: `<!-- WORK_RESULT:passed/failed -->`
+ * 2. Heuristic heading/pattern matching scoped to the work type
+ * 3. Returns 'unknown' if nothing matches (safe default: no transition)
+ *
+ * @param resultMessage - The agent's final output message
+ * @param workType - The type of work performed (qa, acceptance, etc.)
+ * @returns 'passed', 'failed', or 'unknown'
+ */
+export function parseWorkResult(resultMessage, workType) {
+    if (!resultMessage) {
+        return 'unknown';
+    }
+    // 1. Check for structured marker (highest priority, work-type agnostic)
+    const markerMatch = resultMessage.match(STRUCTURED_MARKER_RE);
+    if (markerMatch) {
+        return markerMatch[1].toLowerCase();
+    }
+    // 2. Fall back to heuristic patterns scoped by work type
+    if (workType === 'qa') {
+        if (QA_FAIL_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'failed';
+        }
+        if (QA_PASS_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'passed';
+        }
+    }
+    if (workType === 'acceptance') {
+        if (ACCEPTANCE_FAIL_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'failed';
+        }
+        if (ACCEPTANCE_PASS_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'passed';
+        }
+    }
+    // 3. Unknown — safe default
+    return 'unknown';
+}

package/dist/src/orchestrator/progress-logger.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Progress Logger
+ *
+ * Append-only log for debugging agent activity.
+ * Format: timestamp|event_type|details
+ */
+import type { ProgressLoggerConfig, ProgressEventType } from './state-types';
+/**
+ * ProgressLogger appends events to a log file for debugging
+ */
+export declare class ProgressLogger {
+    private readonly config;
+    private readonly logPath;
+    private stopped;
+    constructor(config: ProgressLoggerConfig);
+    /**
+     * Initialize the logger (create directory if needed)
+     */
+    init(): void;
+    /**
+     * Stop the logger
+     */
+    stop(): void;
+    /**
+     * Log an event
+     */
+    log(eventType: ProgressEventType, details: string | object): void;
+    /**
+     * Log agent start
+     */
+    logStart(details: {
+        issueId: string;
+        workType: string;
+        prompt: string;
+    }): void;
+    /**
+     * Log phase change
+     */
+    logPhase(phase: string): void;
+    /**
+     * Log tool call
+     */
+    logTool(toolName: string, input?: object): void;
+    /**
+     * Log error
+     */
+    logError(message: string, error?: Error | unknown): void;
+    /**
+     * Log recovery attempt
+     */
+    logRecovery(attempt: number, reason?: string): void;
+    /**
+     * Log completion
+     */
+    logComplete(details?: {
+        prUrl?: string;
+        message?: string;
+    }): void;
+    /**
+     * Log stop
+     */
+    logStop(reason: 'user_request' | 'timeout' | 'error'): void;
+    /**
+     * Rotate log file if it exceeds max size
+     */
+    private maybeRotate;
+}
+/**
+ * Create a progress logger for an agent
+ */
+export declare function createProgressLogger(config: ProgressLoggerConfig): ProgressLogger;
+//# sourceMappingURL=progress-logger.d.ts.map

package/dist/src/orchestrator/progress-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-logger.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/progress-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAK5E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAQ;gBAEX,MAAM,EAAE,oBAAoB;IAQxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBjE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI9E;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI;IAOxD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIjE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI;IAI3D;;OAEG;IACH,OAAO,CAAC,WAAW;CAkBpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAIjF"}

package/dist/src/orchestrator/progress-logger.js

@@ -0,0 +1,135 @@
+/**
+ * Progress Logger
+ *
+ * Append-only log for debugging agent activity.
+ * Format: timestamp|event_type|details
+ */
+import { appendFileSync, existsSync, mkdirSync, statSync, renameSync } from 'fs';
+import { resolve, dirname } from 'path';
+// Default max log size: 1MB
+const DEFAULT_MAX_SIZE_BYTES = 1024 * 1024;
+/**
+ * ProgressLogger appends events to a log file for debugging
+ */
+export class ProgressLogger {
+    config;
+    logPath;
+    stopped = false;
+    constructor(config) {
+        this.config = {
+            ...config,
+            maxSizeBytes: config.maxSizeBytes ?? DEFAULT_MAX_SIZE_BYTES,
+        };
+        this.logPath = resolve(this.config.agentDir, 'progress.log');
+    }
+    /**
+     * Initialize the logger (create directory if needed)
+     */
+    init() {
+        const dir = dirname(this.logPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    /**
+     * Stop the logger
+     */
+    stop() {
+        this.stopped = true;
+    }
+    /**
+     * Log an event
+     */
+    log(eventType, details) {
+        if (this.stopped)
+            return;
+        const timestamp = Date.now();
+        const detailsStr = typeof details === 'object' ? JSON.stringify(details) : details;
+        const line = `${timestamp}|${eventType}|${detailsStr}\n`;
+        try {
+            // Check if rotation is needed
+            this.maybeRotate();
+            // Append to log
+            appendFileSync(this.logPath, line);
+        }
+        catch (error) {
+            // Silently ignore errors - progress logging is best-effort
+        }
+    }
+    /**
+     * Log agent start
+     */
+    logStart(details) {
+        this.log('start', details);
+    }
+    /**
+     * Log phase change
+     */
+    logPhase(phase) {
+        this.log('phase', { phase });
+    }
+    /**
+     * Log tool call
+     */
+    logTool(toolName, input) {
+        this.log('tool', { toolName, input: input ? JSON.stringify(input).substring(0, 200) : undefined });
+    }
+    /**
+     * Log error
+     */
+    logError(message, error) {
+        this.log('error', {
+            message,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    /**
+     * Log recovery attempt
+     */
+    logRecovery(attempt, reason) {
+        this.log('recovery', { attempt, reason });
+    }
+    /**
+     * Log completion
+     */
+    logComplete(details) {
+        this.log('complete', details ?? {});
+    }
+    /**
+     * Log stop
+     */
+    logStop(reason) {
+        this.log('stop', { reason });
+    }
+    /**
+     * Rotate log file if it exceeds max size
+     */
+    maybeRotate() {
+        try {
+            if (!existsSync(this.logPath))
+                return;
+            const stats = statSync(this.logPath);
+            if (stats.size >= this.config.maxSizeBytes) {
+                // Rotate: rename current to .old
+                const oldPath = `${this.logPath}.old`;
+                try {
+                    renameSync(this.logPath, oldPath);
+                }
+                catch {
+                    // Ignore rotation errors
+                }
+            }
+        }
+        catch {
+            // Ignore stat errors
+        }
+    }
+}
+/**
+ * Create a progress logger for an agent
+ */
+export function createProgressLogger(config) {
+    const logger = new ProgressLogger(config);
+    logger.init();
+    return logger;
+}

package/dist/src/orchestrator/session-logger.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Session Logger
+ *
+ * Verbose logging of agent sessions for analysis and improvement.
+ * Uses JSON Lines format for append efficiency and easy parsing.
+ *
+ * Logs are stored at: .agent-logs/sessions/{session-id}/
+ *   - metadata.json: Session metadata
+ *   - events.jsonl: Event log (JSON Lines)
+ */
+import type { AgentWorkType } from '@supaku/agentfactory-linear';
+/**
+ * Session event types for categorization
+ */
+export type SessionEventType = 'init' | 'tool_use' | 'tool_result' | 'assistant' | 'user' | 'error' | 'warning' | 'status' | 'complete' | 'stop';
+/**
+ * A single logged event
+ */
+export interface SessionEvent {
+    /** Unix timestamp (milliseconds) */
+    timestamp: number;
+    /** Event type for categorization */
+    type: SessionEventType;
+    /** Tool name (for tool_use/tool_result events) */
+    tool?: string;
+    /** Event content/details */
+    content: string | object;
+    /** Whether this was an error */
+    isError?: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session metadata stored in metadata.json
+ */
+export interface SessionMetadata {
+    /** Unique session ID */
+    sessionId: string;
+    /** Linear issue ID */
+    issueId: string;
+    /** Human-readable issue identifier */
+    issueIdentifier: string;
+    /** Type of work being performed */
+    workType: AgentWorkType;
+    /** Initial prompt */
+    prompt: string;
+    /** Unix timestamp when session started */
+    startedAt: number;
+    /** Unix timestamp when session ended */
+    endedAt?: number;
+    /** Final status */
+    status: 'running' | 'completed' | 'failed' | 'stopped';
+    /** Error message if failed */
+    errorMessage?: string;
+    /** PR URL if created */
+    pullRequestUrl?: string;
+    /** Total tool calls count */
+    toolCallsCount: number;
+    /** Total errors count */
+    errorsCount: number;
+    /** Worker ID if remote */
+    workerId?: string;
+}
+/**
+ * Configuration for SessionLogger
+ */
+export interface SessionLoggerConfig {
+    /** Session ID (used for directory name) */
+    sessionId: string;
+    /** Linear issue ID */
+    issueId: string;
+    /** Human-readable issue identifier */
+    issueIdentifier: string;
+    /** Type of work being performed */
+    workType: AgentWorkType;
+    /** Initial prompt */
+    prompt: string;
+    /** Base directory for logs (default: .agent-logs) */
+    logsDir?: string;
+    /** Worker ID if remote */
+    workerId?: string;
+}
+/**
+ * SessionLogger handles verbose logging of agent sessions
+ */
+export declare class SessionLogger {
+    private readonly config;
+    private readonly sessionDir;
+    private readonly metadataPath;
+    private readonly eventsPath;
+    private metadata;
+    private stopped;
+    constructor(config: SessionLoggerConfig);
+    /**
+     * Initialize the logger - create directory and write initial metadata
+     */
+    initialize(): void;
+    /**
+     * Log a generic event
+     */
+    logEvent(event: SessionEvent): void;
+    /**
+     * Log a tool use event
+     */
+    logToolUse(toolName: string, input?: unknown): void;
+    /**
+     * Log a tool result event
+     */
+    logToolResult(toolName: string, result: unknown, isError?: boolean): void;
+    /**
+     * Log an assistant message/thought
+     */
+    logAssistant(content: string): void;
+    /**
+     * Log an error
+     */
+    logError(message: string, error?: unknown, metadata?: Record<string, unknown>): void;
+    /**
+     * Log a warning (non-fatal issue)
+     */
+    logWarning(message: string, details?: Record<string, unknown>): void;
+    /**
+     * Log a status change
+     */
+    logStatus(status: string, details?: Record<string, unknown>): void;
+    /**
+     * Finalize the session with a final status
+     */
+    finalize(status: 'completed' | 'failed' | 'stopped', options?: {
+        errorMessage?: string;
+        pullRequestUrl?: string;
+    }): void;
+    /**
+     * Get the session directory path
+     */
+    getSessionDir(): string;
+    /**
+     * Get current metadata
+     */
+    getMetadata(): SessionMetadata;
+    /**
+     * Write metadata to file
+     */
+    private writeMetadata;
+}
+/**
+ * Create and initialize a session logger
+ */
+export declare function createSessionLogger(config: SessionLoggerConfig): SessionLogger;
+/**
+ * Read session metadata from a session directory
+ */
+export declare function readSessionMetadata(sessionDir: string): SessionMetadata | null;
+/**
+ * Read events from a session directory
+ * Returns an async generator for memory efficiency
+ */
+export declare function readSessionEvents(sessionDir: string): Generator<SessionEvent>;
+//# sourceMappingURL=session-logger.d.ts.map

package/dist/src/orchestrator/session-logger.d.ts.map

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