agent-notes 2.30.0__tar.gz → 2.33.0__tar.gz

{agent_notes-2.30.0 → agent_notes-2.33.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-notes
-Version: 2.30.0
+Version: 2.33.0
 Summary: AI agent configuration manager for Claude Code, OpenCode, and Copilot
 Author-email: Eugene Naumov <min.verkligheten@gmail.com>
 License-Expression: MIT
@@ -44,8 +44,8 @@ agent-notes doctor
 
 **What's Included**
 - 19 specialized AI subagents (Opus reasons, Sonnet executes, Haiku explores)
-- 47+ on-demand skills (Rails, Docker, Git, Kamal, Process)
-- Global rules and guardrails
+- 50+ on-demand skills (Rails, Docker, Git, Kamal, Process)
+- Global rules and guardrails (including a ban on AI self-attribution in commits/PRs)
 - Agent memory with 3 storage options (Local, Obsidian, Wiki)
 - Configuration for Claude Code, OpenCode, and GitHub Copilot
 
@@ -170,7 +170,7 @@ If you configured agent-notes to access your memory vault (Obsidian or local), t
 <details>
 <summary>Agent Team</summary>
 
-Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonnet 4.6 executes, Haiku 4.5 scouts.**
+Specialized subagents with hierarchical model strategy: **Opus 4.8 reasons (high effort), Sonnet 5 executes (medium effort), Haiku 4.5 scouts (low effort).**
 
 | Agent | Role | Model Tier | Purpose |
 |---|---|---|---|
@@ -194,7 +194,7 @@ Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonn
 | analyst | scout | haiku | Requirements translation, acceptance criteria |
 | tech-writer | scout | haiku | READMEs, API docs, changelogs |
 
-**4 roles, 19 agents, 3 model tiers.** The tiered model strategy optimizes cost: Opus reasons ($15/1M tokens), Sonnet executes ($3/1M), Haiku scouts ($0.80/1M).
+**4 roles, 19 agents, 3 model tiers.** The tiered model strategy optimizes cost: Opus reasons ($5/$25 per 1M tokens in/out), Sonnet executes ($3/$15), Haiku scouts ($1/$5). A premium `fable` tier ($10/$50) is available for explicit pinning, but no role defaults to it.
 
 ### Delegation rules
 
@@ -216,6 +216,18 @@ Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonn
 - **tech-writer** — Documentation, READMEs, API docs
 - **devil** — Challenges assumptions and plans
 
+### Reconfiguring roles, models, and effort
+
+During `agent-notes install`, wizard step 2 asks you to pick a model per role, and — for models served by a provider with a known effort vocabulary (currently `anthropic`, `openai`) — a follow-up effort prompt, pre-selected to the role's typical effort when that value is valid for the chosen provider. Providers with no effort registry entry (`github-copilot`, `openrouter`, `google`, `moonshot`) skip the effort prompt entirely.
+
+To change these after install:
+```bash
+agent-notes config role-model [--cli <cli>] <role> <model>    # e.g. role-model worker claude-sonnet-5
+agent-notes config role-effort [--cli <cli>] <role> <effort>  # e.g. role-effort worker high
+agent-notes config wizard                                     # interactive menu for both
+```
+`role-effort` validates the effort against the role's currently-assigned model's provider — an invalid value prints that provider's name and its valid effort list. There's no cross-provider mapping: each provider (anthropic, openai) has its own independent effort vocabulary and default.
+
 </details>
 
 ---
@@ -282,7 +294,7 @@ agent-notes memory lint               # health-check
 <details>
 <summary>Skills</summary>
 
-47+ on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
+50+ on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
 
 The session context hook auto-generates a skill index from SKILL.md frontmatter at install time, so agents always know what skills are available without loading full skill content. This keeps context overhead low while maintaining skill discoverability.
 
@@ -297,26 +309,29 @@ Load the docker-compose skill for multi-service setup
 
 | Failure mode | What goes wrong | Skills that help |
 |---|---|---|
-| Misalignment | Claude starts building before the problem is resolved | `/grill-me`, `/grill-with-docs` |
-| Verbosity | Responses are bloated; context window fills with noise | `/caveman`, `/setup-project-context` |
-| Broken code | Claude codes without a feedback loop or evidence trail | `/tdd` (improved), `/debugging-protocol` (improved) |
-| Ball of mud | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/zoom-out` |
+| Misalignment | Claude starts building before the problem is resolved | `/grill-me`, `/grilling`, `/grill-with-docs` |
+| Vague scope | Work starts without a spec or ticketed breakdown | `/to-spec`, `/to-tickets`, `/wayfinder`, `/triage` |
+| Broken code | Claude codes without a feedback loop or evidence trail | `/tdd`, `/diagnosing-bugs` |
+| Ball of mud | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/codebase-design`, `/domain-modeling` |
 
 **Skill descriptions:**
 
-- `/grill-me` — Interview the user until the problem is fully resolved before touching code
+- `/grill-me`, `/grilling` — Interview the user relentlessly until the plan is fully resolved before touching code
 - `/grill-with-docs` — Same, but cross-references CONTEXT.md and ADRs and updates them inline
-- `/caveman` — Ultra-compressed reply mode (~75% token savings) for rapid iteration
-- `/setup-project-context` — Bootstraps a CONTEXT.md domain glossary (ubiquitous language)
-- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; horizontal-slicing anti-pattern added
-- `/debugging-protocol` — Phase 1 rewritten as "build a feedback loop first" with 9 strategies
-- `/improve-codebase-architecture` — Deletion test to find shallow modules; surfaces deepening opportunities
-- `/zoom-out` — Quick orientation map of an unfamiliar code area
+- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; integration-first testing
+- `/diagnosing-bugs` — Diagnosis loop for hard bugs and performance regressions (build a feedback loop first)
+- `/improve-codebase-architecture` — Scan for deepening opportunities, present a visual HTML report, then grill the chosen one
+- `/codebase-design` — Shared vocabulary for designing deep modules and choosing where seams go
+- `/domain-modeling` — Pin down ubiquitous language, maintain a CONTEXT.md glossary and ADRs
 - `/handoff` — Compact conversation into a handoff document for a fresh agent session
-- `/to-prd` — Synthesize conversation into a Product Requirements Document
-- `/to-issues` — Break a plan/PRD into vertical-slice issues (HITL/AFK classification)
+- `/to-spec` — Synthesize the current conversation into a spec and publish it to the issue tracker
+- `/to-tickets` — Break a plan/spec into tracer-bullet tickets with declared blocking edges
+- `/wayfinder` — Plan work larger than one agent session as a map of investigation tickets
+- `/triage` — Move issues and external PRs through a triage state machine into agent-ready briefs
+- `/research` — Investigate a question against primary sources and capture findings as Markdown
 - `/prototype` — Throwaway prototypes: terminal app for logic or UI variations for visual
-- `/write-a-skill` — Meta-skill for creating new skills with proper structure
+- `/setup-agent-tracker` — One-time per-repo setup of the issue tracker, triage labels, and domain doc layout
+- `/writing-great-skills` — Reference for writing and editing skills well
 
 </details>
 
@@ -509,7 +524,7 @@ See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI
 ## Inspired by
 
 - [Andrej Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — The wiki memory backend implements his compile-once, query-forever knowledge pattern with structured page types and three core operations (ingest, query, lint)
-- [Matt Pocock's skills repo](https://github.com/mattpocock/skills) — Skill format (SKILL.md per directory), failure-mode table (misalignment, verbosity, broken code, architectural degradation), and several core skills (tdd, grill-me, grill-with-docs, improve-codebase-architecture, zoom-out, caveman)
+- [Matt Pocock's skills repo](https://github.com/mattpocock/skills) — Skill format (SKILL.md per directory), failure-mode table (misalignment, broken code, architectural degradation), and a set of engineering/productivity skills vendored from the upstream repo (tdd, grill-me, grilling, grill-with-docs, diagnosing-bugs, improve-codebase-architecture, codebase-design, domain-modeling, prototype, handoff, research, to-spec, to-tickets, triage, wayfinder, writing-great-skills). Last synced from upstream commit [`391a270`](https://github.com/mattpocock/skills/commit/391a2701dd948f94f56a39f7533f8eea9a859c87) (2026-07-10), reviewed for prompt-injection before import.
 
 ## License
 

{agent_notes-2.30.0 → agent_notes-2.33.0}/README.md

@@ -12,8 +12,8 @@ agent-notes doctor
 
 **What's Included**
 - 19 specialized AI subagents (Opus reasons, Sonnet executes, Haiku explores)
-- 47+ on-demand skills (Rails, Docker, Git, Kamal, Process)
-- Global rules and guardrails
+- 50+ on-demand skills (Rails, Docker, Git, Kamal, Process)
+- Global rules and guardrails (including a ban on AI self-attribution in commits/PRs)
 - Agent memory with 3 storage options (Local, Obsidian, Wiki)
 - Configuration for Claude Code, OpenCode, and GitHub Copilot
 
@@ -138,7 +138,7 @@ If you configured agent-notes to access your memory vault (Obsidian or local), t
 <details>
 <summary>Agent Team</summary>
 
-Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonnet 4.6 executes, Haiku 4.5 scouts.**
+Specialized subagents with hierarchical model strategy: **Opus 4.8 reasons (high effort), Sonnet 5 executes (medium effort), Haiku 4.5 scouts (low effort).**
 
 | Agent | Role | Model Tier | Purpose |
 |---|---|---|---|
@@ -162,7 +162,7 @@ Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonn
 | analyst | scout | haiku | Requirements translation, acceptance criteria |
 | tech-writer | scout | haiku | READMEs, API docs, changelogs |
 
-**4 roles, 19 agents, 3 model tiers.** The tiered model strategy optimizes cost: Opus reasons ($15/1M tokens), Sonnet executes ($3/1M), Haiku scouts ($0.80/1M).
+**4 roles, 19 agents, 3 model tiers.** The tiered model strategy optimizes cost: Opus reasons ($5/$25 per 1M tokens in/out), Sonnet executes ($3/$15), Haiku scouts ($1/$5). A premium `fable` tier ($10/$50) is available for explicit pinning, but no role defaults to it.
 
 ### Delegation rules
 
@@ -184,6 +184,18 @@ Specialized subagents with hierarchical model strategy: **Opus 4.6 reasons, Sonn
 - **tech-writer** — Documentation, READMEs, API docs
 - **devil** — Challenges assumptions and plans
 
+### Reconfiguring roles, models, and effort
+
+During `agent-notes install`, wizard step 2 asks you to pick a model per role, and — for models served by a provider with a known effort vocabulary (currently `anthropic`, `openai`) — a follow-up effort prompt, pre-selected to the role's typical effort when that value is valid for the chosen provider. Providers with no effort registry entry (`github-copilot`, `openrouter`, `google`, `moonshot`) skip the effort prompt entirely.
+
+To change these after install:
+```bash
+agent-notes config role-model [--cli <cli>] <role> <model>    # e.g. role-model worker claude-sonnet-5
+agent-notes config role-effort [--cli <cli>] <role> <effort>  # e.g. role-effort worker high
+agent-notes config wizard                                     # interactive menu for both
+```
+`role-effort` validates the effort against the role's currently-assigned model's provider — an invalid value prints that provider's name and its valid effort list. There's no cross-provider mapping: each provider (anthropic, openai) has its own independent effort vocabulary and default.
+
 </details>
 
 ---
@@ -250,7 +262,7 @@ agent-notes memory lint               # health-check
 <details>
 <summary>Skills</summary>
 
-47+ on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
+50+ on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
 
 The session context hook auto-generates a skill index from SKILL.md frontmatter at install time, so agents always know what skills are available without loading full skill content. This keeps context overhead low while maintaining skill discoverability.
 
@@ -265,26 +277,29 @@ Load the docker-compose skill for multi-service setup
 
 | Failure mode | What goes wrong | Skills that help |
 |---|---|---|
-| Misalignment | Claude starts building before the problem is resolved | `/grill-me`, `/grill-with-docs` |
-| Verbosity | Responses are bloated; context window fills with noise | `/caveman`, `/setup-project-context` |
-| Broken code | Claude codes without a feedback loop or evidence trail | `/tdd` (improved), `/debugging-protocol` (improved) |
-| Ball of mud | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/zoom-out` |
+| Misalignment | Claude starts building before the problem is resolved | `/grill-me`, `/grilling`, `/grill-with-docs` |
+| Vague scope | Work starts without a spec or ticketed breakdown | `/to-spec`, `/to-tickets`, `/wayfinder`, `/triage` |
+| Broken code | Claude codes without a feedback loop or evidence trail | `/tdd`, `/diagnosing-bugs` |
+| Ball of mud | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/codebase-design`, `/domain-modeling` |
 
 **Skill descriptions:**
 
-- `/grill-me` — Interview the user until the problem is fully resolved before touching code
+- `/grill-me`, `/grilling` — Interview the user relentlessly until the plan is fully resolved before touching code
 - `/grill-with-docs` — Same, but cross-references CONTEXT.md and ADRs and updates them inline
-- `/caveman` — Ultra-compressed reply mode (~75% token savings) for rapid iteration
-- `/setup-project-context` — Bootstraps a CONTEXT.md domain glossary (ubiquitous language)
-- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; horizontal-slicing anti-pattern added
-- `/debugging-protocol` — Phase 1 rewritten as "build a feedback loop first" with 9 strategies
-- `/improve-codebase-architecture` — Deletion test to find shallow modules; surfaces deepening opportunities
-- `/zoom-out` — Quick orientation map of an unfamiliar code area
+- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; integration-first testing
+- `/diagnosing-bugs` — Diagnosis loop for hard bugs and performance regressions (build a feedback loop first)
+- `/improve-codebase-architecture` — Scan for deepening opportunities, present a visual HTML report, then grill the chosen one
+- `/codebase-design` — Shared vocabulary for designing deep modules and choosing where seams go
+- `/domain-modeling` — Pin down ubiquitous language, maintain a CONTEXT.md glossary and ADRs
 - `/handoff` — Compact conversation into a handoff document for a fresh agent session
-- `/to-prd` — Synthesize conversation into a Product Requirements Document
-- `/to-issues` — Break a plan/PRD into vertical-slice issues (HITL/AFK classification)
+- `/to-spec` — Synthesize the current conversation into a spec and publish it to the issue tracker
+- `/to-tickets` — Break a plan/spec into tracer-bullet tickets with declared blocking edges
+- `/wayfinder` — Plan work larger than one agent session as a map of investigation tickets
+- `/triage` — Move issues and external PRs through a triage state machine into agent-ready briefs
+- `/research` — Investigate a question against primary sources and capture findings as Markdown
 - `/prototype` — Throwaway prototypes: terminal app for logic or UI variations for visual
-- `/write-a-skill` — Meta-skill for creating new skills with proper structure
+- `/setup-agent-tracker` — One-time per-repo setup of the issue tracker, triage labels, and domain doc layout
+- `/writing-great-skills` — Reference for writing and editing skills well
 
 </details>
 
@@ -477,7 +492,7 @@ See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI
 ## Inspired by
 
 - [Andrej Karpathy's LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — The wiki memory backend implements his compile-once, query-forever knowledge pattern with structured page types and three core operations (ingest, query, lint)
-- [Matt Pocock's skills repo](https://github.com/mattpocock/skills) — Skill format (SKILL.md per directory), failure-mode table (misalignment, verbosity, broken code, architectural degradation), and several core skills (tdd, grill-me, grill-with-docs, improve-codebase-architecture, zoom-out, caveman)
+- [Matt Pocock's skills repo](https://github.com/mattpocock/skills) — Skill format (SKILL.md per directory), failure-mode table (misalignment, broken code, architectural degradation), and a set of engineering/productivity skills vendored from the upstream repo (tdd, grill-me, grilling, grill-with-docs, diagnosing-bugs, improve-codebase-architecture, codebase-design, domain-modeling, prototype, handoff, research, to-spec, to-tickets, triage, wayfinder, writing-great-skills). Last synced from upstream commit [`391a270`](https://github.com/mattpocock/skills/commit/391a2701dd948f94f56a39f7533f8eea9a859c87) (2026-07-10), reviewed for prompt-injection before import.
 
 ## License
 

agent_notes-2.33.0/agent_notes/VERSION

@@ -0,0 +1 @@
+2.33.0

{agent_notes-2.30.0 → agent_notes-2.33.0}/agent_notes/cli.py

@@ -302,7 +302,7 @@ def main():
     # config
     p_config = subparsers.add_parser("config", help="Reconfigure role/agent/model/memory/skill assignments after install")
     p_config.add_argument("action", nargs="?", default="wizard",
-        choices=["wizard", "show", "role-model", "role-agent", "provider", "providers", "memory", "cost-report"],
+        choices=["wizard", "show", "role-model", "role-agent", "role-effort", "provider", "providers", "memory", "cost-report"],
         help="Config action (default: wizard)")
     p_config.add_argument("extra", nargs="*", help="Additional positional args (role, model, agent)")
     p_config.add_argument("--cli", help="Target CLI (claude / opencode / both)")

{agent_notes-2.30.0 → agent_notes-2.33.0}/agent_notes/commands/build.py

@@ -89,10 +89,43 @@ def count_lines(file_path: Path) -> int:
         return 0
 
 
-def build() -> None:
-    """Build agent configuration files from source."""
+def count_dist_clis(files: list[Path], dist_dir: Path, cli_names: set[str]) -> int:
+    """Count distinct CLI backends among generated files (dist/<cli>/... paths).
+
+    Files outside dist_dir or under non-CLI top-level dirs (rules/, skills/)
+    are ignored."""
+    found = set()
+    for f in files:
+        try:
+            rel = f.relative_to(dist_dir)
+        except ValueError:
+            continue
+        if rel.parts and rel.parts[0] in cli_names:
+            found.add(rel.parts[0])
+    return len(found)
+
+
+def format_build_summary(n_files: int, n_lines: int, n_clis: int) -> str:
+    """One-line build summary, e.g. 'Generated 96 files (13,748 lines) across 4 CLIs'."""
+    file_word = "file" if n_files == 1 else "files"
+    cli_word = "CLI" if n_clis == 1 else "CLIs"
+    return f"Generated {n_files} {file_word} ({n_lines:,} lines) across {n_clis} {cli_word}"
+
+
+def build(role_models=None, role_efforts=None, scope='global', project_path=None,
+          profile_label: str = "") -> None:
+    """Build agent configuration files from source.
+
+    Args:
+        role_models: Optional explicit {cli: {role: model_id}} pins that override
+            persisted state (e.g. wizard selections not yet written to state.json)
+        role_efforts: Optional explicit {cli: {role: effort}} pins, same semantics
+        scope: which state.json scope's pins drive the render ('global' or 'local')
+        project_path: project path for scope='local'
+        profile_label: named profile whose pins drive the render ("" = default profile)
+    """
     from ..services.state_store import load_state
-    from ..config import ROOT
+    from ..registries.cli_registry import load_registry
 
     # Read configuration
     try:
@@ -103,10 +136,13 @@ def build() -> None:
 
     # Load state if present (no error if missing)
     state = load_state()
-    
+
     # Generate agent files (state=None is backward compatible)
     print("Generating agent files...")
-    agent_files = generate_agent_files(agents_config, tiers, state=state)
+    agent_files = generate_agent_files(agents_config, tiers, state=state,
+                                       scope=scope, project_path=project_path,
+                                       role_models=role_models, role_efforts=role_efforts,
+                                       profile_label=profile_label)
     
     # Copy global files
     print("Copying global files...")
@@ -120,21 +156,12 @@ def build() -> None:
     print("Copying commands...")
     command_files = copy_commands()
 
-    # Report results
+    # Report results — one-line summary (per-file listing was too noisy)
     all_files = agent_files + global_files + skill_files + command_files
-    print(f"\nGenerated {len(all_files)} files:")
-    
-    total_lines = 0
-    for file_path in sorted(all_files):
-        try:
-            rel_path = file_path.relative_to(ROOT)
-        except ValueError:
-            rel_path = file_path  # absolute path if outside the package tree
-        lines = count_lines(file_path)
-        total_lines += lines
-        print(f"  {rel_path} ({lines} lines)")
-    
-    print(f"\nTotal: {total_lines} lines across {len(all_files)} files")
+    total_lines = sum(count_lines(f) for f in all_files)
+    cli_names = {b.name for b in load_registry().all()}
+    n_clis = count_dist_clis(all_files, DIST_DIR, cli_names)
+    print(f"\n{format_build_summary(len(all_files), total_lines, n_clis)}")
 
 
 if __name__ == '__main__':

{agent_notes-2.30.0 → agent_notes-2.33.0}/agent_notes/commands/config.py

@@ -68,6 +68,65 @@ def _validate_role(role_name: str):
         sys.exit(1)
 
 
+def _check_effort_valid(scope_state, cli_name: str, role_name: str, effort: str) -> bool:
+    """Check effort against the role's currently-assigned model's provider on
+    cli_name. Prints the provider name and its valid effort list on failure.
+    Returns True/False — does not exit (callers decide fatal vs. non-fatal).
+
+    NO cross-provider mapping/translation — the value is checked against exactly
+    the provider that serves the role's current model, nothing more.
+    """
+    from ..registries.model_registry import load_model_registry
+    from ..registries.cli_registry import load_registry
+    from ..registries.provider_registry import load_provider_registry
+
+    model_id = scope_state.clis[cli_name].role_models.get(role_name)
+    if not model_id:
+        print(f"No model assigned to role '{role_name}' for CLI '{cli_name}'.")
+        print("Set a model first with `agent-notes config role-model`.")
+        return False
+
+    model_registry = load_model_registry()
+    try:
+        model = model_registry.get(model_id)
+    except KeyError:
+        print(f"Unknown model '{model_id}' assigned to role '{role_name}'.")
+        return False
+
+    cli_registry = load_registry()
+    try:
+        backend = cli_registry.get(cli_name)
+    except KeyError:
+        print(f"Unknown CLI '{cli_name}'.")
+        return False
+
+    resolved = backend.first_alias_for(model.aliases)
+    if resolved is None:
+        print(f"Model '{model_id}' has no compatible provider for CLI '{cli_name}'.")
+        return False
+    provider_name, _alias = resolved
+
+    provider_registry = load_provider_registry()
+    try:
+        provider = provider_registry.get(provider_name)
+    except KeyError:
+        print(f"Provider '{provider_name}' does not support effort configuration.")
+        return False
+
+    if effort not in provider.efforts:
+        print(f"Invalid effort '{effort}' for provider '{provider_name}'.")
+        print(f"Valid efforts for {provider_name}: {', '.join(provider.efforts)}")
+        return False
+
+    return True
+
+
+def _validate_effort(scope_state, cli_name: str, role_name: str, effort: str) -> None:
+    """Validate effort, exiting with the printed error on failure."""
+    if not _check_effort_valid(scope_state, cli_name, role_name, effort):
+        sys.exit(1)
+
+
 def _state_snapshot(state) -> str:
     """Return a compact JSON snapshot of state for diffing."""
     from ..services.state_store import _state_to_dict
@@ -156,6 +215,37 @@ def role_model(role_name: str, model_id: str, cli_filter: Optional[str] = None)
     _apply_and_regenerate(state, before)
 
 
+def role_effort(role_name: str, effort: str, cli_filter: Optional[str] = None) -> None:
+    """Set role→effort for one or both CLIs. Validates against the role's current
+    model's provider, diffs, prompts, applies."""
+    state = _load_state()
+    before = _state_snapshot(state)
+
+    _validate_role(role_name)
+
+    scope, project_path, scope_state = _get_scope_state(state)
+
+    if cli_filter and cli_filter not in ("both",):
+        # Single CLI
+        target_clis = [cli_filter]
+        for cli_name in target_clis:
+            if cli_name not in scope_state.clis:
+                print(f"CLI '{cli_name}' not in {scope} installation.")
+                print(f"Installed CLIs: {', '.join(scope_state.clis.keys())}")
+                sys.exit(1)
+    else:
+        target_clis = list(scope_state.clis.keys())
+
+    for cli_name in target_clis:
+        _validate_effort(scope_state, cli_name, role_name, effort)
+
+    for cli_name in target_clis:
+        scope_state.clis[cli_name].role_efforts[role_name] = effort
+        print(f"Set {cli_name}: {role_name} -> {effort}")
+
+    _apply_and_regenerate(state, before)
+
+
 def role_agent(role_name: str, agent_name: str, cli_filter: Optional[str] = None) -> None:
     """Set role→agent assignment (which agent files carry a given role)."""
     # Note: in the current data model, agent-to-role mapping is in agents.yaml (source)
@@ -243,6 +333,17 @@ def show(state=None) -> None:
             else:
                 print("      (no role assignments)")
 
+            if backend_state.role_efforts:
+                print("      Effort:")
+                for role_name in sorted(backend_state.role_efforts):
+                    effort = backend_state.role_efforts[role_name]
+                    try:
+                        role = role_registry.get(role_name)
+                        role_label = role.label
+                    except KeyError:
+                        role_label = role_name
+                    print(f"      {role_label:<20} {effort}")
+
 
 # ── Interactive wizard ───────────────────────────────────────────────────────
 
@@ -313,6 +414,68 @@ def _wizard_role_model(state, before: str) -> bool:
     return True
 
 
+def _wizard_role_effort(state, before: str) -> bool:
+    """Branch 7: interactive role→effort reassignment. Returns True if changes were applied."""
+    from ..registries.cli_registry import load_registry
+    from ..registries.role_registry import load_role_registry
+    from ..services.ui import _safe_input
+
+    scope, project_path, scope_state = _get_scope_state(state)
+
+    cli_registry = load_registry()
+    role_registry = load_role_registry()
+
+    # Show current
+    print("\nCurrent effort assignments:")
+    for cli_name, backend_state in sorted(scope_state.clis.items()):
+        try:
+            label = cli_registry.get(cli_name).label
+        except KeyError:
+            label = cli_name
+        print(f"  {label.upper()}:")
+        for role_name in sorted(backend_state.role_efforts):
+            effort = backend_state.role_efforts[role_name]
+            print(f"    {role_name:<20} {effort}")
+
+    cli_names = list(scope_state.clis.keys())
+    if len(cli_names) > 1:
+        cli_choice = _safe_input("\nWhich CLI? (claude / opencode / both) [both]: ", "both").strip().lower()
+        if cli_choice in ("both", ""):
+            target_clis = cli_names
+        elif cli_choice in cli_names:
+            target_clis = [cli_choice]
+        else:
+            print(f"Unknown CLI '{cli_choice}'. No changes made.")
+            return False
+    else:
+        target_clis = cli_names
+
+    role_names = role_registry.names()
+    role_choice = _safe_input(
+        f"Which role? ({'/'.join(role_names)}): ", ""
+    ).strip().lower()
+    if role_choice not in role_names:
+        print(f"Unknown role '{role_choice}'. No changes made.")
+        return False
+
+    effort_choice = _safe_input(f"New effort: ", "").strip().lower()
+    if not effort_choice:
+        print("No effort entered. No changes made.")
+        return False
+
+    for cli_name in target_clis:
+        if not _check_effort_valid(scope_state, cli_name, role_choice, effort_choice):
+            print("No changes made.")
+            return False
+
+    for cli_name in target_clis:
+        scope_state.clis[cli_name].role_efforts[role_choice] = effort_choice
+        print(f"Set {cli_name}: {role_choice} -> {effort_choice}")
+
+    _apply_and_regenerate(state, before)
+    return True
+
+
 def _wizard_memory(state, before: str) -> bool:
     """Branch 3: interactive memory backend change."""
     from ..services.ui import _safe_input, _path_input
@@ -427,6 +590,7 @@ def interactive_config() -> None:
     print("  4) Skill bundles")
     print("  5) Show full configuration (read-only)")
     print("  6) API keys / providers")
+    print("  7) Role -> effort assignments")
     print("  q) Quit")
 
     try:
@@ -447,6 +611,8 @@ def interactive_config() -> None:
         show(state)
     elif choice == "6":
         _wizard_providers()
+    elif choice == "7":
+        _wizard_role_effort(state, before)
     elif choice == "q":
         print("Quit.")
     else:
@@ -493,6 +659,12 @@ def config(action: str = "wizard", args: Optional[list] = None, cli_filter: Opti
             print("Usage: agent-notes config role-agent <role> <agent>")
             sys.exit(1)
         role_agent(args[0], args[1], cli_filter=cli_filter)
+    elif action == "role-effort":
+        # args: [role_name, effort]
+        if len(args) < 2:
+            print("Usage: agent-notes config role-effort [--cli <cli>] <role> <effort>")
+            sys.exit(1)
+        role_effort(args[0], args[1], cli_filter=cli_filter)
     elif action == "providers":
         _wizard_providers()
     elif action == "provider":
@@ -510,5 +682,5 @@ def config(action: str = "wizard", args: Optional[list] = None, cli_filter: Opti
         cost_report_toggle(args[0])
     else:
         print(f"Unknown config action: {action}")
-        print("Actions: wizard, show, role-model, role-agent, providers, provider, memory, cost-report")
+        print("Actions: wizard, show, role-model, role-agent, role-effort, providers, provider, memory, cost-report")
         sys.exit(1)

{agent_notes-2.30.0 → agent_notes-2.33.0}/agent_notes/commands/install.py

@@ -48,6 +48,20 @@ def install(local: bool = False, copy: bool = False, reconfigure: bool = False,
         print(f"  CLIs:      {', '.join(cli_labels)}")
         print(f"  Mode:      {existing.mode}")
         print()
+        # Re-render dist/ from the persisted state pins before verifying.
+        # After a pipx upgrade/reinstall the shipped dist/ carries package
+        # defaults; installed symlinks point into dist/, so without this
+        # rebuild the user's role_models/role_efforts pins would silently
+        # revert to defaults until the next build/regenerate.
+        print("Refreshing rendered files from saved configuration ...")
+        try:
+            from ..commands.build import build
+            from ..services.fs import silent_ops
+            with silent_ops():
+                build(scope=scope, project_path=project_path, profile_label=profile_label)
+        except Exception as e:
+            print(f"{Color.YELLOW}Warning: rebuild failed: {e}{Color.NC}")
+        print()
         print("Verifying ...")
         issues = _verify_install(existing, scope, project_path, registry)
         if not issues:
@@ -78,11 +92,12 @@ def install(local: bool = False, copy: bool = False, reconfigure: bool = False,
         print("Global installs always use symlinks.")
         return
 
-    # Build first
+    # Build first — scope-aware so an existing state pin set for this scope
+    # (e.g. local install after a previous local wizard run) drives the render.
     print("Building from source...")
     try:
         from ..commands.build import build
-        build()
+        build(scope=scope, project_path=project_path, profile_label=profile_label)
     except Exception as e:
         print(f"{Color.RED}Build failed: {e}{Color.NC}")
         return

{agent_notes-2.30.0 → agent_notes-2.33.0}/agent_notes/commands/memory/migrate.py

@@ -100,7 +100,7 @@ def do_migrate() -> None:
                 continue
             dst_cat = vault / cat
             dst_cat.mkdir(exist_ok=True)
-            for note in src_cat.glob("*.md"):
+            for note in sorted(src_cat.glob("*.md")):
                 dst = dst_cat / note.name
                 if dst.exists():
                     errors.append(f"collision: {note} -> {dst}")
@@ -126,7 +126,10 @@ def do_migrate() -> None:
         cat_dir = vault / cat
         if not cat_dir.exists():
             continue
-        for note in list(cat_dir.glob("*.md")):
+        # Sort for deterministic ordering: on a same-date collision the
+        # earliest-named file keeps the clean base name and later ones get the
+        # HHMMSS suffix, regardless of filesystem glob order.
+        for note in sorted(cat_dir.glob("*.md")):
             new_stem = _new_stem(note.stem, cat_dir, note)
             if new_stem is None:
                 skipped += 1