@danielblomma/cortex-mcp 0.4.0

package/scaffold/scripts/bootstrap.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+MCP_DIR="$REPO_ROOT/mcp"
+TOTAL_STEPS=5
+STEP_INDEX=0
+
+print_logo() {
+  cat <<'EOF'
+  CCC    OOO   RRRR  TTTTT  EEEEE  X   X
+ C   C  O   O  R   R   T    E       X X
+ C      O   O  RRRR    T    EEEE     X
+ C   C  O   O  R  R    T    E       X X
+  CCC    OOO   R   R   T    EEEEE  X   X
+EOF
+}
+
+step() {
+  STEP_INDEX=$((STEP_INDEX + 1))
+  echo ""
+  echo "[cortex][$STEP_INDEX/$TOTAL_STEPS] $1"
+}
+
+info() {
+  echo "[cortex] $1"
+}
+
+print_logo
+info "bootstrap start"
+info "repo: $REPO_ROOT"
+info "pipeline: deps -> ingest -> embeddings -> graph -> status"
+
+mkdir -p "$MCP_DIR/.npm-cache"
+
+step "Installing MCP dependencies"
+info "note: upstream RyuGraph dependencies may print deprecation warnings during install"
+NPM_CONFIG_CACHE="$MCP_DIR/.npm-cache" npm --prefix "$MCP_DIR" install --no-fund --no-update-notifier --loglevel=warn
+NPM_CONFIG_CACHE="$REPO_ROOT/scripts/parsers/.npm-cache" npm --prefix "$REPO_ROOT/scripts/parsers" install --no-fund --no-update-notifier --loglevel=warn
+
+step "Indexing repository context"
+"$REPO_ROOT/scripts/ingest.sh"
+
+step "Generating semantic embeddings"
+if ! "$REPO_ROOT/scripts/embed.sh"; then
+  info "warning: embedding generation failed; continuing with lexical search fallback"
+fi
+
+step "Loading RyuGraph"
+"$REPO_ROOT/scripts/load-ryu.sh"
+
+step "Reading context status"
+"$REPO_ROOT/scripts/status.sh"
+
+echo ""
+info "bootstrap complete"
+info "next: run ./scripts/context.sh update while coding"

package/scaffold/scripts/capture-note.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+NOTES_DIR="$REPO_ROOT/.context/notes"
+DECISIONS_DIR="$REPO_ROOT/.context/decisions"
+
+TITLE="${1:-}"
+if [[ -z "$TITLE" ]]; then
+  echo "Usage: ./scripts/context.sh note <title> [text]"
+  exit 1
+fi
+shift || true
+
+BODY="${*:-}"
+if [[ -z "$BODY" && ! -t 0 ]]; then
+  BODY="$(cat)"
+fi
+
+mkdir -p "$NOTES_DIR" "$DECISIONS_DIR"
+
+DATE_UTC="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+DATE_PREFIX="$(date -u +"%Y-%m-%d")"
+SLUG="$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//; s/-+/-/g')"
+if [[ -z "$SLUG" ]]; then
+  SLUG="note"
+fi
+FILE_PATH="$NOTES_DIR/${DATE_PREFIX}-${SLUG}.md"
+
+if [[ -f "$FILE_PATH" ]]; then
+  FILE_PATH="$NOTES_DIR/${DATE_PREFIX}-${SLUG}-$(date -u +"%H%M%S").md"
+fi
+
+{
+  echo "---"
+  echo "title: \"$TITLE\""
+  echo "created_at: \"$DATE_UTC\""
+  echo "kind: \"team-note\""
+  echo "source_of_truth: false"
+  echo "trust_level: 60"
+  echo "status: active"
+  echo "---"
+  echo
+  if [[ -n "$BODY" ]]; then
+    echo "$BODY"
+  else
+    echo "_Skriv ner bakgrund, beslut, edge-cases och länkar här._"
+  fi
+  echo
+  echo "## Follow-up"
+  echo "- [ ] Convert to ADR in .context/decisions/ if this becomes a long-term rule."
+} > "$FILE_PATH"
+
+echo "[note] wrote $FILE_PATH"
+echo "[note] run: ./scripts/context.sh update"

