@trazum/cli 3.0.1 → 3.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/README.md +4 -1
  2. package/assets/trazum-statusline.sh +45 -0
  3. package/dist/base-cost.d.ts +173 -0
  4. package/dist/base-cost.d.ts.map +1 -0
  5. package/dist/base-cost.js +244 -0
  6. package/dist/base-cost.js.map +1 -0
  7. package/dist/bill-range.d.ts +118 -0
  8. package/dist/bill-range.d.ts.map +1 -0
  9. package/dist/bill-range.js +122 -0
  10. package/dist/bill-range.js.map +1 -0
  11. package/dist/command-help.d.ts +17 -0
  12. package/dist/command-help.d.ts.map +1 -0
  13. package/dist/command-help.js +69 -0
  14. package/dist/command-help.js.map +1 -0
  15. package/dist/filter.d.ts +7 -1
  16. package/dist/filter.d.ts.map +1 -1
  17. package/dist/filter.js +10 -18
  18. package/dist/filter.js.map +1 -1
  19. package/dist/gateway-metrics.d.ts +83 -0
  20. package/dist/gateway-metrics.d.ts.map +1 -0
  21. package/dist/gateway-metrics.js +181 -0
  22. package/dist/gateway-metrics.js.map +1 -0
  23. package/dist/gateway-server.d.ts +23 -5
  24. package/dist/gateway-server.d.ts.map +1 -1
  25. package/dist/gateway-server.js +26 -1
  26. package/dist/gateway-server.js.map +1 -1
  27. package/dist/gateway-spend.d.ts +11 -1
  28. package/dist/gateway-spend.d.ts.map +1 -1
  29. package/dist/gateway-spend.js +44 -32
  30. package/dist/gateway-spend.js.map +1 -1
  31. package/dist/git.d.ts +70 -0
  32. package/dist/git.d.ts.map +1 -1
  33. package/dist/git.js +145 -0
  34. package/dist/git.js.map +1 -1
  35. package/dist/i18n/en.d.ts.map +1 -1
  36. package/dist/i18n/en.js +358 -6
  37. package/dist/i18n/en.js.map +1 -1
  38. package/dist/i18n/es.d.ts +0 -1
  39. package/dist/i18n/es.d.ts.map +1 -1
  40. package/dist/i18n/es.js +456 -35
  41. package/dist/i18n/es.js.map +1 -1
  42. package/dist/i18n/types.d.ts +205 -0
  43. package/dist/i18n/types.d.ts.map +1 -1
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +942 -59
  46. package/dist/index.js.map +1 -1
  47. package/dist/loopback-guard.d.ts +37 -0
  48. package/dist/loopback-guard.d.ts.map +1 -0
  49. package/dist/loopback-guard.js +65 -0
  50. package/dist/loopback-guard.js.map +1 -0
  51. package/dist/markdown.d.ts +23 -0
  52. package/dist/markdown.d.ts.map +1 -1
  53. package/dist/markdown.js +105 -0
  54. package/dist/markdown.js.map +1 -1
  55. package/dist/plan-edits.d.ts +63 -0
  56. package/dist/plan-edits.d.ts.map +1 -0
  57. package/dist/plan-edits.js +96 -0
  58. package/dist/plan-edits.js.map +1 -0
  59. package/dist/proactive.d.ts +17 -2
  60. package/dist/proactive.d.ts.map +1 -1
  61. package/dist/proactive.js +16 -9
  62. package/dist/proactive.js.map +1 -1
  63. package/dist/receipt-send.d.ts +44 -0
  64. package/dist/receipt-send.d.ts.map +1 -0
  65. package/dist/receipt-send.js +71 -0
  66. package/dist/receipt-send.js.map +1 -0
  67. package/dist/serve.d.ts +7 -0
  68. package/dist/serve.d.ts.map +1 -1
  69. package/dist/serve.js +22 -1
  70. package/dist/serve.js.map +1 -1
  71. package/dist/session-guard.d.ts +210 -0
  72. package/dist/session-guard.d.ts.map +1 -0
  73. package/dist/session-guard.js +463 -0
  74. package/dist/session-guard.js.map +1 -0
  75. package/dist/task.d.ts +7 -1
  76. package/dist/task.d.ts.map +1 -1
  77. package/dist/task.js +7 -26
  78. package/dist/task.js.map +1 -1
  79. package/dist/waste.d.ts +25 -0
  80. package/dist/waste.d.ts.map +1 -0
  81. package/dist/waste.js +39 -0
  82. package/dist/waste.js.map +1 -0
  83. package/dist/zone.d.ts +27 -0
  84. package/dist/zone.d.ts.map +1 -0
  85. package/dist/zone.js +96 -0
  86. package/dist/zone.js.map +1 -0
  87. package/package.json +2 -2
  88. package/src/base-cost.ts +384 -0
  89. package/src/bill-range.ts +206 -0
  90. package/src/command-help.ts +65 -0
  91. package/src/filter.ts +11 -18
  92. package/src/gateway-metrics.ts +209 -0
  93. package/src/gateway-server.ts +43 -6
  94. package/src/gateway-spend.ts +45 -33
  95. package/src/git.ts +158 -0
  96. package/src/i18n/en.ts +424 -6
  97. package/src/i18n/es.ts +542 -35
  98. package/src/i18n/types.ts +208 -0
  99. package/src/index.ts +952 -58
  100. package/src/loopback-guard.ts +74 -0
  101. package/src/markdown.ts +117 -0
  102. package/src/plan-edits.ts +120 -0
  103. package/src/proactive.ts +22 -13
  104. package/src/receipt-send.ts +89 -0
  105. package/src/serve.ts +23 -1
  106. package/src/session-guard.ts +541 -0
  107. package/src/task.ts +8 -26
  108. package/src/waste.ts +42 -0
  109. package/src/zone.ts +95 -0
