@bvdm/delano 0.1.0

package/assets/payload/.agents/scripts/git-sparse-download.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+
+# Git Sparse Checkout - Download specific directories from GitHub repositories
+# Usage: ./git-sparse-download.sh <repo_url> <directory_path> [target_name]
+# Example: ./git-sparse-download.sh https://github.com/google/guava guava-gwt
+# Example: ./git-sparse-download.sh https://github.com/ComposioHQ/awesome-claude-skills skill-creator skills/skill-creator
+
+set -e
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m' # No Color
+
+# Function to print colored output
+print_error() { echo -e "${RED}❌ $1${NC}"; }
+print_success() { echo -e "${GREEN}✅ $1${NC}"; }
+print_info() { echo -e "${YELLOW}ℹ️  $1${NC}"; }
+
+# Check arguments
+if [ "$#" -lt 2 ] || [ "$#" -gt 3 ]; then
+    echo "Usage: $0 <repo_url> <directory_path> [target_name]"
+    echo ""
+    echo "Arguments:"
+    echo "  repo_url       - GitHub repository URL (e.g., https://github.com/user/repo)"
+    echo "  directory_path - Path to the directory in the repo (e.g., src/components)"
+    echo "  target_name    - Optional: Name for the downloaded directory (defaults to directory name)"
+    echo ""
+    echo "Examples:"
+    echo "  $0 https://github.com/google/guava guava-gwt"
+    echo "  $0 https://github.com/ComposioHQ/awesome-claude-skills skill-creator skills/my-skill"
+    exit 1
+fi
+
+REPO_URL=$1
+DIR_PATH=$2
+TARGET_NAME=${3:-$(basename "$DIR_PATH")}
+
+# Validate repo URL
+if [[ ! "$REPO_URL" =~ ^https?://github\.com/.*$ ]]; then
+    print_error "Invalid GitHub URL. URL must start with https://github.com/"
+    exit 1
+fi
+
+# Clean up directory path (remove leading/trailing slashes)
+DIR_PATH=$(echo "$DIR_PATH" | sed 's|^/||;s|/$||')
+
+print_info "Repository: $REPO_URL"
+print_info "Directory: $DIR_PATH"
+print_info "Target: $TARGET_NAME"
+
+# Create a temporary directory for the operation
+TEMP_DIR=$(mktemp -d)
+trap "rm -rf $TEMP_DIR" EXIT
+
+print_info "Initializing sparse checkout..."
+
+# Navigate to temp directory
+cd "$TEMP_DIR" || exit 1
+
+# Initialize empty git repo
+git init -q 2>/dev/null || {
+    print_error "Failed to initialize git repository"
+    exit 1
+}
+
+# Add remote
+git remote add origin "$REPO_URL" 2>/dev/null || {
+    print_error "Failed to add remote repository"
+    exit 1
+}
+
+# Configure sparse checkout
+git config core.sparseCheckout true
+
+# Handle both old and new sparse-checkout patterns
+# Try new way first (Git 2.25+), fall back to old way
+if command -v git sparse-checkout >/dev/null 2>&1 && git sparse-checkout init --cone 2>/dev/null; then
+    # New sparse-checkout command available
+    git sparse-checkout set "$DIR_PATH" 2>/dev/null || echo "$DIR_PATH" >> .git/info/sparse-checkout
+else
+    # Fall back to old method
+    echo "$DIR_PATH/*" >> .git/info/sparse-checkout
+    echo "$DIR_PATH/**" >> .git/info/sparse-checkout
+fi
+
+# Attempt to fetch and checkout
+print_info "Downloading $DIR_PATH from repository..."
+
+# Determine the default branch
+DEFAULT_BRANCH=$(git ls-remote --symref origin HEAD 2>/dev/null | grep "ref:" | sed 's/.*refs\/heads\///' | sed 's/[[:space:]].*$//')
+if [ -z "$DEFAULT_BRANCH" ]; then
+    # Try common branch names
+    for branch in main master; do
+        if git ls-remote --heads origin $branch 2>/dev/null | grep -q $branch; then
+            DEFAULT_BRANCH=$branch
+            break
+        fi
+    done
+fi
+
+# If we still don't have a branch, default to main
+DEFAULT_BRANCH=${DEFAULT_BRANCH:-main}
+
+print_info "Using branch: $DEFAULT_BRANCH"
+
+# Fetch with depth 1 for speed
+if ! git fetch --depth=1 origin "$DEFAULT_BRANCH" 2>/dev/null; then
+    print_error "Failed to fetch from repository. Please check the URL and your internet connection."
+    exit 1
+fi
+
+# Checkout the fetched branch
+if ! git checkout -f "origin/$DEFAULT_BRANCH" 2>/dev/null; then
+    print_error "Failed to checkout repository content"
+    exit 1
+fi
+
+# Check if the directory exists
+if [ ! -d "$DIR_PATH" ]; then
+    print_error "Directory '$DIR_PATH' not found in repository"
+    print_info "Available directories in root:"
+    ls -d */ 2>/dev/null | head -10 || echo "  (none found)"
+    exit 1
+fi
+
+# Move the downloaded folder to the user's original location
+print_info "Moving files to current directory..."
+
+# Ensure we're back in the original directory
+cd "$OLDPWD" || exit 1
+
+# Check if target already exists
+if [ -e "$TARGET_NAME" ]; then
+    print_error "Target '$TARGET_NAME' already exists in current directory"
+    echo "Please remove it first or choose a different target name"
+    exit 1
+fi
+
+# Move the directory
+if mv "$TEMP_DIR/$DIR_PATH" "$TARGET_NAME" 2>/dev/null; then
+    print_success "Successfully downloaded '$DIR_PATH' as '$TARGET_NAME'"
+
+    # Show what was downloaded
+    echo ""
+    echo "Downloaded structure:"
+    if command -v tree >/dev/null 2>&1; then
+        tree -L 2 "$TARGET_NAME" 2>/dev/null | head -20
+    else
+        ls -la "$TARGET_NAME" 2>/dev/null | head -10
+    fi
+else
+    print_error "Failed to move directory to target location"
+    exit 1
+fi
+
+# Additional info
+echo ""
+print_info "To use this as a Delano skill, copy it to .agents/skills/"
+print_info "Compatibility mirror: .claude/skills/ when present"
+print_info "Example: mv $TARGET_NAME .agents/skills/"

package/assets/payload/.agents/scripts/log-event.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+if (args.length < 2) {
+  console.error('Usage: log-event.js <type> <actor> [--key value ...]');
+  process.exit(1);
+}
+
+const [type, actor, ...rest] = args;
+const event = {
+  timestamp: new Date().toISOString(),
+  type,
+  actor,
+  meta: {}
+};
+
+for (let i = 0; i < rest.length; i++) {
+  const token = rest[i];
+  if (!token.startsWith('--')) continue;
+  const key = token.slice(2);
+  const value = rest[i + 1] && !rest[i + 1].startsWith('--') ? rest[++i] : 'true';
+  event.meta[key] = value;
+}
+
+const root = process.cwd();
+const logDir = path.join(root, '.agents', 'logs');
+const logFile = path.join(logDir, 'changes.jsonl');
+fs.mkdirSync(logDir, { recursive: true });
+fs.appendFileSync(logFile, JSON.stringify(event) + '\n', 'utf8');
+
+console.log(`logged ${type}`);

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

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+node "$script_dir/log-event.js" "$@"

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

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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"
+}
+
+found=0
+for task in .project/projects/*/tasks/*.md; do
+  [[ -f "$task" ]] || continue
+  status="$(fm_get "$task" status 2>/dev/null || true)"
+  [[ "$status" == "blocked" ]] || continue
+
+  project="$(basename "$(dirname "$(dirname "$task")")")"
+  tid="$(fm_get "$task" id 2>/dev/null || basename "$task" .md)"
+  name="$(fm_get "$task" name 2>/dev/null || basename "$task" .md)"
+  echo "$project\t$tid\t$name\t$task"
+  found=1
+done
+
+if [[ $found -eq 0 ]]; then
+  echo "No blocked tasks."
+fi

package/assets/payload/.agents/scripts/pm/epic-list.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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"
+}
+
+found=0
+for plan in .project/projects/*/plan.md; do
+  [[ -f "$plan" ]] || continue
+  slug="$(basename "$(dirname "$plan")")"
+  name="$(fm_get "$plan" name 2>/dev/null || echo "$slug")"
+  status="$(fm_get "$plan" status 2>/dev/null || echo "unknown")"
+  lead="$(fm_get "$plan" lead 2>/dev/null || true)"
+  echo "$slug\t$name\t$status\t$lead"
+  found=1
+done
+
+if [[ $found -eq 0 ]]; then
+  echo "No delivery plans found."
+fi

package/assets/payload/.agents/scripts/pm/in-progress.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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"
+}
+
+found=0
+for task in .project/projects/*/tasks/*.md; do
+  [[ -f "$task" ]] || continue
+  status="$(fm_get "$task" status 2>/dev/null || true)"
+  if [[ "$status" == "in-progress" || "$status" == "review" ]]; then
+    project="$(basename "$(dirname "$(dirname "$task")")")"
+    tid="$(fm_get "$task" id 2>/dev/null || basename "$task" .md)"
+    name="$(fm_get "$task" name 2>/dev/null || basename "$task" .md)"
+    echo "$project\t$tid\t$status\t$name"
+    found=1
+  fi
+done
+
+if [[ $found -eq 0 ]]; then
+  echo "No tasks in progress or review."
+fi

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

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "" || "${2:-}" == "" ]]; then
+  echo "Usage: $0 <slug> <project-name> [owner] [lead]"
+  exit 1
+fi
+
+slug="$1"
+name="$2"
+owner="${3:-team}"
+lead="${4:-$owner}"
+
+if [[ ! "$slug" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
+  echo "Error: slug must be kebab-case"
+  exit 1
+fi
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+project_dir="$root/.project/projects/$slug"
+now="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+if [[ -d "$project_dir" ]]; then
+  echo "Error: project already exists at $project_dir"
+  exit 1
+fi
+
+mkdir -p "$project_dir"/{tasks,workstreams,updates}
+
+cat > "$project_dir/spec.md" <<SPEC
+---
+name: $name
+slug: $slug
+owner: $owner
+status: draft
+created: $now
+updated: $now
+outcome: <measurable target>
+uncertainty: <low|medium|high>
+probe_required: <true|false>
+probe_status: <pending|skipped|completed>
+---
+
+# Spec: $name
+
+## Executive Summary
+
+## Problem and Users
+
+## Outcome and Success Metrics
+
+## Scope
+### In Scope
+### Out of Scope
+
+## Functional Requirements
+
+## Non-Functional Requirements
+
+## Hypotheses and Unknowns
+
+## Touchpoints to Exercise
+
+## Probe Findings
+
+## Footguns Discovered
+
+## Remaining Unknowns
+
+## Dependencies
+
+## Approval Notes
+SPEC
+
+cat > "$project_dir/plan.md" <<PLAN
+---
+name: $name
+status: planned
+lead: $lead
+created: $now
+updated: $now
+linear_project_id:
+risk_level: <low|medium|high>
+spec_status_at_plan_time: <approved|active>
+---
+
+# Delivery Plan: $name
+
+## What Changed After Probe
+
+## Architecture Decisions
+
+## Probe-Driven Architecture Changes
+
+## Workstream Design
+
+## Milestone Strategy
+
+## Rollout Strategy
+
+## Test Strategy
+
+## Rollback Strategy
+
+## Remaining Delivery Risks
+PLAN
+
+cat > "$project_dir/decisions.md" <<'DECISIONS'
+# Decisions
+
+Track key project decisions with context and rationale.
+DECISIONS
+
+# Ensure registries exist
+mkdir -p "$root/.project/registry"
+if [[ ! -f "$root/.project/registry/linear-map.json" ]]; then
+  cat > "$root/.project/registry/linear-map.json" <<REG
+{
+  "version": 1,
+  "updated": "$now",
+  "projects": {},
+  "tasks": {}
+}
+REG
+fi
+
+if [[ ! -f "$root/.project/registry/migration-map.json" ]]; then
+  cat > "$root/.project/registry/migration-map.json" <<REG
+{
+  "version": 1,
+  "updated": "$now",
+  "mappings": []
+}
+REG
+fi
+
+echo "Created Delano project scaffold: .project/projects/$slug"
+
+"$root/.agents/scripts/pm/validate.sh"

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

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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
+
+  echo "No usable Python runtime found (tried: python3, py -3, python)." >&2
+  exit 1
+}
+
+show_all=false
+if [[ "${1:-}" == "--all" ]]; then
+  show_all=true
+fi
+
+if [[ "$show_all" == "true" ]]; then
+  export DELANO_NEXT_ALL=1
+else
+  export DELANO_NEXT_ALL=0
+fi
+
+resolve_python_cmd
+
+"${python_cmd[@]}" - <<'PY'
+import re
+from pathlib import Path
+
+ROOT = Path('.')
+TASK_STATUS_READY = 'ready'
+
+rank = {'urgent': 0, 'high': 1, 'medium': 2, 'low': 3}
+
+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
+
+def parse_list(raw: str):
+    raw = (raw or '[]').strip()
+    if raw.startswith('[') and raw.endswith(']'):
+      inner = raw[1:-1].strip()
+      if not inner:
+        return []
+      return [x.strip().strip('"\'') for x in inner.split(',') if x.strip()]
+    return []
+
+projects = sorted((ROOT / '.project' / 'projects').glob('*'))
+all_candidates = []
+for p in projects:
+  if not p.is_dir() or p.name == '.gitkeep':
+    continue
+  tasks = {}
+  for tf in sorted((p / 'tasks').glob('*.md')):
+    meta = parse_frontmatter(tf)
+    tid = meta.get('id', tf.stem)
+    tasks[tid] = {
+      'path': tf,
+      'name': meta.get('name', tf.stem),
+      'status': meta.get('status', ''),
+      'depends_on': parse_list(meta.get('depends_on', '[]')),
+      'priority': meta.get('priority', 'medium').lower(),
+    }
+
+  for tid, t in tasks.items():
+    if t['status'] != TASK_STATUS_READY:
+      continue
+    unmet = [d for d in t['depends_on'] if d in tasks and tasks[d]['status'] != 'done']
+    if unmet:
+      continue
+    all_candidates.append((rank.get(t['priority'], 4), p.name, tid, t['name'], t['priority'], str(t['path'])))
+
+all_candidates.sort()
+if not all_candidates:
+  print('No dependency-safe ready tasks found.')
+  raise SystemExit(0)
+
+import os
+show_all = os.environ.get('DELANO_NEXT_ALL', '0') == '1'
+if not show_all:
+  all_candidates = all_candidates[:1]
+
+for _, project, tid, name, prio, path in all_candidates:
+  print(f'{project}\t{tid}\t{prio}\t{name}\t{path}')
+PY

package/assets/payload/.agents/scripts/pm/prd-list.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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"
+}
+
+found=0
+for spec in .project/projects/*/spec.md; do
+  [[ -f "$spec" ]] || continue
+  slug="$(basename "$(dirname "$spec")")"
+  name="$(fm_get "$spec" name 2>/dev/null || echo "$slug")"
+  status="$(fm_get "$spec" status 2>/dev/null || echo "unknown")"
+  outcome="$(fm_get "$spec" outcome 2>/dev/null || true)"
+  echo "$slug\t$name\t$status\t$outcome"
+  found=1
+done
+
+if [[ $found -eq 0 ]]; then
+  echo "No specs found."
+fi

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

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "${1:-}" == "" ]]; then
+  echo "Usage: $0 <query>"
+  exit 1
+fi
+
+query="$*"
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+grep -R -n -- "$query" .project/projects .project/context .project/registry || true

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+echo "Daily standup snapshot ($(date -u +"%Y-%m-%dT%H:%M:%SZ"))"
+echo ""
+
+echo "[Portfolio]"
+"$root/.agents/scripts/pm/status.sh"
+
+echo ""
+echo "[In Progress]"
+"$root/.agents/scripts/pm/in-progress.sh"
+
+echo ""
+echo "[Blocked]"
+"$root/.agents/scripts/pm/blocked.sh"

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

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+cd "$root"
+
+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"
+}
+
+echo "Delano portfolio status"
+echo "======================="
+
+project_count=0
+for project_dir in .project/projects/*; do
+  [[ -d "$project_dir" ]] || continue
+  [[ "$(basename "$project_dir")" == ".gitkeep" ]] && continue
+  project_count=$((project_count + 1))
+
+  slug="$(basename "$project_dir")"
+  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
+  for task in "$project_dir"/tasks/*.md; do
+    [[ -f "$task" ]] || continue
+    total=$((total + 1))
+  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"
+done
+
+if [[ $project_count -eq 0 ]]; then
+  echo "No projects found. Create one with: .agents/scripts/pm/init.sh <slug> <project-name>"
+fi