@standards/cli 1.0.0-alpha.431 → 1.0.0-alpha.434

package/dist/bin.mjs

@@ -486,6 +486,7 @@ function questionsOf(decision) {
 		return [{
 			id: entry.id,
 			question: typeof entry.question === "string" ? entry.question : "",
+			...typeof entry.context === "string" && entry.context.trim() !== "" ? { context: entry.context.trim() } : {},
 			multiSelect: entry.multiSelect === true,
 			options: Array.isArray(entry.options) ? entry.options.filter(isOption) : []
 		}];
@@ -525,14 +526,13 @@ function decisionUrl(cmd, decision) {
 	const sessionId = sessionIdOf(decision);
 	return sessionId ? conversationUrl(cmd, sessionId) : appUrl(cmd);
 }
-/** A decision as one block of text: title, why, change, numbered options, setup commands. */
+/** A decision as one block of text: title, each question with its context and numbered options, setup commands. */
 function renderDecision(decision) {
 	const lines = [`${decision.title}  (${decision.type}, ${decision.id})`];
-	if (decision.why) lines.push(`  why: ${decision.why}`);
-	if (decision.change) lines.push(`  change: ${decision.change}`);
 	for (const [index, question] of questionsOf(decision).entries()) {
 		const multi = question.multiSelect ? " (several: 1,3)" : "";
 		lines.push(`  Q${index + 1}. ${question.question}${multi}`);
+		if (question.context) lines.push(`      ${question.context}`);
 		for (const option of numberedOptions(question)) lines.push(`      ${option}`);
 	}
 	for (const variable of setupVariablesOf(decision)) lines.push(`  ${variable.label}: ${secretCommand(variable)}`);
@@ -550,6 +550,7 @@ function summarizeDecision$1(decision) {
 		questions: questionsOf(decision).map((question) => ({
 			id: question.id,
 			question: question.question,
+			...question.context && { context: question.context },
 			...question.multiSelect && { multiSelect: true },
 			options: numberedOptions(question)
 		}))
@@ -558,8 +559,6 @@ function summarizeDecision$1(decision) {
 function describeDecision(cmd, decision) {
 	return {
 		...summarizeDecision$1(decision),
-		why: decision.why ?? null,
-		change: decision.change ?? null,
 		links: decision.links.map(formatDecisionLink),
 		setup: setupVariablesOf(decision).map((variable) => ({
 			key: variable.key,
@@ -663,7 +662,7 @@ function registerDecisionsCommand(program) {
 	decisions.command("list").description("List open decisions, options numbered from 1").option("--all", "every decision not archived, answered ones included").action(async (opts, cmd) => {
 		formatOutput((await readDecisions(getAppClientFromCommand(cmd), opts.all ? void 0 : "open")).map(summarizeDecision$1), getFormat(cmd));
 	});
-	decisions.command("show").description("Show a decision: why, change, numbered options, links, setup commands").argument("<id>", "decision id").action(async (id, _opts, cmd) => {
+	decisions.command("show").description("Show a decision: its questions with their context, numbered options, links, setup commands").argument("<id>", "decision id").action(async (id, _opts, cmd) => {
 		formatOutput(describeDecision(cmd, await findDecision(getAppClientFromCommand(cmd), id)), getFormat(cmd));
 	});
 	decisions.command("answer").description("Answer a decision: yes/no, an option number or label per question, changes, continue/skip, configure").argument("<id>", "decision id").argument("[answer...]", "the answer, one per question for a question").option("--reason <reason>", "why, with an approval").option("--feedback <feedback>", "what to change, with a review's changes").option("--skip", "skip every question").action(async (id, args, flags, cmd) => {
@@ -1904,7 +1903,7 @@ async function deleteSecret(client, owner, key) {
 function stripped(result) {
 	return Array.isArray(result) ? result.map(withoutValue) : withoutValue(result);
 }
-/** A workspace secret that reaches no environment yet; an update keeps the key's reach. */
+/** A workspace secret no environment lists yet; an update keeps the environments that list it. */
 function reachesNoEnvironment(result) {
 	if (Array.isArray(result)) return false;
 	const { environments } = result;
@@ -1917,7 +1916,7 @@ function registerSecretsCommand(program) {
 		const client = getAppClientFromCommand(cmd);
 		formatOutput((await listOwnerSecrets(client, await resolveOwner(client, opts))).map(withoutValue), getFormat(cmd));
 	});
-	secrets.command("set").description("Set a secret from piped stdin: printf %s \"$VALUE\" | standards secrets set KEY").argument("<KEY>", "secret key").allowExcessArguments(false).option("--private", "your own secret").option("--env <env>", "an environment's secret (name or id)").option("--repository <owner/name>", "scope an environment's secret to one repository").option("--environments <env,…|all>", "the environments a new workspace secret reaches").option("--plain", "store it as non-sensitive").action(async (key, opts, cmd) => {
+	secrets.command("set").description("Set a secret from piped stdin: printf %s \"$VALUE\" | standards secrets set KEY").argument("<KEY>", "secret key").allowExcessArguments(false).option("--private", "your own secret").option("--env <env>", "an environment's secret (name or id)").option("--repository <owner/name>", "scope an environment's secret to one repository").option("--environments <env,…|all>", "the environments that list a new workspace secret (all: every current one)").option("--plain", "store it as non-sensitive").action(async (key, opts, cmd) => {
 		checkOwnerFlags(opts);
 		if (opts.environments !== void 0 && (opts.private || opts.env)) throw new ValidationError("--environments only applies to a workspace secret", []);
 		const value = await readPipedValue(`secrets set ${key}`);
@@ -1929,7 +1928,7 @@ function registerSecretsCommand(program) {
 			isSensitive: !opts.plain
 		}, opts.environments);
 		formatOutput(stripped(result), getFormat(cmd));
-		if (owner.kind === "workspace" && reachesNoEnvironment(result)) process.stderr.write("Reaches no environment yet: re-run with --environments <env,…|all>\n");
+		if (owner.kind === "workspace" && reachesNoEnvironment(result)) process.stderr.write("Used by no environment yet: re-run with --environments <env,…|all> (all = every current environment)\n");
 	});
 	secrets.command("delete").description("Delete a secret").argument("<KEY>", "secret key").option("--private", "your own secret").option("--env <env>", "an environment's secret (name or id)").option("--repository <owner/name>", "the repository's value of an environment's secret").option("--yes", "delete without confirmation").action(async (key, opts, cmd) => {
 		checkOwnerFlags(opts);

package/guide/agents.md

@@ -84,7 +84,7 @@ standards sessions archive <id>
 
 ```bash
 standards decisions list [--all]       # open by default; options numbered from 1
-standards decisions show <id>          # title, why, change, questions, links
+standards decisions show <id>          # title, each question with its context, links
 standards decisions answer <id> …
 ```
 

package/package.json

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