codexkit 1.0.0

package/install/install-remote.sh

@@ -0,0 +1,152 @@
+#!/bin/bash
+set -euo pipefail
+
+usage() {
+    cat <<'EOF'
+Codexkit remote installer
+
+Usage:
+  bash install/install-remote.sh [target-dir] [--force] [--upgrade]
+  bash install/install-remote.sh --archive /path/to/codexkit.tar.gz [target-dir]
+
+Options:
+  --global           Install global prompts/config into ~/.codex
+  --archive PATH     Install from a local tar.gz archive instead of GitHub
+  --repo SLUG        GitHub repo slug (default: QuangThai/codexkit)
+  --ref REF          Git ref, tag, or branch (default: main)
+  --force            Overwrite managed files
+  --upgrade          Only upgrade unmodified managed files
+  -h, --help         Show this help
+
+Notes:
+  - This repository may be private. Unauthenticated raw.githubusercontent.com usage is
+    not a reliable install path for private distribution.
+  - For private installs, prefer a local clone or an authenticated archive passed via
+    --archive.
+EOF
+}
+
+require_command() {
+    if ! command -v "$1" >/dev/null 2>&1; then
+        echo "✗ Missing required command: $1" >&2
+        exit 1
+    fi
+}
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+MODE="project"
+TARGET_DIR=""
+ARCHIVE_PATH=""
+REPO_SLUG="${CODEXKIT_REPO:-QuangThai/codexkit}"
+REF="${CODEXKIT_REF:-main}"
+FORCE=false
+UPGRADE=false
+TEMP_DIR=""
+
+cleanup() {
+    if [ -n "$TEMP_DIR" ] && [ -d "$TEMP_DIR" ]; then
+        rm -rf "$TEMP_DIR"
+    fi
+}
+trap cleanup EXIT
+
+while [ "$#" -gt 0 ]; do
+    case "$1" in
+        --global)
+            MODE="global"
+            ;;
+        --archive)
+            ARCHIVE_PATH="${2:-}"
+            shift
+            ;;
+        --repo)
+            REPO_SLUG="${2:-}"
+            shift
+            ;;
+        --ref)
+            REF="${2:-}"
+            shift
+            ;;
+        --force)
+            FORCE=true
+            ;;
+        --upgrade)
+            UPGRADE=true
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        *)
+            if [ -z "$TARGET_DIR" ]; then
+                TARGET_DIR="$1"
+            else
+                echo "✗ Unexpected argument: $1" >&2
+                usage >&2
+                exit 1
+            fi
+            ;;
+    esac
+    shift
+done
+
+if [ "$MODE" = "project" ]; then
+    TARGET_DIR="${TARGET_DIR:-$(pwd)}"
+fi
+
+require_command tar
+
+TEMP_DIR="$(mktemp -d)"
+EXTRACT_DIR="$TEMP_DIR/extracted"
+ARCHIVE_FILE="$TEMP_DIR/codexkit.tar.gz"
+mkdir -p "$EXTRACT_DIR"
+
+if [ -n "$ARCHIVE_PATH" ]; then
+    if [ ! -f "$ARCHIVE_PATH" ]; then
+        echo "✗ Archive not found: $ARCHIVE_PATH" >&2
+        exit 1
+    fi
+    cp "$ARCHIVE_PATH" "$ARCHIVE_FILE"
+else
+    DOWNLOAD_URL="https://codeload.github.com/${REPO_SLUG}/tar.gz/${REF}"
+    echo "Downloading Codexkit from $DOWNLOAD_URL"
+    if command -v curl >/dev/null 2>&1; then
+        curl -fsSL "$DOWNLOAD_URL" -o "$ARCHIVE_FILE"
+    elif command -v wget >/dev/null 2>&1; then
+        wget -qO "$ARCHIVE_FILE" "$DOWNLOAD_URL"
+    else
+        echo "✗ Missing downloader: install curl or wget" >&2
+        exit 1
+    fi
+fi
+
+tar -xzf "$ARCHIVE_FILE" -C "$EXTRACT_DIR"
+
+if [ -d "$EXTRACT_DIR/install" ]; then
+    EXTRACTED_REPO="$EXTRACT_DIR"
+else
+    EXTRACTED_REPO="$(find "$EXTRACT_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
+fi
+
+if [ -z "$EXTRACTED_REPO" ] || [ ! -d "$EXTRACTED_REPO/install" ]; then
+    echo "✗ Failed to extract a valid Codexkit archive" >&2
+    exit 1
+fi
+
+INSTALL_ARGS=()
+$FORCE && INSTALL_ARGS+=("--force")
+$UPGRADE && INSTALL_ARGS+=("--upgrade")
+
+if [ "$MODE" = "global" ]; then
+    if [ "${#INSTALL_ARGS[@]}" -gt 0 ]; then
+        "$EXTRACTED_REPO/install/install-global.sh" "${INSTALL_ARGS[@]}"
+    else
+        "$EXTRACTED_REPO/install/install-global.sh"
+    fi
+else
+    if [ "${#INSTALL_ARGS[@]}" -gt 0 ]; then
+        "$EXTRACTED_REPO/install/install-project.sh" "$TARGET_DIR" "${INSTALL_ARGS[@]}"
+    else
+        "$EXTRACTED_REPO/install/install-project.sh" "$TARGET_DIR"
+    fi
+fi

