@agentuity/claude-code 2.0.10 → 3.0.0-alpha.0

package/hooks/scripts/session-start.sh

@@ -1,68 +0,0 @@
-#!/usr/bin/env bash
-# Session start hook: Gather Agentuity context
-set -euo pipefail
-
-# Find agentuity.json by walking up directories
-find_agentuity_json() {
-  local dir="$PWD"
-  while [ "$dir" != "/" ]; do
-    if [ -f "$dir/agentuity.json" ]; then
-      echo "$dir/agentuity.json"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  return 1
-}
-
-# Initialize context
-CONTEXT="{}"
-
-# Check CLI availability
-if command -v agentuity &>/dev/null; then
-  CLI_AVAILABLE=true
-else
-  CLI_AVAILABLE=false
-fi
-
-# Read agentuity.json
-AGENTUITY_JSON=""
-if AGENTUITY_JSON_PATH=$(find_agentuity_json); then
-  AGENTUITY_JSON=$(cat "$AGENTUITY_JSON_PATH" 2>/dev/null || echo "{}")
-fi
-
-# Extract project info
-PROJECT_ID=$(echo "$AGENTUITY_JSON" | grep -o '"projectId"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"projectId"[[:space:]]*:[[:space:]]*"\([^"]*\)"/\1/' || echo "")
-ORG_ID=$(echo "$AGENTUITY_JSON" | grep -o '"orgId"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"orgId"[[:space:]]*:[[:space:]]*"\([^"]*\)"/\1/' || echo "")
-
-# If no orgId in agentuity.json, try CLI profile
-if [ -z "$ORG_ID" ] && [ -f "$HOME/.config/agentuity/production.yaml" ]; then
-  ORG_ID=$(grep 'orgId' "$HOME/.config/agentuity/production.yaml" 2>/dev/null | head -1 | sed 's/.*orgId:[[:space:]]*//' | tr -d '"' || echo "")
-fi
-
-# Get user info from CLI
-USER_INFO=""
-if [ "$CLI_AVAILABLE" = true ]; then
-  USER_INFO=$(agentuity auth whoami --json 2>/dev/null || echo "")
-fi
-
-# Get git info
-GIT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-GIT_REMOTE=$(git remote get-url origin 2>/dev/null || echo "unknown")
-
-# Output context
-cat <<EOF
-{
-  "agentuity": {
-    "cliAvailable": $CLI_AVAILABLE,
-    "projectId": "$PROJECT_ID",
-    "orgId": "$ORG_ID",
-    "configPath": "${AGENTUITY_JSON_PATH:-}",
-    "userInfo": ${USER_INFO:-null}
-  },
-  "git": {
-    "branch": "$GIT_BRANCH",
-    "remote": "$GIT_REMOTE"
-  }
-}
-EOF

package/hooks/scripts/setup-cadence.sh

