@bvdm/delano 0.1.0

package/assets/payload/.agents/scripts/pm/validate.sh

@@ -0,0 +1,309 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+errors=0
+warnings=0
+
+check_required_path() {
+  local path="$1"
+  if [[ -e "$path" ]]; then
+    echo "✅ $path"
+  else
+    echo "❌ Missing: $path"
+    errors=$((errors + 1))
+  fi
+}
+
+fm_get() {
+  local file="$1"
+  local key="$2"
+  awk -v key="$key" '
+    BEGIN {in_fm=0}
+    /^---[[:space:]]*$/ {if (in_fm==0) {in_fm=1; next} else {exit}}
+    in_fm==1 && $0 ~ "^" key ":[[:space:]]*" {
+      sub("^" key ":[[:space:]]*", "")
+      print
+      exit
+    }
+  ' "$file"
+}
+
+has_frontmatter() {
+  local file="$1"
+  [[ "$(awk 'NR==1 && /^---[[:space:]]*$/ {print "yes"}' "$file")" == "yes" ]]
+}
+
+is_iso_utc() {
+  local ts="$1"
+  [[ "$ts" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$ ]]
+}
+
+python_cmd=()
+
+resolve_python_cmd() {
+  if command -v python3 >/dev/null 2>&1 && python3 -c "import sys" >/dev/null 2>&1; then
+    python_cmd=(python3)
+    return 0
+  fi
+
+  if command -v py >/dev/null 2>&1 && py -3 -c "import sys" >/dev/null 2>&1; then
+    python_cmd=(py -3)
+    return 0
+  fi
+
+  if command -v python >/dev/null 2>&1 && python -c "import sys" >/dev/null 2>&1; then
+    python_cmd=(python)
+    return 0
+  fi
+
+  return 1
+}
+
+echo "Delano validation"
+echo "================="
+
+check_required_path ".project/projects"
+check_required_path ".project/context"
+check_required_path ".project/registry/linear-map.json"
+check_required_path ".agents/scripts/pm"
+check_required_path ".agents/rules"
+check_required_path ".agents/hooks"
+check_required_path ".agents/logs"
+check_required_path ".agents/skills"
+
+if [[ -e ".claude" || -L ".claude" ]]; then
+  echo "✅ Compatibility runtime present: .claude"
+else
+  echo "⚠️ Compatibility runtime missing: .claude (canonical .agents is sufficient)"
+  warnings=$((warnings + 1))
+fi
+
+if resolve_python_cmd; then
+  echo "✅ Python runtime: ${python_cmd[*]}"
+else
+  echo "❌ Python runtime not found (tried: python3, py -3, python)"
+  errors=$((errors + 1))
+fi
+
+# Required skill contracts
+required_skills=(
+  discovery-skill
+  planning-skill
+  breakdown-skill
+  sync-skill
+  execution-skill
+  quality-skill
+  closeout-skill
+  learning-skill
+)
+
+echo ""
+echo "Required skills"
+echo "---------------"
+for skill in "${required_skills[@]}"; do
+  skill_dir=".agents/skills/$skill"
+  skill_file="$skill_dir/SKILL.md"
+
+  if [[ -f "$skill_file" ]]; then
+    echo "✅ $skill_file"
+  else
+    echo "❌ Missing skill contract: $skill_file"
+    errors=$((errors + 1))
+    continue
+  fi
+
+  runbook="$skill_dir/references/runbook.md"
+  if [[ -f "$runbook" ]]; then
+    echo "✅ $runbook"
+  else
+    echo "❌ Missing skill runbook: $runbook"
+    errors=$((errors + 1))
+  fi
+
+  template_count=0
+  if [[ -d "$skill_dir/templates" ]]; then
+    template_count=$(find "$skill_dir/templates" -maxdepth 1 -type f -name '*.md' | wc -l | tr -d ' ')
+  fi
+
+  if [[ "$template_count" -ge 2 ]]; then
+    echo "✅ $skill_dir/templates ($template_count files)"
+  else
+    echo "❌ Skill needs at least 2 templates: $skill_dir/templates"
+    errors=$((errors + 1))
+  fi
+
+  if grep -q '^## Execution assets' "$skill_file"; then
+    echo "✅ $skill_file includes execution assets section"
+  else
+    echo "❌ $skill_file missing execution assets section"
+    errors=$((errors + 1))
+  fi
+done
+
+# Project contract validation
+for project_dir in .project/projects/*; do
+  [[ -d "$project_dir" ]] || continue
+  [[ "$(basename "$project_dir")" == ".gitkeep" ]] && continue
+
+  echo ""
+  echo "Project: $(basename "$project_dir")"
+
+  for path in spec.md plan.md decisions.md tasks workstreams updates; do
+    if [[ ! -e "$project_dir/$path" ]]; then
+      echo "  ❌ Missing $path"
+      errors=$((errors + 1))
+    fi
+  done
+
+  spec="$project_dir/spec.md"
+  if [[ -f "$spec" ]]; then
+    if ! has_frontmatter "$spec"; then
+      echo "  ❌ spec.md missing frontmatter"
+      errors=$((errors + 1))
+    fi
+    for key in name slug owner status created updated outcome uncertainty probe_required probe_status; do
+      val="$(fm_get "$spec" "$key")"
+      if [[ -z "$val" ]]; then
+        echo "  ❌ spec.md missing key: $key"
+        errors=$((errors + 1))
+      fi
+    done
+    for key in created updated; do
+      val="$(fm_get "$spec" "$key")"
+      if [[ -n "$val" ]] && ! is_iso_utc "$val"; then
+        echo "  ❌ spec.md $key must be ISO8601 UTC"
+        errors=$((errors + 1))
+      fi
+    done
+  fi
+
+  plan="$project_dir/plan.md"
+  if [[ -f "$plan" ]]; then
+    if ! has_frontmatter "$plan"; then
+      echo "  ❌ plan.md missing frontmatter"
+      errors=$((errors + 1))
+    fi
+    for key in name status lead created updated linear_project_id risk_level spec_status_at_plan_time; do
+      val="$(fm_get "$plan" "$key")"
+      if [[ -z "$val" && "$key" != "linear_project_id" ]]; then
+        echo "  ❌ plan.md missing key: $key"
+        errors=$((errors + 1))
+      fi
+    done
+    for key in created updated; do
+      val="$(fm_get "$plan" "$key")"
+      if [[ -n "$val" ]] && ! is_iso_utc "$val"; then
+        echo "  ❌ plan.md $key must be ISO8601 UTC"
+        errors=$((errors + 1))
+      fi
+    done
+  fi
+
+  for task in "$project_dir"/tasks/*.md; do
+    [[ -f "$task" ]] || continue
+    if ! has_frontmatter "$task"; then
+      echo "  ❌ $(basename "$task") missing frontmatter"
+      errors=$((errors + 1))
+      continue
+    fi
+    for key in id name status created updated linear_issue_id github_issue github_pr depends_on conflicts_with parallel priority estimate; do
+      val="$(fm_get "$task" "$key")"
+      if [[ -z "$val" && ! "$key" =~ ^(linear_issue_id|github_issue|github_pr|depends_on|conflicts_with)$ ]]; then
+        echo "  ❌ $(basename "$task") missing key: $key"
+        errors=$((errors + 1))
+      fi
+    done
+  done
+
+  # dependency cycle check for this project
+  if [[ ${#python_cmd[@]} -gt 0 ]]; then
+    "${python_cmd[@]}" - "$project_dir" <<'PY' || errors=$((errors + 1))
+import sys, re
+from pathlib import Path
+
+project = Path(sys.argv[1])
+tasks = {}
+
+def parse_frontmatter(path: Path):
+    text = path.read_text(encoding='utf-8')
+    m = re.match(r'^---\n(.*?)\n---\n', text, re.S)
+    if not m:
+        return {}
+    data = {}
+    for line in m.group(1).splitlines():
+        if ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        data[k.strip()] = v.strip()
+    return data
+
+for f in sorted((project / 'tasks').glob('*.md')):
+    meta = parse_frontmatter(f)
+    tid = meta.get('id') or f.stem
+    raw = meta.get('depends_on', '[]').strip()
+    deps = []
+    if raw.startswith('[') and raw.endswith(']'):
+        inner = raw[1:-1].strip()
+        if inner:
+            deps = [x.strip().strip('"\'') for x in inner.split(',') if x.strip()]
+    tasks[tid] = deps
+
+visited = {}
+
+def dfs(node, stack):
+    state = visited.get(node, 0)
+    if state == 1:
+        cycle = ' -> '.join(stack + [node])
+        raise RuntimeError(f'dependency cycle: {cycle}')
+    if state == 2:
+        return
+    visited[node] = 1
+    for dep in tasks.get(node, []):
+        if dep in tasks:
+            dfs(dep, stack + [node])
+    visited[node] = 2
+
+for t in tasks:
+    dfs(t, [])
+print('  [ok] dependency graph acyclic')
+PY
+  fi
+
+done
+
+# Absolute path leakage check (documentation and contract files only)
+path_tmp="$(mktemp)"
+trap 'rm -f "$path_tmp"' EXIT
+
+compat_paths=()
+if [[ -e .claude || -L .claude ]]; then
+  compat_paths+=(.claude)
+fi
+
+if find .project .agents "${compat_paths[@]}" \
+  -type f \
+  \( -name '*.md' -o -name '*.json' -o -name '*.yaml' -o -name '*.yml' \) \
+  -not -path '.agents/logs/*' \
+  -not -path '.claude/logs/*' \
+  -print0 | xargs -0 grep -nE '(/home/|/Users/|[A-Za-z]:\\)' >"$path_tmp" 2>/dev/null; then
+  echo ""
+  echo "❌ Absolute path leakage found"
+  head -n 20 "$path_tmp"
+  errors=$((errors + 1))
+else
+  echo ""
+  echo "✅ No absolute path leakage in tracked docs and contracts"
+fi
+
+echo ""
+echo "Summary"
+echo "-------"
+echo "Errors: $errors"
+echo "Warnings: $warnings"
+
+if [[ $errors -gt 0 ]]; then
+  exit 1
+fi

package/assets/payload/.agents/scripts/query-log.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+type_filter=""
+actor_filter=""
+since_filter=""
+last_n=""
+pretty=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --type) type_filter="$2"; shift 2 ;;
+    --actor) actor_filter="$2"; shift 2 ;;
+    --since) since_filter="$2"; shift 2 ;;
+    --last) last_n="$2"; shift 2 ;;
+    --pretty) pretty=true; shift ;;
+    *) echo "Unknown arg: $1"; exit 1 ;;
+  esac
+done
+
+LOG_FILE=".agents/logs/changes.jsonl"
+[[ -f "$LOG_FILE" ]] || { echo "No log file: $LOG_FILE"; exit 0; }
+
+node - "$LOG_FILE" "$type_filter" "$actor_filter" "$since_filter" "$last_n" "$pretty" <<'NODE'
+const fs = require('fs');
+
+const [logFile, typeFilter, actorFilter, sinceFilter, lastNRaw, prettyRaw] = process.argv.slice(2);
+const pretty = prettyRaw === 'true';
+const lines = fs.readFileSync(logFile, 'utf8').split('\n').filter(Boolean);
+const parsed = [];
+for (const line of lines) {
+  try { parsed.push(JSON.parse(line)); } catch {}
+}
+
+let out = parsed.filter(e => {
+  if (typeFilter && e.type !== typeFilter) return false;
+  if (actorFilter && e.actor !== actorFilter) return false;
+  if (sinceFilter && (e.timestamp || '') < sinceFilter) return false;
+  return true;
+});
+
+const lastN = Number(lastNRaw || 0);
+if (Number.isFinite(lastN) && lastN > 0) {
+  out = out.slice(-lastN);
+}
+
+for (const row of out) {
+  if (pretty) {
+    console.log(JSON.stringify(row, null, 2));
+  } else {
+    console.log(JSON.stringify(row));
+  }
+}
+NODE

package/assets/payload/.agents/scripts/test-and-log.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -eq 0 ]]; then
+  echo "Usage: $0 <test-command...>"
+  exit 1
+fi
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+mkdir -p .agents/logs/tests
+run_id="$(date -u +"%Y%m%dT%H%M%SZ")"
+log_file=".agents/logs/tests/$run_id.log"
+
+set +e
+"$@" 2>&1 | tee "$log_file"
+exit_code=${PIPESTATUS[0]}
+set -e
+
+timestamp="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+printf '{"timestamp":"%s","command":"%s","exit_code":%s,"log_file":"%s"}\n' \
+  "$timestamp" "$*" "$exit_code" "$log_file" >> .agents/logs/test-runs.jsonl
+
+.agents/scripts/log-event.sh test_run system --command "$*" --exit "$exit_code" --log "$log_file" >/dev/null || true
+
+echo "Saved test log: $log_file"
+exit $exit_code

package/assets/payload/.agents/skills/README.md

@@ -0,0 +1,23 @@
+# Delano Skills
+
+Handbook-aligned skill contracts.
+
+Core workflow skills:
+
+- `discovery-skill`
+- `planning-skill`
+- `breakdown-skill`
+- `sync-skill`
+- `execution-skill`
+- `quality-skill`
+- `closeout-skill`
+- `learning-skill`
+
+Each skill defines:
+- intent and trigger context
+- required inputs
+- output schema
+- quality checks
+- failure behavior
+- allowed side effects
+- script hooks

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

@@ -0,0 +1,40 @@
+---
+name: breakdown-skill
+description: Decompose an approved plan into atomic tasks with dependencies and acceptance criteria. Use when planning is complete and execution must be prepared.
+---
+
+# breakdown-skill
+
+## Trigger context
+- plan is complete and ready for decomposition
+
+## Required inputs
+- spec_path
+- plan_path
+- workstream_files
+
+## Output schema
+- task_files
+- dependency_graph
+
+## Quality checks
+- acceptance criteria are binary
+- estimate present per task
+- dependency graph acyclic
+
+## Failure behavior
+- stop on circular dependency
+- return ambiguity report
+
+## Allowed side effects
+- create/update `.project/projects/<slug>/tasks/*.md`
+
+## Script hooks
+- `bash .agents/scripts/pm/validate.sh`
+- `bash .agents/scripts/pm/next.sh`
+- `bash .agents/scripts/pm/blocked.sh`
+
+## Execution assets
+- `references/runbook.md`
+- `templates/task-batch-summary.md`
+- `templates/ambiguity-report.md`

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

@@ -0,0 +1,16 @@
+# Breakdown Runbook
+
+1. Read `plan.md` and `workstreams/*.md`.
+2. Generate atomic tasks from `.project/templates/task.md`.
+3. Add binary acceptance criteria per task.
+4. Add dependencies and estimate/priority fields.
+5. Run sequencing checks:
+   - `bash .agents/scripts/pm/next.sh --all`
+   - `bash .agents/scripts/pm/blocked.sh`
+6. Validate:
+   - `bash .agents/scripts/pm/validate.sh`
+
+Exit gate:
+- Tasks are atomic
+- Dependencies are acyclic
+- Ready tasks are execution-safe

package/assets/payload/.agents/skills/breakdown-skill/templates/ambiguity-report.md

@@ -0,0 +1,11 @@
+# Breakdown Ambiguity Report
+
+## Ambiguous Requirement
+
+## Why It Blocks Decomposition
+
+## Clarification Needed
+
+## Impacted Workstreams
+
+## Suggested Resolution

package/assets/payload/.agents/skills/breakdown-skill/templates/task-batch-summary.md

@@ -0,0 +1,11 @@
+# Task Batch Summary
+
+## Generated Tasks
+- T-001:
+- T-002:
+
+## Dependency Notes
+
+## Ambiguities Found
+
+## Recommended Start Order

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

@@ -0,0 +1,42 @@
+---
+name: closeout-skill
+description: Close the delivery loop and capture completion evidence, status updates, and handoff artifacts. Use after quality gates pass.
+---
+
+# closeout-skill
+
+## Trigger context
+- quality gates passed for closure scope
+
+## Required inputs
+- project_slug
+- completed_task_ids
+- outcome_review
+
+## Output schema
+- closure update
+- completion summary
+- updated status in contracts/registry
+
+## Quality checks
+- required tasks resolved
+- evidence package complete
+- outcome review captured
+
+## Failure behavior
+- block closure when evidence is incomplete
+- return missing-evidence list
+
+## Allowed side effects
+- update project/task statuses
+- append completion summary and release evidence
+
+## Script hooks
+- `bash .agents/scripts/pm/status.sh`
+- `bash .agents/scripts/query-log.sh --last 50`
+- `bash .agents/scripts/pm/validate.sh`
+
+## Execution assets
+- `references/runbook.md`
+- `templates/outcome-review.md`
+- `templates/closure-checklist.md`

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

@@ -0,0 +1,16 @@
+# Closeout Runbook
+
+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:
+   - `bash .agents/scripts/query-log.sh --last 100`
+6. Validate:
+   - `bash .agents/scripts/pm/status.sh`
+   - `bash .agents/scripts/pm/validate.sh`
+
+Exit gate:
+- Outcome review captured
+- Evidence complete
+- Delivery state closed cleanly

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

@@ -0,0 +1,7 @@
+# Closure Checklist
+
+- [ ] Required tasks resolved
+- [ ] Quality gates passed
+- [ ] Evidence package complete
+- [ ] Registry/state updated
+- [ ] Retrospective scheduled

package/assets/payload/.agents/skills/closeout-skill/templates/outcome-review.md

@@ -0,0 +1,11 @@
+# Outcome Review
+
+## Target Outcome
+
+## Actual Outcome
+
+## Delta
+
+## Root Causes
+
+## Follow-up Actions

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

@@ -0,0 +1,44 @@
+---
+name: discovery-skill
+description: Define and approve a measurable outcome and Spec. Use when a new delivery request has unclear scope, missing outcome, or missing owner.
+---
+
+# discovery-skill
+
+## Trigger context
+- New delivery request with undefined scope
+- Existing scope lacks clear outcome or owner
+
+## Required inputs
+- project_slug
+- project_name
+- owner
+- outcome_hypothesis
+- constraints
+
+## Output schema
+- `.project/projects/<slug>/spec.md`
+- clarified outcome statement
+- open questions list
+
+## Quality checks
+- measurable success criteria present
+- explicit non-goals present
+- dependency assumptions documented
+
+## Failure behavior
+- stop if objective is ambiguous
+- return a clarification question set
+
+## Allowed side effects
+- create project scaffold through init script
+- update `spec.md`
+
+## Script hooks
+- `bash .agents/scripts/pm/init.sh <slug> "<Project Name>" <owner> <lead>`
+- `bash .agents/scripts/pm/validate.sh`
+
+## Execution assets
+- `references/runbook.md`
+- `templates/clarification-questions.md`
+- `templates/discovery-summary.md`

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

@@ -0,0 +1,14 @@
+# Discovery Runbook
+
+1. Confirm project slug, owner, and measurable outcome.
+2. If project scaffold is missing, run:
+   - `bash .agents/scripts/pm/init.sh <slug> "<Project Name>" <owner> <lead>`
+3. Fill `spec.md` using `.project/templates/spec.md`.
+4. Ensure non-goals and dependencies are explicit.
+5. Validate:
+   - `bash .agents/scripts/pm/validate.sh`
+
+Exit gate:
+- Spec outcome is measurable
+- Non-goals are explicit
+- Assumptions are documented

package/assets/payload/.agents/skills/discovery-skill/templates/clarification-questions.md

@@ -0,0 +1,18 @@
+# Discovery Clarification Questions
+
+## Problem
+- What exact pain are we solving?
+- Who is blocked today and how often?
+
+## Outcome
+- What measurable result defines success?
+- What is the target date?
+
+## Scope
+- What is explicitly out of scope?
+- What is the smallest viable first delivery?
+
+## Constraints
+- Technical constraints?
+- Compliance/security constraints?
+- Team/resource constraints?

package/assets/payload/.agents/skills/discovery-skill/templates/discovery-summary.md

@@ -0,0 +1,14 @@
+# Discovery Summary
+
+## Outcome Hypothesis
+
+## Owner
+
+## Scope (In / Out)
+
+## Assumptions
+
+## Open Questions
+
+## Next Action
+- Move to planning once spec is approved.