@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.
- package/README.md +4 -1
- package/assets/trazum-statusline.sh +45 -0
- package/dist/base-cost.d.ts +173 -0
- package/dist/base-cost.d.ts.map +1 -0
- package/dist/base-cost.js +244 -0
- package/dist/base-cost.js.map +1 -0
- package/dist/bill-range.d.ts +118 -0
- package/dist/bill-range.d.ts.map +1 -0
- package/dist/bill-range.js +122 -0
- package/dist/bill-range.js.map +1 -0
- package/dist/command-help.d.ts +17 -0
- package/dist/command-help.d.ts.map +1 -0
- package/dist/command-help.js +69 -0
- package/dist/command-help.js.map +1 -0
- package/dist/filter.d.ts +7 -1
- package/dist/filter.d.ts.map +1 -1
- package/dist/filter.js +10 -18
- package/dist/filter.js.map +1 -1
- package/dist/gateway-metrics.d.ts +83 -0
- package/dist/gateway-metrics.d.ts.map +1 -0
- package/dist/gateway-metrics.js +181 -0
- package/dist/gateway-metrics.js.map +1 -0
- package/dist/gateway-server.d.ts +23 -5
- package/dist/gateway-server.d.ts.map +1 -1
- package/dist/gateway-server.js +26 -1
- package/dist/gateway-server.js.map +1 -1
- package/dist/gateway-spend.d.ts +11 -1
- package/dist/gateway-spend.d.ts.map +1 -1
- package/dist/gateway-spend.js +44 -32
- package/dist/gateway-spend.js.map +1 -1
- package/dist/git.d.ts +70 -0
- package/dist/git.d.ts.map +1 -1
- package/dist/git.js +145 -0
- package/dist/git.js.map +1 -1
- package/dist/i18n/en.d.ts.map +1 -1
- package/dist/i18n/en.js +358 -6
- package/dist/i18n/en.js.map +1 -1
- package/dist/i18n/es.d.ts +0 -1
- package/dist/i18n/es.d.ts.map +1 -1
- package/dist/i18n/es.js +456 -35
- package/dist/i18n/es.js.map +1 -1
- package/dist/i18n/types.d.ts +205 -0
- package/dist/i18n/types.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +942 -59
- package/dist/index.js.map +1 -1
- package/dist/loopback-guard.d.ts +37 -0
- package/dist/loopback-guard.d.ts.map +1 -0
- package/dist/loopback-guard.js +65 -0
- package/dist/loopback-guard.js.map +1 -0
- package/dist/markdown.d.ts +23 -0
- package/dist/markdown.d.ts.map +1 -1
- package/dist/markdown.js +105 -0
- package/dist/markdown.js.map +1 -1
- package/dist/plan-edits.d.ts +63 -0
- package/dist/plan-edits.d.ts.map +1 -0
- package/dist/plan-edits.js +96 -0
- package/dist/plan-edits.js.map +1 -0
- package/dist/proactive.d.ts +17 -2
- package/dist/proactive.d.ts.map +1 -1
- package/dist/proactive.js +16 -9
- package/dist/proactive.js.map +1 -1
- package/dist/receipt-send.d.ts +44 -0
- package/dist/receipt-send.d.ts.map +1 -0
- package/dist/receipt-send.js +71 -0
- package/dist/receipt-send.js.map +1 -0
- package/dist/serve.d.ts +7 -0
- package/dist/serve.d.ts.map +1 -1
- package/dist/serve.js +22 -1
- package/dist/serve.js.map +1 -1
- package/dist/session-guard.d.ts +210 -0
- package/dist/session-guard.d.ts.map +1 -0
- package/dist/session-guard.js +463 -0
- package/dist/session-guard.js.map +1 -0
- package/dist/task.d.ts +7 -1
- package/dist/task.d.ts.map +1 -1
- package/dist/task.js +7 -26
- package/dist/task.js.map +1 -1
- package/dist/waste.d.ts +25 -0
- package/dist/waste.d.ts.map +1 -0
- package/dist/waste.js +39 -0
- package/dist/waste.js.map +1 -0
- package/dist/zone.d.ts +27 -0
- package/dist/zone.d.ts.map +1 -0
- package/dist/zone.js +96 -0
- package/dist/zone.js.map +1 -0
- package/package.json +2 -2
- package/src/base-cost.ts +384 -0
- package/src/bill-range.ts +206 -0
- package/src/command-help.ts +65 -0
- package/src/filter.ts +11 -18
- package/src/gateway-metrics.ts +209 -0
- package/src/gateway-server.ts +43 -6
- package/src/gateway-spend.ts +45 -33
- package/src/git.ts +158 -0
- package/src/i18n/en.ts +424 -6
- package/src/i18n/es.ts +542 -35
- package/src/i18n/types.ts +208 -0
- package/src/index.ts +952 -58
- package/src/loopback-guard.ts +74 -0
- package/src/markdown.ts +117 -0
- package/src/plan-edits.ts +120 -0
- package/src/proactive.ts +22 -13
- package/src/receipt-send.ts +89 -0
- package/src/serve.ts +23 -1
- package/src/session-guard.ts +541 -0
- package/src/task.ts +8 -26
- package/src/waste.ts +42 -0
- 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 <
|
|
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 <
|
|
56
|
-
trazum from-openai <usage.json> [--label <
|
|
57
|
-
trazum from-openrouter <activity.json> [--label <
|
|
58
|
-
trazum reconcile <receipt.json> --against <cost.json> [-o <
|
|
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 <
|
|
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 <
|
|
70
|
-
trazum experiment <log> --a <
|
|
71
|
-
trazum quality <log> --label <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
514
|
-
--codex <
|
|
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 <
|
|
519
|
-
-o, --out <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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.',
|