@vaubaan/harness 0.0.0-stage → 1.3.2

package/dist/commands/doc-audit.cmd.md

@@ -0,0 +1,24 @@
+---
+id: doc-audit
+trigger: /doc-audit
+invokes_skill: doc-audit
+args:
+  - name: scope
+    type: enum
+    values: [spec, decisions, handbook, tests, workflow, readme, all]
+    default: all
+description: Audits the completeness and freshness of the project docs (selectable scope).
+---
+
+# /doc-audit
+
+When the human or the agent invokes `/doc-audit [scope]`, load the skill
+`doc-audit` with the `scope` passed as argument (default `all`).
+
+The skill reads `docs/` and `README.md`, applies the §9.3 criteria, and emits
+a Markdown report in `.vaubaan/reports/doc-audit.md` (creates the folder if missing).
+If `scope` is restricted (e.g. `decisions`), only that pillar is audited;
+the report does not mention the others.
+
+No additional logic here — the command is a simple
+`slash → skill + args` binding.

package/dist/commands/drift.cmd.md

@@ -0,0 +1,18 @@
+---
+id: drift
+trigger: /drift
+invokes_skill: drift-detector
+description: "Detects code ↔ doc drift (stale handbooks, orphan ADRs, stale tracks)."
+---
+
+# /drift
+
+When the human or the agent invokes `/drift`, load the skill
+`drift-detector`.
+
+The skill compares the files declared in the `tracks:` frontmatter of
+handbooks / test plans / workflow against their git history, flags
+drifts beyond the configured threshold, and lists recently modified
+code files with no doc counterpart.
+
+No arguments — the skill produces a standalone report.

package/dist/commands/handbook.cmd.md

@@ -0,0 +1,21 @@
+---
+id: handbook
+trigger: /handbook
+invokes_skill: handbook-writer
+args:
+  - name: name
+    type: string
+description: Documents the actual implementation of a feature under `docs/handbook/<name>.md`.
+---
+
+# /handbook
+
+When the human or the agent invokes `/handbook [name]`, load the skill
+`handbook-writer` with the optional `name` argument.
+
+If `name` is provided, the skill targets `docs/handbook/<name>.md`. Without
+an argument, it offers the existing handbooks or creates a new one
+after identifying the code area to document.
+
+The skill reads the code, proposes a draft (`tracks:` frontmatter included
+via `handbook.md.tmpl`), and lets the human validate before writing.

package/dist/commands/readme.cmd.md

@@ -0,0 +1,19 @@
+---
+id: readme
+trigger: /readme
+invokes_skill: readme-writer
+description: Maintains the root `README.md` (pitch, quick start, links to the pillars).
+---
+
+# /readme
+
+When the human or the agent invokes `/readme`, load the skill
+`readme-writer`.
+
+The skill reads the root `README.md` (or instantiates `readme.md.tmpl` if it
+is missing), syncs the links to `docs/spec/`, `docs/handbook/`,
+`docs/workflow/coding-workflow.md`, and checks that pitch + quick start
+reflect the current state of the code (entry points, run scripts,
+major dependencies).
+
+No arguments — the skill drives the wizard.

package/dist/commands/spec.cmd.md

@@ -0,0 +1,20 @@
+---
+id: spec
+trigger: /spec
+invokes_skill: spec-writer
+args:
+  - name: name
+    type: string
+description: Writes or updates a `docs/spec/<name>.md` file in wizard mode.
+---
+
+# /spec
+
+When the human or the agent invokes `/spec [name]`, load the skill
+`spec-writer` with the optional `name` argument.
+
+If `name` is provided, the skill directly targets `docs/spec/<name>.md`
+(creation or update). Without an argument, it lists the existing
+specs and asks you to pick one / create one.
+
+The skill instantiates the `spec.md.tmpl` template for creations.

package/dist/commands/test-plan.cmd.md

@@ -0,0 +1,22 @@
+---
+id: test-plan
+trigger: /test-plan
+invokes_skill: test-plan-writer
+args:
+  - name: kind
+    type: enum
+    values: [integration, e2e]
+    default: integration
+description: Updates `docs/tests/integration-tests.md` or `e2e-tests.md` depending on `kind`.
+---
+
+# /test-plan
+
+When the human or the agent invokes `/test-plan [kind]`, load the skill
+`test-plan-writer` with the `kind` passed as argument (default `integration`).
+
+The skill targets `docs/tests/integration-tests.md` or
+`docs/tests/e2e-tests.md` depending on `kind`. It walks the existing test
+code to detect unlisted scenarios and proposes updates,
+relying on the `integration-tests.md.tmpl` or
+`e2e-tests.md.tmpl` templates for creations.

package/dist/commands/workflow.cmd.md

@@ -0,0 +1,19 @@
+---
+id: workflow
+trigger: /workflow
+invokes_skill: workflow-writer
+description: Updates `docs/workflow/coding-workflow.md` (CI, env variants, PR, branches, release).
+---
+
+# /workflow
+
+When the human or the agent invokes `/workflow`, load the skill
+`workflow-writer`.
+
+The skill reads `.github/workflows/`, `vercel.json`, the `package.json`
+scripts, the branch/PR config, and proposes an update of the
+required sections (CI / env / PR / branches / release) of
+`docs/workflow/coding-workflow.md`. For an initial creation, it
+instantiates `coding-workflow.md.tmpl`.
+
+No arguments — the skill drives the wizard.

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export { InitArgs, InitResult, initCommand, planInit, writeFilesToTarget } from './init.js';
+import { d as RenderedFile } from './render-B9_kNtQc.js';
+import './parser/index.js';
+import 'zod';
+
+declare const VERSION = "1.3.2";
+
+interface UpdateArgs {
+    targetDir: string;
+    packageDir?: string;
+    overridesDir?: string;
+    preserveFiles?: ReadonlyArray<string>;
+    dryRun?: boolean;
+    /** Exact new backup directory, outside the project. Defaults to private user state. */
+    backupDir?: string;
+}
+interface UpdateResult {
+    version: string;
+    fromManifestVersion: string;
+    dryRun: boolean;
+    upToDate: boolean;
+    filesToWrite: string[];
+    filesToRemove: string[];
+    warnings: string[];
+    backupDir?: string;
+}
+interface UpdatePlan {
+    writes: RenderedFile[];
+    removals: string[];
+    result: UpdateResult;
+}
+/** All reads and validation precede backup creation and project mutations. */
+declare function planUpdate(args: UpdateArgs): UpdatePlan;
+declare function updateCommand(args: UpdateArgs): UpdateResult;
+
+export { type UpdateArgs, type UpdateResult, VERSION, planUpdate, updateCommand };