infini-cli 0.1.0__tar.gz

infini_cli-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: infini-cli
+Version: 0.1.0
+Summary: INFINI — the open standard for agent loops. Write a Loopfile, run it on any engine.
+Author: NickAiNYC and INFINI contributors
+License: MIT
+Project-URL: Homepage, https://github.com/NickAiNYC/infini
+Project-URL: Documentation, https://github.com/NickAiNYC/infini#readme
+Project-URL: Repository, https://github.com/NickAiNYC/infini
+Project-URL: Issues, https://github.com/NickAiNYC/infini/issues
+Keywords: agents,loops,ai,standard,loopfile,infini
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: rich>=13.0
+Requires-Dist: click>=8.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Provides-Extra: ui
+Requires-Dist: flask>=3.0; extra == "ui"
+
+# INFINI CLI
+
+The reference implementation of the `infini` command-line tool.
+
+> The CLI is the **INFINI Reference Engine**. It conforms to the same Loopfile spec as every other engine. The only asymmetry: it ships first with new spec features, since the spec is developed against it.
+
+---
+
+## Install
+
+```bash
+pip install infini-cli
+
+# With adapter extras
+pip install infini-cli[hermes,openclaw]
+
+# From source
+git clone https://github.com/NickAiNYC/infini
+cd infini/cli && pip install -e .
+```
+
+Requires Python 3.10+.
+
+---
+
+## Commands
+
+```bash
+infini validate  [Loopfile]   # check spec compliance
+infini run       [Loopfile]   # execute a loop (--mock for no API key)
+infini inspect   [run_dir]    # inspect a trace (--web opens Observatory, coming soon)
+infini replay    [run_dir]    # time-travel debug from any step
+infini diff      [v1] [v2]    # semantic diff between loops or traces
+infini ui        [trace]      # launch the Observatory web app
+infini engines                # list detected adapters (reads adapter.yaml)
+infini init      [--target]   # scaffold a minimal project (Loopfile, loops/, state/, runs/)
+infini new       <name>       # create a new project scaffold
+infini graph     [Loopfile]   # render a simple ASCII graph of steps
+infini benchmark [Loopfile]   # preview benchmark estimate (real profiling needs a run)
+```
+
+### Commands not yet implemented (planned)
+
+```bash
+infini install   [loop_ref]   # pull from registry (planned — registry not yet live)
+infini publish   [Loopfile]   # push to registry (planned)
+infini ci        [Loopfile]   # run loop against fixtures (GitHub Action)
+infini search    [query]      # search the registry (planned)
+infini migrate   [Loopfile]   # migrate a Loopfile between spec versions
+infini keys generate           # generate a publisher signing keypair
+```
+
+### Mock mode
+
+`infini run --mock` simulates LLM calls so you can run any Loopfile
+without an API key. Useful for evaluation, CI, demos, and the conformance
+suite. Mock mode is deterministic: same Loopfile + same seed = same output.
+
+---
+
+## Conformance
+
+The CLI implements:
+
+| Capability       | Status |
+| ---------------- | :----: |
+| Parse Loopfile   |   ✅   |
+| Run Loop         |   ✅   |
+| Verify           |   ✅   |
+| Inspect Trace    |   ✅   |
+| Replay           |   ✅   |
+| Diff             |   ✅   |
+
+This makes the CLI the **canonical conformance reference**. If your adapter disagrees with the CLI on a spec edge case, the CLI is right until an RFC says otherwise.
+
+---
+
+## Architecture
+
+```
+cli/
+├── README.md           # you are here
+├── pyproject.toml      # package metadata
+├── src/infini/
+│   ├── __init__.py
+│   ├── main.py         # entrypoint
+│   ├── parse.py        # Loopfile parser
+│   ├── validate.py     # JSON Schema validator
+│   ├── run.py          # reference engine
+│   ├── inspect.py      # trace inspector (Loop Observatory)
+│   ├── replay.py       # time-travel debugger
+│   ├── diff.py         # semantic diff
+│   ├── registry.py     # publish/install/search
+│   ├── ci.py           # CI mode
+│   ├── migrate.py      # spec migration
+│   └── keys.py         # signing key management
+└── tests/
+    ├── conformance/    # spec conformance suite
+    ├── fixtures/       # example Loopfiles
+    └── expected/       # expected trace shapes
+```
+
+The full source ships with the next CLI release. This README documents the contract.
+
+---
+
+## The Loop Observatory
+
+`infini inspect <run_dir>` opens the Loop Observatory — the signature feature.
+
+The Observatory shows, for any run:
+
+- the graph of decisions taken,
+- every verification checkpoint and its verdict,
+- total runtime, token count, and dollar cost,
+- artifacts produced at each step,
+- where the loop failed (if it did), and what was retried,
+- what changed between iterations,
+- governance events (Hermes) and tool calls (OpenClaw) in a swimlane view.
+
+The Inspector ships today. The full UI (annotated timeline, cost waterfall, artifact gallery, replay studio) is in preview.
+
+---
+
+## License
+
+MIT. See [repository LICENSE](../LICENSE).

