@syntesseraai/opencode-feature-factory 0.4.2 → 0.4.4

package/dist/local-recall/prompt-injection.js

@@ -1,194 +0,0 @@
-import { searchLearningMemories } from './mcp-server.js';
-const MEMORY_CONTEXT_HEADER = '## Local Recall: Relevant Memories';
-const MEMORY_CONTEXT_GUIDANCE = 'Use these prior project learnings only when they directly improve the current response.';
-const DEFAULT_INTERNAL_MARKERS = ['[LOCAL_RECALL_INTERNAL]'];
-const APPROX_CHARS_PER_TOKEN = 4;
-const pendingContextBySession = new Map();
-function parseBooleanEnv(name, fallback) {
-    const value = process.env[name];
-    if (!value) {
-        return fallback;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (['1', 'true', 'yes', 'on'].includes(normalized)) {
-        return true;
-    }
-    if (['0', 'false', 'no', 'off'].includes(normalized)) {
-        return false;
-    }
-    return fallback;
-}
-function parseNumberEnv(name, fallback, options) {
-    const value = process.env[name];
-    if (!value) {
-        return fallback;
-    }
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed)) {
-        return fallback;
-    }
-    const withInteger = options?.integer ? Math.trunc(parsed) : parsed;
-    const min = options?.min ?? Number.NEGATIVE_INFINITY;
-    const max = options?.max ?? Number.POSITIVE_INFINITY;
-    return Math.min(max, Math.max(min, withInteger));
-}
-function parseInternalMarkers() {
-    const configured = process.env.FF_LOCAL_RECALL_PROMPT_INTERNAL_MARKERS;
-    if (!configured) {
-        return DEFAULT_INTERNAL_MARKERS;
-    }
-    const markers = configured
-        .split(',')
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    return markers.length > 0 ? markers : DEFAULT_INTERNAL_MARKERS;
-}
-function getPromptInjectionConfig() {
-    return {
-        enabled: parseBooleanEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_ENABLED', true),
-        minPromptChars: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MIN_PROMPT_CHARS', 20, {
-            min: 1,
-            max: 2000,
-            integer: true,
-        }),
-        maxQueryChars: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MAX_QUERY_CHARS', 2000, {
-            min: 64,
-            max: 20000,
-            integer: true,
-        }),
-        searchLimit: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_SEARCH_LIMIT', 8, {
-            min: 1,
-            max: 50,
-            integer: true,
-        }),
-        maxResults: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MAX_RESULTS', 5, {
-            min: 1,
-            max: 20,
-            integer: true,
-        }),
-        minRelevance: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MIN_RELEVANCE', 0.2, {
-            min: 0,
-            max: 1,
-        }),
-        minImportance: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MIN_IMPORTANCE', 0.2, {
-            min: 0,
-            max: 1,
-        }),
-        maxTokens: parseNumberEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_MAX_TOKENS', 400, {
-            min: 50,
-            max: 4000,
-            integer: true,
-        }),
-        sessionOnly: parseBooleanEnv('FF_LOCAL_RECALL_PROMPT_INJECTION_SESSION_ONLY', false),
-        internalMarkers: parseInternalMarkers(),
-    };
-}
-function estimateTokens(text) {
-    return Math.ceil(text.length / APPROX_CHARS_PER_TOKEN);
-}
-function normalizeInlineText(value) {
-    return value.replace(/\s+/g, ' ').trim();
-}
-function extractUserPromptText(parts) {
-    const text = parts
-        .filter((part) => part.type === 'text')
-        .filter((part) => !part.synthetic)
-        .map((part) => part.text)
-        .join('\n')
-        .trim();
-    return text;
-}
-function isInternalPrompt(prompt, markers) {
-    return markers.some((marker) => marker.length > 0 && prompt.includes(marker));
-}
-function scoreMemory(memory) {
-    return memory.relevance * 0.75 + memory.importance * 0.25;
-}
-function rankMemories(memories, config) {
-    return memories
-        .filter((memory) => memory.relevance >= config.minRelevance)
-        .sort((a, b) => {
-        const scoreDifference = scoreMemory(b) - scoreMemory(a);
-        if (scoreDifference !== 0) {
-            return scoreDifference;
-        }
-        return b.createdAt - a.createdAt;
-    });
-}
-function formatMemoryLine(index, memory) {
-    const title = normalizeInlineText(memory.title);
-    const tags = memory.tags.length > 0 ? ` | tags: ${memory.tags.slice(0, 5).join(', ')}` : '';
-    return `${index}. ${title} (category: ${memory.category}, relevance: ${memory.relevance.toFixed(2)}, importance: ${memory.importance.toFixed(2)}${tags})`;
-}
-function buildMemoryContext(memories, config) {
-    const lines = [];
-    let usedTokens = estimateTokens(MEMORY_CONTEXT_HEADER) + estimateTokens(MEMORY_CONTEXT_GUIDANCE);
-    for (const memory of memories) {
-        if (lines.length >= config.maxResults) {
-            break;
-        }
-        const line = formatMemoryLine(lines.length + 1, memory);
-        const lineTokens = estimateTokens(line);
-        if (lines.length > 0 && usedTokens + lineTokens > config.maxTokens) {
-            break;
-        }
-        lines.push(line);
-        usedTokens += lineTokens;
-    }
-    if (lines.length === 0) {
-        return null;
-    }
-    return [MEMORY_CONTEXT_HEADER, MEMORY_CONTEXT_GUIDANCE, ...lines.map((line) => `- ${line}`)].join('\n');
-}
-export function createLocalRecallPromptHooks(directory) {
-    const config = getPromptInjectionConfig();
-    if (!config.enabled) {
-        return {};
-    }
-    return {
-        'chat.message': async (input, output) => {
-            const promptText = extractUserPromptText(output.parts);
-            if (promptText.length < config.minPromptChars) {
-                pendingContextBySession.delete(input.sessionID);
-                return;
-            }
-            if (isInternalPrompt(promptText, config.internalMarkers)) {
-                pendingContextBySession.delete(input.sessionID);
-                return;
-            }
-            const criteria = {
-                query: promptText.slice(0, config.maxQueryChars),
-                limit: config.searchLimit,
-                minImportance: config.minImportance,
-            };
-            if (config.sessionOnly) {
-                criteria.sessionID = input.sessionID;
-            }
-            try {
-                const searchOutput = await searchLearningMemories(directory, criteria);
-                const ranked = rankMemories(searchOutput.results, config);
-                const context = buildMemoryContext(ranked, config);
-                if (!context) {
-                    pendingContextBySession.delete(input.sessionID);
-                    return;
-                }
-                pendingContextBySession.set(input.sessionID, context);
-            }
-            catch {
-                pendingContextBySession.delete(input.sessionID);
-            }
-        },
-        'experimental.chat.system.transform': async (input, output) => {
-            const sessionID = input.sessionID;
-            if (!sessionID) {
-                return;
-            }
-            const pendingContext = pendingContextBySession.get(sessionID);
-            if (!pendingContext) {
-                return;
-            }
-            output.system.push(pendingContext);
-            pendingContextBySession.delete(sessionID);
-        },
-    };
-}