@@ -1,133 +0,0 @@
-#!/usr/bin/env bash
-# Setup script for Cadence mode.
-# Creates the .claude/agentuity-cadence.local.md state file and saves initial state to KV.
-#
-# Usage: setup-cadence.sh [--max-iterations N] [--completion-promise TEXT] PROMPT
-#
-# The state file is read by cadence-stop.sh (Stop hook) to keep
-# the loop running until the completion promise is detected.
-# State is also persisted to Agentuity Cloud KV for cross-session recall.
-
-set -euo pipefail
-
-MAX_ITERATIONS=50
-COMPLETION_PROMISE="DONE"
-PROMPT=""
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --max-iterations)
-      MAX_ITERATIONS="$2"
-      shift 2
-      ;;
-    --completion-promise)
-      COMPLETION_PROMISE="$2"
-      shift 2
-      ;;
-    -h|--help)
-      echo "Usage: setup-cadence.sh [OPTIONS] PROMPT"
-      echo ""
-      echo "Options:"
-      echo "  --max-iterations N        Maximum loop iterations (default: 50)"
-      echo "  --completion-promise TEXT  Completion signal text (default: DONE)"
-      echo "  -h, --help                Show this help"
-      exit 0
-      ;;
-    *)
-      # Everything else is the prompt
-      if [ -z "$PROMPT" ]; then
-        PROMPT="$1"
-      else
-        PROMPT="$PROMPT $1"
-      fi
-      shift
-      ;;
-  esac
-done
-
-if [ -z "$PROMPT" ]; then
-  echo "Error: No prompt provided" >&2
-  echo "Usage: setup-cadence.sh [OPTIONS] PROMPT" >&2
-  exit 1
-fi
-
-# Validate max-iterations
-if ! [[ "$MAX_ITERATIONS" =~ ^[0-9]+$ ]] || [[ "$MAX_ITERATIONS" -lt 1 ]]; then
-  echo "Error: --max-iterations must be a positive integer" >&2
-  exit 1
-fi
-
-# Generate a loop ID: lp_{short_name}_{random}
-# Take first 3 words of prompt, lowercase, underscored, plus random suffix
-SHORT_NAME=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]' | tr -cs '[:alnum:]' '_' | cut -c1-30 | sed 's/_$//')
-RANDOM_SUFFIX=$(head -c 4 /dev/urandom | od -An -tx1 | tr -d ' \n' | cut -c1-6)
-LOOP_ID="lp_${SHORT_NAME}_${RANDOM_SUFFIX}"
-
-# Get git branch
-GIT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-
-# Create .claude directory if needed
-mkdir -p .claude
-
-# Check for existing cadence session
-if [ -f ".claude/agentuity-cadence.local.md" ]; then
-  EXISTING_ITER=$(sed -n '/^---$/,/^---$/{ /^iteration:/s/iteration: *//p }' .claude/agentuity-cadence.local.md)
-  EXISTING_LOOP=$(sed -n '/^---$/,/^---$/{ /^loop_id:/s/loop_id: *//p }' .claude/agentuity-cadence.local.md | tr -d '"')
-  echo "Warning: Active Cadence loop found (${EXISTING_LOOP:-?} at iteration ${EXISTING_ITER:-?}). Replacing with new loop." >&2
-  rm -f .claude/agentuity-cadence.local.md
-fi
-
-# Create state file
-CREATED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-cat > .claude/agentuity-cadence.local.md << STATEFILE
----
-active: true
-loop_id: "${LOOP_ID}"
-iteration: 1
-max_iterations: ${MAX_ITERATIONS}
-completion_promise: "${COMPLETION_PROMISE}"
-branch: "${GIT_BRANCH}"
-created_at: ${CREATED_AT}
----
-
-${PROMPT}
-STATEFILE
-
-# Save initial cadence state to KV (if agentuity CLI available)
-if command -v agentuity &>/dev/null; then
-  KV_STATE=$(jq -n \
-    --arg loopId "$LOOP_ID" \
-    --arg prompt "$PROMPT" \
-    --arg branch "$GIT_BRANCH" \
-    --arg createdAt "$CREATED_AT" \
-    --argjson iteration 1 \
-    --argjson maxIterations "$MAX_ITERATIONS" \
-    --arg completionPromise "$COMPLETION_PROMISE" \
-    --arg status "active" \
-    '{
-      loopId: $loopId,
-      prompt: $prompt,
-      branch: $branch,
-      iteration: $iteration,
-      maxIterations: $maxIterations,
-      completionPromise: $completionPromise,
-      status: $status,
-      startedAt: $createdAt,
-      lastActivity: $createdAt,
-      checkpoints: []
-    }')
-  agentuity cloud kv set agentuity-opencode-memory "cadence:${LOOP_ID}" "$KV_STATE" --region use 2>/dev/null || true
-fi
-
-echo "Cadence loop initialized:"
-echo "  Loop ID: ${LOOP_ID}"
-echo "  Max iterations: ${MAX_ITERATIONS}"
-echo "  Completion promise: ${COMPLETION_PROMISE}"
-echo "  Branch: ${GIT_BRANCH}"
-echo "  State file: .claude/agentuity-cadence.local.md"
-echo "  KV key: cadence:${LOOP_ID}"
-echo ""
-echo "The loop will continue until you output <promise>${COMPLETION_PROMISE}</promise>"
-echo "or reach ${MAX_ITERATIONS} iterations."
-echo "To cancel: /agentuity-cadence-cancel"

package/hooks/scripts/stop-memory-save.sh

