agent-notes 2.23.0__tar.gz → 2.25.0__tar.gz

{agent_notes-2.23.0 → agent_notes-2.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-notes
-Version: 2.23.0
+Version: 2.25.0
 Summary: AI agent configuration manager for Claude Code, OpenCode, and Copilot
 Author-email: Eugene Naumov <min.verkligheten@gmail.com>
 License-Expression: MIT
@@ -42,7 +42,7 @@ agent-notes doctor
 
 **What's Included**
 - 19 specialized AI subagents (Opus reasons, Sonnet executes, Haiku explores)
-- 42+ on-demand skills (Rails, Docker, Git, Kamal, Process)
+- 47+ on-demand skills (Rails, Docker, Git, Kamal, Process)
 - Global rules and guardrails
 - Agent memory with 3 storage options (Local, Obsidian, Wiki)
 - Configuration for Claude Code, OpenCode, and GitHub Copilot
@@ -267,7 +267,7 @@ Implements Karpathy's LLM Wiki pattern (v1). Auto-creates a folder per project (
 
 - **Query** — Search wiki pages, synthesize answers with citations, optionally file answers back as new pages
 
-- **Lint** — Health-check for contradictions, stale claims, orphan pages, missing cross-references
+- **Lint** — Health-check for contradictions, stale pages, data gaps, orphan pages, missing cross-references
 
 **Commands:**
 ```bash
@@ -312,7 +312,7 @@ The installed `CLAUDE.md` already points agents to your vault. At the start of a
 <details>
 <summary>Skills</summary>
 
-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/`.
+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/`.
 
 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.
 
@@ -342,6 +342,11 @@ Load the docker-compose skill for multi-service setup
 - `/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
+- `/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)
+- `/prototype` — Throwaway prototypes: terminal app for logic or UI variations for visual
+- `/write-a-skill` — Meta-skill for creating new skills with proper structure
 
 </details>
 

{agent_notes-2.23.0 → agent_notes-2.25.0}/README.md

@@ -12,7 +12,7 @@ agent-notes doctor
 
 **What's Included**
 - 19 specialized AI subagents (Opus reasons, Sonnet executes, Haiku explores)
-- 42+ on-demand skills (Rails, Docker, Git, Kamal, Process)
+- 47+ on-demand skills (Rails, Docker, Git, Kamal, Process)
 - Global rules and guardrails
 - Agent memory with 3 storage options (Local, Obsidian, Wiki)
 - Configuration for Claude Code, OpenCode, and GitHub Copilot
@@ -237,7 +237,7 @@ Implements Karpathy's LLM Wiki pattern (v1). Auto-creates a folder per project (
 
 - **Query** — Search wiki pages, synthesize answers with citations, optionally file answers back as new pages
 
-- **Lint** — Health-check for contradictions, stale claims, orphan pages, missing cross-references
+- **Lint** — Health-check for contradictions, stale pages, data gaps, orphan pages, missing cross-references
 
 **Commands:**
 ```bash
@@ -282,7 +282,7 @@ The installed `CLAUDE.md` already points agents to your vault. At the start of a
 <details>
 <summary>Skills</summary>
 
-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/`.
+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/`.
 
 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.
 
@@ -312,6 +312,11 @@ Load the docker-compose skill for multi-service setup
 - `/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
+- `/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)
+- `/prototype` — Throwaway prototypes: terminal app for logic or UI variations for visual
+- `/write-a-skill` — Meta-skill for creating new skills with proper structure
 
 </details>
 

agent_notes-2.25.0/agent_notes/VERSION

@@ -0,0 +1 @@
+2.25.0

{agent_notes-2.23.0 → agent_notes-2.25.0}/agent_notes/cli.py

@@ -226,6 +226,12 @@ def main():
     p_install.add_argument("--copy", action="store_true", help="Copy instead of symlink (with --local)")
     p_install.add_argument("--reconfigure", action="store_true",
         help="Clear existing state for this scope and re-run the wizard")
+    p_install.add_argument("--profile", metavar="LABEL",
+        help="Profile label for multi-subscription setups (e.g. work, personal)")
+    p_install.add_argument("--folder", metavar="DIR",
+        help="Local folder name override (e.g. .claude-work)")
+    p_install.add_argument("--global-home", metavar="DIR", dest="global_home",
+        help="Global home directory override (e.g. ~/.claude-work)")
     
     # build
     subparsers.add_parser("build", help="Build agent configuration files from source")
@@ -234,6 +240,11 @@ 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 only")
     p_uninstall.add_argument("--global", action="store_true", dest="global_", help="Remove from global scope only")
