@turri-dev/cli 0.1.4-next.fa9223b → 0.1.5-next.6df6879

package/dist/brand.js

@@ -2,8 +2,8 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 /**
- * turri's colours for what its command line prints - the ones its themes use (.pi/themes): on a dark terminal its lime
- * accent and green, on a light one its blue. Nothing is coloured when the output is not a terminal, or NO_COLOR is set;
+ * turri's colours for what its command line prints - the design system's, as its themes use them (.pi/themes): on a
+ * dark terminal neon and pink, on a light one blue whale and eggplant. Nothing is coloured when the output is not a terminal, or NO_COLOR is set;
  * a terminal without 24-bit colour gets the nearest of its sixteen.
  */
 /** Whether the terminal is light: COLORFGBG says so (a light background, 7 or 15), or pi's theme is a light one. */
@@ -35,15 +35,15 @@ function paint(stream = process.stdout) {
     };
     return {
         /** turri's accent: what to look at - a heading, a choice's number, the command to run. */
-        accent: light ? ink("#0a1fd4", 34) : ink("#e0ff6e", 93),
+        accent: light ? ink("#1e3442", 34) : ink("#5ce1e6", 96),
         /** Done, and what was written. */
-        success: light ? ink("#223936", 32) : ink("#79fc96", 92),
+        success: light ? ink("#732553", 35) : ink("#ff5c8d", 95),
         /** What is wrong: what stops turri. */
-        error: light ? ink("#d00505", 31) : ink("#dd5353", 91),
+        error: ink("#ff7a3d", 33),
         /** What works, with limits. */
-        warning: ink("#dc6803", 33),
+        warning: ink("#ff7a3d", 33),
         /** What goes with it, and can be skimmed. */
-        muted: ink("#808080", 90),
+        muted: light ? ink("#3e5a6b", 90) : ink("#85a3b2", 37),
         bold: (text) => (on ? `\x1b[1m${text}\x1b[22m` : text),
     };
 }

package/dist/cli-options.js