@@ -1,69 +0,0 @@
-#!/usr/bin/env bash
-# Stop hook: Request memory save before session ends (interactive mode only).
-#
-# In INTERACTIVE mode: blocks the first stop to request memory save via Memory agent.
-# In HEADLESS mode (-p): skips entirely — session-end.sh handles KV save directly.
-#
-# Exit 0 = let Claude stop normally.
-# Exit 2 + JSON with decision:block = prevent stop and inject instructions.
-
-INPUT=$(cat)
-
-# Check if agentuity CLI is available — if not, skip memory save
-if ! command -v agentuity &>/dev/null; then
-  exit 0
-fi
-
-# If Cadence mode is active, skip memory save — cadence-stop.sh handles the loop
-# and includes Memory checkpoints at each iteration.
-if [ -f ".claude/agentuity-cadence.local.md" ]; then
-  exit 0
-fi
-
-# Detect headless mode: check if CLAUDE_CODE_HEADLESS is set, or if
-# the session was started with -p (no TTY on parent's stdin).
-# In headless mode, session-end.sh handles memory save directly via KV.
-if [ "${CLAUDE_CODE_HEADLESS:-}" = "1" ] || [ "${CLAUDE_NON_INTERACTIVE:-}" = "1" ]; then
-  exit 0
-fi
-
-# Also detect headless by checking if the parent process has no TTY
-if ! kill -0 $PPID 2>/dev/null || [ ! -t 0 ] 2>/dev/null; then
-  # Can't reliably detect, but hooks don't have a TTY in either mode.
-  # Use the marker-only approach and keep the block minimal.
-  :
-fi
-
-# Use a session-specific marker file to track save state.
-# PPID is the Claude Code process that spawns hooks — consistent within a session.
-MARKER_DIR="/tmp/agentuity-coder-memory"
-mkdir -p "$MARKER_DIR" 2>/dev/null
-MARKER_FILE="$MARKER_DIR/saved-$PPID"
-
-# If we've already requested a save this session, let Claude stop
-if [ -f "$MARKER_FILE" ]; then
-  exit 0
-fi
-
-# Mark that we've requested a save
-touch "$MARKER_FILE"
-
-# Clean up old markers (older than 24h)
-find "$MARKER_DIR" -name 'saved-*' -mtime +1 -delete 2>/dev/null || true
-
-# Get git branch for context
-GIT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-
-# Block the stop and request agentic memory save via Memory agent.
-# The Memory agent has full reasoning capabilities: entity extraction,
-# corrections identification, Vector upsert, and structured KV storage.
-#
-# IMPORTANT: We use the Task tool to delegate to Memory agent (subagent),
-# NOT Lead, to avoid complex multi-agent orchestration that can hang.
-cat <<EOF
-{
-  "decision": "block",
-  "reason": "Before ending this session, you MUST save session context to persistent memory. Use the Task tool to delegate to the Memory agent:\n\nTask tool parameters:\n- subagent_type: agentuity-coder:agentuity-coder-memory\n- description: Save session memory\n- prompt: \"Memorialize this session. You are being invoked automatically at session end. Review the conversation above and perform a full session memorialization:\\n\\n1. Create a session summary using the Session Summary Template (PROBLEM, CONTEXT, DECISIONS, CORRECTIONS, SOLUTIONS, PATTERNS, FILES, OPEN QUESTIONS)\\n2. Extract and store any corrections/mistakes as high-priority KV entries (correction:{name})\\n3. Store any key decisions (decision:{name})\\n4. Store any reusable patterns (pattern:{name})\\n5. Upsert the FULL session document to Vector storage for semantic search\\n6. Apply reasoning to extract conclusions (explicit, deductive, inductive, abductive) and update entity representations\\n7. Current branch: ${GIT_BRANCH}\\n\\nDo NOT ask questions. Summarize and store everything you can from the conversation history. Prioritize corrections and decisions.\"\n\nAfter the Memory agent completes, you may stop."
-}
-EOF
-exit 2

package/skills/agentuity-command-runner/SKILL.md

