expxdev 0.1.0

package/dist/nucleo/catalogo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * As cinco skills do ecossistema Expx.
+ *
+ * Fonte única do que o CLI sabe instalar. `papel` é o texto mostrado na seleção
+ * do `init`; `camada` marca as skills que, sozinhas, não fazem nada — elas
+ * modificam o comportamento da sprintx/runx em vez de agir por conta própria
+ * (ver `docs/expx-cli/base/08-repositorios-reais.md`).
+ */
+export type Skill = {
+    nome: string;
+    repositorio: string;
+    papel: string;
+    camada: boolean;
+};
+export declare const CATALOGO: readonly Skill[];
+/** Os nomes na ordem em que a seleção do `init` os apresenta. */
+export declare const NOMES: readonly string[];
+export declare function buscarNoCatalogo(nome: string): Skill | undefined;
+/** Camada é skill que sozinha não faz nada: precisa de sprintx ou runx junto. */
+export declare function ehCamada(nome: string): boolean;

package/dist/nucleo/catalogo.js

@@ -0,0 +1,50 @@
+/**
+ * As cinco skills do ecossistema Expx.
+ *
+ * Fonte única do que o CLI sabe instalar. `papel` é o texto mostrado na seleção
+ * do `init`; `camada` marca as skills que, sozinhas, não fazem nada — elas
+ * modificam o comportamento da sprintx/runx em vez de agir por conta própria
+ * (ver `docs/expx-cli/base/08-repositorios-reais.md`).
+ */
+export const CATALOGO = [
+    {
+        nome: "sprintx",
+        repositorio: "https://github.com/bittencourtthulio/sprintx",
+        papel: "planeja e executa features novas",
+        camada: false,
+    },
+    {
+        nome: "runx",
+        repositorio: "https://github.com/bittencourtthulio/runx",
+        papel: "ocorrencias de manutencao do dia a dia",
+        camada: false,
+    },
+    {
+        nome: "legadox",
+        repositorio: "https://github.com/bittencourtthulio/legadox",
+        papel: "camada para projetos legados",
+        camada: true,
+    },
+    {
+        nome: "stackx",
+        repositorio: "https://github.com/bittencourtthulio/stackx",
+        papel: "descobre o dialeto tecnico do repositorio",
+        camada: true,
+    },
+    {
+        nome: "mergex",
+        repositorio: "https://github.com/bittencourtthulio/mergex",
+        papel: "versionamento, entrega e revisao de pull requests",
+        camada: false,
+    },
+];
+/** Os nomes na ordem em que a seleção do `init` os apresenta. */
+export const NOMES = CATALOGO.map((s) => s.nome);
+export function buscarNoCatalogo(nome) {
+    return CATALOGO.find((s) => s.nome === nome);
+}
+/** Camada é skill que sozinha não faz nada: precisa de sprintx ou runx junto. */
+export function ehCamada(nome) {
+    return buscarNoCatalogo(nome)?.camada ?? false;
+}
+//# sourceMappingURL=catalogo.js.map

package/dist/nucleo/catalogo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogo.js","sourceRoot":"","sources":["../../src/nucleo/catalogo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,kCAAkC;QACzC,MAAM,EAAE,KAAK;KACd;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2CAA2C;QACxD,KAAK,EAAE,wCAAwC;QAC/C,MAAM,EAAE,KAAK;KACd;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,8BAA8B;QACrC,MAAM,EAAE,IAAI;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6CAA6C;QAC1D,KAAK,EAAE,2CAA2C;QAClD,MAAM,EAAE,IAAI;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6CAA6C;QAC1D,KAAK,EAAE,mDAAmD;QAC1D,MAAM,EAAE,KAAK;KACd;CACO,CAAC;AAEX,iEAAiE;AACjE,MAAM,CAAC,MAAM,KAAK,GAAsB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC;AACjD,CAAC"}

