@promptwheel/cli 0.6.0

package/dist/lib/goals.js

@@ -0,0 +1,216 @@
+/**
+ * Goals — measurable targets that drive wheel formula selection.
+ *
+ * A goal is a formula with a `measure` field. The system measures current
+ * state, picks the goal with the biggest gap from target, and works toward it.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { parseSimpleYaml, parseStringList, } from '@promptwheel/core/formulas/shared';
+// ---------------------------------------------------------------------------
+// Loading
+// ---------------------------------------------------------------------------
+/**
+ * Load goal files from `.promptwheel/goals/*.yaml`, return formulas with measure fields.
+ */
+export function loadGoals(repoRoot) {
+    const goalsDir = path.join(repoRoot, '.promptwheel', 'goals');
+    if (!fs.existsSync(goalsDir))
+        return [];
+    const files = fs.readdirSync(goalsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const goals = [];
+    for (const file of files) {
+        try {
+            const filePath = path.join(goalsDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const parsed = parseSimpleYaml(content);
+            const name = parsed.name || path.basename(file, path.extname(file));
+            const measureCmd = parsed.measure_cmd;
+            const measureTarget = parsed.measure_target ? parseFloat(parsed.measure_target) : undefined;
+            const measureDirection = parsed.measure_direction;
+            if (!measureCmd || measureTarget === undefined || !measureDirection) {
+                continue; // skip goals missing required measure fields
+            }
+            const formula = {
+                name,
+                description: parsed.description || `Goal: ${name}`,
+                categories: parsed.categories ? parseStringList(parsed.categories) : undefined,
+                prompt: parsed.prompt,
+                minConfidence: parsed.min_confidence ? parseInt(parsed.min_confidence, 10) : undefined,
+                min_confidence: parsed.min_confidence ? parseInt(parsed.min_confidence, 10) : undefined,
+                measure: {
+                    cmd: measureCmd,
+                    target: measureTarget,
+                    direction: measureDirection,
+                },
+            };
+            goals.push(formula);
+        }
+        catch {
+            // Skip malformed goal files
+        }
+    }
+    return goals;
+}
+// ---------------------------------------------------------------------------
+// Measurement
+// ---------------------------------------------------------------------------
+/**
+ * Run a measurement command and parse the last number from its output.
+ * Returns null if the command fails or produces no parseable number.
+ */
+export function runMeasurement(cmd, repoRoot) {
+    try {
+        const output = execFileSync('sh', ['-c', cmd], {
+            cwd: repoRoot,
+            timeout: 30_000,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Find the last number in the output
+        const matches = output.match(/-?\d+\.?\d*/g);
+        if (!matches || matches.length === 0) {
+            return { value: null, error: 'No numeric output' };
+        }
+        const value = parseFloat(matches[matches.length - 1]);
+        if (isNaN(value)) {
+            return { value: null, error: 'Could not parse number' };
+        }
+        return { value };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // Truncate long error messages
+        const shortMsg = message.length > 100 ? message.slice(0, 100) + '...' : message;
+        return { value: null, error: shortMsg };
+    }
+}
+/**
+ * Measure all goals, compute gaps.
+ */
+export function measureGoals(goals, repoRoot) {
+    const measurements = [];
+    for (const goal of goals) {
+        if (!goal.measure)
+            continue;
+        const { value, error } = runMeasurement(goal.measure.cmd, repoRoot);
+        const { target, direction } = goal.measure;
+        let gapPercent = 100;
+        let met = false;
+        if (value !== null) {
+            if (direction === 'up') {
+                // Higher is better: gap = how far below target
+                if (value >= target) {
+                    gapPercent = 0;
+                    met = true;
+                }
+                else if (target !== 0) {
+                    gapPercent = ((target - value) / target) * 100;
+                }
+            }
+            else {
+                // Lower is better: gap = how far above target
+                if (value <= target) {
+                    gapPercent = 0;
+                    met = true;
+                }
+                else {
+                    // For "down" direction, express gap relative to current value
+                    gapPercent = target === 0
+                        ? (value > 0 ? 100 : 0)
+                        : ((value - target) / value) * 100;
+                }
+            }
+        }
+        measurements.push({
+            goalName: goal.name,
+            current: value,
+            target,
+            direction,
+            gapPercent: Math.round(gapPercent * 10) / 10,
+            met,
+            error,
+            measuredAt: Date.now(),
+        });
+    }
+    return measurements;
+}
+/**
+ * Pick the goal with the biggest gap from target.
+ * Skips met goals and errored goals.
+ */
+export function pickGoalByGap(measurements) {
+    const candidates = measurements
+        .filter(m => !m.met && m.current !== null)
+        .sort((a, b) => b.gapPercent - a.gapPercent);
+    return candidates[0] ?? null;
+}
+// ---------------------------------------------------------------------------
+// Prompt formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format goal context for injection into the scout prompt.
+ */
+export function formatGoalContext(goal, measurement) {
+    const arrow = measurement.direction === 'up' ? '↑' : '↓';
+    const unit = measurement.direction === 'up' ? 'higher is better' : 'lower is better';
+    return [
+        `<goal>`,
+        `Active goal: ${goal.name}`,
+        `${goal.description}`,
+        `Current: ${measurement.current} | Target: ${measurement.target} (${arrow} ${unit})`,
+        `Gap: ${measurement.gapPercent}%`,
+        `</goal>`,
+        '',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// State persistence
+// ---------------------------------------------------------------------------
+function goalStatePath(repoRoot) {
+    return path.join(repoRoot, '.promptwheel', 'goal-state.json');
+}
+export function readGoalState(repoRoot) {
+    const p = goalStatePath(repoRoot);
+    try {
+        if (fs.existsSync(p)) {
+            return JSON.parse(fs.readFileSync(p, 'utf-8'));
+        }
+    }
+    catch {
+        // Corrupted file — start fresh
+    }
+    return { measurements: {}, lastUpdated: 0 };
+}
+export function writeGoalState(repoRoot, state) {
+    const p = goalStatePath(repoRoot);
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    state.lastUpdated = Date.now();
+    fs.writeFileSync(p, JSON.stringify(state, null, 2));
+}
+const MAX_MEASUREMENTS_PER_GOAL = 50;
+/**
+ * Append a measurement to the ring buffer for a goal.
+ */
+export function recordGoalMeasurement(repoRoot, measurement) {
+    const state = readGoalState(repoRoot);
+    if (!state.measurements[measurement.goalName]) {
+        state.measurements[measurement.goalName] = [];
+    }
+    const entries = state.measurements[measurement.goalName];
+    entries.push({
+        value: measurement.current,
+        timestamp: measurement.measuredAt,
+        error: measurement.error,
+    });
+    // Ring buffer: keep only the last N entries
+    if (entries.length > MAX_MEASUREMENTS_PER_GOAL) {
+        state.measurements[measurement.goalName] = entries.slice(-MAX_MEASUREMENTS_PER_GOAL);
+    }
+    writeGoalState(repoRoot, state);
+}
+//# sourceMappingURL=goals.js.map

package/dist/lib/goals.js.map

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

package/dist/lib/guidelines.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Project guidelines loader — loads CLAUDE.md or AGENTS.md for prompt injection.
+ *
+ * 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, GuidelinesBackend } from '@promptwheel/core/guidelines/shared';
+export { formatGuidelinesForPrompt } from '@promptwheel/core/guidelines/shared';
+export interface GuidelinesOptions {
+    /** Which backend is running. Determines default file search order. */
+    backend?: GuidelinesBackend;
+    /** Auto-create baseline file if none found. */
+    autoCreate?: boolean;
+    /**
+     * Custom path (relative to repoRoot) to the guidelines file.
+     * Overrides the default CLAUDE.md / AGENTS.md search.
+     * Set to false to disable guidelines entirely.
+     */
+    customPath?: string | false | null;
+}
+/**
+ * Load project guidelines.
+ *
+ * Resolution order:
+ * 1. If customPath is false → disabled, return null
+ * 2. If customPath is a string → use that exact file
+ * 3. Otherwise → search default paths by backend (primary then fallback)
+ * 4. If nothing found and autoCreate → generate baseline
+ */
+export declare function loadGuidelines(repoRoot: string, opts?: GuidelinesOptions): ProjectGuidelines | null;
+//# sourceMappingURL=guidelines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.d.ts","sourceRoot":"","sources":["../../src/lib/guidelines.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAKvB,MAAM,qCAAqC,CAAC;AAG7C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAChG,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,iBAAiB,GAAG,IAAI,CAuB1B"}

package/dist/lib/guidelines.js

@@ -0,0 +1,102 @@
+/**
+ * Project guidelines loader — loads CLAUDE.md or AGENTS.md for prompt injection.
+ *
+ * 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, getBaselineFilename, generateBaselineGuidelines, } from '@promptwheel/core/guidelines/shared';
+export { formatGuidelinesForPrompt } from '@promptwheel/core/guidelines/shared';
+/**
+ * Load project guidelines.
+ *
+ * Resolution order:
+ * 1. If customPath is false → disabled, return null
+ * 2. If customPath is a string → use that exact file
+ * 3. Otherwise → search default paths by backend (primary then fallback)
+ * 4. If nothing found and autoCreate → generate baseline
+ */
+export function loadGuidelines(repoRoot, opts = {}) {
+    const { backend = 'claude', autoCreate = false, customPath } = opts;
+    // Explicitly disabled
+    if (customPath === false)
+        return null;
+    // Custom path — single file, no fallback
+    if (typeof customPath === 'string') {
+        return readGuidelinesFile(repoRoot, customPath);
+    }
+    // Default search: primary paths by backend, then fallback
+    const [primaryPaths, fallbackPaths] = resolveGuidelinesPaths(backend);
+    const result = searchPaths(repoRoot, primaryPaths) ?? searchPaths(repoRoot, fallbackPaths);
+    if (result)
+        return result;
+    // Nothing found — auto-create if enabled
+    if (autoCreate) {
+        return createBaselineGuidelines(repoRoot, backend);
+    }
+    return null;
+}
+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 {
+        return null;
+    }
+}
+function searchPaths(repoRoot, paths) {
+    for (const rel of paths) {
+        const result = readGuidelinesFile(repoRoot, rel);
+        if (result)
+            return result;
+    }
+    return null;
+}
+/**
+ * Generate a baseline guidelines file from project metadata.
+ */
+function createBaselineGuidelines(repoRoot, backend) {
+    const filename = getBaselineFilename(backend);
+    const fullPath = path.join(repoRoot, filename);
+    // Don't overwrite existing files
+    if (fs.existsSync(fullPath))
+        return null;
+    // Build input from package.json
+    const input = buildBaselineInput(repoRoot);
+    const content = generateBaselineGuidelines(input, backend);
+    try {
+        fs.writeFileSync(fullPath, content, 'utf-8');
+        return { content, source: filename, loadedAt: Date.now() };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build baseline input from project metadata (package.json, monorepo detection).
+ */
+function buildBaselineInput(repoRoot) {
+    const projectName = path.basename(repoRoot);
+    const input = { projectName };
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf-8'));
+        input.description = pkg.description || undefined;
+        input.scripts = pkg.scripts || {};
+        input.hasTypeScript = !!(pkg.devDependencies?.typescript ||
+            pkg.dependencies?.typescript);
+    }
+    catch {
+        // No package.json
+    }
+    // Detect monorepo
+    const hasWorkspaces = fs.existsSync(path.join(repoRoot, 'pnpm-workspace.yaml')) ||
+        fs.existsSync(path.join(repoRoot, 'lerna.json'));
+    input.isMonorepo = hasWorkspaces || fs.existsSync(path.join(repoRoot, 'packages'));
+    return input;
+}
+//# sourceMappingURL=guidelines.js.map

package/dist/lib/guidelines.js.map

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

package/dist/lib/learnings.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Cross-run learning mechanism.
+ *
+ * Persists learnings to `.promptwheel/learnings.json` and provides
+ * decay, consolidation, relevance scoring, and prompt formatting.
+ *
+ * Pure algorithms (decay, consolidation, formatting, keyword extraction,
+ * relevance scoring) live in @promptwheel/core/learnings/shared.
+ * This file wraps them with filesystem I/O and adds CLI-specific
+ * extensions (metrics instrumentation, effectiveness tracking).
+ */
+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;
+/**
+ * Record learning application: track when learnings were used in a ticket context.
+ */
+export declare function recordApplication(projectRoot: string, ids: string[]): void;
+/**
+ * Record learning outcome: track success/failure after a ticket completes.
+ */
+export declare function recordOutcome(projectRoot: string, ids: string[], success: boolean): void;
+/**
+ * Get learning effectiveness stats.
+ */
+export declare function getLearningEffectiveness(projectRoot: string): {
+    total: number;
+    applied: number;
+    successRate: number;
+    topPerformers: Array<{
+        id: string;
+        text: string;
+        effectiveness: number;
+    }>;
+};
+/**
+ * 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/lib/learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/lib/learnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,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;AAqC7B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAsC,GAAG,QAAQ,EAAE,CAShH;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;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAa1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBxF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E,CA+BA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM9D"}

package/dist/lib/learnings.js

@@ -0,0 +1,193 @@
+/**
+ * Cross-run learning mechanism.
+ *
+ * Persists learnings to `.promptwheel/learnings.json` and provides
+ * decay, consolidation, relevance scoring, and prompt formatting.
+ *
+ * Pure algorithms (decay, consolidation, formatting, keyword extraction,
+ * relevance scoring) live in @promptwheel/core/learnings/shared.
+ * This file wraps them with filesystem I/O and adds CLI-specific
+ * extensions (metrics instrumentation, effectiveness tracking).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { metric } from './metrics.js';
+import { applyLearningsDecay, consolidateLearnings as coreConsolidate, LEARNINGS_DEFAULTS, } from '@promptwheel/core/learnings/shared';
+export { formatLearningsForPrompt, extractKeywords, selectRelevant, extractTags, LEARNINGS_DEFAULTS, } from '@promptwheel/core/learnings/shared';
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+const LEARNINGS_FILE = 'learnings.json';
+function learningsPath(projectRoot) {
+    return path.join(projectRoot, '.promptwheel', LEARNINGS_FILE);
+}
+function readLearnings(projectRoot) {
+    const fp = learningsPath(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 writeLearnings(projectRoot, learnings) {
+    const fp = learningsPath(projectRoot);
+    const dir = path.dirname(fp);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(fp, JSON.stringify(learnings, null, 2) + '\n', 'utf8');
+}
+// ---------------------------------------------------------------------------
+// Core API (wraps core algorithms with I/O + metrics)
+// ---------------------------------------------------------------------------
+/**
+ * Load learnings, apply decay, prune dead entries, write back.
+ * Called once per session start.
+ */
+export function loadLearnings(projectRoot, decayRate = LEARNINGS_DEFAULTS.DECAY_RATE) {
+    const learnings = readLearnings(projectRoot);
+    const surviving = applyLearningsDecay(learnings, decayRate);
+    writeLearnings(projectRoot, surviving);
+    // Instrument: track how many learnings loaded
+    metric('learnings', 'loaded', { count: surviving.length, decayed: learnings.length - surviving.length });
+    return surviving;
+}
+/**
+ * Add a new learning with sensible defaults.
+ */
+export function addLearning(projectRoot, input) {
+    const learnings = readLearnings(projectRoot);
+    const now = new Date().toISOString();
+    const learning = {
+        id: crypto.randomBytes(4).toString('hex'),
+        text: input.text.slice(0, 200),
+        category: input.category,
+        source: input.source,
+        tags: input.tags ?? [],
+        weight: LEARNINGS_DEFAULTS.DEFAULT_WEIGHT,
+        created_at: now,
+        last_confirmed_at: now,
+        access_count: 0,
+        structured: input.structured,
+    };
+    learnings.push(learning);
+    writeLearnings(projectRoot, learnings);
+    return learning;
+}
+/**
+ * Confirm a learning: bump weight +10 and update last_confirmed_at.
+ */
+export function confirmLearning(projectRoot, id) {
+    const learnings = readLearnings(projectRoot);
+    const l = learnings.find(x => x.id === id);
+    if (!l)
+        return;
+    l.weight = Math.min(LEARNINGS_DEFAULTS.MAX_WEIGHT, l.weight + 10);
+    l.last_confirmed_at = new Date().toISOString();
+    writeLearnings(projectRoot, learnings);
+}
+/**
+ * Record access: increment access_count for each id.
+ */
+export function recordAccess(projectRoot, ids) {
+    if (ids.length === 0)
+        return;
+    const learnings = readLearnings(projectRoot);
+    const idSet = new Set(ids);
+    for (const l of learnings) {
+        if (idSet.has(l.id)) {
+            l.access_count++;
+        }
+    }
+    writeLearnings(projectRoot, learnings);
+}
+/**
+ * Record learning application: track when learnings were used in a ticket context.
+ */
+export function recordApplication(projectRoot, ids) {
+    if (ids.length === 0)
+        return;
+    const learnings = readLearnings(projectRoot);
+    const idSet = new Set(ids);
+    for (const l of learnings) {
+        if (idSet.has(l.id)) {
+            l.applied_count = (l.applied_count ?? 0) + 1;
+        }
+    }
+    writeLearnings(projectRoot, learnings);
+    // Instrument: track application
+    metric('learnings', 'applied', { count: ids.length });
+}
+/**
+ * Record learning outcome: track success/failure after a ticket completes.
+ */
+export function recordOutcome(projectRoot, ids, success) {
+    if (ids.length === 0)
+        return;
+    const learnings = readLearnings(projectRoot);
+    const idSet = new Set(ids);
+    for (const l of learnings) {
+        if (idSet.has(l.id)) {
+            if (success) {
+                l.success_count = (l.success_count ?? 0) + 1;
+                // Boost weight on success
+                l.weight = Math.min(LEARNINGS_DEFAULTS.MAX_WEIGHT, l.weight + 2);
+            }
+            else {
+                // Slight penalty on failure (learning didn't help)
+                l.weight = Math.max(1, l.weight - 1);
+            }
+        }
+    }
+    writeLearnings(projectRoot, learnings);
+    // Instrument: track outcome
+    metric('learnings', 'outcome', { count: ids.length, success });
+}
+/**
+ * Get learning effectiveness stats.
+ */
+export function getLearningEffectiveness(projectRoot) {
+    const learnings = readLearnings(projectRoot);
+    const withApplication = learnings.filter(l => (l.applied_count ?? 0) > 0);
+    let totalApplied = 0;
+    let totalSuccess = 0;
+    const performers = [];
+    for (const l of withApplication) {
+        const applied = l.applied_count ?? 0;
+        const success = l.success_count ?? 0;
+        totalApplied += applied;
+        totalSuccess += success;
+        if (applied >= 2) { // Only include learnings with enough data
+            performers.push({
+                id: l.id,
+                text: l.text,
+                effectiveness: applied > 0 ? success / applied : 0,
+            });
+        }
+    }
+    performers.sort((a, b) => b.effectiveness - a.effectiveness);
+    return {
+        total: learnings.length,
+        applied: totalApplied,
+        successRate: totalApplied > 0 ? totalSuccess / totalApplied : 0,
+        topPerformers: performers.slice(0, 5),
+    };
+}
+/**
+ * Consolidate near-duplicate learnings (>70% text similarity).
+ * Keeps the higher weight entry, sums access counts.
+ */
+export function consolidateLearnings(projectRoot) {
+    const learnings = readLearnings(projectRoot);
+    const result = coreConsolidate(learnings);
+    if (result !== null) {
+        writeLearnings(projectRoot, result);
+    }
+}
+//# sourceMappingURL=learnings.js.map

package/dist/lib/learnings.js.map

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger implementation for CLI
+ */
+import type { Logger } from '@promptwheel/core/services';
+export interface LoggerOptions {
+    verbose?: boolean;
+    quiet?: boolean;
+}
+/**
+ * Create a logger instance
+ */
+export declare function createLogger(opts?: LoggerOptions): Logger;
+/**
+ * Silent logger (for tests or quiet mode)
+ */
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map