promptopskit 0.3.3 → 0.3.5

package/dist/cli/index.js

@@ -568,12 +568,107 @@ async function collectPromptFiles(dir) {
 // src/cli/commands/compile.ts
 import { readdir as readdir2, writeFile, mkdir, rm } from "fs/promises";
 import { join as join3, extname as extname2, relative, dirname as dirname3 } from "path";
+
+// src/prompt-resolution.ts
+import { readFile as readFile3 } from "fs/promises";
+import { existsSync, statSync as statSync2 } from "fs";
+import { resolve as resolve3 } from "path";
+
+// src/cache.ts
+import { statSync } from "fs";
+var PromptCache = class {
+  cache = /* @__PURE__ */ new Map();
+  maxSize;
+  constructor(maxSize = 100) {
+    this.maxSize = maxSize;
+  }
+  get(filePath) {
+    const entry = this.cache.get(filePath);
+    if (!entry) return void 0;
+    try {
+      const stat = statSync(filePath);
+      if (stat.mtimeMs !== entry.mtime) {
+        this.cache.delete(filePath);
+        return void 0;
+      }
+    } catch {
+      this.cache.delete(filePath);
+      return void 0;
+    }
+    this.cache.delete(filePath);
+    this.cache.set(filePath, entry);
+    return entry.value;
+  }
+  set(filePath, value) {
+    try {
+      const stat = statSync(filePath);
+      if (this.cache.has(filePath)) {
+        this.cache.delete(filePath);
+      } else if (this.cache.size >= this.maxSize) {
+        const oldest = this.cache.keys().next().value;
+        if (oldest) this.cache.delete(oldest);
+      }
+      this.cache.set(filePath, { value, mtime: stat.mtimeMs });
+    } catch {
+    }
+  }
+  clear() {
+    this.cache.clear();
+  }
+  get size() {
+    return this.cache.size;
+  }
+};
+
+// src/overrides/apply-overrides.ts
+function applyOverrides(asset, options = {}) {
+  let result = { ...asset };
+  if (options.environment && result.environments?.[options.environment]) {
+    result = mergeOverride(result, result.environments[options.environment]);
+  }
+  if (options.tier && result.tiers?.[options.tier]) {
+    result = mergeOverride(result, result.tiers[options.tier]);
+  }
+  if (options.runtime) {
+    result = mergeOverride(result, options.runtime);
+  }
+  return result;
+}
+function mergeOverride(base, override) {
+  const result = { ...base };
+  if (override.model !== void 0) result.model = override.model;
+  if (override.fallback_models !== void 0) result.fallback_models = override.fallback_models;
+  if (override.tools !== void 0) result.tools = override.tools;
+  if (override.reasoning !== void 0) {
+    result.reasoning = { ...result.reasoning, ...override.reasoning };
+  }
+  if (override.sampling !== void 0) {
+    result.sampling = { ...result.sampling, ...override.sampling };
+  }
+  if (override.response !== void 0) {
+    result.response = { ...result.response, ...override.response };
+  }
+  return result;
+}
+
+// src/prompt-resolution.ts
+var DEFAULT_PROMPTS_DIR = "./prompts";
+var DEFAULT_COMPILED_JSON_DIR = "./.generated-prompts/json";
+var DEFAULT_COMPILED_ESM_DIR = "./.generated-prompts/esm";
+function defaultCompiledDirForFormat(format) {
+  return format === "esm" ? DEFAULT_COMPILED_ESM_DIR : DEFAULT_COMPILED_JSON_DIR;
+}
+var sharedPromptCache = new PromptCache();
+
+// src/cli/commands/compile.ts
 var HELP2 = `
-promptopskit compile <sourceDir> <outputDir> [options]
+promptopskit compile [sourceDir] [outputDir] [options]
 
-Compile .md prompt files to JSON artifacts.
+Compile .md prompt files to JSON or ESM artifacts.
 
 Options:
+  --source, -s   Source directory (default: ./prompts)
+  --output, -o   Output directory (default: ./.generated-prompts/<format>)
   --no-clean     Don't clear the output directory before compiling
   --dry-run      Show what would be compiled without writing files
   --format       Output format: json (default) or esm
@@ -584,14 +679,7 @@ async function compile(args) {
     console.log(HELP2);
     return;
   }
-  const positional = args.filter((a) => !a.startsWith("--"));
-  const sourceDir = positional[0];
-  const outputDir = positional[1];
-  if (!sourceDir || !outputDir) {
-    console.error("Error: Please provide source and output directories.");
-    console.error("Usage: promptopskit compile <sourceDir> <outputDir>");
-    process.exit(1);
-  }
+  const positional = getPositionalArgs(args, /* @__PURE__ */ new Set(["--format", "--source", "--output", "-s", "-o"]));
   const dryRun = args.includes("--dry-run");
   const noClean = args.includes("--no-clean");
   const format = getFlag(args, "--format") ?? "json";
@@ -599,6 +687,8 @@ async function compile(args) {
     console.error(`Error: Unknown format "${format}". Use "json" or "esm".`);
     process.exit(1);
   }
+  const sourceDir = getFlag(args, "--source", "-s") ?? positional[0] ?? DEFAULT_PROMPTS_DIR;
+  const outputDir = getFlag(args, "--output", "-o") ?? positional[1] ?? defaultCompiledDirForFormat(format);
   const files = await collectPromptFiles2(sourceDir);
   if (files.length === 0) {
     console.log(`No .md prompt files found in ${sourceDir}`);
@@ -647,10 +737,27 @@ async function compile(args) {
     process.exit(1);
   }
 }
-function getFlag(args, flag) {
-  const idx = args.indexOf(flag);
-  if (idx >= 0 && idx + 1 < args.length) {
-    return args[idx + 1];
+function getPositionalArgs(args, flagsWithValues) {
+  const positional = [];
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (flagsWithValues.has(arg)) {
+      index++;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      continue;
+    }
+    positional.push(arg);
+  }
+  return positional;
+}
+function getFlag(args, ...flags) {
+  for (const flag of flags) {
+    const idx = args.indexOf(flag);
+    if (idx >= 0 && idx + 1 < args.length) {
+      return args[idx + 1];
+    }
   }
   return void 0;
 }
@@ -666,49 +773,18 @@ async function collectPromptFiles2(dir) {
 }
 
 // src/cli/commands/render.ts
-import { readFile as readFile3 } from "fs/promises";
-import { existsSync as existsSync2 } from "fs";
-
-// src/overrides/apply-overrides.ts
-function applyOverrides(asset, options = {}) {
-  let result = { ...asset };
-  if (options.environment && result.environments?.[options.environment]) {
-    result = mergeOverride(result, result.environments[options.environment]);
-  }
-  if (options.tier && result.tiers?.[options.tier]) {
-    result = mergeOverride(result, result.tiers[options.tier]);
-  }
-  if (options.runtime) {
-    result = mergeOverride(result, options.runtime);
-  }
-  return result;
-}
-function mergeOverride(base, override) {
-  const result = { ...base };
-  if (override.model !== void 0) result.model = override.model;
-  if (override.fallback_models !== void 0) result.fallback_models = override.fallback_models;
-  if (override.tools !== void 0) result.tools = override.tools;
-  if (override.reasoning !== void 0) {
-    result.reasoning = { ...result.reasoning, ...override.reasoning };
-  }
-  if (override.sampling !== void 0) {
-    result.sampling = { ...result.sampling, ...override.sampling };
-  }
-  if (override.response !== void 0) {
-    result.response = { ...result.response, ...override.response };
-  }
-  return result;
-}
+import { readFile as readFile4 } from "fs/promises";
+import { existsSync as existsSync3 } from "fs";
 
 // src/cli/commands/defaults-root.ts
-import { existsSync } from "fs";
-import { dirname as dirname4, join as join4, resolve as resolve3 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { dirname as dirname4, join as join4, resolve as resolve4 } from "path";
 function findDefaultsRoot(filePath) {
-  let current = resolve3(dirname4(filePath));
+  let current = resolve4(dirname4(filePath));
   let root = current;
   let foundDefaults = false;
   while (true) {
-    if (existsSync(join4(current, "defaults.md"))) {
+    if (existsSync2(join4(current, "defaults.md"))) {
       root = current;
       foundDefaults = true;
     } else if (foundDefaults) {
@@ -751,13 +827,13 @@ async function render(args) {
   const jsonOutput = args.includes("--json");
   let variables = {};
   if (varsFile) {
-    const varsContent = await readFile3(varsFile, "utf-8");
+    const varsContent = await readFile4(varsFile, "utf-8");
     variables = JSON.parse(varsContent);
   } else {
     const sidecarPath = file.replace(/\.md$/, ".test.yaml");
-    if (existsSync2(sidecarPath)) {
+    if (existsSync3(sidecarPath)) {
       const { default: yaml } = await import("gray-matter");
-      const sidecarContent = await readFile3(sidecarPath, "utf-8");
+      const sidecarContent = await readFile4(sidecarPath, "utf-8");
       const parsed2 = yaml(`---
 ${sidecarContent}---
 `);
@@ -842,12 +918,15 @@ async function inspect(args) {
 // src/cli/commands/init.ts
 import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { join as join5, dirname as dirname5 } from "path";
-import { existsSync as existsSync3, readFileSync } from "fs";
+import { existsSync as existsSync4, readFileSync } from "fs";
 var HELP5 = `
 promptopskit init [dir]
 
 Scaffold a prompts directory with starter files.
 
+Arguments:
+  dir            Target directory (default: ./prompts)
+
 Options:
   --help, -h     Show this help
 `.trim();
@@ -990,7 +1069,7 @@ async function init(args) {
   let created = 0;
   let skipped = 0;
   for (const file of files) {
-    if (existsSync3(file.path)) {
+    if (existsSync4(file.path)) {
       console.log(`  skip ${file.path} (already exists)`);
       skipped++;
       continue;
@@ -1002,13 +1081,13 @@ async function init(args) {
   }
   console.log();
   console.log(`Created ${created} file(s), skipped ${skipped} existing.`);
-  if (existsSync3("package.json")) {
+  if (existsSync4("package.json")) {
     try {
       const pkg = JSON.parse(readFileSync("package.json", "utf-8"));
       if (!pkg.scripts?.["build:prompts"]) {
         console.log();
         console.log(`Tip: Add to your package.json scripts:`);
-        console.log(`  "build:prompts": "promptopskit compile ${dir} ./dist/prompts"`);
+        console.log(`  "build:prompts": "promptopskit compile ${dir}"`);
       }
     } catch {
     }
@@ -1016,9 +1095,9 @@ async function init(args) {
 }
 
 // src/cli/commands/skill.ts
-import { writeFile as writeFile3, readFile as readFile4, mkdir as mkdir3 } from "fs/promises";
+import { writeFile as writeFile3, readFile as readFile5, mkdir as mkdir3 } from "fs/promises";
 import { dirname as dirname6 } from "path";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 var MARKER_START = "<!-- promptopskit:start -->";
 var MARKER_END = "<!-- promptopskit:end -->";
 var HELP6 = `
@@ -1104,8 +1183,8 @@ async function skill(args) {
       continue;
     }
     const markedContent = config.wrap(wrapMarkers(STUB_CONTENT));
-    if (existsSync4(filePath) && !force) {
-      const existing = await readFile4(filePath, "utf-8");
+    if (existsSync5(filePath) && !force) {
+      const existing = await readFile5(filePath, "utf-8");
       const merged = mergeContent(existing, markedContent);
       if (merged === existing) {
         console.log(`  skip ${filePath} (already up to date)`);
@@ -1128,13 +1207,13 @@ async function skill(args) {
 }
 async function deployClaude(filePath, force) {
   const content = CLAUDE_LINE + "\n";
-  if (!existsSync4(filePath) || force) {
+  if (!existsSync5(filePath) || force) {
     await mkdir3(dirname6(filePath), { recursive: true });
     await writeFile3(filePath, content, "utf-8");
     console.log(`  \u2713 ${filePath}`);
     return 1;
   }
-  const existing = await readFile4(filePath, "utf-8");
+  const existing = await readFile5(filePath, "utf-8");
   if (existing.split("\n").some((line) => line.trim() === CLAUDE_LINE)) {
     console.log(`  skip ${filePath} (already up to date)`);
     return 0;
@@ -1169,7 +1248,7 @@ Usage:
 Commands:
   init [dir]                           Scaffold a prompts directory with starter files
   validate <dir>                       Validate prompt files
-  compile <src> <out> [options]        Compile .md prompts to JSON/ESM artifacts
+  compile [src] [out] [options]        Compile .md prompts to JSON/ESM artifacts
   render <file> [options]              Render a prompt preview
   inspect <file>                       Print normalized prompt asset
   skill [options]                      Deploy AI agent instructions into your project