t44 0.4.0-rc.10

package/package.json

@@ -0,0 +1,102 @@
+{
+    "name": "t44",
+    "version": "0.4.0-rc.10",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Stream44/t44.git"
+    },
+    "type": "module",
+    "bin": {
+        "t44": "./bin/t44"
+    },
+    "exports": {
+        "./workspace-rt": "./workspace-rt.ts",
+        "./standalone-rt": "./standalone-rt.ts",
+        "./caps/Home": "./caps/Home.ts",
+        "./caps/HomeRegistry": "./caps/HomeRegistry.ts",
+        "./caps/OpenApiSchema": "./caps/OpenApiSchema.ts",
+        "./caps/JsonSchemas": "./caps/JsonSchemas.ts",
+        "./caps/ProjectDeployment": "./caps/ProjectDeployment.ts",
+        "./caps/ProjectDevelopment": "./caps/ProjectDevelopment.ts",
+        "./caps/ProjectPublishing": "./caps/ProjectPublishing.ts",
+        "./caps/ProjectRack": "./caps/ProjectRack.ts",
+        "./caps/WorkspaceCli": "./caps/WorkspaceCli.ts",
+        "./caps/WorkspaceConfig": "./caps/WorkspaceConfig.ts",
+        "./caps/WorkspaceConnection": "./caps/WorkspaceConnection.ts",
+        "./caps/WorkspaceEntityConfig": "./caps/WorkspaceEntityConfig.ts",
+        "./caps/WorkspaceEntityFact": "./caps/WorkspaceEntityFact.ts",
+        "./caps/WorkspaceInfo": "./caps/WorkspaceInfo.ts",
+        "./caps/WorkspaceInit": "./caps/WorkspaceInit.ts",
+        "./caps/RootKey": "./caps/RootKey.ts",
+        "./caps/WorkspaceKey": "./caps/WorkspaceKey.ts",
+        "./caps/WorkspaceProjects": "./caps/WorkspaceProjects.ts",
+        "./caps/WorkspacePrompt": "./caps/WorkspacePrompt.ts",
+        "./caps/WorkspaceShell": "./caps/WorkspaceShell.ts",
+        "./caps/WorkspaceShellCli": "./caps/WorkspaceShellCli.ts",
+        "./caps/WorkspaceTest": "./caps/WorkspaceTest.ts",
+        "./caps/providers/bunny.net/ProjectDeployment": "./caps/providers/bunny.net/ProjectDeployment.ts",
+        "./caps/providers/dynadot.com/ProjectDeployment": "./caps/providers/dynadot.com/ProjectDeployment.ts",
+        "./caps/providers/git-scm.com/ProjectPublishing": "./caps/providers/git-scm.com/ProjectPublishing.ts",
+        "./caps/providers/github.com/ProjectPublishing": "./caps/providers/github.com/ProjectPublishing.ts",
+        "./caps/providers/npmjs.com/ProjectPublishing": "./caps/providers/npmjs.com/ProjectPublishing.ts",
+        "./caps/providers/semver.org/ProjectPublishing": "./caps/providers/semver.org/ProjectPublishing.ts",
+        "./caps/providers/vercel.com/ProjectDeployment": "./caps/providers/vercel.com/ProjectDeployment.ts",
+        "./structs/HomeRegistryConfig": "./structs/HomeRegistryConfig.ts",
+        "./structs/RootKeyConfig": "./structs/RootKeyConfig.ts",
+        "./structs/ProjectDeploymentConfig": "./structs/ProjectDeploymentConfig.ts",
+        "./structs/ProjectDeploymentFact": "./structs/ProjectDeploymentFact.ts",
+        "./structs/ProjectPublishingFact": "./structs/ProjectPublishingFact.ts",
+        "./structs/ProjectRackConfig": "./structs/ProjectRackConfig.ts",
+        "./structs/WorkspaceCliConfig": "./structs/WorkspaceCliConfig.ts",
+        "./structs/WorkspaceConfig": "./structs/WorkspaceConfig.ts",
+        "./structs/WorkspaceKeyConfig": "./structs/WorkspaceKeyConfig.ts",
+        "./structs/WorkspaceMappingsConfig": "./structs/WorkspaceMappingsConfig.ts",
+        "./structs/WorkspaceProjectsConfig": "./structs/WorkspaceProjectsConfig.ts",
+        "./structs/WorkspacePublishingConfig": "./structs/WorkspacePublishingConfig.ts",
+        "./structs/WorkspaceShellConfig": "./structs/WorkspaceShellConfig.ts",
+        "./structs/providers/bunny.net/PullZoneFact": "./structs/providers/bunny.net/PullZoneFact.ts",
+        "./structs/providers/bunny.net/PullZoneListFact": "./structs/providers/bunny.net/PullZoneListFact.ts",
+        "./structs/providers/bunny.net/StorageZoneFact": "./structs/providers/bunny.net/StorageZoneFact.ts",
+        "./structs/providers/bunny.net/StorageZoneListFact": "./structs/providers/bunny.net/StorageZoneListFact.ts",
+        "./structs/providers/bunny.net/WorkspaceConnectionConfig": "./structs/providers/bunny.net/WorkspaceConnectionConfig.ts",
+        "./structs/providers/dynadot.com/DomainFact": "./structs/providers/dynadot.com/DomainFact.ts",
+        "./structs/providers/dynadot.com/WorkspaceConnectionConfig": "./structs/providers/dynadot.com/WorkspaceConnectionConfig.ts",
+        "./structs/providers/git-scm.com/ProjectPublishingFact": "./structs/providers/git-scm.com/ProjectPublishingFact.ts",
+        "./structs/providers/github.com/ProjectPublishingFact": "./structs/providers/github.com/ProjectPublishingFact.ts",
+        "./structs/providers/github.com/WorkspaceConnectionConfig": "./structs/providers/github.com/WorkspaceConnectionConfig.ts",
+        "./structs/providers/npmjs.com/ProjectPublishingFact": "./structs/providers/npmjs.com/ProjectPublishingFact.ts",
+        "./structs/providers/vercel.com/ProjectDeploymentFact": "./structs/providers/vercel.com/ProjectDeploymentFact.ts",
+        "./structs/providers/vercel.com/WorkspaceConnectionConfig": "./structs/providers/vercel.com/WorkspaceConnectionConfig.ts"
+    },
+    "dependencies": {
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
+        "js-yaml": "^4.1.0",
+        "commander": "^14.0.0",
+        "chalk": "^5.6.2",
+        "dotenv": "^17.2.3",
+        "fast-glob": "^3.3.3",
+        "inquirer": "^12.4.0",
+        "upload-to-bunny": "^2.1.0",
+        "axios": "^1.13.4",
+        "vercel": "^50.4.9",
+        "turbo": "^2.7.5",
+        "@ucanto/principal": "^9.0.3",
+        "@ucanto/server": "^11.0.3",
+        "json-schema-ref-resolver": "^3.0.0",
+        "@stream44.studio/encapsulate": "^0.4.0-rc.9",
+        "@stream44.studio/dco": "^0.3.0-rc.9",
+        "@stream44.studio/t44-blockchaincommons.com": "^0.1.0-rc.10"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.3.4",
+        "@types/node": "^25.0.3",
+        "@types/js-yaml": "^4.0.9",
+        "bun-types": "^1.3.4"
+    },
+    "workspaces": [
+        "caps/providers/vercel.com"
+    ],
+    "private": false
+}

