@trazum/cli 2.7.12 → 3.0.0
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 -2
- package/assets/trazum-statusline.sh +131 -0
- package/dist/git.d.ts +38 -0
- package/dist/git.d.ts.map +1 -1
- package/dist/git.js +54 -0
- package/dist/git.js.map +1 -1
- package/dist/i18n/en.d.ts.map +1 -1
- package/dist/i18n/en.js +170 -3
- package/dist/i18n/en.js.map +1 -1
- package/dist/i18n/es.d.ts.map +1 -1
- package/dist/i18n/es.js +174 -3
- package/dist/i18n/es.js.map +1 -1
- package/dist/i18n/types.d.ts +84 -0
- package/dist/i18n/types.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +670 -262
- package/dist/index.js.map +1 -1
- package/dist/proactive.d.ts +344 -0
- package/dist/proactive.d.ts.map +1 -0
- package/dist/proactive.js +1079 -0
- package/dist/proactive.js.map +1 -0
- package/dist/style.d.ts +305 -26
- package/dist/style.d.ts.map +1 -1
- package/dist/style.js +449 -47
- package/dist/style.js.map +1 -1
- package/dist/watch-notify.d.ts +82 -0
- package/dist/watch-notify.d.ts.map +1 -0
- package/dist/watch-notify.js +118 -0
- package/dist/watch-notify.js.map +1 -0
- package/dist/watch-run.d.ts +7 -0
- package/dist/watch-run.d.ts.map +1 -1
- package/dist/watch-run.js.map +1 -1
- package/dist/weekly.d.ts +32 -0
- package/dist/weekly.d.ts.map +1 -0
- package/dist/weekly.js +119 -0
- package/dist/weekly.js.map +1 -0
- package/package.json +3 -2
- package/src/git.ts +77 -0
- package/src/i18n/en.ts +198 -3
- package/src/i18n/es.ts +202 -3
- package/src/i18n/types.ts +130 -0
- package/src/index.ts +715 -302
- package/src/proactive.ts +1319 -0
- package/src/style.ts +502 -54
- package/src/watch-notify.ts +152 -0
- package/src/watch-run.ts +7 -0
- package/src/weekly.ts +133 -0
package/src/i18n/en.ts
CHANGED
|
@@ -52,7 +52,7 @@ ${bold('USAGE')}
|
|
|
52
52
|
trazum history <dir-of-stored-reports> [options]
|
|
53
53
|
trazum connect <provider> [options]
|
|
54
54
|
trazum store [--prune] [options]
|
|
55
|
-
trazum watch [--once | --interval 15m] [options]
|
|
55
|
+
trazum watch [--once | --interval 15m] [--sessions] [--notify] [options]
|
|
56
56
|
trazum serve [--port <n> | --socket <path>]
|
|
57
57
|
trazum diff <before> <after> [options]
|
|
58
58
|
trazum diff --all <dir> <dir> [options]
|
|
@@ -68,6 +68,7 @@ ${bold('USAGE')}
|
|
|
68
68
|
trazum receipt <usage.jsonl> [--stamp] [--since <when>] [--until <when>] [-o <file>]
|
|
69
69
|
trazum bill [<file|dir>...] [--label <name>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <file>]
|
|
70
70
|
[--since <when>] [--until <when>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out <file>]
|
|
71
|
+
trazum weekly [<file|dir>...] [--until <when>] [--label <name>] [--notify] [-o <file>]
|
|
71
72
|
trazum from-claude-code <file|dir> [--label <name>] [-o <file>]
|
|
72
73
|
trazum from-codex <file|dir> [--label <name>] [-o <file>]
|
|
73
74
|
trazum from-gemini-cli <file|dir> [--label <name>] [-o <file>]
|
|
@@ -82,6 +83,7 @@ ${bold('USAGE')}
|
|
|
82
83
|
trazum switch <usage.jsonl> --to <model> [--migration-usd <n>] [--cases <n>]
|
|
83
84
|
trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]
|
|
84
85
|
trazum pulse [--max-stale-hours <n>]
|
|
86
|
+
trazum proactive [status|on|off] [--only <item,...>] [--dry-run | --yes] [--json]
|
|
85
87
|
trazum bench [--workload <id>] [--record <file>] [--against <file> --max-ratio <n>] [--json]
|
|
86
88
|
trazum write [--answers <file>] [--json] [-o <file>]
|
|
87
89
|
trazum models
|
|
@@ -262,6 +264,30 @@ ${bold('OPTIONS FOR bill')}
|
|
|
262
264
|
cost report is pointed at reconcile. Each file's line says how many rows
|
|
263
265
|
were left out, and the dedicated from-<shape> command says why.
|
|
264
266
|
|
|
267
|
+
${bold('OPTIONS FOR weekly')}
|
|
268
|
+
--until <when> Where the week ends: a UTC day (2026-11-19, the
|
|
269
|
+
whole of it), a timestamp, a relative window or
|
|
270
|
+
"now", the default. The week is the seven days
|
|
271
|
+
before it, and the week before that is what it
|
|
272
|
+
is compared with.
|
|
273
|
+
--label <name> The project this usage belongs to, for the
|
|
274
|
+
shapes that take one.
|
|
275
|
+
--notify Also show a desktop notification with one line of
|
|
276
|
+
it, the bill and its movement, through what the
|
|
277
|
+
platform has (as watch --notify does). Said, not
|
|
278
|
+
fatal, where there is none.
|
|
279
|
+
-o, --out <file> Write the summary there instead of stdout.
|
|
280
|
+
|
|
281
|
+
The week in Markdown: the bill, what moved against the week before, and the
|
|
282
|
+
three changes worth making first. Reads what bill reads, and with no path
|
|
283
|
+
the coding agents' own session folders. Both weeks are measured, from the
|
|
284
|
+
same logs and the same price list. The changes are projections and say so,
|
|
285
|
+
each beside what its workload cost this week; trazum verify is what
|
|
286
|
+
measures them afterwards. Every dollar amount and percentage is checked
|
|
287
|
+
against the two weeks' bills before anything is written, and a summary with
|
|
288
|
+
one that is not there is refused. It sends nothing anywhere: the file is
|
|
289
|
+
the output, and the GitHub Action is what posts it.
|
|
290
|
+
|
|
265
291
|
${bold('OPTIONS FOR from-openrouter')}
|
|
266
292
|
--label <name> The project this usage belongs to.
|
|
267
293
|
--label-by-workspace <file> One label per workspace id, as a JSON array of
|
|
@@ -413,6 +439,33 @@ ${bold('OPTIONS FOR pulse')}
|
|
|
413
439
|
late against, and never on how far the measurements reach, which is a
|
|
414
440
|
provider reporting on its own schedule rather than a job that failed.
|
|
415
441
|
|
|
442
|
+
${bold('OPTIONS FOR proactive')}
|
|
443
|
+
status What speaks first, on or off: the status line and
|
|
444
|
+
its Stop hook, a scheduled watch, the MCP server.
|
|
445
|
+
One line each. It is the default and writes nothing.
|
|
446
|
+
on Offer each one that is off, say which files it
|
|
447
|
+
would touch and every line it would add, and write
|
|
448
|
+
only after a yes for that item.
|
|
449
|
+
off Remove exactly the lines it added. Nothing else in
|
|
450
|
+
those files changes.
|
|
451
|
+
--only <item,...> Limit it to statusline, watch or mcp.
|
|
452
|
+
--dry-run Print every file and every line, write nothing.
|
|
453
|
+
This is what it does until somebody says yes: not
|
|
454
|
+
a terminal and no --yes means a dry run.
|
|
455
|
+
--yes Say yes to every item, without asking.
|
|
456
|
+
--json The report as data. See docs/json-output.md.
|
|
457
|
+
|
|
458
|
+
The three things Trazum can say without being asked, each off until somebody
|
|
459
|
+
wires it by hand. It edits ~/.claude/settings.json, your crontab, and the MCP
|
|
460
|
+
config of the project it runs in (.mcp.json, .cursor/mcp.json), and nothing
|
|
461
|
+
else. A file it cannot parse, or a symbolic link, is left alone and named. A
|
|
462
|
+
status line that is already configured is never replaced. It sends nothing
|
|
463
|
+
anywhere: all three read files already on this machine.
|
|
464
|
+
|
|
465
|
+
It never invents a budget and never fills the store. A watch with no store or
|
|
466
|
+
no spend limit is "not ready", with the command or the key that would make it
|
|
467
|
+
ready.
|
|
468
|
+
|
|
416
469
|
${bold('OPTIONS FOR bench')}
|
|
417
470
|
--workload <id> Run one standard workload instead of all of them.
|
|
418
471
|
An unknown id is refused with the known ones named.
|
|
@@ -899,6 +952,18 @@ ${bold('OPTIONS FOR watch')}
|
|
|
899
952
|
because URLs end up in logs and shell history.
|
|
900
953
|
--payload <file> Evaluate a usage payload you already have,
|
|
901
954
|
instead of the store.
|
|
955
|
+
--sessions Watch the sessions Claude Code, Codex and Gemini
|
|
956
|
+
CLI keep on this machine, the ones \`bill\` reads
|
|
957
|
+
with no path, instead of the store. Needs no
|
|
958
|
+
setup. Say \`--sessions\` again on every run: it
|
|
959
|
+
keeps its own record of what was reported.
|
|
960
|
+
--notify Also show a desktop notification for what newly
|
|
961
|
+
crossed: osascript on macOS, notify-send on
|
|
962
|
+
Linux, a PowerShell toast on Windows, nothing
|
|
963
|
+
installed. It carries the sentence printed here
|
|
964
|
+
and nothing more. Off unless asked for; where the
|
|
965
|
+
machine has none it says so and the other
|
|
966
|
+
transports carry on.
|
|
902
967
|
--json The cycle as data: crossings, abstentions, gap.
|
|
903
968
|
|
|
904
969
|
Evaluates the spend gates from your config, maxUsd, maxDayUsd,
|
|
@@ -1366,7 +1431,7 @@ ${bold('EXAMPLES')}
|
|
|
1366
1431
|
: `Not scaled to a month: ${days} days is under the week a scaling needs, and being shorter than one weekly cycle multiplies whichever part of the cycle it caught. These figures cover exactly the period measured.`,
|
|
1367
1432
|
perMonthSaving: (saving, pct) => `saving ${saving}/month (${pct}%)`,
|
|
1368
1433
|
beyondShortening: () => 'Beyond shortening the prompt',
|
|
1369
|
-
biggestLever: () => 'Start here
|
|
1434
|
+
biggestLever: () => 'Start here',
|
|
1370
1435
|
biggestLeverDetail: (title, amount, times) =>
|
|
1371
1436
|
// The title keeps its case: lowercasing it turned "Claude Opus 5" into
|
|
1372
1437
|
// "claude opus 5", which is a product name mangled to fit a sentence.
|
|
@@ -2345,6 +2410,127 @@ ${bold('EXAMPLES')}
|
|
|
2345
2410
|
'Measured from this log alone, priced record by record. The store\'s provider-billed monthly standing is a different measurement, "trazum store" prints it, and the two are never merged into one figure.',
|
|
2346
2411
|
noLog: () => 'position needs a usage log: trazum position usage.jsonl',
|
|
2347
2412
|
},
|
|
2413
|
+
weekly: {
|
|
2414
|
+
heading: (firstDay, lastDay) => `Trazum, the week of ${firstDay} to ${lastDay}`,
|
|
2415
|
+
billHeading: () => 'The bill',
|
|
2416
|
+
billTotal: (usd, calls) => `**${usd}** over ${calls} ${calls === '1' ? 'call' : 'calls'}, measured from the logs and priced with the catalogue's own rates.`,
|
|
2417
|
+
noCalls: (firstDay, lastDay) =>
|
|
2418
|
+
`No call in the logs falls between ${firstDay} and ${lastDay}, so there is no bill to state for it. That is not a bill of nothing: either nothing ran, or what ran was not written to a log this was given.`,
|
|
2419
|
+
colModel: () => 'Model',
|
|
2420
|
+
colCalls: () => 'Calls',
|
|
2421
|
+
colUsd: () => 'USD',
|
|
2422
|
+
moreModels: (count) => `${count} more models, smaller than these.`,
|
|
2423
|
+
unpriced: (models, calls) =>
|
|
2424
|
+
`Calls on models the catalogue cannot price: ${calls} (${models}). They are not in the bill above, which is therefore a floor.`,
|
|
2425
|
+
undated: (count) =>
|
|
2426
|
+
`Calls with no timestamp: ${count}. They cannot be placed in any week and are left out, not guessed into this one.`,
|
|
2427
|
+
movedHeading: (firstDay, lastDay) => `Against the week before (${firstDay} to ${lastDay})`,
|
|
2428
|
+
noWeekBefore: () =>
|
|
2429
|
+
'No call in the logs falls in the week before, so there is nothing to compare with. A percentage of nothing is not printed.',
|
|
2430
|
+
moved: (delta, pct, now, before, calls) =>
|
|
2431
|
+
`The bill moved ${delta}${pct === null ? '' : ` (${pct})`} against the week before: ${now} now, ${before} then, over ${calls} ${calls === '1' ? 'call' : 'calls'}. Both are measured.`,
|
|
2432
|
+
unchanged: (now, before) => `The week cost the same as the week before: ${now} now, ${before} then. Both are measured.`,
|
|
2433
|
+
moversHeading: () => 'What moved most, by model:',
|
|
2434
|
+
mover: (model, before, now, delta) => `${model}: ${before} then, ${now} now (${delta})`,
|
|
2435
|
+
changesHeading: () => 'Three changes to make first',
|
|
2436
|
+
noChanges: () =>
|
|
2437
|
+
"Nothing in this week's calls gives a change to propose: no cheaper model that fits, no batchable call, no settled cache loss and no truncation retry.",
|
|
2438
|
+
projected: (usd) => `${usd} projected saving on this week's calls. Projected, not measured: it has not happened.`,
|
|
2439
|
+
stake: (usd) => `${usd} already spent on this problem this week. Measured, not projected.`,
|
|
2440
|
+
measuredBefore: (usd, calls) => `Measured before the change: this workload on this model cost ${usd} over ${calls} ${calls === '1' ? 'call' : 'calls'} this week.`,
|
|
2441
|
+
moreChanges: (count) => `${count} more changes are in the plan and are smaller than these.`,
|
|
2442
|
+
verifyHow: () =>
|
|
2443
|
+
'How each will be checked: `trazum plan <log> --out plan.json` before changing anything, then `trazum verify plan.json --against <the newer log>` after. It says for each action whether the change arrived, did not arrive, or cannot be told, and what the bill did. Until then a projected saving is a projection.',
|
|
2444
|
+
footer: () =>
|
|
2445
|
+
'Written by `trazum weekly` from logs on the machine that ran it. Nothing was sent anywhere to produce it, and no model was called.',
|
|
2446
|
+
strayFigures: (figures) =>
|
|
2447
|
+
`The summary was not written: it holds ${figures}, which is in neither week's bill. A figure nobody can find in the bill is not printed.`,
|
|
2448
|
+
wrote: (path) => `Weekly summary written to ${path}.`,
|
|
2449
|
+
notifyUnavailable: (command) => `--notify asked for a desktop notification, and this machine has no ${command}, so none was sent. The summary is written all the same.`,
|
|
2450
|
+
notifyFailed: (command, why) => `--notify: ${command} refused (${why}), so no notification was shown. The summary is written all the same.`,
|
|
2451
|
+
headline: (usd, calls, delta, pct) =>
|
|
2452
|
+
`Trazum, this week: ${usd} over ${calls} ${calls === '1' ? 'call' : 'calls'}${delta === null ? '' : `, ${delta}${pct === null ? '' : ` (${pct})`} against the week before`}.`,
|
|
2453
|
+
},
|
|
2454
|
+
proactive: {
|
|
2455
|
+
heading: () => 'Trazum, speaking first',
|
|
2456
|
+
item: { statusline: 'status line', watch: 'watch', mcp: 'MCP server' },
|
|
2457
|
+
verdict: { on: 'on', off: 'off', 'not-ready': 'not ready', 'not-available': 'not available', 'could-not-tell': 'could not tell' },
|
|
2458
|
+
reason: {
|
|
2459
|
+
'statusline.on': (p) => `The status line and its Stop hook are in ${p.file}.`,
|
|
2460
|
+
'statusline.off': (p) => `Not in ${p.file}. Turning it on adds a status line, and a Stop hook that refreshes it after each turn.`,
|
|
2461
|
+
'statusline.partial': (p) =>
|
|
2462
|
+
`${p.file} has part of it: the ${p.missing === 'hook' ? 'Stop hook' : 'status line'} is missing. Turning it on adds that part.`,
|
|
2463
|
+
'statusline.stale': (p) => `The entries in ${p.file} point at a script or a CLI that is no longer there. Turning it on repairs them.`,
|
|
2464
|
+
'statusline.windows': () => 'The status line is a bash script, and there is no Windows form of it yet.',
|
|
2465
|
+
'statusline.noClaude': (p) => `${p.dir} does not exist: Claude Code has not run on this machine, so there is no settings file to add to.`,
|
|
2466
|
+
'statusline.foreign': (p) =>
|
|
2467
|
+
`${p.file} already has a status line (${p.command}). It is left alone. To switch by hand, follow plugin/README.md.`,
|
|
2468
|
+
'watch.on': (p) => `Scheduled in your crontab for ${p.project} (${p.schedule}), reading the store and the budget there.`,
|
|
2469
|
+
'watch.off': (p) => `Not scheduled for ${p.project}. Turning it on adds one crontab line that runs "trazum watch --once" there every hour.`,
|
|
2470
|
+
'watch.stale': (p) => `The crontab line for ${p.project} points at a CLI that is no longer there. Turning it on repairs it.`,
|
|
2471
|
+
'watch.windows': () => 'Scheduling here is cron, and Windows has none. docs/running.md has the Task Scheduler line to run by hand.',
|
|
2472
|
+
'watch.noCrontab': () => 'There is no crontab program on this machine, so nothing can be scheduled here.',
|
|
2473
|
+
'watch.crontabError': (p) => `"crontab -l" failed: ${p.why}`,
|
|
2474
|
+
'watch.configError': (p) => `trazum.config.json could not be read: ${p.why}`,
|
|
2475
|
+
'watch.noStore': () => 'The store has nothing in it. Fill it first with "trazum connect <provider> --store".',
|
|
2476
|
+
'watch.noBudget': (p) =>
|
|
2477
|
+
`A budget is a policy, so none is written for you.${p.measured === '' ? '' : ` The store holds ${p.measured} measured.`} Set spend.maxUsd, spend.maxDayUsd or spend.maxCacheLossUsd in trazum.config.json to a limit you choose.`,
|
|
2478
|
+
'watch.noStoreNoBudget': () =>
|
|
2479
|
+
'Needs a store with something in it ("trazum connect <provider> --store") and a limit you choose (spend.maxUsd, spend.maxDayUsd or spend.maxCacheLossUsd in trazum.config.json).',
|
|
2480
|
+
'watch.scheduledNotReady': (p) =>
|
|
2481
|
+
`Scheduled for ${p.project}, but every run refuses until the store has something in it and trazum.config.json has a spend limit. It is not watching yet.`,
|
|
2482
|
+
'watch.otherProjects': (p) => `${p.count} more managed crontab line(s) for other projects stay as they are. Run this in each of those projects to remove them.`,
|
|
2483
|
+
'mcp.on': (p) => `The trazum server is in ${p.files}.`,
|
|
2484
|
+
'mcp.off': (p) => `Turning it on adds the trazum server to ${p.files}.`,
|
|
2485
|
+
'mcp.noClient': (p) => `No .mcp.json and no .cursor folder in ${p.dir}, so there is no client config here to add to.`,
|
|
2486
|
+
'mcp.noClientClaude': (p) =>
|
|
2487
|
+
`No .mcp.json in ${p.dir}. Claude Code takes the server through its plugin; run these yourself: claude plugin marketplace add Davmunrey/Trazum, then claude plugin install trazum@trazum.`,
|
|
2488
|
+
'mcp.other': (p) => `${p.file} already has a trazum entry that is not the one this writes. Left alone.`,
|
|
2489
|
+
'mcp.changed': (p) => `${p.file} has a trazum entry this command added and somebody has changed since. Left alone.`,
|
|
2490
|
+
'mcp.notAdded': (p) => `${p.file} already has exactly this entry, put there by hand. It stays when this is turned off.`,
|
|
2491
|
+
'cli.unstable': (p) =>
|
|
2492
|
+
`The CLI at ${p.path} will not be there tomorrow: a one-off npx run, or the file is gone. Install it where it stays (npm install -g @trazum/cli) and run this again.`,
|
|
2493
|
+
'cli.unsafe': (p) => `The path ${p.path} has a quote, a percent sign or a newline in it, and cannot be written safely into a shell line or a crontab.`,
|
|
2494
|
+
'cli.notExecutable': (p) =>
|
|
2495
|
+
`The CLI at ${p.path} is not executable, and the Stop hook starts it by its path: the status line would never have a figure. Make it executable (chmod +x) or install the CLI (npm install -g @trazum/cli), and run this again.`,
|
|
2496
|
+
'file.unparseable': (p) => `${p.file} could not be parsed as JSON (${p.why}). Left alone.`,
|
|
2497
|
+
'file.symlink': (p) => `${p.file} is a symbolic link. Left alone: edit the file it points to by hand.`,
|
|
2498
|
+
'file.shape': (p) => `${p.file} has a ${p.key} that is not the kind of value expected. Left alone.`,
|
|
2499
|
+
'file.notExact': (p) =>
|
|
2500
|
+
`${p.file} is JSON, but writing it back would change a value, a key or an escape in it (a duplicate key, for one). Left alone, so that nothing else in it changes.`,
|
|
2501
|
+
'file.reformat': (p) => `${p.file} lays out some lines differently from what this writes (inline arrays, say). Its spacing and line breaks are normalised when it is written; every key and value stays.`,
|
|
2502
|
+
'file.unreadable': (p) => `${p.file} could not be read: ${p.why}.`,
|
|
2503
|
+
'file.outside': (p) => `${p.file} resolves outside the directory it belongs to. Left alone.`,
|
|
2504
|
+
'write.not-allowed': (p) => `Refused to write ${p.file}: it is not one of the files this command may touch (${p.allowed}).`,
|
|
2505
|
+
'write.symlink': (p) => `Refused to write ${p.file}: it is a symbolic link.`,
|
|
2506
|
+
'write.outside': (p) => `Refused to write ${p.file}: it resolves outside the directory it belongs to.`,
|
|
2507
|
+
'write.changed': (p) => `${p.file} changed while this ran. Nothing was written to it. Run it again.`,
|
|
2508
|
+
'write.unreadable': (p) => `${p.file} could not be read again just before writing, so nothing was written to it. Run it again.`,
|
|
2509
|
+
'write.partial': (p) =>
|
|
2510
|
+
`A write failed part way, and what had already been written could not be put back: ${p.files}. Nothing records these as written by this command, so look at them by hand.`,
|
|
2511
|
+
'write.failed': (p) => `Could not write: ${p.why}.`,
|
|
2512
|
+
'statusline.scriptChanged': (p) =>
|
|
2513
|
+
`The file at ${p.script} is not the script this command wrote: it was changed, or it is somebody's own. It is left as it is, and nothing is written over it. Move it away and run this again to install the status line.`,
|
|
2514
|
+
},
|
|
2515
|
+
unknownAction: (given) => `Unknown action "${given}". Use: trazum proactive [status|on|off].`,
|
|
2516
|
+
unknownItem: (given, allowed) => `Unknown item "${given}" in --only. The items are: ${allowed}.`,
|
|
2517
|
+
wouldTurnOn: (item) => `${item}: would write`,
|
|
2518
|
+
wouldTurnOff: (item) => `${item}: would remove`,
|
|
2519
|
+
nothingToChange: (item) => `${item}: nothing to change.`,
|
|
2520
|
+
dryRunAsked: () => 'Dry run: nothing was written.',
|
|
2521
|
+
dryRunNoTerminal: () =>
|
|
2522
|
+
'This is not a terminal and --yes was not given, so it is a dry run: nothing was written. Run it in a terminal to be asked about each item, or pass --yes to say yes to all of them.',
|
|
2523
|
+
askOn: (item, files) => `Write the ${item} (${files})? [y/N] `,
|
|
2524
|
+
askOff: (item, files) => `Remove the ${item} (${files})? [y/N] `,
|
|
2525
|
+
didTurnOn: (item) => `${item}: wrote`,
|
|
2526
|
+
didTurnOff: (item) => `${item}: removed`,
|
|
2527
|
+
declined: (item) => `${item}: not written, you said no.`,
|
|
2528
|
+
failed: (item, reason) => `${item}: not written. ${reason}`,
|
|
2529
|
+
backupNote: (suffix) =>
|
|
2530
|
+
`The first time a file you own changes, a copy of it is kept beside it as <name>${suffix}. It is never replaced.`,
|
|
2531
|
+
crontab: () => 'your crontab',
|
|
2532
|
+
},
|
|
2533
|
+
|
|
2348
2534
|
pulse: {
|
|
2349
2535
|
heading: () => 'Did the things that are supposed to run, run?',
|
|
2350
2536
|
kind: (kind) => {
|
|
@@ -2848,7 +3034,7 @@ ${bold('EXAMPLES')}
|
|
|
2848
3034
|
leverSlice: (label, model, usd, pct) =>
|
|
2849
3035
|
`${label} on ${model}, up to ${usd} of this bill (${pct})`,
|
|
2850
3036
|
leverRoute: (candidate, usd) => `route it to ${candidate}, ${usd}`,
|
|
2851
|
-
leverRouteVerify: (
|
|
3037
|
+
leverRouteVerify: () =>
|
|
2852
3038
|
`Whether that holds is an evaluation question, not an arithmetic one, and nothing here has seen a single answer. Measure it: trazum route <log> --prompt-file <prompt> --cases <cases> --yes`,
|
|
2853
3039
|
leverBatch: (usd) => `send it through the Batch API, ${usd}`,
|
|
2854
3040
|
leverCalls: (calls, spent) => `${calls}, ${spent} spent`,
|
|
@@ -3341,6 +3527,15 @@ ${bold('EXAMPLES')}
|
|
|
3341
3527
|
webhookFailed: (status) =>
|
|
3342
3528
|
`The webhook did not deliver (${status}). The crossing is still in the exit code and in the output above: a receiver being down must not be the quietest failure in the room.`,
|
|
3343
3529
|
watching: (minutes) => `Watching every ${minutes} minutes. Ctrl-C stops it.`,
|
|
3530
|
+
readingSessions: (agent, dir) => `Watching ${agent}'s sessions in ${dir}`,
|
|
3531
|
+
sessionsAndPayload: () =>
|
|
3532
|
+
'--sessions reads the sessions on this machine and --payload reads the file you name. A cycle has one source: give one of them.',
|
|
3533
|
+
noSessionUsage: () =>
|
|
3534
|
+
'The sessions found hold no usage a price can be put on yet. Watching nothing would report that everything is fine, so this is refused rather than passed.',
|
|
3535
|
+
notifyUnavailable: (command) =>
|
|
3536
|
+
`--notify asked for a desktop notification, and this machine has no ${command}, so none was sent. The exit code, the output above and --webhook still carry the crossing.`,
|
|
3537
|
+
notifyFailed: (command, why) =>
|
|
3538
|
+
`${command} would not show the notification (${why}), usually because nobody is logged in at a desktop. The crossing is still in the exit code and in the output above.`,
|
|
3344
3539
|
},
|
|
3345
3540
|
|
|
3346
3541
|
store: {
|
package/src/i18n/es.ts
CHANGED
|
@@ -39,7 +39,7 @@ ${bold('USO')}
|
|
|
39
39
|
trazum history <dir-de-informes-guardados> [opciones]
|
|
40
40
|
trazum connect <provider> [opciones]
|
|
41
41
|
trazum store [--prune] [opciones]
|
|
42
|
-
trazum watch [--once | --interval 15m] [opciones]
|
|
42
|
+
trazum watch [--once | --interval 15m] [--sessions] [--notify] [opciones]
|
|
43
43
|
trazum serve [--port <n> | --socket <ruta>]
|
|
44
44
|
trazum diff <antes> <después> [opciones]
|
|
45
45
|
trazum diff --all <dir> <dir> [opciones]
|
|
@@ -55,6 +55,7 @@ ${bold('USO')}
|
|
|
55
55
|
trazum receipt <uso.jsonl> [--stamp] [--since <cuándo>] [--until <cuándo>] [-o <fichero>]
|
|
56
56
|
trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
|
|
57
57
|
[--since <cuándo>] [--until <cuándo>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
|
|
58
|
+
trazum weekly [<fichero|dir>...] [--until <cuándo>] [--label <nombre>] [--notify] [-o <fichero>]
|
|
58
59
|
trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
|
|
59
60
|
trazum from-codex <fichero|dir> [--label <nombre>] [-o <fichero>]
|
|
60
61
|
trazum from-gemini-cli <fichero|dir> [--label <nombre>] [-o <fichero>]
|
|
@@ -69,6 +70,7 @@ ${bold('USO')}
|
|
|
69
70
|
trazum switch <uso.jsonl> --to <modelo> [--migration-usd <n>] [--cases <n>]
|
|
70
71
|
trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]
|
|
71
72
|
trazum pulse [--max-stale-hours <n>]
|
|
73
|
+
trazum proactive [status|on|off] [--only <item,...>] [--dry-run | --yes] [--json]
|
|
72
74
|
trazum bench [--workload <id>] [--record <fichero>] [--against <fichero> --max-ratio <n>] [--json]
|
|
73
75
|
trazum write [--answers <fichero>] [--json] [-o <fichero>]
|
|
74
76
|
trazum models
|
|
@@ -295,6 +297,31 @@ ${bold('OPCIONES DE bill')}
|
|
|
295
297
|
remite a reconcile. La línea de cada archivo dice cuántas filas quedaron
|
|
296
298
|
fuera, y el comando from-<forma> dedicado dice por qué.
|
|
297
299
|
|
|
300
|
+
${bold('OPCIONES DE weekly')}
|
|
301
|
+
--until <cuándo> Dónde termina la semana: un día UTC (2026-11-19,
|
|
302
|
+
el día entero), una marca de tiempo, una ventana
|
|
303
|
+
relativa o "now", el valor por defecto. La semana
|
|
304
|
+
son los siete días anteriores, y se compara con
|
|
305
|
+
la semana anterior a esa.
|
|
306
|
+
--label <nombre> El proyecto al que pertenece este uso, para las
|
|
307
|
+
formas que lo admiten.
|
|
308
|
+
--notify Muestra además una notificación de escritorio con
|
|
309
|
+
una línea del resumen, la factura y su movimiento,
|
|
310
|
+
con lo que tenga la plataforma (como watch
|
|
311
|
+
--notify). Se dice, no es fatal, si no hay.
|
|
312
|
+
-o, --out <archivo> Escribe el resumen ahí en vez de en stdout.
|
|
313
|
+
|
|
314
|
+
La semana en Markdown: la factura, qué se movió respecto a la semana
|
|
315
|
+
anterior y los tres cambios que conviene hacer primero. Lee lo que lee
|
|
316
|
+
bill y, sin ruta, las carpetas de sesiones de cada agente. Las dos semanas
|
|
317
|
+
son medidas, de los mismos logs y con la misma lista de precios. Los
|
|
318
|
+
cambios son proyecciones y lo dicen, cada uno junto a lo que costó su
|
|
319
|
+
carga de trabajo esta semana; trazum verify es lo que los mide después.
|
|
320
|
+
Cada importe en dólares y cada porcentaje se comprueba contra las facturas
|
|
321
|
+
de las dos semanas antes de escribir nada, y se rechaza un resumen con uno
|
|
322
|
+
que no esté ahí. No envía nada a ningún sitio: el archivo es la salida, y
|
|
323
|
+
la GitHub Action es la que lo publica.
|
|
324
|
+
|
|
298
325
|
${bold('OPCIONES DE from-openrouter')}
|
|
299
326
|
--label <nombre> El proyecto al que pertenece este uso.
|
|
300
327
|
--label-by-workspace <archivo> Una etiqueta por id de workspace, como array
|
|
@@ -398,6 +425,35 @@ ${bold('OPCIONES DE from-claude-code')}
|
|
|
398
425
|
contenido, así que las líneas se colapsan por id de petición; lo colapsado o
|
|
399
426
|
descartado se dice en stderr, nunca en silencio.
|
|
400
427
|
|
|
428
|
+
${bold('OPCIONES DE proactive')}
|
|
429
|
+
status Qué habla primero, activo o apagado: la línea de
|
|
430
|
+
estado y su hook Stop, un watch programado, el
|
|
431
|
+
servidor MCP. Una línea cada uno. Es lo
|
|
432
|
+
predeterminado y no escribe nada.
|
|
433
|
+
on Ofrece cada uno que esté apagado, dice qué archivos
|
|
434
|
+
tocaría y cada línea que añadiría, y solo escribe
|
|
435
|
+
tras un sí para ese elemento.
|
|
436
|
+
off Quita exactamente las líneas que añadió. Nada más
|
|
437
|
+
cambia en esos archivos.
|
|
438
|
+
--only <item,...> Limita a statusline, watch o mcp.
|
|
439
|
+
--dry-run Imprime cada archivo y cada línea, no escribe nada.
|
|
440
|
+
Es lo que hace hasta que alguien dice que sí: sin
|
|
441
|
+
terminal y sin --yes es un simulacro.
|
|
442
|
+
--yes Dice que sí a todos, sin preguntar.
|
|
443
|
+
--json El informe como datos. Ver docs/json-output.md.
|
|
444
|
+
|
|
445
|
+
Las tres cosas que Trazum puede decir sin que se lo pidan, apagadas hasta que
|
|
446
|
+
alguien las conecta a mano. Edita ~/.claude/settings.json, tu crontab y la
|
|
447
|
+
configuración MCP del proyecto donde se ejecuta (.mcp.json,
|
|
448
|
+
.cursor/mcp.json), y nada más. Un archivo que no puede leer, o un enlace
|
|
449
|
+
simbólico, se deja como está y se nombra. Una línea de estado ya configurada
|
|
450
|
+
nunca se reemplaza. No envía nada a ningún sitio: las tres leen archivos que
|
|
451
|
+
ya están en esta máquina.
|
|
452
|
+
|
|
453
|
+
Nunca inventa un presupuesto ni llena el almacén. Un watch sin almacén o sin
|
|
454
|
+
límite de gasto está "no listo", con el comando o la clave que lo dejaría
|
|
455
|
+
listo.
|
|
456
|
+
|
|
401
457
|
${bold('OPCIONES DE pulse')}
|
|
402
458
|
--max-stale-hours <n> Sale con 1 cuando algo que corre aquí lleva más
|
|
403
459
|
de n horas sin correr. Sin esto, se informan las
|
|
@@ -937,6 +993,19 @@ ${bold('OPCIONES DE watch')}
|
|
|
937
993
|
porque las URLs acaban en logs e historiales.
|
|
938
994
|
--payload <fichero> Evalúa un payload de uso que ya tengas, en vez
|
|
939
995
|
del almacén.
|
|
996
|
+
--sessions Vigila las sesiones que Claude Code, Codex y
|
|
997
|
+
Gemini CLI guardan en esta máquina, las que
|
|
998
|
+
\`bill\` lee sin ruta, en vez del almacén. No
|
|
999
|
+
necesita configuración. Repite \`--sessions\` en
|
|
1000
|
+
cada ejecución: lleva su propio registro de lo
|
|
1001
|
+
que ya se reportó.
|
|
1002
|
+
--notify Muestra además una notificación de escritorio de
|
|
1003
|
+
lo que acaba de cruzar: osascript en macOS,
|
|
1004
|
+
notify-send en Linux, un aviso de PowerShell en
|
|
1005
|
+
Windows, sin instalar nada. Lleva la frase que se
|
|
1006
|
+
imprime aquí y nada más. Desactivada salvo que la
|
|
1007
|
+
pidas; si la máquina no tiene ninguna, lo dice y
|
|
1008
|
+
los demás transportes siguen.
|
|
940
1009
|
--json La vuelta como datos: cruces, abstenciones, hueco.
|
|
941
1010
|
|
|
942
1011
|
Evalúa los gates de gasto de tu configuración (maxUsd, maxDayUsd,
|
|
@@ -1409,7 +1478,7 @@ ${bold('EJEMPLOS')}
|
|
|
1409
1478
|
: `Sin escalar a un mes: ${days} días queda por debajo de la semana que un escalado necesita: menos de un ciclo semanal multiplica la parte del ciclo que pilló. Estas cifras cubren exactamente el periodo medido.`,
|
|
1410
1479
|
perMonthSaving: (saving, pct) => `ahorro ${saving}/mes (${pct}%)`,
|
|
1411
1480
|
beyondShortening: () => 'Además de acortar el prompt',
|
|
1412
|
-
biggestLever: () => 'Empieza por
|
|
1481
|
+
biggestLever: () => 'Empieza por aquí',
|
|
1413
1482
|
biggestLeverDetail: (title, amount, times) =>
|
|
1414
1483
|
// El título conserva sus mayúsculas: pasarlo a minúsculas convertía
|
|
1415
1484
|
// "Claude Opus 5" en "claude opus 5", un nombre de producto destrozado.
|
|
@@ -2377,6 +2446,127 @@ ${bold('EJEMPLOS')}
|
|
|
2377
2446
|
'Medido solo desde este log, registro a registro. La posición mensual facturada por el proveedor que guarda el almacén es otra medición (la imprime «trazum store») y las dos nunca se funden en una cifra.',
|
|
2378
2447
|
noLog: () => 'position necesita un log de uso: trazum position uso.jsonl',
|
|
2379
2448
|
},
|
|
2449
|
+
weekly: {
|
|
2450
|
+
heading: (firstDay, lastDay) => `Trazum, la semana del ${firstDay} al ${lastDay}`,
|
|
2451
|
+
billHeading: () => 'La factura',
|
|
2452
|
+
billTotal: (usd, calls) => `**${usd}** en ${calls} ${calls === '1' ? 'llamada' : 'llamadas'}, ${calls === '1' ? 'medida' : 'medidas'} de los logs y ${calls === '1' ? 'cobrada' : 'cobradas'} con las tarifas del propio catálogo.`,
|
|
2453
|
+
noCalls: (firstDay, lastDay) =>
|
|
2454
|
+
`Ninguna llamada de los logs cae entre el ${firstDay} y el ${lastDay}, así que no hay factura que declarar. Eso no es una factura de cero: o no se ejecutó nada, o lo que se ejecutó no quedó en un log de los entregados.`,
|
|
2455
|
+
colModel: () => 'Modelo',
|
|
2456
|
+
colCalls: () => 'Llamadas',
|
|
2457
|
+
colUsd: () => 'USD',
|
|
2458
|
+
moreModels: (count) => `${count} modelos más, más pequeños que estos.`,
|
|
2459
|
+
unpriced: (models, calls) =>
|
|
2460
|
+
`Llamadas con modelos que el catálogo no sabe cobrar: ${calls} (${models}). No están en la factura de arriba, que por tanto es un mínimo.`,
|
|
2461
|
+
undated: (count) =>
|
|
2462
|
+
`Llamadas sin marca de tiempo: ${count}. No se pueden situar en ninguna semana y quedan fuera, no adivinadas dentro de esta.`,
|
|
2463
|
+
movedHeading: (firstDay, lastDay) => `Frente a la semana anterior (${firstDay} a ${lastDay})`,
|
|
2464
|
+
noWeekBefore: () =>
|
|
2465
|
+
'Ninguna llamada de los logs cae en la semana anterior, así que no hay con qué comparar. No se imprime un porcentaje de nada.',
|
|
2466
|
+
moved: (delta, pct, now, before, calls) =>
|
|
2467
|
+
`La factura se movió ${delta}${pct === null ? '' : ` (${pct})`} frente a la anterior: ${now} ahora, ${before} entonces en ${calls} ${calls === '1' ? 'llamada' : 'llamadas'}. Las dos son medidas.`,
|
|
2468
|
+
unchanged: (now, before) => `La semana costó lo mismo que la anterior: ${now} ahora, ${before} entonces. Las dos son medidas.`,
|
|
2469
|
+
moversHeading: () => 'Lo que más se movió, por modelo:',
|
|
2470
|
+
mover: (model, before, now, delta) => `${model}: ${before} entonces, ${now} ahora (${delta})`,
|
|
2471
|
+
changesHeading: () => 'Tres cambios para hacer primero',
|
|
2472
|
+
noChanges: () =>
|
|
2473
|
+
'Nada de las llamadas de esta semana da un cambio que proponer: ningún modelo más barato que encaje, ninguna llamada que pueda ir por lotes, ninguna pérdida de caché confirmada ni reintento por truncado.',
|
|
2474
|
+
projected: (usd) => `${usd} de ahorro proyectado sobre las llamadas de esta semana. Proyectado, no medido: aún no ha ocurrido.`,
|
|
2475
|
+
stake: (usd) => `${usd} ya gastados en este problema esta semana. Medido, no proyectado.`,
|
|
2476
|
+
measuredBefore: (usd, calls) => `Medido antes del cambio: esta carga de trabajo en este modelo costó ${usd} en ${calls} ${calls === '1' ? 'llamada' : 'llamadas'} esta semana.`,
|
|
2477
|
+
moreChanges: (count) => `${count} cambios más están en el plan y son más pequeños que estos.`,
|
|
2478
|
+
verifyHow: () =>
|
|
2479
|
+
'Cómo se comprobará cada uno: `trazum plan <log> --out plan.json` antes de cambiar nada, y después `trazum verify plan.json --against <el log más nuevo>`. Dice por cada acción si el cambio llegó, no llegó o no se puede saber, y qué hizo la factura. Hasta entonces un ahorro proyectado es una proyección.',
|
|
2480
|
+
footer: () =>
|
|
2481
|
+
'Escrito por `trazum weekly` a partir de logs de la máquina que lo ejecutó. No se envió nada a ningún sitio para producirlo y no se llamó a ningún modelo.',
|
|
2482
|
+
strayFigures: (figures) =>
|
|
2483
|
+
`No se escribió el resumen: contiene ${figures}, que no está en la factura de ninguna de las dos semanas. Una cifra que nadie encuentra en la factura no se imprime.`,
|
|
2484
|
+
wrote: (path) => `Resumen semanal escrito en ${path}.`,
|
|
2485
|
+
notifyUnavailable: (command) => `--notify pidió una notificación de escritorio y esta máquina no tiene ${command}, así que no se envió ninguna. El resumen se escribió igualmente.`,
|
|
2486
|
+
notifyFailed: (command, why) => `--notify: ${command} la rechazó (${why}), así que no se mostró ninguna notificación. El resumen se escribió igualmente.`,
|
|
2487
|
+
headline: (usd, calls, delta, pct) =>
|
|
2488
|
+
`Trazum, esta semana: ${usd} en ${calls} ${calls === '1' ? 'llamada' : 'llamadas'}${delta === null ? '' : `, ${delta}${pct === null ? '' : ` (${pct})`} frente a la semana anterior`}.`,
|
|
2489
|
+
},
|
|
2490
|
+
proactive: {
|
|
2491
|
+
heading: () => 'Trazum, hablando primero',
|
|
2492
|
+
item: { statusline: 'línea de estado', watch: 'watch', mcp: 'servidor MCP' },
|
|
2493
|
+
verdict: { on: 'activo', off: 'apagado', 'not-ready': 'no está listo', 'not-available': 'no disponible', 'could-not-tell': 'no se sabe' },
|
|
2494
|
+
reason: {
|
|
2495
|
+
'statusline.on': (p) => `La línea de estado y su hook Stop están en ${p.file}.`,
|
|
2496
|
+
'statusline.off': (p) => `No está en ${p.file}. Activarlo añade una línea de estado y un hook Stop que la refresca tras cada turno.`,
|
|
2497
|
+
'statusline.partial': (p) =>
|
|
2498
|
+
`${p.file} tiene una parte: falta ${p.missing === 'hook' ? 'el hook Stop' : 'la línea de estado'}. Activarlo añade esa parte.`,
|
|
2499
|
+
'statusline.stale': (p) => `Las entradas de ${p.file} apuntan a un script o a una CLI que ya no está. Activarlo las repara.`,
|
|
2500
|
+
'statusline.windows': () => 'La línea de estado es un script de bash, y todavía no existe una versión para Windows.',
|
|
2501
|
+
'statusline.noClaude': (p) => `${p.dir} no existe: Claude Code no se ha ejecutado en esta máquina, así que no hay un archivo de ajustes al que añadir.`,
|
|
2502
|
+
'statusline.foreign': (p) =>
|
|
2503
|
+
`${p.file} ya tiene una línea de estado (${p.command}). Se deja como está. Para cambiarla a mano, sigue plugin/README.md.`,
|
|
2504
|
+
'watch.on': (p) => `Programado en tu crontab para ${p.project} (${p.schedule}), leyendo allí el almacén y el presupuesto.`,
|
|
2505
|
+
'watch.off': (p) => `No está programado para ${p.project}. Activarlo añade una línea al crontab que ejecuta "trazum watch --once" allí cada hora.`,
|
|
2506
|
+
'watch.stale': (p) => `La línea del crontab para ${p.project} apunta a una CLI que ya no está. Activarlo la repara.`,
|
|
2507
|
+
'watch.windows': () => 'Aquí programar es cron, y Windows no lo tiene. docs/running.md trae la línea del Programador de tareas para ejecutar a mano.',
|
|
2508
|
+
'watch.noCrontab': () => 'No hay programa crontab en esta máquina, así que aquí no se puede programar nada.',
|
|
2509
|
+
'watch.crontabError': (p) => `"crontab -l" falló: ${p.why}`,
|
|
2510
|
+
'watch.configError': (p) => `No se pudo leer trazum.config.json: ${p.why}`,
|
|
2511
|
+
'watch.noStore': () => 'El almacén está vacío. Llénalo antes con "trazum connect <proveedor> --store".',
|
|
2512
|
+
'watch.noBudget': (p) =>
|
|
2513
|
+
`Un presupuesto es una decisión, así que no se escribe ninguno por ti.${p.measured === '' ? '' : ` El almacén tiene ${p.measured} medidos.`} Pon spend.maxUsd, spend.maxDayUsd o spend.maxCacheLossUsd en trazum.config.json con un límite que elijas.`,
|
|
2514
|
+
'watch.noStoreNoBudget': () =>
|
|
2515
|
+
'Necesita un almacén con algo dentro ("trazum connect <proveedor> --store") y un límite que elijas (spend.maxUsd, spend.maxDayUsd o spend.maxCacheLossUsd en trazum.config.json).',
|
|
2516
|
+
'watch.scheduledNotReady': (p) =>
|
|
2517
|
+
`Programado para ${p.project}, pero cada ejecución se negará hasta que el almacén tenga algo y trazum.config.json tenga un límite de gasto. Todavía no vigila.`,
|
|
2518
|
+
'watch.otherProjects': (p) => `Quedan ${p.count} línea(s) gestionadas del crontab para otros proyectos. Ejecuta esto en cada uno para quitarlas.`,
|
|
2519
|
+
'mcp.on': (p) => `El servidor trazum está en ${p.files}.`,
|
|
2520
|
+
'mcp.off': (p) => `Activarlo añade el servidor trazum a ${p.files}.`,
|
|
2521
|
+
'mcp.noClient': (p) => `No hay .mcp.json ni carpeta .cursor en ${p.dir}, así que no hay configuración de cliente a la que añadir.`,
|
|
2522
|
+
'mcp.noClientClaude': (p) =>
|
|
2523
|
+
`No hay .mcp.json en ${p.dir}. Claude Code recibe el servidor por su plugin; ejecuta tú estos comandos: claude plugin marketplace add Davmunrey/Trazum, y luego claude plugin install trazum@trazum.`,
|
|
2524
|
+
'mcp.other': (p) => `${p.file} ya tiene una entrada trazum distinta de la que esto escribe. Se deja como está.`,
|
|
2525
|
+
'mcp.changed': (p) => `${p.file} tiene una entrada trazum que añadió este comando y alguien ha cambiado después. Se deja como está.`,
|
|
2526
|
+
'mcp.notAdded': (p) => `${p.file} ya tiene exactamente esta entrada, puesta a mano. Se queda al apagar esto.`,
|
|
2527
|
+
'cli.unstable': (p) =>
|
|
2528
|
+
`La CLI en ${p.path} no estará mañana: una ejecución puntual de npx, o el archivo ya no existe. Instálala donde se quede (npm install -g @trazum/cli) y vuelve a ejecutar esto.`,
|
|
2529
|
+
'cli.unsafe': (p) => `La ruta ${p.path} tiene una comilla, un signo de porcentaje o un salto de línea, y no se puede escribir con seguridad en una línea de shell ni en un crontab.`,
|
|
2530
|
+
'cli.notExecutable': (p) =>
|
|
2531
|
+
`La CLI en ${p.path} no es ejecutable, y el hook Stop la arranca por su ruta: la línea de estado nunca tendría una cifra. Hazla ejecutable (chmod +x) o instala la CLI (npm install -g @trazum/cli), y vuelve a ejecutar esto.`,
|
|
2532
|
+
'file.unparseable': (p) => `${p.file} no se pudo leer como JSON (${p.why}). Se deja como está.`,
|
|
2533
|
+
'file.symlink': (p) => `${p.file} es un enlace simbólico. Se deja como está: edita a mano el archivo al que apunta.`,
|
|
2534
|
+
'file.shape': (p) => `${p.file} tiene un ${p.key} que no es del tipo esperado. Se deja como está.`,
|
|
2535
|
+
'file.notExact': (p) =>
|
|
2536
|
+
`${p.file} es JSON, pero volver a escribirlo cambiaría un valor, una clave o un escape (una clave duplicada, por ejemplo). Se deja como está, para que nada más cambie.`,
|
|
2537
|
+
'file.reformat': (p) => `${p.file} dispone algunas líneas de otro modo que lo que esto escribe (arrays en línea, por ejemplo). Su espaciado y sus saltos de línea se normalizan al escribirlo; todas las claves y valores se conservan.`,
|
|
2538
|
+
'file.unreadable': (p) => `No se pudo leer ${p.file}: ${p.why}.`,
|
|
2539
|
+
'file.outside': (p) => `${p.file} resuelve fuera del directorio al que pertenece. Se deja como está.`,
|
|
2540
|
+
'write.not-allowed': (p) => `Se rechazó escribir ${p.file}: no es uno de los archivos que este comando puede tocar (${p.allowed}).`,
|
|
2541
|
+
'write.symlink': (p) => `Se rechazó escribir ${p.file}: es un enlace simbólico.`,
|
|
2542
|
+
'write.outside': (p) => `Se rechazó escribir ${p.file}: resuelve fuera del directorio al que pertenece.`,
|
|
2543
|
+
'write.changed': (p) => `${p.file} cambió mientras esto se ejecutaba. No se escribió nada en él. Vuelve a ejecutarlo.`,
|
|
2544
|
+
'write.unreadable': (p) => `No se pudo volver a leer ${p.file} justo antes de escribir, así que no se escribió nada en él. Vuelve a ejecutarlo.`,
|
|
2545
|
+
'write.partial': (p) =>
|
|
2546
|
+
`Una escritura falló a medias, y lo que ya se había escrito no se pudo devolver a como estaba: ${p.files}. Nada los registra como escritos por este comando, así que revísalos a mano.`,
|
|
2547
|
+
'write.failed': (p) => `No se pudo escribir: ${p.why}.`,
|
|
2548
|
+
'statusline.scriptChanged': (p) =>
|
|
2549
|
+
`El archivo en ${p.script} no es el script que escribió este comando: se cambió, o es de otra persona. Se deja como está y no se escribe nada encima. Apártalo y vuelve a ejecutar esto para instalar la línea de estado.`,
|
|
2550
|
+
},
|
|
2551
|
+
unknownAction: (given) => `Acción desconocida "${given}". Usa: trazum proactive [status|on|off].`,
|
|
2552
|
+
unknownItem: (given, allowed) => `Elemento desconocido "${given}" en --only. Los elementos son: ${allowed}.`,
|
|
2553
|
+
wouldTurnOn: (item) => `${item}: escribiría`,
|
|
2554
|
+
wouldTurnOff: (item) => `${item}: quitaría`,
|
|
2555
|
+
nothingToChange: (item) => `${item}: nada que cambiar.`,
|
|
2556
|
+
dryRunAsked: () => 'Simulacro: no se escribió nada.',
|
|
2557
|
+
dryRunNoTerminal: () =>
|
|
2558
|
+
'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 por cada elemento, o pasa --yes para decir que sí a todos.',
|
|
2559
|
+
askOn: (item, files) => `¿Escribir ${item} (${files})? [s/N] `,
|
|
2560
|
+
askOff: (item, files) => `¿Quitar ${item} (${files})? [s/N] `,
|
|
2561
|
+
didTurnOn: (item) => `${item}: escrito`,
|
|
2562
|
+
didTurnOff: (item) => `${item}: quitado`,
|
|
2563
|
+
declined: (item) => `${item}: no se escribió, dijiste que no.`,
|
|
2564
|
+
failed: (item, reason) => `${item}: no se escribió. ${reason}`,
|
|
2565
|
+
backupNote: (suffix) =>
|
|
2566
|
+
`La primera vez que cambia un archivo tuyo, se guarda una copia al lado como <nombre>${suffix}. Nunca se reemplaza.`,
|
|
2567
|
+
crontab: () => 'tu crontab',
|
|
2568
|
+
},
|
|
2569
|
+
|
|
2380
2570
|
pulse: {
|
|
2381
2571
|
heading: () => '¿Corrieron las cosas que tienen que correr?',
|
|
2382
2572
|
kind: (kind) => {
|
|
@@ -2877,7 +3067,7 @@ ${bold('EJEMPLOS')}
|
|
|
2877
3067
|
leverSlice: (label, model, usd, pct) =>
|
|
2878
3068
|
`${label} en ${model}: hasta ${usd} de esta factura (${pct})`,
|
|
2879
3069
|
leverRoute: (candidate, usd) => `llévalo a ${candidate}, ${usd}`,
|
|
2880
|
-
leverRouteVerify: (
|
|
3070
|
+
leverRouteVerify: () =>
|
|
2881
3071
|
`Si eso aguanta es una pregunta de evaluación, no de aritmética, y aquí no se ha visto ni una sola respuesta. Mídelo: trazum route <log> --prompt-file <prompt> --cases <casos> --yes`,
|
|
2882
3072
|
leverBatch: (usd) => `mándalo por la Batch API, ${usd}`,
|
|
2883
3073
|
leverCalls: (calls, spent) => `${calls}, ${spent} gastados`,
|
|
@@ -3371,6 +3561,15 @@ ${bold('EJEMPLOS')}
|
|
|
3371
3561
|
webhookFailed: (status) =>
|
|
3372
3562
|
`El webhook no se entregó (${status}). El cruce sigue en el código de salida y en la salida de arriba: que un receptor esté caído no puede ser el fallo más silencioso de la sala.`,
|
|
3373
3563
|
watching: (minutes) => `Vigilando cada ${minutes} minutos. Ctrl-C lo para.`,
|
|
3564
|
+
readingSessions: (agent, dir) => `Vigilando las sesiones de ${agent} en ${dir}`,
|
|
3565
|
+
sessionsAndPayload: () =>
|
|
3566
|
+
'--sessions lee las sesiones de esta máquina y --payload lee el fichero que nombras. Una vuelta tiene una sola fuente: da una de las dos.',
|
|
3567
|
+
noSessionUsage: () =>
|
|
3568
|
+
'Las sesiones encontradas todavía no tienen un uso al que ponerle precio. Vigilar la nada reportaría que todo está bien, así que se rechaza en vez de aprobarse.',
|
|
3569
|
+
notifyUnavailable: (command) =>
|
|
3570
|
+
`--notify pidió una notificación de escritorio, y esta máquina no tiene ${command}, así que no se envió ninguna. El código de salida, la salida de arriba y --webhook siguen llevando el cruce.`,
|
|
3571
|
+
notifyFailed: (command, why) =>
|
|
3572
|
+
`${command} no quiso mostrar la notificación (${why}), normalmente porque nadie ha iniciado sesión en un escritorio. El cruce sigue en el código de salida y en la salida de arriba.`,
|
|
3374
3573
|
},
|
|
3375
3574
|
|
|
3376
3575
|
store: {
|