agent-borg 3.3.2__tar.gz → 3.3.3__tar.gz

{agent_borg-3.3.2 → agent_borg-3.3.3}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Borg contributors
+Copyright (c) 2026 Borg Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

agent_borg-3.3.3/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: agent-borg
+Version: 3.3.3
+Summary: Collective memory MCP server for AI coding agents
+Project-URL: Homepage, https://github.com/borg-farther/Borg-Directory
+Project-URL: Repository, https://github.com/borg-farther/Borg-Directory
+Project-URL: Documentation, https://github.com/borg-farther/Borg-Directory#readme
+Project-URL: Issues, https://github.com/borg-farther/Borg-Directory/issues
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Requires-Dist: numpy>=1.24.0; extra == "semantic"
+Requires-Dist: scikit-learn>=1.3.0; extra == "semantic"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
+Requires-Dist: numpy>=1.24.0; extra == "embeddings"
+Requires-Dist: scikit-learn>=1.3.0; extra == "embeddings"
+Provides-Extra: crypto
+Requires-Dist: pynacl>=1.5.0; extra == "crypto"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pytest>=8.0.0; extra == "all"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
+Requires-Dist: numpy>=1.24.0; extra == "all"
+Requires-Dist: scikit-learn>=1.3.0; extra == "all"
+Requires-Dist: pynacl>=1.5.0; extra == "all"
+Dynamic: license-file

agent_borg-3.3.3/README.md

