@promptscript/cli 1.15.0 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptscript/cli",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
   "keywords": [
     "cli",
@@ -41,18 +41,18 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "chalk": "^5.6.2",
+    "chalk": "^6.0.0",
     "chokidar": "^5.0.0",
     "commander": "^15.0.0",
-    "minimatch": "^10.2.5",
-    "ora": "^9.4.0",
-    "prettier": "^3.8.4",
+    "minimatch": "^10.2.6",
+    "ora": "^9.4.1",
+    "prettier": "^3.9.6",
     "yaml": "^2.9.0",
     "simple-git": "3.36.0",
-    "fastify": "^5.8.5",
-    "@fastify/cors": "^11.0.0",
-    "@fastify/websocket": "^11.0.0",
-    "ws": "^8.21.0",
+    "fastify": "^5.11.2",
+    "@fastify/cors": "^11.3.0",
+    "@fastify/websocket": "^11.3.0",
+    "ws": "^8.21.2",
     "fast-glob": "^3.3.0"
   }
 }

package/skills/promptscript/SKILL.md

@@ -6,7 +6,8 @@ description: >-
   creating or editing .prs files, adding blocks like @identity, @standards,
   @restrictions, @shortcuts, @skills, or @agents, configuring
   promptscript.yaml, resolving compilation errors, understanding inheritance
-  (@inherit) and composition (@use, @extend), or migrating AI instructions
+  (@inherit), composition (@use, @extend, @override), contextual @header
+  metadata, or migrating AI instructions
   to PromptScript. Also use when asked about the 48 built-in compilation
   targets, including GitHub Copilot, Claude Code, Cursor, Antigravity,
   Factory AI, and AGENTS.md-based platforms.
@@ -48,7 +49,9 @@ PromptScript is a domain-specific language that compiles `.prs` files into nativ
 
 ## File Structure
 
-A `.prs` file is made of blocks. Order doesn't matter except `@meta` should come first by convention.
+A `.prs` file contains ordered declarations. Syntax `1.5.0` applies `@inherit`,
+`@use`, local blocks, `@extend`, and `@override` in source order. Put `@meta`
+first.
 
 ```
 # Comments start with #
@@ -65,17 +68,25 @@ A `.prs` file is made of blocks. Order doesn't matter except `@meta` should come
 @knowledge { ... }      # Reference documentation
 @skills { ... }         # Reusable skill definitions
 @agents { ... }         # Subagent definitions
+@workflows { ... }      # Repeatable agent procedures
 @examples { ... }       # Few-shot input/output examples (syntax 1.2.0+)
 @params { ... }         # Template parameters
 @guards { ... }         # File globs and priorities
+@hooks { ... }          # Portable lifecycle hooks (syntax 1.4.0+)
+@mcpServers { ... }     # MCP server configurations (syntax 1.4.0+)
+@plugins { ... }        # Capability bundles (syntax 1.4.0+)
 @local { ... }          # Private config (not committed)
 @extend path { ... }    # Modify imported blocks
+@override path { ... }  # Replace one complete existing target (syntax 1.5.0+)
 @custom-name { ... }    # Arbitrary named blocks
 ```
 
+Contextual `@header` entries appear inside supported owner blocks, not at the
+top level.
+
 ## Content Types
 
-PromptScript has three content types inside blocks:
+PromptScript has four canonical content shapes inside blocks:
 
 ### Text Content
 