+    profile_group = p_uninstall.add_mutually_exclusive_group()
+    profile_group.add_argument("--profile", metavar="LABEL",
+        help="Profile label to uninstall (e.g. work)")
+    profile_group.add_argument("--all-profiles", action="store_true",
+        help="Uninstall all profiles for the target scope")
     
     # doctor
     p_doctor = subparsers.add_parser("doctor", help="Check installation health")
@@ -267,6 +278,7 @@ def main():
     p_regen.add_argument("--scope", choices=["global", "local"], help="Install scope")
     p_regen.add_argument("--cli", help="Regenerate specific CLI only")
     p_regen.add_argument("--local", action="store_true", help="Use local scope")
+    p_regen.add_argument("--profile", metavar="LABEL", help="Profile label")
     
     # memory
     p_memory = subparsers.add_parser("memory", help="Manage agent memory")
@@ -275,6 +287,12 @@ def main():
         help="Memory action")
     p_memory.add_argument("name", nargs="?", help="Agent name / note title (for show/reset/add)")
     p_memory.add_argument("extra", nargs="*", help="Additional args (for add: body [type] [agent] [project])")
+    p_memory.add_argument("--description", default="", help="One-liner description for index display")
+
+    # hook
+    p_hook = subparsers.add_parser("hook", help="Claude Code hook integrations")
+    p_hook.add_argument("subaction", choices=["memory-bridge", "session-discover"],
+        help="Hook to run")
 
     # cost-report
     p_cost_report = subparsers.add_parser("cost-report", help="Report token usage and cost for the current AI session")
@@ -284,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"],
+        choices=["wizard", "show", "role-model", "role-agent", "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)")
@@ -305,15 +323,24 @@ def main():
         from .commands.build import build
         build()
     elif args.command == "install":
-        if args.local or args.copy:
+        if args.local or args.copy or args.profile or args.folder or args.global_home:
             from .commands.install import install
-            install(local=args.local, copy=args.copy, reconfigure=args.reconfigure)
+            install(
+                local=args.local, copy=args.copy, reconfigure=args.reconfigure,
+                profile_label=args.profile or "",
+                folder=args.folder or "",
+                global_home=args.global_home or "",
+            )
         else:
             from .commands.wizard import interactive_install
             interactive_install()
     elif args.command == "uninstall":
+        all_profiles = getattr(args, 'all_profiles', False)
+        profile_label = getattr(args, 'profile', '') or ""
         from .commands.install import uninstall
-        uninstall(local=args.local, global_=args.global_)
+        uninstall(local=args.local, global_=args.global_,
+                  profile_label=profile_label,
+                  all_profiles=all_profiles)
     elif args.command == "doctor":
         from .commands.doctor import doctor
         doctor(local=args.local, fix=args.fix)
@@ -332,13 +359,17 @@ def main():
             set_role(args.role_name, args.model_id, cli=args.cli, scope=args.scope, local=args.local)
     elif args.command == "regenerate":
         from .commands.regenerate import regenerate
-        regenerate(scope=args.scope, cli=args.cli, local=args.local)
+        regenerate(scope=args.scope, cli=args.cli, local=args.local,
+                   profile_label=getattr(args, 'profile', '') or "")
     elif args.command == "memory":
         from .commands.memory import memory
-        memory(args.action, args.name, getattr(args, "extra", None))
+        memory(args.action, args.name, getattr(args, "extra", None), description=getattr(args, "description", ""))
     elif args.command == "config":
         from .commands.config import config
         config(action=args.action, args=getattr(args, "extra", None) or [], cli_filter=args.cli)
+    elif args.command == "hook":
+        from .commands.hook import hook
+        hook(args.subaction)
     elif args.command == "cost-report":
         # Rebuild sys.argv slice so cost_report.main() can parse it normally
         argv = []

{agent_notes-2.23.0 → agent_notes-2.25.0}/agent_notes/commands/config.py

@@ -194,8 +194,13 @@ def show(state=None) -> None:
     else:
         mem_label = "Disabled"
 
+    from ..services.user_config import load_user_config
+    cost_report_enabled = load_user_config().get("cost_report_enabled", False)
+    cost_report_label = "enabled" if cost_report_enabled else "disabled"
+
     print("Current configuration:")
-    print(f"  Memory:   {mem_label}")
+    print(f"  Memory:      {mem_label}")
+    print(f"  Cost report: {cost_report_label}")
 
     # Scopes
     scopes = []
@@ -465,6 +470,17 @@ def interactive_config_memory() -> None:
     _wizard_memory(state, before)
 
 
