tokens-for-good 0.2.5 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "description": "Donate your spare AI tokens to research nonprofits for Fierce Philanthropy",
   "bin": {

package/pipeline/01-research/PROMPT.md

@@ -146,7 +146,7 @@ Inline citations as `[Source Name](URL)`. Distinguish attribution: "X reports th
 
 ### 3. Submit the Report
 
-Submit using the `submit_report` tool with the full markdown as `report_markdown`.
+Submit using the `submit_report` tool with the full markdown as `report_markdown`. Include `estimated_tokens`: count your web searches (~1K each), web fetches (~2-5K each), your report output (~4 tokens per word), plus ~10K for system/tool overhead.
 
 ## Quality Checks
 - [ ] All 5 prompt tables present and complete (20 rows each)

package/pipeline/02-verify/PROMPT.md

@@ -3,8 +3,8 @@
 ## Inputs
 
 - **Org name:** `{{ORG_NAME}}`
-- **Research report:** Read from `{{ORG_SLUG}}_Research_Report.md`
-- **Research guidance:** Read from `site/research-guidance.md`
+- **Research report:** The report from Step 1 (kept in memory from the previous step)
+- **Research guidance:** The same methodology from Step 1
 
 ## Purpose
 
@@ -65,12 +65,11 @@ For each HIGH or MEDIUM issue, write the exact correction:
 **Corrected:** [Fixed text]
 ```
 
-### 6. Apply Corrections and Write Output
+### 6. Apply Corrections and Produce Output
 
-Apply all corrections to produce a verified version of the report. Write to:
-`{{ORG_SLUG}}_02_Verified.md`
+Apply all corrections to produce a verified version of the report. Keep the result in memory for the next pipeline step (Humanize).
 
-Start the file with a verification log:
+Start the output with a verification log:
 
 ```markdown
 <!-- Verified: {{ORG_NAME}} | Date: [date] -->

package/pipeline/03-humanize/PROMPT.md

@@ -3,8 +3,8 @@
 ## Inputs
 
 - **Org name:** `{{ORG_NAME}}`
-- **Verified report:** Read from `{{ORG_SLUG}}_02_Verified.md`
-- **Writing style guide:** Read from `site/writing-style-guide.md`
+- **Verified report:** The verified report from Step 2 (kept in memory from the previous step)
+- **Writing style guide:** The AI decontamination rules below
 
 ## Purpose
 
@@ -16,7 +16,7 @@ Step 2 verified the facts. This step makes the report sound human. You are an ed
 
 Read the verified report (skip the verification log header, work on the content below the `---`).
 
-Read the writing style guide. The "AI Decontamination Rules" section is your checklist.
+The AI decontamination passes below are your checklist.
 
 ### 2. Run Each Pass
 
@@ -97,11 +97,11 @@ After all passes, verify you did NOT change:
 - [ ] The SOURCES section
 - [ ] Section separators (`---`)
 
-### 4. Write Output
+### 4. Produce Output
 
-Write to: `{{ORG_SLUG}}_03_Humanized.md`
+Keep the humanized report in memory. This is the final version that will be submitted via the `submit_report` tool.
 
-Start with a change log:
+Start the output with a change log:
 
 ```markdown
 <!-- Humanized: {{ORG_NAME}} | Date: [date] -->

package/src/mcp-server.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { ApiClient } from './api-client.js';
 import { detectPlatform, isSchedulable, getAutomationInstructions } from './platform.js';
-import { loadState, updateState, isSnoozed, hasContributedToday, markContributed } from './state.js';
+import { loadState, updateState, isSnoozed, hasContributedToday, markContributed, snoozeDays } from './state.js';
 import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -26,7 +26,7 @@ updateState({ platform });
 
 const server = new McpServer({
   name: 'tokens-for-good',
-  version: '0.2.5',
+  version: '0.2.7',
 });
 
 // --- No-key onboarding message ---
@@ -191,11 +191,11 @@ server.tool('get_methodology', 'Get the full research methodology, verification
   }
 });
 
-server.tool('submit_report', 'Submit a completed research report for an org you claimed. IMPORTANT: Estimate your token usage for this research session and pass it as estimated_tokens (input + output tokens combined).', {
+server.tool('submit_report', 'Submit a completed research report for an org you claimed. You MUST include estimated_tokens — count your web searches (each ~1K tokens), web fetches (each ~2-5K tokens), and your output (~4 tokens per word of report). Add it all up.', {
   claim_id: z.number().describe('The claim ID from claim_org'),
   report_markdown: z.string().describe('The full research report in markdown'),
   model_used: z.string().optional().describe('The model that generated this report'),
-  estimated_tokens: z.number().optional().describe('Your estimated total token usage (input + output) for this research session'),
+  estimated_tokens: z.number().describe('Estimated total tokens: count web searches (~1K each), web fetches (~2-5K each), your report output (~4 tokens/word), plus ~10K for system prompts and tool calls'),
 }, async ({ claim_id, report_markdown, model_used, estimated_tokens }) => {
   if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
 
@@ -359,6 +359,13 @@ server.tool('setup_automation', 'Get instructions for setting up automated daily
   return { content: [{ type: 'text', text: instructions }] };
 });
 
+server.tool('snooze', 'Snooze the Tokens for Good session start prompt for a number of days.', {
+  days: z.number().min(1).max(30).describe('Number of days to snooze (1 = ask tomorrow, 7 = ask in a week)'),
+}, async ({ days }) => {
+  snoozeDays(days);
+  return { content: [{ type: 'text', text: `Got it! Tokens for Good will stay quiet for ${days} day${days !== 1 ? 's' : ''}.` }] };
+});
+
 // --- Prompts (session start) ---
 
 server.prompt('session_start', 'Check if you should research an org or complete a peer review', {}, async () => {
@@ -393,7 +400,7 @@ server.prompt('session_start', 'Check if you should research an org or complete
 
   if (state.auto_schedule) {
     try {
-      const impact = await client?.getImpact();
+      const impact = await client.getImpact();
       const c = impact?.contributor;
       return {
         messages: [{
@@ -420,14 +427,14 @@ server.prompt('session_start', 'Check if you should research an org or complete
     return {
       messages: [{
         role: 'user',
-        content: { type: 'text', text: `Tokens for Good: Would you like to donate your spare tokens to research a nonprofit today?\n\n1. Set up automatic daily contributions (recommended)\n2. Just run one now\n3. Ask me tomorrow\n4. Ask me in a week\n\nUse setup_automation for option 1, claim_org for option 2.${permNote}` },
+        content: { type: 'text', text: `Tokens for Good: Would you like to donate your spare tokens to research a nonprofit today?\n\n1. Set up automatic daily contributions (recommended)\n2. Just run one now\n3. Ask me tomorrow\n4. Ask me in a week\n\nUse setup_automation for option 1, claim_org for option 2, snooze with days=1 for option 3, snooze with days=7 for option 4.${permNote}` },
       }],
     };
   } else {
     return {
       messages: [{
         role: 'user',
-        content: { type: 'text', text: `Tokens for Good: Would you like to research a nonprofit org today? It takes about 5 minutes and costs ~$0.20 in tokens.\n\n1. Research an org now\n2. Ask me tomorrow\n3. Ask me in a week\n\nUse claim_org for option 1.${permNote}` },
+        content: { type: 'text', text: `Tokens for Good: Would you like to research a nonprofit org today? It takes about 5 minutes.\n\n1. Research an org now\n2. Ask me tomorrow\n3. Ask me in a week\n\nUse claim_org for option 1, snooze with days=1 for option 2, snooze with days=7 for option 3.${permNote}` },
       }],
     };
   }

package/src/platform.js

@@ -88,7 +88,9 @@ Use WebFetch to POST to /api/research/submit:
 WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/submit
 Method: POST
 Headers: X-TFG-Api-Key: ${apiKey}, Content-Type: application/json
-Body: {"claim_id": <claim_id from step 1>, "report_markdown": "<full report>", "model_used": "claude-code-scheduled"}
+Body: {"claim_id": <claim_id from step 1>, "report_markdown": "<full report>", "model_used": "claude-code-scheduled", "token_usage": {"total_tokens": <estimated total tokens used>}}
+
+Estimate tokens: count your web searches (~1K each), web fetches (~2-5K each), report output (~4 tokens/word), plus ~10K for system/tool overhead.
 
 ### 5. Check next-action
 After submitting, check if you need to do a peer review before continuing:

package/src/state.js

@@ -64,8 +64,8 @@ export function hasContributedToday() {
 }
 
 export function markContributed() {
-  updateState({
-    last_contributed: new Date().toISOString(),
-    total_session_contributions: loadState().total_session_contributions + 1,
-  });
+  const state = loadState();
+  state.last_contributed = new Date().toISOString();
+  state.total_session_contributions = (state.total_session_contributions || 0) + 1;
+  saveState(state);
 }