@nac3/forge-cli 1.23.1 → 1.23.3

package/dist/urazuke/quality_doc.js

@@ -0,0 +1,137 @@
+/**
+ * docs/CODE_QUALITY.md -- the artifact step 9 names, written from the
+ * definition in force.
+ *
+ * Split out of `quality.ts` (which measures) so the file that renders can
+ * carry the result per rule without either of the two crossing 300 lines --
+ * the limit CQ-03 declares and the one Forge measures on itself.
+ *
+ * TWO READINGS, NEVER MIXED. With a rule catalogue in force, every number
+ * in the threshold table comes from the definition and each row says who
+ * declared it (the method, the project, or nobody -- and an undeclared
+ * threshold is not measured). WITHOUT one, the two limits Forge still
+ * measures are declared as what they are: a value of this tool, not the
+ * method's limit. The one thing the annex forbids outright is a number of
+ * ours standing in the column the method governs.
+ *
+ * ASCII-only.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { renderRuleResults, renderUsability } from './rule_report.js';
+const OWN_LIMITS_NOTE = 'La definicion en vigor de este proyecto no trae el catalogo de reglas del'
+    + ' Anexo H (no publica umbrales por regla), asi que los dos limites de abajo son un valor **propio'
+    + ' de Forge** y no el limite del metodo. En cuanto el proyecto adopte una definicion que los'
+    + ' publique, este documento mide contra los declarados y dice quien declara cada uno.';
+function count(r, k) {
+    return r.native.violations.filter((x) => x.kind === k).length;
+}
+/** What the native meters measured, keyed by the threshold id of the
+ *  definition in force. Labelled as this installation's instrument: the
+ *  method publishes the threshold, not the checker (PND-219). */
+function nativeMeasured(r) {
+    const files = count(r, 'file_lines');
+    const fns = count(r, 'function_lines');
+    return {
+        lines_per_file: r.native.max_file_lines + ' el maximo medido; '
+            + (files ? files + ' archivos pasan el limite' : 'ninguno pasa el limite')
+            + ' (medidor nativo de esta instalacion)',
+        lines_per_function: r.native.max_function_lines + ' el maximo medido; '
+            + (fns ? fns + ' funciones pasan el limite' : 'ninguna pasa el limite')
+            + ' (medidor nativo de esta instalacion)',
+        ...(r.coverage_pct != null
+            ? { minimum_coverage: r.coverage_pct + ' por ciento, con piso del trinquete '
+                    + (r.ratchet.next.coverage_pct ?? '-') }
+            : {}),
+        ...(r.mutation_score != null
+            ? { mutation_target: r.mutation_score + ' por ciento de mutantes muertos' }
+            : {}),
+    };
+}
+function toolsSection(r) {
+    return [
+        '## Herramientas',
+        '',
+        '- Bateria: `' + (r.stack.test_command || '(sin comando de tests)') + '`',
+        '- Lint / formato: ' + (r.stack.lint_commands.length
+            ? r.stack.lint_commands.map((c) => '`' + c + '`').join(', ')
+            : '(ninguno instalado; medidores nativos de Forge)'),
+        '- Cobertura: ' + (r.stack.coverage_command
+            ? '`' + r.stack.coverage_command + '` -> ' + r.stack.coverage_file : '(no disponible)'),
+        '- Mutacion: ' + (r.stack.mutation_command
+            ? r.stack.mutation_tool + ' (`' + r.stack.mutation_command + '`)' : '(no disponible)'),
+        '- Lint / formato hoy: ' + r.lint.filter((l) => l.exit_code !== 0).length + ' fallos sobre '
+            + r.lint.length + ' comandos (' + (r.lint.every((l) => l.exit_code === 0) ? 'ok' : 'ROJO') + ')',
+        '',
+    ];
+}
+/** The fallback table, for a project with no rule catalogue in force. */
+function ownLimits(r) {
+    return [
+        '## Limites y valores medidos',
+        '',
+        OWN_LIMITS_NOTE,
+        '',
+        '| Medida | Limite (propio de Forge) | Medido | Estado |',
+        '|---|---|---|---|',
+        '| Lineas por archivo (max) | ' + r.limits.max_file_lines + ' | ' + r.native.max_file_lines
+            + ' | ' + (count(r, 'file_lines') ? count(r, 'file_lines') + ' archivos pasan el limite' : 'ok') + ' |',
+        '| Lineas por funcion (max) | ' + r.limits.max_function_lines + ' | ' + r.native.max_function_lines
+            + ' | ' + (count(r, 'function_lines') ? count(r, 'function_lines') + ' funciones pasan el limite' : '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') + ' |',
+        '',
+    ];
+}
+function failures(v) {
+    return [
+        '## Lo que hoy falla (' + v.length + ')',
+        '',
+        ...(v.length ? v.slice(0, 80).map((x) => '- ' + x.kind + ': ' + x.where + ' (' + x.value + ' > ' + x.limit + ')') : ['- nada']),
+        ...(v.length > 80 ? ['- ... y ' + (v.length - 80) + ' mas (yf urazuke quality check --json)'] : []),
+        '',
+    ];
+}
+/** docs/CODE_QUALITY.md. Rewritten on every check; the history of the
+ *  numbers lives in the ratchet, and the owner's prose is preserved. */
+export function renderQualityDoc(r, prevBody, rs) {
+    const keep = prevBody ? (/## Decisiones del dueno[\s\S]*$/.exec(prevBody)?.[0] ?? '') : '';
+    const lines = [
+        '# Calidad del codigo verificada por maquina',
+        '',
+        'Generado por `yf urazuke quality check` el ' + new Date().toISOString() + '. Stack: ' + r.stack.label + '.',
+        'Los numeros de abajo son medidos; el trinquete (`.forge/quality-ratchet.json`) solo deja mejorar.',
+        '',
+        ...toolsSection(r),
+        ...(rs ? renderRuleResults(rs, nativeMeasured(r)) : ownLimits(r)),
+        ...failures(r.native.violations),
+        '## Trinquete',
+        '',
+        r.ratchet.ok ? '- en verde: los numeros no empeoraron.' : '- EN ROJO: ' + r.ratchet.reasons.join('; '),
+        '',
+        keep || '## Decisiones del dueno\n\n_Que se arregla ahora (un pendiente cada uno) y que se tolera con fecha._\n',
+    ];
+    return lines.join('\n');
+}
+/** Write the two artifacts step 9 names, preserving the owner's prose in
+ *  each. The second one only exists when the definition in force publishes
+ *  usability rules: an empty USABILITY.md would pass a must_contain by
+ *  accident and say nothing. Returns the relative paths written. */
+export async function writeStep9Docs(root, r, rs) {
+    const written = [];
+    const one = async (rel, render) => {
+        const target = path.join(root, rel);
+        const prev = await fs.readFile(target, 'utf8').catch(() => '');
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.writeFile(target, render(prev), 'utf8');
+        written.push(rel);
+    };
+    await one('docs/CODE_QUALITY.md', (prev) => renderQualityDoc(r, prev, rs));
+    if (rs && rs.rules.some((x) => x.group === 'usability')) {
+        await one('docs/USABILITY.md', (prev) => renderUsability(rs, prev));
+    }
+    return written;
+}
+//# sourceMappingURL=quality_doc.js.map

package/dist/urazuke/quality_doc.js.map

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

package/dist/urazuke/rule_report.d.ts

@@ -0,0 +1,29 @@
+import type { Ruleset, ThresholdView } from './heuristics.js';
+/** The rule catalogue of the definition in force, or undefined when the
+ *  definition does not publish one -- the compiled base catalogue is schema 1
+ *  and carries no rules, so a project that never adopted a published file has
+ *  nothing to report per rule, and the document says so instead of inventing
+ *  a catalogue. */
+export declare function rulesetInForce(projectRoot: string): Promise<Ruleset | undefined>;
+/** The two limits Forge's native meter can measure, when the definition in
+ *  force declares them (annex value, or the project's own override). */
+export interface RuleLimits {
+    max_file_lines?: number;
+    max_function_lines?: number;
+}
+/** The measurable limits, taken from the definition in force instead of
+ *  from a constant of Forge. An undeclared threshold yields nothing: the
+ *  caller keeps its own default and the document says it is its own. */
+export declare function limitsFromRuleset(rs?: Ruleset): RuleLimits;
+/** Who declared a threshold, in the reader's words. */
+export declare function declaredBy(t: ThresholdView): string;
+/** The threshold table: id, rule, value, WHO declared it, and -- for the
+ *  two Forge measures natively -- what was measured against it. */
+export declare function thresholdRows(rs: Ruleset, measured: Record<string, string>): string[];
+/** The section the quality document carries so step 9 gets the result per
+ *  rule and not a single number. */
+export declare function renderRuleResults(rs: Ruleset, measured: Record<string, string>): string[];
+/** docs/USABILITY.md -- the artifact step 9 adds in schema 2: the result
+ *  per usability rule, with its declared exceptions. */
+export declare function renderUsability(rs: Ruleset, prevBody?: string): string;
+//# sourceMappingURL=rule_report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rule_report.d.ts","sourceRoot":"","sources":["../../src/urazuke/rule_report.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,OAAO,EAAgB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;mBAImB;AACnB,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAMtF;AAED;wEACwE;AACxE,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAOD;;wEAEwE;AACxE,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,UAAU,CAQ1D;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CASnD;AAsDD;mEACmE;AACnE,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CASrF;AAgBD;oCACoC;AACpC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAqBzF;AAED;wDACwD;AACxD,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgDtE"}

package/dist/urazuke/rule_report.js

@@ -0,0 +1,239 @@
+/**
+ * THE RESULT PER RULE, WITH ITS ID -- and the provenance of every
+ * threshold (Annex H, step 9's two documents).
+ *
+ * Why this file exists. Step 9 of the published catalogue names two
+ * artifacts with a `must_contain` each: `docs/CODE_QUALITY.md` has to carry
+ * `CQ-\d\d` ("the result per rule, not as a single number") and
+ * `docs/USABILITY.md` has to carry `UX-\d\d` ("the result per usability
+ * rule, with its declared exceptions"). Until 2026-10-28 Forge wrote the
+ * first document with four aggregate numbers and no rule id at all, and
+ * never wrote the second: so the document Forge itself generates failed
+ * Forge's own `artifacts` evaluator, and step 9 came out red in every
+ * project this tool writes -- not for want of the schema-2 evaluators
+ * (PND-215), but through the one evaluator that was already implemented.
+ *
+ * AND THE COLUMN THE METHOD GOVERNS. The same table printed `300` and `40`
+ * under the heading "Limite" with no provenance. Two of the five published
+ * thresholds are declared by the annex, one by the owner and two by neither
+ * (`paths_per_function`, `minimum_coverage`, `mutation_target` -- the last
+ * two by the ratchet and by the owner once there are real users). The annex
+ * is explicit about the ones nobody declared: "it is reported as an
+ * undeclared threshold. Without approximating, without inheriting in
+ * silence and without inventing". So each row says WHO declared the number,
+ * and an undeclared threshold shows no number and is not measured.
+ *
+ * WHAT THIS FILE WILL NOT DO. It will not turn a rule the installation
+ * cannot measure into a green one. `resolveRuleset` resolves every active
+ * rule's checker to `not_published` (the data publishes the instrument and
+ * the severity per rule, but not the cell that says what measures it -- see
+ * PND-219), so the result column says SIN MEDIR and names why. The native
+ * meters Forge does run live in their own section, tied to the rule id
+ * whose threshold they measure and labelled as this installation's
+ * instrument, never as the method's. A number of ours in the method's
+ * column is the one thing the annex forbids outright.
+ *
+ * ASCII-only.
+ */
+import { verdictFor } from './manual_cases.js';
+/** The rule catalogue of the definition in force, or undefined when the
+ *  definition does not publish one -- the compiled base catalogue is schema 1
+ *  and carries no rules, so a project that never adopted a published file has
+ *  nothing to report per rule, and the document says so instead of inventing
+ *  a catalogue. */
+export async function rulesetInForce(projectRoot) {
+    const { gatesInForce } = await import('./gate.js');
+    const { resolveRuleset } = await import('./heuristics.js');
+    const gates = await gatesInForce(projectRoot);
+    const rs = await resolveRuleset({ projectRoot, gates });
+    return rs.rules.length ? rs : undefined;
+}
+const LIMIT_OF = {
+    lines_per_file: 'max_file_lines',
+    lines_per_function: 'max_function_lines',
+};
+/** The measurable limits, taken from the definition in force instead of
+ *  from a constant of Forge. An undeclared threshold yields nothing: the
+ *  caller keeps its own default and the document says it is its own. */
+export function limitsFromRuleset(rs) {
+    const out = {};
+    for (const t of rs?.thresholds ?? []) {
+        const key = LIMIT_OF[t.id];
+        if (!key || !t.declared || typeof t.value !== 'number')
+            continue;
+        out[key] = t.value;
+    }
+    return out;
+}
+/** Who declared a threshold, in the reader's words. */
+export function declaredBy(t) {
+    if (t.declared && t.source === 'project')
+        return 'el proyecto, en .forge/project-settings.json';
+    if (t.declared)
+        return 'el metodo, en el anexo';
+    /* The method's own words, quoted: paraphrasing who declares a threshold
+     * is how a consumer ends up inventing layer 2. The quote marks make the
+     * language change legible instead of looking like a bug. */
+    return t.declared_by
+        ? 'nadie todavia -- el metodo dice que lo declara: "' + t.declared_by + '"'
+        : 'nadie -- la definicion en vigor no dice ni quien lo declararia';
+}
+const SEV = { blocks: 'bloquea', warns: 'avisa', records: 'queda escrito' };
+/** The state of a rule, said in full: a switched-off rule carries who
+ *  authorized it and until when, because that is the whole point of the
+ *  record the method demands. */
+function stateOf(r) {
+    if (r.state === 'group_off')
+        return 'GRUPO APAGADO -- nunca se lee como cumplido';
+    if (r.state === 'switched_off') {
+        const rec = r.record;
+        return 'APAGADA por ' + (rec?.authorized_by ?? '?') + ', revision ' + (rec?.review_date ?? '?')
+            + ': ' + (rec?.reason ?? '?');
+    }
+    if (r.state === 'out_of_scope')
+        return 'FUERA DE ALCANCE -- ' + (r.why ?? 'no aplica a este proyecto');
+    return 'activa';
+}
+/** The result of a rule: measured green, measured red, judged by a person,
+ *  or not measured at all -- never folded into a colour it did not earn. */
+function resultOf(rs, r) {
+    if (r.state !== 'active')
+        return 'no se mide en este estado';
+    if (r.human_red || r.instrument.includes('manual_case')) {
+        const v = verdictFor(rs.manual_cases, r.id);
+        if (!v)
+            return 'LA JUZGA UNA PERSONA -- sin veredicto en el registro';
+        return 'LA JUZGO UNA PERSONA: ' + (v.verdict === 'passed' ? 'paso' : 'FALLO')
+            + ' -- ' + v.judged_by + ', ' + v.at;
+    }
+    if (r.measured)
+        return r.passing ? 'medida en verde' : 'medida en ROJO';
+    return 'SIN MEDIR -- la definicion en vigor no publica con que se mide esta regla';
+}
+function ruleRows(rs, group) {
+    const rows = ['| Regla | Familia | Severidad | Estado | Resultado | Instrumento declarado |',
+        '|---|---|---|---|---|---|'];
+    for (const r of rs.rules.filter((x) => x.group === group)) {
+        rows.push('| ' + r.id + ' | ' + (r.family || '-') + ' | ' + (SEV[r.severity] ?? r.severity)
+            + ' | ' + stateOf(r) + ' | ' + resultOf(rs, r)
+            + ' | ' + (r.instrument.length ? r.instrument.join(', ') : 'sin instrumento publicado') + ' |');
+    }
+    if (rows.length === 2)
+        rows.push('| (ninguna) | - | - | - | la definicion en vigor no trae reglas de este grupo | - |');
+    return rows;
+}
+/** One line per rule with the sentence the annex extracted, so a reader
+ *  does not need the annex open to know what the id means. */
+function statementList(rs, group) {
+    const out = [];
+    for (const r of rs.rules.filter((x) => x.group === group)) {
+        out.push('- **' + r.id + '**: ' + (r.statement ?? '(la definicion en vigor no trae el enunciado)'));
+    }
+    return out.length ? out : ['- (ninguna)'];
+}
+/** The threshold table: id, rule, value, WHO declared it, and -- for the
+ *  two Forge measures natively -- what was measured against it. */
+export function thresholdRows(rs, measured) {
+    const rows = ['| Umbral | Regla | Limite | Quien lo declara | Medido |', '|---|---|---|---|---|'];
+    for (const t of rs.thresholds) {
+        const limit = t.declared ? String(t.value) : 'SIN DECLARAR';
+        const m = measuredCell(t, measured[t.id]);
+        rows.push('| ' + t.id + ' | ' + (t.rule || '-') + ' | ' + limit + ' | ' + declaredBy(t) + ' | ' + m + ' |');
+    }
+    if (rows.length === 2)
+        rows.push('| (ninguno) | - | - | la definicion en vigor no publica umbrales | - |');
+    return rows;
+}
+/** The measured cell. A declared threshold is compared; an undeclared one
+ *  is NOT measured against anything invented -- when a meter still produced a
+ *  number (the coverage the ratchet floors), it is shown as a number with no
+ *  limit to compare it to, which is a different claim from a verdict. */
+function measuredCell(t, m) {
+    if (t.declared)
+        return m ?? 'esta instalacion no lo mide';
+    if (m)
+        return 'no se mide contra un limite (ninguno declarado); medido igual: ' + m;
+    return 'no se mide -- el metodo dice: "' + undeclaredNote(t) + '"';
+}
+function undeclaredNote(t) {
+    return t.note ?? 'el metodo exige que el limite se declare y no fija el numero';
+}
+/** The section the quality document carries so step 9 gets the result per
+ *  rule and not a single number. */
+export function renderRuleResults(rs, measured) {
+    return [
+        '## Resultado por regla (' + rs.rules.filter((r) => r.group === 'code_quality').length + ' reglas de codigo)',
+        '',
+        'Catalogo ' + rs.catalog_version + '. Las reglas, sus familias, sus severidades y sus umbrales'
+            + ' salen de la definicion en vigor: ningun numero de abajo es una constante de esta herramienta.',
+        '',
+        ...ruleRows(rs, 'code_quality'),
+        '',
+        '## Umbrales, y quien declara cada uno',
+        '',
+        ...thresholdRows(rs, measured),
+        '',
+        ...(rs.could_not_verify.length
+            ? ['## Lo que esta instalacion NO pudo verificar', '', ...rs.could_not_verify.map((c) => '- ' + c), '']
+            : []),
+        '## Que dice cada regla',
+        '',
+        ...statementList(rs, 'code_quality'),
+        '',
+    ];
+}
+/** docs/USABILITY.md -- the artifact step 9 adds in schema 2: the result
+ *  per usability rule, with its declared exceptions. */
+export function renderUsability(rs, prevBody) {
+    const keep = prevBody ? (/## Decisiones del dueno[\s\S]*$/.exec(prevBody)?.[0] ?? '') : '';
+    const ux = rs.rules.filter((r) => r.group === 'usability');
+    const off = ux.filter((r) => r.state === 'switched_off');
+    const L = [
+        '# Usabilidad verificada, regla por regla',
+        '',
+        'Generado por `yf urazuke quality check` el ' + new Date().toISOString() + '.',
+        'Catalogo ' + rs.catalog_version + ' | adaptador ' + (rs.adapter ?? '(sin declarar)')
+            + ' | usuarios reales: ' + (rs.real_users ? 'si' : 'no declarados'),
+        '',
+        'Veintisiete de las cuarenta y cinco reglas del anexo son de usabilidad, y la mayoria las juzga'
+            + ' una persona: el instrumento que el metodo les pone es un caso manual, no un medidor. Un caso'
+            + ' manual sin nombre y sin fecha no es un veredicto, y aca se ve como lo que es: ausente.',
+        '',
+        '## Resultado por regla (' + ux.length + ')',
+        '',
+        ...ruleRows(rs, 'usability'),
+        '',
+        '## Las excepciones declaradas',
+        '',
+    ];
+    if (!off.length && !rs.group_off.includes('usability'))
+        L.push('- ninguna regla de usabilidad esta apagada.');
+    for (const r of off) {
+        const rec = r.record;
+        L.push('- ' + r.id + ': apagada por ' + (rec?.authorized_by ?? '?') + ', revision '
+            + (rec?.review_date ?? '?') + '. ' + (rec?.reason ?? '?'));
+    }
+    if (rs.group_off.includes('usability')) {
+        L.push('- el grupo usability esta apagado entero: NUNCA se lee como cumplido.');
+    }
+    L.push('', '## Los veredictos de las personas', '');
+    const human = ux.filter((r) => r.human_red || r.instrument.includes('manual_case'));
+    if (!human.length)
+        L.push('- ninguna regla de usabilidad pide el juicio de una persona en esta definicion.');
+    for (const r of human) {
+        const v = verdictFor(rs.manual_cases, r.id);
+        L.push('- ' + r.id + ': ' + (v
+            ? (v.verdict === 'passed' ? 'paso' : 'FALLO') + ' -- ' + v.judged_by + ', ' + v.at
+                + (v.profile ? ' (perfil ' + v.profile + ')' : '') + (v.note ? '. ' + v.note : '')
+            : 'sin veredicto. Nadie la juzgo todavia.'));
+    }
+    if (rs.validity.invalidating.length) {
+        L.push('', '## La declaracion es INVALIDA', '');
+        for (const p of rs.validity.invalidating)
+            L.push('- ' + p);
+    }
+    L.push('', '## Que dice cada regla', '', ...statementList(rs, 'usability'), '');
+    L.push(keep || '## Decisiones del dueno\n\n_Que se arregla ahora (un pendiente cada uno) y que se tolera con fecha._\n');
+    return L.join('\n');
+}
+//# sourceMappingURL=rule_report.js.map

package/dist/urazuke/rule_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule_report.js","sourceRoot":"","sources":["../../src/urazuke/rule_report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;;;mBAImB;AACnB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AASD,MAAM,QAAQ,GAAqC;IACjD,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;CACzC,CAAC;AAEF;;wEAEwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,SAAS;QACjE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,CAAgB;IACzC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,8CAA8C,CAAC;IAChG,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,wBAAwB,CAAC;IAChD;;gEAE4D;IAC5D,OAAO,CAAC,CAAC,WAAW;QAClB,CAAC,CAAC,mDAAmD,GAAG,CAAC,CAAC,WAAW,GAAG,GAAG;QAC3E,CAAC,CAAC,gEAAgE,CAAC;AACvE,CAAC;AAED,MAAM,GAAG,GAA2B,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAEpG;;iCAEiC;AACjC,SAAS,OAAO,CAAC,CAAe;IAC9B,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,6CAA6C,CAAC;IAClF,IAAI,CAAC,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,OAAO,cAAc,GAAG,CAAC,GAAG,EAAE,aAAa,IAAI,GAAG,CAAC,GAAG,aAAa,GAAG,CAAC,GAAG,EAAE,WAAW,IAAI,GAAG,CAAC;cAC3F,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,KAAK,cAAc;QAAE,OAAO,sBAAsB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAC;IACvG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;4EAC4E;AAC5E,SAAS,QAAQ,CAAC,EAAW,EAAE,CAAe;IAC5C,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,2BAA2B,CAAC;IAC7D,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC;YAAE,OAAO,sDAAsD,CAAC;QACtE,OAAO,wBAAwB,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;cACzE,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACxE,OAAO,2EAA2E,CAAC;AACrF,CAAC;AAED,SAAS,QAAQ,CAAC,EAAW,EAAE,KAAa;IAC1C,MAAM,IAAI,GAAG,CAAC,8EAA8E;QAC1F,2BAA2B,CAAC,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;cACvF,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;cAC5C,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,GAAG,IAAI,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IACxH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;8DAC8D;AAC9D,SAAS,aAAa,CAAC,EAAW,EAAE,KAAa;IAC/C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,+CAA+C,CAAC,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED;mEACmE;AACnE,MAAM,UAAU,aAAa,CAAC,EAAW,EAAE,QAAgC;IACzE,MAAM,IAAI,GAAG,CAAC,yDAAyD,EAAE,uBAAuB,CAAC,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;QAC5D,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IAC3G,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;yEAGyE;AACzE,SAAS,YAAY,CAAC,CAAgB,EAAE,CAAqB;IAC3D,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,6BAA6B,CAAC;IAC1D,IAAI,CAAC;QAAE,OAAO,iEAAiE,GAAG,CAAC,CAAC;IACpF,OAAO,iCAAiC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AACrE,CAAC;AAED,SAAS,cAAc,CAAC,CAAgB;IACtC,OAAO,CAAC,CAAC,IAAI,IAAI,8DAA8D,CAAC;AAClF,CAAC;AAED;oCACoC;AACpC,MAAM,UAAU,iBAAiB,CAAC,EAAW,EAAE,QAAgC;IAC7E,OAAO;QACL,0BAA0B,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,MAAM,GAAG,oBAAoB;QAC7G,EAAE;QACF,WAAW,GAAG,EAAE,CAAC,eAAe,GAAG,4DAA4D;cAC7F,gGAAgG;QAClG,EAAE;QACF,GAAG,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;QAC/B,EAAE;QACF,uCAAuC;QACvC,EAAE;QACF,GAAG,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC;QAC9B,EAAE;QACF,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM;YAC5B,CAAC,CAAC,CAAC,8CAA8C,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;YACvG,CAAC,CAAC,EAAE,CAAC;QACP,wBAAwB;QACxB,EAAE;QACF,GAAG,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC;QACpC,EAAE;KACH,CAAC;AACJ,CAAC;AAED;wDACwD;AACxD,MAAM,UAAU,eAAe,CAAC,EAAW,EAAE,QAAiB;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG;QACR,0CAA0C;QAC1C,EAAE;QACF,6CAA6C,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,GAAG;QAC9E,WAAW,GAAG,EAAE,CAAC,eAAe,GAAG,eAAe,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,gBAAgB,CAAC;cACnF,sBAAsB,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;QACnE,EAAE;QACF,gGAAgG;cAC9F,+FAA+F;cAC/F,yFAAyF;QAC3F,EAAE;QACF,0BAA0B,GAAG,EAAE,CAAC,MAAM,GAAG,GAAG;QAC5C,EAAE;QACF,GAAG,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;QAC5B,EAAE;QACF,+BAA+B;QAC/B,EAAE;KACH,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC9G,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,gBAAgB,GAAG,CAAC,GAAG,EAAE,aAAa,IAAI,GAAG,CAAC,GAAG,aAAa;cAC/E,CAAC,GAAG,EAAE,WAAW,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IAClF,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,mCAAmC,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,CAAC,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC7G,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE;kBAC9E,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY;YAAE,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,EAAE,EAAE,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,wGAAwG,CAAC,CAAC;IACzH,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export declare const VERSION = "1.23.1";
+export declare const VERSION = "1.23.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export const VERSION = '1.23.1';
+export const VERSION = '1.23.3';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.23.1",
+  "version": "1.23.3",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",
@@ -15,23 +15,6 @@
   "exports": {
     ".": "./dist/index.js"
   },
-  "scripts": {
-    "version": "node scripts/sync_version.mjs && git add src/version.ts",
-    "build": "node scripts/clean_dist.mjs && tsc && node scripts/copy_qa_assets.mjs",
-    "dev": "tsx watch src/bin/yf.ts",
-    "typecheck": "tsc --noEmit",
-    "typecheck:all": "pnpm typecheck && pnpm --filter @yujin/hito4-server typecheck && pnpm --filter @yujin/forge-mobile typecheck",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "tsc --noEmit",
-    "yf": "tsx src/bin/yf.ts",
-    "catalog:lint": "node scripts/catalog_lint.mjs",
-    "pairing:check": "node scripts/check_pairing_sync.mjs",
-    "brain-matrix:gate": "node scripts/brain_matrix_gate.mjs",
-    "hito4:lint": "node scripts/hito4_lint_bundle.mjs",
-    "publish-alpha-emergency": "node scripts/publish_alpha_emergency.mjs",
-    "prepublishOnly": "pnpm run build && pnpm run typecheck && pnpm run catalog:lint && pnpm run test && pnpm run brain-matrix:gate && pnpm run hito4:lint"
-  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.32.1",
     "@aws-sdk/client-ecs": "^3.1053.0",
@@ -68,7 +51,6 @@
     "node": ">=18.17",
     "pnpm": ">=9"
   },
-  "packageManager": "pnpm@11.3.0",
   "files": [
     "dist",
     "templates",
@@ -113,5 +95,21 @@
   "publishConfig": {
     "access": "public",
     "tag": "latest"
+  },
+  "scripts": {
+    "version": "node scripts/sync_version.mjs && git add src/version.ts",
+    "build": "node scripts/clean_dist.mjs && tsc && node scripts/copy_qa_assets.mjs",
+    "dev": "tsx watch src/bin/yf.ts",
+    "typecheck": "tsc --noEmit",
+    "typecheck:all": "pnpm typecheck && pnpm --filter @yujin/hito4-server typecheck && pnpm --filter @yujin/forge-mobile typecheck",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "yf": "tsx src/bin/yf.ts",
+    "catalog:lint": "node scripts/catalog_lint.mjs",
+    "pairing:check": "node scripts/check_pairing_sync.mjs",
+    "brain-matrix:gate": "node scripts/brain_matrix_gate.mjs",
+    "hito4:lint": "node scripts/hito4_lint_bundle.mjs",
+    "publish-alpha-emergency": "node scripts/publish_alpha_emergency.mjs"
   }
-}
+}

package/src/i18n/catalogs/ar.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "يتطلب verb المستدعى project root نشط لكن ~/.yujin-forge/projects.json ليس به إدخالات.",
   "error.project_not_registered.fix": "أنشئ واحدا بـ yujin.project.init أو سجل واحدا موجودا بـ yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "لم يُرجع سطح المكتب ردًا على طلبك خلال {minutes} دقيقة.",
+  "error.mobile_turn_unanswered.why": "قد تكون الجولة ما زالت تعمل: ما انتهى هو الانتظار، لا العمل. سطح المكتب لا يتوقف.",
+  "error.mobile_turn_unanswered.fix": "راجع محادثة سطح المكتب: إذا انتهت الجولة فالرد موجود هناك. لا تعد إرسال الطلب قبل أن تتحقق، وإلا سيُنفَّذ مرتين.",
+  "error.mobile_turn_undelivered.what": "لم أتمكن من تسليم طلبك إلى سطح المكتب.",
+  "error.mobile_turn_undelivered.why": "خادم المحادثة في سطح المكتب لم يكن يستمع على المنفذ {port}. لم يُنفَّذ أي شيء هنا.",
+  "error.mobile_turn_undelivered.fix": "افتح لوحة Forge على سطح المكتب (أو شغّلها بـ yf chat) ثم أعد إرسال الطلب.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "الوكلاء",
   "panel.agents.title": "الوكلاء",
   "panel.agents.subtitle": "المدير والوكلاء الفرعيون المسجلون في هذا المشروع",

package/src/i18n/catalogs/de.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "Das aufgerufene Verb benoetigt einen aktiven Project-Root, aber ~/.yujin-forge/projects.json hat keine Eintraege.",
   "error.project_not_registered.fix": "Erstellen Sie eines mit yujin.project.init oder registrieren Sie ein existierendes mit yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "Der Desktop hat deine Anfrage in {minutes} Minuten nicht beantwortet.",
+  "error.mobile_turn_unanswered.why": "Der Turn laeuft moeglicherweise weiter: abgelaufen ist das Warten, nicht die Arbeit. Der Desktop hoert nicht auf.",
+  "error.mobile_turn_unanswered.fix": "Schau in den Desktop-Chat: wenn der Turn fertig ist, steht die Antwort dort. Sende die Anfrage nicht erneut, ohne nachzusehen, sonst laeuft sie zweimal.",
+  "error.mobile_turn_undelivered.what": "Ich konnte deine Anfrage nicht an den Desktop uebergeben.",
+  "error.mobile_turn_undelivered.why": "Der Chat-Server des Desktops lauschte nicht auf Port {port}. Hier wurde nichts ausgefuehrt.",
+  "error.mobile_turn_undelivered.fix": "Oeffne das Forge-Panel auf dem Desktop (oder starte es mit yf chat) und sende die Anfrage erneut.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "Agenten",
   "panel.agents.title": "Agenten",
   "panel.agents.subtitle": "Director und Sub-Agenten registriert in diesem Projekt",

package/src/i18n/catalogs/en.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "The verb you invoked needs an active project root but ~/.yujin-forge/projects.json has no entries.",
   "error.project_not_registered.fix": "Create one with yujin.project.init or register an existing one with yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "The desktop did not return an answer to your request within {minutes} minutes.",
+  "error.mobile_turn_unanswered.why": "The turn may still be running: what expired is the wait, not the work. The desktop does not stop.",
+  "error.mobile_turn_unanswered.fix": "Check the desktop chat: if the turn finished, the answer is there. Do not resend the request before looking, or it runs twice.",
+  "error.mobile_turn_undelivered.what": "I could not hand your request to the desktop.",
+  "error.mobile_turn_undelivered.why": "The desktop chat server was not listening on port {port}. Nothing ran here.",
+  "error.mobile_turn_undelivered.fix": "Open the Forge panel on the desktop (or start it with yf chat) and send the request again.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "Agents",
   "panel.agents.title": "Agents",
   "panel.agents.subtitle": "Director and sub-agents registered in this project",

package/src/i18n/catalogs/es.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "El verb que invocaste requiere project root activo pero ~/.yujin-forge/projects.json no tiene entradas.",
   "error.project_not_registered.fix": "Crea uno con yujin.project.init o registra uno existente con yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "El escritorio no devolvio la respuesta de tu pedido en {minutes} minutos.",
+  "error.mobile_turn_unanswered.why": "El turno puede seguir corriendo: lo que vencio es la espera, no el trabajo. El escritorio no para.",
+  "error.mobile_turn_unanswered.fix": "Mira el chat del escritorio: si el turno termino, la respuesta esta ahi. No repitas el pedido sin fijarte, o se ejecuta dos veces.",
+  "error.mobile_turn_undelivered.what": "No pude entregarle tu pedido al escritorio.",
+  "error.mobile_turn_undelivered.why": "El servidor de chat del escritorio no estaba escuchando en el puerto {port}. Aca no se ejecuto nada.",
+  "error.mobile_turn_undelivered.fix": "Abri el panel de Forge en el escritorio (o arrancalo con yf chat) y volve a mandar el pedido.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "Agentes",
   "panel.agents.title": "Agentes",
   "panel.agents.subtitle": "Director + sub-agentes registrados en este proyecto",

package/src/i18n/catalogs/fr.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "Le verb invoque necessite un project root actif mais ~/.yujin-forge/projects.json n'a pas d'entrees.",
   "error.project_not_registered.fix": "Creez-en un avec yujin.project.init ou enregistrez un existant avec yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "Le bureau n'a pas renvoye de reponse a ta demande en {minutes} minutes.",
+  "error.mobile_turn_unanswered.why": "Le tour peut encore tourner : ce qui a expire, c'est l'attente, pas le travail. Le bureau ne s'arrete pas.",
+  "error.mobile_turn_unanswered.fix": "Regarde le chat du bureau : si le tour est fini, la reponse y est. Ne renvoie pas la demande sans verifier, sinon elle s'execute deux fois.",
+  "error.mobile_turn_undelivered.what": "Je n'ai pas pu transmettre ta demande au bureau.",
+  "error.mobile_turn_undelivered.why": "Le serveur de chat du bureau n'ecoutait pas sur le port {port}. Rien n'a ete execute ici.",
+  "error.mobile_turn_undelivered.fix": "Ouvre le panneau Forge sur le bureau (ou lance-le avec yf chat) puis renvoie la demande.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "Agents",
   "panel.agents.title": "Agents",
   "panel.agents.subtitle": "Director et sous-agents enregistres dans ce projet",

package/src/i18n/catalogs/hi.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "invoked verb को सक्रिय project root की आवश्यकता है लेकिन ~/.yujin-forge/projects.json में कोई entries नहीं हैं।",
   "error.project_not_registered.fix": "yujin.project.init के साथ एक बनाएं या yf projects add के साथ एक मौजूदा पंजीकृत करें।",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "डेस्कटॉप ने {minutes} मिनट में आपके अनुरोध का उत्तर नहीं लौटाया।",
+  "error.mobile_turn_unanswered.why": "टर्न अभी भी चल सकता है: जो समाप्त हुआ वह प्रतीक्षा है, काम नहीं। डेस्कटॉप रुकता नहीं है।",
+  "error.mobile_turn_unanswered.fix": "डेस्कटॉप का चैट देखें: अगर टर्न पूरा हो गया है, तो उत्तर वहीं है। देखे बिना अनुरोध दोबारा न भेजें, वरना वह दो बार चलेगा।",
+  "error.mobile_turn_undelivered.what": "मैं आपका अनुरोध डेस्कटॉप तक नहीं पहुंचा सका।",
+  "error.mobile_turn_undelivered.why": "डेस्कटॉप का चैट सर्वर पोर्ट {port} पर सुन नहीं रहा था। यहां कुछ भी नहीं चला।",
+  "error.mobile_turn_undelivered.fix": "डेस्कटॉप पर Forge पैनल खोलें (या yf chat से शुरू करें) और अनुरोध दोबारा भेजें।",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "एजेंट",
   "panel.agents.title": "एजेंट",
   "panel.agents.subtitle": "इस परियोजना में पंजीकृत निदेशक और उप-एजेंट",

package/src/i18n/catalogs/it.json

@@ -128,6 +128,13 @@
   "error.project_not_registered.why": "Il verb invocato richiede un project root attivo ma ~/.yujin-forge/projects.json non ha voci.",
   "error.project_not_registered.fix": "Creane uno con yujin.project.init o registrane uno esistente con yf projects add.",
   "error.project_not_registered.cmd": "yf projects scan",
+  "error.mobile_turn_unanswered.what": "Il desktop non ha restituito una risposta alla tua richiesta in {minutes} minuti.",
+  "error.mobile_turn_unanswered.why": "Il turno puo essere ancora in corso: a scadere e stata l'attesa, non il lavoro. Il desktop non si ferma.",
+  "error.mobile_turn_unanswered.fix": "Guarda la chat del desktop: se il turno e finito, la risposta e la. Non rimandare la richiesta senza controllare, altrimenti viene eseguita due volte.",
+  "error.mobile_turn_undelivered.what": "Non ho potuto consegnare la tua richiesta al desktop.",
+  "error.mobile_turn_undelivered.why": "Il server di chat del desktop non era in ascolto sulla porta {port}. Qui non e stato eseguito nulla.",
+  "error.mobile_turn_undelivered.fix": "Apri il pannello Forge sul desktop (o avvialo con yf chat) e rimanda la richiesta.",
+  "error.mobile_turn_undelivered.cmd": "yf chat",
   "panel.button.agents": "Agenti",
   "panel.agents.title": "Agenti",
   "panel.agents.subtitle": "Director e sub-agenti registrati in questo progetto",