@mc-and-his-agents/loom-installer 0.1.39 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/package.json +1 -1
  2. package/payload/manifest.json +62 -62
  3. package/payload/plugin/loom/skills/shared/scripts/fact_chain_support.py +34 -0
  4. package/payload/plugin/loom/skills/shared/scripts/loom_check.py +150 -0
  5. package/payload/plugin/loom/skills/shared/scripts/loom_flow.py +119 -16
  6. package/payload/skills/loom-adopt/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  7. package/payload/skills/loom-adopt/.loom-runtime/shared/scripts/loom_check.py +150 -0
  8. package/payload/skills/loom-adopt/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  9. package/payload/skills/loom-handoff/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  10. package/payload/skills/loom-handoff/.loom-runtime/shared/scripts/loom_check.py +150 -0
  11. package/payload/skills/loom-handoff/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  12. package/payload/skills/loom-init/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  13. package/payload/skills/loom-init/.loom-runtime/shared/scripts/loom_check.py +150 -0
  14. package/payload/skills/loom-init/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  15. package/payload/skills/loom-merge-ready/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  16. package/payload/skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_check.py +150 -0
  17. package/payload/skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  18. package/payload/skills/loom-pre-review/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  19. package/payload/skills/loom-pre-review/.loom-runtime/shared/scripts/loom_check.py +150 -0
  20. package/payload/skills/loom-pre-review/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  21. package/payload/skills/loom-resume/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  22. package/payload/skills/loom-resume/.loom-runtime/shared/scripts/loom_check.py +150 -0
  23. package/payload/skills/loom-resume/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  24. package/payload/skills/loom-retire/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  25. package/payload/skills/loom-retire/.loom-runtime/shared/scripts/loom_check.py +150 -0
  26. package/payload/skills/loom-retire/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  27. package/payload/skills/loom-review/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  28. package/payload/skills/loom-review/.loom-runtime/shared/scripts/loom_check.py +150 -0
  29. package/payload/skills/loom-review/.loom-runtime/shared/scripts/loom_flow.py +119 -16
  30. package/payload/skills/loom-spec-review/.loom-runtime/shared/scripts/fact_chain_support.py +34 -0
  31. package/payload/skills/loom-spec-review/.loom-runtime/shared/scripts/loom_check.py +150 -0
  32. package/payload/skills/loom-spec-review/.loom-runtime/shared/scripts/loom_flow.py +119 -16
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mc-and-his-agents/loom-installer",
3
- "version": "0.1.39",
3
+ "version": "0.1.41",
4
4
  "description": "Node installer for Loom plugin and single-skill installation surfaces.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -2,9 +2,9 @@
2
2
  "schema_version": "loom-installer-payload/v1",
3
3
  "loom_version": "0.4.0",
4
4
  "source_repository": "https://github.com/MC-and-his-Agents/Loom",
5
- "source_commit": "a0094e42a22f72429dccc3f437df2d86b084544d",
5
+ "source_commit": "348e5ac4d5c30e78a985865f38f792d40fd278fa",
6
6
  "source_ref": "main",
7
- "built_at": "2026-04-27T16:28:18+08:00",
7
+ "built_at": "2026-04-27T17:41:47+08:00",
8
8
  "runtime": {
9
9
  "python_minimum": "3.10",
10
10
  "python_recommended": "3.11+"
@@ -623,8 +623,8 @@
623
623
  },
624
624
  {
625
625
  "path": "plugin/loom/skills/shared/scripts/fact_chain_support.py",
626
- "bytes": 21748,
627
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
626
+ "bytes": 22966,
627
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
628
628
  },
629
629
  {
630
630
  "path": "plugin/loom/skills/shared/scripts/governance_surface.py",
@@ -633,13 +633,13 @@
633
633
  },
634
634
  {
635
635
  "path": "plugin/loom/skills/shared/scripts/loom_check.py",
636
- "bytes": 340603,
637
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
636
+ "bytes": 347978,
637
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
638
638
  },
639
639
  {
640
640
  "path": "plugin/loom/skills/shared/scripts/loom_flow.py",
641
- "bytes": 334363,
642
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
641
+ "bytes": 338788,
642
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
643
643
  },
644
644
  {
645
645
  "path": "plugin/loom/skills/shared/scripts/loom_init.py",
@@ -1213,8 +1213,8 @@
1213
1213
  },