@@ -1,128 +0,0 @@
----
-name: agentuity-command-runner
-description: When running lint, build, test, typecheck, format, clean, or install commands and need structured, actionable output. Activates when executing development commands and parsing their output into structured error reports with file locations, error classification, and deduplication.
-version: 1.0.0
----
-
-# Command Runner Reference
-
-Reference for executing development commands and parsing output into structured, actionable summaries.
-
-## Runtime Detection
-
-Before running ANY command, detect the correct runtime:
-
-### Detection Priority
-
-1. **Agentuity project** (highest priority):
-   - If `agentuity.json` or `.agentuity/` exists → **bun**
-   - Agentuity projects are ALWAYS bun-only
-
-2. **JavaScript/TypeScript lockfiles**:
-   - `bun.lockb` → **bun**
-   - `package-lock.json` → **npm**
-   - `pnpm-lock.yaml` → **pnpm**
-   - `yarn.lock` → **yarn**
-
-3. **Other ecosystems**:
-   - `go.mod` → **go**
-   - `Cargo.toml` → **cargo** (Rust)
-   - `pyproject.toml` → **uv** or **poetry**
-   - `requirements.txt` → **pip**
-
-## Command Patterns by Ecosystem
-
-### JavaScript/TypeScript (bun/npm/pnpm/yarn)
-
-| Task      | bun                 | npm                 | pnpm                 |
-| --------- | ------------------- | ------------------- | -------------------- |
-| install   | `bun install`       | `npm install`       | `pnpm install`       |
-| build     | `bun run build`     | `npm run build`     | `pnpm run build`     |
-| test      | `bun test`          | `npm test`          | `pnpm test`          |
-| typecheck | `bun run typecheck` | `npm run typecheck` | `pnpm run typecheck` |
-| lint      | `bun run lint`      | `npm run lint`      | `pnpm run lint`      |
-| format    | `bun run format`    | `npm run format`    | `pnpm run format`    |
-| clean     | `bun run clean`     | `npm run clean`     | `pnpm run clean`     |
-
-### Go
-
-| Task   | Command             |
-| ------ | ------------------- |
-| build  | `go build ./...`    |
-| test   | `go test ./...`     |
-| lint   | `golangci-lint run` |
-| format | `go fmt ./...`      |
-
-### Rust (cargo)
-
-| Task   | Command        |
-| ------ | -------------- |
-| build  | `cargo build`  |
-| test   | `cargo test`   |
-| lint   | `cargo clippy` |
-| format | `cargo fmt`    |
-
-## Output Parsing Intelligence
-
-### Error Extraction Rules
-
-1. **Deduplicate** — Same error in multiple files? Report once with count
-2. **Prioritize** — Errors before warnings
-3. **Truncate** — Top 10 issues max (note if more exist)
-4. **Extract locations** — file:line format when available
-5. **Classify** — type error, syntax error, lint error, test failure
-
-### Error Classification
-
-| Type         | Signal Words                                    |
-| ------------ | ----------------------------------------------- |
-| Type Error   | "Type", "TS", "cannot assign", "not assignable" |
-| Syntax Error | "Unexpected", "SyntaxError", "Parse error"      |
-| Lint Error   | "eslint", "biome", "warning", "rule"            |
-| Test Failure | "FAIL", "AssertionError", "expect", "assert"    |
-| Build Error  | "Build failed", "Cannot find module"            |
-
-### Location Extraction
-
-Extract file:line from common formats:
-
-- TypeScript: `src/foo.ts(10,5): error TS2322`
-- ESLint: `src/foo.ts:10:5 error`
-- Go: `./pkg/foo.go:10:5:`
-- Rust: `--> src/main.rs:10:5`
-- Python: `File "src/foo.py", line 10`
-
-## Structured Output Format
-
-```markdown
-## [Task] Result: [PASSED | FAILED | WARNINGS]
-
-**Runtime:** [bun | npm | pnpm | go | cargo | uv]
-**Command:** `[exact command executed]`
-**Duration:** [time in seconds]
-**Exit Code:** [0 | non-zero]
-
-### Errors ([count])
-
-| File         | Line | Type | Message                                          |
-| ------------ | ---- | ---- | ------------------------------------------------ |
-| `src/foo.ts` | 45   | Type | Type 'string' is not assignable to type 'number' |
-
-### Warnings ([count])
-
-| File         | Line | Message           |
-| ------------ | ---- | ----------------- |
-| `src/baz.ts` | 8    | Unused import 'y' |
-
-### Summary
-
-[One sentence: what happened, what the calling agent should know]
-```
-
-## Execution Workflow
-
-1. **Detect Runtime** — Check for agentuity.json, then lockfiles
-2. **Discover or Use Explicit Command** — Auto-discover from package.json or use provided command
-3. **Execute Command** — Capture stdout, stderr, exit code, duration
-4. **Parse Output** — Extract and classify errors/warnings with file:line
-5. **Return Structured Result** — Format using the template above