package/dist/local-recall/session-extractor.d.ts

@@ -1,19 +0,0 @@
-/**
- * session-extractor.ts — Extracts learnings from OpenCode session messages.
- *
- * Scans assistant text parts for reusable knowledge (patterns, decisions,
- * debugging insights, preferences, context, procedures) and returns
- * ExtractionResult[] ready for storage.
- */
-import type { ExtractionInput, ExtractionResult, OCPart } from './types.js';
-/**
- * Extract learnings from a set of text parts for a single message.
- *
- * Each qualifying text part that passes heuristic classification
- * becomes one ExtractionResult.
- */
-export declare function extractFromParts(input: ExtractionInput, parts: OCPart[]): ExtractionResult[];
-/**
- * High-level: extract from a message by reading its parts from storage.
- */
-export declare function extractFromMessage(input: ExtractionInput): Promise<ExtractionResult[]>;

package/dist/local-recall/session-extractor.js

@@ -1,172 +0,0 @@
-/**
- * session-extractor.ts — Extracts learnings from OpenCode session messages.
- *
- * Scans assistant text parts for reusable knowledge (patterns, decisions,
- * debugging insights, preferences, context, procedures) and returns
- * ExtractionResult[] ready for storage.
- */
-import { listParts } from './storage-reader.js';
-const CATEGORY_RULES = [
-    {
-        category: 'pattern',
-        weight: 0.9,
-        patterns: [
-            /\bpattern\b/i,
-            /\bbest practice\b/i,
-            /\bidiom(atic)?\b/i,
-            /\bconvention\b/i,
-            /\balways use\b/i,
-            /\bprefer\s+\w+\s+over\b/i,
-        ],
-    },
-    {
-        category: 'decision',
-        weight: 0.85,
-        patterns: [
-            /\bdecid(e|ed|ing)\b/i,
-            /\bchose\b/i,
-            /\btrade-?off\b/i,
-            /\bwent with\b/i,
-            /\binstead of\b/i,
-            /\bwe (should|chose|picked)\b/i,
-        ],
-    },
-    {
-        category: 'debugging',
-        weight: 0.8,
-        patterns: [
-            /\bbug\b/i,
-            /\bfix(ed|ing)?\b/i,
-            /\berror\b/i,
-            /\broot cause\b/i,
-            /\bwork-?around\b/i,
-            /\bregression\b/i,
-            /\bstack trace\b/i,
-        ],
-    },
-    {
-        category: 'preference',
-        weight: 0.7,
-        patterns: [
-            /\bprefer(ence|red|s)?\b/i,
-            /\bstyle\b/i,
-            /\bdon't like\b/i,
-            /\bfavor\b/i,
-            /\brather\b/i,
-        ],
-    },
-    {
-        category: 'procedure',
-        weight: 0.75,
-        patterns: [
-            /\bstep[- ]?by[- ]?step\b/i,
-            /\bworkflow\b/i,
-            /\bprocedure\b/i,
-            /\bhow to\b/i,
-            /\brecipe\b/i,
-            /\brun(ning)?\s+(the|this)?\s*command\b/i,
-        ],
-    },
-    {
-        category: 'context',
-        weight: 0.6,
-        patterns: [
-            /\barchitecture\b/i,
-            /\bdesign\b/i,
-            /\bconstraint\b/i,
-            /\brequirement\b/i,
-            /\binfrastructure\b/i,
-            /\bstack\b/i,
-        ],
-    },
-];
-// ────────────────────────────────────────────────────────────
-// Helpers
-// ────────────────────────────────────────────────────────────
-/** Score text against category rules and return best match (if any). */
-function classifyText(text) {
-    let best = null;
-    for (const rule of CATEGORY_RULES) {
-        let hits = 0;
-        for (const pat of rule.patterns) {
-            if (pat.test(text))
-                hits++;
-        }
-        if (hits === 0)
-            continue;
-        const confidence = Math.min(1, (hits / rule.patterns.length) * rule.weight);
-        if (!best || confidence > best.confidence) {
-            best = { category: rule.category, confidence };
-        }
-    }
-    return best;
-}
-/** Derive a short title from the first meaningful sentence. */
-function deriveTitle(text) {
-    const firstLine = text.split(/\n/).find((l) => l.trim().length > 10) ?? text;
-    const trimmed = firstLine.replace(/^#+\s*/, '').trim();
-    return trimmed.length > 120 ? trimmed.slice(0, 117) + '...' : trimmed;
-}
-/** Extract simple tags from text. */
-function deriveTags(text) {
-    const tags = new Set();
-    // Language mentions
-    const langs = text.match(/\b(TypeScript|JavaScript|Python|Rust|Go|Java|C\+\+|Ruby|Swift|Kotlin)\b/gi);
-    if (langs)
-        langs.forEach((l) => tags.add(l.toLowerCase()));
-    // Framework mentions
-    const frameworks = text.match(/\b(React|Next\.?js|Vue|Angular|Express|Django|Flask|Spring|Rails)\b/gi);
-    if (frameworks)
-        frameworks.forEach((f) => tags.add(f.toLowerCase()));
-    // Tool mentions
-    const tools = text.match(/\b(Docker|Kubernetes|Terraform|AWS|GCP|Azure|GitHub|GitLab)\b/gi);
-    if (tools)
-        tools.forEach((t) => tags.add(t.toLowerCase()));
-    return [...tags].slice(0, 10);
-}
-// ────────────────────────────────────────────────────────────
-// Minimum thresholds
-// ────────────────────────────────────────────────────────────
-/** Minimum text length to consider for extraction. */
-const MIN_TEXT_LENGTH = 80;
-/** Minimum confidence to accept a classification. */
-const MIN_CONFIDENCE = 0.15;
-// ────────────────────────────────────────────────────────────
-// Public API
-// ────────────────────────────────────────────────────────────
-/**
- * Extract learnings from a set of text parts for a single message.
- *
- * Each qualifying text part that passes heuristic classification
- * becomes one ExtractionResult.
- */
-export function extractFromParts(input, parts) {
-    const results = [];
-    for (const part of parts) {
-        if (part.type !== 'text' || !part.text)
-            continue;
-        if (part.text.length < MIN_TEXT_LENGTH)
-            continue;
-        const classification = classifyText(part.text);
-        if (!classification || classification.confidence < MIN_CONFIDENCE)
-            continue;
-        results.push({
-            sessionID: input.sessionID,
-            messageID: input.messageID,
-            category: classification.category,
-            title: deriveTitle(part.text),
-            body: part.text,
-            tags: deriveTags(part.text),
-            importance: classification.confidence,
-            source: 'session',
-        });
-    }
-    return results;
-}
-/**
- * High-level: extract from a message by reading its parts from storage.
- */
-export async function extractFromMessage(input) {
-    const parts = await listParts(input.messageID);
-    return extractFromParts(input, parts);
-}

package/dist/local-recall/storage-reader.d.ts

@@ -1,40 +0,0 @@
-/**
- * OpenCode Storage Readers
- *
- * Reads OpenCode's native JSON storage from ~/.local/share/opencode/storage/
- * with adapters for project, session, message, and part entities.
- */
-import type { OCProject, OCSession, OCMessage, OCPart } from './types.js';
-/**
- * Find the project record whose worktree matches `directory`.
- * The project hash is a SHA-1 of the worktree path.
- */
-export declare function findProject(directory: string): Promise<OCProject | null>;
-/**
- * List all known projects.
- */
-export declare function listProjects(): Promise<OCProject[]>;
-/**
- * List sessions for a given project hash.
- */
-export declare function listSessions(projectID: string): Promise<OCSession[]>;
-/**
- * Get a single session by its ID within a project.
- */
-export declare function getSession(projectID: string, sessionID: string): Promise<OCSession | null>;
-/**
- * List all messages in a session, sorted by creation time.
- */
-export declare function listMessages(sessionID: string): Promise<OCMessage[]>;
-/**
- * Get a single message by ID.
- */
-export declare function getMessage(sessionID: string, messageID: string): Promise<OCMessage | null>;
-/**
- * List all parts for a given message, sorted by start time.
- */
-export declare function listParts(messageID: string): Promise<OCPart[]>;
-/**
- * Get a single part by ID.
- */
-export declare function getPart(messageID: string, partID: string): Promise<OCPart | null>;

package/dist/local-recall/storage-reader.js

@@ -1,157 +0,0 @@
-/**
- * OpenCode Storage Readers
- *
- * Reads OpenCode's native JSON storage from ~/.local/share/opencode/storage/
- * with adapters for project, session, message, and part entities.
- */
-import { readFile, readdir, stat, realpath } from 'fs/promises';
-import { join } from 'path';
-import { homedir } from 'os';
-// ── Storage base path ───────────────────────────────────────────
-function getStorageBase() {
-    return join(homedir(), '.local', 'share', 'opencode', 'storage');
-}
-// ── Helpers ─────────────────────────────────────────────────────
-async function readJsonFile(filePath) {
-    const raw = await readFile(filePath, 'utf-8');
-    return JSON.parse(raw);
-}
-async function readAllJsonInDir(dirPath) {
-    try {
-        const entries = await readdir(dirPath);
-        const jsonFiles = entries.filter((e) => e.endsWith('.json'));
-        const results = [];
-        for (const file of jsonFiles) {
-            try {
-                const data = await readJsonFile(join(dirPath, file));
-                results.push(data);
-            }
-            catch {
-                // Skip malformed files
-            }
-        }
-        return results;
-    }
-    catch {
-        return [];
-    }
-}
-async function dirExists(dirPath) {
-    try {
-        const s = await stat(dirPath);
-        return s.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-function getPartStartTime(part) {
-    const start = part.time?.start;
-    return typeof start === 'number' ? start : Number.POSITIVE_INFINITY;
-}
-// ── Project Reader ──────────────────────────────────────────────
-/**
- * Find the project record whose worktree matches `directory`.
- * The project hash is a SHA-1 of the worktree path.
- */
-export async function findProject(directory) {
-    const projectDir = join(getStorageBase(), 'project');
-    const projects = await readAllJsonInDir(projectDir);
-    // Normalise both sides so symlinks / trailing slashes don't cause mismatches
-    let normalisedInput;
-    try {
-        normalisedInput = await realpath(directory);
-    }
-    catch {
-        normalisedInput = directory; // fallback when directory doesn't exist yet
-    }
-    for (const p of projects) {
-        let normalisedWorktree;
-        try {
-            normalisedWorktree = await realpath(p.worktree);
-        }
-        catch {
-            normalisedWorktree = p.worktree;
-        }
-        if (normalisedWorktree === normalisedInput || p.worktree === directory) {
-            return p;
-        }
-    }
-    return null;
-}
-/**
- * List all known projects.
- */
-export async function listProjects() {
-    return readAllJsonInDir(join(getStorageBase(), 'project'));
-}
-// ── Session Reader ──────────────────────────────────────────────
-/**
- * List sessions for a given project hash.
- */
-export async function listSessions(projectID) {
-    const sessionDir = join(getStorageBase(), 'session', projectID);
-    return readAllJsonInDir(sessionDir);
-}
-/**
- * Get a single session by its ID within a project.
- */
-export async function getSession(projectID, sessionID) {
-    const sessionDir = join(getStorageBase(), 'session', projectID);
-    try {
-        return await readJsonFile(join(sessionDir, `${sessionID}.json`));
-    }
-    catch {
-        return null;
-    }
-}
-// ── Message Reader ──────────────────────────────────────────────
-/**
- * List all messages in a session, sorted by creation time.
- */
-export async function listMessages(sessionID) {
-    const msgDir = join(getStorageBase(), 'message', sessionID);
-    const messages = await readAllJsonInDir(msgDir);
-    return messages.sort((a, b) => a.time.created - b.time.created);
-}
-/**
- * Get a single message by ID.
- */
-export async function getMessage(sessionID, messageID) {
-    const msgDir = join(getStorageBase(), 'message', sessionID);
-    try {
-        return await readJsonFile(join(msgDir, `${messageID}.json`));
-    }
-    catch {
-        return null;
-    }
-}
-// ── Part Reader ─────────────────────────────────────────────────
-/**
- * List all parts for a given message, sorted by start time.
- */
-export async function listParts(messageID) {
-    const partDir = join(getStorageBase(), 'part', messageID);
-    if (!(await dirExists(partDir)))
-        return [];
-    const parts = await readAllJsonInDir(partDir);
-    return parts.sort((a, b) => {
-        const timeDelta = getPartStartTime(a) - getPartStartTime(b);
-        if (timeDelta !== 0) {
-            return timeDelta;
-        }
-        return a.id.localeCompare(b.id);
-    });
-}
-/**
- * Get a single part by ID.
- */
-export async function getPart(messageID, partID) {
-    const partDir = join(getStorageBase(), 'part', messageID);
-    try {
-        return await readJsonFile(join(partDir, `${partID}.json`));
-    }
-    catch {
-        return null;
-    }
-}

package/dist/local-recall/thinking-extractor.d.ts

@@ -1,16 +0,0 @@
-/**
- * thinking-extractor.ts — Extracts learnings from "thinking" / reasoning blocks.
- *
- * OpenCode stores extended-thinking or chain-of-thought content in parts
- * with type "reasoning" or "thinking". These often contain high-signal insights about
- * decision making and problem solving that are worth capturing.
- */
-import type { ExtractionInput, ExtractionResult, OCPart } from './types.js';
-/**
- * Extract learnings specifically from reasoning/thinking parts.
- */
-export declare function extractFromThinkingParts(input: ExtractionInput, parts: OCPart[]): ExtractionResult[];
-/**
- * High-level: extract thinking-based learnings from a message.
- */
-export declare function extractThinkingFromMessage(input: ExtractionInput): Promise<ExtractionResult[]>;