@@ -0,0 +1,259 @@
+# Borg — collective memory for AI agents
+
+**Install:** `pip install agent-borg`  
+**CLI:** `borg`  
+**MCP server:** `borg-mcp`  
+**Canonical repo:** https://github.com/borg-farther/Borg-Directory
+
+Borg helps coding agents avoid rediscovering the same fixes and dead ends. When an agent hits an error, it can check Borg first, get prior guidance, and record whether the guidance helped.
+
+Borg is not marketed here as a magic success-rate booster. Current local security/readiness gates are green; statistically significant external agent-level lift is still unproven.
+
+---
+
+## 1. Install
+
+```bash
+python3 -m pip install agent-borg
+borg version
+borg-doctor --json
+```
+
+Expected first check:
+
+```text
+borg version   # prints the installed version, currently 3.3.3 in this repo
+borg-doctor    # returns ok=true / PASS-style checks when the install is healthy
+```
+
+For isolated installs:
+
+```bash
+pipx install agent-borg
+```
+
+For controlled or offline environments, pre-download wheels on a connected machine and install from that local wheelhouse:
+
+```bash
+python -m pip download agent-borg -d ./wheelhouse
+python -m pip install --no-index --find-links ./wheelhouse agent-borg
+```
+
+Optional extras:
+
+```bash
+pip install 'agent-borg[embeddings]'   # semantic search
+pip install 'agent-borg[crypto]'       # Ed25519 signing support
+pip install 'agent-borg[all]'          # dev + semantic + crypto
+```
+
+Requires Python 3.10+.
+
+---
+
+## 2. One-command Claude setup
+
+```bash
+borg setup-claude --scope user --verify --fix
+```
+
+What this does:
+
+1. Finds the MCP launch command.
+2. Creates Borg home storage if missing.
+3. Writes user-level Claude MCP config.
+4. Runs an MCP initialize verification.
+5. Prints a binary pass/fail result with remediation if something is wrong.
+
+If your agent config needs manual MCP wiring, use this:
+
+```json
+{
+  "mcpServers": {
+    "borg": {
+      "command": "borg-mcp",
+      "args": [],
+      "env": { "BORG_HOME": "/absolute/path/to/.borg" }
+    }
+  }
+}
+```
+
+Fallback if `borg-mcp` is not on PATH:
+
+```json
+{
+  "mcpServers": {
+    "borg": {
+      "command": "python3",
+      "args": ["-m", "borg.integrations.mcp_server"],
+      "env": { "BORG_HOME": "/absolute/path/to/.borg" }
+    }
+  }
+}
+```
+
+Use absolute paths in MCP env blocks. Do not rely on `~` expansion inside MCP clients.
+
+---
+
+## 3. First useful commands
+
+```bash
+# Fastest day-one value: paste an error, get ACTION / STOP / VERIFY
+borg rescue "ModuleNotFoundError: No module named flask"
+
+# Pipe failing command output into Borg
+pytest -q 2>&1 | borg rescue --json
+
+# Interactive onboarding uses the same rescue engine
+borg start
+
+# First-10 beta contract / readiness packet
+borg first-10
+borg first-10 --json
+
+# Search existing guidance
+borg search "django migration table already exists"
+
+# Preview a workflow pack safely
+borg try borg://hermes/systematic-debugging
+
+# Pull the pack locally
+borg pull borg://hermes/systematic-debugging
+
+# Apply it to a real task
+borg apply systematic-debugging --task "Fix Django migration table already exists error"
+
+# After completion, generate feedback
+borg feedback <session_id>
+```
+
+For Python callers:
+
+```python
+import borg
+
+hits = borg.check("TypeError: unsupported operand type(s)", top_k=3)
+for hit in hits:
+    print(hit.get("name"), hit.get("tier"))
+```
+
+---
+
+## 4. Agent instruction / priming
+
+Put this in your project `CLAUDE.md`, agent system prompt, or first user message:
+
+```text
+Before attempting technical fixes for errors, bugs, installs, configs, deployments, or tests, call Borg first. Prefer borg_rescue(input="<exact error or failing command output>") when there is a concrete failure; use borg_observe(task="<exact task or error>", context="<tech stack>") at task start. Treat Borg output as advisory: follow ACTION when relevant, avoid STOP/AVOID patterns, and disclose when retrieved guidance is weak or does not fit. After the fix, call borg_rate(helpful=True/False) or record the outcome.
+```
+
+Why: agents often do not discover optional tools unless explicitly primed.
+
+---
+
+## 5. MCP tools
+
+Core tools available through the MCP server include:
+
+- `borg_rescue` — agent-ready ACTION / STOP / VERIFY packet for concrete failures
+- `borg_observe` — passive guidance before a technical fix
+- `borg_search` — search packs / traces
+- `borg_try` — preview a pack before saving
+- `borg_pull` — fetch and validate a pack
+- `borg_apply` — phase-by-phase execution
+- `borg_feedback` — structured feedback artifact
+- `borg_suggest` — suggest after repeated failures
+- `borg_convert` — convert skills/rules into Borg-compatible artifacts
+- `borg_publish` — publish artifacts with safety gates
+- `borg_first_10` — first-10 beta gates, smoke path, priming paragraph, feedback fields
+
+Use `borg_rescue` for concrete errors/failing command output. Use `borg_observe` first for broader debugging/config/install/deploy/test tasks.
+
+---
+
+## 6. What is proven right now
+
+Current local gate snapshot in this repo:
+
+- Version consistency: PASS
+- First-user install surface: PASS
+- Security/privacy/prompt-injection surface: PASS
+- Learning-atom safety tests: PASS
+- Local 10/100/1000 logical-user soak: PASS
+- Latest focused verification: source + wheel + PyPI first-user gates must pass; first-user public launch remains gated by real external-user evidence
+
+Canonical local artifacts:
+
+- [`PROJECT_STATUS.md`](PROJECT_STATUS.md)
+- [`GO_NO_GO_DECISION.md`](GO_NO_GO_DECISION.md)
+- [`docs/20260504-1123_BORG_PRODUCTION_1000_READINESS_STATUS.md`](docs/20260504-1123_BORG_PRODUCTION_1000_READINESS_STATUS.md)
+- [`docs/FIRST_10_BETA_READINESS.md`](docs/FIRST_10_BETA_READINESS.md)
+- [`eval/uat_scoreboard_snapshot.json`](eval/uat_scoreboard_snapshot.json)
+- [`docs/SECURITY_HARDENING_BASELINE.md`](docs/SECURITY_HARDENING_BASELINE.md)
+- [`docs/PRIVACY_MODEL.md`](docs/PRIVACY_MODEL.md)
+- [`docs/PROMPT_INJECTION_THREAT_MODEL.md`](docs/PROMPT_INJECTION_THREAT_MODEL.md)
+- [`docs/TRUST_AND_PROMOTION.md`](docs/TRUST_AND_PROMOTION.md)
+- [`docs/REVOCATION_AND_DELETION.md`](docs/REVOCATION_AND_DELETION.md)
+
+---
+
+## 7. Honest limitations
+
+Not yet proven:
+
+- Statistically significant agent-level success lift.
+- Real external-user network effects.
+- Global/federated multi-node reliability.
+- Broad non-Python generalization.
+- Navigation cache as a shipped first-user feature.
+
+Security boundary:
+
+- Learning atoms are signed, privacy-scanned, prompt-injection scanned, and revocable.
+- Ed25519 primitives exist, but do not interpret that as “every pack from every source is cryptographically trusted” unless the specific command reports verified signature state.
+
+---
+
+## 8. For evaluators
+
+If you are evaluating Borg, run this exact smoke path from a clean environment:
+
+```bash
+python3 -m venv /tmp/borg-smoke
+. /tmp/borg-smoke/bin/activate
+python -m pip install --upgrade pip
+python -m pip install agent-borg
+borg version
+borg-doctor --json
+borg search "django migration table already exists"
+borg first-10 --json
+python - <<'PY'
+import borg
+print(borg.check('TypeError: unsupported operand type(s)', top_k=2))
+PY
+```
+
+Then connect MCP using `borg setup-claude --scope user --verify --fix` or the manual config above.
+
+A good first evaluation is whether Borg reduces redundant investigation, not whether it magically solves every bug.
+
+---
+
+## 9. Development verification
+
+From a source checkout:
+
+```bash
+python -m pytest -q borg/tests/test_public_api_check.py borg/tests/test_version_consistency.py borg/tests/test_runtime_doctor.py
+python scripts/security_gate_check.py
+BORG_READINESS_SOAK_SECONDS=5 python eval/run_readiness_gates.py
+python eval/uat_scoreboard.py
+```
+
+---
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).

agent_borg-3.3.3/agent_borg.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: agent-borg
+Version: 3.3.3
+Summary: Collective memory MCP server for AI coding agents
+Project-URL: Homepage, https://github.com/borg-farther/Borg-Directory
+Project-URL: Repository, https://github.com/borg-farther/Borg-Directory
+Project-URL: Documentation, https://github.com/borg-farther/Borg-Directory#readme
+Project-URL: Issues, https://github.com/borg-farther/Borg-Directory/issues
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Requires-Dist: numpy>=1.24.0; extra == "semantic"
+Requires-Dist: scikit-learn>=1.3.0; extra == "semantic"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
+Requires-Dist: numpy>=1.24.0; extra == "embeddings"
+Requires-Dist: scikit-learn>=1.3.0; extra == "embeddings"
+Provides-Extra: crypto
+Requires-Dist: pynacl>=1.5.0; extra == "crypto"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pytest>=8.0.0; extra == "all"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
+Requires-Dist: numpy>=1.24.0; extra == "all"
+Requires-Dist: scikit-learn>=1.3.0; extra == "all"
+Requires-Dist: pynacl>=1.5.0; extra == "all"
+Dynamic: license-file

{agent_borg-3.3.2 → agent_borg-3.3.3}/agent_borg.egg-info/SOURCES.txt

@@ -18,20 +18,24 @@ borg/benchmarks/tasks.py
 borg/benchmarks/tests/__init__.py
 borg/benchmarks/tests/test_benchmarks.py
 borg/cli/__init__.py
+borg/cli/__main__.py
 borg/cli/doctor.py
 borg/cli/install.py
 borg/core/__init__.py
-borg/core/action_policy.py
 borg/core/agentskills_converter.py
 borg/core/aggregator.py
 borg/core/apply.py
+borg/core/atom_policy.py
+borg/core/atom_retrieval.py
+borg/core/atom_store.py
+borg/core/atom_tenant.py
 borg/core/bm25_index.py
-borg/core/canonical_truth.py
 borg/core/causal.py
 borg/core/changes.py
 borg/core/clustering.py
 borg/core/cold_start.py
 borg/core/conditions.py
+borg/core/confidence_gate.py
 borg/core/contextual_selector.py
 borg/core/convert.py
 borg/core/crypto.py
@@ -39,22 +43,21 @@ borg/core/dirs.py
 borg/core/embeddings.py
 borg/core/failure_memory.py
 borg/core/feedback_loop.py
+borg/core/first_user_readiness.py
 borg/core/generate.py
 borg/core/generator.py
+borg/core/learning_atoms.py
 borg/core/mutation_engine.py
 borg/core/negative_traces.py
 borg/core/openclaw_converter.py
-borg/core/outcome_ledger.py
 borg/core/pack_taxonomy.py
 borg/core/privacy.py
