codexkit 1.0.3 → 1.0.5

package/install/install-project.sh

@@ -8,6 +8,7 @@ REPO_DIR="$(dirname "$SCRIPT_DIR")"
 PROJECT_DIR=""
 FORCE=false
 UPGRADE=false
+VERBOSE=false
 TEMPLATE_NAME=""
 AUTO_APPLY_PATCHES=false
 FULL_LOCAL=false
@@ -15,6 +16,7 @@ for arg in "$@"; do
     case "$arg" in
         --force) FORCE=true ;;
         --upgrade) UPGRADE=true ;;
+        --verbose|-v) VERBOSE=true ;;
         --auto-apply-patches) AUTO_APPLY_PATCHES=true ;;
         --full-local) FULL_LOCAL=true ;;
         --template=*) TEMPLATE_NAME="${arg#--template=}" ;;
@@ -44,16 +46,23 @@ GLOBAL_CODEX_DIR="${HOME}/.codex"
 MANIFEST="$REPO_DIR/.codex/.template-manifest.json"
 [ -f "$MANIFEST" ] || MANIFEST="$REPO_DIR/.template-manifest.json"
 
-should_copy() {
+# Counters for install summary
+_count_created=0
+_count_upgraded=0
+_count_kept=0
+_count_skipped=0
+
+# Returns: 0 = new file, 1 = skip (customized/exists), 2 = safe to upgrade (unchanged from template)
+check_copy_action() {
     local target="$1"
     local source_path="$2"
     local manifest_hash installed_hash
 
-    # New file → always copy
+    # New file
     [ ! -f "$target" ] && return 0
 
-    # Force → always copy
-    $FORCE && return 0
+    # Force → treat as upgrade
+    $FORCE && return 2
 
     # Upgrade mode → check if customized
     if $UPGRADE && [ -f "$MANIFEST" ]; then
@@ -61,8 +70,8 @@ should_copy() {
         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
+            # File matches original template → safe to upgrade
+            return 2
         fi
 
         # File was customized (or not tracked) → skip
@@ -73,6 +82,149 @@ should_copy() {
     return 1
 }
 
+# Backward-compatible wrapper (returns 0 for both new and upgrade)
+should_copy() {
+    local rc=0
+    check_copy_action "$1" "$2" || rc=$?
+    [ "$rc" -ne 1 ]
+}
+
+# Log and count a file operation. Usage: log_file_op <display_path> <action>
+# action: created | upgraded | kept | skipped
+log_file_op() {
+    local display_path="$1"
+    local action="$2"
+    case "$action" in
+        created)
+            if $VERBOSE; then echo "  CREATED  $display_path"; fi
+            _count_created=$((_count_created + 1))
+            ;;
+        upgraded)
+            if $VERBOSE; then echo "  UPGRADED $display_path"; fi
+            _count_upgraded=$((_count_upgraded + 1))
+            ;;
+        kept)
+            if $VERBOSE; then echo "  KEPT     $display_path (customized)"; fi
+            _count_kept=$((_count_kept + 1))
+            ;;
+        skipped)
+            if $VERBOSE; then echo "  SKIP     $display_path (exists)"; fi
+            _count_skipped=$((_count_skipped + 1))
+            ;;
+    esac
+}
+
+# Determine action label for a file copy operation
+copy_and_log() {
+    local target="$1"
+    local source="$2"
+    local source_path="$3"
+    local display_path="$4"
+    local rc=0
+
+    check_copy_action "$target" "$source_path" || rc=$?
+
+    if [ "$rc" -eq 0 ]; then
+        cp "$source" "$target"
+        log_file_op "$display_path" "created"
+    elif [ "$rc" -eq 2 ]; then
+        cp "$source" "$target"
+        log_file_op "$display_path" "upgraded"
+    elif $UPGRADE; then
+        log_file_op "$display_path" "kept"
+    else
+        log_file_op "$display_path" "skipped"
+    fi
+}
+
+print_version_comparison() {
+    local installed_version latest_version
+    latest_version=""
+    installed_version=""
+
+    # Latest version from codexkit source
+    if [ -f "$REPO_DIR/.codex/.version" ]; then
+        latest_version=$(cat "$REPO_DIR/.codex/.version" 2>/dev/null | tr -d '[:space:]')
+    fi
+
+    # Installed version from target project
+    if [ -f "$PROJECT_DIR/.codex/.version" ]; then
+        installed_version=$(cat "$PROJECT_DIR/.codex/.version" 2>/dev/null | tr -d '[:space:]')
+    fi
+
+    if [ -n "$installed_version" ] && [ -n "$latest_version" ]; then
+        if [ "$installed_version" = "$latest_version" ]; then
+            echo "  Version: $latest_version (up to date)"
+        else
+            echo "  Version: $installed_version → $latest_version"
+        fi
+    elif [ -n "$latest_version" ]; then
+        echo "  Version: $latest_version (fresh install)"
+    fi
+}
+
+detect_orphans() {
+    local project_codex="$PROJECT_DIR/.codex"
+    local orphan_count=0
+    local rel_path=""
+    local manifest_file=""
+
+    [ -f "$MANIFEST" ] || return 0
+    [ -d "$project_codex" ] || return 0
+
+    # Write manifest keys to a temp file for O(1) lookup via grep -Fxf
+    manifest_file=$(mktemp)
+    python3 -c '
+import json, sys
+d = json.load(open(sys.argv[1]))
+for k in sorted(d.get("files", {}).keys()):
+    print(k)
+' "$MANIFEST" > "$manifest_file" 2>/dev/null || true
+
+    if [ ! -s "$manifest_file" ]; then
+        rm -f "$manifest_file"
+        return 0
+    fi
+
+    # Scan project .codex for files not in manifest
+    # Exclude user-owned directories: context/, memory/project/, plans/
+    while IFS= read -r file; do
+        rel_path="${file#$PROJECT_DIR/}"
+        # Skip user-owned content
+        case "$rel_path" in
+            .codex/context/*|.codex/memory/project/*|.codex/memory/research/*|.codex/plans/*) continue ;;
+            .codex/.env|.codex/.env.*) continue ;;
+        esac
+        if ! grep -qxF "$rel_path" "$manifest_file"; then
+            orphan_count=$((orphan_count + 1))
+            if $VERBOSE; then echo "  ORPHAN   $rel_path"; fi
+        fi
+    done < <(find "$project_codex" -type f ! -name '.gitkeep' 2>/dev/null | sort)
+
+    rm -f "$manifest_file"
+
+    if [ "$orphan_count" -gt 0 ]; then
+        echo "  ○ $orphan_count orphan file(s) not in template"
+    fi
+}
+
+print_summary() {
+    echo ""
+    local parts=()
+    [ "$_count_created" -gt 0 ] && parts+=("◆ Created $_count_created new files")
+    [ "$_count_upgraded" -gt 0 ] && parts+=("◆ Upgraded $_count_upgraded files")
+    [ "$_count_kept" -gt 0 ] && parts+=("● Preserved $_count_kept customized files")
+    [ "$_count_skipped" -gt 0 ] && parts+=("○ Skipped $_count_skipped existing files")
+
+    for part in "${parts[@]+"${parts[@]}"}"; do
+        echo "  $part"
+    done
+
+    if $UPGRADE; then
+        detect_orphans
+    fi
+}
+
 root_shared_inventory_available() {
     [ -f "$GLOBAL_CODEX_DIR/config.toml" ] &&
     [ -d "$GLOBAL_CODEX_DIR/agents" ] &&
@@ -95,19 +247,19 @@ bootstrap_user_prompt_discovery() {
 
         if should_copy "$target" "$source_path"; then
             cp "$prompt_file" "$target"
-            echo "  BOOTSTRAPPED ~/.codex/prompts/$(basename "$prompt_file")"
+            if $VERBOSE; then echo "  BOOTSTRAPPED ~/.codex/prompts/$(basename "$prompt_file")"; fi
             copied=$((copied + 1))
         elif $UPGRADE; then
-            echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file") (customized)"
+            if $VERBOSE; then echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file") (customized)"; fi
         else
-            echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file")"
+            if $VERBOSE; then echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file")"; fi
         fi
     done
 
     if [ "$copied" -gt 0 ]; then
-        echo "  Prompt discovery bootstrap: synced $copied prompt files into ~/.codex/prompts"
+        if $VERBOSE; then echo "  Prompt discovery bootstrap: synced $copied prompt files into ~/.codex/prompts"; fi
     else
-        echo "  Prompt discovery bootstrap: ~/.codex/prompts already ready"
+        if $VERBOSE; then echo "  Prompt discovery bootstrap: ~/.codex/prompts already ready"; fi
     fi
 }
 
@@ -348,23 +500,32 @@ install_seed_file() {
     local target="$1"
     local source_path="$2"
     local seed_key="$3"
+    local display_path="${target#$PROJECT_DIR/}"
+    local rc=0
+
+    check_copy_action "$target" "$source_path" || rc=$?
 
-    if should_copy "$target" "$source_path"; then
+    if [ "$rc" -eq 0 ]; then
         mkdir -p "$(dirname "$target")"
         write_seed_file "$target" "$seed_key"
-        echo "  CREATED ${target#$PROJECT_DIR/}"
+        log_file_op "$display_path" "created"
+    elif [ "$rc" -eq 2 ]; then
+        mkdir -p "$(dirname "$target")"
+        write_seed_file "$target" "$seed_key"
+        log_file_op "$display_path" "upgraded"
     elif $UPGRADE; then
-        echo "  KEPT ${target#$PROJECT_DIR/} (customized)"
+        log_file_op "$display_path" "kept"
     else
-        echo "  SKIP ${target#$PROJECT_DIR/} (exists)"
+        log_file_op "$display_path" "skipped"
     fi
 }
 
 echo "=== Codexkit Project Install ==="
 echo "  Target: $PROJECT_DIR"
+print_version_comparison
 
 if $UPGRADE && [ ! -f "$MANIFEST" ] && ! $FORCE; then
-    echo "⚠ Upgrade checks unavailable (missing .template-manifest.json); existing files will be kept"
+    echo "  ⚠ Upgrade checks unavailable (missing .template-manifest.json); existing files will be kept"
 fi
 
 # Verify git repo
@@ -380,30 +541,30 @@ if root_shared_inventory_available; then
 fi
 
 if $UPGRADE && $ROOT_SHARED_AVAILABLE && ! $FULL_LOCAL; then
-    echo "  Shared inventory detected at $GLOBAL_CODEX_DIR"
-    echo "  Upgrading shared inventory first..."
+    if $VERBOSE; then echo "  Shared inventory detected at $GLOBAL_CODEX_DIR"; fi
+    if $VERBOSE; then echo "  Upgrading shared inventory first..."; fi
     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"
+    if $VERBOSE; then echo "  Shared inventory mode: reusing $GLOBAL_CODEX_DIR for profiles, agents, prompts, and skills"; fi
 elif ! $FULL_LOCAL; then
-    echo "  Shared inventory mode unavailable: ~/.codex shared inventory not found"
-    echo "  Falling back to full local install for this project"
+    if $VERBOSE; then echo "  Shared inventory mode unavailable: ~/.codex shared inventory not found"; fi
+    if $VERBOSE; then echo "  Falling back to full local install for this project"; fi
 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"; do
         if [ -e "$legacy_dir" ]; then
-            echo "  KEPT $legacy_dir (legacy local shared inventory)"
+            if $VERBOSE; then echo "  KEPT $legacy_dir (legacy local shared inventory)"; fi
         fi
     done
 fi
 
 # Create directory structure
-mkdir -p "$PROJECT_DIR/.codex"/{context,hooks,scripts,mcp,memory,plans}
+mkdir -p "$PROJECT_DIR/.codex"/{context,context/archive,hooks,scripts,mcp,memory,plans}
 if ! $USE_SHARED_ROOT; then
     mkdir -p "$PROJECT_DIR/.codex"/{agents,prompts,skills}
 fi
@@ -418,14 +579,9 @@ if ! $USE_SHARED_ROOT; then
 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)"
+    log_file_op ".codex/config.toml" "kept"
 else
-    echo "  SKIP .codex/config.toml (exists)"
+    copy_and_log "$config_target" "$config_source" "$config_source_path" ".codex/config.toml"
 fi
 
 # Copy project metadata files
@@ -434,27 +590,13 @@ for metadata in .env.example .version .template-manifest.json; do
     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
+    copy_and_log "$target" "$source" "$source_path" ".codex/$metadata"
 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
+copy_and_log "$agents_target" "$agents_source" "templates/project/AGENTS.md.template" "AGENTS.md"
 
 # 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
@@ -463,20 +605,19 @@ for doc in index.md architecture.md conventions.md current-priorities.md decisio
     install_seed_file "$target" "$source_path" "context/$doc"
 done
 
+# Ensure archive directory has a .gitkeep
+if [ ! -f "$PROJECT_DIR/.codex/context/archive/.gitkeep" ]; then
+    : > "$PROJECT_DIR/.codex/context/archive/.gitkeep"
+    log_file_op ".codex/context/archive/.gitkeep" "created"
+fi
+
 # 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
+        copy_and_log "$target" "$agent_file" "$source_path" ".codex/agents/$(basename "$agent_file")"
     done
 fi
 
@@ -486,14 +627,7 @@ if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/prompts" ]; then
         [ -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
+        copy_and_log "$target" "$prompt_file" "$source_path" ".codex/prompts/$(basename "$prompt_file")"
     done
 fi
 
@@ -507,15 +641,8 @@ if [ -d "$REPO_DIR/.codex/hooks" ]; then
         [ -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
+        copy_and_log "$target" "$hook_file" "$source_path" ".codex/hooks/$(basename "$hook_file")"
+        [ -f "$target" ] && chmod +x "$target"
     done
 fi
 
@@ -525,15 +652,8 @@ if [ -d "$REPO_DIR/.codex/scripts" ]; then
         [ -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
+        copy_and_log "$target" "$script_file" "$source_path" ".codex/scripts/$(basename "$script_file")"
+        [ -f "$target" ] && chmod +x "$target"
     done
 fi
 
@@ -544,19 +664,12 @@ if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/skills" ]; then
         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
+        copy_and_log "$target" "$skill_file" "$source_path" ".codex/skills/$rel_path"
     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
+for rel_path in README.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"
@@ -565,7 +678,7 @@ 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"
+    log_file_op ".codex/memory/research/.gitkeep" "created"
 fi
 
 if [ -d "$REPO_DIR/.codex/memory/_templates" ]; then
@@ -574,14 +687,7 @@ if [ -d "$REPO_DIR/.codex/memory/_templates" ]; then
         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
+        copy_and_log "$target" "$template_file" "$source_path" ".codex/memory/$rel_path"
     done < <(find "$REPO_DIR/.codex/memory/_templates" -type f | sort)
 fi
 
@@ -592,14 +698,7 @@ if [ -d "$REPO_DIR/.codex/plans" ]; then
         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
+        copy_and_log "$target" "$plan_file" "$source_path" ".codex/plans/$rel_path"
     done < <(find "$REPO_DIR/.codex/plans" -type f | sort)
 fi
 
@@ -609,19 +708,12 @@ if [ -d "$REPO_DIR/.codex/mcp" ]; then
         [ -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
+        copy_and_log "$target" "$mcp_file" "$source_path" ".codex/mcp/$(basename "$mcp_file")"
     done
 fi
 
 if [ -e "$PROJECT_DIR/.agents" ]; then
-    echo "  KEPT .agents (legacy compatibility path)"
+    if $VERBOSE; then echo "  KEPT .agents (legacy compatibility path)"; fi
 fi
 
 # ─── Custom template overlay ────────────────────────────────────────────
@@ -689,9 +781,9 @@ for k, v in vars.items():
                         sed -i "s|{{${var_name}}}|${TMPL_VARS[$var_name]}|g" "$target" 2>/dev/null || true
                     done
                 fi
-                echo "  CREATED $rel_path (from template)"
+                log_file_op "$rel_path" "created"
             else
-                echo "  SKIP $rel_path (exists)"
+                log_file_op "$rel_path" "skipped"
             fi
         done < <(find "$TMPL_DIR/files" -type f | sort)
     fi
@@ -711,6 +803,8 @@ if $UPGRADE && $AUTO_APPLY_PATCHES; then
     CODEXKIT_PROJECT_DIR="$PROJECT_DIR" "$REPO_DIR/install/patch.sh" apply-all
 fi
 
+print_summary
+echo ""
 echo "✓ Project install complete"
 echo "  Structure:"
 echo "    AGENTS.md              (project root)"

package/install/validate.sh

@@ -430,7 +430,7 @@ done
 # ─── Memory ──────────────────────────────────────────────────────
 echo ""
 echo "Memory:"
-for doc 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
+for doc in README.md project/user.md project/tech-stack.md project/project.md project/roadmap.md project/state.md project/gotchas.md; do
     if [ -f ".codex/memory/$doc" ]; then
         check ".codex/memory/$doc" "pass"
     else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexkit",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Professional configuration kit for OpenAI Codex CLI",
   "license": "MIT",
   "keywords": [
@@ -11,7 +11,7 @@
     "installer"
   ],
   "bin": {
-    "codexkit": "bin/codexkit"
+    "codexkit": "bin/codexkit.js"
   },
   "files": [
     "bin",