@promptwheel/cli 0.6.0

package/dist/lib/daemon.js

@@ -0,0 +1,265 @@
+/**
+ * Daemon mode: types, config, pure functions, and main loop.
+ *
+ * The daemon wraps the existing auto mode — each wake cycle calls
+ * runAutoMode() with bounded cycles. Between cycles, the session lock
+ * is released so manual `promptwheel` runs can proceed.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { getPromptwheelDir } from './solo-config.js';
+import { acquireSessionLock, releaseSessionLock } from './retention.js';
+import { rotateDaemonLog, removeDaemonPid } from './daemon-fork.js';
+import { notifyAll } from './daemon-notifier.js';
+import { runAutoMode } from './solo-auto.js';
+export const DEFAULT_DAEMON_CONFIG = {
+    pollIntervalMinutes: 30,
+    cyclesPerWake: 3,
+    notifications: [],
+    maxLogSizeMB: 10,
+};
+const WAKE_METRICS_FILE = 'daemon-wake-metrics.json';
+export function writeDaemonWakeMetrics(repoRoot, metrics) {
+    const dir = getPromptwheelDir(repoRoot);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, WAKE_METRICS_FILE), JSON.stringify(metrics, null, 2));
+}
+export function readDaemonWakeMetrics(repoRoot) {
+    const filePath = path.join(getPromptwheelDir(repoRoot), WAKE_METRICS_FILE);
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        // Clean up after reading
+        fs.unlinkSync(filePath);
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Pure functions ───────────────────────────────────────────────────────────
+/**
+ * Compute adaptive polling interval based on recent activity.
+ *
+ * - Work done + new commits → base * 0.5
+ * - New commits but no proposals → base * 1.0
+ * - No new commits → base * 1.5
+ * - Quiet hours with boost → base * 0.25
+ * - Floor: 5 minutes. Ceiling: base * 3.
+ */
+export function computeAdaptiveInterval(state, config, context) {
+    const baseMs = config.pollIntervalMinutes * 60_000;
+    const floorMs = 5 * 60_000;
+    const ceilingMs = baseMs * 3;
+    let multiplier;
+    if (context.isQuietBoost) {
+        multiplier = 0.25;
+    }
+    else if (context.hadWork && context.hadNewCommits) {
+        multiplier = 0.5;
+    }
+    else if (context.hadNewCommits) {
+        multiplier = 1.0;
+    }
+    else {
+        // No new commits — lengthen based on consecutive idle cycles
+        multiplier = Math.min(1.5 + state.consecutiveNoWorkCycles * 0.25, 3.0);
+    }
+    return Math.max(floorMs, Math.min(Math.round(baseMs * multiplier), ceilingMs));
+}
+/**
+ * Check if current time falls within the quiet hours window.
+ * Handles midnight crossing (e.g. start=22:00, end=06:00).
+ */
+export function isInQuietHours(config, now) {
+    if (!config.quietHours)
+        return false;
+    const d = now ?? new Date();
+    const currentMinutes = d.getHours() * 60 + d.getMinutes();
+    const [startH, startM] = config.quietHours.start.split(':').map(Number);
+    const [endH, endM] = config.quietHours.end.split(':').map(Number);
+    const startMinutes = startH * 60 + startM;
+    const endMinutes = endH * 60 + endM;
+    if (startMinutes <= endMinutes) {
+        // Same-day window (e.g. 09:00 – 17:00)
+        return currentMinutes >= startMinutes && currentMinutes < endMinutes;
+    }
+    else {
+        // Midnight-crossing window (e.g. 22:00 – 06:00)
+        return currentMinutes >= startMinutes || currentMinutes < endMinutes;
+    }
+}
+// ── State persistence ────────────────────────────────────────────────────────
+const DAEMON_STATE_FILE = 'daemon-state.json';
+export function readDaemonState(repoRoot) {
+    const filePath = path.join(getPromptwheelDir(repoRoot), DAEMON_STATE_FILE);
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeDaemonState(repoRoot, state) {
+    const dir = getPromptwheelDir(repoRoot);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, DAEMON_STATE_FILE), JSON.stringify(state, null, 2));
+}
+export function createInitialDaemonState(config) {
+    return {
+        startedAt: Date.now(),
+        lastWakeAt: 0,
+        lastTrigger: 'timer',
+        totalWakes: 0,
+        totalCyclesCompleted: 0,
+        totalTicketsCompleted: 0,
+        totalTicketsFailed: 0,
+        currentInterval: config.pollIntervalMinutes * 60_000,
+        consecutiveNoWorkCycles: 0,
+    };
+}
+function checkTrigger(repoRoot, state) {
+    const now = Date.now();
+    const timerExpired = state.lastWakeAt === 0 || (now - state.lastWakeAt) >= state.currentInterval;
+    // Check for new commits since last wake
+    let hadNewCommits = false;
+    if (state.lastWakeAt > 0) {
+        try {
+            const since = new Date(state.lastWakeAt).toISOString();
+            const output = execSync(`git log --since="${since}" --oneline --max-count=1`, {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                timeout: 10_000,
+            }).trim();
+            hadNewCommits = output.length > 0;
+        }
+        catch {
+            // git log failed — proceed with timer only
+        }
+    }
+    return {
+        shouldWake: timerExpired || hadNewCommits,
+        trigger: hadNewCommits ? 'commits' : 'timer',
+        hadNewCommits,
+    };
+}
+// ── Sleep helper ─────────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+// ── Main daemon loop ─────────────────────────────────────────────────────────
+function log(msg) {
+    console.log(`[${new Date().toISOString()}] ${msg}`);
+}
+/**
+ * Main daemon entry point. Runs in the forked child process.
+ * Wakes periodically, runs bounded auto sessions, and sleeps.
+ */
+export async function startDaemon(repoRoot, config) {
+    const state = readDaemonState(repoRoot) ?? createInitialDaemonState(config);
+    state.startedAt = Date.now();
+    writeDaemonState(repoRoot, state);
+    let shutdown = false;
+    process.on('SIGTERM', () => { shutdown = true; });
+    process.on('SIGINT', () => { shutdown = true; });
+    log(`Daemon started (pid=${process.pid}, interval=${config.pollIntervalMinutes}m)`);
+    while (!shutdown) {
+        rotateDaemonLog(repoRoot, config.maxLogSizeMB);
+        const trigger = checkTrigger(repoRoot, state);
+        const quiet = isInQuietHours(config);
+        const isBoost = quiet && config.quietHours?.policy === 'boost';
+        if (!trigger.shouldWake || (quiet && !isBoost)) {
+            // Not time to wake yet, or in quiet hours with pause policy
+            await sleep(Math.min(state.currentInterval, 60_000));
+            if (shutdown)
+                break;
+            continue;
+        }
+        // Try to acquire session lock
+        const lockResult = acquireSessionLock(repoRoot);
+        if (!lockResult.acquired) {
+            log('Session lock held by another process, skipping this cycle');
+            await sleep(60_000);
+            continue;
+        }
+        const wakeStart = Date.now();
+        state.lastWakeAt = wakeStart;
+        state.lastTrigger = trigger.trigger;
+        state.totalWakes++;
+        let hadWork = false;
+        log(`Wake #${state.totalWakes} (trigger=${trigger.trigger})`);
+        try {
+            const exitCode = await runAutoMode({
+                wheel: true,
+                cycles: String(config.cyclesPerWake),
+                formula: config.formula,
+                scope: config.scope,
+                daemon: true,
+                yes: true,
+                tui: false,
+            });
+            hadWork = exitCode === 0;
+            if (hadWork) {
+                state.consecutiveNoWorkCycles = 0;
+            }
+            else {
+                state.consecutiveNoWorkCycles++;
+            }
+        }
+        catch (err) {
+            log(`Wake cycle error: ${err instanceof Error ? err.message : err}`);
+            state.consecutiveNoWorkCycles++;
+        }
+        // Release session lock so manual runs can proceed
+        releaseSessionLock(repoRoot);
+        // Read metrics persisted by finalizeSession
+        const wakeMetrics = readDaemonWakeMetrics(repoRoot);
+        if (wakeMetrics) {
+            state.totalCyclesCompleted += wakeMetrics.cyclesCompleted;
+            state.totalTicketsCompleted += wakeMetrics.ticketsCompleted;
+            state.totalTicketsFailed += wakeMetrics.ticketsFailed;
+        }
+        // Notifications
+        if (config.notifications.length > 0) {
+            const summary = {
+                repoName: path.basename(repoRoot),
+                startTime: wakeStart,
+                endTime: Date.now(),
+                cyclesCompleted: wakeMetrics?.cyclesCompleted ?? 0,
+                ticketsCompleted: wakeMetrics?.ticketsCompleted ?? 0,
+                ticketsFailed: wakeMetrics?.ticketsFailed ?? 0,
+                prUrls: wakeMetrics?.prUrls ?? [],
+                trigger: trigger.trigger,
+                reportPath: wakeMetrics?.reportPath,
+            };
+            await notifyAll(config.notifications, summary, log);
+        }
+        // Adaptive interval
+        state.currentInterval = computeAdaptiveInterval(state, config, {
+            hadWork,
+            hadNewCommits: trigger.hadNewCommits,
+            isQuietBoost: isBoost,
+        });
+        writeDaemonState(repoRoot, state);
+        log(`Next wake in ${Math.round(state.currentInterval / 60_000)}m`);
+        // Sleep until next wake
+        const sleepTarget = state.currentInterval;
+        const sleepChunk = 10_000; // Check shutdown every 10s
+        let slept = 0;
+        while (!shutdown && slept < sleepTarget) {
+            await sleep(Math.min(sleepChunk, sleepTarget - slept));
+            slept += sleepChunk;
+        }
+    }
+    // Cleanup
+    log('Daemon shutting down');
+    removeDaemonPid(repoRoot);
+    writeDaemonState(repoRoot, state);
+}
+//# sourceMappingURL=daemon.js.map

