shellbrain 0.1.47__tar.gz → 0.1.49__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.47
+Version: 0.1.49
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -69,10 +69,12 @@ 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.
 
 ```bash
-shellbrain recall --json '{"query":"What is ShellBrain and how does it help a working coding agent?","current_problem":{"goal":"understand ShellBrain","surface":"README","obstacle":"new readers do not know the product yet","hypothesis":"a real recall brief should show what agents get back"}}'
+shellbrain recall "What is ShellBrain, and how does it help a working coding agent?"
 ```
 
 Response shape:
@@ -90,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.47 → shellbrain-0.1.49}/README.md

@@ -55,10 +55,12 @@ 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.
 
 ```bash
-shellbrain recall --json '{"query":"What is ShellBrain and how does it help a working coding agent?","current_problem":{"goal":"understand ShellBrain","surface":"README","obstacle":"new readers do not know the product yet","hypothesis":"a real recall brief should show what agents get back"}}'
+shellbrain recall "What is ShellBrain, and how does it help a working coding agent?"
 ```
 
 Response shape:
@@ -76,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.47 → shellbrain-0.1.49}/app/core/ports/host_apps/inner_agents.py

@@ -34,7 +34,6 @@ class InnerAgentRunRequest(_StrictModel):
     max_private_reads: int = Field(default=0, ge=0, le=10)
     max_brief_tokens: int | None = Field(default=None, ge=1, le=100_000)
     query: str = Field(min_length=1)
-    current_problem: dict[str, str]
     repo_root: str | None = None
     synthesis_only: bool = False
     deterministic_pack: dict[str, Any] | None = None

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

@@ -160,7 +160,6 @@ def _inner_agent_request(
         max_private_reads=settings.max_private_reads,
         max_brief_tokens=settings.max_brief_tokens,
         query=request.query,
-        current_problem=request.current_problem.model_dump(mode="python"),
         repo_root=repo_root,
         synthesis_only=synthesis_only,
         deterministic_pack=deterministic_pack,
@@ -175,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)
@@ -272,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,
@@ -433,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")),
@@ -453,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]:
@@ -590,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
@@ -605,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.47 → shellbrain-0.1.49}/app/core/use_cases/retrieval/deterministic_graph_recall.py

@@ -55,7 +55,6 @@ _CONCEPT_HARD_CAP = 8
 _RELATION_NEIGHBOR_CAP = 4
 _HIGH_SIGNAL_RELATIONS = {"depends_on", "constrains", "precedes", "contains"}
 _HIGH_SIGNAL_CLAIMS = {"invariant", "failure_mode", "usage_note", "behavior"}
-_PLACEHOLDER_VALUES = {"none", "none yet", "n/a", "na", "unknown", "not sure"}
 
 
 @dataclass(frozen=True)