@@ -166,6 +177,29 @@ Category-based conventions. Any category name is valid:
 }
 ```
 
+Category names are arbitrary. `@standards` can also contain free-form text:
+
+```
+@standards {
+  """
+  ## Formatting
+  Preserve heading structure and use four-space indentation.
+
+  ## Testing
+  Add regression coverage for every behavior change.
+  """
+  typescript: ["Strict mode", "Named exports only"]
+  git: {
+    format: "Conventional Commits"
+  }
+}
+```
+
+Free-form text is dedented and rendered with its Markdown heading structure. Factory
+monolith output nests it under `Conventions & Patterns`; split Factory rules adjust
+heading levels relative to the generated section. Custom structured categories remain
+available to formatters that support them.
+
 ### @restrictions
 
 Hard rules as a list of dash-prefixed strings:
@@ -365,6 +399,26 @@ Factory AI droids support additional properties: `model` (any model ID or "inher
 `reasoningEffort` ("low", "medium", "high"), and `tools` (category name like "read-only"
 or array of tool IDs).
 
+### @workflows
+
+Repeatable multi-step agent procedures. Requires syntax `1.1.0`.
+
+```
+@workflows {
+  release: {
+    description: "Prepare a validated release"
+    content: """
+      1. Run formatting, linting, type checks, and tests.
+      2. Validate compiled output.
+      3. Stop before publishing and request approval.
+    """
+  }
+}
+```
+
+Targets with native workflow discovery emit dedicated workflow files. Other targets
+retain workflow instructions in their main output when supported.
+
 ### @examples
 
 Structured few-shot examples for AI assistants (requires syntax `1.2.0`):
@@ -418,6 +472,141 @@ Optional parameters use `?` suffix. Defaults use `= value`.
 
 File glob patterns and priority rules for path-specific instructions.
 
+### @hooks
+
+Portable lifecycle hooks. Requires syntax `1.4.0`. Each hook needs exactly one of
+`command` or `script`.
+
+```
+@hooks {
+  validate-types: {
+    event: "post-tool-use"
+    matcher: "Edit|Write"
+    script: {
+      path: ".promptscript/scripts/validate.py"
+      interpreter: "python3"
+      args: ["--strict"]
+    }
+    cwd: "project"
+    timeoutMs: 120000
+    statusMessage: "Checking TypeScript"
+    continueOnFailure: false
+    enabled: true
+    targets: {
+      factory: { matcher: "Execute" }
+      vscode: { matcher: "run_in_terminal" }
+      github: { enabled: false }
+    }
+  }
+}
+```
+
+Portable events:
+
+| Event                  | Meaning                   |
+| ---------------------- | ------------------------- |
+| `pre-terminal-command` | Before a terminal command |
+| `pre-tool-use`         | Before a tool invocation  |
+| `post-tool-use`        | After a tool invocation   |
+| `session-start`        | Agent session start       |
+| `setup`                | Session setup             |
+| `subagent-start`       | Subagent start            |
+| `notification`         | Agent notification        |
+| `stop`                 | Agent stop                |
+
+`command` is a non-empty string array. Shell interpolation (`$()`, backticks,
+`${...}`) is forbidden. `script` requires:
+
+- `path` under `.promptscript/scripts/`, using forward slashes.
+- Existing regular file at compile time.
+- No traversal, absolute path, invalid segment, or symlink escape.
+- Explicit interpreter: `python3`, `python`, `node`, `deno`, `bun`, `ruby`, `php`,
+  `perl`, `bash`, `sh`, `zsh`, `pwsh`, or `powershell`.
+- Optional `args` string array; each argument remains one argument.
+
+`cwd: "project"` runs from project root. Other values are portable forward-slash
+paths relative to project root. Hook config file location does not set command cwd.
+Environment-root and Git-root wrappers exit before script or command execution when
+the required root is unavailable. Native-cwd and workspace-cwd targets retain host
+cwd fields and report `PS4002` when PromptScript cannot verify that cwd.
+`timeoutMs` range is 100-600000. `matcher` uses target-native tool names, so a
+matcher valid for one target may match nothing on another.
+
+`pre-terminal-command` supplies native defaults: Factory `Execute`, Claude and
+Codex `Bash`, Windsurf `pre_run_command`, Cursor `run_terminal_cmd`, Gemini
+`run_shell_command`, and VS Code `run_in_terminal`. Override a native tool name
+with `targets.<name>.matcher`. Cursor, Gemini, and VS Code report best-effort
+`PS4002` warnings. GitHub and Grok omit the event with `PS4002`.
+
+Target overrides may change `event`, `matcher`, `timeoutMs`, `statusMessage`,
+`continueOnFailure`, `enabled`, or `cwd`. Native hook files are emitted only in
+target modes that support additional files:
+
+| Target         | Hook output                                                            | Mode                |
+| -------------- | ---------------------------------------------------------------------- | ------------------- |
+| Claude Code    | `.claude/settings.json`                                                | `full`              |
+| Factory AI     | `.factory/hooks.json`                                                  | `multifile`, `full` |
+| GitHub Copilot | `.github/hooks/promptscript.json`                                      | `multifile`, `full` |
+| Cursor         | `.cursor/hooks.json`                                                   | `full`              |
+| Codex          | `.codex/hooks.json`                                                    | `multifile`, `full` |
+| Gemini CLI     | `.gemini/settings.json`                                                | `multifile`, `full` |
+| Windsurf       | `.windsurf/hooks.json`                                                 | `multifile`, `full` |
+| Grok Build     | `.grok/hooks/promptscript.json`                                        | `full`              |
+| VS Code Agent  | `.github/hooks/promptscript-vscode.json` when `vscode` override exists | target-specific     |
+
+Simple mode and targets without native project hooks report `PS4002` instead of
+silently dropping hooks. Use `prs compile --watch` as fallback. Plugin-only and
+agent-scoped integrations are not emitted as universal project hooks.
+
+Each generated command carries a PromptScript ownership marker. CLI cleanup removes
+only marked entries and preserves user hooks/settings. Removing `@hooks` removes a
+fully owned generated hook file and prunes directories left empty. `prs hooks install factory`
+migrates unambiguous legacy hooks from `.factory/settings.json`; ambiguous
+entries remain for manual review.
+
+Factory compilation performs the same migration when `.factory/hooks.json` is
+absent. Use `prs compile --dry-run` to preview the changes or
+`--no-migrate-factory-hooks` to keep warning-only behavior. Unknown events,
+malformed entries, and mixed ownership abort without a partial migration.
+
+`@hooks` compilation is separate from `prs hooks install`. The latter installs
+auto-compilation and generated-output protection for supported AI tools. Copilot VS
+Code Agent hooks use `promptscript-vscode.json`; GitHub Copilot repository hooks use
+`promptscript.json`.
+
+### @mcpServers
+
+Project-local Model Context Protocol servers. Requires syntax `1.4.0`.
+
+```
+@mcpServers {
+  issue-tracker: {
+    transport: "stdio"
+    command: ["node", "./tools/issues.mjs"]
+    env: { LOG_LEVEL: "info" }
+  }
+}
+```
+
+Use `stdio` with `command`, or `http`/`sse` with `url`. Keep credentials out of
+`.prs` files and provide them through target-native secret management.
+
+### @plugins
+
+Portable capability bundles. Requires syntax `1.4.0`.
+
+```
+@plugins {
+  security-suite: {
+    description: "Security review tooling"
+    version: "1.0.0"
+    skills: ["security-review"]
+    hooks: ["validate-types"]
+    mcpServers: ["issue-tracker"]
+  }
+}
+```
+
 ### @local
 
 Private local configuration. Not included in compiled output or committed to git.
@@ -482,8 +671,12 @@ Then use the alias as scope prefix:
 Merge rules:
 
 - Text: concatenated with deduplication
-- Objects: deep merged (target wins on conflicts)
+- Objects: deep merged (imported source wins same-shape conflicts)
 - Arrays: unique concatenation
+- Shape mismatch: existing target body wins
+
+Under syntax `1.5.0`, later local blocks, `@extend`, and `@override`
+operations apply to the accumulated import result in declaration order.
 
 ### Block Filtering
 
@@ -565,16 +758,38 @@ Replacement works after `@inherit` and `@use`, including aliases and nested targ
 A missing field is set. The modifier is rejected for `@skills`, which retain their dedicated
 merge and sealing semantics.
 
+#### Replacing complete targets with @override
+
+Syntax `1.5.0` adds atomic replacement for an existing block or nested value:
+
+```
+@meta { id: "project" syntax: "1.5.0" }
+
+@standards {
+  testing: ["Use Jest", "Use Mocha"]
+}
+
+@override standards.testing {
+  ["Use Vitest"]
+}
+```
+
+`@override` requires the complete target path to exist, applies in declaration
+order, and cannot bypass sealed skill properties. Later `@extend` declarations
+merge into the replacement. Use `@extend` for additive changes, `field!` for
+compatibility replacement of one direct regular field, and `@override` for
+intentional complete replacement.
+
 #### Skill-aware @extend semantics
 
 When extending a skill definition via `@extend`, individual skill properties follow specific merge
 strategies rather than the generic block merge rules:
 
-| Strategy          | Properties                                                                                         |
-| ----------------- | -------------------------------------------------------------------------------------------------- |
-| **Replace**       | content, description, trigger, userInvocable, allowedTools, disableModelInvocation, context, agent |
-| **Append**        | references, examples, requires                                                                     |
-| **Shallow merge** | params, inputs, outputs                                                                            |
+| Strategy          | Properties                                                                                                  |
+| ----------------- | ----------------------------------------------------------------------------------------------------------- |
+| **Replace**       | content, description, trigger, userInvocable, allowedTools, disableModelInvocation, context, agent, license |
+| **Append**        | references, examples, requires                                                                              |
+| **Shallow merge** | params, inputs, outputs                                                                                     |
 
 Example — extending a base skill to add references and override content:
 
@@ -771,11 +986,11 @@ policies:
 
 ### Lockfile: `promptscript.lock`
 
-When remote imports are used, `prs compile` automatically generates a lockfile
-recording the exact resolved commit for each dependency. Integrity hashes
-(SHA-256) are included for registry references to detect tampering or drift.
-This enables reproducible builds across machines and CI. Commit `promptscript.lock`
-to version control.
+When remote imports are used, run `prs lock` to generate or update the lockfile
+before compilation. It records the exact resolved commit for each dependency.
+Integrity hashes (SHA-256) are included for registry references to detect
+tampering or drift. This enables reproducible builds across machines and CI.
+Commit `promptscript.lock` to version control.
 
 Use `--ignore-hashes` on `prs compile` or `prs validate` to skip integrity
 hash verification when needed.
@@ -824,6 +1039,7 @@ The `syntax` field in `@meta` declares the PromptScript language version (semver
 | `1.2.0` | Adds `@examples` (few-shot input/output pairs)                                                                          |
 | `1.3.0` | Adds explicit regular block field replacement in `@extend`                                                              |
 | `1.4.0` | Adds `@hooks`, `@mcpServers`, and `@plugins`                                                                            |
+| `1.5.0` | Adds `@header` section titles, `@override` replacement, and unquoted `${VAR}` values                                    |
 
 ### Block Version Requirements
 
@@ -838,11 +1054,40 @@ The `syntax` field in `@meta` declares the PromptScript language version (semver
 
 All other built-in blocks are available from `1.0.0`.
 Regular block field replacement with `field!: value` requires syntax `1.3.0`.
+Generated section title overrides with `@header` require syntax `1.5.0`.
+Atomic replacement with `@override` requires syntax `1.5.0`.
+Unquoted `${VAR}` references as values require syntax `1.5.0`.
+
+### Generated Section Headers
+
+Use `@header` inside a registered owner block to rename human-readable output
+sections without changing filenames, frontmatter, XML tags, or structured keys:
+
+```promptscript
+@meta { id: "localized" syntax: "1.5.0" }
+
+@standards {
+  @header "Coding Rules"
+  @header git-commits "Commit Rules"
+  code: ["Use strict TypeScript"]
+}
+```
+
+- `@header "Title"` targets the block's primary section.
+- `@header <section-key> "Title"` targets an owned derived section.
+- Titles must be non-empty, single-line strings.
+- Source overrides take precedence over formatter configuration and target defaults.
+- Child inheritance, imported source, and the latest root extension take precedence.
+- An initial `## Heading` in a registered text-only primary owner is a syntax
+  `1.5.0` compatibility fallback. Explicit `@header` metadata wins.
+- Ordinary `header` and `headers` fields remain domain data.
 
 ### Validation Rules
 
 - **PS018 (`syntax-version-compat`)**: warns when resolved blocks or syntax features require a higher version than declared. Requirements from inheritance, imports, and skill composition are included. 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.
