agent-notes 2.15.1__tar.gz → 2.17.0__tar.gz

{agent_notes-2.15.1 → agent_notes-2.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-notes
-Version: 2.15.1
+Version: 2.17.0
 Summary: AI agent configuration manager for Claude Code, OpenCode, and Copilot
 Author-email: Eugene Naumov <min.verkligheten@gmail.com>
 License-Expression: MIT
@@ -32,7 +32,7 @@ Dynamic: license-file
 
 AI agent configuration manager for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [OpenCode](https://github.com/opencode-ai/opencode).
 
-Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus plans and reasons, Sonnet executes, and Haiku explores.
+Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus 4.6 plans and reasons, Sonnet 4.6 executes, and Haiku 4.5 explores.
 
 ## Quick Start
 
@@ -86,8 +86,8 @@ Iteration loop: edit source → `python -m build` → `pipx reinstall dist/*.whl
 
 ### 3. Plugin — limited functionality
 
-- **Claude Code**: install via the Claude Code plugin marketplace.
-- **OpenCode**: copy or symlink `.opencode-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
+- **Claude Code**: install via the Claude Code plugin marketplace or copy/symlink `.claude-plugin/` into `~/.claude/plugins/agent-notes/`.
+- **OpenCode**: copy or symlink `.claude-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
 
 The plugin runs a `session.start` hook that surfaces agent-notes context to the CLI session. It does **not** include the full `agent-notes` CLI (wizard, doctor, config, memory, etc.). For those, use install method 1 or 2.
 
@@ -113,9 +113,8 @@ agent-notes <command> [options]
 
 | Command | Description |
 |---------|-------------|
-| `install [--local] [--copy]` | Interactive wizard or direct install |
-| `uninstall [--local]` | Remove installed components |
-| `update` | Pull latest, rebuild, reinstall |
+| `install [--local] [--copy] [--reconfigure]` | Interactive wizard or direct install |
+| `uninstall [--local \| --global]` | Remove installed components (both scopes by default) |
 | `doctor [--local] [--fix]` | Check installation health |
 | `info` | Show status and component counts |
 | `list [clis\|models\|roles\|agents\|skills\|rules\|all]` | List engine components or installed |
@@ -123,6 +122,7 @@ agent-notes <command> [options]
 | `regenerate [--cli <cli>]` | Rebuild files from state.json (Phase 10+) |
 | `validate` | Lint source configuration files |
 | `memory [list\|size\|show\|reset\|export\|import] [name]` | Manage agent memory |
+| `cost-report` | Show session cost breakdown by agent and model |
 
 ### Supported platforms
 
@@ -153,25 +153,25 @@ agent-notes memory add "Rails enum prefix" \
 
 ## Agent Team
 
-Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonnet 4 executes, Haiku 4.5 explores.**
+Specialized subagents with hierarchical model strategy: **Opus 4.6 decides, Sonnet 4.6 executes, Haiku 4.5 explores.**
 
 | Agent | Model | Role |
 |-------|-------|------|
-| **lead** | Opus 4.7 | Plans, delegates, reviews. Orchestrator. |
-| **architect** | Opus 4.7 | System architecture, module boundaries, domain models. Read-only. |
-| **debugger** | Opus 4.7 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
-| **coder** | Sonnet 4 | Implements features, fixes bugs, edits files. |
-| **reviewer** | Sonnet 4 | Code quality review. Read-only. |
-| **security-auditor** | Sonnet 4 | Security vulnerability analysis. Read-only. |
-| **test-writer** | Sonnet 4 | Writes tests for any framework. |
-| **test-runner** | Sonnet 4 | Diagnoses and fixes failing tests. |
-| **system-auditor** | Sonnet 4 | Codebase health: duplication, N+1, coupling. Read-only. |
-| **database-specialist** | Sonnet 4 | Schema design, indexes, query performance, migrations. Read-only. |
-| **performance-profiler** | Sonnet 4 | Response times, memory, caching, bundle size. Read-only. |
-| **devops** | Sonnet 4 | Docker, CI/CD, deployment configs. |
-| **devil** | Sonnet 4 | Challenges plans to surface hidden risks. Read-only. |
-| **integrations** | Sonnet 4 | Third-party integrations: OAuth, webhooks, payments. |
-| **refactorer** | Sonnet 4 | Improves code structure without changing behavior. |
+| **lead** | Opus 4.6 | Plans, delegates, reviews. Orchestrator. |
+| **architect** | Opus 4.6 | System architecture, module boundaries, domain models. Read-only. |
+| **debugger** | Opus 4.6 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
+| **coder** | Sonnet 4.6 | Implements features, fixes bugs, edits files. |
+| **reviewer** | Sonnet 4.6 | Code quality review. Read-only. |
+| **security-auditor** | Sonnet 4.6 | Security vulnerability analysis. Read-only. |
+| **test-writer** | Sonnet 4.6 | Writes tests for any framework. |
+| **test-runner** | Sonnet 4.6 | Diagnoses and fixes failing tests. |
+| **system-auditor** | Sonnet 4.6 | Codebase health: duplication, N+1, coupling. Read-only. |
+| **database-specialist** | Sonnet 4.6 | Schema design, indexes, query performance, migrations. Read-only. |
+| **performance-profiler** | Sonnet 4.6 | Response times, memory, caching, bundle size. Read-only. |
+| **devops** | Sonnet 4.6 | Docker, CI/CD, deployment configs. |
+| **devil** | Sonnet 4.6 | Challenges plans to surface hidden risks. Read-only. |
+| **integrations** | Sonnet 4.6 | Third-party integrations: OAuth, webhooks, payments. |
+| **refactorer** | Sonnet 4.6 | Improves code structure without changing behavior. |
 | **analyst** | Haiku 4.5 | Requirements analysis: surfaces missing or contradictory requirements. Read-only. |
 | **api-reviewer** | Haiku 4.5 | API design, versioning, error handling, backward compatibility. Read-only. |
 | **tech-writer** | Haiku 4.5 | Documentation: READMEs, API docs, changelogs. |
@@ -179,7 +179,7 @@ Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonn
 
 ## Architecture
 
-agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
+agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. Context is loaded in tiers: always-loaded (CLAUDE.md, rules, skill catalog), lazy-loaded (full skill content, agent prompts), and pull-based (memory notes). See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
 
 ## Improved Claude Code workflows
 
@@ -205,6 +205,8 @@ Four failure modes that derail AI-assisted development, and the skills that addr
 
 42 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.
+
 ### Using skills in Claude Code / OpenCode
 
 ```
@@ -222,6 +224,7 @@ Agents accumulate knowledge across sessions using one of three backends, chosen
 |---------|---------|----------|
 | **Local** | `~/.claude/agent-memory/<agent>/` — plain markdown per agent | Simple setup, no extra tools |
 | **Obsidian** | Category vault with YAML frontmatter and `[[wikilinks]]` | Visual browsing, backlinks, Dataview queries |
+| **Wiki** | `~/Documents/Obsidian Vault/agent-wiki/` — structured wiki with categories | Team knowledge bases, shared context |
 | **None** | Disabled — no files written | Stateless or shared machines |
 
 ### Obsidian setup
@@ -269,7 +272,7 @@ Always use `_prefix: true` with Rails enums to avoid method name collisions.
 
 ## Development
 
-Python 3.9+ required. Build from source and run tests:
+Python 3.10+ required. Build from source and run tests:
 
 ```bash
 python -m build && pipx install dist/*.whl

{agent_notes-2.15.1 → agent_notes-2.17.0}/README.md

@@ -2,7 +2,7 @@
 
 AI agent configuration manager for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [OpenCode](https://github.com/opencode-ai/opencode).
 
-Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus plans and reasons, Sonnet executes, and Haiku explores.
+Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus 4.6 plans and reasons, Sonnet 4.6 executes, and Haiku 4.5 explores.
 
 ## Quick Start
 
@@ -56,8 +56,8 @@ Iteration loop: edit source → `python -m build` → `pipx reinstall dist/*.whl
 
 ### 3. Plugin — limited functionality
 
-- **Claude Code**: install via the Claude Code plugin marketplace.
-- **OpenCode**: copy or symlink `.opencode-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
+- **Claude Code**: install via the Claude Code plugin marketplace or copy/symlink `.claude-plugin/` into `~/.claude/plugins/agent-notes/`.
+- **OpenCode**: copy or symlink `.claude-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
 
 The plugin runs a `session.start` hook that surfaces agent-notes context to the CLI session. It does **not** include the full `agent-notes` CLI (wizard, doctor, config, memory, etc.). For those, use install method 1 or 2.
 
@@ -83,9 +83,8 @@ agent-notes <command> [options]
 
 | Command | Description |
 |---------|-------------|
-| `install [--local] [--copy]` | Interactive wizard or direct install |
-| `uninstall [--local]` | Remove installed components |
-| `update` | Pull latest, rebuild, reinstall |
+| `install [--local] [--copy] [--reconfigure]` | Interactive wizard or direct install |
+| `uninstall [--local \| --global]` | Remove installed components (both scopes by default) |
 | `doctor [--local] [--fix]` | Check installation health |
 | `info` | Show status and component counts |
 | `list [clis\|models\|roles\|agents\|skills\|rules\|all]` | List engine components or installed |
@@ -93,6 +92,7 @@ agent-notes <command> [options]
 | `regenerate [--cli <cli>]` | Rebuild files from state.json (Phase 10+) |
 | `validate` | Lint source configuration files |
 | `memory [list\|size\|show\|reset\|export\|import] [name]` | Manage agent memory |
+| `cost-report` | Show session cost breakdown by agent and model |
 
 ### Supported platforms
 
@@ -123,25 +123,25 @@ agent-notes memory add "Rails enum prefix" \
 
 ## Agent Team
 
-Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonnet 4 executes, Haiku 4.5 explores.**
+Specialized subagents with hierarchical model strategy: **Opus 4.6 decides, Sonnet 4.6 executes, Haiku 4.5 explores.**
 
 | Agent | Model | Role |
 |-------|-------|------|
-| **lead** | Opus 4.7 | Plans, delegates, reviews. Orchestrator. |
-| **architect** | Opus 4.7 | System architecture, module boundaries, domain models. Read-only. |
-| **debugger** | Opus 4.7 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
-| **coder** | Sonnet 4 | Implements features, fixes bugs, edits files. |
-| **reviewer** | Sonnet 4 | Code quality review. Read-only. |
-| **security-auditor** | Sonnet 4 | Security vulnerability analysis. Read-only. |
-| **test-writer** | Sonnet 4 | Writes tests for any framework. |
-| **test-runner** | Sonnet 4 | Diagnoses and fixes failing tests. |
-| **system-auditor** | Sonnet 4 | Codebase health: duplication, N+1, coupling. Read-only. |
-| **database-specialist** | Sonnet 4 | Schema design, indexes, query performance, migrations. Read-only. |
-| **performance-profiler** | Sonnet 4 | Response times, memory, caching, bundle size. Read-only. |
-| **devops** | Sonnet 4 | Docker, CI/CD, deployment configs. |
-| **devil** | Sonnet 4 | Challenges plans to surface hidden risks. Read-only. |
-| **integrations** | Sonnet 4 | Third-party integrations: OAuth, webhooks, payments. |
-| **refactorer** | Sonnet 4 | Improves code structure without changing behavior. |
+| **lead** | Opus 4.6 | Plans, delegates, reviews. Orchestrator. |
+| **architect** | Opus 4.6 | System architecture, module boundaries, domain models. Read-only. |
+| **debugger** | Opus 4.6 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
+| **coder** | Sonnet 4.6 | Implements features, fixes bugs, edits files. |
+| **reviewer** | Sonnet 4.6 | Code quality review. Read-only. |
+| **security-auditor** | Sonnet 4.6 | Security vulnerability analysis. Read-only. |
+| **test-writer** | Sonnet 4.6 | Writes tests for any framework. |
+| **test-runner** | Sonnet 4.6 | Diagnoses and fixes failing tests. |
+| **system-auditor** | Sonnet 4.6 | Codebase health: duplication, N+1, coupling. Read-only. |
+| **database-specialist** | Sonnet 4.6 | Schema design, indexes, query performance, migrations. Read-only. |
+| **performance-profiler** | Sonnet 4.6 | Response times, memory, caching, bundle size. Read-only. |
+| **devops** | Sonnet 4.6 | Docker, CI/CD, deployment configs. |
+| **devil** | Sonnet 4.6 | Challenges plans to surface hidden risks. Read-only. |
+| **integrations** | Sonnet 4.6 | Third-party integrations: OAuth, webhooks, payments. |
+| **refactorer** | Sonnet 4.6 | Improves code structure without changing behavior. |
 | **analyst** | Haiku 4.5 | Requirements analysis: surfaces missing or contradictory requirements. Read-only. |
 | **api-reviewer** | Haiku 4.5 | API design, versioning, error handling, backward compatibility. Read-only. |
 | **tech-writer** | Haiku 4.5 | Documentation: READMEs, API docs, changelogs. |
@@ -149,7 +149,7 @@ Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonn
 
 ## Architecture
 
-agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
+agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. Context is loaded in tiers: always-loaded (CLAUDE.md, rules, skill catalog), lazy-loaded (full skill content, agent prompts), and pull-based (memory notes). See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
 
 ## Improved Claude Code workflows
 
@@ -175,6 +175,8 @@ Four failure modes that derail AI-assisted development, and the skills that addr
 
 42 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.
+
 ### Using skills in Claude Code / OpenCode
 
 ```
@@ -192,6 +194,7 @@ Agents accumulate knowledge across sessions using one of three backends, chosen
 |---------|---------|----------|
 | **Local** | `~/.claude/agent-memory/<agent>/` — plain markdown per agent | Simple setup, no extra tools |
 | **Obsidian** | Category vault with YAML frontmatter and `[[wikilinks]]` | Visual browsing, backlinks, Dataview queries |
+| **Wiki** | `~/Documents/Obsidian Vault/agent-wiki/` — structured wiki with categories | Team knowledge bases, shared context |
 | **None** | Disabled — no files written | Stateless or shared machines |
 
 ### Obsidian setup
@@ -239,7 +242,7 @@ Always use `_prefix: true` with Rails enums to avoid method name collisions.
 
 ## Development
 
-Python 3.9+ required. Build from source and run tests:
+Python 3.10+ required. Build from source and run tests:
 
 ```bash
 python -m build && pipx install dist/*.whl

agent_notes-2.17.0/agent_notes/VERSION

@@ -0,0 +1 @@
+2.17.0

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/cli.py

@@ -237,15 +237,6 @@ def main():
     p_uninstall = subparsers.add_parser("uninstall", help="Remove installed components")
     p_uninstall.add_argument("--local", action="store_true", help="Remove from current project")
     
-    # update
-    p_update = subparsers.add_parser("update", help="Pull latest, show diff, reinstall")
-    p_update.add_argument("--dry-run", action="store_true", help="Show diff only, do not reinstall")
-    p_update.add_argument("-y", "--yes", action="store_true", help="Skip confirmation prompt")
-    p_update.add_argument("--only", action="append", choices=["agents","skills","rules","commands","config","settings"],
-        help="Filter diff to these component types (repeatable)")
-    p_update.add_argument("--since", help="Override 'before' commit label (cosmetic only for now)")
-    p_update.add_argument("--skip-pull", action="store_true", help="Skip git pull")
-    
     # doctor
     p_doctor = subparsers.add_parser("doctor", help="Check installation health")
     p_doctor.add_argument("--local", action="store_true", help="Check local installation")
@@ -325,15 +316,6 @@ def main():
     elif args.command == "uninstall":
         from .commands.install import uninstall
         uninstall(local=args.local)
-    elif args.command == "update":
-        from .commands.update import update
-        update(
-            dry_run=args.dry_run,
-            yes=args.yes,
-            only=args.only,
-            since=args.since,
-            skip_pull=args.skip_pull,
-        )
     elif args.command == "doctor":
         from .commands.doctor import doctor
         doctor(local=args.local, fix=args.fix)

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/commands/__init__.py

@@ -14,14 +14,13 @@ from . import uninstall
 from . import build
 from . import doctor
 from . import validate
-from . import update
 from . import regenerate
 from . import list as list_cmd
 from . import memory as memory_cmd
 
 __all__ = [
     "install", "uninstall", "show_info",
-    "build", "doctor", "validate", "update",
+    "build", "doctor", "validate",
     "regenerate", "set_role", "interactive_install",
     "list_cmd", "memory_cmd",
 ]

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/commands/doctor.py

@@ -62,25 +62,60 @@ def _check_session_hook(scope: str, issues: list) -> None:
         ))
 
 
+def check_version_drift(scope: str, issues: list, fix_actions: list) -> None:
+    """Check if the installed package version matches the current running version."""
+    from .. import install_state
+    from ..config import get_version
+    from ..domain.diagnostics import Issue, FixAction
+    from ..services.state_store import get_scope
+    from pathlib import Path
+
+    state = install_state.load_current_state()
+    if state is None:
+        return
+
+    project_path = Path.cwd() if scope == "local" else None
+    scope_state = get_scope(state, scope, project_path)
+    if scope_state is None:
+        return
+
+    installed_version = scope_state.installed_version
+    if not installed_version:
+        return
+
+    current_version = get_version()
+    if installed_version != current_version:
+        issues.append(Issue(
+            "version_drift",
+            "state.json",
+            f"Installed with v{installed_version} but running v{current_version}. "
+            "Run `agent-notes doctor --fix` or `agent-notes install` to update.",
+        ))
+        fix_actions.append(FixAction("_TRIGGER_INSTALL", "state.json", "reinstall to update"))
+
+
 def diagnose(scope: str, fix: bool = False) -> bool:
     """Run all diagnostic checks and optionally apply fixes."""
     from .. import install_state
-    
+
     print_summary(scope)
-    
+
     issues = []
     fix_actions = []
-    
+
     # Run checks
     check_stale_files(scope, issues, fix_actions)
-    check_broken_symlinks(scope, issues, fix_actions) 
+    check_broken_symlinks(scope, issues, fix_actions)
     check_shadowed_files(scope, issues, fix_actions)
     check_missing_files(scope, issues, fix_actions)
     check_content_drift(scope, issues, fix_actions)
-    
+
     # Build freshness check (scope-independent)
     check_build_freshness(issues, fix_actions)
 
+    # Version drift check
+    check_version_drift(scope, issues, fix_actions)
+
     # SessionStart hook check (Claude Code only)
     _check_session_hook(scope, issues)
 

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/commands/wizard.py

@@ -8,6 +8,7 @@ from .build import build
 from ._install_helpers import (
     count_agents, count_global, count_skills
 )
+from ..services.counts import count_rules_total as _count_rules_total
 from ..services.fs import place_file, place_dir_contents
 from ..services.ui import (
     _can_interactive, _safe_input, _checkbox_select, _radio_select,
@@ -79,22 +80,7 @@ def _get_skill_groups() -> Dict[str, List[str]]:
 
 def _count_rules() -> int:
     """Count rule files."""
-    # For testing, allow bypassing the registry
-    import os
-    if os.environ.get('_WIZARD_TEST_MODE'):
-        if not DIST_RULES_DIR.exists():
-            return 0
-        return len(list(DIST_RULES_DIR.glob("*.md")))
-    else:
-        try:
-            from ..registries import default_rule_registry
-            registry = default_rule_registry()
-            return len(registry.all())
-        except Exception:
-            # Fallback to old behavior if registry fails
-            if not DIST_RULES_DIR.exists():
-                return 0
-            return len(list(DIST_RULES_DIR.glob("*.md")))
+    return _count_rules_total()
 
 
 def _select_cli(step: int = 0, total: int = 0, version: str = '') -> Set[str]:
@@ -629,7 +615,27 @@ def _interactive_install() -> None:
         print(f"{Color.RED}Build failed: {e}{Color.NC}")
         return
 
-    # Execute installation
+    _execute_install(
+        clis=clis,
+        scope=scope,
+        copy_mode=copy_mode,
+        selected_skills=selected_skills,
+        role_models=role_models,
+        memory_backend=memory_backend,
+        memory_path=memory_path,
+    )
+
+
+def _execute_install(
+    clis: Set[str],
+    scope: str,
+    copy_mode: bool,
+    selected_skills: List[str],
+    role_models: Dict[str, Dict[str, str]],
+    memory_backend: str,
+    memory_path: str,
+) -> None:
+    """Run all installation steps after parameters have been collected and the build is done."""
     print(f"\nInstalling ({scope}, {'copy' if copy_mode else 'symlink'}) ...\n")
 
     from ..services import fs as _fs

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/config.py

@@ -91,56 +91,46 @@ def global_output_path(backend) -> Optional[Path]:
     return dist_dir_for(backend) / backend.layout["config"]
 
 
-# === Backward compatibility - lazy evaluation of old constants ===
-def _lazy_backend_attr(backend_name: str, attr_func):
-    """Helper for creating lazy attributes that depend on registry.
-
-    Note: at initial config-module import time, ``agent_notes.cli_backend`` is
-    NOT safe to import (circular). In that case we fall back to hardcoded
-    values that match the shipped YAMLs. Later callers who import these
-    constants after initial module load get the correct values via this same
-    function (the registry is then importable).
-    """
-    def get_attr():
-        try:
-            from .registries.cli_registry import default_registry
-            backend = default_registry().get(backend_name)
-            return attr_func(backend)
-        except (ImportError, KeyError):
-            # Fallback to hardcoded values if registry not available (e.g. circular
-            # import at initial module-load time). These match the shipped YAMLs.
-            fallbacks = {
-                'claude': {'home': Path.home() / ".claude", 'template': "global-claude.md", 'dist': "claude"},
-                'opencode': {'home': Path.home() / ".config" / "opencode", 'template': "global-opencode.md", 'dist': "opencode"},
-                'copilot': {'home': Path.home() / ".github", 'template': "global-copilot.md", 'dist': "github"},
-            }
-            fb = fallbacks.get(backend_name, {})
-            # Match by the attr_func's role — we encode intent via __name__ for named
-            # functions, or by returning the generic dist/home/template via the lambdas
-            # below (see DIST_*/GLOBAL_*/*_HOME assignments).
-            name = attr_func.__name__
-            if name == 'global_home' or name == '_fb_home':
-                return fb.get('home')
-            elif name == 'template_path' or name == '_fb_template':
-                return DATA_DIR / fb.get('template', '')
-            elif name == 'dist_dir' or name == '_fb_dist':
-                return DIST_DIR / fb.get('dist', backend_name)
-    return get_attr
-
-
-# Create backward-compatibility constants. We give the lambdas named stand-ins
-# so the fallback branch in _lazy_backend_attr can classify them correctly even
-# when the registry isn't importable yet (circular import during config init).
-def _fb_home(b):    return b.global_home
-def _fb_dist(b):    return dist_dir_for(b)
-def _fb_template(b): return global_template_path(b)
-
-CLAUDE_HOME       = _lazy_backend_attr('claude',   _fb_home)()
-OPENCODE_HOME     = _lazy_backend_attr('opencode', _fb_home)()
-GITHUB_HOME       = _lazy_backend_attr('copilot',  _fb_home)()
-DIST_CLAUDE_DIR   = _lazy_backend_attr('claude',   _fb_dist)()
-DIST_OPENCODE_DIR = _lazy_backend_attr('opencode', _fb_dist)()
-DIST_GITHUB_DIR   = _lazy_backend_attr('copilot',  _fb_dist)()
-GLOBAL_CLAUDE_MD  = _lazy_backend_attr('claude',   _fb_template)()
-GLOBAL_OPENCODE_MD = _lazy_backend_attr('opencode', _fb_template)()
-GLOBAL_COPILOT_MD = _lazy_backend_attr('copilot',  _fb_template)()
+# === Backward compatibility constants ===
+# Hardcoded fallbacks match the shipped YAMLs and protect against circular
+# imports if this module is ever imported very early in the load sequence.
+_FALLBACKS = {
+    'claude':   {'home': Path.home() / ".claude",               'template': "global-claude.md",   'dist': "claude"},
+    'opencode': {'home': Path.home() / ".config" / "opencode",  'template': "global-opencode.md", 'dist': "opencode"},
+    'copilot':  {'home': Path.home() / ".github",               'template': "global-copilot.md",  'dist': "github"},
+}
+
+
+def _backend_home(name: str) -> Path:
+    try:
+        from .registries.cli_registry import default_registry
+        return default_registry().get(name).global_home
+    except (ImportError, KeyError):
+        return _FALLBACKS[name]['home']
+
+
+def _backend_dist(name: str) -> Path:
+    try:
+        from .registries.cli_registry import default_registry
+        return dist_dir_for(default_registry().get(name))
+    except (ImportError, KeyError):
+        return DIST_DIR / _FALLBACKS[name]['dist']
+
+
+def _backend_template(name: str) -> Path:
+    try:
+        from .registries.cli_registry import default_registry
+        return global_template_path(default_registry().get(name))
+    except (ImportError, KeyError):
+        return DATA_DIR / _FALLBACKS[name]['template']
+
+
+CLAUDE_HOME        = _backend_home('claude')
+OPENCODE_HOME      = _backend_home('opencode')
+GITHUB_HOME        = _backend_home('copilot')
+DIST_CLAUDE_DIR    = _backend_dist('claude')
+DIST_OPENCODE_DIR  = _backend_dist('opencode')
+DIST_GITHUB_DIR    = _backend_dist('copilot')
+GLOBAL_CLAUDE_MD   = _backend_template('claude')
+GLOBAL_OPENCODE_MD = _backend_template('opencode')
+GLOBAL_COPILOT_MD  = _backend_template('copilot')

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/data/hooks/session-context.md.tpl

@@ -16,4 +16,4 @@ You have a specialized agent team installed. Delegate work to them — do not tr
 - Docs → tech-writer
 - Infrastructure → devops
 
-**Slash commands:** /plan /review /debug /brainstorm
+{{skills_catalog}}

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/doctor_checks.py

@@ -1,6 +1,14 @@
 """Scoped health checks for agent-notes — only touches files we own."""
 
 from __future__ import annotations
+
+__all__ = [
+    "expected_paths_for_install",
+    "check_missing",
+    "check_broken",
+    "check_drift",
+    "check_stale",
+]
 from pathlib import Path
 from typing import Optional
 

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/domain/state.py

@@ -33,6 +33,7 @@ class ScopeState:
     installed_at: str = ""
     updated_at: str = ""
     mode: str = "symlink"
+    installed_version: str = ""
     clis: dict[str, BackendState] = field(default_factory=dict)
 
 

{agent_notes-2.15.1 → agent_notes-2.17.0}/agent_notes/scripts/cost_report.py

@@ -5,6 +5,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 
 from . import _claude_backend, _opencode_backend
+from ._opencode_backend import DB as _OPENCODE_DB
 
 
 def _opencode_active() -> bool:
@@ -21,8 +22,7 @@ def _by_recency(since: float | None = None, session_id: str | None = None) -> in
         if jsonls:
             claude_mtime = max(f.stat().st_mtime for f in jsonls)
 
-    opencode_db = Path.home() / ".local" / "share" / "opencode" / "opencode.db"
-    opencode_mtime = opencode_db.stat().st_mtime if opencode_db.exists() else 0.0
+    opencode_mtime = _OPENCODE_DB.stat().st_mtime if _OPENCODE_DB.exists() else 0.0
 
     if claude_mtime == 0.0 and opencode_mtime == 0.0:
         print("No session data found (no Claude Code transcripts or OpenCode database).")

agent_notes-2.17.0/agent_notes/services/counts.py

@@ -0,0 +1,67 @@
+"""Shared counting helpers for installed components."""
+
+import os
+
+
+def count_rules_total() -> int:
+    """Count total available rule files (for wizard display).
+
+    Uses the rule registry when available; falls back to counting .md files
+    directly from the dist rules directory.
+    """
+    from ..config import DIST_RULES_DIR
+
+    if os.environ.get('_WIZARD_TEST_MODE'):
+        if not DIST_RULES_DIR.exists():
+            return 0
+        return len(list(DIST_RULES_DIR.glob("*.md")))
+
+    try:
+        from ..registries import default_rule_registry
+        registry = default_rule_registry()
+        return len(registry.all())
+    except Exception:
+        if not DIST_RULES_DIR.exists():
+            return 0
+        return len(list(DIST_RULES_DIR.glob("*.md")))
+
+
+def count_skills(backend, scope: str) -> tuple:
+    """Count (installed, expected) skills for a CLI backend. Excludes broken symlinks."""
+    from . import installer
+    from ..config import DIST_SKILLS_DIR
+
+    if not backend.supports("skills"):
+        return 0, 0
+
+    skills_dir = installer.target_dir_for(backend, "skills", scope)
+    if skills_dir and skills_dir.exists():
+        installed = len([d for d in skills_dir.iterdir() if d.is_dir() and d.exists()])
+    else:
+        installed = 0
+
+    expected = (
+        len([d for d in DIST_SKILLS_DIR.iterdir() if d.is_dir()])
+        if DIST_SKILLS_DIR and DIST_SKILLS_DIR.exists()
+        else 0
+    )
+    return installed, expected
+
+
+def count_rules(backend, scope: str) -> tuple:
+    """Count (installed, expected) rules for a CLI backend."""
+    from . import installer
+    from ..config import DIST_RULES_DIR
+
+    if not backend.supports("rules"):
+        return 0, 0
+
+    rules_dir = installer.target_dir_for(backend, "rules", scope)
+    installed = len(list(rules_dir.glob("*.md"))) if rules_dir and rules_dir.exists() else 0
+
+    expected = (
+        len(list(DIST_RULES_DIR.glob("*.md")))
+        if DIST_RULES_DIR and DIST_RULES_DIR.exists()
+        else 0
+    )
+    return installed, expected