@davidorex/pi-context 0.26.0 → 0.28.0

package/dist/context-registry.js

@@ -0,0 +1,189 @@
+/**
+ * context-registry — project-root substrate registry read / write surface for
+ * `<cwd>/.pi-context-registry.json`.
+ *
+ * The registry is a PROJECT-ROOT file (tracked in git, like `.pi-context.json`),
+ * NOT substrate-relative: it enumerates EVERY known substrate by its immutable
+ * content-addressed `substrate_id` (`^sub-[0-9a-f]{16}$`), mapping each to its
+ * on-disk directory + alias list. This is the substrate-locator layer the
+ * Cycle-8 F2 resolver consumes to resolve a foreign `<substrate_id>:<oid>` /
+ * `<alias>:<refname>` locator to a directory, and the surface the Phase-H
+ * migration registers each legacy substrate into.
+ *
+ * Distinct from the `.pi-context.json` bootstrap pointer: the pointer names the
+ * single ACTIVE substrate dir; this registry enumerates all of them. The
+ * SoT-drift invariant in `validateContext` (context-sdk.ts) requires the active
+ * `config.substrate_id` to have an entry here whose `dir` resolves to the active
+ * substrate.
+ *
+ * Mirrors `migrations-store.ts` atomic discipline one-for-one:
+ *   - `loadRegistry` reads + JSON-parses + AJV-validates via `validateFromFile`
+ *     against the bundled `context-registry.schema.json`; returns null when the
+ *     file is absent (a pre-write project with no registry is a normal state,
+ *     NOT an error).
+ *   - `writeRegistry` delegates whole-file writes to block-api's atomic
+ *     `writeTypedFile` (tmp + rename + schema-validate), so a failed write
+ *     leaves the prior file byte-identical and a malformed registry never lands.
+ *   - `registerSubstrate` wraps a load-or-empty → JSON deep-clone → upsert →
+ *     write pattern (idempotent: re-registering the same substrate_id with the
+ *     same dir is a no-op rewrite; a changed dir/aliases overwrites the entry).
+ *
+ * A small per-cwd cache (keyed by absolute cwd, invalidated on mtime change and
+ * proactively on write) mirrors the migrations-store cache so read-after-write
+ * within a process is consistent without restart.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeTypedFile } from "./block-api.js";
+import { validateFromFile } from "./schema-validator.js";
+/**
+ * Resolve the bundled context-registry schema file. Mirrors
+ * `bundledMigrationsSchemaPath` in migrations-store.ts — schemas live one
+ * directory up from both `src/` (under tsx --test) and `dist/` (after tsc).
+ */
+function bundledRegistrySchemaPath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "schemas", "context-registry.schema.json");
+}
+/**
+ * Project-root path of the substrate registry. PROJECT-ROOT, not substrate-dir-
+ * relative (contrast `migrationsPath`, which resolves through the active
+ * substrate dir). The registry enumerates substrates above any single
+ * substrate, so it must live at a fixed root location independent of which
+ * substrate the bootstrap pointer currently names.
+ */
+export function contextRegistryPath(cwd) {
+    return path.join(cwd, ".pi-context-registry.json");
+}
+/**
+ * Current `version` emitted into newly-created `.pi-context-registry.json`
+ * files. Tracks the `version` field of context-registry.schema.json itself.
+ */
+export const REGISTRY_FILE_VERSION = "1.0.0";
+const registryCache = new Map();
+/**
+ * Drop the cached registry for `cwd` so the next `loadRegistry(cwd)` re-reads
+ * from disk. Called internally by `writeRegistry`; exported for callers that
+ * mutate the file out-of-band (e.g. tests / the orchestrator seed).
+ */
+export function invalidateRegistry(cwd) {
+    registryCache.delete(path.resolve(cwd));
+}
+/**
+ * Load + AJV-validate the project-root registry. Returns null when the file is
+ * absent (a project with no registry yet — a normal pre-write condition, NOT an
+ * error). Throws on read / parse / schema failure. Caches by absolute cwd keyed
+ * on file mtime.
+ */
+export function loadRegistry(cwd) {
+    const p = contextRegistryPath(cwd);
+    if (!fs.existsSync(p))
+        return null;
+    const mtime = fs.statSync(p).mtimeMs;
+    const key = path.resolve(cwd);
+    const cached = registryCache.get(key);
+    if (cached && cached.mtimeMs === mtime) {
+        return cached.file;
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(p, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`loadRegistry: failed to read ${p}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`loadRegistry: invalid JSON in ${p}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    validateFromFile(bundledRegistrySchemaPath(), data, `.pi-context-registry.json (${p})`);
+    const file = data;
+    registryCache.set(key, { file, mtimeMs: mtime });
+    return file;
+}
+/**
+ * Atomic, AJV-validated whole-file write of `.pi-context-registry.json`.
+ * Delegates to block-api's `writeTypedFile` against the bundled registry schema
+ * (tmp + rename; a failed write leaves the prior file byte-identical). `ctx` is
+ * accepted for call-site parity with the rest of the substrate write surface;
+ * the registry schema declares no envelope author fields so stamping is a
+ * structural no-op today. Invalidates the per-cwd cache after the write so the
+ * next `loadRegistry(cwd)` reads the fresh file.
+ */
+export function writeRegistry(cwd, file, ctx) {
+    writeTypedFile(contextRegistryPath(cwd), bundledRegistrySchemaPath(), file, ctx, ".pi-context-registry.json");
+    invalidateRegistry(cwd);
+}
+/**
+ * Compose an initial empty registry shape — used by `registerSubstrate` when no
+ * registry exists on disk. Centralised so the `version` token is sourced from
+ * one place.
+ */
+function emptyRegistry() {
+    return { version: REGISTRY_FILE_VERSION, substrates: {} };
+}
+/**
+ * Deep-clone via JSON round-trip. Sufficient for RegistryFile shapes (no Date /
+ * Map / undefined values per the schema). Matches the migrations-store
+ * load-clone-mutate-write precedent.
+ */
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+/**
+ * Upsert a substrate's registry entry. Load-or-empty → clone → set
+ * `substrates[substrate_id] = { dir, aliases }` → atomic write. Idempotent:
+ * re-registering the same substrate_id with the same dir + aliases produces a
+ * byte-identical file; a changed dir (e.g. a renamed substrate directory) or a
+ * changed alias list overwrites the prior entry in place. `aliases` defaults to
+ * `[]` when omitted (Cycle 4 registers with empty aliases; the Phase-H
+ * migration populates the legacy `project:` alias).
+ *
+ * Does NOT validate that `substrate_id` matches `^sub-[0-9a-f]{16}$` here — the
+ * schema's `propertyNames` pattern enforces that at the write boundary (an
+ * out-of-shape key fails `writeTypedFile`'s AJV validation, leaving the prior
+ * file intact).
+ */
+export function registerSubstrate(cwd, substrate_id, dir, aliases = [], ctx) {
+    const current = loadRegistry(cwd) ?? emptyRegistry();
+    const next = clone(current);
+    next.substrates[substrate_id] = { dir, aliases };
+    writeRegistry(cwd, next, ctx);
+}
+/**
+ * Resolve a substrate_id to its registered directory string (as stored — i.e.
+ * project-root-relative, the caller resolves against cwd when an absolute path
+ * is needed). Returns null on miss (substrate_id not registered, or no registry
+ * file at all) — never throws on a clean miss, mirroring the F2 resolver's
+ * expectation of a null-or-hit lookup.
+ */
+export function resolveSubstrateDir(cwd, substrate_id) {
+    const reg = loadRegistry(cwd);
+    if (reg === null)
+        return null;
+    const entry = reg.substrates[substrate_id];
+    return entry ? entry.dir : null;
+}
+/**
+ * Resolve an alias to the substrate_id that declares it. Scans every entry's
+ * `aliases[]` for an exact string match and returns the owning substrate_id.
+ * Returns null on miss (alias unregistered, or no registry file) — never throws
+ * on a clean miss. First-match wins if (by misconfiguration) two substrates
+ * claim the same alias; the registry does not enforce alias uniqueness this
+ * cycle.
+ */
+export function resolveAlias(cwd, alias) {
+    const reg = loadRegistry(cwd);
+    if (reg === null)
+        return null;
+    for (const [substrate_id, entry] of Object.entries(reg.substrates)) {
+        if (entry.aliases.includes(alias))
+            return substrate_id;
+    }
+    return null;
+}
+//# sourceMappingURL=context-registry.js.map

package/dist/context-registry.js.map

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

package/dist/context-sdk.d.ts

@@ -3,8 +3,9 @@
  * and derived metrics. Computes everything dynamically from filesystem
  * and git — no cache, no stale data.
  */
-import { type ConfigBlock } from "./context.js";
-export { type BlockKindDecl, type CompositionMember, type ConfigBlock, type ContextData, type CurationSuggestion, displayName, type Edge, edgesForLens, groupByLens, type HierarchyDecl, type InvariantDecl, type ItemRecord, type LayerDecl, type LensSpec, listUncategorized, loadConfig, loadContext, loadRelations, type RelationTypeDecl, type StatusBucket, type SubstrateValidationIssue, type SubstrateValidationResult, synthesizeFromField, validateRelations, walkDescendants, } from "./context.js";
+import { type ConfigBlock, type Edge, type EdgeEndpoint, type RawEndpoint } from "./context.js";
+import type { DispatchContext } from "./dispatch-context.js";
+export { type BlockKindDecl, type CompositionMember, type ConfigBlock, type ContextData, type CurationSuggestion, displayName, type Edge, type EdgeEndpoint, edgesForLens, endpointBin, endpointIdentity, endpointKey, groupByLens, type HierarchyDecl, type InvariantDecl, type ItemRecord, type LayerDecl, type LensSpec, listUncategorized, loadConfig, loadContext, loadRelations, type NormalizedEndpoint, normalizeEndpoint, type RawEndpoint, type RelationTypeDecl, type StatusBucket, type SubstrateValidationIssue, type SubstrateValidationResult, synthesizeFromField, validateRelations, walkDescendants, } from "./context.js";
 export interface BlockInfo {
     name: string;
     hasSchema: boolean;
@@ -246,15 +247,20 @@ export interface BlockPage {
 /**
  * Read a single item from ONE named block by its id, or null if absent.
  * Block-scoped (no cross-substrate idIndex, no prefix-vs-block invariant — that is resolveItemById).
- * Reuses filterBlockItems(id eq) so it inherits readBlock + discoverArrayKey + edge semantics
- * (missing block / multiple top-level arrays THROW; no-array block or id-not-found → null). FGAP-045.
+ * Reads the block then routes id-resolution through the shared addressInto primitive
+ * (id matches `.id` or `.canonical_id`), so block-item lookup uses the same element
+ * addressing as every other read surface. Missing block / multiple top-level arrays
+ * THROW (readBlock + discoverArrayKey via addressInto); no-array block or id-not-found → null. FGAP-045.
  */
 export declare function readBlockItem(cwd: string, blockName: string, id: string): unknown | null;
 /**
- * Paginate a block's items. Reuses readBlock + discoverArrayKey. Returns the FULL count as `total`
- * (not the page length) and `hasMore = offset + limit < total`. No-array block → {items:[],total:0,
- * hasMore:false}; offset ≥ total → empty items with correct total. Missing block / multiple top-level
- * arrays propagate the throw (consistent with filterBlockItems). FGAP-045.
+ * Paginate a block's items. Reads the block, discovers its single top-level array,
+ * then routes the slice/total/hasMore math through the shared `pageArray` primitive
+ * (ONE pagination implementation — serializeForRead uses the same). Returns the FULL
+ * count as `total` (not the page length) and `hasMore = offset + limit < total`.
+ * No-array block → {items:[],total:0,hasMore:false}; offset ≥ total → empty items
+ * with correct total. Missing block / multiple top-level arrays propagate the throw
+ * (consistent with filterBlockItems). FGAP-045.
  */
 export declare function readBlockPage(cwd: string, blockName: string, opts?: {
     offset?: number;
@@ -276,9 +282,11 @@ export interface JoinResult {
 /**
  * Cross-block join (FGAP-043, HYBRID). Mode = exactly one of relationType (edge) XOR
  * leftField+rightField (field). Returns one JoinResult per left item (after leftPredicate),
- * right always an array. Edge mode is DEC-0013-native (relations.json); field mode joins on a
- * shared field value (legacy inline-FK + arbitrary shared fields). Reuses filterBlockItems /
- * readBlock / discoverArrayKey / loadRelations / buildIdIndex.
+ * right always an array. Edge mode is DEC-0013-native (relations.json); field mode is a
+ * DEPRECATED backward-compat path that joins on a shared field value (formerly inline-FK,
+ * now arbitrary shared fields). NO validation uses field mode — cross-block validation is
+ * edge-only since DEC-0036; field mode here is a query convenience, not a reference surface.
+ * Reuses filterBlockItems / readBlock / discoverArrayKey / loadRelations / buildIdIndex.
  */
 export declare function joinBlocks(cwd: string, spec: JoinSpec): JoinResult[];
 /**
@@ -288,10 +296,49 @@ export declare function joinBlocks(cwd: string, spec: JoinSpec): JoinResult[];
  * (e.g., a per-item macro inlining a related decision by ID).
  */
 export interface ItemLocation {
+    /**
+     * The item's refname — its top-level string `id`. Exposed on the locator so
+     * iteration over a {@link SubstrateIndex.items} list can recover the key
+     * without re-deriving it from `item.id` (the value is identical: `id` is set
+     * to `item.id` at index-build time). Lookup maps (`byRefname`) key on this
+     * same value.
+     */
+    id: string;
     block: string;
     arrayKey: string;
     item: Record<string, unknown>;
 }
+/**
+ * Split-surface index over a single substrate's id-bearing items (Cycle 7 /
+ * Phase F1). Replaces the prior `Map<refname, ItemLocation>` return of
+ * {@link buildIdIndex}/{@link buildIdIndexForDir} by separating the two roles
+ * that the single Map previously served:
+ *
+ *   - `byRefname` — point-lookup map keyed by refname (`item.id`). First-writer-
+ *     wins on refname collision across blocks (one entry per distinct refname),
+ *     exactly as the prior Map. This is the lookup surface every `.get`/`.has`
+ *     consumer reads.
+ *   - `items` — the iteration surface: ONE entry per id-bearing item, in scan
+ *     order. Whole-index `for…of` consumers iterate this so a future dual-keyed
+ *     lookup map (F2's oid keys) cannot inflate iteration (anti-double-count).
+ *   - `byOid` — point-lookup map keyed by an item's string `oid`, ONE entry per
+ *     item that HAS a string `oid`. Populated here but DORMANT this cycle —
+ *     no F1 consumer reads it; it is the seam Cycle-8/F2 fills with cross-
+ *     substrate (oid-keyed) resolution. Near-empty on current real data (most
+ *     items are unstamped). First-writer-wins on oid collision, mirroring
+ *     `byRefname`'s collision discipline.
+ *
+ * `dir` is the scanned substrate directory; `substrate_id` is `config.substrate_id`
+ * when the config declares one (undefined otherwise — absence does NOT throw,
+ * so a pre-identity substrate still indexes cleanly).
+ */
+export interface SubstrateIndex {
+    substrate_id?: string;
+    dir: string;
+    byRefname: Map<string, ItemLocation>;
+    byOid: Map<string, ItemLocation>;
+    items: ItemLocation[];
+}
 /**
  * Look up the block expected to host an ID based on its prefix, driven by
  * the config registry.
@@ -332,7 +379,21 @@ export declare function expectedBlockForId(id: string, cfg: ConfigBlock | null):
  * (no overwrite) — duplicate entries are intentionally ignored to keep
  * the resolver deterministic without allocating warning channels here.
  */
-export declare function buildIdIndex(cwd: string): Map<string, ItemLocation>;
+export declare function buildIdIndex(cwd: string): SubstrateIndex;
+/**
+ * Build the item-id → location index for an ARBITRARY substrate directory
+ * (the dir-targeted twin of `buildIdIndex`, which resolves the active pointer
+ * dir). Used by the relation porcelain to index a FOREIGN substrate (resolved
+ * via the registry from a `<alias>:` selector) as well as the active substrate.
+ *
+ * `substrateDir` is the absolute substrate directory to scan; `cfg` is that
+ * dir's config (drives the prefix-vs-block invariant via `expectedBlockForId`),
+ * passed by the caller so this function performs no pointer resolution. Reads
+ * each block file via `readBlockForDir` so the version-aware validation hook
+ * fires identically to the active-dir path. Same first-writer-wins collision
+ * semantics + prefix-invariant throw as `buildIdIndex`.
+ */
+export declare function buildIdIndexForDir(substrateDir: string, _cwd: string, cfg: ConfigBlock | null): SubstrateIndex;
 /**
  * One-off lookup — builds the full index then performs a single get.
  * Callers performing multiple lookups in one render pass should call
@@ -371,6 +432,112 @@ export declare function resolveItemById(cwd: string, id: string): ItemLocation |
  * Closes part of the FGAP-026 phase 2 query-surface gap (TASK-035).
  */
 export declare function resolveItemsByIds(cwd: string, ids: string[]): Map<string, ItemLocation | null>;
+/**
+ * Resolve one friendly relation selector to a structured `EdgeEndpoint`:
+ *  - `<alias>:<refname>` (alias is a registered substrate alias) → FOREIGN item
+ *    `{kind:"item", substrate_id, oid, refname}` (oid from the foreign index;
+ *    when the foreign refname does not resolve, oid is left as the refname so the
+ *    endpoint round-trips — Cycle 8 resolves foreign endpoints, this cycle only
+ *    forms them; an unresolved foreign endpoint validates as a sentinel).
+ *  - a selector matching a declared lens bin → `{kind:"lens_bin", bin}`.
+ *  - a bare `refname` → SAME-substrate item `{kind:"item", oid, refname}` (oid
+ *    from the active index; falls back to refname when unresolved so an
+ *    edge to a not-yet-filed item is still expressible).
+ *
+ * NOTE: the `<alias>:` branch is tried first so an alias-prefixed selector is
+ * never misread as a bare refname containing a colon.
+ */
+export declare function resolveRelationSelector(cwd: string, selector: string): EdgeEndpoint;
+/**
+ * Friendly-selector relation append (Cycle 5 porcelain). Resolves `parent` /
+ * `child` STRING selectors to structured `EdgeEndpoint`s via
+ * `resolveRelationSelector`, then delegates to the raw `appendRelation` plumbing
+ * (atomic, AJV-validated, exact-duplicate no-op — same deferred-integrity
+ * semantics). Keeps the string param surface its callers (the append-relation
+ * Pi tool + the orchestrator CLI) already expose.
+ *
+ * Returns `{ appended, edge }` where `edge` is the RESOLVED structured edge
+ * actually written (so callers can report / dry-run-validate the structured
+ * form).
+ */
+export declare function appendRelationByRef(cwd: string, rel: {
+    parent: string;
+    child: string;
+    relation_type: string;
+    ordinal?: number;
+}, ctx?: DispatchContext): {
+    appended: boolean;
+    edge: Edge;
+};
+/**
+ * Classification of an endpoint by {@link resolveRef}:
+ *  - `active`       — an item resolved in the ACTIVE substrate index (the
+ *                     same-substrate refname/oid path, byte-identical pass to today).
+ *  - `foreign`      — an item resolved in a REGISTERED foreign substrate's index
+ *                     (via a structured `substrate_id` locator or a legacy
+ *                     `<alias>:<refname>` string whose alias is registered).
+ *  - `dangling`     — a located endpoint (active or foreign) whose key was NOT
+ *                     found in the relevant index (the "does not resolve" outcome),
+ *                     OR a foreign substrate whose index build threw (degraded to
+ *                     dangling rather than crashing validation).
+ *  - `unregistered` — a locator naming a substrate_id / alias that the project-root
+ *                     registry does NOT carry (the foreign substrate is not yet
+ *                     registered — the pre-Phase-H state of the 30 `project:` strings).
+ */
+export type ResolveStatus = "active" | "foreign" | "dangling" | "unregistered";
+/**
+ * The result of {@link resolveRef}. `endpointKind` discriminates item endpoints
+ * (the resolution surface) from lens_bin endpoints (always `active`, never an
+ * item lookup). `loc` is the resolved {@link ItemLocation} for `active`/`foreign`
+ * item endpoints (absent for `dangling`/`unregistered`/lens_bin). `substrate_id`
+ * is the resolved foreign substrate_id when known (structured locator, or an
+ * alias that resolved); `oid`/`refname` carry the parsed/structured lookup keys.
+ */
+export interface ResolvedRef {
+    status: ResolveStatus;
+    endpointKind: "item" | "lens_bin";
+    substrate_id?: string;
+    oid?: string;
+    refname?: string;
+    loc?: ItemLocation;
+}
+/**
+ * Classify a single edge endpoint (legacy string OR structured) into one of the
+ * four {@link ResolveStatus} values — the load-bearing F2 resolver wired into
+ * `validateContext`'s edge loop + the `validateRelations` `resolve?` hook.
+ *
+ * Algorithm (the locked Cycle-8 design):
+ *  1. A structured `{kind:"lens_bin"}` endpoint → `{status:"active",
+ *     endpointKind:"lens_bin"}` with NO item lookup (a lens_bin never routes
+ *     through item resolution — the corruption-risk surface, Constraint 4).
+ *  2. An item endpoint WITH A LOCATOR — a structured `substrate_id`, OR a STRING
+ *     of the form `<alias>:<refname>` whose `<alias>` prefix is a REGISTERED
+ *     alias — resolves against the named FOREIGN substrate: substrate_id/alias
+ *     NOT in the registry → `unregistered`; registered → build (cached) the
+ *     foreign index → look up by `oid` (structured locator carrying an oid) else
+ *     by `refname` in `byOid`/`byRefname` → found `foreign` / absent `dangling`.
+ *     A foreign-index build that throws → `dangling` (never a crash).
+ *  3. An item endpoint with NO locator — a bare oid or a bare refname (a string
+ *     with no `:` alias-prefix) — resolves against the ACTIVE index ONLY → found
+ *     `active` / absent `dangling`.
+ *
+ * The alias-string parse is ATTEMPTED FIRST on any string containing a `:`
+ * (mirroring `resolveRelationSelector`): the `<x>` in `<x>:<y>` is treated as an
+ * alias candidate, so such a string is an aliased-item locator (step 2), NOT a
+ * bare refname (step 3). If `<x>` is NOT a registered alias → `unregistered`. So
+ * today's `project:FGAP-153` (the `project` alias is not registered until Phase H)
+ * → `unregistered`. The real 30 are therefore `unregistered` pre-H and flip to
+ * `foreign` once Phase H registers the `project` alias (the count/total stay
+ * unchanged at reclassification — see the note in `validateContext`).
+ *
+ * `opts.activeIndex` lets the caller pass a pre-built active index (built once per
+ * validation pass); `opts.foreignCache` memoizes foreign indices per substrate_id
+ * within the pass (so N edges into one foreign substrate build its index ONCE).
+ */
+export declare function resolveRef(cwd: string, ref: RawEndpoint, opts?: {
+    activeIndex?: SubstrateIndex;
+    foreignCache?: Map<string, SubstrateIndex>;
+}): ResolvedRef;
 export interface ContextValidationIssue {
     severity: "error" | "warning";
     message: string;

package/dist/context-sdk.d.ts.map

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