@bvdm/delano 0.2.3 → 0.2.5

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

@@ -0,0 +1,296 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage:
+  research.sh <project-slug> <research-slug> [options]
+
+Creates a repo-native Delano research intake folder for a project.
+
+Required arguments:
+  project-slug          Existing Delano project slug
+  research-slug         Research folder slug in kebab-case
+
+Options:
+  --title <title>        Human-readable research title
+  --question <question>  Primary research question
+  --owner <owner>        Research owner, defaults to team
+  --no-validate          Create artifacts without running Delano validation
+  --json                 Print a single machine-readable JSON result
+  -h, --help             Show this help
+
+Agent notes:
+  - Use this before mutating spec/plan/tasks when intent is unclear.
+  - Update findings.md and progress.md during investigation.
+  - Fold durable conclusions forward into spec.md, plan.md, decisions.md, workstreams, tasks, or updates.
+  - Research files are supporting discovery state, not executable task truth.
+USAGE
+}
+
+resolve_python() {
+  if command -v python3 >/dev/null 2>&1 && python3 -c "import sys" >/dev/null 2>&1; then
+    PYTHON_CMD=(python3)
+  elif command -v py >/dev/null 2>&1 && py -3 -c "import sys" >/dev/null 2>&1; then
+    PYTHON_CMD=(py -3)
+  elif command -v python >/dev/null 2>&1 && python -c "import sys" >/dev/null 2>&1; then
+    PYTHON_CMD=(python)
+  else
+    echo "Error: Python runtime not found. Install python3, python, or py -3." >&2
+    exit 1
+  fi
+}
+
+resolve_python
+
+json_escape() {
+  "${PYTHON_CMD[@]}" -c 'import json,sys; print(json.dumps(sys.stdin.read().rstrip("\n")))'
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+if [[ "${2:-}" == "" ]]; then
+  usage
+  exit 1
+fi
+
+project_slug="$1"
+research_slug="$2"
+shift 2
+
+title=""
+question=""
+owner="team"
+validate="true"
+json="false"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --title)
+      title="${2:-}"
+      if [[ -z "$title" ]]; then echo "Error: --title requires a value"; exit 1; fi
+      shift 2
+      ;;
+    --question)
+      question="${2:-}"
+      if [[ -z "$question" ]]; then echo "Error: --question requires a value"; exit 1; fi
+      shift 2
+      ;;
+    --owner)
+      owner="${2:-}"
+      if [[ -z "$owner" ]]; then echo "Error: --owner requires a value"; exit 1; fi
+      shift 2
+      ;;
+    --no-validate)
+      validate="false"
+      shift
+      ;;
+    --json)
+      json="true"
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --)
+      shift
+      ;;
+    --*)
+      echo "Error: unknown option: $1"
+      exit 1
+      ;;
+    *)
+      echo "Error: unexpected positional argument: $1"
+      exit 1
+      ;;
+  esac
+done
+
+if [[ ! "$project_slug" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+  echo "Error: project-slug must be kebab-case"
+  exit 1
+fi
+
+if [[ ! "$research_slug" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+  echo "Error: research-slug must be kebab-case"
+  exit 1
+fi
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+project_dir=".project/projects/$project_slug"
+if [[ ! -d "$project_dir" ]]; then
+  echo "Error: Delano project not found: $project_dir"
+  exit 1
+fi
+
+research_dir="$project_dir/research/$research_slug"
+if [[ -d "$research_dir" ]]; then
+  echo "Error: research intake already exists at $research_dir"
+  exit 1
+fi
+
+now="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+title="${title:-${research_slug//-/ }}"
+question="${question:-<primary research question>}"
+
+mkdir -p "$research_dir"
+
+cat > "$research_dir/task_plan.md" <<PLAN
+---
+type: research_intake
+project: $project_slug
+slug: $research_slug
+owner: $owner
+status: opened
+created: $now
+updated: $now
+---
+
+# Research Plan: $title
+
+## Goal
+
+Answer the research question and fold durable conclusions into canonical Delano project artifacts.
+
+## Primary Question
+
+$question
+
+## Scope
+
+### In Scope
+
+- Gather relevant evidence.
+- Capture findings and decisions.
+- Identify changes needed in \`spec.md\`, \`plan.md\`, \`decisions.md\`, workstreams, tasks, or updates.
+
+### Out of Scope
+
+- Marking delivery tasks done from research alone.
+- External sync writes without normal Delano approval semantics.
+- Storing secrets, credentials, or private machine paths.
+
+## Current Phase
+
+Opened
+
+## Phases
+
+- [x] Open research intake
+- [ ] Investigate sources and options
+- [ ] Summarize findings
+- [ ] Fold forward into canonical project artifacts or explicitly close as no-action
+
+## Decisions Made
+
+| Decision | Rationale |
+| --- | --- |
+
+## Blockers
+
+| Blocker | Owner | Check-back |
+| --- | --- | --- |
+PLAN
+
+cat > "$research_dir/findings.md" <<FINDINGS
+---
+type: research_findings
+project: $project_slug
+slug: $research_slug
+created: $now
+updated: $now
+---
+
+# Findings: $title
+
+## Source References
+
+- <source, file, command, or artifact inspected>
+
+## Observations
+
+- <finding>
+
+## Options Considered
+
+| Option | Pros | Cons | Decision |
+| --- | --- | --- | --- |
+
+## Fold-Forward Candidates
+
+| Finding | Target Artifact | Proposed Change |
+| --- | --- | --- |
+
+## Open Questions
+
+- <question>
+FINDINGS
+
+cat > "$research_dir/progress.md" <<PROGRESS
+---
+type: research_progress
+project: $project_slug
+slug: $research_slug
+created: $now
+updated: $now
+---
+
+# Progress: $title
+
+## $now
+
+- Opened research intake for project \`$project_slug\`.
+- Primary question: $question
+
+## Validation Evidence
+
+- Pending.
+
+## Handoff Summary
+
+- Pending.
+PROGRESS
+
+validation_status="skipped"
+ok="true"
+error=""
+if [[ "$validate" == "true" ]]; then
+  if [[ "$json" == "true" ]]; then
+    validation_log="$(mktemp)"
+    if "$root/.agents/scripts/pm/validate.sh" >"$validation_log" 2>&1; then
+      validation_status="passed"
+    else
+      validation_status="failed"
+      ok="false"
+      error="validation_failed"
+    fi
+    rm -f "$validation_log"
+  else
+    "$root/.agents/scripts/pm/validate.sh"
+    validation_status="passed"
+  fi
+fi
+
+if [[ "$json" == "true" ]]; then
+  project_json="$(printf '%s' "$project_dir" | json_escape)"
+  research_json="$(printf '%s' "$research_dir" | json_escape)"
+  validation_json="$(printf '%s' "$validation_status" | json_escape)"
+  if [[ "$ok" == "true" ]]; then
+    printf '{"ok":true,"command":"research","project":%s,"research":%s,"files":["task_plan.md","findings.md","progress.md"],"validation":%s}\n' "$project_json" "$research_json" "$validation_json"
+  else
+    error_json="$(printf '%s' "$error" | json_escape)"
+    printf '{"ok":false,"command":"research","project":%s,"research":%s,"files":["task_plan.md","findings.md","progress.md"],"validation":%s,"error":%s}\n' "$project_json" "$research_json" "$validation_json" "$error_json"
+    exit 1
+  fi
+else
+  echo "Created Delano research intake: $research_dir"
+  echo "Files: task_plan.md, findings.md, progress.md"
+  echo "Validation: $validation_status"
+  echo "Next: update findings.md and progress.md, then fold conclusions into canonical Delano artifacts."
+fi

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

@@ -4,24 +4,92 @@ set -euo pipefail
 root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
 cd "$root"
 
+open_only=false
+brief=false
+
+usage() {
+  cat <<'EOF'
+Usage:
+  status.sh [--open] [--brief]
+
+Options:
+  --open   Show only projects that are not closed.
+  --brief  Show one compact line per project.
+  -h, --help
+           Show this help.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --open)
+      open_only=true
+      ;;
+    --brief)
+      brief=true
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown status option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
 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"
+  local line
+  local in_fm=0
+  while IFS= read -r line; do
+    if [[ "$line" =~ ^---[[:space:]]*$ ]]; then
+      if [[ $in_fm -eq 0 ]]; then
+        in_fm=1
+        continue
+      fi
+      return 1
+    fi
+
+    if [[ $in_fm -eq 1 && "$line" == "$key:"* ]]; then
+      local value="${line#"$key:"}"
+      value="${value#"${value%%[![:space:]]*}"}"
+      printf '%s\n' "$value"
+      return 0
+    fi
+  done < "$file"
+  return 1
 }
 
-echo "Delano portfolio status"
-echo "======================="
+is_closed_spec_status() {
+  local status="${1:-unknown}"
+  [[ "$status" == "complete" || "$status" == "deferred" ]]
+}
+
+is_closed_plan_status() {
+  local status="${1:-unknown}"
+  [[ "$status" == "done" || "$status" == "deferred" ]]
+}
+
+is_closed_task_status() {
+  local status="${1:-unknown}"
+  [[ "$status" == "done" || "$status" == "deferred" || "$status" == "canceled" ]]
+}
+
+if [[ "$open_only" == "true" ]]; then
+  echo "Delano open project status"
+  echo "=========================="
+else
+  echo "Delano portfolio status"
+  echo "======================="
+fi
 
 project_count=0
+printed_count=0
 for project_dir in .project/projects/*; do
   [[ -d "$project_dir" ]] || continue
   [[ "$(basename "$project_dir")" == ".gitkeep" ]] && continue
@@ -31,31 +99,70 @@ for project_dir in .project/projects/*; do
   spec_status="$(fm_get "$project_dir/spec.md" status 2>/dev/null || true)"
   plan_status="$(fm_get "$project_dir/plan.md" status 2>/dev/null || true)"
 
-  echo ""
-  echo "Project: $slug"
-  echo "  Spec status: ${spec_status:-unknown}"
-  echo "  Plan status: ${plan_status:-unknown}"
-
   total=0
+  open_tasks=0
+  backlog_count=0
+  ready_count=0
+  in_progress_count=0
+  review_count=0
+  done_count=0
+  blocked_count=0
+  deferred_count=0
+  canceled_count=0
+  unknown_count=0
   for task in "$project_dir"/tasks/*.md; do
     [[ -f "$task" ]] || continue
+    status="$(fm_get "$task" status 2>/dev/null || true)"
     total=$((total + 1))
+    if ! is_closed_task_status "$status"; then
+      open_tasks=$((open_tasks + 1))
+    fi
+    case "$status" in
+      backlog) backlog_count=$((backlog_count + 1)) ;;
+      ready) ready_count=$((ready_count + 1)) ;;
+      in-progress) in_progress_count=$((in_progress_count + 1)) ;;
+      review) review_count=$((review_count + 1)) ;;
+      done) done_count=$((done_count + 1)) ;;
+      blocked) blocked_count=$((blocked_count + 1)) ;;
+      deferred) deferred_count=$((deferred_count + 1)) ;;
+      canceled) canceled_count=$((canceled_count + 1)) ;;
+      *) unknown_count=$((unknown_count + 1)) ;;
+    esac
   done
 
-  for st in backlog ready in-progress review done blocked canceled; do
-    count=0
-    for task in "$project_dir"/tasks/*.md; do
-      [[ -f "$task" ]] || continue
-      status="$(fm_get "$task" status 2>/dev/null || true)"
-      if [[ "$status" == "$st" ]]; then
-        count=$((count + 1))
-      fi
-    done
-    [[ $count -gt 0 ]] && echo "  $st: $count"
-  done
-  echo "  total tasks: $total"
+  project_open=false
+  if ! is_closed_spec_status "$spec_status" || ! is_closed_plan_status "$plan_status" || [[ $open_tasks -gt 0 ]]; then
+    project_open=true
+  fi
+
+  if [[ "$open_only" == "true" && "$project_open" != "true" ]]; then
+    continue
+  fi
+
+  printed_count=$((printed_count + 1))
+
+  if [[ "$brief" == "true" ]]; then
+    echo "${slug}  spec=${spec_status:-unknown} plan=${plan_status:-unknown} open_tasks=${open_tasks} total_tasks=${total}"
+  else
+    echo ""
+    echo "Project: $slug"
+    echo "  Spec status: ${spec_status:-unknown}"
+    echo "  Plan status: ${plan_status:-unknown}"
+    [[ $backlog_count -gt 0 ]] && echo "  backlog: $backlog_count"
+    [[ $ready_count -gt 0 ]] && echo "  ready: $ready_count"
+    [[ $in_progress_count -gt 0 ]] && echo "  in-progress: $in_progress_count"
+    [[ $review_count -gt 0 ]] && echo "  review: $review_count"
+    [[ $done_count -gt 0 ]] && echo "  done: $done_count"
+    [[ $blocked_count -gt 0 ]] && echo "  blocked: $blocked_count"
+    [[ $deferred_count -gt 0 ]] && echo "  deferred: $deferred_count"
+    [[ $canceled_count -gt 0 ]] && echo "  canceled: $canceled_count"
+    [[ $unknown_count -gt 0 ]] && echo "  unknown: $unknown_count"
+    echo "  total tasks: $total"
+  fi
 done
 
 if [[ $project_count -eq 0 ]]; then
   echo "No projects found. Create one with: .agents/scripts/pm/init.sh <slug> <project-name>"
+elif [[ "$open_only" == "true" && $printed_count -eq 0 ]]; then
+  echo "No open projects found."
 fi

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

@@ -467,6 +467,20 @@ if [[ -n "$artifact_schema_check" ]]; then
   fi
 fi
 
+if [[ -f scripts/check-adapter-manifests.mjs ]]; then
+  echo ""
+  if command -v node >/dev/null 2>&1; then
+    if node scripts/check-adapter-manifests.mjs; then
+      true
+    else
+      errors=$((errors + 1))
+    fi
+  else
+    echo "❌ Node runtime not found for adapter manifest check"
+    errors=$((errors + 1))
+  fi
+fi
+
 operating_modes_check=""
 if [[ -f .agents/scripts/check-operating-modes.mjs ]]; then
   operating_modes_check=".agents/scripts/check-operating-modes.mjs"
@@ -497,6 +511,8 @@ fi
 
 if [[ -n "$status_transition_check" ]]; then
   echo ""
+  echo "Project lifecycle and status transition check"
+  echo "---------------------------------------------"
   if command -v node >/dev/null 2>&1; then
     if node "$status_transition_check"; then
       true

package/assets/payload/.codex/hooks.json

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/hooks/codex-session-status.js\"",
+            "timeout": 5,
+            "statusMessage": "Loading Delano open projects"
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -3,8 +3,9 @@
 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`
+- Default starting URL: `http://127.0.0.1:3977`
+- Override starting port: `DELANO_VIEWER_PORT=3987 npm run viewer`
+- Multiple viewers can run at once. If the starting port is already in use, the viewer tries the next available port and prints the actual URL.
 
 Run from the repository root:
 

package/assets/payload/.delano/viewer/public/app.js

@@ -771,7 +771,19 @@ function render() {
   });
   document.querySelectorAll('[data-doc]').forEach((el) => el.onclick = () => loadDoc(el.dataset.doc));
   document.querySelectorAll('[data-status]').forEach((el) => el.onclick = () => { state.status = el.dataset.status; render(); });
-  document.querySelectorAll('[data-role]').forEach((el) => el.onclick = () => { state.role = el.dataset.role; state.workstream = null; render(); });
+  document.querySelectorAll('[data-role]').forEach((el) => el.onclick = () => {
+    state.role = el.dataset.role;
+    state.workstream = null;
+    if (state.role !== 'all') {
+      const firstInRole = currentDocs().find((doc) => doc.role === state.role);
+      if (firstInRole) {
+        if (state.role === 'workstream') state.workstream = firstInRole.path;
+        loadDoc(firstInRole.path);
+        return;
+      }
+    }
+    render();
+  });
   document.querySelectorAll('[data-workstream]').forEach((el) => el.onclick = () => { state.workstream = el.dataset.workstream; state.role = 'all'; loadDoc(el.dataset.doc); });
   document.querySelectorAll('[data-clear-workstream]').forEach((el) => el.onclick = () => { state.workstream = null; render(); });
   document.querySelectorAll('[data-outline-toggle]').forEach((el) => el.onclick = () => { state.outlineOpen = !state.outlineOpen; render(); });

package/assets/payload/.delano/viewer/public/index.html

@@ -1,21 +1,19 @@
 <!doctype html>
 <html lang="en">
 <head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>Delano Viewer</title>
-  <link rel="preconnect" href="https://fonts.googleapis.com" crossorigin />
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-  <link
-    rel="stylesheet"
-    href="https://fonts.googleapis.com/css2?family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;0,6..72,600;1,6..72,400&family=Instrument+Serif:ital@0;1&display=swap"
-  />
-  <link rel="stylesheet" href="/styles.css" />
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Delano Viewer</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="/styles.css" />
 </head>
 <body>
-  <div class="ambient" aria-hidden="true"></div>
-  <div id="app">Loading Delano viewer...</div>
-  <div id="copy-live" class="visually-hidden" aria-live="polite" aria-atomic="true"></div>
-  <script src="/app.js"></script>
+<div id="root"></div>
+<script src="https://unpkg.com/react@18.3.1/umd/react.development.js" crossorigin="anonymous"></script>
+<script src="https://unpkg.com/react-dom@18.3.1/umd/react-dom.development.js" crossorigin="anonymous"></script>
+<script src="https://unpkg.com/@babel/standalone@7.29.0/babel.min.js" crossorigin="anonymous"></script>
+<script type="text/babel" src="/app.jsx"></script>
 </body>
 </html>