@spectratools/assembly-cli 0.4.0 → 0.4.3

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
+import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
 import { Cli as Cli6, z as z6 } from "incur";
 
@@ -26,6 +27,19 @@ function relTime(unixSeconds) {
   const label = h > 0 ? `${h}h ${m}m` : `${m}m`;
   return delta >= 0 ? `in ${label}` : `${label} ago`;
 }
+function isoTime(unixSeconds) {
+  const ts = typeof unixSeconds === "bigint" ? Number(unixSeconds) : unixSeconds;
+  if (!Number.isFinite(ts) || ts <= 0) return "n/a";
+  try {
+    return new Date(ts * 1e3).toISOString().replace(".000Z", "Z");
+  } catch {
+    return "n/a";
+  }
+}
+function timeValue(unixSeconds, format) {
+  if (format === "json" || format === "jsonl") return isoTime(unixSeconds);
+  return typeof unixSeconds === "bigint" ? Number(unixSeconds) : unixSeconds;
+}
 function asNum(value) {
   return Number(value);
 }
@@ -4313,6 +4327,7 @@ function createAssemblyPublicClient(rpcUrl) {
 var env = z.object({
   ABSTRACT_RPC_URL: z.string().optional().describe("Abstract RPC URL override")
 });
+var timestampOutput = z.union([z.number(), z.string()]);
 function decodeSeat(value) {
   const [owner, startAt, endAt, forfeited] = value;
   return { owner, startAt, endAt, forfeited };
@@ -4336,9 +4351,9 @@ council.command("seats", {
     z.object({
       id: z.number(),
       owner: z.string(),
-      startAt: z.number(),
+      startAt: timestampOutput,
       startAtRelative: z.string(),
-      endAt: z.number(),
+      endAt: timestampOutput,
       endAtRelative: z.string(),
       forfeited: z.boolean()
     })
@@ -4366,9 +4381,9 @@ council.command("seats", {
       seats.map((seat, idx) => ({
         id: idx,
         owner: toChecksum(seat.owner),
-        startAt: asNum(seat.startAt),
+        startAt: timeValue(seat.startAt, c.format),
         startAtRelative: relTime(seat.startAt),
-        endAt: asNum(seat.endAt),
+        endAt: timeValue(seat.endAt, c.format),
         endAtRelative: relTime(seat.endAt),
         forfeited: seat.forfeited
       }))
@@ -4384,8 +4399,8 @@ council.command("seat", {
   output: z.object({
     id: z.number(),
     owner: z.string(),
-    startAt: z.number(),
-    endAt: z.number(),
+    startAt: timestampOutput,
+    endAt: timestampOutput,
     forfeited: z.boolean(),
     endAtRelative: z.string()
   }),
@@ -4414,8 +4429,8 @@ council.command("seat", {
     return c.ok({
       id: c.args.id,
       owner: toChecksum(seat.owner),
-      startAt: asNum(seat.startAt),
-      endAt: asNum(seat.endAt),
+      startAt: timeValue(seat.startAt, c.format),
+      endAt: timeValue(seat.endAt, c.format),
       forfeited: seat.forfeited,
       endAtRelative: relTime(seat.endAt)
     });
@@ -4538,7 +4553,7 @@ council.command("auctions", {
         highestBidder: z.string(),
         highestBid: z.string(),
         settled: z.boolean(),
-        windowEnd: z.number(),
+        windowEnd: timestampOutput,
         windowEndRelative: z.string(),
         status: z.enum(["bidding", "closed", "settled"])
       })
@@ -4604,7 +4619,7 @@ council.command("auctions", {
             highestBidder: toChecksum(auctions[i].highestBidder),
             highestBid: eth(auctions[i].highestBid),
             settled: auctions[i].settled,
-            windowEnd: asNum(windowEnd),
+            windowEnd: timeValue(windowEnd, c.format),
             windowEndRelative: relTime(windowEnd),
             status: deriveAuctionStatus({
               settled: auctions[i].settled,
@@ -4639,7 +4654,7 @@ council.command("auction", {
     highestBidder: z.string(),
     highestBid: z.string(),
     settled: z.boolean(),
-    windowEnd: z.number(),
+    windowEnd: timestampOutput,
     windowEndRelative: z.string(),
     status: z.enum(["bidding", "closed", "settled"])
   }),
@@ -4670,7 +4685,7 @@ council.command("auction", {
       highestBidder: toChecksum(auction.highestBidder),
       highestBid: eth(auction.highestBid),
       settled: auction.settled,
-      windowEnd: asNum(windowEndTimestamp),
+      windowEnd: timeValue(windowEndTimestamp, c.format),
       windowEndRelative: relTime(windowEndTimestamp),
       status: deriveAuctionStatus({
         settled: auction.settled,
@@ -4778,6 +4793,7 @@ import { Cli as Cli2, z as z2 } from "incur";
 var env2 = z2.object({
   ABSTRACT_RPC_URL: z2.string().optional().describe("Abstract RPC URL override")
 });
+var timestampOutput2 = z2.union([z2.number(), z2.string()]);
 function decodeThread(value) {
   const [id, kind, author, createdAt, category, title, body, proposalId, petitionId] = value;
   return {
@@ -4841,7 +4857,7 @@ forum.command("threads", {
         id: z2.number(),
         kind: z2.number(),
         author: z2.string(),
-        createdAt: z2.number(),
+        createdAt: timestampOutput2,
         createdAtRelative: z2.string(),
         category: z2.string().nullable().optional(),
         title: z2.string().nullable().optional()
@@ -4872,7 +4888,7 @@ forum.command("threads", {
       id: x.id,
       kind: x.kind,
       author: x.author,
-      createdAt: x.createdAt,
+      createdAt: timeValue(x.createdAt, c.format),
       createdAtRelative: relTime(x.createdAt),
       category: x.category ?? null,
       title: x.title ?? null
@@ -5157,6 +5173,48 @@ import { Cli as Cli3, z as z3 } from "incur";
 var env3 = z3.object({
   ABSTRACT_RPC_URL: z3.string().optional().describe("Abstract RPC URL override")
 });
+var timestampOutput3 = z3.union([z3.number(), z3.string()]);
+var proposalStatusLabels = {
+  0: "pending",
+  1: "active",
+  2: "passed",
+  3: "executed",
+  4: "defeated",
+  5: "cancelled"
+};
+function proposalStatus(status) {
+  const statusCode = asNum(status);
+  return {
+    status: proposalStatusLabels[statusCode] ?? `unknown-${statusCode}`,
+    statusCode
+  };
+}
+var proposalOutputSchema = z3.object({
+  kind: z3.number(),
+  configRiskTier: z3.number(),
+  origin: z3.number(),
+  status: z3.string(),
+  statusCode: z3.number(),
+  proposer: z3.string(),
+  threadId: z3.number(),
+  petitionId: z3.number(),
+  createdAt: z3.number(),
+  deliberationEndsAt: z3.number(),
+  voteStartAt: z3.number(),
+  voteEndAt: z3.number(),
+  timelockEndsAt: z3.number(),
+  activeSeatsSnapshot: z3.number(),
+  forVotes: z3.string(),
+  againstVotes: z3.string(),
+  abstainVotes: z3.string(),
+  amount: z3.string(),
+  snapshotAssetBalance: z3.string(),
+  transferIntent: z3.boolean(),
+  intentDeadline: z3.number(),
+  intentMaxRiskTier: z3.number(),
+  title: z3.string(),
+  description: z3.string()
+});
 function decodeProposal(value) {
   const [
     kind,
@@ -5210,11 +5268,13 @@ function decodeProposal(value) {
   };
 }
 function serializeProposal(proposal) {
+  const status = proposalStatus(proposal.status);
   return {
     kind: asNum(proposal.kind),
     configRiskTier: asNum(proposal.configRiskTier),
     origin: asNum(proposal.origin),
-    status: asNum(proposal.status),
+    status: status.status,
+    statusCode: status.statusCode,
     proposer: proposal.proposer,
     threadId: asNum(proposal.threadId),
     petitionId: asNum(proposal.petitionId),
@@ -5247,9 +5307,10 @@ governance.command("proposals", {
       z3.object({
         id: z3.number(),
         kind: z3.number(),
-        status: z3.number(),
+        status: z3.string(),
+        statusCode: z3.number(),
         title: z3.string().nullable().optional(),
-        voteEndAt: z3.number(),
+        voteEndAt: timestampOutput3,
         voteEndRelative: z3.string()
       })
     ),
@@ -5275,11 +5336,11 @@ governance.command("proposals", {
     }) : [];
     const proposals = proposalTuples.map(decodeProposal);
     const items = proposals.map((p, i) => ({
+      ...proposalStatus(p.status),
       id: i + 1,
       kind: asNum(p.kind),
-      status: asNum(p.status),
       title: p.title ?? null,
-      voteEndAt: asNum(p.voteEndAt),
+      voteEndAt: timeValue(p.voteEndAt, c.format),
       voteEndRelative: relTime(p.voteEndAt)
     }));
     return c.ok(
@@ -5305,7 +5366,7 @@ governance.command("proposal", {
     id: z3.coerce.number().int().positive().describe("Proposal id (1-indexed)")
   }),
   env: env3,
-  output: z3.record(z3.string(), z3.unknown()),
+  output: proposalOutputSchema,
   examples: [{ args: { id: 1 }, description: "Fetch proposal #1" }],
   async run(c) {
     const client = createAssemblyPublicClient(c.env.ABSTRACT_RPC_URL);
@@ -5436,6 +5497,7 @@ var env4 = z4.object({
   ABSTRACT_RPC_URL: z4.string().optional().describe("Abstract RPC URL override"),
   ASSEMBLY_INDEXER_URL: z4.string().optional().describe("Optional members snapshot endpoint (default: theaiassembly.org indexer)")
 });
+var timestampOutput4 = z4.union([z4.number(), z4.string()]);
 var memberSnapshotSchema = z4.array(z4.string());
 var AssemblyApiValidationError = class extends Error {
   constructor(details) {
@@ -5550,9 +5612,9 @@ members.command("list", {
         address: z4.string(),
         active: z4.boolean(),
         registered: z4.boolean(),
-        activeUntil: z4.number(),
+        activeUntil: timestampOutput4,
         activeUntilRelative: z4.string(),
-        lastHeartbeatAt: z4.number(),
+        lastHeartbeatAt: timestampOutput4,
         lastHeartbeatRelative: z4.string()
       })
     ),
@@ -5620,9 +5682,9 @@ members.command("list", {
         address: toChecksum(address),
         active,
         registered: info.registered,
-        activeUntil: Number(info.activeUntil),
+        activeUntil: timeValue(info.activeUntil, c.format),
         activeUntilRelative: relTime(info.activeUntil),
-        lastHeartbeatAt: Number(info.lastHeartbeatAt),
+        lastHeartbeatAt: timeValue(info.lastHeartbeatAt, c.format),
         lastHeartbeatRelative: relTime(info.lastHeartbeatAt)
       };
     });
@@ -5641,8 +5703,8 @@ members.command("info", {
   output: z4.object({
     address: z4.string(),
     active: z4.boolean(),
-    activeUntil: z4.number(),
-    lastHeartbeatAt: z4.number(),
+    activeUntil: timestampOutput4,
+    lastHeartbeatAt: timestampOutput4,
     activeUntilRelative: z4.string(),
     lastHeartbeatRelative: z4.string()
   }),
@@ -5671,8 +5733,8 @@ members.command("info", {
     return c.ok({
       address: toChecksum(c.args.address),
       active,
-      activeUntil: Number(member.activeUntil),
-      lastHeartbeatAt: Number(member.lastHeartbeatAt),
+      activeUntil: timeValue(member.activeUntil, c.format),
+      lastHeartbeatAt: timeValue(member.lastHeartbeatAt, c.format),
       activeUntilRelative: relTime(member.activeUntil),
       lastHeartbeatRelative: relTime(member.lastHeartbeatAt)
     });
@@ -5748,6 +5810,7 @@ import { Cli as Cli5, z as z5 } from "incur";
 var env5 = z5.object({
   ABSTRACT_RPC_URL: z5.string().optional().describe("Abstract RPC URL override")
 });
+var timestampOutput5 = z5.union([z5.number(), z5.string()]);
 var treasury = Cli5.create("treasury", {
   description: "Inspect treasury balances, execution status, and spend controls."
 });
@@ -5802,7 +5865,7 @@ treasury.command("major-spend-status", {
   env: env5,
   output: z5.object({
     majorSpendCooldownSeconds: z5.number(),
-    lastMajorSpendAt: z5.number(),
+    lastMajorSpendAt: timestampOutput5,
     lastMajorSpendRelative: z5.string(),
     isMajorSpendAllowed: z5.boolean()
   }),
@@ -5830,7 +5893,7 @@ treasury.command("major-spend-status", {
     ]);
     return c.ok({
       majorSpendCooldownSeconds: asNum(cooldown),
-      lastMajorSpendAt: asNum(lastMajorSpendAt),
+      lastMajorSpendAt: timeValue(lastMajorSpendAt, c.format),
       lastMajorSpendRelative: relTime(lastMajorSpendAt),
       isMajorSpendAllowed: allowed
     });
@@ -6010,6 +6073,7 @@ cli.command(treasury);
 var rootEnv = z6.object({
   ABSTRACT_RPC_URL: z6.string().optional().describe("Abstract RPC URL override")
 });
+var timestampOutput6 = z6.union([z6.number(), z6.string()]);
 cli.command("status", {
   description: "Get a cross-contract Assembly snapshot (members, council, governance, treasury).",
   env: rootEnv,
@@ -6078,7 +6142,8 @@ cli.command("health", {
   output: z6.object({
     address: z6.string(),
     isActive: z6.boolean(),
-    activeUntil: z6.number(),
+    activeUntil: timestampOutput6,
+    activeUntilRelative: z6.string(),
     isCouncilMember: z6.boolean(),
     pendingReturnsWei: z6.string(),
     votingPower: z6.number()
@@ -6126,7 +6191,8 @@ cli.command("health", {
     return c.ok({
       address: toChecksum(c.args.address),
       isActive,
-      activeUntil: Number(member.activeUntil),
+      activeUntil: timeValue(member.activeUntil, c.format),
+      activeUntilRelative: relTime(member.activeUntil),
       isCouncilMember,
       pendingReturnsWei: pendingReturns.toString(),
       votingPower: Number(votingPower)
@@ -6134,7 +6200,17 @@ cli.command("health", {
   }
 });
 applyFriendlyErrorHandling(cli);
-var isMain = process.argv[1] === fileURLToPath(import.meta.url);
+var isMain = (() => {
+  const entrypoint = process.argv[1];
+  if (!entrypoint) {
+    return false;
+  }
+  try {
+    return realpathSync(entrypoint) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+})();
 if (isMain) {
   cli.serve();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectratools/assembly-cli",
-  "version": "0.4.0",
+  "version": "0.4.3",
   "description": "CLI for Assembly governance on Abstract (members, council, forum, proposals, and treasury).",
   "type": "module",
   "license": "MIT",