@repomem/memory 0.0.0-stage → 0.1.0

package/dist/setup/spec.js

@@ -0,0 +1,44 @@
+/**
+ * spec.ts — repomem's own {@link AgentSetupSpec}.
+ *
+ * Resolves asset paths relative to the compiled file location, mirroring the
+ * `TEMPLATES_DIR` pattern in cli.ts so it works both from `dist/` in a
+ * published package and during local development.
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const here = path.dirname(fileURLToPath(import.meta.url));
+// dist/setup/spec.js -> ../../assets  (package root holds `assets/`)
+const ASSETS_DIR = path.resolve(here, "..", "..", "assets");
+const KIRO_ASSETS = path.join(ASSETS_DIR, "kiro");
+/** The spec repomem contributes to a Kiro setup. */
+export const repomemSpec = {
+    serverName: "repomem",
+    mcpServer: {
+        command: "npx",
+        args: ["-y", "repomem"],
+        env: {},
+        disabled: false,
+        autoApprove: ["search_memory", "get_memory", "memory_for_path"],
+    },
+    skills: [
+        {
+            id: "repomem-memory",
+            srcDir: path.join(KIRO_ASSETS, "skills", "repomem-memory"),
+        },
+        {
+            id: "repomem-distill",
+            srcDir: path.join(KIRO_ASSETS, "skills", "repomem-distill"),
+        },
+    ],
+    hookScripts: [
+        {
+            name: "repomem-validate.sh",
+            srcPath: path.join(KIRO_ASSETS, "hooks", "repomem-validate.sh"),
+        },
+    ],
+    agentHooks: {
+        agentSpawn: [{ command: ".kiro/hooks/repomem-validate.sh" }],
+    },
+};
+//# sourceMappingURL=spec.js.map

