@toon-protocol/townhouse 0.1.0-rc5 → 0.1.0

package/dist/chunk-GQNBZJ6F.js

@@ -0,0 +1,39 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+
+// src/constants.ts
+var CONTAINER_PREFIX = "townhouse-";
+var NODE_BTP_PORT = 3e3;
+var DEFAULT_CONNECTOR_IMAGE = (
+  // v3.8.0 — latest published connector (Story 50.4 bump). Migrates local SQLite
+  // from better-sqlite3 to libsql (toon-protocol/connector#79 — removes the
+  // native-build failure on Node 24 that left the settlement/claim subsystem
+  // silently un-wired → value-bearing packets auto-fulfilled instead of
+  // claim-gated) AND makes inbound per-packet claim validation relation-aware
+  // (toon-protocol/connector#78 — a child node now skips the inline-claim
+  // requirement for PREPAREs forwarded from its parent, unblocking Story 50.3's
+  // AC#1 kind:1 F06 "No payment channel claim attached" on the apex→child hop).
+  // No breaking changes to the SDK/admin contract within 3.x (verified >=3.3.2
+  // through 3.8.0 — see packages/sdk/CONNECTOR_MIGRATION.md). Digest resolved via
+  // `docker buildx imagetools inspect` for tag 3.8.0. To bump: see
+  // CONNECTOR_RELEASE_CONTRACT.md.
+  "ghcr.io/toon-protocol/connector@sha256:3343c19649290043e521c81b467b7c6410b8eaedd76d48804ea9b6fc810cddb0"
+);
+var ACCOUNT_INDEX_TOWN = 0;
+var ACCOUNT_INDEX_MILL = 1;
+var ACCOUNT_INDEX_DVM = 2;
+var TOWN_HEALTH_PORT = 3100;
+var MILL_HEALTH_PORT = 3200;
+var DVM_HEALTH_PORT = 3400;
+
+export {
+  CONTAINER_PREFIX,
+  NODE_BTP_PORT,
+  DEFAULT_CONNECTOR_IMAGE,
+  ACCOUNT_INDEX_TOWN,
+  ACCOUNT_INDEX_MILL,
+  ACCOUNT_INDEX_DVM,
+  TOWN_HEALTH_PORT,
+  MILL_HEALTH_PORT,
+  DVM_HEALTH_PORT
+};
+//# sourceMappingURL=chunk-GQNBZJ6F.js.map

