@ethlete/agent-rules 0.1.0-next.0 → 0.1.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @ethlete/agent-rules
 
+## 0.1.0-next.1
+
+### Minor Changes
+
+- [#3042](https://github.com/ethlete-io/ethdk/pull/3042) [`28a58eb`](https://github.com/ethlete-io/ethdk/commit/28a58ebc56420b7e067d8c56108b39601d7b367e) Thanks [@github-actions](https://github.com/apps/github-actions)! - - Skills now compile to the cross-tool `.agents/skills/ethlete-*/SKILL.md` format, discovered natively by Codex, Cursor and Copilot; the `.agents/ethlete/` pointer tree is pruned on sync.
+  - New `ethlete-agents migrate` converts a repo to the `AGENTS.md`-canonical layout: `CLAUDE.md` becomes an `@AGENTS.md` import and hand-written skills move to `.agents/skills` with symlinks.
+  - New opt-in `hooks` config: `context-warning` warns (and instructs Claude) before the context crosses the 200k long-context pricing boundary, recommending `/handoff`.
+  - A gitignored `ethlete-agents.config.local.json` (`"disableHooks": true` or a list of hook names) disables generated hooks per machine at runtime — committed files never change, and `sync`/`check` warn about unsupported keys or unknown hook names in it.
+
 ## 0.1.0-next.0
 
 ### Minor Changes

package/README.md

@@ -23,17 +23,44 @@ npx ethlete-agents check  # exits non-zero when the generated files are stale
 
 ## What gets written
 
-|                     | Claude Code                         | Cursor                                              | Copilot                                                | Codex                          |
-| ------------------- | ----------------------------------- | --------------------------------------------------- | ------------------------------------------------------ | ------------------------------ |
-| Always-loaded rules | `.claude/rules/ethlete/*.md`        | `.cursor/rules/ethlete-*.mdc` (`alwaysApply: true`) | inlined into `.github/copilot-instructions.md`         | inlined into `AGENTS.md`       |
-| On-demand guides    | `.claude/skills/ethlete-*/SKILL.md` | `.cursor/rules/ethlete-*.mdc`                       | `.github/instructions/*.instructions.md`, or a pointer | a pointer table in `AGENTS.md` |
-
-`AGENTS.md` supports neither frontmatter nor includes, so anything a target cannot
-express on-demand falls back to plain markdown under `.agents/ethlete/` plus a pointer
-from the always-loaded file. Marker-block files (`AGENTS.md`,
-`.github/copilot-instructions.md`) are only rewritten between
-`<!-- ethlete:agent-rules:start -->` and `:end` - everything you wrote around them
-survives.
+Skills are compiled once into `.agents/skills/ethlete-*/SKILL.md` - the cross-tool
+[Agent Skills](https://agentskills.io) format that Codex, Cursor, Copilot and VS Code
+discover natively (each skill's body loads on demand from its `description`
+frontmatter). Claude Code only scans `.claude/skills/`, so the claude target writes its
+own copies there. Rules are always-loaded and go into each tool's native mechanism:
+
+|                     | Claude Code                         | Cursor                                              | Copilot                                        | Codex                               |
+| ------------------- | ----------------------------------- | --------------------------------------------------- | ---------------------------------------------- | ----------------------------------- |
+| Always-loaded rules | `.claude/rules/ethlete/*.md`        | `.cursor/rules/ethlete-*.mdc` (`alwaysApply: true`) | inlined into `.github/copilot-instructions.md` | inlined into `AGENTS.md`            |
+| On-demand skills    | `.claude/skills/ethlete-*/SKILL.md` | `.agents/skills/ethlete-*/SKILL.md`                 | `.agents/skills/ethlete-*/SKILL.md`            | `.agents/skills/ethlete-*/SKILL.md` |
+
+Marker-block files (`AGENTS.md`, `.github/copilot-instructions.md`) are only rewritten
+between `<!-- ethlete:agent-rules:start -->` and `:end` - everything you wrote around
+them survives.
+
+## Migrating a repo to the AGENTS.md layout
+
+`AGENTS.md` is the cross-tool standard, and Claude Code officially supports reading it
+through a one-line `CLAUDE.md` import. To restructure a whole repo around that:
+
+```bash
+npx ethlete-agents migrate --dry-run   # prints the plan
+npx ethlete-agents migrate
+```
+
+- `CLAUDE.md` content moves to the top of `AGENTS.md`; `CLAUDE.md` becomes `@AGENTS.md`.
+- Hand-written `.claude/skills/<name>` directories move to `.agents/skills/<name>`, with
+  a symlink left behind so Claude Code still finds them. (Symlinks need Developer Mode
+  on Windows checkouts.)
+- A short layout note is added to `AGENTS.md` so agents know the symlinked skills are
+  the same files, not duplicates - skipped if your `AGENTS.md` already explains it.
+- The config gains the `codex` target and `claudeMdImportsAgentsMd: true`, which stops
+  the claude target from writing `.claude/rules/ethlete/` - the rules already reach
+  Claude through the `AGENTS.md` marker block, and a second copy would load twice.
+- A `sync` runs, which also prunes output from older layouts (`.agents/ethlete/`,
+  `.github/instructions/ethlete-*`).
+
+The command is idempotent - every step detects the migrated state and skips itself.
 
 Every generated file carries a `DO NOT EDIT` banner. Files that disappear from the
 package are pruned on the next `sync`; nothing outside an `ethlete` directory or an
@@ -47,7 +74,6 @@ Prettier rewrites them and `check` then reports drift on every run:
 /.claude
 /.agents
 /.cursor/rules/ethlete-*
-/.github/instructions/ethlete-*
 ```
 
 ## Configuration
@@ -69,8 +95,9 @@ Prettier rewrites them and `check` then reports drift on every run:
 }
 ```
 
-- **`targets`** - `"auto"` (default) emits for every agent whose directory already
-  exists, or list a subset of `claude`, `codex`, `cursor`, `copilot`.
+- **`targets`** - `"auto"` (default) always emits `codex` (`AGENTS.md` plus
+  `.agents/skills/` is the cross-tool baseline) and adds `claude`, `cursor` or `copilot`
+  when their directory exists; or list an explicit subset.
 - **`profile`** - `"consumer"` (default) emits `scope: consumer` and `scope: both`
   content. `"sdk"` emits only `both`; the SDK repo uses it so its own hand-written,
   authoring-side guides are not overwritten by the consumer-side versions.
@@ -78,10 +105,55 @@ Prettier rewrites them and `check` then reports drift on every run:
   `content/defaults.json`; a guide whose variable has no default and no value is
   skipped with a warning rather than emitted with a dangling placeholder.
 - **`exclude`** - content names to skip entirely.
+- **`claudeMdImportsAgentsMd`** - set (usually by `migrate`) when `CLAUDE.md` is an
+  `@AGENTS.md` import or symlink; the claude target then skips `.claude/rules/ethlete/`
+  so the rules don't load twice. `sync` warns when the flag is set but the import is
+  missing.
 
 Content that declares `requires` is only emitted when those packages are installed, so
 a repo without `@ethlete/query` never sees the query guide.
 
+## Hooks (opt-in)
+
+Claude Code hooks run commands on the developer's machine, so none are emitted by
+default - opt in per hook in the config:
+
+```json
+{
+  "hooks": ["context-warning"]
+}
+```
+
+`sync` writes the script to `.claude/hooks/ethlete/` and registers it in
+`.claude/settings.json` (your own entries are left untouched); removing the name from
+`hooks` unregisters and deletes it again.
+
+Available hooks:
+
+- **`context-warning`** - warns once per tier (and instructs Claude) when the session
+  context crosses 70% / 85% of the token budget, recommending `/handoff`. The budget is
+  capped at the 200k long-context pricing boundary: on 1M-window models every request
+  past 200k input tokens bills the whole context at a premium rate, so the warnings
+  fire at ~140k/~170k instead of deep into the expensive range.
+
+### Disabling hooks per machine
+
+A gitignored `ethlete-agents.config.local.json` at the repo root turns generated hooks
+off for one developer without touching any committed file:
+
+```json
+{
+  "disableHooks": true
+}
+```
+
+`true` disables every generated hook; an array (`["context-warning"]`) just the named
+ones. The hook scripts read this file at runtime, so toggling takes effect on the next
+prompt - no `sync` needed - and the generated files stay identical on every machine and
+in CI. That is also why the local file supports nothing else: sync output must never
+depend on it, and `sync`/`check` warn if it contains other keys. Add the filename to
+your repo's `.gitignore`.
+
 ## Authoring content
 
 `content/rules/<name>.md` for short, always-loaded rules; `content/skills/<name>/SKILL.md`
@@ -94,7 +166,7 @@ description: Read before writing any color, background or border CSS.
 kind: skill # rule | skill
 scope: consumer # consumer | sdk | both
 requires: ['@ethlete/core'] # optional
-paths: ['**/*.css'] # optional; becomes Claude `paths`, Cursor `globs`, Copilot `applyTo`
+paths: ['**/*.css'] # optional; becomes Claude `paths` and Cursor `globs` on rules
 vars: [docsBaseUrl] # optional
 ---
 ```

package/content/hooks/context-warning.py

@@ -0,0 +1,215 @@
+#!/usr/bin/env python3
+"""UserPromptSubmit hook: warn when the context window is getting large.
+
+Reads the hook input JSON from stdin, estimates the current context size from
+the last main-chain assistant message in the session transcript, and emits a
+warning (visible to both the user and Claude) when it crosses a threshold.
+Recommends the /handoff skill so work can continue in a fresh session.
+
+The thresholds are fractions of a token budget, and the budget is capped at the
+200k long-context pricing boundary: on models with a larger window, every
+request past that point bills the entire context at the premium rate, which
+costs far more than handing off into a fresh session ever would.
+
+Warns once per tier per session (state kept in a temp file); re-arms itself
+if the context shrinks again (e.g. after /compact).
+
+Can be disabled per machine via a gitignored ethlete-agents.config.local.json
+at the repo root: {"disableHooks": true} or {"disableHooks": ["context-warning"]}.
+
+Fail-safe: any error exits 0 with no output — the hook must never block a prompt.
+"""
+
+import json
+import os
+import sys
+import tempfile
+
+HOOK_NAME = "context-warning"
+LOCAL_CONFIG_FILE = "ethlete-agents.config.local.json"
+
+# Warn / critical fire at these fractions of the token budget.
+WARN_FRACTION = 0.70
+CRITICAL_FRACTION = 0.85
+
+# On models with a window larger than this, tokens beyond it bill the whole
+# context at the long-context premium rate — so the budget never exceeds it.
+PREMIUM_BOUNDARY = 200_000
+
+# Context window (tokens) per model, matched by substring against the model id
+# from the transcript — first match wins. Edit these as model windows change;
+# anything unmatched falls back to DEFAULT_WINDOW.
+CONTEXT_WINDOWS = (
+    ("opus-5", 1_000_000),
+    ("opus-4-8", 1_000_000),
+    ("sonnet-4-5", 1_000_000),
+    ("sonnet-5", 1_000_000),
+    ("fable-5", 1_000_000),
+    # Generic fallbacks — keep these last: the first substring match wins, so a bare
+    # "opus"/"sonnet" entry placed above would shadow every versioned entry below it.
+    ("opus", 200_000),
+    ("sonnet", 200_000),
+    ("haiku", 200_000),
+)
+DEFAULT_WINDOW = 200_000
+
+
+def disabled_locally():
+    """True when the local config disables this hook (or all hooks) on this machine."""
+    root = os.environ.get("CLAUDE_PROJECT_DIR")
+    if not root:
+        return False
+    try:
+        with open(os.path.join(root, LOCAL_CONFIG_FILE), encoding="utf-8") as f:
+            disabled = json.load(f).get("disableHooks")
+    except (OSError, ValueError, AttributeError):
+        return False
+    return disabled is True or (isinstance(disabled, list) and HOOK_NAME in disabled)
+
+
+def window_for(model):
+    """Context window for a model id, by first substring match; DEFAULT_WINDOW otherwise."""
+    if model:
+        for needle, window in CONTEXT_WINDOWS:
+            if needle in model:
+                return window
+    return DEFAULT_WINDOW
+
+
+def context_state(transcript_path):
+    """(tokens, model) from the last main-chain assistant message.
+
+    tokens ≈ its total input tokens (fresh + cache read + cache creation).
+    """
+    last_usage = None
+    last_model = None
+    with open(transcript_path, encoding="utf-8") as f:
+        for line in f:
+            try:
+                obj = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            if obj.get("type") != "assistant" or obj.get("isSidechain"):
+                continue
+            message = obj.get("message") or {}
+            usage = message.get("usage")
+            if usage:
+                last_usage = usage
+                last_model = message.get("model") or last_model
+    if not last_usage:
+        return 0, last_model
+    tokens = (
+        last_usage.get("input_tokens", 0)
+        + last_usage.get("cache_read_input_tokens", 0)
+        + last_usage.get("cache_creation_input_tokens", 0)
+    )
+    return tokens, last_model
+
+
+def messages(tier, tokens, budget, priced):
+    """(systemMessage, additionalContext) for a tier.
+
+    priced: the budget is the pricing boundary, not the window — the reason to
+    hand off is cost, not an imminent auto-compact.
+    """
+    k = f"~{tokens // 1000}k"
+    pct = round(tokens / budget * 100)
+    budget_k = f"{budget // 1000}k"
+    if tier == 2 and priced:
+        return (
+            f"🔴 Context is at {k} tokens — about to cross the {budget_k} long-context "
+            f"pricing boundary, after which every request bills the whole context at the "
+            f"premium rate. Run /handoff now and continue in a fresh session.",
+            f"[context-warning hook] The context is at {k} tokens — {pct}% of the "
+            f"{budget_k} long-context pricing boundary. Past it every request is billed at "
+            "the premium rate. Finish only the immediate step, then recommend the user run "
+            "/handoff to save state and start a fresh session. Do not start new sub-tasks.",
+        )
+    if tier == 2:
+        return (
+            f"🔴 Context is at {k} tokens ({pct}% of the {budget_k} window) — "
+            f"auto-compact is imminent. Run /handoff now and continue in a fresh session.",
+            f"[context-warning hook] The context window is at {k} tokens — {pct}% of "
+            f"this model's {budget_k} window (critical, ≥{int(CRITICAL_FRACTION * 100)}%). "
+            "Finish only the immediate step, then recommend the user run /handoff to "
+            "save state and start a fresh session. Do not start new sub-tasks.",
+        )
+    if priced:
+        return (
+            f"🟡 Context is at {k} tokens, approaching the {budget_k} long-context "
+            f"pricing boundary. At the next natural stopping point, consider /handoff "
+            f"to continue in a fresh session.",
+            f"[context-warning hook] The context is at {k} tokens — {pct}% of the "
+            f"{budget_k} long-context pricing boundary, past which every request is "
+            "billed at the premium rate. When the current task reaches a natural "
+            "stopping point, suggest the user run /handoff to save state and start a "
+            "fresh session. Keep working normally until then.",
+        )
+    return (
+        f"🟡 Context is at {k} tokens ({pct}% of the {budget_k} window). At the next "
+        f"natural stopping point, consider /handoff to continue in a fresh session.",
+        f"[context-warning hook] The context window is at {k} tokens — {pct}% of "
+        f"this model's {budget_k} window (≥{int(WARN_FRACTION * 100)}%). When the "
+        "current task reaches a natural stopping point, suggest the user run "
+        "/handoff to save state and start a fresh session. Keep working normally until then.",
+    )
+
+
+def main():
+    if disabled_locally():
+        return
+    data = json.load(sys.stdin)
+    transcript_path = data.get("transcript_path")
+    session_id = data.get("session_id", "unknown")
+    if not transcript_path or not os.path.isfile(transcript_path):
+        return
+
+    tokens, model = context_state(transcript_path)
+    window = window_for(model)
+    budget = min(window, PREMIUM_BOUNDARY)
+    warn_tokens = int(budget * WARN_FRACTION)
+    critical_tokens = int(budget * CRITICAL_FRACTION)
+    tier = 2 if tokens >= critical_tokens else 1 if tokens >= warn_tokens else 0
+
+    state_file = os.path.join(
+        tempfile.gettempdir(), f"claude-context-warning-{session_id}"
+    )
+    prev_tier = 0
+    try:
+        with open(state_file, encoding="utf-8") as f:
+            prev_tier = int(f.read().strip() or 0)
+    except (OSError, ValueError):
+        pass
+
+    if tier != prev_tier:
+        try:
+            with open(state_file, "w", encoding="utf-8") as f:
+                f.write(str(tier))
+        except OSError:
+            pass
+
+    if tier <= prev_tier:
+        return  # already warned at this tier (or context shrank — state re-armed above)
+
+    system_message, additional_context = messages(tier, tokens, budget, budget < window)
+
+    print(
+        json.dumps(
+            {
+                "systemMessage": system_message,
+                "suppressOutput": True,
+                "hookSpecificOutput": {
+                    "hookEventName": "UserPromptSubmit",
+                    "additionalContext": additional_context,
+                },
+            }
+        )
+    )
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except Exception:
+        pass
+    sys.exit(0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/agent-rules",
-  "version": "0.1.0-next.0",
+  "version": "0.1.0-next.1",
   "license": "MIT",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/index.js

@@ -5,17 +5,22 @@ const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const config_1 = require("./lib/config");
+const migrate_1 = require("./lib/migrate");
 const sync_1 = require("./lib/sync");
 const USAGE = `ethlete-agents — compile @ethlete agent rules and skills into your repo
 
-  ethlete-agents sync    Write the generated rules/skills for every detected agent
-  ethlete-agents check   Exit non-zero when the generated files are out of date (for CI)
-  ethlete-agents init    Write a starter ${config_1.CONFIG_FILE_NAME}
+  ethlete-agents sync      Write the generated rules/skills for every detected agent
+  ethlete-agents check     Exit non-zero when the generated files are out of date (for CI)
+  ethlete-agents init      Write a starter ${config_1.CONFIG_FILE_NAME}
+  ethlete-agents migrate   Convert the repo to the AGENTS.md + .agents/skills layout:
+                           CLAUDE.md content moves into AGENTS.md (CLAUDE.md becomes an
+                           @AGENTS.md import), hand-written .claude/skills move to
+                           .agents/skills with symlinks left behind, then a sync runs
 
 Options
   --targets <list>   Comma-separated subset of: ${config_1.AGENT_TARGETS.join(', ')}
   --root <path>      Repo root to write into (default: current directory)
-  --dry-run          Print what sync would change without writing (sync only)
+  --dry-run          Print what would change without writing (sync and migrate)
 `;
 const readFlag = (args, flag) => {
     const index = args.indexOf(flag);
@@ -43,6 +48,7 @@ const init = (root) => {
         targets: (0, config_1.detectTargets)(root),
         vars: {},
         exclude: [],
+        hooks: [],
     };
     (0, fs_1.writeFileSync)(path, `${JSON.stringify(template, null, 2)}\n`, 'utf8');
     console.log(`Wrote ${config_1.CONFIG_FILE_NAME}. Fill in "vars" for your repo, then run \`ethlete-agents sync\`.`);
@@ -60,6 +66,8 @@ const run = (argv) => {
             return (0, sync_1.check)(options);
         case 'init':
             return init(root);
+        case 'migrate':
+            return (0, migrate_1.migrate)(Object.assign(Object.assign({}, options), { dryRun: argv.includes('--dry-run') }));
         default:
             console.log(USAGE);
             return command === undefined || command === '--help' || command === '-h' ? 0 : 1;

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/agent-rules/src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/agent-rules/src/index.ts"],"names":[],"mappings":";;;;AACA,2BAA6D;AAC7D,+BAA4B;AAC5B,yCAA2F;AAC3F,2CAAwC;AACxC,qCAAyC;AAEzC,MAAM,KAAK,GAAG;;;;6CAI+B,yBAAgB;;;;;;;kDAOX,sBAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;;CAGzE,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,IAAY,EAAE,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnC,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAc,EAAE,EAAE;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAExC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAkB,CAAC;AACtE,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,GAAG,EAAE;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;IAEhH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;IAC5B,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,yBAAgB,CAAC,CAAC;IAE1C,IAAI,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,GAAG,yBAAgB,kBAAkB,CAAC,CAAC;QAErD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,IAAA,sBAAa,EAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,IAAA,kBAAa,EAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,SAAS,yBAAgB,mEAAmE,CAAC,CAAC;IAE1G,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,CAAC,IAAc,EAAE,EAAE;;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;IAE9E,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,IAAA,WAAI,kCAAM,OAAO,KAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAG,CAAC;QAClE,KAAK,OAAO;YACV,OAAO,IAAA,YAAK,EAAC,OAAO,CAAC,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,IAAA,iBAAO,kCAAM,OAAO,KAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAG,CAAC;QACrE;YACE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAEnB,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC,CAAC;AAEF,gDAAsB;AAEtB,oFAAoF;AACpF,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/src/lib/config.d.ts

@@ -2,6 +2,7 @@ import { ContentScope } from './frontmatter';
 export declare const AGENT_TARGETS: readonly ["claude", "codex", "cursor", "copilot"];
 export type AgentTarget = (typeof AGENT_TARGETS)[number];
 export declare const CONFIG_FILE_NAME = "ethlete-agents.config.json";
+export declare const LOCAL_CONFIG_FILE_NAME = "ethlete-agents.config.local.json";
 export type SyncConfig = {
     root: string;
     targets: AgentTarget[];
@@ -9,10 +10,42 @@ export type SyncConfig = {
     scopes: ContentScope[];
     vars: Record<string, string | string[]>;
     exclude: string[];
+    /**
+     * Declares that the repo's `CLAUDE.md` is an `@AGENTS.md` import (or symlink). The claude
+     * target then skips `.claude/rules/ethlete/` — the rules already reach Claude through the
+     * `AGENTS.md` marker block, and a second copy would load twice.
+     */
+    claudeMdImportsAgentsMd: boolean;
+    /** Opt-in Claude Code hooks (they run commands on the developer's machine, so never default). */
+    hooks: string[];
 };
 /**
- * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
- * which Cursor, Copilot and most other agents read as well.
+ * The gitignored local config is a per-machine override, read by the generated hook scripts at
+ * runtime — never by `sync`. Sync output must be identical on every machine and in CI (the
+ * generated files are committed and `check` diffs them), so the only thing a local file can do
+ * is turn behavior off after emit: `disableHooks: true` silences every generated hook,
+ * `disableHooks: ["context-warning"]` just the named ones.
+ */
+export type LocalConfig = {
+    disableHooks?: boolean | string[];
+};
+export type LocalConfigState = {
+    exists: false;
+} | {
+    exists: true;
+    valid: false;
+} | {
+    exists: true;
+    valid: true;
+    config: LocalConfig;
+    unknownKeys: string[];
+};
+export declare const readLocalConfig: (root: string) => LocalConfigState;
+/**
+ * Emit for the agents a repo already uses. `codex` is always included: `AGENTS.md` is the
+ * cross-tool standard that Cursor, Copilot and most other agents read as well, and gating it on
+ * an existing `AGENTS.md` would mean the file that triggers Codex output is the very file the
+ * sync is supposed to create.
  */
 export declare const detectTargets: (root: string) => AgentTarget[];
 export declare const loadConfig: (options: {

package/src/lib/config.js

@@ -1,32 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = exports.detectTargets = exports.CONFIG_FILE_NAME = exports.AGENT_TARGETS = void 0;
+exports.loadConfig = exports.detectTargets = exports.readLocalConfig = exports.LOCAL_CONFIG_FILE_NAME = exports.CONFIG_FILE_NAME = exports.AGENT_TARGETS = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const load_content_1 = require("./load-content");
 exports.AGENT_TARGETS = ['claude', 'codex', 'cursor', 'copilot'];
 exports.CONFIG_FILE_NAME = 'ethlete-agents.config.json';
+exports.LOCAL_CONFIG_FILE_NAME = 'ethlete-agents.config.local.json';
 const readRawConfig = (root) => {
     const path = (0, path_1.join)(root, exports.CONFIG_FILE_NAME);
     if (!(0, fs_1.existsSync)(path))
         return {};
     return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
 };
+const LOCAL_CONFIG_KEYS = ['disableHooks'];
+const readLocalConfig = (root) => {
+    const path = (0, path_1.join)(root, exports.LOCAL_CONFIG_FILE_NAME);
+    if (!(0, fs_1.existsSync)(path))
+        return { exists: false };
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return { exists: true, valid: false };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return { exists: true, valid: false };
+    const config = parsed;
+    const unknownKeys = Object.keys(config).filter((key) => !LOCAL_CONFIG_KEYS.includes(key));
+    return { exists: true, valid: true, config, unknownKeys };
+};
+exports.readLocalConfig = readLocalConfig;
 /**
- * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
- * which Cursor, Copilot and most other agents read as well.
+ * Emit for the agents a repo already uses. `codex` is always included: `AGENTS.md` is the
+ * cross-tool standard that Cursor, Copilot and most other agents read as well, and gating it on
+ * an existing `AGENTS.md` would mean the file that triggers Codex output is the very file the
+ * sync is supposed to create.
  */
 const detectTargets = (root) => {
-    const detected = [];
+    const detected = ['codex'];
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.claude')))
         detected.push('claude');
-    if ((0, fs_1.existsSync)((0, path_1.join)(root, 'AGENTS.md')) || (0, fs_1.existsSync)((0, path_1.join)(root, '.codex')))
-        detected.push('codex');
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.cursor')))
         detected.push('cursor');
     if ((0, fs_1.existsSync)((0, path_1.join)(root, '.github')))
         detected.push('copilot');
-    return detected.length > 0 ? detected : ['codex'];
+    return detected;
 };
 exports.detectTargets = detectTargets;
 const assertKnownTargets = (targets) => {
@@ -36,7 +56,7 @@ const assertKnownTargets = (targets) => {
     }
 };
 const loadConfig = (options) => {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const { root, targetOverride } = options;
     const raw = readRawConfig(root);
     const configured = raw.targets && raw.targets !== 'auto' ? raw.targets : undefined;
@@ -48,6 +68,8 @@ const loadConfig = (options) => {
         scopes: raw.profile === 'sdk' ? ['both'] : ['consumer', 'both'],
         vars: Object.assign(Object.assign({}, (0, load_content_1.loadDefaultVars)()), ((_b = raw.vars) !== null && _b !== void 0 ? _b : {})),
         exclude: (_c = raw.exclude) !== null && _c !== void 0 ? _c : [],
+        claudeMdImportsAgentsMd: (_d = raw.claudeMdImportsAgentsMd) !== null && _d !== void 0 ? _d : false,
+        hooks: (_e = raw.hooks) !== null && _e !== void 0 ? _e : [],
     };
 };
 exports.loadConfig = loadConfig;

package/src/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/config.ts"],"names":[],"mappings":"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"}

package/src/lib/index.d.ts

@@ -2,6 +2,7 @@ export * from './config';
 export * from './filter';
 export * from './frontmatter';
 export * from './load-content';
+export * from './migrate';
 export * from './owned-paths';
 export * from './plan';
 export * from './render';

package/src/lib/index.js

@@ -5,6 +5,7 @@ tslib_1.__exportStar(require("./config"), exports);
 tslib_1.__exportStar(require("./filter"), exports);
 tslib_1.__exportStar(require("./frontmatter"), exports);
 tslib_1.__exportStar(require("./load-content"), exports);
+tslib_1.__exportStar(require("./migrate"), exports);
 tslib_1.__exportStar(require("./owned-paths"), exports);
 tslib_1.__exportStar(require("./plan"), exports);
 tslib_1.__exportStar(require("./render"), exports);

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,mDAAyB;AACzB,wDAA8B;AAC9B,yDAA+B;AAC/B,wDAA8B;AAC9B,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB;AACvB,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,mDAAyB;AACzB,wDAA8B;AAC9B,yDAA+B;AAC/B,oDAA0B;AAC1B,wDAA8B;AAC9B,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB;AACvB,2DAAiC"}

package/src/lib/migrate.d.ts

@@ -0,0 +1,6 @@
+import { RunOptions } from './sync';
+/**
+ * Converts a repo to the `AGENTS.md`-canonical layout and re-syncs. Safe to re-run: every step
+ * detects the migrated state and skips itself.
+ */
+export declare const migrate: (options: RunOptions) => number;