mcard-studio 0.0.1 → 0.0.3

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 (212) hide show
  1. package/README.md +3 -0
  2. package/astro.config.mjs +46 -2
  3. package/bin/mcard-studio.mjs +1 -1
  4. package/cli/lib/runtimeContext.mjs +6 -3
  5. package/dist/client/_astro/{ChartAnalyticsViewlet.Cevj0EOs.js → ChartAnalyticsViewlet.CBW-JyA3.js} +1 -1
  6. package/dist/client/_astro/ClmPcardViewlet.cvKsR2ng.js +3 -0
  7. package/dist/client/_astro/D3GraphViewlet.8YEIrCGL.js +2 -0
  8. package/dist/client/_astro/DockviewSpatialWorkbench.BTd66LPl.js +12 -0
  9. package/dist/client/_astro/DocumentViewlets.KY1HcNka.js +2 -0
  10. package/dist/client/_astro/DxfViewlet.B3N5zpZR.js +1 -0
  11. package/dist/client/_astro/ExcalidrawWhiteboardViewlet.CMJGCQN4.js +1 -0
  12. package/dist/client/_astro/{FaroVCardSpanInstrumenter.BIk2NhJY.js → FaroVCardSpanInstrumenter.ClIqZujq.js} +1 -1
  13. package/dist/client/_astro/{FontSpecimenViewlet.CpONhJh0.js → FontSpecimenViewlet.ChIyr0B8.js} +1 -1
  14. package/dist/client/_astro/HeadMeta.astro_astro_type_script_index_0_lang.D3FSc061.js +1 -0
  15. package/dist/client/_astro/{ImageViewlet.CHeNvX6L.js → ImageViewlet.Cs-u7-wt.js} +1 -1
  16. package/dist/client/_astro/{KatexFormulaViewlet.Cy_InWOK.js → KatexFormulaViewlet.0nOzV_qD.js} +1 -1
  17. package/dist/client/_astro/KoishiChatViewlet.DLsMmwdb.js +16 -0
  18. package/dist/client/_astro/MCardLibraryHarness.WBT9W10S.js +2 -0
  19. package/dist/client/_astro/{MarkdownViewlet.qoPlM-TZ.js → MarkdownViewlet.BIolkNXf.js} +25 -25
  20. package/dist/client/_astro/{MermaidDiagramViewlet.RnwDfQl6.js → MermaidDiagramViewlet.CkRk7QsS.js} +1 -1
  21. package/dist/client/_astro/PCardRendererBridge.DhaRSprd.js +1 -0
  22. package/dist/client/_astro/RendererPCardRegistry.brM2KiQs.js +1 -0
  23. package/dist/client/_astro/{SchemaYamlViewlet.D6HVdmrq.js → SchemaYamlViewlet.Bc7nkK4M.js} +1 -1
  24. package/dist/client/_astro/{ShellContainer.astro_astro_type_script_index_0_lang.2oi8fhQo.js → ShellContainer.astro_astro_type_script_index_0_lang.5q1gCLvf.js} +1 -1
  25. package/dist/client/_astro/{Spatial3dViewlet.CCYBSSib.js → Spatial3dViewlet.C-jjhr0A.js} +1 -1
  26. package/dist/client/_astro/{StudioLayout.CBgiVbeb.css → StudioLayout.CX8XGtZV.css} +1 -1
  27. package/dist/client/_astro/StudioWorkbench.B1QwGHWM.js +7 -0
  28. package/dist/client/_astro/{SvgViewlet.BxlWQ-JX.js → SvgViewlet.uGxvb06H.js} +1 -1
  29. package/dist/client/_astro/{TerminalView.DWZR-hUa.js → TerminalView.DP7G7E1m.js} +4 -4
  30. package/dist/client/_astro/{ThemeSettingsViewlet.Cb1r8fWw.js → ThemeSettingsViewlet.UaTHcGnF.js} +1 -1
  31. package/dist/client/_astro/{TikzDiagramViewlet.CqY7VTeP.js → TikzDiagramViewlet.O8MJyXfT.js} +1 -1
  32. package/dist/client/_astro/VideoPlayerViewlet.-ycmo3kY.js +1 -0
  33. package/dist/client/_astro/WebappZenViewlet.PNce4u2T.js +1 -0
  34. package/dist/client/_astro/{WelcomeViewport.LwKTA6h7.js → WelcomeViewport.CZ6RxGSw.js} +1 -1
  35. package/dist/client/_astro/{agentIdentityCredentialService.BtKVsl2C.js → agentIdentityCredentialService.BEtZzBlO.js} +5 -5
  36. package/dist/client/_astro/cardTypeDetector.C2HH5RnU.js +1 -0
  37. package/dist/client/_astro/disposable.BmlxZrDf.js +1 -0
  38. package/dist/client/_astro/{markdownService.D-tM2RYx.js → markdownService.CpuKl0vp.js} +1 -1
  39. package/dist/client/_astro/{mcardStore.BiAvqM-D.js → mcardStore.nSWnzeLg.js} +2 -2
  40. package/dist/client/_astro/mcardVfs.BSdys1Y7.js +3 -0
  41. package/dist/client/_astro/pathsConfig.CSBBSzwH.js +2 -0
  42. package/dist/client/_astro/polyfills.Bi7kO8cu.js +1 -0
  43. package/dist/client/_astro/rendererEventBus.DirFDmGw.js +1 -0
  44. package/dist/client/_astro/themeStore.BajxvCga.js +1 -0
  45. package/dist/client/_astro/{tikzCompiler.DFojjdxR.js → tikzCompiler.-fXMNQpz.js} +1 -1
  46. package/dist/client/_astro/{useMCardHydration.Co47OH3D.js → useMCardHydration.Bjj_N5Gv.js} +1 -1
  47. package/dist/client/_astro/vendor-ai.D6NcJ6lu.js +69 -0
  48. package/dist/client/_astro/vendor-clm-kernel.B0kxq3g4.js +108 -0
  49. package/dist/client/_astro/vfsHandles.D4Pq18pW.js +1 -0
  50. package/dist/client/_astro/vfsPersistence.DVrd1BZj.js +1 -0
  51. package/dist/client/_astro/vfsTransactions.DBNtFuRz.js +1 -0
  52. package/dist/client/_astro/{workspaceStore.CXakha4Y.js → workspaceStore.DUHW2YBc.js} +1 -1
  53. package/dist/client/js/buffer-polyfill.js +14 -0
  54. package/dist/server/chunks/{StudioLayout_D163irJ0.mjs → StudioLayout_taayQJ5b.mjs} +2 -2
  55. package/dist/server/chunks/{_.._ZXsz792-.mjs → _.._CoQKwo62.mjs} +137 -91
  56. package/dist/server/chunks/{_handle__D_cIJYrU.mjs → _handle__D8dKQPUS.mjs} +3 -3
  57. package/dist/server/chunks/{cardTypeDetector_CyW1Xnmy.mjs → cardTypeDetector_C55M_HWS.mjs} +9 -0
  58. package/dist/server/chunks/{cards_B89BvF6W.mjs → cards_rVOc8K6H.mjs} +2 -2
  59. package/dist/server/chunks/cas_DTxlZ4Le.mjs +68 -0
  60. package/dist/server/chunks/{dispatch_DOwSKukU.mjs → dispatch_BTW4E_BJ.mjs} +8 -7
  61. package/dist/server/chunks/{dispatch_CxWKiHpn.mjs → dispatch_MbkljUxD.mjs} +8 -8
  62. package/dist/server/chunks/{export_DRouradA.mjs → export_DkEwDE2T.mjs} +3 -3
  63. package/dist/server/chunks/{health_Dfa5I0-X.mjs → health_cRt0M0yu.mjs} +1 -1
  64. package/dist/server/chunks/{mcard-library_DvPPUs9_.mjs → mcard-library_CLHvyslV.mjs} +1 -1
  65. package/dist/server/chunks/{mcardVfs_CeezzRvt.mjs → mcardVfs_DvNburKb.mjs} +5 -30
  66. package/dist/server/chunks/{move__RFvIDkq.mjs → move_DYcaXBLV.mjs} +6 -6
  67. package/dist/server/chunks/{pathsConfig_CgNYYLVm.mjs → pathsConfig_Dack-p2f.mjs} +13 -3
  68. package/dist/server/chunks/{proxy_CrWJQIBe.mjs → proxy_CMbbdBPW.mjs} +2 -2
  69. package/dist/server/chunks/{raw_DzNDaDVP.mjs → raw_C97sJWhg.mjs} +59 -26
  70. package/dist/server/chunks/{serverBootstrap_XKo2s6Ha.mjs → serverBootstrap_BDdSRIu5.mjs} +2 -2
  71. package/dist/server/chunks/tree_BwmO-pTe.mjs +186 -0
  72. package/dist/server/chunks/vfsCore_DIKpk-pk.mjs +98 -0
  73. package/dist/server/chunks/{vfsTreeScan_CKp7kMt9.mjs → vfsTreeScan_CRoCluPB.mjs} +18 -10
  74. package/dist/server/chunks/workspaceRoot_CRx3taID.mjs +157 -0
  75. package/dist/server/chunks/{write_popiFsO7.mjs → write_BLsmsTIx.mjs} +6 -5
  76. package/dist/server/chunks/{ws-server-init_CkcgcI5V.mjs → ws-server-init_Cfft7U5u.mjs} +343 -298
  77. package/dist/server/entry.mjs +8 -4
  78. package/dist/server/entry2.mjs +67 -28
  79. package/dist/server/virtual_astro_middleware.mjs +2 -2
  80. package/package.json +2 -2
  81. package/public/js/buffer-polyfill.js +14 -0
  82. package/src/components/studio/views/cardViewlets/ClmRegistryComponentViewlet.tsx +133 -0
  83. package/src/components/studio/views/cardViewlets/DxfViewlet.tsx +230 -0
  84. package/src/components/studio/views/cardViewlets/VideoPlayerViewlet.tsx +4 -4
  85. package/src/components/studio/views/cardViewlets/coreViewletDefs.ts +2 -2
  86. package/src/components/studio/views/cardViewlets/documents/AudioPlayerViewlet.tsx +15 -3
  87. package/src/components/studio/views/cardViewlets/documents/PdfViewlet.tsx +25 -7
  88. package/src/components/studio/views/cardViewlets/markdown/stages/wikilinkStage.ts +2 -1
  89. package/src/components/studio/views/cardViewlets/mediaViewletDefs.ts +21 -1
  90. package/src/components/studio/views/cardViewlets/webapp/WebappCanvas.tsx +40 -15
  91. package/src/components/studio/views/cardViewlets/webapp/WebappDevicePresetBar.tsx +108 -0
  92. package/src/components/studio/views/cardViewlets/webapp/WebappZenViewlet.tsx +23 -30
  93. package/src/components/studio/views/fileTree/MCardFileTree.tsx +71 -54
  94. package/src/components/studio/views/fileTree/hooks/useFileTreeSync.ts +0 -1
  95. package/src/components/studio/views/fileTree/hooks/usePartitionedTrees.ts +68 -23
  96. package/src/components/studio/views/fileTree/hooks/useSectionAccordion.ts +21 -11
  97. package/src/components/studio/views/functions/UnifiedFunctionExplorerViewlet.tsx +168 -0
  98. package/src/components/studio/views/history/HistoryPanel.tsx +110 -0
  99. package/src/components/studio/views/lineage/LineagePanel.tsx +152 -0
  100. package/src/components/studio/views/navigation/HandleLineageDrawer.tsx +89 -0
  101. package/src/components/studio/views/navigation/MultiCardCollectionBrowser.tsx +154 -0
  102. package/src/components/studio/views/pills/HashPill.tsx +101 -0
  103. package/src/components/studio/views/residency/ResidencyIndicator.tsx +82 -0
  104. package/src/config/app_config.json +3 -3
  105. package/src/core/projection/catalog.ts +105 -0
  106. package/src/core/projection/collection.ts +148 -0
  107. package/src/core/projection/handleSubscription.ts +132 -0
  108. package/src/core/projection/index.ts +4 -0
  109. package/src/core/projection/selectors.ts +29 -0
  110. package/src/core/projection/views.ts +242 -0
  111. package/src/core/refinement/designMetrics.ts +104 -0
  112. package/src/core/refinement/fibrationProjector.ts +142 -0
  113. package/src/core/refinement/lagrangianEngine.ts +137 -0
  114. package/src/core/refinement/refinementCommands.ts +82 -0
  115. package/src/core/viewport/deviceArchetypeRegistry.ts +177 -0
  116. package/src/core/viewport/viewportAudit.ts +150 -0
  117. package/src/edge/storeFilter.d.ts +4 -0
  118. package/src/edge/storeFilter.js +54 -0
  119. package/src/edge/storeFilter.ts +52 -0
  120. package/src/layouts/StudioLayout.astro +1 -0
  121. package/src/lib/cryptoPolyfill.js +77 -1
  122. package/src/lib/fsPolyfill.js +65 -0
  123. package/src/lib/urlPolyfill.js +21 -0
  124. package/src/lib/zlibPolyfill.js +35 -0
  125. package/src/packages/mcard-studio/package.json +2 -2
  126. package/src/packages/mcard-studio/type/legacyMapping.ts +5 -0
  127. package/src/packages/mcard-studio/viewlets/manifests.ts +2 -0
  128. package/src/packages/mcard-studio/viewlets/moduleMap.ts +12 -0
  129. package/src/packages/mcard-studio/viewlets/refinementManifests.ts +114 -0
  130. package/src/pages/api/dispatch.ts +3 -2
  131. package/src/pages/api/vfs/cas.ts +114 -0
  132. package/src/pages/api/vfs/move.ts +5 -5
  133. package/src/pages/api/vfs/raw.ts +72 -27
  134. package/src/pages/api/vfs/tree.ts +130 -11
  135. package/src/pages/api/vfs/write.ts +5 -4
  136. package/src/pages/index.astro +75 -0
  137. package/src/server/api/kernelDispatch.ts +8 -8
  138. package/src/server/artifactCollectionService.ts +4 -7
  139. package/src/server/artifactRepository.ts +4 -3
  140. package/src/server/clmRunner.mjs +1 -1
  141. package/src/server/collectionOwner.mjs +5 -5
  142. package/src/server/effects/executionPersistenceService.mjs +11 -11
  143. package/src/server/effects/resultSealingService.mjs +2 -2
  144. package/src/server/fileIngestService.mjs +21 -9
  145. package/src/server/fileWatcherService.mjs +4 -1
  146. package/src/server/handlers/fileChangeHandler.mjs +18 -10
  147. package/src/server/handlers/saveExecutionLogHandler.mjs +6 -6
  148. package/src/server/notificationService.mjs +14 -1
  149. package/src/server/scripts/buildSeedingMemory.mjs +3 -3
  150. package/src/server/serverMemoryRepository.ts +41 -59
  151. package/src/server/vfsTreeScan.ts +16 -10
  152. package/src/server/workspaceRoot.ts +143 -5
  153. package/src/services/cardTypeDetector.ts +4 -0
  154. package/src/services/databaseSyncService.ts +30 -46
  155. package/src/services/inBrowserLlm/engines/litertEngine.ts +1 -1
  156. package/src/services/namespaceProtocolClient.ts +221 -0
  157. package/src/services/renderers/pcard/RendererPCardRegistry.ts +4 -66
  158. package/src/services/renderers/pcard/modalitySpecs.ts +125 -0
  159. package/src/services/renderers/pcard/types.ts +7 -1
  160. package/src/services/renderers/rendererEventBus.ts +5 -3
  161. package/src/services/unifiedFunctionExecutionService.ts +145 -0
  162. package/src/services/vfs/vfsCore.ts +12 -1
  163. package/src/services/vfs/vfsMigration.ts +95 -0
  164. package/src/services/vfs/vfsMutations.ts +17 -35
  165. package/src/services/vfs/vfsPersistence.ts +19 -24
  166. package/src/services/vfs/vfsSync.ts +55 -17
  167. package/src/services/vfs/vfsVersions.ts +23 -34
  168. package/src/services/workbenchExecutionPolicy.ts +183 -0
  169. package/src/stores/mcardCollectionStore.ts +2 -0
  170. package/src/styles/dockview.css +34 -0
  171. package/src/ui/viewlets/FibrationRefinementViewlet.tsx +155 -0
  172. package/src/ui/viewlets/PetriConformanceViewlet.tsx +166 -0
  173. package/src/ui/viewlets/ResponsiveViewportLabViewlet.tsx +175 -0
  174. package/src/ui/viewlets/SprintGovernanceViewlet.tsx +176 -0
  175. package/src/ui/viewlets/viewletFocus.ts +35 -0
  176. package/src/ui/viewlets/viewportLabParts.tsx +190 -0
  177. package/dist/client/_astro/ClmPcardViewlet.DW5Yft0E.js +0 -3
  178. package/dist/client/_astro/D3GraphViewlet.DAjPz1DP.js +0 -2
  179. package/dist/client/_astro/DockviewSpatialWorkbench.DyQjSoHd.js +0 -12
  180. package/dist/client/_astro/DocumentViewlets.Dm_GL3AL.js +0 -2
  181. package/dist/client/_astro/ExcalidrawWhiteboardViewlet.DrlW7B6G.js +0 -1
  182. package/dist/client/_astro/HeadMeta.astro_astro_type_script_index_0_lang.DGXU-3Lu.js +0 -1
  183. package/dist/client/_astro/KoishiChatViewlet.B0eDEMnT.js +0 -16
  184. package/dist/client/_astro/MCardLibraryHarness.CUJLJFBt.js +0 -2
  185. package/dist/client/_astro/PCardRendererBridge.BnyaE05I.js +0 -1
  186. package/dist/client/_astro/RendererPCardRegistry.CLr4j1Ub.js +0 -1
  187. package/dist/client/_astro/StudioWorkbench.CF0SOYwy.js +0 -7
  188. package/dist/client/_astro/VideoPlayerViewlet.DoSYmmoQ.js +0 -1
  189. package/dist/client/_astro/WebappZenViewlet.CQW50OhX.js +0 -1
  190. package/dist/client/_astro/cardTypeDetector.C9kGObMh.js +0 -1
  191. package/dist/client/_astro/disposable.66apX1Q2.js +0 -1
  192. package/dist/client/_astro/empty.DOwCrGXH.js +0 -1
  193. package/dist/client/_astro/mcardVfs.Bj-RA0p7.js +0 -2
  194. package/dist/client/_astro/path.CR60mj9W.js +0 -1
  195. package/dist/client/_astro/pathsConfig.D0hV34p7.js +0 -2
  196. package/dist/client/_astro/polyfills.DcBkS56X.js +0 -1
  197. package/dist/client/_astro/rendererEventBus.CyFnSRLk.js +0 -1
  198. package/dist/client/_astro/themeStore.zUMFLo3Q.js +0 -1
  199. package/dist/client/_astro/vendor-ai.CZe7UVVK.js +0 -69
  200. package/dist/client/_astro/vfsHandles.B-nczBRy.js +0 -1
  201. package/dist/client/_astro/vfsPersistence.D6zRzVML.js +0 -1
  202. package/dist/client/_astro/vfsTransactions.04mkEHxD.js +0 -1
  203. package/dist/server/chunks/cryptoPolyfill_99rxUwYC.mjs +0 -180
  204. package/dist/server/chunks/kernelHash_DRaj51hY.mjs +0 -5
  205. package/dist/server/chunks/tree_CE2BhvyJ.mjs +0 -76
  206. package/dist/server/chunks/vfsCore_B6nCiBl5.mjs +0 -21
  207. package/dist/server/chunks/workspaceRoot_DVSUbYkd.mjs +0 -71
  208. package/src/server/kernelHash.ts +0 -22
  209. package/src/server/storage/cardCollection.ts +0 -94
  210. package/src/server/storage/index.ts +0 -3
  211. package/src/server/storage/mcard.ts +0 -99
  212. package/src/server/storage/sqliteNodeEngine.ts +0 -121
