@promptscript/cli 1.18.1 → 1.19.1

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.
Files changed (25) hide show
  1. package/README.md +26 -6
  2. package/index.js +2134 -591
  3. package/package.json +5 -5
  4. package/skills/promptscript/SKILL.md +12 -5
  5. package/src/cli.d.ts.map +1 -1
  6. package/src/commands/compile.d.ts.map +1 -1
  7. package/src/commands/init.d.ts.map +1 -1
  8. package/src/commands/lock-scanner.d.ts +2 -2
  9. package/src/commands/lock-scanner.d.ts.map +1 -1
  10. package/src/commands/lock.d.ts.map +1 -1
  11. package/src/commands/resolve-cmd.d.ts.map +1 -1
  12. package/src/commands/skills.d.ts +27 -5
  13. package/src/commands/skills.d.ts.map +1 -1
  14. package/src/config/merge-config.d.ts.map +1 -1
  15. package/src/types.d.ts +10 -0
  16. package/src/types.d.ts.map +1 -1
  17. package/src/utils/global-output-safety.d.ts +12 -0
  18. package/src/utils/global-output-safety.d.ts.map +1 -0
  19. package/src/utils/managed-output-cleanup.d.ts.map +1 -1
  20. package/src/utils/output-ownership.d.ts +1 -1
  21. package/src/utils/output-ownership.d.ts.map +1 -1
  22. package/src/utils/registry-resolver.d.ts +2 -0
  23. package/src/utils/registry-resolver.d.ts.map +1 -1
  24. package/src/utils/resource-filter.d.ts +35 -0
  25. package/src/utils/resource-filter.d.ts.map +1 -0
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  **Agent platform configuration as code**
6
6
 
7
7
  Define instructions, skills, agents, MCP servers, hooks, workflows, and policies once. Compile
8
- native configuration for 49 AI coding platforms.
8
+ native configuration for 50 AI coding platforms.
9
9
 
10
10
  [![npm version](https://img.shields.io/npm/v/@promptscript/cli.svg)](https://www.npmjs.com/package/@promptscript/cli)
11
11
  [![CI](https://github.com/mrwogu/promptscript/actions/workflows/ci.yml/badge.svg)](https://github.com/mrwogu/promptscript/actions/workflows/ci.yml)
@@ -20,9 +20,19 @@ native configuration for 49 AI coding platforms.
20
20
 
21
21
  [![Watch the PromptScript introduction](https://img.youtube.com/vi/7sHMn-DbZig/maxresdefault.jpg)](https://youtu.be/7sHMn-DbZig)
22
22
 
23
- AI coding platforms use different files for instructions, skills, agents, commands, MCP
24
- integrations, hooks, and settings. PromptScript replaces hand-maintained copies with one validated,
25
- composable, Git-native source and target-specific compilers.
23
+ ## What is PromptScript?
24
+
25
+ PromptScript is an open-source language and compiler for AI agent configuration. `.prs` sources
26
+ define instructions, project standards, restrictions, skills, agents, MCP servers, hooks, and
27
+ workflows, while `promptscript.yaml` configures targets and extension-compliance policies.
28
+ PromptScript compiles them into the native files each AI tool already reads, including `CLAUDE.md`,
29
+ `.github/copilot-instructions.md`, `.cursor/rules`, and output for 47 more targets.
30
+
31
+ Every AI coding tool uses its own file names, formats, and paths. Teams using several tools end up
32
+ maintaining several copies of the same rules. Those copies drift, and a change made for one tool may
33
+ never reach the others.
34
+
35
+ PromptScript fixes the source instead of patching each generated file:
26
36
 
27
37
  ```text
28
38
  .promptscript/project.prs
@@ -33,6 +43,16 @@ composable, Git-native source and target-specific compilers.
33
43
 
34
44
  No runtime proxy. Each selected platform keeps consuming its own native configuration.
35
45
 
46
+ ## Why maintain native files by hand?
47
+
48
+ Even a few tools create copies that need the same manual updates. Errors stay hidden until an agent
49
+ reads the broken file. Policy changes become separate edits across every repository and tool.
50
+
51
+ With PromptScript, you change one source, review the generated diff, and validate it in CI. Git
52
+ records each change. Remote dependencies stay pinned in `promptscript.lock`, so builds remain
53
+ reproducible. Adding or switching tools does not require rewriting the source. See the
54
+ [full comparison](https://getpromptscript.dev/guides/vs-manual/).
55
+
36
56
  ## Install
37
57
 
38
58
  Requires Node.js 20 or later.
@@ -206,7 +226,7 @@ unsupported platform-specific features.
206
226
  | Automation | `@hooks`, `@workflows` | Lifecycle hooks and repeatable workflow files |
207
227
  | Monorepo delivery | `builds` in `promptscript.yaml` | Scoped output for packages and applications |
208
228
 
209
- ## 49 Built-In Targets
229
+ ## 50 Built-In Targets
210
230
 
211
231
  | Platform | Primary and rich output |
212
232
  | :------------- | :--------------------------------------------------------------- |
@@ -220,7 +240,7 @@ unsupported platform-specific features.
220
240
  | Antigravity | `.agent/rules/`, workflows and MCP configuration |
221
241
  | Grok | `AGENTS.md`, agents, skills, commands and integrations |
222
242
 
223
- PromptScript also supports 11 AGENTS.md targets and 29 Markdown instruction targets, including
243
+ PromptScript also supports 11 AGENTS.md targets and 30 Markdown instruction targets, including
224
244
  Windsurf, Cline, Roo Code, Continue, Aider, Amazon Q, Warp, Zed, OpenHands, Qwen Code, Kimi, Mimo,
225
245
  Deep Agents, ForgeCode, and Hermes Agent.
226
246