@kb-labs/infra-worker-core 0.5.0

package/README.md

@@ -0,0 +1,19 @@
+# @kb-labs/infra-worker-core
+
+Core package for the KB Labs infra worker plugin.
+
+Exports:
+- V3 plugin manifest (`./plugin-manifest`)
+- CLI command handlers under `src/cli/commands`
+
+## Commands
+
+- `infra-worker:prepare`
+- `infra-worker:capture-snapshot`
+- `infra-worker:restore-snapshot`
+
+## Build
+
+```bash
+pnpm --filter @kb-labs/infra-worker-core build
+```

package/dist/cli/commands/capture-snapshot.d.ts

@@ -0,0 +1,18 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+interface CaptureSnapshotFlags {
+    workspaceId?: string;
+    environmentId?: string;
+    namespace?: string;
+    sourcePath?: string;
+}
+interface CaptureSnapshotInput {
+    argv: string[];
+    flags: CaptureSnapshotFlags;
+}
+interface CaptureSnapshotResult {
+    snapshotId: string;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CaptureSnapshotInput, CaptureSnapshotResult>;
+
+export { _default as default };

package/dist/cli/commands/capture-snapshot.js

@@ -0,0 +1,28 @@
+import { defineCommand } from '@kb-labs/sdk';
+
+// src/cli/commands/capture-snapshot.ts
+var capture_snapshot_default = defineCommand({
+  id: "infra-worker:capture-snapshot",
+  description: "Capture snapshot from workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const snapshot = await ctx.api.snapshot.capture({
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        namespace: flags.namespace,
+        sourcePath: flags.sourcePath
+      });
+      const result = { snapshotId: snapshot.snapshotId };
+      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+
+export { capture_snapshot_default as default };
+//# sourceMappingURL=capture-snapshot.js.map
+//# sourceMappingURL=capture-snapshot.js.map

package/dist/cli/commands/capture-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/capture-snapshot.ts"],"names":[],"mappings":";;;AAkBA,IAAO,2BAAQ,aAAA,CAAoE;AAAA,EACjF,EAAA,EAAI,+BAAA;AAAA,EACJ,WAAA,EAAa,8CAAA;AAAA,EACb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC+C;AAC/C,MAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AACpB,MAAA,MAAM,QAAA,GAAW,MAAM,GAAA,CAAI,GAAA,CAAI,SAAS,OAAA,CAAQ;AAAA,QAC9C,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,YAAY,KAAA,CAAM;AAAA,OACnB,CAAA;AAED,MAAA,MAAM,MAAA,GAAgC,EAAE,UAAA,EAAY,QAAA,CAAS,UAAA,EAAW;AACxE,MAAA,GAAA,CAAI,EAAA,CAAG,OAAA,CAAQ,CAAA,mBAAA,EAAsB,MAAA,CAAO,UAAU,CAAA,CAAE,CAAA;AAExD,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,CAAA;AAAA,QACV;AAAA,OACF;AAAA,IACF;AAAA;AAEJ,CAAC","file":"capture-snapshot.js","sourcesContent":["import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface CaptureSnapshotFlags {\n  workspaceId?: string;\n  environmentId?: string;\n  namespace?: string;\n  sourcePath?: string;\n}\n\ninterface CaptureSnapshotInput {\n  argv: string[];\n  flags: CaptureSnapshotFlags;\n}\n\ninterface CaptureSnapshotResult {\n  snapshotId: string;\n}\n\nexport default defineCommand<unknown, CaptureSnapshotInput, CaptureSnapshotResult>({\n  id: 'infra-worker:capture-snapshot',\n  description: 'Capture snapshot from workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: CaptureSnapshotInput\n    ): Promise<CommandResult<CaptureSnapshotResult>> {\n      const flags = input.flags;\n      const snapshot = await ctx.api.snapshot.capture({\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        namespace: flags.namespace,\n        sourcePath: flags.sourcePath,\n      });\n\n      const result: CaptureSnapshotResult = { snapshotId: snapshot.snapshotId };\n      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n"]}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,4 @@
+export { default as prepareInfraCommand } from './prepare-infra.js';
+export { default as captureSnapshotCommand } from './capture-snapshot.js';
+export { default as restoreSnapshotCommand } from './restore-snapshot.js';
+import '@kb-labs/shared-command-kit';

package/dist/cli/commands/index.js

@@ -0,0 +1,142 @@
+import { defineCommand } from '@kb-labs/sdk';
+
+// src/cli/commands/prepare-infra.ts
+function toBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  return void 0;
+}
+function toNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
+}
+var prepare_infra_default = defineCommand({
+  id: "infra-worker:prepare",
+  description: "Materialize workspace, optionally provision environment, optionally capture snapshot.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;
+      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;
+      const ttlMs = toNumber(flags.ttlMs);
+      const workspace = await ctx.api.workspace.materialize({
+        sourceRef: flags.sourceRef,
+        basePath: flags.basePath
+      });
+      let environmentId;
+      if (createEnvironment) {
+        const environment = await ctx.api.environment.create({
+          templateId: flags.templateId,
+          ttlMs,
+          workspacePath: workspace.rootPath ?? flags.basePath
+        });
+        environmentId = environment.environmentId;
+        await ctx.api.workspace.attach({
+          workspaceId: workspace.workspaceId,
+          environmentId
+        });
+      }
+      let snapshotId;
+      if (captureSnapshot) {
+        const snapshot = await ctx.api.snapshot.capture({
+          workspaceId: workspace.workspaceId,
+          environmentId,
+          namespace: flags.namespace
+        });
+        snapshotId = snapshot.snapshotId;
+      }
+      const result = {
+        workspaceId: workspace.workspaceId,
+        environmentId,
+        snapshotId
+      };
+      ctx.ui.success("Infrastructure prepared", {
+        sections: [
+          {
+            header: "Identifiers",
+            items: [
+              `workspaceId: ${result.workspaceId}`,
+              `environmentId: ${result.environmentId ?? "-"}`,
+              `snapshotId: ${result.snapshotId ?? "-"}`
+            ]
+          }
+        ]
+      });
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+var capture_snapshot_default = defineCommand({
+  id: "infra-worker:capture-snapshot",
+  description: "Capture snapshot from workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const snapshot = await ctx.api.snapshot.capture({
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        namespace: flags.namespace,
+        sourcePath: flags.sourcePath
+      });
+      const result = { snapshotId: snapshot.snapshotId };
+      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+var restore_snapshot_default = defineCommand({
+  id: "infra-worker:restore-snapshot",
+  description: "Restore snapshot to workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      if (!flags.snapshotId) {
+        throw new Error("Missing required flag: snapshotId");
+      }
+      const restored = await ctx.api.snapshot.restore({
+        snapshotId: flags.snapshotId,
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        targetPath: flags.targetPath,
+        overwrite: flags.overwrite
+      });
+      const result = {
+        snapshotId: restored.snapshotId,
+        restoredAt: restored.restoredAt
+      };
+      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+
+export { capture_snapshot_default as captureSnapshotCommand, prepare_infra_default as prepareInfraCommand, restore_snapshot_default as restoreSnapshotCommand };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/prepare-infra.ts","../../../src/cli/commands/capture-snapshot.ts","../../../src/cli/commands/restore-snapshot.ts"],"names":["defineCommand"],"mappings":"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","file":"index.js","sourcesContent":["import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface PrepareInfraFlags {\n  sourceRef?: string;\n  basePath?: string;\n  createEnvironment?: boolean;\n  templateId?: string;\n  ttlMs?: number;\n  captureSnapshot?: boolean;\n  namespace?: string;\n}\n\ninterface PrepareInfraInput {\n  argv: string[];\n  flags: PrepareInfraFlags;\n}\n\ninterface PrepareInfraResult {\n  workspaceId: string;\n  environmentId?: string;\n  snapshotId?: string;\n}\n\nfunction toBoolean(value: unknown): boolean | undefined {\n  if (typeof value === 'boolean') {\n    return value;\n  }\n  if (typeof value === 'string') {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === 'true') {return true;}\n    if (normalized === 'false') {return false;}\n  }\n  return undefined;\n}\n\nfunction toNumber(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value === 'string' && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) {return parsed;}\n  }\n  return undefined;\n}\n\nexport default defineCommand<unknown, PrepareInfraInput, PrepareInfraResult>({\n  id: 'infra-worker:prepare',\n  description: 'Materialize workspace, optionally provision environment, optionally capture snapshot.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: PrepareInfraInput\n    ): Promise<CommandResult<PrepareInfraResult>> {\n      const flags = input.flags;\n      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;\n      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;\n      const ttlMs = toNumber(flags.ttlMs);\n\n      const workspace = await ctx.api.workspace.materialize({\n        sourceRef: flags.sourceRef,\n        basePath: flags.basePath,\n      });\n\n      let environmentId: string | undefined;\n      if (createEnvironment) {\n        const environment = await ctx.api.environment.create({\n          templateId: flags.templateId,\n          ttlMs,\n          workspacePath: workspace.rootPath ?? flags.basePath,\n        });\n        environmentId = environment.environmentId;\n        await ctx.api.workspace.attach({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n        });\n      }\n\n      let snapshotId: string | undefined;\n      if (captureSnapshot) {\n        const snapshot = await ctx.api.snapshot.capture({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n          namespace: flags.namespace,\n        });\n        snapshotId = snapshot.snapshotId;\n      }\n\n      const result: PrepareInfraResult = {\n        workspaceId: workspace.workspaceId,\n        environmentId,\n        snapshotId,\n      };\n\n      ctx.ui.success('Infrastructure prepared', {\n        sections: [\n          {\n            header: 'Identifiers',\n            items: [\n              `workspaceId: ${result.workspaceId}`,\n              `environmentId: ${result.environmentId ?? '-'}`,\n              `snapshotId: ${result.snapshotId ?? '-'}`,\n            ],\n          },\n        ],\n      });\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n","import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface CaptureSnapshotFlags {\n  workspaceId?: string;\n  environmentId?: string;\n  namespace?: string;\n  sourcePath?: string;\n}\n\ninterface CaptureSnapshotInput {\n  argv: string[];\n  flags: CaptureSnapshotFlags;\n}\n\ninterface CaptureSnapshotResult {\n  snapshotId: string;\n}\n\nexport default defineCommand<unknown, CaptureSnapshotInput, CaptureSnapshotResult>({\n  id: 'infra-worker:capture-snapshot',\n  description: 'Capture snapshot from workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: CaptureSnapshotInput\n    ): Promise<CommandResult<CaptureSnapshotResult>> {\n      const flags = input.flags;\n      const snapshot = await ctx.api.snapshot.capture({\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        namespace: flags.namespace,\n        sourcePath: flags.sourcePath,\n      });\n\n      const result: CaptureSnapshotResult = { snapshotId: snapshot.snapshotId };\n      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n","import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface RestoreSnapshotFlags {\n  snapshotId?: string;\n  workspaceId?: string;\n  environmentId?: string;\n  targetPath?: string;\n  overwrite?: boolean;\n}\n\ninterface RestoreSnapshotInput {\n  argv: string[];\n  flags: RestoreSnapshotFlags;\n}\n\ninterface RestoreSnapshotResult {\n  snapshotId: string;\n  restoredAt: string;\n}\n\nexport default defineCommand<unknown, RestoreSnapshotInput, RestoreSnapshotResult>({\n  id: 'infra-worker:restore-snapshot',\n  description: 'Restore snapshot to workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: RestoreSnapshotInput\n    ): Promise<CommandResult<RestoreSnapshotResult>> {\n      const flags = input.flags;\n      if (!flags.snapshotId) {\n        throw new Error('Missing required flag: snapshotId');\n      }\n\n      const restored = await ctx.api.snapshot.restore({\n        snapshotId: flags.snapshotId,\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        targetPath: flags.targetPath,\n        overwrite: flags.overwrite,\n      });\n\n      const result: RestoreSnapshotResult = {\n        snapshotId: restored.snapshotId,\n        restoredAt: restored.restoredAt,\n      };\n      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n"]}

package/dist/cli/commands/prepare-infra.d.ts

@@ -0,0 +1,23 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+interface PrepareInfraFlags {
+    sourceRef?: string;
+    basePath?: string;
+    createEnvironment?: boolean;
+    templateId?: string;
+    ttlMs?: number;
+    captureSnapshot?: boolean;
+    namespace?: string;
+}
+interface PrepareInfraInput {
+    argv: string[];
+    flags: PrepareInfraFlags;
+}
+interface PrepareInfraResult {
+    workspaceId: string;
+    environmentId?: string;
+    snapshotId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, PrepareInfraInput, PrepareInfraResult>;
+
+export { _default as default };

package/dist/cli/commands/prepare-infra.js

@@ -0,0 +1,93 @@
+import { defineCommand } from '@kb-labs/sdk';
+
+// src/cli/commands/prepare-infra.ts
+function toBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  return void 0;
+}
+function toNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
+}
+var prepare_infra_default = defineCommand({
+  id: "infra-worker:prepare",
+  description: "Materialize workspace, optionally provision environment, optionally capture snapshot.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;
+      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;
+      const ttlMs = toNumber(flags.ttlMs);
+      const workspace = await ctx.api.workspace.materialize({
+        sourceRef: flags.sourceRef,
+        basePath: flags.basePath
+      });
+      let environmentId;
+      if (createEnvironment) {
+        const environment = await ctx.api.environment.create({
+          templateId: flags.templateId,
+          ttlMs,
+          workspacePath: workspace.rootPath ?? flags.basePath
+        });
+        environmentId = environment.environmentId;
+        await ctx.api.workspace.attach({
+          workspaceId: workspace.workspaceId,
+          environmentId
+        });
+      }
+      let snapshotId;
+      if (captureSnapshot) {
+        const snapshot = await ctx.api.snapshot.capture({
+          workspaceId: workspace.workspaceId,
+          environmentId,
+          namespace: flags.namespace
+        });
+        snapshotId = snapshot.snapshotId;
+      }
+      const result = {
+        workspaceId: workspace.workspaceId,
+        environmentId,
+        snapshotId
+      };
+      ctx.ui.success("Infrastructure prepared", {
+        sections: [
+          {
+            header: "Identifiers",
+            items: [
+              `workspaceId: ${result.workspaceId}`,
+              `environmentId: ${result.environmentId ?? "-"}`,
+              `snapshotId: ${result.snapshotId ?? "-"}`
+            ]
+          }
+        ]
+      });
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+
+export { prepare_infra_default as default };
+//# sourceMappingURL=prepare-infra.js.map
+//# sourceMappingURL=prepare-infra.js.map

package/dist/cli/commands/prepare-infra.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/prepare-infra.ts"],"names":[],"mappings":"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","file":"prepare-infra.js","sourcesContent":["import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface PrepareInfraFlags {\n  sourceRef?: string;\n  basePath?: string;\n  createEnvironment?: boolean;\n  templateId?: string;\n  ttlMs?: number;\n  captureSnapshot?: boolean;\n  namespace?: string;\n}\n\ninterface PrepareInfraInput {\n  argv: string[];\n  flags: PrepareInfraFlags;\n}\n\ninterface PrepareInfraResult {\n  workspaceId: string;\n  environmentId?: string;\n  snapshotId?: string;\n}\n\nfunction toBoolean(value: unknown): boolean | undefined {\n  if (typeof value === 'boolean') {\n    return value;\n  }\n  if (typeof value === 'string') {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === 'true') {return true;}\n    if (normalized === 'false') {return false;}\n  }\n  return undefined;\n}\n\nfunction toNumber(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value === 'string' && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) {return parsed;}\n  }\n  return undefined;\n}\n\nexport default defineCommand<unknown, PrepareInfraInput, PrepareInfraResult>({\n  id: 'infra-worker:prepare',\n  description: 'Materialize workspace, optionally provision environment, optionally capture snapshot.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: PrepareInfraInput\n    ): Promise<CommandResult<PrepareInfraResult>> {\n      const flags = input.flags;\n      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;\n      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;\n      const ttlMs = toNumber(flags.ttlMs);\n\n      const workspace = await ctx.api.workspace.materialize({\n        sourceRef: flags.sourceRef,\n        basePath: flags.basePath,\n      });\n\n      let environmentId: string | undefined;\n      if (createEnvironment) {\n        const environment = await ctx.api.environment.create({\n          templateId: flags.templateId,\n          ttlMs,\n          workspacePath: workspace.rootPath ?? flags.basePath,\n        });\n        environmentId = environment.environmentId;\n        await ctx.api.workspace.attach({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n        });\n      }\n\n      let snapshotId: string | undefined;\n      if (captureSnapshot) {\n        const snapshot = await ctx.api.snapshot.capture({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n          namespace: flags.namespace,\n        });\n        snapshotId = snapshot.snapshotId;\n      }\n\n      const result: PrepareInfraResult = {\n        workspaceId: workspace.workspaceId,\n        environmentId,\n        snapshotId,\n      };\n\n      ctx.ui.success('Infrastructure prepared', {\n        sections: [\n          {\n            header: 'Identifiers',\n            items: [\n              `workspaceId: ${result.workspaceId}`,\n              `environmentId: ${result.environmentId ?? '-'}`,\n              `snapshotId: ${result.snapshotId ?? '-'}`,\n            ],\n          },\n        ],\n      });\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n"]}

package/dist/cli/commands/restore-snapshot.d.ts

@@ -0,0 +1,20 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+interface RestoreSnapshotFlags {
+    snapshotId?: string;
+    workspaceId?: string;
+    environmentId?: string;
+    targetPath?: string;
+    overwrite?: boolean;
+}
+interface RestoreSnapshotInput {
+    argv: string[];
+    flags: RestoreSnapshotFlags;
+}
+interface RestoreSnapshotResult {
+    snapshotId: string;
+    restoredAt: string;
+}
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, RestoreSnapshotInput, RestoreSnapshotResult>;
+
+export { _default as default };

package/dist/cli/commands/restore-snapshot.js

@@ -0,0 +1,35 @@
+import { defineCommand } from '@kb-labs/sdk';
+
+// src/cli/commands/restore-snapshot.ts
+var restore_snapshot_default = defineCommand({
+  id: "infra-worker:restore-snapshot",
+  description: "Restore snapshot to workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      if (!flags.snapshotId) {
+        throw new Error("Missing required flag: snapshotId");
+      }
+      const restored = await ctx.api.snapshot.restore({
+        snapshotId: flags.snapshotId,
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        targetPath: flags.targetPath,
+        overwrite: flags.overwrite
+      });
+      const result = {
+        snapshotId: restored.snapshotId,
+        restoredAt: restored.restoredAt
+      };
+      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+
+export { restore_snapshot_default as default };
+//# sourceMappingURL=restore-snapshot.js.map
+//# sourceMappingURL=restore-snapshot.js.map

package/dist/cli/commands/restore-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/restore-snapshot.ts"],"names":[],"mappings":";;;AAoBA,IAAO,2BAAQ,aAAA,CAAoE;AAAA,EACjF,EAAA,EAAI,+BAAA;AAAA,EACJ,WAAA,EAAa,4CAAA;AAAA,EACb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC+C;AAC/C,MAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AACpB,MAAA,IAAI,CAAC,MAAM,UAAA,EAAY;AACrB,QAAA,MAAM,IAAI,MAAM,mCAAmC,CAAA;AAAA,MACrD;AAEA,MAAA,MAAM,QAAA,GAAW,MAAM,GAAA,CAAI,GAAA,CAAI,SAAS,OAAA,CAAQ;AAAA,QAC9C,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,WAAW,KAAA,CAAM;AAAA,OAClB,CAAA;AAED,MAAA,MAAM,MAAA,GAAgC;AAAA,QACpC,YAAY,QAAA,CAAS,UAAA;AAAA,QACrB,YAAY,QAAA,CAAS;AAAA,OACvB;AACA,MAAA,GAAA,CAAI,EAAA,CAAG,OAAA,CAAQ,CAAA,mBAAA,EAAsB,MAAA,CAAO,UAAU,CAAA,CAAE,CAAA;AAExD,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,CAAA;AAAA,QACV;AAAA,OACF;AAAA,IACF;AAAA;AAEJ,CAAC","file":"restore-snapshot.js","sourcesContent":["import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface RestoreSnapshotFlags {\n  snapshotId?: string;\n  workspaceId?: string;\n  environmentId?: string;\n  targetPath?: string;\n  overwrite?: boolean;\n}\n\ninterface RestoreSnapshotInput {\n  argv: string[];\n  flags: RestoreSnapshotFlags;\n}\n\ninterface RestoreSnapshotResult {\n  snapshotId: string;\n  restoredAt: string;\n}\n\nexport default defineCommand<unknown, RestoreSnapshotInput, RestoreSnapshotResult>({\n  id: 'infra-worker:restore-snapshot',\n  description: 'Restore snapshot to workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: RestoreSnapshotInput\n    ): Promise<CommandResult<RestoreSnapshotResult>> {\n      const flags = input.flags;\n      if (!flags.snapshotId) {\n        throw new Error('Missing required flag: snapshotId');\n      }\n\n      const restored = await ctx.api.snapshot.restore({\n        snapshotId: flags.snapshotId,\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        targetPath: flags.targetPath,\n        overwrite: flags.overwrite,\n      });\n\n      const result: RestoreSnapshotResult = {\n        snapshotId: restored.snapshotId,\n        restoredAt: restored.restoredAt,\n      };\n      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { default as prepareInfraCommand } from './cli/commands/prepare-infra.js';
+export { default as captureSnapshotCommand } from './cli/commands/capture-snapshot.js';
+export { default as restoreSnapshotCommand } from './cli/commands/restore-snapshot.js';
+export { default as manifest } from './manifest.v3.js';
+import '@kb-labs/shared-command-kit';
+import '@kb-labs/plugin-contracts';

package/dist/index.js

@@ -0,0 +1,226 @@
+import { defineCommand, defineCommandFlags } from '@kb-labs/sdk';
+
+// src/cli/commands/prepare-infra.ts
+function toBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  return void 0;
+}
+function toNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
+  }
+  return void 0;
+}
+var prepare_infra_default = defineCommand({
+  id: "infra-worker:prepare",
+  description: "Materialize workspace, optionally provision environment, optionally capture snapshot.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;
+      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;
+      const ttlMs = toNumber(flags.ttlMs);
+      const workspace = await ctx.api.workspace.materialize({
+        sourceRef: flags.sourceRef,
+        basePath: flags.basePath
+      });
+      let environmentId;
+      if (createEnvironment) {
+        const environment = await ctx.api.environment.create({
+          templateId: flags.templateId,
+          ttlMs,
+          workspacePath: workspace.rootPath ?? flags.basePath
+        });
+        environmentId = environment.environmentId;
+        await ctx.api.workspace.attach({
+          workspaceId: workspace.workspaceId,
+          environmentId
+        });
+      }
+      let snapshotId;
+      if (captureSnapshot) {
+        const snapshot = await ctx.api.snapshot.capture({
+          workspaceId: workspace.workspaceId,
+          environmentId,
+          namespace: flags.namespace
+        });
+        snapshotId = snapshot.snapshotId;
+      }
+      const result = {
+        workspaceId: workspace.workspaceId,
+        environmentId,
+        snapshotId
+      };
+      ctx.ui.success("Infrastructure prepared", {
+        sections: [
+          {
+            header: "Identifiers",
+            items: [
+              `workspaceId: ${result.workspaceId}`,
+              `environmentId: ${result.environmentId ?? "-"}`,
+              `snapshotId: ${result.snapshotId ?? "-"}`
+            ]
+          }
+        ]
+      });
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+var capture_snapshot_default = defineCommand({
+  id: "infra-worker:capture-snapshot",
+  description: "Capture snapshot from workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      const snapshot = await ctx.api.snapshot.capture({
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        namespace: flags.namespace,
+        sourcePath: flags.sourcePath
+      });
+      const result = { snapshotId: snapshot.snapshotId };
+      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+var restore_snapshot_default = defineCommand({
+  id: "infra-worker:restore-snapshot",
+  description: "Restore snapshot to workspace/environment.",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags;
+      if (!flags.snapshotId) {
+        throw new Error("Missing required flag: snapshotId");
+      }
+      const restored = await ctx.api.snapshot.restore({
+        snapshotId: flags.snapshotId,
+        workspaceId: flags.workspaceId,
+        environmentId: flags.environmentId,
+        targetPath: flags.targetPath,
+        overwrite: flags.overwrite
+      });
+      const result = {
+        snapshotId: restored.snapshotId,
+        restoredAt: restored.restoredAt
+      };
+      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);
+      return {
+        exitCode: 0,
+        result
+      };
+    }
+  }
+});
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/infra-worker",
+  version: "0.1.0",
+  display: {
+    name: "Infra Worker",
+    description: "Provision infra capabilities and return stable IDs for orchestrators.",
+    tags: ["infra", "workspace", "environment", "snapshot"]
+  },
+  permissions: {
+    platform: {
+      environment: {
+        create: true,
+        read: true,
+        destroy: true,
+        renewLease: true,
+        templates: ["*"]
+      },
+      workspace: {
+        materialize: true,
+        attach: true,
+        release: true,
+        read: true,
+        sources: ["*"],
+        paths: ["*"]
+      },
+      snapshot: {
+        capture: true,
+        restore: true,
+        delete: true,
+        read: true,
+        garbageCollect: true,
+        namespaces: ["*"]
+      }
+    }
+  },
+  cli: {
+    commands: [
+      {
+        id: "infra-worker:prepare",
+        group: "infra-worker",
+        describe: "Materialize workspace, optional environment, and optional snapshot.",
+        handler: "./cli/commands/prepare-infra.js#default",
+        handlerPath: "./cli/commands/prepare-infra.js",
+        flags: defineCommandFlags({
+          sourceRef: { type: "string", description: "Workspace source reference (repo/branch/etc)" },
+          basePath: { type: "string", description: "Workspace base path" },
+          createEnvironment: { type: "boolean", default: false, description: "Provision environment after workspace materialize" },
+          templateId: { type: "string", description: "Environment template ID" },
+          ttlMs: { type: "number", description: "Environment lease TTL in milliseconds" },
+          captureSnapshot: { type: "boolean", default: false, description: "Capture snapshot after prepare" },
+          namespace: { type: "string", description: "Snapshot namespace" }
+        })
+      },
+      {
+        id: "infra-worker:capture-snapshot",
+        group: "infra-worker",
+        describe: "Capture snapshot for workspace/environment.",
+        handler: "./cli/commands/capture-snapshot.js#default",
+        handlerPath: "./cli/commands/capture-snapshot.js",
+        flags: defineCommandFlags({
+          workspaceId: { type: "string", description: "Workspace ID" },
+          environmentId: { type: "string", description: "Environment ID" },
+          namespace: { type: "string", description: "Snapshot namespace" },
+          sourcePath: { type: "string", description: "Source path for snapshot" }
+        })
+      },
+      {
+        id: "infra-worker:restore-snapshot",
+        group: "infra-worker",
+        describe: "Restore snapshot to workspace/environment target.",
+        handler: "./cli/commands/restore-snapshot.js#default",
+        handlerPath: "./cli/commands/restore-snapshot.js",
+        flags: defineCommandFlags({
+          snapshotId: { type: "string", required: true, description: "Snapshot ID to restore" },
+          workspaceId: { type: "string", description: "Workspace ID target" },
+          environmentId: { type: "string", description: "Environment ID target" },
+          targetPath: { type: "string", description: "Restore target path" },
+          overwrite: { type: "boolean", default: false, description: "Overwrite existing files" }
+        })
+      }
+    ]
+  }
+};
+
+export { capture_snapshot_default as captureSnapshotCommand, manifest, prepare_infra_default as prepareInfraCommand, restore_snapshot_default as restoreSnapshotCommand };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/prepare-infra.ts","../src/cli/commands/capture-snapshot.ts","../src/cli/commands/restore-snapshot.ts","../src/manifest.v3.ts"],"names":["defineCommand"],"mappings":"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","file":"index.js","sourcesContent":["import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface PrepareInfraFlags {\n  sourceRef?: string;\n  basePath?: string;\n  createEnvironment?: boolean;\n  templateId?: string;\n  ttlMs?: number;\n  captureSnapshot?: boolean;\n  namespace?: string;\n}\n\ninterface PrepareInfraInput {\n  argv: string[];\n  flags: PrepareInfraFlags;\n}\n\ninterface PrepareInfraResult {\n  workspaceId: string;\n  environmentId?: string;\n  snapshotId?: string;\n}\n\nfunction toBoolean(value: unknown): boolean | undefined {\n  if (typeof value === 'boolean') {\n    return value;\n  }\n  if (typeof value === 'string') {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === 'true') {return true;}\n    if (normalized === 'false') {return false;}\n  }\n  return undefined;\n}\n\nfunction toNumber(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value === 'string' && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) {return parsed;}\n  }\n  return undefined;\n}\n\nexport default defineCommand<unknown, PrepareInfraInput, PrepareInfraResult>({\n  id: 'infra-worker:prepare',\n  description: 'Materialize workspace, optionally provision environment, optionally capture snapshot.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: PrepareInfraInput\n    ): Promise<CommandResult<PrepareInfraResult>> {\n      const flags = input.flags;\n      const createEnvironment = toBoolean(flags.createEnvironment) ?? false;\n      const captureSnapshot = toBoolean(flags.captureSnapshot) ?? false;\n      const ttlMs = toNumber(flags.ttlMs);\n\n      const workspace = await ctx.api.workspace.materialize({\n        sourceRef: flags.sourceRef,\n        basePath: flags.basePath,\n      });\n\n      let environmentId: string | undefined;\n      if (createEnvironment) {\n        const environment = await ctx.api.environment.create({\n          templateId: flags.templateId,\n          ttlMs,\n          workspacePath: workspace.rootPath ?? flags.basePath,\n        });\n        environmentId = environment.environmentId;\n        await ctx.api.workspace.attach({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n        });\n      }\n\n      let snapshotId: string | undefined;\n      if (captureSnapshot) {\n        const snapshot = await ctx.api.snapshot.capture({\n          workspaceId: workspace.workspaceId,\n          environmentId,\n          namespace: flags.namespace,\n        });\n        snapshotId = snapshot.snapshotId;\n      }\n\n      const result: PrepareInfraResult = {\n        workspaceId: workspace.workspaceId,\n        environmentId,\n        snapshotId,\n      };\n\n      ctx.ui.success('Infrastructure prepared', {\n        sections: [\n          {\n            header: 'Identifiers',\n            items: [\n              `workspaceId: ${result.workspaceId}`,\n              `environmentId: ${result.environmentId ?? '-'}`,\n              `snapshotId: ${result.snapshotId ?? '-'}`,\n            ],\n          },\n        ],\n      });\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n","import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface CaptureSnapshotFlags {\n  workspaceId?: string;\n  environmentId?: string;\n  namespace?: string;\n  sourcePath?: string;\n}\n\ninterface CaptureSnapshotInput {\n  argv: string[];\n  flags: CaptureSnapshotFlags;\n}\n\ninterface CaptureSnapshotResult {\n  snapshotId: string;\n}\n\nexport default defineCommand<unknown, CaptureSnapshotInput, CaptureSnapshotResult>({\n  id: 'infra-worker:capture-snapshot',\n  description: 'Capture snapshot from workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: CaptureSnapshotInput\n    ): Promise<CommandResult<CaptureSnapshotResult>> {\n      const flags = input.flags;\n      const snapshot = await ctx.api.snapshot.capture({\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        namespace: flags.namespace,\n        sourcePath: flags.sourcePath,\n      });\n\n      const result: CaptureSnapshotResult = { snapshotId: snapshot.snapshotId };\n      ctx.ui.success(`Snapshot captured: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n","import { defineCommand, type CommandResult, type PluginContextV3 } from '@kb-labs/sdk';\n\ninterface RestoreSnapshotFlags {\n  snapshotId?: string;\n  workspaceId?: string;\n  environmentId?: string;\n  targetPath?: string;\n  overwrite?: boolean;\n}\n\ninterface RestoreSnapshotInput {\n  argv: string[];\n  flags: RestoreSnapshotFlags;\n}\n\ninterface RestoreSnapshotResult {\n  snapshotId: string;\n  restoredAt: string;\n}\n\nexport default defineCommand<unknown, RestoreSnapshotInput, RestoreSnapshotResult>({\n  id: 'infra-worker:restore-snapshot',\n  description: 'Restore snapshot to workspace/environment.',\n  handler: {\n    async execute(\n      ctx: PluginContextV3<unknown>,\n      input: RestoreSnapshotInput\n    ): Promise<CommandResult<RestoreSnapshotResult>> {\n      const flags = input.flags;\n      if (!flags.snapshotId) {\n        throw new Error('Missing required flag: snapshotId');\n      }\n\n      const restored = await ctx.api.snapshot.restore({\n        snapshotId: flags.snapshotId,\n        workspaceId: flags.workspaceId,\n        environmentId: flags.environmentId,\n        targetPath: flags.targetPath,\n        overwrite: flags.overwrite,\n      });\n\n      const result: RestoreSnapshotResult = {\n        snapshotId: restored.snapshotId,\n        restoredAt: restored.restoredAt,\n      };\n      ctx.ui.success(`Snapshot restored: ${result.snapshotId}`);\n\n      return {\n        exitCode: 0,\n        result,\n      };\n    },\n  },\n});\n","import type { ManifestV3 } from '@kb-labs/plugin-contracts';\nimport { defineCommandFlags } from '@kb-labs/sdk';\n\nexport const manifest: ManifestV3 = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/infra-worker',\n  version: '0.1.0',\n  display: {\n    name: 'Infra Worker',\n    description: 'Provision infra capabilities and return stable IDs for orchestrators.',\n    tags: ['infra', 'workspace', 'environment', 'snapshot'],\n  },\n  permissions: {\n    platform: {\n      environment: {\n        create: true,\n        read: true,\n        destroy: true,\n        renewLease: true,\n        templates: ['*'],\n      },\n      workspace: {\n        materialize: true,\n        attach: true,\n        release: true,\n        read: true,\n        sources: ['*'],\n        paths: ['*'],\n      },\n      snapshot: {\n        capture: true,\n        restore: true,\n        delete: true,\n        read: true,\n        garbageCollect: true,\n        namespaces: ['*'],\n      },\n    },\n  },\n  cli: {\n    commands: [\n      {\n        id: 'infra-worker:prepare',\n        group: 'infra-worker',\n        describe: 'Materialize workspace, optional environment, and optional snapshot.',\n        handler: './cli/commands/prepare-infra.js#default',\n        handlerPath: './cli/commands/prepare-infra.js',\n        flags: defineCommandFlags({\n          sourceRef: { type: 'string', description: 'Workspace source reference (repo/branch/etc)' },\n          basePath: { type: 'string', description: 'Workspace base path' },\n          createEnvironment: { type: 'boolean', default: false, description: 'Provision environment after workspace materialize' },\n          templateId: { type: 'string', description: 'Environment template ID' },\n          ttlMs: { type: 'number', description: 'Environment lease TTL in milliseconds' },\n          captureSnapshot: { type: 'boolean', default: false, description: 'Capture snapshot after prepare' },\n          namespace: { type: 'string', description: 'Snapshot namespace' },\n        }),\n      },\n      {\n        id: 'infra-worker:capture-snapshot',\n        group: 'infra-worker',\n        describe: 'Capture snapshot for workspace/environment.',\n        handler: './cli/commands/capture-snapshot.js#default',\n        handlerPath: './cli/commands/capture-snapshot.js',\n        flags: defineCommandFlags({\n          workspaceId: { type: 'string', description: 'Workspace ID' },\n          environmentId: { type: 'string', description: 'Environment ID' },\n          namespace: { type: 'string', description: 'Snapshot namespace' },\n          sourcePath: { type: 'string', description: 'Source path for snapshot' },\n        }),\n      },\n      {\n        id: 'infra-worker:restore-snapshot',\n        group: 'infra-worker',\n        describe: 'Restore snapshot to workspace/environment target.',\n        handler: './cli/commands/restore-snapshot.js#default',\n        handlerPath: './cli/commands/restore-snapshot.js',\n        flags: defineCommandFlags({\n          snapshotId: { type: 'string', required: true, description: 'Snapshot ID to restore' },\n          workspaceId: { type: 'string', description: 'Workspace ID target' },\n          environmentId: { type: 'string', description: 'Environment ID target' },\n          targetPath: { type: 'string', description: 'Restore target path' },\n          overwrite: { type: 'boolean', default: false, description: 'Overwrite existing files' },\n        }),\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"]}

package/dist/manifest.v3.d.ts

@@ -0,0 +1,5 @@
+import { ManifestV3 } from '@kb-labs/plugin-contracts';
+
+declare const manifest: ManifestV3;
+
+export { manifest as default, manifest };

package/dist/manifest.v3.js

@@ -0,0 +1,92 @@
+import { defineCommandFlags } from '@kb-labs/sdk';
+
+// src/manifest.v3.ts
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/infra-worker",
+  version: "0.1.0",
+  display: {
+    name: "Infra Worker",
+    description: "Provision infra capabilities and return stable IDs for orchestrators.",
+    tags: ["infra", "workspace", "environment", "snapshot"]
+  },
+  permissions: {
+    platform: {
+      environment: {
+        create: true,
+        read: true,
+        destroy: true,
+        renewLease: true,
+        templates: ["*"]
+      },
+      workspace: {
+        materialize: true,
+        attach: true,
+        release: true,
+        read: true,
+        sources: ["*"],
+        paths: ["*"]
+      },
+      snapshot: {
+        capture: true,
+        restore: true,
+        delete: true,
+        read: true,
+        garbageCollect: true,
+        namespaces: ["*"]
+      }
+    }
+  },
+  cli: {
+    commands: [
+      {
+        id: "infra-worker:prepare",
+        group: "infra-worker",
+        describe: "Materialize workspace, optional environment, and optional snapshot.",
+        handler: "./cli/commands/prepare-infra.js#default",
+        handlerPath: "./cli/commands/prepare-infra.js",
+        flags: defineCommandFlags({
+          sourceRef: { type: "string", description: "Workspace source reference (repo/branch/etc)" },
+          basePath: { type: "string", description: "Workspace base path" },
+          createEnvironment: { type: "boolean", default: false, description: "Provision environment after workspace materialize" },
+          templateId: { type: "string", description: "Environment template ID" },
+          ttlMs: { type: "number", description: "Environment lease TTL in milliseconds" },
+          captureSnapshot: { type: "boolean", default: false, description: "Capture snapshot after prepare" },
+          namespace: { type: "string", description: "Snapshot namespace" }
+        })
+      },
+      {
+        id: "infra-worker:capture-snapshot",
+        group: "infra-worker",
+        describe: "Capture snapshot for workspace/environment.",
+        handler: "./cli/commands/capture-snapshot.js#default",
+        handlerPath: "./cli/commands/capture-snapshot.js",
+        flags: defineCommandFlags({
+          workspaceId: { type: "string", description: "Workspace ID" },
+          environmentId: { type: "string", description: "Environment ID" },
+          namespace: { type: "string", description: "Snapshot namespace" },
+          sourcePath: { type: "string", description: "Source path for snapshot" }
+        })
+      },
+      {
+        id: "infra-worker:restore-snapshot",
+        group: "infra-worker",
+        describe: "Restore snapshot to workspace/environment target.",
+        handler: "./cli/commands/restore-snapshot.js#default",
+        handlerPath: "./cli/commands/restore-snapshot.js",
+        flags: defineCommandFlags({
+          snapshotId: { type: "string", required: true, description: "Snapshot ID to restore" },
+          workspaceId: { type: "string", description: "Workspace ID target" },
+          environmentId: { type: "string", description: "Environment ID target" },
+          targetPath: { type: "string", description: "Restore target path" },
+          overwrite: { type: "boolean", default: false, description: "Overwrite existing files" }
+        })
+      }
+    ]
+  }
+};
+var manifest_v3_default = manifest;
+
+export { manifest_v3_default as default, manifest };
+//# sourceMappingURL=manifest.v3.js.map
+//# sourceMappingURL=manifest.v3.js.map

package/dist/manifest.v3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.v3.ts"],"names":[],"mappings":"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","file":"manifest.v3.js","sourcesContent":["import type { ManifestV3 } from '@kb-labs/plugin-contracts';\nimport { defineCommandFlags } from '@kb-labs/sdk';\n\nexport const manifest: ManifestV3 = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/infra-worker',\n  version: '0.1.0',\n  display: {\n    name: 'Infra Worker',\n    description: 'Provision infra capabilities and return stable IDs for orchestrators.',\n    tags: ['infra', 'workspace', 'environment', 'snapshot'],\n  },\n  permissions: {\n    platform: {\n      environment: {\n        create: true,\n        read: true,\n        destroy: true,\n        renewLease: true,\n        templates: ['*'],\n      },\n      workspace: {\n        materialize: true,\n        attach: true,\n        release: true,\n        read: true,\n        sources: ['*'],\n        paths: ['*'],\n      },\n      snapshot: {\n        capture: true,\n        restore: true,\n        delete: true,\n        read: true,\n        garbageCollect: true,\n        namespaces: ['*'],\n      },\n    },\n  },\n  cli: {\n    commands: [\n      {\n        id: 'infra-worker:prepare',\n        group: 'infra-worker',\n        describe: 'Materialize workspace, optional environment, and optional snapshot.',\n        handler: './cli/commands/prepare-infra.js#default',\n        handlerPath: './cli/commands/prepare-infra.js',\n        flags: defineCommandFlags({\n          sourceRef: { type: 'string', description: 'Workspace source reference (repo/branch/etc)' },\n          basePath: { type: 'string', description: 'Workspace base path' },\n          createEnvironment: { type: 'boolean', default: false, description: 'Provision environment after workspace materialize' },\n          templateId: { type: 'string', description: 'Environment template ID' },\n          ttlMs: { type: 'number', description: 'Environment lease TTL in milliseconds' },\n          captureSnapshot: { type: 'boolean', default: false, description: 'Capture snapshot after prepare' },\n          namespace: { type: 'string', description: 'Snapshot namespace' },\n        }),\n      },\n      {\n        id: 'infra-worker:capture-snapshot',\n        group: 'infra-worker',\n        describe: 'Capture snapshot for workspace/environment.',\n        handler: './cli/commands/capture-snapshot.js#default',\n        handlerPath: './cli/commands/capture-snapshot.js',\n        flags: defineCommandFlags({\n          workspaceId: { type: 'string', description: 'Workspace ID' },\n          environmentId: { type: 'string', description: 'Environment ID' },\n          namespace: { type: 'string', description: 'Snapshot namespace' },\n          sourcePath: { type: 'string', description: 'Source path for snapshot' },\n        }),\n      },\n      {\n        id: 'infra-worker:restore-snapshot',\n        group: 'infra-worker',\n        describe: 'Restore snapshot to workspace/environment target.',\n        handler: './cli/commands/restore-snapshot.js#default',\n        handlerPath: './cli/commands/restore-snapshot.js',\n        flags: defineCommandFlags({\n          snapshotId: { type: 'string', required: true, description: 'Snapshot ID to restore' },\n          workspaceId: { type: 'string', description: 'Workspace ID target' },\n          environmentId: { type: 'string', description: 'Environment ID target' },\n          targetPath: { type: 'string', description: 'Restore target path' },\n          overwrite: { type: 'boolean', default: false, description: 'Overwrite existing files' },\n        }),\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@kb-labs/infra-worker-core",
+  "version": "0.5.0",
+  "type": "module",
+  "description": "Infra worker plugin core for workspace/environment/snapshot lifecycle operations.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin-manifest": {
+      "import": "./dist/manifest.v3.js",
+      "types": "./dist/manifest.v3.d.ts"
+    },
+    "./cli": "./dist/cli/index.js",
+    "./dist/*": "./dist/*"
+  },
+  "kb": {
+    "manifest": "./dist/manifest.v3.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "pretype-check": "pnpm --filter @kb-labs/infra-worker-core build",
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@kb-labs/plugin-contracts": "^1.4.0",
+    "@kb-labs/infra-worker-contracts": "^0.5.0",
+    "@kb-labs/sdk": "^1.5.0",
+    "react": "^18.3.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@kb-labs/plugin-runtime": "link:../../../../infra/kb-labs-plugin/packages/plugin-runtime",
+    "@types/node": "^24.3.3",
+    "@types/react": "^18.3.8",
+    "@types/react-dom": "^18.3.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}