awkno 0.2.7__tar.gz → 0.2.8__tar.gz

{awkno-0.2.7 → awkno-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awkno
-Version: 0.2.7
+Version: 0.2.8
 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.7 → awkno-0.2.8}/awkno/__init__.py

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

{awkno-0.2.7 → awkno-0.2.8}/awkno/generate.py

@@ -118,11 +118,22 @@ class AwknoGenerator:
 
         # Generate a page per pack ON THE SHELF. Held packs are absent by
         # design — see _make_pack_page.
+        # A pack that shares an id with a registry brick or stack (awnode and awdesk
+        # each ship a shelf pack of the same name) must NOT overwrite that page: the
+        # registry owns the id, and the overwrite made EC012 report the brick as
+        # absent from the corpus after every regen.
+        registry_ids = set(pages)
         if self.shelf_dir.exists():
             for manifest in sorted(self.shelf_dir.glob("*/pack.yaml")):
                 page = self._make_pack_page(manifest)
-                if page is not None:
-                    pages[page["topic"].lower()] = page
+                if page is None:
+                    continue
+                key = page["topic"].lower()
+                if key in registry_ids:
+                    print(f"[SKIP] pack {key!r}: the id is a registry brick or "
+                          f"stack; the registry page wins")
+                    continue
+                pages[key] = page
 
         # Generate law pages
         if self.laws_dir.exists():

awkno-0.2.8/awkno/pages/aitherbrowser.json

@@ -0,0 +1,12 @@
+{
+  "adopt": "# Only inside a checkout of this repository, or where the addon manifest has\n# been installed to ~/.aither/components. From PyPI alone this raises\n# \"Unknown addon: aitherbrowser\".\npip install awdk\n\n# Start the browser here (port 8132) and\n# register what it finds:\nadk addon enable aitherbrowser\n\n# Confirm it is serving. The image answers TLS when configured and plain\n# HTTP on a bare node, so probe the one you actually started.\ncurl -fsS http://127.0.0.1:8132/health\n\n# Status, and the container's own log when something is wrong:\nadk addon status aitherbrowser\nadk addon logs aitherbrowser",
+  "category": "pack",
+  "description": "Kind: pack\n\nWhat it does\nRun AitherBrowser on your own machine: an untethered Chromium an agent drives with the pilot_* tools — sessions, screenshots, extraction, taught recipes and saved logins that stay on your disk and never touch anyone else's hardware.\n\nRuntime\nawdk>=3.8.0\n\nTools\n  pilot_open\n  pilot_navigate\n  pilot_observe\n  pilot_parse_ui\n  pilot_look\n  pilot_click\n  pilot_fill\n  pilot_scroll\n  pilot_extract\n  pilot_save_login\n  pilot_done\n  pilot_close",
+  "see_also": [
+    "awdk",
+    "awpack"
+  ],
+  "status": "preview",
+  "synopsis": "Run AitherBrowser on your own machine: an untethered Chromium an agent drives with the pilot_* tools — sessions, screenshots, extraction, taught recipes and saved logins that stay on your disk and never touch anyone else's hardware.",
+  "topic": "aitherbrowser"
+}

awkno-0.2.8/awkno/pages/awcap.json

@@ -0,0 +1,16 @@
+{
+  "adopt": "Describe one capability in one file and get the same name, arguments and JSON back from CLI, Python, MCP and relay.",
+  "category": "brick",
+  "description": "Kind: tool\n\nProblem\nA tool that ships a CLI, a Python API and an MCP server ends up with three names, three argument shapes and three result formats, and nothing tells you which of them still work.\n\nInstall\nnot yet published; builds in-tree\n\nCommands\n  awcap",
+  "see_also": [
+    "awdk",
+    "awnode",
+    "awrelay",
+    "awm",
+    "awflow",
+    "awgit"
+  ],
+  "status": "planned",
+  "synopsis": "Describe a capability once; call it the same way from CLI, Python, MCP and relay.",
+  "topic": "awcap"
+}

