ori-memory 0.2.0

package/dist/core/linkdetect.js

@@ -0,0 +1,181 @@
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Build a regex that matches a note title in body text.
+ * Slug-aware: dashes in titles also match spaces, and vice versa.
+ */
+function titleToPattern(title) {
+    // Replace dashes with a pattern that matches dash or space
+    const flexible = escapeRegex(title).replace(/-/g, "[-\\s]");
+    return new RegExp(`\\b${flexible}\\b`, "gi");
+}
+/**
+ * Check if the match at `offset` is already inside [[...]]
+ */
+function isInsideWikiLink(body, offset) {
+    // Walk backwards from offset looking for [[ without ]]
+    let i = offset - 1;
+    while (i >= 1) {
+        if (body[i] === "[" && body[i - 1] === "[") {
+            // Found [[ before this position — check no ]] between [[ and offset
+            const between = body.slice(i + 1, offset);
+            if (!between.includes("]]")) {
+                return true;
+            }
+        }
+        if (body[i] === "]" && i > 0 && body[i - 1] === "]") {
+            // Found ]] before reaching [[, so we're not inside a link
+            break;
+        }
+        i--;
+    }
+    return false;
+}
+/**
+ * Scan body text for mentions of existing note titles.
+ * Returns detected mentions sorted by offset.
+ * Skips mentions already wrapped in [[]].
+ */
+export function detectLinks(body, existingTitles) {
+    // Sort longest first to avoid partial matches
+    const sorted = [...existingTitles].sort((a, b) => b.length - a.length);
+    const results = [];
+    const covered = new Set(); // track covered character positions
+    for (const title of sorted) {
+        if (title.length === 0)
+            continue;
+        const pattern = titleToPattern(title);
+        let match;
+        while ((match = pattern.exec(body)) !== null) {
+            const offset = match.index;
+            const length = match[0].length;
+            // Skip if any position in this range is already covered
+            let overlaps = false;
+            for (let p = offset; p < offset + length; p++) {
+                if (covered.has(p)) {
+                    overlaps = true;
+                    break;
+                }
+            }
+            if (overlaps)
+                continue;
+            const alreadyLinked = isInsideWikiLink(body, offset);
+            results.push({ title, offset, length, alreadyLinked });
+            // Mark positions as covered
+            for (let p = offset; p < offset + length; p++) {
+                covered.add(p);
+            }
+        }
+    }
+    return results.sort((a, b) => a.offset - b.offset);
+}
+/**
+ * Apply detected links to body text, wrapping unlinked mentions in [[]].
+ * Processes from end to start to preserve offsets.
+ */
+export function applyLinks(body, links) {
+    // Filter to only unlinked, sort by offset descending
+    const toApply = links
+        .filter((l) => !l.alreadyLinked)
+        .sort((a, b) => b.offset - a.offset);
+    let result = body;
+    for (const link of toApply) {
+        const before = result.slice(0, link.offset);
+        const after = result.slice(link.offset + link.length);
+        result = `${before}[[${link.title}]]${after}`;
+    }
+    return result;
+}
+/**
+ * Suggest structural connections via graph heuristics.
+ * No LLM — pure computation over vault metadata and link graph.
+ */
+export function suggestLinks(frontmatter, body, vaultIndex) {
+    const suggestions = new Map();
+    const noteProject = Array.isArray(frontmatter.project)
+        ? frontmatter.project
+        : [];
+    const noteTags = Array.isArray(frontmatter.tags)
+        ? frontmatter.tags
+        : [];
+    // Title match suggestions (from detectLinks)
+    const detected = detectLinks(body, vaultIndex.titles);
+    for (const link of detected) {
+        if (!link.alreadyLinked) {
+            suggestions.set(link.title, {
+                title: link.title,
+                reason: "title-match",
+                confidence: 0.9,
+            });
+        }
+    }
+    // Project overlap
+    if (noteProject.length > 0) {
+        for (const [title, fm] of vaultIndex.frontmatter) {
+            if (suggestions.has(title))
+                continue;
+            const otherProject = Array.isArray(fm.project)
+                ? fm.project
+                : [];
+            const overlap = noteProject.filter((p) => otherProject.includes(p));
+            if (overlap.length > 0) {
+                suggestions.set(title, {
+                    title,
+                    reason: "project-overlap",
+                    confidence: 0.6 + overlap.length * 0.1,
+                });
+            }
+        }
+    }
+    // Tag overlap
+    if (noteTags.length > 0) {
+        for (const [title, fm] of vaultIndex.frontmatter) {
+            if (suggestions.has(title))
+                continue;
+            const otherTags = Array.isArray(fm.tags) ? fm.tags : [];
+            const overlap = noteTags.filter((t) => otherTags.includes(t));
+            if (overlap.length > 0) {
+                suggestions.set(title, {
+                    title,
+                    reason: "tag-overlap",
+                    confidence: 0.5 + overlap.length * 0.1,
+                });
+            }
+        }
+    }
+    // Shared neighborhood (triangle closing)
+    // If the new note links to X, and Y also links to X (or X links to Y),
+    // suggest Y as a connection.
+    const myLinks = new Set(detected.filter((d) => !d.alreadyLinked).map((d) => d.title));
+    for (const linkedTitle of myLinks) {
+        // Find other notes that also link to linkedTitle
+        const coLinkers = vaultIndex.graph.incoming.get(linkedTitle);
+        if (coLinkers) {
+            for (const coLinker of coLinkers) {
+                if (suggestions.has(coLinker) || myLinks.has(coLinker))
+                    continue;
+                suggestions.set(coLinker, {
+                    title: coLinker,
+                    reason: "shared-neighborhood",
+                    confidence: 0.5,
+                });
+            }
+        }
+        // Find notes that linkedTitle links to
+        const outgoing = vaultIndex.graph.outgoing.get(linkedTitle);
+        if (outgoing) {
+            for (const target of outgoing) {
+                if (suggestions.has(target) || myLinks.has(target))
+                    continue;
+                suggestions.set(target, {
+                    title: target,
+                    reason: "shared-neighborhood",
+                    confidence: 0.45,
+                });
+            }
+        }
+    }
+    return Array.from(suggestions.values()).sort((a, b) => b.confidence - a.confidence);
+}
+//# sourceMappingURL=linkdetect.js.map

