kushi-agents 6.1.2 → 6.2.0

package/plugin/runners/pull-state.mjs

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+// plugin/runners/pull-state.mjs
+// Deterministic State/ generator. Inventories Evidence/ and produces:
+//   State/index.md     — TOC pointing at every evidence file by source/week
+//   State/log.md       — chronological run + evidence ledger
+//   State/CLAUDE.md    — host-agnostic project context (project name, sources, alias inventory)
+//   State/AGENTS.md    — alias of CLAUDE.md for OpenAI-flavored hosts
+//
+// This runner does NOT do narrative synthesis — that is the build-state LLM
+// skill's job. This produces the structural skeleton that makes the LLM
+// skill's work cheaper and reproducible. v5.9.0.
+//
+// Usage:
+//   node plugin/runners/pull-state.mjs --project <P> [--dry-run] [--include-legacy]
+
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import YAML from 'yaml';
+import { evidenceRoot, projectRoot, sharedRoot } from './lib/layout.mjs';
+import { writeAtomic, pathExists } from './lib/evidence.mjs';
+
+function parseArgs(argv) {
+  const args = { dryRun: false, includeLegacy: true };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--project') args.project = argv[++i];
+    else if (a === '--dry-run') args.dryRun = true;
+    else if (a === '--no-legacy') args.includeLegacy = false;
+    else if (a === '--help' || a === '-h') args.help = true;
+  }
+  return args;
+}
+
+function help() {
+  return `Usage: node pull-state.mjs --project <P> [--dry-run] [--no-legacy]`;
+}
+
+function emit(obj) { process.stdout.write(JSON.stringify(obj) + '\n'); }
+function log(msg) { process.stderr.write(`[state] ${msg}\n`); }
+
+const SOURCES = ['email', 'teams', 'meetings', 'onenote', 'sharepoint', 'crm', 'ado'];
+
+async function listDirs(p) {
+  try {
+    return (await fs.readdir(p, { withFileTypes: true })).filter(e => e.isDirectory()).map(e => e.name);
+  } catch { return []; }
+}
+
+async function listFiles(p, exts = ['.md', '.yml']) {
+  try {
+    return (await fs.readdir(p, { withFileTypes: true }))
+      .filter(e => e.isFile() && exts.includes(path.extname(e.name).toLowerCase()))
+      .map(e => e.name);
+  } catch { return []; }
+}
+
+/** Inventory one alias's source folder. Returns { weekly, snapshot, stream, index, total }. */
+async function inventoryAliasSource(aliasSourceDir) {
+  const result = { weekly: [], snapshot: [], stream: [], index: [], total: 0 };
+  for (const layout of ['weekly', 'snapshot', 'stream', '_index']) {
+    const dir = path.join(aliasSourceDir, layout);
+    const files = await listFiles(dir);
+    const key = layout === '_index' ? 'index' : layout;
+    result[key] = files.map(f => path.join(layout, f)).sort();
+    result.total += files.length;
+  }
+  return result;
+}
+
+/** Inventory shared sources (crm, ado, references). */
+async function inventoryShared(project) {
+  const out = {};
+  const shared = sharedRoot(project);
+  for (const sub of ['crm', 'ado', 'references']) {
+    const dir = path.join(shared, sub);
+    if (!await pathExists(dir)) continue;
+    out[sub] = await listFilesRecursive(dir, shared);
+  }
+  return out;
+}
+
+async function listFilesRecursive(dir, base) {
+  const out = [];
+  async function walk(d) {
+    let entries;
+    try { entries = await fs.readdir(d, { withFileTypes: true }); } catch { return; }
+    for (const e of entries) {
+      const full = path.join(d, e.name);
+      if (e.isDirectory()) await walk(full);
+      else if (e.isFile() && ['.md','.yml'].includes(path.extname(e.name).toLowerCase())) {
+        out.push(path.relative(base, full).replaceAll('\\','/'));
+      }
+    }
+  }
+  await walk(dir);
+  return out.sort();
+}
+
+async function readIntegrations(project) {
+  const p = path.join(projectRoot(project), 'integrations.yml');
+  if (!await pathExists(p)) return {};
+  try { return YAML.parse(await fs.readFile(p, 'utf8')) || {}; } catch { return {}; }
+}
+
+async function readBoundaries(project, alias) {
+  const p = path.join(evidenceRoot(project), alias, 'boundaries.yml');
+  if (!await pathExists(p)) return {};
+  try { return YAML.parse(await fs.readFile(p, 'utf8')) || {}; } catch { return {}; }
+}
+
+function fmtSection(title, lines) {
+  return [`## ${title}`, '', ...lines, ''].join('\n');
+}
+
+function buildIndex({ projectName, integrations, aliases, shared, generatedAt }) {
+  const lines = [];
+  lines.push(`# ${projectName} — State Index`);
+  lines.push('');
+  lines.push(`Generated by \`pull-state.mjs\` on ${generatedAt}.`);
+  lines.push('');
+  lines.push('Mechanical inventory only. For narrative synthesis, use the `build-state` skill.');
+  lines.push('');
+
+  const integLines = [];
+  if (integrations.crm?.request_id) integLines.push(`- **CRM**: \`${integrations.crm.request_id}\``);
+  if (integrations.ado?.engagement_id) integLines.push(`- **ADO**: \`${integrations.ado.engagement_id}\``);
+  const spSites = integrations.sharepoint?.sites || [];
+  if (spSites.length) {
+    integLines.push(`- **SharePoint sites** (${spSites.length}):`);
+    for (const s of spSites.slice(0, 10)) integLines.push(`  - ${s}`);
+  }
+  if (integLines.length) lines.push(fmtSection('Integrations (project-shared)', integLines));
+
+  // Shared evidence
+  const sharedLines = [];
+  for (const [src, files] of Object.entries(shared)) {
+    if (!files.length) continue;
+    sharedLines.push(`### ${src} (${files.length} file${files.length === 1 ? '' : 's'})`);
+    sharedLines.push('');
+    for (const f of files.slice(0, 30)) sharedLines.push(`- \`Evidence/_shared/${f}\``);
+    if (files.length > 30) sharedLines.push(`- _… and ${files.length - 30} more_`);
+    sharedLines.push('');
+  }
+  if (sharedLines.length) lines.push(fmtSection('Shared Evidence', sharedLines));
+
+  // Per-alias
+  for (const a of aliases) {
+    const aliasLines = [];
+    aliasLines.push(`Boundaries:`);
+    for (const [k, v] of Object.entries(a.boundaries || {})) {
+      const arr = Array.isArray(v) ? v : (v?.folders || v?.chats || v?.joinUrls || v?.section_file_ids || v?.sites || []);
+      if (Array.isArray(arr) && arr.length) aliasLines.push(`  - ${k}: ${arr.length} item(s)`);
+    }
+    aliasLines.push('');
+    for (const [src, inv] of Object.entries(a.sources || {})) {
+      if (inv.total === 0) continue;
+      aliasLines.push(`**${src}** — ${inv.total} file(s) (weekly: ${inv.weekly.length}, snapshot: ${inv.snapshot.length}, stream: ${inv.stream.length}, index: ${inv.index.length})`);
+      const all = [...inv.weekly, ...inv.snapshot, ...inv.stream, ...inv.index];
+      for (const f of all.slice(0, 12)) aliasLines.push(`- \`Evidence/${a.alias}/${src}/${f}\``);
+      if (all.length > 12) aliasLines.push(`- _… and ${all.length - 12} more_`);
+      aliasLines.push('');
+    }
+    lines.push(fmtSection(`Contributor: ${a.alias}`, aliasLines));
+  }
+
+  return lines.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+
+function buildLog({ projectName, runLog, generatedAt }) {
+  const lines = [];
+  lines.push(`# ${projectName} — Run Log`);
+  lines.push('');
+  lines.push(`Generated by \`pull-state.mjs\` on ${generatedAt}. Reflects \`Evidence/run-log.yml\`.`);
+  lines.push('');
+  if (!runLog || !Array.isArray(runLog.entries) || runLog.entries.length === 0) {
+    lines.push('_No run-log entries yet._');
+    return lines.join('\n');
+  }
+  const entries = [...runLog.entries].sort((a, b) => String(b.timestamp || '').localeCompare(String(a.timestamp || '')));
+  for (const e of entries.slice(0, 100)) {
+    const ts = e.timestamp || '?';
+    const status = e.status || '?';
+    const src = e.source || '?';
+    const ent = e.entity ? ` \`${e.entity}\`` : '';
+    const wk = e.week ? ` (week ${e.week})` : '';
+    lines.push(`- **${ts}** — ${src}${ent}${wk} → \`${status}\``);
+  }
+  if (entries.length > 100) lines.push(`\n_Showing 100 of ${entries.length} entries._`);
+  return lines.join('\n');
+}
+
+function buildClaude({ projectName, integrations, aliases, shared }) {
+  const lines = [];
+  lines.push(`# ${projectName} — Project Context`);
+  lines.push('');
+  lines.push('Auto-generated by `pull-state.mjs`. This file gives any AI agent (Claude, Copilot, etc.) the minimal facts to be useful in this engagement.');
+  lines.push('');
+  lines.push('## Project');
+  lines.push(`- Name: \`${projectName}\``);
+  if (integrations.crm?.request_id) lines.push(`- CRM request: \`${integrations.crm.request_id}\``);
+  if (integrations.ado?.engagement_id) lines.push(`- ADO engagement: \`${integrations.ado.engagement_id}\``);
+  if (integrations.sharepoint?.sites?.length) {
+    lines.push(`- SharePoint sites: ${integrations.sharepoint.sites.length}`);
+  }
+  lines.push('');
+  lines.push('## Contributors');
+  for (const a of aliases) {
+    const totalFiles = Object.values(a.sources || {}).reduce((s, inv) => s + (inv.total || 0), 0);
+    lines.push(`- \`${a.alias}\`: ${totalFiles} evidence file(s)`);
+  }
+  lines.push('');
+  lines.push('## Where things live');
+  lines.push('- Per-contributor evidence: `Evidence/<alias>/<source>/...`');
+  lines.push('- Shared evidence: `Evidence/_shared/{crm,ado,references}/`');
+  lines.push('- Project-wide config: `integrations.yml`');
+  lines.push('- This index: `State/index.md`, `State/log.md`');
+  lines.push('');
+  lines.push('## Doctrine');
+  lines.push('- Cite every claim. Use the form `[source: <relative-path> · <iso-ts>]`.');
+  lines.push('- Read-only Q&A: see the `ask-project` skill.');
+  lines.push('- Refresh + state regen: `kushi refresh <project>` then `kushi state <project>`.');
+  return lines.join('\n');
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) { console.log(help()); return 0; }
+  if (!args.project) { console.error(help()); emit({ status: 'failed', error: 'required: --project' }); return 2; }
+
+  const root = projectRoot(args.project);
+  if (!await pathExists(root)) { emit({ status: 'failed', error: `project-not-bootstrapped: ${root}` }); return 2; }
+  const evRoot = evidenceRoot(root);
+  if (!await pathExists(evRoot)) { emit({ status: 'failed', error: `evidence-missing: ${evRoot}` }); return 2; }
+
+  const projectName = path.basename(root);
+  const generatedAt = new Date().toISOString();
+
+  log(`scanning ${evRoot}...`);
+  const integrations = await readIntegrations(root);
+  const shared = await inventoryShared(root);
+
+  // Per-alias inventory
+  const dirs = await listDirs(evRoot);
+  const aliasNames = dirs.filter(d => !d.startsWith('_'));
+  const aliases = [];
+  for (const alias of aliasNames) {
+    const aliasDir = path.join(evRoot, alias);
+    const sources = {};
+    for (const src of SOURCES) {
+      const srcDir = path.join(aliasDir, src);
+      if (!await pathExists(srcDir)) { sources[src] = { weekly:[], snapshot:[], stream:[], index:[], total:0 }; continue; }
+      sources[src] = await inventoryAliasSource(srcDir);
+    }
+    aliases.push({ alias, boundaries: await readBoundaries(root, alias), sources });
+  }
+
+  // run-log.yml
+  let runLog = {};
+  const runLogPath = path.join(evRoot, 'run-log.yml');
+  if (await pathExists(runLogPath)) {
+    try { runLog = YAML.parse(await fs.readFile(runLogPath, 'utf8')) || {}; } catch { runLog = {}; }
+  }
+
+  const stateDir = path.join(root, 'State');
+  const indexMd = buildIndex({ projectName, integrations, aliases, shared, generatedAt });
+  const logMd = buildLog({ projectName, runLog, generatedAt });
+  const claudeMd = buildClaude({ projectName, integrations, aliases, shared });
+
+  const writes = [];
+  if (!args.dryRun) {
+    await fs.mkdir(stateDir, { recursive: true });
+    const r1 = await writeAtomic(path.join(stateDir, 'index.md'), indexMd);
+    const r2 = await writeAtomic(path.join(stateDir, 'log.md'), logMd);
+    const r3 = await writeAtomic(path.join(stateDir, 'CLAUDE.md'), claudeMd);
+    const r4 = await writeAtomic(path.join(stateDir, 'AGENTS.md'), claudeMd);
+    writes.push(r1, r2, r3, r4);
+  }
+
+  log(`done: ${aliases.length} contributor(s), ${SOURCES.length} sources scanned`);
+  emit({
+    status: 'ok',
+    project: root,
+    project_name: projectName,
+    dry_run: args.dryRun,
+    contributors: aliases.length,
+    contributors_list: aliases.map(a => a.alias),
+    state_dir: path.relative(root, stateDir).replaceAll('\\', '/'),
+    files_written: writes.filter(w => w?.written).map(w => path.relative(root, w.path).replaceAll('\\','/')),
+    note: 'Mechanical inventory only. Run the build-state LLM skill for narrative synthesis.',
+  });
+  return 0;
+}
+
+main().then(c => process.exit(c || 0)).catch(e => {
+  emit({ status: 'failed', error: e.message || String(e) });
+  process.exit(1);
+});

