@jetrabbits/agentic 0.0.5 → 0.2.0

package/agentic

@@ -15,7 +15,7 @@ APP_REPO_LINK="https://github.com/sawrus/agent-guides"
 PROJECT_MANIFEST_NAME=".agentic.json"
 
 DEFAULT_AGENT_OS="default"
-STATIC_AGENT_OS=(default opencode codex claude antigravity cursor agents)
+STATIC_AGENT_OS=(opencode codex claude antigravity cursor kilocode)
 INSTALL_DIRS=(rules skills workflows prompts)
 THEME_CHOICES=(auto dark light)
 
@@ -55,6 +55,12 @@ SKIPPED_MANAGED_PATHS=()
 WARNINGS=()
 
 CONTEXT7_API_KEY="${CONTEXT7_API_KEY:-}"
+AGENTIC_ENABLE_CONTEXT7="${AGENTIC_ENABLE_CONTEXT7:-}"
+AGENTIC_DOCTOR="${AGENTIC_DOCTOR:-1}"
+AGENTIC_DOCTOR_KEEP_TMP="${AGENTIC_DOCTOR_KEEP_TMP:-0}"
+
+RUN_LOG_ACTIVE=false
+RUN_LOG_FILE=""
 
 COLOR_RESET=""
 COLOR_HEADER=""
@@ -67,7 +73,7 @@ FZF_COLOR_ARGS=()
 
 usage() {
   cat <<USAGE
-$APP_TITLE
+$APP_TITLE $(app_version_label)
 
 Usage:
   $SCRIPT_NAME list [agentos|areas|specs --area <name>]
@@ -75,6 +81,7 @@ Usage:
   $SCRIPT_NAME tui [--theme auto|dark|light]
   $SCRIPT_NAME upgrade
   $SCRIPT_NAME self-install [--bin-dir <dir>] [--force] [--install-fzf] [--dry-run]
+  $SCRIPT_NAME --version
 
 Behavior:
   - No arguments in interactive terminal: runs TUI mode
@@ -87,11 +94,13 @@ Options:
   --areas               Comma-separated area list (example: software)
   --specializations     Comma-separated specializations in area.spec format (example: software.backend,software.frontend)
   --theme               Interface theme: auto|dark|light (default: config value or auto)
+  --no-doctor           Skip real agent smoke checks after install
   --bin-dir             Installation directory for self-install (default: ~/.local/bin)
   --force               Overwrite existing binary for self-install
   --install-fzf         During self-install, try to auto-install fzf (optional)
   --dry-run             Show actions without writing files
   -h, --help            Show this help
+  -V, --version         Show agentic version
 
 Examples:
   $SCRIPT_NAME list agentos
@@ -102,6 +111,31 @@ Examples:
 USAGE
 }
 