package/dist/core/linkdetect.js.map

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

package/dist/core/llm.d.ts

@@ -0,0 +1,41 @@
+export type VaultContext = {
+    existingTitles: string[];
+    recentNotes: Array<{
+        title: string;
+        type: string;
+        description: string;
+    }>;
+    projectTags: string[];
+};
+export type EnhancementSuggestions = {
+    type?: string;
+    description?: string;
+    links?: string[];
+    project?: string[];
+    areas?: string[];
+    reasoning?: string;
+};
+export type LlmConfig = {
+    provider: string | null;
+    model: string | null;
+    api_key_env: string | null;
+};
+export declare const DEFAULT_LLM_CONFIG: LlmConfig;
+export interface LlmProvider {
+    enhance(note: {
+        title: string;
+        body: string;
+        frontmatter: Record<string, unknown>;
+    }, context: VaultContext): Promise<EnhancementSuggestions>;
+}
+/**
+ * Null provider: returns empty suggestions (pure deterministic path).
+ */
+export declare class NullProvider implements LlmProvider {
+    enhance(): Promise<EnhancementSuggestions>;
+}
+/**
+ * Create provider from config. Returns NullProvider when provider is null.
+ */
+export declare function createProvider(config: LlmConfig): Promise<LlmProvider>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/core/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/core/llm.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,OAAO,CACL,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,EACD,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,WAAW;IACxC,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC;CAGjD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB5E"}

package/dist/core/llm.js

