feat(miner): add local claims ledger CLI

packages/gittensory-miner/bin/gittensory-miner.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { printHelp, printVersion, runCli } from "../lib/cli.js";
+import { runClaimsCli } from "../lib/claim-ledger-cli.js";
 import { runDenyCheck } from "../lib/deny-check.js";
 import { runGovernorCli } from "../lib/governor-ledger-cli.js";
 import { runLedgerCli } from "../lib/event-ledger-cli.js";
@@ -37,6 +38,10 @@ if (cliArgs[0] === "queue") {
   process.exit(runQueueCli(cliArgs[1], cliArgs.slice(2)));
 }
 
+if (cliArgs[0] === "claims") {
+  process.exit(runClaimsCli(cliArgs[1], cliArgs.slice(2)));
+}
+
 if (cliArgs[0] === "ledger") {
   process.exit(runLedgerCli(cliArgs[1], cliArgs.slice(2)));
 }

packages/gittensory-miner/lib/claim-ledger-cli.d.ts

@@ -0,0 +1,69 @@
+import type { ClaimEntry, ClaimLedger, ClaimStatus } from "./claim-ledger.js";
+
+export type ParsedClaimsListArgs =
+  | {
+      json: boolean;
+      repoFullName: string | null;
+      status: ClaimStatus | null;
+    }
+  | { error: string };
+
+export type ParsedClaimsClaimArgs =
+  | {
+      repoFullName: string;
+      issueNumber: number;
+      note: string | null;
+      json: boolean;
+    }
+  | { error: string };
+
+export type ParsedClaimsReleaseArgs =
+  | {
+      repoFullName: string;
+      issueNumber: number;
+      json: boolean;
+    }
+  | { error: string };
+
+export type ParsedClaimsSweepArgs =
+  | {
+      json: boolean;
+      maxAgeDays: number;
+    }
+  | { error: string };
+
+export function parseClaimsListArgs(args: string[]): ParsedClaimsListArgs;
+
+export function parseClaimsClaimArgs(args: string[]): ParsedClaimsClaimArgs;
+
+export function parseClaimsReleaseArgs(args: string[]): ParsedClaimsReleaseArgs;
+
+export function parseClaimsSweepArgs(args: string[]): ParsedClaimsSweepArgs;
+
+export function renderClaimsTable(claims: ClaimEntry[]): string;
+
+export function runClaimsList(
+  args: string[],
+  options?: { openClaimLedger?: () => ClaimLedger },
+): number;
+
+export function runClaimsClaim(
+  args: string[],
+  options?: { openClaimLedger?: () => ClaimLedger },
+): number;
+
+export function runClaimsRelease(
+  args: string[],
+  options?: { openClaimLedger?: () => ClaimLedger },
+): number;
+
+export function runClaimsSweep(
+  args: string[],
+  options?: { openClaimLedger?: () => ClaimLedger; nowMs?: number },
+): number;
+
+export function runClaimsCli(
+  subcommand: string | undefined,
+  args: string[],
+  options?: { openClaimLedger?: () => ClaimLedger; nowMs?: number },
+): number;