pi-usereq 0.11.0 → 0.13.0

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 (53) hide show
  1. package/CHANGELOG.md +59 -0
  2. package/README.md +6 -6
  3. package/package.json +1 -1
  4. package/pi-usereq/docs/REFERENCES.md +1135 -834
  5. package/pi-usereq/docs/REQUIREMENTS.md +177 -110
  6. package/pi-usereq/docs/WORKFLOW.md +244 -79
  7. package/scripts/lib/extension-debug-harness.ts +2 -2
  8. package/scripts/tool-args-to-params.ts +2 -2
  9. package/src/cli.ts +12 -12
  10. package/src/core/config.ts +541 -180
  11. package/src/core/extension-status.ts +69 -12
  12. package/src/core/path-context.ts +19 -4
  13. package/src/core/pi-notify.ts +5 -5
  14. package/src/core/pi-usereq-tools.ts +4 -2
  15. package/src/core/prompt-command-catalog.ts +4 -5
  16. package/src/core/prompt-command-runtime.ts +183 -44
  17. package/src/core/prompts.ts +0 -2
  18. package/src/core/req-references-command.ts +175 -0
  19. package/src/core/req-reset-command.ts +323 -0
  20. package/src/core/resources.ts +6 -23
  21. package/src/core/settings-menu.ts +85 -28
  22. package/src/core/tool-runner.ts +26 -6
  23. package/src/index.ts +601 -116
  24. package/tests/attended-results-scenarios.ts +15 -9
  25. package/tests/cli-command-option-parity.test.ts +53 -35
  26. package/tests/debug-extension-harness.test.ts +8 -10
  27. package/tests/extension-registration.test.ts +1204 -205
  28. package/tests/helpers.ts +29 -6
  29. package/tests/oracle-project.test.ts +4 -4
  30. package/tests/oracle-standalone.test.ts +5 -5
  31. package/src/core/reference-payload.ts +0 -752
  32. package/src/resources/prompts/references.md +0 -64
  33. /package/tests/fixtures_attended_results/project/{references.json → summarize.json} +0 -0
  34. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_c.c.json +0 -0
  35. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_cpp.cpp.json +0 -0
  36. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_csharp.cs.json +0 -0
  37. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_elixir.ex.json +0 -0
  38. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_go.go.json +0 -0
  39. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_haskell.hs.json +0 -0
  40. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_java.java.json +0 -0
  41. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_javascript.js.json +0 -0
  42. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_kotlin.kt.json +0 -0
  43. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_lua.lua.json +0 -0
  44. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_perl.pl.json +0 -0
  45. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_php.php.json +0 -0
  46. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_python.py.json +0 -0
  47. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_ruby.rb.json +0 -0
  48. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_rust.rs.json +0 -0
  49. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_scala.scala.json +0 -0
  50. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_shell.sh.json +0 -0
  51. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_swift.swift.json +0 -0
  52. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_typescript.ts.json +0 -0
  53. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_zig.zig.json +0 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,60 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.13.0](https://github.com/Ogekuri/PI-useReq/compare/v0.12.0..v0.13.0) - 2026-04-27
4
+ ### 🚜 Changes
5
+ - BREAKING CHANGE: split local and global configuration [useReq] *(config)*
6
+ - update REQUIREMENTS, WORKFLOW, and REFERENCES for the split config model
7
+ - persist tool, notification, git, and checker-command settings globally
8
+ - keep project paths, debug, and static-check enable flags locally
9
+ - rename Show configuration to Show local configuration and add Show global configuration
10
+ - refresh tests for local/global persistence and CLI static-check behavior
11
+
12
+ ## [0.12.0](https://github.com/Ogekuri/PI-useReq/compare/v0.11.0..v0.12.0) - 2026-04-25
13
+ ### ⛰️ Features
14
+ - add req-reset recovery command and docs [useReq] *(req-reset)*
15
+ - Add dedicated req-reset recovery without prompt dispatch or worktree creation.
16
+ - Extend requirements, workflow, and references traceability for req-reset.
17
+ - Add extension-registration coverage for req-reset registration, success, and failure paths.
18
+
19
+ ### 🐛 Bug Fixes
20
+ - keep toggle rows open and refresh status [useReq] *(settings-menu)*
21
+ - keep inline menu toggles focused without closing menus
22
+ - refresh direct status renders from live context usage
23
+ - show Pushover credential guidance when enablement is locked
24
+
25
+ ### 🚜 Changes
26
+ - BREAKING CHANGE: reject busy req commands and finalize active runs [useReq] *(orchestration)*
27
+ - update REQUIREMENTS.md for req-reset and non-idle req-command behavior
28
+ - enforce error-state rejection for req-references and bundled req prompts
29
+ - preserve successful worktree finalization after busy-command rejection
30
+ - extend extension-registration tests and refresh WORKFLOW/REFERENCES docs
31
+ - BREAKING CHANGE: specialize direct references workflow [useReq] *(req-references)*
32
+ - remove the bundled req-references prompt template
33
+ - add direct references generation, staging, commit, and clean-repo checks
34
+ - update requirements, workflow, references, and extension tests
35
+ - add status-only REFERENCES writer [useReq] *(references)*
36
+ - update requirements for references tool registration and output contract
37
+ - implement the status-only references tool and default enablement
38
+ - add extension tests and refresh workflow plus references docs
39
+ - derive req descriptions from markdown headings [useReq] *(prompt-command)*
40
+ - update REQ-004 and TST-080 for heading-based descriptions
41
+ - remove YAML description extraction from bundled prompts
42
+ - refresh workflow and references traceability
43
+ - BREAKING CHANGE: rename references tools to summarize [useReq] *(tool-runner)*
44
+ - Update REQUIREMENTS, WORKFLOW, and REFERENCES for files-summarize and summarize.
45
+ - Rename CLI flags, tool registrations, startup-tool defaults, and debug harness examples.
46
+ - Refresh oracle, parity, registration, and archived fixture tests.
47
+ - align low context gauge colors with status field [useReq] *(extension-status)*
48
+ - update REQ-126, TST-035, and TST-096 for low-band context gauge color\n- render context icons below 90% with the status warning token\n- refresh workflow, references, and status-bar tests for traceability
49
+ - BREAKING CHANGE: stash dirty base-path around merge [useReq] *(prompt-command-runtime)*
50
+ - update requirements, workflow, and references
51
+ - add stash-assisted merge warning coverage
52
+ - decouple runtime sound from boot config [useReq] *(notifications)*
53
+ - update sound requirements and runtime docs
54
+ - keep hotkey sound changes runtime-only
55
+ - keep menu edits persisted as boot value only
56
+ - refresh references and extension tests
57
+
3
58
  ## [0.11.0](https://github.com/Ogekuri/PI-useReq/compare/v0.10.0..v0.11.0) - 2026-04-24
4
59
  ### 🚜 Changes
5
60
  - BREAKING CHANGE: revise status bar branch gauge and debug defaults [useReq] *(extension-status)*
@@ -312,6 +367,8 @@
312
367
  - \[0.7.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.7.0
313
368
  - \[0.10.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.10.0
314
369
  - \[0.11.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.11.0
370
+ - \[0.12.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.12.0
371
+ - \[0.13.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.13.0
315
372
 
316
373
  [0.1.0]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.1.0
317
374
  [0.2.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.1.0..v0.2.0
@@ -322,3 +379,5 @@
322
379
  [0.7.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.6.0..v0.7.0
323
380
  [0.10.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.7.0..v0.10.0
324
381
  [0.11.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.10.0..v0.11.0
382
+ [0.12.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.11.0..v0.12.0
383
+ [0.13.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.12.0..v0.13.0
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # PI-useReq/pi-usereq (0.11.0)
1
+ # PI-useReq/pi-usereq (0.13.0)
2
2
 
3
3
  <p align="center">
4
4
  <img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+">
@@ -60,7 +60,7 @@ TODO: complete table with the extension custom commands
60
60
  | `new` | Implement a new requirement and the corresponding source code changes |
61
61
  | `refactor` | Perform a refactor without changing the requirements |
62
62
  | `readme` | Write `README.md` from user-visible implementation evidence |
63
- | `references` | Write a `REFERENCES.md` using the project's source code |
63
+ | `req-references` | Write a `REFERENCES.md` using the project's source code |
64
64
  | `workflow` | Write a `WORKFLOW.md` using the project's source code |
65
65
  | `flowchart` | Write a `FLOWCHART.md` using the project's source code |
66
66
 
@@ -148,8 +148,8 @@ TODO: complete with the extension custom tools full documentasions
148
148
  - Count tokens and chars for the given files
149
149
  `files-tokens FILE [FILE ...]`
150
150
 
151
- - Generate LLM reference markdown for the given files
152
- `files-references FILE [FILE ...]`
151
+ - Generate LLM summary markdown for the given files
152
+ `files-summarize FILE [FILE ...]`
153
153
 
154
154
  - Generate compressed output for the given files
155
155
  `files-compress FILE [FILE ...]`
@@ -163,8 +163,8 @@ TODO: complete with the extension custom tools full documentasions
163
163
  - Count tokens and chars for canonical docs files in configured `docs-dir` (`REQUIREMENTS.md`, `WORKFLOW.md`, `REFERENCES.md`).
164
164
  `tokens`
165
165
 
166
- - Generate LLM reference markdown for source files selected by `git ls-files cached others exclude-standard` under configured `src-dir` directories.
167
- `references`
166
+ - Generate LLM summary markdown for source files selected by `git ls-files cached others exclude-standard` under configured `src-dir` directories.
167
+ `summarize`
168
168
 
169
169
  - Generate compressed output for source files selected by `git ls-files cached others exclude-standard` under configured `src-dir` directories.
170
170
  `compress`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-usereq",
3
- "version": "0.11.0",
3
+ "version": "0.13.0",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/Ogekuri/PI-useReq.git"