@stream44.studio/t44 0.4.0-rc.24

package/structs/WorkspaceShellConfig.ts

@@ -0,0 +1,83 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#@stream44.studio/t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                env: {
+                                    type: 'object',
+                                    properties: {
+                                        default: {
+                                            type: 'object',
+                                            additionalProperties: { type: 'string' },
+                                            description: 'Default environment variables.'
+                                        },
+                                        force: {
+                                            type: 'object',
+                                            additionalProperties: { type: 'string' },
+                                            description: 'Forced environment variables that override defaults.'
+                                        }
+                                    },
+                                    additionalProperties: true,
+                                    description: 'Shell environment variable configuration.'
+                                },
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp of when the entity config was created.'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp of when the entity config was last updated.'
+                                }
+                            },
+                            required: ['createdAt', 'updatedAt'],
+                            additionalProperties: true,
+                            description: 'Workspace shell configuration with environment variables.'
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+                env: {
+                    type: CapsulePropertyTypes.GetterFunction,
+                    value: async function (this: any): Promise<object> {
+                        const shellConfig = await this.config
+
+                        if (!shellConfig?.env) {
+                            return {}
+                        }
+
+                        const defaultEnv = shellConfig.env.default || {}
+                        const forceEnv = shellConfig.env.force || {}
+
+                        return {
+                            ...defaultEnv,
+                            ...forceEnv
+                        }
+                    }
+                },
+            }
+        }
+    }, {
+        extendsCapsule: '@stream44.studio/t44/caps/WorkspaceEntityConfig',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = '@stream44.studio/t44/structs/WorkspaceShellConfig'

package/structs/patterns/README.md

@@ -0,0 +1,2 @@
+
+**NOTE: Code in this directory will be relocated under MIT License to a different project in future.**

package/structs/patterns/git-scm.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#@stream44.studio/t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project publishing fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: '@stream44.studio/t44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = '@stream44.studio/t44/structs/patterns/git-scm.com/ProjectPublishingFact'

package/tsconfig.json

@@ -0,0 +1,33 @@
+{
+    "compilerOptions": {
+        "target": "es2021",
+        "module": "esnext",
+        "lib": [
+            "ES2021",
+            "DOM"
+        ],
+        "types": [
+            "bun",
+            "node"
+        ],
+        "moduleResolution": "bundler",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "allowSyntheticDefaultImports": true,
+        "baseUrl": ".",
+        "paths": {
+            "@stream44.studio/t44/*": [
+                "./*"
+            ]
+        }
+    },
+    "include": [
+        "**/*.ts"
+    ],
+    "exclude": [
+        "node_modules"
+    ]
+}

package/workspace-rt.ts

@@ -0,0 +1,152 @@
+#!/usr/bin/env bun
+/// <reference types="bun" />
+/// <reference types="node" />
+
+const startTime = Date.now()
+
+import { join, resolve } from 'path'
+import { access } from 'fs/promises'
+import chalk from 'chalk'
+import { CapsuleSpineFactory } from "@stream44.studio/encapsulate/spine-factories/CapsuleSpineFactory.v0"
+import { CapsuleSpineContract } from "@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0/Membrane.v0"
+import { TimingObserver } from "@stream44.studio/encapsulate/spine-factories/TimingObserver"
+
+async function findWorkspaceRoot(): Promise<string> {
+    const isInitCommand = process.argv.includes('init')
+    if (isInitCommand) {
+        const { mkdir, writeFile } = await import('fs/promises')
+        const workspaceDir = join(process.cwd(), '.workspace')
+        const workspaceConfigPath = join(workspaceDir, 'workspace.yaml')
+
+        await mkdir(workspaceDir, { recursive: true })
+        const workspaceYaml = `extends:\n  - '@stream44.studio/t44/workspace.yaml'\n`
+        await writeFile(workspaceConfigPath, workspaceYaml)
+
+        return process.cwd()
+    }
+
+    let currentDir = resolve(process.cwd())
+
+    while (true) {
+        const workspaceConfigPath = join(currentDir, '.workspace', 'workspace.yaml')
+        try {
+            await access(workspaceConfigPath)
+            return currentDir
+        } catch {
+            // File doesn't exist, continue traversing
+        }
+
+        const parentDir = resolve(currentDir, '..')
+        if (parentDir === currentDir) {
+            throw new Error(
+                `Could not find workspace root. Please run this command from within a workspace directory ` +
+                `(a directory containing .workspace/workspace.yaml).`
+            )
+        }
+        currentDir = parentDir
+    }
+}
+
+export async function run(encapsulateHandler: any, runHandler: any, options?: { importMeta?: { dir: string } }) {
+
+    const timing = process.argv.includes('--trace') ? TimingObserver({ startTime }) : undefined
+
+    timing?.recordMajor('INIT SPINE')
+
+    const eventsByKey = new Map<string, any>()
+
+    const workspaceRootDir = await findWorkspaceRoot()
+
+    const { encapsulate, freeze, CapsulePropertyTypes, makeImportStack, hoistSnapshot } = await CapsuleSpineFactory({
+        spineFilesystemRoot: workspaceRootDir,
+        capsuleModuleProjectionRoot: (import.meta as any).dir,
+        enableCallerStackInference: true,
+        spineContracts: {
+            ['#' + CapsuleSpineContract['#']]: CapsuleSpineContract
+        },
+        timing,
+        onMembraneEvent: timing ? (event: any) => {
+            const instanceId = event.target?.spineContractCapsuleInstanceId
+            const eventIndex = event.eventIndex
+
+            // Store event by composite key (instance ID + event index)
+            const key = `${eventIndex}`
+            eventsByKey.set(key, event)
+
+            let capsuleRef = event.target?.capsuleSourceLineRef
+            let prop = event.target?.prop
+            let callerLocation = event.caller ? `${event.caller.filepath}:${event.caller.line}` : 'unknown'
+            const eventType = event.event
+
+            // For call-result events, look up the original call event to get all info
+            if (eventType === 'call-result') {
+                const callKey = `${event.callEventIndex}`
+                const callEvent = eventsByKey.get(callKey)
+                if (callEvent) {
+                    capsuleRef = callEvent.target?.capsuleSourceLineRef || capsuleRef
+                    prop = callEvent.target?.prop || prop
+                    if (callEvent.caller) {
+                        callerLocation = `${callEvent.caller.filepath}:${callEvent.caller.line}`
+                    }
+                }
+            }
+
+            console.error(
+                chalk.gray(`[${eventIndex}]`),
+                chalk.cyan(eventType.padEnd(12)),
+                chalk.yellow(capsuleRef),
+                chalk.magenta(`.${prop}`),
+                chalk.dim(`from ${callerLocation}`)
+            )
+        } : undefined
+    })
+
+    timing?.recordMajor('ENCAPSULATE')
+
+    const exportedApi = await encapsulateHandler({
+        encapsulate,
+        CapsulePropertyTypes,
+        makeImportStack
+    })
+
+    timing?.recordMajor('FREEZE')
+
+    const snapshot = await freeze()
+
+    timing?.recordMajor('HOIST SNAPSHOT')
+
+    const { run } = await hoistSnapshot({
+        snapshot
+    })
+
+    timing?.recordMajor('RUN')
+
+    const result = await run({
+        overrides: {
+            ['@stream44.studio/t44/caps/WorkspaceConfig']: {
+                '#': {
+                    workspaceRootDir
+                }
+            },
+            ['@stream44.studio/t44/caps/ProjectTest']: {
+                '#': {
+                    testRootDir: options?.importMeta?.dir
+                }
+            },
+            ['@stream44.studio/t44-ipfs.tech/caps/IpfsWorkbench']: {
+                '#': {
+                    cacheDir: join(workspaceRootDir, '.~o/workspace.foundation', '@t44.sh~t44-ipfs.tech~caps~IpfsWorkbench', 'daemons')
+                }
+            }
+        }
+    }, async (opts) => {
+        return runHandler({
+            ...opts,
+            ...(exportedApi || {})
+        })
+    })
+
+    timing?.recordMajor('DONE')
+
+    return result
+}

package/workspace.yaml

@@ -0,0 +1,3 @@
+$schema: ../../../.~o/workspace.foundation/@t44.sh~t44~caps~JsonSchemas/@t44.sh~t44~structs~WorkspaceConfigFile.json
+extends:
+  - ./caps/WorkspaceConfig.yaml