Document AppKit context surface

Author: nshkrdotcom

guides/context_abi.md

@@ -0,0 +1,27 @@
+# AppKit Context ABI Surface
+
+AppKit owns product-safe context, model, evaluation, cost, replay,
+optimization, coordination, and operator projections. It is the only supported
+product boundary for governed NSHKR writes and reads.
+
+## Public Surface
+
+`core/context_surface` exposes product-safe context packet and AI run summaries.
+It depends on Mezzanine projections and redacted refs, not direct calls into
+OuterBrain, Citadel, Jido Integration, or AITrace internals.
+
+## Boundary Rules
+
+Product code must not import lower owner packages to compile context, render
+prompts, execute models, or inspect raw trace payloads. AppKit returns bounded
+summary DTOs with context packet refs, authority refs, model invocation refs,
+eval refs, cost summaries, replay refs, and safe projection state.
+
+## Local QC
+
+```bash
+mix ci
+```
+
+StackLab proves that product paths enter through AppKit and do not bypass the
+lower owner boundaries.

guides/index.md

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

mix.exs

@@ -148,6 +148,9 @@ defmodule AppKit.Workspace.MixProject do
         "docs/layout.md",
         "docs/surfaces.md",
         "docs/composition.md",
+        "guides/context_abi.md",
+        "guides/generalized_stack.md",
+        "guides/qc_and_operations.md",
         "guides/code_smell_remediation.md",
         "CHANGELOG.md",
         "LICENSE"
@@ -156,7 +159,12 @@ defmodule AppKit.Workspace.MixProject do
         Overview: ["README.md", "docs/overview.md"],
         Architecture: ["docs/layout.md", "docs/surfaces.md"],
         Composition: ["docs/composition.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"]
       ]
     ]