@@ -0,0 +1,36 @@
+export const DEFAULT_LLM_CONFIG = {
+    provider: null,
+    model: null,
+    api_key_env: null,
+};
+/**
+ * Null provider: returns empty suggestions (pure deterministic path).
+ */
+export class NullProvider {
+    async enhance() {
+        return {};
+    }
+}
+/**
+ * Create provider from config. Returns NullProvider when provider is null.
+ */
+export async function createProvider(config) {
+    if (!config.provider) {
+        return new NullProvider();
+    }
+    const apiKey = config.api_key_env
+        ? process.env[config.api_key_env]
+        : undefined;
+    if (!apiKey) {
+        return new NullProvider();
+    }
+    switch (config.provider) {
+        case "anthropic": {
+            const { AnthropicProvider } = await import("../providers/anthropic.js");
+            return new AnthropicProvider(apiKey, config.model ?? "claude-sonnet-4-20250514");
+        }
+        default:
+            return new NullProvider();
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/core/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/core/llm.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI;CAClB,CAAC;AAaF;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,OAAO;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAiB;IACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW;QAC/B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;QACjC,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACxE,OAAO,IAAI,iBAAiB,CAC1B,MAAM,EACN,MAAM,CAAC,KAAK,IAAI,0BAA0B,CAC3C,CAAC;QACJ,CAAC;QACD;YACE,OAAO,IAAI,YAAY,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/core/promote.d.ts

@@ -0,0 +1,40 @@
+import { type ClassificationResult, type ProjectKeywordConfig } from "./classify.js";
+import { type DetectedLink, type LinkSuggestion, type VaultIndex } from "./linkdetect.js";
+export type PromoteOverrides = {
+    type?: string;
+    description?: string;
+    links?: string[];
+    project?: string[];
+};
+export type PromoteInput = {
+    inboxPath: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    existingTitles: string[];
+    vaultIndex: VaultIndex;
+    overrides: PromoteOverrides;
+    projectConfig: ProjectKeywordConfig;
+    mapRouting: Record<string, string>;
+    defaultArea: string;
+};
+export type PromoteResult = {
+    updatedFrontmatter: Record<string, unknown>;
+    updatedBody: string;
+    destinationFilename: string;
+    classification: ClassificationResult;
+    detectedLinks: DetectedLink[];
+    suggestedLinks: LinkSuggestion[];
+    suggestedAreas: string[];
+    changes: string[];
+    warnings: string[];
+};
+/**
+ * Inject footers with idempotency: parse existing, merge, dedupe, write once.
+ */
+export declare function injectFooters(body: string, areas: string[], links: string[]): string;
+/**
+ * Compute the promotion result without performing any I/O.
+ * The caller (CLI or MCP) handles file move, validation, etc.
+ */
+export declare function computePromotion(input: PromoteInput): PromoteResult;
+//# sourceMappingURL=promote.d.ts.map

package/dist/core/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/core/promote.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,oBAAoB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,oBAAoB,CAAC;IACrC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAoHF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAcR;AAuCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA4JnE"}

package/dist/core/promote.js

@@ -0,0 +1,246 @@
+import { classifyNoteType, detectProjects, } from "./classify.js";
+import { detectLinks, applyLinks, suggestLinks, } from "./linkdetect.js";
+const AUTO_APPLY_THRESHOLD = 0.8;
+/**
+ * Parse an existing footer section from the body.
+ * Looks for "## <heading>" or "<heading>:" followed by lines starting with "- ".
+ */
+function parseFooter(body, heading) {
+    // Match both "## Areas" and "Areas:" formats
+    const patterns = [
+        new RegExp(`^##\\s+${escapeRegex(heading)}\\s*$`, "m"),
+        new RegExp(`^${escapeRegex(heading)}:\\s*$`, "m"),
+    ];
+    for (const pattern of patterns) {
+        const match = pattern.exec(body);
+        if (!match)
+            continue;
+        const startIdx = match.index + match[0].length;
+        const items = [];
+        const remaining = body.slice(startIdx);
+        const lines = remaining.split("\n");
+        const knownHeadings = ["Relevant Notes", "Areas"];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("- ")) {
+                // Extract wiki-link title from "- [[title]]" or "- [[title]] -- reason"
+                const linkMatch = trimmed.match(/^-\s+\[\[([^\]]+)\]\]/);
+                if (linkMatch) {
+                    items.push(linkMatch[1]);
+                }
+            }
+            else if (trimmed.length === 0) {
+                continue;
+            }
+            else if (trimmed.startsWith("#") ||
+                trimmed.startsWith("---") ||
+                knownHeadings.some((h) => trimmed === `${h}:` || trimmed === `## ${h}`)) {
+                break;
+            }
+        }
+        return items;
+    }
+    return [];
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Strip existing footer sections (Areas and Relevant Notes) from body.
+ * Line-based approach for reliability.
+ */
+function stripFooters(body) {
+    const headings = ["Relevant Notes", "Areas"];
+    const lines = body.split("\n");
+    const kept = [];
+    let inFooterSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check if this line starts a footer section
+        const isHeading = headings.some((h) => trimmed === `${h}:` ||
+            trimmed === `## ${h}` ||
+            trimmed.startsWith(`${h}:`));
+        if (isHeading) {
+            inFooterSection = true;
+            continue;
+        }
+        if (inFooterSection) {
+            // Stay in footer section for list items and blank lines
+            if (trimmed.startsWith("- ") || trimmed === "") {
+                continue;
+            }
+            // Non-list, non-blank line exits the footer section
+            inFooterSection = false;
+        }
+        kept.push(line);
+    }
+    return kept.join("\n").trimEnd();
+}
+/**
+ * Format footer sections.
+ */
+function formatFooters(areas, links) {
+    let footer = "";
+    if (links.length > 0) {
+        footer += "\n\nRelevant Notes:";
+        for (const link of links) {
+            footer += `\n- [[${link}]]`;
+        }
+    }
+    if (areas.length > 0) {
+        footer += "\n\nAreas:";
+        for (const area of areas) {
+            footer += `\n- [[${area}]]`;
+        }
+    }
+    return footer + "\n";
+}
+/**
+ * Inject footers with idempotency: parse existing, merge, dedupe, write once.
+ */
+export function injectFooters(body, areas, links) {
+    const existingAreas = parseFooter(body, "Areas");
+    const existingLinks = parseFooter(body, "Relevant Notes");
+    const mergedAreas = [...new Set([...existingAreas, ...areas])];
+    const mergedLinks = [...new Set([...existingLinks, ...links])];
+    const cleanBody = stripFooters(body);
+    if (mergedAreas.length === 0 && mergedLinks.length === 0) {
+        return cleanBody + "\n";
+    }
+    return cleanBody + formatFooters(mergedAreas, mergedLinks);
+}
+/**
+ * Resolve areas for a note based on project tags and map routing config.
+ * Fallback chain: config routing → keyword match on map titles → defaultArea.
+ */
+function resolveAreas(projects, mapRouting, existingTitles, defaultArea) {
+    const areas = [];
+    for (const project of projects) {
+        // Direct config routing
+        if (mapRouting[project]) {
+            areas.push(mapRouting[project]);
+            continue;
+        }
+        // Keyword match against existing map titles (titles containing "map")
+        const mapTitle = existingTitles.find((t) => t.toLowerCase().includes(project.toLowerCase()) &&
+            t.toLowerCase().includes("map"));
+        if (mapTitle) {
+            areas.push(mapTitle);
+        }
+    }
+    // Ensure at least one area — zero orphans from promotion
+    if (areas.length === 0) {
+        areas.push(defaultArea);
+    }
+    return [...new Set(areas)];
+}
+/**
+ * Compute the promotion result without performing any I/O.
+ * The caller (CLI or MCP) handles file move, validation, etc.
+ */
+export function computePromotion(input) {
+    const { inboxPath, frontmatter, body, existingTitles, vaultIndex, overrides, projectConfig, mapRouting, defaultArea, } = input;
+    const changes = [];
+    const warnings = [];
+    // 1. Classify type
+    const classification = classifyNoteType(titleFromPath(inboxPath), body, overrides.type ?? frontmatter.type);
+    if (classification.confidence === "low" && !overrides.type) {
+        warnings.push(`Low-confidence type classification: ${classification.type} (${classification.reason}). Use --type to override.`);
+    }
+    if (overrides.type && overrides.type !== frontmatter.type) {
+        changes.push(`type: ${frontmatter.type ?? "unset"} → ${overrides.type}`);
+    }
+    else if (classification.type !== frontmatter.type) {
+        changes.push(`type classified as ${classification.type} (${classification.confidence} confidence)`);
+    }
+    // 2. Detect projects
+    let projects;
+    if (overrides.project && overrides.project.length > 0) {
+        projects = overrides.project;
+        changes.push(`project set to: ${projects.join(", ")}`);
+    }
+    else if (Array.isArray(frontmatter.project) &&
+        frontmatter.project.length > 0) {
+        projects = frontmatter.project;
+    }
+    else {
+        projects = detectProjects(titleFromPath(inboxPath), body, projectConfig);
+        if (projects.length > 0) {
+            changes.push(`project detected: ${projects.join(", ")}`);
+        }
+        else {
+            warnings.push("No project detected. Consider adding --project.");
+        }
+    }
+    // 3. Detect wiki-links in body text
+    const detectedLinks = detectLinks(body, existingTitles);
+    const unlinked = detectedLinks.filter((l) => !l.alreadyLinked);
+    if (unlinked.length > 0) {
+        changes.push(`auto-linked ${unlinked.length} mention(s) in body`);
+    }
+    // 4. Suggest structural links
+    const allSuggested = suggestLinks({ ...frontmatter, project: projects }, body, vaultIndex);
+    // Auto-apply high-confidence suggestions
+    const autoApplied = allSuggested.filter((s) => s.confidence >= AUTO_APPLY_THRESHOLD);
+    const manualSuggestions = allSuggested.filter((s) => s.confidence < AUTO_APPLY_THRESHOLD);
+    if (manualSuggestions.length > 0) {
+        changes.push(`suggested ${manualSuggestions.length} connection(s): ${manualSuggestions.map((s) => s.title).join(", ")}`);
+    }
+    // 5. Apply links to body
+    let updatedBody = applyLinks(body, detectedLinks);
+    // Add override links if provided
+    if (overrides.links && overrides.links.length > 0) {
+        changes.push(`added ${overrides.links.length} explicit link(s): ${overrides.links.join(", ")}`);
+    }
+    // 6. Resolve areas
+    const suggestedAreas = resolveAreas(projects, mapRouting, existingTitles, defaultArea);
+    changes.push(`assigned to area(s): ${suggestedAreas.join(", ")}`);
+    // 7. Inject footers (idempotent)
+    const allLinks = [
+        ...autoApplied.map((s) => s.title),
+        ...(overrides.links ?? []),
+    ];
+    updatedBody = injectFooters(updatedBody, suggestedAreas, allLinks);
+    // 8. Update frontmatter
+    const updatedFrontmatter = {
+        ...frontmatter,
+        status: "active",
+        type: classification.type,
+        project: projects.length > 0 ? projects : frontmatter.project,
+        last_accessed: new Date().toISOString().split("T")[0],
+        access_count: (typeof frontmatter.access_count === "number"
+            ? frontmatter.access_count
+            : 0) + 1,
+    };
+    if (overrides.description) {
+        updatedFrontmatter.description = overrides.description;
+        changes.push("description updated via override");
+    }
+    else if (!frontmatter.description ||
+        (typeof frontmatter.description === "string" &&
+            frontmatter.description.trim().length === 0)) {
+        warnings.push('No description found. Add with --description "..." or configure LLM.');
+    }
+    changes.push("status: inbox → active");
+    // 9. Derive destination filename
+    const filename = inboxPath.split(/[/\\]/).pop() ?? "note.md";
+    const destinationFilename = filename.endsWith(".md")
+        ? filename
+        : `${filename}.md`;
+    return {
+        updatedFrontmatter,
+        updatedBody,
+        destinationFilename,
+        classification,
+        detectedLinks,
+        suggestedLinks: allSuggested,
+        suggestedAreas,
+        changes,
+        warnings,
+    };
+}
+function titleFromPath(filePath) {
+    const filename = filePath.split(/[/\\]/).pop() ?? "";
+    return filename.replace(/\.md$/, "").replace(/-/g, " ");
+}
+//# sourceMappingURL=promote.js.map

