@promovaweb/specsfy 0.8.1 → 0.9.2

package/dist/prerequisites.js

@@ -1,7 +1,6 @@
 /** Diagnóstico compartilhado pelos fluxos de setup, update e upgrade. */
 import { constants } from "node:fs";
-import { access, realpath, stat } from "node:fs/promises";
-import { createRequire } from "node:module";
+import { access, stat } from "node:fs/promises";
 import { delimiter, join, resolve } from "node:path";
 const MINIMUM_NODE_VERSION = [22, 20, 0];
 /** Informa se a versão do runtime satisfaz o contrato do pacote. */
@@ -17,24 +16,18 @@ export function nodeVersionSupported(version) {
     return true;
 }
 /**
- * Resolve o comando oficial `skills` sem depender apenas do PATH do processo.
+ * Resolve o `npx` que chama a CLI oficial `skills` sob demanda.
  *
- * A instalação incluída no pacote cobre launchers gráficos e chamadas por
- * caminho absoluto, que podem omitir o diretório global do npm no PATH.
+ * Toda materialização do Specsfy passa por `npx skills add`, para usar a
+ * versão publicada e tornar o comando apresentado à pessoa explícito.
  */
-export async function resolveSkillsCommand(path = process.env.PATH ?? "", override = process.env.SPECSFY_SKILLS_CLI, launcher = process.argv[1]) {
+export async function resolveNpxSkillsCommand(path = process.env.PATH ?? "", override = process.env.SPECSFY_NPX_COMMAND, _launcher = process.argv[1]) {
     if (override) {
         const executable = resolve(override);
-        return (await isExecutable(executable)) ? [executable] : undefined;
+        return (await isExecutable(executable)) ? [executable, "skills"] : undefined;
     }
-    const skills = await findExecutable("skills", path);
-    if (skills)
-        return [skills];
-    const packaged = await resolvePackagedSkills(launcher);
-    if (packaged)
-        return [process.execPath, packaged];
     const npx = await findExecutable("npx", path);
-    return npx ? [npx, "--yes", "skills"] : undefined;
+    return npx ? [npx, "skills"] : undefined;
 }
 /** Verifica todos os recursos usados pelos comandos de instalação e atualização. */
 export async function checkPrerequisites(project, options = {}) {
@@ -42,7 +35,7 @@ export async function checkPrerequisites(project, options = {}) {
     const nodeVersion = options.nodeVersion ?? process.versions.node;
     const git = await findExecutable("git", path);
     const npm = await findExecutable("npm", path);
-    const skills = await resolveSkillsCommand(path, options.skillsOverride ?? process.env.SPECSFY_SKILLS_CLI, options.skillsLauncher ?? process.argv[1]);
+    const skills = await resolveNpxSkillsCommand(path, options.npxOverride ?? process.env.SPECSFY_NPX_COMMAND, options.skillsLauncher ?? process.argv[1]);
     const target = resolve(project);
     let projectOk = false;
     try {
@@ -69,9 +62,8 @@ export async function checkPrerequisites(project, options = {}) {
             name: "skills",
             ok: Boolean(skills),
             detail: skills
-                ? `skills CLI disponível por ${skills.join(" ")}`
-                : "skills CLI ausente; reinstale `@promovaweb/specsfy` pelo npm ou " +
-                    "disponibilize `skills` ou `npx` no PATH",
+                ? `instalação de skills disponível por ${skills.join(" ")}`
+                : "npx não encontrado; instale o npm e disponibilize `npx` no PATH",
             command: skills,
         },
         {
@@ -108,20 +100,6 @@ async function findExecutable(name, path) {
     }
     return undefined;
 }
-/** Localiza a dependência `skills` a partir do launcher instalado do Specsfy. */
-async function resolvePackagedSkills(launcher) {
-    if (!launcher)
-        return undefined;
-    try {
-        const require = createRequire(await realpath(resolve(launcher)));
-        const executable = require.resolve("skills/bin/cli.mjs");
-        await access(executable, constants.R_OK);
-        return executable;
-    }
-    catch {
-        return undefined;
-    }
-}
 async function isExecutable(path) {
     try {
         await access(path, constants.X_OK);

package/dist/prerequisites.js.map

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

package/dist/tui.d.ts

@@ -119,6 +119,10 @@ export declare class SpecsfyTui {
     private mountShell;
     private bindKeys;
     private showTab;
+    /** Recupera um alvo navegável quando um painel foi recriado ou fechado. */
+    private focusActiveTab;
+    /** Renderiza somente enquanto a tela ainda pertence ao ciclo atual. */
+    private renderScreen;
     /**
      * Retorna um nível por vez: fecha modal, limpa busca e volta ao Home.
      *
@@ -135,6 +139,7 @@ export declare class SpecsfyTui {
     private renderSkills;
     private renderAbout;
     private refreshAll;
+    private refreshAllInternal;
     private refreshIfChanged;
     private skillOptions;
     private visibleSkills;

package/dist/tui.d.ts.map

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

package/dist/tui.js

@@ -119,6 +119,7 @@ export class SpecsfyTui {
     #status;
     #projectInput;
     #modal;
+    #modalFocus;
     #lastBackAt = 0;
     #tabButtons = new Map();
     #activeTab = "home";
@@ -129,6 +130,8 @@ export class SpecsfyTui {
     #catalogError = "";
     #installed = new Set();
     #selected = new Set();
+    #selectionDirty = false;
+    #loaded = false;
     #detected = new Set();
     #skillFilter = "all";
     #skillQuery = "";
@@ -136,10 +139,13 @@ export class SpecsfyTui {
     #suppressSkillToggleUntil = 0;
     #fingerprints = { specs: "", backlogs: "", lock: "" };
     #poller;
+    #refreshPromise;
     #testRunning = false;
     #testResultTab = "summary";
     #testSummary = "Nenhuma execução nesta sessão.";
     #testOutput = [];
+    #testSummaryPanel;
+    #testOutputPanel;
     constructor(project = process.cwd()) {
         this.project = resolvePath(project);
     }
@@ -158,6 +164,10 @@ export class SpecsfyTui {
         });
         await this.start({ screen });
         await new Promise((resolve) => {
+            if (screenDestroyed(screen)) {
+                resolve();
+                return;
+            }
             screen.once("destroy", () => {
                 resolve();
             });
@@ -170,6 +180,9 @@ export class SpecsfyTui {
      * terminais virtuais, sem manter um processo pendurado durante os testes.
      */
     async start(options = {}) {
+        if (this.#screen && !screenDestroyed(this.#screen)) {
+            throw new Error("a TUI já foi iniciada nesta instância");
+        }
         const screen = options.screen ??
             blessed.screen({
                 smartCSR: true,
@@ -187,13 +200,20 @@ export class SpecsfyTui {
             if (this.#poller)
                 clearInterval(this.#poller);
             this.#poller = undefined;
+            this.#refreshPromise = undefined;
+            this.#modal = undefined;
+            this.#modalFocus = undefined;
         });
         this.showStatus("Carregando projeto…");
         await this.refreshAll(!options.catalog);
         this.showTab("home");
         if (options.watch !== false) {
             const config = await loadConfig(this.project);
-            this.#poller = setInterval(() => void this.refreshIfChanged(), config.watch_interval * 1000);
+            if (screenDestroyed(screen))
+                return;
+            this.#poller = setInterval(() => void this.refreshIfChanged().catch((error) => {
+                this.showStatus(`Erro ao atualizar automaticamente: ${errorMessage(error)}`);
+            }), config.watch_interval * 1000);
         }
     }
     mountShell(screen) {
@@ -378,6 +398,8 @@ export class SpecsfyTui {
         }
         for (const child of [...body.children])
             child.destroy();
+        this.#testSummaryPanel = undefined;
+        this.#testOutputPanel = undefined;
         if (tab === "home")
             this.renderHome(body);
         else if (tab === "backlogs")
@@ -390,7 +412,24 @@ export class SpecsfyTui {
             this.renderSkills(body);
         else
             this.renderAbout(body);
-        this.#screen.render();
+        this.focusActiveTab();
+        if (!screenDestroyed(this.#screen))
+            this.#screen.render();
+    }
+    /** Recupera um alvo navegável quando um painel foi recriado ou fechado. */
+    focusActiveTab() {
+        const screen = this.#screen;
+        if (!screen || screenDestroyed(screen))
+            return;
+        const focused = screen.focused;
+        if (focused && !focused.detached && focused.visible)
+            return;
+        this.#tabButtons.get(this.#activeTab)?.focus();
+    }
+    /** Renderiza somente enquanto a tela ainda pertence ao ciclo atual. */
+    renderScreen() {
+        if (this.#screen && !screenDestroyed(this.#screen))
+            this.#screen.render();
     }
     /**
      * Retorna um nível por vez: fecha modal, limpa busca e volta ao Home.
@@ -406,7 +445,13 @@ export class SpecsfyTui {
         if (this.#modal) {
             this.#modal.destroy();
             this.#modal = undefined;
-            this.#screen?.render();
+            const focus = this.#modalFocus;
+            this.#modalFocus = undefined;
+            if (focus && !focus.detached && focus.visible)
+                focus.focus();
+            else
+                this.focusActiveTab();
+            this.renderScreen();
             return;
         }
         if (this.#activeTab === "skills" && this.#skillQuery) {
@@ -520,7 +565,7 @@ export class SpecsfyTui {
             preview.setContent(item
                 ? renderMarkdown(formatBacklogPreview(item.content))
                 : "Crie arquivos em specs/backlog/<NNNN>-<slug>.md para visualizá-los aqui.");
-            this.#screen?.render();
+            this.renderScreen();
         };
         list.on("select item", updatePreview);
         list.on("keypress", updatePreview);
@@ -614,7 +659,9 @@ export class SpecsfyTui {
                 border: { fg: TUI_THEME.focusBackground },
             },
         });
+        this.#modalFocus = screen.focused;
         this.#modal = modal;
+        screen.focusPush(modal);
         modal.focus();
         screen.render();
     }
@@ -677,7 +724,7 @@ export class SpecsfyTui {
             this.showTab("tests");
         });
         if (this.#testResultTab === "summary") {
-            blessed.box({
+            this.#testSummaryPanel = blessed.box({
                 parent: body,
                 top: 6,
                 left: 1,
@@ -698,7 +745,7 @@ export class SpecsfyTui {
             // O blessed.log agenda a rolagem depois de setContent e acessa widgets
             // destruídos quando a saída ao vivo recria a aba. A caixa preserva a
             // rolagem sem deixar callbacks pendentes entre duas renderizações.
-            blessed.box({
+            this.#testOutputPanel = blessed.box({
                 parent: body,
                 top: 6,
                 left: 1,
@@ -720,9 +767,9 @@ export class SpecsfyTui {
         button.focus();
     }
     async runTests() {
-        this.showTab("tests");
-        if (this.#testRunning)
+        if (this.#modal || this.#testRunning)
             return;
+        this.showTab("tests");
         this.#testRunning = true;
         this.#testResultTab = "output";
         this.#testOutput = [];
@@ -732,27 +779,32 @@ export class SpecsfyTui {
         try {
             const result = await runProjectTests(this.project, (line) => {
                 this.#testOutput.push(line);
+                this.#testOutputPanel?.setContent(this.#testOutput.join("\n"));
                 if (this.#activeTab === "tests" && this.#testResultTab === "output") {
-                    this.showTab("tests");
+                    this.renderScreen();
                 }
             });
             this.#testSummary = formatTestRun(result);
+            this.#testSummaryPanel?.setContent(this.#testSummary);
             this.#testResultTab = "summary";
             this.showStatus(`${result.exit_code === 0 ? "Testes passaram" : "Testes falharam"} · ` +
                 `${result.duration_seconds.toFixed(2)}s · exit code ${result.exit_code}`);
-            this.showTab("tests");
+            if (this.#activeTab === "tests")
+                this.showTab("tests");
         }
         catch (error) {
             const message = `Erro ao executar testes: ${errorMessage(error)}`;
             this.#testSummary = message;
+            this.#testSummaryPanel?.setContent(message);
             this.#testOutput.push(message);
             this.#testResultTab = "summary";
             this.showStatus(message);
-            this.showTab("tests");
+            if (this.#activeTab === "tests")
+                this.showTab("tests");
         }
         finally {
             this.#testRunning = false;
-            this.#screen?.render();
+            this.renderScreen();
         }
     }
     renderSkills(body) {
@@ -904,7 +956,7 @@ export class SpecsfyTui {
             detail.setContent(option
                 ? formatSkillDetail(option, this.#installed, this.#selected, this.#detected)
                 : "Nenhuma skill visível.\n\nAjuste a busca ou os filtros para continuar.");
-            this.#screen?.render();
+            this.renderScreen();
         };
         list.on("select item", updateDetail);
         list.on("keypress", () => setImmediate(updateDetail));
@@ -956,7 +1008,18 @@ export class SpecsfyTui {
                 "Ctrl+Q encerra a interface.",
         });
     }
-    async refreshAll(reloadCatalog) {
+    refreshAll(reloadCatalog) {
+        if (this.#refreshPromise)
+            return this.#refreshPromise;
+        const promise = this.refreshAllInternal(reloadCatalog);
+        const tracked = promise.finally(() => {
+            if (this.#refreshPromise === tracked)
+                this.#refreshPromise = undefined;
+        });
+        this.#refreshPromise = tracked;
+        return tracked;
+    }
+    async refreshAllInternal(reloadCatalog) {
         try {
             const [specs, backlogs, lock] = await Promise.all([
                 scanSpecs(this.project),
@@ -965,8 +1028,8 @@ export class SpecsfyTui {
             ]);
             this.#specs = specs;
             this.#backlogs = backlogs;
-            this.#installed = new Set(Object.keys(lock.skills).filter(isSpecsfySkill));
-            this.#selected = new Set(this.#installed);
+            const installed = new Set(Object.keys(lock.skills).filter(isSpecsfySkill));
+            this.#installed = installed;
             if (reloadCatalog || !this.#catalog) {
                 try {
                     this.#catalog = await Catalog.fetch();
@@ -974,10 +1037,14 @@ export class SpecsfyTui {
                     this.#catalogError = "";
                 }
                 catch (error) {
-                    this.#catalogEntries = [];
                     this.#catalogError = errorMessage(error);
                 }
             }
+            const available = new Set(buildSkillOptions(this.#catalogEntries, installed).map((option) => option.name));
+            this.#selected = this.#loaded && this.#selectionDirty
+                ? new Set([...this.#selected].filter((name) => available.has(name)))
+                : new Set(installed);
+            this.#loaded = true;
             this.#fingerprints = {
                 specs: await specsFingerprint(this.project),
                 backlogs: await backlogsFingerprint(this.project),
@@ -1019,20 +1086,26 @@ export class SpecsfyTui {
     }
     selectFramework() {
         this.#selected = new Set([...this.#selected, ...FRAMEWORK_SKILLS]);
+        this.#selectionDirty = true;
         this.showStatus("As skills do framework foram selecionadas. Use ^A para aplicar.");
         this.showTab("skills");
     }
     async detectSkills() {
+        if (this.#modal)
+            return;
         this.showTab("skills");
+        const startedOnSkills = this.#activeTab === "skills";
         try {
             this.#catalog ??= await Catalog.fetch();
             this.#catalogEntries = this.#catalog.entries;
             const entries = await this.#catalog.detect(this.project);
             this.#detected = new Set(entries.map((entry) => entry.name));
             this.#selected = new Set([...this.#selected, ...this.#detected]);
+            this.#selectionDirty = true;
             this.#skillFilter = "detected";
             this.showStatus(`Skills detectadas e selecionadas: ${[...this.#detected].sort().join(", ") || "nenhuma skill"}`);
-            this.showTab("skills");
+            if (startedOnSkills && this.#activeTab === "skills")
+                this.showTab("skills");
         }
         catch (error) {
             this.showStatus(`Erro: ${errorMessage(error)}`);
@@ -1049,21 +1122,26 @@ export class SpecsfyTui {
         else {
             this.#selected.add(this.#selectedSkill);
         }
+        this.#selectionDirty = true;
         this.showTab("skills");
     }
     selectVisible() {
         this.#suppressSkillToggleUntil = Date.now() + 100;
         for (const option of this.visibleSkills())
             this.#selected.add(option.name);
+        this.#selectionDirty = true;
         this.showTab("skills");
     }
     clearVisible() {
         this.#suppressSkillToggleUntil = Date.now() + 100;
         for (const option of this.visibleSkills())
             this.#selected.delete(option.name);
+        this.#selectionDirty = true;
         this.showTab("skills");
     }
     async applySkills() {
+        if (this.#modal)
+            return;
         this.showTab("skills");
         try {
             const selected = new Set([...this.#selected].filter(isSpecsfySkill));
@@ -1093,6 +1171,7 @@ export class SpecsfyTui {
             }
             if (toRemove.length)
                 changed.push(...(await installer.remove(toRemove.sort())));
+            this.#selectionDirty = false;
             await this.refreshAll(false);
             this.showStatus(changed.length
                 ? `Seleção aplicada: ${changed.length} alteração(ões).`
@@ -1103,6 +1182,8 @@ export class SpecsfyTui {
         }
     }
     async updateSkills() {
+        if (this.#modal)
+            return;
         this.showTab("skills");
         try {
             const changed = await (await SkillInstaller.create(this.project)).updateAll();
@@ -1117,7 +1198,7 @@ export class SpecsfyTui {
     }
     showStatus(message) {
         this.#status?.setContent(message);
-        this.#screen?.render();
+        this.renderScreen();
     }
 }
 /** Cria as opções base, especialistas e instalações fora do catálogo atual. */
@@ -1299,4 +1380,8 @@ function terminalScrollbar() {
         style: { bg: TUI_THEME.focusBackground },
     };
 }
+/** Detecta o estado encerrado sem depender da tipagem incompleta do blessed. */
+function screenDestroyed(screen) {
+    return Boolean(screen.destroyed);
+}
 //# sourceMappingURL=tui.js.map