@supaku/agentfactory-linear 0.7.9 → 0.7.10

package/dist/src/constants.d.ts

@@ -34,6 +34,11 @@ export declare const CONTINUATION_MARKER = "\n\n*...continued in next comment*";
  * hoisting issues where the value is captured before dotenv runs.
  */
 export declare function getDefaultTeamId(): string;
+/**
+ * Default team name
+ * Can be set via LINEAR_TEAM_NAME env var (auto-set by orchestrator from issue context)
+ */
+export declare function getDefaultTeamName(): string;
 /**
  * Project IDs — must be set via env vars:
  * - LINEAR_PROJECT_AGENT

package/dist/src/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAQ,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,mBAAmB,uCAAuC,CAAA;AAQvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;IAG1B,mDAAmD;;CAE3C,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAA;AAGV,eAAO,MAAM,gBAAgB;IAC3B,+DAA+D;;IAE/D,2CAA2C;;CAEnC,CAAA;AAMV;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;CAS1B,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAQ,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,mBAAmB,uCAAuC,CAAA;AAQvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;IAG1B,mDAAmD;;CAE3C,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAA;AAGV,eAAO,MAAM,gBAAgB;IAC3B,+DAA+D;;IAE/D,2CAA2C;;CAEnC,CAAA;AAMV;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;CAS1B,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAA"}

package/dist/src/constants.js

@@ -44,6 +44,13 @@ export const CONTINUATION_MARKER = '\n\n*...continued in next comment*';
 export function getDefaultTeamId() {
     return process.env.LINEAR_TEAM_ID ?? '';
 }
+/**
+ * Default team name
+ * Can be set via LINEAR_TEAM_NAME env var (auto-set by orchestrator from issue context)
+ */
+export function getDefaultTeamName() {
+    return process.env.LINEAR_TEAM_NAME ?? '';
+}
 /**
  * Project IDs — must be set via env vars:
  * - LINEAR_PROJECT_AGENT

package/dist/src/defaults/index.d.ts

@@ -5,7 +5,7 @@
  * New users start with these defaults and customize as needed.
  * Supaku overrides these with its own prompts.ts.
  */
-export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, } from './prompts.js';
+export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, buildFailureContextBlock, WORK_RESULT_MARKER_INSTRUCTION, PR_SELECTION_GUIDANCE, type WorkflowContext, } from './prompts.js';
 export { defaultDetectWorkTypeFromPrompt } from './work-type-detection.js';
 export { defaultGetPriority } from './priority.js';
 export { defaultParseAutoTriggerConfig, type DefaultAutoTriggerConfig, } from './auto-trigger.js';

package/dist/src/defaults/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/defaults/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EACL,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/defaults/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mCAAmC,EACnC,wBAAwB,EACxB,8BAA8B,EAC9B,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EACL,6BAA6B,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAA"}

package/dist/src/defaults/index.js

@@ -5,7 +5,7 @@
  * New users start with these defaults and customize as needed.
  * Supaku overrides these with its own prompts.ts.
  */
-export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, } from './prompts.js';
+export { defaultGeneratePrompt, defaultBuildParentQAContext, defaultBuildParentAcceptanceContext, buildFailureContextBlock, WORK_RESULT_MARKER_INSTRUCTION, PR_SELECTION_GUIDANCE, } from './prompts.js';
 export { defaultDetectWorkTypeFromPrompt } from './work-type-detection.js';
 export { defaultGetPriority } from './priority.js';
 export { defaultParseAutoTriggerConfig, } from './auto-trigger.js';

package/dist/src/defaults/prompts.d.ts

@@ -5,14 +5,31 @@
  * The Supaku project overrides these with its own prompts.ts.
  */
 import type { AgentWorkType, SubIssueStatus } from '../types.js';