package/dist/i18n/es.js CHANGED
@@ -5,9 +5,113 @@ const plural = (value, one, many = `${one}s`) => `${count(value)} ${value === 1
5
5
  /** "(hace 46 días)", o nada cuando no se sabe la antigüedad. */
6
6
  const hace = (days) => days === null ? '' : days === 0 ? ' (hoy)' : days === 1 ? ' (hace 1 día)' : ` (hace ${days} días)`;
7
7
  /** Spanish catalogue. Mirrors `en.ts`; see that file for the contract. */
8
+ /**
9
+ * What `trazum task`, `trazum filter` and the core's task analysis raise, in
10
+ * Spanish (#871). Keyed by the English text they are raised with, because the
11
+ * core has no locale; `i18n.test.js` reads every such text from the sources and
12
+ * fails on one with no entry here.
13
+ */
14
+ const TASK_FILTER_ES = new Map(Object.entries({
15
+ // packages/cli/src/task.ts
16
+ 'Unknown task action. Run trazum task --help.': 'Acción de task desconocida. Prueba con "trazum task --help".',
17
+ 'Unsupported task option. Run trazum task --help.': 'Opción de task no admitida. Prueba con "trazum task --help".',
18
+ 'Task options cannot be repeated except source flags.': 'Las opciones de task no se pueden repetir, salvo las de fuente.',
19
+ 'A task option is missing its value.': 'A una opción de task le falta su valor.',
20
+ 'At most 16 task sources are accepted.': 'Se aceptan como mucho 16 fuentes de tarea.',
21
+ 'Task output exceeds the report limit; use a smaller complete task source.': 'La salida de task supera el límite del informe; usa una fuente de tarea completa más pequeña.',
22
+ 'Wrong number of task input files. Run trazum task --help.': 'Número de ficheros de entrada de task equivocado. Prueba con "trazum task --help".',
23
+ 'Provide at least one --claude-code or --codex file.': 'Indica al menos un fichero con --claude-code o --codex.',
24
+ // packages/cli/src/task-files.ts
25
+ 'Input must be a bounded regular file, not a symlink or stream.': 'La entrada debe ser un fichero normal de tamaño acotado, no un enlace simbólico ni un flujo.',
26
+ 'Input must be a regular file, not a symlink or stream.': 'La entrada debe ser un fichero normal, no un enlace simbólico ni un flujo.',
27
+ 'Input changed while opening; retry after other edits finish.': 'La entrada cambió mientras se abría; vuelve a intentarlo cuando terminen las otras ediciones.',
28
+ 'Input changed while reading; finish the task and retry with a stable transcript.': 'La entrada cambió mientras se leía; termina la tarea y vuelve a intentarlo con una transcripción estable.',
29
+ 'Input was replaced while reading; retry after other edits finish.': 'La entrada se sustituyó mientras se leía; vuelve a intentarlo cuando terminen las otras ediciones.',
30
+ 'Input must be UTF-8 text without NUL bytes.': 'La entrada debe ser texto UTF-8 sin bytes NUL.',
31
+ 'Cannot read input; provide an existing, readable regular file without a symlink.': 'No se puede leer la entrada; indica un fichero normal que exista y se pueda leer, sin enlace simbólico.',
32
+ 'Cannot create output; choose a new file in an existing writable directory.': 'No se puede crear la salida; elige un fichero nuevo en un directorio que exista y admita escritura.',
33
+ 'Instructions must be a regular file owned by you, without symlinks or hard links.': 'Las instrucciones deben ser un fichero normal tuyo, sin enlaces simbólicos ni enlaces duros.',
34
+ 'The managed policy block was edited or is malformed; review it manually before retrying.': 'El bloque de política gestionado se editó o está mal formado; revísalo a mano antes de volver a intentarlo.',
35
+ 'Instructions would exceed the input limit.': 'Las instrucciones superarían el límite de entrada.',
36
+ 'Instructions changed while preparing the policy; retry after other edits finish.': 'Las instrucciones cambiaron mientras se preparaba la política; vuelve a intentarlo cuando terminen las otras ediciones.',
37
+ 'Cannot update instructions; choose an existing writable file in a writable directory.': 'No se pueden actualizar las instrucciones; elige un fichero que exista y admita escritura, en un directorio que también la admita.',
38
+ // packages/cli/src/filter.ts
39
+ 'Store must be a real directory.': 'El almacén debe ser un directorio real.',
40
+ 'Store must be owned by you and have mode 0700.': 'El almacén debe ser tuyo y tener el modo 0700.',
41
+ 'Invalid recovery file.': 'Fichero de recuperación no válido.',
42
+ 'Recovery integrity check failed.': 'Ha fallado la comprobación de integridad de la recuperación.',
43
+ 'Invalid arguments. Run trazum filter --help.': 'Argumentos no válidos. Prueba con "trazum filter --help".',
44
+ 'Expected a SHA-256 recovery identifier.': 'Se esperaba un identificador de recuperación SHA-256.',
45
+ 'Pipe a tool log into stdin; interactive tools are not supported.': 'Pasa el log de una herramienta por la entrada estándar; las herramientas interactivas no se admiten.',
46
+ 'Trazum: original could not be retained; passing log through unchanged.': 'Trazum: no se pudo guardar el original; el log pasa sin cambios.',
47
+ // packages/core/src/task-analysis.ts and task.ts
48
+ 'Invalid task data. See the task workflow schema and limits.': 'Datos de tarea no válidos. Consulta el esquema y los límites del flujo de task.',
49
+ 'Ambiguous Claude request identifiers across sessions. Supply separate session sources.': 'Identificadores de petición de Claude ambiguos entre sesiones. Indica fuentes de sesión separadas.',
50
+ 'Duplicate task sources are not supported. Supply each session once.': 'No se admiten fuentes de tarea duplicadas. Indica cada sesión una sola vez.',
51
+ 'Multiple sources from the same harness require explicit, disjoint sessions.': 'Varias fuentes del mismo agente necesitan sesiones explícitas y sin solapes.',
52
+ 'Overlapping task sessions are not supported. Supply each session once.': 'No se admiten sesiones de tarea solapadas. Indica cada sesión una sola vez.',
53
+ 'Task usage exceeds safe numeric limits.': 'El uso de la tarea supera los límites numéricos seguros.',
54
+ 'No actionable repeated read, search or explicit failure evidence was found.': 'No se encontró ninguna prueba accionable de lecturas o búsquedas repetidas, ni de fallos explícitos.',
55
+ }));
8
56
  export const es = {
9
57
  locale: 'es',
10
58
  numberLocale: 'es-ES',
59
+ commandHelpMore: 'Todos los comandos, el fichero de configuración, los precios y los ejemplos: trazum --help',
60
+ taskFilter: {
61
+ taskHelp: (maxChars) => `Uso:
62
+ trazum task analyze --id <id> --type <tipo> --criterion <texto>
63
+ --claude-code <fichero> [--codex <fichero>] [--claude-code <fichero> ...]
64
+ [--outcome accepted|rejected|unknown --assessor <etiqueta>]
65
+ [--policy baseline|repeat-review-v1] [-o <informe-nuevo.json>]
66
+ trazum task policy <informe.json> [-o <politica-nueva.md>]
67
+ trazum task apply <informe.json> --instructions <fichero-existente>
68
+ trazum task revert --instructions <fichero-existente>
69
+ trazum task compare <antes.json> <despues.json> [-o <comparacion-nueva.json>]
70
+
71
+ Analiza en local fuentes de tareas explícitas y completas de Claude Code y Codex.
72
+ Repite las opciones de fuente para incluir sesiones de los dos agentes. No se
73
+ recorre la carpeta personal, ni se usa la red, ni se llama a un proveedor, ni se
74
+ instalan hooks, ni se ejecutan comandos. Hasta 16 fuentes y ${maxChars} caracteres
75
+ en total. No partas una sesión entre varias fuentes ni importes la misma sesión
76
+ más de una vez.
77
+ Los informes y las comparaciones son JSON por defecto (también se acepta --json).
78
+ El resultado y quien lo evalúa los declara quien llama; nunca se deducen del uso.
79
+ Aplicar la política añade un bloque gestionado, pequeño y opcional, al fichero que elijas.
80
+ Revisa el diff y haz tú una tarea comparable antes de comparar informes.
81
+ Revertir quita solo el bloque exacto y sin cambios. Cierra otros editores mientras
82
+ aplicas o reviertes. Los informes de salida que ya existen nunca se sobrescriben; los
83
+ ficheros nuevos se crean con 0600.
84
+ Los resultados de herramientas repetidos pueden ser intencionados. Una comparación
85
+ por pares es una observación, no prueba de un ahorro causal, de la calidad de la tarea
86
+ ni del margen de suscripción que queda.
87
+ `,
88
+ filterHelp: `Uso:
89
+ trazum filter compact --recovery-dir <directorio-privado> [--stats]
90
+ trazum filter restore <sha256> --recovery-dir <directorio-privado>
91
+ trazum filter instructions imprime una guía de salida opcional
92
+
93
+ Filtro de visualización experimental y opcional. Solo se compactan las líneas de
94
+ log repetidas seguidas. Los errores y las líneas únicas se conservan. No es para
95
+ ficheros de código ni para tuberías de datos.
96
+ Usa pipefail de Bash para conservar el fallo del comando que produce el log.
97
+ Los logs originales pueden contener datos sensibles: --recovery-dir acepta de forma
98
+ explícita guardarlos en local. Borra ese directorio cuando ya no necesites los originales.
99
+ Los recuentos de tokens son estimaciones, no medidas de facturación ni de cuota de suscripción.
100
+ --stats escribe un registro JSON en stderr, sin contenido del log ni rutas de recuperación.
101
+ `,
102
+ say: (message) => {
103
+ const fixed = TASK_FILTER_ES.get(message);
104
+ if (fixed !== undefined)
105
+ return fixed;
106
+ const missing = /^Missing --([a-z-]+)\. Run trazum task --help\.$/.exec(message);
107
+ if (missing)
108
+ return `Falta --${missing[1]}. Prueba con "trazum task --help".`;
109
+ const tooLong = /^Input exceeds (\d+) characters; use a smaller complete task source\.$/.exec(message);
110
+ if (tooLong)
111
+ return `La entrada supera los ${tooLong[1]} caracteres; usa una fuente de tarea completa más pequeña.`;
112
+ return message;
113
+ },
114
+ },
11
115
  help: (d, bold) => `${bold('trazum')}: lo que cuestan tus agentes de IA y tus llamadas a la API, leído de los logs de esta máquina.
12
116
 
13
117
  ${bold('EMPIEZA AQUÍ')}
@@ -28,7 +132,7 @@ ${bold('USO')}
28
132
  trazum verify <plan.json> --against <nuevo.jsonl|dir> [opciones]
29
133
  trazum profile <log.jsonl|dir> [opciones]
30
134
  trazum history <dir-de-informes-guardados> [opciones]
31
- trazum connect <provider> [opciones]
135
+ trazum connect <proveedor> [opciones]
32
136
  trazum store [--prune] [opciones]
33
137
  trazum watch [--once | --interval 15m] [--sessions] [--notify] [opciones]
34
138
  trazum serve [--port <n> | --socket <ruta>]
@@ -45,37 +149,41 @@ ${bold('USO')}
45
149
  trazum position <uso.jsonl>
46
150
  trazum receipt <uso.jsonl> [--stamp] [--since <cuándo>] [--until <cuándo>] [-o <fichero>]
47
151
  trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
48
- [--since <cuándo>] [--until <cuándo>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
152
+ [--since <cuándo>] [--until <cuándo>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out|--otlp-out|--prom-out <fichero>]
153
+ [--agent <nombre>] [--timezone <zona>] [--git-range <rango> [--delivery]]
49
154
  trazum weekly [<fichero|dir>...] [--until <cuándo>] [--label <nombre>] [--notify] [-o <fichero>]
50
155
  trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
51
156
  trazum from-codex <fichero|dir> [--label <nombre>] [-o <fichero>]
52
157
  trazum from-gemini-cli <fichero|dir> [--label <nombre>] [-o <fichero>]
53
158
  trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
54
159
  trazum from-litellm <fichero|dir> [-o <fichero>]
55
- trazum from-anthropic <usage.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
56
- trazum from-openai <usage.json> [--label <name>] [--label-by-project <file>] [-o <file>]
57
- trazum from-openrouter <activity.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
58
- trazum reconcile <receipt.json> --against <cost.json> [-o <file>]
160
+ trazum from-anthropic <usage.json> [--label <nombre>] [--label-by-workspace <fichero>] [-o <fichero>]
161
+ trazum from-openai <usage.json> [--label <nombre>] [--label-by-project <fichero>] [-o <fichero>]
162
+ trazum from-openrouter <activity.json> [--label <nombre>] [--label-by-workspace <fichero>] [-o <fichero>]
163
+ trazum reconcile <receipt.json> --against <cost.json> [-o <fichero>]
59
164
  trazum from-helicone <fichero|dir> [-o <fichero>]
60
165
  trazum from-langsmith <fichero|dir> [-o <fichero>]
61
166
  trazum switch <uso.jsonl> --to <modelo> [--migration-usd <n>] [--cases <n>]
62
167
  trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]
168
+ trazum model-pricing <managed-settings.json> --reviewed <AAAA-MM-DD> [-o <fichero>]
63
169
  trazum pulse [--max-stale-hours <n>]
64
- trazum proactive [status|on|off] [--only <item,...>] [--dry-run | --yes] [--json]
170
+ trazum proactive [status|on|off] [--only <elemento,...>] [--dry-run | --yes] [--json]
171
+ trazum session-guard [status|install|uninstall] --warn <usd> --stop <usd> --on-cannot-tell <fail-open|fail-closed> [--dry-run | --yes]
172
+ trazum waste <transcripcion.jsonl> [--min-reads <n>] [--claude-md <fichero>] [--mcp-servers <a,b>] [--json]
65
173
  trazum bench [--workload <id>] [--record <fichero>] [--against <fichero> --max-ratio <n>] [--json]
66
174
  trazum write [--answers <fichero>] [--json] [-o <fichero>]
67
175
  trazum models
68
176
  trazum rules [--measure <dir>] [--level <safe|aggressive>]
69
- trazum gateway <provider> --on-cannot-tell <fail-open|fail-closed>
70
- trazum experiment <log> --a <label> --b <label> --min-outcomes <n>
71
- trazum quality <log> --label <name> --at <iso> [--gate]
177
+ trazum gateway <proveedor> --on-cannot-tell <fail-open|fail-closed> [--metrics-port <n>]
178
+ trazum experiment <log> --a <etiqueta> --b <etiqueta> --min-outcomes <n>
179
+ trazum quality <log> --label <nombre> --at <iso> [--gate]
72
180
  trazum semantic <prompt> [--yes]
