@clearlydev/nx-archweave 0.1.1 → 0.2.1

package/dist/eslint/fsd-boundaries.js

@@ -1,144 +0,0 @@
-import { posix, relative, resolve, sep } from 'node:path';
-const LAYER_ORDER = ['app', 'pages', 'widgets', 'features', 'entities', 'shared'];
-/** Directory name → layer. `_app`/`_pages` are FSD's own Next.js naming (its routers own
- * `app/` and `pages/`). */
-const LAYER_BY_DIR = {
-    app: 'app',
-    _app: 'app',
-    pages: 'pages',
-    _pages: 'pages',
-    widgets: 'widgets',
-    features: 'features',
-    entities: 'entities',
-    shared: 'shared',
-};
-const SLICED_LAYERS = new Set(['pages', 'widgets', 'features', 'entities']);
-const INDEX_FILE = /^index(\.[cm]?[jt]sx?)?$/;
-export function locate(rootRelativePath) {
-    const segments = rootRelativePath.split('/').filter((s) => s.length > 0 && s !== '.');
-    if (segments.length === 0)
-        return null;
-    const layer = LAYER_BY_DIR[segments[0]];
-    if (layer === undefined)
-        return null;
-    const hasUnit = layer !== 'app';
-    const unit = hasUnit ? (segments[1] ?? null) : null;
-    const rest = segments.slice(hasUnit ? 2 : 1);
-    if (rest.length > 0 && INDEX_FILE.test(rest[rest.length - 1]))
-        rest.pop();
-    return { layer, unit, rest };
-}
-/** Pure core: the violation (if any) of `from` importing `to`. */
-export function judge(from, to) {
-    if (LAYER_ORDER.indexOf(to.layer) < LAYER_ORDER.indexOf(from.layer))
-        return { kind: 'upward', from, to };
-    if (to.unit === null)
-        return null; // the app layer, or a bare layer directory — nothing finer to guard
-    const sameUnit = from.layer === to.layer && from.unit === to.unit;
-    if (sameUnit)
-        return null; // inside one slice/segment anything goes
-    const viaCrossImportApi = to.rest[0] === '@x' && to.rest[1] === from.unit && from.layer === to.layer;
-    if (viaCrossImportApi)
-        return null;
-    if (from.layer === to.layer && SLICED_LAYERS.has(to.layer))
-        return { kind: 'cross-slice', from, to };
-    if (to.rest.length > 0)
-        return { kind: 'sidestep', from, to };
-    return null;
-}
-export function describeLocation(location) {
-    return location.unit === null ? location.layer : `${location.layer}/${location.unit}`;
-}
-/** Resolves an import specifier to a path relative to the source root, or null when it is
- * a package specifier or lands outside the root. */
-export function resolveSpecifier(specifier, importerRootRelative, options) {
-    let rootRelative = null;
-    if (specifier.startsWith('./') || specifier.startsWith('../') || specifier === '.' || specifier === '..') {
-        rootRelative = posix.normalize(posix.join(posix.dirname(importerRootRelative), specifier));
-    }
-    else {
-        for (const [prefix, target] of Object.entries(options.aliases)) {
-            if (!specifier.startsWith(prefix))
-                continue;
-            const targetAbsolute = resolve(options.cwd, target);
-            const targetRootRelative = toPosix(relative(options.rootAbsolute, targetAbsolute));
-            rootRelative = posix.normalize(posix.join(targetRootRelative === '' ? '.' : targetRootRelative, specifier.slice(prefix.length)));
-            break;
-        }
-    }
-    if (rootRelative === null)
-        return null;
-    if (rootRelative === '..' || rootRelative.startsWith('../'))
-        return null;
-    return rootRelative;
-}
-function toPosix(path) {
-    return sep === '/' ? path : path.split(sep).join('/');
-}
-export const fsdBoundariesRule = {
-    meta: {
-        type: 'problem',
-        docs: {
-            description: 'Enforce canonical Feature-Sliced Design import rules inside a frontend app',
-            url: 'https://github.com/clearlydev/nx-archweave#fsd-lite',
-        },
-        schema: [
-            {
-                type: 'object',
-                properties: {
-                    root: { type: 'string' },
-                    aliases: { type: 'object', additionalProperties: { type: 'string' } },
-                },
-                additionalProperties: false,
-            },
-        ],
-        messages: {
-            upward: 'FSD: "{{from}}" may not import from "{{to}}" (a higher layer).',
-            crossSlice: 'FSD: "{{from}}" may not import a sibling slice "{{to}}" — move the shared part down a layer, or expose it through "{{to}}/@x/{{fromUnit}}".',
-            sidestep: 'FSD: import "{{to}}" through its public API (index.ts), not its internal file "{{path}}".',
-        },
-    },
-    create(context) {
-        const options = (context.options[0] ?? {});
-        const root = options.root ?? 'src';
-        const aliases = options.aliases ?? { '@/': root };
-        const cwd = context.cwd;
-        const rootAbsolute = resolve(cwd, root);
-        const importerRootRelative = toPosix(relative(rootAbsolute, context.filename));
-        if (importerRootRelative === '' || importerRootRelative.startsWith('..'))
-            return {};
-        const from = locate(importerRootRelative);
-        if (from === null)
-            return {};
-        const check = (node, specifier) => {
-            if (typeof specifier !== 'string')
-                return;
-            const target = resolveSpecifier(specifier, importerRootRelative, { rootAbsolute, cwd, aliases });
-            if (target === null)
-                return;
-            const to = locate(target);
-            if (to === null)
-                return;
-            const violation = judge(from, to);
-            if (violation === null)
-                return;
-            const data = { from: describeLocation(from), to: describeLocation(to), fromUnit: from.unit ?? '', path: target };
-            context.report({
-                node,
-                messageId: violation.kind === 'upward' ? 'upward' : violation.kind === 'cross-slice' ? 'crossSlice' : 'sidestep',
-                data,
-            });
-        };
-        const fromSource = (node) => check(node, node.source?.value);
-        return {
-            ImportDeclaration: fromSource,
-            ExportNamedDeclaration: fromSource,
-            ExportAllDeclaration: fromSource,
-            ImportExpression: (node) => {
-                const argument = node.source;
-                if (argument && argument.type === 'Literal')
-                    check(node, argument.value);
-            },
-        };
-    },
-};

