agyloop 0.1.0__tar.gz

agyloop-0.1.0/.agent/rules/agyloop-agent-sdk.md

@@ -0,0 +1,23 @@
+# agyloop-agent-sdk (Antigravity mirror of `.claude/skills/agyloop-agent-sdk/SKILL.md`)
+
+
+# agyloop + google-antigravity
+
+`infrastructure/agent/` is the only place `google.antigravity` may be
+imported.
+
+- Default gateway is the SDK (`Agent` + `LocalAgentConfig`). `--gateway cli`
+  shells out to `agy`.
+- Autonomy: `policy.allow_all()` plus workspace/destructive scopes.
+  Interactive hooks are never registered. `ask_question` is denied with
+  guidance.
+- `--unsafe-skip-permissions` is refused on the SDK path.
+- Live config pins `mcp_servers=[]` (OAuth cannot complete unattended).
+- Additive `system_instructions` only — never `CustomSystemInstructions`.
+- Input detection in Go `localharness` hardcodes withdrawn
+  `gemini-2.5-flash-lite`. agyloop retargets via env + extra `ModelTarget`,
+  then a copy-patch (`ANTIGRAVITY_HARNESS_PATH`), then monkeypatch /
+  site-packages backup / localhost rewrite proxy. See
+  `docs/contributing/harness-patch.md`.
+- Empty drain + 404 / `NOT_FOUND` / "no longer available to new users" in
+  harness logs → `AgentConfigError`, not Available.

agyloop-0.1.0/.agent/rules/agyloop-architecture.md

@@ -0,0 +1,29 @@
+# agyloop-architecture (Antigravity mirror of `.claude/skills/agyloop-architecture/SKILL.md`)
+
+
+# agyloop architecture
+
+Dependencies point inward. `import-linter` enforces this in CI.
+
+```
+src/agyloop/
+├── domain/           # PURE. stdlib only. No I/O, no async, no third-party.
+├── application/      # Protocol ports + use cases. Imports domain + stdlib.
+├── infrastructure/   # Adapters. ONLY layer that may import google.antigravity.
+├── cli/              # Typer. Calls application via bootstrap.
+└── bootstrap.py      # Composition root — the ONE module that sees every layer.
+```
+
+## Where does new code go?
+
+1. Touches FS, network, clock, or an SDK? → `infrastructure/`, behind a
+   `Protocol` in `application/ports.py`. Never `import google.antigravity`
+   elsewhere.
+2. Pure decision, zero I/O? → `domain/`. Examples: `classify.py`,
+   `waiting.py`, `completion.py`, `loop.py`.
+3. Orchestration (port → domain → port)? → `application/`.
+4. Argument parsing / terminal formatting? → `cli/`.
+
+When in doubt, push logic inward. `lint-imports` names the broken contract.
+
+See ADR 0001.

agyloop-0.1.0/.agent/rules/agyloop-docs.md

