@jmtrin/opencode-kevin 0.7.0 → 0.9.0

package/dist/plugin/RepoIdentity.d.ts

@@ -0,0 +1,124 @@
+import type { ArtifactWriter } from "./ArtifactWriter.js";
+import type { HostSurface } from "./host.js";
+/**
+ * The four sources `resolve()` tries, in order (plan §5.2, D9-13).
+ */
+export type IdentitySource = "declared" | "remote" | "host" | "path";
+/**
+ * The outcome of resolving a repository identity.
+ */
+export interface ResolvedIdentity {
+    /** The repository-scoped id every Team scope is keyed on. */
+    repoId: string;
+    /** Which source produced `repoId`. */
+    source: IdentitySource;
+    /**
+     * A short, non-secret description of how the id was derived,
+     * surfaced by `kevin_project show`. Never contains a credential
+     * or an absolute path.
+     */
+    evidence: string;
+    /** The v0.7.0 project scope, always returned regardless of source. */
+    projectId: string;
+}
+/**
+ * Read the first `url = …` value inside `[remote "<name>"]` of a
+ * `.git/config`-style INI text.
+ *
+ * Line-oriented reader, not an INI library: tracks the current
+ * `[section "sub"]` header, tolerates tabs, spaces around `=`,
+ * CRLF, and comment lines. Returns `null` on anything unrecognised
+ * and never throws — on any input, including binary.
+ */
+export declare function parseGitConfigRemote(text: string, name?: string): string | null;
+/**
+ * Fold the URL shapes git accepts into one canonical string.
+ *
+ * Steps, in order (K8-005):
+ *   1. strip a trailing `.git`;
+ *   2. strip a `scheme://` prefix;
+ *   3. strip everything up to and including the last `@` in the
+ *      authority (userinfo and embedded credentials — a token must
+ *      never reach a hash that lands in a committed file, D8-04);
+ *   4. strip a numeric port (`:8443`, `:443`, …) so the same repo
+ *      served over different transports folds to one id;
+ *   5. rewrite the scp-style `host:path` separator to `host/path`;
+ *   6. strip a trailing `/`;
+ *   7. lowercase the whole result.
+ *
+ * Returns `null` when the result contains no `/` (e.g. a local
+ * path remote) — the caller falls through to the path source.
+ */
+export declare function normalizeRemote(url: string): string | null;
+/**
+ * Derive a repository id from a normalized remote (K8-006).
+ *
+ * The domain prefix means a repo id can never collide with a memory
+ * fingerprint computed over the same string, and it leaves room to
+ * version the derivation later.
+ */
+export declare function computeRepoId(normalized: string): string;
+/**
+ * Resolve the repository identity for `cwd`, trying the four
+ * sources in order (plan §5.2, D9-13):
+ *
+ *   1. `declared` — `.kevin/project.json` → `id` (validated as
+ *      exactly 16 lowercase hex characters; anything else is ignored
+ *      and falls through, because a hand-edited garbage id in a
+ *      committed file would otherwise scope a whole team's corpus
+ *      onto a typo);
+ *   2. `remote` — `.git/config` → `[remote "origin"] url`,
+ *      normalized and hashed;
+ *   3. `host` — the value the host resolved for this directory,
+ *      `host.project.worktree` first, `host.project.directory` as
+ *      fallback; both empty or absent falls through to `path`.
+ *      This is strictly better than `process.cwd()` — the host's own
+ *      ToolContext documents "prefer this over `process.cwd()`" —
+ *      but it sits below the explicit sources, because monorepos and
+ *      D8-03's confirmed re-keying depend on `.kevin/project.json`
+ *      winning;
+ *   4. `path` — `fingerprint(cwd)`, the v0.7.0 behaviour, preserved
+ *      exactly when `host` is absent.
+ *
+ * Never throws: a directory that is not a git repository, an
+ * unreadable `.git/config`, a malformed `project.json`, and a host
+ * with no usable project fields all fall through to source 4.
+ * `projectId` is always returned alongside `repoId`, regardless of
+ * which source won.
+ */
+export declare function resolve(cwd: string, host?: HostSurface): ResolvedIdentity;
+/**
+ * The outcome of `initProjectFile` (K8-008).
+ */
+export interface InitProjectResult {
+    /** Whether the file was written. */
+    ok: boolean;
+    /** The absolute path the file was written to, or refused. */
+    path: string;
+    /** Human-readable refusal reason when `ok` is false. */
+    reason?: string;
+    /** The pinned id when the file was written. */
+    id?: string;
+    /** The ISO-8601 Z timestamp written into the file. */
+    createdAt?: string;
+}
+/**
+ * Write `.kevin/project.json` pinning the repository identity (K8-008
+ * / plan §5.8). The id comes from the current `resolve(cwd)` — so `init`
+ * in a repository with a remote *pins* the remote-derived id, which is
+ * the point: it survives the organisation renaming the repo (a remote
+ * URL change would otherwise silently re-scope the corpus).
+ *
+ * The file is `{"id": "<16 hex>", "created_at": "<ISO-8601 Z>",
+ * "generator": "opencode-kevin/0.8.0"}` with sorted keys and a
+ * terminating newline (deterministic bytes, the codec discipline of
+ * plan §7.3). `init` refuses when the file already exists: overwriting
+ * it re-scopes a team's corpus, and that is `rekey`'s job (K8-009),
+ * with a confirmation.
+ *
+ * NOTE (K8-019): the write goes through `ArtifactWriter` in whole-file
+ * mode — `.kevin/project.json` is a Kevin-owned file, and D8-08 leaves
+ * no scenario in which a second raw write path is acceptable (asserted
+ * by tests/unit/single_write_path.test.ts).
+ */
+export declare function initProjectFile(cwd: string, writer: ArtifactWriter): InitProjectResult;