package/dist/eslint/tsconfig-aliases.js

@@ -1,114 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
-/**
- * Import aliases from a tsconfig's `compilerOptions.paths`: every
- * `"<prefix>*": ["<dir>/*"]` entry becomes `{ "<prefix>": "<dir>" }`, the directory relative
- * to `cwd` (what the rule's `aliases` option takes). The `extends` chain is followed
- * (relative paths only — a package preset is skipped), the nearest config winning per key;
- * `baseUrl` of the config that declares the paths resolves the targets. Comments and
- * trailing commas are tolerated, like tsc. Anything unreadable yields nothing: the rule
- * then falls back to its default alias — a wrong alias map costs a missed report, never a
- * false one, so this stays best-effort.
- */
-export function aliasesFromTsconfig({ cwd, tsconfig = 'tsconfig.json', maxDepth = 8 }) {
-    const aliases = {};
-    let current = resolve(cwd, tsconfig);
-    const seen = new Set();
-    for (let depth = 0; current !== null && depth < maxDepth && !seen.has(current); depth++) {
-        seen.add(current);
-        const config = readJsonc(current);
-        if (config === null)
-            break;
-        const compilerOptions = asRecord(config['compilerOptions']);
-        const paths = asRecord(compilerOptions?.['paths']);
-        if (paths) {
-            const baseUrl = typeof compilerOptions?.['baseUrl'] === 'string' ? resolve(dirname(current), compilerOptions['baseUrl']) : dirname(current);
-            for (const [pattern, targets] of Object.entries(paths)) {
-                if (!pattern.endsWith('*'))
-                    continue;
-                const prefix = pattern.slice(0, -1);
-                if (prefix in aliases)
-                    continue; // a nearer config already decided this prefix
-                const target = Array.isArray(targets) ? targets.find((t) => typeof t === 'string') : undefined;
-                if (target === undefined || !target.endsWith('/*'))
-                    continue;
-                const dir = toPosix(relative(cwd, resolve(baseUrl, target.slice(0, -'/*'.length))));
-                aliases[prefix] = dir === '' ? '.' : dir;
-            }
-        }
-        const parent = config['extends'];
-        const parentPath = typeof parent === 'string' ? parent : Array.isArray(parent) ? parent.find((p) => typeof p === 'string') : undefined;
-        current = parentPath !== undefined && (parentPath.startsWith('.') || isAbsolute(parentPath)) ? resolveExtends(dirname(current), parentPath) : null;
-    }
-    return aliases;
-}
-function resolveExtends(fromDir, target) {
-    const candidates = [resolve(fromDir, target), resolve(fromDir, `${target}.json`)];
-    return candidates.find((candidate) => existsSync(candidate)) ?? null;
-}
-function asRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
-}
-function toPosix(path) {
-    return sep === '/' ? path : path.split(sep).join('/');
-}
-/** tsconfig is JSON with comments and trailing commas; strip both outside strings. */
-export function readJsonc(path) {
-    let text;
-    try {
-        text = readFileSync(path, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-    let out = '';
-    let mode = 'code';
-    for (let i = 0; i < text.length; i++) {
-        const c = text[i];
-        const d = text[i + 1];
-        if (mode === 'code') {
-            if (c === '"') {
-                mode = 'string';
-                out += c;
-            }
-            else if (c === '/' && d === '/') {
-                mode = 'line';
-                i++;
-            }
-            else if (c === '/' && d === '*') {
-                mode = 'block';
-                i++;
-            }
-            else {
-                out += c;
-            }
-        }
-        else if (mode === 'string') {
-            out += c;
-            if (c === '\\') {
-                out += d ?? '';
-                i++;
-            }
-            else if (c === '"') {
-                mode = 'code';
-            }
-        }
-        else if (mode === 'line') {
-            if (c === '\n') {
-                mode = 'code';
-                out += c;
-            }
-        }
-        else if (c === '*' && d === '/') {
-            mode = 'code';
-            i++;
-        }
-    }
-    try {
-        const parsed = JSON.parse(out.replace(/,(\s*[}\]])/g, '$1'));
-        return asRecord(parsed);
-    }
-    catch {
-        return null;
-    }
-}

