@canonical/pragma-cli 0.34.0 → 0.36.0

package/dist/src/kernel/packs/graphql/buildLookupDocument.js

@@ -0,0 +1,258 @@
+/**
+ * Generate the ONE GraphQL document a `source: "graphql"` pack lookup executes
+ * after its SPARQL name→URI resolve.
+ *
+ * The compiler — not the pack author — writes the GraphQL: pack declarations
+ * name RDF properties, and this module maps each onto the OWL-derived schema
+ * using the same naming rules the ke-graphql compiler applied (strip `has`/`is`,
+ * pluralize for multi-valued fields — see {@link ./nameMap}).
+ *
+ * Missing-name semantics mirror the SPARQL path's OPTIONAL clauses: a DERIVED
+ * name that maps onto no schema field anywhere simply drops out of the document
+ * (ontology drift degrades to emptiness, not failure). An EXPLICIT `graphqlField`
+ * override that names no field is a fail-fast error, as are cardinality
+ * mismatches. A property on only some concrete classes under an interface
+ * fragment resolves through subtype-scoped `... on <Subtype>` fragments.
+ *
+ * Injection safety: the document text is composed ONLY from validated pack terms
+ * and names read from the compiled schema; the entity IRI travels via
+ * `variableValues.uri`, never string interpolation.
+ *
+ * Ported from #856; retargeted onto graphql-js `GraphQLSchema` (referenced as an
+ * inline type — this module has no runtime `graphql`/`ke-graphql` import, so it
+ * stays off the storeless fast path).
+ */
+import { PragmaError } from "../../error/index.js";
+import { activeExpands, activeFields } from "./../sparql/buildLookupQuery.js";
+import { isNestedExpand } from "../types.js";
+import { MAX_PAGE_SIZE, pluralize, stripVerbPrefix } from "./nameMap.js";
+/** Local name of an IRI (`…#Thing`/`…/Thing` → `Thing`). */
+function extractLocalName(uri) {
+    const hash = uri.lastIndexOf("#");
+    if (hash !== -1)
+        return uri.slice(hash + 1);
+    const slash = uri.lastIndexOf("/");
+    if (slash !== -1)
+        return uri.slice(slash + 1);
+    return uri;
+}
+/** Does a schema type expose fields (object or interface)? */
+function isComposite(type) {
+    return (typeof type === "object" &&
+        type !== null &&
+        "getFields" in type &&
+        typeof type.getFields === "function");
+}
+/** Unwrap NonNull/List wrappers to the named type underneath. */
+function namedType(type) {
+    let current = type;
+    while (typeof current === "object" &&
+        current !== null &&
+        "ofType" in current &&
+        current.ofType) {
+        current = current.ofType;
+    }
+    return current;
+}
+/** Is the field type a GraphQL list? Detected from the type's string form. */
+function isListType(type) {
+    return String(type).includes("[");
+}
+/** Is the named type a generated Relay connection envelope? */
+function isConnection(type) {
+    return (isComposite(type) &&
+        type.name.endsWith("Connection") &&
+        "edges" in type.getFields());
+}
+/** Local name of a validated pack term (`ds:Component` → `Component`). */
+function termLocalName(term) {
+    if (term.includes("://"))
+        return extractLocalName(term);
+    const colon = term.indexOf(":");
+    return colon === -1 ? term : term.slice(colon + 1);
+}
+function buildDocumentError(source, message) {
+    return PragmaError.configError(`Invalid story in ${source}: ${message}`);
+}
+/**
+ * Resolve a pack term to the GraphQL field it maps to on a container type. With
+ * an explicit `graphqlField` the name is only checked for existence (a miss
+ * throws). Otherwise the derivation applies; a derived miss returns `undefined`.
+ */
+function resolveGraphqlField(container, term, override, preferPlural, where, source) {
+    const fields = container.getFields();
+    if (override) {
+        const match = fields[override];
+        if (!match) {
+            throw buildDocumentError(source, `"${where}.graphqlField" "${override}" is not a field of GraphQL type "${container.name}".`);
+        }
+        return { fieldName: override, type: match.type };
+    }
+    if (term.includes("/") && !term.includes("://")) {
+        throw buildDocumentError(source, `"${where}" uses a property path ("${term}"), which the GraphQL source cannot express — set "graphqlField" or use source "sparql".`);
+    }
+    const base = stripVerbPrefix(termLocalName(term));
+    const forms = preferPlural
+        ? [pluralize(base), base]
+        : [base, pluralize(base)];
+    for (const candidate of [...new Set(forms)]) {
+        const match = fields[candidate];
+        if (match)
+            return { fieldName: candidate, type: match.type };
+    }
+    return undefined;
+}
+/** Alias a selection only when the output name differs from the field. */
+function aliased(name, fieldName) {
+    return name === fieldName ? name : `${name}: ${fieldName}`;
+}
+/**
+ * Build the selection for one flat value (field or section): scalars select
+ * bare, singular entity references select `{ uri }`. Multi-valued fields are
+ * rejected. `undefined` when the derived name maps onto no field.
+ */
+function buildValueSelection(container, value, where, source) {
+    const resolved = resolveGraphqlField(container, value.property, value.graphqlField, false, where, source);
+    if (!resolved)
+        return undefined;
+    const { fieldName, type } = resolved;
+    const named = namedType(type);
+    if (isConnection(named) || isListType(type)) {
+        throw buildDocumentError(source, `"${where}" property "${value.property}" resolves to multi-valued GraphQL field "${container.name}.${fieldName}" — declare it as an expand.`);
+    }
+    if (isComposite(named)) {
+        return {
+            text: `${aliased(value.name, fieldName)} { uri }`,
+            projection: { kind: "entity", name: value.name },
+        };
+    }
+    if (fieldName === "uri") {
+        return {
+            text: aliased(value.name, fieldName),
+            projection: { kind: "iri", name: value.name },
+        };
+    }
+    return {
+        text: aliased(value.name, fieldName),
+        projection: { kind: "scalar", name: value.name },
+    };
+}
+/**
+ * Build the selection for a multi-valued projection (an expand or nested
+ * expand): Relay connections select through `edges { node }`; embedded lists
+ * select children directly. `undefined` when the relation maps onto no field or
+ * every child selection was omitted.
+ */
+function buildCollectionSelection(container, expand, where, source) {
+    const resolved = resolveGraphqlField(container, expand.relation, expand.graphqlField, true, where, source);
+    if (!resolved)
+        return undefined;
+    const { fieldName, type } = resolved;
+    const named = namedType(type);
+    const connection = isConnection(named);
+    if (!connection && !isListType(type)) {
+        throw buildDocumentError(source, `"${where}" relation "${expand.relation}" resolves to singular GraphQL field "${container.name}.${fieldName}" — declare it as a field.`);
+    }
+    const childType = connection
+        ? namedType(named.getFields().edges?.type)
+        : named;
+    const nodeType = connection && isComposite(childType)
+        ? namedType(childType.getFields().node?.type)
+        : childType;
+    if (!isComposite(nodeType)) {
+        throw buildDocumentError(source, `"${where}" relation "${expand.relation}" resolves to a list of scalars on "${container.name}" — declare it as a field or fix the relation.`);
+    }
+    const children = expand.select
+        .map((entry, index) => {
+        const childWhere = `${where}.select[${index}]`;
+        if (isNestedExpand(entry)) {
+            return buildCollectionSelection(nodeType, entry, childWhere, source);
+        }
+        return buildValueSelection(nodeType, entry, childWhere, source);
+    })
+        .filter((child) => child !== undefined);
+    if (children.length === 0)
+        return undefined;
+    const childText = children.map((child) => child.text).join(" ");
+    const body = connection
+        ? `(first: ${MAX_PAGE_SIZE}) { edges { node { ${childText} } } }`
+        : ` { ${childText} }`;
+    return {
+        text: `${aliased(expand.name, fieldName)}${body}`,
+        projection: {
+            kind: "collection",
+            name: expand.name,
+            connection,
+            children: children.map((child) => child.projection),
+        },
+    };
+}
+/** The concrete object types under an interface fragment (empty for object types). */
+function possibleSubtypes(schema, fragmentType) {
+    const lookup = schema.getPossibleTypes;
+    return lookup.call(schema, fragmentType).filter(isComposite);
+}
+/**
+ * Build one top-level selection, falling back to subtype scoping: a term that
+ * does not resolve on the fragment type is tried on each concrete class under it
+ * and selected inside `... on <Subtype>` fragments. `undefined` when the term
+ * resolves nowhere (omitted, mirroring an unbound OPTIONAL).
+ */
+function buildScopedSelection(schema, fragmentType, build) {
+    const direct = build(fragmentType);
+    if (direct)
+        return direct;
+    const scoped = possibleSubtypes(schema, fragmentType)
+        .map((subtype) => {
+        const selection = build(subtype);
+        return selection === undefined
+            ? undefined
+            : {
+                ...selection,
+                text: `... on ${subtype.name} { ${selection.text} }`,
+            };
+    })
+        .filter((selection) => selection !== undefined);
+    if (scoped.length === 0)
+        return undefined;
+    return {
+        text: scoped.map((selection) => selection.text).join(" "),
+        projection: scoped[0].projection,
+    };
+}
+/**
+ * Generate the lookup document for a pack lookup at a canonical level.
+ *
+ * @param lookup - A validated graphql-sourced lookup declaration.
+ * @param schema - The runtime's compiled OWL-derived schema.
+ * @param source - Pack source, for error attribution.
+ * @param level - Active canonical level (undefined: everything included).
+ * @returns The document text and its unwrap plan.
+ * @throws PragmaError CONFIG_ERROR when a declaration does not map onto the schema.
+ */
+export function buildLookupDocument(lookup, schema, source, level) {
+    const typeName = lookup.graphqlType ?? termLocalName(lookup.type ?? "");
+    const fragmentType = schema.getType(typeName);
+    if (!isComposite(fragmentType)) {
+        throw buildDocumentError(source, `lookup.graphqlType "${typeName}" is not an object or interface type in the compiled GraphQL schema.`);
+    }
+    const selections = [
+        ...activeFields(lookup, level).map((field, index) => buildScopedSelection(schema, fragmentType, (container) => buildValueSelection(container, field, `lookup.fields/sections[${index}]`, source))),
+        ...activeExpands(lookup, level).map((expand, index) => buildScopedSelection(schema, fragmentType, (container) => buildCollectionSelection(container, expand, `lookup.expand[${index}]`, source))),
+    ].filter((selection) => selection !== undefined);
+    const body = selections.map((selection) => `      ${selection.text}`);
+    const text = [
+        "query PackLookup($uri: ID!) {",
+        "  node(id: $uri) {",
+        `    ... on ${fragmentType.name} {`,
+        ...(body.length > 0 ? body : ["      uri"]),
+        "    }",
+        "  }",
+        "}",
+    ].join("\n");
+    return {
+        source: text,
+        projections: selections.map((selection) => selection.projection),
+    };
+}
+//# sourceMappingURL=buildLookupDocument.js.map