package/dist/lib/daemon.js.map

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

package/dist/lib/dedup-memory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Cross-run dedup memory with temporal decay.
+ *
+ * Persists completed/rejected proposal titles to `.promptwheel/dedup-memory.json`
+ * so the scout prompt knows what NOT to propose.
+ *
+ * Pure algorithms (decay, entry management) live in @promptwheel/core/dedup/shared.
+ * This file wraps them with filesystem I/O and adds CLI-specific extensions
+ * (failureReason, relatedTitles, metrics).
+ */
+import { type DedupEntry as CoreDedupEntry } from '@promptwheel/core/dedup/shared';
+export interface DedupEntry extends CoreDedupEntry {
+    /** Why this entry failed (if not completed) */
+    failureReason?: 'qa_failed' | 'scope_violation' | 'spindle_abort' | 'agent_error' | 'no_changes';
+    /** Titles of proposals that were in the same batch (dependency tracking) */
+    relatedTitles?: string[];
+}
+/**
+ * Load dedup memory, apply decay, prune dead entries, write back.
+ * Call once per session start (mirrors learnings.loadLearnings).
+ */
+export declare function loadDedupMemory(projectRoot: string): DedupEntry[];
+/**
+ * Record a title as "seen" — either a new duplicate rejection or a completed ticket.
+ * If the title already exists, bumps weight and hit_count (re-confirmation).
+ */
+export declare function recordDedupEntry(projectRoot: string, title: string, completed: boolean, failureReason?: 'qa_failed' | 'scope_violation' | 'spindle_abort' | 'agent_error' | 'no_changes', relatedTitles?: string[]): void;
+/**
+ * Batch-record multiple titles at once (avoids repeated file I/O).
+ */
+export declare function recordDedupEntries(projectRoot: string, titles: {
+    title: string;
+    completed: boolean;
+}[]): void;
+/**
+ * Format dedup memory for prompt injection.
+ * Highest-weight entries first, respects char budget.
+ */
+export declare function formatDedupForPrompt(entries: DedupEntry[], budget?: number): string;
+/**
+ * Find proposals enabled by recently completed work.
+ * Returns related titles from completed entries within 48h
+ * that are NOT themselves completed.
+ */
+export declare function getEnabledProposals(projectRoot: string): string[];
+//# sourceMappingURL=dedup-memory.d.ts.map