package/install/patch.sh

@@ -0,0 +1,478 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(dirname "$SCRIPT_DIR")"
+PROJECT_DIR="${CODEXKIT_PROJECT_DIR:-$(pwd)}"
+PATCHES_DIR="$PROJECT_DIR/Codexkit_patches"
+MANIFEST_FILE="$PROJECT_DIR/.codex/.template-manifest.json"
+[ -f "$MANIFEST_FILE" ] || MANIFEST_FILE="$PROJECT_DIR/.template-manifest.json"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+info()  { echo -e "${BLUE}ℹ${NC} $1"; }
+ok()    { echo -e "${GREEN}✓${NC} $1"; }
+warn()  { echo -e "${YELLOW}⚠${NC} $1"; }
+err()   { echo -e "${RED}✗${NC} $1" >&2; }
+
+usage() {
+    cat <<'EOF'
+codexkit patch
+
+Usage:
+  codexkit patch create "<name> - <description>"
+  codexkit patch list
+  codexkit patch apply <name>
+  codexkit patch apply-all
+  codexkit patch diff <name>
+  codexkit patch disable <name>
+EOF
+}
+
+require_project() {
+    if ! git -C "$PROJECT_DIR" rev-parse --git-dir >/dev/null 2>&1; then
+        err "Not a git repository: $PROJECT_DIR"
+        exit 1
+    fi
+    if [ ! -f "$MANIFEST_FILE" ]; then
+        err "Missing project manifest: .codex/.template-manifest.json"
+        exit 1
+    fi
+}
+
+slugify() {
+    python3 - "$1" <<'PY'
+import re
+import sys
+value = sys.argv[1].strip().lower()
+value = re.sub(r'[^a-z0-9]+', '-', value)
+value = re.sub(r'-{2,}', '-', value).strip('-')
+print(value or "patch")
+PY
+}
+
+split_patch_input() {
+    python3 - "$1" <<'PY'
+import sys
+raw = sys.argv[1].strip()
+if " - " in raw:
+    title, desc = raw.split(" - ", 1)
+else:
+    title, desc = raw, raw
+print(title.strip())
+print(desc.strip())
+PY
+}
+
+json_get() {
+    python3 - "$1" "$2" <<'PY'
+import json
+import sys
+data = json.load(open(sys.argv[1]))
+value = data
+for part in sys.argv[2].split('.'):
+    if isinstance(value, dict):
+        value = value.get(part)
+    else:
+        value = None
+        break
+if isinstance(value, bool):
+    print("true" if value else "false")
+elif value is None:
+    print("")
+else:
+    print(value)
+PY
+}
+
+metadata_update_enabled() {
+    python3 - "$1" "$2" <<'PY'
+import json
+import sys
+path = sys.argv[1]
+enabled = sys.argv[2].lower() == "true"
+with open(path) as fh:
+    data = json.load(fh)
+data["enabled"] = enabled
+with open(path, "w") as fh:
+    json.dump(data, fh, indent=2)
+    fh.write("\n")
+PY
+}
+
+manifest_hash_for() {
+    python3 - "$MANIFEST_FILE" "$1" <<'PY'
+import json
+import sys
+data = json.load(open(sys.argv[1]))
+print(data.get("files", {}).get(sys.argv[2], ""))
+PY
+}
+
+find_customized_pairs() {
+    python3 -c '
+import hashlib
+import json
+import os
+import sys
+
+manifest_path, project_dir = sys.argv[1:]
+manifest = json.load(open(manifest_path)).get("files", {})
+
+for raw in sys.stdin:
+    raw = raw.rstrip("\n")
+    if not raw:
+        continue
+    source_key, target_rel, source_abs = raw.split("\t")
+    manifest_hash = manifest.get(source_key)
+    if not manifest_hash:
+        continue
+    target_abs = os.path.join(project_dir, target_rel)
+    if not os.path.isfile(target_abs):
+        continue
+    hasher = hashlib.sha256()
+    with open(target_abs, "rb") as fh:
+        for chunk in iter(lambda: fh.read(65536), b""):
+            hasher.update(chunk)
+    if hasher.hexdigest() != manifest_hash:
+        print(raw)
+' "$MANIFEST_FILE" "$PROJECT_DIR"
+}
+
+project_version() {
+    if [ -f "$PROJECT_DIR/.codex/.version" ]; then
+        cat "$PROJECT_DIR/.codex/.version"
+    elif [ -f "$REPO_DIR/.codex/.version" ]; then
+        cat "$REPO_DIR/.codex/.version"
+    else
+        echo "unknown"
+    fi
+}
+
+project_uses_full_local_inventory() {
+    (
+        [ -d "$PROJECT_DIR/.codex/agents" ] &&
+        find "$PROJECT_DIR/.codex/agents" -maxdepth 1 -type f -name '*.toml' | grep -q .
+    ) || (
+        [ -d "$PROJECT_DIR/.codex/prompts" ] &&
+        find "$PROJECT_DIR/.codex/prompts" -maxdepth 1 -type f -name '*.md' | grep -q .
+    ) || (
+        [ -d "$PROJECT_DIR/.codex/skills" ] &&
+        find "$PROJECT_DIR/.codex/skills" -type f | grep -q .
+    ) || [ -e "$PROJECT_DIR/.agents/skills" ]
+}
+
+iter_managed_pairs() {
+    printf '%s\t%s\t%s\n' "templates/project/AGENTS.md.template" "AGENTS.md" "$REPO_DIR/templates/project/AGENTS.md.template"
+    if project_uses_full_local_inventory; then
+        printf '%s\t%s\t%s\n' ".codex/config.toml" ".codex/config.toml" "$REPO_DIR/.codex/config.toml"
+    else
+        printf '%s\t%s\t%s\n' "templates/project/.codex-config-template.toml" ".codex/config.toml" "$REPO_DIR/templates/project/.codex-config-template.toml"
+    fi
+
+    local rel
+    for rel in .codex/.env.example .codex/.version; do
+        [ -f "$REPO_DIR/$rel" ] && printf '%s\t%s\t%s\n' "$rel" "$rel" "$REPO_DIR/$rel"
+    done
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/agents" -type f -name '*.toml' | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/prompts" -type f -name '*.md' | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/hooks" -type f -name '*.sh' | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/scripts" -type f -name '*.sh' | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/skills" -type f | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/mcp" -type f | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/plans" -type f | sort)
+
+    while IFS= read -r file; do
+        rel="${file#$REPO_DIR/}"
+        printf '%s\t%s\t%s\n' "$rel" "$rel" "$file"
+    done < <(find "$REPO_DIR/.codex/memory/_templates" -type f | sort)
+}
+
+find_patch_dir() {
+    local name="$1"
+    if [ -d "$PATCHES_DIR/$name" ]; then
+        printf '%s\n' "$PATCHES_DIR/$name"
+        return 0
+    fi
+
+    local dir metadata patch_name
+    for dir in "$PATCHES_DIR"/*; do
+        [ -d "$dir" ] || continue
+        metadata="$dir/metadata.json"
+        [ -f "$metadata" ] || continue
+        patch_name="$(json_get "$metadata" "name")"
+        if [ "$patch_name" = "$name" ]; then
+            printf '%s\n' "$dir"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+cmd_create() {
+    local raw_name="${1:-}"
+    if [ -z "$raw_name" ]; then
+        err "Usage: codexkit patch create \"<name> - <description>\""
+        return 1
+    fi
+
+    require_project
+    mkdir -p "$PATCHES_DIR"
+
+    local split_output title description slug patch_dir patch_file metadata_file
+    split_output="$(split_patch_input "$raw_name")"
+    title="$(printf '%s\n' "$split_output" | sed -n '1p')"
+    description="$(printf '%s\n' "$split_output" | sed -n '2p')"
+    slug="$(slugify "$title")"
+    patch_dir="$PATCHES_DIR/$slug"
+    patch_file="$patch_dir/patch.patch"
+    metadata_file="$patch_dir/metadata.json"
+
+    mkdir -p "$patch_dir"
+
+    local tmp_patch
+    tmp_patch="$(mktemp)"
+    : > "$tmp_patch"
+
+    local file_count=0
+    local target_rel source_key source_abs target_abs
+    local target_files=()
+
+    while IFS=$'\t' read -r source_key target_rel source_abs; do
+        [ -f "$source_abs" ] || continue
+        target_abs="$PROJECT_DIR/$target_rel"
+        diff -u --label "a/$target_rel" --label "b/$target_rel" "$source_abs" "$target_abs" >> "$tmp_patch" || true
+        target_files+=("$target_rel")
+        file_count=$((file_count + 1))
+    done < <(iter_managed_pairs | find_customized_pairs)
+
+    if [ "$file_count" -eq 0 ]; then
+        rm -f "$tmp_patch"
+        err "No customized managed core files found"
+        return 1
+    fi
+
+    mv "$tmp_patch" "$patch_file"
+
+    python3 - "$metadata_file" "$slug" "$title" "$description" "$(project_version)" "$(date +%F)" "${target_files[@]}" <<'PY'
+import json
+import sys
+path, name, title, desc, version, created, *targets = sys.argv[1:]
+data = {
+    "name": name,
+    "title": title,
+    "description": desc,
+    "created": created,
+    "codexkit_version": version,
+    "enabled": True,
+    "target_files": targets,
+}
+with open(path, "w") as fh:
+    json.dump(data, fh, indent=2)
+    fh.write("\n")
+PY
+
+    ok "Created patch '$slug' with $file_count customized file(s)"
+    echo "  Path: $patch_dir"
+}
+
+cmd_list() {
+    require_project
+
+    if [ ! -d "$PATCHES_DIR" ]; then
+        info "No patches found"
+        return 0
+    fi
+
+    local found=false
+    local dir metadata name created enabled desc
+    for dir in "$PATCHES_DIR"/*; do
+        [ -d "$dir" ] || continue
+        metadata="$dir/metadata.json"
+        [ -f "$metadata" ] || continue
+        found=true
+        name="$(json_get "$metadata" "name")"
+        created="$(json_get "$metadata" "created")"
+        enabled="$(json_get "$metadata" "enabled")"
+        desc="$(json_get "$metadata" "description")"
+        printf '%-24s %-9s %s  %s\n' "$name" "$([ "$enabled" = "true" ] && echo enabled || echo disabled)" "$created" "$desc"
+    done | sort
+
+    if [ "$found" = false ]; then
+        info "No patches found"
+    fi
+}
+
+apply_patch_dir() {
+    local patch_dir="$1"
+    local allow_disabled="${2:-false}"
+    local metadata="$patch_dir/metadata.json"
+    local patch_file="$patch_dir/patch.patch"
+    local name enabled
+
+    [ -f "$metadata" ] || { err "Missing metadata: $metadata"; return 1; }
+    [ -f "$patch_file" ] || { err "Missing patch file: $patch_file"; return 1; }
+
+    name="$(json_get "$metadata" "name")"
+    enabled="$(json_get "$metadata" "enabled")"
+
+    if [ "$enabled" != "true" ] && [ "$allow_disabled" != "true" ]; then
+        info "Skipping disabled patch '$name'"
+        return 3
+    fi
+
+    if git -C "$PROJECT_DIR" apply --check "$patch_file" >/dev/null 2>&1; then
+        git -C "$PROJECT_DIR" apply "$patch_file"
+        ok "Applied patch '$name'"
+        return 0
+    fi
+
+    if git -C "$PROJECT_DIR" apply --reverse --check "$patch_file" >/dev/null 2>&1; then
+        info "Patch '$name' already applied"
+        return 2
+    fi
+
+    warn "Conflict while applying patch '$name'"
+    echo "  Patch: $patch_file"
+    return 1
+}
+
+cmd_apply() {
+    local name="${1:-}"
+    if [ -z "$name" ]; then
+        err "Usage: codexkit patch apply <name>"
+        return 1
+    fi
+
+    require_project
+
+    local patch_dir
+    if ! patch_dir="$(find_patch_dir "$name")"; then
+        err "Patch not found: $name"
+        return 1
+    fi
+
+    apply_patch_dir "$patch_dir" "true"
+}
+
+cmd_apply_all() {
+    require_project
+
+    if [ ! -d "$PATCHES_DIR" ]; then
+        info "No patches to apply"
+        return 0
+    fi
+
+    local dir
+    local applied=0
+    local skipped=0
+    local conflicts=0
+
+    for dir in "$PATCHES_DIR"/*; do
+        [ -d "$dir" ] || continue
+        if apply_patch_dir "$dir"; then
+            applied=$((applied + 1))
+        else
+            case "$?" in
+                2|3) skipped=$((skipped + 1)) ;;
+                *) conflicts=$((conflicts + 1)) ;;
+            esac
+        fi
+    done
+
+    echo "Patch summary: applied=$applied skipped=$skipped conflicts=$conflicts"
+
+    if [ "$conflicts" -gt 0 ]; then
+        return 1
+    fi
+}
+
+cmd_diff() {
+    local name="${1:-}"
+    if [ -z "$name" ]; then
+        err "Usage: codexkit patch diff <name>"
+        return 1
+    fi
+
+    require_project
+
+    local patch_dir
+    if ! patch_dir="$(find_patch_dir "$name")"; then
+        err "Patch not found: $name"
+        return 1
+    fi
+
+    cat "$patch_dir/patch.patch"
+}
+
+cmd_disable() {
+    local name="${1:-}"
+    if [ -z "$name" ]; then
+        err "Usage: codexkit patch disable <name>"
+        return 1
+    fi
+
+    require_project
+
+    local patch_dir
+    if ! patch_dir="$(find_patch_dir "$name")"; then
+        err "Patch not found: $name"
+        return 1
+    fi
+
+    metadata_update_enabled "$patch_dir/metadata.json" "false"
+    ok "Disabled patch '$name'"
+}
+
+COMMAND="${1:-help}"
+if [ "$#" -gt 0 ]; then
+    shift
+fi
+
+case "$COMMAND" in
+    create) cmd_create "$@" ;;
+    list) cmd_list "$@" ;;
+    apply) cmd_apply "$@" ;;
+    apply-all) cmd_apply_all "$@" ;;
+    diff) cmd_diff "$@" ;;
+    disable) cmd_disable "$@" ;;
+    help|--help|-h|"") usage ;;
+    *)
+        err "Unknown patch command: $COMMAND"
+        usage >&2
+        exit 1
+        ;;
+esac