@shanyucoder/flowgrid 0.1.0

package/dist/codegen/config/project-root.d.ts

@@ -0,0 +1,13 @@
+export type CodegenType = 'fe' | 'be' | 'fullstack';
+export type FeAdapterId = 'nuxt4' | 'nextjs' | 'dotnet-line';
+export type BeAdapterId = 'fastapi' | 'laravel' | 'dotnet-integration' | 'nestjs';
+export type AdapterId = FeAdapterId | BeAdapterId;
+export declare function packageRoot(): string;
+export declare function packageVersion(): string;
+export declare function resolveProjectRoot(explicit?: string): string;
+export declare function resolveType(type?: string): CodegenType;
+export declare function resolveFeAdapter(adapter?: string): FeAdapterId;
+export declare function resolveBeAdapter(adapter?: string): BeAdapterId;
+/** Backward-compatible FE resolver. */
+export declare function resolveAdapter(adapter?: string): FeAdapterId;
+export declare function adapterEngine(adapter: FeAdapterId, kind: 'codegen' | 'unitgen', script: string): string;

package/dist/codegen/config/project-root.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+function envFirst(...keys) {
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+export function packageRoot() {
+    return pkgRoot;
+}
+export function packageVersion() {
+    return JSON.parse(readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'))
+        .version ?? '0.0.0';
+}
+export function resolveProjectRoot(explicit) {
+    const root = path.resolve(explicit ?? envFirst('FLOWGRID_PROJECT_ROOT') ?? process.cwd());
+    if (!existsSync(root))
+        throw new Error(`FlowGrid code project root not found: ${root}`);
+    return root;
+}
+export function resolveType(type) {
+    const value = type ?? envFirst('FLOWGRID_CODE_ROLE') ?? 'fe';
+    if (!['fe', 'be', 'fullstack'].includes(value)) {
+        throw new Error('--type must be fe | be | fullstack (OpenAPI YAML lives on the docs hub)');
+    }
+    return value;
+}
+export function resolveFeAdapter(adapter) {
+    const id = (adapter ??
+        envFirst('FLOWGRID_FE_ADAPTER', 'FLOWGRID_ADAPTER') ??
+        'nuxt4');
+    if (id !== 'nuxt4' && id !== 'nextjs' && id !== 'dotnet-line') {
+        throw new Error('--fe-adapter/--adapter must be nuxt4 | nextjs | dotnet-line');
+    }
+    const dir = path.join(pkgRoot, 'adapters', id);
+    if (!existsSync(dir))
+        throw new Error(`Adapter missing: ${id}`);
+    return id;
+}
+export function resolveBeAdapter(adapter) {
+    const id = (adapter ??
+        envFirst('FLOWGRID_BE_ADAPTER', 'FLOWGRID_ADAPTER') ??
+        'fastapi');
+    if (id !== 'fastapi' && id !== 'laravel' && id !== 'dotnet-integration' && id !== 'nestjs') {
+        throw new Error('--be-adapter/--adapter must be fastapi | laravel | dotnet-integration | nestjs');
+    }
+    const dir = path.join(pkgRoot, 'adapters', id);
+    if (!existsSync(dir))
+        throw new Error(`Adapter missing: ${id}`);
+    return id;
+}
+/** Backward-compatible FE resolver. */
+export function resolveAdapter(adapter) {
+    return resolveFeAdapter(adapter);
+}
+export function adapterEngine(adapter, kind, script) {
+    return path.join(pkgRoot, 'adapters', adapter, kind, 'runners', script);
+}
+//# sourceMappingURL=project-root.js.map

package/dist/codegen/config/project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../../src/codegen/config/project-root.ts"],"names":[],"mappings":"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"}

package/dist/codegen/mcp/tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTools(server: McpServer): void;

package/dist/codegen/mcp/tools.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { resolveBeAdapter, resolveFeAdapter, resolveProjectRoot, } from '../config/project-root.js';
+import { runAdapterEngine, runCommonGen } from '../adapters/run.js';
+import { runBeEngine } from '../adapters/run-be.js';
+import { validateCommonRegistry } from '../registries/common.js';
+function text(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+function commonShape() {
+    return {
+        adapter: z.enum(['nuxt4', 'nextjs', 'dotnet-line']).optional(),
+        projectRoot: z.string().optional(),
+        docsRoot: z.string().optional(),
+        argv: z.array(z.string()).optional(),
+    };
+}
+export function registerTools(server) {
+    const register = (name, description, kind, script, dryRun = false) => {
+        server.tool(name, description, commonShape(), async (input) => {
+            try {
+                const result = runAdapterEngine({
+                    adapter: resolveFeAdapter(input.adapter),
+                    kind,
+                    script,
+                    projectRoot: resolveProjectRoot(input.projectRoot),
+                    docsRoot: input.docsRoot,
+                    argv: input.argv,
+                    dryRun,
+                });
+                return text({
+                    ok: result.status === 0,
+                    status: result.status,
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                });
+            }
+            catch (error) {
+                return text({ ok: false, error: error instanceof Error ? error.message : String(error) });
+            }
+        });
+    };
+    register('codegen_gen', 'Run FE portal codegen for the selected adapter.', 'codegen', 'generate.mjs');
+    register('codegen_gen_dry', 'Dry-run FE portal codegen for the selected adapter.', 'codegen', 'generate.mjs', true);
+    register('unit_gen', 'Run FE unit codegen for the selected adapter.', 'unitgen', 'generate.mjs');
+    register('unit_gen_dry', 'Dry-run FE unit codegen for the selected adapter.', 'unitgen', 'generate.mjs', true);
+    register('codegen_registry_validate', 'Validate FE design/codegen registries.', 'codegen', 'validate-registry.mjs');
+    register('unit_registry_validate', 'Validate FE unit registries.', 'unitgen', 'validate-registry.mjs');
+    const commonGenShape = {
+        adapter: z.enum(['nuxt4', 'nextjs']).optional(),
+        projectRoot: z.string().optional(),
+        docsRoot: z.string().optional(),
+        argv: z.array(z.string()).optional(),
+    };
+    server.tool('common_gen', 'Inventory and stub shared UI from surfaces/<surface>/common or CMP-*/common.', commonGenShape, async (input) => {
+        try {
+            const result = runCommonGen({
+                adapter: resolveFeAdapter(input.adapter),
+                projectRoot: resolveProjectRoot(input.projectRoot),
+                docsRoot: input.docsRoot,
+                argv: input.argv,
+            });
+            return text({
+                ok: result.status === 0,
+                status: result.status,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            });
+        }
+        catch (error) {
+            return text({ ok: false, error: error instanceof Error ? error.message : String(error) });
+        }
+    });
+    server.tool('common_gen_dry', 'Dry-run shared UI inventory for surface or module common (no stub writes).', commonGenShape, async (input) => {
+        try {
+            const result = runCommonGen({
+                adapter: resolveFeAdapter(input.adapter),
+                projectRoot: resolveProjectRoot(input.projectRoot),
+                docsRoot: input.docsRoot,
+                argv: input.argv,
+                dryRun: true,
+            });
+            return text({
+                ok: result.status === 0,
+                status: result.status,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            });
+        }
+        catch (error) {
+            return text({ ok: false, error: error instanceof Error ? error.message : String(error) });
+        }
+    });
+    const registerBe = (name, description, kind, dryRun = false) => {
+        server.tool(name, description, {
+            adapter: z.enum(['fastapi', 'laravel', 'dotnet-integration']).optional(),
+            projectRoot: z.string().optional(),
+            argv: z.array(z.string()).optional(),
+        }, async (input) => {
+            try {
+                const result = runBeEngine({
+                    adapter: resolveBeAdapter(input.adapter),
+                    projectRoot: resolveProjectRoot(input.projectRoot),
+                    kind,
+                    argv: input.argv,
+                    dryRun,
+                });
+                return text({ ok: result.status === 0, ...result });
+            }
+            catch (error) {
+                return text({ ok: false, error: error instanceof Error ? error.message : String(error) });
+            }
+        });
+    };
+    registerBe('api_gen', 'Run backend API generation.', 'codegen');
+    registerBe('api_gen_dry', 'Dry-run backend API generation.', 'codegen', true);
+    registerBe('api_unit_gen', 'Run backend API unit generation.', 'unitgen');
+    registerBe('api_unit_gen_dry', 'Dry-run backend API unit generation.', 'unitgen', true);
+    registerBe('api_registry_validate', 'Validate backend API codegen registry.', 'registry');
+    registerBe('api_unit_registry_validate', 'Validate backend API unit registry.', 'unit-registry');
+    server.tool('common_registry_validate', 'Validate the target common registry and alias references.', {
+        projectRoot: z.string().optional(),
+        registry: z.string().optional(),
+    }, async (input) => {
+        try {
+            return text({
+                ok: true,
+                ...validateCommonRegistry(resolveProjectRoot(input.projectRoot), input.registry),
+            });
+        }
+        catch (error) {
+            return text({
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/codegen/mcp/tools.js.map

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

package/dist/codegen/registries/common.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const commonRegistrySchema: z.ZodObject<{
+    version: z.ZodNumber;
+    description: z.ZodOptional<z.ZodString>;
+    entries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            planned: "planned";
+            implemented: "implemented";
+            deprecated: "deprecated";
+        }>;
+        tag: z.ZodString;
+        kind: z.ZodString;
+        path: z.ZodString;
+        symbol: z.ZodOptional<z.ZodString>;
+        summary: z.ZodString;
+        usedBy: z.ZodArray<z.ZodString>;
+        specRefs: z.ZodArray<z.ZodString>;
+        tests: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    aliasIndex: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$loose>;
+export interface CommonRegistryValidation {
+    path: string;
+    version: number;
+    entries: number;
+    aliases: number;
+}
+export declare function validateCommonRegistry(projectRoot: string, explicitPath?: string): CommonRegistryValidation;

package/dist/codegen/registries/common.js

@@ -0,0 +1,54 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+const commonEntrySchema = z.object({
+    status: z.enum(['planned', 'implemented', 'deprecated']),
+    tag: z.string().min(1),
+    kind: z.string().min(1),
+    path: z.string().min(1),
+    symbol: z.string().min(1).optional(),
+    summary: z.string().min(1),
+    usedBy: z.array(z.string()),
+    specRefs: z.array(z.string()),
+    tests: z.string().min(1).optional(),
+}).passthrough();
+export const commonRegistrySchema = z.object({
+    version: z.number().int().positive(),
+    description: z.string().min(1).optional(),
+    entries: z.record(z.string().min(1), commonEntrySchema),
+    aliasIndex: z.record(z.string().min(1), z.string().min(1)),
+}).passthrough();
+export function validateCommonRegistry(projectRoot, explicitPath) {
+    const registryPath = path.resolve(explicitPath ?? path.join(projectRoot, 'registries', 'common.registry.json'));
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(registryPath, 'utf8'));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Cannot read common registry at ${registryPath}: ${detail}`);
+    }
+    const parsed = commonRegistrySchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
+            .join('\n');
+        throw new Error(`Invalid common registry at ${registryPath}:\n${issues}`);
+    }
+    const errors = [];
+    for (const [alias, id] of Object.entries(parsed.data.aliasIndex)) {
+        if (!parsed.data.entries[id]) {
+            errors.push(`aliasIndex.${alias}: target "${id}" does not exist in entries`);
+        }
+    }
+    if (errors.length) {
+        throw new Error(`Invalid common registry at ${registryPath}:\n${errors.join('\n')}`);
+    }
+    return {
+        path: registryPath,
+        version: parsed.data.version,
+        entries: Object.keys(parsed.data.entries).length,
+        aliases: Object.keys(parsed.data.aliasIndex).length,
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/codegen/registries/common.js.map

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

package/dist/dna/config/project-root.d.ts

@@ -0,0 +1,12 @@
+/** Product hubs only — never MCP tooling packages. */
+export type ProfileType = 'docs' | 'fe' | 'be' | 'monolith' | 'tests';
+export declare const FE_ADAPTERS: readonly ["nuxt4", "nextjs", "dotnet-line"];
+export declare const BE_ADAPTERS: readonly ["fastapi", "laravel", "dotnet-integration"];
+export type FeAdapterId = (typeof FE_ADAPTERS)[number];
+export type BeAdapterId = (typeof BE_ADAPTERS)[number];
+export declare function packageRoot(): string;
+export declare function packageVersion(): string;
+export declare function resolveProjectRoot(explicit?: string): string;
+export declare function resolveType(value?: string): ProfileType;
+export declare function resolveFeAdapter(value?: string): FeAdapterId;
+export declare function resolveBeAdapter(value?: string): BeAdapterId;

package/dist/dna/config/project-root.js

@@ -0,0 +1,41 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+export const FE_ADAPTERS = ['nuxt4', 'nextjs', 'dotnet-line'];
+export const BE_ADAPTERS = ['fastapi', 'laravel', 'dotnet-integration'];
+export function packageRoot() {
+    return root;
+}
+export function packageVersion() {
+    return JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8')).version ?? '0.0.0';
+}
+export function resolveProjectRoot(explicit) {
+    const target = path.resolve(explicit ?? process.env.PLATFORM_DNA_ROOT ?? process.cwd());
+    if (!existsSync(target))
+        throw new Error(`Project root not found: ${target}`);
+    return target;
+}
+const PROFILE_TYPES = ['docs', 'fe', 'be', 'monolith', 'tests'];
+export function resolveType(value) {
+    const type = value ?? 'docs';
+    if (!PROFILE_TYPES.includes(type)) {
+        throw new Error('--type must be docs | fe | be | monolith | tests (docs/code hubs only; not MCP packages)');
+    }
+    return type;
+}
+export function resolveFeAdapter(value) {
+    const adapter = value ?? 'nuxt4';
+    if (!FE_ADAPTERS.includes(adapter)) {
+        throw new Error(`--fe-adapter must be ${FE_ADAPTERS.join(' | ')}`);
+    }
+    return adapter;
+}
+export function resolveBeAdapter(value) {
+    const adapter = value ?? 'fastapi';
+    if (!BE_ADAPTERS.includes(adapter)) {
+        throw new Error(`--be-adapter must be ${BE_ADAPTERS.join(' | ')}`);
+    }
+    return adapter;
+}
+//# sourceMappingURL=project-root.js.map

package/dist/dna/config/project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../../src/dna/config/project-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AAKhF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAA;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAU,CAAA;AAIhF,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OACE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGjE,CAAC,OAAO,IAAI,OAAO,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACvF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAA;IAC7E,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,aAAa,GAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;AAE9E,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,IAAI,GAAG,KAAK,IAAI,MAAM,CAAA;IAC5B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAmB,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAA;IACH,CAAC;IACD,OAAO,IAAmB,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,KAAK,IAAI,OAAO,CAAA;IAChC,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,OAAsB,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,KAAK,IAAI,SAAS,CAAA;IAClC,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,OAAsB,CAAA;AAC/B,CAAC"}

package/dist/dna/profile/detect.d.ts

@@ -0,0 +1,14 @@
+import type { ProfileDefinition } from './manifest.js';
+import type { ProfileType } from '../config/project-root.js';
+export declare function declaredRole(root: string): string | undefined;
+export declare function normalizeRole(role?: string): string | undefined;
+export declare function declaredProfileType(root: string): ProfileType | undefined;
+export declare function validateTarget(opts: {
+    root: string;
+    type: ProfileType;
+    profile: ProfileDefinition;
+    adapter?: string;
+    feAdapter?: string;
+    beAdapter?: string;
+    force?: boolean;
+}): void;

package/dist/dna/profile/detect.js

@@ -0,0 +1,159 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+export function declaredRole(root) {
+    const file = path.join(root, 'platform-repos.json');
+    if (!existsSync(file))
+        return undefined;
+    try {
+        const data = JSON.parse(readFileSync(file, 'utf8'));
+        return Object.values(data.projects ?? {}).find((project) => project.root === '.')?.role;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function normalizeRole(role) {
+    if (!role)
+        return undefined;
+    return {
+        frontend: 'fe',
+        portal: 'fe',
+        client: 'fe',
+        backend: 'be',
+        api: 'be',
+        fullstack: 'monolith',
+        mono: 'monolith',
+        test: 'tests',
+        plans: 'tests',
+    }[role] ?? role;
+}
+export function declaredProfileType(root) {
+    const role = normalizeRole(declaredRole(root));
+    return role === 'docs' ||
+        role === 'fe' ||
+        role === 'be' ||
+        role === 'monolith' ||
+        role === 'tests'
+        ? role
+        : undefined;
+}
+function hasDotnetMarker(root) {
+    try {
+        return readdirSync(root).some((name) => name.endsWith('.sln') || name.endsWith('.csproj'));
+    }
+    catch {
+        return false;
+    }
+}
+function markerPresent(root, marker) {
+    if (marker.includes('*')) {
+        const suffix = marker.replace(/^\*/, '');
+        try {
+            return readdirSync(root).some((name) => name.endsWith(suffix));
+        }
+        catch {
+            return false;
+        }
+    }
+    return existsSync(path.join(root, marker));
+}
+function validateFeAdapter(root, adapter, force) {
+    if (adapter === 'dotnet-line') {
+        if (!hasDotnetMarker(root) && !force) {
+            throw new Error('Selected dotnet-line, but no .sln/.csproj found; pass --force only for a new base');
+        }
+        return;
+    }
+    const expected = adapter === 'nuxt4'
+        ? ['nuxt.config.ts', 'nuxt.config.js']
+        : ['next.config.ts', 'next.config.js', 'next.config.mjs'];
+    if (!expected.some((file) => existsSync(path.join(root, file))) && !force) {
+        throw new Error(`Selected ${adapter}, but no ${expected.join(' or ')} found; pass --force only for a new base`);
+    }
+}
+function validateBeAdapter(root, adapter, force) {
+    if (adapter === 'dotnet-integration') {
+        if (!hasDotnetMarker(root) && !force) {
+            throw new Error('Selected dotnet-integration, but no .sln/.csproj found; pass --force only for a new base');
+        }
+        return;
+    }
+    if (adapter === 'fastapi') {
+        const pyproject = path.join(root, 'pyproject.toml');
+        if (!existsSync(pyproject) && !force) {
+            throw new Error('Selected fastapi, but pyproject.toml is missing');
+        }
+        if (existsSync(pyproject) &&
+            !/\bfastapi\b/i.test(readFileSync(pyproject, 'utf8')) &&
+            !force) {
+            throw new Error('Selected fastapi, but pyproject.toml does not declare FastAPI');
+        }
+        return;
+    }
+    if (adapter === 'laravel') {
+        const roots = [root, path.join(root, 'src')];
+        const laravelRoot = roots.find((candidate) => existsSync(path.join(candidate, 'artisan')) &&
+            existsSync(path.join(candidate, 'composer.json')));
+        if (!laravelRoot && !force) {
+            throw new Error('Selected laravel, but artisan + composer.json are missing at root or src/');
+        }
+        if (laravelRoot && !force) {
+            const composer = JSON.parse(readFileSync(path.join(laravelRoot, 'composer.json'), 'utf8'));
+            const dependencies = {
+                ...(composer.require ?? {}),
+                ...(composer['require-dev'] ?? {}),
+            };
+            if (!dependencies['laravel/framework']) {
+                throw new Error('Selected laravel, but composer.json does not require laravel/framework');
+            }
+            if (!dependencies['nwidart/laravel-modules']) {
+                throw new Error('FlowGrid Laravel adapter requires nwidart/laravel-modules (modules-v1)');
+            }
+        }
+    }
+}
+export function validateTarget(opts) {
+    if (existsSync(path.join(opts.root, 'mcp-package.json')) && !opts.force) {
+        throw new Error('Target looks like an MCP package (mcp-package.json present); Platform DNA installs only into docs/fe/be/monolith/tests hubs — not into MCP tooling repos');
+    }
+    const role = normalizeRole(declaredRole(opts.root));
+    if (role === 'tooling' && !opts.force) {
+        throw new Error('Repository declares role=tooling; Platform DNA does not install into MCP tooling repos');
+    }
+    if (role && role !== opts.type && !opts.force) {
+        throw new Error(`Repository declares role=${role}, not ${opts.type}; use the correct --type or explicit --force`);
+    }
+    if (opts.type === 'monolith') {
+        const feAdapter = opts.feAdapter;
+        const beAdapter = opts.beAdapter;
+        if (!feAdapter)
+            throw new Error('--fe-adapter is required for --type=monolith');
+        if (!beAdapter)
+            throw new Error('--be-adapter is required for --type=monolith');
+        if (!opts.profile.feAdapters?.includes(feAdapter)) {
+            throw new Error(`--fe-adapter for monolith must be ${opts.profile.feAdapters?.join(' | ')}`);
+        }
+        if (!opts.profile.beAdapters?.includes(beAdapter)) {
+            throw new Error(`--be-adapter for monolith must be ${opts.profile.beAdapters?.join(' | ')}`);
+        }
+        validateFeAdapter(opts.root, feAdapter, opts.force);
+        validateBeAdapter(opts.root, beAdapter, opts.force);
+    }
+    else if (opts.profile.requiresAdapter) {
+        if (!opts.adapter)
+            throw new Error(`--adapter is required for --type=${opts.type}`);
+        if (!opts.profile.adapters?.includes(opts.adapter)) {
+            throw new Error(`--adapter for ${opts.type} must be ${opts.profile.adapters?.join(' | ')}`);
+        }
+        if (opts.type === 'fe')
+            validateFeAdapter(opts.root, opts.adapter, opts.force);
+        if (opts.type === 'be')
+            validateBeAdapter(opts.root, opts.adapter, opts.force);
+    }
+    const markerFound = opts.profile.repoMarkers.length === 0 ||
+        opts.profile.repoMarkers.some((marker) => markerPresent(opts.root, marker));
+    if (!markerFound && !role && !opts.force) {
+        throw new Error(`Repository does not look like a ${opts.type} base (expected one of: ${opts.profile.repoMarkers.join(', ')}); use --force only for a new empty base`);
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/dna/profile/detect.js.map

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

package/dist/dna/profile/manifest.d.ts

@@ -0,0 +1,17 @@
+import { type ProfileType } from '../config/project-root.js';
+export interface ProfileDefinition {
+    repoMarkers: string[];
+    requiresAdapter?: boolean;
+    /** Single-lane adapters (fe or be). */
+    adapters?: string[];
+    /** Monolith FE adapter list. */
+    feAdapters?: string[];
+    /** Monolith BE adapter list. */
+    beAdapters?: string[];
+    ownedSkills?: string[];
+}
+export interface ProfilesManifest {
+    schemaVersion: 1;
+    profiles: Record<ProfileType, ProfileDefinition>;
+}
+export declare function loadProfiles(): ProfilesManifest;

package/dist/dna/profile/manifest.js

@@ -0,0 +1,10 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { packageRoot } from '../config/project-root.js';
+export function loadProfiles() {
+    const manifest = JSON.parse(readFileSync(path.join(packageRoot(), 'profiles.json'), 'utf8'));
+    if (manifest.schemaVersion !== 1)
+        throw new Error('Unsupported profiles.json schemaVersion');
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/dna/profile/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/dna/profile/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAoB,MAAM,2BAA2B,CAAA;AAmBzE,MAAM,UAAU,YAAY;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAC5C,CAAA;IACrB,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5F,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/docs/cli/engines.d.ts

@@ -0,0 +1,13 @@
+export type EngineName = 'split' | 'merge' | 'check' | 'split_all' | 'normalize' | 'render' | 'publish' | 'legacy_validate' | 'extract_i18n' | 'openapi_render' | 'openapi_build_ui' | 'openapi_gen';
+export interface EngineResult {
+    ok: boolean;
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    command: string[];
+    cwd: string;
+}
+export declare function runEngine(name: EngineName, args: string[], opts?: {
+    cwd?: string;
+    extraArgs?: string[];
+}): Promise<EngineResult>;