@nac3/forge-cli 1.26.0 → 1.28.0

package/dist/urazuke/method_config.js

@@ -0,0 +1,328 @@
+/**
+ * LA CONFIGURACION DEL METODO -- de donde sale la definicion, cuando avisa
+ * que hay una version nueva, y cuando se niega a arrancar sin congelar.
+ *
+ * Pedido del dueno, textual (2026-11-03): "y que tanto las compuertas como
+ * los prompts se puedan actualizar desde el config de Forge".
+ *
+ * DONDE VIVE ESTO, Y POR QUE NO EN limits.json
+ *
+ * La pregunta vino abierta ("decidilo vos y escribi por que"), asi que la
+ * decision esta aca y no en un commit message. Vive en el PROYECTO
+ * (`.forge/project-settings.json`, seccion `method`), no en el global del
+ * usuario, por tres razones:
+ *
+ *   1. UNA LLAVE GLOBAL QUE CAMBIA COMO SE MIDE UN PROYECTO ES INVISIBLE EN
+ *      SU HISTORIA. El congelado de las compuertas y el de los prompts ya
+ *      viven en `.forge/` y se commitean; la POLITICA que decide de donde
+ *      salen tiene que viajar igual. Si estuviera en el home del usuario,
+ *      dos maquinas darian dos veredictos del mismo commit y el diff no
+ *      mostraria nada. Eso es exactamente la familia del cero que informaba
+ *      salud.
+ *   2. YA HAY PRECEDENTE EN EL MISMO ARCHIVO. `.forge/project-settings.json`
+ *      es donde el proyecto declara los apagados de reglas, con su registro
+ *      de cuatro campos, y los evaluadores lo leen de ahi. La politica del
+ *      metodo es de la misma clase: politica del proyecto que una compuerta
+ *      consulta.
+ *   3. limits.json ES RUNTIME DE LA MAQUINA (topes, vencimientos, postura
+ *      de aprobacion). Ahi SI pertenece una preferencia de maquina -- si
+ *      este Forge avisa o no cuando sale una version nueva -- y por eso esa
+ *      sola llave esta en limits.json (`urazuke.update_check`) y el
+ *      proyecto la puede pisar. Ruido: maquina. Medicion: proyecto.
+ *
+ * LO QUE ESTA CONFIGURACION NO PUEDE HACER, Y ES EL LIMITE DE TODO ESTO
+ *
+ *     Ninguna llave de configuracion puede adoptar una version sin la razon
+ *     escrita del dueno.
+ *
+ * Si se pudiera declarar "adopta siempre lo ultimo", el doble candado se
+ * termino: el proyecto cambiaria lo que el agente lee en cada turno sin que
+ * nadie firme el cambio. La configuracion puede decir DE DONDE MIRAR,
+ * CUANDO AVISAR y CUANDO NEGARSE A ARRANCAR. La adopcion sigue siendo un
+ * acto con nombre y razon (`gates adopt --reason`, `prompts adopt
+ * --reason`).
+ *
+ * Y no se ignora en silencio al que lo intente: una llave de
+ * auto-adopcion se RECHAZA con el motivo escrito (ver LLAVES_PROHIBIDAS).
+ * Una configuracion que descarta sin avisar es la misma familia de defecto
+ * que todo este lote vino a cerrar.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+export const METHOD_CONFIG_REL = path.join('.forge', 'project-settings.json');
+export function methodConfigPath(projectRoot) {
+    return path.join(projectRoot, METHOD_CONFIG_REL);
+}
+export const PROMPTS_SOURCES = ['frozen', 'published', 'vendored'];
+export function defaultMethodConfig() {
+    return { prompts_source: 'frozen', strict: false };
+}
+/** Llaves que la configuracion NO acepta, con el motivo que se le devuelve
+ *  a quien las escriba. La lista es explicita a proposito: el que la
+ *  intente tiene que leer por que no, no descubrir que no paso nada. */
+export const LLAVES_PROHIBIDAS = {
+    auto_adopt: 'la adopcion es un acto con autor y razon escrita (yf urazuke gates|prompts adopt --reason).'
+        + ' Una llave que adopta sola cambiaria lo que el agente lee en cada turno sin que nadie firme el cambio.',
+    adopt_latest: 'lo mismo que auto_adopt: la configuracion puede decir de donde mirar y cuando avisar, no adoptar.',
+    always_latest: 'lo mismo que auto_adopt. Si lo que queres es seguir al metodo sin congelar,'
+        + ' eso es prompts_source="published", y queda declarado en el proyecto.',
+};
+function esObjeto(v) {
+    return v != null && typeof v === 'object' && !Array.isArray(v);
+}
+function url(v, campo, problems) {
+    if (v === undefined)
+        return undefined;
+    if (typeof v !== 'string' || !/^https?:\/\/|^file:\/\//.test(v.trim())) {
+        problems.push('method.' + campo + ' tiene que ser una direccion http(s) o file: -- ignorada');
+        return undefined;
+    }
+    return v.trim();
+}
+/** Leer la seccion `method` del proyecto. Nunca lanza: un proyecto con un
+ *  settings roto tiene que poder seguir corriendo con los defaults, y
+ *  enterarse de que su archivo no se esta aplicando. */
+export async function readMethodConfig(projectRoot) {
+    const cfg = defaultMethodConfig();
+    const problems = [];
+    const refused = [];
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readFile(methodConfigPath(projectRoot), 'utf8'));
+    }
+    catch (e) {
+        const err = e;
+        if (err && err.code !== 'ENOENT') {
+            problems.push('no pude leer ' + METHOD_CONFIG_REL + ': ' + e.message
+                + ' -- el proyecto corre con la configuracion por omision del metodo');
+        }
+        return { cfg, problems, refused, present: false };
+    }
+    if (!esObjeto(raw)) {
+        problems.push(METHOD_CONFIG_REL + ' no es un objeto JSON -- ignorado');
+        return { cfg, problems, refused, present: true };
+    }
+    const m = raw['method'];
+    if (m === undefined)
+        return { cfg, problems, refused, present: true };
+    if (!esObjeto(m)) {
+        problems.push('method tiene que ser un objeto -- ignorado');
+        return { cfg, problems, refused, present: true };
+    }
+    for (const [k, motivo] of Object.entries(LLAVES_PROHIBIDAS)) {
+        if (m[k] !== undefined) {
+            refused.push('method.' + k + ' NO se aplica: ' + motivo);
+        }
+    }
+    if (m['prompts_source'] !== undefined) {
+        const v = m['prompts_source'];
+        if (typeof v === 'string' && PROMPTS_SOURCES.includes(v)) {
+            cfg.prompts_source = v;
+        }
+        else {
+            problems.push('method.prompts_source acepta ' + PROMPTS_SOURCES.join('|')
+                + ' -- se usa ' + cfg.prompts_source);
+        }
+    }
+    const pu = url(m['prompts_url'], 'prompts_url', problems);
+    if (pu)
+        cfg.prompts_url = pu;
+    const gu = url(m['gates_url'], 'gates_url', problems);
+    if (gu)
+        cfg.gates_url = gu;
+    const lu = url(m['ledger_url'], 'ledger_url', problems);
+    if (lu)
+        cfg.ledger_url = lu;
+    if (m['check_on_start'] !== undefined) {
+        if (typeof m['check_on_start'] === 'boolean')
+            cfg.check_on_start = m['check_on_start'];
+        else
+            problems.push('method.check_on_start tiene que ser booleano -- se usa el ajuste de la maquina');
+    }
+    if (m['strict'] !== undefined) {
+        if (typeof m['strict'] === 'boolean')
+            cfg.strict = m['strict'];
+        else
+            problems.push('method.strict tiene que ser booleano -- se usa ' + cfg.strict);
+    }
+    /* Las llaves que nadie reconoce se nombran. Un typo en una politica que
+     * decide como se mide un proyecto no puede pasar inadvertido. */
+    const conocidas = new Set([
+        'prompts_source', 'prompts_url', 'gates_url', 'ledger_url', 'check_on_start', 'strict',
+        ...Object.keys(LLAVES_PROHIBIDAS),
+    ]);
+    for (const k of Object.keys(m)) {
+        if (!conocidas.has(k))
+            problems.push('method.' + k + ' no es una llave que Forge conozca -- ignorada');
+    }
+    return { cfg, problems, refused, present: true };
+}
+/** Resolver si este proyecto avisa de versiones nuevas: el proyecto manda,
+ *  la maquina pone el default. */
+export function updateCheckEnabled(cfg, machine) {
+    if (cfg.check_on_start !== undefined)
+        return cfg.check_on_start;
+    return machine !== 'off';
+}
+/**
+ * EL MODO ESTRICTO. Un proyecto que declara `method.strict` no corre la
+ * escalera leyendo el catalogo compilado ni los prompts vendorizados: eso
+ * es medir con un instrumento distinto del que el proyecto declaro, y para
+ * un equipo que esta midiendo es peor que no correr.
+ *
+ * Devuelve el veredicto en vez de lanzar: el que decide si frena es el
+ * llamador (el arranque frena; un `status` informa y sigue, porque negarle
+ * a alguien VER el estado por no haber congelado seria absurdo).
+ */
+export function methodStrictVerdict(cfg, estado) {
+    const missing = [];
+    if (!estado.gates_frozen)
+        missing.push('las compuertas');
+    if (!estado.prompts_frozen)
+        missing.push('los prompts');
+    if (!cfg.strict) {
+        return {
+            strict: false, ok: true, missing,
+            detail: missing.length
+                ? 'sin congelar: ' + missing.join(' y ') + '. El proyecto NO declara modo estricto,'
+                    + ' asi que corre leyendo lo que haya (catalogo compilado / prompts publicados) y lo dice.'
+                : 'las dos mitades estan congeladas.',
+        };
+    }
+    if (!missing.length) {
+        return { strict: true, ok: true, missing, detail: 'modo estricto: las dos mitades estan congeladas.' };
+    }
+    return {
+        strict: true, ok: false, missing,
+        detail: 'MODO ESTRICTO: este proyecto declara method.strict y le falta congelar ' + missing.join(' y ')
+            + '. No corro la escalera leyendo otra version del metodo que la que el proyecto declaro:'
+            + ' corre `yf urazuke freeze` (congela lo que lee hoy) o'
+            + ' `yf urazuke gates adopt --reason "..."` / `yf urazuke prompts adopt --reason "..."`'
+            + ' para adoptar la publicada. Si no queres esta compuerta, saca method.strict del'
+            + ' ' + METHOD_CONFIG_REL + '.',
+    };
+}
+/** Una linea por mitad que tenga version nueva publicada. Sin red, sin
+ *  congelado o sin version publicada legible NO dice nada: un aviso que no
+ *  pudo mirar no se informa como "estas al dia". */
+export function compareVersions(half, frozen, published) {
+    if (!frozen || !published || frozen === published)
+        return undefined;
+    return {
+        half, frozen, published,
+        detail: (half === 'gates' ? 'las compuertas' : 'los prompts') + ' del proyecto estan congelados en '
+            + frozen + ' y el metodo publica ' + published + '. Adoptarla es una decision con razon escrita:'
+            + ' `yf urazuke ' + (half === 'gates' ? 'gates' : 'prompts') + ' pull` mide lo que cambia sin escribir nada.',
+    };
+}
+/**
+ * EL ESTADO DEL METODO EN ESTE PROYECTO, de una sola lectura: que dice la
+ * configuracion, que esta congelado, si el modo estricto deja arrancar y si
+ * hay version nueva publicada.
+ *
+ * `check_updates` sale de la maquina (limits.json urazuke.update_check) y lo
+ * pisa el proyecto. Cuando esta apagado NO se sale a la red, y el resultado
+ * lo dice en vez de informar silencio como si fuera "al dia".
+ */
+export async function methodState(projectRoot, opts = {}) {
+    const { cfg, problems, refused } = await readMethodConfig(projectRoot);
+    const config_notices = [...refused, ...problems];
+    let gates_frozen = false;
+    let gates_version;
+    try {
+        const { readFrozenGates } = await import('./gates_data.js');
+        const g = await readFrozenGates(projectRoot);
+        if (g.gates) {
+            gates_frozen = true;
+            gates_version = g.gates.version;
+        }
+        else if (g.refused?.length)
+            config_notices.push('el congelado de compuertas NO verifica: ' + g.refused.join('; '));
+    }
+    catch { /* sin congelado */ }
+    let prompts_frozen = false;
+    let prompts_version;
+    try {
+        const { readFrozenPrompts, declaredPromptsVersion } = await import('./prompts_freeze.js');
+        const p = await readFrozenPrompts(projectRoot);
+        if (p.prompts) {
+            prompts_frozen = true;
+            prompts_version = declaredPromptsVersion(p.prompts);
+        }
+        else if (p.refused?.length)
+            config_notices.push('el congelado de prompts NO verifica: ' + p.refused.join('; '));
+    }
+    catch { /* sin congelado */ }
+    const strict = methodStrictVerdict(cfg, { gates_frozen, prompts_frozen });
+    const state = {
+        cfg, config_notices, gates_frozen, prompts_frozen, strict, updates: [],
+        ...(gates_version ? { gates_version } : {}),
+        ...(prompts_version ? { prompts_version } : {}),
+    };
+    if (!updateCheckEnabled(cfg, opts.machine_update_check)) {
+        state.could_not_check = 'el aviso de version nueva esta apagado'
+            + ' (limits.json urazuke.update_check=off, o method.check_on_start=false en el proyecto):'
+            + ' no mire, asi que no se si hay una version nueva.';
+        return state;
+    }
+    /* SIN CONGELADO NO HAY CON QUE COMPARAR, y eso NO es "estas al dia".
+     * Decirlo asi es la mitad del defecto que este modulo viene a cerrar: un
+     * proyecto sin congelar lee lo publicado en cada turno, asi que por
+     * construccion no tiene version nueva que adoptar -- y tampoco tiene
+     * version fija, que es la otra mitad de la frase y la que importa. */
+    if (!prompts_frozen) {
+        state.could_not_check = 'los prompts de este proyecto NO estan congelados, asi que no hay con que'
+            + ' comparar: lee lo publicado en cada turno. No es "al dia": es "sin version fija".'
+            + ' `yf urazuke freeze` congela lo que lee hoy.';
+        return state;
+    }
+    /* Los prompts son la mitad que se puede comparar sin instalar nada: la
+     * definicion de compuertas en vigor NO sale a la red por diseno, asi que
+     * su contraste es `yf urazuke gates pull`, que es un acto explicito. */
+    try {
+        const { loadPublishedPrompts } = await import('./prompts_client.js');
+        const pub = await loadPublishedPrompts({
+            ...(opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}),
+            ...(opts.offline ? { offline: true } : {}),
+            ...(cfg.prompts_url ? { url: cfg.prompts_url } : {}),
+        });
+        if (!pub) {
+            state.could_not_check = 'no pude leer los prompts publicados (sin red y sin cache util):'
+                + ' no se si hay una version nueva, que no es lo mismo que estar al dia.';
+        }
+        else {
+            const { declaredPromptsVersion } = await import('./prompts_freeze.js');
+            const publicada = declaredPromptsVersion(pub.payload);
+            const n = compareVersions('prompts', prompts_version, publicada);
+            if (n)
+                state.updates.push(n);
+        }
+    }
+    catch (e) {
+        state.could_not_check = 'no pude comparar contra lo publicado: ' + e.message;
+    }
+    return state;
+}
+/** El estado en lineas, para el CLI y el arranque. */
+export function renderMethodState(s) {
+    const L = [];
+    L.push('compuertas: ' + (s.gates_frozen ? 'congeladas en ' + s.gates_version : 'SIN congelar')
+        + ' | prompts: ' + (s.prompts_frozen ? 'congelados en ' + s.prompts_version : 'SIN congelar'));
+    L.push('fuente de los prompts: ' + s.cfg.prompts_source
+        + (s.cfg.prompts_url ? ' (' + s.cfg.prompts_url + ')' : '')
+        + ' | modo estricto: ' + (s.cfg.strict ? 'SI' : 'no'));
+    for (const n of s.config_notices)
+        L.push('aviso: ' + n);
+    if (!s.strict.ok)
+        L.push(s.strict.detail);
+    for (const u of s.updates)
+        L.push('VERSION NUEVA: ' + u.detail);
+    if (s.could_not_check)
+        L.push('aviso: ' + s.could_not_check);
+    if (!s.updates.length && !s.could_not_check)
+        L.push('no hay version nueva publicada de los prompts.');
+    return L;
+}
+//# sourceMappingURL=method_config.js.map