73
181
  trazum commitment <log> --floor <usd> --discount <pct> [--months 12]
74
- trazum report <log> --year <yyyy>
182
+ trazum report <log> --year <aaaa>
75
183
  trazum owners <log>
76
184
  trazum ladder <log>
77
185
  trazum feedback
78
- trazum filter compact|restore|instructions [--recovery-dir <directory>]
186
+ trazum filter compact|restore|instructions [--recovery-dir <directorio>]
79
187
  trazum task analyze|policy|apply|revert|compare [--help]
80
188
  trazum --version
81
189
 
@@ -210,12 +318,23 @@ ${bold('OPCIONES DE ownrate')}
210
318
  en trazum.config.json, de modo que el modelo que tú mismo sirves sea una
211
319
  fila de primera en cada informe, tasado por ti y marcado como tal.
212
320
 
321
+ ${bold('OPCIONES DE model-pricing')}
322
+ --reviewed <AAAA-MM-DD> Cuándo se comprobaron las tarifas contra el
323
+ contrato por última vez. Obligatorio.
324
+ -o, --out <fichero> Escribe el overlay ahí en vez de en stdout.
325
+
326
+ Las tarifas contratadas que tu organización dio a Claude Code en su ajuste
327
+ gestionado modelPricing, como overlay para --pricing, para que las cifras
328
+ de Trazum coincidan con las que muestra Claude Code. Lo que la tabla no
329
+ puede decir, lotes y modo rápido, conserva la cifra del catálogo y se
330
+ nombra por modelo.
331
+
213
332
  ${bold('OPCIONES DE reconcile')}
214
- --against <archivo> El informe de costes del proveedor: el
333
+ --against <fichero> El informe de costes del proveedor: el
215
334
  GET /v1/organizations/cost_report de Anthropic o
216
335
  el GET /v1/organization/costs de OpenAI, que se
217
336
  distinguen por su forma.
218
- -o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
337
+ -o, --out <fichero> Escribe la comparación ahí en vez de en stdout.
219
338
 
220
339
  Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
221
340
  dos tablas de precios en una sola cifra es como un informe se vuelve
@@ -230,7 +349,7 @@ ${bold('OPCIONES DE reconcile')}
230
349
  ${bold('OPCIONES DE from-anthropic')}
231
350
  --label <nombre> El proyecto al que pertenece este uso. El
232
351
  proveedor no conoce tus nombres de proyecto.
233
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
352
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
234
353
 
235
354
  El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
236
355
  credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
@@ -243,10 +362,10 @@ ${bold('OPCIONES DE from-anthropic')}
243
362
  ${bold('OPCIONES DE from-openai')}
244
363
  --label <nombre> El proyecto al que pertenece este uso. El
245
364
  proveedor no conoce tus nombres de proyecto.
246
- --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
365
+ --label-by-project <fichero> Una etiqueta por id de proyecto, como array JSON
247
366
  de {"project": "proj_…", "label": "nombre"}.
248
367
  Coincidencia exacta; --label es el respaldo.
249
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
368
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
250
369
 
251
370
  El informe de uso de OpenAI, leído como log, con el mismo arreglo que
252
371
  from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
@@ -270,8 +389,44 @@ ${bold('OPCIONES DE bill')}
270
389
  --by <day|week|month> Reparte el extracto por día UTC, semana ISO (de
271
390
  lunes a domingo) o mes. Sin él, una factura que
272
391
  abarca dos meses o más se reparte por mes.
392
+ --timezone <zona> Corta esos días, y un día suelto de --since/--until,
393
+ en esta zona IANA (Europe/Madrid) en vez de UTC. El
394
+ extracto dice cuál. No con --otlp-out,
395
+ --prom-out, --markdown-out, --html-out, --pdf-out ni un
396
+ --csv-shape distinto de slice: cortan los días en UTC.
397
+ --agent <nombre> Factura solo los registros de un agente de código:
398
+ claude-code, codex o gemini-cli. Un log suelto o una
399
+ exportación de proveedor no pertenece a ningún agente
400
+ y queda fuera, contado.
401
+ --git-range <rango> En vez de una factura, dice qué se registró en las
402
+ sesiones de Claude Code de este repositorio entre la
403
+ primera hora de autor y la última de commit del
404
+ rango (main..HEAD), ejecutado desde el repositorio.
405
+ Solo entran en la cifra las sesiones que empezaron y
406
+ terminaron dentro del periodo; las que cruzaron un
407
+ extremo se nombran y cuentan aparte. Es todo lo
408
+ gastado entonces en este repositorio, no el coste
409
+ del cambio. No con --since, --until, --label ni salida.
410
+ --delivery Con --git-range, dice además qué muestra git local que
411
+ llegó en el mismo rango (commits, pull requests con
412
+ número en un asunto, días con un commit) y divide la
413
+ cifra por cada uno. Solo recuentos: no se lee ningún
414
+ nombre, mensaje ni hash. Un promedio del periodo, no
415
+ lo que costó un commit o una pull request.
416
+ --otlp-out <fichero> Escribe además la factura como métricas OpenTelemetry
417
+ (JSON OTLP/HTTP): por día UTC cerrado, coste, tokens
418
+ y llamadas por proyecto, modelo y agente, y lo que no
419
+ se pudo cobrar como métrica aparte. Cada punto de coste
420
+ dice que es equivalente a API, no lo que pagó un plan.
421
+ Hoy, y un día que corta la ventana --since/--until, no
422
+ son puntos: el recurso dice cuáles y qué contenían.
423
+ Trazum escribe el fichero; tu pipeline lo envía.
424
+ --prom-out <fichero> Escribe además las mismas métricas en el formato de
425
+ texto de Prometheus, para el textfile collector del
426
+ node exporter: una serie por día UTC cerrado (su
427
+ etiqueta trazum_day), sin timestamps, sin enviar nada.
273
428
  --stamp Sella el recibo con la hora en que se escribió.
274
- -o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
429
+ -o, --out <fichero> Escribe el recibo ahí en vez de en stdout.
275
430
 
276
431
  Sin ruta, lee las carpetas de sesiones de cada agente que encuentra:
277
432
  Claude Code (~/.claude/projects), Codex ($CODEX_HOME/sessions y
@@ -300,7 +455,7 @@ ${bold('OPCIONES DE weekly')}
300
455
  una línea del resumen, la factura y su movimiento,
301
456
  con lo que tenga la plataforma (como watch
302
457
  --notify). Se dice, no es fatal, si no hay.
303
- -o, --out <archivo> Escribe el resumen ahí en vez de en stdout.
458
+ -o, --out <fichero> Escribe el resumen ahí en vez de en stdout.
304
459
 
305
460
  La semana en Markdown: la factura, qué se movió respecto a la semana
306
461
  anterior y los tres cambios que conviene hacer primero. Lee lo que lee
@@ -315,11 +470,11 @@ ${bold('OPCIONES DE weekly')}
315
470
 
316
471
  ${bold('OPCIONES DE from-openrouter')}
317
472
  --label <nombre> El proyecto al que pertenece este uso.
318
- --label-by-workspace <archivo> Una etiqueta por id de workspace, como array
473
+ --label-by-workspace <fichero> Una etiqueta por id de workspace, como array
319
474
  JSON de {"workspace": "…", "label": "nombre"}.
320
475
  Coincidencia exacta; --label es el respaldo.
321
476
  Requiere el informe pedido con group_by=workspace.
322
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
477
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
323
478
 
324
479
  El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
325
480
  gestión, los últimos treinta días), leído como log de uso con los mismos
@@ -426,7 +581,7 @@ ${bold('OPCIONES DE proactive')}
426
581
  tras un sí para ese elemento.
427
582
  off Quita exactamente las líneas que añadió. Nada más
428
583
  cambia en esos archivos.
429
- --only <item,...> Limita a statusline, watch o mcp.
584
+ --only <elemento,...> Limita a statusline, watch o mcp.
430
585
  --dry-run Imprime cada archivo y cada línea, no escribe nada.
431
586
  Es lo que hace hasta que alguien dice que sí: sin
432
587
  terminal y sin --yes es un simulacro.
@@ -464,6 +619,49 @@ ${bold('OPCIONES DE pulse')}
464
619
  contra la que ir tarde) ni por hasta dónde llegan las mediciones, que es un
465
620
  proveedor informando a su ritmo y no un trabajo que falló.
466
621
 
622
+ ${bold('OPCIONES DE session-guard')}
623
+ status Si el hook está en ~/.claude/settings.json, y con
624
+ qué cifras. Es lo predeterminado; no escribe nada.
625
+ install Añade el hook a los eventos UserPromptSubmit y
626
+ PreToolUse. Dice el archivo y cada línea antes, y
627
+ solo escribe tras un sí.
628
+ uninstall Quita exactamente el hook que añadió.
629
+ check Lo que ejecuta el hook: lee la transcripción de la
630
+ sesión, le pone precio con el catálogo incluido y
631
+ avisa una vez, detiene (código de salida 2) o
632
+ calla. No es para escribirlo a mano.
633
+ --warn <usd> Avisa una vez por sesión con este coste equivalente
634
+ en API.
635
+ --stop <usd> Detiene la sesión con este coste. Mayor que --warn.
636
+ --on-cannot-tell <política> fail-open o fail-closed: qué pasa cuando no se
637
+ puede saber el coste (sin transcripción, un modelo
638
+ sin precio). Nunca cuenta el coste como cero.
639
+ --dry-run, --yes Como en proactive.
640
+
641
+ No hay valor por defecto para los umbrales ni para la política: si falta uno,
642
+ el comando se niega y lo nombra. Toda cifra es coste equivalente en API, lo que
643
+ costaría el uso a los precios de lista de la API del proveedor, no lo que te
644
+ cobraron. Nada sale de esta máquina.
645
+
646
+ ${bold('OPCIONES DE waste')}
647
+ <transcripcion.jsonl> La transcripción de una sesión de Claude Code. Se
648
+ leen también las de sus subagentes, en la carpeta
649
+ de al lado.
650
+ --min-reads <n> Lista un fichero solo si se leyó al menos n veces
651
+ (2 o más; por defecto 3). Elige lo que se lista,
652
+ no lo que se cuenta.
653
+ --claude-md <fichero> El CLAUDE.md que medir. Sin él, el CLAUDE.md del
654
+ directorio donde corrió la sesión, si lo hay. Solo
655
+ se lee su tamaño en bytes, nunca su contenido.
656
+ --mcp-servers <a,b> Los servidores MCP que estaban cargados, cuando la
657
+ transcripción no lo dice. Solo nombres.
658
+
659
+ Nombra un coste y lo valora al catálogo incluido, con los recuentos de esta
660
+ sesión: un fichero leído otra vez, un servidor MCP cargado y nunca llamado, un
661
+ CLAUDE.md que se paga en cada turno. Recomienda y no edita ningún fichero. Un
662
+ coste que no se puede calcular con lo que registra la transcripción se nombra
663
+ y no se valora. Toda cifra es coste equivalente en API, no lo que te cobraron.
664
+
467
665
  ${bold('OPCIONES DE bench')}
468
666
  --workload <id> Ejecuta una sola carga estándar en vez de todas.
469
667
  Un id desconocido se rechaza nombrando los conocidos.
@@ -510,13 +708,13 @@ ${bold('OPCIONES DE rules')}
510
708
  ${bold('OPCIONES DE task')}
511
709
  --id <id> --type <tipo> Identifica una tarea y su tipo comparable.
512
710
  --criterion <texto> Declara el criterio de aceptación antes del cambio.
513
- --claude-code <archivo> Añade una sesión explícita de Claude Code; repetible.
514
- --codex <archivo> Añade una sesión explícita de Codex; repetible.
711
+ --claude-code <fichero> Añade una sesión explícita de Claude Code; repetible.
712
+ --codex <fichero> Añade una sesión explícita de Codex; repetible.
515
713
  --outcome <valor> accepted, rejected o unknown (por defecto unknown).
516
714
  --assessor <etiqueta> Obligatorio para un resultado accepted o rejected.
517
715
  --policy <id> baseline (por defecto) o repeat-review-v1.
518
- --instructions <archivo> Archivo local existente para apply o revert.
519
- -o, --out <archivo-nuevo> Crea un informe o política privados; no sobrescribe.
716
+ --instructions <fichero> Archivo local existente para apply o revert.
717
+ -o, --out <fichero-nuevo> Crea un informe o política privados; no sobrescribe.
520
718
  --json Los informes y comparaciones ya usan JSON por defecto.
521
719
  Consulta task --help para analyze, policy, apply, revert y compare.
522
720
  Máximo 400.000 caracteres entre fuentes. Nunca se infiere el éxito de la tarea.
@@ -544,6 +742,11 @@ ${bold('OPCIONES DE gateway')}
544
742
  juzgar una llamada: sin presupuesto, sin nada
545
743
  medido, un modelo sin precio.
546
744
  --port <n> | --socket <p> Dónde escuchar. Solo loopback, siempre.
745
+ --metrics-port <n> Sirve lo que la pasarela ha contado desde que
746
+ arrancó, en texto de Prometheus, en GET /metrics
747
+ de este segundo puerto loopback. Apagado si no se
748
+ da. Solo recuentos y coste a tarifa de lista,
749
+ nunca un prompt.
547
750
  --log <uso.jsonl> El log de uso contra el que se mide la política
548
751
  de limits, leído una vez al arrancar, el mismo
549
752
  flag que en serve, por la misma razón: el gasto
@@ -611,7 +814,7 @@ ${bold('OPCIONES DE commitment')}
611
814
  previsión.
612
815
 
613
816
  ${bold('OPCIONES DE report')}
614
- --year <yyyy> Obligatorio. Qué año montar.
817
+ --year <aaaa> Obligatorio. Qué año montar.
615
818
  --json El registro como datos.
616
819
 
617
820
  Todo sale del almacén y de los planes que ya guardas: no se calcula nada
@@ -716,7 +919,7 @@ ${bold('OPCIONES DE optimize')}
716
919
  el cambio, más los desajustes en ambos sentidos
717
920
  (prompts mapeados sin tráfico, tráfico sin
718
921
  prompt mapeado).
719
- --from-log <usage.jsonl> Mide las tres cifras de arriba desde un registro
922
+ --from-log <uso.jsonl> Mide las tres cifras de arriba desde un registro
720
923
  de uso en vez de teclearlas: llamadas reales,
721
924
  tamaño de salida real, cuota de caché real y el
722
925
  modelo al que fueron las llamadas. Rechaza los
@@ -785,6 +988,16 @@ ${bold('OPCIONES DE check')}
785
988
  comprobable pasa. Los presupuestos aplican por fichero como
786
989
  siempre; el baseline necesita el repositorio entero y se
787
990
  omite, diciéndolo.
991
+ --base <ref> Pone además precio a cada prompt cambiado en ese commit y
992
+ aquí: tokens, y su coste de entrada al mes con las
993
+ llamadas al mes que "volumes" indica para su label, o por
994
+ llamada si no indica ninguna. Cada cifra nombra su precio
995
+ y el día en que se leyó. El commit se lee de esta copia
996
+ con git y nunca se descarga; si no está, se dice.
997
+ --max-monthly-increase-usd <usd>
998
+ Con --base: falla si los prompts con volumen indicado
999
+ cuestan al mes más de estos dólares por encima de la
1000
+ base. Desactivado salvo que se pase.
788
1001
 
789
1002
  Pensado para CI: sale con código 1 si el prompt supera el presupuesto,
790
1003
  así una plantilla que crece sin control rompe la build en vez de la factura.
@@ -925,6 +1138,13 @@ ${bold('OPCIONES DE plan')}
925
1138
  --min-usd <n> Deja fuera las acciones que valen menos de n
926
1139
  dólares. Cuántas quedaron fuera se dice, nunca
927
1140
  en silencio.
1141
+ --edits Añade una edición a cada fichero de prompt que
1142
+ "labels" en trazum.config.json asigna a un
1143
+ label: el texto de las reglas safe, guardado por
1144
+ hash, sin escribirse. Solo ficheros que git
1145
+ sigue. No se proyecta ningún ahorro.
1146
+ --reorder Con --edits: mueve los bloques estables delante
1147
+ del primer marcador antes de recortar.
928
1148
  -o, --out <fichero> Guarda el plan como JSON fechado, el fichero al
929
1149
  que "trazum verify" lo atará después.
930
1150
  --markdown-out <fichero> Escribe además el plan como Markdown, para un
@@ -1177,6 +1397,9 @@ ${bold('FICHERO DE CONFIGURACIÓN')}
1177
1397
  labels { "support-rag": "prompts/soporte.txt" }: qué fichero de prompt
1178
1398
  manda cada label del registro de uso, para que "trazum profile"
1179
1399
  lea el fichero y diga por qué falla una caché que falla
1400
+ volumes { "support-rag": 30000 }: llamadas al mes de una label que
1401
+ "labels" asocia, para que "check --base" ponga precio a ese
1402
+ prompt por meses. Un prompt sin volumen va por llamada, y se dice
1180
1403
  spend { "maxUsd": 200, "byLabel": { "chat": 40 } }: presupuestos en
1181
1404
  dólares para "trazum profile". Una etiqueta con presupuesto y sin
1182
1405
  llamadas se informa como no medida, nunca como aprobada
@@ -1314,7 +1537,7 @@ ${bold('EJEMPLOS')}
1314
1537
  badMaxInput: (raw) => `--max-input debe ser un número positivo de caracteres (recibido: "${raw}").`,
1315
1538
  fractionFlag: (name, raw) => `--${name} es una fracción entre 0 y 1 (recibido: ${raw}). La configuración rechaza el mismo valor de la misma forma.`,
1316
1539
  badLevel: (received) => `--level debe ser "safe" o "aggressive" (recibido: "${received}").`,
1317
- allLabelsNeedsLog: () => '--all-labels ordena los prompts por tráfico medido, así que necesita --from-log <usage.jsonl>. Sin registro cada ahorro se multiplicaría por la misma suposición tecleada, lo que ordena los prompts por longitud y lo llama prioridad.',
1540
+ allLabelsNeedsLog: () => '--all-labels ordena los prompts por tráfico medido, así que necesita --from-log <uso.jsonl>. Sin registro cada ahorro se multiplicaría por la misma suposición tecleada, lo que ordena los prompts por longitud y lo llama prioridad.',
1318
1541
  allLabelsNeedsMap: () => '--all-labels lee el mapa "labels" de trazum.config.json (etiqueta a fichero de prompt) y esta config no tiene ninguno. Mapea al menos una carga a su prompt.',
1319
1542
  fromLogConflict: (flag) => `--from-log mide la cifra que --${flag} teclea, y mezclar una medición con una suposición produce un número que no es ninguna de las dos. Pasa una u otra.`,
1320
1543
  fromLogNeedsLabel: (available) => `--from-log necesita saber qué carga es este prompt: pasa --label, o mapea el fichero bajo "labels" en trazum.config.json. Etiquetas con tráfico en este registro: ${available}.`,
@@ -1423,8 +1646,8 @@ ${bold('EJEMPLOS')}
1423
1646
  tokensSaved: (tokens) => `${tokens} token${tokens === '1' ? '' : 's'} de vuelta, en cada llamada.`,
1424
1647
  windowNegligible: (tokens, model, window) => `${tokens} tokens de la ventana de ${window} de ${model}: menos de una décima de por ciento, así que la ventana no es lo que limita este prompt.`,
1425
1648
  windowUnmoved: (share, model, window) => `${share} de la ventana de ${window} de ${model}, antes y después: este cambio es demasiado pequeño para moverla.`,
1426
- beyondThisPromptTokensOnly: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. Si alguno de tus prompts va a una API de pago por uso, "trazum profile <usage.jsonl>" lee lo que el proveedor cobró de verdad y calcula las palancas que no son el prompt. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1427
- beyondThisPrompt: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 60% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <usage.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1649
+ beyondThisPromptTokensOnly: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. Si alguno de tus prompts va a una API de pago por uso, "trazum profile <uso.jsonl>" lee lo que el proveedor cobró de verdad y calcula las palancas que no son el prompt. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1650
+ beyondThisPrompt: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 60% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <uso.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1428
1651
  windowUse: (before, after, model, window) => `Ventana de contexto: ${before} → ${after} de los ${window} tokens de ${model}, sitio que se lleva la conversación.`,