package/dist/generators/add-agent-rules/render.js

@@ -1,46 +0,0 @@
-const ACTION_LINE = {
-    created: (result) => `${result.filePath}: created`,
-    appended: (result) => `${result.filePath}: nx-archweave block added after the existing content (nothing else changed)`,
-    updated: (result) => `${result.filePath}: nx-archweave block updated (nothing outside it changed)`,
-    unchanged: (result) => `${result.filePath}: unchanged`,
-    unrecognized: (result) => `${result.filePath}: not written — ${result.reason ?? 'the nx-archweave markers could not be placed'}`,
-};
-export function renderAddAgentRulesReport(report) {
-    const lines = [];
-    lines.push(report.dryRun ? 'add-agent-rules dry-run — no files were written.' : 'add-agent-rules:');
-    lines.push(`  hosts: ${report.hosts.join(', ')}`);
-    lines.push(`  locale: ${report.locale}`);
-    lines.push(`  teamRules: ${report.teamRules}`);
-    lines.push('');
-    for (const file of report.files) {
-        lines.push(`  ${ACTION_LINE[file.action](file)}`);
-    }
-    const RECORD_LINE = {
-        created: 'toolkit.config.json: aiHosts recorded (file created)',
-        updated: 'toolkit.config.json: aiHosts recorded',
-        unchanged: 'toolkit.config.json: aiHosts already recorded',
-        unrecognized: 'toolkit.config.json: not a JSON object — aiHosts not recorded (fix the file, then rerun)',
-        'not-applied': 'toolkit.config.json: aiHosts not recorded — a file above was not written',
-        'not-requested': null,
-    };
-    const recordLine = RECORD_LINE[report.hostsRecord];
-    if (recordLine !== null)
-        lines.push(`  ${recordLine}`);
-    if (report.files.some((file) => file.action === 'unrecognized')) {
-        lines.push('');
-        lines.push('Manual fix needed: keep exactly one "<!-- nx-archweave:agent-rules start -->" … "<!-- nx-archweave:agent-rules end -->"');
-        lines.push('pair in the file (or remove both markers), then rerun add-agent-rules.');
-    }
-    if (report.dryRun) {
-        lines.push('');
-        lines.push('Generated content preview:');
-        for (const file of report.files) {
-            if (file.content === null)
-                continue;
-            lines.push('');
-            lines.push(`--- ${file.filePath} ---`);
-            lines.push(file.content);
-        }
-    }
-    return lines.join('\n');
-}

