@maestro-ai/mcp-server 2.6.1 → 5.0.0

package/dist/services/content-resolver.service.d.ts

@@ -0,0 +1,96 @@
+/**
+ * ContentResolverService — Resolução Unificada de Conteúdo
+ *
+ * Única fonte de verdade para resolver onde ler conteúdo:
+ * 1. Projeto local (.maestro/content/) — Plano B (prioridade)
+ * 2. Servidor (content/) — Plano A (fallback)
+ *
+ * Cache em memória para evitar I/O repetido.
+ */
+export declare class ContentResolverService {
+    private diretorio;
+    private projectContentRoot;
+    private serverContentRoot;
+    private cache;
+    constructor(diretorio: string);
+    /**
+     * Resolve o diretório raiz de conteúdo do servidor.
+     * Tenta múltiplos caminhos relativos ao módulo.
+     */
+    private resolveServerContentRoot;
+    /**
+     * Retorna o diretório raiz de conteúdo ativo.
+     * Prioriza projeto local, fallback para servidor.
+     */
+    getContentRoot(): string;
+    /**
+     * Verifica se o projeto tem conteúdo local instalado (.maestro/content)
+     */
+    hasProjectContent(): boolean;
+    /**
+     * Retorna o diretório raiz do conteúdo do servidor (sempre disponível)
+     */
+    getServerContentRoot(): string;
+    /**
+     * Resolve o diretório de uma skill específica.
+     * Prioriza projeto local → servidor.
+     * Retorna null se não encontrada em nenhum.
+     */
+    getSkillDir(skillName: string): string | null;
+    /**
+     * Lê conteúdo de um arquivo de skill.
+     * Prioriza projeto local → servidor.
+     * Retorna null se não encontrado.
+     */
+    readSkillFile(skillName: string, fileName: string): Promise<string | null>;
+    /**
+     * Lista recursos disponíveis de uma skill (templates, examples, checklists, reference).
+     */
+    listSkillResources(skillName: string, tipo: "templates" | "examples" | "checklists" | "reference"): Promise<string[]>;
+    /**
+     * Lê recurso específico de uma skill.
+     */
+    readSkillResource(skillName: string, tipo: "templates" | "examples" | "checklists" | "reference", arquivo: string): Promise<string | null>;
+    /**
+     * Lê o primeiro arquivo de template encontrado para uma skill.
+     * Retorna null se nenhum template disponível.
+     */
+    readFirstTemplate(skillName: string): Promise<string | null>;
+    /**
+     * Lê o primeiro arquivo de checklist encontrado para uma skill.
+     * Retorna null se nenhum checklist disponível.
+     */
+    readFirstChecklist(skillName: string): Promise<string | null>;
+    /**
+     * Lista todas as skills disponíveis (pastas dentro de skills/).
+     */
+    listAvailableSkills(): Promise<string[]>;
+    private getFromCache;
+    private setCache;
+    /**
+     * Limpa o cache (útil para testes ou após injeção de conteúdo).
+     */
+    clearCache(): void;
+    /**
+     * Lê o manifesto de versão do conteúdo (.version.json).
+     * Retorna null se não encontrado.
+     */
+    readVersionManifest(source?: "project" | "server"): Promise<Record<string, unknown> | null>;
+    /**
+     * Verifica se o conteúdo local está desatualizado comparado ao servidor.
+     * Retorna objeto com informações de compatibilidade.
+     */
+    checkVersionCompatibility(): Promise<{
+        hasProjectContent: boolean;
+        projectVersion: string | null;
+        serverVersion: string | null;
+        isCompatible: boolean;
+        needsUpdate: boolean;
+        message: string;
+    }>;
+}
+/**
+ * Factory function para criar ContentResolverService.
+ */
+export declare function createContentResolver(diretorio: string): ContentResolverService;
+//# sourceMappingURL=content-resolver.service.d.ts.map

package/dist/services/content-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-resolver.service.d.ts","sourceRoot":"","sources":["../../src/services/content-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAsC;gBAEvC,SAAS,EAAE,MAAM;IAM7B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;;OAGG;IACH,cAAc,IAAI,MAAM;IAOxB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgB7C;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBhF;;OAEG;IACG,kBAAkB,CACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAC5D,OAAO,CAAC,MAAM,EAAE,CAAC;IAcpB;;OAEG;IACG,iBAAiB,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,EAC3D,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBzB;;;OAGG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMlE;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMnE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAiB9C,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;;OAGG;IACG,mBAAmB,CAAC,MAAM,GAAE,SAAS,GAAG,QAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAa5G;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC;QACvC,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CAgDL;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAE/E"}

package/dist/services/content-resolver.service.js

