@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/continuum/sourceBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceBundle.js","sourceRoot":"","sources":["../../src/continuum/sourceBundle.ts"],"names":[],"mappings":"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"}

package/dist/continuum/state.d.ts

@@ -0,0 +1,41 @@
+import { type ContinuumCid } from '@hypersoniclabs/helix-manifest';
+import type { ContinuumPublicationReceipt } from './types';
+export type ContinuumCheckpoint = {
+    schema: 'helix.creator.continuum-checkpoint/1';
+    revision: number;
+    jobId: string;
+    sourceDigest: string;
+    projectId: string;
+    intentDigest: string;
+    objects: Record<string, true>;
+    packageCreated?: true;
+    versionCreated?: true;
+    lease?: {
+        owner: string;
+        fencingToken: string;
+    };
+    sealed?: true;
+    vaultAssetVersionPinned?: true;
+    universalItemPinned?: true;
+    listingIds?: Record<string, true>;
+    worldReleased?: true;
+    receipt?: ContinuumPublicationReceipt;
+};
+export declare function publicationJobId(input: {
+    sourceDigest: string;
+    projectId: string;
+    intent: unknown;
+    compilerVersion: string;
+    contractVersion: string;
+}): string;
+export declare function canonicalIntentDigest(intent: unknown): string;
+export declare class ContinuumCheckpointStore {
+    readonly directory: string;
+    constructor(directory: string);
+    read(jobId: string): Promise<ContinuumCheckpoint | null>;
+    update(jobId: string, create: () => ContinuumCheckpoint, mutate: (checkpoint: ContinuumCheckpoint) => void): Promise<ContinuumCheckpoint>;
+    /** Serialize one durable publication across concurrent CLI/MCP worker processes. */
+    runExclusive<T>(jobId: string, action: () => Promise<T>): Promise<T>;
+    private reconcileOrphans;
+}
+export declare function checkpointHasObject(checkpoint: ContinuumCheckpoint, cid: ContinuumCid): boolean;

