codexkit 1.0.0

package/install/install-project.sh

@@ -0,0 +1,704 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Parse args
+PROJECT_DIR=""
+FORCE=false
+UPGRADE=false
+TEMPLATE_NAME=""
+AUTO_APPLY_PATCHES=false
+FULL_LOCAL=false
+for arg in "$@"; do
+    case "$arg" in
+        --force) FORCE=true ;;
+        --upgrade) UPGRADE=true ;;
+        --auto-apply-patches) AUTO_APPLY_PATCHES=true ;;
+        --full-local) FULL_LOCAL=true ;;
+        --template=*) TEMPLATE_NAME="${arg#--template=}" ;;
+        --template)
+            # Next arg is template name (handled below)
+            _next_is_template=true
+            continue
+            ;;
+        *)
+            if [ "${_next_is_template:-}" = "true" ]; then
+                TEMPLATE_NAME="$arg"
+                _next_is_template=""
+            elif [ "$arg" = "--auto-apply-patches" ]; then
+                :
+            elif [ "$arg" = "--full-local" ]; then
+                :
+            elif [ -z "$PROJECT_DIR" ]; then
+                PROJECT_DIR="$arg"
+            fi
+            ;;
+    esac
+done
+PROJECT_DIR="${PROJECT_DIR:-$(pwd)}"
+CODEXKIT_HOME="${CODEXKIT_HOME:-$HOME/.codexkit}"
+GLOBAL_CODEX_DIR="${HOME}/.codex"
+
+MANIFEST="$REPO_DIR/.codex/.template-manifest.json"
+[ -f "$MANIFEST" ] || MANIFEST="$REPO_DIR/.template-manifest.json"
+
+should_copy() {
+    local target="$1"
+    local source_path="$2"
+    local manifest_hash installed_hash
+
+    # New file → always copy
+    [ ! -f "$target" ] && return 0
+
+    # Force → always copy
+    $FORCE && return 0
+
+    # Upgrade mode → check if customized
+    if $UPGRADE && [ -f "$MANIFEST" ]; then
+        manifest_hash=$(python3 -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
+        installed_hash=$(shasum -a 256 "$target" 2>/dev/null | cut -d' ' -f1)
+
+        if [ -n "$manifest_hash" ] && [ "$installed_hash" = "$manifest_hash" ]; then
+            # File matches original template → safe to update
+            return 0
+        fi
+
+        # File was customized (or not tracked) → skip
+        return 1
+    fi
+
+    # Default: skip existing
+    return 1
+}
+
+root_shared_inventory_available() {
+    [ -f "$GLOBAL_CODEX_DIR/config.toml" ] &&
+    [ -d "$GLOBAL_CODEX_DIR/agents" ] &&
+    [ -d "$GLOBAL_CODEX_DIR/prompts" ] &&
+    [ -d "$GLOBAL_CODEX_DIR/skills" ]
+}
+
+write_seed_file() {
+    local target="$1"
+    local key="$2"
+
+    case "$key" in
+        context/index.md)
+            cat <<'EOF' > "$target"
+# Context Index
+
+- `architecture.md` — system boundaries and major modules
+- `conventions.md` — coding and workflow norms for this repo
+- `current-priorities.md` — active goals and focus areas
+- `decision-log.md` — durable architecture decisions
+- `worklog.md` — session trail for the current project
+- `gotchas.md` — sharp edges and local footguns
+- `session-context.md` — compact session state that can survive compaction
+EOF
+            ;;
+        context/architecture.md)
+            cat <<'EOF' > "$target"
+# Architecture
+
+Document the main subsystems, boundaries, and critical flows for this project.
+
+## Modules
+
+- Fill in the primary packages/apps/services in this repo.
+
+## Notes
+
+- Record important architectural constraints here.
+EOF
+            ;;
+        context/conventions.md)
+            cat <<'EOF' > "$target"
+# Conventions
+
+Track coding norms, repository patterns, naming conventions, and workflow rules that matter for this project.
+
+## Coding
+
+- Add style, testing, and verification expectations here.
+EOF
+            ;;
+        context/current-priorities.md)
+            cat <<'EOF' > "$target"
+# Current Priorities
+
+- Capture the current milestones, blockers, and near-term goals for this project.
+EOF
+            ;;
+        context/decision-log.md)
+            cat <<'EOF' > "$target"
+# Decision Log
+
+Append durable architecture or workflow decisions here.
+
+## Decisions
+
+### Template
+
+### DLOG-001: Title
+
+- **Date**: YYYY-MM-DD
+- **Context**: Why the decision was needed
+- **Decision**: What was chosen
+- **Consequences**: Tradeoffs and follow-up implications
+EOF
+            ;;
+        context/worklog.md)
+            cat <<'EOF' > "$target"
+# Worklog
+
+> Session-level human-readable trail for this project. Add the newest entry near the top.
+
+---
+
+## Entries
+
+- No project-specific entries yet.
+EOF
+            ;;
+        context/gotchas.md)
+            cat <<'EOF' > "$target"
+# Gotchas
+
+- Record local edge cases, footguns, and operational caveats for this project.
+EOF
+            ;;
+        context/session-context.md)
+            cat <<'EOF' > "$target"
+# Session Context
+
+Use this file for compact session state that should survive context compaction.
+
+## Current Focus
+
+- None recorded.
+
+## Next Actions
+
+- None recorded.
+EOF
+            ;;
+        memory/README.md)
+            cat <<'EOF' > "$target"
+# Memory
+
+Codexkit stores durable project memory in markdown files under this directory.
+This directory is part of the repo-visible memory model, not a hidden semantic memory engine.
+
+## Canonical Boundaries
+
+- `project/` holds durable project facts, state, goals, roadmap, and gotchas.
+- `research/` holds deeper investigations that should stay inspectable in git.
+- `_templates/` holds starter templates for repeatable memory updates.
+
+The canonical stop point for pause/resume is `.codex/context/session-context.md`.
+If `memory/session-context.md` exists, treat it as a legacy compatibility file, not the primary home for new session checkpoints.
+EOF
+            ;;
+        memory/session-context.md)
+            cat <<'EOF' > "$target"
+# Session Context
+
+Legacy compatibility file only.
+
+Use `.codex/context/session-context.md` as the canonical stop point for pause/resume.
+Do not start writing new session checkpoints here unless a migration or compatibility workflow explicitly requires it.
+EOF
+            ;;
+        memory/project/user.md)
+            cat <<'EOF' > "$target"
+# User Memory
+
+## Preferences
+
+- Add collaboration preferences for this project's user here.
+
+## Workflow
+
+- Add workflow preferences or operating preferences here.
+EOF
+            ;;
+        memory/project/tech-stack.md)
+            cat <<'EOF' > "$target"
+# Tech Stack
+
+## Languages
+
+- Add primary implementation languages here.
+
+## Runtime
+
+- Add runtime and framework notes here.
+
+## Verification Commands
+
+- Add the main verification commands for this project here.
+EOF
+            ;;
+        memory/project/project.md)
+            cat <<'EOF' > "$target"
+# Project Memory
+
+## Vision
+
+- Describe the long-term purpose of this project.
+
+## Goals
+
+- List near-term and durable goals here.
+
+## Success Criteria
+
+- Define what “done” or “successful” looks like.
+EOF
+            ;;
+        memory/project/roadmap.md)
+            cat <<'EOF' > "$target"
+# Roadmap
+
+## Current Phase
+
+- Record the current delivery phase here.
+
+## Near-Term Milestones
+
+- List the next milestones here.
+
+## Backlog
+
+- Capture later improvements here.
+EOF
+            ;;
+        memory/project/state.md)
+            cat <<'EOF' > "$target"
+# State
+
+## Status
+
+- Record the current milestone and current operating state here.
+
+## Recent Completed Work
+
+- Summarize recently completed work here.
+
+## Active Decisions
+
+- Capture decisions currently steering implementation here.
+
+## Blockers
+
+- Record active blockers here.
+
+## Next Actions
+
+- Record the next durable actions here.
+EOF
+            ;;
+        memory/project/gotchas.md)
+            cat <<'EOF' > "$target"
+# Project Gotchas
+
+- Record project-specific edge cases and operational caveats here.
+EOF
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+install_seed_file() {
+    local target="$1"
+    local source_path="$2"
+    local seed_key="$3"
+
+    if should_copy "$target" "$source_path"; then
+        mkdir -p "$(dirname "$target")"
+        write_seed_file "$target" "$seed_key"
+        echo "  CREATED ${target#$PROJECT_DIR/}"
+    elif $UPGRADE; then
+        echo "  KEPT ${target#$PROJECT_DIR/} (customized)"
+    else
+        echo "  SKIP ${target#$PROJECT_DIR/} (exists)"
+    fi
+}
+
+echo "=== Codexkit Project Install ==="
+echo "  Target: $PROJECT_DIR"
+
+if $UPGRADE && [ ! -f "$MANIFEST" ] && ! $FORCE; then
+    echo "⚠ Upgrade checks unavailable (missing .template-manifest.json); existing files will be kept"
+fi
+
+# Verify git repo
+if ! git -C "$PROJECT_DIR" rev-parse --git-dir &> /dev/null; then
+    echo "✗ Not a git repository: $PROJECT_DIR"
+    exit 1
+fi
+
+# Root-first upgrade: refresh shared inventory before project-scoped files.
+ROOT_SHARED_AVAILABLE=false
+if root_shared_inventory_available; then
+    ROOT_SHARED_AVAILABLE=true
+fi
+
+if $UPGRADE && $ROOT_SHARED_AVAILABLE && ! $FULL_LOCAL; then
+    echo "  Shared inventory detected at $GLOBAL_CODEX_DIR"
+    echo "  Upgrading shared inventory first..."
+    HOME="$HOME" "$REPO_DIR/install/install-global.sh" --upgrade
+fi
+
+USE_SHARED_ROOT=false
+if $ROOT_SHARED_AVAILABLE && ! $FULL_LOCAL; then
+    USE_SHARED_ROOT=true
+    echo "  Shared inventory mode: reusing $GLOBAL_CODEX_DIR for profiles, agents, prompts, and skills"
+elif ! $FULL_LOCAL; then
+    echo "  Shared inventory mode unavailable: ~/.codex shared inventory not found"
+    echo "  Falling back to full local install for this project"
+fi
+
+if $USE_SHARED_ROOT; then
+    for legacy_dir in "$PROJECT_DIR/.codex/agents" "$PROJECT_DIR/.codex/prompts" "$PROJECT_DIR/.codex/skills" "$PROJECT_DIR/.agents/skills"; do
+        if [ -e "$legacy_dir" ]; then
+            echo "  KEPT $legacy_dir (legacy local shared inventory)"
+        fi
+    done
+fi
+
+# Create directory structure
+mkdir -p "$PROJECT_DIR/.codex"/{context,hooks,scripts,mcp,memory,plans}
+if ! $USE_SHARED_ROOT; then
+    mkdir -p "$PROJECT_DIR/.codex"/{agents,prompts,skills}
+    mkdir -p "$PROJECT_DIR/.agents"
+fi
+
+# Copy config template
+config_target="$PROJECT_DIR/.codex/config.toml"
+config_source="$REPO_DIR/templates/project/.codex-config-template.toml"
+config_source_path="templates/project/.codex-config-template.toml"
+if ! $USE_SHARED_ROOT; then
+    config_source="$REPO_DIR/.codex/config.toml"
+    config_source_path=".codex/config.toml"
+fi
+
+if $USE_SHARED_ROOT && [ -f "$config_target" ] && ! $FORCE; then
+    echo "  KEPT .codex/config.toml (existing project config)"
+elif should_copy "$config_target" "$config_source_path"; then
+    cp "$config_source" "$config_target"
+    echo "  CREATED .codex/config.toml"
+elif $UPGRADE; then
+    echo "  KEPT .codex/config.toml (customized)"
+else
+    echo "  SKIP .codex/config.toml (exists)"
+fi
+
+# Copy project metadata files
+for metadata in .env.example .version .template-manifest.json; do
+    source="$REPO_DIR/.codex/$metadata"
+    target="$PROJECT_DIR/.codex/$metadata"
+    source_path=".codex/$metadata"
+    [ -f "$source" ] || continue
+    if should_copy "$target" "$source_path"; then
+        cp "$source" "$target"
+        echo "  CREATED .codex/$metadata"
+    elif $UPGRADE; then
+        echo "  KEPT .codex/$metadata (customized)"
+    else
+        echo "  SKIP .codex/$metadata (exists)"
+    fi
+done
+
+# Copy AGENTS.md template
+agents_source="$REPO_DIR/templates/project/AGENTS.md.template"
+agents_target="$PROJECT_DIR/AGENTS.md"
+if should_copy "$agents_target" "templates/project/AGENTS.md.template"; then
+    cp "$agents_source" "$agents_target"
+    echo "  CREATED AGENTS.md"
+elif $UPGRADE; then
+    echo "  KEPT AGENTS.md (customized)"
+else
+    echo "  SKIP AGENTS.md (exists)"
+fi
+
+# Create neutral context docs for target projects
+for doc in index.md architecture.md conventions.md current-priorities.md decision-log.md worklog.md gotchas.md session-context.md; do
+    target="$PROJECT_DIR/.codex/context/$doc"
+    source_path=".codex/context/$doc"
+    install_seed_file "$target" "$source_path" "context/$doc"
+done
+
+# Copy agent role files when the project owns shared inventory locally.
+if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/agents" ]; then
+    for agent_file in "$REPO_DIR/.codex/agents"/*.toml; do
+        [ -f "$agent_file" ] || continue
+        target="$PROJECT_DIR/.codex/agents/$(basename "$agent_file")"
+        source_path=".codex/agents/$(basename "$agent_file")"
+        if should_copy "$target" "$source_path"; then
+            cp "$agent_file" "$target"
+            echo "  CREATED .codex/agents/$(basename "$agent_file")"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/agents/$(basename "$agent_file") (customized)"
+        else
+            echo "  SKIP .codex/agents/$(basename "$agent_file") (exists)"
+        fi
+    done
+fi
+
+# Copy prompt files when the project owns shared inventory locally.
+if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/prompts" ]; then
+    for prompt_file in "$REPO_DIR/.codex/prompts"/*.md; do
+        [ -f "$prompt_file" ] || continue
+        target="$PROJECT_DIR/.codex/prompts/$(basename "$prompt_file")"
+        source_path=".codex/prompts/$(basename "$prompt_file")"
+        if should_copy "$target" "$source_path"; then
+            cp "$prompt_file" "$target"
+            echo "  CREATED .codex/prompts/$(basename "$prompt_file")"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/prompts/$(basename "$prompt_file") (customized)"
+        else
+            echo "  SKIP .codex/prompts/$(basename "$prompt_file") (exists)"
+        fi
+    done
+fi
+
+# Copy hook scripts
+if [ -d "$REPO_DIR/.codex/hooks" ]; then
+    for hook_file in "$REPO_DIR/.codex/hooks"/*.sh; do
+        [ -f "$hook_file" ] || continue
+        target="$PROJECT_DIR/.codex/hooks/$(basename "$hook_file")"
+        source_path=".codex/hooks/$(basename "$hook_file")"
+        if should_copy "$target" "$source_path"; then
+            cp "$hook_file" "$target"
+            chmod +x "$target"
+            echo "  CREATED .codex/hooks/$(basename "$hook_file")"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/hooks/$(basename "$hook_file") (customized)"
+        else
+            echo "  SKIP .codex/hooks/$(basename "$hook_file") (exists)"
+        fi
+    done
+fi
+
+# Copy helper scripts
+if [ -d "$REPO_DIR/.codex/scripts" ]; then
+    for script_file in "$REPO_DIR/.codex/scripts"/*.sh; do
+        [ -f "$script_file" ] || continue
+        target="$PROJECT_DIR/.codex/scripts/$(basename "$script_file")"
+        source_path=".codex/scripts/$(basename "$script_file")"
+        if should_copy "$target" "$source_path"; then
+            cp "$script_file" "$target"
+            chmod +x "$target"
+            echo "  CREATED .codex/scripts/$(basename "$script_file")"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/scripts/$(basename "$script_file") (customized)"
+        else
+            echo "  SKIP .codex/scripts/$(basename "$script_file") (exists)"
+        fi
+    done
+fi
+
+# Copy skill files from canonical source when the project owns shared inventory locally.
+if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/skills" ]; then
+    while IFS= read -r skill_file; do
+        rel_path="${skill_file#$REPO_DIR/.codex/skills/}"
+        target="$PROJECT_DIR/.codex/skills/$rel_path"
+        source_path=".codex/skills/$rel_path"
+        mkdir -p "$(dirname "$target")"
+        if should_copy "$target" "$source_path"; then
+            cp "$skill_file" "$target"
+            echo "  CREATED .codex/skills/$rel_path"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/skills/$rel_path (customized)"
+        else
+            echo "  SKIP .codex/skills/$rel_path (exists)"
+        fi
+    done < <(find "$REPO_DIR/.codex/skills" -type f | sort)
+fi
+
+# Seed neutral memory files for target projects
+for rel_path in README.md session-context.md project/user.md project/tech-stack.md project/project.md project/roadmap.md project/state.md project/gotchas.md; do
+    target="$PROJECT_DIR/.codex/memory/$rel_path"
+    source_path=".codex/memory/$rel_path"
+    install_seed_file "$target" "$source_path" "memory/$rel_path"
+done
+
+if [ ! -d "$PROJECT_DIR/.codex/memory/research" ]; then
+    mkdir -p "$PROJECT_DIR/.codex/memory/research"
+    : > "$PROJECT_DIR/.codex/memory/research/.gitkeep"
+    echo "  CREATED .codex/memory/research/.gitkeep"
+fi
+
+if [ -d "$REPO_DIR/.codex/memory/_templates" ]; then
+    while IFS= read -r template_file; do
+        rel_path="${template_file#$REPO_DIR/.codex/memory/}"
+        target="$PROJECT_DIR/.codex/memory/$rel_path"
+        source_path=".codex/memory/$rel_path"
+        mkdir -p "$(dirname "$target")"
+        if should_copy "$target" "$source_path"; then
+            cp "$template_file" "$target"
+            echo "  CREATED .codex/memory/$rel_path"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/memory/$rel_path (customized)"
+        else
+            echo "  SKIP .codex/memory/$rel_path (exists)"
+        fi
+    done < <(find "$REPO_DIR/.codex/memory/_templates" -type f | sort)
+fi
+
+# Copy plan files
+if [ -d "$REPO_DIR/.codex/plans" ]; then
+    while IFS= read -r plan_file; do
+        rel_path="${plan_file#$REPO_DIR/.codex/plans/}"
+        target="$PROJECT_DIR/.codex/plans/$rel_path"
+        source_path=".codex/plans/$rel_path"
+        mkdir -p "$(dirname "$target")"
+        if should_copy "$target" "$source_path"; then
+            cp "$plan_file" "$target"
+            echo "  CREATED .codex/plans/$rel_path"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/plans/$rel_path (customized)"
+        else
+            echo "  SKIP .codex/plans/$rel_path (exists)"
+        fi
+    done < <(find "$REPO_DIR/.codex/plans" -type f | sort)
+fi
+
+# Copy MCP examples
+if [ -d "$REPO_DIR/.codex/mcp" ]; then
+    for mcp_file in "$REPO_DIR/.codex/mcp"/*; do
+        [ -f "$mcp_file" ] || continue
+        target="$PROJECT_DIR/.codex/mcp/$(basename "$mcp_file")"
+        source_path=".codex/mcp/$(basename "$mcp_file")"
+        if should_copy "$target" "$source_path"; then
+            cp "$mcp_file" "$target"
+            echo "  CREATED .codex/mcp/$(basename "$mcp_file")"
+        elif $UPGRADE; then
+            echo "  KEPT .codex/mcp/$(basename "$mcp_file") (customized)"
+        else
+            echo "  SKIP .codex/mcp/$(basename "$mcp_file") (exists)"
+        fi
+    done
+fi
+
+# Create .agents/skills symlink (Codex CLI discovery bridge) for self-contained installs.
+if ! $USE_SHARED_ROOT && [ ! -e "$PROJECT_DIR/.agents/skills" ]; then
+    ln -s ../.codex/skills "$PROJECT_DIR/.agents/skills"
+    echo "  CREATED .agents/skills → .codex/skills"
+elif ! $USE_SHARED_ROOT && [ -L "$PROJECT_DIR/.agents/skills" ]; then
+    echo "  KEPT .agents/skills symlink"
+elif ! $USE_SHARED_ROOT; then
+    echo "  KEPT .agents/skills directory"
+elif [ -e "$PROJECT_DIR/.agents/skills" ]; then
+    echo "  KEPT .agents/skills legacy bridge"
+fi
+
+# ─── Custom template overlay ────────────────────────────────────────────
+# If --template was specified, apply template files after base install
+if [ -n "$TEMPLATE_NAME" ]; then
+    TMPL_DIR="$CODEXKIT_HOME/templates/$TEMPLATE_NAME"
+    if [ ! -d "$TMPL_DIR" ]; then
+        echo "✗ Template '$TEMPLATE_NAME' not found at $TMPL_DIR"
+        echo "  Run: codexkit template list"
+        exit 1
+    fi
+    if [ ! -f "$TMPL_DIR/template.json" ]; then
+        echo "✗ Template '$TEMPLATE_NAME' missing template.json"
+        exit 1
+    fi
+
+    echo ""
+    echo "Applying template: $TEMPLATE_NAME"
+
+    # Collect variables from template.json and prompt user
+    if command -v python3 &>/dev/null; then
+        # Extract variable names and defaults
+        _var_json=$(python3 -c '
+import json, sys
+t = json.load(open(sys.argv[1]))
+vars = t.get("variables", {})
+for k, v in vars.items():
+    default = v.get("default", "") if isinstance(v, dict) else v
+    prompt_text = v.get("prompt", k) if isinstance(v, dict) else k
+    print(f"{k}|{default}|{prompt_text}")
+' "$TMPL_DIR/template.json" 2>/dev/null || echo "")
+
+        declare -A TMPL_VARS
+        while IFS='|' read -r var_name var_default var_prompt; do
+            [ -z "$var_name" ] && continue
+            if [ -t 0 ]; then
+                printf "  %s [%s]: " "$var_prompt" "$var_default"
+                read -r user_val
+                TMPL_VARS["$var_name"]="${user_val:-$var_default}"
+            else
+                TMPL_VARS["$var_name"]="$var_default"
+            fi
+        done <<< "$_var_json"
+    fi
+
+    # Run pre-install hook
+    if [ -f "$TMPL_DIR/hooks/pre-install.sh" ]; then
+        echo "  Running pre-install hook..."
+        (cd "$PROJECT_DIR" && bash "$TMPL_DIR/hooks/pre-install.sh")
+    fi
+
+    # Copy template files with variable substitution
+    if [ -d "$TMPL_DIR/files" ]; then
+        while IFS= read -r tmpl_file; do
+            rel_path="${tmpl_file#$TMPL_DIR/files/}"
+            target="$PROJECT_DIR/$rel_path"
+            mkdir -p "$(dirname "$target")"
+
+            if should_copy "$target" "template/$TEMPLATE_NAME/$rel_path"; then
+                cp "$tmpl_file" "$target"
+                # Apply variable substitution
+                if [ ${#TMPL_VARS[@]:-0} -gt 0 ]; then
+                    for var_name in "${!TMPL_VARS[@]}"; do
+                        sed -i '' "s|{{${var_name}}}|${TMPL_VARS[$var_name]}|g" "$target" 2>/dev/null || \
+                        sed -i "s|{{${var_name}}}|${TMPL_VARS[$var_name]}|g" "$target" 2>/dev/null || true
+                    done
+                fi
+                echo "  CREATED $rel_path (from template)"
+            else
+                echo "  SKIP $rel_path (exists)"
+            fi
+        done < <(find "$TMPL_DIR/files" -type f | sort)
+    fi
+
+    # Run post-install hook
+    if [ -f "$TMPL_DIR/hooks/post-install.sh" ]; then
+        echo "  Running post-install hook..."
+        (cd "$PROJECT_DIR" && bash "$TMPL_DIR/hooks/post-install.sh")
+    fi
+
+    echo "  ✓ Template '$TEMPLATE_NAME' applied"
+fi
+
+if $UPGRADE && $AUTO_APPLY_PATCHES; then
+    echo ""
+    echo "Applying saved Codexkit patches..."
+    CODEXKIT_PROJECT_DIR="$PROJECT_DIR" "$REPO_DIR/install/patch.sh" apply-all
+fi
+
+echo "✓ Project install complete"
+echo "  Structure:"
+echo "    AGENTS.md              (project root)"
+echo "    .codex/config.toml     (project config)"
+if $USE_SHARED_ROOT; then
+    echo "    ~/.codex/agents/       (shared agent roles)"
+    echo "    ~/.codex/prompts/      (shared workflow prompts)"
+    echo "    ~/.codex/skills/       (shared skills)"
+else
+    echo "    .codex/agents/         (agent roles)"
+    echo "    .codex/prompts/        (workflow prompts)"
+    echo "    .agents/skills/        (skills)"
+fi
+echo "    .codex/context/        (project knowledge)"
+echo "    .codex/memory/         (durable project memory)"
+echo ""
+echo "  Next: codex --profile explore \"Summarize this project\""