awkno-0.2.8/awkno/pages/awconnect.json

@@ -0,0 +1,12 @@
+{
+  "adopt": "# Chrome Web Store:\n#   https://chromewebstore.google.com/detail/awconnect/peeojgjhjficedkncdejbfnacooodbak\n#\n# Source (MIT): https://github.com/Aitherium/AitherConnect\n# Load unpacked from a checkout of `awconnect/` if you want your own build.\n#\n# Start a local daemon BEFORE expecting it to pair — `awnode mcp`, or the awsh\n# harness on :8362. With no daemon listening it reports\n#   \"No awdk daemon answered ...; using Cloud\"\n# and the page goes through the cloud instead of your machine. That fallback\n# is deliberate; it is also the thing to check first when it \"feels remote\".",
+  "category": "pack",
+  "description": "Kind: pack\n\nWhat it does\nAdd the awconnect browser extension: it hands an agent the page you are looking at, pairs over loopback to a local daemon, and falls back to the cloud only when no daemon answers.\n\nRuntime\nawdk>=3.8.0",
+  "see_also": [
+    "awdk",
+    "awpack"
+  ],
+  "status": "preview",
+  "synopsis": "Add the awconnect browser extension: it hands an agent the page you are looking at, pairs over loopback to a local daemon, and falls back to the cloud only when no daemon answers.",
+  "topic": "awconnect"
+}

{awkno-0.2.7 → awkno-0.2.8}/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 .)\n\nQuick start\n  npm install\n  npm run demo\n\nDocs\nhttps://aitherium.github.io/awdesk/",
+  "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. It also replaces the Windows utilities, each synced to AitherOS Online and reachable by agents through awsh, adk and AwNode under one command id: a snipping tool (PrintScreen), clipboard sync, a screen recorder (Shift+PrintScreen), a System window for processes, ports and connections, a File Explorer (Win+E, opt-in), Search this PC (Alt+Space) and a one-click public URL for a local port.\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",
@@ -11,7 +11,9 @@
     "awavatar",
     "AitherConnect",
     "awdaemons",
-    "awsettings"
+    "awsettings",
+    "awnode",
+    "awtunnel"
   ],
   "status": "public",
   "synopsis": "Aither World Desk -- the desktop body of AitherOS Online: tray, avatars, decision cards, the Living Desktop as an overlay.",

