nikos 0.1.0 → 0.1.1

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
 import { runValidate } from "./commands/validate.js";
 import { runPlan } from "./commands/plan.js";
 import { runInit } from "./commands/init.js";
@@ -47,6 +48,7 @@ Commands:
   release rename <n>   Change a release's title or goal (--goal)
   release move <id> <n>  Move a story to another release, retagging its feature
   release reorder <n> <pos>  Move a release and renumber them all
+  release remove <n>   Remove an empty release and renumber the rest
   plan new <id>    Start the next version of a story's plan
   clear <id>       Check a story is Lean and Executable before building
   verify setup     Set up a Cucumber runner for this repo's stack
@@ -63,6 +65,8 @@ Commands:
   planning <cmd>   Bets, key results and the planning dashboard (nikos-planning pack;
                    run \`nikos planning help\`)
 
+  --version        Print the installed version
+
 Docs: https://nikos.tools`;
 async function main(argv) {
     const [cmd, ...rest] = argv;
@@ -70,6 +74,10 @@ async function main(argv) {
         console.log(help);
         return 0;
     }
+    if (cmd === "--version" || cmd === "-v" || cmd === "version") {
+        console.log(JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version);
+        return 0;
+    }
     const run = commands[cmd];
     if (!run) {
         console.error(`Unknown command '${cmd}'.\n\n${help}`);

package/dist/commands/init.js

@@ -44,10 +44,17 @@ export function init(root, opts = {}) {
     }
     return { intentDir, created, skipped, validation: validate(intentDir) };
 }
+const EXAMPLES = { name: '"Hello Todo"', key: "HT", dir: "." };
 export function runInit(args) {
     const opt = (n) => {
         const i = args.indexOf(`--${n}`);
-        return i >= 0 ? args[i + 1] : undefined;
+        if (i < 0)
+            return undefined;
+        const value = args[i + 1];
+        // Without this, a bare --name falls back to the folder name and the key changes silently.
+        if (value === undefined || value.startsWith("--") || !value.trim())
+            throw new Error(`--${n} needs a value, e.g. --${n} ${EXAMPLES[n] ?? "<value>"}`);
+        return value;
     };
     try {
         const r = init(opt("dir") ?? process.cwd(), { name: opt("name"), key: opt("key") });

package/dist/commands/release.js

@@ -36,6 +36,18 @@ function retag(intentDir, moved) {
             writeFileSync(file, setFeatureTag(text, "release", String(moved.get(id)), id));
     }
 }
+/** Number the releases 1, 2, 3… in list order, retagging the stories of any that changed. */
+function renumber(o) {
+    const moved = new Map();
+    o.releases.items.forEach((item, i) => {
+        if (numberOf(item) === i + 1)
+            return;
+        item.set("number", i + 1);
+        for (const id of storiesOf(item))
+            moved.set(id, i + 1);
+    });
+    retag(o.intentDir, moved);
+}
 function save(o) {
     writeFileSync(o.mapPath, o.map.toString(yamlOpts));
     return validate(o.intentDir);
@@ -46,12 +58,19 @@ const cleanTitle = (title) => {
         throw new Error("A release needs a title");
     return t;
 };
+/** Refuse a title another release already has (ignoring case), so two releases can't share a name. */
+function uniqueTitle(o, title, except) {
+    const taken = o.releases.items.find((r) => r !== except && String(r.get("title")).trim().toLowerCase() === title.toLowerCase());
+    if (taken)
+        throw new Error(`Release ${numberOf(taken)} is already called '${String(taken.get("title"))}'`);
+    return title;
+}
 /** Add the next numbered release, with no stories yet. */
 export function addRelease(input, dir) {
     const o = open(dir);
     const number = Math.max(0, ...o.releases.items.map(numberOf)) + 1;
     const goal = input.goal?.trim();
-    o.releases.add(o.map.createNode({ number, title: cleanTitle(input.title), ...(goal ? { goal } : {}), stories: [] }));
+    o.releases.add(o.map.createNode({ number, title: uniqueTitle(o, cleanTitle(input.title)), ...(goal ? { goal } : {}), stories: [] }));
     const added = o.releases.items[o.releases.items.length - 1];
     added.get("stories", true).flow = true;
     return { number, validation: save(o) };
@@ -63,7 +82,7 @@ export function renameRelease(input, dir) {
     const o = open(dir);
     const r = find(o, input.number);
     if (input.title !== undefined)
-        r.set("title", cleanTitle(input.title));
+        r.set("title", uniqueTitle(o, cleanTitle(input.title), r));
     if (input.goal !== undefined) {
         const goal = input.goal.trim();
         if (!goal)
@@ -98,6 +117,22 @@ export function moveStory(input, dir) {
     retag(o.intentDir, new Map([[input.id, input.to]]));
     return { id: input.id, from: fromNumber, to: input.to, validation: save(o) };
 }
+/** Remove an empty release and renumber the ones after it, retagging their stories. */
+export function removeRelease(input, dir) {
+    const o = open(dir);
+    const r = find(o, input.number);
+    const stories = storiesOf(r);
+    if (stories.length)
+        throw new Error(`Release ${input.number} still has ${stories.join(", ")}. Move its stories out first with nikos release move`);
+    const bets = r.get("bets", true);
+    if (isSeq(bets) && bets.items.length)
+        throw new Error(`Release ${input.number} delivers bets (${bets.items.map((b) => String(b?.value ?? b)).join(", ")}). Move them to another release first`);
+    const title = String(r.get("title"));
+    const items = o.releases.items;
+    items.splice(items.indexOf(r), 1);
+    renumber(o);
+    return { number: input.number, title, validation: save(o) };
+}
 /** Move a release to a new position and renumber them all from 1, retagging every story that moved. */
 export function reorderRelease(input, dir) {
     const o = open(dir);
@@ -108,22 +143,15 @@ export function reorderRelease(input, dir) {
     const items = o.releases.items;
     items.splice(items.indexOf(r), 1);
     items.splice(input.to - 1, 0, r);
-    const moved = new Map();
-    items.forEach((item, i) => {
-        if (numberOf(item) === i + 1)
-            return;
-        item.set("number", i + 1);
-        for (const id of storiesOf(item))
-            moved.set(id, i + 1);
-    });
-    retag(o.intentDir, moved);
+    renumber(o);
     return { order: items.map((i) => ({ number: numberOf(i), title: String(i.get("title")) })), validation: save(o) };
 }
 const USAGE = `Usage:
   nikos release add "<title>" [--goal "<goal>"]
   nikos release rename <n> ["<title>"] [--goal "<goal>"]   (--goal "" removes it)
   nikos release move <story-id> <n>
-  nikos release reorder <n> <position>`;
+  nikos release reorder <n> <position>
+  nikos release remove <n>   (only an empty release)`;
 function report(v) {
     if (v.errors.length)
         console.log(`\n! intent/ now has ${v.errors.length} ${v.errors.length === 1 ? "problem" : "problems"}; run nikos validate to see them.`);
@@ -157,6 +185,11 @@ export function runRelease(args) {
             console.log(`Releases are now:\n${r.order.map((x) => `  ${x.number}. ${x.title}`).join("\n")}`);
             report(r.validation);
         }
+        else if (sub === "remove" && positional[0]) {
+            const r = removeRelease({ number: Number(positional[0]) }, dir);
+            console.log(`Removed release ${r.number}: ${r.title}`);
+            report(r.validation);
+        }
         else {
             console.error(USAGE);
             return 1;

package/docs/format.md

@@ -150,10 +150,11 @@ keeps comments and leaves the rest of the file as it was:
 | Command | What it does |
 | --- | --- |
 | `nikos step add "<title>" --activity <id>` | Add a step under an activity (`--id` to choose its id) |
-| `nikos release add "<title>" [--goal "<goal>"]` | Add the next numbered release, with no stories yet |
+| `nikos release add "<title>" [--goal "<goal>"]` | Add the next numbered release, with no stories yet (titles must be unique) |
 | `nikos release rename <n> ["<title>"] [--goal "<goal>"]` | Change a release's title or goal (`--goal ""` removes it) |
 | `nikos release move <story-id> <n>` | Move a story to the end of another release and retag its feature |
 | `nikos release reorder <n> <position>` | Move a release, renumber them all from 1 and retag every moved story |
+| `nikos release remove <n>` | Remove a release with no stories or bets, renumber the rest and retag their stories |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nikos",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Spec-driven development for AI coding agents: story maps, Gherkin acceptance criteria and a done gate for Claude Code, Codex and Cursor",
   "license": "MIT",
   "author": "Niko Vijay",