Expose Context ABI guide

Author: nshkrdotcom

core/context_abi/lib/outer_brain/context_abi/failure.ex

@@ -234,20 +234,24 @@ defmodule OuterBrain.ContextABI.Failure do
   defp owner(_owner), do: {:error, :invalid_failure_owner}
 
   defp infer_family(reason_code) do
-    cond do
-      String.contains?(reason_code, ".context.") -> {:ok, :context}
-      String.contains?(reason_code, ".authority.") -> {:ok, :authority}
-      String.contains?(reason_code, ".route.") -> {:ok, :router}
-      String.contains?(reason_code, ".model_") -> {:ok, :model_execution}
-      String.contains?(reason_code, ".inference.") -> {:ok, :model_execution}
-      String.contains?(reason_code, ".eval.") -> {:ok, :eval}
-      String.contains?(reason_code, ".memory.") -> {:ok, :memory}
-      String.contains?(reason_code, ".optimization.") -> {:ok, :optimization}
-      String.contains?(reason_code, ".promotion.") -> {:ok, :promotion}
-      String.contains?(reason_code, ".rollback.") -> {:ok, :promotion}
-      String.contains?(reason_code, ".evidence.") -> {:ok, :evidence}
-      String.contains?(reason_code, ".replay.") -> {:ok, :evidence}
-      true -> {:error, :unknown_failure_family}
+    case Enum.find(@family_prefixes, fn {prefix, _family} ->
+           String.starts_with?(reason_code, prefix)
+         end) do
+      {_prefix, family} -> {:ok, family}
+      nil -> infer_family_from_fragment(reason_code)
+    end
+  end
+
+  defp infer_family_from_fragment(reason_code) do
+    [
+      {".model_", :model_execution},
+      {".inference.", :model_execution},
+      {".rollback.", :promotion}
+    ]
+    |> Enum.find(fn {fragment, _family} -> String.contains?(reason_code, fragment) end)
+    |> case do
+      {_fragment, family} -> {:ok, family}
+      nil -> {:error, :unknown_failure_family}
     end
   end
 

core/memory_engine/mix.exs

@@ -16,7 +16,14 @@ defmodule OuterBrain.MemoryEngine.MixProject do
   end
 
   def application do
-    [extra_applications: [:crypto, :logger]]
+    [
+      extra_applications: [
+        :crypto,
+        :logger,
+        :outer_brain_guardrail_engine,
+        :outer_brain_memory_contracts
+      ]
+    ]
   end
 
   def cli do

guides/context_abi.md

@@ -0,0 +1,35 @@
+# OuterBrain Context ABI
+
+OuterBrain owns the Context ABI data model and semantic artifact references for
+the NSHKR stack. The public surface is the `core/context_abi` package, with
+prompt rendering owned by `core/outer_brain_prompting`.
+
+## Owned Outputs
+
+- `OuterBrain.ContextABI.ContextUnit` for bounded context inputs.
+- `OuterBrain.ContextABI.ContextPacket` for admitted packet facts and packet
+  hashes.
+- `OuterBrain.Prompting.ContextRenderer` for sealed prompt artifact refs,
+  provider payload refs, and payload hashes.
+- Failure reason codes under `OuterBrain.ContextABI.Failure`.
+
+## Boundary Rules
+
+OuterBrain does not execute models, grant authority, promote optimization
+candidates, or own product projections. Mezzanine holds the rendered prompt
+handoff as a `Mezzanine.AIExecution.RenderResult` and passes only refs and
+hashes to Jido Integration.
+
+Raw prompts and raw memory bodies must not cross product, authority, workflow,
+or model-runtime boundaries. Use artifact refs, payload refs, packet hashes,
+trace refs, and bounded failure reason codes.
+
+## Local QC
+
+```bash
+mix ci
+```
+
+StackLab proof of the Context ABI path is owned by StackLab. OuterBrain remains
+responsible for its package tests, canonical hashing, renderer validation, and
+redaction posture.

guides/index.md

@@ -3,6 +3,7 @@
 Implementation-facing guides:
 
 - [Generalized Stack Boundary](https://github.com/nshkrdotcom/outer_brain/blob/main/guides/generalized_stack.md)
+- [Context ABI](context_abi.md)
 - [Code Smell Remediation](code_smell_remediation.md)
 - [QC And Operations](https://github.com/nshkrdotcom/outer_brain/blob/main/guides/qc_and_operations.md)
 

mix.exs

@@ -144,6 +144,9 @@ defmodule OuterBrain.Workspace.MixProject do
         "docs/layout.md",
         "docs/runtime_model.md",
         "docs/integration_surface.md",
+        "guides/context_abi.md",
+        "guides/generalized_stack.md",
+        "guides/qc_and_operations.md",
         "guides/code_smell_remediation.md",
         "CHANGELOG.md",
         "LICENSE"
@@ -152,7 +155,12 @@ defmodule OuterBrain.Workspace.MixProject do
         Overview: ["README.md", "docs/overview.md"],
         Architecture: ["docs/layout.md", "docs/runtime_model.md"],
         Integration: ["docs/integration_surface.md"],
-        Guides: ["guides/code_smell_remediation.md"],
+        Guides: [
+          "guides/context_abi.md",
+          "guides/generalized_stack.md",
+          "guides/qc_and_operations.md",
+          "guides/code_smell_remediation.md"
+        ],
         Project: ["CHANGELOG.md", "LICENSE"]
       ]
     ]