@poa-box/agent 0.1.0

package/dist/commands/agent/daily-digest.js

@@ -0,0 +1,336 @@
+"use strict";
+/**
+ * pop agent daily-digest — auto-summarize cross-agent activity for operator
+ * status checks. Task #405.
+ *
+ * Answers "what have the agents done today?" without manual git-log / subgraph
+ * digging. Pulls from git log (local) + subgraph (remote) and produces a
+ * structured summary per agent.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dailyDigestHandler = void 0;
+const child_process_1 = require("child_process");
+const ethers_1 = require("ethers");
+const subgraph_1 = require("@poa-box/cli/lib/subgraph");
+const resolve_1 = require("@poa-box/cli/lib/resolve");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+function parseSinceDuration(since) {
+    const match = since.match(/^(\d+)\s*(h|d|m)$/i);
+    if (!match)
+        return 24 * 3600;
+    const [, numStr, unit] = match;
+    const num = parseInt(numStr, 10);
+    if (unit === 'h')
+        return num * 3600;
+    if (unit === 'd')
+        return num * 86400;
+    if (unit === 'm')
+        return num * 60;
+    return 24 * 3600;
+}
+const FETCH_DIGEST_DATA = `
+  query FetchDigestData($orgId: Bytes!) {
+    organization(id: $orgId) {
+      name
+      participationToken { totalSupply symbol }
+      users(first: 100) {
+        address
+        membershipStatus
+        participationTokenBalance
+        totalTasksCompleted
+        totalVotes
+        account { username }
+      }
+      hybridVoting {
+        proposals(first: 100, orderBy: proposalId, orderDirection: desc) {
+          proposalId
+          title
+          status
+          votes {
+            voter
+            voterUsername
+          }
+        }
+      }
+      taskManager {
+        projects(where: { deleted: false }, first: 100) {
+          title
+          tasks(first: 1000) {
+            taskId
+            title
+            status
+            payout
+            assignee
+            assigneeUsername
+            completer
+            completerUsername
+            createdAt
+            assignedAt
+            submittedAt
+            completedAt
+          }
+        }
+      }
+    }
+  }
+`;
+function getGitCommits(sinceSec) {
+    try {
+        const sinceDate = new Date(Date.now() - sinceSec * 1000).toISOString();
+        const raw = (0, child_process_1.execSync)(`git log --since="${sinceDate}" --format="%H|%an|%aI|%s" --no-merges 2>/dev/null`, { encoding: 'utf-8', timeout: 10000 }).trim();
+        if (!raw)
+            return [];
+        return raw.split('\n').map((line) => {
+            const [hash, author, date, ...msg] = line.split('|');
+            return { hash: hash.slice(0, 8), author, date, message: msg.join('|') };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function getGitPRsMerged(sinceSec) {
+    try {
+        const sinceDate = new Date(Date.now() - sinceSec * 1000).toISOString();
+        const raw = (0, child_process_1.execSync)(`git log --since="${sinceDate}" --merges --format="%s" 2>/dev/null`, { encoding: 'utf-8', timeout: 10000 }).trim();
+        return raw ? raw.split('\n').filter((l) => /merge pull request|merge.*pr/i.test(l)).length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+exports.dailyDigestHandler = {
+    builder: (yargs) => yargs
+        .option('since', {
+        type: 'string',
+        default: '24h',
+        describe: 'Time window: 6h, 12h, 24h, 48h, 7d',
+    })
+        .option('per-agent', {
+        type: 'boolean',
+        default: false,
+        describe: 'Group activity by agent',
+    }),
+    handler: async (argv) => {
+        const spin = output.spinner('Generating daily digest...');
+        spin.start();
+        try {
+            const sinceSec = parseSinceDuration(argv.since || '24h');
+            const sinceTs = Math.floor(Date.now() / 1000) - sinceSec;
+            const modules = await (0, resolve_1.resolveOrgModules)(argv.org, argv.chain);
+            const result = await (0, subgraph_1.query)(FETCH_DIGEST_DATA, { orgId: modules.orgId }, argv.chain);
+            const org = result.organization;
+            if (!org)
+                throw new Error('Organization not found');
+            const activeMembers = org.users.filter((u) => u.membershipStatus === 'Active');
+            const ptSupply = parseFloat(ethers_1.ethers.utils.formatEther(org.participationToken?.totalSupply || '0'));
+            // All tasks flat
+            const allTasks = (org.taskManager?.projects || []).flatMap((p) => p.tasks || []);
+            // Filter tasks by window
+            const tasksCreated = allTasks.filter((t) => parseInt(t.createdAt || '0') >= sinceTs);
+            const tasksClaimed = allTasks.filter((t) => parseInt(t.assignedAt || '0') >= sinceTs && t.assignee);
+            const tasksSubmitted = allTasks.filter((t) => parseInt(t.submittedAt || '0') >= sinceTs);
+            const tasksCompleted = allTasks.filter((t) => parseInt(t.completedAt || '0') >= sinceTs);
+            // PT earned in window
+            const ptEarnedInWindow = tasksCompleted.reduce((s, t) => s + parseFloat(ethers_1.ethers.utils.formatEther(t.payout || '0')), 0);
+            // Proposals — subgraph lacks createdAt on Proposal/Vote, so we show
+            // current state (active proposals, total votes) rather than windowed.
+            const proposals = org.hybridVoting?.proposals || [];
+            const activeProposals = proposals.filter((p) => p.status === 'Active');
+            const totalVotesCast = proposals.reduce((s, p) => s + (p.votes || []).length, 0);
+            // Pending reviews
+            const pendingReviews = allTasks.filter((t) => t.status === 'Submitted');
+            // Git activity
+            const commits = getGitCommits(sinceSec);
+            const prsMerged = getGitPRsMerged(sinceSec);
+            // Per-agent breakdown
+            const agentMap = {};
+            const ensureAgent = (addr, username) => {
+                const key = addr.toLowerCase();
+                if (!agentMap[key]) {
+                    agentMap[key] = { username: username || addr.slice(0, 10), commits: 0, tasksCreated: [], tasksClaimed: [], tasksSubmitted: [], tasksCompleted: [], votescast: 0, ptEarned: 0 };
+                }
+                return agentMap[key];
+            };
+            // Map git authors to agents (best-effort)
+            for (const c of commits) {
+                // Try to match git author to an agent. ClawDAOBot is the shared bot.
+                const authorLower = c.author.toLowerCase();
+                if (authorLower === 'clawdaobot') {
+                    // Task IDs in commit messages: "Task #NNN"
+                    const taskMatch = c.message.match(/task\s+#?(\d+)/i);
+                    if (taskMatch) {
+                        const tid = taskMatch[1];
+                        const task = allTasks.find((t) => String(t.taskId) === tid);
+                        if (task?.assignee) {
+                            ensureAgent(task.assignee, task.assigneeUsername || '').commits++;
+                            continue;
+                        }
+                    }
+                }
+                // Fallback: attribute to first member matching author name
+                const member = activeMembers.find((m) => (m.account?.username || '').toLowerCase() === authorLower);
+                if (member) {
+                    ensureAgent(member.address, member.account?.username || '').commits++;
+                }
+            }
+            for (const t of tasksClaimed) {
+                const a = ensureAgent(t.assignee, t.assigneeUsername || '');
+                a.tasksClaimed.push(`#${t.taskId} ${t.title}`);
+            }
+            for (const t of tasksSubmitted) {
+                if (t.assignee) {
+                    const a = ensureAgent(t.assignee, t.assigneeUsername || '');
+                    a.tasksSubmitted.push(`#${t.taskId} ${t.title}`);
+                }
+            }
+            for (const t of tasksCompleted) {
+                if (t.completer) {
+                    const a = ensureAgent(t.completer, t.completerUsername || '');
+                    a.tasksCompleted.push(`#${t.taskId} ${t.title}`);
+                    a.ptEarned += parseFloat(ethers_1.ethers.utils.formatEther(t.payout || '0'));
+                }
+            }
+            // Attribute votes from active + recent proposals to agents
+            for (const p of proposals) {
+                for (const v of (p.votes || [])) {
+                    ensureAgent(v.voter, v.voterUsername || '').votescast++;
+                }
+            }
+            spin.stop();
+            const digest = {
+                org: org.name,
+                window: argv.since || '24h',
+                windowStart: new Date(sinceTs * 1000).toISOString(),
+                summary: {
+                    commits: commits.length,
+                    prsMerged,
+                    tasksCreated: tasksCreated.length,
+                    tasksClaimed: tasksClaimed.length,
+                    tasksSubmitted: tasksSubmitted.length,
+                    tasksCompleted: tasksCompleted.length,
+                    ptEarned: Math.round(ptEarnedInWindow * 10) / 10,
+                    ptSupply: Math.round(ptSupply * 10) / 10,
+                    totalVotesCast,
+                    activeProposals: activeProposals.length,
+                },
+                activeProposals: activeProposals.map((p) => ({
+                    id: p.proposalId,
+                    title: p.title,
+                    status: p.status,
+                    votes: (p.votes || []).length,
+                })),
+                pendingReviews: pendingReviews.map((t) => ({
+                    taskId: t.taskId,
+                    title: t.title,
+                    assignee: t.assigneeUsername || t.assignee?.slice(0, 10),
+                })),
+                perAgent: argv['per-agent'] ? Object.values(agentMap) : undefined,
+                blocked: [
+                    'Content distribution credentials (Twitter/Mirror) — Hudson-gated',
+                    'Branch protection on main — requires repo admin (task #402)',
+                    'Cross-org vouching (tasks #230, #277) — Hudson-gated',
+                ],
+            };
+            if (output.isJsonMode()) {
+                output.json(digest);
+                return;
+            }
+            console.log('');
+            console.log(`  Daily Digest — ${org.name} (last ${argv.since || '24h'})`);
+            console.log('  ══════════════════════════════════════════');
+            console.log('');
+            console.log('  Activity Summary');
+            console.log('  ────────────────');
+            console.log(`  Commits:            ${commits.length}`);
+            if (prsMerged > 0)
+                console.log(`  PRs merged:         ${prsMerged}`);
+            console.log(`  Tasks created:      ${tasksCreated.length}`);
+            console.log(`  Tasks claimed:      ${tasksClaimed.length}`);
+            console.log(`  Tasks submitted:    ${tasksSubmitted.length}`);
+            console.log(`  Tasks completed:    ${tasksCompleted.length} (${ptEarnedInWindow.toFixed(1)} PT earned)`);
+            console.log(`  Total votes (all):  ${totalVotesCast}`);
+            console.log(`  PT supply:          ${ptSupply.toFixed(1)}`);
+            if (activeProposals.length > 0) {
+                console.log('');
+                console.log('  Active Proposals');
+                console.log('  ────────────────');
+                for (const p of activeProposals) {
+                    console.log(`  #${p.proposalId} ${p.title} (${(p.votes || []).length} votes)`);
+                }
+            }
+            if (pendingReviews.length > 0) {
+                console.log('');
+                console.log('  Pending Reviews');
+                console.log('  ───────────────');
+                for (const t of pendingReviews) {
+                    console.log(`  #${t.taskId} "${t.title}" by ${t.assigneeUsername || t.assignee?.slice(0, 10)}`);
+                }
+            }
+            if (argv['per-agent']) {
+                console.log('');
+                console.log('  Per-Agent Breakdown');
+                console.log('  ──────────────────');
+                for (const a of Object.values(agentMap)) {
+                    console.log(`\n  ${a.username}`);
+                    console.log(`    Commits: ${a.commits} | Votes: ${a.votescast} | PT earned: ${a.ptEarned.toFixed(1)}`);
+                    if (a.tasksSubmitted.length > 0) {
+                        console.log('    Submitted:');
+                        for (const t of a.tasksSubmitted)
+                            console.log(`      ${t}`);
+                    }
+                    if (a.tasksCompleted.length > 0) {
+                        console.log('    Completed (reviewed):');
+                        for (const t of a.tasksCompleted)
+                            console.log(`      ${t}`);
+                    }
+                }
+            }
+            console.log('');
+            console.log('  Still Blocked');
+            console.log('  ─────────────');
+            for (const b of digest.blocked) {
+                console.log(`  • ${b}`);
+            }
+            console.log('');
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/delegate.d.ts

@@ -0,0 +1,12 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface DelegateArgs {
+    chain?: number;
+    rpc?: string;
+    'private-key'?: string;
+    'dry-run'?: boolean;
+}
+export declare const delegateHandler: {
+    builder: (yargs: Argv) => Argv<{}>;
+    handler: (argv: ArgumentsCamelCase<DelegateArgs>) => Promise<void>;
+};
+export {};

package/dist/commands/agent/delegate.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delegateHandler = void 0;
+const accounts_1 = require("viem/accounts");
+const sponsored_1 = require("@poa-box/cli/lib/sponsored");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+exports.delegateHandler = {
+    builder: (yargs) => yargs,
+    handler: async (argv) => {
+        const spin = output.spinner('Setting up EIP-7702 delegation...');
+        spin.start();
+        try {
+            const key = argv.privateKey || process.env.POP_PRIVATE_KEY;
+            if (!key)
+                throw new Error('No private key configured');
+            const account = (0, accounts_1.privateKeyToAccount)(key);
+            const rpcUrl = argv.rpc || 'https://rpc.gnosischain.com';
+            // Check if already delegated
+            spin.text = 'Checking delegation status...';
+            const alreadyDelegated = await (0, sponsored_1.isDelegated)(account.address, rpcUrl);
+            if (alreadyDelegated) {
+                spin.stop();
+                if (output.isJsonMode()) {
+                    output.json({ status: 'already_delegated', address: account.address, delegate: sponsored_1.EOA_DELEGATION });
+                }
+                else {
+                    output.info(`Already delegated to EOADelegation (${sponsored_1.EOA_DELEGATION})`);
+                }
+                return;
+            }
+            if (argv.dryRun) {
+                spin.stop();
+                output.success('Delegation ready (dry-run)', {
+                    address: account.address,
+                    delegate: sponsored_1.EOA_DELEGATION,
+                    action: 'Would sign EIP-7702 authorization and send delegation transaction',
+                });
+                return;
+            }
+            // Delegate
+            spin.text = 'Signing EIP-7702 authorization...';
+            const txHash = await (0, sponsored_1.delegateEOA)(key, rpcUrl);
+            spin.stop();
+            output.success('EOA delegated to EOADelegation', {
+                address: account.address,
+                delegate: sponsored_1.EOA_DELEGATION,
+                txHash,
+                explorerUrl: `https://gnosisscan.io/tx/${txHash}`,
+                note: 'Your EOA can now receive sponsored UserOperations via PaymasterHub.',
+            });
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/deploy-to-org.d.ts

@@ -0,0 +1,20 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface DeployToOrgArgs {
+    'target-org': string;
+    chain: number;
+    username?: string;
+    rpc?: string;
+    'private-key'?: string;
+    'dry-run'?: boolean;
+}
+export declare const deployToOrgHandler: {
+    builder: (yargs: Argv) => Argv<{
+        "target-org": string;
+    } & {
+        chain: number;
+    } & {
+        username: string | undefined;
+    }>;
+    handler: (argv: ArgumentsCamelCase<DeployToOrgArgs>) => Promise<void>;
+};
+export {};

package/dist/commands/agent/deploy-to-org.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployToOrgHandler = void 0;
+const ethers_1 = require("ethers");
+const signer_1 = require("@poa-box/cli/lib/signer");
+const networks_1 = require("@poa-box/cli/config/networks");
+const output = __importStar(require("@poa-box/cli/lib/output"));
+const IDENTITY_REGISTRY = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432';
+const EOA_DELEGATION = '0x776ec88A88E86e38d54a985983377f1A2A25ef8b';
+exports.deployToOrgHandler = {
+    builder: (yargs) => yargs
+        .option('target-org', { type: 'string', demandOption: true, describe: 'Target org name' })
+        .option('chain', { type: 'number', demandOption: true, describe: 'Target chain ID' })
+        .option('username', { type: 'string', describe: 'Username to register (if not already registered)' }),
+    handler: async (argv) => {
+        const spin = output.spinner('Preparing cross-org deployment...');
+        spin.start();
+        try {
+            const networkConfig = (0, networks_1.resolveNetworkConfig)(argv.chain);
+            const { signer } = (0, signer_1.createSigner)({ privateKey: argv.privateKey, chainId: argv.chain, rpcUrl: argv.rpc });
+            const provider = new ethers_1.ethers.providers.JsonRpcProvider(networkConfig.resolvedRpc);
+            const steps = [];
+            // Step 1: Check wallet balance on target chain
+            spin.text = 'Checking wallet balance...';
+            const balance = await provider.getBalance(signer.address);
+            const balanceEth = ethers_1.ethers.utils.formatEther(balance);
+            const hasGas = balance.gt(ethers_1.ethers.utils.parseEther('0.001'));
+            steps.push({
+                step: 'Wallet balance',
+                status: hasGas ? 'OK' : 'NEEDS_FUNDING',
+                detail: `${balanceEth} ${networkConfig.nativeCurrency.symbol}`,
+            });
+            // Step 2: Check ERC-8004 registration on target chain
+            spin.text = 'Checking ERC-8004 identity...';
+            const registryAbi = ['function balanceOf(address) view returns (uint256)'];
+            const registry = new ethers_1.ethers.Contract(IDENTITY_REGISTRY, registryAbi, provider);
+            let hasIdentity = false;
+            try {
+                const idBalance = await registry.balanceOf(signer.address);
+                hasIdentity = idBalance.gt(0);
+            }
+            catch { /* registry might not exist on this chain */ }
+            steps.push({
+                step: 'ERC-8004 identity',
+                status: hasIdentity ? 'REGISTERED' : 'NOT_REGISTERED',
+                detail: hasIdentity ? 'Agent identity exists on target chain' : 'Run pop agent register --chain ' + argv.chain,
+            });
+            // Step 3: Check delegation
+            spin.text = 'Checking EIP-7702 delegation...';
+            let isDelegated = false;
+            try {
+                const code = await provider.getCode(signer.address);
+                isDelegated = code.length > 2 && code.startsWith('0xef0100');
+            }
+            catch { /* not delegated */ }
+            steps.push({
+                step: 'EIP-7702 delegation',
+                status: isDelegated ? 'DELEGATED' : 'NOT_DELEGATED',
+                detail: isDelegated ? 'EOA delegated to EOADelegation' : 'Run pop agent delegate --chain ' + argv.chain,
+            });
+            // Step 4: Check if org exists on target chain
+            spin.text = 'Checking target org...';
+            const orgQuery = `query($name: String!) { organizations(where: { name: $name }, first: 1) { id name users(first: 100) { address membershipStatus account { username } } } }`;
+            const { queryAllChains } = require('@poa-box/cli/lib/subgraph');
+            let orgFound = false;
+            let isMember = false;
+            let orgMembers = 0;
+            for (const r of await queryAllChains(orgQuery, { name: argv.targetOrg })) {
+                const org = r.data?.organizations?.[0];
+                if (org && r.chainId === argv.chain) {
+                    orgFound = true;
+                    orgMembers = org.users?.length || 0;
+                    isMember = (org.users || []).some((u) => u.address?.toLowerCase() === signer.address.toLowerCase());
+                }
+            }
+            steps.push({
+                step: 'Target org',
+                status: orgFound ? (isMember ? 'MEMBER' : 'FOUND') : 'NOT_FOUND',
+                detail: orgFound ? `${argv.targetOrg} (${orgMembers} members)${isMember ? ' — already a member!' : ''}` : `${argv.targetOrg} not found on chain ${argv.chain}`,
+            });
+            spin.stop();
+            // Summary
+            const ready = hasGas && orgFound;
+            const needsAction = steps.filter(s => !['OK', 'REGISTERED', 'DELEGATED', 'MEMBER', 'FOUND'].includes(s.status));
+            if (output.isJsonMode()) {
+                output.json({ targetOrg: argv.targetOrg, chain: argv.chain, address: signer.address, steps, ready, needsAction: needsAction.length });
+            }
+            else {
+                console.log('');
+                console.log(`  Cross-Org Deployment: ${signer.address.slice(0, 10)}... → ${argv.targetOrg}`);
+                console.log('  ' + '═'.repeat(50));
+                for (const s of steps) {
+                    const icon = ['OK', 'REGISTERED', 'DELEGATED', 'MEMBER'].includes(s.status) ? '✓' : s.status === 'FOUND' ? '○' : '✗';
+                    console.log(`  ${icon} ${s.step}: ${s.detail}`);
+                }
+                console.log('');
+                if (isMember) {
+                    console.log('  ✓ Already a member of this org!');
+                }
+                else if (ready) {
+                    console.log('  Ready to deploy. Next steps:');
+                    console.log(`    1. Ask a ${argv.targetOrg} member to vouch for you`);
+                    console.log(`    2. pop vouch claim --hat <hat-id> --chain ${argv.chain}`);
+                    if (!hasIdentity)
+                        console.log(`    3. pop agent register --name <name> --chain ${argv.chain}`);
+                    if (!isDelegated)
+                        console.log(`    ${hasIdentity ? '3' : '4'}. pop agent delegate --chain ${argv.chain}`);
+                }
+                else {
+                    console.log('  Not ready. Fix issues marked ✗ above.');
+                }
+                console.log('');
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err.message);
+            process.exit(1);
+        }
+    },
+};

