@orchestraworks/cli 0.3.0 → 0.5.1

package/dist/cli/core/banner.d.ts

@@ -0,0 +1,10 @@
+export interface BannerTerminal {
+    readonly isTTY?: boolean;
+    readonly columns?: number;
+}
+/**
+ * The banner and a blank line, or the empty string. `NO_COLOR` follows no-color.org: any non-empty value
+ * turns it off. `COLORTERM` of `truecolor` or `24bit` selects 24-bit color. A terminal narrower than the
+ * mark and the wordmark gets the mark with the plain word beside its centre.
+ */
+export declare function helpBanner(terminal: BannerTerminal, env: NodeJS.ProcessEnv): string;

package/dist/cli/core/banner.js

@@ -0,0 +1,63 @@
+// The Orchestra mark at the top of bare `orchestra` and `orchestra --help`, for a person at a terminal.
+// A coding agent usually reads piped output, so the banner prints only to a terminal with color allowed:
+// piped output stays plain text with no escape codes.
+/**
+ * The console's 48-dot mark (`console/src/components/BrandMark.tsx`), its circles rasterized onto a
+ * 42-by-40 dot grid and written as braille, eight dots to a character.
+ */
+const MARK = [
+    "⠀⠀⠀⠀⢀⣤⡀⠀⠀⣴⣶⡄⣼⣿⡆⠀⠀⠀⠀⠀⠀",
+    "⠀⠀⠀⠀⠹⠿⠧⣿⡆⠈⠉⣶⡌⢹⣷⡄⢀⣀⠀⠀⠀",
+    "⢠⣶⣄⣿⡷⢰⣶⠀⠀⠿⠀⢈⡀⢀⣭⠀⢿⡿⠂⠀⠀",
+    "⠘⠛⢋⣤⡀⢠⡄⠀⠶⠀⠀⠈⠁⠈⠉⠀⣿⠆⣾⣿⡇",
+    "⢰⣿⡯⠙⣁⠀⠀⣤⠀⠀⠉⠀⠙⠀⠰⠆⠀⢴⣿⡍⠀",
+    "⠀⠉⣤⣌⠛⠀⣤⠀⠀⠒⠀⣀⠀⢴⠄⠐⠿⠂⣩⣄⠀",
+    "⠀⣤⣿⠋⣤⡄⢀⡀⠀⠦⠀⢀⠀⢀⣤⠀⣶⣮⠿⠿⠀",
+    "⠀⠻⠟⢁⣭⡅⠈⡋⠀⣀⡀⠛⢀⣤⡁⣠⣍⠁⠀⠀⠀",
+    "⠀⠀⠀⠘⣻⣧⡸⠿⣂⡙⢣⣤⡄⣙⡁⠻⠟⠀⠀⠀⠀",
+    "⠀⠀⠀⠀⠻⠿⠇⠸⣿⠗⠈⠛⠹⣿⡿⠀⠀⠀⠀⠀⠀",
+];
+/** "ORCHESTRA" in the figlet ANSI Shadow face. */
+const WORDMARK = [
+    " ██████╗ ██████╗  ██████╗██╗  ██╗███████╗███████╗████████╗██████╗  █████╗ ",
+    "██╔═══██╗██╔══██╗██╔════╝██║  ██║██╔════╝██╔════╝╚══██╔══╝██╔══██╗██╔══██╗",
+    "██║   ██║██████╔╝██║     ███████║█████╗  ███████╗   ██║   ██████╔╝███████║",
+    "██║   ██║██╔══██╗██║     ██╔══██║██╔══╝  ╚════██║   ██║   ██╔══██╗██╔══██║",
+    "╚██████╔╝██║  ██║╚██████╗██║  ██║███████╗███████║   ██║   ██║  ██║██║  ██║",
+    " ╚═════╝ ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝",
+];
+const MARK_WIDTH = MARK[0].length;
+const GAP = "   ";
+/** The mark and the wordmark side by side. */
+const BANNER_WIDTH = MARK_WIDTH + GAP.length + WORDMARK[0].length;
+/** The first mark row the wordmark sits on, which centres it on the mark. */
+const WORDMARK_TOP = Math.floor((MARK.length - WORDMARK.length) / 2);
+const WORD = "Orchestra";
+/** The console's light-theme accent, `consolePalette.json` `light.accent`, as 24-bit RGB. */
+const ACCENT_TRUE_COLOR = "\u001b[38;2;66;99;235m";
+/** The nearest color in the 256-color table, for a terminal that does not announce 24-bit color. */
+const ACCENT_256 = "\u001b[38;5;63m";
+const BOLD = "\u001b[1m";
+const RESET = "\u001b[0m";
+/**
+ * The banner and a blank line, or the empty string. `NO_COLOR` follows no-color.org: any non-empty value
+ * turns it off. `COLORTERM` of `truecolor` or `24bit` selects 24-bit color. A terminal narrower than the
+ * mark and the wordmark gets the mark with the plain word beside its centre.
+ */
+export function helpBanner(terminal, env) {
+    if (terminal.isTTY !== true || (env.NO_COLOR ?? "") !== "") {
+        return "";
+    }
+    const accent = /^(truecolor|24bit)$/i.test(env.COLORTERM ?? "") ? ACCENT_TRUE_COLOR : ACCENT_256;
+    const wide = (terminal.columns ?? BANNER_WIDTH) >= BANNER_WIDTH;
+    const lines = MARK.map((row, index) => {
+        if (wide) {
+            const word = WORDMARK[index - WORDMARK_TOP];
+            return word === undefined ? `${accent}${row}${RESET}` : `${accent}${row}${GAP}${word.trimEnd()}${RESET}`;
+        }
+        return index === Math.floor(MARK.length / 2)
+            ? `${accent}${row}${RESET}${GAP}${BOLD}${WORD}${RESET}`
+            : `${accent}${row}${RESET}`;
+    });
+    return `${lines.join("\n")}\n\n`;
+}

