Skip to content

chore(aethyme): redeploy 0.8.26 guidance #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
schiste merged 1 commit into from
Oct 9, 2026
Merged

chore(aethyme): redeploy 0.8.26 guidance #36

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions .aethyme/generated/onboarding.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -354,6 +354,11 @@
}
],
"dangerous_paths": [
{
"path": ".aethyme/gates.toml",
"reason": "repository validation policy; changes affect every broker submission",
"provenance": "tracked path classification"
},
{
"path": ".github/workflows",
"reason": "repository automation; changes can affect publication or shared CI",
Expand Down Expand Up @@ -396,9 +401,9 @@
]
},
"freshness": {
"source_digest": "9d585c352194147824bc58c079ba104409fa5271d4cab3e0f4363992fb631475",
"source_digest": "a4e4ab608b581278da8d3cb4fbefea7c0159eb38a2de4323ddfe61f982828bf4",
"source_commit": null,
"source_file_count": 131,
"source_file_count": 133,
"generator": "deterministic"
},
"telemetry": {
Expand All @@ -423,7 +428,7 @@
"entrypoints": 4,
"caution_zones": 0,
"generated_paths": 1,
"dangerous_paths": 1,
"dangerous_paths": 2,
"navigation_recipes": 3,
"notes": 0
},
Expand Down
23 changes: 23 additions & 0 deletions .claude/skills/aethyme/references/broker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,6 +170,29 @@ blocked.
aethyme broker advanced ship execute --entry <promoted-entry-id> --confirm <full-publication-sha>
```

By default, the selected entry is a prefix boundary: every earlier
promoted-but-unpublished entry ships with it. In promote-mode repositories,
`--only` can publish one independent entry without changing that default:

```bash
aethyme broker advanced ship plan --entry <promoted-entry-id> --only
aethyme broker advanced ship execute --entry <promoted-entry-id> --only --confirm <full-publication-sha> --plan <sha256>
```

The plan refuses when an earlier unshipped entry is required by ancestry,
changed-path overlap, or a declared `Depends-On` trailer. Otherwise it gates
the exact tree made from the remote default branch plus only the selected
entry. Planning does not move refs, though it may record gate results in the
local cache; execution requires the reviewed plan digest. After publication,
the broker rebases the remaining pending entries onto the published commit
in integration and re-runs gates only for replayed trees that changed.
Review that reconciliation report. If it refuses or cannot apply safely,
use `aethyme broker advanced integration reconcile --upstream <published-sha> --dry-run`
and follow its reviewed apply plan. `broker main reconcile plan/apply` remains
the separate operation for advancing the local default checkout from
integration; independent publication does not mark the other queue entries
shipped or change their promotion order.

Prefer this reviewed broker ship workflow over a raw push. Never infer
publication authority from permission to edit, submit, or promote.
Without publication authority, stop after submit and report the promoted
Expand Down
5 changes: 3 additions & 2 deletions .claude/skills/repo-onboarding/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,11 +73,12 @@ description: Use when starting work in an unfamiliar repository, when the task a
## Generated and Dangerous Paths

- Generated/vendor `.aethyme/generated`: tracked generated or vendored surface; verify ownership before editing
- Sensitive `.aethyme/gates.toml`: repository validation policy; changes affect every broker submission
- Sensitive `.github/workflows`: repository automation; changes can affect publication or shared CI

## Freshness

- Source digest: `9d585c352194147824bc58c079ba104409fa5271d4cab3e0f4363992fb631475`
- Tracked source files: `131`
- Source digest: `a4e4ab608b581278da8d3cb4fbefea7c0159eb38a2de4323ddfe61f982828bf4`
- Tracked source files: `133`
- Overrides applied: `False`
- Sections generated: `repo, workspaces, primary_workspace, commands, areas, entrypoints, caution_zones, generated_paths, dangerous_paths, navigation_recipes, summon, freshness`
23 changes: 23 additions & 0 deletions .codex/skills/aethyme/references/broker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,6 +170,29 @@ blocked.
aethyme broker advanced ship execute --entry <promoted-entry-id> --confirm <full-publication-sha>
```

By default, the selected entry is a prefix boundary: every earlier
promoted-but-unpublished entry ships with it. In promote-mode repositories,
`--only` can publish one independent entry without changing that default:

```bash
aethyme broker advanced ship plan --entry <promoted-entry-id> --only
aethyme broker advanced ship execute --entry <promoted-entry-id> --only --confirm <full-publication-sha> --plan <sha256>
```

The plan refuses when an earlier unshipped entry is required by ancestry,
changed-path overlap, or a declared `Depends-On` trailer. Otherwise it gates
the exact tree made from the remote default branch plus only the selected
entry. Planning does not move refs, though it may record gate results in the
local cache; execution requires the reviewed plan digest. After publication,
the broker rebases the remaining pending entries onto the published commit
in integration and re-runs gates only for replayed trees that changed.
Review that reconciliation report. If it refuses or cannot apply safely,
use `aethyme broker advanced integration reconcile --upstream <published-sha> --dry-run`
and follow its reviewed apply plan. `broker main reconcile plan/apply` remains
the separate operation for advancing the local default checkout from
integration; independent publication does not mark the other queue entries
shipped or change their promotion order.

Prefer this reviewed broker ship workflow over a raw push. Never infer
publication authority from permission to edit, submit, or promote.
Without publication authority, stop after submit and report the promoted
Expand Down
5 changes: 3 additions & 2 deletions .codex/skills/repo-onboarding/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,11 +73,12 @@ description: Use when starting work in an unfamiliar repository, when the task a
## Generated and Dangerous Paths

- Generated/vendor `.aethyme/generated`: tracked generated or vendored surface; verify ownership before editing
- Sensitive `.aethyme/gates.toml`: repository validation policy; changes affect every broker submission
- Sensitive `.github/workflows`: repository automation; changes can affect publication or shared CI

## Freshness

- Source digest: `9d585c352194147824bc58c079ba104409fa5271d4cab3e0f4363992fb631475`
- Tracked source files: `131`
- Source digest: `a4e4ab608b581278da8d3cb4fbefea7c0159eb38a2de4323ddfe61f982828bf4`
- Tracked source files: `133`
- Overrides applied: `False`
- Sections generated: `repo, workspaces, primary_workspace, commands, areas, entrypoints, caution_zones, generated_paths, dangerous_paths, navigation_recipes, summon, freshness`
4 changes: 1 addition & 3 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<!-- AETHYME:BEGIN generated -->
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.24; policy-sha256=8b2a6a86b61069d29569675fe894b5821ae6c824ddb838cfc91d4bda07cf6461 -->
<!-- AETHYME-GENERATED: version=0.8.26; policy-sha256=8b2a6a86b61069d29569675fe894b5821ae6c824ddb838cfc91d4bda07cf6461 -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
Expand Down Expand Up @@ -55,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`.
<!-- AETHYME:END generated -->
4 changes: 1 addition & 3 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<!-- AETHYME:BEGIN generated -->
# Agent Instructions
<!-- AETHYME-GENERATED: version=0.8.24; policy-sha256=8b2a6a86b61069d29569675fe894b5821ae6c824ddb838cfc91d4bda07cf6461 -->
<!-- AETHYME-GENERATED: version=0.8.26; policy-sha256=8b2a6a86b61069d29569675fe894b5821ae6c824ddb838cfc91d4bda07cf6461 -->

Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json`
(policy) or `.aethyme/overrides/onboarding.json` (orientation), then run
Expand Down Expand Up @@ -55,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`.
<!-- AETHYME:END generated -->
Loading