@promptscript/cli 1.0.0-alpha.1 → 1.0.0-alpha.10

package/CHANGELOG.md

@@ -5,6 +5,129 @@ All notable changes to this project 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).
 
+## [1.0.0-alpha.10](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2026-01-31)
+
+
+### chore
+
+* prepare alpha release ([c6595b6](https://github.com/mrwogu/promptscript/commit/c6595b6fd639f93f0093c503e8468fbbbf057cf9))
+
+## [1.0.0-alpha.9](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2026-01-30)
+
+
+### chore
+
+* prepare alpha release ([ce96d95](https://github.com/mrwogu/promptscript/commit/ce96d954ae0a015689dda443effc7e80ce80dec5))
+
+
+### Features
+
+* **docs:** add interactive terminal demos to homepage and getting started ([b2f781b](https://github.com/mrwogu/promptscript/commit/b2f781b45d57862026e5c8ab8cb4525ccacbbd15))
+
+
+### Bug Fixes
+
+* **cli:** correct version detection in bundled package ([28c15a2](https://github.com/mrwogu/promptscript/commit/28c15a2622c92e99051854868a45825cbedf80cc))
+* **cli:** use universal migration hint instead of Claude Code specific ([ff2e731](https://github.com/mrwogu/promptscript/commit/ff2e731371840b95ed2378755ff431399903c3c2))
+
+## [1.0.0-alpha.8](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2026-01-30)
+
+
+### chore
+
+* prepare alpha release ([7b1fe19](https://github.com/mrwogu/promptscript/commit/7b1fe197b1ddc9b0fec87c407f557fbaa67113fd))
+
+## [1.0.0-alpha.7](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2026-01-28)
+
+
+### chore
+
+* prepare alpha release ([9f2f1ed](https://github.com/mrwogu/promptscript/commit/9f2f1ed61923048312206118ff1e0a10679f9899))
+
+
+### Features
+
+* **cli:** add registry manifest support for init command ([790ae31](https://github.com/mrwogu/promptscript/commit/790ae312bfef2cb80a74feb6ccbb334f15a3985b))
+
+## [1.0.0-alpha.6](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2026-01-28)
+
+
+### chore
+
+* prepare alpha release ([970c1c8](https://github.com/mrwogu/promptscript/commit/970c1c8c6bc2ebdc4a508314ce7c9c38ddc10a6d))
+
+
+### Features
+
+* **cli:** add --migrate flag to init command for AI-assisted migration ([3e567c6](https://github.com/mrwogu/promptscript/commit/3e567c606ddff779b841f76615a2aac93e35dec3))
+
+
+### Bug Fixes
+
+* **cli:** skip writing unchanged files during compilation ([8542512](https://github.com/mrwogu/promptscript/commit/854251214d927dd5f5dea0aea04a65e0f96819a2))
+
+## [1.0.0-alpha.5](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2026-01-27)
+
+
+### chore
+
+* prepare alpha release ([54696c9](https://github.com/mrwogu/promptscript/commit/54696c93e27cf9fc2f09dd730b09e568d0dc425e))
+
+
+### Features
+
+* **cli:** add AI-assisted migration skill and CLI integration ([53e9cca](https://github.com/mrwogu/promptscript/commit/53e9cca8669a30e787cbc2aa7679bb63f7896fce))
+* **cli:** add verbose and debug logging throughout compilation pipeline ([36bd63a](https://github.com/mrwogu/promptscript/commit/36bd63a2fa1dde1acbfd0794bb174f645ef71335))
+
+
+### Bug Fixes
+
+* **cli:** add migrationCandidates to test mocks ([d8fe117](https://github.com/mrwogu/promptscript/commit/d8fe117ff5523bb5b1c15996e00d8c24548c7b8f))
+* **cli:** extend marker detection from 10 to 20 lines ([229e9bc](https://github.com/mrwogu/promptscript/commit/229e9bc5bf4d0441c9674e6483a5125347b6f0b8))
+
+## [1.0.0-alpha.4](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2026-01-27)
+
+
+### ⚠ BREAKING CHANGES
+
+* **compiler:** Generated files now have compact marker instead of verbose header. Existing files with legacy marker still recognized.
+
+### chore
+
+* prepare alpha release ([8c3a428](https://github.com/mrwogu/promptscript/commit/8c3a428856bc088fb27a4fdd6a16185fe5e63589))
+
+
+### Features
+
+* **compiler:** add compact PromptScript marker to all outputs ([6d74480](https://github.com/mrwogu/promptscript/commit/6d744800a4ab38030b6c23b2ab949c79977ab12e))
+
+## [1.0.0-alpha.3](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2026-01-27)
+
+
+### chore
+
+* prepare alpha release ([8bb0fb2](https://github.com/mrwogu/promptscript/commit/8bb0fb2e643566af2fed08a5cd7bc17420c4dd96))
+
+
+### Features
+
+* **cli:** add file overwrite protection for prs compile ([9213a1d](https://github.com/mrwogu/promptscript/commit/9213a1d6edecff54333c65226a2ede8ff20ae417))
+* **formatting:** add dynamic Prettier configuration support ([c7ceca1](https://github.com/mrwogu/promptscript/commit/c7ceca13928df3449d3ac9f16b1c4749cc48dc2f))
+
+## [1.0.0-alpha.2](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2026-01-24)
+
+
+### chore
+
+* prepare alpha.2 release ([449fbcc](https://github.com/mrwogu/promptscript/commit/449fbccc119d34ab2a674cbfcd8cc4cc3012d108))
+
+
+### Bug Fixes
+
+* **cli:** resolve ESM dynamic require error for simple-git ([748a401](https://github.com/mrwogu/promptscript/commit/748a401377b5b58dff1935b94543f65f11f5360c))
+* **formatters:** read devCommands and postWork from [@knowledge](https://github.com/knowledge) block ([83a2727](https://github.com/mrwogu/promptscript/commit/83a272707bf3550142ae440f1a595657bb5704e9))
+* sync package.publish.json keywords and description ([ae7481f](https://github.com/mrwogu/promptscript/commit/ae7481fe64639420ba38fc98ea1349bca17cb91d))
+
 ## [1.0.0-alpha.1](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.1...v1.0.0-alpha.1) (2026-01-23)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # @promptscript/cli
 
-> Part of the [PromptScript](https://github.com/mrwogu/promptscript) ecosystem - The Infrastructure-as-Code for AI Context.
+> Part of the [PromptScript](https://github.com/mrwogu/promptscript) ecosystem - The Prompt-as-Code for AI Instructions.
 
 Command-line interface for PromptScript. Compile, validate, and manage AI instructions at enterprise scale.
 
@@ -8,16 +8,17 @@ Command-line interface for PromptScript. Compile, validate, and manage AI instru
 
 The CLI bundles all internal packages into a single distributable:
 
-```text
+```
 @promptscript/cli (published)
 │
-└─► bundles:
-    ├─► compiler
-    │   ├─► parser
-    │   ├─► resolver
-    │   ├─► validator
-    │   └─► formatters
-    └─► core
+├─► compiler (pipeline orchestration)
+│   ├─► resolver
+│   ├─► validator ─────► core
+│   └─► formatters ────► core
+│
+└─► resolver (inheritance & import resolution)
+    ├─► parser ────────► core
+    └───────────────────► core
 ```
 
 See the [PromptScript monorepo](https://github.com/mrwogu/promptscript) for development details.
@@ -66,11 +67,21 @@ Options:
   -w, --watch             Watch mode for continuous compilation (uses chokidar)
   -o, --output <dir>      Output directory
   --dry-run               Preview changes without writing files
+  --force                 Force overwrite existing files without prompts
   --registry <path>       Path or URL to registry
+  --verbose               Show detailed compilation progress
+  --debug                 Show debug information (includes verbose)
 ```
 
 **Watch Mode:** Uses [chokidar](https://github.com/paulmillr/chokidar) for reliable file watching across all platforms. Automatically recompiles when `.prs` files change.
 
+**Overwrite Protection:** By default, `prs compile` protects user-created files from accidental overwriting. Files generated by PromptScript contain a marker (`> Auto-generated by PromptScript`) and are overwritten silently. For files without this marker:
+
+- **Interactive mode:** You'll be prompted to overwrite (y/N/a)
+- **Non-interactive mode:** Compilation fails with a list of conflicting files
+
+Use `--force` to skip all prompts and overwrite everything. Use `--dry-run` to preview conflicts before writing.
+
 ### Validate
 
 ```bash
@@ -103,6 +114,42 @@ Options:
 
 By default, diff output is shown through a pager (`less`) for easy scrolling. Use `--no-pager` to disable this behavior. You can customize the pager via the `PAGER` environment variable.
 
+### Check for Updates
+
+```bash
+prs update-check
+```
+
+Checks if a newer version of the CLI is available on npm and displays the result:
+
+```
+@promptscript/cli v1.0.0
+✓ Up to date
+```
+
+Or if an update is available:
+
+```
+@promptscript/cli v1.0.0
+Update available: 1.0.0 → 1.1.0 (npm i -g @promptscript/cli)
+```
+
+**Automatic Update Checks:** The CLI automatically checks for updates once every 24 hours when running any command. The check is non-blocking and cached locally. To disable automatic checks, set the `PROMPTSCRIPT_NO_UPDATE_CHECK` environment variable:
+
+```bash
+PROMPTSCRIPT_NO_UPDATE_CHECK=1 prs compile
+```
+
+## Environment Variables
+
+| Variable                       | Description                                    |
+| ------------------------------ | ---------------------------------------------- |
+| `PROMPTSCRIPT_NO_UPDATE_CHECK` | Set to `1` to disable automatic update checks  |
+| `PROMPTSCRIPT_VERBOSE`         | Set to `1` to enable verbose output            |
+| `PROMPTSCRIPT_DEBUG`           | Set to `1` to enable debug output              |
+| `PAGER`                        | Custom pager for diff output (default: `less`) |
+| `NO_COLOR`                     | Set to disable colored output                  |
+
 ## Configuration
 
 Create a `promptscript.yaml` file: