archik 0.12.36 → 0.12.37

package/.claude/commands/archik/alpha.md

@@ -50,12 +50,14 @@ X currently has none. Author `.archik/X.archik.seq.yaml` with
 ### `demote <alpha> <state>`
 
 ```
-npx archik alpha demote <alpha> <state> --note "<reason>"
+npx archik alpha demote <alpha> <state>
 ```
 
 Demotion is a deliberate admission that the project no longer meets
-a previously-claimed state. Always prompt for the `--note` reason if
-the user didn't supply one — the audit trail matters.
+a previously-claimed state. Before running it, prompt the user for
+the reason and surface it in your reply (and, if appropriate, in a
+follow-up commit message) — the CLI doesn't persist a note for
+demotions, so the audit trail has to live in chat / git history.
 
 ## Notes
 

package/.claude/commands/archik/trace.md

@@ -17,11 +17,13 @@ realising it, are participants ECB-tagged. Optional filter args:
    ```
    npx archik trace
    ```
-   If the user passed a filter (`use-case=<id>`, `actor=<id>`,
-   `status=active|proposed|deprecated`, `coverage=full|partial|none`),
-   pass it through as a query flag:
+   If the user passed a filter, pass it as a CLI flag — the flag form
+   uses a SPACE, not `=`:
    ```
-   npx archik trace --<filter>=<value>
+   npx archik trace --use-case <id>
+   npx archik trace --actor <id>
+   npx archik trace --status active|proposed|deprecated
+   npx archik trace --coverage full|partial|none
    ```
 
 2. **Read the totals row** at the bottom (`X full, Y partial, Z untraced`)

package/README.md

@@ -218,8 +218,9 @@ archik drift [path]      Surface gaps where a node's sourcePath or a slice's
 
 archik alpha [sub]       Project-wide alpha state (Essence / SEMAT)
                          show              snapshot with ✓ / ? / ✗ verification
-                         promote <a> <s>   advance an alpha — runs criteria first
-                         demote <a> <s>    walk back; --note '<reason>' required
+                         promote <a> <s>   advance an alpha — runs criteria first;
+                                           --note '<text>' captures the rationale
+                         demote <a> <s>    walk back to an earlier state on the ladder
 
 archik upgrade           Pull the latest archik via the project's package manager
                          (auto-detects npm / pnpm / yarn / bun from the lockfile)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archik",
-  "version": "0.12.36",
+  "version": "0.12.37",
   "description": "The shared vocabulary between you and Claude Code, at the engineering level. Plain-YAML architecture diagrams with a live browser canvas, headless SVG render in CI, and an installable Claude skill so the model treats the diagram as the spec.",
   "keywords": [
     "architecture",