@drafthq/draft 2.7.0

package/integrations/gemini/.gemini.md

@@ -0,0 +1,26 @@
+# Draft Methodology - Global Instructions
+
+You are equipped with the **Draft Methodology** for Context-Driven Development.
+
+**Core Principles:**
+- **Measure twice, code once.**
+- **Context -> Spec & Plan -> Implement.**
+- Never implement without a plan.
+- Never plan without a specification.
+- Never specify without codebase context.
+
+**Skill Locations:**
+The authoritative Draft implementation skills are located at:
+`~/.gemini/antigravity/skills/draft/skills`
+
+**Automatic Workflow:**
+1. If the current directory does NOT have a `draft/` folder, recommend running `draft-init` (alias) or `@draft init`.
+2. Follow the protocols in `~/.gemini/antigravity/skills/draft/skills/<command>/SKILL.md` for all `@draft` commands.
+3. Use the standard markers: `[ ]` (Pending), `[~]` (In Progress), `[x]` (Completed), `[!]` (Blocked).
+
+**Project Context:**
+Always prioritize information in:
+- `draft/.ai-context.md` (Dense AI context)
+- `draft/architecture.md` (Human-readable guide)
+- `draft/product.md` (Vision)
+- `draft/tech-stack.md` (Constraints)

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@drafthq/draft",
+  "version": "2.7.0",
+  "description": "Context-Driven Development for AI coding agents — install Draft into Claude Code, Cursor, Codex, or opencode.",
+  "bin": {
+    "draft": "cli/bin/draft.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "cli/",
+    "skills/",
+    "core/",
+    ".claude-plugin/",
+    "integrations/",
+    "bin/",
+    "scripts/tools/",
+    "scripts/fetch-memory-engine.sh",
+    "scripts/lib.sh",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "bash tests/test-cli.sh",
+    "prepublishOnly": "bash scripts/build-integrations.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drafthq/draft.git"
+  },
+  "homepage": "https://github.com/drafthq/draft",
+  "bugs": {
+    "url": "https://github.com/drafthq/draft/issues"
+  },
+  "license": "MIT",
+  "author": "mayurpise",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "codex",
+    "opencode",
+    "ai",
+    "agents",
+    "context-driven-development",
+    "draft",
+    "spec-driven-development"
+  ]
+}