package/standalone-rt.ts

@@ -0,0 +1,121 @@
+#!/usr/bin/env bun
+/// <reference types="bun" />
+/// <reference types="node" />
+
+const startTime = Date.now()
+
+import { resolve, join } 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 findPackageRoot(startDir: string): Promise<string> {
+    let dir = resolve(startDir)
+    while (true) {
+        try {
+            await access(join(dir, 'package.json'))
+            return dir
+        } catch { }
+        const parent = resolve(dir, '..')
+        if (parent === dir) return resolve(startDir)
+        dir = parent
+    }
+}
+
+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 spineFilesystemRoot = options?.importMeta?.dir
+        ? await findPackageRoot(options.importMeta.dir)
+        : process.cwd()
+
+    const { encapsulate, freeze, CapsulePropertyTypes, makeImportStack, hoistSnapshot } = await CapsuleSpineFactory({
+        spineFilesystemRoot,
+        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/WorkspaceTest']: {
+                '#': {
+                    testRootDir: options?.importMeta?.dir
+                }
+            }
+        }
+    }, async (opts) => {
+        return runHandler({
+            ...opts,
+            ...(exportedApi || {})
+        })
+    })
+
+    timing?.recordMajor('DONE')
+
+    return result
+}

package/structs/HomeRegistry.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: {
+                                did: {
+                                    type: 'string',
+                                    description: 'The DID (Decentralized Identifier) of the home registry.'
+                                },
+                                privateKey: {
+                                    type: 'string',
+                                    description: 'The private key associated with the home registry DID.'
+                                },
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp of when the registry was created.'
+                                },
+                                rootDir: {
+                                    type: 'string',
+                                    description: 'Absolute path to the home registry root directory.'
+                                }
+                            },
+                            required: ['did', 'privateKey', 'createdAt', 'rootDir'],
+                            additionalProperties: false,
+                            description: 'Home registry identity containing the root DID and private key.'
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/HomeRegistryFile',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/HomeRegistry'

package/structs/HomeRegistryConfig.ts

