@cavuno/board 2.0.0 → 2.0.1

package/dist/index.mjs

@@ -265,12 +265,24 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "2.0.0";
+var SDK_VERSION = "2.0.1";
 
 // src/client.ts
 function isRawBody(body) {
   return typeof body === "string" || body instanceof URLSearchParams || typeof FormData !== "undefined" && body instanceof FormData || typeof Blob !== "undefined" && body instanceof Blob || body instanceof ArrayBuffer || typeof ReadableStream !== "undefined" && body instanceof ReadableStream;
 }
+function redactUrlForLog(value) {
+  try {
+    const url = new URL(value);
+    for (const key of new Set(url.searchParams.keys())) {
+      url.searchParams.delete(key);
+      url.searchParams.set(key, "[REDACTED]");
+    }
+    return url.toString();
+  } catch {
+    return value.replace(/([?&][^=&#]+)=([^&#]*)/g, "$1=[REDACTED]");
+  }
+}
 var BoardClient = class {
   storage;
   basePath;
@@ -322,9 +334,10 @@ var BoardClient = class {
       init: { ...passthrough, method, headers, body: serializedBody }
     };
     if (this.options.onRequest) req = await this.options.onRequest(req);
-    this.options.logger?.debug(`${method} ${req.url}`);
+    const logUrl = redactUrlForLog(req.url);
+    this.options.logger?.debug(`${method} ${logUrl}`);
     const res = await globalThis.fetch(req.url, req.init);
-    this.options.logger?.debug(`${res.status} ${method} ${req.url}`);
+    this.options.logger?.debug(`${res.status} ${method} ${logUrl}`);
     if (this.options.onResponse)
       await this.options.onResponse(res.clone(), req);
     if (res.status === 204) return void 0;
@@ -350,7 +363,7 @@ var BoardClient = class {
       raw: parsed
     });
     this.options.logger?.error(
-      `${error.status} ${error.code} ${method} ${req.url}`
+      `${error.status} ${error.code} ${method} ${logUrl}`
     );
     throw error;
   }
@@ -1005,7 +1018,7 @@ function jobsNamespace(client) {
       );
     },
     /**
-     * Apply to a job natively (ADR-0054). Optional auth: a signed-in candidate
+     * Apply to a job natively. Optional auth: a signed-in candidate
      * applies from their profile (omit name/email); a guest supplies them
      * (allowed only when the board permits applications without sign-up).
      * Idempotent — a repeat apply returns the existing application.
@@ -1103,8 +1116,8 @@ function meNamespace(client) {
       return client.fetch("/me", { ...options, method: "DELETE" });
     },
     /**
-     * The authenticated candidate's own account self-service (doc 32).
-     * `profile.*` is the lean profile singleton + (commit 2+) its
+     * The authenticated candidate's own account self-service.
+     * `profile.*` is the lean profile singleton + its
      * experience / education / skills / languages collections + avatar.
      */
     profile: {
@@ -1252,7 +1265,7 @@ function meNamespace(client) {
     },
     /**
      * Signed-in notification preferences + the anonymous email-link
-     * unsubscribe branch (doc 32).
+     * unsubscribe branch.
      */
     notificationPreferences: {
       /** List every notification channel + its subscribed state. */
@@ -1282,7 +1295,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The authenticated board user's employer facet (doc 35 / ADR-0052):
+     * The authenticated board user's employer facet:
      * claiming/creating a company, the work-email verification state machine,
      * and editing the company profile. A board user becomes an employer by
      * claiming a company — the same identity can also be a candidate.
@@ -1427,8 +1440,7 @@ function meNamespace(client) {
         }
       },
       /**
-       * Manage the jobs of a company I am an approved member of (doc 35 /
-       * ADR-0052). Every method is scoped to the company `slug`. New jobs are
+       * Manage the jobs of a company I am an approved member of . Every method is scoped to the company `slug`. New jobs are
        * created as held drafts — publishing is `publish` (within a live paid
        * window) or the paid-post checkout flow.
        */
@@ -1528,7 +1540,7 @@ function meNamespace(client) {
           );
         },
         /**
-         * Pay for / publish a held draft (ADR-0031). Select billing: a paid plan
+         * Pay for / publish a held draft. Select billing: a paid plan
          * returns `{ status: 'checkout', checkoutUrl }` (send the buyer there;
          * the webhook publishes on payment); a free / bundle / subscription plan
          * publishes immediately (`status: 'published'`); an invoice plan emails a
@@ -1569,10 +1581,10 @@ function meNamespace(client) {
       },
       /**
        * The read-only reporting funnel that backs the hosted employer jobs
-       * table (doc 35): per-job views / apply clicks / native applications,
+       * table: per-job views / apply clicks / native applications,
        * plus a daily views+apply-clicks time-series for a chart. Membership-
-       * scoped; never cached. Analytics degrade to zeroes on a Tinybird
-       * outage — the reads never fail on an analytics problem, so a `0` means
+       * scoped; never cached. Analytics degrade to zeroes when reporting data
+       * is temporarily unavailable, so a `0` means
        * "no activity" OR "analytics briefly unavailable".
        */
       jobStats: {
@@ -1609,7 +1621,7 @@ function meNamespace(client) {
         }
       },
       /**
-       * Company-profile page views (doc 35) for the employer dashboard's
+       * Company-profile page views for the employer dashboard's
        * "profile views" metric — visits to the company profile page ITSELF
        * (`/companies/{slug}`, tab subpaths and bots excluded), NOT job details.
        * Membership-scoped; never cached; degrades to `0` / an empty series on
@@ -1648,7 +1660,7 @@ function meNamespace(client) {
       },
       /**
        * The applicant pipeline (ATS) for a company I am an approved member of
-       * (doc 35 / ADR-0052 / ADR-0004). Reads return the full pipeline (job
+       * Reads return the full pipeline (job
        * header + stage rail + applicants with timelines); the move/reject/note
        * writes resolve void — re-read the pipeline for fresh state, mirroring
        * the hosted portal's single reactive query.
@@ -1799,7 +1811,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The viewer's talent entitlement on this board (CAV-243) — "does this
+     * The viewer's talent entitlement on this board — "does this
      * employer have talent access?" for gating a Message-vs-upsell CTA.
      * Candidates and unaffiliated viewers get `hasTalentAccess: false`.
      *
@@ -1818,7 +1830,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The authenticated board user's job-alert preferences (ADR-0053) —
+     * The authenticated board user's job-alert preferences —
      * a collection (up to 10). Creating one is active immediately (no
      * double opt-in — the authenticated action is the consent). There is no
      * pause: `remove` is the only way to stop an alert.
@@ -1892,7 +1904,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The authenticated candidate's applications (ADR-0054). Apply itself lives
+     * The authenticated candidate's applications. Apply itself lives
      * on the job (`board.jobs.apply` — it is optional-auth); these manage the
      * applications the candidate has already submitted, keyed by `applicationId`.
      */
@@ -1948,7 +1960,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The candidate's resume (ADR-0055). `upload` starts an async parse that
+     * The candidate's resume. `upload` starts an async parse that
      * auto-populates the profile — it returns `parseStatus: 'parsing'`; poll
      * `retrieve()` until `parsed`/`failed`, then re-read `profile.*`.
      */
@@ -2039,7 +2051,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The authenticated board user's messaging inbox (doc 34 / ADR-0053).
+     * The authenticated board user's messaging inbox.
      * The v1 surface is polled REST — there is no realtime primitive; poll
      * `list` / `listMessages` / `unreadCount` on an interval (3–5s is the
      * reference cadence) for near-live updates.
@@ -2177,7 +2189,7 @@ function meNamespace(client) {
         );
       },
       /**
-       * The existing employer↔candidate conversation id (or null). Tier-3
+       * The existing employer↔candidate conversation id (or null).
        * talent-contact helper — route to an existing thread instead of opening
        * a composer.
        *
@@ -2192,7 +2204,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * Blocking (doc 34 §E): list / add / remove blocks + a Tier-3 status check.
+     * Blocking: list / add / remove blocks + a  status check.
      */
     blocks: {
       /**
@@ -2230,7 +2242,7 @@ function meNamespace(client) {
         );
       },
       /**
-       * Whether I've blocked a user (Tier-3 helper).
+       * Whether I've blocked a user.
        *
        * @example
        * const { blocked } = await board.me.blocks.status(boardUserId);
@@ -2243,7 +2255,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * Message-scoped actions (doc 34 §E): edit / unsend your own messages
+     * Message-scoped actions: edit / unsend your own messages
      * (15-minute window), and report a message addressed to you.
      */
     messages: {
@@ -2289,8 +2301,7 @@ function meNamespace(client) {
       }
     },
     /**
-     * The candidate job-access paywall — the authenticated money flow (doc 36 /
-     * ADR-0056). Enumerate offers publicly with `board.paywall.offers()`, then
+     * The candidate job-access paywall — the authenticated money flow . Enumerate offers publicly with `board.paywall.offers()`, then
      * `checkout` here; poll `retrieveCheckout` until complete and confirm with
      * `grant`. The SDK stays Stripe-agnostic — `checkout` returns a mount kit
      * and the frontend brings `@stripe/stripe-js`.

package/dist/{jobs-BEYJY97F.d.ts → jobs-CuRzTDb1.d.mts}

@@ -1,15 +1,17 @@
-import { S as Schemas } from './_spec-C7vqY_b3.js';
+import { S as Schemas } from './_spec-sW85fuvT.mjs';
 
 /**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
+ * Optional pagination metadata returned by Board API list operations.
+ * These fields are intentionally defined at the public SDK boundary because
+ * individual response schemas expose them inline rather than through a shared
+ * OpenAPI component.
  */
-/**
- * Optional offset-pagination metadata generated from the Board API contract.
- * `nextCursor` is preserved alongside for forward cursor iteration.
- */
-type OffsetPagination = Schemas['OffsetPagination'];
+interface OffsetPagination {
+    count?: number;
+    limit?: number;
+    offset?: number;
+    gatedCount?: number;
+}
 /** @deprecated Use `OffsetPagination`. */
 type StorefrontPagination = OffsetPagination;
 /** @deprecated Use `OffsetPagination`. */
@@ -33,7 +35,7 @@ type SearchEnvelope<T> = OffsetPagination & {
 type PublicJob = Schemas['PublicJob'];
 type PublicJobCard = Schemas['PublicJobCard'];
 /**
- * A job's opaque, display-only custom-field values (CAV-294), keyed by each
+ * A job's opaque, display-only custom-field values, keyed by each
  * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
  * (`board.context().customFields`).
  */
@@ -44,13 +46,13 @@ type OfficeLocation = Schemas['JobOfficeLocation'];
 type RemoteOption = NonNullable<PublicJob['remoteOption']>;
 type EmploymentType = NonNullable<PublicJob['employmentType']>;
 type Seniority = NonNullable<PublicJob['seniority']>;
-/** Candidate-facing result ordering (ADR-0048); `relevance` is the default. */
+/** Candidate-facing result ordering; `relevance` is the default. */
 type JobSort = NonNullable<Schemas['PublicSearchJobsBody']['sort']>;
 type EducationRequirement = PublicJob['educationRequirements'][number];
 type RemotePermit = PublicJob['remotePermits'][number];
 type RemoteTimezone = PublicJob['remoteTimezones'][number];
 /**
- * Derived suggestion on a browse list (ADR-0037 §8): jobs surface `category`
+ * Derived suggestion on a browse list: jobs surface `category`
  * and `skill` terms; the companies list surfaces `market` terms.
  */
 interface RelatedSearch {
@@ -83,7 +85,7 @@ type JobsListQuery = {
     remoteOption?: RemoteOption[];
     employmentType?: EmploymentType[];
     seniority?: Seniority[];
-    /** Result ordering (ADR-0048). Absent ⇒ `relevance` (the featured-ranked browse). */
+    /** Result ordering. Absent ⇒ `relevance` (the featured-ranked browse). */
     sort?: JobSort;
     /** Place slug for a geo radius search; unresolvable slugs are ignored. */
     location?: string;

package/dist/{jobs-DJiISpqX.d.mts → jobs-DTnCZGtb.d.ts}

@@ -1,15 +1,17 @@
-import { S as Schemas } from './_spec-C7vqY_b3.mjs';
+import { S as Schemas } from './_spec-sW85fuvT.js';
 
 /**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
+ * Optional pagination metadata returned by Board API list operations.
+ * These fields are intentionally defined at the public SDK boundary because
+ * individual response schemas expose them inline rather than through a shared
+ * OpenAPI component.
  */
-/**
- * Optional offset-pagination metadata generated from the Board API contract.
- * `nextCursor` is preserved alongside for forward cursor iteration.
- */
-type OffsetPagination = Schemas['OffsetPagination'];
+interface OffsetPagination {
+    count?: number;
+    limit?: number;
+    offset?: number;
+    gatedCount?: number;
+}
 /** @deprecated Use `OffsetPagination`. */
 type StorefrontPagination = OffsetPagination;
 /** @deprecated Use `OffsetPagination`. */
@@ -33,7 +35,7 @@ type SearchEnvelope<T> = OffsetPagination & {
 type PublicJob = Schemas['PublicJob'];
 type PublicJobCard = Schemas['PublicJobCard'];
 /**
- * A job's opaque, display-only custom-field values (CAV-294), keyed by each
+ * A job's opaque, display-only custom-field values, keyed by each
  * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
  * (`board.context().customFields`).
  */
@@ -44,13 +46,13 @@ type OfficeLocation = Schemas['JobOfficeLocation'];
 type RemoteOption = NonNullable<PublicJob['remoteOption']>;
 type EmploymentType = NonNullable<PublicJob['employmentType']>;
 type Seniority = NonNullable<PublicJob['seniority']>;
-/** Candidate-facing result ordering (ADR-0048); `relevance` is the default. */
+/** Candidate-facing result ordering; `relevance` is the default. */
 type JobSort = NonNullable<Schemas['PublicSearchJobsBody']['sort']>;
 type EducationRequirement = PublicJob['educationRequirements'][number];
 type RemotePermit = PublicJob['remotePermits'][number];
 type RemoteTimezone = PublicJob['remoteTimezones'][number];
 /**
- * Derived suggestion on a browse list (ADR-0037 §8): jobs surface `category`
+ * Derived suggestion on a browse list: jobs surface `category`
  * and `skill` terms; the companies list surfaces `market` terms.
  */
 interface RelatedSearch {
@@ -83,7 +85,7 @@ type JobsListQuery = {
     remoteOption?: RemoteOption[];
     employmentType?: EmploymentType[];
     seniority?: Seniority[];
-    /** Result ordering (ADR-0048). Absent ⇒ `relevance` (the featured-ranked browse). */
+    /** Result ordering. Absent ⇒ `relevance` (the featured-ranked browse). */
     sort?: JobSort;
     /** Place slug for a geo radius search; unresolvable slugs are ignored. */
     location?: string;

package/dist/paths.d.mts

@@ -6,13 +6,13 @@
  *
  * Each `*Path` returns an absolute path (leading slash, no origin);
  * `boardUrl(origin, path)` prefixes a board origin. Pure, isomorphic,
- * zero-dependency — safe to import in the Convex runtime, on the edge,
+ * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
- * cross-surface contract (ADR-0070).
+ * cross-surface contract.
  */
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
@@ -63,7 +63,7 @@ declare const BOARD_PATHS: {
     readonly talent: "/talent";
     readonly employers: "/employers";
     /**
-     * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+     * Alert-email surfaces. Promoted out of raw literals in
      * the job-alerts composer so /go indirection and email composition share
      * one definition.
      */
@@ -71,8 +71,8 @@ declare const BOARD_PATHS: {
     readonly alertsConfirm: "/alerts/confirm";
 };
 /**
- * Email `/go` indirection paths (ADR-0090 D4 / LNK-05). Pure builders so
- * Convex email composers can emit structure-independent links without
+ * Email `/go` indirection paths. Pure builders so
+ * Server-side email composers can emit structure-independent links without
  * importing `@cavuno/board/go` (handler code is not safe in that runtime).
  *
  * Shapes match the hosted handler + SDK `createGoHandler` contracts:
@@ -80,7 +80,7 @@ declare const BOARD_PATHS: {
  *   /go/alerts-manage
  *   /go/alerts-confirm
  *
- * No encoding — callers pass opaque Convex ids / static role segments that
+ * No encoding — callers pass opaque Cavuno ids / static role segments that
  * are already URL-safe path segments. Query strings are composed by the
  * caller (tokens must ride through verbatim).
  */

package/dist/paths.d.ts

@@ -6,13 +6,13 @@
  *
  * Each `*Path` returns an absolute path (leading slash, no origin);
  * `boardUrl(origin, path)` prefixes a board origin. Pure, isomorphic,
- * zero-dependency — safe to import in the Convex runtime, on the edge,
+ * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
- * cross-surface contract (ADR-0070).
+ * cross-surface contract.
  */
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
@@ -63,7 +63,7 @@ declare const BOARD_PATHS: {
     readonly talent: "/talent";
     readonly employers: "/employers";
     /**
-     * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+     * Alert-email surfaces. Promoted out of raw literals in
      * the job-alerts composer so /go indirection and email composition share
      * one definition.
      */
@@ -71,8 +71,8 @@ declare const BOARD_PATHS: {
     readonly alertsConfirm: "/alerts/confirm";
 };
 /**
- * Email `/go` indirection paths (ADR-0090 D4 / LNK-05). Pure builders so
- * Convex email composers can emit structure-independent links without
+ * Email `/go` indirection paths. Pure builders so
+ * Server-side email composers can emit structure-independent links without
  * importing `@cavuno/board/go` (handler code is not safe in that runtime).
  *
  * Shapes match the hosted handler + SDK `createGoHandler` contracts:
@@ -80,7 +80,7 @@ declare const BOARD_PATHS: {
  *   /go/alerts-manage
  *   /go/alerts-confirm
  *
- * No encoding — callers pass opaque Convex ids / static role segments that
+ * No encoding — callers pass opaque Cavuno ids / static role segments that
  * are already URL-safe path segments. Query strings are composed by the
  * caller (tokens must ride through verbatim).
  */

package/dist/paths.js

@@ -97,7 +97,7 @@ var BOARD_PATHS = {
   talent: "/talent",
   employers: "/employers",
   /**
-   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * Alert-email surfaces. Promoted out of raw literals in
    * the job-alerts composer so /go indirection and email composition share
    * one definition.
    */

package/dist/paths.mjs

@@ -56,7 +56,7 @@ var BOARD_PATHS = {
   talent: "/talent",
   employers: "/employers",
   /**
-   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * Alert-email surfaces. Promoted out of raw literals in
    * the job-alerts composer so /go indirection and email composition share
    * one definition.
    */

package/dist/roles-vY0AXhoc.d.mts

@@ -51,7 +51,7 @@ type ValidateManifestResult = {
 };
 
 /**
- * Role vocabulary for the per-board route manifest (ADR-0090 D1).
+ * Role vocabulary for the per-board route manifest.
  *
  * Parameterized roles mirror the helpers in `../paths`; static roles mirror
  * `BOARD_PATHS` keys; `alertsManage` / `alertsConfirm` are promoted out of
@@ -67,7 +67,7 @@ type RouteRole = 'jobDetail' | 'jobsCategory' | 'jobsSkill' | 'jobsLocation' | '
  * Empty arrays = static / zero-param roles (never inferred by signature).
  */
 declare const ROLE_PARAM_REGISTRY: Record<RouteRole, readonly string[]>;
-/** Email-emitting roles — a missing one blocks publish (ADR-0090 D1/D6). */
+/** Email-emitting roles — a missing one blocks publish. */
 declare const REQUIRED_ROLES: readonly RouteRole[];
 /** All known roles (stable iteration order = registry key order). */
 declare const ALL_ROLES: readonly RouteRole[];
@@ -75,7 +75,7 @@ declare function isRouteRole(value: string): value is RouteRole;
 /**
  * Identity manifest reproducing the current canonical structure from the
  * paths module. Built by calling helpers with `:param` placeholders so the
- * templates stay locked to the helpers (ADR-0070 / ADR-0090).
+ * templates stay locked to the helpers.
  */
 declare const CANONICAL_MANIFEST: ManifestV1;
 

package/dist/roles-vY0AXhoc.d.ts

@@ -51,7 +51,7 @@ type ValidateManifestResult = {
 };
 
 /**
- * Role vocabulary for the per-board route manifest (ADR-0090 D1).
+ * Role vocabulary for the per-board route manifest.
  *
  * Parameterized roles mirror the helpers in `../paths`; static roles mirror
  * `BOARD_PATHS` keys; `alertsManage` / `alertsConfirm` are promoted out of
@@ -67,7 +67,7 @@ type RouteRole = 'jobDetail' | 'jobsCategory' | 'jobsSkill' | 'jobsLocation' | '
  * Empty arrays = static / zero-param roles (never inferred by signature).
  */
 declare const ROLE_PARAM_REGISTRY: Record<RouteRole, readonly string[]>;
-/** Email-emitting roles — a missing one blocks publish (ADR-0090 D1/D6). */
+/** Email-emitting roles — a missing one blocks publish. */
 declare const REQUIRED_ROLES: readonly RouteRole[];
 /** All known roles (stable iteration order = registry key order). */
 declare const ALL_ROLES: readonly RouteRole[];
@@ -75,7 +75,7 @@ declare function isRouteRole(value: string): value is RouteRole;
 /**
  * Identity manifest reproducing the current canonical structure from the
  * paths module. Built by calling helpers with `:param` placeholders so the
- * templates stay locked to the helpers (ADR-0070 / ADR-0090).
+ * templates stay locked to the helpers.
  */
 declare const CANONICAL_MANIFEST: ManifestV1;
 

package/dist/route-contract.d.mts

@@ -11,13 +11,13 @@ declare function classifyRoutes(routes: RouteEntry[], markers?: ReadonlyMap<stri
 
 /**
  * Classify routes and emit a ManifestV1 plus publish-gate signals.
- * Assigned templates are self-validated via checkRoleTemplate (F1);
+ * Assigned templates are self-validated via checkRoleTemplate;
  * failing required roles land in blockingMissing; failing optionals warn.
  */
 declare function compileManifest(routes: RouteEntry[], markers?: ReadonlyMap<string, RouteRole>): CompileResult;
 
 /**
- * LNK-06 — compile a ManifestV1 from a workspace file tree already in
+ *  — compile a ManifestV1 from a workspace file tree already in
  * memory (candidate verification). Pure: no IO.
  */
 
@@ -36,7 +36,7 @@ declare function compileManifestFromTree(files: ReadonlyArray<TreeFile>): Compil
  * Tolerant parse of `export const cavunoPage = '<role>'` (single or double
  * quotes; optional `as const`). Accepts camelCase roles and their kebab-case
  * aliases (`job-detail` → `jobDetail`). Returns null when absent or when the
- * string is not a known RouteRole (ADR-0090 D6 escape hatch).
+ * string is not a known RouteRole.
  */
 declare function extractCavunoPageMarker(contents: string): RouteRole | null;
 
@@ -70,7 +70,7 @@ declare function checkRoleTemplate(role: RouteRole, template: string): ValidateM
 declare function validateManifest(value: unknown): ValidateManifestResult;
 
 /**
- * Platform resolution overlay (ADR-0090 D3 / LNK-07).
+ * Platform resolution overlay.
  *
  * Pure + isomorphic: role + params + precedence layers → board path.
  * Imports only sibling route-contract / paths modules.
@@ -92,7 +92,7 @@ declare function createBoardLinkResolver(layers: readonly ManifestLayer[]): {
 };
 
 /**
- * LNK-10 — pure history path matching for hosted rename 301s (ADR-0090 D7).
+ *  — pure history path matching for hosted rename 301s.
  *
  * Segment-wise matcher (no RegExp construction from templates). Templates
  * are validated at write time but stay defensive here: any segment that
@@ -131,7 +131,7 @@ type HistoryMatchResult = {
 declare function matchPathAgainstHistory(entries: readonly HistoryMatchEntry[], pathname: string): HistoryMatchResult | null;
 
 /**
- * LNK-02 — shared types for the route-derivation adapter registry.
+ *  — shared types for the route-derivation adapter registry.
  */
 type DerivedRoute = {
     path: string;
@@ -151,7 +151,7 @@ type FrameworkId = 'tanstack' | 'next' | 'astro' | 'sveltekit' | 'nuxt' | 'react
  *
  * The marker-less TanStack heuristic (any src/routes/*.tsx|jsx) runs LAST
  * among framework checks so a Next/Astro/SvelteKit/Nuxt repo with a stray
- * src/routes helper is never misclassified (F1).
+ * src/routes helper is never misclassified.
  */
 
 declare function detectFramework(paths: string[]): FrameworkId | null;
@@ -159,8 +159,8 @@ declare function detectFramework(paths: string[]): FrameworkId | null;
 /**
  * react-router pure parsers over provided FILE CONTENTS.
  *
- * Content-fetch is intentionally NOT wired into the navigator UI —
- * LNK-02 only exposes these functions; UI wiring is a later ticket.
+ * Content-fetch is intentionally not supported into the navigator UI —
+ *  only exposes these functions; UI wiring is a future release.
  */
 
 /**
@@ -177,7 +177,7 @@ declare function parseReactRouterRoutes(contents: string[]): DerivedRoute[];
 
 /**
  * TanStack Start / TanStack Router file-based route conventions under
- * `src/routes/`. Behavior preserved exactly from the CHR-03 parser.
+ * `src/routes/`. Behavior preserved exactly from the  parser.
  *
  *   - `index` → parent path (`src/routes/index.tsx` → `/`)
  *   - dots nest (`jobs.index.tsx` → `/jobs`)
@@ -208,7 +208,7 @@ declare function parseNextRoutes(paths: string[]): DerivedRoute[];
  * when the tree has astro.config.* and no src/pages/ (srcDir-customized).
  * Page extensions: .astro / .md / .mdx / .html.
  * Skip _-prefixed and .../api/. Index collapses.
- * [param]→:param, [...slug]→*, [[...slug]]→* (F5).
+ * [param]→:param, [...slug]→*, [[...slug]]→*.
  */
 
 declare function parseAstroRoutes(paths: string[]): DerivedRoute[];
@@ -217,7 +217,7 @@ declare function parseAstroRoutes(paths: string[]): DerivedRoute[];
  * SvelteKit file-based routing: src/routes/.../+page.svelte
  * and layout-reset +page@*.svelte only.
  * (group) stripped, [param]→:param, [[...rest]]→*, dynamic ⇒ navigable false.
- * +page.ts / +page.server.ts are load modules and derive nothing (F4).
+ * +page.ts / +page.server.ts are load modules and derive nothing.
  */
 
 declare function parseSvelteKitRoutes(paths: string[]): DerivedRoute[];
@@ -231,7 +231,7 @@ declare function parseSvelteKitRoutes(paths: string[]): DerivedRoute[];
 declare function parseNuxtRoutes(paths: string[]): DerivedRoute[];
 
 /**
- * LNK-02 — framework adapter registry entry.
+ *  — framework adapter registry entry.
  *
  * Detects the framework from a path listing, dispatches to the matching
  * pure parser, returns DerivedRoute[] (path + navigable). Unknown → [].
@@ -239,18 +239,18 @@ declare function parseNuxtRoutes(paths: string[]): DerivedRoute[];
  * react-router content parsers are exported for later UI wiring; the
  * path-only deriveRoutes entry returns [] for react-router-only trees.
  *
- * LNK-06: enumerateRouteEntries keeps sourcePath for marker harvest +
+ *enumerateRouteEntries keeps sourcePath for marker harvest +
  * compileManifest; deriveRoutes strips it so the navigator contract is
  * unchanged (path + navigable only).
  */
 
 /**
- * Navigator contract: path + navigable only (CHR-03 / LNK-02 stable).
+ * Navigator contract: path + navigable only.
  * sourcePath is intentionally stripped so existing equality fixtures hold.
  */
 declare function deriveRoutes(paths: string[]): DerivedRoute[];
 /**
- * LNK-06 compile path: URL template + sourcePath for marker harvest.
+ *  compile path: URL template + sourcePath for marker harvest.
  */
 declare function enumerateRouteEntries(paths: string[]): RouteEntry[];