tokens-for-good 0.4.24 → 0.4.26

package/README.md

@@ -48,7 +48,6 @@ Once installed, these are available to your AI via the MCP server:
 
 | Tool | Purpose |
 |---|---|
-| `next_action` | Tells you whether to validate, consolidate, or research next |
 | `claim_org` | Reserves the next available nonprofit (up to 2 researchers per org under v3) |
 | `get_methodology` | Fetches research / verify / humanize / validate / consolidate instructions |
 | `submit_report` | Submits a finished report (or a merged consolidation report with `disagreement_rows`) |
@@ -58,7 +57,7 @@ Once installed, these are available to your AI via the MCP server:
 | `set_role_preference` | Prefer the low-fetch roles (validation/consolidation); best for local models |
 | `create_agent` / `list_agents` / `rotate_agent_key` / `revoke_agent` | Run several harnesses at once: each agent gets its own key + research slot |
 | `setup_automation` | Emits `/schedule` prompt (normally called by `/tfg-schedule` skill) |
-| `my_impact` / `research_status` / `get_badge` | Stats, leaderboard, GitHub README badge |
+| `my_impact` / `research_status` | Your stats + the project leaderboard |
 | `snooze` | Quiet the session-start prompt for N days |
 
 ## Non-Claude-Code platforms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "type": "module",
   "description": "Contribute your spare AI tokens to research nonprofits for Fierce Philanthropy",
   "homepage": "https://tokensforgood.ai",

package/pipeline/01-research/PROMPT.md

@@ -183,7 +183,7 @@ Run these checks before submitting. They are not optional.
 - [ ] EVIDENCE TABLE quotes appear verbatim on the cited pages (substring-checked at submit time)
 
 **Writing style:**
-- [ ] No em dashes (, ). Replace with periods, commas, or parentheses.
+- [ ] No em dashes. Replace with periods, commas, semicolons, or parentheses.
 - [ ] No filler adjectives: seamless, robust, comprehensive, innovative, cutting-edge, holistic, game-changing
 - [ ] No AI transitions: "It's worth noting", "Here's the thing", "Let's dive in", "Simply put"
 - [ ] Replace "leverage" with "use", "utilize" with "use"

package/src/cli.js

@@ -50,19 +50,18 @@ if (args.includes('-v') || args.includes('--version')) {
   try {
     const client = new ApiClient(process.env.TFG_API_KEY || 'public', { version: pkg.version, installId: getOrCreateInstallId() });
     const status = await client.getStatus();
-    const sys = status.system_stats || status;
     console.log('\nTokens for Good - Project Status\n');
-    console.log(`Total orgs: ${sys.total_organizations ?? status.total_orgs ?? 'n/a'}`);
-    console.log(`Pending research: ${sys.pending_organizations ?? status.pending_orgs ?? 'n/a'}`);
-    console.log(`Active contributors (7d): ${sys.active_contributors_7_days ?? status.active_contributors_7d ?? 'n/a'}`);
+    console.log(`Total orgs: ${status.total_orgs ?? 'n/a'}`);
+    console.log(`Pending research: ${status.pending_orgs ?? 'n/a'}`);
+    console.log(`Active contributors (7d): ${status.active_contributors_7d ?? 'n/a'}`);
     console.log('\nQueue:');
-    for (const [k, v] of Object.entries(status.queue_status || status.queue || {})) {
+    for (const [k, v] of Object.entries(status.queue || {})) {
       console.log(`  ${k}: ${v}`);
     }
     console.log('\nTop Contributors:');
     (status.top_contributors || []).forEach((c, i) => {
-      const name = c.display_name || (c.github_handle ? '@' + c.github_handle : 'anonymous');
-      console.log(`  ${c.rank ?? i + 1}. ${name} (${c.total_organizations ?? c.total_orgs} orgs, ${c.tier})`);
+      const name = c.display_name || 'anonymous';
+      console.log(`  ${i + 1}. ${name} (${c.total_orgs} orgs, ${c.tier})`);
     });
   } catch (err) {
     console.error('Error:', err.message);

package/src/mcp-server.js

@@ -112,7 +112,7 @@ server.tool('claim_org', 'Claim the next available nonprofit org to research.',
   try {
     const result = await client.claimOrg(plat || platform);
     return {
-      content: [{ type: 'text', text: `Claimed: ${result.org.name} (${result.org.url})\nclaim_id: ${result.claim_id}\nexpires: ${result.expires_at}\nNext: get_methodology step="research", then submit_report.` }],
+      content: [{ type: 'text', text: `Claimed: ${result.org.name} (${result.org.url})\nclaim_id: ${result.claim_id}\nexpires: ${result.expires_at}\nNext: get_methodology step="research" to research, then step="verify" and step="humanize" to check citations and clean the voice, then submit_report. (The /tfg skill walks all four.)` }],
     };
   } catch (err) {
     // 409 means you already have an active claim; usually an auto-assigned
@@ -331,14 +331,13 @@ server.tool('research_status', 'See the overall Tokens for Good project progress
   try {
     const clientForStatus = client || new ApiClient('dummy', { version: PKG_VERSION, platform, installId }); // Status is public
     const result = await clientForStatus.getStatus();
-    const sys = result.system_stats || result;
-    const queue = result.queue_status || result.queue || {};
+    const queue = result.queue || {};
     const topList = result.top_contributors?.map((c, i) =>
-      `${c.rank ?? i + 1}. ${c.display_name || (c.github_handle ? '@' + c.github_handle : 'anonymous')} (${c.total_organizations ?? c.total_orgs} orgs, ${c.tier})`
+      `${i + 1}. ${c.display_name || 'anonymous'} (${c.total_orgs} orgs, ${c.tier})`
     ).join('\n') || 'No contributors yet';
 
     return {
-      content: [{ type: 'text', text: `Tokens for Good Progress:\n\nTotal orgs: ${sys.total_organizations ?? result.total_orgs}\nPending research: ${sys.pending_organizations ?? result.pending_orgs}\nActive contributors (7d): ${sys.active_contributors_7_days ?? result.active_contributors_7d}\n\nQueue:\n${Object.entries(queue).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\nTop Contributors:\n${topList}` }],
+      content: [{ type: 'text', text: `Tokens for Good Progress:\n\nTotal orgs: ${result.total_orgs}\nPending research: ${result.pending_orgs}\nActive contributors (7d): ${result.active_contributors_7d}\n\nQueue:\n${Object.entries(queue).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\nTop Contributors:\n${topList}` }],
     };
   } catch (err) {
     return { content: [{ type: 'text', text: `Error: ${err.message}` }] };

package/src/platform.js

@@ -33,7 +33,7 @@ API Base: ${base}
 Your API key: ${apiKey}
 
 ## Calling the API; read first
-Use the **Bash tool with \`curl\`** for every authenticated ${base}/* call (next-action, claim, submit, consolidate). **WebFetch will NOT work for these; it cannot send the X-TFG-Api-Key header or POST a body, so it returns 401/403 and the run fails.** Always include \`-H "X-TFG-Api-Key: ${apiKey}"\`. WebSearch and WebFetch are only for the actual web research, not for our API.
+Use the **Bash tool with \`curl\`** for every authenticated ${base}/* call (next-action, claim, submit, validate, consolidate). **WebFetch will NOT work for these; it cannot send the X-TFG-Api-Key header or POST a body, so it returns 401/403 and the run fails.** Always include \`-H "X-TFG-Api-Key: ${apiKey}"\`. WebSearch and WebFetch are only for the actual web research, not for our API.
 
 ## Instructions
 1. Fetch the batch flow (public): \`curl -s "${base}/research/schedule-instructions"\`