1214
1214
  {
1215
1215
  "path": "skills/loom-adopt/.loom-runtime/shared/scripts/fact_chain_support.py",
1216
- "bytes": 21748,
1217
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
1216
+ "bytes": 22966,
1217
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
1218
1218
  },
1219
1219
  {
1220
1220
  "path": "skills/loom-adopt/.loom-runtime/shared/scripts/governance_surface.py",
@@ -1223,13 +1223,13 @@
1223
1223
  },
1224
1224
  {
1225
1225
  "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_check.py",
1226
- "bytes": 340603,
1227
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
1226
+ "bytes": 347978,
1227
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
1228
1228
  },
1229
1229
  {
1230
1230
  "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_flow.py",
1231
- "bytes": 334363,
1232
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
1231
+ "bytes": 338788,
1232
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
1233
1233
  },
1234
1234
  {
1235
1235
  "path": "skills/loom-adopt/.loom-runtime/shared/scripts/loom_init.py",
@@ -1833,8 +1833,8 @@
1833
1833
  },
1834
1834
  {
1835
1835
  "path": "skills/loom-handoff/.loom-runtime/shared/scripts/fact_chain_support.py",
1836
- "bytes": 21748,
1837
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
1836
+ "bytes": 22966,
1837
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
1838
1838
  },
1839
1839
  {
1840
1840
  "path": "skills/loom-handoff/.loom-runtime/shared/scripts/governance_surface.py",
@@ -1843,13 +1843,13 @@
1843
1843
  },
1844
1844
  {
1845
1845
  "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_check.py",
1846
- "bytes": 340603,
1847
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
1846
+ "bytes": 347978,
1847
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
1848
1848
  },
1849
1849
  {
1850
1850
  "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_flow.py",
1851
- "bytes": 334363,
1852
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
1851
+ "bytes": 338788,
1852
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
1853
1853
  },
1854
1854
  {
1855
1855
  "path": "skills/loom-handoff/.loom-runtime/shared/scripts/loom_init.py",
@@ -2453,8 +2453,8 @@
2453
2453
  },
2454
2454
  {
2455
2455
  "path": "skills/loom-init/.loom-runtime/shared/scripts/fact_chain_support.py",
2456
- "bytes": 21748,
2457
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
2456
+ "bytes": 22966,
2457
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
2458
2458
  },
2459
2459
  {
2460
2460
  "path": "skills/loom-init/.loom-runtime/shared/scripts/governance_surface.py",
@@ -2463,13 +2463,13 @@
2463
2463
  },
2464
2464
  {
2465
2465
  "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_check.py",
2466
- "bytes": 340603,
2467
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
2466
+ "bytes": 347978,
2467
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
2468
2468
  },
2469
2469
  {
2470
2470
  "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_flow.py",
2471
- "bytes": 334363,
2472
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
2471
+ "bytes": 338788,
2472
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
2473
2473
  },
2474
2474
  {
2475
2475
  "path": "skills/loom-init/.loom-runtime/shared/scripts/loom_init.py",
@@ -3078,8 +3078,8 @@
3078
3078
  },
3079
3079
  {
3080
3080
  "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/fact_chain_support.py",
3081
- "bytes": 21748,
3082
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
3081
+ "bytes": 22966,
3082
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
3083
3083
  },
3084
3084
  {
3085
3085
  "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/governance_surface.py",
@@ -3088,13 +3088,13 @@
3088
3088
  },
3089
3089
  {
3090
3090
  "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_check.py",
3091
- "bytes": 340603,
3092
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
3091
+ "bytes": 347978,
3092
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
3093
3093
  },
3094
3094
  {
3095
3095
  "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_flow.py",
3096
- "bytes": 334363,
3097
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
3096
+ "bytes": 338788,
3097
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
3098
3098
  },
3099
3099
  {
3100
3100
  "path": "skills/loom-merge-ready/.loom-runtime/shared/scripts/loom_init.py",
@@ -3698,8 +3698,8 @@
3698
3698
  },
3699
3699
  {
3700
3700
  "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/fact_chain_support.py",
3701
- "bytes": 21748,
3702
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
3701
+ "bytes": 22966,
3702
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
3703
3703
  },
3704
3704
  {
3705
3705
  "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/governance_surface.py",
@@ -3708,13 +3708,13 @@
3708
3708
  },
3709
3709
  {
3710
3710
  "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_check.py",
3711
- "bytes": 340603,
3712
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
3711
+ "bytes": 347978,
3712
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
3713
3713
  },
