@promovaweb/specsfy 0.7.0

package/dist/cli.js

@@ -0,0 +1,258 @@
+/**
+ * Entrada pública do Specsfy CLI.
+ *
+ * Define a gramática de comandos e coordena módulos de domínio sem incorporar
+ * regras de instalação, catálogo ou progresso.
+ */
+import { Command, CommanderError, Option } from "commander";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { Catalog } from "./catalog.js";
+import { loadConfig, updateConfig } from "./config.js";
+import { SkillInstaller } from "./installer.js";
+import { scanSpecs, serializeSpec, specsFingerprint, summarizeSpecs, } from "./progress.js";
+import { runProjectTests } from "./project-testing.js";
+import { offerStartupUpdate } from "./updater.js";
+import { VERSION } from "./version.js";
+/** Constrói o parser público sem executar efeitos. */
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name("specsfy")
+        .description("Instala o Specsfy e acompanha especificações no terminal.")
+        .version(VERSION, "--version")
+        .showHelpAfterError()
+        .action(async () => {
+        await openTui(process.cwd());
+    });
+    program
+        .command("install")
+        .description("instala as skills do framework")
+        .addOption(projectOption())
+        .option("--force", "substitui arquivos gerenciados alterados")
+        .option("--detected", "instala também os especialistas detectados")
+        .option("--specialist <nome>", "especialista explícito; pode ser repetido", collect, [])
+        .option("--json", "emite resultado JSON")
+        .action(async (options) => {
+        const installer = await SkillInstaller.create(options.project, options.force);
+        const changed = await installer.installBase();
+        let specialistNames = [...options.specialist];
+        let catalog;
+        if (options.detected) {
+            catalog = await Catalog.fetch();
+            specialistNames.push(...(await catalog.detect(options.project)).map((entry) => entry.name));
+        }
+        if (specialistNames.length) {
+            catalog ??= await Catalog.fetch();
+            specialistNames = catalog.resolve(specialistNames).map((entry) => entry.name);
+            changed.push(...(await installer.installSpecialists(specialistNames)));
+        }
+        printInstallation(changed, Boolean(options.json));
+    });
+    const skills = program.command("skills").description("gerencia especialistas");
+    skills
+        .command("list")
+        .description("lista o catálogo")
+        .option("--json", "emite resultado JSON")
+        .action(async (options) => {
+        printCatalog((await Catalog.fetch()).entries, Boolean(options.json));
+    });
+    skills
+        .command("detect")
+        .description("detecta skills para o projeto")
+        .addOption(projectOption())
+        .option("--json", "emite resultado JSON")
+        .action(async (options) => {
+        const catalog = await Catalog.fetch();
+        printCatalog(await catalog.detect(options.project), Boolean(options.json));
+    });
+    skills
+        .command("add")
+        .description("instala especialistas")
+        .argument("<names...>", "nomes das skills")
+        .addOption(projectOption())
+        .option("--force", "substitui arquivos gerenciados alterados")
+        .action(async (names, options) => {
+        const catalog = await Catalog.fetch();
+        const resolved = catalog.resolve(names).map((entry) => entry.name);
+        const installer = await SkillInstaller.create(options.project, options.force);
+        printPaths(await installer.installSpecialists(resolved));
+    });
+    skills
+        .command("remove")
+        .description("remove skills instaladas")
+        .argument("<names...>", "nomes das skills")
+        .addOption(projectOption())
+        .option("--force", "remove arquivos gerenciados alterados")
+        .action(async (names, options) => {
+        const installer = await SkillInstaller.create(options.project, options.force);
+        printPaths(await installer.remove(names));
+    });
+    skills
+        .command("update")
+        .description("atualiza todas as skills Specsfy instaladas")
+        .addOption(projectOption())
+        .option("--force", "substitui arquivos gerenciados alterados")
+        .action(async (options) => {
+        const installer = await SkillInstaller.create(options.project, options.force);
+        printInstallation(await installer.updateAll(), false);
+    });
+    program
+        .command("progress")
+        .description("exibe progresso das specs")
+        .addOption(projectOption())
+        .option("--json", "emite resultado JSON")
+        .option("--watch", "emite novo resumo quando uma spec muda")
+        .option("--interval <segundos>", "intervalo do watch em segundos", Number)
+        .action(async (options) => runProgress(options));
+    program
+        .command("test")
+        .description("executa os testes do projeto")
+        .addOption(projectOption())
+        .action(async (options) => {
+        const result = await runProjectTests(options.project);
+        process.exitCode = result.exit_code;
+    });
+    program
+        .command("tui")
+        .description("abre a interface terminal")
+        .addOption(projectOption())
+        .action(async (options) => {
+        await openTui(options.project);
+    });
+    const config = program.command("config").description("configura o projeto consumidor");
+    config
+        .command("show")
+        .description("exibe a configuração efetiva")
+        .addOption(projectOption())
+        .option("--json", "emite resultado JSON")
+        .action(async (options) => {
+        printConfig(await loadConfig(options.project), Boolean(options.json));
+    });
+    config
+        .command("set")
+        .description("altera a configuração")
+        .addOption(projectOption())
+        .requiredOption("--watch-interval <segundos>", "intervalo de atualização", Number)
+        .option("--json", "emite resultado JSON")
+        .action(async (options) => {
+        printConfig(await updateConfig(options.project, options.watchInterval), Boolean(options.json));
+    });
+    return program;
+}
+/** Executa o CLI e converte falhas conhecidas em exit code previsível. */
+export async function runCli(argv = process.argv) {
+    const program = buildProgram();
+    program.exitOverride();
+    try {
+        await program.parseAsync(argv);
+        return Number(process.exitCode ?? 0);
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (error.code === "commander.helpDisplayed" ||
+                error.code === "commander.version") {
+                return 0;
+            }
+            return error.exitCode;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`erro: ${message}`);
+        return 1;
+    }
+}
+function projectOption() {
+    return new Option("--project <caminho>", "raiz do projeto consumidor").default(process.cwd());
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+async function openTui(project) {
+    const reader = createInterface({ input: stdin, output: stdout });
+    const shouldExit = await offerStartupUpdate(VERSION, (prompt) => reader.question(prompt));
+    reader.close();
+    if (shouldExit)
+        return;
+    const { SpecsfyTui } = await import("./tui.js");
+    await new SpecsfyTui(project).run();
+}
+async function runProgress(options) {
+    const configured = await loadConfig(options.project);
+    const interval = options.interval ?? configured.watch_interval;
+    if (!Number.isFinite(interval) || interval <= 0) {
+        throw new Error("interval deve ser maior que zero");
+    }
+    let previous = "";
+    while (true) {
+        const fingerprint = await specsFingerprint(options.project);
+        if (fingerprint !== previous) {
+            const specs = await scanSpecs(options.project);
+            printProgress(specs, Boolean(options.json));
+            previous = fingerprint;
+            if (!options.watch) {
+                if (!specs.length)
+                    process.exitCode = 2;
+                return;
+            }
+        }
+        await new Promise((resolve) => setTimeout(resolve, interval * 1000));
+    }
+}
+function printProgress(specs, json) {
+    const summary = summarizeSpecs(specs);
+    if (json) {
+        console.log(JSON.stringify({
+            summary,
+            specs: specs.map(serializeSpec),
+        }));
+        return;
+    }
+    console.log(`Resumo\t${summary.total_specs} specs\t` +
+        `${summary.completed_tasks}/${summary.total_tasks} tarefas\t` +
+        `${summary.completed_items}/${summary.total_items} itens\t` +
+        `${summary.percent}%`);
+    for (const spec of specs) {
+        console.log(`${spec.slug}\t${spec.status}\t` +
+            `${spec.completed_tasks}/${spec.total_tasks} tarefas\t` +
+            `${spec.completed_items}/${spec.total_items} itens\t${spec.percent}%`);
+    }
+}
+function printCatalog(entries, json) {
+    if (json) {
+        console.log(JSON.stringify(entries.map(({ name, description, category, tags, requires }) => ({
+            name,
+            description,
+            category,
+            tags,
+            requires,
+        }))));
+        return;
+    }
+    for (const entry of entries) {
+        console.log(`${entry.name}\t${entry.description}`);
+    }
+}
+function printConfig(config, json) {
+    if (json)
+        console.log(JSON.stringify(config));
+    else {
+        console.log(`project\t${config.project}`);
+        console.log(`watch_interval\t${config.watch_interval}`);
+    }
+}
+function printPaths(paths) {
+    for (const path of paths)
+        console.log(path);
+}
+function printInstallation(paths, json) {
+    if (json) {
+        console.log(JSON.stringify({ changed: paths.length, paths }));
+    }
+    else if (paths.length) {
+        printPaths(paths);
+    }
+    else {
+        console.log("skills já estão atualizadas");
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuração persistente por projeto.
+ */
+export declare const DEFAULT_WATCH_INTERVAL = 0.75;
+/** Configuração efetiva do projeto. */
+export interface ProjectConfig {
+    project: string;
+    watch_interval: number;
+}
+/** Carrega a configuração e aplica os valores padrão. */
+export declare function loadConfig(project: string): Promise<ProjectConfig>;
+/** Atualiza o intervalo preservando campos desconhecidos. */
+export declare function updateConfig(project: string, watchInterval: number): Promise<ProjectConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAOD,yDAAyD;AACzD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAMxE;AAED,6DAA6D;AAC7D,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,CAAC,CAWxB"}

package/dist/config.js

@@ -0,0 +1,44 @@
+/**
+ * Configuração persistente por projeto.
+ */
+import { join } from "node:path";
+import { isFile, readJson, resolvePath, writeTextAtomic } from "./filesystem.js";
+export const DEFAULT_WATCH_INTERVAL = 0.75;
+/** Carrega a configuração e aplica os valores padrão. */
+export async function loadConfig(project) {
+    const root = resolvePath(project);
+    const payload = await readPayload(root);
+    const interval = Number(payload.watch_interval ?? DEFAULT_WATCH_INTERVAL);
+    validateInterval(interval);
+    return { project: root, watch_interval: interval };
+}
+/** Atualiza o intervalo preservando campos desconhecidos. */
+export async function updateConfig(project, watchInterval) {
+    const root = resolvePath(project);
+    validateInterval(watchInterval);
+    const payload = await readPayload(root);
+    payload.schema_version = 1;
+    payload.watch_interval = watchInterval;
+    await writeTextAtomic(join(root, ".specsfy", "config.json"), `${JSON.stringify(payload, null, 2)}\n`);
+    return { project: root, watch_interval: watchInterval };
+}
+async function readPayload(project) {
+    const path = join(project, ".specsfy", "config.json");
+    if (!(await isFile(path)))
+        return { schema_version: 1 };
+    const payload = await readJson(path);
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw new Error(`configuração inválida: ${path}`);
+    }
+    const value = payload;
+    if ((value.schema_version ?? 1) !== 1) {
+        throw new Error("versão de configuração não suportada");
+    }
+    return value;
+}
+function validateInterval(interval) {
+    if (!Number.isFinite(interval) || interval <= 0) {
+        throw new Error("watch interval deve ser um número finito maior que zero");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAa3C,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,sBAAsB,CAAC,CAAC;IAC1E,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,aAAqB;IAErB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC;IACvC,MAAM,eAAe,CACnB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EACrC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACxC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,OAAwB,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/filesystem.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Utilitários compartilhados de filesystem.
+ *
+ * Centraliza resolução de caminhos, escrita atômica e varreduras pequenas
+ * usadas pelo CLI sem esconder operações destrutivas.
+ */
+/** Expande `~` e retorna um caminho absoluto normalizado. */
+export declare function resolvePath(value: string): string;
+/** Informa se um caminho existe, sem propagar a ausência como erro. */
+export declare function pathExists(path: string): Promise<boolean>;
+/** Informa se um caminho existente é um arquivo regular. */
+export declare function isFile(path: string): Promise<boolean>;
+/** Escreve texto UTF-8 por arquivo temporário no mesmo diretório. */
+export declare function writeTextAtomic(target: string, content: string, mode?: number): Promise<void>;
+/** Lê JSON e mantém o tipo como desconhecido até a validação do chamador. */
+export declare function readJson(path: string): Promise<unknown>;
+/** Lista arquivos recursivamente em ordem estável. */
+export declare function listFiles(root: string): Promise<string[]>;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,4DAA4D;AAC5D,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3D;AAED,qEAAqE;AACrE,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,6EAA6E;AAC7E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED,sDAAsD;AACtD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc/D"}

package/dist/filesystem.js

@@ -0,0 +1,67 @@
+/**
+ * Utilitários compartilhados de filesystem.
+ *
+ * Centraliza resolução de caminhos, escrita atômica e varreduras pequenas
+ * usadas pelo CLI sem esconder operações destrutivas.
+ */
+import { constants } from "node:fs";
+import { access, mkdir, readFile, readdir, rename, stat, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+/** Expande `~` e retorna um caminho absoluto normalizado. */
+export function resolvePath(value) {
+    const expanded = value === "~"
+        ? homedir()
+        : value.startsWith("~/")
+            ? join(homedir(), value.slice(2))
+            : value;
+    return isAbsolute(expanded) ? resolve(expanded) : resolve(process.cwd(), expanded);
+}
+/** Informa se um caminho existe, sem propagar a ausência como erro. */
+export async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Informa se um caminho existente é um arquivo regular. */
+export async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Escreve texto UTF-8 por arquivo temporário no mesmo diretório. */
+export async function writeTextAtomic(target, content, mode) {
+    await mkdir(dirname(target), { recursive: true });
+    const temporary = join(dirname(target), `.${basename(target) || "arquivo"}.${process.pid}.tmp`);
+    await writeFile(temporary, content, { encoding: "utf8", mode });
+    await rename(temporary, target);
+}
+/** Lê JSON e mantém o tipo como desconhecido até a validação do chamador. */
+export async function readJson(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+/** Lista arquivos recursivamente em ordem estável. */
+export async function listFiles(root) {
+    if (!(await pathExists(root))) {
+        return [];
+    }
+    const output = [];
+    for (const entry of await readdir(root, { withFileTypes: true })) {
+        const path = join(root, entry.name);
+        if (entry.isDirectory()) {
+            output.push(...(await listFiles(path)));
+        }
+        else if (entry.isFile() || entry.isSymbolicLink()) {
+            output.push(path);
+        }
+    }
+    return output.sort();
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Autenticação compartilhada para chamadas à API do GitHub.
+ */
+/** Monta os headers oficiais e inclui token quando disponível. */
+export declare function apiHeaders(userAgent: string, accept?: string): Promise<Record<string, string>>;
+/** Resolve a credencial sem persistir nem imprimir seu valor. */
+export declare function githubToken(): Promise<string | undefined>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,kEAAkE;AAClE,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,SAAgC,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASjC;AAED,iEAAiE;AACjE,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa/D"}

package/dist/github.js

@@ -0,0 +1,36 @@
+/**
+ * Autenticação compartilhada para chamadas à API do GitHub.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Monta os headers oficiais e inclui token quando disponível. */
+export async function apiHeaders(userAgent, accept = "application/vnd.github+json") {
+    const headers = {
+        Accept: accept,
+        "User-Agent": userAgent,
+        "X-GitHub-Api-Version": "2022-11-28",
+    };
+    const token = await githubToken();
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    return headers;
+}
+/** Resolve a credencial sem persistir nem imprimir seu valor. */
+export async function githubToken() {
+    for (const variable of ["GH_TOKEN", "GITHUB_TOKEN"]) {
+        const value = process.env[variable]?.trim();
+        if (value)
+            return value;
+    }
+    try {
+        const result = await execFileAsync("gh", ["auth", "token"], {
+            encoding: "utf8",
+        });
+        return result.stdout.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAiB,EACjB,MAAM,GAAG,6BAA6B;IAEtC,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,SAAS;QACvB,sBAAsB,EAAE,YAAY;KACrC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;IAClC,IAAI,KAAK;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,KAAK,MAAM,QAAQ,IAAI,CAAC,UAAU,EAAE,cAAc,CAAU,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAC1D,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/installer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Instalação idempotente do framework e das skills do Specsfy.
+ *
+ * A materialização é delegada ao CLI oficial `skills`; este módulo mantém os
+ * fingerprints, protege customizações e gerencia somente blocos identificados.
+ */
+export declare const MONOREPO_REPOSITORY = "https://github.com/promovaweb/specsfy.git";
+export declare const BASE_DIRECTORY = "skills";
+export declare const SPECIALISTS_DIRECTORY = "specialists";
+export declare const BASE_SKILLS: readonly ["specsfy-01-inbox", "specsfy-02-backlog", "specsfy-03-specify", "specsfy-04-validate", "specsfy-05-tasks", "specsfy-06-tdd-bdd", "specsfy-07-implement", "specsfy-update-spec", "specsfy-progress"];
+export declare const AUXILIARY_SKILLS: readonly ["specsfy-aux-stack", "specsfy-aux-rules", "specsfy-aux-database"];
+export declare const DOCUMENTATION_SKILLS: readonly ["specsfy-documentator"];
+export declare const FRAMEWORK_SKILLS: readonly ["specsfy-setup", "specsfy-aux-stack", "specsfy-aux-rules", "specsfy-aux-database", "specsfy-documentator", "specsfy-01-inbox", "specsfy-02-backlog", "specsfy-03-specify", "specsfy-04-validate", "specsfy-05-tasks", "specsfy-06-tdd-bdd", "specsfy-07-implement", "specsfy-update-spec", "specsfy-progress"];
+export declare const RENAMED_BASE_SKILLS: Readonly<Record<string, string>>;
+/** Instalador de um projeto consumidor explicitamente selecionado. */
+export declare class SkillInstaller {
+    readonly project: string;
+    readonly force: boolean;
+    private constructor();
+    /** Valida o destino e cria o lock oficial antes de liberar o instalador. */
+    static create(project: string, force?: boolean): Promise<SkillInstaller>;
+    /** Instala todo o framework base. */
+    installBase(): Promise<string[]>;
+    /** Instala um subconjunto válido do framework base. */
+    installBaseSelection(names: string[]): Promise<string[]>;
+    /** Instala framework estrutural e skills a partir de uma origem local. */
+    installBaseFromCheckout(checkout: string, names?: readonly string[]): Promise<string[]>;
+    /** Publica regras, templates, exemplo e blocos gerenciados. */
+    installFrameworkFromCheckout(checkout: string): Promise<string[]>;
+    /** Instala especialistas do catálogo oficial. */
+    installSpecialists(names: string[]): Promise<string[]>;
+    /** Atualiza todas as skills Specsfy já registradas. */
+    updateAll(): Promise<string[]>;
+    /** Clona uma origem temporária e instala as skills solicitadas. */
+    installFromRepository(repository: string, names: readonly string[], sourceName: string, directory?: string): Promise<string[]>;
+    /** Instala skills locais preservando alterações não autorizadas. */
+    installFromCheckout(checkout: string, names: readonly string[], sourceName: string): Promise<string[]>;
+    /** Remove somente nomes pertencentes ao Specsfy e protege customizações. */
+    remove(names: string[]): Promise<string[]>;
+    private validateSkillInstallation;
+    private legacyBaseTargets;
+    private removeLegacyBase;
+    private readLock;
+    private writeLock;
+}
+/** Calcula o fingerprint estável de uma skill, ignorando caches gerados. */
+export declare function skillDigest(path: string): Promise<string>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,eAAO,MAAM,mBAAmB,8CACa,CAAC;AAC9C,eAAO,MAAM,cAAc,WAAW,CAAC;AACvC,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,WAAW,YACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,CACV,CAAC;AACX,eAAO,MAAM,gBAAgB,YAC3B,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,CACd,CAAC;AACX,eAAO,MAAM,oBAAoB,YAAI,sBAAsB,CAAU,CAAC;AACtE,eAAO,MAAM,gBAAgB,0TAKnB,CAAC;AACX,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYhE,CAAC;AAmCF,sEAAsE;AACtE,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,OAAO,eAGN;IAED,4EAA4E;IAC5E,OAAa,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAK3E;IAED,qCAAqC;IAC/B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAErC;IAED,uDAAuD;IACjD,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW7D;IAED,0EAA0E;IACpE,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,SAAS,MAAM,EAAgB,GACrC,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;IAED,+DAA+D;IACzD,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwHtE;IAED,iDAAiD;IAC3C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO3D;IAED,uDAAuD;IACjD,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnC;IAED,mEAAmE;IAC7D,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;IAED,oEAAoE;IAC9D,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CA6EnB;IAED,4EAA4E;IACtE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsD/C;YAEa,yBAAyB;YAuBzB,iBAAiB;YAoBjB,gBAAgB;YAsBhB,QAAQ;YAeR,SAAS;CAMxB;AAmMD,4EAA4E;AAC5E,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB/D"}