cyrus-edge-worker 0.0.37 → 0.0.39

package/dist/procedures/ProcedureRouter.js

@@ -0,0 +1,201 @@
+/**
+ * ProcedureRouter - Intelligent routing of agent sessions through procedures
+ *
+ * Uses SimpleClaudeRunner to analyze requests and determine which procedure
+ * (sequence of subroutines) should be executed.
+ */
+import { SimpleClaudeRunner } from "cyrus-simple-agent-runner";
+import { getProcedureForClassification, PROCEDURES } from "./registry.js";
+export class ProcedureRouter {
+    routingRunner;
+    procedures = new Map();
+    constructor(config) {
+        // Initialize SimpleClaudeRunner for routing decisions
+        this.routingRunner = new SimpleClaudeRunner({
+            validResponses: [
+                "question",
+                "documentation",
+                "transient",
+                "code",
+                "debugger",
+                "orchestrator",
+            ],
+            cyrusHome: config.cyrusHome,
+            model: config.model || "haiku",
+            fallbackModel: "sonnet",
+            systemPrompt: this.buildRoutingSystemPrompt(),
+            maxTurns: 1,
+            timeoutMs: config.timeoutMs || 10000,
+        });
+        // Load all predefined procedures from registry
+        this.loadPredefinedProcedures();
+    }
+    /**
+     * Build the system prompt for routing classification
+     */
+    buildRoutingSystemPrompt() {
+        return `You are a request classifier for a software agent system.
+
+Analyze the Linear issue request and classify it into ONE of these categories:
+
+**question**: User is asking a question, seeking information, or requesting explanation.
+- Examples: "How does X work?", "What is the purpose of Y?", "Explain the architecture"
+
+**documentation**: User wants documentation, markdown, or comments edited (no code changes).
+- Examples: "Update the README", "Add docstrings to functions", "Fix typos in docs"
+
+**transient**: Request involves MCP tools, temporary files, or no codebase interaction.
+- Examples: "Search the web for X", "Generate a diagram", "Use Linear MCP to check issues"
+
+**debugger**: User EXPLICITLY requests the full debugging workflow with reproduction and approval.
+- ONLY use this if the user specifically asks for: "debug this with approval workflow", "reproduce the bug first", "show me the root cause before fixing"
+- DO NOT use for regular bug reports - those should use "code"
+- Examples: "Debug this issue and get my approval before fixing", "Reproduce the authentication bug with approval checkpoint"
+
+**orchestrator**: User EXPLICITLY requests decomposition into sub-issues with specialized agent delegation.
+- ONLY use this if the user specifically asks for: "break this into sub-issues", "orchestrate this work", "use sub-agents", "delegate to specialized agents"
+- DO NOT use for regular complex work - those should use "code"
+- Examples: "Orchestrate this feature with sub-issues", "Break this down and delegate to specialized agents", "Create sub-tasks for this epic"
+
+**code**: Request involves code changes, features, bugs, or refactoring (DEFAULT for most work).
+- Examples: "Fix bug in X", "Add feature Y", "Refactor module Z", "Implement new API endpoint", "Fix the login issue"
+- Use this for ALL standard bug fixes and features
+
+IMPORTANT: Respond with ONLY the classification word, nothing else.`;
+    }
+    /**
+     * Load predefined procedures from registry
+     */
+    loadPredefinedProcedures() {
+        for (const [name, procedure] of Object.entries(PROCEDURES)) {
+            this.procedures.set(name, procedure);
+        }
+    }
+    /**
+     * Determine which procedure to use for a given request
+     */
+    async determineRoutine(requestText) {
+        try {
+            // Classify the request using SimpleClaudeRunner
+            const result = await this.routingRunner.query(`Classify this Linear issue request:\n\n${requestText}`);
+            const classification = result.response;
+            // Get procedure name for this classification
+            const procedureName = getProcedureForClassification(classification);
+            // Get procedure definition
+            const procedure = this.procedures.get(procedureName);
+            if (!procedure) {
+                throw new Error(`Procedure "${procedureName}" not found in registry`);
+            }
+            return {
+                classification,
+                procedure,
+                reasoning: `Classified as "${classification}" → using procedure "${procedureName}"`,
+            };
+        }
+        catch (error) {
+            // Fallback to full-development on error
+            console.error("[ProcedureRouter] Error during routing decision:", error);
+            const fallbackProcedure = this.procedures.get("full-development");
+            if (!fallbackProcedure) {
+                throw new Error("Fallback procedure 'full-development' not found");
+            }
+            return {
+                classification: "code",
+                procedure: fallbackProcedure,
+                reasoning: `Fallback to full-development due to error: ${error}`,
+            };
+        }
+    }
+    /**
+     * Get the next subroutine for a session
+     * Returns null if procedure is complete
+     */
+    getNextSubroutine(session) {
+        const procedureMetadata = session.metadata?.procedure;
+        if (!procedureMetadata) {
+            // No procedure metadata - session doesn't use procedure routing
+            return null;
+        }
+        const procedure = this.procedures.get(procedureMetadata.procedureName);
+        if (!procedure) {
+            console.error(`[ProcedureRouter] Procedure "${procedureMetadata.procedureName}" not found`);
+            return null;
+        }
+        const nextIndex = procedureMetadata.currentSubroutineIndex + 1;
+        if (nextIndex >= procedure.subroutines.length) {
+            // Procedure complete
+            return null;
+        }
+        return procedure.subroutines[nextIndex] ?? null;
+    }
+    /**
+     * Get the current subroutine for a session
+     */
+    getCurrentSubroutine(session) {
+        const procedureMetadata = session.metadata?.procedure;
+        if (!procedureMetadata) {
+            return null;
+        }
+        const procedure = this.procedures.get(procedureMetadata.procedureName);
+        if (!procedure) {
+            return null;
+        }
+        const currentIndex = procedureMetadata.currentSubroutineIndex;
+        if (currentIndex < 0 || currentIndex >= procedure.subroutines.length) {
+            return null;
+        }
+        return procedure.subroutines[currentIndex] ?? null;
+    }
+    /**
+     * Initialize procedure metadata for a new session
+     */
+    initializeProcedureMetadata(session, procedure) {
+        if (!session.metadata) {
+            session.metadata = {};
+        }
+        session.metadata.procedure = {
+            procedureName: procedure.name,
+            currentSubroutineIndex: 0,
+            subroutineHistory: [],
+        };
+    }
+    /**
+     * Record subroutine completion and advance to next
+     */
+    advanceToNextSubroutine(session, claudeSessionId) {
+        const procedureMetadata = session.metadata?.procedure;
+        if (!procedureMetadata) {
+            throw new Error("Cannot advance: session has no procedure metadata");
+        }
+        const currentSubroutine = this.getCurrentSubroutine(session);
+        if (currentSubroutine) {
+            // Record completion
+            procedureMetadata.subroutineHistory.push({
+                subroutine: currentSubroutine.name,
+                completedAt: Date.now(),
+                claudeSessionId,
+            });
+        }
+        // Advance index
+        procedureMetadata.currentSubroutineIndex++;
+    }
+    /**
+     * Check if procedure is complete
+     */
+    isProcedureComplete(session) {
+        return this.getNextSubroutine(session) === null;
+    }
+    /**
+     * Register a custom procedure
+     */
+    registerProcedure(procedure) {
+        this.procedures.set(procedure.name, procedure);
+    }
+    /**
+     * Get procedure by name
+     */
+    getProcedure(name) {
+        return this.procedures.get(name);
+    }
+}
+//# sourceMappingURL=ProcedureRouter.js.map