package/plugin/runners/pull-teams.mjs

@@ -1,7 +1,174 @@
 #!/usr/bin/env node
 // plugin/runners/pull-teams.mjs
-// Deterministic teams pull via WorkIQ (HARD RULE per workiq-only.instructions.md).
+// Deterministic Teams chat pull: one chat × one ISO week per call.
+// Writes to Evidence/<alias>/teams/<chat-hash>/<week>/.
+//
+// Usage:
+//   node plugin/runners/pull-teams.mjs --project <P> --alias <A> --entity <chat-id>
+//     [--week YYYY-MM-DD] [--dry-run] [--force] [--fixture <path>]
 
-import { runCli } from './lib/csc-pull.mjs';
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import YAML from 'yaml';
+import { assertProject, loadConfig } from './lib/config.mjs';
+import { sourceDir } from './lib/layout.mjs';
+import { writeAtomic } from './lib/evidence.mjs';
+import { fetchAllPages, encodeODataOp } from './lib/http.mjs';
+import { getToken, SCOPES } from './lib/identity.mjs';
+import { updateCell } from './lib/ledger.mjs';
+import { appendRunLog } from './lib/runlog.mjs';
+import { enqueue, clear } from './lib/deferred.mjs';
+import { shortHash } from './lib/dedup.mjs';
+import { currentIsoMonday, ymd, parseYmd } from './lib/weeks.mjs';
+import { emitLearningCandidate } from './lib/learnings.mjs';
 
