@standards/cli 1.0.0-alpha.391 → 1.0.0-alpha.393

package/dist/bin.mjs

@@ -1,19 +1,20 @@
 #!/usr/bin/env node
 /*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+import { t as discoverBundles } from "./discover-bundles-D5RNCkan.mjs";
 import { createRequire } from "node:module";
 import { styleText } from "node:util";
-import { StandardsRequestError, createTransport } from "@standards/client";
+import { BundleConflictError, StandardsRequestError, createTransport, syncBundle } from "@standards/client";
 import { Command } from "commander";
-import { CATALOG_KINDS, CATALOG_LOCALES, COUNT_MODES, DEVICE_CHANNEL_WORKER_CLOSE_PROTOCOL_VIOLATION, MEETING_RESPONSES, RECORDING_OVERRIDES, RECORD_ACCESS_ROLES, RESOURCE_VISIBILITIES, SchemaError, SchemaErrorCode, ValidationError, canonicalStringify, computeReconnectDelay, computeRetryDelay, deviceChannelUrl, diffSchemaState, formatByteSize, parseRecordAccessRole, parseSchemaState, parseServerFrame, schemaStateSourcePayload } from "@standards/schema";
+import { BUNDLE_LOCALES, COUNT_MODES, DEVICE_CHANNEL_WORKER_CLOSE_PROTOCOL_VIOLATION, MEETING_RESPONSES, RECORDING_OVERRIDES, RECORD_ACCESS_ROLES, RESOURCE_VISIBILITIES, SchemaError, SchemaErrorCode, ValidationError, canonicalStringify, computeReconnectDelay, computeRetryDelay, deviceChannelUrl, diffSchemaState, formatByteSize, parseRecordAccessRole, parseSchemaState, parseServerFrame, schemaStateSourcePayload } from "@standards/schema";
 import Table from "cli-table3";
 import { createAppClient } from "@standards/client/app";
-import { homedir, hostname } from "node:os";
-import { createHash, randomUUID } from "node:crypto";
+import { constants, createWriteStream } from "node:fs";
 import { access, chmod, mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join } from "node:path";
+import { homedir, hostname } from "node:os";
+import { createHash, randomUUID } from "node:crypto";
 import { WebSocket } from "ws";
 import { spawn } from "node:child_process";
-import { constants, createWriteStream } from "node:fs";
 import { StringDecoder } from "node:string_decoder";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
@@ -193,100 +194,125 @@ function registerAuthCommand(program) {
 	});
 }
 //#endregion
-//#region src/commands/bundles.ts
+//#region src/discovery/order-bundles.ts
 /**
-* System bundles (admin / workspace:manage). A bundle is a code-defined,
-* versioned set of schema that can be assigned to — and updated on — a tenant.
+* Orders discovered bundles so each comes after the bundles it `uses`.
+* Bundles a `uses` names that were not discovered are already the host's concern.
 */
-function registerBundlesCommand(program) {
-	const bundles = program.command("bundles").description("Manage system bundles assigned to the current tenant (admin)");
-	bundles.command("list").description("List the bundles actively assigned to the current tenant").action(async (_opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).bundles.listAssigned({}), getFormat(cmd));
-	});
-	bundles.command("updatable").description("List assigned bundles that have a newer version available").action(async (_opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).bundles.listUpdatable({}), getFormat(cmd));
-	});
-	bundles.command("assign").description("Assign (install) a bundle to the current tenant").argument("<bundleId>", "bundle ID to assign").action(async (bundleId, _opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).bundles.assign({ bundleId }), getFormat(cmd));
-	});
-	bundles.command("uninstall").description("Uninstall a bundle: deactivate it and demote its now-orphaned objects").argument("<bundleId>", "bundle ID to uninstall").option("--yes", "uninstall without confirmation").action(async (bundleId, opts, cmd) => {
-		if (!opts.yes) throw new Error("Uninstalling a bundle is explicit. Re-run with \"--yes\" to confirm.");
-		formatOutput(await getAppClientFromCommand(cmd).bundles.uninstall({ bundleId }), getFormat(cmd));
-	});
-	bundles.command("update").description("Apply assigned bundles — picks up newer bundle versions (additive sync)").action(async (_opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).bundles.update({}), getFormat(cmd));
-	});
+async function orderByUses(discovered) {
+	const byName = new Map(discovered.map((entry) => [entry.bundle.name, entry]));
+	const ordered = [];
+	const visited = /* @__PURE__ */ new Set();
+	async function visit(entry) {
+		if (visited.has(entry.bundle.name)) return;
+		visited.add(entry.bundle.name);
+		for (const used of (await entry.bundle.build()).uses) {
+			const dependency = byName.get(used);
+			if (dependency) await visit(dependency);
+		}
+		ordered.push(entry);
+	}
+	for (const entry of discovered) await visit(entry);
+	return ordered;
 }
 //#endregion
