@blockspool/cli 0.4.2 → 0.5.0

package/dist/lib/learnings.js

@@ -0,0 +1,248 @@
+/**
+ * Cross-run learning mechanism.
+ *
+ * Persists learnings to `.blockspool/learnings.json` and provides
+ * decay, consolidation, relevance scoring, and prompt formatting.
+ *
+ * Copied from packages/mcp/src/learnings.ts with titleSimilarity
+ * inlined to avoid cross-package dependency.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Inlined bigrams / titleSimilarity (from proposals.ts)
+// ---------------------------------------------------------------------------
+function bigrams(s) {
+    const result = new Set();
+    const cleaned = s.replace(/[^a-z0-9 ]/g, '').trim();
+    for (let i = 0; i < cleaned.length - 1; i++) {
+        result.add(cleaned.slice(i, i + 2));
+    }
+    return result;
+}
+function titleSimilarity(a, b) {
+    const bigramsA = bigrams(a.toLowerCase());
+    const bigramsB = bigrams(b.toLowerCase());
+    if (bigramsA.size === 0 && bigramsB.size === 0)
+        return 1;
+    if (bigramsA.size === 0 || bigramsB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const bg of bigramsA) {
+        if (bigramsB.has(bg))
+            intersection++;
+    }
+    const union = bigramsA.size + bigramsB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const LEARNINGS_FILE = 'learnings.json';
+const DEFAULT_DECAY_RATE = 3;
+const DEFAULT_WEIGHT = 50;
+const MAX_WEIGHT = 100;
+const CONSOLIDATION_THRESHOLD = 50;
+const SIMILARITY_MERGE_THRESHOLD = 0.7;
+const CONFIRMATION_WINDOW_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const DEFAULT_BUDGET = 2000;
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+function learningsPath(projectRoot) {
+    return path.join(projectRoot, '.blockspool', 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
+// ---------------------------------------------------------------------------
+/**
+ * Load learnings, apply decay, prune dead entries, write back.
+ * Called once per session start.
+ */
+export function loadLearnings(projectRoot, decayRate = DEFAULT_DECAY_RATE) {
+    const learnings = readLearnings(projectRoot);
+    const now = Date.now();
+    const surviving = [];
+    for (const l of learnings) {
+        let decay = decayRate;
+        // Access bonus: halve decay if accessed
+        if (l.access_count > 0) {
+            decay /= 2;
+        }
+        // Confirmation bonus: halve again if confirmed within 7 days
+        const confirmedAt = new Date(l.last_confirmed_at).getTime();
+        if (now - confirmedAt < CONFIRMATION_WINDOW_MS) {
+            decay /= 2;
+        }
+        l.weight = Math.min(MAX_WEIGHT, l.weight - decay);
+        if (l.weight > 0) {
+            surviving.push(l);
+        }
+    }
+    writeLearnings(projectRoot, surviving);
+    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: DEFAULT_WEIGHT,
+        created_at: now,
+        last_confirmed_at: now,
+        access_count: 0,
+    };
+    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(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);
+}
+/**
+ * Consolidate near-duplicate learnings (>70% text similarity).
+ * Keeps the higher weight entry, sums access counts.
+ */
+export function consolidateLearnings(projectRoot) {
+    const learnings = readLearnings(projectRoot);
+    if (learnings.length <= CONSOLIDATION_THRESHOLD)
+        return;
+    const merged = new Set();
+    for (let i = 0; i < learnings.length; i++) {
+        if (merged.has(i))
+            continue;
+        for (let j = i + 1; j < learnings.length; j++) {
+            if (merged.has(j))
+                continue;
+            if (titleSimilarity(learnings[i].text, learnings[j].text) >= SIMILARITY_MERGE_THRESHOLD) {
+                // Merge j into i (keep higher weight)
+                if (learnings[j].weight > learnings[i].weight) {
+                    learnings[i].weight = learnings[j].weight;
+                    learnings[i].text = learnings[j].text;
+                }
+                learnings[i].access_count += learnings[j].access_count;
+                // Merge tags
+                const tagSet = new Set([...learnings[i].tags, ...learnings[j].tags]);
+                learnings[i].tags = [...tagSet];
+                merged.add(j);
+            }
+        }
+    }
+    const result = learnings.filter((_, idx) => !merged.has(idx));
+    writeLearnings(projectRoot, result);
+}
+/**
+ * Format learnings for prompt injection.
+ * Sorts by weight descending, respects char budget.
+ */
+export function formatLearningsForPrompt(learnings, budget = DEFAULT_BUDGET) {
+    if (learnings.length === 0)
+        return '';
+    const sorted = [...learnings].sort((a, b) => b.weight - a.weight);
+    const lines = [];
+    let charCount = 0;
+    const header = '<project-learnings>\n## Learnings from Previous Runs\n';
+    const footer = '\n</project-learnings>';
+    charCount += header.length + footer.length;
+    for (const l of sorted) {
+        const tag = l.category.toUpperCase();
+        const line = `- [${tag}] ${l.text} (w:${Math.round(l.weight)})`;
+        if (charCount + line.length + 1 > budget)
+            break;
+        lines.push(line);
+        charCount += line.length + 1;
+    }
+    if (lines.length === 0)
+        return '';
+    return header + lines.join('\n') + footer;
+}
+/**
+ * Select learnings relevant to the current context.
+ * Scores by tag overlap × weight.
+ */
+export function selectRelevant(learnings, context) {
+    const contextTags = extractTags(context.paths ?? [], context.commands ?? []);
+    if (contextTags.length === 0)
+        return learnings;
+    const contextTagSet = new Set(contextTags);
+    const scored = learnings.map(l => {
+        let tagScore = 0;
+        for (const t of l.tags) {
+            if (contextTagSet.has(t))
+                tagScore += 20;
+        }
+        return { learning: l, score: tagScore + l.weight };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored.map(s => s.learning);
+}
+/**
+ * Extract tags from paths and commands for tag matching.
+ */
+export function extractTags(paths, commands) {
+    const tags = [];
+    for (const p of paths) {
+        // Normalize: strip trailing globs
+        const clean = p.replace(/\/?\*\*?$/, '');
+        if (clean)
+            tags.push(`path:${clean}`);
+    }
+    for (const c of commands) {
+        tags.push(`cmd:${c}`);
+    }
+    return tags;
+}
+//# 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/project-metadata.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Project Metadata — framework-agnostic detection of tooling, test runners,
+ * package managers, and languages.
+ *
+ * Scans config files at the project root to build a structured summary
+ * that gets injected into scout prompts so the LLM knows which CLI
+ * flags and conventions to use.
+ */
+export interface ProjectMetadata {
+    /** Primary language(s) detected */
+    languages: string[];
+    /** Package manager (npm, yarn, pnpm, bun, pip, poetry, cargo, go, mix, bundle, maven, gradle) */
+    package_manager: string | null;
+    /** Test runner and CLI syntax */
+    test_runner: TestRunnerInfo | null;
+    /** App framework (next, remix, express, django, flask, rails, phoenix, spring, etc.) */
+    framework: string | null;
+    /** Linter (eslint, biome, ruff, clippy, golangci-lint, rubocop, etc.) */
+    linter: string | null;
+    /** Type checker if separate from compiler (tsc, mypy, pyright, etc.) */
+    type_checker: string | null;
+    /** Monorepo tool (turborepo, nx, lerna, cargo workspaces, etc.) */
+    monorepo_tool: string | null;
+    /** Raw detection signals for debugging */
+    signals: string[];
+}
+export interface TestRunnerInfo {
+    name: string;
+    run_command: string;
+    filter_syntax: string;
+}
+export declare function detectProjectMetadata(projectRoot: string): ProjectMetadata;
+export declare function formatMetadataForPrompt(meta: ProjectMetadata): string;
+//# sourceMappingURL=project-metadata.d.ts.map

package/dist/lib/project-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-metadata.d.ts","sourceRoot":"","sources":["../../src/lib/project-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iGAAiG;IACjG,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iCAAiC;IACjC,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,wFAAwF;IACxF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mEAAmE;IACnE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAuX1E;AAqBD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CA8BrE"}