+borg/core/prompt_injection.py
 borg/core/proof_gates.py
-borg/core/provider_router.py
 borg/core/publish.py
-borg/core/quality_gate.py
-borg/core/rate_limiter.py
-borg/core/response_formatter.py
+borg/core/rescue.py
+borg/core/runtime_fingerprint.py
 borg/core/safety.py
-borg/core/sanitizer.py
 borg/core/schema.py
 borg/core/search.py
 borg/core/seed_loader.py
@@ -63,7 +66,6 @@ borg/core/semantic_search.py
 borg/core/session.py
 borg/core/signals.py
 borg/core/stack.py
-borg/core/status.py
 borg/core/synthesis.py
 borg/core/telemetry.py
 borg/core/temporal.py
@@ -77,99 +79,6 @@ borg/db/embeddings.py
 borg/db/migrations.py
 borg/db/reputation.py
 borg/db/store.py
-borg/defi/__init__.py
-borg/defi/alpha_signal.py
-borg/defi/cli.py
-borg/defi/data_models.py
-borg/defi/dojo_bridge.py
-borg/defi/liquidation_watcher.py
-borg/defi/lp_manager.py
-borg/defi/mcp_tools.py
-borg/defi/portfolio_monitor.py
-borg/defi/risk_engine.py
-borg/defi/strategy_backtester.py
-borg/defi/strategy_selector.py
-borg/defi/swap_executor.py
-borg/defi/whale_tracker.py
-borg/defi/yield_scanner.py
-borg/defi/api_clients/__init__.py
-borg/defi/api_clients/alchemy.py
-borg/defi/api_clients/arkham.py
-borg/defi/api_clients/base.py
-borg/defi/api_clients/birdeye.py
-borg/defi/api_clients/cache.py
-borg/defi/api_clients/defillama.py
-borg/defi/api_clients/dexscreener.py
-borg/defi/api_clients/goplus.py
-borg/defi/api_clients/helius.py
-borg/defi/cron/__init__.py
-borg/defi/cron/alpha_cron.py
-borg/defi/cron/delivery.py
-borg/defi/cron/liquidation_cron.py
-borg/defi/cron/live_scans.py
-borg/defi/cron/portfolio_cron.py
-borg/defi/cron/risk_cron.py
-borg/defi/cron/state.py
-borg/defi/cron/whale_cron.py
-borg/defi/cron/yield_cron.py
-borg/defi/mev/__init__.py
-borg/defi/mev/flashbots.py
-borg/defi/mev/jito.py
-borg/defi/security/__init__.py
-borg/defi/security/keystore.py
-borg/defi/security/tx_guard.py
-borg/defi/tests/__init__.py
-borg/defi/tests/test_alchemy.py
-borg/defi/tests/test_alpha_signal.py
-borg/defi/tests/test_api_clients.py
-borg/defi/tests/test_arkham.py
-borg/defi/tests/test_base_client.py
-borg/defi/tests/test_cache.py
-borg/defi/tests/test_cli.py
-borg/defi/tests/test_cron.py
-borg/defi/tests/test_cron_delivery.py
-borg/defi/tests/test_cron_state.py
-borg/defi/tests/test_data_models.py
-borg/defi/tests/test_dojo_bridge.py
-borg/defi/tests/test_e2e_live.py
-borg/defi/tests/test_goplus.py
-borg/defi/tests/test_keystore_unit.py
-borg/defi/tests/test_liquidation_watcher.py
-borg/defi/tests/test_live_scans.py
-borg/defi/tests/test_lp_manager.py
-borg/defi/tests/test_mcp_tools.py
-borg/defi/tests/test_mev.py
-borg/defi/tests/test_portfolio_monitor.py
-borg/defi/tests/test_risk_engine.py
-borg/defi/tests/test_strategy_backtester.py
-borg/defi/tests/test_strategy_selector.py
-borg/defi/tests/test_swap_executor.py
-borg/defi/tests/test_tx_guard_unit.py
-borg/defi/tests/test_v2_borg_bridge.py
-borg/defi/tests/test_v2_circuit_breaker.py
-borg/defi/tests/test_v2_drift.py
-borg/defi/tests/test_v2_integration.py
-borg/defi/tests/test_v2_models.py
-borg/defi/tests/test_v2_outcome_store.py
-borg/defi/tests/test_v2_pack_store.py
-borg/defi/tests/test_v2_recommender.py
-borg/defi/tests/test_v2_reputation.py
-borg/defi/tests/test_v2_seed_packs.py
-borg/defi/tests/test_v2_warnings.py
-borg/defi/tests/test_whale_tracker.py
-borg/defi/tests/test_yield_scanner.py
-borg/defi/v2/__init__.py
-borg/defi/v2/borg_bridge.py
-borg/defi/v2/circuit_breaker.py
-borg/defi/v2/daily_brief.py
-borg/defi/v2/drift.py
-borg/defi/v2/models.py
-borg/defi/v2/outcome_store.py
-borg/defi/v2/pack_store.py
-borg/defi/v2/recommender.py
-borg/defi/v2/reputation.py
-borg/defi/v2/seed_packs.py
-borg/defi/v2/warnings.py
 borg/dojo/__init__.py
 borg/dojo/auto_fixer.py
 borg/dojo/cron_runner.py