@@ -0,0 +1,60 @@
+
+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: {
+                                homeDir: {
+                                    type: 'string',
+                                    description: 'Absolute path to the home directory (parent of registry, .ssh, etc).'
+                                },
+                                rootDir: {
+                                    type: 'string',
+                                    description: 'Absolute path to the home registry root directory.'
+                                },
+                                identifier: {
+                                    type: 'string',
+                                    description: 'DID (Decentralized Identifier) of the home registry.'
+                                },
+                                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: false,
+                            description: 'Home registry configuration with identity and location.'
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityConfig',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/HomeRegistryConfig'

package/structs/ProjectCatalogsConfig.ts

@@ -0,0 +1,53 @@
+
+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: {
+                                catalogs: {
+                                    type: 'object',
+                                    additionalProperties: true,
+                                    description: 'Map of catalog names to their configurations.'
+                                },
+                                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: false,
+                            description: 'Project catalogs configuration.'
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityConfig',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/ProjectCatalogsConfig'

package/structs/ProjectDeploymentConfig.ts

@@ -0,0 +1,56 @@
+
+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: {
+                                deployments: {
+                                    type: 'object',
+                                    additionalProperties: {
+                                        type: 'object',
+                                        additionalProperties: true
+                                    },
+                                    description: 'Map of deployment names to their configurations.'
+                                },
+                                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: false,
+                            description: 'Project deployment configurations for deployment providers.'
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityConfig',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/ProjectDeploymentConfig'

package/structs/ProjectDeploymentFact.ts

@@ -0,0 +1,106 @@
+
+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: {
+                                projectName: {
+                                    type: 'string',
+                                    description: 'The name of the deployed project'
+                                },
+                                provider: {
+                                    type: 'string',
+                                    description: 'The deployment provider (e.g., vercel.com, bunny.net)'
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: ['READY', 'BUILDING', 'ERROR', 'DISABLED', 'UNKNOWN'],
+                                    description: 'Current deployment status'
+                                },
+                                publicUrl: {
+                                    type: 'string',
+                                    format: 'uri',
+                                    description: 'The public URL where the deployment is accessible'
+                                },
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the deployment was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the deployment was last updated'
+                                },
+                                providerProjectId: {
+                                    type: 'string',
+                                    description: 'Provider-specific project identifier'
+                                },
+                                providerPortalUrl: {
+                                    type: 'string',
+                                    format: 'uri',
+                                    description: 'URL to the provider admin portal for this deployment'
+                                },
+                                usage: {
+                                    type: 'object',
+                                    properties: {
+                                        storageBytes: {
+                                            type: 'integer',
+                                            description: 'Storage used in bytes'
+                                        },
+                                        filesCount: {
+                                            type: 'integer',
+                                            description: 'Number of files stored'
+                                        },
+                                        bandwidthBytes: {
+                                            type: 'integer',
+                                            description: 'Bandwidth used in bytes (monthly)'
+                                        },
+                                        charges: {
+                                            type: 'number',
+                                            description: 'Monthly charges in USD'
+                                        }
+                                    },
+                                    description: 'Usage statistics for the deployment'
+                                },
+                                error: {
+                                    type: 'string',
+                                    description: 'Error message if status retrieval failed'
+                                },
+                                rawDefinitionFilepaths: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'string'
+                                    },
+                                    description: 'Relative filepaths to the raw provider-specific definition files'
+                                }
+                            },
+                            required: ['projectName', 'provider', 'rawDefinitionFilepaths']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/ProjectDeploymentFact'

package/structs/ProjectPublishingFact.ts

@@ -0,0 +1,68 @@
+
+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: {
+                                projectName: {
+                                    type: 'string',
+                                    description: 'The name of the published project'
+                                },
+                                provider: {
+                                    type: 'string',
+                                    description: 'The publishing provider (e.g., github.com, git-scm.com, npmjs.com)'
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: ['READY', 'PUBLISHED', 'ERROR', 'SKIPPED', 'UNKNOWN'],
+                                    description: 'Current publishing status'
+                                },
+                                publicUrl: {
+                                    type: 'string',
+                                    format: 'uri',
+                                    description: 'The public URL where the published resource is accessible'
+                                },
+                                createdAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the publishing was created'
+                                },
+                                updatedAt: {
+                                    type: 'string',
+                                    format: 'date-time',
+                                    description: 'ISO 8601 timestamp when the publishing was last updated'
+                                },
+                                error: {
+                                    type: 'string',
+                                    description: 'Error message if publishing failed'
+                                }
+                            },
+                            required: ['projectName', 'provider']
+                        }
+                    }
+                }
+            },
+            '#': {
+                capsuleName: {
+                    type: CapsulePropertyTypes.Literal,
+                    value: capsule['#']
+                },
+            }
+        }
+    }, {
+        extendsCapsule: 't44/caps/WorkspaceEntityFact',
+        importMeta: import.meta,
+        importStack: makeImportStack(),
+        capsuleName: capsule['#'],
+    })
+}
+capsule['#'] = 't44/structs/ProjectPublishingFact'