@nac3/forge-cli 1.21.3 → 1.23.0

package/dist/urazuke/heuristics.js

@@ -0,0 +1,248 @@
+/**
+ * THE FORTY-FIVE RULES, RESOLVED AGAINST THE DEFINITION IN FORCE
+ * (Annex H, layers 1 to 3 -- pieces 1, 2, 3 reaching the evaluator).
+ *
+ * Everything in here is READ from the gate definition the project is being
+ * measured by: the rule ids, the group they belong to, the instrument, the
+ * severity, which rules a machine may not judge (`human_red`), the
+ * thresholds and which of them the method declares. Nothing is a constant
+ * of Forge. That is the whole point: on 2026-10-27 this tool was measuring
+ * two thresholds it had invented (`max_complexity=10` standing in for
+ * CQ-04's undeclared `paths_per_function`, and a `dup_block_lines=8` with
+ * no rule id at all), which is the one thing the annex forbids outright.
+ *
+ * THE SHAPE OF THE PROJECT'S OWN DECLARATIONS is published too, and the
+ * field names are the method's, not ours: frontend, real_users, switches,
+ * switched_off, thresholds, tools (`project_config.fields`). They live in
+ * <root>/.forge/project-settings.json. They are the VALUES; the published
+ * `project_config` is the SCHEMA, and the two must not share a field --
+ * before this slice `resolveGates` wrote the values over the schema, so a
+ * consumer asking the definition for the field names got a project's
+ * answers instead.
+ *
+ * WHAT THIS MODULE REFUSES TO GUESS. The evaluator `heuristics` asks that
+ * every active rule have "an instrument, a severity and a checker". The
+ * data publishes the first two per rule. The third it does not: 29 of the
+ * 45 rules say `checker_declared_by: adapter`, and the adapter table is a
+ * POINTER -- `adapters.annex_columns.note` says the text of every cell
+ * lives only in the annex, and the pointer covers 6 rules of 45. The other
+ * 16 say `owner`, and the field name the owner would write it in is not
+ * published either (`adapters.measured_by.illustrative: true`, with the
+ * warning that an installation taking those names as defaults "is
+ * inventing layer 2"). So the checker resolves to `not_published` and the
+ * gate reports it as something it COULD NOT VERIFY. Not green, not red:
+ * named. Inventing the cell here would be the same defect this file was
+ * written to delete.
+ *
+ * ASCII-only.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readManualCases } from './manual_cases.js';
+export * from './scoreboard.js';
+export function projectSettingsPath(root) {
+    return path.join(root, '.forge', 'project-settings.json');
+}
+export async function readProjectSettings(root) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(projectSettingsPath(root), 'utf8'));
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+            return parsed;
+    }
+    catch { /* no declarations: that is a gap the report names, not an error */ }
+    return undefined;
+}
+function isRec(v) {
+    return v != null && typeof v === 'object' && !Array.isArray(v);
+}
+const RECORD_FIELDS = ['rule', 'reason', 'authorized_by', 'review_date'];
+/** A switch-off record, or the list of what is missing from it. The method
+ *  is explicit that an incomplete record is not a lenient switch-off: it is
+ *  red, and it makes the whole ruleset invalid (D-046, D-047). */
+export function switchOffProblems(entry, index) {
+    if (!isRec(entry)) {
+        return { problems: ['switched_off[' + index + '] no es un registro: ' + JSON.stringify(entry ?? null)] };
+    }
+    const rule = typeof entry['rule'] === 'string' ? entry['rule'] : undefined;
+    const problems = [];
+    for (const f of RECORD_FIELDS) {
+        const v = entry[f];
+        if (typeof v !== 'string' || v.trim() === '') {
+            problems.push('apagada sin un registro completo: ' + (rule ?? 'switched_off[' + index + ']')
+                + ' no trae ' + f);
+        }
+    }
+    return { ...(rule ? { rule } : {}), problems };
+}
+function severityOf(rule, realUsers, declaredThresholdIds) {
+    const base = String(rule['initial_severity'] ?? 'records');
+    const esc = rule['escalates_to'];
+    /* CQ-18 escalates to `blocks` when the product has users outside the
+     * organisation, and the method says the escalation "requires a
+     * declaration by the owner, through the same mechanism as any threshold"
+     * (D-048). So real_users alone does not escalate it: without the owner's
+     * declaration it stays where the catalogue put it, and the report says
+     * the escalation is pending a declaration. */
+    if (isRec(esc) && realUsers && declaredThresholdIds.has(String(rule['id']))) {
+        return { severity: String(esc['severity'] ?? base), source: 'escalated' };
+    }
+    return { severity: base, source: 'catalog' };
+}
+function thresholdsOf(adapters, settings) {
+    const declared = isRec(adapters) && Array.isArray(adapters['thresholds'])
+        ? adapters['thresholds']
+        : [];
+    const own = settings?.thresholds ?? {};
+    return declared.filter(isRec).map((t) => {
+        const id = String(t['id']);
+        const rule = String(t['rule'] ?? '');
+        if (Object.prototype.hasOwnProperty.call(own, id) && own[id] != null) {
+            return { id, rule, value: own[id], declared: true, source: 'project' };
+        }
+        if (t['declared'] === true && t['value'] != null) {
+            return { id, rule, value: t['value'], declared: true, source: 'annex' };
+        }
+        /* Not declared anywhere: reported as undeclared. No approximating, no
+         * silent inheriting and no inventing (adapters.undeclared_threshold). */
+        return { id, rule, value: null, declared: false, source: 'undeclared' };
+    });
+}
+export async function resolveRuleset(opts) {
+    const settings = opts.settings ?? await readProjectSettings(opts.projectRoot);
+    const h = isRec(opts.gates.heuristics) ? opts.gates.heuristics : {};
+    const publishedRules = Array.isArray(h['rules']) ? h['rules'].filter(isRec) : [];
+    const scoreboard = isRec(h['scoreboard']) ? h['scoreboard'] : {};
+    const outsideNamed = new Set((Array.isArray(scoreboard['human_outside_the_percentage'])
+        ? scoreboard['human_outside_the_percentage']
+        : []).filter((x) => typeof x === 'string' && /^[A-Z]{2}-\d\d$/.test(x)));
+    const realUsers = settings?.real_users === true;
+    /* ---- the switch-off list, and whether it is a valid ruleset ---- */
+    const problems = [];
+    const invalidating = [];
+    const offRecords = new Map();
+    const offIds = new Set();
+    const rawOff = Array.isArray(settings?.switched_off) ? settings?.switched_off : [];
+    rawOff.forEach((entry, i) => {
+        const r = switchOffProblems(entry, i);
+        if (r.rule)
+            offIds.add(r.rule);
+        if (r.problems.length) {
+            problems.push(...r.problems);
+            invalidating.push(...r.problems);
+            return;
+        }
+        offRecords.set(r.rule, entry);
+    });
+    /* ---- the group switches ---- */
+    const groupOff = [];
+    for (const [group, sw] of Object.entries(settings?.switches ?? {})) {
+        if (sw === true)
+            continue;
+        if (!isRec(sw)) {
+            const p = 'switches.' + group + ' no es ni true ni un registro de apagado';
+            problems.push(p);
+            invalidating.push(p);
+            continue;
+        }
+        const missing = ['reason', 'authorized_by', 'review_date']
+            .filter((f) => typeof sw[f] !== 'string' || String(sw[f]).trim() === '');
+        if (missing.length) {
+            const p = 'el grupo ' + group + ' esta apagado sin un registro completo: falta ' + missing.join(', ');
+            problems.push(p);
+            invalidating.push(p);
+            continue;
+        }
+        groupOff.push(group);
+    }
+    const thresholds = thresholdsOf(opts.gates.adapters, settings);
+    /* The escalation of a severity travels "through the same mechanism as any
+     * threshold" (D-048), so the owner declares it as a `thresholds` entry
+     * keyed by the rule id. The method publishes no threshold id for it, which
+     * is why this is the rule id and not one of the five published ones. */
+    const ownerDeclared = new Set(Object.keys(settings?.thresholds ?? {}));
+    const couldNotVerify = [];
+    const rules = publishedRules.map((raw) => {
+        const id = String(raw['id']);
+        const group = String(raw['group'] ?? '');
+        const instrument = Array.isArray(raw['instrument']) ? raw['instrument'].map(String) : [];
+        const humanRed = raw['human_red'] === true;
+        const { severity, source } = severityOf(raw, realUsers, ownerDeclared);
+        const appliesIf = typeof raw['applies_if'] === 'string' ? raw['applies_if'] : undefined;
+        let state = 'active';
+        let why;
+        if (groupOff.includes(group)) {
+            state = 'group_off';
+            why = 'the group ' + group + ' is switched off, and a switched-off group is never read as fulfilled';
+        }
+        else if (offRecords.has(id)) {
+            const rec = offRecords.get(id);
+            state = 'switched_off';
+            why = 'switched off by ' + rec.authorized_by + ', review ' + rec.review_date + ': ' + rec.reason;
+        }
+        else if (appliesIf === 'real_users' && !realUsers) {
+            state = 'out_of_scope';
+            why = 'applies_if real_users, and this project declares real_users=false: that is scope, not an exception';
+        }
+        /* `checker_declared_by` says WHO declares what measures the rule; the
+         * data does not carry the cell itself (see the header). */
+        const checker = 'not_published';
+        const outside = humanRed || instrument.includes('manual_case') || outsideNamed.has(id);
+        return {
+            id, group,
+            family: String(raw['family'] ?? ''),
+            instrument,
+            severity, severity_source: source,
+            state,
+            human_red: humanRed,
+            in_percentage: state === 'active' && !outside,
+            passing: false,
+            measured: false,
+            checker,
+            ...(offRecords.has(id) ? { record: offRecords.get(id) } : {}),
+            ...(why ? { why } : {}),
+        };
+    });
+    for (const r of publishedRules) {
+        if (isRec(r['escalates_to']) && realUsers && !ownerDeclared.has(String(r['id']))) {
+            couldNotVerify.push('la regla ' + String(r['id']) + ' escala su severidad cuando el producto tiene'
+                + ' usuarios fuera de la organizacion, y la escalada necesita que el dueno la declare por el mismo'
+                + ' mecanismo que cualquier umbral -- la definicion en vigor no publica ningun id de umbral para'
+                + ' ella, asi que esta instalacion no distingue una escalada pendiente de una declinada.');
+        }
+    }
+    const activeNeedingChecker = rules.filter((r) => r.state === 'active').length;
+    if (activeNeedingChecker > 0) {
+        couldNotVerify.push('con que se mide cada regla: la definicion en vigor no publica la celda del'
+            + ' adaptador (adapters.annex_columns es un puntero al anexo y cubre 6 reglas de 45) ni publica el'
+            + ' nombre del campo donde el dueno la declararia (adapters.measured_by.illustrative=true). '
+            + activeNeedingChecker + ' reglas activas no tienen entonces NINGUN medidor alcanzable, y esta'
+            + ' instalacion lo reporta en lugar de inventar uno.');
+    }
+    if (!settings) {
+        problems.push('este proyecto no declara nada: falta .forge/project-settings.json, asi que ningun grupo'
+            + ' esta declarado activo y no hay umbral, adaptador ni version de herramienta en el registro');
+    }
+    else {
+        for (const g of ['code_quality', 'usability']) {
+            if (!Object.prototype.hasOwnProperty.call(settings.switches ?? {}, g)) {
+                problems.push('el grupo ' + g + ' no esta declarado en switches: el metodo pide una entrada por grupo');
+            }
+        }
+    }
+    /* A ruleset is INVALID only when something was switched off without its
+     * record (D-046/D-047). A missing declaration is a red verdict with the
+     * figures still emitted; an invalid ruleset emits no figures at all. */
+    return {
+        catalog_version: String(opts.gates.catalog_version ?? opts.gates.version ?? 'unknown'),
+        adapter: settings?.frontend ?? null,
+        tools: settings?.tools ?? {},
+        real_users: realUsers,
+        rules,
+        thresholds,
+        group_off: groupOff,
+        validity: { ok: invalidating.length === 0, problems, invalidating },
+        could_not_verify: couldNotVerify,
+        manual_cases: await readManualCases(opts.projectRoot),
+    };
+}
+//# sourceMappingURL=heuristics.js.map