-//#region src/commands/catalog.ts
-/** Reject a typo instead of letting the API answer a 400 on a bare enum. */
-function parseChoice(flag, value, choices) {
-	if (choices.includes(value)) return value;
-	throw new ValidationError(`${flag} must be one of: ${choices.join(", ")}`, []);
-}
-/** An empty selection installs nothing, so it is refused before the request. */
-function parseSelection(opts) {
-	const selection = {};
-	if (opts.entries !== void 0) selection.entries = parseCsvList(opts.entries);
-	if (opts.packs !== void 0) selection.packs = parseCsvList(opts.packs);
-	if (!(selection.entries?.length || selection.packs?.length)) throw new ValidationError("Select at least one catalog entry (--entries) or pack (--packs)", []);
-	return selection;
-}
-/** `<entryId>=bind`, `<entryId>=skip` or `<entryId>=rename:<name>`, one per collision. */
+//#region src/commands/bundles.ts
+const HASH_PREFIX_LENGTH = 7;
+function shortHash(hash) {
+	return hash?.slice(0, HASH_PREFIX_LENGTH) ?? "";
+}
+function describeFailure(name, error) {
+	if (error instanceof BundleConflictError && error.owner) return `${name}: ${messageOf(error)} (owned by ${error.owner})`;
+	return `${name}: ${messageOf(error)}`;
+}
+/** Runs a command body; any failure prints once on stderr and exits 1. */
+async function run(body) {
+	try {
+		await body();
+	} catch (error) {
+		console.error(styleText("red", `✗ ${messageOf(error)}`));
+		process.exit(1);
+	}
+}
+async function syncDiscovered(cmd, cwd) {
+	const transport = getClientFromCommand(cmd);
+	for (const { bundle } of await orderByUses(await discoverBundles({ cwd }))) try {
+		const { applied, hash } = await syncBundle(transport, bundle);
+		console.info(`${bundle.name} ${applied ? "applied" : "unchanged"} ${shortHash(hash)}`);
+	} catch (error) {
+		throw new Error(describeFailure(bundle.name, error));
+	}
+}
+/** Reject a locale typo instead of letting the API answer a 400 on a bare enum. */
+function parseLocale(value) {
+	const locale = BUNDLE_LOCALES.find((candidate) => candidate === value);
+	if (locale) return locale;
+	throw new ValidationError(`--locale must be one of: ${BUNDLE_LOCALES.join(", ")}`, []);
+}
+/** `<pieceId>=bind`, `<pieceId>=skip` or `<pieceId>=rename:<name>`, one per collision. */
 function collectDecision(value, decisions) {
 	const separator = value.indexOf("=");
-	const entryId = value.slice(0, separator);
+	const pieceId = value.slice(0, separator);
 	const choice = value.slice(separator + 1);
 	if (separator > 0 && (choice === "bind" || choice === "skip")) return {
 		...decisions,
-		[entryId]: choice
+		[pieceId]: choice
 	};
 	if (separator > 0 && choice.startsWith("rename:") && choice.length > 7) return {
 		...decisions,
-		[entryId]: { rename: choice.slice(7) }
+		[pieceId]: { rename: choice.slice(7) }
+	};
+	throw new ValidationError(`--decision must read <pieceId>=bind, <pieceId>=skip or <pieceId>=rename:<name> (received: ${value})`, []);
+}
+/** The input `preview` and `add` share: whole bundles, in one locale. */
+function addInput(names, opts) {
+	return {
+		bundles: names,
+		locale: parseLocale(opts.locale),
+		withSamples: opts.withSamples === true
 	};
-	throw new ValidationError(`--decision must read <entryId>=bind, <entryId>=skip or <entryId>=rename:<name> (received: ${value})`, []);
 }
