@machineblocks/cli 0.1.0 → 0.1.2

package/blocks/com/machineblocks/bml/cli/Library.bml

@@ -14,7 +14,7 @@
     The MachineBlocks host CLI library catalog
   </is>
   <version>
-    0.1.0
+    0.1.2
   </version>
   <documentation>
     Publishable host-CLI library (com.machineblocks.bml.cli.Library).

package/blocks/com/machineblocks/bml/cli/README.bml

@@ -27,5 +27,6 @@
     <see type="clidoc:Introduction" relation="ReadFirst" />
     <see type="clidoc:DualCliModel" relation="SeeAlso" />
     <see type="clidoc:Commands" relation="SeeAlso" />
+    <see type="clidoc:Help" relation="SeeAlso" />
   </references>
 </mbcli:README>

package/blocks/com/machineblocks/bml/cli/documentation/Commands.bml

@@ -8,81 +8,30 @@
     core:Documentation
   </baseType>
   <is>
-    User-facing commands for rendering BML to SCAD
+    Command inventory
   </is>
-  <documentation><![CDATA[
-    The host exposes a short command set. validate matches blockml validate.
-    compile takes a BlockML type selector, not a file path and not --out.
+  <documentation>
+    <![CDATA[
+    Host commands:
+    • validate — parser + semantic check; no SCAD target; no output files
+    • compile — render machineblocks-v3-scad for one type selector; writes under srcDir
+    • init — scaffold a BlockML project and record the MachineBlocks profile
 
-    machineblocks validate [file]
-    - Same project validate as blockml validate.
-    - Exit 0 success, 1 diagnostics, 2 config or usage.
-    - Does not register the SCAD target and does not write SCAD.
-    - A file argument validates that file. --all validates the reachable corpus.
-      file and --all together exit 2.
-
-    machineblocks compile <source-selector>
-    - Compiles with target machineblocks-v3-scad.
-    - The selector is one BlockML type selector: an exact block FQN, a package
-      selector ending in .*, or a recursive selector ending in .**.
-      Resolution is scanTypes from the BlockML framework. This host does not
-      define a second selector language.
-    - --source-package <FQN> is the source package root for an explicit mapping.
-    - --target-package <FQN> is the target package root. It is not a directory
-      and not the FQN of one output file.
-    - --help shows this command.
-    - There is no --out and no --all. The output root is the configured srcDir
-      (default blocks).
-    - A selector only chooses blocks. It does not by itself choose the target
-      package, except that a package selector (a final .* or .** segment)
-      supplies the source root when --target-package is set and
-      --source-package is omitted. An exact block FQN does not supply a source
-      root.
-    - --source-package without --target-package exits 2 with
-      MB_SOURCE_PACKAGE_ALONE.
-    - --target-package without a derivable source root exits 2 with
-      MB_SOURCE_PACKAGE_REQUIRED.
-    - A missing selector, an unknown flag, or a selector scanTypes rejects
-      exits 2.
-    - Types whose baseType chain is neither com.machineblocks.bml.core.Block
-      nor com.machineblocks.bml.core.Set are skipped. If none remain, the host
-      exits 1 with MB_SELECTOR_EMPTY and the selector text.
-    - Mapping failures, collisions, and paths that leave srcDir or would
-      overwrite a .bml file exit 1. No output file is written unless every
-      selected block has a target FQN and a legal path, and every compile
-      succeeded.
-    - Exit 0 writes the SCAD or preset JSON files and a sibling .map when the
-      target attached a source map.
-
-    Host diagnostic codes:
-
-    - MB_SOURCE_PACKAGE_ALONE — --source-package without --target-package.
-    - MB_SOURCE_PACKAGE_REQUIRED — --target-package and the source root is not
-      determined. The message names --source-package.
-    - MB_SELECTOR_EMPTY — the selector matched no Block or Set.
-    - MB_TARGET_COLLISION — two selected blocks share a target FQN or output path.
-    - MB_OUTPUT_ESCAPES_SRC — a resolved path is outside srcDir.
-    - MB_OUTPUT_OVERWRITES_BML — a resolved path is an existing .bml file.
-
-    Mapping codes MB_TARGET_PACKAGE_UNDETERMINED, MB_TARGET_PACKAGE_AMBIGUOUS,
-    and MB_SOURCE_OUTSIDE_ROOT are defined with the manifestation rules.
-
-    machineblocks --help
-    - Lists these commands.
-    - Points advanced users to blockml --help for search, inspect, graph,
-      transform, new, and init.
-
-    Not in this host surface (still available via blockml if that package
-    is installed): watch, search, inspect, graph, transform, scaffolding, xsd
-    toggle, thumbnail generation.
+    Not on this host (use blockml when that package is installed): watch, search,
+    scan, inspect, graph, transform, new, agents-md, xsd toggle, thumbnail generation.
 
     Per-target matrix entry this host satisfies:
 
         machineblocks-v3-scad — document target; selected by type selector;
         written under srcDir; registered by @machineblocks/cli, not by @blockml/cli.
 
-  ]]></documentation>
+    Printed operator help: clidoc:Help (root) and each command documentation Printed help section.
+    ]]>
+  </documentation>
   <references>
-    <see type="clidoc:Configuration" relation="ReadNext" />
+    <see type="clidoc:Help" relation="ReadNext" />
+    <see type="clidoc:ValidateCommand" relation="SeeAlso" />
+    <see type="clidoc:CompileCommand" relation="SeeAlso" />
+    <see type="clidoc:InitCommand" relation="SeeAlso" />
   </references>
 </clidoc:Commands>

package/blocks/com/machineblocks/bml/cli/documentation/CompileCommand.bml

