edsger 0.51.0 → 0.52.0

package/.claude/settings.local.json

@@ -1,8 +1,28 @@
 {
   "permissions": {
     "allow": [
-      "Bash(npx tsc:*)",
-      "Bash(npm run:*)"
-    ]
+      "Read(//Users/steven/development/edsger/**)",
+      "Bash(npm run build)",
+      "Bash(node:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(git diff:*)",
+      "WebSearch",
+      "WebFetch(domain:supabase.com)",
+      "Bash(npm install:*)",
+      "Bash(grep:*)",
+      "Bash(npx supabase gen types typescript --help:*)",
+      "Bash(git -C /Users/steven/development/edsger status)",
+      "Bash(git -C /Users/steven/development/edsger diff)",
+      "Bash(git -C /Users/steven/development/edsger log --oneline -5)",
+      "Bash(git -C /Users/steven/development/edsger add supabase/migrations/20251231000000_drop_unused_views.sql)",
+      "Bash(git -C /Users/steven/development/edsger commit -m \"$\\(cat <<''EOF''\nchore: drop unused database views\n\nRemove test_report_summary and user_stories_with_context views that are defined but never used in the application.\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git -C /Users/steven/development/edsger commit -m \"$\\(cat <<''EOF''\nchore: drop unused database views\n\nRemove test_report_summary and user_stories_with_context views\nthat are defined but never used in the application.\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
+    ],
+    "deny": [],
+    "ask": []
   }
 }

package/.env.local

@@ -0,0 +1,12 @@
+OPENAI_API_KEY=
+TRIGGER_SECRET_KEY=
+RECALL_AI_API_KEY=
+RECALL_WEBHOOK_SECRET=
+NEXT_PUBLIC_APP_URL=
+RESEND_API_KEY=
+EMAIL_FROM=
+GITHUB_APP_ID=
+GITHUB_APP_PRIVATE_KEY=
+GITHUB_APP_SLUG=
+DEEPGRAM_API_KEY=
+DEEPGRAM_PROJECT_ID=

package/dist/commands/find-smells/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI command: edsger find-smells <productId>
+ * Audits the product's repository for code smells (refactor candidates, perf
+ * cliffs, dead code, etc.) and files each new finding as an issue.
+ */
+import { type SmellCategory } from '../../phases/find-smells/types.js';
+export interface FindSmellsCliOptions {
+    full?: boolean;
+    branch?: string;
+    maxFiles?: number;
+    categories?: SmellCategory[];
+    verbose?: boolean;
+}
+/**
+ * Parse and validate `--categories` from the CLI. Throws on invalid input so
+ * commander's option-parser rejects the run before any work starts. Empty
+ * input is treated as "no filter" (returns undefined) rather than an error —
+ * matches user intuition for `--categories=`.
+ */
+export declare function parseCategoriesOption(raw: string): SmellCategory[] | undefined;
+export declare function runFindSmells(productId: string, options: FindSmellsCliOptions): Promise<void>;

package/dist/commands/find-smells/index.js

