@dewtech/dare-cli 2.17.0 → 3.1.0

package/dist/stacks/rust-axum/__tests__/scaffold.spec.js

@@ -0,0 +1,203 @@
+// SPDX-License-Identifier: MIT
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'fs-extra';
+import { rust_axum } from '../scaffold.js';
+import { DARE_DNA } from '../../types.js';
+let tmpRoot;
+let appDir;
+let result;
+beforeAll(async () => {
+    tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'axum-scaffold-'));
+    appDir = path.join(tmpRoot, 'my-api');
+    await fs.ensureDir(appDir);
+    result = await rust_axum.generate({
+        dir: appDir,
+        projectName: 'my-api',
+        toolchain: 'auto',
+        features: new Set(DARE_DNA),
+        isMonorepo: false,
+    });
+});
+afterAll(async () => {
+    if (tmpRoot)
+        await fs.remove(tmpRoot);
+});
+describe('rust-axum scaffold', () => {
+    describe('metadata', () => {
+        it('id is rust-axum, backend, stable', () => {
+            expect(rust_axum.id).toBe('rust-axum');
+            expect(rust_axum.category).toBe('backend');
+            expect(rust_axum.status).toBe('stable');
+        });
+    });
+    describe('filesWritten', () => {
+        it('emits ≥ 25 files', () => {
+            expect(result.filesWritten.length).toBeGreaterThanOrEqual(25);
+        });
+        it.each([
+            'Cargo.toml',
+            '.env.example',
+            'llms.txt',
+            'openapi.json',
+            'README.md',
+            'src/main.rs',
+            'src/lib.rs',
+            'src/config.rs',
+            'src/errors.rs',
+            'src/handlers/auth.rs',
+            'src/handlers/users.rs',
+            'src/handlers/ws.rs',
+            'src/services/auth_service.rs',
+            'src/services/user_service.rs',
+            'src/repositories/user_repository.rs',
+            'src/models/user.rs',
+            'src/middleware/auth.rs',
+            'src/middleware/rate_limit.rs',
+            'src/llm/provider.rs',
+            'migrations/0001_create_users.sql',
+            'tests/integration_test.rs',
+            '.dare/skills.yml',
+            '.github/workflows/dare-ci.yml',
+        ])('writes anchor %s', (anchor) => {
+            expect(result.filesWritten).toContain(anchor);
+        });
+    });
+    describe('Cargo.toml', () => {
+        let toml;
+        beforeAll(async () => {
+            toml = await fs.readFile(path.join(appDir, 'Cargo.toml'), 'utf8');
+        });
+        it('uses crateName (underscore form of projectName)', () => {
+            expect(toml).toContain('name = "my_api"');
+        });
+        it('declares axum + tokio + tower-http + tower_governor', () => {
+            expect(toml).toContain('axum = ');
+            expect(toml).toContain('tokio = ');
+            expect(toml).toContain('tower-http');
+            expect(toml).toContain('tower_governor');
+        });
+        it('declares utoipa for OpenAPI', () => {
+            expect(toml).toContain('utoipa');
+        });
+        it('declares jsonwebtoken + argon2', () => {
+            expect(toml).toContain('jsonwebtoken');
+            expect(toml).toContain('argon2');
+        });
+        it('declares sqlx with postgres + migrate features', () => {
+            expect(toml).toContain('sqlx');
+            expect(toml).toContain('postgres');
+            expect(toml).toContain('migrate');
+        });
+        it('declares async-trait for LLM trait dyn-compat', () => {
+            expect(toml).toContain('async-trait');
+        });
+    });
+    describe('main.rs wires invariants', () => {
+        let main;
+        beforeAll(async () => {
+            main = await fs.readFile(path.join(appDir, 'src/main.rs'), 'utf8');
+        });
+        it('mounts auth + users + ws routes', () => {
+            expect(main).toContain('"/auth/login"');
+            expect(main).toContain('"/auth/me"');
+            expect(main).toContain('"/users"');
+            expect(main).toContain('"/ws"');
+            expect(main).toContain('"/openapi.json"');
+        });
+        it('applies rate limit (with_rate_limit) + CORS layers', () => {
+            expect(main).toContain('with_rate_limit');
+            expect(main).toContain('cors');
+        });
+        it('runs sqlx migrate on boot', () => {
+            expect(main).toContain('sqlx::migrate!');
+        });
+        it('uses tracing_subscriber for structured logs', () => {
+            expect(main).toContain('tracing_subscriber');
+        });
+    });
+    describe('Layered Design', () => {
+        it('handlers never call sqlx directly', async () => {
+            const auth = await fs.readFile(path.join(appDir, 'src/handlers/auth.rs'), 'utf8');
+            const users = await fs.readFile(path.join(appDir, 'src/handlers/users.rs'), 'utf8');
+            expect(auth).not.toContain('sqlx::');
+            expect(users).not.toContain('sqlx::');
+        });
+        it('repository owns all sqlx queries', async () => {
+            const repo = await fs.readFile(path.join(appDir, 'src/repositories/user_repository.rs'), 'utf8');
+            expect(repo).toContain('sqlx::query_as');
+            expect(repo).toContain('SELECT');
+        });
+        it('services orchestrate (no SQL strings)', async () => {
+            const svc = await fs.readFile(path.join(appDir, 'src/services/user_service.rs'), 'utf8');
+            expect(svc).not.toMatch(/\bSELECT\b/);
+            expect(svc).not.toMatch(/\bINSERT\b/);
+        });
+    });
+    describe('Migration', () => {
+        it('creates users table with UNIQUE email + index', async () => {
+            const sql = await fs.readFile(path.join(appDir, 'migrations/0001_create_users.sql'), 'utf8');
+            expect(sql).toContain('CREATE TABLE');
+            expect(sql).toContain('users');
+            expect(sql).toContain('UNIQUE');
+            expect(sql).toContain('ix_users_email');
+        });
+    });
+    describe('Rate limit middleware', () => {
+        it('uses tower_governor with env knobs', async () => {
+            const rl = await fs.readFile(path.join(appDir, 'src/middleware/rate_limit.rs'), 'utf8');
+            expect(rl).toContain('GovernorConfigBuilder');
+            expect(rl).toContain('per_second');
+            expect(rl).toContain('burst_size');
+        });
+    });
+    describe('LLM abstraction', () => {
+        it('LlmProvider trait + Dummy + OpenAi impls', async () => {
+            const p = await fs.readFile(path.join(appDir, 'src/llm/provider.rs'), 'utf8');
+            expect(p).toContain('trait LlmProvider');
+            expect(p).toContain('struct DummyProvider');
+            expect(p).toContain('struct OpenAiProvider');
+        });
+    });
+    describe('DNA emission', () => {
+        it('reports all 7 DNA artifacts', () => {
+            expect([...result.dnaEmitted].sort()).toEqual([...DARE_DNA].sort());
+        });
+        it('llms.txt is substantive', async () => {
+            const llms = await fs.readFile(path.join(appDir, 'llms.txt'), 'utf8');
+            expect(llms.length).toBeGreaterThan(400);
+            expect(llms).toMatch(/^#\s+my-api/m);
+        });
+        it('.env.example placeholders pass secret scan', async () => {
+            const env = await fs.readFile(path.join(appDir, '.env.example'), 'utf8');
+            for (const line of env.split('\n')) {
+                const t = line.trim();
+                if (!t || t.startsWith('#'))
+                    continue;
+                const v = t.split('=', 2)[1] ?? '';
+                expect(v).not.toMatch(/[A-Za-z0-9+/]{40,}={0,2}/);
+                expect(v).not.toMatch(/[a-f0-9]{32,}/);
+            }
+        });
+        it('dare-ci.yml has audit/lint/test with cargo audit + clippy + cargo test', async () => {
+            const ci = await fs.readFile(path.join(appDir, '.github/workflows/dare-ci.yml'), 'utf8');
+            expect(ci).toMatch(/^\s*audit:/m);
+            expect(ci).toMatch(/^\s*lint:/m);
+            expect(ci).toMatch(/^\s*test:/m);
+            expect(ci).toContain('cargo audit');
+            expect(ci).toContain('clippy');
+            expect(ci).toContain('cargo test');
+            expect(ci).toContain('-D warnings');
+        });
+    });
+    describe('postInstallSteps', () => {
+        it('includes sqlx migrate + cargo run', () => {
+            const j = result.postInstallSteps.join('\n');
+            expect(j).toContain('cd my-api');
+            expect(j).toContain('sqlx');
+            expect(j).toContain('cargo run');
+        });
+    });
+});
+//# sourceMappingURL=scaffold.spec.js.map

package/dist/stacks/rust-axum/__tests__/scaffold.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.spec.js","sourceRoot":"","sources":["../../../../src/stacks/rust-axum/__tests__/scaffold.spec.ts"],"names":[],"mappings":"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"}

package/dist/stacks/rust-axum/scaffold.d.ts

@@ -0,0 +1,3 @@
+import type { StackScaffold } from '../types.js';
+export declare const rust_axum: StackScaffold;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/stacks/rust-axum/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/stacks/rust-axum/scaffold.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,aAAa,CAAC;AAkDrB,eAAO,MAAM,SAAS,EAAE,aAwDvB,CAAC"}

package/dist/stacks/rust-axum/scaffold.js

@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: MIT
+/**
+ * T-033 — rust-axum scaffolder.
+ *
+ * Produces a Layered Design Axum 0.7 API with:
+ *   - Tokio runtime
+ *   - tower-http (CORS, trace) + tower-governor (rate limit)
+ *   - utoipa for OpenAPI 3.x
+ *   - jsonwebtoken + argon2 for auth
+ *   - sqlx + Postgres + migrations
+ *   - axum::extract::ws for WebSocket
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'fs-extra';
+import { DARE_DNA } from '../types.js';
+import { emit } from '../dna-emitter.js';
+import { detectEngine, renderToFile } from '../template-engine.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TEMPLATES_DIR = path.resolve(__dirname, '..', '..', '..', 'templates', 'stacks', 'rust-axum');
+const TEMPLATE_FILES = [
+    { template: 'Cargo.toml.tera', dest: 'Cargo.toml' },
+    { template: 'gitignore', dest: '.gitignore' },
+    { template: '.env.example', dest: '.env.example' },
+    { template: 'README.md.tera', dest: 'README.md' },
+    { template: 'llms.txt.tera', dest: 'llms.txt' },
+    { template: 'openapi.json.tera', dest: 'openapi.json' },
+    { template: 'src/main.rs.tera', dest: 'src/main.rs' },
+    { template: 'src/lib.rs', dest: 'src/lib.rs' },
+    { template: 'src/config.rs', dest: 'src/config.rs' },
+    { template: 'src/errors.rs', dest: 'src/errors.rs' },
+    { template: 'src/handlers/mod.rs', dest: 'src/handlers/mod.rs' },
+    { template: 'src/handlers/auth.rs', dest: 'src/handlers/auth.rs' },
+    { template: 'src/handlers/users.rs', dest: 'src/handlers/users.rs' },
+    { template: 'src/handlers/ws.rs', dest: 'src/handlers/ws.rs' },
+    { template: 'src/services/mod.rs', dest: 'src/services/mod.rs' },
+    { template: 'src/services/auth_service.rs', dest: 'src/services/auth_service.rs' },
+    { template: 'src/services/user_service.rs', dest: 'src/services/user_service.rs' },
+    { template: 'src/repositories/mod.rs', dest: 'src/repositories/mod.rs' },
+    { template: 'src/repositories/user_repository.rs', dest: 'src/repositories/user_repository.rs' },
+    { template: 'src/models/mod.rs', dest: 'src/models/mod.rs' },
+    { template: 'src/models/user.rs', dest: 'src/models/user.rs' },
+    { template: 'src/middleware/mod.rs', dest: 'src/middleware/mod.rs' },
+    { template: 'src/middleware/auth.rs', dest: 'src/middleware/auth.rs' },
+    { template: 'src/middleware/rate_limit.rs', dest: 'src/middleware/rate_limit.rs' },
+    { template: 'src/llm/mod.rs', dest: 'src/llm/mod.rs' },
+    { template: 'src/llm/provider.rs', dest: 'src/llm/provider.rs' },
+    { template: 'migrations/0001_create_users.sql', dest: 'migrations/0001_create_users.sql' },
+    { template: 'tests/integration_test.rs.tera', dest: 'tests/integration_test.rs' },
+    { template: '.dare/skills.yml', dest: '.dare/skills.yml' },
+    { template: '.github/workflows/dare-ci.yml', dest: '.github/workflows/dare-ci.yml' },
+];
+export const rust_axum = {
+    id: 'rust-axum',
+    label: '🦀 Rust / Axum',
+    category: 'backend',
+    status: 'stable',
+    async generate(opts) {
+        const vars = {
+            projectName: opts.projectName,
+            crateName: opts.projectName.replace(/-/g, '_'),
+            llmProvider: opts.llm?.providers[0]?.id ?? 'dummy',
+            isMonorepo: opts.isMonorepo,
+        };
+        const filesWritten = [];
+        for (const { template, dest } of TEMPLATE_FILES) {
+            const templatePath = path.join(TEMPLATES_DIR, template);
+            const engine = detectEngine(template);
+            await renderToFile({
+                templatePath,
+                engine,
+                vars,
+                baseDir: opts.dir,
+                destPath: dest,
+            });
+            filesWritten.push(dest);
+        }
+        const dnaEmitted = new Set(DARE_DNA);
+        const envPath = path.join(opts.dir, '.env.example');
+        const envContent = await fs.readFile(envPath, 'utf8');
+        await emit({
+            dir: opts.dir,
+            projectName: opts.projectName,
+            stackId: 'rust-axum',
+            artifact: 'env-example',
+            targetPath: '.env.example',
+            content: envContent,
+        });
+        return {
+            filesWritten: [...filesWritten].sort(),
+            postInstallSteps: [
+                `cd ${opts.projectName}`,
+                'cp .env.example .env',
+                'docker compose up -d postgres',
+                'sqlx database create',
+                'sqlx migrate run',
+                'cargo run',
+            ],
+            warnings: [],
+            dnaEmitted,
+        };
+    },
+};
+//# sourceMappingURL=scaffold.js.map

package/dist/stacks/rust-axum/scaffold.js.map

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

package/dist/stacks/template-engine.d.ts

@@ -0,0 +1,38 @@
+export type TemplateEngine = 'handlebars' | 'nunjucks' | 'mustache' | 'raw';
+export interface RenderOpts {
+    /** Absolute path to template file. */
+    readonly templatePath: string;
+    readonly engine: TemplateEngine;
+    readonly vars: Readonly<Record<string, unknown>>;
+}
+export declare class TemplateNotFoundError extends Error {
+    readonly templatePath: string;
+    constructor(templatePath: string);
+}
+export declare class TemplateRenderError extends Error {
+    readonly templatePath: string;
+    readonly engine: TemplateEngine;
+    readonly cause: unknown;
+    constructor(templatePath: string, engine: TemplateEngine, cause: unknown);
+}
+/**
+ * Detects engine from file extension.
+ * Unknown extensions → 'raw'.
+ */
+export declare function detectEngine(templatePath: string): TemplateEngine;
+/**
+ * Renders a template to a string.
+ *
+ * Throws TemplateNotFoundError when the file doesn't exist,
+ * TemplateRenderError on parse/runtime failure (e.g. missing var).
+ */
+export declare function render(opts: RenderOpts): Promise<string>;
+/**
+ * Convenience helper: render and write to disk under baseDir/destPath.
+ * Creates parent dirs.
+ */
+export declare function renderToFile(opts: RenderOpts & {
+    destPath: string;
+    baseDir: string;
+}): Promise<void>;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/stacks/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/stacks/template-engine.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,YAAY,EAAE,MAAM,CAAC;gBACzB,YAAY,EAAE,MAAM;CAKjC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,MAAM,EAAE,cAAc,CAAC;IACvC,SAAgB,KAAK,EAAE,OAAO,CAAC;gBACnB,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO;CASzE;AAaD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAmBjE;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC9D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/stacks/template-engine.js

