@promptscript/cli 1.19.0 → 1.19.1

package/README.md

@@ -20,9 +20,19 @@ native configuration for 50 AI coding platforms.
 
 [![Watch the PromptScript introduction](https://img.youtube.com/vi/7sHMn-DbZig/maxresdefault.jpg)](https://youtu.be/7sHMn-DbZig)
 
-AI coding platforms use different files for instructions, skills, agents, commands, MCP
-integrations, hooks, and settings. PromptScript replaces hand-maintained copies with one validated,
-composable, Git-native source and target-specific compilers.
+## What is PromptScript?
+
+PromptScript is an open-source language and compiler for AI agent configuration. `.prs` sources
+define instructions, project standards, restrictions, skills, agents, MCP servers, hooks, and
+workflows, while `promptscript.yaml` configures targets and extension-compliance policies.
+PromptScript compiles them into the native files each AI tool already reads, including `CLAUDE.md`,
+`.github/copilot-instructions.md`, `.cursor/rules`, and output for 47 more targets.
+
+Every AI coding tool uses its own file names, formats, and paths. Teams using several tools end up
+maintaining several copies of the same rules. Those copies drift, and a change made for one tool may
+never reach the others.
+
+PromptScript fixes the source instead of patching each generated file:
 
 ```text
 .promptscript/project.prs
@@ -33,6 +43,16 @@ composable, Git-native source and target-specific compilers.
 
 No runtime proxy. Each selected platform keeps consuming its own native configuration.
 
+## Why maintain native files by hand?
+
+Even a few tools create copies that need the same manual updates. Errors stay hidden until an agent
+reads the broken file. Policy changes become separate edits across every repository and tool.
+
+With PromptScript, you change one source, review the generated diff, and validate it in CI. Git
+records each change. Remote dependencies stay pinned in `promptscript.lock`, so builds remain
+reproducible. Adding or switching tools does not require rewriting the source. See the
+[full comparison](https://getpromptscript.dev/guides/vs-manual/).
+
 ## Install
 
 Requires Node.js 20 or later.

package/index.js

@@ -17249,12 +17249,35 @@ var init_visitor2 = __esm({
         return expression ? expression.loc : fallbackLoc;
       }
       parseTextBlock(token) {
-        let value = token.image.slice(3, -3).trim();
+        let value = this.normalizeTextBlockIndent(token.image.slice(3, -3));
         if (this.interpolateEnv) {
           value = this.interpolateEnvVars(value);
         }
         return value;
       }
+      /**
+       * Strip the common leading whitespace shared by the non-empty lines of a
+       * text block, then trim. A plain trim() would leave the first line at
+       * column 0 while every following line keeps its source indentation, so
+       * markdown consumers read the block body indent as list nesting. Stripping
+       * the common indent keeps relative (nested) indentation intact.
+       */
+      normalizeTextBlockIndent(raw) {
+        let minIndent = Infinity;
+        for (const line of raw.split("\n")) {
+          if (line.trim().length === 0) continue;
+          const match2 = /^([ \t]*)/.exec(line);
+          const indent = match2?.[1]?.length ?? 0;
+          if (indent < minIndent) {
+            minIndent = indent;
+            if (minIndent === 0) break;
+          }
+        }
+        if (minIndent === Infinity || minIndent === 0) {
+          return raw.trim();
+        }
+        return raw.split("\n").map((line) => line.slice(minIndent)).join("\n").trim();
+      }
       /**
        * Parse a string literal, handling escape sequences.
        */
@@ -18810,6 +18833,52 @@ var init_extractors = __esm({
   }
 });
 
+// packages/formatters/src/section-title-resolver.ts
+function presentationSectionId(blockName, entry) {
+  if (entry.sectionId) return getSectionContract(entry.sectionId)?.id ?? entry.sectionId;
+  return getPrimarySectionForBlock(blockName)?.id;
+}
+function sourceTitle(ast, section) {
+  const owners = [section.primaryOwner, ...section.fallbackOwners];
+  for (const source of ["explicit", "legacy"]) {
+    for (const owner of owners) {
+      const candidates = ast.blocks.filter((block) => block.name === owner).flatMap(
+        (block) => (block.canonicalBody?.entries ?? []).filter(
+          (entry) => entry.type === "PresentationEntry" && entry.source === source && presentationSectionId(block.name, entry) === section.id
+        )
+      );
+      const selected = candidates.at(-1);
+      if (selected) return selected.title;
+    }
+  }
+  return void 0;
+}
+function resolveSourceSectionTitle(ast, sectionIdOrAlias) {
+  const section = getSectionContract(sectionIdOrAlias);
+  return section ? sourceTitle(ast, section) : void 0;
+}
+function configuredTitle(section, titles) {
+  if (!titles) return void 0;
+  for (const key of [section.id, ...section.formatterAliases]) {
+    const title = titles[key];
+    if (title !== void 0) return title;
+  }
+  return void 0;
+}
+function resolveSectionTitle(ast, sectionIdOrAlias, options = {}) {
+  const section = getSectionContract(sectionIdOrAlias);
+  if (!section) {
+    return options.defaultTitle ?? sectionIdOrAlias;
+  }
+  return (options.sourceOverrides === false ? void 0 : sourceTitle(ast, section)) ?? configuredTitle(section, options.formatterTitles) ?? options.defaultTitle ?? section.defaultTitle;
+}
+var init_section_title_resolver = __esm({
+  "packages/formatters/src/section-title-resolver.ts"() {
+    "use strict";
+    init_src();
+  }
+});
+
 // packages/formatters/src/base-formatter.ts
 import { posix } from "path";
 var BaseFormatter;
@@ -18819,6 +18888,7 @@ var init_base_formatter = __esm({
     init_src();
     init_convention_renderer();
     init_extractors();
+    init_section_title_resolver();
     BaseFormatter = class _BaseFormatter {
       /**
        * Canonical entry point for legacy implementations.
@@ -19003,6 +19073,21 @@ var init_base_formatter = __esm({
         }
         return this.valueToString(value).split("\n")[0] ?? fallback;
       }
+      /**
+       * Whether the `@context` block's text is consumed by the project/intro
+       * fallback. Must mirror the project() and intro() consumption conditions
+       * exactly, otherwise the context section would either duplicate the text
+       * (predicate too narrow) or drop it entirely (predicate too wide).
+       */
+      contextTextConsumedByProject(ast) {
+        const identity = this.findBlock(ast, "identity");
+        if (identity) return false;
+        const context = this.findBlock(ast, "context");
+        if (!context) return false;
+        if (resolveSourceSectionTitle(ast, "context")) return false;
+        const projectTitle = resolveSourceSectionTitle(ast, "project");
+        return context.content.type === "MixedContent" || projectTitle !== void 0;
+      }
       /**
        * `@context` keys that already have a dedicated rendering path. Anything
        * outside this set is generic and must be surfaced by the context section.
@@ -20890,52 +20975,6 @@ var init_mcp_helpers = __esm({
   }
 });
 
-// packages/formatters/src/section-title-resolver.ts
-function presentationSectionId(blockName, entry) {
-  if (entry.sectionId) return getSectionContract(entry.sectionId)?.id ?? entry.sectionId;
-  return getPrimarySectionForBlock(blockName)?.id;
-}
-function sourceTitle(ast, section) {
-  const owners = [section.primaryOwner, ...section.fallbackOwners];
-  for (const source of ["explicit", "legacy"]) {
-    for (const owner of owners) {
-      const candidates = ast.blocks.filter((block) => block.name === owner).flatMap(
-        (block) => (block.canonicalBody?.entries ?? []).filter(
-          (entry) => entry.type === "PresentationEntry" && entry.source === source && presentationSectionId(block.name, entry) === section.id
-        )
-      );
-      const selected = candidates.at(-1);
-      if (selected) return selected.title;
-    }
-  }
-  return void 0;
-}
-function resolveSourceSectionTitle(ast, sectionIdOrAlias) {
-  const section = getSectionContract(sectionIdOrAlias);
-  return section ? sourceTitle(ast, section) : void 0;
-}
-function configuredTitle(section, titles) {
-  if (!titles) return void 0;
-  for (const key of [section.id, ...section.formatterAliases]) {
-    const title = titles[key];
-    if (title !== void 0) return title;
-  }
-  return void 0;
-}
-function resolveSectionTitle(ast, sectionIdOrAlias, options = {}) {
-  const section = getSectionContract(sectionIdOrAlias);
-  if (!section) {
-    return options.defaultTitle ?? sectionIdOrAlias;
-  }
-  return (options.sourceOverrides === false ? void 0 : sourceTitle(ast, section)) ?? configuredTitle(section, options.formatterTitles) ?? options.defaultTitle ?? section.defaultTitle;
-}
-var init_section_title_resolver = __esm({
-  "packages/formatters/src/section-title-resolver.ts"() {
-    "use strict";
-    init_src();
-  }
-});
-
 // packages/formatters/src/markdown-instruction-formatter.ts
 var MarkdownInstructionFormatter;
 var init_markdown_instruction_formatter = __esm({
@@ -21427,17 +21466,16 @@ var init_markdown_instruction_formatter = __esm({
       context(ast, renderer) {
         const contextBlock = this.findBlock(ast, "context");
         if (!contextBlock) return null;
-        const identity = this.findBlock(ast, "identity");
-        const textIsConsumedByProject = !identity && !resolveSourceSectionTitle(ast, "context");
+        const textIsConsumedByProject = this.contextTextConsumedByProject(ast);
         const propertyItems = this.contextPropertyItems(ast);
         let body = "";
         if (!textIsConsumedByProject) {
           const text = this.extractText(contextBlock.content);
           const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
           const strippedText = archMatch ? text.replace(archMatch, "") : text;
-          const remainingText = this.dedent(strippedText);
+          const remainingText = strippedText.trim();
           if (remainingText) {
-            const downgradedText = remainingText.replace(/^(\s*)## /gm, "$1### ");
+            const downgradedText = remainingText.replace(/^([ \t]*)## /gm, "$1### ");
             body = this.normalizeMarkdownForPrettier(downgradedText).trim();
           }
         }
@@ -23123,8 +23161,7 @@ ${f.content}`
       contextSection(ast, renderer) {
         const contextBlock = this.findBlock(ast, "context");
         if (!contextBlock) return null;
-        const identity = this.findBlock(ast, "identity");
-        const textIsConsumedByProject = !identity && !resolveSourceSectionTitle(ast, "context");
+        const textIsConsumedByProject = this.contextTextConsumedByProject(ast);
         const propertyItems = this.contextPropertyItems(ast);
         let body = "";
         if (!textIsConsumedByProject) {
@@ -23132,7 +23169,7 @@ ${f.content}`
           const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
           const remainingText = archMatch ? text.replace(archMatch, "").trim() : text.trim();
           if (remainingText) {
-            const downgradedText = remainingText.replace(/^(\s*)## /gm, "$1### ");
+            const downgradedText = remainingText.replace(/^([ \t]*)## /gm, "$1### ");
             body = this.stripAllIndent(downgradedText);
           }
         }
@@ -24238,8 +24275,7 @@ ${f.content}`
       contextSection(ast, renderer) {
         const contextBlock = this.findBlock(ast, "context");
         if (!contextBlock) return null;
-        const identity = this.findBlock(ast, "identity");
-        const textIsConsumedByProject = !identity && !resolveSourceSectionTitle(ast, "context");
+        const textIsConsumedByProject = this.contextTextConsumedByProject(ast);
         const propertyItems = this.contextPropertyItems(ast);
         let body = "";
         if (!textIsConsumedByProject) {
@@ -24247,7 +24283,7 @@ ${f.content}`
           const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
           const remainingText = archMatch ? text.replace(archMatch, "").trim() : text.trim();
           if (remainingText) {
-            const downgradedText = remainingText.replace(/^(\s*)## /gm, "$1### ");
+            const downgradedText = remainingText.replace(/^([ \t]*)## /gm, "$1### ");
             body = this.normalizeMarkdownForPrettier(downgradedText).trim();
           }
         }
@@ -25146,10 +25182,14 @@ ${text2.trim()}`;
           }
         }
         const text = this.extractText(context.content);
-        if (text?.includes("Architecture")) {
-          return text.trim();
-        }
-        return null;
+        const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
+        if (!archMatch) return null;
+        const content = archMatch.replace("## Architecture", "");
+        const normalizedContent = this.normalizeMarkdownForPrettier(content);
+        const title = resolveSectionTitle(ast, "architecture", { defaultTitle: "Architecture" });
+        return `## ${title}
+
+${normalizedContent.trim()}`;
       }
       contextSection(ast) {
         const context = this.findBlock(ast, "context");
@@ -25161,13 +25201,13 @@ ${text2.trim()}`;
           consumedByIntro ? ["tech-stack", "project"] : ["tech-stack"]
         );
         let body = "";
-        if (resolveSourceSectionTitle(ast, "context")) {
+        if (!this.contextTextConsumedByProject(ast)) {
           const text = this.extractText(context.content);
           const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
           const remainingText = archMatch ? text.replace(archMatch, "").trim() : text.trim();
           if (remainingText) {
-            const downgradedText = remainingText.replace(/^(\s*)## /gm, "$1### ");
-            body = this.stripAllIndent(downgradedText);
+            const downgradedText = remainingText.replace(/^([ \t]*)## /gm, "$1### ");
+            body = downgradedText.trim();
           }
         }
         if (propertyItems.length > 0) {
@@ -26035,8 +26075,7 @@ ${this.stripAllIndent(content)}`;
       contextSection(ast, _renderer) {
         const contextBlock = this.findBlock(ast, "context");
         if (!contextBlock) return null;
-        const identity = this.findBlock(ast, "identity");
-        const textIsConsumedByProject = !identity && !resolveSourceSectionTitle(ast, "context");
+        const textIsConsumedByProject = this.contextTextConsumedByProject(ast);
         const propertyItems = this.contextPropertyItems(ast, ["frameworks"]);
         let body = "";
         if (!textIsConsumedByProject) {
@@ -26044,7 +26083,7 @@ ${this.stripAllIndent(content)}`;
           const archMatch = this.extractSectionWithCodeBlock(text, "## Architecture");
           const remainingText = archMatch ? text.replace(archMatch, "").trim() : text.trim();
           if (remainingText) {
-            const downgradedText = remainingText.replace(/^(\s*)## /gm, "$1### ");
+            const downgradedText = remainingText.replace(/^([ \t]*)## /gm, "$1### ");
             body = this.stripAllIndent(downgradedText);
           }
         }
@@ -43978,6 +44017,37 @@ async function readBoundedRegularFile(filePath, maxBytes, description) {
     await handle.close();
   }
 }
+async function readOptionalBoundedRegularFile(filePath, description) {
+  try {
+    return await readBoundedRegularFile(filePath, MAX_GIT_CONFIG_BYTES, description);
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return Buffer.alloc(0);
+    }
+    throw error;
+  }
+}
+async function readGitBooleanConfig(filePath, key, description) {
+  try {
+    const result = await execFileAsync(
+      "git",
+      ["config", "--no-includes", "--file", filePath, "--bool", "--get", key],
+      {
+        env: {
+          PATH: process.env["PATH"],
+          GIT_CONFIG_GLOBAL: NULL_DEVICE,
+          GIT_CONFIG_NOSYSTEM: "1"
+        }
+      }
+    );
+    return result.stdout.trim() === "true";
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === 1) {
+      return false;
+    }
+    throw new Error(`Invalid ${description}: ${filePath}`, { cause: error });
+  }
+}
 async function resolveSafeRepositorySymlink(symlinkPath, repositoryRoot, gitMetadataRoot) {
   let targetPath;
   try {
@@ -44109,8 +44179,23 @@ async function verifyGitRepositoryCheckout(directory, gitDirectoryName, expected
     "Vendor Git config"
   );
   const localConfig = localConfigContent.toString("utf-8");
-  if (/^[ \t]*\[(?:include|includeif)\b/im.test(localConfig) || /\bworktreeconfig\s*=\s*true\b/i.test(localConfig) || !options.allowPartial && (/\bpromisor\s*=\s*true\b/i.test(localConfig) || /\bpartialclone/i.test(localConfig))) {
-    throw new Error(`External or partial Git object sources are not allowed: ${gitDir}`);
+  const externalGitSourcesError = () => `External or partial Git object sources are not allowed: ${gitDir}. ` + (options.allowPartial ? `Delete the checkout directory ${directory} and re-run this command to re-clone it.` : `Run 'prs vendor sync' to re-vendor the dependency, then re-run this command.`);
+  if (/^[ \t]*\[(?:include|includeif)\b/im.test(localConfig)) {
+    throw new Error(externalGitSourcesError());
+  }
+  const usesWorktreeConfig = await readGitBooleanConfig(
+    join9(gitDir, "config"),
+    "extensions.worktreeConfig",
+    "Git worktree config extension"
+  );
+  if (!options.allowPartial && (usesWorktreeConfig || /\bpromisor\s*=\s*true\b/i.test(localConfig) || /\bpartialclone/i.test(localConfig))) {
+    throw new Error(externalGitSourcesError());
+  }
+  if (options.allowPartial && usesWorktreeConfig) {
+    const worktreeConfig = (await readOptionalBoundedRegularFile(join9(gitDir, "config.worktree"), "Git worktree config")).toString("utf-8");
+    if (/^[ \t]*\[(?:include|includeif)\b/im.test(worktreeConfig)) {
+      throw new Error(externalGitSourcesError());
+    }
   }
   await rejectMetadataPath("commondir", "Git common directories are not allowed");
   await rejectMetadataPath(
@@ -45555,7 +45640,9 @@ var Resolver = class {
       const markerCommit = version && /^[0-9a-f]{40}$/i.test(version) && !/^0{40}$/.test(version) ? version : null;
       const lockedCommit = lockfileCommit ?? markerCommit;
       if (this.options.lockfile && !lockfileCommit) {
-        throw new Error(`Remote dependency is not pinned by the lockfile: ${repoUrl}`);
+        throw new Error(
+          `Remote dependency is not pinned by the lockfile: ${repoUrl}. Run 'prs lock' to pin it, then re-run this command.`
+        );
       }
       const requestedRef = lockEntry?.version ?? (version || void 0);
       const tag = requestedRef && requestedRef !== "latest" && !/^[0-9a-f]{40}$/i.test(requestedRef) ? requestedRef : void 0;
@@ -45569,7 +45656,9 @@ var Resolver = class {
       }
       if (this.options.vendorDir && vendorManifest) {
         if (!lockEntry || !lockedCommit) {
-          throw new Error(`Vendored dependency is not pinned by the lockfile: ${repoUrl}`);
+          throw new Error(
+            `Vendored dependency is not pinned by the lockfile: ${repoUrl}. Run 'prs lock' to pin it, then re-run this command.`
+          );
         }
         vendoredPath = await resolveVendoredRepository(
           this.options.vendorDir,
@@ -52644,12 +52733,16 @@ async function resolveRegistryPath(config, options = {}) {
     if (options.vendorDir && existsSync12(options.vendorDir) && !vendorManifest) {
       throw new Error(`Vendor manifest is missing: ${options.vendorDir}`);
     }
-    if (options.lockfile && !lockedRepository) {
-      throw new Error(`Git registry is not pinned by the lockfile: ${gitConfig.url}`);
+    if (options.lockfile && !lockedRepository && !options.allowMissingLockEntry) {
+      throw new Error(
+        `Git registry is not pinned by the lockfile: ${gitConfig.url}. Run 'prs lock' to pin it, then re-run this command.`
+      );
     }
     if (options.vendorDir && vendorManifest) {
       if (!lockedRepository) {
-        throw new Error(`Vendored registry is not pinned by the lockfile: ${gitConfig.url}`);
+        throw new Error(
+          `Vendored registry is not pinned by the lockfile: ${gitConfig.url}. Run 'prs lock' to pin it, then re-run this command.`
+        );
       }
       const [repoUrl, dependency] = lockedRepository;
       const repositoryPath = await resolveVendoredRepository(
@@ -52689,7 +52782,8 @@ async function resolveRegistryPath(config, options = {}) {
           cachePath,
           ".git",
           lockedRepository[1].commit,
-          /* @__PURE__ */ new Set([".prs-cache-meta.json"])
+          /* @__PURE__ */ new Set([".prs-cache-meta.json"]),
+          { allowPartial: true }
         );
         return {
           path: await resolveRegistrySubPath(cachePath, gitConfig.path),
@@ -52742,7 +52836,8 @@ async function resolveRegistryPath(config, options = {}) {
         cachePath,
         ".git",
         lockedRepository[1].commit,
-        /* @__PURE__ */ new Set([".prs-cache-meta.json"])
+        /* @__PURE__ */ new Set([".prs-cache-meta.json"]),
+        { allowPartial: true }
       );
     }
     return {
@@ -57901,6 +57996,63 @@ async function collectRemoteImports(entryPath, options) {
   const visited = /* @__PURE__ */ new Set();
   const seen = /* @__PURE__ */ new Set();
   const results = [];
+  function recordRemoteImport(path2, sourceFile, resolved) {
+    const marker = parseRegistryMarker(resolved);
+    if (!marker) {
+      return false;
+    }
+    const key = `${marker.repoUrl}\0${marker.path}\0${marker.version}`;
+    if (options.deduplicate === false || !seen.has(key)) {
+      seen.add(key);
+      results.push({
+        ...marker,
+        ...options.includeLocations ? {
+          sourceFile,
+          sourceLine: path2.loc.line,
+          rawSource: path2.raw
+        } : {}
+      });
+    }
+    return true;
+  }
+  async function scanLocalReference(resolved) {
+    if (!resolved.endsWith(".prs") && !resolved.endsWith(".md")) {
+      return;
+    }
+    if (existsSync21(resolved)) {
+      await scan(resolved);
+      return;
+    }
+    if (resolved.endsWith(".prs")) {
+      const skillDirectory = resolved.slice(0, -".prs".length);
+      if (existsSync21(skillDirectory)) {
+        const skillFile = join21(skillDirectory, "SKILL.md");
+        if (existsSync21(skillFile)) {
+          await scan(skillFile);
+        }
+        return;
+      }
+    }
+    if (options.strict) {
+      throw new Error(`Imported PromptScript file not found: ${resolved}`);
+    }
+  }
+  async function scanReference(path2, sourceFile) {
+    let resolved;
+    try {
+      resolved = loader.resolveRef(path2, sourceFile);
+    } catch (error) {
+      if (options.strict) {
+        throw new Error(`Cannot resolve import '${path2.raw}' in ${sourceFile}`, {
+          cause: error
+        });
+      }
+      return;
+    }
+    if (!recordRemoteImport(path2, sourceFile, resolved)) {
+      await scanLocalReference(resolved);
+    }
+  }
   async function scan(filePath) {
     if (visited.has(filePath)) return;
     visited.add(filePath);
@@ -57921,54 +58073,16 @@ async function collectRemoteImports(entryPath, options) {
       throw new Error(`Cannot scan invalid PromptScript file: ${filePath}: ${errors[0].message}`);
     }
     if (!ast) return;
-    for (const use of ast.uses) {
-      let resolved;
-      try {
-        resolved = loader.resolveRef(use.path, filePath);
-      } catch (error) {
-        if (options.strict) {
-          throw new Error(`Cannot resolve import '${use.path.raw}' in ${filePath}`, {
-            cause: error
-          });
-        }
-        continue;
-      }
-      const marker = parseRegistryMarker(resolved);
-      if (marker) {
-        const key = `${marker.repoUrl}\0${marker.path}\0${marker.version}`;
-        if (options.deduplicate === false || !seen.has(key)) {
-          seen.add(key);
-          results.push({
-            ...marker,
-            ...options.includeLocations ? {
-              sourceFile: filePath,
-              sourceLine: use.path.loc.line,
-              rawSource: use.path.raw
-            } : {}
-          });
-        }
-      } else {
-        if (!resolved.endsWith(".prs") && !resolved.endsWith(".md")) {
-          continue;
-        }
-        if (existsSync21(resolved)) {
-          await scan(resolved);
-          continue;
-        }
-        if (resolved.endsWith(".prs")) {
-          const skillDirectory = resolved.slice(0, -".prs".length);
-          if (existsSync21(skillDirectory)) {
-            const skillFile = join21(skillDirectory, "SKILL.md");
-            if (existsSync21(skillFile)) {
-              await scan(skillFile);
-            }
-            continue;
-          }
-        }
-        if (options.strict) {
-          throw new Error(`Imported PromptScript file not found: ${resolved}`);
-        }
-      }
+    const inlineUses = ast.blocks.flatMap(
+      (block) => block.name === "skills" && (block.content.type === "ObjectContent" || block.content.type === "MixedContent") ? block.content.inlineUses ?? [] : []
+    );
+    const paths = [
+      ...ast.inherit ? [ast.inherit.path] : [],
+      ...ast.uses.map((use) => use.path),
+      ...inlineUses.map((use) => use.path)
+    ];
+    for (const path2 of paths) {
+      await scanReference(path2, filePath);
     }
   }
   await scan(entryPath);
@@ -58163,6 +58277,7 @@ async function lockCommand(options) {
     const localPath = resolve33(projectRoot, ".promptscript");
     const entryPath = config.input?.entry ? resolve33(projectRoot, config.input.entry) : resolve33(localPath, "project.prs");
     const registry2 = await resolveRegistryPath(config, {
+      allowMissingLockEntry: true,
       ...!options.update && Object.keys(existing.dependencies).length > 0 ? { lockfile: existing } : {}
     });
     const scannedImports = await collectRemoteImports(entryPath, {
@@ -58817,7 +58932,9 @@ async function resolveCommand(importPath, options) {
     }
     if (manifest) {
       if (!lockKey || !dependency) {
-        throw new Error(`Vendored dependency is not pinned by the lockfile: ${marker.repoUrl}`);
+        throw new Error(
+          `Vendored dependency is not pinned by the lockfile: ${marker.repoUrl}. Run 'prs lock' to pin it, then re-run this command.`
+        );
       }
       const vendoredPath = await resolveVendoredRepository(
         vendorDir,
@@ -58836,7 +58953,10 @@ async function resolveCommand(importPath, options) {
           cachePath,
           ".git",
           dependency.commit,
-          /* @__PURE__ */ new Set([".prs-registry-meta.json"])
+          /* @__PURE__ */ new Set([".prs-registry-meta.json"]),
+          {
+            allowPartial: true
+          }
         );
       } catch {
         source = "stale cache";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptscript/cli",
-  "version": "1.19.0",
+  "version": "1.19.1",
   "description": "CLI for PromptScript - standardize AI instructions across GitHub Copilot, Claude, Cursor and other AI tools",
   "keywords": [
     "cli",
@@ -47,10 +47,10 @@
     "commander": "^15.0.0",
     "minimatch": "^10.2.6",
     "ora": "^9.4.1",
-    "prettier": "^3.9.6",
-    "yaml": "^2.9.0",
+    "prettier": "^3.9.8",
+    "yaml": "^2.9.1",
     "simple-git": "3.36.0",
-    "fastify": "^5.12.3",
+    "fastify": "^5.12.5",
     "@fastify/cors": "^11.3.0",
     "@fastify/websocket": "^11.3.0",
     "ws": "^8.21.3",

package/src/commands/lock-scanner.d.ts

@@ -13,7 +13,7 @@ export interface RemoteImport {
     sourceFile?: string;
     /** Source line containing this import when location collection is enabled */
     sourceLine?: number;
-    /** Original @use source text when location collection is enabled */
+    /** Original reference text when location collection is enabled */
     rawSource?: string;
 }
 /**
@@ -35,7 +35,7 @@ export interface ScanOptions {
 }
 /**
  * Scan `.prs` files starting from an entry point, recursively follow local
- * `@use` imports, and collect all remote `@use` references.
+ * references, and collect remote `@use`, `@inherit`, and inline skill imports.
  *
  * Remote references are those that resolve to registry markers — either direct
  * URL-style imports (e.g. `github.com/org/repo/path`) or registry alias

package/src/commands/lock-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock-scanner.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/lock-scanner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAmGzB"}
+{"version":3,"file":"lock-scanner.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/lock-scanner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2HzB"}

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

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/lock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAQhC,4CAA4C;AAC5C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAUjD,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyLrE;AAkBD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EAAE,EAC3B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,WAAW,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAmE7B"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/lock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAQhC,4CAA4C;AAC5C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAUjD,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0LrE;AAkBD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EAAE,EAC3B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,WAAW,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAmE7B"}

package/src/commands/resolve-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-cmd.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/resolve-cmd.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoIzD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiKf"}
+{"version":3,"file":"resolve-cmd.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/commands/resolve-cmd.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoIzD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAuKf"}

package/src/utils/registry-resolver.d.ts

@@ -23,6 +23,8 @@ export interface ResolvedRegistry {
 export interface ResolveRegistryOptions {
     vendorDir?: string;
     lockfile?: Lockfile;
+    /** Allow lock generation to resolve a registry missing from an existing lockfile. */
+    allowMissingLockEntry?: boolean;
     /** Refuse cache repair, network access, and all registry writes. */
     readOnly?: boolean;
 }

package/src/utils/registry-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-resolver.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/registry-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAcvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACjC,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAiL3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAe,GAAG,MAAM,CAKzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,OAAO,CAEhG"}
+{"version":3,"file":"registry-resolver.d.ts","sourceRoot":"","sources":["../../../../../packages/cli/src/utils/registry-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAcvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACjC,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAyL3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAe,GAAG,MAAM,CAKzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,OAAO,CAEhG"}