@promptscript/cli 1.0.0-alpha.3 → 1.0.0-alpha.5

package/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-alpha.5](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2026-01-27)
+
+
+### chore
+
+* prepare alpha release ([54696c9](https://github.com/mrwogu/promptscript/commit/54696c93e27cf9fc2f09dd730b09e568d0dc425e))
+
+
+### Features
+
+* **cli:** add AI-assisted migration skill and CLI integration ([53e9cca](https://github.com/mrwogu/promptscript/commit/53e9cca8669a30e787cbc2aa7679bb63f7896fce))
+* **cli:** add verbose and debug logging throughout compilation pipeline ([36bd63a](https://github.com/mrwogu/promptscript/commit/36bd63a2fa1dde1acbfd0794bb174f645ef71335))
+
+
+### Bug Fixes
+
+* **cli:** add migrationCandidates to test mocks ([d8fe117](https://github.com/mrwogu/promptscript/commit/d8fe117ff5523bb5b1c15996e00d8c24548c7b8f))
+* **cli:** extend marker detection from 10 to 20 lines ([229e9bc](https://github.com/mrwogu/promptscript/commit/229e9bc5bf4d0441c9674e6483a5125347b6f0b8))
+
+## [1.0.0-alpha.4](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2026-01-27)
+
+
+### ⚠ BREAKING CHANGES
+
+* **compiler:** Generated files now have compact marker instead of verbose header. Existing files with legacy marker still recognized.
+
+### chore
+
+* prepare alpha release ([8c3a428](https://github.com/mrwogu/promptscript/commit/8c3a428856bc088fb27a4fdd6a16185fe5e63589))
+
+
+### Features
+
+* **compiler:** add compact PromptScript marker to all outputs ([6d74480](https://github.com/mrwogu/promptscript/commit/6d744800a4ab38030b6c23b2ab949c79977ab12e))
+
 ## [1.0.0-alpha.3](https://github.com/mrwogu/promptscript/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2026-01-27)
 
 

package/README.md

@@ -69,6 +69,8 @@ Options:
   --dry-run               Preview changes without writing files
   --force                 Force overwrite existing files without prompts
   --registry <path>       Path or URL to registry
+  --verbose               Show detailed compilation progress
+  --debug                 Show debug information (includes verbose)
 ```
 
 **Watch Mode:** Uses [chokidar](https://github.com/paulmillr/chokidar) for reliable file watching across all platforms. Automatically recompiles when `.prs` files change.

package/index.js

@@ -296,6 +296,14 @@ function getPackageVersion(baseDir, relativePath = "../package.json") {
   return getPackageInfo(baseDir, relativePath).version;
 }
 
+// packages/core/src/logger.ts
+var noopLogger = {
+  verbose: () => {
+  },
+  debug: () => {
+  }
+};
+
 // packages/cli/src/commands/init.ts
 import { fileURLToPath } from "url";
 import { dirname as dirname2 } from "path";
@@ -331,6 +339,7 @@ var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2[LogLevel2["Quiet"] = 0] = "Quiet";
   LogLevel2[LogLevel2["Normal"] = 1] = "Normal";
   LogLevel2[LogLevel2["Verbose"] = 2] = "Verbose";
+  LogLevel2[LogLevel2["Debug"] = 3] = "Debug";
   return LogLevel2;
 })(LogLevel || {});
 var globalContext = {
@@ -349,6 +358,9 @@ function isVerbose() {
 function isQuiet() {
   return globalContext.logLevel <= 0 /* Quiet */;
 }
+function isDebug() {
+  return globalContext.logLevel >= 3 /* Debug */;
+}
 function createSpinner(text) {
   if (isQuiet()) {
     const noopSpinner = ora({ isSilent: true });
@@ -617,6 +629,16 @@ async function detectFrameworks(services) {
 }
 
 // packages/cli/src/utils/ai-tools-detector.ts
+var PROMPTSCRIPT_MARKER = "PromptScript";
+var INSTRUCTION_FILES = [
+  "CLAUDE.md",
+  "claude.md",
+  ".cursorrules",
+  ".github/copilot-instructions.md",
+  "AGENTS.md",
+  "AI_INSTRUCTIONS.md",
+  "AI.md"
+];
 var AI_TOOL_PATTERNS = [
   {
     target: "github",
@@ -648,6 +670,15 @@ async function directoryHasContent(dir, services) {
     return false;
   }
 }
+async function isPromptScriptGenerated(filePath, services) {
+  try {
+    const content = await services.fs.readFile(filePath, "utf-8");
+    const header = content.slice(0, 500);
+    return header.includes(PROMPTSCRIPT_MARKER);
+  } catch {
+    return false;
+  }
+}
 async function detectAITools(services = createDefaultServices()) {
   const detected = [];
   const details = {
@@ -656,6 +687,7 @@ async function detectAITools(services = createDefaultServices()) {
     cursor: [],
     antigravity: []
   };
+  const migrationCandidates = [];
   for (const pattern of AI_TOOL_PATTERNS) {
     const foundFiles = [];
     for (const file of pattern.files) {
@@ -673,7 +705,15 @@ async function detectAITools(services = createDefaultServices()) {
       details[pattern.target] = foundFiles;
     }
   }
-  return { detected, details };
+  for (const file of INSTRUCTION_FILES) {
+    if (services.fs.existsSync(file)) {
+      const isGenerated = await isPromptScriptGenerated(file, services);
+      if (!isGenerated) {
+        migrationCandidates.push(file);
+      }
+    }
+  }
+  return { detected, details, migrationCandidates };
 }
 function getAllTargets() {
   return ["github", "claude", "cursor", "antigravity"];
@@ -694,6 +734,25 @@ function formatDetectionResults(detection) {
   }
   return lines;
 }
+function hasMigrationCandidates(detection) {
+  return detection.migrationCandidates.length > 0;
+}
+function formatMigrationHint(detection) {
+  if (detection.migrationCandidates.length === 0) {
+    return [];
+  }
+  const lines = [];
+  lines.push("");
+  lines.push("\u{1F4CB} Existing instruction files detected:");
+  for (const file of detection.migrationCandidates) {
+    lines.push(`   \u2022 ${file}`);
+  }
+  lines.push("");
+  lines.push("   These can be migrated to PromptScript for unified management.");
+  lines.push("   See: https://getpromptscript.dev/latest/guides/ai-migration-best-practices");
+  lines.push("   Or use the /migrate skill in Claude Code.");
+  return lines;
+}
 
 // packages/cli/src/prettier/loader.ts
 import { existsSync as existsSync2 } from "fs";
@@ -854,6 +913,18 @@ async function initCommand(options, services = createDefaultServices()) {
     console.log("Next steps:");
     ConsoleOutput.muted("1. Edit .promptscript/project.prs to customize your AI instructions");
     ConsoleOutput.muted("2. Run: prs compile");
+    if (hasMigrationCandidates(aiToolsDetection)) {
+      const migrationHint = formatMigrationHint(aiToolsDetection);
+      for (const line of migrationHint) {
+        if (line.startsWith("\u{1F4CB}") || line.includes("migrated") || line.includes("See:") || line.includes("Or use")) {
+          ConsoleOutput.info(line.replace(/^\s+/, ""));
+        } else if (line.trim().startsWith("\u2022")) {
+          ConsoleOutput.muted(line);
+        } else if (line.trim()) {
+          console.log(line);
+        }
+      }
+    }
   } catch (error) {
     if (error.name === "ExitPromptError") {
       ConsoleOutput.newline();
@@ -2064,8 +2135,6 @@ var GitHubFormatter = class extends BaseFormatter {
     const lines = [];
     lines.push("# Agent Instructions");
     lines.push("");
-    lines.push("> Auto-generated by PromptScript");
-    lines.push("");
     const identityText = this.extractText(identity2.content);
     if (identityText) {
       lines.push("## Identity");
@@ -2225,16 +2294,8 @@ var GitHubFormatter = class extends BaseFormatter {
     const knowledge = this.knowledge(ast, renderer);
     if (knowledge) sections.push(knowledge);
   }
-  header(ast) {
-    const id = this.getMetaField(ast, "id") ?? "unknown";
-    const syntax = this.getMetaField(ast, "syntax") ?? "0.0.0";
-    return `# GitHub Copilot Instructions
-
-> Auto-generated by PromptScript
-> Source: ${id} (syntax ${syntax})
-> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
->
-> **Do not edit manually**`;
+  header(_ast) {
+    return `# GitHub Copilot Instructions`;
   }
   project(ast, renderer) {
     const identity2 = this.findBlock(ast, "identity");
@@ -4068,17 +4129,8 @@ var AntigravityFormatter = class extends BaseFormatter {
   formatWorkflowTitle(name) {
     return name.replace(/^\//, "").split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
   }
-  header(ast) {
-    const id = this.getMetaField(ast, "id") ?? "unknown";
-    const syntax = this.getMetaField(ast, "syntax") ?? "0.0.0";
-    return `# Project Rules
-
-> Auto-generated by PromptScript
-> Source: ${id} (syntax ${syntax})
-> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}
->
-> **Do not edit manually** - these rules are generated from PromptScript.
-> To modify, update the source .prs file and recompile.`;
+  header(_ast) {
+    return `# Project Rules`;
   }
   identity(ast, _renderer) {
     const identity2 = this.findBlock(ast, "identity");
@@ -15397,11 +15449,13 @@ var Resolver = class {
   cache;
   resolving;
   cacheEnabled;
+  logger;
   constructor(options) {
     this.loader = new FileLoader(options);
     this.cache = /* @__PURE__ */ new Map();
     this.resolving = /* @__PURE__ */ new Set();
     this.cacheEnabled = options.cache !== false;
+    this.logger = options.logger ?? noopLogger;
   }
   /**
    * Resolve a PromptScript file and all its dependencies.
@@ -15413,15 +15467,19 @@ var Resolver = class {
   async resolve(entryPath) {
     const absPath = this.loader.toAbsolutePath(entryPath);
     if (this.resolving.has(absPath)) {
+      this.logger.debug(`Circular dependency detected: ${absPath}`);
       throw new CircularDependencyError([...this.resolving, absPath]);
     }
     if (this.cacheEnabled && this.cache.has(absPath)) {
+      this.logger.debug(`Cache hit: ${absPath}`);
       return this.cache.get(absPath);
     }
     this.resolving.add(absPath);
+    this.logger.verbose(`Parsing ${absPath}`);
     try {
       const result = await this.doResolve(absPath);
       if (this.cacheEnabled) {
+        this.logger.debug(`Cache store: ${absPath}`);
         this.cache.set(absPath, result);
       }
       return result;
@@ -15440,16 +15498,33 @@ var Resolver = class {
       return { ast: null, sources, errors };
     }
     let ast = parseData.ast;
+    this.logger.debug(`AST node count: ${this.countNodes(ast)}`);
     ast = await this.resolveInherit(ast, absPath, sources, errors);
     ast = await this.resolveImports(ast, absPath, sources, errors);
+    if (ast.extends.length > 0) {
+      this.logger.debug(`Applying ${ast.extends.length} extension(s)`);
+    }
     ast = applyExtends(ast);
     ast = await resolveNativeSkills(ast, this.loader.getRegistryPath(), absPath);
+    this.logger.debug(`Resolved ${sources.length} source file(s)`);
     return {
       ast,
       sources: [...new Set(sources)],
       errors
     };
   }
+  /**
+   * Count nodes in AST for debug output.
+   */
+  countNodes(ast) {
+    let count = 1;
+    if (ast.meta) count++;
+    if (ast.inherit) count++;
+    count += ast.uses.length;
+    count += ast.blocks.length;
+    count += ast.extends.length;
+    return count;
+  }
   /**
    * Load and parse a file.
    */
@@ -15484,11 +15559,14 @@ var Resolver = class {
       return ast;
     }
     const parentPath = this.loader.resolveRef(ast.inherit.path, absPath);
+    this.logger.verbose(`Resolving inherit: ${ast.inherit.path.raw}`);
+    this.logger.verbose(`  \u2192 ${parentPath}`);
     try {
       const parent = await this.resolve(parentPath);
       sources.push(...parent.sources);
       errors.push(...parent.errors);
       if (parent.ast) {
+        this.logger.debug(`Merging with parent AST`);
         return resolveInheritance(parent.ast, ast);
       }
     } catch (err) {
@@ -15506,11 +15584,14 @@ var Resolver = class {
     let result = ast;
     for (const use of ast.uses) {
       const importPath = this.loader.resolveRef(use.path, absPath);
+      this.logger.verbose(`Resolving import: ${use.path.raw}`);
+      this.logger.verbose(`  \u2192 ${importPath}`);
       try {
         const imported = await this.resolve(importPath);
         sources.push(...imported.sources);
         errors.push(...imported.errors);
         if (imported.ast) {
+          this.logger.debug(`Merging import${use.alias ? ` as "${use.alias}"` : ""}`);
           result = resolveUses(result, use, imported.ast);
         }
       } catch (err) {
@@ -16784,6 +16865,7 @@ var Validator = class {
   rules;
   config;
   disabledRules;
+  logger;
   /**
    * Create a new validator instance.
    *
@@ -16793,11 +16875,13 @@ var Validator = class {
     this.config = config;
     this.rules = [...allRules];
     this.disabledRules = new Set(config.disableRules ?? []);
+    this.logger = config.logger ?? noopLogger;
     if (config.customRules) {
       for (const rule of config.customRules) {
         this.rules.push(rule);
       }
     }
+    this.logger.debug(`Validator initialized with ${this.rules.length} rules`);
   }
   /**
    * Validate an AST.
@@ -16807,15 +16891,22 @@ var Validator = class {
    */
   validate(ast) {
     const messages = [];
+    const activeRules = this.rules.filter(
+      (r) => !this.disabledRules.has(r.name) && !this.disabledRules.has(r.id)
+    );
+    this.logger.verbose(`Running ${activeRules.length} validation rules`);
     for (const rule of this.rules) {
       if (this.disabledRules.has(rule.name) || this.disabledRules.has(rule.id)) {
+        this.logger.debug(`Skipping disabled rule: ${rule.name}`);
         continue;
       }
       const configuredSeverity = this.config.rules?.[rule.name];
       const severity = configuredSeverity ?? rule.defaultSeverity;
       if (severity === "off") {
+        this.logger.debug(`Skipping off rule: ${rule.name}`);
         continue;
       }
+      this.logger.debug(`Running rule: ${rule.name} (${severity})`);
       const ctx = {
         ast,
         config: this.config,
@@ -16833,6 +16924,9 @@ var Validator = class {
     const errors = messages.filter((m) => m.severity === "error");
     const warnings = messages.filter((m) => m.severity === "warning");
     const infos = messages.filter((m) => m.severity === "info");
+    if (errors.length > 0 || warnings.length > 0) {
+      this.logger.verbose(`Validation: ${errors.length} error(s), ${warnings.length} warning(s)`);
+    }
     return {
       valid: errors.length === 0,
       errors,
@@ -16878,16 +16972,52 @@ var Validator = class {
 };
 
 // packages/compiler/src/compiler.ts
+function generateMarker() {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  return `<!-- PromptScript ${timestamp} - do not edit -->`;
+}
+function addMarkerToOutput(output) {
+  const { content, path } = output;
+  if (content.includes("<!-- PromptScript")) {
+    return output;
+  }
+  const marker = generateMarker();
+  if (!path.endsWith(".md") && !path.endsWith(".mdc")) {
+    return output;
+  }
+  if (content.startsWith("---")) {
+    const closingIndex = content.indexOf("---", 3);
+    if (closingIndex !== -1) {
+      const beforeMarker = content.slice(0, closingIndex + 3);
+      const afterMarker = content.slice(closingIndex + 3);
+      const newContent = `${beforeMarker}
+
+${marker}
+${afterMarker.replace(/^\n+/, "\n")}`;
+      return { ...output, content: newContent };
+    }
+  }
+  const lines = content.split("\n");
+  if (lines[0]?.startsWith("# ")) {
+    lines.splice(1, 0, "", marker);
+  } else {
+    lines.unshift(marker, "");
+  }
+  return { ...output, content: lines.join("\n") };
+}
 var Compiler = class _Compiler {
   constructor(options) {
     this.options = options;
-    this.resolver = new Resolver(options.resolver);
-    this.validator = new Validator(options.validator);
+    this.logger = options.logger ?? noopLogger;
+    this.resolver = new Resolver({ ...options.resolver, logger: this.logger });
+    this.validator = new Validator({ ...options.validator, logger: this.logger });
     this.loadedFormatters = this.loadFormatters(options.formatters);
+    this.logger.debug(`Compiler initialized with ${this.loadedFormatters.length} formatters`);
   }
   resolver;
   validator;
   loadedFormatters;
+  logger;
   /**
    * Compile a PromptScript file through the full pipeline.
    *
@@ -16895,6 +17025,10 @@ var Compiler = class _Compiler {
    * @returns Compilation result with outputs, errors, and stats
    */
   async compile(entryPath) {
+    this.logger.verbose(`Entry: ${entryPath}`);
+    this.logger.verbose(
+      `Targets: ${this.loadedFormatters.map((f) => f.formatter.name).join(", ")}`
+    );
     const startTotal = Date.now();
     const stats = {
       resolveTime: 0,
@@ -16902,6 +17036,7 @@ var Compiler = class _Compiler {
       formatTime: 0,
       totalTime: 0
     };
+    this.logger.verbose("=== Stage 1: Resolve ===");
     const startResolve = Date.now();
     let resolved;
     try {
@@ -16909,6 +17044,7 @@ var Compiler = class _Compiler {
     } catch (err) {
       stats.resolveTime = Date.now() - startResolve;
       stats.totalTime = Date.now() - startTotal;
+      this.logger.verbose(`Resolve failed (${stats.resolveTime}ms)`);
       return {
         success: false,
         outputs: /* @__PURE__ */ new Map(),
@@ -16918,6 +17054,7 @@ var Compiler = class _Compiler {
       };
     }
     stats.resolveTime = Date.now() - startResolve;
+    this.logger.verbose(`Resolve completed (${stats.resolveTime}ms)`);
     if (resolved.errors.length > 0 || !resolved.ast) {
       stats.totalTime = Date.now() - startTotal;
       return {
@@ -16928,9 +17065,11 @@ var Compiler = class _Compiler {
         stats
       };
     }
+    this.logger.verbose("=== Stage 2: Validate ===");
     const startValidate = Date.now();
     const validation = this.validator.validate(resolved.ast);
     stats.validateTime = Date.now() - startValidate;
+    this.logger.verbose(`Validate completed (${stats.validateTime}ms)`);
     if (!validation.valid) {
       stats.totalTime = Date.now() - startTotal;
       return {
@@ -16941,17 +17080,24 @@ var Compiler = class _Compiler {
         stats
       };
     }
+    this.logger.verbose("=== Stage 3: Format ===");
     const startFormat = Date.now();
     const outputs = /* @__PURE__ */ new Map();
     const formatErrors = [];
     for (const { formatter, config } of this.loadedFormatters) {
+      const formatterStart = Date.now();
+      this.logger.verbose(`Formatting for ${formatter.name}`);
       try {
         const formatOptions = this.getFormatOptionsForTarget(formatter.name, config);
+        this.logger.debug(`  Convention: ${formatOptions.convention ?? "default"}`);
         const output = formatter.format(resolved.ast, formatOptions);
-        outputs.set(output.path, output);
+        const formatterTime = Date.now() - formatterStart;
+        this.logger.verbose(`  \u2192 ${output.path} (${formatterTime}ms)`);
+        outputs.set(output.path, addMarkerToOutput(output));
         if (output.additionalFiles) {
           for (const additionalFile of output.additionalFiles) {
-            outputs.set(additionalFile.path, additionalFile);
+            this.logger.verbose(`  \u2192 ${additionalFile.path} (additional)`);
+            outputs.set(additionalFile.path, addMarkerToOutput(additionalFile));
           }
         }
       } catch (err) {
@@ -16964,6 +17110,7 @@ var Compiler = class _Compiler {
     }
     stats.formatTime = Date.now() - startFormat;
     stats.totalTime = Date.now() - startTotal;
+    this.logger.verbose(`Format completed (${stats.formatTime}ms)`);
     if (formatErrors.length > 0) {
       return {
         success: false,
@@ -17257,7 +17404,26 @@ function createPager(enabled = true) {
 }
 
 // packages/cli/src/commands/compile.ts
-var PROMPTSCRIPT_MARKER = "> Auto-generated by PromptScript";
+var PROMPTSCRIPT_MARKERS = [
+  "<!-- PromptScript",
+  // Current marker (HTML comment with date)
+  "> Auto-generated by PromptScript"
+  // Legacy - for backwards compatibility
+];
+function createCliLogger() {
+  return {
+    verbose: (message) => {
+      if (isVerbose() || isDebug()) {
+        ConsoleOutput.verbose(message);
+      }
+    },
+    debug: (message) => {
+      if (isDebug()) {
+        ConsoleOutput.debug(message);
+      }
+    }
+  };
+}
 function parseTargets(targets) {
   return targets.map((entry) => {
     if (typeof entry === "string") {
@@ -17271,11 +17437,11 @@ function parseTargets(targets) {
     return { name, config };
   }).filter((target) => target.config?.enabled !== false);
 }
-async function isPromptScriptGenerated(filePath) {
+async function isPromptScriptGenerated2(filePath) {
   try {
     const content = await readFile6(filePath, "utf-8");
-    const lines = content.split("\n").slice(0, 10);
-    return lines.some((line) => line.includes(PROMPTSCRIPT_MARKER));
+    const lines = content.split("\n").slice(0, 20);
+    return lines.some((line) => PROMPTSCRIPT_MARKERS.some((marker) => line.includes(marker)));
   } catch {
     return false;
   }
@@ -17310,7 +17476,7 @@ async function writeOutputs(outputs, options, _config, services) {
     const fileExists2 = existsSync7(outputPath);
     if (options.dryRun) {
       if (fileExists2) {
-        const isGenerated2 = await isPromptScriptGenerated(outputPath);
+        const isGenerated2 = await isPromptScriptGenerated2(outputPath);
         if (isGenerated2) {
           ConsoleOutput.dryRun(`Would overwrite: ${outputPath}`);
         } else {
@@ -17329,7 +17495,7 @@ async function writeOutputs(outputs, options, _config, services) {
       result.written.push(outputPath);
       continue;
     }
-    const isGenerated = await isPromptScriptGenerated(outputPath);
+    const isGenerated = await isPromptScriptGenerated2(outputPath);
     if (isGenerated) {
       await mkdir2(dirname5(outputPath), { recursive: true });
       await writeFile2(outputPath, output.content, "utf-8");
@@ -17397,12 +17563,16 @@ function printWarnings(warnings) {
 }
 async function compileCommand(options, services = createDefaultServices()) {
   const spinner = createSpinner("Loading configuration...").start();
+  const logger = createCliLogger();
   try {
+    logger.verbose("Loading configuration...");
     const config = await loadConfig(options.config);
     spinner.text = "Compiling...";
     const selectedTarget = options.target ?? options.format;
     const targets = selectedTarget ? [{ name: selectedTarget }] : parseTargets(config.targets);
     const registryPath = options.registry ?? config.registry?.path ?? "./registry";
+    logger.verbose(`Registry: ${registryPath}`);
+    logger.debug(`Config: ${JSON.stringify(config, null, 2)}`);
     const prettierOptions = await resolvePrettierOptions(config, process.cwd());
     const compiler = new Compiler({
       resolver: {
@@ -17412,7 +17582,8 @@ async function compileCommand(options, services = createDefaultServices()) {
       validator: config.validation,
       formatters: targets,
       customConventions: config.customConventions,
-      prettier: prettierOptions
+      prettier: prettierOptions,
+      logger
     });
     const entryPath = resolve4("./.promptscript/project.prs");
     if (!existsSync7(entryPath)) {
@@ -18061,19 +18232,23 @@ function printResults(results) {
 var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname7(__filename2);
 var program = new Command();
-program.name("prs").description("PromptScript CLI - Standardize AI instructions").version(getPackageVersion(__dirname2, "./package.json")).option("--verbose", "Enable verbose output").option("--quiet", "Suppress non-error output").hook("preAction", (thisCommand) => {
+program.name("prs").description("PromptScript CLI - Standardize AI instructions").version(getPackageVersion(__dirname2, "./package.json")).option("--verbose", "Enable verbose output").option("--debug", "Enable debug output (includes verbose)").option("--quiet", "Suppress non-error output").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts["quiet"]) {
     setContext({ logLevel: 0 /* Quiet */ });
+  } else if (opts["debug"]) {
+    setContext({ logLevel: 3 /* Debug */ });
   } else if (opts["verbose"]) {
     setContext({ logLevel: 2 /* Verbose */ });
   }
-  if (process.env["PROMPTSCRIPT_VERBOSE"] === "1" || process.env["PROMPTSCRIPT_VERBOSE"] === "true") {
+  if (process.env["PROMPTSCRIPT_DEBUG"] === "1" || process.env["PROMPTSCRIPT_DEBUG"] === "true") {
+    setContext({ logLevel: 3 /* Debug */ });
+  } else if (process.env["PROMPTSCRIPT_VERBOSE"] === "1" || process.env["PROMPTSCRIPT_VERBOSE"] === "true") {
     setContext({ logLevel: 2 /* Verbose */ });
   }
 });
 program.command("init").description("Initialize PromptScript in current directory").option("-n, --name <name>", "Project name (auto-detected from package.json, etc.)").option("-t, --team <team>", "Team namespace").option("--inherit <path>", "Inheritance path (e.g., @company/team)").option("--registry <path>", "Registry path").option("--targets <targets...>", "Target AI tools (github, claude, cursor)").option("-i, --interactive", "Force interactive mode").option("-y, --yes", "Skip prompts, use defaults").option("-f, --force", "Force reinitialize even if already initialized").action((opts) => initCommand(opts));
-program.command("compile").description("Compile PromptScript to target formats").option("-t, --target <target>", "Specific target (github, claude, cursor)").option("-f, --format <format>", "Output format (alias for --target)").option("-a, --all", "All configured targets", true).option("-w, --watch", "Watch mode").option("-o, --output <dir>", "Output directory").option("--dry-run", "Preview changes").option("--registry <path>", "Registry path (overrides config)").option("-c, --config <path>", "Path to custom config file").option("--force", "Force overwrite existing files without prompts").action(compileCommand);
+program.command("compile").description("Compile PromptScript to target formats").option("-t, --target <target>", "Specific target (github, claude, cursor)").option("-f, --format <format>", "Output format (alias for --target)").option("-a, --all", "All configured targets", true).option("-w, --watch", "Watch mode").option("-o, --output <dir>", "Output directory").option("--dry-run", "Preview changes").option("--registry <path>", "Registry path (overrides config)").option("-c, --config <path>", "Path to custom config file").option("--force", "Force overwrite existing files without prompts").action((opts) => compileCommand(opts));
 program.command("validate").description("Validate PromptScript files").option("--strict", "Treat warnings as errors").option("--format <format>", "Output format (text, json)", "text").action(validateCommand);
 program.command("pull").description("Pull updates from registry").option("-f, --force", "Force overwrite").option("--dry-run", "Preview changes without pulling").option("-b, --branch <name>", "Git branch to pull from").option("--tag <name>", "Git tag to pull from").option("--commit <hash>", "Git commit to pull from").option("--refresh", "Force re-fetch from remote (ignore cache)").action(pullCommand);
 program.command("diff").description("Show diff for compiled output").option("-t, --target <target>", "Specific target").option("-a, --all", "Show diff for all targets at once").option("--full", "Show full diff without truncation").option("--no-pager", "Disable pager output").option("--color", "Force colored output").option("--no-color", "Disable colored output").action(diffCommand);

package/package.json

@@ -1,50 +1,51 @@
 {
   "name": "@promptscript/cli",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.5",
   "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
+  "keywords": [
+    "cli",
+    "enterprise",
+    "typescript",
+    "devtools",
+    "infrastructure-as-code",
+    "cursor",
+    "developer-experience",
+    "governance",
+    "claude",
+    "ai-tools",
+    "github-copilot",
+    "llm",
+    "prompt-engineering",
+    "promptscript",
+    "antigravity",
+    "promptops"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/mrwogu/promptscript.git",
     "directory": "packages/cli"
   },
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
   "main": "./index.js",
+  "types": "./src/index.d.ts",
   "bin": {
     "prs": "./bin/prs.js",
     "promptscript": "./bin/prs.js"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@inquirer/prompts": "^8.2.0",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "commander": "^14.0.2",
     "ora": "^9.0.0",
-    "simple-git": "^3.22.0",
-    "yaml": "^2.8.2"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "cli",
-    "enterprise",
-    "typescript",
-    "devtools",
-    "infrastructure-as-code",
-    "cursor",
-    "developer-experience",
-    "governance",
-    "claude",
-    "ai-tools",
-    "github-copilot",
-    "llm",
-    "prompt-engineering",
-    "promptscript",
-    "antigravity",
-    "promptops"
-  ],
-  "license": "MIT"
+    "yaml": "^2.8.2",
+    "simple-git": "^3.22.0"
+  }
 }

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/cli/src/cli.ts"],"names":[],"mappings":";AAwGA;;;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":";AA6GA;;;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;AA+NzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA4Ef"}
+{"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;AAqPzE;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAkFf"}

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":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAKzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAyB/C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA+Ef"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAKzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA2B/C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAkGf"}

package/src/output/console.d.ts

@@ -8,7 +8,9 @@ export declare enum LogLevel {
     /** Normal output (default) */
     Normal = 1,
     /** Verbose output with additional details */
-    Verbose = 2
+    Verbose = 2,
+    /** Debug output with maximum details */
+    Debug = 3
 }
 /**
  * Global CLI context for sharing state across commands.
@@ -35,6 +37,10 @@ export declare function isVerbose(): boolean;
  * Check if quiet mode is enabled.
  */
 export declare function isQuiet(): boolean;
+/**
+ * Check if debug logging is enabled.
+ */
+export declare function isDebug(): boolean;
 /**
  * Creates a spinner for async operations.
  * Returns a no-op spinner in quiet mode.

package/src/output/console.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/output/console.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,oBAAY,QAAQ;IAClB,wCAAwC;IACxC,KAAK,IAAI;IACT,8BAA8B;IAC9B,MAAM,IAAI;IACV,6CAA6C;IAC7C,OAAO,IAAI;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAQ/C;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;;OAGG;mBACY,MAAM,GAAG,IAAI;IAI5B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAK3B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAK3B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;oBACa,MAAM,GAAG,IAAI;IAK7B;;OAEG;eACQ,IAAI;IAKf;;OAEG;oBACa,MAAM,GAAG,IAAI;IAK7B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;qBACc,MAAM,GAAG,MAAM;IAIhC;;OAEG;yBACkB,MAAM,SAAS,MAAM,WAAW,MAAM,GAAG,MAAM;CAUrE,CAAC"}
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/output/console.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,oBAAY,QAAQ;IAClB,wCAAwC;IACxC,KAAK,IAAI;IACT,8BAA8B;IAC9B,MAAM,IAAI;IACV,6CAA6C;IAC7C,OAAO,IAAI;IACX,wCAAwC;IACxC,KAAK,IAAI;CACV;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAQ/C;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;;OAGG;mBACY,MAAM,GAAG,IAAI;IAI5B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAK3B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAK3B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;qBACc,MAAM,GAAG,IAAI;IAK9B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;oBACa,MAAM,GAAG,IAAI;IAK7B;;OAEG;eACQ,IAAI;IAKf;;OAEG;oBACa,MAAM,GAAG,IAAI;IAK7B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAK5B;;OAEG;qBACc,MAAM,GAAG,MAAM;IAIhC;;OAEG;yBACkB,MAAM,SAAS,MAAM,WAAW,MAAM,GAAG,MAAM;CAUrE,CAAC"}

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

@@ -11,6 +11,8 @@ export interface AIToolsDetection {
     detected: AIToolTarget[];
     /** Details about detected files */
     details: Record<AIToolTarget, string[]>;
+    /** Files that exist but were NOT generated by PromptScript (candidates for migration) */
+    migrationCandidates: string[];
 }
 /**
  * Detect existing AI tool configurations.
@@ -29,4 +31,12 @@ export declare function getSuggestedTargets(detection: AIToolsDetection): AITool
  * Format detection results for display.
  */
 export declare function formatDetectionResults(detection: AIToolsDetection): string[];
+/**
+ * Check if there are migration candidates (non-PromptScript instruction files).
+ */
+export declare function hasMigrationCandidates(detection: AIToolsDetection): boolean;
+/**
+ * Format migration hint for display.
+ */
+export declare function formatMigrationHint(detection: AIToolsDetection): string[];
 //# sourceMappingURL=ai-tools-detector.d.ts.map

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,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1E;;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;CACzC;AA+CD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;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"}
+{"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,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1E;;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;AAgFD;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,WAAqC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CA4C3B;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"}

package/package.publish.json

@@ -1,50 +0,0 @@
-{
-  "name": "@promptscript/cli",
-  "version": "0.0.1",
-  "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mrwogu/promptscript.git",
-    "directory": "packages/cli"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "type": "module",
-  "main": "./index.js",
-  "bin": {
-    "prs": "./bin/prs.js",
-    "promptscript": "./bin/prs.js"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^8.2.0",
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "commander": "^14.0.2",
-    "ora": "^9.0.0",
-    "simple-git": "^3.22.0",
-    "yaml": "^2.8.2"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "cli",
-    "enterprise",
-    "typescript",
-    "devtools",
-    "infrastructure-as-code",
-    "cursor",
-    "developer-experience",
-    "governance",
-    "claude",
-    "ai-tools",
-    "github-copilot",
-    "llm",
-    "prompt-engineering",
-    "promptscript",
-    "antigravity",
-    "promptops"
-  ],
-  "license": "MIT"
-}