chronicle-dev 0.1.0__py3-none-any.whl

chronicle/__init__.py

@@ -0,0 +1,12 @@
+"""
+Chronicle — AI-native development memory.
+
+This package is a thin wrapper around the Node.js chronicle-dev CLI.
+For the full API, use the CLI directly or via subprocess.
+
+Example:
+    import subprocess
+    result = subprocess.run(["chronicle", "inject"], capture_output=True, text=True)
+    context = result.stdout
+"""
+__version__ = "0.1.0"

chronicle/_cli.py

@@ -0,0 +1,64 @@
+"""
+Subprocess wrapper — delegates all work to the Node binary (chronicle-dev).
+Requires Node ≥ 20 on PATH. The Node package is the source of truth.
+"""
+import shutil
+import subprocess
+import sys
+
+
+def _node_available() -> bool:
+    node = shutil.which("node")
+    if not node:
+        return False
+    try:
+        out = subprocess.check_output(["node", "--version"], text=True).strip()
+        major = int(out.lstrip("v").split(".")[0])
+        return major >= 20
+    except Exception:
+        return False
+
+
+def _chronicle_binary() -> list[str]:
+    """Return the command list that invokes the Node chronicle CLI.
+
+    Never calls 'chronicle' directly — that would call this Python wrapper
+    recursively. Always delegates to the Node package via npm/npx.
+    """
+    # If the user has `npm install -g chronicle-dev`, the Node binary lands
+    # at a path like /usr/local/bin/chronicle — but so does this Python script.
+    # We disambiguate by checking for the npm global bin explicitly.
+    npm = shutil.which("npm")
+    if npm:
+        try:
+            prefix = subprocess.check_output(
+                [npm, "root", "-g"], text=True, stderr=subprocess.DEVNULL
+            ).strip()
+            # npm global bin is one level up from global node_modules
+            import os
+            global_bin = os.path.join(os.path.dirname(prefix), "bin", "chronicle")
+            # Only use it if it's a Node script (not this Python script)
+            if os.path.exists(global_bin):
+                with open(global_bin) as f:
+                    first_line = f.readline()
+                if "node" in first_line and "python" not in first_line:
+                    return [global_bin]
+        except Exception:
+            pass
+
+    # Fallback: npx installs on-demand from npm registry
+    return ["npx", "--yes", "chronicle-dev"]
+
+
+def main() -> None:
+    if not _node_available():
+        print(
+            "Chronicle requires Node.js ≥ 20.\n"
+            "Install it from https://nodejs.org or via `brew install node`.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    cmd = _chronicle_binary() + sys.argv[1:]
+    result = subprocess.run(cmd)
+    sys.exit(result.returncode)

chronicle_dev-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: chronicle-dev
+Version: 0.1.0
+Summary: AI-native development memory — markdown RAG for every AI coding tool
+Project-URL: Homepage, https://github.com/ypollak2/chronicle
+Project-URL: Repository, https://github.com/ypollak2/chronicle
+Project-URL: Issues, https://github.com/ypollak2/chronicle/issues
+License: MIT
+Keywords: ai,claude,codex,cursor,developer-tools,llm,rag
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# chronicle-dev (Python)
+
+> AI-native development memory — markdown RAG for every AI coding tool
+
+This is the Python wrapper for [Chronicle](https://github.com/ypollak2/chronicle).
+It delegates all work to the Node.js CLI (`chronicle-dev` on npm).
+
+## Requirements
+
+- Python ≥ 3.9
+- Node.js ≥ 20 ([install](https://nodejs.org))
+
+## Install
+
+```bash
+pip install chronicle-dev
+```
+
+## Usage
+
+Identical to the npm version:
+
+```bash
+chronicle init                    # scan last 6 months of git history
+chronicle inject | claude         # pipe context into Claude
+chronicle inject | codex          # or Codex, Gemini CLI, Aider...
+chronicle hooks install           # passive capture on every commit
+chronicle deepen --depth=1year    # scan further back
+```
+
+## How it works
+
+`pip install chronicle-dev` installs a `chronicle` entry point that:
+1. Checks Node ≥ 20 is available
+2. Delegates to `chronicle` (if globally installed) or `npx chronicle-dev`
+
+The Node package is the source of truth. This wrapper exists so Python developers
+can install Chronicle without switching to npm.
+
+## Full docs
+
+See [github.com/ypollak2/chronicle](https://github.com/ypollak2/chronicle)

chronicle_dev-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+chronicle/__init__.py,sha256=jGN-JDr7EyQHNjL1TEKNrpCEjXr9L8rrhKxO9JGhmi4,347
+chronicle/_cli.py,sha256=WY4r_MTqseMwdc34ubAxe8VXXZ3wxq-pjI9f3hUANYk,2203
+chronicle_dev-0.1.0.dist-info/METADATA,sha256=gTB1iigbHJpAKxYR6Z6AQvorq1-Ek9qASpAn9u-Y1qs,1996
+chronicle_dev-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+chronicle_dev-0.1.0.dist-info/entry_points.txt,sha256=BFypbnmnCFRbNtaFgiOxbNHjh38krA3-ySk_boiByfI,50
+chronicle_dev-0.1.0.dist-info/RECORD,,

chronicle_dev-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

chronicle_dev-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chronicle = chronicle._cli:main