1429
1652
  tokensOnlyAskedFor: () => 'Has nombrado un escenario y no se ha calculado su coste: Trazum se está ejecutando en un sitio que factura por suscripción, así que aquí no hay factura que reducir. Añade --cost para calcularlo igualmente: el host dice dónde se ejecuta Trazum, no a dónde va tu prompt.',
1430
1653
  tokensOnlyCost: () => 'Usa --cost si este prompt va a una API de pago por uso.',
@@ -1693,6 +1916,8 @@ ${bold('EJEMPLOS')}
1693
1916
  return `sin medir: el proveedor respondió sin uso alguno en el cuerpo: la llamada se hizo y su coste no es deducible de la respuesta, así que el total de abajo se queda corto (${sofar} sin medir hasta ahora)`;
1694
1917
  },
1695
1918
  pointYourSdk: (where) => `Apunta la URL base de tu SDK a ${where} y no cambies nada más. Habla el formato del propio proveedor, así que no hay cambios de código ni cliente nuevo.`,
1919
+ badMetricsPort: (given) => `--metrics-port es "${given}". Da un número entero de 0 a 65535: el puerto loopback del que lee Prometheus.`,
1920
+ metrics: (where) => `Recuentos para Prometheus en ${where}/metrics, desde que arrancó este proceso: llamadas, tokens, coste a tarifa de lista, rechazos y lo que no se pudo medir. No se envía nada y no lleva ningún prompt.`,
1696
1921
  credential: () => 'Tu credencial se reenvía intacta y nunca se lee, ni se guarda, ni se registra, ni se pone en una URL. Trazum no tiene ninguna clave aquí y no puede hacer una llamada propia a través de esto.',
1697
1922
  neverSubstitutes: () => 'Una llamada por encima del presupuesto se rechaza con HTTP 402 y las alternativas más baratas nombradas, nunca se cambia, recorta ni degrada en silencio. 402 y no 429 a propósito: todos los SDK de proveedor reintentan un 429, lo que convertiría un rechazo en una tormenta de reintentos.',
1698
1923
  standing: (consumed, limit) => `Juzgando contra ${consumed} de ${limit}, medido, leído una vez al arrancar: leer un fichero en el camino de la petición pondría la latencia de esta herramienta entre tú y tu proveedor en cada llamada.`,
@@ -1804,6 +2029,32 @@ ${bold('EJEMPLOS')}
1804
2029
  evalCostHint: () => 'Pasa --cases <n> para tasar la evaluación que el cambio exige.',
1805
2030
  quality: (routeCommand) => `Nada de lo de arriba dice si el candidato puede hacer el trabajo. Eso es una evaluación, no aritmética: ${routeCommand}`,
1806
2031
  },