@@ -0,0 +1,26 @@
+# agyloop-docs (Antigravity mirror of `.claude/skills/agyloop-docs/SKILL.md`)
+
+
+# agyloop documentation
+
+| Content | Goes in |
+|---|---|
+| Always-true facts | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` (short routers) |
+| Procedures | `.claude/skills/`, `.cursor/rules/`, `.agents/skills/`, `.agent/rules/` |
+| User how-to | `docs/getting-started/`, `docs/guides/` |
+| One hard decision | `docs/architecture/decisions/` |
+| Contributor process | `docs/contributing/` |
+
+README is what PyPI renders: **absolute** URLs only for docs, repo,
+security, contributing, changelog. Relative `docs/*.md` links break on PyPI.
+
+```bash
+pip install -e ".[docs]"
+mkdocs serve
+mkdocs build --strict
+```
+
+`edit_uri` stays `edit/main/docs/` — the published site tracks `main`.
+
+When a procedure changes, update Claude + Cursor + Codex + Antigravity in
+the same PR.

agyloop-0.1.0/.agent/rules/agyloop-domain-model.md

@@ -0,0 +1,33 @@
+# agyloop-domain-model (Antigravity mirror of `.claude/skills/agyloop-domain-model/SKILL.md`)
+
+
+# agyloop domain model
+
+`src/agyloop/domain/` is stdlib-only. Frozen dataclasses / closed unions.
+
+## CapacityState (ADR 0003 — five members)
+
+```
+Available | WindowExhausted | TransientThrottle | CreditsExhausted | AuthenticationFailed
+```
+
+`CreditsExhausted` has **no** `resets_at`. Never add one. Credits ≠ window.
+
+`TransientThrottle` is a short waitable (503 / UNAVAILABLE / RetryInfo).
+
+## classify.py
+
+Ladder over `TurnSignals`. Operator cancel (exception type **or**
+`context canceled` / `context cancelled` / `manage_task` in the message)
+is Available **before** the throttle ladder. Do not match a bare
+`canceled`. 404 / withdrawn-model is **not** a sixth state — the adapter
+raises `AgentConfigError`.
+
+## completion.py
+
+Structured `{complete, remaining_work, blocked_on, summary}`. Capacity
+rejection outranks a Done claim.
+
+## loop.py
+
+Pure state machine. No I/O. The runner only performs the Decision.

agyloop-0.1.0/.agent/rules/agyloop-quality-gates.md

@@ -0,0 +1,28 @@
+# agyloop-quality-gates (Antigravity mirror of `.claude/skills/agyloop-quality-gates/SKILL.md`)
+
+
+# agyloop quality gates
+
+```bash
+ruff check src tests
+ruff format --check src tests
+mypy --strict src/agyloop
+pytest
+pytest -m system
+lint-imports
+bandit -q -r src/agyloop
+pip-audit
+mkdocs build --strict
+```
+
+| Gate | Fix |
+|---|---|
+| `ruff check` | `ruff check --fix src tests` |
+| `ruff format` | `ruff format src tests` |
+| `mypy` | Annotate. No bare `Any` without a reason. |
+| `lint-imports` | Move code to the correct layer (architecture skill). |
+| `bandit` | Fix, or `# nosec Bxxx` with *why*. |
+| `pip-audit` | Bump the dependency. |
+| `mkdocs` | Broken link or missing nav entry. |
+
+`pre-commit run --all-files` runs the hook subset. Python 3.12–3.13 in CI.

agyloop-0.1.0/.agent/rules/agyloop-releasing.md

@@ -0,0 +1,29 @@
+# agyloop-releasing (Antigravity mirror of `.claude/skills/agyloop-releasing/SKILL.md`)
+
+
+# agyloop releasing
+
+```
+main         ← always releasable; release-please target-branch: main
+  ▲ merge commit
+develop      ← default GitHub branch; feature PRs squash here
+  ▲ squash-merge
+feature/*    ← branch from develop, never from main
+```
+
+Never implement on `main`.
+
+Commit: `<type>[scope]: <description>`. Hook `--strict`. Types: feat, fix,
+docs, style, refactor, perf, test, build, ci, chore, revert.
+
+First public tag is **v0.1.0** (already in pyproject / manifest). Later:
+release-please PR on `main`, then `publish-to-pypi.yml` (filename
+load-bearing) with OIDC environments `testpypi` / `pypi` (manual approve).
+
+TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agyloop
+```
+
+See `docs/contributing/release-process.md`.

agyloop-0.1.0/.agent/rules/agyloop-rest-surface.md

@@ -0,0 +1,14 @@
+# agyloop-rest-surface (Antigravity mirror of `.claude/skills/agyloop-rest-surface/SKILL.md`)
+
+
+# agyloop REST surface (generated)
+
+`agyloop api` is generated from Gemini REST discovery with a CI drift gate
+(ADR 0015). Do not hand-write individual endpoints or the gate is meaningless.
+
+- Developer lane: `GOOGLE_API_KEY` as a query parameter. Treat it as secret.
+- Vertex lane is separate; doctor never guesses when both look possible.
+- Baseline JSON lives under `src/agyloop/infrastructure/api/`.
+- `--json` / file inlining for request bodies.
+
+See `docs/guides/rest-api-surface.md`.

agyloop-0.1.0/.agent/rules/agyloop-router.md

@@ -0,0 +1,13 @@
+# agyloop (Antigravity router)
+
+Facts only. Procedures are the other files in this directory (mirrors of
+`.claude/skills/`).
+
+- Never block on a human. Credits ≠ window. domain/ is stdlib-only.
+- Capacity rejection outranks completion. Conventional Commits.
+- Never implement on `main`; squash into `develop`.
+- Developer auth: `GOOGLE_API_KEY`. Do not set `GOOGLE_GENAI_USE_VERTEXAI`
+  on that lane.
+- `google.antigravity` imports stay in `infrastructure/`.
+
+See root `GEMINI.md`, `CLAUDE.md`, `AGENTS.md`.

agyloop-0.1.0/.agent/rules/agyloop-testing.md

@@ -0,0 +1,25 @@
+# agyloop-testing (Antigravity mirror of `.claude/skills/agyloop-testing/SKILL.md`)
+
+
+# agyloop testing
+
+```
+tests/domain/            # pure unit + Hypothesis
+tests/application/       # fakes for every port (fakes.py)
+tests/infrastructure/    # adapters
+tests/system/            # marker: system — real FS/git + scripted agent
+tests/live/              # marker: live — real Google account, opt-in
+```
+
+```bash
+pytest                 # skips live + system
+pytest -m system
+pytest -m live         # needs GOOGLE_API_KEY
+```
+
+- **Fakes over mocks.** Implement the `Protocol`; `mypy --strict` checks it.
+- **No `time.sleep` in tests.** `FakeClock` / `FakeSleeper`.
+- Hypothesis for numeric / time-based invariants.
+- `# pragma: no cover` needs a reason.
+- Unit tests set `AGYLOOP_SKIP_HARNESS_RETARGET=1` (autouse) so they do not
+  copy the 99MB bundled `localharness`.

agyloop-0.1.0/.agents/skills/agyloop-agent-sdk/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: agyloop-agent-sdk
+description: google-antigravity Agent + LocalAgentConfig, never-block policies, harness retarget. Consult before editing infrastructure/agent/.
+allowed-tools: Read Grep Glob
+---
+
+# agyloop + google-antigravity
+
+`infrastructure/agent/` is the only place `google.antigravity` may be
+imported.
+
+- Default gateway is the SDK (`Agent` + `LocalAgentConfig`). `--gateway cli`
+  shells out to `agy`.
+- Autonomy: `policy.allow_all()` plus workspace/destructive scopes.
+  Interactive hooks are never registered. `ask_question` is denied with
+  guidance.
+- `--unsafe-skip-permissions` is refused on the SDK path.
+- Live config pins `mcp_servers=[]` (OAuth cannot complete unattended).
+- Additive `system_instructions` only — never `CustomSystemInstructions`.
+- Input detection in Go `localharness` hardcodes withdrawn
+  `gemini-2.5-flash-lite`. agyloop retargets via env + extra `ModelTarget`,
+  then a copy-patch (`ANTIGRAVITY_HARNESS_PATH`), then monkeypatch /
+  site-packages backup / localhost rewrite proxy. See
+  `docs/contributing/harness-patch.md`.
+- Empty drain + 404 / `NOT_FOUND` / "no longer available to new users" in
+  harness logs → `AgentConfigError`, not Available.

agyloop-0.1.0/.agents/skills/agyloop-architecture/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: agyloop-architecture
+description: Onion layers for agyloop (domain, application, infrastructure, cli), import-linter, and where new code belongs. Use before adding a module under src/agyloop/.
+allowed-tools: Read Grep Glob Bash(lint-imports)
+---
+
+# agyloop architecture
+
+Dependencies point inward. `import-linter` enforces this in CI.
+
+```
+src/agyloop/
+├── domain/           # PURE. stdlib only. No I/O, no async, no third-party.
+├── application/      # Protocol ports + use cases. Imports domain + stdlib.
+├── infrastructure/   # Adapters. ONLY layer that may import google.antigravity.
+├── cli/              # Typer. Calls application via bootstrap.
+└── bootstrap.py      # Composition root — the ONE module that sees every layer.
+```
+
+## Where does new code go?
+
+1. Touches FS, network, clock, or an SDK? → `infrastructure/`, behind a
+   `Protocol` in `application/ports.py`. Never `import google.antigravity`
+   elsewhere.
+2. Pure decision, zero I/O? → `domain/`. Examples: `classify.py`,
+   `waiting.py`, `completion.py`, `loop.py`.
+3. Orchestration (port → domain → port)? → `application/`.
+4. Argument parsing / terminal formatting? → `cli/`.
+
+When in doubt, push logic inward. `lint-imports` names the broken contract.
+
+See ADR 0001.

agyloop-0.1.0/.agents/skills/agyloop-docs/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: agyloop-docs
+description: Where content belongs (routers vs skills vs docs), MkDocs strict build, PyPI-safe absolute README links.
+allowed-tools: Read Grep Glob Bash(mkdocs *)
+---
+
+# agyloop documentation
+
+| Content | Goes in |
+|---|---|
+| Always-true facts | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` (short routers) |
+| Procedures | `.claude/skills/`, `.cursor/rules/`, `.agents/skills/`, `.agent/rules/` |
+| User how-to | `docs/getting-started/`, `docs/guides/` |
+| One hard decision | `docs/architecture/decisions/` |
+| Contributor process | `docs/contributing/` |
+
+README is what PyPI renders: **absolute** URLs only for docs, repo,
+security, contributing, changelog. Relative `docs/*.md` links break on PyPI.
+
+```bash
+pip install -e ".[docs]"
+mkdocs serve
+mkdocs build --strict
+```
+
+`edit_uri` stays `edit/main/docs/` — the published site tracks `main`.
+
+When a procedure changes, update Claude + Cursor + Codex + Antigravity in
+the same PR.

agyloop-0.1.0/.agents/skills/agyloop-domain-model/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: agyloop-domain-model
+description: CapacityState, TurnSignals, completion verdicts, waiting, and the run loop. Consult before editing domain/classify.py, waiting.py, completion.py, or loop.py.
+allowed-tools: Read Grep Glob
+---
+
+# agyloop domain model
+
+`src/agyloop/domain/` is stdlib-only. Frozen dataclasses / closed unions.
+
+## CapacityState (ADR 0003 — five members)
+
+```
+Available | WindowExhausted | TransientThrottle | CreditsExhausted | AuthenticationFailed
+```
+
+`CreditsExhausted` has **no** `resets_at`. Never add one. Credits ≠ window.
+
+`TransientThrottle` is a short waitable (503 / UNAVAILABLE / RetryInfo).
+
+## classify.py
+
+Ladder over `TurnSignals`. Operator cancel (exception type **or**
+`context canceled` / `context cancelled` / `manage_task` in the message)
+is Available **before** the throttle ladder. Do not match a bare
+`canceled`. 404 / withdrawn-model is **not** a sixth state — the adapter
+raises `AgentConfigError`.
+
+## completion.py
+
+Structured `{complete, remaining_work, blocked_on, summary}`. Capacity
+rejection outranks a Done claim.
+
+## loop.py
+
+Pure state machine. No I/O. The runner only performs the Decision.

agyloop-0.1.0/.agents/skills/agyloop-quality-gates/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: agyloop-quality-gates
+description: How to run and fix ruff, mypy --strict, pytest, lint-imports, bandit, pip-audit, mkdocs. Consult when a gate fails.
+allowed-tools: Bash(ruff *) Bash(mypy *) Bash(pytest *) Bash(lint-imports) Bash(bandit *) Bash(pip-audit *) Bash(pre-commit *) Bash(mkdocs *) Read
+---
+
+# agyloop quality gates
+
+```bash
+ruff check src tests
+ruff format --check src tests
+mypy --strict src/agyloop
+pytest
+pytest -m system
+lint-imports
+bandit -q -r src/agyloop
+pip-audit
+mkdocs build --strict
+```
+
+| Gate | Fix |
+|---|---|
+| `ruff check` | `ruff check --fix src tests` |
+| `ruff format` | `ruff format src tests` |
+| `mypy` | Annotate. No bare `Any` without a reason. |
+| `lint-imports` | Move code to the correct layer (architecture skill). |
+| `bandit` | Fix, or `# nosec Bxxx` with *why*. |
+| `pip-audit` | Bump the dependency. |
+| `mkdocs` | Broken link or missing nav entry. |
+
+`pre-commit run --all-files` runs the hook subset. Python 3.12–3.13 in CI.

agyloop-0.1.0/.agents/skills/agyloop-releasing/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: agyloop-releasing
+description: gitflow, Conventional Commits, release-please, Trusted Publishing. Consult before branching, committing, or cutting a release.
+allowed-tools: Bash(git *) Read
+---
+
+# agyloop releasing
+
+```
+main         ← always releasable; release-please target-branch: main
+  ▲ merge commit
+develop      ← default GitHub branch; feature PRs squash here
+  ▲ squash-merge
+feature/*    ← branch from develop, never from main
+```
+
+Never implement on `main`.
+
+Commit: `<type>[scope]: <description>`. Hook `--strict`. Types: feat, fix,
+docs, style, refactor, perf, test, build, ci, chore, revert.
+
+First public tag is **v0.1.0** (already in pyproject / manifest). Later:
+release-please PR on `main`, then `publish-to-pypi.yml` (filename
+load-bearing) with OIDC environments `testpypi` / `pypi` (manual approve).
+
+TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agyloop
+```
+
+See `docs/contributing/release-process.md`.

agyloop-0.1.0/.agents/skills/agyloop-rest-surface/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: agyloop-rest-surface
+description: Generated agyloop api command tree from Gemini REST discovery, drift gate. Consult before hand-writing api commands.
+allowed-tools: Read Grep Glob
+---
+
+# agyloop REST surface (generated)
+
+`agyloop api` is generated from Gemini REST discovery with a CI drift gate
+(ADR 0015). Do not hand-write individual endpoints or the gate is meaningless.
+
+- Developer lane: `GOOGLE_API_KEY` as a query parameter. Treat it as secret.
+- Vertex lane is separate; doctor never guesses when both look possible.
+- Baseline JSON lives under `src/agyloop/infrastructure/api/`.
+- `--json` / file inlining for request bodies.
+
+See `docs/guides/rest-api-surface.md`.

agyloop-0.1.0/.agents/skills/agyloop-testing/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: agyloop-testing
+description: Fakes over mocks, FakeClock/FakeSleeper, Hypothesis, pytest markers. Consult before adding tests or mocks.
+allowed-tools: Read Grep Glob Bash(pytest *)
+---
+
+# agyloop testing
+
+```
+tests/domain/            # pure unit + Hypothesis
+tests/application/       # fakes for every port (fakes.py)
+tests/infrastructure/    # adapters
+tests/system/            # marker: system — real FS/git + scripted agent
+tests/live/              # marker: live — real Google account, opt-in
+```
+
+```bash
+pytest                 # skips live + system
+pytest -m system
+pytest -m live         # needs GOOGLE_API_KEY
+```
+
+- **Fakes over mocks.** Implement the `Protocol`; `mypy --strict` checks it.
+- **No `time.sleep` in tests.** `FakeClock` / `FakeSleeper`.
+- Hypothesis for numeric / time-based invariants.
+- `# pragma: no cover` needs a reason.
+- Unit tests set `AGYLOOP_SKIP_HARNESS_RETARGET=1` (autouse) so they do not
+  copy the 99MB bundled `localharness`.

agyloop-0.1.0/.claude/skills/agyloop-agent-sdk/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: agyloop-agent-sdk
+description: google-antigravity Agent + LocalAgentConfig, never-block policies, harness retarget. Consult before editing infrastructure/agent/.
+allowed-tools: Read Grep Glob
+---
+
+# agyloop + google-antigravity
+
+`infrastructure/agent/` is the only place `google.antigravity` may be
+imported.
+
+- Default gateway is the SDK (`Agent` + `LocalAgentConfig`). `--gateway cli`
+  shells out to `agy`.
+- Autonomy: `policy.allow_all()` plus workspace/destructive scopes.
+  Interactive hooks are never registered. `ask_question` is denied with
+  guidance.
+- `--unsafe-skip-permissions` is refused on the SDK path.
+- Live config pins `mcp_servers=[]` (OAuth cannot complete unattended).
+- Additive `system_instructions` only — never `CustomSystemInstructions`.
+- Input detection in Go `localharness` hardcodes withdrawn
+  `gemini-2.5-flash-lite`. agyloop retargets via env + extra `ModelTarget`,
+  then a copy-patch (`ANTIGRAVITY_HARNESS_PATH`), then monkeypatch /
+  site-packages backup / localhost rewrite proxy. See
+  `docs/contributing/harness-patch.md`.
+- Empty drain + 404 / `NOT_FOUND` / "no longer available to new users" in
+  harness logs → `AgentConfigError`, not Available.

agyloop-0.1.0/.claude/skills/agyloop-architecture/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: agyloop-architecture
+description: Onion layers for agyloop (domain, application, infrastructure, cli), import-linter, and where new code belongs. Use before adding a module under src/agyloop/.
+allowed-tools: Read Grep Glob Bash(lint-imports)
+---
+
+# agyloop architecture
+
+Dependencies point inward. `import-linter` enforces this in CI.
+
+```
+src/agyloop/
+├── domain/           # PURE. stdlib only. No I/O, no async, no third-party.
+├── application/      # Protocol ports + use cases. Imports domain + stdlib.
+├── infrastructure/   # Adapters. ONLY layer that may import google.antigravity.
+├── cli/              # Typer. Calls application via bootstrap.
+└── bootstrap.py      # Composition root — the ONE module that sees every layer.
+```
+
+## Where does new code go?
+
+1. Touches FS, network, clock, or an SDK? → `infrastructure/`, behind a
+   `Protocol` in `application/ports.py`. Never `import google.antigravity`
+   elsewhere.
+2. Pure decision, zero I/O? → `domain/`. Examples: `classify.py`,
+   `waiting.py`, `completion.py`, `loop.py`.
+3. Orchestration (port → domain → port)? → `application/`.
+4. Argument parsing / terminal formatting? → `cli/`.
+
+When in doubt, push logic inward. `lint-imports` names the broken contract.
+
+See ADR 0001.

agyloop-0.1.0/.claude/skills/agyloop-docs/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: agyloop-docs
+description: Where content belongs (routers vs skills vs docs), MkDocs strict build, PyPI-safe absolute README links.
+allowed-tools: Read Grep Glob Bash(mkdocs *)
+---
+
+# agyloop documentation
+
+| Content | Goes in |
+|---|---|
+| Always-true facts | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md` (short routers) |
+| Procedures | `.claude/skills/`, `.cursor/rules/`, `.agents/skills/`, `.agent/rules/` |
+| User how-to | `docs/getting-started/`, `docs/guides/` |
+| One hard decision | `docs/architecture/decisions/` |
+| Contributor process | `docs/contributing/` |
+
+README is what PyPI renders: **absolute** URLs only for docs, repo,
+security, contributing, changelog. Relative `docs/*.md` links break on PyPI.
+
+```bash
+pip install -e ".[docs]"
+mkdocs serve
+mkdocs build --strict
+```
+
+`edit_uri` stays `edit/main/docs/` — the published site tracks `main`.
+
+When a procedure changes, update Claude + Cursor + Codex + Antigravity in
+the same PR.

agyloop-0.1.0/.claude/skills/agyloop-domain-model/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: agyloop-domain-model
+description: CapacityState, TurnSignals, completion verdicts, waiting, and the run loop. Consult before editing domain/classify.py, waiting.py, completion.py, or loop.py.
+allowed-tools: Read Grep Glob
+---
+
+# agyloop domain model
+
+`src/agyloop/domain/` is stdlib-only. Frozen dataclasses / closed unions.
+
+## CapacityState (ADR 0003 — five members)
+
+```
+Available | WindowExhausted | TransientThrottle | CreditsExhausted | AuthenticationFailed
+```
+
+`CreditsExhausted` has **no** `resets_at`. Never add one. Credits ≠ window.
+
+`TransientThrottle` is a short waitable (503 / UNAVAILABLE / RetryInfo).
+
+## classify.py
+
+Ladder over `TurnSignals`. Operator cancel (exception type **or**
+`context canceled` / `context cancelled` / `manage_task` in the message)
+is Available **before** the throttle ladder. Do not match a bare
+`canceled`. 404 / withdrawn-model is **not** a sixth state — the adapter
+raises `AgentConfigError`.
+
+## completion.py
+
+Structured `{complete, remaining_work, blocked_on, summary}`. Capacity
+rejection outranks a Done claim.
+
+## loop.py
+
+Pure state machine. No I/O. The runner only performs the Decision.

agyloop-0.1.0/.claude/skills/agyloop-quality-gates/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: agyloop-quality-gates
+description: How to run and fix ruff, mypy --strict, pytest, lint-imports, bandit, pip-audit, mkdocs. Consult when a gate fails.
+allowed-tools: Bash(ruff *) Bash(mypy *) Bash(pytest *) Bash(lint-imports) Bash(bandit *) Bash(pip-audit *) Bash(pre-commit *) Bash(mkdocs *) Read
+---
+
+# agyloop quality gates
+
+```bash
+ruff check src tests
+ruff format --check src tests
+mypy --strict src/agyloop
+pytest
+pytest -m system
+lint-imports
+bandit -q -r src/agyloop
+pip-audit
+mkdocs build --strict
+```
+
+| Gate | Fix |
+|---|---|
+| `ruff check` | `ruff check --fix src tests` |
+| `ruff format` | `ruff format src tests` |
+| `mypy` | Annotate. No bare `Any` without a reason. |
+| `lint-imports` | Move code to the correct layer (architecture skill). |
+| `bandit` | Fix, or `# nosec Bxxx` with *why*. |
+| `pip-audit` | Bump the dependency. |
+| `mkdocs` | Broken link or missing nav entry. |
+
+`pre-commit run --all-files` runs the hook subset. Python 3.12–3.13 in CI.

agyloop-0.1.0/.claude/skills/agyloop-releasing/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: agyloop-releasing
+description: gitflow, Conventional Commits, release-please, Trusted Publishing. Consult before branching, committing, or cutting a release.
+allowed-tools: Bash(git *) Read
+---
+
+# agyloop releasing
+
+```
+main         ← always releasable; release-please target-branch: main
+  ▲ merge commit
+develop      ← default GitHub branch; feature PRs squash here
+  ▲ squash-merge
+feature/*    ← branch from develop, never from main
+```
+
+Never implement on `main`.
+
+Commit: `<type>[scope]: <description>`. Hook `--strict`. Types: feat, fix,
+docs, style, refactor, perf, test, build, ci, chore, revert.
+
+First public tag is **v0.1.0** (already in pyproject / manifest). Later:
+release-please PR on `main`, then `publish-to-pypi.yml` (filename
+load-bearing) with OIDC environments `testpypi` / `pypi` (manual approve).
+
+TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agyloop
+```
+
+See `docs/contributing/release-process.md`.