@promptscript/cli 1.3.1 → 1.4.0

package/package.json

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

package/skills/promptscript/SKILL.md

@@ -211,7 +211,108 @@ Reusable skill definitions with metadata:
 ```
 
 Properties: description (required), content (required), trigger, disableModelInvocation,
-userInvocable, allowedTools, context ("fork" or "inherit"), agent.
+userInvocable, allowedTools, context ("fork" or "inherit"), agent, requires, inputs, outputs.
+
+### Parameterized Skills
+
+Skills in `.promptscript/skills/<name>/SKILL.md` support template parameters via
+YAML frontmatter. Define `params` in frontmatter and use `{{variable}}` in content:
+
+```yaml
+---
+name: review
+description: 'Review {{language}} code for {{standard}}'
+params:
+  language:
+    type: string
+  standard:
+    type: string
+    default: 'best practices'
+---
+Review the code using {{language}} conventions following {{standard}}.
+```
+
+Pass values in `@skills` block:
+
+```
+@skills {
+  review: {
+    description: "Review code"
+    language: "typescript"
+    standard: "strict mode"
+  }
+}
+```
+
+Non-reserved properties (anything other than description, content, trigger,
+userInvocable, allowedTools, disableModelInvocation, context, agent, requires,
+inputs, outputs) are treated as skill parameter arguments.
+
+### Skill Dependencies
+
+Skills can declare dependencies on other skills via `requires`:
+
+```
+@skills {
+  deploy: {
+    description: "Deploy service"
+    requires: ["lint-check", "test-suite"]
+    content: (triple-quoted text)
+  }
+}
+```
+
+The validator (PS016) checks that required skills exist, detects self-references,
+and catches circular dependency chains.
+
+### Skill Contracts (Inputs/Outputs)
+
+Skills can declare typed inputs and outputs in SKILL.md frontmatter:
+
+```yaml
+---
+name: security-scan
+description: 'Scan for vulnerabilities'
+inputs:
+  files:
+    description: 'Files to scan'
+    type: string
+  severity:
+    description: 'Minimum severity'
+    type: enum
+    options: [low, medium, high]
+    default: medium
+outputs:
+  report:
+    description: 'Scan report'
+    type: string
+  passed:
+    description: 'Whether scan passed'
+    type: boolean
+---
+```
+
+Field types: `string`, `number`, `boolean`, `enum` (with `options` list).
+The validator (PS017) checks field types, ensures enum fields have options,
+and warns if param names collide with input names.
+
+### Shared Resources
+
+Skills in a folder can share common resources via `.promptscript/shared/`:
+
+```
+.promptscript/
+  shared/
+    templates.md         # Shared across all skills
+    style-guide.md
+  skills/
+    review/
+      SKILL.md           # Gets @shared/templates.md, @shared/style-guide.md
+    deploy/
+      SKILL.md           # Also gets shared resources
+```
+
+Files in `shared/` are automatically included in every skill with `@shared/` prefix.
 
 ### @agents
 
@@ -297,8 +398,75 @@ Requires an aliased @use:
 }
 ```
 
+### Parameterized Inheritance (Template Variables)
+
+Use `{{variable}}` placeholders in a **parent/template** file, and pass values
+from the **child** file via `@inherit` or `@use` with `(key: value)` syntax.
+
+**IMPORTANT:** Variables are NOT set from `promptscript.yaml` or CLI. They are
+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
+@meta {
+  id: "service-template"
+  syntax: "1.0.0"
+  params: {
+    serviceName: string
+    port?: number = 3000
+  }
+}
+
+@identity {
+  """
+  You are working on {{serviceName}} running on port {{port}}.
+  """
+}
+```
+
+**Step 2: Inherit with values** (child file passes params):
+
+```
+# project.prs — concrete project
+@meta { id: "user-api" syntax: "1.0.0" }
+
+@inherit ./base(serviceName: "user-api", port: 8080)
+```
+
+After compilation, `{{serviceName}}` becomes `user-api` and `{{port}}` becomes `8080`.
+
+The same works with `@use`:
+
+```
+@use ./base(serviceName: "auth-service") as auth
+```
+
+**Parameter types:** `string`, `number`, `boolean`, `enum("a", "b")`.
+Optional params use `?` suffix. Defaults use `= value`.
+Missing required params produce a compile error.
+
+**Multi-service pattern** — reuse one template across many projects:
+
+```
+services/
+  base.prs                          # template with params
+  user-api/
+    promptscript.yaml               # source: project.prs
+    project.prs                     # @inherit ../base(serviceName: "user-api")
+  auth-service/
+    promptscript.yaml
+    project.prs                     # @inherit ../base(serviceName: "auth-service")
+```
+
 ## Configuration: promptscript.yaml
 
+### Auto-injection
+
+This skill is automatically included when compiling with `prs compile`. No manual copying needed.
+To disable, set `includePromptScriptSkill: false` in your `promptscript.yaml`.
+
 ```
 id: my-project
 syntax: "1.1.0"
