shellbrain 0.1.48__tar.gz → 0.1.49__tar.gz

{shellbrain-0.1.48 → shellbrain-0.1.49}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.48
+Version: 0.1.49
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -69,7 +69,7 @@ The episodic layer is truth. Empirical memory extracts. Concept memory abstracts
 
 ### Recall
 
-**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief**, with sources cited.
+**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief** for the task at hand.
 
 Recall receives only the quoted query, so include the relevant task, failure, subsystem, or decision naturally in the question.
 
@@ -92,14 +92,7 @@ Response shape:
       "anchors": ["`README.md`"],
       "conflicts": ["..."],
       "gaps": ["..."],
-      "next_checks": ["..."],
-      "sources": [
-        {
-          "kind": "memory",
-          "id": "...",
-          "section": "direct"
-        }
-      ]
+      "next_checks": ["..."]
     },
     "fallback_reason": null
   },

{shellbrain-0.1.48 → shellbrain-0.1.49}/README.md

@@ -55,7 +55,7 @@ The episodic layer is truth. Empirical memory extracts. Concept memory abstracts
 
 ### Recall
 
-**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief**, with sources cited.
+**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief** for the task at hand.
 
 Recall receives only the quoted query, so include the relevant task, failure, subsystem, or decision naturally in the question.
 
@@ -78,14 +78,7 @@ Response shape:
       "anchors": ["`README.md`"],
       "conflicts": ["..."],
       "gaps": ["..."],
-      "next_checks": ["..."],
-      "sources": [
-        {
-          "kind": "memory",
-          "id": "...",
-          "section": "direct"
-        }
-      ]
+      "next_checks": ["..."]
     },
     "fallback_reason": null
   },

{shellbrain-0.1.48 → shellbrain-0.1.49}/app/core/use_cases/retrieval/build_context/execute.py

@@ -174,10 +174,7 @@ def _provider_result(
 
     read_trace = _read_trace(inner_agent_result)
     source_items = _source_items_from_read_trace(read_trace)
-    brief = _normalize_provider_brief(
-        inner_agent_result.brief or {},
-        deterministic_sources=_sources_from_source_items(source_items),
-    )
+    brief = _normalize_provider_brief(inner_agent_result.brief or {})
     fallback_reason = (
         "no_candidates"
         if not source_items and _read_trace_no_context_reason(read_trace)
@@ -271,10 +268,7 @@ def _deterministic_graph_result(
     )
     if synthesis_result.status == "ok" and synthesis_result.brief is not None:
         return RecallMemoryResult(
-            brief=_normalize_provider_brief(
-                synthesis_result.brief,
-                deterministic_sources=_sources_from_source_items(source_items),
-            ),
+            brief=_normalize_provider_brief(synthesis_result.brief),
             fallback_reason=None,
             telemetry={
                 "candidate_pack": graph_pack,
@@ -432,16 +426,13 @@ def _no_context_brief() -> dict[str, Any]:
         "conflicts": [],
         "gaps": ["Shellbrain has no relevant memories or concepts for this query."],
         "next_checks": [],
-        "sources": [],
     }
 
 
-def _normalize_provider_brief(
-    brief: dict[str, Any], *, deterministic_sources: list[dict[str, Any]]
-) -> dict[str, Any]:
+def _normalize_provider_brief(brief: dict[str, Any]) -> dict[str, Any]:
     """Ensure provider output keeps the stable worker-facing brief shape."""
 
-    normalized = {
+    return {
         "summary": str(brief.get("summary") or "").strip()
         or "Shellbrain synthesized relevant recall context.",
         "constraints": _string_list(brief.get("constraints")),
@@ -452,9 +443,7 @@ def _normalize_provider_brief(
         "conflicts": _string_list(brief.get("conflicts")),
         "gaps": _string_list(brief.get("gaps")),
         "next_checks": _string_list(brief.get("next_checks")),
-        "sources": deterministic_sources,
     }
-    return normalized
 
 
 def _string_list(value: Any) -> list[str]:
@@ -589,7 +578,6 @@ def _source_items_from_read_trace(read_trace: dict[str, Any]) -> list[dict[str,
                 "source_kind": source_kind,
                 "source_id": source_id,
                 "input_section": "inner_agent.read_trace",
-                "output_section": "sources",
             }
         )
         ordinal += 1
@@ -604,29 +592,12 @@ def _source_items_from_read_trace(read_trace: dict[str, Any]) -> list[dict[str,
                 "source_kind": "concept",
                 "source_id": concept_ref,
                 "input_section": "inner_agent.read_trace",
-                "output_section": "sources",
             }
         )
         ordinal += 1
     return items
 
 
-def _sources_from_source_items(
-    source_items: list[dict[str, Any]]
-) -> list[dict[str, Any]]:
-    """Render brief sources from telemetry provenance rows."""
-
-    return [
-        {
-            "kind": item["source_kind"],
-            "id": item["source_id"],
-            "section": item["input_section"],
-        }
-        for item in source_items
-        if item.get("output_section") is not None
-    ]
-
-
 def _read_trace_no_context_reason(read_trace: dict[str, Any]) -> str | None:
     """Return an explicit no-context reason from provider trace, when present."""
 

{shellbrain-0.1.48 → shellbrain-0.1.49}/app/core/use_cases/retrieval/deterministic_graph_recall.py

@@ -220,7 +220,6 @@ def deterministic_brief_from_graph_pack(pack: dict[str, Any]) -> dict[str, Any]:
             "conflicts": [],
             "gaps": ["Shellbrain has no relevant memories or concepts for this query."],
             "next_checks": [],
-            "sources": [],
         }
     concept_items = concepts + neighbors
     constraints = _brief_memory_texts(
@@ -265,7 +264,6 @@ def deterministic_brief_from_graph_pack(pack: dict[str, Any]) -> dict[str, Any]:
         ),
         "gaps": [],
         "next_checks": _next_checks(pack),
-        "sources": _sources_from_graph_pack(pack),
     }
 
 
@@ -288,7 +286,6 @@ def source_items_from_graph_pack(pack: dict[str, Any]) -> list[dict[str, Any]]:
                 "source_kind": "memory",
                 "source_id": source_id,
                 "input_section": _source_section_for_memory(memory),
-                "output_section": "sources",
             }
         )
         ordinal += 1
@@ -309,7 +306,6 @@ def source_items_from_graph_pack(pack: dict[str, Any]) -> list[dict[str, Any]]:
                     "source_kind": "concept",
                     "source_id": str(source_id),
                     "input_section": "concept_orientation",
-                    "output_section": "sources",
                 }
             )
             ordinal += 1
@@ -1208,18 +1204,6 @@ def _next_checks(pack: dict[str, Any]) -> list[str]:
     return list(dict.fromkeys(checks))[:3]
 
 
-def _sources_from_graph_pack(pack: dict[str, Any]) -> list[dict[str, str]]:
-    return [
-        {
-            "kind": item["source_kind"],
-            "id": item["source_id"],
-            "section": item["input_section"],
-        }
-        for item in source_items_from_graph_pack(pack)
-        if item.get("output_section") is not None
-    ]
-
-
 def _conflict_summary(item: object) -> str:
     if isinstance(item, dict):
         return str(item.get("summary") or item.get("reason") or item)

{shellbrain-0.1.48 → shellbrain-0.1.49}/app/infrastructure/host_apps/inner_agents/prompt.py

@@ -154,13 +154,13 @@ context, with empty or minimal arrays and a concrete
 Lead with the answer. Keep only details that change what the worker should do.
 Use plain English. One idea per sentence. Leave sections empty unless useful.
 Summary: max two sentences. Lists: max three items. Items: max one sentence.
-Full provenance belongs in telemetry; keep visible sources and anchors minimal.
+Full provenance belongs in telemetry; keep visible anchors minimal.
 
 # OUTPUT
 Return only valid JSON matching `output_contract`.
 The brief must be compact and action-oriented: summary, constraints,
 known_traps, prior_cases, concept_orientation, anchors, conflicts, gaps,
-next_checks, and sources. Use conflicts for stale, disputed, superseded,
+and next_checks. Use conflicts for stale, disputed, superseded,
 low-confidence, or mutually inconsistent context. Use gaps for missing context
 or unresolved questions. Use next_checks for one to three concrete checks the
 worker should perform because retrieved context makes them high leverage.
@@ -317,9 +317,8 @@ Summary: max two sentences. Lists: max three items. Items: max one sentence.
 Full provenance belongs in telemetry; keep visible anchors minimal.
 
 # OUTPUT
-Return only valid JSON matching `output_contract`. Return a `brief` object only;
-do not include read_trace or sources. Keep each list compact. Shellbrain attaches
-deterministic source provenance after synthesis.
+Return only valid JSON matching `output_contract`. Return a `brief` object only.
+Keep each list compact.
 """
 
 
@@ -903,14 +902,6 @@ def render_build_context_prompt(request: InnerAgentRunRequest) -> str:
                 "conflicts": ["string"],
                 "gaps": ["string"],
                 "next_checks": ["string"],
-                "sources": [
-                    {
-                        "kind": "memory|concept|episode_event",
-                        "id": "source id or concept ref",
-                        "facet": "claim|relation|grounding|memory_link|event|memory when applicable",
-                        "used_in": "summary|constraints|known_traps|prior_cases|concept_orientation|anchors|conflicts|gaps|next_checks",
-                    }
-                ],
             },
             "read_trace": {
                 "commands": [

{shellbrain-0.1.48 → shellbrain-0.1.49}/app/infrastructure/telemetry/recall_records.py

@@ -50,7 +50,6 @@ def build_recall_summary_records(
                 source_kind=str(item["source_kind"]),
                 source_id=str(item["source_id"]),
                 input_section=str(item["input_section"]),
-                output_section=_optional_string(item.get("output_section")),
             )
         )
 

{shellbrain-0.1.48 → shellbrain-0.1.49}/app/infrastructure/telemetry/records.py

@@ -107,7 +107,6 @@ class RecallSourceItemRecord:
     source_kind: str
     source_id: str
     input_section: str
-    output_section: str | None
 
 
 @dataclass(frozen=True)

{shellbrain-0.1.48 → shellbrain-0.1.49}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shellbrain"
-version = "0.1.48"
+version = "0.1.49"
 description = "Repo-scoped Shellbrain CLI with explicit evidence-backed writes."
 readme = "README.md"
 requires-python = ">=3.11"

{shellbrain-0.1.48 → shellbrain-0.1.49}/shellbrain.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.48
+Version: 0.1.49
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -69,7 +69,7 @@ The episodic layer is truth. Empirical memory extracts. Concept memory abstracts
 
 ### Recall
 
-**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief**, with sources cited.
+**Working agents call `shellbrain recall`.** That is the normal interface they have to think about. One command, **one _carefully curated_ compact brief** for the task at hand.
 
 Recall receives only the quoted query, so include the relevant task, failure, subsystem, or decision naturally in the question.
 
@@ -92,14 +92,7 @@ Response shape:
       "anchors": ["`README.md`"],
       "conflicts": ["..."],
       "gaps": ["..."],
-      "next_checks": ["..."],
-      "sources": [
-        {
-          "kind": "memory",
-          "id": "...",
-          "section": "direct"
-        }
-      ]
+      "next_checks": ["..."]
     },
     "fallback_reason": null
   },