An open source design system that's fully customizable and agent ready
TypeScript
refactor(cli): split init into api/init leaf shape (#4482)
Joey231a33bbe678
diff --git a/.changeset/cli-init-leaves.md b/.changeset/cli-init-leaves.mdnew file mode 100644index 0000000000..a3d94b16d9--- /dev/null+++ b/.changeset/cli-init-leaves.md@@ -0,0 +1,7 @@+---+'@astryxdesign/cli': patch+---++[refactor] CLI: init reorganized into api/init leaf shape — `init.mjs` is now a dispatcher + barrel that routes to `api/init/run/run.mjs` (the default / `--features` / `--all` install path) and `api/init/remove/remove.mjs` (the `--remove-agents` path), with the shared plain-logger contract in `api/init/_adapter.mjs`. Pure reorg: `getNextSteps`, `noopInitLogger`, and the `InitOptions` / `InitLogger` types stay re-exported from the barrel, so api/index.mjs, the CLI command, and the programmatic API are unchanged. Human and `--json` output are byte-identical.++@josephfarinadiff --git a/packages/cli/api/init/_adapter.mjs b/packages/cli/api/init/_adapter.mjsnew file mode 100644index 0000000000..0005ddc131--- /dev/null+++ b/packages/cli/api/init/_adapter.mjs@@ -0,0 +1,27 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file init shared adapter — the plain logger contract shared by init's leaves.+ *+ * Both the `init.run` (run/run.mjs) and `init.remove` (remove/remove.mjs) leaves+ * emit human progress through the SAME injectable logger and default to the SAME+ * silent no-op for programmatic callers. That contract is the only thing the two+ * leaves share — the agent-docs engine itself lives in lib/agent-docs — so it+ * lives here rather than being duplicated per-leaf or forcing a cross-leaf+ * import. The dispatcher/barrel (init.mjs) re-exports `noopInitLogger` so the+ * CLI + tests keep importing it by name.+ *+ * The logger is a PLAIN log/error pair, NOT the clack-style term-log used by+ * upgrade/theme: init's output has always been flat humanLog lines, so a+ * byte-identical CLI needs a plain passthrough, not intro/step/success framing.+ */++/**+ * Plain injectable logger for init's flat output.+ * @typedef {object} InitLogger+ * @property {(m?: string) => void} log stdout line (the CLI maps this to humanLog)+ * @property {(m?: string) => void} error stderr line (the CLI maps this to console.error)+ */++/** Silent logger — the default for programmatic callers. @type {InitLogger} */+export const noopInitLogger = {log() {}, error() {}};diff --git a/packages/cli/api/init/init.mjs b/packages/cli/api/init/init.mjsindex 00c29c55c0..545d93d4da 100644--- a/packages/cli/api/init/init.mjs+++ b/packages/cli/api/init/init.mjs@@ -1,279 +1,53 @@// Copyright (c) Meta Platforms, Inc. and affiliates./**- * @file init API — non-interactive project setup + feature installer.+ * @file init API — dispatcher + barrel.*- * `init(options)` installs the AGENTS.md/CLAUDE.md agent-docs cheat sheet, points- * at the theme + page-building workflows, and (optionally) scaffolds a starter- * template — with NO prompts, so it behaves identically for humans, agents, CI,- * and piped I/O. It performs the side effects and returns a receipt:- * - `init.run` — the setup receipt (docs written, features, template outcome)- * - `init.remove` — the `--remove-agents` receipt- * Hard errors (unknown feature/template) throw AstryxError with a stable code.- * Human output is emitted through the injected `logger` (silent by default) so- * the CLI keeps its exact plain output and a programmatic caller stays quiet.+ * `init(options, ctx)` is the non-interactive project setup entrypoint. It has+ * no prompts, so it behaves identically for humans, agents, CI, and piped I/O.+ * It routes to one of two leaves and returns that leaf's receipt:+ * - `init.run` (run/run.mjs) — the default / `--features` / `--all`+ * install path (agent-docs, theme ++ * page-building guidance, template)+ * - `init.remove` (remove/remove.mjs) — the `--remove-agents` path*- * The logger here is a PLAIN log/error pair, NOT the clack-style term-log used by- * upgrade/theme: init's output has always been flat humanLog lines, so a- * byte-identical CLI needs a plain passthrough, not intro/step/success framing.- *- * Note: `--remove-agents` calls removeAgentDocs(), which still logs its own- * per-file lines via humanLog (shared lib behavior) — so a programmatic remove- * is not perfectly silent yet. Threading a logger through agent-docs is a- * separate cleanup.- */--import * as path from 'node:path';-import * as fs from 'node:fs';-import {CLI_ROOT} from '../../utils/paths.mjs';-import {PathSafetyError} from '../../utils/path-safety.mjs';-import {getCliInvocation} from '../../utils/package-manager.mjs';-import {- installAgentDocs,- removeAgentDocs,-} from '../../lib/agent-docs/agent-docs.mjs';-import {listTemplates} from '../template/template.mjs';-import {AstryxError} from '../error.mjs';-import {ERROR_CODES} from '../../lib/error-codes.mjs';--const VALID_FEATURES = ['agents', 'theme', 'template'];--/**- * Plain injectable logger for init's flat output.- * @typedef {object} InitLogger- * @property {(m?: string) => void} log stdout line (the CLI maps this to humanLog)- * @property {(m?: string) => void} error stderr line (the CLI maps this to console.error)+ * This module also re-exports the leaf symbols the CLI + tests import by name+ * (`getNextSteps`, `noopInitLogger`) so api/index.mjs, the command handler+ * (cli/commands/init.mjs), and the test suite stay unchanged.*/-/** Silent logger — the default for programmatic callers. @type {InitLogger} */-export const noopInitLogger = {log() {}, error() {}};+import {run} from './run/run.mjs';+import {remove} from './remove/remove.mjs';+import {noopInitLogger} from './_adapter.mjs';-/**- * @typedef {object} InitOptions- * @property {string} [features] comma-separated features (agents, theme, template)- * @property {boolean} [all] install all features- * @property {boolean} [removeAgents] remove the managed agent-docs block- * @property {string} [agent] agent preset (claude, cursor, codex, hermes, all)- * @property {string | string[]} [agentDocsPath] explicit agent-docs path(s)- * @property {string} [templateName] programmatic-only; the CLI never sets it- */+export {getNextSteps} from './run/run.mjs';+export {noopInitLogger} from './_adapter.mjs';/**- * @typedef {object} InitRunData- * @property {'default' | 'features'} mode- * @property {string[]} features features that were run- * @property {string[]} docsWritten agent-doc files written (empty if not run/failed)- * @property {{kind: 'path-safety' | 'install-failed', message?: string} | null} docsError- * @property {boolean} theme whether theme guidance was emitted- * @property {'workflow' | 'created' | 'skipped' | null} template template outcome- * @property {string | null} templatePath relative path when `template === 'created'`- * @property {boolean} nextSteps whether the getting-started next-steps were emitted+ * Re-exported types so callers can keep referencing them off the init barrel+ * (e.g. cli/commands/init.mjs uses `import('../../api/init/init.mjs').InitOptions`+ * and `.InitLogger`). The canonical shapes stay central in types/api.d.ts ++ * types/init.d.ts; these aliases just preserve the barrel's original type+ * surface after the split.+ * @typedef {import('../../types/api').InitOptions} InitOptions+ * @typedef {import('./_adapter.mjs').InitLogger} InitLogger+ * @typedef {import('../../types/init').InitRunData} InitRunData*//**- * Build the "Next steps" lines printed at the end of `astryx init`.- *- * Theme guidance must match the runtime recommendation emitted by core's- * <Theme> component (packages/core/src/theme/Theme.tsx): the pre-built theme- * path (`/built` import + `theme.css`) plus the base CSS import, so users- * don't end up with an unstyled app or the slower runtime style-injection- * path. See https://github.com/facebook/astryx/issues/3080.- *- * @param {string} invocation install-aware CLI invocation stem (e.g. `npx astryx`, `pnpm exec astryx`, or `npx @astryxdesign/cli` for one-off runs)- * @returns {string[]} ordered list of human-facing lines- */-export function getNextSteps(invocation) {- return [- '',- ' Next steps:',- " 1. Import base styles: import '@astryxdesign/core/reset.css'",- " and import '@astryxdesign/core/astryx.css'",- " 2. Import components: import { Button } from '@astryxdesign/core'",- ' 3. Optionally add a theme (use the pre-built path for performance):',- " import { neutralTheme } from '@astryxdesign/theme-neutral/built'",- " import '@astryxdesign/theme-neutral/theme.css'",- ' <Theme theme={neutralTheme}>...</Theme>',- ` For custom themes, run \`${invocation} theme build <file>\` to generate the built artifacts.`,- ` 4. ${invocation} --help for all commands`,- '',- ];-}--/**- * Install the agent-docs block; records the outcome (or soft error) on `data`.- * Mirrors the CLI's historical soft-error policy: a PathSafetyError surfaces its- * precise message and flags a non-zero exit; any other failure prints the- * generic retry hint and continues without changing the exit code.- *- * @param {string} cwd- * @param {InitOptions} options- * @param {string} run- * @param {InitLogger} logger- * @param {InitRunData} data- */-function applyAgents(cwd, options, run, logger, data) {- try {- const paths = options.agentDocsPath- ? Array.isArray(options.agentDocsPath)- ? options.agentDocsPath- : [options.agentDocsPath]- : undefined;- const written = installAgentDocs(cwd, {agent: options.agent, paths});- data.docsWritten = written;- logger.log(`✓ AI agent docs installed → ${written.join(', ')}`);- } catch (err) {- // PathSafetyError carries a precise, user-actionable message — surface it- // (and flag exit 1) instead of the generic "could not install" warning so- // misconfigured --agent-docs-path values aren't silently swallowed.- if (err instanceof PathSafetyError) {- logger.error(`Error: ${err.message}`);- data.docsError = {kind: 'path-safety', message: err.message};- return;- }- logger.error(- `Could not install agent docs. Try again with \`${run} init --features agents\`.`,- );- data.docsError = {kind: 'install-failed'};- }-}--/**- * Emit the template guidance, or (programmatic-only) scaffold a named template.- * The CLI never passes `templateName`, so from the CLI this always emits the- * build-workflow prose (or nothing when no templates are bundled).- *- * @param {string} cwd- * @param {{templateName?: string}} opts- * @param {string} run- * @param {InitLogger} logger- * @param {InitRunData} data- */-function applyTemplate(cwd, {templateName}, run, logger, data) {- const templates = listTemplates();- if (templates.length === 0) {- data.template = 'skipped';- return;- }-- if (!templateName) {- // Point agents at the build workflow rather than dumping page-template- // names — `build` surfaces pages AND blocks AND components for an idea,- // and `build` with no args is the full how-to-build playbook.- logger.log('✓ To build UI, use these commands:');- logger.log('');- logger.log(- ` ${run} build "<what you're building>" build a page — kit: closest template + blocks + components`,- );- logger.log(- ` ${run} build the how-to-build workflow (read this first)`,- );- logger.log(- ` ${run} search <query> find anything — components, docs, templates, blocks`,- );- logger.log('');- data.template = 'workflow';- return;- }-- if (!templates.includes(templateName)) {- throw new AstryxError(- `Unknown template "${templateName}". Available: ${templates.join(', ')}`,- undefined,- ERROR_CODES.ERR_UNKNOWN_TEMPLATE,- );- }-- const outputDir = path.resolve(cwd, `./src/pages/${templateName}`);- const srcPath = path.join(CLI_ROOT, 'templates', 'pages', templateName, 'page.tsx');- fs.mkdirSync(outputDir, {recursive: true});- fs.copyFileSync(srcPath, path.join(outputDir, 'page.tsx'));- const rel = path.relative(cwd, outputDir);- logger.log(`✓ Template created at ${rel}/page.tsx`);- data.template = 'created';- data.templatePath = rel;-}--/**- * Run the non-interactive init flow. Performs the side effects (agent-docs- * install, template scaffold, or agent-docs removal) and returns a receipt.- * Progress is emitted through `logger` (silent by default); unknown feature or- * template names throw AstryxError with a stable code.+ * Run the non-interactive init flow. Dispatches to the remove leaf when+ * `--remove-agents` is set, otherwise to the install (run) leaf, and returns+ * that leaf's receipt. Progress is emitted through `logger` (silent by+ * default); unknown feature or template names throw AstryxError with a stable+ * code.** @param {InitOptions} [options]* @param {{cwd?: string, logger?: InitLogger}} [ctx]- * @returns {Promise<{type: 'init.run', data: InitRunData} | {type: 'init.remove', data: {removed: true}}>}+ * @returns {Promise<import('../../types/init').InitRunResponse | import('../../types/init').InitRemoveResponse>}*/export async function init(options = {}, {cwd = process.cwd(), logger = noopInitLogger} = {}) {- const run = getCliInvocation();-- // Remove mode.if (options.removeAgents) {- removeAgentDocs(cwd);- logger.log('✓ AI agent docs removed.');- return {type: 'init.remove', data: {removed: true}};+ return remove({cwd, logger});}-- // Non-interactive feature install: --features or --all.- if (options.features || options.all) {- const features = options.all- ? VALID_FEATURES- : String(options.features)- .split(',')- .map(f => f.trim().toLowerCase());-- const invalid = features.filter(f => !VALID_FEATURES.includes(f));- if (invalid.length > 0) {- throw new AstryxError(- `Unknown features: ${invalid.join(', ')}. Valid features: ${VALID_FEATURES.join(', ')}`,- undefined,- ERROR_CODES.ERR_UNKNOWN_FEATURE,- );- }-- /** @type {InitRunData} */- const data = {- mode: 'features',- features,- docsWritten: [],- docsError: null,- theme: false,- template: null,- templatePath: null,- nextSteps: false,- };- for (const feature of features) {- if (feature === 'agents') applyAgents(cwd, options, run, logger, data);- if (feature === 'theme') {- logger.log(- `✓ For a custom theme, run \`${run} theme\` (browse) or \`${run} theme add <slug>\` (scaffold).`,- );- data.theme = true;- }- if (feature === 'template') {- applyTemplate(cwd, {templateName: options.templateName}, run, logger, data);- }- }- return {type: 'init.run', data};- }-- // No flags: TTY-free default — install the AI agent cheat sheet with NO- // prompts, then print the getting-started guidance.- /** @type {InitRunData} */- const data = {- mode: 'default',- features: ['agents'],- docsWritten: [],- docsError: null,- theme: false,- template: null,- templatePath: null,- nextSteps: true,- };- applyAgents(cwd, options, run, logger, data);- logger.log('');- logger.log(- ` Tip: \`${run} init --all\` also points you to the theme and page-building workflows.`,- );- for (const line of getNextSteps(run)) logger.log(line);- return {type: 'init.run', data};+ return run(options, {cwd, logger});}diff --git a/packages/cli/api/init/remove/remove.mjs b/packages/cli/api/init/remove/remove.mjsnew file mode 100644index 0000000000..9d36ba5756--- /dev/null+++ b/packages/cli/api/init/remove/remove.mjs@@ -0,0 +1,29 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file init.remove leaf — the `--remove-agents` path behind `astryx init`.+ *+ * `remove(ctx)` deletes the managed agent-docs block from every agent-doc file+ * and returns an `init.remove` receipt. The removal engine lives in+ * lib/agent-docs; this leaf only wires the cwd + the injected logger.+ *+ * Note: removeAgentDocs() still logs its own per-file lines via humanLog+ * (shared lib behavior) — so a programmatic remove is not perfectly silent yet.+ * Threading a logger through agent-docs is a separate cleanup.+ */++import {removeAgentDocs} from '../../../lib/agent-docs/agent-docs.mjs';+import {noopInitLogger} from '../_adapter.mjs';++/**+ * Remove the managed agent-docs block and return an `init.remove` receipt.+ * Progress is emitted through `logger` (silent by default).+ *+ * @param {{cwd?: string, logger?: import('../_adapter.mjs').InitLogger}} [ctx]+ * @returns {Promise<import('../../../types/init').InitRemoveResponse>}+ */+export async function remove({cwd = process.cwd(), logger = noopInitLogger} = {}) {+ removeAgentDocs(cwd);+ logger.log('✓ AI agent docs removed.');+ return {type: 'init.remove', data: {removed: true}};+}diff --git a/packages/cli/api/init/run/run.mjs b/packages/cli/api/init/run/run.mjsnew file mode 100644index 0000000000..6e858e7326--- /dev/null+++ b/packages/cli/api/init/run/run.mjs@@ -0,0 +1,230 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file init.run leaf — non-interactive project setup + feature installer.+ *+ * `run(options, ctx)` is the default / `--features` / `--all` path behind+ * `astryx init`. It installs the AGENTS.md/CLAUDE.md agent-docs cheat sheet,+ * points at the theme + page-building workflows, and (optionally) scaffolds a+ * starter template — with NO prompts, so it behaves identically for humans,+ * agents, CI, and piped I/O. It performs the side effects and returns an+ * `init.run` receipt. Hard errors (unknown feature/template) throw AstryxError+ * with a stable code. Human output is emitted through the injected `logger`+ * (silent by default) so the CLI keeps its exact plain output and a+ * programmatic caller stays quiet.+ */++import * as path from 'node:path';+import * as fs from 'node:fs';+import {CLI_ROOT} from '../../../utils/paths.mjs';+import {PathSafetyError} from '../../../utils/path-safety.mjs';+import {getCliInvocation} from '../../../utils/package-manager.mjs';+import {installAgentDocs} from '../../../lib/agent-docs/agent-docs.mjs';+import {listTemplates} from '../../template/template.mjs';+import {AstryxError} from '../../error.mjs';+import {ERROR_CODES} from '../../../lib/error-codes.mjs';+import {noopInitLogger} from '../_adapter.mjs';++const VALID_FEATURES = ['agents', 'theme', 'template'];++/**+ * Build the "Next steps" lines printed at the end of `astryx init`.+ *+ * Theme guidance must match the runtime recommendation emitted by core's+ * <Theme> component (packages/core/src/theme/Theme.tsx): the pre-built theme+ * path (`/built` import + `theme.css`) plus the base CSS import, so users+ * don't end up with an unstyled app or the slower runtime style-injection+ * path. See https://github.com/facebook/astryx/issues/3080.+ *+ * @param {string} invocation install-aware CLI invocation stem (e.g. `npx astryx`, `pnpm exec astryx`, or `npx @astryxdesign/cli` for one-off runs)+ * @returns {string[]} ordered list of human-facing lines+ */+export function getNextSteps(invocation) {+ return [+ '',+ ' Next steps:',+ " 1. Import base styles: import '@astryxdesign/core/reset.css'",+ " and import '@astryxdesign/core/astryx.css'",+ " 2. Import components: import { Button } from '@astryxdesign/core'",+ ' 3. Optionally add a theme (use the pre-built path for performance):',+ " import { neutralTheme } from '@astryxdesign/theme-neutral/built'",+ " import '@astryxdesign/theme-neutral/theme.css'",+ ' <Theme theme={neutralTheme}>...</Theme>',+ ` For custom themes, run \`${invocation} theme build <file>\` to generate the built artifacts.`,+ ` 4. ${invocation} --help for all commands`,+ '',+ ];+}++/**+ * Install the agent-docs block; records the outcome (or soft error) on `data`.+ * Mirrors the CLI's historical soft-error policy: a PathSafetyError surfaces its+ * precise message and flags a non-zero exit; any other failure prints the+ * generic retry hint and continues without changing the exit code.+ *+ * @param {string} cwd+ * @param {import('../../../types/api').InitOptions} options+ * @param {string} invocation+ * @param {import('../_adapter.mjs').InitLogger} logger+ * @param {import('../../../types/init').InitRunData} data+ */+function applyAgents(cwd, options, invocation, logger, data) {+ try {+ const paths = options.agentDocsPath+ ? Array.isArray(options.agentDocsPath)+ ? options.agentDocsPath+ : [options.agentDocsPath]+ : undefined;+ const written = installAgentDocs(cwd, {agent: options.agent, paths});+ data.docsWritten = written;+ logger.log(`✓ AI agent docs installed → ${written.join(', ')}`);+ } catch (err) {+ // PathSafetyError carries a precise, user-actionable message — surface it+ // (and flag exit 1) instead of the generic "could not install" warning so+ // misconfigured --agent-docs-path values aren't silently swallowed.+ if (err instanceof PathSafetyError) {+ logger.error(`Error: ${err.message}`);+ data.docsError = {kind: 'path-safety', message: err.message};+ return;+ }+ logger.error(+ `Could not install agent docs. Try again with \`${invocation} init --features agents\`.`,+ );+ data.docsError = {kind: 'install-failed'};+ }+}++/**+ * Emit the template guidance, or (programmatic-only) scaffold a named template.+ * The CLI never passes `templateName`, so from the CLI this always emits the+ * build-workflow prose (or nothing when no templates are bundled).+ *+ * @param {string} cwd+ * @param {{templateName?: string}} opts+ * @param {string} invocation+ * @param {import('../_adapter.mjs').InitLogger} logger+ * @param {import('../../../types/init').InitRunData} data+ */+function applyTemplate(cwd, {templateName}, invocation, logger, data) {+ const templates = listTemplates();+ if (templates.length === 0) {+ data.template = 'skipped';+ return;+ }++ if (!templateName) {+ // Point agents at the build workflow rather than dumping page-template+ // names — `build` surfaces pages AND blocks AND components for an idea,+ // and `build` with no args is the full how-to-build playbook.+ logger.log('✓ To build UI, use these commands:');+ logger.log('');+ logger.log(+ ` ${invocation} build "<what you're building>" build a page — kit: closest template + blocks + components`,+ );+ logger.log(+ ` ${invocation} build the how-to-build workflow (read this first)`,+ );+ logger.log(+ ` ${invocation} search <query> find anything — components, docs, templates, blocks`,+ );+ logger.log('');+ data.template = 'workflow';+ return;+ }++ if (!templates.includes(templateName)) {+ throw new AstryxError(+ `Unknown template "${templateName}". Available: ${templates.join(', ')}`,+ undefined,+ ERROR_CODES.ERR_UNKNOWN_TEMPLATE,+ );+ }++ const outputDir = path.resolve(cwd, `./src/pages/${templateName}`);+ const srcPath = path.join(CLI_ROOT, 'templates', 'pages', templateName, 'page.tsx');+ fs.mkdirSync(outputDir, {recursive: true});+ fs.copyFileSync(srcPath, path.join(outputDir, 'page.tsx'));+ const rel = path.relative(cwd, outputDir);+ logger.log(`✓ Template created at ${rel}/page.tsx`);+ data.template = 'created';+ data.templatePath = rel;+}++/**+ * Run the install path of the non-interactive init flow (the default no-flags+ * install plus `--features` / `--all`). Performs the side effects (agent-docs+ * install, template scaffold) and returns an `init.run` receipt. Progress is+ * emitted through `logger` (silent by default); unknown feature or template+ * names throw AstryxError with a stable code.+ *+ * @param {import('../../../types/api').InitOptions} [options]+ * @param {{cwd?: string, logger?: import('../_adapter.mjs').InitLogger}} [ctx]+ * @returns {Promise<import('../../../types/init').InitRunResponse>}+ */+export async function run(options = {}, {cwd = process.cwd(), logger = noopInitLogger} = {}) {+ const invocation = getCliInvocation();++ // Non-interactive feature install: --features or --all.+ if (options.features || options.all) {+ const features = options.all+ ? VALID_FEATURES+ : String(options.features)+ .split(',')+ .map(f => f.trim().toLowerCase());++ const invalid = features.filter(f => !VALID_FEATURES.includes(f));+ if (invalid.length > 0) {+ throw new AstryxError(+ `Unknown features: ${invalid.join(', ')}. Valid features: ${VALID_FEATURES.join(', ')}`,+ undefined,+ ERROR_CODES.ERR_UNKNOWN_FEATURE,+ );+ }++ /** @type {import('../../../types/init').InitRunData} */+ const data = {+ mode: 'features',+ features,+ docsWritten: [],+ docsError: null,+ theme: false,+ template: null,+ templatePath: null,+ nextSteps: false,+ };+ for (const feature of features) {+ if (feature === 'agents') applyAgents(cwd, options, invocation, logger, data);+ if (feature === 'theme') {+ logger.log(+ `✓ For a custom theme, run \`${invocation} theme\` (browse) or \`${invocation} theme add <slug>\` (scaffold).`,+ );+ data.theme = true;+ }+ if (feature === 'template') {+ applyTemplate(cwd, {templateName: options.templateName}, invocation, logger, data);+ }+ }+ return {type: 'init.run', data};+ }++ // No flags: TTY-free default — install the AI agent cheat sheet with NO+ // prompts, then print the getting-started guidance.+ /** @type {import('../../../types/init').InitRunData} */+ const data = {+ mode: 'default',+ features: ['agents'],+ docsWritten: [],+ docsError: null,+ theme: false,+ template: null,+ templatePath: null,+ nextSteps: true,+ };+ applyAgents(cwd, options, invocation, logger, data);+ logger.log('');+ logger.log(+ ` Tip: \`${invocation} init --all\` also points you to the theme and page-building workflows.`,+ );+ for (const line of getNextSteps(invocation)) logger.log(line);+ return {type: 'init.run', data};+}