package/dist/src/kernel/packs/graphql/buildLookupDocument.js.map

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

package/dist/src/kernel/packs/graphql/fetchGraphqlLookup.js

@@ -0,0 +1,157 @@
+/**
+ * Execute a `source: "graphql"` pack lookup's generated document and unwrap the
+ * result to the flat pack entity shape.
+ *
+ * Retargeted onto the PR2 facade: the compiled schema comes from the booted
+ * `StoreSession` (`rt.store.get()`), and the document runs through
+ * `rt.query.graphql` (ke-graphql's in-process `executeLocal` — no server, no
+ * HTTP). Relay envelopes are unwrapped here (connections → arrays, entity
+ * references → IRI strings, prefixed URIs → full IRIs), so the resolved entity
+ * is shape-identical to the SPARQL path.
+ *
+ * Injection safety: the resolved entity IRI enters execution EXCLUSIVELY via
+ * `variableValues.uri` — never interpolated into the document text, which is
+ * composed only from validated pack terms and compiled schema names.
+ */
+import { cliRecovery, PragmaError } from "../../error/index.js";
+import { buildLookupDocument, } from "./buildLookupDocument.js";
+/**
+ * @param rt - The runtime (lazy store + query facade).
+ * @param lookup - The validated lookup declaration.
+ * @param entityUri - IRI resolved by the SPARQL name→URI query (store output).
+ * @param entityName - The entity's canonical stored name.
+ * @param source - Pack source, for error attribution.
+ * @param prefixes - The runtime's merged prefix map (prefixed→full expansion).
+ * @param level - Active canonical level (gates fields/expands at fetch).
+ * @returns The unwrapped pack entity.
+ * @throws PragmaError STORE_UNAVAILABLE when execution reports errors,
+ *   ENTITY_NOT_FOUND when a resolved IRI has no typed node in the schema.
+ * @note Impure — reads the compiled schema and queries the store.
+ */
+export async function fetchGraphqlLookup(rt, lookup, entityUri, entityName, source, prefixes, level) {
+    const session = await rt.store.get();
+    const plan = buildLookupDocument(lookup, session.schema, source, level);
+    const result = await rt.query.graphql(plan.source, { uri: entityUri });
+    if (result.errors && result.errors.length > 0) {
+        const messages = result.errors
+            .slice(0, 3)
+            .map((error) => error.message)
+            .join("; ");
+        throw PragmaError.storeUnavailable(`GraphQL lookup failed: ${messages}`, {
+            // `graph inspect` needs a <uri>; `ontology list` is runnable as-is.
+            recovery: cliRecovery("ontology list", "Check the loaded ontology and namespaces.", { tool: "ontology_list" }),
+        });
+    }
+    const node = result.data?.node;
+    if (node === null || node === undefined || typeof node !== "object") {
+        // The name→URI resolve DID find this IRI, so the store is available — the
+        // entity simply has no typed node (its rdf:type is missing from the loaded
+        // ontology). That is a runtime not-found, not an unavailable store (exit 3).
+        throw new PragmaError({
+            code: "ENTITY_NOT_FOUND",
+            message: `Cannot resolve <${entityUri}> — its rdf:type may be missing from the ontology.`,
+            recovery: cliRecovery(`graph inspect ${entityUri}`, "Inspect the entity's triples to check its rdf:type."),
+        });
+    }
+    const entity = { uri: entityUri, name: entityName };
+    const record = node;
+    for (const projection of plan.projections) {
+        const value = unwrapProjection(record[projection.name], projection, prefixes);
+        if (value !== undefined)
+            entity[projection.name] = value;
+    }
+    return entity;
+}
+/** Unwrap one projected key to the flat pack shape (absent → omitted). */
+function unwrapProjection(value, projection, prefixes) {
+    switch (projection.kind) {
+        case "scalar":
+            return value === null || value === undefined ? undefined : String(value);
+        case "iri":
+            return value === null || value === undefined
+                ? undefined
+                : expandPrefixed(String(value), prefixes);
+        case "entity":
+            return unwrapEntityRef(value, prefixes);
+        case "collection": {
+            const nodes = collectionNodes(value, projection.connection);
+            return nodes.map((node) => unwrapChildRow(node, projection.children, prefixes));
+        }
+    }
+}
+/** Unwrap `{ uri }` to the full IRI string (the identity field is prefixed). */
+function unwrapEntityRef(value, prefixes) {
+    const uri = value?.uri;
+    return typeof uri === "string" ? expandPrefixed(uri, prefixes) : undefined;
+}
+/** Strip the Relay envelope (or pass a plain list through) to node records. */
+function collectionNodes(value, connection) {
+    if (connection) {
+        const edges = value?.edges;
+        if (!Array.isArray(edges))
+            return [];
+        return edges
+            .map((edge) => edge.node)
+            .filter((node) => typeof node === "object" && node !== null);
+    }
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((node) => typeof node === "object" && node !== null);
+}
+/**
+ * Unwrap one child row. A nested expand with a single scalar select collapses
+ * each grandchild to that value (so `values: ["Dense", "Comfortable"]`); a
+ * multi-field select keeps one record per grandchild.
+ */
+function unwrapChildRow(node, children, prefixes) {
+    const row = {};
+    for (const child of children) {
+        const value = node[child.name];
+        if (child.kind === "collection") {
+            const grandchildren = collectionNodes(value, child.connection);
+            const single = child.children.length === 1 && child.children[0]?.kind === "scalar"
+                ? child.children[0]
+                : undefined;
+            row[child.name] = single
+                ? grandchildren
+                    .map((grandchild) => grandchild[single.name])
+                    .filter((v) => v !== null && v !== undefined)
+                    .map(String)
+                : grandchildren.map((grandchild) => {
+                    const record = {};
+                    for (const leaf of child.children) {
+                        const leafValue = unwrapLeaf(grandchild[leaf.name], leaf, prefixes);
+                        if (leafValue !== undefined)
+                            record[leaf.name] = leafValue;
+                    }
+                    return record;
+                });
+            continue;
+        }
+        const unwrapped = unwrapLeaf(value, child, prefixes);
+        if (unwrapped !== undefined)
+            row[child.name] = unwrapped;
+    }
+    return row;
+}
+/** Unwrap one non-collection leaf value (entity refs and `uri` → full IRIs). */
+function unwrapLeaf(value, leaf, prefixes) {
+    if (leaf.kind === "entity")
+        return unwrapEntityRef(value, prefixes);
+    if (value === null || value === undefined)
+        return undefined;
+    return leaf.kind === "iri"
+        ? expandPrefixed(String(value), prefixes)
+        : String(value);
+}
+/** Expand a prefixed URI (`ds:global`) to its full IRI via the merged prefixes. */
+function expandPrefixed(uri, prefixes) {
+    if (uri.includes("://"))
+        return uri;
+    const colon = uri.indexOf(":");
+    if (colon === -1)
+        return uri;
+    const namespace = prefixes[uri.slice(0, colon)];
+    return namespace ? `${namespace}${uri.slice(colon + 1)}` : uri;
+}
+//# sourceMappingURL=fetchGraphqlLookup.js.map

