@retaw106/mmc-oc 2.6.0 → 2.7.1

package/dist/v2/tui/entry.d.ts

@@ -0,0 +1,8 @@
+import type { V2TuiContext } from "./types";
+declare function setup(context: V2TuiContext): Promise<() => void>;
+declare const _default: {
+    id: string;
+    setup: typeof setup;
+};
+export default _default;
+//# sourceMappingURL=entry.d.ts.map

package/dist/v2/tui/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/entry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,iBAAe,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAG/D;;;;;AAGD,wBAA2C"}

package/dist/v2/tui/notification-socket.d.ts

@@ -0,0 +1,26 @@
+export interface SocketNotification {
+    id: number;
+    type: string;
+    payload: Record<string, unknown>;
+    sessionId?: string;
+}
+interface NotificationSocketOptions {
+    /** Current active session id (re-read cheaply to follow session switches). */
+    getSessionId: () => string | null;
+    /**
+     * Directory of the active session, when the host reports it. The socket
+     * subscribes to that directory's server, because that is the server whose
+     * commands push this session's notifications; null means the startup one.
+     */
+    getSessionDirectory?: () => string | null;
+    /** Handle one delivered notification. Returns true only after it is fully
+     *  consumed and can be acknowledged. Async because dialog handlers await. */
+    onNotification: (notification: SocketNotification) => boolean | Promise<boolean>;
+}
+/** Open the persistent notification socket. Reconnects on its own after a drop. */
+export declare function startNotificationSocket(options: NotificationSocketOptions): void;
+/** Close the socket and release all state owned by this TUI initialization. */
+export declare function stopNotificationSocket(): void;
+export declare function _resetNotificationSocketStateForTesting(): void;
+export {};
+//# sourceMappingURL=notification-socket.d.ts.map

package/dist/v2/tui/notification-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-socket.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/notification-socket.ts"],"names":[],"mappings":"AAiDA,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,yBAAyB;IAC/B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC1C;iFAC6E;IAC7E,cAAc,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAoDD,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAOhF;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,IAAI,CAiC7C;AA2UD,wBAAgB,uCAAuC,IAAI,IAAI,CAE9D"}

package/dist/v2/tui/session-directory.d.ts

@@ -0,0 +1,22 @@
+import type { V2TuiContext } from "./types";
+/**
+ * The directory whose Magic Context server owns a session.
+ *
+ * OpenCode starts one Magic Context server instance per directory. The TUI
+ * starts in one directory but can show a session from another one (non-git
+ * directories share OpenCode's global project, so a TUI started in the home
+ * directory lists sessions from any of them). The status dialog must ask the
+ * server for the session's directory, not the startup one.
+ *
+ * `sessionDirectory` is what the host reports for the session
+ * (`context.data.session.get(id).location.directory` on OpenCode 2). The
+ * startup directory is the fallback while the host has not loaded the session.
+ */
+export declare function directoryForSession(sessionDirectory: unknown, startupDirectory: string): string;
+/**
+ * The directory of the Magic Context server that owns `sessionID` on this host,
+ * or undefined while the host has not loaded the session (the caller then uses
+ * its startup directory). See `directoryForSession`.
+ */
+export declare function sessionDirectory(context: V2TuiContext, sessionID: string): string | undefined;
+//# sourceMappingURL=session-directory.d.ts.map

package/dist/v2/tui/session-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-directory.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/session-directory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAI/F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM7F"}

package/dist/v2/tui/types.d.ts

