@indigoai-us/hq-cli 5.77.13 → 5.78.0

package/assets/scaffold/core/scripts/qmd-reindex-after-sync.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+# qmd-reindex-after-sync.sh — incremental qmd reindex after an HQ sync.
+#
+# Why this exists: the qmd index is a per-machine local SQLite store derived
+# from local folder paths. Nothing re-indexed it after `hq-sync` pulled new
+# files in, so search results diverged between teammates depending on who ran
+# `qmd update` most recently. This script makes post-sync indexing automatic
+# and deterministic, so every machine's personal index converges to the same
+# content. The index itself stays personal (it is large, binary, and embeds
+# absolute local paths); only the *freshness* is made automatic.
+#
+# Behavior:
+#   1. Auto-registers any company knowledge dir that isn't yet a qmd
+#      collection (fixes the "newly-synced knowledge isn't searchable until I
+#      manually map it" gap).
+#   2. Runs an incremental lexical reindex (`qmd update` — fast, skips
+#      unchanged files by mtime).
+#   3. Rebuilds embeddings only when called with --embed (slow on a
+#      multi-GB index; meant for an idle/interval pass, not every sync).
+#
+# Idempotent and safe: no-op (exit 0) when qmd is absent or the path isn't an
+# HQ root. Never blocks or fails a sync.
+#
+# Usage: qmd-reindex-after-sync.sh [hq_root] [--embed]
+#   hq_root  Local HQ directory (default: $PWD). Must contain core/core.yaml.
+#   --embed  Also rebuild embeddings (deferred-cost; omit for fast lexical-only).
+
+set -uo pipefail
+
+hq_root=""
+embed=0
+for arg in "$@"; do
+  case "$arg" in
+    --embed) embed=1 ;;
+    --*)     : ;;                       # ignore unknown flags
+    *)       [ -z "$hq_root" ] && hq_root="$arg" ;;
+  esac
+done
+[ -z "$hq_root" ] && hq_root="$PWD"
+
+command -v qmd >/dev/null 2>&1 || exit 0
+[ -f "$hq_root/core/core.yaml" ] || exit 0
+
+cd "$hq_root" || exit 0
+
+# 1. Auto-register company knowledge collections that don't exist yet.
+#    Convention matches /newcompany: --name <slug> --mask "**/*.md".
+existing="$(qmd collection list 2>/dev/null || true)"
+for kdir in companies/*/knowledge; do
+  [ -d "$kdir" ] || continue
+  [ -n "$(find "$kdir" -name '*.md' -not -name 'INDEX.md' -print -quit 2>/dev/null)" ] || continue
+  slug="$(basename "$(dirname "$kdir")")"
+  printf '%s\n' "$existing" | grep -Fq "qmd://$slug/" && continue
+  qmd collection add "$hq_root/$kdir" --name "$slug" --mask "**/*.md" >/dev/null 2>&1 || true
+  qmd context add "qmd://$slug" "Knowledge base for $slug." >/dev/null 2>&1 || true
+done
+
+# 1b. Auto-register company *projects* collections that don't exist yet.
+#    Convention matches the HQ-level `hq-projects` collection: --name <slug>-projects
+#    --mask "**/*.{md,json}" (so prd.json + project docs are searchable). Without
+#    this, company projects/ dirs are indexed by nothing and /startwork's global
+#    `qmd search "prd.json"` and /brainstorm's project discovery silently miss them.
+for pdir in companies/*/projects; do
+  [ -d "$pdir" ] || continue
+  [ -n "$(find "$pdir" -type f \( -name '*.md' -o -name '*.json' \) -print -quit 2>/dev/null)" ] || continue
+  slug="$(basename "$(dirname "$pdir")")"
+  name="${slug}-projects"
+  printf '%s\n' "$existing" | grep -Fq "qmd://$name/" && continue
+  qmd collection add "$hq_root/$pdir" --name "$name" --mask "**/*.{md,json}" >/dev/null 2>&1 || true
+  qmd context add "qmd://$name" "Project PRDs and documentation for $slug." >/dev/null 2>&1 || true
+done
+
+# 1c. Auto-register the personal knowledge collection if it isn't one yet.
+#     personal/knowledge is now read DIRECTLY (the reindex symlink mirror into
+#     core/knowledge is retired), so it needs its own qmd collection to stay
+#     searchable rather than riding in under a core collection.
+if [ -d "personal/knowledge" ] && \
+   [ -n "$(find "personal/knowledge" -name '*.md' -not -name 'INDEX.md' -print -quit 2>/dev/null)" ]; then
+  printf '%s\n' "$existing" | grep -Fq "qmd://personal-knowledge/" || {
+    qmd collection add "$hq_root/personal/knowledge" --name "personal-knowledge" --mask "**/*.md" >/dev/null 2>&1 || true
+    qmd context add "qmd://personal-knowledge" "Personal knowledge base (owner overlay)." >/dev/null 2>&1 || true
+  }
+fi
+
+# 2. Incremental lexical reindex (cheap; mtime-incremental inside qmd).
+qmd update >/dev/null 2>&1 || true
+
+# 3. Embeddings only on explicit request.
+if [ "$embed" -eq 1 ]; then
+  qmd embed >/dev/null 2>&1 || true
+fi
+
+exit 0

