xtrm-tools 0.5.9 → 0.5.11

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 (25) hide show
  1. package/README.md +28 -30
  2. package/cli/dist/index.cjs +379 -441
  3. package/cli/dist/index.cjs.map +1 -1
  4. package/cli/package.json +1 -1
  5. package/config/instructions/agents-top.md +87 -23
  6. package/config/instructions/claude-top.md +101 -23
  7. package/config/pi/extensions/beads/index.ts +3 -1
  8. package/config/pi/extensions/session-flow/index.ts +26 -90
  9. package/config/pi/extensions/xtrm-loader/index.ts +39 -2
  10. package/hooks/README.md +0 -14
  11. package/hooks/beads-gate-messages.mjs +4 -18
  12. package/hooks/hooks.json +20 -16
  13. package/hooks/using-xtrm-reminder.mjs +35 -0
  14. package/package.json +1 -1
  15. package/skills/using-xtrm/SKILL.md +84 -205
  16. package/config/pi/extensions/bg-process/index.ts +0 -230
  17. package/config/pi/extensions/bg-process/package.json +0 -16
  18. package/config/pi/extensions/minimal-mode/index.ts +0 -201
  19. package/config/pi/extensions/minimal-mode/package.json +0 -16
  20. package/config/pi/extensions/todo/index.ts +0 -299
  21. package/config/pi/extensions/todo/package.json +0 -16
  22. package/hooks/agent_context.py +0 -105
  23. package/hooks/guard-rules.mjs +0 -118
  24. package/hooks/main-guard-post-push.mjs +0 -71
  25. package/hooks/main-guard.mjs +0 -119
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # XTRM-Tools
2
2
 
3
- > **Claude Code plugin** — workflow enforcement, code quality gates, issue tracking, and development automation.
3
+ > **Dual-runtime workflow system** — Claude Code plugin + Pi extension suite for workflow enforcement, code quality gates, issue tracking, and development automation.
4
4
 
5
- **Version 2.4.0** | [Complete Guide](XTRM-GUIDE.md) | [Changelog](CHANGELOG.md)
5
+ **Version 0.5.10** | [Complete Guide](XTRM-GUIDE.md) | [Changelog](CHANGELOG.md)
6
6
 
7
7
  ---
8
8
 
@@ -13,16 +13,16 @@
13
13
  npm install -g github:Jaggerxtrm/xtrm-tools@latest
14
14
 
15
15
  # Install the plugin
16
- xtrm install all
16
+ xtrm install
17
17
 
18
18
  # Verify
19
19
  claude plugin list
20
- # → xtrm-tools@xtrm-tools Version: 2.4.0 Status: ✔ enabled
20
+ # → xtrm-tools@xtrm-tools Version: 0.5.10 Status: ✔ enabled
21
21
  ```
22
22
 
23
23
  **One-line run:**
24
24
  ```bash