@@ -0,0 +1,110 @@
+export interface V2TuiLocation {
+    readonly directory: string;
+}
+export interface V2TuiRoute {
+    readonly type: string;
+    readonly sessionID?: string;
+}
+export interface V2TuiContext {
+    readonly location?: V2TuiLocation;
+    readonly data: {
+        readonly location: {
+            default(): V2TuiLocation;
+        };
+        /**
+         * `Context.data.session` on GA 2.0.x. `location.directory` is the
+         * directory whose Magic Context server owns the session. Optional so a
+         * host without it falls back to the startup directory.
+         */
+        readonly session?: {
+            get(sessionID: string): {
+                readonly location?: {
+                    readonly directory?: string;
+                };
+            } | undefined;
+        };
+    };
+    readonly renderer: {
+        requestRender(): void;
+    };
+    readonly keymap: {
+        /** `Context.keymap.layer` on GA 2.0.22. See `V2KeymapLayer`. */
+        readonly layer: (input: () => V2KeymapLayer) => void;
+    };
+    readonly ui: {
+        readonly router: {
+            current(): V2TuiRoute;
+        };
+        /**
+         * `Context.ui.slot` on GA 2.0.22: claims a place in the host's slot
+         * tree and returns the unregister function. See `V2SlotClaim`.
+         */
+        readonly slot: (claim: V2SlotClaim) => () => void;
+        readonly toast: {
+            show(options: {
+                readonly title?: string;
+                readonly message: string;
+                readonly variant?: "info" | "success" | "warning" | "error";
+                readonly duration?: number;
+            }): void;
+        };
+        readonly dialog: {
+            alert(options: {
+                readonly title: string;
+                readonly message: string;
+            }): Promise<void>;
+            confirm(options: {
+                readonly title: string;
+                readonly message: string;
+                readonly label?: {
+                    readonly confirm?: string;
+                    readonly cancel?: string;
+                };
+            }): Promise<boolean | undefined>;
+        };
+    };
+}
+/**
+ * One keymap command, aligned with `@opencode/plugin` 2.0.22's
+ * `dist/tui/context.d.ts` `KeymapCommand` (the fields this layer writes).
+ * Differences from that declaration, kept as a structural subset so the
+ * plugin depends on no @opentui/* types: 2.0.22 makes `id`/`title`/`group`
+ * optional (inline commands omit them) and adds `description`/`enabled`/
+ * `bind`/`suggested`; its `run` also receives the dispatching `KeyEvent` as a
+ * second argument and may return `false` to continue dispatch. This layer
+ * always names its commands and reads only the slash input, so the narrower
+ * `run` shape stays assignable to the host's.
+ */
+export interface V2KeymapCommand {
+    readonly id: string;
+    readonly title: string;
+    readonly group: string;
+    readonly palette: true;
+    readonly slash: {
+        readonly name: string;
+        readonly arguments?: true;
+    };
+    readonly run: (input?: string) => void | Promise<void>;
+}
+/**
+ * The layer object `context.keymap.layer()` accepts, aligned with 2.0.22's
+ * `KeymapLayer` (whose `mode`/`commands` are optional and which also carries
+ * `enabled`/`target`/`priority`/`bindings`). This layer always pins
+ * `mode: "global"` and lists its commands.
+ */
+export interface V2KeymapLayer {
+    readonly mode: string;
+    readonly commands: readonly V2KeymapCommand[];
+}
+/**
+ * The one slot claim this face uses, a subset of 2.0.22's `SlotClaim`
+ * (`SlotMap["app"]` input is `Readonly<Record<string, never>>`; 2.0.22's claim
+ * type is a mutually-exclusive placement union whose `render` returns a
+ * Solid `JSX.Element` — this layer's app-slot render returns `null`, which
+ * the host accepts at runtime).
+ */
+export interface V2SlotClaim {
+    readonly append: "app";
+    readonly render: (input: Readonly<Record<string, never>>) => unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/v2/tui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/v2/tui/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,QAAQ,EAAE;YAAE,OAAO,IAAI,aAAa,CAAA;SAAE,CAAC;QAChD;;;;WAIG;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE;YACf,GAAG,CACC,SAAS,EAAE,MAAM,GAClB;gBAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE;oBAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,GAAG,SAAS,CAAC;SAC1E,CAAC;KACL,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QAAE,aAAa,IAAI,IAAI,CAAA;KAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE;QACb,gEAAgE;QAChE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,aAAa,KAAK,IAAI,CAAC;KACxD,CAAC;IACF,QAAQ,CAAC,EAAE,EAAE;QACT,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,UAAU,CAAA;SAAE,CAAC;QAC3C;;;WAGG;QACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,IAAI,CAAC;QAClD,QAAQ,CAAC,KAAK,EAAE;YACZ,IAAI,CAAC,OAAO,EAAE;gBACV,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;gBAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;aAC9B,GAAG,IAAI,CAAC;SACZ,CAAC;QACF,QAAQ,CAAC,MAAM,EAAE;YACb,KAAK,CAAC,OAAO,EAAE;gBAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACpF,OAAO,CAAC,OAAO,EAAE;gBACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,KAAK,CAAC,EAAE;oBAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;oBAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;aAC5E,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;SACpC,CAAC;KACL,CAAC;CACL;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC;CACxE"}

package/dist/{wrapup-orchestrator-g0mww1h4.js → wrapup-orchestrator-ghq4y406.js}

@@ -21,7 +21,7 @@ import {
   getActiveCompartmentRun,
   markActiveCompartmentRunPublished,
   registerActiveCompartmentRun
-} from "./index-xk1dz6q9.js";
+} from "./index-xrxpbe74.js";
 import"./index-pte3cfs9.js";
 import"./index-x37vg474.js";
 import"./index-t0zx3tgz.js";
