codewhale.history 2.11.12 → 2.11.14

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.
Files changed (3) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +27 -3
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,16 @@ All notable changes to the CodeWhale Tools Pack.
4
4
 
5
5
  ---
6
6
 
7
+ ## [2.11.14] — 2026-07-11
8
+
9
+ ### Fixed
10
+ - README: trigger table and theme modifiers now show both spec↔code directions (was only showing spec→code)
11
+
12
+ ## [2.11.13] — 2026-07-11
13
+
14
+ ### Added
15
+ - README: "How to use" section — cd → codewhale → TAB → //trigger
16
+
7
17
  ## [2.11.12] — 2026-07-11
8
18
 
9
19
  ### Fixed
package/README.md CHANGED
@@ -45,6 +45,30 @@ codewhale-tools-install # current workspace
45
45
  codewhale-tools-install -p <target-path> # specific workspace
46
46
  ```
47
47
 
48
+ ### How to use
49
+
50
+ After installation, start a CodeWhale session in your project:
51
+
52
+ 1. **Navigate to your project folder** (the one with `.codewhale/instructions.md`):
53
+ ```bash
54
+ cd /path/to/your/project
55
+ ```
56
+
57
+ 2. **Launch CodeWhale**:
58
+ ```bash
59
+ codewhale
60
+ ```
61
+
62
+ 3. **Press TAB** to enter YOLO mode (full tool access).
63
+
64
+ 4. **Type any trigger command**:
65
+ - `//teach-me` — interactive code quiz
66
+ - `//history` — list chat sessions
67
+ - `//tools` — list all available tools
68
+ - `//snapshot` — toggle pre-edit file backups
69
+
70
+ The skills were installed globally in the Install step above, so they're available in any workspace that has the `.codewhale/instructions.md` trigger file.
71
+
48
72
  ## After install
49
73
 
50
74
  ### `//tools`
@@ -106,8 +130,8 @@ current project. Two independent dimensions across five difficulty levels:
106
130
  | `teach me interactive` | interactive | standard | Lines removed; you restore them |
107
131
  | `teach me solid` | passive | solid | Degraded code; you describe fixes |
108
132
  | `teach me solid interactive` | interactive | solid | Degraded code; you edit to fix it |
109
- | `teach me spec` | passive | spec | Spec or code presented; you trace the link |
110
- | `teach me spec interactive` | interactive | spec | Trace spec to code; you edit code to match |
133
+ | `teach me spec` | passive | spec | Two directions: spec→code (show requirement, you find the code) or code→spec (show code, you name the requirement) |
134
+ | `teach me spec interactive` | interactive | spec | Two directions: spec→code (edit code to satisfy a spec) or code→spec (edit spec to match the code) |
111
135
  | `teach me ba` | passive | ba-gates | BA doc fragment; you identify quality gate violations |
112
136
  | `teach me ba interactive` | interactive | ba-gates | BA doc with issues; you edit to fix them |
113
137
 
@@ -122,7 +146,7 @@ current project. Two independent dimensions across five difficulty levels:
122
146
  | Level | `teach me level 3` or `teach me l3` | Set difficulty 1–5 (default: 3) |
123
147
  | Response | `teach me interactive` | Edit the file instead of describing |
124
148
  | Theme | `teach me solid` | Anti-pattern detection — fix degraded design |
125
- | Theme | `teach me spec` | Spec-to-code traceability via office docs |
149
+ | Theme | `teach me spec` | Speccode traceability either direction (show spec, find the code; or show code, name the requirement) |
126
150
  | Theme | `teach me ba` | BA documentation quality analysis |
127
151
  | Scope | `teach me services/` | Narrow to a specific file or folder |
128
152
  | Concept | `teach me decorators` | Target: decorators, async, generators, context managers, comprehensions, error handling, type hints, threading |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codewhale.history",
3
- "version": "2.11.12",
3
+ "version": "2.11.14",
4
4
  "description": "CodeWhale utility commands: session history, tool listing, file snapshot, interactive code quiz — global install",
5
5
  "bin": {
6
6
  "codewhale-history": "./_list_sessions.js",