promptopskit 0.3.9 → 0.4.2

package/dist/cli/index.js

@@ -4,8 +4,8 @@
 import { readFileSync as readFileSync2 } from "fs";
 
 // src/cli/commands/validate.ts
-import { readdir } from "fs/promises";
-import { join as join2, extname } from "path";
+import { readdir, stat } from "fs/promises";
+import { join as join3, extname } from "path";
 
 // src/parser/parser.ts
 import matter from "gray-matter";
@@ -42,23 +42,42 @@ var ResponseSchema = z.object({
   stream: z.boolean().optional(),
   schema: z.record(z.unknown()).optional(),
   schema_name: z.string().optional(),
+  schema_description: z.string().optional(),
   schema_strict: z.boolean().optional()
 });
 var AnthropicProviderOptionsSchema = z.object({
   top_k: z.number().int().min(0).optional(),
-  tool_choice: z.record(z.unknown()).optional()
+  tool_choice: z.record(z.unknown()).optional(),
+  output_config: z.record(z.unknown()).optional()
 });
 var GeminiProviderOptionsSchema = z.object({
   candidate_count: z.number().int().positive().optional(),
   top_k: z.number().int().min(0).optional(),
   seed: z.number().int().optional(),
   response_schema: z.record(z.unknown()).optional(),
+  response_json_schema: z.record(z.unknown()).optional(),
   response_modalities: z.array(z.string()).optional(),
   thinking_budget_tokens: z.number().int().positive().optional()
 });
+var OpenRouterProviderOptionsSchema = z.object({
+  provider: z.record(z.unknown()).optional(),
+  transforms: z.array(z.string()).optional(),
+  plugins: z.array(z.record(z.unknown())).optional(),
+  models: z.array(z.string()).optional()
+});
 var ProviderOptionsSchema = z.object({
   anthropic: AnthropicProviderOptionsSchema.optional(),
-  gemini: GeminiProviderOptionsSchema.optional()
+  gemini: GeminiProviderOptionsSchema.optional(),
+  openrouter: OpenRouterProviderOptionsSchema.optional()
+});
+var RawProviderBodySchema = z.object({
+  openai: z.record(z.unknown()).optional(),
+  "openai-responses": z.record(z.unknown()).optional(),
+  openai_responses: z.record(z.unknown()).optional(),
+  anthropic: z.record(z.unknown()).optional(),
+  gemini: z.record(z.unknown()).optional(),
+  google: z.record(z.unknown()).optional(),
+  openrouter: z.record(z.unknown()).optional()
 });
 var OpenAICacheSchema = z.object({
   prompt_cache_key: z.string().min(1).optional(),
@@ -131,6 +150,7 @@ var PromptAssetOverridesSchema = z.object({
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
   cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
   tools: z.array(ToolRefSchema).optional(),
   provider_options: ProviderOptionsSchema.optional()
 });
@@ -163,6 +183,7 @@ var PromptAssetSchema = z.object({
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
   cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
   tools: z.array(ToolRefSchema).optional(),
   provider_options: ProviderOptionsSchema.optional(),
   mcp: MCPSchema.optional(),
@@ -176,6 +197,123 @@ var PromptAssetSchema = z.object({
   source: SourceSchema.optional()
 });
 
+// src/parser/frontmatter-guard.ts
+var FRONT_MATTER_DELIMITER = /^---[ \t]*$/;
+var REGEX_FIELD = /^(?<indent>\s*)(?<field>allow_regex|deny_regex)\s*:\s*(?<value>.*)$/;
+var PATTERN_FIELD = /^(?<indent>\s*)pattern\s*:\s*(?<value>.*)$/;
+var INLINE_PATTERN_FIELD = /(?:^|[{,]\s*)pattern\s*:\s*(?<value>"(?:\\.|[^"\\])*")/;
+function assertRegexFrontMatterQuoting(content, filePath) {
+  const frontMatter = extractFrontMatter(content);
+  if (!frontMatter) {
+    return;
+  }
+  let pendingRegex;
+  for (const [index, line] of frontMatter.lines.entries()) {
+    const lineNumber = frontMatter.startLine + index;
+    const regexMatch = line.match(REGEX_FIELD);
+    if (regexMatch?.groups) {
+      const field = regexMatch.groups.field;
+      const indent2 = regexMatch.groups.indent.length;
+      const value = regexMatch.groups.value.trim();
+      pendingRegex = value === "" ? { field, indent: indent2 } : void 0;
+      assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber);
+      assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber);
+      continue;
+    }
+    if (!pendingRegex) {
+      continue;
+    }
+    if (line.trim() === "" || line.trimStart().startsWith("#")) {
+      continue;
+    }
+    const indent = line.match(/^\s*/)?.[0].length ?? 0;
+    if (indent <= pendingRegex.indent) {
+      pendingRegex = void 0;
+      continue;
+    }
+    const patternMatch = line.match(PATTERN_FIELD);
+    if (!patternMatch?.groups) {
+      continue;
+    }
+    assertNoUnescapedBackslashInDoubleQuotedRegex(
+      patternMatch.groups.value.trim(),
+      `${pendingRegex.field}.pattern`,
+      filePath,
+      lineNumber
+    );
+  }
+}
+function assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber) {
+  const match = value.match(INLINE_PATTERN_FIELD);
+  const pattern = match?.groups?.value;
+  if (!pattern) {
+    return;
+  }
+  assertNoUnescapedBackslashInDoubleQuotedRegex(pattern, `${field}.pattern`, filePath, lineNumber);
+}
+function extractFrontMatter(content) {
+  const lines = content.split(/\r?\n/);
+  if (!FRONT_MATTER_DELIMITER.test(lines[0] ?? "")) {
+    return void 0;
+  }
+  for (let index = 1; index < lines.length; index += 1) {
+    if (FRONT_MATTER_DELIMITER.test(lines[index] ?? "")) {
+      return {
+        lines: lines.slice(1, index),
+        startLine: 2
+      };
+    }
+  }
+  return void 0;
+}
+function assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber) {
+  if (!value.startsWith('"')) {
+    return;
+  }
+  const quoted = readDoubleQuotedScalar(value);
+  if (!quoted) {
+    return;
+  }
+  if (!hasUnescapedBackslash(quoted)) {
+    return;
+  }
+  const location = filePath ? `${filePath}:${lineNumber}` : `line ${lineNumber}`;
+  throw new Error(
+    `POK013: Invalid context regex YAML at ${location}, field "${field}": double-quoted regex strings treat backslashes as YAML escapes. Use unquoted /pattern/i literal form, single quotes, or double each backslash.`
+  );
+}
+function readDoubleQuotedScalar(value) {
+  let result = "";
+  for (let index = 1; index < value.length; index += 1) {
+    const char = value[index];
+    if (char === '"') {
+      return result;
+    }
+    result += char;
+    if (char === "\\" && index + 1 < value.length) {
+      index += 1;
+      result += value[index];
+    }
+  }
+  return void 0;
+}
+function hasUnescapedBackslash(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    if (value[index] !== "\\") {
+      continue;
+    }
+    let count = 1;
+    while (value[index + count] === "\\") {
+      count += 1;
+    }
+    if (count % 2 === 1) {
+      return true;
+    }
+    index += count - 1;
+  }
+  return false;
+}
+
 // src/parser/sections.ts
 var SECTION_MAP = {
   "system instructions": "system_instructions",
@@ -216,6 +354,7 @@ function extractSections(body) {
 
 // src/parser/parser.ts
 function parsePrompt(content, filePath) {
+  assertRegexFrontMatterQuoting(content, filePath);
   const { data: frontMatter, content: body } = matter(content);
   const sections = extractSections(body);
   const raw = {
@@ -293,6 +432,7 @@ function mergeDefaults(base, local) {
   return {
     provider: local.provider ?? base.provider,
     model: local.model ?? base.model,
+    cache: mergeCache(base.cache, local.cache),
     metadata: {
       ...base.metadata ?? {},
       ...local.metadata ?? {}
@@ -304,10 +444,12 @@ function mergeDefaults(base, local) {
   };
 }
 function applyDefaults(asset, defaults) {
+  const cache = mergeCache(defaults.cache, asset.cache);
   const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;
   const hasDefaultSystem = !!defaults.sections?.system_instructions;
   const hasDefaultScalars = defaults.provider !== void 0 || defaults.model !== void 0;
-  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {
+  const hasDefaultCache = cache !== void 0;
+  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars && !hasDefaultCache) {
     return asset;
   }
   const mergedMetadata = {
@@ -321,10 +463,38 @@ function applyDefaults(asset, defaults) {
     ...asset,
     provider: asset.provider ?? defaults.provider,
     model: asset.model ?? defaults.model,
+    cache,
     metadata,
     sections
   };
 }
+function mergeCache(base, local) {
+  const merged = {
+    ...base ?? {},
+    ...local ?? {},
+    openai: {
+      ...base?.openai ?? {},
+      ...local?.openai ?? {}
+    },
+    anthropic: {
+      ...base?.anthropic ?? {},
+      ...local?.anthropic ?? {}
+    },
+    gemini: {
+      ...base?.gemini ?? {},
+      ...local?.gemini ?? {}
+    },
+    google: {
+      ...base?.google ?? {},
+      ...local?.google ?? {}
+    }
+  };
+  if (merged.openai && Object.keys(merged.openai).length === 0) delete merged.openai;
+  if (merged.anthropic && Object.keys(merged.anthropic).length === 0) delete merged.anthropic;
+  if (merged.gemini && Object.keys(merged.gemini).length === 0) delete merged.gemini;
+  if (merged.google && Object.keys(merged.google).length === 0) delete merged.google;
+  return Object.keys(merged).length > 0 ? merged : void 0;
+}
 
 // src/renderer/interpolate.ts
 var VARIABLE_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -542,8 +712,21 @@ var KNOWN_FRONT_MATTER_KEYS = /* @__PURE__ */ new Set([
   "environments",
   "tiers",
   "metadata",
-  "cache"
+  "cache",
+  "provider_options",
+  "raw"
 ]);
+var RISKY_UNBOUNDED_INPUT_NAMES = [
+  "message",
+  "prompt",
+  "history",
+  "transcript",
+  "document",
+  "content",
+  "input",
+  "body",
+  "context"
+];
 function validateAsset(asset, frontMatterKeys, filePath) {
   const errors = [];
   const warnings = [];
@@ -614,7 +797,32 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       });
     }
   }
+  if (usedVars.size > 0 && (!asset.context?.inputs || asset.context.inputs.length === 0)) {
+    warnings.push({
+      code: "POK046",
+      message: `Template uses ${usedVars.size === 1 ? "a variable" : "variables"} but context.inputs is not declared.`,
+      filePath,
+      suggestion: "Declare context.inputs to enable input policy validation."
+    });
+  }
   for (const input of getContextInputs(asset)) {
+    const lowerName = input.name.toLowerCase();
+    if (input.max_size === void 0 && RISKY_UNBOUNDED_INPUT_NAMES.some((needle) => lowerName.includes(needle))) {
+      warnings.push({
+        code: "POK040",
+        message: `Context input "${input.name}" has no max_size and appears unbounded.`,
+        filePath,
+        suggestion: "Add max_size to constrain prompt payload growth."
+      });
+    }
+    if (input.allow_regex === void 0 && input.deny_regex === void 0 && input.non_empty === void 0 && input.reject_secrets === void 0) {
+      warnings.push({
+        code: "POK041",
+        message: `Context input "${input.name}" has no input hardening validators.`,
+        filePath,
+        suggestion: "Consider non_empty/reject_secrets and allow/deny regex validators."
+      });
+    }
     if (input.trim !== void 0 && input.trim !== false && input.max_size === void 0) {
       warnings.push({
         code: "POK014",
@@ -642,6 +850,91 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       }
     }
   }
+  if (asset.provider) {
+    let providerCache;
+    let cacheSuggestionField;
+    switch (asset.provider) {
+      case "openai":
+        providerCache = asset.cache?.openai;
+        cacheSuggestionField = "cache.openai";
+        break;
+      case "anthropic":
+        providerCache = asset.cache?.anthropic;
+        cacheSuggestionField = "cache.anthropic";
+        break;
+      case "gemini":
+      case "google":
+        providerCache = asset.cache?.gemini ?? asset.cache?.google;
+        cacheSuggestionField = "cache.gemini";
+        break;
+      default:
+        break;
+    }
+    if (cacheSuggestionField && providerCache === void 0) {
+      warnings.push({
+        code: "POK042",
+        message: `Provider "${asset.provider}" has no provider-specific cache settings.`,
+        filePath,
+        suggestion: `Consider configuring ${cacheSuggestionField} for better cache-hit behavior.`
+      });
+    }
+    if (!asset.model) {
+      warnings.push({
+        code: "POK044",
+        message: `Provider "${asset.provider}" is configured without a model.`,
+        filePath,
+        suggestion: "Set model in prompt or defaults to avoid adapter-time errors."
+      });
+    }
+  }
+  if (asset.cache?.gemini?.cached_content && asset.cache.google?.cached_content && asset.cache.gemini.cached_content !== asset.cache.google.cached_content) {
+    warnings.push({
+      code: "POK043",
+      message: "cache.gemini.cached_content and cache.google.cached_content are both set to different values.",
+      filePath,
+      suggestion: "Use one canonical value; Gemini prefers cache.gemini.cached_content."
+    });
+  }
+  for (const [envName, overrides] of Object.entries(asset.environments ?? {})) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
+      warnings.push({
+        code: "POK045",
+        message: `Environment "${envName}" does not override cache while prompt-level cache is defined.`,
+        filePath,
+        suggestion: "Confirm cache strategy is intentionally shared across environments."
+      });
+    }
+  }
+  for (const [tierName, overrides] of Object.entries(asset.tiers ?? {})) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
+      warnings.push({
+        code: "POK045",
+        message: `Tier "${tierName}" does not override cache while prompt-level cache is defined.`,
+        filePath,
+        suggestion: "Confirm cache strategy is intentionally shared across tiers."
+      });
+    }
+  }
+  for (const tool of asset.tools ?? []) {
+    if (isRecord(tool)) {
+      if (!tool.description) {
+        warnings.push({
+          code: "POK047",
+          message: `Inline tool "${tool.name}" is missing a description.`,
+          filePath,
+          suggestion: "Add description to improve model tool-selection quality."
+        });
+      }
+      if (!tool.input_schema) {
+        warnings.push({
+          code: "POK047",
+          message: `Inline tool "${tool.name}" is missing input_schema.`,
+          filePath,
+          suggestion: "Add input_schema so tool inputs are strongly typed."
+        });
+      }
+    }
+  }
   return {
     valid: errors.length === 0,
     errors,
@@ -678,6 +971,9 @@ function findClosestMatch(input, candidates) {
   }
   return best;
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/prompt-resolution.ts
 import { readFile as readFile3 } from "fs/promises";
@@ -696,8 +992,8 @@ var PromptCache = class {
     const entry = this.cache.get(filePath);
     if (!entry) return void 0;
     try {
-      const stat = statSync(filePath);
-      if (stat.mtimeMs !== entry.mtime) {
+      const stat2 = statSync(filePath);
+      if (stat2.mtimeMs !== entry.mtime) {
         this.cache.delete(filePath);
         return void 0;
       }
@@ -711,14 +1007,14 @@ var PromptCache = class {
   }
   set(filePath, value) {
     try {
-      const stat = statSync(filePath);
+      const stat2 = 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 });
+      this.cache.set(filePath, { value, mtime: stat2.mtimeMs });
     } catch {
     }
   }
@@ -758,6 +1054,29 @@ function mergeOverride(base, override) {
   if (override.response !== void 0) {
     result.response = { ...result.response, ...override.response };
   }
+  if (override.cache !== void 0) {
+    result.cache = {
+      ...result.cache,
+      ...override.cache,
+      openai: mergeRecordBlock(result.cache?.openai, override.cache.openai),
+      anthropic: mergeRecordBlock(result.cache?.anthropic, override.cache.anthropic),
+      gemini: mergeRecordBlock(result.cache?.gemini, override.cache.gemini),
+      google: mergeRecordBlock(result.cache?.google, override.cache.google)
+    };
+  }
+  if (override.raw !== void 0) {
+    result.raw = {
+      ...result.raw,
+      ...override.raw,
+      openai: mergeRecordBlock(result.raw?.openai, override.raw.openai),
+      "openai-responses": mergeRecordBlock(result.raw?.["openai-responses"], override.raw["openai-responses"]),
+      openai_responses: mergeRecordBlock(result.raw?.openai_responses, override.raw.openai_responses),
+      anthropic: mergeRecordBlock(result.raw?.anthropic, override.raw.anthropic),
+      gemini: mergeRecordBlock(result.raw?.gemini, override.raw.gemini),
+      google: mergeRecordBlock(result.raw?.google, override.raw.google),
+      openrouter: mergeRecordBlock(result.raw?.openrouter, override.raw.openrouter)
+    };
+  }
   if (override.provider_options !== void 0) {
     result.provider_options = {
       ...result.provider_options,
@@ -769,11 +1088,19 @@ function mergeOverride(base, override) {
       gemini: {
         ...result.provider_options?.gemini,
         ...override.provider_options.gemini
+      },
+      openrouter: {
+        ...result.provider_options?.openrouter,
+        ...override.provider_options.openrouter
       }
     };
   }
   return result;
 }
+function mergeRecordBlock(base, override) {
+  if (override === void 0) return base;
+  return { ...base, ...override };
+}
 
 // src/prompt-resolution.ts
 var DEFAULT_PROMPTS_DIR = "./prompts";
@@ -784,11 +1111,33 @@ function defaultCompiledDirForFormat(format) {
 }
 var sharedPromptCache = new PromptCache();
 
+// src/cli/commands/defaults-root.ts
+import { existsSync as existsSync2 } from "fs";
+import { dirname as dirname3, join as join2, resolve as resolve4 } from "path";
+function findDefaultsRoot(filePath) {
+  let current = resolve4(dirname3(filePath));
+  let root = current;
+  let foundDefaults = false;
+  while (true) {
+    if (existsSync2(join2(current, "defaults.md"))) {
+      root = current;
+      foundDefaults = true;
+    } else if (foundDefaults) {
+      return root;
+    }
+    const parent = dirname3(current);
+    if (parent === current) {
+      return root;
+    }
+    current = parent;
+  }
+}
+
 // src/cli/commands/validate.ts
 var HELP = `
 promptopskit validate [sourceDir] [options]
 
-Validate all prompt .md files in a directory.
+Validate prompt .md files in a directory or a single prompt file.
 
 Options:
   --source, -s  Source directory (default: ./prompts)
@@ -801,18 +1150,19 @@ async function validate(args) {
     return;
   }
   const positional = getPositionalArgs(args, /* @__PURE__ */ new Set(["--source", "-s"]));
-  const dir = getFlag(args, "--source", "-s") ?? positional[0] ?? DEFAULT_PROMPTS_DIR;
+  const target = getFlag(args, "--source", "-s") ?? positional[0] ?? DEFAULT_PROMPTS_DIR;
   const strict = args.includes("--strict");
-  const files = await collectPromptFiles(dir);
+  const files = await collectPromptFiles(target);
   if (files.length === 0) {
-    console.log(`No .md prompt files found in ${dir}`);
+    console.log(`No .md prompt files found in ${target}`);
     return;
   }
   let errorCount = 0;
   let warnCount = 0;
   for (const file of files) {
     try {
-      const { asset, raw } = await loadPromptFile(file, { defaultsRoot: dir });
+      const defaultsRoot = files.length === 1 && file === target ? findDefaultsRoot(file) : target;
+      const { asset, raw } = await loadPromptFile(file, { defaultsRoot });
       const result = await validateAssetWithIncludes(asset, file, Object.keys(raw.frontMatter));
       if (result.errors.length > 0) {
         errorCount += result.errors.length;
@@ -867,12 +1217,19 @@ function getFlag(args, ...flags) {
   }
   return void 0;
 }
-async function collectPromptFiles(dir) {
+async function collectPromptFiles(target) {
+  const targetStats = await stat(target);
+  if (targetStats.isFile()) {
+    if (extname(target) !== ".md" || target.endsWith("defaults.md") || target.endsWith(".test.md")) {
+      return [];
+    }
+    return [target];
+  }
   const results = [];
-  const entries = await readdir(dir, { withFileTypes: true, recursive: true });
+  const entries = await readdir(target, { withFileTypes: true, recursive: true });
   for (const entry of entries) {
     if (entry.isFile() && extname(entry.name) === ".md" && !entry.name.endsWith(".test.md") && entry.name !== "defaults.md") {
-      results.push(join2(entry.parentPath ?? dir, entry.name));
+      results.push(join3(entry.parentPath ?? target, entry.name));
     }
   }
   return results.sort();
@@ -880,7 +1237,7 @@ 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";
+import { join as join4, extname as extname2, relative, dirname as dirname5 } from "path";
 var HELP2 = `
 promptopskit compile [sourceDir] [outputDir] [options]
 
@@ -922,7 +1279,7 @@ async function compile(args) {
   for (const file of files) {
     const rel = relative(sourceDir, file).replace(/\.md$/, "");
     const outExt = format === "esm" ? ".mjs" : ".json";
-    const outPath = join3(outputDir, rel + outExt);
+    const outPath = join4(outputDir, rel + outExt);
     try {
       const { asset: parsed, raw } = await loadPromptFile(file, { defaultsRoot: sourceDir });
       const validation = await validateAssetWithIncludes(parsed, file, Object.keys(raw.frontMatter));
@@ -933,7 +1290,7 @@ async function compile(args) {
       if (dryRun) {
         console.log(`  Would create: ${outPath}`);
       } else {
-        await mkdir(dirname3(outPath), { recursive: true });
+        await mkdir(dirname5(outPath), { recursive: true });
         if (format === "esm") {
           const esmContent = `export default ${JSON.stringify(asset, null, 2)};
 `;
@@ -990,7 +1347,7 @@ async function collectPromptFiles2(dir) {
   const entries = await readdir2(dir, { withFileTypes: true, recursive: true });
   for (const entry of entries) {
     if (entry.isFile() && extname2(entry.name) === ".md" && !entry.name.endsWith(".test.md") && entry.name !== "defaults.md") {
-      results.push(join3(entry.parentPath ?? dir, entry.name));
+      results.push(join4(entry.parentPath ?? dir, entry.name));
     }
   }
   return results.sort();
@@ -999,30 +1356,6 @@ async function collectPromptFiles2(dir) {
 // src/cli/commands/render.ts
 import { readFile as readFile4 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
-
-// src/cli/commands/defaults-root.ts
-import { existsSync as existsSync2 } from "fs";
-import { dirname as dirname4, join as join4, resolve as resolve4 } from "path";
-function findDefaultsRoot(filePath) {
-  let current = resolve4(dirname4(filePath));
-  let root = current;
-  let foundDefaults = false;
-  while (true) {
-    if (existsSync2(join4(current, "defaults.md"))) {
-      root = current;
-      foundDefaults = true;
-    } else if (foundDefaults) {
-      return root;
-    }
-    const parent = dirname4(current);
-    if (parent === current) {
-      return root;
-    }
-    current = parent;
-  }
-}
-
-// src/cli/commands/render.ts
 var HELP3 = `
 promptopskit render <file> [options]
 
@@ -1157,7 +1490,7 @@ 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 { join as join5, dirname as dirname6, relative as relative2 } from "path";
 import { existsSync as existsSync4, readFileSync } from "fs";
 var HELP5 = `
 promptopskit init [dir]
@@ -1229,10 +1562,14 @@ var TEST_SIDECAR = `cases:
     variables:
       name: "World"
       app_context: "Welcome screen"
+    response:
+      message: "Hello, World! How can I help you today?"
   - name: named-greeting
     variables:
       name: "Alice"
       app_context: "Settings page"
+    response:
+      message: "Hello, Alice! How can I help you today?"
 `;
 var EXAMPLE_USAGE = `// Example: render the hello prompt and send it to OpenAI
 // Full docs: https://promptopskit.com/docs/index.html#/
@@ -1304,12 +1641,16 @@ async function init(args) {
     return;
   }
   const dir = args.find((a) => !a.startsWith("--")) ?? "./prompts";
+  const testFilePath = join5(dirname6(dir), "tests", "hello.prompt.test.mjs");
+  const promptsDirFromTest = relative2(dirname6(testFilePath), dir) || ".";
+  const helloPromptTest = createHelloPromptTest(promptsDirFromTest);
   const files = [
     { path: join5(dir, "defaults.md"), content: DEFAULTS },
     { path: join5(dir, "hello.md"), content: HELLO_PROMPT },
     { path: join5(dir, "hello.test.yaml"), content: TEST_SIDECAR },
     { path: join5(dir, "shared", "tone.md"), content: TONE_INCLUDE },
-    { path: join5(dir, "example-usage.ts"), content: EXAMPLE_USAGE }
+    { path: join5(dir, "example-usage.ts"), content: EXAMPLE_USAGE },
+    { path: testFilePath, content: helloPromptTest }
   ];
   let created = 0;
   let skipped = 0;
@@ -1319,7 +1660,7 @@ async function init(args) {
       skipped++;
       continue;
     }
-    await mkdir2(dirname5(file.path), { recursive: true });
+    await mkdir2(dirname6(file.path), { recursive: true });
     await writeFile2(file.path, file.content, "utf-8");
     console.log(`  \u2713 ${file.path}`);
     created++;
@@ -1334,14 +1675,61 @@ async function init(args) {
         console.log(`Tip: Add to your package.json scripts:`);
         console.log(`  "build:prompts": "promptopskit compile ${dir}"`);
       }
+      if (!pkg.scripts?.test) {
+        console.log();
+        console.log(`Tip: Add a test script to run the generated prompt test:`);
+        console.log(`  "test": "node --test tests/*.test.mjs"`);
+      }
     } catch {
     }
   }
 }
+function createHelloPromptTest(promptsDirFromTest) {
+  return `import assert from 'node:assert/strict';
+import { dirname, resolve } from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { createPromptOpsKit } from 'promptopskit';
+import {
+  getHardcodedPromptResponse,
+  loadPromptTestSidecar,
+  renderPromptTestCase,
+} from 'promptopskit/testing';
+
+const testDir = dirname(fileURLToPath(import.meta.url));
+const promptsDir = resolve(testDir, ${JSON.stringify(promptsDirFromTest)});
+
+test('hello prompt renders every sidecar case', async () => {
+  const kit = createPromptOpsKit({ sourceDir: promptsDir, cache: false });
+  const sidecar = await loadPromptTestSidecar(resolve(promptsDir, 'hello.test.yaml'));
+
+  for (const testCase of sidecar.cases) {
+    const { rendered } = await renderPromptTestCase(kit, {
+      sidecar,
+      caseName: testCase.name,
+      path: 'hello',
+      provider: 'openai',
+      environment: 'dev',
+      strict: true,
+    });
+
+    assert.ok(rendered.request?.body?.messages);
+  }
+});
+
+test('hello prompt can return a deterministic response without calling a model', async () => {
+  const sidecar = await loadPromptTestSidecar(resolve(promptsDir, 'hello.test.yaml'));
+
+  assert.deepEqual(getHardcodedPromptResponse(sidecar, 'basic-greeting'), {
+    message: 'Hello, World! How can I help you today?',
+  });
+});
+`;
+}
 
 // src/cli/commands/skill.ts
 import { writeFile as writeFile3, readFile as readFile5, mkdir as mkdir3 } from "fs/promises";
-import { dirname as dirname6 } from "path";
+import { dirname as dirname7 } from "path";
 import { existsSync as existsSync5 } from "fs";
 var MARKER_START = "<!-- promptopskit:start -->";
 var MARKER_END = "<!-- promptopskit:end -->";
@@ -1440,7 +1828,7 @@ async function skill(args) {
       written++;
       continue;
     }
-    await mkdir3(dirname6(filePath), { recursive: true });
+    await mkdir3(dirname7(filePath), { recursive: true });
     await writeFile3(filePath, markedContent, "utf-8");
     console.log(`  \u2713 ${filePath}`);
     written++;
@@ -1453,7 +1841,7 @@ async function skill(args) {
 async function deployClaude(filePath, force) {
   const content = CLAUDE_LINE + "\n";
   if (!existsSync5(filePath) || force) {
-    await mkdir3(dirname6(filePath), { recursive: true });
+    await mkdir3(dirname7(filePath), { recursive: true });
     await writeFile3(filePath, content, "utf-8");
     console.log(`  \u2713 ${filePath}`);
     return 1;