@haibun/core 4.0.0-alpha.2 → 4.0.0-alpha.3

package/build/lib/fixme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixme.d.ts","sourceRoot":"","sources":["../../src/lib/fixme.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC"}
+{"version":3,"file":"fixme.d.ts","sourceRoot":"","sources":["../../src/lib/fixme.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC"}

package/build/lib/host-id.d.ts

@@ -0,0 +1,44 @@
+/**
+ * hostId — a stable non-negative integer identifying the haibun instance
+ * within a deployment. Prepended to every seqPath root so observations from
+ * different hosts cannot collide even when running identical features.
+ *
+ * Single-host deployments keep hostId = 0 (the default) and see no change.
+ * Multi-host deployments set HAIBUN_HOST_ID per instance; assigning ids is
+ * an operator concern (config, supervisor, orchestration).
+ *
+ * Aligns with OpenTelemetry's `service.instance.id` convention — a haibun
+ * instance is a service instance.
+ */
+export declare const HAIBUN_HOST_ID_ENV = "HAIBUN_HOST_ID";
+export declare const DEFAULT_HOST_ID = 0;
+/** Reserved featureNum value used for non-feature synthetic seqPaths (ad-hoc RPC, MCP, subprocess). */
+export declare const SYNTHETIC_FEATURE_NUM = -1;
+/**
+ * Resolve hostId from environment. Returns DEFAULT_HOST_ID when the env var
+ * is absent. Throws on non-integer or negative values — a misconfigured
+ * hostId would silently break global uniqueness, so fail fast at startup.
+ */
+export declare function resolveHostId(env?: Record<string, string | undefined>): number;
+/**
+ * Synthetic seqPath for calls not tied to a feature step — ad-hoc RPC,
+ * MCP tool invocations, subprocess transport. Uses SYNTHETIC_FEATURE_NUM
+ * (-1) in the featureNum slot so these paths sort distinctly from any
+ * feature path and cannot collide with a running feature.
+ */
+export declare function syntheticSeqPath(hostId: number, adHocSeq: number): number[];
+/**
+ * Allocate the next synthetic seqPath for the given world. Bumps the
+ * world's `adHocSeq` counter and returns a path rooted on the world's
+ * hostId. Used by every external-protocol entry point (RPC, MCP,
+ * subprocess) so the bump-then-build invariant lives in one place.
+ */
+export declare function allocateSyntheticSeqPath(world: {
+    tag: {
+        hostId: number;
+    };
+    runtime: {
+        adHocSeq?: number;
+    };
+}): number[];
+//# sourceMappingURL=host-id.d.ts.map

package/build/lib/host-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-id.d.ts","sourceRoot":"","sources":["../../src/lib/host-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,uGAAuG;AACvG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAQ3F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAGrH"}

package/build/lib/host-id.js

@@ -0,0 +1,51 @@
+/**
+ * hostId — a stable non-negative integer identifying the haibun instance
+ * within a deployment. Prepended to every seqPath root so observations from
+ * different hosts cannot collide even when running identical features.
+ *
+ * Single-host deployments keep hostId = 0 (the default) and see no change.
+ * Multi-host deployments set HAIBUN_HOST_ID per instance; assigning ids is
+ * an operator concern (config, supervisor, orchestration).
+ *
+ * Aligns with OpenTelemetry's `service.instance.id` convention — a haibun
+ * instance is a service instance.
+ */
+export const HAIBUN_HOST_ID_ENV = "HAIBUN_HOST_ID";
+export const DEFAULT_HOST_ID = 0;
+/** Reserved featureNum value used for non-feature synthetic seqPaths (ad-hoc RPC, MCP, subprocess). */
+export const SYNTHETIC_FEATURE_NUM = -1;
+/**
+ * Resolve hostId from environment. Returns DEFAULT_HOST_ID when the env var
+ * is absent. Throws on non-integer or negative values — a misconfigured
+ * hostId would silently break global uniqueness, so fail fast at startup.
+ */
+export function resolveHostId(env = process.env) {
+    const raw = env[HAIBUN_HOST_ID_ENV];
+    if (raw === undefined || raw === "")
+        return DEFAULT_HOST_ID;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error(`${HAIBUN_HOST_ID_ENV} must be a non-negative integer, got "${raw}"`);
+    }
+    return n;
+}
+/**
+ * Synthetic seqPath for calls not tied to a feature step — ad-hoc RPC,
+ * MCP tool invocations, subprocess transport. Uses SYNTHETIC_FEATURE_NUM
+ * (-1) in the featureNum slot so these paths sort distinctly from any
+ * feature path and cannot collide with a running feature.
+ */
+export function syntheticSeqPath(hostId, adHocSeq) {
+    return [hostId, SYNTHETIC_FEATURE_NUM, adHocSeq];
+}
+/**
+ * Allocate the next synthetic seqPath for the given world. Bumps the
+ * world's `adHocSeq` counter and returns a path rooted on the world's
+ * hostId. Used by every external-protocol entry point (RPC, MCP,
+ * subprocess) so the bump-then-build invariant lives in one place.
+ */
+export function allocateSyntheticSeqPath(world) {
+    world.runtime.adHocSeq = (world.runtime.adHocSeq ?? 0) + 1;
+    return syntheticSeqPath(world.tag.hostId, world.runtime.adHocSeq);
+}
+//# sourceMappingURL=host-id.js.map