package/dist/nucleo/integridade.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Detecção de modificação local.
+ *
+ * Quem ajustou uma skill à mão não pode perder o trabalho por rodar um comando
+ * de rotina. Por isso o lock guarda o hash de CADA arquivo, e não um hash único
+ * da árvore: só assim o `update` consegue LISTAR quais arquivos mudaram, que é
+ * o que a decisão exige para oferecer manter, substituir ou salvar ao lado.
+ */
+export type Hashes = Record<string, string>;
+export type Divergencia = {
+    limpo: boolean;
+    alterados: string[];
+    removidos: string[];
+    novos: string[];
+};
+export declare function hashDoArquivo(caminho: string): string;
+/** O hash de cada arquivo da pasta, indexado pelo caminho relativo. */
+export declare function hashearPasta(raiz: string): Hashes;
+/** Compara o disco com os hashes do lock. `limpo: true` = nada mudou. */
+export declare function compararComHashes(raiz: string, esperados: Hashes): Divergencia;

package/dist/nucleo/integridade.js

@@ -0,0 +1,75 @@
+import { createHash } from "node:crypto";
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+const IGNORADAS = new Set([".git", "node_modules"]);
+function arquivosDe(raiz) {
+    const saida = [];
+    const fila = [raiz];
+    while (fila.length > 0) {
+        const dir = fila.shift();
+        if (dir === undefined)
+            break;
+        let entradas;
+        try {
+            entradas = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entradas) {
+            if (IGNORADAS.has(e))
+                continue;
+            const p = join(dir, e);
+            try {
+                if (statSync(p).isDirectory())
+                    fila.push(p);
+                else
+                    saida.push(p);
+            }
+            catch {
+                // entrada sumiu entre o readdir e o stat: ignora
+            }
+        }
+    }
+    return saida.sort();
+}
+/** Caminho relativo com separador normalizado, para o lock não depender do SO. */
+function chave(raiz, arquivo) {
+    return relative(raiz, arquivo).split(sep).join("/");
+}
+export function hashDoArquivo(caminho) {
+    return createHash("sha256").update(readFileSync(caminho)).digest("hex");
+}
+/** O hash de cada arquivo da pasta, indexado pelo caminho relativo. */
+export function hashearPasta(raiz) {
+    const saida = {};
+    for (const a of arquivosDe(raiz))
+        saida[chave(raiz, a)] = hashDoArquivo(a);
+    return saida;
+}
+/** Compara o disco com os hashes do lock. `limpo: true` = nada mudou. */
+export function compararComHashes(raiz, esperados) {
+    const atuais = hashearPasta(raiz);
+    const alterados = [];
+    const removidos = [];
+    const novos = [];
+    for (const [rel, hash] of Object.entries(esperados)) {
+        const atual = atuais[rel];
+        if (atual === undefined)
+            removidos.push(rel);
+        else if (atual !== hash)
+            alterados.push(rel);
+    }
+    for (const rel of Object.keys(atuais)) {
+        if (esperados[rel] === undefined)
+            novos.push(rel);
+    }
+    const norm = (l) => l.map((x) => x.split("/").join(sep)).sort();
+    return {
+        limpo: alterados.length === 0 && removidos.length === 0 && novos.length === 0,
+        alterados: norm(alterados),
+        removidos: norm(removidos),
+        novos: norm(novos),
+    };
+}
+//# sourceMappingURL=integridade.js.map

package/dist/nucleo/integridade.js.map

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

package/dist/nucleo/layout.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Normaliza os layouts de repositório de skill.
+ *
+ * Os cinco repositórios reais têm DOIS layouts distintos
+ * (`base/08-repositorios-reais.md`):
+ *
+ *   embutido — `.claude/skills/<nome>/` + `.claude/commands/`  (sprintx, stackx, mergex)
+ *   plano    — `skill/` + `commands/`                          (runx, legadox)
+ *
+ * Por isso a detecção NÃO assume caminho fixo: procura o `SKILL.md` e toma o
+ * diretório que o contém como raiz da skill. Um layout novo passa a funcionar
+ * sem alterar esta camada, desde que o `SKILL.md` exista em algum lugar.
+ */
+export type Layout = {
+    ok: true;
+    nome: string;
+    raizSkill: string;
+    comandos: string[];
+} | {
+    ok: false;
+    erro: string;
+};
+export declare function detectarLayout(raizRepo: string, nomeEsperado: string): Layout;