3714
3714
  {
3715
3715
  "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_flow.py",
3716
- "bytes": 334363,
3717
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
3716
+ "bytes": 338788,
3717
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
3718
3718
  },
3719
3719
  {
3720
3720
  "path": "skills/loom-pre-review/.loom-runtime/shared/scripts/loom_init.py",
@@ -4318,8 +4318,8 @@
4318
4318
  },
4319
4319
  {
4320
4320
  "path": "skills/loom-resume/.loom-runtime/shared/scripts/fact_chain_support.py",
4321
- "bytes": 21748,
4322
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
4321
+ "bytes": 22966,
4322
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
4323
4323
  },
4324
4324
  {
4325
4325
  "path": "skills/loom-resume/.loom-runtime/shared/scripts/governance_surface.py",
@@ -4328,13 +4328,13 @@
4328
4328
  },
4329
4329
  {
4330
4330
  "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_check.py",
4331
- "bytes": 340603,
4332
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
4331
+ "bytes": 347978,
4332
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
4333
4333
  },
4334
4334
  {
4335
4335
  "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_flow.py",
4336
- "bytes": 334363,
4337
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
4336
+ "bytes": 338788,
4337
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
4338
4338
  },
4339
4339
  {
4340
4340
  "path": "skills/loom-resume/.loom-runtime/shared/scripts/loom_init.py",
@@ -4938,8 +4938,8 @@
4938
4938
  },
4939
4939
  {
4940
4940
  "path": "skills/loom-retire/.loom-runtime/shared/scripts/fact_chain_support.py",
4941
- "bytes": 21748,
4942
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
4941
+ "bytes": 22966,
4942
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
4943
4943
  },
4944
4944
  {
4945
4945
  "path": "skills/loom-retire/.loom-runtime/shared/scripts/governance_surface.py",
@@ -4948,13 +4948,13 @@
4948
4948
  },
4949
4949
  {
4950
4950
  "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_check.py",
4951
- "bytes": 340603,
4952
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
4951
+ "bytes": 347978,
4952
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
4953
4953
  },
4954
4954
  {
4955
4955
  "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_flow.py",
4956
- "bytes": 334363,
4957
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
4956
+ "bytes": 338788,
4957
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
4958
4958
  },
4959
4959
  {
4960
4960
  "path": "skills/loom-retire/.loom-runtime/shared/scripts/loom_init.py",
@@ -5558,8 +5558,8 @@
5558
5558
  },
5559
5559
  {
5560
5560
  "path": "skills/loom-review/.loom-runtime/shared/scripts/fact_chain_support.py",
5561
- "bytes": 21748,
5562
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
5561
+ "bytes": 22966,
5562
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
5563
5563
  },
5564
5564
  {
5565
5565
  "path": "skills/loom-review/.loom-runtime/shared/scripts/governance_surface.py",
@@ -5568,13 +5568,13 @@
5568
5568
  },
5569
5569
  {
5570
5570
  "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_check.py",
5571
- "bytes": 340603,
5572
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
5571
+ "bytes": 347978,
5572
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
5573
5573
  },
5574
5574
  {
5575
5575
  "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_flow.py",
5576
- "bytes": 334363,
5577
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
5576
+ "bytes": 338788,
5577
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
5578
5578
  },
5579
5579
  {
5580
5580
  "path": "skills/loom-review/.loom-runtime/shared/scripts/loom_init.py",
@@ -6178,8 +6178,8 @@
6178
6178
  },
6179
6179
  {
6180
6180
  "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/fact_chain_support.py",
6181
- "bytes": 21748,
6182
- "sha256": "e5c52cda01f1107cafcd00bf2d37feaa167f1acd5152fc8f41f28ee3255a7d52"
6181
+ "bytes": 22966,
6182
+ "sha256": "78cf0d0022a4c03933a5e46cba676e80cafa5d0802fb95191a761ec9f9417e65"
6183
6183
  },
6184
6184
  {
6185
6185
  "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/governance_surface.py",
@@ -6188,13 +6188,13 @@
6188
6188
  },
6189
6189
  {
6190
6190
  "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_check.py",
6191
- "bytes": 340603,
6192
- "sha256": "8affea751d682b3bcb0fd975652b7c09c9af2cebe5a7dd069d0e64a3e9ce6858"
6191
+ "bytes": 347978,
6192
+ "sha256": "f5119cf04e195c79dfeb58c33c5d4c8e524c2eb2b162b5906cc04a655465543e"
6193
6193
  },