package/dist/src/kernel/packs/graphql/fetchGraphqlLookup.js.map

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

package/dist/src/kernel/packs/graphql/index.js

@@ -0,0 +1,20 @@
+/**
+ * The GraphQL lookup path — what a `source: "graphql"` pack story executes
+ * once SPARQL has resolved its name to an entity IRI.
+ *
+ * The three files here are one function split for testability, not three
+ * services: the naming rules derive schema field names from the RDF properties
+ * a pack declares, the document generator turns a lookup declaration plus
+ * those names into the single query to run, and the fetcher executes it and
+ * unwraps the Relay envelope into the same flat entity shape the SPARQL path
+ * produces. Only the last of those is something a caller does.
+ *
+ * So the barrel is one export, and the narrowness is the point. The document
+ * generator's contract is that the entity IRI travels as a query VARIABLE and
+ * never as interpolated text, and that a document is composed only from
+ * validated pack terms and compiled schema names. Handing out the generator on
+ * its own would hand out a way to build a document and execute it by some
+ * other route; handing out the fetcher hands out the guarantee with it.
+ */
+export { fetchGraphqlLookup } from "./fetchGraphqlLookup.js";
+//# sourceMappingURL=index.js.map

package/dist/src/kernel/packs/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/kernel/packs/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/kernel/packs/graphql/nameMap.js

