@standards/cli 1.0.0-alpha.418 → 1.0.0-alpha.419

package/dist/bin.mjs

@@ -266,6 +266,10 @@ function collectDecision(value, decisions) {
 	};
 	throw new ValidationError(`--decision must read <pieceId>=bind, <pieceId>=skip or <pieceId>=rename:<name> (received: ${value})`, []);
 }
+/** A repeatable option's values, in the order given. */
+function collectPieceId(value, pieceIds) {
+	return [...pieceIds, value];
+}
 /** The input `preview` and `add` share: whole bundles, in one locale. */
 function addInput(names, opts) {
 	return {
@@ -280,8 +284,9 @@ function withAddOptions(command) {
 }
 /**
 * 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).
+* installed and where each stands, remove one, add a bundle the workspace may
+* add as a copy it owns (`preview`, then `add` with the preview's fingerprint)
+* and update such a copy (`update-preview`, then `update` with its fingerprint).
 */
 function registerBundlesCommand(program) {
 	const bundles = program.command("bundles").description("Sync and manage the workspace's bundles");
@@ -296,6 +301,9 @@ function registerBundlesCommand(program) {
 			installedAt: row.installedAt
 		})), getFormat(cmd));
 	}));
+	bundles.command("status").description("Show where each installed bundle stands and the bundles that depend on it").action((_opts, cmd) => run(async () => {
+		formatOutput(await getAppClientFromCommand(cmd).bundles.status({}), 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));
@@ -310,7 +318,20 @@ function registerBundlesCommand(program) {
 			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 () => {
+	bundles.command("update-preview").description("Plan an added bundle's update, piece by piece, and the plan's fingerprint").argument("<name>", "bundle name").action((name, _opts, cmd) => run(async () => {
+		formatOutput(await getAppClientFromCommand(cmd).bundles.updatePreview({ name }), getFormat(cmd));
+	}));
+	bundles.command("update").description("Update an added bundle as its preview showed; nothing is removed").argument("<name>", "bundle name").requiredOption("--fingerprint <fingerprint>", "the fingerprint `bundles update-preview` returned").option("--take <pieceId>", "take the new version of a piece you changed (repeatable)", collectPieceId, []).option("--skip-missing <pieceId>", "do not reinstall a missing piece (repeatable)", collectPieceId, []).option("--decision <pieceId=choice>", "how to settle a collision: bind, skip or rename:<name> (repeatable)", collectDecision, {}).action((name, opts, cmd) => run(async () => {
+		const { applied } = await getAppClientFromCommand(cmd).bundles.update({
+			name,
+			fingerprint: opts.fingerprint,
+			take: opts.take,
+			skipMissing: opts.skipMissing,
+			decisions: opts.decision
+		});
+		console.info(`${name} updated, ${applied} applied`);
+	}));
+	bundles.command("remove").description("Remove a synced bundle; its pieces are demoted, never deleted. An added bundle is refused: uninstall it from the Bundles window").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`);
@@ -349,7 +370,7 @@ function connectDisclosure(provider, capabilities = []) {
 		if (modify) lines.push("- create, change and delete your events");
 		lines.push("It shows them in the workspace, links them to records and makes them searchable.", "The default assistant can read this calendar, and AI providers process your events whenever an agent works on them.");
 	} else return null;
-	lines.push("Your data is not sold and not used for ads.", "Disconnect at any time in Settings > Integrations.", "Details: https://docs.standards.new/docs/integrations/connected-accounts");
+	lines.push("Your data is not sold and not used for ads.", "Disconnect at any time on the Connectors page.", "Details: https://docs.standards.new/docs/integrations/connected-accounts");
 	return lines.join("\n");
 }
 /** Parse a comma-separated `--capabilities` flag; unknown tiers are refused before the request. */
@@ -371,16 +392,12 @@ function registerConnectorsCommand(program) {
 	connectors.command("list").description("List connector connections").option("--scope <scope>", "connection scope (tenant or actor)", "tenant").action(async (opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).connectors.list({ scope: resolveScope(opts.scope) }), getFormat(cmd));
 	});
-	connectors.command("connect").description("Start an OAuth flow and return the authorization URL to open").requiredOption("--provider <provider>", `connector provider (${PROVIDERS.join(", ")}); run "connectors providers" for the ones this deployment configured`).option("--scope <scope>", "connection scope (tenant or actor)", "tenant").option("--capabilities <list>", `comma-separated capability tiers beyond read (${CAPABILITIES.join(", ")})`).option("--yes", "confirm the access a mailbox or calendar connection gives Standards").action(async (opts, cmd) => {
+	connectors.command("connect").description("Check a provider and capabilities; the account itself is connected from the app").requiredOption("--provider <provider>", `connector provider (${PROVIDERS.join(", ")}); run "connectors providers" for the ones this deployment configured`).option("--scope <scope>", "connection scope (tenant or actor)", "tenant").option("--capabilities <list>", `comma-separated capability tiers beyond read (${CAPABILITIES.join(", ")})`).option("--yes", "confirm the access a mailbox or calendar connection gives Standards").action((opts) => {
 		if (!PROVIDERS.includes(opts.provider)) throw new ValidationError(`--provider must be one of: ${PROVIDERS.join(", ")}`, []);
 		const capabilities = parseCapabilities(opts.capabilities);
 		const disclosure = connectDisclosure(opts.provider, capabilities);
 		if (disclosure && !opts.yes) throw new Error(`${disclosure}\n\nRe-run with "--yes" to continue.`);
-		formatOutput(await getAppClientFromCommand(cmd).connectors.startAuth({
-			provider: opts.provider,
-			scope: resolveScope(opts.scope),
-			...capabilities ? { capabilities } : {}
-		}), getFormat(cmd));
+		process.stdout.write(`${opts.provider} is connected from the Standards app: open Connectors in the sidebar and connect it there.\n`);
 	});
 	connectors.command("disconnect").description("Disconnect (delete) a connector connection").argument("<id>", "connection ID").option("--yes", "disconnect without confirmation").option("--remove-imported", "also remove what a mail or calendar connection imported (kept by default)").action(async (id, opts, cmd) => {
 		if (!opts.yes) throw new Error("Disconnecting a connector is explicit. Re-run with \"--yes\" to confirm.");
@@ -1278,23 +1295,38 @@ async function runSkillsPull(client, dir, names) {
 	}
 	return written;
 }
-/**
-* `standards skills search`: our index, or skills.sh with `community`. Every
-* row carries the same keys, because a table takes its columns from the first.
-*/
-async function runSkillsSearch(client, query, options = {}) {
-	const limit = options.limit === void 0 ? DEFAULT_SEARCH_LIMIT : parseCount("--limit", options.limit);
-	return (await client.skillCatalog.search({
-		query,
-		scope: options.community === true ? "community" : "official",
-		limit
-	})).map(({ source, name, state, reason, description, installs }) => ({
+function searchLimit(limit) {
+	return limit === void 0 ? DEFAULT_SEARCH_LIMIT : parseCount("--limit", limit);
+}
+/** Every row carries the same keys, because a table takes its columns from the first. */
+function catalogRow(result) {
+	const { source, name, state, reason, description, installs } = result;
+	return {
 		source,
 		name,
 		state,
 		reason,
 		description,
 		installs
+	};
+}
+/** `standards skills search`: our index, or skills.sh with `community`. */
+async function runSkillsSearch(client, query, options = {}) {
+	return (await client.skillCatalog.search({
+		query,
+		scope: options.community === true ? "community" : "official",
+		limit: searchLimit(options.limit)
+	})).map(catalogRow);
+}
+/** `standards skills top`: skills.sh's all-time leaderboard, or the last 24 hours with `trending`. */
+async function runSkillsTop(client, options = {}) {
+	return (await client.skillCatalog.search({
+		query: "",
+		scope: options.trending === true ? "trending" : "top",
+		limit: searchLimit(options.limit)
+	})).map((result) => ({
+		...catalogRow(result),
+		weeklyInstalls: result.weeklyInstalls
 	}));
 }
 /** `standards skills preview`: what a source would install, the source checked here first. */
@@ -1376,6 +1408,9 @@ function registerSkillsCommand(program) {
 	skills.command("search").description("Find skills to add: the official catalogue, or skills.sh with --community").argument("<query>", "what the skill should do").option("--community", "search skills.sh instead of the official catalogue").option("--limit <n>", "max results to return (up to 50)").action(async (query, opts, cmd) => {
 		await printAnswer(cmd, () => runSkillsSearch(getAppClientFromCommand(cmd), query, opts));
 	});
+	skills.command("top").description("List skills.sh's most installed skills, or the last 24 hours with --trending").option("--trending", "rank by the last 24 hours instead of all time").option("--limit <n>", "max results to return (up to 50)").action(async (opts, cmd) => {
+		await printAnswer(cmd, () => runSkillsTop(getAppClientFromCommand(cmd), opts));
+	});
 	skills.command("preview").description("Show what a source would install, without installing it").argument("<source>", "owner/repo@skill or owner/repo@skill#ref").action(async (source, _opts, cmd) => {
 		await printAnswer(cmd, () => runSkillsPreview(getAppClientFromCommand(cmd), source));
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standards/cli",
-  "version": "1.0.0-alpha.418",
+  "version": "1.0.0-alpha.419",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
@@ -23,9 +23,9 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@standards/client": "1.0.0-alpha.418",
-    "@standards/constants": "1.0.0-alpha.418",
-    "@standards/schema": "1.0.0-alpha.418",
+    "@standards/client": "1.0.0-alpha.419",
+    "@standards/constants": "1.0.0-alpha.419",
+    "@standards/schema": "1.0.0-alpha.419",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "jiti": "2.7.0"