package/dist/generators/add-backend/render.js

@@ -1,102 +0,0 @@
-import { packageManagerCommands } from '@nx-archweave/template-engine';
-/** Section body, no header — init prints its own `## add-backend` title and
- * dry-run marker, so the body must not repeat them. */
-export function renderAddBackendBody(report) {
-    const lines = [];
-    if (report.refused === 'no-frontend') {
-        lines.push(`Refused: no frontend application and no "${report.apiName}" app found in this workspace.`);
-        lines.push('  add-backend wires a backend app — beside a frontend, or on its own in a backend-only');
-        lines.push(`  workspace (create one with: npx create-nx-workspace --preset=${report.backend} --appName=${report.apiName}).`);
-        lines.push('  If the backend app has another name, pass --apiName=<its directory name>.');
-        return lines.join('\n');
-    }
-    if (report.refused === 'frontend-not-found') {
-        lines.push(`Refused: --frontendProject "${report.frontendProject}" does not match any project.`);
-        lines.push('  Nothing was written. Check the name with `nx show projects`.');
-        return lines.join('\n');
-    }
-    if (report.refused === 'ambiguous-frontend') {
-        lines.push('Refused: multiple frontend applications found — add-backend will not guess:');
-        for (const name of report.frontendCandidates ?? [])
-            lines.push(`  - ${name}`);
-        lines.push('  Nothing was written. Re-run with --frontendProject=<name> to pick one.');
-        return lines.join('\n');
-    }
-    if (report.refused === 'invalid-project-json') {
-        lines.push('Refused: a project.json this run must update could not be parsed:');
-        for (const path of report.invalidProjects ?? [])
-            lines.push(`  - ${path}`);
-        lines.push('  Nothing was written — fix the JSON, then re-run add-backend.');
-        return lines.join('\n');
-    }
-    if (report.refused === 'missing-api-project') {
-        lines.push(`Refused: no "${report.apiName}" application project found.`);
-        lines.push('  Create it with the official commands first (copy-paste, names already filled in),');
-        lines.push('  then re-run add-backend to wire it up:');
-        lines.push('');
-        for (const command of report.commands ?? [])
-            lines.push(`    ${command}`);
-        if (report.expressRange !== undefined) {
-            lines.push('');
-            lines.push(`  The express line declares express@${report.expressRange}, the range this workspace's @nx/react supports —`);
-            lines.push('  the official generator then keeps it instead of adding express 5, which npm rejects as a peer conflict.');
-        }
-        return lines.join('\n');
-    }
-    if (report.packageManagerNote !== undefined)
-        lines.push(`  note: ${report.packageManagerNote}`);
-    lines.push(`  frontend project: ${report.frontendProject ?? 'none (backend-only workspace)'}`);
-    lines.push(report.sharedTypes === 'created'
-        ? `  libs/shared-types: created (import it as ${report.sharedTypesPackage})`
-        : '  libs/shared-types: already exists — skipped');
-    if (report.config !== undefined && report.config !== 'unchanged') {
-        lines.push(`  toolkit.config.json: backend "${report.backend}" recorded (${report.config}) — doctor's backend checks now run`);
-    }
-    if (report.workspaceGlob !== undefined) {
-        const pmName = report.packageManager ?? 'pnpm';
-        const registry = packageManagerCommands(pmName).workspaceRegistration;
-        lines.push({
-            added: `  ${registry}: 'libs/shared-types' registered — run \`${pmName} install\` once to link it`,
-            present: `  ${registry}: already covers libs/shared-types`,
-            unrecognized: 
-            // an integrated layout lists no workspace packages: the paths alias below links it
-            report.tsconfigPaths === 'added' || report.tsconfigPaths === 'present'
-                ? `  ${registry}: no workspace package list (integrated layout) — the tsconfig paths alias links libs/shared-types`
-                : `  ${registry}: shape not recognized — add 'libs/shared-types' to its workspace list yourself`,
-        }[report.workspaceGlob]);
-    }
-    for (const tag of report.tags) {
-        lines.push(`  tag ${tag.project}: ${tag.action === 'added' ? 'added' : 'already present'}`);
-    }
-    lines.push({
-        added: `  tsconfig.base.json paths: ${report.sharedTypesPackage} added (a classic or integrated setup — libs resolve through paths)`,
-        present: '  tsconfig.base.json paths: already wired',
-        'workspace-link': '  tsconfig paths: not needed — the workspace package link is the wiring',
-        unrecognized: '  tsconfig.base.json: could not be parsed — left untouched',
-    }[report.tsconfigPaths]);
-    switch (report.eslint) {
-        case 'applied':
-            lines.push('  ESLint boundaries: cross-side deny rules written (existing imports stay allowed)');
-            break;
-        case 'already-applied':
-            lines.push('  ESLint boundaries: already enforced — no change');
-            break;
-        case 'degraded-unrecognized':
-            lines.push('  ESLint boundaries: your config was NOT recognized — left untouched.');
-            lines.push('  Merge this yourself (then boundaries are actually enforced):');
-            break;
-        case 'snippet-only':
-            lines.push('  ESLint boundaries: report-only (pass --applyEslint to write them).');
-            lines.push('  Paste-ready snippet:');
-            break;
-    }
-    if (report.snippet) {
-        lines.push('');
-        lines.push(report.snippet);
-    }
-    return lines.join('\n');
-}
-/** Standalone rendering (the add-backend generator's own console output). */
-export function renderAddBackendReport(report, dryRun) {
-    return [`add-backend (${report.backend})${dryRun ? ' — dry run' : ''}`, '', renderAddBackendBody(report)].join('\n');
-}