@@ -0,0 +1,126 @@
+<!--CLI Documentation — CompileCommand
+  FQN: com.machineblocks.bml.cli.documentation.CompileCommand-->
+<clidoc:CompileCommand xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation"
+  xmlns:rdoc="com.machineblocks.bml.target.render.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    machineblocks compile specification
+  </is>
+  <documentation>
+    <![CDATA[
+    Syntax:
+        machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+
+        Compiles with target machineblocks-v3-scad. The command does not take a
+        target name.
+        The selector is one BlockML type selector: an exact block FQN, a package
+        selector ending in .*, or a recursive selector ending in .**.
+        Resolution is scanTypes from the BlockML framework. This host does not
+        define a second selector language.
+        Quote tokens that contain * or ** so the shell does not expand them.
+        --source-package <FQN> is the source package root for an explicit mapping.
+        --target-package <FQN> is the target package root. It is not a directory
+        and not the FQN of one output file.
+        There is no --out and no --all. The output root is the configured srcDir
+        (default blocks).
+        A selector only chooses blocks. It does not by itself choose the target
+        package, except that a package selector (a final .* or .** segment)
+        supplies the source root when --target-package is set and
+        --source-package is omitted. An exact block FQN does not supply a source
+        root.
+        --source-package without --target-package exits 2 with
+        MB_SOURCE_PACKAGE_ALONE.
+        --target-package without a derivable source root exits 2 with
+        MB_SOURCE_PACKAGE_REQUIRED. The message names --source-package.
+        A missing selector, an unknown flag, or a selector scanTypes rejects
+        exits 2.
+        Types whose baseType chain is neither com.machineblocks.bml.core.Block
+        nor com.machineblocks.bml.core.Set are skipped. If none remain, the host
+        exits 1 with MB_SELECTOR_EMPTY and the selector text.
+        Mapping failures, collisions, and paths that leave srcDir or would
+        overwrite a .bml file exit 1. No output file is written unless every
+        selected block has a target FQN and a legal path, and every compile
+        succeeded.
+        Exit 0 writes the SCAD or preset JSON files and a sibling .map when the
+        target attached a source map, then prints Wrote N file(s) to <srcDir>.
+        N counts every written file, including a sibling .map.
+
+        Automatic mapping replaces the one bml segment with scad. An explicit
+        mapping swaps sourcePackage for targetPackage and does not apply that
+        replacement on top. The path rules and the codes
+        MB_TARGET_PACKAGE_UNDETERMINED, MB_TARGET_PACKAGE_AMBIGUOUS, and
+        MB_SOURCE_OUTSIDE_ROOT are specified by rdoc:FqnNaming.
+
+        Host diagnostic codes:
+
+        - MB_SOURCE_PACKAGE_ALONE — --source-package without --target-package.
+        - MB_SOURCE_PACKAGE_REQUIRED — --target-package and the source root is not
+          determined. The message names --source-package.
+        - MB_SELECTOR_EMPTY — the selector matched no Block or Set.
+        - MB_TARGET_COLLISION — two selected blocks share a target FQN or output path.
+        - MB_OUTPUT_ESCAPES_SRC — a resolved path is outside srcDir.
+        - MB_OUTPUT_OVERWRITES_BML — a resolved path is an existing .bml file.
+        - MB_EMPTY_BLOCK — a composite has nothing to render.
+
+        blockml.config.json srcDir is the output root. mbLibPath defaults to the
+        installed @machineblocks/core package. openscadPath is unused by compile.
+        A missing mbLibPath and a missing @machineblocks/core install exit 2.
+
+    Printed help:
+    Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+           machineblocks compile --help
+
+    When: render selected Block and Set types to OpenSCAD. Change BML first, then recompile.
+
+    Target is machineblocks-v3-scad. The command does not take a target name.
+    The selector is one BlockML type selector: an exact FQN, pkg.*, or pkg.**.
+    Quote tokens that contain * or ** so the shell does not expand them.
+    Resolution is scanTypes. This host does not define a second selector language.
+    Types whose baseType chain is neither com.machineblocks.bml.core.Block nor
+    com.machineblocks.bml.core.Set are skipped.
+
+    Output is written under the configured srcDir (default blocks). There is no --out and no --all.
+    A package selector (a final .* or .** segment) supplies the source root when
+    --target-package is set and --source-package is omitted. An exact block FQN does not.
+    Automatic mapping replaces the one bml segment with scad.
+    com.example.bml.bricks.MyBrick becomes blocks/com/example/scad/bricks/MyBrick.scad.
+    Explicit mapping swaps --source-package for --target-package and does not apply that replacement again.
+
+    Flags:
+      --source-package <FQN>   source package root for an explicit mapping
+      --target-package <FQN>   target package root. Not a directory and not one output file.
+
+    --source-package without --target-package exits 2 (MB_SOURCE_PACKAGE_ALONE).
+    --target-package without a derivable source root exits 2 (MB_SOURCE_PACKAGE_REQUIRED).
+    A missing selector, an unknown flag, or a selector scanTypes rejects exits 2.
+    If no Block or Set remains, exit 1 (MB_SELECTOR_EMPTY) and the message names the selector.
+
+    Exit 0 writes the SCAD or preset JSON files and a sibling .map when the target attached a source map.
+    The status line is Wrote N file(s) to <srcDir>. N counts every written file, including a sibling .map.
+    One failure writes nothing. Mapping failures, collisions, and illegal paths exit 1:
+      MB_TARGET_COLLISION — two selected blocks share a target FQN or output path.
+      MB_OUTPUT_ESCAPES_SRC — a resolved path is outside srcDir.
+      MB_OUTPUT_OVERWRITES_BML — a resolved path is an existing .bml file.
+      MB_TARGET_PACKAGE_UNDETERMINED — the source FQN has no bml segment.
+      MB_TARGET_PACKAGE_AMBIGUOUS — the source FQN has more than one bml segment.
+      MB_SOURCE_OUTSIDE_ROOT — a selected block is outside --source-package.
+      MB_EMPTY_BLOCK — a composite has nothing to render.
+
+    blockml.config.json srcDir is the output root. mbLibPath defaults to the installed
+    @machineblocks/core package. openscadPath is unused by compile.
+    A missing mbLibPath and a missing @machineblocks/core install exit 2.
+
+    Related: validate. Search, inspect, graph, and new stay on blockml.
+    ]]>
+  </documentation>
+  <references>
+    <see type="clidoc:InitCommand" relation="ReadNext" />
+    <see type="clidoc:ValidateCommand" relation="SeeAlso" />
+    <see type="rdoc:FqnNaming" relation="SeeAlso" />
+  </references>
+</clidoc:CompileCommand>

package/blocks/com/machineblocks/bml/cli/documentation/DualCliModel.bml

@@ -27,6 +27,11 @@
       BlockRenderEngine.
     - Same validate and compile facade underneath. Defaults differ.
     - Does not reimplement parse, validate, or emit.
+    - init calls initProject from @blockml/cli, then adds devDependency
+      @machineblocks/cli and library dependency com.machineblocks.bml.Library.
+      --install then runs npm install and GenerateAgentsMd in that order:
+      profile first, then the same install and AGENTS.md step as initProject.
+      The universal init stays domain-agnostic.
 
     Interop: a later plugin load (targetPackages in blockml.config.json mapping
     machineblocks-v3-scad to @machineblocks/render-target) may let the universal

package/blocks/com/machineblocks/bml/cli/documentation/Help.bml

@@ -0,0 +1,49 @@
+<!--CLI Documentation — Help
+  FQN: com.machineblocks.bml.cli.documentation.Help-->
+<clidoc:Help xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Printed root help page for machineblocks --help
+  </is>
+  <documentation>
+    <![CDATA[
+    Usage: machineblocks <command> [options]
+           machineblocks --help
+
+    machineblocks is the MachineBlocks host CLI.
+
+    It renders BML to OpenSCAD that matches the V3 SCAD library.
+    BML is the editable source of truth. Change BML first, then compile.
+    This host registers target machineblocks-v3-scad. It does not reimplement parse, validate, or emit.
+
+    Invocation: npx machineblocks <command>
+    Requires Node.js 20 or newer.
+    A new project starts with npx @machineblocks/cli init <package-fqn>.
+
+    Commands:
+      validate    Parser + semantic check. Same project check as blockml validate.
+                  Does not write SCAD.
+                  machineblocks validate [--all] [<file>]
+      compile     Render selected Block and Set types to SCAD under srcDir.
+                  machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+      init        Scaffold a BlockML project and record the MachineBlocks profile.
+                  machineblocks init <package-fqn> [--src dir] [--install]
+
+    Search, scan, inspect, graph, new, agents-md, and transform stay on blockml.
+    Exit codes: 0 success, 1 diagnostic errors, 2 usage or configuration error.
+
+    Run `machineblocks <command> --help` for flags, defaults, output, and constraints.
+    ]]>
+  </documentation>
+  <references>
+    <see type="clidoc:Commands" relation="SeeAlso" />
+    <see type="clidoc:ValidateCommand" relation="SeeAlso" />
+    <see type="clidoc:CompileCommand" relation="SeeAlso" />
+    <see type="clidoc:InitCommand" relation="SeeAlso" />
+  </references>
+</clidoc:Help>

