@xemahq/edition-tooling 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,175 @@
+Xema Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:  Neuralchowder Inc.
+
+Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc.
+
+  The Licensed Work includes, without limitation, Xema Core, Xema Runtime,
+  Xema Kernel, Xema control plane, Xema application runtime, Xema biome
+  runtime, Xema biome registry, Xema store services, Xema orchestration
+  services, Xema agents, Xema skills, Xema memory services, Xema APIs, Xema
+  user interfaces, Xema command-line tools, Xema deployment artifacts, Xema
+  templates, Xema specifications, Xema schemas, Xema manifests, Xema
+  documentation, Xema examples, and all source code, object code, binaries,
+  packages, modules, configuration files, manifests, schemas, examples,
+  templates, documentation, and derivative works included in or distributed
+  as part of the Xema software project.
+
+  The Licensed Work does not include any third-party software, libraries,
+  dependencies, packages, assets, or components that are distributed with the
+  Licensed Work but are governed by their own separate license terms. Such
+  third-party materials remain subject to their respective licenses.
+
+  A specific file, package, component, or directory may state that it is
+  governed by a different license. In that case, that specific file, package,
+  component, or directory is governed by the license expressly stated therein.
+
+Additional Use Grant:
+
+  You may make production use of the Licensed Work, provided that your use
+  does not include offering, providing, making available, distributing,
+  hosting, managing, embedding, reselling, white-labeling, sublicensing,
+  commercializing, or otherwise making the Licensed Work, or any modified
+  version or derivative work of the Licensed Work, available to Third Parties
+  as part of a Competitive Offering.
+
+The following definitions and clarifications form part of, and govern
+the interpretation of, the Additional Use Grant set out above.
+
+  1. "Production Use" means any use of the Licensed Work other than for
+     development, testing, evaluation, demonstration, experimentation,
+     benchmarking, or other non-production purposes.
+
+  2. "Affiliate" means any entity that, directly or indirectly,
+     controls, is controlled by, or is under common control with you,
+     where "control" means ownership of more than fifty percent (50%) of
+     the voting interests of the entity, or the power to direct its
+     management.
+
+  3. "Third Party" means any natural person or legal entity other than
+     you and your Affiliates.
+
+  4. "Competitive Offering" means any product or service, made available
+     to one or more Third Parties for a fee or other consideration
+     (including without limitation on a paid, subscription,
+     advertising-supported, hosted, or managed-service basis), that is
+     offered or marketed as, or that competes with, a software platform,
+     runtime, orchestration system, agent or automation system,
+     extension or distribution marketplace, or other software system
+     that provides, in substantial part, the same or substantially
+     similar capabilities as those provided by the Licensed Work. A
+     product or service is a Competitive Offering whether the Licensed
+     Work is provided in whole or in part, alone or bundled with other
+     software, and whether modified or unmodified.
+
+  5. Providing, hosting, or managing the Licensed Work for a Third Party,
+     or otherwise making the Licensed Work available to a Third Party as
+     a hosted or managed service such that the Third Party obtains the
+     principal value or functionality of the Licensed Work, is a
+     Competitive Offering and is not permitted by the Additional Use
+     Grant.
+
+  6. Subject to the foregoing, the Additional Use Grant permits you to
+     make Production Use of the Licensed Work for your own internal
+     business purposes and to build, operate, and provide your own
+     products and services to Third Parties, provided that the Licensed
+     Work itself (whether modified or unmodified) is not the product or
+     service, and is not a Competitive Offering, made available to those
+     Third Parties.
+
+  7. You may modify the Licensed Work and create derivative works for
+     any purpose permitted by this License. Any Production Use of such
+     modified or derivative works remains subject to the same
+     restrictions as the Licensed Work, including the prohibition on
+     Competitive Offerings.
+
+  8. Use of the Licensed Work by your own employees, contractors, and
+     agents, acting on your behalf and for your benefit, is not by
+     itself making the Licensed Work available to a Third Party.
+
+  9. Embedding or distributing the Licensed Work as a component of your
+     own product or service is permitted only where the Licensed Work
+     does not constitute the principal value of that product or service
+     and the product or service is not a Competitive Offering.
+
+  10. Nothing in this Additional Use Grant grants any right to use any
+      name, trademark, service mark, or logo of the Licensor or its
+      Affiliates, except as reasonably required for customary
+      attribution.
+
+  11. The rights stated in this Additional Use Grant are the maximum
+      rights granted for Production Use prior to the Change Date. Any
+      Production Use not expressly permitted requires a separate
+      commercial license from the Licensor.
+
+  12. If any provision of this Additional Use Grant is held invalid or
+      unenforceable, that provision shall be limited or eliminated to
+      the minimum extent necessary so that the remainder of this
+      Additional Use Grant, and of this License, remains in full force
+      and effect. The Licensor reserves all rights not expressly granted
+      by this License.
+
+
+Change Date:  Four years from the date the specific version of the Licensed
+  Work is first publicly released by Licensor.
+
+Change License:  Mozilla Public License, Version 2.0
+
+For information about alternative licensing arrangements, commercial
+licensing, enterprise licensing, OEM licensing, appliance licensing, managed
+service licensing, cloud provider licensing, or other commercial use of the
+Licensed Work, please contact: licensing@neuralchowder.com
+
+-----------------------------------------------------------------------------
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates, provided that you may use a trademark or logo of Licensor
+as expressly required by this License.
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+export { registerEditionCommand, registerVerbs } from './commands/edition';
+export { captureEditionVerb } from './runtime/edition/run-entry';
+export { EditionVerb } from './runtime/edition/verb-map';
+export declare function buildProgram(): Command;
+export declare function main(argv?: ReadonlyArray<string>): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,wBAAgB,YAAY,IAAI,OAAO,CAUtC;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,aAAa,CAAC,MAAM,CAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF"}

