tascan-mcp 3.4.0 → 3.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tascan-mcp",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "mcpName": "io.github.snowbikemike/tascan-mcp",
   "description": "TaScan MCP Server — Closed-loop autonomous operations protocol. 50 tools for projects, tasks, workers, QR codes, NFC tags, geofenced zones, AI condition assessment, worker passports, verification-gated gig payments, cross-entity search, duplicate-worker detection, AI issue analysis, and autonomous remediation dispatch. 14 patents filed (435+ claims). Task. Scan. Done.",
   "type": "module",

package/tools.cjs

@@ -896,31 +896,97 @@ const TOOLS = [
   },
   {
     name: 'tascan_get_scan_history',
-    description: 'Get scan event history for a registered NFC tag — timestamps, GPS coordinates, and accuracy for each scan',
+    description: 'Scan accountability data. Two modes: (1) tag_id — scans of a registered NFC tag; (2) task_list_id or project_id — every QR/link page-open stamp: when the code was scanned, GPS + IP + channel (qr/nfc/sms/email/link), who the scanner turned out to be, and the scan→start delta (how long between scanning and actually identifying + starting work — the sign-in-and-vanish metric).',
     inputSchema: {
       type: 'object',
       properties: {
-        tag_id: { type: 'string', description: 'Tag registry ID (from tascan_list_tags)' },
-        limit: { type: 'number', description: 'Max results (default 50)' }
+        tag_id: { type: 'string', description: 'NFC tag registry ID (from tascan_list_tags) — tag mode' },
+        task_list_id: { type: 'string', description: 'Task list ID — page-scan mode' },
+        project_id: { type: 'string', description: 'Project ID — page-scan mode, all lists in the project' },
+        source: { type: 'string', description: 'Filter page scans by channel: qr | nfc | sms | email | link | unknown' },
+        since: { type: 'string', description: 'ISO timestamp — only scans after this' },
+        limit: { type: 'number', description: 'Max results (default 50, max 200)' }
       },
-      required: ['tag_id']
+      required: []
     },
     annotations: { title: 'Get Scan History', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args, api) => {
-      const path = `/tags/${args.tag_id}/scans` + (args.limit ? `?limit=${args.limit}` : '');
-      const result = await api('GET', path);
-      const scans = result.data;
-      if (!scans.length) return 'No scans recorded for this tag.';
-      let text = `${scans.length} scan(s):\n\n`;
+      if (args.tag_id) {
+        const path = `/tags/${args.tag_id}/scans` + (args.limit ? `?limit=${args.limit}` : '');
+        const result = await api('GET', path);
+        const scans = result.data;
+        if (!scans.length) return 'No scans recorded for this tag.';
+        let text = `${scans.length} tag scan(s):\n\n`;
+        scans.forEach((s, i) => {
+          text += `${i + 1}. ${s.scanned_at}`;
+          if (s.gps_lat && s.gps_lng) text += ` — GPS: ${s.gps_lat.toFixed(6)}, ${s.gps_lng.toFixed(6)} (±${Math.round(s.gps_accuracy || 0)}m)`;
+          text += '\n';
+        });
+        return text;
+      }
+      if (!args.task_list_id && !args.project_id) {
+        return 'Provide tag_id (NFC tag mode) or task_list_id / project_id (page-scan mode).';
+      }
+      const qs = new URLSearchParams();
+      if (args.task_list_id) qs.set('task_list_id', args.task_list_id);
+      else qs.set('project_id', args.project_id);
+      if (args.source) qs.set('source', args.source);
+      if (args.since) qs.set('since', args.since);
+      if (args.limit) qs.set('limit', String(args.limit));
+      const result = await api('GET', '/scans?' + qs.toString());
+      const scans = result.data || [];
+      if (!scans.length) return 'No page scans recorded yet for this scope.';
+      const converted = scans.filter(s => s.converted);
+      const deltas = converted.map(s => s.scan_to_start_secs).filter(n => n != null);
+      const median = deltas.length ? deltas.sort((a, b) => a - b)[Math.floor(deltas.length / 2)] : null;
+      let text = `${scans.length} scan(s) — ${converted.length} converted to a working session (${Math.round(converted.length / scans.length * 100)}%)`;
+      if (median != null) text += ` · median scan→start ${median}s`;
+      text += '\n\n';
       scans.forEach((s, i) => {
-        text += `${i + 1}. ${s.scanned_at}`;
-        if (s.gps_lat && s.gps_lng) text += ` — GPS: ${s.gps_lat.toFixed(6)}, ${s.gps_lng.toFixed(6)} (±${Math.round(s.gps_accuracy || 0)}m)`;
+        text += `${i + 1}. ${s.scanned_at} · ${s.scan_source || 'unknown'}`;
+        if (s.worker_name) text += ` · ${s.worker_name}`;
+        text += s.converted ? ` · started +${s.scan_to_start_secs}s` : ' · NEVER STARTED';
+        if (s.ip) text += ` · ip ${s.ip}`;
+        if (s.gps_lat && s.gps_lng) text += ` · GPS ${s.gps_lat.toFixed(5)}, ${s.gps_lng.toFixed(5)}`;
         text += '\n';
       });
       return text;
     }
   },
 