{awkno-0.2.7 → awkno-0.2.8}/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\n\nCommands\n  adk\n  adk-awdelegate\n  adk-bug\n  adk-py\n  adk-serve\n  adk-shell\n  adk-workspace\n  aither-adk\n  aither-hearth\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\nIn Claude Code\n  plugin                 awsh@awsh\n  command                adk claude setup\n  command                adk claude doctor\n  skill                  /awdk\n\nDocs\nhttps://aitherium.github.io/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-awdelegate\n  adk-bug\n  adk-py\n  adk-serve\n  adk-shell\n  adk-workspace\n  aither-adk\n  aither-hearth\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\nIn Claude Code\n  plugin                 awsh@awsh\n  command                adk claude setup\n  command                adk claude doctor\n  mcp                    python -m adk.harnesses.mcp_stdio\n  skill                  /awdk\n\nDocs\nhttps://aitherium.github.io/awdk/",
   "see_also": [
     "aitheros",
     "awskills",

{awkno-0.2.7 → awkno-0.2.8}/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\n\nCommands\n  awprism\n\nQuick start\n  pip install awprism\n\nIn Claude Code\n  mcp                    awprism mcp  [planned]\n\nDocs\nhttps://aitherium.github.io/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\nIn Claude Code\n  mcp                    awprism mcp\n\nDocs\nhttps://aitherium.github.io/awprism/",
   "see_also": [
     "awreason",
     "awrepl",

awkno-0.2.8/awkno/pages/aws.json

@@ -0,0 +1,20 @@
+{
+  "adopt": null,
+  "category": "stack",
+  "description": "An open-source private cloud you run yourself: identity, directory, RBAC, secrets, certificates, object storage, events, metrics, audit, messaging, jobs and tunnels, on an immutable awnix base on hardware you own. The parts a stranger can adopt alone are these bricks. The control plane behind them (Identity, Directory, Secrets, Strata, Flux, Pulse, Watch, Chronicle, Nexus, Relay) is a set of platform services that the sovereign-replica layer set stands up, not bricks. Solutions (CRM, mail, web hosting, MDM, the OccupySaaS packs) ship as optional packs on top and are never baked in. Design and the AWS service map: `.AITHEROS/43-AITHER-WORLD-SERVICES.md`.\n\nIncludes: awnix, awdaemons, awrun, awiam, awbac, awdit, awseal, awrelay, awtunnel, awpack",
+  "see_also": [
+    "awnix",
+    "awdaemons",
+    "awrun",
+    "awiam",
+    "awbac",
+    "awdit",
+    "awseal",
+    "awrelay",
+    "awtunnel",
+    "awpack"
+  ],
+  "status": "partial",
+  "synopsis": "Aither World Services",
+  "topic": "aws"
+}

{awkno-0.2.7 → awkno-0.2.8}/awkno/pages/awstorage.json

@@ -12,7 +12,9 @@
     "awseal",
     "awshare",
     "awm",
-    "awrise"
+    "awrise",
+    "awrtifact",
+    "awrelay"
   ],
   "status": "public",
   "synopsis": "Every drive on every node, indexed, classified and diffed -- so you can see what you own before you delete it.",

awkno-0.2.8/awkno/pages/salescompel.json

@@ -0,0 +1,12 @@
+{
+  "adopt": "# Source (Apache-2.0): https://github.com/occupysaas/salescompel\ngit clone https://github.com/occupysaas/salescompel\ncd salescompel\n\n# It needs PostgreSQL, and NOTHING UPSTREAM CREATES THE LOGINS OR THE GRANTS —\n# the role names below are examples you choose, not names the project defines.\n# The one rule the program enforces: migrations run as an OPERATOR principal\n# and serve runs as a RUNTIME principal that does not own the database\n# (serve refuses owner privileges). Grant the runtime logins what the schema\n# needs; the repository's docs are the authority on which privileges.\ncreatedb salescompel\npsql -d salescompel -c \"CREATE ROLE salescompel_op  LOGIN PASSWORD 'change-me';\"\npsql -d salescompel -c \"CREATE ROLE salescompel_app LOGIN PASSWORD 'change-me';\"\npsql -d salescompel -c \"CREATE ROLE salescompel_id  LOGIN PASSWORD 'change-me';\"\n\nexport MIGRATION_DATABASE_URL='postgres://salescompel_op@127.0.0.1:5432/salescompel?sslmode=disable'\nexport DATABASE_URL='postgres://salescompel_app@127.0.0.1:5432/salescompel?sslmode=disable'\nexport AUTH_DATABASE_URL='postgres://salescompel_id@127.0.0.1:5432/salescompel?sslmode=disable'\n\n# Build, migrate, create the first user, then serve.\ngo build -o salescompel ./cmd/salescompel\n./salescompel migrate status    # forward-only migrations; never run at startup\n./salescompel migrate up\nSALESCOMPEL_TENANT=acme SALESCOMPEL_USERNAME=admin@example.com \\\n  SALESCOMPEL_PASSWORD='<choose-one>' SALESCOMPEL_ROLE=owner \\\n  ./salescompel user create     # reads the four env vars above\n./salescompel serve -addr 127.0.0.1:8080\n\n# The UI is BUILT assets, not source: -assets defaults to web/dist. Build them\n# once with Node 22.12 or newer, or pass -assets \"\" to serve the API alone.\n#   (cd web && npm ci && npm run build)\n#\n# A non-loopback listener is REFUSED without TLS. That is deliberate:\n#   ./salescompel serve -addr 0.0.0.0:8443 -tls-cert cert.pem -tls-key key.pem",
+  "category": "pack",
+  "description": "Kind: pack\n\nWhat it does\nRun SalesCompel — the Apache-2.0, work-in-progress Salesforce replacement from the OccupySaaS community — from source: a Go/PostgreSQL candidate with a Vue record workflow, OAuth with PKCE, and a compatibility laboratory. This pack records how to build and serve it; it never vendors or hosts it.\n\nRuntime\nawdk>=3.8.0",
+  "see_also": [
+    "awdk",
+    "awpack"
+  ],
+  "status": "preview",
+  "synopsis": "Run SalesCompel — the Apache-2.0, work-in-progress Salesforce replacement from the OccupySaaS community — from source: a Go/PostgreSQL candidate with a Vue record workflow, OAuth with PKCE, and a compatibility laboratory",
+  "topic": "salescompel"
+}

awkno-0.2.8/awkno/pages/zeroauthy.json

@@ -0,0 +1,12 @@
+{
+  "adopt": "# Source, docs and the compatibility matrix (Apache-2.0):\n#   https://github.com/occupysaas/zeroauthy\ngit clone https://github.com/occupysaas/zeroauthy\ncd zeroauthy\n\n# Their quickstart (docs/quickstart.md) covers the TLS certificate pair and\n# master.key that the server requires before it will start.\n# Put cert.pem, key.pem and master.key where the run command below expects.\n\n# Run the published image. Tag 1.0.0-rc.1 is the current public release.\ndocker run -d --name zeroauthy -p 8443:8443 -v zeroauthy-data:/data \\\n  -v \"$PWD/certs:/certs:ro\" \\\n  -e ZEROAUTHY_SERVER__LISTEN=:8443 \\\n  -e ZEROAUTHY_SERVER__SYSTEM_HOST=system.localhost:8443 \\\n  -e ZEROAUTHY_SERVER__TLS_CERT_FILE=/certs/cert.pem \\\n  -e ZEROAUTHY_SERVER__TLS_KEY_FILE=/certs/key.pem \\\n  -e ZEROAUTHY_SECURITY__MASTER_KEY=\"$(cat master.key)\" \\\n  ghcr.io/occupysaas/zeroauthy:1.0.0-rc.1\n\n# First admin, then sign in at https://system.localhost:8443/\ndocker exec zeroauthy zeroauthy admin create --email you@example.com\n\n# No Docker? Release binaries for linux/amd64, linux/arm64 and darwin/arm64\n# are on their releases page, with a SHA256SUMS file.",
+  "category": "pack",
+  "description": "Kind: pack\n\nWhat it does\nStand up zeroauthy — the Apache-2.0 Go identity provider from the OccupySaaS community — from its published container image or its release binaries. This pack installs and documents it; it never vendors or hosts it.\n\nRuntime\nawdk>=3.8.0",
+  "see_also": [
+    "awdk",
+    "awpack"
+  ],
+  "status": "preview",
+  "synopsis": "Stand up zeroauthy — the Apache-2.0 Go identity provider from the OccupySaaS community — from its published container image or its release binaries",
+  "topic": "zeroauthy"
+}

{awkno-0.2.7 → awkno-0.2.8}/awkno.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awkno
-Version: 0.2.7
+Version: 0.2.8
 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.7 → awkno-0.2.8}/awkno.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ awkno.egg-info/top_level.txt
 awkno/pages/agent-senses.json
 awkno/pages/agent-vm.json
 awkno/pages/agentic-orchestrator.json