package/dist/plugin/RepoIdentity.js

@@ -0,0 +1,301 @@
+import { mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fingerprint, fnv1a64 } from "./fingerprint.js";
+// ============================================================
+// Kevin 0.8.0 — RepoIdentity (K8-005/K8-006 / plan §5.1, D8-04)
+// v0.9.0 — host identity source (K9-006 / plan §5.2, D9-13)
+// ============================================================
+// Repository-derived identity that survives a clone. Two clones
+// of the same remote must agree on one `repo_id` even though
+// `process.cwd()` differs.
+//
+// This file deliberately contains no process-launching calls (D8-01)
+// and no `new URL()` — the scp-style `git@host:path` form that git
+// accepts and roughly half of all clones use rejects URL parsing
+// (K8-005).
+// ============================================================
+// Comment lines git accepts inside a config section: `#` and `;`.
+const COMMENT_RE = /^[#;]/;
+// A declared id must be exactly 16 lowercase hex characters (K8-006).
+const DECLARED_ID_RE = /^[0-9a-f]{16}$/;
+const PROJECT_JSON_PATH = join(".kevin", "project.json");
+const GIT_CONFIG_PATH = join(".git", "config");
+/**
+ * Read the first `url = …` value inside `[remote "<name>"]` of a
+ * `.git/config`-style INI text.
+ *
+ * Line-oriented reader, not an INI library: tracks the current
+ * `[section "sub"]` header, tolerates tabs, spaces around `=`,
+ * CRLF, and comment lines. Returns `null` on anything unrecognised
+ * and never throws — on any input, including binary.
+ */
+export function parseGitConfigRemote(text, name = "origin") {
+    // Never throw on any input, including binary and huge strings.
+    if (typeof text !== "string" || text.length === 0)
+        return null;
+    const lines = text.split(/\r\n|\n|\r/);
+    let currentSection = null;
+    let currentSub = null;
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (line.length === 0)
+            continue;
+        if (COMMENT_RE.test(line))
+            continue;
+        // Section header: `[section "sub"]` or `[section]`.
+        if (line.startsWith("[")) {
+            const header = line.slice(1, line.indexOf("]"));
+            if (header === null)
+                return null;
+            const q = header.indexOf('"');
+            if (q === -1) {
+                currentSection = header.trim();
+                currentSub = null;
+            }
+            else {
+                currentSection = header.slice(0, q).trim();
+                const sub = header.slice(q + 1, header.lastIndexOf('"'));
+                currentSub = sub;
+            }
+            continue;
+        }
+        if (currentSection !== "remote")
+            continue;
+        const eq = line.indexOf("=");
+        if (eq === -1)
+            return null;
+        const key = line.slice(0, eq).trim();
+        const value = line.slice(eq + 1).trim();
+        if (key !== "url")
+            continue;
+        if (currentSub === name)
+            return value;
+    }
+    return null;
+}
+/**
+ * Fold the URL shapes git accepts into one canonical string.
+ *
+ * Steps, in order (K8-005):
+ *   1. strip a trailing `.git`;
+ *   2. strip a `scheme://` prefix;
+ *   3. strip everything up to and including the last `@` in the
+ *      authority (userinfo and embedded credentials — a token must
+ *      never reach a hash that lands in a committed file, D8-04);
+ *   4. strip a numeric port (`:8443`, `:443`, …) so the same repo
+ *      served over different transports folds to one id;
+ *   5. rewrite the scp-style `host:path` separator to `host/path`;
+ *   6. strip a trailing `/`;
+ *   7. lowercase the whole result.
+ *
+ * Returns `null` when the result contains no `/` (e.g. a local
+ * path remote) — the caller falls through to the path source.
+ */
+export function normalizeRemote(url) {
+    if (typeof url !== "string" || url.length === 0)
+        return null;
+    // 1. Strip a trailing `.git` (case-insensitive for file names
+    //    like `App.GIT`; hosts are lowercased later anyway).
+    let s = url.replace(/\.git$/i, "");
+    // 2. Strip a `scheme://` prefix — any scheme, including
+    //    `ssh://`, `https://`, `git://`, `file://`. A `file://`
+    //    remote collapses to a local path and will fall through.
+    s = s.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "");
+    // 3. Strip userinfo: everything up to and including the last
+    //    `@` in the authority. `https://user:token@host/…` and
+    //    `ssh://git@host/…` both lose the credential half here,
+    //    before anything else can retain a copy.
+    const at = s.lastIndexOf("@");
+    if (at !== -1)
+        s = s.slice(at + 1);
+    // 4. Strip a numeric port: `https://host:8443/org/repo`, `host:8443/
+    //    org/repo` and `host/org/repo` are the same repository served
+    //    over different transports — they must fold to one id or the
+    //    team silently splits by transport form. The scp-style
+    //    `host:path` form (path not starting with digits) is rewritten
+    //    by the step below.
+    s = s.replace(/^([^/]+):(\d+)(\/|$)/, "$1$3");
+    // 5. scp-style `host:path` → `host/path`. The first `:` that
+    //    remains is the separator; everything after it is the path.
+    //    After step 3 there is no userinfo `:` left to confuse it.
+    const colon = s.indexOf(":");
+    if (colon !== -1) {
+        s = `${s.slice(0, colon)}/${s.slice(colon + 1)}`;
+    }
+    // 6. Strip a trailing `/`.
+    s = s.replace(/\/+$/, "");
+    // 7. Lowercase.
+    s = s.toLowerCase();
+    if (s.length === 0)
+        return null;
+    // Anything without a `/` is a bare host or a bare local name,
+    // not a remote repository path — the caller falls through.
+    if (!s.includes("/"))
+        return null;
+    // A leading `/` means the remote is a local filesystem path
+    // (e.g. `/srv/git/bare.git` or a `file://` remote) — plan §5.1's
+    // fifth fixture — and the caller falls through to source 3.
+    if (s.startsWith("/"))
+        return null;
+    return s;
+}
+/**
+ * Derive a repository id from a normalized remote (K8-006).
+ *
+ * The domain prefix means a repo id can never collide with a memory
+ * fingerprint computed over the same string, and it leaves room to
+ * version the derivation later.
+ */
+export function computeRepoId(normalized) {
+    return fnv1a64(`okf:repo:v1\u0000${normalized}`);
+}
+/**
+ * Resolve the repository identity for `cwd`, trying the four
+ * sources in order (plan §5.2, D9-13):
+ *
+ *   1. `declared` — `.kevin/project.json` → `id` (validated as
+ *      exactly 16 lowercase hex characters; anything else is ignored
+ *      and falls through, because a hand-edited garbage id in a
+ *      committed file would otherwise scope a whole team's corpus
+ *      onto a typo);
+ *   2. `remote` — `.git/config` → `[remote "origin"] url`,
+ *      normalized and hashed;
+ *   3. `host` — the value the host resolved for this directory,
+ *      `host.project.worktree` first, `host.project.directory` as
+ *      fallback; both empty or absent falls through to `path`.
+ *      This is strictly better than `process.cwd()` — the host's own
+ *      ToolContext documents "prefer this over `process.cwd()`" —
+ *      but it sits below the explicit sources, because monorepos and
+ *      D8-03's confirmed re-keying depend on `.kevin/project.json`
+ *      winning;
+ *   4. `path` — `fingerprint(cwd)`, the v0.7.0 behaviour, preserved
+ *      exactly when `host` is absent.
+ *
+ * Never throws: a directory that is not a git repository, an
+ * unreadable `.git/config`, a malformed `project.json`, and a host
+ * with no usable project fields all fall through to source 4.
+ * `projectId` is always returned alongside `repoId`, regardless of
+ * which source won.
+ */
+export function resolve(cwd, host) {
+    const projectId = fingerprint(cwd);
+    // 1. Declared.
+    try {
+        const raw = readFileSync(join(cwd, PROJECT_JSON_PATH), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.id === "string" && DECLARED_ID_RE.test(parsed.id)) {
+            return {
+                repoId: parsed.id,
+                source: "declared",
+                evidence: ".kevin/project.json#id",
+                projectId,
+            };
+        }
+    }
+    catch {
+        // Missing, unreadable, or malformed — fall through.
+    }
+    // 2. Remote.
+    try {
+        const config = readFileSync(join(cwd, GIT_CONFIG_PATH), "utf8");
+        const url = parseGitConfigRemote(config);
+        const normalized = url === null ? null : normalizeRemote(url);
+        if (normalized !== null) {
+            return {
+                repoId: computeRepoId(normalized),
+                source: "remote",
+                evidence: `remote:${normalized}`,
+                projectId,
+            };
+        }
+    }
+    catch {
+        // Unreadable or missing — fall through.
+    }
+    // 3. Host — the value the host already resolved for this
+    //    directory (D9-13), inserted above `path` and below the two
+    //    explicit sources. `worktree` first, `directory` as fallback;
+    //    both empty or absent falls through. The chosen value feeds
+    //    the unchanged `computeRepoId()` — this chain changes which
+    //    string is hashed, never how.
+    const worktree = host?.project?.worktree;
+    if (typeof worktree === "string" && worktree.length > 0) {
+        return {
+            repoId: computeRepoId(worktree),
+            source: "host",
+            evidence: "host:worktree",
+            projectId,
+        };
+    }
+    const directory = host?.project?.directory;
+    if (typeof directory === "string" && directory.length > 0) {
+        return {
+            repoId: computeRepoId(directory),
+            source: "host",
+            evidence: "host:directory",
+            projectId,
+        };
+    }
+    // 4. Path — the v0.7.0 behaviour, preserved exactly.
+    return { repoId: projectId, source: "path", evidence: "cwd", projectId };
+}
+/**
+ * Write `.kevin/project.json` pinning the repository identity (K8-008
+ * / plan §5.8). The id comes from the current `resolve(cwd)` — so `init`
+ * in a repository with a remote *pins* the remote-derived id, which is
+ * the point: it survives the organisation renaming the repo (a remote
+ * URL change would otherwise silently re-scope the corpus).
+ *
+ * The file is `{"id": "<16 hex>", "created_at": "<ISO-8601 Z>",
+ * "generator": "opencode-kevin/0.8.0"}` with sorted keys and a
+ * terminating newline (deterministic bytes, the codec discipline of
+ * plan §7.3). `init` refuses when the file already exists: overwriting
+ * it re-scopes a team's corpus, and that is `rekey`'s job (K8-009),
+ * with a confirmation.
+ *
+ * NOTE (K8-019): the write goes through `ArtifactWriter` in whole-file
+ * mode — `.kevin/project.json` is a Kevin-owned file, and D8-08 leaves
+ * no scenario in which a second raw write path is acceptable (asserted
+ * by tests/unit/single_write_path.test.ts).
+ */
+export function initProjectFile(cwd, writer) {
+    const path = join(cwd, PROJECT_JSON_PATH);
+    try {
+        readFileSync(path, "utf8");
+        return {
+            ok: false,
+            path,
+            reason: `.kevin/project.json already exists — overwriting it would re-scope the corpus; use "kevin_project rekey" instead`,
+        };
+    }
+    catch {
+        // Absent or unreadable — proceed.
+    }
+    const id = resolve(cwd).repoId;
+    const createdAt = new Date().toISOString();
+    const payload = `${JSON.stringify({
+        created_at: createdAt,
+        generator: "opencode-kevin/0.9.0",
+        id,
+    })}\n`;
+    try {
+        mkdirSync(join(cwd, ".kevin"), { recursive: true });
+        const outcome = writer.write({ path, mode: "whole", content: payload });
+        if (outcome !== "written") {
+            return {
+                ok: false,
+                path,
+                reason: `could not write .kevin/project.json: ${outcome}`,
+            };
+        }
+        return { ok: true, path, id, createdAt };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            path,
+            reason: `could not write .kevin/project.json: ${err?.message ?? "unknown error"}`,
+        };
+    }
+}
+//# sourceMappingURL=RepoIdentity.js.map

