arc402-cli 0.4.3 → 0.5.0

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAU3E;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAY3E;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvF"}

package/dist/client.js

@@ -10,7 +10,9 @@ async function getClient(config) {
         const address = await signer.getAddress();
         return { provider, signer, address };
     }
-    return { provider, signer: null, address: null };
+    // No private key — use walletContractAddress for read-only operations
+    const address = config.walletContractAddress ?? null;
+    return { provider, signer: null, address };
 }
 async function requireSigner(config) {
     const { provider, signer } = await getClient(config);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;AASA,8BAUC;AAED,sCAYC;AAjCD,mCAAgC;AASzB,KAAK,UAAU,SAAS,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,IAAI,eAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,MAAoB;IAEpB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,gFAAgF,CACjF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;AASA,8BAYC;AAED,sCAYC;AAnCD,mCAAgC;AASzB,KAAK,UAAU,SAAS,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,IAAI,eAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,sEAAsE;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,qBAAqB,IAAI,IAAI,CAAC;IACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,MAAoB;IAEpB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,gFAAgF,CACjF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC"}

package/dist/index.js

@@ -1,118 +1,15 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const accept_1 = require("./commands/accept");
-const agent_1 = require("./commands/agent");
-const agreements_1 = require("./commands/agreements");
-const arbitrator_1 = require("./commands/arbitrator");
-const cancel_1 = require("./commands/cancel");
-const channel_1 = require("./commands/channel");
-const config_1 = require("./commands/config");
-const deliver_1 = require("./commands/deliver");
-const discover_1 = require("./commands/discover");
-const endpoint_1 = require("./commands/endpoint");
-const dispute_1 = require("./commands/dispute");
-const hire_1 = require("./commands/hire");
-const agent_handshake_1 = require("./commands/agent-handshake");
-const negotiate_1 = require("./commands/negotiate");
-const relay_1 = require("./commands/relay");
-const remediate_1 = require("./commands/remediate");
-const daemon_1 = require("./commands/daemon");
-const openshell_1 = require("./commands/openshell");
-const workroom_1 = require("./commands/workroom");
-const arena_handshake_1 = require("./commands/arena-handshake");
-const trust_1 = require("./commands/trust");
-const wallet_1 = require("./commands/wallet");
-const banner_1 = require("./ui/banner");
-const owner_1 = require("./commands/owner");
-const setup_1 = require("./commands/setup");
-const verify_1 = require("./commands/verify");
-const contract_interaction_1 = require("./commands/contract-interaction");
-const watchtower_1 = require("./commands/watchtower");
-const coldstart_1 = require("./commands/coldstart");
-const migrate_1 = require("./commands/migrate");
-const feed_1 = require("./commands/feed");
-const arena_1 = require("./commands/arena");
-const watch_1 = require("./commands/watch");
-const reputation_js_1 = __importDefault(require("./commands/reputation.js"));
-const policy_js_1 = __importDefault(require("./commands/policy.js"));
-// Show banner when invoked with no arguments
+const program_1 = require("./program");
+const repl_1 = require("./repl");
 if (process.argv.length <= 2) {
-    void (async () => {
-        const CONFIG_PATH = path_1.default.join(os_1.default.homedir(), ".arc402", "config.json");
-        let bannerCfg;
-        if (fs_1.default.existsSync(CONFIG_PATH)) {
-            try {
-                const raw = JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
-                bannerCfg = { network: raw.network };
-                if (raw.walletContractAddress) {
-                    const w = raw.walletContractAddress;
-                    bannerCfg.wallet = `${w.slice(0, 6)}...${w.slice(-4)}`;
-                }
-                if (raw.rpcUrl && raw.walletContractAddress) {
-                    try {
-                        // eslint-disable-next-line @typescript-eslint/no-var-requires
-                        const ethersLib = require("ethers");
-                        const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
-                        const bal = await Promise.race([
-                            provider.getBalance(raw.walletContractAddress),
-                            new Promise((_, r) => setTimeout(() => r(new Error("timeout")), 2000)),
-                        ]);
-                        bannerCfg.balance = `${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`;
-                    }
-                    catch { /* skip balance on error/timeout */ }
-                }
-            }
-            catch { /* skip config info on parse error */ }
-        }
-        (0, banner_1.renderBanner)(bannerCfg);
-        process.exit(0);
-    })();
+    // No subcommand — enter interactive REPL
+    void (0, repl_1.startREPL)();
 }
 else {
-    const program = new commander_1.Command();
-    program.name("arc402").description("ARC-402 CLI aligned to canonical-capability discovery → negotiate → hire → remediate → dispute workflow").version(require("../package.json").version);
-    (0, config_1.registerConfigCommands)(program);
-    (0, agent_handshake_1.registerHandshakeCommand)(program);
-    (0, agent_1.registerAgentCommands)(program);
-    (0, discover_1.registerDiscoverCommand)(program);
-    (0, endpoint_1.registerEndpointCommands)(program);
-    (0, negotiate_1.registerNegotiateCommands)(program);
-    (0, hire_1.registerHireCommand)(program);
-    (0, agreements_1.registerAgreementsCommands)(program);
-    (0, accept_1.registerAcceptCommand)(program);
-    (0, deliver_1.registerDeliverCommand)(program);
-    (0, remediate_1.registerRemediateCommands)(program);
-    (0, dispute_1.registerDisputeCommand)(program);
-    (0, arbitrator_1.registerArbitratorCommand)(program);
-    (0, cancel_1.registerCancelCommand)(program);
-    (0, channel_1.registerChannelCommands)(program);
-    (0, relay_1.registerRelayCommands)(program);
-    (0, daemon_1.registerDaemonCommands)(program);
-    (0, openshell_1.registerOpenShellCommands)(program);
-    (0, workroom_1.registerWorkroomCommands)(program);
-    (0, arena_handshake_1.registerArenaHandshakeCommands)(program);
-    (0, trust_1.registerTrustCommand)(program);
-    (0, wallet_1.registerWalletCommands)(program);
-    (0, owner_1.registerOwnerCommands)(program);
-    (0, setup_1.registerSetupCommands)(program);
-    (0, verify_1.registerVerifyCommand)(program);
-    (0, contract_interaction_1.registerContractInteractionCommands)(program);
-    (0, watchtower_1.registerWatchtowerCommands)(program);
-    (0, coldstart_1.registerColdStartCommands)(program);
-    (0, migrate_1.registerMigrateCommands)(program);
-    (0, feed_1.registerFeedCommand)(program);
-    (0, arena_1.registerArenaCommands)(program);
-    (0, watch_1.registerWatchCommand)(program);
-    program.addCommand(reputation_js_1.default);
-    program.addCommand(policy_js_1.default);
+    // One-shot mode — arc402 wallet deploy still works as usual
+    const program = (0, program_1.createProgram)();
     program.parse(process.argv);
-} // end else (has arguments)
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uCAA0C;AAC1C,iCAAmC;AAEnC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAC7B,yCAAyC;IACzC,KAAK,IAAA,gBAAS,GAAE,CAAC;AACnB,CAAC;KAAM,CAAC;IACN,4DAA4D;IAC5D,MAAM,OAAO,GAAG,IAAA,uBAAa,GAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createProgram(): Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,wBAAgB,aAAa,IAAI,OAAO,CA8CvC"}

package/dist/program.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+const commander_1 = require("commander");
+const accept_1 = require("./commands/accept");
+const agent_1 = require("./commands/agent");
+const agreements_1 = require("./commands/agreements");
+const arbitrator_1 = require("./commands/arbitrator");
+const cancel_1 = require("./commands/cancel");
+const channel_1 = require("./commands/channel");
+const config_1 = require("./commands/config");
+const deliver_1 = require("./commands/deliver");
+const discover_1 = require("./commands/discover");
+const endpoint_1 = require("./commands/endpoint");
+const dispute_1 = require("./commands/dispute");
+const hire_1 = require("./commands/hire");
+const agent_handshake_1 = require("./commands/agent-handshake");
+const negotiate_1 = require("./commands/negotiate");
+const relay_1 = require("./commands/relay");
+const remediate_1 = require("./commands/remediate");
+const daemon_1 = require("./commands/daemon");
+const openshell_1 = require("./commands/openshell");
+const workroom_1 = require("./commands/workroom");
+const arena_handshake_1 = require("./commands/arena-handshake");
+const trust_1 = require("./commands/trust");
+const wallet_1 = require("./commands/wallet");
+const owner_1 = require("./commands/owner");
+const setup_1 = require("./commands/setup");
+const verify_1 = require("./commands/verify");
+const contract_interaction_1 = require("./commands/contract-interaction");
+const watchtower_1 = require("./commands/watchtower");
+const coldstart_1 = require("./commands/coldstart");
+const migrate_1 = require("./commands/migrate");
+const feed_1 = require("./commands/feed");
+const arena_1 = require("./commands/arena");
+const watch_1 = require("./commands/watch");
+const reputation_js_1 = __importDefault(require("./commands/reputation.js"));
+const policy_js_1 = __importDefault(require("./commands/policy.js"));
+function createProgram() {
+    const program = new commander_1.Command();
+    program
+        .name("arc402")
+        .description("ARC-402 CLI aligned to canonical-capability discovery → negotiate → hire → remediate → dispute workflow")
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        .version(require("../package.json").version);
+    (0, config_1.registerConfigCommands)(program);
+    (0, agent_handshake_1.registerHandshakeCommand)(program);
+    (0, agent_1.registerAgentCommands)(program);
+    (0, discover_1.registerDiscoverCommand)(program);
+    (0, endpoint_1.registerEndpointCommands)(program);
+    (0, negotiate_1.registerNegotiateCommands)(program);
+    (0, hire_1.registerHireCommand)(program);
+    (0, agreements_1.registerAgreementsCommands)(program);
+    (0, accept_1.registerAcceptCommand)(program);
+    (0, deliver_1.registerDeliverCommand)(program);
+    (0, remediate_1.registerRemediateCommands)(program);
+    (0, dispute_1.registerDisputeCommand)(program);
+    (0, arbitrator_1.registerArbitratorCommand)(program);
+    (0, cancel_1.registerCancelCommand)(program);
+    (0, channel_1.registerChannelCommands)(program);
+    (0, relay_1.registerRelayCommands)(program);
+    (0, daemon_1.registerDaemonCommands)(program);
+    (0, openshell_1.registerOpenShellCommands)(program);
+    (0, workroom_1.registerWorkroomCommands)(program);
+    (0, arena_handshake_1.registerArenaHandshakeCommands)(program);
+    (0, trust_1.registerTrustCommand)(program);
+    (0, wallet_1.registerWalletCommands)(program);
+    (0, owner_1.registerOwnerCommands)(program);
+    (0, setup_1.registerSetupCommands)(program);
+    (0, verify_1.registerVerifyCommand)(program);
+    (0, contract_interaction_1.registerContractInteractionCommands)(program);
+    (0, watchtower_1.registerWatchtowerCommands)(program);
+    (0, coldstart_1.registerColdStartCommands)(program);
+    (0, migrate_1.registerMigrateCommands)(program);
+    (0, feed_1.registerFeedCommand)(program);
+    (0, arena_1.registerArenaCommands)(program);
+    (0, watch_1.registerWatchCommand)(program);
+    program.addCommand(reputation_js_1.default);
+    program.addCommand(policy_js_1.default);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":";;;;;AAoCA,sCA8CC;AAlFD,yCAAoC;AACpC,8CAA0D;AAC1D,4CAAyD;AACzD,sDAAmE;AACnE,sDAAkE;AAClE,8CAA0D;AAC1D,gDAA6D;AAC7D,8CAA2D;AAC3D,gDAA4D;AAC5D,kDAA8D;AAC9D,kDAA+D;AAC/D,gDAA4D;AAC5D,0CAAsD;AACtD,gEAAsE;AACtE,oDAAiE;AACjE,4CAAyD;AACzD,oDAAiE;AACjE,8CAA2D;AAC3D,oDAAiE;AACjE,kDAA+D;AAC/D,gEAA4E;AAC5E,4CAAwD;AACxD,8CAA2D;AAC3D,4CAAyD;AACzD,4CAAyD;AACzD,8CAA0D;AAC1D,0EAAsF;AACtF,sDAAmE;AACnE,oDAAiE;AACjE,gDAA6D;AAC7D,0CAAsD;AACtD,4CAAyD;AACzD,4CAAwD;AACxD,6EAAkD;AAClD,qEAA0C;AAE1C,SAAgB,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CACV,yGAAyG,CAC1G;QACD,8DAA8D;SAC7D,OAAO,CAAE,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC,CAAC;IAExE,IAAA,+BAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,0CAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,qCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,uCAA0B,EAAC,OAAO,CAAC,CAAC;IACpC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,qCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,iCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,+BAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,qCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,gDAA8B,EAAC,OAAO,CAAC,CAAC;IACxC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,+BAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,0DAAmC,EAAC,OAAO,CAAC,CAAC;IAC7C,IAAA,uCAA0B,EAAC,OAAO,CAAC,CAAC;IACpC,IAAA,qCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,iCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,UAAU,CAAC,uBAAU,CAAC,CAAC;IAC/B,OAAO,CAAC,UAAU,CAAC,mBAAM,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,2 @@
+export declare function startREPL(): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AA0LA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA6I/C"}

package/dist/repl.js

@@ -0,0 +1,277 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startREPL = startREPL;
+const node_readline_1 = __importDefault(require("node:readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const program_1 = require("./program");
+const banner_1 = require("./ui/banner");
+const colors_1 = require("./ui/colors");
+// ─── Prompt ───────────────────────────────────────────────────────────────────
+const PROMPT = chalk_1.default.cyanBright("◈") +
+    " " +
+    chalk_1.default.dim("arc402") +
+    " " +
+    chalk_1.default.white(">") +
+    " ";
+// ─── Sentinel thrown to intercept process.exit() from commands ───────────────
+class REPLExitSignal extends Error {
+    constructor(code = 0) {
+        super("repl-exit-signal");
+        this.code = code;
+    }
+}
+// ─── Config / banner helpers ──────────────────────────────────────────────────
+const CONFIG_PATH = path_1.default.join(os_1.default.homedir(), ".arc402", "config.json");
+async function loadBannerConfig() {
+    if (!fs_1.default.existsSync(CONFIG_PATH))
+        return undefined;
+    try {
+        const raw = JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
+        const cfg = { network: raw.network };
+        if (raw.walletContractAddress) {
+            const w = raw.walletContractAddress;
+            cfg.wallet = `${w.slice(0, 6)}...${w.slice(-4)}`;
+        }
+        if (raw.rpcUrl && raw.walletContractAddress) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const ethersLib = require("ethers");
+                const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
+                const bal = await Promise.race([
+                    provider.getBalance(raw.walletContractAddress),
+                    new Promise((_, r) => setTimeout(() => r(new Error("timeout")), 2000)),
+                ]);
+                cfg.balance = `${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`;
+            }
+            catch {
+                /* skip balance on timeout */
+            }
+        }
+        return cfg;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ─── Status dashboard ─────────────────────────────────────────────────────────
+async function showStatus() {
+    console.log();
+    console.log(" " + chalk_1.default.cyanBright("◈") + " " + chalk_1.default.dim("─".repeat(45)));
+    if (!fs_1.default.existsSync(CONFIG_PATH)) {
+        console.log(chalk_1.default.dim("  No config found. Run 'config init' to get started."));
+        console.log();
+        return;
+    }
+    try {
+        const raw = JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
+        if (raw.network)
+            console.log(` ${chalk_1.default.dim("Network")}   ${chalk_1.default.white(raw.network)}`);
+        if (raw.walletContractAddress) {
+            const w = raw.walletContractAddress;
+            console.log(` ${chalk_1.default.dim("Wallet")}    ${chalk_1.default.white(`${w.slice(0, 6)}...${w.slice(-4)}`)}`);
+        }
+        if (raw.rpcUrl && raw.walletContractAddress) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const ethersLib = require("ethers");
+                const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
+                const bal = await Promise.race([
+                    provider.getBalance(raw.walletContractAddress),
+                    new Promise((_, r) => setTimeout(() => r(new Error("timeout")), 2000)),
+                ]);
+                console.log(` ${chalk_1.default.dim("Balance")}   ${chalk_1.default.white(`${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`)}`);
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    catch {
+        /* skip */
+    }
+    console.log();
+}
+// ─── Shell-style tokenizer (handles "quoted strings") ────────────────────────
+function parseTokens(input) {
+    const tokens = [];
+    let current = "";
+    let inQuote = false;
+    let quoteChar = "";
+    for (const ch of input) {
+        if (inQuote) {
+            if (ch === quoteChar) {
+                inQuote = false;
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"' || ch === "'") {
+            inQuote = true;
+            quoteChar = ch;
+        }
+        else if (ch === " ") {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        tokens.push(current);
+    return tokens;
+}
+// ─── Tab completer ────────────────────────────────────────────────────────────
+function buildCompleter(topCmds, subCmds) {
+    const specialCmds = ["help", "exit", "quit", "clear", "status"];
+    const allTop = [...specialCmds, ...topCmds];
+    return function completer(line) {
+        const trimmed = line.trimStart();
+        const spaceIdx = trimmed.indexOf(" ");
+        if (spaceIdx === -1) {
+            // Completing the first word (top-level command)
+            const hits = allTop.filter((cmd) => cmd.startsWith(trimmed));
+            return [hits.length ? hits : allTop, trimmed];
+        }
+        // Completing a subcommand
+        const parent = trimmed.slice(0, spaceIdx);
+        const rest = trimmed.slice(spaceIdx + 1);
+        const subs = subCmds.get(parent) ?? [];
+        const hits = subs.filter((s) => s.startsWith(rest));
+        return [
+            hits.map((s) => `${parent} ${s}`),
+            trimmed,
+        ];
+    };
+}
+// ─── REPL entry point ─────────────────────────────────────────────────────────
+async function startREPL() {
+    // Show the banner
+    const bannerCfg = await loadBannerConfig();
+    (0, banner_1.renderBanner)(bannerCfg);
+    // Build a template program once just to extract command metadata for completions
+    const template = (0, program_1.createProgram)();
+    const topCmds = template.commands.map((cmd) => cmd.name());
+    const subCmds = new Map();
+    for (const cmd of template.commands) {
+        if (cmd.commands.length > 0) {
+            subCmds.set(cmd.name(), cmd.commands.map((s) => s.name()));
+        }
+    }
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: PROMPT,
+        completer: buildCompleter(topCmds, subCmds),
+        terminal: true,
+        historySize: 200,
+    });
+    function goodbye() {
+        console.log("\n " + chalk_1.default.cyanBright("◈") + chalk_1.default.dim(" goodbye"));
+    }
+    rl.on("SIGINT", () => {
+        goodbye();
+        rl.close();
+        process.exit(0);
+    });
+    rl.on("close", () => {
+        goodbye();
+        process.exit(0);
+    });
+    rl.prompt();
+    // Process lines one at a time
+    for await (const line of rl) {
+        const input = line.trim();
+        if (!input) {
+            rl.prompt();
+            continue;
+        }
+        // ── Special built-in commands ──────────────────────────────────────────
+        if (input === "exit" || input === "quit") {
+            goodbye();
+            rl.close();
+            process.exit(0);
+        }
+        if (input === "clear") {
+            console.clear();
+            const cfg = await loadBannerConfig();
+            (0, banner_1.renderBanner)(cfg);
+            rl.prompt();
+            continue;
+        }
+        if (input === "status") {
+            await showStatus();
+            rl.prompt();
+            continue;
+        }
+        if (input === "help" || input === "help ") {
+            // Show the full commander help via the program
+            const prog = (0, program_1.createProgram)();
+            prog.exitOverride();
+            prog.configureOutput({
+                writeOut: (str) => process.stdout.write(str),
+                writeErr: (str) => process.stderr.write(str),
+            });
+            try {
+                await prog.parseAsync(["node", "arc402", "--help"]);
+            }
+            catch {
+                /* commander throws after printing help — ignore */
+            }
+            rl.prompt();
+            continue;
+        }
+        // ── Dispatch to commander ──────────────────────────────────────────────
+        const tokens = parseTokens(input);
+        const prog = (0, program_1.createProgram)();
+        prog.exitOverride();
+        prog.configureOutput({
+            writeOut: (str) => process.stdout.write(str),
+            writeErr: (str) => process.stderr.write(str),
+        });
+        // Intercept process.exit() so a command exiting doesn't kill the REPL
+        const origExit = process.exit;
+        process.exit = ((code) => {
+            throw new REPLExitSignal(code ?? 0);
+        });
+        try {
+            await prog.parseAsync(["node", "arc402", ...tokens]);
+        }
+        catch (err) {
+            if (err instanceof REPLExitSignal) {
+                // Command called process.exit() — normal, just continue the REPL
+            }
+            else {
+                const e = err;
+                if (e.code === "commander.helpDisplayed" ||
+                    e.code === "commander.version") {
+                    // Help / version output was already written — nothing to do
+                }
+                else if (e.code === "commander.unknownCommand") {
+                    console.log(`\n ${colors_1.c.failure} ${chalk_1.default.red(`Unknown command: ${chalk_1.default.white(tokens[0])}`)}`);
+                    console.log(chalk_1.default.dim("  Type 'help' for available commands\n"));
+                }
+                else if (e.code?.startsWith("commander.")) {
+                    console.log(`\n ${colors_1.c.failure} ${chalk_1.default.red(e.message ?? String(err))}\n`);
+                }
+                else {
+                    console.log(`\n ${colors_1.c.failure} ${chalk_1.default.red(e.message ?? String(err))}\n`);
+                }
+            }
+        }
+        finally {
+            process.exit = origExit;
+        }
+        rl.prompt();
+    }
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arc402-cli",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "ARC-402 CLI for discovery, negotiation payloads, hire/remediation/dispute workflows, and network reads",
   "bin": {
     "arc402": "./dist/index.js"

package/src/client.ts

@@ -16,7 +16,9 @@ export async function getClient(config: Arc402Config): Promise<Arc402Client> {
     return { provider, signer, address };
   }
 
-  return { provider, signer: null, address: null };
+  // No private key — use walletContractAddress for read-only operations
+  const address = config.walletContractAddress ?? null;
+  return { provider, signer: null, address };
 }
 
 export async function requireSigner(

package/src/index.ts

@@ -1,119 +1,12 @@
 #!/usr/bin/env node
-import { Command } from "commander";
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { registerAcceptCommand } from "./commands/accept";
-import { registerAgentCommands } from "./commands/agent";
-import { registerAgreementsCommands } from "./commands/agreements";
-import { registerArbitratorCommand } from "./commands/arbitrator";
-import { registerCancelCommand } from "./commands/cancel";
-import { registerChannelCommands } from "./commands/channel";
-import { registerConfigCommands } from "./commands/config";
-import { registerDeliverCommand } from "./commands/deliver";
-import { registerDiscoverCommand } from "./commands/discover";
-import { registerEndpointCommands } from "./commands/endpoint";
-import { registerDisputeCommand } from "./commands/dispute";
-import { registerHireCommand } from "./commands/hire";
-import { registerHandshakeCommand } from "./commands/agent-handshake";
-import { registerNegotiateCommands } from "./commands/negotiate";
-import { registerRelayCommands } from "./commands/relay";
-import { registerRemediateCommands } from "./commands/remediate";
-import { registerDaemonCommands } from "./commands/daemon";
-import { registerOpenShellCommands } from "./commands/openshell";
-import { registerWorkroomCommands } from "./commands/workroom";
-import { registerArenaHandshakeCommands } from "./commands/arena-handshake";
-import { registerTrustCommand } from "./commands/trust";
-import { registerWalletCommands } from "./commands/wallet";
-import { renderBanner } from "./ui/banner";
-import { registerOwnerCommands } from "./commands/owner";
-import { registerSetupCommands } from "./commands/setup";
-import { registerVerifyCommand } from "./commands/verify";
-import { registerContractInteractionCommands } from "./commands/contract-interaction";
-import { registerWatchtowerCommands } from "./commands/watchtower";
-import { registerColdStartCommands } from "./commands/coldstart";
-import { registerMigrateCommands } from "./commands/migrate";
-import { registerFeedCommand } from "./commands/feed";
-import { registerArenaCommands } from "./commands/arena";
-import { registerWatchCommand } from "./commands/watch";
-import reputation from "./commands/reputation.js";
-import policy from "./commands/policy.js";
-import { BannerConfig } from "./ui/banner";
+import { createProgram } from "./program";
+import { startREPL } from "./repl";
 
-// Show banner when invoked with no arguments
 if (process.argv.length <= 2) {
-  void (async () => {
-    const CONFIG_PATH = path.join(os.homedir(), ".arc402", "config.json");
-    let bannerCfg: BannerConfig | undefined;
-
-    if (fs.existsSync(CONFIG_PATH)) {
-      try {
-        const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8")) as {
-          network?: string;
-          walletContractAddress?: string;
-          rpcUrl?: string;
-        };
-        bannerCfg = { network: raw.network };
-        if (raw.walletContractAddress) {
-          const w = raw.walletContractAddress;
-          bannerCfg.wallet = `${w.slice(0, 6)}...${w.slice(-4)}`;
-        }
-        if (raw.rpcUrl && raw.walletContractAddress) {
-          try {
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const ethersLib = require("ethers") as typeof import("ethers");
-            const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
-            const bal = await Promise.race([
-              provider.getBalance(raw.walletContractAddress),
-              new Promise<never>((_, r) => setTimeout(() => r(new Error("timeout")), 2000)),
-            ]);
-            bannerCfg.balance = `${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`;
-          } catch { /* skip balance on error/timeout */ }
-        }
-      } catch { /* skip config info on parse error */ }
-    }
-
-    renderBanner(bannerCfg);
-    process.exit(0);
-  })();
+  // No subcommand — enter interactive REPL
+  void startREPL();
 } else {
-
-const program = new Command();
-program.name("arc402").description("ARC-402 CLI aligned to canonical-capability discovery → negotiate → hire → remediate → dispute workflow").version(require("../package.json").version);
-registerConfigCommands(program);
-registerHandshakeCommand(program);
-registerAgentCommands(program);
-registerDiscoverCommand(program);
-registerEndpointCommands(program);
-registerNegotiateCommands(program);
-registerHireCommand(program);
-registerAgreementsCommands(program);
-registerAcceptCommand(program);
-registerDeliverCommand(program);
-registerRemediateCommands(program);
-registerDisputeCommand(program);
-registerArbitratorCommand(program);
-registerCancelCommand(program);
-registerChannelCommands(program);
-registerRelayCommands(program);
-registerDaemonCommands(program);
-registerOpenShellCommands(program);
-registerWorkroomCommands(program);
-registerArenaHandshakeCommands(program);
-registerTrustCommand(program);
-registerWalletCommands(program);
-registerOwnerCommands(program);
-registerSetupCommands(program);
-registerVerifyCommand(program);
-registerContractInteractionCommands(program);
-registerWatchtowerCommands(program);
-registerColdStartCommands(program);
-registerMigrateCommands(program);
-registerFeedCommand(program);
-registerArenaCommands(program);
-registerWatchCommand(program);
-program.addCommand(reputation);
-program.addCommand(policy);
-program.parse(process.argv);
-
-} // end else (has arguments)
+  // One-shot mode — arc402 wallet deploy still works as usual
+  const program = createProgram();
+  program.parse(process.argv);
+}

package/src/program.ts

@@ -0,0 +1,83 @@
+import { Command } from "commander";
+import { registerAcceptCommand } from "./commands/accept";
+import { registerAgentCommands } from "./commands/agent";
+import { registerAgreementsCommands } from "./commands/agreements";
+import { registerArbitratorCommand } from "./commands/arbitrator";
+import { registerCancelCommand } from "./commands/cancel";
+import { registerChannelCommands } from "./commands/channel";
+import { registerConfigCommands } from "./commands/config";
+import { registerDeliverCommand } from "./commands/deliver";
+import { registerDiscoverCommand } from "./commands/discover";
+import { registerEndpointCommands } from "./commands/endpoint";
+import { registerDisputeCommand } from "./commands/dispute";
+import { registerHireCommand } from "./commands/hire";
+import { registerHandshakeCommand } from "./commands/agent-handshake";
+import { registerNegotiateCommands } from "./commands/negotiate";
+import { registerRelayCommands } from "./commands/relay";
+import { registerRemediateCommands } from "./commands/remediate";
+import { registerDaemonCommands } from "./commands/daemon";
+import { registerOpenShellCommands } from "./commands/openshell";
+import { registerWorkroomCommands } from "./commands/workroom";
+import { registerArenaHandshakeCommands } from "./commands/arena-handshake";
+import { registerTrustCommand } from "./commands/trust";
+import { registerWalletCommands } from "./commands/wallet";
+import { registerOwnerCommands } from "./commands/owner";
+import { registerSetupCommands } from "./commands/setup";
+import { registerVerifyCommand } from "./commands/verify";
+import { registerContractInteractionCommands } from "./commands/contract-interaction";
+import { registerWatchtowerCommands } from "./commands/watchtower";
+import { registerColdStartCommands } from "./commands/coldstart";
+import { registerMigrateCommands } from "./commands/migrate";
+import { registerFeedCommand } from "./commands/feed";
+import { registerArenaCommands } from "./commands/arena";
+import { registerWatchCommand } from "./commands/watch";
+import reputation from "./commands/reputation.js";
+import policy from "./commands/policy.js";
+
+export function createProgram(): Command {
+  const program = new Command();
+  program
+    .name("arc402")
+    .description(
+      "ARC-402 CLI aligned to canonical-capability discovery → negotiate → hire → remediate → dispute workflow"
+    )
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    .version((require("../package.json") as { version: string }).version);
+
+  registerConfigCommands(program);
+  registerHandshakeCommand(program);
+  registerAgentCommands(program);
+  registerDiscoverCommand(program);
+  registerEndpointCommands(program);
+  registerNegotiateCommands(program);
+  registerHireCommand(program);
+  registerAgreementsCommands(program);
+  registerAcceptCommand(program);
+  registerDeliverCommand(program);
+  registerRemediateCommands(program);
+  registerDisputeCommand(program);
+  registerArbitratorCommand(program);
+  registerCancelCommand(program);
+  registerChannelCommands(program);
+  registerRelayCommands(program);
+  registerDaemonCommands(program);
+  registerOpenShellCommands(program);
+  registerWorkroomCommands(program);
+  registerArenaHandshakeCommands(program);
+  registerTrustCommand(program);
+  registerWalletCommands(program);
+  registerOwnerCommands(program);
+  registerSetupCommands(program);
+  registerVerifyCommand(program);
+  registerContractInteractionCommands(program);
+  registerWatchtowerCommands(program);
+  registerColdStartCommands(program);
+  registerMigrateCommands(program);
+  registerFeedCommand(program);
+  registerArenaCommands(program);
+  registerWatchCommand(program);
+  program.addCommand(reputation);
+  program.addCommand(policy);
+
+  return program;
+}

package/src/repl.ts

@@ -0,0 +1,328 @@
+import readline from "node:readline";
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { createProgram } from "./program";
+import { renderBanner, BannerConfig } from "./ui/banner";
+import { c } from "./ui/colors";
+
+// ─── Prompt ───────────────────────────────────────────────────────────────────
+
+const PROMPT =
+  chalk.cyanBright("◈") +
+  " " +
+  chalk.dim("arc402") +
+  " " +
+  chalk.white(">") +
+  " ";
+
+// ─── Sentinel thrown to intercept process.exit() from commands ───────────────
+
+class REPLExitSignal extends Error {
+  constructor(public readonly code: number = 0) {
+    super("repl-exit-signal");
+  }
+}
+
+// ─── Config / banner helpers ──────────────────────────────────────────────────
+
+const CONFIG_PATH = path.join(os.homedir(), ".arc402", "config.json");
+
+async function loadBannerConfig(): Promise<BannerConfig | undefined> {
+  if (!fs.existsSync(CONFIG_PATH)) return undefined;
+  try {
+    const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8")) as {
+      network?: string;
+      walletContractAddress?: string;
+      rpcUrl?: string;
+    };
+    const cfg: BannerConfig = { network: raw.network };
+    if (raw.walletContractAddress) {
+      const w = raw.walletContractAddress;
+      cfg.wallet = `${w.slice(0, 6)}...${w.slice(-4)}`;
+    }
+    if (raw.rpcUrl && raw.walletContractAddress) {
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ethersLib = require("ethers") as typeof import("ethers");
+        const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
+        const bal = await Promise.race([
+          provider.getBalance(raw.walletContractAddress),
+          new Promise<never>((_, r) =>
+            setTimeout(() => r(new Error("timeout")), 2000)
+          ),
+        ]);
+        cfg.balance = `${parseFloat(
+          ethersLib.ethers.formatEther(bal)
+        ).toFixed(4)} ETH`;
+      } catch {
+        /* skip balance on timeout */
+      }
+    }
+    return cfg;
+  } catch {
+    return undefined;
+  }
+}
+
+// ─── Status dashboard ─────────────────────────────────────────────────────────
+
+async function showStatus(): Promise<void> {
+  console.log();
+  console.log(
+    " " + chalk.cyanBright("◈") + " " + chalk.dim("─".repeat(45))
+  );
+  if (!fs.existsSync(CONFIG_PATH)) {
+    console.log(
+      chalk.dim("  No config found. Run 'config init' to get started.")
+    );
+    console.log();
+    return;
+  }
+  try {
+    const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8")) as {
+      network?: string;
+      walletContractAddress?: string;
+      rpcUrl?: string;
+    };
+    if (raw.network)
+      console.log(` ${chalk.dim("Network")}   ${chalk.white(raw.network)}`);
+    if (raw.walletContractAddress) {
+      const w = raw.walletContractAddress;
+      console.log(
+        ` ${chalk.dim("Wallet")}    ${chalk.white(`${w.slice(0, 6)}...${w.slice(-4)}`)}`
+      );
+    }
+    if (raw.rpcUrl && raw.walletContractAddress) {
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ethersLib = require("ethers") as typeof import("ethers");
+        const provider = new ethersLib.ethers.JsonRpcProvider(raw.rpcUrl);
+        const bal = await Promise.race([
+          provider.getBalance(raw.walletContractAddress),
+          new Promise<never>((_, r) =>
+            setTimeout(() => r(new Error("timeout")), 2000)
+          ),
+        ]);
+        console.log(
+          ` ${chalk.dim("Balance")}   ${chalk.white(
+            `${parseFloat(ethersLib.ethers.formatEther(bal)).toFixed(4)} ETH`
+          )}`
+        );
+      } catch {
+        /* skip */
+      }
+    }
+  } catch {
+    /* skip */
+  }
+  console.log();
+}
+
+// ─── Shell-style tokenizer (handles "quoted strings") ────────────────────────
+
+function parseTokens(input: string): string[] {
+  const tokens: string[] = [];
+  let current = "";
+  let inQuote = false;
+  let quoteChar = "";
+
+  for (const ch of input) {
+    if (inQuote) {
+      if (ch === quoteChar) {
+        inQuote = false;
+      } else {
+        current += ch;
+      }
+    } else if (ch === '"' || ch === "'") {
+      inQuote = true;
+      quoteChar = ch;
+    } else if (ch === " ") {
+      if (current) {
+        tokens.push(current);
+        current = "";
+      }
+    } else {
+      current += ch;
+    }
+  }
+  if (current) tokens.push(current);
+  return tokens;
+}
+
+// ─── Tab completer ────────────────────────────────────────────────────────────
+
+function buildCompleter(
+  topCmds: string[],
+  subCmds: Map<string, string[]>
+): readline.Completer {
+  const specialCmds = ["help", "exit", "quit", "clear", "status"];
+  const allTop = [...specialCmds, ...topCmds];
+
+  return function completer(line: string): [string[], string] {
+    const trimmed = line.trimStart();
+    const spaceIdx = trimmed.indexOf(" ");
+
+    if (spaceIdx === -1) {
+      // Completing the first word (top-level command)
+      const hits = allTop.filter((cmd) => cmd.startsWith(trimmed));
+      return [hits.length ? hits : allTop, trimmed];
+    }
+
+    // Completing a subcommand
+    const parent = trimmed.slice(0, spaceIdx);
+    const rest = trimmed.slice(spaceIdx + 1);
+    const subs = subCmds.get(parent) ?? [];
+    const hits = subs.filter((s) => s.startsWith(rest));
+    return [
+      hits.map((s) => `${parent} ${s}`),
+      trimmed,
+    ];
+  };
+}
+
+// ─── REPL entry point ─────────────────────────────────────────────────────────
+
+export async function startREPL(): Promise<void> {
+  // Show the banner
+  const bannerCfg = await loadBannerConfig();
+  renderBanner(bannerCfg);
+
+  // Build a template program once just to extract command metadata for completions
+  const template = createProgram();
+  const topCmds = template.commands.map((cmd) => cmd.name());
+  const subCmds = new Map<string, string[]>();
+  for (const cmd of template.commands) {
+    if (cmd.commands.length > 0) {
+      subCmds.set(
+        cmd.name(),
+        cmd.commands.map((s) => s.name())
+      );
+    }
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: PROMPT,
+    completer: buildCompleter(topCmds, subCmds),
+    terminal: true,
+    historySize: 200,
+  });
+
+  function goodbye(): void {
+    console.log(
+      "\n " + chalk.cyanBright("◈") + chalk.dim(" goodbye")
+    );
+  }
+
+  rl.on("SIGINT", () => {
+    goodbye();
+    rl.close();
+    process.exit(0);
+  });
+
+  rl.on("close", () => {
+    goodbye();
+    process.exit(0);
+  });
+
+  rl.prompt();
+
+  // Process lines one at a time
+  for await (const line of rl) {
+    const input = line.trim();
+
+    if (!input) {
+      rl.prompt();
+      continue;
+    }
+
+    // ── Special built-in commands ──────────────────────────────────────────
+
+    if (input === "exit" || input === "quit") {
+      goodbye();
+      rl.close();
+      process.exit(0);
+    }
+
+    if (input === "clear") {
+      console.clear();
+      const cfg = await loadBannerConfig();
+      renderBanner(cfg);
+      rl.prompt();
+      continue;
+    }
+
+    if (input === "status") {
+      await showStatus();
+      rl.prompt();
+      continue;
+    }
+
+    if (input === "help" || input === "help ") {
+      // Show the full commander help via the program
+      const prog = createProgram();
+      prog.exitOverride();
+      prog.configureOutput({
+        writeOut: (str) => process.stdout.write(str),
+        writeErr: (str) => process.stderr.write(str),
+      });
+      try {
+        await prog.parseAsync(["node", "arc402", "--help"]);
+      } catch {
+        /* commander throws after printing help — ignore */
+      }
+      rl.prompt();
+      continue;
+    }
+
+    // ── Dispatch to commander ──────────────────────────────────────────────
+
+    const tokens = parseTokens(input);
+    const prog = createProgram();
+    prog.exitOverride();
+    prog.configureOutput({
+      writeOut: (str) => process.stdout.write(str),
+      writeErr: (str) => process.stderr.write(str),
+    });
+
+    // Intercept process.exit() so a command exiting doesn't kill the REPL
+    const origExit = process.exit;
+    (process as NodeJS.Process).exit = ((code?: number) => {
+      throw new REPLExitSignal(code ?? 0);
+    }) as typeof process.exit;
+
+    try {
+      await prog.parseAsync(["node", "arc402", ...tokens]);
+    } catch (err) {
+      if (err instanceof REPLExitSignal) {
+        // Command called process.exit() — normal, just continue the REPL
+      } else {
+        const e = err as { code?: string; message?: string };
+        if (
+          e.code === "commander.helpDisplayed" ||
+          e.code === "commander.version"
+        ) {
+          // Help / version output was already written — nothing to do
+        } else if (e.code === "commander.unknownCommand") {
+          console.log(
+            `\n ${c.failure} ${chalk.red(`Unknown command: ${chalk.white(tokens[0])}`)}`
+          );
+          console.log(chalk.dim("  Type 'help' for available commands\n"));
+        } else if (e.code?.startsWith("commander.")) {
+          console.log(`\n ${c.failure} ${chalk.red(e.message ?? String(err))}\n`);
+        } else {
+          console.log(
+            `\n ${c.failure} ${chalk.red(e.message ?? String(err))}\n`
+          );
+        }
+      }
+    } finally {
+      (process as NodeJS.Process).exit = origExit;
+    }
+
+    rl.prompt();
+  }
+}