+awkno/pages/aitherbrowser.json
 awkno/pages/aitherconnect.json
 awkno/pages/aitherkvcache.json
 awkno/pages/aitheros.json
@@ -30,7 +31,9 @@ awkno/pages/awbrain.json
 awkno/pages/awbrowse.json
 awkno/pages/awcache.json
 awkno/pages/awcams.json
+awkno/pages/awcap.json
 awkno/pages/awclassify.json
+awkno/pages/awconnect.json
 awkno/pages/awdaemons.json
 awkno/pages/awdata.json
 awkno/pages/awdecide.json
@@ -85,6 +88,7 @@ awkno/pages/awrise.json
 awkno/pages/awrouter.json
 awkno/pages/awrtifact.json
 awkno/pages/awrun.json
+awkno/pages/aws.json
 awkno/pages/awsaga.json
 awkno/pages/awscope.json
 awkno/pages/awscreen.json
@@ -168,6 +172,7 @@ awkno/pages/personal-mesh-pool.json
 awkno/pages/provenance.json
 awkno/pages/ps5-bridge.json
 awkno/pages/retrieval-you-trained.json
+awkno/pages/salescompel.json
 awkno/pages/set-and-forget.json
 awkno/pages/shared-worktree.json
 awkno/pages/the-aither-way-claude-code.json
