fdeops 3.5.0

package/bin/install.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+
+const SKILLS_SRC = path.join(__dirname, '..', 'skills')
+const HOOKS_SRC = path.join(__dirname, '..', 'hooks')
+const CLAUDE_MD_SRC = path.join(__dirname, '..', 'CLAUDE.md.template')
+const FDE_TEMPLATES_SRC = path.join(__dirname, '..', 'templates', '.fde')
+const ADAPTERS_SRC = path.join(__dirname, '..', 'adapters')
+
+const GLOBAL_SKILLS_DIR = path.join(os.homedir(), '.claude', 'skills')
+const GLOBAL_HOOKS_DIR = path.join(os.homedir(), '.claude', 'hooks')
+const HOOK_SCRIPTS = ['session-start', 'session-stop', 'pre-compact']
+const ENGAGEMENTS_ROOT = path.join(os.homedir(), 'fde-engagements')
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true })
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name)
+    const destPath = path.join(dest, entry.name)
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath)
+    } else {
+      fs.copyFileSync(srcPath, destPath)
+    }
+  }
+}
+
+function copyTemplateTree(src, dest, onlyMissing) {
+  let merged = 0
+  fs.mkdirSync(dest, { recursive: true })
+  for (const name of fs.readdirSync(src)) {
+    const srcPath = path.join(src, name)
+    const destPath = path.join(dest, name)
+    if (fs.statSync(srcPath).isDirectory()) {
+      merged += copyTemplateTree(srcPath, destPath, onlyMissing)
+    } else if (!onlyMissing || !fs.existsSync(destPath)) {
+      fs.copyFileSync(srcPath, destPath)
+      if (onlyMissing) merged++
+    }
+  }
+  return merged
+}
+
+function slugify(name) {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '')
+    || 'engagement'
+}
+
+// v2 shipped 16 standalone skills; v3 is one `fde` skill + references.
+// Leaving the old ones in place would route users to stale content.
+const LEGACY_SKILL_DIRS = [
+  'fde-land', 'fde-discover', 'fde-audit', 'fde-rescue', 'fde-sketch',
+  'fde-close', 'fde-engineering', 'fde-plan', 'fde-build', 'fde-review',
+  'fde-debug', 'fde-ship', 'fde-dashboard', 'healthcare-fde', 'fintech-fde',
+  'gov-fde',
+]
+
+function removeLegacySkills() {
+  let removed = 0
+  for (const dir of LEGACY_SKILL_DIRS) {
+    const p = path.join(GLOBAL_SKILLS_DIR, dir)
+    if (fs.existsSync(path.join(p, 'SKILL.md'))) {
+      fs.rmSync(p, { recursive: true, force: true })
+      removed++
+    }
+  }
+  return removed
+}
+
+function installSkills() {
+  const removed = removeLegacySkills()
+  if (removed > 0) console.log(`  Removed ${removed} v2 skill dir(s) (now covered by @fde)`)
+  copyDir(SKILLS_SRC, GLOBAL_SKILLS_DIR)
+  fs.mkdirSync(GLOBAL_HOOKS_DIR, { recursive: true })
+  for (const name of HOOK_SCRIPTS) {
+    const src = path.join(HOOKS_SRC, name)
+    if (!fs.existsSync(src)) continue
+    const dest = path.join(GLOBAL_HOOKS_DIR, `fdeops-${name}`)
+    fs.copyFileSync(src, dest)
+    try {
+      fs.chmodSync(dest, '755')
+    } catch (_) {}
+  }
+  const globalPointer = path.join(os.homedir(), '.claude', 'FDEOPS-CLAUDE.md')
+  if (!fs.existsSync(globalPointer)) {
+    fs.copyFileSync(CLAUDE_MD_SRC, globalPointer)
+  }
+  fs.copyFileSync(CLAUDE_MD_SRC, path.join(os.homedir(), '.claude', 'FDEOPS-CLAUDE.md.template'))
+
+  // the fde CLI + templates, so the skill can call it from any workspace
+  const cliHome = path.join(os.homedir(), '.claude', 'fdeops')
+  fs.mkdirSync(cliHome, { recursive: true })
+  fs.copyFileSync(path.join(__dirname, 'fde.js'), path.join(cliHome, 'fde.js'))
+  try { fs.chmodSync(path.join(cliHome, 'fde.js'), '755') } catch (_) {}
+  copyDir(FDE_TEMPLATES_SRC, path.join(cliHome, 'templates', '.fde'))
+
+  // cross-platform pointer templates, so `fdeops adapters` works from anywhere
+  if (fs.existsSync(ADAPTERS_SRC)) copyDir(ADAPTERS_SRC, path.join(cliHome, 'adapters'))
+}
+
+// One brain (skills/fde/SKILL.md) reached through a thin pointer per tool.
+// Each tool reads a different file in a different place; the content is the same.
+const ADAPTER_TARGETS = [
+  { label: 'CLAUDE.md', dest: 'CLAUDE.md', src: CLAUDE_MD_SRC, appendable: true },
+  { label: 'AGENTS.md', dest: 'AGENTS.md', src: path.join(ADAPTERS_SRC, 'AGENTS.md'), appendable: true },
+  { label: 'GEMINI.md', dest: 'GEMINI.md', src: path.join(ADAPTERS_SRC, 'GEMINI.md'), appendable: true },
+  { label: '.github/copilot-instructions.md', dest: path.join('.github', 'copilot-instructions.md'), src: path.join(ADAPTERS_SRC, 'copilot-instructions.md'), appendable: true },
+  { label: '.cursor/rules/fde.mdc', dest: path.join('.cursor', 'rules', 'fde.mdc'), src: path.join(ADAPTERS_SRC, 'cursor.fde.mdc'), appendable: false },
+]
+
+const FDE_MARKER = '<!-- fdeops adapter - points your AI tool at @fde; safe to keep -->'
+
+function placePointer(destPath, content, label, appendable) {
+  fs.mkdirSync(path.dirname(destPath), { recursive: true })
+  if (fs.existsSync(destPath)) {
+    const existing = fs.readFileSync(destPath, 'utf8')
+    if (/FDEOS|fdeops/i.test(existing)) {
+      console.log(`  skip   ${label} (already wired)`)
+      return
+    }
+    if (!appendable) {
+      console.log(`  skip   ${label} (exists - left untouched)`)
+      return
+    }
+    fs.writeFileSync(destPath, `${existing.trimEnd()}\n\n${FDE_MARKER}\n\n${content}`)
+    console.log(`  append ${label}`)
+    return
+  }
+  fs.writeFileSync(destPath, content)
+  console.log(`  write  ${label}`)
+}
+
+function cmdAdapters(targetDir) {
+  const dest = path.resolve(targetDir || process.cwd())
+  console.log('')
+  console.log(`  fdeops cross-platform adapters → ${dest}`)
+  console.log('  One brain (skills/fde/SKILL.md). These are thin pointers per tool.')
+  console.log('')
+  for (const a of ADAPTER_TARGETS) {
+    if (!fs.existsSync(a.src)) { console.log(`  skip   ${a.label} (template missing)`); continue }
+    placePointer(path.join(dest, a.dest), fs.readFileSync(a.src, 'utf8'), a.label, a.appendable)
+  }
+  console.log('')
+  console.log('  Open this workspace in Claude Code, Cursor, Codex, Gemini CLI, or Copilot')
+  console.log('  and type @fde - each tool now routes to the same engagement brain.')
+  console.log('')
+}
+
+function cmdInit(engagementName) {
+  if (!engagementName) {
+    console.error('  Usage: node bin/install.js init <engagement-name>')
+    console.error('  Example: node bin/install.js init retailbank-payments')
+    process.exit(1)
+  }
+  const slug = slugify(engagementName)
+  const root = path.join(ENGAGEMENTS_ROOT, slug)
+  const fdeDir = path.join(root, '.fde')
+  const created = !fs.existsSync(fdeDir)
+  const merged = copyTemplateTree(FDE_TEMPLATES_SRC, fdeDir, !created)
+
+  const pointer = path.join(root, 'ENGAGEMENT.md')
+  if (!fs.existsSync(pointer)) {
+    fs.writeFileSync(
+      pointer,
+      `# ${engagementName}\n\nEngagement root: \`${fdeDir}\`\n\nPoint your **AI coding agent** at this folder (not a human colleague). Add to ~/.claude/FDEOPS-CLAUDE.md:\n\n\`\`\`\nFDEOPS_ENGAGEMENT=${fdeDir}\n\`\`\`\n\nOpen your workspace. In the AI chat, type \`@fde\`.\n`,
+    )
+  }
+
+  console.log('')
+  console.log('  fdeops engagement created (private notes on your machine)')
+  console.log('')
+  console.log(`  ${fdeDir}`)
+  if (created) console.log('  (new)')
+  else if (merged > 0) console.log(`  (${merged} missing template file(s) added)`)
+  console.log('')
+  console.log('  Next:')
+  console.log('  1. Open your workspace for this engagement')
+  console.log(`  2. Point your AI coding agent at: FDEOPS_ENGAGEMENT=${fdeDir}`)
+  console.log('  3. In the AI chat (not email), type: @fde and describe what is happening')
+  console.log('')
+}
+
+function cmdInstall() {
+  console.log('')
+  console.log('  fdeops - installs on YOUR machine only')
+  console.log('')
+  installSkills()
+  console.log('  Skills → ~/.claude/skills/')
+  console.log('  Hooks → ~/.claude/hooks/fdeops-*')
+  console.log('  CLI → ~/.claude/fdeops/fde.js  (try: node ~/.claude/fdeops/fde.js scan)')
+  console.log('')
+  console.log('  Create an engagement (stays off customer infrastructure):')
+  console.log('    node bin/install.js init <engagement-name>')
+  console.log('')
+  console.log('  Example:')
+  console.log('    node bin/install.js init acme-payments')
+  console.log('  (npm 3.0.0+: npx fdeops@latest init <engagement-name>)')
+  console.log('')
+  console.log('  Use another AI tool (Cursor, Codex, Gemini CLI, Copilot)? Wire it up:')
+  console.log('    node bin/install.js adapters <engagement-workspace>')
+  console.log('')
+  console.log('  Then open your workspace and use @fde')
+  console.log('  Docs: docs/install.md')
+  console.log('')
+}
+
+const arg = process.argv[2]
+if (arg === 'init') {
+  cmdInit(process.argv[3])
+} else if (arg === 'adapters') {
+  cmdAdapters(process.argv[3])
+} else {
+  cmdInstall()
+}

