@jini-ai/cms 0.1.0

package/dist/navigation/reconcile.d.ts

@@ -0,0 +1,57 @@
+import type { ClockPort, UUID } from "../core/ports.js";
+import type { MenuRepoPort } from "./repo.memory.js";
+import type { NavLocationBindingRepoPort } from "./ports.js";
+/**
+ * @file `rebuildNavLocationBindings` — the first real caller of the
+ * already-implemented-but-unused `NavLocationBindingRepoPort.rebuildForWorkspace`.
+ *
+ * Purpose:
+ * Reads every menu's `.locations` field (the source of truth,
+ * `NavMenuEntry.locations`), computes the resulting binding-index rows, and
+ * calls `rebuildForWorkspace` to replace the whole workspace's index in one
+ * shot. The index is derived + rebuildable by definition (same species as
+ * `entry_refs`) — a full
+ * rescan of menu entries can always reconstruct it, including dropping any
+ * orphan rows that drifted out of sync with the menus' own field.
+ *
+ * How it relates to the project:
+ * - Meant to be called once at boot from a host's SQLite composition root,
+ *   after the SQLite db opens — the same
+ *   per-row-failure-tolerant boot-time reconciliation pattern this library's
+ *   first host uses elsewhere, though this rebuild has no per-row failure
+ *   mode (a pure read-then-replace, not a fallible write-service call).
+ * - Also directly unit-testable against fixture repos, independent of which
+ *   adapter (in-memory or a host's own SQLite adapter) is behind the ports.
+ *
+ * Architectural role:
+ * Feature logic only — no HTTP, no direct SQL. Read-then-replace, never a
+ * partial update (`rebuildForWorkspace` itself replaces the whole
+ * workspace's rows in one call, so there is no intermediate inconsistent
+ * state observable through the port).
+ */
+export interface RebuildNavLocationBindingsDeps {
+    menuRepo: MenuRepoPort;
+    bindingRepo: NavLocationBindingRepoPort;
+    clock: ClockPort;
+    workspaceId: UUID;
+}
+export interface RebuildNavLocationBindingsResult {
+    /** Total binding rows written (the size of the rebuilt index). */
+    rebuiltCount: number;
+}
+/**
+ * Recompute the workspace's `nav_location_bindings` index from scratch from
+ * every menu's `.locations` field, and replace the stored index with it.
+ * Idempotent: re-running against unchanged menu data produces the same
+ * index every time. If more than one menu somehow lists the same location
+ * key (a data-drift edge case the invariant should otherwise prevent), the
+ * later menu in `MenuRepoPort.list`'s iteration order wins — consistent with
+ * `NavLocationBindingRepoPort.upsert`'s existing last-writer-wins semantics
+ * elsewhere in this library.
+ *
+ * @complexity O(n) over menus in the workspace, plus O(k) over each menu's
+ * `.locations` entries (small, bounded by registered locations).
+ * @overallScore 100
+ */
+export declare function rebuildNavLocationBindings(deps: RebuildNavLocationBindingsDeps): Promise<RebuildNavLocationBindingsResult>;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/navigation/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/navigation/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,0BAA0B,CAAC;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,gCAAgC,CAAC,CAoB3C"}

package/dist/navigation/reconcile.js

