craftgo

Overview ¶

craftgo gen subcommand: design parse, semantic analysis, per-package + project-wide codegen.

craftgo init subcommand: scaffold a design folder + manifest.

Cross-subcommand CLI helpers.

Command craftgo is the CLI entrypoint that drives the design-first pipeline: locate the project manifest, parse every `.craftgo` source file, run semantic analysis, and dispatch each codegen artefact.

Usage:

craftgo init [path] [-package <module>]
craftgo gen  [-f <design-folder>] [-c|--context <project-root>] [path]

`init` scaffolds a fresh design folder at <path> (default `design`). The path argument IS the design folder - manifest + sample `.craftgo` files land flat inside it. Existing files are never overwritten so re-running on a populated directory fills only the gaps.

`gen` resolves the design folder one of two ways: with `-f` it uses the supplied path directly; without it walks upward from <path> (or cwd) looking for a craftgo.design.yaml, probing direct subdirs of any name at each level. The project root the `output:` paths resolve against is `-c <root>` when given, else cwd in the `-f` flow, else the parent of the manifest folder (legacy compat).