tokens-for-good 0.2.6 → 0.3.0

package/package.json

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

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.6',
+  version: '0.3.0',
 });
 
 // --- No-key onboarding message ---
@@ -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

@@ -22,114 +22,19 @@ export function isSchedulable(platform) {
 }
 
 export function getSchedulePrompt(apiKey) {
-  return `You are a research agent for Fierce Philanthropy's Tokens for Good program. Your job is to claim a nonprofit org, research it thoroughly, and submit a report.
+  const base = 'https://fierce-philanthropy-directory.laravel.cloud/api';
+  return `You are a research agent for Fierce Philanthropy's Tokens for Good program.
 
-## API Access
+## Setup
+API Base: ${base}
+Auth header for all requests: X-TFG-Api-Key: ${apiKey}
 
-Base URL: https://fierce-philanthropy-directory.laravel.cloud/api
-Auth header: X-TFG-Api-Key: ${apiKey}
+## Instructions
+1. Fetch the batch flow: WebFetch GET ${base}/research/schedule-instructions
+2. Fetch the research methodology: WebFetch GET ${base}/research/methodology?step=research
+3. Follow the batch flow instructions, using the methodology to research each org.
 
-## Steps
-
-### 1. Claim an org
-Use WebFetch to POST to /api/research/claim:
-
-WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/claim
-Method: POST
-Headers: X-TFG-Api-Key: ${apiKey}, Content-Type: application/json
-Body: {"platform": "claude-code-scheduled"}
-
-This returns the org name, URL, description, and a claim_id. You have 30 minutes.
-
-### 2. Research the org
-Use WebSearch and WebFetch to thoroughly research the organization:
-- The org's website, impact pages, annual reports
-- Independent evaluations (RCTs, J-PAL, 3ie)
-- Third-party reviews (GiveWell, Charity Navigator)
-- Financial data (ProPublica Nonprofit Explorer)
-
-### 3. Write the report
-Follow the Fierce Philanthropy research methodology:
-
-**PROMPT 1** - Org and Social Problem Summary (problem, population, location)
-**PROMPT 2** - Top 20 Negative Consequences table
-**PROMPT 3** - Classify each as Intermediary or Ultimate Outcome
-**PROMPT 4** - Positive Results shared by the org (with citations)
-**PROMPT 5** - Counterfactual Results (with citations)
-
-**SUMMARY REPORT** with 7 sections:
-1. Our Recommendation (with scored checklist)
-2. The Social Problem
-3. The Solution
-4. Key Outputs
-5. Key Intermediate Outcomes
-6. Key Ultimate Outcomes
-7. Continual Learning & Adaptation
-
-**SOURCES** - All cited sources with full URLs
-
-#### Scoring Checklist (use EXACTLY these criteria):
-
-Base score (out of 100):
-- [x] or [ ] a. Has Ultimate Outcome Goals (50 pts)
-- [x] or [ ] b. Measures Intermediate Outcomes (10 pts)
-- [x] or [ ] c. Measures Ultimate Outcomes (15 pts)
-- [x] or [ ] d. Shows Continual Learning & Adaptation (25 pts)
-
-Extra credit:
-- [x] or [ ] e. Measures Intermediate Counterfactual (10 pts)
-- [x] or [ ] f. Measures Ultimate Counterfactual (10 pts)
-
-**Score: [X]/100** (can exceed 100 with extra credit, max 120)
-
-### 4. Submit the report
-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"}
-
-### 5. Check next-action
-After submitting, check if you need to do a peer review before continuing:
-
-WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/next-action
-Method: GET
-Headers: X-TFG-Api-Key: ${apiKey}, Accept: application/json
-
-If the response says action is "review", do the review:
-
-**5a. Get the review:**
-WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/review/next
-Method: GET
-Headers: X-TFG-Api-Key: ${apiKey}, Accept: application/json
-
-**5b. Review the report** — score it 1-4 (4=great, 3=good with minor fixes, 2=needs redo, 1=bad actor)
-
-**5c. Submit the review:**
-WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/review/submit
-Method: POST
-Headers: X-TFG-Api-Key: ${apiKey}, Content-Type: application/json
-Body: {"claim_id": <claim_id>, "score": <1-4>, "notes": "<review notes>", "updated_report": "<fixed report if score is 3>"}
-
-### 6. Repeat (up to 3 orgs per session)
-After completing each org (and any peer review), loop back to Step 1 and claim the next org.
-Research up to 3 orgs total per session. After 3 orgs (or if no more are available), stop.
-
-## Batch Flow Summary
-\`\`\`
-for i in 1..3:
-  claim org → research → submit report
-  check next-action → if review needed, do review
-  repeat
-\`\`\`
-
-### Rules
-- Every factual claim needs an inline citation [Source Name](URL)
-- Only use direct results from the org, not from similar orgs
-- No anecdotes, only measured results
-- Paragraphs under 4 sentences
-- No em dashes, no filler adjectives, no AI tells`;
+All endpoints, scoring criteria, and submission format are in the fetched instructions.`;
 }
 
 export function getAutomationInstructions(platform, frequency = 'daily', apiKey = null) {

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);
 }