oh-my-second-brain 0.1.9 → 0.2.0

package/dist/conventions/write-protocol.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Write Protocol: Admission & Acceptance contract with explicit rejection & receipt.
+ *
+ * Response Shape Contract:
+ * - `written` results carry `receipt` (persisted, postcondition-verified) and no `rejection`.
+ * - `rejected` results (and contract-fixable `ask` results) carry `rejection` and no `receipt`.
+ * - `inbox` results carry NEITHER (inbox is a routing plan; nothing is persisted).
+ * - `dryRun` results carry NO receipt (a receipt attests a persisted, postcondition-verified write).
+ *
+ * Rejection Model (gajae-code reference: error{code, message, recoverable} + remediation):
+ * Each rejection carries a stage (admission or acceptance), code, message, and recoverable flag
+ * derived exhaustively from a per-code table. This ensures adding a code without a recoverable
+ * entry is a compile error.
+ */
+import type { VaultSource } from "../link/link.js";
+import type { WriteMode } from "../capture/safe.js";
+export type WriteStage = "admission" | "acceptance";
+export type WriteTargetSource = VaultSource | "explicit";
+export type WriteRejectionCode = "target-unverified" | "target-invalid" | "path-unsafe" | "note-exists" | "note-missing" | "concept-unbound" | "contract-violation" | "body-missing" | "args-invalid" | "postcondition-failed";
+export interface WriteRejection {
+    stage: WriteStage;
+    code: WriteRejectionCode;
+    message: string;
+    recoverable: boolean;
+    remediation: string;
+}
+export interface WriteReceipt {
+    resolvedVault: string;
+    resolutionSource: WriteTargetSource;
+    notePath: string;
+    mode: WriteMode;
+    concept: string | null;
+    postconditionVerified: boolean;
+}
+/**
+ * Create a WriteRejection with stage, code, message, and remediation.
+ * The recoverable flag is derived exhaustively from the per-code table.
+ */
+export declare function rejection(stage: WriteStage, code: WriteRejectionCode, message: string, remediation: string): WriteRejection;

package/dist/conventions/write-protocol.js

@@ -0,0 +1,44 @@
+/**
+ * Write Protocol: Admission & Acceptance contract with explicit rejection & receipt.
+ *
+ * Response Shape Contract:
+ * - `written` results carry `receipt` (persisted, postcondition-verified) and no `rejection`.
+ * - `rejected` results (and contract-fixable `ask` results) carry `rejection` and no `receipt`.
+ * - `inbox` results carry NEITHER (inbox is a routing plan; nothing is persisted).
+ * - `dryRun` results carry NO receipt (a receipt attests a persisted, postcondition-verified write).
+ *
+ * Rejection Model (gajae-code reference: error{code, message, recoverable} + remediation):
+ * Each rejection carries a stage (admission or acceptance), code, message, and recoverable flag
+ * derived exhaustively from a per-code table. This ensures adding a code without a recoverable
+ * entry is a compile error.
+ */
+/**
+ * Exhaustive recovery table: maps each rejection code to its recoverable flag.
+ * Adding a code without an entry is a compile error.
+ */
+const RECOVERABLE_BY_CODE = {
+    "target-unverified": true,
+    "contract-violation": true,
+    "body-missing": true,
+    "args-invalid": true,
+    "path-unsafe": true,
+    "note-exists": false,
+    "note-missing": false,
+    "concept-unbound": false,
+    "target-invalid": false,
+    "postcondition-failed": false,
+};
+/**
+ * Create a WriteRejection with stage, code, message, and remediation.
+ * The recoverable flag is derived exhaustively from the per-code table.
+ */
+export function rejection(stage, code, message, remediation) {
+    return {
+        stage,
+        code,
+        message,
+        remediation,
+        recoverable: RECOVERABLE_BY_CODE[code],
+    };
+}
+//# sourceMappingURL=write-protocol.js.map