+def cost_report_toggle(value: str) -> None:
+    """Enable or disable cost reporting in user config."""
+    from ..services.user_config import load_user_config, save_user_config
+    cfg = load_user_config()
+    cfg["cost_report_enabled"] = (value == "on")
+    save_user_config(cfg)
+    state_label = "enabled" if value == "on" else "disabled"
+    print(f"Cost reporting {state_label}.")
+    print("Run 'agent-notes regenerate' to update generated rules.")
+
+
 # ── Entry point ──────────────────────────────────────────────────────────────
 
 def config(action: str = "wizard", args: Optional[list] = None, cli_filter: Optional[str] = None) -> None:
@@ -497,7 +513,12 @@ def config(action: str = "wizard", args: Optional[list] = None, cli_filter: Opti
         _wizard_provider_status(args[0])
     elif action == "memory":
         interactive_config_memory()
+    elif action == "cost-report":
+        if len(args) != 1 or args[0] not in ("on", "off"):
+            print("Usage: agent-notes config cost-report <on|off>")
+            sys.exit(1)
+        cost_report_toggle(args[0])
     else:
         print(f"Unknown config action: {action}")
-        print("Actions: wizard, show, role-model, role-agent, providers, provider, memory")
+        print("Actions: wizard, show, role-model, role-agent, providers, provider, memory, cost-report")
         sys.exit(1)

{agent_notes-2.23.0 → agent_notes-2.25.0}/agent_notes/commands/doctor.py

@@ -1,5 +1,7 @@
 """Health check for agent-notes installation."""
 
+from pathlib import Path
+
 # Re-export for backward compatibility. New code should import from agent_notes.domain.
 from ..domain.diagnostics import Issue, FixAction  # noqa: F401
 
@@ -53,13 +55,38 @@ def _check_session_hook(scope: str, issues: list) -> None:
     except KeyError:
         return
 
-    settings_path, _context_file, hook_command = _session_hook_paths(claude_backend, scope)
-    if not has_hook(settings_path, "SessionStart", hook_command):
-        issues.append(Issue(
-            "missing_hook",
-            str(settings_path),
-            "SessionStart hook not found — run: agent-notes install to re-add the hook",
-        ))
+    from ..services.state_store import load_state, get_profiles_for_project
+    state = load_state()
+
+    # Check all profiles for the current project (local scope) or default (global)
+    backends_to_check = [claude_backend]
+    if state and scope == "local":
+        for _key, ss in get_profiles_for_project(state, Path.cwd()):
+            bs = ss.clis.get("claude")
+            if bs and bs.local_dir_override:
+                backends_to_check.append(claude_backend.with_local_dir(bs.local_dir_override))
+
+    for backend in backends_to_check:
+        settings_path, _context_file, hook_command = _session_hook_paths(backend, scope)
+        if not settings_path.exists():
+            continue
+        if not has_hook(settings_path, "SessionStart", hook_command):
+            issues.append(Issue(
+                "missing_hook",
+                str(settings_path),
+                "SessionStart hook not found — run: agent-notes install to re-add the hook",
+            ))
+
+    # Memory bridge check on the default backend only
+    settings_path, _, _ = _session_hook_paths(claude_backend, scope)
+    from ..constants import Hooks
+    if state and state.memory.backend in ("obsidian", "wiki"):
+        if settings_path.exists() and not has_hook(settings_path, "SessionStart", Hooks.MEMORY_BRIDGE):
+            issues.append(Issue(
+                "missing_hook",
+                str(settings_path),
+                "memory-bridge SessionStart hook not found — run: agent-notes install to re-add",
+            ))
 
 
 def check_version_drift(scope: str, issues: list, fix_actions: list) -> None:
@@ -100,12 +127,31 @@ def diagnose(scope: str, fix: bool = False) -> bool:
     issues = []
     fix_actions = []
 
-    # Run checks
-    check_stale_files(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)
+    from ..services.state_store import load_current_state, get_profiles_for_project
+    from ..services.state_store import label_from_key
+
+    # For local scope, run checks against each installed profile
+    if scope == "local":
+        state = load_current_state()
+        profiles = []
+        if state:
+            profiles = get_profiles_for_project(state, Path.cwd().resolve())
+        # Fall back to default profile if none recorded
+        if not profiles:
+            profiles = [("", None)]
+        for key, _ss in profiles:
+            label = label_from_key(key, Path.cwd())
+            check_stale_files(scope, issues, fix_actions, profile_label=label)
+            check_broken_symlinks(scope, issues, fix_actions, profile_label=label)
+            check_shadowed_files(scope, issues, fix_actions, profile_label=label)
+            check_missing_files(scope, issues, fix_actions, profile_label=label)
+            check_content_drift(scope, issues, fix_actions, profile_label=label)
+    else:
+        check_stale_files(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)
@@ -117,7 +163,6 @@ def diagnose(scope: str, fix: bool = False) -> bool:
     _check_session_hook(scope, issues)
 
     # Print role→model assignments
-    from ..services.state_store import load_current_state
     state = load_current_state()
     if state is not None:
         _check_role_models(state)

agent_notes-2.25.0/agent_notes/commands/hook.py

@@ -0,0 +1,69 @@
+"""Hook command - Claude Code hook integrations."""
+
+from pathlib import Path
+
+
+def hook(subaction: str) -> None:
+    """Handle hook subactions."""
+    if subaction == "memory-bridge":
+        _memory_bridge()
+    elif subaction == "session-discover":
+        _session_discover()
+
+
+def _session_discover() -> None:
+    """Discover all agent-notes profiles for the current project and emit combined context."""
+    try:
+        from ..services.state_store import load_state, get_profiles_for_project
+        from ..registries.cli_registry import load_registry
+
+        state = load_state()
+        if state is None:
+            return
+
+        registry = load_registry()
+        default_local_dirs = {b.name: b.local_dir for b in registry.all()}
+
+        for key, scope_state in get_profiles_for_project(state, Path.cwd()):
+            for cli_name, backend_state in scope_state.clis.items():
+                local_dir = backend_state.local_dir_override or default_local_dirs.get(cli_name, ".claude")
+                context_file = Path(local_dir) / "agent-notes-context.md"
+                if context_file.exists():
+                    label = scope_state.profile_label or "default"
+                    print(f"<!-- agent-notes profile: {label} -->")
+                    print(context_file.read_text(encoding="utf-8"))
+    except Exception:
+        return
+
+
+def _memory_bridge() -> None:
+    """SessionStart hook that prints the agent-notes memory index.
+
+    Unconditionally loads and prints the memory index so it is visible in
+    context at the start of every Claude Code session.
+    """
+    try:
+        from .memory._common import _load_memory_config
+        from ..constants import Obsidian, Wiki
+
+        backend, path = _load_memory_config()
+
+        if backend == "none" or backend is None:
+            return
+
+        if backend == "obsidian":
+            index_file = Path(path) / Obsidian.INDEX
+        elif backend == "wiki":
+            index_file = Path(path) / Wiki.DIR / Wiki.INDEX
+        else:
+            # local and any unknown backends: use Index.md at root
+            index_file = Path(path) / "Index.md"
+
+        if not index_file.exists():
+            return
+
+        content = index_file.read_text(encoding="utf-8")
+        print("<!-- agent-notes memory index (auto-loaded) -->")
+        print(content)
+    except Exception:
+        return

{agent_notes-2.23.0 → agent_notes-2.25.0}/agent_notes/commands/info.py

@@ -73,10 +73,30 @@ def show_info() -> None:
         else:
             print("  Global:   none")
 
+        # Named global profiles
+        if st.global_installs:
+            for label, gs in sorted(st.global_installs.items()):
+                print(f"  Global [{label}]: installed {gs.installed_at}, {gs.mode}")
+                if gs.clis:
+                    backend_summaries = []
+                    for backend_name, bs in sorted(gs.clis.items()):
+                        parts = []
+                        for component_type, items in bs.installed.items():
+                            if items:
+                                parts.append(f"{len(items)} {component_type}")
+                        if parts:
+                            extra = ""
+                            if bs.global_home_override:
+                                extra = f", home={bs.global_home_override}"
+                            backend_summaries.append(f"{backend_name} ({', '.join(parts)}{extra})")
+                    if backend_summaries:
+                        print(f"            Storage: {', '.join(backend_summaries)}")
+
         # Local installs
         if st.local_installs:
             for project_path, ls in sorted(st.local_installs.items()):
-                print(f"  Local:    {project_path}  (installed {ls.installed_at}, {ls.mode})")
+                profile_hint = f" [{ls.profile_label}]" if ls.profile_label else ""
+                print(f"  Local{profile_hint}:  {project_path}  (installed {ls.installed_at}, {ls.mode})")
                 if ls.clis:
                     backend_summaries = []
                     for backend_name, bs in sorted(ls.clis.items()):
@@ -85,7 +105,10 @@ def show_info() -> None:
                             if items:
                                 counts.append(f"{len(items)} {component_type}")
                         if counts:
-                            backend_summaries.append(f"{backend_name} ({', '.join(counts)})")
+                            extra = ""
+                            if bs.local_dir_override:
+                                extra = f", folder={bs.local_dir_override}"
+                            backend_summaries.append(f"{backend_name} ({', '.join(counts)}{extra})")
                     if backend_summaries:
                         print(f"            Storage: {', '.join(backend_summaries)}")
         else: