Skip to content

Add isketch scan: a first architecture diagram of a repository - #89

Merged
raj-khan merged 1 commit into
mainfrom
fl-86-scan
Sep 27, 2026
Merged

raj-khan merged 1 commit into
mainfrom
fl-86-scan

Conversation

@raj-khan

Copy link
Copy Markdown
Owner

FL-86.

isketch scan [folder] [-o out.flow] gives an agent a first draft instead of a blank page.

  • What it reads (pickSources): compose files by name; OpenAPI specs and Drizzle schemas by looking inside YAML, JSON and TypeScript; Prisma schemas; and all SQL files together, in name order, since migrations build on each other. Dependencies, build output, tests and fixtures are skipped; the real CLI never walks into ignored folders.
  • How it combines them (combineSources): each source is imported by the same readers as the Import dialog, laid out on its own, and framed side by side, the frame named after the file. Ids are renamed (prefixed with the source) only when two sources share one.
  • Skipped items print per file, as isketch import does.

On this repository: Scanned . (docker-compose.yml; server/migrations/001_diagrams.sql): 5 shapes in 2 frames in 0.25s.

Tests: scan.spec.js over a fixture repository (src/tests/fixtures/repo.js), and CLI scan end to end with a fake file system. vitest 300, e2e 140, lint and typecheck.

Compose files, SQL migrations, Prisma, OpenAPI and Drizzle schemas are
imported, laid out and framed side by side in one .flow file.
@raj-khan
raj-khan merged commit 793508a into main Sep 27, 2026
4 checks passed
@raj-khan
raj-khan deleted the fl-86-scan branch September 27, 2026 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant