@nac3/forge-cli 1.23.7 → 1.24.0

package/dist/core/doc_citations.js

@@ -0,0 +1,271 @@
+/**
+ * LAS CITAS A LA NADA -- la compuerta que el dueno pidio (2026-11-01).
+ *
+ * EL DEFECTO, en sus palabras: "un documento que afirma una compuerta con
+ * confianza es mas convincente que uno que falta. La ausencia se nota; la
+ * afirmacion falsa no." Van tres citas a la nada medidas en dos lotes
+ * -- `docs/PROGRAMMING_NORMS.md` citado por `.github/workflows/ci.yml` cinco
+ * meses sin existir, cuatro jobs y dos crons descritos en
+ * `docs/CI_PIPELINE.md` que nunca existieron, y un comentario de
+ * `.github/workflows/ci.yml` al que remitia `CLAUDE.md` -- y las tres
+ * describian compuertas. Esta compuerta cierra la familia: todo archivo de
+ * este repositorio citado en un documento VIGENTE tiene que existir.
+ *
+ * POR QUE EL DETECTOR ES CONSERVADOR. Una compuerta ruidosa se desactiva, y
+ * un gancho desactivado es peor que ninguno porque figura como existente
+ * (el mismo argumento con el que el dueno acoto F-15). Asi que esto NO
+ * intenta encontrar toda cita: encuentra las que son inequivocamente una
+ * afirmacion sobre ESTE repositorio HOY. Las reglas, en orden:
+ *
+ *   1. Los bloques de codigo cercados no se miran. Un `ls docs/FOO.md` de
+ *      ejemplo no es una afirmacion sobre el repositorio.
+ *   2. Solo cuentan los tramos entre acentos graves y los destinos de los
+ *      enlaces markdown. Una ruta en prosa suelta no se toca.
+ *   3. Con `/`: el primer segmento tiene que ser un directorio que EXISTE en
+ *      la raiz y no ser generado (`dist/`, `test-results/`, `.forge/`...).
+ *      La cita afirma una UBICACION, asi que se verifica tal cual.
+ *      Sin `/`: es un NOMBRE, no una ubicacion, y se verifica como tal --
+ *      basta que un archivo con ese nombre exista en algun lugar del
+ *      repositorio. Medido: tratar `claude.ts` como archivo de la raiz daba
+ *      cientos de falsos positivos, y descartarlo del todo dejaba pasar
+ *      nombres que ya no existen en ninguna parte (`relay_error.ts`).
+ *   4. Nada con comodin (`*`, `?`), hueco (`<x>`, `{x}`, `$x`), dos puntos
+ *      (rutas de Windows, `repo:ruta`) ni esquema (`http://`). Son formas
+ *      que no afirman un archivo concreto.
+ *
+ * Y LOS DOCUMENTOS HISTORICOS NO ENTRAN, por una razon que no es comodidad:
+ * un changelog, un traspaso o un informe fechado describen el estado del
+ * repositorio EN SU FECHA, y un archivo que existia entonces y se renombro
+ * despues es historia correcta, no una cita a la nada. Medido: de 2378 citas
+ * verificables, 762 estaban muertas y la enorme mayoria vivia justamente
+ * ahi. Meterlas obligaria a una lista de permisos de cientos de entradas sin
+ * motivo real, que es la misma afirmacion sin respaldo que esto persigue. La
+ * exclusion se DECLARA (`isHistoricalDoc`) y la corrida dice cuantos
+ * documentos salteo, nunca en silencio.
+ *
+ * ASCII-only.
+ */
+/** Directorios de la raiz que existen pero NO son fuente: lo que hay dentro
+ *  lo genera una corrida o lo escribe un producto en ejecucion, asi que un
+ *  documento puede nombrarlos legitimamente sin que esten en disco. */
+export const GENERATED_ROOTS = [
+    'dist', 'node_modules', 'test-results', 'qa_reports', 'coverage', 'build',
+];
+/** Extensiones que hacen que un token sin `/` cuente como cita de un nombre
+ *  de archivo. Corta a proposito: un token cualquiera no es una cita. */
+const NAME_EXT = [
+    '.md', '.json', '.yml', '.yaml', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.toml', '.sql', '.sh', '.py', '.php',
+];
+/** Sufijos de puntuacion que la prosa deja pegados a una ruta. */
+function trimPunctuation(s) {
+    return s.replace(/^[('"`]+/, '').replace(/[)'"`,.;:!?]+$/, '');
+}
+/** La forma de la cita, o el motivo por el que no es una cita verificable. */
+export function classifyToken(token, rootDirs) {
+    const t = token.trim();
+    if (!t)
+        return { reject: 'vacio' };
+    if (/\s/.test(t))
+        return { reject: 'tiene espacios' };
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(t))
+        return { reject: 'es una URL' };
+    if (t.startsWith('#') || t.startsWith('mailto:'))
+        return { reject: 'es un ancla o un correo' };
+    if (/[*?<>{}$|]/.test(t))
+        return { reject: 'tiene comodin o hueco' };
+    if (t.includes(':'))
+        return { reject: 'tiene dos puntos (ruta ajena o de Windows)' };
+    if (t.includes('\\'))
+        return { reject: 'usa separador de Windows' };
+    if (t.includes('..'))
+        return { reject: 'sube de directorio' };
+    if (t.startsWith('/'))
+        return { reject: 'es absoluta' };
+    if (t.startsWith('~'))
+        return { reject: 'es del home del usuario' };
+    const clean = t.replace(/^\.\//, '').replace(/\/+$/, '');
+    if (!clean)
+        return { reject: 'vacio' };
+    const dot = clean.lastIndexOf('.');
+    const ext = dot > 0 ? clean.slice(dot).toLowerCase() : '';
+    if (clean.includes('/')) {
+        const segs = clean.split('/');
+        const first = segs[0];
+        if (!rootDirs.includes(first))
+            return { reject: 'su primer segmento no es un directorio de este repositorio' };
+        if (first.startsWith('.') && first !== '.github')
+            return { reject: 'vive en un directorio de estado local' };
+        /* Generado en CUALQUIER tramo, no solo en el primero: la salida de un
+         * build de CI (`apps/x/android/app/build/outputs/...`) la produce la
+         * corrida, asi que nombrarla no afirma un archivo en disco. */
+        if (segs.some((s) => GENERATED_ROOTS.includes(s)))
+            return { reject: 'vive en un directorio generado' };
+        return 'path';
+    }
+    if (!ext)
+        return { reject: 'no parece un archivo' };
+    if (!NAME_EXT.includes(ext))
+        return { reject: 'extension no reconocida' };
+    return 'name';
+}
+/** Las citas verificables de un documento markdown. */
+export function extractCitations(md, rootDirs) {
+    const out = [];
+    const lines = md.split(/\r?\n/);
+    let fence = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const fenceMatch = /^\s*(```+|~~~+)/.exec(line);
+        if (fenceMatch) {
+            const mark = fenceMatch[1];
+            if (fence === null)
+                fence = mark[0];
+            else if (mark[0] === fence)
+                fence = null;
+            continue;
+        }
+        if (fence !== null)
+            continue;
+        /* Lineas sangradas cuatro espacios: bloque de codigo indentado. */
+        if (/^ {4,}\S/.test(line) && !/^ {0,3}[-*+]/.test(line))
+            continue;
+        const tokens = [];
+        for (const m of line.matchAll(/`([^`\n]+)`/g))
+            tokens.push(m[1]);
+        for (const m of line.matchAll(/\]\(([^)\s]+)\)/g))
+            tokens.push(m[1]);
+        for (const raw of tokens) {
+            /* El ancla (`docs/X.md#seccion`) no es parte del archivo. */
+            const target0 = trimPunctuation(raw).split('#')[0];
+            const target = target0.replace(/^\.\//, '').replace(/\/+$/, '');
+            const shape = classifyToken(target, rootDirs);
+            if (typeof shape !== 'string')
+                continue;
+            if (out.some((c) => c.line === i + 1 && c.target === target))
+                continue;
+            out.push({ line: i + 1, target, raw, shape });
+        }
+    }
+    return out;
+}
+/** Un documento que describe el estado del repositorio en su fecha, no hoy.
+ *  La lista es de FORMAS de nombre, no de rutas: una lista de rutas se
+ *  desactualiza con cada documento nuevo y acaba siendo una lista de
+ *  permisos. */
+export function isHistoricalDoc(rel) {
+    const p = rel.replace(/\\/g, '/');
+    const base = p.split('/').pop();
+    if (base === 'CHANGELOG.md')
+        return true;
+    /* Carpetas de contexto volcado de una sesion. */
+    if (/(^|\/)context-from-/.test(p))
+        return true;
+    if (/(^|\/)handoff\//i.test(p))
+        return true;
+    /* Nombre con fecha: un documento fechado afirma sobre su fecha. Los dos
+     * separadores se mezclan de verdad en este repositorio
+     * (`CATCHUP_PRELIMINAR_2026-06-11.md`), asi que la forma los acepta
+     * mezclados en vez de pedir uno solo. */
+    if (/[_-]\d{4}[_-]\d{2}[_-]\d{2}/.test(base))
+        return true;
+    /* Generos que son registro, no especificacion vigente. */
+    if (/^(HANDOFF|SESSION|SESION|AUTOPILOT|CODE_REVIEW|INFORME|PROMPT|RETRO|SNAPSHOT|PENDING_REGISTRY_SNAPSHOT)[_-]/i.test(base))
+        return true;
+    return false;
+}
+/** Las citas de un archivo de MAQUINARIA (workflow, lefthook, manifiesto):
+ *  ahi una ruta no viene entre acentos graves, viene en un comentario o en
+ *  un valor. Se buscan por forma y se pasan por el mismo clasificador.
+ *
+ *  Esto NO se usa sobre fuentes TypeScript a proposito: un especificador de
+ *  import (`./tools/x.js`) tiene forma de ruta, es relativo al archivo y
+ *  apunta al transpilado, asi que daria cientos de falsos positivos.
+ *  Medido antes de acotar: 307.
+ *
+ *  Y aca la cita tiene que llevar EXTENSION. En un archivo de maquinaria no
+ *  hay acentos graves que delimiten el token, asi que un tramo sin extension
+ *  suele ser otra cosa con forma de ruta -- medido: `src/version\.ts` dentro
+ *  de una expresion regular de `lefthook.yml` se lee como `src/version`. Las
+ *  tres citas a la nada que este repositorio ya pago llevaban extension. */
+export function extractMachineryCitations(text, rootDirs) {
+    const out = [];
+    const lines = text.split(/\r?\n/);
+    const re = /[A-Za-z0-9_.][A-Za-z0-9_./-]*\/[A-Za-z0-9_][A-Za-z0-9_./-]*/g;
+    for (let i = 0; i < lines.length; i++) {
+        for (const m of lines[i].matchAll(re)) {
+            const target = trimPunctuation(m[0]).replace(/^\.\//, '').replace(/\/+$/, '');
+            if (!/\.[a-z0-9]{1,6}$/i.test(target))
+                continue;
+            const shape = classifyToken(target, rootDirs);
+            if (shape !== 'path')
+                continue;
+            if (out.some((c) => c.line === i + 1 && c.target === target))
+                continue;
+            out.push({ line: i + 1, target, raw: m[0], shape });
+        }
+    }
+    return out;
+}
+/** EL ALCANCE QUE BLOQUEA, y por que es este y no "todos los documentos".
+ *
+ *  Medido en este repositorio: de 1331 citas verificables en documentos
+ *  vigentes, 206 apuntan a archivos que no existen -- y casi todas son
+ *  correctas. El espacio `docs/` esta SOBRECARGADO: `docs/SQ.md` exige
+ *  `docs/USER_MANUAL.md` al proyecto ADOPTANTE, `src/urazuke/catalog.ts`
+ *  nombra `docs/GATES.md` como artefacto que produce el proyecto que corre
+ *  el metodo, y `docs/worker/README.md` cita `src/relay.js` relativo a su
+ *  propio componente. Prescribir rutas para otros proyectos es el negocio
+ *  de este repositorio, asi que "toda ruta citada existe" es FALSO como
+ *  regla general y una compuerta que lo exija pide una lista de permisos de
+ *  cientos de entradas -- que es la misma afirmacion sin respaldo que esto
+ *  persigue.
+ *
+ *  Lo que si se puede exigir sin excepciones es este conjunto: los archivos
+ *  que se leen como AUTORIDAD sobre la maquinaria de este repositorio. Es
+ *  donde vivieron los tres defectos medidos y es chico y verificable. El
+ *  resto se MIDE y se informa en la misma salida, nunca en silencio.
+ *
+ *  Y dentro de ese conjunto bloquean solo las citas con forma de RUTA. Un
+ *  nombre suelto (`nac-bridge.js`, `pilot.bundle.js` en el README) no afirma
+ *  una ubicacion de este repositorio: nombra un artefacto de otro paquete.
+ *  Una ruta si afirma: dice "esta aca". Esa es la afirmacion que las tres
+ *  citas a la nada hicieron y la que esto verifica. */
+export const AUTHORITY_SCOPE = [
+    'CLAUDE.md',
+    'README.md',
+    'PROJECT.md',
+    'docs/PROGRAMMING_NORMS.md',
+    'docs/CI_PIPELINE.md',
+    'lefthook.yml',
+    'package.json',
+    /* mas .github/workflows/*.yml, que el script expande del disco. */
+];
+export function renderCitationReport(r) {
+    const out = [];
+    out.push('doc-citations [compuerta]: ' + r.authority_files + ' archivos de autoridad, '
+        + r.authority_checked + ' citas verificadas'
+        + (r.allowed ? ', ' + r.allowed + ' permitidas por declaracion' : '')
+        + ', ' + r.violations.length + ' a la nada.');
+    out.push('doc-citations [relevamiento, NO bloquea]: ' + r.survey_docs
+        + ' documentos vigentes (' + r.survey_skipped_historical + ' historicos salteados), '
+        + r.survey_checked + ' citas, ' + r.survey_dead + ' sin archivo en disco.');
+    out.push('  El relevamiento no bloquea porque este repositorio PRESCRIBE rutas para otros');
+    out.push('  proyectos (docs/SQ.md exige docs/USER_MANUAL.md al adoptante), asi que una ruta');
+    out.push('  sin archivo no es por si misma un defecto. El numero esta a la vista para que');
+    out.push('  nadie lo descubra midiendo de nuevo.');
+    if (!r.violations.length)
+        return out.join('\n');
+    out.push('');
+    out.push('CITAS A LA NADA EN EL ALCANCE QUE BLOQUEA (' + r.violations.length + '):');
+    for (const v of r.violations) {
+        out.push('  ' + v.doc + ':' + v.line + ' -> ' + v.target
+            + (v.shape === 'name' ? '  (no existe con ese nombre en ninguna parte)' : '  (no existe)'));
+    }
+    out.push('');
+    out.push('Un documento que afirma un archivo que no existe es peor que uno que falta:');
+    out.push('la ausencia se nota, la afirmacion falsa no. Arregla la cita, crea el archivo,');
+    out.push('o declara la excepcion con su motivo en docs/.doc-citations-allow.');
+    return out.join('\n');
+}
+//# sourceMappingURL=doc_citations.js.map

package/dist/core/doc_citations.js.map

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

package/dist/docs/doctrine/urazuke.md

@@ -18,8 +18,9 @@ stations (N0..N7) first and enters the loop at step 5.
   the step names exist, are not stubs, say what they must; the sizing
   record is admissible (G9); the plan items carry a spec; the evidence
   receipts exist. `yujin.pending.close` refuses a red step. An override
-  needs the OWNER's written `force_reason` (kept in history); never pass
-  one on your own initiative.
+  needs the OWNER's written `force_reason` AND its `force_kind` (kept in
+  history, counted per motive -- see "A forced close carries a TYPE");
+  never pass either on your own initiative.
 - Evidence is a RECEIPT Forge records (command, ref, exit code, counts),
   never your summary. "Tests pass" without a receipt is a claim.
 - A LONG run leaves its receipt the same way. `yujin.evidence.run` blocks
@@ -35,6 +36,123 @@ stations (N0..N7) first and enters the loop at step 5.
   receipt, `yujin.task.list` for a task. Two closes were reported as
   "believed" over a receipt that existed on disk the whole time.
 
+## When does a project EXPECT a ladder?
+
+Written here because the condition must be findable, not inferred from the
+source (the owner's condition on F-06, 2026-11-01): "if tomorrow a project
+should have a ladder and does not leave that trace, the notice does not
+come out and we are where we started. The condition has to be WRITTEN
+where someone would look for it."
+
+The switch being ON means **the method is available**, not **you are
+walking it**. It is ON by default in Forge developer, so injecting the
+step block -- or warning that it is missing -- in every project with the
+switch on would charge ~700 characters of system prompt per turn to
+everyone who does not use the method.
+
+So Forge warns ("enabled and NOT arriving") only when the project leaves a
+TRACE that it expects a ladder. Exactly three traces count, any one of
+them is enough (`expectsLadder` in `src/chat/urazuke_section.ts`):
+
+1. **A Urazuke workflow instance exists** for the project, open or closed
+   (`findUrazukeInstance`). This is the normal trace: `yf urazuke start` /
+   `yujin.urazuke.start` leaves it.
+2. **The frozen copy of the gate definition** is on disk
+   (`.forge/urazuke/gates.json`, PND-165): the project pinned a version of
+   the method, so it is using it.
+3. **The method's artifacts are in the repository**: all three of
+   `docs/WORKING_AGREEMENT.md`, `docs/SEMANTIC_TREE.md` and `docs/GATES.md`
+   exist and are not stubs (`hasMethodArtifacts` in
+   `src/urazuke/probes.ts`).
+
+With none of the three, the turn records `reason: 'not_in_use'` and stays
+silent. That reason is itself the trace: it is in the result of
+`buildUrazukeSection`, so "the notice did not come out" can always be
+answered with WHICH condition failed. If you want the ladder in a project
+that has none of the three, open it -- `yujin.urazuke.start` -- and the
+step prompt arrives on the next turn.
+
+## A forced close carries a TYPE, and the type is counted
+
+M-02, decided by the owner on 2026-11-01. A plan item ships only with its
+receipts, and some items have no red to produce at all (documentation,
+configuration). The answer is NOT a kind of pending that authorises
+itself -- nothing can guarantee a code item will not be declared
+"documentation" -- it is an honest forced close that is COUNTABLE:
+
+- `force_reason` (the owner's prose, min 15 chars) is still mandatory, and
+- `force_kind` is mandatory with it, from a CLOSED catalogue
+  (`src/urazuke/overrides.ts`; `yf pending close --force-kind`, or
+  `force_kind` on `yujin.pending.close`). A free-text type turns the
+  counter into a cloud of synonyms, which is not counting.
+
+The condition that makes this worth having, in the owner's words: "the
+typed motive has to be a NUMBER in the report. You have to be able to ask
+how many closes were forced by `documentacion_sin_rojo_posible` and get an
+answer. If the type exists and nobody counts it, it is the same hole with
+a better name -- and worse, because it sounds solved."
+
+So the override is stored as DATA on the item's history entry
+(`history[].override = {gate, kind, missing}`), and
+`docs/RETROSPECTIVE_<date>.md` prints one row per motive and one per gate
+bypassed. Overrides recorded before this change are still counted, in
+their own `sin tipo` row: discounting them would have made the total DROP
+on the day of the fix, which is the worst way to measure a debt.
+
+## The catalogue's file names are PROTOCOL
+
+Decided by the owner on 2026-11-01 (M-03, measured by the Urazuke
+experiment), as a rule of the contract and not as an error message:
+
+**The file names the step catalogue asks for are protocol and are NOT
+translated. The CONTENT goes in the project's language.**
+
+So a step that names `docs/ARCHITECTURE.md` is satisfied by a file at
+exactly that path, whose prose may be entirely in Spanish. A
+`docs/ARQUITECTURA.md` with the identical, correct content counts as
+ABSENT -- and the gate now says so, with that reason, every time an
+artifact is missing (`ARTIFACT_NAMES_ARE_PROTOCOL` in
+`src/urazuke/gate.ts`), whether or not a similar-looking neighbour is
+found next to it.
+
+Why not a per-language alias table, which was the other option: **an alias
+table is a second source of truth, and a second source of truth
+desynchronises** -- the defect this project already has on record three
+times. (Plus the price on the Forge side: 232 artifact names to maintain in
+two languages.) It is the same line the `language-sovereignty` doctrine
+draws for verb ids and code identifiers: translate the EXPERIENCE, never
+the protocol.
+
+What was unacceptable before this was never the requirement. It was the
+SILENCE: a file with the right content next to it, counted as absent, with
+no written reason.
+
+## The five statuses, and why `closed` is NOT `green`
+
+A step carries ONE of five statuses, and two of them are easy to confuse --
+the confusion cost a report that said 0 of 24 when three steps were closed
+(F-07, measured by the Urazuke experiment, 2026-11-01):
+
+| status       | meaning                                                      |
+|--------------|--------------------------------------------------------------|
+| `closed`     | the canonical task of this step IS CLOSED. Consolidated progress. The BEST state a step can be in. |
+| `green`      | the gate passes and the task is STILL OPEN: it CAN be closed, nobody closed it yet. |
+| `red`        | a check is missing. It does not close.                       |
+| `owner`      | nothing mechanical to check; the owner signs it.             |
+| `unmeasured` | the definition in force needs an evaluator this installation cannot measure. It does NOT close and it is NOT green. |
+
+The two rules that follow:
+
+1. **`closed` and `green` are disjoint.** A closed step is reported as
+   `closed`, never as `green`. So **counting `green` to measure progress
+   LOSES every closed step** -- the best ones. Progress is `closed + green`
+   (`done_or_ready`), and a summary prints BOTH numbers, never one.
+2. **Nobody counts statuses on their own.** `summarizeLadder()` in
+   `src/urazuke/current.ts` is the only counter; the verb, the CLI, the
+   retrospective and the cyclic report all read it. A second, independent
+   count is exactly the inference the method warns against: it is how the
+   distinction gets lost again, in one consumer, silently.
+
 ## How to work inside it
 
 1. Read the URAZUKE section: red checks are what is missing. Produce the
@@ -48,3 +166,56 @@ stations (N0..N7) first and enters the loop at step 5.
    when / then" + `how_verified`) before it is implemented (step 5).
 5. No deadlines, ever: the method fixes the order and the gates, not the
    calendar. Speed is a consequence, not the objective.
+
+## The profiles axis: three evaluators, and where their data lives
+
+Added 2026-11-01 (Pieza 6, D-044). The published definition requires these
+three on the three anchors of the construction loop, and until that day this
+installation could not measure any of them -- so adopting the published
+definition froze three permanently unmeasurable steps.
+
+| evaluator | step | what it measures |
+|---|---|---|
+| `pendings_profiles` | 5 | every open plan item that touches a screen declares its convergence group, the profiles that have it, and ONE acceptance criterion per profile |
+| `profile_matrix` | 8 | the matrix is consistent, the navigation is DERIVED from it, and each profile's e2e reaches exactly its row |
+| `manual_cases_per_profile` | 10 | every manual case ran once per affected profile, derived from the matrix |
+
+The data, and the one rule that explains every choice -- **the matrix is the
+producer**:
+
+- `docs/PROFILE_MATRIX.md` carries the four columns of Annex H B2 and
+  nothing else: functionality, home, profiles, entry point. The table is
+  found by HEADER, so the column order is free.
+- `.forge/profile-navigation.json` is the generated navigation, and it
+  declares a fingerprint. The evaluator **recomputes** that fingerprint from
+  the matrix and compares; it never reads the declared one and compares it
+  with itself, which would pass any file. The fingerprint is
+  self-describing (algorithm, encoding, canonical form, covers, excludes) --
+  one that cannot be reproduced from outside is not evidence.
+- `.forge/profile-reachability.json` lists, per profile, what the e2e
+  **reached** (not what it attempted) and the id of its receipt. The
+  evaluator contrasts that id against the receipt registry: an artifact
+  whose receipt the registry does not have is prose.
+- the two directions of "neither less nor more" fail DIFFERENTLY and never
+  merge into one red: reaching **less** than the row is a MISSING piece
+  (construction incomplete); reaching **more** is an AUTHORIZATION defect,
+  high severity by written definition. If the message does not name the
+  class, the reader under-rates it.
+- the per-profile pending fields live in `PendingSpec` **in the registry**,
+  not in `docs/PENDING.md` (owner's decision, 2026-11-01): a gate cannot
+  measure prose, `pendings_spec` already measures there, and two sources for
+  the same datum age in opposite directions. The document is generated from
+  the registry or cites it. Write them with
+  `yf pending add --touches-screen --convergence-group ... --row-profile ...
+  --accept-for perfil=criterio`.
+- `touches_screen` is a THREE-state field: absent means "not declared" and
+  the evaluator reports it as such -- never as "does not touch". Not looking
+  is not the same as nothing being there.
+- the manual case ledger carries `functionality` (the link the method's
+  "derived from the matrix" implies): `yf urazuke rules sign <rule> passed
+  --by <name> --profile <id> --functionality "<row>"`. A case with a single
+  profile does NOT count as executed when its row has more.
+
+To measure what adopting the published definition would cost BEFORE
+adopting it: `yf urazuke rules show --published` (read only, writes
+nothing, never blocks) and `yf urazuke gates pull`.

package/dist/nac3/internal_manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal_manifest.d.ts","sourceRoot":"","sources":["../../src/nac3/internal_manifest.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,YAAY,GACZ,SAAS,GACT,SAAS,GACT,cAAc,GACd,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QAKnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB;;;4BAGwB;IACxB,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;;;;qCAMiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAm7GD,wBAAgB,QAAQ,IAAI,YAAY,CAOvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGzD;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO9D;AAED;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA2CzF;AAED;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAO/D"}
+{"version":3,"file":"internal_manifest.d.ts","sourceRoot":"","sources":["../../src/nac3/internal_manifest.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,SAAS,GACT,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,YAAY,GACZ,SAAS,GACT,SAAS,GACT,cAAc,GACd,KAAK,CAAC;AAEV,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QAKnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB;;;4BAGwB;IACxB,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC;;;;;;qCAMiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAw8GD,wBAAgB,QAAQ,IAAI,YAAY,CAOvC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGzD;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO9D;AAED;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA2CzF;AAED;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAO/D"}

package/dist/nac3/internal_manifest.js

@@ -14,6 +14,11 @@
  * ASCII-only.
  */
 import { VERSION as FORGE_VERSION } from '../version.js';
+/* M-02: el catalogo de motivos de un cierre forzado se declara UNA vez
+ * (src/urazuke/overrides.ts) y el schema del verbo lo refleja. Repetir la
+ * lista aca es la segunda fuente de verdad que se desincroniza el dia que
+ * se agregue un motivo. */
+import { OVERRIDE_KIND_NAMES } from '../urazuke/overrides.js';
 /* ============================================================
  * Verb declarations
  *
@@ -49,7 +54,7 @@ const VERBS = [
             type: 'object',
             properties: {
                 title: { type: 'string', description: 'Tab header label. Max 80 chars.', minLength: 1, maxLength: 80 },
-                kind: { type: 'string', description: 'Render mode. doc = DOCUMENTO (reporte/analisis/spec/ARQUITECTURA/DISEÑO): content = HTML por DEFAULT (h1/h2/h3, p, ul/ol, table, blockquote, pre, strong/em; NADA de <script>/<style>/JS -- se sanitiza), se renderiza dentro de una hoja con el look Yujin. Usa HTML siempre para documentos de arquitectura, diseño y specs (formato rico). Tambien acepta markdown como fallback. Usalo por DEFAULT para cualquier documento que generes. bpmn (o flow) = DIAGRAMA DE PROCESO BPMN 2.0 -- USALO cuando el usuario pide un FLUJO / flow / proceso / circuito de negocio (NO el grafo de nodos). content = JSON {lanes?:[{id,label}], nodes:[{id, type, label, lane?, gateway?}], flows:[{from, to, label?}]}; type en startEvent|endEvent|intermediate|task|userTask|serviceTask|scriptTask|sendTask|receiveTask|gateway; gateway en exclusive|parallel|inclusive. graph = grafo de nodos dinamico (relaciones/dependencias, NO procesos): content = JSON {nodes:[{id,label,weight,kind,detail}], edges:[{from,to,kind,label}]}; md/markdown = texto; code/table/tree. html = mini-navegador en iframe sandbox. app = mini-app con JS arbitrario (viz/herramienta) en iframe sandbox aislado; usa app solo si necesitas JS real, sino doc.', enum: ['code', 'table', 'markdown', 'md', 'html', 'app', 'bpmn', 'flow', 'document', 'doc', 'tree', 'graph'] },
+                kind: { type: 'string', description: 'Render mode. doc = DOCUMENTO (reporte/analisis/spec/ARQUITECTURA/DISENO): content = HTML por DEFAULT (h1/h2/h3, p, ul/ol, table, blockquote, pre, strong/em; NADA de <script>/<style>/JS -- se sanitiza), se renderiza dentro de una hoja con el look Yujin. Usa HTML siempre para documentos de arquitectura, diseno y specs (formato rico). Tambien acepta markdown como fallback. Usalo por DEFAULT para cualquier documento que generes. bpmn (o flow) = DIAGRAMA DE PROCESO BPMN 2.0 -- USALO cuando el usuario pide un FLUJO / flow / proceso / circuito de negocio (NO el grafo de nodos). content = JSON {lanes?:[{id,label}], nodes:[{id, type, label, lane?, gateway?}], flows:[{from, to, label?}]}; type en startEvent|endEvent|intermediate|task|userTask|serviceTask|scriptTask|sendTask|receiveTask|gateway; gateway en exclusive|parallel|inclusive. graph = grafo de nodos dinamico (relaciones/dependencias, NO procesos): content = JSON {nodes:[{id,label,weight,kind,detail}], edges:[{from,to,kind,label}]}; md/markdown = texto; code/table/tree. html = mini-navegador en iframe sandbox. app = mini-app con JS arbitrario (viz/herramienta) en iframe sandbox aislado; usa app solo si necesitas JS real, sino doc.', enum: ['code', 'table', 'markdown', 'md', 'html', 'app', 'bpmn', 'flow', 'document', 'doc', 'tree', 'graph'] },
                 content: { type: 'string', description: 'Body text. Max 100000 chars. Para kind=graph: JSON {nodes,edges}. Para kind=bpmn/flow: JSON {lanes?,nodes,flows} (ver kind).', minLength: 1, maxLength: 100000 },
                 language: { type: 'string', description: 'For kind=code: language hint.', maxLength: 40 },
             },
@@ -2962,6 +2967,19 @@ const VERBS = [
                 blocker_who: { type: 'string', maxLength: 80 },
                 priority: { type: 'number', description: '0..100 (0 = critical, 100 = nice-to-have). Default 50.' },
                 related_doc: { type: 'string', maxLength: 200 },
+                /* M-01 (experimento Urazuke, 2026-11-01) -- EL SPEC, por verbo.
+                 *
+                 * La compuerta del peldano 5 (gate.ts, evaluador `plan`) falla
+                 * cuando hay pendientes del plan SIN spec. El CLI podia escribirlo
+                 * (`yf pending add --acceptance ... --how-verified ...`) y el verbo
+                 * NO, asi que un agente que registraba un hallazgo durante el
+                 * recorrido volvia ROJO un peldano ya cerrado y no tenia manera de
+                 * arreglarlo. El metodo terminaba castigando la honestidad: el
+                 * camino barato era no anotar el hallazgo. Aparecio CUATRO veces en
+                 * la corrida. La forma es la del CLI, no una nueva. */
+                acceptance: { type: 'array', description: 'Urazuke peldano 5: criterios de aceptacion, uno por entrada, en forma "dado / cuando / entonces". Sin esto el item cuenta como SIN spec y pone el peldano 5 en rojo.' },
+                how_verified: { type: 'string', maxLength: 2000, description: 'Urazuke peldano 5: como se verifica SIN leer codigo. Va junto con acceptance: la compuerta exige los dos.' },
+                flows: { type: 'array', description: 'Urazuke: los flujos de usuario que toca el item (los que el e2e del peldano 8 tiene que recorrer).' },
             },
             required: ['title', 'category'],
         },
@@ -3000,7 +3018,8 @@ const VERBS = [
                 reason: { type: 'string', enum: ['shipped', 'obsoleted', 'duplicate', 'rejected'] },
                 commit: { type: 'string', description: 'Git SHA that delivered the close. The affected sources are derived from it.', maxLength: 80 },
                 resolution: { type: 'string', description: 'How it was resolved -- the closing history summary (what was done across the evolutive/corrective cycle). Saved as a history entry AND as the technical summary of the implementation record.', maxLength: 4000 },
-                force_reason: { type: 'string', maxLength: 500, description: 'Urazuke: ONLY when the owner explicitly decides to close a workflow task whose step is RED or out of order. The written reason (min 15 chars) is kept in the item history for the audit. Never use it on your own initiative.' },
+                force_reason: { type: 'string', maxLength: 500, description: 'Urazuke: ONLY when the owner explicitly decides to close a workflow task whose step is RED or out of order. The written reason (min 15 chars) is kept in the item history for the audit. Never use it on your own initiative. Requires force_kind.' },
+                force_kind: { type: 'string', maxLength: 60, description: 'Urazuke (M-02): the TYPE of the forced close, mandatory with force_reason so the retrospective can COUNT forced closes per motive. Closed catalogue.', enum: OVERRIDE_KIND_NAMES },
                 functional: { type: 'string', description: 'FUNCTIONAL description of what was delivered: what the user can do now and how it behaves. Mandatory with reason=shipped -- it is not in the diff.', maxLength: 8000 },
                 use_cases: { type: 'array', description: 'Concrete use cases now covered, one per entry.' },
                 files: { type: 'array', description: 'Extra affected sources. Normally empty: with `commit` they come from the SHA.' },
@@ -3057,6 +3076,13 @@ const VERBS = [
                 blocker_who: { type: 'string', maxLength: 80 },
                 priority: { type: 'number', description: '0..100' },
                 related_doc: { type: 'string', maxLength: 200 },
+                /* M-01 -- el spec tambien por EDIT, no solo por add: un item
+                 * abierto antes de tener spec tiene que poder adquirirlo sin pasar
+                 * por la consola. Pasar uno de los dos campos reemplaza el spec
+                 * entero; no pasar ninguno lo deja intacto. */
+                acceptance: { type: 'array', description: 'Urazuke peldano 5: criterios de aceptacion "dado / cuando / entonces", uno por entrada. Pasarlos REEMPLAZA el spec del item.' },
+                how_verified: { type: 'string', maxLength: 2000, description: 'Urazuke peldano 5: como se verifica sin leer codigo. Va junto con acceptance.' },
+                flows: { type: 'array', description: 'Urazuke: los flujos de usuario que toca el item.' },
             },
             required: ['id'],
         },