@@ -0,0 +1,183 @@
1
+ /**
2
+ * mcard-studio/src/services/workbenchExecutionPolicy.ts
3
+ * Sprint ULR-08 — Published-Kernel Workbench Contract, Descriptor Inspection,
4
+ * Allowlisted Execution Policy, and Approved Cordis 4-Preset Capability Matrix
5
+ * (INV-ULR-02, INV-ULR-06, INV-ULR-07).
6
+ */
7
+ import { SavepointGuard, computeContentHash } from 'clm-kernel';
8
+
9
+ export type CordisPresetId = 'minimal' | 'developer' | 'verify' | 'studio';
10
+
11
+ export type WorkbenchEffect =
12
+ | 'read' | 'stat' | 'inspect' | 'write' | 'bind' | 'execute'
13
+ | 'verify_lattice' | 'dry_run_prune' | 'viewport_probe' | 'network' | 'unbounded_network';
14
+
15
+ export interface CordisPresetCapabilitySpec {
16
+ id: CordisPresetId;
17
+ allowedEffects: ReadonlyArray<WorkbenchEffect>;
18
+ forbiddenEffects: ReadonlyArray<WorkbenchEffect>;
19
+ allowedOperations: ReadonlyArray<string>;
20
+ }
21
+
22
+ export const PUBLISHED_CLM_KERNEL_008_DESCRIPTOR_EXPORTS = Object.freeze([
23
+ 'PlaceMCard', 'TransitionMCard', 'TokenMCard', 'FiringReceiptMCard', 'NetMCard',
24
+ 'PetriProcessPCard', 'ChunkerProcessPCard', 'StreamRangeProcessPCard',
25
+ 'AnchoredPruningProcessPCard', 'MCardTokenNamespace', 'MCardNamespaceProtocolService',
26
+ 'NAMESPACE_PROTOCOL_OPS', 'PlaceTypeLattice', 'MCardMarking',
27
+ ] as const);
28
+
29
+ export const WORKSPACE_009_DEFERRED_DESCRIPTOR_EXPORTS = Object.freeze([
30
+ 'PCardDescriptor', 'reifyPcardDescriptor', 'reflectPcardDescriptor',
31
+ ] as const);
32
+
33
+ export const CORDIS_PRESET_CAPABILITY_MATRIX: Readonly<
34
+ Record<CordisPresetId, CordisPresetCapabilitySpec>
35
+ > = Object.freeze({
36
+ minimal: {
37
+ id: 'minimal',
38
+ allowedEffects: ['read', 'stat', 'inspect'],
39
+ forbiddenEffects: ['write', 'bind', 'execute', 'network', 'unbounded_network'],
40
+ allowedOperations: ['version', 'get', 'stat', 'resolve', 'list', 'history'],
41
+ },
42
+ developer: {
43
+ id: 'developer',
44
+ allowedEffects: ['read', 'stat', 'inspect', 'write', 'bind', 'execute'],
45
+ forbiddenEffects: ['unbounded_network'],
46
+ allowedOperations: [
47
+ 'version', 'put', 'get', 'stat', 'resolve', 'bind', 'list', 'history', 'watch', 'petri:execute_step',
48
+ ],
49
+ },
50
+ verify: {
51
+ id: 'verify',
52
+ allowedEffects: ['read', 'stat', 'inspect', 'verify_lattice', 'dry_run_prune'],
53
+ forbiddenEffects: ['write', 'bind', 'execute', 'network', 'unbounded_network'],
54
+ allowedOperations: [
55
+ 'version', 'get', 'stat', 'resolve', 'list', 'history', 'lattice:verify', 'prune:dry_run',
56
+ ],
57
+ },
58
+ studio: {
59
+ id: 'studio',
60
+ allowedEffects: [
61
+ 'read', 'stat', 'inspect', 'write', 'bind', 'execute',
62
+ 'verify_lattice', 'dry_run_prune', 'viewport_probe',
63
+ ],
64
+ forbiddenEffects: ['unbounded_network'],
65
+ allowedOperations: [
66
+ 'version', 'put', 'get', 'stat', 'resolve', 'bind', 'list', 'history', 'watch',
67
+ 'petri:execute_step', 'lattice:verify', 'prune:dry_run', 'viewport:probe',
68
+ ],
69
+ },
70
+ });
71
+
72
+ export function resolveCordisPresetCapabilities(
73
+ label: string,
74
+ ): { ok: true; spec: CordisPresetCapabilitySpec } | { ok: false; errorCode: 'UnknownPresetError'; reason: string } {
75
+ if (Object.prototype.hasOwnProperty.call(CORDIS_PRESET_CAPABILITY_MATRIX, label)) {
76
+ return { ok: true, spec: CORDIS_PRESET_CAPABILITY_MATRIX[label as CordisPresetId] };
77
+ }
78
+ return {
79
+ ok: false,
80
+ errorCode: 'UnknownPresetError',
81
+ reason: `Unknown Cordis preset "${label}" (must be one of minimal, developer, verify, studio)`,
82
+ };
83
+ }
84
+
85
+ export interface DescriptorInspectionResult {
86
+ variant: string;
87
+ supportedInPublished008: boolean;
88
+ executable: boolean;
89
+ deferredRelease: string | null;
90
+ metadata: Readonly<Record<string, unknown>>;
91
+ }
92
+
93
+ export function inspectPublishedDescriptor(
94
+ cardRecord: Readonly<Record<string, unknown>> | null | undefined,
95
+ ): DescriptorInspectionResult {
96
+ if (!cardRecord || typeof cardRecord !== 'object') {
97
+ return { variant: 'unknown', supportedInPublished008: false, executable: false, deferredRelease: null, metadata: {} };
98
+ }
99
+ const rawVariant = String(cardRecord.variant ?? cardRecord.schema ?? cardRecord.kind ?? 'unknown');
100
+ const metadata = {
101
+ id: cardRecord.id ?? null,
102
+ name: cardRecord.name ?? null,
103
+ operationId: cardRecord.operationId ?? null,
104
+ };
105
+ const isDeferred009 =
106
+ rawVariant === 'urn:clm:pcard:descriptor:v1' ||
107
+ (WORKSPACE_009_DEFERRED_DESCRIPTOR_EXPORTS as readonly string[]).includes(rawVariant);
108
+ if (isDeferred009) {
109
+ return { variant: rawVariant, supportedInPublished008: false, executable: false, deferredRelease: '0.0.9', metadata };
110
+ }
111
+ const supportedIn008 = (PUBLISHED_CLM_KERNEL_008_DESCRIPTOR_EXPORTS as readonly string[]).includes(rawVariant);
112
+ const executableVariants = new Set([
113
+ 'TransitionMCard', 'PetriProcessPCard', 'ChunkerProcessPCard', 'StreamRangeProcessPCard', 'AnchoredPruningProcessPCard',
114
+ ]);
115
+ return {
116
+ variant: rawVariant,
117
+ supportedInPublished008: supportedIn008,
118
+ executable: supportedIn008 && executableVariants.has(rawVariant),
119
+ deferredRelease: null,
120
+ metadata,
121
+ };
122
+ }
123
+
124
+ export function computeWorkbenchStateHash(state: Readonly<Record<string, unknown>>): string {
125
+ const canonical = JSON.stringify(
126
+ Object.keys(state).sort().reduce<Record<string, unknown>>((acc, key) => {
127
+ acc[key] = state[key];
128
+ return acc;
129
+ }, {}),
130
+ );
131
+ return computeContentHash(canonical);
132
+ }
133
+
134
+ export interface WorkbenchExecutionReceipt {
135
+ status: 'EXECUTED' | 'REJECTED';
136
+ operationId: string;
137
+ preset: string;
138
+ reason?: string;
139
+ stateHashBefore: string;
140
+ stateHashAfter: string;
141
+ mutated: boolean;
142
+ }
143
+
144
+ export async function executeAllowlistedOperation(options: {
145
+ operationId: string;
146
+ preset: string;
147
+ allowlist: Readonly<Record<string, (state: Record<string, unknown>) => void>>;
148
+ state: Record<string, unknown>;
149
+ }): Promise<WorkbenchExecutionReceipt> {
150
+ const { operationId, preset, allowlist, state } = options;
151
+ const stateHashBefore = computeWorkbenchStateHash(state);
152
+ const reject = (reason: string): WorkbenchExecutionReceipt => ({
153
+ status: 'REJECTED', operationId, preset, reason, stateHashBefore, stateHashAfter: stateHashBefore, mutated: false,
154
+ });
155
+ const presetLookup = resolveCordisPresetCapabilities(preset);
156
+ if (!presetLookup.ok) return reject(presetLookup.reason);
157
+ if (!presetLookup.spec.allowedOperations.includes(operationId)) {
158
+ return reject(`Operation "${operationId}" is not permitted under preset "${preset}"`);
159
+ }
160
+ const handler = Object.prototype.hasOwnProperty.call(allowlist, operationId) ? allowlist[operationId] : undefined;
161
+ if (typeof handler !== 'function') return reject(`Unregistered operation ID "${operationId}"`);
162
+
163
+ const snapshot = JSON.parse(JSON.stringify(state)) as Record<string, unknown>;
164
+ const guard = new SavepointGuard<Record<string, unknown>>((restored) => {
165
+ for (const k of Object.keys(state)) delete state[k];
166
+ Object.assign(state, restored);
167
+ });
168
+ guard.begin(snapshot);
169
+ try {
170
+ handler(state);
171
+ guard.commit();
172
+ const stateHashAfter = computeWorkbenchStateHash(state);
173
+ return { status: 'EXECUTED', operationId, preset, stateHashBefore, stateHashAfter, mutated: stateHashAfter !== stateHashBefore };
174
+ } catch (err: unknown) {
175
+ await guard.rollback();
176
+ const stateHashAfter = computeWorkbenchStateHash(state);
177
+ return {
178
+ status: 'REJECTED', operationId, preset,
179
+ reason: err instanceof Error ? err.message : String(err),
180
+ stateHashBefore, stateHashAfter, mutated: stateHashAfter !== stateHashBefore,
181
+ };
182
+ }
183
+ }
@@ -53,6 +53,7 @@ export type CardDetectedType =
53
53
  export interface MCardFileNode {
54
54
  handle: string;
55
55
  hash: string;
56
+ hashDeferred?: boolean;
56
57
  path: string;
57
58
  name: string;
58
59
  mimeType: string;
@@ -64,6 +65,7 @@ export interface MCardFileNode {
64
65
  subclass?: 'MCard' | 'PCard' | 'VCard';
65
66
  coreCard?: MCard;
66
67
  sizeBytes?: number;
68
+ scope?: string;
67
69
  }
68
70
 
69
71
  /**
@@ -257,10 +257,44 @@
257
257
 
258
258
  .mcard-file-tree-scroll {
259
259
  flex: 1;
260
+ min-height: 0;
260
261
  overflow-y: auto;
261
262
  overflow-x: hidden;
262
263
  }
263
264
 
265
+ .mcard-file-tree-gap-divider {
266
+ display: flex;
267
+ align-items: center;
268
+ gap: 8px;
269
+ padding: 10px 10px 8px 10px;
270
+ flex-shrink: 0;
271
+ border-top: 1px solid var(--vscode-sideBarSectionHeader-border, #2d2d2d);
272
+ background-color: var(--vscode-sideBar-background, #252526);
273
+ user-select: none;
274
+ }
275
+
276
+ .mcard-file-tree-gap-line {
277
+ flex: 1;
278
+ height: 1px;
279
+ background-color: var(--vscode-sideBarSectionHeader-border, rgba(255, 255, 255, 0.08));
280
+ }
281
+
282
+ .mcard-file-tree-gap-label {
283
+ font-size: 9px;
284
+ font-weight: 700;
285
+ text-transform: uppercase;
286
+ letter-spacing: 0.08em;
287
+ color: var(--vscode-descriptionForeground, #717171);
288
+ }
289
+
290
+ .mcard-file-tree-ro-scroll {
291
+ flex-shrink: 0;
292
+ max-height: 42%;
293
+ overflow-y: auto;
294
+ overflow-x: hidden;
295
+ background-color: var(--vscode-sideBar-background, #252526);
296
+ }
297
+
264
298
  .explorer-action-bar {
265
299
  display: flex;
266
300
  align-items: center;
@@ -0,0 +1,155 @@
1
+ /**
2
+ * FibrationRefinementViewlet — Least-Action & Fibration Refinement UI
3
+ * (SMR-11 · DoD-SMR-11-02), registered as `pcard:render/fibration-dashboard`.
4
+ *
5
+ * Migrates the local Least-Action Navigator and Fibration Dashboard: per-unit
6
+ * Software Lagrangian scores, the least-action ordering, the base-to-fiber
7
+ * projection for a selected unit, and a refinement trajectory across revisions.
8
+ * All computation lives in the pure engines; this viewlet renders and raises intents.
9
+ *
10
+ * Contract D budget: <= 240 LOC.
11
+ */
12
+ import React, { useMemo, useState } from 'react';
13
+
14
+ import { computeLagrangian, type UnitMetrics } from '@/core/refinement/lagrangianEngine';
15
+ import {
16
+ leastActionPath,
17
+ projectFibration,
18
+ refinementTrajectory,
19
+ type AssessmentUnit,
20
+ } from '@/core/refinement/fibrationProjector';
21
+
22
+ export interface FibrationRefinementViewletProps {
23
+ readonly units: readonly AssessmentUnit[];
24
+ readonly revisions?: readonly { readonly hash: string; readonly lagrangian: number; readonly changedAt?: string }[];
25
+ readonly handle?: string;
26
+ readonly onSelectUnit?: (unit: string) => void;
27
+ }
28
+
29
+ /** Scores raw metrics into an assessment unit, for callers holding only metrics. */
30
+ export function assessUnit(unit: string, metrics: UnitMetrics, tau?: AssessmentUnit['tau']): AssessmentUnit {
31
+ const score = computeLagrangian(metrics);
32
+ return {
33
+ unit,
34
+ tau,
35
+ payload_bytes: metrics.payload?.total_bytes ?? 0,
36
+ within_budget: metrics.payload?.within_budget ?? true,
37
+ functionality_coverage: metrics.functionality?.invariant_coverage ?? 1,
38
+ S_T: score.S_T,
39
+ H_T: score.H_T,
40
+ lagrangian: score.lagrangian,
41
+ regime: score.regime,
42
+ };
43
+ }
44
+
45
+ export const LagrangianTable: React.FC<{ units: readonly AssessmentUnit[]; onSelectUnit?: (unit: string) => void }> = ({
46
+ units,
47
+ onSelectUnit,
48
+ }) => (
49
+ <table className="fibration-units">
50
+ <thead>
51
+ <tr>
52
+ <th scope="col">Unit</th>
53
+ <th scope="col">S_T</th>
54
+ <th scope="col">H_T</th>
55
+ <th scope="col">ℒ</th>
56
+ <th scope="col">Regime</th>
57
+ </tr>
58
+ </thead>
59
+ <tbody>
60
+ {units.map((unit) => (
61
+ <tr key={unit.unit} data-role="unit-row" data-regime={unit.regime}>
62
+ <th scope="row">
63
+ <button type="button" onClick={() => onSelectUnit?.(unit.unit)}>
64
+ {unit.unit}
65
+ </button>
66
+ </th>
67
+ <td>{unit.S_T.toFixed(4)}</td>
68
+ <td>{unit.H_T.toFixed(4)}</td>
69
+ <td data-role="lagrangian">{unit.lagrangian.toFixed(4)}</td>
70
+ <td>{unit.regime}</td>
71
+ </tr>
72
+ ))}
73
+ </tbody>
74
+ </table>
75
+ );
76
+
77
+ export const FibrationRefinementViewlet: React.FC<FibrationRefinementViewletProps> = ({
78
+ units,
79
+ revisions = [],
80
+ handle = 'urn:mcard:content:landing_page',
81
+ onSelectUnit,
82
+ }) => {
83
+ const [selected, setSelected] = useState<string>(units[0]?.unit ?? '');
84
+ const order = useMemo(() => leastActionPath(units), [units]);
85
+ const projection = useMemo(
86
+ () => (selected ? projectFibration(selected, units) : null),
87
+ [selected, units],
88
+ );
89
+ const trajectory = useMemo(
90
+ () => (revisions.length > 0 ? refinementTrajectory(handle, revisions) : null),
91
+ [handle, revisions],
92
+ );
93
+
94
+ const select = (unit: string) => {
95
+ setSelected(unit);
96
+ onSelectUnit?.(unit);
97
+ };
98
+
99
+ return (
100
+ <section className="fibration-viewlet" aria-label="Least-action and fibration refinement">
101
+ <header>
102
+ <h3>Least-Action &amp; Fibration</h3>
103
+ <p className="fibration-note">
104
+ ℒ = S_T − H_T · geodesic when ℒ &gt; 0.05, pruning when ℒ &lt; −0.05
105
+ </p>
106
+ </header>
107
+
108
+ <LagrangianTable units={units} onSelectUnit={select} />
109
+
110
+ <section className="fibration-least-action" aria-label="Least-action ordering">
111
+ <h4>Least-action ordering</h4>
112
+ <ol data-role="least-action-order">
113
+ {order.map((unit) => (
114
+ <li key={unit}>{unit}</li>
115
+ ))}
116
+ </ol>
117
+ </section>
118
+
119
+ {projection && (
120
+ <section className="fibration-projection" aria-label={`Fiber projection over ${projection.base}`}>
121
+ <h4>Fiber projection over {projection.base}</h4>
122
+ <p data-role="fiber-count">
123
+ {projection.fiberCount} fiber(s) · spread {projection.spread.toFixed(4)}
124
+ </p>
125
+ <ul>
126
+ {projection.fibers.map((fiber) => (
127
+ <li key={fiber.coordinate} data-role="fiber">
128
+ <code>{fiber.coordinate}</code> — ℒ {fiber.lagrangian.toFixed(4)} ({fiber.regime})
129
+ </li>
130
+ ))}
131
+ </ul>
132
+ </section>
133
+ )}
134
+
135
+ {trajectory && (
136
+ <section className="fibration-trajectory" aria-label="Refinement trajectory">
137
+ <h4>Refinement trajectory</h4>
138
+ <p data-role="trajectory-net">
139
+ net ℒ {trajectory.netLagrangian.toFixed(4)} · {trajectory.direction}
140
+ {trajectory.imaginaryAction ? ' · imaginary action distance' : ''}
141
+ </p>
142
+ <ol>
143
+ {trajectory.steps.map((step) => (
144
+ <li key={`${step.from}-${step.to}`} data-role="trajectory-step" data-direction={step.direction}>
145
+ {step.from.slice(0, 8)}… → {step.to.slice(0, 8)}… : {step.deltaLagrangian.toFixed(4)}
146
+ </li>
147
+ ))}
148
+ </ol>
149
+ </section>
150
+ )}
151
+ </section>
152
+ );
153
+ };
154
+
155
+ export default FibrationRefinementViewlet;
@@ -0,0 +1,166 @@
1
+ /**
2
+ * PetriConformanceViewlet — Petri-net marking & MIME taxonomy fiber conformance
3
+ * (SMR-11 · DoD-SMR-11-03), registered as `pcard:render/petri-inspector`.
4
+ *
5
+ * Supersedes the local `fiber-conformance.html` and `fiber-inspector.html` islands:
6
+ * it validates all 15 MIME taxonomy fiber adapters and renders Petri-net place and
7
+ * transition markings. Read-only — this inspector never fires a transition or mutates
8
+ * a marking (SMR-11 DoD-05).
9
+ *
10
+ * Contract D budget: <= 240 LOC.
11
+ */
12
+ import React, { useMemo } from 'react';
13
+
14
+ export interface FiberAdapter {
15
+ readonly kind: string;
16
+ readonly payload_shape?: string;
17
+ readonly content_class?: string;
18
+ readonly supertypes?: readonly string[];
19
+ readonly renderer?: string;
20
+ readonly isolation?: string;
21
+ readonly budget?: { readonly archetype?: string; readonly max_bytes?: number };
22
+ }
23
+
24
+ export interface PetriMarking {
25
+ readonly place: string;
26
+ readonly tokens: number;
27
+ readonly capacity?: number | null;
28
+ }
29
+
30
+ export interface PetriTransition {
31
+ readonly id: string;
32
+ readonly inputs?: readonly string[];
33
+ readonly outputs?: readonly string[];
34
+ readonly enabled?: boolean;
35
+ }
36
+
37
+ export interface FiberConformanceRow {
38
+ readonly kind: string;
39
+ readonly renderer: string;
40
+ readonly conformant: boolean;
41
+ readonly missing: readonly string[];
42
+ }
43
+
44
+ /** A fiber adapter conforms when it declares the fields the taxonomy requires. */
45
+ export function checkFiberConformance(fibers: readonly FiberAdapter[]): {
46
+ readonly rows: readonly FiberConformanceRow[];
47
+ readonly total: number;
48
+ readonly conformant: number;
49
+ readonly allConformant: boolean;
50
+ } {
51
+ const required: readonly (keyof FiberAdapter)[] = ['kind', 'payload_shape', 'content_class', 'renderer'];
52
+ const rows = fibers.map((fiber) => {
53
+ const missing = required.filter((field) => !fiber[field]);
54
+ return {
55
+ kind: fiber.kind,
56
+ renderer: fiber.renderer ?? '(none)',
57
+ conformant: missing.length === 0,
58
+ missing: missing.map(String),
59
+ };
60
+ });
61
+ const conformant = rows.filter((row) => row.conformant).length;
62
+ return { rows, total: rows.length, conformant, allConformant: rows.length > 0 && conformant === rows.length };
63
+ }
64
+
65
+ /** Marking summary: places over capacity are reported, never silently clamped. */
66
+ export function markingSummary(markings: readonly PetriMarking[]): {
67
+ readonly places: number;
68
+ readonly tokens: number;
69
+ readonly overCapacity: readonly string[];
70
+ } {
71
+ return {
72
+ places: markings.length,
73
+ tokens: markings.reduce((total, marking) => total + marking.tokens, 0),
74
+ overCapacity: markings
75
+ .filter((marking) => marking.capacity != null && marking.tokens > marking.capacity)
76
+ .map((marking) => marking.place),
77
+ };
78
+ }
79
+
80
+ export interface PetriConformanceViewletProps {
81
+ readonly fibers: readonly FiberAdapter[];
82
+ readonly markings?: readonly PetriMarking[];
83
+ readonly transitions?: readonly PetriTransition[];
84
+ readonly onSelectPlace?: (place: string) => void;
85
+ }
86
+
87
+ export const PetriConformanceViewlet: React.FC<PetriConformanceViewletProps> = ({
88
+ fibers,
89
+ markings = [],
90
+ transitions = [],
91
+ onSelectPlace,
92
+ }) => {
93
+ const conformance = useMemo(() => checkFiberConformance(fibers), [fibers]);
94
+ const summary = useMemo(() => markingSummary(markings), [markings]);
95
+ const enabled = transitions.filter((transition) => transition.enabled).length;
96
+
97
+ return (
98
+ <section className="petri-conformance" aria-label="Petri marking and fiber conformance inspector">
99
+ <header>
100
+ <h3>Petri Markings &amp; Fiber Conformance</h3>
101
+ <p data-role="conformance-summary">
102
+ {conformance.conformant} of {conformance.total} fiber adapter(s) conformant
103
+ </p>
104
+ </header>
105
+
106
+ <table className="petri-fibers">
107
+ <thead>
108
+ <tr>
109
+ <th scope="col">Fiber kind</th>
110
+ <th scope="col">Renderer</th>
111
+ <th scope="col">Conformant</th>
112
+ </tr>
113
+ </thead>
114
+ <tbody>
115
+ {conformance.rows.map((row) => (
116
+ <tr key={row.kind} data-role="fiber-row" data-conformant={String(row.conformant)}>
117
+ <th scope="row">{row.kind}</th>
118
+ <td>
119
+ <code>{row.renderer}</code>
120
+ </td>
121
+ <td>{row.conformant ? '✓' : `✗ missing ${row.missing.join(', ')}`}</td>
122
+ </tr>
123
+ ))}
124
+ </tbody>
125
+ </table>
126
+
127
+ <section className="petri-markings" aria-label="Petri markings">
128
+ <h4>Markings</h4>
129
+ <p data-role="marking-summary">
130
+ {summary.places} place(s) · {summary.tokens} token(s)
131
+ {summary.overCapacity.length > 0 ? ` · over capacity: ${summary.overCapacity.join(', ')}` : ''}
132
+ </p>
133
+ <ul>
134
+ {markings.map((marking) => (
135
+ <li key={marking.place} data-role="marking">
136
+ <button type="button" onClick={() => onSelectPlace?.(marking.place)}>
137
+ <code>{marking.place}</code>
138
+ </button>
139
+ <span className="petri-tokens">{marking.tokens}</span>
140
+ {marking.capacity != null && <span className="petri-capacity">/ {marking.capacity}</span>}
141
+ </li>
142
+ ))}
143
+ </ul>
144
+ </section>
145
+
146
+ <section className="petri-transitions" aria-label="Petri transitions">
147
+ <h4>Transitions</h4>
148
+ <p data-role="transition-summary">
149
+ {enabled} of {transitions.length} enabled · read-only (no firing control)
150
+ </p>
151
+ <ul>
152
+ {transitions.map((transition) => (
153
+ <li key={transition.id} data-role="transition" data-enabled={String(Boolean(transition.enabled))}>
154
+ <code>{transition.id}</code>
155
+ <span className="petri-io">
156
+ {(transition.inputs ?? []).join(', ')} → {(transition.outputs ?? []).join(', ')}
157
+ </span>
158
+ </li>
159
+ ))}
160
+ </ul>
161
+ </section>
162
+ </section>
163
+ );
164
+ };
165
+
166
+ export default PetriConformanceViewlet;