+- **PS037 (`valid-section-headers`)**: rejects invalid titles, unknown or unowned section keys, duplicate overrides, and nested extension overrides.
+- **PS038 (`valid-block-shape`)**: rejects unsupported built-in block shapes and warns about formatter-sensitive legacy shapes or multiline shortcut scalars.
 - **PS021 (`use-block-filter`)**: errors when `only` and `exclude` are both specified in `@use` parameters.
 - **PS025 (`valid-skill-references`)**: errors when a `references` entry points to a file with a disallowed extension or a path that cannot be resolved.
 - **PS026 (`safe-reference-content`)**: warns when a referenced file contains potentially sensitive content (e.g., secrets, credentials).
@@ -850,6 +1095,11 @@ Regular block field replacement with `field!: value` requires syntax `1.3.0`.
 - **PS028 (`valid-append-negation`)**: warns when negation prefix `!` appears in base skill definitions (only effective in `@extend`).
 - **PS029 (`valid-sealed-property`)**: warns when `sealed` contains non-replace-strategy property names.
 - **PS030 (`policy-compliance`)**: validates skill extensions against organizational policies defined in `promptscript.yaml`.
+- **PS034 (`valid-hooks`)**: validates portable hook events, commands/scripts, paths, interpreters, timeouts, cwd, and target overrides.
+
+Target formatters report **PS4002** when a hook event or field has no native equivalent,
+when a target cannot guarantee project-root execution, or when output mode cannot emit
+the additional hook file.
 
 ### Fixing Syntax Versions
 