package/dist/lib/dedup-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-memory.d.ts","sourceRoot":"","sources":["../../src/lib/dedup-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EACL,KAAK,UAAU,IAAI,cAAc,EAGlC,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,+CAA+C;IAC/C,aAAa,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;IACjG,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AA8CD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE,CAajE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,aAAa,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,EAChG,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,IAAI,CA8BN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,GAC9C,IAAI,CA0BN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,GAAE,MAAuB,GAAG,MAAM,CAwBnG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBjE"}

package/dist/lib/dedup-memory.js

@@ -0,0 +1,190 @@
+/**
+ * Cross-run dedup memory with temporal decay.
+ *
+ * Persists completed/rejected proposal titles to `.promptwheel/dedup-memory.json`
+ * so the scout prompt knows what NOT to propose.
+ *
+ * Pure algorithms (decay, entry management) live in @promptwheel/core/dedup/shared.
+ * This file wraps them with filesystem I/O and adds CLI-specific extensions
+ * (failureReason, relatedTitles, metrics).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { metric } from './metrics.js';
+import { applyDecay, DEDUP_DEFAULTS, } from '@promptwheel/core/dedup/shared';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEDUP_FILE = 'dedup-memory.json';
+const MAX_WEIGHT = DEDUP_DEFAULTS.MAX_WEIGHT;
+const BUMP_AMOUNT = DEDUP_DEFAULTS.BUMP_AMOUNT;
+const COMPLETED_WEIGHT = DEDUP_DEFAULTS.COMPLETED_WEIGHT;
+const DEFAULT_WEIGHT = DEDUP_DEFAULTS.DEFAULT_WEIGHT;
+const DEFAULT_BUDGET = DEDUP_DEFAULTS.DEFAULT_BUDGET;
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+function dedupPath(projectRoot) {
+    return path.join(projectRoot, '.promptwheel', DEDUP_FILE);
+}
+function readEntries(projectRoot) {
+    const fp = dedupPath(projectRoot);
+    if (!fs.existsSync(fp))
+        return [];
+    try {
+        const raw = fs.readFileSync(fp, 'utf8');
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeEntries(projectRoot, entries) {
+    const fp = dedupPath(projectRoot);
+    const dir = path.dirname(fp);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(fp, JSON.stringify(entries, null, 2) + '\n', 'utf8');
+}
+// ---------------------------------------------------------------------------
+// Core API
+// ---------------------------------------------------------------------------
+/**
+ * Load dedup memory, apply decay, prune dead entries, write back.
+ * Call once per session start (mirrors learnings.loadLearnings).
+ */
+export function loadDedupMemory(projectRoot) {
+    const entries = readEntries(projectRoot);
+    const surviving = applyDecay(entries, DEDUP_DEFAULTS.DECAY_RATE);
+    writeEntries(projectRoot, surviving);
+    // Instrument: track dedup memory load
+    metric('dedup', 'loaded', {
+        count: surviving.length,
+        decayed: entries.length - surviving.length,
+        completed: surviving.filter(e => e.completed).length,
+    });
+    return surviving;
+}
+/**
+ * Record a title as "seen" — either a new duplicate rejection or a completed ticket.
+ * If the title already exists, bumps weight and hit_count (re-confirmation).
+ */
+export function recordDedupEntry(projectRoot, title, completed, failureReason, relatedTitles) {
+    const entries = readEntries(projectRoot);
+    const now = new Date().toISOString();
+    const normalized = title.toLowerCase().trim();
+    const existing = entries.find(e => e.title.toLowerCase().trim() === normalized);
+    if (existing) {
+        existing.weight = Math.min(MAX_WEIGHT, existing.weight + BUMP_AMOUNT);
+        existing.last_seen_at = now;
+        existing.hit_count++;
+        if (completed)
+            existing.completed = true;
+        if (failureReason)
+            existing.failureReason = failureReason;
+        if (relatedTitles?.length)
+            existing.relatedTitles = relatedTitles;
+        // Instrument: duplicate detected
+        metric('dedup', 'duplicate_found', { hitCount: existing.hit_count, completed });
+    }
+    else {
+        entries.push({
+            title,
+            weight: completed ? COMPLETED_WEIGHT : DEFAULT_WEIGHT,
+            created_at: now,
+            last_seen_at: now,
+            hit_count: 1,
+            completed,
+            failureReason,
+            relatedTitles,
+        });
+    }
+    writeEntries(projectRoot, entries);
+}
+/**
+ * Batch-record multiple titles at once (avoids repeated file I/O).
+ */
+export function recordDedupEntries(projectRoot, titles) {
+    if (titles.length === 0)
+        return;
+    const entries = readEntries(projectRoot);
+    const now = new Date().toISOString();
+    for (const { title, completed } of titles) {
+        const normalized = title.toLowerCase().trim();
+        const existing = entries.find(e => e.title.toLowerCase().trim() === normalized);
+        if (existing) {
+            existing.weight = Math.min(MAX_WEIGHT, existing.weight + BUMP_AMOUNT);
+            existing.last_seen_at = now;
+            existing.hit_count++;
+            if (completed)
+                existing.completed = true;
+        }
+        else {
+            entries.push({
+                title,
+                weight: completed ? COMPLETED_WEIGHT : DEFAULT_WEIGHT,
+                created_at: now,
+                last_seen_at: now,
+                hit_count: 1,
+                completed,
+            });
+        }
+    }
+    writeEntries(projectRoot, entries);
+}
+/**
+ * Format dedup memory for prompt injection.
+ * Highest-weight entries first, respects char budget.
+ */
+export function formatDedupForPrompt(entries, budget = DEFAULT_BUDGET) {
+    if (entries.length === 0)
+        return '';
+    const sorted = [...entries].sort((a, b) => b.weight - a.weight);
+    const lines = [];
+    let charCount = 0;
+    const header = '<already-completed>\n## Already Completed — Do NOT Propose These\n\nThe following improvements have already been done or attempted. Do NOT propose similar changes:\n';
+    const footer = '\n</already-completed>';
+    charCount += header.length + footer.length;
+    for (const e of sorted) {
+        const status = e.completed ? '✓ done'
+            : e.failureReason === 'scope_violation' ? 'scope issue — may work with broader scope'
+                : e.failureReason === 'no_changes' ? 'no changes produced'
+                    : 'attempted — failed';
+        const line = `- ${e.title} (${status}, seen ${e.hit_count}x)`;
+        if (charCount + line.length + 1 > budget)
+            break;
+        lines.push(line);
+        charCount += line.length + 1;
+    }
+    if (lines.length === 0)
+        return '';
+    return header + lines.join('\n') + footer;
+}
+/**
+ * Find proposals enabled by recently completed work.
+ * Returns related titles from completed entries within 48h
+ * that are NOT themselves completed.
+ */
+export function getEnabledProposals(projectRoot) {
+    const entries = readEntries(projectRoot);
+    const now = Date.now();
+    const cutoff = 48 * 60 * 60 * 1000;
+    const completedTitles = new Set(entries.filter(e => e.completed).map(e => e.title.toLowerCase().trim()));
+    const enabled = [];
+    for (const e of entries) {
+        if (!e.completed || !e.relatedTitles?.length)
+            continue;
+        const lastSeen = new Date(e.last_seen_at).getTime();
+        if (now - lastSeen > cutoff)
+            continue;
+        for (const rt of e.relatedTitles) {
+            if (!completedTitles.has(rt.toLowerCase().trim())) {
+                enabled.push(rt);
+            }
+        }
+    }
+    return [...new Set(enabled)];
+}
+//# sourceMappingURL=dedup-memory.js.map

