kadence 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.1.2] — 2026-09-03
+
+### Documentation
+
+- The README opened with `npx kadence init` and said nothing more, so the
+  obvious next step — `kadence board` — failed with "command not found". `npx`
+  fetches a package for one command and leaves nothing installed. Global
+  install is now the first instruction, with the npx path shown as the
+  alternative it is.
+
 ## [0.1.1] — 2026-09-03
 
 ### Fixed

package/README.md

@@ -7,9 +7,11 @@ account, no network. Works offline, and works for AI agents because the data is
 just files they can read.
 
 ```bash
-npx kadence init
-npx kadence task add "Fix login" -d "Broken since 2.3" --type bug --estimate 3
-npx kadence ui        # interactive board, or `kadence board` for a plain list
+npm install -g kadence
+
+kadence init
+kadence task add "Fix login" -d "Broken since 2.3" --type bug --estimate 3
+kadence ui        # interactive board, or `kadence board` for a plain list
 ```
 
 > **v0.1.0.** The architecture is measured and covered by 383 tests. The product
@@ -51,13 +53,23 @@ costs your team.
 
 Requires Node 20 or newer, and a git repository.
 
+Install it once, so the command stays available:
+
+```bash
+npm install -g kadence
+kadence init
+```
+
+Or run it without installing — but note that `npx` fetches the package for that
+one command and leaves nothing behind, so every later call needs `npx` too:
+
 ```bash
 npx kadence init
+npx kadence board
 ```
 
-No global install needed. `init` creates `.kadence/`, adds the derived cache to
-`.gitignore`, and writes a short guide for AI agents. It does **not** commit
-anything — that call is yours.
+`init` creates `.kadence/`, adds the derived cache to `.gitignore`, and writes a
+short guide for AI agents. It does **not** commit anything — that call is yours.
 
 ## Commands
 

package/dist/cli.js

@@ -129,7 +129,7 @@ Available: create, add, edit, start, close, status, list, burndown
   kadence sprint --help`),e)}});h.command("template [action] [name]","Task templates: save | list | delete").option("-d, --description <text>","Default description").option("--type <type>","Default type").option("--priority <level>","Default priority").option("-a, --assignee <who>","Default assignee").option("--label <name>","Default label; repeat for several").option("--estimate <points>","Default estimate").option("--json","Machine-readable output for agents").example("  kadence template save bug --type bug --priority high --label triage").example("  kadence template list").action((n,t,s)=>{let e=s.json===!0,a=process.cwd();switch(n){case"save":{t===void 0&&c(f(`A template name is required:
   kadence template save bug --type bug`),e);let i=s.label===void 0?void 0:Array.isArray(s.label)?s.label:[s.label];c(Te(a,process.env,t,{...s.description!==void 0?{description:s.description}:{},...s.type!==void 0?{type:s.type}:{},...s.priority!==void 0?{priority:s.priority}:{},...s.assignee!==void 0?{assignee:s.assignee}:{},...i!==void 0?{labels:i}:{},...s.estimate!==void 0?{estimate:Number(s.estimate)}:{}}),e);break}case"list":case void 0:c(Ke(a,process.env),e);break;case"delete":t===void 0&&c(f(`Which template?
   kadence template delete bug`),e),c(Ne(a,process.env,t),e);break;default:c(f(`Unknown action "${n}".
-Available: save, list, delete`),e)}});h.command("ui","Interactive kanban board").alias("board:ui").example("  kadence ui").action(async()=>{let{runUi:n}=await import("./chunks/ui-WFLRVGUH.js"),t=await n(process.cwd(),process.env);t.ok||c(t,!1)});h.help();h.version("0.1.1");var v=process.argv;if(v[2]==="task"&&v[3]==="log"&&v[4]!==void 0&&v[5]!==void 0){let n=T(process.cwd(),process.env,v[4],v[5]),t=v.includes("--json");c(n,t)}var _e=process.argv.findIndex((n,t)=>n.startsWith("-")&&/^-\d+(\.\d+)?$/.test(n)&&process.argv[t-1]==="--estimate");_e!==-1&&(process.stderr.write(`Estimate must be a positive number, got "${process.argv[_e]}".
+Available: save, list, delete`),e)}});h.command("ui","Interactive kanban board").alias("board:ui").example("  kadence ui").action(async()=>{let{runUi:n}=await import("./chunks/ui-WFLRVGUH.js"),t=await n(process.cwd(),process.env);t.ok||c(t,!1)});h.help();h.version("0.1.2");var v=process.argv;if(v[2]==="task"&&v[3]==="log"&&v[4]!==void 0&&v[5]!==void 0){let n=T(process.cwd(),process.env,v[4],v[5]),t=v.includes("--json");c(n,t)}var _e=process.argv.findIndex((n,t)=>n.startsWith("-")&&/^-\d+(\.\d+)?$/.test(n)&&process.argv[t-1]==="--estimate");_e!==-1&&(process.stderr.write(`Estimate must be a positive number, got "${process.argv[_e]}".
   kadence task add "Fix login" --estimate 3
 `),process.exit(2));try{h.parse()}catch(n){process.stderr.write(`${n.message}
 `),process.exit(2)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kadence",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Tasks, sprints and velocity as plain files inside your git repository",
   "type": "module",
   "license": "MIT",
@@ -26,7 +26,8 @@
   "dependencies": {
     "@types/blessed": "^0.1.27",
     "blessed": "^0.1.81",
-    "cac": "^7.0.0"
+    "cac": "^7.0.0",
+    "kadence": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",