@bvdm/delano 0.1.7 → 0.1.8

package/assets/payload/.agents/scripts/propose-closeout-learning.mjs

@@ -0,0 +1,20 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename);
+const repoRoot = resolveRepoRoot(__dirname);
+const project = readOption("--project") || "delano-learning-loop";
+const metricsPath = readOption("--metrics") || path.join(repoRoot, ".agents", "metrics", "delivery-events.jsonl");
+const metrics = readEvents(metricsPath).filter((event)=>event.project === project || !event.project);
+const proposal = {
+  schema_version: 1,
+  mode: "dry-run-proposal",
+  project,
+  apply_posture: "proposal-only-no-mutation",
+  summary: { event_count: metrics.length, recommendation_count: 1, privacy: "summary-only" },
+  recommendations: [{ id: "LP-001", type: "closeout-learning", summary: metrics.length ? "Review summarized delivery metrics during closeout." : "Capture at least one delivery metric event during future closeouts.", evidence: ["scripts/summarize-project-metrics.mjs", ".agents/logs/delivery-metrics.md"] }]
+};
+if (process.argv.includes("--json")) console.log(JSON.stringify(proposal,null,2)); else console.log(`Closeout learning proposal produced ${proposal.summary.recommendation_count} recommendation(s) for ${project}.`);
+function readEvents(filePath){ if(!existsSync(filePath)) return []; return readFileSync(filePath,"utf8").split(/\r?\n/).filter(Boolean).map(line=>JSON.parse(line)); }
+function readOption(name){ const i=process.argv.indexOf(name); return i===-1?"":process.argv[i+1]; }
+function resolveRepoRoot(startDir){ for(const c of [path.resolve(startDir,".."),path.resolve(startDir,"..","..")]) if(existsSync(path.join(c,".agents"))) return c; return path.resolve(startDir,".."); }

package/assets/payload/.agents/scripts/read-local-sync-map.mjs

