@vaubaan/harness 2.4.0 → 3.0.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 +207 -83
- package/dist/cli/index.js +4165 -843
- package/dist/cli/index.js.map +1 -1
- package/dist/commands/harn-canvas.cmd.md +23 -0
- package/dist/commands/{decision.cmd.md → harn-decision.cmd.md} +6 -6
- package/dist/commands/{doc-audit.cmd.md → harn-doc-audit.cmd.md} +7 -7
- package/dist/commands/{drift.cmd.md → harn-drift.cmd.md} +6 -6
- package/dist/commands/{handbook.cmd.md → harn-handbook.cmd.md} +6 -6
- package/dist/commands/harn-improve.cmd.md +20 -0
- package/dist/commands/{intent.cmd.md → harn-intent.cmd.md} +9 -9
- package/dist/commands/{readme.cmd.md → harn-readme.cmd.md} +6 -6
- package/dist/commands/{spec.cmd.md → harn-spec.cmd.md} +6 -6
- package/dist/commands/{test-plan.cmd.md → harn-test-plan.cmd.md} +6 -6
- package/dist/commands/harn-upgrade.cmd.md +22 -0
- package/dist/commands/{workflow.cmd.md → harn-workflow.cmd.md} +6 -6
- package/dist/index.d.ts +32 -3
- package/dist/index.js +533 -96
- package/dist/index.js.map +1 -1
- package/dist/init.d.ts +1 -1
- package/dist/init.js +468 -93
- package/dist/init.js.map +1 -1
- package/dist/linters/index.d.ts +3 -34
- package/dist/linters/index.js +996 -554
- package/dist/linters/index.js.map +1 -1
- package/dist/parser/index.d.ts +96 -6
- package/dist/parser/index.js +220 -10
- package/dist/parser/index.js.map +1 -1
- package/dist/render-BhUar2gf.d.ts +81 -0
- package/dist/render.d.ts +1 -1
- package/dist/render.js +233 -22
- package/dist/render.js.map +1 -1
- package/dist/skills/harn-canvas-review.skill.md +87 -0
- package/dist/skills/{decision-record-writer.skill.md → harn-decision-record-writer.skill.md} +2 -1
- package/dist/skills/{doc-audit.skill.md → harn-doc-audit.skill.md} +75 -26
- package/dist/skills/{drift-detector.skill.md → harn-drift-detector.skill.md} +15 -14
- package/dist/skills/harn-guide.skill.md +137 -0
- package/dist/skills/{handbook-writer.skill.md → harn-handbook-writer.skill.md} +2 -1
- package/dist/skills/{intent-writer.skill.md → harn-intent-writer.skill.md} +83 -16
- package/dist/skills/{readme-writer.skill.md → harn-readme-writer.skill.md} +4 -4
- package/dist/skills/harn-self-improve.skill.md +84 -0
- package/dist/skills/{spec-writer.skill.md → harn-spec-writer.skill.md} +8 -8
- package/dist/skills/{test-plan-writer.skill.md → harn-test-plan-writer.skill.md} +6 -5
- package/dist/skills/harn-upgrade.skill.md +171 -0
- package/dist/skills/{workflow-writer.skill.md → harn-workflow-writer.skill.md} +6 -5
- package/dist/templates/decisions-index.md.tmpl +11 -0
- package/dist/templates/handbook-index.md.tmpl +8 -0
- package/dist/templates/profile.md.tmpl +30 -0
- package/dist/types-CfUByAIr.d.ts +35 -0
- package/dist/view/index.d.ts +117 -0
- package/dist/view/index.js +3987 -0
- package/dist/view/index.js.map +1 -0
- package/package.json +5 -1
- package/dist/render-CTx7VNOK.d.ts +0 -45
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: harn-canvas
|
|
3
|
+
trigger: /harn-canvas
|
|
4
|
+
invokes_skill: harn-canvas-review
|
|
5
|
+
args:
|
|
6
|
+
- name: mode
|
|
7
|
+
type: enum
|
|
8
|
+
values: [talk, comment]
|
|
9
|
+
default: talk
|
|
10
|
+
required: false
|
|
11
|
+
description: Opens the live view of the context; you talk or comment cards, the agent changes the docs, nothing is committed.
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# /harn-canvas
|
|
15
|
+
|
|
16
|
+
When the human or the agent invokes `/harn-canvas [talk|comment]`, load the
|
|
17
|
+
skill `harn-canvas-review` with the optional `mode` argument.
|
|
18
|
+
|
|
19
|
+
The skill starts a review session (`vaubaan-harness review start`), gives
|
|
20
|
+
the URL of the view, and keeps it live: in `talk` mode it applies what the
|
|
21
|
+
human says, in `comment` mode it waits for the batches of comments the
|
|
22
|
+
human hands over from the view and answers each thread. It ends with
|
|
23
|
+
`review keep` or `review discard`, never with a commit.
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: decision
|
|
3
|
-
trigger: /decision
|
|
4
|
-
invokes_skill: decision-record-writer
|
|
2
|
+
id: harn-decision
|
|
3
|
+
trigger: /harn-decision
|
|
4
|
+
invokes_skill: harn-decision-record-writer
|
|
5
5
|
description: Writes an ADR under `docs/decisions/<slug>.md` (detects implicit decisions in the diff).
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# /decision
|
|
8
|
+
# /harn-decision
|
|
9
9
|
|
|
10
|
-
When the human or the agent invokes `/decision`, load the skill
|
|
11
|
-
`decision-record-writer`.
|
|
10
|
+
When the human or the agent invokes `/harn-decision`, load the skill
|
|
11
|
+
`harn-decision-record-writer`.
|
|
12
12
|
|
|
13
13
|
The skill inspects the current diff and recent history looking for
|
|
14
14
|
implicit decisions (technology changes, module removals, structural
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: doc-audit
|
|
3
|
-
trigger: /doc-audit
|
|
4
|
-
invokes_skill: doc-audit
|
|
2
|
+
id: harn-doc-audit
|
|
3
|
+
trigger: /harn-doc-audit
|
|
4
|
+
invokes_skill: harn-doc-audit
|
|
5
5
|
args:
|
|
6
6
|
- name: scope
|
|
7
7
|
type: enum
|
|
8
|
-
values: [spec, decisions, handbook, tests, workflow, readme, intents, all]
|
|
8
|
+
values: [spec, decisions, handbook, tests, workflow, readme, intents, profiles, all]
|
|
9
9
|
default: all
|
|
10
10
|
description: Audits the completeness and freshness of the project docs (selectable scope).
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
# /doc-audit
|
|
13
|
+
# /harn-doc-audit
|
|
14
14
|
|
|
15
|
-
When the human or the agent invokes `/doc-audit [scope]`, load the skill
|
|
16
|
-
`doc-audit` with the `scope` passed as argument (default `all`).
|
|
15
|
+
When the human or the agent invokes `/harn-doc-audit [scope]`, load the skill
|
|
16
|
+
`harn-doc-audit` with the `scope` passed as argument (default `all`).
|
|
17
17
|
|
|
18
18
|
The skill reads `docs/` and `README.md`, applies the §9.3 criteria, and emits
|
|
19
19
|
a Markdown report in `.vaubaan/reports/doc-audit.md` (creates the folder if missing).
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: drift
|
|
3
|
-
trigger: /drift
|
|
4
|
-
invokes_skill: drift-detector
|
|
2
|
+
id: harn-drift
|
|
3
|
+
trigger: /harn-drift
|
|
4
|
+
invokes_skill: harn-drift-detector
|
|
5
5
|
description: "Detects code ↔ doc drift (stale handbooks, orphan ADRs, stale tracks)."
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# /drift
|
|
8
|
+
# /harn-drift
|
|
9
9
|
|
|
10
|
-
When the human or the agent invokes `/drift`, load the skill
|
|
11
|
-
`drift-detector`.
|
|
10
|
+
When the human or the agent invokes `/harn-drift`, load the skill
|
|
11
|
+
`harn-drift-detector`.
|
|
12
12
|
|
|
13
13
|
The skill compares the files declared in the `tracks:` frontmatter of
|
|
14
14
|
handbooks / test plans / workflow against their git history, flags
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: handbook
|
|
3
|
-
trigger: /handbook
|
|
4
|
-
invokes_skill: handbook-writer
|
|
2
|
+
id: harn-handbook
|
|
3
|
+
trigger: /harn-handbook
|
|
4
|
+
invokes_skill: harn-handbook-writer
|
|
5
5
|
args:
|
|
6
6
|
- name: name
|
|
7
7
|
type: string
|
|
8
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
|
-
# /handbook
|
|
11
|
+
# /harn-handbook
|
|
12
12
|
|
|
13
|
-
When the human or the agent invokes `/handbook [name]`, load the skill
|
|
14
|
-
`handbook-writer` with the optional `name` argument.
|
|
13
|
+
When the human or the agent invokes `/harn-handbook [name]`, load the skill
|
|
14
|
+
`harn-handbook-writer` with the optional `name` argument.
|
|
15
15
|
|
|
16
16
|
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
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: harn-improve
|
|
3
|
+
trigger: /harn-improve
|
|
4
|
+
invokes_skill: harn-self-improve
|
|
5
|
+
description: Turns the patches reviews keep asking for into rules, proposed with their evidence and written in the project's pillars once accepted.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# /harn-improve
|
|
9
|
+
|
|
10
|
+
When the human or the agent invokes `/harn-improve`, load the skill
|
|
11
|
+
`harn-self-improve`.
|
|
12
|
+
|
|
13
|
+
The skill fetches the recent pull requests if it can, runs
|
|
14
|
+
`vaubaan-harness lessons collect`, groups the patch events, and proposes
|
|
15
|
+
one rule per recurring patch with its evidence and the pillar it would go
|
|
16
|
+
to. The human accepts, edits or rejects each one; accepted rules are
|
|
17
|
+
written in the project's docs, rejected ones are kept so they do not come
|
|
18
|
+
back. Nothing is committed.
|
|
19
|
+
|
|
20
|
+
No arguments.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: intent
|
|
3
|
-
trigger: /intent
|
|
4
|
-
invokes_skill: intent-writer
|
|
2
|
+
id: harn-intent
|
|
3
|
+
trigger: /harn-intent
|
|
4
|
+
invokes_skill: harn-intent-writer
|
|
5
5
|
args:
|
|
6
6
|
- name: intent
|
|
7
7
|
type: string
|
|
8
8
|
required: false
|
|
9
|
-
description: Proposes an intent before any code (`/intent <verb + object>`), or maps and extends the intent tree under `docs/intents/`.
|
|
9
|
+
description: Proposes an intent before any code (`/harn-intent <verb + object>`), or maps and extends the intent tree under `docs/intents/`.
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
# /intent
|
|
12
|
+
# /harn-intent
|
|
13
13
|
|
|
14
|
-
When the human or the agent invokes `/intent [verb + object]`, load the
|
|
15
|
-
skill `intent-writer` with the optional `intent` argument.
|
|
14
|
+
When the human or the agent invokes `/harn-intent [verb + object]`, load the
|
|
15
|
+
skill `harn-intent-writer` with the optional `intent` argument.
|
|
16
16
|
|
|
17
|
-
**With an argument**, `/intent <verb + object>` names the visible change
|
|
17
|
+
**With an argument**, `/harn-intent <verb + object>` names the visible change
|
|
18
18
|
of behavior about to be built. The skill places it as a `proposed`
|
|
19
19
|
terminal intent in the level-1 intent it belongs to (or creates the
|
|
20
20
|
file), with 2 to 5 observable acceptance criteria and its `requires:` /
|
|
21
21
|
`creates:` taken from the spec vocabulary. It writes no code and no
|
|
22
22
|
`anchors:`: the pull request that delivers the intent adds them and
|
|
23
23
|
passes it `implemented`. It refuses an entity that no linked spec
|
|
24
|
-
defines and redirects to `/spec` first.
|
|
24
|
+
defines and redirects to `/harn-spec` first.
|
|
25
25
|
|
|
26
26
|
**Without an argument**, the skill maps or extends the tree. It reads
|
|
27
27
|
the generated index `docs/intents/README.md`, lists the level-1 intents
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: readme
|
|
3
|
-
trigger: /readme
|
|
4
|
-
invokes_skill: readme-writer
|
|
2
|
+
id: harn-readme
|
|
3
|
+
trigger: /harn-readme
|
|
4
|
+
invokes_skill: harn-readme-writer
|
|
5
5
|
description: Maintains the root `README.md` (pitch, quick start, links to the pillars).
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# /readme
|
|
8
|
+
# /harn-readme
|
|
9
9
|
|
|
10
|
-
When the human or the agent invokes `/readme`, load the skill
|
|
11
|
-
`readme-writer`.
|
|
10
|
+
When the human or the agent invokes `/harn-readme`, load the skill
|
|
11
|
+
`harn-readme-writer`.
|
|
12
12
|
|
|
13
13
|
The skill reads the root `README.md` (or instantiates `readme.md.tmpl` if it
|
|
14
14
|
is missing), syncs the links to `docs/spec/`, `docs/handbook/`,
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: spec
|
|
3
|
-
trigger: /spec
|
|
4
|
-
invokes_skill: spec-writer
|
|
2
|
+
id: harn-spec
|
|
3
|
+
trigger: /harn-spec
|
|
4
|
+
invokes_skill: harn-spec-writer
|
|
5
5
|
args:
|
|
6
6
|
- name: name
|
|
7
7
|
type: string
|
|
8
8
|
description: Writes or updates a `docs/spec/<name>.md` file in wizard mode.
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
# /spec
|
|
11
|
+
# /harn-spec
|
|
12
12
|
|
|
13
|
-
When the human or the agent invokes `/spec [name]`, load the skill
|
|
14
|
-
`spec-writer` with the optional `name` argument.
|
|
13
|
+
When the human or the agent invokes `/harn-spec [name]`, load the skill
|
|
14
|
+
`harn-spec-writer` with the optional `name` argument.
|
|
15
15
|
|
|
16
16
|
If `name` is provided, the skill directly targets `docs/spec/<name>.md`
|
|
17
17
|
(creation or update). Without an argument, it lists the existing
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: test-plan
|
|
3
|
-
trigger: /test-plan
|
|
4
|
-
invokes_skill: test-plan-writer
|
|
2
|
+
id: harn-test-plan
|
|
3
|
+
trigger: /harn-test-plan
|
|
4
|
+
invokes_skill: harn-test-plan-writer
|
|
5
5
|
args:
|
|
6
6
|
- name: kind
|
|
7
7
|
type: enum
|
|
@@ -10,10 +10,10 @@ args:
|
|
|
10
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
|
-
# /test-plan
|
|
13
|
+
# /harn-test-plan
|
|
14
14
|
|
|
15
|
-
When the human or the agent invokes `/test-plan [kind]`, load the skill
|
|
16
|
-
`test-plan-writer` with the `kind` passed as argument (default `integration`).
|
|
15
|
+
When the human or the agent invokes `/harn-test-plan [kind]`, load the skill
|
|
16
|
+
`harn-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
19
|
`docs/tests/e2e-tests.md` depending on `kind`. It checks the documented stack and
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: harn-upgrade
|
|
3
|
+
trigger: /harn-upgrade
|
|
4
|
+
invokes_skill: harn-upgrade
|
|
5
|
+
args:
|
|
6
|
+
- name: version
|
|
7
|
+
type: string
|
|
8
|
+
required: false
|
|
9
|
+
description: Moves the project to a newer version of the harness (`/harn-upgrade [version]`), with the migration notes of every version crossed.
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /harn-upgrade
|
|
13
|
+
|
|
14
|
+
When the human or the agent invokes `/harn-upgrade [version]`, load
|
|
15
|
+
the skill `harn-upgrade` with the optional `version` argument: the
|
|
16
|
+
target version, the latest when omitted.
|
|
17
|
+
|
|
18
|
+
The skill pins the package wherever the project pins it, previews
|
|
19
|
+
`update`, resolves the conflicts it lists without deleting anything,
|
|
20
|
+
applies it, then applies the migration notes of every version between
|
|
21
|
+
the one that rendered the project and the target, and ends with the
|
|
22
|
+
lint. It reports what changed and what is left; it does not commit.
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
id: workflow
|
|
3
|
-
trigger: /workflow
|
|
4
|
-
invokes_skill: workflow-writer
|
|
2
|
+
id: harn-workflow
|
|
3
|
+
trigger: /harn-workflow
|
|
4
|
+
invokes_skill: harn-workflow-writer
|
|
5
5
|
description: Updates `docs/workflow/coding-workflow.md` (CI, env variants, PR, branches, release).
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
# /workflow
|
|
8
|
+
# /harn-workflow
|
|
9
9
|
|
|
10
|
-
When the human or the agent invokes `/workflow`, load the skill
|
|
11
|
-
`workflow-writer`.
|
|
10
|
+
When the human or the agent invokes `/harn-workflow`, load the skill
|
|
11
|
+
`harn-workflow-writer`.
|
|
12
12
|
|
|
13
13
|
The skill reads `.github/workflows/`, `vercel.json`, the `package.json`
|
|
14
14
|
scripts, the branch/PR config, and proposes an update of the
|
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
export { InitArgs, InitResult, initCommand, planInit, writeFilesToTarget } from './init.js';
|
|
2
|
-
import {
|
|
2
|
+
import { g as RenderedFile, d as PillarId } from './render-BhUar2gf.js';
|
|
3
|
+
export { A as ADDABLE_PILLARS, P as PILLARS, b as PILLAR_IDS, c as Pillar, h as activePillars } from './render-BhUar2gf.js';
|
|
3
4
|
import './parser/index.js';
|
|
4
5
|
import 'zod';
|
|
5
6
|
|
|
6
|
-
declare const VERSION = "
|
|
7
|
+
declare const VERSION = "3.0.0";
|
|
7
8
|
|
|
8
9
|
interface UpdateArgs {
|
|
9
10
|
targetDir: string;
|
|
@@ -35,4 +36,32 @@ interface UpdatePlan {
|
|
|
35
36
|
declare function planUpdate(args: UpdateArgs): UpdatePlan;
|
|
36
37
|
declare function updateCommand(args: UpdateArgs): UpdateResult;
|
|
37
38
|
|
|
38
|
-
|
|
39
|
+
interface AddArgs {
|
|
40
|
+
targetDir: string;
|
|
41
|
+
pillar: string;
|
|
42
|
+
/** Directory holding the harness content (`templates/`); defaults to the package's own. */
|
|
43
|
+
packageDir?: string;
|
|
44
|
+
overridesDir?: string;
|
|
45
|
+
/** Exact new backup directory for the re-render, outside the project. */
|
|
46
|
+
backupDir?: string;
|
|
47
|
+
}
|
|
48
|
+
interface AddResult {
|
|
49
|
+
pillar: PillarId;
|
|
50
|
+
/** False when the pillar's folder already existed. */
|
|
51
|
+
activated: boolean;
|
|
52
|
+
/** Starter files written; an existing file is never overwritten. */
|
|
53
|
+
filesCreated: string[];
|
|
54
|
+
/** The re-render, absent when the project has no installation yet. */
|
|
55
|
+
update?: UpdateResult;
|
|
56
|
+
/** What to do next, for the operator or the agent. */
|
|
57
|
+
next: string;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Activates a pillar (docs/spec/coding-agent-harness.md §9.1.2): creates its
|
|
61
|
+
* folder, writes its starter files without overwriting anything, then
|
|
62
|
+
* re-renders the installation so the pillar's skill, command and umbrella
|
|
63
|
+
* lines appear. The folder is the switch: nothing else records the pillar.
|
|
64
|
+
*/
|
|
65
|
+
declare function addCommand(args: AddArgs): AddResult;
|
|
66
|
+
|
|
67
|
+
export { type AddArgs, type AddResult, PillarId, type UpdateArgs, type UpdateResult, VERSION, addCommand, planUpdate, updateCommand };
|