@@ -334,6 +502,8 @@ prs init --migrate          # Initialize + migration skills
 prs compile                 # Compile to all targets
 prs compile --watch         # Watch mode
 prs validate --strict       # Validate syntax
+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
 ```
@@ -358,6 +528,15 @@ prs diff --target claude    # Show compilation diff
 | Continue    | .continue/rules/project.md      | .continue/skills/\*/SKILL.md                       |
 | + 26 more   |                                 | See full list in documentation                     |
 
+### Formatter Documentation
+
+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
+- **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
+
 ## Project Organization
 
 Typical modular structure:
@@ -381,40 +560,44 @@ The entry file uses `@use ./context`, `@use ./standards`, etc. to compose them.
 4. Unquoted strings with special chars - quote strings containing `:`, `#`, `{`, `}`
 5. Forgetting to compile - `.prs` changes need `prs compile` to take effect
 6. Triple quotes inside triple quotes - not supported; describe content textually instead
+7. Using `{{var}}` in the root file without `@inherit` - template variables only work
+   in a parent file that defines `params` in `@meta`, with values passed by the child
+   via `@inherit ./parent(key: value)` or `@use ./fragment(key: value)`. They are NOT
+   set from `promptscript.yaml` or CLI flags
 
 ## Migrating Existing AI Instructions to PromptScript
 
-Use this workflow when converting existing AI instruction files (CLAUDE.md, .cursorrules, copilot-instructions.md, etc.) to PromptScript `.prs` format.
+### Automated: `prs import`
 
-### Step 1: Discovery
+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 --dry-run CLAUDE.md          # Preview without writing
+```
 
-Find all existing AI instruction files in the project:
+`prs import` automatically:
+
+- Detects the source format (Claude, GitHub Copilot, Cursor, Factory, etc.)
+- Maps content to appropriate PromptScript blocks (@identity, @standards, etc.)
+- Generates a valid `.prs` file with `@meta` block
+- Preserves the original intent and structure
+
+Supported source formats:
 
 - `CLAUDE.md` (Claude Code)
 - `.github/copilot-instructions.md` (GitHub Copilot)
 - `.cursorrules` or `.cursor/rules/*.mdc` (Cursor)
-- `.agent/rules/*.md` (Antigravity)
 - `AGENTS.md` (Factory AI / Codex)
-- `.clinerules` (Cline)
-- `.roorules` (Roo Code)
+- `.clinerules` (Cline), `.roorules` (Roo Code)
 - `.windsurf/rules/*.md` (Windsurf)
-- Any other AI instruction files
-
-### Step 2: Read and Analyze
-
-Read each discovered file and identify:
-
-- Identity/persona instructions ("You are...")
-- Project context (tech stack, architecture)
-- Coding standards and conventions
-- Hard restrictions and rules
-- Command shortcuts or slash commands
-- Skill definitions
-- Agent/subagent definitions
+- Any Markdown-based AI instruction file
 
-### Step 3: Content Mapping
+### Manual Migration
 
-Map content from source files to PromptScript blocks:
+For complex migrations or when `prs import` needs refinement:
 
 | Source Pattern                      | PromptScript Block |
 | ----------------------------------- | ------------------ |
@@ -427,33 +610,6 @@ Map content from source files to PromptScript blocks:
 | Agent/subagent configs              | `@agents`          |
 | Reference docs, API specs           | `@knowledge`       |
 
-### Step 4: Generate PromptScript
-
-Create `.prs` files in `.promptscript/` directory using the mapped content. Start with `project.prs` containing `@meta` with project id and syntax version.
-
-### Step 5: File Organization
-
-Split content into logical files:
-
-- `project.prs` - entry point with `@meta`, `@inherit`, `@use`, `@identity`
-- `context.prs` - `@context` block
-- `standards.prs` - `@standards` block
-- `restrictions.prs` - `@restrictions` block
-- `commands.prs` - `@shortcuts` and `@knowledge` blocks
-
-Use `@use ./context`, `@use ./standards`, etc. in `project.prs` to compose them.
-
-### Step 6: Configuration
-
-Create or update `promptscript.yaml` with appropriate targets matching the original AI tools being used.
-
-### Step 7: Validation
-
-Run `prs validate --strict` to check syntax, then `prs compile` to generate output files. Compare compiled output with original files to verify content was preserved.
-
-### Migration Tips
-
-- Preserve the original intent and tone of instructions
-- Don't lose any rules or restrictions during mapping
-- Use `@knowledge` for large reference sections that don't fit other blocks
-- Back up original files before overwriting with compiled output
+After import, split into modular files (`context.prs`, `standards.prs`, etc.)
+and compose with `@use` in `project.prs`. Run `prs validate --strict` then
+`prs compile` to verify output matches the original.

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAmIA;;;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":";AAyJA;;;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":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAgVzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA8Gf"}
+{"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;AAkXzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwHf"}

package/src/commands/import.d.ts

@@ -0,0 +1,8 @@
+export interface ImportCommandOptions {
+    format?: string;
+    output?: string;
+    dryRun?: boolean;
+    validate?: boolean;
+}
+export declare function importCommand(file: string, options: ImportCommandOptions): Promise<void>;
+//# sourceMappingURL=import.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/import.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9F"}

package/src/commands/index.d.ts

@@ -3,4 +3,5 @@ export { compileCommand } from './compile.js';
 export { validateCommand } from './validate.js';
 export { pullCommand } from './pull.js';
 export { diffCommand } from './diff.js';
+export { importCommand } from './import.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/src/commands/init.d.ts

@@ -1,8 +1,13 @@
 import { type CliServices } from '../services.js';
 import type { InitOptions } from '../types.js';
+import { type AIToolTarget } from '../utils/ai-tools-detector.js';
 /**
  * Initialize PromptScript in the current directory.
  * Creates configuration file and initial project structure.
  */
 export declare function initCommand(options: InitOptions, services?: CliServices): Promise<void>;
