tsoft-cli 3.12.4 → 3.13.1

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to T-Soft CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.13.1] - 2026-09-10
+
+### Fixed
+- The directory warning added in 3.13.0 no longer fires inside the theme directory it is pointing at. Some commands record the active theme by its folder id and others by its name, while the directory on disk is always named after the theme — so for a theme recorded by id the two never matched, the warning appeared even in the right place, and the `cd` it offered named an id that no directory has. An id cannot be turned back into a directory name without asking the store, which this check deliberately avoids so it stays fast and works offline, so the warning is now skipped in that case. Themes recorded by name are unaffected and still get the warning outside their directory.
+
+## [3.13.0] - 2026-09-10
+
+### Added
+- Commands that work on theme files now say so when you are not standing in the theme directory. They quietly fell back to the saved theme, so a command run from the wrong place worked on a theme you were not looking at and gave no sign of it. The theme that will be used is now named, along with the directory to change into. Commands that create or fetch a theme are unaffected, and `--json` output is unchanged.
+- `tsoft docs` opens the developer documentation. The address only lived in the README, so there was no way to reach the docs from the tool itself. It is printed as well as opened, and printed on its own when no browser can be opened, so it still helps over SSH or in a container.
+- `tsoft completion bash|zsh|fish` prints a shell completion script built from the command tree, so `tsoft th` completes to `theme` and `tsoft theme d` to `dev`. Deprecated commands are left out. The README documents installing it for each shell.
+- `tsoft upgrade` updates the CLI and works out how it was installed first: npm for a global install, volta under Volta. Running through `npx` fetches the latest version every time, so there is nothing to upgrade and the command says that instead of suggesting something that would not help. `tsoft update` does the same thing.
+- The CLI checks once a day whether a newer version has been published and prints a line when there is one. A failed check is ignored, so being offline neither delays nor breaks whatever you were running. `tsoft config autoupgrade on|off|status` turns the check off; the setting lives in `~/.tsoft-cli/settings.json`.
+- `theme create`, `theme fork` and `theme pull` print the `cd` step before `tsoft theme dev`. The first two skipped it and `pull` printed no follow-up at all, so the README described a step the tool never mentioned.
+
+### Changed
+- `theme list`, `store list` and `theme section list` print as aligned tables. Each record used to spread over several lines, which made them hard to compare. Columns are trimmed to fit the terminal, so a narrow window no longer wraps a row, and `--json` output is unchanged.
+- A mistyped command now exits non-zero. `tsoft themme push` printed the help screen and exited zero, so it looked like it had succeeded; scripts checking the exit code saw nothing wrong. This is a behaviour change for anything relying on that zero.
+- The README now documents the whole CLI. Roughly half the command surface was missing from it — `theme init`/`fork`, `store list`, `store use`, `org switch`, `theme section create`, `theme section fork` and the global `--json`, `--verbose` and `--store` flags were all undocumented, so anyone reading the README had no way to discover them. It also now explains the per-store directory layout that decides which store and theme a command targets, and how to drive the CLI from CI with `--json`.
+- The package carries a fuller set of npm keywords, so searching npm or Google for the T-Soft CLI finds this package rather than the retired `@tsoft-cli/theme`.
+- `CONTRIBUTING.md` lists the two source files and the `scripts/` directory it had been missing, and documents the `check-locales` and `check-engine-floor` validation scripts.
+
+### Fixed
+- A mistyped command now reports the mistake and offers the closest match instead of printing the help screen. The root command has an action attached, which meant the unknown-command branch was never reached and the suggestion machinery never ran. The same applied under `theme section`, where a typo opened the interactive menu. Both now tell apart no arguments, which still shows the menu or help, from an argument that matches nothing. A close match can be accepted to run the intended command.
+- "Theme directory not found" no longer tells everyone to run `theme pull`. That is the wrong advice when the theme is already on disk and you are simply standing somewhere else, which was the more common case of the two. The two situations are now separate messages.
+
+### Removed
+- `cli-progress`, `cli-spinners` and `strip-ansi` are no longer direct dependencies. They were declared but imported nowhere; `strip-ansi` still arrives through `string-width` for the packages that need it.
+
 ## [3.12.4] - 2026-08-11
 
 ### Fixed