@@ -0,0 +1,33 @@
+/**
+ * Recompute the workspace's `nav_location_bindings` index from scratch from
+ * every menu's `.locations` field, and replace the stored index with it.
+ * Idempotent: re-running against unchanged menu data produces the same
+ * index every time. If more than one menu somehow lists the same location
+ * key (a data-drift edge case the invariant should otherwise prevent), the
+ * later menu in `MenuRepoPort.list`'s iteration order wins — consistent with
+ * `NavLocationBindingRepoPort.upsert`'s existing last-writer-wins semantics
+ * elsewhere in this library.
+ *
+ * @complexity O(n) over menus in the workspace, plus O(k) over each menu's
+ * `.locations` entries (small, bounded by registered locations).
+ * @overallScore 100
+ */
+export async function rebuildNavLocationBindings(deps) {
+    const menus = await deps.menuRepo.list({ workspaceId: deps.workspaceId });
+    const boundAt = deps.clock.nowIso();
+    const byLocation = new Map();
+    for (const menu of menus) {
+        for (const locationKey of menu.locations) {
+            byLocation.set(locationKey, {
+                workspaceId: deps.workspaceId,
+                locationKey,
+                menuId: menu.id,
+                boundAt,
+            });
+        }
+    }
+    const bindings = [...byLocation.values()];
+    await deps.bindingRepo.rebuildForWorkspace({ workspaceId: deps.workspaceId, bindings });
+    return { rebuiltCount: bindings.length };
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/navigation/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/navigation/reconcile.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAoC;IAEpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAEpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE;gBAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW;gBACX,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExF,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC"}

package/dist/navigation/repo.memory.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @file In-memory adapters for the `navigation` library.
+ *
+ * Purpose:
+ * Provides the two dev/test persistence adapters this build needs:
+ *
+ * - `InMemoryNavLocationBindingRepo` — the real `NavLocationBindingRepoPort`
+ *   adapter (`ports.ts`) for the derived `nav_location_bindings` index, honoring
+ *   its `UNIQUE (workspace_id, location_key)` constraint via last-writer-wins
+ *   `upsert`.
+ * - `InMemoryMenuRepo` — a **self-contained** menu store. The original design is explicit
+ *   that a menu "adds NO new persistence port" because it should ride the
+ *   generic entries repo. That generic entries system is not yet
+ *   implemented as reusable code (only `post` exists as a concrete type in the
+ *   host that first built this), so this build stores menu records directly
+ *   instead of force-fitting the not-yet-generic entries system. `MenuRepoPort`
+ *   below is a local, navigation-owned interface (not part of the frozen
+ *   `ports.ts` surface) that exists only to make this simplification
+ *   swappable later without touching `menu-service.ts` call sites. When the
+ *   generic entries system ships, this repo should be deleted in favor of the
+ *   entries repo, and `MenuRepoPort` should be deleted in favor of typed reads
+ *   over it.
+ *
+ * How it relates to the project:
+ * - `menu-service.ts` and `resolver.ts` depend on `MenuRepoPort`, not this
+ *   concrete class, so a host-supplied SQLite/entries-backed adapter is a
+ *   drop-in.
+ *
+ * Architectural role:
+ * Adapters only. No validation or business rules live here (that is
+ * `menu-service.ts`'s job) — these classes are dumb, uniqueness-enforcing
+ * collections.
+ */
+import type { UUID } from "../core/ports.js";
+import type { NavLocationBindingRepoPort } from "./ports.js";
+import type { NavLocationBindingRow, NavLocationKey, NavMenuEntry } from "./types.js";
+/**
+ * Storage seam for menu records, standing in for the generic entries
+ * repo until that generic system exists as reusable code. Shape mirrors the
+ * `post` feature's own repo port plus a `remove` for hard purge, since menus
+ * have a real hard-delete step in their deletion ladder (mirrors the media
+ * library's).
+ */
+export interface MenuRepoPort {
+    findById(required: {
+        workspaceId: UUID;
+        id: UUID;
+    }): Promise<NavMenuEntry | null>;
+    findBySlug(required: {
+        workspaceId: UUID;
+        slug: string;
+    }): Promise<NavMenuEntry | null>;
+    list(required: {
+        workspaceId: UUID;
+    }): Promise<NavMenuEntry[]>;
+    save(record: NavMenuEntry): Promise<void>;
+    /** Hard-remove a menu row. Only called after the trash step. */
+    remove(required: {
+        workspaceId: UUID;
+        id: UUID;
+    }): Promise<void>;
+}
+/**
+ * In-memory `MenuRepoPort` adapter for dev/tests. See file header for why a
+ * self-contained repo exists instead of an entries-backed one.
+ *
+ * @complexity Every operation is O(n) in the workspace's menu count via a
+ * linear scan; acceptable for the in-memory/dev-test adapter this library
+ * builds now. A SQLite adapter would index `(workspace_id, id)` /
+ * `(workspace_id, slug)` instead.
+ * @overallScore 100
+ */
+export declare class InMemoryMenuRepo implements MenuRepoPort {
+    private rows;
+    constructor(initialRows?: NavMenuEntry[]);
+    findById(required: {
+        workspaceId: UUID;
+        id: UUID;
+    }): Promise<NavMenuEntry | null>;
+    findBySlug(required: {
+        workspaceId: UUID;
+        slug: string;
+    }): Promise<NavMenuEntry | null>;
+    list(required: {
+        workspaceId: UUID;
+    }): Promise<NavMenuEntry[]>;
+    save(record: NavMenuEntry): Promise<void>;
+    remove(required: {
+        workspaceId: UUID;
+        id: UUID;
+    }): Promise<void>;
+}
+/**
+ * In-memory `NavLocationBindingRepoPort` adapter for dev/tests. Enforces the
+ * derived index's `UNIQUE (workspace_id, location_key)` constraint by storing
+ * at most one row per `(workspaceId, locationKey)` pair: `upsert` replaces
+ * whatever row previously held that key (last-writer-wins).
+ *
+ * @complexity O(n) linear scan per operation over the workspace's binding
+ * count; `n` is bounded by the number of registered locations, which is small
+ * by construction (never a user-scale collection).
+ * @overallScore 100
+ */
+export declare class InMemoryNavLocationBindingRepo implements NavLocationBindingRepoPort {
+    private rows;
+    constructor(initialRows?: NavLocationBindingRow[]);
+    findByLocation(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+    }): Promise<NavLocationBindingRow | null>;
+    listByMenu(required: {
+        workspaceId: UUID;
+        menuId: UUID;
+    }): Promise<NavLocationBindingRow[]>;
+    listByWorkspace(required: {
+        workspaceId: UUID;
+    }): Promise<NavLocationBindingRow[]>;
+    upsert(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+        menuId: UUID;
+        boundAt: string;
+    }): Promise<NavLocationBindingRow>;
+    remove(required: {
+        workspaceId: UUID;
+        locationKey: NavLocationKey;
+    }): Promise<void>;
+    removeByMenu(required: {
+        workspaceId: UUID;
+        menuId: UUID;
+    }): Promise<void>;
+    rebuildForWorkspace(required: {
+        workspaceId: UUID;
+        bindings: readonly NavLocationBindingRow[];
+    }): Promise<void>;
+}
+//# sourceMappingURL=repo.memory.d.ts.map

