@canonical/pragma-cli 0.34.0 → 0.35.0

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

@@ -0,0 +1,369 @@
+/**
+ * The zod pack-definition validator — the single gate for DYNAMIC (config- and
+ * package-declared) packs and the parity round-trip tests. It replaces the old
+ * ~1,000-line hand validator with a schema plus a handful of cross-field
+ * refinements that encode the source rule (§3): `type` XOR `types`, a
+ * graphql-sourced lookup names its fragment target, SPARQL expands stay
+ * single-hop, GraphQL fields reject property paths, and every disclosure `level`
+ * names a declared canonical level. Two more refinements make the definition
+ * COMPILABLE, not merely well-shaped: distinct compiled verb names and distinct
+ * filter params (see {@link refineVerbNames} / {@link refineFilterParams}).
+ *
+ * zod lives here and ONLY here in the pack layer, imported lazily (never on the
+ * `--help`/`__complete` fast path). The distribution's own stories are compiled
+ * statically by `capabilities/distribution.ts` and never revalidated at dispatch
+ * (`collect.projectStoryTiers`'s default-origin carve-out); this runs for config-
+ * and package-declared stories, and in `distribution.test.ts`'s round-trip.
+ */
+import { z } from "zod";
+import { DETAIL_LEVELS, RECOVERY_CLI_PREFIX } from "../../constants.js";
+import { PragmaError } from "../error/index.js";
+const NOUN_PATTERN = /^[a-z][a-z0-9-]*$/;
+/** Message for {@link NOUN_PATTERN} — third-party authors never see the regex. */
+const NOUN_MESSAGE = 'must be lowercase kebab-case, e.g. "design-token"';
+const FILTER_PARAM_PATTERN = /^[a-z][a-z0-9]*$/;
+const FIELD_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const GRAPHQL_NAME_PATTERN = /^[_A-Za-z][_0-9A-Za-z]*$/;
+/**
+ * A prefixed name (`ds:Thing`), a property path of them, or an absolute IRI.
+ * Each path segment may carry the SPARQL inverse marker (`^ds:tier`) — the
+ * contract (`types.ts`) admits "prefixed name, IRI, or path", and an inverse
+ * step IS a property path, so rejecting it here was a schema bug, not a
+ * grammar decision (L-OPEN-9: the tier story's `blocks` expand reads
+ * `^ds:tier`).
+ */
+const TERM_PATTERN = /^(?:[A-Za-z][A-Za-z0-9+.-]*:\/\/[^<>"\s]+|\^?[A-Za-z][\w-]*:[^/<>"\s]+(?:\/\^?[A-Za-z][\w-]*:[^/<>"\s]+)*)$/;
+/** Params a filter/verb may not claim (they are the shared read vocabulary). */
+const RESERVED_PARAMS = new Set(["search", "detail", "name", "count"]);
+const term = z.string().regex(TERM_PATTERN, "must be a prefixed name or IRI");
+const graphqlName = z.string().regex(GRAPHQL_NAME_PATTERN);
+const fieldName = z.string().regex(FIELD_PATTERN);
+const columnSchema = z
+    .object({ field: fieldName, label: z.string().optional() })
+    .strict();
+const filterSchema = z
+    .object({
+    param: z.string().regex(FILTER_PARAM_PATTERN),
+    variable: fieldName,
+    values: z.array(z.string()).min(1).optional(),
+    description: z.string().optional(),
+})
+    .strict()
+    .refine((f) => !RESERVED_PARAMS.has(f.param), {
+    message: "filter param is a reserved name",
+});
+const searchSchema = z
+    .object({
+    variables: z.array(fieldName).min(1),
+    description: z.string().optional(),
+})
+    .strict();
+const emptyRecoverySchema = z
+    .object({
+    message: z.string().min(1),
+    // The command WITHOUT a binary name — the renderer prepends the CONSUMING
+    // distribution's. A story is portable only if it does not name a binary, so
+    // the old prefixed form is rejected rather than accepted and doubled. Named
+    // loudly, in the `packages` → `packs` tradition, because a third-party pack
+    // written against the old grammar is data, not a typo.
+    cli: z
+        .string()
+        .min(1)
+        .refine((value) => !value.startsWith(RECOVERY_CLI_PREFIX), `emptyRecovery.cli is now the command WITHOUT the binary name — write "sources update", not "${RECOVERY_CLI_PREFIX}sources update"`)
+        .optional(),
+})
+    .strict();
+const listShape = {
+    query: z.string().min(1),
+    columns: z.array(columnSchema).min(1),
+    filters: z.array(filterSchema).min(1).optional(),
+    search: searchSchema.optional(),
+    emptyRecovery: emptyRecoverySchema.optional(),
+};
+const listSchema = z.object(listShape).strict();
+const verbSchema = z
+    .object({
+    ...listShape,
+    verb: z.string().regex(NOUN_PATTERN, NOUN_MESSAGE),
+    description: z.string().optional(),
+    toolDescription: z.string().optional(),
+})
+    .strict();
+const fieldSchema = z
+    .object({
+    name: fieldName,
+    property: term,
+    label: z.string().optional(),
+    graphqlField: graphqlName.optional(),
+    level: z.string().optional(),
+})
+    .strict();
+const sectionSchema = fieldSchema.extend({
+    kind: z.enum(["field", "code"]).optional(),
+});
+const nestedExpandSchema = z
+    .object({
+    name: fieldName,
+    relation: term,
+    graphqlField: graphqlName.optional(),
+    select: z
+        .array(z
+        .object({
+        name: fieldName,
+        property: term,
+        label: z.string().optional(),
+        graphqlField: graphqlName.optional(),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+const expandFieldSchema = z
+    .object({
+    name: fieldName,
+    property: term,
+    label: z.string().optional(),
+    graphqlField: graphqlName.optional(),
+})
+    .strict();
+const expandSchema = z
+    .object({
+    name: fieldName,
+    heading: z.string().optional(),
+    kind: z.enum(["list", "table"]).optional(),
+    relation: term,
+    graphqlField: graphqlName.optional(),
+    select: z.array(z.union([nestedExpandSchema, expandFieldSchema])).min(1),
+    showWhenEmpty: z.boolean().optional(),
+    level: z.string().optional(),
+})
+    .strict();
+const disclosureSchema = z
+    .object({
+    levels: z.array(z.enum(DETAIL_LEVELS)).min(1),
+    default: z.enum(DETAIL_LEVELS).optional(),
+})
+    .strict()
+    .superRefine((disclosure, ctx) => {
+    // `default` must name a DECLARED level, not merely a canonical one — else the
+    // injected MCP `detail` enum offers only the declared levels while the
+    // advertised/resolved default is unselectable (compounds the divergence
+    // resolvePackDetail guards at runtime).
+    if (disclosure.default !== undefined &&
+        !disclosure.levels.includes(disclosure.default)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `disclosure default "${disclosure.default}" is not one of the declared levels [${disclosure.levels.join(", ")}].`,
+            path: ["default"],
+        });
+    }
+});
+const sampleSchema = z.union([
+    z.literal(true),
+    z
+        .object({
+        count: z.number().int().min(1).max(5).optional(),
+        fixedCount: z.boolean().optional(),
+        description: z.string().optional(),
+        toolDescription: z.string().optional(),
+    })
+        .strict(),
+]);
+const completionSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    match: z.enum(["prefix", "substring", "fuzzy"]).optional(),
+    minChars: z.number().int().min(0).optional(),
+})
+    .strict();
+const lookupSchema = z
+    .object({
+    source: z.enum(["sparql", "graphql"]).optional(),
+    by: term,
+    type: term.optional(),
+    description: z.string().optional(),
+    toolDescription: z.string().optional(),
+    types: z.array(term).min(1).optional(),
+    weights: z.record(term, z.number().min(0).max(1)).optional(),
+    graphqlType: graphqlName.optional(),
+    fields: z.array(fieldSchema).min(1).optional(),
+    sections: z.array(sectionSchema).min(1).optional(),
+    expand: z.array(expandSchema).min(1).optional(),
+    disclosure: disclosureSchema.optional(),
+    sample: sampleSchema.optional(),
+    completion: completionSchema.optional(),
+})
+    .strict();
+const definitionSchema = z
+    .object({
+    noun: z.string().regex(NOUN_PATTERN, NOUN_MESSAGE),
+    description: z.string().optional(),
+    toolDescription: z.string().optional(),
+    list: listSchema.optional(),
+    verbs: z.array(verbSchema).min(1).optional(),
+    lookup: lookupSchema.optional(),
+    colophon: z.string().optional(),
+})
+    .strict()
+    .superRefine((def, ctx) => {
+    if (!def.list && !def.lookup) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'a pack must declare at least one of "list" or "lookup".',
+        });
+    }
+    if (def.list &&
+        !/^\s*(?:PREFIX\s+[^\n]*\n\s*)*SELECT\s/i.test(def.list.query)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: '"list.query" must be a SPARQL SELECT query.',
+            path: ["list", "query"],
+        });
+    }
+    refineVerbNames(def, ctx);
+    if (def.list)
+        refineFilterParams(def.list.filters, ["list"], ctx);
+    for (const [index, verb] of (def.verbs ?? []).entries()) {
+        refineFilterParams(verb.filters, ["verbs", index], ctx);
+    }
+    if (def.lookup)
+        refineLookup(def.lookup, ctx);
+});
+/**
+ * The compiled `(noun, verb)` keys must be distinct.
+ *
+ * `compilePack` emits `list`, then each `verbs[].verb`, then `lookup` and
+ * `sample`. A repeat there survives the grammar into `assembleEffectiveModules`,
+ * where `assertUniqueVerbs` throws — and package stories reach dispatch before
+ * the command tree exists, so that throw would fail EVERY command, `doctor` and
+ * `sources update` included. The collision is a property of the definition, so
+ * the grammar is where it is caught.
+ */
+function refineVerbNames(def, ctx) {
+    const emitted = new Set(def.list ? ["list"] : []);
+    if (def.lookup) {
+        emitted.add("lookup");
+        if (def.lookup.sample)
+            emitted.add("sample");
+    }
+    const seen = new Set();
+    for (const [index, verb] of (def.verbs ?? []).entries()) {
+        if (emitted.has(verb.verb) || seen.has(verb.verb)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `verb "${verb.verb}" is already compiled by this pack — every verb must be distinct.`,
+                path: ["verbs", index, "verb"],
+            });
+        }
+        seen.add(verb.verb);
+    }
+}
+/**
+ * Filter params project to CLI options, so a repeat inside one list shape makes
+ * Commander refuse to register the second `--<param>` — outside every error
+ * envelope the CLI owns.
+ */
+function refineFilterParams(filters, path, ctx) {
+    const seen = new Set();
+    for (const [index, filter] of (filters ?? []).entries()) {
+        if (seen.has(filter.param)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `filter param "${filter.param}" is declared twice.`,
+                path: [...path, "filters", index, "param"],
+            });
+        }
+        seen.add(filter.param);
+    }
+}
+/** Cross-field lookup rules — the source rule (§3, F8). */
+function refineLookup(lookup, ctx) {
+    const source = lookup.source ?? "sparql";
+    if (lookup.type !== undefined && lookup.types !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: '"lookup.type" and "lookup.types" are mutually exclusive.',
+            path: ["lookup"],
+        });
+    }
+    // A weight naming a type the lookup does not address can never apply. Reject
+    // it rather than ignore it — a silent no-op is how a stale weight survives a
+    // rename (the type moves, the weight stays, and nothing says so).
+    const addressed = new Set(lookup.types ?? (lookup.type ? [lookup.type] : []));
+    for (const named of Object.keys(lookup.weights ?? {})) {
+        if (!addressed.has(named)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `"lookup.weights" names "${named}", which is not in "lookup.type"/"lookup.types".`,
+                path: ["lookup", "weights"],
+            });
+        }
+    }
+    if (source === "graphql" && !lookup.graphqlType && !lookup.type) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: '"lookup.source" "graphql" requires "lookup.graphqlType" (or a single "lookup.type" to derive it).',
+            path: ["lookup"],
+        });
+    }
+    const allValues = [...(lookup.fields ?? []), ...(lookup.sections ?? [])];
+    const declared = new Set(lookup.disclosure?.levels ?? []);
+    for (const value of allValues) {
+        if (value.level !== undefined && !declared.has(value.level)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `field "${value.name}" level "${value.level}" is not a declared disclosure level.`,
+                path: ["lookup"],
+            });
+        }
+        if (source === "graphql" &&
+            isPropertyPath(value.property) &&
+            !value.graphqlField) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `field "${value.name}" uses a property path, which the GraphQL source cannot express — set "graphqlField" or use source "sparql".`,
+                path: ["lookup"],
+            });
+        }
+    }
+    for (const expand of lookup.expand ?? []) {
+        if (expand.level !== undefined && !declared.has(expand.level)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `expand "${expand.name}" level "${expand.level}" is not a declared disclosure level.`,
+                path: ["lookup"],
+            });
+        }
+        for (const entry of expand.select) {
+            if ("relation" in entry && source !== "graphql") {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `expand "${expand.name}" nests a relation, which requires lookup.source "graphql" (the SPARQL expand sub-SELECT is single-hop).`,
+                    path: ["lookup"],
+                });
+            }
+        }
+    }
+}
+/** A term with a `/` join of prefixed names (never an absolute IRI). */
+function isPropertyPath(term) {
+    return term.includes("/") && !term.includes("://");
+}
+/**
+ * Validate a raw pack definition, throwing a config error on the first issue.
+ *
+ * @param raw - The untrusted definition (config/package JSON, or a test input).
+ * @param source - Where it came from, for error attribution.
+ * @returns The validated definition (shape-preserving — no injected defaults).
+ * @throws PragmaError CONFIG_ERROR describing the first violation.
+ */
+export function parsePackDefinition(raw, source) {
+    const result = definitionSchema.safeParse(raw);
+    if (!result.success) {
+        const issue = result.error.issues[0];
+        const path = issue?.path.join(".") ?? "<root>";
+        throw PragmaError.configError(`Invalid story in ${source} at ${path}: ${issue?.message ?? "unknown error"}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=schema.js.map

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

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

package/dist/src/kernel/packs/sparql/applyFilters.js

@@ -0,0 +1,68 @@
+/**
+ * Apply declared pack filters to resolved list rows.
+ *
+ * Filters are row predicates on projected SELECT variables — the author query is
+ * never modified, so user input cannot inject SPARQL and the query's ordering is
+ * preserved. With declared `values` the input is canonicalized against the set
+ * (NFC, case-insensitive) and rows are matched case-insensitively; without them
+ * the input is a free term matched the same way. A row lacking the variable never
+ * matches. Several filters combine conjunctively; several values for one
+ * filter (a repeated flag) combine as a union.
+ */
+import { PragmaError } from "../../error/index.js";
+/**
+ * @param rows - Rows produced by the pack's list query.
+ * @param filters - Declared filters (absent means no filtering).
+ * @param params - Story parameters as provided by the surface.
+ * @returns Rows matching every provided filter.
+ * @throws PragmaError INVALID_INPUT when a value is not in a filter's declared
+ *   set, or when a value-free filter receives a non-string value.
+ */
+export function applyPackFilters(rows, filters, params) {
+    let result = rows;
+    for (const filter of filters ?? []) {
+        const provided = params[filter.param];
+        if (provided === undefined)
+            continue;
+        // A repeated CLI flag accumulates into an array; MCP args stay scalar.
+        // Several values for ONE filter are a union (a row matches any of them);
+        // several filters still combine conjunctively.
+        const occurrences = Array.isArray(provided) ? provided : [provided];
+        if (occurrences.length === 0)
+            continue;
+        const values = filter.values;
+        const terms = occurrences.map((occurrence) => values === undefined
+            ? requireStringValue(occurrence, filter).toLowerCase()
+            : canonicalizeFilterValue(occurrence, filter, values).toLowerCase());
+        result = result.filter((row) => {
+            const cell = row[filter.variable]?.normalize("NFC").toLowerCase();
+            return cell !== undefined && terms.includes(cell);
+        });
+    }
+    return result;
+}
+/** @throws PragmaError INVALID_INPUT when a value-free filter value is not a string. */
+function requireStringValue(provided, filter) {
+    if (typeof provided !== "string") {
+        throw PragmaError.invalidInput(filter.param, String(provided), {
+            recovery: { message: `Provide a string value for --${filter.param}.` },
+        });
+    }
+    return provided.trim().normalize("NFC");
+}
+/** @throws PragmaError INVALID_INPUT when the value is not in the declared set. */
+function canonicalizeFilterValue(provided, filter, values) {
+    if (typeof provided === "string") {
+        const normalized = provided.trim().normalize("NFC");
+        const match = values.find((value) => value.normalize("NFC").toLowerCase() === normalized.toLowerCase());
+        if (match !== undefined)
+            return match.normalize("NFC");
+    }
+    throw PragmaError.invalidInput(filter.param, String(provided), {
+        validOptions: [...values],
+        recovery: {
+            message: `Allowed values for --${filter.param}: ${values.join(", ")}.`,
+        },
+    });
+}
+//# sourceMappingURL=applyFilters.js.map

package/dist/src/kernel/packs/sparql/applyFilters.js.map

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

package/dist/src/kernel/packs/sparql/applySearch.js

@@ -0,0 +1,25 @@
+/**
+ * Apply a pack list's free-text search to resolved rows.
+ *
+ * Like filters, search runs AFTER the author query, so user input never touches
+ * the query text (injection-safe) and the author's ORDER BY is preserved. The
+ * term is NFC-normalized and matched case-insensitively; a row passes when ANY
+ * declared variable contains it as a substring. A non-string or empty term is a
+ * no-op.
+ */
+/**
+ * @param rows - Rows produced by the pack's list query (post-filter).
+ * @param search - The declared search (absent means no searching).
+ * @param params - Story parameters as provided by the surface.
+ * @returns Rows containing the term in at least one searched variable.
+ */
+export function applyPackSearch(rows, search, params) {
+    const provided = params.search;
+    if (search === undefined || typeof provided !== "string")
+        return rows;
+    const term = provided.trim().normalize("NFC").toLowerCase();
+    if (term === "")
+        return rows;
+    return rows.filter((row) => search.variables.some((variable) => row[variable]?.normalize("NFC").toLowerCase().includes(term)));
+}
+//# sourceMappingURL=applySearch.js.map

package/dist/src/kernel/packs/sparql/applySearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applySearch.js","sourceRoot":"","sources":["../../../../../src/kernel/packs/sparql/applySearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAe,EACf,MAA8B,EAC9B,MAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACzB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC7D,CACF,CAAC;AACJ,CAAC"}