package/dist/urazuke/heuristics.js.map

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

package/dist/urazuke/manual_cases.d.ts

@@ -0,0 +1,31 @@
+export type ManualVerdict = 'passed' | 'failed';
+export interface ManualCase {
+    /** The rule id the verdict is about (CQ-12, UX-22, ...). */
+    rule: string;
+    verdict: ManualVerdict;
+    /** The person who judged it. Never a tool, never "the agent". */
+    judged_by: string;
+    /** ISO date (YYYY-MM-DD) or a full ISO timestamp. */
+    at: string;
+    /** The profile the case was run under, when the project has profiles.
+     *  `manual_cases_per_profile` needs one run per affected profile; this
+     *  field is what will let that evaluator be measured without a migration. */
+    profile?: string;
+    note?: string;
+}
+export interface ManualCaseLedger {
+    version: 1;
+    cases: ManualCase[];
+}
+export declare function manualCasesPath(root: string): string;
+export declare function readManualCases(root: string): Promise<ManualCaseLedger>;
+/** A stored entry only counts when it still carries the four things that
+ *  make it a verdict. A hand-edited ledger that lost a name loses the
+ *  verdict with it -- it does not inherit a green. */
+export declare function isVerdict(c: unknown): c is ManualCase;
+export declare function recordManualCase(root: string, c: ManualCase): Promise<ManualCaseLedger>;
+/** The verdict in force for a rule: the LAST recorded one. Undefined means
+ *  nobody signed, which is neither a pass nor a fail and must never be
+ *  rendered as either. */
+export declare function verdictFor(led: ManualCaseLedger, rule: string, profile?: string): ManualCase | undefined;
+//# sourceMappingURL=manual_cases.d.ts.map