+export declare const WORK_RESULT_MARKER_INSTRUCTION = "\n\nMANDATORY \u2014 Structured Result Marker:\nYou MUST include exactly one of these HTML comment markers in your final output:\n- On pass: <!-- WORK_RESULT:passed -->\n- On fail: <!-- WORK_RESULT:failed -->\nWithout this marker, the orchestrator CANNOT detect your result and the issue status will NOT be updated. Even if you encounter errors, always emit <!-- WORK_RESULT:failed -->.";
+export declare const PR_SELECTION_GUIDANCE = "\n\nPR Selection (Multi-PR Handling):\nIssues may have multiple PRs. Select the correct one:\n1. Check linked PRs in the issue attachments/links for GitHub PR URLs\n2. Filter by state \u2014 prefer OPEN over MERGED over CLOSED: gh pr view NNN --json state\n3. If multiple OPEN PRs, pick the most recently created one\n4. Fallback search by branch: gh pr list --head \"$(git branch --show-current)\" --state open\n5. Last resort search by issue ID: gh pr list --state open --search \"[issue-id]\"\n6. If no PR found, emit WORK_RESULT:failed with explanation";
+/**
+ * Context from the workflow state machine for retry enrichment.
+ * Injected when an issue has been through previous dev-QA-rejected cycles.
+ */
+export interface WorkflowContext {
+    cycleCount: number;
+    strategy: string;
+    failureSummary: string | null;
+    qaAttemptCount?: number;
+}
+/**
+ * Build the failure context block to append to prompts for retries.
+ */
+export declare function buildFailureContextBlock(workType: AgentWorkType, context: WorkflowContext): string;
 /**
  * Generate a default prompt for a given work type and issue identifier.
  *
  * @param identifier - The issue identifier (e.g., "PROJ-123")
  * @param workType - The type of work to perform
  * @param mentionContext - Optional additional context from a user mention
+ * @param workflowContext - Optional workflow state context for retry enrichment
  */
-export declare function defaultGeneratePrompt(identifier: string, workType: AgentWorkType, mentionContext?: string): string;
+export declare function defaultGeneratePrompt(identifier: string, workType: AgentWorkType, mentionContext?: string, workflowContext?: WorkflowContext): string;
 /**
  * Build default QA context for parent issues with sub-issues.
  */

package/dist/src/defaults/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/defaults/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAahE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA4DR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,cAAc,EAAE,GACjC,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,cAAc,EAAE,GACjC,MAAM,CAmBR"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/defaults/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAahE,eAAO,MAAM,8BAA8B,uYAMsI,CAAA;AAEjL,eAAO,MAAM,qBAAqB,ijBAS0B,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,eAAe,GACvB,MAAM,CA0DR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,eAAe,GAChC,MAAM,CAuFR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,cAAc,EAAE,GACjC,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,cAAc,EAAE,GACjC,MAAM,CAmBR"}

package/dist/src/defaults/prompts.js

@@ -14,14 +14,91 @@ manual setup steps, policy decisions, access permissions), create a blocker issu
 This creates a tracked issue in Icebox with 'Needs Human' label, linked as blocking the source issue.
 Do NOT silently skip human-needed work or bury it in comments.
 Only create blockers for things that genuinely require a human — not for things you can retry or work around.`;
+export const WORK_RESULT_MARKER_INSTRUCTION = `
+
+MANDATORY — Structured Result Marker:
+You MUST include exactly one of these HTML comment markers in your final output:
+- On pass: <!-- WORK_RESULT:passed -->
+- On fail: <!-- WORK_RESULT:failed -->
+Without this marker, the orchestrator CANNOT detect your result and the issue status will NOT be updated. Even if you encounter errors, always emit <!-- WORK_RESULT:failed -->.`;
+export const PR_SELECTION_GUIDANCE = `
+
+PR Selection (Multi-PR Handling):
+Issues may have multiple PRs. Select the correct one:
+1. Check linked PRs in the issue attachments/links for GitHub PR URLs
+2. Filter by state — prefer OPEN over MERGED over CLOSED: gh pr view NNN --json state
+3. If multiple OPEN PRs, pick the most recently created one
+4. Fallback search by branch: gh pr list --head "$(git branch --show-current)" --state open
+5. Last resort search by issue ID: gh pr list --state open --search "[issue-id]"
+6. If no PR found, emit WORK_RESULT:failed with explanation`;
+/**
+ * Build the failure context block to append to prompts for retries.
+ */
+export function buildFailureContextBlock(workType, context) {
+    if (context.cycleCount <= 0)
+        return '';
+    switch (workType) {
+        case 'refinement': {
+            if (context.strategy === 'decompose') {
+                return `\n\n## Decomposition Required (Cycle ${context.cycleCount})
+
+This issue has been through ${context.cycleCount} development-QA cycle(s) and keeps failing.
+Instead of refining, DECOMPOSE this issue into smaller, independently testable pieces.
+
+### Failure History
+${context.failureSummary ?? 'No details recorded.'}
+
+### Decomposition Instructions
+- Break this issue into smaller sub-issues (use --parentId to make them children)
+- Each sub-issue must have clear, unambiguous acceptance criteria
+- Each sub-issue must be testable in isolation
+- Address one specific concern that previous attempts failed on
+- After creating sub-issues, move the PARENT issue to Backlog status`;
+            }
+            return `\n\n## Previous Failure Context
+
+This issue has been through ${context.cycleCount} development-QA cycle(s).
+
+### Failure History
+${context.failureSummary ?? 'No details recorded.'}
+
+### Instructions
+- Read the failure history carefully before making changes
+- Do NOT repeat approaches that already failed
+- If the acceptance criteria are ambiguous, update them to be testable before fixing code
+- Focus on the ROOT CAUSE, not symptoms`;
+        }
+        case 'development':
+        case 'coordination': {
+            return `\n\n## Retry Context
+
+This is retry #${context.cycleCount} for this issue. Previous QA failures:
+${context.failureSummary ?? 'No details recorded.'}
+
+Pay special attention to the areas that failed QA previously.`;
+        }
+        case 'qa':
+        case 'qa-coordination': {
+            if (!context.failureSummary)
+                return '';
+            return `\n\n## Previous QA Results
+This issue has been QA'd ${context.qaAttemptCount ?? context.cycleCount} times previously.
+${context.failureSummary}
+Focus validation on these previously failing areas.`;
+        }
+        default:
+            return '';
+    }
+}
 /**
  * Generate a default prompt for a given work type and issue identifier.
  *
  * @param identifier - The issue identifier (e.g., "PROJ-123")
  * @param workType - The type of work to perform
  * @param mentionContext - Optional additional context from a user mention
+ * @param workflowContext - Optional workflow state context for retry enrichment
  */
-export function defaultGeneratePrompt(identifier, workType, mentionContext) {
+export function defaultGeneratePrompt(identifier, workType, mentionContext, workflowContext) {
     let basePrompt;
     switch (workType) {
         case 'research':
@@ -45,10 +122,30 @@ Do NOT wait for user approval - create issues automatically.`;
             basePrompt = `Continue work on ${identifier}. Resume where you left off.`;
             break;
         case 'qa':