package/dist/chunk-GQNBZJ6F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Shared constants for Townhouse package.\n *\n * Single source of truth for values used across multiple modules\n * (orchestrator, config-generator, CLI).\n */\n\n/** Container name prefix for all Townhouse-managed Docker containers */\nexport const CONTAINER_PREFIX = 'townhouse-';\n\n/** Internal BTP port exposed by node containers (Docker-internal only) */\nexport const NODE_BTP_PORT = 3000;\n\n/**\n * Default connector Docker image — digest-pinned per CONNECTOR_RELEASE_CONTRACT.md.\n *\n * To bump: capture a new digest by running the Story 45.1 publish workflow\n * against the desired connector tag, copy the resulting image-manifest.json\n * connector entry's digest, and update this constant + the contract canary\n * fixture. See packages/sdk/CONNECTOR_RELEASE_CONTRACT.md for the full bump\n * checklist + breaking-changes history.\n *\n * To read the human-readable tag for log output, consult dist/image-manifest.json:\n *   manifest.images.connector.tag\n */\nexport const DEFAULT_CONNECTOR_IMAGE =\n  // v3.8.0 — latest published connector (Story 50.4 bump). Migrates local SQLite\n  // from better-sqlite3 to libsql (toon-protocol/connector#79 — removes the\n  // native-build failure on Node 24 that left the settlement/claim subsystem\n  // silently un-wired → value-bearing packets auto-fulfilled instead of\n  // claim-gated) AND makes inbound per-packet claim validation relation-aware\n  // (toon-protocol/connector#78 — a child node now skips the inline-claim\n  // requirement for PREPAREs forwarded from its parent, unblocking Story 50.3's\n  // AC#1 kind:1 F06 \"No payment channel claim attached\" on the apex→child hop).\n  // No breaking changes to the SDK/admin contract within 3.x (verified >=3.3.2\n  // through 3.8.0 — see packages/sdk/CONNECTOR_MIGRATION.md). Digest resolved via\n  // `docker buildx imagetools inspect` for tag 3.8.0. To bump: see\n  // CONNECTOR_RELEASE_CONTRACT.md.\n  'ghcr.io/toon-protocol/connector@sha256:3343c19649290043e521c81b467b7c6410b8eaedd76d48804ea9b6fc810cddb0';\n\n/**\n * HD wallet account indices per node type (Story 21.4, D21-008).\n * BIP-44 paths: m/44'/{coin}'/ACCOUNT'/0/0\n */\nexport const ACCOUNT_INDEX_TOWN = 0;\nexport const ACCOUNT_INDEX_MILL = 1;\nexport const ACCOUNT_INDEX_DVM = 2;\n\n/** BLS health port exposed by each node container type (internal Docker port). */\nexport const TOWN_HEALTH_PORT = 3100;\nexport const MILL_HEALTH_PORT = 3200;\nexport const DVM_HEALTH_PORT = 3400;\n"],"mappings":";;;AAQO,IAAM,mBAAmB;AAGzB,IAAM,gBAAgB;AActB,IAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaX;AAAA;AAMK,IAAM,qBAAqB;AAC3B,IAAM,qBAAqB;AAC3B,IAAM,oBAAoB;AAG1B,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AACzB,IAAM,kBAAkB;","names":[]}

package/dist/{chunk-UTFWPLTB.js → chunk-I2R4CRUX.js}

@@ -31,29 +31,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// src/constants.ts
-var CONTAINER_PREFIX = "townhouse-";
-var NODE_BTP_PORT = 3e3;
-var DEFAULT_CONNECTOR_IMAGE = "ghcr.io/toon-protocol/connector@sha256:4a24ccb0997d7b025997e670546032f6a84cd18a77c490509016b85e181a344e";
-var ACCOUNT_INDEX_TOWN = 0;
-var ACCOUNT_INDEX_MILL = 1;
-var ACCOUNT_INDEX_DVM = 2;
-var TOWN_HEALTH_PORT = 3100;
-var MILL_HEALTH_PORT = 3200;
-var DVM_HEALTH_PORT = 3400;
-
 export {
   __require,
   __commonJS,
-  __toESM,
-  CONTAINER_PREFIX,
-  NODE_BTP_PORT,
-  DEFAULT_CONNECTOR_IMAGE,
-  ACCOUNT_INDEX_TOWN,
-  ACCOUNT_INDEX_MILL,
-  ACCOUNT_INDEX_DVM,
-  TOWN_HEALTH_PORT,
-  MILL_HEALTH_PORT,
-  DVM_HEALTH_PORT
+  __toESM
 };
-//# sourceMappingURL=chunk-UTFWPLTB.js.map
+//# sourceMappingURL=chunk-I2R4CRUX.js.map

package/dist/chunk-I2R4CRUX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-JCOFMUPL.js