package/dist/urazuke/manual_cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual_cases.d.ts","sourceRoot":"","sources":["../../src/urazuke/manual_cases.ts"],"names":[],"mappings":"AA6BA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX;;iFAE6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ7E;AAED;;sDAEsD;AACtD,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAOrD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB7F;AAED;;0BAE0B;AAC1B,wBAAgB,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGxG"}

package/dist/urazuke/manual_cases.js

@@ -0,0 +1,87 @@
+/**
+ * THE HUMAN VERDICT ON RECORD (Annex H, pieza 5).
+ *
+ * Four of the forty-five rules carry `human_red: true` in the published
+ * data -- CQ-12, CQ-14, UX-22 and UX-27 as of catalog 2026.10.6 -- and the
+ * method's `manual_case` instrument says what such a verdict IS: "passed or
+ * failed, with a name and a date", judged by a person. The list is read
+ * from the definition in force, never from this file: a rule that gains
+ * `human_red` in a later catalogue is picked up without an install.
+ *
+ * Why a ledger and not a boolean. Before this module the `owner` state
+ * existed in the gate and signed nothing: a step with nothing mechanical to
+ * look at came out as "the owner verifies it", and the close gate let it
+ * through (`orchestrator.ts` treated only `red` and `unmeasured` as
+ * blocking). So the strongest claim in the method -- a person looked at
+ * this and said yes -- was the one claim with no evidence behind it. The
+ * ledger makes it a record with a name and a date, or it makes it absent.
+ *
+ * What is refused on write. A verdict with an empty `judged_by` or an empty
+ * `at` is not a verdict with a missing field, it is not a verdict: an
+ * anonymous or undated signature is exactly the "green without having
+ * looked" this whole slice exists to remove. `recordManualCase` throws
+ * instead of storing it.
+ *
+ * ASCII-only.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export function manualCasesPath(root) {
+    return path.join(root, '.forge', 'urazuke-manual-cases.json');
+}
+export async function readManualCases(root) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(manualCasesPath(root), 'utf8'));
+        if (parsed && parsed.version === 1 && Array.isArray(parsed.cases)) {
+            return { version: 1, cases: parsed.cases.filter(isVerdict) };
+        }
+    }
+    catch { /* no ledger yet: that is "nobody signed", not an error */ }
+    return { version: 1, cases: [] };
+}
+/** A stored entry only counts when it still carries the four things that
+ *  make it a verdict. A hand-edited ledger that lost a name loses the
+ *  verdict with it -- it does not inherit a green. */
+export function isVerdict(c) {
+    if (c == null || typeof c !== 'object')
+        return false;
+    const r = c;
+    return typeof r['rule'] === 'string' && String(r['rule']).trim() !== ''
+        && (r['verdict'] === 'passed' || r['verdict'] === 'failed')
+        && typeof r['judged_by'] === 'string' && String(r['judged_by']).trim() !== ''
+        && typeof r['at'] === 'string' && String(r['at']).trim() !== '';
+}
+export async function recordManualCase(root, c) {
+    if (!c || typeof c.rule !== 'string' || c.rule.trim() === '') {
+        throw new Error('a manual case needs the rule it judges');
+    }
+    if (c.verdict !== 'passed' && c.verdict !== 'failed') {
+        throw new Error('verdict has to be passed or failed: ' + String(c.verdict));
+    }
+    if (typeof c.judged_by !== 'string' || c.judged_by.trim() === '') {
+        throw new Error('judged_by is empty: an anonymous verdict is not a verdict (rule ' + c.rule + ')');
+    }
+    if (typeof c.at !== 'string' || c.at.trim() === '') {
+        throw new Error('at is empty: an undated verdict is not a verdict (rule ' + c.rule + ')');
+    }
+    const led = await readManualCases(root);
+    /* Append-only by design: the previous verdict stays visible, and the
+     * latest one for a (rule, profile) pair is the one that counts. The
+     * history is how a reviewer sees a red that turned green and when. */
+    led.cases.push({
+        rule: c.rule, verdict: c.verdict, judged_by: c.judged_by, at: c.at,
+        ...(c.profile ? { profile: c.profile } : {}),
+        ...(c.note ? { note: c.note } : {}),
+    });
+    await fs.mkdir(path.dirname(manualCasesPath(root)), { recursive: true });
+    await fs.writeFile(manualCasesPath(root), JSON.stringify(led, null, 2) + '\n', 'utf8');
+    return led;
+}
+/** The verdict in force for a rule: the LAST recorded one. Undefined means
+ *  nobody signed, which is neither a pass nor a fail and must never be
+ *  rendered as either. */
+export function verdictFor(led, rule, profile) {
+    const matching = led.cases.filter((c) => c.rule === rule && (profile == null || c.profile === profile));
+    return matching.length ? matching[matching.length - 1] : undefined;
+}
+//# sourceMappingURL=manual_cases.js.map

