diff --git a/.aethyme/generated/onboarding.json b/.aethyme/generated/onboarding.json index 8e1660c..b79a94b 100644 --- a/.aethyme/generated/onboarding.json +++ b/.aethyme/generated/onboarding.json @@ -501,9 +501,9 @@ ] }, "freshness": { - "source_digest": "1cc729348eeead667dcc0ac274bc2e9cb91df1799a0a670316fd6e3abacd14f5", + "source_digest": "50b057d5f9ff1851a21d4b1ecac1b9454323cb851d29d19edf383d3c51415671", "source_commit": null, - "source_file_count": 539, + "source_file_count": 540, "generator": "deterministic" }, "telemetry": { diff --git a/.codex/skills/aethyme/aethyme-explore b/.codex/skills/aethyme/aethyme-explore index 1eb66cd..82210a7 100755 --- a/.codex/skills/aethyme/aethyme-explore +++ b/.codex/skills/aethyme/aethyme-explore @@ -2,10 +2,9 @@ # Native Rust thin client for `aethyme explore` — the canonical hot path. # # This wrapper is the convenience entry point for in-repo skill consumers. -# The `aethyme` binary detects an engine daemon and routes to the native -# Rust `aethyme-engine-cli explore` for sub-second warm latency. If no -# daemon is running, it falls back to the Python daemon / subprocess -# transparently. +# The aethyme binary routes to the native engine daemon for sub-second warm +# latency. If no daemon is running, it starts the Rust daemon and retries; +# the first map build can take a minute on large repos. # # Replaced the soft-retired Python `python -m src.cli explore` wrapper # on 2026-05-08 (task #59 — Python explore hard-deleted). diff --git a/.codex/skills/aethyme/references/broker.md b/.codex/skills/aethyme/references/broker.md index 4827b47..d913f79 100644 --- a/.codex/skills/aethyme/references/broker.md +++ b/.codex/skills/aethyme/references/broker.md @@ -54,6 +54,12 @@ blocked. back as a warning naming the holder, with the `note send` command to coordinate. + Orchestration with no path -- a release, a merge chain -- is claimed by + name instead: `aethyme broker advanced ownership claim "release v1.2.0" + --session --reason ""`. `status` shows every claim, + its holder and when the holder last acted; a claim is refused only while + its holder is working, and a quiet holder's claim is taken over. + 3. **Guard broad rewrite commands**. For formatters, code generators, or any command likely to touch many files, run through the broker guard: @@ -103,6 +109,8 @@ blocked. `aethyme broker sync --session ` when it warns, before the pull request reports the conflict: it rebases an unpublished branch or merges the default branch into a published one, and changes nothing if that would conflict. + Sync is local only: it never pushes, so run `aethyme broker push --session + ` afterwards to publish the caught-up branch. `broker start` and `start --reuse` refresh the default branch first, so a new worktree starts from the latest fetched tip. In a repository with `[promote] mode = "verify-only"`, `broker submit` is a pre-flight diff --git a/.codex/skills/aethyme/references/graph-task.md b/.codex/skills/aethyme/references/graph-task.md index 43a5e75..1f7afbe 100644 --- a/.codex/skills/aethyme/references/graph-task.md +++ b/.codex/skills/aethyme/references/graph-task.md @@ -145,38 +145,3 @@ Two ways the graph can quietly disagree with the source you are reading: 2. **The extraction is incomplete.** Unresolved edges and absent callers are expected in the coverage gaps listed above. Absence of evidence in the graph is not evidence of absence in the code. - -## Task Scope And Anchors - -Use task commands when the user asks "where should I work?", "what files are in -scope?", or "what should I inspect next?" and the initial Explore answer is not -enough. - -```bash -aethyme task anchors --repo "$REPO" --task "" --json-output -aethyme task scope --repo "$REPO" --task "" --json-output -aethyme task next --repo "$REPO" --task "" --json-output -``` - -Read reasons and risks before expanding scope. A file with a clear reason beats -a larger list with weak evidence. - -## Context Packs - -Use a pack when you need a compact prompt-ready bundle instead of reading many -files manually. - -```bash -aethyme task context --repo "$REPO" --task "" --json-output -aethyme task pack --repo "$REPO" --task "" --json-output -``` - -Inspect selected files, selected symbols, snippets, and token estimates. If a -pack is too large, narrow the task or anchor before asking for a larger pack. - -## Verification Discipline - -Graph/task output is a candidate selector, not a substitute for reading code. -After a graph or task command, verify with targeted file reads or symbol grep -against the returned paths. Avoid raw `rg --files`, broad `find`, or -repo-wide grep unless Aethyme returned no usable candidates. diff --git a/.codex/skills/repo-onboarding/SKILL.md b/.codex/skills/repo-onboarding/SKILL.md index 76142fb..c4d7c2d 100644 --- a/.codex/skills/repo-onboarding/SKILL.md +++ b/.codex/skills/repo-onboarding/SKILL.md @@ -84,7 +84,7 @@ description: Use when starting work in an unfamiliar repository, when the task a ## Freshness -- Source digest: `1cc729348eeead667dcc0ac274bc2e9cb91df1799a0a670316fd6e3abacd14f5` -- Tracked source files: `539` +- Source digest: `50b057d5f9ff1851a21d4b1ecac1b9454323cb851d29d19edf383d3c51415671` +- Tracked source files: `540` - Overrides applied: `False` - Sections generated: `repo, workspaces, primary_workspace, commands, areas, entrypoints, caution_zones, generated_paths, dangerous_paths, navigation_recipes, summon, freshness` diff --git a/.gitignore b/.gitignore index 55d9e85..215cbd3 100644 --- a/.gitignore +++ b/.gitignore @@ -46,6 +46,7 @@ __pycache__/ # aethyme-broker:begin (managed block — do not edit inside) .aethyme/broker.db* .aethyme/logs/ +.aethyme/locks/ .aethyme/reports/ .aethyme/run/ .aethyme/worktrees/ @@ -56,4 +57,8 @@ __pycache__/ .aethyme/generated/experience-status.json .aethyme/generated/experience-status.md .aethyme/generated/experience-telemetry.jsonl +.aethyme/reviews/ +.aethyme/worktree-sizes.json +.aethyme/gc-journal.json +.aethyme/gc.lock # aethyme-broker:end diff --git a/AGENTS.md b/AGENTS.md index 1a9e03d..939fc34 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,5 @@ - # Agent Instructions - + Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json` (policy) or `.aethyme/overrides/onboarding.json` (orientation), then run @@ -38,6 +37,8 @@ read it first. Leases, gates, advisories and recovery: `references/broker.md`. For "where is X" questions, try `aethyme explore --request "" --format brief` first: one call prints a ranked summary and the top verified source spans. It is a navigation aid, not an answer. Verify the spans before relying on them. +Read code in a session worktree, not the main checkout: it trails +`aethyme/integration` by design, and Explore flags answers from a stale tree. ## Commits @@ -53,4 +54,3 @@ Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex: GitHub coordination, publication, recovery), `policy.md` (commit format, branch and review practice, verifying these files), `graph-task.md` and `dead-code.md`. - diff --git a/CLAUDE.md b/CLAUDE.md index 1a9e03d..939fc34 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,5 @@ - # Agent Instructions - + Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json` (policy) or `.aethyme/overrides/onboarding.json` (orientation), then run @@ -38,6 +37,8 @@ read it first. Leases, gates, advisories and recovery: `references/broker.md`. For "where is X" questions, try `aethyme explore --request "" --format brief` first: one call prints a ranked summary and the top verified source spans. It is a navigation aid, not an answer. Verify the spans before relying on them. +Read code in a session worktree, not the main checkout: it trails +`aethyme/integration` by design, and Explore flags answers from a stale tree. ## Commits @@ -53,4 +54,3 @@ Load the Aethyme skill: `.claude/skills/aethyme/SKILL.md` (Codex: GitHub coordination, publication, recovery), `policy.md` (commit format, branch and review practice, verifying these files), `graph-task.md` and `dead-code.md`. -