2032
+ modelPricing: {
2033
+ noFile: () => 'Nombra el fichero de ajustes que contiene modelPricing: trazum model-pricing <managed-settings.json> --reviewed AAAA-MM-DD',
2034
+ noReviewed: () => '--reviewed AAAA-MM-DD es obligatorio: la fecha en que alguien comprobó estas tarifas contra el contrato por última vez. Un overlay de edad desconocida es peor que el catálogo incluido, cuya edad imprime cada informe.',
2035
+ notFound: (file) => `${file} no es un fichero.`,
2036
+ tooLarge: (file, bytes) => `${file} pasa de ${bytes} bytes, más de lo que cabe en un fichero de ajustes.`,
2037
+ notJson: (file, detail) => `${file} no es JSON: ${detail}`,
2038
+ skipped: (key, reason, detail) => {
2039
+ switch (reason) {
2040
+ case 'invalid':
2041
+ return `"${key}" queda fuera: ${detail}. Claude Code también la descarta y conserva el resto.`;
2042
+ case 'zero':
2043
+ return `"${key}" queda fuera: tiene una tarifa de cero, y Trazum no tasa nada a cero. Sus llamadas siguen a precio de lista aquí.`;
2044
+ case 'unknown-model':
2045
+ return `"${key}" no es un modelo que el catálogo conozca, así que no se tasa nada con él. Si es un id de proveedor o de pasarela de un modelo Claude, añade la fila de ese modelo con el id del catálogo.`;
2046
+ case 'duplicate':
2047
+ return `"${key}" queda fuera: es el mismo modelo que "${detail}", cuya fila se usa. Trazum no puede tasar un modelo de dos maneras.`;
2048
+ }
2049
+ },
2050
+ empty: () => 'Nada de la tabla llega a un modelo que Trazum tase, así que no se escribió ningún overlay.',
2051
+ summary: (fromRows, fromMultiplier, multiplier) => `${fromRows} modelo(s) a las tarifas de tu tabla${multiplier === undefined ? '' : `, por ${multiplier}`}` +
2052
+ (fromMultiplier > 0 ? `; ${fromMultiplier} modelo(s) Claude más a precio de lista por ${multiplier}.` : '.'),
2053
+ batch: (models) => `Lotes: la tabla no tiene tarifa de lotes, así que ${models} modelo(s) conservan el descuento de lotes del catálogo sobre la nueva tarifa de entrada.`,
2054
+ fastKept: (models) => `Modo rápido: un overlay no puede llevar una tarifa de modo rápido, así que estos conservan la publicada, sin tu tabla ni tu multiplicador: ${models}. Claude Code sí los aplica a los turnos rápidos.`,
2055
+ usOnly: (models) => `Inferencia solo en EE. UU.: sin recargo sobre una fila, como lo aplica Claude Code: ${models}.`,
2056
+ written: (file, models) => `Escrito un overlay de ${models} modelo(s) en ${file}. Úsalo con --pricing ${file}.`,
2057
+ },
1807
2058
  ownrate: {
1808
2059
  missing: () => 'Los dos números los declaras tú: trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]',
1809
2060
  invalid: (flag) => `--${flag} debe ser un número positivo (utilization: mayor que 0, como mucho 1).`,
@@ -1945,6 +2196,14 @@ ${bold('EJEMPLOS')}
1945
2196
  periodsUndated: (calls, usd, unit) => `${usd} de ${calls} llamada(s) sin marca de tiempo está en el total y en ${unit === 'day' ? 'ningún día' : unit === 'week' ? 'ninguna semana' : 'ningún mes'}.`,
1946
2197
  periodHint: (since, until, unit) => `${unit === 'day' ? 'Un día' : unit === 'week' ? 'Una semana' : 'Un mes'} por separado: --since ${since} --until ${until}.`,
1947
2198
  badBy: (value) => `--by admite day, week o month, no "${value}".`,
2199
+ badAgent: (value, known) => `--agent no conoce "${value}". Los agentes que nombra son ${known}.`,
2200
+ agentNoRecords: (name, known) => `--agent ${name} no encontró ningún registro de ese agente entre lo leído. Los agentes que nombra son ${known}; un log suelto o una exportación de proveedor no pertenece a ninguno.`,
2201
+ agentOnly: (name, kept, leftOut) => `--agent: solo se factura ${kept} registro(s) de ${name}; ${leftOut} registro(s) de otros agentes u orígenes quedan fuera.`,
2202
+ badTimezone: (value) => `--timezone no conoce "${value}". Indica una zona horaria IANA como Europe/Madrid o America/New_York.`,
2203
+ timezoneConflict: (flag) => `--timezone corta los días del extracto en esa zona y ${flag} corta los suyos en UTC, así que los dos imprimirían días que no coinciden. Quita uno de los dos.`,
2204
+ zoneLine: (zone) => `Los días se cortan en ${zone}, no en UTC: un día suelto de --since/--until es un día de esa zona, y también cada fila de arriba.`,
2205
+ periodHintZone: (zone) => `Añade --timezone ${zone} para facturarlo con los mismos días.`,
2206
+ zoneReceiptNote: (zone) => `--timezone ${zone}: el recibo guarda instantes y ningún día, así que la zona solo decide qué significa un día suelto de --since/--until.`,
1948
2207
  colCalls: () => 'llamadas',
1949
2208
  colShare: () => 'parte',
1950
2209
  moreRows: (count) => `… y ${count} más`,
@@ -1963,11 +2222,45 @@ ${bold('EJEMPLOS')}
1963
2222
  costReport: (path) => `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
1964
2223
  nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
1965
2224
  sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
2225
+ sendNeedsReceipt: () => '--send envía el recibo, así que necesita --receipt: bill --receipt --send <url>. No se envía nada más.',
2226
+ badSendTarget: (reason, keyVariable) => reason === 'credentials-in-url'
2227
+ ? '--send: esa URL lleva credenciales. Las URL acaban en registros, en el historial del shell y en mensajes de error, así que se rechaza. La clave va en la variable de entorno ' + keyVariable + ', y se envía como cabecera bearer.'
2228
+ : reason === 'insecure-scheme'
2229
+ ? '--send: la URL debe ser https, salvo en loopback. Un recibo lleva tus cifras de gasto, y enviarlas en claro por una red es una fuga que no pediste.'
2230
+ : reason === 'bad-key'
2231
+ ? `--send: ${keyVariable} contiene espacios, caracteres de control o bytes no ASCII, que no pueden enviarse como token bearer. Su valor no se muestra.`
2232
+ : '--send: eso no es una URL que esta herramienta pueda interpretar.',
2233
+ sendDelivered: (where, status) => `Recibo enviado a ${where} (HTTP ${status}). No se envió nada más.`,
2234
+ sendFailed: (where, status) => status === null
2235
+ ? `El recibo no llegó a ${where}. Queda escrito aquí como siempre; esta ejecución sale con 3 porque el envío falló. El error va debajo, sin las cabeceras de la petición.`
2236
+ : `${where} respondió HTTP ${status}, así que el recibo no se entregó. Queda escrito aquí como siempre; esta ejecución sale con 3 porque el envío falló. El cuerpo de la respuesta va debajo, sin las cabeceras de la petición.`,
1966
2237
  pricingLiveHint: (count) => `${count} id(s) de modelo sin precio llevan prefijo de proveedor, como nombran los modelos OpenRouter y LiteLLM, y el catálogo incluido no los trae. Vuelve a ejecutar con --pricing-live para cobrar los slugs de OpenRouter desde su propia lista.`,
1967
2238
  apiEquivalent: () => 'Las sesiones de agentes (Claude Code, Codex, Gemini CLI) se valoran a tarifas API del catálogo. Si pagas una suscripción, pagaste el plan, no esta estimación equivalente; los datos ausentes y las tarifas propias pueden cambiar el resultado.',
2239
+ partnerUnpriced: (ids) => `Modelos Claude como los nombran Amazon Bedrock o Vertex AI: ${ids}. Esas plataformas fijan sus propios precios, que este catálogo no lleva, así que las llamadas quedan sin tasar en vez de cobrarse a las tarifas de Anthropic. Para tasarlas, da a cada id su propia fila en un overlay --pricing con las tarifas de la página de la plataforma.`,
2240
+ partnerModel: (platform, model) => `${platform === 'bedrock' ? 'Amazon Bedrock' : 'Vertex AI'}, ${model ?? 'un modelo que este catálogo no conoce'}`,
1968
2241
  prefixedKnown: (ids) => `${ids}: el modelo tras la barra tiene precio aquí con su propio nombre. El prefijo no se quita por ti, porque el mismo modelo a través de un router puede facturarse distinto. Si esas llamadas fueron directas al proveedor, registra el modelo sin el prefijo.`,
1969
2242
  windowMatchesNothing: (from, to) => `Ninguna llamada cae dentro de este periodo. Lo leído cubre ${from} → ${to}. Un periodo sin nada dentro no es una factura de $0: revisa las fechas, o quita --since/--until para facturarlo todo.`,
1970
2243
  written: (file) => `Escrito ${file}.`,
2244
+ rangeConflict: (flag) => `--git-range fija el periodo por sí mismo, a partir de los commits, e imprime su propio extracto: no se puede combinar con ${flag}.`,
2245
+ rangeNoGit: () => 'no se pudo ejecutar git, del que --git-range lee las horas de los commits.',
2246
+ rangeNoRepository: () => 'Este directorio no está dentro de un repositorio git, así que --git-range no tiene repositorio que leer.',
2247
+ rangeBad: (range) => `git no conoce el rango "${range}". Indica uno como main..HEAD.`,
2248
+ rangeEmpty: (range) => `El rango "${range}" no contiene ningún commit, así que no tiene periodo que sumar.`,
2249
+ rangeHeading: (range) => `Registrado en las sesiones de este repositorio mientras se escribía ${range}`,
2250
+ rangeWindow: (from, to, commits) => `Periodo: ${from} a ${to}, según las horas de autor y de commit de ${commits} commit(s).`,
2251
+ rangeInside: (usd, calls, sessions) => `${usd} en ${calls.toLocaleString('es-ES')} llamada(s) valorada(s) de ${sessions.toLocaleString('es-ES')} sesión(es) que empezaron y terminaron dentro del periodo.`,
2252
+ rangeNothingInside: () => 'Ninguna sesión de este proyecto empezó y terminó dentro del periodo.',
2253
+ rangeStraddleHeading: (count) => `${count} sesión(es) empezaron antes del periodo o siguieron después. Contadas aparte, no en la cifra de arriba:`,
2254
+ rangeStraddleRow: (session, from, to, insideUsd, insideCalls, outsideUsd, outsideCalls) => ` ${session} ${from} a ${to}: ${insideUsd} (${insideCalls} llamada(s)) dentro del periodo, ${outsideUsd} (${outsideCalls} llamada(s)) fuera.`,
2255
+ rangeNoStraddle: () => 'Ninguna sesión cruzó un extremo del periodo.',
2256
+ rangeMeaning: () => 'Esto es todo lo registrado en este repositorio durante ese periodo. No es el coste del cambio: incluye otro trabajo del mismo repositorio, y no incluye el trabajo del cambio hecho en otro sitio.',
2257
+ rangeLeftOut: (outsideCalls, otherProjects, otherSources, undated) => `Fuera: ${outsideCalls} llamada(s) de sesiones por completo fuera del periodo, ${otherProjects} registro(s) de otros proyectos, ${otherSources} registro(s) de fuentes sin carpeta de proyecto que comparar (Codex, Gemini CLI, logs), ${undated} llamada(s) sin marca de tiempo.`,
2258
+ rangeUnpriced: (calls) => `No está en la cifra: ${calls} llamada(s) a modelos que el catálogo no valora. Nombradas, nunca contadas como $0.`,
2259
+ deliveryNeedsRange: () => '--delivery pone el gasto de un rango de commits junto a lo que git muestra que llegó en él, así que necesita --git-range.',
2260
+ rangeDelivered: (commits, merges, pullRequests, days) => `Llegó en el mismo rango, según git local: ${commits.toLocaleString('es-ES')} commit(s), ${merges.toLocaleString('es-ES')} de ellos commits de fusión; ${pullRequests.toLocaleString('es-ES')} pull request(s) con número en un asunto; ${days.toLocaleString('es-ES')} día(s) UTC con un commit. Una pull request fusionada con rebase no lleva número, así que esa cuenta puede quedarse corta.`,
2261
+ rangeDividedBy: (perCommit, perPullRequest, perDay) => `La cifra de arriba dividida por cada cuenta: ${perCommit ?? 'sin cifra'} por commit, ${perPullRequest ?? 'sin cifra (no se nombra ninguna pull request)'} por pull request, ${perDay ?? 'sin cifra'} por día. Dos números sobre un mismo periodo, no lo que costó un commit, una pull request o un día.`,
2262
+ rangeDividedNothing: () => 'Ninguna sesión empezó y terminó dentro del periodo, así que no hay cifra que dividir por estas cuentas.',
2263
+ rangeNoProject: () => 'Ninguna sesión leída pertenece a la carpeta de proyecto de este repositorio. Claude Code nombra esa carpeta con la ruta absoluta del repositorio, así que lee la carpeta que la contiene (trazum bill ~/.claude/projects --git-range main..HEAD) desde la raíz del repositorio. Una sesión iniciada en un subdirectorio o en un worktree está en una carpeta de otro nombre y no se reconoce.',
1971
2264
  },
1972
2265
  fromOpenrouter: {
1973
2266
  noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturación',
@@ -2176,6 +2469,75 @@ ${bold('EJEMPLOS')}
2176
2469
  backupNote: (suffix) => `La primera vez que cambia un archivo tuyo, se guarda una copia al lado como <nombre>${suffix}. Nunca se reemplaza.`,
2177
2470
  crontab: () => 'tu crontab',
2178
2471
  },
2472
+ sessionGuard: {
2473
+ unknownAction: (given) => `Acción desconocida "${given}". Usa: trazum session-guard [status|install|uninstall].`,
2474
+ refusedMissing: (flags) => `Falta: ${flags}. No hay valor por defecto para los dos umbrales en dólares ni para lo que se hace cuando no se puede saber el coste: cada uno es decisión tuya, y una guarda que eligiera uno lo habría decidido por ti. Ejemplo: trazum session-guard install --warn 5 --stop 15 --on-cannot-tell fail-open`,
2475
+ refusedAmount: (flag, given) => `${flag} necesita un importe en dólares mayor que cero, y "${given}" no lo es.`,
2476
+ refusedPolicy: (given, allowed) => `--on-cannot-tell es "${given}". Tiene que ser uno de: ${allowed}. fail-open deja seguir el trabajo cuando no se puede saber el coste, y fail-closed lo detiene.`,
2477
+ refusedWarnNotBelowStop: () => '--warn tiene que ser menor que --stop, o el aviso nunca se vería antes de la parada.',
2478
+ refusedFlag: (flag) => `${flag} no se acepta aquí. La guarda pone precio a la sesión con el catálogo incluido en esta versión y solo lee archivos que ya están en esta máquina.`,
2479
+ warn: (usd, warnUsd, stopUsd, atLeast) => `Trazum: esta sesión ha llegado a ${atLeast ? 'al menos ' : ''}${usd} de coste equivalente en API. Tu cifra de aviso es ${warnUsd} y se detiene en ${stopUsd}. Equivalente en API es lo que costaría este uso a los precios de lista de la API del proveedor, no lo que te cobraron.${atLeast ? ' Algunas llamadas son de un modelo para el que Trazum no tiene precio, así que la cifra real es mayor.' : ''} Esto se dice una vez por sesión.`,
2480
+ block: (usd, stopUsd, atLeast) => `Trazum: detenida. Esta sesión ha llegado a ${atLeast ? 'al menos ' : ''}${usd} de coste equivalente en API, igual o por encima de tu cifra de parada de ${stopUsd}. Equivalente en API es lo que costaría este uso a los precios de lista de la API del proveedor, no lo que te cobraron. Para seguir, sube la cifra: trazum session-guard install --warn <usd> --stop <usd> --on-cannot-tell <fail-open|fail-closed>.`,
2481
+ cannotTellOpen: (why) => `Trazum no pudo saber cuánto cuesta esta sesión: ${why}. Tu política es fail-open, así que el trabajo sigue y esta guarda no detiene nada. No contó el coste como cero. Esto se dice una vez por sesión.`,
2482
+ cannotTellClosed: (why) => `Trazum: detenida, porque no pudo saber cuánto cuesta esta sesión: ${why}. Tu política es fail-closed. No contó el coste como cero. Para seguir, arregla la causa o cambia la política con trazum session-guard install.`,
2483
+ cause: {
2484
+ 'no-transcript': () => 'Claude Code no dio ninguna transcripción que leer',
2485
+ unreadable: () => 'no se pudo leer la transcripción',
2486
+ unparseable: () => 'la transcripción tiene líneas y ninguna se pudo leer como uso',
2487
+ skipped: () => 'una parte de la transcripción no se pudo leer como registro de uso',
2488
+ },
2489
+ unpriced: (models) => `el catálogo no tiene precio para ${models}`,
2490
+ settingsShape: (file, key) => `${file} tiene un "${key}" que no tiene la forma que lee Claude Code, así que se deja como está.`,
2491
+ wouldInstall: () => 'guarda de sesión: escribiría',
2492
+ wouldUninstall: () => 'guarda de sesión: quitaría',
2493
+ askInstall: (file) => `¿Escribir el hook de la guarda de sesión (${file})? [s/N] `,
2494
+ askUninstall: (file) => `¿Quitar el hook de la guarda de sesión (${file})? [s/N] `,
2495
+ didInstall: (file) => `guarda de sesión: escrito en ${file}`,
2496
+ didUninstall: (file) => `guarda de sesión: quitado de ${file}`,
2497
+ declined: () => 'guarda de sesión: no se escribió, dijiste que no.',
2498
+ nothingToUninstall: () => 'guarda de sesión: nada que quitar.',
2499
+ alreadyInstalled: (file) => `guarda de sesión: ya está como pediste en ${file}, nada que cambiar.`,
2500
+ dryRun: () => 'Simulacro: no se escribió nada.',
2501
+ dryRunNoTerminal: () => 'Esto no es una terminal y no se pasó --yes, así que es un simulacro: no se escribió nada. Ejecútalo en una terminal para que te pregunte, o pasa --yes.',
2502
+ failed: (reason) => `guarda de sesión: no se escribió. ${reason}`,
2503
+ statusOn: (file, warnUsd, stopUsd, policy) => `activa en ${file}: avisa en ${warnUsd}, detiene en ${stopUsd} de coste equivalente en API, y cuando no se puede saber el coste es ${policy}.`,
2504
+ statusOff: (file) => `desactivada: no hay hook de la guarda de sesión en ${file}.`,
2505
+ statusPartial: (file) => `activa a medias: ${file} tiene el hook en uno de los dos eventos y no en el otro. Ejecuta install otra vez para completarla.`,
2506
+ apiEquivalent: () => 'Toda cifra es coste equivalente en API: el uso a los precios de lista de la API del proveedor, no lo que te cobraron.',
2507
+ windows: () => 'El hook de la guarda de sesión se escribe como comando de shell y no está disponible en Windows.',
2508
+ noClaude: (dir) => `${dir} no existe, así que Claude Code no parece instalado para este usuario. No se escribió nada.`,
2509
+ },
2510
+ waste: {
2511
+ refusedFlag: (flag) => `${flag} no se acepta aquí. waste valora al catálogo incluido en esta versión y lee solo ficheros que ya están en esta máquina.`,
2512
+ noPath: () => 'Indica la transcripción de la sesión que leer. Ejemplo: trazum waste <sesion>.jsonl',
2513
+ notFound: (path) => `${path} no es un fichero.`,
2514
+ unreadable: (path) => `No se pudo leer ${path}, o una transcripción de sus subagentes.`,
2515
+ minReadsBad: (given) => `--min-reads necesita un número entero de 2 o más, y "${given}" no lo es: un fichero leído una vez no se ha leído otra vez.`,
2516
+ cannotTell: () => 'No se puede saber: la transcripción no se pudo emparejar línea a línea con su uso, y emparejar una llamada a herramienta con el prompt equivocado valoraría lo que no es. No se calculó nada. Ejecuta trazum from-claude-code sobre ella para ver cómo se lee.',
2517
+ heading: (calls, threads) => `Desperdicio en esta sesión: ${plural(calls, 'llamada')} en ${plural(threads, 'hilo')}`,
2518
+ apiEquivalent: (reviewed) => `Toda cifra es coste equivalente en API al catálogo incluido, revisado por última vez el ${reviewed}: no lo que te cobraron. Un ahorro es una cota inferior calculada con los recuentos de esta sesión.`,
2519
+ unpriced: (models) => `El catálogo no tiene precio para ${models}: esas llamadas quedan fuera de toda cifra, así que cada una es un mínimo.`,
2520
+ readsHeading: () => 'El mismo fichero leído otra vez',
2521
+ readsNone: (minReads) => `Ningún fichero se leyó ${minReads} o más veces sin que nada lo cambiara entre medias.`,
2522
+ readLine: (reads, repeats, measured, tokens, usd) => `leído ${reads} veces, ${plural(repeats, 'repetición', 'repeticiones')} del mismo tramo sin edición entre medias. ${usd === null
2523
+ ? 'Sin valorar: las llamadas que lo repitieron hicieron también otras llamadas a herramientas, así que el crecimiento no se puede repartir.'
2524
+ : `${measured} medidas, ${tokens.toLocaleString('es-ES')} tokens añadidos al contexto y arrastrados en cada llamada posterior: ${usd}.`}`,
2525
+ readsOmitted: (count) => `${plural(count, 'fichero más', 'ficheros más')} leído${count === 1 ? '' : 's'} otra vez y sin listar (por debajo de --min-reads, o pasadas las 20 listadas).`,
2526
+ readsTotal: (usd, measured, repeats) => `En conjunto: ${usd} por las ${measured} de ${repeats} repeticiones que se pudieron medir.`,
2527
+ readsUnmeasured: (repeats) => `${plural(repeats, 'repetición', 'repeticiones')} encontradas y ninguna se pudo valorar con los recuentos.`,
2528
+ mcpHeading: () => 'Servidores MCP cargados y nunca llamados',
2529
+ mcpNoList: () => 'No se puede saber qué servidores estaban cargados: esta transcripción no registra una lista. Nómbralos con --mcp-servers <a,b> y dirá cuáles no se llamaron nunca.',
2530
+ mcpAllCalled: (loaded) => `${plural(loaded, 'servidor', 'servidores')} cargado${loaded === 1 ? '' : 's'}, y todos se llamaron al menos una vez.`,
2531
+ mcpSummary: (loaded, called, source) => `${plural(loaded, 'servidor', 'servidores')} cargado${loaded === 1 ? '' : 's'}${source === 'flag' ? ' (como los nombraste)' : ''}, ${called} llamado${called === 1 ? '' : 's'}.`,
2532
+ mcpUnused: (server, tools) => `${server}: nunca llamado${tools === null ? '' : `, ${plural(tools, 'herramienta')} cargada${tools === 1 ? '' : 's'}`}`,
2533
+ mcpNotPriced: () => 'Sin valorar: lo que cuestan las definiciones de herramientas de un servidor no está en la transcripción, y donde las herramientas se difieren sus definiciones no se envían hasta que se piden. Una cifra aquí sería inventada.',
2534
+ claudeHeading: () => 'Un CLAUDE.md que se paga en cada turno',
2535
+ claudeNone: (path) => path === ''
2536
+ ? 'No hay CLAUDE.md que medir: la transcripción no nombra ningún directorio. Pasa --claude-md <fichero>.'
2537
+ : `No hay CLAUDE.md en ${path}. Pasa --claude-md <fichero> para medir otro.`,
2538
+ claudeLine: (bytes, tokens, calls, usd, low, high, bandPct) => `${plural(bytes, 'byte')}, unos ${tokens.toLocaleString('es-ES')} tokens, en ${plural(calls, 'llamada')} del hilo principal: ${usd} (${low} a ${high}). Estimado: la transcripción no registra su tamaño, así que los tokens son los bytes entre el divisor del estimador, dentro de su banda publicada de ${bandPct}%. Solo se leyó el tamaño del fichero.`,
2539
+ nothingChanged: () => 'No se cambió nada. Este comando recomienda y no edita ningún fichero.',
2540
+ },
2179
2541
  pulse: {
2180
2542
  heading: () => '¿Corrieron las cosas que tienen que correr?',
2181
2543
  kind: (kind) => {
@@ -2515,6 +2877,37 @@ ${bold('EJEMPLOS')}
2515
2877
  filesFromNoBaseline: () => 'La puerta de baseline se omite con --files-from: compara el repositorio entero contra el registro comprometido, y una lista parcial se leería como eliminaciones. Los presupuestos se comprueban por fichero como siempre; ejecuta «trazum check .» para el baseline.',
2516
2878
  exactCountsCost: (files) => `Contando ${files} ${files === 1 ? 'fichero' : 'ficheros'} con la API, una llamada por cada uno. Esto tarda un momento.`,
2517
2879
  },
2880
+ againstBase: {
2881
+ heading: (ref, sha) => `Frente a la base, ${ref} en ${sha}`,
2882
+ columnTokens: () => 'Tokens, base → cabeza',
2883
+ columnCalls: () => 'Llamadas al mes',
2884
+ columnBase: () => 'Base',
2885
+ columnHead: () => 'Cabeza',
2886
+ columnPrice: () => 'Precio',
2887
+ notStated: () => 'sin indicar',
2888
+ perMonth: (usd) => `${usd} al mes`,
2889
+ perCall: (usd) => `${usd} por llamada`,
2890
+ price: (perMTok, model, provider, readOn) => `${perMTok} por millón de tokens de entrada, ${model}, precios de ${provider} leídos el ${readOn}`,
2891
+ priceOverlay: (perMTok, model, readOn) => `${perMTok} por millón de tokens de entrada, ${model}, capa local de precios fechada el ${readOn}`,
2892
+ promo: (until) => `precio promocional hasta el ${until}`,
2893
+ totals: (base, head, change) => `Los prompts con volumen indicado: ${base} al mes en la base, ${head} en la cabeza (${change}).`,
2894
+ perCallNote: (count) => `${count} ${count === 1 ? 'prompt cambiado no tiene' : 'prompts cambiados no tienen'} volumen indicado, así que su coste es solo por llamada. Para ponerle precio a un mes, asocia el fichero del prompt en "labels" e indica sus llamadas al mes en "volumes" de trazum.config.json.`,
2895
+ inputOnly: () => 'Tokens de entrada al precio de entrada, los dos lados a los mismos precios. La salida queda fuera: editar un prompt no fija cuánto escribe el modelo.',
2896
+ modelDefault: (model) => `Con el modelo por defecto de Trazum, ${model}, porque la config no fija usage.model. Fíjalo para poner precio al modelo al que se envían los prompts.`,
2897
+ unchanged: (count) => `${count} ${count === 1 ? 'prompt es igual' : 'prompts son iguales'} en los dos lados.`,
2898
+ nothingChanged: () => 'Ningún prompt de aquí cambió frente a la base.',
2899
+ gateWithin: (change, limit) => `El aumento mensual, ${change}, está dentro del límite de ${limit}.`,
2900
+ gateBreached: (change, limit) => `El aumento mensual, ${change}, supera el límite de ${limit}.`,
2901
+ gateNotJudged: (count) => `El límite juzga solo los prompts con volumen indicado: ${count} ${count === 1 ? 'prompt cambiado no se juzgó' : 'prompts cambiados no se juzgaron'}.`,
2902
+ unavailable: (why, ref) => why === 'no-commit'
2903
+ ? `La base, ${ref}, no está en esta copia, así que no se comparó nada. No se descarga nada para buscarla. En GitHub Actions, pon fetch-depth: 0 en actions/checkout.`
2904
+ : why === 'not-a-repository'
2905
+ ? `Esto no es un repositorio git, así que no hay base con la que comparar ${ref}.`
2906
+ : `No se pudo ejecutar git, así que la base, ${ref}, no se leyó.`,
2907
+ gateUnavailable: (limit) => `El límite de aumento mensual de ${limit} no juzgó nada, porque la base no se pudo leer, y una puerta que no juzga nada falla.`,
2908
+ gateNeedsBase: () => '--max-monthly-increase-usd limita lo que un cambio añade al coste mensual frente a una base, así que necesita --base <ref>.',
2909
+ noStdin: () => '--base lee de git el lado base de un fichero, y la entrada estándar no tiene lado base. Nombra el fichero.',
2910
+ },
2518
2911
  profile: {
2519
2912
  noTarget: () => 'Apúntalo a un log de uso: trazum profile usage.jsonl: un objeto JSON por línea, cada uno con un "model" y el objeto "usage" que devolvió la API. Añade "label" (qué carga), "session" (qué conversación) y "ts" (cuándo) ya que estás: sin ellos todas las llamadas parecen iguales, y los hallazgos más grandes de este comando (el crecimiento de conversación, y si el TTL de la caché encaja con el ritmo de tus turnos) no se pueden hacer siquiera. Registrarlo son cuatro líneas en tu propio código, nunca contiene el texto del prompt, y la clave de sesión se agrupa y nunca se imprime.',
2520
2913
  heading: () => 'Adónde fue el dinero',
@@ -2790,7 +3183,9 @@ ${bold('EJEMPLOS')}
2790
3183
  ? 'Enruta y agrupa'
2791
3184
  : kind === 'fix-truncation'
2792
3185
  ? 'Arregla los reintentos por truncado de'
2793
- : 'Mira la caché de';
3186
+ : kind === 'edit-file'
3187
+ ? 'Edita el fichero de prompt de'
3188
+ : 'Mira la caché de';
2794
3189
  return `${verb} ${label} (${model})`;
2795
3190
  },
2796
3191
  routeTo: (model, withBatch) => withBatch ? `a ${model}, combinado con el batch donde aplican los dos, nunca sumado` : `a ${model}`,
@@ -2806,6 +3201,8 @@ ${bold('EJEMPLOS')}
2806
3201
  return 'supone que un max_tokens en el que quepan las respuestas elimina el par';
2807
3202
  case 'traffic-pattern-holds':
2808
3203
  return 'supone que el patrón de tráfico se mantiene: una caché que perdió dinero en este registro puede rendir con otro tráfico';
3204
+ case 'file-is-what-label-sends':
3205
+ return `supone que ${assumption.path} es lo que envía esta carga: trazum.config.json lo dice, el registro guarda tokens, no ficheros`;
2809
3206
  }
2810
3207
  },
2811
3208
  check: (command) => `compruébalo: ${command}`,
@@ -2813,6 +3210,20 @@ ${bold('EJEMPLOS')}
2813
3210
  batchExcluded: (usd) => `No se proyecta ahorro por batch sobre ${usd} de entrada y salida: esas llamadas ya pasaron por la Batch API, o algo esperaba su respuesta (marcadas como interactivas, como lo es cada turno de un agente de código).`,
2814
3211
  footer: () => 'Ordenado por dinero, proyectado o ya gastado por igual. Los supuestos los respondes tú: este plan es aritmética sobre el registro, no conocimiento de tu producto.',
2815
3212
  wrote: (path) => `Plan escrito en ${path}, con fecha. Guárdalo: una predicción que nadie apuntó es una predicción que no se le puede exigir a nadie.`,
3213
+ editsNeedLabels: () => '--edits lee el fichero de prompt que envía cada label, y trazum.config.json no asigna ninguno: añade "labels", por ejemplo {"labels": {"soporte": "prompts/soporte.txt"}}.',
3214
+ reorderNeedsEdits: () => '--reorder es un paso de una edición: añade --edits.',
3215
+ editMeasured: (usd, calls, inputPerCall) => `se espera contra ${usd} en ${calls} llamadas a ${inputPerCall} tokens de entrada por llamada, medido`,
3216
+ editChange: (path, reordered, tokensBefore, tokensAfter) => `${path}: ${reordered ? 'bloques estables movidos delante del primer marcador, y luego recortado' : 'recortado'} por las reglas safe, ${tokensBefore} → ${tokensAfter} tokens según el estimador, estimado, no medido; no se proyecta ningún ahorro`,
3217
+ editCheck: () => 'trazum verify lee el fichero, que debe tener el texto que este plan prometió, y el registro más nuevo, donde la entrada por llamada debe bajar de la cifra de arriba',
3218
+ editSkipped: (why, label, path) => why === 'no-traffic'
3219
+ ? `Sin edición para ${label} (${path}): el registro no tiene ninguna llamada tasada con ese label, así que no hay cifra medida contra la que esperarla.`
3220
+ : why === 'unreadable'
3221
+ ? `Sin edición para ${label}: no se pudo leer ${path}.`
3222
+ : why === 'not-tracked'
3223
+ ? `Sin edición para ${label}: git no sigue ${path}, y una edición se propone al repositorio.`
3224
+ : why === 'source-file'
3225
+ ? `Sin edición para ${label}: ${path} es código fuente, y una edición reescribe el fichero entero.`
3226
+ : `Sin edición para ${label}: las reglas safe dejan ${path} como está.`,
2816
3227
  },
2817
3228
  serve: {
2818
3229
  listening: (where) => `Respondiendo en ${where}`,
@@ -2934,7 +3345,9 @@ ${bold('EJEMPLOS')}
2934
3345
  ? `Enrutar y agrupar ${label} (${model})`
2935
3346
  : kind === 'fix-truncation'
2936
3347
  ? `Arreglar los reintentos por truncado de ${label} (${model})`
2937
- : `Arreglar la caché de ${label} (${model})`;
3348
+ : kind === 'edit-file'
3349
+ ? `Editar el fichero de prompt de ${label} (${model})`
3350
+ : `Arreglar la caché de ${label} (${model})`;
2938
3351
  const span = first !== null && last !== null ? ` (${first} → ${last})` : '';
2939
3352
  return `${what} se ha planificado ${appearances} veces${span} y sigue en el plan más reciente: una decisión que nadie está revisando.`;
2940
3353
  },
@@ -2992,7 +3405,9 @@ ${bold('EJEMPLOS')}
2992
3405
  ? `Enrutar y agrupar ${label} (${model})`
2993
3406
  : kind === 'fix-truncation'
2994
3407
  ? `Arreglar los reintentos por truncado de ${label} (${model})`
2995
- : `Arreglar la caché de ${label} (${model})`;
3408
+ : kind === 'edit-file'
3409
+ ? `Editar el fichero de prompt de ${label} (${model})`
3410
+ : `Arreglar la caché de ${label} (${model})`;
2996
3411
  const verdict = outcome === 'arrived' ? 'LLEGÓ' : outcome === 'not-arrived' ? 'NO LLEGÓ' : 'NO SE PUEDE SABER';
2997
3412
  return `${what}: ${verdict}`;
2998
3413
  },
@@ -3000,13 +3415,19 @@ ${bold('EJEMPLOS')}
3000
3415
  ? 'el label no lleva tráfico tasado en este registro: una carga desaparecida no está arreglada, y tampoco rota'
3001
3416
  : reason === 'fields-stopped'
3002
3417
  ? 'los campos que la detección necesita no están en este registro: "no registrado" no puede leerse como "arreglado", así que con --gate esto suspende'
3003
- : 'el registro guarda tokens, y los tokens no dicen con qué tarifa se facturaron: el Batch API no se puede ver desde aquí',
3418
+ : reason === 'file-not-read'
3419
+ ? 'el fichero no se pudo leer desde aquí, así que no se puede saber si se hizo la edición'
3420
+ : reason === 'file-changed'
3421
+ ? 'el fichero no tiene ni el texto del que partió el plan ni el que prometió: siguió cambiando, y con --gate esto suspende'
3422
+ : 'el registro guarda tokens, y los tokens no dicen con qué tarifa se facturaron: el Batch API no se puede ver desde aquí',
3004
3423
  routeObserved: (dearestModel, onTargetUsd, onOldUsd) => `el modelo más caro del label ahora es ${dearestModel} · ${onTargetUsd} en el destino, ${onOldUsd} todavía en el modelo antiguo`,
3005
3424
  batchUnobservable: () => 'la mitad batch de esta acción no se puede ver en los recuentos de tokens; el veredicto de arriba es solo la mitad de la ruta',
3006
3425
  truncationObserved: (retryBillUsd) => `este registro todavía muestra ${retryBillUsd} de desperdicio y reintentos por truncado`,
3007
3426
  cacheObserved: (deltaUsd, outcome) => outcome === 'arrived'
3008
3427
  ? `la caché ahora se paga sola en esta porción (${deltaUsd} contra la factura sin caché)`
3009
3428
  : `la caché todavía añade ${deltaUsd} a la factura de esta porción`,
3429
+ editObserved: (before, after) => `el fichero tiene el texto planeado; entrada por llamada ${before} → ${after} tokens, medido`,
3430
+ editNotMade: (path) => `${path} todavía tiene el texto del que partió el plan: la edición no se hizo`,
3010
3431
  attribution: (callsBefore, callsAfter, outBefore, outAfter) => `el mundo también se movió: llamadas ${callsBefore} → ${callsAfter}, salida/llamada ${outBefore} → ${outAfter} tokens, dicho para que el veredicto no se lea como toda la historia`,
3011
3432
  gateFailed: (failures, total) => `GATE SUSPENDIDO: ${failures} de ${total} acciones no produjeron lo que el plan prometió, o dejaron de poder medirse por el propio registro del equipo.`,
3012
3433
  gateOk: () => 'Gate superado: toda acción verificable llegó, y nada se volvió inverificable.',