@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.
- package/README.md +25 -21
- package/dist/cli/index.js +543 -76
- package/dist/cli/index.js.map +1 -1
- package/dist/commands/doc-audit.cmd.md +1 -1
- package/dist/commands/handbook.cmd.md +4 -3
- package/dist/commands/journey.cmd.md +22 -0
- package/dist/commands/story.cmd.md +24 -0
- package/dist/commands/test-plan.cmd.md +4 -4
- package/dist/index.d.ts +2 -2
- package/dist/index.js +304 -56
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts +2 -3
- package/dist/init.js +301 -53
- package/dist/init.js.map +1 -1
- package/dist/linters/index.js +523 -56
- package/dist/linters/index.js.map +1 -1
- package/dist/parser/index.d.ts +110 -1
- package/dist/parser/index.js +229 -2
- package/dist/parser/index.js.map +1 -1
- package/dist/{render-C-FWmUfX.d.ts → render-BzrBb_l4.d.ts} +3 -1
- package/dist/render.d.ts +1 -1
- package/dist/render.js +89 -10
- package/dist/render.js.map +1 -1
- package/dist/skills/decision-record-writer.skill.md +93 -130
- package/dist/skills/doc-audit.skill.md +37 -7
- package/dist/skills/drift-detector.skill.md +41 -11
- package/dist/skills/handbook-writer.skill.md +71 -159
- package/dist/skills/journey-writer.skill.md +159 -0
- package/dist/skills/spec-writer.skill.md +25 -3
- package/dist/skills/test-plan-writer.skill.md +46 -53
- package/dist/skills/workflow-writer.skill.md +20 -3
- package/dist/templates/decision.md.tmpl +20 -47
- package/dist/templates/e2e-tests.md.tmpl +16 -45
- package/dist/templates/handbook.md.tmpl +20 -38
- package/dist/templates/integration-tests.md.tmpl +16 -34
- package/dist/templates/journey.md.tmpl +45 -0
- 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:
|
|
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,
|
|
21
|
-
|
|
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
|
|
20
|
-
code
|
|
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-
|
|
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.
|
|
6
|
+
declare const VERSION = "2.2.0";
|
|
7
7
|
|
|
8
8
|
interface UpdateArgs {
|
|
9
9
|
targetDir: string;
|