@@ -0,0 +1,65 @@
+/**
+ * CLI command: edsger find-smells <productId>
+ * Audits the product's repository for code smells (refactor candidates, perf
+ * cliffs, dead code, etc.) and files each new finding as an issue.
+ */
+import { getGitHubConfigByProduct } from '../../api/github.js';
+import { scanForSmells } from '../../phases/find-smells/index.js';
+import { isSmellCategory, SMELL_CATEGORIES, } from '../../phases/find-smells/types.js';
+import { logError, logInfo, logSuccess } from '../../utils/logger.js';
+/**
+ * Parse and validate `--categories` from the CLI. Throws on invalid input so
+ * commander's option-parser rejects the run before any work starts. Empty
+ * input is treated as "no filter" (returns undefined) rather than an error —
+ * matches user intuition for `--categories=`.
+ */
+export function parseCategoriesOption(raw) {
+    const tokens = raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (tokens.length === 0) {
+        return undefined;
+    }
+    const invalid = tokens.filter((t) => !isSmellCategory(t));
+    if (invalid.length > 0) {
+        throw new Error(`--categories: unknown value(s): ${invalid.join(', ')}. ` +
+            `Allowed: ${SMELL_CATEGORIES.join(', ')}`);
+    }
+    // Dedup while preserving order so the error message and downstream behaviour
+    // are deterministic.
+    return Array.from(new Set(tokens));
+}
+export async function runFindSmells(productId, options) {
+    const { full, branch, maxFiles, categories, verbose } = options;
+    logInfo(`Starting smell scan for product ${productId}`);
+    const githubConfig = await getGitHubConfigByProduct(productId, verbose);
+    if (!githubConfig.configured ||
+        !githubConfig.token ||
+        !githubConfig.owner ||
+        !githubConfig.repo) {
+        logError(`GitHub not configured for product ${productId}: ${githubConfig.message || 'No installation found'}`);
+        process.exit(1);
+    }
+    const result = await scanForSmells({
+        productId,
+        githubToken: githubConfig.token,
+        owner: githubConfig.owner,
+        repo: githubConfig.repo,
+        full,
+        branch,
+        maxFiles,
+        categories,
+        verbose,
+    });
+    if (result.status === 'success') {
+        logSuccess(result.message);
+        if (result.summary) {
+            logInfo(result.summary);
+        }
+    }
+    else {
+        logError(result.message);
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -15,6 +15,7 @@ import { runCodeReview } from './commands/code-review/index.js';
 import { runConfigGet, runConfigList, runConfigSet, runConfigUnset, } from './commands/config/index.js';
 import { runFindBugs } from './commands/find-bugs/index.js';
 import { runFindFeatures } from './commands/find-features/index.js';
+import { parseCategoriesOption, runFindSmells, } from './commands/find-smells/index.js';
 import { runGrowthAnalysis } from './commands/growth-analysis/index.js';
 import { runInit } from './commands/init/index.js';
 import { runIntelligence } from './commands/intelligence/index.js';
@@ -26,6 +27,8 @@ import { runRunSheetCommand } from './commands/run-sheet/index.js';
 import { runSmokeTestCommand } from './commands/smoke-test/index.js';
 import { runTaskWorker } from './commands/task-worker/index.js';
 import { runWorkflow } from './commands/workflow/index.js';
+import { DEFAULT_MAX_FILES as FIND_SMELLS_DEFAULT_MAX_FILES } from './phases/find-smells/index.js';
+import { SMELL_CATEGORIES, } from './phases/find-smells/types.js';
 import { logError, logInfo } from './utils/logger.js';
 // Get package.json version dynamically
 // eslint-disable-next-line @typescript-eslint/naming-convention -- ESM __filename/__dirname polyfill
@@ -414,6 +417,32 @@ program
     }
 });
 // ============================================================