package/README.md

@@ -1,6 +1,10 @@
 # tsoft-cli
 
-Command-line tool for [tsoft360](https://tsoft360.com) theme development and management.
+The official command-line tool for [tsoft360](https://tsoft360.com) theme development.
+
+Build, preview and ship storefront themes from your terminal, with live reload during development and OAuth2 authentication against your store.
+
+> **Looking for `@tsoft-cli/theme`?** That package is deprecated and no longer maintained. `tsoft-cli` is the official CLI — install it as shown below.
 
 ## Installation
 
@@ -8,6 +12,12 @@ Command-line tool for [tsoft360](https://tsoft360.com) theme development and man
 npm install -g tsoft-cli
 ```
 
+Verify the installation:
+
+```bash
+tsoft --version
+```
+
 ## Requirements
 
 - Node.js >= 20.19.0
@@ -15,77 +25,220 @@ npm install -g tsoft-cli
 ## Quick Start
 
 ```bash
-# Sign in
+# 1. Sign in to your store
 tsoft login
 
-# List available themes
+# 2. See which themes you have
 tsoft theme list
 
-# Pull an existing theme
+# 3. Download one to work on
 tsoft theme pull
 
-# Start dev mode (hot-reload)
+# 4. Start developing with live reload
 tsoft theme dev
+
+# 5. Ship your changes
+tsoft theme push
 ```
 
+## Workspace Layout
+
+The CLI organizes themes per store, one directory per store domain:
+
+```
+my-projects/
+└── example.com/          # store directory (named after your store domain)
+    ├── my-theme/         # a theme
+    └── another-theme/
+```
+
+Commands detect the store and theme from your current directory. Running `tsoft theme push` from inside `example.com/my-theme/` targets that store and theme without any flags. This also means new themes are created next to their siblings rather than nested inside the theme you happen to be in.
+
+Use `--store <domain>` to override the detected store for a single command.
+
 ## Commands
 
+### Global Flags
+
+Available on every command:
+
+| Flag              | Description                              |
+| ----------------- | ---------------------------------------- |
+| `--json`          | Machine-readable JSON output for CI/CD   |
+| `--verbose`       | Verbose debug output                     |
+| `--store <domain>` | Run against a specific store            |
+| `--version`       | Print the installed version              |
+| `--help`          | Show help                                |
+
 ### Authentication
 
 | Command        | Description                             |
-|----------------|-----------------------------------------|
-| `tsoft login`  | Sign in via OAuth2                      |
-| `tsoft logout` | Sign out and clear stored tokens        |
-| `tsoft whoami` | Show the signed-in user and active shop |
-
-### Theme Management
-
-| Command                    | Description                             |
-| -------------------------- | --------------------------------------- |
-| `tsoft theme list`         | List all themes                         |
-| `tsoft theme create [name]` | Create a new theme                     |
-| `tsoft theme pull`         | Pull an existing theme                  |
-| `tsoft theme use [name]`   | Set the active theme                    |
-| `tsoft theme dev [name]`   | Start dev mode (hot-reload)             |
-| `tsoft theme push [name]`  | Push theme files to your store          |
-| `tsoft theme section list` | List blocks and sections                |
-| `tsoft theme section add`  | Add a section (interactive)             |
-
-`tsoft theme publish` and `tsoft theme submit` are deprecated aliases kept for backwards compatibility. `publish` forwards to `push`; submission is now done from the partner panel.
+| -------------- | --------------------------------------- |
+| `tsoft login`  | Authenticate via OAuth2                 |
+| `tsoft logout` | Sign out and clear local credentials    |
+| `tsoft whoami` | Show the signed-in user and active store |
+
+### Stores
+
+| Command                     | Description                          |
+| --------------------------- | ------------------------------------ |
+| `tsoft store list`          | List the stores you are signed in to |
+| `tsoft store use [domain]`  | Set the active store                 |
+
+### Organizations
+
+| Command             | Description                   |
+| ------------------- | ----------------------------- |
+| `tsoft org switch`  | Switch the active organization |
+
+### Themes
+
+| Command                      | Description                             |
+| ---------------------------- | --------------------------------------- |
+| `tsoft theme list`           | List all themes in your store           |
+| `tsoft theme create [name]`  | Create a new theme                      |
+| `tsoft theme init`           | Fork an existing theme into a new one   |
+| `tsoft theme pull`           | Download an existing theme              |
+| `tsoft theme use [name]`     | Set the active theme                    |
+| `tsoft theme dev [name]`     | Start the dev server with live reload   |
+| `tsoft theme push [name]`    | Push theme files to your store          |
+
+`tsoft theme init` accepts `--from <slug>` to pick the source theme non-interactively, and is also available as `tsoft theme fork`.
+
+### Sections
+
+| Command                       | Description                                  |
+| ----------------------------- | -------------------------------------------- |
+| `tsoft theme section`         | Open the interactive section menu             |
+| `tsoft theme section list`    | List all sections in the active theme         |
+| `tsoft theme section add`     | Add a new section to the active theme         |
+| `tsoft theme section create`  | Create an empty section in the active theme   |
+| `tsoft theme section fork`    | Fork an existing section into the active theme |
+
+## Developing a Theme
+
+```bash
+tsoft theme dev
+```
+
+This starts a local development server and watches your theme files. Edits are pushed to your store as you save, so you can preview changes without a manual push.
+
+### Help
+
+| Command                            | Description                              |
+| ---------------------------------- | ---------------------------------------- |
+| `tsoft docs`                       | Open the developer documentation         |
+| `tsoft completion <shell>`         | Print a shell completion script          |
+| `tsoft upgrade`                    | Update the CLI (`tsoft update` also works) |
+| `tsoft config autoupgrade <state>` | Turn the version check `on`, `off`, or show `status` |
+
+## Staying Up To Date
+
+`tsoft upgrade` reads the published version, works out how the CLI was installed
+and runs the right command for it — `npm install -g` for a global install,
+`volta install` under Volta. Running through `npx` always fetches the latest
+version, so there is nothing to upgrade and the command says so.
+
+Once a day the CLI also checks quietly and prints a line when a newer version
+exists. The check is skipped when you are offline and never delays a command.
+Turn it off with:
+
+```bash
+tsoft config autoupgrade off
+```
+
+The setting is stored in `~/.tsoft-cli/settings.json`.
+
+## Tab Completion
+
+`tsoft completion` writes a completion script to stdout for `bash`, `zsh` or `fish`.
+Once installed, `tsoft th<Tab>` completes to `theme` and `tsoft theme d<Tab>` to `dev`.
+
+**bash**
+
+```bash
+tsoft completion bash > /usr/local/etc/bash_completion.d/tsoft
+# or, without root:
+echo 'source <(tsoft completion bash)' >> ~/.bashrc
+```
+
+**zsh**
+
+```bash
+tsoft completion zsh > "${fpath[1]}/_tsoft"
+# or:
+echo 'source <(tsoft completion zsh)' >> ~/.zshrc
+```
+
+**fish**
+
+```bash
+tsoft completion fish > ~/.config/fish/completions/tsoft.fish
+```
+
+Open a new shell afterwards, or re-source the file you edited.
 
 ## Pushing a Theme
 
 ```bash
-# Using the active theme
+# Push the active theme
 tsoft theme push
 
-# Using a specific theme
+# Push a specific theme
 tsoft theme push my-theme
 
-# With verbose error output
+# Show full error detail if a push fails
 tsoft theme push --verbose
 ```
 
-On the first push you enter the initial version number. Subsequent updates prompt for a semantic-versioning bump type (patch / minor / major).
+On the first push you enter an initial version number. Later pushes prompt for a semantic-versioning bump type (patch / minor / major).
+
+## CI/CD Usage
+
+Every command accepts `--json`, which disables colors and interactive prompts and emits structured output:
+
+```bash
+tsoft theme list --json
+tsoft whoami --json
+```
+
+Combine with `--store` to target a specific store from a pipeline:
+
+```bash
+tsoft theme push my-theme --store example.com --json
+```
 
 ## Security
 
-- **OAuth2 PKCE**: Secure authorization as a public client
-- **State parameter**: CSRF protection
+- **OAuth2 PKCE**: Authorization as a public client, no client secret on disk
+- **State parameter**: CSRF protection during the authorization exchange
 - **Secure storage**: Tokens are readable only by the owner (`chmod 600`)
 - **Auto-refresh**: Access tokens are refreshed automatically when they expire
 
 ## Troubleshooting
 
 ```bash
-# Check the current session
+# Who am I, and which store am I pointed at?
 tsoft whoami
 
 # Re-authenticate from scratch
 tsoft logout
 tsoft login
+
+# Get full error detail on a failing command
+tsoft theme push --verbose
 ```
 
+If a command targets the wrong store, check the directory you are running it from — see [Workspace Layout](#workspace-layout) — or pass `--store <domain>` explicitly.
+
+## Deprecated Commands
+
+`tsoft theme publish` and `tsoft theme submit` are hidden aliases kept for backwards compatibility. `publish` forwards to `push`; theme submission is now done from the partner panel.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## License
 
 [MIT](LICENSE)

package/locales/en.json

@@ -169,7 +169,6 @@
   "dev.fork_source": "Source: {{source}} v{{version}}",
   "dev.dir_exists_title": "Directory Exists",
   "dev.dir_exists_prompt": "Directory already exists!\n\nLocation: {{path}}\n\nOverwrite?",
-  "dev.theme_not_found": "Theme directory not found!\n\nExpected: {{path}}\n\nSolution: tsoft theme pull",
   "dev.checking_lock": "🔒 Checking lock status...",
   "dev.not_locked": "✓ Theme is not locked",
   "dev.acquiring_lock": "🔐 Acquiring lock...",
@@ -214,7 +213,7 @@
   "init.theme_label": "Theme:",
   "init.source_label": "Source:",
   "init.location_label": "Location:",
-  "init.dev_tip": "To start development: tsoft theme dev {{slug}}",
+  "init.dev_tip": "To start development:",
   "init.json_error.message": "--from parameter required (interactive selection not supported in JSON mode)",
   "init.json_error.hint": "Usage: tsoft --json theme fork --from <slug>",
   "init.theme_not_found": "Theme not found: {{slug}}",
@@ -223,11 +222,6 @@
   "section.list.active_theme": "Active Theme: {{theme}}",
   "section.list.no_blocks": "▲ No blocks found yet.",
   "section.list.count": "Total {{count}} blocks found:",
-  "section.list.id_label": "ID:",
-  "section.list.folder_label": "Folder:",
-  "section.list.sections_label": "Available sections ({{count}}):",
-  "section.list.tags_label": "Tags:",
-  "section.list.file_label": "File:",
   "section.list.no_sections": "▲ No sections found for this block",
   "section.add.no_active_theme": "No active theme found. Please run \"tsoft theme use <theme-name>\" first.",
   "section.add.starting": "🔧 Starting section add operation...",
@@ -310,6 +304,8 @@
   "help.group.development": "Development",
   "help.group.theme_management": "Theme Management",
   "help.group.account": "Account",
+  "help.group.help": "Help",
+  "help.cmd.docs": "Open the developer documentation in your browser",
   "help.cmd.theme_dev": "Start theme development server with live reload",
   "help.cmd.theme_push": "Push theme files to your store",
   "help.cmd.theme_section_list": "List all sections in the active theme",
@@ -357,5 +353,47 @@
   "store.search_prompt": "Search or pick a store",
   "theme.use.on_store": "Store: {{store}}",
   "theme.use.search_prompt": "Search or pick a theme",
-  "context.workspace": "From this directory: {{store}} · {{theme}}"
+  "context.workspace": "From this directory: {{store}} · {{theme}}",
+  "docs.opening": "Opening the developer documentation in your browser...",
+  "docs.open_failed": "Could not open a browser. You can reach the documentation at:",
+  "context.outside_theme": "You are outside the theme directory. This command will use your saved theme: {{store}} · {{theme}}",
+  "context.cd_hint": "To work inside that theme, change into its directory:",
+  "dev.theme_not_downloaded": "Theme directory not found!\n\nExpected: {{path}}\n\nThe theme has not been downloaded yet. To download it: tsoft theme pull",
+  "dev.theme_wrong_directory": "Theme directory not found!\n\nExpected: {{path}}\n\nYou may be in the wrong directory. Change into the theme directory:\n  cd {{cd}}",
+  "error.unknown_command": "Unknown command: {{command}}",
+  "error.unknown_subcommand": "Unknown command: {{parent}} {{command}}",
+  "error.did_you_mean": "Did you mean: {{suggestion}}",
+  "error.see_help": "To see the available commands: tsoft --help",
+  "error.run_suggestion": "Run {{command}} instead?",
+  "help.cmd.completion": "Generate a shell completion script",
+  "completion.unsupported_shell": "Unsupported shell: {{shell}}\n\nSupported: {{supported}}",
+  "table.head.theme": "THEME",
+  "table.head.version": "VERSION",
+  "table.head.folder": "FOLDER",
+  "table.head.status": "STATUS",
+  "table.head.store": "STORE",
+  "table.head.session": "SESSION",
+  "table.head.block": "BLOCK",
+  "table.head.section": "SECTION",
+  "table.head.id": "ID",
+  "table.head.file": "FILE",
+  "table.head.description": "DESCRIPTION",
+  "help.cmd.upgrade": "Update the CLI to the latest version",
+  "help.cmd.config": "Show and change CLI settings",
+  "upgrade.checking": "Checking for the latest version...",
+  "upgrade.current": "You are already on the latest version: v{{version}}",
+  "upgrade.available": "A new version is available: v{{current}} → v{{latest}}",
+  "upgrade.running": "Running: {{command}}",
+  "upgrade.success": "Updated the CLI to v{{version}}.",
+  "upgrade.failed": "Update failed: {{error}}",
+  "upgrade.check_failed": "Could not read the published version. You may be offline.",
+  "upgrade.npx_notice": "You are running through npx, which downloads the latest version every time.\n\nTo install it permanently: npm install -g tsoft-cli",
+  "upgrade.unknown_install": "Could not work out how the CLI was installed.\n\nTo update it by hand: npm install -g tsoft-cli@latest",
+  "upgrade.notice": "A new version is available: v{{current}} → v{{latest}}  ({{command}})",
+  "upgrade.notice_disable": "To silence this: tsoft config autoupgrade off",
+  "config.autoupgrade.on": "Version checking is on.",
+  "config.autoupgrade.off": "Version checking is off.",
+  "config.autoupgrade.status_on": "Version checking: on",
+  "config.autoupgrade.status_off": "Version checking: off",
+  "config.autoupgrade.usage": "Usage: tsoft config autoupgrade on | off | status"
 }

package/locales/tr.json

@@ -169,7 +169,6 @@
   "dev.fork_source": "Kaynak: {{source}} v{{version}}",
   "dev.dir_exists_title": "Dizin Mevcut",
   "dev.dir_exists_prompt": "Dizin zaten mevcut!\n\nKonum: {{path}}\n\nUzerine yazilsin mi?",
-  "dev.theme_not_found": "Tema dizini bulunamadı!\n\nBeklenen: {{path}}\n\nÇözüm: tsoft theme pull",
   "dev.checking_lock": "🔒 Lock durumu kontrol ediliyor...",
   "dev.not_locked": "✓ Tema kilitli değil",
   "dev.acquiring_lock": "🔐 Kilit alınıyor...",
@@ -214,7 +213,7 @@
   "init.theme_label": "Tema:",
   "init.source_label": "Kaynak:",
   "init.location_label": "Konum:",
-  "init.dev_tip": "Geliştirmeye başlamak için: tsoft theme dev {{slug}}",
+  "init.dev_tip": "Geliştirmeye başlamak için:",
   "init.json_error.message": "--from parametresi gerekli (JSON modda interaktif seçim desteklenmez)",
   "init.json_error.hint": "Kullanim: tsoft --json theme fork --from <slug>",
   "init.theme_not_found": "Tema bulunamadı: {{slug}}",
@@ -223,11 +222,6 @@
   "section.list.active_theme": "Aktif Tema: {{theme}}",
   "section.list.no_blocks": "▲ Henüz block bulunmuyor.",
   "section.list.count": "Toplam {{count}} block bulundu:",
-  "section.list.id_label": "ID:",
-  "section.list.folder_label": "Klasör:",
-  "section.list.sections_label": "Mevcut section'lar ({{count}}):",
-  "section.list.tags_label": "Etiketler:",
-  "section.list.file_label": "Dosya:",
   "section.list.no_sections": "▲ Bu block için section bulunmuyor",
   "section.add.no_active_theme": "Aktif tema bulunamadı. Lütfen önce \"tsoft theme use <tema-adı>\" komutunu çalıştırın.",
   "section.add.starting": "🔧 Section ekleme işlemi başlatılıyor...",
@@ -310,6 +304,8 @@
   "help.group.development": "Geliştirme",
   "help.group.theme_management": "Tema Yönetimi",
   "help.group.account": "Hesap",
+  "help.group.help": "Yardım",
+  "help.cmd.docs": "Geliştirici dokümanını tarayıcıda açın",
   "help.cmd.theme_dev": "Canlı yenileme ile tema geliştirme sunucusunu başlat",
   "help.cmd.theme_push": "Tema dosyalarını mağazanıza gönderin",
   "help.cmd.theme_section_list": "Aktif temadaki tüm section'ları listeleyin",
@@ -357,5 +353,47 @@
   "store.search_prompt": "Mağaza arayın veya seçin",
   "theme.use.on_store": "Mağaza: {{store}}",
   "theme.use.search_prompt": "Tema arayın veya seçin",
-  "context.workspace": "Bulunduğunuz dizin: {{store}} · {{theme}}"
+  "context.workspace": "Bulunduğunuz dizin: {{store}} · {{theme}}",
+  "docs.opening": "Geliştirici dokümanı tarayıcıda açılıyor...",
+  "docs.open_failed": "Tarayıcı açılamadı. Dokümana şu adresten ulaşabilirsiniz:",
+  "context.outside_theme": "Tema dizininin dışındasınız. Komut kayıtlı temanız üzerinde çalışacak: {{store}} · {{theme}}",
+  "context.cd_hint": "Bu temanın dizinine geçmek için:",
+  "dev.theme_not_downloaded": "Tema dizini bulunamadı!\n\nBeklenen: {{path}}\n\nTema henüz indirilmemiş. İndirmek için: tsoft theme pull",
+  "dev.theme_wrong_directory": "Tema dizini bulunamadı!\n\nBeklenen: {{path}}\n\nYanlış dizinde olabilirsiniz. Tema dizinine geçin:\n  cd {{cd}}",
+  "error.unknown_command": "Bilinmeyen komut: {{command}}",
+  "error.unknown_subcommand": "Bilinmeyen komut: {{parent}} {{command}}",
+  "error.did_you_mean": "Bunu mu demek istediniz: {{suggestion}}",
+  "error.see_help": "Komut listesi için: tsoft --help",
+  "error.run_suggestion": "{{command}} komutunu çalıştıralım mı?",
+  "help.cmd.completion": "Kabuk tamamlama betiği üretin",
+  "completion.unsupported_shell": "Desteklenmeyen kabuk: {{shell}}\n\nDesteklenenler: {{supported}}",
+  "table.head.theme": "TEMA",
+  "table.head.version": "SÜRÜM",
+  "table.head.folder": "KLASÖR",
+  "table.head.status": "DURUM",
+  "table.head.store": "MAĞAZA",
+  "table.head.session": "OTURUM",
+  "table.head.block": "BLOK",
+  "table.head.section": "SECTION",
+  "table.head.id": "ID",
+  "table.head.file": "DOSYA",
+  "table.head.description": "AÇIKLAMA",
+  "help.cmd.upgrade": "CLI'ı en son sürüme güncelleyin",
+  "help.cmd.config": "CLI ayarlarını görüntüleyin ve değiştirin",
+  "upgrade.checking": "En son sürüm kontrol ediliyor...",
+  "upgrade.current": "Zaten en son sürümü kullanıyorsunuz: v{{version}}",
+  "upgrade.available": "Yeni sürüm mevcut: v{{current}} → v{{latest}}",
+  "upgrade.running": "Çalıştırılıyor: {{command}}",
+  "upgrade.success": "CLI v{{version}} sürümüne güncellendi.",
+  "upgrade.failed": "Güncelleme başarısız: {{error}}",
+  "upgrade.check_failed": "Sürüm bilgisi alınamadı. Çevrimdışı olabilirsiniz.",
+  "upgrade.npx_notice": "npx ile çalıştırıyorsunuz; her çalıştırmada en son sürüm indirilir.\n\nKalıcı kurulum için: npm install -g tsoft-cli",
+  "upgrade.unknown_install": "Kurulum yöntemi belirlenemedi.\n\nEl ile güncellemek için: npm install -g tsoft-cli@latest",
+  "upgrade.notice": "Yeni sürüm mevcut: v{{current}} → v{{latest}}  ({{command}})",
+  "upgrade.notice_disable": "Bu uyarıyı kapatmak için: tsoft config autoupgrade off",
+  "config.autoupgrade.on": "Sürüm kontrolü açıldı.",
+  "config.autoupgrade.off": "Sürüm kontrolü kapatıldı.",
+  "config.autoupgrade.status_on": "Sürüm kontrolü: açık",
+  "config.autoupgrade.status_off": "Sürüm kontrolü: kapalı",
+  "config.autoupgrade.usage": "Kullanım: tsoft config autoupgrade on | off | status"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsoft-cli",
-  "version": "3.12.4",
+  "version": "3.13.1",
   "description": "Command-line tool for tsoft360 theme development and management",
   "type": "module",
   "main": "src/index.js",
@@ -20,10 +20,18 @@
   },
   "keywords": [
     "tsoft",
+    "tsoft-cli",
+    "tsoft cli",
     "tsoft360",
+    "tsoft theme",
+    "tsoft os2",
     "cli",
     "theme",
-    "development"
+    "theme development",
+    "twig",
+    "ecommerce",
+    "e-commerce",
+    "storefront"
   ],
   "author": "T-Soft",
   "license": "MIT",
@@ -41,14 +49,12 @@
     "boxen": "^8.0.1",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
-    "cli-progress": "^3.12.0",
-    "cli-spinners": "^3.3.0",
     "commander": "^12.1.0",
     "gradient-string": "^3.0.0",
     "open": "^10.1.0",
     "ora": "^9.3.0",
-    "string-width": "^7.2.0",
-    "strip-ansi": "^7.1.2"
+    "semver": "^7.8.5",
+    "string-width": "^7.2.0"
   },
   "homepage": "https://github.com/tekrom/tsoft-cli",
   "repository": {
@@ -56,7 +62,6 @@
     "url": "git+https://github.com/tekrom/tsoft-cli.git"
   },
   "devDependencies": {
-    "semver": "^7.8.5",
     "vitest": "^4.1.5"
   }
 }

package/src/cli-settings.js

@@ -0,0 +1,47 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+
+const SETTINGS_FILE = 'settings.json';
+
+function settingsPath() {
+    return path.join(os.homedir(), '.tsoft-cli', SETTINGS_FILE);
+}
+
+async function readSettings() {
+    try {
+        return JSON.parse(await fs.readFile(settingsPath(), 'utf-8'));
+    } catch {
+        return {};
+    }
+}
+
+async function writeSetting(key, value) {
+    const file = settingsPath();
+    const settings = await readSettings();
+
+    settings[key] = value;
+
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, JSON.stringify(settings, null, 2) + '\n');
+}
+
+export async function getAutoupgrade() {
+    const { autoupgrade } = await readSettings();
+
+    return autoupgrade !== false;
+}
+
+export async function setAutoupgrade(enabled) {
+    await writeSetting('autoupgrade', Boolean(enabled));
+}
+
+export async function getLastCheck() {
+    const { lastUpdateCheck } = await readSettings();
+
+    return Number.isFinite(lastUpdateCheck) ? lastUpdateCheck : 0;
+}
+
+export async function setLastCheck(timestamp) {
+    await writeSetting('lastUpdateCheck', timestamp);
+}

package/src/commands/config.js

@@ -0,0 +1,38 @@
+import { isJsonMode, jsonOut } from '../output-mode.js';
+import { showError, showInfo, showSuccess } from '../ui/prompt-wrapper.js';
+import { getAutoupgrade, setAutoupgrade } from '../cli-settings.js';
+import { t } from '../i18n.js';
+
+export async function configAutoupgradeCommand(action = 'status') {
+    if (!['on', 'off', 'status'].includes(action)) {
+        if (isJsonMode()) {
+            jsonOut({ status: 'error', command: 'config autoupgrade', error: { message: t('config.autoupgrade.usage'), hint: null } });
+            process.exit(1);
+        }
+        showError(t('config.autoupgrade.usage'));
+        process.exit(1);
+    }
+
+    if (action === 'status') {
+        const enabled = await getAutoupgrade();
+
+        if (isJsonMode()) {
+            jsonOut({ status: 'ok', command: 'config autoupgrade', autoupgrade: enabled });
+            return;
+        }
+
+        showInfo(enabled ? t('config.autoupgrade.status_on') : t('config.autoupgrade.status_off'));
+        return;
+    }
+
+    const enabled = action === 'on';
+
+    await setAutoupgrade(enabled);
+
+    if (isJsonMode()) {
+        jsonOut({ status: 'ok', command: 'config autoupgrade', autoupgrade: enabled });
+        return;
+    }
+
+    showSuccess(enabled ? t('config.autoupgrade.on') : t('config.autoupgrade.off'));
+}

package/src/commands/docs.js

@@ -0,0 +1,23 @@
+import open from 'open';
+import chalk from 'chalk';
+import { isJsonMode, jsonOut } from '../output-mode.js';
+import { t } from '../i18n.js';
+
+export const DOCS_URL = 'https://developer.tsoft.com.tr/';
+
+export async function docsCommand() {
+    if (isJsonMode()) {
+        jsonOut({ url: DOCS_URL });
+        return;
+    }
+
+    try {
+        await open(DOCS_URL);
+        console.log(chalk.cyan(t('docs.opening')));
+    } catch {
+        console.log(chalk.yellow(t('docs.open_failed')));
+    }
+
+    console.log(chalk.gray(`   ${DOCS_URL}`));
+    console.log();
+}