package/dist/conventions/write-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-protocol.js","sourceRoot":"","sources":["../../src/conventions/write-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsCH;;;GAGG;AACH,MAAM,mBAAmB,GAAwC;IAC/D,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,IAAI;IAC1B,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,KAAK;IACxB,gBAAgB,EAAE,KAAK;IACvB,sBAAsB,EAAE,KAAK;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,KAAiB,EACjB,IAAwB,EACxB,OAAe,EACf,WAAmB;IAEnB,OAAO;QACL,KAAK;QACL,IAAI;QACJ,OAAO;QACP,WAAW;QACX,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/core/runtime/assets.d.ts

@@ -10,5 +10,11 @@ export declare class MissingBundledAssetRootError extends Error {
     readonly assetRootId: BundledAssetRootId;
     constructor(assetRootId: BundledAssetRootId);
 }
+/**
+ * Reads `version` from the bundled package.json. Synchronous by contract: the
+ * MCP server info is built during (sync) server construction, and this reads a
+ * single small file that ships inside the package.
+ */
+export declare function readBundledPackageVersion(packageRoot?: string): string;
 export declare function resolveBundledAssetPaths(moduleUrl?: string, runtimeAssetRoots?: readonly HarnessRuntimeAssetRoot[]): BundledAssetPaths;
 export {};

package/dist/core/runtime/assets.js

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { harnessSurfaceRegistry } from "../../harness/surface-registry.js";
@@ -26,6 +27,32 @@ function packageRootFromModulePath(modulePath) {
     }
     return path.resolve(path.dirname(modulePath), "../..");
 }