package/scripts/fetch-memory-engine.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# fetch-memory-engine.sh — download and verify the Draft knowledge-graph engine.
+#
+# The engine is the codebase-memory-mcp single static binary. This script fetches
+# the release archive for the host OS/arch from GitHub Releases, verifies its
+# SHA-256 against the published checksums.txt, extracts it, and installs the
+# binary to the Draft-managed location (~/.cache/draft/bin/codebase-memory-mcp),
+# which scripts/tools/_lib.sh:find_memory_bin resolves.
+#
+# Pinned by default for reproducibility; override with CMM_VERSION (a tag, e.g.
+# "v0.7.0", or "latest").
+#
+# Usage:
+#   scripts/fetch-memory-engine.sh [--dest DIR] [--force]
+#
+# Env:
+#   CMM_VERSION        Release tag to fetch (default: pinned DEFAULT_VERSION).
+#   CMM_DOWNLOAD_URL   Override the release base URL (testing).
+#
+# Exit codes: 0 installed/already-present, 1 invocation error, 2 fetch/verify failure.
+set -euo pipefail
+
+REPO="DeusData/codebase-memory-mcp"
+DEFAULT_VERSION="v0.7.0"   # pinned; bump deliberately
+VERSION="${CMM_VERSION:-$DEFAULT_VERSION}"
+DEST="$HOME/.cache/draft/bin"
+FORCE=0
+
+usage() { sed -n '2,22p' "$0" | sed 's/^# \{0,1\}//'; }
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dest) DEST="$2"; shift 2 ;;
+    --force) FORCE=1; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown flag: $1" >&2; usage >&2; exit 1 ;;
+  esac
+done
+
+BIN_PATH="$DEST/codebase-memory-mcp"
+if [[ -x "$BIN_PATH" && $FORCE -eq 0 ]]; then
+  echo "codebase-memory-mcp already installed at $BIN_PATH ($("$BIN_PATH" --version 2>/dev/null || echo unknown))"
+  exit 0
+fi
+
+# --- Detect OS / arch (mirrors the engine's own install.sh naming) ---
+case "$(uname -s)" in
+  Darwin) OS="darwin" ;;
+  Linux)  OS="linux" ;;
+  *) echo "error: unsupported OS: $(uname -s)" >&2; exit 2 ;;
+esac
+case "$(uname -m)" in
+  x86_64|amd64) ARCH="amd64" ;;
+  arm64|aarch64) ARCH="arm64" ;;
+  *) echo "error: unsupported arch: $(uname -m)" >&2; exit 2 ;;
+esac
+
+# Linux ships a fully-static "-portable" build; macOS has no such variant.
+PORTABLE=""
+[[ "$OS" = "linux" ]] && PORTABLE="-portable"
+ARCHIVE="codebase-memory-mcp-${OS}-${ARCH}${PORTABLE}.tar.gz"
+
+if [[ -n "${CMM_DOWNLOAD_URL:-}" ]]; then
+  BASE="$CMM_DOWNLOAD_URL"
+elif [[ "$VERSION" = "latest" ]]; then
+  BASE="https://github.com/${REPO}/releases/latest/download"
+else
+  BASE="https://github.com/${REPO}/releases/download/${VERSION}"
+fi
+
+case "$BASE" in https://*) ;; *) echo "error: refusing non-HTTPS URL: $BASE" >&2; exit 2 ;; esac
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+echo "Fetching ${ARCHIVE} (${VERSION})..."
+if ! curl -fSL --max-time 300 -o "$TMP/$ARCHIVE" "$BASE/$ARCHIVE"; then
+  echo "error: download failed: $BASE/$ARCHIVE" >&2
+  exit 2
+fi
+
+# --- Verify checksum (best-effort: hard-fail only if the archive is listed) ---
+if curl -fsSL --max-time 60 -o "$TMP/checksums.txt" "$BASE/checksums.txt" 2>/dev/null; then
+  expected="$(grep "  $ARCHIVE\$" "$TMP/checksums.txt" 2>/dev/null | awk '{print $1}' | head -1 || true)"
+  if [[ -n "$expected" ]]; then
+    if command -v sha256sum >/dev/null 2>&1; then
+      actual="$(sha256sum "$TMP/$ARCHIVE" | awk '{print $1}')"
+    else
+      actual="$(shasum -a 256 "$TMP/$ARCHIVE" | awk '{print $1}')"
+    fi
+    if [[ "$expected" != "$actual" ]]; then
+      echo "error: checksum mismatch for $ARCHIVE (expected $expected, got $actual)" >&2
+      exit 2
+    fi
+    echo "  checksum OK"
+  else
+    echo "  warning: $ARCHIVE not found in checksums.txt — skipping verification" >&2
+  fi
+else
+  echo "  warning: checksums.txt unavailable — skipping verification" >&2
+fi
+
+# --- Extract and install ---
+tar -xzf "$TMP/$ARCHIVE" -C "$TMP"
+SRC="$(find "$TMP" -maxdepth 2 -type f -name codebase-memory-mcp | head -1)"
+if [[ -z "$SRC" ]]; then
+  echo "error: codebase-memory-mcp binary not found in archive" >&2
+  exit 2
+fi
+
+mkdir -p "$DEST"
+install -m 0755 "$SRC" "$BIN_PATH" 2>/dev/null || { cp -f "$SRC" "$BIN_PATH"; chmod +x "$BIN_PATH"; }
+
+echo "Installed: $("$BIN_PATH" --version 2>/dev/null || echo "$BIN_PATH")"
+echo "  -> $BIN_PATH"
+exit 0

package/scripts/lib.sh

