@vaubaan/harness 2.0.0 → 2.2.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 (37) hide show
  1. package/README.md +25 -21
  2. package/dist/cli/index.js +543 -76
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/commands/doc-audit.cmd.md +1 -1
  5. package/dist/commands/handbook.cmd.md +4 -3
  6. package/dist/commands/journey.cmd.md +22 -0
  7. package/dist/commands/story.cmd.md +24 -0
  8. package/dist/commands/test-plan.cmd.md +4 -4
  9. package/dist/index.d.ts +2 -2
  10. package/dist/index.js +304 -56
  11. package/dist/index.js.map +1 -1
  12. package/dist/init.d.ts +2 -3
  13. package/dist/init.js +301 -53
  14. package/dist/init.js.map +1 -1
  15. package/dist/linters/index.js +523 -56
  16. package/dist/linters/index.js.map +1 -1
  17. package/dist/parser/index.d.ts +110 -1
  18. package/dist/parser/index.js +229 -2
  19. package/dist/parser/index.js.map +1 -1
  20. package/dist/{render-C-FWmUfX.d.ts → render-BzrBb_l4.d.ts} +3 -1
  21. package/dist/render.d.ts +1 -1
  22. package/dist/render.js +89 -10
  23. package/dist/render.js.map +1 -1
  24. package/dist/skills/decision-record-writer.skill.md +93 -130
  25. package/dist/skills/doc-audit.skill.md +37 -7
  26. package/dist/skills/drift-detector.skill.md +41 -11
  27. package/dist/skills/handbook-writer.skill.md +71 -159
  28. package/dist/skills/journey-writer.skill.md +159 -0
  29. package/dist/skills/spec-writer.skill.md +25 -3
  30. package/dist/skills/test-plan-writer.skill.md +46 -53
  31. package/dist/skills/workflow-writer.skill.md +20 -3
  32. package/dist/templates/decision.md.tmpl +20 -47
  33. package/dist/templates/e2e-tests.md.tmpl +16 -45
  34. package/dist/templates/handbook.md.tmpl +20 -38
  35. package/dist/templates/integration-tests.md.tmpl +16 -34
  36. package/dist/templates/journey.md.tmpl +45 -0
  37. package/package.json +1 -1
@@ -5,7 +5,7 @@ invokes_skill: doc-audit
5
5
  args:
6
6
  - name: scope
7
7
  type: enum
8
- values: [spec, decisions, handbook, tests, workflow, readme, all]
8
+ values: [spec, decisions, handbook, tests, workflow, readme, journeys, all]
9
9
  default: all
10
10
  description: Audits the completeness and freshness of the project docs (selectable scope).
11
11
  ---
@@ -5,7 +5,7 @@ invokes_skill: handbook-writer
5
5
  args:
6
6
  - name: name
7
7
  type: string
8
- description: Documents the actual implementation of a feature under `docs/handbook/<name>.md`.
8
+ description: Writes `docs/handbook/<name>.md` — only what the code does not say (entry points, invariants, traps, settings outside the repo, procedures).
9
9
  ---
10
10
 
11
11
  # /handbook
@@ -17,5 +17,6 @@ If `name` is provided, the skill targets `docs/handbook/<name>.md`. Without
17
17
  an argument, it offers the existing handbooks or creates a new one
18
18
  after identifying the code area to document.
19
19
 
20
- The skill reads the code, proposes a draft (`tracks:` frontmatter included
21
- via `handbook.md.tmpl`), and lets the human validate before writing.
20
+ The skill reads the code, keeps only what an agent would not get from it
21
+ quickly, proposes a short draft (`tracks:` frontmatter included via
22
+ `handbook.md.tmpl`), and lets the human validate before writing.
@@ -0,0 +1,22 @@
1
+ ---
2
+ id: journey
3
+ trigger: /journey
4
+ invokes_skill: journey-writer
5
+ args:
6
+ - name: name
7
+ type: string
8
+ description: Writes or updates `docs/journeys/<name>.md`, one node at a time, in wizard mode.
9
+ ---
10
+
11
+ # /journey
12
+
13
+ When the human or the agent invokes `/journey [name]`, load the skill
14
+ `journey-writer` with the optional `name` argument.
15
+
16
+ If `name` is provided, the skill targets `docs/journeys/<name>.md`
17
+ (creation or update). Without an argument, it reads the generated index
18
+ `docs/journeys/README.md`, lists the journeys and asks which one to
19
+ extend or whether to create one.
20
+
21
+ The skill instantiates the `journey.md.tmpl` template for creations. For
22
+ a new behavior to build, prefer `/story <intent>`.
@@ -0,0 +1,24 @@
1
+ ---
2
+ id: story
3
+ trigger: /story
4
+ invokes_skill: journey-writer
5
+ args:
6
+ - name: intent
7
+ type: string
8
+ description: Adds a `proposed` leaf with its acceptance criteria to the right journey, before any code.
9
+ ---
10
+
11
+ # /story
12
+
13
+ When the human or the agent invokes `/story <intent>`, load the skill
14
+ `journey-writer` in its story mode with the `intent` argument: the
15
+ visible change of behavior about to be built, as a verb + object.
16
+
17
+ The skill places a `proposed` leaf in the journey the intent belongs to
18
+ (or creates the journey), with 2 to 5 observable acceptance criteria and
19
+ its `requires:` / `creates:` taken from the spec vocabulary. It writes
20
+ no code and no `anchors:`: the pull request that delivers the leaf adds
21
+ them and passes it `implemented`.
22
+
23
+ It refuses an entity that no linked spec defines and redirects to
24
+ `/spec` first.
@@ -7,7 +7,7 @@ args:
7
7
  type: enum
8
8
  values: [integration, e2e]
9
9
  default: integration
10
- description: Updates `docs/tests/integration-tests.md` or `e2e-tests.md` depending on `kind`.
10
+ description: Updates `docs/tests/integration-tests.md` or `e2e-tests.md` (scope, stack, conventions, known gaps) depending on `kind`.
11
11
  ---
12
12
 
13
13
  # /test-plan
@@ -16,7 +16,7 @@ When the human or the agent invokes `/test-plan [kind]`, load the skill
16
16
  `test-plan-writer` with the `kind` passed as argument (default `integration`).
17
17
 
18
18
  The skill targets `docs/tests/integration-tests.md` or
19
- `docs/tests/e2e-tests.md` depending on `kind`. It walks the existing test
20
- code to detect unlisted scenarios and proposes updates,
21
- relying on the `integration-tests.md.tmpl` or
19
+ `docs/tests/e2e-tests.md` depending on `kind`. It checks the documented stack and
20
+ conventions against the test code, lists the specs without tests as known
21
+ gaps (never the covered scenarios), and proposes updates, relying on the `integration-tests.md.tmpl` or
22
22
  `e2e-tests.md.tmpl` templates for creations.
package/dist/index.d.ts CHANGED
@@ -1,9 +1,9 @@
1
1
  export { InitArgs, InitResult, initCommand, planInit, writeFilesToTarget } from './init.js';
2
- import { d as RenderedFile } from './render-C-FWmUfX.js';
2
+ import { d as RenderedFile } from './render-BzrBb_l4.js';
3
3
  import './parser/index.js';
4
4
  import 'zod';
5
5
 
6
- declare const VERSION = "2.0.0";
6
+ declare const VERSION = "2.2.0";
7
7
 
8
8
  interface UpdateArgs {
9
9
  targetDir: string;