@poa-box/core 0.1.0

package/dist/graph/documents/task.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Task & Project Queries
+ * Ported from frontend queries.js
+ */
+import type { FieldFallbackTier } from '../client';
+export declare const FETCH_PROJECTS_DATA = "\n  query FetchProjectsDataNew($orgId: Bytes!) {\n    organization(id: $orgId) {\n      id\n      taskManager {\n        id\n        creatorHatIds\n        projects(where: { deleted: false }, first: 50) {\n          id\n          title\n          metadataHash\n          metadata {\n            id\n            description\n          }\n          cap\n          bountyCaps {\n            token\n            cap\n          }\n          createdAt\n          tasks(first: 1000, orderBy: taskId, orderDirection: desc) {\n            id\n            taskId\n            title\n            metadataHash\n            submissionHash\n            rejectionHash\n            rejectionCount\n            metadata {\n              id\n              name\n              description\n              location\n              difficulty\n              estimatedHours\n              dueDate\n              submission\n              rejection\n            }\n            rejections(orderBy: rejectedAt, orderDirection: desc, first: 10) {\n              rejectorUsername\n              rejectedAt\n              metadata {\n                rejection\n              }\n            }\n            payout\n            bountyToken\n            bountyPayout\n            completionWindow\n            absoluteDeadline\n            claimDeadline\n            reclaimCount\n            status\n            assignee\n            assigneeUsername\n            completer\n            completerUsername\n            requiresApplication\n            createdAt\n            assignedAt\n            submittedAt\n            completedAt\n            applications {\n              applicant\n              applicantUsername\n              applicationHash\n              metadata {\n                notes\n                experience\n              }\n              approved\n              approver\n              approverUsername\n              appliedAt\n            }\n          }\n        }\n      }\n    }\n  }\n";
+/**
+ * FETCH_PROJECTS_DATA without the TaskManager v6 deadline fields (subgraph #192).
+ *
+ * A GraphQL document validates as a whole, so one unknown field fails the entire query. When
+ * this tier serves, callers fall back to reading deadlines on-chain via the task lens.
+ * Derived by deletion so the two cannot drift apart.
+ */
+export declare const FETCH_PROJECTS_DATA_LEGACY: string;
+/**
+ * FETCH_PROJECTS_DATA plus the claim-release fields (subgraph #201, TaskManager v7).
+ *
+ * GNOSIS ONLY as of 2026-08-02. Verified live that poa-arb-v-1 rejects the document with
+ * ``Type `Task` has no field `releaseCount``` — which `isUnknownFieldError` matches on
+ * /has no field/i, so the tier drops cleanly to FETCH_PROJECTS_DATA. TaskManager v7 itself
+ * IS live on Arbitrum; it is only the indexing that has not shipped there.
+ *
+ * Both fields are structurally present but zero/null on every live Gnosis row (v7 shipped,
+ * no release has happened yet), so callers must gate rendering on the SERVED TIER, never on
+ * truthiness — `releaseCount: 0` ("indexed, never released") has to stay distinguishable
+ * from absent ("not indexed").
+ *
+ * Built by INSERTION, not by deletion like FETCH_PROJECTS_DATA_LEGACY: that idiom would
+ * silently no-op if a field were ever reflowed onto a shared line, leaving the "rich" tier
+ * byte-identical to the tier it exists to improve on. The task-release-tiers test asserts
+ * tier 0 is strictly longer than tier 1 for exactly this reason.
+ */
+export declare const FETCH_PROJECTS_DATA_WITH_RELEASES: string;
+/**
+ * Tier order for consumers that want release data. Every consumer of the shared projects
+ * document that does NOT need releases must keep using bare `query(FETCH_PROJECTS_DATA)` —
+ * adding the v7 fields there would break those call sites outright on Arbitrum for no gain.
+ */
+export declare const PROJECTS_DATA_TIERS: string[];
+/** Build the tier array for `queryWithFieldFallback`. */
+export declare function projectsDataTiers(orgId: string): FieldFallbackTier[];
+/**
+ * Chains whose deployed subgraph indexes `TaskUnclaimed` (subgraph #201).
+ *
+ * TaskManager v7 is live on EVERY chain — verified 2026-08-02, byte-identical
+ * implementation on Gnosis and Arbitrum — but only the Gnosis subgraph has the
+ * handler. So a release on any other chain succeeds on-chain and is then
+ * invisible to every read surface: the task keeps showing as claimed by the
+ * previous assignee, with `assignee`/`assignedAt` never cleared.
+ *
+ * Deliberately a chain-id allowlist rather than a runtime probe: `task unclaim`
+ * must be able to warn even under `--no-preflight`, with no extra round-trip.
+ * Delete an entry here only when that chain's subgraph is genuinely upgraded.
+ */
+export declare const TASK_RELEASE_INDEXING_CHAIN_IDS: ReadonlySet<number>;
+/** Whether `chainId`'s subgraph indexes task releases. Unknown chains: assume not. */
+export declare function chainIndexesTaskReleases(chainId: number | undefined): boolean;
+/**
+ * One task's full release history (subgraph #201). Issued only when the shared document
+ * already reported `releaseCount > 0`, so the common path stays at one round-trip.
+ *
+ * `$taskId` is the Task ENTITY id — `<lowercased taskManager address>-<numeric task id>`,
+ * not the bare numeric id.
+ *
+ * Every variable is scalar and the ordering args are inline on purpose: an `orderBy`/`where`
+ * that a deployment does not know produces ``Invalid value provided for argument `where``` /
+ * ``Variable `w` must have an input type``, and NONE of `isUnknownFieldError`'s regexes match
+ * those — they would escape the tier machinery and kill the command outright.
+ */
+export declare const FETCH_TASK_RELEASE_HISTORY = "\n  query FetchTaskReleaseHistory($taskId: ID!, $first: Int!) {\n    task(id: $taskId) {\n      id\n      taskId\n      status\n      releaseCount\n      lastReleasedAt\n      releases(first: $first, orderBy: releasedAt, orderDirection: desc) {\n        id\n        previousClaimer\n        previousClaimerUsername\n        caller\n        callerUsername\n        selfRelease\n        releasedAt\n        releasedAtBlock\n        transactionHash\n      }\n    }\n  }\n";
+/**
+ * Tier 1 for the history read: deliberately minimal so `queryWithFieldFallback` resolves
+ * with tierIndex 1 ("release history not indexed here") instead of rethrowing the validation
+ * error, which is what it does when the LAST tier also fails.
+ */
+export declare const FETCH_TASK_RELEASE_HISTORY_LEGACY = "\n  query FetchTaskReleaseHistoryLegacy($taskId: ID!) {\n    task(id: $taskId) {\n      id\n      taskId\n      status\n    }\n  }\n";
+/**
+ * Org-wide recent releases (subgraph #201).
+ *
+ * Org scoping MUST route through the nested `task_` join: `TaskRelease` carries no org field
+ * and `Project` has no `organization` field. `$taskManager` must be LOWERCASED — a
+ * checksummed address returns `[]` silently rather than erroring.
+ */
+export declare const FETCH_ORG_TASK_RELEASES = "\n  query FetchOrgTaskReleases($taskManager: Bytes!, $first: Int!, $skip: Int!) {\n    taskReleases(\n      where: { task_: { taskManager: $taskManager } }\n      orderBy: releasedAt\n      orderDirection: desc\n      first: $first\n      skip: $skip\n    ) {\n      id\n      previousClaimer\n      previousClaimerUsername\n      caller\n      callerUsername\n      selfRelease\n      releasedAt\n      transactionHash\n      task {\n        id\n        taskId\n        title\n        status\n        releaseCount\n      }\n    }\n  }\n";