package/dist/urazuke/method_config.js.map

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

package/dist/urazuke/prompts_client.d.ts

@@ -1,5 +1,5 @@
 export declare const DEFAULT_PROMPTS_URL = "https://yujin.app/urazuke/api/prompts.json";
-export type PromptSource = 'override' | 'remote' | 'cache' | 'vendored';
+export type PromptSource = 'override' | 'frozen' | 'remote' | 'cache' | 'vendored';
 export interface PromptsApiPayload {
     version: string;
     generated_at?: string;
@@ -15,6 +15,19 @@ export interface ResolvedPrompts {
     version: string;
     /** Keys the project overrides. */
     overridden: string[];
+    /** El congelado del proyecto, cuando hay uno que verifica. */
+    frozen?: {
+        version: string;
+        hash: string;
+        frozen_at?: string;
+        frozen_reason?: string;
+    };
+    /** Lo que el dueno tiene que saber y nadie mas le va a decir: un
+     *  congelado que no verifica, un archivo viejo que no declara si es
+     *  congelado u override, una llave de configuracion rechazada. Nunca se
+     *  calla: un congelado que se ignora en silencio es la version que el
+     *  proyecto creia tener y no tiene. */
+    notices?: string[];
 }
 export interface PromptOverridesFile {
     version: 1;
@@ -55,7 +68,16 @@ export declare function resolveCanonicalPrompts(opts?: FetchOptions): Promise<{
     source: Record<string, PromptSource>;
     version: string;
 }>;
-/** Effective prompts for a project: overrides > published > vendored. */
+/**
+ * Effective prompts for a project: overrides > FROZEN > published > vendored.
+ *
+ * El congelado entra en el medio y cambia una cosa mas que el orden: cuando
+ * hay un congelado que verifica y la configuracion del proyecto no pide otra
+ * cosa, esta funcion NO SALE A LA RED. Es la misma regla que las compuertas
+ * ya cumplen (resolveGates no consulta el portal nunca): un proyecto no
+ * cambia de regla entre dos turnos, y resolver un prompt no es el momento de
+ * descubrir que el portal se movio.
+ */
 export declare function resolvePrompts(projectRoot: string | undefined, opts?: FetchOptions): Promise<ResolvedPrompts>;
 export interface PullResult {
     /** The canonical version these prompts were pulled from. */
@@ -66,16 +88,24 @@ export interface PullResult {
      *  before (a fresh `pull` of an up-to-date project reports none). */
     changed: string[];
 }
-/** Bring the CANONICAL prompts (never this project's own overrides, even
- *  if some exist already) and write them into
- *  `<root>/.forge/urazuke-prompts.json`, replacing one contract (`key`) or
- *  every contract Forge knows about. Unlike `reset` -- which deletes the
- *  override and falls back to live resolution -- `pull` leaves an explicit,
- *  on-disk copy the project keeps control of afterwards (D-036): it does
- *  not depend on the network or on which Forge version is installed to
- *  know what text the agent is working from, and the owner can still edit
- *  it by hand (or with `prompts set`) once pulled. */
-export declare function pullPrompts(projectRoot: string, opts?: FetchOptions & {
+/**
+ * Copiar los prompts CANONICOS al archivo de OVERRIDES del proyecto,
+ * pisando lo que hubiera.
+ *
+ * SE LLAMABA `pullPrompts`, Y ESE NOMBRE ERA EL DEFECTO (PND-277). En el
+ * mismo comando padre, `gates pull` MIDE y no escribe; este ESCRIBIA y no
+ * media. Un dueno que aprendio el seguro y corrio el otro por analogia ya
+ * se habia pisado los prompts del proyecto. El nombre prometia el
+ * comportamiento del otro, que es peor que no existir.
+ *
+ * La capacidad sigue siendo legitima para UN caso -- "quiero el texto
+ * publicado como punto de partida para editarlo a mano" -- asi que no se
+ * borro: se le puso el nombre que dice lo que hace, y el CLI la expone como
+ * `yf urazuke prompts copy-to-overrides`. Lo que escribe son OVERRIDES del
+ * dueno, no un congelado: el congelado tiene version, huella y razon, y se
+ * escribe con `prompts adopt --reason` (src/urazuke/prompts_freeze.ts).
+ */
+export declare function copyCanonicalIntoOverrides(projectRoot: string, opts?: FetchOptions & {
     key?: string;
 }): Promise<PullResult>;
 //# sourceMappingURL=prompts_client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompts_client.d.ts","sourceRoot":"","sources":["../../src/urazuke/prompts_client.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,mBAAmB,+CAA+C,CAAC;AAIhF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC3C,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAcD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAYD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAYrF;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlG;AAgBD,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;qEAIiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;wDACwD;AACxD,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,CAuBnJ;AAED;;;;uCAIuC;AACvC,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAarL;AAED,yEAAyE;AACzE,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAUvH;AAED,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;yEACqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;sDAQsD;AACtD,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CActH"}
+{"version":3,"file":"prompts_client.d.ts","sourceRoot":"","sources":["../../src/urazuke/prompts_client.ts"],"names":[],"mappings":"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"}

package/dist/urazuke/prompts_client.js

@@ -3,10 +3,18 @@
  *
  *   1. The project's overrides: <root>/.forge/urazuke-prompts.json
  *      (the owner controls the text; `yf urazuke prompts set|reset`).
- *   2. The method's published API: https://yujin.app/urazuke/api/prompts.json
+ *   2. THE PROJECT'S FROZEN COPY: <root>/.forge/urazuke-prompts-frozen.json
+ *      (PND-277, 2026-11-03). The version of the method this project lives
+ *      on, sealed and with the owner's written reason inside. It sits
+ *      BETWEEN the overrides and the published file on purpose: it pins the
+ *      version without taking the text away from the owner, which is the
+ *      reason the overrides exist. And a frozen project does NOT go to the
+ *      network to resolve a prompt -- same rule the gates already follow:
+ *      a project does not change rule between two turns.
+ *   3. The method's published API: https://yujin.app/urazuke/api/prompts.json
  *      (cached at ~/.yujin-forge/cache/urazuke_prompts.json, 24 h fresh,
  *      30 days stale-on-failure).
- *   3. The vendored copy in prompts.generated.ts (offline fallback).
+ *   4. The vendored copy in prompts.generated.ts (offline fallback).
  *
  * Why the API and not only the vendored copy: the method evolves in its own
  * repository and publishes in eight languages; Forge should follow the
@@ -134,7 +142,13 @@ export async function resolveCanonicalPrompts(opts = {}) {
     let version = URAZUKE_PROMPTS_SOURCE;
     const pub = await loadPublishedPrompts(opts);
     if (pub) {
-        version = 'pkuschnirof/urazuke@' + pub.payload.version;
+        /* La identidad de lo publicado es corpus_version, no el sha: el propio
+         * payload lo dice ("ninguna comparacion mira esto") y el registro
+         * append-only anota por corpus_version. Forge venia sellando cada
+         * recibo con el sha -- que, ademas, nombra el cambio ANTERIOR al que
+         * contiene el archivo. Fallback al sha para un payload viejo. */
+        const declarada = pub.payload['corpus_version'];
+        version = 'pkuschnirof/urazuke@' + (typeof declarada === 'string' && declarada.trim() ? declarada : pub.payload.version);
         for (const [k, v] of Object.entries(pub.payload.contracts)) {
             if (v.length) {
                 prompts[k] = v;
@@ -144,9 +158,77 @@ export async function resolveCanonicalPrompts(opts = {}) {
     }
     return { prompts, source, version };
 }
-/** Effective prompts for a project: overrides > published > vendored. */
+/**
+ * Effective prompts for a project: overrides > FROZEN > published > vendored.
+ *
+ * El congelado entra en el medio y cambia una cosa mas que el orden: cuando
+ * hay un congelado que verifica y la configuracion del proyecto no pide otra
+ * cosa, esta funcion NO SALE A LA RED. Es la misma regla que las compuertas
+ * ya cumplen (resolveGates no consulta el portal nunca): un proyecto no
+ * cambia de regla entre dos turnos, y resolver un prompt no es el momento de
+ * descubrir que el portal se movio.
+ */
 export async function resolvePrompts(projectRoot, opts = {}) {
-    const { prompts, source, version } = await resolveCanonicalPrompts(opts);
+    const notices = [];
+    let frozen;
+    let frozenContracts;
+    let fuente = 'frozen';
+    if (projectRoot) {
+        try {
+            const { readMethodConfig } = await import('./method_config.js');
+            const cfg = await readMethodConfig(projectRoot);
+            fuente = cfg.cfg.prompts_source;
+            for (const r of cfg.refused)
+                notices.push(r);
+            for (const p of cfg.problems)
+                notices.push(p);
+            if (cfg.cfg.prompts_url && !opts.url)
+                opts = { ...opts, url: cfg.cfg.prompts_url };
+        }
+        catch { /* sin configuracion legible, el default: congelado primero */ }
+        if (fuente === 'frozen') {
+            try {
+                const { readFrozenPrompts, declaredPromptsVersion } = await import('./prompts_freeze.js');
+                const fr = await readFrozenPrompts(projectRoot);
+                if (fr.prompts) {
+                    frozenContracts = fr.prompts.contracts;
+                    const meta = fr.prompts;
+                    frozen = {
+                        version: declaredPromptsVersion(fr.prompts),
+                        hash: fr.prompts.content_hash.value,
+                        ...(typeof meta['frozen_at'] === 'string' ? { frozen_at: meta['frozen_at'] } : {}),
+                        ...(typeof meta['frozen_reason'] === 'string' ? { frozen_reason: meta['frozen_reason'] } : {}),
+                    };
+                }
+                else if (fr.refused?.length) {
+                    /* Un congelado que no verifica NO se usa y NO se calla: el
+                     * proyecto pasa a leer lo publicado, que es otra version que la
+                     * que creia haber fijado. */
+                    notices.push('el congelado de prompts de este proyecto NO verifica y no lo estoy usando: '
+                        + fr.refused.join('; ') + '. Mientras siga asi, el proyecto lee los prompts publicados'
+                        + ' y NO la version que creia haber congelado. Restauralo desde el repositorio o borralo'
+                        + ' para que el proximo freeze lo vuelva a escribir.');
+                }
+            }
+            catch { /* el congelado es opcional */ }
+        }
+    }
+    /* Con congelado no hace falta la red; sin congelado, lo publicado (o la
+     * copia vendorizada si la configuracion lo pide). */
+    const canonOpts = frozenContracts || fuente === 'vendored'
+        ? { ...opts, offline: true }
+        : opts;
+    const { prompts, source, version: versionPublicada } = await resolveCanonicalPrompts(canonOpts);
+    let version = versionPublicada;
+    if (frozenContracts && frozen) {
+        for (const [k, v] of Object.entries(frozenContracts)) {
+            if (v.length) {
+                prompts[k] = v;
+                source[k] = 'frozen';
+            }
+        }
+        version = 'pkuschnirof/urazuke@' + frozen.version;
+    }
     const overridden = [];
     if (projectRoot) {
         const ov = await readOverrides(projectRoot);
@@ -155,19 +237,41 @@ export async function resolvePrompts(projectRoot, opts = {}) {
             source[k] = 'override';
             overridden.push(k);
         }
+        if (overridden.length && !frozen) {
+            /* EL ARCHIVO AMBIGUO (el caso del brazo C1): un
+             * .forge/urazuke-prompts.json escrito por el pull viejo es
+             * indistinguible de una edicion a mano. No se adivina: se dice. */
+            notices.push('este proyecto tiene ' + overridden.length + ' contrato(s) en'
+                + ' .forge/urazuke-prompts.json y NINGUN congelado declarado. Ese archivo no dice si es'
+                + ' una copia congelada o una edicion a mano, y no lo adivino:'
+                + ' `yf urazuke prompts pull` lo mide y `yf urazuke prompts adopt --reason "..."`'
+                + ' lo convierte en un congelado con autor.');
+        }
     }
-    return { prompts, source, version, overridden: overridden.sort() };
+    return {
+        prompts, source, version, overridden: overridden.sort(),
+        ...(frozen ? { frozen } : {}),
+        ...(notices.length ? { notices } : {}),
+    };
 }
-/** Bring the CANONICAL prompts (never this project's own overrides, even
- *  if some exist already) and write them into
- *  `<root>/.forge/urazuke-prompts.json`, replacing one contract (`key`) or
- *  every contract Forge knows about. Unlike `reset` -- which deletes the
- *  override and falls back to live resolution -- `pull` leaves an explicit,
- *  on-disk copy the project keeps control of afterwards (D-036): it does
- *  not depend on the network or on which Forge version is installed to
- *  know what text the agent is working from, and the owner can still edit
- *  it by hand (or with `prompts set`) once pulled. */
-export async function pullPrompts(projectRoot, opts = {}) {
+/**
+ * Copiar los prompts CANONICOS al archivo de OVERRIDES del proyecto,
+ * pisando lo que hubiera.
+ *
+ * SE LLAMABA `pullPrompts`, Y ESE NOMBRE ERA EL DEFECTO (PND-277). En el
+ * mismo comando padre, `gates pull` MIDE y no escribe; este ESCRIBIA y no
+ * media. Un dueno que aprendio el seguro y corrio el otro por analogia ya
+ * se habia pisado los prompts del proyecto. El nombre prometia el
+ * comportamiento del otro, que es peor que no existir.
+ *
+ * La capacidad sigue siendo legitima para UN caso -- "quiero el texto
+ * publicado como punto de partida para editarlo a mano" -- asi que no se
+ * borro: se le puso el nombre que dice lo que hace, y el CLI la expone como
+ * `yf urazuke prompts copy-to-overrides`. Lo que escribe son OVERRIDES del
+ * dueno, no un congelado: el congelado tiene version, huella y razon, y se
+ * escribe con `prompts adopt --reason` (src/urazuke/prompts_freeze.ts).
+ */
+export async function copyCanonicalIntoOverrides(projectRoot, opts = {}) {
     const canonical = await resolveCanonicalPrompts(opts);
     if (opts.key && !canonical.prompts[opts.key])
         throw new Error('no existe el contrato ' + opts.key);