@promovaweb/specsfy 0.7.0

package/dist/main.js

@@ -0,0 +1,13 @@
+/**
+ * Processo executável do Specsfy CLI.
+ */
+import { runCli } from "./cli.js";
+void runCli()
+    .then((exitCode) => {
+    process.exitCode = exitCode;
+})
+    .catch((error) => {
+    console.error(`erro: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,MAAM,EAAE;KACV,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;IACjB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/progress.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Projeção de progresso das especificações Markdown.
+ */
+/** Métricas e conteúdo de uma especificação. */
+export interface SpecProgress {
+    slug: string;
+    title: string;
+    path: string;
+    content: string;
+    status: string;
+    definition_gate: string;
+    plan_gate: string;
+    delivery_gate: string;
+    passed_gates: number;
+    total_gates: number;
+    completed_tasks: number;
+    pending_tasks: number;
+    total_tasks: number;
+    completed_items: number;
+    pending_items: number;
+    total_items: number;
+    percent: number;
+}
+/** Totais consolidados de uma coleção de specs. */
+export interface ProgressSummary {
+    total_specs: number;
+    completed_specs: number;
+    completed_tasks: number;
+    pending_tasks: number;
+    total_tasks: number;
+    completed_items: number;
+    pending_items: number;
+    total_items: number;
+    passed_gates: number;
+    total_gates: number;
+    percent: number;
+}
+/** Lê specs no layout canônico e no layout legado. */
+export declare function scanSpecs(project: string): Promise<SpecProgress[]>;
+/** Consolida as métricas das specs fornecidas. */
+export declare function summarizeSpecs(specs: SpecProgress[]): ProgressSummary;
+/** Calcula o fingerprint dos caminhos e conteúdos de spec. */
+export declare function specsFingerprint(project: string): Promise<string>;
+/** Remove o conteúdo bruto antes de serializar a resposta pública. */
+export declare function serializeSpec(spec: SpecProgress): Omit<SpecProgress, "content">;
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGxE;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,eAAe,CAwBrE;AAED,8DAA8D;AAC9D,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcvE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAG/E"}

package/dist/progress.js

@@ -0,0 +1,148 @@
+/**
+ * Projeção de progresso das especificações Markdown.
+ */
+import { createHash } from "node:crypto";
+import { readFile, readdir } from "node:fs/promises";
+import { basename, dirname, join, relative } from "node:path";
+import { isFile, resolvePath } from "./filesystem.js";
+const FIELD = /^\*\*([^*]+)\*\*:\s*(.+?)\s*$/;
+const TABLE_FIELD = /^\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*$/;
+const CHECKLIST_ITEM = /^\s*[-*+]\s*\[([ xX])\]\s+(.+?)\s*$/;
+const TASK_ID = /^(?:\*\*|`)?T\d+\b/i;
+const GATE_NAMES = ["definition gate", "plan gate", "delivery gate"];
+/** Lê specs no layout canônico e no layout legado. */
+export async function scanSpecs(project) {
+    const root = resolvePath(project);
+    return Promise.all((await specPaths(root)).map(parseSpec));
+}
+/** Consolida as métricas das specs fornecidas. */
+export function summarizeSpecs(specs) {
+    const completedItems = sum(specs, "completed_items");
+    const totalItems = sum(specs, "total_items");
+    const completedTasks = sum(specs, "completed_tasks");
+    const totalTasks = sum(specs, "total_tasks");
+    const passedGates = sum(specs, "passed_gates");
+    const totalGates = sum(specs, "total_gates");
+    return {
+        total_specs: specs.length,
+        completed_specs: specs.filter((spec) => spec.status.toLowerCase() === "complete")
+            .length,
+        completed_tasks: completedTasks,
+        pending_tasks: totalTasks - completedTasks,
+        total_tasks: totalTasks,
+        completed_items: completedItems,
+        pending_items: totalItems - completedItems,
+        total_items: totalItems,
+        passed_gates: passedGates,
+        total_gates: totalGates,
+        percent: ratio(totalItems ? completedItems : passedGates, totalItems ? totalItems : totalGates),
+    };
+}
+/** Calcula o fingerprint dos caminhos e conteúdos de spec. */
+export async function specsFingerprint(project) {
+    const root = resolvePath(project);
+    const digest = createHash("sha256");
+    for (const path of await specPaths(root)) {
+        digest.update(relative(root, path));
+        digest.update("\0");
+        try {
+            digest.update(await readFile(path));
+        }
+        catch {
+            continue;
+        }
+        digest.update("\0");
+    }
+    return digest.digest("hex");
+}
+/** Remove o conteúdo bruto antes de serializar a resposta pública. */
+export function serializeSpec(spec) {
+    const { content: _content, ...serialized } = spec;
+    return serialized;
+}
+async function specPaths(root) {
+    const paths = new Set();
+    for (const parent of [
+        join(root, "specs", "specs"),
+        join(root, "specs"),
+    ]) {
+        let entries;
+        try {
+            entries = await readdir(parent, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const path = join(parent, entry.name, "spec.md");
+            if (await isFile(path))
+                paths.add(path);
+        }
+    }
+    return [...paths].sort();
+}
+async function parseSpec(path) {
+    const content = await readFile(path, "utf8");
+    const slug = basename(dirname(path));
+    let title = slug;
+    let completedTasks = 0;
+    let totalTasks = 0;
+    let completedItems = 0;
+    let totalItems = 0;
+    const fields = new Map();
+    for (const line of content.split(/\r?\n/u)) {
+        if (line.startsWith("# ") && title === slug)
+            title = line.slice(2).trim();
+        const field = FIELD.exec(line) ?? TABLE_FIELD.exec(line);
+        if (field?.[1] && field[2]) {
+            fields.set(field[1].trim().toLowerCase(), field[2].trim());
+        }
+        const item = CHECKLIST_ITEM.exec(line);
+        if (!item)
+            continue;
+        const done = item[1]?.toLowerCase() === "x";
+        totalItems += 1;
+        completedItems += Number(done);
+        if (TASK_ID.test(item[2] ?? "")) {
+            totalTasks += 1;
+            completedTasks += Number(done);
+        }
+    }
+    const passedGates = GATE_NAMES.filter((name) => fields.get(name)?.toLowerCase() === "passed").length;
+    const totalGates = GATE_NAMES.length;
+    return {
+        slug,
+        title,
+        path,
+        content,
+        status: fields.get("status") ?? "Unknown",
+        definition_gate: fields.get("definition gate") ?? "Unknown",
+        plan_gate: fields.get("plan gate") ?? "Unknown",
+        delivery_gate: fields.get("delivery gate") ?? "Unknown",
+        passed_gates: passedGates,
+        total_gates: totalGates,
+        completed_tasks: completedTasks,
+        pending_tasks: totalTasks - completedTasks,
+        total_tasks: totalTasks,
+        completed_items: completedItems,
+        pending_items: totalItems - completedItems,
+        total_items: totalItems,
+        percent: ratio(totalItems ? completedItems : passedGates, totalItems ? totalItems : totalGates),
+    };
+}
+function sum(specs, key) {
+    return specs.reduce((total, spec) => total + spec[key], 0);
+}
+function ratio(completed, total) {
+    if (!total)
+        return 0;
+    const value = (completed * 100) / total;
+    const floor = Math.floor(value);
+    const fraction = value - floor;
+    if (fraction !== 0.5)
+        return Math.round(value);
+    return floor % 2 === 0 ? floor : floor + 1;
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,KAAK,GAAG,+BAA+B,CAAC;AAC9C,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAC9D,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAC7D,MAAM,OAAO,GAAG,qBAAqB,CAAC;AACtC,MAAM,UAAU,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,CAAU,CAAC;AAsC9E,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7C,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC;aAC9E,MAAM;QACT,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,UAAU,GAAG,cAAc;QAC1C,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,UAAU,GAAG,cAAc;QAC1C,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,KAAK,CACZ,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,EACzC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CACrC;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAClD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI;QACnB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;QACF,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACjD,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI;YAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,GAAG,CAAC;QAC5C,UAAU,IAAI,CAAC,CAAC;QAChB,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAChC,UAAU,IAAI,CAAC,CAAC;YAChB,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CACnC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,QAAQ,CACvD,CAAC,MAAM,CAAC;IACT,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;IACrC,OAAO;QACL,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS;QACzC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,SAAS;QAC3D,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS;QAC/C,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS;QACvD,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,UAAU,GAAG,cAAc;QAC1C,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,UAAU,GAAG,cAAc;QAC1C,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,KAAK,CACZ,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,EACzC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CACrC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CACV,KAAqB,EACrB,GAMiB;IAEjB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,KAAK,CAAC,SAAiB,EAAE,KAAa;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/B,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/project-testing.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Detecção e execução segura dos testes do projeto consumidor.
+ */
+/** Comando de teste detectado sem interpretação por shell. */
+export interface TestCommand {
+    label: string;
+    argv: readonly string[];
+    cwd: string;
+    display: string;
+}
+/** Resultado de uma execução do runner do consumidor. */
+export interface TestRun {
+    command: TestCommand;
+    exit_code: number;
+    duration_seconds: number;
+    summary_lines: string[];
+}
+/** Detecta Laravel com Pest sem executar código do projeto. */
+export declare function detectProjectTestCommand(project: string): Promise<TestCommand>;
+/** Executa o runner detectado, transmite linhas e preserva o exit code. */
+export declare function runProjectTests(project: string, emit?: (line: string) => void, signal?: AbortSignal): Promise<TestRun>;
+/** Formata uma linha JSON estruturada do Pest ou preserva texto comum. */
+export declare function presentOutputLine(line: string): {
+    lines: string[];
+    summary: string[];
+};
+//# sourceMappingURL=project-testing.d.ts.map

package/dist/project-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-testing.d.ts","sourceRoot":"","sources":["../src/project-testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAED,2EAA2E;AAC3E,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,EAC1C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAyCA"}

package/dist/project-testing.js

@@ -0,0 +1,150 @@
+/**
+ * Detecção e execução segura dos testes do projeto consumidor.
+ */
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import { performance } from "node:perf_hooks";
+import { isFile, pathExists, resolvePath } from "./filesystem.js";
+import { assertConsumerProject } from "./skill-lock.js";
+/** Detecta Laravel com Pest sem executar código do projeto. */
+export async function detectProjectTestCommand(project) {
+    const root = resolvePath(project);
+    if (!(await pathExists(root))) {
+        throw new Error(`projeto não encontrado: ${root}`);
+    }
+    await assertConsumerProject(root);
+    if ((await isFile(join(root, "artisan"))) && (await usesPest(root))) {
+        const argv = ["php", "artisan", "test"];
+        return {
+            label: "Laravel Pest",
+            argv,
+            cwd: root,
+            display: argv.join(" "),
+        };
+    }
+    throw new Error("Pest não foi detectado no projeto. " +
+        "É esperado um projeto Laravel com artisan e pestphp/pest.");
+}
+/** Executa o runner detectado, transmite linhas e preserva o exit code. */
+export async function runProjectTests(project, emit = console.log, signal) {
+    const command = await detectProjectTestCommand(project);
+    const startedAt = performance.now();
+    const lines = [];
+    let structuredSummary = [];
+    const [executable, ...arguments_] = command.argv;
+    if (!executable)
+        throw new Error("comando de teste vazio");
+    const child = spawn(executable, arguments_, {
+        cwd: command.cwd,
+        env: { ...process.env, NO_COLOR: process.env.NO_COLOR ?? "1" },
+        stdio: ["ignore", "pipe", "pipe"],
+        signal,
+    });
+    if (!child.stdout)
+        throw new Error("não foi possível capturar a saída do Pest");
+    const consume = (line) => {
+        const presented = presentOutputLine(line);
+        lines.push(...presented.lines);
+        if (presented.summary.length)
+            structuredSummary = presented.summary;
+        for (const item of presented.lines)
+            emit(item);
+    };
+    createInterface({ input: child.stdout, crlfDelay: Infinity }).on("line", consume);
+    if (child.stderr) {
+        createInterface({ input: child.stderr, crlfDelay: Infinity }).on("line", consume);
+    }
+    const exitCode = await new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("close", (code) => resolve(code ?? 1));
+    });
+    return {
+        command,
+        exit_code: exitCode,
+        duration_seconds: (performance.now() - startedAt) / 1000,
+        summary_lines: structuredSummary.length
+            ? structuredSummary
+            : summaryLines(lines),
+    };
+}
+/** Formata uma linha JSON estruturada do Pest ou preserva texto comum. */
+export function presentOutputLine(line) {
+    let payload;
+    try {
+        payload = JSON.parse(line);
+    }
+    catch {
+        return { lines: [line], summary: [] };
+    }
+    if (!payload ||
+        typeof payload !== "object" ||
+        payload.tool !== "pest" ||
+        typeof payload.result !== "string") {
+        return { lines: [line], summary: [] };
+    }
+    const value = payload;
+    const total = integer(value.tests);
+    const passed = integer(value.passed);
+    const errors = integer(value.errors);
+    const assertions = integer(value.assertions);
+    const duration = integer(value.duration_ms);
+    const summary = [
+        `Tests: ${total} total · ${passed} passed · ${errors} errors`,
+        `Assertions: ${assertions}`,
+        `Duration: ${(duration / 1000).toFixed(2)}s`,
+    ];
+    const lines = [];
+    if (Array.isArray(value.error_details)) {
+        for (const detail of value.error_details) {
+            if (!detail || typeof detail !== "object")
+                continue;
+            const error = detail;
+            lines.push(`FAIL  ${String(error.test ?? "Teste desconhecido")}`, `      ${String(error.file ?? "arquivo desconhecido")}:${String(error.line ?? "?")}`, `      ${String(error.message ?? "Erro sem mensagem")}`, "");
+        }
+    }
+    if (!lines.length)
+        lines.push(summary[0]);
+    return { lines, summary };
+}
+async function usesPest(root) {
+    if ((await isFile(join(root, "tests", "Pest.php"))) ||
+        (await isFile(join(root, "vendor", "bin", "pest")))) {
+        return true;
+    }
+    const path = join(root, "composer.json");
+    if (!(await isFile(path)))
+        return false;
+    let payload;
+    try {
+        payload = JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`composer.json inválido em ${root}: ${message}`);
+    }
+    if (!payload || typeof payload !== "object" || Array.isArray(payload))
+        return false;
+    const dependencies = new Set();
+    for (const section of ["require", "require-dev"]) {
+        const value = payload[section];
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            for (const dependency of Object.keys(value))
+                dependencies.add(dependency);
+        }
+    }
+    return dependencies.has("pestphp/pest");
+}
+function summaryLines(lines) {
+    const markers = ["tests:", "duration:", "passed", "failed", "skipped", "todo"];
+    return lines
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 &&
+        markers.some((marker) => line.toLowerCase().includes(marker)))
+        .slice(-3);
+}
+function integer(value) {
+    return Number.isInteger(value) ? value : 0;
+}
+//# sourceMappingURL=project-testing.js.map