package/scaffold/scripts/context.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+print_help() {
+  cat <<'EOF'
+Usage: ./scripts/context.sh <command> [options]
+
+Commands:
+  bootstrap                        Install deps + full ingest + graph load
+  ingest [--changed] [--verbose]   Index docs/code/design context into .context
+  embed [--changed]                Generate semantic embeddings for indexed entities
+  update                           Ingest changed files + rebuild graph
+  watch [start|stop|status|run|once] [--interval <sec>] [--debounce <sec>] [--mode <auto|event|poll>]
+                                    Continuous background update loop
+  refresh [--changed] [--verbose]  Alias for ingest
+  graph-load [--no-reset]          Build RyuGraph DB from indexed context
+  note <title> [text]              Save tacit knowledge note into .context/notes
+  plan [show|reset]                Show or reset automatic plan/progress state
+  todo [text|list|done <id>|reopen <id>|remove <id>]
+                                   Manage TODOs in automatic plan state
+  status                           Show latest ingest summary
+  help                             Show this message
+EOF
+}
+
+COMMAND="${1:-help}"
+if [[ $# -gt 0 ]]; then
+  shift
+fi
+
+TRACK_EVENT=""
+
+case "$COMMAND" in
+  bootstrap)
+    "$SCRIPT_DIR/bootstrap.sh" "$@"
+    TRACK_EVENT="bootstrap"
+    ;;
+  ingest)
+    "$SCRIPT_DIR/ingest.sh" "$@"
+    TRACK_EVENT="ingest"
+    ;;
+  embed)
+    "$SCRIPT_DIR/embed.sh" "$@"
+    TRACK_EVENT="embed"
+    ;;
+  update)
+    "$SCRIPT_DIR/update-context.sh" "$@"
+    TRACK_EVENT="update"
+    ;;
+  watch)
+    "$SCRIPT_DIR/watch.sh" "$@"
+    ;;
+  refresh)
+    "$SCRIPT_DIR/refresh.sh" "$@"
+    TRACK_EVENT="refresh"
+    ;;
+  graph-load)
+    "$SCRIPT_DIR/load-ryu.sh" "$@"
+    TRACK_EVENT="graph-load"
+    ;;
+  note)
+    "$SCRIPT_DIR/capture-note.sh" "$@"
+    TRACK_EVENT="note"
+    ;;
+  plan)
+    PLAN_SUBCOMMAND="${1:-show}"
+    if [[ $# -gt 0 ]]; then
+      shift
+    fi
+    "$SCRIPT_DIR/plan-state.sh" "$PLAN_SUBCOMMAND" "$@"
+    ;;
+  todo)
+    if [[ $# -eq 0 ]]; then
+      "$SCRIPT_DIR/plan-state.sh" todo list
+    else
+      case "$1" in
+        list|done|reopen|remove)
+          TODO_SUBCOMMAND="$1"
+          shift
+          "$SCRIPT_DIR/plan-state.sh" todo "$TODO_SUBCOMMAND" "$@"
+          ;;
+        *)
+          "$SCRIPT_DIR/plan-state.sh" todo add "$*"
+          ;;
+      esac
+    fi
+    TRACK_EVENT="todo"
+    ;;
+  status)
+    "$SCRIPT_DIR/status.sh"
+    TRACK_EVENT="status"
+    ;;
+  help|--help|-h)
+    print_help
+    ;;
+  *)
+    echo "Unknown command: $COMMAND"
+    print_help
+    exit 1
+    ;;
+esac
+
+if [[ -n "$TRACK_EVENT" ]]; then
+  if ! "$SCRIPT_DIR/plan-state.sh" event "$TRACK_EVENT" >/dev/null 2>&1; then
+    echo "[plan] warning: failed to update plan state"
+  fi
+fi

package/scaffold/scripts/embed.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+MCP_DIR="$REPO_ROOT/mcp"
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "[embed] npm is required but not found on PATH"
+  exit 1
+fi
+
+mkdir -p "$MCP_DIR/.npm-cache"
+
+echo "[embed] generating embeddings via mcp/embed"
+NPM_CONFIG_CACHE="$MCP_DIR/.npm-cache" npm --prefix "$MCP_DIR" run embed --silent -- "$@"