package/dist/urazuke/manual_cases.js.map

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

package/dist/urazuke/project_config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PROJECT CONFIGURATION: validation and semantics.
+ *
+ * A project's .forge/project-config.json can declare switches to
+ * turn off rules of the method. Each off-switch requires a 4-field
+ * audit record (rule, reason, authorized_by, review_date), and
+ * an evaluator can only read a rule as off if the record is complete.
+ *
+ * ASCII-only.
+ */
+export interface SwitchOffRecord {
+    rule: string;
+    reason: string;
+    authorized_by: string;
+    review_date: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    invalid: string[];
+    problems: string[];
+}
+export declare function isSwitchOffValid(record: unknown): record is SwitchOffRecord;
+export declare function validateSwitchOffRecord(records: unknown): ValidationResult;
+export declare function isRuleSwitchedOff(rule: string, switched_off: string[] | undefined, switch_off_record: unknown): boolean;
+//# sourceMappingURL=project_config.d.ts.map

package/dist/urazuke/project_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_config.d.ts","sourceRoot":"","sources":["../../src/urazuke/project_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,eAAe,CAM3E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAkC1E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,EAClC,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAQT"}

package/dist/urazuke/project_config.js

@@ -0,0 +1,65 @@
+/**
+ * PROJECT CONFIGURATION: validation and semantics.
+ *
+ * A project's .forge/project-config.json can declare switches to
+ * turn off rules of the method. Each off-switch requires a 4-field
+ * audit record (rule, reason, authorized_by, review_date), and
+ * an evaluator can only read a rule as off if the record is complete.
+ *
+ * ASCII-only.
+ */
+const REQUIRED_FIELDS = ['rule', 'reason', 'authorized_by', 'review_date'];
+function isRecord(v) {
+    return v != null && typeof v === 'object' && !Array.isArray(v);
+}
+export function isSwitchOffValid(record) {
+    if (!isRecord(record))
+        return false;
+    for (const field of REQUIRED_FIELDS) {
+        if (typeof record[field] !== 'string')
+            return false;
+    }
+    return true;
+}
+export function validateSwitchOffRecord(records) {
+    const invalid = [];
+    const problems = [];
+    const input = Array.isArray(records) ? records : [];
+    for (const rec of input) {
+        if (!isRecord(rec)) {
+            /* Reading `.rule` off this is what used to throw: a null left behind
+             * by a hand-edited config crashed the validator instead of being
+             * reported as the invalid entry it is. */
+            invalid.push('?');
+            problems.push('record is not an object: ' + JSON.stringify(rec ?? null));
+            continue;
+        }
+        const rule = rec.rule;
+        if (typeof rule !== 'string') {
+            invalid.push('?');
+            problems.push('rule is not a string');
+            continue;
+        }
+        for (const field of REQUIRED_FIELDS) {
+            if (typeof rec[field] !== 'string') {
+                invalid.push(rule);
+                problems.push(`rule ${rule}: ${field} is missing or not a string`);
+                break;
+            }
+        }
+    }
+    return {
+        ok: invalid.length === 0,
+        invalid,
+        problems,
+    };
+}
+export function isRuleSwitchedOff(rule, switched_off, switch_off_record) {
+    const list = switched_off ?? [];
+    if (!list.includes(rule))
+        return false;
+    const records = Array.isArray(switch_off_record) ? switch_off_record : [];
+    const recordForRule = records.find((r) => isRecord(r) && r.rule === rule);
+    return isSwitchOffValid(recordForRule);
+}
+//# sourceMappingURL=project_config.js.map

