@north-light/crouter-api 0.3.181 → 0.3.183

package/README.md

@@ -41,18 +41,11 @@ autostart hook.
   canvas, worktree, and human-in-the-loop.
 - **`routes` / `API_VERSION`** — pure path builders for the `/v1` surface.
 - **`ApiError` / `ErrorBody` / `isErrorBody`** — the error contract.
-- **`@north-light/crouter-api/doc-link-grammar`** — the `[[canonical/name]]`
-  memory-document link grammar (`findDocLinks`, `docLinkNames`,
-  `isDocLinkName`). Zero imports and browser-safe, so a UI can scan transcript
-  markdown for doc links in the renderer and hand each name to
-  `client.resolveMemoryDoc(name, nodeId)`. Import the subpath, not the root, in
-  a browser bundle — the root pulls `CrtrClient` and its Node built-ins.
 
 ## Source of truth & releases
 
 The source lives in the [`crouter`](https://github.com/vallum-security/crouter)
-repo at `src/api/`, plus `src/core/memory/doc-link-grammar.ts` for the subpath
-above; this package is a build-and-publish mirror of those files (it carries no
-source of its own). It is published by the `publish-api.yml`
+repo at `src/api/`; this package is a build-and-publish mirror of that subtree
+(it carries no source of its own). It is published by the `publish-api.yml`
 GitHub Action when a tag matching `api-vX.Y.Z` is pushed — the tag version must
 match this package's `version`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter-api",
-  "version": "0.3.181",
+  "version": "0.3.183",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, and the CrtrClient. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",
@@ -11,12 +11,6 @@
       "import": "./dist/api/index.js",
       "require": "./dist/api/index.js",
       "default": "./dist/api/index.js"
-    },
-    "./doc-link-grammar": {
-      "types": "./dist/core/memory/doc-link-grammar.d.ts",
-      "import": "./dist/core/memory/doc-link-grammar.js",
-      "require": "./dist/core/memory/doc-link-grammar.js",
-      "default": "./dist/core/memory/doc-link-grammar.js"
     }
   },
   "files": [

package/dist/core/memory/doc-link-grammar.d.ts

@@ -1,20 +0,0 @@
-/** One `[[name]]` link occurrence found in a document body. */
-export interface DocLink {
-    /** Character index of the first `[` of `[[`. */
-    start: number;
-    /** Character index just past the closing `]]`. */
-    end: number;
-    /** The canonical document name between the brackets. */
-    name: string;
-}
-/** Is `name` a well-formed canonical doc-link name? */
-export declare function isDocLinkName(name: string): boolean;
-/**
- * Find every `[[name]]` doc link in a markdown body, in order of appearance,
- * skipping fenced code blocks and inline code spans (a link mentioned inside
- * code is an example, not a reference). Occurrences are NOT deduplicated —
- * callers collapse as needed.
- */
-export declare function findDocLinks(body: string): DocLink[];
-/** The distinct link names in a body, first-appearance order. */
-export declare function docLinkNames(body: string): string[];

package/dist/core/memory/doc-link-grammar.js

@@ -1,113 +0,0 @@
-// doc-link-grammar.ts — the single source of truth for the `[[canonical/name]]`
-// memory-document link grammar. Zero imports, pure string ops, browser-safe —
-// any surface that highlights, resolves, or lints doc links imports THIS module
-// rather than re-implementing the bracket scan or the name shape. It ships to
-// external consumers as `@north-light/crouter-api/doc-link-grammar`, so a
-// browser UI rendering a node's transcript scans with the same grammar crtrd
-// validates `/v1/memory/resolve` names with.
-//
-// A doc link is a durable cross-reference written INSIDE a memory document's
-// body, pointing at another memory document by its exact canonical name (the
-// same identifier `crtr memory read <name>` takes; a directory INDEX is linked
-// by its folded bare-directory name). It is distinct from the interactive
-// `/name` inline-reference grammar (`inline-ref-grammar.ts`), which scans a
-// human's live composer text — links live in stored markdown and survive there.
-//
-// Links are POINTERS, never transclusion: nothing in the runtime auto-loads a
-// linked body into context. `crtr memory lint` fails a link that resolves to no
-// document; `crtr memory read` surfaces the resolved links of the doc it loads.
-//
-// This module never resolves anything: `findDocLinks` returns candidate links;
-// a caller decides a link is live by testing `name` against the corpus of
-// resolvable canonical names.
-// A canonical doc name: one or more `[A-Za-z0-9_-]+` segments joined by `/`.
-// Anything else between `[[` `]]` (spaces, `|` aliases, empty segments) is NOT
-// a doc link — the grammar has no alias/label form, by design.
-const NAME_RE = /^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/;
-const LINK_RE = /\[\[([^\[\]\n]+)\]\]/g;
-/** Is `name` a well-formed canonical doc-link name? */
-export function isDocLinkName(name) {
-    return NAME_RE.test(name);
-}
-/**
- * Find every `[[name]]` doc link in a markdown body, in order of appearance,
- * skipping fenced code blocks and inline code spans (a link mentioned inside
- * code is an example, not a reference). Occurrences are NOT deduplicated —
- * callers collapse as needed.
- */
-export function findDocLinks(body) {
-    const links = [];
-    for (const segment of proseSegments(body)) {
-        LINK_RE.lastIndex = 0;
-        let m;
-        while ((m = LINK_RE.exec(segment.text)) !== null) {
-            const name = m[1];
-            if (!isDocLinkName(name))
-                continue;
-            links.push({ start: segment.offset + m.index, end: segment.offset + m.index + m[0].length, name });
-        }
-    }
-    return links;
-}
-/** The distinct link names in a body, first-appearance order. */
-export function docLinkNames(body) {
-    const seen = new Set();
-    const out = [];
-    for (const link of findDocLinks(body)) {
-        if (seen.has(link.name))
-            continue;
-        seen.add(link.name);
-        out.push(link.name);
-    }
-    return out;
-}
-const FENCE_RE = /^ {0,3}(`{3,}|~{3,})/;
-function* proseSegments(body) {
-    let offset = 0;
-    let fence = null; // the opening fence marker while inside a block
-    for (const line of body.split('\n')) {
-        const lineLen = line.length + 1; // + '\n' (harmless overcount on last line)
-        const fenceMatch = line.match(FENCE_RE);
-        if (fence !== null) {
-            // Inside a fenced block: only a closing fence of the same char and at
-            // least the same length ends it. Nothing in here is prose.
-            if (fenceMatch && fenceMatch[1][0] === fence[0] && fenceMatch[1].length >= fence.length) {
-                fence = null;
-            }
-            offset += lineLen;
-            continue;
-        }
-        if (fenceMatch) {
-            fence = fenceMatch[1];
-            offset += lineLen;
-            continue;
-        }
-        // Prose line: split around inline code spans (single-backtick pairs).
-        yield* proseParts(line, offset);
-        offset += lineLen;
-    }
-}
-function* proseParts(line, offset) {
-    let i = 0;
-    while (i < line.length) {
-        const open = line.indexOf('`', i);
-        if (open === -1) {
-            yield { offset: offset + i, text: line.slice(i) };
-            return;
-        }
-        // Backtick run: an inline span is delimited by runs of equal length.
-        let runEnd = open;
-        while (runEnd < line.length && line[runEnd] === '`')
-            runEnd++;
-        const run = line.slice(open, runEnd);
-        const close = line.indexOf(run, runEnd);
-        if (close === -1) {
-            // Unbalanced backticks: treat the rest as prose past the run.
-            yield { offset: offset + i, text: line.slice(i, open) };
-            i = runEnd;
-            continue;
-        }
-        yield { offset: offset + i, text: line.slice(i, open) };
-        i = close + run.length;
-    }
-}