+/**
+ * Version reported when the bundled manifest cannot be read or declares no
+ * string `version`. Callers embed this in server handshakes at construction
+ * time, so a missing/corrupt manifest must degrade rather than abort boot.
+ */
+const UNKNOWN_PACKAGE_VERSION = "0.0.0";
+/**
+ * Reads `version` from the bundled package.json. Synchronous by contract: the
+ * MCP server info is built during (sync) server construction, and this reads a
+ * single small file that ships inside the package.
+ */
+export function readBundledPackageVersion(packageRoot = resolveBundledAssetPaths().packageRoot) {
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(path.join(packageRoot, "package.json"), "utf-8"));
+    }
+    catch (error) {
+        if (error instanceof Error)
+            return UNKNOWN_PACKAGE_VERSION;
+        throw error;
+    }
+    const version = typeof manifest === "object" && manifest !== null && "version" in manifest
+        ? manifest.version
+        : undefined;
+    return typeof version === "string" ? version : UNKNOWN_PACKAGE_VERSION;
+}
 export function resolveBundledAssetPaths(moduleUrl = import.meta.url, runtimeAssetRoots = harnessSurfaceRegistry.packageAssets.runtimeAssetRoots) {
     const modulePath = fileURLToPath(moduleUrl);
     const packageRoot = packageRootFromModulePath(modulePath);

package/dist/core/runtime/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/core/runtime/assets.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAgC,MAAM,mCAAmC,CAAC;AAWzG,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAChC;IAArB,YAAqB,WAA+B;QAClD,KAAK,CAAC,mDAAmD,WAAW,EAAE,CAAC,CAAC;QADrD,gBAAW,GAAX,WAAW,CAAoB;QAElD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,wBAAwB,CAC/B,iBAAqD,EACrD,EAAsB;IAEtB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC;AAED,SAAS,yBAAyB,CAAC,UAAkB;IACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,EACtC,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CACtC,CAAC;IAEF,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QAClE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC;QACzE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,YAAoB,MAAM,CAAC,IAAI,CAAC,GAAG,EACnC,oBAAwD,sBAAsB,CAAC,aAAa,CAAC,iBAAiB;IAE9G,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAE1D,OAAO;QACL,WAAW;QACX,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC5F,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC5F,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;KACxG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/core/runtime/assets.ts"],"names":[],"mappings":"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"}

package/dist/engine/graph/resolver.d.ts

@@ -8,6 +8,14 @@ export interface WikilinkIndex {
     readonly byBasename: ReadonlyMap<string, readonly string[]>;
     /** Lowercase vault-relative path (with .md) → original-case vault-relative path. */
     readonly byPath: ReadonlyMap<string, string>;
+    /** Lowercase frontmatter alias → list of vault-relative paths declaring it. */
+    readonly byAlias: ReadonlyMap<string, readonly string[]>;
+}
+/** A vault document paired with its already-parsed frontmatter. */
+export interface IndexedDoc {
+    /** Vault-relative path (original case, with .md). */
+    readonly path: string;
+    readonly frontmatter: Record<string, unknown>;
 }
 /** Result of resolving a single raw wikilink against the vault file set. */
 export interface WikilinkResolution {
@@ -24,6 +32,14 @@ export interface WikilinkResolution {
  * O(n) construction; call once per graph build pass.
  */
 export declare function buildWikilinkIndex(vaultFiles: readonly string[]): WikilinkIndex;
+/**
+ * Build a wikilink index that also resolves frontmatter `aliases` declarations.
+ *
+ * Same path/basename behaviour as {@link buildWikilinkIndex}, plus a `byAlias`
+ * map so `[[Ataraxia]]` reaches a note whose frontmatter declares that alias.
+ * Non-string, blank, and non-array `aliases` values are ignored.
+ */
+export declare function buildWikilinkIndexWithFrontmatter(docs: readonly IndexedDoc[]): WikilinkIndex;
 /**
  * Resolve a raw `[[wikilink]]` string to a vault-relative document path.
  *
@@ -31,6 +47,7 @@ export declare function buildWikilinkIndex(vaultFiles: readonly string[]): Wikil
  *  1. Exact vault-relative path (case-insensitive, `.md` optional)
  *  2. Basename match (case-insensitive) — when ambiguous, shortest path wins;
  *     ties broken alphabetically
+ *  3. Frontmatter `aliases` match (case-insensitive), same tie-break
  *
  * Returns `{ docPath: null }` when unresolvable.  Callers must **not** throw;
  * instead they should emit a `kind: "unknown-ref"` GraphEdge with weight 0.

package/dist/engine/graph/resolver.js

@@ -9,6 +9,7 @@ import path from "node:path";
 export function buildWikilinkIndex(vaultFiles) {
     const byBasename = new Map();
     const byPath = new Map();
+    const byAlias = new Map();
     for (const f of vaultFiles) {
         // exact-path lookup (normalised to lowercase with .md)
         const normalised = f.toLowerCase();
@@ -20,7 +21,45 @@ export function buildWikilinkIndex(vaultFiles) {
         bucket.push(f);
         byBasename.set(base, bucket);
     }
-    return { byBasename, byPath };
+    return { byBasename, byPath, byAlias };
+}
+/**
+ * Build a wikilink index that also resolves frontmatter `aliases` declarations.
+ *
+ * Same path/basename behaviour as {@link buildWikilinkIndex}, plus a `byAlias`
+ * map so `[[Ataraxia]]` reaches a note whose frontmatter declares that alias.
+ * Non-string, blank, and non-array `aliases` values are ignored.
+ */
+export function buildWikilinkIndexWithFrontmatter(docs) {
+    const { byBasename, byPath } = buildWikilinkIndex(docs.map((d) => d.path));
+    const byAlias = new Map();
+    for (const doc of docs) {
+        for (const alias of aliasStrings(doc.frontmatter["aliases"])) {
+            const key = alias.toLowerCase();
+            const bucket = byAlias.get(key) ?? [];
+            bucket.push(doc.path);
+            byAlias.set(key, bucket);
+        }
+    }
+    return { byBasename, byPath, byAlias };
+}
+/** Flatten an unknown frontmatter `aliases` value to trimmed non-empty strings. */
+function aliasStrings(value) {
+    if (Array.isArray(value))
+        return value.flatMap(aliasStrings);
+    if (typeof value !== "string")
+        return [];
+    const trimmed = value.trim();
+    return trimmed ? [trimmed] : [];
+}
+/** Shortest path wins; ties broken alphabetically. */
+function bestCandidate(candidates) {
+    if (candidates === undefined || candidates.length === 0)
+        return null;
+    const sorted = candidates
+        .slice()
+        .sort((a, b) => a.split("/").length - b.split("/").length || a.localeCompare(b));
+    return sorted[0] ?? null;
 }
 // ---------------------------------------------------------------------------
 // Link parsing helpers
@@ -57,6 +96,7 @@ function cleanLinkTarget(raw) {
  *  1. Exact vault-relative path (case-insensitive, `.md` optional)
  *  2. Basename match (case-insensitive) — when ambiguous, shortest path wins;
  *     ties broken alphabetically
+ *  3. Frontmatter `aliases` match (case-insensitive), same tie-break
  *
  * Returns `{ docPath: null }` when unresolvable.  Callers must **not** throw;
  * instead they should emit a `kind: "unknown-ref"` GraphEdge with weight 0.
@@ -72,16 +112,11 @@ export function resolveWikilink(rawLink, index) {
     if (exactHit !== undefined)
         return { target, docPath: exactHit };
     // 2. Basename match — shortest path wins, ties broken alphabetically
-    const base = path.basename(lc, ".md");
-    const candidates = index.byBasename.get(base);
-    if (candidates !== undefined && candidates.length > 0) {
-        const sorted = candidates
-            .slice()
-            .sort((a, b) => a.split("/").length - b.split("/").length || a.localeCompare(b));
-        const best = sorted[0] ?? null;
-        return { target, docPath: best };
-    }
-    return { target, docPath: null };
+    const byBasenameHit = bestCandidate(index.byBasename.get(path.basename(lc, ".md")));
+    if (byBasenameHit !== null)
+        return { target, docPath: byBasenameHit };
+    // 3. Frontmatter alias match — same tie-break
+    return { target, docPath: bestCandidate(index.byAlias.get(lc)) };
 }
 // ---------------------------------------------------------------------------
 // Convenience: batch-convert wikilink strings to GraphEdge[]

package/dist/engine/graph/resolver.js.map

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

package/dist/engine/linkify/apply.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Link application: splice accepted candidates into a note body and persist
+ * through the capture kernel.
+ *
+ * This is the only linkify module with a side effect, and even here the effect
+ * is injected — `writeNote` arrives as a parameter, `node:fs` is never imported,
+ * and the capture kernel is referenced by TYPE only. mask.ts and suggest.ts stay
+ * pure; every disk decision (path safety, concept contract, postcondition
+ * re-read) remains the kernel's, unduplicated here.
+ *
+ * Optimistic concurrency: candidates carry absolute offsets into the body they
+ * were computed from. If that body changed, the offsets are lies. `applyLinks`
+ * therefore re-hashes the body it is handed and refuses to write on any
+ * mismatch, on any candidate whose recorded text no longer sits at its offsets,
+ * and on any overlapping pair — three independent ways the same corruption
+ * could otherwise reach disk.
+ */
+import type { WriteNoteInput, WriteNoteResult } from "../../capture/safe.js";
+import type { LinkCandidate } from "./types.js";
+/** The capture-kernel seam apply persists through (structurally `writeNote`). */
+export type WriteNoteLike = (input: WriteNoteInput) => Promise<WriteNoteResult>;
+/** Everything the kernel needs to address the note, minus the body apply supplies. */
+export type LinkifyWriteTarget = Omit<WriteNoteInput, "mode" | "dryRun" | "body" | "frontmatter">;
+/** Why an apply attempt produced no write. */
+export type ApplyRefusal = "note-changed" | "no-candidates" | "candidate-drift" | "overlapping-candidates" | "write-rejected";
+/** Outcome of {@link applyLinks}: a written body, or a typed refusal. */
+export type ApplyResult = {
+    readonly applied: true;
+    readonly body: string;
+    readonly contentHash: string;
+    readonly write: WriteNoteResult;
+} | {
+    readonly applied: false;
+    readonly reason: ApplyRefusal;
+    readonly write?: WriteNoteResult;
+};
+/** Inputs for {@link applyLinks}, grouped so the call site stays readable. */
+export interface ApplyLinksInput {
+    /** The note body the candidates were computed against. */
+    readonly body: string;
+    /** sha256 hex of that body, taken when the candidates were produced. */
+    readonly baseContentHash: string;
+    /** The candidates the caller (or user) accepted. */
+    readonly accepted: readonly LinkCandidate[];
+    readonly writeNote: WriteNoteLike;
+    readonly target: LinkifyWriteTarget;
+}
+/** sha256 hex digest of a note body — the optimistic-concurrency token. */
+export declare function hashBody(body: string): string;
+/**
+ * Apply accepted link candidates to a note body and persist the result.
+ *
+ * Returns `{ applied: false, reason }` — with no write attempted — whenever the
+ * body has drifted from the snapshot the candidates were computed against.
+ */
+export declare function applyLinks(input: ApplyLinksInput): Promise<ApplyResult>;

package/dist/engine/linkify/apply.js

@@ -0,0 +1,65 @@
+/**
+ * Link application: splice accepted candidates into a note body and persist
+ * through the capture kernel.
+ *
+ * This is the only linkify module with a side effect, and even here the effect
+ * is injected — `writeNote` arrives as a parameter, `node:fs` is never imported,
+ * and the capture kernel is referenced by TYPE only. mask.ts and suggest.ts stay
+ * pure; every disk decision (path safety, concept contract, postcondition
+ * re-read) remains the kernel's, unduplicated here.
+ *
+ * Optimistic concurrency: candidates carry absolute offsets into the body they
+ * were computed from. If that body changed, the offsets are lies. `applyLinks`
+ * therefore re-hashes the body it is handed and refuses to write on any
+ * mismatch, on any candidate whose recorded text no longer sits at its offsets,
+ * and on any overlapping pair — three independent ways the same corruption
+ * could otherwise reach disk.
+ */
+import { createHash } from "node:crypto";
+/** sha256 hex digest of a note body — the optimistic-concurrency token. */
+export function hashBody(body) {
+    return createHash("sha256").update(body, "utf-8").digest("hex");
+}
+/** True when any two candidates claim overlapping body ranges. */
+function hasOverlap(sorted) {
+    return sorted.some((candidate, index) => {
+        const previous = sorted[index - 1];
+        return previous !== undefined && candidate.startOffset < previous.endOffset;
+    });
+}
+/** True when every candidate's recorded text still sits at its offsets. */
+function offsetsIntact(body, candidates) {
+    return candidates.every((candidate) => body.slice(candidate.startOffset, candidate.endOffset) === candidate.matchedText);
+}
+/** Splice replacements right-to-left so untouched offsets stay valid. */
+function splice(body, sorted) {
+    return sorted.reduceRight((acc, candidate) => acc.slice(0, candidate.startOffset) + candidate.renderedReplacement + acc.slice(candidate.endOffset), body);
+}
+/**
+ * Apply accepted link candidates to a note body and persist the result.
+ *
+ * Returns `{ applied: false, reason }` — with no write attempted — whenever the
+ * body has drifted from the snapshot the candidates were computed against.
+ */
+export async function applyLinks(input) {
+    if (hashBody(input.body) !== input.baseContentHash) {
+        return { applied: false, reason: "note-changed" };
+    }
+    if (input.accepted.length < 1) {
+        return { applied: false, reason: "no-candidates" };
+    }
+    const sorted = input.accepted.slice().sort((a, b) => a.startOffset - b.startOffset);
+    if (hasOverlap(sorted)) {
+        return { applied: false, reason: "overlapping-candidates" };
+    }
+    if (!offsetsIntact(input.body, sorted)) {
+        return { applied: false, reason: "candidate-drift" };
+    }
+    const body = splice(input.body, sorted);
+    const write = await input.writeNote({ ...input.target, mode: "update", dryRun: false, body });
+    if (write.status !== "written") {
+        return { applied: false, reason: "write-rejected", write };
+    }
+    return { applied: true, body, contentHash: hashBody(body), write };
+}
+//# sourceMappingURL=apply.js.map

package/dist/engine/linkify/apply.js.map

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

package/dist/engine/linkify/josa.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Korean josa (조사) table + stem matcher for the linkify span detector.
+ *
+ * Why this exists: Korean is agglutinative, so a vault term almost never appears
+ * bare in prose — "아타락시아" shows up as "아타락시아를", "아타락시아는",
+ * "아타락시아에서". A plain word-boundary matcher misses every one of them, and a
+ * plain prefix matcher over-matches ("학교" inside "학교폭력").
+ *
+ * The rule this module encodes: a term matches a token when the term is a prefix
+ * and the remainder is a KNOWN particle from the table below (or empty). An
+ * unknown remainder is NOT a match — there is no morphological analysis here and
+ * no guessing. Latin-script terms get ordinary case-insensitive whole-token
+ * matching; particle logic never applies to them.
+ *
+ * Pure module: no I/O, no state. Tokenisation grain matches
+ * src/engine/graph/node.ts::tokenize (\p{L}/\p{N} runs), so callers can feed it
+ * whitespace/punctuation-delimited tokens directly.
+ */
+/**
+ * Common Korean particles, ≤2 syllables, that may directly follow a noun.
+ *
+ * Plain reviewable data, grouped by role. Deliberately conservative: only
+ * particles that attach to a bare noun stem are listed, because anything longer
+ * or more contextual (verb endings such as "하게", "이라는") is exactly the case
+ * the matcher must reject rather than guess at.
+ */
+export declare const KOREAN_PARTICLES: readonly ["이", "가", "께서", "은", "는", "을", "를", "의", "에", "에서", "에게", "께", "한테", "으로", "로", "와", "과", "하고", "이랑", "랑", "보다", "부터", "까지", "에도", "에는", "도", "만", "조차", "마저", "밖에", "이나", "이란", "란", "이다"];
+/** A particle string drawn from {@link KOREAN_PARTICLES}. */
+export type KoreanParticle = (typeof KOREAN_PARTICLES)[number];
+/**
+ * Outcome of matching a term against a single token.
+ *
+ * Offsets are UTF-16 code-unit indices into the token, so `token.slice(stemStart,
+ * stemEnd)` yields the stem the caller should wrap. Particle fields are null on
+ * a bare match (no trailing particle).
+ */
+export type JosaMatch = {
+    readonly kind: "match";
+    readonly stem: string;
+    readonly stemStart: number;
+    readonly stemEnd: number;
+    readonly particle: string | null;
+    readonly particleStart: number | null;
+    readonly particleEnd: number | null;
+} | {
+    readonly kind: "no_match";
+};
+/** True when the remainder is a known particle short enough to be one. */
+export declare function isKnownParticle(remainder: string): boolean;
+/**
+ * Match `term` inside a single whitespace/punctuation-delimited `token`.
+ *
+ * Korean-final terms accept one trailing particle from {@link KOREAN_PARTICLES};
+ * the returned span covers the stem only. Every other trailing remainder is a
+ * no-match. Latin/other-script terms require the whole token to equal the term
+ * (case-insensitive) — no particle absorption, no partial-word hits.
+ */
+export declare function matchTermInToken(term: string, token: string): JosaMatch;

package/dist/engine/linkify/josa.js

@@ -0,0 +1,133 @@
+/**
+ * Korean josa (조사) table + stem matcher for the linkify span detector.
+ *
+ * Why this exists: Korean is agglutinative, so a vault term almost never appears
+ * bare in prose — "아타락시아" shows up as "아타락시아를", "아타락시아는",
+ * "아타락시아에서". A plain word-boundary matcher misses every one of them, and a
+ * plain prefix matcher over-matches ("학교" inside "학교폭력").
+ *
+ * The rule this module encodes: a term matches a token when the term is a prefix
+ * and the remainder is a KNOWN particle from the table below (or empty). An
+ * unknown remainder is NOT a match — there is no morphological analysis here and
+ * no guessing. Latin-script terms get ordinary case-insensitive whole-token
+ * matching; particle logic never applies to them.
+ *
+ * Pure module: no I/O, no state. Tokenisation grain matches
+ * src/engine/graph/node.ts::tokenize (\p{L}/\p{N} runs), so callers can feed it
+ * whitespace/punctuation-delimited tokens directly.
+ */
+// ---------------------------------------------------------------------------
+// Particle table
+// ---------------------------------------------------------------------------
+/**
+ * Common Korean particles, ≤2 syllables, that may directly follow a noun.
+ *
+ * Plain reviewable data, grouped by role. Deliberately conservative: only
+ * particles that attach to a bare noun stem are listed, because anything longer
+ * or more contextual (verb endings such as "하게", "이라는") is exactly the case
+ * the matcher must reject rather than guess at.
+ */
+export const KOREAN_PARTICLES = [
+    // subject (주격)
+    "이",
+    "가",
+    "께서",
+    // topic (보조사 — 주제)
+    "은",
+    "는",
+    // object (목적격)
+    "을",
+    "를",
+    // possessive (관형격)
+    "의",
+    // locative / directional (부사격)
+    "에",
+    "에서",
+    "에게",
+    "께",
+    "한테",
+    "으로",
+    "로",
+    // comitative / conjunctive (접속)
+    "와",
+    "과",
+    "하고",
+    "이랑",
+    "랑",
+    // comparative / source (부사격)
+    "보다",
+    "부터",
+    "까지",
+    "에도",
+    "에는",
+    // auxiliary (보조사)
+    "도",
+    "만",
+    "조차",
+    "마저",
+    "밖에",
+    "이나",
+    "이란",
+    "란",
+    // copula attached straight to a noun
+    "이다",
+];
+const PARTICLE_SET = new Set(KOREAN_PARTICLES);
+const NO_MATCH = { kind: "no_match" };
+// ---------------------------------------------------------------------------
+// Matcher
+// ---------------------------------------------------------------------------
+const HANGUL_SYLLABLE = /^[\uAC00-\uD7A3]+$/u;
+/** True when the string's last character is a Hangul syllable. */
+function endsWithHangul(text) {
+    const last = text.slice(-1);
+    return last.length > 0 && HANGUL_SYLLABLE.test(last);
+}
+/** True when the remainder is a known particle short enough to be one. */
+export function isKnownParticle(remainder) {
+    return remainder.length <= 2 && PARTICLE_SET.has(remainder);
+}
+/**
+ * Match `term` inside a single whitespace/punctuation-delimited `token`.
+ *
+ * Korean-final terms accept one trailing particle from {@link KOREAN_PARTICLES};
+ * the returned span covers the stem only. Every other trailing remainder is a
+ * no-match. Latin/other-script terms require the whole token to equal the term
+ * (case-insensitive) — no particle absorption, no partial-word hits.
+ */
+export function matchTermInToken(term, token) {
+    if (term.length < 1 || token.length < 1)
+        return NO_MATCH;
+    if (!endsWithHangul(term)) {
+        return token.toLowerCase() === term.toLowerCase() ? bareMatch(term.length, token) : NO_MATCH;
+    }
+    if (!token.startsWith(term))
+        return NO_MATCH;
+    const remainder = token.slice(term.length);
+    if (remainder.length < 1)
+        return bareMatch(term.length, token);
+    if (!isKnownParticle(remainder))
+        return NO_MATCH;
+    return {
+        kind: "match",
+        stem: token.slice(0, term.length),
+        stemStart: 0,
+        stemEnd: term.length,
+        particle: remainder,
+        particleStart: term.length,
+        particleEnd: token.length,
+    };
+}
+/** Whole-token match with no trailing particle. */
+function bareMatch(stemEnd, token) {
+    return {
+        kind: "match",
+        stem: token.slice(0, stemEnd),
+        stemStart: 0,
+        stemEnd,
+        particle: null,
+        particleStart: null,
+        particleEnd: null,
+    };
+}
+//# sourceMappingURL=josa.js.map

package/dist/engine/linkify/josa.js.map

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