+  // ─── Worker Marketplace (Patent 4: portable reputation) ──────────
+  {
+    name: 'tascan_search_marketplace',
+    description: 'Search the cross-org Worker Marketplace: workers who opted in (discoverable=true on their passport), ranked by passkey trust tier + verified completion volume.  Skills are AI-inferred from REAL completed work, not resumes — each carries a verified_task_count and a civilian_equivalent job title.  Returns sanitized public cards only (first name + last initial, skills, stats, passport URL) — never phone, email, or org membership.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        q: { type: 'string', description: 'Skill, category, name, or civilian job title — e.g. "forklift", "LED wall", "AV technician"' },
+        min_completions: { type: 'number', description: 'Only workers with at least this many verified completions' },
+        limit: { type: 'number', description: 'Max cards (default 25, max 50)' }
+      },
+      required: []
+    },
+    annotations: { title: 'Search Worker Marketplace', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    handler: async (args, api) => {
+      const qs = new URLSearchParams();
+      if (args.q) qs.set('q', args.q);
+      if (args.min_completions) qs.set('min_completions', String(args.min_completions));
+      if (args.limit) qs.set('limit', String(args.limit));
+      const result = await api('GET', '/marketplace' + (qs.toString() ? '?' + qs.toString() : ''));
+      const cards = result.data || [];
+      if (!cards.length) return 'No discoverable workers match.  Workers appear after opting in on their own passport (profile page → "List me").';
+      return cards.map(w => {
+        let t = `${w.name}${w.passkey_verified ? ' ✓ID-VERIFIED' : ''} — ${w.completions} verified completions · ${w.points} pts · since ${w.member_since}`;
+        if (w.skills.length) t += '\n  Skills: ' + w.skills.map(s => `${s.skill} (${s.verified_task_count}×)`).join(', ');
+        const civ = [...new Set(w.skills.map(s => s.civilian_equivalent).filter(Boolean))];
+        if (civ.length) t += '\n  Civilian equivalent: ' + civ.join(' · ');
+        t += '\n  Passport: ' + w.passport_url;
+        return t;
+      }).join('\n\n');
+    }
+  },
+
   // ─── Geofenced Zones (Patent 7: location-triggered delivery) ─────
   {
     name: 'tascan_create_zone',
@@ -935,6 +1001,12 @@ const TOOLS = [
         project_id: { type: 'string', description: 'Project this zone belongs to' },
         task_list_id: { type: 'string', description: 'Task list the Site Gate routes workers to when they are inside this zone' },
         enforce_on_list: { type: 'boolean', description: 'Zone-lock the task list — it cannot be started from outside the radius' },
+        notify_on_enter: { type: 'boolean', description: 'Email the manager when a worker enters this zone (danger areas)' },
+        notify_on_exit: { type: 'boolean', description: 'Email the manager when a worker leaves this zone (accountability — sign in then disappear)' },
+        auto_clock_in: { type: 'boolean', description: 'Entering the zone writes a shift_start clock-in event' },
+        auto_clock_out: { type: 'boolean', description: 'Leaving the zone writes a shift_end clock-out event' },
+        notify_email: { type: 'string', description: 'Alert recipient override — defaults to all org admins' },
+        polygon: { type: 'array', items: { type: 'array', items: { type: 'number' } }, description: 'Polygon/rectangle zone instead of a circle: vertices as [[lat,lng], ...], at least 3.  lat/lng/radius_m are then computed (centroid + bounding radius) — still pass lat/lng but they are overridden.' },
         description: { type: 'string', description: 'Shown to workers on the Site Gate page' }
       },
       required: ['name', 'lat', 'lng']
@@ -943,7 +1015,7 @@ const TOOLS = [
     handler: async (args, api) => {
       const result = await api('POST', '/zones', args);
       const z = result.data;
-      let text = `Zone created: ${z.name}\n\nID: ${z.id}\nCenter: ${z.lat}, ${z.lng}\nRadius: ${z.radius_m}m\nRoutes to list: ${z.task_list_id || '(none — set task_list_id to enable Site Gate routing)'}\nZone-locked: ${z.enforce_on_list ? 'YES — list cannot start outside the zone' : 'no'}`;
+      let text = `Zone created: ${z.name}\n\nID: ${z.id}\nCenter: ${z.lat}, ${z.lng}\nRadius: ${z.radius_m}m\nRoutes to list: ${z.task_list_id || '(none — set task_list_id to enable Site Gate routing)'}\nZone-locked: ${z.enforce_on_list ? 'YES — list cannot start outside the zone' : 'no'}\nAlerts: enter=${z.notify_on_enter ? 'ON' : 'off'} exit=${z.notify_on_exit ? 'ON' : 'off'} · Auto-clock: in=${z.auto_clock_in ? 'ON' : 'off'} out=${z.auto_clock_out ? 'ON' : 'off'}`;
       if (z.project_id) text += `\n\nSite Gate URL (print this QR at the site entrance):\nhttps://app.tascan.io/geo.html?project=${z.project_id}`;
       return text;
     }
@@ -963,7 +1035,7 @@ const TOOLS = [
       const zones = result.data || [];
       if (!zones.length) return 'No zones configured. Use tascan_create_zone to add one.';
       return zones.map(z =>
-        `${z.name} (${z.id})\n  Center: ${z.lat}, ${z.lng} · Radius: ${z.radius_m}m · ${z.is_active ? 'active' : 'INACTIVE'}\n  Routes to: ${z.task_list_id || '—'} · Zone-locked: ${z.enforce_on_list ? 'yes' : 'no'}`
+        `${z.name} (${z.id})\n  Center: ${z.lat}, ${z.lng} · Radius: ${z.radius_m}m · ${z.is_active ? 'active' : 'INACTIVE'}\n  Routes to: ${z.task_list_id || '—'} · Zone-locked: ${z.enforce_on_list ? 'yes' : 'no'}\n  Alerts: enter=${z.notify_on_enter ? 'ON' : 'off'} exit=${z.notify_on_exit ? 'ON' : 'off'} · Auto-clock: in=${z.auto_clock_in ? 'ON' : 'off'} out=${z.auto_clock_out ? 'ON' : 'off'}`
       ).join('\n\n');
     }
   },
@@ -976,7 +1048,11 @@ const TOOLS = [
         zone_id: { type: 'string', description: 'Zone ID' },
         name: { type: 'string' }, lat: { type: 'number' }, lng: { type: 'number' },
         radius_m: { type: 'number' }, task_list_id: { type: 'string' },
-        enforce_on_list: { type: 'boolean' }, is_active: { type: 'boolean' }
+        enforce_on_list: { type: 'boolean' }, is_active: { type: 'boolean' },
+        notify_on_enter: { type: 'boolean' }, notify_on_exit: { type: 'boolean' },
+        auto_clock_in: { type: 'boolean' }, auto_clock_out: { type: 'boolean' },
+        notify_email: { type: 'string' },
+        polygon: { type: 'array', items: { type: 'array', items: { type: 'number' } }, description: 'Replace geometry with a polygon ([[lat,lng],...], ≥3 vertices); pass null to revert to a circle' }
       },
       required: ['zone_id']
     },