waypoint-skills 1.3.0

package/scripts/lib/common.sh

@@ -0,0 +1,215 @@
+#!/usr/bin/env bash
+# Waypoint Skills — shared install helpers
+set -euo pipefail
+
+WAYPOINT_REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+expand_path() {
+  local p="$1"
+  if [[ "$p" == "~/"* ]]; then
+    echo "${HOME}${p#\~}"
+  elif [[ "$p" == "~" ]]; then
+    echo "${HOME}"
+  else
+    echo "$p"
+  fi
+}
+
+log() { printf 'waypoint: %s\n' "$*"; }
+warn() { printf 'waypoint: WARN: %s\n' "$*" >&2; }
+die() { printf 'waypoint: ERROR: %s\n' "$*" >&2; exit 1; }
+
+platform_config() {
+  local platform="$1" key="$2"
+  jq -r --arg p "$platform" --arg k "$key" '.platforms[$p][$k] // empty' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+list_platforms() {
+  jq -r '.platforms | keys[]' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+detect_installed_platforms() {
+  local p detected=()
+  for p in $(list_platforms); do
+  local gb lb
+  gb="$(platform_config "$p" global_base)"
+  lb="$(platform_config "$p" local_base)"
+  if [[ -n "$gb" && "$gb" != "null" ]]; then
+    gb="$(expand_path "$gb")"
+    [[ -d "$gb" ]] && detected+=("$p") && continue
+  fi
+  if [[ -n "$lb" && "$lb" != "null" && -d "$(expand_path "$lb")" ]]; then
+    detected+=("$p")
+  fi
+  done
+  printf '%s\n' "${detected[@]}"
+}
+
+resolve_install_base() {
+  local platform="$1" scope="${2:-global}"
+  local base
+  case "$scope" in
+    global)
+      base="$(platform_config "$platform" global_base)"
+      [[ -n "$base" && "$base" != "null" ]] || die "Platform $platform has no global install path"
+      ;;
+    local)
+      base="$(platform_config "$platform" local_base)"
+      [[ -n "$base" && "$base" != "null" ]] || die "Platform $platform has no local install path"
+      if [[ "$base" != .* ]]; then
+        die "local base must be relative: $base"
+      fi
+      base="$(pwd)/${base#./}"
+      ;;
+    *)
+      die "Unknown scope: $scope (use global or local)"
+      ;;
+  esac
+  expand_path "$base"
+}
+
+link_or_copy() {
+  local src="$1" dest="$2" mode="${3:-symlink}"
+  mkdir -p "$(dirname "$dest")"
+  if [[ -e "$dest" || -L "$dest" ]]; then
+    local src_real dest_real
+    src_real="$(readlink -f "$src" 2>/dev/null || realpath "$src" 2>/dev/null || echo "$src")"
+    dest_real="$(readlink -f "$dest" 2>/dev/null || realpath "$dest" 2>/dev/null || echo "$dest")"
+    if [[ "$dest_real" == "$src_real" ]]; then
+      return 0
+    fi
+    warn "exists, skipping: $dest"
+    return 0
+  fi
+  case "$mode" in
+    symlink) ln -s "$src" "$dest" ;;
+    copy) cp -R "$src" "$dest" ;;
+    *) die "unknown mode: $mode" ;;
+  esac
+}
+
+install_file() {
+  local src="$1" dest="$2"
+  mkdir -p "$(dirname "$dest")"
+  if [[ -f "$dest" ]]; then
+    warn "exists, skipping: $dest"
+  else
+    cp "$src" "$dest"
+  fi
+}
+
+read_manifest_skills() {
+  jq -r '.packages.skills[]' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+read_manifest_agents() {
+  jq -r '.packages.agents[]' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+read_manifest_rules() {
+  jq -r '.packages.rules[]' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+read_manifest_hooks() {
+  jq -r '.packages.hook_templates[]' "${WAYPOINT_REPO_ROOT}/manifest.json"
+}
+
+install_platform() {
+  local platform="$1" scope="$2" mode="$3" repo_root="$4"
+  local base skills_dir agents_dir rules_dir hooks_dir rules_ext
+
+  base="$(resolve_install_base "$platform" "$scope")"
+  skills_dir="$(platform_config "$platform" skills)"
+  agents_dir="$(platform_config "$platform" agents)"
+  rules_dir="$(platform_config "$platform" rules)"
+  hooks_dir="$(platform_config "$platform" hook_templates)"
+  rules_ext="$(platform_config "$platform" rules_ext)"
+  [[ -z "$rules_ext" || "$rules_ext" == "null" ]] && rules_ext=".mdc"
+
+  local label
+  label="$(platform_config "$platform" label)"
+  log "install platform=$platform ($label) scope=$scope base=$base mode=$mode"
+
+  if [[ -n "$skills_dir" && "$skills_dir" != "null" ]]; then
+    mkdir -p "${base}/${skills_dir}"
+    for skill in $(read_manifest_skills); do
+      link_or_copy "${repo_root}/packages/skills/${skill}" "${base}/${skills_dir}/${skill}" "$mode"
+      log "  skill: ${skill}"
+    done
+  fi
+
+  if [[ -n "$agents_dir" && "$agents_dir" != "null" ]]; then
+    mkdir -p "${base}/${agents_dir}"
+    for agent in $(read_manifest_agents); do
+      link_or_copy "${repo_root}/packages/agents/${agent}.md" "${base}/${agents_dir}/${agent}.md" "$mode"
+      log "  agent: ${agent}"
+    done
+  fi
+
+  if [[ -n "$rules_dir" && "$rules_dir" != "null" ]]; then
+    mkdir -p "${base}/${rules_dir}"
+    for rule in $(read_manifest_rules); do
+      local src_ext=".mdc" dest_ext="$rules_ext"
+      if [[ "$platform" == "antigravity" ]]; then
+        install_file "${repo_root}/packages/rules/${rule}.mdc" "${base}/${rules_dir}/${rule}${dest_ext}"
+      else
+        link_or_copy "${repo_root}/packages/rules/${rule}${src_ext}" "${base}/${rules_dir}/${rule}${dest_ext}" "$mode"
+      fi
+      log "  rule: ${rule}"
+    done
+  fi
+
+  if [[ -n "$hooks_dir" && "$hooks_dir" != "null" ]]; then
+    mkdir -p "${base}/${hooks_dir}"
+    for hook in $(read_manifest_hooks); do
+      install_file "${repo_root}/packages/hooks/templates/${hook}" "${base}/${hooks_dir}/${hook}"
+      chmod +x "${base}/${hooks_dir}/${hook}" 2>/dev/null || true
+      log "  hook: ${hook}"
+    done
+  fi
+
+  echo "$base"
+}
+
+uninstall_platform() {
+  local platform="$1" scope="$2"
+  local base skills_dir agents_dir rules_dir hooks_dir rules_ext
+
+  base="$(resolve_install_base "$platform" "$scope")"
+  skills_dir="$(platform_config "$platform" skills)"
+  agents_dir="$(platform_config "$platform" agents)"
+  rules_dir="$(platform_config "$platform" rules)"
+  hooks_dir="$(platform_config "$platform" hook_templates)"
+  rules_ext="$(platform_config "$platform" rules_ext)"
+  [[ -z "$rules_ext" || "$rules_ext" == "null" ]] && rules_ext=".mdc"
+
+  log "uninstall platform=$platform scope=$scope base=$base"
+
+  remove_target() {
+    local path="$1"
+    if [[ -L "$path" ]]; then
+      rm -f "$path"
+      log "  removed: $path"
+    elif [[ -e "$path" ]]; then
+      warn "  not a symlink, manual remove: $path"
+    fi
+  }
+
+  if [[ -n "$skills_dir" && "$skills_dir" != "null" ]]; then
+    for skill in $(read_manifest_skills); do
+      remove_target "${base}/${skills_dir}/${skill}"
+    done
+  fi
+
+  if [[ -n "$agents_dir" && "$agents_dir" != "null" ]]; then
+    for agent in $(read_manifest_agents); do
+      remove_target "${base}/${agents_dir}/${agent}.md"
+    done
+  fi
+
+  if [[ -n "$rules_dir" && "$rules_dir" != "null" ]]; then
+    for rule in $(read_manifest_rules); do
+      remove_target "${base}/${rules_dir}/${rule}${rules_ext}"
+    done
+  fi
+}

package/scripts/sync-skills.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Keep skills/ in sync with packages/skills/ for npx skills add discovery.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+mkdir -p "${ROOT}/skills"
+
+for dir in "${ROOT}/packages/skills"/*; do
+  [[ -d "$dir" ]] || continue
+  name="$(basename "$dir")"
+  target="../packages/skills/${name}"
+  link="${ROOT}/skills/${name}"
+  if [[ -L "$link" ]]; then
+    rm -f "$link"
+  elif [[ -e "$link" ]]; then
+    echo "skills/sync: skip non-symlink ${link}" >&2
+    continue
+  fi
+  ln -sf "$target" "$link"
+  echo "skills/sync: ${name}"
+done

package/scripts/uninstall.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Remove Waypoint Skills symlinks from AI assistant config.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/common.sh
+source "${SCRIPT_DIR}/lib/common.sh"
+
+SCOPE="global"
+PLATFORM="auto"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --platform) PLATFORM="$2"; shift 2 ;;
+    --global) SCOPE="global"; shift ;;
+    --local) SCOPE="local"; shift ;;
+    -h|--help)
+      echo "Usage: uninstall.sh [--platform NAME|auto|all] [--global|--local]"
+      exit 0
+      ;;
+    *) die "Unknown option: $1" ;;
+  esac
+done
+
+command -v jq >/dev/null 2>&1 || die "jq required"
+
+case "$PLATFORM" in
+  auto) PLATFORMS="$(detect_installed_platforms)" ;;
+  all) PLATFORMS="$(list_platforms)" ;;
+  *) PLATFORMS="$PLATFORM" ;;
+esac
+
+while IFS= read -r p; do
+  [[ -z "$p" ]] && continue
+  uninstall_platform "$p" "$SCOPE" || warn "skip $p (not installed?)"
+done <<< "$PLATFORMS"
+
+log "done"

package/scripts/waypoint

@@ -0,0 +1,281 @@
+#!/usr/bin/env bash
+# waypoint — Waypoint Skills CLI (agent-callable)
+#
+# Usage:
+#   waypoint install [--platform auto|NAME] [--global|--local]
+#   waypoint uninstall [--platform auto] [--global|--local]
+#   waypoint status [--platform cursor] [--global|--local]
+#   waypoint doctor
+#   waypoint detect
+#   waypoint bootstrap [--mid ID] [--project-root PATH]
+#   waypoint instances
+#   waypoint instance [--mid ID]
+#
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+# shellcheck source=lib/common.sh
+source "${SCRIPT_DIR}/lib/common.sh"
+WAYPOINT_REPO_ROOT="$REPO_ROOT"
+
+cmd="${1:-help}"
+shift || true
+
+case "$cmd" in
+  install)
+    exec "${SCRIPT_DIR}/install.sh" "$@"
+    ;;
+  uninstall)
+    exec "${SCRIPT_DIR}/uninstall.sh" "$@"
+    ;;
+  detect)
+    exec "${SCRIPT_DIR}/detect-platform.sh" "$@"
+    ;;
+  status)
+    SCOPE="global"
+    PLATFORM="cursor"
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --global) SCOPE="global"; shift ;;
+        --local) SCOPE="local"; shift ;;
+        --platform) PLATFORM="$2"; shift 2 ;;
+        *) break ;;
+      esac
+    done
+    BASE="$(resolve_install_base "$PLATFORM" "$SCOPE")"
+    skills_dir="$(platform_config "$PLATFORM" skills)"
+    agents_dir="$(platform_config "$PLATFORM" agents)"
+    rules_dir="$(platform_config "$PLATFORM" rules)"
+    rules_ext="$(platform_config "$PLATFORM" rules_ext)"
+    [[ -z "$rules_ext" || "$rules_ext" == "null" ]] && rules_ext=".mdc"
+    echo "Waypoint Skills status (platform=$PLATFORM scope=$SCOPE)"
+    echo "base: $BASE"
+    echo ""
+    printf "%-10s %-8s %s\n" "TYPE" "OK?" "PATH"
+    if [[ -n "$skills_dir" && "$skills_dir" != "null" ]]; then
+      for skill in $(read_manifest_skills); do
+        p="${BASE}/${skills_dir}/${skill}/SKILL.md"
+        [[ -f "$p" ]] && ok="yes" || ok="no"
+        printf "%-10s %-8s %s\n" "skill" "$ok" "$p"
+      done
+    fi
+    if [[ -n "$agents_dir" && "$agents_dir" != "null" ]]; then
+      for agent in $(read_manifest_agents); do
+        p="${BASE}/${agents_dir}/${agent}.md"
+        [[ -f "$p" ]] && ok="yes" || ok="no"
+        printf "%-10s %-8s %s\n" "agent" "$ok" "$p"
+      done
+    fi
+    if [[ -n "$rules_dir" && "$rules_dir" != "null" ]]; then
+      for rule in $(read_manifest_rules); do
+        p="${BASE}/${rules_dir}/${rule}${rules_ext}"
+        [[ -f "$p" ]] && ok="yes" || ok="no"
+        printf "%-10s %-8s %s\n" "rule" "$ok" "$p"
+      done
+    fi
+    ;;
+  doctor)
+    echo "Waypoint Skills doctor"
+    command -v jq >/dev/null 2>&1 && echo "jq: ok" || echo "jq: MISSING (required for install)"
+    command -v git >/dev/null 2>&1 && echo "git: ok" || echo "git: MISSING (required for worktrees)"
+    [[ -f "${REPO_ROOT}/manifest.json" ]] && echo "manifest: ok" || echo "manifest: MISSING"
+  echo ""
+  echo "Platforms:"
+    for p in $(list_platforms); do
+      gb="$(platform_config "$p" global_base)"
+      found="no"
+      [[ -n "$gb" && "$gb" != "null" && -d "$(expand_path "$gb")" ]] && found="yes"
+      echo "  $(platform_config "$p" label) ($p): $found"
+    done
+    ;;
+  bootstrap|mission-bootstrap)
+    MID="default"
+    PROJECT_ROOT="$(pwd)"
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --mid) MID="$2"; shift 2 ;;
+        --project-root) PROJECT_ROOT="$2"; shift 2 ;;
+        *) die "unknown arg: $1" ;;
+      esac
+    done
+    if [[ ! "$MID" =~ ^[a-z0-9][a-z0-9-]*$ ]]; then
+      die "invalid mid: $MID"
+    fi
+    INST=".wp/instances/${MID}"
+    mkdir -p .wp/{agents,skills,hooks,instances/${MID}/handoffs}
+    grep -qxF '.wp/' .gitignore 2>/dev/null || echo '.wp/' >> .gitignore
+
+    ORCH_SRC="${REPO_ROOT}/packages/agents/orchestrator.md"
+    cp -n "$ORCH_SRC" .wp/agents/orchestrator.md 2>/dev/null || true
+    cp -n "${REPO_ROOT}/packages/skills/wp/caveman-wire.md" .wp/skills/ 2>/dev/null || true
+    cp -n "${REPO_ROOT}/packages/hooks/templates/"*.sh .wp/hooks/ 2>/dev/null || true
+    chmod +x .wp/hooks/*.sh 2>/dev/null || true
+
+    ISO="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+    [[ -f .wp/registry.md ]] || cat >.wp/registry.md <<EOF
+# Instance Registry
+
+| mid | objective | phase | pause | worktree_root | updated |
+|-----|-----------|-------|-------|---------------|---------|
+EOF
+
+    if [[ ! -f "${INST}/instance_meta.md" ]]; then
+      WORKTREE_ROOT="$PROJECT_ROOT"
+      if [[ "$MID" != "default" ]] && [[ -x .wp/hooks/mission-worktree-bootstrap.sh ]]; then
+        .wp/hooks/mission-worktree-bootstrap.sh \
+          --project-root "$PROJECT_ROOT" \
+          --mid "$MID" \
+          --meta-out "${INST}/instance_meta.md" || true
+        if [[ -f "${INST}/instance_meta.md" ]]; then
+          WORKTREE_ROOT="$(grep '^\*\*worktree_root:\*\*' "${INST}/instance_meta.md" | sed 's/.*\*\* //')"
+        fi
+      else
+        cat >"${INST}/instance_meta.md" <<EOF
+# Instance Meta
+
+**mid:** ${MID}
+**framework_version:** 1.3.0
+**project_root:** ${PROJECT_ROOT}
+**worktree_root:** ${PROJECT_ROOT}
+**branch:** —
+**worktree_parent:** —
+**provisioned_at:** ${ISO}
+EOF
+      fi
+      for tmpl in mission_profile validation_contract active_plan mission_control; do
+        [[ -f "${INST}/${tmpl}.md" ]] && continue
+        case "$tmpl" in
+          mission_profile) cat >"${INST}/${tmpl}.md" <<EOF
+# Instance Profile
+
+**mid:** ${MID}
+**Objective:**
+
+**Success definition:**
+
+## In scope
+
+-
+
+## Out of scope
+
+-
+
+## Technical boundaries
+- **Allowed paths:**
+- **Forbidden paths:**
+
+## Constraints
+
+- **Implementation:** ponytail full
+- **Inter-agent comms:** caveman wire
+- **Code root:** ${WORKTREE_ROOT}
+
+## Open questions
+
+-
+EOF
+            ;;
+          validation_contract) cat >"${INST}/${tmpl}.md" <<EOF
+# Validation Contract
+
+**mid:** ${MID}
+**Status:** draft
+**Approved:** no
+
+## Assertions
+
+| ID | Behavior | Verification method |
+|----|----------|---------------------|
+| A-01 | | |
+
+## Approval
+
+Set \`Approved: yes\` after user confirms contract.
+EOF
+            ;;
+          active_plan) cat >"${INST}/${tmpl}.md" <<EOF
+# Active Plan
+
+**mid:** ${MID}
+**Status:** current task — | blocked — no
+
+## Tasks
+
+## Plan Changelog
+
+| Date | Change | Reason |
+|------|--------|--------|
+EOF
+            ;;
+          mission_control) cat >"${INST}/${tmpl}.md" <<EOF
+# Instance Control
+
+**framework_version:** 1.3.0
+**mid:** ${MID}
+**bootstrapped_at:** ${ISO}
+**worktree_root:** ${WORKTREE_ROOT}
+**Pause:** inactive
+
+## Dashboard
+
+| Metric | Value |
+|--------|-------|
+| Tasks complete | 0 / 0 |
+| Current task | — |
+| Blocked | no |
+
+## Ledger
+EOF
+            ;;
+        esac
+      done
+      log "instance bootstrapped: ${INST}"
+    else
+      log "instance exists: ${INST}"
+    fi
+    echo "🚀 Waypoint Skills v1.3. Instance \`${MID}\` at \`${INST}/\`."
+    ;;
+  instances|mission-list)
+    REG=".wp/registry.md"
+    [[ -f "$REG" ]] && cat "$REG" || echo "No registry. Run: waypoint bootstrap"
+    ;;
+  instance|mission-status)
+    MID=""
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --mid) MID="$2"; shift 2 ;;
+        *) die "unknown arg: $1" ;;
+      esac
+    done
+    if [[ -z "$MID" ]]; then
+      "$0" instances
+      exit 0
+    fi
+    INST=".wp/instances/${MID}"
+    for f in instance_meta.md mission_profile.md validation_contract.md active_plan.md mission_control.md; do
+      echo "=== $f ==="
+      [[ -f "${INST}/${f}" ]] && cat "${INST}/${f}" || echo "(missing)"
+      echo ""
+    done
+    ;;
+  help|--help|-h)
+    cat <<'EOF'
+Waypoint Skills CLI
+
+  waypoint install [--platform auto] [--global|--local]
+  waypoint uninstall [--platform auto] [--global|--local]
+  waypoint detect
+  waypoint doctor
+  waypoint status [--platform NAME] [--global|--local]
+  waypoint bootstrap [--mid ID]
+  waypoint instances
+  waypoint instance --mid ID
+EOF
+    ;;
+  *)
+    die "unknown command: $cmd (try: waypoint help)"
+    ;;
+esac