@@ -887,6 +1137,8 @@ prs inspect <skill>         # Show skill composition provenance
 prs inspect <skill> --layers # Show layer-level breakdown
 prs hooks install           # Install auto-compilation hooks for AI tools
 prs hooks install claude    # Install hooks for a specific tool
+prs hooks uninstall         # Remove installed auto-compilation hooks
+prs hooks uninstall claude  # Remove hooks for a specific tool
 prs skills add <source>     # Add a remote skill (@use + lock update + SKILL.md validation)
 prs skills add <source> --strict          # Treat validation warnings as errors
 prs skills add <source> --skip-validation # Bypass Agent Skills spec checks (not recommended)
@@ -994,7 +1246,7 @@ The fastest way to convert existing AI instructions to PromptScript:
 ```
 prs import CLAUDE.md                    # Convert a single file
 prs import .github/copilot-instructions.md
-prs import AGENTS.md --output ./imported.prs
+prs import AGENTS.md --output ./imported
 prs import --dry-run CLAUDE.md          # Preview without writing
 ```
 

package/src/cli.d.ts

@@ -3,5 +3,5 @@
  * Run the CLI.
  * @param args - Command line arguments (defaults to process.argv)
  */
-export declare function run(args?: string[]): void;
+export declare function run(args?: string[]): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAkTA;;;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":";AAuVA;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE"}

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":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAmhBzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/compile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AA0wBzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAEf"}

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/hooks.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAsBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBrF;AAuLD;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/hooks.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAsBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBrF;AA0RD;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/src/commands/telemetry.d.ts

