awkno 0.2.3__tar.gz → 0.2.4__tar.gz

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

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

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

awkno-0.2.4/awkno/pages/law-24.json

@@ -0,0 +1,11 @@
+{
+  "adopt": null,
+  "body": "*Part VI · Configuration*\n\n**Fires when:** you add a paragraph to `CLAUDE.md`, `AGENTS.md`, or any rule file a\ncoding agent loads on every turn; when a subagent dies on \"prompt is too long\" before\nits first tool call; when two harnesses (Claude Code and opencode, codex, gemini) read\ndifferent instruction files for the same repository.\n\n## The law\n\nEvery instruction file an agent loads unconditionally is paid on **every turn of every\nsession**, before the agent has read a single line of your code, and compaction cannot\nreclaim it. That makes it a budget, not a document. Pin the budget with a check that\nfails, ratchet it down only, and treat a rule that grew as a rule to scope or split — never\nas a reason to raise the pin.\n\nTwo shapes follow from that:\n\n1. **One shared file, one harness layer.** The facts every agent needs (what the system\n is, the standing instructions, which tool to reach for first) live in a\n harness-neutral `AGENTS.md`. The harness-specific file (`CLAUDE.md`) *imports* it and\n adds only what that harness needs: how its rules load, its MCP wiring, its hooks. A\n second copy drifts; this repository measured the drift twice and lost a curated file\n to a \"run the generator\" fix before it stopped copying.\n2. **Scope, then split by hand.** A rule that loads only when a matching path is touched\n costs nothing the rest of the time — but only the frontmatter key the harness honours\n does that (`paths:` for Claude Code; `globs:`/`alwaysApply:` do nothing and read as\n scoped). When a scoped rule is still too long, move its dated evidence to a reference\n file with a one-line pointer, and move it **by hand, section by section**: a\n heuristic splitter that infers \"operative\" from markup deleted a whole gate here\n while correctly trimming the line above it.\n\n## The numbers that proved this\n\nMeasured 2026-09-21 in the monorepo, with the checker that pins it\n(`your_checker.py`, CF001 always-applied, CF002 worst case):\n\n| what | before | after |\n|---|---|---|\n| always-applied context (root file + every unscoped rule) | 8,459 tokens, over the 8,000 pin | 5,490 tokens |\n| the root file alone | 10,830 chars, hand-owned, one copy | 4,326 chars importing a 6,552-char shared file |\n| worst case a subagent carries before its first turn | 124,798 tokens against an 87,000 pin | falling, gate doc by gate doc |\n\nThe worst-case pin is not theoretical: on 2026-09-02 six subagents matching many path\nglobs consumed 1.19 M tokens and produced zero output, each dying on the prompt limit\nbefore its first turn.\n\nA checker that counts the root file but not what it imports would have reported the\nsplit as an 8 KB win it never was — so the check follows the import line and its\nself-test proves an imported file is counted.\n\n## The check\n\n- One checker owns both ceilings and exits 1 over either, 2 when it cannot read the\n files, never 0 on silence. Its self-test proves both ceilings fire in both directions.\n- The floor ratchets down only. A commit that raises the pin needs a reason in the\n commit; a commit that adds an always-on paragraph pays for it by scoping or splitting\n another.\n- A rule's narrative lives next to it in a reference file, never in the rule. A pointer\n line is enough; the evidence is one hop away when the rule is disputed.",
+  "category": "law",
+  "description": "Law #24",
+  "see_also": null,
+  "slug": "the-always-on-context-is-a-budget",
+  "status": "published",
+  "synopsis": "The always-on context is a budget — split the shared file from the harness file",
+  "topic": "law-24"
+}

{awkno-0.2.3 → awkno-0.2.4}/awkno.egg-info/PKG-INFO

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

@@ -142,6 +142,7 @@ awkno/pages/law-20.json
 awkno/pages/law-21.json
 awkno/pages/law-22.json
 awkno/pages/law-23.json
+awkno/pages/law-24.json
 awkno/pages/mediaforge.json
 awkno/pages/mine-what-you-ran.json
 awkno/pages/one-surface.json

{awkno-0.2.3 → awkno-0.2.4}/pyproject.toml

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