@devstroupe/devkit-cli 1.2.0-beta.5 → 1.2.0-beta.6

package/dist/ai-workflow/rules/backend.md

@@ -0,0 +1,14 @@
+# DT-DevKit backend rules
+
+- NestJS CRUD controllers extend `BaseCrudController`.
+- TypeORM repositories extend `BaseRepository`.
+- Use application use cases for simple CRUD; do not add `@nestjs/cqrs` by default.
+- Persistent entities use soft delete. Application hard delete and restore are forbidden.
+- Tenant-scoped repositories use `executionContext.requireTenantId()`.
+- Public filters use a trusted registry and pagination has a maximum limit.
+- Never use unbounded `.find()` or `.getMany()`.
+- Domain and entity layers must not import infrastructure, controllers or modules.
+- TypeORM `synchronize` remains `false`; schema changes require migrations.
+- Cross-module references persist IDs and do not import external infrastructure.
+- Writes plus integration events use Unit of Work and transactional outbox.
+

package/dist/ai-workflow/rules/engineering.md

@@ -0,0 +1,8 @@
+# Engineering rules
+
+- Prefer the smallest complete change that satisfies the approved specification.
+- Diagnose root causes; do not hide failures with workarounds.
+- Preserve unrelated user changes.
+- Keep durable decisions in the feature techspec or an ADR.
+- A task is complete only with relevant verification evidence.
+

package/dist/ai-workflow/rules/frontend.md

@@ -0,0 +1,11 @@
+# DT-DevKit frontend and UI rules
+
+- Angular list components extend `BaseListPage`.
+- List templates use `<devkit-table>` and `<devkit-filter>`.
+- Use separate `templateUrl` and `styleUrl`/`styleUrls`; no inline templates or styles.
+- Do not implement polling with `setInterval`, `interval` or repeating `timer`.
+- Reuse local `devkit-*` wrappers before creating a new UI abstraction.
+- Spartan Helm primitives in `libs/ui` belong to the app; do not place business logic in them.
+- Apply Spartan styles through `components.json` and `ds_set_spartan_style`, never by CSS imitation.
+- Protect routes and actions with `devkitPermissionGuard` and `*devkitHasPermission`.
+

package/dist/ai-workflow/skills/dt-build-ui/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: dt-build-ui
+description: Build or modify Angular UI using the DT-DevKit wrappers and project-owned Spartan Helm primitives. Use for pages, forms, lists, dialogs, navigation or Spartan style work.
+---
+
+# Build UI
+
+1. Read `.devstroupe/rules/frontend.md`, `devstroupe.config.ts` and `components.json` when present.
+2. Call `ds_health` and `ds_get_config`. Bootstrap MCP if unavailable.
+3. If UI is not initialized, call `ds_init_ui`. Change official style only with `ds_set_spartan_style`.
+4. Reuse local `devkit-*` wrappers. Add a wrapper only when the application lacks the required abstraction.
+5. Never emulate a Spartan style with runtime CSS or add business logic to `libs/ui` primitives.
+6. Keep Angular templates/styles separate, avoid polling and apply RBAC directives/guards.
+7. Verify build and call `ds_check_architecture`.
+

package/dist/ai-workflow/skills/dt-create-feature/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: dt-create-feature
+description: Create a DevsTroupe feature PRD, techspec and executable task plan. Use when the user asks to plan, specify or break down a feature in a DT-DevKit project.
+---
+
+# Create feature
+
+1. Read `AGENTS.md`, `devstroupe.config.ts` and relevant `.devstroupe/rules/`.
+2. Call `ds_health`, then `ds_get_config`. If unavailable, activate `dt-mcp-bootstrap` and pause technical execution until MCP is ready.
+3. Classify the change as trivial, standard or high-risk. A trivial change may use a short change brief; other changes require PRD, techspec and tasks.
+4. Resolve unclear product decisions with the user before locking the specification.
+5. Create `.devstroupe/tasks/<slug>/_prd.md`, `_techspec.md` and `_tasks.md` from `.devstroupe/templates/`.
+6. Tasks must identify MCP operations, code changes, acceptance criteria and verification evidence.
+7. Do not implement code unless the user also asks for execution.
+