@@ -37,7 +37,7 @@ import {
 import {
   setRecompStarting2,
   setRecompTerminal2
-} from "./index-1np16gxq.js";
+} from "./index-cgjyhwdk.js";
 import"./index-yjv8dpht.js";
 
 // src/hooks/magic-context/wrapup-orchestrator.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retaw106/mmc-oc",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
@@ -31,14 +31,16 @@
   "files": [
     "dist",
     "index.js",
+    "tui.js",
     "src/shared",
     "src/config",
     "src/agents",
     "README.md"
   ],
   "scripts": {
-    "build": "bun ../../scripts/check-bun.mjs && bun ../../scripts/clean-dist-chunks.mjs dist index.js config-init.js cli.js && rm -rf dist/web && bun build src/index.ts --outdir dist --target node --format esm --splitting --external @opencode-ai/plugin --external bun:sqlite --external node:sqlite && bun run build:v2 && bun run build:web && bun run build:config-init && bun run build:cli && tsc --emitDeclarationOnly",
+    "build": "bun ../../scripts/check-bun.mjs && bun ../../scripts/clean-dist-chunks.mjs dist index.js config-init.js cli.js && rm -rf dist/web && bun build src/index.ts --outdir dist --target node --format esm --splitting --external @opencode-ai/plugin --external bun:sqlite --external node:sqlite && bun run build:v2 && bun run build:tui && bun run build:web && bun run build:config-init && bun run build:cli && tsc --emitDeclarationOnly",
     "build:v2": "bun build src/v2/server.ts --outfile dist/v2/server.js --target node --format esm --external @opencode/plugin && bun test src/v2/server.test.ts",
+    "build:tui": "bun build src/v2/tui/entry.ts --outfile dist/tui.js --target node --format esm",
     "build:web": "bun build src/web/main.ts --outfile dist/web/main.js --target node --format esm --external bun:sqlite --external node:sqlite && mkdir -p dist/web/ui && cp src/web/ui/* dist/web/ui/",
     "build:config-init": "bun build scripts/config-init-entry.ts --outfile dist/config-init.js --target node --format esm",
     "build:cli": "bun build scripts/cli.ts --outfile dist/cli.js --target node --format esm",
@@ -80,10 +82,18 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./tui": {
+      "import": "./tui.js"
     }
   },
   "oc-plugin": [
-    "server"
+    "server",
+    "tui"
+  ],
+  "opencode": [
+    "server",
+    "tui"
   ],
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.15.0"

package/src/shared/prompt-surface-a1-golden.md

@@ -1,6 +1,6 @@
 # Magic Context agent-facing surface (exported from source)
 
-Generated by `packages/plugin/scripts/export-agent-surface.ts` at 2026-11-01.
+Generated by `packages/plugin/scripts/export-agent-surface.ts` at 2026-11-10.
 Token counts are Claude BPE estimates on the raw text.
 
 ## 1. System-prompt guidance section
