trackfw 9.3.0 → 9.3.1

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 (2) hide show
  1. package/README.md +18 -15
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -19,12 +19,12 @@ ADR → REQ → ROADMAP → backlog / wip / blocked / done / abandoned
19
19
  Every piece of work traces back to a decision. Every decision links to a requirement. Every requirement lands in a roadmap. No orphan work, no undocumented choices.
20
20
 
21
21
  > 🚧 **Platform support: Linux and macOS are supported. Windows support is partial.**
22
- > The CLIs install on Windows and core governance commands run. From the next release,
23
- > guard hooks call `trackfw guard <name>` (the Go binary) instead of a POSIX shell
24
- > script — measured blocking and allowing correctly in PowerShell 5, cmd.exe, and Git
25
- > Bash (non-login) on Windows. Windows CI still reports known test failures. There are
26
- > limits worth knowing; **read [Windows support (partial)](#windows-support-partial)
27
- > before adopting on Windows.**
22
+ > The CLIs install on Windows and core governance commands run. Since v9.3.0, guard
23
+ > hooks call `trackfw guard <name>` (the Go binary) instead of a POSIX shell script —
24
+ > measured blocking and allowing correctly in PowerShell 5, cmd.exe, and Git Bash on
25
+ > Windows; Claude Code and Codex CLI proven end-to-end. Windows CI still reports known
26
+ > test failures. There are limits worth knowing; **read
27
+ > [Windows support (partial)](#windows-support-partial) before adopting on Windows.**
28
28
 
29
29
  ---
30
30
 
@@ -112,14 +112,17 @@ declaration.
112
112
 
113
113
  Shared behavior follows the [command contract](docs/cli-parity.md).
114
114
 
115
- > **The CLI installs on Node ≥ 18 alone — the generated guard hooks do not run on
116
- > Node alone.** They are POSIX shell scripts and need a POSIX shell to execute. On
117
- > Windows, see [Windows support](#windows-support-partial) before relying on them.
115
+ > **The npm package delivers the same Go binary, and the guard hooks run it from `PATH`.**
116
+ > Since v9.3.0, hooks call `trackfw guard <name>` directly; no POSIX shell is needed. On
117
+ > Windows, the npm shim is a `.ps1` that PowerShell's `ExecutionPolicy Restricted` blocks —
118
+ > see [Windows support](#windows-support-partial) before relying on the hooks.
118
119
 
119
120
  ### Windows support (partial)
120
121
 
121
- 🚧 **Windows support is partial. Native Windows hooks are planned but not yet being
122
- worked on. Read this before adopting `trackfw` on Windows.**
122
+ 🚧 **Windows support is partial. Read this before adopting `trackfw` on Windows.**
123
+
124
+ Since v9.3.0, guard hooks call `trackfw guard <name>` (the Go binary) and run on
125
+ Windows. Windows CI still reports known test failures mapped by root cause.
123
126
 
124
127
  We publish a Windows binary and the npm/pip packages install on Windows. That is not
125
128
  the same as the tool working end to end, and we would rather tell you where the edges
@@ -138,10 +141,10 @@ are than let you find them after adoption.
138
141
 
139
142
  - Our Windows CI still reports **known test failures**. They are mapped by root cause,
140
143
  not unknown — but they are not zero.
141
- **Guard hooks on Windows — measured state (from the next release)**
144
+ **Guard hooks on Windows — measured state (since v9.3.0)**
142
145
 
143
- From the next release, guard hooks call `trackfw guard <name>` (the Go binary) instead
144
- of a `.sh` script. The same binary runs in every shell; for a given agent CLI, the hook
146
+ Since v9.3.0, guard hooks call `trackfw guard <name>` (the Go binary) instead of a
147
+ `.sh` script. The same binary runs in every shell; for a given agent CLI, the hook
145
148
  line in the committed config is the same string across PowerShell, cmd.exe, and Git
146
149
  Bash — a team with mixed OS can commit one config and have it work on all machines.
147
150
 
@@ -192,7 +195,7 @@ Code names the tool `Bash`) and Windows (where it names it `PowerShell`). Run
192
195
  through Git Bash (login shell), whose login profile puts `~/bin` at the front of `PATH`.
193
196
  If an older trackfw binary (without the `guard` subcommand) lives in `~/bin`, the hook
194
197
  exits 1 ("unknown command") and fails open on most CLIs — remove or update that binary.
195
- `trackfw validate` will report this condition from the next release.
198
+ Since v9.3.0, `trackfw validate` reports this condition.
196
199
 
197
200
  **The guard requires a `trackfw` binary with the `guard` subcommand in the PATH of the
198
201
  agent CLI's process.** `trackfw validate` now reports three new conditions:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "trackfw",
3
- "version": "9.3.0",
3
+ "version": "9.3.1",
4
4
  "description": "Governance CLI for AI-native software delivery and AI coding agents. Enforces traceability: ADR → REQ → ROADMAP → kanban. Native support for Codex, Claude Code, Gemini CLI, Cursor, Copilot, Windsurf, Amazon Q, OpenCode, and Kiro.",
5
5
  "keywords": [
6
6
  "cli",
@@ -63,11 +63,11 @@
63
63
  "node": ">=18"
64
64
  },
65
65
  "optionalDependencies": {
66
- "@trackfw-bin/darwin-arm64": "9.3.0",
67
- "@trackfw-bin/darwin-x64": "9.3.0",
68
- "@trackfw-bin/linux-arm64": "9.3.0",
69
- "@trackfw-bin/linux-x64": "9.3.0",
70
- "@trackfw-bin/win32-arm64": "9.3.0",
71
- "@trackfw-bin/win32-x64": "9.3.0"
66
+ "@trackfw-bin/darwin-arm64": "9.3.1",
67
+ "@trackfw-bin/darwin-x64": "9.3.1",
68
+ "@trackfw-bin/linux-arm64": "9.3.1",
69
+ "@trackfw-bin/linux-x64": "9.3.1",
70
+ "@trackfw-bin/win32-arm64": "9.3.1",
71
+ "@trackfw-bin/win32-x64": "9.3.1"
72
72
  }
73
73
  }