v1.0.1

Full release notes: https://releases.i18nprune.dev/cli/1.0.1 · https://releases.i18nprune.dev/core/1.0.1

Summary

Patch release for the CLI and Core SDK — placeholder sentinel leak detect and repair across validate/quality/review/sync/generate, kits terminal markdown styling, and CLI help enrichment with mnemonic command and flag aliases.

Changes

Placeholder sentinel repair (CLI + Core)

• Read-only detect — validate, quality, and review warn with issue i18nprune.locale.placeholder_sentinel_leak; spaced MT mask variants (__I18NPRUNE _0__) detected alongside tight tokens; __I18NPRUNE_MISSING__ scaffold tokens excluded.
• sync post-merge repair copies source strings over stale __I18NPRUNE_* mask tokens; JSON sentinelRepairs[] with bounded detail lines (respects -T / -F / dry-run).
• generate force-queues leaked paths for placeholder_copy or full MT repair; live repair notice after translate progress; dry-run preview before translate; fail-closed on post-MT mangling.
• generate --resume treats leaked leaves as pending until repair succeeds (including preserve paths).
• Opt out — --no-repair-sentinel-leaks on sync and generate (SDK: noRepairSentinelLeaks: true on runSync / runGenerate).
• Core module — shared sentinelLeak.ts (scanLocaleForSentinelLeaks, repairSentinelLeaksCopyFromSource, planSentinelLeakGenerateRepairs, isSentinelLeakPending).

Kits terminal output

• Dim blockquotes, doc links, and sample rows on TTY via formatKitsTerminalMarkdown; plain markdown on --out / file saves.
• JSON consumers unchanged — standard CliJsonEnvelope; terminal styling does not affect --json or -o files.

CLI help & aliases

• Root help Workflows: recipes (bootstrap, sentinel fix, CI gate, share snapshot).
• Per-command Examples, Related, group Workflows, and generic Notes; styled Examples (brand-blue binary, cyan command, dim flags).
• Inline command aliases in Commands: — mnemonic positional shortcuts (val, gen, cfg, miss, qual, rev, rep, prov, langs); group subs (locales ls|dyn|rm, share up|ls|rm, kits id|dyn|bl).
• Flag shorts — global -y, -n, -m, -t, -T, -F, -ncl, -ld, -cp, …; generate -P/-R/-W/-f/-nrsl; sync -nrsl/-sm; share -wu; kits -fcs (focus); languages -flt/-tbl (--source, --src, --ask remain long-only).
• help <topic> resolves mnemonic and group alias paths (help val, help kits id, help locales ls).

Installation

CLI

npm install -g i18nprune@1.0.1

Core SDK

npm install @i18nprune/core@1.0.1

Breaking Changes

None for CLI --json envelopes, issue codes, or exit codes (parity policy).

CLI aliases are argv-only shortcuts — SDK hosts continue to use canonical command and option names.

Migration

npm install -g i18nprune@1.0.1
npm install @i18nprune/core@1.0.1

• After upgrading: run i18nprune validate to detect stale sentinels; fix with i18nprune sync --metadata --target <locale> (copy) then i18nprune generate --metadata --target <locale> (localized repair).
• Use --no-repair-sentinel-leaks when you need detect-only sync/generate runs without automatic repair.
• Optional shortcuts — i18nprune val, gen -m -t ar, locales ls.
• Pin @i18nprune/core@1.0.1 when mixing SDK + CLI.

Portal: CLI 1.0.1 · Core 1.0.1
Docs: sync · generate · placeholder_sentinel_leak · kits

Full Changelog: v1.0.0...v1.0.1