+// Subcommand: edsger find-smells <productId>
+// ============================================================
+program
+    .command('find-smells <productId>')
+    .description("AI-audit a product's repository for code smells (refactor candidates, perf cliffs, dead code, type-safety gaps) and file each new finding as an issue")
+    .option('--full', 'Force a full scan even if previous-scan state exists')
+    .option('--branch <name>', 'Branch to scan (defaults to repo default branch)')
+    .option('--max-files <n>', `Upper bound on files the auditor may Read (default ${FIND_SMELLS_DEFAULT_MAX_FILES})`, (value) => {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n <= 0) {
+        throw new Error('--max-files must be a positive integer');
+    }
+    return n;
+})
+    .option('--categories <list>', `Comma-separated category filter (${SMELL_CATEGORIES.join(',')})`, parseCategoriesOption)
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (productId, opts) => {
+    try {
+        await runFindSmells(productId, opts);
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
 // Subcommand: edsger pr-resolve <productId>
 // ============================================================
 program

package/dist/phases/find-bugs/index.js

@@ -4,11 +4,11 @@
  * incremental, scoped to commits since the previous successful scan.
  */
 import { query } from '@anthropic-ai/claude-agent-sdk';
-import { execFileSync } from 'child_process';
-import { callMcpEndpoint } from '../../api/mcp-client.js';
 import { DEFAULT_MODEL } from '../../constants.js';
 import { logError, logInfo, logSuccess, logWarning, } from '../../utils/logger.js';
 import { cloneIssueRepo, ensureWorkspaceDir, syncRepoToRef, } from '../../workspace/workspace-manager.js';
+import { detectDefaultBranch, gitRevParse, isAncestor, listChangedPaths, } from '../find-shared/git.js';
+import { createIssue, fetchOpenIssues, fetchProductBasics, } from '../find-shared/mcp.js';
 import { createPromptGenerator, extractTextFromContent, tryExtractResult, } from '../pr-shared/agent-utils.js';
 import { createFindBugsSystemPrompt, createFindBugsUserPrompt, } from './prompts.js';
 import { acquireFindBugsLock, loadFindBugsState, updateFindBugsState, } from './state.js';
@@ -193,97 +193,12 @@ export async function scanForBugs(options) {
         lock.release();
     }
 }
-function gitRevParse(repoPath, ref) {
-    return execFileSync('git', ['rev-parse', ref], {
-        cwd: repoPath,
-        encoding: 'utf-8',
-    }).trim();
-}
-function detectDefaultBranch(repoPath) {
-    try {
-        const ref = execFileSync('git', ['symbolic-ref', '--short', 'refs/remotes/origin/HEAD'], { cwd: repoPath, encoding: 'utf-8' }).trim();
-        // ref is like "origin/main"
-        return ref.replace(/^origin\//, '');
-    }
-    catch {
-        return 'main';
-    }
-}
-function isAncestor(repoPath, ancestor, descendant) {
-    try {
-        execFileSync('git', ['merge-base', '--is-ancestor', ancestor, descendant], {
-            cwd: repoPath,
-            stdio: 'pipe',
-        });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function listChangedPaths(repoPath, baseSha, headSha) {
-    try {
-        const out = execFileSync('git', ['diff', '--name-only', `${baseSha}..${headSha}`], { cwd: repoPath, encoding: 'utf-8' });
-        return out
-            .split('\n')
-            .map((s) => s.trim())
-            .filter((s) => s.length > 0);
-    }
-    catch {
-        return [];
-    }
-}
-async function fetchProductBasics(productId) {
-    try {
-        const result = (await callMcpEndpoint('resources/read', {
-            uri: `product://${productId}`,
-        }));
-        const text = result.contents?.[0]?.text || '{}';
-        const parsed = JSON.parse(text);
-        return {
-            name: parsed.name || productId,
-            description: parsed.description,
-        };
-    }
-    catch {
-        return { name: productId };
-    }
-}
-async function fetchOpenIssues(productId) {
-    try {
-        const result = (await callMcpEndpoint('issues/list', {
-            product_id: productId,
-        }));
-        const all = result.issues || [];
-        // Dedup is only useful against issues that are still actionable.
-        return all.filter((i) => !isTerminalStatus(i.status));
-    }
-    catch (error) {
-        logWarning(`Could not load existing issues for dedup: ${error instanceof Error ? error.message : String(error)}`);
-        return [];
-    }
-}
-function isTerminalStatus(status) {
-    return (status === 'shipped' ||
-        status === 'archived' ||
-        status === 'cancelled' ||
-        status === 'closed' ||
-        status === 'completed');
-}
 async function createIssueForBug(productId, bug) {
-    const description = formatIssueDescription(bug);
-    try {
-        const result = (await callMcpEndpoint('issues/create', {
-            product_id: productId,
-            name: bug.title,
-            description,
-        }));
-        return result.issue?.id || result.id || null;
-    }
-    catch (error) {
-        logError(`Failed to create issue for "${bug.title}": ${error instanceof Error ? error.message : String(error)}`);
-        return null;
-    }
+    return createIssue({
+        productId,
+        title: bug.title,
+        description: formatIssueDescription(bug),
+    });
 }
 function formatIssueDescription(bug) {
     const location = bug.line ? `${bug.file}:${bug.line}` : bug.file;

package/dist/phases/find-bugs/state.d.ts

@@ -1,44 +1,19 @@
 /**
- * Per-product scan state persisted under `~/.edsger/find-bugs-state/<productId>.json`.
+ * Per-product scan state for find-bugs. Storage at
+ * `~/.edsger/find-bugs-state/<productId>.json`.
  *
- * Covers three concerns:
- *
- * 1. **Incremental scope**: `lastScannedCommitSha` tells the next run where to
- *    diff from. Only updated on a successful audit.
- * 2. **Failure tracking**: `lastAttemptedAt` / `lastError` are updated even on
- *    failure so an orchestrating agent can back off instead of looping on a
- *    permanent misconfiguration (e.g. missing GitHub install).
- * 3. **Concurrency**: a lock file next to the state file gates simultaneous
- *    runs for the same product — they share one workspace clone.
- *
- * Known limitation: state is machine-local. A scan started on machine A and
- * next on machine B will look like a first run. Tracked for a future migration
- * to a DB-backed store (see the v0.2 followups).
+ * Schema is bug-scan-specific (incremental commit sha tracking + failure
+ * recording); the file/lock machinery is shared via createScanStateModule.
  */
+import { type LockHandle } from '../find-shared/scan-state.js';
+export type { LockHandle };
 export interface FindBugsState {
     lastScannedCommitSha?: string;
     lastScannedAt?: string;
     lastAttemptedAt?: string;
     lastError?: string;
 }
-export declare function loadFindBugsState(productId: string): FindBugsState;
-/**
- * Atomic write: stage to a tempfile, then rename. A crash mid-write leaves the
- * previous state intact instead of truncating it.
- */
-export declare function saveFindBugsState(productId: string, state: FindBugsState): void;
-/**
- * Merge new fields into the stored state. Fields not mentioned are preserved.
- */
-export declare function updateFindBugsState(productId: string, patch: Partial<FindBugsState>): FindBugsState;
-export interface LockHandle {
-    release: () => void;
-}
-/**
- * Acquire an exclusive lock for this product's scan state.
- *
- * Uses O_EXCL on a lockfile, which is atomic on local POSIX filesystems (good
- * enough — the workspace clone is also machine-local). Returns null if already
- * held. Stale locks older than `staleAfterMs` are reclaimed.
- */
-export declare function acquireFindBugsLock(productId: string, staleAfterMs?: number): LockHandle | null;
+export declare const loadFindBugsState: (productId: string) => FindBugsState;
+export declare const saveFindBugsState: (productId: string, state: FindBugsState) => void;
+export declare const updateFindBugsState: (productId: string, patch: Partial<FindBugsState>) => FindBugsState;
+export declare const acquireFindBugsLock: (productId: string, staleAfterMs?: number) => LockHandle | null;

package/dist/phases/find-bugs/state.js

@@ -1,121 +1,13 @@
 /**
- * Per-product scan state persisted under `~/.edsger/find-bugs-state/<productId>.json`.
- *
- * Covers three concerns:
- *
- * 1. **Incremental scope**: `lastScannedCommitSha` tells the next run where to
- *    diff from. Only updated on a successful audit.
- * 2. **Failure tracking**: `lastAttemptedAt` / `lastError` are updated even on
- *    failure so an orchestrating agent can back off instead of looping on a
- *    permanent misconfiguration (e.g. missing GitHub install).
- * 3. **Concurrency**: a lock file next to the state file gates simultaneous
- *    runs for the same product — they share one workspace clone.
- *
- * Known limitation: state is machine-local. A scan started on machine A and
- * next on machine B will look like a first run. Tracked for a future migration
- * to a DB-backed store (see the v0.2 followups).
- */
-import { existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, unlinkSync, writeFileSync, } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-function stateDir() {
-    return join(homedir(), '.edsger', 'find-bugs-state');
-}
-function safeProductId(productId) {
-    // productId is a UUID controlled upstream; still strip any slashes defensively.
-    return productId.replace(/[^a-zA-Z0-9_-]/g, '_');
-}
-function statePath(productId) {
-    return join(stateDir(), `${safeProductId(productId)}.json`);
-}
-function lockPath(productId) {
-    return join(stateDir(), `${safeProductId(productId)}.lock`);
-}
-function ensureStateDir() {
-    const dir = stateDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    return dir;
-}
-export function loadFindBugsState(productId) {
-    const p = statePath(productId);
-    if (!existsSync(p)) {
-        return {};
-    }
-    try {
-        const raw = readFileSync(p, 'utf-8');
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === 'object' ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Atomic write: stage to a tempfile, then rename. A crash mid-write leaves the
- * previous state intact instead of truncating it.
- */
-export function saveFindBugsState(productId, state) {
-    ensureStateDir();
-    const finalPath = statePath(productId);
-    const tmpPath = `${finalPath}.${process.pid}.tmp`;
-    writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
-    renameSync(tmpPath, finalPath);
-}
-/**
- * Merge new fields into the stored state. Fields not mentioned are preserved.
- */
-export function updateFindBugsState(productId, patch) {
-    const merged = { ...loadFindBugsState(productId), ...patch };
-    saveFindBugsState(productId, merged);
-    return merged;
-}
-/**
- * Acquire an exclusive lock for this product's scan state.
- *
- * Uses O_EXCL on a lockfile, which is atomic on local POSIX filesystems (good
- * enough — the workspace clone is also machine-local). Returns null if already
- * held. Stale locks older than `staleAfterMs` are reclaimed.
- */
-export function acquireFindBugsLock(productId, staleAfterMs = 60 * 60 * 1000) {
-    ensureStateDir();
-    const lock = lockPath(productId);
-    if (existsSync(lock)) {
-        try {
-            const raw = readFileSync(lock, 'utf-8');
-            const parsed = JSON.parse(raw);
-            const age = Date.now() - new Date(parsed.acquiredAt ?? 0).getTime();
-            if (age < staleAfterMs) {
-                return null;
-            }
-            // Stale — reclaim. A run crashing without cleanup (SIGKILL, OOM) is the
-            // only way to reach here. Logging is the caller's job.
-            rmSync(lock, { force: true });
-        }
-        catch {
-            // Corrupt lockfile — also reclaim.
-            rmSync(lock, { force: true });
-        }
-    }
-    try {
-        // wx = fail if exists, create otherwise. Atomic against a racing peer.
-        const fd = openSync(lock, 'wx');
-        writeFileSync(fd, JSON.stringify({ acquiredAt: new Date().toISOString(), pid: process.pid }));
-        // Note: we don't hold the fd; the lock is the file's existence.
-        // Close is implicit via the writeFileSync result on this fd.
-        return {
-            release: () => {
-                try {
-                    unlinkSync(lock);
-                }
-                catch {
-                    // Already gone — fine.
-                }
-            },
-        };
-    }
-    catch {
-        return null;
-    }
-}
+ * Per-product scan state for find-bugs. Storage at
+ * `~/.edsger/find-bugs-state/<productId>.json`.
+ *
+ * Schema is bug-scan-specific (incremental commit sha tracking + failure
+ * recording); the file/lock machinery is shared via createScanStateModule.
+ */
+import { createScanStateModule, } from '../find-shared/scan-state.js';
+const m = createScanStateModule({ dirName: 'find-bugs-state' });
+export const loadFindBugsState = m.load;
+export const saveFindBugsState = m.save;
+export const updateFindBugsState = m.update;
+export const acquireFindBugsLock = m.acquireLock;

package/dist/phases/find-features/index.js

@@ -13,11 +13,12 @@
  * code, we care what exists there.
  */
 import { query } from '@anthropic-ai/claude-agent-sdk';
-import { execFileSync } from 'child_process';
 import { callMcpEndpoint } from '../../api/mcp-client.js';
 import { DEFAULT_MODEL } from '../../constants.js';
 import { logError, logInfo, logSuccess, logWarning, } from '../../utils/logger.js';
 import { cloneIssueRepo, ensureWorkspaceDir, syncRepoToRef, } from '../../workspace/workspace-manager.js';
+import { detectDefaultBranch } from '../find-shared/git.js';
+import { createIssue, fetchOpenIssues, fetchProductBasics, } from '../find-shared/mcp.js';
 import { createPromptGenerator, extractTextFromContent, tryExtractResult, } from '../pr-shared/agent-utils.js';
 import { createFindFeaturesSystemPrompt, createFindFeaturesUserPrompt, } from './prompts.js';
 import { acquireFindFeaturesLock, updateFindFeaturesState } from './state.js';
@@ -61,7 +62,6 @@ export async function scanForFeatures(options) {
         const branch = options.branch ?? detectDefaultBranch(repoPath);
         logInfo(`Syncing ${owner}/${repo} to branch ${branch}`);
         syncRepoToRef(repoPath, { branch }, githubToken);
-        const headSha = gitRevParse(repoPath, 'HEAD');
         const sinceIso = resolveSinceIso(since);
         const product = await fetchProductBasics(productId);
         const [feedbacks, intelligenceReports, existingIssues] = await Promise.all([
@@ -70,21 +70,11 @@ export async function scanForFeatures(options) {
             fetchOpenIssues(productId),
         ]);
         logInfo(`Loaded ${feedbacks.length} feedbacks (since ${since}), ${intelligenceReports.length} reports, ${existingIssues.length} open issues`);
-        if (feedbacks.length === 0 && intelligenceReports.length === 0) {
-            logWarning('No feedback or intelligence reports in scope — nothing to synthesise.');
-            updateFindFeaturesState(productId, {
-                lastRunAt: new Date().toISOString(),
-                lastScannedCommitSha: headSha,
-                lastError: undefined,
-            });
-            return {
-                status: 'success',
-                message: 'No feedback or intelligence reports available',
-                opportunitiesFound: 0,
-                issuesCreated: 0,
-            };
+        const codeOnlyMode = feedbacks.length === 0 && intelligenceReports.length === 0;
+        if (codeOnlyMode) {
+            logInfo('No feedback or intelligence reports in scope — running code-only analysis on the repo.');
         }
-        const systemPrompt = createFindFeaturesSystemPrompt();
+        const systemPrompt = createFindFeaturesSystemPrompt({ codeOnlyMode });
         const userPrompt = createFindFeaturesUserPrompt({
             productName: product.name,
             productDescription: product.description,
@@ -99,6 +89,7 @@ export async function scanForFeatures(options) {
             maxSuggestions,
             sinceWindow: since,
             focusReportId,
+            codeOnlyMode,
         });
         let lastAssistantResponse = '';
         let discoveryResult = null;
@@ -150,11 +141,12 @@ export async function scanForFeatures(options) {
                 logSuccess(`Filed issue ${issueId}: ${opp.title}`);
             }
         }
+        // The previous schema captured `lastSeenFeedbackId / lastSeenReportId /
+        // lastScannedCommitSha` here, but the reader side never used them — kept
+        // it lean and only persist the run-status fields the worker actually
+        // reads on retry. See find-features/state.ts for the schema rationale.
         updateFindFeaturesState(productId, {
             lastRunAt: new Date().toISOString(),
-            lastSeenFeedbackId: feedbacks[0]?.id,
-            lastSeenReportId: intelligenceReports[0]?.id,
-            lastScannedCommitSha: headSha,
             lastError: undefined,
         });
         return {
@@ -178,21 +170,6 @@ export async function scanForFeatures(options) {
         lock.release();
     }
 }
-function gitRevParse(repoPath, ref) {
-    return execFileSync('git', ['rev-parse', ref], {
-        cwd: repoPath,
-        encoding: 'utf-8',
-    }).trim();
-}
-function detectDefaultBranch(repoPath) {
-    try {
-        const ref = execFileSync('git', ['symbolic-ref', '--short', 'refs/remotes/origin/HEAD'], { cwd: repoPath, encoding: 'utf-8' }).trim();
-        return ref.replace(/^origin\//, '');
-    }
-    catch {
-        return 'main';
-    }
-}
 /**
  * Convert a user-friendly "since" value (e.g. "30d", "12h", ISO timestamp) to
  * an ISO string usable as a lower bound. Falls back to 90 days ago on parse
@@ -275,56 +252,12 @@ async function fetchIntelligenceReports(productId, focusReportId) {
         return [];
     }
 }
-async function fetchProductBasics(productId) {
-    try {
-        const result = (await callMcpEndpoint('resources/read', {
-            uri: `product://${productId}`,
-        }));
-        const text = result.contents?.[0]?.text || '{}';
-        const parsed = JSON.parse(text);
-        return {
-            name: parsed.name || productId,
-            description: parsed.description,
-        };
-    }
-    catch {
-        return { name: productId };
-    }
-}
-async function fetchOpenIssues(productId) {
-    try {
-        const result = (await callMcpEndpoint('issues/list', {
-            product_id: productId,
-        }));
-        const all = result.issues || [];
-        return all.filter((i) => !isTerminalStatus(i.status));
-    }
-    catch (error) {
-        logWarning(`Could not load existing issues for dedup: ${error instanceof Error ? error.message : String(error)}`);
-        return [];
-    }
-}
-function isTerminalStatus(status) {
-    return (status === 'shipped' ||
-        status === 'archived' ||
-        status === 'cancelled' ||
-        status === 'closed' ||
-        status === 'completed');
-}
 async function createIssueForOpportunity(productId, opp) {
-    const description = formatIssueDescription(opp);
-    try {
-        const result = (await callMcpEndpoint('issues/create', {
-            product_id: productId,
-            name: opp.title,
-            description,
-        }));
-        return result.issue?.id || result.id || null;
-    }
-    catch (error) {
-        logError(`Failed to create issue for "${opp.title}": ${error instanceof Error ? error.message : String(error)}`);
-        return null;
-    }
+    return createIssue({
+        productId,
+        title: opp.title,
+        description: formatIssueDescription(opp),
+    });
 }
 function formatIssueDescription(opp) {
     const evidenceLine = opp.supporting_evidence_ids.length > 0

package/dist/phases/find-features/prompts.d.ts

@@ -6,7 +6,11 @@
  * "opportunities" that are really just discoverability issues on existing
  * functionality.
  */
-export declare function createFindFeaturesSystemPrompt(): string;
+export interface FindFeaturesSystemPromptParams {
+    /** True when no feedback/reports were available; agent must derive opportunities purely from code. */
+    codeOnlyMode?: boolean;
+}
+export declare function createFindFeaturesSystemPrompt(params?: FindFeaturesSystemPromptParams): string;
 export interface FindFeaturesUserPromptParams {
     productName: string;
     productDescription?: string;
@@ -33,5 +37,7 @@ export interface FindFeaturesUserPromptParams {
     sinceWindow: string;
     /** Optional narrowing to a specific intelligence report's context. */
     focusReportId?: string;
+    /** True when the run has no feedback/reports and must analyse the codebase only. */
+    codeOnlyMode?: boolean;
 }
 export declare function createFindFeaturesUserPrompt(params: FindFeaturesUserPromptParams): string;