Skip to content

Commit 0ae9a54

Browse files
rootclaude
andcommitted
docs: comprehensive README update + CHANGELOG
Add missing documentation for: Vue SFC parser, --json agent output, --agents flag on diff/watch, programmatic API, license system, Drizzle parser details, schema provider table, AI context generator output details, relative paths change, and agent thresholds config. Create CHANGELOG.md with full release history (v0.1.0 → v0.3.0). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 5b5cf1f commit 0ae9a54

2 files changed

Lines changed: 308 additions & 50 deletions

File tree

CHANGELOG.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Changelog
2+
3+
All notable changes to Fondamenta ArchCode are documented here.
4+
5+
## [0.3.0] - 2026-02-24
6+
7+
### Added
8+
- **Code health agents system** — 8 agents (3 free, 5 PRO) for automated codebase analysis
9+
- Free: `dead-code`, `circular-deps`, `architecture-guard`
10+
- PRO: `security-scanner`, `schema-drift`, `performance-sentinel`, `convention-enforcer`, `impact-analyzer`
11+
- **`fondamenta agents` command** with `--free`, `--agent <id>`, `--ci`, `--report`, `--list`, `--json` flags
12+
- **JSON output** (`--json`) for CI/CD pipeline integration
13+
- **Configurable agent thresholds** (`maxLineCount`, `maxDependencies`, `maxPageImports`, `maxApiCallsPerPage`)
14+
- **PRO licensing system** — offline HMAC-based license validation
15+
- **AGENTS-REPORT.md** generation with `--report` flag
16+
- **`--agents` flag** for `diff` and `watch` commands to include agent findings
17+
- **Drizzle ORM support** — parser using TypeScript Compiler API for `pgTable()`, `mysqlTable()`, `sqliteTable()`, enums, and relations
18+
- **Nuxt 3 partial support** — pages, composables, server/api routes, auto-imports
19+
- **Vue SFC parser** — extracts `<script setup>`, composable usage, `ref()`/`reactive()` state, API calls, template component references
20+
- **Next.js Pages Router partial support** — detection, `getServerSideProps`/`getStaticProps` data fetching, API handlers
21+
- **GitHub Action** — reusable CI action (`talionwar/fondamenta-archcode@main`)
22+
- **Test suite** — 111 tests across 16 files (14 unit + 2 integration suites)
23+
- **Demo project** — pre-generated `.planning/` output showcasing all features
24+
25+
### Changed
26+
- Graph nodes now store **relative paths** instead of absolute paths for portability across environments
27+
- Reduced agent false positives: skip Next.js convention files (`layout.tsx`, `loading.tsx`, `error.tsx`, `not-found.tsx`, etc.) and Nuxt auto-import directories
28+
- Package renamed to `fondamenta-archcode` on npm
29+
30+
## [0.2.0] - 2026-02-24
31+
32+
### Added
33+
- **`fondamenta diff`** — show added, modified, removed files since last analysis
34+
- `--ci` flag exits with code 1 if analysis is outdated
35+
- **`fondamenta watch`** — file watcher with debounce, regenerates on `.ts`/`.tsx` changes
36+
- **`fondamenta ai-context`** — generate context files for AI tools
37+
- `--claude``CLAUDE.md` (project structure, key routes, DB models, fragile zones)
38+
- `--cursor``.cursorrules` (framework info, conventions, auth patterns)
39+
- `--copilot``.github/copilot-instructions.md` (project map, model listing)
40+
- `--all` → all of the above
41+
- **State tracking**`.planning/.state.json` with MD5 file hashes for incremental diff
42+
- **Automation docs** — cron, git pre-commit hook examples
43+
44+
## [0.1.0] - 2026-02-24
45+
46+
### Added
47+
- **`fondamenta analyze`** — full codebase analysis generating 7 structured Markdown files
48+
- **7 atomic generators:**
49+
- `pages-atomic.md` — every page with imports, auth, data fetching, components, i18n
50+
- `components-atomic.md` — every component with props, state, hooks, API calls, used-by tracking
51+
- `api-routes-atomic.md` — every API route with methods, auth, models, side effects
52+
- `lib-atomic.md` — every utility with exports, imports, env vars, used-by
53+
- `schema-crossref-atomic.md` — all DB models, fields, constraints, relations, enums
54+
- `component-graph.md` — visual text-based dependency tree
55+
- `DEPENDENCY-MAP.md` — architecture overview, impact areas, test checklists
56+
- **`fondamenta init`** — interactive config file generation
57+
- **Framework auto-detection** with confidence scoring (Next.js App/Pages Router, Nuxt 3, SvelteKit, Remix)
58+
- **Prisma schema parser** — models, fields, constraints, relations, enums
59+
- **TypeScript Compiler API** for AST parsing (not regex)
60+
- **Programmatic API** — full library export for use in custom tools
61+
- **`defineConfig()`** helper for typed configuration

0 commit comments

Comments
 (0)