package/dist/core/promote.js.map

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

package/dist/core/ranking.d.ts

@@ -0,0 +1,33 @@
+export interface ScoredNote {
+    title: string;
+    score: number;
+    signals: {
+        composite?: number;
+        keyword?: number;
+        graph?: number;
+        rrf?: number;
+    };
+    spaces?: {
+        text: number;
+        temporal: number;
+        vitality: number;
+        importance: number;
+        type: number;
+        community: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Rank notes by graph importance (PageRank scores).
+ */
+export declare function rankByImportance(notes: string[], pagerankScores: Map<string, number>, limit?: number): ScoredNote[];
+/**
+ * Find notes that are fading (below vitality threshold).
+ * Sorted ascending — most fading first.
+ */
+export declare function rankByFading(notes: string[], vitalityScores: Map<string, number>, threshold?: number): ScoredNote[];
+/**
+ * Rank notes by vitality score (descending).
+ */
+export declare function rankByVitality(notes: string[], vitalityScores: Map<string, number>, limit?: number): ScoredNote[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/core/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/core/ranking.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,KAAK,CAAC,EAAE,MAAM,GACb,UAAU,EAAE,CASd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,SAAS,GAAE,MAAY,GACtB,UAAU,EAAE,CAiBd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,KAAK,CAAC,EAAE,MAAM,GACb,UAAU,EAAE,CASd"}