@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.
Files changed (53) hide show
  1. package/README.md +207 -83
  2. package/dist/cli/index.js +4165 -843
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/commands/harn-canvas.cmd.md +23 -0
  5. package/dist/commands/{decision.cmd.md → harn-decision.cmd.md} +6 -6
  6. package/dist/commands/{doc-audit.cmd.md → harn-doc-audit.cmd.md} +7 -7
  7. package/dist/commands/{drift.cmd.md → harn-drift.cmd.md} +6 -6
  8. package/dist/commands/{handbook.cmd.md → harn-handbook.cmd.md} +6 -6
  9. package/dist/commands/harn-improve.cmd.md +20 -0
  10. package/dist/commands/{intent.cmd.md → harn-intent.cmd.md} +9 -9
  11. package/dist/commands/{readme.cmd.md → harn-readme.cmd.md} +6 -6
  12. package/dist/commands/{spec.cmd.md → harn-spec.cmd.md} +6 -6
  13. package/dist/commands/{test-plan.cmd.md → harn-test-plan.cmd.md} +6 -6
  14. package/dist/commands/harn-upgrade.cmd.md +22 -0
  15. package/dist/commands/{workflow.cmd.md → harn-workflow.cmd.md} +6 -6
  16. package/dist/index.d.ts +32 -3
  17. package/dist/index.js +533 -96
  18. package/dist/index.js.map +1 -1
  19. package/dist/init.d.ts +1 -1
  20. package/dist/init.js +468 -93
  21. package/dist/init.js.map +1 -1
  22. package/dist/linters/index.d.ts +3 -34
  23. package/dist/linters/index.js +996 -554
  24. package/dist/linters/index.js.map +1 -1
  25. package/dist/parser/index.d.ts +96 -6
  26. package/dist/parser/index.js +220 -10
  27. package/dist/parser/index.js.map +1 -1
  28. package/dist/render-BhUar2gf.d.ts +81 -0
  29. package/dist/render.d.ts +1 -1
  30. package/dist/render.js +233 -22
  31. package/dist/render.js.map +1 -1
  32. package/dist/skills/harn-canvas-review.skill.md +87 -0
  33. package/dist/skills/{decision-record-writer.skill.md → harn-decision-record-writer.skill.md} +2 -1
  34. package/dist/skills/{doc-audit.skill.md → harn-doc-audit.skill.md} +75 -26
  35. package/dist/skills/{drift-detector.skill.md → harn-drift-detector.skill.md} +15 -14
  36. package/dist/skills/harn-guide.skill.md +137 -0
  37. package/dist/skills/{handbook-writer.skill.md → harn-handbook-writer.skill.md} +2 -1
  38. package/dist/skills/{intent-writer.skill.md → harn-intent-writer.skill.md} +83 -16
  39. package/dist/skills/{readme-writer.skill.md → harn-readme-writer.skill.md} +4 -4
  40. package/dist/skills/harn-self-improve.skill.md +84 -0
  41. package/dist/skills/{spec-writer.skill.md → harn-spec-writer.skill.md} +8 -8
  42. package/dist/skills/{test-plan-writer.skill.md → harn-test-plan-writer.skill.md} +6 -5
  43. package/dist/skills/harn-upgrade.skill.md +171 -0
  44. package/dist/skills/{workflow-writer.skill.md → harn-workflow-writer.skill.md} +6 -5
  45. package/dist/templates/decisions-index.md.tmpl +11 -0
  46. package/dist/templates/handbook-index.md.tmpl +8 -0
  47. package/dist/templates/profile.md.tmpl +30 -0
  48. package/dist/types-CfUByAIr.d.ts +35 -0
  49. package/dist/view/index.d.ts +117 -0
  50. package/dist/view/index.js +3987 -0
  51. package/dist/view/index.js.map +1 -0
  52. package/package.json +5 -1
  53. 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 { d as RenderedFile } from './render-CTx7VNOK.js';
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 = "2.4.0";
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
- export { type UpdateArgs, type UpdateResult, VERSION, planUpdate, updateCommand };
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 };