package/dist/plugin/RepoIdentity.js.map

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

package/dist/plugin/Retrospective.js

@@ -49,6 +49,24 @@ export const METRIC_KEY_LABELS = {
     conventions_mined: "Convenciones minadas",
     conflicts_detected: "Conflictos detectados",
     error_lessons_suppressed: "Lecciones de error suprimidas",
+    // v0.8.0 (K8-003 / plan §8.16) — the K8 metric keys need their own
+    // Spanish labels; the audit regression forbids raw-key fallback for any
+    // key in METRIC_KEYS.
+    shared_entries_total: "Entradas compartidas (totales)",
+    shared_entries_imported: "Entradas compartidas importadas",
+    shared_entries_exported: "Entradas compartidas exportadas",
+    okf_merge_folds: "Fusiones OKF (folds)",
+    rekey_events: "Re-keys de repositorio",
+    injections_from_shared: "Inyecciones desde la capa compartida",
+    // v0.9.0 (K9-003 / plan §8.16) — the K9 metric keys need their own
+    // Spanish labels; the audit regression forbids raw-key fallback for any
+    // key in METRIC_KEYS.
+    hook_fires_total: "Disparos de hooks (totales)",
+    hook_errors_total: "Errores de hooks",
+    hooks_dead_total: "Hooks muertos",
+    injections_suppressed_dead_hook: "Inyecciones suprimidas (hook muerto)",
+    native_registrations_total: "Registros nativos (totales)",
+    native_registration_failures: "Fallos de registro nativo",
 };
 function originLabel(origin) {
     if (origin === "reflector")

package/dist/plugin/Retrospective.js.map

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

package/dist/plugin/SharedLayer.d.ts

@@ -0,0 +1,159 @@
+import type { ArtifactWriter, WriteOutcome, WritePlan, WriteRequest } from "./ArtifactWriter.js";
+import { type ParseResult } from "./okf.js";
+export interface ImportReport {
+    path: string;
+    /** null when the file does not exist. */
+    fileHash: string | null;
+    parsed: number;
+    folded: number;
+    rejected: number;
+    /** rows inserted or updated in shared_entries. */
+    imported: number;
+    /** shared memories retired by an incoming tombstone. */
+    tombstoned: number;
+    /** true when fileHash matches the last okf_imports row. */
+    skipped: boolean;
+}
+/**
+ * A planned (or applied) export (K8-020 / plan §5.5). The refusal is
+ * carried by the write plan itself — `outcome: "refused"` with both
+ * hashes audited — so a refused plan is indistinguishable from a
+ * written one until `outcome` is read.
+ */
+export interface ExportPlan {
+    path: string;
+    /** The whole-mode write request; applying re-plans through the single write funnel. */
+    request: WriteRequest;
+    /** The pure preview from planning time — diff and outcome, nothing written. */
+    write: WritePlan;
+    /** Entry ids in the merged corpus absent from the current file. */
+    entriesAdded: number;
+    /** Set by applyExport: the outcome of the actual write. */
+    applied?: WriteOutcome;
+}
+export declare class SharedLayer {
+    private readonly store;
+    private readonly repoId;
+    private readonly projectId;
+    private readonly version;
+    private readonly writer;
+    constructor(deps: {
+        store: StoreLike;
+        repoId: string;
+        projectId: string;
+        version: string;
+        writer: ArtifactWriter;
+    });
+    /**
+     * The single whole-file (mode `whole`) construction site in
+     * SharedLayer (K8-019 / K8-020, D8-08, asserted by
+     * tests/unit/single_write_path.test.ts): the OKF file is written
+     * through the ArtifactWriter's write funnel like every other file
+     * Kevin owns — there is no second write path.
+     */
+    private wholeRequest;
+    /**
+     * Pure export planner (K8-020 / plan §5.5): reads the current file
+     * and merges the given local memories' projections into the corpus,
+     * producing a {@link WritePlan} — but writes nothing. Refusals are
+     * audited like any other write: `after === before`, both hashes
+     * recorded (D6-04). The refusal ladder, in the order the code
+     * evaluates it — file-side refusals first (not_okf, version_ahead,
+     * repo_mismatch), then candidate-side refusals in the loop order
+     * (line_too_long, below_floor, not_curated, unknown_entry), then
+     * too_many_entries and finally parse_damaged.
+     */
+    planExport(memoryIds: string[], path: string): ExportPlan;
+    /**
+     * Tombstone-append planner (K8-020 / D8-09): emits one `tombstone`
+     * line per entry id, never deletes a line. The identifying triple is
+     * reconstructed from the local projection (a memory with
+     * `shared_entry_id`) so the line still passes parse's
+     * tamper-evident entry_id check; an id with no local projection is
+     * refused rather than emitting an invalid line.
+     */
+    planTombstone(entryIds: string[], path: string): ExportPlan;
+    /**
+     * v0.8.0 (BUG-003) — heal a stale `#repo` header after a rekey.
+     * Rekey changes the scope the file is written under; a stale first
+     * line would make every later planExport/planTombstone refuse with
+     * repo_mismatch forever. Only the header line is replaced; the entry
+     * bytes, line endings and trailing newline are preserved. The write
+     * goes through the single funnel (D8-08). Returns true when the
+     * header was rewritten. Never throws: a missing or unreadable file
+     * is nothing to heal.
+     */
+    healHeader(path: string, newRepoId: string): boolean;
+    /**
+     * Apply a previously planned export: the write goes through the
+     * single write funnel (re-planning against the file's current state),
+     * and the outcome is recorded on the returned plan (K8-020).
+     */
+    applyExport(plan: ExportPlan): ExportPlan;
+    /** Refusal plans are audited with both hashes (after === before). */
+    private refused;
+    /**
+     * Convert the requested local memories into OKF candidates and run
+     * the candidate-side refusals — line_too_long, below_floor,
+     * not_curated — in plan §5.5 order.
+     */
+    private candidateEntries;
+    private setting;
+    private readWithFlag;
+    /**
+     * Read and parse the shared file. Total: a missing or unreadable
+     * file yields an empty ParseResult, never a throw (D8-14).
+     */
+    read(path: string): ParseResult;
+    /**
+     * Idempotent and cheap to call (K8-016 / plan §5.5): hash the file
+     * first and return `{ skipped: true }` when the hash matches the
+     * most recent `okf_imports` row for this repo_id — the session.idle
+     * path costs one readFileSync plus one hash on an unchanged
+     * repository. A missing file is not an error: it returns
+     * `fileHash: null`, `parsed: 0`, and still writes an audit row.
+     */
+    import(path: string): ImportReport;
+    private writeImportRow;
+    /**
+     * Project every imported entry into memories (K8-017 / plan §5.5,
+     * D8-10): a shared memory IS a memory, so getRelevant(), rankScore(),
+     * the five gates, truth_penalty, ConflictDetector and every audit
+     * rollup keep working unchanged.
+     *
+     * - assert entries: inserted once, never updated — re-importing an
+     *   unchanged file must not create duplicates, bump evidence_count or
+     *   move updated_at. `fingerprint` is deliberately left NULL: it is a
+     *   different identity dimension (plan §3.3) and conflating it with
+     *   `shared_entry_id` would make the v0.4.0 supersede path fire on
+     *   unrelated entries (K8-017 acceptance).
+     * - tombstone entries: the ONE place in this codebase where the shared
+     *   layer may write memories.status. This is NOT a v0.7.0 Principle 24
+     *   violation: that principle forbids *contradiction* — a fuzzy
+     *   inference — from writing status, and a tombstone is the opposite:
+     *   an explicit, committed, human-reviewed decision that arrived
+     *   through a pull request (D8-09, plan §5.5).
+     *
+     * Returns the number of memories archived by tombstones.
+     */
+    private projectEntries;
+    /**
+     * Upsert every entry into shared_entries keyed on (repo_id,
+     * entry_id) — the UNIQUE index from migration 009 makes this an
+     * upsert rather than an append. `confidence` is the DERIVED value
+     * (deriveConfidence), never a transported float (plan §5.3).
+     * Returns the number of rows inserted or updated.
+     */
+    private upsertEntries;
+}
+/**
+ * The Store surface SharedLayer needs. Kept structural so tests can
+ * use the real Store without importing plugin internals.
+ */
+export interface StoreLike {
+    prepare(sql: string): {
+        get(...params: unknown[]): unknown;
+        all(...params: unknown[]): unknown[];
+        run(...params: unknown[]): void;
+    };
+}