@@ -142,7 +141,6 @@ def build_deterministic_graph_pack(
         "strategy": "deterministic_graph",
         "request": {
             "query": request.query,
-            "current_problem": request.current_problem.model_dump(mode="python"),
         },
         "query_lanes": [
             {"lane": lane.name, "query": lane.query, "terms": list(lane.terms)}
@@ -222,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(
@@ -267,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),
     }
 
 
@@ -290,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
@@ -311,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
@@ -320,10 +314,9 @@ def source_items_from_graph_pack(pack: dict[str, Any]) -> list[dict[str, Any]]:
 
 def _build_query_lanes(request: MemoryRecallRequest) -> list[_QueryLane]:
     original = _lane("original", request.query)
-    current_problem = _current_problem_lane(request)
     identifiers = _identifier_lane(request)
     traps = _prior_cases_lane(request)
-    lanes = [lane for lane in (original, current_problem, identifiers, traps) if lane]
+    lanes = [lane for lane in (original, identifiers, traps) if lane]
     deduped: list[_QueryLane] = []
     seen_queries: set[str] = set()
     for lane in lanes:
@@ -343,24 +336,13 @@ def _lane(name: str, query: str) -> _QueryLane | None:
     return _QueryLane(name=name, query=text, terms=terms)
 
 
-def _current_problem_lane(request: MemoryRecallRequest) -> _QueryLane | None:
-    problem = request.current_problem.model_dump(mode="python")
-    parts = [
-        value
-        for key in ("surface", "obstacle", "hypothesis", "goal")
-        if _useful_problem_part(value := str(problem.get(key) or ""))
-    ]
-    return _lane("current_problem", " ".join(parts))
-
-
 def _identifier_lane(request: MemoryRecallRequest) -> _QueryLane | None:
-    problem_text = " ".join(request.current_problem.model_dump(mode="python").values())
-    identifiers = _extract_identifiers(f"{request.query} {problem_text}")
+    identifiers = _extract_identifiers(request.query)
     return _lane("identifiers", " ".join(identifiers))
 
 
 def _prior_cases_lane(request: MemoryRecallRequest) -> _QueryLane | None:
-    terms = list(dict.fromkeys(_tokenize(f"{request.query} {request.current_problem.obstacle}")))
+    terms = list(dict.fromkeys(_tokenize(request.query)))
     strongest = " ".join(terms[:8])
     if not strongest:
         return None
@@ -371,7 +353,7 @@ def _prior_cases_lane(request: MemoryRecallRequest) -> _QueryLane | None:
 
 
 def _broad_domain_lane(request: MemoryRecallRequest) -> _QueryLane | None:
-    terms = _tokenize(f"{request.current_problem.surface} {request.current_problem.goal}")
+    terms = _tokenize(request.query)
     if not terms:
         return None
     return _lane("broad_domain", " ".join(dict.fromkeys(terms[:8])))
@@ -1222,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)
@@ -1392,11 +1362,6 @@ def _tokenize(text: str) -> tuple[str, ...]:
     return tuple(re.findall(r"[a-z0-9_./:-]+", text.lower()))
 
 
-def _useful_problem_part(value: str) -> bool:
-    text = value.strip().lower()
-    return bool(text and text not in _PLACEHOLDER_VALUES)
-
-
 def _dedupe_reasons(reasons: Iterable[dict[str, Any]]) -> list[dict[str, Any]]:
     seen: set[str] = set()
     deduped = []

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/core/use_cases/retrieval/recall/__init__.py

@@ -1,14 +1,10 @@
 """Memory recall use case."""
 
-from app.core.use_cases.retrieval.recall.request import (
-    MemoryRecallRequest,
-    RecallCurrentProblem,
-)
+from app.core.use_cases.retrieval.recall.request import MemoryRecallRequest
 from app.core.use_cases.retrieval.recall.result import RecallMemoryResult
 
 __all__ = [
     "MemoryRecallRequest",
-    "RecallCurrentProblem",
     "RecallMemoryResult",
     "execute_recall_memory",
 ]

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/core/use_cases/retrieval/recall/request.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from typing import Literal
-
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 from app.core.entities.ids import RepoId
@@ -24,28 +22,11 @@ def _normalize_repo_id(value: RepoId) -> RepoId:
     return RepoId(_normalize_required_string(str(value), field_name="repo_id"))
 
 
-class RecallCurrentProblem(_StrictModel):
-    """Required worker problem context for recall synthesis."""
-
-    goal: str = Field(min_length=1)
-    surface: str = Field(min_length=1)
-    obstacle: str = Field(min_length=1)
-    hypothesis: str = Field(min_length=1)
-
-    @field_validator("goal", "surface", "obstacle", "hypothesis")
-    @classmethod
-    def _validate_non_blank(cls, value: str) -> str:
-        return _normalize_required_string(value, field_name="current_problem fields")
-
-
 class MemoryRecallRequest(_StrictModel):
     """Canonical recall request payload."""
 
-    op: Literal["recall"] = "recall"
     repo_id: RepoId
     query: str = Field(min_length=1)
