@promptscript/cli 1.4.7 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptscript/cli",
-  "version": "1.4.7",
+  "version": "1.5.0",
   "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
   "keywords": [
     "cli",

package/skills/promptscript/SKILL.md

@@ -380,6 +380,40 @@ Import and merge fragments:
 @use @core/typescript as ts   # alias enables @extend access
 ```
 
+#### URL imports (Go-module style)
+
+Import directly from any Git repository by host path - no alias required:
+
+```
+@use github.com/acme/shared-standards/@fragments/security
+@use gitlab.com/myorg/prompts/@stacks/python
+```
+
+Version pinning with `@`:
+
+```
+@use github.com/acme/shared-standards/@org/base@1.2.0    # exact version
+@use github.com/acme/shared-standards/@org/base@^1.0.0   # semver range
+@use github.com/acme/shared-standards/@org/base@main     # branch
+```
+
+#### Registry aliases
+
+Short names for Git repository URLs, configured in `promptscript.yaml`:
+
+```yaml
+registries:
+  company:
+    url: github.com/acme/promptscript-registry
+```
+
+Then use the alias as scope prefix:
+
+```
+@use @company/security
+@inherit @company/base-config
+```
+
 Merge rules:
 
 - Text: concatenated with deduplication
@@ -409,7 +443,7 @@ passed from one `.prs` file to another through `@inherit` or `@use`.
 **Step 1: Create the template** (parent file with `params` in `@meta`):
 
 ```
-# base.prs — reusable template
+# base.prs - reusable template
 @meta {
   id: "service-template"
   syntax: "1.0.0"
@@ -429,7 +463,7 @@ passed from one `.prs` file to another through `@inherit` or `@use`.
 **Step 2: Inherit with values** (child file passes params):
 
 ```
-# project.prs — concrete project
+# project.prs - concrete project
 @meta { id: "user-api" syntax: "1.0.0" }
 
 @inherit ./base(serviceName: "user-api", port: 8080)
@@ -447,7 +481,7 @@ The same works with `@use`:
 Optional params use `?` suffix. Defaults use `= value`.
 Missing required params produce a compile error.
 
-**Multi-service pattern** — reuse one template across many projects:
+**Multi-service pattern** - reuse one template across many projects:
 
 ```
 services/
@@ -492,20 +526,73 @@ targets:
 registry:
   git: https://github.com/org/registry.git
   ref: main
+registries:
+  company:
+    url: github.com/acme/promptscript-registry
+  oss:
+    url: github.com/prscrpt/community-registry
+    ref: v2
+```
+
+### Lockfile: `promptscript.lock`
+
+When remote imports are used, `prs compile` automatically generates a lockfile
+recording the exact resolved commit for each dependency. This enables reproducible
+builds across machines and CI. Commit `promptscript.lock` to version control.
+
+## Syntax Version Validation
+
+The `syntax` field in `@meta` declares the PromptScript language version (semver).
+
+### Known Versions
+
+| Version | What it adds                                                                                                            |
+| ------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `1.0.0` | Core blocks (identity, context, standards, restrictions, knowledge, shortcuts, commands, guards, params, skills, local) |
+| `1.1.0` | Adds `@agents` (plus internal `@workflows`, `@prompts` - not user-facing)                                               |
+
+### Validation Rules
+
+- **PS018 (`syntax-version-compat`)**: warns when blocks used in a file require a higher syntax version than declared. For example, `@agents` with `syntax: "1.0.0"` triggers PS018. Suggestion: run `prs validate --fix`.
+- **PS019 (`unknown-block-name`)**: warns when a block name is not a known PromptScript type, with fuzzy-match suggestions for typos.
+
+### Fixing Syntax Versions
+
+```
+prs validate --fix          # Auto-fix syntax versions in .prs files
+prs upgrade                 # Upgrade all .prs files to the latest version
 ```
 
+`--fix` rewrites the `syntax: "..."` line in each file's `@meta` block to match the minimum version required by the blocks used. It only upgrades, never downgrades.
+
+`prs upgrade` upgrades all files to the latest known syntax version regardless of what blocks they use.
+
 ## CLI Commands
 
 ```
-prs init                    # Initialize project
-prs init --migrate          # Initialize + migration skills
+prs init                    # Initialize project (auto-detects existing files)
+prs init --auto-import      # Initialize + static import of existing files
+prs migrate                 # Interactive migration flow
+prs migrate --static        # Non-interactive static import
+prs migrate --llm           # Generate AI-assisted migration prompt
 prs compile                 # Compile to all targets
 prs compile --watch         # Watch mode
 prs validate --strict       # Validate syntax
+prs validate --fix          # Auto-fix syntax version declarations
+prs upgrade                 # Upgrade all .prs files to latest syntax version
 prs import CLAUDE.md        # Import existing AI instructions
 prs import --dry-run        # Preview import conversion
 prs pull                    # Update registry
 prs diff --target claude    # Show compilation diff
+prs lock                    # Generate/update promptscript.lock
+prs lock --dry-run          # Preview lockfile changes
+prs update                  # Re-resolve all remote imports to latest
+prs update <url>            # Update a specific registry
+prs vendor sync             # Copy cached deps to .promptscript/vendor/
+prs vendor check            # Verify vendor matches lockfile
+prs resolve @alias/path     # Debug: show how an import resolves
+prs registry list           # Show configured registries and aliases
+prs registry add <alias> <url>  # Add a registry alias
 ```
 
 ## Output Targets
@@ -533,7 +620,7 @@ prs diff --target claude    # Show compilation diff
 For detailed information about each formatter's output paths, supported features, quirks, and example outputs:
 
 - **Full formatter reference:** `docs/reference/formatters/` (7 dedicated pages + index of all 37)
-- **llms-full.txt:** Available at the docs site root — contains all documentation in a single file for LLM consumption
+- **llms-full.txt:** Available at the docs site root - contains all documentation in a single file for LLM consumption
 - **Dedicated pages exist for:** Claude Code, GitHub Copilot, Cursor, Antigravity, Factory AI, Gemini CLI, OpenCode
 - **All 37 formatters indexed at:** `docs/reference/formatters/index.md` with output paths, tier, and feature flags
 

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAyJA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CAEvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAsNA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CAEvD"}

package/src/commands/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/compile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAsXzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA0Hf"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/compile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAyYzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAoKf"}

package/src/commands/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmG/C;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFrE"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsG/C;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFrE"}

package/src/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAmBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AA+CvC;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAmLf;AA8SD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAM7D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAoBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,+BAA+B,CAAC;AAkDvC;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyLf;AAifD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAM7D"}

package/src/commands/lock.d.ts

@@ -0,0 +1,16 @@
+import type { LockOptions } from '../types.js';
+/** Path to the lockfile relative to cwd. */
+export declare const LOCKFILE_PATH = "promptscript.lock";
+/**
+ * Generate or update promptscript.lock by resolving all remote imports.
+ *
+ * This command collects all registry aliases configured in the project and
+ * global config, then writes a lockfile that pins each dependency to a
+ * resolved version and commit hash for reproducible builds.
+ *
+ * NOTE: Full remote resolution (actual git fetching) requires the registry
+ * resolver pipeline. This implementation records the configured aliases as
+ * pending dependencies and preserves any previously-resolved entries.
+ */
+export declare function lockCommand(options: LockOptions): Promise<void>;
+//# sourceMappingURL=lock.d.ts.map

package/src/commands/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/lock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,4CAA4C;AAC5C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ErE"}

package/src/commands/migrate.d.ts

@@ -0,0 +1,11 @@
+import type { MigrateOptions } from '../types.js';
+import { type CliServices } from '../services.js';
+/**
+ * prs migrate -- alias/shortcut to init migration path.
+ * Delegates to initCommand with appropriate flags.
+ *
+ * When promptscript.yaml already exists, force: true allows
+ * initCommand to re-enter and run migration-only flow.
+ */
+export declare function migrateCommand(options: MigrateOptions, services?: CliServices): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/src/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/migrate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/src/commands/registry/add.d.ts

@@ -0,0 +1,6 @@
+import type { RegistryAddOptions } from '../../types.js';
+/**
+ * Add a registry alias to the project or global config.
+ */
+export declare function registryAddCommand(alias: string, url: string, options: RegistryAddOptions): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/src/commands/registry/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/add.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/src/commands/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA2BhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAsChE"}

package/src/commands/registry/list.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Show merged registry alias mappings from all config levels.
+ * Project config overrides user (global) config — last write wins.
+ */
+export declare function registryListCommand(): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/src/commands/registry/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/list.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiEzD"}

package/src/commands/resolve-cmd.d.ts

@@ -0,0 +1,9 @@
+import type { ResolveCommandOptions } from '../types.js';
+/**
+ * Debug command: show the full resolution chain for an import path.
+ *
+ * Prints alias expansion, repo URL, version from lockfile, cache location,
+ * and resolved file type without performing any network operations.
+ */
+export declare function resolveCommand(importPath: string, _options: ResolveCommandOptions): Promise<void>;
+//# sourceMappingURL=resolve-cmd.d.ts.map

package/src/commands/resolve-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cmd.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/resolve-cmd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AASzD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgGf"}

package/src/commands/update.d.ts

@@ -0,0 +1,13 @@
+import type { UpdateOptions } from '../types.js';
+/**
+ * Re-resolve versions (ignoring current lockfile pins) and update promptscript.lock.
+ *
+ * When a package argument is provided, only that dependency is updated.
+ * Otherwise all dependencies are re-resolved.
+ *
+ * NOTE: Full remote resolution requires the registry resolver pipeline.
+ * This implementation updates the lockfile structure and shows before/after
+ * version info from the existing lockfile.
+ */
+export declare function updateCommand(packageArg: string | undefined, options: UpdateOptions): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/src/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/update.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOjD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAqGf"}

package/src/commands/upgrade.d.ts

@@ -0,0 +1,8 @@
+export interface UpgradeOptions {
+    dryRun?: boolean;
+}
+/**
+ * Upgrade all .prs files to the latest syntax version.
+ */
+export declare function upgradeCommand(options: UpgradeOptions): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/src/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/upgrade.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC3E"}

package/src/commands/validate.d.ts

@@ -1,4 +1,13 @@
 import type { ValidateOptions } from '../types.js';
+/**
+ * Replace syntax version within the @meta block only.
+ * Returns the modified content, or null if no change needed.
+ */
+export declare function fixSyntaxVersion(content: string, currentVersion: string, targetVersion: string): string | null;
+/**
+ * Recursively discover all .prs files in a directory.
+ */
+export declare function discoverPrsFiles(dir: string): string[];
 /**
  * Validate PromptScript files without generating output.
  */

package/src/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA2InD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD7E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA6InD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CA+Bf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBtD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+D7E"}

package/src/commands/vendor.d.ts

@@ -0,0 +1,14 @@
+import type { VendorSyncOptions, VendorCheckOptions } from '../types.js';
+/**
+ * Copy all cached dependencies to .promptscript/vendor/.
+ *
+ * Reads promptscript.lock to determine which repos are pinned, then copies
+ * the cached content (from ~/.promptscript/cache/) to the vendor directory
+ * for offline / CI builds.
+ */
+export declare function vendorSyncCommand(options: VendorSyncOptions): Promise<void>;
+/**
+ * Verify that the vendor directory matches the lockfile.
+ */
+export declare function vendorCheckCommand(_options: VendorCheckOptions): Promise<void>;
+//# sourceMappingURL=vendor.d.ts.map

package/src/commands/vendor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/vendor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAYzE;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEjF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDpF"}

package/src/types.d.ts

@@ -20,6 +20,24 @@ export interface InitOptions {
     force?: boolean;
     /** Install migration skill for AI-assisted migration */
     migrate?: boolean;
+    /** Non-interactive static import of detected files (--auto-import) */
+    autoImport?: boolean;
+    /** Create backup before migration */
+    backup?: boolean;
+    /** Internal: force migrate flow (used by prs migrate) */
+    _forceMigrate?: boolean;
+    /** Internal: force LLM flow (used by prs migrate --llm) */
+    _forceLlm?: boolean;
+    /** Internal: specific files to migrate (used by prs migrate --files) */
+    _migrateFiles?: string[];
+}
+/**
+ * Options for the migrate command.
+ */
+export interface MigrateOptions {
+    static?: boolean;
+    llm?: boolean;
+    files?: string[];
 }
 /**
  * Options for the compile command.
@@ -43,6 +61,8 @@ export interface CompileOptions {
     config?: string;
     /** Force overwrite existing files without prompts */
     force?: boolean;
+    /** Treat output path conflicts as errors */
+    strict?: boolean;
     /** Working directory (project root) */
     cwd?: string;
 }
@@ -54,6 +74,8 @@ export interface ValidateOptions {
     strict?: boolean;
     /** Output format (text, json) */
     format?: 'text' | 'json';
+    /** Auto-fix syntax version issues */
+    fix?: boolean;
 }
 /**
  * Options for the pull command.
@@ -131,4 +153,42 @@ export interface RegistryPublishOptions {
     /** Git tag for release */
     tag?: string;
 }
+/**
+ * Options for the registry add command.
+ */
+export interface RegistryAddOptions {
+    /** Add to global user config instead of project config */
+    global?: boolean;
+}
+/**
+ * Options for the lock command.
+ */
+export interface LockOptions {
+    /** Preview without writing lockfile */
+    dryRun?: boolean;
+}
+/**
+ * Options for the update command.
+ */
+export interface UpdateOptions {
+    /** Preview without writing lockfile */
+    dryRun?: boolean;
+}
+/**
+ * Options for the vendor sync command.
+ */
+export interface VendorSyncOptions {
+    /** Preview without copying files */
+    dryRun?: boolean;
+}
+/**
+ * Options for the vendor check command.
+ */
+export interface VendorCheckOptions {
+}
+/**
+ * Options for the resolve command.
+ */
+export interface ResolveCommandOptions {
+}
 //# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/types.ts"],"names":[],"mappings":"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"}

package/src/utils/ai-tools-detector.d.ts

@@ -1,8 +1,19 @@
+import { type DetectedFormat } from '@promptscript/importer';
 import { type CliServices } from '../services.js';
 /**
  * AI tool target identifier — corresponds to a registered formatter name.
  */
 export type AIToolTarget = string;
+/**
+ * Enriched migration candidate with metadata about the instruction file.
+ */
+export interface MigrationCandidate {
+    path: string;
+    format: DetectedFormat;
+    sizeBytes: number;
+    sizeHuman: string;
+    toolName: string;
+}
 /**
  * AI tool detection result.
  */
@@ -12,7 +23,7 @@ export interface AIToolsDetection {
     /** Details about detected files */
     details: Record<string, string[]>;
     /** Files that exist but were NOT generated by PromptScript (candidates for migration) */
-    migrationCandidates: string[];
+    migrationCandidates: MigrationCandidate[];
 }
 /**
  * Detect existing AI tool configurations.

package/src/utils/ai-tools-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools-detector.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/ai-tools-detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAkKD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAQ/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAiBzE"}
+{"version":3,"file":"ai-tools-detector.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/ai-tools-detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,yFAAyF;IACzF,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C;AAiMD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAoD3B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAQ/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkB5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAiBzE"}

package/src/utils/backup.d.ts

@@ -0,0 +1,8 @@
+import type { CliServices } from '../services.js';
+export interface BackupResult {
+    dir: string;
+    files: string[];
+}
+export declare function isGitRepo(services: CliServices): boolean;
+export declare function createBackup(filePaths: string[], services: CliServices): Promise<BackupResult>;
+//# sourceMappingURL=backup.d.ts.map

package/src/utils/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/backup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/src/utils/clipboard.d.ts

@@ -0,0 +1,2 @@
+export declare function copyToClipboard(text: string): boolean;
+//# sourceMappingURL=clipboard.d.ts.map

package/src/utils/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/clipboard.ts"],"names":[],"mappings":"AAWA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAarD"}

package/src/utils/conflict-detector.d.ts

@@ -0,0 +1,10 @@
+import type { TargetConfig } from '@promptscript/core';
+/**
+ * Detect output path conflicts: multiple targets writing to the same file.
+ * Returns a map of conflicting paths to the list of target names that write to them.
+ */
+export declare function detectOutputConflicts(targets: {
+    name: string;
+    config?: TargetConfig;
+}[]): Map<string, string[]>;
+//# sourceMappingURL=conflict-detector.d.ts.map

package/src/utils/conflict-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/conflict-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,EAAE,GACjD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAiBvB"}

package/src/utils/markers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PromptScript generation marker utilities.
+ *
+ * Markers are added to compiled output files so the compiler can identify
+ * files it previously generated. These utilities strip markers before
+ * content comparison to avoid false diffs from timestamp-only changes.
+ */
+/**
+ * Strip PromptScript generation markers from content for comparison purposes.
+ * This allows comparing actual content changes while ignoring timestamp updates.
+ *
+ * Regex literals are inlined to avoid stateful module-level RegExp objects
+ * with the `g` flag (which maintain a `lastIndex` cursor between calls).
+ */
+export declare function stripMarkers(content: string): string;
+//# sourceMappingURL=markers.d.ts.map

package/src/utils/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/markers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/src/utils/migration-prompt.d.ts

@@ -0,0 +1,7 @@
+export interface MigrationPromptInput {
+    path: string;
+    sizeHuman: string;
+    toolName: string;
+}
+export declare function generateMigrationPrompt(candidates: MigrationPromptInput[]): string;
+//# sourceMappingURL=migration-prompt.d.ts.map

package/src/utils/migration-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-prompt.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/migration-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAyBlF"}