package/dist/project-testing.js.map

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

package/dist/skill-lock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Contrato do `skills-lock.json` gerado pelo gerenciador oficial de skills.
+ */
+export declare const LOCK_FILENAME = "skills-lock.json";
+/** Estrutura mínima compatível com o CLI `skills`. */
+export interface SkillsLock {
+    version: 1;
+    skills: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** Cria um lock vazio em memória. */
+export declare function emptySkillsLock(): SkillsLock;
+/** Lê o lock ou materializa a estrutura mínima quando ele não existe. */
+export declare function ensureSkillsLock(project: string): Promise<SkillsLock>;
+/** Lê e valida o lock oficial sem criá-lo. */
+export declare function readSkillsLock(project: string): Promise<SkillsLock>;
+/** Retorna os nomes registrados no lock. */
+export declare function installedSkillNames(project: string, create?: boolean): Promise<Set<string>>;
+/** Retorna um fingerprint barato do lock para polling da TUI. */
+export declare function skillsLockFingerprint(project: string): Promise<string>;
+/** Impede instalação na raiz oficial do monorepo Specsfy. */
+export declare function assertConsumerProject(project: string): Promise<void>;
+//# sourceMappingURL=skill-lock.d.ts.map

package/dist/skill-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lock.d.ts","sourceRoot":"","sources":["../src/skill-lock.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ3E;AAED,8CAA8C;AAC9C,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBzE;AAED,4CAA4C;AAC5C,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,UAAO,GACZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAKtB;AAED,iEAAiE;AACjE,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5E;AAED,6DAA6D;AAC7D,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1E"}

package/dist/skill-lock.js

@@ -0,0 +1,80 @@
+/**
+ * Contrato do `skills-lock.json` gerado pelo gerenciador oficial de skills.
+ */
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { isFile, readJson, resolvePath, writeTextAtomic, } from "./filesystem.js";
+export const LOCK_FILENAME = "skills-lock.json";
+/** Cria um lock vazio em memória. */
+export function emptySkillsLock() {
+    return { version: 1, skills: {} };
+}
+/** Lê o lock ou materializa a estrutura mínima quando ele não existe. */
+export async function ensureSkillsLock(project) {
+    const root = resolvePath(project);
+    await assertConsumerProject(root);
+    const path = join(root, LOCK_FILENAME);
+    if (!(await isFile(path))) {
+        await writeTextAtomic(path, `${JSON.stringify(emptySkillsLock(), null, 2)}\n`);
+    }
+    return readSkillsLock(root);
+}
+/** Lê e valida o lock oficial sem criá-lo. */
+export async function readSkillsLock(project) {
+    const root = resolvePath(project);
+    const path = join(root, LOCK_FILENAME);
+    if (!(await isFile(path)))
+        return emptySkillsLock();
+    let payload;
+    try {
+        payload = await readJson(path);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`lock inválido: ${path}: ${message}`);
+    }
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw new Error(`lock inválido: ${path}`);
+    }
+    const lock = payload;
+    if (lock.version !== 1) {
+        throw new Error(`versão de lock não suportada em ${path}`);
+    }
+    if (!lock.skills || typeof lock.skills !== "object" || Array.isArray(lock.skills)) {
+        throw new Error(`campo skills inválido em ${path}`);
+    }
+    return lock;
+}
+/** Retorna os nomes registrados no lock. */
+export async function installedSkillNames(project, create = true) {
+    const payload = create
+        ? await ensureSkillsLock(project)
+        : await readSkillsLock(project);
+    return new Set(Object.keys(payload.skills));
+}
+/** Retorna um fingerprint barato do lock para polling da TUI. */
+export async function skillsLockFingerprint(project) {
+    const path = join(resolvePath(project), LOCK_FILENAME);
+    if (!(await isFile(path)))
+        return "missing";
+    try {
+        const metadata = await stat(path, { bigint: true });
+        return `${metadata.mtimeNs}:${metadata.size}`;
+    }
+    catch {
+        return "unreadable";
+    }
+}
+/** Impede instalação na raiz oficial do monorepo Specsfy. */
+export async function assertConsumerProject(project) {
+    const path = join(resolvePath(project), "AGENTS.md");
+    if (!(await isFile(path)))
+        return;
+    const { readFile } = await import("node:fs/promises");
+    const content = (await readFile(path, "utf8")).toLowerCase();
+    if (content.includes("monorepo oficial do specsfy") ||
+        content.includes("workspace specsfy dev")) {
+        throw new Error("operação recusada no monorepo oficial do Specsfy");
+    }
+}
+//# sourceMappingURL=skill-lock.js.map

package/dist/skill-lock.js.map

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