package/dist/cli/core/invocation.js

@@ -14,7 +14,7 @@ import { errorCode } from "./errors.js";
 export function addAuthOptions(command) {
     return command
         .option("--profile <name>", "named auth profile to read (default profile if omitted)")
-        .option("--base-url <url>", "platform base URL (overrides PLATFORM_BASE_URL and the stored profile)")
+        .option("--base-url <url>", "platform base URL (overrides ORCHESTRA_BASE_URL, PLATFORM_BASE_URL and the stored profile)")
         .option("--org <id>", "target organization id (overrides ORCHESTRA_ORGANIZATION_ID and the stored profile)");
 }
 /**

package/dist/cli/core/package-root.d.ts

@@ -1,11 +1,12 @@
+import { type KitSkill } from "../skill-install-fs.js";
 /**
  * The package root this process runs from. Under `npx orchestra` outside an installed folder this is npm's
  * disposable cache, which `skills install` refuses to link into.
  */
 export declare function runningPackageRoot(): string;
 /**
- * The bundled authoring skill's path, or `null` when this install does not carry it. The exists-guard is the
+ * A bundled skill's path, or `null` when this install does not carry it. The exists-guard is the
  * contract: callers print this as a pointer to follow, and pointing a reader at a path with nothing behind
  * it is a worse repair than printing none. `packageRoot` is the test seam.
  */
-export declare function resolveBundledSkillPath(packageRoot?: string): string | null;
+export declare function resolveBundledSkillPath(packageRoot?: string, skill?: KitSkill): string | null;

package/dist/cli/core/package-root.js

@@ -6,7 +6,7 @@
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { SKILL_DIR_IN_PACKAGE, SKILL_FILE_NAME } from "../skill-install-fs.js";
+import { SKILL_FILE_NAME, skillPackageDir } from "../skill-install-fs.js";
 /**
  * The package root this process runs from. Under `npx orchestra` outside an installed folder this is npm's
  * disposable cache, which `skills install` refuses to link into.
@@ -15,11 +15,11 @@ export function runningPackageRoot() {
     return fileURLToPath(new URL("../../..", import.meta.url));
 }
 /**
- * The bundled authoring skill's path, or `null` when this install does not carry it. The exists-guard is the
+ * A bundled skill's path, or `null` when this install does not carry it. The exists-guard is the
  * contract: callers print this as a pointer to follow, and pointing a reader at a path with nothing behind
  * it is a worse repair than printing none. `packageRoot` is the test seam.
  */