package/dist/cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditionVerb = exports.captureEditionVerb = exports.registerVerbs = exports.registerEditionCommand = void 0;
+exports.buildProgram = buildProgram;
+exports.main = main;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const commander_1 = require("commander");
+const edition_1 = require("./commands/edition");
+const exit_codes_1 = require("./lib/exit-codes");
+function readVersion() {
+    const manifest = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'package.json'), 'utf8'));
+    const version = manifest.version;
+    if (typeof version !== 'string' || version.length === 0) {
+        throw new Error('@xemahq/edition-tooling: no "version" in its package.json');
+    }
+    return version;
+}
+var edition_2 = require("./commands/edition");
+Object.defineProperty(exports, "registerEditionCommand", { enumerable: true, get: function () { return edition_2.registerEditionCommand; } });
+Object.defineProperty(exports, "registerVerbs", { enumerable: true, get: function () { return edition_2.registerVerbs; } });
+var run_entry_1 = require("./runtime/edition/run-entry");
+Object.defineProperty(exports, "captureEditionVerb", { enumerable: true, get: function () { return run_entry_1.captureEditionVerb; } });
+var verb_map_1 = require("./runtime/edition/verb-map");
+Object.defineProperty(exports, "EditionVerb", { enumerable: true, get: function () { return verb_map_1.EditionVerb; } });
+function buildProgram() {
+    const program = new commander_1.Command();
+    program
+        .name('xema-edition')
+        .description('Xema edition pipeline: resolve, seal, check and develop-snapshot an edition; build and verify image evidence.')
+        .version(readVersion(), '-v, --version', 'print the tooling version')
+        .showHelpAfterError(true)
+        .configureHelp({ sortSubcommands: true });
+    (0, edition_1.registerVerbs)(program);
+    return program;
+}
+async function main(argv = process.argv) {
+    await buildProgram().parseAsync([...argv]);
+}
+if (require.main === module) {
+    void main().catch((err) => {
+        console.error(`xema-edition: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(exit_codes_1.EditionExitCode.GenericError);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AA2BA,oCAUC;AAED,oBAEC;AArCD,qCAAuC;AACvC,yCAAiC;AAEjC,yCAAoC;AAEpC,gDAAmD;AACnD,iDAAmD;AAEnD,SAAS,WAAW;IAElB,MAAM,QAAQ,GAAY,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,OAAO,GAAI,QAAkC,CAAC,OAAO,CAAC;IAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8CAA2E;AAAlE,iHAAA,sBAAsB,OAAA;AAAE,wGAAA,aAAa,OAAA;AAE9C,yDAAiE;AAAxD,+GAAA,kBAAkB,OAAA;AAC3B,uDAAyD;AAAhD,uGAAA,WAAW,OAAA;AAEpB,SAAgB,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,cAAc,CAAC;SACpB,WAAW,CAAC,+GAA+G,CAAC;SAC5H,OAAO,CAAC,WAAW,EAAE,EAAE,eAAe,EAAE,2BAA2B,CAAC;SACpE,kBAAkB,CAAC,IAAI,CAAC;SACxB,aAAa,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,IAAI,CAAC,OAA8B,OAAO,CAAC,IAAI;IACnE,MAAM,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAGD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACjC,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,4BAAe,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/edition.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function registerVerbs(parent: Command, invocation?: string): void;
+export declare function registerEditionCommand(program: Command): void;
+//# sourceMappingURL=edition.d.ts.map

package/dist/commands/edition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edition.d.ts","sourceRoot":"","sources":["../../src/commands/edition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DzC,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,GAAE,MAAuB,GAAG,IAAI,CAgBxF;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE7D"}

package/dist/commands/edition.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerVerbs = registerVerbs;
+exports.registerEditionCommand = registerEditionCommand;
+const exit_codes_1 = require("../lib/exit-codes");
+const run_entry_1 = require("../runtime/edition/run-entry");
+const verb_map_1 = require("../runtime/edition/verb-map");
+const VERB_SUMMARY = {
+    [verb_map_1.EditionVerb.Resolve]: 'Resolve the whole release lock set of an edition: xema-edition resolve <id> [--check]; or a customer edition against the catalogue pinned in catalogue.pin.json beside the definition: xema-edition resolve --definition <file> --channel release --out <dir> (a develop customer edition is resolved by xema-edition develop resolve --definition) [--source-image <source>=<registry>/<prefix>]...',
+    [verb_map_1.EditionVerb.Seal]: 'Seal one exact resolved RELEASE edition (kind resolved, pulled by the caller): xema-edition seal --resolved <repository>@sha256:<digest> --manifest <file> --artifact <dir> --out <dir> --cosign <abs path> --resolve-workflow-sha <40-hex> [--local] --data-root <dir> --editions-root <dir> --kernel <dir>; cosign-verifies it offline against the contract issuer and the resolve publisher (only the data root edition-workspace.json editionPublishers.resolved.release, in the repository the edition provenance records; undeclared is refused), then writes its layers unchanged plus a kind sealed release descriptor naming it as sealOf, refused unless the evidence trust policy is armed on release',
+    [verb_map_1.EditionVerb.ResolveDigests]: 'Resolve the image digests of an edition: xema-edition resolve-digests <id> [--definition <file>] (a customer edition resolves them against the release catalogue pinned in catalogue.pin.json beside the definition)',
+    [verb_map_1.EditionVerb.Develop]: 'Resolve a develop edition snapshot: xema-edition develop <resolve|target|choose-kernel|freeze-graph|freeze-sources|check-existing|check-overrides|select-records|image-record> ... (the channel lane: resolve --engine-image <repo>@sha256:<digest> --images-from <record> --channel <tag>; no signature is verified); or a customer develop edition (catalogue pinned in catalogue.pin.json beside the definition): xema-edition develop <resolve|target|check-existing|freeze-sources> --definition <file> ... (resolve: --pins <file> --out <dir> --registry <root> --engine-image <repo>@sha256:<digest> [--source-image <source>=<registry>/<prefix>]...; target: --pins <file> --registry <root> --engine-image <repo>@sha256:<digest> [--source-image ...]; check-existing: --pins <file> --artifact <dir> --engine-image <repo>@sha256:<digest> [--source-image ...]). The develop tag is sha256 of the @xemahq/edition-tooling version, the engine image, the pins and the source-image map.',
+    [verb_map_1.EditionVerb.Release]: 'Resolve a customer release edition (catalogue pinned for release in catalogue.pin.json beside the definition): xema-edition release <freeze-sources|target|check-existing|resolve> --definition <file> ... (freeze-sources: --out <pins.json>, each source at its declared ref; resolve: --pins <file> --out <dir> --registry <root> --engine-image <repo>@sha256:<digest> [--source-image <source>=<registry>/<prefix>]...; target: --pins <file> --registry <root> --engine-image <repo>@sha256:<digest> [--source-image ...]; resolve and check-existing are refused until the release catalogue evidence is verified)',
+    [verb_map_1.EditionVerb.Artifact]: 'Write the OCI artifact files of a release edition from the committed sealed locks: xema-edition artifact <id> --channel release --registry <root> --coordinate <tag> --engine-image <repo>@sha256:<digest> --out <dir>',
+    [verb_map_1.EditionVerb.Catalogue]: 'Write the catalogue.json of a release offering from its committed sealed locks: xema-edition catalogue <id> --out <dir>',
+    [verb_map_1.EditionVerb.Index]: `Rebuild a catalogue index: xema-edition index <${Object.values(verb_map_1.EditionIndexKind).join('|')}> [--check]; xema-edition index runtime-image-source --repin-contract-authority --kernel-commit <40-hex> replaces only the contract authority of the committed index with the kernel checkout's at the stated commit (its HEAD must equal it); xema-edition index runtime-image-source --trusted-write --third-party <name> verifies a third-party source offline against the OCI registry and the trusted cosign (flags and --check-third-party in edition/README.md), commits its evidence and pin, and requires xema-edition repin-evidence-trust to follow`,
+    [verb_map_1.EditionVerb.Check]: 'Check the committed edition locks and catalogue indices; prints every active per-edition hold (sourcePins) with its exit condition',
+    [verb_map_1.EditionVerb.CheckAuthored]: 'Check the authored distribution source offline (the develop gate): the definitions, the indexes, the trust policy, the data-root readers, the chart-set pin and the ownership self-tests; resolves no edition and reads no lock content and no source checkout at a pinned commit: xema-edition check-authored --data-root <dir> --editions-root <dir> --sources-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Why]: 'Explain why a biome is in an edition: xema-edition why <id> <biome>',
+    [verb_map_1.EditionVerb.VerifyPlatforms]: 'Prove the registry serves every required platform of an edition: xema-edition verify-platforms <id>',
+    [verb_map_1.EditionVerb.CheckoutSources]: 'Check out the source repositories the runtime image source index names',
+    [verb_map_1.EditionVerb.RepinEvidenceTrust]: 'Pin the data root evidence trust policy and this CLI verifier: xema-edition repin-evidence-trust --data-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.VerifyEvidence]: 'Verify the signed image evidence of an edition with the pinned verifier bundle: xema-edition verify-evidence <id> --evidence-root <dir> --descriptor <path> --state <path> --cosign <path> --git <path> [--json] --data-root <dir> --editions-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Evidence]: `Build, accept and plan image evidence (never signs): xema-edition evidence <${Object.values(verb_map_1.EditionEvidenceKind).join('|')}> …; a third-party publisher's GitHub-hosted refs/heads/main workflow assembles the producer input of one image on public inputs only (this CLI, the @xemahq/contracts it ships, its own checkout at GITHUB_WORKSPACE and registry credentials): xema-edition evidence assemble-third-party-input --bundle <oci repository>@sha256:<hex> --contract-authority <file> --image <image repository>@sha256:<hex> --subject-id <component image name> --provenance <absolute exported SLSA v1 predicate> --registry-credentials <file> --output <path> [--ttl-seconds <n>]; it then runs statement producer <stage|accept> and oci <attach-plan|validate> with --contract-authority <file> in place of --data-root/--kernel (public-input mode; the CLI's bundled @xemahq/contracts must be that authority)`,
+    [verb_map_1.EditionVerb.ContractAuthority]: 'Print the full kernel contract authority (KernelContractAuthoritySchema) of the @xemahq/contracts this CLI ships, as canonical JSON: the --contract-authority <file> of a third-party publisher\'s public-input run. No root flags: xema-edition contract-authority > contract-authority.json. Read from the kernel\'s own published dist/edition-protocol/contract-authority.json (sourceCommit is the commit as the kernel release states it, carried, not proven; contentDigest and sourcePaths are proven against the package), refused unless its contentDigest is the bundled edition protocol digest and the bundled kernel is that authority; a kernel without the file (a dev build) is refused',
+    [verb_map_1.EditionVerb.List]: 'Print the offering ids of an editions root as JSON: xema-edition list --editions-root <dir>',
+    [verb_map_1.EditionVerb.Locks]: 'Print the validated locks of an edition as JSON: xema-edition locks <id> --channel <release|develop> --data-root <dir> --editions-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.ChartSet]: `Pin the chart set of the editions to the charts the registry serves: xema-edition chart-set <${Object.values(verb_map_1.EditionChartSetOperation).join('|')}> [--check] --data-root <dir> --editions-root <dir> --kernel <dir>; source-commit prints the commit each publisher closed its locked set at (--data-root, --kernel)`,
+    [verb_map_1.EditionVerb.BiomeManifests]: 'Print the pinned xema-biome.json of every biome of an edition as JSON: xema-edition biome-manifests <id> --json --data-root <dir> --editions-root <dir> --sources-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Arming]: 'Print whether the data root evidence trust policy is armed on one channel as one JSON line, exiting 0 only when armed: xema-edition arming --channel <release|develop> --data-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Pin]: 'Hold one repository of a vendor edition at an exact commit, then re-resolve the edition (the commit must exist, be contained in origin/main and be built; a pin equal to the shared repository pin is not a hold): xema-edition pin <edition> <repo> <ref> --until "<exit condition>" --data-root <dir> --editions-root <dir> --sources-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Unpin]: 'Release one hold (or all holds) of a vendor edition, then re-resolve the edition: xema-edition unpin <edition> [<repo>] --data-root <dir> --editions-root <dir> --sources-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.SourceClosure]: 'Print the source tree hash and workspace closure of a source directory at a commit as JSON: xema-edition source-closure --repo <repo> --path <dir> --commit <sha> --sources-root <dir> --kernel <dir>',
+    [verb_map_1.EditionVerb.Ceiling]: 'Print the dev ceiling (DevelopCeilingSchema) of a distribution at a distributions commit as JSON: the selection from the definition and indexes at that commit, the process facts from each producer manifest and ledger at its stated commit: xema-edition ceiling --distribution <id> --at <distributions sha> --producer-commit <owner/repo>=<sha> [--producer-commit ...] --data-root <dir> --sources-root <dir> --kernel <dir>',
+};
+const BIN_INVOCATION = 'xema-edition';
+function registerVerbs(parent, invocation = BIN_INVOCATION) {
+    for (const verb of Object.values(verb_map_1.EditionVerb)) {
+        parent
+            .command(verb)
+            .description(VERB_SUMMARY[verb].replaceAll(BIN_INVOCATION, invocation))
+            .argument('[args...]', 'the verb\'s arguments and the root flags, passed through')
+            .allowUnknownOption()
+            .action((args) => {
+            try {
+                const { exitCode } = (0, run_entry_1.runEditionVerb)(verb, args);
+                process.exit(exitCode);
+            }
+            catch (error) {
+                (0, exit_codes_1.exitWith)(exit_codes_1.EditionExitCode.GenericError, error instanceof Error ? error.message : String(error));
+            }
+        });
+    }
+}
+function registerEditionCommand(program) {
+    registerVerbs(program.command('edition').summary('Resolve, seal and check editions'), 'xema edition');
+}
+//# sourceMappingURL=edition.js.map

package/dist/commands/edition.js.map

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