package/dist/lib/dedup-memory.js.map

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

package/dist/lib/dedup.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Deduplication utilities for proposal filtering.
+ *
+ * Pure algorithms (normalizeTitle, titleSimilarity, isDuplicate) live in
+ * @promptwheel/core/dedup/shared. This file re-exports them and adds
+ * I/O-dependent helpers (database lookups, git branch listing).
+ */
+import type { DatabaseAdapter } from '@promptwheel/core/db';
+import type { TicketProposal } from '@promptwheel/core/scout';
+export { normalizeTitle, titleSimilarity } from '@promptwheel/core/dedup/shared';
+/**
+ * Sleep helper
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Check if a proposal is a duplicate of existing tickets or open PRs
+ */
+export declare function isDuplicateProposal(proposal: {
+    title: string;
+    files?: string[];
+}, existingTitles: string[], openPrBranches: string[], similarityThreshold?: number): Promise<{
+    isDuplicate: boolean;
+    reason?: string;
+}>;
+/**
+ * Get existing ticket titles and open PR branches for deduplication
+ */
+export declare function getDeduplicationContext(adapter: DatabaseAdapter, projectId: string, repoRoot: string): Promise<{
+    existingTitles: string[];
+    openPrBranches: string[];
+}>;
+/**
+ * Determine adaptive parallel count based on ticket complexity.
+ * When --parallel is NOT explicitly set, scale based on proposal mix.
+ */
+export declare function getAdaptiveParallelCount(proposals: TicketProposal[]): number;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/lib/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/lib/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjF;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC7C,cAAc,EAAE,MAAM,EAAE,EACxB,cAAc,EAAE,MAAM,EAAE,EACxB,mBAAmB,SAAM,GACxB,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBpD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyBjE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAO5E"}