infini_cli-0.1.0/README.md

@@ -0,0 +1,127 @@
+# INFINI CLI
+
+The reference implementation of the `infini` command-line tool.
+
+> The CLI is the **INFINI Reference Engine**. It conforms to the same Loopfile spec as every other engine. The only asymmetry: it ships first with new spec features, since the spec is developed against it.
+
+---
+
+## Install
+
+```bash
+pip install infini-cli
+
+# With adapter extras
+pip install infini-cli[hermes,openclaw]
+
+# From source
+git clone https://github.com/NickAiNYC/infini
+cd infini/cli && pip install -e .
+```
+
+Requires Python 3.10+.
+
+---
+
+## Commands
+
+```bash
+infini validate  [Loopfile]   # check spec compliance
+infini run       [Loopfile]   # execute a loop (--mock for no API key)
+infini inspect   [run_dir]    # inspect a trace (--web opens Observatory, coming soon)
+infini replay    [run_dir]    # time-travel debug from any step
+infini diff      [v1] [v2]    # semantic diff between loops or traces
+infini ui        [trace]      # launch the Observatory web app
+infini engines                # list detected adapters (reads adapter.yaml)
+infini init      [--target]   # scaffold a minimal project (Loopfile, loops/, state/, runs/)
+infini new       <name>       # create a new project scaffold
+infini graph     [Loopfile]   # render a simple ASCII graph of steps
+infini benchmark [Loopfile]   # preview benchmark estimate (real profiling needs a run)
+```
+
+### Commands not yet implemented (planned)
+
+```bash
+infini install   [loop_ref]   # pull from registry (planned — registry not yet live)
+infini publish   [Loopfile]   # push to registry (planned)
+infini ci        [Loopfile]   # run loop against fixtures (GitHub Action)
+infini search    [query]      # search the registry (planned)
+infini migrate   [Loopfile]   # migrate a Loopfile between spec versions
+infini keys generate           # generate a publisher signing keypair
+```
+
+### Mock mode
+
+`infini run --mock` simulates LLM calls so you can run any Loopfile
+without an API key. Useful for evaluation, CI, demos, and the conformance
+suite. Mock mode is deterministic: same Loopfile + same seed = same output.
+
+---
+
+## Conformance
+
+The CLI implements:
+
+| Capability       | Status |
+| ---------------- | :----: |
+| Parse Loopfile   |   ✅   |
+| Run Loop         |   ✅   |
+| Verify           |   ✅   |
+| Inspect Trace    |   ✅   |
+| Replay           |   ✅   |
+| Diff             |   ✅   |
+
+This makes the CLI the **canonical conformance reference**. If your adapter disagrees with the CLI on a spec edge case, the CLI is right until an RFC says otherwise.
+
+---
+
+## Architecture
+
+```
+cli/
+├── README.md           # you are here
+├── pyproject.toml      # package metadata
+├── src/infini/
+│   ├── __init__.py
+│   ├── main.py         # entrypoint
+│   ├── parse.py        # Loopfile parser
+│   ├── validate.py     # JSON Schema validator
+│   ├── run.py          # reference engine
+│   ├── inspect.py      # trace inspector (Loop Observatory)
+│   ├── replay.py       # time-travel debugger
+│   ├── diff.py         # semantic diff
+│   ├── registry.py     # publish/install/search
+│   ├── ci.py           # CI mode
+│   ├── migrate.py      # spec migration
+│   └── keys.py         # signing key management
+└── tests/
+    ├── conformance/    # spec conformance suite
+    ├── fixtures/       # example Loopfiles
+    └── expected/       # expected trace shapes
+```
+
+The full source ships with the next CLI release. This README documents the contract.
+
+---
+
+## The Loop Observatory
+
+`infini inspect <run_dir>` opens the Loop Observatory — the signature feature.
+
+The Observatory shows, for any run:
+
+- the graph of decisions taken,
+- every verification checkpoint and its verdict,
+- total runtime, token count, and dollar cost,
+- artifacts produced at each step,
+- where the loop failed (if it did), and what was retried,
+- what changed between iterations,
+- governance events (Hermes) and tool calls (OpenClaw) in a swimlane view.
+
+The Inspector ships today. The full UI (annotated timeline, cost waterfall, artifact gallery, replay studio) is in preview.
+
+---
+
+## License
+
+MIT. See [repository LICENSE](../LICENSE).

