awkno 0.2.4__tar.gz → 0.2.5__tar.gz

{awkno-0.2.4 → awkno-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awkno
-Version: 0.2.4
+Version: 0.2.5
 Summary: The man page for the Aither World — every brick, stack and law, in your terminal, offline.
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/Aitherium/awkno

{awkno-0.2.4 → awkno-0.2.5}/awkno/__init__.py

@@ -15,7 +15,7 @@ from __future__ import annotations
 
 from awkno.corpus import AwknoPage, AwknoRegistry, NotFoundError
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"
 
 __all__ = [
     "AwknoRegistry",

{awkno-0.2.4 → awkno-0.2.5}/awkno/generate.py

@@ -240,6 +240,68 @@ class AwknoGenerator:
 
         return text
 
+
+    # ------------------------------------------------------------------ usage
+    def _brick_source_dir(self, brick: dict) -> Path | None:
+        """The brick's source tree, from the registry's `source` (monorepo-relative)."""
+        src = brick.get("source")
+        if not src:
+            return None
+        d = self.repo_root.parent / src
+        return d if d.is_dir() else None
+
+    def _brick_commands(self, brick: dict) -> list[str]:
+        """Console scripts the brick installs, read from `[project.scripts]`.
+
+        Static parse on purpose: the corpus is built on a runner that has not
+        installed the brick, and `--help` output would make the page depend on
+        the machine that rendered it.
+        """
+        d = self._brick_source_dir(brick)
+        if d is None or not (d / "pyproject.toml").is_file():
+            return []
+        try:
+            import tomllib  # noqa: PLC0415
+        except ModuleNotFoundError:  # CI floor is 3.10
+            try:
+                import tomli as tomllib  # type: ignore[no-redef]  # noqa: PLC0415
+            except ModuleNotFoundError:
+                return []
+        try:
+            data = tomllib.loads((d / "pyproject.toml").read_text(encoding="utf-8"))
+        except Exception:
+            return []
+        scripts = (data.get("project") or {}).get("scripts") or {}
+        return sorted(k for k in scripts if not k.startswith("_"))
+
+    def _brick_quick_start(self, brick: dict) -> str:
+        """The first fenced shell block a stranger can type, from the brick's README.
+
+        Chosen by position, not by heading name: the family's READMEs put the
+        one-line install and first run in the first fenced `bash`/`sh`/`console`
+        block after the title. Internal refs are scrubbed like every other field.
+        """
+        import re  # noqa: PLC0415
+        d = self._brick_source_dir(brick)
+        if d is None or not (d / "README.md").is_file():
+            return ""
+        text = (d / "README.md").read_text(encoding="utf-8", errors="replace")
+        for m in re.finditer(r"```(?:bash|sh|shell|console)?\n(.*?)```", text, re.S):
+            block = m.group(1).strip()
+            if not block or len(block) > 600:
+                continue
+            if re.search(r"\b[A-Z]:[\\/]|AitherOS/|\.PRODUCTS|\.DEPLOYMENT", block):
+                continue
+            return self._scrub_internal_refs(block)
+        return ""
+
+    @staticmethod
+    def _brick_docs_url(brick: dict) -> str:
+        """The brick's Pages site. Public bricks publish at aitherium.github.io/<id>/."""
+        if brick.get("status") != "public":
+            return ""
+        return f"https://aitherium.github.io/{brick.get('id')}/"
+
     def _make_brick_page(self, brick: dict) -> dict[str, Any]:
         """Create a page for a brick.
 
@@ -263,7 +325,18 @@ class AwknoGenerator:
         if problem:
             description += f"\nProblem\n{problem}\n"
         if install:
-            description += f"\nInstall\n{install}"
+            description += f"\nInstall\n{install}\n"
+        # The part that makes a man page a man page: what to TYPE. Derived from
+        # the brick's own pyproject and README so it cannot drift from the code.
+        commands = self._brick_commands(brick)
+        if commands:
+            description += "\nCommands\n" + "\n".join(f"  {c}" for c in commands) + "\n"
+        quick = self._brick_quick_start(brick)
+        if quick:
+            description += "\nQuick start\n" + "\n".join(f"  {ln}" for ln in quick.splitlines()) + "\n"
+        docs = self._brick_docs_url(brick)
+        if docs:
+            description += f"\nDocs\n{docs}\n"
 
         see_also = []
         if brick.get("pairs_with"):

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/aitherconnect.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Install it and ask an agent about the tab you are on.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nYour agent cannot see the page you are looking at, so you paste it in by hand.\n\nInstall\nload unpacked — see the repo",
+  "description": "Kind: tool\n\nProblem\nYour agent cannot see the page you are looking at, so you paste it in by hand.\n\nInstall\nload unpacked — see the repo\n\nDocs\nhttps://aitherium.github.io/AitherConnect/",
   "see_also": [
     "awdk"
   ],

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/aitherkvcache.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Quantize the cache on one model you already serve and measure the headroom.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nKV cache, not weights, is what runs a GPU out of room during real serving, and it grows with every token of every concurrent request.\n\nInstall\npip install aither-kvcache",
+  "description": "Kind: tool\n\nProblem\nKV cache, not weights, is what runs a GPU out of room during real serving, and it grows with every token of every concurrent request.\n\nInstall\npip install aither-kvcache\n\nDocs\nhttps://aitherium.github.io/aitherkvcache/",
   "see_also": [
     "awnode"
   ],

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/aitheros.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run one file on a fresh box and open the URL it prints.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nEvery part of the stack ships on its own lane -- a shell on npm, two runtimes on PyPI, a desktop app on GitHub Releases, an extension in a browser store -- so a person who wants the STACK has to find six things, install them in the right order and make them agree on ports and models. Measured 2026-09-10: every one of those lanes was live and the thing that joins them was published nowhere.\n\nInstall\nsee the repo — one binary per OS from the `aitheros-v*` release",
+  "description": "Kind: runtime\n\nProblem\nEvery part of the stack ships on its own lane -- a shell on npm, two runtimes on PyPI, a desktop app on GitHub Releases, an extension in a browser store -- so a person who wants the STACK has to find six things, install them in the right order and make them agree on ports and models. Measured 2026-09-10: every one of those lanes was live and the thing that joins them was published nowhere.\n\nInstall\nsee the repo — one binary per OS from the `aitheros-v*` release\n\nCommands\n  aitheros\n  gen\n  genesis\n\nQuick start\n  cd AitherOS\n  \n  # Create virtual environment\n  python -m venv.venv\n  source.venv/bin/activate # Linux/macOS\n  .venv\\Scripts\\activate # Windows\n  \n  # Install dependencies\n  pip install -e \".[dev]\"\n  \n  # Set testing flag (required for tests)\n  export AITHER_TESTING=1",
   "see_also": [
     "awdaemons",
     "awnode",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/aitherzero.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run one numbered script and read what it says it did.",
   "category": "brick",
-  "description": "Kind: corpus\n\nProblem\nOps knowledge lives in people's shell history, so the same recovery gets improvised differently every time it is needed.\n\nInstall\ngit clone https://github.com/Aitherium/AitherZero",
+  "description": "Kind: corpus\n\nProblem\nOps knowledge lives in people's shell history, so the same recovery gets improvised differently every time it is needed.\n\nInstall\ngit clone https://github.com/Aitherium/AitherZero\n\nQuick start\n  git clone https://github.com/Aitherium/AitherZero.git\n  cd AitherZero\n\nDocs\nhttps://aitherium.github.io/AitherZero/",
   "see_also": [
     "awrecover"
   ],

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awask.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Ask a human a question from a script, and keep working on their answer.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nA decision buried in terminal prose is a stream event — it scrolls past, and the agent either stalls waiting for someone who is not reading, or guesses and does days of the wrong work. Every agent framework can print a question; almost none can carry the ANSWER back into the run that asked it, so the human is a bottleneck exactly when they are least able to be one.\n\nInstall\npip install awask",
+  "description": "Kind: tool\n\nProblem\nA decision buried in terminal prose is a stream event — it scrolls past, and the agent either stalls waiting for someone who is not reading, or guesses and does days of the wrong work. Every agent framework can print a question; almost none can carry the ANSWER back into the run that asked it, so the human is a bottleneck exactly when they are least able to be one.\n\nInstall\npip install awask\n\nCommands\n  awask\n\nQuick start\n  pip install awask\n\nDocs\nhttps://aitherium.github.io/awask/",
   "see_also": [
     "awdk",
     "awrelay",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awavatar.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Validate one character_spec.json and one character_pack/ against their schemas and refuse the pack if any file's hash, licence or rig audit is missing.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nA generated 3D character is five artifacts from five tools (mesh, rig, clips, VRM, style renders) with no shared contract, so every host re-derives what it may load, and the bakes end up.gitignored with no canonical home -- measured 2026-09-05 on the CoC engine, where every Anny body and every clip pack is absent from disk while the code that drives them is committed.\n\nInstall\npip install git+https://github.com/Aitherium/awavatar",
+  "description": "Kind: tool\n\nProblem\nA generated 3D character is five artifacts from five tools (mesh, rig, clips, VRM, style renders) with no shared contract, so every host re-derives what it may load, and the bakes end up.gitignored with no canonical home -- measured 2026-09-05 on the CoC engine, where every Anny body and every clip pack is absent from disk while the code that drives them is committed.\n\nInstall\npip install git+https://github.com/Aitherium/awavatar\n\nCommands\n  awavatar\n\nQuick start\n  pip install awavatar\n  awavatar validate-spec character_spec.json # schema_version-routed validation\n  awavatar validate-pack./character_pack/ # hashes, licences, rig audit, VRM bones\n  awavatar submit character_spec.json --server http://127.0.0.1:8200 # any media-forge-shaped server\n\nDocs\nhttps://aitherium.github.io/awavatar/",
   "see_also": [
     "awrtifact",
     "awdk",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awbac.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Gate one endpoint and read the explanation it gives for a denial.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nMost authz answers \"no\" without saying why, so every denial becomes a debugging session — and the ones that fail OPEN never announce themselves at all.\n\nInstall\npip install awbac",
+  "description": "Kind: tool\n\nProblem\nMost authz answers \"no\" without saying why, so every denial becomes a debugging session — and the ones that fail OPEN never announce themselves at all.\n\nInstall\npip install awbac\n\nCommands\n  awbac\n\nQuick start\n  pip install awbac\n\nDocs\nhttps://aitherium.github.io/awbac/",
   "see_also": [
     "awdit"
   ],

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awbeads.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Drop a canvas into one page, arrange two things on it, reload, and find them where you left them.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nEvery product eventually grows a screen where things are placed rather than listed — a board, a map, a graph of what connects to what. That screen is almost always re-implemented per product, and the arrangement lives in component state, so it dies on reload and cannot be exported, reviewed, or moved to another surface. Measured on this tree 2026-08-24, the same hand-vendored tarball appears in three separate product frontends because there was no registered brick to depend on.\n\nInstall\ngit clone https://github.com/Aitherium/awbeads",
+  "description": "Kind: tool\n\nProblem\nEvery product eventually grows a screen where things are placed rather than listed — a board, a map, a graph of what connects to what. That screen is almost always re-implemented per product, and the arrangement lives in component state, so it dies on reload and cannot be exported, reviewed, or moved to another surface. Measured on this tree 2026-08-24, the same hand-vendored tarball appears in three separate product frontends because there was no registered brick to depend on.\n\nInstall\ngit clone https://github.com/Aitherium/awbeads\n\nQuick start\n  ### React",
   "see_also": [
     "awkit",
     "awsh",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awbonsai.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Load one page and get an answer from a model that never left the tab.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nEvery in-browser LLM demo either phones home for the real answer or downloads a few hundred MB unasked. Getting BOTH right -- genuinely local inference, and a consent gate that runs BEFORE the fetch instead of after -- is the part nobody ships, so most \"runs in your browser\" claims are marketing for a server call.\n\nInstall\ngit clone https://github.com/Aitherium/awbonsai",
+  "description": "Kind: runtime\n\nProblem\nEvery in-browser LLM demo either phones home for the real answer or downloads a few hundred MB unasked. Getting BOTH right -- genuinely local inference, and a consent gate that runs BEFORE the fetch instead of after -- is the part nobody ships, so most \"runs in your browser\" claims are marketing for a server call.\n\nInstall\ngit clone https://github.com/Aitherium/awbonsai\n\nQuick start\n  npm install @aitherium/awbonsai",
   "see_also": [
     "awkit",
     "awsprite",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awbrain.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Point it at a folder of notes or sessions; ask a question your context never held.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nEvery AI memory system sells you a black box: sessions vanish into a vendor cloud, and \"it remembers\" means \"the vendor's model was prompted with a blob\". Memory should be files you can read, claims you can check against the session or file that produced them, and retrieval that never dumps your whole history into a prompt.\n\nInstall\npip install awbrain",
+  "description": "Kind: runtime\n\nProblem\nEvery AI memory system sells you a black box: sessions vanish into a vendor cloud, and \"it remembers\" means \"the vendor's model was prompted with a blob\". Memory should be files you can read, claims you can check against the session or file that produced them, and retrieval that never dumps your whole history into a prompt.\n\nInstall\npip install awbrain\n\nCommands\n  awbrain\n\nQuick start\n  pip install awbrain",
   "see_also": [
     "awknowledge",
     "awm",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awbrowse.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Drive one page and get back what is on it in a form worth reasoning about.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nHanding an agent a screenshot makes it read a picture of text; handing it raw DOM makes it read a megabyte of markup. Neither of those is the page.\n\nInstall\npip install awbrowse",
+  "description": "Kind: tool\n\nProblem\nHanding an agent a screenshot makes it read a picture of text; handing it raw DOM makes it read a megabyte of markup. Neither of those is the page.\n\nInstall\npip install awbrowse\n\nCommands\n  awbrowse\n\nQuick start\n  pip install awbrowse\n\nDocs\nhttps://aitherium.github.io/awbrowse/",
   "see_also": [
     "awdk",
     "awfind",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awclassify.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run it on one file and read what it is, who may see it and what it is about.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nA corpus nobody has classified cannot be published safely or retrieved well: the one internal page in a public mirror is found by a stranger, and the question that needed a design note gets a changelog. Classification must be a standalone step any pipeline can call, not a judgement buried in a model prompt.\n\nInstall\npip install git+https://github.com/Aitherium/awclassify.git",
+  "description": "Kind: tool\n\nProblem\nA corpus nobody has classified cannot be published safely or retrieved well: the one internal page in a public mirror is found by a stranger, and the question that needed a design note gets a changelog. Classification must be a standalone step any pipeline can call, not a judgement buried in a model prompt.\n\nInstall\npip install git+https://github.com/Aitherium/awclassify.git\n\nCommands\n  awclassify\n\nQuick start\n  pip install awclassify\n  \n  awclassify classify report.md\n  # doc_type report\n  # visibility internal\n  # audience other\n  # topics -\n  # engine rules classified=False\n  #\n  # NOT VERIFIED: rules-only classification. Pass --server for the full\n  # engine. Per the fail-closed contract, do not publish on this alone.",
   "see_also": [
     "awknowledge",
     "awkno",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdaemons.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run it on a box with no Python and curl its /health.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nShipping the agent loop and the shell harness means shipping a Python environment, and freezing the whole CLI to get them drags in the entire ML stack: 694 MiB and 164+ PyInstaller hooks to obtain two subcommands.\n\nInstall\nsee the repo — built by awdk/packaging/build_executable.py --narrow",
+  "description": "Kind: runtime\n\nProblem\nShipping the agent loop and the shell harness means shipping a Python environment, and freezing the whole CLI to get them drags in the entire ML stack: 694 MiB and 164+ PyInstaller hooks to obtain two subcommands.\n\nInstall\nsee the repo — built by awdk/packaging/build_executable.py --narrow\n\nCommands\n  adk\n  adk-bug\n  adk-py\n  adk-serve\n  adk-shell\n  adk-workspace\n  aither-adk\n  awdk\n\nQuick start\n  pip install awdk\n  adk quickstart # auto-detect hardware, set up inference\n  adk init my-agent && cd my-agent && python agent.py",
   "see_also": [
     "awdk",
     "awnode",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdecide.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Ask one typed question of one state and read back a decision, a probability, and decided=False when nothing earned it.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nSoftware makes the same bounded decision millions of times and asks a text model each time, then parses prose. Hosted \"decision models\" fix the shape but send the program state off-box, emit a probability that is never resolved against what happened, and cannot say what happens next if you act on it. A decision is a function; the loop it sits in is the product.\n\nInstall\npip install awdecide",
+  "description": "Kind: tool\n\nProblem\nSoftware makes the same bounded decision millions of times and asks a text model each time, then parses prose. Hosted \"decision models\" fix the shape but send the program state off-box, emit a probability that is never resolved against what happened, and cannot say what happens next if you act on it. A decision is a function; the loop it sits in is the product.\n\nInstall\npip install awdecide\n\nCommands\n  awdecide\n\nQuick start\n  ## The loop: a decision you resolved is never paid for twice\n  \n  `Ladder` answers a question. `Loop` remembers how the answer turned out. Ask, act,\n  resolve -- the next identical decision is answered from that evidence with no model\n  call, and an answer that was resolved wrong is never given again.\n  \n  Add it to the agent harness you already use:",
   "see_also": [
     "awclassify",
     "awpredict",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdeck.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Turn a JSON outline into a narrated MP4, and read back which voice actually spoke it.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nA rendered video looks identical whether a neural voice plane narrated it or a 2010-era desktop speech synthesiser did, so the artifact cannot be audited by looking at it. Measured 2026-09-19: one long-job transport failure was read as \"the fleet is down\", the render silently fell back to Windows SAPI, and the only thing that caught it was the owner listening to six minutes of it. Separately, the voice service accepts a `voice` parameter and serves en-GB-SoniaNeural whatever you ask for, so even the non-degraded path was not the voice chosen.\n\nInstall\nbuilds in-tree (pip install -e .); not on PyPI yet",
+  "description": "Kind: tool\n\nProblem\nA rendered video looks identical whether a neural voice plane narrated it or a 2010-era desktop speech synthesiser did, so the artifact cannot be audited by looking at it. Measured 2026-09-19: one long-job transport failure was read as \"the fleet is down\", the render silently fell back to Windows SAPI, and the only thing that caught it was the owner listening to six minutes of it. Separately, the voice service accepts a `voice` parameter and serves en-GB-SoniaNeural whatever you ask for, so even the non-degraded path was not the voice chosen.\n\nInstall\nbuilds in-tree (pip install -e .); not on PyPI yet\n\nCommands\n  awdeck\n\nQuick start\n  export AWVOICE_TTS_URL=http://127.0.0.1:8084/voice/synthesize\n  awdeck doctor # is the plane reachable?\n  awdeck render slides.json --out talk.mp4 --voice onyx",
   "see_also": [
     "awvoice",
     "awsh",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdelphi.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run a multi-round anonymous expert panel on a question and get a converged answer with a trace.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nA single expert opinion is one opinion; a panel that reads each other's names converges on the loudest voice, not the best argument. Delphi panels need anonymous rounds, aggregate feedback, and an honest stop rule.\n\nInstall\npip install awdelphi",
+  "description": "Kind: tool\n\nProblem\nA single expert opinion is one opinion; a panel that reads each other's names converges on the loudest voice, not the best argument. Delphi panels need anonymous rounds, aggregate feedback, and an honest stop rule.\n\nInstall\npip install awdelphi\n\nCommands\n  awdelphi\n\nQuick start\n  pip install awdelphi # the CLI + engine\n  pip install \"awdelphi[mcp]\" # + the MCP server for coding agents\n  \n  awdelphi run \"Should the fleet pin the model pool to the DGX Spark?\" \\\n   --experts demiurge,athena,hydra --context \"...\" --arena\n  awdelphi status <run_id>\n  awdelphi show <run_id> --json\n\nDocs\nhttps://aitherium.github.io/awdelphi/",
   "see_also": [
     "awrelay",
     "awdk"

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdesk.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run it, and the next decision card an agent raises pops on your desktop instead of scrolling past in a log.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nEvery surface an agent has on a laptop lives in a browser tab that can be closed, minimized or forgotten. The desk is the one that stays: an always-on presence that can interrupt you with a decision card, embody an agent as an avatar, and hold the Living Desktop over your real desktop.\n\nInstall\nsee the repo -- Electron app (npm install && npx electron .)",
+  "description": "Kind: runtime\n\nProblem\nEvery surface an agent has on a laptop lives in a browser tab that can be closed, minimized or forgotten. The desk is the one that stays: an always-on presence that can interrupt you with a decision card, embody an agent as an avatar, and hold the Living Desktop over your real desktop.\n\nInstall\nsee the repo -- Electron app (npm install && npx electron .)\n\nQuick start\n  npm install\n  npm run demo\n\nDocs\nhttps://aitherium.github.io/awdesk/",
   "see_also": [
     "awdk",
     "awsh",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdit.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Write one sensitive action to it and then try to remove the record.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAn audit log you can silently delete from is decoration. Most are. The property that matters is not \"it records\" but \"a missing record is visible\".\n\nInstall\npip install awdit",
+  "description": "Kind: tool\n\nProblem\nAn audit log you can silently delete from is decoration. Most are. The property that matters is not \"it records\" but \"a missing record is visible\".\n\nInstall\npip install awdit\n\nCommands\n  awdit\n\nQuick start\n  pip install awdit\n\nDocs\nhttps://aitherium.github.io/awdit/",
   "see_also": [
     "awbac",
     "awseal"

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awdk.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Point it at a backend you already pay for and run one agent loop.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nRunning one agent is easy and running fifty is a different job: budgets, retries, which model, whose machine. Most frameworks make you adopt their whole world to find out.\n\nInstall\npip install awdk",
+  "description": "Kind: runtime\n\nProblem\nRunning one agent is easy and running fifty is a different job: budgets, retries, which model, whose machine. Most frameworks make you adopt their whole world to find out.\n\nInstall\npip install awdk\n\nCommands\n  adk\n  adk-bug\n  adk-py\n  adk-serve\n  adk-shell\n  adk-workspace\n  aither-adk\n  awdk\n\nQuick start\n  pip install awdk\n  adk quickstart # auto-detect hardware, set up inference\n  adk init my-agent && cd my-agent && python agent.py\n\nDocs\nhttps://aitherium.github.io/awdk/",
   "see_also": [
     "aitheros",
     "awskills",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awembed.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Point it at one repo and get a 0.6B embedder that ranks your directories better than the 7B one it learned from, with the eval that proves it.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nEvery agent stack searches your code with an embedding model trained on someone else's. It is right about two thirds of the time on a corpus it never saw, and nothing in the stack measures that. Distilling a small student on your own corpus -- the big model's margins plus your labels -- beats the big model, and the eval that proves it is the part people skip.\n\nInstall\npip install awembed",
+  "description": "Kind: tool\n\nProblem\nEvery agent stack searches your code with an embedding model trained on someone else's. It is right about two thirds of the time on a corpus it never saw, and nothing in the stack measures that. Distilling a small student on your own corpus -- the big model's margins plus your labels -- beats the big model, and the eval that proves it is the part people skip.\n\nInstall\npip install awembed\n\nCommands\n  awembed\n\nQuick start\n  pip install awembed # the student side: torch + transformers\n  pip install \"awembed[teacher]\" # also the teacher server (fastapi, einops,...)\n\nDocs\nhttps://aitherium.github.io/awembed/",
   "see_also": [
     "awdk",
     "awgraph",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awevolve.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Point it at a file and a command that scores that file, and watch an agent improve it -- keeping every version and the score it earned.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAutomated improvement loops fail silently and look identical while doing it. A run that explored honestly and found nothing produces the same logs, the same records and the same stop reason as a run that changed nothing at all -- there is no exception to catch and no failing request, so the loop keeps running and a human periodically concludes the search space is just hard. And the loops that DO work are usually one-shot generators: the model is asked for a candidate, handed no history, and never allowed to test its own idea before committing it.\n\nInstall\npip install awevolve",
+  "description": "Kind: tool\n\nProblem\nAutomated improvement loops fail silently and look identical while doing it. A run that explored honestly and found nothing produces the same logs, the same records and the same stop reason as a run that changed nothing at all -- there is no exception to catch and no failing request, so the loop keeps running and a human periodically concludes the search space is just hard. And the loops that DO work are usually one-shot generators: the model is asked for a candidate, handed no history, and never allowed to test its own idea before committing it.\n\nInstall\npip install awevolve\n\nCommands\n  awevolve\n\nQuick start\n  pip install awevolve",
   "see_also": [
     "awdk",
     "awrun",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awfind.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Ask one question and get ranked answers back instead of a page of results.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAn agent with no search guesses from training data; an agent handed a raw web API gets ten blue links and burns its context reading them.\n\nInstall\npip install awfind",
+  "description": "Kind: tool\n\nProblem\nAn agent with no search guesses from training data; an agent handed a raw web API gets ten blue links and burns its context reading them.\n\nInstall\npip install awfind\n\nCommands\n  awfind\n\nQuick start\n  pip install awfind\n\nDocs\nhttps://aitherium.github.io/awfind/",
   "see_also": [
     "awdk",
     "awbrowse",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awflow.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Chain parallel and sequential agent calls with deterministic ordering, a persistent journal, and hard budget enforcement. Replay from the journal at any breakpoint.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nWorkflows need deterministic orchestration with journaled execution so every call, every branch decision, and every result can be captured and replayed from any point. Agents running a workflow need to see the same progression whether they are in the middle of a live run or resuming from an earlier checkpoint.\n\nInstall\npip install aitherium-awflow",
+  "description": "Kind: runtime\n\nProblem\nWorkflows need deterministic orchestration with journaled execution so every call, every branch decision, and every result can be captured and replayed from any point. Agents running a workflow need to see the same progression whether they are in the middle of a live run or resuming from an earlier checkpoint.\n\nInstall\npip install aitherium-awflow\n\nCommands\n  awflow\n\nQuick start\n  python -m AitherOS.lib.orchestration.awflow --self-test\n\nDocs\nhttps://aitherium.github.io/awflow/",
   "see_also": [
     "awdk",
     "awrun",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awfocus.json

@@ -1,7 +1,7 @@
 {
   "adopt": "List your live sessions, search their transcripts, and focus or message the one you want.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nEvery session is a tab; nothing answers \"which session is doing what, where did I say X, how do I tell that session to do Y\" without hunting.\n\nInstall\npip install awfocus",
+  "description": "Kind: tool\n\nProblem\nEvery session is a tab; nothing answers \"which session is doing what, where did I say X, how do I tell that session to do Y\" without hunting.\n\nInstall\npip install awfocus\n\nCommands\n  awfocus\n\nQuick start\n  awfocus # list what is running right now\n  awfocus what did we decide about the tunnel\n   # search every transcript, ranked\n  awfocus open 8d191d35 # open that session in a terminal tab\n  awfocus ask 8d191d35 \"ship it\"\n   # deliver a message into the session\n  awfocus remote # sessions seen on the relay (other machines)\n  awfocus --self-test # prove the contract, offline\n\nDocs\nhttps://aitherium.github.io/awfocus/",
   "see_also": [
     "awrelay",
     "awgit",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awgit.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Take a lease on a file before you edit it in a shared checkout.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nSeveral agents editing one worktree silently sweep each other's work; a diff tells you WHAT changed but not who meant it or whether they were mid-edit.\n\nInstall\npip install awgit",
+  "description": "Kind: tool\n\nProblem\nSeveral agents editing one worktree silently sweep each other's work; a diff tells you WHAT changed but not who meant it or whether they were mid-edit.\n\nInstall\npip install awgit\n\nCommands\n  awgit\n\nQuick start\n  pip install awgit\n  awgit init # verify the actor, install the capture hooks\n\nDocs\nhttps://aitherium.github.io/awgit/",
   "see_also": [
     "awgraph",
     "awrelay"

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awgraph.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Index one repo and ask it who calls one function.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\n\"Who calls this?\" answered by grep is a guess. Agents burn enormous context re-reading files to rebuild a graph the parser already knows.\n\nInstall\npip install awgraph",
+  "description": "Kind: tool\n\nProblem\n\"Who calls this?\" answered by grep is a guess. Agents burn enormous context re-reading files to rebuild a graph the parser already knows.\n\nInstall\npip install awgraph\n\nCommands\n  awgraph\n\nQuick start\n  pip install awgraph\n\nDocs\nhttps://aitherium.github.io/awgraph/",
   "see_also": [
     "awm",
     "awdk",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awgym.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Play one ARC game end-to-end with the world model watching every transition, then ask it to predict the next grid and watch the surprise score fall.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nA world model is only as good as the play it watches. Solver runs stream past, checkpoints get trained on whatever happened to be recorded, and nobody can answer \"did the model actually get better at predicting the next grid?\" against transitions it has never seen.\n\nInstall\npip install awgym",
+  "description": "Kind: runtime\n\nProblem\nA world model is only as good as the play it watches. Solver runs stream past, checkpoints get trained on whatever happened to be recorded, and nobody can answer \"did the model actually get better at predicting the next grid?\" against transitions it has never seen.\n\nInstall\npip install awgym\n\nCommands\n  awgym\n\nQuick start\n  awgym --help # the CLI\n  awgym serve # the gym server (FastAPI)\n\nDocs\nhttps://aitherium.github.io/awgym/",
   "see_also": [
     "awdk",
     "awm",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awiam.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Deactivate one session and watch it stop working immediately.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nDeactivation that takes effect \"eventually\" is not deactivation, and a store that cannot be read reports zero users — which every caller reads as \"nobody is authorised\" or, worse, as an empty directory to helpfully repopulate.\n\nInstall\npip install awiam",
+  "description": "Kind: tool\n\nProblem\nDeactivation that takes effect \"eventually\" is not deactivation, and a store that cannot be read reports zero users — which every caller reads as \"nobody is authorised\" or, worse, as an empty directory to helpfully repopulate.\n\nInstall\npip install awiam\n\nCommands\n  awiam\n\nQuick start\n  pip install awiam\n\nDocs\nhttps://aitherium.github.io/awiam/",
   "see_also": [
     "awbac",
     "awdit"

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awiris.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Hand it three reference images and get one style card back.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nCharacter-consistent generation loses the character after a few iterations when the render is locked to prompts alone. Style cards + critique let an artist pipeline run unattended and hold identity across a full production.\n\nInstall\nbuilds in-tree (AitherOS/agents/Iris) -- not on PyPI yet",
+  "description": "Kind: tool\n\nProblem\nCharacter-consistent generation loses the character after a few iterations when the render is locked to prompts alone. Style cards + critique let an artist pipeline run unattended and hold identity across a full production.\n\nInstall\nnot on PyPI yet (pending publish)",
   "see_also": [
     "mediaforge",
     "awdk",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awkno.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Ask it what a brick does and get the answer with your network cable out.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nThe family is only useful if you can find it. Its registry lives in one yaml in one monorepo and the laws live in a public skills pack, so a stranger with a terminal and no browser can reach neither — which makes \"what exists and what should this talk to\" a question asked of a person instead of a tool.\n\nInstall\npip install awkno",
+  "description": "Kind: tool\n\nProblem\nThe family is only useful if you can find it. Its registry lives in one yaml in one monorepo and the laws live in a public skills pack, so a stranger with a terminal and no browser can reach neither — which makes \"what exists and what should this talk to\" a question asked of a person instead of a tool.\n\nInstall\npip install awkno\n\nCommands\n  awkno\n\nQuick start\n  pip install awkno\n\nDocs\nhttps://aitherium.github.io/awkno/",
   "see_also": [
     "awskills",
     "awfind",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awknowledge.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Read one law and apply it to the next thing you ship.",
   "category": "brick",
-  "description": "Kind: corpus\n\nProblem\nEveryone learns the same lessons about agent-written code the same expensive way, and writes none of them down where the next person looks.\n\nInstall\nread it — https://aitherium.github.io/awknowledge/",
+  "description": "Kind: corpus\n\nProblem\nEveryone learns the same lessons about agent-written code the same expensive way, and writes none of them down where the next person looks.\n\nInstall\nread it — https://aitherium.github.io/awknowledge/\n\nQuick start\n  something breaks\n   → you fix it\n   → you ask: could a check have caught this?\n   → if yes, THE CHECK IS THE WORK. Write it, watch it fail, wire it somewhere\n   unattended. Do not write a ticket.\n\nDocs\nhttps://aitherium.github.io/awknowledge/",
   "see_also": [
     "awskills",
     "awkno",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awm.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Give one agent a memory scoped to one project and watch it stop re-asking.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAn agent that forgets everything between sessions re-derives the same facts forever; one that remembers everything globally leaks context across projects.\n\nInstall\npip install awm",
+  "description": "Kind: tool\n\nProblem\nAn agent that forgets everything between sessions re-derives the same facts forever; one that remembers everything globally leaks context across projects.\n\nInstall\npip install awm\n\nCommands\n  awm\n\nQuick start\n  pip install awm\n  \n  awm remember --scope acme:alice:orchestrator --key recipe --value \"rank 16, lr 2e-5\"\n  awm recall --scope acme:alice:orchestrator\n\nDocs\nhttps://aitherium.github.io/awm/",
   "see_also": [
     "awpredict",
     "awdk",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awmail.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Send one email from an agent using a mailbox you already own, in about a minute.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAn agent that cannot send email cannot finish most real errands: it drafts the invitation, the receipt, the reply, and then hands a human a block of text to paste somewhere. The usual fix is a transactional provider, which means a domain, DNS records, a paid account and a warm-up period before the first message — an afternoon of setup to send one email from a mailbox you already own. Receiving is worse: almost nothing gives an agent an inbox, so agents are write-only and cannot close a loop that a person answers by replying.\n\nInstall\npip install awmail",
+  "description": "Kind: tool\n\nProblem\nAn agent that cannot send email cannot finish most real errands: it drafts the invitation, the receipt, the reply, and then hands a human a block of text to paste somewhere. The usual fix is a transactional provider, which means a domain, DNS records, a paid account and a warm-up period before the first message — an afternoon of setup to send one email from a mailbox you already own. Receiving is worse: almost nothing gives an agent an inbox, so agents are write-only and cannot close a loop that a person answers by replying.\n\nInstall\npip install awmail\n\nCommands\n  awmail\n\nQuick start\n  pip install awmail\n\nDocs\nhttps://aitherium.github.io/awmail/",
   "see_also": [
     "awnboard",
     "awnest",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awmine.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Point it at one transcript directory and read back what those sessions learned, with the line each lesson came from.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nEvery agent session leaves a transcript, and almost every transcript is thrown away. The correction a human made at turn 40, the retry that finally worked, the six-command sequence three sessions each re-derived -- all of it sits in JSONL nobody reads, while the next session starts from zero.\n\nInstall\npip install git+https://github.com/Aitherium/awmine.git",
+  "description": "Kind: tool\n\nProblem\nEvery agent session leaves a transcript, and almost every transcript is thrown away. The correction a human made at turn 40, the retry that finally worked, the six-command sequence three sessions each re-derived -- all of it sits in JSONL nobody reads, while the next session starts from zero.\n\nInstall\npip install git+https://github.com/Aitherium/awmine.git\n\nCommands\n  awmine\n\nQuick start\n  pip install awmine",
   "see_also": [
     "awtoll",
     "awm",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awnboard.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Put a gate in front of one URL and let exactly one person through it with a code you sent them.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nLetting one specific person reach one specific thing is still, in 2026, either a whole identity deployment or a link anyone who sees it can use. So everybody ships the link: an unguessable URL in an email, no expiry, no audience, no record of who walked through it -- and no way to take it back without breaking it for everyone.\n\nInstall\npip install awnboard",
+  "description": "Kind: tool\n\nProblem\nLetting one specific person reach one specific thing is still, in 2026, either a whole identity deployment or a link anyone who sees it can use. So everybody ships the link: an unguessable URL in an email, no expiry, no audience, no record of who walked through it -- and no way to take it back without breaking it for everyone.\n\nInstall\npip install awnboard\n\nCommands\n  awnboard\n\nQuick start\n  pip install awnboard\n\nDocs\nhttps://aitherium.github.io/awnboard/",
   "see_also": [
     "awnest",
     "awiam",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awnest.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Gate one action behind a human check and watch an automated caller fail it.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAny surface an agent can use, a bot can flood. CAPTCHA is hostile to the humans it is meant to serve and is beaten by the machines it is meant to stop, so the check has to be something other than a puzzle -- and every check that does exist fails OPEN, because \"we could not tell\" and \"it is fine\" reach the caller as the same empty value.\n\nInstall\npip install awnest",
+  "description": "Kind: tool\n\nProblem\nAny surface an agent can use, a bot can flood. CAPTCHA is hostile to the humans it is meant to serve and is beaten by the machines it is meant to stop, so the check has to be something other than a puzzle -- and every check that does exist fails OPEN, because \"we could not tell\" and \"it is fine\" reach the caller as the same empty value.\n\nInstall\npip install awnest\n\nCommands\n  awnest\n\nQuick start\n  pip install awnest\n\nDocs\nhttps://aitherium.github.io/awnest/",
   "see_also": [
     "awiam",
     "awbac",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awnet.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Host a mesh on one machine and join it from another.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nAgents are islands. Every deployment reinvents how a peer is found, addressed and trusted, so two agents on two machines cost more to introduce than either cost to build — and the answers (port forwards, a VPN per pair, public IPs, a broker somebody has to run) all become permanent maintenance.\n\nInstall\npip install awnet",
+  "description": "Kind: runtime\n\nProblem\nAgents are islands. Every deployment reinvents how a peer is found, addressed and trusted, so two agents on two machines cost more to introduce than either cost to build — and the answers (port forwards, a VPN per pair, public IPs, a broker somebody has to run) all become permanent maintenance.\n\nInstall\npip install awnet\n\nCommands\n  awnet\n\nQuick start\n  pip install awnet\n\nDocs\nhttps://aitherium.github.io/awnet/",
   "see_also": [
     "awnode",
     "awdk",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awnix.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Boot one throwaway box and try to make a change you cannot reproduce.",
   "category": "brick",
-  "description": "Kind: base\n\nProblem\nAn agent with root on a mutable host eventually produces a machine nobody can reproduce.\n\nInstall\nsee the repo — image builder",
+  "description": "Kind: base\n\nProblem\nAn agent with root on a mutable host eventually produces a machine nobody can reproduce.\n\nInstall\npodman build -t awnix:latest -f Containerfile .\n\nQuick start\n  podman build -t awnix:latest -f Containerfile.\n\nDocs\nhttps://aitherium.github.io/awnix/",
   "see_also": [
     "awdk",
     "awrecover",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awnode.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Run it once and point one app at it instead of a vendor URL.",
   "category": "brick",
-  "description": "Kind: runtime\n\nProblem\nEvery app hardcodes a different provider SDK, so switching backends means editing every app.\n\nInstall\npip install awnode",
+  "description": "Kind: runtime\n\nProblem\nEvery app hardcodes a different provider SDK, so switching backends means editing every app.\n\nInstall\npip install awnode\n\nCommands\n  awnode\n  awnode-mcp\n\nQuick start\n  pip install awnode\n  # container image:\n  docker pull ghcr.io/aitherium/awnode:latest\n  \n  # or full stack:\n  curl -fsSL https://launch.aitherium.com | bash\n\nDocs\nhttps://aitherium.github.io/awnode/",
   "see_also": [
     "awdk",
     "aitherkvcache",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awpack.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Install one pack and run it. Each carries its own manifest, licence and version, so taking one costs you nothing else.",
   "category": "brick",
-  "description": "Kind: corpus\n\nProblem\nA pack bundled into the SDK inherits the SDK's licence and the SDK's release cadence. That is backwards in both directions: a proprietary pack blocks the SDK's public publish (measured — the adk sync gate aborts on exactly this and names it), and a good pack cannot ship a fix without an SDK release. Packs and the runtime that loads them are different products with different audiences.\n\nInstall\ngit clone https://github.com/Aitherium/awpack",
+  "description": "Kind: corpus\n\nProblem\nA pack bundled into the SDK inherits the SDK's licence and the SDK's release cadence. That is backwards in both directions: a proprietary pack blocks the SDK's public publish (measured — the adk sync gate aborts on exactly this and names it), and a good pack cannot ship a fix without an SDK release. Packs and the runtime that loads them are different products with different audiences.\n\nInstall\ngit clone https://github.com/Aitherium/awpack\n\nCommands\n  awpack\n\nQuick start\n  packs/<id>/\n   pack.yaml # identity, version, what it needs, what it gives\n   README.md # what it does, for a stranger, in one screen\n\nDocs\nhttps://aitherium.github.io/awpack/",
   "see_also": [
     "awdk",
     "awskills",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awpredict.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Wrap an environment you already have and ask it what happens next.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nAn agent that cannot anticipate its environment can only react. Every framework that offers this makes you adopt its whole training stack to find out whether a learned model beats the lookup table you already have.\n\nInstall\npip install git+https://github.com/Aitherium/awpredict.git",
+  "description": "Kind: tool\n\nProblem\nAn agent that cannot anticipate its environment can only react. Every framework that offers this makes you adopt its whole training stack to find out whether a learned model beats the lookup table you already have.\n\nInstall\npip install git+https://github.com/Aitherium/awpredict.git\n\nCommands\n  awpredict\n\nQuick start\n  pip install -e \".[torch]\" # torch + numpy are optional; engines degrade loudly without them\n\nDocs\nhttps://aitherium.github.io/awpredict/",
   "see_also": [
     "awm"
   ],

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awprism.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Hand it a failure and get back ranked candidate causes, each with the one observation that would rule it in or out.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nDebugging with an agent collapses onto the first plausible story, because nothing forces a second. The cost is not the wrong guess, it is the hours spent proving it — measured repeatedly here, where five hypotheses were spent on a service that was genuinely correct, and where a symptom named the wrong component so consistently that \"the symptom names the INNOCENT service\" had to be written down as a standing rule.\n\nInstall\npip install awprism",
+  "description": "Kind: tool\n\nProblem\nDebugging with an agent collapses onto the first plausible story, because nothing forces a second. The cost is not the wrong guess, it is the hours spent proving it — measured repeatedly here, where five hypotheses were spent on a service that was genuinely correct, and where a symptom named the wrong component so consistently that \"the symptom names the INNOCENT service\" had to be written down as a standing rule.\n\nInstall\npip install awprism\n\nCommands\n  awprism\n\nQuick start\n  pip install awprism\n\nDocs\nhttps://aitherium.github.io/awprism/",
   "see_also": [
     "awreason",
     "awrepl",

{awkno-0.2.4 → awkno-0.2.5}/awkno/pages/awprove.json

@@ -1,7 +1,7 @@
 {
   "adopt": "Write one journey as a real user takes it, name the truths that must hold on the page, and get back a PASS/FAIL plus a gate that pins each truth.",
   "category": "brick",
-  "description": "Kind: tool\n\nProblem\nEvery failure that enrages a user answers 200: a lock screen shown to someone already signed in, an empty knowledge base, a chat panel that says \"backend unavailable\". A route probe, a healthcheck and a test suite all pass while the product is unusable, because none of them looks at what actually rendered. And the one-off script that finally catches it is thrown away, so the same class regresses a week later with nothing watching.\n\nInstall\nbuilds in-tree -- not on PyPI yet; `pip install awprove` 404s today",
+  "description": "Kind: tool\n\nProblem\nEvery failure that enrages a user answers 200: a lock screen shown to someone already signed in, an empty knowledge base, a chat panel that says \"backend unavailable\". A route probe, a healthcheck and a test suite all pass while the product is unusable, because none of them looks at what actually rendered. And the one-off script that finally catches it is thrown away, so the same class regresses a week later with nothing watching.\n\nInstall\nbuilds in-tree -- not on PyPI yet; `pip install awprove` 404s today\n\nCommands\n  awprove\n\nQuick start\n  # offline: the proof is well-formed AND every assertion provably can fail\n  awprove check proofs/example-anon.yaml\n  \n  # live: drive the journey and judge the render (exit 0 pass / 1 fail / 2 could-not-judge)\n  awprove run proofs/example-anon.yaml --browser-url https://127.0.0.1:8132\n  \n  # pin it: emit a self-testing gate that fails if the truth stops being true\n  awprove pin proofs/example-anon.yaml --out.\n  python your_checker.py --self-test",
   "see_also": [
     "awbrowse",
     "awvision",