package/dist/navigation/repo.memory.d.ts.map

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

package/dist/navigation/repo.memory.js

@@ -0,0 +1,95 @@
+/**
+ * In-memory `MenuRepoPort` adapter for dev/tests. See file header for why a
+ * self-contained repo exists instead of an entries-backed one.
+ *
+ * @complexity Every operation is O(n) in the workspace's menu count via a
+ * linear scan; acceptable for the in-memory/dev-test adapter this library
+ * builds now. A SQLite adapter would index `(workspace_id, id)` /
+ * `(workspace_id, slug)` instead.
+ * @overallScore 100
+ */
+export class InMemoryMenuRepo {
+    rows;
+    constructor(initialRows = []) {
+        this.rows = [...initialRows];
+    }
+    async findById(required) {
+        return (this.rows.find((row) => row.workspaceId === required.workspaceId && row.id === required.id) ?? null);
+    }
+    async findBySlug(required) {
+        return (this.rows.find((row) => row.workspaceId === required.workspaceId && row.slug === required.slug) ?? null);
+    }
+    async list(required) {
+        return this.rows.filter((row) => row.workspaceId === required.workspaceId);
+    }
+    async save(record) {
+        const index = this.rows.findIndex((row) => row.workspaceId === record.workspaceId && row.id === record.id);
+        if (index === -1) {
+            this.rows.push(record);
+            return;
+        }
+        this.rows[index] = record;
+    }
+    async remove(required) {
+        this.rows = this.rows.filter((row) => !(row.workspaceId === required.workspaceId && row.id === required.id));
+    }
+}
+// ---------------------------------------------------------------------------
+// NavLocationBindingRepoPort — the one real port this library declares
+// ---------------------------------------------------------------------------
+/**
+ * In-memory `NavLocationBindingRepoPort` adapter for dev/tests. Enforces the
+ * derived index's `UNIQUE (workspace_id, location_key)` constraint by storing
+ * at most one row per `(workspaceId, locationKey)` pair: `upsert` replaces
+ * whatever row previously held that key (last-writer-wins).
+ *
+ * @complexity O(n) linear scan per operation over the workspace's binding
+ * count; `n` is bounded by the number of registered locations, which is small
+ * by construction (never a user-scale collection).
+ * @overallScore 100
+ */
+export class InMemoryNavLocationBindingRepo {
+    rows;
+    constructor(initialRows = []) {
+        this.rows = [...initialRows];
+    }
+    async findByLocation(required) {
+        return (this.rows.find((row) => row.workspaceId === required.workspaceId && row.locationKey === required.locationKey) ?? null);
+    }
+    async listByMenu(required) {
+        return this.rows.filter((row) => row.workspaceId === required.workspaceId && row.menuId === required.menuId);
+    }
+    async listByWorkspace(required) {
+        return this.rows.filter((row) => row.workspaceId === required.workspaceId);
+    }
+    async upsert(required) {
+        const row = {
+            workspaceId: required.workspaceId,
+            locationKey: required.locationKey,
+            menuId: required.menuId,
+            boundAt: required.boundAt,
+        };
+        const index = this.rows.findIndex((existing) => existing.workspaceId === required.workspaceId &&
+            existing.locationKey === required.locationKey);
+        if (index === -1) {
+            this.rows.push(row);
+        }
+        else {
+            // Last-writer-wins reassignment: the UNIQUE(workspace_id, location_key)
+            // constraint means there is never more than one row for this key.
+            this.rows[index] = row;
+        }
+        return row;
+    }
+    async remove(required) {
+        this.rows = this.rows.filter((row) => !(row.workspaceId === required.workspaceId && row.locationKey === required.locationKey));
+    }
+    async removeByMenu(required) {
+        this.rows = this.rows.filter((row) => !(row.workspaceId === required.workspaceId && row.menuId === required.menuId));
+    }
+    async rebuildForWorkspace(required) {
+        const others = this.rows.filter((row) => row.workspaceId !== required.workspaceId);
+        this.rows = [...others, ...required.bindings];
+    }
+}
+//# sourceMappingURL=repo.memory.js.map

