ver-0.7

2026-06-19 21:12:14 -05:00
parent a860819bfb
commit 2fc3a0a80b
26 changed files with 1559 additions and 89 deletions
@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# bootstrap.sh — stand up (or repair) an ECHO vault deterministically.
+#
+# Idempotent and additive: every write is probe-before-write and NEVER overwrites an
+# existing file. The marker (_agent/echo-vault.md) is written LAST, so the vault is
+# only flagged "set up" once every piece is in place. Safe to re-run any time — that
+# is also the "repair" path (it fills in only what is missing).
+#
+# All scaffold is resolved relative to THIS script's location, so it works regardless
+# of the caller's CWD (fixes the old `@scaffold/...` relative-path assumption).
+#
+# Usage:
+#   bootstrap.sh [--dry-run]
+#
+# Env: ECHO_BASE, ECHO_KEY (passed through to echo.sh), ECHO_TODAY (YYYY-MM-DD for {{DATE}}).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+SCAFFOLD="$SKILL_DIR/scaffold"
+ECHO="$SCRIPT_DIR/echo.sh"
+TODAY="${ECHO_TODAY:-$(date +%Y-%m-%d)}"
+DRY=0
+[ "${1:-}" = "--dry-run" ] || [ "${1:-}" = "-n" ] && DRY=1
+
+[ -d "$SCAFFOLD" ] || { echo "bootstrap: scaffold not found at $SCAFFOLD" >&2; exit 1; }
+[ -x "$ECHO" ] || chmod +x "$ECHO" 2>/dev/null || true
+
+say()  { echo "bootstrap: $*"; }
+exists() { ECHO_VERIFY=0 "$ECHO" get "$1" >/dev/null 2>&1; }   # 0 = present(200), nonzero = absent/404
+
+# seed VAULT_PATH from LOCAL_FILE (with {{DATE}} substitution), only if absent
+seed() {
+  local vpath="$1" local_file="$2"
+  if exists "$vpath"; then say "skip (exists)  $vpath"; return 0; fi
+  if [ "$DRY" = "1" ]; then say "would seed     $vpath  <- ${local_file#$SKILL_DIR/}"; return 0; fi
+  sed "s/{{DATE}}/$TODAY/g" "$local_file" | ECHO_VERIFY=1 "$ECHO" put "$vpath" - >/dev/null
+  say "seeded         $vpath"
+}
+
+# write a one-line leaf README only if absent
+leaf_readme() {
+  local dir="$1" name="${1##*/}"
+  local vpath="$dir/README.md"
+  if exists "$vpath"; then return 0; fi
+  if [ "$DRY" = "1" ]; then say "would readme   $vpath"; return 0; fi
+  printf '# %s\n\nMemory vault folder. See the echo-memory plugin for conventions.\n' "$name" \
+    | ECHO_VERIFY=0 "$ECHO" put "$vpath" - >/dev/null
+  say "readme         $vpath"
+}
+
+# ---- Pre-flight: is the vault already bootstrapped? --------------------------
+if exists "_agent/echo-vault.md"; then
+  ver="$("$ECHO" get _agent/echo-vault.md 2>/dev/null | sed -n 's/^schema_version:[[:space:]]*//p' | head -1)"
+  say "marker present (schema_version=${ver:-unknown}). Running repair pass (fills only missing files)."
+  CUR_SCHEMA=2
+  if [ -n "$ver" ] && [ "$ver" -lt "$CUR_SCHEMA" ] 2>/dev/null; then
+    say "NOTE: schema_version $ver < $CUR_SCHEMA — run migrate.sh before relying on the vault."
+  fi
+fi
+
+# ---- 1. Folder tree (leaf READMEs guarantee non-empty dirs) ------------------
+LEAVES=(
+  inbox/captures inbox/imports inbox/processing-log
+  journal/daily journal/weekly journal/monthly journal/quarterly journal/annual journal/templates
+  projects/active projects/incubating projects/on-hold projects/archived
+  areas/business areas/personal areas/learning areas/systems
+  resources/concepts resources/references resources/people resources/companies resources/meetings
+  decisions/by-date
+  _agent/context _agent/memory/working _agent/memory/episodic _agent/memory/semantic
+  _agent/sessions _agent/health _agent/templates _agent/heartbeat
+  _agent/skills/active _agent/skills/archived _agent/locks
+)
+for d in "${LEAVES[@]}"; do leaf_readme "$d"; done
+
+# ---- 2. Templates (mirror scaffold/templates/ 1:1 into the vault) ------------
+if [ -d "$SCAFFOLD/templates" ]; then
+  while IFS= read -r f; do
+    rel="${f#$SCAFFOLD/templates/}"
+    seed "$rel" "$f"
+  done < <(find "$SCAFFOLD/templates" -type f -name '*.md')
+fi
+
+# ---- 3. Anchor seeds (only if absent — never fabricate facts) ----------------
+seed "_agent/memory/semantic/operator-preferences.md" "$SCAFFOLD/anchors/operator-preferences.seed.md"
+seed "_agent/context/current-context.md"               "$SCAFFOLD/anchors/current-context.seed.md"
+seed "inbox/captures/inbox.md"                          "$SCAFFOLD/anchors/inbox.seed.md"
+
+# ---- 4. Vault README (human signpost) ----------------------------------------
+seed "README.md" "$SCAFFOLD/README.vault.md"
+
+# ---- 5. Marker (write LAST) --------------------------------------------------
+seed "_agent/echo-vault.md" "$SCAFFOLD/echo-vault.md"
+
+say "done (${DRY:+DRY-RUN }$TODAY)."
+say "Next: create today's daily note + a bootstrap session log + heartbeat (see SKILL.md First-run trace)."