@@ -0,0 +1,134 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Template engine dispatcher.
+ *
+ * Templates per stack live in `packages/cli/templates/stacks/<id>/`.
+ * File extension picks the engine:
+ *   .hbs / .handlebars → handlebars
+ *   .j2 / .jinja2 / .tera / .erb → nunjucks (Jinja-compatible dialect)
+ *   .mustache → mustache
+ *   anything else → raw (copy byte-for-byte)
+ *
+ * Var-faltante: throws (Nunjucks via throwOnUndefined; Handlebars via strict
+ * mode; Mustache silently produces empty so we wrap with a pre-check).
+ */
+import path from 'node:path';
+import fs from 'fs-extra';
+import Handlebars from 'handlebars';
+import nunjucks from 'nunjucks';
+import Mustache from 'mustache';
+export class TemplateNotFoundError extends Error {
+    constructor(templatePath) {
+        super(`Template not found: ${templatePath}`);
+        this.name = 'TemplateNotFoundError';
+        this.templatePath = templatePath;
+    }
+}
+export class TemplateRenderError extends Error {
+    constructor(templatePath, engine, cause) {
+        super(`Failed to render '${templatePath}' (${engine}): ${cause?.message ?? cause}`);
+        this.name = 'TemplateRenderError';
+        this.templatePath = templatePath;
+        this.engine = engine;
+        this.cause = cause;
+    }
+}
+// ─── Engine setup ──────────────────────────────────────────────────────────
+// Shared Nunjucks env. autoescape=false because outputs are source code, not HTML.
+// throwOnUndefined=true so missing vars fail fast instead of silently producing "".
+const nunjucksEnv = new nunjucks.Environment(null, {
+    autoescape: false,
+    throwOnUndefined: true,
+});
+// ─── Public API ────────────────────────────────────────────────────────────
+/**
+ * Detects engine from file extension.
+ * Unknown extensions → 'raw'.
+ */
+export function detectEngine(templatePath) {
+    const lower = templatePath.toLowerCase();
+    if (lower.endsWith('.hbs') ||
+        lower.endsWith('.handlebars') ||
+        lower.endsWith('.tpl')) {
+        return 'handlebars';
+    }
+    if (lower.endsWith('.j2') ||
+        lower.endsWith('.jinja2') ||
+        lower.endsWith('.tera') ||
+        lower.endsWith('.erb')) {
+        return 'nunjucks';
+    }
+    if (lower.endsWith('.mustache'))
+        return 'mustache';
+    return 'raw';
+}
+/**
+ * Renders a template to a string.
+ *
+ * Throws TemplateNotFoundError when the file doesn't exist,
+ * TemplateRenderError on parse/runtime failure (e.g. missing var).
+ */
+export async function render(opts) {
+    if (!(await fs.pathExists(opts.templatePath))) {
+        throw new TemplateNotFoundError(opts.templatePath);
+    }
+    const source = await fs.readFile(opts.templatePath, 'utf8');
+    switch (opts.engine) {
+        case 'raw':
+            return source;
+        case 'handlebars':
+            try {
+                const tpl = Handlebars.compile(source, { strict: true, noEscape: true });
+                return tpl(opts.vars);
+            }
+            catch (cause) {
+                throw new TemplateRenderError(opts.templatePath, 'handlebars', cause);
+            }
+        case 'nunjucks':
+            try {
+                return nunjucksEnv.renderString(source, { ...opts.vars });
+            }
+            catch (cause) {
+                throw new TemplateRenderError(opts.templatePath, 'nunjucks', cause);
+            }
+        case 'mustache': {
+            // Mustache is intentionally lax — but we want missing-var to throw to
+            // match the strictness of Handlebars/Nunjucks. We pre-scan tags.
+            try {
+                assertAllMustacheVarsProvided(source, opts.vars);
+                return Mustache.render(source, opts.vars);
+            }
+            catch (cause) {
+                throw new TemplateRenderError(opts.templatePath, 'mustache', cause);
+            }
+        }
+    }
+}
+/**
+ * Convenience helper: render and write to disk under baseDir/destPath.
+ * Creates parent dirs.
+ */
+export async function renderToFile(opts) {
+    const rendered = await render(opts);
+    const abs = path.join(opts.baseDir, opts.destPath);
+    await fs.ensureDir(path.dirname(abs));
+    await fs.writeFile(abs, rendered, 'utf8');
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function assertAllMustacheVarsProvided(source, vars) {
+    // Mustache tags: {{name}}, {{&name}}, {{{name}}}, {{#name}}...{{/name}}, etc.
+    // We scan for simple {{name}} and {{&name}} references.
+    const re = /\{\{[#^/&]?\s*([A-Za-z_][A-Za-z0-9_.]*)\s*\}\}/g;
+    const seen = new Set();
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const top = m[1].split('.')[0];
+        if (top === '.')
+            continue; // implicit iterator
+        if (!seen.has(top) && !(top in vars)) {
+            throw new Error(`Mustache var '${top}' not provided`);
+        }
+        seen.add(top);
+    }
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/stacks/template-engine.js.map

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

package/dist/stacks/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Core contract for stack scaffolders (v3.1).
+ *
+ * Every scaffolder in `packages/cli/src/stacks/<id>/scaffold.ts` implements
+ * `StackScaffold`. Each one is registered (lazy) in `./registry.ts`.
+ */
+export type BackendStackId = 'ruby-rails-8' | 'node-nestjs' | 'python-fastapi' | 'php-laravel' | 'rust-axum' | 'go-gin' | 'go-stdlib';
+export type McpStackId = 'mcp-node-ts' | 'mcp-python' | 'mcp-rust' | 'mcp-go';
+export type StackId = BackendStackId | McpStackId;
+export type StackCategory = 'backend' | 'mcp';
+export type ToolchainMode = 'native' | 'docker' | 'auto';
+export type McpTransport = 'stdio' | 'sse' | 'http';
+export type DareDnaArtifact = 'llms-txt' | 'openapi' | 'cli-json-flag' | 'env-example' | 'rate-limit' | 'skills-yml' | 'github-ci';
+export declare const DARE_DNA: readonly DareDnaArtifact[];
+export interface LlmProvider {
+    /** Free-form id validated by enum upstream. E.g. 'openai', 'anthropic', 'dummy'. */
+    readonly id: string;
+    readonly defaultModel: string;
+}
+export interface ScaffoldOpts {
+    /** Already-created, empty target directory. */
+    readonly dir: string;
+    /** kebab-case slug, validated upstream. */
+    readonly projectName: string;
+    readonly toolchain: ToolchainMode;
+    /** Subset of DARE_DNA. Default = all 7 (DNA is mandatory). */
+    readonly features: ReadonlySet<DareDnaArtifact>;
+    /** Optional. When absent, scaffolder does NOT wire any LLM stack. */
+    readonly llm?: {
+        providers: ReadonlyArray<LlmProvider>;
+    };
+    /** Backend-only realtime config. Defaults to 'ws' when realtime is on. */
+    readonly realtime?: {
+        transport: 'ws' | 'sse';
+    };
+    /** Required when stack.category === 'mcp'. Default 'stdio' upstream. */
+    readonly mcp?: {
+        transport: McpTransport;
+    };
+    /** True when init detected a pre-existing monorepo (Cargo workspace etc.). */
+    readonly isMonorepo: boolean;
+}
+export interface ScaffoldResult {
+    /** Paths relative to opts.dir. Order = write order. */
+    readonly filesWritten: ReadonlyArray<string>;
+    /** Shell-quoted commands the user should run next. */
+    readonly postInstallSteps: ReadonlyArray<string>;
+    /** Non-fatal warnings — go to stderr. */
+    readonly warnings: ReadonlyArray<string>;
+    /** Which of the 7 DNA artifacts were emitted. Used by dna.spec.ts. */
+    readonly dnaEmitted: ReadonlySet<DareDnaArtifact>;
+}
+export interface StackScaffold {
+    readonly id: StackId;
+    /** Human-readable label shown in the prompt (may include emoji). */
+    readonly label: string;
+    readonly category: StackCategory;
+    readonly status: 'stable' | 'beta';
+    generate(opts: ScaffoldOpts): Promise<ScaffoldResult>;
+}
+export interface StackRegistryEntry {
+    readonly id: StackId;
+    readonly label: string;
+    readonly category: StackCategory;
+    readonly status: 'stable' | 'beta';
+    /** Lazy import. Resolves when the user picks the stack. */
+    readonly load: () => Promise<StackScaffold>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stacks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stacks/types.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAIH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAI9C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAMpD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,SAAS,GACT,eAAe,GACf,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,WAAW,CAAC;AAEhB,eAAO,MAAM,QAAQ,EAAE,SAAS,eAAe,EAQrC,CAAC;AAiBX,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAChD,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC;IACzD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,IAAI,GAAG,KAAK,CAAA;KAAE,CAAC;IAChD,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,SAAS,EAAE,YAAY,CAAA;KAAE,CAAC;IAC3C,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CACnD;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvD;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7C"}

package/dist/stacks/types.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Core contract for stack scaffolders (v3.1).
+ *
+ * Every scaffolder in `packages/cli/src/stacks/<id>/scaffold.ts` implements
+ * `StackScaffold`. Each one is registered (lazy) in `./registry.ts`.
+ */
+export const DARE_DNA = [
+    'llms-txt',
+    'openapi',
+    'cli-json-flag',
+    'env-example',
+    'rate-limit',
+    'skills-yml',
+    'github-ci',
+];
+// Compile-time exhaustiveness check — if DareDnaArtifact grows, this fails to
+// compile until DARE_DNA is updated.
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const _DARE_DNA_EXHAUSTIVE_CHECK = {
+    'llms-txt': true,
+    openapi: true,
+    'cli-json-flag': true,
+    'env-example': true,
+    'rate-limit': true,
+    'skills-yml': true,
+    'github-ci': true,
+};
+//# sourceMappingURL=types.js.map

package/dist/stacks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stacks/types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;;;;GAKG;AA0CH,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,UAAU;IACV,SAAS;IACT,eAAe;IACf,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,WAAW;CACH,CAAC;AAEX,8EAA8E;AAC9E,qCAAqC;AACrC,6DAA6D;AAC7D,MAAM,0BAA0B,GAAkC;IAChE,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,IAAI;IACb,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;CAClB,CAAC"}