-    limit: int | None = Field(default=None, ge=1, le=100)
-    current_problem: RecallCurrentProblem
 
     @field_validator("repo_id")
     @classmethod

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/entrypoints/cli/parser/builder.py

@@ -45,7 +45,8 @@ _TOP_LEVEL_HELP = dedent(
         - Use `shellbrain recall` for normal task context.
         - Use `shellbrain teach` only when the user explicitly asks to store or teach Shellbrain something.
         - If you changed any files since your last user-facing response, run `shellbrain snapshot` exactly once after validation and immediately before your next user-facing response. Do this on every response cycle where files changed; skip only when no files changed.
-        - Send a concrete `query` plus required `current_problem`.
+        - Send one concrete natural-language query.
+        - Recall receives only this query, so include relevant task context naturally.
         - Avoid generic prompts like "what should I know about this repo?"
 
       Internal recall agents:
@@ -74,7 +75,7 @@ _TOP_LEVEL_HELP = dedent(
       shellbrain admin migrate
 
       Working agents:
-      shellbrain recall --json '{"query":"What context matters for this migration lock timeout?","current_problem":{"goal":"fix migration locking","surface":"db admin","obstacle":"lock timeout","hypothesis":"missing timeout guard"}}'
+      shellbrain recall "What context matters for this migration lock timeout?"
       shellbrain teach --json '{"text":"In this repo, startup wires dependencies but should not own workflow behavior.","current_problem":{"goal":"record architecture preference","surface":"startup and clean architecture","obstacle":"agents may put behavior in startup","hypothesis":"teach should become a durable preference or concept claim"}}'
       shellbrain snapshot
 
@@ -158,14 +159,13 @@ _RECALL_HELP = dedent(
     This is the normal working-agent interface. Working agents should call
     `recall`, not internal commands like `read`, `events`, or `concept show`.
 
-    Requires `query` and `current_problem`.
-    `current_problem` must include non-empty `goal`, `surface`, `obstacle`, and
-    `hypothesis`; use an explicit value like "none yet" when there is no hypothesis.
-    Accepts optional `limit`.
+    Pass one self-contained natural-language query naming the failure mode,
+    subsystem, decision, file area, or constraint that matters. Recall receives
+    only this query, so include relevant task context naturally.
     It does not mutate memories, concepts, utility observations, or problem runs.
 
     Example:
-      shellbrain recall --json '{"query":"What context matters for this migration lock timeout?","current_problem":{"goal":"fix migration locking","surface":"db admin","obstacle":"Docker unavailable","hypothesis":"none yet"}}'
+      shellbrain recall "What context matters for this migration lock timeout?"
     """
 )
 
@@ -565,7 +565,7 @@ def build_parser() -> argparse.ArgumentParser:
         formatter_class=_HelpFormatter,
     )
     _add_repo_context_arguments(recall_parser, suppress_default=True)
-    _add_payload_arguments(recall_parser)
+    recall_parser.add_argument("query", help="Natural-language recall query.")
 
     teach_parser = subparsers.add_parser(
         "teach",

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/entrypoints/cli/presenters/init.py

@@ -34,7 +34,7 @@ def render_success_lines(
             "Repo registration: deferred until first Shellbrain use inside a repo."
         )
         lines.append(
-            'Next: from inside a repo, run shellbrain recall --json \'{"query":"What prior Shellbrain context matters for this task?","current_problem":{"goal":"start work","surface":"repo session","obstacle":"none yet","hypothesis":"none yet"}}\''
+            'Next: from inside a repo, run shellbrain recall "What prior Shellbrain context matters for this task?"'
         )
     else:
         lines.insert(1, f"Repo: {registration.repo_id}")
@@ -44,7 +44,7 @@ def render_success_lines(
                 "Repo identity is weak-local and will change if this directory moves. Use --repo-id for a durable override.",
             )
         lines.append(
-            'Next: shellbrain recall --json \'{"query":"What prior Shellbrain context matters for this task?","current_problem":{"goal":"start work","surface":"repo session","obstacle":"none yet","hypothesis":"none yet"}}\''
+            'Next: shellbrain recall "What prior Shellbrain context matters for this task?"'
         )
     lines.extend(notes)
     return lines

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/entrypoints/cli/request_parsing/payload_validation.py

@@ -84,37 +84,6 @@ class AgentReadRequest(StrictBaseModel):
         return value
 
 
-class AgentRecallCurrentProblem(StrictBaseModel):
-    """Agent-facing current-problem context for recall synthesis."""
-
-    goal: str = Field(min_length=1)
-    surface: str = Field(min_length=1)
-    obstacle: str = Field(min_length=1)
-    hypothesis: str = Field(min_length=1)
-
-    @field_validator("goal", "surface", "obstacle", "hypothesis")
-    @classmethod
-    def _validate_non_blank(cls, value: str) -> str:
-        """Require every problem context field to be explicit."""
-
-        return _normalize_required_string(
-            value, field_name="current_problem fields"
-        )
-
-
-class AgentRecallRequest(StrictBaseModel):
-    """Agent-facing recall payload with worker problem context."""
-
-    query: str = Field(min_length=1)
-    limit: int | None = Field(default=None, ge=1, le=100)
-    current_problem: AgentRecallCurrentProblem
-
-    @field_validator("query")
-    @classmethod
-    def _validate_query(cls, value: str) -> str:
-        return _normalize_required_string(value, field_name="query")
-
-
 class AgentTeachRequest(StrictBaseModel):
     """Worker-facing payload for explicit user teaching."""
 
@@ -282,17 +251,6 @@ def validate_read_schema(
         return None, _format_validation_errors(exc)
 
 
-def validate_recall_schema(
-    payload: dict[str, Any],
-) -> tuple[AgentRecallRequest | None, list[ErrorDetail]]:
-    """Validate and parse agent recall payloads into the minimal recall contract."""
-
-    try:
-        return AgentRecallRequest.model_validate(payload), []
-    except ValidationError as exc:
-        return None, _format_validation_errors(exc)
-
-
 def validate_events_schema(
     payload: dict[str, Any],
 ) -> tuple[AgentEventsRequest | None, list[ErrorDetail]]:

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/entrypoints/cli/request_parsing/retrieval.py

@@ -9,7 +9,6 @@ from app.entrypoints.cli.request_parsing.payload_validation import (
     validate_internal_read_contract,
     validate_internal_recall_contract,
     validate_read_schema,
-    validate_recall_schema,
 )
 from app.entrypoints.cli.request_parsing.prepared import (
     PreparedOperationRequest,
@@ -67,14 +66,7 @@ def prepare_recall_request(
 ) -> PreparedOperationRequest[MemoryRecallRequest]:
     """Validate and hydrate one raw recall payload."""
 
-    agent_request, errors = validate_recall_schema(payload)
-    if errors:
-        return PreparedOperationRequest(
-            request=None, errors=errors, error_stage="schema_validation"
-        )
-    assert agent_request is not None
-    hydrated = agent_request.model_dump(mode="python", exclude_none=True)
-    hydrated.setdefault("op", "recall")
+    hydrated = dict(payload)
     hydrated.setdefault("repo_id", inferred_repo_id)
     request, contract_errors = validate_internal_recall_contract(hydrated)
     return PreparedOperationRequest(

{shellbrain-0.1.47 → shellbrain-0.1.49}/app/entrypoints/cli/runner.py

@@ -122,13 +122,14 @@ def main(
             repo_root_arg=getattr(args, "repo_root", None),
             repo_id_arg=getattr(args, "repo_id", None),
         )
-        payload = (
-            {}
-            if command == "snapshot"
-            else _load_payload(
+        if command == "snapshot":
+            payload = {}
+        elif command == "recall":
+            payload = {"query": args.query}
+        else:
+            payload = _load_payload(
                 getattr(args, "json_text", None), getattr(args, "json_file", None)
             )
-        )
     except ValueError as exc:
         parser.error(str(exc))
         return 2

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

@@ -83,18 +83,17 @@ admin/init/upgrade/metrics, filesystem writes, settings writes, and direct DB
 writes.
 
 # PROTOCOL
-1. Read the payload: `query`, `current_problem`, `repo_root`, and budgets.
+1. Read the payload: `query`, `repo_root`, and budgets. Treat `query` as the
+   complete worker context.
    Use the repo-root-prefixed commands from the payload whenever `repo_root` is
    provided. Do not omit `--repo-root` in nested Codex.
 2. Run events first:
    ```bash
    shellbrain --no-sync --repo-root "<repo_root>" events --json '{"limit":10}'
    ```
-3. Build a compact search text from the query and useful parts of
-   current_problem.goal, surface, obstacle, and hypothesis. Omit placeholders
-   such as "none yet". Prefer concrete error terms, domain nouns,
-   files/symbols, and the actual obstacle over generic goal text. Use recent
-   events to sharpen the query when they reveal better terms.
+3. Build a compact search text from the query. Prefer concrete error terms,
+   domain nouns, files/symbols, and the actual obstacle over generic wording.
+   Use recent events to sharpen the query when they reveal better terms.
 4. Run at least one targeted read:
    ```bash
    shellbrain --no-sync --repo-root "<repo_root>" read --json '{"query":"<combined search text>","kinds":["problem","solution","failed_tactic","fact","preference","change"]}'
@@ -114,7 +113,7 @@ writes.
    ```
    If multiple concepts match, inspect at most the few most relevant within
    budget. Prefer concepts whose claims, groundings, or memory links connect
-   directly to current_problem.surface or current_problem.obstacle. Mention
+   directly to the query. Mention
    competing or ambiguous concepts only when the ambiguity affects the worker.
 6. Run extra reads only when they are likely to improve the brief: events reveal
    a sharper query, concept details suggest a related term, the first read was
@@ -155,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.
@@ -180,7 +179,7 @@ You are Shellbrain build_context_synthesizer.
 # JOB
 Synthesize a compact operational recall brief from the deterministic recall
 graph pack. Do not request more data. Do not run commands. Do not inspect files.
-Do not invent facts. Use only the pack.
+Do not invent facts. Use only the pack. The query is the complete worker request.
 
 Your job is not to summarize everything. Your job is to tell the working coding
 agent what prior knowledge changes what it should do next.
@@ -318,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.
 """
 
 
@@ -867,7 +865,6 @@ def render_build_context_prompt(request: InnerAgentRunRequest) -> str:
     shellbrain = _shellbrain_command(request.repo_root, no_sync=True)
     payload = {
         "query": request.query,
-        "current_problem": request.current_problem,
         "repo_root": request.repo_root,
         "budgets": {
             "max_private_reads": request.max_private_reads,
@@ -905,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": [
@@ -938,7 +927,6 @@ def render_build_context_synthesis_prompt(request: InnerAgentRunRequest) -> str:
 
     payload = {
         "query": request.query,
-        "current_problem": request.current_problem,
         "budgets": {
             "max_brief_tokens": request.max_brief_tokens,
         },

{shellbrain-0.1.47 → 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.47 → 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.47 → shellbrain-0.1.49}/onboarding_assets/claude/CLAUDE.md

@@ -22,9 +22,11 @@ If prior context may help:
 Then run:
 
 ```bash
-shellbrain recall --json '{"query":"<targeted question>","current_problem":{"goal":"<goal>","surface":"<surface>","obstacle":"<obstacle>","hypothesis":"<hypothesis or none yet>"}}'
+shellbrain recall "<targeted natural-language question>"
 ```
 
+Recall receives only this query, so include relevant task context naturally in the question.
+
 If recall would not help:
 
 `SB: skip | same signature | <one-line reason>`