axis-synome 0.1.0.dev61__tar.gz → 0.1.0.dev62__tar.gz

axis_synome-0.1.0.dev62/AGENTS.md

@@ -0,0 +1,58 @@
+# axis-synome — Agent Instructions
+
+`axis-synome` is a Python framework that encodes Sky Atlas calculation rules as
+machine-verifiable specs. This file documents agent rules that apply when working
+inside `axis-synome/`.
+
+## Setup
+
+From the repo root, run **`make setup`** once after cloning. This installs Python
+deps, lefthook git hooks, and the Claude/Codex skills — all of which further guide
+and constrain agent work. Run **`make check-all`** before opening or updating a PR
+(it is what CI runs).
+
+## Where to find what
+
+- **`WRITING_SPECS.md`** — authoritative guide for writing axis-synome specs. Read
+  it before editing anything under `spec/`.
+
+## Editing axis-synome specs (`spec/`)
+
+Highlights from `WRITING_SPECS.md` that are not auto-discoverable from the code:
+
+- Specs are **pure, declarative Python**: no I/O, no mutable state, no side effects.
+- The spec language subset is enforced by the `AXS` flake8 plugin
+  (`axis_synome.spec_validator`); read its rules in `python_subset.py` and `checker.py`
+  rather than restating them here. In short: no reassignment, no conditional assignment,
+  no imperative control flow, no mutation, imports limited to the spec, `math`, and
+  approved support packages.
+- **Provenance lives in docstrings as reST fields**, e.g. `:source_uuid: <uuid>`. In
+  `**/formulas/*.py`, public functions are treated as formulas by convention; outside
+  formula modules, `:source_uuid:` is the explicit opt-in marker. Parameters are
+  module-level `Final[...]` constants with a trailing string-literal docstring carrying
+  the description and `:source_uuid:`. The `check-spec-uuids` tool resolves every
+  `:source_uuid:` against the `content/` document tree on every `make check-all`.
+- **Entities** use `pydantic.dataclasses.dataclass` (frozen) with closed-world `Enum`
+  fields; encode eligibility via Enum membership (e.g. `EligiblePrimeAgentASC`) rather
+  than booleans or runtime checks.
+- **Start entities formula-local** (`spec/<domain>/entities/`); only uplift to a shared
+  location when ≥3 independent formulas reuse them. Moving entities is a breaking
+  change.
+
+## Reviewing axis-synome PRs
+
+The shared review focus / non-focus list lives in
+[`../.github/copilot-instructions.md`](../.github/copilot-instructions.md) so Copilot
+and humans use the same list. Subtree-specific review rules for `axis-synome/**` live
+in
+[`../.github/instructions/axis-synome.instructions.md`](../.github/instructions/axis-synome.instructions.md)
+(in particular: spec-review patterns AXS cannot enforce, Atlas-alignment guidance,
+and the no-defensive-error-handling rule). Read both before reviewing.
+
+## What belongs in this AGENTS.md
+
+Only rules that an agent **cannot reasonably discover on its own** by reading the
+axis-synome subtree (e.g. `pyproject.toml`, the root `Makefile`, `lefthook.yml`).
+Things that *can* be discovered — make-target catalogues, dependency lists,
+type-checker choice, lint rule sets — drift out of date and belong in their config
+of origin, not here.

axis_synome-0.1.0.dev62/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

{axis_synome-0.1.0.dev61 → axis_synome-0.1.0.dev62}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axis-synome
-Version: 0.1.0.dev61
+Version: 0.1.0.dev62
 Summary: Axis specification modules (entities, formulas, validators)
 Author-email: Archon Tech <hello@archontech.ai>
 License: MIT

{axis_synome-0.1.0.dev61 → axis_synome-0.1.0.dev62}/src/axis_synome/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.0.dev61'
-__version_tuple__ = version_tuple = (0, 1, 0, 'dev61')
+__version__ = version = '0.1.0.dev62'
+__version_tuple__ = version_tuple = (0, 1, 0, 'dev62')
 
 __commit_id__ = commit_id = None

{axis_synome-0.1.0.dev61 → axis_synome-0.1.0.dev62}/src/axis_synome.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axis-synome
-Version: 0.1.0.dev61
+Version: 0.1.0.dev62
 Summary: Axis specification modules (entities, formulas, validators)
 Author-email: Archon Tech <hello@archontech.ai>
 License: MIT

{axis_synome-0.1.0.dev61 → axis_synome-0.1.0.dev62}/src/axis_synome.egg-info/SOURCES.txt

@@ -1,4 +1,6 @@
 .flake8
+AGENTS.md
+CLAUDE.md
 README.md
 WRITING_SPECS.md
 pyproject.toml