generated from coulomb/repo-seed
tegwick
8a9314ded6
Instead of overwriting the target repo's CLAUDE.md, the registration script now writes CLAUDE.custodian.md — a suggestion file with an integration header. The repo's Claude agent integrates both files and deletes the suggestion when done, preserving existing project conventions. Also fix: `read` prompt now redirects from /dev/tty so the script doesn't exit with code 1 when run non-interactively via make. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
223 lines
9.1 KiB
Bash
Executable File
223 lines
9.1 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# register_project.sh — register a project/repo with the Custodian State Hub
|
|
#
|
|
# Usage: scripts/register_project.sh <domain> <project_path> [--additional]
|
|
# domain: slug of an active domain (e.g. custodian, railiance)
|
|
# project_path: absolute path to the project directory
|
|
# --additional: add a second repo to an existing domain; skip CLAUDE.md
|
|
#
|
|
# Example:
|
|
# scripts/register_project.sh railiance /home/worsch/railiance
|
|
# scripts/register_project.sh railiance /home/worsch/railiance-infra --additional
|
|
#
|
|
# What it does:
|
|
# 1. Verify the API is reachable
|
|
# 2. Verify the domain exists via GET /domains/{slug}/
|
|
# 3. Look up the topic ID for the domain (first active topic)
|
|
# 4. Check that state-hub is in ~/.claude.json; warn if missing
|
|
# 5. Write $project_path/CLAUDE.custodian.md (suggestion; repo agent integrates → CLAUDE.md)
|
|
# 6. POST to /repos/ to register the repo
|
|
# 7. POST a progress event recording the registration
|
|
|
|
set -euo pipefail
|
|
|
|
DOMAIN="${1:-}"
|
|
PROJECT_PATH="${2:-}"
|
|
ADDITIONAL="${3:-}"
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
STATE_HUB_DIR="$(dirname "$SCRIPT_DIR")"
|
|
API_BASE="${API_BASE:-http://127.0.0.1:8000}"
|
|
|
|
# ── Validate args ──────────────────────────────────────────────────────────────
|
|
if [[ -z "$DOMAIN" || -z "$PROJECT_PATH" ]]; then
|
|
echo "Usage: $0 <domain> <project_path> [--additional]"
|
|
echo " domain: slug of an active domain in the State Hub"
|
|
echo " project_path: absolute path to project directory"
|
|
echo " --additional: register a second repo; skip CLAUDE.md generation"
|
|
exit 1
|
|
fi
|
|
|
|
if [[ ! -d "$PROJECT_PATH" ]]; then
|
|
echo "ERROR: project_path does not exist: $PROJECT_PATH"
|
|
exit 1
|
|
fi
|
|
|
|
PROJECT_NAME="$(basename "$PROJECT_PATH")"
|
|
REPO_SLUG="$(echo "$PROJECT_NAME" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/-\+/-/g' | sed 's/^-\|-$//g')"
|
|
|
|
# ── Step 1: API health check ───────────────────────────────────────────────────
|
|
echo "==> Checking API at $API_BASE ..."
|
|
if ! curl -sf "$API_BASE/state/health" > /dev/null; then
|
|
echo "ERROR: State Hub API is not reachable."
|
|
echo " Start it: cd $STATE_HUB_DIR && make api"
|
|
echo " (requires postgres: make db first)"
|
|
exit 1
|
|
fi
|
|
echo " API OK"
|
|
|
|
# ── Step 2: Verify domain exists ───────────────────────────────────────────────
|
|
echo "==> Verifying domain '$DOMAIN' ..."
|
|
DOMAIN_JSON="$(curl -sf "$API_BASE/domains/$DOMAIN/" 2>/dev/null || echo 'NOT_FOUND')"
|
|
if [[ "$DOMAIN_JSON" == "NOT_FOUND" ]] || echo "$DOMAIN_JSON" | python3 -c "import json,sys; d=json.load(sys.stdin); sys.exit(0 if d.get('slug') else 1)" 2>/dev/null; then
|
|
if [[ "$DOMAIN_JSON" == "NOT_FOUND" ]] || ! echo "$DOMAIN_JSON" | python3 -c "import json,sys; d=json.load(sys.stdin); sys.exit(0 if d.get('slug') else 1)" 2>/dev/null; then
|
|
echo "ERROR: Domain '$DOMAIN' not found in the State Hub."
|
|
echo " To create: make add-domain DOMAIN=$DOMAIN NAME=\"<display name>\""
|
|
echo " To list available: curl -s $API_BASE/domains/ | python3 -m json.tool"
|
|
exit 1
|
|
fi
|
|
fi
|
|
echo " Domain OK"
|
|
|
|
# ── Step 3: Look up topic ID ───────────────────────────────────────────────────
|
|
echo "==> Looking up topic for domain '$DOMAIN' ..."
|
|
TOPICS_JSON="$(curl -sf "$API_BASE/topics/?status=active")"
|
|
|
|
TOPIC_ID="$(echo "$TOPICS_JSON" | python3 -c "
|
|
import json, sys
|
|
topics = json.load(sys.stdin)
|
|
match = next((t for t in topics if t.get('domain_slug') == sys.argv[1]), None)
|
|
if not match:
|
|
print('NOT_FOUND')
|
|
else:
|
|
print(match['id'])
|
|
" "$DOMAIN")"
|
|
|
|
if [[ "$TOPIC_ID" == "NOT_FOUND" ]]; then
|
|
echo "WARNING: No active topic found for domain '$DOMAIN'. CLAUDE.md will omit topic_id."
|
|
TOPIC_ID=""
|
|
else
|
|
echo " topic_id: $TOPIC_ID"
|
|
fi
|
|
|
|
# ── Step 4: Check MCP registration ────────────────────────────────────────────
|
|
echo "==> Checking MCP server registration ..."
|
|
MCP_OK="$(python3 -c "
|
|
import json
|
|
from pathlib import Path
|
|
f = Path.home() / '.claude.json'
|
|
if not f.exists():
|
|
print('MISSING_FILE')
|
|
else:
|
|
d = json.loads(f.read_text())
|
|
servers = d.get('mcpServers', {})
|
|
print('OK' if 'state-hub' in servers else 'NOT_REGISTERED')
|
|
")"
|
|
|
|
if [[ "$MCP_OK" == "MISSING_FILE" ]]; then
|
|
echo "WARNING: ~/.claude.json not found. MCP server is not registered."
|
|
elif [[ "$MCP_OK" == "NOT_REGISTERED" ]]; then
|
|
echo "WARNING: 'state-hub' not found in ~/.claude.json."
|
|
echo " To register, see CLAUDE.md MCP Server Registration section."
|
|
else
|
|
echo " MCP OK"
|
|
fi
|
|
|
|
# ── Step 5: Write CLAUDE.custodian.md (suggestion for the repo agent) ─────────
|
|
CLAUDE_MD="$PROJECT_PATH/CLAUDE.md"
|
|
SUGGESTION_FILE="$PROJECT_PATH/CLAUDE.custodian.md"
|
|
TEMPLATE="$SCRIPT_DIR/project_claude_md.template"
|
|
|
|
echo "==> Writing custodian suggestion to $SUGGESTION_FILE ..."
|
|
{
|
|
cat <<'PREAMBLE'
|
|
<!--
|
|
CUSTODIAN SUGGESTION — generated by `make register-project`
|
|
|
|
This file was written by the Custodian State Hub registration workflow.
|
|
It contains the standard State Hub integration block for this repository.
|
|
|
|
A Claude Code agent in this repo should:
|
|
1. Read this file and the existing CLAUDE.md side by side
|
|
2. Integrate the sections below into CLAUDE.md — preserve all existing
|
|
project-specific conventions; add or update the hub integration block
|
|
3. Delete this file once integration is complete and commit the result
|
|
|
|
Do NOT add this file to .gitignore. It is a temporary artefact that signals
|
|
pending integration work to the repo agent.
|
|
-->
|
|
|
|
PREAMBLE
|
|
sed \
|
|
-e "s|{PROJECT_NAME}|$PROJECT_NAME|g" \
|
|
-e "s|{DOMAIN}|$DOMAIN|g" \
|
|
-e "s|{TOPIC_ID}|$TOPIC_ID|g" \
|
|
-e "s|{REPO_SLUG}|$REPO_SLUG|g" \
|
|
"$TEMPLATE"
|
|
} > "$SUGGESTION_FILE"
|
|
echo " Written. The repo agent should integrate it into CLAUDE.md and delete this file."
|
|
|
|
# ── Step 6: Register repo in State Hub ────────────────────────────────────────
|
|
echo "==> Registering repo '$PROJECT_NAME' under domain '$DOMAIN' ..."
|
|
REPO_PAYLOAD="$(python3 -c "
|
|
import json
|
|
payload = {
|
|
'domain_slug': '$DOMAIN',
|
|
'slug': '$REPO_SLUG',
|
|
'name': '$PROJECT_NAME',
|
|
'local_path': '$PROJECT_PATH',
|
|
}
|
|
print(json.dumps(payload))
|
|
")"
|
|
|
|
REPO_RESULT="$(curl -sf -X POST "$API_BASE/repos/" \
|
|
-H "Content-Type: application/json" \
|
|
-d "$REPO_PAYLOAD" 2>/dev/null || echo 'REPO_EXISTS')"
|
|
|
|
if [[ "$REPO_RESULT" == "REPO_EXISTS" ]]; then
|
|
echo " Repo '$REPO_SLUG' already registered (or slug conflict) — skipping."
|
|
else
|
|
echo " Repo registered: $REPO_SLUG"
|
|
fi
|
|
|
|
# ── Step 7: Record progress event ─────────────────────────────────────────────
|
|
echo "==> Recording registration event ..."
|
|
EVENT_JSON="$(python3 -c "
|
|
import json
|
|
payload = {
|
|
$([ -n '$TOPIC_ID' ] && echo "'topic_id': '$TOPIC_ID',")
|
|
'event_type': 'milestone',
|
|
'summary': 'Project registered with State Hub: $PROJECT_NAME ($DOMAIN)',
|
|
'author': 'custodian',
|
|
'detail': {
|
|
'project_path': '$PROJECT_PATH',
|
|
'suggestion_file': '$SUGGESTION_FILE',
|
|
'domain': '$DOMAIN',
|
|
'repo_slug': '$REPO_SLUG',
|
|
},
|
|
}
|
|
print(json.dumps(payload))
|
|
")"
|
|
|
|
curl -sf -X POST "$API_BASE/progress/" \
|
|
-H "Content-Type: application/json" \
|
|
-d "$EVENT_JSON" > /dev/null
|
|
|
|
echo " Event recorded."
|
|
echo ""
|
|
echo "Registration complete!"
|
|
echo " Project: $PROJECT_NAME"
|
|
echo " Domain: $DOMAIN"
|
|
echo " Repo slug: $REPO_SLUG"
|
|
[[ -n "$TOPIC_ID" ]] && echo " Topic ID: $TOPIC_ID"
|
|
echo " Suggestion: $SUGGESTION_FILE (repo agent should integrate → CLAUDE.md)"
|
|
echo ""
|
|
echo "Next: restart Claude Code for the MCP server to be available in this project."
|
|
|
|
# ── Optional: SBOM ingest ─────────────────────────────────────────────────────
|
|
if [[ "$ADDITIONAL" != "--additional" ]]; then
|
|
echo ""
|
|
read -r -p "==> Run SBOM ingest now? (auto-detects lockfile in $PROJECT_PATH) [y/N] " INGEST_NOW </dev/tty || INGEST_NOW="N"
|
|
if [[ "$INGEST_NOW" =~ ^[Yy]$ ]]; then
|
|
echo "==> Ingesting SBOM for '$REPO_SLUG' ..."
|
|
INGEST_UV="$STATE_HUB_DIR/.venv/bin/python"
|
|
if [[ -x "$INGEST_UV" ]]; then
|
|
"$INGEST_UV" "$SCRIPT_DIR/ingest_sbom.py" \
|
|
--repo "$REPO_SLUG" \
|
|
--repo-path "$PROJECT_PATH" \
|
|
--api-base "$API_BASE" && echo " SBOM ingested." || echo " SBOM ingest failed (non-fatal)."
|
|
else
|
|
echo " Skipping: .venv not found. Run 'make install' first, then 'make ingest-sbom REPO=$REPO_SLUG'."
|
|
fi
|
|
fi
|
|
fi
|