package/blocks/com/machineblocks/bml/cli/documentation/InitCommand.bml

@@ -0,0 +1,92 @@
+<!--CLI Documentation — InitCommand
+  FQN: com.machineblocks.bml.cli.documentation.InitCommand-->
+<clidoc:InitCommand xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    machineblocks init specification
+  </is>
+  <documentation>
+    <![CDATA[
+    Syntax:
+        machineblocks init <package-fqn> [--src dir] [--install]
+
+        Scaffolds a BlockML project by calling initProject from @blockml/cli
+        with install false, then records the MachineBlocks profile. It does not
+        spawn blockml init. The profile is recorded before npm install so the
+        installed corpus is the project this command just wrote.
+        PACKAGE-FQN is a dotted package identifier, not ….Library. A bml segment
+        after the domain is recommended. Compile maps a bml segment to scad.
+        --src changes the source directory (default blocks).
+        --install runs npm install after the profile is recorded, then generates
+        AGENTS.md when the file is missing, by the same step as initProject.
+        At least one section or rule writes AGENTS.md. No AgentInstructions
+        content leaves the file unwritten and prints
+        "No AgentInstructions blocks found."; the init exit code stays 0.
+        An existing AGENTS.md is left in place. The next-step line from the
+        earlier initProject pass is dropped, because install already ran.
+        Without --install, the only AGENTS.md pass is the one inside initProject,
+        before dependencies are installed. The file is written when those
+        packages already resolve. Otherwise initProject's next line remains:
+        npm install && npx blockml agents-md generate.
+        CLAUDE.md (@AGENTS.md) is written by initProject when missing.
+        The profile adds @machineblocks/cli to devDependencies when that package
+        is absent from dependencies and devDependencies. The range is the caret
+        range of this host. An existing dependencies entry stays put.
+        The project Library.bml gains a dependencies composition child
+        com.machineblocks.bml.Library. An existing child is left in place.
+        Existing files are not replaced.
+        A package FQN without a bml segment still exits 0 and warns:
+        Package FQN has no bml segment. Compile maps a bml segment to scad.
+        Exit codes match initProject: 0 success, 1 write or install failure,
+        2 usage or an invalid package FQN.
+
+    Printed help:
+    Usage: machineblocks init <package-fqn> [--src dir] [--install]
+           machineblocks init --help
+
+    When: turn a directory into a MachineBlocks project. Scaffolds a BlockML project,
+    then records the MachineBlocks profile.
+
+    PACKAGE-FQN is a dotted package identifier (not …Library). A bml segment after
+    the domain is recommended. Compile maps a bml segment to scad.
+    A package FQN without a bml segment still exits 0 and warns.
+    Does not overwrite existing files.
+    Does not spawn blockml init. Calls initProject from @blockml/cli with install
+    false, then records the profile before npm install.
+
+    The profile adds @machineblocks/cli to devDependencies when that package is
+    absent from dependencies and devDependencies. The range is the caret range of
+    this host. An existing dependencies entry stays put.
+    The project Library.bml gains com.machineblocks.bml.Library.
+    CLAUDE.md (@AGENTS.md) is written when missing.
+
+    Flags:
+      --src dir     source directory (default blocks)
+      --install     run npm install after the profile is recorded, then generate
+                    AGENTS.md the same way as blockml init
+
+    Without --install, AGENTS.md is generated only inside initProject, before
+    dependencies are installed. The file is written when AgentInstructions already
+    resolve. Otherwise the next step remains: npm install && npx blockml agents-md generate.
+    With --install, an existing AGENTS.md is left in place. When the file is missing,
+    generation runs after npm install. Sections or rules write AGENTS.md.
+    No AgentInstructions content leaves the file unwritten and prints
+    No AgentInstructions blocks found. The init exit code stays 0.
+    The next-step line from the earlier initProject pass is dropped, because install already ran.
+
+    Exit codes match initProject: 0 success, 1 write or install failure,
+    2 usage or an invalid package FQN.
+
+    Related: validate, compile. agents-md and new stay on blockml.
+    ]]>
+  </documentation>
+  <references>
+    <see type="clidoc:Configuration" relation="ReadNext" />
+    <see type="clidoc:Commands" relation="SeeAlso" />
+  </references>
+</clidoc:InitCommand>

package/blocks/com/machineblocks/bml/cli/documentation/Installation.bml

@@ -13,13 +13,24 @@
   <documentation>
     Consumer project (the usual path):
 
-        npm install @machineblocks/cli
+        npx @machineblocks/cli init com.example.bml
         npx machineblocks validate
         npx machineblocks compile com.example.bml.bricks.MyBrick
 
+    init calls the universal project scaffold, then records @machineblocks/cli
+    as a devDependency and adds com.machineblocks.bml.Library to the project
+    library. Pass --install to run npm install after that profile is recorded
+    and then generate AGENTS.md the same way blockml init does. Without
+    --install, AGENTS.md is generated only when AgentInstructions already
+    resolve; otherwise the next step is npm install and
+    npx blockml agents-md generate. On a project that blockml init
+    already created, the same command adds only the missing profile and does
+    not replace existing files.
+
     That install brings @machineblocks/render-target, @blockml/block-render-engine,
-    @machineblocks/core, and the BlockML compiler packages. The user does not
-    install @blockml/cli unless they also want the universal command.
+    @machineblocks/core, and the BlockML compiler packages. init also records
+    @blockml/core and @blockml/cli. A bml segment in the package FQN lets
+    compile map the output package to scad.
 
     From this monorepo while the bin is not published:
 

package/blocks/com/machineblocks/bml/cli/documentation/ValidateCommand.bml