package/build/lib/host-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-id.js","sourceRoot":"","sources":["../../src/lib/host-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,uGAAuG;AACvG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0C,OAAO,CAAC,GAAG;IAClF,MAAM,GAAG,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,eAAe,CAAC;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,GAAG,kBAAkB,yCAAyC,GAAG,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IAChE,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAkE;IAC1G,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC"}

package/build/lib/http-observations.d.ts

@@ -5,7 +5,19 @@
  * - NodeHttpEvents (Node.js fetch/undici requests)
  * - PlaywrightEvents (browser requests via Playwright)
  */
-import type { TWorld } from './defs.js';
+import type { TWorld } from "./execution.js";
+export declare const SERVICE_PATH_PREFIXES: readonly ["/sse", "/rpc/"];
+export declare const OBSERVATION_GRAPH: {
+    readonly ROUTE: "observation/route";
+    readonly SERVICE: "observation/shu-service";
+    readonly EXTERNAL: "observation/external";
+    readonly ENDPOINT: "Endpoint";
+};
+/** Classify an HTTP path against registered route paths. Returns the observation namedGraph and resolved endpoint path. */
+export declare function classifyHttpPath(path: string, registeredPaths: Set<string>): {
+    namedGraph: string;
+    endpointPath: string;
+};
 /** Observation data for a single HTTP request */
 export type THttpRequestObservation = {
     url: string;
@@ -20,6 +32,7 @@ export type THttpRequestObservation = {
 export declare function trackHttpHost(world: TWorld, url: string): void;
 /**
  * Track an HTTP request in observations for the 'http-trace' observation source.
+ * Pass registeredPaths (from IWebServer.mounted) to classify observations into namedGraphs.
  */
-export declare function trackHttpRequest(world: TWorld, observation: THttpRequestObservation): void;
+export declare function trackHttpRequest(world: TWorld, observation: THttpRequestObservation, registeredPaths: Set<string>): void;
 //# sourceMappingURL=http-observations.d.ts.map

package/build/lib/http-observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-observations.d.ts","sourceRoot":"","sources":["../../src/lib/http-observations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAa9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,uBAAuB,GAAG,IAAI,CA6B1F"}
+{"version":3,"file":"http-observations.d.ts","sourceRoot":"","sources":["../../src/lib/http-observations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,eAAO,MAAM,qBAAqB,4BAA6B,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;CAAsI,CAAC;AAErK,2HAA2H;AAC3H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAWzH;AAUD,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAAG;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAa9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,uBAAuB,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAkBxH"}

package/build/lib/http-observations.js

@@ -5,6 +5,33 @@
  * - NodeHttpEvents (Node.js fetch/undici requests)
  * - PlaywrightEvents (browser requests via Playwright)
  */
+import { emitQuadObservation } from "./quad-types.js";
+export const SERVICE_PATH_PREFIXES = ["/sse", "/rpc/"];
+export const OBSERVATION_GRAPH = { ROUTE: "observation/route", SERVICE: "observation/shu-service", EXTERNAL: "observation/external", ENDPOINT: "Endpoint" };
+/** Classify an HTTP path against registered route paths. Returns the observation namedGraph and resolved endpoint path. */
+export function classifyHttpPath(path, registeredPaths) {
+    const isService = SERVICE_PATH_PREFIXES.some((p) => path === p || path.startsWith(p));
+    if (isService) {
+        if (registeredPaths.has(path))
+            return { namedGraph: OBSERVATION_GRAPH.SERVICE, endpointPath: path };
+        const match = [...registeredPaths].find((rp) => pathMatchesParameterized(rp, path));
+        return { namedGraph: OBSERVATION_GRAPH.SERVICE, endpointPath: match ?? path };
+    }
+    if (registeredPaths.has(path))
+        return { namedGraph: OBSERVATION_GRAPH.ROUTE, endpointPath: path };
+    const paramMatch = [...registeredPaths].find((rp) => pathMatchesParameterized(rp, path));
+    if (paramMatch)
+        return { namedGraph: OBSERVATION_GRAPH.ROUTE, endpointPath: paramMatch };
+    return { namedGraph: OBSERVATION_GRAPH.EXTERNAL, endpointPath: path };
+}
+/** Check if a concrete path matches a parameterized route (e.g., /status/revocation matches /status/:purpose). */
+function pathMatchesParameterized(route, path) {
+    const routeParts = route.split("/");
+    const pathParts = path.split("/");
+    if (routeParts.length !== pathParts.length)
+        return false;
+    return routeParts.every((rp, i) => rp.startsWith(":") || rp === pathParts[i]);
+}
 /**
  * Track an HTTP host in observations for the 'http-trace hosts' observation source.
  * Both NodeHttpEvents and PlaywrightEvents use this.
@@ -16,9 +43,9 @@ export function trackHttpHost(world, url) {
         if (!world.runtime.observations) {
             world.runtime.observations = new Map();
         }
-        const httpHosts = world.runtime.observations.get('httpHosts') || new Map();
+        const httpHosts = world.runtime.observations.get("httpHosts") || new Map();
         httpHosts.set(host, (httpHosts.get(host) || 0) + 1);
-        world.runtime.observations.set('httpHosts', httpHosts);
+        world.runtime.observations.set("httpHosts", httpHosts);
     }
     catch {
         // Invalid URL, skip tracking
@@ -26,34 +53,24 @@ export function trackHttpHost(world, url) {
 }
 /**
  * Track an HTTP request in observations for the 'http-trace' observation source.
+ * Pass registeredPaths (from IWebServer.mounted) to classify observations into namedGraphs.
  */
-export function trackHttpRequest(world, observation) {
+export function trackHttpRequest(world, observation, registeredPaths) {
     if (!world.runtime.observations) {
         world.runtime.observations = new Map();
     }
-    const requests = world.runtime.observations.get('httpRequests') || new Map();
+    const requests = world.runtime.observations.get("httpRequests") ||
+        new Map();
     const count = requests.size;
     const id = `req-${count + 1}`;
     requests.set(id, observation);
-    world.runtime.observations.set('httpRequests', requests);
-    // Emit quadObservation with hierarchical context for graph visualization
+    world.runtime.observations.set("httpRequests", requests);
     const timestamp = Date.now();
-    world.eventLogger.emit({
-        id: `quad-http-${timestamp}-${id}`,
-        timestamp,
-        source: 'haibun',
-        level: 'debug',
-        kind: 'artifact',
-        artifactType: 'json',
-        mimetype: 'application/json',
-        json: {
-            quadObservation: {
-                subject: id,
-                predicate: 'time',
-                object: observation.time,
-                namedGraph: 'observation/http',
-            }
-        },
-    });
+    const path = observation.url.startsWith("/") ? observation.url : new URL(observation.url).pathname;
+    const { namedGraph, endpointPath } = classifyHttpPath(path, registeredPaths);
+    const subject = `${observation.method} ${path}`;
+    emitQuadObservation(world.eventLogger, `quad-http-${timestamp}-${id}-name`, { subject, predicate: "name", object: `${observation.method} ${observation.status} ${observation.time}ms`, namedGraph, timestamp });
+    if (namedGraph !== OBSERVATION_GRAPH.EXTERNAL)
+        emitQuadObservation(world.eventLogger, `quad-http-${timestamp}-${id}-endpoint`, { subject, predicate: "endpoint", object: endpointPath, namedGraph, timestamp });
 }
 //# sourceMappingURL=http-observations.js.map

package/build/lib/http-observations.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-observations.js","sourceRoot":"","sources":["../../src/lib/http-observations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,GAAW;IACtD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,SAAS,GAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAyB,IAAI,IAAI,GAAG,EAAkB,CAAC;QACpH,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,WAAoC;IAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,QAAQ,GAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAA0C,IAAI,IAAI,GAAG,EAAmC,CAAC;IACxJ,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC5B,MAAM,EAAE,GAAG,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAEzD,yEAAyE;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACrB,EAAE,EAAE,aAAa,SAAS,IAAI,EAAE,EAAE;QAClC,SAAS;QACT,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,OAAgB;QACvB,IAAI,EAAE,UAAmB;QACzB,YAAY,EAAE,MAAe;QAC7B,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE;YACJ,eAAe,EAAE;gBACf,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,UAAU,EAAE,kBAAkB;aAC/B;SACF;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"http-observations.js","sourceRoot":"","sources":["../../src/lib/http-observations.ts"],"names":[],"mappings":"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"}

package/build/lib/hypermedia.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Hypermedia concern catalog — canonical contract between server and SPA.
+ *
+ * Grounded in ActivityStreams / JSON-LD.  Derived entirely from getConcerns domains
+ * with TDomainTopology: one declaration drives CRUD, JSON-LD context, and UI behaviour.
+ *
+ * StepDiscovery (step.list) embeds a ConcernCatalog so any client (shu, MCP, ...)
+ * receives machine-readable hypermedia metadata without a separate RPC call.
+ */
+import { z } from "zod";
+import type { TRegisteredDomain } from "./resources.js";
+export declare const RelSchema: z.ZodEnum<{
+    [x: string]: string;
+}>;
+/** All vertex concerns emitted by a running server, keyed by vertex label. */
+export declare const ConcernCatalogSchema: z.ZodObject<{
+    vertices: z.ZodRecord<z.ZodString, z.ZodObject<{
+        domainKey: z.ZodString;
+        label: z.ZodString;
+        idField: z.ZodString;
+        asType: z.ZodOptional<z.ZodString>;
+        jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+            term: z.ZodString;
+            rel: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+            mediaType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        edges: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            term: z.ZodString;
+            rel: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+            target: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TConcernCatalog = z.infer<typeof ConcernCatalogSchema>;
+/**
+ * Build a ConcernCatalog from world.domains after getConcerns has run.
+ * Non-vertex domains (no topology.vertexLabel) are skipped.
+ * Vertex domains are validated: id, properties, and valid rels are required.
+ */
+export declare function buildConcernCatalog(domains: Record<string, TRegisteredDomain>): TConcernCatalog;
+/** Rel-to-field lookup for resource types. Derived from topology at runtime. */
+export type ResourceRels = {
+    types: string[];
+    field(type: string, rel: string): string | undefined;
+    idField(type: string): string;
+    publishedField(type: string): string | undefined;
+    nameField(type: string): string | undefined;
+    contentField(type: string): string | undefined;
+    fields(type: string): Record<string, string>;
+};
+/** Build ResourceRels from world.domains concern metadata. */
+export declare function buildResourceRels(domains: Record<string, TRegisteredDomain>): ResourceRels;
+/** Parse a value as epoch ms (ISO date string or number). */
+export declare function parseTimestampValue(val: unknown): number | null;
+/** Build JSON-LD context from domain topology. Derives URI mappings from domain property rels. */
+export declare function getJsonLdContext(domains: Record<string, TRegisteredDomain>): Record<string, unknown>;
+//# sourceMappingURL=hypermedia.d.ts.map

package/build/lib/hypermedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypermedia.d.ts","sourceRoot":"","sources":["../../src/lib/hypermedia.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAwBxD,eAAO,MAAM,SAAS;;EAAoB,CAAC;AAmC3C,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;iBAE/B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,eAAe,CA8C/F;AAMD,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,YAAY,CAwC1F;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO/D;AAqBD,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCpG"}

package/build/lib/hypermedia.js

@@ -0,0 +1,228 @@
+/**
+ * Hypermedia concern catalog — canonical contract between server and SPA.
+ *
+ * Grounded in ActivityStreams / JSON-LD.  Derived entirely from getConcerns domains
+ * with TDomainTopology: one declaration drives CRUD, JSON-LD context, and UI behaviour.
+ *
+ * StepDiscovery (step.list) embeds a ConcernCatalog so any client (shu, MCP, ...)
+ * receives machine-readable hypermedia metadata without a separate RPC call.
+ */
+import { z } from "zod";
+import { getRel, getMediaType, edgeRel, REL_CONTEXT, LinkRelations, getRelRange } from "./resources.js";
+/** Per-schema JSON-Schema memoization. `step.list` RPC calls buildConcernCatalog repeatedly; each
+ *  domain's `z.toJSONSchema` traversal is stable per schema instance, so cache by identity. */
+const jsonSchemaCache = new WeakMap();
+function toJsonSchemaCached(schema) {
+    const hit = jsonSchemaCache.get(schema);
+    if (hit)
+        return hit;
+    try {
+        const js = z.toJSONSchema(schema);
+        jsonSchemaCache.set(schema, js);
+        return js;
+    }
+    catch {
+        const empty = {};
+        jsonSchemaCache.set(schema, empty);
+        return empty;
+    }
+}
+// ============================================================================
+// Schemas  (Zod → TypeScript, Zod → JSON Schema — single source of truth)
+// ============================================================================
+const relValues = Object.values(LinkRelations).map((lr) => lr.rel);
+export const RelSchema = z.enum(relValues);
+/**
+ * A single vertex property mapped to its ActivityStreams predicate.
+ * `mediaType` is present only when rel === 'content'.
+ */
+const PropertyConcernSchema = z.object({
+    term: z.string(),
+    rel: RelSchema,
+    mediaType: z.string().optional(),
+});
+/** An outgoing edge with its ActivityStreams predicate and target vertex label. */
+const EdgeConcernSchema = z.object({
+    term: z.string(),
+    rel: RelSchema,
+    target: z.string(),
+});
+/** Complete hypermedia description of a vertex type. */
+const VertexConcernSchema = z.object({
+    domainKey: z.string(),
+    label: z.string(),
+    idField: z.string(),
+    /** ActivityStreams @type  e.g. "as:Note" */
+    asType: z.string().optional(),
+    /** JSON Schema derived from the Zod domain schema at registration time. */
+    jsonSchema: z.record(z.string(), z.unknown()),
+    properties: z.record(z.string(), PropertyConcernSchema),
+    edges: z.record(z.string(), EdgeConcernSchema).default({}),
+});
+/** All vertex concerns emitted by a running server, keyed by vertex label. */
+export const ConcernCatalogSchema = z.object({
+    vertices: z.record(z.string(), VertexConcernSchema),
+});
+// ============================================================================
+// Builder
+// ============================================================================
+/**
+ * Build a ConcernCatalog from world.domains after getConcerns has run.
+ * Non-vertex domains (no topology.vertexLabel) are skipped.
+ * Vertex domains are validated: id, properties, and valid rels are required.
+ */
+export function buildConcernCatalog(domains) {
+    const vertices = {};
+    for (const [domainKey, domain] of Object.entries(domains)) {
+        const topology = domain.topology;
+        if (!topology?.vertexLabel)
+            continue;
+        const label = topology.vertexLabel;
+        if (!topology.id)
+            throw new Error(`Vertex domain "${label}" (${domainKey}) is missing required "id" field`);
+        if (!topology.properties || Object.keys(topology.properties).length === 0)
+            throw new Error(`Vertex domain "${label}" (${domainKey}) has no properties`);
+        const hasIdentifier = Object.values(topology.properties).some((p) => getRel(p) === LinkRelations.IDENTIFIER.rel);
+        if (!hasIdentifier)
+            throw new Error(`Vertex domain "${label}" (${domainKey}) has no property with rel "${LinkRelations.IDENTIFIER.rel}"`);
+        const properties = {};
+        for (const [field, propDef] of Object.entries(topology.properties)) {
+            const rel = getRel(propDef);
+            if (!REL_CONTEXT[rel])
+                throw new Error(`Vertex domain "${label}" property "${field}" has unknown rel "${rel}"`);
+            const mediaType = getMediaType(propDef);
+            properties[field] = { term: REL_CONTEXT[rel], rel, ...(mediaType ? { mediaType } : {}) };
+        }
+        const edges = {};
+        for (const [edgeField, edgeDef] of Object.entries(topology.edges ?? {})) {
+            const rel = edgeDef.rel ?? edgeRel(edgeField);
+            if (!rel)
+                throw new Error(`Vertex domain "${label}" edge "${edgeField}" has no rel — add to EdgePredicates or provide explicit rel`);
+            if (!REL_CONTEXT[rel])
+                throw new Error(`Vertex domain "${label}" edge "${edgeField}" has unknown rel "${rel}"`);
+            edges[edgeField] = { term: REL_CONTEXT[rel], rel, target: edgeDef.range };
+        }
+        const jsonSchema = toJsonSchemaCached(domain.schema);
+        vertices[label] = VertexConcernSchema.parse({
+            domainKey,
+            label,
+            idField: topology.id,
+            ...(topology.type ? { asType: topology.type } : {}),
+            jsonSchema,
+            properties,
+            edges,
+        });
+    }
+    return { vertices };
+}
+/** Build ResourceRels from world.domains concern metadata. */
+export function buildResourceRels(domains) {
+    const types = [];
+    const idFields = new Map();
+    const relMaps = new Map();
+    for (const domain of Object.values(domains)) {
+        const topology = domain.topology;
+        if (!topology?.vertexLabel)
+            continue;
+        const type = topology.vertexLabel;
+        types.push(type);
+        idFields.set(type, topology.id);
+        const rels = {};
+        for (const [field, def] of Object.entries(topology.properties ?? {})) {
+            rels[field] = getRel(def);
+        }
+        relMaps.set(type, rels);
+    }
+    const fieldByRel = (type, rel) => {
+        const rels = relMaps.get(type);
+        if (!rels)
+            return undefined;
+        for (const [field, r] of Object.entries(rels)) {
+            if (r === rel)
+                return field;
+        }
+        return undefined;
+    };
+    return {
+        types,
+        field: fieldByRel,
+        idField: (type) => {
+            const id = idFields.get(type);
+            if (!id)
+                throw new Error(`Unknown resource type: ${type}`);
+            return id;
+        },
+        publishedField: (type) => fieldByRel(type, LinkRelations.PUBLISHED.rel),
+        nameField: (type) => fieldByRel(type, LinkRelations.NAME.rel),
+        contentField: (type) => fieldByRel(type, LinkRelations.CONTENT.rel),
+        fields: (type) => relMaps.get(type) ?? {},
+    };
+}
+/** Parse a value as epoch ms (ISO date string or number). */
+export function parseTimestampValue(val) {
+    if (typeof val === "number")
+        return val;
+    if (typeof val === "string") {
+        const d = new Date(val);
+        if (!Number.isNaN(d.getTime()))
+            return d.getTime();
+    }
+    return null;
+}
+// ============================================================================
+// JSON-LD context — derived from domain topology
+// ============================================================================
+/**
+ * Map a rel's RDF range to its UI rendering category.
+ *   iri       → "item"    (navigable link to another vertex)
+ *   container → "select"  (multi-valued structure; select-like control)
+ *   literal   → "filter"  (scalar value; filter/text control)
+ *
+ * Unknown rels default to "filter" — the safest neutral rendering.
+ */
+function linkRelFromSemantic(rel) {
+    const range = getRelRange(rel);
+    if (range === "iri")
+        return "item";
+    if (range === "container")
+        return "select";
+    return "filter";
+}
+/** Build JSON-LD context from domain topology. Derives URI mappings from domain property rels. */
+export function getJsonLdContext(domains) {
+    const context = {
+        "@version": 1.1,
+        as: "https://www.w3.org/ns/activitystreams#",
+        foaf: "http://xmlns.com/foaf/0.1/",
+        dcterms: "http://purl.org/dc/terms/",
+        prov: "https://www.w3.org/ns/prov#",
+        sosa: "http://www.w3.org/ns/sosa/",
+        schema: "https://schema.org/",
+        otel: "https://opentelemetry.io/schemas/",
+        hbn: "https://haibun.dev/ns/",
+        haibun: "/ns/",
+    };
+    for (const domain of Object.values(domains)) {
+        const topology = domain.topology;
+        if (!topology?.vertexLabel)
+            continue;
+        for (const [prop, def] of Object.entries(topology.properties)) {
+            const rel = getRel(def);
+            const uri = REL_CONTEXT[rel] ?? `haibun:${prop}`;
+            const mediaType = getMediaType(def);
+            const linkRel = linkRelFromSemantic(rel);
+            const node = { "@id": uri, "haibun:rel": linkRel };
+            if (linkRel === "item")
+                node["@type"] = "@id";
+            if (mediaType)
+                node["as:mediaType"] = mediaType;
+            context[prop] = node;
+        }
+        for (const [edge, edgeDef] of Object.entries(topology.edges ?? {})) {
+            const rel = edgeDef.rel ?? edgeRel(edge);
+            context[edge] = { "@id": (rel && REL_CONTEXT[rel]) ?? `haibun:${edge}`, "@type": "@id", "haibun:rel": "item" };
+        }
+    }
+    return { "@context": context };
+}
+//# sourceMappingURL=hypermedia.js.map

package/build/lib/hypermedia.js.map

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

package/build/lib/namedVars.d.ts

@@ -1,5 +1,5 @@
-import { TStepperStep, TStepAction } from './defs.js';
-import { TStepValue } from '../schema/protocol.js';
+import { TStepperStep, TStepAction } from "./execution.js";
+import { TStepValue } from "../schema/protocol.js";
 export declare const TYPE_QUOTED = "q_";
 export declare const TYPE_ENV = "e_";
 export declare const TYPE_VAR = "b_";

package/build/lib/namedVars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namedVars.d.ts","sourceRoot":"","sources":["../../src/lib/namedVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,UAAU,EAAmB,MAAM,uBAAuB,CAAC;AAGpE,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CA+ElH,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAY,MAAM,EAAE,YAAY,MAAM,EAAE,aAAa,MAAM,EAAE,MAAM,YAAY,gBAO9H,CAAC;AAUF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;EAG3D;AAED,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,MAAM,EAAE,aAAa,MAAM,EAAE,MAAM,YAAY,EAAE,gBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,gBAoD9J,CAAC;AAeF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM;;EAUhF"}
+{"version":3,"file":"namedVars.d.ts","sourceRoot":"","sources":["../../src/lib/namedVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAmB,MAAM,uBAAuB,CAAC;AAGpE,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CA2ElH,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,MAAM,MAAM,EACZ,YAAY,MAAM,EAClB,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,MAAM,YAAY,gBAQlB,CAAC;AAUF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;EAG3D;AAED,eAAO,MAAM,QAAQ,GACpB,YAAY,MAAM,EAClB,GAAG,MAAM,EACT,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,MAAM,YAAY,EAClB,gBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,gBAuD1C,CAAC;AAeF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM;;EAUhF"}