package/dist/commands/agent/index.d.ts

@@ -0,0 +1,2 @@
+import type { Argv } from 'yargs';
+export declare function registerAgentCommands(yargs: Argv): Argv<{}>;

package/dist/commands/agent/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentCommands = registerAgentCommands;
+const status_1 = require("./status");
+const triage_1 = require("./triage");
+const register_1 = require("./register");
+const delegate_1 = require("./delegate");
+const setup_sponsorship_1 = require("./setup-sponsorship");
+const paymaster_status_1 = require("./paymaster-status");
+const onboard_1 = require("./onboard");
+const deploy_to_org_1 = require("./deploy-to-org");
+const init_1 = require("./init");
+const daily_digest_1 = require("./daily-digest");
+function registerAgentCommands(yargs) {
+    return yargs
+        .command('status', 'Show agent operational status and action items', status_1.agentStatusHandler.builder, status_1.agentStatusHandler.handler)
+        .command('triage', 'Prioritized action plan for current heartbeat', triage_1.triageHandler.builder, triage_1.triageHandler.handler)
+        .command('daily-digest', 'Summarize cross-agent activity for operator status checks', daily_digest_1.dailyDigestHandler.builder, daily_digest_1.dailyDigestHandler.handler)
+        .command('register', 'Register agent identity on ERC-8004', register_1.registerHandler.builder, register_1.registerHandler.handler)
+        .command('delegate', 'Set up EIP-7702 delegation for gas sponsorship', delegate_1.delegateHandler.builder, delegate_1.delegateHandler.handler)
+        .command('setup-sponsorship', 'Set up full gas sponsorship (delegate + budget + fee caps)', setup_sponsorship_1.setupSponsorshipHandler.builder, setup_sponsorship_1.setupSponsorshipHandler.handler)
+        .command('paymaster-status', 'Show gas sponsorship status (budgets, deposits, fee caps)', paymaster_status_1.paymasterStatusHandler.builder, paymaster_status_1.paymasterStatusHandler.handler)
+        .command('onboard', 'Complete agent onboarding: register + delegate + identity + brain', onboard_1.onboardHandler.builder, onboard_1.onboardHandler.handler)
+        .command('deploy-to-org', 'Check readiness for cross-org deployment', deploy_to_org_1.deployToOrgHandler.builder, deploy_to_org_1.deployToOrgHandler.handler)
+        .command('init', 'Initialize a new agent (brain files, wallet, bootstrap checklist)', init_1.initHandler.builder, init_1.initHandler.handler)
+        .demandCommand(1, 'Please specify an agent action');
+}

package/dist/commands/agent/init.d.ts

@@ -0,0 +1,19 @@
+import type { Argv, ArgumentsCamelCase } from 'yargs';
+interface InitArgs {
+    org: string;
+    chain: number;
+    username?: string;
+    'hat-id'?: string;
+    home?: string;
+}
+export declare const initHandler: {
+    builder: (yargs: Argv) => Argv<{
+        username: string | undefined;
+    } & {
+        "hat-id": string | undefined;
+    } & {
+        home: string | undefined;
+    }>;
+    handler: (argv: ArgumentsCamelCase<InitArgs>) => Promise<void>;
+};
+export {};