From 49c6d61ad1239fb11e6c053c608a350bd48fd74e Mon Sep 17 00:00:00 2001 From: Christophe Henner Date: Thu, 8 Oct 2026 06:57:17 +0200 Subject: [PATCH] chore(aethyme): upgrade repository deployment to schema 1 Apply the repository-deployment-v1 migration with replace resolutions for the Aethyme-generated AGENTS.md and CLAUDE.md, add the generated gate policy, and track the upgrade-managed .aethyme files. Co-Authored-By: Claude Opus 5.5 (1M context) --- .aethyme/gates.toml | 14 + .aethyme/generated/act-starter.json | 98 +++++++ .aethyme/generated/onboarding.json | 434 ++++++++++++++++++++++++++++ .aethyme/repository.json | 6 + .gitignore | 3 + AGENTS.md | 4 +- CLAUDE.md | 4 +- 7 files changed, 561 insertions(+), 2 deletions(-) create mode 100644 .aethyme/gates.toml create mode 100644 .aethyme/generated/act-starter.json create mode 100644 .aethyme/generated/onboarding.json create mode 100644 .aethyme/repository.json diff --git a/.aethyme/gates.toml b/.aethyme/gates.toml new file mode 100644 index 0000000..6f4ddba --- /dev/null +++ b/.aethyme/gates.toml @@ -0,0 +1,14 @@ +# Draft generated by `aethyme init` from this repo's manifests. +# REVIEW EVERY GATE: commands, triggers, and cost tiers are guesses. +# Rules: commands run with cwd = the worktree under test (bare — +# no venv/node_modules); gate outputs must be gitignored. +# Set this to true only after reviewing every command and trigger. +reviewed = false +schema = 1 + +[[gate]] +name = "cargo-test" +command = "cargo test --workspace --quiet --manifest-path Cargo.toml" +cost = 3 +timeout_seconds = 1800 +triggers = ["**/*.rs", "**/Cargo.toml"] diff --git a/.aethyme/generated/act-starter.json b/.aethyme/generated/act-starter.json new file mode 100644 index 0000000..e0821ad --- /dev/null +++ b/.aethyme/generated/act-starter.json @@ -0,0 +1,98 @@ +{ + "schema_version": "aethyme-act-starter-v1", + "repo": { + "name": "map-generator", + "kind": "repository" + }, + "recommended_mode": "repo-act", + "starter_checklists": { + "debugging": [ + "Load repo-onboarding first if the repository or area is unfamiliar.", + "Run Aethyme Explore on the user task before broad manual search.", + "Verify answer candidates before concluding when trust_policy is not answer-safe.", + "Identify the nearest fast test or validation command before editing.", + "Inspect caution zones before changing generated or vendored areas." + ], + "change_validation": [ + "Run the fastest relevant test command first.", + "Check likely entrypoints and impacted callers before finishing.", + "Re-run lint/build only after the focused validation passes.", + "Document any override-based maintainer note that affected the change plan." + ] + }, + "commands": { + "fast_test": "cargo test --workspace", + "full_test": null, + "lint": null, + "build": "cargo build --workspace", + "dev": "cargo run" + }, + "entrypoints": [ + { + "path": "Procfile:web", + "kind": "process", + "role": "app", + "reason": "Procfile process entrypoint", + "confidence": "high", + "relevance": "supporting" + }, + { + "path": "crates/mapgen-cli/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen", + "relevance": "supporting" + }, + { + "path": "crates/mapgen-server/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen-server", + "relevance": "supporting" + } + ], + "primary_entrypoints": { + "app": { + "path": "Procfile:web", + "kind": "process", + "role": "app", + "reason": "Procfile process entrypoint", + "confidence": "high", + "relevance": "supporting" + }, + "cli": { + "path": "crates/mapgen-cli/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen", + "relevance": "supporting" + }, + "test": { + "path": "tests", + "kind": "directory", + "role": "test", + "reason": "conventional test root", + "confidence": "medium", + "relevance": "supporting" + } + }, + "caution_zones": [], + "telemetry": { + "derived_from": ".aethyme/generated/onboarding.json", + "entrypoint_count": 4, + "primary_entrypoint_count": 3, + "caution_zone_count": 0 + } +} diff --git a/.aethyme/generated/onboarding.json b/.aethyme/generated/onboarding.json new file mode 100644 index 0000000..f8ea3a6 --- /dev/null +++ b/.aethyme/generated/onboarding.json @@ -0,0 +1,434 @@ +{ + "schema_version": "aethyme-onboarding-v2", + "repo": { + "name": "map-generator", + "root": ".", + "kind": "repository", + "languages": [ + "rust", + "typescript" + ], + "primary_language": "rust", + "package_manager": "cargo", + "manifests": [ + "Cargo.toml", + "Procfile", + "crates/mapgen-cli/Cargo.toml", + "crates/mapgen-core/Cargo.toml", + "crates/mapgen-data/Cargo.toml", + "crates/mapgen-server/Cargo.toml", + "crates/mapgen-spec/Cargo.toml", + "crates/mapgen-wasm/Cargo.toml", + "crates/mapgen-wasm/package.json" + ] + }, + "workspaces": [ + { + "root": ".", + "manifest": { + "path": "Cargo.toml", + "kind": "cargo" + }, + "package_manager": "cargo", + "languages": [ + "rust" + ], + "members": [ + "crates/mapgen-cli", + "crates/mapgen-core", + "crates/mapgen-data", + "crates/mapgen-server", + "crates/mapgen-spec", + "crates/mapgen-wasm" + ], + "lockfiles": [ + "Cargo.lock" + ], + "candidate_commands": [ + { + "kind": "fast_test", + "command": "cargo test --workspace", + "source": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "build", + "command": "cargo build --workspace", + "source": "Cargo.toml", + "confidence": "high" + } + ], + "evidence": [ + { + "kind": "tracked_manifest", + "detail": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "root_manifest", + "detail": "manifest is at repository root", + "confidence": "high" + }, + { + "kind": "workspace_members", + "detail": "6 tracked member roots", + "confidence": "high" + } + ], + "confidence": "high", + "primary": true, + "ranking": { + "root_manifest": true, + "declares_workspace": true, + "member_count": 6, + "ci_mentions": 0, + "executable_entrypoints": 2, + "source_files": 59 + } + }, + { + "root": "crates/mapgen-wasm", + "manifest": { + "path": "crates/mapgen-wasm/package.json", + "kind": "node" + }, + "package_manager": "npm", + "languages": [ + "typescript" + ], + "members": [], + "lockfiles": [ + "crates/mapgen-wasm/package-lock.json" + ], + "candidate_commands": [ + { + "kind": "build", + "command": "npm --prefix crates/mapgen-wasm run build", + "source": "crates/mapgen-wasm/package.json", + "confidence": "high" + } + ], + "evidence": [ + { + "kind": "tracked_manifest", + "detail": "crates/mapgen-wasm/package.json", + "confidence": "high" + }, + { + "kind": "ci_usage", + "detail": "workspace root mentioned 4 time(s) in CI", + "confidence": "medium" + } + ], + "confidence": "high", + "primary": false, + "ranking": { + "root_manifest": false, + "declares_workspace": false, + "member_count": 0, + "ci_mentions": 4, + "executable_entrypoints": 0, + "source_files": 4 + } + } + ], + "primary_workspace": { + "root": ".", + "manifest": { + "path": "Cargo.toml", + "kind": "cargo" + }, + "package_manager": "cargo", + "languages": [ + "rust" + ], + "members": [ + "crates/mapgen-cli", + "crates/mapgen-core", + "crates/mapgen-data", + "crates/mapgen-server", + "crates/mapgen-spec", + "crates/mapgen-wasm" + ], + "lockfiles": [ + "Cargo.lock" + ], + "candidate_commands": [ + { + "kind": "fast_test", + "command": "cargo test --workspace", + "source": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "build", + "command": "cargo build --workspace", + "source": "Cargo.toml", + "confidence": "high" + } + ], + "evidence": [ + { + "kind": "tracked_manifest", + "detail": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "root_manifest", + "detail": "manifest is at repository root", + "confidence": "high" + }, + { + "kind": "workspace_members", + "detail": "6 tracked member roots", + "confidence": "high" + } + ], + "confidence": "high", + "primary": true, + "ranking": { + "root_manifest": true, + "declares_workspace": true, + "member_count": 6, + "ci_mentions": 0, + "executable_entrypoints": 2, + "source_files": 59 + } + }, + "commands": [ + { + "kind": "dev", + "command": "cargo run", + "source": "Cargo.toml", + "confidence": "medium" + }, + { + "kind": "dev", + "command": "./target/release/mapgen-server", + "source": "Procfile:web", + "confidence": "medium" + }, + { + "kind": "fast_test", + "command": "cargo test", + "source": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "fast_test", + "command": "cargo test --workspace", + "source": "Cargo.toml", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace manifest" + }, + { + "kind": "build", + "command": "cargo build", + "source": "Cargo.toml", + "confidence": "high" + }, + { + "kind": "build", + "command": "cargo build --workspace", + "source": "Cargo.toml", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace manifest" + }, + { + "kind": "build", + "command": "npm --prefix crates/mapgen-wasm run build", + "source": "crates/mapgen-wasm/package.json", + "confidence": "high", + "workspace_root": "crates/mapgen-wasm", + "provenance": "derived from tracked workspace manifest" + } + ], + "primary_commands": { + "dev": "cargo run", + "fast_test": "cargo test --workspace", + "build": "cargo build --workspace" + }, + "areas": [ + { + "path": ".github", + "role": "automation", + "reason": "automation and CI configuration", + "confidence": "high" + }, + { + "path": "docs", + "role": "docs", + "reason": "documentation area", + "confidence": "high" + }, + { + "path": "scripts", + "role": "tooling", + "reason": "developer tooling or scripts", + "confidence": "high" + }, + { + "path": "tests", + "role": "tests", + "reason": "conventional test directory", + "confidence": "high" + } + ], + "entrypoints": [ + { + "path": "Procfile:web", + "kind": "process", + "role": "app", + "reason": "Procfile process entrypoint", + "confidence": "high", + "relevance": "supporting" + }, + { + "path": "crates/mapgen-cli/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen", + "relevance": "supporting" + }, + { + "path": "crates/mapgen-server/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen-server", + "relevance": "supporting" + }, + { + "path": "tests", + "kind": "directory", + "role": "test", + "reason": "conventional test root", + "confidence": "medium", + "relevance": "supporting" + } + ], + "primary_entrypoints": { + "app": { + "path": "Procfile:web", + "kind": "process", + "role": "app", + "reason": "Procfile process entrypoint", + "confidence": "high", + "relevance": "supporting" + }, + "cli": { + "path": "crates/mapgen-cli/src/main.rs", + "kind": "file", + "role": "cli", + "reason": "tracked Rust binary entrypoint in `.`", + "confidence": "high", + "workspace_root": ".", + "provenance": "derived from tracked workspace source", + "executable_name": "mapgen", + "relevance": "supporting" + }, + "test": { + "path": "tests", + "kind": "directory", + "role": "test", + "reason": "conventional test root", + "confidence": "medium", + "relevance": "supporting" + } + }, + "caution_zones": [], + "generated_paths": [ + { + "path": ".aethyme/generated", + "reason": "tracked generated or vendored surface; verify ownership before editing", + "provenance": "tracked path classification" + } + ], + "dangerous_paths": [ + { + "path": ".github/workflows", + "reason": "repository automation; changes can affect publication or shared CI", + "provenance": "tracked path classification" + } + ], + "navigation_recipes": [ + { + "purpose": "Broad repository orientation for a user request", + "command": "aethyme explore --repo \"$PWD\" --request \"\" --format answer-json" + }, + { + "purpose": "Quick deterministic repo summary", + "command": "aethyme repo inspect \"$PWD\" --mode brief --json-output" + }, + { + "purpose": "Trace likely impact before editing", + "command": "aethyme graph callers \"$PWD\" \"\" --json-output" + } + ], + "summon": { + "description": "Use when starting work in an unfamiliar repository, when the task asks for repo overview, setup, architecture, entrypoints, test commands, or where to begin. Skip for narrow file-scoped edits once the relevant paths are already known.", + "recommended_when": [ + "first task in repo", + "repo overview", + "setup or run instructions", + "architecture or entrypoints", + "where should I start", + "broad debugging or feature-localization request" + ], + "skip_when": [ + "known file-scoped edit", + "follow-up inside already identified area", + "task already localized to concrete files" + ], + "task_signals": [ + "unfamiliar repository", + "broad task with no path named", + "user asks how the repo is organized" + ] + }, + "freshness": { + "source_digest": "9d585c352194147824bc58c079ba104409fa5271d4cab3e0f4363992fb631475", + "source_commit": null, + "source_file_count": 131, + "generator": "deterministic" + }, + "telemetry": { + "sections": [ + "repo", + "workspaces", + "primary_workspace", + "commands", + "areas", + "entrypoints", + "caution_zones", + "generated_paths", + "dangerous_paths", + "navigation_recipes", + "summon", + "freshness" + ], + "counts": { + "workspaces": 2, + "commands": 7, + "areas": 4, + "entrypoints": 4, + "caution_zones": 0, + "generated_paths": 1, + "dangerous_paths": 1, + "navigation_recipes": 3, + "notes": 0 + }, + "overrides_applied": false, + "override_source": null, + "override_invalid": false + } +} diff --git a/.aethyme/repository.json b/.aethyme/repository.json new file mode 100644 index 0000000..e201f57 --- /dev/null +++ b/.aethyme/repository.json @@ -0,0 +1,6 @@ +{ + "schema_version": 1, + "applied_migrations": [ + "repository-deployment-v1" + ] +} diff --git a/.gitignore b/.gitignore index 16fa773..bcd95b7 100644 --- a/.gitignore +++ b/.gitignore @@ -9,6 +9,9 @@ # local tooling .aethyme/* !.aethyme/config.toml +!.aethyme/gates.toml +!.aethyme/repository.json +!.aethyme/generated/ .chau7/ .playwright-mcp/ diff --git a/AGENTS.md b/AGENTS.md index 1e41f91..0de1992 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,6 @@ + # Agent Instructions - + Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json` (policy) or `.aethyme/overrides/onboarding.json` (orientation), then run @@ -54,3 +55,4 @@ 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 1e41f91..0de1992 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,5 +1,6 @@ + # Agent Instructions - + Generated by Aethyme; do not edit. Customize `.aethyme/overrides/agents.json` (policy) or `.aethyme/overrides/onboarding.json` (orientation), then run @@ -54,3 +55,4 @@ 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`. +