agent-borg 3.2.0__tar.gz → 3.2.2__tar.gz

{agent_borg-3.2.0 → agent_borg-3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-borg
-Version: 3.2.0
+Version: 3.2.2
 Summary: Collective memory for AI coding agents — your agent learns from every session
 Author-email: Hermes Team <aleshbrown@gmail.com>
 License-Expression: MIT
@@ -39,12 +39,33 @@ Requires-Dist: agent-borg[crypto,defi,dev,embeddings]; extra == "all"
 
 # Borg
 
-**Your AI coding agent forgets everything between sessions. Borg remembers.**
+**A Python/Django debugging expert that's honest about what it doesn't know.**
 
 [![PyPI](https://img.shields.io/pypi/v/agent-borg)](https://pypi.org/project/agent-borg/)
-[![Tests](https://img.shields.io/badge/tests-2862%20passed-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-2872%20passed-brightgreen)]()
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)]()
 
+> **v3.2.2 honesty patch.** Earlier versions of `borg debug` would route any
+> error containing the substring "Error" to a Django migration pack — including
+> Rust, Go, Docker, and JavaScript errors. v3.2.2 deletes that fallback and
+> adds a non-Python language guard. Borg now refuses to give a Python answer
+> to a non-Python error and tells you so explicitly. JS/TS, Rust, Go,
+> Docker, and Kubernetes pack coverage is on the roadmap (see
+> `docs/20260408-0623_classifier_prd/`). If you are a Python/Django developer
+> `borg debug` should still help; if you are not, we would rather say
+> "we don't know yet" than give you a confidently wrong answer.
+
+---
+
+## Get Started in 30 Seconds
+
+```bash
+pip install agent-borg
+borg start
+```
+
+That's it. Paste an error, get structured debugging guidance. No config, no API keys, works offline.
+
 ---
 
 ## 10-Second Demo
@@ -117,9 +138,9 @@ Borg is collective memory. When one agent solves a problem, every agent learns.
 
 ## Features
 
-- **Instant debugging** — paste any error, get root cause + fix + anti-patterns
+- **Python/Django expert** — 12 hand-authored packs covering migrations, schema drift, imports, types, permissions, timeouts, and more
+- **Honest about scope** — non-Python errors return "no match" rather than wrong advice
 - **Works offline** — no API calls, no cloud, runs locally
-- **Collective learning** — fixes improve from real agent outcomes
 - **Platform export** — one command to generate .cursorrules, .clinerules, CLAUDE.md, or .windsurfrules
 - **17 MCP tools** — plug into any MCP-compatible agent
 - **Task guidance** — get step-by-step approaches before you start coding
@@ -164,8 +185,8 @@ borg generate systematic-debugging --format windsurf
 ## Quick Start
 
 ```bash
-# 1. Debug an error
-borg debug "TypeError: Cannot read properties of undefined (reading 'map')"
+# 1. Debug a Python/Django error
+borg debug "django.db.utils.OperationalError: no such column: app_user.email"
 
 # 2. Get task guidance before you start
 borg observe "refactor authentication to use JWT tokens"
@@ -177,7 +198,7 @@ borg search "docker networking"
 borg generate systematic-debugging --format cursor
 
 # 5. Classify an error without full guidance
-borg debug --classify "ECONNREFUSED 127.0.0.1:5432"
+borg debug --classify "django.db.utils.OperationalError: no such column"
 ```
 
 ---

{agent_borg-3.2.0 → agent_borg-3.2.2}/README.md

@@ -1,11 +1,32 @@
 # Borg
 
-**Your AI coding agent forgets everything between sessions. Borg remembers.**
+**A Python/Django debugging expert that's honest about what it doesn't know.**
 
 [![PyPI](https://img.shields.io/pypi/v/agent-borg)](https://pypi.org/project/agent-borg/)
-[![Tests](https://img.shields.io/badge/tests-2862%20passed-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-2872%20passed-brightgreen)]()
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)]()
 
+> **v3.2.2 honesty patch.** Earlier versions of `borg debug` would route any
+> error containing the substring "Error" to a Django migration pack — including
+> Rust, Go, Docker, and JavaScript errors. v3.2.2 deletes that fallback and
+> adds a non-Python language guard. Borg now refuses to give a Python answer
+> to a non-Python error and tells you so explicitly. JS/TS, Rust, Go,
+> Docker, and Kubernetes pack coverage is on the roadmap (see
+> `docs/20260408-0623_classifier_prd/`). If you are a Python/Django developer
+> `borg debug` should still help; if you are not, we would rather say
+> "we don't know yet" than give you a confidently wrong answer.
+
+---
+
+## Get Started in 30 Seconds
+
+```bash
+pip install agent-borg
+borg start
+```
+
+That's it. Paste an error, get structured debugging guidance. No config, no API keys, works offline.
+
 ---
 
 ## 10-Second Demo
@@ -78,9 +99,9 @@ Borg is collective memory. When one agent solves a problem, every agent learns.
 
 ## Features
 
-- **Instant debugging** — paste any error, get root cause + fix + anti-patterns
+- **Python/Django expert** — 12 hand-authored packs covering migrations, schema drift, imports, types, permissions, timeouts, and more
+- **Honest about scope** — non-Python errors return "no match" rather than wrong advice
 - **Works offline** — no API calls, no cloud, runs locally
-- **Collective learning** — fixes improve from real agent outcomes
 - **Platform export** — one command to generate .cursorrules, .clinerules, CLAUDE.md, or .windsurfrules
 - **17 MCP tools** — plug into any MCP-compatible agent
 - **Task guidance** — get step-by-step approaches before you start coding
@@ -125,8 +146,8 @@ borg generate systematic-debugging --format windsurf
 ## Quick Start
 
 ```bash
-# 1. Debug an error
-borg debug "TypeError: Cannot read properties of undefined (reading 'map')"
+# 1. Debug a Python/Django error
+borg debug "django.db.utils.OperationalError: no such column: app_user.email"
 
 # 2. Get task guidance before you start
 borg observe "refactor authentication to use JWT tokens"
@@ -138,7 +159,7 @@ borg search "docker networking"
 borg generate systematic-debugging --format cursor
 
 # 5. Classify an error without full guidance
-borg debug --classify "ECONNREFUSED 127.0.0.1:5432"
+borg debug --classify "django.db.utils.OperationalError: no such column"
 ```
 
 ---

{agent_borg-3.2.0 → agent_borg-3.2.2}/agent_borg.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-borg
-Version: 3.2.0
+Version: 3.2.2
 Summary: Collective memory for AI coding agents — your agent learns from every session
 Author-email: Hermes Team <aleshbrown@gmail.com>
 License-Expression: MIT
@@ -39,12 +39,33 @@ Requires-Dist: agent-borg[crypto,defi,dev,embeddings]; extra == "all"
 
 # Borg
 
-**Your AI coding agent forgets everything between sessions. Borg remembers.**
+**A Python/Django debugging expert that's honest about what it doesn't know.**
 
 [![PyPI](https://img.shields.io/pypi/v/agent-borg)](https://pypi.org/project/agent-borg/)
-[![Tests](https://img.shields.io/badge/tests-2862%20passed-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-2872%20passed-brightgreen)]()
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)]()
 
+> **v3.2.2 honesty patch.** Earlier versions of `borg debug` would route any
+> error containing the substring "Error" to a Django migration pack — including
+> Rust, Go, Docker, and JavaScript errors. v3.2.2 deletes that fallback and
+> adds a non-Python language guard. Borg now refuses to give a Python answer
+> to a non-Python error and tells you so explicitly. JS/TS, Rust, Go,
+> Docker, and Kubernetes pack coverage is on the roadmap (see
+> `docs/20260408-0623_classifier_prd/`). If you are a Python/Django developer
+> `borg debug` should still help; if you are not, we would rather say
+> "we don't know yet" than give you a confidently wrong answer.
+
+---
+
+## Get Started in 30 Seconds
+
+```bash
+pip install agent-borg
+borg start
+```
+
+That's it. Paste an error, get structured debugging guidance. No config, no API keys, works offline.
+
 ---
 
 ## 10-Second Demo
@@ -117,9 +138,9 @@ Borg is collective memory. When one agent solves a problem, every agent learns.
 
 ## Features
 
-- **Instant debugging** — paste any error, get root cause + fix + anti-patterns
+- **Python/Django expert** — 12 hand-authored packs covering migrations, schema drift, imports, types, permissions, timeouts, and more
+- **Honest about scope** — non-Python errors return "no match" rather than wrong advice
 - **Works offline** — no API calls, no cloud, runs locally
-- **Collective learning** — fixes improve from real agent outcomes
 - **Platform export** — one command to generate .cursorrules, .clinerules, CLAUDE.md, or .windsurfrules
 - **17 MCP tools** — plug into any MCP-compatible agent
 - **Task guidance** — get step-by-step approaches before you start coding
@@ -164,8 +185,8 @@ borg generate systematic-debugging --format windsurf
 ## Quick Start
 
 ```bash
-# 1. Debug an error
-borg debug "TypeError: Cannot read properties of undefined (reading 'map')"
+# 1. Debug a Python/Django error
+borg debug "django.db.utils.OperationalError: no such column: app_user.email"
 
 # 2. Get task guidance before you start
 borg observe "refactor authentication to use JWT tokens"
@@ -177,7 +198,7 @@ borg search "docker networking"
 borg generate systematic-debugging --format cursor
 
 # 5. Classify an error without full guidance
-borg debug --classify "ECONNREFUSED 127.0.0.1:5432"
+borg debug --classify "django.db.utils.OperationalError: no such column"
 ```
 
 ---

{agent_borg-3.2.0 → agent_borg-3.2.2}/borg/__init__.py

@@ -1,6 +1,6 @@
 """Borg — Collective intelligence for AI coding agents."""
 
-__version__ = "3.2.0"
+__version__ = "3.2.2"
 
 
 def check(context: str, constraints: dict = None, top_k: int = 3) -> list:

{agent_borg-3.2.0 → agent_borg-3.2.2}/borg/cli.py

@@ -335,6 +335,73 @@ def _cmd_debug(args: argparse.Namespace) -> int:
     return 0
 
 
+def _cmd_start(args: argparse.Namespace) -> int:
+    """Interactive onboarding — get value from borg in 30 seconds."""
+    print()
+    print("  ╔══════════════════════════════════════════════════╗")
+    print("  ║          Welcome to the Borg Collective          ║")
+    print("  ╚══════════════════════════════════════════════════╝")
+    print()
+    print("  Your agent forgets everything between sessions.")
+    print("  Borg remembers.")
+    print()
+    print("  ── Try it now ─────────────────────────────────────")
+    print()
+    print("  Paste any error message you're dealing with:")
+    print()
+
+    try:
+        error = input("  > ").strip()
+    except (EOFError, KeyboardInterrupt):
+        print()
+        return 0
+
+    if not error:
+        print()
+        print("  No error entered. Try:")
+        print("    borg debug 'your error message here'")
+        print()
+        return 0
+
+    # Run debug
+    from borg.core.pack_taxonomy import debug_error
+    print()
+    result = debug_error(error, show_evidence=True)
+    print(result)
+
+    # Auto-record feedback
+    try:
+        from borg.core.pack_taxonomy import classify_error
+        from borg.core.v3_integration import BorgV3
+        pc = classify_error(error)
+        if pc:
+            v3 = BorgV3(db_path="~/.hermes/guild/borg_v3.db")
+            v3.record_outcome(
+                pack_id=pc,
+                task_context={"task_category": pc, "source": "borg_start"},
+                success=True,
+                tokens_used=0,
+                time_taken=0.0,
+            )
+    except Exception:
+        pass
+
+    # Next steps
+    print()
+    print("  ── What's next ───────────────────────────────────")
+    print()
+    print("  • Run again anytime:   borg debug 'your error'")
+    print("  • Browse workflows:    borg search debugging")
+    print("  • Export for Cursor:   borg generate systematic-debugging --format cursorrules")
+    print("  • Export for Claude:   borg setup-claude")
+    print("  • Record what worked:  borg feedback-v3 --pack systematic-debugging --success yes")
+    print()
+    print("  The more you use borg, the smarter it gets.")
+    print("  Resistance is futile.")
+    print()
+    return 0
+
+
 def _cmd_convert(args: argparse.Namespace) -> int:
     """Convert a SKILL.md, CLAUDE.md, or .cursorrules file to a workflow pack."""
     import yaml
@@ -907,12 +974,11 @@ def main() -> int:
         description="Borg — Semantic reasoning cache for AI agents.",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""Quick Start:
-  borg search debugging          Search for debugging packs
-  borg try systematic-debugging  Preview a pack before using it
-  borg apply systematic-debugging --task 'fix failing test'
-                                  Apply a pack to your task
-  borg list                      List locally installed packs
-  borg debug 'TypeError: ...'    Get structured debugging guidance
+  borg start                     First time? Start here — paste an error, get a fix
+  borg debug 'TypeError: ...'    Get structured debugging guidance for any error
+  borg search debugging          Search for workflow packs
+  borg generate systematic-debugging --format cursorrules
+                                  Export a debugging workflow for Cursor
   borg setup-claude              Configure borg MCP for Claude Code
   borg setup-cursor              Configure borg MCP for Cursor
   borg autopilot                 Zero-config setup for Hermes""",
@@ -1138,6 +1204,16 @@ def main() -> int:
   borg setup-cursor""")
     p.set_defaults(func=_cmd_setup_cursor)
 
+    # borg start — interactive onboarding
+    p = sub.add_parser("start", help="Get started — paste an error, get a fix in 30 seconds",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""Examples:
+  borg start              Interactive onboarding — paste an error, get guidance
+  
+First time? Just run:
+  pip install agent-borg && borg start""")
+    p.set_defaults(func=_cmd_start)
+
     args = parser.parse_args()
 
     if args.command is None:

{agent_borg-3.2.0 → agent_borg-3.2.2}/borg/core/pack_taxonomy.py

@@ -79,10 +79,109 @@ _ERROR_KEYWORDS: List[Tuple[str, str]] = [
     # Schema drift
     ("OperationalError", "schema_drift"),
     ("SyncError", "schema_drift"),
-    # Generic
-    ("Error", "schema_drift"),
+    # NOTE: v3.2.2 — the bare ("Error", "schema_drift") fallback was removed.
+    # It was a generic substring trap that routed every error containing the
+    # word "error" — Rust E0382, Docker ENOSPC, Go panics, JS TypeError — to
+    # the Django schema_drift pack. See docs/20260408-0623_classifier_prd/
+    # for the full PRD and the new confidence-gated classifier roadmap.
 ]
 
+
+# -----------------------------------------------------------------------
+# Phase 0 language detection — non-Python locking signals
+# -----------------------------------------------------------------------
+# Each entry is a regex that, if matched, locks the input to a specific
+# non-Python language. Phase 0 only needs to detect "this is definitely
+# NOT Python" so classify_error can refuse to answer instead of routing
+# to a Python/Django pack. Phase 1 (ARCHITECTURE_SPEC.md §5.1) replaces
+# this with a full multi-language detection cascade.
+import re as _re
+
+_NON_PYTHON_LOCKING_SIGNALS: List[Tuple[str, "_re.Pattern[str]"]] = [
+    # Rust — rustc error codes and borrow checker
+    ("rust", _re.compile(r"error\[E\d{4}\]")),
+    ("rust", _re.compile(r"\bborrow checker\b", _re.IGNORECASE)),
+    ("rust", _re.compile(r"borrow of moved value", _re.IGNORECASE)),
+    ("rust", _re.compile(r"\bcargo (build|run|test|check)\b")),
+    ("rust", _re.compile(r"\brustc\b")),
+    ("rust", _re.compile(r"does not live long enough")),
+    ("rust", _re.compile(r"cannot borrow .* as mutable")),
+    # Go — runtime panics, goroutines, modules
+    ("go", _re.compile(r"\bgoroutine \d+ \[")),
+    ("go", _re.compile(r"panic: runtime error")),
+    ("go", _re.compile(r"invalid memory address or nil pointer dereference")),
+    ("go", _re.compile(r"\bgo\.mod\b")),
+    ("go", _re.compile(r"go: cannot find module")),
+    # JavaScript / Node.js
+    ("javascript", _re.compile(r"Cannot read propert(?:y|ies) of (?:null|undefined)")),
+    ("javascript", _re.compile(r"\bReferenceError\b.*is not defined")),
+    ("javascript", _re.compile(r"UnhandledPromiseRejectionWarning")),
+    ("javascript", _re.compile(r"\bnode_modules\b")),
+    ("javascript", _re.compile(r"at .*\.(?:js|mjs|cjs):\d+")),
+    ("javascript", _re.compile(r"npm ERR!")),
+    # TypeScript — compiler errors
+    ("typescript", _re.compile(r"\bTS\d{4}\b")),
+    ("typescript", _re.compile(r"is not assignable to type")),
+    ("typescript", _re.compile(r"\.tsx?:\d+:\d+")),
+    # React / Next.js
+    ("react", _re.compile(r"Hydration failed because", _re.IGNORECASE)),
+    ("react", _re.compile(r"Text content does not match server-rendered HTML")),
+    ("react", _re.compile(r"Invalid hook call")),
+    ("react", _re.compile(r"Each child in a list should have a unique \"key\" prop")),
+    # Docker / BuildKit
+    ("docker", _re.compile(r"\bENOSPC\b")),
+    ("docker", _re.compile(r"no space left on device", _re.IGNORECASE)),
+    ("docker", _re.compile(r"failed to solve:")),
+    ("docker", _re.compile(r"^docker:", _re.MULTILINE)),
+    ("docker", _re.compile(r"COPY failed:")),
+    ("docker", _re.compile(r"manifest unknown")),
+    # Kubernetes
+    ("kubernetes", _re.compile(r"CrashLoopBackOff")),
+    ("kubernetes", _re.compile(r"ImagePullBackOff")),
+    ("kubernetes", _re.compile(r"ErrImagePull")),
+    ("kubernetes", _re.compile(r"OOMKilled")),
+    ("kubernetes", _re.compile(r"\bkubectl\b")),
+    ("kubernetes", _re.compile(r"FailedScheduling")),
+]
+
+# Python "positive lock" signals — if any of these match we KEEP processing
+# Python keywords even if a non-Python signal also fires (polyglot logs).
+_PYTHON_LOCKING_SIGNALS: List["_re.Pattern[str]"] = [
+    _re.compile(r"Traceback \(most recent call last\)"),
+    _re.compile(r"\bpython3?(?:\.\d+)?\b"),
+    _re.compile(r"\.py:\d+"),
+    _re.compile(r"\bmanage\.py\b"),
+    _re.compile(r"\bdjango\."),
+    _re.compile(r"\bflask\b", _re.IGNORECASE),
+    _re.compile(r"\bfastapi\b", _re.IGNORECASE),
+    _re.compile(r"\bpip install\b"),
+    _re.compile(r"ModuleNotFoundError: No module named"),
+]
+
+
+def _detect_language_quick(error_message: str) -> Optional[str]:
+    """Phase 0 language detector — return non-Python language if locked.
+
+    Returns one of {'rust','go','javascript','typescript','react','docker',
+    'kubernetes'} when a high-confidence non-Python signal fires AND no
+    Python locking signal also fires. Returns None otherwise (which means
+    "Python or unknown — proceed with the legacy keyword table").
+
+    Phase 1 will replace this with the full cascade in
+    ARCHITECTURE_SPEC.md §4.3 / §5.1.
+    """
+    if not error_message:
+        return None
+    # If any Python locking signal fires, treat as Python (keep current behaviour).
+    for pat in _PYTHON_LOCKING_SIGNALS:
+        if pat.search(error_message):
+            return None
+    # Otherwise, the first non-Python locking signal wins.
+    for lang, pat in _NON_PYTHON_LOCKING_SIGNALS:
+        if pat.search(error_message):
+            return lang
+    return None
+
 # Canonical list of all known problem classes (must match seed pack filenames)
 PROBLEM_CLASSES: List[str] = [
     "circular_dependency",
@@ -187,11 +286,25 @@ def classify_error(error_message: str) -> Optional[str]:
     """
     Classify an error message string into a problem_class.
 
-    Uses keyword matching against ERROR_KEYWORDS.
-    Returns the first matching problem_class, or None if no match.
+    v3.2.2 (Phase 0 of the multi-language classifier roadmap):
+    1. Detect non-Python locking signals (Rust E0xxx, Go panic, JS
+       Cannot read properties of, TS####, React Hydration failed,
+       Docker ENOSPC, Kubernetes CrashLoopBackOff, etc.). If any
+       fire, return None ("we don't know yet, refusing to give a
+       Python answer to a non-Python error").
+    2. Otherwise fall back to the legacy substring keyword table
+       (Python/Django coverage unchanged).
+
+    Phase 1+ (ARCHITECTURE_SPEC.md §3-§7) replaces this with a
+    confidence-scored Match | UnknownMatch dataclass return type.
+
+    See docs/20260408-0623_classifier_prd/ for the full PRD.
     """
     if not error_message:
         return None
+    # Phase 0 language guard — refuse to answer non-Python errors.
+    if _detect_language_quick(error_message) is not None:
+        return None
     lower = error_message.lower()
     for keyword, problem_class in _ERROR_KEYWORDS:
         if keyword.lower() in lower:
@@ -393,17 +506,43 @@ def debug_error(error_message: str, show_evidence: bool = True) -> str:
         show_evidence: Include evidence stats in output
 
     Returns:
-        Formatted guidance string, or a "no pack found" message if
-        no matching problem_class is found.
+        Formatted guidance string, or an "I don't know yet" UnknownMatch
+        block when no matching problem_class is found. v3.2.2 (Phase 0)
+        explicitly refuses to print Python/Django guidance for detected
+        non-Python errors — it returns the UnknownMatch block instead.
     """
+    # Phase 0: detect non-Python languages first so the UnknownMatch
+    # block can name the language we DID detect.
+    detected_lang = _detect_language_quick(error_message) if error_message else None
+
     # Step 1: classify
     problem_class = classify_error(error_message)
 
     if not problem_class:
+        lang_line = (
+            f"Detected language: {detected_lang}. "
+            "Borg currently has Python/Django expert packs only.\n"
+            f"v3.2.2 refuses to give a Python answer to a {detected_lang} "
+            "error — see docs/20260408-0623_classifier_prd/ for the\n"
+            "multi-language classifier roadmap."
+        ) if detected_lang else (
+            "Borg's current packs are Python/Django specific.\n"
+            "If your error is Python/Django, try pasting more of the traceback."
+        )
         return (
-            "No matching problem class found.\n"
-            "Try: borg debug <your-error-message>\n"
-            "Known problem classes: " + ", ".join(PROBLEM_CLASSES)
+            "============================================================\n"
+            f"ERROR: {error_message[:120]}{'...' if len(error_message) > 120 else ''}\n"
+            "============================================================\n"
+            "[unknown] No matching problem class found.\n"
+            "\n"
+            f"{lang_line}\n"
+            "\n"
+            "Known Python/Django problem classes:\n"
+            "  " + ", ".join(PROBLEM_CLASSES) + "\n"
+            "\n"
+            "Help us add coverage for your language:\n"
+            "  https://github.com/bensargotest-sys/agent-borg/issues/new\n"
+            "============================================================"
         )
 
     # Step 2: load pack

{agent_borg-3.2.0 → agent_borg-3.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-borg"
-version = "3.2.0"
+version = "3.2.2"
 description = "Collective memory for AI coding agents — your agent learns from every session"
 readme = "README.md"
 license = "MIT"