+/**
+ * Format target name for display using the formatter's description.
+ */
+export declare function formatTargetName(target: AIToolTarget): string;
 //# sourceMappingURL=init.d.ts.map

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;AAyD/C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwKf"}
+{"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,CA6Kf;AA8SD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAM7D"}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/init.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAM5E;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyFf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli/src/commands/registry/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAO5E;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAiGf"}

package/src/commands/serve.d.ts

@@ -0,0 +1,9 @@
+interface ServeOptions {
+    port?: string;
+    host?: string;
+    readOnly?: boolean;
+    corsOrigin?: string;
+}
+export declare function serveCommand(options: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/serve.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

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

@@ -1,8 +1,8 @@
 import { type CliServices } from '../services.js';
 /**
- * Supported AI tool targets.
+ * AI tool target identifier — corresponds to a registered formatter name.
  */
-export type AIToolTarget = 'github' | 'claude' | 'cursor' | 'antigravity' | 'factory' | 'opencode' | 'gemini';
+export type AIToolTarget = string;
 /**
  * AI tool detection result.
  */
@@ -10,7 +10,7 @@ export interface AIToolsDetection {
     /** Detected AI tools with existing configuration */
     detected: AIToolTarget[];
     /** Details about detected files */
-    details: Record<AIToolTarget, string[]>;
+    details: Record<string, string[]>;
     /** Files that exist but were NOT generated by PromptScript (candidates for migration) */
     migrationCandidates: string[];
 }
@@ -19,12 +19,12 @@ export interface AIToolsDetection {
  */
 export declare function detectAITools(services?: CliServices): Promise<AIToolsDetection>;
 /**
- * Get all available targets.
+ * Get all available targets from the FormatterRegistry.
  */
 export declare function getAllTargets(): AIToolTarget[];
 /**
  * Get suggested targets based on detection.
- * If no tools detected, suggest all. Otherwise, suggest detected ones.
+ * If no tools detected, suggest common defaults. Otherwise, suggest detected ones.
  */
 export declare function getSuggestedTargets(detection: AIToolsDetection): AIToolTarget[];
 /**

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":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAiGD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAgB5E;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,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"}

package/src/utils/resolve-target-directory.d.ts

@@ -0,0 +1,22 @@
+import type { FileSystem, PromptSystem } from '../services.js';
+export interface ResolveTargetDirectoryOptions {
+    cwd: string;
+    directoryArg?: string;
+    registryName: string;
+    nonInteractive: boolean;
+}
+interface ResolveServices {
+    fs: Pick<FileSystem, 'readdir'>;
+    prompts: Pick<PromptSystem, 'select'>;
+}
+/**
+ * Determine where to scaffold the registry.
+ *
+ * - Explicit directory arg: use it directly
+ * - Empty CWD + interactive: ask user "here or subdirectory?"
+ * - Empty CWD + non-interactive: scaffold in CWD
+ * - Non-empty CWD: create slugified subdirectory
+ */
+export declare function resolveTargetDirectory(options: ResolveTargetDirectoryOptions, services: ResolveServices): Promise<string>;
+export {};
+//# sourceMappingURL=resolve-target-directory.d.ts.map

package/src/utils/resolve-target-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target-directory.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/resolve-target-directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG/D,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/src/utils/slugify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert a string to a filesystem-safe slug.
+ *
+ * Lowercases, replaces non-alphanumeric characters with hyphens,
+ * deduplicates consecutive hyphens, and trims hyphens from edges.
+ */
+export declare function slugify(name: string): string;
+//# sourceMappingURL=slugify.d.ts.map

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

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