@@ -217,8 +126,6 @@ borg/seeds_data/systematic-debugging.md
 borg/seeds_data/test-driven-development.md
 borg/seeds_data/timeout-hang.md
 borg/seeds_data/type-mismatch.md
-borg/seeds_data/borg/SKILL.md
-borg/seeds_data/borg-autopilot/SKILL.md
 borg/seeds_data/packs/bash-permission-denied.yaml
 borg/seeds_data/packs/django-circular-dependency.yaml
 borg/seeds_data/packs/django-migration-state.yaml
@@ -229,29 +136,43 @@ borg/seeds_data/packs/git-merge-conflict.yaml
 borg/seeds_data/packs/pytest-flaky-test.yaml
 borg/seeds_data/packs/python-import-cycle.yaml
 borg/seeds_data/packs/python-missing-dependency.yaml
+borg/seeds_data/packs/systematic-debugging.workflow.yaml
 borg/tests/__init__.py
 borg/tests/test_agent_hook.py
 borg/tests/test_aggregator.py
 borg/tests/test_analytics.py
 borg/tests/test_apply.py
+borg/tests/test_atom_policy.py
+borg/tests/test_atom_retrieval_firewall.py
+borg/tests/test_atom_store.py
+borg/tests/test_atom_tenant.py
+borg/tests/test_borg_observe_confidence_gate.py
+borg/tests/test_borg_observe_wrapper.py
 borg/tests/test_change_awareness.py
 borg/tests/test_classify_error.py
 borg/tests/test_cli.py
+borg/tests/test_cli_atom.py
 borg/tests/test_conditions.py
+borg/tests/test_confidence_gate.py
 borg/tests/test_contextual_selector.py
 borg/tests/test_convert.py
 borg/tests/test_convert_openclaw.py
 borg/tests/test_dirs.py
+borg/tests/test_distribution_readiness.py
 borg/tests/test_dojo_pipeline.py
 borg/tests/test_e2e_learning_loop.py
 borg/tests/test_e2e_learning_loop_v3.py
+borg/tests/test_embeddings_schema_compat.py
 borg/tests/test_failure_memory.py
 borg/tests/test_feedback_loop.py
+borg/tests/test_first_10_readiness.py
+borg/tests/test_first_user_cli_contract.py
 borg/tests/test_fleet_syncer.py
 borg/tests/test_generate.py
 borg/tests/test_generator.py
 borg/tests/test_golden_queries.py
-borg/tests/test_invariants.py
+borg/tests/test_learning_atom_publish.py
+borg/tests/test_learning_atoms.py
 borg/tests/test_mcp_hardening.py
 borg/tests/test_mcp_server.py
 borg/tests/test_mcp_server_extended.py
@@ -260,22 +181,29 @@ borg/tests/test_nudge.py
 borg/tests/test_observe_search_roundtrip.py
 borg/tests/test_openclaw_converter.py
 borg/tests/test_pack_compatibility.py
-borg/tests/test_perf_candidate_cache.py
 borg/tests/test_privacy.py
+borg/tests/test_privacy_structured.py
+borg/tests/test_prompt_injection.py
 borg/tests/test_proof_gates.py
+borg/tests/test_public_api_check.py
 borg/tests/test_publish.py
 borg/tests/test_publish_flow_debug.py
 borg/tests/test_publish_flow_integration.py
 borg/tests/test_publish_sybil.py
 borg/tests/test_pull_network.py