-            basePrompt = `QA ${identifier}. Validate the implementation against acceptance criteria.`;
+            basePrompt = `QA ${identifier}. Validate the implementation against acceptance criteria.
+${WORK_RESULT_MARKER_INSTRUCTION}
+${PR_SELECTION_GUIDANCE}
+
+Validation Steps:
+1. Find and validate the correct PR (see PR selection above)
+2. Run tests scoped to the affected packages
+3. Verify the build passes
+4. Check deployment status (CI checks on the PR)
+5. Review changes against issue requirements
+6. Post result comment with the structured marker`;
             break;
         case 'acceptance':
-            basePrompt = `Process acceptance for ${identifier}. Validate development and QA work is complete, verify PR is ready to merge (CI passing, no conflicts), merge the PR, and clean up local resources.`;
+            basePrompt = `Process acceptance for ${identifier}. Validate development and QA work is complete, verify PR is ready to merge (CI passing, no conflicts), merge the PR, and clean up local resources.
+${WORK_RESULT_MARKER_INSTRUCTION}
+${PR_SELECTION_GUIDANCE}
+
+Acceptance Steps:
+1. Find and validate the correct PR (see PR selection above)
+2. Verify CI is passing and there are no merge conflicts
+3. Confirm QA has passed (check issue status or QA comments)
+4. Merge the PR
+5. Delete the remote branch after successful merge
+6. Post result comment with the structured marker`;
             break;
         case 'refinement':
             basePrompt = `Refine ${identifier} based on rejection feedback. Read comments, update requirements, then return to Backlog.`;
