infini-cli 0.1.0__py3-none-any.whl

infini_cli-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,18 @@
+infini/__init__.py,sha256=hZj9QhOb5A17a191GIYdUK6Pa4PVoT_H6vAugLoTLLs,117
+infini/__main__.py,sha256=Pwe_ejewY25INYi1zRyqYkeFQfgQBYpclvIVwu-XF-o,67
+infini/adapters.py,sha256=twmSIwf8Xsb15J1ntex9ITypbKApqwq1y-obrhs7zQQ,2173
+infini/cli.py,sha256=NlCu27DYRGv_WGX7LmLRWjLNST3MMs_2YbUPPvlGmrA,10715
+infini/diff.py,sha256=lT9bp1boKpHJC_gI2Eldx6_hoT-449mIYlwzCBTmdX4,6958
+infini/engine.py,sha256=_h__o_6vst-RLnzgP2FuLwbK35nmU7muYZlmLv82BxQ,7462
+infini/inspect.py,sha256=nawR65_LEBzwliGouxruNzvWrrnsCrNs78RyZ1pEQFA,3522
+infini/mock.py,sha256=_3rYhXnOFncur-NXrikBy1NeYLEkRLEggZ8K29EqwLw,3502
+infini/parse.py,sha256=WL_m6SEFSOqwRQ2KYOWA8sSsH53Goi33R-_KsGfSGuQ,5597
+infini/replay.py,sha256=7oRqhjbfaj0SX5cH8ld10GRUaZHrYHupIDo1nUAt1Jk,5300
+infini/schema.json,sha256=eOTxnqdrMSvonbhBvfBM5t-d4AakqbyBOt-hcidQ8AQ,5274
+infini/trace.py,sha256=E_Wo58wOKnBw__XnuTJJLzHqJ-sSExY7GAkRaaMDU7c,5311
+infini/ui.py,sha256=NJWoCg0b9l2oSX7mAXh4WkyRLS5gWWYn3NZszCClqyA,3361
+infini_cli-0.1.0.dist-info/METADATA,sha256=-XiIeWEge4x3sYcfDz5I7FbcH3SjM4iVgVYMHVBf4_U,5490
+infini_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+infini_cli-0.1.0.dist-info/entry_points.txt,sha256=kvvzDKKPxIMbawPBaHVvQlQnQ3Jwx7fTyMOChoSx6o8,43
+infini_cli-0.1.0.dist-info/top_level.txt,sha256=3DBo5l7eEus-AzE5TLqknRYx4CqCTh_x9mXCiUK7-y0,7
+infini_cli-0.1.0.dist-info/RECORD,,

infini_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

infini_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+infini = infini.cli:main

infini_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+infini