@@ -0,0 +1,135 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const repoRoot = resolveRepoRoot(__dirname);
+
+export function readLocalSyncMap(root = repoRoot) {
+  const projectsRoot = path.join(root, ".project", "projects");
+  const registryPath = path.join(root, ".project", "registry", "linear-map.json");
+  const registry = readOptionalJson(registryPath) || { projects: {}, tasks: {} };
+  const projects = [];
+
+  for (const projectDir of listProjectDirs(projectsRoot)) {
+    const slug = path.basename(projectDir);
+    const projectRegistry = registry.projects?.[slug] || {};
+    const tasks = [];
+    const tasksDir = path.join(projectDir, "tasks");
+    if (existsSync(tasksDir)) {
+      for (const taskFile of readdirSync(tasksDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => path.join(tasksDir, entry.name)).sort()) {
+        const text = readFileSync(taskFile, "utf8");
+        const fm = parseFrontmatter(text);
+        const registryKey = `${slug}/${fm.id || path.basename(taskFile, ".md")}`;
+        const taskRegistry = registry.tasks?.[registryKey] || registry.tasks?.[fm.id] || {};
+        tasks.push({
+          local_id: fm.id || path.basename(taskFile, ".md"),
+          name: fm.name || titleFromMarkdown(text) || path.basename(taskFile, ".md"),
+          status: fm.status || "unknown",
+          workstream: fm.workstream || "",
+          local_path: toRepoPath(root, taskFile),
+          depends_on: parseList(fm.depends_on || "[]"),
+          linear_issue_id: emptyToUndefined(fm.linear_issue_id) || taskRegistry.linear_issue_id,
+          github_issue: emptyToUndefined(fm.github_issue) || taskRegistry.github_issue,
+          github_pr: emptyToUndefined(fm.github_pr) || taskRegistry.github_pr
+        });
+      }
+    }
+    projects.push({
+      slug,
+      local_path: toRepoPath(root, projectDir),
+      linear_project_id: projectRegistry.linear_project_id,
+      github_repo: projectRegistry.github_repo,
+      tasks
+    });
+  }
+
+  return { schema_version: 1, source: "local", projects };
+}
+
+export function validateLocalSyncMap(syncMap) {
+  const errors = [];
+  const seenProjects = new Set();
+  for (const project of syncMap.projects || []) {
+    if (seenProjects.has(project.slug)) errors.push(`duplicate project slug: ${project.slug}`);
+    seenProjects.add(project.slug);
+    if (!/^\.project\/projects\/[^/]+$/.test(project.local_path || "")) errors.push(`invalid project local_path for ${project.slug}: ${project.local_path}`);
+    const seenTasks = new Set();
+    for (const task of project.tasks || []) {
+      if (!/^T-[0-9]{3}$/.test(task.local_id || "")) errors.push(`${project.slug} has invalid task id: ${task.local_id}`);
+      if (seenTasks.has(task.local_id)) errors.push(`${project.slug} has duplicate task id: ${task.local_id}`);
+      seenTasks.add(task.local_id);
+      for (const dependency of task.depends_on || []) {
+        if (!seenTasks.has(dependency) && !(project.tasks || []).some((candidate) => candidate.local_id === dependency)) {
+          errors.push(`${project.slug}/${task.local_id} depends on missing local task ${dependency}`);
+        }
+      }
+      if (task.github_issue && !isUrlOrNumber(task.github_issue)) errors.push(`${project.slug}/${task.local_id} has invalid github_issue: ${task.github_issue}`);
+      if (task.github_pr && !isUrlOrNumber(task.github_pr)) errors.push(`${project.slug}/${task.local_id} has invalid github_pr: ${task.github_pr}`);
+    }
+  }
+  return errors;
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const syncMap = readLocalSyncMap(repoRoot);
+  const errors = validateLocalSyncMap(syncMap);
+  if (process.argv.includes("--json")) {
+    console.log(JSON.stringify(syncMap, null, 2));
+  }
+  if (errors.length > 0) {
+    console.error("Local sync map validation failed:");
+    for (const error of errors) console.error(`- ${error}`);
+    process.exit(1);
+  }
+  if (!process.argv.includes("--json")) {
+    const taskCount = syncMap.projects.reduce((sum, project) => sum + project.tasks.length, 0);
+    console.log(`Local sync map check passed for ${syncMap.projects.length} project(s) and ${taskCount} task(s).`);
+  }
+}
+
+function listProjectDirs(projectsRoot) {
+  if (!existsSync(projectsRoot)) return [];
+  return readdirSync(projectsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => path.join(projectsRoot, entry.name)).sort();
+}
+function parseFrontmatter(text) {
+  const match = text.match(/^---\n([\s\S]*?)\n---\n/);
+  if (!match) return {};
+  const result = {};
+  for (const line of match[1].split("\n")) {
+    const index = line.indexOf(":");
+    if (index === -1) continue;
+    result[line.slice(0, index).trim()] = line.slice(index + 1).trim();
+  }
+  return result;
+}
+function parseList(raw) {
+  const value = String(raw || "").trim();
+  if (!value || value === "[]") return [];
+  if (value.startsWith("[") && value.endsWith("]")) return value.slice(1, -1).split(",").map((item) => item.trim().replace(/^['\"]|['\"]$/g, "")).filter(Boolean);
+  return [value.replace(/^['\"]|['\"]$/g, "")].filter(Boolean);
+}
+function titleFromMarkdown(text) {
+  const match = text.match(/^#\s+(.+)$/m);
+  return match ? match[1].replace(/^Task:\s*/, "").trim() : "";
+}
+function emptyToUndefined(value) {
+  const trimmed = String(value || "").trim();
+  return trimmed ? trimmed : undefined;
+}
+function isUrlOrNumber(value) {
+  return /^https?:\/\//.test(value) || /^#?[0-9]+$/.test(value);
+}
+function readOptionalJson(filePath) {
+  if (!existsSync(filePath)) return null;
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function toRepoPath(root, filePath) {
+  return path.relative(root, filePath).split(path.sep).join("/");
+}
+function resolveRepoRoot(startDir) {
+  const candidates = [path.resolve(startDir, ".."), path.resolve(startDir, "..", "..")];
+  for (const candidate of candidates) if (existsSync(path.join(candidate, ".project")) && existsSync(path.join(candidate, ".agents"))) return candidate;
+  return path.resolve(startDir, "..");
+}

package/assets/payload/.agents/scripts/select-next-task.mjs

@@ -0,0 +1,22 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const repoRoot = resolveRepoRoot(__dirname);
+const projectSlug = readOption("--project") || "delano-multi-agent-execution";
+const stream = readOption("--stream") || "default";
+const tasksDir = path.join(repoRoot, ".project", "projects", projectSlug, "tasks");
+const leases = readLeases(readOption("--leases") || path.join(repoRoot, ".agents", "leases", "active-leases.json"));
+const ready = readdirSync(tasksDir).filter((file)=>file.endsWith(".md")).map((file)=>readTask(path.join(tasksDir,file))).filter((task)=>task.status === "ready");
+const activeZones = new Set(leases.filter((l)=>l.status === "active" && new Date(l.expires_at).getTime() > Date.now()).flatMap((l)=>l.conflict_zones || []));
+const candidates = ready.map((task)=>({ ...task, stream, blocked_by_active_zone: task.conflicts_with.some((zone)=>activeZones.has(zone)) })).filter((task)=>!task.blocked_by_active_zone);
+const selected = candidates[0] || null;
+const result = { schema_version: 1, project: projectSlug, stream, ready_count: ready.length, candidate_count: candidates.length, selected: selected && { id: selected.id, file: selected.file, priority: selected.priority } };
+if (process.argv.includes("--json")) console.log(JSON.stringify(result, null, 2)); else console.log(selected ? `Selected ${selected.id} for ${stream}.` : `No unleased ready task for ${stream}.`);
+export function readTask(filePath) { const text=readFileSync(filePath,"utf8"); return { file:path.basename(filePath), id: front(text,"id"), status: front(text,"status"), priority: front(text,"priority"), conflicts_with: list(front(text,"conflicts_with")) }; }
+function front(text,key){ const m=text.match(new RegExp(`^${key}:\\s*(.*)$`,"m")); return m?m[1].trim():""; }
+function list(v){ const m=v.match(/^\[(.*)\]$/); return m?m[1].split(",").map(x=>x.trim()).filter(Boolean):[]; }
+function readLeases(filePath){ if(!existsSync(filePath)) return []; return JSON.parse(readFileSync(filePath,"utf8")).leases || []; }
+function readOption(name){ const i=process.argv.indexOf(name); return i===-1?"":process.argv[i+1]; }
+function resolveRepoRoot(startDir){ for(const c of [path.resolve(startDir,".."),path.resolve(startDir,"..","..")]) if(existsSync(path.join(c,".project"))) return c; return path.resolve(startDir,".."); }

package/assets/payload/.agents/scripts/summarize-project-metrics.mjs

@@ -0,0 +1,15 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename);
+const repoRoot = resolveRepoRoot(__dirname);
+const eventsPath = readOption("--events") || path.join(repoRoot, ".agents", "metrics", "delivery-events.jsonl");
+const project = readOption("--project") || "all";
+const events = readEvents(eventsPath).filter((e)=>project === "all" || e.project === project);
+const byType = Object.create(null);
+for (const e of events) byType[e.event_type] = (byType[e.event_type] || 0) + 1;
+const summary = { schema_version: 1, project, event_count: events.length, by_type: byType, privacy: "summary-only" };
+if (process.argv.includes("--json")) console.log(JSON.stringify(summary, null, 2)); else console.log(`Project metrics summary: ${events.length} event(s), privacy=summary-only.`);
+function readEvents(filePath){ if(!existsSync(filePath)) return []; return readFileSync(filePath,"utf8").split(/\r?\n/).filter(Boolean).map((line)=>JSON.parse(line)); }
+function readOption(name){ const i=process.argv.indexOf(name); return i===-1?"":process.argv[i+1]; }
+function resolveRepoRoot(startDir){ for(const c of [path.resolve(startDir,".."),path.resolve(startDir,"..","..")]) if(existsSync(path.join(c,".agents"))) return c; return path.resolve(startDir,".."); }

package/assets/payload/.agents/skills/closeout-skill/SKILL.md

@@ -17,11 +17,13 @@ description: Close the delivery loop and capture completion evidence, status upd
 - closure update
 - completion summary
 - updated status in contracts/registry
+- learning proposals for any rule, skill, schema, or fixture changes discovered during closeout
 
 ## Quality checks
 - required tasks resolved
 - evidence package complete
 - outcome review captured
+- learning proposals are reviewed before adoption
 
 ## Failure behavior
 - block closure when evidence is incomplete
@@ -40,3 +42,4 @@ description: Close the delivery loop and capture completion evidence, status upd
 - `references/runbook.md`
 - `templates/outcome-review.md`
 - `templates/closure-checklist.md`
+- `templates/learning-proposal.md`

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

@@ -3,8 +3,10 @@
 1. Confirm all required tasks are in terminal state.
 2. Ensure quality evidence package is complete.
 3. Write completion summary from template.
-4. Update project status and mapping registry.
-5. Review event log:
+4. Draft a learning proposal for any proposed rule, skill, schema, or fixture update.
+5. Keep learning proposals in `proposed` state until reviewed and explicitly accepted.
+6. Update project status and mapping registry.
+7. Review event log:
    - `bash .agents/scripts/query-log.sh --last 100`
 6. Validate:
    - `bash .agents/scripts/pm/status.sh`
@@ -12,5 +14,6 @@
 
 Exit gate:
 - Outcome review captured
+- Learning proposals reviewed before adoption
 - Evidence complete
 - Delivery state closed cleanly

package/assets/payload/.agents/skills/closeout-skill/templates/closure-checklist.md

@@ -4,4 +4,6 @@
 - [ ] Quality gates passed
 - [ ] Evidence package complete
 - [ ] Registry/state updated
+- [ ] Learning proposals drafted for rule, skill, schema, or fixture changes
+- [ ] Learning proposals reviewed before adoption
 - [ ] Retrospective scheduled

package/assets/payload/.agents/skills/closeout-skill/templates/learning-proposal.md

@@ -0,0 +1,21 @@
+# Closeout Learning Proposal
+
+## Proposal Type
+rule | skill | schema | fixture
+
+## Title
+
+## Rationale
+What happened, what should change, and why the change is worth reviewing.
+
+## Target Paths
+- repo/relative/path
+
+## Evidence
+- command, task, fixture, or local event summary
+
+## Review Gate
+Required before adoption. Do not apply the proposed rule, skill, schema, or fixture change until it has been reviewed and explicitly accepted.
+
+## Adoption Status
+proposed

package/assets/payload/.agents/skills/closeout-skill/templates/learning-proposals.md

@@ -0,0 +1,25 @@
+# Closeout Learning Proposals
+
+Use this during project closeout to propose reusable runtime changes. Proposals are review-first: do not silently adopt changes to shared rules, skills, schemas, or fixtures.
+
+## Proposal Summary
+
+- Project:
+- Source closeout/update:
+- Reviewer:
+- Review status: pending
+
+## Proposed Changes
+
+| Target type | Target path | Change summary | Evidence | Adoption state |
+| --- | --- | --- | --- | --- |
+| rule | `.agents/rules/example.md` | Replace with the observed improvement. | Link task/update evidence. | proposed |
+| skill | `.agents/skills/example-skill/SKILL.md` | Replace with the observed improvement. | Link task/update evidence. | proposed |
+| schema | `.agents/schemas/example.schema.json` | Replace with the observed improvement. | Link task/update evidence. | proposed |
+| fixture | `.agents/validation-fixtures/example.json` | Replace with the observed improvement. | Link task/update evidence. | proposed |
+
+## Review Gate
+
+- [ ] Every proposal cites observed evidence.
+- [ ] No proposal is adopted before review status is approved.
+- [ ] Rejected proposals retain the reason for future context.

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`.