fdeops 3.15.0 → 3.15.2

package/bin/check.js

@@ -43,7 +43,7 @@ for (const f of requiredTemplates) {
 
 const deadMedia = ['demo.gif', 'demo.sh', 'demo.tape', 'terminal-demo.svg', 'fieldbook-dashboard.png', 'fieldbook-detail.png', 'fieldbook-walkthrough.gif']
 for (const name of deadMedia) {
-  if (fs.existsSync(path.join(root, 'media', name))) fail(`dead media/${name} must not ship — the recorded session is session.gif`)
+  if (fs.existsSync(path.join(root, 'media', name))) fail(`dead media/${name} must not ship - the recorded session is session.gif`)
 }
 ok('no staged mock media')
 
@@ -57,7 +57,7 @@ for (const dir of fs.readdirSync(path.join(root, 'skills'))) {
 ok('skills structure')
 
 if (fs.existsSync(path.join(root, 'skills', 'fde', 'archive'))) {
-  fail('skills/fde/archive must not exist — unrouted methods are dead code')
+  fail('skills/fde/archive must not exist - unrouted methods are dead code')
 } else ok('no archived skill dump')
 
 // v3: one skill + phase references (progressive disclosure)
@@ -182,28 +182,26 @@ ok(`router dispatch (${mentioned.length} reference targets verified) + memory co
   // the agent can never reach, advertised anyway.
   const unrouted = [...documented].filter(name => !routed.has(name))
   if (unrouted.length) {
-    fail(`docs/skills-reference.md documents method(s) SKILL.md never routes to: ${unrouted.join(', ')}`)
+    fail(`docs/skills-reference.md documents skill(s) SKILL.md never routes to: ${unrouted.join(', ')}`)
   }
   for (const rel of ['docs/skills.md', 'docs/skills-reference.md']) {
     const body = read(rel)
     // `-` is a word boundary, so \bingest\b matches inside `ingest-connect`:
     // a method could disappear from the docs behind a hyphenated sibling.
     const absent = [...documented].filter(name => !new RegExp(`(?<![\\w-])${name}(?![\\w-])`).test(body))
-    if (absent.length) fail(`${rel} does not list method(s): ${absent.join(', ')}`)
-    // every count claim, not just the first: an earlier sentence must not shadow
-    // a stale headline (or the reverse).
-    const claims = [...body.matchAll(/(\d+)\s+methods/g)].map(m => Number(m[1]))
-    if (!claims.length) fail(`${rel} must state how many methods it documents`)
+    if (absent.length) fail(`${rel} does not list skill(s): ${absent.join(', ')}`)
+    const claims = [...body.matchAll(/(\d+)\s+skills/g)].map(m => Number(m[1]))
+    if (!claims.length) fail(`${rel} must state how many skills it documents`)
     const wrong = [...new Set(claims.filter(n => n !== documented.size))]
     if (wrong.length) {
-      fail(`${rel} claims ${wrong.join('/')} methods; ${documented.size} are documented`)
+      fail(`${rel} claims ${wrong.join('/')} skills; ${documented.size} are documented`)
     }
   }
-  ok(`public method count is verifiable (${documented.size} documented, ${routed.size} routed)`)
+  ok(`public skill count is verifiable (${documented.size} documented, ${routed.size} routed)`)
 
   const refDir = path.join(root, 'skills', 'fde', 'references')
   const extra = fs.readdirSync(refDir).filter(f => f.endsWith('.md') && !mentioned.includes(f))
-  if (extra.length) fail(`unrouted reference file(s) — dead method: ${extra.join(', ')}`)
+  if (extra.length) fail(`unrouted reference file(s) - dead method: ${extra.join(', ')}`)
   else ok('no unrouted reference files')
 }
 
@@ -224,7 +222,7 @@ if (read('package.json').includes('postinstall')) {
 
 const readme = read('README.md')
 if (/session\.gif|demo\.gif|<img /i.test(readme)) {
-  fail('README must not embed images — front door is text; the recording lives in docs/USAGE.md')
+  fail('README must not embed images - front door is text; the recording lives in docs/USAGE.md')
 } else ok('README is text (no gif)')
 
 const usage = read('docs/USAGE.md')
@@ -250,7 +248,7 @@ if (brokenLinks.length) fail(`README links to missing paths: ${brokenLinks.join(
 else ok('README links all resolve')
 
 for (const section of [
-  'How it works',
+  'How Skills Work',
   'Quick Start',
   'Engagement memory',
   'Who this is for',
@@ -264,9 +262,10 @@ if (!readme.includes('AI coding agent')) {
 }
 ok('README clarity sections')
 
-for (const cmd of ['/brief', '/discover', '/plan', '/ship', '/got', '/close', '/debrief', '/prep', '/quiet', '/agreed', '/status']) {
+for (const cmd of ['/brief', '/discover', '/plan', '/ship', '/outcome', '/close', '/debrief', '/prep', '/quiet', '/agreed', '/status']) {
   if (!readme.includes(cmd)) fail(`README must document slash command ${cmd}`)
 }
+if (/(^|[^\w/])\/got\b/.test(readme)) fail('README must use /outcome, not /got')
 ok('README slash commands documented')
 
 // Front-door map is the embed left-to-right (LAND → CLOSE), not a pile of situations.
@@ -282,9 +281,8 @@ if (!readme.includes('fde-engagements') || !/fdeops.*init.*engagement/i.test(rea
   fail('README must document fde-engagements + init flow')
 } else ok('README engagement path')
 
-// The contributor-only testing skill lives in .agents/skills/, so a bare
-// `skills add` installs it too. The advertised command must name the one skill
-// a field user wants.
+// The advertised command must name the one skill a field user wants.
+// Contributor CLI attack notes live in evals/testing-fieldbook.md, not as a skill.
 for (const m of readme.match(/^.*npx skills add .*$/gm) || []) {
   if (!m.includes('--skill fde')) {
     fail(`README skills-add command must pin --skill fde: ${m.trim()}`)
@@ -310,19 +308,7 @@ if (!read('skills/fde/SKILL.md').includes('npx --yes fdeops')) {
     fail(`SKILL.md description needs several "Use when …" triggers so it fires on intent (found ${triggers.length})`)
   } else if (/Use when the human says @fde or/.test(desc)) {
     fail('SKILL.md description must not gate on @fde - name the client-work intents first')
-  } else ok('SKILL.md description triggers on intent')
-}
-
-// Six invented words (fieldbook, terrain, reality, trust signal, receipts,
-// vault) carry the method. They were never defined in one place, so a stranger
-// met them scattered through the docs and guessed.
-{
-  const gloss = /Words used here[\s\S]{0,1200}/.exec(readme)
-  const missing = ['fieldbook', 'reality', 'terrain', 'trust signal', 'receipts', 'vault']
-    .filter(w => !gloss || !new RegExp(w, 'i').test(gloss[0]))
-  if (!gloss) fail('README must define its invented words once (a "Words used here" line)')
-  else if (missing.length) fail(`README glossary is missing: ${missing.join(', ')}`)
-  else ok('README defines its own vocabulary')
+  }   else ok('SKILL.md description triggers on intent')
 }
 
 if (!fs.existsSync(path.join(root, 'docs', 'USAGE.md'))) {
@@ -550,7 +536,7 @@ if (pkg.version !== plugin.version) {
 if (plugin.commands !== './.claude/commands' || plugin.skills !== './skills') {
   fail('.claude-plugin/plugin.json must declare skills and commands')
 } else {
-  for (const cmd of ['brief', 'discover', 'plan', 'ship', 'got', 'close', 'debrief', 'prep', 'quiet', 'agreed', 'status']) {
+  for (const cmd of ['brief', 'discover', 'plan', 'ship', 'outcome', 'close', 'debrief', 'prep', 'quiet', 'agreed', 'status']) {
     const rel = `.claude/commands/${cmd}.md`
     if (!fs.existsSync(path.join(root, rel))) fail(`${rel} missing`)
     else if (!read(rel).includes('@fde')) fail(`${rel} must load @fde`)
@@ -629,15 +615,88 @@ for (const manifest of ['plugin.json', 'mcp.json']) {
   else ok(`${manifest} published to npm`)
 }
 
+const skillDirs = []
 for (const entry of fs.readdirSync(path.join(root, 'skills'))) {
   const dir = path.join(root, 'skills', entry)
   if (!fs.statSync(dir).isDirectory()) continue
   if (!fs.existsSync(path.join(dir, 'SKILL.md'))) fail(`skills/${entry}/ has no SKILL.md - clients skip it`)
-  else ok(`skill ${entry} discoverable`)
+  else {
+    skillDirs.push(entry)
+    ok(`skill ${entry} discoverable`)
+  }
 }
+if (skillDirs.length !== 1 || skillDirs[0] !== 'fde') {
+  fail(`public tree ships one skill (skills/fde); found: ${skillDirs.join(', ') || '(none)'}`)
+} else ok('one public skill')
+
+function findSkillMd(dir, acc = []) {
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === '.git' || e.name === 'node_modules' || e.name === '.agents') continue
+    const p = path.join(dir, e.name)
+    if (e.isDirectory()) findSkillMd(p, acc)
+    else if (e.name === 'SKILL.md') acc.push(path.relative(root, p))
+  }
+  return acc
+}
+const skillFiles = findSkillMd(root)
+const allowedSkill = path.join('skills', 'fde', 'SKILL.md')
+if (skillFiles.length !== 1 || skillFiles[0] !== allowedSkill) {
+  fail(`only ${allowedSkill} may exist; found: ${skillFiles.join(', ') || '(none)'}`)
+} else ok('one SKILL.md')
 
 if (!fs.existsSync(path.join(root, '.github', 'ISSUE_TEMPLATE', 'bug_report.yml'))) {
   fail('GitHub issue template missing')
 } else ok('issue templates')
 
+function findUnicodeDashes(dir, acc = []) {
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === '.git' || e.name === 'node_modules' || e.name === '.agents') continue
+    const p = path.join(dir, e.name)
+    if (e.isDirectory()) findUnicodeDashes(p, acc)
+    else if (e.name === 'session.cast' || e.name === 'session.gif') continue
+    else {
+      let t
+      try { t = fs.readFileSync(p, 'utf8') } catch { continue }
+      if (t.includes('\u2014') || t.includes('\u2013')) acc.push(path.relative(root, p))
+    }
+  }
+  return acc
+}
+{
+  const dashed = findUnicodeDashes(root)
+  if (dashed.length) fail(`em/en dashes must be ASCII hyphen: ${dashed.join(', ')}`)
+  else ok('no em/en dashes')
+}
+
+if (!fs.existsSync(path.join(root, 'CODE_OF_CONDUCT.md'))) {
+  fail('CODE_OF_CONDUCT.md missing - GitHub community profile needs it')
+} else ok('CODE_OF_CONDUCT.md')
+
+if (!fs.existsSync(path.join(root, '.github', 'PULL_REQUEST_TEMPLATE.md'))) {
+  fail('.github/PULL_REQUEST_TEMPLATE.md missing - GitHub community profile needs it')
+} else ok('pull request template')
+
+if (!fs.existsSync(path.join(root, '.github', 'ISSUE_TEMPLATE', 'question.md'))) {
+  fail('.github/ISSUE_TEMPLATE/question.md missing - community profile needs a markdown template with name/about')
+} else {
+  const q = read('.github/ISSUE_TEMPLATE/question.md')
+  if (!/^---[\s\S]*\nname:/m.test(q) || !/^---[\s\S]*\nabout:/m.test(q)) {
+    fail('question.md must have YAML name: and about: so GitHub ticks issue templates')
+  } else ok('markdown issue template (name + about)')
+}
+
+{
+  const mktPath = path.join(root, '.claude-plugin', 'marketplace.json')
+  if (!fs.existsSync(mktPath)) fail('.claude-plugin/marketplace.json missing - /plugin marketplace add needs it')
+  else {
+    const mkt = JSON.parse(read('.claude-plugin/marketplace.json'))
+    const plug = (mkt.plugins || [])[0]
+    if (mkt.name !== 'fdeops' || !plug || plug.source !== './') {
+      fail('marketplace.json must name fdeops and list source ./')
+    } else if (!mkt.description && !(mkt.metadata && mkt.metadata.description)) {
+      fail('marketplace.json needs a description for the plugin directory')
+    } else ok('claude marketplace.json')
+  }
+}
+
 process.exit(failed)

package/bin/fde.js

@@ -1134,7 +1134,7 @@ function cmdResume(args) {
     const fdeDir = path.join(engRoot, '.fde')
     const existed = fs.existsSync(fdeDir)
 
-    // Optional stubs (AI eval pack, …) stay in templates/ for copy-on-use — not day-1 scaffold.
+    // Optional stubs (AI eval pack, …) stay in templates/ for copy-on-use - not day-1 scaffold.
     const SKIP_INIT_TEMPLATES = new Set(['evals.md'])
     const fillTemplates = (destFde) => {
       for (const f of fs.readdirSync(tpl)) {
@@ -1381,7 +1381,7 @@ function setContextPhase(eng, phase) {
 // as one dated debrief block. contact: lines may carry an inline [signal:x]
 // token anywhere in the text - preserved verbatim so computeSignals can trust it.
 // --smart: thin heuristic propose (existing prefixes + light keywords). Not a
-// brain — the agent rewrites .debrief-propose with prefixes; --apply commits.
+// brain - the agent rewrites .debrief-propose with prefixes; --apply commits.
 // --dry-run prints the routing without writing anything.
 function inferContactSignal(text) {
   const t = String(text)
@@ -1392,7 +1392,7 @@ function inferContactSignal(text) {
 }
 
 function looksLikePersonLine(text) {
-  // "Denise …" / "Randy opened…" — capitalized subject + field verb.
+  // "Denise …" / "Randy opened…" - capitalized subject + field verb.
   return /^[A-Z][a-z]{1,20}\b/.test(text) &&
     /\b(helping|quiet|skipped|said|will|opened|resistant|champion|warm|cold|unresponsive|demo|sheet|slack)\b/i.test(text)
 }
@@ -1688,7 +1688,7 @@ function cmdDebrief(args) {
 
 // Pull sink: stage raw artifacts outside the memory ledger, then reuse debrief
 // propose/apply. Never writes .fde/ until the FDE confirms apply. Source SaaS
-// (Granola/Gmail/…) is not here — only staging + the existing confirm gate.
+// (Granola/Gmail/…) is not here - only staging + the existing confirm gate.
 function inboxDir(eng) {
   return path.join(path.dirname(eng), '.inbox')
 }
@@ -1863,7 +1863,7 @@ function cmdIngest(args) {
   console.log(`staged → ${dest}`)
   console.log(`id: ${id}`)
   console.log('next:   fde ingest propose ' + id)
-  console.log('(does not write .fde/ — confirm via propose → apply)')
+  console.log('(does not write .fde/ - confirm via propose → apply)')
 }
 
 function cmdReceipts(args) {
@@ -2157,7 +2157,7 @@ function collectDoctorIssues(eng) {
     }
     if (engagementTouchesAI(eng) && !hasEvalReceipt(eng)) {
       issues.push(
-        `phase is ${s.phase} with AI in scope but no eval receipt (evals.md Verdict or delivery Eval / Ship receipts) — required before green ship/close`
+        `phase is ${s.phase} with AI in scope but no eval receipt (evals.md Verdict or delivery Eval / Ship receipts) - required before green ship/close`
       )
     }
   }
@@ -2302,7 +2302,7 @@ function hasValueBucket(eng) {
 // "pending review", "TBD.", "n/a (blocked)" and "..." are all the same thing an
 // FDE means by an empty cell - nagging about them teaches people to ignore doctor.
 const PENDING_CELL_RE =
-  /^(?:pending|tbd|to ?be ?(?:measured|confirmed|determined)|n\s*\/\s*a|na|none|unknown|not measured|\?+|\.{2,}|…|-+|—+|–+)(?:[^\w].*)?$/i
+  /^(?:pending|tbd|to ?be ?(?:measured|confirmed|determined)|n\s*\/\s*a|na|none|unknown|not measured|\?+|\.{2,}|…|-+|-+|-+)(?:[^\w].*)?$/i
 
 function parseValueLedger(eng) {
   const ledger = stripTemplateNoise(sectionBody(readClean(eng, 'delivery.md'), 'Value ledger') || '')
@@ -2359,7 +2359,7 @@ function valueLedgerStatusLines(eng, opts = {}) {
   return lines
 }
 
-// AI in scope for ship/close hygiene — delivery/decisions/trust evidence only.
+// AI in scope for ship/close hygiene - delivery/decisions/trust evidence only.
 // Do not scan terrain.md: its template headers mention LLM and would false-positive every ship.
 function engagementTouchesAI(eng) {
   const trust = readClean(eng, 'trust-profile.md')
@@ -2376,7 +2376,7 @@ function hasEvalReceipt(eng) {
   const evalsPath = path.join(eng, 'evals.md')
   if (fs.existsSync(evalsPath)) {
     const e = stripTemplateNoise(readClean(eng, 'evals.md'))
-    // Empty G1 stub + "Pass / fail" heading is not a receipt — need a real verdict/run/result.
+    // Empty G1 stub + "Pass / fail" heading is not a receipt - need a real verdict/run/result.
     if (/\*\*Verdict:\*\*\s*SHIP\b/i.test(e) || /(?:^|\n)\s*-\s*\*\*Verdict:\*\*\s*SHIP\b/i.test(e)) return true
     if (/\bLast run:\s*\d{4}-\d{2}-\d{2}/i.test(e)) return true
     if (/\|\s*G\d+\s*\|[^|\n]+\|[^|\n]+\|[^|\n]+\|[^|\n]+\|\s*pass\s*\|/i.test(e)) return true
@@ -2397,7 +2397,7 @@ function hygieneTriageLines(eng) {
   if (!issues.length) return []
   const top = issues[0].replace(/\s+/g, ' ').trim().slice(0, 72)
   return [
-    `  hygiene: ${issues.length} issue(s) — ${top}${issues[0].length > 72 ? '…' : ''}`,
+    `  hygiene: ${issues.length} issue(s) - ${top}${issues[0].length > 72 ? '…' : ''}`,
     '    → say "@fde clean up the fieldbook" when ready (agent runs fde doctor; nothing auto-rewrites)',
   ]
 }
@@ -2494,7 +2494,7 @@ function cmdPrep(args) {
   if (!eng) { console.error('no engagement - run: fde resume --init <name>'); process.exit(2) }
   const label = args.join(' ').trim() || 'next meeting'
   // Grounded brief: only text already in .fde/. No invention (Rowboat meeting-prep rule).
-  console.log(`MEETING PREP — ${label}`)
+  console.log(`MEETING PREP - ${label}`)
   console.log('(grounded in local .fde/ only - if a fact is missing, it is missing)\n')
   console.log(resumeTriage(eng))
   const owner = readOwner(eng)
@@ -2504,7 +2504,7 @@ function cmdPrep(args) {
   const people = extractStakeholders(eng).slice(0, 8)
   console.log('\nStakeholders (table + signal history)')
   if (!people.length) console.log('  (none yet - log contacts with --signal)')
-  else people.forEach(p => console.log(`  [${p.signal}] ${p.name}${p.role ? ` — ${p.role}` : ''}${p.note ? ` · ${p.note.slice(0, 60)}` : ''}`))
+  else people.forEach(p => console.log(`  [${p.signal}] ${p.name}${p.role ? ` - ${p.role}` : ''}${p.note ? ` · ${p.note.slice(0, 60)}` : ''}`))
 
   const risks = extractRisks(eng).slice(0, 5)
   console.log('\nOpen risks (table + dated bullets)')
@@ -2537,16 +2537,16 @@ function cmdGarden(args) {
   if (gitHealth.ok) {
     console.log('TIDY (contract: no new facts · no deleted substance · reversible via memory git)')
   } else if (gitHealth.reason === 'broken') {
-    console.log('TIDY (contract: no new facts · no deleted substance · ⚠ memory git BROKEN — NOT reversible until ledger is repaired)')
+    console.log('TIDY (contract: no new facts · no deleted substance · ⚠ memory git BROKEN - NOT reversible until ledger is repaired)')
   } else {
-    console.log('TIDY (contract: no new facts · no deleted substance · ⚠ memory not git-versioned — NOT reversible)')
+    console.log('TIDY (contract: no new facts · no deleted substance · ⚠ memory not git-versioned - NOT reversible)')
   }
   console.log(resumeTriage(eng))
   if (!gitHealth.ok) {
     console.log(
       gitHealth.reason === 'broken'
         ? '\n⚠ ledger is UNVERSIONED (corrupt .git). Repair before trusting tidy apply: mv .fde/.git .fde/.git.broken && run any fde write to re-init.'
-        : '\n⚠ no memory git — tidy apply cannot create a reversible commit until the ledger exists.'
+        : '\n⚠ no memory git - tidy apply cannot create a reversible commit until the ledger exists.'
     )
   }
   const proposals = []
@@ -2564,7 +2564,7 @@ function cmdGarden(args) {
     proposals.push({
       id: 'dedupe-risks',
       kind: 'apply',
-      text: `Consolidate ${dupes.length} duplicate open-risk cluster(s) (e.g. "${sample}${sample.length >= 50 ? '…' : ''}") — keep first, retire echoes`,
+      text: `Consolidate ${dupes.length} duplicate open-risk cluster(s) (e.g. "${sample}${sample.length >= 50 ? '…' : ''}") - keep first, retire echoes`,
       clusters: dupes,
     })
   }

package/bin/lib/memory.js

@@ -152,7 +152,7 @@ function createMemoryApi(deps) {
   }
 
   // True only when .git exists AND can resolve HEAD. A corrupt ledger (broken
-  // HEAD / missing objects) still has a .git directory — existsSync alone lied.
+  // HEAD / missing objects) still has a .git directory - existsSync alone lied.
   function memoryGitHealthy(eng) {
     if (!eng) return { ok: false, reason: 'missing' }
     if (!fs.existsSync(path.join(eng, '.git'))) return { ok: false, reason: 'missing' }

package/bin/lib/render.js

@@ -438,7 +438,7 @@ function todayViewHtml({ today, total, attentionCount, highRiskTotal, todayQueue
 <h1 class="fb-h1">Today</h1>
 <div class="fb-meta-line">${escapeHtml(today)} &middot; ${total} engagement${total === 1 ? '' : 's'} &middot; ${attentionCount} need you &middot; ${highRiskTotal} high risk${highRiskTotal === 1 ? '' : 's'} open</div>
 <div class="fb-block">
-<div class="fb-sec">Queue — next action per client, worst first</div>
+<div class="fb-sec">Queue - next action per client, worst first</div>
 ${todayQueue}
 </div>
 ${flagsHtml ? `<div class="fb-block">

package/bin/lib/trust.js

@@ -95,7 +95,7 @@ function createTrustApi(deps) {
 
   function nextActionLine(ctx) {
     // lastNonEmpty: template ships an empty ## Next action; agents often append a
-    // second heading with the real bullet — first-match would report "(none set)".
+    // second heading with the real bullet - first-match would report "(none set)".
     const body = sectionBody(ctx, 'Next action', { lastNonEmpty: true })
     for (const raw of body.split('\n')) {
       const t = raw.trim().replace(/^[-*]\s+/, '')

package/mcp/README.md

@@ -9,7 +9,7 @@ FDEOps MCP servers follow a **pluggable source model**: core owns the **sink**,
 | **Source** | FDE configures separately | Granola, Slack, Notion, Gmail, file |
 | **Sink** | FDEOps (`fdeops-ingest`) | stage → propose → apply into engagement memory |
 
-Source MCPs fetch raw text from SaaS APIs using credentials the FDE manages. The ingest MCP never stores OAuth tokens or calls external services — it only shells out to the local `fde` CLI.
+Source MCPs fetch raw text from SaaS APIs using credentials the FDE manages. The ingest MCP never stores OAuth tokens or calls external services - it only shells out to the local `fde` CLI.
 
 ## Ground loop
 
@@ -28,7 +28,7 @@ Source MCP(s)          fdeops-ingest MCP           fde CLI
 1. Agent pulls from whichever source MCPs are configured.
 2. Agent stages raw content via `ingest_stage` (with `source` provenance).
 3. Agent proposes routing via `ingest_propose`; FDE confirms.
-4. Agent applies via `ingest_apply` — nothing writes `.fde/` unreviewed.
+4. Agent applies via `ingest_apply` - nothing writes `.fde/` unreviewed.
 
 ## Packages
 

package/mcp/fdeops-ingest/README.md

@@ -2,9 +2,9 @@
 
 Thin stdio MCP server for the FDEOps **ingest sink** only: **stage → propose → apply**.
 
-This package shells out to the local `fde` CLI. It never calls SaaS APIs. Source MCPs (Granola, Slack, Notion, etc.) are **separate** — you add those in your own `mcp.json`.
+This package shells out to the local `fde` CLI. It never calls SaaS APIs. Source MCPs (Granola, Slack, Notion, etc.) are **separate** - you add those in your own `mcp.json`.
 
-**Prefer the CLI when this workspace is bound:** `fde ingest stage|list|propose|apply`. Use this MCP when the host did not start in a bound workspace — then pass `engagement` (path to `.fde/` from `fde resume --bind`) on every tool call.
+**Prefer the CLI when this workspace is bound:** `fde ingest stage|list|propose|apply`. Use this MCP when the host did not start in a bound workspace - then pass `engagement` (path to `.fde/` from `fde resume --bind`) on every tool call.
 
 ## Tools
 
@@ -70,12 +70,12 @@ Or after `npm link` in this directory:
 
 ## Daily loop (with separate source MCPs)
 
-1. **Fetch** — Use your source MCP (e.g. Granola, Gmail) to pull raw text. FDEOps does not bundle these.
-2. **Stage** — `ingest_stage` with `content`, `source` (e.g. `"granola"`), optional `title`.
-3. **List** — `ingest_list` to see staged items in `.inbox/`.
-4. **Propose** — `ingest_propose` with the staged `id`; agent reviews `.debrief-propose`.
-5. **Confirm** — FDE approves the proposal in chat.
-6. **Apply** — `ingest_apply` writes dated facts into `.fde/` with provenance.
+1. **Fetch** - Use your source MCP (e.g. Granola, Gmail) to pull raw text. FDEOps does not bundle these.
+2. **Stage** - `ingest_stage` with `content`, `source` (e.g. `"granola"`), optional `title`.
+3. **List** - `ingest_list` to see staged items in `.inbox/`.
+4. **Propose** - `ingest_propose` with the staged `id`; agent reviews `.debrief-propose`.
+5. **Confirm** - FDE approves the proposal in chat.
+6. **Apply** - `ingest_apply` writes dated facts into `.fde/` with provenance.
 
 Raw artifacts stay in `.inbox/`; the system of record (`.fde/`) stays thin and reviewed.
 

package/mcp/fdeops-ingest/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fdeops-ingest-mcp",
-  "version": "3.15.0",
+  "version": "3.15.2",
   "private": true,
   "description": "Thin stdio MCP sink for FDEOps ingest (stage → propose → apply). Zero runtime dependencies.",
   "bin": {

package/mcp/fdeops-ingest/server.js

@@ -2,7 +2,7 @@
 'use strict'
 
 /**
- * fdeops-ingest MCP — thin stdio sink for FDEOps ingest.
+ * fdeops-ingest MCP - thin stdio sink for FDEOps ingest.
  * Shells out to local `fde` CLI only. Never calls SaaS.
  * MCP stdio transport: newline-delimited JSON-RPC 2.0
  * (Content-Length frames are accepted on input).

package/mcp/recipes/README.md

@@ -4,13 +4,13 @@ FDEOps does **not** bundle Granola / Slack / Notion OAuth and does **not** push
 
 **Daily (no MCP):** paste notes to `@fde debrief`, or drop a file ([file.md](./file.md)).
 
-**Pull (optional):** you add a **source** MCP. The agent fetches text, then runs `fde ingest` in this bound workspace (stage → propose → you confirm → apply). The `fdeops-ingest` MCP is optional — only if you are not using the CLI from a bound workspace.
+**Pull (optional):** you add a **source** MCP. The agent fetches text, then runs `fde ingest` in this bound workspace (stage → propose → you confirm → apply). The `fdeops-ingest` MCP is optional - only if you are not using the CLI from a bound workspace.
 
 | Recipe | When |
 |--------|------|
 | [file.md](./file.md) | Transcript / export already on disk, or paste |
 | [granola.md](./granola.md) | Meeting transcripts via a notes MCP (or export) |
-| [slack.md](./slack.md) | Pull a thread/channel as text — never post |
+| [slack.md](./slack.md) | Pull a thread/channel as text - never post |
 | [notion.md](./notion.md) | Read a Notion page (or export markdown) |
 
 **Natural language:** `@fde I want to connect Granola` (or Slack / Notion) → `skills/fde/references/ingest-connect.md`.

package/mcp/recipes/file.md

@@ -1,6 +1,6 @@
 # Recipe: local file / paste (no source MCP)
 
-**Use when:** you already have a transcript, `.eml`, or export on disk — or you paste into chat. This is the default FDE path.
+**Use when:** you already have a transcript, `.eml`, or export on disk - or you paste into chat. This is the default FDE path.
 
 ## Setup
 

package/mcp/recipes/granola.md

@@ -1,6 +1,6 @@
 # Recipe: Granola-shaped meeting transcripts
 
-**Use when:** meeting notes live in Granola (or a similar notes MCP). FDEOps does not ship a Granola server — you add whichever MCP/export path you trust.
+**Use when:** meeting notes live in Granola (or a similar notes MCP). FDEOps does not ship a Granola server - you add whichever MCP/export path you trust.
 
 Daily path if the notes are already in chat or on disk: paste to `@fde debrief` or [file.md](./file.md). This recipe is only for **pull**.
 
@@ -8,7 +8,7 @@ Daily path if the notes are already in chat or on disk: paste to `@fde debrief`
 
 1. Enable a **Granola (or notes) MCP** in Cursor/Claude per that product’s docs.
 2. Reload MCP / restart the host.
-3. Test: `@fde what can you pull?` — notes-source tools should appear.
+3. Test: `@fde what can you pull?` - notes-source tools should appear.
 
 The sink is **`fde ingest` in this bound workspace.** You do not need `fdeops-ingest` MCP for daily pull.
 
@@ -40,15 +40,15 @@ Replace command/args with whatever the real Granola MCP documents. FDEOps only n
 
 ## Agent steps
 
-1. Capability check — notes-source tools present?
+1. Capability check - notes-source tools present?
 2. Fetch transcript text (ask which meeting if ambiguous).
 3. `fde ingest stage --source granola --title "<short>"` then propose → confirm → apply.
-4. Extract decisions/risks/next — do not dump the raw transcript into `.fde/`.
+4. Extract decisions/risks/next - do not dump the raw transcript into `.fde/`.
 
 ## Common fails
 
 | Symptom | Fix |
 |---------|-----|
-| No Granola tools | Source MCP not loaded — they save + reload |
+| No Granola tools | Source MCP not loaded - they save + reload |
 | Wrong meeting | One clarifying question, then fetch |
 | Wrong engagement | `fde resume` in this workspace before staging |

package/mcp/recipes/notion.md

@@ -1,6 +1,6 @@
 # Recipe: Notion docs / meeting notes
 
-**Use when:** useful engagement notes live in Notion. FDEOps does not ship a Notion server — use a Notion MCP (or export markdown). We do not write back to Notion.
+**Use when:** useful engagement notes live in Notion. FDEOps does not ship a Notion server - use a Notion MCP (or export markdown). We do not write back to Notion.
 
 ## Setup (once)
 
@@ -36,7 +36,7 @@ The sink is **`fde ingest` in this bound workspace.** `fdeops-ingest` MCP is opt
 
 ## Agent steps
 
-1. Capability check — Notion read tools present?
+1. Capability check - Notion read tools present?
 2. Fetch page/block text (ask which page if ambiguous).
 3. `fde ingest stage --source notion --title "<short>"` → propose → confirm → apply.
 

package/mcp/recipes/slack.md

@@ -8,7 +8,7 @@ You add whatever Slack MCP your host already supports. We only accept **text you
 
 1. Enable a **Slack MCP** (official or community) with read access to the threads you need.
 2. Reload MCP / restart the host.
-3. Test: `@fde what can you pull?` — Slack fetch tools should appear. The FDEOps **CLI** (`fde ingest`) is the sink if this workspace is bound; you do not need `fdeops-ingest` MCP for daily use.
+3. Test: `@fde what can you pull?` - Slack fetch tools should appear. The FDEOps **CLI** (`fde ingest`) is the sink if this workspace is bound; you do not need `fdeops-ingest` MCP for daily use.
 
 ### Example mcp.json shape (illustrative)
 
@@ -40,10 +40,10 @@ Optional sink MCP (only if you are not running `fde ingest` from this workspace)
 
 ## Agent steps
 
-1. Capability check — Slack **read** tools present? If not → this recipe, then stop.
+1. Capability check - Slack **read** tools present? If not → this recipe, then stop.
 2. Fetch the thread/channel as **text** (ask which channel/thread if ambiguous).
 3. `fde ingest stage --source slack --title "<short>"` (CLI in this bound workspace).
-4. Propose → FDE confirms → apply. Extract decisions/risks/asks — do not dump the thread into `.fde/`.
+4. Propose → FDE confirms → apply. Extract decisions/risks/asks - do not dump the thread into `.fde/`.
 
 ## Never
 
@@ -55,7 +55,7 @@ Optional sink MCP (only if you are not running `fde ingest` from this workspace)
 
 | Symptom | Fix |
 |---------|-----|
-| No Slack tools | Source MCP not loaded — they save + reload; we cannot silent-install |
-| Missing channel | Token/scopes cannot read that workspace — their Slack admin, not FDEOps |
+| No Slack tools | Source MCP not loaded - they save + reload; we cannot silent-install |
+| Missing channel | Token/scopes cannot read that workspace - their Slack admin, not FDEOps |
 | Huge dump | Stage full text in `.inbox/`; apply only short dated facts |
 | Wrong client | Bind this workspace (`fde resume`) before staging |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fdeops",
-  "version": "3.15.0",
+  "version": "3.15.2",
   "description": "Forward deployed engineering skills for AI coding agents. Your agent forgets the client every morning - the sponsor, the promise, who signed off. FDEOps keeps that as dated markdown on your laptop: one @fde skill, a deterministic local CLI, and hooks that make it automatic. Claude Code plugin and any agent that loads skills.",
   "bin": {
     "fdeops": "bin/install.js",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "fdeops",
-  "version": "3.15.0",
+  "version": "3.15.2",
   "description": "Forward deployed engineering skills for AI coding agents: per-client memory in local .fde/ files, one @fde skill. Local-only, no network.",
   "author": {
     "name": "Subash Natarajan",