package/dist/nucleo/layout.js

@@ -0,0 +1,73 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, join } from "node:path";
+const IGNORADAS = new Set([".git", "node_modules", ".github", "dist"]);
+const CANDIDATAS_COMANDOS = [join(".claude", "commands"), "commands", join(".opencode", "commands"), join(".opencode", "command")];
+/** Procura o SKILL.md mais raso, ignorando pastas de infraestrutura. */
+function acharSkillMd(raiz, profundidadeMax = 5) {
+    const fila = [{ dir: raiz, nivel: 0 }];
+    while (fila.length > 0) {
+        const atual = fila.shift();
+        if (atual === undefined)
+            break;
+        if (atual.nivel > profundidadeMax)
+            continue;
+        let entradas;
+        try {
+            entradas = readdirSync(atual.dir);
+        }
+        catch {
+            continue;
+        }
+        if (entradas.includes("SKILL.md"))
+            return join(atual.dir, "SKILL.md");
+        for (const e of entradas) {
+            if (IGNORADAS.has(e))
+                continue;
+            const p = join(atual.dir, e);
+            try {
+                if (statSync(p).isDirectory())
+                    fila.push({ dir: p, nivel: atual.nivel + 1 });
+            }
+            catch {
+                // entrada sumiu entre o readdir e o stat: ignora
+            }
+        }
+    }
+    return undefined;
+}
+/** O `name:` do frontmatter, que no OpenCode precisa bater com o nome da pasta. */
+function nomeDoFrontmatter(skillMd) {
+    const bruto = readFileSync(skillMd, "utf8");
+    const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(bruto);
+    if (m === null)
+        return undefined;
+    const linha = /^name:\s*(.+)$/m.exec(m[1] ?? "");
+    return linha?.[1]?.trim().replace(/^["']|["']$/g, "");
+}
+/** Os arquivos de comando da skill, no primeiro diretório candidato que existir. */
+function acharComandos(raiz, nome) {
+    for (const c of CANDIDATAS_COMANDOS) {
+        const dir = join(raiz, c);
+        if (!existsSync(dir))
+            continue;
+        const arquivos = readdirSync(dir)
+            .filter((a) => a.endsWith(".md"))
+            .filter((a) => a === `${nome}.md` || a.startsWith(`${nome}-`))
+            .map((a) => join(dir, a));
+        if (arquivos.length > 0)
+            return arquivos;
+    }
+    return [];
+}
+export function detectarLayout(raizRepo, nomeEsperado) {
+    const skillMd = acharSkillMd(raizRepo);
+    if (skillMd === undefined)
+        return { ok: false, erro: `SKILL.md nao encontrado em ${raizRepo}` };
+    const raizSkill = join(skillMd, "..");
+    const nome = nomeDoFrontmatter(skillMd) ?? basename(raizSkill);
+    if (nome !== nomeEsperado) {
+        return { ok: false, erro: `nome da skill e "${nome}", esperado "${nomeEsperado}"` };
+    }
+    return { ok: true, nome, raizSkill, comandos: acharComandos(raizRepo, nome) };
+}
+//# sourceMappingURL=layout.js.map

package/dist/nucleo/layout.js.map

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

package/dist/nucleo/lock.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+/**
+ * O lock: o que está instalado, e em que versão exata.
+ *
+ * É commitado junto com `.expx/`. Quem clona o projeto recebe as skills já em
+ * disco e não precisa de rede nem de rodar o `init` para trabalhar — a
+ * instalação é travada por este arquivo, e só o `update` o reescreve.
+ *
+ * `arquivos` guarda o hash de cada arquivo instalado: é o que permite detectar
+ * modificação local e recusar sobrescrever trabalho manual (ver `integridade.ts`).
+ */
+export declare const VERSAO_LOCK = 1;
+export declare const SkillTravada: z.ZodObject<{
+    repositorio: z.ZodString;
+    referencia: z.ZodString;
+    travado: z.ZodBoolean;
+    commit: z.ZodString;
+    resolvido_em: z.ZodString;
+    arquivos: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type SkillTravada = z.infer<typeof SkillTravada>;
+export declare const Lock: z.ZodObject<{
+    lock_version: z.ZodNumber;
+    cli_version: z.ZodString;
+    harness: z.ZodArray<z.ZodString>;
+    skills: z.ZodRecord<z.ZodString, z.ZodObject<{
+        repositorio: z.ZodString;
+        referencia: z.ZodString;
+        travado: z.ZodBoolean;
+        commit: z.ZodString;
+        resolvido_em: z.ZodString;
+        arquivos: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Lock = z.infer<typeof Lock>;
+export type LeituraLock = {
+    ok: true;
+    lock: Lock;
+    incompativel: boolean;
+} | {
+    ok: false;
+    erro: string;
+};
+export declare function caminhoDoLock(raizProjeto: string): string;
+export declare function escreverLock(raizProjeto: string, lock: Lock): void;
+/**
+ * Compara duas versões `x.y.z`. Devolve >0 se `a` é maior.
+ *
+ * Usado para detectar estrutura criada por CLI MAIS NOVO que o em execução —
+ * caso em que o método manda parar com mensagem clara, nunca adivinhar.
+ */
+export declare function compararVersoes(a: string, b: string): number;
+/**
+ * A versão deste CLI, lida do package.json do próprio pacote.
+ *
+ * Fixar a versão em literal faria o lock "do futuro" ser detectado errado a
+ * cada publicação — o valor tem que vir da mesma fonte que o npm publica.
+ */
+export declare function versaoDoCli(): string;
+/** Lê o lock. Ausente ou inválido devolve `ok: false` — nunca lança. */
+export declare function lerLock(raizProjeto: string, versaoCliAtual?: string): LeituraLock;

package/dist/nucleo/lock.js

@@ -0,0 +1,96 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+/**
+ * O lock: o que está instalado, e em que versão exata.
+ *
+ * É commitado junto com `.expx/`. Quem clona o projeto recebe as skills já em
+ * disco e não precisa de rede nem de rodar o `init` para trabalhar — a
+ * instalação é travada por este arquivo, e só o `update` o reescreve.
+ *
+ * `arquivos` guarda o hash de cada arquivo instalado: é o que permite detectar
+ * modificação local e recusar sobrescrever trabalho manual (ver `integridade.ts`).
+ */
+export const VERSAO_LOCK = 1;
+export const SkillTravada = z.object({
+    repositorio: z.string().min(1),
+    referencia: z.string().min(1),
+    /** `false` quando a referência é branch: a skill não está em versão publicada. */
+    travado: z.boolean(),
+    commit: z.string().min(1),
+    resolvido_em: z.string().min(1),
+    arquivos: z.record(z.string(), z.string()),
+});
+export const Lock = z.object({
+    lock_version: z.number().int(),
+    cli_version: z.string().min(1),
+    harness: z.array(z.string()),
+    skills: z.record(z.string(), SkillTravada),
+});
+export function caminhoDoLock(raizProjeto) {
+    return join(raizProjeto, ".expx", "expx-lock.json");
+}
+export function escreverLock(raizProjeto, lock) {
+    const destino = caminhoDoLock(raizProjeto);
+    mkdirSync(join(destino, ".."), { recursive: true });
+    writeFileSync(destino, `${JSON.stringify(lock, null, 2)}\n`);
+}
+/**
+ * Compara duas versões `x.y.z`. Devolve >0 se `a` é maior.
+ *
+ * Usado para detectar estrutura criada por CLI MAIS NOVO que o em execução —
+ * caso em que o método manda parar com mensagem clara, nunca adivinhar.
+ */
+export function compararVersoes(a, b) {
+    const pa = a.split(".").map((n) => Number(n) || 0);
+    const pb = b.split(".").map((n) => Number(n) || 0);
+    for (let i = 0; i < 3; i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+/**
+ * A versão deste CLI, lida do package.json do próprio pacote.
+ *
+ * Fixar a versão em literal faria o lock "do futuro" ser detectado errado a
+ * cada publicação — o valor tem que vir da mesma fonte que o npm publica.
+ */
+export function versaoDoCli() {
+    for (const rel of ["../../package.json", "../package.json"]) {
+        try {
+            const p = join(dirname(fileURLToPath(import.meta.url)), rel);
+            const d = JSON.parse(readFileSync(p, "utf8"));
+            if (typeof d.version === "string")
+                return d.version;
+        }
+        catch {
+            // tenta o próximo candidato
+        }
+    }
+    return "0.0.0";
+}
+/** Lê o lock. Ausente ou inválido devolve `ok: false` — nunca lança. */
+export function lerLock(raizProjeto, versaoCliAtual = versaoDoCli()) {
+    const caminho = caminhoDoLock(raizProjeto);
+    if (!existsSync(caminho))
+        return { ok: false, erro: `lock nao encontrado em ${caminho}` };
+    let bruto;
+    try {
+        bruto = JSON.parse(readFileSync(caminho, "utf8"));
+    }
+    catch (e) {
+        return { ok: false, erro: `lock ilegivel: ${String(e)}` };
+    }
+    const r = Lock.safeParse(bruto);
+    if (!r.success)
+        return { ok: false, erro: `lock fora do formato: ${r.error.message}` };
+    return {
+        ok: true,
+        lock: r.data,
+        incompativel: compararVersoes(r.data.cli_version, versaoCliAtual) > 0,
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/nucleo/lock.js.map

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

package/dist/nucleo/versao.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Resolução de versão alvo de uma skill.
+ *
+ * A regra do método: por padrão, a MAIOR tag de versão semântica do
+ * repositório. Sem nenhuma tag, cai para a branch padrão e avisa
+ * explicitamente que a skill não está travada em versão publicada — nunca
+ * segue a branch em silêncio quando existe tag.
+ *
+ * Hoje NENHUMA das cinco skills tem tag (`base/08-repositorios-reais.md`), então
+ * o caminho de fallback é o corrente na prática, não a exceção.
+ */
+export type Alvo = {
+    ok: boolean;
+    /** Tag escolhida, ou a branch padrão quando não há tag. */
+    referencia: string;
+    /** `false` quando a referência é branch: a skill não está travada em versão publicada. */
+    travado: boolean;
+    erro?: string;
+};
+/**
+ * A maior tag semver da lista, ou `undefined` se nenhuma for semver.
+ *
+ * Compara número a número — ordenação de string colocaria `v1.10.0` antes de
+ * `v1.2.0`, que é o erro clássico e justamente o que o teste cobre.
+ */
+export declare function maiorTagSemver(tags: readonly string[]): string | undefined;
+/** As tags publicadas de um repositório, sem as referências desreferenciadas (`^{}`). */
+export declare function listarTags(repositorio: string): Promise<string[]>;
+/**
+ * A referência que deve ser instalada.
+ *
+ * Repositório inacessível NÃO lança: devolve `ok: false` com o motivo, porque o
+ * método exige que uma skill inacessível não aborte a instalação das demais.
+ */
+export declare function resolverAlvo(repositorio: string, forcar?: string): Promise<Alvo>;

package/dist/nucleo/versao.js

@@ -0,0 +1,63 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+const BRANCH_PADRAO = "main";
+/** `v1.2.3` → [1,2,3]. Pré-lançamento (`-rc.1`) é ignorado: não é versão publicada. */
+function partes(tag) {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(tag.trim());
+    if (m === null)
+        return undefined;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/**
+ * A maior tag semver da lista, ou `undefined` se nenhuma for semver.
+ *
+ * Compara número a número — ordenação de string colocaria `v1.10.0` antes de
+ * `v1.2.0`, que é o erro clássico e justamente o que o teste cobre.
+ */
+export function maiorTagSemver(tags) {
+    let melhor;
+    for (const tag of tags) {
+        const p = partes(tag);
+        if (p === undefined)
+            continue;
+        if (melhor === undefined ||
+            p[0] > melhor.p[0] ||
+            (p[0] === melhor.p[0] && p[1] > melhor.p[1]) ||
+            (p[0] === melhor.p[0] && p[1] === melhor.p[1] && p[2] > melhor.p[2])) {
+            melhor = { tag, p };
+        }
+    }
+    return melhor?.tag;
+}
+/** As tags publicadas de um repositório, sem as referências desreferenciadas (`^{}`). */
+export async function listarTags(repositorio) {
+    const { stdout } = await exec("git", ["ls-remote", "--tags", repositorio]);
+    return stdout
+        .split("\n")
+        .filter((l) => l.includes("refs/tags/") && !l.endsWith("^{}"))
+        .map((l) => l.slice(l.indexOf("refs/tags/") + "refs/tags/".length).trim())
+        .filter((t) => t !== "");
+}
+/**
+ * A referência que deve ser instalada.
+ *
+ * Repositório inacessível NÃO lança: devolve `ok: false` com o motivo, porque o
+ * método exige que uma skill inacessível não aborte a instalação das demais.
+ */
+export async function resolverAlvo(repositorio, forcar) {
+    if (forcar !== undefined && forcar !== "") {
+        return { ok: true, referencia: forcar, travado: !forcar.includes(BRANCH_PADRAO) };
+    }
+    try {
+        const tags = await listarTags(repositorio);
+        const maior = maiorTagSemver(tags);
+        if (maior !== undefined)
+            return { ok: true, referencia: maior, travado: true };
+        return { ok: true, referencia: BRANCH_PADRAO, travado: false };
+    }
+    catch (e) {
+        return { ok: false, referencia: "", travado: false, erro: String(e) };
+    }
+}
+//# sourceMappingURL=versao.js.map

package/dist/nucleo/versao.js.map

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

package/dist/parser/conformidade/regras.d.ts

@@ -0,0 +1,41 @@
+import type { Projeto } from "../projeto/montar.js";
+/**
+ * Violações do método — arquivos que o painel LEU e cujo conteúdo desobedece
+ * uma regra. Distinto de rejeição, que é falha de leitura (decisão D-03).
+ *
+ * Cada regra aqui tem um escopo estreito de propósito. A definição de pronto
+ * proíbe violação falsa, e todos os caminhos conhecidos para produzir uma
+ * nascem de aplicar uma regra a quem ela não se destina:
+ *
+ *  - regressão cobrada de trabalho sprintx, ou de runx que não é bug;
+ *  - critério de saída exigido de fase que não o declara por não existir;
+ *  - dependência inexistente acusada sem olhar o escopo do trabalho.
+ */
+export declare const TipoViolacao: {
+    readonly TesteAusente: "teste_ausente";
+    readonly RegressaoAusente: "regressao_ausente";
+    readonly ConcluidaSemVerde: "concluida_sem_verde";
+    readonly ParalelaComDependencia: "paralela_com_dependencia";
+    readonly SemCriterioSaida: "sem_criterio_saida";
+    readonly BloqueioAntigo: "bloqueio_antigo";
+    readonly DependenciaInexistente: "dependencia_inexistente";
+    readonly CicloDependencia: "ciclo_dependencia";
+    readonly EstagioIncoerente: "estagio_incoerente";
+};
+export type TipoViolacao = (typeof TipoViolacao)[keyof typeof TipoViolacao];
+export type Violacao = {
+    tipo: TipoViolacao;
+    trabalho_id: string;
+    /** id da task/fase/bloqueio a que a violação se refere. */
+    alvo: string;
+    arquivo: string;
+    linha: number | null;
+    detalhe: string;
+};
+export type OpcoesConformidade = {
+    /** "Hoje" entra como parâmetro: regra que lê o relógio não é testável (decisão D-16). */
+    hoje: Date;
+    /** Limite de dias para bloqueio antigo (decisão D-15). */
+    diasBloqueio: number;
+};
+export declare function verificarConformidade(projeto: Projeto, op: OpcoesConformidade): Violacao[];