+read_package_version() {
+  local package_file="$1"
+  [[ -f "$package_file" ]] || return 1
+
+  sed -n 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$package_file" | head -n 1
+}
+
+app_version() {
+  local version=""
+  local candidate
+  for candidate in "$SCRIPT_DIR/package.json" "$REPO_ROOT/package.json" "$APP_REPO_DIR/package.json"; do
+    [[ -n "$candidate" ]] || continue
+    version="$(read_package_version "$candidate" || true)"
+    if [[ -n "$version" ]]; then
+      printf '%s\n' "$version"
+      return
+    fi
+  done
+  printf 'unknown\n'
+}
+
+app_version_label() {
+  printf 'v%s\n' "$(app_version)"
+}
+
 is_interactive_terminal() {
   if [[ "${AGENTIC_FORCE_INTERACTIVE:-${AGENTOS_FORCE_INTERACTIVE:-}}" == "1" ]]; then
     return 0
@@ -217,16 +251,116 @@ set_theme_colors() {
 }
 
 log() {
-  printf '%s[agentic]%s %s\n' "$COLOR_INFO" "$COLOR_RESET" "$1"
+  emit_log_line stdout "[agentic]" "$1" "$COLOR_INFO"
 }
 
 warn() {
-  printf '%s[agentic][warn]%s %s\n' "$COLOR_WARN" "$COLOR_RESET" "$1"
+  emit_log_line stdout "[agentic][warn]" "$1" "$COLOR_WARN"
   WARNINGS+=("$1")
 }
 
 error() {
-  printf '%s[agentic][error]%s %s\n' "$COLOR_ERROR" "$COLOR_RESET" "$1" >&2
+  emit_log_line stderr "[agentic][error]" "$1" "$COLOR_ERROR"
+}
+
+timestamp_now() {
+  date '+%Y-%m-%d %H:%M:%S'
+}
+
+init_run_logging() {
+  if [[ "$RUN_LOG_ACTIVE" == true ]]; then
+    return
+  fi
+
+  local base_dir="${TMPDIR:-/tmp}"
+  local stamp
+  stamp="$(date '+%Y%m%d-%H%M%S')"
+  RUN_LOG_FILE="$(mktemp "$base_dir/agentic-$stamp.XXXXXX")"
+  RUN_LOG_ACTIVE=true
+  log "Run log initialized: $RUN_LOG_FILE"
+}
+
+write_run_log_line() {
+  local line="$1"
+  if [[ "$RUN_LOG_ACTIVE" == true && -n "$RUN_LOG_FILE" ]]; then
+    printf '%s\n' "$line" >> "$RUN_LOG_FILE"
+  fi
+}
+
+emit_log_line() {
+  local stream="$1"
+  local tag="$2"
+  local message="$3"
+  local color="${4:-}"
+
+  local line plain_line ts
+  if [[ "$RUN_LOG_ACTIVE" == true ]]; then
+    ts="$(timestamp_now)"
+    plain_line="$ts $tag $message"
+    if [[ -n "$color" ]]; then
+      line="$ts ${color}${tag}${COLOR_RESET} $message"
+    else
+      line="$plain_line"
+    fi
+  else
+    plain_line="$tag $message"
+    if [[ -n "$color" ]]; then
+      line="${color}${tag}${COLOR_RESET} $message"
+    else
+      line="$plain_line"
+    fi
+  fi
+
+  if [[ "$stream" == "stderr" ]]; then
+    printf '%s\n' "$line" >&2
+  else
+    printf '%s\n' "$line"
+  fi
+  write_run_log_line "$plain_line"
+}
+
+out() {
+  local message="${1:-}"
+  local color="${2:-}"
+  local line plain_line ts
+
+  if [[ -z "$message" ]]; then
+    printf '\n'
+    write_run_log_line ""
+    return
+  fi
+
+  if [[ "$RUN_LOG_ACTIVE" == true ]]; then
+    ts="$(timestamp_now)"
+    plain_line="$ts $message"
+    if [[ -n "$color" ]]; then
+      line="$ts ${color}${message}${COLOR_RESET}"
+    else
+      line="$plain_line"
+    fi
+  else
+    plain_line="$message"
+    if [[ -n "$color" ]]; then
+      line="${color}${message}${COLOR_RESET}"
+    else
+      line="$plain_line"
+    fi
+  fi
+
+  printf '%s\n' "$line"
+  write_run_log_line "$plain_line"
+}
+
+log_file_block() {
+  local label="$1"
+  local path="$2"
+  [[ "$RUN_LOG_ACTIVE" == true && -n "$RUN_LOG_FILE" && -f "$path" ]] || return 0
+
+  write_run_log_line "$(timestamp_now) --- $label output begin ---"
+  while IFS= read -r line || [[ -n "$line" ]]; do
+    write_run_log_line "$(timestamp_now) $line"
+  done < "$path"
+  write_run_log_line "$(timestamp_now) --- $label output end ---"
 }
 
 unique_append() {
@@ -519,6 +653,42 @@ ensure_python_available() {
   fi
 }
 
+pip_command() {
+  if command -v pip >/dev/null 2>&1; then
+    printf '%s\n' "pip"
+    return 0
+  fi
+  if command -v pip3 >/dev/null 2>&1; then
+    printf '%s\n' "pip3"
+    return 0
+  fi
+  if command -v python3 >/dev/null 2>&1 && python3 -m pip --version >/dev/null 2>&1; then
+    printf '%s\n' "python3 -m pip"
+    return 0
+  fi
+  return 1
+}
+
+ensure_pip_available() {
+  if ! pip_command >/dev/null; then
+    error "pip is required to run agentic install/tui. Install pip for Python 3 and make 'pip3', 'pip', or 'python3 -m pip' available."
+    exit 1
+  fi
+}
+
+ensure_hash_available() {
+  if ! command -v shasum >/dev/null 2>&1 && ! command -v sha256sum >/dev/null 2>&1; then
+    error "shasum or sha256sum is required to track managed files"
+    exit 1
+  fi
+}
+
+ensure_agentic_runtime_requirements() {
+  ensure_python_available
+  ensure_pip_available
+  ensure_hash_available
+}
+
 selected_agent_os_contains() {
   local expected="$1"
   local agent
@@ -547,8 +717,7 @@ hash_file() {
   elif command -v sha256sum >/dev/null 2>&1; then
     sha256sum "$path" | awk '{print $1}'
   else
-    error "shasum or sha256sum is required to track managed files"
-    exit 1
+    ensure_hash_available
   fi
 }
 
@@ -634,12 +803,15 @@ register_managed_file() {
   local dest="$1"
   local source_ref="$2"
   local marker="$3"
+  local copied="${4:-true}"
   local rel
   rel="$(project_rel_path "$dest")"
   local digest
   digest="$(hash_file "$dest")"
   MANAGED_RECORDS+=("$rel|$source_ref|$digest|$marker")
-  unique_append "$dest" COPIED_PATHS
+  if [[ "$copied" == true ]]; then
+    unique_append "$dest" COPIED_PATHS
+  fi
 }
 
 record_agentic_event() {
@@ -679,8 +851,10 @@ write_file_with_agentic_marker() {
   can_write_managed_file "$dest" || return 0
 
   ensure_dir "$(dirname -- "$dest")"
-  python3 - "$src" "$dest" "$source_ref" "$APP_REPO_LINK" <<'PY'
+  local write_status
+  write_status="$(python3 - "$src" "$dest" "$source_ref" "$APP_REPO_LINK" "$(app_version_label)" <<'PY'
 import json
+import re
 import sys
 from pathlib import Path
 
@@ -688,6 +862,7 @@ src = Path(sys.argv[1])
 dest = Path(sys.argv[2])
 source_ref = sys.argv[3]
 repo = sys.argv[4]
+version = sys.argv[5]
 text = src.read_text(encoding="utf-8")
 suffix = dest.suffix.lower()
 marker = f"Generated by agentic; source: {source_ref}; repository: {repo}"
@@ -697,12 +872,28 @@ def yaml_quote(value: str) -> str:
     return json.dumps(value, ensure_ascii=False)
 
 
+def existing_created_by() -> str:
+    if not dest.exists():
+        return version
+    try:
+        old = dest.read_text(encoding="utf-8")
+    except Exception:
+        return version
+    match = re.search(r"(?m)^  created_by:\s*(.+?)\s*$", old)
+    if not match:
+        return version
+    return match.group(1).strip().strip('"')
+
+
 def markdown_with_marker(body: str) -> str:
+    created_by = existing_created_by()
     block = (
         "agentic:\n"
         "  generated_by: agentic\n"
         f"  source: {yaml_quote(source_ref)}\n"
         f"  repository: {yaml_quote(repo)}\n"
+        f"  created_by: {yaml_quote(created_by)}\n"
+        f"  updated_by: {yaml_quote(version)}\n"
     )
     if body.startswith("---\n"):
         end = body.find("\n---", 4)
@@ -731,11 +922,6 @@ elif suffix == ".json":
     data = json.loads(text)
     if not isinstance(data, dict):
         raise SystemExit(f"Cannot add agentic metadata to non-object JSON: {dest}")
-    data["_agentic"] = {
-        "generated_by": "agentic",
-        "source": source_ref,
-        "repository": repo,
-    }
     output = json.dumps(data, indent=2, ensure_ascii=False) + "\n"
 elif suffix in {".ts", ".tsx", ".js", ".jsx", ".css"}:
     output = commented(text, "//")
@@ -744,9 +930,23 @@ elif suffix in {".sh", ".toml", ".py", ".yml", ".yaml"}:
 else:
     output = commented(text, "#")
 
+if dest.exists():
+    try:
+        if dest.read_text(encoding="utf-8") == output:
+            print("unchanged")
+            raise SystemExit(0)
+    except UnicodeDecodeError:
+        pass
+
 dest.write_text(output, encoding="utf-8")
+print("written")
 PY
-  register_managed_file "$dest" "$source_ref" "internal"
+)"
+  if [[ "$write_status" == "unchanged" ]]; then
+    register_managed_file "$dest" "$source_ref" "internal" false
+  else
+    register_managed_file "$dest" "$source_ref" "internal"
+  fi
 }
 
 write_agentic_manifest() {
@@ -780,7 +980,8 @@ write_agentic_manifest() {
   specs_csv="${SELECTED_SPECS[*]}"
   IFS="$old_ifs"
 
-  python3 - "$manifest" "$records_file" "$skipped_file" "$APP_REPO_LINK" "$REPO_ROOT" "$agent_os_csv" "$areas_csv" "$specs_csv" <<'PY'
+  local manifest_status
+  manifest_status="$(python3 - "$manifest" "$records_file" "$skipped_file" "$APP_REPO_LINK" "$REPO_ROOT" "$agent_os_csv" "$areas_csv" "$specs_csv" "$(app_version_label)" <<'PY'
 import json
 import sys
 from datetime import datetime, timezone
@@ -794,37 +995,55 @@ repo_root = sys.argv[5]
 agent_os = [x for x in sys.argv[6].split(",") if x]
 areas = [x for x in sys.argv[7].split(",") if x]
 specs = [x for x in sys.argv[8].split(",") if x]
+app_version = sys.argv[9]
 now = datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z")
 
 existing = {}
 created_at = now
+old_data = None
 if manifest.exists():
     try:
         old = json.loads(manifest.read_text(encoding="utf-8"))
+        old_data = old
         created_at = old.get("created_at", created_at)
         for item in old.get("managed_files", []):
             if item.get("path"):
                 existing[item["path"]] = item
     except Exception:
         existing = {}
+original_existing = json.loads(json.dumps(existing))
 
 for line in records_file.read_text(encoding="utf-8").splitlines():
     if not line:
         continue
     path, source, digest, marker = (line.split("|", 3) + ["", "", "", ""])[:4]
+    old_item = original_existing.get(path, {})
+    old_updated_at = old_item.get("updated_at", now)
+    if (
+        old_item.get("source") == source
+        and old_item.get("content_hash") == digest
+        and old_item.get("marker") == marker
+    ):
+        item_updated_at = old_updated_at
+    else:
+        item_updated_at = now
     existing[path] = {
         "path": path,
         "source": source,
         "content_hash": digest,
         "marker": marker,
-        "updated_at": now,
+        "updated_at": item_updated_at,
     }
 
 skipped = [x for x in skipped_file.read_text(encoding="utf-8").splitlines() if x]
+old_agentic = old_data.get("_agentic", {}) if isinstance(old_data, dict) else {}
+created_by = old_agentic.get("created_by", app_version)
 data = {
     "_agentic": {
         "generated_by": "agentic",
         "repository": repo_link,
+        "created_by": created_by,
+        "updated_by": app_version,
     },
     "version": 1,
     "created_at": created_at,
@@ -839,9 +1058,26 @@ data = {
     "managed_files": sorted(existing.values(), key=lambda x: x["path"]),
     "skipped_files": skipped,
 }
+
+if old_data is not None:
+    old_compare = json.loads(json.dumps(old_data))
+    new_compare = json.loads(json.dumps(data))
+    for payload in (old_compare, new_compare):
+        payload.pop("updated_at", None)
+        if isinstance(payload.get("_agentic"), dict):
+            payload["_agentic"].pop("updated_by", None)
+    if old_compare == new_compare:
+        print("unchanged")
+        raise SystemExit(0)
+
 manifest.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+print("written")
 PY
+)"
   rm -f "$records_file" "$skipped_file"
+  if [[ "$manifest_status" == "unchanged" ]]; then
+    return
+  fi
   unique_append "$manifest" COPIED_PATHS
 }
 
@@ -981,9 +1217,10 @@ copy_dir_contents() {
 
   local event kind value events_file
   events_file="$(mktemp "${TMPDIR:-/tmp}/agentic-copy-events.XXXXXX")"
-  python3 - "$src" "$dest" "$REPO_ROOT" "$PROJECT_DIR" "$(project_manifest_path)" "$APP_REPO_LINK" > "$events_file" <<'PY'
+  python3 - "$src" "$dest" "$REPO_ROOT" "$PROJECT_DIR" "$(project_manifest_path)" "$APP_REPO_LINK" "$(app_version_label)" > "$events_file" <<'PY'
 import hashlib
 import json
+import re
 import sys
 from pathlib import Path
 
@@ -993,6 +1230,7 @@ repo_root = Path(sys.argv[3])
 project_dir = Path(sys.argv[4])
 manifest = Path(sys.argv[5])
 repo = sys.argv[6]
+version = sys.argv[7]
 
 
 def emit(kind: str, value: str) -> None:
@@ -1015,7 +1253,7 @@ if manifest.exists():
         for item in data.get("managed_files", []):
             rel = item.get("path")
             if rel:
-                managed[rel] = item.get("content_hash", "")
+                managed[rel] = item
     except Exception:
         managed = {}
 
@@ -1038,12 +1276,28 @@ def yaml_quote(value: str) -> str:
     return json.dumps(value, ensure_ascii=False)
 
 
-def markdown_with_marker(body: str, source_ref: str) -> str:
+def existing_created_by(target: Path) -> str:
+    if not target.exists():
+        return version
+    try:
+        old = target.read_text(encoding="utf-8")
+    except Exception:
+        return version
+    match = re.search(r"(?m)^  created_by:\s*(.+?)\s*$", old)
+    if not match:
+        return version
+    return match.group(1).strip().strip('"')
+
+
+def markdown_with_marker(body: str, source_ref: str, target: Path) -> str:
+    created_by = existing_created_by(target)
     block = (
         "agentic:\n"
         "  generated_by: agentic\n"
         f"  source: {yaml_quote(source_ref)}\n"
         f"  repository: {yaml_quote(repo)}\n"
+        f"  created_by: {yaml_quote(created_by)}\n"
+        f"  updated_by: {yaml_quote(version)}\n"
     )
     if body.startswith("---\n"):
         end = body.find("\n---", 4)
@@ -1066,16 +1320,11 @@ def add_marker(file_path: Path, target: Path, source_ref: str) -> str:
     text = file_path.read_text(encoding="utf-8")
     suffix = target.suffix.lower()
     if suffix == ".md":
-        return markdown_with_marker(text, source_ref)
+        return markdown_with_marker(text, source_ref, target)
     if suffix == ".json":
         data = json.loads(text)
         if not isinstance(data, dict):
             raise SystemExit(f"Cannot add agentic metadata to non-object JSON: {target}")
-        data["_agentic"] = {
-            "generated_by": "agentic",
-            "source": source_ref,
-            "repository": repo,
-        }
         return json.dumps(data, indent=2, ensure_ascii=False) + "\n"
     if suffix in {".ts", ".tsx", ".js", ".jsx", ".css"}:
         return commented(text, "//", source_ref)
@@ -1097,15 +1346,27 @@ for file_path in sorted(p for p in src.rglob("*") if p.is_file()):
                 emit("WARN", f"Skipping unmanaged target on rerun: {project_rel}")
                 emit("SKIP", project_rel)
                 continue
-        expected_hash = managed.get(project_rel, "")
+        managed_item = managed.get(project_rel, {})
+        if managed_item.get("marker") == "config":
+            continue
+        expected_hash = managed_item.get("content_hash", "")
         if target.exists() and expected_hash and sha256(target) != expected_hash:
             emit("WARN", f"Skipping user-modified managed file: {project_rel}")
             emit("SKIP", project_rel)
             continue
 
+    output = add_marker(file_path, target, source_ref)
     target.parent.mkdir(parents=True, exist_ok=True)
     emit("DIR", str(target.parent))
-    target.write_text(add_marker(file_path, target, source_ref), encoding="utf-8")
+    if target.exists():
+        try:
+            if target.read_text(encoding="utf-8") == output:
+                digest = sha256(target)
+                emit("RECORD", f"{project_rel}|{source_ref}|{digest}|internal")
+                continue
+        except UnicodeDecodeError:
+            pass
+    target.write_text(output, encoding="utf-8")
     digest = sha256(target)
     emit("RECORD", f"{project_rel}|{source_ref}|{digest}|internal")
     emit("COPIED", str(target))
@@ -1156,7 +1417,8 @@ write_json_file_with_agentic_metadata() {
 
   can_write_managed_file "$dest" || return 0
   ensure_dir "$(dirname -- "$dest")"
-  python3 - "$dest" "$source_ref" "$APP_REPO_LINK" "$CONTEXT7_API_KEY" "$python_body" <<'PY'
+  local write_status
+  write_status="$(python3 - "$dest" "$source_ref" "$APP_REPO_LINK" "$CONTEXT7_API_KEY" "$python_body" "$(app_version_label)" <<'PY'
 import json
 import sys
 from pathlib import Path
@@ -1166,11 +1428,15 @@ source_ref = sys.argv[2]
 repo = sys.argv[3]
 context7_api_key = sys.argv[4]
 body = sys.argv[5]
+version = sys.argv[6]
 
 data = {}
+created_by = version
 if path.exists():
     try:
         data = json.loads(path.read_text(encoding="utf-8"))
+        if isinstance(data, dict):
+            created_by = data.get("_agentic", {}).get("created_by", version)
     except Exception:
         data = {}
 if not isinstance(data, dict):
@@ -1182,14 +1448,28 @@ namespace = {
 }
 exec(body, namespace)
 data = namespace["data"]
-data["_agentic"] = {
-    "generated_by": "agentic",
-    "source": source_ref,
-    "repository": repo,
-}
+metadata = data.setdefault("_agentic", {})
+metadata["generated_by"] = "agentic"
+metadata["repository"] = repo
+metadata["created_by"] = created_by
+metadata["updated_by"] = version
+output = json.dumps(data, indent=2, ensure_ascii=False) + "\n"
+if path.exists():
+    try:
+        if path.read_text(encoding="utf-8") == output:
+            print("unchanged")
+            raise SystemExit(0)
+    except UnicodeDecodeError:
+        pass
 path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+print("written")
 PY
-  register_managed_file "$dest" "$source_ref" "internal"
+)"
+  if [[ "$write_status" == "unchanged" ]]; then
+    register_managed_file "$dest" "$source_ref" "internal" false
+  else
+    register_managed_file "$dest" "$source_ref" "internal"
+  fi
 }
 
 write_json_config_file() {
@@ -1205,7 +1485,8 @@ write_json_config_file() {
 
   can_write_managed_file "$dest" || return 0
   ensure_dir "$(dirname -- "$dest")"
-  python3 - "$dest" "$CONTEXT7_API_KEY" "$python_body" <<'PY'
+  local write_status
+  write_status="$(python3 - "$dest" "$CONTEXT7_API_KEY" "$python_body" <<'PY'
 import json
 import sys
 from pathlib import Path
@@ -1229,9 +1510,62 @@ namespace = {
 }
 exec(body, namespace)
 data = namespace["data"]
-path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+output = json.dumps(data, indent=2, ensure_ascii=False) + "\n"
+if path.exists():
+    try:
+        if path.read_text(encoding="utf-8") == output:
+            print("unchanged")
+            raise SystemExit(0)
+    except UnicodeDecodeError:
+        pass
+path.write_text(output, encoding="utf-8")
+print("written")
 PY
-  register_managed_file "$dest" "$source_ref" "config"
+)"
+  if [[ "$write_status" == "unchanged" ]]; then
+    register_managed_file "$dest" "$source_ref" "config" false
+  else
+    register_managed_file "$dest" "$source_ref" "config"
+  fi
+}
+
+write_text_config_file() {
+  local dest="$1"
+  local source_ref="$2"
+  local content="$3"
+
+  if [[ "$DRY_RUN" == true ]]; then
+    log "DRY-RUN write text config file $dest"
+    unique_append "$dest" COPIED_PATHS
+    return
+  fi
+
+  can_write_managed_file "$dest" || return 0
+  ensure_dir "$(dirname -- "$dest")"
+
+  local write_status
+  write_status="$(python3 - "$dest" "$content" <<'PY'
+import sys
+from pathlib import Path
+
+path = Path(sys.argv[1])
+content = sys.argv[2]
+if path.exists():
+    try:
+        if path.read_text(encoding="utf-8") == content:
+            print("unchanged")
+            raise SystemExit(0)
+    except UnicodeDecodeError:
+        pass
+path.write_text(content, encoding="utf-8")
+print("written")
+PY
+)"
+  if [[ "$write_status" == "unchanged" ]]; then
+    register_managed_file "$dest" "$source_ref" "config" false
+  else
+    register_managed_file "$dest" "$source_ref" "config"
+  fi
 }
 
 write_context7_opencode_config() {
@@ -1265,22 +1599,32 @@ if context7_api_key:
     context7["headers"] = {"CONTEXT7_API_KEY": context7_api_key}
 mcp["context7"] = context7
 '
-  write_json_file_with_agentic_metadata "$dest" "generated:context7-opencode-legacy-config" "$body"
+  write_json_config_file "$dest" "generated:context7-opencode-legacy-config" "$body"
 }
 
 write_context7_codex_config() {
   local dest="$PROJECT_DIR/.codex/config.toml"
-  local headers=""
-  if [[ -n "$CONTEXT7_API_KEY" ]]; then
-    local escaped_key
-    escaped_key="${CONTEXT7_API_KEY//\\/\\\\}"
-    escaped_key="${escaped_key//\"/\\\"}"
-    headers="http_headers = { \"CONTEXT7_API_KEY\" = \"$escaped_key\" }
-"
-  fi
-  write_generated_text_file "$dest" "generated:context7-codex-config" "[mcp_servers.context7]
-url = \"https://mcp.context7.com/mcp\"
-${headers}"
+  local body
+  body="$(python3 - "$dest" "$CONTEXT7_API_KEY" <<'PY'
+import re
+import sys
+from pathlib import Path
+
+path = Path(sys.argv[1])
+api_key = sys.argv[2]
+text = path.read_text(encoding="utf-8") if path.exists() else ""
+text = re.sub(r"(?ms)^\[mcp_servers\.context7\]\n.*?(?=^\[|\Z)", "", text).strip()
+block = '[mcp_servers.context7]\nurl = "https://mcp.context7.com/mcp"\n'
+if api_key:
+    escaped = api_key.replace("\\", "\\\\").replace('"', '\\"')
+    block += f'http_headers = {{ "CONTEXT7_API_KEY" = "{escaped}" }}\n'
+if text:
+    print(block + "\n" + text.rstrip() + "\n", end="")
+else:
+    print(block, end="")
+PY
+)"
+  write_text_config_file "$dest" "generated:context7-codex-config" "$body"
 }
 
 write_context7_claude_config() {
@@ -1314,6 +1658,37 @@ mcp_servers["context7"] = context7
   write_json_config_file "$dest" "generated:context7-cursor-config" "$body"
 }
 
+
+write_context7_kilocode_config() {
+  local dest="$PROJECT_DIR/.kilocode/mcp.json"
+  local body
+  body='
+mcp_servers = data.setdefault("mcpServers", {})
+context7 = {
+    "url": "https://mcp.context7.com/mcp",
+}
+if context7_api_key:
+    context7["headers"] = {"CONTEXT7_API_KEY": context7_api_key}
+mcp_servers["context7"] = context7
+'
+  write_json_config_file "$dest" "generated:context7-kilocode-config" "$body"
+}
+
+write_context7_antigravity_config() {
+  local dest="$HOME/.gemini/antigravity/mcp_config.json"
+  local body
+  body='
+mcp_servers = data.setdefault("mcpServers", {})
+context7 = {
+    "url": "https://mcp.context7.com/mcp",
+}
+if context7_api_key:
+    context7["headers"] = {"CONTEXT7_API_KEY": context7_api_key}
+mcp_servers["context7"] = context7
+'
+  write_json_config_file "$dest" "generated:context7-antigravity-config" "$body"
+}
+
 write_context7_gemini_config() {
   local dest="$PROJECT_DIR/.gemini/settings.json"
   local body
@@ -1329,19 +1704,190 @@ mcp_servers["context7"] = context7
   write_json_config_file "$dest" "generated:context7-gemini-config" "$body"
 }
 
+write_mempalace_opencode_config() {
+  local dest="$1"
+  local body
+  body='
+mcp = data.setdefault("mcp", {})
+mcp["mempalace"] = {"type": "local", "command": ["mempalace-mcp"]}
+'
+  write_json_config_file "$dest" "generated:mempalace-opencode-config" "$body"
+}
+
+write_mempalace_codex_config() {
+  local dest="$PROJECT_DIR/.codex/config.toml"
+  local body
+  body="$(python3 - "$dest" <<'PYCODE'
+import re
+import pathlib
+import sys
+
+path = pathlib.Path(sys.argv[1])
+text = path.read_text(encoding='utf-8') if path.exists() else ''
+block = "[mcp_servers.mempalace]\ncommand = \"mempalace-mcp\"\n"
+text = re.sub(r"(?ms)^\[mcp_servers\.mempalace\]\n.*?(?=^\[|\Z)", "", text).strip()
+if text:
+    print(text.rstrip() + "\n\n" + block, end="")
+else:
+    print(block, end="")
+PYCODE
+)"
+  write_text_config_file "$dest" "generated:mempalace-codex-config" "$body"
+}
+
+write_mempalace_generic_json_config() {
+  local dest="$1"
+  local marker="$2"
+  local body
+  body='
+servers = data.setdefault("mcpServers", {})
+servers["mempalace"] = {"command": "mempalace-mcp"}
+'
+  write_json_config_file "$dest" "$marker" "$body"
+}
+
+print_mempalace_project_setup_instructions() {
+  log "MemPalace setup instructions for target project: $PROJECT_DIR"
+  out "1) Ensure Python is installed and available in PATH."
+  out "2) Install MemPalace:"
+  out "   pip install mempalace"
+  out "3) Initialize project-local MemPalace cache:"
+  out "   mempalace init \"$PROJECT_DIR\" --yes --auto-mine"
+  out "4) Index existing project memory:"
+  out "   # optional if --auto-mine was skipped"
+  out "   mempalace mine \"$PROJECT_DIR\""
+  out "5) Verify in your IDE/agent that MemPalace MCP tools are connected."
+  out "Note: Ollama at localhost:11434 is optional; MemPalace can run heuristics-only without it."
+}
+
+setup_mempalace_for_agentic_opencode() {
+  local step_prefix="MemPalace setup"
+
+  log "$step_prefix [1/4] Checking Python availability"
+  if ! command -v python3 >/dev/null 2>&1 && ! command -v python >/dev/null 2>&1; then
+    warn "Python is not installed. Install Python 3 first, then run: pip install mempalace"
+    warn "Install help: https://www.python.org/downloads/"
+    return 1
+  fi
+  log "$step_prefix [1/4] Python check passed"
+
+  log "$step_prefix [2/4] Checking pip availability"
+  local pip_bin
+  if ! pip_bin="$(pip_command)"; then
+    warn "pip is not available. Install pip for Python 3, then run: pip install mempalace"
+    return 1
+  fi
+  log "$step_prefix [2/4] pip check passed"
+
+  log "$step_prefix [3/4] Installing mempalace package"
+  if $pip_bin install mempalace >/dev/null 2>&1; then
+    log "MemPalace package installed via '$pip_bin install mempalace'"
+  else
+    warn "Unable to auto-install mempalace via pip; continuing with manual setup instructions"
+    print_mempalace_project_setup_instructions
+    return 1
+  fi
+
+  log "$step_prefix [4/4] Initializing project memory at $PROJECT_DIR"
+  if command -v mempalace >/dev/null 2>&1; then
+    if mempalace init "$PROJECT_DIR" --yes --auto-mine >/dev/null 2>&1; then
+      log "MemPalace init completed"
+    else
+      warn "Failed: mempalace init \"$PROJECT_DIR\" --yes --auto-mine"
+    fi
+    if mempalace mine "$PROJECT_DIR" >/dev/null 2>&1; then
+      log "MemPalace mine completed"
+    else
+      warn "Failed: mempalace mine \"$PROJECT_DIR\""
+    fi
+    log "$step_prefix [4/4] Initialization step finished"
+  else
+    warn "mempalace command is unavailable after install; please run setup manually"
+    print_mempalace_project_setup_instructions
+    return 1
+  fi
+}
+
+configure_mempalace_if_needed() {
+  if ! selected_agent_os_contains "opencode" \
+    && ! selected_agent_os_contains "codex" \
+    && ! selected_agent_os_contains "claude" \
+    && ! selected_agent_os_contains "cursor" \
+    && ! selected_agent_os_contains "gemini" \
+    && ! selected_agent_os_contains "kilocode" \
+    && ! selected_agent_os_contains "antigravity"; then
+    return
+  fi
+
+  local enable_mempalace="N"
+  if [[ -n "${AGENTIC_ENABLE_MEMPALACE:-}" ]]; then
+    enable_mempalace="$(trim "${AGENTIC_ENABLE_MEMPALACE}")"
+  elif is_interactive_terminal && [[ -z "${AGENTIC_TEST_SOURCE_AGENTIC:-}" ]]; then
+    read -r -p "Enable MemPalace MCP memory integration? [y/N]: " enable_mempalace
+    enable_mempalace="$(trim "${enable_mempalace:-n}")"
+    if [[ -z "$enable_mempalace" ]]; then enable_mempalace="n"; fi
+  fi
+  if [[ "$enable_mempalace" =~ ^[Nn]$ ]]; then
+    log "Skipped MemPalace MCP configuration"
+    return
+  fi
+
+  if selected_agent_os_contains "opencode"; then
+    setup_mempalace_for_agentic_opencode || true
+  else
+    print_mempalace_project_setup_instructions
+  fi
+
+  if command -v mempalace-mcp >/dev/null 2>&1; then
+    log "MemPalace MCP binary found: mempalace-mcp"
+  else
+    warn "mempalace-mcp is unavailable; install/repair MemPalace and re-run setup"
+  fi
+
+  if selected_agent_os_contains "opencode"; then
+    write_mempalace_opencode_config "$PROJECT_DIR/opencode.json"
+    write_mempalace_opencode_config "$PROJECT_DIR/.opencode/opencode.json"
+  fi
+  if selected_agent_os_contains "codex"; then write_mempalace_codex_config; fi
+  if selected_agent_os_contains "claude"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.mcp.json" "generated:mempalace-claude-config"
+  fi
+  if selected_agent_os_contains "cursor"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.cursor/mcp.json" "generated:mempalace-cursor-config"
+  fi
+  if selected_agent_os_contains "gemini"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.gemini/settings.json" "generated:mempalace-gemini-config"
+  fi
+  if selected_agent_os_contains "kilocode"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.kilocode/mcp.json" "generated:mempalace-kilocode-config"
+  fi
+  if selected_agent_os_contains "antigravity"; then
+    write_mempalace_generic_json_config "$HOME/.gemini/antigravity/mcp_config.json" "generated:mempalace-antigravity-config"
+  fi
+}
+
 configure_context7_if_needed() {
   if ! selected_agent_os_contains "opencode" \
     && ! selected_agent_os_contains "codex" \
     && ! selected_agent_os_contains "claude" \
     && ! selected_agent_os_contains "cursor" \
-    && ! selected_agent_os_contains "gemini"; then
+    && ! selected_agent_os_contains "gemini" \
+    && ! selected_agent_os_contains "kilocode" \
+    && ! selected_agent_os_contains "antigravity"; then
     return
   fi
 
-  if is_interactive_terminal; then
-    local enable_context7 answer
-    read -r -p "Enable Context7 MCP configuration? [y/N]: " enable_context7
+  local enable_context7="${AGENTIC_ENABLE_CONTEXT7:-}"
+  if [[ -n "$enable_context7" ]]; then
     enable_context7="$(trim "$enable_context7")"
+  fi
+
+  if is_interactive_terminal; then
+    local answer
+    if [[ -z "$enable_context7" ]]; then
+      read -r -p "Enable Context7 MCP configuration? [y/N]: " enable_context7
+      enable_context7="$(trim "$enable_context7")"
+    fi
     if [[ ! "$enable_context7" =~ ^[Yy]$ ]]; then
       log "Context7 MCP configuration disabled"
       return
@@ -1376,6 +1922,14 @@ configure_context7_if_needed() {
   if selected_agent_os_contains "gemini"; then
     write_context7_gemini_config
   fi
+
+  if selected_agent_os_contains "kilocode"; then
+    write_context7_kilocode_config
+  fi
+
+  if selected_agent_os_contains "antigravity"; then
+    write_context7_antigravity_config
+  fi
 }
 
 write_default_opencode_plugin_config() {
@@ -1415,9 +1969,34 @@ configure_opencode_plugins_if_needed() {
     return
   fi
 
-  local enable_telegram telegram_token telegram_chat enable_model_checker
-  read -r -p "Enable OpenCode Telegram notifications? [y/N]: " enable_telegram
-  enable_telegram="$(trim "$enable_telegram")"
+  local plugin_options=("telegram-opencode-notifier" "llm-quota-checker")
+  local selected_plugins=()
+  local use_fzf_plugins=false
+  if fzf_available; then
+    use_fzf_plugins=true
+  elif ensure_fzf_or_fallback; then
+    use_fzf_plugins=true
+  fi
+
+  if [[ "$use_fzf_plugins" == true ]]; then
+    readlines selected_plugins < <(choose_multi_fzf_strict "Select optional OpenCode plugin(s):" "${plugin_options[@]}")
+  else
+    local selected_plugins_output
+    selected_plugins_output="$(choose_multi_by_index "Select optional OpenCode plugin(s):" "${plugin_options[@]}")"
+    readlines selected_plugins <<< "$selected_plugins_output"
+  fi
+
+  local enable_telegram="n" telegram_token telegram_chat enable_model_checker="n"
+  local selected_plugin
+  for selected_plugin in "${selected_plugins[@]}"; do
+    selected_plugin="$(trim "$selected_plugin")"
+    [[ -z "$selected_plugin" ]] && continue
+    case "$selected_plugin" in
+      telegram-opencode-notifier) enable_telegram="y" ;;
+      llm-quota-checker) enable_model_checker="y" ;;
+    esac
+  done
+
   telegram_token=""
   telegram_chat=""
   if [[ "$enable_telegram" =~ ^[Yy]$ ]]; then
@@ -1427,9 +2006,6 @@ configure_opencode_plugins_if_needed() {
     telegram_chat="$(trim "$telegram_chat")"
   fi
 
-  read -r -p "Enable OpenCode model checker plugin? [y/N]: " enable_model_checker
-  enable_model_checker="$(trim "$enable_model_checker")"
-
   python3 - "$OPENCODE_PLUGIN_CONFIG_FILE" "$telegram_token" "$telegram_chat" "$enable_model_checker" <<'PY'
 import json
 import sys
@@ -1556,7 +2132,7 @@ build_header() {
   {
     echo "# Agentic Project Guidelines"
     echo
-    echo "Generated by $SCRIPT_NAME on $(date -u +'%Y-%m-%dT%H:%M:%SZ')."
+    echo "Generated by $SCRIPT_NAME."
     echo
     echo "## Installation Context"
     echo "- Agent OS targets: ${SELECTED_AGENT_OS[*]}"
@@ -1610,11 +2186,31 @@ append_root_agents_template() {
 
 generate_agents_md() {
   local project_dir="$1"
-  local out="$project_dir/AGENTS.md"
+  local outputs=()
+  local needs_root=false
+  local agent_os
+
+  if selected_agent_os_contains "opencode"; then
+    unique_append "$project_dir/.opencode/AGENTS.md" outputs
+  fi
+
+  for agent_os in "${SELECTED_AGENT_OS[@]}"; do
+    if [[ "$agent_os" != "opencode" ]]; then
+      needs_root=true
+      break
+    fi
+  done
+
+  if [[ "$needs_root" == true ]] || ! selected_agent_os_contains "opencode"; then
+    unique_append "$project_dir/AGENTS.md" outputs
+  fi
 
   if [[ "$DRY_RUN" == true ]]; then
-    log "DRY-RUN generate $out"
-    unique_append "$out" COPIED_PATHS
+    local dry_run_out
+    for dry_run_out in "${outputs[@]}"; do
+      log "DRY-RUN generate $dry_run_out"
+      unique_append "$dry_run_out" COPIED_PATHS
+    done
     return
   fi
 
@@ -1629,7 +2225,10 @@ generate_agents_md() {
     append_specialization_template "$tmp" "$spec_key"
   done
 
-  write_file_with_agentic_marker "$tmp" "$out" "generated:AGENTS.md"
+  local out
+  for out in "${outputs[@]}"; do
+    write_file_with_agentic_marker "$tmp" "$out" "generated:AGENTS.md"
+  done
   rm -f "$tmp"
 }
 
@@ -1700,43 +2299,304 @@ validate_inputs() {
 }
 
 print_report() {
-  echo
-  echo "${COLOR_HEADER}=== Installation report ===${COLOR_RESET}"
-  echo "Project dir: $PROJECT_DIR"
-  echo "Knowledge base repo: $REPO_ROOT"
-  echo "Config file: $APP_CONFIG_FILE"
-  echo "Agent OS targets: ${SELECTED_AGENT_OS[*]}"
-  echo "Areas: ${SELECTED_AREAS[*]}"
-  echo "Specializations: ${SELECTED_SPECS[*]}"
-
-  echo
-  echo "Created directories:"
+  out
+  out "=== Installation report ===" "$COLOR_HEADER"
+  out "Agentic version: $(app_version_label)"
+  out "Project dir: $PROJECT_DIR"
+  out "Knowledge base repo: $REPO_ROOT"
+  out "Config file: $APP_CONFIG_FILE"
+  out "Agent OS targets: ${SELECTED_AGENT_OS[*]}"
+  out "Areas: ${SELECTED_AREAS[*]}"
+  out "Specializations: ${SELECTED_SPECS[*]}"
+
+  out
+  out "Created directories:"
   if [[ "${#CREATED_PATHS[@]}" -eq 0 ]]; then
-    echo "- (none)"
+    out "- (none)"
   else
-    printf -- '- %s\n' "${CREATED_PATHS[@]}"
+    local created_path
+    for created_path in "${CREATED_PATHS[@]}"; do
+      out "- $created_path"
+    done
   fi
 
-  echo
-  echo "Copied/generated paths:"
+  out
+  out "Copied/generated paths:"
   if [[ "${#COPIED_PATHS[@]}" -eq 0 ]]; then
-    echo "- (none)"
+    out "- (none)"
   else
-    printf -- '- %s\n' "${COPIED_PATHS[@]}"
+    local copied_path
+    for copied_path in "${COPIED_PATHS[@]}"; do
+      out "- $copied_path"
+    done
   fi
 
-  echo
-  echo "Warnings:"
+  out
+  out "Warnings:"
   if [[ "${#WARNINGS[@]}" -eq 0 ]]; then
-    echo "- (none)"
+    out "- (none)"
+  else
+    local warning
+    for warning in "${WARNINGS[@]}"; do
+      out "- $warning"
+    done
+  fi
+}
+
+detect_runtime_platform_label() {
+  local platform
+  platform="$(detect_platform)"
+  if [[ "$platform" == "linux" ]] && grep -qiE "(microsoft|wsl)" /proc/version 2>/dev/null; then
+    echo "wsl"
+    return
+  fi
+  echo "$platform"
+}
+
+get_agent_binary_name() {
+  local agent_os="$1"
+  case "$agent_os" in
+    codex) echo "codex" ;;
+    claude) echo "claude" ;;
+    opencode) echo "opencode" ;;
+    cursor) echo "cursor-agent" ;;
+    gemini) echo "gemini" ;;
+    antigravity) echo "antigravity" ;;
+    *) echo "" ;;
+  esac
+}
+
+print_missing_agent_binary_guides() {
+  local platform_label
+  platform_label="$(detect_runtime_platform_label)"
+  local missing_lines=()
+  local agent_os
+
+  for agent_os in "${SELECTED_AGENT_OS[@]}"; do
+    local binary_name
+    binary_name="$(get_agent_binary_name "$agent_os")"
+    if [[ -z "$binary_name" ]]; then
+      continue
+    fi
+    if command -v "$binary_name" >/dev/null 2>&1; then
+      continue
+    fi
+
+    local install_link=""
+    case "$agent_os" in
+      codex) install_link="https://github.com/openai/codex" ;;
+      claude) install_link="https://docs.anthropic.com/en/docs/claude-code/quickstart" ;;
+      opencode) install_link="https://opencode.ai/docs" ;;
+      cursor) install_link="https://docs.cursor.com/get-started/installation" ;;
+      gemini) install_link="https://github.com/google-gemini/gemini-cli" ;;
+      antigravity) install_link="https://github.com/getantigravity/antigravity" ;;
+    esac
+
+    missing_lines+=("- $agent_os: binary '$binary_name' is not installed on $platform_label.")
+    if [[ -n "$install_link" ]]; then
+      missing_lines+=("  Install guide: $install_link")
+    fi
+  done
+
+  if [[ "${#missing_lines[@]}" -eq 0 ]]; then
+    return
+  fi
+
+  out
+  out "=== Agent binary setup recommendations ===" "$COLOR_HEADER"
+  local missing_line
+  for missing_line in "${missing_lines[@]}"; do
+    out "$missing_line"
+  done
+}
+
+changelog_file_path() {
+  local candidate
+  for candidate in "$SCRIPT_DIR/CHANGELOG.md" "$REPO_ROOT/CHANGELOG.md" "$APP_REPO_DIR/CHANGELOG.md"; do
+    [[ -f "$candidate" ]] || continue
+    printf '%s\n' "$candidate"
+    return 0
+  done
+  return 1
+}
+
+print_current_changelog() {
+  local changelog version
+  changelog="$(changelog_file_path || true)"
+  version="$(app_version_label)"
+  if [[ -z "$changelog" ]]; then
+    warn "CHANGELOG.md not found; skipping changelog output"
+    return
+  fi
+
+  local section_file
+  section_file="$(mktemp "${TMPDIR:-/tmp}/agentic-changelog.XXXXXX")"
+  awk -v wanted="## $version" '
+    $0 == wanted { in_section = 1; print; next }
+    in_section && /^## / { exit }
+    in_section { print }
+  ' "$changelog" > "$section_file"
+
+  if [[ ! -s "$section_file" ]]; then
+    rm -f "$section_file"
+    warn "No changelog section found for $version"
+    return
+  fi
+
+  out
+  out "=== Changelog $version ===" "$COLOR_HEADER"
+  while IFS= read -r line || [[ -n "$line" ]]; do
+    if [[ "$line" == "## $version" ]]; then
+      continue
+    fi
+    out "$line"
+  done < "$section_file"
+  rm -f "$section_file"
+}
+
+doctor_agent_supported() {
+  case "$1" in
+    codex|opencode|claude|gemini) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+doctor_enabled() {
+  [[ "$DRY_RUN" != true ]] || return 1
+  [[ "${AGENTIC_DOCTOR:-1}" != "0" ]] || return 1
+  [[ "${AGENTIC_TEST_SOURCE_AGENTIC:-}" != "1" ]] || return 1
+  return 0
+}
+
+doctor_prompt() {
+  printf '%s\n' "/develop-feature напиши hello world python"
+}
+
+doctor_output_has_fatal_patterns() {
+  local output_file="$1"
+  grep -Eiq 'MCP.*(error|failed|failure|connection|connect|startup)|plugin.*(error|failed|failure)|auth.*(required|failed)|login required|permission.*(denied|required)|SyntaxError|Traceback|Invalid regular expression flags|An unexpected critical error occurred|FatalError|RuntimeError|EPERM|EACCES|panic:' "$output_file"
+}
+
+doctor_copy_project() {
+  local dest="$1"
+  mkdir -p "$dest"
+  if [[ -d "$PROJECT_DIR" ]]; then
+    cp -R "$PROJECT_DIR/." "$dest/"
+  fi
+}
+
+run_doctor_command() {
+  local agent_os="$1"
+  local work_dir="$2"
+  local output_file="$3"
+  local prompt
+  prompt="$(doctor_prompt)"
+
+  case "$agent_os" in
+    codex)
+      codex exec --skip-git-repo-check --full-auto -C "$work_dir" "$prompt" >"$output_file" 2>&1
+      ;;
+    opencode)
+      opencode run --dir "$work_dir" --dangerously-skip-permissions --format json --command develop-feature "напиши hello world python" >"$output_file" 2>&1
+      ;;
+    claude)
+      (cd "$work_dir" && claude -p --permission-mode bypassPermissions --output-format stream-json "$prompt") >"$output_file" 2>&1
+      ;;
+    gemini)
+      (cd "$work_dir" && gemini --prompt "$prompt") >"$output_file" 2>&1
+      ;;
+    *)
+      return 2
+      ;;
+  esac
+}
+
+run_doctor_for_agent() {
+  local agent_os="$1"
+  local doctor_root="$2"
+  local binary_name
+  binary_name="$(get_agent_binary_name "$agent_os")"
+
+  if [[ -z "$binary_name" ]] || ! command -v "$binary_name" >/dev/null 2>&1; then
+    out "❌ $agent_os: binary '$binary_name' is not installed"
+    return 1
+  fi
+
+  local work_dir output_file status
+  work_dir="$doctor_root/$agent_os"
+  output_file="$doctor_root/$agent_os.log"
+  doctor_copy_project "$work_dir"
+
+  set +e
+  run_doctor_command "$agent_os" "$work_dir" "$output_file"
+  status=$?
+  set -e
+
+  log_file_block "doctor $agent_os" "$output_file"
+
+  if [[ "$status" -ne 0 ]]; then
+    out "❌ $agent_os: /develop-feature smoke failed (exit $status, log: $output_file)"
+    return 1
+  fi
+
+  if doctor_output_has_fatal_patterns "$output_file"; then
+    out "❌ $agent_os: /develop-feature smoke reported integration errors (log: $output_file)"
+    return 1
+  fi
+
+  out "✅ $agent_os: /develop-feature smoke passed"
+  return 0
+}
+
+run_agentic_doctor() {
+  if ! doctor_enabled; then
+    log "Agentic doctor skipped"
+    return
+  fi
+
+  local selected_doctor_agents=()
+  local agent_os
+  for agent_os in "${SELECTED_AGENT_OS[@]}"; do
+    if doctor_agent_supported "$agent_os"; then
+      selected_doctor_agents+=("$agent_os")
+    fi
+  done
+
+  if [[ "${#selected_doctor_agents[@]}" -eq 0 ]]; then
+    log "Agentic doctor skipped: no supported real agentos selected"
+    return
+  fi
+
+  local doctor_root
+  doctor_root="$(mktemp -d "${TMPDIR:-/tmp}/agentic-doctor.XXXXXX")"
+  out
+  out "=== Agentic doctor ===" "$COLOR_HEADER"
+  out "Doctor temp root: $doctor_root"
+
+  local failures=0
+  for agent_os in "${selected_doctor_agents[@]}"; do
+    if ! run_doctor_for_agent "$agent_os" "$doctor_root"; then
+      failures=$((failures + 1))
+    fi
+  done
+
+  if [[ "$AGENTIC_DOCTOR_KEEP_TMP" == "1" || "$failures" -gt 0 ]]; then
+    out "Doctor temp root kept: $doctor_root"
   else
-    printf -- '- %s\n' "${WARNINGS[@]}"
+    rm -rf "$doctor_root"
+  fi
+
+  if [[ "$failures" -gt 0 ]]; then
+    warn "Agentic doctor completed with $failures failing check(s)"
+  else
+    log "Agentic doctor completed successfully"
   fi
 }
 
 run_install() {
+  init_run_logging
   ensure_repo_layout
-  ensure_python_available
+  ensure_agentic_runtime_requirements
   normalize_selected_agent_os
   validate_inputs
 
@@ -1746,8 +2606,13 @@ run_install() {
   copy_specialization_assets "$PROJECT_DIR"
   generate_agents_md "$PROJECT_DIR"
   configure_context7_if_needed
+  configure_mempalace_if_needed
   write_agentic_manifest "$PROJECT_DIR"
   print_report
+  print_missing_agent_binary_guides
+  print_current_changelog
+  run_agentic_doctor
+  out "Agentic log file: $RUN_LOG_FILE"
 }
 
 ascii_banner() {
@@ -2041,6 +2906,28 @@ choose_single_fzf() {
   printf '%s\n' "${options[@]}" | fzf "${fzf_args[@]}"
 }
 
+
+choose_multi_fzf_strict() {
+  local prompt="$1"
+  shift
+  local options=("$@")
+
+  if [[ "${#options[@]}" -eq 0 ]]; then
+    return
+  fi
+
+  local sentinel="<none>"
+  local picked=()
+  readlines picked < <(choose_multi_fzf "$prompt" "$sentinel" "${options[@]}")
+
+  local item
+  for item in "${picked[@]}"; do
+    item="$(trim "$item")"
+    [[ -z "$item" || "$item" == "$sentinel" ]] && continue
+    printf '%s\n' "$item"
+  done
+}
+
 choose_multi_fzf() {
   local prompt="$1"
   shift
@@ -2096,11 +2983,13 @@ run_tui() {
     exit 1
   fi
 
+  ensure_agentic_runtime_requirements
+
   pick_theme_if_needed
   set_theme_colors
 
   ascii_banner
-  echo "${COLOR_HEADER}$APP_TUI_TITLE${COLOR_RESET}"
+  echo "${COLOR_HEADER}$APP_TUI_TITLE $(app_version_label)${COLOR_RESET}"
   echo "${COLOR_DIM}Theme: $THEME (resolved: $ACTIVE_THEME)${COLOR_RESET}"
   echo
 
@@ -2136,6 +3025,26 @@ run_tui() {
     SELECTED_AGENT_OS=("${picked_agent_os[@]}")
   fi
 
+  local mcp_options=("context7" "mempalace")
+  local picked_mcps=()
+  if [[ "$use_fzf" == true ]]; then
+    readlines picked_mcps < <(choose_multi_fzf_strict "Select optional MCP integration(s):" "${mcp_options[@]}")
+  else
+    local picked_mcps_output
+    picked_mcps_output="$(choose_multi_by_index "Select optional MCP integration(s):" "<none>" "${mcp_options[@]}")"
+    readlines picked_mcps <<< "$picked_mcps_output"
+  fi
+
+  AGENTIC_ENABLE_CONTEXT7="n"
+  AGENTIC_ENABLE_MEMPALACE="n"
+  local picked_mcp
+  for picked_mcp in "${picked_mcps[@]}"; do
+    case "$picked_mcp" in
+      context7) AGENTIC_ENABLE_CONTEXT7="y" ;;
+      mempalace) AGENTIC_ENABLE_MEMPALACE="y" ;;
+    esac
+  done
+
   local areas=()
   readlines areas < <(list_areas)
 
@@ -2274,8 +3183,13 @@ update_installed_binary_from_repo() {
     return
   fi
 
-  cp "$source_path" "$target"
-  chmod +x "$target"
+  local target_dir target_tmp
+  target_dir="$(dirname "$target")"
+  target_tmp="$(mktemp "$target_dir/.agentic-update.XXXXXX")"
+
+  cp "$source_path" "$target_tmp"
+  chmod +x "$target_tmp"
+  mv -f "$target_tmp" "$target"
   log "Updated installed binary: $target"
 }
 
@@ -2396,6 +3310,9 @@ case "$COMMAND" in
           shift 2
           ;;
         --agent-os)
+          if [[ "${#SELECTED_AGENT_OS[@]}" -eq 1 && "${SELECTED_AGENT_OS[0]}" == "$DEFAULT_AGENT_OS" ]]; then
+            SELECTED_AGENT_OS=()
+          fi
           split_csv "$2" SELECTED_AGENT_OS
           shift 2
           ;;
@@ -2419,6 +3336,10 @@ case "$COMMAND" in
           DRY_RUN=true
           shift
           ;;
+        --no-doctor)
+          AGENTIC_DOCTOR=0
+          shift
+          ;;
         -h|--help)
           usage
           exit 0
@@ -2460,6 +3381,10 @@ case "$COMMAND" in
           DRY_RUN=true
           shift
           ;;
+        --no-doctor)
+          AGENTIC_DOCTOR=0
+          shift
+          ;;
         -h|--help)
           usage
           exit 0
@@ -2546,6 +3471,10 @@ case "$COMMAND" in
     usage
     ;;
 
+  -V|--version|version)
+    app_version_label
+    ;;
+
   *)
     usage
     exit 1