package/dist/procedures/ProcedureRouter.js.map

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

package/dist/procedures/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Procedure routing system for intelligent workflow selection
+ */
+export * from "./ProcedureRouter.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/procedures/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/procedures/index.js

@@ -0,0 +1,7 @@
+/**
+ * Procedure routing system for intelligent workflow selection
+ */
+export * from "./ProcedureRouter.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/procedures/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/procedures/registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Registry of predefined procedures and routing rules
+ */
+import type { ProcedureDefinition, RequestClassification } from "./types.js";
+/**
+ * Predefined subroutine definitions
+ */
+export declare const SUBROUTINES: {
+    readonly primary: {
+        readonly name: "primary";
+        readonly promptPath: "primary";
+        readonly description: "Main work execution phase";
+    };
+    readonly debuggerReproduction: {
+        readonly name: "debugger-reproduction";
+        readonly promptPath: "subroutines/debugger-reproduction.md";
+        readonly description: "Reproduce bug and perform root cause analysis";
+    };
+    readonly getApproval: {
+        readonly name: "get-approval";
+        readonly promptPath: "subroutines/get-approval.md";
+        readonly description: "Request user approval before proceeding";
+        readonly maxTurns: 1;
+        readonly requiresApproval: true;
+    };
+    readonly debuggerFix: {
+        readonly name: "debugger-fix";
+        readonly promptPath: "subroutines/debugger-fix.md";
+        readonly description: "Implement minimal fix based on approved reproduction";
+    };
+    readonly verifications: {
+        readonly name: "verifications";
+        readonly promptPath: "subroutines/verifications.md";
+        readonly description: "Run tests, linting, and type checking";
+    };
+    readonly gitGh: {
+        readonly name: "git-gh";
+        readonly promptPath: "subroutines/git-gh.md";
+        readonly description: "Commit changes and create/update PR";
+    };
+    readonly conciseSummary: {
+        readonly name: "concise-summary";
+        readonly promptPath: "subroutines/concise-summary.md";
+        readonly maxTurns: 1;
+        readonly description: "Brief summary for simple requests";
+        readonly suppressThoughtPosting: true;
+    };
+    readonly verboseSummary: {
+        readonly name: "verbose-summary";
+        readonly promptPath: "subroutines/verbose-summary.md";
+        readonly maxTurns: 1;
+        readonly description: "Detailed summary with implementation details";
+        readonly suppressThoughtPosting: true;
+    };
+};
+/**
+ * Predefined procedure definitions
+ */
+export declare const PROCEDURES: Record<string, ProcedureDefinition>;
+/**
+ * Mapping from request classification to procedure name
+ */
+export declare const CLASSIFICATION_TO_PROCEDURE: Record<RequestClassification, string>;
+/**
+ * Get a procedure definition by name
+ */
+export declare function getProcedure(name: string): ProcedureDefinition | undefined;
+/**
+ * Get procedure name for a given classification
+ */
+export declare function getProcedureForClassification(classification: RequestClassification): string;
+/**
+ * Get all available procedure names
+ */
+export declare function getAllProcedureNames(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/procedures/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/procedures/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Cd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAiD1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC/C,qBAAqB,EACrB,MAAM,CAQN,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC5C,cAAc,EAAE,qBAAqB,GACnC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/procedures/registry.js

@@ -0,0 +1,130 @@
+/**
+ * Registry of predefined procedures and routing rules
+ */
+/**
+ * Predefined subroutine definitions
+ */
+export const SUBROUTINES = {
+    primary: {
+        name: "primary",
+        promptPath: "primary", // Special: resolved via label (debugger/builder/scoper/orchestrator)
+        description: "Main work execution phase",
+    },
+    debuggerReproduction: {
+        name: "debugger-reproduction",
+        promptPath: "subroutines/debugger-reproduction.md",
+        description: "Reproduce bug and perform root cause analysis",
+    },
+    getApproval: {
+        name: "get-approval",
+        promptPath: "subroutines/get-approval.md",
+        description: "Request user approval before proceeding",
+        maxTurns: 1,
+        requiresApproval: true, // Flag to trigger approval workflow
+    },
+    debuggerFix: {
+        name: "debugger-fix",
+        promptPath: "subroutines/debugger-fix.md",
+        description: "Implement minimal fix based on approved reproduction",
+    },
+    verifications: {
+        name: "verifications",
+        promptPath: "subroutines/verifications.md",
+        description: "Run tests, linting, and type checking",
+    },
+    gitGh: {
+        name: "git-gh",
+        promptPath: "subroutines/git-gh.md",
+        description: "Commit changes and create/update PR",
+    },
+    conciseSummary: {
+        name: "concise-summary",
+        promptPath: "subroutines/concise-summary.md",
+        maxTurns: 1,
+        description: "Brief summary for simple requests",
+        suppressThoughtPosting: true,
+    },
+    verboseSummary: {
+        name: "verbose-summary",
+        promptPath: "subroutines/verbose-summary.md",
+        maxTurns: 1,
+        description: "Detailed summary with implementation details",
+        suppressThoughtPosting: true,
+    },
+};
+/**
+ * Predefined procedure definitions
+ */
+export const PROCEDURES = {
+    "simple-question": {
+        name: "simple-question",
+        description: "For questions or requests that don't modify the codebase",
+        subroutines: [SUBROUTINES.primary, SUBROUTINES.conciseSummary],
+    },
+    "documentation-edit": {
+        name: "documentation-edit",
+        description: "For documentation/markdown edits that don't require verification",
+        subroutines: [
+            SUBROUTINES.primary,
+            SUBROUTINES.gitGh,
+            SUBROUTINES.conciseSummary,
+        ],
+    },
+    "full-development": {
+        name: "full-development",
+        description: "For code changes requiring full verification and PR creation",
+        subroutines: [
+            SUBROUTINES.primary,
+            SUBROUTINES.verifications,
+            SUBROUTINES.gitGh,
+            SUBROUTINES.verboseSummary,
+        ],
+    },
+    "debugger-full": {
+        name: "debugger-full",
+        description: "Full debugging workflow with reproduction, approval, fix, and verification",
+        subroutines: [
+            SUBROUTINES.debuggerReproduction,
+            SUBROUTINES.getApproval,
+            SUBROUTINES.debuggerFix,
+            SUBROUTINES.verifications,
+            SUBROUTINES.gitGh,
+            SUBROUTINES.verboseSummary,
+        ],
+    },
+    "orchestrator-full": {
+        name: "orchestrator-full",
+        description: "Full orchestration workflow with decomposition and delegation to sub-agents",
+        subroutines: [SUBROUTINES.primary, SUBROUTINES.verboseSummary],
+    },
+};
+/**
+ * Mapping from request classification to procedure name
+ */
+export const CLASSIFICATION_TO_PROCEDURE = {
+    question: "simple-question",
+    documentation: "documentation-edit",
+    transient: "simple-question",
+    code: "full-development",
+    debugger: "debugger-full",
+    orchestrator: "orchestrator-full",
+};
+/**
+ * Get a procedure definition by name
+ */
+export function getProcedure(name) {
+    return PROCEDURES[name];
+}
+/**
+ * Get procedure name for a given classification
+ */
+export function getProcedureForClassification(classification) {
+    return CLASSIFICATION_TO_PROCEDURE[classification];
+}
+/**
+ * Get all available procedure names
+ */
+export function getAllProcedureNames() {
+    return Object.keys(PROCEDURES);
+}
+//# sourceMappingURL=registry.js.map

package/dist/procedures/registry.js.map

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

package/dist/procedures/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Type definitions for the procedure routing system
+ */
+/**
+ * Definition of a single subroutine in a procedure
+ */
+export interface SubroutineDefinition {
+    /** Unique identifier for the subroutine */
+    name: string;
+    /** Path to the prompt file (relative to edge-worker/src/prompts/) */
+    promptPath: string;
+    /** Optional maximum number of turns (undefined = unlimited) */
+    maxTurns?: number;
+    /** Human-readable description of what this subroutine does */
+    description: string;
+    /** Whether this subroutine should skip posting to Linear activity stream */
+    skipLinearPost?: boolean;
+    /** Whether to suppress posting thoughts/actions (still posts final summary) */
+    suppressThoughtPosting?: boolean;
+    /** Whether this subroutine requires user approval before advancing to next step */
+    requiresApproval?: boolean;
+}
+/**
+ * Complete definition of a procedure (sequence of subroutines)
+ */
+export interface ProcedureDefinition {
+    /** Unique identifier for the procedure */
+    name: string;
+    /** Human-readable description of when to use this procedure */
+    description: string;
+    /** Ordered list of subroutines to execute */
+    subroutines: SubroutineDefinition[];
+}
+/**
+ * Procedure metadata stored in session.metadata.procedure
+ */
+export interface ProcedureMetadata {
+    /** Name of the active procedure */
+    procedureName: string;
+    /** Current position in the subroutine sequence (0-indexed) */
+    currentSubroutineIndex: number;
+    /** History of completed subroutines */
+    subroutineHistory: Array<{
+        subroutine: string;
+        completedAt: number;
+        claudeSessionId: string | null;
+    }>;
+}
+/**
+ * Request classification types for routing decisions
+ */
+export type RequestClassification = "question" | "documentation" | "transient" | "code" | "debugger" | "orchestrator";
+/**
+ * Result of procedure routing decision
+ */
+export interface RoutingDecision {
+    /** Classification of the request */
+    classification: RequestClassification;
+    /** Selected procedure to execute */
+    procedure: ProcedureDefinition;
+    /** Reasoning for the classification (for debugging) */
+    reasoning?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/procedures/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,CAAC;IAE/B,uCAAuC;IACvC,iBAAiB,EAAE,KAAK,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B,UAAU,GACV,eAAe,GACf,WAAW,GACX,MAAM,GACN,UAAU,GACV,cAAc,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,oCAAoC;IACpC,cAAc,EAAE,qBAAqB,CAAC;IAEtC,oCAAoC;IACpC,SAAS,EAAE,mBAAmB,CAAC;IAE/B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/procedures/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the procedure routing system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/procedures/types.js.map

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

package/dist/prompts/subroutines/concise-summary.md

@@ -0,0 +1,53 @@
+# Summary - Brief Response for Linear
+
+Generate a concise summary of the work completed for posting to Linear.
+
+## Your Task
+
+Create a clear, brief summary that covers:
+
+### 1. Work Completed
+- What was accomplished (1-2 sentences)
+- Key outcome or result
+
+### 2. Key Details (if applicable)
+- Files modified or created (brief list)
+- Important changes made
+- PR link if created
+
+### 3. Status
+- Completion status
+- Any follow-up needed
+
+## Format Requirements
+
+- **Be concise** - aim for 3-5 paragraphs maximum
+- Use clear, professional language suitable for Linear
+- Use markdown formatting for readability
+- Focus on what matters to stakeholders
+- **To mention someone**: Use `https://linear.app/linear/profiles/username` syntax where `username` is the Linear username (e.g., `https://linear.app/linear/profiles/alice` to mention @alice)
+
+## Constraints
+
+- **You have exactly 1 turn** - generate the summary in a single response
+- This is the final output that will be posted to Linear
+- Make it informative but brief
+
+## Example Format
+
+```
+## Summary
+
+[Brief description of what was done]
+
+## Changes
+
+- [Key change 1]
+- [Key change 2]
+
+## Status
+
+[Current status and any next steps]
+
+[PR link if applicable]
+```