@promptwheel/mcp 0.6.0

package/dist/event-helpers.js

@@ -0,0 +1,125 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { repos } from '@promptwheel/core';
+import { recordDedupEntry } from './dedup-memory.js';
+import { recordTicketOutcome as recordTicketOutcomeCore, } from '@promptwheel/core/sectors/shared';
+// ---------------------------------------------------------------------------
+// Helpers — shared sector & dedup recording
+// ---------------------------------------------------------------------------
+/** Atomic write: write to .tmp then rename, preventing corruption on crash */
+export function atomicWriteJsonSync(filePath, data) {
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf8');
+    fs.renameSync(tmpPath, filePath);
+}
+/** Load sectors.json, return null if missing/invalid. */
+export function loadSectorsState(rootPath) {
+    try {
+        const filePath = path.join(rootPath, '.promptwheel', 'sectors.json');
+        if (!fs.existsSync(filePath))
+            return null;
+        const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        if (data?.version !== 2 || !Array.isArray(data.sectors))
+            return null;
+        return { state: data, filePath };
+    }
+    catch (err) {
+        console.warn(`[promptwheel] loadSectorsState: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+export function recordSectorOutcome(rootPath, sectorPath, outcome) {
+    if (!sectorPath)
+        return;
+    try {
+        const loaded = loadSectorsState(rootPath);
+        if (!loaded)
+            return;
+        recordTicketOutcomeCore(loaded.state, sectorPath, outcome === 'success');
+        atomicWriteJsonSync(loaded.filePath, loaded.state);
+    }
+    catch (err) {
+        console.warn(`[promptwheel] recordSectorOutcome: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function recordTicketDedup(db, rootPath, ticketId, completed, reason, 
+/** Pass a pre-fetched ticket to avoid a redundant DB lookup */
+prefetchedTicket) {
+    if (!ticketId)
+        return;
+    try {
+        const ticket = prefetchedTicket ?? await repos.tickets.getById(db, ticketId);
+        if (ticket) {
+            recordDedupEntry(rootPath, ticket.title, completed, reason);
+        }
+    }
+    catch (err) {
+        console.warn(`[promptwheel] recordTicketDedup: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Extract a normalized error signature from raw error output.
+ * Captures the first recognizable error pattern (TypeError, SyntaxError, assertion, etc.)
+ * and truncates to 120 chars for storage.
+ */
+export function extractErrorSignature(errorOutput) {
+    if (!errorOutput)
+        return undefined;
+    // Match common error patterns
+    const patterns = [
+        /(?:TypeError|ReferenceError|SyntaxError|RangeError|Error):\s*[^\n]{1,100}/,
+        /AssertionError:\s*[^\n]{1,100}/i,
+        /FAIL(?:ED)?[:\s]+[^\n]{1,80}/i,
+        /error\[E\d+\]:\s*[^\n]{1,80}/i, // Rust errors
+        /panic:\s*[^\n]{1,80}/, // Go panics
+        /Exception[:\s]+[^\n]{1,80}/i, // Java/Python exceptions
+    ];
+    for (const p of patterns) {
+        const match = errorOutput.match(p);
+        if (match)
+            return match[0].slice(0, 120);
+    }
+    return undefined;
+}
+/**
+ * Classify a QA error to determine retry strategy.
+ * - environment: permission denied, missing tools, env vars — don't retry (will never pass)
+ * - timeout: command timed out — retry once (transient)
+ * - code: test failures, type errors, syntax errors — full retries (agent can fix)
+ * - unknown: can't classify — full retries (default)
+ */
+export function classifyQaError(errorOutput) {
+    const lower = errorOutput.toLowerCase();
+    // Environment / permission issues — unrecoverable without human intervention
+    if (/permission denied|eacces|eperm/i.test(errorOutput))
+        return 'environment';
+    if (/command not found|enoent.*spawn/i.test(errorOutput))
+        return 'environment';
+    if (/missing.*(env|variable|credential|token|key|secret)/i.test(lower))
+        return 'environment';
+    if (/econnrefused|enotfound|cannot connect/i.test(errorOutput))
+        return 'environment';
+    // Timeout — transient, worth one retry
+    if (/timed?\s*out|timeout|etimedout/i.test(errorOutput))
+        return 'timeout';
+    if (/killed.*signal|sigterm|sigkill/i.test(lower))
+        return 'timeout';
+    // Code errors — agent can fix these
+    if (/syntaxerror|typeerror|referenceerror|rangeerror/i.test(errorOutput))
+        return 'code';
+    if (/assertion|expect|fail|error\[/i.test(lower))
+        return 'code';
+    if (/tsc.*error|type.*not assignable/i.test(lower))
+        return 'code';
+    return 'unknown';
+}
+/** Max retries per error class */
+export function maxRetriesForClass(errorClass) {
+    switch (errorClass) {
+        case 'environment': return 1; // One retry in case it was a race, then give up
+        case 'timeout': return 2; // Transient — try twice
+        case 'code': return 3; // Agent can fix — full retries
+        case 'unknown': return 3; // Default — full retries
+    }
+}
+//# sourceMappingURL=event-helpers.js.map

package/dist/event-helpers.js.map

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

package/dist/event-processor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event Processor — handles ingested events and triggers state transitions.
+ *
+ * When the client calls `promptwheel_ingest_event`, this module processes
+ * the event and updates RunState accordingly (phase transitions, counters, etc).
+ */
+import type { DatabaseAdapter } from '@promptwheel/core';
+import type { Project } from '@promptwheel/core';
+import { RunManager } from './run-manager.js';
+import type { EventType } from './types.js';
+export type { ProcessResult, QaErrorClass } from './event-helpers.js';
+export { classifyQaError } from './event-helpers.js';
+import type { ProcessResult } from './event-helpers.js';
+export declare function processEvent(run: RunManager, db: DatabaseAdapter, type: EventType, payload: Record<string, unknown>, project?: Project): Promise<ProcessResult>;
+//# sourceMappingURL=event-processor.d.ts.map

package/dist/event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.d.ts","sourceRoot":"","sources":["../src/event-processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,aAAa,CAAC,CA4GxB"}

package/dist/event-processor.js

@@ -0,0 +1,111 @@
+/**
+ * Event Processor — handles ingested events and triggers state transitions.
+ *
+ * When the client calls `promptwheel_ingest_event`, this module processes
+ * the event and updates RunState accordingly (phase transitions, counters, etc).
+ */
+import { filterAndCreateTickets } from './proposals.js';
+import { ingestTicketEvent } from './ticket-worker.js';
+export { classifyQaError } from './event-helpers.js';
+import { handleScoutOutput, handleProposalsReviewed, handleProposalsFiltered } from './event-handlers-scout.js';
+import { handlePlanSubmitted, handleTicketResult, handlePrCreated } from './event-handlers-ticket.js';
+import { handleQaCommandResult, handleQaPassed, handleQaFailed } from './event-handlers-qa.js';
+export async function processEvent(run, db, type, payload, project) {
+    const s = run.require();
+    // Ensure learnings loaded for any event handler that might need them
+    run.ensureLearningsLoaded();
+    // ---------------------------------------------------------------------------
+    // Parallel execution: forward ticket-specific events to ticket workers
+    // ---------------------------------------------------------------------------
+    // When in PARALLEL_EXECUTE phase, events like PR_CREATED, TICKET_RESULT, etc.
+    // should be routed to the ticket worker, not processed at session level.
+    // This handles the case where the user calls promptwheel_ingest_event instead
+    // of promptwheel_ticket_event for ticket completion.
+    const TICKET_WORKER_EVENTS = new Set([
+        'PR_CREATED', 'TICKET_RESULT', 'PLAN_SUBMITTED', 'QA_PASSED', 'QA_FAILED', 'QA_COMMAND_RESULT',
+    ]);
+    if (s.phase === 'PARALLEL_EXECUTE' && TICKET_WORKER_EVENTS.has(type)) {
+        const ticketId = payload['ticket_id'];
+        if (ticketId && run.getTicketWorker(ticketId)) {
+            // Forward to ticket worker
+            const ctx = { run, db, project: project ?? { id: s.project_id, rootPath: run.rootPath } };
+            const result = await ingestTicketEvent(ctx, ticketId, type, payload);
+            return {
+                processed: result.processed,
+                phase_changed: false,
+                message: result.message,
+            };
+        }
+    }
+    const ctx = { run, db, project };
+    switch (type) {
+        // -----------------------------------------------------------------
+        // Scout events
+        // -----------------------------------------------------------------
+        case 'SCOUT_OUTPUT': return handleScoutOutput(ctx, payload);
+        case 'PROPOSALS_REVIEWED': return handleProposalsReviewed(ctx, payload);
+        case 'PROPOSALS_FILTERED': return handleProposalsFiltered(ctx, payload);
+        // -----------------------------------------------------------------
+        // Plan events
+        // -----------------------------------------------------------------
+        case 'PLAN_SUBMITTED': return handlePlanSubmitted(ctx, payload);
+        // -----------------------------------------------------------------
+        // Execution events
+        // -----------------------------------------------------------------
+        case 'TICKET_RESULT': return handleTicketResult(ctx, payload);
+        // -----------------------------------------------------------------
+        // QA events
+        // -----------------------------------------------------------------
+        case 'QA_COMMAND_RESULT': return handleQaCommandResult(ctx, payload);
+        case 'QA_PASSED': return handleQaPassed(ctx, payload);
+        case 'QA_FAILED': return handleQaFailed(ctx, payload);
+        // -----------------------------------------------------------------
+        // PR events
+        // -----------------------------------------------------------------
+        case 'PR_CREATED': return handlePrCreated(ctx, payload);
+        // -----------------------------------------------------------------
+        // User overrides
+        // -----------------------------------------------------------------
+        case 'USER_OVERRIDE': {
+            if (typeof payload['hint'] === 'string') {
+                run.addHint(payload['hint']);
+                return { processed: true, phase_changed: false, message: 'Hint added' };
+            }
+            if (payload['cancel'] === true) {
+                run.setPhase('DONE');
+                return {
+                    processed: true,
+                    phase_changed: true,
+                    new_phase: 'DONE',
+                    message: 'Session cancelled by user',
+                };
+            }
+            if (payload['skip_review'] === true) {
+                s.skip_review = true;
+                // If there are pending proposals waiting for review, create tickets immediately
+                if (s.pending_proposals && s.pending_proposals.length > 0) {
+                    const pendingProposals = s.pending_proposals;
+                    s.pending_proposals = null;
+                    const result = await filterAndCreateTickets(run, db, pendingProposals);
+                    if (result.created_ticket_ids.length > 0) {
+                        run.setPhase('NEXT_TICKET');
+                        return {
+                            processed: true,
+                            phase_changed: true,
+                            new_phase: 'NEXT_TICKET',
+                            message: `skip_review enabled, created ${result.created_ticket_ids.length} tickets from pending proposals`,
+                        };
+                    }
+                }
+                return { processed: true, phase_changed: false, message: 'skip_review enabled' };
+            }
+            return { processed: true, phase_changed: false, message: 'User override recorded' };
+        }
+        // -----------------------------------------------------------------
+        // Default: just record
+        // -----------------------------------------------------------------
+        default:
+            return { processed: true, phase_changed: false, message: `Event ${type} recorded` };
+    }
+}
+//# sourceMappingURL=event-processor.js.map

package/dist/event-processor.js.map

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

package/dist/formulas.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Formulas — typed, versioned, testable sweep recipes.
+ *
+ * Pure definitions (BUILTIN_FORMULAS, YAML parsing) live in
+ * @promptwheel/core/formulas/shared. This file wraps them with
+ * filesystem I/O and adds MCP-specific formula application logic.
+ */
+import type { SessionConfig } from './types.js';
+import { type Formula as CoreFormula } from '@promptwheel/core/formulas/shared';
+export type { Formula } from '@promptwheel/core/formulas/shared';
+export { BUILTIN_FORMULAS, parseSimpleYaml, parseStringList } from '@promptwheel/core/formulas/shared';
+type Formula = CoreFormula;
+/**
+ * Load a formula by name.
+ * Search order: user formulas in `.promptwheel/formulas/`, then built-ins.
+ */
+export declare function loadFormula(name: string, projectPath?: string): Formula | null;
+/**
+ * List all available formulas (user + built-in, user overrides built-in).
+ */
+export declare function listFormulas(projectPath?: string): Formula[];
+/**
+ * Apply a formula's settings to a SessionConfig.
+ * Formula values are defaults — explicit config values take precedence.
+ */
+export declare function applyFormula(formula: Formula, config: SessionConfig): SessionConfig;
+//# sourceMappingURL=formulas.d.ts.map

package/dist/formulas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.d.ts","sourceRoot":"","sources":["../src/formulas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,KAAK,OAAO,IAAI,WAAW,EAI5B,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGvG,KAAK,OAAO,GAAG,WAAW,CAAC;AAM3B;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAI9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAK5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CASnF"}

package/dist/formulas.js

@@ -0,0 +1,109 @@
+/**
+ * Formulas — typed, versioned, testable sweep recipes.
+ *
+ * Pure definitions (BUILTIN_FORMULAS, YAML parsing) live in
+ * @promptwheel/core/formulas/shared. This file wraps them with
+ * filesystem I/O and adds MCP-specific formula application logic.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { BUILTIN_FORMULAS as CORE_BUILTINS, parseSimpleYaml, parseStringList, } from '@promptwheel/core/formulas/shared';
+export { BUILTIN_FORMULAS, parseSimpleYaml, parseStringList } from '@promptwheel/core/formulas/shared';
+// ---------------------------------------------------------------------------
+// Loader (wraps core with filesystem I/O)
+// ---------------------------------------------------------------------------
+/**
+ * Load a formula by name.
+ * Search order: user formulas in `.promptwheel/formulas/`, then built-ins.
+ */
+export function loadFormula(name, projectPath) {
+    const userFormula = loadUserFormula(name, projectPath);
+    if (userFormula)
+        return userFormula;
+    return CORE_BUILTINS.find(f => f.name === name) ?? null;
+}
+/**
+ * List all available formulas (user + built-in, user overrides built-in).
+ */
+export function listFormulas(projectPath) {
+    const userFormulas = loadAllUserFormulas(projectPath);
+    const userNames = new Set(userFormulas.map(f => f.name));
+    const builtins = CORE_BUILTINS.filter(f => !userNames.has(f.name));
+    return [...userFormulas, ...builtins];
+}
+/**
+ * Apply a formula's settings to a SessionConfig.
+ * Formula values are defaults — explicit config values take precedence.
+ */
+export function applyFormula(formula, config) {
+    return {
+        ...config,
+        scope: config.scope ?? formula.scope,
+        categories: config.categories ?? formula.categories,
+        min_confidence: config.min_confidence ?? (formula.min_confidence ?? formula.minConfidence),
+        max_prs: config.max_prs ?? (formula.max_prs ?? formula.maxPrs),
+        formula: config.formula,
+    };
+}
+// ---------------------------------------------------------------------------
+// User formulas (filesystem I/O)
+// ---------------------------------------------------------------------------
+function getFormulasDir(projectPath) {
+    const base = projectPath ?? process.cwd();
+    return path.join(base, '.promptwheel', 'formulas');
+}
+function loadUserFormula(name, projectPath) {
+    const dir = getFormulasDir(projectPath);
+    for (const ext of ['.yaml', '.yml']) {
+        const filePath = path.join(dir, `${name}${ext}`);
+        if (fs.existsSync(filePath)) {
+            return parseFormulaFile(filePath, name);
+        }
+    }
+    return null;
+}
+function loadAllUserFormulas(projectPath) {
+    const dir = getFormulasDir(projectPath);
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const formulas = [];
+    for (const file of files) {
+        const name = path.basename(file, path.extname(file));
+        const formula = parseFormulaFile(path.join(dir, file), name);
+        if (formula)
+            formulas.push(formula);
+    }
+    return formulas;
+}
+function parseFormulaFile(filePath, name) {
+    const safeInt = (val, fallback) => {
+        const n = parseInt(val, 10);
+        return Number.isNaN(n) ? fallback : n;
+    };
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = parseSimpleYaml(content);
+        return {
+            name,
+            version: parsed.version ? safeInt(parsed.version, 1) : 1,
+            description: parsed.description || `Formula: ${name}`,
+            scope: parsed.scope,
+            categories: parsed.categories ? parseStringList(parsed.categories) : undefined,
+            min_confidence: parsed.min_confidence ? safeInt(parsed.min_confidence, 50) : undefined,
+            prompt: parsed.prompt,
+            max_prs: parsed.max_prs ? safeInt(parsed.max_prs, 5) : undefined,
+            model: parsed.model,
+            risk_tolerance: parsed.risk_tolerance,
+            exclude: parsed.exclude ? parseStringList(parsed.exclude) : undefined,
+            tags: parsed.tags ? parseStringList(parsed.tags) : undefined,
+        };
+    }
+    catch (err) {
+        if (err instanceof Error && !('code' in err && err.code === 'ENOENT')) {
+            console.warn(`[promptwheel] failed to parse formula file ${filePath}: ${err.message}`);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=formulas.js.map

package/dist/formulas.js.map

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

package/dist/guidelines.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Project guidelines loader for MCP advance prompts.
+ *
+ * Pure resolution logic and formatting live in @promptwheel/core/guidelines/shared.
+ * This file wraps them with filesystem I/O.
+ */
+import { type ProjectGuidelines, type GuidelinesBackend } from '@promptwheel/core/guidelines/shared';
+export type { ProjectGuidelines } from '@promptwheel/core/guidelines/shared';
+export type { GuidelinesBackend } from '@promptwheel/core/guidelines/shared';
+export { formatGuidelinesForPrompt } from '@promptwheel/core/guidelines/shared';
+export interface GuidelinesOptions {
+    backend?: GuidelinesBackend;
+    customPath?: string | false | null;
+}
+export declare function loadGuidelines(repoRoot: string, opts?: GuidelinesOptions): ProjectGuidelines | null;
+//# sourceMappingURL=guidelines.d.ts.map

package/dist/guidelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.d.ts","sourceRoot":"","sources":["../src/guidelines.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,qCAAqC,CAAC;AAG7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,iBAAiB,GAAG,IAAI,CAW1B"}

package/dist/guidelines.js

@@ -0,0 +1,44 @@
+/**
+ * Project guidelines loader for MCP advance prompts.
+ *
+ * Pure resolution logic and formatting live in @promptwheel/core/guidelines/shared.
+ * This file wraps them with filesystem I/O.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveGuidelinesPaths, } from '@promptwheel/core/guidelines/shared';
+export { formatGuidelinesForPrompt } from '@promptwheel/core/guidelines/shared';
+export function loadGuidelines(repoRoot, opts = {}) {
+    const { backend = 'claude', customPath } = opts;
+    if (customPath === false)
+        return null;
+    if (typeof customPath === 'string') {
+        return readGuidelinesFile(repoRoot, customPath);
+    }
+    const [primaryPaths, fallbackPaths] = resolveGuidelinesPaths(backend);
+    return searchPaths(repoRoot, primaryPaths) ?? searchPaths(repoRoot, fallbackPaths);
+}
+function readGuidelinesFile(repoRoot, rel) {
+    const full = path.join(repoRoot, rel);
+    if (!fs.existsSync(full))
+        return null;
+    try {
+        const content = fs.readFileSync(full, 'utf-8');
+        return { content, source: rel, loadedAt: Date.now() };
+    }
+    catch (err) {
+        if (err instanceof Error && !('code' in err && err.code === 'ENOENT')) {
+            console.warn(`[promptwheel] failed to read guidelines file ${rel}: ${err.message}`);
+        }
+        return null;
+    }
+}
+function searchPaths(repoRoot, paths) {
+    for (const rel of paths) {
+        const result = readGuidelinesFile(repoRoot, rel);
+        if (result)
+            return result;
+    }
+    return null;
+}
+//# sourceMappingURL=guidelines.js.map

package/dist/guidelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.js","sourceRoot":"","sources":["../src/guidelines.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAGL,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAOhF,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAA0B,EAAE;IAE5B,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAEtC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,GAAW;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YACjG,OAAO,CAAC,IAAI,CAAC,gDAAgD,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,KAAe;IACpD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @promptwheel/mcp — MCP server entry point
+ *
+ * Runs as a stdio MCP server for Claude Code.
+ * Usage: npx @promptwheel/mcp
+ */
+export {};
+//# 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;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * @promptwheel/mcp — MCP server entry point
+ *
+ * Runs as a stdio MCP server for Claude Code.
+ * Usage: npx @promptwheel/mcp
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createSQLiteAdapter } from '@promptwheel/sqlite';
+import { createServer } from './server.js';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+async function main() {
+    const projectPath = process.env.PROMPTWHEEL_PROJECT_PATH ?? process.cwd();
+    // Determine DB path
+    const bsDir = path.join(projectPath, '.promptwheel');
+    if (!fs.existsSync(bsDir)) {
+        fs.mkdirSync(bsDir, { recursive: true });
+    }
+    const dbPath = path.join(bsDir, 'state.sqlite');
+    const db = await createSQLiteAdapter({ url: dbPath });
+    const { server } = await createServer({
+        db,
+        projectPath,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Graceful shutdown
+    process.on('SIGINT', async () => {
+        await db.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await db.close();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error('PromptWheel MCP server failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1E,oBAAoB;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC;QACpC,EAAE;QACF,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/learnings.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Cross-run learning mechanism.
+ *
+ * Persists learnings to `.promptwheel/learnings.json` and provides
+ * decay, consolidation, relevance scoring, and prompt formatting.
+ *
+ * Pure algorithms live in @promptwheel/core/learnings/shared.
+ * This file wraps them with filesystem I/O.
+ */
+import { type Learning as CoreLearning, type StructuredKnowledge } from '@promptwheel/core/learnings/shared';
+export type { Learning, StructuredKnowledge } from '@promptwheel/core/learnings/shared';
+export { formatLearningsForPrompt, extractKeywords, selectRelevant, extractTags, LEARNINGS_DEFAULTS, } from '@promptwheel/core/learnings/shared';
+type Learning = CoreLearning;
+/**
+ * Load learnings, apply decay, prune dead entries, write back.
+ * Called once per session start.
+ */
+export declare function loadLearnings(projectRoot: string, decayRate?: number): Learning[];
+/**
+ * Add a new learning with sensible defaults.
+ */
+export declare function addLearning(projectRoot: string, input: {
+    text: string;
+    category: Learning['category'];
+    source: Learning['source'];
+    tags?: string[];
+    structured?: StructuredKnowledge;
+}): Learning;
+/**
+ * Confirm a learning: bump weight +10 and update last_confirmed_at.
+ */
+export declare function confirmLearning(projectRoot: string, id: string): void;
+/**
+ * Record access: increment access_count for each id.
+ */
+export declare function recordAccess(projectRoot: string, ids: string[]): void;
+/**
+ * Consolidate near-duplicate learnings (>70% text similarity).
+ * Keeps the higher weight entry, sums access counts.
+ */
+export declare function consolidateLearnings(projectRoot: string): void;
+//# sourceMappingURL=learnings.d.ts.map

package/dist/learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../src/learnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,mBAAmB,EAIzB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,WAAW,EACX,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAG5C,KAAK,QAAQ,GAAG,YAAY,CAAC;AAsC7B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAsC,GAAG,QAAQ,EAAE,CAKhH;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,GACA,QAAQ,CAkBV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAUrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM9D"}