@wickdninja/sweny-engine 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @swenyai/engine
+
+Workflow engine for SWEny -- orchestrates **Learn -> Act -> Report** pipelines with pluggable providers.
+
+## Install
+
+```bash
+npm install @swenyai/engine @swenyai/providers
+```
+
+## Quick Example
+
+```typescript
+import { runWorkflow, createProviderRegistry } from "@swenyai/engine";
+import { datadog } from "@swenyai/providers/observability";
+import { linear } from "@swenyai/providers/issue-tracking";
+import { github } from "@swenyai/providers/source-control";
+import { slackWebhook } from "@swenyai/providers/notification";
+import { claudeCode } from "@swenyai/providers/coding-agent";
+
+// 1. Register providers
+const providers = createProviderRegistry();
+providers.set("observability", datadog({ apiKey, appKey }));
+providers.set("issueTracker", linear({ apiKey }));
+providers.set("sourceControl", github({ token, owner, repo }));
+providers.set("notification", slackWebhook({ webhookUrl }));
+providers.set("codingAgent", claudeCode({}));
+
+// 2. Run a recipe
+import { triageWorkflow } from "@swenyai/engine/recipes/triage";
+
+const result = await runWorkflow(triageWorkflow, triageConfig, providers);
+console.log(result.status); // "completed" | "failed" | "partial"
+```
+
+## Concepts
+
+**Workflow** -- A pipeline of steps organized into three phases: Learn, Act, Report.
+
+**Step** -- A single unit of work (e.g., "query logs", "create issue", "send notification").
+
+**Recipe** -- A pre-built workflow. SWEny Triage is the first recipe.
+
+**ProviderRegistry** -- A type-safe container for pluggable service integrations.
+
+## Built-in Recipes
+
+| Recipe | Description |
+|--------|-------------|
+| **Triage** | Monitor observability logs -> investigate with AI -> create tickets -> open fix PRs -> notify |
+
+## Creating a Custom Workflow
+
+```typescript
+import type { Workflow } from "@swenyai/engine";
+
+const myWorkflow: Workflow<MyConfig> = {
+  name: "my-workflow",
+  phases: {
+    learn: [
+      { name: "fetch-data", phase: "learn", run: fetchData },
+    ],
+    act: [
+      { name: "process", phase: "act", run: processData },
+    ],
+    report: [
+      { name: "notify", phase: "report", run: sendReport },
+    ],
+  },
+};
+```
+
+## License
+
+[MIT](../../LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { WorkflowPhase, StepResult, WorkflowStep, WorkflowContext, ProviderRegistry, Workflow, WorkflowResult, RunOptions, } from "./types.js";
+export { runWorkflow, createProviderRegistry } from "./runner.js";
+export { triageWorkflow } from "./recipes/triage/index.js";
+export type { TriageConfig, InvestigationResult, ImplementResult, BuildContextData, IssueData, ImplementFixData, PrData, CrossRepoData, TriageStepDataMap, } from "./recipes/triage/index.js";
+export { getStepData } from "./recipes/triage/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Runtime
+export { runWorkflow, createProviderRegistry } from "./runner.js";
+// Recipes
+export { triageWorkflow } from "./recipes/triage/index.js";
+export { getStepData } from "./recipes/triage/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAElE,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAY3D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/recipes/triage/index.d.ts

@@ -0,0 +1,7 @@
+import type { Workflow } from "../../types.js";
+import type { TriageConfig } from "./types.js";
+/** The triage recipe — first workflow on the SWEny platform. */
+export declare const triageWorkflow: Workflow<TriageConfig>;
+export type { TriageConfig, InvestigationResult, ImplementResult, BuildContextData, IssueData, ImplementFixData, PrData, CrossRepoData, TriageStepDataMap, } from "./types.js";
+export { getStepData } from "./results.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recipes/triage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recipes/triage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW/C,gEAAgE;AAChE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAmBjD,CAAC;AAEF,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/recipes/triage/index.js

@@ -0,0 +1,30 @@
+import { verifyAccess } from "./steps/verify-access.js";
+import { buildContext } from "./steps/build-context.js";
+import { investigate } from "./steps/investigate.js";
+import { noveltyGate } from "./steps/novelty-gate.js";
+import { createIssue } from "./steps/create-issue.js";
+import { crossRepoCheck } from "./steps/cross-repo-check.js";
+import { implementFix } from "./steps/implement-fix.js";
+import { createPr } from "./steps/create-pr.js";
+import { sendNotification } from "./steps/notify.js";
+/** The triage recipe — first workflow on the SWEny platform. */
+export const triageWorkflow = {
+    name: "triage",
+    description: "Investigate production issues, implement fixes, and report results",
+    steps: [
+        // Learn phase — gather data
+        { name: "verify-access", phase: "learn", run: verifyAccess },
+        { name: "build-context", phase: "learn", run: buildContext },
+        { name: "investigate", phase: "learn", run: investigate },
+        // Act phase — fix the problem
+        { name: "novelty-gate", phase: "act", run: noveltyGate },
+        { name: "create-issue", phase: "act", run: createIssue },
+        { name: "cross-repo-check", phase: "act", run: crossRepoCheck },
+        { name: "implement-fix", phase: "act", run: implementFix },
+        { name: "create-pr", phase: "act", run: createPr },
+        // Report phase — notify stakeholders
+        { name: "notify", phase: "report", run: sendNotification },
+    ],
+};
+export { getStepData } from "./results.js";
+//# sourceMappingURL=index.js.map

package/dist/recipes/triage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recipes/triage/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oEAAoE;IACjF,KAAK,EAAE;QACL,4BAA4B;QAC5B,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE;QAC5D,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE;QAC5D,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE;QAEzD,8BAA8B;QAC9B,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE;QACxD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE;QACxD,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE;QAC/D,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE;QAC1D,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE;QAElD,qCAAqC;QACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;KAC3D;CACF,CAAC;AAaF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/recipes/triage/prompts.d.ts

@@ -0,0 +1,6 @@
+import type { ObservabilityProvider } from "@swenyai/providers/observability";
+import type { TriageConfig } from "./types.js";
+export declare function buildInvestigationPrompt(config: TriageConfig, observability: ObservabilityProvider, knownIssuesContent: string): string;
+export declare function buildImplementPrompt(issueIdentifier: string): string;
+export declare function buildPrDescriptionPrompt(issueIdentifier: string, issueUrl: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/recipes/triage/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/recipes/triage/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,qBAAqB,EACpC,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAgMR;AAMD,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CA0CpE;AAMD,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoC1F"}

package/dist/recipes/triage/prompts.js

@@ -0,0 +1,279 @@
+import * as fs from "fs";
+import { parseServiceMap } from "./service-map.js";
+// ---------------------------------------------------------------------------
+// Investigation Prompt
+// ---------------------------------------------------------------------------
+export function buildInvestigationPrompt(config, observability, knownIssuesContent) {
+    const parts = [];
+    parts.push(`You are an autonomous SRE agent investigating production issues.
+You have access to multiple tools and data sources. Your job is to investigate issues,
+understand problems, and prepare fixes.
+
+## CURRENT REPO
+You are running inside: **${config.repository}**
+
+## YOUR INPUTS - REVIEW THESE FIRST
+
+### Linear Issue
+${config.issueOverride || "(none provided)"}
+
+### Additional Instructions
+${config.additionalInstructions || "(none provided)"}
+
+### Cross-Repo Dispatch
+Dispatched from: (not dispatched — this is a direct run)
+Context from dispatcher: (none)
+
+### Investigation Parameters
+- Service Pattern: ${config.serviceFilter}
+- Time Range: ${config.timeRange}
+- Focus Area: ${config.severityFocus}
+- Investigation Depth: ${config.investigationDepth}
+
+## DECIDE YOUR APPROACH
+
+Based on the inputs above, decide how to proceed:
+
+1. **If a Linear Issue is provided** (e.g., ENG-123):
+   - Fetch the issue details and comments from Linear using the API
+   - Understand what the issue is about and any context from comments
+   - You may still query the observability provider for related logs if helpful
+   - Focus your investigation on this specific issue
+
+2. **If Additional Instructions are provided**:
+   - Follow them as your primary guide
+   - They may tell you to skip log investigation, focus on specific areas, etc.
+   - Use your judgment to combine with other inputs
+
+3. **If neither is provided** (default mode):
+   - Query the observability provider for recent errors
+   - Investigate the top issues
+   - Identify the best candidate for fixing
+
+4. **You can combine approaches** - e.g., work on a Linear issue AND check observability logs for related errors
+
+## AVAILABLE TOOLS
+
+${observability.getPromptInstructions()}
+
+### Linear API
+The \`LINEAR_API_KEY\` environment variable is set. Use the Linear GraphQL API directly via curl:
+
+\`\`\`bash
+# Get issue details by identifier (e.g., ENG-123)
+curl -s -X POST "https://api.linear.app/graphql" \\
+  -H "Content-Type: application/json" \\
+  -H "Authorization: \${LINEAR_API_KEY}" \\
+  -d '{"query":"query { issueSearch(query: \\"ENG-123\\") { nodes { id identifier title description url state { name } } } }"}'
+
+# Search for existing issues by title/keyword
+curl -s -X POST "https://api.linear.app/graphql" \\
+  -H "Content-Type: application/json" \\
+  -H "Authorization: \${LINEAR_API_KEY}" \\
+  -d '{"query":"query { issueSearch(query: \\"search terms\\", filter: { team: { id: { eq: \\"\${LINEAR_TEAM_ID}\\" } } }) { nodes { id identifier title url state { name } } } }"}'
+\`\`\`
+
+**Environment variables available:**
+- \`LINEAR_API_KEY\` - API key (already configured)
+- \`LINEAR_TEAM_ID\` - Team ID
+- \`LINEAR_BUG_LABEL_ID\` - Bug label ID
+
+## SERVICE OWNERSHIP MAP
+
+Read the service map at \`${config.serviceMapPath}\` to understand which GitHub repo
+owns which service. This is critical for cross-repo dispatch.
+
+**You MUST determine which repo should fix the bug you find.** Look at the service
+name in the error logs and match it against the \`owns\` list in the service map.`);
+    // Inject service map if it exists
+    const serviceMap = parseServiceMap(config.serviceMapPath);
+    if (serviceMap.services.length > 0) {
+        parts.push("");
+        parts.push("### Service Map Reference");
+        if (fs.existsSync(config.serviceMapPath)) {
+            parts.push(fs.readFileSync(config.serviceMapPath, "utf-8"));
+        }
+    }
+    // Target repo identification
+    parts.push(`
+## TARGET REPO IDENTIFICATION
+
+**Required**: In your \`best-candidate.md\` output, include these lines near the top
+(after the TRIAGE_FINGERPRINT and RECOMMENDATION):
+
+\`\`\`
+TARGET_SERVICE: <service-map key, e.g., my-service>
+TARGET_REPO: <GitHub repo, e.g., my-org/my-service>
+\`\`\`
+
+- If the bug belongs to **this repo**, set TARGET_REPO to the current repo.
+- If the bug belongs to **a different repo**, set TARGET_REPO to that repo.
+  The workflow will automatically dispatch to the correct repo.`);
+    // Known issues context
+    if (knownIssuesContent) {
+        parts.push(`
+## KNOWN ISSUES - DO NOT DUPLICATE
+
+The following issues and fixes have already been identified by previous triage runs.
+Do NOT create new issues or propose fixes for the same underlying problems.
+If the same error appears again, note it as a known issue and recommend a +1 on the existing issue instead.
+
+${knownIssuesContent}`);
+    }
+    // Investigation parameters and output requirements
+    parts.push(`
+## Investigation Parameters
+
+- **Service Pattern**: \`${config.serviceFilter}\`
+- **Time Range**: \`${config.timeRange}\`
+- **Focus Area**: \`${config.severityFocus}\`
+- **Investigation Depth**: \`${config.investigationDepth}\`
+
+## Output Requirements
+
+Create these files with your findings:
+
+### 1. \`.github/triage-analysis/investigation-log.md\`
+Document your investigation process - commands run, what you found, reasoning.
+
+### 2. \`.github/triage-analysis/issues-report.md\`
+For each issue found:
+- Severity, Environment (Production/Staging/Both), Frequency
+- Description, Evidence (logs, stack traces)
+- Root Cause Analysis, Impact, Suggested Fix
+- Files to Modify, Confidence Level
+- **Linear Status**: Check if this issue already exists in Linear
+  - If exists: Note the issue identifier (e.g., ENG-123) and URL
+  - If not found: Note as "No existing Linear issue found"
+
+### 3. \`.github/triage-analysis/best-candidate.md\`
+Select the BEST issue to fix based on impact, frequency, fixability.
+Include full technical analysis, exact code changes, test plan, rollback plan.
+
+**CRITICAL - Title Format**: The first \`#\` heading in this file becomes the Linear issue title and PR title.
+Do NOT prefix it with "Best Candidate Fix:", "Best Fix Candidate:", or any boilerplate.
+Write a concise, descriptive bug title like you would for a real bug ticket. Examples:
+- \`# extractUserFromResult Null Guard in EmitsEvent Decorator\`
+- \`# SQS Message Retry Storm from Unhandled TypeError in Worker\`
+- \`# PostgreSQL Vector Cast Syntax Error in Embedding Repository\`
+Do NOT include backticks (\\\`) in the heading — they cause shell injection in CI.
+
+**Important**: Include Linear Status at the top showing if this issue already exists:
+- If exists: \`**Linear Issue**: [ENG-123](url) - Issue already tracked\`
+- If not found: \`**Linear Issue**: None found - New issue will be created\`
+
+**Required**: Include a TRIAGE_FINGERPRINT block in an HTML comment at the very top of best-candidate.md:
+\`\`\`
+<!-- TRIAGE_FINGERPRINT
+error_pattern: <the key error message or pattern>
+service: <service name>
+first_seen: <date>
+run_id: <github run id if available>
+-->
+\`\`\`
+
+**Required**: Include a RECOMMENDATION line near the top (after the fingerprint):
+- \`RECOMMENDATION: implement\` - This is a novel issue worth fixing
+- \`RECOMMENDATION: +1 existing ENG-XXX\` - Same issue as an existing ticket, add occurrence
+- \`RECOMMENDATION: skip\` - Not worth fixing (too minor, expected behavior, etc.)
+
+## START NOW
+
+1. Review your inputs above (Linear Issue, Additional Instructions, Parameters)
+2. Decide your approach based on what was provided
+3. Execute your investigation using the available APIs
+4. Write the output files
+
+**CRITICAL**: You MUST write the output files BEFORE you run out of turns.
+Write files early and update them if needed. Do NOT keep investigating without writing files.
+
+**If Additional Instructions tell you to do something specific, follow them.**`);
+    return parts.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Implementation Prompt
+// ---------------------------------------------------------------------------
+export function buildImplementPrompt(issueIdentifier) {
+    return `You are implementing a fix for an issue identified from production logs.
+
+## Context
+
+Read the best candidate analysis at \`.github/triage-analysis/best-candidate.md\`.
+Also read \`.github/triage-analysis/investigation-log.md\` for context.
+
+## Your Task
+
+1. **Understand the issue**: Read the analysis thoroughly
+2. **Verify the fix approach**: Check the codebase to ensure the suggested fix is valid
+3. **Implement the fix**:
+   - Make minimal, focused changes
+   - Follow existing code patterns
+   - Add appropriate error handling
+   - Include TypeScript types
+   - Do NOT add unnecessary comments
+   - Do NOT refactor unrelated code
+
+4. **Verify your changes**:
+   - Run \`npm run lint\` to check for issues
+   - Run \`npm run build\` to verify compilation
+
+5. **Create a commit** with format:
+   \`\`\`
+   fix(<scope>): <brief description>
+
+   - <change 1>
+   - <change 2>
+
+   Identified by SWEny Triage
+   Linear: ${issueIdentifier}
+   \`\`\`
+
+## Safety Guidelines
+
+- If the fix is too complex or risky, create \`.github/triage-analysis/fix-declined.md\` explaining why
+- Do not make breaking changes
+- Prefer defensive coding patterns
+
+Start by reading the best-candidate.md file.`;
+}
+// ---------------------------------------------------------------------------
+// PR Description Prompt
+// ---------------------------------------------------------------------------
+export function buildPrDescriptionPrompt(issueIdentifier, issueUrl) {
+    return `Generate a pull request description.
+
+## Context
+
+1. Read \`.github/triage-analysis/best-candidate.md\` for issue details
+2. Read \`.github/triage-analysis/investigation-log.md\` for context
+3. Run \`git diff main..HEAD\` to see the changes made
+
+## Output
+
+Create \`.github/triage-analysis/pr-description.md\` with:
+
+## Summary
+<What this PR fixes and why>
+
+## Issue Analysis
+- Severity, Frequency, Services affected, Impact
+
+## Root Cause
+<Technical explanation>
+
+## Solution
+<Description and changes made>
+
+## Testing
+- [ ] Lint passes
+- [ ] Build passes
+- [ ] Tests pass
+
+## Rollback Plan
+<How to rollback>
+
+---
+**Linear Issue**: [${issueIdentifier}](${issueUrl})
+> Generated by SWEny Triage`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/recipes/triage/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/recipes/triage/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,wBAAwB,CACtC,MAAoB,EACpB,aAAoC,EACpC,kBAA0B;IAE1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC;;;;;4BAKe,MAAM,CAAC,UAAU;;;;;EAK3C,MAAM,CAAC,aAAa,IAAI,iBAAiB;;;EAGzC,MAAM,CAAC,sBAAsB,IAAI,iBAAiB;;;;;;;qBAO/B,MAAM,CAAC,aAAa;gBACzB,MAAM,CAAC,SAAS;gBAChB,MAAM,CAAC,aAAa;yBACX,MAAM,CAAC,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BhD,aAAa,CAAC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;4BA0BX,MAAM,CAAC,cAAc;;;;kFAIiC,CAAC,CAAC;IAElF,kCAAkC;IAClC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,IAAI,CAAC;;;;;;;;;;;;;gEAamD,CAAC,CAAC;IAEhE,uBAAuB;IACvB,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC;;;;;;;EAOb,kBAAkB,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,IAAI,CAAC;;;2BAGc,MAAM,CAAC,aAAa;sBACzB,MAAM,CAAC,SAAS;sBAChB,MAAM,CAAC,aAAa;+BACX,MAAM,CAAC,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EA4DuB,CAAC,CAAC;IAE/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAAC,eAAuB;IAC1D,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA+BI,eAAe;;;;;;;;;6CASiB,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,wBAAwB,CAAC,eAAuB,EAAE,QAAgB;IAChF,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiCY,eAAe,KAAK,QAAQ;4BACrB,CAAC;AAC7B,CAAC"}

package/dist/recipes/triage/results.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowContext } from "../../types.js";
+import type { TriageConfig, TriageStepDataMap } from "./types.js";
+/**
+ * Get typed step result data from the workflow context.
+ *
+ * Replaces unsafe casts like `ctx.results.get("investigate")?.data as unknown as T`.
+ * Step name is checked at compile time — typos are caught immediately.
+ *
+ * @example
+ * const investigation = getStepData(ctx, "investigate");
+ * //    ^? InvestigationResult | undefined
+ */
+export declare function getStepData<K extends keyof TriageStepDataMap>(ctx: WorkflowContext<TriageConfig>, stepName: K): TriageStepDataMap[K] | undefined;
+//# sourceMappingURL=results.d.ts.map

package/dist/recipes/triage/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/recipes/triage/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAC3D,GAAG,EAAE,eAAe,CAAC,YAAY,CAAC,EAClC,QAAQ,EAAE,CAAC,GACV,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAElC"}

package/dist/recipes/triage/results.js

@@ -0,0 +1,14 @@
+/**
+ * Get typed step result data from the workflow context.
+ *
+ * Replaces unsafe casts like `ctx.results.get("investigate")?.data as unknown as T`.
+ * Step name is checked at compile time — typos are caught immediately.
+ *
+ * @example
+ * const investigation = getStepData(ctx, "investigate");
+ * //    ^? InvestigationResult | undefined
+ */
+export function getStepData(ctx, stepName) {
+    return ctx.results.get(stepName)?.data;
+}
+//# sourceMappingURL=results.js.map

package/dist/recipes/triage/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/recipes/triage/results.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,GAAkC,EAClC,QAAW;IAEX,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAwC,CAAC;AAC7E,CAAC"}

package/dist/recipes/triage/service-map.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from "@swenyai/providers";
+export interface ServiceEntry {
+    name: string;
+    repo: string;
+    owns: string[];
+}
+export interface ServiceMap {
+    services: ServiceEntry[];
+}
+/**
+ * Parse a service-map.yml file using simple line-based parsing.
+ * Avoids YAML library dependency for ncc bundling simplicity.
+ */
+export declare function parseServiceMap(filePath: string, logger?: Logger): ServiceMap;
+//# sourceMappingURL=service-map.d.ts.map

package/dist/recipes/triage/service-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-map.d.ts","sourceRoot":"","sources":["../../../src/recipes/triage/service-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAsD7E"}

package/dist/recipes/triage/service-map.js

@@ -0,0 +1,56 @@
+import * as fs from "fs";
+/**
+ * Parse a service-map.yml file using simple line-based parsing.
+ * Avoids YAML library dependency for ncc bundling simplicity.
+ */
+export function parseServiceMap(filePath, logger) {
+    if (!fs.existsSync(filePath)) {
+        logger?.warn(`Service map not found at ${filePath}`);
+        return { services: [] };
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const services = [];
+    let current = null;
+    let inOwns = false;
+    for (const line of lines) {
+        const trimmed = line.trimEnd();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        // Top-level "services:" header
+        if (trimmed === "services:")
+            continue;
+        // Service name (2-space indent, ends with colon)
+        const serviceMatch = trimmed.match(/^  (\S+):$/);
+        if (serviceMatch) {
+            if (current)
+                services.push(current);
+            current = { name: serviceMatch[1], repo: "", owns: [] };
+            inOwns = false;
+            continue;
+        }
+        // repo field
+        const repoMatch = trimmed.match(/^\s+repo:\s*"?([^"]+)"?$/);
+        if (repoMatch && current) {
+            current.repo = repoMatch[1];
+            inOwns = false;
+            continue;
+        }
+        // owns header
+        if (trimmed.match(/^\s+owns:\s*$/) && current) {
+            inOwns = true;
+            continue;
+        }
+        // owns list item
+        const ownsMatch = trimmed.match(/^\s+-\s+(.+)$/);
+        if (ownsMatch && current && inOwns) {
+            current.owns.push(ownsMatch[1].trim());
+            continue;
+        }
+    }
+    if (current)
+        services.push(current);
+    return { services };
+}
+//# sourceMappingURL=service-map.js.map

package/dist/recipes/triage/service-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-map.js","sourceRoot":"","sources":["../../../src/recipes/triage/service-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAazB;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAe;IAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,EAAE,IAAI,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,OAAO,GAAwB,IAAI,CAAC;IACxC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE/B,gCAAgC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,+BAA+B;QAC/B,IAAI,OAAO,KAAK,WAAW;YAAE,SAAS;QAEtC,iDAAiD;QACjD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACxD,MAAM,GAAG,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QAED,aAAa;QACb,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC5D,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,GAAG,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,OAAO,EAAE,CAAC;YAC9C,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QAED,iBAAiB;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,SAAS,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/recipes/triage/steps/build-context.d.ts

@@ -0,0 +1,5 @@
+import type { StepResult, WorkflowContext } from "../../../types.js";
+import type { TriageConfig } from "../types.js";
+/** Build known-issues context from issue tracker + source control to prevent duplicates. */
+export declare function buildContext(ctx: WorkflowContext<TriageConfig>): Promise<StepResult>;
+//# sourceMappingURL=build-context.d.ts.map

package/dist/recipes/triage/steps/build-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-context.d.ts","sourceRoot":"","sources":["../../../../src/recipes/triage/steps/build-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,4FAA4F;AAC5F,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAyF1F"}

package/dist/recipes/triage/steps/build-context.js

@@ -0,0 +1,85 @@
+import { canListTriageHistory } from "@swenyai/providers/issue-tracking";
+/** Build known-issues context from issue tracker + source control to prevent duplicates. */
+export async function buildContext(ctx) {
+    const issueTracker = ctx.providers.get("issueTracker");
+    const sourceControl = ctx.providers.get("sourceControl");
+    const config = ctx.config;
+    const lines = [];
+    lines.push("# Known Triage History (Last 30 Days)");
+    lines.push("");
+    lines.push("These issues have already been identified by previous SWEny Triage runs.");
+    lines.push("Do NOT create new issues or propose fixes for these same problems.");
+    lines.push("");
+    // 1. Fetch recent triage issues (last 30 days)
+    lines.push("## Tracked Issues");
+    try {
+        if (canListTriageHistory(issueTracker)) {
+            const triageHistory = await issueTracker.listTriageHistory(config.projectId, config.triageLabelId, 30);
+            if (triageHistory.length > 0) {
+                for (const entry of triageHistory) {
+                    lines.push(`- **${entry.identifier}** [${entry.state}] ${entry.title} — ${entry.url}`);
+                }
+            }
+            else {
+                lines.push("_No triage-labeled issues found in last 30 days_");
+            }
+        }
+        else {
+            lines.push("_Issue tracker does not support triage history_");
+        }
+    }
+    catch (err) {
+        ctx.logger.warn(`Failed to fetch triage history: ${err}`);
+        lines.push("_Failed to fetch triage history_");
+    }
+    lines.push("");
+    // 2. Fetch recent triage PRs
+    lines.push("## Pull Requests");
+    try {
+        const triagePrs = await sourceControl.listPullRequests({
+            state: "all",
+            labels: ["triage"],
+            limit: 30,
+        });
+        lines.push("### Merged (fixed)");
+        const merged = triagePrs.filter((pr) => pr.state === "merged");
+        if (merged.length > 0) {
+            for (const pr of merged) {
+                lines.push(`- PR #${pr.number}: ${pr.title} — ${pr.url}`);
+            }
+        }
+        else {
+            lines.push("_None_");
+        }
+        lines.push("### Open (in progress)");
+        const open = triagePrs.filter((pr) => pr.state === "open");
+        if (open.length > 0) {
+            for (const pr of open) {
+                lines.push(`- PR #${pr.number}: ${pr.title} — ${pr.url}`);
+            }
+        }
+        else {
+            lines.push("_None_");
+        }
+        lines.push("### Closed (failed attempts)");
+        const closed = triagePrs.filter((pr) => pr.state === "closed");
+        if (closed.length > 0) {
+            for (const pr of closed) {
+                lines.push(`- PR #${pr.number}: ${pr.title} — ${pr.url}`);
+            }
+        }
+        else {
+            lines.push("_None_");
+        }
+    }
+    catch {
+        ctx.logger.warn("Failed to fetch triage PRs");
+        lines.push("_Failed to fetch triage PRs_");
+    }
+    const knownIssuesContent = lines.join("\n");
+    return {
+        status: "success",
+        data: { knownIssuesContent },
+    };
+}
+//# sourceMappingURL=build-context.js.map