package/dist/generators/add-fsd-lite/render.js

@@ -1,72 +0,0 @@
-export function renderAddFsdLiteReport(report) {
-    const lines = [];
-    if (report.aborted) {
-        lines.push('add-fsd-lite aborted — nothing was written.');
-        const refusal = report.appRefusal;
-        if (refusal !== null) {
-            lines.push('');
-            lines.push("  FSD layers live inside the frontend app's source root (e.g. apps/web/src), and no app could be picked:");
-            if (refusal.reason === 'project-not-found') {
-                lines.push(`    --project=${refusal.project} names no project in this workspace.`);
-            }
-            else if (refusal.reason === 'ambiguous-frontend') {
-                lines.push('    more than one frontend app was found — rerun with --project=<one of them>:');
-                for (const name of refusal.candidates)
-                    lines.push(`      - ${name}`);
-            }
-            else if (refusal.reason === 'invalid-project-json') {
-                lines.push(`    a project.json could not be parsed (${refusal.detail}) — fix it, then rerun.`);
-            }
-            else {
-                lines.push('    the workspace has no frontend application — create one (e.g. nx g @nx/react:app) or pass --project.');
-            }
-        }
-        return lines.join('\n');
-    }
-    if (report.dryRun) {
-        lines.push('add-fsd-lite dry-run — no files were written.');
-        lines.push('');
-    }
-    lines.push(`FSD layers (in ${report.project}, ${report.sourceRoot}):`);
-    if (report.layerGuide !== null)
-        lines.push(report.layerGuide);
-    lines.push('');
-    const where = report.eslintPath ?? `${report.project}'s eslint.config.mjs`;
-    switch (report.eslint) {
-        case 'applied':
-            lines.push(`ESLint: archweave/fsd-boundaries (${report.enforcement}) written to ${where}`);
-            break;
-        case 'already-applied':
-            lines.push(`ESLint: archweave/fsd-boundaries already wired in ${where} — no change`);
-            break;
-        case 'degraded-unrecognized':
-            lines.push(`ESLint: ${report.eslintPath === null ? `no ESLint config found for ${report.project}` : `${where} was NOT recognized — left untouched`}.`);
-            lines.push('  Add the rule yourself (then the layer rules are actually enforced):');
-            break;
-        case 'snippet-only':
-            lines.push(`ESLint: report-only (pass --applyEslint to write the rule into ${where}).`);
-            break;
-        case 'not-applied':
-            break;
-    }
-    if (report.snippet !== null)
-        lines.push(report.snippet);
-    if (report.steiger !== null) {
-        const st = report.steiger;
-        lines.push('');
-        lines.push('steiger (official FSD linter, opt-in):');
-        lines.push(`  ${st.configPath}: ${st.config === 'created' ? 'created' : st.config === 'unchanged' ? 'unchanged' : 'kept — an existing config with other content is never replaced'}`);
-        lines.push(st.target === 'added'
-            ? `  target ${'fsd-check'}: added to ${st.targetPath}`
-            : st.target === 'present'
-                ? `  target ${'fsd-check'}: already present in ${st.targetPath}`
-                : '  target fsd-check: NOT added — no parseable project.json / package.json for the app');
-        lines.push(st.dependencies === 'added'
-            ? `  devDependencies: steiger + @feature-sliced/steiger-plugin added to package.json — run \`${st.installCommand}\``
-            : st.dependencies === 'present'
-                ? '  devDependencies: already present'
-                : '  devDependencies: NOT added — the root package.json could not be parsed');
-        lines.push(`  run it with: ${st.runCommand}  (steiger needs Node >= 22.18)`);
-    }
-    return lines.join('\n');
-}