@@ -0,0 +1,280 @@
+/**
+ * ContentResolverService — Resolução Unificada de Conteúdo
+ *
+ * Única fonte de verdade para resolver onde ler conteúdo:
+ * 1. Projeto local (.maestro/content/) — Plano B (prioridade)
+ * 2. Servidor (content/) — Plano A (fallback)
+ *
+ * Cache em memória para evitar I/O repetido.
+ */
+import { readFile, readdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutos
+export class ContentResolverService {
+    diretorio;
+    projectContentRoot;
+    serverContentRoot;
+    cache = new Map();
+    constructor(diretorio) {
+        this.diretorio = diretorio;
+        this.projectContentRoot = join(diretorio, ".maestro", "content");
+        this.serverContentRoot = this.resolveServerContentRoot();
+    }
+    /**
+     * Resolve o diretório raiz de conteúdo do servidor.
+     * Tenta múltiplos caminhos relativos ao módulo.
+     */
+    resolveServerContentRoot() {
+        const possiblePaths = [
+            join(__dirname, "..", "..", "..", "content"),
+            join(__dirname, "..", "..", "content"),
+            join(__dirname, "..", "content"),
+            join(process.cwd(), "content"),
+        ];
+        for (const path of possiblePaths) {
+            if (existsSync(path)) {
+                return path;
+            }
+        }
+        // Fallback: retorna o path mais provável mesmo sem existir
+        return possiblePaths[0];
+    }
+    /**
+     * Retorna o diretório raiz de conteúdo ativo.
+     * Prioriza projeto local, fallback para servidor.
+     */
+    getContentRoot() {
+        if (this.hasProjectContent()) {
+            return this.projectContentRoot;
+        }
+        return this.serverContentRoot;
+    }
+    /**
+     * Verifica se o projeto tem conteúdo local instalado (.maestro/content)
+     */
+    hasProjectContent() {
+        return existsSync(this.projectContentRoot);
+    }
+    /**
+     * Retorna o diretório raiz do conteúdo do servidor (sempre disponível)
+     */
+    getServerContentRoot() {
+        return this.serverContentRoot;
+    }
+    /**
+     * Resolve o diretório de uma skill específica.
+     * Prioriza projeto local → servidor.
+     * Retorna null se não encontrada em nenhum.
+     */
+    getSkillDir(skillName) {
+        // 1. Tentar no projeto local
+        const projectSkillDir = join(this.projectContentRoot, "skills", skillName);
+        if (existsSync(projectSkillDir)) {
+            return projectSkillDir;
+        }
+        // 2. Tentar no servidor
+        const serverSkillDir = join(this.serverContentRoot, "skills", skillName);
+        if (existsSync(serverSkillDir)) {
+            return serverSkillDir;
+        }
+        return null;
+    }
+    /**
+     * Lê conteúdo de um arquivo de skill.
+     * Prioriza projeto local → servidor.
+     * Retorna null se não encontrado.
+     */
+    async readSkillFile(skillName, fileName) {
+        const cacheKey = `skill:${skillName}:${fileName}`;
+        const cached = this.getFromCache(cacheKey);
+        if (cached !== null)
+            return cached;
+        const skillDir = this.getSkillDir(skillName);
+        if (!skillDir)
+            return null;
+        const filePath = join(skillDir, fileName);
+        try {
+            if (!existsSync(filePath))
+                return null;
+            const content = await readFile(filePath, "utf-8");
+            this.setCache(cacheKey, content);
+            return content;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Lista recursos disponíveis de uma skill (templates, examples, checklists, reference).
+     */
+    async listSkillResources(skillName, tipo) {
+        const skillDir = this.getSkillDir(skillName);
+        if (!skillDir)
+            return [];
+        const resourceDir = join(skillDir, "resources", tipo);
+        try {
+            if (!existsSync(resourceDir))
+                return [];
+            const entries = await readdir(resourceDir);
+            return entries.filter(e => e.endsWith(".md"));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Lê recurso específico de uma skill.
+     */
+    async readSkillResource(skillName, tipo, arquivo) {
+        const cacheKey = `resource:${skillName}:${tipo}:${arquivo}`;
+        const cached = this.getFromCache(cacheKey);
+        if (cached !== null)
+            return cached;
+        const skillDir = this.getSkillDir(skillName);
+        if (!skillDir)
+            return null;
+        const filePath = join(skillDir, "resources", tipo, arquivo);
+        try {
+            if (!existsSync(filePath))
+                return null;
+            const content = await readFile(filePath, "utf-8");
+            this.setCache(cacheKey, content);
+            return content;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Lê o primeiro arquivo de template encontrado para uma skill.
+     * Retorna null se nenhum template disponível.
+     */
+    async readFirstTemplate(skillName) {
+        const templates = await this.listSkillResources(skillName, "templates");
+        if (templates.length === 0)
+            return null;
+        return this.readSkillResource(skillName, "templates", templates[0]);
+    }
+    /**
+     * Lê o primeiro arquivo de checklist encontrado para uma skill.
+     * Retorna null se nenhum checklist disponível.
+     */
+    async readFirstChecklist(skillName) {
+        const checklists = await this.listSkillResources(skillName, "checklists");
+        if (checklists.length === 0)
+            return null;
+        return this.readSkillResource(skillName, "checklists", checklists[0]);
+    }
+    /**
+     * Lista todas as skills disponíveis (pastas dentro de skills/).
+     */
+    async listAvailableSkills() {
+        const contentRoot = this.getContentRoot();
+        const skillsDir = join(contentRoot, "skills");
+        try {
+            if (!existsSync(skillsDir))
+                return [];
+            const entries = await readdir(skillsDir, { withFileTypes: true });
+            return entries
+                .filter(e => e.isDirectory() && e.name.startsWith("specialist-"))
+                .map(e => e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    // === Cache ===
+    getFromCache(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > CACHE_TTL_MS) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.content;
+    }
+    setCache(key, content) {
+        this.cache.set(key, { content, timestamp: Date.now() });
+    }
+    /**
+     * Limpa o cache (útil para testes ou após injeção de conteúdo).
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    // === Version Management (v5: Sprint D.3) ===
+    /**
+     * Lê o manifesto de versão do conteúdo (.version.json).
+     * Retorna null se não encontrado.
+     */
+    async readVersionManifest(source = "project") {
+        const root = source === "project" ? this.projectContentRoot : this.serverContentRoot;
+        const versionPath = join(root, ".version.json");
+        try {
+            if (!existsSync(versionPath))
+                return null;
+            const content = await readFile(versionPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Verifica se o conteúdo local está desatualizado comparado ao servidor.
+     * Retorna objeto com informações de compatibilidade.
+     */
+    async checkVersionCompatibility() {
+        const projectManifest = await this.readVersionManifest("project");
+        const serverManifest = await this.readVersionManifest("server");
+        const projectVersion = projectManifest?.version;
+        const serverVersion = serverManifest?.version;
+        const hasProjectContent = this.hasProjectContent();
+        if (!hasProjectContent) {
+            return {
+                hasProjectContent: false,
+                projectVersion: null,
+                serverVersion,
+                isCompatible: true,
+                needsUpdate: false,
+                message: "Usando conteúdo do servidor (builtin).",
+            };
+        }
+        if (!projectVersion || !serverVersion) {
+            return {
+                hasProjectContent: true,
+                projectVersion,
+                serverVersion,
+                isCompatible: true,
+                needsUpdate: false,
+                message: "Sem informação de versão disponível.",
+            };
+        }
+        // Comparar versões major.minor.patch
+        const [pMajor, pMinor] = projectVersion.split(".").map(Number);
+        const [sMajor, sMinor] = serverVersion.split(".").map(Number);
+        const isCompatible = pMajor === sMajor;
+        const needsUpdate = pMinor < sMinor || (pMajor < sMajor);
+        return {
+            hasProjectContent: true,
+            projectVersion,
+            serverVersion,
+            isCompatible,
+            needsUpdate,
+            message: needsUpdate
+                ? `Conteúdo local desatualizado (${projectVersion} vs ${serverVersion}). Execute 'npx @maestro-ai/cli' para atualizar.`
+                : `Conteúdo local atualizado (${projectVersion}).`,
+        };
+    }
+}
+/**
+ * Factory function para criar ContentResolverService.
+ */
+export function createContentResolver(diretorio) {
+    return new ContentResolverService(diretorio);
+}
+//# sourceMappingURL=content-resolver.service.js.map

package/dist/services/content-resolver.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-resolver.service.js","sourceRoot":"","sources":["../../src/services/content-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAO1D,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAEhD,MAAM,OAAO,sBAAsB;IACvB,SAAS,CAAS;IAClB,kBAAkB,CAAS;IAC3B,iBAAiB,CAAS;IAC1B,KAAK,GAA4B,IAAI,GAAG,EAAE,CAAC;IAEnD,YAAY,SAAiB;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACK,wBAAwB;QAC5B,MAAM,aAAa,GAAG;YAClB,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC;YAC5C,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC;YACtC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC;SACjC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,cAAc;QACV,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,kBAAkB,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACb,OAAO,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,SAAiB;QACzB,6BAA6B;QAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3E,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9B,OAAO,eAAe,CAAC;QAC3B,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzE,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC7B,OAAO,cAAc,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,QAAgB;QACnD,MAAM,QAAQ,GAAG,SAAS,SAAS,IAAI,QAAQ,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,OAAO,OAAO,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACpB,SAAiB,EACjB,IAA2D;QAE3D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,OAAO,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;YAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACnB,SAAiB,EACjB,IAA2D,EAC3D,OAAe;QAEf,MAAM,QAAQ,GAAG,YAAY,SAAS,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,OAAO,OAAO,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACrC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,SAAiB;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO,OAAO;iBACT,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;iBAChE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAED,gBAAgB;IAER,YAAY,CAAC,GAAW;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IAEO,QAAQ,CAAC,GAAW,EAAE,OAAe;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,UAAU;QACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,8CAA8C;IAE9C;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAA+B,SAAS;QAC9D,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAEhD,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB;QAQ3B,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEhE,MAAM,cAAc,GAAG,eAAe,EAAE,OAAwB,CAAC;QACjE,MAAM,aAAa,GAAG,cAAc,EAAE,OAAwB,CAAC;QAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEnD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrB,OAAO;gBACH,iBAAiB,EAAE,KAAK;gBACxB,cAAc,EAAE,IAAI;gBACpB,aAAa;gBACb,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,wCAAwC;aACpD,CAAC;QACN,CAAC;QAED,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,OAAO;gBACH,iBAAiB,EAAE,IAAI;gBACvB,cAAc;gBACd,aAAa;gBACb,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,sCAAsC;aAClD,CAAC;QACN,CAAC;QAED,qCAAqC;QACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE9D,MAAM,YAAY,GAAG,MAAM,KAAK,MAAM,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QAEzD,OAAO;YACH,iBAAiB,EAAE,IAAI;YACvB,cAAc;YACd,aAAa;YACb,YAAY;YACZ,WAAW;YACX,OAAO,EAAE,WAAW;gBAChB,CAAC,CAAC,iCAAiC,cAAc,OAAO,aAAa,kDAAkD;gBACvH,CAAC,CAAC,8BAA8B,cAAc,IAAI;SACzD,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACnD,OAAO,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC"}

package/dist/services/flow-engine.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Flow Engine — State Machine para Fluxos do Maestro
+ *
+ * Codifica transições de fase como state machine declarativa.
+ * Qualquer tool pode perguntar "qual o próximo passo?" ao flow engine.
+ * Gera next_action automaticamente baseado no estado atual.
+ */
+import type { EstadoProjeto } from "../types/index.js";
+import type { NextAction, FlowProgress, SpecialistPersona } from "../types/response.js";
+/**
+ * Estado do fluxo extraído do estado do projeto
+ */
+export interface FlowState {
+    hasGlobalConfig: boolean;
+    hasProject: boolean;
+    currentPhase: string;
+    faseNumero: number;
+    totalFases: number;
+    gatesValidados: number[];
+    mode: 'economy' | 'balanced' | 'quality';
+    discoveryStatus: string;
+    brainstormStatus: string;
+    prdStatus: string;
+    aguardandoAprovacao: boolean;
+    aguardandoClassificacao: boolean;
+    wantsBrainstorm: boolean;
+    nivel: string;
+    usarStitch: boolean;
+    diretorio: string;
+}
+/**
+ * Resultado do flow engine: próximo passo recomendado
+ */
+export interface FlowStep {
+    phase: string;
+    tool: string;
+    description: string;
+    args_template: Record<string, unknown>;
+    requires_user_input: boolean;
+    user_prompt?: string;
+    auto_execute?: boolean;
+    specialist?: SpecialistPersona | null;
+}
+/**
+ * Transição declarativa no flow
+ */
+interface FlowTransition {
+    from: string;
+    to: string;
+    tool: string;
+    description: string;
+    condition?: (state: FlowState) => boolean;
+    requires_user_input: boolean;
+    user_prompt?: string;
+    auto_execute?: boolean;
+}
+/**
+ * Extrai estado do fluxo a partir do estado do projeto
+ */
+export declare function getFlowState(estado: EstadoProjeto, diretorio: string): FlowState;
+/**
+ * Obtém o próximo passo recomendado pelo flow engine
+ */
+export declare function getNextStep(estado: EstadoProjeto, diretorio: string): FlowStep;
+/**
+ * Converte FlowStep em NextAction para resposta de tool
+ */
+export declare function flowStepToNextAction(step: FlowStep): NextAction;
+/**
+ * Calcula progresso atual do fluxo
+ */
+export declare function getFlowProgress(estado: EstadoProjeto): FlowProgress;
+/**
+ * Verifica se o projeto está no fluxo de onboarding
+ */
+export declare function isInOnboarding(estado: EstadoProjeto): boolean;
+/**
+ * Lista todas as transições disponíveis a partir do estado atual
+ */
+export declare function getAvailableTransitions(estado: EstadoProjeto, diretorio: string): FlowTransition[];
+export {};
+//# sourceMappingURL=flow-engine.d.ts.map

package/dist/services/flow-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-engine.d.ts","sourceRoot":"","sources":["../../src/services/flow-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIxF;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,OAAO,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;IAC1C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAyID;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAoBhF;AAyBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAsC9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAS/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAanE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAQ7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAMlG"}