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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-notes
-Version: 2.32.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
@@ -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>
 
 ---

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

@@ -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>
 
 ---

agent_notes-2.33.0/agent_notes/VERSION

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

{agent_notes-2.32.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.32.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.32.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.32.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.32.0 → agent_notes-2.33.0}/agent_notes/commands/regenerate.py

@@ -104,7 +104,8 @@ def regenerate(scope: Optional[str] = None, cli: Optional[str] = None, local: bo
                 {},  # empty tiers - state-driven only
                 state=current_state,
                 scope=scope,
-                project_path=project_path
+                project_path=project_path,
+                profile_label=profile_label
             )
             # Count files for this CLI
             try:
@@ -136,24 +137,27 @@ def regenerate(scope: Optional[str] = None, cli: Optional[str] = None, local: bo
     
     # Update installed manifest to reflect current state
     try:
-        # Get current role_models and overrides from state to preserve them
+        # Get current role_models/role_efforts and overrides from state to preserve them
         existing_role_models = {}
+        existing_role_efforts = {}
         folder_overrides = {}
         global_home_override = None
         for cli_name, backend_state in scope_state.clis.items():
             existing_role_models[cli_name] = backend_state.role_models
+            existing_role_efforts[cli_name] = backend_state.role_efforts
             if backend_state.local_dir_override:
                 folder_overrides[cli_name] = backend_state.local_dir_override
             if backend_state.global_home_override:
                 global_home_override = backend_state.global_home_override
 
-        # Build new state with current files but preserve role_models
+        # Build new state with current files but preserve role_models/role_efforts
         new_state = build_install_state(
             mode=scope_state.mode,
             scope=scope,
             repo_root=PKG_DIR.parent,
             project_path=project_path,
             role_models=existing_role_models,
+            role_efforts=existing_role_efforts,
             profile_label=profile_label,
             folder_overrides=folder_overrides or None,
             global_home_override=global_home_override,