package/dist/generators/add-github-templates/render.js

@@ -1,26 +0,0 @@
-const ACTION_LINES = {
-    created: 'created',
-    unchanged: 'unchanged (already matches the generated version)',
-    skipped: 'left as-is (a different file already exists there — never overwritten)',
-};
-export function renderAddGithubTemplatesReport(report) {
-    const lines = [];
-    if (report.files.length === 0) {
-        lines.push('add-github-templates: nothing selected (issue/pr/codeowners all false) — no files to install.');
-        return lines.join('\n');
-    }
-    if (report.dryRun) {
-        lines.push('add-github-templates dry-run — no files were written.');
-        lines.push('');
-        for (const file of report.files) {
-            lines.push(`${file.filePath}:`);
-            lines.push(file.content);
-            lines.push('');
-        }
-        lines.push('Effective decision:');
-    }
-    for (const file of report.files) {
-        lines.push(`  ${file.filePath}: ${ACTION_LINES[file.action]}`);
-    }
-    return lines.join('\n');
-}

package/dist/generators/add-integration/render.js

@@ -1,34 +0,0 @@
-import { renderUserCommand } from '@nx-archweave/integrations';
-export function renderIntegrationPlan(view) {
-    const command = view.plan.officialCommand;
-    const scopeFlag = view.scopeExplicit ? ` --scope=${view.scope}` : '';
-    const lines = [
-        `Integration: ${view.tool}`,
-        `Source repository: ${view.plan.sourceRepository}`,
-        `Official homepage: ${view.plan.officialHomepage}`,
-        `License: ${view.plan.license}`,
-        `Resolved version: ${view.plan.resolvedVersion}`,
-        `Official install method: ${command === null ? 'manual (no scriptable command for this target)' : renderUserCommand(command)}`,
-        ...(command !== null && view.teamMarketplaceCommand !== null
-            ? [`For teammates (project scope), install-integration first declares the marketplace in .claude/settings.json: ${view.teamMarketplaceCommand}`]
-            : []),
-        ...(command === null
-            ? []
-            : [
-                `Run it for you (verifies and records afterwards): ${view.runNx} g @clearlydev/nx-archweave:install-integration --tool=${view.tool} --apply${scopeFlag}`,
-            ]),
-        '',
-        command === null ? 'Manual steps:' : 'Manual alternative (inside a Claude Code session):',
-        ...view.manualSteps.map((step) => `  - ${step}`),
-        '',
-        'Uninstall instructions:',
-        ...view.uninstallSteps.map((step) => `  - ${step}`),
-        '',
-        `Current detection: ${view.detection.installed ? 'installed' : 'not installed'}`,
-        `Current verification: ${view.verification.verified ? 'passed' : 'not verified'}`,
-        ...view.verification.problems.map((problem) => `  ! ${problem}`),
-        '',
-        'Manifest write: none here — install-integration records it after installing; record-integration records an install done elsewhere.',
-    ];
-    return lines.join('\n');
-}

