phaedo-mcp 0.3.3 → 0.3.4

package/capture-local.js

@@ -53,6 +53,23 @@ async function localSnapshots(now) {
   return out;
 }
 
+// How many captured sessions the local state holds, across every surface: the live ones plus
+// those evicted into the baseline (their counts are still in it). For the starter-profile
+// readout only; 0 on any failure — it describes, it never gates.
+export async function localCaptureSessionCount() {
+  try {
+    const stateMod = await loadCaptureModule('capture/state.js');
+    const state = stateMod.loadState(stateMod.defaultStatePath());
+    let n = 0;
+    for (const s of Object.values(state.surfaces || {})) {
+      n += Object.keys((s && s.sessions) || {}).length + (Array.isArray(s && s.evicted) ? s.evicted.length : 0);
+    }
+    return n;
+  } catch {
+    return 0;
+  }
+}
+
 // Fold the local capture state into a vault payload's fingerprint and return the
 // folded payload (or the input unchanged when there is nothing to fold / the
 // modules are unavailable). Pure with respect to the input object.

package/fingerprint-source.js

@@ -15,7 +15,7 @@ import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { hasPairingRecord, loadPairingRecord, loadFingerprintFromPhone, PhoneError } from './phone-source.js';
 import { defaultStateDir, writeCache, readCache, clearCache } from './cache.js';
-import { foldLocalCapture, isLocalCaptureOwner } from './capture-local.js';
+import { foldLocalCapture, isLocalCaptureOwner, localCaptureSessionCount } from './capture-local.js';
 import { Capabilities, AuthoredSource } from './lib/phaedo-crypto.js';
 import { PhaedoError } from './errors.js';
 
@@ -137,6 +137,33 @@ async function loadStarterProfile(now = new Date().toISOString()) {
   return markStarter(foldConfigHome(normalizeIdentity(vd)));
 }
 
+// HOW FAR ALONG a starter profile is, in words a person can act on. "Learned" counts distinct
+// traits (layer + field), not observations: ten corrections about length are one thing learned.
+// The stages are about what to do next, which is the point of saying it at all: early on, keep
+// working; once it is a solid start, the phone app is what adds the rest (its interview and the
+// decisions the subject approves, which sessions cannot show). Cut-offs are deliberately coarse
+// and are not a confidence measure — the projection's own confidence section is that.
+export const STARTER_STAGES = [
+  { min: 8, text: 'a solid start. The Phaedo phone app adds what sessions can\'t show (https://phaedo.so).' },
+  { min: 3, text: 'taking shape; it keeps learning as you work.' },
+  { min: 0, text: 'just getting started; it fills in as you work.' },
+];
+
+export async function summarizeStarter(vd) {
+  const layers = (vd && vd.phaedo_fingerprint && vd.phaedo_fingerprint.layers) || {};
+  const traits = new Set();
+  let areas = 0;
+  for (const [id, layer] of Object.entries(layers)) {
+    const sigs = (layer && Array.isArray(layer.signals)) ? layer.signals : [];
+    if (sigs.length) areas++;
+    for (const sg of sigs) if (sg && sg.field) traits.add(`${id}.${sg.field}`);
+  }
+  const learned = traits.size;
+  const sessions = await localCaptureSessionCount();
+  const stage = STARTER_STAGES.find((st) => learned >= st.min).text;
+  return { learned, areas, sessions, stage };
+}
+
 /** One line for the server log describing where the profile will come from, or null when there
  *  is nothing a person needs told. Never touches the phone: a pull at startup would put an
  *  "authorize" card on it with nobody asking. */
@@ -146,7 +173,13 @@ export async function profileStatusLine(baseDir) {
   if (env) return null;
   if (hasPairingRecord(baseDir)) return null;
   if (existsSync(resolve(baseDir, 'fingerprint.json'))) return null;
-  if (await loadStarterProfile()) return 'no phone paired; using a starter profile built from your own sessions on this computer.';
+  const starter = await loadStarterProfile();
+  if (starter) {
+    const { learned, areas, sessions, stage } = await summarizeStarter(starter);
+    return `no phone paired; using a starter profile from your own sessions on this computer: ` +
+      `${learned} thing${learned === 1 ? '' : 's'} learned across ${areas} area${areas === 1 ? '' : 's'}` +
+      `${sessions ? ` from ${sessions} session${sessions === 1 ? '' : 's'}` : ''} — ${stage}`;
+  }
   return NO_PROFILE_LOG;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phaedo-mcp",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",

package/pull.js

@@ -7,12 +7,12 @@
 
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
-import { loadFingerprint, sourceOf } from './fingerprint-source.js';
+import { loadFingerprint, sourceOf, summarizeStarter } from './fingerprint-source.js';
 
 const BASE_DIR = dirname(fileURLToPath(import.meta.url));
 
 loadFingerprint(BASE_DIR)
-  .then((vd) => {
+  .then(async (vd) => {
     const fp = (vd && vd.phaedo_fingerprint) || {};
     const layers = fp.layers ? Object.keys(fp.layers).length : 0;
     const src = sourceOf(vd);
@@ -22,8 +22,10 @@ loadFingerprint(BASE_DIR)
     // whole point of this command is to verify the pairing works, so it has to distinguish
     // "your phone answered" from "your phone didn't, here's an old copy".
     if (src.starter) {
+      const { learned, areas, sessions, stage } = await summarizeStarter(vd);
       process.stdout.write(
-        `✓ No phone paired — serving a starter profile built from your own sessions on this computer, ${layers} layer(s).\n` +
+        `✓ No phone paired — serving a starter profile from your own sessions on this computer:\n` +
+        `  ${learned} thing(s) learned across ${areas} area(s)${sessions ? ` from ${sessions} session(s)` : ''} — ${stage}\n` +
         `  Pair the Phaedo phone app (npm run pair) to replace it with your full profile.\n`
       );
       process.exit(0);

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.phaedo-labs/phaedo-mcp",
   "description": "Make AI apps answer your way, check with you before acting, and get approvals on your phone.",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "repository": {
     "url": "https://github.com/phaedo-labs/phaedo-mcp",
     "source": "github",
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "phaedo-mcp",
-      "version": "0.3.3",
+      "version": "0.3.4",
       "transport": {
         "type": "stdio"
       }