@bvdm/delano 0.1.5 → 0.1.8

package/assets/payload/.agents/skills/prototype-skill/references/probe-design-checklist.md

@@ -0,0 +1,26 @@
+# Probe Design Checklist
+
+Use this before running a Prototype Probe.
+
+## Probe quality
+- Is the uncertainty material enough to justify a probe?
+- Is the probe tied to one concrete question?
+- Is the probe smaller than full implementation?
+- Can the result change the spec approval decision?
+
+## Scope control
+- What is explicitly in scope?
+- What is explicitly out of scope?
+- Which surfaces may be touched?
+- What would make this probe too broad?
+
+## Evidence
+- What outcome would justify approval?
+- What outcome would require revision?
+- What outcome would suggest another narrow probe?
+- What footguns or side effects must be recorded even if the probe succeeds?
+
+## Safety
+- Is there any risk of probe code being treated like production-ready output?
+- Is there a clean way to prevent direct merge from probe artifacts?
+- Are follow-up tasks likely to be needed after the probe?

package/assets/payload/.agents/skills/prototype-skill/references/runbook.md

@@ -0,0 +1,27 @@
+# Prototype Probe Runbook
+
+1. Read the draft `spec.md` and identify the single material uncertainty to retire or bound.
+2. Confirm `probe_required: true` and keep the probe narrow.
+3. Define the smallest useful experiment:
+   - what is being tested
+   - what evidence is needed
+   - what touched surfaces are in scope
+   - what is explicitly out of scope
+4. Time-box the probe, normally to `<= 1 day`.
+5. Run the experiment using the safest path, CLI-first when feasible.
+6. Do not merge probe output directly into production delivery flow.
+7. Fold findings back into `spec.md`:
+   - what changed after probe
+   - touched surfaces
+   - footguns
+   - remaining uncertainty
+   - approval recommendation
+8. Validate if contracts changed:
+   - `bash .agents/scripts/pm/validate.sh`
+9. Snapshot status when useful:
+   - `bash .agents/scripts/pm/status.sh`
+
+Exit gate:
+- probe findings recorded
+- approval recommendation is clear
+- next step is explicit: approve, revise, or run another narrow probe

package/assets/payload/.agents/skills/prototype-skill/templates/probe-approval-recommendation.md

@@ -0,0 +1,13 @@
+# Probe Approval Recommendation
+
+## Recommendation
+- Approve
+- Revise
+- Run another narrow probe
+
+## Why
+
+## Remaining Uncertainty
+
+## Immediate Next Action
+- 

package/assets/payload/.agents/skills/prototype-skill/templates/probe-findings.md

@@ -0,0 +1,16 @@
+# Probe Findings
+
+## Uncertainty Tested
+
+## Experiment Shape
+
+## Evidence Observed
+
+## Touched Surfaces
+- 
+
+## Footguns
+- 
+
+## What Changed In The Spec
+- 

package/assets/payload/.agents/validation-fixtures/strict/invalid/broken-dependencies/dependency.md

@@ -0,0 +1,18 @@
+---
+id: T-001
+name: Undone dependency fixture
+status: ready
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: []
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Undone dependency fixture

package/assets/payload/.agents/validation-fixtures/strict/invalid/broken-dependencies/task.md

@@ -0,0 +1,24 @@
+---
+id: T-002
+name: Broken dependencies fixture
+status: done
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: [T-001]
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Broken dependencies fixture
+
+## Acceptance Criteria
+- [x] Current repo state has been inspected before implementation starts.
+
+## Evidence Log
+- 2026-04-29T00:10:00Z: Inspected fixture and validation passed despite intentionally broken dependency.

package/assets/payload/.agents/validation-fixtures/strict/invalid/invalid-transition/task.md

@@ -0,0 +1,20 @@
+---
+id: T-001
+name: Invalid transition fixture
+status: blocked
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: []
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Invalid transition fixture
+
+Blocked without owner or check-back.

package/assets/payload/.agents/validation-fixtures/strict/invalid/missing-evidence/task.md

@@ -0,0 +1,27 @@
+---
+id: T-001
+name: Missing evidence fixture
+status: done
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: []
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Missing evidence fixture
+
+## Acceptance Criteria
+- [x] Current repo state has been inspected before implementation starts.
+- [x] The delivered change is represented in Delano runtime assets, project contracts, validation, fixtures, or docs as appropriate.
+- [x] The change is validated with the smallest meaningful command or fixture.
+- [x] Evidence is recorded in this task or a task update before the task is marked done.
+
+## Evidence Log
+- 2026-04-29T00:00:00Z: Task created; implementation evidence pending.