-runCli('teams').then(code => { process.exitCode = code; });
+const SOURCE = 'teams';
+
+function parseArgs(argv) {
+  const args = { dryRun: false, force: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--project') args.project = argv[++i];
+    else if (a === '--alias') args.alias = argv[++i];
+    else if (a === '--entity') args.entity = argv[++i];
+    else if (a === '--week') args.week = argv[++i];
+    else if (a === '--dry-run') args.dryRun = true;
+    else if (a === '--force') args.force = true;
+    else if (a === '--fixture') args.fixture = argv[++i];
+    else if (a === '--help' || a === '-h') args.help = true;
+  }
+  return args;
+}
+
+function help() {
+  return `Usage: node pull-teams.mjs --project <P> --alias <A> --entity <chat-id>
+  [--week YYYY-MM-DD] [--dry-run] [--force] [--fixture <path>]`;
+}
+
+function emit(obj) { process.stdout.write(JSON.stringify(obj) + '\n'); }
+function configError(msg) { const e = new Error(msg); e.exitCode = 2; return e; }
+function authError(msg)   { const e = new Error(msg); e.exitCode = 3; return e; }
+
+async function buildClient({ fixture }) {
+  if (fixture) {
+    const data = JSON.parse(await fs.readFile(fixture, 'utf8'));
+    return makeFixtureClient(data);
+  }
+  const token = await getToken(SCOPES.graph).catch(e => { throw authError(`token fetch failed: ${e.message}`); });
+  const headers = { Authorization: `Bearer ${token}`, Accept: 'application/json' };
+  return {
+    async listMessages(chatId, fromIso, toIso) {
+      // Graph chats messages: server filters createdDateTime; some tenants ignore. We re-filter locally.
+      const filter = `createdDateTime ge ${fromIso} and createdDateTime lt ${toIso}`;
+      const url = `https://graph.microsoft.com/v1.0/chats/${encodeURIComponent(chatId)}/messages?${encodeODataOp('$filter')}=${encodeURIComponent(filter)}&${encodeODataOp('$orderby')}=createdDateTime asc&${encodeODataOp('$top')}=50`;
+      const { items } = await fetchAllPages(url, { headers });
+      return items.filter(m => m.createdDateTime >= fromIso && m.createdDateTime < toIso);
+    },
+  };
+}
+
+function makeFixtureClient(data) {
+  return {
+    async listMessages(chatId, fromIso, toIso) {
+      const all = (data.messagesByChat && data.messagesByChat[chatId]) || [];
+      return all.filter(m => m.createdDateTime >= fromIso && m.createdDateTime < toIso);
+    },
+  };
+}
+
+function weekBounds(weekStartYmd) {
+  const start = parseYmd(weekStartYmd);
+  const end = new Date(start);
+  end.setDate(end.getDate() + 7);
+  return { fromIso: start.toISOString(), toIso: end.toISOString() };
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) { console.log(help()); return 0; }
+  if (!args.project || !args.alias || !args.entity) {
+    console.error(help());
+    emit({ source: SOURCE, status: 'failed', errors: [{ signature: 'bad-args', message: 'required: --project --alias --entity' }] });
+    return 2;
+  }
+  const projectRoot = await assertProject(args.project).catch(e => { throw configError(e.message); });
+  await loadConfig(projectRoot, args.alias);
+  const weekStart = args.week || ymd(currentIsoMonday());
+  const { fromIso, toIso } = weekBounds(weekStart);
+
+  const client = await buildClient({ fixture: args.fixture });
+  const startedAt = new Date().toISOString();
+
+  let messages;
+  try {
+    messages = await client.listMessages(args.entity, fromIso, toIso);
+  } catch (e) {
+    const retryable = !e.status || [429, 502, 503, 504].includes(e.status);
+    await updateCell(projectRoot, args.alias, SOURCE, args.entity, weekStart, { last_status: retryable ? 'deferred' : 'failed', last_error: e.message });
+    if (retryable && !args.dryRun) await enqueue(projectRoot, args.alias, { source: SOURCE, entity: args.entity, weekStart, signature: 'fetch-failed', reason: e.message });
+    if (!retryable && !args.dryRun) await emitLearningCandidate({ projectRoot, alias: args.alias, source: SOURCE, entity: args.entity, week: weekStart, error: { signature: 'fetch-failed', message: e.message, status: e.status }, context: { runner: 'pull-teams' } });
+    emit({ source: SOURCE, entity: args.entity, week: weekStart, status: retryable ? 'deferred' : 'failed', errors: [{ message: e.message, status: e.status }] });
+    return retryable ? 1 : 0;
+  }
+
+  const chatHash = shortHash(args.entity);
+
+  if (messages.length === 0) {
+    await updateCell(projectRoot, args.alias, SOURCE, args.entity, weekStart, { last_status: 'no-activity', items_pulled: 0, chat_hash: chatHash });
+    emit({ source: SOURCE, entity: args.entity, week: weekStart, status: 'no-activity', items_pulled: 0, files_written: [] });
+    return 0;
+  }
+
+  const outDir = path.join(sourceDir(projectRoot, args.alias, SOURCE), chatHash, weekStart);
+  const filesWritten = [];
+  if (!args.dryRun) {
+    const r1 = await writeAtomic(path.join(outDir, 'messages.yml'), YAML.stringify(messages));
+    const r2 = await writeAtomic(path.join(outDir, 'chat.yml'), YAML.stringify({ chat_id: args.entity, hash: chatHash }));
+    const r3 = await writeAtomic(path.join(outDir, 'index.md'), renderIndexMd({ chatId: args.entity, messages, weekStart, pulledAt: startedAt }), { skipIfUnchanged: false });
+    for (const r of [r1, r2, r3]) if (r.written !== false) filesWritten.push(path.relative(projectRoot, r.path));
+  }
+
+  await clear(projectRoot, args.alias, SOURCE, args.entity).catch(() => {});
+
+  await updateCell(projectRoot, args.alias, SOURCE, args.entity, weekStart, {
+    last_status: 'captured',
+    items_pulled: messages.length,
+    chat_hash: chatHash,
+  });
+
+  if (!args.dryRun) {
+    await appendRunLog(projectRoot, { runner: 'pull-teams', alias: args.alias, entity: args.entity, week: weekStart, status: 'captured', items_pulled: messages.length });
+  }
+
+  emit({
+    source: SOURCE, entity: args.entity, week: weekStart, status: 'captured',
+    items_pulled: messages.length, chat_hash: chatHash,
+    files_written: filesWritten, ledger_key: `teams::${args.entity}::${weekStart}`,
+  });
+  return 0;
+}
+
+function renderIndexMd({ chatId, messages, weekStart, pulledAt }) {
+  const lines = [
+    `# Teams chat — ${chatId} — week ${weekStart}`,
+    '',
+    `- chat_id: ${chatId}`,
+    `- week_start: ${weekStart}`,
+    `- messages: ${messages.length}`,
+    `- pulled_at: ${pulledAt}`,
+    '',
+    '## Messages',
+  ];
+  for (const m of messages) {
+    const from = (m.from && m.from.user && m.from.user.displayName) || (m.from && m.from.application && m.from.application.displayName) || '?';
+    const preview = (m.body && m.body.content || '').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').slice(0, 120);
+    lines.push(`- [${m.createdDateTime}] **${from}**: ${preview}`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+main().then(code => { process.exitCode = code; }).catch(e => {
+  emit({ source: SOURCE, status: 'failed', errors: [{ message: e.message, code: e.exitCode || 'unknown' }] });
+  process.exitCode = e.exitCode || 1;
+});

package/plugin/runners/refresh.mjs

@@ -228,12 +228,19 @@ async function main() {
   // v5.9.0: post-pass — unified references pool. Scans Evidence for URLs and
   // builds a project-shared dedup index with HTTP snapshots for external links.
   let referencesResult = null;
+  let stateResult = null;
   if (!args.dryRun) {
     const refsRunner = path.join(HERE, 'pull-references.mjs');
     const refsArgv = ['--project', args.project];
     if (args.force) refsArgv.push('--refresh');
     const r = await spawnRunner(refsRunner, refsArgv);
-    referencesResult = { source: 'references', exit_code: r.code, stdout: r.stdout?.slice(0, 4000), stderr: r.stderr?.slice(0, 1000) };
+    referencesResult = { source: 'references', exit_code: r.exitCode, stdout: r.stdout?.slice(0, 4000), stderr: r.stderr?.slice(0, 1000) };
+
+    // v5.9.0 / v6.2.0: post-pass — deterministic State/ generator. Inventory
+    // only; build-state LLM skill remains the synthesis layer.
+    const stateRunner = path.join(HERE, 'pull-state.mjs');
+    const s = await spawnRunner(stateRunner, ['--project', args.project]);
+    stateResult = { source: 'state', exit_code: s.exitCode, stdout: s.stdout?.slice(0, 4000), stderr: s.stderr?.slice(0, 1000) };
   }
 
   const learning_candidates_total = args.dryRun ? 0 : await readCandidateCount(args.project);
@@ -298,6 +305,7 @@ async function main() {
     results,
     skipped_targets: skipped,
     references: referencesResult,
+    state: stateResult,
     learning_candidates_total,
   });
   return 0;

package/plugin/runners/test/fixtures/email-abn-amro.json

@@ -0,0 +1,13 @@
+{
+  "folders": [
+    { "id": "AAMkAGI=", "displayName": "23. ABN AMRO" }
+  ],
+  "messagesByFolder": {
+    "AAMkAGI=": [
+      { "id": "m1", "subject": "Kickoff agenda", "receivedDateTime": "2026-05-25T08:00:00Z", "from": { "emailAddress": { "address": "ushak@abnamro.com", "name": "Alice" } } },
+      { "id": "m2", "subject": "Architecture review notes", "receivedDateTime": "2026-05-27T14:30:00Z", "from": { "emailAddress": { "address": "bob@abnamro.com", "name": "Bob" } } },
+      { "id": "m3", "subject": "Out of window — prior week", "receivedDateTime": "2026-05-18T09:00:00Z", "from": { "emailAddress": { "address": "carol@abnamro.com", "name": "Carol" } } },
+      { "id": "m4", "subject": "Out of window — next week", "receivedDateTime": "2026-06-01T09:00:00Z", "from": { "emailAddress": { "address": "dave@abnamro.com", "name": "Dave" } } }
+    ]
+  }
+}

package/plugin/runners/test/fixtures/email-novel-error.json

@@ -0,0 +1,9 @@
+{
+  "folders": [
+    { "id": "AAMkAGI=", "displayName": "23. ABN AMRO" }
+  ],
+  "throwOnListMessages": {
+    "status": 500,
+    "message": "Graph returned unexpected null for $select(receivedDateTime)"
+  }
+}

package/plugin/runners/test/fixtures/meetings-abn-amro.json

@@ -0,0 +1,10 @@
+{
+  "meeting": {
+    "id": "MSoxMjM0NTY3OA==",
+    "subject": "ABN AMRO — Architecture Review",
+    "startDateTime": "2026-05-26T15:00:00Z",
+    "endDateTime": "2026-05-26T16:00:00Z",
+    "joinWebUrl": "https://teams.microsoft.com/meet/31827546911768?p=YOgZHuaffeF0MGBCNt"
+  },
+  "transcript": "WEBVTT\n\n00:00:00.000 --> 00:00:05.000\nAlice: Welcome everyone.\n\n00:00:05.000 --> 00:00:10.000\nBob: Thanks. Let's start with the agenda.\n\n00:00:10.000 --> 00:00:20.000\nCarol: Architecture diagram is ready for review.\n"
+}

package/plugin/runners/test/fixtures/meetings-body-unavailable.json

@@ -0,0 +1,10 @@
+{
+  "meeting": {
+    "id": "MSoxMjM0NTY3OA==",
+    "subject": "ABN AMRO — Discovery (transcript pending)",
+    "startDateTime": "2026-05-28T09:00:00Z",
+    "endDateTime": "2026-05-28T10:00:00Z",
+    "joinWebUrl": "https://teams.microsoft.com/meet/26457824867211?p=zdSjg6cqHoHPA8Hx11"
+  },
+  "transcript": null
+}

package/plugin/runners/test/fixtures/onenote-abn-amro.json

@@ -0,0 +1,30 @@
+{
+  "section": {
+    "id": "015a0ac9-58f4-4f34-98b3-a60075b36627",
+    "displayName": "ABN AMRO"
+  },
+  "resolvedSection": {
+    "id": "015a0ac9-58f4-4f34-98b3-a60075b36627",
+    "displayName": "ABN AMRO"
+  },
+  "pages": [
+    {
+      "id": "p1",
+      "title": "Kickoff Notes",
+      "lastModifiedDateTime": "2026-05-25T10:00:00Z",
+      "content": "<html><body><h1>Kickoff</h1><p>Project goals discussed.</p></body></html>"
+    },
+    {
+      "id": "p2",
+      "title": "Architecture Notes",
+      "lastModifiedDateTime": "2026-05-27T14:00:00Z",
+      "content": "<html><body><h1>Architecture</h1><p>Three-tier proposed.</p></body></html>"
+    },
+    {
+      "id": "p3",
+      "title": "Stale page",
+      "lastModifiedDateTime": "2026-05-18T08:00:00Z",
+      "content": "<html><body>Out of window</body></html>"
+    }
+  ]
+}

package/plugin/runners/test/fixtures/onenote-partial.json

@@ -0,0 +1,21 @@
+{
+  "section": {
+    "id": "015a0ac9-58f4-4f34-98b3-a60075b36627",
+    "displayName": "ABN AMRO"
+  },
+  "resolvedSection": null,
+  "pages": [
+    {
+      "id": "p1",
+      "title": "Page with content",
+      "lastModifiedDateTime": "2026-05-25T10:00:00Z",
+      "content": "<html><body>OK</body></html>"
+    },
+    {
+      "id": "p2",
+      "title": "Page body unavailable",
+      "lastModifiedDateTime": "2026-05-26T11:00:00Z",
+      "content": null
+    }
+  ]
+}

package/plugin/runners/test/fixtures/refresh-dir/email.json

@@ -1,5 +1,8 @@
-{
-  "stdout": "> [block: csc]\n> entity_id: conv-001\n> display_name: Kickoff\n> last_touched: 2026-05-26T10:00:00Z\n> participants: Alice\n> topics: kickoff\n> summary: Kickoff happened.\n",
-  "exitCode": 0,
-  "stderr": ""
+{
+  "folders": [{ "id": "F1", "displayName": "Project Inbox" }],
+  "messagesByFolder": {
+    "F1": [
+      { "id": "m1", "subject": "Kickoff", "receivedDateTime": "2026-05-26T10:00:00Z", "from": { "emailAddress": { "address": "alice@example.com", "name": "Alice" } } }
+    ]
+  }
 }

package/plugin/runners/test/fixtures/refresh-dir/teams.json

@@ -1,5 +1,7 @@
-{
-  "stdout": "> [block: csc]\n> entity_id: conv-001\n> display_name: Kickoff\n> last_touched: 2026-05-26T10:00:00Z\n> participants: Alice\n> topics: kickoff\n> summary: Kickoff happened.\n",
-  "exitCode": 0,
-  "stderr": ""
+{
+  "messagesByChat": {
+    "19:abc@thread.v2": [
+      { "id": "1748260800000", "createdDateTime": "2026-05-26T10:00:00Z", "from": { "user": { "displayName": "Alice" } }, "body": { "content": "kickoff", "contentType": "text" } }
+    ]
+  }
 }

package/plugin/runners/test/fixtures/sharepoint-abn-amro.json

@@ -0,0 +1,12 @@
+{
+  "itemsBySite": {
+    "https://abnamro.sharepoint.com/sites/TeamAlfred": [
+      { "id": "01ABC", "name": "Architecture.pptx", "webUrl": "https://abnamro.sharepoint.com/sites/TeamAlfred/Architecture.pptx", "lastModifiedDateTime": "2026-05-25T11:00:00Z" },
+      { "id": "01DEF", "name": "DiscoveryNotes.docx", "webUrl": "https://abnamro.sharepoint.com/sites/TeamAlfred/DiscoveryNotes.docx", "lastModifiedDateTime": "2026-05-27T16:00:00Z" },
+      { "id": "01GHI", "name": "Stale.xlsx", "webUrl": "https://abnamro.sharepoint.com/sites/TeamAlfred/Stale.xlsx", "lastModifiedDateTime": "2026-05-18T09:00:00Z" }
+    ],
+    "https://contoso-evil.sharepoint.com/sites/X": [
+      { "id": "01ZZZ", "name": "Should never be reached.docx", "webUrl": "https://contoso-evil.sharepoint.com/sites/X/Y.docx", "lastModifiedDateTime": "2026-05-26T10:00:00Z" }
+    ]
+  }
+}

package/plugin/runners/test/fixtures/teams-abn-amro.json

@@ -0,0 +1,11 @@
+{
+  "messagesByChat": {
+    "19:e17bf64ba941442590dae0824cc4784c@thread.v2": [
+      { "id": "1747000000000", "createdDateTime": "2026-05-25T09:15:00Z", "from": { "user": { "displayName": "Alice" } }, "body": { "content": "<p>Status update</p>" } },
+      { "id": "1747100000000", "createdDateTime": "2026-05-26T13:00:00Z", "from": { "user": { "displayName": "Bob" } }, "body": { "content": "<p>Will review the doc</p>" } },
+      { "id": "1747200000000", "createdDateTime": "2026-05-28T08:30:00Z", "from": { "user": { "displayName": "Carol" } }, "body": { "content": "<p>Action items captured</p>" } },
+      { "id": "1746000000000", "createdDateTime": "2026-05-18T10:00:00Z", "from": { "user": { "displayName": "Stale" } }, "body": { "content": "<p>Out of window</p>" } }
+    ],
+    "19:empty@thread.v2": []
+  }
+}