@@ -1,4 +1,4 @@
-import { conformanceOption, overrideConfig, reviewOption, splitModelSpec } from "./config.js";
+import { booleanOption, conformanceOption, overrideConfig, splitModelSpec } from "./config.js";
 /**
  * The command line of turri's commands: their words, and the options that stand for the config's own keys - kept apart
  * from the commands that use them, so a light one (doctor) reads them as a regenerate does without loading it.
@@ -51,19 +51,24 @@ export function optionValue(options, name) {
 }
 /**
  * The options that stand for the config's own keys - `--harness-model`, `--coding-model` (`--model`), `--judge-model`
- * and, as asked, `--review` and `--conformance-tests` - read as if config.turri.yaml had them, in their place in the
+ * and, as asked, `--review`, `--mutation-testing` and `--conformance-tests` - read as if config.turri.yaml had them, in their place in the
  * order the config resolves them in (overrideConfig): a run, or doctor, with them is the same as one with them in the
  * file. Exits on a value it cannot read.
  */
 export function configKeyOptions(options, take = {}) {
+    const flag = (name) => {
+        const given = take.review === true ? optionValue(options, name) : undefined;
+        const value = given !== undefined ? booleanOption(given) : undefined;
+        if (given !== undefined && value === undefined)
+            failOption(`--${name} takes true or false, not ${given}`);
+        return value;
+    };
     const tests = take.conformance === true ? optionValue(options, "conformance-tests") : undefined;
     const setting = tests !== undefined ? conformanceOption(tests) : undefined;
     if (tests !== undefined && setting === undefined)
         failOption(`--conformance-tests takes all, chosen, module or false, not ${tests}`);
-    const reviewed = take.review === true ? optionValue(options, "review") : undefined;
-    const review = reviewed !== undefined ? reviewOption(reviewed) : undefined;
-    if (reviewed !== undefined && review === undefined)
-        failOption(`--review takes true or false, not ${reviewed}`);
+    const review = flag("review");
+    const mutationTesting = flag("mutation-testing");
     const model = (name, key) => {
         const spec = optionValue(options, name);
         return spec !== undefined ? { [key]: splitModelSpec(spec) } : {};
@@ -74,6 +79,7 @@ export function configKeyOptions(options, take = {}) {
         ...model("judge-model", "judgeModel"),
         ...(setting !== undefined ? { conformanceTests: setting } : {}),
         ...(review !== undefined ? { review } : {}),
+        ...(mutationTesting !== undefined ? { mutationTesting } : {}),
     });
 }
 function failOption(message) {

package/dist/config-edit.js

@@ -59,6 +59,7 @@ export function settings(rules = []) {
         { key: "conformance-tests", about: "which functional specs get conformance tests", kind: "choice", options: ["all", "chosen", "module", "false"], unset: "all, where a module has test reqs", effect: "next-plan" },
         { key: "conformance-budget", about: "under conformance-tests: chosen or module, how many may be chosen - a count or a share", kind: "budget", options: ["10%", "30%", "50%", "5", "10"], unset: "no limit", effect: "next-plan" },
         { key: "review", about: "whether the code and its tests are reviewed once they pass", kind: "boolean", unset: "true", effect: "next-pulse" },
+        { key: "mutation-testing", about: "whether the coding agent and the reviewer can put a bug in the code for one test run (can_it_fail)", kind: "boolean", unset: "true", effect: "next-pulse" },
         { key: "allow-to-stop-jobs", about: "whether turri stops a running pulse the spec has moved on from", kind: "boolean", unset: "true", effect: "now" },
         { key: "release-after-pulse", about: "whether every pulse that lands code releases it", kind: "boolean", unset: "false", effect: "next-landing" },
         { key: "unittests-script", about: "the unit testing script, by path from the project root", kind: "path", unset: "the one run_unittests*.sh found", effect: "next-test-run" },

package/dist/config.js

@@ -21,6 +21,7 @@ import { projectDirOf } from "./regenerate/paths.js";
  * conformance-tests: chosen                                 # all, chosen (those with acceptance tests, and those the chooser picks after each pulse), module (the chooser picks, and plans, once the module is regenerated) or false (default: false)
  * conformance-budget: 30%                                   # under chosen or module: how many functional specs a module may have chosen, beside those with acceptance tests - a count or a share (default: no limit)
  * review: false                                             # review the code and its tests once they pass (default: true)
+ * mutation-testing: false                                   # give the coding agent and the reviewer can_it_fail (default: true)
  * allow-to-stop-jobs: false                                 # stop a running job the spec moved on from (default: true)
  * release-after-pulse: true                                 # release what each pulse lands, as its last stage, before the next pulse (default: false)
  * rules-off: [integrations]                                 # ***plain rules to leave out of the prompts, by name (default: none)
@@ -156,6 +157,23 @@ export function chooseStack(stack) {
 export function withStack(stack, work) {
     return pinnedStack.run({ stack }, work);
 }
+/** The words that choose no stack: the project's config alone. */
+export const NO_STACK = ["none", "off", "base", "-"];
+/**
+ * The stack `name` names for the project at `root` - undefined for none - refused when the project has no file for
+ * it, with the stacks it has.
+ */
+export function stackNamed(root, name) {
+    const wanted = name.trim();
+    if (wanted === "" || NO_STACK.includes(wanted.toLowerCase()))
+        return undefined;
+    const stacks = stacksOf(root);
+    if (stacks.includes(wanted))
+        return wanted;
+    throw new Error(stacks.length > 0
+        ? `There is no stack ${wanted} in ${root}. Its stacks: ${stacks.join(", ")} - or none.`
+        : `${root} has no stacks: a stack is a ${stackConfigFile("<stack>")} beside config.turri.yaml.`);
+}
 /** The stack a project folder is built with now: the one chosen, when the folder has a file for it. */
 export function stackOf(root) {
     const stack = chosenStack();
@@ -331,6 +349,7 @@ export const CONFIG_KEYS = {
     conformanceTests: "conformance-tests",
     conformanceBudget: "conformance-budget",
     review: "review",
+    mutationTesting: "mutation-testing",
     allowToStopJobs: "allow-to-stop-jobs",
     releaseAfterPulse: "release-after-pulse",
     unittestsScript: "unittests-script",
@@ -416,8 +435,8 @@ export function overrideConfig(overrides) {
 export function conformanceOption(value) {
     return conformanceSetting(value);
 }
-/** `--review <value>`: the config's own, true or false. Undefined for anything else. */
-export function reviewOption(value) {
+/** `--review <value>`, `--mutation-testing <value>`: the config's own, true or false. Undefined for anything else. */
+export function booleanOption(value) {
     const word = value.trim().toLowerCase();
     return word === "true" ? true : word === "false" ? false : undefined;
 }
@@ -487,6 +506,7 @@ function readConfigFile(path) {
         conformanceTests: conformanceSetting(conformance),
         conformanceBudget: budgetSetting(raw[CONFIG_KEYS.conformanceBudget]),
         review: typeof raw[CONFIG_KEYS.review] === "boolean" ? raw[CONFIG_KEYS.review] : undefined,
+        mutationTesting: typeof raw[CONFIG_KEYS.mutationTesting] === "boolean" ? raw[CONFIG_KEYS.mutationTesting] : undefined,
         allowToStopJobs: typeof raw[CONFIG_KEYS.allowToStopJobs] === "boolean" ? raw[CONFIG_KEYS.allowToStopJobs] : undefined,
         releaseAfterPulse: typeof raw[CONFIG_KEYS.releaseAfterPulse] === "boolean" ? raw[CONFIG_KEYS.releaseAfterPulse] : undefined,
         unittestsScript: text(raw[CONFIG_KEYS.unittestsScript]),

package/dist/cultivate-cli.js

@@ -7,40 +7,33 @@ import { skillRunDir } from "./regenerate/paths.js";
 import { loadSkill } from "./skill.js";
 import { discoverSkills } from "./skills.js";
 import { PACKAGE_ROOT } from "./environment.js";
-const c = {
-    dim: (s) => `\x1b[2m${s}\x1b[0m`,
-    bold: (s) => `\x1b[1m${s}\x1b[0m`,
-    green: (s) => `\x1b[32m${s}\x1b[0m`,
-    red: (s) => `\x1b[31m${s}\x1b[0m`,
-    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
-    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
-};
+import { c } from "./module-report.js";
 const reporter = {
-    step: (name, attempt) => console.log(`\n${c.bold(c.cyan(`> step ${name}`))} ${c.dim(`attempt ${attempt}`)}`),
+    step: (name, attempt) => console.log(`\n${c.bold(c.accent(`> step ${name}`))} ${c.dim(`attempt ${attempt}`)}`),
     artifact: (path, body) => {
         console.log(c.dim(`  ${path}:`));
         for (const line of body.split("\n"))
             console.log(c.dim(`  | ${line}`));
     },
     gate: (name, judges) => console.log(judges === 0
-        ? `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim("no artifact - failing without spending judges")}`
-        : `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`${judges} independent judges`)}`),
+        ? `${c.bold(c.warning(`> gate ${name}`))} ${c.dim("no artifact - failing without spending judges")}`
+        : `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`${judges} independent judges`)}`),
     livePass: (step, scope, findings) => console.log(findings === 0
         ? c.dim(`  review ${step}: ${scope} - clean`)
-        : `  ${c.yellow(`review ${step}`)}: ${scope} ${c.dim(`- ${findings} to fix`)}`),
+        : `  ${c.warning(`review ${step}`)}: ${scope} ${c.dim(`- ${findings} to fix`)}`),
     liveReview: (name, passes, findings) => console.log(findings === 0
-        ? `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`reviewer read along in ${passes} passes, nothing outstanding`)}`
-        : `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`${findings} unresolved from the reviewer - failing without spending judges`)}`),
+        ? `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`reviewer read along in ${passes} passes, nothing outstanding`)}`
+        : `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`${findings} unresolved from the reviewer - failing without spending judges`)}`),
     judge: (index, model, verdict, violations) => {
-        const mark = verdict === "pass" ? c.green("pass") : c.red(verdict);
+        const mark = verdict === "pass" ? c.success("pass") : c.error(verdict);
         console.log(`  judge ${index + 1} ${c.dim(`(${model})`)}: ${mark}${violations ? c.dim(` (${violations})`) : ""}`);
     },
     outcome: (name, decision, critique) => {
         const colour = {
-            advance: c.green,
-            retry: c.yellow,
-            escalate: c.yellow,
-            abort: c.red,
+            advance: c.success,
+            retry: c.warning,
+            escalate: c.warning,
+            abort: c.error,
         };
         console.log(`  ${c.bold(colour[decision](decision))} ${c.dim(`<- gate ${name}`)}`);
         if (critique)
@@ -78,7 +71,7 @@ async function main() {
             select: async (title, options, context) => {
                 const rl = createInterface({ input: process.stdin, output: process.stdout });
                 const list = options.map((option, i) => `  ${c.bold(String(i + 1))}. ${option}`).join("\n");
-                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.cyan("? "))}${title}\n${list}\n> `)).trim();
+                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.accent("? "))}${title}\n${list}\n> `)).trim();
                 rl.close();
                 const index = Number.parseInt(reply, 10);
                 if (Number.isInteger(index) && index >= 1 && index <= options.length)
@@ -87,13 +80,13 @@ async function main() {
             },
             input: async (title, context) => {
                 const rl = createInterface({ input: process.stdin, output: process.stdout });
-                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.cyan("? "))}${title}\n> `)).trim();
+                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.accent("? "))}${title}\n> `)).trim();
                 rl.close();
                 return reply === "" ? undefined : reply;
             },
         }),
         escalate: async ({ question, critique }) => {
-            console.log(`\n${c.bold(c.yellow("! human review required"))}`);
+            console.log(`\n${c.bold(c.warning("! human review required"))}`);
             console.log(c.dim(critique));
             const rl = createInterface({ input: process.stdin, output: process.stdout });
             const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
@@ -101,7 +94,7 @@ async function main() {
             return answer === "y";
         },
     });
-    console.log(`\n${result.ok ? c.green(c.bold("run complete")) : c.red(c.bold("run aborted at a gate"))} ${c.dim(`artifacts in ${relative(cwd, skillRunDir(cwd, skill.name))}`)}`);
+    console.log(`\n${result.ok ? c.success(c.bold("run complete")) : c.error(c.bold("run aborted at a gate"))} ${c.dim(`artifacts in ${relative(cwd, skillRunDir(cwd, skill.name))}`)}`);
     process.exit(result.ok ? 0 : 1);
 }
 main().catch((err) => {