package/assets/payload/.agents/validation-fixtures/strict/invalid/path-leak/task.md

@@ -0,0 +1,27 @@
+---
+id: T-001
+name: Path leak fixture
+status: done
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: []
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Path leak fixture
+
+Leaked path: PATH_LEAK_TOKEN(home::example::private::delano)
+WSL leak form: PATH_LEAK_TOKEN(wsl-mount::example::private::delano)
+
+## Acceptance Criteria
+- [x] Current repo state has been inspected before implementation starts.
+
+## Evidence Log
+- 2026-04-29T00:10:00Z: Inspected fixture and validation passed.

package/assets/payload/.agents/validation-fixtures/strict/invalid/stale-context/context.md

@@ -0,0 +1,9 @@
+---
+created: 2026-04-01T00:00:00Z
+updated: 2026-04-01T00:00:00Z
+review_by: 2026-04-15T00:00:00Z
+---
+
+# Stale context fixture
+
+This fixture is intentionally past its review date.

package/assets/payload/.agents/validation-fixtures/strict/manifest.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 1,
+  "fixtures": [
+    { "name": "minimal-project", "kind": "valid", "path": "valid/minimal-project", "expected": "pass" },
+    { "name": "missing-evidence", "kind": "invalid", "path": "invalid/missing-evidence", "expected_rule": "missing-evidence" },
+    { "name": "broken-dependencies", "kind": "invalid", "path": "invalid/broken-dependencies", "expected_rule": "broken-dependencies" },
+    { "name": "stale-context", "kind": "invalid", "path": "invalid/stale-context", "expected_rule": "stale-context" },
+    { "name": "path-leak", "kind": "invalid", "path": "invalid/path-leak", "expected_rule": "path-leak" },
+    { "name": "invalid-transition", "kind": "invalid", "path": "invalid/invalid-transition", "expected_rule": "invalid-transition" }
+  ]
+}

package/assets/payload/.agents/validation-fixtures/strict/valid/minimal-project/task.md

@@ -0,0 +1,27 @@
+---
+id: T-001
+name: Valid strict fixture task
+status: done
+workstream: WS-A
+created: 2026-04-29T00:00:00Z
+updated: 2026-04-29T00:10:00Z
+linear_issue_id:
+github_issue:
+github_pr:
+depends_on: []
+conflicts_with: []
+parallel: false
+priority: high
+estimate: S
+---
+
+# Task: Valid strict fixture task
+
+## Acceptance Criteria
+- [x] Current repo state has been inspected before implementation starts.
+- [x] The delivered change is represented in Delano runtime assets, project contracts, validation, fixtures, or docs as appropriate.
+- [x] The change is validated with the smallest meaningful command or fixture.
+- [x] Evidence is recorded in this task or a task update before the task is marked done.
+
+## Evidence Log
+- 2026-04-29T00:10:00Z: Inspected fixture project, added represented runtime fixture content, and validation passed: fixture validator smoke.

package/assets/payload/.delano/viewer/README.md

@@ -0,0 +1,19 @@
+# Delano Read-Only Viewer
+
+Minimal local frontend for browsing `.project` markdown contracts.
+
+- Read-only: serves files from `.project` and does not write delivery state.
+- Default URL: `http://127.0.0.1:3977`
+- Override port: `DELANO_VIEWER_PORT=3987 npm run viewer`
+
+Run from the repository root:
+
+```bash
+npm run viewer
+```
+
+The viewer indexes `.project/context/**/*.md`, `.project/templates/**/*.md`, and `.project/projects/**/*.md`. It derives artifact roles (`spec`, `plan`, `workstream`, `task`, `progress`, `decision`, `context`, `template`), status fields, task/workstream relationships, relationship-like wikilinks, snippets, and renders markdown in a Tolaria-inspired read-only pane layout.
+
+Project folders get a right-side outline for the spec, plan, decisions/progress, workstreams, and tasks. Selecting a workstream focuses the list on that workstream and its subtasks. Context and template folders keep filters scoped to the roles/statuses that actually exist in the selected folder.
+
+The reader stays read-only, but includes convenience buttons to open the selected markdown file's containing folder in the system explorer or open the file in VS Code. These actions are guarded so they only target markdown files inside `.project`.