package/assets/scaffold/core/scripts/rebuild-all-indexes.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# rebuild-all-indexes.sh — fan out to every per-class INDEX.md regenerator.
+#
+# Stdout: JSON array of every INDEX.md path that was actually written
+# (parsed from per-script "wrote {path}" lines on stderr).
+# Stderr: passthrough log from each script, plus a final "all-indexes: ok"
+# or "all-indexes: errors" line.
+#
+# Used by handoff-post.sh / handoff-finalize.sh / /cleanup --reindex.
+# Exit 0 always (handoff must not fail because one INDEX class blew up).
+
+set -uo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+SCRIPTS=(
+  "rebuild-threads-index.sh"
+  "rebuild-orchestrator-index.sh"
+  "rebuild-companies-index.sh"
+  "rebuild-projects-index.sh"
+  "rebuild-company-knowledge-index.sh"
+  "rebuild-public-knowledge-index.sh"
+  "rebuild-workers-index.sh"
+  "rebuild-reports-index.sh"
+  "rebuild-social-drafts-index.sh"
+)
+
+TMP_STDERR=$(mktemp /tmp/rebuild-all-indexes.XXXXXX)
+trap 'rm -f "$TMP_STDERR"' EXIT
+
+ERRORS=0
+for s in "${SCRIPTS[@]}"; do
+  path="core/scripts/${s}"
+  if [[ ! -x "$path" ]] && [[ -f "$path" ]]; then
+    chmod +x "$path" 2>/dev/null || true
+  fi
+  if [[ ! -f "$path" ]]; then
+    echo "rebuild-all-indexes: skip ${s} (missing)" >&2
+    continue
+  fi
+  if ! bash "$path" 2>>"$TMP_STDERR"; then
+    echo "rebuild-all-indexes: ERROR in ${s}" >&2
+    ERRORS=$((ERRORS+1))
+  fi
+done
+
+# Replay each rebuild's stderr to our stderr (so callers see logs)
+cat "$TMP_STDERR" >&2
+
+# Parse "wrote {path}" lines to build the JSON output array
+paths_json=$(
+  grep -E 'wrote (workspace|companies|knowledge|workers|projects)' "$TMP_STDERR" 2>/dev/null \
+    | sed -E 's/.*wrote ([^ ]+).*/\1/' \
+    | sort -u \
+    | jq -R . \
+    | jq -s .
+)
+[[ -z "$paths_json" ]] && paths_json='[]'
+
+printf '%s\n' "$paths_json"
+
+if [[ "$ERRORS" -gt 0 ]]; then
+  echo "all-indexes: errors (${ERRORS})" >&2
+else
+  echo "all-indexes: ok" >&2
+fi
+
+exit 0

package/assets/scaffold/core/scripts/rebuild-companies-index.sh