6194
6194
  {
6195
6195
  "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_flow.py",
6196
- "bytes": 334363,
6197
- "sha256": "e9b376551600383e95e4f707557bb957edf51cd9ee2263587b8b6109088b737c"
6196
+ "bytes": 338788,
6197
+ "sha256": "e5f386988863d970ebf5415bfdb3a91159b120a84d3acd82ca3435be6f9af19c"
6198
6198
  },
6199
6199
  {
6200
6200
  "path": "skills/loom-spec-review/.loom-runtime/shared/scripts/loom_init.py",
@@ -204,6 +204,40 @@ def resolve_repo_relative_path(target_root: Path, relative: str, *, label: str)
204
204
  return candidate, []
205
205
 
206
206
 
207
+ def path_boundary_missing_details(*, label: str, locator: object, errors: list[str]) -> list[dict[str, object]]:
208
+ """Return stable machine-readable details for repo locator boundary failures."""
209
+ locator_text = "" if locator is None else str(locator)
210
+ details: list[dict[str, object]] = []
211
+ for message in errors:
212
+ if "non-empty" in message:
213
+ kind = "empty_locator"
214
+ elif "absolute path" in message or "repo-relative" in message:
215
+ kind = "absolute_locator"
216
+ else:
217
+ kind = "repo_locator_escape"
218
+
219
+ scopes: list[str] = []
220
+ if "target root" in message:
221
+ scopes.append("target_root")
222
+ if "repository" in message or "repo-relative" in message:
223
+ scopes.append("repository_root")
224
+ if not scopes:
225
+ scopes.append("repository_root")
226
+
227
+ for scope in scopes:
228
+ details.append(
229
+ {
230
+ "category": "path_boundary",
231
+ "kind": kind,
232
+ "scope": scope,
233
+ "label": label,
234
+ "locator": locator_text,
235
+ "message": message,
236
+ }
237
+ )
238
+ return details
239
+
240
+
207
241
  def parse_work_item(path: Path, root: Path) -> tuple[dict[str, object], list[str]]:
208
242
  relative_path = _relative(path, root)
209
243
  sections = markdown_sections(path)
@@ -1062,6 +1062,26 @@ def require_repo_specific_requirements_payload(
1062
1062
  failures.append(Failure(category, f"{context} declared requirements must split cleanly into blocking and advisory"))
1063
1063
 
1064
1064
 
1065
+ def require_missing_details(
1066
+ failures: list[Failure],
1067
+ *,
1068
+ category: str,
1069
+ context: str,
1070
+ details: object,
1071
+ ) -> None:
1072
+ if not isinstance(details, list):
1073
+ failures.append(Failure(category, f"{context} must be a list"))
1074
+ return
1075
+ for index, detail in enumerate(details):
1076
+ if not isinstance(detail, dict):
1077
+ failures.append(Failure(category, f"{context}[{index}] must be an object"))
1078
+ continue
1079
+ for field in ("category", "kind", "scope", "label", "locator", "message"):
1080
+ value = detail.get(field)
1081
+ if not isinstance(value, str) or not value:
1082
+ failures.append(Failure(category, f"{context}[{index}] missing `{field}`"))
1083
+
1084
+
1065
1085
  def require_shadow_parity_payload(
1066
1086
  failures: list[Failure],
1067
1087
  *,
@@ -1090,6 +1110,14 @@ def require_shadow_parity_payload(
1090
1110
  failures.append(Failure(category, f"{context} must include non-empty `summary`"))
1091
1111
  if not isinstance(payload.get("missing_inputs"), list):
1092
1112
  failures.append(Failure(category, f"{context} must include `missing_inputs`"))
1113
+ top_level_details = payload.get("missing_details")
1114
+ if top_level_details is not None:
1115
+ require_missing_details(
1116
+ failures,
1117
+ category=category,
1118
+ context=f"{context}.missing_details",
1119
+ details=top_level_details,
1120
+ )
1093
1121
  require_runtime_state_payload(
1094
1122
  failures,
1095
1123
  category=category,
@@ -1133,6 +1161,14 @@ def require_shadow_parity_payload(
1133
1161
  failures.append(Failure(category, f"{context} reports[{index}] must include non-empty `summary`"))
1134
1162
  if not isinstance(report.get("missing_inputs"), list):
1135
1163
  failures.append(Failure(category, f"{context} reports[{index}] must include `missing_inputs`"))
1164
+ report_details = report.get("missing_details")
1165
+ if report_details is not None:
1166
+ require_missing_details(
1167
+ failures,
1168
+ category=category,
1169
+ context=f"{context} reports[{index}].missing_details",
1170
+ details=report_details,
1171
+ )
1136
1172
  for key in ("host_adapters", "repo_native_carriers"):
1137
1173
  if not isinstance(report.get(key), list):
1138
1174
  failures.append(Failure(category, f"{context} reports[{index}] must include `{key}` as a list"))
@@ -3654,6 +3690,42 @@ def check_daily_execution_cli(root: Path) -> list[Failure]:
3654
3690
  elif payload.get("result") != "pass":
3655
3691
  failures.append(Failure("daily-execution-cli", "`work-item update` must pass on a clean temp copy"))
3656
3692
 
3693
+ poisoned_authoring_target = temp_root / "authoring-poisoned-workspace"
3694
+ shutil.copytree(authoring_target, poisoned_authoring_target)
3695
+ poisoned_work_item = poisoned_authoring_target / ".loom/work-items/NEXT-0001.md"
3696
+ poisoned_before = poisoned_work_item.read_text(encoding="utf-8").replace(
3697
+ "- Workspace Entry: .",
3698
+ "- Workspace Entry: ../outside.md",
3699
+ )
3700
+ poisoned_work_item.write_text(poisoned_before, encoding="utf-8")
3701
+ poisoned_init = poisoned_authoring_target / ".loom/bootstrap/init-result.json"
3702
+ poisoned_init_before = load_json_file(poisoned_init)
3703
+ payload, error = load_command_json(
3704
+ root,
3705
+ [
3706
+ "python3",
3707
+ "tools/loom_flow.py",
3708
+ "work-item",
3709
+ "update",
3710
+ "--target",
3711
+ str(poisoned_authoring_target),
3712
+ "--item",
3713
+ "NEXT-0001",
3714
+ "--scope",
3715
+ "This update must not persist because the workspace locator is unsafe",
3716
+ "--activate",
3717
+ ],
3718
+ )
3719
+ poisoned_init_after = load_json_file(poisoned_init)
3720
+ if error:
3721
+ failures.append(Failure("daily-execution-cli", f"`work-item update --activate` poisoned workspace sample failed: {error}"))
3722
+ elif payload.get("result") != "block":
3723
+ failures.append(Failure("daily-execution-cli", "`work-item update --activate` must block poisoned workspace locators"))
3724
+ elif poisoned_work_item.read_text(encoding="utf-8") != poisoned_before:
3725
+ failures.append(Failure("daily-execution-cli", "`work-item update --activate` must not rewrite a poisoned Work Item before locator validation passes"))
3726
+ elif poisoned_init_after.get("fact_chain", {}).get("entry_points") != poisoned_init_before.get("fact_chain", {}).get("entry_points"):
3727
+ failures.append(Failure("daily-execution-cli", "`work-item update --activate` must not mutate active fact-chain locators when locator validation blocks"))
3728
+
3657
3729
  payload, error = load_command_json(
3658
3730
  root,
3659
3731
  [
@@ -6460,6 +6532,43 @@ def check_adversarial_adoption_fixture(root: Path) -> list[Failure]:
6460
6532
  ):
6461
6533
  failures.append(Failure("adversarial-adoption", "shadow surface path-boundary errors must expose a stable repository anchor"))
6462
6534
 
6535
+ shadow_boundary_target = base / "shadow-structured-boundary"
6536
+ (shadow_boundary_target / ".loom/companion").mkdir(parents=True)
6537
+ write_json(
6538
+ shadow_boundary_target / ".loom/companion/interop.json",
6539
+ {
6540
+ "schema_version": "loom-repo-interop/v1",
6541
+ "host_adapters": [],
6542
+ "repo_native_carriers": [],
6543
+ "shadow_surfaces": {
6544
+ "review": {
6545
+ "summary": "review parity",
6546
+ "loom_locator": "../outside-loom.json",
6547
+ "repo_locator": "../outside-repo.json",
6548
+ }
6549
+ },
6550
+ },
6551
+ )
6552
+ shadow_boundary_report = loom_flow_module.shadow_parity_report(
6553
+ {
6554
+ "availability": "present",
6555
+ "contract": {"locator": ".loom/companion/interop.json"},
6556
+ },
6557
+ target_root=shadow_boundary_target,
6558
+ surface="review",
6559
+ )
6560
+ shadow_boundary_details = shadow_boundary_report.get("missing_details")
6561
+ if not isinstance(shadow_boundary_details, list) or not any(
6562
+ isinstance(detail, dict)
6563
+ and detail.get("category") == "path_boundary"
6564
+ and detail.get("kind") == "repo_locator_escape"
6565
+ and detail.get("scope") == "repository_root"
6566
+ and detail.get("label") == "shadow surface `review` repo_locator"
6567
+ and detail.get("locator") == "../outside-repo.json"
6568
+ for detail in shadow_boundary_details
6569
+ ):
6570
+ failures.append(Failure("adversarial-adoption", "shadow parity path-boundary failures must expose structured missing_details"))
6571
+
6463
6572
  spec_contract_target = base / "spec-contract"
6464
6573
  (spec_contract_target / ".loom/specs/INIT-0001").mkdir(parents=True)
6465
6574
  (spec_contract_target / ".loom/specs/INIT-0001/spec.md").write_text("bootstrap spec\n", encoding="utf-8")
@@ -6605,6 +6714,38 @@ def check_adversarial_adoption_fixture(root: Path) -> list[Failure]:
6605
6714
  elif escape_work_item_payload.get("result") != "block":
6606
6715
  failures.append(Failure("adversarial-adoption", "work-item create must block recovery locators that escape the target root"))
6607
6716
 
6717
+ poisoned_work_item_target = base / "work-item-update-poisoned-locator"
6718
+ shutil.copytree(baseline, poisoned_work_item_target)
6719
+ poisoned_work_item_path = poisoned_work_item_target / ".loom/work-items/INIT-0001.md"
6720
+ poisoned_work_item_text = poisoned_work_item_path.read_text(encoding="utf-8").replace(
6721
+ "- Recovery Entry: .loom/progress/INIT-0001.md",
6722
+ "- Recovery Entry: ../outside.md",
6723
+ )
6724
+ poisoned_work_item_path.write_text(poisoned_work_item_text, encoding="utf-8")
6725
+ poisoned_init_path = poisoned_work_item_target / ".loom/bootstrap/init-result.json"
6726
+ poisoned_init_before = poisoned_init_path.read_text(encoding="utf-8")
6727
+ poisoned_update_payload, error = load_command_json(
6728
+ root,
6729
+ [
6730
+ "python3",
6731
+ "tools/loom_flow.py",
6732
+ "work-item",
6733
+ "update",
6734
+ "--target",
6735
+ str(poisoned_work_item_target),
6736
+ "--item",
6737
+ "INIT-0001",
6738
+ "--activate",
6739
+ ],
6740
+ )
6741
+ poisoned_init_after = poisoned_init_path.read_text(encoding="utf-8")
6742
+ if error:
6743
+ failures.append(Failure("adversarial-adoption", f"poisoned work-item update sample failed: {error}"))
6744
+ elif poisoned_update_payload.get("result") != "block":
6745
+ failures.append(Failure("adversarial-adoption", "work-item update --activate must block poisoned recovery locators"))
6746
+ elif poisoned_init_before != poisoned_init_after:
6747
+ failures.append(Failure("adversarial-adoption", "work-item update --activate must not mutate init-result before locator validation passes"))
6748
+
6608
6749
  shadow_escape_target = base / "shadow-locator-escape"
6609
6750
  shutil.copytree(baseline, shadow_escape_target)
6610
6751
  interop_path = shadow_escape_target / ".loom/companion/interop.json"
@@ -6622,6 +6763,15 @@ def check_adversarial_adoption_fixture(root: Path) -> list[Failure]:
6622
6763
  failures.append(Failure("adversarial-adoption", f"path escape shadow-parity sample failed: {error}"))
6623
6764
  elif shadow_escape_payload.get("result") != "block":
6624
6765
  failures.append(Failure("adversarial-adoption", "shadow-parity blocking mode must reject absolute shadow locators"))
6766
+ else:
6767
+ shadow_escape_details = shadow_escape_payload.get("missing_details")
6768
+ if not isinstance(shadow_escape_details, list) or not any(
6769
+ isinstance(detail, dict)
6770
+ and detail.get("category") == "path_boundary"
6771
+ and "loom_locator" in str(detail.get("label", ""))
6772
+ for detail in shadow_escape_details
6773
+ ):
6774
+ failures.append(Failure("adversarial-adoption", "shadow-parity CLI payload must aggregate structured path-boundary missing_details"))
6625
6775
 
6626
6776
  poisoned_payload, error = load_command_json(
6627
6777
  root,