package/dist/continuum/state.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContinuumCheckpointStore = void 0;
+exports.publicationJobId = publicationJobId;
+exports.canonicalIntentDigest = canonicalIntentDigest;
+exports.checkpointHasObject = checkpointHasObject;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+function publicationJobId(input) {
+    const normalized = (0, helix_manifest_1.canonicalJsonString)(normalizeIJson(input));
+    return (0, node_crypto_1.createHash)('sha256').update(normalized).digest('hex');
+}
+function canonicalIntentDigest(intent) {
+    return (0, node_crypto_1.createHash)('sha256').update((0, helix_manifest_1.canonicalJsonString)(normalizeIJson(intent))).digest('hex');
+}
+function normalizeIJson(value) {
+    if (Array.isArray(value))
+        return value.map(normalizeIJson);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, child]) => child !== undefined)
+            .map(([key, child]) => [key, normalizeIJson(child)]));
+    }
+    return value;
+}
+class ContinuumCheckpointStore {
+    directory;
+    constructor(directory) {
+        this.directory = directory;
+    }
+    async read(jobId) {
+        try {
+            return JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(this.directory, `${jobId}.json`), 'utf8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    async update(jobId, create, mutate) {
+        await (0, promises_1.mkdir)(this.directory, { recursive: true, mode: 0o700 });
+        const lockPath = (0, node_path_1.join)(this.directory, `${jobId}.lock`);
+        const lock = await acquireFileLock(lockPath, 100, `checkpoint ${jobId}`);
+        try {
+            await this.reconcileOrphans(jobId);
+            const checkpoint = (await this.read(jobId)) ?? create();
+            mutate(checkpoint);
+            checkpoint.revision += 1;
+            const temp = (0, node_path_1.join)(this.directory, `${jobId}.${(0, node_crypto_1.randomUUID)()}.tmp`);
+            await writeDurably(temp, `${JSON.stringify(checkpoint, null, 2)}\n`);
+            await (0, promises_1.rename)(temp, (0, node_path_1.join)(this.directory, `${jobId}.json`));
+            await syncDirectory(this.directory);
+            return checkpoint;
+        }
+        finally {
+            await lock.close();
+            await (0, promises_1.unlink)(lockPath).catch(() => undefined);
+        }
+    }
+    /** Serialize one durable publication across concurrent CLI/MCP worker processes. */
+    async runExclusive(jobId, action) {
+        await (0, promises_1.mkdir)(this.directory, { recursive: true, mode: 0o700 });
+        const lockPath = (0, node_path_1.join)(this.directory, `${jobId}.run.lock`);
+        const lock = await acquireFileLock(lockPath, 600, `publication ${jobId}`);
+        try {
+            await this.reconcileOrphans(jobId);
+            return await action();
+        }
+        finally {
+            await lock.close();
+            await (0, promises_1.unlink)(lockPath).catch(() => undefined);
+        }
+    }
+    async reconcileOrphans(jobId) {
+        const prefix = `${jobId}.`;
+        const candidates = (await (0, promises_1.readdir)(this.directory).catch((error) => {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        })).filter((name) => name.startsWith(prefix) && name.endsWith('.tmp'));
+        if (!candidates.length)
+            return;
+        const currentPath = (0, node_path_1.join)(this.directory, `${jobId}.json`);
+        const current = await readCheckpoint(currentPath, jobId);
+        let best;
+        for (const name of candidates) {
+            const path = (0, node_path_1.join)(this.directory, name);
+            const checkpoint = await readCheckpoint(path, jobId);
+            if (checkpoint && checkpoint.revision > (best?.checkpoint.revision ?? current?.revision ?? -1)) {
+                best = { path, checkpoint };
+            }
+        }
+        if (best) {
+            await (0, promises_1.rename)(best.path, currentPath);
+            await syncDirectory(this.directory);
+        }
+        await Promise.all(candidates.map((name) => {
+            const path = (0, node_path_1.join)(this.directory, name);
+            return path === best?.path ? Promise.resolve() : (0, promises_1.unlink)(path).catch(() => undefined);
+        }));
+    }
+}
+exports.ContinuumCheckpointStore = ContinuumCheckpointStore;
+async function readCheckpoint(path, jobId) {
+    try {
+        const value = JSON.parse(await (0, promises_1.readFile)(path, 'utf8'));
+        return value.schema === 'helix.creator.continuum-checkpoint/1' && value.jobId === jobId && Number.isSafeInteger(value.revision)
+            ? value
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDurably(path, contents) {
+    const handle = await (0, promises_1.open)(path, 'wx', 0o600);
+    try {
+        await handle.writeFile(contents, 'utf8');
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function syncDirectory(directory) {
+    // Windows cannot fsync a directory handle: the handle opens, then `sync()` throws EPERM. The file's
+    // own fsync above is what carries the durability guarantee, so skipping this is a no-op there.
+    if (process.platform === 'win32')
+        return;
+    const handle = await (0, promises_1.open)(directory, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function acquireFileLock(path, attempts, label) {
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        try {
+            const handle = await (0, promises_1.open)(path, 'wx', 0o600);
+            await handle.writeFile(JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString() }));
+            return handle;
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            const staleContents = await deadLockContents(path);
+            if (staleContents !== null) {
+                // Re-read before unlinking so two recoverers do not let the loser
+                // remove a replacement lock acquired by the winner.
+                const current = await (0, promises_1.readFile)(path, 'utf8').catch(() => null);
+                if (current === staleContents) {
+                    await (0, promises_1.unlink)(path).catch(() => undefined);
+                    continue;
+                }
+            }
+            await new Promise((resolve) => setTimeout(resolve, Math.min(20 + attempt * 5, 250)));
+        }
+    }
+    throw new Error(`${label} is busy`);
+}
+async function deadLockContents(path) {
+    try {
+        const contents = await (0, promises_1.readFile)(path, 'utf8');
+        let owner;
+        try {
+            owner = JSON.parse(contents);
+        }
+        catch {
+            const metadata = await (0, promises_1.stat)(path);
+            return Date.now() - metadata.mtimeMs >= 2_000 ? contents : null;
+        }
+        if (!Number.isInteger(owner.pid) || !owner.createdAt) {
+            const metadata = await (0, promises_1.stat)(path);
+            // Avoid racing the short create -> metadata write window, but recover a
+            // partial lock left behind by a process that died before writing it.
+            return Date.now() - metadata.mtimeMs >= 2_000 ? contents : null;
+        }
+        try {
+            process.kill(owner.pid, 0);
+            return null;
+        }
+        catch (error) {
+            return error.code === 'ESRCH' ? contents : null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+function checkpointHasObject(checkpoint, cid) {
+    return checkpoint.objects[cid] === true;
+}
+//# sourceMappingURL=state.js.map

package/dist/continuum/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/continuum/state.ts"],"names":[],"mappings":"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"}

package/dist/continuum/types.d.ts

@@ -0,0 +1,156 @@
+import type { ContinuumCid, ContinuumObjectReference, ContinuumPackage, ContinuumPackageVersion, ContinuumPackageVersionReference, Listing, WorldRelease } from '@hypersoniclabs/helix-manifest';
+import type { SceneCompilationReport } from '../sceneElements/continuum';
+import type { SourceSceneImportReceipt } from '../sceneImport/semantic';
+export declare const CONTINUUM_CREATOR_CONTRACT: "helix.creator.continuum-publish/1";
+export declare const CONTINUUM_CREATOR_COMPILER_VERSION: "1";
+export type ContinuumObjectSource = {
+    kind: 'inline';
+    bytes: Uint8Array;
+    filename: string;
+    audience?: 'private' | 'public';
+} | {
+    kind: 'file';
+    path: string;
+    filename: string;
+    audience?: 'private' | 'public';
+} | {
+    kind: 'universal-item-adoption';
+    assetId: string;
+    contentSha256: string;
+    audience?: 'private' | 'public';
+} | {
+    kind: 'vault-adoption';
+    vaultAssetVersionId: string;
+    audience?: 'private' | 'public';
+} | {
+    kind: 'instant-world-adoption';
+    buildId: string;
+    contentSha256: string;
+} | {
+    kind: 'existing';
+};
+export type ContinuumObjectPublication = {
+    reference: ContinuumObjectReference;
+    source: ContinuumObjectSource;
+};
+export type ContinuumListingIntent = {
+    listing: Listing;
+};
+export type ContinuumPublicationIntent = {
+    projectId: string;
+    sourceDigest: string;
+    package: ContinuumPackage;
+    packagePublication?: {
+        slug?: string;
+        visibility?: 'private' | 'public';
+    };
+    packageVersion: ContinuumPackageVersion;
+    objects: ContinuumObjectPublication[];
+    /** Adopt the primary legacy Vault card as provenance for this exact Package. */
+    vaultAssetVersionPin?: {
+        vaultAssetVersionId: string;
+    };
+    /** Pin this exact sealed Package Version to an existing Universal Item. */
+    universalItemPin?: {
+        itemId: string;
+        promoteToPublished?: true;
+    };
+    /**
+     * Seal this Package Version immutably without making it the Package's current
+     * version. The bytes and the manifest CID are final either way; staging only
+     * withholds the switchover, so a release can be verified before anything resolves
+     * to it. Activate later through the Package Version activate endpoint.
+     */
+    stage?: boolean;
+    /** Ordered post-seal projections. One Package may appear on both surfaces without republishing. */
+    listings: ContinuumListingIntent[];
+    world?: {
+        release: WorldRelease;
+        defaultRuntimeProfileId: string;
+    };
+};
+export type ContinuumConversionReceipt = {
+    scene?: SourceSceneImportReceipt;
+    compilation?: SceneCompilationReport;
+};
+export type ContinuumPublicationReceipt = {
+    schema: 'helix.creator.continuum-receipt/1';
+    jobId: string;
+    status: 'complete';
+    sourceDigest: string;
+    packageId: string;
+    packageVersion: string;
+    manifestCid: ContinuumCid;
+    objectCids: ContinuumCid[];
+    listingIds: string[];
+    universalItemId?: string;
+    vaultAssetVersionId?: string;
+    worldReleaseId?: string;
+    actions: {
+        objectsPublished: number;
+        objectsReused: number;
+        packageCreated: boolean;
+        versionCreated: boolean;
+        versionSealed: boolean;
+        vaultAssetVersionPinned: boolean;
+        universalItemPinned: boolean;
+        listingsCreated: number;
+        worldReleased: boolean;
+    };
+    policy: {
+        listings: Record<string, 'not-public' | 'allowed-cli'>;
+    };
+    conversion?: ContinuumConversionReceipt;
+};
+export type ContinuumObjectRecord = {
+    cid: ContinuumCid;
+    bytes: number;
+    mediaType: string;
+};
+export type ContinuumLease = {
+    leaseOwner: string;
+    fencingToken: string;
+    leaseExpiresAt?: string;
+};
+export interface ContinuumPublicationApi {
+    putObject(input: {
+        bytes: Uint8Array;
+        filename: string;
+        mediaType: string;
+        audience?: 'private' | 'public';
+    }): Promise<ContinuumObjectRecord>;
+    putObjectFromFile(input: {
+        path: string;
+        filename: string;
+        mediaType: string;
+        audience?: 'private' | 'public';
+    }): Promise<ContinuumObjectRecord>;
+    adoptUniversalItemObject(assetId: string, contentSha256: string, audience?: 'private' | 'public'): Promise<ContinuumObjectRecord>;
+    adoptVaultObject(vaultAssetVersionId: string, audience?: 'private' | 'public'): Promise<ContinuumObjectRecord>;
+    adoptInstantWorldObject(buildId: string, contentSha256: string): Promise<ContinuumObjectRecord>;
+    createPackage(pkg: ContinuumPackage, settings?: {
+        slug?: string;
+        visibility?: 'private' | 'public';
+    }): Promise<unknown>;
+    createPackageVersion(packageId: string, version: ContinuumPackageVersion): Promise<unknown>;
+    acquirePackageVersionLease(packageId: string, version: string, input: {
+        leaseOwner: string;
+        ttlSeconds: number;
+        operationId: string;
+        expectedFencingToken?: string;
+    }): Promise<ContinuumLease>;
+    sealPackageVersion(packageId: string, version: string, input: {
+        leaseOwner: string;
+        fencingToken: string;
+    }): Promise<unknown>;
+    pinVaultAssetVersionPackage(vaultAssetVersionId: string, packagePin: ContinuumPackageVersionReference): Promise<unknown>;
+    pinUniversalItemPackage(itemId: string, input: {
+        packagePin: ContinuumPackageVersionReference;
+        promoteToPublished?: true;
+    }): Promise<unknown>;
+    createListing(listing: Listing): Promise<unknown>;
+    publishWorldRelease(worldId: string, input: {
+        release: WorldRelease;
+        defaultRuntimeProfileId: string;
+    }): Promise<unknown>;
+}

package/dist/continuum/types.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTINUUM_CREATOR_COMPILER_VERSION = exports.CONTINUUM_CREATOR_CONTRACT = void 0;
+exports.CONTINUUM_CREATOR_CONTRACT = 'helix.creator.continuum-publish/1';
+exports.CONTINUUM_CREATOR_COMPILER_VERSION = '1';
+//# sourceMappingURL=types.js.map

package/dist/continuum/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/continuum/types.ts"],"names":[],"mappings":";;;AAYa,QAAA,0BAA0B,GAAG,mCAA4C,CAAC;AAC1E,QAAA,kCAAkC,GAAG,GAAY,CAAC"}

package/dist/continuum/workflow.d.ts

@@ -0,0 +1,62 @@
+import { type ScenePackageCompilationInput } from '../sceneElements/continuum';
+import type { FrozenBuild } from '../builds';
+import { type SourceSceneMap } from '../sceneImport/semantic';
+import { type ScratchSceneDescription } from './authoring';
+import { ContinuumCheckpointStore } from './state';
+import { type ContinuumConversionReceipt, type ContinuumObjectPublication, type ContinuumPublicationApi, type ContinuumPublicationIntent, type ContinuumPublicationReceipt } from './types';
+export declare class PublicListingPolicyError extends Error {
+}
+export type ContinuumPublisherOptions = {
+    stateDirectory?: string;
+    /** @deprecated Public Listing authority is invocation-local and cannot be persisted. */
+    policyDirectory?: string;
+    leaseTtlSeconds?: number;
+};
+export declare class ContinuumPublisher {
+    private readonly api;
+    readonly checkpoints: ContinuumCheckpointStore;
+    private readonly leaseTtlSeconds;
+    constructor(api: ContinuumPublicationApi, options?: ContinuumPublisherOptions);
+    publish(input: ContinuumPublicationIntent, conversion?: ContinuumConversionReceipt): Promise<ContinuumPublicationReceipt>;
+    receipt(jobId: string): Promise<ContinuumPublicationReceipt | null>;
+    /** Publish the immutable result of createPrivateBuildDraft -> freezeBuildDraft. */
+    publishFrozenBuild(input: {
+        frozen: FrozenBuild;
+        name: string;
+        projectId: string;
+        sourceDigest: string;
+        objects: ContinuumObjectPublication[];
+        listings?: ContinuumPublicationIntent['listings'];
+    }): Promise<ContinuumPublicationReceipt>;
+    publishSourceMapWorld(input: {
+        source: SourceSceneMap;
+        compilation: Omit<ScenePackageCompilationInput, 'document'>;
+        projectId: string;
+        sourceDigest: string;
+        objects?: ContinuumObjectPublication[];
+        packagePublication?: ContinuumPublicationIntent['packagePublication'];
+        defaultRuntimeProfileId: string;
+        listings?: ContinuumPublicationIntent['listings'];
+    }): Promise<ContinuumPublicationReceipt>;
+    publishScratchWorld(input: {
+        source: ScratchSceneDescription;
+        compilation: Omit<ScenePackageCompilationInput, 'document'>;
+        projectId: string;
+        sourceDigest: string;
+        objects?: ContinuumObjectPublication[];
+        packagePublication?: ContinuumPublicationIntent['packagePublication'];
+        defaultRuntimeProfileId: string;
+        listings?: ContinuumPublicationIntent['listings'];
+    }): Promise<ContinuumPublicationReceipt>;
+    private publishImportedWorld;
+    private authorizeListings;
+    private publishObject;
+}
+/**
+ * The seal-side validation `ContinuumPublisher.publish` runs BEFORE it uploads or seals anything. Pure (no network), exported
+ * so a dry run can run the exact rules the real publish will hit (`provenance.source` length, Package Version shape,
+ * object closure, ...). It throws a TypeError whose message joins every refusal with "; ".
+ */
+export declare function preflightContinuumPublicationIntent(input: ContinuumPublicationIntent): {
+    objects: ContinuumObjectPublication[];
+};