Publish machine-oriented AI context

README.md

@@ -28,6 +28,7 @@ This site displays exact, provenance-bearing chapter snapshots. It does not merg
 - `/preamble/` remains one click from Awakening and from the primary navigation.
 - `/chapters/` is the unified index for the eight-repository textbook.
 - `/chapters/chapter-zero/` through `/chapters/chapter-seven/` render exact source Markdown with commit, blob, digest, and repository links.
+- `/eai/aicontext.md` begins with Erin's exact connection contract and then publishes the exact canon copy, all eight textbook chapters, a public-scope JSON-LD biography, and machine-readable work-graph and publication identities.
 - Eleventy generates complete HTML into `_site`.
 - Pagefind supplies static search.
 - GitHub organization, canon, and textbook source data are retrieved at build time, never in a visitor’s browser.
@@ -69,6 +70,7 @@ Route checks after a build:
 /chapters/chapter-zero/         Chapter Zero
 ...
 /chapters/chapter-seven/        Chapter Seven
+/eai/aicontext.md               machine-oriented connection context
 ```
 
 Add reviewed project metadata to a repository:

The-Interdependency.github.io_msdmd.ts

@@ -530,9 +530,150 @@ export default defineMsdmdCollection({
       },
       "file": "src/assets/js/site.js",
       "id": "optional_site_enhancement"
+    },
+    {
+      "block": "BOUNDARIES",
+      "fields": {
+        "admin_only": "false",
+        "auth_boundary": "none",
+        "network_boundary": "none",
+        "owner": "Erin Spencer",
+        "pii": "direct",
+        "review_required": "Erin Spencer for biography field expansion",
+        "secrets": "none",
+        "side_effects": "public static artifact generated beneath _site/eai",
+        "storage_boundary": "read",
+        "summary": "Reads repository-controlled snapshots and a deliberately public biography record, then writes them into a public build artifact through Eleventy.",
+        "user_data_boundary": "read"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_publication_boundary"
+    },
+    {
+      "block": "CONTRACTS",
+      "fields": {
+        "class": "canon",
+        "given": "Eleventy renders /eai/aicontext.md",
+        "then": "the first byte begins the author-supplied EOF connection contract with no front matter, preamble, or byte-order marker"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_exact_contract_prefix"
+    },
+    {
+      "block": "CONTRACTS",
+      "fields": {
+        "class": "evidence",
+        "given": "current canon and all eight textbook sources resolve with immutable identities",
+        "then": "the artifact contains each exact source body once in declared order and exposes repository, path, commit, blob, digest, license state, correction target, and fallback state"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_exact_distributed_sources"
+    },
+    {
+      "block": "CONTRACTS",
+      "fields": {
+        "class": "doctrine",
+        "given": "canon, textbook chapters, and biography share one public artifact",
+        "then": "authorship, ownership, license, canonical, proof, certification, measurement, empirical, and authentication status do not transfer between sources"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_non_transfer_boundary"
+    },
+    {
+      "block": "CONTRACTS",
+      "fields": {
+        "class": "safety",
+        "given": "the machine-readable biography is published",
+        "then": "valid JSON-LD is enclosed in vertical bars and excludes private categories unless Erin explicitly authorizes expansion"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_public_biography_boundary"
+    },
+    {
+      "block": "MODULE_BUILD",
+      "fields": {
+        "admin_only": "false",
+        "auth_boundary": "none",
+        "data_schema": "the-interdependency.stack-manifest/1.0.0, the-interdependency.distributed-publication/1.0.0, interdependentway.public-biography/1.0.0",
+        "internal_surface": "renderAiContext, buildWorkGraph, buildPublicationManifest",
+        "module_kind": "route",
+        "module_name": "aicontext",
+        "network_boundary": "none",
+        "owner": "Erin Spencer",
+        "public_surface": "/eai/aicontext.md",
+        "requires": "canonical_source_fetch, canon_structure_materializer, distributed_textbook_fetch",
+        "rollback": "remove this template, biography record, aicontext checks, and route documentation together",
+        "rollout": "Eleventy emits the route after online production validation resolves every required source without fallback",
+        "storage_boundary": "read",
+        "summary": "Publishes one machine-oriented Markdown context file containing the exact connection contract, canonical Way copy, distributed textbook, public biography, and immutable source identities.",
+        "tests": "tests/aicontext.test.mjs, tests/generated-site.test.mjs",
+        "unresolved": "signed source authentication, author-reviewed expansion of the public biography",
+        "user_data_boundary": "read"
+      },
+      "file": "src/eai/aicontext.11ty.js",
+      "id": "ai_context_publication"
+    },
+    {
+      "block": "CHECKS",
+      "fields": {
+        "call": "self::checkExactContractPrefix",
+        "cleanup": "none",
+        "mutates": "none",
+        "proves": "ai_context_exact_contract_prefix",
+        "requires": "node",
+        "timeout": "10"
+      },
+      "file": "tests/aicontext.test.mjs",
+      "id": "check_ai_context_exact_contract_prefix"
+    },
+    {
+      "block": "CHECKS",
+      "fields": {
+        "call": "self::checkExactDistributedSources",
+        "cleanup": "none",
+        "mutates": "none",
+        "proves": "ai_context_exact_distributed_sources",
+        "requires": "node",
+        "timeout": "10"
+      },
+      "file": "tests/aicontext.test.mjs",
+      "id": "check_ai_context_exact_distributed_sources"
+    },
+    {
+      "block": "CHECKS",
+      "fields": {
+        "call": "self::checkNonTransferBoundary",
+        "cleanup": "none",
+        "mutates": "none",
+        "proves": "ai_context_non_transfer_boundary",
+        "requires": "node",
+        "timeout": "10"
+      },
+      "file": "tests/aicontext.test.mjs",
+      "id": "check_ai_context_non_transfer_boundary"
+    },
+    {
+      "block": "CHECKS",
+      "fields": {
+        "call": "self::checkPublicBiographyBoundary",
+        "cleanup": "none",
+        "mutates": "none",
+        "proves": "ai_context_public_biography_boundary",
+        "requires": "node",
+        "timeout": "10"
+      },
+      "file": "tests/aicontext.test.mjs",
+      "id": "check_ai_context_public_biography_boundary"
     }
   ],
   "edges": [
+    {
+      "from": "ai_context_publication_boundary",
+      "kind": "owns",
+      "source_block": "BOUNDARIES",
+      "source_id": "ai_context_publication_boundary",
+      "to": "Erin Spencer"
+    },
     {
       "from": "article_canon_verification_boundary",
       "kind": "owns",
@@ -610,6 +751,118 @@ export default defineMsdmdCollection({
       "source_id": "static_textbook_math_rendering_boundary",
       "to": "Erin Spencer"
     },
+    {
+      "from": "check_ai_context_exact_contract_prefix",
+      "kind": "calls",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_contract_prefix",
+      "to": "self::checkExactContractPrefix"
+    },
+    {
+      "from": "check_ai_context_exact_contract_prefix",
+      "kind": "claims_proves",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_contract_prefix",
+      "to": "ai_context_exact_contract_prefix"
+    },
+    {
+      "from": "check_ai_context_exact_contract_prefix",
+      "kind": "requires",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_contract_prefix",
+      "to": "node"
+    },
+    {
+      "from": "check_ai_context_exact_distributed_sources",
+      "kind": "calls",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_distributed_sources",
+      "to": "self::checkExactDistributedSources"
+    },
+    {
+      "from": "check_ai_context_exact_distributed_sources",
+      "kind": "claims_proves",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_distributed_sources",
+      "to": "ai_context_exact_distributed_sources"
+    },
+    {
+      "from": "check_ai_context_exact_distributed_sources",
+      "kind": "requires",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_exact_distributed_sources",
+      "to": "node"
+    },
+    {
+      "from": "check_ai_context_non_transfer_boundary",
+      "kind": "calls",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_non_transfer_boundary",
+      "to": "self::checkNonTransferBoundary"
+    },
+    {
+      "from": "check_ai_context_non_transfer_boundary",
+      "kind": "claims_proves",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_non_transfer_boundary",
+      "to": "ai_context_non_transfer_boundary"
+    },
+    {
+      "from": "check_ai_context_non_transfer_boundary",
+      "kind": "requires",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_non_transfer_boundary",
+      "to": "node"
+    },
+    {
+      "from": "check_ai_context_public_biography_boundary",
+      "kind": "calls",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_public_biography_boundary",
+      "to": "self::checkPublicBiographyBoundary"
+    },
+    {
+      "from": "check_ai_context_public_biography_boundary",
+      "kind": "claims_proves",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_public_biography_boundary",
+      "to": "ai_context_public_biography_boundary"
+    },
+    {
+      "from": "check_ai_context_public_biography_boundary",
+      "kind": "requires",
+      "source_block": "CHECKS",
+      "source_id": "check_ai_context_public_biography_boundary",
+      "to": "node"
+    },
+    {
+      "from": "ai_context_publication",
+      "kind": "owns",
+      "source_block": "MODULE_BUILD",
+      "source_id": "ai_context_publication",
+      "to": "Erin Spencer"
+    },
+    {
+      "from": "ai_context_publication",
+      "kind": "requires",
+      "source_block": "MODULE_BUILD",
+      "source_id": "ai_context_publication",
+      "to": "canon_structure_materializer"
+    },
+    {
+      "from": "ai_context_publication",
+      "kind": "requires",
+      "source_block": "MODULE_BUILD",
+      "source_id": "ai_context_publication",
+      "to": "canonical_source_fetch"
+    },
+    {
+      "from": "ai_context_publication",
+      "kind": "requires",
+      "source_block": "MODULE_BUILD",
+      "source_id": "ai_context_publication",
+      "to": "distributed_textbook_fetch"
+    },
     {
       "from": "article_canon_exactness_gate",
       "kind": "owns",

docs/aicontext.md

@@ -0,0 +1,80 @@
+# AI context endpoint
+
+`/eai/aicontext.md` is the public, machine-oriented connection surface for an AI or other reader that needs one bounded context object before navigating the full site.
+
+## Usage guidance
+
+Read the file from its first byte. The author-supplied `EOF` connection contract is deliberately first and has no front matter, byte-order marker, HTML wrapper, or generated introduction before it. A consuming agent should then:
+
+1. apply the opening content-creation and connection contract;
+2. read the work-graph and publication manifests as JSON;
+3. treat `<CANON COPY>` as an exact publication copy whose authority remains `wayseer00/main:canon/INTERDEPENDENT_WAY.txt`;
+4. read textbook chapters in declared order from Zero through Seven while preserving each source-local status and license;
+5. parse the JSON-LD inside `<MACHINE READABLE BIOGRAPHY>` and its vertical-bar context boundary;
+6. carry `<TO BE DETERMINED>`, `<NOT YET>`, and the closing `hmmm` into continuation rather than inventing completion.
+
+Build and inspect locally:
+
+```bash
+npm run build
+sed -n '1,120p' _site/eai/aicontext.md
+npm run check
+```
+
+The endpoint is generated from the same refreshed data used by the public canon and chapter routes. Edit canonical prose only in `wayseer00/main`; edit a textbook chapter only in its owning repository; edit the public biography scope or endpoint renderer in this repository.
+
+## Domain claims
+
+The structural labels introduced here are provisional publication-domain claims, not universal definitions.
+
+### AI context
+
+- Surface form: `AI context`
+- Term ID: `interdependentway.publication.ai_context`
+- Claiming domain: interdependentway.org public knowledge publication
+- Claimed sense: one ordered, machine-oriented Markdown artifact that carries an author-supplied connection contract, exact distributed source copies, public biography JSON-LD, provenance, non-transfer boundaries, and unresolved continuation
+- Scope: `/eai/aicontext.md` and its build/test contracts
+- Claim type: specialized
+- Status: provisional
+- Authority source: Erin Spencer's request dated 2026-08-01
+- Included: source identity, reading order, correction routing, public biography scope, `hmmm`
+- Excluded: model weights, private memory, private biography, producer authentication, canonical replacement, or authority transfer
+- Collision check: no conflicting structural use was found in the website repository; broader AI meanings do not control this route
+
+### Public biography
+
+- Surface form: `public biography`
+- Term ID: `interdependentway.publication.public_biography`
+- Claiming domain: interdependentway.org public knowledge publication
+- Claimed sense: an author-requested, machine-readable project biography whose public field selection remains reviewable and whose excluded private categories are explicit
+- Scope: `src/_data/erin.public-biography.json` and the biography block in `/eai/aicontext.md`
+- Claim type: specialized
+- Status: provisional
+- Authority source: Erin Spencer's request dated 2026-08-01 plus author-supplied context
+- Included: public name, work roles, project relationships, general veteran background, working-method constraints, source and privacy metadata
+- Excluded: exact location, birth details, medical information, trauma history, legal matters, financial information, private relationships, and private contact information
+- Collision check: schema.org `Person` supplies the base JSON-LD vocabulary; the Interdependent Way extension fields are publication-local and do not claim global schema authority
+
+## Work graph
+
+The generated stack manifest resolves these participants to exact build-time commits:
+
+- `The-Interdependency/The-Interdependency.github.io` — publication ordering, rendering, biography scope, and display provenance;
+- `wayseer00/main` — sole canonical text authority;
+- `The-Interdependency/metapat`, `ucns`, `edcm`, `skill-lib`, `interdependent-lib`, `ptcna`, `a0`, and `zfae` — source owners for textbook chapters Zero through Seven;
+- `The-Interdependency/skill-lib` — additionally supplies build and evidence doctrine.
+
+Repository boundaries remain authority and provenance boundaries. The website consumes exact source content and must not repair source prose in its generated copy.
+
+## Publication and privacy boundaries
+
+The endpoint transfers no authorship, ownership, license, canon, theorem, proof, certification, measurement, empirical, frontier, or authentication status between sources. Digests establish byte identity only. Every source has a correction target. Online production fails before Eleventy renders when canon or any required textbook chapter is missing or fallback.
+
+The biography is intentionally public-scope. Its `privacy.excludedCategories` list records what is absent without publishing any excluded values. Erin Spencer must explicitly authorize field expansion before those values enter a public build.
+
+## hmmm
+
+- The source repositories do not yet share a signed-source authentication contract.
+- UCNS currently has no root license declaration; Chapter One is therefore marked `human-review-required`, and the archived Apache license is not projected onto current source.
+- The public biography needs Erin Spencer's line-by-line review before its provisional field selection can be considered settled.
+- Content negotiation for a pure JSON sibling endpoint is not selected; Markdown with fenced JSON remains the requested surface.

package.json

@@ -15,7 +15,7 @@
     "validate": "node scripts/validate-content.mjs && node scripts/verify-generated-routes.mjs && node scripts/verify-article-canon.mjs",
     "build": "npm run validate && eleventy && pagefind --site _site && node scripts/write-build-info.mjs",
     "pretest": "node scripts/prepare-tests.mjs",
-    "test": "node --test tests/canon-parser.test.mjs tests/canon-integrity.test.mjs tests/textbook-integrity.test.mjs tests/math-rendering.test.mjs tests/narratives.test.mjs tests/offline-project-snapshot.test.mjs tests/repo-coverage.test.mjs tests/research-ledger.test.mjs tests/works-registry.test.mjs tests/site-contract.test.mjs",
+    "test": "node --test tests/aicontext.test.mjs tests/canon-parser.test.mjs tests/canon-integrity.test.mjs tests/textbook-integrity.test.mjs tests/math-rendering.test.mjs tests/narratives.test.mjs tests/offline-project-snapshot.test.mjs tests/repo-coverage.test.mjs tests/research-ledger.test.mjs tests/works-registry.test.mjs tests/site-contract.test.mjs",
     "test:generated": "node --test tests/generated-site.test.mjs tests/textbook-generated.test.mjs tests/math-generated.test.mjs && node tests/links.test.mjs",
     "test:browser": "playwright test",
     "test:e2e": "playwright test tests/site.spec.mjs",