@promptwheel/cli 0.6.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export {};
+/**
+ * @promptwheel/cli
+ *
+ * PromptWheel command-line interface.
+ *
+ * This package is a CLI tool only - it has no public API exports.
+ * Use it via the command line:
+ *
+ *   npx @promptwheel/cli solo scout .
+ *
+ * Or installed globally:
+ *   npm install -g @promptwheel/cli
+ *   promptwheel solo scout .
+ *
+ * The CLI entry point is src/bin/promptwheel.ts
+ */
+//# 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":";AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export {};
+/**
+ * @promptwheel/cli
+ *
+ * PromptWheel command-line interface.
+ *
+ * This package is a CLI tool only - it has no public API exports.
+ * Use it via the command line:
+ *
+ *   npx @promptwheel/cli solo scout .
+ *
+ * Or installed globally:
+ *   npm install -g @promptwheel/cli
+ *   promptwheel solo scout .
+ *
+ * The CLI entry point is src/bin/promptwheel.ts
+ */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/artifacts.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Artifact persistence helpers
+ *
+ * Writes structured data as JSON files in .promptwheel/artifacts/
+ * Used for proposals, run outputs, and other debugging data.
+ *
+ * Artifact Types:
+ * - proposals: Scout proposals before approval
+ * - executions: Agent execution logs (stdout, stderr, prompt)
+ * - diffs: Git diff snapshots
+ * - runs: Complete run summaries with all steps
+ * - violations: Scope violation details
+ */
+/**
+ * Known artifact types - single source of truth
+ */
+export declare const ARTIFACT_TYPES: readonly ["proposals", "executions", "diffs", "runs", "violations", "spindle", "traces"];
+/**
+ * Known artifact types for type safety
+ */
+export type ArtifactType = (typeof ARTIFACT_TYPES)[number];
+/**
+ * Run summary artifact structure
+ */
+export interface RunSummaryArtifact {
+    runId: string;
+    ticketId: string;
+    ticketTitle: string;
+    projectId: string;
+    success: boolean;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    branchName?: string;
+    prUrl?: string;
+    error?: string;
+    steps: Array<{
+        name: string;
+        status: 'success' | 'failed' | 'skipped';
+        durationMs?: number;
+        errorMessage?: string;
+        artifactPath?: string;
+    }>;
+    artifacts: {
+        execution?: string;
+        diff?: string;
+        violations?: string;
+    };
+}
+/**
+ * Scope violations artifact structure
+ */
+export interface ViolationsArtifact {
+    runId: string;
+    ticketId: string;
+    changedFiles: string[];
+    allowedPaths: string[];
+    forbiddenPaths: string[];
+    violations: Array<{
+        file: string;
+        violation: 'not_in_allowed' | 'in_forbidden';
+        pattern?: string;
+    }>;
+}
+/**
+ * Options for writing an artifact
+ */
+interface WriteArtifactOptions {
+    /** Base directory (usually .promptwheel) */
+    baseDir: string;
+    /** Artifact type (creates subfolder) */
+    type: string;
+    /** Unique identifier (used in filename) */
+    id: string;
+    /** Data to serialize */
+    data: unknown;
+    /** Optional timestamp suffix (default: true) */
+    timestamp?: boolean;
+}
+/**
+ * Write a JSON artifact file
+ *
+ * Creates: {baseDir}/artifacts/{type}/{id}[-timestamp].json
+ *
+ * @returns The full path to the written file
+ */
+export declare function writeJsonArtifact(opts: WriteArtifactOptions): string;
+/**
+ * Read a JSON artifact file
+ *
+ * @returns Parsed data or null if file doesn't exist
+ */
+export declare function readJsonArtifact<T = unknown>(filePath: string): T | null;
+/**
+ * List artifacts of a given type
+ *
+ * @returns Array of { path, id, timestamp } sorted by timestamp desc
+ */
+export declare function listArtifacts(baseDir: string, type: string): Array<{
+    path: string;
+    id: string;
+    timestamp: number;
+}>;
+/**
+ * Get the most recent artifact of a given type
+ */
+export declare function getLatestArtifact<T = unknown>(baseDir: string, type: string): {
+    path: string;
+    data: T;
+} | null;
+/**
+ * Get all artifacts for a specific run ID
+ *
+ * Searches across all artifact types for files matching the run ID.
+ */
+export declare function getArtifactsForRun(baseDir: string, runId: string): Record<ArtifactType, {
+    path: string;
+    data: unknown;
+} | null>;
+/**
+ * Get artifact by run ID and type
+ */
+export declare function getArtifactByRunId<T = unknown>(baseDir: string, runId: string, type: ArtifactType): {
+    path: string;
+    data: T;
+} | null;
+/**
+ * Get all artifacts in the base directory, grouped by type
+ */
+export declare function getAllArtifacts(baseDir: string): Record<ArtifactType, Array<{
+    path: string;
+    id: string;
+    timestamp: number;
+}>>;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

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

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