@@ -180,4 +185,5 @@ awkno/pages/trust.json
 awkno/pages/wake-learning-loop.json
 awkno/pages/who-what-did.json
 awkno/pages/workspace-bridge.json
+awkno/pages/zeroauthy.json
 tests/test_awkno.py

{awkno-0.2.7 → awkno-0.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "awkno"
-version = "0.2.7"
+version = "0.2.8"
 description = "The man page for the Aither World — every brick, stack and law, in your terminal, offline."
 readme = "README.md"
 requires-python = ">=3.10"

{awkno-0.2.7 → awkno-0.2.8}/tests/test_awkno.py

@@ -247,6 +247,43 @@ class TestAwknoRegistry:
             data2_str = json.dumps(pages2[key], sort_keys=True)
             assert data1_str == data2_str, f"Page {key} differs between runs"
 
+    def test_shelf_pack_never_overwrites_a_registry_brick(self, tmp_path):
+        """A pack named like a brick (awnode, awdesk) must not replace the brick page.
+
+        It did: packs were written after bricks into the same dict key, so every
+        regen turned the `awnode` brick page into a pack page and EC012 then
+        reported the brick as absent from the offline corpus.
+        """
+        from awkno.generate import AwknoGenerator
+
+        root = tmp_path / "AitherOS"
+        (root / "config").mkdir(parents=True)
+        (root / "config" / "ecosystem.yaml").write_text(
+            "bricks:\n"
+            "  - id: awzed\n    name: awzed\n    kind: runtime\n    status: public\n"
+            "    problem: p\n    adopt: a\n",
+            encoding="utf-8")
+        shelf = tmp_path / "awpack" / "packs"
+        shelf.mkdir(parents=True)
+        real = Path(__file__).resolve()
+        while real != real.parent and not (real / "awpack" / "packs" / "awnode").is_dir():
+            real = real.parent
+        src = real / "awpack" / "packs" / "awnode" / "pack.yaml"
+        if not src.is_file():
+            pytest.skip("standalone awkno checkout: no shelf pack to copy")
+        (shelf / "awzed").mkdir()
+        text = src.read_text(encoding="utf-8").replace("awnode", "awzed")
+        (shelf / "awzed" / "pack.yaml").write_text(text, encoding="utf-8")
+        out = tmp_path / "pages"
+        out.mkdir()
+
+        gen = AwknoGenerator(str(root), output_dir=str(out))
+        assert gen._make_pack_page(shelf / "awzed" / "pack.yaml") is not None, \
+            "fixture pack must be a real shelf page or the test proves nothing"
+        pages = gen.generate()
+
+        assert pages["awzed"]["category"] == "brick", pages["awzed"]
+
     def test_scrub_removes_empty_span_and_keeps_code_fences(self):
         """The empty-span safety net must not eat two-thirds of a ``` fence.