@north-light/crouter 0.3.317 → 0.3.319

package/dist/core/substrate/schema.js

@@ -1,186 +1 @@
-// schema.ts — the typed shape of a substrate document's frontmatter, the
-// visibility ladder, and the parse/validate function that turns a resolved
-// MemoryDoc into a fully-typed SubstrateDoc. This is the keystone every
-// downstream track (CLI verbs, boot render, on-read render, migrator) builds
-// against — pure and side-effect free. See design-substrate.md §4 (schema).
-//
-// The runtime parser is tolerant by contract (it maps over many docs and must
-// never throw): invalid `surfaces` entries are dropped rather than crashing a
-// render, and `crtr memory lint` owns strict authoring-time enforcement.
-import { PROFILE_PROJECT_MEMORY_VALUES } from '../../api/dto/profiles.js';
-// Kinds — the two semantic kinds (design §3): `knowledge` (consult — procedural
-// playbooks + factual references merged) vs `preference` (behave — standing
-// directives). `kind` is a load-bearing binary, not a content taxonomy.
-export const KINDS = ['knowledge', 'preference'];
-/** Is `v` one of the two valid document kinds? */
-export function isDocKind(v) {
-    return typeof v === 'string' && KINDS.includes(v);
-}
-// The 4-rung visibility ladder (design §4). A strict, monotone ordering where
-// each rung is a superset of disclosure over the one before:
-//   none < name < preview < content
-// The ladder is ONE union, owned by the public API DTO (`ProfileProjectMemory`)
-// so a profile relationship's cap and a doc's authored rung are the same values
-// and clamp against each other without a conversion.
-export const RUNGS = PROFILE_PROJECT_MEMORY_VALUES;
-/** Ordinal of a rung on the ladder (none=0 … content=3). */
-export function rungRank(r) {
-    return RUNGS.indexOf(r);
-}
-/** Does rung `r` disclose at least as much as `min`? */
-export function rungAtLeast(r, min) {
-    return rungRank(r) >= rungRank(min);
-}
-/** The lower of two rungs — the clamp automatic delivery applies to an
- *  authored rung against its project relationship's cap. */
-export function minRung(a, b) {
-    return rungRank(a) <= rungRank(b) ? a : b;
-}
-// Identity — owned entirely by core/memory/identity.ts (ordering-prefix
-// normalization, INDEX collapse, explicit-name-then-path local identity,
-// namespace composition). Re-exported here so document parsing and identity
-// derivation stay one rule with one implementation.
-export { normalizeNameSegment, normalizeDocName, resolveLocalName as resolveDocName } from '../memory/identity.js';
-// Surfaces — explicit event routing (design: surfaces-design.md). A doc
-// declares WHEN it delivers as (event, match, rung) entries; matches are
-// always globs, always absolute in the event's namespace, with `./` as the
-// one relative spelling (anchoring to the doc's own container). A doc with
-// no `surfaces` at all does exactly one thing: appears in its directory's
-// listing.
-export const SURFACE_EVENTS = ['boot', 'workspace-open', 'read', 'memory-read', 'command', 'pre-command'];
-/** The rungs an entry may deliver at. There is no `none` — silence is the
- *  absence of an entry. (`Rung`'s `none` survives only as the internal
- *  ranking floor — the planner's verdict for a doc that delivers nothing.) */
-export const SURFACE_RUNGS = ['name', 'preview', 'content'];
-// Parse / validate.
-/** Parse a raw frontmatter record (from `parseFrontmatterGeneric`, via the
- *  resolver) into a typed schema with defaults applied. Returns `null` when the
- *  record is absent or carries no valid `kind` — i.e. it is not a substrate
- *  document and cannot be classified. Tolerant of every other imperfection (a
- *  missing `when-and-why-to-read` defaults to '', a missing/bad rung falls back
- *  to the neutral floor `none`), so a renderer mapping over many docs never
- *  throws. Authoring-time enforcement of these fields lives in `crtr memory
- *  write` (on create) and `crtr memory lint`. */
-export function parseSubstrateFrontmatter(fm) {
-    if (fm === null)
-        return null;
-    if (!isDocKind(fm.kind))
-        return null;
-    const kind = fm.kind;
-    return {
-        kind,
-        whenAndWhyToRead: strField(fm['when-and-why-to-read']),
-        shortForm: strField(fm['short-form']),
-        unlisted: fm['unlisted'] === true,
-        surfaces: parseSurfaces(fm['surfaces']),
-        gate: parseGate(fm.gate),
-        slash: fm.slash === true,
-        rationale: parseRationale(fm['rationale']),
-    };
-}
-/** Parse a resolved MemoryDoc into a fully-typed SubstrateDoc (schema + the
- *  resolver's name/scope/path/body). Returns `null` for a non-substrate doc
- *  (no valid `kind`), so callers can `docs.map(parseSubstrateDoc).filter(...)`. */
-export function parseSubstrateDoc(doc) {
-    const schema = parseSubstrateFrontmatter(doc.frontmatter);
-    if (schema === null)
-        return null;
-    return { ...schema, name: doc.name, scope: doc.scope, plugin: doc.plugin, path: doc.path, body: doc.body, projectMemory: doc.projectMemory };
-}
-/** The kind a doc resolves to for `--kind` filtering/matching: the substrate
- *  kind when the frontmatter parses as a valid substrate doc, else the raw
- *  frontmatter `kind` string when present (even if not one of the two valid
- *  kinds — an authoring error, not grounds to silently reclassify it), else
- *  the legacy default `knowledge` for a frontmatter-less/kindless doc. The
- *  single coercion `memory read`'s resolution and result display share, so a
- *  `--kind` filter and the displayed `kind` field never disagree. */
-export function effectiveDocKind(doc) {
-    const sub = parseSubstrateDoc(doc);
-    if (sub !== null)
-        return sub.kind;
-    const raw = doc.frontmatter?.['kind'];
-    return typeof raw === 'string' ? raw : 'knowledge';
-}
-/** The `preview`-rung routing line (design §4): the `when-and-why-to-read`
- *  field rendered essentially verbatim — it is already authored as the complete
- *  routing sentence ("When …, this <kind> should be read …"), so there is no
- *  template to compose. Both boot and on-read render this identical line, so it
- *  lives once here to prevent drift. Light cleanup normalizes the trailing
- *  period. */
-export function previewLine(doc) {
-    const line = doc.whenAndWhyToRead.trim().replace(/\.+$/, '');
-    return line === '' ? '' : `${line}.`;
-}
-// Field coercion helpers (private).
-function strField(v) {
-    return typeof v === 'string' ? v : '';
-}
-/** Resolve an optional `rationale` field: a non-empty string is carried as-is
- *  (multi-line YAML block scalars parse to a plain string, so no special
- *  handling is needed); anything else (absent, blank, non-string) yields
- *  `undefined` — the doc simply carries no rationale. */
-function parseRationale(v) {
-    return typeof v === 'string' && v.trim() !== '' ? v : undefined;
-}
-/** A gate is engaged only when frontmatter carries a non-null, non-array object
- *  (the predicate vocabulary's field→matcher map). Anything else (absent, null,
- *  scalar, array) ⇒ no gate ⇒ always eligible — the safe default that never
- *  silently hides a doc. An empty `{}` IS carried (and is inert per design §4). */
-function parseGate(v) {
-    return v !== null && typeof v === 'object' && !Array.isArray(v)
-        ? v
-        : undefined;
-}
-/** Tolerant `surfaces` parse: a non-array yields `[]`; invalid entries are
- *  dropped (bad `on`, bad `at`, a read/memory-read/command/pre-command entry
- *  left with neither `match` nor — read only — `match-frontmatter`). `match-frontmatter`
- *  on a non-read event is dropped from the entry, which survives iff it still
- *  carries a `match`; an invalid entry `gate` is dropped. Lint owns strict
- *  enforcement; the runtime parser maps over many docs and must never throw. */
-export function parseSurfaces(v) {
-    if (!Array.isArray(v))
-        return [];
-    const out = [];
-    for (const raw of v) {
-        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
-            continue;
-        const rec = raw;
-        const on = rec['on'];
-        if (typeof on !== 'string' || !SURFACE_EVENTS.includes(on))
-            continue;
-        const at = rec['at'];
-        if (typeof at !== 'string' || !SURFACE_RUNGS.includes(at))
-            continue;
-        const match = parseMatchGlobs(rec['match']);
-        const matchFrontmatter = on === 'read' ? parseGate(rec['match-frontmatter']) : undefined;
-        const gate = parseGate(rec['gate']);
-        if ((on === 'read' || on === 'memory-read' || on === 'command' || on === 'pre-command') &&
-            match === undefined &&
-            matchFrontmatter === undefined) {
-            continue;
-        }
-        out.push({
-            on: on,
-            at: at,
-            ...(match !== undefined ? { match } : {}),
-            ...(matchFrontmatter !== undefined ? { matchFrontmatter } : {}),
-            ...(gate !== undefined ? { gate } : {}),
-        });
-    }
-    return out;
-}
-/** Normalize an entry's `match` to a non-empty glob list, or undefined.
- *  Accepts a string or an array of strings; blanks are dropped. */
-function parseMatchGlobs(v) {
-    if (typeof v === 'string') {
-        const t = v.trim();
-        return t === '' ? undefined : [t];
-    }
-    if (Array.isArray(v)) {
-        const globs = v
-            .filter((g) => typeof g === 'string' && g.trim() !== '')
-            .map((g) => g.trim());
-        return globs.length > 0 ? globs : undefined;
-    }
-    return undefined;
-}
+var l=Object.defineProperty;var t=(e,n)=>l(e,"name",{value:n,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as m}from"../../api/dto/profiles.js";const y=["knowledge","preference"];function g(e){return typeof e=="string"&&y.includes(e)}t(g,"isDocKind");const h=m;function a(e){return h.indexOf(e)}t(a,"rungRank");function F(e,n){return a(e)>=a(n)}t(F,"rungAtLeast");function D(e,n){return a(e)<=a(n)?e:n}t(D,"minRung");import{normalizeNameSegment as j,normalizeDocName as G,resolveLocalName as O}from"../memory/identity.js";const x=["boot","workspace-open","read","memory-read","command","pre-command"],A=["name","preview","content"];function R(e){return e===null||!g(e.kind)?null:{kind:e.kind,whenAndWhyToRead:p(e["when-and-why-to-read"]),shortForm:p(e["short-form"]),unlisted:e.unlisted===!0,surfaces:k(e.surfaces),gate:f(e.gate),slash:e.slash===!0,rationale:S(e.rationale)}}t(R,"parseSubstrateFrontmatter");function w(e){const n=R(e.frontmatter);return n===null?null:{...n,name:e.name,scope:e.scope,plugin:e.plugin,path:e.path,body:e.body,projectMemory:e.projectMemory}}t(w,"parseSubstrateDoc");function L(e){const n=w(e);if(n!==null)return n.kind;const r=e.frontmatter?.kind;return typeof r=="string"?r:"knowledge"}t(L,"effectiveDocKind");function M(e){const n=e.whenAndWhyToRead.trim().replace(/\.+$/,"");return n===""?"":`${n}.`}t(M,"previewLine");function p(e){return typeof e=="string"?e:""}t(p,"strField");function S(e){return typeof e=="string"&&e.trim()!==""?e:void 0}t(S,"parseRationale");function f(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}t(f,"parseGate");function k(e){if(!Array.isArray(e))return[];const n=[];for(const r of e){if(r===null||typeof r!="object"||Array.isArray(r))continue;const i=r,o=i.on;if(typeof o!="string"||!x.includes(o))continue;const u=i.at;if(typeof u!="string"||!A.includes(u))continue;const s=b(i.match),c=o==="read"?f(i["match-frontmatter"]):void 0,d=f(i.gate);(o==="read"||o==="memory-read"||o==="command"||o==="pre-command")&&s===void 0&&c===void 0||n.push({on:o,at:u,...s!==void 0?{match:s}:{},...c!==void 0?{matchFrontmatter:c}:{},...d!==void 0?{gate:d}:{}})}return n}t(k,"parseSurfaces");function b(e){if(typeof e=="string"){const n=e.trim();return n===""?void 0:[n]}if(Array.isArray(e)){const n=e.filter(r=>typeof r=="string"&&r.trim()!=="").map(r=>r.trim());return n.length>0?n:void 0}}t(b,"parseMatchGlobs");export{y as KINDS,h as RUNGS,x as SURFACE_EVENTS,A as SURFACE_RUNGS,L as effectiveDocKind,g as isDocKind,D as minRung,G as normalizeDocName,j as normalizeNameSegment,w as parseSubstrateDoc,R as parseSubstrateFrontmatter,k as parseSurfaces,M as previewLine,O as resolveDocName,F as rungAtLeast,a as rungRank};

package/dist/core/substrate/session-cache.js

@@ -1,83 +1 @@
-// session-cache.ts — a per-session parse cache for the document substrate.
-//
-// Both substrate hooks (boot render in render.ts, on-read in on-read.ts) re-walk
-// and re-YAML-parse the full corpus on every invocation without memoization.  At
-// the two highest-frequency hook sites this is O(reads × corpus) and O(turns ×
-// corpus) respectively.  This module provides a single session-scoped cache that
-// the hooks read from, so the corpus is scanned and parsed AT MOST ONCE per
-// session turn/read burst.
-//
-// Lifecycle:
-//   • clearSessionCache() — called on every `session_start` by canvas-doc-
-//     substrate.ts.  It does NOT need to be called before the first use: a
-//     cold cache (null) triggers a fresh scan on the next read.
-//   • All getters lazily populate on first call after a clear.
-//   • The cache is a module-level singleton (one JS module instance per pi
-//     process, and each pi process hosts exactly one canvas node session).
-//
-// Cached entries:
-//   • allMemoryDocsInclusive — the full listAllMemoryDocs() corpus, UNFILTERED
-//                        (includes node scope). This is the ONE underlying
-//                        filesystem scan the whole module performs per session;
-//                        every other entry below derives from it by
-//                        filtering/mapping, never by calling listFn() again.
-//   • eventCorpusInclusive — allMemoryDocsInclusive parsed once, each surviving
-//                        SubstrateDoc paired with the resolver descriptor it
-//                        parsed from. The ONE parse pass every delivery plan
-//                        reads from. The pairs matter: `./` memory-read globs
-//                        anchor on the descriptor's canonical routing anchor,
-//                        and the boot tree orders by its physical path. Boot
-//                        filters node scope out of it and loads the node's own
-//                        store separately (render.ts), so a node doc never
-//                        double-surfaces there.
-//   • substrateDocsInclusive — the parsed docs alone, still including node
-//                        scope. Consumers that need every referenceable doc
-//                        (e.g. the inline memory-reference inventory) use this
-//                        pair with allMemoryDocsInclusive.
-// Node subjects are deliberately NOT cached: lifecycle, mode, kind, and other
-// gate inputs can change while a resident broker/session remains live. Rendering
-// must always gate against the current persisted node metadata.
-const _cache = {
-    allMemoryDocsInclusive: null,
-    eventCorpusInclusive: null,
-    substrateDocsInclusive: null,
-};
-/** Called by canvas-doc-substrate.ts on every `session_start`.
- *  Resets all cached values so the next access triggers a fresh scan.  */
-export function clearSessionCache() {
-    _cache.allMemoryDocsInclusive = null;
-    _cache.eventCorpusInclusive = null;
-    _cache.substrateDocsInclusive = null;
-}
-/** The FULL corpus (listAllMemoryDocs()), INCLUDING node scope, scanned at
- *  most once per session. `listFn` is injected by the caller to avoid
- *  circular imports at module init. This is the single filesystem walk the
- *  whole module performs — every other entry derives from this result rather
- *  than re-scanning. */
-export function cachedAllMemoryDocsInclusive(listFn) {
-    if (_cache.allMemoryDocsInclusive === null) {
-        _cache.allMemoryDocsInclusive = listFn();
-    }
-    return _cache.allMemoryDocsInclusive;
-}
-/** allMemoryDocsInclusive parsed and paired with its descriptors, INCLUDING
- *  node scope — the event corpus, and the module's only parse pass. */
-export function cachedEventCorpusInclusive(listFn, parseFn) {
-    if (_cache.eventCorpusInclusive === null) {
-        const out = [];
-        for (const source of cachedAllMemoryDocsInclusive(listFn)) {
-            const doc = parseFn(source);
-            if (doc !== null)
-                out.push({ doc, source });
-        }
-        _cache.eventCorpusInclusive = out;
-    }
-    return _cache.eventCorpusInclusive;
-}
-/** The parsed docs of the inclusive event corpus, without their descriptors. */
-export function cachedSubstrateDocsInclusive(listFn, parseFn) {
-    if (_cache.substrateDocsInclusive === null) {
-        _cache.substrateDocsInclusive = cachedEventCorpusInclusive(listFn, parseFn).map((e) => e.doc);
-    }
-    return _cache.substrateDocsInclusive;
-}
+var t=Object.defineProperty;var l=(s,c)=>t(s,"name",{value:c,configurable:!0});const e={allMemoryDocsInclusive:null,eventCorpusInclusive:null,substrateDocsInclusive:null};function a(){e.allMemoryDocsInclusive=null,e.eventCorpusInclusive=null,e.substrateDocsInclusive=null}l(a,"clearSessionCache");function r(s){return e.allMemoryDocsInclusive===null&&(e.allMemoryDocsInclusive=s()),e.allMemoryDocsInclusive}l(r,"cachedAllMemoryDocsInclusive");function i(s,c){if(e.eventCorpusInclusive===null){const n=[];for(const u of r(s)){const o=c(u);o!==null&&n.push({doc:o,source:u})}e.eventCorpusInclusive=n}return e.eventCorpusInclusive}l(i,"cachedEventCorpusInclusive");function I(s,c){return e.substrateDocsInclusive===null&&(e.substrateDocsInclusive=i(s,c).map(n=>n.doc)),e.substrateDocsInclusive}l(I,"cachedSubstrateDocsInclusive");export{r as cachedAllMemoryDocsInclusive,i as cachedEventCorpusInclusive,I as cachedSubstrateDocsInclusive,a as clearSessionCache};

package/dist/core/substrate/subject-fields.js

@@ -1,35 +1 @@
-// subject-fields.ts — the PURE half of subject assembly: the NodeConfigSubject
-// shape plus the two derived-field resolvers (`scopeForCwd`, `profileNameFor`)
-// that read scope/profile config but NEVER the canvas-db. Split out of
-// subject.ts so CLI consumers (`sys context prompt-review`) can build a subject from an
-// API-fetched node without pulling subject.ts's canvas-db reach (getNode/getRow).
-// The canvas-db assembler (`assembleNodeSubject`, `spineDepth`) stays in
-// subject.ts for broker/daemon-side callers.
-import { projectScopeRoot } from '../scope.js';
-import { loadProfileManifest } from '../profiles/manifest.js';
-import { CrtrError } from '../errors.js';
-/** The scope a cwd resolves into: `project` when scope.ts finds a
- *  nearest-ancestor `.crouter/` at/above it, else `user`. Reuses the existing
- *  resolver (`projectScopeRoot`). */
-export function scopeForCwd(cwd) {
-    return projectScopeRoot(cwd) !== null ? 'project' : 'user';
-}
-/** Resolve `profile_id` to the manifest's mutable `name` for the gate subject.
- *  NEVER throws: a missing/deleted profile resolves to `null` silently (the
- *  ordinary lifecycle of a node whose profile was deleted out from under it);
- *  any OTHER failure (e.g. an unreadable/corrupt manifest slipping past
- *  `loadProfileManifest`'s own tolerance) is logged and still resolves to
- *  `null` rather than throwing — this runs on every gated-doc render. */
-export function profileNameFor(profileId) {
-    if (profileId === undefined || profileId === null || profileId === '')
-        return null;
-    try {
-        return loadProfileManifest(profileId).manifest.name;
-    }
-    catch (err) {
-        if (err instanceof CrtrError && err.code === 'not_found')
-            return null;
-        console.warn(`[subject] profile "${profileId}" failed to resolve for node subject assembly: ${err.message}`);
-        return null;
-    }
-}
+var n=Object.defineProperty;var o=(r,e)=>n(r,"name",{value:e,configurable:!0});import{projectScopeRoot as t}from"../scope.js";import{loadProfileManifest as u}from"../profiles/manifest.js";import{CrtrError as l}from"../errors.js";function i(r){return t(r)!==null?"project":"user"}o(i,"scopeForCwd");function m(r){if(r==null||r==="")return null;try{return u(r).manifest.name}catch(e){return e instanceof l&&e.code==="not_found"||console.warn(`[subject] profile "${r}" failed to resolve for node subject assembly: ${e.message}`),null}}o(m,"profileNameFor");export{m as profileNameFor,i as scopeForCwd};

package/dist/core/substrate/subject.js

@@ -1,47 +1 @@
-// subject.ts — the CANVAS-DB half of subject assembly: `assembleNodeSubject`
-// (reads NodeMeta rows) and `spineDepth` (walks the parent chain). The PURE
-// derived-field resolvers and the NodeConfigSubject shape live in
-// subject-fields.ts (re-exported here); a CLI consumer that must stay off the
-// canvas-db imports those from subject-fields.ts directly. See design-substrate.md
-// §4 + plan-substrate.md §2.
-import { getNode, getRow } from '../canvas/index.js';
-import { scopeForCwd, profileNameFor } from './subject-fields.js';
-export { scopeForCwd, profileNameFor } from './subject-fields.js';
-/** Spine distance from `nodeId` up to its root orchestrator: count the hops
- *  walking the `parent` chain (canvas-db rows) until a row with no parent (the
- *  root). The root is depth 0. Cycle-guarded (parents must not cycle, but never
- *  loop forever) — mirrors `rootOfSpine` in runtime/placement.ts. */
-export function spineDepth(nodeId) {
-    let cur = nodeId;
-    const seen = new Set();
-    let hops = 0;
-    for (;;) {
-        if (seen.has(cur))
-            break;
-        seen.add(cur);
-        const row = getRow(cur);
-        if (row === null || row.parent == null)
-            break;
-        cur = row.parent;
-        hops++;
-    }
-    return hops;
-}
-/** Assemble the node-config subject for `nodeId` from its `NodeMeta` + the
- *  derived fields. Returns `null` when the node has no canvas-db row (an
- *  unknown id). Pure aside from the canvas-db + profile-manifest reads. */
-export function assembleNodeSubject(nodeId) {
-    const meta = getNode(nodeId);
-    if (meta === null)
-        return null;
-    return {
-        kind: meta.kind,
-        mode: meta.mode,
-        lifecycle: meta.lifecycle,
-        hasManager: (meta.parent ?? null) !== null,
-        cwd: meta.cwd,
-        scope: scopeForCwd(meta.cwd),
-        orchestration: { depth: spineDepth(nodeId) },
-        profile: profileNameFor(meta.profile_id),
-    };
-}
+var p=Object.defineProperty;var t=(o,e)=>p(o,"name",{value:e,configurable:!0});import{getNode as c,getRow as i}from"../canvas/index.js";import{scopeForCwd as a,profileNameFor as f}from"./subject-fields.js";import{scopeForCwd as k,profileNameFor as F}from"./subject-fields.js";function s(o){let e=o;const n=new Set;let l=0;for(;!n.has(e);){n.add(e);const r=i(e);if(r===null||r.parent==null)break;e=r.parent,l++}return l}t(s,"spineDepth");function w(o){const e=c(o);return e===null?null:{kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,hasManager:(e.parent??null)!==null,cwd:e.cwd,scope:a(e.cwd),orchestration:{depth:s(o)},profile:f(e.profile_id)}}t(w,"assembleNodeSubject");export{w as assembleNodeSubject,F as profileNameFor,k as scopeForCwd,s as spineDepth};

package/dist/core/substrate/surface-match.js

@@ -1,242 +1 @@
-// surface-match.ts — the per-event matchers for `surfaces` entries, plus the
-// owning-root helpers they anchor on. Pure: every function takes its subject
-// explicitly (the read file, the resolved doc name, the command string) and
-// touches no store discovery.
-//
-// Match semantics (design: surfaces-design.md): constraints within one entry
-// AND together — each present constraint must fit, a `match` list is satisfied
-// by any one glob — and multiple entries per event OR together. The `./`
-// prefix is the one relative spelling: it anchors a glob to the doc's own
-// container (its owning repo dir for `read`, its canonical routing anchor for
-// `memory-read`).
-import { basename, isAbsolute, matchesGlob, relative, sep } from 'node:path';
-import { commandSegments, stripHeredocs } from '../shell-segments.js';
-import { CRTR_DIR_NAME } from '../../types.js';
-import { realpathOrSelf } from '../fs-utils.js';
-import { evalCondition } from '../predicate.js';
-import { surfaceEntryGatePasses } from './gate.js';
-import { rungRank } from './schema.js';
-/** The project directory owning a doc's store: the path segment stack above
- *  the doc's `.crouter` dir. `null` when the doc's path carries no `.crouter`
- *  segment (builtin docs). */
-export function owningRootOf(doc) {
-    const parts = doc.path.split(sep);
-    const idx = parts.lastIndexOf(CRTR_DIR_NAME);
-    if (idx <= 0)
-        return null;
-    return parts.slice(0, idx).join(sep) || sep;
-}
-/** True when the (already-realpathed) file sits beneath the doc's store's
- *  owning directory. Callers additionally guard on `doc.scope === 'project'`:
- *  a profile store's path computes an owning root of `~`, and user/builtin/
- *  node docs likewise have no project-owning dir, so a `./`-anchored glob
- *  outside a project store must never match. */
-export function underOwningRoot(doc, absFile) {
-    const root = owningRootOf(doc);
-    if (root === null)
-        return false;
-    const rel = relative(realpathOrSelf(root), absFile);
-    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
-}
-function safeGlob(target, glob) {
-    try {
-        return matchesGlob(target, glob);
-    }
-    catch {
-        return false;
-    }
-}
-/** One read-event glob vs the read file: plain globs match the absolute path
- *  and the basename; a `./`-anchored glob matches the path relative to the
- *  doc's store's owning repo dir (project-store docs only). */
-function readGlobMatches(glob, doc, absReadFile) {
-    if (glob.startsWith('./')) {
-        if (doc.scope !== 'project' || !underOwningRoot(doc, absReadFile))
-            return false;
-        const root = owningRootOf(doc);
-        if (root === null)
-            return false;
-        return safeGlob(relative(realpathOrSelf(root), absReadFile), glob.slice(2));
-    }
-    return safeGlob(absReadFile, glob) || safeGlob(basename(absReadFile), glob);
-}
-/** Does a `read` entry fit the read file? `absReadFile` must already be
- *  realpathed. `readFrontmatter` is the read file's own parsed YAML (empty
- *  for non-markdown files); an empty record never satisfies
- *  `matchFrontmatter`. */
-export function matchesReadEntry(entry, doc, subject, absReadFile, readFrontmatter) {
-    if (entry.on !== 'read' || !surfaceEntryGatePasses(entry, subject))
-        return false;
-    if (entry.match !== undefined && !entry.match.some((g) => readGlobMatches(g, doc, absReadFile))) {
-        return false;
-    }
-    if (entry.matchFrontmatter !== undefined) {
-        if (Object.keys(readFrontmatter).length === 0)
-            return false;
-        if (!evalCondition(entry.matchFrontmatter, readFrontmatter))
-            return false;
-    }
-    return entry.match !== undefined || entry.matchFrontmatter !== undefined;
-}
-/** One memory-read glob vs the resolved doc's exact canonical name: plain
- *  globs match that name only — no mount-stripped or other alias, per the
- *  hard-cut canonical-only routing contract; a `./`-anchored glob matches
- *  the name relative to the CARRIER's routing anchor — its own canonical
- *  name when the carrier fronts a directory, its canonical parent when it is
- *  an ordinary leaf. Names are slash-separated, so path globbing applies
- *  segment-wise. */
-function memoryReadGlobMatches(glob, routingAnchor, name) {
-    if (glob.startsWith('./')) {
-        const stripped = glob.slice(2);
-        if (routingAnchor === '')
-            return safeGlob(name, stripped);
-        if (!name.startsWith(routingAnchor + '/'))
-            return false;
-        return safeGlob(name.slice(routingAnchor.length + 1), stripped);
-    }
-    return safeGlob(name, glob);
-}
-/** Does a `memory-read` entry on a carrier anchored at `routingAnchor` fit a
- *  resolved read of the doc known by its exact canonical `name`? */
-export function matchesMemoryReadEntry(entry, routingAnchor, subject, name) {
-    if (entry.on !== 'memory-read' || entry.match === undefined || !surfaceEntryGatePasses(entry, subject))
-        return false;
-    return entry.match.some((g) => memoryReadGlobMatches(g, routingAnchor, name));
-}
-function commandGlobPattern(glob) {
-    const words = glob.trim().split(/\s+/);
-    if (words.length === 1 && words[0] === '')
-        return null;
-    const pattern = [];
-    for (const word of words) {
-        const parts = word.split('*');
-        for (let i = 0; i < parts.length; i += 1) {
-            if (parts[i] !== '')
-                pattern.push({ kind: 'literal', text: parts[i] });
-            if (i < parts.length - 1)
-                pattern.push({ kind: 'any' });
-        }
-    }
-    return pattern;
-}
-function tokenMatches(pattern, token) {
-    const rx = pattern
-        .split('')
-        .map((ch) => (ch === '?' ? '[\\s\\S]' : ch.replace(/[.+^${}()|[\]\\]/g, '\\$&')))
-        .join('');
-    return new RegExp(`^${rx}$`).test(token);
-}
-function segmentMatches(pattern, tokens) {
-    const memo = new Map();
-    const match = (patternIndex, tokenIndex) => {
-        const key = `${patternIndex}:${tokenIndex}`;
-        const cached = memo.get(key);
-        if (cached !== undefined)
-            return cached;
-        let result;
-        if (patternIndex === pattern.length) {
-            result = tokenIndex === tokens.length;
-        }
-        else if (pattern[patternIndex].kind === 'any') {
-            result = match(patternIndex + 1, tokenIndex) || (tokenIndex < tokens.length && match(patternIndex, tokenIndex + 1));
-        }
-        else {
-            const token = tokens[tokenIndex];
-            result = token !== undefined && !token.opaque && tokenMatches(pattern[patternIndex].text, token.text) && match(patternIndex + 1, tokenIndex + 1);
-        }
-        memo.set(key, result);
-        return result;
-    };
-    return match(0, 0);
-}
-function commandGlobMatches(glob, command) {
-    const pattern = commandGlobPattern(glob);
-    if (pattern === null)
-        return false;
-    return commandSegments(command)
-        .filter(({ tokens }) => tokens.length > 0)
-        .some(({ tokens }) => segmentMatches(pattern, tokens));
-}
-/** Does a `command` entry's parsed command pattern fit, without evaluating its
- * node-config gate? Callers use this only to determine whether resolving a
- * subject could be necessary; delivery must still use `matchesCommandEntry`. */
-export function commandEntryMatches(entry, command) {
-    return entry.on === 'command' && entry.match !== undefined && entry.match.some((g) => commandGlobMatches(g, command));
-}
-/** Does a `command` entry fit the executed command string? */
-export function matchesCommandEntry(entry, subject, command) {
-    return commandEntryMatches(entry, command) && surfaceEntryGatePasses(entry, subject);
-}
-/** Does a `pre-command` entry's parsed command pattern fit, without evaluating
- * its node-config gate? Callers use this only to determine whether resolving a
- * subject could be necessary; delivery must still use `matchesPreCommandEntry`. */
-export function preCommandEntryMatches(entry, command) {
-    if (entry.on !== 'pre-command' || entry.match === undefined)
-        return false;
-    return entry.match.some((g) => commandGlobMatches(g, stripHeredocs(command)));
-}
-/** Does a `pre-command` entry fit a command that is ABOUT to run? The same
- * glob machinery `command` uses — one matcher, one semantics — applied to the
- * command with its heredoc bodies stripped. Subshell parentheses, backticks,
- * and path-prefixed binaries stay unhandled: this is a guardrail against the
- * faithful-but-uninformed action, not an enforcement boundary. */
-export function matchesPreCommandEntry(entry, subject, command) {
-    return preCommandEntryMatches(entry, command) && surfaceEntryGatePasses(entry, subject);
-}
-/** Does ONE entry of `event` fit this occurrence — constraints and the entry's
- *  own gate together? */
-export function surfaceEntryParticipates(entry, doc, subject, event, payload) {
-    if (entry.on !== event)
-        return false;
-    switch (event) {
-        // Presence of the entry is the match; callers scope the corpus.
-        case 'boot':
-        case 'workspace-open':
-            return surfaceEntryGatePasses(entry, subject);
-        case 'read':
-            if (payload.absoluteFile === undefined || doc.path === undefined || doc.scope === undefined)
-                return false;
-            return matchesReadEntry(entry, { path: doc.path, scope: doc.scope }, subject, payload.absoluteFile, payload.readFrontmatter ?? {});
-        case 'memory-read':
-            if (payload.resolvedCanonicalName === undefined)
-                return false;
-            return matchesMemoryReadEntry(entry, payload.routingAnchor ?? '', subject, payload.resolvedCanonicalName);
-        case 'command':
-            return payload.command !== undefined && matchesCommandEntry(entry, subject, payload.command);
-        case 'pre-command':
-            return payload.command !== undefined && matchesPreCommandEntry(entry, subject, payload.command);
-    }
-}
-/** The entry that decides this doc's delivery for one event occurrence: the
- *  highest-rung participating entry, or null when none participates. */
-export function matchingSurfaceEntry(doc, subject, event, payload) {
-    let best = null;
-    for (const entry of doc.surfaces) {
-        if (!surfaceEntryParticipates(entry, doc, subject, event, payload))
-            continue;
-        if (best === null || rungRank(entry.at) > rungRank(best.at))
-            best = entry;
-    }
-    return best;
-}
-/** The doc's delivery rung for a read of `absReadFile` (already realpathed). */
-export function readDeliveryRung(doc, subject, absReadFile, readFrontmatter) {
-    return matchingSurfaceEntry(doc, subject, 'read', { absoluteFile: absReadFile, readFrontmatter })?.at ?? 'none';
-}
-/** The doc's workspace-open rung. */
-export function workspaceOpenRung(doc, subject) {
-    return matchingSurfaceEntry(doc, subject, 'workspace-open', {})?.at ?? 'none';
-}
-/** The doc's delivery rung for a `crtr memory read` that resolved a doc known
- *  by its exact canonical `name` — no mount-stripped or other alias. */
-export function memoryReadDeliveryRung(doc, routingAnchor, subject, name) {
-    return matchingSurfaceEntry(doc, subject, 'memory-read', { routingAnchor, resolvedCanonicalName: name })?.at ?? 'none';
-}
-/** The doc's delivery rung for an executed command string. */
-export function commandDeliveryRung(doc, subject, command) {
-    return matchingSurfaceEntry(doc, subject, 'command', { command })?.at ?? 'none';
-}
-/** The doc's delivery rung for a command about to run. */
-export function preCommandDeliveryRung(doc, subject, command) {
-    return matchingSurfaceEntry(doc, subject, 'pre-command', { command })?.at ?? 'none';
-}
+var x=Object.defineProperty;var i=(e,t)=>x(e,"name",{value:t,configurable:!0});import{basename as M,isAbsolute as C,matchesGlob as v,relative as p,sep as l}from"node:path";import{commandSegments as G,stripHeredocs as O}from"../shell-segments.js";import{CRTR_DIR_NAME as $}from"../../types.js";import{realpathOrSelf as g}from"../fs-utils.js";import{evalCondition as D}from"../predicate.js";import{surfaceEntryGatePasses as c}from"./gate.js";import{rungRank as R}from"./schema.js";function E(e){const t=e.path.split(l),n=t.lastIndexOf($);return n<=0?null:t.slice(0,n).join(l)||l}i(E,"owningRootOf");function N(e,t){const n=E(e);if(n===null)return!1;const r=p(g(n),t);return r!==""&&!r.startsWith("..")&&!C(r)}i(N,"underOwningRoot");function a(e,t){try{return v(e,t)}catch{return!1}}i(a,"safeGlob");function P(e,t,n){if(e.startsWith("./")){if(t.scope!=="project"||!N(t,n))return!1;const r=E(t);return r===null?!1:a(p(g(r),n),e.slice(2))}return a(n,e)||a(M(n),e)}i(P,"readGlobMatches");function S(e,t,n,r,o){return e.on!=="read"||!c(e,n)||e.match!==void 0&&!e.match.some(s=>P(s,t,r))||e.matchFrontmatter!==void 0&&(Object.keys(o).length===0||!D(e.matchFrontmatter,o))?!1:e.match!==void 0||e.matchFrontmatter!==void 0}i(S,"matchesReadEntry");function W(e,t,n){if(e.startsWith("./")){const r=e.slice(2);return t===""?a(n,r):n.startsWith(t+"/")?a(n.slice(t.length+1),r):!1}return a(n,e)}i(W,"memoryReadGlobMatches");function k(e,t,n,r){return e.on!=="memory-read"||e.match===void 0||!c(e,n)?!1:e.match.some(o=>W(o,t,r))}i(k,"matchesMemoryReadEntry");function F(e){const t=e.trim().split(/\s+/);if(t.length===1&&t[0]==="")return null;const n=[];for(const r of t){const o=r.split("*");for(let s=0;s<o.length;s+=1)o[s]!==""&&n.push({kind:"literal",text:o[s]}),s<o.length-1&&n.push({kind:"any"})}return n}i(F,"commandGlobPattern");function b(e,t){const n=e.split("").map(r=>r==="?"?"[\\s\\S]":r.replace(/[.+^${}()|[\]\\]/g,"\\$&")).join("");return new RegExp(`^${n}$`).test(t)}i(b,"tokenMatches");function _(e,t){const n=new Map,r=i((o,s)=>{const h=`${o}:${s}`,d=n.get(h);if(d!==void 0)return d;let u;if(o===e.length)u=s===t.length;else if(e[o].kind==="any")u=r(o+1,s)||s<t.length&&r(o,s+1);else{const m=t[s];u=m!==void 0&&!m.opaque&&b(e[o].text,m.text)&&r(o+1,s+1)}return n.set(h,u),u},"match");return r(0,0)}i(_,"segmentMatches");function w(e,t){const n=F(e);return n===null?!1:G(t).filter(({tokens:r})=>r.length>0).some(({tokens:r})=>_(n,r))}i(w,"commandGlobMatches");function q(e,t){return e.on==="command"&&e.match!==void 0&&e.match.some(n=>w(n,t))}i(q,"commandEntryMatches");function A(e,t,n){return q(e,n)&&c(e,t)}i(A,"matchesCommandEntry");function H(e,t){return e.on!=="pre-command"||e.match===void 0?!1:e.match.some(n=>w(n,O(t)))}i(H,"preCommandEntryMatches");function T(e,t,n){return H(e,n)&&c(e,t)}i(T,"matchesPreCommandEntry");function j(e,t,n,r,o){if(e.on!==r)return!1;switch(r){case"boot":case"workspace-open":return c(e,n);case"read":return o.absoluteFile===void 0||t.path===void 0||t.scope===void 0?!1:S(e,{path:t.path,scope:t.scope},n,o.absoluteFile,o.readFrontmatter??{});case"memory-read":return o.resolvedCanonicalName===void 0?!1:k(e,o.routingAnchor??"",n,o.resolvedCanonicalName);case"command":return o.command!==void 0&&A(e,n,o.command);case"pre-command":return o.command!==void 0&&T(e,n,o.command)}}i(j,"surfaceEntryParticipates");function f(e,t,n,r){let o=null;for(const s of e.surfaces)j(s,e,t,n,r)&&(o===null||R(s.at)>R(o.at))&&(o=s);return o}i(f,"matchingSurfaceEntry");function X(e,t,n,r){return f(e,t,"read",{absoluteFile:n,readFrontmatter:r})?.at??"none"}i(X,"readDeliveryRung");function Y(e,t){return f(e,t,"workspace-open",{})?.at??"none"}i(Y,"workspaceOpenRung");function Z(e,t,n,r){return f(e,n,"memory-read",{routingAnchor:t,resolvedCanonicalName:r})?.at??"none"}i(Z,"memoryReadDeliveryRung");function y(e,t,n){return f(e,t,"command",{command:n})?.at??"none"}i(y,"commandDeliveryRung");function I(e,t,n){return f(e,t,"pre-command",{command:n})?.at??"none"}i(I,"preCommandDeliveryRung");export{y as commandDeliveryRung,q as commandEntryMatches,A as matchesCommandEntry,k as matchesMemoryReadEntry,T as matchesPreCommandEntry,S as matchesReadEntry,f as matchingSurfaceEntry,Z as memoryReadDeliveryRung,E as owningRootOf,I as preCommandDeliveryRung,H as preCommandEntryMatches,X as readDeliveryRung,j as surfaceEntryParticipates,N as underOwningRoot,Y as workspaceOpenRung};