@@ -0,0 +1,65 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+
+// src/tui/format.ts
+var DECIMAL_RE = /^-?\d+$/;
+var MICRO_FRACTIONAL_DIGITS = 4;
+function formatRelativeTime(iso, now = /* @__PURE__ */ new Date()) {
+  if (iso === null) return "\u2014";
+  const ms = Date.parse(iso);
+  if (!Number.isFinite(ms)) return "?";
+  const deltaSec = Math.max(0, Math.floor((now.getTime() - ms) / 1e3));
+  if (deltaSec < 60) return "<1m ago";
+  if (deltaSec < 3600) return `${Math.floor(deltaSec / 60)}m ago`;
+  if (deltaSec < 86400) return `${Math.floor(deltaSec / 3600)}h ago`;
+  if (deltaSec < 2592e3) return `${Math.floor(deltaSec / 86400)}d ago`;
+  return `${Math.floor(deltaSec / 2592e3)}mo ago`;
+}
+function formatUsdcMicro(decimalString, scale) {
+  if (!DECIMAL_RE.test(decimalString)) {
+    const env = process.env["NODE_ENV"];
+    if (env === "development" || env === "test") {
+      throw new Error(
+        `formatUsdcMicro: invalid decimal string: ${JSON.stringify(decimalString)}`
+      );
+    }
+    return "$?.????";
+  }
+  const negative = decimalString.startsWith("-");
+  const abs = negative ? decimalString.slice(1) : decimalString;
+  const divisor = BigInt(10) ** BigInt(scale);
+  const value = BigInt(abs);
+  const whole = value / divisor;
+  const remainder = value % divisor;
+  const fractionalStr = remainder.toString().padStart(scale, "0");
+  const cents = fractionalStr.slice(0, MICRO_FRACTIONAL_DIGITS).padEnd(MICRO_FRACTIONAL_DIGITS, "0");
+  const formatted = `$${whole.toString()}.${cents}`;
+  return negative && value !== 0n ? `-${formatted}` : formatted;
+}
+function formatUsdc(decimalString, scale) {
+  if (!DECIMAL_RE.test(decimalString)) {
+    const env = process.env["NODE_ENV"];
+    if (env === "development" || env === "test") {
+      throw new Error(
+        `formatUsdc: invalid decimal string: ${JSON.stringify(decimalString)}`
+      );
+    }
+    return "$?.??";
+  }
+  const negative = decimalString.startsWith("-");
+  const abs = negative ? decimalString.slice(1) : decimalString;
+  const divisor = BigInt(10) ** BigInt(scale);
+  const value = BigInt(abs);
+  const whole = value / divisor;
+  const remainder = value % divisor;
+  const fractionalStr = remainder.toString().padStart(scale, "0");
+  const cents = fractionalStr.slice(0, 2).padEnd(2, "0");
+  const formatted = `$${whole.toString()}.${cents}`;
+  return negative && value !== 0n ? `-${formatted}` : formatted;
+}
+
+export {
+  formatRelativeTime,
+  formatUsdcMicro,
+  formatUsdc
+};
+//# sourceMappingURL=chunk-JCOFMUPL.js.map