-/** The flags `preview` and `install` share — both take the same selection. */
-function withSelectionOptions(command) {
-	return command.option("--entries <ids>", "comma-separated catalog entry IDs to install").option("--packs <ids>", "comma-separated catalog pack IDs to install").option("--locale <locale>", `language to compile the pieces in (${CATALOG_LOCALES.join(", ")})`, "en").option("--with-samples", "also install the packs' sample records");
+/** The flags `preview` and `add` share. */
+function withAddOptions(command) {
+	return command.argument("<names...>", "bundle names (the bundles each one uses come along)").option("--locale <locale>", `language to compile the pieces in (${BUNDLE_LOCALES.join(", ")})`, "en").option("--with-samples", "also add the bundles' sample records");
 }
 /**
-* The pre-built catalog: objects, views and agents installed as copies the
-* workspace owns. `preview` returns the plan and its fingerprint; `install`
-* applies that same plan, refused if the workspace changed since.
+* The workspace's bundles: sync the ones the project declares, list what is
+* installed, remove one, and add a bundle the workspace may add as a copy it
+* owns (`preview`, then `add` with the preview's fingerprint).
 */
-function registerCatalogCommand(program) {
-	const catalog = program.command("catalog").description("Browse and install pre-built objects, views and agents");
-	catalog.command("list").description("List the catalog entries and packs, and whether each is installed").option("--kind <kind>", `restrict to one kind (${CATALOG_KINDS.join(", ")})`).option("--search <text>", "match labels and descriptions").option("--locale <locale>", `language of the labels (${CATALOG_LOCALES.join(", ")})`, "en").action(async (opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).catalog.list({
-			locale: parseChoice("--locale", opts.locale, CATALOG_LOCALES),
-			...opts.kind !== void 0 && { kind: parseChoice("--kind", opts.kind, CATALOG_KINDS) },
-			...opts.search !== void 0 && { q: opts.search }
-		}), getFormat(cmd));
-	});
-	catalog.command("get").description("Get one catalog entry or pack, with the IDs it pulls in").argument("<id>", "catalog entry or pack ID").option("--locale <locale>", `language of the labels (${CATALOG_LOCALES.join(", ")})`, "en").action(async (id, opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).catalog.read({
-			id,
-			locale: parseChoice("--locale", opts.locale, CATALOG_LOCALES)
-		}), getFormat(cmd));
-	});
-	withSelectionOptions(catalog.command("preview").description("Plan an install: what is new, what collides, and the plan's fingerprint")).action(async (opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).catalog.preview({
-			selection: parseSelection(opts),
-			locale: parseChoice("--locale", opts.locale, CATALOG_LOCALES),
-			withSamples: opts.withSamples === true
-		}), getFormat(cmd));
-	});
-	withSelectionOptions(catalog.command("install").description("Install a previewed selection as workspace-owned copies").requiredOption("--fingerprint <fingerprint>", "the fingerprint `catalog preview` returned").option("--decision <entryId=choice>", "how to settle a collision: bind, skip or rename:<name> (repeatable)", collectDecision, {})).action(async (opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).catalog.install({
-			selection: parseSelection(opts),
-			locale: parseChoice("--locale", opts.locale, CATALOG_LOCALES),
-			withSamples: opts.withSamples === true,
+function registerBundlesCommand(program) {
+	const bundles = program.command("bundles").description("Sync and manage the workspace's bundles");
+	bundles.command("sync").description("Discover the project's bundles (standards/bundles/*.ts) and sync each one").option("--cwd <dir>", "project root to discover bundles in").action((opts, cmd) => run(() => syncDiscovered(cmd, opts.cwd)));
+	bundles.command("list").description("List the bundles installed in the workspace").action((_opts, cmd) => run(async () => {
+		const { installed } = await getAppClientFromCommand(cmd).bundles.list({});
+		formatOutput(installed.map((row) => ({
+			name: row.name,
+			mode: row.mode,
+			origin: row.origin ?? "",
+			hash: shortHash(row.hash),
+			installedAt: row.installedAt
+		})), getFormat(cmd));
+	}));
+	bundles.command("available").description("List the bundles the workspace may add, and whether each is installed").option("--locale <locale>", `language of the labels (${BUNDLE_LOCALES.join(", ")})`, "en").action((opts, cmd) => run(async () => {
+		const { available } = await getAppClientFromCommand(cmd).bundles.list({ locale: parseLocale(opts.locale) });
+		formatOutput(available, getFormat(cmd));
+	}));
+	withAddOptions(bundles.command("preview").description("Plan an add: what is new, what collides, and the plan's fingerprint")).action((names, opts, cmd) => run(async () => {
+		formatOutput(await getAppClientFromCommand(cmd).bundles.preview(addInput(names, opts)), getFormat(cmd));
+	}));
+	withAddOptions(bundles.command("add").description("Add previewed bundles as copies the workspace owns").requiredOption("--fingerprint <fingerprint>", "the fingerprint `bundles preview` returned").option("--decision <pieceId=choice>", "how to settle a collision: bind, skip or rename:<name> (repeatable)", collectDecision, {})).action((names, opts, cmd) => run(async () => {
+		formatOutput(await getAppClientFromCommand(cmd).bundles.add({
+			...addInput(names, opts),
 			decisions: opts.decision,
 			fingerprint: opts.fingerprint
 		}), getFormat(cmd));
-	});
+	}));
+	bundles.command("remove").description("Remove a synced bundle; its pieces are demoted, never deleted").argument("<name>", "bundle name").option("--yes", "remove without confirmation").action((name, opts, cmd) => run(async () => {
+		requireConfirmation(opts.yes, `Removing bundle "${name}" demotes its objects to workspace-owned. Re-run with "--yes" to confirm.`);
+		await getAppClientFromCommand(cmd).bundles.remove({ name });
+		console.info(`${name} removed`);
+	}));
 }
 //#endregion
 //#region src/commands/codemod.ts
@@ -294,7 +320,7 @@ function registerCatalogCommand(program) {
 function registerCodemodCommand(program) {
 	const codemod = program.command("codemod").description("Rewrite code for a breaking SDK change");
 	codemod.command("builder-shorthand").description("Rewrite text({ name, label }) builders to text(name, label)").argument("[paths...]", "files or directories to rewrite", ["."]).option("--dry-run", "report without writing").option("--relative-imports", "also treat relative imports as Standards builders — for the Standards monorepo itself").action(async (paths, opts) => {
-		const { runBuilderShorthand } = await import("./builder-shorthand-DPVmGTec.mjs");
+		const { runBuilderShorthand } = await import("./builder-shorthand-CPJ9hFiW.mjs");
 		const report = await runBuilderShorthand(paths, {
 			write: !opts.dryRun,
 			relativeImports: opts.relativeImports === true
@@ -2014,7 +2040,7 @@ function registerSchemaCommand(program) {
 	schema.command("inspect").description("Inspect an object (attributes, types, views)").argument("<object>", "object name or ID").action(async (objectName, _opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).schemaObjects.get({ objectIdOrName: objectName }), getFormat(cmd));
 	});
-	schema.command("groups").description("List the bundles and schema sources that own objects, with label and icon").action(async (_opts, cmd) => {
+	schema.command("groups").description("List the bundles that own objects, with their label").action(async (_opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).schemaGroups.list({}), getFormat(cmd));
 	});
 }
@@ -2043,20 +2069,6 @@ function registerSearchCommand(program) {
 	});
 }
 //#endregion
-//#region src/commands/sources.ts
-/** Remote schema sources — definitions pushed by an external codebase through @standards/client. */
-function registerSourcesCommand(program) {
-	const sources = program.command("sources").description("Inspect and remove remote schema sources on the current tenant");
-	sources.command("list").description("List remote schema sources: id, hash, last apply, object names").action(async (_opts, cmd) => {
-		formatOutput(await getAppClientFromCommand(cmd).schemaSources.list({}), getFormat(cmd));
-	});
-	sources.command("remove").description("Remove a remote schema source: its objects are demoted to custom, records are kept").argument("<sourceId>", "source id declared in code").option("--yes", "remove without confirmation").action(async (sourceId, opts, cmd) => {
-		if (!opts.yes) throw new Error("Removing a schema source is explicit. Re-run with \"--yes\" to confirm.");
-		await getAppClientFromCommand(cmd).schemaSources.remove({ sourceId });
-		formatOutput({ removed: sourceId }, getFormat(cmd));
-	});
-}
-//#endregion
 //#region src/version.ts
 /**
 * The installed package's version, read from its own manifest: `src/` and the
@@ -2101,8 +2113,6 @@ function createProgram() {
 	registerInvitationsCommand(program);
 	registerAuthCommand(program);
 	registerBundlesCommand(program);
-	registerCatalogCommand(program);
-	registerSourcesCommand(program);
 	registerCodemodCommand(program);
 	registerConnectorsCommand(program);
 	registerMcpCommand(program);

package/dist/{builder-shorthand-DPVmGTec.mjs → builder-shorthand-CPJ9hFiW.mjs}

@@ -24,7 +24,6 @@ const BUILDERS = /* @__PURE__ */ new Set([
 	"nativeObject"
 ]);
 const WITH_ID = /* @__PURE__ */ new Set(["object", "nativeObject"]);
-const SOURCE = "defineSchemaSource";
 const STANDARDS_PACKAGE = /^@standards\/(schema|client)$/;
 const RELATIVE_MODULE = /^\.{1,2}\//;
 const COMMENT_IN_CONFIG = "comment in config, rewrite by hand";
@@ -46,7 +45,7 @@ function importedBuilders(clauses) {
 		if (!(bindings && ts.isNamedImports(bindings))) continue;
 		for (const element of bindings.elements) {
 			const exported = element.propertyName?.text ?? element.name.text;
-			if (BUILDERS.has(exported) || exported === SOURCE) found.set(element.name.text, exported);
+			if (BUILDERS.has(exported)) found.set(element.name.text, exported);
 		}
 	}
 	return found;
@@ -109,33 +108,6 @@ function rewriteBuilder(call, exported, file) {
 		edits
 	};
 }
-function rewriteSource(call, file) {
-	const [id, config] = call.arguments;
-	if (call.arguments.length !== 2 || id === void 0 || config === void 0) return { kind: "none" };
-	if (!ts.isObjectLiteralExpression(config)) return {
-		kind: "skip",
-		reason: "config is not an object literal"
-	};
-	const idText = id.getText(file);
-	const hasProperties = config.properties.length > 0;
-	const open = config.getStart(file) + 1;
-	const spaces = /^[ \t]*/.exec(file.text.slice(open))?.[0].length ?? 0;
-	const multiline = /^[ \t]*[\r\n]/.test(file.text.slice(open));
-	const head = hasProperties ? `{ id: ${idText},${multiline ? "" : " "}` : `{ id: ${idText} }`;
-	const end = hasProperties ? multiline ? open : open + spaces : config.getEnd();
-	if (hasComment(file, id.getStart(file), end)) return {
-		kind: "skip",
-		reason: COMMENT_IN_CONFIG
-	};
-	return {
-		kind: "edit",
-		edits: [{
-			start: id.getStart(file),
-			end,
-			text: head
-		}]
-	};
-}
 function overlaps(x, y) {
 	if (x.start === x.end && y.start === y.end) return x.start === y.start;
 	return x.start < y.end && y.start < x.end;
@@ -161,10 +133,6 @@ function importedNamespaces(clauses) {
 }
 /** True when a call to `exported` still has the pre-shorthand argument shape. */
 function isLegacyShape(call, exported) {
-	if (exported === SOURCE) {
-		const config = call.arguments[1];
-		return call.arguments.length === 2 && config !== void 0 && ts.isObjectLiteralExpression(config);
-	}
 	return BUILDERS.has(exported) && call.arguments.length === 1;
 }
 /** Every TS and JS module a schema can live in; declaration files carry no calls. */
@@ -190,7 +158,7 @@ function rewriteBuilderShorthand(text, fileName, options = {}) {
 		if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) {
 			const exported = builders.get(node.expression.text);
 			if (exported !== void 0) {
-				const outcome = exported === SOURCE ? rewriteSource(node, file) : rewriteBuilder(node, exported, file);
+				const outcome = rewriteBuilder(node, exported, file);
 				if (outcome.kind === "edit") calls.push({
 					node,
 					edits: outcome.edits

package/dist/discover-bundles-D5RNCkan.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+import { DuplicateError, ValidationError, isBundle } from "@standards/schema";
+import { existsSync } from "node:fs";
+import { glob } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { createJiti } from "jiti";
+//#region src/discovery/discover-bundles.ts
+const DEFAULT_PATTERNS = ["standards/bundles/*.ts"];
+const CONFIG_FILE = "standards.config.ts";
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+async function importModule(jiti, file, label) {
+	try {
+		return await jiti.import(file);
+	} catch (error) {
+		throw new ValidationError(`Could not load ${label}: ${messageOf(error)}`, []);
+	}
+}
+async function readConfigPatterns(jiti, cwd) {
+	const file = join(cwd, CONFIG_FILE);
+	if (!existsSync(file)) return void 0;
+	const config = (await importModule(jiti, file, CONFIG_FILE)).default;
+	if (config?.bundles === void 0) return void 0;
+	return Array.isArray(config.bundles) ? config.bundles : [config.bundles];
+}
+async function matchFiles(cwd, patterns) {
+	const files = /* @__PURE__ */ new Set();
+	for (const pattern of patterns) for await (const match of glob(pattern, { cwd })) files.add(resolve(cwd, match));
+	return [...files].sort();
+}
+/**
+* Finds the bundles a project declares: every export, in every file the
+* patterns match, that is a `BundleBuilder`. Files may hold anything else.
+*/
+async function discoverBundles(options = {}) {
+	const cwd = resolve(options.cwd ?? process.cwd());
+	const jiti = createJiti(import.meta.url, {
+		moduleCache: true,
+		fsCache: false
+	});
+	const patterns = options.patterns ?? await readConfigPatterns(jiti, cwd) ?? DEFAULT_PATTERNS;
+	const files = await matchFiles(cwd, patterns);
+	const found = /* @__PURE__ */ new Map();
+	for (const file of files) {
+		const label = relative(cwd, file).split("\\").join("/");
+		const exports = await importModule(jiti, file, label);
+		for (const [exportName, value] of Object.entries(exports)) {
+			if (!isBundle(value)) continue;
+			const previous = found.get(value.name);
+			if (previous?.bundle === value) continue;
+			if (previous) {
+				const first = relative(cwd, previous.file).split("\\").join("/");
+				throw new DuplicateError("bundle", value.name, `Bundle "${value.name}" is exported by ${first} and ${label}`);
+			}
+			found.set(value.name, {
+				bundle: value,
+				file,
+				exportName
+			});
+		}
+	}
+	if (files.length > 0 && found.size === 0) throw new ValidationError(`No bundle found in ${files.length} file(s) matching ${patterns.join(", ")}`, []);
+	return [...found.values()].sort((a, b) => a.bundle.name.localeCompare(b.bundle.name));
+}
+//#endregion
+export { discoverBundles as t };

package/dist/index.d.mts

@@ -0,0 +1,32 @@
+
+import { BundleBuilder, ObjectBuilderLike } from "@standards/schema";
+//#region src/discovery/define-config.d.ts
+/** What `standards.config.ts` declares. Every key is optional: the conventions apply without a file. */
+interface StandardsCliConfig {
+  /** Glob pattern(s), relative to the project root, that locate the bundle files. */
+  bundles?: string | string[];
+}
+/** Types a `standards.config.ts` default export. */
+export declare function defineConfig(config: StandardsCliConfig): StandardsCliConfig;
+//#endregion
+//#region src/discovery/discover-bundles.d.ts
+type AnyBundle = BundleBuilder<string, readonly ObjectBuilderLike[]>;
+interface DiscoveredBundle {
+  bundle: AnyBundle;
+  /** Absolute path of the file that exports the bundle. */
+  file: string;
+  /** `default` or the name of the named export. */
+  exportName: string;
+}
+interface DiscoverBundlesOptions {
+  cwd?: string;
+  /** Overrides the config and the convention. */
+  patterns?: string[];
+}
+/**
+ * Finds the bundles a project declares: every export, in every file the
+ * patterns match, that is a `BundleBuilder`. Files may hold anything else.
+ */
+export declare function discoverBundles(options?: DiscoverBundlesOptions): Promise<DiscoveredBundle[]>;
+//#endregion
+export type { DiscoverBundlesOptions, DiscoveredBundle, StandardsCliConfig };

package/dist/index.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+import { t as discoverBundles } from "./discover-bundles-D5RNCkan.mjs";
+//#region src/discovery/define-config.ts
+/** Types a `standards.config.ts` default export. */
+function defineConfig(config) {
+	return config;
+}
+//#endregion
+export { defineConfig, discoverBundles };

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@standards/cli",
-  "version": "1.0.0-alpha.391",
+  "version": "1.0.0-alpha.393",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
     "standards": "./dist/bin.mjs"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
   "files": [
     "dist",
     "LICENSE",
@@ -17,11 +25,12 @@
   "dependencies": {
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
+    "jiti": "2.7.0",
     "typescript": "^5.6.3",
     "ws": "8.21.1",
-    "@standards/client": "1.0.0-alpha.391",
-    "@standards/constants": "1.0.0-alpha.391",
-    "@standards/schema": "1.0.0-alpha.391"
+    "@standards/client": "1.0.0-alpha.393",
+    "@standards/constants": "1.0.0-alpha.393",
+    "@standards/schema": "1.0.0-alpha.393"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",