@@ -0,0 +1,206 @@
+#!/usr/bin/env bash
+# rebuild-companies-index.sh — regenerate companies/{co}/INDEX.md for each company.
+#
+# Pure bash + jq. Zero Claude context. Iterates companies/*/ (skips _template,
+# dotfiles), summarizes top-level dirs, scans projects/*/prd.json and
+# workspace/orchestrator/{name}/state.json to populate the Projects table.
+#
+# Schema per knowledge/public/hq-core/index-md-spec.md (Company Root variant):
+#   - "# {Company Title}" + "> Auto-generated. Updated: YYYY-MM-DD"
+#   - Top-level Name | Description table (dirs and 1-line desc)
+#   - "## Projects" table (Project | Status | Description)
+#   - "## Deployments" placeholder (None for now — manifest-driven enrichment deferred)
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+DATE=$(date -u +%Y-%m-%d)
+
+# Title-case a slug: "example-co" -> "Example Co"
+titleize() {
+  echo "$1" | awk -F'-' '{
+    for (i=1; i<=NF; i++) {
+      $i = toupper(substr($i,1,1)) substr($i,2)
+    }
+    print
+  }' OFS=' '
+}
+
+describe_dir() {
+  local co="$1"
+  local d="$2"
+  local path="companies/${co}/${d}"
+  [[ -d "$path" ]] || return 0
+  case "$d" in
+    data)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} item(s)"
+      ;;
+    knowledge)
+      if [[ -e "${path}/.git" ]]; then
+        echo "Embedded git repo"
+      else
+        local n
+        n=$(find "$path" -mindepth 1 -maxdepth 1 -type d ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+        echo "Inline knowledge (${n} subdirs)"
+      fi
+      ;;
+    settings)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 -type d ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} integration(s)"
+      ;;
+    policies)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 -name '*.md' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} policy file(s)"
+      ;;
+    projects)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 -type d ! -name '_*' ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} project(s)"
+      ;;
+    workers)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 -type d ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} worker(s)"
+      ;;
+    repos)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 \( -type d -o -type l \) ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} repo link(s)"
+      ;;
+    registry)
+      local n
+      n=$(find "${path}/resources" -mindepth 1 -maxdepth 1 -name '*.yaml' 2>/dev/null | wc -l | tr -d ' ')
+      echo "Resource registry (${n} resource(s))"
+      ;;
+    scripts)
+      local n
+      n=$(find "$path" -mindepth 1 -maxdepth 1 -type f 2>/dev/null | wc -l | tr -d ' ')
+      echo "${n} script(s)"
+      ;;
+    *)
+      echo "—"
+      ;;
+  esac
+}
+
+# Resolve project status: orchestrator state.json wins, else story-pass fallback.
+project_status() {
+  local project="$1"
+  local prd="$2"
+  local state="workspace/orchestrator/${project}/state.json"
+  if [[ -f "$state" ]]; then
+    local raw
+    raw=$(jq -r '.status // "active"' "$state" 2>/dev/null || echo "active")
+    case "$raw" in
+      completed|complete) echo "complete" ;;
+      in_progress|active|started) echo "active" ;;
+      archived) echo "archived" ;;
+      *) echo "$raw" ;;
+    esac
+    return
+  fi
+  if [[ -f "$prd" ]]; then
+    local total passes
+    total=$(jq '[.userStories[]?] | length' "$prd" 2>/dev/null || echo 0)
+    passes=$(jq '[.userStories[]? | select(.passes==true)] | length' "$prd" 2>/dev/null || echo 0)
+    if [[ "$total" -gt 0 ]] && [[ "$total" == "$passes" ]]; then
+      echo "complete"
+      return
+    fi
+  fi
+  echo "active"
+}
+
+# Sanitize a string for Markdown table cells (single line, no pipes).
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+
+# Truncate to N chars.
+trunc() {
+  local s="$1"
+  local n="$2"
+  if [[ ${#s} -le $n ]]; then
+    printf '%s' "$s"
+  else
+    printf '%s…' "${s:0:$((n-1))}"
+  fi
+}
+
+write_company_index() {
+  local co="$1"
+  local out="companies/${co}/INDEX.md"
+  local title
+  title=$(titleize "$co")
+
+  # Header + top-level dir table
+  {
+    echo "# ${title}"
+    echo ""
+    echo "> Auto-generated. Updated: ${DATE}"
+    echo ""
+    echo "| Name | Description |"
+    echo "|------|-------------|"
+    # Stable order matching company template.
+    for d in data knowledge policies projects registry repos scripts settings workers; do
+      if [[ -d "companies/${co}/${d}" ]]; then
+        local desc
+        desc=$(describe_dir "$co" "$d")
+        printf '| `%s/` | %s |\n' "$d" "$(sanitize_cell "$desc")"
+      fi
+    done
+    echo ""
+    echo "## Projects"
+    echo ""
+
+    local proj_dir="companies/${co}/projects"
+    if [[ -d "$proj_dir" ]]; then
+      echo "| Project | Status | Description |"
+      echo "|---------|--------|-------------|"
+      # List immediate project subdirs, skip _archive and dotfiles.
+      while IFS= read -r p; do
+        local name
+        name=$(basename "$p")
+        [[ "$name" == _* ]] && continue
+        [[ "$name" == .* ]] && continue
+        local prd="${p}/prd.json"
+        local desc=""
+        if [[ -f "$prd" ]]; then
+          desc=$(jq -r '.description // ""' "$prd" 2>/dev/null || echo "")
+        fi
+        local status
+        status=$(project_status "$name" "$prd")
+        desc=$(sanitize_cell "$desc")
+        desc=$(trunc "$desc" 110)
+        [[ -z "$desc" ]] && desc="—"
+        printf '| `%s` | %s | %s |\n' "$name" "$status" "$desc"
+      done < <(find "$proj_dir" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+    else
+      echo "_No projects directory._"
+    fi
+
+    echo ""
+    echo "## Deployments"
+    echo ""
+    echo "_See \`companies/manifest.yaml\` for deployment targets._"
+  } > "$out"
+
+  echo "rebuild-companies-index: wrote ${out}" >&2
+}
+
+COUNT=0
+while IFS= read -r dir; do
+  co=$(basename "$dir")
+  [[ "$co" == _* ]] && continue
+  [[ "$co" == .* ]] && continue
+  write_company_index "$co"
+  COUNT=$((COUNT+1))
+done < <(find companies -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+echo "rebuild-companies-index: regenerated ${COUNT} company INDEX.md file(s)" >&2

package/assets/scaffold/core/scripts/rebuild-company-knowledge-index.sh

@@ -0,0 +1,127 @@
+#!/usr/bin/env bash
+# rebuild-company-knowledge-index.sh — regenerate companies/{co}/knowledge/INDEX.md.
+#
+# Pure bash + jq. One INDEX.md per company knowledge dir, at the top level only
+# (no descent into subdirs — embedded git repos manage their own internals).
+#
+# Description extraction:
+#   - .md files → first `#` heading (stripped)
+#   - .yaml files → `description:` field if present
+#   - .json files → `description` field if present
+#   - directories → "{N} item(s)"
+#
+# Most company knowledge dirs are embedded git repos (160000 gitlinks). The
+# generated INDEX.md lives inside the inner repo; HQ git won't track its
+# content directly, but it gets refreshed on every handoff.
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+DATE=$(date -u +%Y-%m-%d)
+
+titleize() {
+  echo "$1" | awk -F'-' '{
+    for (i=1; i<=NF; i++) { $i = toupper(substr($i,1,1)) substr($i,2) }
+    print
+  }' OFS=' '
+}
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1" n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+describe_item() {
+  local path="$1"
+  local name="$2"
+  if [[ -d "$path" ]]; then
+    local n
+    n=$(find "$path" -mindepth 1 -maxdepth 1 ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+    echo "${n} item(s)"
+    return
+  fi
+  case "$name" in
+    *.md)
+      local h
+      h=$(awk '/^# / { sub(/^# +/, ""); print; exit }' "$path" 2>/dev/null || true)
+      [[ -z "$h" ]] && h="$name"
+      echo "$h"
+      ;;
+    *.yaml|*.yml)
+      local d
+      d=$(awk -F: '/^description:/ { sub(/^description: */, ""); gsub(/^["\x27]|["\x27]$/, ""); print; exit }' "$path" 2>/dev/null || true)
+      [[ -z "$d" ]] && d="$name"
+      echo "$d"
+      ;;
+    *.json)
+      local d
+      d=$(jq -r '.description // .name // empty' "$path" 2>/dev/null || true)
+      [[ -z "$d" ]] && d="$name"
+      echo "$d"
+      ;;
+    *)
+      echo "$name"
+      ;;
+  esac
+}
+
+write_knowledge_index() {
+  local co="$1"
+  local kdir="companies/${co}/knowledge"
+  [[ -d "$kdir" ]] || return 0
+  local out="${kdir}/INDEX.md"
+  local title
+  title="$(titleize "$co") Knowledge"
+
+  {
+    echo "# ${title}"
+    echo ""
+    echo "> Auto-generated. Updated: ${DATE}"
+    echo ""
+    echo "| Name | Description |"
+    echo "|------|-------------|"
+
+    # Directories first (sorted), then files (sorted). Skip dotfiles, INDEX.md.
+    while IFS= read -r item; do
+      local name
+      name=$(basename "$item")
+      [[ "$name" == .* ]] && continue
+      [[ "$name" == "INDEX.md" ]] && continue
+      local desc
+      desc=$(describe_item "$item" "$name")
+      desc=$(sanitize_cell "$desc")
+      desc=$(trunc "$desc" 100)
+      [[ -z "$desc" ]] && desc="—"
+      if [[ -d "$item" ]]; then
+        printf '| `%s/` | %s |\n' "$name" "$desc"
+      else
+        printf '| `%s` | %s |\n' "$name" "$desc"
+      fi
+    done < <(
+      {
+        find -L "$kdir" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort
+        find -L "$kdir" -mindepth 1 -maxdepth 1 -type f 2>/dev/null | sort
+      }
+    )
+  } > "$out"
+
+  echo "rebuild-company-knowledge-index: wrote ${out}" >&2
+}
+
+COUNT=0
+while IFS= read -r dir; do
+  co=$(basename "$dir")
+  [[ "$co" == _* ]] && continue
+  [[ "$co" == .* ]] && continue
+  if [[ -d "companies/${co}/knowledge" ]]; then
+    write_knowledge_index "$co"
+    COUNT=$((COUNT+1))
+  fi
+done < <(find companies -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+echo "rebuild-company-knowledge-index: regenerated ${COUNT} knowledge INDEX.md file(s)" >&2

package/assets/scaffold/core/scripts/rebuild-orchestrator-index.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# rebuild-orchestrator-index.sh — regenerate workspace/orchestrator/INDEX.md.
+#
+# Pure bash + jq. Reads workspace/orchestrator/<project>/state.json files.
+# Tolerates two on-disk schemas: project-run state (run-project.sh — .project,
+# .prd_path, .progress, terminal on .status == "completed") and garden state
+# (/garden — .run_id, .scope, .findings_count, terminal on .phase == "complete").
+# Lists only non-terminal runs; _archive/ and _pipeline/ excluded.
+# Each state.json is parsed independently: a malformed file is reported to stderr
+# and skipped, never silently wiping the rest of the index
+# (see core/policies/hq-never-swallow-errors.md).
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+OUT="workspace/orchestrator/INDEX.md"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+mkdir -p workspace/orchestrator
+
+STATE_FILES=()
+while IFS= read -r line; do
+  STATE_FILES+=("$line")
+done < <(
+  find workspace/orchestrator -mindepth 2 -maxdepth 2 -name state.json 2>/dev/null \
+    | grep -v '/_archive/' \
+    | grep -v '/_pipeline/' \
+    || true
+)
+
+# Project column: .project (project-run) else .run_id (garden) else "-".
+# Company column: parsed from .prd_path (project-run) or .scope (garden); a bare
+#   slug or non-companies/ path yields "-". Progress: only project-run rows carry
+#   .progress; garden rows render "-". Terminal exclusion keys off BOTH
+#   .status == "completed"/"complete" (project-run + drift guard) AND
+#   .phase == "complete" (garden's real terminal marker).
+ROW_FILTER='
+  select((.status // "") != "completed" and (.status // "") != "complete")
+  | select((.phase // "") != "complete")
+  | [
+      (.project // .run_id // "-"),
+      (((.prd_path // .scope // "") | capture("companies/(?<co>[^/]+)/") | .co) // "-"),
+      (.status // "-"),
+      (if .progress
+       then ((.progress.completed // 0) | tostring) + "/" + ((.progress.total // 0) | tostring)
+       else "-" end),
+      (.updated_at // "-")
+    ] | @tsv
+'
+
+ERR_FILE=$(mktemp)
+trap 'rm -f "$ERR_FILE"' EXIT
+
+NL=$'\n'
+rows=""
+# Guard the array expansion: "${arr[@]}" on an empty array errors under `set -u`
+# on bash 3.2 (macOS). See core/policies/hq-bash-discipline.md rule 4.
+if [[ ${#STATE_FILES[@]} -gt 0 ]]; then
+  for sf in "${STATE_FILES[@]}"; do
+    row=""
+    if row=$(jq -r "$ROW_FILTER" "$sf" 2>"$ERR_FILE"); then
+      [ -n "$row" ] && rows="${rows:+$rows$NL}$row"
+    else
+      echo "rebuild-orchestrator-index: WARNING: skipped unparseable ${sf}: $(tr '\n' ' ' < "$ERR_FILE")" >&2
+    fi
+  done
+fi
+
+{
+  echo "# Orchestrator Projects"
+  echo ""
+  echo "Generated: ${TS}"
+  echo ""
+  echo "Active runs only. Archived runs in \`workspace/orchestrator/_archive/\`."
+  echo ""
+  echo "| Project | Company | Status | Progress | Last Updated |"
+  echo "|---------|---------|--------|----------|--------------|"
+  if [[ -n "$rows" ]]; then
+    printf "%s\n" "$rows" | awk -F'\t' 'NF>=5 { printf "| %s | %s | %s | %s | %s |\n", $1, $2, $3, $4, $5 }'
+  fi
+} > "$OUT"
+
+active=$(printf "%s" "$rows" | grep -c . || true)
+echo "rebuild-orchestrator-index: wrote ${OUT} (${active} active)" >&2

package/assets/scaffold/core/scripts/rebuild-projects-index.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# rebuild-projects-index.sh — regenerate the personal projects INDEX.md.
+#
+# Pure bash + jq. Reads personal/projects/*/prd.json for the Personal/HQ
+# Projects table and lists companies/*/projects directories for cross-reference.
+# Status comes from workspace/orchestrator/{name}/state.json (fallback:
+# passes-all → complete).
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+PROJECTS_DIR="personal/projects"
+OUT="${PROJECTS_DIR}/INDEX.md"
+DATE=$(date -u +%Y-%m-%d)
+
+[[ -d "$PROJECTS_DIR" ]] || { echo "rebuild-projects-index: ${PROJECTS_DIR}/ missing, skipping" >&2; exit 0; }
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1"
+  local n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+project_status() {
+  local project="$1"
+  local prd="$2"
+  local state="workspace/orchestrator/${project}/state.json"
+  if [[ -f "$state" ]]; then
+    local raw
+    raw=$(jq -r '.status // "active"' "$state" 2>/dev/null || echo "active")
+    case "$raw" in
+      completed|complete) echo "complete" ;;
+      in_progress|active|started) echo "active" ;;
+      archived) echo "archived" ;;
+      *) echo "$raw" ;;
+    esac
+    return
+  fi
+  if [[ -f "$prd" ]]; then
+    local total passes
+    total=$(jq '[.userStories[]?] | length' "$prd" 2>/dev/null || echo 0)
+    passes=$(jq '[.userStories[]? | select(.passes==true)] | length' "$prd" 2>/dev/null || echo 0)
+    if [[ "$total" -gt 0 ]] && [[ "$total" == "$passes" ]]; then
+      echo "complete"
+      return
+    fi
+  fi
+  echo "—"
+}
+
+{
+  echo "# Projects"
+  echo ""
+  echo "> Auto-generated. Updated: ${DATE}"
+  echo ""
+  echo "Personal/HQ projects only. Company-scoped projects live in \`companies/{co}/projects/\`."
+  echo ""
+  echo "## Company Project Directories"
+  echo ""
+  echo "| Company | Path |"
+  echo "|---------|------|"
+  while IFS= read -r dir; do
+    co=$(basename "$dir")
+    [[ "$co" == _* ]] && continue
+    [[ "$co" == .* ]] && continue
+    if [[ -d "companies/${co}/projects" ]]; then
+      printf '| %s | `companies/%s/projects/` |\n' "$co" "$co"
+    fi
+  done < <(find companies -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+  echo ""
+  echo "## Personal/HQ Projects"
+  echo ""
+  echo "Projects here are HQ infrastructure or cross-company tools."
+  echo ""
+  echo "| Project | Stories | Status | Description |"
+  echo "|---------|---------|--------|-------------|"
+
+  while IFS= read -r p; do
+    name=$(basename "$p")
+    [[ "$name" == _* ]] && continue
+    [[ "$name" == .* ]] && continue
+    prd="${p}/prd.json"
+    desc=""
+    stories="—"
+    if [[ -f "$prd" ]]; then
+      desc=$(jq -r '.description // ""' "$prd" 2>/dev/null || echo "")
+      stories=$(jq '[.userStories[]?] | length' "$prd" 2>/dev/null || echo 0)
+      [[ "$stories" == "0" ]] && stories="—"
+    fi
+    status=$(project_status "$name" "$prd")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 110)
+    [[ -z "$desc" ]] && desc="—"
+    printf '| `%s/` | %s | %s | %s |\n' "$name" "$stories" "$status" "$desc"
+  done < <(find "$PROJECTS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+} > "$OUT"
+
+count=$(find "$PROJECTS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+echo "rebuild-projects-index: wrote ${OUT} (${count} HQ project(s))" >&2