t44 0.4.0-rc.3

package/structs/providers/github.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#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: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/github.com/ProjectPublishingFact'

package/structs/providers/github.com/WorkspaceConnectionConfig.ts

@@ -0,0 +1,43 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiToken: {
+                                    type: 'string',
+                                    title: 'GitHub Personal Access Token',
+                                    description: 'Your GitHub personal access token from https://github.com/settings/tokens (needs repo scope)',
+                                    minLength: 10,
+                                    pattern: '^(ghp_[A-Za-z0-9]+|github_pat_[A-Za-z0-9_]+)$'
+                                }
+                            },
+                            required: ['apiToken']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/github.com/WorkspaceConnectionConfig'

package/structs/providers/npmjs.com/ProjectPublishingFact.ts

@@ -0,0 +1,46 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#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: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/npmjs.com/ProjectPublishingFact'

package/structs/providers/vercel.com/ProjectDeploymentFact.ts

@@ -0,0 +1,55 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project deployment fact was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the project deployment fact was last updated'
+                                }
+                            },
+                            additionalProperties: true
+                        }
+                    }
+                }
+            },
+            '#t44/caps/OpenApiSchema': {
+                as: 'schemaOpenApi',
+                options: {
+                    '#': {
+                        url: 'https://openapi.vercel.sh/',
+                        def: '#/paths/~1v9~1projects~1{idOrName}/get/responses/200/content/application~1json/schema'
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/vercel.com/ProjectDeploymentFact'

package/structs/providers/vercel.com/WorkspaceConnectionConfig.ts

@@ -0,0 +1,49 @@
+
+export async function capsule({
+    encapsulate,
+    CapsulePropertyTypes,
+    makeImportStack
+}: any) {
+    return encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#t44/caps/ConfigSchemaStruct': {
+                as: 'schema',
+                options: {
+                    '#': {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                apiToken: {
+                                    type: 'string',
+                                    title: 'Vercel API Token',
+                                    description: 'Your Vercel API token from https://vercel.com/account/tokens',
+                                    minLength: 20,
+                                    pattern: '^[A-Za-z0-9_-]+$'
+                                },
+                                team: {
+                                    type: 'string',
+                                    title: 'Default Team',
+                                    description: 'Your default Vercel team slug',
+                                    minLength: 1
+                                }
+                            },
+                            required: ['apiToken']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceConnection',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/providers/vercel.com/WorkspaceConnectionConfig'

package/tests/01-Lifecycle/main.test.ts

@@ -0,0 +1,173 @@
+#!/usr/bin/env bun test
+// Set VERBOSE=1 to see stdout/stderr from spawned t44 commands
+
+export const testConfig = {
+    group: 'lifecycle',
+    runOnAll: false,
+}
+
+import { join } from 'path'
+import { mkdir, writeFile, rm, stat } from 'fs/promises'
+import * as bunTest from 'bun:test'
+import { run } from 't44/workspace-rt'
+
+const {
+    test: { describe, it, expect, beforeAll },
+} = await run(async ({ encapsulate, CapsulePropertyTypes, makeImportStack }: any) => {
+    const spine = await encapsulate({
+        '#@stream44.studio/encapsulate/spine-contracts/CapsuleSpineContract.v0': {
+            '#@stream44.studio/encapsulate/structs/Capsule': {},
+            '#': {
+                test: {
+                    type: CapsulePropertyTypes.Mapping,
+                    value: 't44/caps/WorkspaceTest',
+                    options: {
+                        '#': {
+                            bunTest,
+                        }
+                    }
+                },
+            }
+        }
+    }, {
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: 't44/tests/01-Lifecycle/main.test'
+    })
+    return { spine }
+}, async ({ spine, apis }: any) => {
+    return apis[spine.capsuleSourceLineRef]
+}, {
+    importMeta: import.meta
+})
+
+const testDir = join(import.meta.dir, '.~main.test')
+const t44Bin = join(import.meta.dir, '../../bin/t44')
+
+const homeDir = join(testDir, 'lifecycle', 'home')
+const repoDir = join(testDir, 'lifecycle', 'repo')
+const env = { ...process.env, T44_HOME_DIR: homeDir, T44_KEYS_PASSPHRASE: 't44-test' }
+
+async function runT44(...args: string[]) {
+    const proc = Bun.spawn([t44Bin, ...args, '--yes'], {
+        env,
+        cwd: repoDir,
+        stdout: 'pipe',
+        stderr: 'pipe',
+        stdin: 'pipe',
+    })
+    proc.stdin.end()
+
+    const timeout = setTimeout(() => proc.kill(), 15_000)
+
+    const stdoutChunks: string[] = []
+    const stderrChunks: string[] = []
+
+    const verbose = !!process.env.VERBOSE
+
+    const stdoutReader = new WritableStream({
+        write(chunk) {
+            const text = new TextDecoder().decode(chunk)
+            stdoutChunks.push(text)
+            if (verbose) process.stdout.write(text)
+        }
+    })
+
+    const stderrReader = new WritableStream({
+        write(chunk) {
+            const text = new TextDecoder().decode(chunk)
+            stderrChunks.push(text)
+            if (verbose) process.stderr.write(text)
+        }
+    })
+
+    const [exitCode] = await Promise.all([
+        proc.exited,
+        proc.stdout.pipeTo(stdoutReader),
+        proc.stderr.pipeTo(stderrReader),
+    ])
+
+    clearTimeout(timeout)
+
+    return { exitCode, stdout: stdoutChunks.join(''), stderr: stderrChunks.join('') }
+}
+
+describe('t44 lifecycle', function () {
+
+    beforeAll(async () => {
+        await rm(join(testDir, 'lifecycle'), { recursive: true, force: true })
+        await mkdir(homeDir, { recursive: true })
+        await mkdir(join(homeDir, '.ssh'), { recursive: true })
+        await mkdir(join(repoDir, '.workspace'), { recursive: true })
+
+        const workspaceYaml = `extends:
+  - 't44/workspace.yaml'
+`
+        await writeFile(join(repoDir, '.workspace', 'workspace.yaml'), workspaceYaml)
+    })
+
+    it('init — t44 info --yes initializes workspace', async () => {
+        const { exitCode, stdout, stderr } = await runT44('info')
+
+        if (exitCode !== 0) {
+            console.log('STDOUT:', stdout)
+            console.log('STDERR:', stderr)
+        }
+
+        expect(exitCode).toBe(0)
+
+        // Verify registry was created
+        const registryDir = join(homeDir, '.o/workspace.foundation')
+        const registryStat = await stat(registryDir)
+        expect(registryStat.isDirectory()).toBe(true)
+
+        // Verify SSH keys were created
+        const sshDir = join(homeDir, '.ssh')
+        const rootKeyStat = await stat(join(sshDir, 'id_t44_ed25519'))
+        expect(rootKeyStat.isFile()).toBe(true)
+
+        const signingKeyStat = await stat(join(sshDir, 'id_t44_signing_ed25519'))
+        expect(signingKeyStat.isFile()).toBe(true)
+    }, 15_000)
+
+    it('info — displays workspace information', async () => {
+        const { exitCode, stdout, stderr } = await runT44('info', '--full')
+
+        if (exitCode !== 0) {
+            console.log('STDOUT:', stdout)
+            console.log('STDERR:', stderr)
+        }
+
+        expect(exitCode).toBe(0)
+        expect(stdout).toContain('WORKSPACE INFORMATION')
+        expect(stdout).toContain('repo')
+        expect(stdout).toContain('did:key:')
+        expect(stdout).toContain('CONFIGURATION FILES')
+    }, 15_000)
+
+    it('activate — outputs shell export statements', async () => {
+        const { exitCode, stdout, stderr } = await runT44('activate')
+
+        if (exitCode !== 0) {
+            console.log('STDOUT:', stdout)
+            console.log('STDERR:', stderr)
+        }
+
+        expect(exitCode).toBe(0)
+        expect(stdout).toContain('export ')
+        expect(stdout).toContain('F_WORKSPACE_DIR')
+    }, 15_000)
+
+    it('query — displays workspace model', async () => {
+        const { exitCode, stdout, stderr } = await runT44('query', '--full')
+
+        if (exitCode !== 0) {
+            console.log('STDOUT:', stdout)
+            console.log('STDERR:', stderr)
+        }
+
+        expect(exitCode).toBe(0)
+        expect(stdout).toContain('WorkspaceConfig')
+    }, 15_000)
+
+})

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+    "extends": "../../../tsconfig.paths.json",
+    "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
+    },
+    "include": [
+        "**/*.ts"
+    ],
+    "exclude": [
+        "node_modules"
+    ]
+}

package/workspace-rt.ts

@@ -0,0 +1,134 @@
+#!/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> {
+    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: {
+            ['t44/caps/WorkspaceConfig']: {
+                '#': {
+                    workspaceRootDir
+                }
+            },
+            ['t44/caps/WorkspaceTest']: {
+                '#': {
+                    testRootDir: options?.importMeta?.dir
+                }
+            }
+        }
+    }, 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