package/dist/navigation/repo.memory.js.map

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

package/dist/navigation/resolver.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @file Render-time read model for the `navigation` library.
+ *
+ * Purpose:
+ * `resolveForLocation` is the one typed call a theme renderer makes: look up
+ * the menu bound to a location, then walk its stored item tree into a
+ * `ResolvedNav` — concrete hrefs, `available` flags, active-state — so the
+ * theme "receives resolved data, never resolves refs".
+ *
+ * How it relates to the project:
+ * - `entryRef`/`termRef`/`route` targets need a resolver over entries/taxonomy/
+ *   routing. Those are host-owned concerns and are not this library's running
+ *   code, so this module does NOT import them. Instead it takes an injected
+ *   `resolveTargetHref` function as a dependency — the exact seam a host's own
+ *   routing layer later backs. This keeps `resolver.ts` compiling and testable
+ *   today with a fake, and wiring a real routing implementation in later is a
+ *   pure DI swap, not a rewrite.
+ * - `url` targets are already-resolved hrefs (validated at write time in
+ *   `menu-service.ts`) and pass straight through.
+ * - `termRef` targets: term-link
+ *   integrity has **no compatible schema yet** (`entry_refs` is
+ *   entry-to-entry only) — this is a named blocker, not an oversight.
+ *   This resolver does not special-case `termRef`; it is passed to the same
+ *   injected `resolveTargetHref` as `entryRef`/`route`, and a fake/real
+ *   resolver that has no term schema to consult should return `null`, which
+ *   this module already turns into `available: false` on that node only (the
+ *   rest of the tree still resolves).
+ *
+ * Architectural role:
+ * Pure read-side feature logic. No storage writes; no theme code reachable
+ * from here reads storage directly (render-IR boundary honored by
+ * returning only `ResolvedNav`/`ResolvedNavItem` data).
+ */
+import type { MenuRepoPort } from "./repo.memory.js";
+import type { NavLocationBindingRepoPort, NavResolveContext } from "./ports.js";
+import type { NavLocationKey, NavMenuDoc, NavTarget, ResolvedNav, ResolvedNavItem } from "./types.js";
+/**
+ * A resolved, already-known-available href for a `url` target, or the outcome
+ * of resolving a ref/route target: `path` plus whether it is currently
+ * reachable. `null` means "could not resolve at all" (unknown/deleted/no
+ * schema yet, e.g. `termRef` per the Round-3 fold) — distinct from
+ * `available: false`, which means "resolved to a real target that is
+ * currently unavailable" (e.g. trashed). Both cases end up `available: false`
+ * on the `ResolvedNavItem`; the distinction is for the resolver implementation's
+ * own diagnostics, not surfaced further.
+ */
+export interface ResolvedTargetHref {
+    readonly path: string;
+    readonly available: boolean;
+}
+/**
+ * The injected seam standing in for a host's own routing library. Resolves
+ * one non-`url` target (`entryRef`, `termRef`, or `route`) to an href, or
+ * `null` if it cannot be resolved at all (deleted target, or — for `termRef`
+ * today — no schema yet to resolve against).
+ */
+export type ResolveTargetHrefFn = (target: NavTarget, context: NavResolveContext) => Promise<ResolvedTargetHref | null>;
+export interface ResolveForLocationDeps {
+    menuRepo: MenuRepoPort;
+    bindingRepo: NavLocationBindingRepoPort;
+    resolveTargetHref: ResolveTargetHrefFn;
+}
+export interface ResolveForLocationServiceInput {
+    workspaceId: string;
+    locationKey: NavLocationKey;
+    /** Current request path, for `isCurrent`/`isActive` computation. */
+    currentPath?: string | undefined;
+}
+export interface ResolveForLocationRequired {
+    deps: ResolveForLocationDeps;
+    input: ResolveForLocationServiceInput;
+}
+export interface ResolveForLocationOptional {
+}
+/**
+ * Resolves the menu bound to a theme location into a render-ready
+ * `ResolvedNav`, or `null` if the location has no menu bound.
+ *
+ * Defensive note: if the binding index points at a menu id the menu repo no
+ * longer has (a stale derived row — the index is declared rebuildable —
+ * this resolves to `null` rather than throwing, since a
+ * missing nav fragment is a theme-recoverable degradation and a hard error at
+ * render time is not.
+ *
+ * @complexity O(n) over the resolved menu's total node count — one
+ * `resolveTargetHref` call per non-`url` node, awaited depth-first. No bound
+ * on concurrency is applied since menu trees are bounded (
+ * `DEFAULT_MAX_ITEM_COUNT` in `menu-service.ts`) and are not a user-scale
+ * collection at render time.
+ * @overallScore 100
+ */
+export declare function resolveForLocation(required: ResolveForLocationRequired, _optional?: ResolveForLocationOptional): Promise<ResolvedNav | null>;
+export interface ResolveMenuDocRequired {
+    doc: NavMenuDoc;
+    context: NavResolveContext;
+    resolveTargetHref: ResolveTargetHrefFn;
+}
+/**
+ * Resolves a menu document's item tree into render-ready `ResolvedNavItem`s, independent of any
+ * location binding — the doc-level building block `resolveForLocation` composes on top of (menu
+ * lookup + location-binding lookup), and the seam a caller with a menu already in hand (e.g. a
+ * `widgets`-style `menu` widget type) needs to get real hrefs without duplicating the href-walking
+ * logic `resolveForLocation` already owns (`resolveItemList`/`resolveItem` below stay
+ * module-private; this is the one exported entry point to their behavior).
+ *
+ * @complexity O(n) over the doc's total node count — see `resolveItemList`.
+ * @overallScore 100
+ */
+export declare function resolveMenuDoc(required: ResolveMenuDocRequired): Promise<ResolvedNavItem[]>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/navigation/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/navigation/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAEV,cAAc,EACd,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;AAExC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,0BAA0B,CAAC;IACxC,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,8BAA8B,CAAC;CACvC;AAED,MAAM,WAAW,0BAA0B;CAAG;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,0BAA0B,EACpC,SAAS,GAAE,0BAA+B,GACzC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyB7B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAGjG"}