@@ -67,13 +164,19 @@ Before marking the parent issue as complete, verify ALL sub-issues are in Finish
 If any sub-issue is not Finished, report the failure and do not mark the parent as complete.`;
             break;
         case 'qa-coordination':
-            basePrompt = `Coordinate QA across sub-issues for parent issue ${identifier}. Fetch sub-issues, spawn QA sub-agents in parallel for each sub-issue, collect pass/fail results, and roll up to parent. ALL sub-issues must pass QA for the parent to pass.`;
+            basePrompt = `Coordinate QA across sub-issues for parent issue ${identifier}. Fetch sub-issues, spawn QA sub-agents in parallel for each sub-issue, collect pass/fail results, and roll up to parent. ALL sub-issues must pass QA for the parent to pass.
+${WORK_RESULT_MARKER_INSTRUCTION}`;
             break;
         case 'acceptance-coordination':
-            basePrompt = `Coordinate acceptance across sub-issues for parent issue ${identifier}. Verify all sub-issues are Delivered, validate the PR (CI passing, no conflicts), merge the PR, and bulk-update sub-issues to Accepted.`;
+            basePrompt = `Coordinate acceptance across sub-issues for parent issue ${identifier}. Verify all sub-issues are Delivered, validate the PR (CI passing, no conflicts), merge the PR, and bulk-update sub-issues to Accepted.
+${WORK_RESULT_MARKER_INSTRUCTION}`;
             break;
     }
     basePrompt += HUMAN_BLOCKER_INSTRUCTION;
+    // Inject workflow failure context for retries
+    if (workflowContext) {
+        basePrompt += buildFailureContextBlock(workType, workflowContext);
+    }
     if (mentionContext) {
         return `${basePrompt}\n\nAdditional context from the user's mention:\n${mentionContext}`;
     }

package/dist/src/defaults/prompts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompts.test.d.ts.map

package/dist/src/defaults/prompts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.test.d.ts","sourceRoot":"","sources":["../../../src/defaults/prompts.test.ts"],"names":[],"mappings":""}

package/dist/src/defaults/prompts.test.js

@@ -0,0 +1,130 @@
+import { describe, it, expect } from 'vitest';
+import { buildFailureContextBlock, defaultGeneratePrompt } from './prompts.js';
+describe('buildFailureContextBlock', () => {
+    const baseContext = {
+        cycleCount: 2,
+        strategy: 'context-enriched',
+        failureSummary: '--- Cycle 1, qa (2024-01-01) ---\nTests failed: TypeError in UserService',
+    };
+    describe('refinement work type', () => {
+        it('returns empty string for cycleCount 0', () => {
+            expect(buildFailureContextBlock('refinement', { ...baseContext, cycleCount: 0 })).toBe('');
+        });
+        it('includes failure history for cycle 1+', () => {
+            const result = buildFailureContextBlock('refinement', baseContext);
+            expect(result).toContain('Previous Failure Context');
+            expect(result).toContain('2 development-QA cycle(s)');
+            expect(result).toContain('TypeError in UserService');
+            expect(result).toContain('Do NOT repeat approaches that already failed');
+        });
+        it('includes decomposition instructions for decompose strategy', () => {
+            const decomposeCtx = {
+                ...baseContext,
+                cycleCount: 3,
+                strategy: 'decompose',
+            };
+            const result = buildFailureContextBlock('refinement', decomposeCtx);
+            expect(result).toContain('Decomposition Required');
+            expect(result).toContain('DECOMPOSE this issue');
+            expect(result).toContain('smaller sub-issues');
+            expect(result).not.toContain('Previous Failure Context');
+        });
+        it('handles null failure summary gracefully', () => {
+            const result = buildFailureContextBlock('refinement', { ...baseContext, failureSummary: null });
+            expect(result).toContain('No details recorded');
+        });
+    });
+    describe('development work type', () => {
+        it('returns empty string for cycleCount 0', () => {
+            expect(buildFailureContextBlock('development', { ...baseContext, cycleCount: 0 })).toBe('');
+        });
+        it('includes retry context for cycle 1+', () => {
+            const result = buildFailureContextBlock('development', baseContext);
+            expect(result).toContain('Retry Context');
+            expect(result).toContain('retry #2');
+            expect(result).toContain('TypeError in UserService');
+        });
+    });
+    describe('coordination work type', () => {
+        it('includes retry context same as development', () => {
+            const result = buildFailureContextBlock('coordination', baseContext);
+            expect(result).toContain('Retry Context');
+            expect(result).toContain('retry #2');
+        });
+    });
+    describe('qa work type', () => {
+        it('returns empty string when no failure summary', () => {
+            expect(buildFailureContextBlock('qa', { ...baseContext, failureSummary: null })).toBe('');
+        });
+        it('includes previous QA results when failure summary exists', () => {
+            const qaCtx = {
+                ...baseContext,
+                qaAttemptCount: 2,
+            };
+            const result = buildFailureContextBlock('qa', qaCtx);
+            expect(result).toContain('Previous QA Results');
+            expect(result).toContain('QA\'d 2 times previously');
+            expect(result).toContain('TypeError in UserService');
+        });
+        it('falls back to cycleCount when qaAttemptCount not provided', () => {
+            const result = buildFailureContextBlock('qa', baseContext);
+            expect(result).toContain('QA\'d 2 times previously');
+        });
+    });
+    describe('other work types', () => {
+        it('returns empty string for acceptance', () => {
+            expect(buildFailureContextBlock('acceptance', baseContext)).toBe('');
+        });
+        it('returns empty string for research', () => {
+            expect(buildFailureContextBlock('research', baseContext)).toBe('');
+        });
+        it('returns empty string for backlog-creation', () => {
+            expect(buildFailureContextBlock('backlog-creation', baseContext)).toBe('');
+        });
+    });
+});
+describe('defaultGeneratePrompt with workflowContext', () => {
+    it('does not modify prompt when workflowContext is undefined', () => {
+        const withoutCtx = defaultGeneratePrompt('PROJ-123', 'development');
+        const withUndefined = defaultGeneratePrompt('PROJ-123', 'development', undefined, undefined);
+        expect(withoutCtx).toBe(withUndefined);
+    });
+    it('does not modify prompt when cycleCount is 0', () => {
+        const withoutCtx = defaultGeneratePrompt('PROJ-123', 'development');
+        const withZero = defaultGeneratePrompt('PROJ-123', 'development', undefined, {
+            cycleCount: 0,
+            strategy: 'normal',
+            failureSummary: null,
+        });
+        expect(withoutCtx).toBe(withZero);
+    });
+    it('enriches refinement prompt with failure context', () => {
+        const result = defaultGeneratePrompt('PROJ-123', 'refinement', undefined, {
+            cycleCount: 2,
+            strategy: 'context-enriched',
+            failureSummary: 'Tests failed in UserService',
+        });
+        expect(result).toContain('Refine PROJ-123');
+        expect(result).toContain('Previous Failure Context');
+        expect(result).toContain('Tests failed in UserService');
+    });
+    it('enriches development prompt with retry context', () => {
+        const result = defaultGeneratePrompt('PROJ-123', 'development', undefined, {
+            cycleCount: 1,
+            strategy: 'normal',
+            failureSummary: 'Build error in core package',
+        });
+        expect(result).toContain('Start work on PROJ-123');
+        expect(result).toContain('Retry Context');
+        expect(result).toContain('Build error in core package');
+    });
+    it('preserves mentionContext alongside workflowContext', () => {
+        const result = defaultGeneratePrompt('PROJ-123', 'development', 'Please focus on the API layer', {
+            cycleCount: 1,
+            strategy: 'normal',
+            failureSummary: 'API tests failing',
+        });
+        expect(result).toContain('Retry Context');
+        expect(result).toContain('Please focus on the API layer');
+    });
+});