package/dist/lib/artifacts.js

@@ -0,0 +1,147 @@
+/**
+ * Artifact persistence helpers
+ *
+ * Writes structured data as JSON files in .promptwheel/artifacts/
+ * Used for proposals, run outputs, and other debugging data.
+ *
+ * Artifact Types:
+ * - proposals: Scout proposals before approval
+ * - executions: Agent execution logs (stdout, stderr, prompt)
+ * - diffs: Git diff snapshots
+ * - runs: Complete run summaries with all steps
+ * - violations: Scope violation details
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Known artifact types - single source of truth
+ */
+export const ARTIFACT_TYPES = [
+    'proposals',
+    'executions',
+    'diffs',
+    'runs',
+    'violations',
+    'spindle',
+    'traces',
+];
+/**
+ * Write a JSON artifact file
+ *
+ * Creates: {baseDir}/artifacts/{type}/{id}[-timestamp].json
+ *
+ * @returns The full path to the written file
+ */
+export function writeJsonArtifact(opts) {
+    const { baseDir, type, id, data, timestamp = true } = opts;
+    const artifactsDir = path.join(baseDir, 'artifacts', type);
+    // Ensure directory exists
+    if (!fs.existsSync(artifactsDir)) {
+        fs.mkdirSync(artifactsDir, { recursive: true });
+    }
+    // Build filename
+    const ts = timestamp ? `-${Date.now()}` : '';
+    const filename = `${id}${ts}.json`;
+    const filePath = path.join(artifactsDir, filename);
+    // Write atomically (write to temp, then rename)
+    const tempPath = `${filePath}.tmp`;
+    fs.writeFileSync(tempPath, JSON.stringify(data, null, 2));
+    fs.renameSync(tempPath, filePath);
+    return filePath;
+}
+/**
+ * Read a JSON artifact file
+ *
+ * @returns Parsed data or null if file doesn't exist
+ */
+export function readJsonArtifact(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * List artifacts of a given type
+ *
+ * @returns Array of { path, id, timestamp } sorted by timestamp desc
+ */
+export function listArtifacts(baseDir, type) {
+    const artifactsDir = path.join(baseDir, 'artifacts', type);
+    if (!fs.existsSync(artifactsDir)) {
+        return [];
+    }
+    const files = fs.readdirSync(artifactsDir)
+        .filter(f => f.endsWith('.json'))
+        .map(f => {
+        // eslint-disable-next-line security/detect-unsafe-regex
+        const match = f.match(/^(.+?)(?:-(\d+))?\.json$/);
+        if (!match)
+            return null;
+        const filePath = path.join(artifactsDir, f);
+        const stat = fs.statSync(filePath);
+        return {
+            path: filePath,
+            id: match[1],
+            timestamp: match[2] ? parseInt(match[2], 10) : stat.mtimeMs,
+        };
+    })
+        .filter((x) => x !== null);
+    // Sort by timestamp descending (most recent first)
+    return files.sort((a, b) => b.timestamp - a.timestamp);
+}
+/**
+ * Get the most recent artifact of a given type
+ */
+export function getLatestArtifact(baseDir, type) {
+    const artifacts = listArtifacts(baseDir, type);
+    if (artifacts.length === 0)
+        return null;
+    const latest = artifacts[0];
+    const data = readJsonArtifact(latest.path);
+    if (data === null)
+        return null;
+    return { path: latest.path, data };
+}
+/**
+ * Get all artifacts for a specific run ID
+ *
+ * Searches across all artifact types for files matching the run ID.
+ */
+export function getArtifactsForRun(baseDir, runId) {
+    const result = {};
+    for (const type of ARTIFACT_TYPES) {
+        const artifacts = listArtifacts(baseDir, type);
+        const match = artifacts.find(a => a.id === runId || a.id.startsWith(runId));
+        if (match) {
+            const data = readJsonArtifact(match.path);
+            result[type] = data ? { path: match.path, data } : null;
+        }
+        else {
+            result[type] = null;
+        }
+    }
+    return result;
+}
+/**
+ * Get artifact by run ID and type
+ */
+export function getArtifactByRunId(baseDir, runId, type) {
+    const artifacts = listArtifacts(baseDir, type);
+    const match = artifacts.find(a => a.id === runId || a.id.startsWith(runId));
+    if (!match)
+        return null;
+    const data = readJsonArtifact(match.path);
+    return data ? { path: match.path, data } : null;
+}
+/**
+ * Get all artifacts in the base directory, grouped by type
+ */
+export function getAllArtifacts(baseDir) {
+    const result = {};
+    for (const type of ARTIFACT_TYPES) {
+        result[type] = listArtifacts(baseDir, type);
+    }
+    return result;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/lib/artifacts.js.map

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

package/dist/lib/codebase-index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-exports from @promptwheel/core — single source of truth for codebase indexing.
+ */
+export { buildCodebaseIndex, refreshCodebaseIndex, hasStructuralChanges, formatIndexForPrompt, getTrackedDirectories, SOURCE_EXTENSIONS, type CodebaseIndex, type ModuleEntry, type LargeFileEntry, type ClassificationConfidence, } from '@promptwheel/core/codebase-index';
+//# sourceMappingURL=codebase-index.d.ts.map

package/dist/lib/codebase-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-index.d.ts","sourceRoot":"","sources":["../../src/lib/codebase-index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC"}

package/dist/lib/codebase-index.js

@@ -0,0 +1,5 @@
+/**
+ * Re-exports from @promptwheel/core — single source of truth for codebase indexing.
+ */
+export { buildCodebaseIndex, refreshCodebaseIndex, hasStructuralChanges, formatIndexForPrompt, getTrackedDirectories, SOURCE_EXTENSIONS, } from '@promptwheel/core/codebase-index';
+//# sourceMappingURL=codebase-index.js.map

package/dist/lib/codebase-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-index.js","sourceRoot":"","sources":["../../src/lib/codebase-index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,kCAAkC,CAAC"}

package/dist/lib/cycle-context.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Cycle context for convergence-aware scout prompting.
+ *
+ * Tracks recent cycle outcomes so the scout can propose follow-up work
+ * instead of random scattershot. Also computes convergence metrics
+ * to guide session-level decisions.
+ */
+import type { SectorState } from './sectors.js';
+export interface CycleSummary {
+    cycle: number;
+    scope: string;
+    formula: string;
+    succeeded: Array<{
+        title: string;
+        category: string;
+    }>;
+    failed: Array<{
+        title: string;
+        reason: string;
+    }>;
+    noChanges: string[];
+}
+/**
+ * Build an XML block summarizing recent cycle outcomes for the scout prompt.
+ * Optionally includes recent diff summaries for follow-up awareness.
+ */
+export declare function buildCycleContextBlock(recentCycles: CycleSummary[], recentDiffs?: Array<{
+    title: string;
+    summary: string;
+    files: string[];
+    cycle: number;
+}>): string;
+/**
+ * Ring buffer push — keeps at most `max` entries.
+ */
+export declare function pushCycleSummary(buf: CycleSummary[], summary: CycleSummary, max?: number): CycleSummary[];
+export interface ConvergenceMetrics {
+    polishedSectorPct: number;
+    avgProposalYield: number;
+    learningsDensity: number;
+    successRateTrend: 'improving' | 'stable' | 'declining';
+    suggestedAction: 'continue' | 'widen_scope' | 'deepen' | 'stop';
+    mergeRate: number;
+    velocity: {
+        prsPerHour: number;
+        mergeRatePercent: number;
+    };
+}
+/**
+ * Compute convergence metrics from sectors, learnings count, and recent cycles.
+ */
+export declare function computeConvergenceMetrics(sectorState: SectorState, learningsCount: number, recentCycles: CycleSummary[], sessionContext?: {
+    elapsedMs: number;
+    prsCreated: number;
+    prsMerged: number;
+    prsClosed: number;
+}): ConvergenceMetrics;
+/**
+ * Format a one-liner convergence summary for console output.
+ */
+export declare function formatConvergenceOneLiner(m: ConvergenceMetrics): string;
+//# sourceMappingURL=cycle-context.d.ts.map

package/dist/lib/cycle-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-context.d.ts","sourceRoot":"","sources":["../../src/lib/cycle-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAAE,EAC5B,WAAW,CAAC,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACtF,MAAM,CA4CR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EAAE,EACnB,OAAO,EAAE,YAAY,EACrB,GAAG,GAAE,MAAU,GACd,YAAY,EAAE,CAMhB;AAMD,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvD,eAAe,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,YAAY,EAAE,EAC5B,cAAc,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/F,kBAAkB,CA+DpB;AAQD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAKvE"}

package/dist/lib/cycle-context.js

@@ -0,0 +1,141 @@
+/**
+ * Cycle context for convergence-aware scout prompting.
+ *
+ * Tracks recent cycle outcomes so the scout can propose follow-up work
+ * instead of random scattershot. Also computes convergence metrics
+ * to guide session-level decisions.
+ */
+/**
+ * Build an XML block summarizing recent cycle outcomes for the scout prompt.
+ * Optionally includes recent diff summaries for follow-up awareness.
+ */
+export function buildCycleContextBlock(recentCycles, recentDiffs) {
+    if ((!recentCycles || recentCycles.length === 0) && (!recentDiffs || recentDiffs.length === 0))
+        return '';
+    const lines = ['<recent-cycles>', '## Recent Cycle Outcomes', ''];
+    for (const c of (recentCycles ?? [])) {
+        lines.push(`### Cycle ${c.cycle} — scope: ${c.scope}, formula: ${c.formula}`);
+        if (c.succeeded.length > 0) {
+            lines.push('Succeeded:');
+            for (const s of c.succeeded) {
+                lines.push(`- [${s.category}] ${s.title}`);
+            }
+        }
+        if (c.failed.length > 0) {
+            lines.push('Failed:');
+            for (const f of c.failed) {
+                lines.push(`- ${f.title} (${f.reason})`);
+            }
+        }
+        if (c.noChanges.length > 0) {
+            lines.push('No changes produced:');
+            for (const nc of c.noChanges) {
+                lines.push(`- ${nc}`);
+            }
+        }
+        lines.push('');
+    }
+    // Append recent diffs for follow-up awareness
+    if (recentDiffs && recentDiffs.length > 0) {
+        lines.push('<recent-diffs>');
+        for (const d of recentDiffs.slice(-5)) {
+            lines.push(`Title: "${d.title}", Files: [${d.files.join(', ')}], Changes: ${d.summary}`);
+        }
+        lines.push('Consider proposing follow-up work based on these recent changes.');
+        lines.push('</recent-diffs>');
+        lines.push('');
+    }
+    lines.push('Use these outcomes to propose FOLLOW-UP work.');
+    lines.push('Fix what failed. Build on what succeeded. Avoid repeating no-change proposals.');
+    lines.push('</recent-cycles>');
+    return lines.join('\n');
+}
+/**
+ * Ring buffer push — keeps at most `max` entries.
+ */
+export function pushCycleSummary(buf, summary, max = 5) {
+    const result = [...buf, summary];
+    if (result.length > max) {
+        return result.slice(result.length - max);
+    }
+    return result;
+}
+/**
+ * Compute convergence metrics from sectors, learnings count, and recent cycles.
+ */
+export function computeConvergenceMetrics(sectorState, learningsCount, recentCycles, sessionContext) {
+    const prodSectors = sectorState.sectors.filter(s => s.production && s.fileCount > 0);
+    const polishedCount = prodSectors.filter(s => s.polishedAt > 0).length;
+    const polishedSectorPct = prodSectors.length > 0
+        ? Math.round((polishedCount / prodSectors.length) * 100)
+        : 0;
+    const scannedSectors = prodSectors.filter(s => s.scanCount > 0);
+    const avgProposalYield = scannedSectors.length > 0
+        ? scannedSectors.reduce((sum, s) => sum + s.proposalYield, 0) / scannedSectors.length
+        : 0;
+    const totalFiles = prodSectors.reduce((sum, s) => sum + s.fileCount, 0);
+    const learningsDensity = totalFiles > 0 ? learningsCount / totalFiles : 0;
+    // Compute success rate trend from last 3 cycles
+    let successRateTrend = 'stable';
+    if (recentCycles.length >= 3) {
+        const rates = recentCycles.slice(-3).map(c => {
+            const total = c.succeeded.length + c.failed.length + c.noChanges.length;
+            return total > 0 ? c.succeeded.length / total : 0;
+        });
+        const first = rates[0];
+        const last = rates[rates.length - 1];
+        if (last - first > 0.1)
+            successRateTrend = 'improving';
+        else if (first - last > 0.1)
+            successRateTrend = 'declining';
+    }
+    // Determine suggested action
+    let suggestedAction = 'continue';
+    if (polishedSectorPct > 80 && avgProposalYield < 0.5) {
+        suggestedAction = 'stop';
+    }
+    else if (polishedSectorPct > 60 && successRateTrend === 'declining') {
+        suggestedAction = 'widen_scope';
+    }
+    else if (avgProposalYield > 1.5 && successRateTrend === 'improving') {
+        suggestedAction = 'deepen';
+    }
+    // Merge rate from sector-level data
+    let totalMerged = 0;
+    let totalClosed = 0;
+    for (const s of prodSectors) {
+        totalMerged += s.mergeCount ?? 0;
+        totalClosed += s.closedCount ?? 0;
+    }
+    const mergeRate = (totalMerged + totalClosed) > 0
+        ? totalMerged / (totalMerged + totalClosed)
+        : NaN;
+    // Velocity from session context
+    const elapsedHours = sessionContext ? sessionContext.elapsedMs / 3_600_000 : 0;
+    const prsPerHour = elapsedHours > 0 ? (sessionContext?.prsCreated ?? 0) / elapsedHours : 0;
+    const mergedTotal = sessionContext?.prsMerged ?? 0;
+    const closedTotal = sessionContext?.prsClosed ?? 0;
+    const mergeRatePercent = (mergedTotal + closedTotal) > 0
+        ? Math.round((mergedTotal / (mergedTotal + closedTotal)) * 100)
+        : 0;
+    return {
+        polishedSectorPct, avgProposalYield, learningsDensity, successRateTrend, suggestedAction,
+        mergeRate,
+        velocity: { prsPerHour, mergeRatePercent },
+    };
+}
+const TREND_ARROWS = {
+    improving: '\u2191',
+    stable: '\u2192',
+    declining: '\u2193',
+};
+/**
+ * Format a one-liner convergence summary for console output.
+ */
+export function formatConvergenceOneLiner(m) {
+    const arrow = TREND_ARROWS[m.successRateTrend] ?? '→';
+    const velStr = m.velocity.prsPerHour > 0 ? `, ${m.velocity.prsPerHour.toFixed(1)} PRs/h` : '';
+    const mergeStr = !isNaN(m.mergeRate) ? `, merge ${Math.round(m.mergeRate * 100)}%` : '';
+    return `Convergence: ${m.polishedSectorPct}% polished, yield ${m.avgProposalYield.toFixed(1)}/scan, success ${arrow}${velStr}${mergeStr} — ${m.suggestedAction}`;
+}
+//# sourceMappingURL=cycle-context.js.map

package/dist/lib/cycle-context.js.map

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

package/dist/lib/daemon-fork.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Daemon forking and PID management.
+ *
+ * Handles spawning a detached child process, PID file management,
+ * and log rotation.
+ */
+export declare function readDaemonPid(repoRoot: string): number | null;
+export declare function writeDaemonPid(repoRoot: string, pid: number): void;
+export declare function removeDaemonPid(repoRoot: string): void;
+/**
+ * Check if a daemon process is alive via signal 0.
+ */
+export declare function isDaemonRunning(repoRoot: string): boolean;
+export interface ForkOptions {
+    interval?: number;
+    formula?: string;
+    scope?: string;
+}
+/**
+ * Fork a detached daemon child process.
+ * The child runs `promptwheel solo daemon __run` with the same env.
+ * Returns the child PID.
+ */
+export declare function forkDaemon(repoRoot: string, options: ForkOptions): number;
+/**
+ * Stop the daemon process gracefully.
+ * Sends SIGTERM, waits up to 10s, then SIGKILL as last resort.
+ */
+export declare function stopDaemon(repoRoot: string): Promise<boolean>;
+/**
+ * Rotate daemon.log when it exceeds maxSizeMB.
+ * Renames current log to daemon.log.1, starts fresh.
+ */
+export declare function rotateDaemonLog(repoRoot: string, maxSizeMB: number): void;
+/**
+ * Get the daemon log file path.
+ */
+export declare function getDaemonLogPath(repoRoot: string): string;
+//# sourceMappingURL=daemon-fork.d.ts.map

package/dist/lib/daemon-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-fork.d.ts","sourceRoot":"","sources":["../../src/lib/daemon-fork.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWzD;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA6BzE;AAID;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsCnE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAczE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD"}