package/dist/navigation/resolver.js

@@ -0,0 +1,131 @@
+/**
+ * Resolves the menu bound to a theme location into a render-ready
+ * `ResolvedNav`, or `null` if the location has no menu bound.
+ *
+ * Defensive note: if the binding index points at a menu id the menu repo no
+ * longer has (a stale derived row — the index is declared rebuildable —
+ * this resolves to `null` rather than throwing, since a
+ * missing nav fragment is a theme-recoverable degradation and a hard error at
+ * render time is not.
+ *
+ * @complexity O(n) over the resolved menu's total node count — one
+ * `resolveTargetHref` call per non-`url` node, awaited depth-first. No bound
+ * on concurrency is applied since menu trees are bounded (
+ * `DEFAULT_MAX_ITEM_COUNT` in `menu-service.ts`) and are not a user-scale
+ * collection at render time.
+ * @overallScore 100
+ */
+export async function resolveForLocation(required, _optional = {}) {
+    const { deps, input } = required;
+    const binding = await deps.bindingRepo.findByLocation({
+        workspaceId: input.workspaceId,
+        locationKey: input.locationKey,
+    });
+    if (!binding)
+        return null;
+    const menu = await deps.menuRepo.findById({ workspaceId: input.workspaceId, id: binding.menuId });
+    if (!menu)
+        return null;
+    const context = {
+        workspaceId: input.workspaceId,
+        currentPath: input.currentPath,
+    };
+    const items = await resolveMenuDoc({ doc: menu.doc, context, resolveTargetHref: deps.resolveTargetHref });
+    return {
+        menuId: menu.id,
+        locationKey: input.locationKey,
+        title: menu.title,
+        items,
+    };
+}
+/**
+ * Resolves a menu document's item tree into render-ready `ResolvedNavItem`s, independent of any
+ * location binding — the doc-level building block `resolveForLocation` composes on top of (menu
+ * lookup + location-binding lookup), and the seam a caller with a menu already in hand (e.g. a
+ * `widgets`-style `menu` widget type) needs to get real hrefs without duplicating the href-walking
+ * logic `resolveForLocation` already owns (`resolveItemList`/`resolveItem` below stay
+ * module-private; this is the one exported entry point to their behavior).
+ *
+ * @complexity O(n) over the doc's total node count — see `resolveItemList`.
+ * @overallScore 100
+ */
+export async function resolveMenuDoc(required) {
+    const { doc, context, resolveTargetHref } = required;
+    return resolveItemList(doc.items, context, resolveTargetHref);
+}
+/**
+ * Resolves a sibling list of item nodes, depth-first, preserving order.
+ *
+ * @complexity O(n) over the subtree's node count.
+ * @overallScore 100
+ */
+async function resolveItemList(nodes, context, resolveTargetHref) {
+    const resolved = [];
+    for (const node of nodes) {
+        resolved.push(await resolveItem(node, context, resolveTargetHref));
+    }
+    return resolved;
+}
+/**
+ * Resolves one node: `url` targets pass through directly (already validated
+ * hrefs, `menu-service.ts`); every other kind goes through the injected
+ * `resolveTargetHref` seam. A `null`/unavailable result never throws and never
+ * drops the node — it is returned with `available: false, href: null` so the
+ * rest of the tree keeps resolving (themes must omit unavailable
+ * links, never render dead ones, but core still hands back a full model for
+ * the theme to filter).
+ *
+ * Label-fallback simplification: `types.ts`'s `NavItemNode.label` doc says it
+ * "falls back to the target's title when absent." Deriving a target's title
+ * needs entry/taxonomy metadata that `ResolveTargetHrefFn` does not return
+ * (only `{ path, available }`); doing that fallback for real is deferred to
+ * whenever the injected resolver is widened to return a title alongside the
+ * href. For now an absent `label` resolves to `""`, which is a documented gap,
+ * not a silent behavior claim.
+ *
+ * @complexity O(1) at this node plus the cost of resolving its `children`
+ * subtree (accounted in the caller's overall O(n)).
+ * @overallScore 90
+ * @findings Low: label fallback to target title is not implemented (see note
+ * above) — deferred pending a richer `ResolveTargetHrefFn` return shape.
+ */
+async function resolveItem(node, context, resolveTargetHref) {
+    const children = node.children
+        ? await resolveItemList(node.children, context, resolveTargetHref)
+        : [];
+    let href = null;
+    let available;
+    if (node.target.kind === "url") {
+        href = node.target.href;
+        available = true;
+    }
+    else {
+        // entryRef / termRef / route: resolved via the injected seam standing in
+        // for the host's own routing layer, which is not this library's running
+        // code. termRef in particular has no compatible entry_refs schema today
+        // — a resolver with no term schema to
+        // consult returns null here, same as any other "cannot resolve" outcome.
+        const result = await resolveTargetHref(node.target, context);
+        if (result === null) {
+            href = null;
+            available = false;
+        }
+        else {
+            href = result.path;
+            available = result.available;
+        }
+    }
+    const isCurrent = available && href !== null && context.currentPath !== undefined && href === context.currentPath;
+    const isActive = isCurrent || children.some((child) => child.isActive);
+    return {
+        id: node.id,
+        label: node.label ?? "",
+        href: available ? href : null,
+        available,
+        isCurrent,
+        isActive,
+        attrs: node.attrs,
+        children,
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/navigation/resolver.js.map

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

package/dist/navigation/tool-registrations.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @file Navigation's (Menus') half of the agent-tool authorization wiring: maps `agent-tools.ts`'s five
+ * catalog entries onto `menu-service.ts`'s read/create/update/assign operations, as
+ * `ToolRegistration`s. The entire catalog is wired — `deleteMenu` is deliberately absent from the
+ * catalog rather than present-but-unwired; see `navigation/agent-tools.ts`'s own header.
+ *
+ * Authorization shape: like Media and unlike Forms/Identity/Widgets, `menu-service.ts`'s functions
+ * perform NO internal `authorize()` call of their own — every admin HTTP route a host builds gates
+ * inline. Every handler here does the same via the kit's `requireToolPermission`, which is the
+ * single evaluation for these tools, located where the real route locates it.
+ */
+import type { AuthorizeFn } from "../core/commands/command.js";
+import type { OutboxPort } from "../core/ports.js";
+import { type DerivedRiskByToolId, type ToolRegistration } from "../core/tools/registration-kit.js";
+import type { NavLocationBindingRepoPort } from "./ports.js";
+import type { MenuRepoPort } from "./repo.memory.js";
+/**
+ * The exact slice of the route-deps bag Menus' tool handlers read. Declared structurally (rather
+ * than importing a host's own `RouteDeps`) so this module carries no back-edge into any host's
+ * composition root. A host's `server/routes/*` satisfies this structurally by passing its existing
+ * route-deps object; nothing there needs to change shape.
+ */
+export interface MenusToolDeps {
+    authorize: AuthorizeFn;
+    workspaceId: string;
+    clock: {
+        nowIso(): string;
+    };
+    idGen: {
+        newId(): string;
+    };
+    outbox: OutboxPort;
+    menuRepo: MenuRepoPort;
+    navLocationBindingRepo: NavLocationBindingRepoPort;
+}
+/**
+ * This wiring layer's OWN risk classification, authored from what each handler below actually
+ * calls. See `DerivedRiskByToolId` in the kit for why it is independent of the catalog's own
+ * `sideEffects` declaration.
+ */
+export declare const menusDerivedRisk: DerivedRiskByToolId;
+export declare function buildMenusRegistrations(routeDeps: MenusToolDeps): ToolRegistration[];
+//# sourceMappingURL=tool-registrations.d.ts.map

package/dist/navigation/tool-registrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registrations.d.ts","sourceRoot":"","sources":["../../src/navigation/tool-registrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EASL,KAAK,mBAAmB,EAExB,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKrD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,MAAM,IAAI,MAAM,CAAA;KAAE,CAAC;IAC5B,KAAK,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,sBAAsB,EAAE,0BAA0B,CAAC;CACpD;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,mBAa7B,CAAC;AA0CH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,aAAa,GAAG,gBAAgB,EAAE,CA8EpF"}