AntamCircuit

CLI for BotForge's ForgeScript framework. Bun + TypeScript, zero runtime dependencies.

bun install
bun run src/main.ts --help
bun run build        # single executable -> dist/antamcircuit

Command	What it does
antamcircuit init [dir]	Scaffold a bot project
antamcircuit check [paths]	Validate .forge/.fs files and code: strings in .js/.ts against function metadata
antamcircuit docs <$fn | text>	Show a function's signature or search functions
antamcircuit metadata sync|info|clear	Manage the metadata cache (~/.antamcircuit, override with ANTAMCIRCUIT_HOME)

Metadata comes from metadata/functions.json of ForgeScript, ForgeDB and ForgeCanvas (the same files ForgeLSP uses). Optional forge.config.json: include, exclude, sources, branch.

Layout

src/
  main.ts          entry
  config.ts        forge.config.json
  cli/             router, help, flag parsing, output
  commands/        one file per command
  metadata/        sources, cache, function index
  parser/          scanner (code -> call tree), diagnostics (rules), regions (file -> code)
  templates/       files written by `init`

Checks: unknown function, missing/unexpected/unclosed brackets, too few/many arguments, empty required argument, invalid enum value, deprecated/experimental.