pi-usereq 0.10.0 → 0.12.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 (52) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +6 -6
  3. package/package.json +1 -1
  4. package/pi-usereq/docs/REFERENCES.md +861 -704
  5. package/pi-usereq/docs/REQUIREMENTS.md +152 -95
  6. package/pi-usereq/docs/WORKFLOW.md +228 -65
  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/debug-runtime.ts +2 -2
  11. package/src/core/extension-status.ts +98 -36
  12. package/src/core/pi-notify.ts +5 -5
  13. package/src/core/pi-usereq-tools.ts +4 -2
  14. package/src/core/prompt-command-catalog.ts +4 -5
  15. package/src/core/prompt-command-runtime.ts +347 -42
  16. package/src/core/prompts.ts +0 -2
  17. package/src/core/req-references-command.ts +175 -0
  18. package/src/core/req-reset-command.ts +323 -0
  19. package/src/core/resources.ts +6 -23
  20. package/src/core/runtime-project-paths.ts +21 -1
  21. package/src/core/settings-menu.ts +85 -28
  22. package/src/core/tool-runner.ts +26 -6
  23. package/src/index.ts +530 -104
  24. package/tests/attended-results-scenarios.ts +5 -5
  25. package/tests/cli-command-option-parity.test.ts +25 -25
  26. package/tests/debug-extension-harness.test.ts +8 -2
  27. package/tests/extension-registration.test.ts +1109 -76
  28. package/tests/oracle-project.test.ts +4 -4
  29. package/tests/oracle-standalone.test.ts +5 -5
  30. package/src/core/reference-payload.ts +0 -752
  31. package/src/resources/prompts/references.md +0 -64
  32. /package/tests/fixtures_attended_results/project/{references.json → summarize.json} +0 -0
  33. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_c.c.json +0 -0
  34. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_cpp.cpp.json +0 -0
  35. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_csharp.cs.json +0 -0
  36. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_elixir.ex.json +0 -0
  37. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_go.go.json +0 -0
  38. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_haskell.hs.json +0 -0
  39. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_java.java.json +0 -0
  40. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_javascript.js.json +0 -0
  41. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_kotlin.kt.json +0 -0
  42. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_lua.lua.json +0 -0
  43. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_perl.pl.json +0 -0
  44. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_php.php.json +0 -0
  45. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_python.py.json +0 -0
  46. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_ruby.rb.json +0 -0
  47. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_rust.rs.json +0 -0
  48. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_scala.scala.json +0 -0
  49. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_shell.sh.json +0 -0
  50. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_swift.swift.json +0 -0
  51. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_typescript.ts.json +0 -0
  52. /package/tests/fixtures_attended_results/standalone/{files-references → files-summarize}/fixture_zig.zig.json +0 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,67 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.12.0](https://github.com/Ogekuri/PI-useReq/compare/v0.11.0..v0.12.0) - 2026-04-25
4
+ ### ⛰️ Features
5
+ - add req-reset recovery command and docs [useReq] *(req-reset)*
6
+ - Add dedicated req-reset recovery without prompt dispatch or worktree creation.
7
+ - Extend requirements, workflow, and references traceability for req-reset.
8
+ - Add extension-registration coverage for req-reset registration, success, and failure paths.
9
+
10
+ ### 🐛 Bug Fixes
11
+ - keep toggle rows open and refresh status [useReq] *(settings-menu)*
12
+ - keep inline menu toggles focused without closing menus
13
+ - refresh direct status renders from live context usage
14
+ - show Pushover credential guidance when enablement is locked
15
+
16
+ ### 🚜 Changes
17
+ - BREAKING CHANGE: reject busy req commands and finalize active runs [useReq] *(orchestration)*
18
+ - update REQUIREMENTS.md for req-reset and non-idle req-command behavior
19
+ - enforce error-state rejection for req-references and bundled req prompts
20
+ - preserve successful worktree finalization after busy-command rejection
21
+ - extend extension-registration tests and refresh WORKFLOW/REFERENCES docs
22
+ - BREAKING CHANGE: specialize direct references workflow [useReq] *(req-references)*
23
+ - remove the bundled req-references prompt template
24
+ - add direct references generation, staging, commit, and clean-repo checks
25
+ - update requirements, workflow, references, and extension tests
26
+ - add status-only REFERENCES writer [useReq] *(references)*
27
+ - update requirements for references tool registration and output contract
28
+ - implement the status-only references tool and default enablement
29
+ - add extension tests and refresh workflow plus references docs
30
+ - derive req descriptions from markdown headings [useReq] *(prompt-command)*
31
+ - update REQ-004 and TST-080 for heading-based descriptions
32
+ - remove YAML description extraction from bundled prompts
33
+ - refresh workflow and references traceability
34
+ - BREAKING CHANGE: rename references tools to summarize [useReq] *(tool-runner)*
35
+ - Update REQUIREMENTS, WORKFLOW, and REFERENCES for files-summarize and summarize.
36
+ - Rename CLI flags, tool registrations, startup-tool defaults, and debug harness examples.
37
+ - Refresh oracle, parity, registration, and archived fixture tests.
38
+ - align low context gauge colors with status field [useReq] *(extension-status)*
39
+ - 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
40
+ - BREAKING CHANGE: stash dirty base-path around merge [useReq] *(prompt-command-runtime)*
41
+ - update requirements, workflow, and references
42
+ - add stash-assisted merge warning coverage
43
+ - decouple runtime sound from boot config [useReq] *(notifications)*
44
+ - update sound requirements and runtime docs
45
+ - keep hotkey sound changes runtime-only
46
+ - keep menu edits persisted as boot value only
47
+ - refresh references and extension tests
48
+
49
+ ## [0.11.0](https://github.com/Ogekuri/PI-useReq/compare/v0.10.0..v0.11.0) - 2026-04-24
50
+ ### 🚜 Changes
51
+ - BREAKING CHANGE: revise status bar branch gauge and debug defaults [useReq] *(extension-status)*
52
+ - update requirements for branch field, context thresholds, and debug log defaults
53
+ - remove Reset defaults right-side values across menus
54
+ - align source, tests, workflow, and references with the breaking change
55
+ - preserve worktree transcript on session restore [useReq] *(prompt-command-runtime)*
56
+ - Update REQ-208 to require client-visible transcript preservation after closure.
57
+ - Copy execution-session JSONL entries into the restored base session before merge and cleanup.
58
+ - Refresh workflow and references docs for the new prompt-finalization path.
59
+ - remove current-path from status footer [useReq] *(status-bar)*
60
+ - Trace: useReq-20260424-1530
61
+ - update requirements, workflow, and references
62
+ - stop rendering current-path in extension status output
63
+ - align harness and registration status tests
64
+
3
65
  ## [0.10.0](https://github.com/Ogekuri/PI-useReq/compare/v0.7.0..v0.10.0) - 2026-04-24
4
66
  ### ⛰️ Features
5
67
  - Add source code from a extranal branch.
@@ -295,6 +357,8 @@
295
357
  - \[0.6.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.6.0
296
358
  - \[0.7.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.7.0
297
359
  - \[0.10.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.10.0
360
+ - \[0.11.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.11.0
361
+ - \[0.12.0\]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.12.0
298
362
 
299
363
  [0.1.0]: https://github.com/Ogekuri/PI-useReq/releases/tag/v0.1.0
300
364
  [0.2.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.1.0..v0.2.0
@@ -304,3 +368,5 @@
304
368
  [0.6.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.5.0..v0.6.0
305
369
  [0.7.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.6.0..v0.7.0
306
370
  [0.10.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.7.0..v0.10.0
371
+ [0.11.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.10.0..v0.11.0
372
+ [0.12.0]: https://github.com/Ogekuri/PI-useReq/compare/v0.11.0..v0.12.0
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # PI-useReq/pi-usereq (0.10.0)
1
+ # PI-useReq/pi-usereq (0.12.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.10.0",
3
+ "version": "0.12.0",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/Ogekuri/PI-useReq.git"