package/dist/ai-workflow/skills/dt-create-task/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: dt-create-task
+description: Add a concrete executable task to an existing DevsTroupe feature specification. Use when the user asks to create, refine or split a task.
+---
+
+# Create task
+
+1. Locate the feature under `.devstroupe/tasks/` and read its PRD, techspec and current tasks.
+2. Read the relevant backend/frontend rules and call `ds_get_config`.
+3. Define one bounded outcome with dependencies, exact scope, acceptance criteria and verification.
+4. Identify the expected `ds_*` calls. Never prescribe direct CLI fallback for an operation exposed by MCP.
+5. Append the task without rewriting approved tasks or changing scope silently.
+

package/dist/ai-workflow/skills/dt-execute-task/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: dt-execute-task
+description: Execute a specified DevsTroupe task using the DT-DevKit MCP, generated architecture and Spartan UI. Use when the user asks to implement or complete a task.
+---
+
+# Execute task
+
+1. Read the feature PRD, techspec, task, `devstroupe.config.ts` and relevant rules.
+2. Call `ds_health` and `ds_get_config` before edits. If MCP is missing, use `dt-mcp-bootstrap`; do not silently use CLI.
+3. Use MCP operations whenever available: `ds_init_ui`, `ds_generate_crud`, `ds_generate_migration`, `ds_set_spartan_style` and `ds_check_architecture`.
+4. Edit code directly only for task-specific behavior not covered by a generator. Preserve the DevKit architecture and local UI ownership.
+5. For UI, reuse `devkit-*` wrappers and the existing Spartan primitives in `libs/ui`.
+6. Run applicable tests/build and `ds_check_architecture`.
+7. Update only the task status and evidence after verification succeeds. Report blockers truthfully.
+

package/dist/ai-workflow/skills/dt-final-verify/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: dt-final-verify
+description: Perform the final evidence-based verification of a DevsTroupe task or feature. Use before claiming implementation is complete.
+---
+
+# Final verification
+
+1. Read the approved acceptance criteria and changed files.
+2. Call `ds_health` and `ds_get_config`.
+3. Run focused tests, relevant builds, migration checks and `ds_check_architecture` through MCP where exposed.
+4. Check generated UI against the project-owned Spartan style and DevKit wrappers.
+5. Record commands/tool calls, results and remaining risks in the task evidence.
+6. Do not mark complete when a required check failed or did not run.
+

package/dist/ai-workflow/skills/dt-mcp-bootstrap/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: dt-mcp-bootstrap
+description: Diagnose, install or repair the DT-DevKit MCP integration for Codex, Claude Code, Cursor or Antigravity. Use whenever ds_health or other ds_* tools are unavailable.
+---
+
+# MCP bootstrap
+
+1. Detect the current agent and inspect its project-local MCP configuration.
+2. Explain that DevKit task execution requires the MCP and request authorization before installing packages or modifying configuration outside the project.
+3. Prefer the project bootstrap: `devstroupe ai:init --targets <agent>`.
+4. The expected server is `npx -y @devstroupe/devkit-mcp`, named `devstroupe`.
+5. Run `devstroupe ai:doctor`, then ask for an agent-session restart if tool discovery is not live.
+6. Confirm readiness by calling `ds_health` and `ds_get_config`.
+7. Do not continue the technical task through direct CLI commands merely because MCP discovery failed.
+

package/dist/ai-workflow/templates/AGENTS.md

@@ -0,0 +1,13 @@
+# DevsTroupe AI Workflow
+
+Este projeto usa o DT-DevKit e o workflow orientado por especificações da DevsTroupe.
+
+- Para mudanças standard ou high-risk, crie PRD, techspec e tasks em `.devstroupe/tasks/<slug>/`.
+- Use as skills `dt-*` instaladas no projeto.
+- Antes de agir, valide o MCP DevKit com `ds_health` e leia o projeto com `ds_get_config`.
+- Ferramentas MCP `ds_*` são obrigatórias quando existe uma operação equivalente.
+- Se o MCP não estiver disponível, use `dt-mcp-bootstrap`; não faça fallback silencioso para a CLI.
+- A CLI pode ser usada diretamente somente para instalar ou reparar o MCP, quando não houver ferramenta MCP equivalente ou por solicitação explícita.
+- Leia `.devstroupe/rules/` antes de editar backend ou frontend.
+- Sempre finalize com `ds_check_architecture` e as verificações aplicáveis.
+

package/dist/ai-workflow/templates/prd-template.md

@@ -0,0 +1,16 @@
+# PRD — <feature>
+
+## Problem
+
+## Outcome
+
+## Users and use cases
+
+## Scope
+
+## Out of scope
+
+## Acceptance criteria
+
+## Risks and open questions
+

