@promptwheel/mcp 0.6.0

package/dist/learnings.js

@@ -0,0 +1,117 @@
+/**
+ * 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 * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+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 (err) {
+        console.warn(`[promptwheel] failed to parse learnings.json: ${err instanceof Error ? err.message : String(err)}`);
+        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)
+// ---------------------------------------------------------------------------
+/**
+ * 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);
+    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);
+}
+/**
+ * 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/learnings.js.map

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

package/dist/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/project-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-metadata.d.ts","sourceRoot":"","sources":["../src/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,CAue1E;AA+BD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CA8BrE"}