movehat 0.1.8 → 0.2.0

package/dist/templates/tests/Counter.test.ts

@@ -1,104 +1,102 @@
 // @ts-nocheck - This is a template file, dependencies are installed in user projects
 import { describe, it, before, after } from "mocha";
 import { expect } from "chai";
-import { setupTestFixture, teardownTestFixture, type TestFixture } from "movehat/helpers";
+import { Harness, AccountManager } from "movehat";
 
 describe("Counter Contract", () => {
-  let fixture: TestFixture<'counter'>;
+  let harness;
+  let counter;
+  let deployer, alice, bob;
 
   before(async function () {
     this.timeout(60000); // Allow time for local node startup + deployment
 
-    // Setup local testing environment with auto-deployment
-    // This will:
-    // 1. Start a local Movement blockchain node
-    // 2. Generate and fund test accounts from local faucet
-    // 3. Auto-deploy the counter module
-    // 4. Return everything ready to use
+    // Hardhat-style Harness — primary public API since M2.
+    // createLocal spins up a Movement local node, funds the labeled
+    // accounts from the local faucet, and (via autoDeploy) builds +
+    // publishes the named modules so they're ready to use.
     //
-    // By default uses 'local-node' mode (full blockchain)
-    // For faster tests on existing state, pass { mode: 'fork' }
-    //
-    // Note: Use 'as const' for type inference
-    fixture = await setupTestFixture(['counter'] as const, ['alice', 'bob']);
+    // The setupTestFixture helper still works if you prefer the older
+    // pattern; see `import { setupTestFixture } from "movehat/helpers"`.
+    harness = await Harness.createLocal({
+      accountLabels: ["deployer", "alice", "bob"],
+      autoDeploy: ["counter"],
+    });
+
+    const labeled = AccountManager.getLabeledAccounts();
+    deployer = labeled.deployer;
+    alice = labeled.alice;
+    bob = labeled.bob;
+
+    const counterAddr = harness.runtime.getDeploymentAddress("counter");
+    counter = harness.runtime.getContract(counterAddr, "counter");
 
     console.log(`\n✅ Testing on local blockchain`);
-    console.log(`   Deployer: ${fixture.accounts.deployer.accountAddress.toString()}`);
-    console.log(`   Alice: ${fixture.accounts.alice.accountAddress.toString()}`);
-    console.log(`   Bob: ${fixture.accounts.bob.accountAddress.toString()}\n`);
+    console.log(`   Deployer: ${deployer.accountAddress.toString()}`);
+    console.log(`   Alice: ${alice.accountAddress.toString()}`);
+    console.log(`   Bob: ${bob.accountAddress.toString()}\n`);
   });
 
   describe("Counter functionality", () => {
-    it("should initialize with value 0", async () => {
-      const counter = fixture.contracts.counter; // Type-safe, no `!` needed
-      const deployer = fixture.accounts.deployer;
+    it("should initialize counter for deployer", async () => {
+      // Initialize counter for deployer (required before get/increment)
+      const tx = await counter.call(deployer, "init", []);
+      console.log(`   Init transaction: ${tx.hash}`);
 
-      // Read counter value (returns string from view function)
-      const value = await counter.view<string>("get", [
-        deployer.accountAddress.toString()
-      ]);
+      // Read counter value via harness.runViewFunction (new in M2)
+      const [value] = await harness.runViewFunction({
+        function: `${counter.moduleAddress}::counter::get`,
+        functionArguments: [deployer.accountAddress.toString()],
+      });
 
       console.log(`   Counter value: ${value}`);
-
-      // Assert the counter is 0 (note: values from view are strings)
       expect(parseInt(value)).to.equal(0);
     });
 
     it("should increment counter", async () => {
-      const counter = fixture.contracts.counter;
-      const deployer = fixture.accounts.deployer;
-
-      // Increment the counter
       const tx = await counter.call(deployer, "increment", []);
       console.log(`   Transaction: ${tx.hash}`);
 
-      // Read new value
+      // counter.view is the shorter form when you already have the contract.
       const value = await counter.view<string>("get", [
-        deployer.accountAddress.toString()
+        deployer.accountAddress.toString(),
       ]);
 
       console.log(`   New counter value: ${value}`);
-
-      // Should be 1 now
       expect(parseInt(value)).to.equal(1);
     });
 
-    it("alice can also increment counter", async () => {
-      const counter = fixture.contracts.counter;
-      const alice = fixture.accounts.alice;
+    it("alice can initialize and increment her counter", async () => {
+      const initTx = await counter.call(alice, "init", []);
+      console.log(`   Alice init transaction: ${initTx.hash}`);
 
-      // Alice increments her own counter
       const tx = await counter.call(alice, "increment", []);
-      console.log(`   Alice's transaction: ${tx.hash}`);
+      console.log(`   Alice's increment transaction: ${tx.hash}`);
 
-      // Read counter value for Alice (each user has their own counter)
       const aliceValue = await counter.view<string>("get", [
-        alice.accountAddress.toString()
+        alice.accountAddress.toString(),
       ]);
 
       console.log(`   Alice's counter value: ${aliceValue}`);
       expect(parseInt(aliceValue)).to.equal(1);
 
-      // Deployer's counter should still be 1 (unchanged)
       const deployerValue = await counter.view<string>("get", [
-        fixture.accounts.deployer.accountAddress.toString()
+        deployer.accountAddress.toString(),
       ]);
 
       console.log(`   Deployer's counter value: ${deployerValue}`);
       expect(parseInt(deployerValue)).to.equal(1);
     });
 
-    it("bob can also increment the counter", async () => {
-      const counter = fixture.contracts.counter;
-      const bob = fixture.accounts.bob;
+    it("bob can initialize and increment his counter", async () => {
+      const initTx = await counter.call(bob, "init", []);
+      console.log(`   Bob init transaction: ${initTx.hash}`);
 
-      // Bob increments his own counter
       const tx = await counter.call(bob, "increment", []);
-      console.log(`   Bob's transaction: ${tx.hash}`);
+      console.log(`   Bob's increment transaction: ${tx.hash}`);
 
-      // Read counter value for Bob (each user has their own counter)
       const bobValue = await counter.view<string>("get", [
-        bob.accountAddress.toString()
+        bob.accountAddress.toString(),
       ]);
 
       console.log(`   Bob's counter value: ${bobValue}`);
@@ -107,7 +105,9 @@ describe("Counter Contract", () => {
   });
 
   after(async () => {
-    // Cleanup: Stop local node and clear account pool
-    await teardownTestFixture();
+    // harness.cleanup() stops the local node and poisons the harness —
+    // any further method call (other than cleanup itself) throws
+    // HarnessDisposedError synchronously.
+    await harness.cleanup();
   });
 });

package/dist/templates/types/movehat.d.ts

@@ -50,16 +50,10 @@ declare module 'movehat' {
     createAccount: () => Account;
     getAccount: (privateKey: string) => Account;
     getAccountByIndex: (index: number) => Account;
-    switchNetwork: (networkName: string) => Promise<void>;
+    switchNetwork: (networkName: string) => Promise<MovehatRuntime>;
   }
 
-  export function getMovehat(): Promise<MovehatRuntime>;
   export function initRuntime(configOverride?: Partial<MovehatConfig>): Promise<MovehatRuntime>;
-  export function getRuntime(): MovehatRuntime;
-
-  export const mh: {
-    readonly runtime: MovehatRuntime;
-  };
 }
 
 declare module 'movehat/helpers' {
@@ -68,12 +62,15 @@ declare module 'movehat/helpers' {
   export interface TestEnvironment {
     aptos: Aptos;
     account: Account;
-    config: any;
+    config: import('movehat').MovehatConfig;
   }
 
   export class MoveContract {
     constructor(aptos: Aptos, address: string, moduleName: string);
-    call(sender: Account, functionName: string, args: any[]): Promise<any>;
+    // args: any[] mirrors the runtime declaration — Move entry-function
+    // arguments are heterogeneous primitives validated by the Aptos SDK
+    // at submit time.
+    call(sender: Account, functionName: string, args: any[]): Promise<TransactionResult>;
     view<T>(functionName: string, args: any[]): Promise<T>;
   }
 

package/dist/types/config.d.ts

@@ -51,6 +51,14 @@ export interface LocalTestOptions {
     forkName?: string;
     forkPort?: number;
     forkResetState?: boolean;
+    /**
+     * Optional API key sent as `Authorization: Bearer <key>` on every
+     * outgoing Movement API request made by the fork's
+     * `MovementApiClient`. Use for rate-limited public endpoints or
+     * auth-gated nodes. The key stays in process memory only — not
+     * persisted to the fork's on-disk metadata.
+     */
+    forkApiKey?: string;
     autoFund?: boolean;
     defaultBalance?: number;
     autoDeploy?: readonly string[];

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAGxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAGxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}

package/dist/types/fork.d.ts

@@ -32,6 +32,12 @@ export interface AccountData {
 }
 export interface AccountResource {
     type: string;
-    data: any;
+    /**
+     * Move resource payload — structurally a JSON-shaped object whose
+     * schema depends on the resource type (CoinStore, AggregatorSnapshot, etc).
+     * unknown forces callers to narrow before access; the boundary-validation
+     * follow-up of #57 will add per-resource type guards.
+     */
+    data: unknown;
 }
 //# sourceMappingURL=fork.d.ts.map

package/dist/types/fork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/types/fork.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACX"}
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/types/fork.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/types/harness.d.ts

@@ -0,0 +1,166 @@
+import type { DeploymentInfo } from "../core/deployments.js";
+import type { ChildProcessAdapter } from "../utils/childProcessAdapter.js";
+/**
+ * Options for `harness.deployCodeObject(options)`.
+ *
+ * Wraps `movement move deploy-object`. The Movement CLI derives the
+ * destination object address from the signing account; that address is
+ * bound to `moduleName` (passed as `--address-name`) at compile time.
+ * Callers retrieve the resulting object address via the returned
+ * `CodeObjectInfo.address`.
+ */
+export interface DeployCodeObjectOptions {
+    /**
+     * Logical module identifier (the `name` part of `module addr::name`).
+     * Used as the persistence key (`deployments/{network}/{moduleName}.json`)
+     * and as the `name` arg you'd pass to `runtime.getContract(addr, name)`
+     * after deployment.
+     *
+     * If `addressName` is omitted, `moduleName` is also used as the CLI's
+     * `--address-name` flag (correct when the Move.toml's named address
+     * matches the module identifier). For packages where they differ —
+     * e.g. `module hello_blockchain::counter` (named address
+     * `hello_blockchain`, module `counter`) — set `addressName` explicitly.
+     */
+    moduleName: string;
+    /**
+     * Move.toml named address that the derived object address binds to
+     * at compile time (the `--address-name` flag of `move deploy-object`).
+     *
+     * Defaults to `moduleName`. Set this when the Move.toml's named
+     * address differs from the on-chain module identifier:
+     *
+     * ```ts
+     * // Move source: `module hello_blockchain::counter`
+     * // Move.toml:   `[addresses] hello_blockchain = "_"`
+     * await harness.deployCodeObject({
+     *   moduleName: "counter",            // for getContract + save key
+     *   addressName: "hello_blockchain",  // for --address-name
+     * });
+     * ```
+     */
+    addressName?: string;
+    /**
+     * Extra named-address overrides merged on top of the addresses
+     * auto-detected from `<packageDir>/sources/**.move`. Values here win
+     * for the matching keys; auto-detected names not present here are
+     * still pinned to the deployer address (Publisher convention).
+     */
+    namedAddresses?: Record<string, string>;
+    /**
+     * Path to the Move package. Defaults to `config.moveDir` from the
+     * harness's runtime config (usually `./move`).
+     */
+    packageDir?: string;
+    /**
+     * Artifact set written into the on-chain package. Mirrors the CLI
+     * flag. Defaults to `'sparse'` (the Movement CLI default).
+     */
+    includedArtifacts?: "none" | "sparse" | "all";
+    /**
+     * Test-only override for the child-process adapter. Production callers
+     * leave this undefined so the default spawn-based adapter is used.
+     * @internal
+     */
+    adapter?: ChildProcessAdapter;
+}
+/**
+ * Options for `harness.upgradeCodeObject(options)`.
+ *
+ * Wraps `movement move upgrade-object`. The object must already exist
+ * on-chain at `objectAddress` and have been deployed previously (typically
+ * via `deployCodeObject`).
+ */
+export interface UpgradeCodeObjectOptions extends DeployCodeObjectOptions {
+    /** Address of the existing code object to upgrade. Required. */
+    objectAddress: string;
+}
+/**
+ * Result of `deployCodeObject` / `upgradeCodeObject`.
+ *
+ * Today this is structurally identical to {@link DeploymentInfo} — the
+ * `address` field holds the derived **object address** (the value
+ * callers pass to `runtime.getContract(...)` to interact with the
+ * modules), and `deployer` is the signing account.
+ *
+ * The alias exists so future iterations can layer additional fields
+ * (e.g. an explicit `kind: 'code-object' | 'publish'` discriminator)
+ * without churning every callsite.
+ */
+export type CodeObjectInfo = DeploymentInfo;
+/**
+ * Options for `harness.runViewFunction(options)`.
+ *
+ * Delegates to the Aptos SDK's `aptos.view(...)` — no CLI invocation,
+ * no profile management. Works on `createLocal`, `createFork`, and
+ * `createLive` harnesses (view functions are read-only).
+ */
+export interface RunViewFunctionOptions {
+    /**
+     * Fully qualified Move function id, e.g. `0xCAFE::counter::get`.
+     */
+    function: string;
+    /**
+     * Move type-tag arguments, e.g. `['0x1::aptos_coin::AptosCoin']`.
+     */
+    typeArguments?: string[];
+    /**
+     * Move function arguments. SDK-validated at the boundary; pass values
+     * matching the Move function signature (strings for `address`,
+     * numbers / bigints for `u8`-`u256`, booleans, etc.).
+     */
+    functionArguments?: unknown[];
+}
+/**
+ * Options for `harness.runMoveScript(options)`.
+ *
+ * Wraps `movement move run-script`. The CLI handles compilation
+ * inline when given a `.move` source; the user can also pass a
+ * pre-compiled `.mv` bytecode file.
+ *
+ * Not available on fork-mode harnesses (forks are read-only).
+ */
+export interface RunMoveScriptOptions {
+    /**
+     * Path to the Move script. Extension determines the CLI flag:
+     *   - `.move` → `--script-path` (CLI auto-compiles)
+     *   - `.mv` → `--compiled-script-path` (user pre-compiled)
+     * Other extensions throw synchronously before any CLI call.
+     */
+    scriptPath: string;
+    /**
+     * CLI-formatted typed arguments. Movement CLI expects each arg
+     * prefixed by its Move type, e.g. `'address:0x1'`, `'u8:42'`,
+     * `'bool:true'`, `'string:hello'`. See
+     * `movement move run-script --help` for the full grammar.
+     */
+    args?: string[];
+    /**
+     * Type-tag arguments for generic scripts, e.g.
+     * `['0x1::aptos_coin::AptosCoin']`.
+     */
+    typeArgs?: string[];
+    /**
+     * Optional working directory for compilation. Most callers leave
+     * this undefined — the CLI uses the script's parent directory.
+     */
+    packageDir?: string;
+    /**
+     * Test-only override for the child-process adapter.
+     * @internal
+     */
+    adapter?: ChildProcessAdapter;
+}
+/**
+ * Result of `harness.runMoveScript`.
+ *
+ * Always carries `txHash` (parser throws if it can't extract one).
+ * `success` and `vmStatus` are best-effort: parsed from the CLI's
+ * JSON `Result` block when present, `undefined` if the parser misses.
+ */
+export interface MoveScriptResult {
+    txHash: string;
+    success?: boolean;
+    vmStatus?: string;
+}
+//# sourceMappingURL=harness.d.ts.map

package/dist/types/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/types/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAE9C;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/harness.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=harness.js.map

package/dist/types/harness.js.map

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

package/dist/types/runtime.d.ts

@@ -2,6 +2,7 @@ import { Aptos, Account } from "@aptos-labs/ts-sdk";
 import { MovehatConfig } from "./config.js";
 import { MoveContract } from "../core/contract.js";
 import { DeploymentInfo } from "../core/deployments.js";
+import type { ChildProcessAdapter } from "../utils/childProcessAdapter.js";
 export interface NetworkInfo {
     name: string;
     rpc: string;
@@ -16,6 +17,11 @@ export interface MovehatRuntime {
     getContract: (address: string, moduleName: string) => MoveContract;
     deployContract: (moduleName: string, options?: {
         packageDir?: string;
+        /**
+         * Override the child-process adapter. Test-only: production callers
+         * leave this undefined so the default spawn-based adapter is used.
+         */
+        adapter?: ChildProcessAdapter;
     }) => Promise<DeploymentInfo>;
     getDeployment: (moduleName: string) => DeploymentInfo | null;
     getDeployments: () => Record<string, DeploymentInfo>;
@@ -23,6 +29,6 @@ export interface MovehatRuntime {
     createAccount: () => Account;
     getAccount: (privateKey: string) => Account;
     getAccountByIndex: (index: number) => Account;
-    switchNetwork: (networkName: string) => Promise<void>;
+    switchNetwork: (networkName: string) => Promise<MovehatRuntime>;
 }
 //# sourceMappingURL=runtime.d.ts.map

package/dist/types/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAE7B,MAAM,EAAE,aAAa,CAAC;IAGtB,OAAO,EAAE,WAAW,CAAC;IAGrB,KAAK,EAAE,KAAK,CAAC;IAGb,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAGpB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,YAAY,CAAC;IAGnE,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IAC7D,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAG5D,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAG9C,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAE7B,MAAM,EAAE,aAAa,CAAC;IAGtB,OAAO,EAAE,WAAW,CAAC;IAGrB,KAAK,EAAE,KAAK,CAAC;IAGb,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAGpB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,YAAY,CAAC;IAGnE,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB;;;WAGG;QACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;KAC/B,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IAC7D,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAG5D,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAK9C,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACjE"}

package/dist/ui/__tests__/colors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=colors.test.d.ts.map

package/dist/ui/__tests__/colors.test.d.ts.map

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

package/dist/ui/__tests__/colors.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { shouldUseColor, colors, rgbToAnsi, applyGradient, gradients, } from '../colors.js';
+describe('shouldUseColor', () => {
+    const originalEnv = process.env;
+    const originalIsTTY = process.stdout.isTTY;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+        delete process.env.NO_COLOR;
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY });
+    });
+    it('should return true when TTY and NO_COLOR not set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        delete process.env.NO_COLOR;
+        expect(shouldUseColor()).toBe(true);
+    });
+    it('should return false when NO_COLOR is set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        process.env.NO_COLOR = '1';
+        expect(shouldUseColor()).toBe(false);
+    });
+    it('should return false when not TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
+        delete process.env.NO_COLOR;
+        expect(shouldUseColor()).toBe(false);
+    });
+});
+describe('rgbToAnsi', () => {
+    it('should generate correct ANSI escape code', () => {
+        expect(rgbToAnsi(255, 0, 0)).toBe('\x1b[38;2;255;0;0m');
+        expect(rgbToAnsi(0, 255, 0)).toBe('\x1b[38;2;0;255;0m');
+        expect(rgbToAnsi(0, 0, 255)).toBe('\x1b[38;2;0;0;255m');
+        expect(rgbToAnsi(128, 128, 128)).toBe('\x1b[38;2;128;128;128m');
+    });
+    it('should handle edge values', () => {
+        expect(rgbToAnsi(0, 0, 0)).toBe('\x1b[38;2;0;0;0m');
+        expect(rgbToAnsi(255, 255, 255)).toBe('\x1b[38;2;255;255;255m');
+    });
+});
+describe('applyGradient', () => {
+    const originalEnv = process.env;
+    const originalIsTTY = process.stdout.isTTY;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+        delete process.env.NO_COLOR;
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY });
+    });
+    it('should apply gradient to text', () => {
+        const palette = [[255, 0, 0], [0, 255, 0]];
+        const result = applyGradient('AB', palette);
+        expect(result).toContain('\x1b[38;2;255;0;0m'); // Red for 'A'
+        expect(result).toContain('\x1b[38;2;0;255;0m'); // Green for 'B'
+        expect(result).toContain('A');
+        expect(result).toContain('B');
+        expect(result).toContain('\x1b[0m'); // Reset at end
+    });
+    it('should return plain text when colors disabled', () => {
+        process.env.NO_COLOR = '1';
+        const palette = [[255, 0, 0]];
+        const result = applyGradient('Hello', palette);
+        expect(result).toBe('Hello');
+        expect(result).not.toContain('\x1b');
+    });
+    it('should cycle through palette for long text', () => {
+        const palette = [[255, 0, 0], [0, 255, 0]];
+        const result = applyGradient('ABCD', palette);
+        // Should alternate: A=red, B=green, C=red, D=green
+        expect(result).toContain('A');
+        expect(result).toContain('B');
+        expect(result).toContain('C');
+        expect(result).toContain('D');
+    });
+    it('should handle offset parameter', () => {
+        const palette = [[255, 0, 0], [0, 255, 0]];
+        const result = applyGradient('AB', palette, 1);
+        // With offset 1: A=green, B=red
+        expect(result.indexOf('\x1b[38;2;0;255;0m')).toBeLessThan(result.indexOf('\x1b[38;2;255;0;0m'));
+    });
+});
+describe('gradients', () => {
+    it('should have movehat gradient with 5 colors', () => {
+        expect(gradients.movehat).toHaveLength(5);
+        gradients.movehat.forEach(([r, g, b]) => {
+            expect(r).toBeGreaterThanOrEqual(0);
+            expect(r).toBeLessThanOrEqual(255);
+            expect(g).toBeGreaterThanOrEqual(0);
+            expect(g).toBeLessThanOrEqual(255);
+            expect(b).toBeGreaterThanOrEqual(0);
+            expect(b).toBeLessThanOrEqual(255);
+        });
+    });
+    it('should have success gradient', () => {
+        expect(gradients.success).toBeDefined();
+        expect(gradients.success.length).toBeGreaterThan(0);
+    });
+    it('should have error gradient', () => {
+        expect(gradients.error).toBeDefined();
+        expect(gradients.error.length).toBeGreaterThan(0);
+    });
+});
+describe('colors object', () => {
+    it('should have all semantic color functions', () => {
+        expect(typeof colors.success).toBe('function');
+        expect(typeof colors.error).toBe('function');
+        expect(typeof colors.warning).toBe('function');
+        expect(typeof colors.info).toBe('function');
+        expect(typeof colors.primary).toBe('function');
+        expect(typeof colors.secondary).toBe('function');
+        expect(typeof colors.muted).toBe('function');
+        expect(typeof colors.dim).toBe('function');
+        expect(typeof colors.bold).toBe('function');
+        expect(typeof colors.brand).toBe('function');
+        expect(typeof colors.brandBright).toBe('function');
+    });
+    it('should return strings when called', () => {
+        expect(typeof colors.success('test')).toBe('string');
+        expect(typeof colors.error('test')).toBe('string');
+        expect(typeof colors.brand('test')).toBe('string');
+    });
+});
+//# sourceMappingURL=colors.test.js.map

package/dist/ui/__tests__/colors.test.js.map

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

package/dist/ui/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,OAEjC,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,MAAM;mBARM,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;qBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;eAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;uBAAjB,MAAM,KAAK,MAAM;;8BAdtB,CAAC;;CA0CpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAE3D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,SAAS,GAAG,EAAE,EACd,SAAQ,MAAU,KACjB,MAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;aAOE,GAAG,EAAE;IAEV;;;OAGG;aAKE,GAAG,EAAE;IAEV;;;OAGG;WAKE,GAAG,EAAE;CACX,CAAC"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,OAEjC,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,MAAM;mBARM,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;qBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;eAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;uBAAjB,MAAM,KAAK,MAAM;;8BAdtB,CAAC;;CA0CpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAE3D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,SAAS,GAAG,EAAE,EACd,SAAQ,MAAU,KACjB,MAaF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;aAOE,GAAG,EAAE;IAEV;;;OAGG;aAKE,GAAG,EAAE;IAEV;;;OAGG;WAKE,GAAG,EAAE;CACX,CAAC"}

package/dist/ui/colors.js

@@ -69,8 +69,12 @@ export const applyGradient = (text, palette, offset = 0) => {
     let result = '';
     for (let i = 0; i < text.length; i++) {
         const colorIndex = (i + offset) % palette.length;
-        const [r, g, b] = palette[colorIndex];
-        result += `${rgbToAnsi(r, g, b)}${text[i]}`;
+        const color = palette[colorIndex];
+        const ch = text[i];
+        if (!color || ch === undefined)
+            continue;
+        const [r, g, b] = color;
+        result += `${rgbToAnsi(r, g, b)}${ch}`;
     }
     return result + '\x1b[0m';
 };