@@ -0,0 +1,256 @@
+#!/usr/bin/env bash
+#
+# Shared validation library for Draft skill files.
+#
+# Sourced by test suites. Defines constants and validation functions
+# but does not execute anything when sourced.
+#
+# Usage:
+#   source scripts/lib.sh
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+SKILLS_DIR="$ROOT_DIR/skills"
+CORE_DIR="$ROOT_DIR/core"
+TOOLS_DIR="$ROOT_DIR/scripts/tools"
+
+# ─────────────────────────────────────────────────────────
+# Skill ordering (canonical order for all references)
+# ─────────────────────────────────────────────────────────
+
+SKILL_ORDER=(
+    draft
+    init
+    index
+    graph
+    new-track
+    decompose
+    implement
+    coverage
+    deploy-checklist
+    bughunt
+    review
+    upload
+    plan
+    ops
+    docs
+    discover
+    jira
+    integrations
+    quick-review
+    deep-review
+    testing-strategy
+    learn
+    adr
+    debug
+    standup
+    tech-debt
+    incident-response
+    documentation
+    status
+    revert
+    change
+    tour
+    impact
+    assist-review
+)
+
+# ─────────────────────────────────────────────────────────
+# Core reference files (inlined by Claude plugin at runtime)
+# ─────────────────────────────────────────────────────────
+
+CORE_FILES=(
+    # Methodology
+    "methodology.md"
+    "knowledge-base.md"
+    # Shared procedures
+    "shared/draft-context-loading.md"
+    "shared/git-report-metadata.md"
+    "shared/pattern-learning.md"
+    "shared/condensation.md"
+    "shared/cross-skill-dispatch.md"
+    "shared/jira-sync.md"
+    "shared/graph-query.md"
+    "shared/parallel-analysis.md"
+    # Foundations additions (Phase 0)
+    "shared/context-verify.md"
+    "shared/discovery-schema.md"
+    "shared/graph-usage-report.md"
+    "shared/parallel-fanout.md"
+    "shared/red-flags.md"
+    "shared/template-contract.md"
+    "shared/template-hygiene.md"
+    "shared/tool-resolver.md"
+    "shared/verification-gates.md"
+    # Templates
+    "templates/guardrails.md"
+    "templates/intake-questions.md"
+    "templates/ai-context.md"
+    "templates/ai-profile.md"
+    "templates/architecture.md"
+    "templates/track-architecture.md"
+    "templates/jira.md"
+    "templates/product.md"
+    "templates/tech-stack.md"
+    "templates/workflow.md"
+    "templates/spec.md"
+    "templates/plan.md"
+    "templates/metadata.json"
+    # Foundations additions
+    "templates/ai-context-export.md"
+    "templates/session-summary.md"
+    # Index templates (monorepo)
+    "templates/service-index.md"
+    "templates/dependency-graph.md"
+    "templates/tech-matrix.md"
+    "templates/root-product.md"
+    "templates/root-architecture.md"
+    "templates/root-tech-stack.md"
+    "templates/rca.md"
+    # Foundations / internal design templates (added during quality tooling work)
+    "templates/CHANGELOG.md"
+    "templates/discovery.md"
+    "templates/hld.md"
+    "templates/lld.md"
+    # Agents
+    "agents/architect.md"
+    "agents/debugger.md"
+    "agents/planner.md"
+    "agents/rca.md"
+    "agents/reviewer.md"
+    "agents/writer.md"
+    "agents/ops.md"
+    # VCS abstraction
+    "shared/vcs-commands.md"
+    # Guardrails system (Foundations)
+    "guardrails.md"
+    "guardrails/README.md"
+    "guardrails/security.md"
+    "guardrails/code-quality.md"
+    "guardrails/design-norms.md"
+    "guardrails/review-checks.md"
+    "guardrails/secure-patterns.md"
+    "guardrails/dependency-triage.md"
+    "guardrails/language-standards.md"
+)
+
+# ─────────────────────────────────────────────────────────
+# Deterministic tool scripts (under scripts/tools/)
+# Skills invoke these for mechanical work — git metadata,
+# file classification, TODO aging, hotspot ranking, etc.
+# ─────────────────────────────────────────────────────────
+
+TOOLS=(
+    "git-metadata.sh"
+    "classify-files.sh"
+    "parse-git-log.sh"
+    "scan-markers.sh"
+    "hotspot-rank.sh"
+    "cycle-detect.sh"
+    "parse-reports.sh"
+    "detect-test-framework.sh"
+    "run-coverage.sh"
+    "freshness-check.sh"
+    "adr-index.sh"
+    "manage-symlinks.sh"
+    "mermaid-from-graph.sh"
+    "graph-snapshot.sh"
+    "graph-impact.sh"
+    "graph-callers.sh"
+    "validate-frontmatter.sh"
+    # Foundations hygiene/verification tools
+    "check-graph-usage-report.sh"
+    "check-scope-conflicts.sh"
+    "check-skill-line-caps.sh"
+    "check-template-noop.sh"
+    "check-track-hygiene.sh"
+    "diff-templates-vs-tracks.sh"
+    "emit-skill-metrics.sh"
+    "fix-whitespace.sh"
+    "migrate-track-frontmatter.sh"
+    "render-track.sh"
+    "verify-citations.sh"
+    "verify-doc-anchors.sh"
+    "verify-graph-binary.sh"
+)
+
+# ─────────────────────────────────────────────────────────
+# Validation functions
+# ─────────────────────────────────────────────────────────
+
+# Validate a skill name against kebab-case regex.
+# Prevents path traversal, uppercase, special chars.
+is_valid_skill_name() {
+    local name="$1"
+    [[ "$name" =~ ^[a-z][a-z0-9]*(-[a-z0-9]+)*$ ]]
+}
+
+# Extract body content from a SKILL.md file (strip YAML frontmatter).
+# Returns non-zero and prints to stderr on validation failure.
+extract_body() {
+    local file="$1"
+
+    if [[ "$(sed -n '1p' "$file")" != "---" ]]; then
+        echo "ERROR: Missing YAML frontmatter in $file" >&2
+        echo "  Skill files must start with --- delimiter on line 1" >&2
+        return 1
+    fi
+
+    if ! awk 'NR > 1 && /^---$/ { found=1; exit } END { exit !found }' "$file"; then
+        echo "ERROR: Missing closing YAML frontmatter delimiter in $file" >&2
+        return 1
+    fi
+
+    local frontmatter
+    frontmatter=$(awk '
+        NR == 1 && /^---$/ { in_frontmatter=1; next }
+        /^---$/ && in_frontmatter { exit }
+        in_frontmatter { print }
+    ' "$file")
+
+    if ! printf '%s\n' "$frontmatter" | grep -q "^name:"; then
+        echo "ERROR: Missing 'name:' field in frontmatter of $file" >&2
+        return 1
+    fi
+
+    if ! printf '%s\n' "$frontmatter" | grep -q "^description:"; then
+        echo "ERROR: Missing 'description:' field in frontmatter of $file" >&2
+        return 1
+    fi
+
+    awk '
+        BEGIN { in_frontmatter = 0; found_end = 0 }
+        /^---$/ {
+            if (NR == 1 && in_frontmatter == 0) {
+                in_frontmatter = 1
+                next
+            } else if (found_end == 0) {
+                found_end = 1
+                next
+            }
+        }
+        found_end == 1 { print }
+    ' "$file"
+}
+
+# Validate body format: line 1 blank, line 2 starts with #, line 3 blank.
+validate_skill_body_format() {
+    local skill="$1"
+    local skill_file="$2"
+
+    local body_head line1 line2 line3
+    body_head=$(extract_body "$skill_file" | sed -n '1,3p' || true)
+    line1=$(echo "$body_head" | sed -n '1p')
+    line2=$(echo "$body_head" | sed -n '2p')
+    line3=$(echo "$body_head" | sed -n '3p')
+    if [[ -n "$line1" ]] || [[ ! "$line2" =~ ^#\  ]] || [[ -n "$line3" ]]; then
+        echo "ERROR: Skill '$skill' body format invalid (expected: blank, '# Title', blank). Got:" >&2
+        echo "  Line 1: '${line1}'" >&2
+        echo "  Line 2: '${line2}'" >&2
+        echo "  Line 3: '${line3}'" >&2
+        return 1
+    fi
+}

package/scripts/tools/_lib.sh

@@ -0,0 +1,220 @@
+#!/usr/bin/env bash
+# Shared helpers for scripts/tools/*.sh.
+#
+# Sourced, not executed. No side effects at source time.
+
+# shellcheck shell=bash
+
+json_escape() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\t'/\\t}"
+    s="${s//$'\r'/}"
+    printf '%s' "$s"
+}
+
+# Extract a top-level YAML frontmatter field value from a Markdown file.
+# Discover track directories under a repo root (default: caller's Draft repo).
+discover_track_dirs() {
+    local repo_root="${1:-}"
+    [[ -n "$repo_root" ]] || return 0
+    find "$repo_root" -type d -path '*/tracks/*' -maxdepth 4 -mindepth 2 \
+        -not -path '*/.*' 2>/dev/null | sort
+}
+
+# Extract a string value from minified or pretty-printed JSON.
+read_json_str() {
+    local file="$1" key="$2"
+    [[ -f "$file" ]] || return 0
+    awk -v key="$key" '
+        {
+            pat = "\""key"\"[[:space:]]*:[[:space:]]*\"[^\"]*\""
+            if (match($0, pat)) {
+                s = substr($0, RSTART, RLENGTH)
+                sub("^\""key"\"[[:space:]]*:[[:space:]]*\"", "", s)
+                sub("\"$", "", s)
+                print s
+                exit
+            }
+        }' "$file"
+}
+
+# Parse scope_includes / scope_excludes from metadata.json or spec.md frontmatter.
+read_scope_array() {
+    local file="$1" key="$2"
+    [[ -f "$file" ]] || return 0
+    case "$file" in
+        *.json)
+            awk -v key="$key" '
+                {
+                    pat = "\""key"\"[[:space:]]*:[[:space:]]*\\[[^]]*\\]"
+                    if (match($0, pat)) {
+                        s = substr($0, RSTART, RLENGTH)
+                        sub("^\""key"\"[[:space:]]*:[[:space:]]*", "", s)
+                        gsub(/[\[\]",]/, " ", s)
+                        print s
+                        exit
+                    }
+                }' "$file"
+            ;;
+        *.md)
+            awk -v key="$key" '
+                NR==1 && /^---$/ { in_fm=1; next }
+                in_fm && /^---$/ { exit }
+                in_fm && $0 ~ "^"key":" {
+                    sub("^"key":[[:space:]]*", "", $0)
+                    gsub(/[\[\]",]/, " ", $0)
+                    print $0
+                    exit
+                }' "$file"
+            ;;
+    esac
+}
+
+# Return the per-skill line cap from a caps config file (or GLOBAL_CAP).
+skill_line_cap() {
+    local skill_name="$1" caps_conf="$2" global_cap="$3"
+    local name cap
+    [[ -f "$caps_conf" ]] || { printf '%s' "$global_cap"; return; }
+    while read -r name cap; do
+        [[ -z "$name" || "$name" == \#* ]] && continue
+        if [[ "$name" == "*" ]]; then
+            global_cap="$cap"
+        elif [[ "$name" == "$skill_name" ]]; then
+            printf '%s' "$cap"
+            return
+        fi
+    done < "$caps_conf"
+    printf '%s' "$global_cap"
+}
+
+get_yaml_field() {
+    local file="$1"
+    local key="$2"
+    awk -v key="$key" '
+        NR == 1 && /^---$/ { in_fm = 1; next }
+        in_fm && /^---$/ { exit }
+        in_fm {
+            if ($0 ~ "^"key":[[:space:]]*") {
+                val = $0
+                sub("^"key":[[:space:]]*", "", val)
+                if (val ~ /^".*"$/) { val = substr(val, 2, length(val)-2) }
+                sub(/[[:space:]]+$/, "", val)
+                print val
+                exit
+            }
+        }
+    ' "$file"
+}
+
+# Locate the `codebase-memory-mcp` binary (Draft knowledge-graph engine).
+# Sets MEMORY_BIN globally; returns 0 if found, 1 otherwise.
+# Preference: PATH > Draft-managed install (~/.cache/draft/bin) > vendored bin/<arch> under known roots.
+# No legacy fallbacks: the Aether `graph`/`graph-clang` binaries are retired.
+find_memory_bin() {
+    local repo_abs="$1"
+    local self_repo="$2"
+    MEMORY_BIN=""
+    local bin_name="codebase-memory-mcp"
+
+    # 0. Hard opt-out: force the graph engine off (tests, air-gapped, opt-out users).
+    if [[ -n "${DRAFT_MEMORY_DISABLE:-}" ]]; then
+        return 1
+    fi
+
+    # 1. Explicit override (testing / pinned install).
+    if [[ -n "${DRAFT_MEMORY_BIN:-}" && -x "${DRAFT_MEMORY_BIN}" ]]; then
+        MEMORY_BIN="$DRAFT_MEMORY_BIN"
+        return 0
+    fi
+
+    # 2. PATH (highest for dev / global installs).
+    if command -v "$bin_name" >/dev/null 2>&1; then
+        MEMORY_BIN="$bin_name"
+        return 0
+    fi
+
+    # 3. Draft-managed install location (install.sh fetches the binary here).
+    local managed="$HOME/.cache/draft/bin/$bin_name"
+    if [[ -x "$managed" ]]; then
+        MEMORY_BIN="$managed"
+        return 0
+    fi
+
+    # 4. Optional vendored arch-specific binary under known roots.
+    local os arch norm
+    os=$(uname -s | tr '[:upper:]' '[:lower:]')
+    arch=$(uname -m)
+    case "$arch" in
+        x86_64|amd64) norm="amd64" ;;
+        aarch64|arm64) norm="arm64" ;;
+        *) norm="$arch" ;;
+    esac
+    local ARCH="${os}-${norm}"
+
+    local roots=()
+    [[ -n "$repo_abs" && -d "$repo_abs" ]] && roots+=("$repo_abs")
+    [[ -n "$self_repo" && -d "$self_repo" ]] && roots+=("$self_repo")
+    for bc in \
+        "$HOME/.cursor/plugins/local/draft/.draft-install-path" \
+        "$HOME/.claude/plugins/draft/.draft-install-path"; do
+        if [[ -f "$bc" ]]; then
+            local pr; pr="$(cat "$bc" 2>/dev/null || true)"
+            [[ -n "$pr" && -d "$pr" ]] && roots+=("$pr")
+        fi
+    done
+
+    for pr in "${roots[@]}"; do
+        local cand="$pr/bin/$ARCH/$bin_name"
+        if [[ -x "$cand" ]]; then
+            MEMORY_BIN="$cand"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+# Run a codebase-memory-mcp CLI tool. Echoes the JSON result (stdout); the engine's
+# `level=...` log lines go to stderr and are discarded unless DRAFT_MEMORY_DEBUG is set.
+# Usage: memory_cli <tool> [json-args]
+memory_cli() {
+    local tool="$1"
+    local args="${2:-{\}}"
+    if [[ -z "${MEMORY_BIN:-}" ]]; then
+        return 1
+    fi
+    if [[ -n "${DRAFT_MEMORY_DEBUG:-}" ]]; then
+        "$MEMORY_BIN" cli "$tool" "$args"
+    else
+        "$MEMORY_BIN" cli "$tool" "$args" 2>/dev/null
+    fi
+}
+
+# Resolve the engine's project name for a repository absolute path via list_projects.
+# Echoes the project name, or nothing if the repo has not been indexed yet.
+memory_project_for_repo() {
+    local repo_abs="$1"
+    command -v jq >/dev/null 2>&1 || return 1
+    memory_cli list_projects '{}' 2>/dev/null \
+        | jq -r --arg p "$repo_abs" '.projects[]? | select(.root_path == $p) | .name' 2>/dev/null \
+        | head -1
+}
+
+# Ensure a repository is indexed in the engine; echo its project name.
+# Indexes on demand when absent. Returns 1 if the engine is unavailable.
+memory_ensure_index() {
+    local repo_abs="$1"
+    [[ -n "${MEMORY_BIN:-}" ]] || return 1
+    command -v jq >/dev/null 2>&1 || return 1
+    local proj
+    proj="$(memory_project_for_repo "$repo_abs" 2>/dev/null || true)"
+    if [[ -z "$proj" ]]; then
+        proj="$(memory_cli index_repository "{\"repo_path\":\"$repo_abs\"}" 2>/dev/null \
+            | jq -r '.project // empty' 2>/dev/null || true)"
+    fi
+    [[ -n "$proj" ]] || return 1
+    printf '%s' "$proj"
+}