agent-recall-core 3.4.18 → 3.4.21

package/dist/palace/pipeline.js

@@ -0,0 +1,289 @@
+/**
+ * Pipeline layer — project milestone narrative spine.
+ * Stored under palace/pipeline/NNNN-phase-slug.md, one file per phase.
+ * Distinct from journal (chronology), palace/rooms (facts), awareness (cross-project).
+ *
+ * Hardening notes:
+ * - Order numbers sorted numerically (lex sort breaks at 10).
+ * - Atomic writes via tmp+rename (writeFileSync is not crash-safe).
+ * - Section parser only ends at the four KNOWN headings, so user-supplied
+ *   "## Anything" inside a section body cannot break it.
+ * - Frontmatter parser accepts both quoted (JSON-encoded) and bare scalars.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir, sanitizeSlug } from "../storage/paths.js";
+import { ensureDir } from "../storage/fs-utils.js";
+import { generateFrontmatter } from "./obsidian.js";
+const PLACEHOLDER = "(in progress)";
+const ORDER_PAD = 4;
+const KNOWN_SECTIONS = ["Goal", "What was hard", "How solved", "Synthesis"];
+export function pipelineDir(project) {
+    return path.join(palaceDir(project), "pipeline");
+}
+export function zeroPad(n, width = ORDER_PAD) {
+    return n.toString().padStart(width, "0");
+}
+export function milestoneFileName(order, phase) {
+    return `${zeroPad(order)}-${sanitizeSlug(phase)}.md`;
+}
+/**
+ * Parse a quoted YAML scalar back to its native string.
+ * Handles both JSON-encoded (`"with \n escapes"`) and bare values.
+ */
+function parseScalar(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "" || trimmed === "null" || trimmed === "~")
+        return null;
+    if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            // Fall through — return raw stripped quotes
+            return trimmed.slice(1, -1);
+        }
+    }
+    if (/^-?\d+$/.test(trimmed))
+        return Number(trimmed);
+    return trimmed;
+}
+function parseFrontmatter(raw) {
+    // Accept LF or CRLF after the closing ---
+    const match = raw.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: raw };
+    const meta = {};
+    for (const line of match[1].split(/\r?\n/)) {
+        const idx = line.indexOf(":");
+        if (idx < 0)
+            continue;
+        const key = line.slice(0, idx).trim();
+        const rawValue = line.slice(idx + 1).trim();
+        if (!key)
+            continue;
+        if (rawValue.startsWith("[") && rawValue.endsWith("]")) {
+            const inner = rawValue.slice(1, -1).trim();
+            if (!inner) {
+                meta[key] = [];
+            }
+            else {
+                // Split on commas that are NOT inside quoted strings
+                const items = [];
+                let depth = 0;
+                let cur = "";
+                let inQuote = false;
+                for (const ch of inner) {
+                    if (ch === '"' && cur[cur.length - 1] !== "\\")
+                        inQuote = !inQuote;
+                    if (ch === "," && !inQuote && depth === 0) {
+                        items.push(cur.trim());
+                        cur = "";
+                    }
+                    else {
+                        cur += ch;
+                    }
+                }
+                if (cur.trim())
+                    items.push(cur.trim());
+                meta[key] = items.map((s) => {
+                    const scalar = parseScalar(s);
+                    return scalar === null ? "" : String(scalar);
+                });
+            }
+        }
+        else {
+            meta[key] = parseScalar(rawValue);
+        }
+    }
+    return { meta, body: match[2] };
+}
+/**
+ * Extract a section body by name via line-walk. Boundary is the next KNOWN
+ * section heading exactly matching one of Goal / What was hard / How solved /
+ * Synthesis. Anything else — including `## SomeOtherHeading` that the user
+ * (or an attacker) wrote inside a section body — is preserved verbatim.
+ */
+function extractSection(body, heading) {
+    const known = new Set(KNOWN_SECTIONS);
+    const lines = body.split(/\r?\n/);
+    let capturing = false;
+    const captured = [];
+    for (const line of lines) {
+        const m = line.match(/^##\s+(.+?)\s*$/);
+        if (m && known.has(m[1])) {
+            if (capturing)
+                break; // reached next KNOWN section — stop
+            if (m[1] === heading) {
+                capturing = true;
+            }
+            continue;
+        }
+        if (capturing)
+            captured.push(line);
+    }
+    // Trim trailing blank lines but preserve internal blank lines.
+    while (captured.length > 0 && captured[captured.length - 1].trim() === "")
+        captured.pop();
+    return captured.join("\n").trim();
+}
+function parseMeta(raw, fallbackOrder) {
+    const statusRaw = String(raw.status ?? "");
+    const status = statusRaw === "closed" || statusRaw === "abandoned" || statusRaw === "active" ? statusRaw : "active";
+    return {
+        phase: String(raw.phase ?? ""),
+        order: typeof raw.order === "number" ? raw.order : fallbackOrder,
+        status,
+        opened: String(raw.opened ?? ""),
+        closed: raw.closed === null || raw.closed === undefined ? null : String(raw.closed),
+        related_journal: Array.isArray(raw.related_journal) ? raw.related_journal : undefined,
+        related_insights: Array.isArray(raw.related_insights) ? raw.related_insights : undefined,
+        auto: raw.auto === true,
+    };
+}
+export function parseMilestoneFile(filePath) {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const { meta: rawMeta, body } = parseFrontmatter(raw);
+    const base = path.basename(filePath, ".md");
+    const inferredOrder = Number(base.split("-")[0]) || 0;
+    return {
+        meta: parseMeta(rawMeta, inferredOrder),
+        sections: {
+            goal: extractSection(body, "Goal"),
+            what_was_hard: extractSection(body, "What was hard"),
+            how_solved: extractSection(body, "How solved"),
+            synthesis: extractSection(body, "Synthesis"),
+        },
+        file_path: filePath,
+    };
+}
+/**
+ * Validate a parsed milestone. Returns null if file is too broken to trust,
+ * which causes listMilestones to skip it (rather than promote junk to "active").
+ */
+function isWellFormed(m) {
+    if (!m.meta.phase)
+        return false;
+    if (!m.meta.opened)
+        return false;
+    return true;
+}
+export function listMilestones(project) {
+    const dir = pipelineDir(project);
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md") && /^\d+-/.test(f));
+    const milestones = [];
+    for (const f of files) {
+        try {
+            const m = parseMilestoneFile(path.join(dir, f));
+            if (isWellFormed(m))
+                milestones.push(m);
+        }
+        catch {
+            // Skip unreadable files — don't crash list
+        }
+    }
+    // Numeric sort by order (lex sort breaks at order=10)
+    milestones.sort((a, b) => a.meta.order - b.meta.order);
+    return milestones;
+}
+export function findActiveMilestone(project) {
+    const all = listMilestones(project);
+    return all.find((m) => m.meta.status === "active") ?? null;
+}
+export function nextOrder(project) {
+    const all = listMilestones(project);
+    if (all.length === 0)
+        return 1;
+    return Math.max(...all.map((m) => m.meta.order)) + 1;
+}
+/**
+ * Strip carriage returns, collapse newlines to spaces, and trim — for embedding
+ * user content into a single-line context (markdown heading, frontmatter).
+ */
+function singleLine(s) {
+    return s.replace(/\r/g, "").replace(/\n+/g, " ").trim();
+}
+/**
+ * Escape body sections so that no user-supplied "## Known Heading" line can
+ * end a section prematurely. We prefix any such line with a zero-width-joiner
+ * marker that survives display but breaks the parser's regex.
+ *
+ * Cheap, reversible enough for human reading: the markdown renders normally
+ * except `## Goal` → `## ​Goal` (with U+200B). Most viewers show identically.
+ */
+function escapeSectionBody(s) {
+    return s.replace(/^(##\s+)(Goal|What was hard|How solved|Synthesis)\b/gim, "$1​$2");
+}
+export function renderMilestone(meta, sections) {
+    const fm = generateFrontmatter({
+        phase: meta.phase,
+        order: meta.order,
+        status: meta.status,
+        opened: meta.opened,
+        closed: meta.closed ?? null,
+        auto: meta.auto === true ? true : false,
+        related_journal: meta.related_journal ?? [],
+        related_insights: meta.related_insights ?? [],
+    });
+    const safePhase = singleLine(meta.phase);
+    const g = escapeSectionBody(sections.goal || PLACEHOLDER);
+    const h = escapeSectionBody(sections.what_was_hard || PLACEHOLDER);
+    const s = escapeSectionBody(sections.how_solved || PLACEHOLDER);
+    const sy = escapeSectionBody(sections.synthesis || PLACEHOLDER);
+    return (fm +
+        `# Phase ${zeroPad(meta.order)} — ${safePhase}\n\n` +
+        `## Goal\n${g}\n\n` +
+        `## What was hard\n${h}\n\n` +
+        `## How solved\n${s}\n\n` +
+        `## Synthesis\n${sy}\n`);
+}
+/**
+ * Write a milestone file atomically via tmp + rename.
+ * Refuses to follow symlinks at the target path.
+ */
+export function writeMilestone(project, meta, sections, existingFilePath) {
+    const dir = pipelineDir(project);
+    ensureDir(dir);
+    const filePath = existingFilePath ?? path.join(dir, milestoneFileName(meta.order, meta.phase));
+    // Symlink guard: if the target already exists and is a symlink, refuse.
+    try {
+        const lst = fs.lstatSync(filePath);
+        if (lst.isSymbolicLink()) {
+            throw new Error(`Refusing to write through symlink: ${filePath}`);
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    // Same check on parent dir
+    try {
+        const dirStat = fs.lstatSync(dir);
+        if (dirStat.isSymbolicLink()) {
+            throw new Error(`Refusing to write into symlinked dir: ${dir}`);
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    const tmp = `${filePath}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, renderMilestone(meta, sections), { encoding: "utf-8", mode: 0o600 });
+    fs.renameSync(tmp, filePath); // atomic on same filesystem
+    return filePath;
+}
+export function summarize(m) {
+    return {
+        order: m.meta.order,
+        phase: m.meta.phase,
+        status: m.meta.status,
+        opened: m.meta.opened,
+        closed: m.meta.closed ?? null,
+        synthesis: m.meta.status === "closed" ? m.sections.synthesis : null,
+        file_path: m.file_path,
+    };
+}
+export { PLACEHOLDER };
+//# sourceMappingURL=pipeline.js.map

package/dist/palace/pipeline.js.map

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

package/dist/palace/skills.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Skills — procedural memory layer (5th memory type).
+ *
+ * Closes the V10 (formal taxonomy) gap: AgentRecall today covers episodic
+ * (journal), semantic (palace/rooms + awareness), and narrative (pipeline)
+ * but has NO procedural store. Agents re-derive the same multi-step
+ * procedure every session — Cloudflare 4-step DNS+Proxy+OriginRule+SSL,
+ * git rm --cached for untracked file cleanup, OAuth refresh pre-check, etc.
+ *
+ * A Skill is a typed production rule:
+ *   IF trigger matches  AND preconditions hold  THEN follow steps
+ *
+ * Storage: ~/.agent-recall/projects/<slug>/palace/skills/<NN>-<slug>.md
+ *          (or global/procedural/<slug>.md for cross-project)
+ *
+ * Frontmatter shape conforms to naming.ts canonical schema for
+ * indexability + grep-friendly retrieval.
+ */
+import { type FsrsState } from "./fsrs.js";
+export interface SkillMeta {
+    /** Stable kebab-case slug, unique within project. */
+    slug: string;
+    /** Short human-readable name. */
+    name: string;
+    /** Topic / category (e.g. "deploy", "git", "auth"). */
+    topic: string;
+    /** Keywords that match user intent — used for trigger lookup. */
+    triggers: string[];
+    /** Optional file-path globs that increase relevance. */
+    file_globs?: string[];
+    created: string;
+    updated: string;
+    /** Where this came from. */
+    source?: "manual" | "promoted_from_correction" | "promoted_from_pipeline" | "auto_reflection";
+    /** Embedded FSRS state for reinforcement-on-use. */
+    fsrs?: FsrsState;
+}
+export interface SkillBody {
+    /** When to use this skill (the IF). */
+    when: string;
+    /** Preconditions to check before applying (zero or more). */
+    preconditions: string[];
+    /** Ordered steps (the THEN). */
+    steps: string[];
+    /** What success looks like — falsifiable. */
+    postconditions: string[];
+    /** Failure modes / things that went wrong before. */
+    pitfalls?: string[];
+    /** Evidence refs — journal dates / commit SHAs / corrections that led to this. */
+    evidence?: string[];
+}
+export interface Skill {
+    meta: SkillMeta;
+    body: SkillBody;
+    file_path: string;
+}
+export declare function skillsDir(project: string): string;
+export declare function parseSkillFile(filePath: string): Skill;
+export declare function listSkills(project: string): Skill[];
+export declare function nextSkillOrder(project: string): number;
+export declare function writeSkill(project: string, meta: SkillMeta, body: SkillBody, order?: number): string;
+/**
+ * Trigger-match: rank skills by overlap of intent keywords against the skill's
+ * declared `triggers` + topic + name. Returns top N. Pure scoring — no LLM call.
+ */
+export declare function recallSkillsByIntent(project: string, intent: string, limit?: number): Array<{
+    skill: Skill;
+    score: number;
+    matched_triggers: string[];
+}>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/palace/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/palace/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,QAAQ,GAAG,0BAA0B,GAAG,wBAAwB,GAAG,iBAAiB,CAAC;IAC9F,oDAAoD;IACpD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAiDD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CA4BtD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAanD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQtD;AA2BD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBpG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,SAAI,GACR,KAAK,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCpE"}

package/dist/palace/skills.js

@@ -0,0 +1,225 @@
+/**
+ * Skills — procedural memory layer (5th memory type).
+ *
+ * Closes the V10 (formal taxonomy) gap: AgentRecall today covers episodic
+ * (journal), semantic (palace/rooms + awareness), and narrative (pipeline)
+ * but has NO procedural store. Agents re-derive the same multi-step
+ * procedure every session — Cloudflare 4-step DNS+Proxy+OriginRule+SSL,
+ * git rm --cached for untracked file cleanup, OAuth refresh pre-check, etc.
+ *
+ * A Skill is a typed production rule:
+ *   IF trigger matches  AND preconditions hold  THEN follow steps
+ *
+ * Storage: ~/.agent-recall/projects/<slug>/palace/skills/<NN>-<slug>.md
+ *          (or global/procedural/<slug>.md for cross-project)
+ *
+ * Frontmatter shape conforms to naming.ts canonical schema for
+ * indexability + grep-friendly retrieval.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir, sanitizeSlug } from "../storage/paths.js";
+import { ensureDir } from "../storage/fs-utils.js";
+import { generateFrontmatter } from "./obsidian.js";
+import { initFsrs } from "./fsrs.js";
+const ORDER_PAD = 4;
+export function skillsDir(project) {
+    return path.join(palaceDir(project), "skills");
+}
+function zeroPad(n, width = ORDER_PAD) {
+    return n.toString().padStart(width, "0");
+}
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: raw };
+    const meta = {};
+    for (const line of match[1].split(/\r?\n/)) {
+        const idx = line.indexOf(":");
+        if (idx < 0)
+            continue;
+        const key = line.slice(0, idx).trim();
+        const raw = line.slice(idx + 1).trim();
+        if (!key)
+            continue;
+        if (raw.startsWith("[") && raw.endsWith("]")) {
+            const inner = raw.slice(1, -1).trim();
+            meta[key] = inner ? inner.split(",").map((s) => s.trim().replace(/^"|"$/g, "")) : [];
+        }
+        else if (raw.startsWith("{") && raw.endsWith("}")) {
+            try {
+                meta[key] = JSON.parse(raw);
+            }
+            catch {
+                meta[key] = raw;
+            }
+        }
+        else if (raw === "null" || raw === "") {
+            meta[key] = null;
+        }
+        else if (/^-?\d+(\.\d+)?$/.test(raw)) {
+            meta[key] = Number(raw);
+        }
+        else {
+            meta[key] = raw.replace(/^"|"$/g, "");
+        }
+    }
+    return { meta, body: match[2] };
+}
+function extractList(body, heading) {
+    const re = new RegExp(`^##\\s+${heading}\\s*\\r?\\n([\\s\\S]*?)(?=\\n##\\s+|\\s*$)`, "mi");
+    const m = body.match(re);
+    if (!m)
+        return [];
+    return m[1]
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("- ") || l.startsWith("* "))
+        .map((l) => l.replace(/^[-*]\s+/, ""));
+}
+function extractParagraph(body, heading) {
+    const re = new RegExp(`^##\\s+${heading}\\s*\\r?\\n([\\s\\S]*?)(?=\\n##\\s+|\\s*$)`, "mi");
+    const m = body.match(re);
+    return m ? m[1].trim() : "";
+}
+export function parseSkillFile(filePath) {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const { meta: m, body } = parseFrontmatter(raw);
+    const meta = {
+        slug: String(m.slug ?? path.basename(filePath, ".md").split("-").slice(1).join("-")),
+        name: String(m.name ?? ""),
+        topic: String(m.topic ?? ""),
+        triggers: Array.isArray(m.triggers) ? m.triggers : [],
+        file_globs: Array.isArray(m.file_globs) ? m.file_globs : undefined,
+        created: String(m.created ?? ""),
+        updated: String(m.updated ?? ""),
+        source: m.source ?? "manual",
+        fsrs: m.fsrs && typeof m.fsrs === "object" ? m.fsrs : undefined,
+    };
+    return {
+        meta,
+        body: {
+            when: extractParagraph(body, "When"),
+            preconditions: extractList(body, "Preconditions"),
+            steps: extractList(body, "Steps"),
+            postconditions: extractList(body, "Postconditions"),
+            pitfalls: extractList(body, "Pitfalls"),
+            evidence: extractList(body, "Evidence"),
+        },
+        file_path: filePath,
+    };
+}
+export function listSkills(project) {
+    const dir = skillsDir(project);
+    if (!fs.existsSync(dir))
+        return [];
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md") && /^\d+-/.test(f));
+    const skills = [];
+    for (const f of files) {
+        try {
+            skills.push(parseSkillFile(path.join(dir, f)));
+        }
+        catch {
+            // skip unreadable
+        }
+    }
+    return skills.sort((a, b) => a.meta.slug.localeCompare(b.meta.slug));
+}
+export function nextSkillOrder(project) {
+    const dir = skillsDir(project);
+    if (!fs.existsSync(dir))
+        return 1;
+    const orders = fs
+        .readdirSync(dir)
+        .filter((f) => /^\d+-/.test(f))
+        .map((f) => parseInt(f.split("-")[0], 10) || 0);
+    return orders.length === 0 ? 1 : Math.max(...orders) + 1;
+}
+function renderSkill(meta, body) {
+    const fm = generateFrontmatter({
+        slug: meta.slug,
+        name: meta.name,
+        topic: meta.topic,
+        triggers: meta.triggers,
+        file_globs: meta.file_globs ?? [],
+        created: meta.created,
+        updated: meta.updated,
+        source: meta.source ?? "manual",
+        fsrs: meta.fsrs ?? null,
+    });
+    const renderList = (xs) => xs.length ? xs.map((x) => `- ${x}`).join("\n") : "- _(none)_";
+    return (fm +
+        `# ${meta.name}\n\n` +
+        `## When\n${body.when || "_(describe the trigger condition)_"}\n\n` +
+        `## Preconditions\n${renderList(body.preconditions)}\n\n` +
+        `## Steps\n${renderList(body.steps)}\n\n` +
+        `## Postconditions\n${renderList(body.postconditions)}\n\n` +
+        (body.pitfalls && body.pitfalls.length > 0 ? `## Pitfalls\n${renderList(body.pitfalls)}\n\n` : "") +
+        (body.evidence && body.evidence.length > 0 ? `## Evidence\n${renderList(body.evidence)}\n` : ""));
+}
+export function writeSkill(project, meta, body, order) {
+    const dir = skillsDir(project);
+    ensureDir(dir);
+    const finalMeta = {
+        ...meta,
+        slug: sanitizeSlug(meta.slug || meta.name),
+        fsrs: meta.fsrs ?? initFsrs(meta.created || new Date().toISOString()),
+    };
+    const ord = order ?? nextSkillOrder(project);
+    const filename = `${zeroPad(ord)}-${finalMeta.slug}.md`;
+    const filePath = path.join(dir, filename);
+    // Symlink guard
+    try {
+        const lst = fs.lstatSync(filePath);
+        if (lst.isSymbolicLink())
+            throw new Error(`Refusing to write symlinked skill file: ${filePath}`);
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+    }
+    // Atomic write
+    const tmp = `${filePath}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, renderSkill(finalMeta, body), { encoding: "utf-8", mode: 0o600 });
+    fs.renameSync(tmp, filePath);
+    return filePath;
+}
+/**
+ * Trigger-match: rank skills by overlap of intent keywords against the skill's
+ * declared `triggers` + topic + name. Returns top N. Pure scoring — no LLM call.
+ */
+export function recallSkillsByIntent(project, intent, limit = 5) {
+    const skills = listSkills(project);
+    if (skills.length === 0)
+        return [];
+    const intentWords = new Set(intent
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[^a-z0-9 ]+/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length >= 3));
+    const ranked = skills
+        .map((s) => {
+        const haystack = [s.meta.name, s.meta.topic, ...s.meta.triggers].join(" ").toLowerCase();
+        const haystackWords = new Set(haystack.split(/[^a-z0-9]+/).filter((w) => w.length >= 3));
+        const matched = [];
+        let score = 0;
+        for (const w of intentWords) {
+            if (haystackWords.has(w)) {
+                matched.push(w);
+                score += 1;
+            }
+        }
+        // Boost: explicit trigger keyword matches count double
+        for (const t of s.meta.triggers) {
+            if (intent.toLowerCase().includes(t.toLowerCase()))
+                score += 1;
+        }
+        return { skill: s, score, matched_triggers: matched };
+    })
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    return ranked;
+}
+//# sourceMappingURL=skills.js.map

package/dist/palace/skills.js.map

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