infini_cli-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "infini-cli"
+version = "0.1.0"
+description = "INFINI — the open standard for agent loops. Write a Loopfile, run it on any engine."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "NickAiNYC and INFINI contributors" }]
+keywords = ["agents", "loops", "ai", "standard", "loopfile", "infini"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "jsonschema>=4.20",
+    "rich>=13.0",
+    "click>=8.1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-cov"]
+ui = ["flask>=3.0"]
+
+[project.scripts]
+infini = "infini.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/NickAiNYC/infini"
+Documentation = "https://github.com/NickAiNYC/infini#readme"
+Repository = "https://github.com/NickAiNYC/infini"
+Issues = "https://github.com/NickAiNYC/infini/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+infini = ["schema.json"]

infini_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

infini_cli-0.1.0/src/infini/__init__.py

@@ -0,0 +1,6 @@
+"""INFINI — the open standard for agent loops.
+
+Write a Loopfile, run it on any engine.
+"""
+
+__version__ = "0.1.0"

infini_cli-0.1.0/src/infini/__main__.py

@@ -0,0 +1,4 @@
+from infini.cli import main
+
+if __name__ == "__main__":
+    main()

infini_cli-0.1.0/src/infini/adapters.py

@@ -0,0 +1,68 @@
+"""Adapter discovery and capability metadata.
+
+Scans the adapters/ directory for adapter.yaml manifests and reports
+actual capabilities (parse, run, verify, inspect, replay, diff) instead
+of just directory names.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+
+def find_adapters_dir(start: Optional[Path] = None) -> Optional[Path]:
+    """Search upwards from start (or cwd) for an adapters/ directory."""
+    p = Path(start or Path.cwd()).resolve()
+    root = p.anchor
+    while True:
+        candidate = p / "adapters"
+        if candidate.is_dir():
+            return candidate
+        if str(p) == root:
+            return None
+        p = p.parent
+
+
+def load_adapter_manifest(adapter_dir: Path) -> dict | None:
+    """Load an adapter's adapter.yaml manifest. Returns None if not found."""
+    manifest_path = adapter_dir / "adapter.yaml"
+    if not manifest_path.exists():
+        return None
+    try:
+        with manifest_path.open("r", encoding="utf-8") as fh:
+            data = yaml.safe_load(fh)
+        return data if isinstance(data, dict) else None
+    except Exception:
+        return None
+
+
+def detect_adapters(base: Optional[Path] = None) -> list[dict]:
+    """Scan for adapters and return their manifests.
+
+    Returns a list of dicts, each with at minimum:
+      - name: adapter directory name
+      - path: absolute path to the adapter directory
+      - manifest: the parsed adapter.yaml (or None if no manifest)
+      - capabilities: list of supported capability strings (from manifest, or [])
+    """
+    adapters_dir = find_adapters_dir(base)
+    if not adapters_dir:
+        return []
+
+    results = []
+    for p in sorted(adapters_dir.iterdir()):
+        if not p.is_dir():
+            continue
+        manifest = load_adapter_manifest(p)
+        caps = []
+        if manifest and isinstance(manifest.get("capabilities"), dict):
+            caps = [k for k, v in manifest["capabilities"].items() if v is True]
+        results.append({
+            "name": p.name,
+            "path": str(p),
+            "manifest": manifest,
+            "capabilities": caps,
+        })
+    return results