package/dist/ai-workflow/templates/tasks-template.md

@@ -0,0 +1,21 @@
+# Tasks — <feature>
+
+## Execution policy
+
+- MCP DevKit required.
+- Every task must contain acceptance criteria and verification evidence.
+
+## DT-001 — <task>
+
+### Context
+
+### Changes
+
+### Acceptance criteria
+
+### Verification
+
+### Status
+
+pending
+

package/dist/ai-workflow/templates/techspec-template.md

@@ -0,0 +1,16 @@
+# Techspec — <feature>
+
+## Context and constraints
+
+## DevKit configuration impact
+
+## Backend design
+
+## Frontend and Spartan UI design
+
+## Data model and migrations
+
+## Permissions and tenant scope
+
+## Verification strategy
+

package/dist/ai-workflow.d.ts

@@ -0,0 +1,19 @@
+export declare const AI_TARGETS: readonly ["codex", "claude", "cursor", "antigravity"];
+export type AiTarget = typeof AI_TARGETS[number];
+export interface AiInstallResult {
+    projectRoot: string;
+    targets: AiTarget[];
+    skills: string[];
+    written: string[];
+}
+export interface AiDoctorResult {
+    ready: boolean;
+    checks: Array<{
+        name: string;
+        ok: boolean;
+        detail: string;
+    }>;
+}
+export declare function parseAiTargets(value?: string): AiTarget[];
+export declare function installAiWorkflow(projectRoot: string, targets: AiTarget[]): AiInstallResult;
+export declare function diagnoseAiWorkflow(projectRoot: string): AiDoctorResult;

package/dist/ai-workflow.js

