@xyo-network/dapp-kit-cli 0.1.2

package/README.md

@@ -0,0 +1,29 @@
+# `@xyo-network/dapp-kit-cli`
+
+Thin command-line adapter for `xl1.dapp.json` projects.
+
+The `xl1-dapp` binary implements `init`, `validate`, `inspect`, `build`, `plan`,
+`dev`, and `test`. Parsing, rendering, and exit-code mapping live here; repository
+loading, artifact admission, planning, resource ownership, and host lifecycle
+remain in the importable Node/local packages. The CLI has no actor supervisor,
+provider locator, XL1 gateway, daemon manager, or site server of its own.
+
+`init` calls the importable Node repository operation that atomically adds the
+exact `.xl1/` rule to `.gitignore`. It is idempotent and does not create or alter
+the project manifest.
+
+`inspect` renders credential-free definition and deployment projections. With
+`--deployment`, it selects one declared deployment and reports its actors,
+hosts, port/identity/store bindings, semantic resource requests, policies,
+verification classes, explicit absence guarantees, and inputs still awaiting
+artifact build or environment resolution.
+
+`plan`, `dev`, and `test` use the closed, versioned local environment catalog by
+default. `--catalog` selects an explicit repository-relative override for
+embedding and conformance work. `dev` and `test` default to the importable lifecycle
+owner from `@xyo-network/dapp-kit-local`; callers may still inject the same
+narrow service interface for embedding and deterministic tests. `dev` maps
+SIGINT/SIGTERM into owned reverse teardown. `test` binds the same signal policy,
+launches the same system, runs every manifest-declared verification with its
+explicit evidence label, and always stops. `--retain-on-failure` preserves
+isolated failed test state.

package/dist/node/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/node/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":""}

package/dist/node/bin.mjs