package/dist/generators/add-review/render.js

@@ -1,96 +0,0 @@
-/** Line-level LCS diff — small generated files, no diff library. */
-export function renderLineDiff(existing, generated) {
-    const a = existing.split('\n');
-    const b = generated.split('\n');
-    const m = a.length;
-    const n = b.length;
-    const lcs = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
-    for (let i = m - 1; i >= 0; i--) {
-        for (let j = n - 1; j >= 0; j--) {
-            lcs[i][j] = a[i] === b[j] ? lcs[i + 1][j + 1] + 1 : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
-        }
-    }
-    const out = ['--- existing', '+++ generated'];
-    let i = 0;
-    let j = 0;
-    while (i < m && j < n) {
-        if (a[i] === b[j]) {
-            out.push(`  ${a[i]}`);
-            i++;
-            j++;
-        }
-        else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
-            out.push(`- ${a[i]}`);
-            i++;
-        }
-        else {
-            out.push(`+ ${b[j]}`);
-            j++;
-        }
-    }
-    while (i < m)
-        out.push(`- ${a[i++]}`);
-    while (j < n)
-        out.push(`+ ${b[j++]}`);
-    return out.join('\n');
-}
-const WORKFLOW_ACTION_LINES = {
-    created: 'created',
-    overwritten: 'overwritten with the generated version (per --onConflict=overwrite)',
-    unchanged: 'unchanged (already matches the generated version)',
-    proposed: 'NOT written — differs from the generated version (merge proposal below)',
-    skipped: 'left as-is (per --onConflict=skip)',
-    alternate: 'generated alongside the existing file',
-    aborted: 'NOT written',
-};
-const CONFIG_ACTION_LINES = {
-    created: 'created with the review field',
-    updated: 'review field updated',
-    unchanged: 'review field unchanged',
-    'not-updated': 'NOT updated — kept consistent with the workflow file that is actually in effect',
-    aborted: 'NOT updated',
-};
-export function renderAddReviewReport(report) {
-    const lines = [];
-    if (report.packageManagerNote !== undefined) {
-        lines.push(`Note: ${report.packageManagerNote}`);
-    }
-    if (report.workflowAction === 'aborted') {
-        lines.push('add-review aborted — nothing was written.');
-        lines.push(`  toolkit.config.json: ${report.configError ?? 'unusable'}`);
-        lines.push('  Fix the config file manually, then rerun the generator.');
-        return lines.join('\n');
-    }
-    if (report.dryRun) {
-        lines.push('add-review dry-run — no files were written.');
-        lines.push('');
-        lines.push('Generated workflow YAML:');
-        lines.push(report.workflowYaml ?? '');
-        lines.push('');
-        lines.push('toolkit.config.json review field:');
-        lines.push(report.configSnippetJson ?? '');
-        lines.push('');
-        lines.push('Effective decision:');
-    }
-    lines.push(`  ${report.workflowPath}: ${WORKFLOW_ACTION_LINES[report.workflowAction]}`);
-    lines.push(`  toolkit.config.json: ${CONFIG_ACTION_LINES[report.configAction]}`);
-    if (report.workflowAction === 'proposed' && report.diff) {
-        lines.push('');
-        lines.push(report.diff);
-        lines.push('');
-        lines.push('To resolve, rerun with one of:');
-        lines.push('  --onConflict=overwrite            replace the existing file with the generated version');
-        lines.push('  --onConflict=skip                 keep the existing file');
-        lines.push('  --onConflict=alternate-filename   write the generated version alongside it');
-    }
-    if (report.workflowAction === 'alternate') {
-        lines.push('');
-        lines.push('  Review the generated file, then replace the main workflow file with it yourself;');
-        lines.push('  the config stays pointing at the workflow that is actually in effect until you do.');
-    }
-    lines.push('');
-    lines.push(`Note: the review workflow stays green-skipped until you register the ${report.requiredSecretName} secret.`);
-    lines.push('Note: this workflow runs with elevated permissions only after it is merged to the default branch —');
-    lines.push('merging is the first real validation.');
-    return lines.join('\n');
-}