@promptwheel/cli 0.6.0

package/dist/lib/failure-classifier.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Classify QA/ticket failures into structured categories.
+ */
+export type FailureType = 'compile_error' | 'type_error' | 'test_assertion' | 'runtime_error' | 'lint_error' | 'timeout' | 'unknown';
+export interface ClassifiedFailure {
+    failureType: FailureType;
+    failedCommand: string;
+    errorPattern: string;
+}
+export declare function classifyFailure(stepName: string, output: string): ClassifiedFailure;
+//# sourceMappingURL=failure-classifier.d.ts.map

package/dist/lib/failure-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-classifier.d.ts","sourceRoot":"","sources":["../../src/lib/failure-classifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAErI,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAgBnF"}

package/dist/lib/failure-classifier.js

@@ -0,0 +1,24 @@
+/**
+ * Classify QA/ticket failures into structured categories.
+ */
+export function classifyFailure(stepName, output) {
+    const tail = output.slice(-5000);
+    let failureType = 'unknown';
+    if (/\berror TS\d+\b|TS\d+:/.test(tail))
+        failureType = 'type_error';
+    else if (/Cannot find module|SyntaxError|Module not found/.test(tail))
+        failureType = 'compile_error';
+    else if (/FAIL|AssertionError|expect\(|assert\.|✗/.test(tail) && /test|spec/i.test(stepName))
+        failureType = 'test_assertion';
+    else if (/eslint|prettier|lint/i.test(stepName))
+        failureType = 'lint_error';
+    else if (/SIGTERM|timed?\s*out|ETIMEDOUT/i.test(tail))
+        failureType = 'timeout';
+    else if (/ReferenceError|TypeError|Error:|ENOENT|EACCES/.test(tail))
+        failureType = 'runtime_error';
+    const lines = tail.split('\n');
+    const errorLine = lines.find(l => /^(error|Error|FAIL|✗|×|FAILED)/i.test(l.trim()));
+    const errorPattern = (errorLine ?? '').trim().slice(0, 100);
+    return { failureType, failedCommand: stepName, errorPattern };
+}
+//# sourceMappingURL=failure-classifier.js.map

package/dist/lib/failure-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-classifier.js","sourceRoot":"","sources":["../../src/lib/failure-classifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAc;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,WAAW,GAAgB,SAAS,CAAC;IAEzC,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,WAAW,GAAG,YAAY,CAAC;SAC/D,IAAI,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,WAAW,GAAG,eAAe,CAAC;SAChG,IAAI,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,WAAW,GAAG,gBAAgB,CAAC;SACxH,IAAI,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,WAAW,GAAG,YAAY,CAAC;SACvE,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,WAAW,GAAG,SAAS,CAAC;SAC1E,IAAI,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,WAAW,GAAG,eAAe,CAAC;IAEnG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,YAAY,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AAChE,CAAC"}

package/dist/lib/file-cooldown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File cooldown tracking for pending PRs.
+ * Prevents scheduling overlapping work on files that already have open PRs.
+ */
+export declare function recordPrFiles(repoRoot: string, prUrl: string, files: string[]): void;
+export declare function getCooledFiles(repoRoot: string): Map<string, string>;
+export declare function removePrEntries(repoRoot: string, prUrls: string[]): void;
+export declare function computeCooldownOverlap(files: string[], cooledFiles: Map<string, string>): number;
+//# sourceMappingURL=file-cooldown.d.ts.map

package/dist/lib/file-cooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cooldown.d.ts","sourceRoot":"","sources":["../../src/lib/file-cooldown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAOpF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYpE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAKxE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAOhG"}

package/dist/lib/file-cooldown.js

@@ -0,0 +1,75 @@
+/**
+ * File cooldown tracking for pending PRs.
+ * Prevents scheduling overlapping work on files that already have open PRs.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const COOLDOWN_FILE = 'file-cooldown.json';
+const TTL_MS = 48 * 60 * 60 * 1000; // 48 hours
+function cooldownPath(repoRoot) {
+    return path.join(repoRoot, '.promptwheel', COOLDOWN_FILE);
+}
+function readEntries(repoRoot) {
+    const fp = cooldownPath(repoRoot);
+    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(repoRoot, entries) {
+    const fp = cooldownPath(repoRoot);
+    const dir = path.dirname(fp);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(fp, JSON.stringify(entries, null, 2) + '\n', 'utf8');
+}
+function prune(entries) {
+    const cutoff = Date.now() - TTL_MS;
+    return entries.filter(e => e.createdAt > cutoff);
+}
+export function recordPrFiles(repoRoot, prUrl, files) {
+    const entries = prune(readEntries(repoRoot));
+    const now = Date.now();
+    for (const filePath of files) {
+        entries.push({ filePath, prUrl, createdAt: now });
+    }
+    writeEntries(repoRoot, entries);
+}
+export function getCooledFiles(repoRoot) {
+    const raw = readEntries(repoRoot);
+    const entries = prune(raw);
+    // Only write back if entries were actually pruned
+    if (entries.length < raw.length) {
+        writeEntries(repoRoot, entries);
+    }
+    const map = new Map();
+    for (const e of entries) {
+        map.set(e.filePath, e.prUrl);
+    }
+    return map;
+}
+export function removePrEntries(repoRoot, prUrls) {
+    if (prUrls.length === 0)
+        return;
+    const urlSet = new Set(prUrls);
+    const entries = readEntries(repoRoot).filter(e => !urlSet.has(e.prUrl));
+    writeEntries(repoRoot, prune(entries));
+}
+export function computeCooldownOverlap(files, cooledFiles) {
+    if (files.length === 0 || cooledFiles.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const f of files) {
+        if (cooledFiles.has(f))
+            overlap++;
+    }
+    return overlap / files.length;
+}
+//# sourceMappingURL=file-cooldown.js.map

package/dist/lib/file-cooldown.js.map

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

package/dist/lib/formulas.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Formulas - User-defined repeatable sweep recipes
+ *
+ * A formula is a YAML config that defines what an auto run should
+ * look for and how to fix it. Formulas live in .promptwheel/formulas/
+ * and can be invoked with --formula <name>.
+ *
+ * Pure definitions (BUILTIN_FORMULAS, YAML parsing) live in
+ * @promptwheel/core/formulas/shared. This file wraps them with
+ * filesystem I/O and adds CLI-specific formula application logic.
+ */
+import type { ProposalCategory } from '@promptwheel/core/scout';
+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:
+ * 1. .promptwheel/formulas/<name>.yaml (or .yml)
+ * 2. Built-in formulas
+ */
+export declare function loadFormula(name: string, repoPath?: string): Formula | null;
+/**
+ * List all available formulas (built-in + user-defined)
+ */
+export declare function listFormulas(repoPath?: string): Formula[];
+/**
+ * Apply a formula's settings to auto options.
+ * Formula values override defaults but CLI flags take precedence.
+ */
+export declare function applyFormula(formula: Formula, cliOptions: {
+    scope?: string;
+    types?: ProposalCategory[];
+    minConfidence?: number;
+    maxPrs?: number;
+    maxTime?: string;
+    exclude?: string[];
+    noRoadmap?: boolean;
+}): {
+    scope: string;
+    types?: ProposalCategory[];
+    minConfidence?: number;
+    maxPrs?: number;
+    maxTime?: string;
+    exclude?: string[];
+    noRoadmap?: boolean;
+    prompt?: string;
+    focusAreas?: string[];
+};
+//# sourceMappingURL=formulas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.d.ts","sourceRoot":"","sources":["../../src/lib/formulas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,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;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAI3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAKzD;AAyED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAYA"}

package/dist/lib/formulas.js

@@ -0,0 +1,123 @@
+/**
+ * Formulas - User-defined repeatable sweep recipes
+ *
+ * A formula is a YAML config that defines what an auto run should
+ * look for and how to fix it. Formulas live in .promptwheel/formulas/
+ * and can be invoked with --formula <name>.
+ *
+ * Pure definitions (BUILTIN_FORMULAS, YAML parsing) live in
+ * @promptwheel/core/formulas/shared. This file wraps them with
+ * filesystem I/O and adds CLI-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';
+// =============================================================================
+// Formula Loader (wraps core with filesystem I/O)
+// =============================================================================
+/**
+ * Load a formula by name.
+ *
+ * Search order:
+ * 1. .promptwheel/formulas/<name>.yaml (or .yml)
+ * 2. Built-in formulas
+ */
+export function loadFormula(name, repoPath) {
+    const userFormula = loadUserFormula(name, repoPath);
+    if (userFormula)
+        return userFormula;
+    return CORE_BUILTINS.find(f => f.name === name) ?? null;
+}
+/**
+ * List all available formulas (built-in + user-defined)
+ */
+export function listFormulas(repoPath) {
+    const userFormulas = loadAllUserFormulas(repoPath);
+    const userNames = new Set(userFormulas.map(f => f.name));
+    const builtins = CORE_BUILTINS.filter(f => !userNames.has(f.name));
+    return [...userFormulas, ...builtins];
+}
+/**
+ * Load a user-defined formula from .promptwheel/formulas/
+ */
+function loadUserFormula(name, repoPath) {
+    const dir = getFormulasDir(repoPath);
+    if (!dir)
+        return null;
+    for (const ext of ['.yaml', '.yml']) {
+        const filePath = path.join(dir, `${name}${ext}`);
+        if (fs.existsSync(filePath)) {
+            return parseFormulaFile(filePath, name);
+        }
+    }
+    return null;
+}
+/**
+ * Load all user-defined formulas
+ */
+function loadAllUserFormulas(repoPath) {
+    const dir = getFormulasDir(repoPath);
+    if (!dir || !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;
+}
+/**
+ * Get the formulas directory path
+ */
+function getFormulasDir(repoPath) {
+    const base = repoPath || process.cwd();
+    return path.join(base, '.promptwheel', 'formulas');
+}
+/**
+ * Parse a YAML formula file.
+ */
+function parseFormulaFile(filePath, name) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = parseSimpleYaml(content);
+        return {
+            name,
+            description: parsed.description || `Formula: ${name}`,
+            scope: parsed.scope,
+            categories: parsed.categories ? parseStringList(parsed.categories) : undefined,
+            minConfidence: parsed.min_confidence ? parseInt(parsed.min_confidence, 10) : undefined,
+            prompt: parsed.prompt,
+            maxPrs: parsed.max_prs ? parseInt(parsed.max_prs, 10) : undefined,
+            maxTime: parsed.max_time,
+            focusAreas: parsed.focus_areas ? parseStringList(parsed.focus_areas) : undefined,
+            exclude: parsed.exclude ? parseStringList(parsed.exclude) : undefined,
+            useRoadmap: parsed.use_roadmap !== undefined ? parsed.use_roadmap === 'true' : undefined,
+            tags: parsed.tags ? parseStringList(parsed.tags) : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Apply a formula's settings to auto options.
+ * Formula values override defaults but CLI flags take precedence.
+ */
+export function applyFormula(formula, cliOptions) {
+    return {
+        scope: cliOptions.scope || formula.scope || 'src',
+        types: cliOptions.types || formula.categories,
+        minConfidence: cliOptions.minConfidence ?? formula.minConfidence,
+        maxPrs: cliOptions.maxPrs ?? formula.maxPrs,
+        maxTime: cliOptions.maxTime || formula.maxTime,
+        exclude: cliOptions.exclude || formula.exclude,
+        noRoadmap: cliOptions.noRoadmap ?? (formula.useRoadmap === false ? true : undefined),
+        prompt: formula.prompt,
+        focusAreas: formula.focusAreas,
+    };
+}
+//# sourceMappingURL=formulas.js.map

package/dist/lib/formulas.js.map

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

package/dist/lib/git.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Git service implementation for CLI
+ */
+import type { GitService } from '@promptwheel/core/services';
+/**
+ * Create a GitService instance
+ */
+export declare function createGitService(): GitService;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAmD7D;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAM7C"}

package/dist/lib/git.js

@@ -0,0 +1,60 @@
+/**
+ * Git service implementation for CLI
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Find git repository root from a path
+ */
+async function findRepoRoot(startPath) {
+    let current = path.resolve(startPath);
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return null;
+}
+/**
+ * Get remote URL from git
+ */
+async function getRemoteUrl(repoRoot) {
+    try {
+        const url = execSync('git remote get-url origin', {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return url || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Generate deterministic project ID from repo
+ */
+function getProjectId(repoRoot, remoteUrl) {
+    const source = remoteUrl || repoRoot;
+    // Simple hash for deterministic ID
+    let hash = 0;
+    for (let i = 0; i < source.length; i++) {
+        const char = source.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash | 0; // Convert to 32bit integer
+    }
+    return `proj_${Math.abs(hash).toString(36)}`;
+}
+/**
+ * Create a GitService instance
+ */
+export function createGitService() {
+    return {
+        findRepoRoot,
+        getRemoteUrl,
+        getProjectId,
+    };
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,SAAiB;IAC3C,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtC,OAAO,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YAChD,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAE,SAAwB;IAC9D,MAAM,MAAM,GAAG,SAAS,IAAI,QAAQ,CAAC;IAErC,mCAAmC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACnC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,2BAA2B;IAC9C,CAAC;IAED,OAAO,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/lib/goals.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 { type Formula } from '@promptwheel/core/formulas/shared';
+export interface GoalMeasurement {
+    goalName: string;
+    current: number | null;
+    target: number;
+    direction: 'up' | 'down';
+    gapPercent: number;
+    met: boolean;
+    error?: string;
+    measuredAt: number;
+}
+export interface GoalState {
+    measurements: Record<string, GoalMeasurementEntry[]>;
+    lastUpdated: number;
+}
+interface GoalMeasurementEntry {
+    value: number | null;
+    timestamp: number;
+    error?: string;
+}
+/**
+ * Load goal files from `.promptwheel/goals/*.yaml`, return formulas with measure fields.
+ */
+export declare function loadGoals(repoRoot: string): Formula[];
+/**
+ * Run a measurement command and parse the last number from its output.
+ * Returns null if the command fails or produces no parseable number.
+ */
+export declare function runMeasurement(cmd: string, repoRoot: string): {
+    value: number | null;
+    error?: string;
+};
+/**
+ * Measure all goals, compute gaps.
+ */
+export declare function measureGoals(goals: Formula[], repoRoot: string): GoalMeasurement[];
+/**
+ * Pick the goal with the biggest gap from target.
+ * Skips met goals and errored goals.
+ */
+export declare function pickGoalByGap(measurements: GoalMeasurement[]): GoalMeasurement | null;
+/**
+ * Format goal context for injection into the scout prompt.
+ */
+export declare function formatGoalContext(goal: Formula, measurement: GoalMeasurement): string;
+export declare function readGoalState(repoRoot: string): GoalState;
+export declare function writeGoalState(repoRoot: string, state: GoalState): void;
+/**
+ * Append a measurement to the ring buffer for a goal.
+ */
+export declare function recordGoalMeasurement(repoRoot: string, measurement: GoalMeasurement): void;
+export {};
+//# sourceMappingURL=goals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../src/lib/goals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,KAAK,OAAO,EAGb,MAAM,mCAAmC,CAAC;AAM3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA2CrD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BtG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAgDlF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI,CAMrF;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,GAAG,MAAM,CAYrF;AAUD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAUzD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAQvE;AAID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,IAAI,CAmB1F"}