@@ -0,0 +1,63 @@
+/**
+ * The GraphQL naming rules the pack document generator needs — ported verbatim
+ * from ke-graphql's internal `compiler/nameMap` (Pass 4). ke-graphql does not
+ * re-export these helpers from its public entry, so they are reimplemented here
+ * with the SAME logic to guarantee the derived field names match the names the
+ * compiler actually generated. Keeping the port faithful is load-bearing: a
+ * divergence would derive a field the schema does not expose.
+ */
+/** Irregular plurals the suffix rules cannot produce. */
+const IRREGULAR_PLURALS = {
+    child: "children",
+    person: "people",
+};
+/**
+ * Pluralize a camelCase field name (matching ke-graphql):
+ *   a. irregulars (child → children), preserving a camelCase prefix
+ *   b. already ends in 's' → unchanged
+ *   c. consonant + 'y' → 'ies'
+ *   d. x/z/ch/sh → '+es'
+ *   e. default → '+s'
+ */
+export function pluralize(name) {
+    for (const [singular, plural] of Object.entries(IRREGULAR_PLURALS)) {
+        if (name.toLowerCase() === singular) {
+            return name[0] === name[0]?.toUpperCase()
+                ? plural.charAt(0).toUpperCase() + plural.slice(1)
+                : plural;
+        }
+        const suffix = singular.charAt(0).toUpperCase() + singular.slice(1);
+        if (name.endsWith(suffix)) {
+            return (name.slice(0, -suffix.length) +
+                plural.charAt(0).toUpperCase() +
+                plural.slice(1));
+        }
+    }
+    if (name.endsWith("s"))
+        return name;
+    if (/[^aeiou]y$/i.test(name))
+        return `${name.slice(0, -1)}ies`;
+    if (/(x|z|ch|sh)$/i.test(name))
+        return `${name}es`;
+    return `${name}s`;
+}
+/** Strip a leading `has`/`is` verb from a field name (matching ke-graphql). */
+export function stripVerbPrefix(name) {
+    for (const prefix of ["has", "is"]) {
+        if (name.startsWith(prefix) &&
+            name.length > prefix.length &&
+            name[prefix.length] === name[prefix.length]?.toUpperCase()) {
+            const stripped = name.slice(prefix.length);
+            return stripped.charAt(0).toLowerCase() + stripped.slice(1);
+        }
+    }
+    return name;
+}
+/**
+ * The schema's page-size clamp for Relay connections. ke-graphql's
+ * `MAX_PAGE_SIZE`; stated explicitly on generated connection selections to make
+ * the fetched window visible. The schema clamps regardless, so an inlined value
+ * only affects the stated bound, never correctness.
+ */
+export const MAX_PAGE_SIZE = 100;
+//# sourceMappingURL=nameMap.js.map