@@ -271,7 +271,7 @@ First line is the title (under 80 chars), followed by detail. Operations:
 }
 ```
 
-### mmc_memory — description ~279 tokens, params ~175 tokens (total ~454)
+### mmc_memory — description ~279 tokens, params ~198 tokens (total ~477)
 
 **Description:**
 
@@ -305,11 +305,11 @@ Examples: category="CONFIG_VALUES", content="OpenCode source is at ~/Work/OSS/op
     ]
   },
   "content": {
-    "description": "The memory text — one standalone fact (write, update, merge).",
+    "description": "The memory text — one standalone fact (write, update, merge). Archive and get take an empty string.",
     "type": "string"
   },
   "category": {
-    "description": "Kind of fact (required for write; on update/merge, pass the memory's current category to keep it).",
+    "description": "Kind of fact: the new fact's kind for write; on update/merge, the memory's current category to keep it. Archive and get ignore it.",
     "type": "string",
     "enum": [
       "PROJECT_RULES",
@@ -320,7 +320,7 @@ Examples: category="CONFIG_VALUES", content="OpenCode source is at ~/Work/OSS/op
     ]
   },
   "ids": {
-    "description": "Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get.",
+    "description": "Memory ids from <project-memory>: one for update, one or more for archive, two or more for merge, 1–20 for get. Write takes an empty list.",
     "type": "array",
     "items": {
       "type": "number"

package/src/shared/search-text.test.ts

@@ -1,5 +1,40 @@
 import { expect, test } from "bun:test";
-import { cleanSearchText, keywordRelevance, matchedSearchSnippet } from "./search-text";
+import {
+    cleanSearchText,
+    hintKeywordRelevance,
+    keywordRelevance,
+    matchedSearchSnippet,
+} from "./search-text";
+
+test("hint scoring preserves exact English and other space-separated keyword scores", () => {
+    const cases: Array<[string, string, number]> = [
+        ["explain historian cache wiring", "cache icons", 0.2],
+        ["historian cache wiring", "historian cache wiring details", 0.8000000000000002],
+        ["please explain cache wiring to me", "cache wiring", 0.5333333333333333],
+        ["CACHE cache cache_timeout", "cache_timeout", 0.4],
+        ["how are you", "how are you", 0],
+        ["historian cache", "<task>historian cache</task>", 0],
+        ["résumé über prüfen", "über prüfen", 0.5333333333333333],
+        ["память кеш", "кеш", 0.4],
+        ["ذاكرة تخزين", "تخزين", 0.4],
+    ];
+    for (const [query, content, expected] of cases) {
+        expect(keywordRelevance(query, content)).toBe(expected);
+        expect(hintKeywordRelevance(query, content)).toBe(expected);
+    }
+});
+
+test("only hint scoring splits unspaced CJK runs into overlapping character bigrams", () => {
+    expect(keywordRelevance("MC_Maze 残差怎样汇总？", "MC_Maze 残差按种子汇总。")).toBe(0.4);
+    expect(hintKeywordRelevance("残差", "残留")).toBe(0);
+    expect(hintKeywordRelevance("差", "残差")).toBe(0.8);
+    expect(hintKeywordRelevance("𠮷野家", "𠮷野川")).toBe(0.8);
+    expect(hintKeywordRelevance("かながき", "かながきです")).toBe(0.8);
+    expect(hintKeywordRelevance("カタカナ", "カタカナです")).toBe(0.8);
+    expect(hintKeywordRelevance("프로젝트캐시", "프로젝트의캐시")).toBe(0.8);
+    expect(hintKeywordRelevance("cache残差", "cache残差按种子汇总")).toBe(0.8);
+    expect(hintKeywordRelevance("差", "<task>残差</task> unrelated")).toBe(0);
+});
 
 test("notification trees never contribute relevance or display text", () => {
     expect(

package/src/shared/search-text.ts

@@ -35,6 +35,54 @@ export function keywordRelevance(query: string, content: string): number {
     return (0.8 * needles.filter((term) => words.has(term)).length) / needles.length;
 }
 
+const CJK_RUN = /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]+$/u;
+const CJK_RUN_SPLIT = /([\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]+)/u;
+
+function hintTerms(text: string): string[] {
+    return [
+        ...new Set(
+            terms(text)
+                .flatMap((term) => term.split(CJK_RUN_SPLIT))
+                .filter((term) => term.length > 0 && !QUERY_STOP_WORDS.has(term)),
+        ),
+    ];
+}
+
+function characterBigrams(run: string): string[] {
+    const characters = [...run];
+    return characters.length === 1
+        ? characters
+        : characters.slice(1).map((character, index) => characters[index] + character);
+}
+
+/** Match unspaced clauses for hints without changing retrieval or snippet scoring. */
+export function hintKeywordRelevance(query: string, content: string): number {
+    const needles = hintTerms(query);
+    if (needles.length === 0) return 0;
+    const words = new Set(hintTerms(cleanSearchText(content)));
+    const runs = [...words].filter((word) => CJK_RUN.test(word));
+    const bigrams = new Set(runs.flatMap(characterBigrams));
+    let matched = 0;
+    for (const needle of needles) {
+        if (!CJK_RUN.test(needle)) {
+            matched += Number(words.has(needle));
+            continue;
+        }
+        const grams = characterBigrams(needle);
+        if ([...needle].length === 1) {
+            matched += Number(runs.some((run) => run.includes(needle)));
+            continue;
+        }
+        // Count each clause as one term so filler bigrams across word boundaries
+        // do not dilute it; require half coverage so shared function words alone do not pass.
+        matched += Math.min(
+            1,
+            grams.filter((gram) => bigrams.has(gram)).length / Math.ceil(grams.length / 2),
+        );
+    }
+    return (0.8 * matched) / needles.length;
+}
+
 /** Pick the densest matching passage before compression discards matched words. */
 export function matchedSearchSnippet(content: string, query: string, cap = 220): string {
     const text = cleanSearchText(content);

package/tui.js

@@ -0,0 +1,4 @@
+// mmc fork: root TUI entry mirror (T-003 B-tier), shape mirrors upstream's
+// tui.js: the host's "./tui" export resolves here, re-exporting the bundled
+// dist entry.
+export { default } from "./dist/tui.js";