fdeops 3.9.6 → 3.9.9

package/README.md

@@ -2,12 +2,12 @@
 
 **Your AI coding agent forgets your client every morning. fdeops remembers.**
 
-[![npm version](https://img.shields.io/npm/v/fdeops)](https://www.npmjs.com/package/fdeops)
+[![npm version](https://img.shields.io/npm/v/fdeops.svg)](https://www.npmjs.com/package/fdeops)
 [![CI](https://github.com/suboss87/fdeops/actions/workflows/validate.yml/badge.svg)](https://github.com/suboss87/fdeops/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 
-One `@fde` skill over a local client notebook (the **fieldbook** under `.fde/`) - one folder per client. The **second brain for Forward Deployed Engineers** - engineers embedded at a client, from first meeting to final handoff. Works the same for consultants, agency developers, solutions architects, and fractional CTOs.
+One `@fde` skill over a local client notebook (the **fieldbook** under `.fde/`) - one folder per client. The **system of record for embeds** - Forward Deployed Engineers and anyone living on a client site from first meeting to handoff. Feels like a second brain; behaves like a defensible record (dated, sourced, yours). Works the same for consultants, agency developers, solutions architects, and fractional CTOs.
 
 ```
   land      discover      plan      build      ship      close
@@ -33,7 +33,7 @@ Day to day you only need `@fde` and normal English. No command cheat sheet.
 | **Someone disputes scope** | `@fde` when did we agree to drop that feature? | Dated answers from the record (or a clear gap if nothing was logged) |
 | **End of week** | `@fde` draft the sponsor update from the record | Status grounded in what actually happened |
 
-Same client folder every time (`~/fde-engagements/<client>/.fde/`). Your AI coding agent reads it on every session. Optional terminal tools live under [Under the hood](#under-the-hood-optional).
+Same client folder every time (`~/fde-engagements/<client>/.fde/`). Your AI coding agent reads it on every session.
 
 ---
 
@@ -88,7 +88,7 @@ npx fdeops resume                 # prints a short "where we are" for this clien
 
 - **You** describe the situation with `@fde` (or plain language once the skill is loaded)
 - **Session start / end** - small hooks load where you left off and capture what changed (no re-paste)
-- **Under the hood** - a local CLI does memory writes, search, and status with no model tokens; you do not need to learn it for daily use
+- **Local CLI** - memory writes, search, and status with no model tokens; the agent runs it. You do not need to learn it for daily use ([docs/USAGE.md](docs/USAGE.md))
 
 fdeops complements repo memory: CLAUDE.md holds how the *code* works; the fieldbook holds how the *client engagement* works.
 
@@ -114,7 +114,7 @@ Overlays for regulated domains (AI, fintech, healthcare, government) activate on
 
 ## Engagement memory (`.fde/`)
 
-The **fieldbook** - one folder per client, plain markdown you can read, grep, and take with you:
+The **fieldbook** is the system of record for the embed - one folder per client, plain markdown you can read, grep, and take with you:
 
 | File | Holds |
 |------|-------|
@@ -129,52 +129,11 @@ Every entry is dated and sourced, so you can defend it in front of skeptical sta
 
 ---
 
-## Under the hood (optional)
+## Fieldbook UI
 
-**You do not need to learn these for daily work.** Chat with `@fde`; the agent runs the local tools. The list below is for setup, air-gap, or if you prefer the terminal.
+Open the system of record in a browser - trust, phase, next action, and the full record in one local page. Ask `@fde` for the dashboard, or run `npx fdeops dashboard` (current engagement by default; `--all` for the portfolio).
 
-**Humans only need (once / occasional):**
-
-```bash
-npx fdeops resume --init <client>   # one-time: create + bind this workspace
-npx fdeops resume                   # check "where we are"
-npx fdeops scan                     # try day-1 recon with no install
-npx fdeops dashboard                # optional local HTML view of the fieldbook
-```
-
-**What you say → what the agent runs** (you never have to type the right-hand side):
-
-| You say | Agent runs |
-|---------|------------|
-| Debrief these notes | `fde debrief --smart …` → you confirm → `--apply` |
-| Prep me for the sponsor meeting | `fde prep "…"` |
-| When did we agree to drop that? | `fde receipts …` |
-| Draft the sponsor update | `fde status` (+ judgment in chat) |
-| Log that the sponsor went quiet | `fde log contact "…" --signal amber` |
-
-<details>
-<summary><strong>Full command list</strong> (power users / scripts)</summary>
-
-```bash
-fde triage                        # short status (also injected by session hooks)
-fde debrief notes.md              # if notes already use decision: / risk: / … prefixes
-fde doctor                        # check the fieldbook for gaps
-fde log decision "…"
-fde log contact "…" --signal amber
-fde dashboard --all               # every client, sorted by trust
-```
-
-Optional: `export FDEOPS_ENGAGEMENTS_ROOT=~/path/to/engagements` to isolate from `~/fde-engagements`.
-
-Each `.fde/` is a local git repo (no remote, no telemetry). More detail: [docs/USAGE.md](docs/USAGE.md).
-
-</details>
-
-<p align="center"><img src="media/terminal-demo.svg" alt="fde CLI - status, scan, dashboard" width="720"/></p>
-
-Optional FieldBook view (`fde dashboard`) - current engagement by default:
-
-<p align="center"><img width="1336" height="624" alt="fde dashboard FieldBook" src="https://github.com/user-attachments/assets/5683614c-7730-4a3a-860d-185053a377eb" /></p>
+<p align="center"><img width="1336" height="624" alt="fdeops Fieldbook in the browser" src="https://github.com/user-attachments/assets/5683614c-7730-4a3a-860d-185053a377eb" /></p>
 
 ---
 
@@ -186,7 +145,7 @@ Optional FieldBook view (`fde dashboard`) - current engagement by default:
 | **Consultant or contractor at a client site** | Remembers the engagement so you stop re-explaining it |
 | **Solutions architect / engineer** | Methods for the politics as well as the architecture |
 | **Agency developer running 3-5 clients** | One `.fde/` per client - details stop blurring |
-| **Fractional CTO doing client work** | The fieldbook is your second brain - and your audit trail for billable work |
+| **Fractional CTO doing client work** | The fieldbook is your system of record for the embed - and your audit trail for billable work |
 
 ---
 

package/bin/check.js

@@ -266,15 +266,25 @@ ok('hooks registry-aware')
 if (!fs.existsSync(path.join(root, 'bin', 'fde.js'))) {
   fail('bin/fde.js missing (the deterministic core)')
 } else {
-  const cli = read('bin/fde.js')
-  for (const sub of ['cmdScan', 'cmdResume', 'cmdLog', 'cmdDebrief', 'cmdReceipts', 'cmdCapture', 'cmdStatus']) {
-    if (!cli.includes(sub)) fail(`fde.js missing ${sub}`)
+  const cliFiles = [
+    'bin/fde.js',
+    ...fs.readdirSync(path.join(root, 'bin', 'lib'))
+      .filter(name => name.endsWith('.js'))
+      .map(name => path.join('bin', 'lib', name)),
+  ]
+  const cliSource = cliFiles.map(read).join('\n')
+  for (const sub of ['cmdScan', 'cmdResume', 'cmdLog', 'cmdDebrief', 'cmdReceipts', 'cmdCapture', 'cmdStatus', 'cmdDashboard']) {
+    if (!cliSource.includes(sub)) fail(`CLI sources missing ${sub}`)
   }
   if (!JSON.parse(read('package.json')).bin.fde) fail('package.json must expose the fde bin')
   if (!read('bin/install.js').includes('fde.js')) fail('install.js must deploy fde.js')
+  if (!read('bin/install.js').includes('LIB_SRC')) fail('install.js must deploy bin/lib/')
   if (!read('skills/fde/SKILL.md').includes('fde resume')) fail('SKILL.md must use the CLI for memory ops')
-  if (!cli.includes('[signal:')) fail('fde.js must support structured [signal:x] trust tokens')
-  if (!cli.includes('ASK ON DAY 1')) fail('fde.js scan must emit ASK ON DAY 1 questions')
+  if (!cliSource.includes('[signal:')) fail('CLI sources must support structured [signal:x] trust tokens')
+  if (!cliSource.includes('ASK ON DAY 1')) fail('CLI sources must emit ASK ON DAY 1 questions')
+  for (const renderSymbol of ['buildFieldbookHtml', 'dashStyles', 'dashScript', 'FONT_FACE_CSS']) {
+    if (!cliSource.includes(renderSymbol)) fail(`CLI sources missing dashboard renderer symbol ${renderSymbol}`)
+  }
   if (!read('bin/install.js').includes('FDE_SUBCOMMANDS')) fail('install.js must pass fde subcommands through (npx fdeops scan)')
   ok('fde CLI present and wired')
 }