package/dist/lib/dedup.js

@@ -0,0 +1,85 @@
+/**
+ * Deduplication utilities for proposal filtering.
+ *
+ * Pure algorithms (normalizeTitle, titleSimilarity, isDuplicate) live in
+ * @promptwheel/core/dedup/shared. This file re-exports them and adds
+ * I/O-dependent helpers (database lookups, git branch listing).
+ */
+import { tickets } from '@promptwheel/core/repos';
+import { gitExecFile } from './solo-git.js';
+// Re-export pure algorithms from core
+export { normalizeTitle, titleSimilarity } from '@promptwheel/core/dedup/shared';
+import { normalizeTitle, titleSimilarity } from '@promptwheel/core/dedup/shared';
+/**
+ * Sleep helper
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Check if a proposal is a duplicate of existing tickets or open PRs
+ */
+export async function isDuplicateProposal(proposal, existingTitles, openPrBranches, similarityThreshold = 0.6) {
+    const normalizedProposal = normalizeTitle(proposal.title);
+    for (const existing of existingTitles) {
+        if (normalizeTitle(existing) === normalizedProposal) {
+            return { isDuplicate: true, reason: `Exact match: "${existing}"` };
+        }
+    }
+    for (const existing of existingTitles) {
+        const sim = titleSimilarity(proposal.title, existing);
+        if (sim >= similarityThreshold) {
+            return { isDuplicate: true, reason: `Similar (${Math.round(sim * 100)}%): "${existing}"` };
+        }
+    }
+    for (const branch of openPrBranches) {
+        // Extract slug from branch name (e.g., 'promptwheel/tkt_abc123/fix-login-bug' -> 'fix login bug')
+        const branchTitle = branch.replace(/^promptwheel\/tkt_[a-z0-9]+\//, '').replace(/-/g, ' ');
+        if (branchTitle && titleSimilarity(proposal.title, branchTitle) >= similarityThreshold) {
+            return { isDuplicate: true, reason: `Open PR branch: ${branch}` };
+        }
+    }
+    return { isDuplicate: false };
+}
+/**
+ * Get existing ticket titles and open PR branches for deduplication
+ */
+export async function getDeduplicationContext(adapter, projectId, repoRoot) {
+    const allTickets = await tickets.listByProject(adapter, projectId, {
+        limit: 200,
+    });
+    const existingTitles = allTickets
+        .filter(t => t.status !== 'ready')
+        .map(t => t.title);
+    let openPrBranches = [];
+    try {
+        const stdout = await gitExecFile('git', ['branch', '-r', '--list', 'origin/promptwheel/*'], {
+            cwd: repoRoot,
+        });
+        if (stdout) {
+            openPrBranches = stdout
+                .split('\n')
+                .map(b => b.trim().replace('origin/', ''))
+                .filter(Boolean);
+        }
+    }
+    catch {
+        // Ignore git errors
+    }
+    return { existingTitles, openPrBranches };
+}
+/**
+ * Determine adaptive parallel count based on ticket complexity.
+ * When --parallel is NOT explicitly set, scale based on proposal mix.
+ */
+export function getAdaptiveParallelCount(proposals) {
+    const heavy = proposals.filter(p => p.estimated_complexity === 'moderate' || p.estimated_complexity === 'complex').length;
+    const light = proposals.filter(p => p.estimated_complexity === 'trivial' || p.estimated_complexity === 'simple').length;
+    if (heavy === 0)
+        return 5; // all light → go wide
+    if (light === 0)
+        return 2; // all heavy → conservative
+    const ratio = light / (light + heavy);
+    return Math.max(2, Math.min(5, Math.round(2 + ratio * 3))); // 2-5
+}
+//# sourceMappingURL=dedup.js.map