package/hooks/hooks.json

@@ -0,0 +1,40 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "'${CLAUDE_PLUGIN_ROOT}/hooks/session-start'",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "'${CLAUDE_PLUGIN_ROOT}/hooks/pre-compact'",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "'${CLAUDE_PLUGIN_ROOT}/hooks/session-stop'",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/pre-compact

@@ -0,0 +1,66 @@
+#!/bin/bash
+# fdeops PreCompact - preserve engagement state before context compaction.
+# Resolves the engagement the same way as session-start/session-stop.
+
+resolve_engagement_dir() {
+  local raw="$1"
+  [ -z "$raw" ] && return 1
+  # strip surrounding whitespace/quotes only - paths may contain spaces
+  raw=$(printf '%s' "$raw" | sed -e 's/^[[:space:]"'"'"']*//' -e 's/[[:space:]"'"'"']*$//' -e "s|^~|$HOME|")
+  [ -d "$raw" ] && printf '%s\n' "$raw" && return 0
+  return 1
+}
+
+ENG_DIR=$(resolve_engagement_dir "${FDEOPS_ENGAGEMENT:-${FDEOS_ENGAGEMENT:-}}")
+
+if [ -z "$ENG_DIR" ] && [ -f "CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' CLAUDE.md 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+fi
+
+if [ -z "$ENG_DIR" ] && [ -f "$HOME/.claude/FDEOPS-CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' "$HOME/.claude/FDEOPS-CLAUDE.md" 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+fi
+
+if [ -z "$ENG_DIR" ] && [ -d ".fde" ]; then
+  ENG_DIR=".fde"
+fi
+
+[ -z "$ENG_DIR" ] && exit 0
+
+CONTEXT_FILE="$ENG_DIR/context.md"
+DECISIONS_FILE="$ENG_DIR/decisions.md"
+RISKS_FILE="$ENG_DIR/risks.md"
+MARKER="[fdeops context preserved"
+
+[ -f "$CONTEXT_FILE" ] || exit 0
+
+# Avoid unbounded growth: skip if we already preserved today.
+if grep -q "$MARKER" "$CONTEXT_FILE" 2>/dev/null; then
+  LAST=$(grep "$MARKER" "$CONTEXT_FILE" | tail -1)
+  if echo "$LAST" | grep -q "$(date -u +%Y-%m-%d)"; then
+    exit 0
+  fi
+fi
+
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+LAST_DECISIONS=""
+OPEN_RISKS=""
+
+[ -f "$DECISIONS_FILE" ] && LAST_DECISIONS=$(tail -20 "$DECISIONS_FILE" 2>/dev/null)
+[ -f "$RISKS_FILE" ] && OPEN_RISKS=$(grep -iE "open|active|unresolved" "$RISKS_FILE" 2>/dev/null | head -8)
+
+cat >> "$CONTEXT_FILE" 2>/dev/null << EOF
+
+---
+$MARKER at $TIMESTAMP]
+Recent decisions (tail):
+$LAST_DECISIONS
+
+Open risks:
+$OPEN_RISKS
+---
+EOF
+
+exit 0

package/hooks/run-hook.cmd

@@ -0,0 +1,3 @@
+@echo off
+:: Windows wrapper for session-start (uses PowerShell)
+powershell -ExecutionPolicy Bypass -File "%~dp0session-start"

package/hooks/session-start

@@ -0,0 +1,91 @@
+#!/bin/bash
+# fdeops SessionStart - load @fde + engagement context from FDE laptop path.
+
+CONTEXT_FILE=""
+BOOTSTRAP=""
+
+for candidate in \
+  "${CLAUDE_PLUGIN_ROOT:+$CLAUDE_PLUGIN_ROOT/skills/fde/SKILL.md}" \
+  "$(dirname "$0")/../skills/fde/SKILL.md" \
+  "$HOME/.claude/skills/fde/SKILL.md"; do
+  if [ -n "$candidate" ] && [ -f "$candidate" ]; then
+    BOOTSTRAP="$candidate"
+    break
+  fi
+done
+
+resolve_engagement_dir() {
+  local raw="$1"
+  [ -z "$raw" ] && return 1
+  # strip surrounding whitespace/quotes only - paths may contain spaces
+  raw=$(printf '%s' "$raw" | sed -e 's/^[[:space:]"'"'"']*//' -e 's/[[:space:]"'"'"']*$//' -e "s|^~|$HOME|")
+  [ -d "$raw" ] && printf '%s\n' "$raw" && return 0
+  return 1
+}
+
+# 1) Environment variable (any agent)
+if [ -z "$CONTEXT_FILE" ]; then
+  ENG_DIR=$(resolve_engagement_dir "${FDEOPS_ENGAGEMENT:-${FDEOS_ENGAGEMENT:-}}")
+  [ -n "$ENG_DIR" ] && CONTEXT_FILE="$ENG_DIR/context.md"
+fi
+
+# 2) Project CLAUDE.md
+if [ -z "$CONTEXT_FILE" ] && [ -f "CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' CLAUDE.md 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+  [ -n "$ENG_DIR" ] && CONTEXT_FILE="$ENG_DIR/context.md"
+fi
+
+# 3) Global fdeops pointer file
+if [ -z "$CONTEXT_FILE" ] && [ -f "$HOME/.claude/FDEOPS-CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' "$HOME/.claude/FDEOPS-CLAUDE.md" 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+  [ -n "$ENG_DIR" ] && CONTEXT_FILE="$ENG_DIR/context.md"
+fi
+
+# 4) Optional in-repo .fde (customer-approved only)
+if [ -z "$CONTEXT_FILE" ] && [ -f ".fde/context.md" ]; then
+  CONTEXT_FILE=".fde/context.md"
+fi
+
+IS_FDE_PROJECT=0
+[ -n "$CONTEXT_FILE" ] && [ -f "$CONTEXT_FILE" ] && IS_FDE_PROJECT=1
+[ -f "CLAUDE.md" ] && grep -qi "fde\|fdeops" "CLAUDE.md" 2>/dev/null && IS_FDE_PROJECT=1
+[ -n "${FDEOPS_ENGAGEMENT:-${FDEOS_ENGAGEMENT:-}}" ] && IS_FDE_PROJECT=1
+[ -d ".fde" ] && IS_FDE_PROJECT=1
+
+if [ "$IS_FDE_PROJECT" -eq 0 ]; then
+  exit 0
+fi
+
+# Token discipline: context.md grows every session (session-stop appends a
+# snapshot). Inject a bounded view - curated head + most recent activity -
+# instead of the whole log. Mirrors resumeView() in bin/fde.js; keep in sync.
+bounded_context() {
+  local f="$1" total head_end tail_start hidden
+  total=$(wc -l < "$f" 2>/dev/null | tr -d ' ')
+  [ -z "$total" ] && { cat "$f"; return; }
+  if [ "$total" -le 160 ]; then cat "$f"; return; fi
+  head_end=$(grep -n -m1 'fdeops auto-capture' "$f" 2>/dev/null | cut -d: -f1)
+  if [ -n "$head_end" ]; then head_end=$((head_end - 1)); else head_end=120; fi
+  [ "$head_end" -gt 120 ] && head_end=120
+  [ "$head_end" -lt 0 ] && head_end=0
+  tail_start=$((total - 40 + 1))
+  if [ "$tail_start" -le "$((head_end + 1))" ]; then cat "$f"; return; fi
+  hidden=$((tail_start - head_end - 1))
+  [ "$head_end" -ge 1 ] && sed -n "1,${head_end}p" "$f"
+  printf '\n_(… %s lines of earlier session log hidden - `fde resume --full` or open context.md for the full history)_\n\n' "$hidden"
+  sed -n "${tail_start},\$p" "$f"
+}
+
+CONTENT=""
+
+if [ -n "$BOOTSTRAP" ]; then
+  CONTENT="$CONTENT$(cat "$BOOTSTRAP")\n\n"
+fi
+
+if [ -n "$CONTEXT_FILE" ] && [ -f "$CONTEXT_FILE" ]; then
+  CONTENT="$CONTENT---\nEngagement context ($CONTEXT_FILE):\n$(bounded_context "$CONTEXT_FILE")\n"
+fi
+
+printf '%b' "$CONTENT"

package/hooks/session-stop

@@ -0,0 +1,86 @@
+#!/bin/bash
+# fdeops SessionEnd - write-side memory backstop.
+#
+# The skill's memory contract says the agent appends a meaningful
+# "where we left off" to context.md before the session ends. This hook
+# guarantees a deterministic floor when it doesn't: date, workspace state,
+# and which engagement artifacts moved. Next session-start loads it back.
+#
+# Deliberately dumb: no model calls, no network, append-only, exits silently.
+
+cat >/dev/null 2>&1 || true  # drain hook stdin; payload unused
+
+resolve_engagement_dir() {
+  local raw="$1"
+  [ -z "$raw" ] && return 1
+  # strip surrounding whitespace/quotes only - paths may contain spaces
+  raw=$(printf '%s' "$raw" | sed -e 's/^[[:space:]"'"'"']*//' -e 's/[[:space:]"'"'"']*$//' -e "s|^~|$HOME|")
+  [ -d "$raw" ] && printf '%s\n' "$raw" && return 0
+  return 1
+}
+
+ENG_DIR=""
+
+# 1) Environment variable (any agent)
+ENG_DIR=$(resolve_engagement_dir "${FDEOPS_ENGAGEMENT:-${FDEOS_ENGAGEMENT:-}}")
+
+# 2) Project CLAUDE.md
+if [ -z "$ENG_DIR" ] && [ -f "CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' CLAUDE.md 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+fi
+
+# 3) Global fdeops pointer file
+if [ -z "$ENG_DIR" ] && [ -f "$HOME/.claude/FDEOPS-CLAUDE.md" ]; then
+  ENG=$(grep -m1 '^FDEOPS_ENGAGEMENT=\|^FDEOS_ENGAGEMENT=' "$HOME/.claude/FDEOPS-CLAUDE.md" 2>/dev/null | cut -d= -f2-)
+  ENG_DIR=$(resolve_engagement_dir "$ENG")
+fi
+
+# 4) Optional in-repo .fde (customer-approved only)
+if [ -z "$ENG_DIR" ] && [ -d ".fde" ]; then
+  ENG_DIR=".fde"
+fi
+
+[ -z "$ENG_DIR" ] && exit 0
+CONTEXT_FILE="$ENG_DIR/context.md"
+
+TODAY=$(date +%F)
+NOW=$(date +%H:%M)
+
+# Workspace state (only if the cwd is a git repo)
+BRANCH=$(git -C "$PWD" branch --show-current 2>/dev/null)
+LAST_COMMIT=$(git -C "$PWD" log -1 --format="%h %s" 2>/dev/null | head -c 100)
+CHANGED=$(git -C "$PWD" status --porcelain 2>/dev/null | head -8 | sed 's/^...//' | tr '\n' ' ')
+
+# Engagement artifacts updated in the last 12h (the deliverable=memory trail)
+UPDATED=$(find "$ENG_DIR" -maxdepth 1 -name "*.md" ! -name "context.md" -mmin -720 2>/dev/null \
+  | while read -r f; do basename "$f"; done | tr '\n' ' ')
+
+# Idle session (no edits, no artifact updates) → leave the memory clean.
+# LAST_COMMIT alone is not "movement": it exists in any repo with history.
+[ -z "$CHANGED" ] && [ -z "$UPDATED" ] && exit 0
+
+{
+  printf '\n<!-- fdeops auto-capture -->\n'
+  printf '## Session end - %s %s\n' "$TODAY" "$NOW"
+  [ -n "$BRANCH" ] && printf -- '- workspace: `%s` @ %s\n' "$BRANCH" "${LAST_COMMIT:-no commits yet}"
+  [ -n "$CHANGED" ] && printf -- '- uncommitted: %s\n' "$CHANGED"
+  [ -n "$UPDATED" ] && printf -- '- engagement files updated: %s\n' "$UPDATED"
+} 2>/dev/null >> "$CONTEXT_FILE" || true
+
+# Refresh the local fieldbook.html so the portfolio view is current next time
+# it's opened. Deterministic render of .fde/ - zero tokens, best-effort, never
+# allowed to break the session.
+if command -v node >/dev/null 2>&1; then
+  for FDE_CLI in \
+    "${CLAUDE_PLUGIN_ROOT:+$CLAUDE_PLUGIN_ROOT/bin/fde.js}" \
+    "$(dirname "$0")/../bin/fde.js" \
+    "$HOME/.claude/fdeops/fde.js"; do
+    if [ -n "$FDE_CLI" ] && [ -f "$FDE_CLI" ]; then
+      node "$FDE_CLI" dashboard >/dev/null 2>&1 || true
+      break
+    fi
+  done
+fi
+
+exit 0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "fdeops",
+  "version": "3.5.0",
+  "description": "Field kit for engineers embedded in client work - a real CLI (recon, memory, portfolio), one @fde skill with field judgment on top, and hooks that make it automatic. Claude Code plugin and any agent that loads skills.",
+  "bin": {
+    "fdeops": "bin/install.js",
+    "fde": "bin/fde.js"
+  },
+  "scripts": {
+    "check": "node bin/check.js",
+    "prepublishOnly": "node bin/check.js"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "hooks/",
+    "templates/",
+    "adapters/",
+    "CLAUDE.md.template",
+    "AGENTS.md"
+  ],
+  "keywords": [
+    "claude-code",
+    "claude-code-plugin",
+    "ai-agent",
+    "skills",
+    "plugin",
+    "fde",
+    "forward-deployed",
+    "forward-deployed-engineer",
+    "engineering",
+    "client-site",
+    "legacy-code",
+    "brownfield",
+    "cursor",
+    "windsurf",
+    "cline",
+    "codex",
+    "gemini-cli",
+    "copilot",
+    "agents-md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suboss87/fdeops.git"
+  },
+  "author": "Subash Natarajan <suboss87@gmail.com> (https://github.com/suboss87)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}