@@ -0,0 +1,59 @@
+<!--CLI Documentation — ValidateCommand
+  FQN: com.machineblocks.bml.cli.documentation.ValidateCommand-->
+<clidoc:ValidateCommand xmlns="http://blockml.org/bml"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:clidoc="com.machineblocks.bml.cli.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    machineblocks validate specification
+  </is>
+  <documentation>
+    <![CDATA[
+    Syntax:
+        machineblocks validate [file] [--all]
+
+        Same project validate as blockml validate.
+        Does not register machineblocks-v3-scad and does not write SCAD.
+        A file argument parses that file and runs compileBmlToBom against the
+        full project registry.
+        Default (no file, no --all): semantic-validate project sources only
+        (this package srcDir plus local packages/*). npm libraries stay on the
+        registry for resolve.
+        --all semantic-validates every document in the registry, including npm.
+        file and --all together exit 2.
+        Exit 0 success, 1 diagnostics, 2 config or usage.
+        After diagnostics: Validated N block(s). or Validated N block(s) with errors.
+        This host does not accept --src, --libraries, or --verbose. Those flags
+        belong to blockml validate.
+
+    Printed help:
+    Usage: machineblocks validate [--all] [<file>]
+           machineblocks validate --help
+
+    When: check the model after edits. Ordinary project work.
+
+    Default (no file, no --all): semantic-validate project sources only (this package srcDir plus local packages/*). npm libraries stay on the registry for resolve.
+    --all: semantic-validate every document in the registry, including npm. Do not use --all as the default after every edit.
+    Single file: parse + compileBmlToBom against the full project registry.
+    file and --all together exit 2.
+
+    Does not register machineblocks-v3-scad. No output files written.
+    This host does not accept --src, --libraries, or --verbose.
+
+    Flags:
+      --all         entire reachable corpus, including npm
+
+    Exit 0 on success; 1 on diagnostic errors; 2 on config or usage errors.
+    After diagnostics: Validated N block(s). or Validated N block(s) with errors.
+
+    Related: compile. Search, scan, inspect, and graph stay on blockml.
+    ]]>
+  </documentation>
+  <references>
+    <see type="clidoc:CompileCommand" relation="ReadNext" />
+    <see type="clidoc:Help" relation="SeeAlso" />
+  </references>
+</clidoc:ValidateCommand>

package/dist/args.d.ts

@@ -1,3 +1,4 @@
+export type HelpTopic = "validate" | "compile" | "init";
 export interface ValidateArgs {
     command: "validate";
     file?: string;
@@ -9,11 +10,19 @@ export interface CompileArgs {
     sourcePackage?: string;
     targetPackage?: string;
 }
+export interface InitArgs {
+    command: "init";
+    packageFqn: string;
+    srcDir?: string;
+    install: boolean;
+}
 export type HostCommand = {
     command: "help";
-} | ValidateArgs | CompileArgs | {
+    topic?: HelpTopic;
+} | ValidateArgs | CompileArgs | InitArgs | {
     command: "usage";
     message: string;
+    topic?: HelpTopic;
 };
 export declare function parseArgs(argv: readonly string[]): HostCommand;
 /** A final .* or .** segment denotes a package. An exact type FQN does not. */

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB,YAAY,GACZ,WAAW,GACX;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAY9D;AAyED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACtC,YAAY,GACZ,WAAW,GACX,QAAQ,GACR;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAe9D;AAoHD,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E"}

package/dist/args.js

@@ -1,4 +1,3 @@
-import { COMPILE_HELP } from "./help.js";
 export function parseArgs(argv) {
     if (argv.length === 0 || argv[0] === "--help" || argv[0] === "help") {
         return { command: "help" };
@@ -10,35 +9,38 @@ export function parseArgs(argv) {
     if (command === "compile") {
         return parseCompile(rest);
     }
+    if (command === "init") {
+        return parseInit(rest);
+    }
     return { command: "usage", message: `Unknown command: ${command ?? ""}` };
 }
 function parseValidate(args) {
+    if (args.includes("--help")) {
+        return { command: "help", topic: "validate" };
+    }
     let file;
     let all = false;
     for (const arg of args) {
-        if (arg === "--help") {
-            return { command: "help" };
-        }
         if (arg === "--all") {
             all = true;
             continue;
         }
         if (arg.startsWith("--")) {
-            return { command: "usage", message: `Unknown option: ${arg}` };
+            return { command: "usage", message: `Unknown option: ${arg}`, topic: "validate" };
         }
         if (file !== undefined) {
-            return { command: "usage", message: "validate accepts one file." };
+            return { command: "usage", message: "validate accepts one file.", topic: "validate" };
         }
         file = arg;
     }
     if (file !== undefined && all) {
-        return { command: "usage", message: "Specify either <file> or --all, not both." };
+        return { command: "usage", message: "Specify either <file> or --all, not both.", topic: "validate" };
     }
     return file === undefined ? { command: "validate", all } : { command: "validate", all, file };
 }
 function parseCompile(args) {
     if (args.includes("--help")) {
-        return { command: "help" };
+        return { command: "help", topic: "compile" };
     }
     let selector;
     let sourcePackage;
@@ -51,7 +53,7 @@ function parseCompile(args) {
         if (arg === "--source-package" || arg === "--target-package") {
             const value = args[index + 1];
             if (value === undefined || value.startsWith("--")) {
-                return { command: "usage", message: `${arg} requires a package FQN.` };
+                return { command: "usage", message: `${arg} requires a package FQN.`, topic: "compile" };
             }
             if (arg === "--source-package") {
                 sourcePackage = value;
@@ -63,15 +65,15 @@ function parseCompile(args) {
             continue;
         }
         if (arg.startsWith("--")) {
-            return { command: "usage", message: `Unknown option: ${arg}` };
+            return { command: "usage", message: `Unknown option: ${arg}`, topic: "compile" };
         }
         if (selector !== undefined) {
-            return { command: "usage", message: "compile accepts one source selector." };
+            return { command: "usage", message: "compile accepts one source selector.", topic: "compile" };
         }
         selector = arg;
     }
     if (selector === undefined) {
-        return { command: "usage", message: `compile requires a source selector.\n\n${COMPILE_HELP}` };
+        return { command: "usage", message: "compile requires a source selector.", topic: "compile" };
     }
     const parsed = { command: "compile", selector };
     if (sourcePackage !== undefined) {
@@ -82,6 +84,48 @@ function parseCompile(args) {
     }
     return parsed;
 }
+function parseInit(args) {
+    if (args.includes("--help")) {
+        return { command: "help", topic: "init" };
+    }
+    let packageFqn;
+    let srcDir;
+    let install = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === "--install") {
+            install = true;
+            continue;
+        }
+        if (arg === "--src") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { command: "usage", message: "--src requires a directory.", topic: "init" };
+            }
+            srcDir = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            return { command: "usage", message: `Unknown option: ${arg}`, topic: "init" };
+        }
+        if (packageFqn !== undefined) {
+            return { command: "usage", message: "init accepts one package FQN.", topic: "init" };
+        }
+        packageFqn = arg;
+    }
+    if (packageFqn === undefined) {
+        return { command: "usage", message: "init requires a package FQN.", topic: "init" };
+    }
+    const parsed = { command: "init", packageFqn, install };
+    if (srcDir !== undefined) {
+        parsed.srcDir = srcDir;
+    }
+    return parsed;
+}
 /** A final .* or .** segment denotes a package. An exact type FQN does not. */
 export function sourcePackageFromSelector(selector) {
     const parts = selector.split(".");

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAqBzC,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,aAAa,CAAC,IAAuB;IAC5C,IAAI,IAAwB,CAAC;IAC7B,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,GAAG,GAAG,IAAI,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,EAAE,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;QACrE,CAAC;QACD,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAChG,CAAC;AAED,SAAS,YAAY,CAAC,IAAuB;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,QAA4B,CAAC;IACjC,IAAI,aAAiC,CAAC;IACtC,IAAI,aAAiC,CAAC;IACtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,kBAAkB,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,0BAA0B,EAAE,CAAC;YACzE,CAAC;YACD,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;gBAC/B,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,EAAE,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;QAC/E,CAAC;QACD,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,0CAA0C,YAAY,EAAE,EAAE,CAAC;IACjG,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC7D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAInE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAY5E"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKnE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAe5E"}

package/dist/execute.js

@@ -1,18 +1,22 @@
 import { parseArgs } from "./args.js";
 import { runCompile } from "./compile-command.js";
-import { HELP } from "./help.js";
+import { helpFor, usageFor } from "./help.js";
+import { runInit } from "./init-command.js";
 import { runValidate } from "./validate-command.js";
 export function execute(argv, rootDir) {
     const parsed = parseArgs(argv);
     if (parsed.command === "help") {
-        return { code: 0, lines: [HELP] };
+        return { code: 0, lines: [helpFor(parsed.topic)] };
     }
     if (parsed.command === "usage") {
-        return { code: 2, lines: [parsed.message, "", HELP] };
+        return { code: 2, lines: [parsed.message, "", usageFor(parsed.topic)] };
     }
     if (parsed.command === "validate") {
         return runValidate(parsed, rootDir);
     }
+    if (parsed.command === "init") {
+        return runInit(parsed, rootDir);
+    }
     return runCompile(parsed, rootDir);
 }
 //# sourceMappingURL=execute.js.map

package/dist/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,OAAe;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,OAAe;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/help.d.ts

@@ -1,3 +1,17 @@
-export declare const HELP = "Usage: machineblocks validate [file] [--all]\n       machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks --help\n\nvalidate\n  Same project check as blockml validate. Does not write SCAD.\n\ncompile\n  Renders selected Block and Set types to SCAD with machineblocks-v3-scad.\n  The selector is a BlockML type selector: an exact FQN, pkg.*, or pkg.**.\n  Output is written under the configured srcDir (default blocks).\n  --target-package names a package root, not a directory.\n  A package selector supplies the source root when --source-package is omitted.\n  An exact block FQN does not.\n\nExit 0 success, 1 diagnostics, 2 usage or config.\nSearch, inspect, graph, and the other toolchain commands stay on blockml.\n";
-export declare const COMPILE_HELP = "Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks compile --help\n\n<source-selector>  Block FQN, or a package selector ending in .* or .**\n--source-package   Source package root for an explicit mapping\n--target-package   Target package root. Not a directory and not one output file.\n";
+import type { HelpTopic } from "./args.js";
+/** Short syntax printed on usage errors. Not the --help page. */
+export declare const USAGE = "Usage: machineblocks validate [--all] [<file>]\n       machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks init <package-fqn> [--src dir] [--install]\n       machineblocks --help";
+export declare const VALIDATE_USAGE = "Usage: machineblocks validate [--all] [<file>]\n       machineblocks validate --help";
+export declare const COMPILE_USAGE = "Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks compile --help";
+export declare const INIT_USAGE = "Usage: machineblocks init <package-fqn> [--src dir] [--install]\n       machineblocks init --help";
+/** Root help page. SSOT: com.machineblocks.bml.cli.documentation.Help */
+export declare const HELP = "Usage: machineblocks <command> [options]\n       machineblocks --help\n\nmachineblocks is the MachineBlocks host CLI.\n\nIt renders BML to OpenSCAD that matches the V3 SCAD library.\nBML is the editable source of truth. Change BML first, then compile.\nThis host registers target machineblocks-v3-scad. It does not reimplement parse, validate, or emit.\n\nInvocation: npx machineblocks <command>\nRequires Node.js 20 or newer.\nA new project starts with npx @machineblocks/cli init <package-fqn>.\n\nCommands:\n  validate    Parser + semantic check. Same project check as blockml validate.\n              Does not write SCAD.\n              machineblocks validate [--all] [<file>]\n  compile     Render selected Block and Set types to SCAD under srcDir.\n              machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n  init        Scaffold a BlockML project and record the MachineBlocks profile.\n              machineblocks init <package-fqn> [--src dir] [--install]\n\nSearch, scan, inspect, graph, new, agents-md, and transform stay on blockml.\nExit codes: 0 success, 1 diagnostic errors, 2 usage or configuration error.\n\nRun `machineblocks <command> --help` for flags, defaults, output, and constraints.";
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.ValidateCommand */
+export declare const VALIDATE_HELP = "Usage: machineblocks validate [--all] [<file>]\n       machineblocks validate --help\n\nWhen: check the model after edits. Ordinary project work.\n\nDefault (no file, no --all): semantic-validate project sources only (this package srcDir plus local packages/*). npm libraries stay on the registry for resolve.\n--all: semantic-validate every document in the registry, including npm. Do not use --all as the default after every edit.\nSingle file: parse + compileBmlToBom against the full project registry.\nfile and --all together exit 2.\n\nDoes not register machineblocks-v3-scad. No output files written.\nThis host does not accept --src, --libraries, or --verbose.\n\nFlags:\n  --all         entire reachable corpus, including npm\n\nExit 0 on success; 1 on diagnostic errors; 2 on config or usage errors.\nAfter diagnostics: Validated N block(s). or Validated N block(s) with errors.\n\nRelated: compile. Search, scan, inspect, and graph stay on blockml.";
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.CompileCommand */
+export declare const COMPILE_HELP = "Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]\n       machineblocks compile --help\n\nWhen: render selected Block and Set types to OpenSCAD. Change BML first, then recompile.\n\nTarget is machineblocks-v3-scad. The command does not take a target name.\nThe selector is one BlockML type selector: an exact FQN, pkg.*, or pkg.**.\nQuote tokens that contain * or ** so the shell does not expand them.\nResolution is scanTypes. This host does not define a second selector language.\nTypes whose baseType chain is neither com.machineblocks.bml.core.Block nor\ncom.machineblocks.bml.core.Set are skipped.\n\nOutput is written under the configured srcDir (default blocks). There is no --out and no --all.\nA package selector (a final .* or .** segment) supplies the source root when\n--target-package is set and --source-package is omitted. An exact block FQN does not.\nAutomatic mapping replaces the one bml segment with scad.\ncom.example.bml.bricks.MyBrick becomes blocks/com/example/scad/bricks/MyBrick.scad.\nExplicit mapping swaps --source-package for --target-package and does not apply that replacement again.\n\nFlags:\n  --source-package <FQN>   source package root for an explicit mapping\n  --target-package <FQN>   target package root. Not a directory and not one output file.\n\n--source-package without --target-package exits 2 (MB_SOURCE_PACKAGE_ALONE).\n--target-package without a derivable source root exits 2 (MB_SOURCE_PACKAGE_REQUIRED).\nA missing selector, an unknown flag, or a selector scanTypes rejects exits 2.\nIf no Block or Set remains, exit 1 (MB_SELECTOR_EMPTY) and the message names the selector.\n\nExit 0 writes the SCAD or preset JSON files and a sibling .map when the target attached a source map.\nThe status line is Wrote N file(s) to <srcDir>. N counts every written file, including a sibling .map.\nOne failure writes nothing. Mapping failures, collisions, and illegal paths exit 1:\n  MB_TARGET_COLLISION \u2014 two selected blocks share a target FQN or output path.\n  MB_OUTPUT_ESCAPES_SRC \u2014 a resolved path is outside srcDir.\n  MB_OUTPUT_OVERWRITES_BML \u2014 a resolved path is an existing .bml file.\n  MB_TARGET_PACKAGE_UNDETERMINED \u2014 the source FQN has no bml segment.\n  MB_TARGET_PACKAGE_AMBIGUOUS \u2014 the source FQN has more than one bml segment.\n  MB_SOURCE_OUTSIDE_ROOT \u2014 a selected block is outside --source-package.\n  MB_EMPTY_BLOCK \u2014 a composite has nothing to render.\n\nblockml.config.json srcDir is the output root. mbLibPath defaults to the installed\n@machineblocks/core package. openscadPath is unused by compile.\nA missing mbLibPath and a missing @machineblocks/core install exit 2.\n\nRelated: validate. Search, inspect, graph, and new stay on blockml.";
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.InitCommand */
+export declare const INIT_HELP = "Usage: machineblocks init <package-fqn> [--src dir] [--install]\n       machineblocks init --help\n\nWhen: turn a directory into a MachineBlocks project. Scaffolds a BlockML project,\nthen records the MachineBlocks profile.\n\nPACKAGE-FQN is a dotted package identifier (not \u2026Library). A bml segment after\nthe domain is recommended. Compile maps a bml segment to scad.\nA package FQN without a bml segment still exits 0 and warns.\nDoes not overwrite existing files.\nDoes not spawn blockml init. Calls initProject from @blockml/cli with install\nfalse, then records the profile before npm install.\n\nThe profile adds @machineblocks/cli to devDependencies when that package is\nabsent from dependencies and devDependencies. The range is the caret range of\nthis host. An existing dependencies entry stays put.\nThe project Library.bml gains com.machineblocks.bml.Library.\nCLAUDE.md (@AGENTS.md) is written when missing.\n\nFlags:\n  --src dir     source directory (default blocks)\n  --install     run npm install after the profile is recorded, then generate\n                AGENTS.md the same way as blockml init\n\nWithout --install, AGENTS.md is generated only inside initProject, before\ndependencies are installed. The file is written when AgentInstructions already\nresolve. Otherwise the next step remains: npm install && npx blockml agents-md generate.\nWith --install, an existing AGENTS.md is left in place. When the file is missing,\ngeneration runs after npm install. Sections or rules write AGENTS.md.\nNo AgentInstructions content leaves the file unwritten and prints\nNo AgentInstructions blocks found. The init exit code stays 0.\nThe next-step line from the earlier initProject pass is dropped, because install already ran.\n\nExit codes match initProject: 0 success, 1 write or install failure,\n2 usage or an invalid package FQN.\n\nRelated: validate, compile. agents-md and new stay on blockml.";
+export declare function helpFor(topic?: HelpTopic): string;
+export declare function usageFor(topic?: HelpTopic): string;
 //# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,gxBAiBhB,CAAC;AAEF,eAAO,MAAM,YAAY,yWAMxB,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,KAAK,mPAGU,CAAC;AAE7B,eAAO,MAAM,cAAc,yFACU,CAAC;AAEtC,eAAO,MAAM,aAAa,0IACU,CAAC;AAErC,eAAO,MAAM,UAAU,sGACU,CAAC;AAElC,yEAAyE;AACzE,eAAO,MAAM,IAAI,0uCAyBoE,CAAC;AAEtF,kFAAkF;AAClF,eAAO,MAAM,aAAa,o8BAmB0C,CAAC;AAErE,iFAAiF;AACjF,eAAO,MAAM,YAAY,yuFA2C2C,CAAC;AAErE,8EAA8E;AAC9E,eAAO,MAAM,SAAS,w4DAoCyC,CAAC;AAEhE,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAWjD;AAED,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAWlD"}

package/dist/help.js

@@ -1,26 +1,167 @@
-export const HELP = `Usage: machineblocks validate [file] [--all]
+/** Short syntax printed on usage errors. Not the --help page. */
+export const USAGE = `Usage: machineblocks validate [--all] [<file>]
        machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+       machineblocks init <package-fqn> [--src dir] [--install]
+       machineblocks --help`;
+export const VALIDATE_USAGE = `Usage: machineblocks validate [--all] [<file>]
+       machineblocks validate --help`;
+export const COMPILE_USAGE = `Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+       machineblocks compile --help`;
+export const INIT_USAGE = `Usage: machineblocks init <package-fqn> [--src dir] [--install]
+       machineblocks init --help`;
+/** Root help page. SSOT: com.machineblocks.bml.cli.documentation.Help */
+export const HELP = `Usage: machineblocks <command> [options]
        machineblocks --help
 
-validate
-  Same project check as blockml validate. Does not write SCAD.
+machineblocks is the MachineBlocks host CLI.
 
-compile
-  Renders selected Block and Set types to SCAD with machineblocks-v3-scad.
-  The selector is a BlockML type selector: an exact FQN, pkg.*, or pkg.**.
-  Output is written under the configured srcDir (default blocks).
-  --target-package names a package root, not a directory.
-  A package selector supplies the source root when --source-package is omitted.
-  An exact block FQN does not.
+It renders BML to OpenSCAD that matches the V3 SCAD library.
+BML is the editable source of truth. Change BML first, then compile.
+This host registers target machineblocks-v3-scad. It does not reimplement parse, validate, or emit.
 
-Exit 0 success, 1 diagnostics, 2 usage or config.
-Search, inspect, graph, and the other toolchain commands stay on blockml.
-`;
+Invocation: npx machineblocks <command>
+Requires Node.js 20 or newer.
+A new project starts with npx @machineblocks/cli init <package-fqn>.
+
+Commands:
+  validate    Parser + semantic check. Same project check as blockml validate.
+              Does not write SCAD.
+              machineblocks validate [--all] [<file>]
+  compile     Render selected Block and Set types to SCAD under srcDir.
+              machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
+  init        Scaffold a BlockML project and record the MachineBlocks profile.
+              machineblocks init <package-fqn> [--src dir] [--install]
+
+Search, scan, inspect, graph, new, agents-md, and transform stay on blockml.
+Exit codes: 0 success, 1 diagnostic errors, 2 usage or configuration error.
+
+Run \`machineblocks <command> --help\` for flags, defaults, output, and constraints.`;
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.ValidateCommand */
+export const VALIDATE_HELP = `Usage: machineblocks validate [--all] [<file>]
+       machineblocks validate --help
+
+When: check the model after edits. Ordinary project work.
+
+Default (no file, no --all): semantic-validate project sources only (this package srcDir plus local packages/*). npm libraries stay on the registry for resolve.
+--all: semantic-validate every document in the registry, including npm. Do not use --all as the default after every edit.
+Single file: parse + compileBmlToBom against the full project registry.
+file and --all together exit 2.
+
+Does not register machineblocks-v3-scad. No output files written.
+This host does not accept --src, --libraries, or --verbose.
+
+Flags:
+  --all         entire reachable corpus, including npm
+
+Exit 0 on success; 1 on diagnostic errors; 2 on config or usage errors.
+After diagnostics: Validated N block(s). or Validated N block(s) with errors.
+
+Related: compile. Search, scan, inspect, and graph stay on blockml.`;
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.CompileCommand */
 export const COMPILE_HELP = `Usage: machineblocks compile <source-selector> [--source-package <FQN>] [--target-package <FQN>]
        machineblocks compile --help
 
-<source-selector>  Block FQN, or a package selector ending in .* or .**
---source-package   Source package root for an explicit mapping
---target-package   Target package root. Not a directory and not one output file.
-`;
+When: render selected Block and Set types to OpenSCAD. Change BML first, then recompile.
+
+Target is machineblocks-v3-scad. The command does not take a target name.
+The selector is one BlockML type selector: an exact FQN, pkg.*, or pkg.**.
+Quote tokens that contain * or ** so the shell does not expand them.
+Resolution is scanTypes. This host does not define a second selector language.
+Types whose baseType chain is neither com.machineblocks.bml.core.Block nor
+com.machineblocks.bml.core.Set are skipped.
+
+Output is written under the configured srcDir (default blocks). There is no --out and no --all.
+A package selector (a final .* or .** segment) supplies the source root when
+--target-package is set and --source-package is omitted. An exact block FQN does not.
+Automatic mapping replaces the one bml segment with scad.
+com.example.bml.bricks.MyBrick becomes blocks/com/example/scad/bricks/MyBrick.scad.
+Explicit mapping swaps --source-package for --target-package and does not apply that replacement again.
+
+Flags:
+  --source-package <FQN>   source package root for an explicit mapping
+  --target-package <FQN>   target package root. Not a directory and not one output file.
+
+--source-package without --target-package exits 2 (MB_SOURCE_PACKAGE_ALONE).
+--target-package without a derivable source root exits 2 (MB_SOURCE_PACKAGE_REQUIRED).
+A missing selector, an unknown flag, or a selector scanTypes rejects exits 2.
+If no Block or Set remains, exit 1 (MB_SELECTOR_EMPTY) and the message names the selector.
+
+Exit 0 writes the SCAD or preset JSON files and a sibling .map when the target attached a source map.
+The status line is Wrote N file(s) to <srcDir>. N counts every written file, including a sibling .map.
+One failure writes nothing. Mapping failures, collisions, and illegal paths exit 1:
+  MB_TARGET_COLLISION — two selected blocks share a target FQN or output path.
+  MB_OUTPUT_ESCAPES_SRC — a resolved path is outside srcDir.
+  MB_OUTPUT_OVERWRITES_BML — a resolved path is an existing .bml file.
+  MB_TARGET_PACKAGE_UNDETERMINED — the source FQN has no bml segment.
+  MB_TARGET_PACKAGE_AMBIGUOUS — the source FQN has more than one bml segment.
+  MB_SOURCE_OUTSIDE_ROOT — a selected block is outside --source-package.
+  MB_EMPTY_BLOCK — a composite has nothing to render.
+
+blockml.config.json srcDir is the output root. mbLibPath defaults to the installed
+@machineblocks/core package. openscadPath is unused by compile.
+A missing mbLibPath and a missing @machineblocks/core install exit 2.
+
+Related: validate. Search, inspect, graph, and new stay on blockml.`;
+/** Printed help. SSOT: com.machineblocks.bml.cli.documentation.InitCommand */
+export const INIT_HELP = `Usage: machineblocks init <package-fqn> [--src dir] [--install]
+       machineblocks init --help
+
+When: turn a directory into a MachineBlocks project. Scaffolds a BlockML project,
+then records the MachineBlocks profile.
+
+PACKAGE-FQN is a dotted package identifier (not …Library). A bml segment after
+the domain is recommended. Compile maps a bml segment to scad.
+A package FQN without a bml segment still exits 0 and warns.
+Does not overwrite existing files.
+Does not spawn blockml init. Calls initProject from @blockml/cli with install
+false, then records the profile before npm install.
+
+The profile adds @machineblocks/cli to devDependencies when that package is
+absent from dependencies and devDependencies. The range is the caret range of
+this host. An existing dependencies entry stays put.
+The project Library.bml gains com.machineblocks.bml.Library.
+CLAUDE.md (@AGENTS.md) is written when missing.
+
+Flags:
+  --src dir     source directory (default blocks)
+  --install     run npm install after the profile is recorded, then generate
+                AGENTS.md the same way as blockml init
+
+Without --install, AGENTS.md is generated only inside initProject, before
+dependencies are installed. The file is written when AgentInstructions already
+resolve. Otherwise the next step remains: npm install && npx blockml agents-md generate.
+With --install, an existing AGENTS.md is left in place. When the file is missing,
+generation runs after npm install. Sections or rules write AGENTS.md.
+No AgentInstructions content leaves the file unwritten and prints
+No AgentInstructions blocks found. The init exit code stays 0.
+The next-step line from the earlier initProject pass is dropped, because install already ran.
+
+Exit codes match initProject: 0 success, 1 write or install failure,
+2 usage or an invalid package FQN.
+
+Related: validate, compile. agents-md and new stay on blockml.`;
+export function helpFor(topic) {
+    switch (topic) {
+        case "validate":
+            return VALIDATE_HELP;
+        case "compile":
+            return COMPILE_HELP;
+        case "init":
+            return INIT_HELP;
+        default:
+            return HELP;
+    }
+}
+export function usageFor(topic) {
+    switch (topic) {
+        case "validate":
+            return VALIDATE_USAGE;
+        case "compile":
+            return COMPILE_USAGE;
+        case "init":
+            return INIT_USAGE;
+        default:
+            return USAGE;
+    }
+}
 //# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;CAiBnB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;CAM3B,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,CAAC,MAAM,KAAK,GAAG;;;4BAGO,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG;qCACO,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAG;oCACO,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG;iCACO,CAAC;AAElC,yEAAyE;AACzE,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;qFAyBiE,CAAC;AAEtF,kFAAkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;oEAmBuC,CAAC;AAErE,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEA2CwC,CAAC;AAErE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAoCsC,CAAC;AAEhE,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,UAAU;YACb,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,UAAU;YACb,OAAO,cAAc,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/init-command.d.ts

@@ -0,0 +1,4 @@
+import type { InitArgs } from "./args.js";
+import type { HostResult } from "./compile-command.js";
+export declare function runInit(args: InitArgs, rootDir: string): HostResult;
+//# sourceMappingURL=init-command.d.ts.map

package/dist/init-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../src/init-command.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvD,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CA4CnE"}

package/dist/init-command.js

@@ -0,0 +1,128 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { BomBuilder } from "@blockml/builder";
+import { generateAgentsMd, initProject } from "@blockml/cli";
+import { parse } from "@blockml/parser";
+import { serialize } from "@blockml/serializer";
+const CLI_PACKAGE = "@machineblocks/cli";
+const MACHINEBLOCKS_LIBRARY = "com.machineblocks.bml.Library";
+const MACHINEBLOCKS_NAMESPACE = "com.machineblocks.bml";
+const BLOCK_LIBRARY_BASE = "org.blockml.bml.core.BlockLibrary";
+export function runInit(args, rootDir) {
+    const scaffold = initProject({
+        packageFqn: args.packageFqn,
+        rootDir,
+        ...(args.srcDir === undefined ? {} : { srcDir: args.srcDir }),
+        install: false,
+    });
+    const lines = scaffold.lines.map((line) => line.text);
+    if (scaffold.code !== 0) {
+        return { code: scaffold.code, lines };
+    }
+    const srcDir = args.srcDir?.trim() || "blocks";
+    const dependency = ensureCliDevDependency(rootDir);
+    lines.push(...dependency.lines);
+    if (dependency.code !== 0) {
+        return { code: dependency.code, lines };
+    }
+    const library = ensureLibraryDependency(rootDir, srcDir, args.packageFqn);
+    lines.push(...library.lines);
+    if (library.code !== 0) {
+        return { code: library.code, lines };
+    }
+    if (!args.packageFqn.split(".").includes("bml")) {
+        lines.push("Package FQN has no bml segment. Compile maps a bml segment to scad.");
+    }
+    if (!args.install) {
+        return { code: 0, lines };
+    }
+    // initProject already tried GenerateAgentsMd, before this profile existed
+    // and before npm install. blockml init installs first, then generates.
+    const kept = lines.filter((line) => !line.startsWith("Next:"));
+    const installed = npmInstall(rootDir);
+    if (installed.code !== 0) {
+        return { code: installed.code, lines: [...kept, ...installed.lines] };
+    }
+    return {
+        code: 0,
+        lines: [...kept, ...installed.lines, ...agentsMdAfterInstall(rootDir, srcDir)],
+    };
+}
+function agentsMdAfterInstall(rootDir, srcDir) {
+    if (existsSync(join(rootDir, "AGENTS.md"))) {
+        return [];
+    }
+    return generateAgentsMd({ rootDir, srcDir }).lines.map((line) => line.text);
+}
+function ensureCliDevDependency(rootDir) {
+    const pkgPath = join(rootDir, "package.json");
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    }
+    catch {
+        return { code: 2, lines: ["Could not parse package.json."] };
+    }
+    if (pkg.dependencies?.[CLI_PACKAGE] !== undefined || pkg.devDependencies?.[CLI_PACKAGE] !== undefined) {
+        return { code: 0, lines: [`Skipped existing ${CLI_PACKAGE}`] };
+    }
+    pkg.devDependencies = { ...pkg.devDependencies, [CLI_PACKAGE]: `^${ownVersion()}` };
+    writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf8");
+    return { code: 0, lines: [`Recorded devDependency ${CLI_PACKAGE}`] };
+}
+function ensureLibraryDependency(rootDir, srcDir, packageFqn) {
+    const libraryPath = join(rootDir, srcDir, ...packageFqn.split("."), "Library.bml");
+    const display = displayPath(libraryPath, rootDir);
+    if (!existsSync(libraryPath)) {
+        return { code: 1, lines: [`Library not found: ${display}`] };
+    }
+    const parsed = parse(readFileSync(libraryPath, "utf8"), { filePath: libraryPath });
+    if (!parsed.success || parsed.document === null) {
+        return { code: 1, lines: [`Failed to parse ${display}`] };
+    }
+    if (dependsOn(parsed.document.block, MACHINEBLOCKS_LIBRARY)) {
+        return { code: 0, lines: [`Skipped existing ${MACHINEBLOCKS_LIBRARY}`] };
+    }
+    const builder = BomBuilder.edit(parsed.document);
+    if (!dependenciesAggregation(parsed.document.block)) {
+        builder.addAggregation({ name: "dependencies", typeFqn: BLOCK_LIBRARY_BASE, override: true });
+    }
+    builder.ensureNamespaceBinding("mb", MACHINEBLOCKS_NAMESPACE);
+    builder.addCompositionChild("dependencies", MACHINEBLOCKS_LIBRARY);
+    const emitted = serialize(builder.seal());
+    if (!emitted.success || emitted.text === null) {
+        return { code: 1, lines: [`Failed to serialize ${display}`] };
+    }
+    writeFileSync(libraryPath, emitted.text, "utf8");
+    return { code: 0, lines: [`Updated ${display}`] };
+}
+function dependsOn(block, typeFqn) {
+    const aggregation = dependenciesAggregation(block);
+    if (!aggregation?.composition) {
+        return false;
+    }
+    return aggregation.composition.children.some((child) => child.kind === "blockInstance" && child.instance.typeFqn === typeFqn);
+}
+function dependenciesAggregation(block) {
+    const member = block.members.find((entry) => entry.kind === "aggregation" && entry.name === "dependencies");
+    return member?.kind === "aggregation" ? member : undefined;
+}
+function npmInstall(rootDir) {
+    const result = spawnSync("npm", ["install"], { cwd: rootDir, stdio: "inherit" });
+    if (result.status !== 0) {
+        return { code: 1, lines: ["npm install failed."] };
+    }
+    return { code: 0, lines: [] };
+}
+function ownVersion() {
+    const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+    const pkg = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
+    return pkg.version ?? "0.0.0";
+}
+function displayPath(file, rootDir) {
+    const rel = relative(rootDir, file);
+    return rel && !rel.startsWith("..") ? rel : file;
+}
+//# sourceMappingURL=init-command.js.map

package/dist/init-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.js","sourceRoot":"","sources":["../src/init-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAC9D,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AACxD,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAE/D,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,OAAe;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC;IAC/C,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe,EAAE,MAAc;IAC3D,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,IAAI,GAGH,CAAC;IACF,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAe,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,+BAA+B,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QACtG,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,oBAAoB,WAAW,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,GAAG,CAAC,eAAe,GAAG,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,UAAU,EAAE,EAAE,EAAE,CAAC;IACpF,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,0BAA0B,WAAW,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAe,EAAE,MAAc,EAAE,UAAkB;IAClF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,sBAAsB,OAAO,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,mBAAmB,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,oBAAoB,qBAAqB,EAAE,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,CAAC,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC9D,OAAO,CAAC,mBAAmB,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,uBAAuB,OAAO,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,WAAW,OAAO,EAAE,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,SAAS,CAAC,KAAsB,EAAE,OAAe;IACxD,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,KAAK,OAAO,CAChF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAsB;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IAC5G,OAAO,MAAM,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,qBAAqB,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;IACxG,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAe;IAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@machineblocks/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MachineBlocks host CLI — simplified BlockML entry that renders BML to SCAD",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -30,13 +30,16 @@
     "test": "vitest run --root ../.. packages/machineblocks-cli/test"
   },
   "dependencies": {
-    "@blockml/block-render-engine": "^0.1.0",
-    "@blockml/cli": "^0.9.13",
-    "@blockml/compiler": "^0.9.13",
-    "@blockml/core": "^1.4.2",
-    "@blockml/framework": "^0.9.13",
+    "@blockml/block-render-engine": "^0.1.2",
+    "@blockml/builder": "^0.9.14",
+    "@blockml/cli": "^0.9.14",
+    "@blockml/compiler": "^0.9.14",
+    "@blockml/core": "^1.4.5",
+    "@blockml/framework": "^0.9.14",
+    "@blockml/parser": "^0.9.14",
+    "@blockml/serializer": "^0.9.14",
     "@machineblocks/core": "^3.0.0-A4",
-    "@machineblocks/render-target": "^0.1.0"
+    "@machineblocks/render-target": "^0.1.2"
   },
   "engines": {
     "node": ">=20"