package/dist/urazuke/project_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_config.js","sourceRoot":"","sources":["../../src/urazuke/project_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAE3E,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB;;sDAE0C;YAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,2BAA2B,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;YACzE,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACtC,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,6BAA6B,CAAC,CAAC;gBACnE,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACxB,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,YAAkC,EAClC,iBAA0B;IAE1B,MAAM,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE1E,OAAO,gBAAgB,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC"}

package/dist/urazuke/quality.d.ts

@@ -2,9 +2,6 @@ import { type StackAdapter } from './stacks.js';
 export interface QualityLimits {
     max_file_lines: number;
     max_function_lines: number;
-    max_complexity: number;
-    /** Lines in a duplicated block to count it. */
-    dup_block_lines: number;
 }
 export declare const DEFAULT_LIMITS: QualityLimits;
 export interface Violation {
@@ -20,8 +17,6 @@ export interface NativeMeasure {
     violations: Violation[];
     max_file_lines: number;
     max_function_lines: number;
-    max_complexity: number;
-    duplicated_blocks: number;
 }
 interface FnSpan {
     name: string;
@@ -39,14 +34,12 @@ export interface Ratchet {
     coverage_pct?: number;
     mutation_score?: number;
     violations?: number;
-    duplicated_blocks?: number;
     updated_at: number;
     history: Array<{
         at: number;
         coverage_pct?: number;
         mutation_score?: number;
         violations: number;
-        duplicated_blocks: number;
     }>;
 }
 export declare function ratchetPath(root: string): string;
@@ -63,7 +56,6 @@ export declare function applyRatchet(prev: Ratchet, m: {
     coverage_pct?: number;
     mutation_score?: number;
     violations: number;
-    duplicated_blocks: number;
 }, now?: number): RatchetVerdict;
 export interface QualityCheckResult {
     stack: StackAdapter;

package/dist/urazuke/quality.d.ts.map

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

package/dist/urazuke/quality.js

@@ -18,7 +18,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { detectStack, readCoveragePct, readMutationScore } from './stacks.js';
-export const DEFAULT_LIMITS = { max_file_lines: 300, max_function_lines: 40, max_complexity: 10, dup_block_lines: 8 };
+export const DEFAULT_LIMITS = { max_file_lines: 300, max_function_lines: 40 };
 /* ---------------- scanning ---------------- */
 async function walk(root, a) {
     const out = [];
@@ -121,27 +121,9 @@ export async function measureNative(root, a, limits = DEFAULT_LIMITS) {
             maxCx = Math.max(maxCx, fn.complexity);
             if (len > limits.max_function_lines)
                 violations.push({ kind: 'function_lines', where: rel + ':' + fn.start + ' ' + fn.name, value: len, limit: limits.max_function_lines });
-            if (fn.complexity > limits.max_complexity)
-                violations.push({ kind: 'complexity', where: rel + ':' + fn.start + ' ' + fn.name, value: fn.complexity, limit: limits.max_complexity });
-        }
-        const norm = code.map(normalise).filter((l) => l.length > 12);
-        for (let i = 0; i + limits.dup_block_lines <= norm.length; i++) {
-            const key = norm.slice(i, i + limits.dup_block_lines).join('\n');
-            const arr = blocks.get(key) ?? [];
-            arr.push(rel + ':' + (i + 1));
-            blocks.set(key, arr);
-        }
-    }
-    let dup = 0;
-    for (const [, where] of blocks) {
-        const distinctFiles = new Set(where.map((w) => w.split(':')[0]));
-        if (where.length > 1 && (distinctFiles.size > 1 || where.length > 2)) {
-            dup += 1;
-            if (violations.filter((v) => v.kind === 'duplication').length < 50)
-                violations.push({ kind: 'duplication', where: where.slice(0, 3).join(' = '), value: where.length, limit: 1 });
         }
     }
-    return { files: files.length, lines, functions, violations, max_file_lines: maxFile, max_function_lines: maxFn, max_complexity: maxCx, duplicated_blocks: dup };
+    return { files: files.length, lines, functions, violations, max_file_lines: maxFile, max_function_lines: maxFn };
 }
 export function ratchetPath(root) { return path.join(root, '.forge', 'quality-ratchet.json'); }
 export async function readRatchet(root) {
@@ -167,16 +149,13 @@ export function applyRatchet(prev, m, now = Date.now()) {
         reasons.push('mutation score dropped ' + prev.mutation_score + ' -> ' + m.mutation_score);
     if (prev.violations != null && m.violations > prev.violations)
         reasons.push('violations rose ' + prev.violations + ' -> ' + m.violations);
-    if (prev.duplicated_blocks != null && m.duplicated_blocks > prev.duplicated_blocks)
-        reasons.push('duplicated blocks rose ' + prev.duplicated_blocks + ' -> ' + m.duplicated_blocks);
     const ok = reasons.length === 0;
     const next = {
         version: 1, updated_at: now,
         coverage_pct: ok ? Math.max(prev.coverage_pct ?? -1, m.coverage_pct ?? -1) : prev.coverage_pct,
         mutation_score: ok ? Math.max(prev.mutation_score ?? -1, m.mutation_score ?? -1) : prev.mutation_score,
         violations: ok ? Math.min(prev.violations ?? Infinity, m.violations) : prev.violations,
-        duplicated_blocks: ok ? Math.min(prev.duplicated_blocks ?? Infinity, m.duplicated_blocks) : prev.duplicated_blocks,
-        history: [...prev.history.slice(-199), { at: now, ...(m.coverage_pct != null ? { coverage_pct: m.coverage_pct } : {}), ...(m.mutation_score != null ? { mutation_score: m.mutation_score } : {}), violations: m.violations, duplicated_blocks: m.duplicated_blocks }],
+        history: [...prev.history.slice(-199), { at: now, ...(m.coverage_pct != null ? { coverage_pct: m.coverage_pct } : {}), ...(m.mutation_score != null ? { mutation_score: m.mutation_score } : {}), violations: m.violations }],
     };
     if (next.coverage_pct === -1)
         delete next.coverage_pct;
@@ -184,8 +163,6 @@ export function applyRatchet(prev, m, now = Date.now()) {
         delete next.mutation_score;
     if (next.violations === Infinity)
         delete next.violations;
-    if (next.duplicated_blocks === Infinity)
-        delete next.duplicated_blocks;
     return { ok, reasons, next };
 }
 export async function runQualityCheck(root, opts = {}) {
@@ -215,7 +192,7 @@ export async function runQualityCheck(root, opts = {}) {
         mutation_score = (await readMutationScore(root, stack, r.output))?.score;
     }
     const prev = await readRatchet(root);
-    const ratchet = applyRatchet(prev, { ...(coverage_pct != null ? { coverage_pct } : {}), ...(mutation_score != null ? { mutation_score } : {}), violations: native.violations.length, duplicated_blocks: native.duplicated_blocks });
+    const ratchet = applyRatchet(prev, { ...(coverage_pct != null ? { coverage_pct } : {}), ...(mutation_score != null ? { mutation_score } : {}), violations: native.violations.length });
     const lintOk = lint.every((l) => l.exit_code === 0);
     const ok = lintOk && ratchet.ok;
     if (ok && opts.persist !== false)
@@ -247,8 +224,6 @@ export function renderCodeQuality(r, prevBody) {
         '|---|---|---|---|',
         '| Lineas por archivo (max) | ' + r.limits.max_file_lines + ' | ' + r.native.max_file_lines + ' | ' + (by('file_lines').length ? by('file_lines').length + ' archivos pasan el limite' : 'ok') + ' |',
         '| Lineas por funcion (max) | ' + r.limits.max_function_lines + ' | ' + r.native.max_function_lines + ' | ' + (by('function_lines').length ? by('function_lines').length + ' funciones pasan el limite' : 'ok') + ' |',
-        '| Complejidad por funcion (max) | ' + r.limits.max_complexity + ' | ' + r.native.max_complexity + ' | ' + (by('complexity').length ? by('complexity').length + ' funciones pasan el limite' : 'ok') + ' |',
-        '| Bloques duplicados (' + r.limits.dup_block_lines + ' lineas) | 0 | ' + r.native.duplicated_blocks + ' | ' + (r.native.duplicated_blocks ? 'hay duplicacion' : 'ok') + ' |',
         '| Cobertura de lineas (%) | piso ' + (r.ratchet.next.coverage_pct ?? '-') + ' | ' + (r.coverage_pct ?? '-') + ' | ' + (r.coverage_pct != null ? 'trinquete' : 'sin medir') + ' |',
         '| Puntaje de mutacion (%) | piso ' + (r.ratchet.next.mutation_score ?? '-') + ' | ' + (r.mutation_score ?? '-') + ' | ' + (r.mutation_score != null ? 'trinquete' : 'sin medir') + ' |',
         '| Lint / formato | 0 fallos | ' + r.lint.filter((l) => l.exit_code !== 0).length + ' fallos | ' + (r.lint.every((l) => l.exit_code === 0) ? 'ok' : 'rojo') + ' |',