Neon-Desk/README.md

Fiscal Clone 3.0 (Turbopack Rebuild)

Ground-up rebuild into a single Next.js 16 application that runs with Turbopack and internal API routes.

What changed

• Removed hard runtime dependency on the external backend for core app workflows.
• Added internal app/api/* services for watchlist, portfolio, filings, tasks, and health.
• Added durable local data store at runtime (frontend/data/store.json).
• Added async task engine with retry support for:
  • sync_filings
  • refresh_prices
  • analyze_filing
  • portfolio_insights
• Added OpenClaw integration through OpenAI-compatible /v1/chat/completions.
• Enforced Turbopack for both development and production builds.

Architecture

• frontend/: full app (UI + API + task engine)
• frontend/app/api/*: route handlers
• frontend/lib/server/*: storage, task processors, SEC/pricing adapters, OpenClaw client
• frontend/data/store.json: generated local runtime state (git-ignored)

The legacy backend/ folder is retained in-repo but no longer required for the rebuilt local workflow.

Run

cd frontend
npm install
npm run dev

Open: http://localhost:3000

Build (Turbopack)

cd frontend
npm run build
npm run start

OpenClaw setup

Set in environment (for example frontend/.env.local):

OPENCLAW_BASE_URL=http://localhost:4000
OPENCLAW_API_KEY=your_key
OPENCLAW_MODEL=zeroclaw
SEC_USER_AGENT=Fiscal Clone <support@fiscal.local>

If OpenClaw is not configured, the app falls back to local analysis responses so task flows remain testable.

API surface

• GET /api/health
• GET /api/me
• GET|POST /api/watchlist
• DELETE /api/watchlist/:id
• GET|POST /api/portfolio/holdings
• PATCH|DELETE /api/portfolio/holdings/:id
• GET /api/portfolio/summary
• POST /api/portfolio/refresh-prices
• POST /api/portfolio/insights/generate
• GET /api/portfolio/insights/latest
• GET /api/filings
• POST /api/filings/sync
• POST /api/filings/:accessionNumber/analyze
• GET /api/tasks
• GET /api/tasks/:taskId