@bensandee/tooling 0.84.1 → 0.84.3

package/dist/bin.mjs

@@ -269,7 +269,7 @@ function loadEnvFileForBin(rawArgs, bin, io = processIo) {
 */
 const envFileLoad = loadEnvFileForBin(process.argv.slice(2), {
 	name: "bst",
-	version: "0.84.1"
+	version: "0.84.3"
 });
 //#endregion
 //#region ../cli-kit/src/logger.ts
@@ -5777,8 +5777,8 @@ function declaredPublishRegistries(targetDir, structure, rootPackageJson) {
 * shape of custom regex manager in the root `renovate.json` can rewrite both this version and this
 * digest (`customManagers` entries scoped to this file).
 */
-const MISE_VERSION = "2026.9.18";
-const MISE_LINUX_X64_SHA256 = "d24fe0bf7e613824ad99f7b8dac3f2b381a37b9f75f84dd250855217095a8de4";
+const MISE_VERSION = "2026.10.0";
+const MISE_LINUX_X64_SHA256 = "57ced973f968b8fbab07aa8e32bd7077d4a357e200a22356d98963c723c6de0a";
 /** Where generated Forgejo workflows fetch the shared mise setup action: a composite action in
 * `bensandee/common`, on the forge every fleet repo lives on. GitHub cannot reach it; the
 * generators keep inline steps there. */
@@ -7163,7 +7163,7 @@ function buildManagedDevDeps(ctx) {
 	const devDeps = { ...rootDevDeps(ctx.config) };
 	if (!isMonorepo) Object.assign(devDeps, perPackageDevDeps(ctx.config));
 	if (ctx.config.stack !== "none" || ctx.config.ci === "forgejo") devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.14.5";
-	if (!isWorkspacePackage(ctx, "@bensandee/tooling")) devDeps["@bensandee/tooling"] = "0.84.1";
+	if (!isWorkspacePackage(ctx, "@bensandee/tooling")) devDeps["@bensandee/tooling"] = "0.84.3";
 	if (ctx.config.useEslintPlugin && ctx.config.stack !== "none") devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.15.2";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = {
 		"@changesets/cli": "3.0.3",
@@ -12696,7 +12696,7 @@ function reportFailures(failed, command) {
 function generateMigratePrompt(results, config, detected) {
 	const sections = [];
 	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.84.1 repo:sync\` on ${timestamp}_\n`);
+	sections.push(`# Migration Prompt\n\n_Generated by \`@bensandee/tooling@0.84.3 repo:sync\` on ${timestamp}_\n`);
 	const changed = results.filter((r) => r.action === "created" || r.action === "updated" || r.action === "archived");
 	if (changed.length > 0) {
 		const items = changed.map((r) => {
@@ -25939,7 +25939,7 @@ async function refusalMessage(res) {
 	try {
 		const parsed = ErrorBodySchema.safeParse(JSON.parse(text));
 		if (parsed.success) return parsed.data.message;
-	} catch {}
+	} catch (_error) {}
 	return text;
 }
 /** Delete one branch. The name is encoded per segment so `feat/a/b` keeps its slashes. */
@@ -26183,12 +26183,15 @@ function conventionalActiveDirs(exec) {
 * prefix replaced by the terminal verb (`docs/plan-foo.md` ->
 * `docs/retired/completed-foo.md`); anything else (a `plans`/`specs` dir doc,
 * date-prefixed superpowers plan or not) keeps its basename and moves to the
-* sibling `retired/` directory. The single place `docs:retire` reads this
-* convention from, so it can never drift from what `discoverPairs` expects.
+* sibling `retired/` directory. A doc already in a retired directory stays
+* where it is -- re-retiring one to add its retire paragraph once moved it a
+* level deeper, into `retired/retired/`. The single place `docs:retire` reads
+* this convention from, so it can never drift from what `discoverPairs` expects.
 */
 function retireDestination(src, verb) {
 	const dir = path.posix.dirname(src);
 	const base = path.posix.basename(src);
+	if (RETIRED_DIR_NAMES$1.includes(path.posix.basename(dir))) return src;
 	if (dir === DOCS_ROOT && LEGACY_ACTIVE_PATTERN.test(base)) return `${DOCS_ROOT}/${RETIRED_DIR}/${verb}-${base.slice(5)}`;
 	return `${dir}/${RETIRED_DIR}/${base}`;
 }
@@ -26404,6 +26407,11 @@ function checkPair(exec, pair, config, opts) {
 * unquoted too) -- with two deliberate deviations: an empty value is allowed (a label alone
 * on its line, link on the next); no `i` flag (no lowercase `implements:` in this repo). */
 const IMPLEMENTS_LINE_RE = /^(?:(>[ \t]*)|[ \t]*)(?:\*\*)?Implements(?:\*\*)?:.*$/m;
+/** The fallback link line for a plan written in another format, which names its spec with a
+* `Spec:` label (`**Spec:** [...]` in the superpowers plan header) and no `Implements:` line.
+* Same shape as {@link IMPLEMENTS_LINE_RE}; read only when that one does not match, so a plan
+* carrying both is linked by its `Implements:` line alone. */
+const SPEC_LINE_RE = /^(?:(>[ \t]*)|[ \t]*)(?:\*\*)?Spec(?:\*\*)?:.*$/m;
 /**
 * The spec link(s) on a plan's `Implements:` block, if any -- not every relative link in the
 * body. A plan's prose routinely links other documents (a superseded spec, a design doc it
@@ -26417,7 +26425,7 @@ const IMPLEMENTS_LINE_RE = /^(?:(>[ \t]*)|[ \t]*)(?:\*\*)?Implements(?:\*\*)?:.*
 */
 function implementsLinkTargets(body, fileDir) {
 	const scannable = stripCode(body);
-	const match = IMPLEMENTS_LINE_RE.exec(scannable);
+	const match = IMPLEMENTS_LINE_RE.exec(scannable) ?? SPEC_LINE_RE.exec(scannable);
 	if (match === null) return /* @__PURE__ */ new Set();
 	const { lines: continuation } = continuationLines(scannable, match.index + match[0].length, match[1] !== void 0);
 	const block = [match[0], ...continuation].join("\n");
@@ -27111,7 +27119,7 @@ function buildRelocatePlan(exec, moves) {
 	for (const { from, to } of moves) {
 		if (moveMap.has(from)) throw new FatalError(`docs:relocate: duplicate source ${from}`);
 		moveMap.set(from, to);
-		if (exec.exists(from)) plannedMoves.push({
+		if (exec.exists(from) && from !== to) plannedMoves.push({
 			from,
 			to,
 			status: "pending"
@@ -27315,14 +27323,12 @@ const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 function validateRetireArgs(exec, src, opts) {
 	if (!isRetireVerb(opts.status)) throw new FatalError(`docs:retire: unrecognized --status "${opts.status}" (expected one of: ${RETIRE_VERBS.join(", ")})`);
 	const verb = opts.status;
-	const date = opts.date ?? localToday(/* @__PURE__ */ new Date());
-	if (!DATE_RE.test(date)) throw new FatalError(`docs:retire: --date must be YYYY-MM-DD, got: ${date}`);
+	if (opts.date !== void 0 && !DATE_RE.test(opts.date)) throw new FatalError(`docs:retire: --date must be YYYY-MM-DD, got: ${opts.date}`);
 	if (!src.endsWith(".md")) throw new FatalError(`docs:retire: source must be a .md file: ${src}`);
 	const dest = opts.dest !== void 0 ? path.posix.normalize(opts.dest) : retireDestination(src, verb);
 	if (src !== dest && exec.exists(src) && exec.exists(dest)) throw new FatalError(`docs:retire: refusing to overwrite existing destination: ${dest}`);
 	return {
 		verb,
-		date,
 		dest
 	};
 }
@@ -27486,7 +27492,7 @@ function formatRetireLines(src, dest, relocatePlan, lifecycleSummary) {
 */
 function runDocsRetire(exec, src, opts) {
 	const vc = { verbose: opts.verbose ?? false };
-	const { verb, date, dest } = validateRetireArgs(exec, src, opts);
+	const { verb, dest } = validateRetireArgs(exec, src, opts);
 	const relocatePlan = buildRelocatePlan(exec, [{
 		from: src,
 		to: dest
@@ -27496,6 +27502,7 @@ function runDocsRetire(exec, src, opts) {
 	const relinkRewrite = relocatePlan.rewrites.find((r) => r.file === dest);
 	const baseContent = relinkRewrite?.content ?? exec.readFile(move.status === "pending" ? src : dest);
 	if (baseContent === void 0) throw new FatalError(`docs:retire: cannot read ${move.status === "pending" ? src : dest}`);
+	const date = opts.date ?? datedStatusValue(baseContent) ?? localToday(/* @__PURE__ */ new Date());
 	const { content: lifecycleContent, summary, edits: lifecycle } = applyLifecycleEdits(baseContent, dest, verb, date, opts.shipped);
 	const delinked = delinkDocument(lifecycleContent, path.posix.dirname(dest));
 	const finalContent = delinked.content;
@@ -27565,7 +27572,7 @@ const docsRetireCommand = defineCommand({
 		},
 		date: {
 			type: "string",
-			description: "Retirement date, YYYY-MM-DD (defaults to today, local time)"
+			description: "Retirement date, YYYY-MM-DD (defaults to the date of an existing terminal Status: line, else today, local time)"
 		},
 		shipped: {
 			type: "string",
@@ -31255,7 +31262,7 @@ setForgejoLogger(log$1);
 * `local <sha>[-dirty]` otherwise -- so an artifact built from the working tree
 * can't pass itself off as the published release whose version it carries.
 */
-const displayVersion = "0.84.1";
+const displayVersion = "0.84.3";
 /**
 * The registered `bst` subcommand map, exported so both the JSON entry path below (resolving a
 * command name before citty parses anything) and the coverage test (enumerating every

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.84.1",
+  "version": "0.84.3",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "license": "MIT",
   "repository": {