@lumenflow/cli 4.24.0 → 5.0.0

package/dist/docs-generate-pack-reference.js

@@ -0,0 +1,500 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import fg from 'fast-glob';
+import { format as formatWithPrettier, resolveConfig as resolvePrettierConfig } from 'prettier';
+import YAML from 'yaml';
+import { createError, ErrorCodes } from '@lumenflow/core/error-handler';
+import { updateMergeBlock } from './merge-block.js';
+import { runCLI } from './cli-entry-point.js';
+const UTF8_ENCODING = 'utf-8';
+const DEFAULT_PACKS_ROOT = path.join('packages', '@lumenflow', 'packs');
+const DEFAULT_DOCS_ROOT = path.join('apps', 'docs', 'src', 'content', 'docs', 'packs');
+const MANIFEST_GLOB = '*/manifest.yaml';
+const EVENTS_SECTION = 'events';
+const TOOLS_SECTION = 'tools';
+const PAGE_FILE_NAME = 'index.mdx';
+const GENERATED_WITH_COMMAND = 'pnpm docs:generate:pack-reference';
+const PACK_TITLES = {
+    'agent-runtime': 'Agent Runtime',
+    sidekick: 'Sidekick',
+    'software-delivery': 'Software Delivery',
+};
+const SOFTWARE_DELIVERY_EVENT_KINDS = {
+    GATE_STARTED: 'software-delivery:gate_started',
+    GATE_PASSED: 'software-delivery:gate_passed',
+    GATE_FAILED: 'software-delivery:gate_failed',
+    CO_CHANGE_RULE_FIRED: 'software-delivery:co_change_rule_fired',
+    CONDITIONAL_COMMAND_FIRED: 'software-delivery:conditional_command_fired',
+    LANE_WIP_BREACHED: 'software-delivery:lane_wip_breached',
+    LANE_LOCKED: 'software-delivery:lane_locked',
+    LANE_UNLOCKED: 'software-delivery:lane_unlocked',
+    LANE_SUGGESTION_EMITTED: 'software-delivery:lane_suggestion_emitted',
+    INITIATIVE_CREATED: 'software-delivery:initiative_created',
+    INITIATIVE_CLOSED: 'software-delivery:initiative_closed',
+    INITIATIVE_PHASE_ADVANCED: 'software-delivery:initiative_phase_advanced',
+    PLAN_CREATED: 'software-delivery:plan_created',
+    PLAN_LINKED: 'software-delivery:plan_linked',
+    PLAN_PROMOTED: 'software-delivery:plan_promoted',
+};
+const SOFTWARE_DELIVERY_EVENT_DOCS = {
+    [SOFTWARE_DELIVERY_EVENT_KINDS.GATE_STARTED]: {
+        payloadShape: '{ wu_id, lane, gate_name, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildGateStartedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.GATE_PASSED]: {
+        payloadShape: '{ wu_id, lane, gate_name, duration_ms, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildGatePassedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.GATE_FAILED]: {
+        payloadShape: '{ wu_id, lane, gate_name, duration_ms, reason, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildGateFailedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.CO_CHANGE_RULE_FIRED]: {
+        payloadShape: '{ wu_id, rule_id, triggered_paths, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildCoChangeRuleFiredEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.CONDITIONAL_COMMAND_FIRED]: {
+        payloadShape: '{ wu_id, command_id, trigger, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildConditionalCommandFiredEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.LANE_WIP_BREACHED]: {
+        payloadShape: '{ lane, wip_limit, current_wip, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildLaneWipBreachedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.LANE_LOCKED]: {
+        payloadShape: '{ lane, held_by, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildLaneLockedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.LANE_UNLOCKED]: {
+        payloadShape: '{ lane, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildLaneUnlockedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.LANE_SUGGESTION_EMITTED]: {
+        payloadShape: '{ wu_id, suggested_lane, confidence, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildLaneSuggestionEmittedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.INITIATIVE_CREATED]: {
+        payloadShape: '{ initiative, wu_count, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildInitiativeCreatedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.INITIATIVE_CLOSED]: {
+        payloadShape: '{ initiative, reason, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildInitiativeClosedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.INITIATIVE_PHASE_ADVANCED]: {
+        payloadShape: '{ initiative, from_phase, to_phase, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildInitiativePhaseAdvancedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.PLAN_CREATED]: {
+        payloadShape: '{ plan_id, initiative, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildPlanCreatedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.PLAN_LINKED]: {
+        payloadShape: '{ plan_id, wu_id, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildPlanLinkedEvent(',
+    },
+    [SOFTWARE_DELIVERY_EVENT_KINDS.PLAN_PROMOTED]: {
+        payloadShape: '{ plan_id, promoted_wu_id, channel_id, seq }',
+        backpressurePolicy: 'ephemeral',
+        emissionSearchTerm: 'buildPlanPromotedEvent(',
+    },
+};
+const CODE_GLOBS = ['packages/@lumenflow/cli/src/**/*.ts', 'packages/@lumenflow/cli/src/**/*.tsx'];
+const CODE_IGNORE = ['**/__tests__/**', '**/*.test.ts', '**/*.test.tsx', '**/*.spec.ts'];
+const EMITTER_DEFINITION_FILE = path.join('packages', '@lumenflow', 'cli', 'src', 'kernel-event-sync', 'software-delivery-emitters.ts');
+const GENERATOR_SOURCE_FILE = path.join('packages', '@lumenflow', 'cli', 'src', 'docs-generate-pack-reference.ts');
+function formatUsage() {
+    return [
+        'Usage: docs:generate:pack-reference [options]',
+        '',
+        'Generate Starlight /packs/<pack>/events/ and /tools/ reference pages from pack manifests.',
+        '',
+        'Options:',
+        '  --help   Show this help message',
+    ].join('\n');
+}
+function resolvePackTitle(packId) {
+    return PACK_TITLES[packId] ?? packId;
+}
+function resolveProjectRoot(projectRoot) {
+    return path.resolve(projectRoot ?? process.cwd());
+}
+function resolvePacksRoot(projectRoot, packsRoot) {
+    return path.resolve(projectRoot, packsRoot ?? DEFAULT_PACKS_ROOT);
+}
+function resolveDocsRoot(projectRoot, docsRoot) {
+    return path.resolve(projectRoot, docsRoot ?? DEFAULT_DOCS_ROOT);
+}
+function relativeToProject(projectRoot, targetPath) {
+    return path.relative(projectRoot, targetPath).split(path.sep).join('/');
+}
+function loadPackManifest(manifestPath) {
+    const rawContent = readFileSync(manifestPath, UTF8_ENCODING);
+    return parseManifestRecord(YAML.parse(rawContent), manifestPath);
+}
+function sortManifestPaths(paths) {
+    return [...paths].sort((left, right) => left.localeCompare(right));
+}
+function discoverManifestPaths(packsRoot) {
+    return sortManifestPaths(fg.sync(MANIFEST_GLOB, {
+        cwd: packsRoot,
+        absolute: true,
+        onlyFiles: true,
+    }));
+}
+function stringifyJsonBlock(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return 'Not declared in the pack manifest.';
+    }
+    return `\`\`\`json\n${JSON.stringify(schema, null, 2)}\n\`\`\``;
+}
+function formatScope(scope) {
+    if (scope.type === 'path') {
+        return `\`path ${scope.access} ${scope.pattern}\``;
+    }
+    if (scope.type === 'network') {
+        if (scope.posture === 'allowlist') {
+            const entries = scope.allowlist_entries?.map((entry) => `\`${entry}\``).join(', ') ?? '[]';
+            return `\`network allowlist\` (${entries})`;
+        }
+        return `\`network ${scope.posture}\``;
+    }
+    return `\`${JSON.stringify(scope)}\``;
+}
+function formatApprovals(approvals) {
+    if (approvals.length === 0) {
+        return 'None';
+    }
+    return approvals.map((approval) => `\`${approval}\``).join(', ');
+}
+function buildToolSummaryTable(manifest) {
+    const rows = manifest.tools
+        .map((tool) => {
+        const approvals = formatApprovals(tool.required_approvals ?? []);
+        const scopes = tool.required_scopes.map(formatScope).join('<br />');
+        return `| \`${tool.name}\` | \`${tool.permission}\` | ${approvals} | ${scopes} |`;
+    })
+        .join('\n');
+    return [
+        '## Tool Summary',
+        '',
+        '| Tool | Permission | Required approvals | Required scopes |',
+        '| --- | --- | --- | --- |',
+        rows,
+    ].join('\n');
+}
+function buildToolDetails(manifest) {
+    if (manifest.tools.length === 0) {
+        return '## Tool Details\n\nNo tools are declared in this pack manifest.';
+    }
+    const sections = manifest.tools.map((tool) => [
+        `### \`${tool.name}\``,
+        '',
+        `- Permission: \`${tool.permission}\``,
+        `- Required approvals: ${formatApprovals(tool.required_approvals ?? [])}`,
+        `- Required scopes: ${tool.required_scopes.map(formatScope).join(', ')}`,
+        '',
+        '#### Input schema',
+        '',
+        stringifyJsonBlock(tool.input_schema),
+        '',
+        '#### Output schema',
+        '',
+        stringifyJsonBlock(tool.output_schema),
+    ].join('\n'));
+    return ['## Tool Details', '', ...sections].join('\n\n');
+}
+function asRecord(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${label}: expected an object.`);
+    }
+    return value;
+}
+function asString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${label}: expected a non-empty string.`);
+    }
+    return value;
+}
+function asStringArray(value, label) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${label}: expected an array.`);
+    }
+    return value.map((entry, index) => asString(entry, `${label}[${index}]`));
+}
+function parseScope(input, label) {
+    const scope = asRecord(input, label);
+    const scopeType = asString(scope.type, `${label}.type`);
+    if (scopeType === 'path') {
+        return {
+            type: 'path',
+            pattern: asString(scope.pattern, `${label}.pattern`),
+            access: asString(scope.access, `${label}.access`),
+        };
+    }
+    if (scopeType === 'network') {
+        return {
+            type: 'network',
+            posture: asString(scope.posture, `${label}.posture`),
+            allowlist_entries: asStringArray(scope.allowlist_entries, `${label}.allowlist_entries`),
+        };
+    }
+    throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${label}: unsupported scope type "${scopeType}".`);
+}
+function parseTool(input, label) {
+    const tool = asRecord(input, label);
+    const requiredScopesValue = tool.required_scopes;
+    if (!Array.isArray(requiredScopesValue)) {
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${label}.required_scopes: expected an array.`);
+    }
+    return {
+        name: asString(tool.name, `${label}.name`),
+        permission: asString(tool.permission ?? 'read', `${label}.permission`),
+        required_scopes: requiredScopesValue.map((scope, index) => parseScope(scope, `${label}.required_scopes[${index}]`)),
+        input_schema: tool.input_schema,
+        output_schema: tool.output_schema,
+        required_approvals: asStringArray(tool.required_approvals, `${label}.required_approvals`),
+    };
+}
+function parseManifestRecord(value, manifestPath) {
+    const manifest = asRecord(value, manifestPath);
+    const toolsValue = manifest.tools ?? [];
+    if (!Array.isArray(toolsValue)) {
+        throw createError(ErrorCodes.PARSE_ERROR, `Failed to parse ${manifestPath}: tools must be an array.`);
+    }
+    return {
+        id: asString(manifest.id, `${manifestPath}: id`),
+        tools: toolsValue.map((tool, index) => parseTool(tool, `${manifestPath}: tools[${index}]`)),
+        emitted_event_kinds: asStringArray(manifest.emitted_event_kinds, `${manifestPath}: emitted_event_kinds`),
+        subscribed_event_kinds: asStringArray(manifest.subscribed_event_kinds, `${manifestPath}: subscribed_event_kinds`),
+    };
+}
+function lookupEventDocs(eventKind) {
+    const metadata = SOFTWARE_DELIVERY_EVENT_DOCS[eventKind];
+    if (metadata) {
+        return metadata;
+    }
+    return {
+        payloadShape: 'Manifest-declared kind; typed payload summary is not yet published for this pack.',
+        backpressurePolicy: 'not declared',
+    };
+}
+function buildCodeIndex(projectRoot) {
+    const files = fg.sync(CODE_GLOBS, {
+        cwd: projectRoot,
+        absolute: true,
+        onlyFiles: true,
+        ignore: CODE_IGNORE,
+    });
+    return files
+        .map((filePath) => ({
+        relativePath: relativeToProject(projectRoot, filePath),
+        lines: readFileSync(filePath, UTF8_ENCODING).split('\n'),
+    }))
+        .filter((entry) => entry.relativePath !== EMITTER_DEFINITION_FILE &&
+        entry.relativePath !== GENERATOR_SOURCE_FILE);
+}
+function findEmissionSites(codeIndex, searchTerm) {
+    if (!searchTerm) {
+        return [];
+    }
+    const matches = [];
+    for (const file of codeIndex) {
+        file.lines.forEach((line, index) => {
+            if (line.includes(searchTerm)) {
+                matches.push(`${file.relativePath}:${index + 1}`);
+            }
+        });
+    }
+    return matches;
+}
+function buildEventRows(manifest, codeIndex) {
+    const emittedRows = manifest.emitted_event_kinds.map((kind) => {
+        const metadata = lookupEventDocs(kind);
+        return {
+            kind,
+            direction: 'emitted',
+            payloadShape: metadata.payloadShape,
+            backpressurePolicy: metadata.backpressurePolicy,
+            emissionSites: findEmissionSites(codeIndex, metadata.emissionSearchTerm),
+        };
+    });
+    const subscribedRows = manifest.subscribed_event_kinds.map((kind) => ({
+        kind,
+        direction: 'subscribed',
+        payloadShape: 'Inbound handler surface declared by the pack manifest.',
+        backpressurePolicy: 'handled by subscriber',
+        emissionSites: [],
+    }));
+    return [...emittedRows, ...subscribedRows];
+}
+function renderEmissionSitesTableCell(emissionSites) {
+    if (emissionSites.length === 0) {
+        return 'Not found';
+    }
+    return emissionSites.map((site) => `\`${site}\``).join('<br />');
+}
+function buildEventSummary(rows) {
+    if (rows.length === 0) {
+        return '## Event Summary\n\nNo manifest-declared event kinds for this pack yet.';
+    }
+    const tableRows = rows
+        .map((row) => `| \`${row.kind}\` | \`${row.direction}\` | ${row.payloadShape} | \`${row.backpressurePolicy}\` | ${renderEmissionSitesTableCell(row.emissionSites)} |`)
+        .join('\n');
+    return [
+        '## Event Summary',
+        '',
+        '| Kind | Direction | Payload shape | Backpressure policy | Emission sites |',
+        '| --- | --- | --- | --- | --- |',
+        tableRows,
+    ].join('\n');
+}
+function buildEventDetails(rows) {
+    if (rows.length === 0) {
+        return '';
+    }
+    const sections = rows.map((row) => [
+        `### \`${row.kind}\``,
+        '',
+        `- Direction: \`${row.direction}\``,
+        `- Payload shape: ${row.payloadShape}`,
+        `- Backpressure policy: \`${row.backpressurePolicy}\``,
+        `- Emission sites: ${row.emissionSites.length > 0
+            ? row.emissionSites.map((site) => `\`${site}\``).join(', ')
+            : 'Not found in source scan'}`,
+    ].join('\n'));
+    return ['## Event Details', '', ...sections].join('\n\n');
+}
+function buildGeneratedPageBody(sections) {
+    return sections.filter((section) => section.trim().length > 0).join('\n\n');
+}
+async function formatReferencePageContent(content, pagePath) {
+    const prettierConfig = (await resolvePrettierConfig(pagePath)) ?? {};
+    return formatWithPrettier(content, {
+        ...prettierConfig,
+        filepath: pagePath,
+    });
+}
+function createPageScaffold(title, description) {
+    return [
+        '---',
+        `title: ${title}`,
+        `description: ${description}`,
+        '---',
+        '',
+        `This page is generated by \`${GENERATED_WITH_COMMAND}\`. Add any pack-specific notes outside the managed block below; reruns preserve them.`,
+        '',
+    ].join('\n');
+}
+async function updateReferencePage(options) {
+    const { projectRoot, docsRoot, manifest, section, generatedBody } = options;
+    const titlePrefix = resolvePackTitle(manifest.id);
+    const pageTitle = section === EVENTS_SECTION ? `${titlePrefix} Events` : `${titlePrefix} Tools`;
+    const pageDescription = section === EVENTS_SECTION
+        ? `Auto-generated event reference for the ${titlePrefix} Pack`
+        : `Auto-generated tool catalog for the ${titlePrefix} Pack`;
+    const pagePath = path.join(docsRoot, manifest.id, section, PAGE_FILE_NAME);
+    const relativePath = relativeToProject(projectRoot, pagePath);
+    const fileExisted = existsSync(pagePath);
+    mkdirSync(path.dirname(pagePath), { recursive: true });
+    const existingContent = fileExisted
+        ? readFileSync(pagePath, UTF8_ENCODING)
+        : createPageScaffold(pageTitle, pageDescription);
+    const mergeResult = updateMergeBlock(existingContent, generatedBody);
+    const formattedContent = await formatReferencePageContent(mergeResult.content, pagePath);
+    if (formattedContent === existingContent) {
+        return { relativePath, status: 'unchanged' };
+    }
+    writeFileSync(pagePath, formattedContent, UTF8_ENCODING);
+    return {
+        relativePath,
+        status: fileExisted ? 'updated' : 'created',
+    };
+}
+function pushResult(result, update) {
+    if (update.status === 'created') {
+        result.created.push(update.relativePath);
+        return;
+    }
+    if (update.status === 'updated') {
+        result.updated.push(update.relativePath);
+        return;
+    }
+    result.unchanged.push(update.relativePath);
+}
+export async function generatePackReferenceDocs(options = {}) {
+    const projectRoot = resolveProjectRoot(options.projectRoot);
+    const packsRoot = resolvePacksRoot(projectRoot, options.packsRoot);
+    const docsRoot = resolveDocsRoot(projectRoot, options.docsRoot);
+    const manifestPaths = discoverManifestPaths(packsRoot);
+    const codeIndex = buildCodeIndex(projectRoot);
+    const result = {
+        created: [],
+        updated: [],
+        unchanged: [],
+    };
+    for (const manifestPath of manifestPaths) {
+        const manifest = loadPackManifest(manifestPath);
+        const eventRows = buildEventRows(manifest, codeIndex);
+        const eventsBody = buildGeneratedPageBody([
+            buildEventSummary(eventRows),
+            buildEventDetails(eventRows),
+        ]);
+        const toolsBody = buildGeneratedPageBody([
+            buildToolSummaryTable(manifest),
+            buildToolDetails(manifest),
+        ]);
+        pushResult(result, await updateReferencePage({
+            projectRoot,
+            docsRoot,
+            manifest,
+            section: EVENTS_SECTION,
+            generatedBody: eventsBody,
+        }));
+        pushResult(result, await updateReferencePage({
+            projectRoot,
+            docsRoot,
+            manifest,
+            section: TOOLS_SECTION,
+            generatedBody: toolsBody,
+        }));
+    }
+    return result;
+}
+export async function main(argv = process.argv.slice(2)) {
+    if (argv.includes('--help')) {
+        console.log(formatUsage());
+        return;
+    }
+    if (argv.length > 0) {
+        throw createError(ErrorCodes.INVALID_ARGUMENT, `Unknown option(s): ${argv.join(', ')}\n\n${formatUsage()}`);
+    }
+    const result = await generatePackReferenceDocs();
+    console.log('[docs:generate:pack-reference] Pack reference generation complete.');
+    console.log(`  Created: ${result.created.length}`);
+    console.log(`  Updated: ${result.updated.length}`);
+    console.log(`  Unchanged: ${result.unchanged.length}`);
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=docs-generate-pack-reference.js.map

package/dist/docs-generate-pack-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-generate-pack-reference.js","sourceRoot":"","sources":["../src/docs-generate-pack-reference.ts"],"names":[],"mappings":"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"}

package/dist/docs-sync.js

@@ -18,6 +18,7 @@ import { isMainBranch, isInWorktree } from '@lumenflow/core/core/worktree-guard'
 // WU-2373: Import micro-worktree for isolation on main branch
 import { withMicroWorktree, isInGitWorktree } from '@lumenflow/core/micro-worktree';
 import { SCAFFOLDED_ONBOARDING_TEMPLATE_PATHS } from './onboarding-template-paths.js';
+import { PUBLIC_MANIFEST } from './public-manifest.js';
 import { resolveCliTemplatesDir } from './template-directory-resolver.js';
 import { updateMergeBlock, extractMergeBlock, MARKERS } from './merge-block.js';
 /**
@@ -71,6 +72,119 @@ function resolveDocsSyncDirectories(targetDir) {
 export function getTemplatesDir() {
     return resolveCliTemplatesDir();
 }
+const CANONICAL_COMMAND_DOC_TEMPLATE_PATHS = Object.freeze([
+    'core/ai/onboarding/quick-ref-commands.md.template',
+    'core/ai/onboarding/starting-prompt.md.template',
+]);
+const DOCS_SYNC_MANAGED_ONBOARDING_DEFAULT = true;
+const DOC_COMMAND_ALLOWLIST = new Set([
+    'add',
+    'bootstrap',
+    'build',
+    'build:dist',
+    'changeset',
+    'clean',
+    'create',
+    'dev',
+    'docs:generate',
+    'docs:validate',
+    'format',
+    'format:check',
+    'install',
+    'lint',
+    'pre-release:check',
+    'release',
+    'release:changeset',
+    'setup',
+    'spec:linter',
+    'strict:progress',
+    'test',
+    'typecheck',
+    'update',
+    'version',
+]);
+const PNPM_COMMAND_PATTERN = /\bpnpm\s+([a-z0-9][a-z0-9:-]*)\b/gi;
+const NPX_LUMENFLOW_COMMAND_PATTERN = /\bnpx\s+lumenflow(?:\s+([a-z0-9:-]+))?\b/gi;
+const MARKDOWN_FENCE_PATTERN = /```[a-z0-9-]*\n([\s\S]*?)```/gi;
+const INLINE_CODE_PATTERN = /`([^`\n]+)`/g;
+function buildKnownDocumentedCommandNames() {
+    return new Set([...PUBLIC_MANIFEST.map((command) => command.name), ...DOC_COMMAND_ALLOWLIST]);
+}
+function normalizeDocumentedCommand(rawCommand) {
+    if (rawCommand === 'commands') {
+        return 'lumenflow:commands';
+    }
+    if (rawCommand.includes(':')) {
+        return rawCommand;
+    }
+    return `lumenflow:${rawCommand}`;
+}
+export function extractDocumentedCommandNames(content) {
+    const commands = new Set();
+    const codeSegments = [];
+    let remainingContent = content;
+    for (const match of content.matchAll(MARKDOWN_FENCE_PATTERN)) {
+        const segment = match[1]?.trim();
+        if (segment) {
+            codeSegments.push(segment);
+        }
+        remainingContent = remainingContent.replace(match[0], '\n');
+    }
+    for (const match of remainingContent.matchAll(INLINE_CODE_PATTERN)) {
+        const segment = match[1]?.trim();
+        if (segment) {
+            codeSegments.push(segment);
+        }
+    }
+    for (const segment of codeSegments) {
+        for (const match of segment.matchAll(PNPM_COMMAND_PATTERN)) {
+            const command = match[1]?.trim();
+            if (command) {
+                commands.add(command);
+            }
+        }
+        for (const match of segment.matchAll(NPX_LUMENFLOW_COMMAND_PATTERN)) {
+            const subcommand = match[1]?.trim();
+            commands.add(subcommand ? normalizeDocumentedCommand(subcommand) : 'lumenflow');
+        }
+    }
+    return [...commands];
+}
+export function findUnknownCommandDocReferences(sources) {
+    const knownCommands = buildKnownDocumentedCommandNames();
+    const issues = [];
+    for (const source of sources) {
+        for (const command of extractDocumentedCommandNames(source.content)) {
+            if (!knownCommands.has(command)) {
+                issues.push({
+                    docPath: source.docPath,
+                    command,
+                });
+            }
+        }
+    }
+    return issues;
+}
+function createCommandDocParityError(issues) {
+    const details = issues.map((issue) => `${issue.docPath}: ${issue.command}`).join('; ');
+    const canonicalSources = CANONICAL_COMMAND_DOC_TEMPLATE_PATHS.join(', ');
+    return createError(ErrorCodes.VALIDATION_ERROR, 'Canonical command docs reference unknown CLI commands. ' +
+        `Update the canonical onboarding sources (${canonicalSources}), then run ` +
+        '`pnpm docs:sync` to refresh scaffold-like onboarding copies. ' +
+        `Unknown references: ${details}`);
+}
+export function assertCanonicalCommandDocParity(sources) {
+    const issues = findUnknownCommandDocReferences(sources);
+    if (issues.length > 0) {
+        throw createCommandDocParityError(issues);
+    }
+}
+function loadCanonicalCommandDocSources() {
+    return CANONICAL_COMMAND_DOC_TEMPLATE_PATHS.map((templatePath) => ({
+        docPath: templatePath,
+        content: loadTemplate(templatePath),
+    }));
+}
 /**
  * WU-1124: Load a template file from the bundled templates directory
  * @param templatePath - Relative path from templates directory (e.g., 'core/ai/onboarding/quick-ref-commands.md.template')
@@ -568,13 +682,14 @@ async function shouldUseMicroWorktree(targetDir) {
  * @returns Object with created files list and commit message
  */
 export async function executeDocsSyncInDir(targetDir, options) {
+    assertCanonicalCommandDocParity(loadCanonicalCommandDocSources());
     const selectedVendors = options.vendor === undefined
         ? inferConfiguredVendors(targetDir)
         : resolveSelectedVendors(options.vendor, options.vendors);
     const coreResult = await syncCoreDocs(targetDir, { force: options.force });
     const docsResult = await syncAgentDocs(targetDir, {
         force: options.force,
-        refreshManagedOnboarding: options.refreshManagedOnboarding,
+        refreshManagedOnboarding: options.refreshManagedOnboarding ?? DOCS_SYNC_MANAGED_ONBOARDING_DEFAULT,
     });
     const vendorBootstrapResult = await syncVendorBootstraps(targetDir, {
         force: options.force,