open-knowledge-studio 0.2.2__tar.gz → 0.2.3__tar.gz

{open_knowledge_studio-0.2.2/open_knowledge_studio.egg-info → open_knowledge_studio-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-knowledge-studio
-Version: 0.2.2
+Version: 0.2.3
 Summary: File-based knowledge engineering CLI for Claude Code
 Author: open-agent-power
 License: MIT

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/knowledge_studio/_assets/claude/hooks/user-prompt-recall.sh

@@ -3,4 +3,6 @@
 # Passes the original stdin (editor JSON payload) through to the Python hook,
 # and drops jieba's stderr chatter so only the clean <recalled-memory> block
 # reaches stdout. Fails open (exit 0) so a prompt is never blocked.
-exec python3 "$(dirname "$0")/user-prompt-recall.py" 2>/dev/null
+# OKS_PYTHON is baked in by `oks hook install` to point at the interpreter
+# that can import knowledge_studio (pipx/venv safe); falls back to python3.
+exec "${OKS_PYTHON:-python3}" "$(dirname "$0")/user-prompt-recall.py" 2>/dev/null

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/knowledge_studio/cli.py

@@ -24,6 +24,27 @@ app = typer.Typer(
 )
 console = Console()
 
+
+def _version_callback(value: bool):
+    if value:
+        from importlib.metadata import version, PackageNotFoundError
+        try:
+            console.print(f"oks {version('open-knowledge-studio')}")
+        except PackageNotFoundError:
+            console.print("oks (development, not installed as a package)")
+        raise typer.Exit()
+
+
+@app.callback()
+def _main(
+    version: bool = typer.Option(
+        False, "--version", "-V", callback=_version_callback, is_eager=True,
+        help="Show the oks version and exit.",
+    ),
+):
+    pass
+
+
 wiki_app = typer.Typer(help="Wiki page management.")
 drafts_app = typer.Typer(help="Draft proposal management.")
 config_app = typer.Typer(help="Global configuration (~/.oks/config.json).")
@@ -191,8 +212,18 @@ def wiki_create(
     if not content and not sys.stdin.isatty():
         content = sys.stdin.read()
 
-    type_map = {"concept": "concepts", "strategy": "strategies", "anti-pattern": "anti-patterns"}
-    wiki_type = type_map.get(page_type, "concepts")
+    type_map = {
+        "concept": "concepts", "concepts": "concepts",
+        "strategy": "strategies", "strategies": "strategies",
+        "anti-pattern": "anti-patterns", "anti-patterns": "anti-patterns",
+    }
+    wiki_type = type_map.get(page_type)
+    if wiki_type is None:
+        console.print(
+            f"[yellow]Unknown --type '{page_type}' — using 'concept'. "
+            f"Valid: concept, strategy, anti-pattern.[/yellow]"
+        )
+        wiki_type = "concepts"
 
     path = store.write_wiki_page(
         title=title,
@@ -617,7 +648,11 @@ def init(
 
     base, is_packaged = _asset_source()
     if base is None:
-        console.print("[yellow]No bundled assets found — skills/templates not materialized.[/yellow]")
+        console.print(
+            "[yellow]No bundled assets found — skills/templates not materialized.[/yellow]\n"
+            "  Source installs lack the asset bundle. Fix: pip install open-knowledge-studio,\n"
+            "  or run python cli/scripts/bundle_assets.py in the repo before installing."
+        )
     else:
         copied = _materialize_assets(root, base, is_packaged, overwrite=upgrade)
         if copied:
@@ -696,6 +731,12 @@ def _ensure_recall_scripts(root: Path) -> list[str]:
                 f"bundled hook script not found: {name} (asset source: {src_dir})"
             )
         shutil.copy2(src_dir / name, dest)
+        if name.endswith(".sh"):
+            import sys
+            text = dest.read_text(encoding="utf-8").replace(
+                '"${OKS_PYTHON:-python3}"', f'"${{OKS_PYTHON:-{sys.executable}}}"'
+            )
+            dest.write_text(text, encoding="utf-8")
         dest.chmod(dest.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
         created.append(name)
     return created
@@ -757,12 +798,29 @@ def hook_install(
         console.print("[red]--editor must be one of: claude, qoder, both[/red]")
         raise typer.Exit(1)
 
+    import platform
+    if platform.system() == "Windows":
+        console.print(
+            "[yellow]Warning: hooks are bash scripts and will not run on native Windows.[/yellow]\n"
+            "  Use WSL (or Git Bash configured as the hook shell) for auto-recall to work."
+        )
+
     root = _instance_root(path)
     if not root.is_dir():
         console.print(f"[red]Instance root not found:[/red] {root}")
         raise typer.Exit(1)
 
-    created = _ensure_recall_scripts(root)
+    try:
+        created = _ensure_recall_scripts(root)
+    except FileNotFoundError as e:
+        console.print(
+            f"[red]Cannot install hook — bundled assets missing.[/red]\n"
+            f"  {e}\n"
+            f"  This happens when oks was installed from source without the asset bundle.\n"
+            f"  Fix: [bold]pip install open-knowledge-studio[/bold] (PyPI wheel includes assets),\n"
+            f"  or run [bold]python cli/scripts/bundle_assets.py[/bold] in the repo before installing."
+        )
+        raise typer.Exit(1)
     if created:
         console.print(f"[green]Installed hook script:[/green] {', '.join(created)}")
 
@@ -788,6 +846,22 @@ def hook_status(
     script = root / ".claude" / "hooks" / "user-prompt-recall.sh"
     console.print(f"[bold]Instance:[/bold] {root}")
     console.print(f"  script: {'present' if script.is_file() else 'missing'} ({script})")
+    if script.is_file():
+        import os
+        import re
+        import subprocess
+        m = re.search(r"\$\{OKS_PYTHON:-([^}]+)\}", script.read_text(encoding="utf-8"))
+        py = os.environ.get("OKS_PYTHON") or (m.group(1) if m else "python3")
+        try:
+            ok = subprocess.run(
+                [py, "-c", "import knowledge_studio"],
+                capture_output=True, timeout=15,
+            ).returncode == 0
+        except (OSError, subprocess.TimeoutExpired):
+            ok = False
+        state = ("[green]importable[/green]" if ok
+                 else "[red]NOT importable — hook will silently no-op; re-run oks hook install[/red]")
+        console.print(f"  engine: {state} (python: {py})")
     for name, rel in _HOOK_EDITORS.items():
         settings_path = root / rel
         wired = _hook_is_wired(settings_path, _RECALL_HOOK_CMD)

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/knowledge_studio/config.py

@@ -61,8 +61,14 @@ def load_config() -> dict[str, Any]:
     path = config_path()
     if not path.exists():
         return dict(DEFAULT_CONFIG)
-    with open(path) as f:
-        return json.load(f)
+    try:
+        with open(path) as f:
+            return json.load(f)
+    except json.JSONDecodeError as e:
+        raise ValueError(
+            f"{path} is corrupt ({e}). Fix the JSON manually, or delete it and "
+            f"re-run `oks config init` / `oks init <path>`."
+        ) from e
 
 
 def save_config(config: dict[str, Any]) -> None:
@@ -70,6 +76,7 @@ def save_config(config: dict[str, Any]) -> None:
     path = config_path()
     path.parent.mkdir(parents=True, exist_ok=True)
 
+    import contextlib
     import tempfile
     fd, tmp = tempfile.mkstemp(dir=str(path.parent), suffix=".tmp")
     try:
@@ -77,7 +84,8 @@ def save_config(config: dict[str, Any]) -> None:
             json.dump(config, f, indent=2, ensure_ascii=False)
         os.replace(tmp, path)
     except Exception:
-        os.unlink(tmp)
+        with contextlib.suppress(OSError):
+            os.unlink(tmp)
         raise
 
 

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/knowledge_studio/metrics.py

@@ -5,7 +5,7 @@ Removed KnowledgeStore dependency. Uses store functions.
 """
 from __future__ import annotations
 
-from datetime import UTC, datetime, timedelta
+from datetime import UTC, date, datetime, timedelta
 
 from knowledge_studio.store import list_wiki_pages, repo_root, wiki_dir
 
@@ -86,11 +86,15 @@ def _compute_credibility(pages: list[dict], ninety_days_ago: datetime) -> dict:
     }
 
 
-def _parse_date(value: str | None) -> datetime:
+def _parse_date(value) -> datetime:
     if not value:
         return datetime.min.replace(tzinfo=UTC)
+    if isinstance(value, datetime):
+        return value if value.tzinfo else value.replace(tzinfo=UTC)
+    if isinstance(value, date):
+        return datetime(value.year, value.month, value.day, tzinfo=UTC)
     try:
-        dt = datetime.fromisoformat(value)
+        dt = datetime.fromisoformat(str(value))
         if dt.tzinfo is None:
             dt = dt.replace(tzinfo=UTC)
         return dt

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/knowledge_studio/store.py

@@ -13,7 +13,7 @@ import math
 import os
 import re
 import tempfile
-from datetime import UTC, datetime
+from datetime import UTC, date, datetime
 from pathlib import Path
 
 import yaml
@@ -44,8 +44,13 @@ def repo_root() -> Path:
         kb_path = load_config().get("knowledge_base_path")
         if kb_path:
             return Path(kb_path)
-    except Exception:
-        pass
+    except Exception as e:
+        import sys
+        print(
+            f"oks: warning: could not read ~/.oks/config.json ({e}); "
+            f"falling back to current directory as KB root",
+            file=sys.stderr,
+        )
     return Path(os.getcwd())
 
 
@@ -187,11 +192,16 @@ def compute_score(meta: dict, access_count: int = 0, config: dict | None = None)
     if archived or status == "dropped":
         return 0.0
 
-    created_str = meta.get("created", "")
-    try:
-        created = datetime.fromisoformat(created_str)
-    except (ValueError, TypeError):
-        created = datetime.now(UTC)
+    created_raw = meta.get("created", "")
+    if isinstance(created_raw, datetime):
+        created = created_raw
+    elif isinstance(created_raw, date):
+        created = datetime(created_raw.year, created_raw.month, created_raw.day)
+    else:
+        try:
+            created = datetime.fromisoformat(str(created_raw))
+        except (ValueError, TypeError):
+            created = datetime.now(UTC)
 
     tz = UTC if not created.tzinfo else created.tzinfo
     days_old = max(0, (datetime.now(UTC) - created.replace(tzinfo=tz)).days)
@@ -274,18 +284,19 @@ def _find_file_by_slug(slug: str) -> Path | None:
     return None
 
 
-def _update_frontmatter_field(file_path: Path, field: str, value) -> None:
+def _update_frontmatter_field(file_path: Path, field: str, value) -> bool:
     text = file_path.read_text(encoding="utf-8")
     parts = text.split("---", 2)
     if len(parts) < 3:
-        return
+        return False
     try:
         meta = yaml.safe_load(parts[1].strip()) or {}
     except yaml.YAMLError:
-        return
+        return False
     meta[field] = value
     new_fm = yaml.dump(meta, default_flow_style=False, allow_unicode=True, sort_keys=False)
     _atomic_write(file_path, f"---\n{new_fm}---\n{parts[2]}")
+    return True
 
 
 def _reinforce_confidence(slug: str) -> None:
@@ -493,17 +504,16 @@ def pin_page(slug: str) -> bool:
     f = _find_file_by_slug(slug)
     if not f:
         return False
-    _update_frontmatter_field(f, "pinned", True)
-    return True
+    return _update_frontmatter_field(f, "pinned", True)
 
 
 def archive_page(slug: str) -> bool:
     f = _find_file_by_slug(slug)
     if not f:
         return False
-    _update_frontmatter_field(f, "status", "dropped")
-    _update_frontmatter_field(f, "archived", True)
-    return True
+    dropped = _update_frontmatter_field(f, "status", "dropped")
+    archived = _update_frontmatter_field(f, "archived", True)
+    return dropped and archived
 
 
 def list_drafts() -> list[dict]:
@@ -547,7 +557,12 @@ def promote_draft(
     body = meta.get("body", "")
 
     final_title = title or meta.get("title", slug)
-    final_type = (wiki_type or meta.get("draft_type", "concepts")).rstrip("s") + "s"
+    _type_dirs = {
+        "concept": "concepts", "concepts": "concepts",
+        "strategy": "strategies", "strategies": "strategies",
+        "anti-pattern": "anti-patterns", "anti-patterns": "anti-patterns",
+    }
+    final_type = _type_dirs.get(wiki_type or meta.get("draft_type", "concept"), "concepts")
     final_area = area or meta.get("draft_area", "computing")
     human_note = meta.get("source_note") or None
 

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3/open_knowledge_studio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-knowledge-studio
-Version: 0.2.2
+Version: 0.2.3
 Summary: File-based knowledge engineering CLI for Claude Code
 Author: open-agent-power
 License: MIT

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/open_knowledge_studio.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
+setup.py
 knowledge_studio/__init__.py
 knowledge_studio/cli.py
 knowledge_studio/config.py

{open_knowledge_studio-0.2.2 → open_knowledge_studio-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "open-knowledge-studio"
-version = "0.2.2"
+version = "0.2.3"
 description = "File-based knowledge engineering CLI for Claude Code"
 readme = "README.md"
 license = {text = "MIT"}

open_knowledge_studio-0.2.3/setup.py

@@ -0,0 +1,42 @@
+"""Build hook: bundle the shareable asset layer during any source build.
+
+The repo root is the single source of truth for `.claude/`, `templates/`,
+`_meta/`, `settings/`. When building from a git checkout (pip install ./cli,
+pip install git+...#subdirectory=cli, python -m build), copy them into
+`knowledge_studio/_assets/` before build_py runs, so source installs are
+identical to PyPI wheels. When building from an sdist the repo root is
+absent and `_assets/` is already included via MANIFEST.in — skip silently.
+"""
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+from setuptools import setup
+from setuptools.command.build_py import build_py
+
+_MAP = [
+    (".claude", "claude"),
+    ("templates", "templates"),
+    ("_meta", "_meta"),
+    ("settings", "settings"),
+]
+
+
+class build_py_with_assets(build_py):
+    def run(self):
+        cli_dir = Path(__file__).resolve().parent
+        repo_root = cli_dir.parent
+        if (repo_root / ".claude").is_dir() and (repo_root / "templates").is_dir():
+            dest_root = cli_dir / "knowledge_studio" / "_assets"
+            if dest_root.exists():
+                shutil.rmtree(dest_root)
+            dest_root.mkdir(parents=True)
+            for src_name, dest_name in _MAP:
+                src = repo_root / src_name
+                if src.is_dir():
+                    shutil.copytree(src, dest_root / dest_name)
+        super().run()
+
+
+setup(cmdclass={"build_py": build_py_with_assets})