@canonical/pragma-cli 0.34.0 → 0.35.0

package/dist/src/capabilities/sources/runUpdate.js

@@ -0,0 +1,394 @@
+/**
+ * Build the `sources update` Task.
+ *
+ * Two modes, chosen by `runtime.mutation.preview`:
+ *
+ * - Preview (CLI `--dry-run`, or MCP without `confirm`): NETWORK-FREE. It reads
+ *   only the config, then hands back a plan-only Task listing the refs it would
+ *   resolve+build and the pointer it would write — no git fetch, no compile, no
+ *   cache write. This is what a dry-run / agent "preview" must be: side-effect
+ *   free and offline-safe.
+ * - Real execution: the heavy work — resolve every configured pack (git
+ *   clone/fetch, file verify, npm resolve), then build the ONE combined
+ *   content-addressed pack — runs eagerly (it is not expressible as a task
+ *   effect: the effect set is fs + exec, and the in-process compile is not an
+ *   effect at all). The returned Task models the mutations: the active-pack
+ *   pointer write (undo restores or removes the prior pointer) and the package
+ *   skill symlinks.
+ *
+ * Pinning a revision is the ref's job, not a flag's: put a SHA in the source
+ * (`git+https://…#<sha>`) and every update resolves to exactly that commit.
+ */
+import { $, deleteFile, gen, info, mkdir, symlink, writeFile, } from "@canonical/task";
+import { VERSION } from "../../constants.js";
+import { cliRecovery, PragmaError } from "../../kernel/error/index.js";
+// DIRECT LEAF IMPORT, not `graphpack/index.js`. The barrel re-exports
+// `embedded.ts`, which statically imports the ~1.9 MB generated pack — and
+// with per-file `tsc` output ESM evaluates that re-export when this module
+// loads. `sources update` builds a USER pack; it must not pay the embedded
+// pack's cost to do it.
+import { buildPack } from "../../kernel/runtime/graphpack/build.js";
+import { activePackPath, readActivePack } from "../../kernel/runtime/paths.js";
+import { detectPrefixClashes, harvestPrefixes, parsePackDeclaration, redactUrl, resolvePackage, } from "../../kernel/runtime/refs/index.js";
+import { installedSkillsDir } from "../skill/discover.js";
+import { planSkillInstall } from "./installSkills.js";
+/** Generic-core prefixes; config `prefixes` merge over them (config wins). */
+const CORE_PREFIXES = {
+    rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+    rdfs: "http://www.w3.org/2000/01/rdf-schema#",
+    owl: "http://www.w3.org/2002/07/owl#",
+    xsd: "http://www.w3.org/2001/XMLSchema#",
+    skos: "http://www.w3.org/2004/02/skos/core#",
+    sh: "http://www.w3.org/ns/shacl#",
+    dcterms: "http://purl.org/dc/terms/",
+};
+/**
+ * The prefix map a pack is built with: core < the packs' own `@prefix` < config.
+ *
+ * A resolved package's own declarations are harvested from its TTL (ke does not
+ * fold parsed-Turtle prefixes into `store.prefixes`) and merged beneath config
+ * so the index compacts pack URIs to `pfx:Local` — the FROZEN `{name,type}`
+ * token contract — while config still wins any clash. The merged map is
+ * persisted in the manifest, so boot reads the same names.
+ *
+ * Exported because the bundler (`scripts/bundle.ts`) compiles the embedded pack
+ * through this exact precedence. If the two pipelines computed prefixes
+ * separately, the embed could compact entities differently from what the SAME
+ * config produces on a user's machine — a silent divergence in entity names.
+ *
+ * @param inputs - The resolved packages' labelled RDF sources.
+ * @param configPrefixes - The config layer's `prefixes`, if any.
+ * @returns The merged prefix map to build with.
+ */
+export function buildPackPrefixes(inputs, configPrefixes) {
+    return {
+        ...CORE_PREFIXES,
+        ...harvestPrefixes(inputs),
+        ...(configPrefixes ?? {}),
+    };
+}
+/**
+ * Build the NETWORK-FREE preview plan for `sources update`.
+ *
+ * A plan-only Task: it reads the config to list the refs a real update would
+ * resolve and build, then models the project mutation (the active-pack pointer
+ * write) as effects the dry-run interpreter can describe WITHOUT running them.
+ * No git, no compile, no cache write — so `--dry-run` and an MCP plan-first call
+ * are offline-safe. Config refs are parsed (a cheap, offline validity check) but
+ * never resolved.
+ *
+ * @param runtime - The per-invocation runtime.
+ * @returns A plan-only Task describing the intended effects.
+ */
+async function buildUpdatePlan(runtime) {
+    const layers = await runtime.loadConfig();
+    const entries = layers.config.packs ?? [];
+    const refs = entries.map(parsePackDeclaration);
+    const data = {
+        contentHash: "",
+        reused: false,
+        packs: refs.map((ref) => ({
+            name: ref.pkg,
+            resolved: "",
+            sourceCount: 0,
+            storyCount: 0,
+        })),
+    };
+    return gen(function* () {
+        yield* $(info(refs.length > 0
+            ? `Resolve and build ${refs.length} pack(s): ${refs.map((ref) => ref.source).join(", ")}`
+            : "No packs configured — the embedded pack answers store reads"));
+        // The project mutation, previewed (dry-run never executes it). The content
+        // is a placeholder: the real hash only exists once the build has run.
+        yield* $(writeFile(activePackPath(runtime.cwd), "(the pack hash, on execute)"));
+        return data;
+    });
+}
+/**
+ * Resolve, build, and produce the pointer-writing Task — or, for a preview, the
+ * network-free plan.
+ *
+ * @param runtime - The per-invocation runtime.
+ * @param skipInvalid - Drop sources that fail to parse (warning about each)
+ *   rather than failing the whole update.
+ * @returns A Task that points the project at the built pack and returns the
+ *   update result.
+ * @note Impure — resolves packages (may hit git) and builds the pack eagerly,
+ *   UNLESS `runtime.mutation.preview` is set, in which case it stays offline.
+ */
+export async function buildUpdateTask(runtime, skipInvalid = false) {
+    if (runtime.mutation?.preview)
+        return buildUpdatePlan(runtime);
+    // Progress seam (U7/U11): stream stage lines while the heavy EAGER work — the
+    // clone/parse/build below — runs, so the long op is never silent. Unset over
+    // MCP (a no-op there); `--verbose` adds a line per source (U11).
+    const report = runtime.report;
+    const verbose = runtime.globalFlags.verbose;
+    const layers = await runtime.loadConfig();
+    const entries = layers.config.packs ?? [];
+    const priorHash = readActivePack(runtime.cwd);
+    const resolved = [];
+    for (const entry of entries) {
+        const ref = parsePackDeclaration(entry);
+        report?.(resolveProgress(ref));
+        resolved.push({
+            kind: ref.kind,
+            ...(await resolvePackage(ref, { cwd: runtime.cwd })),
+        });
+    }
+    const inputs = resolved.flatMap((pkg) => pkg.sources);
+    // The packages' own `stories/*.json`, carried into the pack verbatim (see
+    // graphpack/types.STORIES_FILE). Raw text: nothing interprets them here.
+    const stories = resolved.flatMap((pkg) => pkg.stories);
+    // Refuse to build an empty store (A4). A package that ships no `.ttl` (or no
+    // configured packs at all) would build a 0-triple pack whose empty
+    // `data.nq` fails the completeness gate — so the "successful" update boots to
+    // a PERMANENT `STORE_UNAVAILABLE` loop. Fail loudly here, leaving the embedded
+    // pack (or the prior build) answering reads, instead of pointing at that one.
+    if (inputs.length === 0) {
+        throw PragmaError.configError(entries.length === 0
+            ? "No packs are configured, so there are no sources to build a store from. The embedded pack answers reads until you add a pack."
+            : `The ${entries.length} configured pack(s) resolved 0 RDF sources (no definitions/**.ttl or data/**.ttl). Refusing to build an empty store.`, {
+            recovery: cliRecovery("sources update --verbose", "Add a pack that ships `.ttl` under definitions/ or data/, then re-run."),
+        });
+    }
+    const prefixes = buildPackPrefixes(inputs, layers.config.prefixes);
+    // Warn on conflicting `@prefix` declarations across packages (A5): last-wins
+    // is silent otherwise, compacting the losing package's URIs to the wrong
+    // prefix. Display-only, so a warning (not a hard failure) is the right call.
+    for (const clash of detectPrefixClashes(inputs)) {
+        report?.(`Prefix "${clash.label}:" is declared with conflicting IRIs across packs (${clash.iris.join(" vs ")}); last wins, so some entities may compact to the wrong prefix.`);
+    }
+    report?.(`Building store from ${inputs.length} source(s)`);
+    if (verbose)
+        for (const input of inputs)
+            report?.(`  parse ${input.path}`);
+    if (stories.length > 0)
+        report?.(`Carrying ${stories.length} pack read story file(s)`);
+    // Build the pack. On a parse/build failure, classify it as a NAMED data error
+    // (U6) — not INTERNAL_ERROR's "report this issue" — identifying the
+    // offending package source, since ke's parser error carries only line/column.
+    // With `--skip-invalid`, drop the unparseable sources (warning LOUDLY about
+    // each — never a silent partial graph) and build from the rest instead of
+    // failing the whole update.
+    // `<name>@<kind>:<resolved>` — the SAME provenance label the bundler writes
+    // for the embed, so the manifest field means one thing whoever built the pack,
+    // and `sources status` / `doctor` can still answer "which revision is my store
+    // built from?" now that no lock records it. A `file:` pack resolves to a local
+    // PATH rather than a revision, so it contributes its name alone: a machine
+    // path is not provenance, and `sources status` already lists the ref.
+    const sourceRef = resolved
+        .map((pkg) => pkg.kind === "file"
+        ? pkg.name
+        : `${pkg.name}@${pkg.kind}:${pkg.resolved}`)
+        .join(", ") || "embedded";
+    let built;
+    try {
+        built = await buildPack(inputs, {
+            name: "pragma",
+            version: VERSION,
+            sourceRef,
+            prefixes,
+            stories,
+        });
+    }
+    catch (error) {
+        if (!skipInvalid)
+            throw await classifySourceBuildError(error, inputs);
+        const bad = await collectBadSources(inputs);
+        // A build failure not attributable to a single unparseable source (e.g. a
+        // cross-file conflict) can't be skipped away — surface the named error.
+        if (bad.length === 0)
+            throw await classifySourceBuildError(error, inputs);
+        const badPaths = new Set(bad.map((entry) => entry.path));
+        const usableInputs = inputs.filter((input) => !badPaths.has(input.path));
+        for (const entry of bad)
+            report?.(`  skipped invalid source ${entry.path}: ${entry.message}`);
+        report?.(`Skipped ${bad.length} invalid source(s); building from ${usableInputs.length} of ${inputs.length}`);
+        if (usableInputs.length === 0)
+            throw PragmaError.configError(`None of the ${inputs.length} configured source(s) can be parsed — nothing to build.`, {
+                recovery: cliRecovery("sources update --verbose", "Fix the reported sources, then re-run."),
+            });
+        try {
+            built = await buildPack(usableInputs, {
+                name: "pragma",
+                version: VERSION,
+                sourceRef,
+                // Re-harvest prefixes from only the sources that survived, so a dropped
+                // file's declarations don't skew compaction.
+                prefixes: buildPackPrefixes(usableInputs, layers.config.prefixes),
+                stories,
+            });
+        }
+        catch (rebuildError) {
+            throw await classifySourceBuildError(rebuildError, usableInputs);
+        }
+    }
+    report?.(`${built.reused ? "Reused" : "Built"} store ${built.contentHash.slice(0, 12)}`);
+    // Refuse a 0-triple build (A4): non-empty sources can still parse to no
+    // triples (e.g. comment-only TTL, or a file of only `@prefix` lines). Pointing
+    // the project at an empty pack boots to the same `STORE_UNAVAILABLE` loop, so
+    // treat it as a data error rather than a silent "success". (A manifest
+    // predating the triple count is left alone — `undefined` never trips this.)
+    if (built.manifest.tripleCount === 0) {
+        throw PragmaError.configError(`The configured sources parsed to 0 RDF triples, so the store would be empty. Refusing to build an empty store.`, {
+            recovery: cliRecovery("sources update --verbose", "Check that the pack sources actually contain RDF triples, then re-run."),
+        });
+    }
+    const path = activePackPath(runtime.cwd);
+    const data = {
+        contentHash: built.contentHash,
+        reused: built.reused,
+        packs: resolved.map((pkg) => ({
+            name: pkg.name,
+            resolved: pkg.resolved,
+            sourceCount: pkg.sources.length,
+            storyCount: pkg.stories.length,
+        })),
+    };
+    const undo = priorHash !== undefined ? writeFile(path, priorHash) : deleteFile(path);
+    // Install package-provided skills (U10): symlink each resolved package's
+    // `skills/*` into the installed-skills root, so `skill list` / `setup skills`
+    // see them after an update — and RETIRE the links of skills those packages
+    // have since dropped, which the same plan reports as `pruned`. Kept in this
+    // Task (reversible: a created link carries an unlink undo, a pruned one a
+    // re-link undo) so `sources update --undo` restores the root as it was.
+    //
+    // The two are split, not counted together: a prune is a deletion, so folding
+    // it into "Installing N skill(s)" would report a removal as an install.
+    const skillPlan = planSkillInstall(resolved);
+    const skillLinks = skillPlan.filter((link) => link.action === "created" || link.action === "replaced");
+    const staleLinks = skillPlan.filter((link) => link.action === "pruned");
+    if (skillLinks.length > 0)
+        report?.(`Installing ${skillLinks.length} skill(s)`);
+    if (staleLinks.length > 0)
+        report?.(`Removing ${staleLinks.length} skill link(s) no longer provided by any package`);
+    report?.(`Pointing ${runtime.cwd} at pack ${built.contentHash.slice(0, 12)}`);
+    return gen(function* () {
+        yield* $(writeFile(path, built.contentHash, { undo }));
+        if (skillLinks.length > 0) {
+            yield* $(mkdir(installedSkillsDir(), true));
+            for (const link of skillLinks) {
+                if (link.action === "replaced")
+                    yield* $(deleteFile(link.linkPath));
+                yield* $(symlink(link.target, link.linkPath, {
+                    undo: deleteFile(link.linkPath),
+                }));
+            }
+        }
+        // No `mkdir` guard here: a stale link can only have been enumerated FROM
+        // the installed root, so the root necessarily exists.
+        //
+        // The undo re-creates the link exactly as found — dangling target and all —
+        // because undo's job is to restore the prior state, not to improve on it. It
+        // clears the path first because the undo interpreter MOCKS forward effects
+        // when collecting: the delete above may never have run, and `fs.symlink`
+        // refuses a path that already exists. Same delete-then-link shape the
+        // `replaced` branch above uses, for the same reason.
+        for (const stale of staleLinks) {
+            yield* $(deleteFile(stale.linkPath, {
+                undo: gen(function* () {
+                    yield* $(deleteFile(stale.linkPath));
+                    yield* $(symlink(stale.target, stale.linkPath));
+                }),
+            }));
+        }
+        return data;
+    });
+}
+/** Progress line for a package about to be resolved, phrased by ref kind. */
+function resolveProgress(ref) {
+    switch (ref.kind) {
+        case "git":
+            return `Cloning ${ref.pkg} from ${redactUrl(ref.url)}`;
+        case "file":
+            return `Reading ${ref.pkg} from ${ref.path}`;
+        case "npm":
+            return `Resolving ${ref.pkg}`;
+    }
+}
+/**
+ * Classify a pack-build failure as a NAMED data error (U6).
+ *
+ * ke/Oxigraph parses each source's Turtle, but its thrown parser error carries
+ * only the line/column — NOT which source produced it (it sees a content string,
+ * not a path). So on failure we re-parse each source in ISOLATION to find the
+ * first that throws — the culprit — and raise a `CONFIG_ERROR` naming its
+ * `pkg/relative-path` with the parser's own message and an actionable recovery.
+ * This runs only on the error path, so the per-source re-parse cost is paid once.
+ * A `PragmaError` from resolution (e.g. a missing file) is already classified and
+ * passes through untouched.
+ *
+ * @param error - The value thrown by `buildPack`.
+ * @param inputs - The labelled sources handed to the build.
+ * @returns A classified {@link PragmaError} (never INTERNAL_ERROR for bad data).
+ */
+export async function classifySourceBuildError(error, inputs) {
+    if (error instanceof PragmaError)
+        return error;
+    const parserMessage = error instanceof Error ? error.message : String(error);
+    const culprit = await isolateBadSource(inputs);
+    const detail = culprit?.message ?? parserMessage;
+    const where = culprit
+        ? `Pack source "${culprit.path}" cannot be parsed`
+        : "The configured packs cannot be built into a store";
+    return PragmaError.configError(`${where}: ${detail}`, {
+        recovery: cliRecovery("sources update --verbose", "Re-run with --verbose to see each file as it parses. If a pack ships malformed RDF, report it to that pack's maintainer."),
+    });
+}
+/**
+ * Re-parse each source alone to find the first that fails to parse.
+ *
+ * @param inputs - The labelled sources.
+ * @returns The offending source's path + parser message, or `undefined` if none
+ *   fails in isolation (a build failure unrelated to a single bad source).
+ * @note Impure — boots a throwaway ke store per source; error path only.
+ */
+async function isolateBadSource(inputs) {
+    const { createStore } = await import("@canonical/ke");
+    for (const input of inputs) {
+        try {
+            const store = await createStore({
+                sources: [{ content: input.content, path: input.path }],
+            });
+            store.dispose();
+        }
+        catch (error) {
+            return {
+                path: input.path,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    return undefined;
+}
+/**
+ * Re-parse each source in isolation and collect EVERY one that fails to parse.
+ *
+ * Backs `--skip-invalid`: {@link isolateBadSource} returns just the first
+ * culprit (for the error message), whereas the skip path needs the full set to
+ * drop before rebuilding. Error path only — one throwaway ke store per source.
+ *
+ * @param inputs - The labelled sources.
+ * @returns Every source that fails to parse alone, with its parser message.
+ */
+async function collectBadSources(inputs) {
+    const { createStore } = await import("@canonical/ke");
+    const bad = [];
+    for (const input of inputs) {
+        try {
+            const store = await createStore({
+                sources: [{ content: input.content, path: input.path }],
+            });
+            store.dispose();
+        }
+        catch (error) {
+            bad.push({
+                path: input.path,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return bad;
+}
+//# sourceMappingURL=runUpdate.js.map

package/dist/src/capabilities/sources/runUpdate.js.map

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

package/dist/src/capabilities/sources/status.render.js

@@ -0,0 +1,64 @@
+/**
+ * Formatters for `pragma sources status` — plain, llm, json.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { defaultStyle } from "../../kernel/render/style.js";
+/**
+ * The headline for each boot decision. The `embedded` case names the update
+ * explicitly: the distribution's snapshot answers reads, but it is a snapshot,
+ * so reporting it as "up to date" would be a lie.
+ */
+const STORE_HEADLINE = {
+    built: "ready",
+    embedded: `embedded snapshot (run \`${BIN_NAME} sources update\` to build from the configured packs)`,
+    unavailable: `not built (run \`${BIN_NAME} sources update\`)`,
+};
+/**
+ * Render `sources status` as plain text.
+ *
+ * @param data - The resolved sources-status payload.
+ * @param style - TTY styling; defaults to the process style. On a color-capable
+ *   terminal the `Sources:` heading is bold, source names align into a column,
+ *   and each configured ref is dimmed; off a TTY the styler is inert, so the
+ *   output is byte-identical to the plain form.
+ * @returns The formatted status block.
+ */
+export function renderSourcesStatusPlain(data, style = defaultStyle()) {
+    const lines = [`Store: ${STORE_HEADLINE[data.store]}`];
+    if (data.contentHash !== null) {
+        lines.push(`  pack: ${data.contentHash.slice(0, 12)} — ${data.entityCount ?? "?"} entities, built ${data.builtAt ?? "?"}`, `  from: ${data.sourceRef ?? "?"}`);
+    }
+    lines.push("", style.enabled ? style.bold("Sources:") : "Sources:");
+    if (data.sources.length === 0) {
+        lines.push("  (none configured)");
+    }
+    const nameWidth = style.enabled
+        ? Math.max(0, ...data.sources.map((source) => source.name.length))
+        : 0;
+    for (const source of data.sources) {
+        lines.push(style.enabled
+            ? `  ${source.name.padEnd(nameWidth)}  ${style.dim(source.ref)}`
+            : `  ${source.name}  ${source.ref}`);
+    }
+    return lines.join("\n");
+}
+export const statusFormatters = {
+    plain(data) {
+        return renderSourcesStatusPlain(data);
+    },
+    llm(data) {
+        const lines = [`# sources`, `- Store: ${data.store}`];
+        if (data.sourceRef !== null)
+            lines.push(`- From: ${data.sourceRef}`);
+        if (data.entityCount !== null)
+            lines.push(`- Entities: ${data.entityCount}`);
+        for (const source of data.sources) {
+            lines.push(`- ${source.name}: ${source.ref}`);
+        }
+        return lines.join("\n");
+    },
+    json(data) {
+        return JSON.stringify(data);
+    },
+};
+//# sourceMappingURL=status.render.js.map

package/dist/src/capabilities/sources/status.render.js.map

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

package/dist/src/capabilities/sources/status.verb.js

@@ -0,0 +1,40 @@
+/**
+ * The `sources status` verb — a storeless read.
+ *
+ * `needsStore: false` is load-bearing: status must report even a cold or
+ * unbuilt store (`store: "unavailable"`), so it must NOT boot the store —
+ * booting a cold store would throw STORE_UNAVAILABLE before status could say
+ * so. Its `run` is a lazy thunk (the collector is dynamic-imported), keeping
+ * the config reader off the fast path, exactly like `info`.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { statusFormatters } from "./status.render.js";
+/** The `sources status` verb spec. */
+export const statusVerb = {
+    path: ["sources", "status"],
+    summary: "Report which pack answers reads, and the packs it was built from.",
+    doc: "Storeless — reads config and the pack cache without booting the store, so it works even when the store is cold. Reports whether reads are answered by a locally built pack, by the embedded snapshot, or not at all.",
+    params: [],
+    output: { formatters: statusFormatters },
+    examples: [
+        {
+            cmd: `${BIN_NAME} sources status`,
+            note: "human-readable readiness summary",
+        },
+        {
+            cmd: `${BIN_NAME} sources status --format json`,
+            note: "the full envelope",
+        },
+    ],
+    capability: {
+        needsStore: false,
+        mutates: false,
+        needsNetwork: false,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (_params, runtime) => import("./collectStatus.js").then((module) => module.collectStatus(runtime)),
+};
+//# sourceMappingURL=status.verb.js.map

package/dist/src/capabilities/sources/status.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/status.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,mEAAmE;IAC5E,GAAG,EAAE,sNAAsN;IAC3N,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,GAAG,QAAQ,iBAAiB;YACjC,IAAI,EAAE,kCAAkC;SACzC;QACD;YACE,GAAG,EAAE,GAAG,QAAQ,+BAA+B;YAC/C,IAAI,EAAE,mBAAmB;SAC1B;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK;QACnB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3C,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAC9B;CACJ,CAAC"}

package/dist/src/capabilities/sources/types.js

@@ -0,0 +1,6 @@
+/**
+ * Data shapes for the `sources` noun — `status` (storeless read) and `update`
+ * (the Task that resolves, builds, and points the project at a pack).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/capabilities/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/capabilities/sources/update.render.js

@@ -0,0 +1,34 @@
+/**
+ * Formatters for `pragma sources update` — plain, llm, json.
+ */
+export const updateFormatters = {
+    plain(data) {
+        const lines = [
+            data.reused
+                ? `Store up to date (pack ${data.contentHash.slice(0, 12)}).`
+                : `Built pack ${data.contentHash.slice(0, 12)}.`,
+        ];
+        for (const pack of data.packs) {
+            // FILES, not usable stories: `sources update` carries them verbatim and
+            // never validates them (zod would have to run per record, in the build).
+            // `doctor` is where "2 stories ignored" comes from — saying "stories"
+            // here would put a green count next to a broken file.
+            const stories = pack.storyCount > 0
+                ? `, ${pack.storyCount} story file${pack.storyCount === 1 ? "" : "s"}`
+                : "";
+            lines.push(`  ${pack.name} @ ${pack.resolved.slice(0, 12)} (${pack.sourceCount} source${pack.sourceCount === 1 ? "" : "s"}${stories})`);
+        }
+        return lines.join("\n");
+    },
+    llm(data) {
+        return [
+            `# sources update`,
+            `- Pack: ${data.contentHash.slice(0, 12)}${data.reused ? " (reused)" : ""}`,
+            ...data.packs.map((pack) => `- ${pack.name}: ${pack.resolved}`),
+        ].join("\n");
+    },
+    json(data) {
+        return JSON.stringify(data);
+    },
+};
+//# sourceMappingURL=update.render.js.map

package/dist/src/capabilities/sources/update.render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.render.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/update.render.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,MAAM;gBACT,CAAC,CAAC,0BAA0B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;gBAC7D,CAAC,CAAC,cAAc,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG;SACnD,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,wEAAwE;YACxE,yEAAyE;YACzE,sEAAsE;YACtE,sDAAsD;YACtD,MAAM,OAAO,GACX,IAAI,CAAC,UAAU,GAAG,CAAC;gBACjB,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,cAAc,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;gBACtE,CAAC,CAAC,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CACR,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,WAAW,UAAU,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,GAAG,CAC5H,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,IAAI;QACN,OAAO;YACL,kBAAkB;YAClB,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3E,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;SAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,IAAI,CAAC,IAAI;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/dist/src/capabilities/sources/update.verb.js

@@ -0,0 +1,55 @@
+/**
+ * The `sources update` verb — resolve the configured packs, build the store,
+ * and point the project at it.
+ *
+ * A mutation (`mutates: true`) that needs the network (`needsNetwork: true`)
+ * but NOT the pre-booted store (`needsStore: false`): update is what *creates*
+ * the store, so the dispatcher must not try to boot it first (a cold boot would
+ * throw STORE_UNAVAILABLE). `run` returns a `Promise<Task<R>>` — the union's
+ * third arm — which the dispatcher awaits: for a real execution it resolves and
+ * builds before handing back the pointer-writing Task; for a preview
+ * (`runtime.mutation.preview`) it stays network-free and hands back a
+ * plan-only Task.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { updateFormatters } from "./update.render.js";
+/** The `sources update` verb spec. */
+export const updateVerb = {
+    path: ["sources", "update"],
+    summary: "Resolve configured packs and build the local store from them.",
+    doc: "Resolves each configured pack (git/file/npm) and builds one content-addressed pack, which every later boot reads with no network access. Pin a revision by putting a commit SHA in the pack's source ref.",
+    params: [
+        {
+            kind: "boolean",
+            name: "skipInvalid",
+            doc: "Skip sources that fail to parse (warning about each) and build from the rest, instead of failing the whole update.",
+        },
+    ],
+    output: { formatters: updateFormatters },
+    examples: [
+        { cmd: `${BIN_NAME} sources update`, note: "resolve and build" },
+        {
+            cmd: `${BIN_NAME} sources update --skip-invalid`,
+            note: "build from the parseable sources, warning about any dropped",
+        },
+    ],
+    capability: {
+        needsStore: false,
+        mutates: true,
+        needsNetwork: true,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: false, openWorldHint: true },
+        },
+    },
+    // `run` really returns `Promise<Task<R>>`: `buildUpdateTask` awaits config
+    // (and, on a real execution, resolves + builds) before handing back the
+    // pointer-writing Task — or, when `runtime.mutation.preview` is set, a
+    // network-free plan Task. The dispatcher and MCP handler both `await` this
+    // promise into a `Task`. The `VerbSpec.run` union is deliberately two-armed
+    // (`Promise<R> | Task<R>`) — a third `Promise<Task<R>>` arm would poison async
+    // read-verb inference — so the awaited-away Promise is presented through the
+    // `Task<R>` arm by this single, honest cast.
+    run: (params, runtime) => import("./runUpdate.js").then((module) => module.buildUpdateTask(runtime, params.skipInvalid === true)),
+};
+//# sourceMappingURL=update.verb.js.map

package/dist/src/capabilities/sources/update.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/update.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,+DAA+D;IACxE,GAAG,EAAE,2MAA2M;IAChN,MAAM,EAAE;QACN;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,oHAAoH;SAC1H;KACF;IACD,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE;QAChE;YACE,GAAG,EAAE,GAAG,QAAQ,gCAAgC;YAChD,IAAI,EAAE,6DAA6D;SACpE;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;SAC1D;KACF;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,+EAA+E;IAC/E,6EAA6E;IAC7E,6CAA6C;IAC7C,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACvB,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CACvB;CAC1C,CAAC"}

package/dist/src/capabilities/upgrade/index.js

@@ -0,0 +1,5 @@
+/**
+ * The `upgrade` capability barrel.
+ */
+export { upgradeModule } from "./upgrade.verb.js";
+//# sourceMappingURL=index.js.map