+borg/tests/test_release_packaging_contract.py
 borg/tests/test_reputation.py
 borg/tests/test_reputation_integration.py
+borg/tests/test_rescue.py
+borg/tests/test_runtime_doctor.py
+borg/tests/test_runtime_fingerprint.py
 borg/tests/test_safety.py
 borg/tests/test_schema.py
 borg/tests/test_search.py
 borg/tests/test_semantic_search.py
 borg/tests/test_session.py
 borg/tests/test_start_signals.py
+borg/tests/test_storage_paths.py
 borg/tests/test_store.py
 borg/tests/test_store_concurrency.py
 borg/tests/test_telemetry.py

{agent_borg-3.3.2 → agent_borg-3.3.3}/agent_borg.egg-info/entry_points.txt

@@ -2,3 +2,4 @@
 borg = borg.cli:main
 borg-doctor = borg.cli.doctor:run_doctor
 borg-install = borg.cli.install:main
+borg-mcp = borg.integrations.mcp_server:main

agent_borg-3.3.3/agent_borg.egg-info/requires.txt

@@ -0,0 +1,24 @@
+pyyaml>=6.0
+
+[all]
+pytest>=8.0.0
+sentence-transformers>=2.2.0
+numpy>=1.24.0
+scikit-learn>=1.3.0
+pynacl>=1.5.0
+
+[crypto]
+pynacl>=1.5.0
+
+[dev]
+pytest>=8.0.0
+
+[embeddings]
+sentence-transformers>=2.2.0
+numpy>=1.24.0
+scikit-learn>=1.3.0
+
+[semantic]
+sentence-transformers>=2.2.0
+numpy>=1.24.0
+scikit-learn>=1.3.0

agent_borg-3.3.3/borg/__init__.py

@@ -0,0 +1,49 @@
+"""Borg — collective memory for AI coding agents.
+
+The top-level :func:`check` helper is intentionally tiny, but it must be real:
+it is the first API many agents try after ``import borg``.  Returning an empty
+placeholder silently destroys first-user value, so this wrapper delegates to the
+same search path used by the CLI/MCP server and fails closed with an empty list
+only when the search layer itself is unavailable.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+__version__ = "3.3.3"
+
+
+def check(context: str, constraints: dict | None = None, top_k: int = 3) -> list[dict[str, Any]]:
+    """Return relevant Borg memories/packs for ``context``.
+
+    Args:
+        context: Error text, task description, or debugging context.
+        constraints: Optional hints. Supported keys today:
+            ``mode`` (``text``/``semantic``/``hybrid``), ``agent_id``.
+        top_k: Maximum number of results to return.
+
+    Returns:
+        A list of result dictionaries from ``borg.core.search.borg_search``.
+        Empty means no confident match or search unavailable; it no longer means
+        "API not implemented".
+    """
+    if not context or not str(context).strip():
+        return []
+    hints = constraints or {}
+    mode = str(hints.get("mode", "hybrid"))
+    agent_id = hints.get("agent_id")
+    try:
+        from borg.core.search import borg_search
+
+        raw = borg_search(str(context), mode=mode, requesting_agent_id=agent_id)
+        payload = json.loads(raw) if isinstance(raw, str) else raw
+        if not isinstance(payload, dict) or not payload.get("success"):
+            return []
+        matches = payload.get("matches", [])
+        if not isinstance(matches, list):
+            return []
+        return [m for m in matches[: max(0, int(top_k))] if isinstance(m, dict)]
+    except Exception:
+        return []

agent_borg-3.3.3/borg/cli/__init__.py

@@ -0,0 +1,11 @@
+"""Load legacy CLI implementation into package namespace.
+
+This keeps `import borg.cli` patch-friendly for tests that monkeypatch
+symbols like `borg.cli.load_session` and `borg.cli.get_borg_dir`.
+"""
+
+from pathlib import Path
+
+_cli_py_path = Path(__file__).parents[1] / "cli.py"
+_source = _cli_py_path.read_text(encoding="utf-8")
+exec(compile(_source, str(_cli_py_path), "exec"), globals(), globals())

agent_borg-3.3.3/borg/cli/__main__.py

@@ -0,0 +1,11 @@
+"""Module execution support for ``python -m borg.cli``."""
+
+from __future__ import annotations
+
+import sys
+
+from . import main
+
+
+if __name__ == "__main__":
+    sys.exit(main())