package/dist/src/frontend-adapter.d.ts

@@ -0,0 +1,168 @@
+/**
+ * LinearFrontendAdapter
+ *
+ * Implements the WorkSchedulingFrontend interface (defined in @supaku/agentfactory)
+ * by wrapping the LinearAgentClient. This adapter translates between abstract,
+ * frontend-agnostic types and Linear-specific concepts.
+ *
+ * Structural typing note: This class structurally satisfies the WorkSchedulingFrontend
+ * interface from @supaku/agentfactory without an explicit `implements` clause, avoiding
+ * a circular package dependency (core depends on linear at runtime, linear depends on
+ * core only for types). Consumers who import both packages can assign this to
+ * WorkSchedulingFrontend.
+ */
+import type { LinearAgentClient } from './agent-client.js';
+/**
+ * Abstract workflow statuses that map to Linear-specific status names.
+ */
+export type AbstractStatus = 'icebox' | 'backlog' | 'started' | 'finished' | 'delivered' | 'accepted' | 'rejected' | 'canceled';
+/**
+ * Minimal issue representation shared across frontends.
+ */
+export interface AbstractIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    url: string;
+    status: AbstractStatus;
+    priority: number;
+    labels: string[];
+    parentId?: string;
+    project?: string;
+    createdAt: Date;
+}
+/**
+ * Minimal comment representation.
+ */
+export interface AbstractComment {
+    id: string;
+    body: string;
+    userId?: string;
+    userName?: string;
+    createdAt: Date;
+}
+/**
+ * External URL for agent sessions.
+ */
+export interface ExternalUrl {
+    label: string;
+    url: string;
+}
+/**
+ * Input for creating an issue.
+ */
+export interface CreateIssueInput {
+    title: string;
+    teamId?: string;
+    description?: string;
+    projectId?: string;
+    status?: AbstractStatus;
+    labels?: string[];
+    parentId?: string;
+    priority?: number;
+}
+/**
+ * Input for creating a blocker issue.
+ */
+export interface CreateBlockerInput {
+    title: string;
+    description?: string;
+    teamId?: string;
+    projectId?: string;
+    assignee?: string;
+}
+/**
+ * Input for updating an agent session.
+ */
+export interface UpdateSessionInput {
+    externalUrls?: ExternalUrl[];
+    plan?: Array<{
+        content: string;
+        status: 'pending' | 'inProgress' | 'completed' | 'canceled';
+    }>;
+}
+/**
+ * Linear frontend adapter that wraps LinearAgentClient.
+ *
+ * Structurally satisfies WorkSchedulingFrontend from @supaku/agentfactory.
+ */
+export declare class LinearFrontendAdapter {
+    private readonly client;
+    readonly name: "linear";
+    constructor(client: LinearAgentClient);
+    /**
+     * Resolve an abstract status to its Linear-native name.
+     */
+    resolveStatus(abstract: AbstractStatus): string;
+    /**
+     * Map a Linear-native status name to its abstract equivalent.
+     * Defaults to 'backlog' for unknown statuses.
+     */
+    abstractStatus(nativeStatus: string): AbstractStatus;
+    /**
+     * Fetch an issue by ID or identifier and map to AbstractIssue.
+     */
+    getIssue(id: string): Promise<AbstractIssue>;
+    /**
+     * List issues in a project filtered by abstract status.
+     *
+     * Uses the underlying LinearClient directly since LinearAgentClient
+     * does not expose a project-scoped issue listing method.
+     */
+    listIssuesByStatus(project: string, status: AbstractStatus): Promise<AbstractIssue[]>;
+    /**
+     * Get comments for an issue and map to AbstractComment[].
+     */
+    getIssueComments(id: string): Promise<AbstractComment[]>;
+    /**
+     * List issues in a project filtered by abstract status, excluding
+     * those that are blocked by other issues (have incoming "blocks" relations).
+     */
+    getUnblockedIssues(project: string, status: AbstractStatus): Promise<AbstractIssue[]>;
+    /**
+     * Check if an issue has child issues (is a parent issue).
+     */
+    isParentIssue(id: string): Promise<boolean>;
+    /**
+     * Check if an issue has a parent (is a child/sub-issue).
+     */
+    isChildIssue(id: string): Promise<boolean>;
+    /**
+     * Get sub-issues of a parent issue, mapped to AbstractIssue[].
+     */
+    getSubIssues(id: string): Promise<AbstractIssue[]>;
+    /**
+     * Transition an issue to a new status.
+     */
+    transitionIssue(id: string, status: AbstractStatus): Promise<void>;
+    /**
+     * Create a comment on an issue.
+     */
+    createComment(id: string, body: string): Promise<void>;
+    /**
+     * Create a blocker issue that blocks the source issue.
+     * Creates the issue in Icebox with a "Needs Human" label (if found),
+     * then creates a "blocks" relation from the blocker to the source.
+     */
+    createBlockerIssue(sourceId: string, data: CreateBlockerInput): Promise<AbstractIssue>;
+    /**
+     * Create a new issue and return it as AbstractIssue.
+     */
+    createIssue(data: CreateIssueInput): Promise<AbstractIssue>;
+    /**
+     * Create an agent session on an issue.
+     * Returns the session ID.
+     */
+    createAgentSession(issueId: string, externalUrls?: ExternalUrl[]): Promise<string>;
+    /**
+     * Update an existing agent session.
+     */
+    updateAgentSession(sessionId: string, data: UpdateSessionInput): Promise<void>;
+    /**
+     * Create an activity on an agent session.
+     * Wraps the content as a ThoughtActivityContent.
+     */
+    createActivity(sessionId: string, type: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=frontend-adapter.d.ts.map

package/dist/src/frontend-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-adapter.d.ts","sourceRoot":"","sources":["../../src/frontend-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAM1D;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAA;KAAE,CAAC,CAAA;CAC/F;AA8ED;;;;GAIG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;gBAEJ,MAAM,EAAE,iBAAiB;IAItD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAI/C;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc;IAMpD;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKlD;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkB3F;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAS9D;;;OAGG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiB3F;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWxD;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxE;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyC5F;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBjE;;;OAGG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxF;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpF;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWtF"}