@@ -0,0 +1,172 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_TARGETS = void 0;
+exports.parseAiTargets = parseAiTargets;
+exports.installAiWorkflow = installAiWorkflow;
+exports.diagnoseAiWorkflow = diagnoseAiWorkflow;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+exports.AI_TARGETS = ['codex', 'claude', 'cursor', 'antigravity'];
+const MCP_COMMAND = 'npx';
+const MCP_ARGS = ['-y', '@devstroupe/devkit-mcp'];
+const MANAGED_START = '<!-- devstroupe-ai:start -->';
+const MANAGED_END = '<!-- devstroupe-ai:end -->';
+function parseAiTargets(value = 'all') {
+    if (value === 'all')
+        return [...exports.AI_TARGETS];
+    const targets = value.split(',').map((item) => item.trim()).filter(Boolean);
+    const invalid = targets.filter((target) => !exports.AI_TARGETS.includes(target));
+    if (invalid.length) {
+        throw new Error(`Targets inválidos: ${invalid.join(', ')}. Use: all, ${exports.AI_TARGETS.join(', ')}.`);
+    }
+    return [...new Set(targets)];
+}
+function resolveWorkflowRoot() {
+    const candidates = [
+        path.resolve(__dirname, 'ai-workflow'),
+        path.resolve(__dirname, '../ai-workflow'),
+    ];
+    const root = candidates.find((candidate) => fs.existsSync(path.join(candidate, 'skills')));
+    if (!root)
+        throw new Error('Assets do DevsTroupe AI Workflow não foram encontrados no pacote da CLI.');
+    return root;
+}
+function listSkills(workflowRoot) {
+    return fs.readdirSync(path.join(workflowRoot, 'skills'))
+        .filter((name) => fs.existsSync(path.join(workflowRoot, 'skills', name, 'SKILL.md')))
+        .sort();
+}
+function copySkills(workflowRoot, projectRoot, destination, skills, written) {
+    for (const skill of skills) {
+        const target = path.join(projectRoot, destination, skill);
+        fs.ensureDirSync(path.dirname(target));
+        fs.copySync(path.join(workflowRoot, 'skills', skill), target, { overwrite: true });
+        written.push(path.relative(projectRoot, target));
+    }
+}
+function writeJsonMerged(file, patch) {
+    const current = fs.existsSync(file) ? fs.readJsonSync(file) : {};
+    fs.ensureDirSync(path.dirname(file));
+    fs.writeJsonSync(file, { ...current, ...patch }, { spaces: 2 });
+}
+function configureMcp(projectRoot, target, written) {
+    const server = { command: MCP_COMMAND, args: MCP_ARGS };
+    if (target === 'claude') {
+        const file = path.join(projectRoot, '.mcp.json');
+        const current = fs.existsSync(file) ? fs.readJsonSync(file) : {};
+        writeJsonMerged(file, { ...current, mcpServers: { ...(current.mcpServers ?? {}), devstroupe: server } });
+        written.push('.mcp.json');
+    }
+    else if (target === 'cursor') {
+        const file = path.join(projectRoot, '.cursor', 'mcp.json');
+        const current = fs.existsSync(file) ? fs.readJsonSync(file) : {};
+        writeJsonMerged(file, { ...current, mcpServers: { ...(current.mcpServers ?? {}), devstroupe: server } });
+        written.push('.cursor/mcp.json');
+    }
+    else if (target === 'antigravity') {
+        const file = path.join(projectRoot, '.gemini', 'settings.json');
+        const current = fs.existsSync(file) ? fs.readJsonSync(file) : {};
+        writeJsonMerged(file, { ...current, mcpServers: { ...(current.mcpServers ?? {}), devstroupe: server } });
+        written.push('.gemini/settings.json');
+    }
+    else {
+        const file = path.join(projectRoot, '.codex', 'config.toml');
+        const block = `${MANAGED_START}\n[mcp_servers.devstroupe]\ncommand = \"${MCP_COMMAND}\"\nargs = [${MCP_ARGS.map((arg) => `\"${arg}\"`).join(', ')}]\n${MANAGED_END}`;
+        const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf-8') : '';
+        const pattern = new RegExp(`${MANAGED_START}[\\s\\S]*?${MANAGED_END}`, 'm');
+        const next = pattern.test(current) ? current.replace(pattern, block) : `${current.trim()}${current.trim() ? '\n\n' : ''}${block}\n`;
+        fs.ensureDirSync(path.dirname(file));
+        fs.writeFileSync(file, next, 'utf-8');
+        written.push('.codex/config.toml');
+    }
+}
+function installAgentInstructions(workflowRoot, projectRoot, targets, written) {
+    const source = fs.readFileSync(path.join(workflowRoot, 'templates', 'AGENTS.md'), 'utf-8').trim();
+    const block = `${MANAGED_START}\n${source}\n${MANAGED_END}`;
+    for (const fileName of ['AGENTS.md', ...(targets.includes('claude') ? ['CLAUDE.md'] : [])]) {
+        const file = path.join(projectRoot, fileName);
+        const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf-8') : '';
+        const pattern = new RegExp(`${MANAGED_START}[\\s\\S]*?${MANAGED_END}`, 'm');
+        const next = pattern.test(current) ? current.replace(pattern, block) : `${current.trim()}${current.trim() ? '\n\n' : ''}${block}\n`;
+        fs.writeFileSync(file, next, 'utf-8');
+        written.push(fileName);
+    }
+}
+function installAiWorkflow(projectRoot, targets) {
+    const workflowRoot = resolveWorkflowRoot();
+    const skills = listSkills(workflowRoot);
+    const written = [];
+    fs.ensureDirSync(path.join(projectRoot, '.devstroupe', 'tasks'));
+    fs.copySync(path.join(workflowRoot, 'templates'), path.join(projectRoot, '.devstroupe', 'templates'), { overwrite: true });
+    fs.copySync(path.join(workflowRoot, 'rules'), path.join(projectRoot, '.devstroupe', 'rules'), { overwrite: true });
+    written.push('.devstroupe/tasks', '.devstroupe/templates', '.devstroupe/rules');
+    if (targets.includes('codex') || targets.includes('antigravity')) {
+        copySkills(workflowRoot, projectRoot, '.agents/skills', skills, written);
+    }
+    if (targets.includes('claude'))
+        copySkills(workflowRoot, projectRoot, '.claude/skills', skills, written);
+    if (targets.includes('cursor')) {
+        copySkills(workflowRoot, projectRoot, '.cursor/skills', skills, written);
+        fs.ensureDirSync(path.join(projectRoot, '.cursor', 'commands'));
+        for (const skill of skills) {
+            fs.writeFileSync(path.join(projectRoot, '.cursor', 'commands', `${skill}.md`), `Use a skill \`${skill}\` em \`.cursor/skills/${skill}/SKILL.md\` e siga todas as instruções dela.\n`, 'utf-8');
+        }
+        written.push('.cursor/commands');
+    }
+    for (const target of targets)
+        configureMcp(projectRoot, target, written);
+    installAgentInstructions(workflowRoot, projectRoot, targets, written);
+    fs.writeJsonSync(path.join(projectRoot, '.devstroupe', 'ai-workflow.json'), {
+        schemaVersion: 1,
+        workflow: 'devstroupe',
+        mcp: { required: true, allowCliFallback: false, server: '@devstroupe/devkit-mcp' },
+        targets,
+        skills,
+    }, { spaces: 2 });
+    written.push('.devstroupe/ai-workflow.json');
+    return { projectRoot, targets, skills, written: [...new Set(written)] };
+}
+function diagnoseAiWorkflow(projectRoot) {
+    const checks = [
+        { name: 'config', ok: fs.existsSync(path.join(projectRoot, 'devstroupe.config.ts')), detail: 'devstroupe.config.ts' },
+        { name: 'manifest', ok: fs.existsSync(path.join(projectRoot, '.devstroupe', 'ai-workflow.json')), detail: '.devstroupe/ai-workflow.json' },
+        { name: 'tasks', ok: fs.existsSync(path.join(projectRoot, '.devstroupe', 'tasks')), detail: '.devstroupe/tasks' },
+        { name: 'skills', ok: fs.existsSync(path.join(projectRoot, '.agents', 'skills')) || fs.existsSync(path.join(projectRoot, '.claude', 'skills')) || fs.existsSync(path.join(projectRoot, '.cursor', 'skills')), detail: 'skills locais' },
+        { name: 'mcp', ok: ['.mcp.json', '.cursor/mcp.json', '.codex/config.toml', '.gemini/settings.json'].some((file) => fs.existsSync(path.join(projectRoot, file))), detail: 'configuração MCP' },
+        { name: 'instructions', ok: fs.existsSync(path.join(projectRoot, 'AGENTS.md')), detail: 'AGENTS.md' },
+    ];
+    return { ready: checks.every((check) => check.ok), checks };
+}