@@ -0,0 +1,3 @@
+export type TelemetryAction = 'status' | 'enable' | 'disable';
+export declare function telemetryCommand(action: string): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/telemetry.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BpE"}

package/src/config/env-config.d.ts

@@ -8,6 +8,7 @@ import type { PromptScriptConfig } from '@promptscript/core';
  * - PROMPTSCRIPT_REGISTRY_URL → registry.url
  * - PROMPTSCRIPT_CACHE_TTL → registry.cache.ttl (parsed as number)
  * - PROMPTSCRIPT_CACHE_ENABLED → registry.cache.enabled (parsed as boolean)
+ * - PROMPTSCRIPT_TELEMETRY → telemetry (parsed as boolean)
  */
 export declare function loadEnvOverrides(): Partial<PromptScriptConfig>;
 //# sourceMappingURL=env-config.d.ts.map

package/src/config/env-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/env-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA6C9D"}
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/env-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA0D9D"}

package/src/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK7D;;GAEG;AACH,eAAO,MAAM,YAAY,UAKxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBjE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBjF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK7D;;GAEG;AACH,eAAO,MAAM,YAAY,UAKxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBjE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBjF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}

package/src/config/merge-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-config.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/merge-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAoEzE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACzC,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,kBAAkB,CA0BpB"}
+{"version":3,"file":"merge-config.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/config/merge-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAoEzE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACzC,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,kBAAkB,CA2CpB"}

