@phren/cli/dist/core/finding.js

Knowledge layer for AI agents - CLI, MCP server, and data layer

import { isValidProjectName } from "../utils.js";
import { addFindingToFile, } from "../shared/content.js";
import { removeFinding as removeFindingStore, } from "../data/access.js";
import { MAX_FINDING_LENGTH } from "../content/validate.js";
const FINDING_TAG_PREFIX_RE = /^\s*\[[^\]]+\]\s*/;
/**
 * Prepend `[findingType]` to a finding only when the text doesn't already
 * start with a bracketed tag. Prevents accumulation like `[pattern] [pattern] X`
 * when callers pass both `findingType` and a finding that's already tagged
 * (a common shape — many MCP callers prefix manually for human readability).
 */
export function applyFindingTypePrefix(finding, findingType) {
    if (!findingType)
        return finding;
    if (FINDING_TAG_PREFIX_RE.test(finding))
        return finding;
    return `[${findingType}] ${finding}`;
}
/**
 * Validate and add a single finding. Shared validation logic used by
 * both CLI `phren add-finding` and MCP `add_finding` tool.
 */
export function addFinding(phrenPath, project, finding, citation, findingType) {
    if (!isValidProjectName(project)) {
        return { ok: false, message: `Invalid project name: "${project}"` };
    }
    if (finding.length > MAX_FINDING_LENGTH) {
        return { ok: false, message: `Finding text exceeds ${MAX_FINDING_LENGTH} character limit.` };
    }
    const taggedFinding = applyFindingTypePrefix(finding, findingType);
    const result = addFindingToFile(phrenPath, project, taggedFinding, citation);
    if (!result.ok) {
        return { ok: false, message: result.error };
    }
    return { ok: true, message: result.data.message, data: { project, finding: taggedFinding } };
}
/**
 * Remove a finding by partial text match.
 */
export function removeFinding(phrenPath, project, finding) {
    if (!isValidProjectName(project)) {
        return { ok: false, message: `Invalid project name: "${project}"` };
    }
    const result = removeFindingStore(phrenPath, project, finding);
    if (!result.ok) {
        return { ok: false, message: result.error };
    }
    return { ok: true, message: result.data, data: { project, finding } };
}
/**
 * Remove multiple findings by partial text match.
 */
export function removeFindings(phrenPath, project, findings) {
    if (!isValidProjectName(project)) {
        return { ok: false, message: `Invalid project name: "${project}"` };
    }
    const results = [];
    for (const finding of findings) {
        const result = removeFindingStore(phrenPath, project, finding);
        results.push({ finding, ok: result.ok, message: result.ok ? result.data : result.error ?? "unknown error" });
    }
    const succeeded = results.filter(r => r.ok).length;
    return {
        ok: succeeded > 0,
        message: `Removed ${succeeded}/${findings.length} findings`,
        data: { project, results },
    };
}