package/dist/ai-workflow.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ai-workflow.test.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("fs-extra"));
+const ai_workflow_1 = require("./ai-workflow");
+const roots = [];
+(0, node_test_1.afterEach)(() => {
+    while (roots.length)
+        fs.removeSync(roots.pop());
+});
+function project() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'devstroupe-ai-'));
+    roots.push(root);
+    fs.writeFileSync(path.join(root, 'devstroupe.config.ts'), 'export default { entities: [] };\n');
+    return root;
+}
+(0, node_test_1.describe)('DevsTroupe AI Workflow', () => {
+    (0, node_test_1.it)('valida targets', () => {
+        assert.deepEqual((0, ai_workflow_1.parseAiTargets)('codex,claude,codex'), ['codex', 'claude']);
+        assert.throws(() => (0, ai_workflow_1.parseAiTargets)('unknown'), /Targets inválidos/);
+    });
+    (0, node_test_1.it)('instala skills, templates e MCP para todos os agentes', () => {
+        const root = project();
+        const result = (0, ai_workflow_1.installAiWorkflow)(root, (0, ai_workflow_1.parseAiTargets)('all'));
+        assert.ok(result.skills.includes('dt-execute-task'));
+        assert.ok(fs.existsSync(path.join(root, '.agents/skills/dt-execute-task/SKILL.md')));
+        assert.ok(fs.existsSync(path.join(root, '.claude/skills/dt-execute-task/SKILL.md')));
+        assert.ok(fs.existsSync(path.join(root, '.cursor/commands/dt-execute-task.md')));
+        assert.equal(fs.readJsonSync(path.join(root, '.mcp.json')).mcpServers.devstroupe.command, 'npx');
+        assert.equal(fs.readJsonSync(path.join(root, '.cursor/mcp.json')).mcpServers.devstroupe.command, 'npx');
+        assert.match(fs.readFileSync(path.join(root, '.codex/config.toml'), 'utf-8'), /mcp_servers\.devstroupe/);
+        assert.equal((0, ai_workflow_1.diagnoseAiWorkflow)(root).ready, true);
+    });
+    (0, node_test_1.it)('é idempotente e preserva instruções existentes', () => {
+        const root = project();
+        fs.writeFileSync(path.join(root, 'AGENTS.md'), '# Existing\n');
+        (0, ai_workflow_1.installAiWorkflow)(root, ['codex']);
+        (0, ai_workflow_1.installAiWorkflow)(root, ['codex']);
+        const agents = fs.readFileSync(path.join(root, 'AGENTS.md'), 'utf-8');
+        assert.match(agents, /# Existing/);
+        assert.equal((agents.match(/devstroupe-ai:start/g) ?? []).length, 1);
+    });
+});

package/dist/index.js

@@ -49,6 +49,7 @@ const child_process_1 = require("child_process");
 const devkit_core_1 = require("@devstroupe/devkit-core");
 const backend_layout_1 = require("./generation/backend-layout");
 const entity_module_move_1 = require("./migrations/entity-module-move");
+const ai_workflow_1 = require("./ai-workflow");
 // Registra ts-node para poder carregar arquivos .ts (como o config)
 try {
     require('ts-node').register({
@@ -1023,6 +1024,37 @@ program
     fs.writeFileSync(configPath, configContent, 'utf-8');
     console.log('Arquivo devstroupe.config.ts criado com sucesso!');
 });
+program
+    .command('ai:init')
+    .description('Instala o DevsTroupe AI Workflow, skills locais e configuração MCP no projeto')
+    .option('-t, --targets <targets>', 'Agentes: all ou lista codex,claude,cursor,antigravity', 'all')
+    .action((options) => {
+    try {
+        const targets = (0, ai_workflow_1.parseAiTargets)(options.targets);
+        const result = (0, ai_workflow_1.installAiWorkflow)(process.cwd(), targets);
+        console.log(`[AI] Workflow instalado para: ${result.targets.join(', ')}.`);
+        console.log(`[AI] ${result.skills.length} skills disponíveis; MCP DevKit configurado como obrigatório.`);
+        console.log('[AI] Reinicie a sessão do agente e execute "devstroupe ai:doctor" para validar.');
+    }
+    catch (error) {
+        console.error('[AI] Falha na instalação:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program
+    .command('ai:doctor')
+    .description('Diagnostica skills, instruções e configuração MCP do DevsTroupe AI Workflow')
+    .action(() => {
+    const result = (0, ai_workflow_1.diagnoseAiWorkflow)(process.cwd());
+    for (const check of result.checks) {
+        console.log(`${check.ok ? '[ok]' : '[falha]'} ${check.name}: ${check.detail}`);
+    }
+    if (!result.ready) {
+        console.error('[AI] Workflow incompleto. Execute "devstroupe ai:init" para instalar ou reparar.');
+        process.exit(1);
+    }
+    console.log('[AI] Workflow pronto. O agente deve validar o MCP com ds_health antes de executar tasks.');
+});
 // Novo Comando init-ui para forçar geração manual do Design System
 program
     .command('init-ui')
@@ -2329,6 +2361,8 @@ program
 };
 `;
         fs.writeFileSync(configPath, configContent, 'utf-8');
+        const aiResult = (0, ai_workflow_1.installAiWorkflow)(projectRoot, (0, ai_workflow_1.parseAiTargets)('all'));
+        console.log(`[AI] Workflow DevsTroupe instalado com ${aiResult.skills.length} skills e MCP configurado.`);
         console.log(`\n\x1b[32m[SUCESSO] Projeto "${projectName}" inicializado com sucesso!\x1b[0m`);
         console.log(`Para começar:`);
         console.log(`  1. Acesse a pasta do projeto: cd ${projectName}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devstroupe/devkit-cli",
-  "version": "1.2.0-beta.5",
+  "version": "1.2.0-beta.6",
   "description": "DevsTroupe Development Kit CLI — scaffold NestJS+Angular projects, inject Spartan UI, generate CRUDs and audit architectural governance",
   "license": "MIT",
   "keywords": [
@@ -36,7 +36,7 @@
   "dependencies": {
     "commander": "^12.0.0",
     "fs-extra": "^11.2.0",
-    "@devstroupe/devkit-core": "1.2.0-beta.5"
+    "@devstroupe/devkit-core": "1.2.0-beta.6"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
@@ -45,6 +45,6 @@
   },
   "scripts": {
     "build": "node clean.js && tsc && node postbuild.js && chmod +x dist/index.js",
-    "test": "node clean.js && tsc && node postbuild.js && node --test dist/rules/linter-rules.test.js dist/templates/relationship-templates.test.js dist/templates/generator-characterization.test.js dist/generation/backend-layout.test.js dist/generation/backend-generator.integration.test.js dist/migrations/entity-module-move.test.js"
+    "test": "node clean.js && tsc && node postbuild.js && node --test dist/ai-workflow.test.js dist/rules/linter-rules.test.js dist/templates/relationship-templates.test.js dist/templates/generator-characterization.test.js dist/generation/backend-layout.test.js dist/generation/backend-generator.integration.test.js dist/migrations/entity-module-move.test.js"
   }
 }