Repository navigation
Expand file tree
/
Copy pathThe-Interdependency.github.io_msdmd.ts
More file actions
1525 lines (1524 loc) · 56.9 KB
/
Copy pathThe-Interdependency.github.io_msdmd.ts
File metadata and controls
1525 lines (1524 loc) · 56.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
import { defineMsdmdCollection } from "./.agents/skills/msdmd/collection";
export default defineMsdmdCollection({
"declarations": [
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "npm run build",
"purpose": "Build the static-first public knowledge system, render exact distributed-textbook Markdown and LaTeX as static MathML, and copy deliberate fallback artifacts.",
"tests": "tests/site-contract.test.mjs, tests/math-rendering.test.mjs, tests/narratives.test.mjs, tests/generated-site.test.mjs"
},
"file": ".eleventy.js",
"id": "eleventy_site_configuration"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "internal",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "browser processes, loopback listener",
"storage_boundary": "read",
"summary": "Launches Chromium and a loopback-only static server against generated public files.",
"user_data_boundary": "none"
},
"file": "playwright.config.mjs",
"id": "generated_site_browser_harness_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "Playwright webServer and Chromium test configuration",
"module_kind": "instrument",
"module_name": "playwright-config",
"network_boundary": "internal",
"owner": "Erin Spencer",
"public_surface": "npm run test:browser, npm run test:e2e, npm run test:a11y",
"rollback": "remove browser scripts, workflow steps, and static test server together",
"rollout": "required by pull-request and Pages workflows",
"storage_boundary": "read",
"summary": "Configures browser, route, static-math, and automated accessibility checks against the generated site.",
"tests": "tests/site.spec.mjs, tests/math.spec.mjs, tests/accessibility.spec.mjs",
"user_data_boundary": "none"
},
"file": "playwright.config.mjs",
"id": "generated_site_browser_harness"
},
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "npm run audit:workflows",
"purpose": "Refuse unpinned, tag-pinned, stale, or unapproved GitHub workflow actions before build/deploy.",
"tests": "npm run check"
},
"file": "scripts/audit-workflows.mjs",
"id": "workflow_action_audit"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "root llms.txt replacement on --apply",
"storage_boundary": "write",
"summary": "Reads repository source declarations and writes only the root llms.txt when explicitly invoked with --apply.",
"user_data_boundary": "none"
},
"file": "scripts/build-llms.mjs",
"id": "llms_instruction_builder_boundary"
},
{
"block": "CONTRACTS",
"fields": {
"class": "correctness",
"given": "a Markdown fenced-code example contains LLMS fence text",
"then": "the example contributes no declaration to llms.txt"
},
"file": "scripts/build-llms.mjs",
"id": "llms_markdown_examples_ignored"
},
{
"block": "CONTRACTS",
"fields": {
"class": "doctrine",
"given": "repository source files contain msdmd LLMS entries and the builder runs",
"then": "llms.txt is generated deterministically from project_overview, key_definitions, architecture_summary, and usage_rules entries"
},
"file": "scripts/build-llms.mjs",
"id": "llms_root_generated_from_declarations"
},
{
"block": "CONTRACTS",
"fields": {
"class": "safety",
"given": "a required LLMS entry is absent",
"then": "the generated section contains hmmm rather than invented content"
},
"file": "scripts/build-llms.mjs",
"id": "llms_unknowns_visible"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "parseLlmsText, collectLlmsEntries, generateLlms",
"module_kind": "instrument",
"module_name": "build-llms",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "npm run build:llms, npm run check:llms",
"rollback": "remove the runner, its package scripts and tests, llms.txt passthrough, and root llms.txt together",
"rollout": "check:llms is required by npm run check; build:llms intentionally applies reviewed declaration changes",
"storage_boundary": "write",
"summary": "Generates and drift-checks the canonical root llms.txt from repository-local msdmd LLMS declarations.",
"tests": "tests/llms-build.test.mjs",
"user_data_boundary": "none"
},
"file": "scripts/build-llms.mjs",
"id": "llms_instruction_builder"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "slug, boundedRouteSlug, canonicalHeadingLevel, parseDefinitionLine, extractNoteMarkers",
"module_kind": "engine",
"module_name": "canon-parser",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "parseCanon, detectHeading, extractNotes",
"rollback": "restore the prior parser version and remove nested heading-parent edges",
"rollout": "imported by scripts/parse-canon.mjs during every canon refresh",
"storage_boundary": "none",
"summary": "Parses canonical or recovery text into stable sections, nested heading units, notes, routes, and provenance-bearing hashes.",
"tests": "tests/canon-parser.test.mjs, tests/canon-integrity.test.mjs",
"user_data_boundary": "none"
},
"file": "scripts/canon-parser.mjs",
"id": "canon_parser_core"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "none",
"module_kind": "instrument",
"module_name": "check-edcm-reference-drift",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "node scripts/check-edcm-reference-drift.mjs [reference-file]",
"rollback": "remove only with another deterministic cross-repository reference gate",
"rollout": "npm run check:edcm-reference and npm run check",
"since": "2026-08-02",
"storage_boundary": "read",
"summary": "Fails when the website copy differs from the exact commit-pinned EDCM reference identity or an explicitly supplied producer checkout.",
"tests": "tests/edcm-mathematics.test.mjs",
"unresolved": "none",
"user_data_boundary": "none"
},
"file": "scripts/check-edcm-reference-drift.mjs",
"id": "edcm_reference_drift_gate"
},
{
"block": "BOUNDARIES",
"fields": {
"failure": "falls back to the repository mirror and records fallback=true",
"network": "read-only HTTPS request to allowlisted GitHub API and raw content endpoints",
"storage": "writes generated snapshots beneath src/_data/snapshots"
},
"file": "scripts/fetch-canon.mjs",
"id": "canon_network_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "npm run refresh:canon",
"purpose": "Retrieve the Wayseer canonical text or preserve a visibly labeled local recovery mirror.",
"tests": "tests/canon-integrity.test.mjs"
},
"file": "scripts/fetch-canon.mjs",
"id": "canonical_source_fetch"
},
{
"block": "BOUNDARIES",
"fields": {
"failure": "preserves last-known-good data with fallback=true, including reviewed editorial fields",
"network": "reads only allowlisted HTTPS GitHub API endpoints; optional token raises rate limits",
"storage": "writes generated and last-known-good JSON snapshots"
},
"file": "scripts/fetch-github-org.mjs",
"id": "github_public_metadata"
},
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "npm run refresh:github",
"purpose": "Build public project pages from GitHub facts plus reviewed repository manifests or central overrides.",
"tests": "tests/repo-coverage.test.mjs, tests/offline-project-snapshot.test.mjs"
},
"file": "scripts/fetch-github-org.mjs",
"id": "organization_project_map"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "optional GitHub read token",
"network_boundary": "external read-only",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "GITHUB_TOKEN is passed only as an HTTPS authorization header and never written",
"side_effects": "generated dataset and snapshot writes",
"storage_boundary": "write beneath src/_data/generated and src/_data/snapshots",
"summary": "Reads only the eight declared chapter files from allowlisted GitHub endpoints.",
"user_data_boundary": "none"
},
"file": "scripts/fetch-textbook.mjs",
"id": "distributed_textbook_network_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "optional read-only GITHUB_TOKEN",
"internal_surface": "allowlisted GitHub API and raw-file retrieval, chapter-source validation, snapshot fallback",
"module_kind": "service",
"module_name": "fetch-textbook",
"network_boundary": "allowlisted read-only HTTPS to api.github.com and raw.githubusercontent.com",
"owner": "Erin Spencer",
"public_surface": "npm run refresh:textbook, generated.textbook",
"rollback": "remove refresh:textbook and the generated chapter routes; source repositories remain unchanged",
"rollout": "required by refresh:data before validation and Eleventy generation",
"storage_boundary": "writes generated textbook data and a last-known-good snapshot",
"summary": "Resolves chapters zero through seven from their owning repositories and emits one provenance-bearing reading dataset.",
"tests": "tests/textbook-integrity.test.mjs, tests/generated-site.test.mjs, tests/site.spec.mjs",
"user_data_boundary": "none"
},
"file": "scripts/fetch-textbook.mjs",
"id": "distributed_textbook_fetch"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "optional GitHub read token",
"network_boundary": "external read-only",
"owner": "Erin Spencer",
"pii": "none beyond what submitters publish themselves",
"secrets": "GITHUB_TOKEN is passed only as an HTTPS authorization header and never written",
"side_effects": "generated dataset and snapshot writes",
"storage_boundary": "write beneath src/_data/generated and src/_data/snapshots",
"summary": "Reads only issues labeled related-work and approved from this repository via the allowlisted GitHub API.",
"user_data_boundary": "public issue content only; submitter login retained as provenance"
},
"file": "scripts/fetch-works.mjs",
"id": "related_works_network_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "optional read-only GITHUB_TOKEN",
"internal_surface": "issue-form body parsing, per-submission validation with visible exclusions, snapshot fallback",
"module_kind": "instrument",
"module_name": "fetch-works",
"network_boundary": "allowlisted read-only HTTPS to api.github.com",
"owner": "Erin Spencer",
"public_surface": "npm run refresh:works, generated.works",
"rollback": "remove refresh:works and the /works/ route; submissions remain as ordinary GitHub issues",
"rollout": "included in refresh:data before validation and Eleventy generation",
"storage_boundary": "writes generated works data and a last-known-good snapshot",
"summary": "Resolves maintainer-approved related-work submissions from GitHub issues into one provenance-bearing works registry dataset.",
"tests": "tests/works-registry.test.mjs",
"user_data_boundary": "publishes only fields submitters place in a public GitHub issue"
},
"file": "scripts/fetch-works.mjs",
"id": "related_works_registry_fetch"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "build fails when a recognized math expression cannot be parsed",
"storage_boundary": "none",
"summary": "Converts repository-controlled TeX expressions to static MathML with untrusted commands disabled and bounded expansion and size.",
"user_data_boundary": "none"
},
"file": "scripts/markdown-math.mjs",
"id": "static_textbook_math_rendering_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "bracket and AMS block rules, inline delimiter rule, fail-closed Temml rendering",
"module_kind": "adapter",
"module_name": "markdown-math",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "installMathRenderer(markdownIt)",
"rollback": "remove installMathRenderer and the Temml dependency; exact chapter Markdown remains available through provenance links",
"rollout": "installed into the repository-owned markdown-it instance in .eleventy.js",
"storage_boundary": "none",
"summary": "Recognizes the textbook's TeX delimiters before Markdown escaping and emits static MathML during the Eleventy build.",
"tests": "tests/math-rendering.test.mjs, tests/generated-site.test.mjs, tests/site.spec.mjs",
"user_data_boundary": "none"
},
"file": "scripts/markdown-math.mjs",
"id": "static_textbook_math_renderer"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "generated canon file",
"storage_boundary": "write",
"summary": "Reads canon snapshots and writes generated canon JSON.",
"user_data_boundary": "none"
},
"file": "scripts/parse-canon.mjs",
"id": "canon_materialization_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "parseCanon invocation and generated JSON write",
"module_kind": "worker",
"module_name": "parse-canon",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "npm run refresh:canon",
"rollback": "restore the previous parser implementation and generated-data contract",
"rollout": "invoked after scripts/fetch-canon.mjs in refresh:data",
"storage_boundary": "write",
"summary": "Reads the selected canon snapshot and writes provenance-bearing generated canon data.",
"tests": "tests/canon-parser.test.mjs, tests/canon-integrity.test.mjs",
"user_data_boundary": "none"
},
"file": "scripts/parse-canon.mjs",
"id": "canon_structure_materializer"
},
{
"block": "BOUNDARIES",
"fields": {
"failure": "exits immediately when any preparation command fails",
"network": "disabled by OFFLINE=1",
"storage": "refreshes generated JSON from repository recovery mirrors and last-known-good snapshots"
},
"file": "scripts/prepare-tests.mjs",
"id": "offline_test_preparation"
},
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "npm test via the pretest lifecycle",
"purpose": "Regenerate canon, project, and distributed-textbook data deterministically before npm test without requiring network access or a full site build.",
"tests": "tests/canon-integrity.test.mjs, tests/textbook-integrity.test.mjs, tests/repo-coverage.test.mjs"
},
"file": "scripts/prepare-tests.mjs",
"id": "offline_test_data_preparation"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "internal",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "loopback listener",
"storage_boundary": "read",
"summary": "Reads generated files and exposes them only on a loopback HTTP test server.",
"user_data_boundary": "none"
},
"file": "scripts/serve-static.mjs",
"id": "generated_site_test_server_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "safePath and static response handler",
"module_kind": "service",
"module_name": "serve-static",
"network_boundary": "internal",
"owner": "Erin Spencer",
"public_surface": "http://127.0.0.1:4173 during Playwright runs",
"rollback": "remove with Playwright webServer configuration and browser checks",
"rollout": "started automatically by playwright.config.mjs",
"storage_boundary": "read",
"summary": "Serves the generated site locally for browser and accessibility release checks.",
"tests": "tests/site.spec.mjs, tests/accessibility.spec.mjs",
"user_data_boundary": "none"
},
"file": "scripts/serve-static.mjs",
"id": "generated_site_test_server"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "none",
"storage_boundary": "read",
"summary": "Reads generated and snapshot artifacts to enforce release integrity.",
"user_data_boundary": "none"
},
"file": "scripts/validate-content.mjs",
"id": "generated_content_validation_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "canon snapshot digest, heading hierarchy, distributed-textbook provenance, study-only research admission, and repository-route assertions",
"module_kind": "instrument",
"module_name": "validate-content",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "npm run validate",
"rollback": "remove the gate only with an explicit replacement preserving provenance, hierarchy, textbook, and route checks",
"rollout": "required by npm run build and npm run check",
"storage_boundary": "read",
"summary": "Refuses deployment when canon identity, heading hierarchy, textbook coverage, study-only research admission, snapshot integrity, generated route coverage, or recovery artifacts drift.",
"tests": "tests/canon-parser.test.mjs, tests/canon-integrity.test.mjs, tests/textbook-integrity.test.mjs, tests/repo-coverage.test.mjs, tests/research-ledger.test.mjs, tests/site-contract.test.mjs",
"user_data_boundary": "none"
},
"file": "scripts/validate-content.mjs",
"id": "generated_content_gate"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "none",
"storage_boundary": "read",
"summary": "Reads canon data and article sources to detect quotation or note drift.",
"user_data_boundary": "none"
},
"file": "scripts/verify-article-canon.mjs",
"id": "article_canon_verification_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "article blockquote extraction and normalized canon comparison",
"module_kind": "instrument",
"module_name": "verify-article-canon",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "npm run validate",
"rollback": "replace only with an equally strict generated excerpt mechanism",
"rollout": "required by validate before Eleventy generation",
"storage_boundary": "read",
"summary": "Verifies every public rights-article page reproduces its complete canonical excerpt and canonical notes.",
"tests": "npm run validate against current generated canon and src/articles",
"user_data_boundary": "none"
},
"file": "scripts/verify-article-canon.mjs",
"id": "article_canon_exactness_gate"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "external",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "bounded external GET requests",
"storage_boundary": "none",
"summary": "Reads public HTTPS build identity from Pages and the custom domain.",
"user_data_boundary": "none"
},
"file": "scripts/verify-live-deployment.mjs",
"id": "public_site_verification_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "bounded HTTPS retries and build.json identity comparison",
"module_kind": "instrument",
"module_name": "verify-live-deployment",
"network_boundary": "external",
"owner": "Erin Spencer",
"public_surface": "node scripts/verify-live-deployment.mjs <base-url> <expected-commit>",
"rollback": "remove only when replaced by another public commit-identity gate",
"rollout": "required after actions/deploy-pages completes",
"storage_boundary": "none",
"summary": "Refuses a green Pages deployment until the public build identity matches the deployed commit.",
"tests": ".github/workflows/pages.yml deployment contact",
"user_data_boundary": "none"
},
"file": "scripts/verify-live-deployment.mjs",
"id": "live_deployment_truth_gate"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "build.json write",
"storage_boundary": "write",
"summary": "Reads canon and textbook provenance and writes public build identity into the generated site.",
"user_data_boundary": "none"
},
"file": "scripts/write-build-info.mjs",
"id": "public_build_identity_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "git commit resolution, canonical provenance projection, chapter-source identity projection",
"module_kind": "worker",
"module_name": "write-build-info",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "_site/build.json",
"rollback": "remove build.json and both live identity checks together",
"rollout": "runs at the end of npm run build",
"storage_boundary": "write",
"summary": "Publishes machine-readable site, canon, and distributed-textbook identities for post-deployment verification.",
"tests": "tests/generated-site.test.mjs, tests/textbook-integrity.test.mjs",
"user_data_boundary": "none"
},
"file": "scripts/write-build-info.mjs",
"id": "public_build_identity"
},
{
"block": "CONTRACTS",
"fields": {
"class": "correctness",
"given": "the website builds the EDCM mathematical reference",
"then": "the rendered Markdown source has the exact SHA-256 and Git blob identity of the commit-pinned EDCM reference"
},
"file": "src/_data/edcm_mathematics.js",
"id": "edcm_reference_bytes_reproduced"
},
{
"block": "CONTRACTS",
"fields": {
"class": "evidence",
"given": "the EDCM mathematical reference is published",
"then": "the EDCM repository, path, commit, Git blob, SHA-256, license, and correction target remain visible"
},
"file": "src/_data/edcm_mathematics.js",
"id": "edcm_reference_source_pin_visible"
},
{
"block": "CONTRACTS",
"fields": {
"class": "safety",
"given": "EDCM equations and status boundaries appear on the website",
"then": "the publication identifies itself as a non-authoritative copy and transfers no canon, proof, theorem, measurement, empirical, or runtime status"
},
"file": "src/_data/edcm_mathematics.js",
"id": "edcm_reference_status_does_not_transfer"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "gitBlobSha1, reference_markdown",
"module_kind": "schema",
"module_name": "edcm-mathematics",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "edcm_mathematics, /artifacts/edcm-mathematics/",
"rollback": "remove this data module, its pinned reference bytes, route, index card, and contract checks together",
"rollout": "loaded by Eleventy and linked from /artifacts/",
"since": "2026-08-02",
"storage_boundary": "read",
"summary": "Publishes an exact commit-pinned reproduction of the EDCM mathematical reference without creating a second mathematical authority.",
"tests": "tests/edcm-mathematics.test.mjs, tests/generated-site.test.mjs",
"unresolved": "Git content identities detect drift but do not provide a cryptographic producer signature",
"user_data_boundary": "none"
},
"file": "src/_data/edcm_mathematics.js",
"id": "edcm_mathematics_public_artifact_record"
},
{
"block": "BOUNDARIES",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"network_boundary": "none",
"owner": "Erin Spencer",
"pii": "none",
"secrets": "none",
"side_effects": "none",
"storage_boundary": "read beneath src/_data/research only",
"summary": "Reads allowlisted repository-local YAML ledgers, rejects incomplete classifications, and returns study-only public arrays.",
"user_data_boundary": "none"
},
"file": "src/_data/research_data.js",
"id": "article_lab_research_data_storage_boundary"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "validateLedgerPaths, readYamlList, readYamlLedgers, indexUnique",
"module_kind": "adapter",
"module_name": "research_data",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "research_data.sources, research_data.claims, research_data.gaps, research_data.stats",
"rollback": "revert this adapter and the admission-ledger manifest entries together",
"rollout": "loaded automatically by Eleventy from src/_data/research_data.js",
"storage_boundary": "read the repository-owned candidate, admission, claim-review, and gap ledgers",
"summary": "Admits only research studies from manifest-declared candidate ledgers and exposes their bounded claims, reviews, and evidence gaps.",
"tests": "tests/research-ledger.test.mjs, tests/generated-site.test.mjs",
"user_data_boundary": "none"
},
"file": "src/_data/research_data.js",
"id": "article_lab_research_data_adapter"
},
{
"block": "MODULE_BUILD",
"fields": {
"entrypoint": "loaded with defer from the base layout",
"purpose": "Add a compact mobile navigation toggle without hiding static content.",
"tests": "tests/site-contract.test.mjs"
},
"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": "safety",
"given": "a reader encounters energy, current, drift, coherence, tensor, runtime, or orchestration vocabulary in copied source text",
"then": "the reader treats it according to source-local status and makes no present-state, measurement, access, synchronization, or capability claim without supplied cited evidence"
},
"file": "src/eai/aicontext.11ty.js",
"id": "ai_context_grounded_inference_boundary"
},
{
"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": "CONTRACTS",
"fields": {
"class": "accessibility",
"given": "the static site is built",
"then": "/llms.txt, homepage navigation, alternate-link metadata, and /sitemap.xml expose /eai/aicontext.md without changing its byte-zero contract"
},
"file": "src/eai/aicontext.11ty.js",
"id": "ai_context_public_discovery"
},
{
"block": "CONTRACTS",
"fields": {
"class": "identity",
"given": "the public biography is parsed as JSON-LD",
"then": "Erin Spencer has one canonical fragment @id on the deployed non-www endpoint and the identifier grants no authentication, authorization, runtime connection, or access"
},
"file": "src/eai/aicontext.11ty.js",
"id": "ai_context_stable_person_identity"
},
{
"block": "LLMS",
"fields": {
"content": "- `/eai/aicontext.md` begins at byte zero with Erin Spencer's connection contract, then publishes grounded interpretation rules, exact canon, eight exact source-owned textbook chapters, public biography JSON-LD, work-graph identity, and publication provenance."
},
"file": "src/eai/aicontext.11ty.js",
"id": "architecture_summary"
},
{
"block": "LLMS",
"fields": {
"ai_context": "One ordered machine-oriented Markdown artifact carrying the author contract, exact distributed source copies, public biography JSON-LD, provenance, interpretation boundaries, and unresolved continuation.",
"canon": "The canonical text of The Interdependent Way lives only at `wayseer00/main:canon/INTERDEPENDENT_WAY.txt`; website copies do not become authority.",
"hmmm": "The mandatory boundary object for unresolved constraints and honest incompletion.",
"json_ld_at_id": "A stable public identifier for one JSON-LD subject; it does not authenticate a person, authorize an action, connect a runtime, or grant access.",
"public_biography": "An author-requested public project biography with explicit privacy exclusions and field-level correction routing."
},
"file": "src/eai/aicontext.11ty.js",
"id": "key_definitions"
},
{
"block": "LLMS",
"fields": {
"content": "The Interdependent Way website is a static-first publication consumer for the sole canon in `wayseer00/main`, the distributed Interdependency textbook, and bounded public project context. Its machine entry point is `/eai/aicontext.md`."
},
"file": "src/eai/aicontext.11ty.js",
"id": "project_overview"
},
{
"block": "LLMS",
"fields": {
"content": "- Read `/eai/aicontext.md` from its first byte and preserve its source order, status labels, provenance, privacy limits, and `hmmm` boundaries."
},
"file": "src/eai/aicontext.11ty.js",
"id": "usage_rules"
},
{
"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, interdependentway.inference-boundary/1.0.0",
"internal_surface": "renderAiContext, buildWorkGraph, buildPublicationManifest, interpretationBoundary",
"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 discoverable, machine-oriented Markdown context file containing the exact connection contract, grounded interpretation rules, 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, empirical effectiveness across independent model providers",
"user_data_boundary": "read"
},
"file": "src/eai/aicontext.11ty.js",
"id": "ai_context_publication"
},
{
"block": "MODULE_BUILD",
"fields": {
"admin_only": "false",
"auth_boundary": "none",
"internal_surface": "SitemapTemplate.render, collections.all, site.url",
"module_kind": "route",
"module_name": "sitemap",
"network_boundary": "none",
"owner": "Erin Spencer",
"public_surface": "/sitemap.xml",
"rollback": "remove this template and its discovery checks",
"rollout": "emitted by every Eleventy build",
"storage_boundary": "none",
"summary": "Publishes stable public page locations plus the collection-excluded AI-context endpoint for machine discovery.",
"tests": "tests/site-contract.test.mjs, tests/generated-site.test.mjs",
"user_data_boundary": "none"
},
"file": "src/sitemap.11ty.js",
"id": "public_sitemap"
},
{
"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::checkGroundedInferenceBoundary",
"cleanup": "none",
"mutates": "none",
"proves": "ai_context_grounded_inference_boundary",
"requires": "node",
"timeout": "10"
},
"file": "tests/aicontext.test.mjs",
"id": "check_ai_context_grounded_inference_boundary"
},
{
"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"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkStablePersonIdentity",
"cleanup": "none",
"mutates": "none",
"proves": "ai_context_stable_person_identity",
"requires": "node",
"timeout": "10"
},
"file": "tests/aicontext.test.mjs",
"id": "check_ai_context_stable_person_identity"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkReferenceBytesReproduced",
"cleanup": "none",
"mutates": "none",
"proves": "edcm_reference_bytes_reproduced",
"requires": "node",
"timeout": "10"
},
"file": "tests/edcm-mathematics.test.mjs",
"id": "check_edcm_reference_bytes_reproduced"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkSourcePinVisible",
"cleanup": "none",
"mutates": "none",
"proves": "edcm_reference_source_pin_visible",
"requires": "node",
"timeout": "10"
},
"file": "tests/edcm-mathematics.test.mjs",
"id": "check_edcm_reference_source_pin_visible"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkStatusDoesNotTransfer",
"cleanup": "none",
"mutates": "none",
"proves": "edcm_reference_status_does_not_transfer",
"requires": "node",
"timeout": "10"
},
"file": "tests/edcm-mathematics.test.mjs",
"id": "check_edcm_reference_status_does_not_transfer"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkAiContextPublicDiscovery",
"cleanup": "none",
"mutates": "none",
"proves": "ai_context_public_discovery",
"requires": "node",
"timeout": "10"
},
"file": "tests/generated-site.test.mjs",
"id": "check_ai_context_public_discovery"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkLlmsMarkdownExamplesIgnored",
"cleanup": "none",
"mutates": "none",
"proves": "llms_markdown_examples_ignored",
"requires": "node",
"timeout": "10"
},
"file": "tests/llms-build.test.mjs",
"id": "check_llms_markdown_examples_ignored"
},
{
"block": "CHECKS",
"fields": {
"call": "self::checkLlmsRootGeneratedFromDeclarations",
"cleanup": "none",
"mutates": "none",
"proves": "llms_root_generated_from_declarations",
"requires": "node",
"timeout": "10"
},
"file": "tests/llms-build.test.mjs",