@@ -0,0 +1,417 @@
+#!/usr/bin/env node
+
+// src/dappCli.ts
+import PATH2 from "node:path";
+import {
+  canonicalizeIJson as canonicalizeIJson2,
+  DappEnvironmentCatalogZod
+} from "@xyo-network/dapp-kit";
+import {
+  buildLocalDappProjectArtifacts,
+  createDefaultLocalEnvironmentCatalog,
+  planLocalDappProject
+} from "@xyo-network/dapp-kit-local";
+import {
+  initializeDappProject,
+  loadDappProject,
+  readStrictJsonFile,
+  resolveRepositoryPath
+} from "@xyo-network/dapp-kit-node";
+
+// src/defaultDappCliLifecycle.ts
+import PATH from "node:path";
+import { canonicalizeIJson } from "@xyo-network/dapp-kit";
+import {
+  runLocalDappVerifications,
+  startDefaultLocalDappRun
+} from "@xyo-network/dapp-kit-local";
+function renderEvent(io, componentId, value) {
+  io.stderr(`[${componentId}] ${canonicalizeIJson(value)}
+`);
+}
+function signalOwnedRun(run) {
+  const stop = () => {
+    void run.stop().catch(() => null);
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+  return () => {
+    process.off("SIGINT", stop);
+    process.off("SIGTERM", stop);
+  };
+}
+function renderReady(io, run, endpoints) {
+  renderEvent(io, "runner", {
+    code: "cli.run-ready",
+    endpoints,
+    runId: run.runId,
+    stateRoot: run.stateRoot
+  });
+}
+async function runDev(project, options) {
+  const run = await startDefaultLocalDappRun({
+    mode: "dev",
+    onForegroundLog: (entry) => renderEvent(options.io, entry.componentId, entry),
+    planned: project
+  });
+  const unbindSignals = signalOwnedRun(run);
+  try {
+    try {
+      const ready = await run.whenReady;
+      renderReady(options.io, run, ready.endpoints);
+    } catch {
+    }
+    return await run.whenTerminal;
+  } finally {
+    unbindSignals();
+  }
+}
+async function stopAfterTest(run, isVerificationFailed, retainOnFailure) {
+  if (isVerificationFailed && retainOnFailure) run.retainState();
+  const terminal = await run.stop();
+  return terminal.outcome === "failed" || isVerificationFailed ? { outcome: "failed" } : { outcome: "stopped" };
+}
+async function runTest(project, options) {
+  const run = await startDefaultLocalDappRun({
+    mode: "test",
+    onForegroundLog: (entry) => renderEvent(options.io, entry.componentId, entry),
+    planned: project,
+    retainOnFailure: options.retainOnFailure
+  });
+  const abort = new AbortController();
+  const unbindSignals = signalOwnedRun(run);
+  void run.whenTerminal.then(() => abort.abort());
+  try {
+    const ready = await run.whenReady;
+    renderReady(options.io, run, ready.endpoints);
+    const summary = await runLocalDappVerifications({
+      contextRoot: PATH.join(run.stateRoot, "verification"),
+      deploymentName: project.lock.deployment.name,
+      endpoints: ready.endpoints,
+      lockId: project.lock.lockId,
+      onOutput: (output) => run.logVerificationOutput(output),
+      planId: project.lock.plan.planId,
+      project: project.project,
+      signal: abort.signal
+    });
+    for (const result of summary.results) renderEvent(options.io, `verification-${result.id}`, result);
+    return await stopAfterTest(run, summary.outcome === "failed", options.retainOnFailure);
+  } catch (error) {
+    renderEvent(options.io, "runner", {
+      code: "cli.test-failed",
+      causeCode: error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "unknown"
+    });
+    if (options.retainOnFailure) run.retainState();
+    const terminal = await run.stop();
+    return terminal.outcome === "failed" ? terminal : { outcome: "failed" };
+  } finally {
+    unbindSignals();
+  }
+}
+function createDefaultDappCliLifecycleServices(options) {
+  return {
+    dev: async (project) => await runDev(project, options),
+    test: async (project) => await runTest(project, options)
+  };
+}
+
+// src/dappCli.ts
+var DappCliExitCode = {
+  success: 0,
+  dataError: 1,
+  usageError: 2,
+  runtimeError: 3
+};
+var DappCliIssueCode = {
+  commandUnknown: "cli.command-unknown",
+  deploymentRequired: "cli.deployment-required",
+  deploymentUnknown: "cli.deployment-unknown",
+  lifecycleUnavailable: "cli.lifecycle-unavailable",
+  optionInvalid: "cli.option-invalid"
+};
+var DappCliError = class extends Error {
+  code;
+  exitCode;
+  constructor(code, message, exitCode = DappCliExitCode.usageError) {
+    super(message);
+    this.name = "DappCliError";
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+var Commands = /* @__PURE__ */ new Set(["build", "dev", "init", "inspect", "plan", "test", "validate"]);
+var ValueOptions = /* @__PURE__ */ new Set(["--catalog", "--deployment", "--manifest", "--repository"]);
+var Help = `Usage: xl1-dapp <command> [options]
+
+Commands:
+  init                     Add or verify .xl1/ repository ignore policy
+  validate                 Validate xl1.dapp.json and repository identity
+  inspect                  Render the normalized project/deployment shape
+  build                    Build and admit declared artifacts
+  plan                     Create a reproducible deployment lock
+  dev                      Run a planned deployment in the foreground
+  test                     Run a planned deployment and its verification suite
+
+Options:
+  --repository <path>      Repository root (default: current directory)
+  --manifest <path>        Repository-relative manifest (default: xl1.dapp.json)
+  --deployment <name>      Deployment for plan/dev/test
+  --catalog <path>         Repository-relative environment catalog override
+  --json                   Emit canonical JSON
+  --retain-on-failure      Keep isolated test state after failure
+  --help                   Show this help
+`;
+function defaultIo() {
+  return {
+    stderr: (output) => process.stderr.write(output),
+    stdout: (output) => process.stdout.write(output)
+  };
+}
+function optionValue(arguments_, index, option) {
+  const value = arguments_[index + 1];
+  if (value === void 0 || value.startsWith("--")) {
+    throw new DappCliError(DappCliIssueCode.optionInvalid, `${option} requires one value`);
+  }
+  return value;
+}
+function isCommand(value) {
+  return typeof value === "string" && Commands.has(value);
+}
+function parseCommand(arguments_, cwd) {
+  if (arguments_.length === 0 || arguments_[0] === "--help" || arguments_[0] === "-h") return "help";
+  const command = arguments_[0];
+  if (!isCommand(command)) {
+    throw new DappCliError(DappCliIssueCode.commandUnknown, `unknown command ${command}`);
+  }
+  let catalog;
+  let deployment;
+  let isJson = false;
+  let manifest;
+  let retainOnFailure = false;
+  let repository = cwd;
+  for (let index = 1; index < arguments_.length; index += 1) {
+    const option = arguments_[index];
+    if (option === "--json") {
+      isJson = true;
+      continue;
+    }
+    if (option === "--retain-on-failure") {
+      retainOnFailure = true;
+      continue;
+    }
+    if (option === void 0 || !ValueOptions.has(option)) {
+      throw new DappCliError(DappCliIssueCode.optionInvalid, `unknown option ${String(option)}`);
+    }
+    const value = optionValue(arguments_, index, option);
+    index += 1;
+    switch (option) {
+      case "--catalog":
+        catalog = value;
+        break;
+      case "--deployment":
+        deployment = value;
+        break;
+      case "--manifest":
+        manifest = value;
+        break;
+      case "--repository":
+        repository = PATH2.resolve(cwd, value);
+        break;
+    }
+  }
+  return {
+    ...catalog === void 0 ? {} : { catalog },
+    command,
+    ...deployment === void 0 ? {} : { deployment },
+    isJson,
+    ...manifest === void 0 ? {} : { manifest },
+    retainOnFailure,
+    repository
+  };
+}
+function print(io, value, isJson) {
+  const serialized = canonicalizeIJson2(value);
+  io.stdout(isJson ? `${serialized}
+` : `${JSON.stringify(value, void 0, 2)}
+`);
+}
+function projectSummary(project) {
+  return {
+    command: "validate",
+    projectId: project.manifest.projectId,
+    manifestPath: project.manifestPath,
+    packageManager: project.packageManager,
+    source: project.source
+  };
+}
+function deploymentSummary(manifest, deploymentName) {
+  const deployment = manifest.deployments[deploymentName];
+  if (deployment === void 0) {
+    throw new DappCliError(
+      DappCliIssueCode.deploymentUnknown,
+      `deployment ${deploymentName} is not declared`,
+      DappCliExitCode.dataError
+    );
+  }
+  const request = deployment.request;
+  const hosts = [.../* @__PURE__ */ new Set([
+    ...request.actors.map((actor) => actor.host),
+    ...request.portBindings.map((binding) => binding.host)
+  ])].sort();
+  return {
+    deploymentName,
+    network: request.network,
+    supervision: request.supervision,
+    actors: request.actors.map((actor) => ({
+      executionMode: actor.executionMode,
+      host: actor.host,
+      instanceId: actor.instanceId,
+      roleId: actor.roleId
+    })),
+    hosts,
+    portBindings: request.portBindings,
+    identityBindings: request.identityBindings,
+    auxiliaryStores: request.auxiliaryStores,
+    resources: Object.entries(request.resources).map(([resourceId, resource]) => ({
+      persistence: resource.persistence,
+      provision: resource.provision,
+      resourceClass: resource.class,
+      resourceId
+    })),
+    policies: request.policies,
+    verification: request.verification.map((verification) => ({
+      evidence: verification.evidence,
+      id: verification.id,
+      package: verification.package,
+      script: verification.script
+    })),
+    absenceGuarantees: {
+      actors: request.actors.length === 0,
+      datalake: request.policies.datalake.mode === "none",
+      externalSources: request.policies.externalInteraction.mode === "none",
+      projection: request.policies.projection.profile === "none",
+      sideChannel: request.policies.sideChannel.profile === "none"
+    },
+    unresolved: {
+      artifactBuilds: Object.keys(manifest.artifacts),
+      environmentResources: Object.keys(request.resources)
+    }
+  };
+}
+function inspectSummary(manifest, selectedDeployment) {
+  const deploymentNames = selectedDeployment === void 0 ? Object.keys(manifest.deployments) : [selectedDeployment];
+  return {
+    command: "inspect",
+    projectId: manifest.projectId,
+    definition: {
+      dappId: manifest.definition.dappId,
+      definitionVersion: manifest.definition.definitionVersion,
+      protocolVersion: manifest.definition.protocolVersion,
+      actors: manifest.definition.actors.map((actor) => actor.roleId),
+      ports: manifest.definition.ports.map((port) => port.portId),
+      durability: manifest.definition.durability
+    },
+    artifacts: Object.entries(manifest.artifacts).map(([artifactId, artifact]) => ({
+      artifactId,
+      kind: artifact.kind,
+      package: artifact.package
+    })),
+    deployments: deploymentNames.map((name) => deploymentSummary(manifest, name))
+  };
+}
+function buildSummary(built) {
+  return {
+    command: "build",
+    projectId: built.project.manifest.projectId,
+    artifacts: built.locks
+  };
+}
+async function loadCatalog(command) {
+  if (command.catalog === void 0) return createDefaultLocalEnvironmentCatalog();
+  const path = await resolveRepositoryPath(command.repository, command.catalog, { kind: "file" });
+  return DappEnvironmentCatalogZod.parse(await readStrictJsonFile(path));
+}
+async function planned(command) {
+  if (command.deployment === void 0) {
+    throw new DappCliError(DappCliIssueCode.deploymentRequired, "--deployment is required for plan, dev, and test");
+  }
+  return await planLocalDappProject({
+    catalog: await loadCatalog(command),
+    deploymentName: command.deployment,
+    ...command.manifest === void 0 ? {} : { manifestPath: command.manifest },
+    repositoryRoot: command.repository
+  });
+}
+async function execute(command, options, io) {
+  const projectOptions = {
+    ...command.manifest === void 0 ? {} : { manifestPath: command.manifest },
+    repositoryRoot: command.repository
+  };
+  if (command.command === "validate") {
+    print(io, projectSummary(await loadDappProject(projectOptions)), command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "init") {
+    print(io, { command: "init", ...await initializeDappProject(command.repository) }, command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "inspect") {
+    const project = await loadDappProject(projectOptions);
+    print(io, inspectSummary(project.manifest, command.deployment), command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "build") {
+    const built = await buildLocalDappProjectArtifacts({
+      ...projectOptions,
+      onStderr: (output) => io.stderr(output),
+      onStdout: (output) => io.stdout(output)
+    });
+    print(io, buildSummary(built), command.isJson);
+    return DappCliExitCode.success;
+  }
+  const plan = await planned(command);
+  if (command.command === "plan") {
+    print(io, { command: "plan", lock: plan.lock }, command.isJson);
+    return DappCliExitCode.success;
+  }
+  const lifecycle = options.lifecycle ?? createDefaultDappCliLifecycleServices({
+    io,
+    retainOnFailure: command.retainOnFailure
+  });
+  const result = command.command === "dev" ? await lifecycle.dev?.(plan) : await lifecycle.test?.(plan);
+  if (result === void 0) {
+    throw new DappCliError(
+      DappCliIssueCode.lifecycleUnavailable,
+      `${command.command} requires an installed local lifecycle service`,
+      DappCliExitCode.runtimeError
+    );
+  }
+  print(io, { command: command.command, outcome: result.outcome }, command.isJson);
+  return result.outcome === "stopped" ? DappCliExitCode.success : DappCliExitCode.runtimeError;
+}
+function errorCode(error) {
+  return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "cli.internal-error";
+}
+async function runDappCli(arguments_, options = {}) {
+  const io = options.io ?? defaultIo();
+  try {
+    const parsed = parseCommand(arguments_, options.cwd ?? process.cwd());
+    if (parsed === "help") {
+      io.stdout(Help);
+      return DappCliExitCode.success;
+    }
+    return await execute(parsed, options, io);
+  } catch (error) {
+    const exitCode = error instanceof DappCliError ? error.exitCode : DappCliExitCode.dataError;
+    io.stderr(`${canonicalizeIJson2({
+      code: errorCode(error),
+      message: error instanceof Error ? error.message : "unknown CLI failure"
+    })}
+`);
+    return exitCode;
+  }
+}
+
+// src/bin.ts
+process.exitCode = await runDappCli(process.argv.slice(2));
+//# sourceMappingURL=bin.mjs.map

package/dist/node/bin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/dappCli.ts", "../../src/defaultDappCliLifecycle.ts", "../../src/bin.ts"],
+  "sourcesContent": ["import PATH from 'node:path'\n\nimport type {\n  DappEnvironmentCatalog,\n  DappProjectManifest,\n} from '@xyo-network/dapp-kit'\nimport {\n  canonicalizeIJson,\n  DappEnvironmentCatalogZod,\n} from '@xyo-network/dapp-kit'\nimport type {\n  BuiltLocalDappProjectArtifacts,\n  PlannedLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport {\n  buildLocalDappProjectArtifacts,\n  createDefaultLocalEnvironmentCatalog,\n  planLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport type { LoadedDappProject } from '@xyo-network/dapp-kit-node'\nimport {\n  initializeDappProject,\n  loadDappProject,\n  readStrictJsonFile,\n  resolveRepositoryPath,\n} from '@xyo-network/dapp-kit-node'\n\nimport { createDefaultDappCliLifecycleServices } from './defaultDappCliLifecycle.ts'\n\nexport const DappCliExitCode = {\n  success: 0,\n  dataError: 1,\n  usageError: 2,\n  runtimeError: 3,\n} as const\n\nexport type DappCliExitCode = typeof DappCliExitCode[keyof typeof DappCliExitCode]\n\nexport const DappCliIssueCode = {\n  commandUnknown: 'cli.command-unknown',\n  deploymentRequired: 'cli.deployment-required',\n  deploymentUnknown: 'cli.deployment-unknown',\n  lifecycleUnavailable: 'cli.lifecycle-unavailable',\n  optionInvalid: 'cli.option-invalid',\n} as const\n\nexport type DappCliIssueCode = typeof DappCliIssueCode[keyof typeof DappCliIssueCode]\n\nexport class DappCliError extends Error {\n  readonly code: DappCliIssueCode\n  readonly exitCode: DappCliExitCode\n\n  constructor(code: DappCliIssueCode, message: string, exitCode: DappCliExitCode = DappCliExitCode.usageError) {\n    super(message)\n    this.name = 'DappCliError'\n    this.code = code\n    this.exitCode = exitCode\n  }\n}\n\nexport interface DappCliIo {\n  readonly stderr: (output: string) => void\n  readonly stdout: (output: string) => void\n}\n\nexport interface DappCliLifecycleResult {\n  readonly outcome: 'failed' | 'stopped'\n}\n\nexport interface DappCliLifecycleServices {\n  dev?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>\n  test?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>\n}\n\nexport interface RunDappCliOptions {\n  readonly cwd?: string\n  readonly io?: DappCliIo\n  readonly lifecycle?: DappCliLifecycleServices\n}\n\ninterface ParsedCommand {\n  readonly catalog?: string\n  readonly command: 'build' | 'dev' | 'init' | 'inspect' | 'plan' | 'test' | 'validate'\n  readonly deployment?: string\n  readonly isJson: boolean\n  readonly manifest?: string\n  readonly repository: string\n  readonly retainOnFailure: boolean\n}\n\ntype DappCliCommand = ParsedCommand['command']\n\nconst Commands = new Set<DappCliCommand>(['build', 'dev', 'init', 'inspect', 'plan', 'test', 'validate'])\nconst ValueOptions = new Set(['--catalog', '--deployment', '--manifest', '--repository'])\n\nconst Help = `Usage: xl1-dapp <command> [options]\n\nCommands:\n  init                     Add or verify .xl1/ repository ignore policy\n  validate                 Validate xl1.dapp.json and repository identity\n  inspect                  Render the normalized project/deployment shape\n  build                    Build and admit declared artifacts\n  plan                     Create a reproducible deployment lock\n  dev                      Run a planned deployment in the foreground\n  test                     Run a planned deployment and its verification suite\n\nOptions:\n  --repository <path>      Repository root (default: current directory)\n  --manifest <path>        Repository-relative manifest (default: xl1.dapp.json)\n  --deployment <name>      Deployment for plan/dev/test\n  --catalog <path>         Repository-relative environment catalog override\n  --json                   Emit canonical JSON\n  --retain-on-failure      Keep isolated test state after failure\n  --help                   Show this help\n`\n\nfunction defaultIo(): DappCliIo {\n  return {\n    stderr: output => process.stderr.write(output),\n    stdout: output => process.stdout.write(output),\n  }\n}\n\nfunction optionValue(arguments_: readonly string[], index: number, option: string): string {\n  const value = arguments_[index + 1]\n  if (value === undefined || value.startsWith('--')) {\n    throw new DappCliError(DappCliIssueCode.optionInvalid, `${option} requires one value`)\n  }\n  return value\n}\n\nfunction isCommand(value: unknown): value is DappCliCommand {\n  return typeof value === 'string' && Commands.has(value as DappCliCommand)\n}\n\nfunction parseCommand(arguments_: readonly string[], cwd: string): ParsedCommand | 'help' {\n  if (arguments_.length === 0 || arguments_[0] === '--help' || arguments_[0] === '-h') return 'help'\n  const command = arguments_[0]\n  if (!isCommand(command)) {\n    throw new DappCliError(DappCliIssueCode.commandUnknown, `unknown command ${command}`)\n  }\n  let catalog: string | undefined\n  let deployment: string | undefined\n  let isJson = false\n  let manifest: string | undefined\n  let retainOnFailure = false\n  let repository = cwd\n  for (let index = 1; index < arguments_.length; index += 1) {\n    const option = arguments_[index]\n    if (option === '--json') {\n      isJson = true\n      continue\n    }\n    if (option === '--retain-on-failure') {\n      retainOnFailure = true\n      continue\n    }\n    if (option === undefined || !ValueOptions.has(option)) {\n      throw new DappCliError(DappCliIssueCode.optionInvalid, `unknown option ${String(option)}`)\n    }\n    const value = optionValue(arguments_, index, option)\n    index += 1\n    switch (option) {\n      case '--catalog':\n        catalog = value\n        break\n      case '--deployment':\n        deployment = value\n        break\n      case '--manifest':\n        manifest = value\n        break\n      case '--repository':\n        repository = PATH.resolve(cwd, value)\n        break\n    }\n  }\n  return {\n    ...(catalog === undefined ? {} : { catalog }),\n    command,\n    ...(deployment === undefined ? {} : { deployment }),\n    isJson,\n    ...(manifest === undefined ? {} : { manifest }),\n    retainOnFailure,\n    repository,\n  }\n}\n\nfunction print(io: DappCliIo, value: unknown, isJson: boolean): void {\n  const serialized = canonicalizeIJson(value)\n  io.stdout(isJson ? `${serialized}\\n` : `${JSON.stringify(value, undefined, 2)}\\n`)\n}\n\nfunction projectSummary(project: LoadedDappProject) {\n  return {\n    command: 'validate',\n    projectId: project.manifest.projectId,\n    manifestPath: project.manifestPath,\n    packageManager: project.packageManager,\n    source: project.source,\n  }\n}\n\nfunction deploymentSummary(\n  manifest: DappProjectManifest,\n  deploymentName: string,\n) {\n  const deployment = manifest.deployments[deploymentName]\n  if (deployment === undefined) {\n    throw new DappCliError(\n      DappCliIssueCode.deploymentUnknown,\n      `deployment ${deploymentName} is not declared`,\n      DappCliExitCode.dataError,\n    )\n  }\n  const request = deployment.request\n  const hosts = [...new Set([\n    ...request.actors.map(actor => actor.host),\n    ...request.portBindings.map(binding => binding.host),\n  ])].sort()\n  return {\n    deploymentName,\n    network: request.network,\n    supervision: request.supervision,\n    actors: request.actors.map(actor => ({\n      executionMode: actor.executionMode,\n      host: actor.host,\n      instanceId: actor.instanceId,\n      roleId: actor.roleId,\n    })),\n    hosts,\n    portBindings: request.portBindings,\n    identityBindings: request.identityBindings,\n    auxiliaryStores: request.auxiliaryStores,\n    resources: Object.entries(request.resources).map(([resourceId, resource]) => ({\n      persistence: resource.persistence,\n      provision: resource.provision,\n      resourceClass: resource.class,\n      resourceId,\n    })),\n    policies: request.policies,\n    verification: request.verification.map(verification => ({\n      evidence: verification.evidence,\n      id: verification.id,\n      package: verification.package,\n      script: verification.script,\n    })),\n    absenceGuarantees: {\n      actors: request.actors.length === 0,\n      datalake: request.policies.datalake.mode === 'none',\n      externalSources: request.policies.externalInteraction.mode === 'none',\n      projection: request.policies.projection.profile === 'none',\n      sideChannel: request.policies.sideChannel.profile === 'none',\n    },\n    unresolved: {\n      artifactBuilds: Object.keys(manifest.artifacts),\n      environmentResources: Object.keys(request.resources),\n    },\n  }\n}\n\nfunction inspectSummary(manifest: DappProjectManifest, selectedDeployment?: string) {\n  const deploymentNames = selectedDeployment === undefined\n    ? Object.keys(manifest.deployments)\n    : [selectedDeployment]\n  return {\n    command: 'inspect',\n    projectId: manifest.projectId,\n    definition: {\n      dappId: manifest.definition.dappId,\n      definitionVersion: manifest.definition.definitionVersion,\n      protocolVersion: manifest.definition.protocolVersion,\n      actors: manifest.definition.actors.map(actor => actor.roleId),\n      ports: manifest.definition.ports.map(port => port.portId),\n      durability: manifest.definition.durability,\n    },\n    artifacts: Object.entries(manifest.artifacts).map(([artifactId, artifact]) => ({\n      artifactId, kind: artifact.kind, package: artifact.package,\n    })),\n    deployments: deploymentNames.map(name => deploymentSummary(manifest, name)),\n  }\n}\n\nfunction buildSummary(built: BuiltLocalDappProjectArtifacts) {\n  return {\n    command: 'build',\n    projectId: built.project.manifest.projectId,\n    artifacts: built.locks,\n  }\n}\n\nasync function loadCatalog(command: ParsedCommand): Promise<DappEnvironmentCatalog> {\n  if (command.catalog === undefined) return createDefaultLocalEnvironmentCatalog()\n  const path = await resolveRepositoryPath(command.repository, command.catalog, { kind: 'file' })\n  return DappEnvironmentCatalogZod.parse(await readStrictJsonFile(path))\n}\n\nasync function planned(command: ParsedCommand): Promise<PlannedLocalDappProject> {\n  if (command.deployment === undefined) {\n    throw new DappCliError(DappCliIssueCode.deploymentRequired, '--deployment is required for plan, dev, and test')\n  }\n  return await planLocalDappProject({\n    catalog: await loadCatalog(command),\n    deploymentName: command.deployment,\n    ...(command.manifest === undefined ? {} : { manifestPath: command.manifest }),\n    repositoryRoot: command.repository,\n  })\n}\n\nasync function execute(\n  command: ParsedCommand,\n  options: RunDappCliOptions,\n  io: DappCliIo,\n): Promise<DappCliExitCode> {\n  const projectOptions = {\n    ...(command.manifest === undefined ? {} : { manifestPath: command.manifest }),\n    repositoryRoot: command.repository,\n  }\n  if (command.command === 'validate') {\n    print(io, projectSummary(await loadDappProject(projectOptions)), command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'init') {\n    print(io, { command: 'init', ...await initializeDappProject(command.repository) }, command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'inspect') {\n    const project = await loadDappProject(projectOptions)\n    print(io, inspectSummary(project.manifest, command.deployment), command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'build') {\n    const built = await buildLocalDappProjectArtifacts({\n      ...projectOptions,\n      onStderr: output => io.stderr(output),\n      onStdout: output => io.stdout(output),\n    })\n    print(io, buildSummary(built), command.isJson)\n    return DappCliExitCode.success\n  }\n  const plan = await planned(command)\n  if (command.command === 'plan') {\n    print(io, { command: 'plan', lock: plan.lock }, command.isJson)\n    return DappCliExitCode.success\n  }\n  const lifecycle = options.lifecycle ?? createDefaultDappCliLifecycleServices({\n    io,\n    retainOnFailure: command.retainOnFailure,\n  })\n  const result = command.command === 'dev'\n    ? await lifecycle.dev?.(plan)\n    : await lifecycle.test?.(plan)\n  if (result === undefined) {\n    throw new DappCliError(\n      DappCliIssueCode.lifecycleUnavailable,\n      `${command.command} requires an installed local lifecycle service`,\n      DappCliExitCode.runtimeError,\n    )\n  }\n  print(io, { command: command.command, outcome: result.outcome }, command.isJson)\n  return result.outcome === 'stopped' ? DappCliExitCode.success : DappCliExitCode.runtimeError\n}\n\nfunction errorCode(error: unknown): string {\n  return error instanceof Error && 'code' in error && typeof error.code === 'string'\n    ? error.code\n    : 'cli.internal-error'\n}\n\nexport async function runDappCli(\n  arguments_: readonly string[],\n  options: RunDappCliOptions = {},\n): Promise<DappCliExitCode> {\n  const io = options.io ?? defaultIo()\n  try {\n    const parsed = parseCommand(arguments_, options.cwd ?? process.cwd())\n    if (parsed === 'help') {\n      io.stdout(Help)\n      return DappCliExitCode.success\n    }\n    return await execute(parsed, options, io)\n  } catch (error) {\n    const exitCode = error instanceof DappCliError ? error.exitCode : DappCliExitCode.dataError\n    io.stderr(`${canonicalizeIJson({\n      code: errorCode(error),\n      message: error instanceof Error ? error.message : 'unknown CLI failure',\n    })}\\n`)\n    return exitCode\n  }\n}\n", "import PATH from 'node:path'\n\nimport { canonicalizeIJson } from '@xyo-network/dapp-kit'\nimport type {\n  DefaultLocalDappRun,\n  PlannedLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport {\n  runLocalDappVerifications,\n  startDefaultLocalDappRun,\n} from '@xyo-network/dapp-kit-local'\n\nimport type {\n  DappCliIo,\n  DappCliLifecycleResult,\n  DappCliLifecycleServices,\n} from './dappCli.ts'\n\nexport interface CreateDefaultDappCliLifecycleOptions {\n  readonly io: DappCliIo\n  readonly retainOnFailure: boolean\n}\n\nfunction renderEvent(io: DappCliIo, componentId: string, value: unknown): void {\n  io.stderr(`[${componentId}] ${canonicalizeIJson(value)}\\n`)\n}\n\nfunction signalOwnedRun(run: DefaultLocalDappRun): () => void {\n  const stop = (): void => {\n    void run.stop().catch(() => null)\n  }\n  process.once('SIGINT', stop)\n  process.once('SIGTERM', stop)\n  return () => {\n    process.off('SIGINT', stop)\n    process.off('SIGTERM', stop)\n  }\n}\n\nfunction renderReady(io: DappCliIo, run: DefaultLocalDappRun, endpoints: readonly unknown[]): void {\n  renderEvent(io, 'runner', {\n    code: 'cli.run-ready',\n    endpoints,\n    runId: run.runId,\n    stateRoot: run.stateRoot,\n  })\n}\n\nasync function runDev(\n  project: PlannedLocalDappProject,\n  options: CreateDefaultDappCliLifecycleOptions,\n): Promise<DappCliLifecycleResult> {\n  const run = await startDefaultLocalDappRun({\n    mode: 'dev',\n    onForegroundLog: entry => renderEvent(options.io, entry.componentId, entry),\n    planned: project,\n  })\n  const unbindSignals = signalOwnedRun(run)\n  try {\n    try {\n      const ready = await run.whenReady\n      renderReady(options.io, run, ready.endpoints)\n    } catch {\n      // The terminal result below retains the stable startup failure.\n    }\n    return await run.whenTerminal\n  } finally {\n    unbindSignals()\n  }\n}\n\nasync function stopAfterTest(\n  run: DefaultLocalDappRun,\n  isVerificationFailed: boolean,\n  retainOnFailure: boolean,\n): Promise<DappCliLifecycleResult> {\n  if (isVerificationFailed && retainOnFailure) run.retainState()\n  const terminal = await run.stop()\n  return terminal.outcome === 'failed' || isVerificationFailed\n    ? { outcome: 'failed' }\n    : { outcome: 'stopped' }\n}\n\nasync function runTest(\n  project: PlannedLocalDappProject,\n  options: CreateDefaultDappCliLifecycleOptions,\n): Promise<DappCliLifecycleResult> {\n  const run = await startDefaultLocalDappRun({\n    mode: 'test',\n    onForegroundLog: entry => renderEvent(options.io, entry.componentId, entry),\n    planned: project,\n    retainOnFailure: options.retainOnFailure,\n  })\n  const abort = new AbortController()\n  const unbindSignals = signalOwnedRun(run)\n  void run.whenTerminal.then(() => abort.abort())\n  try {\n    const ready = await run.whenReady\n    renderReady(options.io, run, ready.endpoints)\n    const summary = await runLocalDappVerifications({\n      contextRoot: PATH.join(run.stateRoot, 'verification'),\n      deploymentName: project.lock.deployment.name,\n      endpoints: ready.endpoints,\n      lockId: project.lock.lockId,\n      onOutput: output => run.logVerificationOutput(output),\n      planId: project.lock.plan.planId,\n      project: project.project,\n      signal: abort.signal,\n    })\n    for (const result of summary.results) renderEvent(options.io, `verification-${result.id}`, result)\n    return await stopAfterTest(run, summary.outcome === 'failed', options.retainOnFailure)\n  } catch (error) {\n    renderEvent(options.io, 'runner', {\n      code: 'cli.test-failed',\n      causeCode: error instanceof Error && 'code' in error && typeof error.code === 'string'\n        ? error.code\n        : 'unknown',\n    })\n    if (options.retainOnFailure) run.retainState()\n    const terminal = await run.stop()\n    return terminal.outcome === 'failed' ? terminal : { outcome: 'failed' }\n  } finally {\n    unbindSignals()\n  }\n}\n\nexport function createDefaultDappCliLifecycleServices(\n  options: CreateDefaultDappCliLifecycleOptions,\n): DappCliLifecycleServices {\n  return {\n    dev: async project => await runDev(project, options),\n    test: async project => await runTest(project, options),\n  }\n}\n", "#!/usr/bin/env node\n\nimport { runDappCli } from './dappCli.ts'\n\nprocess.exitCode = await runDappCli(process.argv.slice(2))\n"],
+  "mappings": "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",
+  "names": ["PATH", "canonicalizeIJson", "PATH", "canonicalizeIJson"]
+}

package/dist/node/dappCli.d.ts

@@ -0,0 +1,39 @@
+import type { PlannedLocalDappProject } from '@xyo-network/dapp-kit-local';
+export declare const DappCliExitCode: {
+    readonly success: 0;
+    readonly dataError: 1;
+    readonly usageError: 2;
+    readonly runtimeError: 3;
+};
+export type DappCliExitCode = typeof DappCliExitCode[keyof typeof DappCliExitCode];
+export declare const DappCliIssueCode: {
+    readonly commandUnknown: "cli.command-unknown";
+    readonly deploymentRequired: "cli.deployment-required";
+    readonly deploymentUnknown: "cli.deployment-unknown";
+    readonly lifecycleUnavailable: "cli.lifecycle-unavailable";
+    readonly optionInvalid: "cli.option-invalid";
+};
+export type DappCliIssueCode = typeof DappCliIssueCode[keyof typeof DappCliIssueCode];
+export declare class DappCliError extends Error {
+    readonly code: DappCliIssueCode;
+    readonly exitCode: DappCliExitCode;
+    constructor(code: DappCliIssueCode, message: string, exitCode?: DappCliExitCode);
+}
+export interface DappCliIo {
+    readonly stderr: (output: string) => void;
+    readonly stdout: (output: string) => void;
+}
+export interface DappCliLifecycleResult {
+    readonly outcome: 'failed' | 'stopped';
+}
+export interface DappCliLifecycleServices {
+    dev?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>;
+    test?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>;
+}
+export interface RunDappCliOptions {
+    readonly cwd?: string;
+    readonly io?: DappCliIo;
+    readonly lifecycle?: DappCliLifecycleServices;
+}
+export declare function runDappCli(arguments_: readonly string[], options?: RunDappCliOptions): Promise<DappCliExitCode>;
+//# sourceMappingURL=dappCli.d.ts.map

package/dist/node/dappCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dappCli.d.ts","sourceRoot":"","sources":["../../src/dappCli.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,6BAA6B,CAAA;AAgBpC,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAElF,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA;AAErF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;gBAEtB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,eAA4C;CAM5G;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACvE,IAAI,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACzE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAA;CAC9C;AAmSD,wBAAsB,UAAU,CAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAiB1B"}

package/dist/node/defaultDappCliLifecycle.d.ts

@@ -0,0 +1,7 @@
+import type { DappCliIo, DappCliLifecycleServices } from './dappCli.ts';
+export interface CreateDefaultDappCliLifecycleOptions {
+    readonly io: DappCliIo;
+    readonly retainOnFailure: boolean;
+}
+export declare function createDefaultDappCliLifecycleServices(options: CreateDefaultDappCliLifecycleOptions): DappCliLifecycleServices;
+//# sourceMappingURL=defaultDappCliLifecycle.d.ts.map

package/dist/node/defaultDappCliLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultDappCliLifecycle.d.ts","sourceRoot":"","sources":["../../src/defaultDappCliLifecycle.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,SAAS,EAET,wBAAwB,EACzB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;IACtB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAyGD,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,oCAAoC,GAC5C,wBAAwB,CAK1B"}

package/dist/node/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dappCli.ts';
+export * from './defaultDappCliLifecycle.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,8BAA8B,CAAA"}

package/dist/node/index.mjs

@@ -0,0 +1,419 @@
+// src/dappCli.ts
+import PATH2 from "node:path";
+import {
+  canonicalizeIJson as canonicalizeIJson2,
+  DappEnvironmentCatalogZod
+} from "@xyo-network/dapp-kit";
+import {
+  buildLocalDappProjectArtifacts,
+  createDefaultLocalEnvironmentCatalog,
+  planLocalDappProject
+} from "@xyo-network/dapp-kit-local";
+import {
+  initializeDappProject,
+  loadDappProject,
+  readStrictJsonFile,
+  resolveRepositoryPath
+} from "@xyo-network/dapp-kit-node";
+
+// src/defaultDappCliLifecycle.ts
+import PATH from "node:path";
+import { canonicalizeIJson } from "@xyo-network/dapp-kit";
+import {
+  runLocalDappVerifications,
+  startDefaultLocalDappRun
+} from "@xyo-network/dapp-kit-local";
+function renderEvent(io, componentId, value) {
+  io.stderr(`[${componentId}] ${canonicalizeIJson(value)}
+`);
+}
+function signalOwnedRun(run) {
+  const stop = () => {
+    void run.stop().catch(() => null);
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+  return () => {
+    process.off("SIGINT", stop);
+    process.off("SIGTERM", stop);
+  };
+}
+function renderReady(io, run, endpoints) {
+  renderEvent(io, "runner", {
+    code: "cli.run-ready",
+    endpoints,
+    runId: run.runId,
+    stateRoot: run.stateRoot
+  });
+}
+async function runDev(project, options) {
+  const run = await startDefaultLocalDappRun({
+    mode: "dev",
+    onForegroundLog: (entry) => renderEvent(options.io, entry.componentId, entry),
+    planned: project
+  });
+  const unbindSignals = signalOwnedRun(run);
+  try {
+    try {
+      const ready = await run.whenReady;
+      renderReady(options.io, run, ready.endpoints);
+    } catch {
+    }
+    return await run.whenTerminal;
+  } finally {
+    unbindSignals();
+  }
+}
+async function stopAfterTest(run, isVerificationFailed, retainOnFailure) {
+  if (isVerificationFailed && retainOnFailure) run.retainState();
+  const terminal = await run.stop();
+  return terminal.outcome === "failed" || isVerificationFailed ? { outcome: "failed" } : { outcome: "stopped" };
+}
+async function runTest(project, options) {
+  const run = await startDefaultLocalDappRun({
+    mode: "test",
+    onForegroundLog: (entry) => renderEvent(options.io, entry.componentId, entry),
+    planned: project,
+    retainOnFailure: options.retainOnFailure
+  });
+  const abort = new AbortController();
+  const unbindSignals = signalOwnedRun(run);
+  void run.whenTerminal.then(() => abort.abort());
+  try {
+    const ready = await run.whenReady;
+    renderReady(options.io, run, ready.endpoints);
+    const summary = await runLocalDappVerifications({
+      contextRoot: PATH.join(run.stateRoot, "verification"),
+      deploymentName: project.lock.deployment.name,
+      endpoints: ready.endpoints,
+      lockId: project.lock.lockId,
+      onOutput: (output) => run.logVerificationOutput(output),
+      planId: project.lock.plan.planId,
+      project: project.project,
+      signal: abort.signal
+    });
+    for (const result of summary.results) renderEvent(options.io, `verification-${result.id}`, result);
+    return await stopAfterTest(run, summary.outcome === "failed", options.retainOnFailure);
+  } catch (error) {
+    renderEvent(options.io, "runner", {
+      code: "cli.test-failed",
+      causeCode: error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "unknown"
+    });
+    if (options.retainOnFailure) run.retainState();
+    const terminal = await run.stop();
+    return terminal.outcome === "failed" ? terminal : { outcome: "failed" };
+  } finally {
+    unbindSignals();
+  }
+}
+function createDefaultDappCliLifecycleServices(options) {
+  return {
+    dev: async (project) => await runDev(project, options),
+    test: async (project) => await runTest(project, options)
+  };
+}
+
+// src/dappCli.ts
+var DappCliExitCode = {
+  success: 0,
+  dataError: 1,
+  usageError: 2,
+  runtimeError: 3
+};
+var DappCliIssueCode = {
+  commandUnknown: "cli.command-unknown",
+  deploymentRequired: "cli.deployment-required",
+  deploymentUnknown: "cli.deployment-unknown",
+  lifecycleUnavailable: "cli.lifecycle-unavailable",
+  optionInvalid: "cli.option-invalid"
+};
+var DappCliError = class extends Error {
+  code;
+  exitCode;
+  constructor(code, message, exitCode = DappCliExitCode.usageError) {
+    super(message);
+    this.name = "DappCliError";
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+var Commands = /* @__PURE__ */ new Set(["build", "dev", "init", "inspect", "plan", "test", "validate"]);
+var ValueOptions = /* @__PURE__ */ new Set(["--catalog", "--deployment", "--manifest", "--repository"]);
+var Help = `Usage: xl1-dapp <command> [options]
+
+Commands:
+  init                     Add or verify .xl1/ repository ignore policy
+  validate                 Validate xl1.dapp.json and repository identity
+  inspect                  Render the normalized project/deployment shape
+  build                    Build and admit declared artifacts
+  plan                     Create a reproducible deployment lock
+  dev                      Run a planned deployment in the foreground
+  test                     Run a planned deployment and its verification suite
+
+Options:
+  --repository <path>      Repository root (default: current directory)
+  --manifest <path>        Repository-relative manifest (default: xl1.dapp.json)
+  --deployment <name>      Deployment for plan/dev/test
+  --catalog <path>         Repository-relative environment catalog override
+  --json                   Emit canonical JSON
+  --retain-on-failure      Keep isolated test state after failure
+  --help                   Show this help
+`;
+function defaultIo() {
+  return {
+    stderr: (output) => process.stderr.write(output),
+    stdout: (output) => process.stdout.write(output)
+  };
+}
+function optionValue(arguments_, index, option) {
+  const value = arguments_[index + 1];
+  if (value === void 0 || value.startsWith("--")) {
+    throw new DappCliError(DappCliIssueCode.optionInvalid, `${option} requires one value`);
+  }
+  return value;
+}
+function isCommand(value) {
+  return typeof value === "string" && Commands.has(value);
+}
+function parseCommand(arguments_, cwd) {
+  if (arguments_.length === 0 || arguments_[0] === "--help" || arguments_[0] === "-h") return "help";
+  const command = arguments_[0];
+  if (!isCommand(command)) {
+    throw new DappCliError(DappCliIssueCode.commandUnknown, `unknown command ${command}`);
+  }
+  let catalog;
+  let deployment;
+  let isJson = false;
+  let manifest;
+  let retainOnFailure = false;
+  let repository = cwd;
+  for (let index = 1; index < arguments_.length; index += 1) {
+    const option = arguments_[index];
+    if (option === "--json") {
+      isJson = true;
+      continue;
+    }
+    if (option === "--retain-on-failure") {
+      retainOnFailure = true;
+      continue;
+    }
+    if (option === void 0 || !ValueOptions.has(option)) {
+      throw new DappCliError(DappCliIssueCode.optionInvalid, `unknown option ${String(option)}`);
+    }
+    const value = optionValue(arguments_, index, option);
+    index += 1;
+    switch (option) {
+      case "--catalog":
+        catalog = value;
+        break;
+      case "--deployment":
+        deployment = value;
+        break;
+      case "--manifest":
+        manifest = value;
+        break;
+      case "--repository":
+        repository = PATH2.resolve(cwd, value);
+        break;
+    }
+  }
+  return {
+    ...catalog === void 0 ? {} : { catalog },
+    command,
+    ...deployment === void 0 ? {} : { deployment },
+    isJson,
+    ...manifest === void 0 ? {} : { manifest },
+    retainOnFailure,
+    repository
+  };
+}
+function print(io, value, isJson) {
+  const serialized = canonicalizeIJson2(value);
+  io.stdout(isJson ? `${serialized}
+` : `${JSON.stringify(value, void 0, 2)}
+`);
+}
+function projectSummary(project) {
+  return {
+    command: "validate",
+    projectId: project.manifest.projectId,
+    manifestPath: project.manifestPath,
+    packageManager: project.packageManager,
+    source: project.source
+  };
+}
+function deploymentSummary(manifest, deploymentName) {
+  const deployment = manifest.deployments[deploymentName];
+  if (deployment === void 0) {
+    throw new DappCliError(
+      DappCliIssueCode.deploymentUnknown,
+      `deployment ${deploymentName} is not declared`,
+      DappCliExitCode.dataError
+    );
+  }
+  const request = deployment.request;
+  const hosts = [.../* @__PURE__ */ new Set([
+    ...request.actors.map((actor) => actor.host),
+    ...request.portBindings.map((binding) => binding.host)
+  ])].sort();
+  return {
+    deploymentName,
+    network: request.network,
+    supervision: request.supervision,
+    actors: request.actors.map((actor) => ({
+      executionMode: actor.executionMode,
+      host: actor.host,
+      instanceId: actor.instanceId,
+      roleId: actor.roleId
+    })),
+    hosts,
+    portBindings: request.portBindings,
+    identityBindings: request.identityBindings,
+    auxiliaryStores: request.auxiliaryStores,
+    resources: Object.entries(request.resources).map(([resourceId, resource]) => ({
+      persistence: resource.persistence,
+      provision: resource.provision,
+      resourceClass: resource.class,
+      resourceId
+    })),
+    policies: request.policies,
+    verification: request.verification.map((verification) => ({
+      evidence: verification.evidence,
+      id: verification.id,
+      package: verification.package,
+      script: verification.script
+    })),
+    absenceGuarantees: {
+      actors: request.actors.length === 0,
+      datalake: request.policies.datalake.mode === "none",
+      externalSources: request.policies.externalInteraction.mode === "none",
+      projection: request.policies.projection.profile === "none",
+      sideChannel: request.policies.sideChannel.profile === "none"
+    },
+    unresolved: {
+      artifactBuilds: Object.keys(manifest.artifacts),
+      environmentResources: Object.keys(request.resources)
+    }
+  };
+}
+function inspectSummary(manifest, selectedDeployment) {
+  const deploymentNames = selectedDeployment === void 0 ? Object.keys(manifest.deployments) : [selectedDeployment];
+  return {
+    command: "inspect",
+    projectId: manifest.projectId,
+    definition: {
+      dappId: manifest.definition.dappId,
+      definitionVersion: manifest.definition.definitionVersion,
+      protocolVersion: manifest.definition.protocolVersion,
+      actors: manifest.definition.actors.map((actor) => actor.roleId),
+      ports: manifest.definition.ports.map((port) => port.portId),
+      durability: manifest.definition.durability
+    },
+    artifacts: Object.entries(manifest.artifacts).map(([artifactId, artifact]) => ({
+      artifactId,
+      kind: artifact.kind,
+      package: artifact.package
+    })),
+    deployments: deploymentNames.map((name) => deploymentSummary(manifest, name))
+  };
+}
+function buildSummary(built) {
+  return {
+    command: "build",
+    projectId: built.project.manifest.projectId,
+    artifacts: built.locks
+  };
+}
+async function loadCatalog(command) {
+  if (command.catalog === void 0) return createDefaultLocalEnvironmentCatalog();
+  const path = await resolveRepositoryPath(command.repository, command.catalog, { kind: "file" });
+  return DappEnvironmentCatalogZod.parse(await readStrictJsonFile(path));
+}
+async function planned(command) {
+  if (command.deployment === void 0) {
+    throw new DappCliError(DappCliIssueCode.deploymentRequired, "--deployment is required for plan, dev, and test");
+  }
+  return await planLocalDappProject({
+    catalog: await loadCatalog(command),
+    deploymentName: command.deployment,
+    ...command.manifest === void 0 ? {} : { manifestPath: command.manifest },
+    repositoryRoot: command.repository
+  });
+}
+async function execute(command, options, io) {
+  const projectOptions = {
+    ...command.manifest === void 0 ? {} : { manifestPath: command.manifest },
+    repositoryRoot: command.repository
+  };
+  if (command.command === "validate") {
+    print(io, projectSummary(await loadDappProject(projectOptions)), command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "init") {
+    print(io, { command: "init", ...await initializeDappProject(command.repository) }, command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "inspect") {
+    const project = await loadDappProject(projectOptions);
+    print(io, inspectSummary(project.manifest, command.deployment), command.isJson);
+    return DappCliExitCode.success;
+  }
+  if (command.command === "build") {
+    const built = await buildLocalDappProjectArtifacts({
+      ...projectOptions,
+      onStderr: (output) => io.stderr(output),
+      onStdout: (output) => io.stdout(output)
+    });
+    print(io, buildSummary(built), command.isJson);
+    return DappCliExitCode.success;
+  }
+  const plan = await planned(command);
+  if (command.command === "plan") {
+    print(io, { command: "plan", lock: plan.lock }, command.isJson);
+    return DappCliExitCode.success;
+  }
+  const lifecycle = options.lifecycle ?? createDefaultDappCliLifecycleServices({
+    io,
+    retainOnFailure: command.retainOnFailure
+  });
+  const result = command.command === "dev" ? await lifecycle.dev?.(plan) : await lifecycle.test?.(plan);
+  if (result === void 0) {
+    throw new DappCliError(
+      DappCliIssueCode.lifecycleUnavailable,
+      `${command.command} requires an installed local lifecycle service`,
+      DappCliExitCode.runtimeError
+    );
+  }
+  print(io, { command: command.command, outcome: result.outcome }, command.isJson);
+  return result.outcome === "stopped" ? DappCliExitCode.success : DappCliExitCode.runtimeError;
+}
+function errorCode(error) {
+  return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "cli.internal-error";
+}
+async function runDappCli(arguments_, options = {}) {
+  const io = options.io ?? defaultIo();
+  try {
+    const parsed = parseCommand(arguments_, options.cwd ?? process.cwd());
+    if (parsed === "help") {
+      io.stdout(Help);
+      return DappCliExitCode.success;
+    }
+    return await execute(parsed, options, io);
+  } catch (error) {
+    const exitCode = error instanceof DappCliError ? error.exitCode : DappCliExitCode.dataError;
+    io.stderr(`${canonicalizeIJson2({
+      code: errorCode(error),
+      message: error instanceof Error ? error.message : "unknown CLI failure"
+    })}
+`);
+    return exitCode;
+  }
+}
+export {
+  DappCliError,
+  DappCliExitCode,
+  DappCliIssueCode,
+  createDefaultDappCliLifecycleServices,
+  runDappCli
+};
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/dappCli.ts", "../../src/defaultDappCliLifecycle.ts"],
+  "sourcesContent": ["import PATH from 'node:path'\n\nimport type {\n  DappEnvironmentCatalog,\n  DappProjectManifest,\n} from '@xyo-network/dapp-kit'\nimport {\n  canonicalizeIJson,\n  DappEnvironmentCatalogZod,\n} from '@xyo-network/dapp-kit'\nimport type {\n  BuiltLocalDappProjectArtifacts,\n  PlannedLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport {\n  buildLocalDappProjectArtifacts,\n  createDefaultLocalEnvironmentCatalog,\n  planLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport type { LoadedDappProject } from '@xyo-network/dapp-kit-node'\nimport {\n  initializeDappProject,\n  loadDappProject,\n  readStrictJsonFile,\n  resolveRepositoryPath,\n} from '@xyo-network/dapp-kit-node'\n\nimport { createDefaultDappCliLifecycleServices } from './defaultDappCliLifecycle.ts'\n\nexport const DappCliExitCode = {\n  success: 0,\n  dataError: 1,\n  usageError: 2,\n  runtimeError: 3,\n} as const\n\nexport type DappCliExitCode = typeof DappCliExitCode[keyof typeof DappCliExitCode]\n\nexport const DappCliIssueCode = {\n  commandUnknown: 'cli.command-unknown',\n  deploymentRequired: 'cli.deployment-required',\n  deploymentUnknown: 'cli.deployment-unknown',\n  lifecycleUnavailable: 'cli.lifecycle-unavailable',\n  optionInvalid: 'cli.option-invalid',\n} as const\n\nexport type DappCliIssueCode = typeof DappCliIssueCode[keyof typeof DappCliIssueCode]\n\nexport class DappCliError extends Error {\n  readonly code: DappCliIssueCode\n  readonly exitCode: DappCliExitCode\n\n  constructor(code: DappCliIssueCode, message: string, exitCode: DappCliExitCode = DappCliExitCode.usageError) {\n    super(message)\n    this.name = 'DappCliError'\n    this.code = code\n    this.exitCode = exitCode\n  }\n}\n\nexport interface DappCliIo {\n  readonly stderr: (output: string) => void\n  readonly stdout: (output: string) => void\n}\n\nexport interface DappCliLifecycleResult {\n  readonly outcome: 'failed' | 'stopped'\n}\n\nexport interface DappCliLifecycleServices {\n  dev?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>\n  test?(project: PlannedLocalDappProject): Promise<DappCliLifecycleResult>\n}\n\nexport interface RunDappCliOptions {\n  readonly cwd?: string\n  readonly io?: DappCliIo\n  readonly lifecycle?: DappCliLifecycleServices\n}\n\ninterface ParsedCommand {\n  readonly catalog?: string\n  readonly command: 'build' | 'dev' | 'init' | 'inspect' | 'plan' | 'test' | 'validate'\n  readonly deployment?: string\n  readonly isJson: boolean\n  readonly manifest?: string\n  readonly repository: string\n  readonly retainOnFailure: boolean\n}\n\ntype DappCliCommand = ParsedCommand['command']\n\nconst Commands = new Set<DappCliCommand>(['build', 'dev', 'init', 'inspect', 'plan', 'test', 'validate'])\nconst ValueOptions = new Set(['--catalog', '--deployment', '--manifest', '--repository'])\n\nconst Help = `Usage: xl1-dapp <command> [options]\n\nCommands:\n  init                     Add or verify .xl1/ repository ignore policy\n  validate                 Validate xl1.dapp.json and repository identity\n  inspect                  Render the normalized project/deployment shape\n  build                    Build and admit declared artifacts\n  plan                     Create a reproducible deployment lock\n  dev                      Run a planned deployment in the foreground\n  test                     Run a planned deployment and its verification suite\n\nOptions:\n  --repository <path>      Repository root (default: current directory)\n  --manifest <path>        Repository-relative manifest (default: xl1.dapp.json)\n  --deployment <name>      Deployment for plan/dev/test\n  --catalog <path>         Repository-relative environment catalog override\n  --json                   Emit canonical JSON\n  --retain-on-failure      Keep isolated test state after failure\n  --help                   Show this help\n`\n\nfunction defaultIo(): DappCliIo {\n  return {\n    stderr: output => process.stderr.write(output),\n    stdout: output => process.stdout.write(output),\n  }\n}\n\nfunction optionValue(arguments_: readonly string[], index: number, option: string): string {\n  const value = arguments_[index + 1]\n  if (value === undefined || value.startsWith('--')) {\n    throw new DappCliError(DappCliIssueCode.optionInvalid, `${option} requires one value`)\n  }\n  return value\n}\n\nfunction isCommand(value: unknown): value is DappCliCommand {\n  return typeof value === 'string' && Commands.has(value as DappCliCommand)\n}\n\nfunction parseCommand(arguments_: readonly string[], cwd: string): ParsedCommand | 'help' {\n  if (arguments_.length === 0 || arguments_[0] === '--help' || arguments_[0] === '-h') return 'help'\n  const command = arguments_[0]\n  if (!isCommand(command)) {\n    throw new DappCliError(DappCliIssueCode.commandUnknown, `unknown command ${command}`)\n  }\n  let catalog: string | undefined\n  let deployment: string | undefined\n  let isJson = false\n  let manifest: string | undefined\n  let retainOnFailure = false\n  let repository = cwd\n  for (let index = 1; index < arguments_.length; index += 1) {\n    const option = arguments_[index]\n    if (option === '--json') {\n      isJson = true\n      continue\n    }\n    if (option === '--retain-on-failure') {\n      retainOnFailure = true\n      continue\n    }\n    if (option === undefined || !ValueOptions.has(option)) {\n      throw new DappCliError(DappCliIssueCode.optionInvalid, `unknown option ${String(option)}`)\n    }\n    const value = optionValue(arguments_, index, option)\n    index += 1\n    switch (option) {\n      case '--catalog':\n        catalog = value\n        break\n      case '--deployment':\n        deployment = value\n        break\n      case '--manifest':\n        manifest = value\n        break\n      case '--repository':\n        repository = PATH.resolve(cwd, value)\n        break\n    }\n  }\n  return {\n    ...(catalog === undefined ? {} : { catalog }),\n    command,\n    ...(deployment === undefined ? {} : { deployment }),\n    isJson,\n    ...(manifest === undefined ? {} : { manifest }),\n    retainOnFailure,\n    repository,\n  }\n}\n\nfunction print(io: DappCliIo, value: unknown, isJson: boolean): void {\n  const serialized = canonicalizeIJson(value)\n  io.stdout(isJson ? `${serialized}\\n` : `${JSON.stringify(value, undefined, 2)}\\n`)\n}\n\nfunction projectSummary(project: LoadedDappProject) {\n  return {\n    command: 'validate',\n    projectId: project.manifest.projectId,\n    manifestPath: project.manifestPath,\n    packageManager: project.packageManager,\n    source: project.source,\n  }\n}\n\nfunction deploymentSummary(\n  manifest: DappProjectManifest,\n  deploymentName: string,\n) {\n  const deployment = manifest.deployments[deploymentName]\n  if (deployment === undefined) {\n    throw new DappCliError(\n      DappCliIssueCode.deploymentUnknown,\n      `deployment ${deploymentName} is not declared`,\n      DappCliExitCode.dataError,\n    )\n  }\n  const request = deployment.request\n  const hosts = [...new Set([\n    ...request.actors.map(actor => actor.host),\n    ...request.portBindings.map(binding => binding.host),\n  ])].sort()\n  return {\n    deploymentName,\n    network: request.network,\n    supervision: request.supervision,\n    actors: request.actors.map(actor => ({\n      executionMode: actor.executionMode,\n      host: actor.host,\n      instanceId: actor.instanceId,\n      roleId: actor.roleId,\n    })),\n    hosts,\n    portBindings: request.portBindings,\n    identityBindings: request.identityBindings,\n    auxiliaryStores: request.auxiliaryStores,\n    resources: Object.entries(request.resources).map(([resourceId, resource]) => ({\n      persistence: resource.persistence,\n      provision: resource.provision,\n      resourceClass: resource.class,\n      resourceId,\n    })),\n    policies: request.policies,\n    verification: request.verification.map(verification => ({\n      evidence: verification.evidence,\n      id: verification.id,\n      package: verification.package,\n      script: verification.script,\n    })),\n    absenceGuarantees: {\n      actors: request.actors.length === 0,\n      datalake: request.policies.datalake.mode === 'none',\n      externalSources: request.policies.externalInteraction.mode === 'none',\n      projection: request.policies.projection.profile === 'none',\n      sideChannel: request.policies.sideChannel.profile === 'none',\n    },\n    unresolved: {\n      artifactBuilds: Object.keys(manifest.artifacts),\n      environmentResources: Object.keys(request.resources),\n    },\n  }\n}\n\nfunction inspectSummary(manifest: DappProjectManifest, selectedDeployment?: string) {\n  const deploymentNames = selectedDeployment === undefined\n    ? Object.keys(manifest.deployments)\n    : [selectedDeployment]\n  return {\n    command: 'inspect',\n    projectId: manifest.projectId,\n    definition: {\n      dappId: manifest.definition.dappId,\n      definitionVersion: manifest.definition.definitionVersion,\n      protocolVersion: manifest.definition.protocolVersion,\n      actors: manifest.definition.actors.map(actor => actor.roleId),\n      ports: manifest.definition.ports.map(port => port.portId),\n      durability: manifest.definition.durability,\n    },\n    artifacts: Object.entries(manifest.artifacts).map(([artifactId, artifact]) => ({\n      artifactId, kind: artifact.kind, package: artifact.package,\n    })),\n    deployments: deploymentNames.map(name => deploymentSummary(manifest, name)),\n  }\n}\n\nfunction buildSummary(built: BuiltLocalDappProjectArtifacts) {\n  return {\n    command: 'build',\n    projectId: built.project.manifest.projectId,\n    artifacts: built.locks,\n  }\n}\n\nasync function loadCatalog(command: ParsedCommand): Promise<DappEnvironmentCatalog> {\n  if (command.catalog === undefined) return createDefaultLocalEnvironmentCatalog()\n  const path = await resolveRepositoryPath(command.repository, command.catalog, { kind: 'file' })\n  return DappEnvironmentCatalogZod.parse(await readStrictJsonFile(path))\n}\n\nasync function planned(command: ParsedCommand): Promise<PlannedLocalDappProject> {\n  if (command.deployment === undefined) {\n    throw new DappCliError(DappCliIssueCode.deploymentRequired, '--deployment is required for plan, dev, and test')\n  }\n  return await planLocalDappProject({\n    catalog: await loadCatalog(command),\n    deploymentName: command.deployment,\n    ...(command.manifest === undefined ? {} : { manifestPath: command.manifest }),\n    repositoryRoot: command.repository,\n  })\n}\n\nasync function execute(\n  command: ParsedCommand,\n  options: RunDappCliOptions,\n  io: DappCliIo,\n): Promise<DappCliExitCode> {\n  const projectOptions = {\n    ...(command.manifest === undefined ? {} : { manifestPath: command.manifest }),\n    repositoryRoot: command.repository,\n  }\n  if (command.command === 'validate') {\n    print(io, projectSummary(await loadDappProject(projectOptions)), command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'init') {\n    print(io, { command: 'init', ...await initializeDappProject(command.repository) }, command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'inspect') {\n    const project = await loadDappProject(projectOptions)\n    print(io, inspectSummary(project.manifest, command.deployment), command.isJson)\n    return DappCliExitCode.success\n  }\n  if (command.command === 'build') {\n    const built = await buildLocalDappProjectArtifacts({\n      ...projectOptions,\n      onStderr: output => io.stderr(output),\n      onStdout: output => io.stdout(output),\n    })\n    print(io, buildSummary(built), command.isJson)\n    return DappCliExitCode.success\n  }\n  const plan = await planned(command)\n  if (command.command === 'plan') {\n    print(io, { command: 'plan', lock: plan.lock }, command.isJson)\n    return DappCliExitCode.success\n  }\n  const lifecycle = options.lifecycle ?? createDefaultDappCliLifecycleServices({\n    io,\n    retainOnFailure: command.retainOnFailure,\n  })\n  const result = command.command === 'dev'\n    ? await lifecycle.dev?.(plan)\n    : await lifecycle.test?.(plan)\n  if (result === undefined) {\n    throw new DappCliError(\n      DappCliIssueCode.lifecycleUnavailable,\n      `${command.command} requires an installed local lifecycle service`,\n      DappCliExitCode.runtimeError,\n    )\n  }\n  print(io, { command: command.command, outcome: result.outcome }, command.isJson)\n  return result.outcome === 'stopped' ? DappCliExitCode.success : DappCliExitCode.runtimeError\n}\n\nfunction errorCode(error: unknown): string {\n  return error instanceof Error && 'code' in error && typeof error.code === 'string'\n    ? error.code\n    : 'cli.internal-error'\n}\n\nexport async function runDappCli(\n  arguments_: readonly string[],\n  options: RunDappCliOptions = {},\n): Promise<DappCliExitCode> {\n  const io = options.io ?? defaultIo()\n  try {\n    const parsed = parseCommand(arguments_, options.cwd ?? process.cwd())\n    if (parsed === 'help') {\n      io.stdout(Help)\n      return DappCliExitCode.success\n    }\n    return await execute(parsed, options, io)\n  } catch (error) {\n    const exitCode = error instanceof DappCliError ? error.exitCode : DappCliExitCode.dataError\n    io.stderr(`${canonicalizeIJson({\n      code: errorCode(error),\n      message: error instanceof Error ? error.message : 'unknown CLI failure',\n    })}\\n`)\n    return exitCode\n  }\n}\n", "import PATH from 'node:path'\n\nimport { canonicalizeIJson } from '@xyo-network/dapp-kit'\nimport type {\n  DefaultLocalDappRun,\n  PlannedLocalDappProject,\n} from '@xyo-network/dapp-kit-local'\nimport {\n  runLocalDappVerifications,\n  startDefaultLocalDappRun,\n} from '@xyo-network/dapp-kit-local'\n\nimport type {\n  DappCliIo,\n  DappCliLifecycleResult,\n  DappCliLifecycleServices,\n} from './dappCli.ts'\n\nexport interface CreateDefaultDappCliLifecycleOptions {\n  readonly io: DappCliIo\n  readonly retainOnFailure: boolean\n}\n\nfunction renderEvent(io: DappCliIo, componentId: string, value: unknown): void {\n  io.stderr(`[${componentId}] ${canonicalizeIJson(value)}\\n`)\n}\n\nfunction signalOwnedRun(run: DefaultLocalDappRun): () => void {\n  const stop = (): void => {\n    void run.stop().catch(() => null)\n  }\n  process.once('SIGINT', stop)\n  process.once('SIGTERM', stop)\n  return () => {\n    process.off('SIGINT', stop)\n    process.off('SIGTERM', stop)\n  }\n}\n\nfunction renderReady(io: DappCliIo, run: DefaultLocalDappRun, endpoints: readonly unknown[]): void {\n  renderEvent(io, 'runner', {\n    code: 'cli.run-ready',\n    endpoints,\n    runId: run.runId,\n    stateRoot: run.stateRoot,\n  })\n}\n\nasync function runDev(\n  project: PlannedLocalDappProject,\n  options: CreateDefaultDappCliLifecycleOptions,\n): Promise<DappCliLifecycleResult> {\n  const run = await startDefaultLocalDappRun({\n    mode: 'dev',\n    onForegroundLog: entry => renderEvent(options.io, entry.componentId, entry),\n    planned: project,\n  })\n  const unbindSignals = signalOwnedRun(run)\n  try {\n    try {\n      const ready = await run.whenReady\n      renderReady(options.io, run, ready.endpoints)\n    } catch {\n      // The terminal result below retains the stable startup failure.\n    }\n    return await run.whenTerminal\n  } finally {\n    unbindSignals()\n  }\n}\n\nasync function stopAfterTest(\n  run: DefaultLocalDappRun,\n  isVerificationFailed: boolean,\n  retainOnFailure: boolean,\n): Promise<DappCliLifecycleResult> {\n  if (isVerificationFailed && retainOnFailure) run.retainState()\n  const terminal = await run.stop()\n  return terminal.outcome === 'failed' || isVerificationFailed\n    ? { outcome: 'failed' }\n    : { outcome: 'stopped' }\n}\n\nasync function runTest(\n  project: PlannedLocalDappProject,\n  options: CreateDefaultDappCliLifecycleOptions,\n): Promise<DappCliLifecycleResult> {\n  const run = await startDefaultLocalDappRun({\n    mode: 'test',\n    onForegroundLog: entry => renderEvent(options.io, entry.componentId, entry),\n    planned: project,\n    retainOnFailure: options.retainOnFailure,\n  })\n  const abort = new AbortController()\n  const unbindSignals = signalOwnedRun(run)\n  void run.whenTerminal.then(() => abort.abort())\n  try {\n    const ready = await run.whenReady\n    renderReady(options.io, run, ready.endpoints)\n    const summary = await runLocalDappVerifications({\n      contextRoot: PATH.join(run.stateRoot, 'verification'),\n      deploymentName: project.lock.deployment.name,\n      endpoints: ready.endpoints,\n      lockId: project.lock.lockId,\n      onOutput: output => run.logVerificationOutput(output),\n      planId: project.lock.plan.planId,\n      project: project.project,\n      signal: abort.signal,\n    })\n    for (const result of summary.results) renderEvent(options.io, `verification-${result.id}`, result)\n    return await stopAfterTest(run, summary.outcome === 'failed', options.retainOnFailure)\n  } catch (error) {\n    renderEvent(options.io, 'runner', {\n      code: 'cli.test-failed',\n      causeCode: error instanceof Error && 'code' in error && typeof error.code === 'string'\n        ? error.code\n        : 'unknown',\n    })\n    if (options.retainOnFailure) run.retainState()\n    const terminal = await run.stop()\n    return terminal.outcome === 'failed' ? terminal : { outcome: 'failed' }\n  } finally {\n    unbindSignals()\n  }\n}\n\nexport function createDefaultDappCliLifecycleServices(\n  options: CreateDefaultDappCliLifecycleOptions,\n): DappCliLifecycleServices {\n  return {\n    dev: async project => await runDev(project, options),\n    test: async project => await runTest(project, options),\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["PATH", "canonicalizeIJson", "PATH", "canonicalizeIJson"]
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@xyo-network/dapp-kit-cli",
+  "version": "0.1.2",
+  "description": "Thin command-line adapter for XL1 dapp-kit projects",
+  "keywords": [
+    "xyo",
+    "xl1",
+    "dapp",
+    "cli",
+    "typescript"
+  ],
+  "bugs": {
+    "url": "https://github.com/XYOracleNetwork/dapp-kit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XYOracleNetwork/dapp-kit.git",
+    "directory": "packages/dapp-kit-cli"
+  },
+  "license": "UNLICENSED",
+  "sideEffects": false,
+  "type": "module",
+  "bin": {
+    "xl1-dapp": "./dist/node/bin.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.mjs"
+    },
+    "./bin": {
+      "types": "./dist/node/bin.d.ts",
+      "default": "./dist/node/bin.mjs"
+    },
+    "./package.json": "./package.json",
+    "./README.md": "./README.md"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ariestools/actor-model": "~1.3.0",
+    "@ariestools/actor-system": "~1.3.0",
+    "@ariestools/cli-kit": "~1.2.3",
+    "@ariestools/sdk": "~8.1.8",
+    "@noble/hashes": "~2.3.0",
+    "@opentelemetry/api": "~1.9.1",
+    "@xyo-network/sdk": "~7.2.3",
+    "@xyo-network/sdk-protocol": "~7.2.3",
+    "@xyo-network/xl1-sdk": "~5.1.1",
+    "async-mutex": "~0.5.0",
+    "ethers": "~6.17.0",
+    "semver": "~7.8.5",
+    "zod": "~4.4.3",
+    "@xyo-network/dapp-kit": "~0.1.2",
+    "@xyo-network/dapp-kit-local": "~0.1.2",
+    "@xyo-network/dapp-kit-node": "~0.1.2"
+  },
+  "devDependencies": {
+    "@ariestools/toolchain": "~8.7.29",
+    "@ariestools/tsconfig": "~8.7.29",
+    "@types/node": "~26.2.0",
+    "eslint": "~10.8.1",
+    "eslint-import-resolver-typescript": "~4.4.5",
+    "typescript": "~6.0.3",
+    "vite": "~8.2.1",
+    "vitest": "~4.1.10"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:ci": "vitest run"
+  }
+}