package/src/hooks/detect-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-marker.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/hooks/detect-marker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAUD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB1E"}
+{"version":3,"file":"detect-marker.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/hooks/detect-marker.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAeD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsB1E"}

package/src/hooks/extract-file-path.d.ts

@@ -2,11 +2,12 @@
  * Extracts the edited file path from AI tool hook JSON payloads.
  *
  * Supports:
- * - Claude Code / Factory AI / Copilot  — tool_input.file_path
- * - Gemini CLI                           — arguments.file_path (write_* / edit_* tools only)
- * - Cursor                               — filePath (camelCase top-level)
- * - Windsurf                             — file_path (top-level, no tool_input wrapper)
- * - Cline                                — file (top-level)
+ * - Claude Code / Factory AI - tool_input.file_path
+ * - VS Code Copilot Agent Hooks - tool_input.filePath
+ * - Gemini CLI - arguments.file_path (write_* / edit_* tools only)
+ * - Cursor - filePath (camelCase top-level)
+ * - Windsurf - file_path (top-level, no tool_input wrapper)
+ * - Cline - file (top-level)
  */
 export declare function extractFilePath(input: unknown): string | null;
 //# sourceMappingURL=extract-file-path.d.ts.map

package/src/hooks/extract-file-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-file-path.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/hooks/extract-file-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA+B7D"}
+{"version":3,"file":"extract-file-path.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/hooks/extract-file-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC7D"}

package/src/hooks/tool-configs/claude.d.ts

@@ -1,8 +1,10 @@
 import type { ToolHookConfig } from './types.js';
+export declare function isPromptScriptHookCommand(command: string): boolean;
 /**
- * Returns true if the given hook array entry contains a `prs hook` command,
- * indicating it was installed by PromptScript.
+ * Returns true if the given hook array entry contains a PromptScript hook
+ * command, indicating it was installed by PromptScript.
  */
 export declare function isPrsHookEntry(entry: unknown): boolean;
+export declare function removePromptScriptHooks(entry: unknown): unknown | undefined;
 export declare const claudeConfig: ToolHookConfig;
 //# sourceMappingURL=claude.d.ts.map

package/src/hooks/tool-configs/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CActD;AAeD,eAAO,MAAM,YAAY,EAAE,cA0E1B,CAAC"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CActD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAqB3E;AAeD,eAAO,MAAM,YAAY,EAAE,cAgF1B,CAAC"}

package/src/hooks/tool-configs/cline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/cline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,WAAW,EAAE,cA2BzB,CAAC"}
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/cline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAajD,eAAO,MAAM,WAAW,EAAE,cA+BzB,CAAC"}

package/src/hooks/tool-configs/copilot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/copilot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,eAAO,MAAM,aAAa,EAAE,cAuE3B,CAAC"}
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/copilot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,eAAO,MAAM,aAAa,EAAE,cA6E3B,CAAC"}

