@dewtech/dare-cli 2.16.0 → 3.0.0

package/dist/utils/confidence.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Confidence & traceability for `dare reverse --report`.
+ *
+ * Parses the confidence markers the `/dare-reverse` skill writes into the
+ * Phase-0 specs (🟢 CONFIRMED / 🟡 INFERRED / 🔴 GAP) and computes a
+ * deterministic confidence index per spec plus a code↔spec traceability
+ * matrix. Because the index is *computed from markers* (not self-reported by
+ * an LLM), it is reproducible and auditable.
+ *
+ * Concept inspired by the Reversa framework (Macedo & da Costa,
+ * arXiv:2605.18684, 2026) — clean-room reimplementation, deterministic.
+ *
+ * License: MIT (part of DARE CLI).
+ */
+export type Marker = 'confirmed' | 'inferred' | 'gap';
+export interface ClaimCounts {
+    confirmed: number;
+    inferred: number;
+    gap: number;
+    total: number;
+}
+export interface SpecConfidence {
+    /** Spec label (e.g. `IDEIA.md`, `module-01-auth.md`). */
+    spec: string;
+    counts: ClaimCounts;
+    /** Confidence index 0–100 (one decimal): (🟢·1 + 🟡·0.5) / total. */
+    index: number;
+    /** Unique `path:line` evidence references cited in this spec. */
+    evidence: string[];
+}
+export declare function emptyCounts(): ClaimCounts;
+export declare function computeIndex(c: ClaimCounts): number;
+/** Parse one spec's markdown into confidence counts + evidence refs. */
+export declare function parseSpecConfidence(spec: string, content: string): SpecConfidence;
+export declare function aggregate(specs: SpecConfidence[]): {
+    counts: ClaimCounts;
+    index: number;
+};
+export declare function renderConfidenceReport(specs: SpecConfidence[], generatedAt: string): string;
+export declare function renderCodeSpecMatrix(specs: SpecConfidence[], generatedAt: string): string;
+//# sourceMappingURL=confidence.d.ts.map

package/dist/utils/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/utils/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAaD,wBAAgB,WAAW,IAAI,WAAW,CAEzC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAGnD;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAejF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASzF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAwB3F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBzF"}

package/dist/utils/confidence.js