25
- npx -y github:Jaggerxtrm/xtrm-tools install all
25
+ npx -y github:Jaggerxtrm/xtrm-tools install
26
26
  ```
27
27
 
28
28
  ---
@@ -31,12 +31,13 @@ npx -y github:Jaggerxtrm/xtrm-tools install all
31
31
 
32
32
  ### Core Enforcement
33
33
 
34
- | Component | Purpose |
35
- |-----------|---------|
36
- | **Main Guard** | PR-only workflow — blocks direct commits on `main`/`master` |
37
- | **Beads Gates** | Issue tracking — edit/commit/stop gates, memory prompts |
38
- | **Quality Gates** | Auto linting (ESLint, tsc, ruff, mypy) on file edits |
39
- | **GitNexus** | Knowledge graph context for code exploration |
34
+ | Component | Runtime | Purpose |
35
+ |-----------|---------|---------|
36
+ | **Beads Gates** | both | Issue tracking — edit/commit/stop gates, memory prompts |
37
+ | **Session Flow** | both | Claim sync, stop gate, `xt end` reminder in worktrees |
38
+ | **Quality Gates** | both | Auto linting (ESLint, tsc, ruff, mypy) on file edits |
39
+ | **GitNexus** | Claude | Knowledge graph context for code exploration |
40
+ | **Service Skills** | Pi | Territory-based Docker service skill activation |
40
41
 
41
42
  ### Skills
42
43
 
@@ -76,12 +77,12 @@ Policies are the **single source of truth** for all enforcement rules. Located i
76
77
 
77
78
  | Policy | Runtime | Purpose |
78
79
  |--------|---------|---------|
79
- | `main-guard.json` | both | PR-only workflow |
80
+ | `session-flow.json` | both | Claim sync, stop gate, `xt end` reminder |
80
81
  | `beads.json` | both | Issue tracking gates |
82
+ | `quality-gates.json` | both | Linting/typechecking |
81
83
  | `branch-state.json` | claude | Branch context injection |
82
84
  | `gitnexus.json` | claude | Knowledge graph enrichment |
83
85
  | `serena.json` | claude | Serena LSP workflow reminder |
84
- | `quality-gates.json` | pi | Linting/typechecking |
85
86
  | `service-skills.json` | pi | Territory-based skill activation |
86
87
 
87
88
  ### Compiler
@@ -101,13 +102,15 @@ xtrm <command> [options]
101
102
 
102
103
  | Command | Description |
103
104
  |---------|-------------|
104
- | `install all` | Full plugin + beads + gitnexus |
105
- | `install basic` | Plugin + skills (no beads) |
106
- | `init` | Initialize current project (alias for `project init`) |
107
- | `project init` | Initialize project data (bd, gitnexus, service-registry) |
108
- | `install project <name>` | **Deprecated** — use `xtrm init` instead |
105
+ | `install` | Install plugin + beads + gitnexus (interactive target selection) |
106
+ | `init` | Initialize project data (bd, gitnexus, service-registry) |
109
107
  | `status` | Read-only diff view |
110
108
  | `clean` | Remove orphaned hooks |
109
+ | `end` | Close worktree session: rebase, push, PR, cleanup |
110
+ | `worktree list` | List all active `xt/*` worktrees |
111
+ | `worktree clean` | Remove worktrees whose branch has been merged |
112
+ | `claude` | Launch Claude Code in a sandboxed worktree |
113
+ | `pi` | Launch Pi in a sandboxed worktree |
111
114
 
112
115
  ### Flags
113
116
 
@@ -126,17 +129,12 @@ xtrm <command> [options]
126
129
  | Event | When |
127
130
  |-------|------|
128
131
  | `SessionStart` | Session begins |
132
+ | `UserPromptSubmit` | After user submits prompt |
129
133
  | `PreToolUse` | Before tool invocation |
130
134
  | `PostToolUse` | After tool completes |
131
135
  | `Stop` | Session ends |
132
136
  | `PreCompact` | Before compaction |
133
137
 
134
- ### Main Guard
135
-
136
- - Blocks `git commit`/`push` on protected branches
137
- - Blocks direct file edits on `main`/`master`
138
- - Post-push reminder: `gh pr merge --squash`
139
-
140
138
  ### Beads Gates
141
139
 
142
140
  | Hook | Behavior |
@@ -158,7 +156,7 @@ Configured in `.mcp.json` (xtrm-managed only):
158
156
  | `github-grep` | Code search |
159
157
  | `deepwiki` | DeepWiki docs search |
160
158
 
161
- Official Claude plugins are installed during `xtrm install all`:
159
+ Official Claude plugins are installed during `xtrm install`:
162
160
  - `serena@claude-plugins-official`
163
161
  - `context7@claude-plugins-official`
164
162
  - `github@claude-plugins-official`
@@ -188,11 +186,11 @@ bd close <id> --reason "Done" # Close when done
188
186
 
189
187
  | Version | Date | Highlights |
190
188
  |---------|------|------------|
191
- | 2.4.0 | 2026-03-18 | Global-first architecture: quality gates + service skills as global hooks/skills, xtrm init project detection, guard-rules centralization, Pi drift checks |
192
- | 2.3.0 | 2026-03-17 | Plugin structure, policy compiler, Pi extension parity |
193
- | 2.2.0 | 2026-03-17 | Pi extensions: quality-gates, beads, main-guard |
194
- | 2.0.0 | 2026-03-12 | CLI rebrand, project skills engine |
195
- | 1.7.0 | 2026-02-25 | GitNexus integration |
189
+ | 0.5.10 | 2026-03-21 | Install cleanup: removes stale `~/.claude/hooks/` + `~/.claude/skills/`; Qwen/Gemini dead code removed |
190
+ | 0.5.9 | 2026-03-20 | Worktrees moved inside repo under `.xtrm/worktrees/` |
191
+ | 0.5.8 | 2026-03-20 | session-flow rewrite: claim sync, stop gate, `xt end` reminder |
192
+ | 0.5.7 | 2026-03-20 | Dead hooks removed; dead CLI removed (`finish.ts`, `session-state.ts`) |
193
+ | 0.5.6 | 2026-03-20 | `xt` CLI commands; plugin-only delivery for Claude; deprecated `xtrm finish` |
196
194
 
197
195
  ---
198
196