package/dist/chunk-JCOFMUPL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tui/format.ts"],"sourcesContent":["const DECIMAL_RE = /^-?\\d+$/;\nconst MICRO_FRACTIONAL_DIGITS = 4;\n\nexport function formatRelativeTime(\n  iso: string | null,\n  now: Date = new Date()\n): string {\n  if (iso === null) return '—';\n  const ms = Date.parse(iso);\n  if (!Number.isFinite(ms)) return '?';\n  // Clamp negative deltas (future-dated `at` from host/container clock skew) to 0.\n  // Without the clamp, a claim ~hours in the future would silently render `<1m ago`\n  // because every negative value already trips the `< 60` shortcut; the clamp makes\n  // the future-tolerance contract explicit instead of incidental.\n  const deltaSec = Math.max(0, Math.floor((now.getTime() - ms) / 1000));\n  if (deltaSec < 60) return '<1m ago';\n  if (deltaSec < 3600) return `${Math.floor(deltaSec / 60)}m ago`;\n  if (deltaSec < 86_400) return `${Math.floor(deltaSec / 3600)}h ago`;\n  if (deltaSec < 2_592_000) return `${Math.floor(deltaSec / 86_400)}d ago`;\n  return `${Math.floor(deltaSec / 2_592_000)}mo ago`;\n}\n\nexport function formatUsdcMicro(decimalString: string, scale: number): string {\n  if (!DECIMAL_RE.test(decimalString)) {\n    const env = process.env['NODE_ENV'];\n    if (env === 'development' || env === 'test') {\n      throw new Error(\n        `formatUsdcMicro: invalid decimal string: ${JSON.stringify(decimalString)}`\n      );\n    }\n    return '$?.????';\n  }\n\n  const negative = decimalString.startsWith('-');\n  const abs = negative ? decimalString.slice(1) : decimalString;\n\n  const divisor = BigInt(10) ** BigInt(scale);\n  const value = BigInt(abs);\n\n  const whole = value / divisor;\n  const remainder = value % divisor;\n\n  const fractionalStr = remainder.toString().padStart(scale, '0');\n  const cents = fractionalStr\n    .slice(0, MICRO_FRACTIONAL_DIGITS)\n    .padEnd(MICRO_FRACTIONAL_DIGITS, '0');\n\n  const formatted = `$${whole.toString()}.${cents}`;\n  return negative && value !== 0n ? `-${formatted}` : formatted;\n}\n\nexport function formatUsdc(decimalString: string, scale: number): string {\n  if (!DECIMAL_RE.test(decimalString)) {\n    const env = process.env['NODE_ENV'];\n    if (env === 'development' || env === 'test') {\n      throw new Error(\n        `formatUsdc: invalid decimal string: ${JSON.stringify(decimalString)}`\n      );\n    }\n    return '$?.??';\n  }\n\n  const negative = decimalString.startsWith('-');\n  const abs = negative ? decimalString.slice(1) : decimalString;\n\n  const divisor = BigInt(10) ** BigInt(scale);\n  const value = BigInt(abs);\n\n  // Truncate (do NOT round) — connector posture.\n  const whole = value / divisor;\n  const remainder = value % divisor;\n\n  const fractionalStr = remainder.toString().padStart(scale, '0');\n  const cents = fractionalStr.slice(0, 2).padEnd(2, '0');\n\n  const formatted = `$${whole.toString()}.${cents}`;\n  // Suppress `-$0.00` — value === 0n collapses negative zero.\n  return negative && value !== 0n ? `-${formatted}` : formatted;\n}\n"],"mappings":";;;AAAA,IAAM,aAAa;AACnB,IAAM,0BAA0B;AAEzB,SAAS,mBACd,KACA,MAAY,oBAAI,KAAK,GACb;AACR,MAAI,QAAQ,KAAM,QAAO;AACzB,QAAM,KAAK,KAAK,MAAM,GAAG;AACzB,MAAI,CAAC,OAAO,SAAS,EAAE,EAAG,QAAO;AAKjC,QAAM,WAAW,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,QAAQ,IAAI,MAAM,GAAI,CAAC;AACpE,MAAI,WAAW,GAAI,QAAO;AAC1B,MAAI,WAAW,KAAM,QAAO,GAAG,KAAK,MAAM,WAAW,EAAE,CAAC;AACxD,MAAI,WAAW,MAAQ,QAAO,GAAG,KAAK,MAAM,WAAW,IAAI,CAAC;AAC5D,MAAI,WAAW,OAAW,QAAO,GAAG,KAAK,MAAM,WAAW,KAAM,CAAC;AACjE,SAAO,GAAG,KAAK,MAAM,WAAW,MAAS,CAAC;AAC5C;AAEO,SAAS,gBAAgB,eAAuB,OAAuB;AAC5E,MAAI,CAAC,WAAW,KAAK,aAAa,GAAG;AACnC,UAAM,MAAM,QAAQ,IAAI,UAAU;AAClC,QAAI,QAAQ,iBAAiB,QAAQ,QAAQ;AAC3C,YAAM,IAAI;AAAA,QACR,4CAA4C,KAAK,UAAU,aAAa,CAAC;AAAA,MAC3E;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,cAAc,WAAW,GAAG;AAC7C,QAAM,MAAM,WAAW,cAAc,MAAM,CAAC,IAAI;AAEhD,QAAM,UAAU,OAAO,EAAE,KAAK,OAAO,KAAK;AAC1C,QAAM,QAAQ,OAAO,GAAG;AAExB,QAAM,QAAQ,QAAQ;AACtB,QAAM,YAAY,QAAQ;AAE1B,QAAM,gBAAgB,UAAU,SAAS,EAAE,SAAS,OAAO,GAAG;AAC9D,QAAM,QAAQ,cACX,MAAM,GAAG,uBAAuB,EAChC,OAAO,yBAAyB,GAAG;AAEtC,QAAM,YAAY,IAAI,MAAM,SAAS,CAAC,IAAI,KAAK;AAC/C,SAAO,YAAY,UAAU,KAAK,IAAI,SAAS,KAAK;AACtD;AAEO,SAAS,WAAW,eAAuB,OAAuB;AACvE,MAAI,CAAC,WAAW,KAAK,aAAa,GAAG;AACnC,UAAM,MAAM,QAAQ,IAAI,UAAU;AAClC,QAAI,QAAQ,iBAAiB,QAAQ,QAAQ;AAC3C,YAAM,IAAI;AAAA,QACR,uCAAuC,KAAK,UAAU,aAAa,CAAC;AAAA,MACtE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,cAAc,WAAW,GAAG;AAC7C,QAAM,MAAM,WAAW,cAAc,MAAM,CAAC,IAAI;AAEhD,QAAM,UAAU,OAAO,EAAE,KAAK,OAAO,KAAK;AAC1C,QAAM,QAAQ,OAAO,GAAG;AAGxB,QAAM,QAAQ,QAAQ;AACtB,QAAM,YAAY,QAAQ;AAE1B,QAAM,gBAAgB,UAAU,SAAS,EAAE,SAAS,OAAO,GAAG;AAC9D,QAAM,QAAQ,cAAc,MAAM,GAAG,CAAC,EAAE,OAAO,GAAG,GAAG;AAErD,QAAM,YAAY,IAAI,MAAM,SAAS,CAAC,IAAI,KAAK;AAE/C,SAAO,YAAY,UAAU,KAAK,IAAI,SAAS,KAAK;AACtD;","names":[]}

package/dist/cli.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import Docker from 'dockerode';
+import { C as ComposeLoaderOptions, T as TownhouseConfig, W as WalletManager, N as NodeType } from './manager-SsneW_Mj.js';
 
 /**
  * Cross-platform browser opener for the wizard CLI command.
@@ -9,6 +10,33 @@ interface BrowserOpener {
     open(url: string): Promise<void>;
 }
 
+/**
+ * Port-collision preflight for `townhouse hs up` (Epic 49 Followup B).
+ *
+ * Detects host-port conflicts BEFORE handing off to Docker, so operators get
+ * an actionable error message instead of a cryptic mid-boot EADDRINUSE.
+ *
+ * Detection strategy (defense in depth):
+ *   1. Bind a transient TCP socket to 127.0.0.1:<port> and immediately close.
+ *      If bind throws EADDRINUSE, the port is occupied. Pure Node, no deps,
+ *      works on Linux/Mac/WSL — this is the source of truth.
+ *   2. If (1) flags a collision, ask Docker for the offending container's
+ *      name + compose project so the message can name a culprit. Best-effort
+ *      enrichment — Docker may be unreachable, in which case we still report
+ *      the port and suggest `lsof` for non-Docker processes.
+ */
+
+interface PortCollision {
+    /** The host port that is already bound. */
+    port: number;
+    /** Name of the Docker container holding the port (when known). */
+    containerName?: string;
+    /** Compose project the container belongs to (when known). */
+    composeProject?: string;
+    /** Container status string e.g. "Up 5 hours" (when known). */
+    status?: string;
+}
+
 /**
  * CLI entrypoint for `@toon-protocol/townhouse` (Story 21.1).
  *
@@ -29,10 +57,74 @@ interface BrowserOpener {
 declare class CliHelpRequested extends Error {
     constructor();
 }
+/**
+ * Dependency-injection overrides for the `hs up` / `hs down` CLI path.
+ * Used by unit tests to stub out Docker, file I/O, and admin client.
+ */
+interface CliHsOverrides {
+    /** Override materializeComposeTemplate (avoids disk writes in tests). */
+    materializeComposeTemplate?: (profile: string, opts?: ComposeLoaderOptions) => {
+        composePath: string;
+        manifestPath: string;
+    };
+    /** Override the DockerOrchestrator constructor (avoids real Docker in tests). */
+    createOrchestrator?: (docker: Docker, config: TownhouseConfig, walletManager: WalletManager | undefined, options: {
+        profile: 'hs';
+        composePath: string;
+    }) => {
+        up: (profiles: NodeType[]) => Promise<void>;
+        down: () => Promise<void>;
+        on: (event: string, handler: (...args: unknown[]) => void) => unknown;
+        /**
+         * Pre-pull a single image ref (Epic 49 Followup D).
+         * Optional on the stub interface — when omitted on a real orchestrator,
+         * the cold-pull narration phase is skipped (silent degrade).
+         */
+        pullImage?: (image: string) => Promise<void>;
+    };
+    /** Override ConnectorAdminClient construction (avoids real HTTP in tests). */
+    createAdminClient?: (baseUrl: string, timeoutMs: number) => {
+        getHsHostname: () => Promise<{
+            hostname: string | null;
+            publishedAt: string | null;
+        }>;
+    };
+    /** Override `docker compose down -v` spawn for --rotate-keys (avoids real Docker). */
+    runComposeDown?: (composePath: string, withVolumes: boolean) => Promise<void>;
+    /**
+     * Override BootReconciler construction (Story 46.1). Tests inject a stub
+     * with a spied-on `reconcile()` to assert wiring without touching disk
+     * or the connector. When omitted, the default constructs a real
+     * `BootReconciler` against `~/.townhouse/{nodes.yaml,reconciler.log}`.
+     */
+    createReconciler?: (nodesYamlPath: string, reconcilerLogPath: string) => {
+        reconcile: () => Promise<void>;
+    };
+    /**
+     * Override the port-collision preflight check (Epic 49 Followup B).
+     * Default invokes `checkHsPortCollisions(docker)` from
+     * `./cli/preflight-ports.js`. Tests inject a stub that returns either
+     * `[]` (happy path) or a fabricated PortCollision[] (collision path) so
+     * the production socket-bind + Docker enrichment is not exercised in
+     * unit tests.
+     */
+    checkPortCollisions?: (docker: Docker) => Promise<PortCollision[]>;
+}
+/**
+ * Dependency-injection overrides for the `node add` / `node remove` / `node list` CLI path.
+ * Used by unit tests to stub `fetch` and the interactive confirmation prompt.
+ */
+interface CliNodeCommandOverrides {
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    confirm?: (question: string) => Promise<boolean>;
+    apiUrl?: string;
+}
 /**
  * Main CLI entry — exported for testability (same pattern as Mill CLI).
  * Accepts optional dockerode instance for dependency injection in tests.
+ * The optional `hsOverrides` bag is used by unit tests to stub out Docker,
+ * file I/O, and admin-client calls in the `hs up` / `hs down` path.
  */
-declare function main(argv: string[], dockerInstance?: Docker, browserOpener?: BrowserOpener): Promise<void>;
+declare function main(argv: string[], dockerInstance?: Docker, browserOpener?: BrowserOpener, hsOverrides?: CliHsOverrides, nodeCommandOverrides?: CliNodeCommandOverrides): Promise<void>;
 
-export { CliHelpRequested, main };
+export { CliHelpRequested, type CliHsOverrides, type CliNodeCommandOverrides, main };