claudekit-codex-sync 0.1.0

package/scripts/export-claudekit-prompts.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+SRC_DIR="${CODEX_HOME}/claudekit/commands"
+DEST_DIR="${CODEX_HOME}/prompts"
+MANIFEST_NAME=".claudekit-generated-prompts.txt"
+PREFIX=""
+FORCE="false"
+DRY_RUN="false"
+INCLUDE_MCP="false"
+
+usage() {
+  cat <<'EOF'
+Export ClaudeKit commands into Codex custom prompts.
+
+Usage:
+  export-claudekit-prompts.sh [options]
+
+Options:
+  --source <dir>        Source commands directory (default: ~/.codex/claudekit/commands).
+  --dest <dir>          Prompt output directory (default: ~/.codex/prompts).
+  --prefix <value>      Prefix for generated prompt names (default: empty).
+  --force               Overwrite existing unmanaged prompt files on name collision.
+  --include-mcp         Include use-mcp.md (disabled by default).
+  --dry-run             Show planned changes without writing files.
+  -h, --help            Show this help.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --source)
+      shift
+      SRC_DIR="${1:-}"
+      ;;
+    --dest)
+      shift
+      DEST_DIR="${1:-}"
+      ;;
+    --prefix)
+      shift
+      PREFIX="${1:-}"
+      ;;
+    --force)
+      FORCE="true"
+      ;;
+    --include-mcp)
+      INCLUDE_MCP="true"
+      ;;
+    --dry-run)
+      DRY_RUN="true"
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+if [[ ! -d "$SRC_DIR" ]]; then
+  echo "Source directory not found: $SRC_DIR" >&2
+  exit 1
+fi
+
+MANIFEST="${DEST_DIR}/${MANIFEST_NAME}"
+declare -A previous_generated=()
+if [[ -f "$MANIFEST" ]]; then
+  while IFS= read -r line; do
+    [[ -n "$line" ]] && previous_generated["$line"]=1
+  done < "$MANIFEST"
+fi
+
+should_skip() {
+  local rel="$1"
+  local base
+  base="$(basename "$rel")"
+  if [[ "$base" == "codex-command-map.md" ]]; then
+    return 0
+  fi
+  if [[ "$base" == "use-mcp.md" && "$INCLUDE_MCP" != "true" ]]; then
+    return 0
+  fi
+  return 1
+}
+
+transform_content() {
+  sed \
+    -e 's#\$HOME/\.claude/skills/#${CODEX_HOME:-$HOME/.codex}/skills/#g' \
+    -e 's#\$HOME/\.claude/scripts/#${CODEX_HOME:-$HOME/.codex}/claudekit/scripts/#g' \
+    -e 's#\$HOME/\.claude/rules/#${CODEX_HOME:-$HOME/.codex}/claudekit/rules/#g' \
+    -e 's#\$HOME/\.claude/#${CODEX_HOME:-$HOME/.codex}/#g' \
+    -e 's#\./\.claude/skills/#~/.codex/skills/#g' \
+    -e 's#\.claude/skills/#~/.codex/skills/#g' \
+    -e 's#\./\.claude/scripts/#~/.codex/claudekit/scripts/#g' \
+    -e 's#\.claude/scripts/#~/.codex/claudekit/scripts/#g' \
+    -e 's#\./\.claude/rules/#~/.codex/claudekit/rules/#g' \
+    -e 's#\.claude/rules/#~/.codex/claudekit/rules/#g' \
+    -e 's#~/.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#\./\.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#\.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#\$HOME/\${CODEX_HOME:-\$HOME/\.codex}/#${CODEX_HOME:-$HOME/.codex}/#g'
+}
+
+build_prompt_file() {
+  local src="$1"
+  local rel="$2"
+  local out="$3"
+  local cmd_path
+  cmd_path="/${rel%.md}"
+  local transformed
+  transformed="$(mktemp /tmp/ck-prompt-content.XXXXXX)"
+  transform_content < "$src" > "$transformed"
+
+  if [[ "$(head -n 1 "$transformed")" == "---" ]]; then
+    cat "$transformed" > "$out"
+  else
+    {
+      echo "---"
+      echo "description: ClaudeKit compatibility prompt for ${cmd_path}"
+      echo "---"
+      echo
+      cat "$transformed"
+    } > "$out"
+  fi
+
+  rm -f "$transformed"
+}
+
+mapfile -t source_files < <(find "$SRC_DIR" -type f -name '*.md' | sort)
+if [[ ${#source_files[@]} -eq 0 ]]; then
+  echo "No markdown command files found in: $SRC_DIR" >&2
+  exit 1
+fi
+
+tmp_dir="$(mktemp -d /tmp/ck-prompts.XXXXXX)"
+cleanup() {
+  rm -rf "$tmp_dir"
+}
+trap cleanup EXIT
+
+if [[ "$DRY_RUN" != "true" ]]; then
+  mkdir -p "$DEST_DIR"
+fi
+
+declare -A generated=()
+added=0
+updated=0
+skipped=0
+collisions=0
+removed=0
+
+for src in "${source_files[@]}"; do
+  rel="${src#$SRC_DIR/}"
+  if should_skip "$rel"; then
+    skipped=$((skipped + 1))
+    echo "skip: $rel"
+    continue
+  fi
+
+  prompt_name="${rel%.md}"
+  prompt_name="${prompt_name//\//-}"
+  prompt_file="${PREFIX}${prompt_name}.md"
+  prompt_dest="${DEST_DIR}/${prompt_file}"
+  prompt_temp="${tmp_dir}/${prompt_file}"
+
+  build_prompt_file "$src" "$rel" "$prompt_temp"
+
+  if [[ -f "$prompt_dest" && -z "${previous_generated[$prompt_file]:-}" && "$FORCE" != "true" ]]; then
+    collisions=$((collisions + 1))
+    echo "skip(collision): $prompt_file"
+    continue
+  fi
+
+  if [[ -f "$prompt_dest" ]]; then
+    updated=$((updated + 1))
+    echo "update: $prompt_file <= $rel"
+  else
+    added=$((added + 1))
+    echo "add: $prompt_file <= $rel"
+  fi
+
+  generated["$prompt_file"]=1
+  if [[ "$DRY_RUN" != "true" ]]; then
+    install -m 0644 "$prompt_temp" "$prompt_dest"
+  fi
+done
+
+if [[ "$DRY_RUN" != "true" ]]; then
+  for old in "${!previous_generated[@]}"; do
+    if [[ -z "${generated[$old]:-}" ]]; then
+      stale_path="${DEST_DIR}/${old}"
+      if [[ -f "$stale_path" ]]; then
+        rm -f "$stale_path"
+        removed=$((removed + 1))
+        echo "remove(stale): $old"
+      fi
+    fi
+  done
+
+  {
+    for f in "${!generated[@]}"; do
+      echo "$f"
+    done
+  } | sort > "$MANIFEST"
+fi
+
+total_generated="${#generated[@]}"
+echo "source: $SRC_DIR"
+echo "dest: $DEST_DIR"
+echo "added=$added updated=$updated skipped=$skipped collisions=$collisions removed=$removed total_generated=$total_generated"
+
+if [[ "$DRY_RUN" == "true" ]]; then
+  echo "DRY_RUN=true (no files changed)"
+fi

package/scripts/normalize-claudekit-for-codex.sh

@@ -0,0 +1,261 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+SKILLS_DIR="${CODEX_HOME}/skills"
+CLAUDEKIT_DIR="${CODEX_HOME}/claudekit"
+DRY_RUN="false"
+INCLUDE_MCP="false"
+
+usage() {
+  cat <<'EOF'
+Re-apply Codex compatibility transforms after ClaudeKit sync.
+
+Usage:
+  normalize-claudekit-for-codex.sh [options]
+
+Options:
+  --include-mcp     Also normalize MCP skills/docs (disabled by default).
+  --dry-run         Show planned changes without writing files.
+  -h, --help        Show this help.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --include-mcp)
+      INCLUDE_MCP="true"
+      ;;
+    --dry-run)
+      DRY_RUN="true"
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+if [[ ! -d "$SKILLS_DIR" ]]; then
+  echo "Skills directory not found: $SKILLS_DIR" >&2
+  exit 1
+fi
+
+if [[ ! -d "$CLAUDEKIT_DIR" ]]; then
+  echo "ClaudeKit directory not found: $CLAUDEKIT_DIR" >&2
+  exit 1
+fi
+
+transform_file() {
+  local file="$1"
+  local tmp
+  tmp="$(mktemp /tmp/ck-normalize.XXXXXX)"
+
+  sed \
+    -e 's#\$HOME/\.claude/skills/#${CODEX_HOME:-$HOME/.codex}/skills/#g' \
+    -e 's#\$HOME/\.claude/scripts/#${CODEX_HOME:-$HOME/.codex}/claudekit/scripts/#g' \
+    -e 's#\$HOME/\.claude/rules/#${CODEX_HOME:-$HOME/.codex}/claudekit/rules/#g' \
+    -e 's#\$HOME/\.claude/#${CODEX_HOME:-$HOME/.codex}/#g' \
+    -e 's#\./\.claude/skills/#${CODEX_HOME:-$HOME/.codex}/skills/#g' \
+    -e 's#\.claude/skills/#${CODEX_HOME:-$HOME/.codex}/skills/#g' \
+    -e 's#\./\.claude/scripts/#${CODEX_HOME:-$HOME/.codex}/claudekit/scripts/#g' \
+    -e 's#\.claude/scripts/#${CODEX_HOME:-$HOME/.codex}/claudekit/scripts/#g' \
+    -e 's#\./\.claude/rules/#${CODEX_HOME:-$HOME/.codex}/claudekit/rules/#g' \
+    -e 's#\.claude/rules/#${CODEX_HOME:-$HOME/.codex}/claudekit/rules/#g' \
+    -e 's#~/.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#\./\.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#\.claude/.ck.json#~/.codex/claudekit/.ck.json#g' \
+    -e 's#~/.claude/#~/.codex/#g' \
+    -e 's#\./\.claude/#./.codex/#g' \
+    -e 's#<project>/.claude/#<project>/.codex/#g' \
+    -e 's#\.claude/#.codex/#g' \
+    -e 's#`\.claude`#`.codex`#g' \
+    -e 's#\$HOME/\${CODEX_HOME:-\$HOME/\.codex}/#${CODEX_HOME:-$HOME/.codex}/#g' \
+    "$file" > "$tmp"
+
+  if cmp -s "$file" "$tmp"; then
+    rm -f "$tmp"
+    return 1
+  fi
+
+  if [[ "$DRY_RUN" == "true" ]]; then
+    rm -f "$tmp"
+    return 0
+  fi
+
+  cp "$tmp" "$file"
+  rm -f "$tmp"
+  return 0
+}
+
+changed=0
+
+while IFS= read -r -d '' file; do
+  if [[ "$INCLUDE_MCP" != "true" && ( "$file" == *"/mcp-builder/"* || "$file" == *"/mcp-management/"* ) ]]; then
+    continue
+  fi
+  if transform_file "$file"; then
+    changed=$((changed + 1))
+    echo "normalize: ${file#$CODEX_HOME/}"
+  fi
+done < <(find "$SKILLS_DIR" -type f -name 'SKILL.md' -not -path '*/.system/*' -print0)
+
+while IFS= read -r -d '' file; do
+  if transform_file "$file"; then
+    changed=$((changed + 1))
+    echo "normalize: ${file#$CODEX_HOME/}"
+  fi
+done < <(find "$CLAUDEKIT_DIR" -type f -name '*.md' -print0)
+
+copywriting_script="${SKILLS_DIR}/copywriting/scripts/extract-writing-styles.py"
+if [[ -f "$copywriting_script" ]]; then
+  if [[ "$DRY_RUN" == "true" ]]; then
+    if ! grep -q "CODEX_HOME = Path(os.environ.get('CODEX_HOME'" "$copywriting_script"; then
+      echo "normalize: skills/copywriting/scripts/extract-writing-styles.py (patch pending)"
+      changed=$((changed + 1))
+    fi
+  else
+    patch_result="$(python3 - "$copywriting_script" <<'PY'
+import re
+import sys
+from pathlib import Path
+
+path = Path(sys.argv[1])
+text = path.read_text(encoding="utf-8")
+original = text
+needs_patch = "CODEX_HOME = Path(os.environ.get('CODEX_HOME'" not in text
+
+if needs_patch:
+    new_func = """def find_project_root(start_dir: Path) -> Path:
+    \"\"\"Find project root by preferring a directory that contains assets/writing-styles.\"\"\"
+    search_chain = [start_dir] + list(start_dir.parents)
+    for parent in search_chain:
+        if (parent / 'assets' / 'writing-styles').exists():
+            return parent
+    for parent in search_chain:
+        if (parent / 'SKILL.md').exists():
+            return parent
+    for parent in search_chain:
+        if (parent / '.codex').exists() or (parent / '.claude').exists():
+            return parent
+    return start_dir
+"""
+    text, func_count = re.subn(
+        r"def find_project_root\(start_dir: Path\) -> Path:\n(?:    .*\n)+?    return start_dir\n",
+        new_func,
+        text,
+        count=1,
+    )
+
+    new_block = """PROJECT_ROOT = find_project_root(Path(__file__).parent)
+STYLES_DIR = PROJECT_ROOT / 'assets' / 'writing-styles'
+CODEX_HOME = Path(os.environ.get('CODEX_HOME', str(Path.home() / '.codex')))
+
+_ai_multimodal_candidates = [
+    PROJECT_ROOT / '.claude' / 'skills' / 'ai-multimodal' / 'scripts',
+    CODEX_HOME / 'skills' / 'ai-multimodal' / 'scripts',
+]
+AI_MULTIMODAL_SCRIPTS = next((p for p in _ai_multimodal_candidates if p.exists()), _ai_multimodal_candidates[-1])
+"""
+    text, block_count = re.subn(
+        r"PROJECT_ROOT = find_project_root\(Path\(__file__\)\.parent\)\nSTYLES_DIR = PROJECT_ROOT / 'assets' / 'writing-styles'\nAI_MULTIMODAL_SCRIPTS = PROJECT_ROOT / '.claude' / 'skills' / 'ai-multimodal' / 'scripts'\n",
+        new_block,
+        text,
+        count=1,
+    )
+    if func_count == 0 or block_count == 0:
+        print("error:copywriting_patch_pattern_miss")
+        sys.exit(2)
+
+if text != original:
+    path.write_text(text, encoding="utf-8")
+    print("patched")
+else:
+    print("unchanged")
+PY
+)"
+    if [[ "$patch_result" == "patched" ]]; then
+      echo "normalize: skills/copywriting/scripts/extract-writing-styles.py"
+      changed=$((changed + 1))
+    fi
+  fi
+fi
+
+default_style="${SKILLS_DIR}/copywriting/assets/writing-styles/default.md"
+fallback_style="${SKILLS_DIR}/copywriting/references/writing-styles.md"
+if [[ ! -f "$default_style" && -f "$fallback_style" ]]; then
+  if [[ "$DRY_RUN" == "true" ]]; then
+    echo "add: skills/copywriting/assets/writing-styles/default.md"
+  else
+    mkdir -p "$(dirname "$default_style")"
+    cp "$fallback_style" "$default_style"
+    echo "add: skills/copywriting/assets/writing-styles/default.md"
+  fi
+  changed=$((changed + 1))
+fi
+
+map_file="${CLAUDEKIT_DIR}/commands/codex-command-map.md"
+if [[ ! -f "$map_file" ]]; then
+  if [[ "$DRY_RUN" == "true" ]]; then
+    echo "add: claudekit/commands/codex-command-map.md"
+  else
+    cat > "$map_file" <<'EOF'
+# ClaudeKit -> Codex Command Map
+
+## Covered by existing skills
+
+- `/preview` -> `markdown-novel-viewer`
+- `/kanban` -> `plans-kanban`
+- `/review/codebase` -> `code-review`
+- `/test`, `/test/ui` -> `web-testing`
+- `/worktree` -> `git`
+- `/plan/*` -> `plan`
+
+## Converted into bridge workflows
+
+- `/ck-help` -> `claudekit-command-bridge` (`resolve-command.py`)
+- `/coding-level` -> `claudekit-command-bridge` (depth rubric + output styles)
+- `/ask` -> `claudekit-command-bridge` (architecture mode)
+- `/docs/init`, `/docs/update`, `/docs/summarize` -> `claudekit-command-bridge`
+- `/journal`, `/watzup` -> `claudekit-command-bridge`
+
+## Explicitly excluded in this sync
+
+- `/use-mcp` (excluded per user request: no MCP sync)
+- Hooks (excluded per user request)
+
+## Custom Prompt Aliases (`/prompts:<name>`)
+
+- `/ask` -> `/prompts:ask`
+- `/ck-help` -> `/prompts:ck-help`
+- `/coding-level` -> `/prompts:coding-level`
+- `/docs/init` -> `/prompts:docs-init`
+- `/docs/summarize` -> `/prompts:docs-summarize`
+- `/docs/update` -> `/prompts:docs-update`
+- `/journal` -> `/prompts:journal`
+- `/kanban` -> `/prompts:kanban`
+- `/plan/archive` -> `/prompts:plan-archive`
+- `/plan/red-team` -> `/prompts:plan-red-team`
+- `/plan/validate` -> `/prompts:plan-validate`
+- `/preview` -> `/prompts:preview`
+- `/review/codebase` -> `/prompts:review-codebase`
+- `/review/codebase/parallel` -> `/prompts:review-codebase-parallel`
+- `/test` -> `/prompts:test`
+- `/test/ui` -> `/prompts:test-ui`
+- `/watzup` -> `/prompts:watzup`
+- `/worktree` -> `/prompts:worktree`
+EOF
+  fi
+  changed=$((changed + 1))
+fi
+
+echo "changed=$changed"
+if [[ "$DRY_RUN" == "true" ]]; then
+  echo "DRY_RUN=true (no files changed)"
+fi

package/src/claudekit_codex_sync/asset_sync_dir.py

@@ -0,0 +1,125 @@
+"""Asset and skill synchronization from live directory."""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+from typing import Dict
+
+from .constants import ASSET_DIRS, ASSET_FILES, CONFLICT_SKILLS, EXCLUDED_SKILLS_ALWAYS, MCP_SKILLS
+from .utils import is_excluded_path, write_bytes_if_changed
+
+
+def sync_assets_from_dir(
+    source: Path,
+    *,
+    codex_home: Path,
+    include_hooks: bool,
+    dry_run: bool,
+) -> Dict[str, int]:
+    """Sync non-skill assets from live directory."""
+    claudekit_dir = codex_home / "claudekit"
+    claudekit_dir.mkdir(parents=True, exist_ok=True)
+    added = updated = 0
+
+    for dirname in ASSET_DIRS:
+        src_dir = source / dirname
+        if not src_dir.exists():
+            continue
+        dst_dir = claudekit_dir / dirname
+        if not dry_run:
+            dst_dir.mkdir(parents=True, exist_ok=True)
+
+        for src_file in sorted(src_dir.rglob("*")):
+            if not src_file.is_file() or is_excluded_path(src_file.parts):
+                continue
+            rel = src_file.relative_to(src_dir)
+            dst = dst_dir / rel
+            data = src_file.read_bytes()
+            mode = src_file.stat().st_mode & 0o777 if src_file.stat().st_mode & 0o111 else None
+            changed, is_added = write_bytes_if_changed(dst, data, mode=mode, dry_run=dry_run)
+            if changed:
+                if is_added:
+                    added += 1
+                    print(f"add: claudekit/{dirname}/{rel}")
+                else:
+                    updated += 1
+                    print(f"update: claudekit/{dirname}/{rel}")
+
+    for filename in ASSET_FILES:
+        src = source / filename
+        if not src.exists():
+            continue
+        dst = claudekit_dir / filename
+        data = src.read_bytes()
+        mode = src.stat().st_mode & 0o777 if src.stat().st_mode & 0o111 else None
+        changed, is_added = write_bytes_if_changed(dst, data, mode=mode, dry_run=dry_run)
+        if changed:
+            if is_added:
+                added += 1
+                print(f"add: claudekit/{filename}")
+            else:
+                updated += 1
+                print(f"update: claudekit/{filename}")
+
+    return {"added": added, "updated": updated, "removed": 0, "managed_files": added + updated}
+
+
+def sync_skills_from_dir(
+    source: Path,
+    *,
+    codex_home: Path,
+    include_mcp: bool,
+    include_conflicts: bool,
+    dry_run: bool,
+) -> Dict[str, int]:
+    """Sync skills from live directory."""
+    skills_src = source / "skills"
+    skills_dst = codex_home / "skills"
+    added = updated = skipped = 0
+
+    if not skills_src.exists():
+        return {"added": 0, "updated": 0, "skipped": 0, "total_skills": 0}
+
+    for skill_dir in sorted(skills_src.iterdir()):
+        if not skill_dir.is_dir() or skill_dir.name.startswith("."):
+            continue
+        skill = skill_dir.name
+
+        if skill in EXCLUDED_SKILLS_ALWAYS:
+            skipped += 1
+            print(f"skip: {skill}")
+            continue
+        if not include_mcp and skill in MCP_SKILLS:
+            skipped += 1
+            print(f"skip: {skill}")
+            continue
+        if skill in CONFLICT_SKILLS:
+            skipped += 1
+            print(f"skip: {skill}")
+            continue
+        if not include_conflicts and (skills_dst / ".system" / skill).exists():
+            skipped += 1
+            print(f"skip: {skill}")
+            continue
+
+        dst = skills_dst / skill
+        exists = dst.exists()
+        if exists:
+            updated += 1
+            print(f"update: {skill}")
+        else:
+            added += 1
+            print(f"add: {skill}")
+
+        if dry_run:
+            continue
+
+        if exists:
+            shutil.rmtree(dst)
+        ignore = shutil.ignore_patterns("*.pyc", "__pycache__", ".venv", "node_modules", "dist", "build")
+        shutil.copytree(skill_dir, dst, ignore=ignore)
+
+    skills_dst.mkdir(parents=True, exist_ok=True)
+    total_skills = len(list(skills_dst.rglob("SKILL.md")))
+    return {"added": added, "updated": updated, "skipped": skipped, "total_skills": total_skills}