package/dist/graph/documents/task.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Task & Project Queries
+ * Ported from frontend queries.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FETCH_ORG_TASK_RELEASES = exports.FETCH_TASK_RELEASE_HISTORY_LEGACY = exports.FETCH_TASK_RELEASE_HISTORY = exports.TASK_RELEASE_INDEXING_CHAIN_IDS = exports.PROJECTS_DATA_TIERS = exports.FETCH_PROJECTS_DATA_WITH_RELEASES = exports.FETCH_PROJECTS_DATA_LEGACY = exports.FETCH_PROJECTS_DATA = void 0;
+exports.projectsDataTiers = projectsDataTiers;
+exports.chainIndexesTaskReleases = chainIndexesTaskReleases;
+exports.FETCH_PROJECTS_DATA = `
+  query FetchProjectsDataNew($orgId: Bytes!) {
+    organization(id: $orgId) {
+      id
+      taskManager {
+        id
+        creatorHatIds
+        projects(where: { deleted: false }, first: 50) {
+          id
+          title
+          metadataHash
+          metadata {
+            id
+            description
+          }
+          cap
+          bountyCaps {
+            token
+            cap
+          }
+          createdAt
+          tasks(first: 1000, orderBy: taskId, orderDirection: desc) {
+            id
+            taskId
+            title
+            metadataHash
+            submissionHash
+            rejectionHash
+            rejectionCount
+            metadata {
+              id
+              name
+              description
+              location
+              difficulty
+              estimatedHours
+              dueDate
+              submission
+              rejection
+            }
+            rejections(orderBy: rejectedAt, orderDirection: desc, first: 10) {
+              rejectorUsername
+              rejectedAt
+              metadata {
+                rejection
+              }
+            }
+            payout
+            bountyToken
+            bountyPayout
+            completionWindow
+            absoluteDeadline
+            claimDeadline
+            reclaimCount
+            status
+            assignee
+            assigneeUsername
+            completer
+            completerUsername
+            requiresApplication
+            createdAt
+            assignedAt
+            submittedAt
+            completedAt
+            applications {
+              applicant
+              applicantUsername
+              applicationHash
+              metadata {
+                notes
+                experience
+              }
+              approved
+              approver
+              approverUsername
+              appliedAt
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * FETCH_PROJECTS_DATA without the TaskManager v6 deadline fields (subgraph #192).
+ *
+ * A GraphQL document validates as a whole, so one unknown field fails the entire query. When
+ * this tier serves, callers fall back to reading deadlines on-chain via the task lens.
+ * Derived by deletion so the two cannot drift apart.
+ */
+exports.FETCH_PROJECTS_DATA_LEGACY = exports.FETCH_PROJECTS_DATA
+    .split('\n')
+    .filter((line) => !/^\s*(completionWindow|absoluteDeadline|claimDeadline|reclaimCount)\s*$/.test(line))
+    .join('\n');
+/**
+ * FETCH_PROJECTS_DATA plus the claim-release fields (subgraph #201, TaskManager v7).
+ *
+ * GNOSIS ONLY as of 2026-08-02. Verified live that poa-arb-v-1 rejects the document with
+ * ``Type `Task` has no field `releaseCount``` — which `isUnknownFieldError` matches on
+ * /has no field/i, so the tier drops cleanly to FETCH_PROJECTS_DATA. TaskManager v7 itself
+ * IS live on Arbitrum; it is only the indexing that has not shipped there.
+ *
+ * Both fields are structurally present but zero/null on every live Gnosis row (v7 shipped,
+ * no release has happened yet), so callers must gate rendering on the SERVED TIER, never on
+ * truthiness — `releaseCount: 0` ("indexed, never released") has to stay distinguishable
+ * from absent ("not indexed").
+ *
+ * Built by INSERTION, not by deletion like FETCH_PROJECTS_DATA_LEGACY: that idiom would
+ * silently no-op if a field were ever reflowed onto a shared line, leaving the "rich" tier
+ * byte-identical to the tier it exists to improve on. The task-release-tiers test asserts
+ * tier 0 is strictly longer than tier 1 for exactly this reason.
+ */
+exports.FETCH_PROJECTS_DATA_WITH_RELEASES = exports.FETCH_PROJECTS_DATA.replace(/^(\s*)reclaimCount$/m, '$1reclaimCount\n$1releaseCount\n$1lastReleasedAt');
+/**
+ * Tier order for consumers that want release data. Every consumer of the shared projects
+ * document that does NOT need releases must keep using bare `query(FETCH_PROJECTS_DATA)` —
+ * adding the v7 fields there would break those call sites outright on Arbitrum for no gain.
+ */
+exports.PROJECTS_DATA_TIERS = [
+    exports.FETCH_PROJECTS_DATA_WITH_RELEASES, // 0: Gnosis — v6 deadlines + v7 releases
+    exports.FETCH_PROJECTS_DATA, // 1: Arbitrum today — v6 deadlines, no releases
+    exports.FETCH_PROJECTS_DATA_LEGACY, // 2: deployments predating subgraph #192
+];
+/** Build the tier array for `queryWithFieldFallback`. */
+function projectsDataTiers(orgId) {
+    return exports.PROJECTS_DATA_TIERS.map((query) => ({ query, variables: { orgId } }));
+}
+/**
+ * Chains whose deployed subgraph indexes `TaskUnclaimed` (subgraph #201).
+ *
+ * TaskManager v7 is live on EVERY chain — verified 2026-08-02, byte-identical
+ * implementation on Gnosis and Arbitrum — but only the Gnosis subgraph has the
+ * handler. So a release on any other chain succeeds on-chain and is then
+ * invisible to every read surface: the task keeps showing as claimed by the
+ * previous assignee, with `assignee`/`assignedAt` never cleared.
+ *
+ * Deliberately a chain-id allowlist rather than a runtime probe: `task unclaim`
+ * must be able to warn even under `--no-preflight`, with no extra round-trip.
+ * Delete an entry here only when that chain's subgraph is genuinely upgraded.
+ */
+exports.TASK_RELEASE_INDEXING_CHAIN_IDS = new Set([100]);
+/** Whether `chainId`'s subgraph indexes task releases. Unknown chains: assume not. */
+function chainIndexesTaskReleases(chainId) {
+    return chainId !== undefined && exports.TASK_RELEASE_INDEXING_CHAIN_IDS.has(chainId);
+}
+/**
+ * One task's full release history (subgraph #201). Issued only when the shared document
+ * already reported `releaseCount > 0`, so the common path stays at one round-trip.
+ *
+ * `$taskId` is the Task ENTITY id — `<lowercased taskManager address>-<numeric task id>`,
+ * not the bare numeric id.
+ *
+ * Every variable is scalar and the ordering args are inline on purpose: an `orderBy`/`where`
+ * that a deployment does not know produces ``Invalid value provided for argument `where``` /
+ * ``Variable `w` must have an input type``, and NONE of `isUnknownFieldError`'s regexes match
+ * those — they would escape the tier machinery and kill the command outright.
+ */
+exports.FETCH_TASK_RELEASE_HISTORY = `
+  query FetchTaskReleaseHistory($taskId: ID!, $first: Int!) {
+    task(id: $taskId) {
+      id
+      taskId
+      status
+      releaseCount
+      lastReleasedAt
+      releases(first: $first, orderBy: releasedAt, orderDirection: desc) {
+        id
+        previousClaimer
+        previousClaimerUsername
+        caller
+        callerUsername
+        selfRelease
+        releasedAt
+        releasedAtBlock
+        transactionHash
+      }
+    }
+  }
+`;
+/**
+ * Tier 1 for the history read: deliberately minimal so `queryWithFieldFallback` resolves
+ * with tierIndex 1 ("release history not indexed here") instead of rethrowing the validation
+ * error, which is what it does when the LAST tier also fails.
+ */
+exports.FETCH_TASK_RELEASE_HISTORY_LEGACY = `
+  query FetchTaskReleaseHistoryLegacy($taskId: ID!) {
+    task(id: $taskId) {
+      id
+      taskId
+      status
+    }
+  }
+`;
+/**
+ * Org-wide recent releases (subgraph #201).
+ *
+ * Org scoping MUST route through the nested `task_` join: `TaskRelease` carries no org field
+ * and `Project` has no `organization` field. `$taskManager` must be LOWERCASED — a
+ * checksummed address returns `[]` silently rather than erroring.
+ */
+exports.FETCH_ORG_TASK_RELEASES = `
+  query FetchOrgTaskReleases($taskManager: Bytes!, $first: Int!, $skip: Int!) {
+    taskReleases(
+      where: { task_: { taskManager: $taskManager } }
+      orderBy: releasedAt
+      orderDirection: desc
+      first: $first
+      skip: $skip
+    ) {
+      id
+      previousClaimer
+      previousClaimerUsername
+      caller
+      callerUsername
+      selfRelease
+      releasedAt
+      transactionHash
+      task {
+        id
+        taskId
+        title
+        status
+        releaseCount
+      }
+    }
+  }
+`;

package/dist/graph/documents/token.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Token Request Queries
+ * Ported from frontend queries.js
+ */
+export declare const FETCH_PENDING_TOKEN_REQUESTS = "\n  query FetchPendingTokenRequests($tokenAddress: String!) {\n    tokenRequests(\n      where: { participationToken: $tokenAddress, status: Pending }\n      orderBy: createdAt\n      orderDirection: desc\n      first: 100\n    ) {\n      id\n      requestId\n      requester\n      amount\n      ipfsHash\n      metadata {\n        reason\n        submittedAt\n      }\n      status\n      createdAt\n      createdAtBlock\n      transactionHash\n    }\n  }\n";
+export declare const FETCH_USER_TOKEN_REQUESTS = "\n  query FetchUserTokenRequests($tokenAddress: String!, $userAddress: Bytes!) {\n    tokenRequests(\n      where: { participationToken: $tokenAddress, requester: $userAddress }\n      orderBy: createdAt\n      orderDirection: desc\n      first: 50\n    ) {\n      id\n      requestId\n      amount\n      ipfsHash\n      metadata {\n        reason\n        submittedAt\n      }\n      status\n      createdAt\n      approvedAt\n      cancelledAt\n      approver\n      transactionHash\n    }\n  }\n";
+export declare const FETCH_ALL_TOKEN_REQUESTS = "\n  query FetchAllTokenRequests($tokenAddress: String!) {\n    tokenRequests(\n      where: { participationToken: $tokenAddress }\n      orderBy: createdAt\n      orderDirection: desc\n      first: 100\n    ) {\n      id\n      requestId\n      requester\n      amount\n      ipfsHash\n      metadata {\n        reason\n        submittedAt\n      }\n      status\n      createdAt\n      approvedAt\n      cancelledAt\n      approver\n      transactionHash\n    }\n  }\n";
+/** Single holder balance + token symbol — `pop token balance`. */
+export declare const FETCH_TOKEN_BALANCE = "\n  query FetchTokenBalance($token: ID!, $balanceId: ID!) {\n    participationTokenContract(id: $token) {\n      id\n      symbol\n    }\n    tokenBalance(id: $balanceId) {\n      id\n      balance\n      updatedAt\n    }\n  }\n";
+/** Many holder balances in one round-trip — `pop vote analyze`. */
+export declare const FETCH_TOKEN_BALANCES = "\n  query FetchTokenBalances($token: String!, $accounts: [Bytes!]) {\n    tokenBalances(first: 1000, where: { participationToken: $token, account_in: $accounts }) {\n      account\n      balance\n    }\n  }\n";
+/** Compose the TokenBalance entity id from a token + holder address. */
+export declare function tokenBalanceId(tokenAddress: string, holder: string): string;

package/dist/graph/documents/token.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Token Request Queries
+ * Ported from frontend queries.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FETCH_TOKEN_BALANCES = exports.FETCH_TOKEN_BALANCE = exports.FETCH_ALL_TOKEN_REQUESTS = exports.FETCH_USER_TOKEN_REQUESTS = exports.FETCH_PENDING_TOKEN_REQUESTS = void 0;
+exports.tokenBalanceId = tokenBalanceId;
+exports.FETCH_PENDING_TOKEN_REQUESTS = `
+  query FetchPendingTokenRequests($tokenAddress: String!) {
+    tokenRequests(
+      where: { participationToken: $tokenAddress, status: Pending }
+      orderBy: createdAt
+      orderDirection: desc
+      first: 100
+    ) {
+      id
+      requestId
+      requester
+      amount
+      ipfsHash
+      metadata {
+        reason
+        submittedAt
+      }
+      status
+      createdAt
+      createdAtBlock
+      transactionHash
+    }
+  }
+`;
+exports.FETCH_USER_TOKEN_REQUESTS = `
+  query FetchUserTokenRequests($tokenAddress: String!, $userAddress: Bytes!) {
+    tokenRequests(
+      where: { participationToken: $tokenAddress, requester: $userAddress }
+      orderBy: createdAt
+      orderDirection: desc
+      first: 50
+    ) {
+      id
+      requestId
+      amount
+      ipfsHash
+      metadata {
+        reason
+        submittedAt
+      }
+      status
+      createdAt
+      approvedAt
+      cancelledAt
+      approver
+      transactionHash
+    }
+  }
+`;
+exports.FETCH_ALL_TOKEN_REQUESTS = `
+  query FetchAllTokenRequests($tokenAddress: String!) {
+    tokenRequests(
+      where: { participationToken: $tokenAddress }
+      orderBy: createdAt
+      orderDirection: desc
+      first: 100
+    ) {
+      id
+      requestId
+      requester
+      amount
+      ipfsHash
+      metadata {
+        reason
+        submittedAt
+      }
+      status
+      createdAt
+      approvedAt
+      cancelledAt
+      approver
+      transactionHash
+    }
+  }
+`;
+// ─────────────────────── ParticipationToken balances ───────────────────────
+//
+// TokenBalance is a complete mirror of ERC20 balanceOf: verified live on
+// poa-gnosis-v-1 that sum(TokenBalance.balance) == ParticipationTokenContract
+// .totalSupply for a token with multiple holders (0x5cafc2fa…, 3 rows,
+// 8273e18 both sides). Row id is `${tokenAddress}-${holderAddress}`, both
+// lowercase.
+//
+// ParticipationTokenContract.symbol is populated on every live row ('PT',
+// 'KUBIX', 'TEST'), which is strictly better than the hardcoded 'PT' guess the
+// balance command used when the symbol() call failed.
+//
+// NOTE for future work: ParticipationTokenContract.executor and .hatsContract
+// exist in this same schema but are ZERO on all 9 live Gnosis rows, and
+// memberHatIds/approverHatIds are not indexed at all — the token hat gates
+// still have to be read from the contract (see src/commands/token/helpers.ts).
+/** Single holder balance + token symbol — `pop token balance`. */
+exports.FETCH_TOKEN_BALANCE = `
+  query FetchTokenBalance($token: ID!, $balanceId: ID!) {
+    participationTokenContract(id: $token) {
+      id
+      symbol
+    }
+    tokenBalance(id: $balanceId) {
+      id
+      balance
+      updatedAt
+    }
+  }
+`;
+/** Many holder balances in one round-trip — `pop vote analyze`. */
+exports.FETCH_TOKEN_BALANCES = `
+  query FetchTokenBalances($token: String!, $accounts: [Bytes!]) {
+    tokenBalances(first: 1000, where: { participationToken: $token, account_in: $accounts }) {
+      account
+      balance
+    }
+  }
+`;
+/** Compose the TokenBalance entity id from a token + holder address. */
+function tokenBalanceId(tokenAddress, holder) {
+    return `${tokenAddress.toLowerCase()}-${holder.toLowerCase()}`;
+}

package/dist/graph/documents/treasury.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Treasury Queries
+ * Ported from frontend queries.js
+ */
+export declare const FETCH_TREASURY_DATA = "\n  query FetchTreasuryData($orgId: Bytes!) {\n    organization(id: $orgId) {\n      id\n      executorContract {\n        id\n        isPaused\n        owner\n        allowedCaller\n        sweeps(first: 50, orderBy: sweptAt, orderDirection: desc) {\n          id\n          to\n          amount\n          sweptAt\n          transactionHash\n        }\n      }\n      participationToken {\n        id\n        name\n        symbol\n        totalSupply\n      }\n      paymentManager {\n        id\n        owner\n        revenueShareToken\n        distributionCounter\n        distributions(first: 100, orderBy: createdAt, orderDirection: desc) {\n          id\n          distributionId\n          payoutToken\n          totalAmount\n          totalClaimed\n          checkpointBlock\n          createdAtBlock\n          merkleRoot\n          status\n          createdAt\n          finalizedAt\n          unclaimedAmount\n          claims(first: 200) {\n            id\n            claimer\n            claimerUsername\n            amount\n            claimedAt\n            transactionHash\n          }\n        }\n        payments(first: 100, orderBy: receivedAt, orderDirection: desc) {\n          id\n          payer\n          payerUsername\n          amount\n          token\n          receivedAt\n          transactionHash\n        }\n      }\n    }\n  }\n";
+/**
+ * Subgraph entity id for a distribution: `<paymentManager>-<distributionId>`, with the
+ * PaymentManager address lower-cased (the mapping keys off `event.address`, which the Graph
+ * node serialises lower-case). Verified against live Gnosis rows, e.g.
+ * `0x409f51250dc5c66bb1d6952f947d841192f1140e-1`.
+ */
+export declare function distributionEntityId(paymentManager: string, distributionId: number | string): string;
+/**
+ * One distribution, by entity id — the indexed twin of PaymentManager.getDistribution().
+ *
+ * Field mapping (all six on-chain struct members that have a getter):
+ *   payoutToken     -> payoutToken
+ *   totalAmount     -> totalAmount
+ *   checkpointBlock -> checkpointBlock
+ *   merkleRoot      -> merkleRoot
+ *   totalClaimed    -> totalClaimed
+ *   finalized       -> status == "Finalized"   (enum is exactly Active | Finalized)
+ *
+ * Plus `createdAtBlock`, which the contract has NO getter for — `Distribution.creationBlock`
+ * is private state — so the subgraph is the only source for it. All of these are populated on
+ * every live Gnosis row (verified 2026-07: 5/5 distributions non-null on every field) and the
+ * whole field set also exists on the Arbitrum deployment
+ * (QmYGCS4pXoaqXX7WjaPEhA56kiwgC14z7jsstZzEQgxgUp), so no queryWithFieldFallback tier is needed.
+ *
+ * `distribution(id:)` returns null (not an error) for an unknown id, which callers MUST treat as
+ * "not indexed yet" and resolve on-chain — never as DistributionNotFound.
+ */
+export declare const FETCH_DISTRIBUTION_BY_ID = "\n  query FetchDistributionById($id: ID!) {\n    distribution(id: $id) {\n      id\n      distributionId\n      payoutToken\n      totalAmount\n      totalClaimed\n      checkpointBlock\n      createdAtBlock\n      merkleRoot\n      status\n    }\n  }\n";
+/**
+ * Every still-claimable distribution for an org, with the claim log needed to skip the ones
+ * this wallet already took. Shared by `pop treasury claim-mine`; `pop treasury claim` reads the
+ * single-distribution form above so the two commands agree on one source for the same values.
+ */
+export declare const FETCH_ACTIVE_DISTRIBUTIONS = "\n  query FetchActiveDistributions($orgId: Bytes!) {\n    organization(id: $orgId) {\n      paymentManager {\n        distributions(where: { status: \"Active\" }, first: 50) {\n          distributionId\n          totalAmount\n          merkleRoot\n          checkpointBlock\n          payoutToken\n          claims { claimer }\n        }\n      }\n    }\n  }\n";

package/dist/graph/documents/treasury.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Treasury Queries
+ * Ported from frontend queries.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FETCH_ACTIVE_DISTRIBUTIONS = exports.FETCH_DISTRIBUTION_BY_ID = exports.FETCH_TREASURY_DATA = void 0;
+exports.distributionEntityId = distributionEntityId;
+exports.FETCH_TREASURY_DATA = `
+  query FetchTreasuryData($orgId: Bytes!) {
+    organization(id: $orgId) {
+      id
+      executorContract {
+        id
+        isPaused
+        owner
+        allowedCaller
+        sweeps(first: 50, orderBy: sweptAt, orderDirection: desc) {
+          id
+          to
+          amount
+          sweptAt
+          transactionHash
+        }
+      }
+      participationToken {
+        id
+        name
+        symbol
+        totalSupply
+      }
+      paymentManager {
+        id
+        owner
+        revenueShareToken
+        distributionCounter
+        distributions(first: 100, orderBy: createdAt, orderDirection: desc) {
+          id
+          distributionId
+          payoutToken
+          totalAmount
+          totalClaimed
+          checkpointBlock
+          createdAtBlock
+          merkleRoot
+          status
+          createdAt
+          finalizedAt
+          unclaimedAmount
+          claims(first: 200) {
+            id
+            claimer
+            claimerUsername
+            amount
+            claimedAt
+            transactionHash
+          }
+        }
+        payments(first: 100, orderBy: receivedAt, orderDirection: desc) {
+          id
+          payer
+          payerUsername
+          amount
+          token
+          receivedAt
+          transactionHash
+        }
+      }
+    }
+  }
+`;
+/**
+ * Subgraph entity id for a distribution: `<paymentManager>-<distributionId>`, with the
+ * PaymentManager address lower-cased (the mapping keys off `event.address`, which the Graph
+ * node serialises lower-case). Verified against live Gnosis rows, e.g.
+ * `0x409f51250dc5c66bb1d6952f947d841192f1140e-1`.
+ */
+function distributionEntityId(paymentManager, distributionId) {
+    return `${paymentManager.toLowerCase()}-${distributionId}`;
+}
+/**
+ * One distribution, by entity id — the indexed twin of PaymentManager.getDistribution().
+ *
+ * Field mapping (all six on-chain struct members that have a getter):
+ *   payoutToken     -> payoutToken
+ *   totalAmount     -> totalAmount
+ *   checkpointBlock -> checkpointBlock
+ *   merkleRoot      -> merkleRoot
+ *   totalClaimed    -> totalClaimed
+ *   finalized       -> status == "Finalized"   (enum is exactly Active | Finalized)
+ *
+ * Plus `createdAtBlock`, which the contract has NO getter for — `Distribution.creationBlock`
+ * is private state — so the subgraph is the only source for it. All of these are populated on
+ * every live Gnosis row (verified 2026-07: 5/5 distributions non-null on every field) and the
+ * whole field set also exists on the Arbitrum deployment
+ * (QmYGCS4pXoaqXX7WjaPEhA56kiwgC14z7jsstZzEQgxgUp), so no queryWithFieldFallback tier is needed.
+ *
+ * `distribution(id:)` returns null (not an error) for an unknown id, which callers MUST treat as
+ * "not indexed yet" and resolve on-chain — never as DistributionNotFound.
+ */
+exports.FETCH_DISTRIBUTION_BY_ID = `
+  query FetchDistributionById($id: ID!) {
+    distribution(id: $id) {
+      id
+      distributionId
+      payoutToken
+      totalAmount
+      totalClaimed
+      checkpointBlock
+      createdAtBlock
+      merkleRoot
+      status
+    }
+  }
+`;
+/**
+ * Every still-claimable distribution for an org, with the claim log needed to skip the ones
+ * this wallet already took. Shared by `pop treasury claim-mine`; `pop treasury claim` reads the
+ * single-distribution form above so the two commands agree on one source for the same values.
+ */
+exports.FETCH_ACTIVE_DISTRIBUTIONS = `
+  query FetchActiveDistributions($orgId: Bytes!) {
+    organization(id: $orgId) {
+      paymentManager {
+        distributions(where: { status: "Active" }, first: 50) {
+          distributionId
+          totalAmount
+          merkleRoot
+          checkpointBlock
+          payoutToken
+          claims { claimer }
+        }
+      }
+    }
+  }
+`;