package/src/hooks/tool-configs/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,eAAO,MAAM,aAAa,EAAE,cAuE3B,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBjD,eAAO,MAAM,aAAa,EAAE,cA6E3B,CAAC"}

package/src/hooks/tool-configs/index.d.ts

@@ -7,6 +7,8 @@ export { copilotConfig } from './copilot.js';
 export { geminiConfig } from './gemini.js';
 export type { ToolHookConfig } from './types.js';
 import type { ToolHookConfig } from './types.js';
+import { type HookCapability } from '@promptscript/core';
 export declare const ALL_TOOL_CONFIGS: ToolHookConfig[];
 export declare function getToolConfig(name: string): ToolHookConfig | undefined;
+export declare function getToolHookCapability(name: string): HookCapability | undefined;
 //# sourceMappingURL=index.d.ts.map

package/src/hooks/tool-configs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAQ5C,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,OAAO,EAAqB,KAAK,cAAc,EAAoB,MAAM,oBAAoB,CAAC;AAY9F,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAQ5C,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E"}

package/src/hooks/tool-configs/types.d.ts

@@ -5,6 +5,7 @@ export interface ToolHookConfig {
     timeoutUnit: 'seconds' | 'milliseconds' | 'n/a';
     generatePreEditHook(prsPath: string): Record<string, unknown>;
     generatePostEditHook(prsPath: string): Record<string, unknown>;
+    isOwnedScript?(content: string, action: 'pre-edit' | 'post-edit'): boolean;
     mergeIntoSettings(existing: Record<string, unknown>, prsPath: string): Record<string, unknown>;
     removeFromSettings(existing: Record<string, unknown>): Record<string, unknown>;
 }

package/src/hooks/tool-configs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC;IAChD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/F,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/hooks/tool-configs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC;IAChD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IAC3E,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/F,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChF"}

package/src/telemetry/config.d.ts

@@ -0,0 +1,10 @@
+import { type ResolvedTelemetryConfig } from '@promptscript/telemetry';
+export interface CliTelemetryConfigOptions {
+    cwd?: string;
+    config?: string;
+    cacheDirectory?: string;
+    userConfigPath?: string;
+}
+export declare function resolveCliTelemetryConfig(options?: CliTelemetryConfigOptions): Promise<ResolvedTelemetryConfig>;
+export declare function setUserTelemetryEnabled(enabled: boolean, configPath?: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/src/telemetry/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/telemetry/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAI/F,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAsDD,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAgClC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/src/telemetry/session.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import { getSpoolInfo, readFlushState, type ResolvedTelemetryConfig, type TelemetryOutcome } from '@promptscript/telemetry';
+export declare function normalizedCommandName(command: Command): string;
+export declare function commandFeatures(command: Command): string[];
+export declare function exitOutcome(code: number): TelemetryOutcome;
+export declare function prepareCliTelemetry(command: Command, appVersion: string): Promise<void>;
+export declare function finishCliTelemetry(outcome?: TelemetryOutcome): void;
+export declare function flushCliTelemetry(): Promise<void>;
+export declare function telemetryStatus(): Promise<{
+    config: ResolvedTelemetryConfig;
+    spool: ReturnType<typeof getSpoolInfo>;
+    state: ReturnType<typeof readFlushState>;
+}>;
+//# sourceMappingURL=session.d.ts.map

package/src/telemetry/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/telemetry/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,YAAY,EAGZ,cAAc,EAKd,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAMjC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAU9D;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA0B1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAK1D;AA4BD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAMnE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACvC,KAAK,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;CAC1C,CAAC,CAOD"}

package/src/types.d.ts

@@ -70,6 +70,8 @@ export interface CompileOptions {
     output?: string;
     /** Preview changes without writing files */
     dryRun?: boolean;
+    /** Migrate unambiguous legacy Factory settings hooks during compilation */
+    migrateFactoryHooks?: boolean;
     /** Registry path or URL (overrides config) */
     registry?: string;
     /** Path to custom config file */