-export function resolveBundledSkillPath(packageRoot = runningPackageRoot()) {
-    const skillPath = join(packageRoot, SKILL_DIR_IN_PACKAGE, SKILL_FILE_NAME);
+export function resolveBundledSkillPath(packageRoot = runningPackageRoot(), skill = "orchestra") {
+    const skillPath = join(packageRoot, skillPackageDir(skill), SKILL_FILE_NAME);
     return existsSync(skillPath) ? skillPath : null;
 }

package/dist/cli/core/skill-pointer.d.ts

@@ -5,10 +5,15 @@ export interface SkillPointer {
     readonly fields: {
         readonly skillPath: string;
     };
+    /**
+     * The lines `orchestra` and `orchestra --help` end with. A coding agent often runs the help right after the
+     * install, and npm hides install-script output, so this tail is where the agent learns which skill to read.
+     */
+    readonly helpEpilogue: readonly string[];
 }
 /**
  * `null` when this install carries no bundled manual, in which case every surface prints nothing at all.
- * Omission is the contract, not a degraded mode. `skillPath` is the test seam.
+ * Omission is the contract, not a degraded mode. `skillPath` and `setupSkillPath` are the test seams.
  */
-export declare function bundledSkillPointer(skillPath?: string | null): SkillPointer | null;
+export declare function bundledSkillPointer(skillPath?: string | null, setupSkillPath?: string | null): SkillPointer | null;
 export declare function emitSkillPointer(io: CliIo, pointer?: SkillPointer | null): void;

package/dist/cli/core/skill-pointer.js

@@ -1,13 +1,23 @@
 import { resolveBundledSkillPath } from "./package-root.js";
 /**
  * `null` when this install carries no bundled manual, in which case every surface prints nothing at all.
- * Omission is the contract, not a degraded mode. `skillPath` is the test seam.
+ * Omission is the contract, not a degraded mode. `skillPath` and `setupSkillPath` are the test seams.
  */
-export function bundledSkillPointer(skillPath = resolveBundledSkillPath()) {
+export function bundledSkillPointer(skillPath = resolveBundledSkillPath(), setupSkillPath = resolveBundledSkillPath(undefined, "orchestra-fdk")) {
     if (skillPath === null) {
         return null;
     }
-    return { line: `Learn orchestra: read ${skillPath}`, fields: { skillPath } };
+    return {
+        line: `Learn orchestra: read ${skillPath}`,
+        fields: { skillPath },
+        helpEpilogue: [
+            "Coding agents: read both skills before you start.",
+            `  To learn how to use the orchestra CLI, read ${skillPath}`,
+            ...(setupSkillPath === null ? [] : [`  To set up a factory, read ${setupSkillPath}`]),
+            "  To link both skills into your harness, run:",
+            "  orchestra skills install --harness claude|codex --scope project",
+        ],
+    };
 }
 export function emitSkillPointer(io, pointer = bundledSkillPointer()) {
     if (pointer !== null) {

package/dist/cli/factory/init.d.ts

@@ -13,7 +13,7 @@ type ModelKeyChoice = Exclude<TemplateChoice, "credits">;
 /** What `--model-key` takes. */
 export declare const MODEL_KEY_CHOICES: readonly ModelKeyChoice[];
 /** Every file the starter writes besides package.json, in the order it prints them. */
-export declare const STARTER_FILES: readonly ["fdk.json", "main.ts", "image/Dockerfile", "image/setup.sh", "agents/bugfix.md", "skills/codebase/SKILL.md"];
+export declare const STARTER_FILES: readonly ["fdk.json", "tsconfig.json", "main.ts", "image/Dockerfile", "image/setup.sh", "agents/bugfix.md", "skills/codebase/SKILL.md"];
 /** The starter plain `orchestra fdk init` writes, and the only one `--repository` and `--model-key` fill in. */
 export declare const DEFAULT_TEMPLATE = "bug-fix";
 /** The starters `--template` offers by name. Each is a folder under templates/ that brings its own package.json. */

package/dist/cli/factory/init.js

@@ -13,6 +13,7 @@ export const MODEL_KEY_CHOICES = TEMPLATE_CHOICES.filter((choice) => choice !==
 /** Every file the starter writes besides package.json, in the order it prints them. */
 export const STARTER_FILES = [
     "fdk.json",
+    "tsconfig.json",
     "main.ts",
     "image/Dockerfile",
     "image/setup.sh",
@@ -27,8 +28,12 @@ const TEMPLATES_DIR = "templates";
 const TEMPLATE_DIR = join(TEMPLATES_DIR, DEFAULT_TEMPLATE);
 /** The one template file `init` fills in; every other file is copied as it is. */
 const FILLED_FILE = "main.ts";
+/** What runs main.ts and checks its types; each is added at the range the kit itself is built with. */
+const STARTER_DEV_PACKAGES = ["tsx", "typescript", "@types/node"];
+/** The script the starter adds when package.json has none of that name. */
+const TYPECHECK_SCRIPT = { name: "typecheck", command: "tsc -p tsconfig.json" };
 /** Any other package in package.json means the folder is a codebase rather than a new folder beside one. */
-const PACKAGES_ALLOWED = new Set([KIT_PACKAGE_NAME, "tsx"]);
+const PACKAGES_ALLOWED = new Set([KIT_PACKAGE_NAME, ...STARTER_DEV_PACKAGES]);
 const DEPENDENCY_FIELDS = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
 /** Leaves room for the longest construct path the template declares, so every derived slug stays within 60. */
 const FACTORY_NAME_MAX = 30;
@@ -90,15 +95,24 @@ export async function initCommand(options, io = defaultIo) {
         };
     });
     const record = manifest.kind === "object" ? manifest.record : {};
-    const addsTsx = !listsPackage(record, "tsx");
-    const devDependencies = { ...dependencyMap(record, "devDependencies"), tsx: kitTsxRange(packageRoot) };
-    const merged = { ...record, type: "module", ...(addsTsx ? { devDependencies } : {}) };
+    const added = STARTER_DEV_PACKAGES.filter((name) => !listsPackage(record, name));
+    const ranges = kitDevRanges(packageRoot, added);
+    const devDependencies = { ...dependencyMap(record, "devDependencies"), ...ranges };
+    // A `scripts` that is not an object is left as it is rather than replaced.
+    const addsTypecheck = record.scripts === undefined || (isRecord(record.scripts) && record.scripts[TYPECHECK_SCRIPT.name] === undefined);
+    const scripts = dependencyMap(record, "scripts");
+    const merged = {
+        ...record,
+        type: "module",
+        ...(addsTypecheck ? { scripts: { ...scripts, [TYPECHECK_SCRIPT.name]: TYPECHECK_SCRIPT.command } } : {}),
+        ...(added.length > 0 ? { devDependencies } : {}),
+    };
     writeFileSync(manifestPath, `${JSON.stringify(merged, null, 2)}\n`);
     for (const { path, text } of contents) {
         mkdirSync(dirname(join(dir, path)), { recursive: true });
         writeFileSync(join(dir, path), text);
     }
-    printNextSteps(io, { repository: repository.full, factoryName, choice, dir, addsTsx });
+    printNextSteps(io, { repository: repository.full, factoryName, choice, dir, added, addsTypecheck });
 }
 /** The starters this kit carries: one folder each under templates/. */
 export function availableTemplates(packageRoot = runningPackageRoot()) {
@@ -325,14 +339,19 @@ function dependencyMap(record, field) {
     const value = record[field];
     return isRecord(value) ? value : {};
 }
-/** The tsx range the kit itself is tested with, so the starter runs on the tsx the kit was proven on. */
-function kitTsxRange(packageRoot) {
+/** The ranges the kit itself is built and tested with, so the starter runs and type-checks on what the kit was proven on. */
+function kitDevRanges(packageRoot, names) {
     const manifest = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
-    const range = isRecord(manifest) ? dependencyMap(manifest, "devDependencies").tsx : undefined;
-    if (typeof range !== "string") {
-        throw new Error("this orchestra install names no tsx version to add. Reinstall the kit, then run orchestra fdk init again.");
+    const kitDev = isRecord(manifest) ? dependencyMap(manifest, "devDependencies") : {};
+    const ranges = {};
+    for (const name of names) {
+        const range = kitDev[name];
+        if (typeof range !== "string") {
+            throw new Error(`this orchestra install names no ${name} version to add. Reinstall the kit, then run orchestra fdk init again.`);
+        }
+        ranges[name] = range;
     }
-    return range;
+    return ranges;
 }
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -341,12 +360,17 @@ function printNextSteps(io, written) {
     const inputs = [...SHELL_INPUTS, ...(written.choice === "credits" ? [] : [MODEL_KEY_INPUTS[written.choice]])];
     const width = Math.max(...inputs.map(([name]) => name.length)) + 2;
     io.out(`Wrote a bug-fix factory named '${written.factoryName}' for ${written.repository} into ${written.dir}:`);
-    io.out(`  package.json (set "type": "module"${written.addsTsx ? ", added tsx to devDependencies" : ""})`);
+    const changes = [
+        `set "type": "module"`,
+        ...(written.addsTypecheck ? [`added the ${TYPECHECK_SCRIPT.name} script`] : []),
+        ...(written.added.length > 0 ? [`added ${listed(written.added)} to devDependencies`] : []),
+    ];
+    io.out(`  package.json (${changes.join(", ")})`);
     for (const path of STARTER_FILES)
         io.out(`  ${path}`);
     io.out("");
     io.out("Next, in this folder:");
-    io.out("  1. npm install");
+    io.out("  1. npm install, then npm run typecheck");
     io.out("  2. In the shell that runs orchestra, set these values. The platform's team hands them over until image");
     io.out("     hosting exists:");
     for (const [name, what] of inputs)
@@ -356,3 +380,7 @@ function printNextSteps(io, written) {
     io.out("  3. npx orchestra fdk diff");
     io.out("  4. npx orchestra fdk apply, then open the GitHub App install link it prints. It waits for the install.");
 }
+/** `a`, `a and b`, or `a, b and c`. */
+function listed(names) {
+    return names.length === 1 ? names[0] : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
+}

package/dist/cli/main.js

@@ -37,6 +37,7 @@ import { DEFAULT_TEMPLATE, initCommand, MODEL_KEY_CHOICES, OFFERED_TEMPLATES } f
 import { grantCommand } from "./api/grant.js";
 import { addAuthOptions } from "./core/invocation.js";
 import { errorDocument, reportError, settleExitCode } from "./core/errors.js";
+import { helpBanner } from "./core/banner.js";
 import { bundledSkillPointer, emitSkillPointer } from "./core/skill-pointer.js";
 import { outputModeFromArgv } from "./core/output-mode.js";
 import { defaultIo, writeLines } from "./core/output.js";
@@ -170,7 +171,7 @@ LEARN MORE
  * entirely. `pointer` is the test seam.
  */
 export function topLevelHelpText(pointer = bundledSkillPointer()) {
-    return pointer === null ? TOP_LEVEL_HELP : `${TOP_LEVEL_HELP}\n${pointer.line}\n`;
+    return pointer === null ? TOP_LEVEL_HELP : `${TOP_LEVEL_HELP}\n${pointer.helpEpilogue.join("\n")}\n`;
 }
 const REQUIRE_APPROVAL_HELP = requireApprovalHelp(IMPERATIVE_APPROVAL_DEFAULT);
 /**
@@ -294,9 +295,10 @@ export function buildProgram(handlers = defaultHandlers, pointer = bundledSkillP
     // Deliberately an own-property assignment and NOT `configureHelp`: commander copies `_helpConfiguration`
     // into every subcommand created afterwards, so configuring the formatter here would make every
     // `--help` print the top-level text too. The text is computed once and the closure returns that same
-    // string every time, so `--help` printed twice in one process cannot disagree with itself.
+    // string every time, so `--help` printed twice in one process cannot disagree with itself. The banner
+    // above it depends on the stream the help goes to: stderr for a bare `orchestra`, stdout for `--help`.
     const helpText = topLevelHelpText(pointer);
-    program.helpInformation = () => helpText;
+    program.helpInformation = (context) => `${helpBanner(context?.error === true ? process.stderr : process.stdout, process.env)}${helpText}`;
     // Registered on the program, which is where commander looks: it walks a command's ancestors when an action
     // fires, so one hook here covers the whole tree. It runs after parsing, so `--help` and a usage error —
     // both of which end during the parse — never reach it.

package/dist/cli/skill-install-fs.d.ts

@@ -10,8 +10,6 @@ export declare const KIT_INSTALL_SPEC = "@orchestraworks/cli";
 export declare const KIT_SKILLS: readonly ["orchestra", "orchestra-fdk"];
 export type KitSkill = (typeof KIT_SKILLS)[number];
 export declare function skillPackageDir(skill: KitSkill): string;
-/** The reference skill's directory, which the CLI's own pointer names. */
-export declare const SKILL_DIR_IN_PACKAGE: string;
 export declare const SKILL_FILE_NAME = "SKILL.md";
 /** "other" is a printed-path branch, never a link target. */
 export type LinkableHarness = "claude" | "codex";

package/dist/cli/skill-install-fs.js

@@ -16,8 +16,6 @@ export const KIT_SKILLS = ["orchestra", "orchestra-fdk"];
 export function skillPackageDir(skill) {
     return join("skills", skill);
 }
-/** The reference skill's directory, which the CLI's own pointer names. */
-export const SKILL_DIR_IN_PACKAGE = skillPackageDir("orchestra");
 export const SKILL_FILE_NAME = "SKILL.md";
 /**
  * Identical under a project root and under `$HOME`. The ONE home for these strings: the link math, the menu

package/dist/cli/skill.js

@@ -21,8 +21,17 @@ const LINKABLE_HARNESSES = ["claude", "codex"];
 const HARNESS_LABEL = { claude: "Claude Code", codex: "Codex" };
 const HARNESS_VALUES = ["claude", "codex", "both", "other"];
 const SCOPE_VALUES = ["user", "project"];
-/** How a person keeps the linked skills current: the global install is updated in place. */
-const UPDATE_COMMAND = `npm update -g ${KIT_INSTALL_SPEC}`;
+/**
+ * How a person keeps the linked skills current: the install the links point into is updated in place, so the
+ * command matches where the running package sits. A checkout outside both reads as global, the common case.
+ */
+function updateCommand(running) {
+    return running.kind === "project" ? `npm update ${KIT_INSTALL_SPEC}` : `npm update -g ${KIT_INSTALL_SPEC}`;
+}
+/** The folder whose `node_modules` holds a project install: `<folder>/node_modules/@orchestraworks/cli`. */
+function installFolder(packageRoot) {
+    return dirname(dirname(dirname(packageRoot)));
+}
 export async function skillInstallCommand(options, deps = {}) {
     const io = deps.io ?? defaultIo;
     const env = deps.env ?? process.env;
@@ -90,14 +99,18 @@ export async function skillInstallCommand(options, deps = {}) {
         return;
     }
     io.out("");
-    printSkillFiles(io, running.packageRoot);
+    printSkillFiles(io, running);
 }
 /** The step after the links: a harness loads a new skill only at its next start, so read them now. */
-function printSkillFiles(io, packageRoot) {
+function printSkillFiles(io, running) {
     io.out("Read each skill now; your harness loads new skills only at its next start:");
     for (const skill of KIT_SKILLS)
-        io.out(`  ${skillFileIn(packageRoot, skill)}`);
-    io.out(`\`${UPDATE_COMMAND}\` keeps them current.`);
+        io.out(`  ${skillFileIn(running.packageRoot, skill)}`);
+    io.out("The kit may be installed globally or in the factory folder.");
+    io.out(running.kind === "project"
+        ? `This one is installed in ${installFolder(running.packageRoot)}, so \`${updateCommand(running)}\`, run in ` +
+            `that folder, keeps them current.`
+        : `This one is installed globally, so \`${updateCommand(running)}\` keeps them current.`);
 }
 function parseChoice(raw, allowed, flag) {
     if (raw === undefined) {
@@ -194,7 +207,7 @@ function printPointingInstructions(io, running, anchors, fs) {
     for (const file of skillFiles)
         io.out(`  ${file}`);
     io.out("");
-    io.out(`Point your harness at each directory (a link keeps it current across '${UPDATE_COMMAND}'):`);
+    io.out(`Point your harness at each directory (a link keeps it current across '${updateCommand(running)}'):`);
     for (const harness of LINKABLE_HARNESSES) {
         // The project leg prints the RELATIVE target the command itself would write, so a hand-made link
         // travels with the repo exactly like an installed one. Nothing recomputes after this line — the