Class InitStep

src/specify_cli/workflows/steps/init/__init__.py:28–309

Bootstrap a project, equivalent to running ``specify init``. The step runs the bundled ``specify init`` command non-interactively, scaffolding templates, scripts, shared infrastructure, and the selected coding agent integration into the target directory. Because workflows run unatt

class InitStep(StepBase):
    """Bootstrap a project, equivalent to running ``specify init``.

    The step runs the bundled ``specify init`` command non-interactively,
    scaffolding templates, scripts, shared infrastructure, and the
    selected coding agent integration into the target directory.

    Because workflows run unattended, the step defaults to
    ``--ignore-agent-tools`` (skip checks for an installed agent CLI) and
    resolves the integration from the step config, falling back to the
    workflow-level default integration.

    Example YAML::

        - id: bootstrap
          type: init
          here: true
          integration: copilot
          script: sh

    Supported config fields (all optional):

    ``project``
        Project name or path to create.  Use ``"."`` for the current
        directory.  Ignored when ``here`` is truthy.
    ``here``
        Initialize in the target directory instead of creating a new one.
    ``integration``
        Integration key (e.g. ``copilot``).  Defaults to the workflow's
        default integration, then to ``DEFAULT_INIT_INTEGRATION``.
    ``integration_options``
        Extra options for the integration (e.g. ``"--skills"`` or
        ``"--commands-dir .myagent/cmds"``).
    ``script``
        Script type, ``sh`` or ``ps``.
    ``force``
        Merge/overwrite without confirmation when the directory is not
        empty.
    ``ignore_agent_tools``
        Skip checks for the coding agent CLI (defaults to ``true``).
    ``preset``
        Preset ID to install during initialization.
    """

    type_key = "init"

    def execute(self, config: dict[str, Any], context: StepContext) -> StepResult:
        project = self._resolve(config.get("project"), context)
        here = self._resolve_bool(config.get("here"), context)

        integration = self._resolve(config.get("integration"), context)
        if not integration:
            integration = self._resolve(context.default_integration, context)
        # Apply the same default that specify init uses in non-interactive mode
        # so that output.integration reflects the actual integration used.
        if not integration:
            integration = DEFAULT_INIT_INTEGRATION