package/dist/setup/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/setup/spec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,qEAAqE;AACrE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAElD,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE;QACT,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;QACvB,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,iBAAiB,CAAC;KAChE;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,gBAAgB;YACpB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,CAAC;SAC3D;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,iBAAiB,CAAC;SAC5D;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,qBAAqB,CAAC;SAChE;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC7D;CACF,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,119 @@
+/**
+ * store.ts — read and write memory entries on disk.
+ *
+ * Responsibilities:
+ *  - Resolve the memory root: `--root` flag > `MEMORY_ROOT` env > <git root>/.repomem/memory.
+ *  - Load entries from `memory/<type>s/<slug>.md`, skipping (not crashing on)
+ *    malformed files and reporting them to stderr.
+ *  - Generate ASCII slugs from titles and write entries without ever
+ *    overwriting an existing file.
+ *  - Propose new draft entries (reject duplicates), deprecate existing ones
+ *    in place, and find entries whose related_paths match a given file path.
+ *
+ * Never writes to stdout — diagnostics go to stderr only, to keep the MCP
+ * stdio protocol clean.
+ */
+import { type EntryType, type Frontmatter, type FrontmatterInput, type MemoryEntry } from "./schema.js";
+/** Today's date in UTC as `YYYY-MM-DD`. */
+export declare function todayIso(): string;
+export interface ResolveRootOptions {
+    /** Explicit `--root` value, if provided on the CLI. */
+    rootFlag?: string;
+    /** Directory to start git-root discovery from. Defaults to process.cwd(). */
+    cwd?: string;
+    /** Environment map (injectable for tests). Defaults to process.env. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Walk upward from `start` looking for a `.git` entry (dir or file).
+ * Returns the directory containing it, or undefined if none is found.
+ */
+export declare function findGitRoot(start: string): string | undefined;
+/**
+ * Resolve the memory root using the precedence:
+ *   1. `--root` flag
+ *   2. `MEMORY_ROOT` env var
+ *   3. `<git root>/.repomem/memory`
+ *
+ * Throws if none can be resolved (no flag, no env, no git root found).
+ */
+export declare function resolveMemoryRoot(options?: ResolveRootOptions): string;
+/**
+ * Convert a title into an ASCII, URL-safe slug.
+ * Strips diacritics (á -> a), lowercases, replaces non-alphanumerics with
+ * single hyphens, trims hyphens, and caps length.
+ */
+export declare function slugify(title: string): string;
+/**
+ * Build a slug that does not collide with `existing`. Appends `-2`, `-3`, …
+ * until unique. Returns the input slug when there is no collision.
+ */
+export declare function uniqueSlug(slug: string, existing: ReadonlySet<string>): string;
+/**
+ * Parse a single entry file. Returns the entry, or undefined if the file is
+ * malformed (invalid frontmatter, wrong type for its folder). Malformed files
+ * are reported to stderr and skipped rather than throwing.
+ */
+export declare function readEntryFile(file: string, expectedType?: EntryType): Promise<MemoryEntry | undefined>;
+/**
+ * Load all valid entries under the memory root. Missing type folders are
+ * treated as empty. Malformed entries are skipped (reported to stderr).
+ */
+export declare function loadEntries(root: string): Promise<MemoryEntry[]>;
+/** Find a single entry by id across all type folders, or undefined. */
+export declare function findEntryById(root: string, id: string): Promise<MemoryEntry | undefined>;
+/** Collect the set of existing slugs for a given type (for collision checks). */
+export declare function existingSlugs(root: string, type: EntryType): Promise<Set<string>>;
+/**
+ * Serialize frontmatter + body back into a markdown file string.
+ * Keys are written in a stable, human-friendly order; optional keys are only
+ * emitted when present.
+ */
+export declare function serializeEntry(frontmatter: Frontmatter, body: string): string;
+export interface WriteResult {
+    id: string;
+    path: string;
+}
+/**
+ * Write a new entry to disk. Validates frontmatter, resolves a unique slug
+ * from the title, creates the type folder if needed, and NEVER overwrites an
+ * existing file. Returns the id and path written.
+ *
+ * @throws if frontmatter is invalid or the resolved file already exists.
+ */
+export declare function writeEntry(root: string, input: FrontmatterInput, body: string): Promise<WriteResult>;
+export interface ProposeInput {
+    type: EntryType;
+    title: string;
+    body: string;
+    tags?: string[];
+    related_paths?: string[];
+    supersedes?: string;
+    author?: string;
+}
+/**
+ * Propose a new entry. ALWAYS writes `status: draft`. The date defaults to
+ * today (UTC). Rejects a title whose slug already exists within the same type
+ * (a likely duplicate the human should resolve) rather than auto-suffixing.
+ *
+ * @throws if the derived slug collides with an existing entry of that type.
+ */
+export declare function proposeEntry(root: string, input: ProposeInput): Promise<WriteResult>;
+/**
+ * Mark an existing entry as deprecated, recording the reason (and optionally
+ * the id that supersedes it) in the frontmatter. Rewrites the file in place,
+ * preserving the body and other fields.
+ *
+ * @throws if the entry does not exist.
+ */
+export declare function deprecateEntry(root: string, id: string, reason: string, supersededBy?: string): Promise<WriteResult>;
+/**
+ * Return entries whose `related_paths` globs match the given file path.
+ * Deprecated entries are excluded. Results are ordered accepted-before-draft,
+ * then by date descending.
+ *
+ * The input path is normalized to posix separators so globs behave the same
+ * across platforms.
+ */
+export declare function entriesForPath(root: string, filePath: string): Promise<MemoryEntry[]>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAOrB,2CAA2C;AAC3C,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAMD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ7D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAc1E;AAQD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAK9E;AAeD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,SAAS,GACvB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAyClC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBtE;AAED,uEAAuE;AACvE,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAQlC;AAED,iFAAiF;AACjF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAUtB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAuB7E;AAMD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,WAAW,CAAC,CAsCtB;AAMD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAYD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBxB"}

package/dist/store.js

@@ -0,0 +1,350 @@
+/**
+ * store.ts — read and write memory entries on disk.
+ *
+ * Responsibilities:
+ *  - Resolve the memory root: `--root` flag > `MEMORY_ROOT` env > <git root>/.repomem/memory.
+ *  - Load entries from `memory/<type>s/<slug>.md`, skipping (not crashing on)
+ *    malformed files and reporting them to stderr.
+ *  - Generate ASCII slugs from titles and write entries without ever
+ *    overwriting an existing file.
+ *  - Propose new draft entries (reject duplicates), deprecate existing ones
+ *    in place, and find entries whose related_paths match a given file path.
+ *
+ * Never writes to stdout — diagnostics go to stderr only, to keep the MCP
+ * stdio protocol clean.
+ */
+import { promises as fs } from "node:fs";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import picomatch from "picomatch";
+import { frontmatterSchema, TYPE_DIRS, ENTRY_TYPES, } from "./schema.js";
+/** Log a diagnostic to stderr. Never use stdout (reserved for MCP). */
+function warn(message) {
+    process.stderr.write(`[repomem] ${message}\n`);
+}
+/** Today's date in UTC as `YYYY-MM-DD`. */
+export function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Walk upward from `start` looking for a `.git` entry (dir or file).
+ * Returns the directory containing it, or undefined if none is found.
+ */
+export function findGitRoot(start) {
+    let dir = path.resolve(start);
+    for (;;) {
+        if (existsSync(path.join(dir, ".git")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * Resolve the memory root using the precedence:
+ *   1. `--root` flag
+ *   2. `MEMORY_ROOT` env var
+ *   3. `<git root>/.repomem/memory`
+ *
+ * Throws if none can be resolved (no flag, no env, no git root found).
+ */
+export function resolveMemoryRoot(options = {}) {
+    const { rootFlag, cwd = process.cwd(), env = process.env } = options;
+    if (rootFlag && rootFlag.trim() !== "")
+        return path.resolve(rootFlag);
+    const envRoot = env.MEMORY_ROOT;
+    if (envRoot && envRoot.trim() !== "")
+        return path.resolve(envRoot);
+    const gitRoot = findGitRoot(cwd);
+    if (gitRoot)
+        return path.join(gitRoot, ".repomem", "memory");
+    throw new Error("Could not resolve a memory root: pass --root, set MEMORY_ROOT, or run inside a git repository.");
+}
+// ---------------------------------------------------------------------------
+// Slug generation (option A: ASCII, diacritics stripped)
+// ---------------------------------------------------------------------------
+const SLUG_MAX_LENGTH = 80;
+/**
+ * Convert a title into an ASCII, URL-safe slug.
+ * Strips diacritics (á -> a), lowercases, replaces non-alphanumerics with
+ * single hyphens, trims hyphens, and caps length.
+ */
+export function slugify(title) {
+    return title
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, SLUG_MAX_LENGTH)
+        .replace(/-+$/g, "");
+}
+/**
+ * Build a slug that does not collide with `existing`. Appends `-2`, `-3`, …
+ * until unique. Returns the input slug when there is no collision.
+ */
+export function uniqueSlug(slug, existing) {
+    if (!existing.has(slug))
+        return slug;
+    let n = 2;
+    while (existing.has(`${slug}-${n}`))
+        n++;
+    return `${slug}-${n}`;
+}
+// ---------------------------------------------------------------------------
+// Reading
+// ---------------------------------------------------------------------------
+function typeDir(root, type) {
+    return path.join(root, TYPE_DIRS[type]);
+}
+/** The slug (id) is the file name without its `.md` extension. */
+function slugFromFile(file) {
+    return path.basename(file, ".md");
+}
+/**
+ * Parse a single entry file. Returns the entry, or undefined if the file is
+ * malformed (invalid frontmatter, wrong type for its folder). Malformed files
+ * are reported to stderr and skipped rather than throwing.
+ */
+export async function readEntryFile(file, expectedType) {
+    let raw;
+    try {
+        raw = await fs.readFile(file, "utf8");
+    }
+    catch (err) {
+        warn(`could not read ${file}: ${err.message}`);
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = matter(raw);
+    }
+    catch (err) {
+        warn(`invalid frontmatter in ${file}: ${err.message}`);
+        return undefined;
+    }
+    const result = frontmatterSchema.safeParse(parsed.data);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("; ");
+        warn(`skipping ${file}: ${issues}`);
+        return undefined;
+    }
+    const frontmatter = result.data;
+    if (expectedType && frontmatter.type !== expectedType) {
+        warn(`skipping ${file}: declared type "${frontmatter.type}" does not match folder "${TYPE_DIRS[expectedType]}"`);
+        return undefined;
+    }
+    return {
+        id: slugFromFile(file),
+        frontmatter,
+        body: parsed.content.trim(),
+        path: file,
+    };
+}
+/**
+ * Load all valid entries under the memory root. Missing type folders are
+ * treated as empty. Malformed entries are skipped (reported to stderr).
+ */
+export async function loadEntries(root) {
+    const entries = [];
+    for (const type of ENTRY_TYPES) {
+        const dir = typeDir(root, type);
+        let files;
+        try {
+            files = await fs.readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of files) {
+            if (!name.endsWith(".md"))
+                continue;
+            const entry = await readEntryFile(path.join(dir, name), type);
+            if (entry)
+                entries.push(entry);
+        }
+    }
+    return entries;
+}
+/** Find a single entry by id across all type folders, or undefined. */
+export async function findEntryById(root, id) {
+    for (const type of ENTRY_TYPES) {
+        const file = path.join(typeDir(root, type), `${id}.md`);
+        if (existsSync(file)) {
+            return readEntryFile(file, type);
+        }
+    }
+    return undefined;
+}
+/** Collect the set of existing slugs for a given type (for collision checks). */
+export async function existingSlugs(root, type) {
+    const dir = typeDir(root, type);
+    try {
+        const files = await fs.readdir(dir);
+        return new Set(files.filter((f) => f.endsWith(".md")).map((f) => slugFromFile(f)));
+    }
+    catch {
+        return new Set();
+    }
+}
+// ---------------------------------------------------------------------------
+// Serialization
+// ---------------------------------------------------------------------------
+/**
+ * Serialize frontmatter + body back into a markdown file string.
+ * Keys are written in a stable, human-friendly order; optional keys are only
+ * emitted when present.
+ */
+export function serializeEntry(frontmatter, body) {
+    const data = {
+        type: frontmatter.type,
+        title: frontmatter.title,
+        status: frontmatter.status,
+        date: frontmatter.date,
+        scope: frontmatter.scope,
+    };
+    if (frontmatter.author !== undefined)
+        data.author = frontmatter.author;
+    data.tags = frontmatter.tags;
+    data.related_paths = frontmatter.related_paths;
+    if (frontmatter.supersedes !== undefined)
+        data.supersedes = frontmatter.supersedes;
+    if (frontmatter.last_verified !== undefined) {
+        data.last_verified = frontmatter.last_verified;
+    }
+    if (frontmatter.deprecated_reason !== undefined) {
+        data.deprecated_reason = frontmatter.deprecated_reason;
+    }
+    if (frontmatter.superseded_by !== undefined) {
+        data.superseded_by = frontmatter.superseded_by;
+    }
+    return matter.stringify(body.trim() + "\n", data);
+}
+/**
+ * Write a new entry to disk. Validates frontmatter, resolves a unique slug
+ * from the title, creates the type folder if needed, and NEVER overwrites an
+ * existing file. Returns the id and path written.
+ *
+ * @throws if frontmatter is invalid or the resolved file already exists.
+ */
+export async function writeEntry(root, input, body) {
+    const frontmatter = frontmatterSchema.parse(input);
+    const dir = typeDir(root, frontmatter.type);
+    await fs.mkdir(dir, { recursive: true });
+    const taken = await existingSlugs(root, frontmatter.type);
+    const slug = uniqueSlug(slugify(frontmatter.title), taken);
+    const file = path.join(dir, `${slug}.md`);
+    if (existsSync(file)) {
+        throw new Error(`refusing to overwrite existing entry: ${file}`);
+    }
+    await fs.writeFile(file, serializeEntry(frontmatter, body), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    return { id: slug, path: file };
+}
+/**
+ * Propose a new entry. ALWAYS writes `status: draft`. The date defaults to
+ * today (UTC). Rejects a title whose slug already exists within the same type
+ * (a likely duplicate the human should resolve) rather than auto-suffixing.
+ *
+ * @throws if the derived slug collides with an existing entry of that type.
+ */
+export async function proposeEntry(root, input) {
+    const slug = slugify(input.title);
+    if (slug === "") {
+        throw new Error("title does not produce a usable slug");
+    }
+    const taken = await existingSlugs(root, input.type);
+    if (taken.has(slug)) {
+        throw new Error(`a ${input.type} entry with id "${slug}" already exists; refusing to create a duplicate`);
+    }
+    const frontmatter = frontmatterSchema.parse({
+        type: input.type,
+        title: input.title,
+        status: "draft", // forced, never taken from caller
+        date: todayIso(),
+        author: input.author,
+        tags: input.tags ?? [],
+        related_paths: input.related_paths ?? [],
+        supersedes: input.supersedes,
+    });
+    const dir = typeDir(root, input.type);
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `${slug}.md`);
+    if (existsSync(file)) {
+        throw new Error(`refusing to overwrite existing entry: ${file}`);
+    }
+    await fs.writeFile(file, serializeEntry(frontmatter, input.body), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    return { id: slug, path: file };
+}
+// ---------------------------------------------------------------------------
+// Deprecate (rewrite an existing entry in place)
+// ---------------------------------------------------------------------------
+/**
+ * Mark an existing entry as deprecated, recording the reason (and optionally
+ * the id that supersedes it) in the frontmatter. Rewrites the file in place,
+ * preserving the body and other fields.
+ *
+ * @throws if the entry does not exist.
+ */
+export async function deprecateEntry(root, id, reason, supersededBy) {
+    if (reason.trim() === "") {
+        throw new Error("a deprecation reason is required");
+    }
+    const entry = await findEntryById(root, id);
+    if (!entry) {
+        throw new Error(`no memory entry found with id "${id}"`);
+    }
+    const updated = frontmatterSchema.parse({
+        ...entry.frontmatter,
+        status: "deprecated",
+        deprecated_reason: reason,
+        superseded_by: supersededBy,
+    });
+    await fs.writeFile(entry.path, serializeEntry(updated, entry.body), "utf8");
+    return { id: entry.id, path: entry.path };
+}
+// ---------------------------------------------------------------------------
+// memory_for_path (match related_paths globs against a file path)
+// ---------------------------------------------------------------------------
+const STATUS_PRIORITY = {
+    accepted: 0,
+    draft: 1,
+    deprecated: 2,
+};
+/**
+ * Return entries whose `related_paths` globs match the given file path.
+ * Deprecated entries are excluded. Results are ordered accepted-before-draft,
+ * then by date descending.
+ *
+ * The input path is normalized to posix separators so globs behave the same
+ * across platforms.
+ */
+export async function entriesForPath(root, filePath) {
+    const normalized = filePath.split(path.sep).join("/").replace(/^\.?\/+/, "");
+    const entries = await loadEntries(root);
+    const matched = entries.filter((e) => {
+        if (e.frontmatter.status === "deprecated")
+            return false;
+        if (e.frontmatter.related_paths.length === 0)
+            return false;
+        return e.frontmatter.related_paths.some((glob) => picomatch.isMatch(normalized, glob, { dot: true }));
+    });
+    matched.sort((a, b) => {
+        const pa = STATUS_PRIORITY[a.frontmatter.status] ?? 99;
+        const pb = STATUS_PRIORITY[b.frontmatter.status] ?? 99;
+        if (pa !== pb)
+            return pa - pb;
+        return b.frontmatter.date.localeCompare(a.frontmatter.date);
+    });
+    return matched;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,42 @@
+/**
+ * validate.ts — pure validation logic for `repomem validate`.
+ *
+ * Checks performed:
+ *  1. Every `.md` entry under the memory root has valid frontmatter.
+ *  2. Every `supersedes` reference points at an existing entry id.
+ *  3. No obvious secrets (API keys, tokens, private keys) appear in any entry.
+ *
+ * This module is I/O-light and returns a structured report; the CLI decides
+ * the process exit code. Nothing here writes to stdout.
+ */
+export type Severity = "error" | "warning";
+export interface Finding {
+    severity: Severity;
+    file: string;
+    line?: number;
+    rule: string;
+    message: string;
+}
+export interface ValidateReport {
+    findings: Finding[];
+    checked: number;
+    ok: boolean;
+}
+/**
+ * High-confidence secret patterns. Tuned to minimize false positives; this is
+ * a safety net, not a replacement for a dedicated secret scanner.
+ */
+export declare const SECRET_PATTERNS: Array<{
+    rule: string;
+    re: RegExp;
+}>;
+/** Scan a block of text for secrets, returning one finding per match line. */
+export declare function scanSecrets(text: string, file: string): Finding[];
+/**
+ * Validate every entry under `root`. Returns a structured report. `ok` is true
+ * only when there are no error-severity findings.
+ */
+export declare function validateRoot(root: string): Promise<ValidateReport>;
+/** Format a report as human-readable lines (for stderr/stdout in the CLI). */
+export declare function formatReport(report: ValidateReport, root: string): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAW/D,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAiBjE;AA4BD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA+ExE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAczE"}