package/dist/src/kernel/packs/graphql/nameMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameMap.js","sourceRoot":"","sources":["../../../../../src/kernel/packs/graphql/nameMap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yDAAyD;AACzD,MAAM,iBAAiB,GAA2B;IAChD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnE,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE;gBACvC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC,MAAM,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;gBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,IAAI,IAAI,CAAC;IACnD,OAAO,GAAG,IAAI,GAAG,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;QACnC,IACE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;YAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,EAC1D,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}

package/dist/src/kernel/packs/index.js

@@ -0,0 +1,34 @@
+/**
+ * The packs domain — declared stories become runnable verbs.
+ *
+ * One pipeline runs end to end inside this folder: a JSON pack declaration is
+ * parsed and validated, compiled into `VerbSpec`s, and given run bodies that
+ * resolve entities out of the graph and formatters that render them. The
+ * intermediate stages — the schema parser, the query/render/run-body builders,
+ * the entity resolver, the sampler, the glob expander — are steps in that
+ * pipeline, not services, and they stay off this barrel: a caller reaching for
+ * one of them is a caller reassembling the pipeline by hand, and the whole
+ * point of compiling a pack once is that nobody has to.
+ *
+ * What crosses the boundary is the pipeline's ends and the contracts naming
+ * them. `compilePack` is the entry the distribution and the config-story path
+ * both take. `validateStories` and `loadEffectiveModules` are the two ways
+ * third-party stories are admitted — the first screens records and reports
+ * every problem (which is how `doctor` reports a story the CLI drops rather
+ * than letting it vanish), the second is the full load the MCP server and the
+ * `capabilities` verb take. `resolvePackDetail` and `resolveUri` are the two
+ * decisions a pack's own reads defer to the runtime, and `verbKey` is the
+ * identity function every surface keys a verb by.
+ *
+ * `loadEffectiveModules` reads config and the answering pack behind DYNAMIC
+ * imports so a bare `--help` never pays for either; consumers reach it lazily
+ * today for exactly that reason, and routing it through this barrel statically
+ * would put the config reader back on the fast path.
+ */
+export { loadEffectiveModules, validateStories } from "./collect.js";
+export { compilePack } from "./compile.js";
+export { resolvePackDetail } from "./disclosure.js";
+export { resolveUri } from "./iri.js";
+export { distributionSource } from "./types.js";
+export { verbKey } from "./uniqueness.js";
+//# sourceMappingURL=index.js.map

package/dist/src/kernel/packs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kernel/packs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}