ckgraphify 0.2.0__tar.gz → 0.2.2__tar.gz

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ckgraphify
-Version: 0.2.0
+Version: 0.2.2
 Summary: AI coding assistant skill for Claude Code and Codex - graph-main boundary graphs, multi-repo call chains, business-map concepts, and business search
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/safishamsi/graphify

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/graphify/__main__.py

@@ -22,31 +22,6 @@ def _default_graph_path() -> str:
     return str(Path(_GRAPHIFY_OUT) / "graph.json")
 
 
-def _check_skill_version(skill_dst: Path) -> None:
-    """Warn if the installed skill is from an older ckgraphify package version."""
-    version_file = skill_dst.parent / ".ckgraphify_version"
-    if not version_file.exists():
-        return
-    if not skill_dst.exists():
-        print("  warning: skill dir exists but SKILL.md is missing. Run 'graphify install' to repair.")
-        return
-    installed = version_file.read_text(encoding="utf-8").strip()
-    if installed != __version__:
-        print(f"  warning: skill is from ckgraphify {installed}, package is {__version__}. Run 'graphify install' to update.", file=sys.stderr)
-
-
-def _refresh_all_version_stamps() -> None:
-    """After a successful install, update .ckgraphify_version in all other known skill dirs.
-
-    Prevents stale-version warnings from platforms that were installed previously
-    but not explicitly re-installed during this upgrade.
-    """
-    for cfg in _PLATFORM_CONFIG.values():
-        skill_dst = Path.home() / cfg["skill_dst"]
-        vf = skill_dst.parent / ".ckgraphify_version"
-        if skill_dst.exists():
-            vf.write_text(__version__, encoding="utf-8")
-
 _SETTINGS_HOOK = {
     # Claude Code v2.1.117+ removed dedicated Grep/Glob tools; searches now go through Bash.
     # We match on Bash and inspect the command string to avoid firing on every shell call.
@@ -92,11 +67,6 @@ _PLATFORM_CONFIG: dict[str, dict] = {
 }
 
 
-def _claude_plugin_root() -> Path | None:
-    raw = os.environ.get("CLAUDE_PLUGIN_ROOT", "").strip()
-    return Path(raw).expanduser().resolve() if raw else None
-
-
 def _claude_project_dir() -> Path | None:
     raw = os.environ.get("CLAUDE_PROJECT_DIR", "").strip()
     return Path(raw).expanduser().resolve() if raw else None
@@ -106,9 +76,6 @@ def _default_repos_root() -> Path:
     project_dir = _claude_project_dir()
     if project_dir is not None:
         return project_dir / "repos"
-    plugin_root = _claude_plugin_root()
-    if plugin_root is not None:
-        return plugin_root / "repos"
     return Path.home() / ".graphify" / "repos"
 
 
@@ -126,11 +93,7 @@ def install(platform: str = "claude") -> None:
         print(f"error: {cfg['skill_file']} not found in package - reinstall ckgraphify", file=sys.stderr)
         sys.exit(1)
 
-    plugin_root = _claude_plugin_root() if platform == "claude" else None
-    installing_to_plugin = plugin_root is not None
-    if plugin_root is not None:
-        skill_dst = plugin_root / "skills" / "ckgraphify" / "SKILL.md"
-    elif platform == "claude" and os.environ.get("CLAUDE_CONFIG_DIR"):
+    if platform == "claude" and os.environ.get("CLAUDE_CONFIG_DIR"):
         _claude_base = Path(os.environ["CLAUDE_CONFIG_DIR"])
         skill_dst = _claude_base / "skills" / "ckgraphify" / "SKILL.md"
     else:
@@ -149,7 +112,7 @@ def install(platform: str = "claude") -> None:
     (skill_dst.parent / ".ckgraphify_version").write_text(__version__, encoding="utf-8")
     print(f"  skill installed  ->  {skill_dst}")
 
-    if cfg["claude_md"] and not installing_to_plugin:
+    if cfg["claude_md"]:
         # Register in ~/.claude/CLAUDE.md (Claude Code only)
         claude_md = Path.home() / ".claude" / "CLAUDE.md"
         if claude_md.exists():
@@ -163,13 +126,6 @@ def install(platform: str = "claude") -> None:
             claude_md.parent.mkdir(parents=True, exist_ok=True)
             claude_md.write_text(_SKILL_REGISTRATION.lstrip(), encoding="utf-8")
             print(f"  CLAUDE.md        ->  created at {claude_md}")
-    elif installing_to_plugin:
-        print(f"  plugin root      ->  {plugin_root}")
-
-    # Refresh version stamps in all other previously-installed skill dirs so
-    # stale-version warnings don't fire for platforms not explicitly re-installed.
-    _refresh_all_version_stamps()
-
     print()
     print("Done. Open your AI coding assistant and type:")
     print()
@@ -485,7 +441,6 @@ def _clone_repo(url: str, branch: str | None = None, out_dir: Path | None = None
 
     Clones into ~/.graphify/repos/<owner>/<repo> by default so repeated
     runs on the same URL reuse the existing clone (git pull instead of clone).
-    In Claude Code plugin mode, the cache lives under ${CLAUDE_PLUGIN_ROOT}/repos.
     """
     import subprocess as _sp
     import re as _re
@@ -539,15 +494,6 @@ def _clone_repo(url: str, branch: str | None = None, out_dir: Path | None = None
 
 
 def main() -> None:
-    # Check all known skill install locations for a stale version stamp.
-    # Skip during install/uninstall (hook writes trigger a fresh check anyway).
-    # Skip during hook-check — it runs on every editor tool use and must be silent.
-    # Deduplicate paths so platforms sharing the same install dir don't warn twice.
-    _silent_cmds = {"install", "uninstall", "hook-check"}
-    if not any(arg in _silent_cmds for arg in sys.argv):
-        for skill_dst in {Path.home() / cfg["skill_dst"] for cfg in _PLATFORM_CONFIG.values()}:
-            _check_skill_version(skill_dst)
-
     if len(sys.argv) >= 2 and sys.argv[1] in ("-v", "--version", "version"):
         print(f"graphify {__version__}")
         return
@@ -1887,10 +1833,6 @@ def main() -> None:
                 i += 1
             else:
                 i += 1
-        if repos_root is None:
-            plugin_root = _claude_plugin_root()
-            if plugin_root is not None:
-                repos_root = plugin_root / "repos"
         if repos_root is None:
             print(
                 "Usage: graphify bridge-mtop --repos-root <path> [--graph-in in.json] "

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/graphify/business_map.py

@@ -300,9 +300,6 @@ def find_kg_banks_root(start: Path | None = None) -> Path | None:
 
 
 def default_business_map_path(start: Path | None = None) -> Path:
-    plugin_root = os.environ.get("CLAUDE_PLUGIN_ROOT", "").strip()
-    if plugin_root:
-        return Path(plugin_root).expanduser().resolve() / "graphify-out" / "business-map.json"
     root = find_kg_banks_root(start)
     if root is not None:
         return root / "graphify-out" / "business-map.json"
@@ -342,21 +339,6 @@ def resolve_bound_graph_path(map_path: Path, graph_ref: str) -> Path:
 
 
 def default_business_graph_path(map_path: Path, start: Path | None = None) -> Path | None:
-    plugin_root = os.environ.get("CLAUDE_PLUGIN_ROOT", "").strip()
-    if plugin_root:
-        graphify_out = Path(plugin_root).expanduser().resolve() / "graphify-out"
-        graph = graphify_out / "graph.json"
-        if graph.exists():
-            return graph
-        legacy_graph = graphify_out / "graph-hc.json"
-        if legacy_graph.exists():
-            return legacy_graph
-        candidates = sorted(
-            p for p in graphify_out.glob("graph*.json")
-            if p.name != "business-map.json"
-        )
-        return candidates[0] if candidates else None
-
     if Path(map_path).exists():
         graph_ref = _business_map_graph_ref(load_business_map(Path(map_path)))
         if graph_ref:

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ckgraphify"
-version = "0.2.0"
+version = "0.2.2"
 description = "AI coding assistant skill for Claude Code and Codex - graph-main boundary graphs, multi-repo call chains, business-map concepts, and business search"
 readme = "README.md"
 license = "MIT"

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/skill/skill-codex.md

@@ -15,8 +15,8 @@ The public API is `$ckgraphify ...`. Treat it as an assistant API: translate it
 Before running any `graphify` command, prefer a project-local CLI. In a Claude plugin checkout, run the bundled setup script once per session:
 
 ```bash
-if [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -x "${CLAUDE_PLUGIN_ROOT}/scripts/setup-ckgraphify.sh" ]; then
-  "${CLAUDE_PLUGIN_ROOT}/scripts/setup-ckgraphify.sh"
+if [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -x "${CLAUDE_PLUGIN_ROOT}/scripts/prepare-ckgraphify.sh" ]; then
+  "${CLAUDE_PLUGIN_ROOT}/scripts/prepare-ckgraphify.sh"
   export GRAPHIFY="${CLAUDE_PLUGIN_ROOT}/.graphify/bin/graphify"
 else
   command -v graphify >/dev/null 2>&1 || { echo "graphify is not installed; install ckgraphify with Python >= 3.10" >&2; exit 1; }

{ckgraphify-0.2.0 → ckgraphify-0.2.2}/skill/skill.md

@@ -11,13 +11,13 @@ trigger: /ckgraphify
 Before running any `graphify` command in the Claude plugin environment, ensure the project-local CLI is available by running the bundled setup script once per session:
 
 ```bash
-"${CLAUDE_PLUGIN_ROOT}/scripts/setup-ckgraphify.sh"
+"${CLAUDE_PLUGIN_ROOT}/scripts/prepare-ckgraphify.sh"
 export GRAPHIFY="${CLAUDE_PLUGIN_ROOT}/.graphify/bin/graphify"
 ```
 
-The setup script also runs `${CLAUDE_PLUGIN_ROOT}/scripts/sync-artifacts.sh`. Before using the default graph or business map, this sync script queries the production kg-server (`KG_SERVER_URL`, default `https://kg-banks.alibaba.net`) for the lightweight latest manifest. If the remote graph/concept versions and checksums already match the local manifest, it does not download files.
+The prepare script ensures the shared Python environment has `ckgraphify`, writes the plugin-local CLI wrapper, and runs `${CLAUDE_PLUGIN_ROOT}/scripts/sync-artifacts.sh`. If Bash does not inherit `${CLAUDE_PLUGIN_ROOT}`, the prepare script resolves the plugin root from its own script location. Before using the default graph or business map, the sync script queries the production kg-server (`KG_SERVER_URL`, default `https://kg-banks.alibaba.net`) for the lightweight latest manifest. If the remote graph/concept versions and checksums already match the local manifest, it does not download files.
 
-If `${CLAUDE_PLUGIN_ROOT}` is missing, report that the Claude plugin environment is not active. Do not use macOS `/usr/bin/python3` or `sudo pip`. Do not inline the setup script from this skill; run the bundled script so quoting, checksum validation, and Python selection stay deterministic.
+If the plugin root cannot be determined from the skill context or the prepare script path, report that the Claude plugin environment is not active. Do not use macOS `/usr/bin/python3` or `sudo pip`. Do not inline the setup script from this skill; run the bundled script so quoting, checksum validation, and Python selection stay deterministic.
 
 ## User API
 
@@ -63,10 +63,10 @@ Show this API briefly.
 Prefer existing deterministic commands:
 
 ```bash
-"${GRAPHIFY:-graphify}" business-show --map <map> --concept <concept>
-"${GRAPHIFY:-graphify}" business-query "<question>" --map <map> --graph <graph> --trace --format text
-"${GRAPHIFY:-graphify}" business-trace --map <map> --graph <graph> --concept <concept> --scenario <scenario> --flow <flow> --max-depth <n> --sources
-"${GRAPHIFY:-graphify}" main-trace --graph <graph> --from <exact-node> --api <api> --max-depth <n> --sources --prefer-repo <repo> --exclude-repo <repo>
+"${GRAPHIFY:-graphify}" business-show --map "${CLAUDE_PLUGIN_ROOT}/graphify-out/business-map.json" --concept <concept>
+"${GRAPHIFY:-graphify}" business-query "<question>" --map "${CLAUDE_PLUGIN_ROOT}/graphify-out/business-map.json" --graph "${CLAUDE_PLUGIN_ROOT}/graphify-out/graph.json" --trace --format text
+"${GRAPHIFY:-graphify}" business-trace --map "${CLAUDE_PLUGIN_ROOT}/graphify-out/business-map.json" --graph "${CLAUDE_PLUGIN_ROOT}/graphify-out/graph.json" --concept <concept> --scenario <scenario> --flow <flow> --max-depth <n> --sources
+"${GRAPHIFY:-graphify}" main-trace --graph "${CLAUDE_PLUGIN_ROOT}/graphify-out/graph.json" --from <exact-node> --api <api> --max-depth <n> --sources --prefer-repo <repo> --exclude-repo <repo>
 ```
 
 ## Graph Scope