@cogit/cli 0.25.0 → 0.25.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,7 +15,7 @@ import {
15
15
  uninstallGitHooks,
16
16
  withHookBlock,
17
17
  withoutHookBlock
18
- } from "./chunk-T7B243ZT.js";
18
+ } from "./chunk-WDGQM5KX.js";
19
19
  export {
20
20
  BLOCK_END,
21
21
  BLOCK_START,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cogit/cli",
3
- "version": "0.25.0",
3
+ "version": "0.25.2",
4
4
  "description": "Git remembers what changed. cogit remembers why.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -88,15 +88,24 @@ message's node, with the node's commit hashes:
88
88
  "shape": { "tools": [{ "kind": "pseudo", "text": "1. ...\n2. ..." }], "commits": ["abc1234"] }
89
89
  ```
90
90
 
91
- Two tools:
92
-
91
+ Tools (at most three, the ones that say the most; never two that tell the same thing):
92
+
93
+ - `mermaid`: a Mermaid `flowchart TD` (or `LR`) of a path through code, at most 10 nodes.
94
+ Quote labels that hold spaces or punctuation.
95
+ - `sequence`: a Mermaid `sequenceDiagram` when work is handed between actors over time (a hook
96
+ starting a job, a client and a server, a queue drained later), at most 6 participants.
97
+ - `table`: Before / After, one `case | before | after` line per case (at most 8), for a
98
+ change someone can see: a fix, a new default, a rule that now says yes or no.
99
+ - `interface`: one `item | before | after` line per command, flag, exported function, config
100
+ key or stored schema field that changed, only what is reached from outside the module;
101
+ `—` for nothing.
102
+ - `example`: one concrete case with real values, each result on its own line after `→`. A new
103
+ or changed command or flag always gets one that runs it.
93
104
  - `pseudo`: numbered plain-language steps of the new logic, naming the functions and files.
94
- - `mermaid`: a Mermaid `flowchart TD` (or `LR`) of the new path between files or functions,
95
- at most 15 nodes. Quote labels that hold spaces or punctuation.
96
105
 
97
- Pick one, both, or none (`{ "tools": [] }` means nothing worth showing). Skip messages whose
98
- commits are only release/version bumps, lockfiles or CHANGELOG, or change fewer than 5 lines
99
- in total. Write it in the conversation's language; the CLI validates each output and keeps an
106
+ Tables have no header row. Order them diagram, tables, example, steps. `{ "tools": [] }`
107
+ means nothing worth showing. Skip messages whose commits are only release/version bumps,
108
+ lockfiles or CHANGELOG, or change fewer than 5 lines in total. Write it in the conversation's language; the CLI validates each output and keeps an
100
109
  invalid diagram as text.
101
110
 
102
111
  ## Branch summary