@@ -0,0 +1,101 @@
+/**
+ * Confidence & traceability for `dare reverse --report`.
+ *
+ * Parses the confidence markers the `/dare-reverse` skill writes into the
+ * Phase-0 specs (🟢 CONFIRMED / 🟡 INFERRED / 🔴 GAP) and computes a
+ * deterministic confidence index per spec plus a code↔spec traceability
+ * matrix. Because the index is *computed from markers* (not self-reported by
+ * an LLM), it is reproducible and auditable.
+ *
+ * Concept inspired by the Reversa framework (Macedo & da Costa,
+ * arXiv:2605.18684, 2026) — clean-room reimplementation, deterministic.
+ *
+ * License: MIT (part of DARE CLI).
+ */
+// A claim line: list bullet + marker emoji + text.
+const MARKER_RE = /^\s*[-*]\s+(🟢|🟡|🔴)\s+/u;
+// Evidence reference inside backticks ending in `:<digits>` (e.g. `src/x.ts:42`).
+const EVIDENCE_RE = /`([^`]+?:\d+)`/gu;
+const MARKER_KIND = {
+    '🟢': 'confirmed',
+    '🟡': 'inferred',
+    '🔴': 'gap',
+};
+export function emptyCounts() {
+    return { confirmed: 0, inferred: 0, gap: 0, total: 0 };
+}
+export function computeIndex(c) {
+    if (c.total === 0)
+        return 0;
+    return Math.round(((c.confirmed + 0.5 * c.inferred) / c.total) * 1000) / 10;
+}
+/** Parse one spec's markdown into confidence counts + evidence refs. */
+export function parseSpecConfidence(spec, content) {
+    const counts = emptyCounts();
+    const evidence = new Set();
+    for (const line of content.split(/\r?\n/)) {
+        const m = MARKER_RE.exec(line);
+        if (!m)
+            continue;
+        counts[MARKER_KIND[m[1]]]++;
+        counts.total++;
+        EVIDENCE_RE.lastIndex = 0;
+        let e;
+        while ((e = EVIDENCE_RE.exec(line)) !== null)
+            evidence.add(e[1]);
+    }
+    return { spec, counts, index: computeIndex(counts), evidence: [...evidence].sort() };
+}
+export function aggregate(specs) {
+    const counts = emptyCounts();
+    for (const s of specs) {
+        counts.confirmed += s.counts.confirmed;
+        counts.inferred += s.counts.inferred;
+        counts.gap += s.counts.gap;
+        counts.total += s.counts.total;
+    }
+    return { counts, index: computeIndex(counts) };
+}
+export function renderConfidenceReport(specs, generatedAt) {
+    const { counts, index } = aggregate(specs);
+    const rows = specs.map((s) => `| ${s.spec} | ${s.counts.confirmed} | ${s.counts.inferred} | ${s.counts.gap} | ${s.index}% |`);
+    return [
+        '# Confidence Report — engenharia reversa',
+        '',
+        `*Gerado: ${generatedAt}*`,
+        '',
+        '> Marcação: 🟢 CONFIRMED (evidência direta no código) · 🟡 INFERRED (padrão/dedução) · 🔴 GAP (não determinável).',
+        '> Índice = (🟢·1.0 + 🟡·0.5) / total. **É a classificação do pipeline, não auditoria factual externa.**',
+        '',
+        '| Spec | 🟢 | 🟡 | 🔴 | Índice |',
+        '|---|---|---|---|---|',
+        ...rows,
+        `| **Total** | **${counts.confirmed}** | **${counts.inferred}** | **${counts.gap}** | **${index}%** |`,
+        '',
+        `**${counts.total} claims** · ${counts.gap} gap(s) para validação humana (ver \`gaps.md\`).`,
+        '',
+        '---',
+        '*DARE Method — Fase 0 brownfield. Conceito de confiança inspirado em Reversa (arXiv:2605.18684), '
+            + 'computado deterministicamente a partir dos marcadores. License: MIT.*',
+    ].join('\n') + '\n';
+}
+export function renderCodeSpecMatrix(specs, generatedAt) {
+    const rows = specs
+        .filter((s) => s.evidence.length > 0)
+        .map((s) => `| \`${s.spec}\` | ${s.evidence.map((e) => `\`${e}\``).join(', ')} |`);
+    return [
+        '# Code ↔ Spec Matrix (rastreabilidade)',
+        '',
+        `*Gerado: ${generatedAt}*`,
+        '',
+        'Cada spec e os arquivos de código citados como evidência nas suas afirmações.',
+        '',
+        '| Spec | Evidência (arquivo:linha) |',
+        '|---|---|',
+        ...(rows.length ? rows : ['| _(nenhuma evidência `arquivo:linha` citada ainda)_ | — |']),
+        '',
+        '---',
+        '*DARE Method — rastreabilidade brownfield. License: MIT.*',
+    ].join('\n') + '\n';
+}
+//# sourceMappingURL=confidence.js.map

package/dist/utils/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/utils/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH,mDAAmD;AACnD,MAAM,SAAS,GAAG,2BAA2B,CAAC;AAC9C,kFAAkF;AAClF,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAEvC,MAAM,WAAW,GAA2B;IAC1C,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAc;IACzC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAe;IAC/D,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAuB;IAC/C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAuB,EAAE,WAAmB;IACjF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,KAAK,CACtG,CAAC;IACF,OAAO;QACL,0CAA0C;QAC1C,EAAE;QACF,YAAY,WAAW,GAAG;QAC1B,EAAE;QACF,mHAAmH;QACnH,yGAAyG;QACzG,EAAE;QACF,kCAAkC;QAClC,uBAAuB;QACvB,GAAG,IAAI;QACP,mBAAmB,MAAM,CAAC,SAAS,UAAU,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,GAAG,UAAU,KAAK,OAAO;QACtG,EAAE;QACF,KAAK,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,GAAG,kDAAkD;QAC5F,EAAE;QACF,KAAK;QACL,mGAAmG;cAC/F,uEAAuE;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAuB,EAAE,WAAmB;IAC/E,MAAM,IAAI,GAAG,KAAK;SACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO;QACL,wCAAwC;QACxC,EAAE;QACF,YAAY,WAAW,GAAG;QAC1B,EAAE;QACF,+EAA+E;QAC/E,EAAE;QACF,sCAAsC;QACtC,WAAW;QACX,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC;QACxF,EAAE;QACF,KAAK;QACL,2DAA2D;KAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/utils/datamodel.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Deterministic data-model (ERD) + API-surface extraction for
+ * `dare reverse --deep` (Phase 3 brownfield).
+ *
+ * Line/regex-based — no AST — matching the rest of the CLI. Covers the common
+ * cases (SQL migrations, Prisma, light ORM relations, and routes for
+ * Express/Nest/Laravel/FastAPI/Gin); anything it can't parse is left for the
+ * `/dare-reverse` skill to complete (marked 🟡).
+ *
+ * Concept inspired by the Reversa Architect/Detective agents
+ * (Macedo & da Costa, arXiv:2605.18684, 2026) — clean-room, deterministic.
+ *
+ * License: MIT (part of DARE CLI).
+ */
+export interface EntityField {
+    name: string;
+    type: string;
+}
+export interface EntityRelation {
+    to: string;
+    kind: string;
+}
+export interface Entity {
+    name: string;
+    fields: EntityField[];
+    relations: EntityRelation[];
+    source: string;
+}
+export interface Endpoint {
+    method: string;
+    route: string;
+    source: string;
+}
+export interface DataModel {
+    entities: Entity[];
+    endpoints: Endpoint[];
+}
+export declare function extractDataModel(root: string): Promise<DataModel>;
+export declare function renderErd(model: DataModel, generatedAt: string): string;
+export declare function renderApiSurface(model: DataModel, generatedAt: string): string;
+//# sourceMappingURL=datamodel.d.ts.map

package/dist/utils/datamodel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datamodel.d.ts","sourceRoot":"","sources":["../../src/utils/datamodel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AA2CD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBvE;AAiVD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAwCvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmB9E"}