How micheledelaney/nuthatch works
Nuthatch is a local FileMaker XML static-analysis app, with browser, desktop-webview, and CLI entry points. The main workflow loads one or more XML exports, parses them into a solution model, resolves references and computes analysis, then presents structure, dependencies, call chains, and risks. Other documented capabilities include analysis comparison, saved analyses, and AI-oriented export. Some UI and state wiring is supported by the SOURCE INDEX rather than inspected implementation excerpts; the parser-to-worker dispatch is therefore shown as unverified.
Main entry points: App.tsx App coordinator · store.ts Application state · buildModel.ts Solution model · main.ts CLI exporter
Components 28
Input and parsing
- DDR parser
src/core/parser/parseDdr.ts - XML utilities
src/core/parser/xmlUtils.ts - Parse context
src/core/parser/context.ts - Parse worker
src/worker/parse.worker.ts - File loading
src/state/loadFiles.ts
Model and analysis
- Solution model
src/core/model/buildModel.ts - Domain model
src/types/ddr.ts - Reference analysis
src/core/analysis/dependencies.ts - Unused chains
src/core/analysis/unusedChains.ts - Usage marks
src/core/analysis/usageMarks.ts - Analysis comparison
src/core/analysis/diff.ts - Object search
src/core/search/search.ts
Exploration interface
- App coordinator
src/App.tsx - Object navigator
src/components/Navigator.tsx - Object details
src/components/ObjectColumn.tsx - Workbench
src/components/workbench/Workbench.tsx - Relationship graph
src/components/RelationshipGraphView.tsx - Risk report
src/components/ReportCardView.tsx - Comparison view
src/components/ComparisonView.tsx
State and export
- Application state
src/state/store.ts - Saved analyses
src/state/savedAnalyses.ts - AI export
src/core/export/aiExport.ts - Export actions
src/state/exportAnalysis.ts
Other entry point
- CLI exporter
src/cli/main.ts
Other components
- Analyst
- XML exports
- Browser app
- Desktop webview
Connections 33
- Analyst → Browser app: opens
- Analyst → Desktop webview: opens
- Analyst → XML exports: loads
- Browser app → App coordinator: runs
- Desktop webview → App coordinator: runs
- App coordinator → Application state: reads state
src/App.tsx - Application state → Parse worker: dispatches parse
src/state/store.ts - Parse worker → File loading: loads files
src/worker/parse.worker.ts - Parse worker → DDR parser: parses XML
src/worker/parse.worker.ts - DDR parser → Parse context: builds context
src/core/parser/parseDdr.ts - DDR parser → XML utilities: uses
src/core/parser/parseDdr.ts - Application state → Solution model: builds model
src/state/store.ts - Solution model → Reference analysis: computes references
src/core/model/buildModel.ts - Solution model → Unused chains: finds unused chains
src/core/model/buildModel.ts - Solution model → Usage marks: resolves marks
src/core/model/buildModel.ts - Solution model → Domain model: produces
src/core/model/buildModel.ts - Application state → Analysis comparison: compares analyses
src/state/store.ts - App coordinator → Object navigator: renders
src/App.tsx - App coordinator → Workbench: renders
src/App.tsx - App coordinator → Relationship graph: renders
src/App.tsx - App coordinator → Risk report: renders
src/App.tsx - App coordinator → Comparison view: renders
src/App.tsx - Object navigator → Application state: reads model
src/components/Navigator.tsx - Object navigator → Object search: uses search
src/components/Navigator.tsx - Object navigator → Object details: opens details
src/components/ObjectColumn.tsx - Application state → Saved analyses: persists analyses
src/state/store.ts - Application state → Export actions: requests export
src/state/store.ts - Export actions → AI export: generates files
src/state/exportAnalysis.ts - Analyst → CLI exporter: runs command
- CLI exporter → File loading: loads files
src/cli/main.ts - CLI exporter → DDR parser: parses exports
src/cli/main.ts - CLI exporter → Solution model: builds model
src/cli/main.ts - CLI exporter → AI export: writes export
src/cli/main.ts