dsh-pstack 0.1.0 → 0.2.0-beta.1

package/dist/index.mjs

@@ -1,172 +1,272 @@
-import { n as SKILLS_ROOT, r as SKILLS_ROOT_URL } from "./paths-Bbai4CaT.mjs";
+import { a as SKILLS_ROOT, n as HARNESS_DOC_PATH, r as PACKAGE_ROOT, t as ASSETS_ROOT } from "./paths-D_JlVmBk.mjs";
+import { a as SKILL_CONSUMED_FIELDS, c as parseFrontmatter, d as skillDroppedFields, f as validateAgentFrontmatter, i as MAX_SKILL_NAME_LENGTH, l as serializeAgentFrontmatter, n as AGENT_DROPPED_FIELDS, o as SKILL_DROPPED_FIELDS, p as validateSkillFrontmatter, r as FrontmatterError, s as agentDroppedFields, t as AGENT_CONSUMED_FIELDS, u as serializeSkillFrontmatter } from "./frontmatter-BQX3ekwP.mjs";
+import { join } from "node:path";
 import { readFileSync, readdirSync } from "node:fs";
-import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
-//#region src/frontmatter.ts
-const DELIMITER = "---";
-function unquote(value) {
-	const trimmed = value.trim();
-	if (trimmed.length >= 2) {
-		const first = trimmed[0];
-		const last = trimmed[trimmed.length - 1];
-		if (first === "\"" && last === "\"" || first === "'" && last === "'") {
-			const inner = trimmed.slice(1, -1);
-			return first === "\"" ? inner.replace(/\\"/g, "\"").replace(/\\n/g, "\n").replace(/\\\\/g, "\\") : inner.replace(/''/g, "'");
-		}
+//#region src/provider.ts
+/**
+* The bundled pstack skill provider: one provider over the 55 generated skills
+* that ship inside this package.
+*
+* The provider contract below mirrors `@deepseek-ai/dsh-skill` 0.2.1-rc.3, which
+* was read through the host Inspect provider (`Service.listService` with
+* `service: "skills"`) and the installed type declarations. It is restated here
+* as a structural contract instead of imported so the plugin keeps zero runtime
+* imports from the host packages: a workspace-directory bundle is linked from
+* its checkout, where `@deepseek-ai/*` is not resolvable.
+*
+* Design constraints this module enforces, from the port design document §8.1:
+*
+* - The catalog is built once from the package assets and never watched. A
+*   package update is the refresh boundary.
+* - A malformed bundled skill fails the whole index instead of disappearing
+*   from the catalog, so a broken asset is a startup error rather than a skill
+*   users silently cannot see.
+* - `get()` only accepts a locator this provider produced. Directory names are
+*   never joined from caller input.
+*/
+/**
+* Standard precedence rank for packaged skill providers, re-exported by
+* `@deepseek-ai/dsh-skill` as `BUNDLED_SKILL_RANK`. Restated to keep the package
+* dependency-free; a mismatch only changes which provider wins a name collision.
+*/
+const BUNDLED_SKILL_RANK = 600;
+/** Default provider name used when the row does not override it. */
+const DEFAULT_PROVIDER_NAME = "pstack";
+/** Raised when a bundled asset violates the provider contract. */
+var BundledSkillError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "BundledSkillError";
 	}
-	return trimmed;
-}
-function parseFrontmatter(source) {
-	const normalized = source.replace(/\r\n/g, "\n");
-	const lines = normalized.split("\n");
-	if (lines[0]?.trim() !== DELIMITER) return {
-		data: {},
-		body: normalized
-	};
-	let end = -1;
-	for (let index = 1; index < lines.length; index += 1) if (lines[index]?.trim() === DELIMITER) {
-		end = index;
-		break;
+};
+/**
+* Read and validate every bundled skill below one directory.
+*
+* This is the startup check: it runs before the provider registers, so a missing
+* `SKILL.md`, an invalid frontmatter block, or a name that disagrees with its
+* directory fails plugin activation with a path-qualified message instead of
+* dropping a skill from the catalog.
+*
+* @param skillsRoot - absolute path of the directory holding the skill directories.
+* @returns validated skills keyed by absolute skill directory, sorted by name.
+* @throws {BundledSkillError} when the tree or any skill in it is malformed.
+*/
+function loadBundledSkillIndex(skillsRoot) {
+	let entries;
+	try {
+		entries = readdirSync(skillsRoot, { withFileTypes: true });
+	} catch (error) {
+		throw new BundledSkillError(`bundled skills: cannot read "${skillsRoot}": ${messageOf(error)}`);
 	}
-	if (end === -1) return {
-		data: {},
-		body: normalized
-	};
-	const data = {};
-	let index = 1;
-	while (index < end) {
-		const line = lines[index] ?? "";
-		const match = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
-		if (!match) {
-			index += 1;
-			continue;
-		}
-		const key = match[1];
-		const rawValue = match[2] ?? "";
-		index += 1;
-		if (rawValue === ">" || rawValue === ">-" || rawValue === "|" || rawValue === "|-") {
-			const folded = rawValue.startsWith(">");
-			const collected = [];
-			while (index < end) {
-				const next = lines[index] ?? "";
-				if (next.trim() !== "" && !/^\s/.test(next)) break;
-				collected.push(next.replace(/^\s{1,4}/, ""));
-				index += 1;
-			}
-			data[key] = folded ? collected.join(" ").replace(/\s+/g, " ").trim() : collected.join("\n").replace(/\n+$/, "");
-			continue;
-		}
-		if (rawValue === "") {
-			const collected = [];
-			while (index < end) {
-				const next = lines[index] ?? "";
-				if (next.trim() !== "" && !/^\s/.test(next)) break;
-				collected.push(next.trim());
-				index += 1;
-			}
-			data[key] = collected.join(" ").trim();
-			continue;
-		}
-		data[key] = unquote(rawValue);
+	const index = /* @__PURE__ */ new Map();
+	for (const entry of entries.sort((left, right) => left.name < right.name ? -1 : 1)) {
+		const directory = join(skillsRoot, entry.name);
+		if (!entry.isDirectory()) throw new BundledSkillError(`bundled skills: "${directory}" is not a skill directory; remove it or add a SKILL.md`);
+		const instructionFile = join(directory, "SKILL.md");
+		const frontmatter = readSkillFrontmatter(readSkillFile(instructionFile), instructionFile);
+		if (frontmatter.name !== entry.name) throw new BundledSkillError(`${instructionFile}: skill name "${frontmatter.name}" does not match its directory "${entry.name}"`);
+		index.set(directory, {
+			name: frontmatter.name,
+			description: frontmatter.description,
+			...frontmatter.whenToUse === void 0 ? {} : { whenToUse: frontmatter.whenToUse },
+			invocation: {
+				modelInvocable: !frontmatter.disableModelInvocation,
+				userInvocable: frontmatter.userInvocable
+			},
+			directory,
+			instructionFile
+		});
 	}
-	return {
-		data,
-		body: lines.slice(end + 1).join("\n").replace(/^\n+/, "")
-	};
+	if (index.size === 0) throw new BundledSkillError(`bundled skills: no skill directories under "${skillsRoot}"`);
+	return index;
 }
-//#endregion
-//#region src/provider.ts
 /**
-* Bundled pstack skill provider.
+* Build the provider over an already validated index.
 *
-* One provider hosts every pstack skill so the catalog stays one entry per
-* skill and the package ships as a single installable bundle. The provider is
-* immutable: `assets/skills/` is generated at build time, so discovery always
-* completes with the same list.
+* @param index - result of {@link loadBundledSkillIndex}.
+* @param providerName - registry name for this provider.
+* @returns a read-only provider whose catalog never changes until the package does.
 */
-const PROVIDER_NAME = "pstack";
-function text(value) {
-	return (value ?? "").trim();
+function createPstackSkillProvider(index, providerName = DEFAULT_PROVIDER_NAME) {
+	const ordered = [...index.values()].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+	return {
+		name: providerName,
+		async list(options) {
+			throwIfAborted(options?.signal);
+			return ordered.map((skill) => ({
+				name: skill.name,
+				description: skill.description,
+				...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
+				invocation: skill.invocation,
+				source: "bundled",
+				provider: providerName,
+				rank: 600,
+				locator: {
+					kind: "bundled-skill",
+					directory: skill.directory,
+					instructionFile: skill.instructionFile
+				},
+				path: skill.instructionFile,
+				resourceBase: {
+					kind: "directory",
+					path: skill.directory
+				}
+			}));
+		},
+		async get(candidate, options) {
+			const locator = asBundledSkillLocator(candidate.locator);
+			if (locator === void 0) return void 0;
+			const skill = index.get(locator.directory);
+			if (skill === void 0 || skill.instructionFile !== locator.instructionFile || skill.name !== candidate.name) return;
+			throwIfAborted(options?.signal);
+			const text = readOptionalSkillFile(skill.instructionFile);
+			if (text === void 0) return void 0;
+			const { body } = parseFrontmatter(text);
+			return {
+				name: skill.name,
+				description: skill.description,
+				...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
+				invocation: skill.invocation,
+				source: "bundled",
+				provider: providerName,
+				path: skill.instructionFile,
+				resourceBase: {
+					kind: "directory",
+					path: skill.directory
+				},
+				content: body
+			};
+		}
+	};
 }
 /**
-* Parse one generated SKILL.md into the catalog entry the provider serves.
-* Generated files always carry `name` and `description`; a hand-edit that
-* removes them fails loudly instead of silently dropping the skill.
+* Load the index and build the provider in one step, failing on a malformed tree.
+*
+* `apply()` uses this exact function, so the startup failure path and the
+* provider used in tests are the same code.
+*
+* @param skillsRoot - absolute path of the bundled skill root.
+* @param providerName - registry name for this provider.
+* @returns the provider over the validated index.
 */
-function toEntry(directory, source) {
-	const { data } = parseFrontmatter(source);
-	if (!text(data.name) || !text(data.description)) throw new Error(`pstack skill "${directory}" is missing name or description frontmatter`);
-	return {
-		name: text(data.name),
-		description: text(data.description),
-		modelInvocable: data["disable-model-invocation"] !== "true",
-		userInvocable: data["user-invocable"] !== "false",
-		directory
-	};
+function createPstackSkillProviderFromRoot(skillsRoot, providerName = DEFAULT_PROVIDER_NAME) {
+	return createPstackSkillProvider(loadBundledSkillIndex(skillsRoot), providerName);
 }
-function resourceBase(directory) {
+function asBundledSkillLocator(locator) {
+	if (typeof locator !== "object" || locator === null) return void 0;
+	const candidate = locator;
+	if (candidate.kind !== "bundled-skill") return void 0;
+	if (typeof candidate.directory !== "string") return void 0;
+	if (typeof candidate.instructionFile !== "string") return void 0;
 	return {
-		kind: "directory",
-		path: `${SKILLS_ROOT}${directory}/`
+		kind: "bundled-skill",
+		directory: candidate.directory,
+		instructionFile: candidate.instructionFile
 	};
 }
-function toCandidate(entry) {
-	return {
-		name: entry.name,
-		description: entry.description,
-		invocation: {
-			modelInvocable: entry.modelInvocable,
-			userInvocable: entry.userInvocable
-		},
-		provider: PROVIDER_NAME,
-		source: "bundled",
-		rank: BUNDLED_SKILL_RANK,
-		resourceBase: resourceBase(entry.directory),
-		locator: entry.directory,
-		path: `${SKILLS_ROOT}${entry.directory}/SKILL.md`
-	};
+function readSkillFile(instructionFile) {
+	try {
+		return readFileSync(instructionFile, "utf8");
+	} catch (error) {
+		throw new BundledSkillError(`bundled skills: cannot read "${instructionFile}": ${messageOf(error)}`);
+	}
 }
-function createProvider(options) {
-	const read = options.read ?? ((directory) => readFileSync(`${SKILLS_ROOT}${directory}/SKILL.md`, "utf8"));
-	const entries = options.directories.map((directory) => toEntry(directory, read(directory)));
-	const byName = new Map(entries.map((entry) => [entry.name, entry]));
-	const load = (entry) => {
-		const { body } = parseFrontmatter(read(entry.directory));
-		return {
-			name: entry.name,
-			description: entry.description,
-			invocation: {
-				modelInvocable: entry.modelInvocable,
-				userInvocable: entry.userInvocable
-			},
-			provider: PROVIDER_NAME,
-			source: "bundled",
-			resourceBase: resourceBase(entry.directory),
-			path: `${SKILLS_ROOT}${entry.directory}/SKILL.md`,
-			content: body
-		};
-	};
-	return {
-		name: PROVIDER_NAME,
-		list: async () => entries.map(toCandidate),
-		get: async (candidate) => {
-			const entry = byName.get(candidate.name);
-			return entry ? load(entry) : void 0;
-		}
-	};
+/** Parse and validate one skill header, reporting failures as bundled-asset errors. */
+function readSkillFrontmatter(text, instructionFile) {
+	try {
+		const { data } = parseFrontmatter(text);
+		return validateSkillFrontmatter(data, instructionFile);
+	} catch (error) {
+		const message = messageOf(error);
+		throw new BundledSkillError(message.includes(instructionFile) ? message : `${instructionFile}: ${message}`);
+	}
+}
+function readOptionalSkillFile(instructionFile) {
+	try {
+		return readFileSync(instructionFile, "utf8");
+	} catch (error) {
+		if (errorCode(error) === "ENOENT") return void 0;
+		throw error;
+	}
+}
+function throwIfAborted(signal) {
+	if (signal?.aborted !== true) return;
+	throw signal.reason ?? /* @__PURE__ */ new Error("skill provider work was aborted");
+}
+function errorCode(error) {
+	if (typeof error !== "object" || error === null) return void 0;
+	const code = error.code;
+	return typeof code === "string" ? code : void 0;
 }
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+//#region src/index.ts
+/**
+* dsh-pstack Host entry.
+*
+* Unit 2 ships one minimal capability: a single `ctx.skills` provider over the
+* generated assets in this package. Delegation, restricted history, roles, and
+* the worktree integration are later units and are deliberately absent here.
+*
+* The provider contract types live in `./provider.ts` and are structural copies
+* of the `@deepseek-ai/dsh-skill` 0.2.1-rc.3 declarations, so this module imports
+* nothing from the host packages at runtime.
+*/
+/** Plugin name used by Loader diagnostics for this row. */
 const name = "pstack";
+/** The provider needs the skill registry and nothing else. */
 const inject = ["skills"];
-function listBundledSkillDirectories() {
-	return readdirSync(SKILLS_ROOT, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
-}
+/**
+* Minimal Standard Schema validator for this plugin's row config.
+*
+* Cordis validates `apply()`'s second argument with `Config["~standard"]` and
+* substitutes the returned `value`, so an omitted row `config` resolves to the
+* documented defaults without a schemastery dependency.
+*/
+const Config = { "~standard": {
+	version: 1,
+	vendor: "dsh-pstack",
+	validate(value) {
+		if (value === void 0 || value === null) return { value: { providerName: DEFAULT_PROVIDER_NAME } };
+		if (typeof value !== "object" || Array.isArray(value)) return { issues: [{ message: "config must be a mapping" }] };
+		const issues = [];
+		const record = value;
+		for (const key of Object.keys(record)) if (key !== "providerName") issues.push({
+			message: `unknown field "${key}"`,
+			path: [key]
+		});
+		const providerName = record["providerName"];
+		if (providerName === void 0) return issues.length > 0 ? { issues } : { value: { providerName: DEFAULT_PROVIDER_NAME } };
+		if (typeof providerName !== "string" || providerName.trim() === "") {
+			issues.push({
+				message: "providerName must be a non-empty string",
+				path: ["providerName"]
+			});
+			return { issues };
+		}
+		return issues.length > 0 ? { issues } : { value: { providerName } };
+	}
+} };
+/**
+* Register the bundled pstack skill provider.
+*
+* The bundled tree is validated before the provider registers, so a malformed
+* `SKILL.md` fails plugin activation with a path-qualified error instead of
+* removing one skill from the catalog. Nothing is copied out of the package and
+* nothing is watched: reinstalling the package is the refresh boundary.
+*
+* @param ctx - host context carrying the skill registry.
+* @param config - validated row config.
+* @throws {import("./provider.ts").BundledSkillError} when the bundled tree is malformed.
+*/
 function apply(ctx, config = {}) {
-	const directories = [.../* @__PURE__ */ new Set([...listBundledSkillDirectories(), ...config.extraSkillDirectories ?? []])];
-	ctx.skills.registerProvider(() => createProvider({ directories }));
+	const providerName = config.providerName ?? "pstack";
+	const index = loadBundledSkillIndex(SKILLS_ROOT);
+	ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, providerName));
 }
-/** Absolute root of the generated skill tree, exported for doctor checks. */
-const skillsRoot = SKILLS_ROOT;
-const skillsRootUrl = SKILLS_ROOT_URL;
 //#endregion
-export { apply, inject, name, skillsRoot, skillsRootUrl };
+export { AGENT_CONSUMED_FIELDS, AGENT_DROPPED_FIELDS, ASSETS_ROOT, BUNDLED_SKILL_RANK, BundledSkillError, Config, DEFAULT_PROVIDER_NAME, FrontmatterError, HARNESS_DOC_PATH, MAX_SKILL_NAME_LENGTH, PACKAGE_ROOT, SKILLS_ROOT, SKILL_CONSUMED_FIELDS, SKILL_DROPPED_FIELDS, agentDroppedFields, apply, createPstackSkillProvider, createPstackSkillProviderFromRoot, inject, loadBundledSkillIndex, name, parseFrontmatter, serializeAgentFrontmatter, serializeSkillFrontmatter, skillDroppedFields, validateAgentFrontmatter, validateSkillFrontmatter };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/frontmatter.ts","../src/provider.ts"],"sourcesContent":["/**\n * The pstack SKILL.md frontmatter subset: plain scalars, quoted scalars, and\n * folded or literal block scalars. Kept dependency-free so the plugin can be\n * imported at boot before any optional parser is available.\n */\n\nexport interface Frontmatter {\n  data: Record<string, string>;\n  body: string;\n}\n\nconst DELIMITER = \"---\";\n\nfunction unquote(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length >= 2) {\n    const first = trimmed[0];\n    const last = trimmed[trimmed.length - 1];\n    if ((first === '\"' && last === '\"') || (first === \"'\" && last === \"'\")) {\n      const inner = trimmed.slice(1, -1);\n      return first === '\"'\n        ? inner.replace(/\\\\\"/g, '\"').replace(/\\\\n/g, \"\\n\").replace(/\\\\\\\\/g, \"\\\\\")\n        : inner.replace(/''/g, \"'\");\n    }\n  }\n  return trimmed;\n}\n\nexport function parseFrontmatter(source: string): Frontmatter {\n  const normalized = source.replace(/\\r\\n/g, \"\\n\");\n  const lines = normalized.split(\"\\n\");\n  if (lines[0]?.trim() !== DELIMITER) return { data: {}, body: normalized };\n\n  let end = -1;\n  for (let index = 1; index < lines.length; index += 1) {\n    if (lines[index]?.trim() === DELIMITER) {\n      end = index;\n      break;\n    }\n  }\n  if (end === -1) return { data: {}, body: normalized };\n\n  const data: Record<string, string> = {};\n  let index = 1;\n  while (index < end) {\n    const line = lines[index] ?? \"\";\n    const match = /^([A-Za-z0-9_-]+):\\s*(.*)$/.exec(line);\n    if (!match) {\n      index += 1;\n      continue;\n    }\n    const key = match[1]!;\n    const rawValue = match[2] ?? \"\";\n    index += 1;\n\n    if (rawValue === \">\" || rawValue === \">-\" || rawValue === \"|\" || rawValue === \"|-\") {\n      const folded = rawValue.startsWith(\">\");\n      const collected: string[] = [];\n      while (index < end) {\n        const next = lines[index] ?? \"\";\n        if (next.trim() !== \"\" && !/^\\s/.test(next)) break;\n        collected.push(next.replace(/^\\s{1,4}/, \"\"));\n        index += 1;\n      }\n      data[key] = folded\n        ? collected.join(\" \").replace(/\\s+/g, \" \").trim()\n        : collected.join(\"\\n\").replace(/\\n+$/, \"\");\n      continue;\n    }\n\n    if (rawValue === \"\") {\n      const collected: string[] = [];\n      while (index < end) {\n        const next = lines[index] ?? \"\";\n        if (next.trim() !== \"\" && !/^\\s/.test(next)) break;\n        collected.push(next.trim());\n        index += 1;\n      }\n      data[key] = collected.join(\" \").trim();\n      continue;\n    }\n\n    data[key] = unquote(rawValue);\n  }\n\n  return {\n    data,\n    body: lines\n      .slice(end + 1)\n      .join(\"\\n\")\n      .replace(/^\\n+/, \"\"),\n  };\n}\n","/**\n * Bundled pstack skill provider.\n *\n * One provider hosts every pstack skill so the catalog stays one entry per\n * skill and the package ships as a single installable bundle. The provider is\n * immutable: `assets/skills/` is generated at build time, so discovery always\n * completes with the same list.\n */\nimport { readdirSync, readFileSync } from \"node:fs\";\nimport type { Context } from \"@deepseek-ai/cordis\";\nimport {\n  BUNDLED_SKILL_RANK,\n  type SkillCandidate,\n  type SkillDefinition,\n  type SkillProvider,\n} from \"@deepseek-ai/dsh-skill\";\nimport { parseFrontmatter } from \"./frontmatter.ts\";\nimport { SKILLS_ROOT, SKILLS_ROOT_URL } from \"./paths.ts\";\n\nexport interface PstackSkillEntry {\n  readonly name: string;\n  readonly description: string;\n  readonly modelInvocable: boolean;\n  readonly userInvocable: boolean;\n  readonly directory: string;\n}\n\nexport const PROVIDER_NAME = \"pstack\";\n\nfunction text(value: string | undefined): string {\n  return (value ?? \"\").trim();\n}\n\n/**\n * Parse one generated SKILL.md into the catalog entry the provider serves.\n * Generated files always carry `name` and `description`; a hand-edit that\n * removes them fails loudly instead of silently dropping the skill.\n */\nexport function toEntry(directory: string, source: string): PstackSkillEntry {\n  const { data } = parseFrontmatter(source);\n  if (!text(data.name) || !text(data.description)) {\n    throw new Error(`pstack skill \"${directory}\" is missing name or description frontmatter`);\n  }\n  return {\n    name: text(data.name),\n    description: text(data.description),\n    modelInvocable: data[\"disable-model-invocation\"] !== \"true\",\n    userInvocable: data[\"user-invocable\"] !== \"false\",\n    directory,\n  };\n}\n\nfunction resourceBase(directory: string) {\n  return { kind: \"directory\" as const, path: `${SKILLS_ROOT}${directory}/` };\n}\n\nexport function toCandidate(entry: PstackSkillEntry): SkillCandidate {\n  return {\n    name: entry.name,\n    description: entry.description,\n    invocation: { modelInvocable: entry.modelInvocable, userInvocable: entry.userInvocable },\n    provider: PROVIDER_NAME,\n    source: \"bundled\",\n    rank: BUNDLED_SKILL_RANK,\n    resourceBase: resourceBase(entry.directory),\n    locator: entry.directory,\n    path: `${SKILLS_ROOT}${entry.directory}/SKILL.md`,\n  };\n}\n\nexport interface PstackProviderOptions {\n  /** Directory names to serve. The build passes the generated list. */\n  readonly directories: readonly string[];\n  /** Reads one skill body. Tests override it to avoid touching the package. */\n  readonly read?: (directory: string) => string;\n}\n\nexport function createProvider(options: PstackProviderOptions): SkillProvider {\n  const read =\n    options.read ??\n    ((directory: string) => readFileSync(`${SKILLS_ROOT}${directory}/SKILL.md`, \"utf8\"));\n  const entries = options.directories.map((directory) => toEntry(directory, read(directory)));\n  const byName = new Map(entries.map((entry) => [entry.name, entry]));\n\n  const load = (entry: PstackSkillEntry): SkillDefinition => {\n    const { body } = parseFrontmatter(read(entry.directory));\n    return {\n      name: entry.name,\n      description: entry.description,\n      invocation: { modelInvocable: entry.modelInvocable, userInvocable: entry.userInvocable },\n      provider: PROVIDER_NAME,\n      source: \"bundled\",\n      resourceBase: resourceBase(entry.directory),\n      path: `${SKILLS_ROOT}${entry.directory}/SKILL.md`,\n      content: body,\n    };\n  };\n\n  return {\n    name: PROVIDER_NAME,\n    list: async () => entries.map(toCandidate),\n    get: async (candidate) => {\n      const entry = byName.get(candidate.name);\n      return entry ? load(entry) : undefined;\n    },\n  };\n}\n\nexport const name = \"pstack\";\n\nexport interface Config {\n  /** Extra skill directories to serve in addition to the bundled set. */\n  readonly extraSkillDirectories?: string[];\n}\n\nexport const inject = [\"skills\"];\n\nexport function listBundledSkillDirectories(): string[] {\n  return readdirSync(SKILLS_ROOT, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory())\n    .map((entry) => entry.name)\n    .sort();\n}\n\nexport function apply(ctx: Context, config: Config = {}): void {\n  const directories = [\n    ...new Set([...listBundledSkillDirectories(), ...(config.extraSkillDirectories ?? [])]),\n  ];\n  ctx.skills.registerProvider(() => createProvider({ directories }));\n}\n\n/** Absolute root of the generated skill tree, exported for doctor checks. */\nexport const skillsRoot = SKILLS_ROOT;\nexport const skillsRootUrl = SKILLS_ROOT_URL;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/provider.ts","../src/index.ts"],"sourcesContent":["/**\n * The bundled pstack skill provider: one provider over the 55 generated skills\n * that ship inside this package.\n *\n * The provider contract below mirrors `@deepseek-ai/dsh-skill` 0.2.1-rc.3, which\n * was read through the host Inspect provider (`Service.listService` with\n * `service: \"skills\"`) and the installed type declarations. It is restated here\n * as a structural contract instead of imported so the plugin keeps zero runtime\n * imports from the host packages: a workspace-directory bundle is linked from\n * its checkout, where `@deepseek-ai/*` is not resolvable.\n *\n * Design constraints this module enforces, from the port design document §8.1:\n *\n * - The catalog is built once from the package assets and never watched. A\n *   package update is the refresh boundary.\n * - A malformed bundled skill fails the whole index instead of disappearing\n *   from the catalog, so a broken asset is a startup error rather than a skill\n *   users silently cannot see.\n * - `get()` only accepts a locator this provider produced. Directory names are\n *   never joined from caller input.\n */\n\nimport { readFileSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport { parseFrontmatter, validateSkillFrontmatter } from \"./frontmatter.ts\";\n\n/**\n * Standard precedence rank for packaged skill providers, re-exported by\n * `@deepseek-ai/dsh-skill` as `BUNDLED_SKILL_RANK`. Restated to keep the package\n * dependency-free; a mismatch only changes which provider wins a name collision.\n */\nexport const BUNDLED_SKILL_RANK = 600;\n\n/** Default provider name used when the row does not override it. */\nexport const DEFAULT_PROVIDER_NAME = \"pstack\";\n\n/** Origin bucket for a skill contribution. */\nexport type SkillSource =\n  | \"project-dsh\"\n  | \"project-agents\"\n  | \"runtime\"\n  | \"user-dsh\"\n  | \"user-agents\"\n  | \"custom\"\n  | \"bundled\"\n  | (string & {});\n\n/** Optional provider-specific base used by loaded skill bodies to resolve relative resources. */\nexport type SkillResourceBase =\n  | { readonly kind: \"directory\"; readonly path: string }\n  | { readonly kind: \"url\"; readonly url: string }\n  | { readonly kind: \"opaque\"; readonly description: string };\n\n/** Invocation controls shared by skill discovery consumers. */\nexport interface SkillInvocationPolicy {\n  /** Whether model-facing catalogs and loaders include this skill. */\n  readonly modelInvocable: boolean;\n  /** Whether human-facing command catalogs and loaders include this skill. */\n  readonly userInvocable: boolean;\n}\n\n/** Invocation-neutral skill metadata returned by `ctx.skills.list()`. */\nexport interface SkillSummary {\n  /** Absolute instruction file path. */\n  readonly path?: string;\n  /** Kebab-case identifier used to address the skill. */\n  readonly name: string;\n  /** Short routing description shown by discovery consumers. */\n  readonly description: string;\n  /** Optional extra routing guidance. */\n  readonly whenToUse?: string;\n  /** Resolved model and user invocation controls. */\n  readonly invocation: SkillInvocationPolicy;\n  /** Discovery source that produced this skill. */\n  readonly source: SkillSource;\n  /** Provider that owns this skill body. */\n  readonly provider: string;\n  /** Provider-specific base for relative resources. */\n  readonly resourceBase?: SkillResourceBase;\n}\n\n/** Provider catalog entry used by the registry to merge and later load skills. */\nexport interface SkillCandidate extends SkillSummary {\n  /** Lower ranks win duplicate skill names. */\n  readonly rank: number;\n  /** Opaque provider-owned handle passed back to `provider.get()`. */\n  readonly locator: unknown;\n  /** Parsed optional metadata object from provider-specific skill frontmatter. */\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\n/** Complete parsed skill definition, including the body loaded by `ctx.skills.get()`. */\nexport interface SkillDefinition extends SkillSummary {\n  /** Markdown instruction body after frontmatter removal. */\n  readonly content: string;\n  /** Parsed optional metadata object from frontmatter. */\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\n/** Caller context used for cwd-sensitive and abortable provider work. */\nexport interface SkillLookupOptions {\n  /** Workspace selector for the current lookup. */\n  readonly cwd?: string | undefined;\n  /** Abort discovery or loading work for the current caller. */\n  readonly signal?: AbortSignal | undefined;\n}\n\n/** Registration-scoped lifecycle capability handed to a provider factory. */\nexport interface SkillProviderControl {\n  /** Aborts when registration fails or the exact provider registration is disposed. */\n  readonly signal: AbortSignal;\n  /** Invalidate completed catalogs and notify consumers. */\n  readonly invalidate: () => void;\n}\n\n/** Provider interface for one source of skills. */\nexport interface SkillProvider {\n  /** Unique provider name in the `ctx.skills` registry. */\n  readonly name: string;\n  /** List available skill candidates for the current lookup context. */\n  readonly list: (options: SkillLookupOptions) => Promise<readonly SkillCandidate[]>;\n  /** Load a complete skill body for a previously listed candidate. */\n  readonly get: (\n    candidate: SkillCandidate,\n    options: SkillLookupOptions,\n  ) => Promise<SkillDefinition | undefined>;\n}\n\n/** Opaque handle this provider hands back to itself; never derived from caller input. */\ninterface BundledSkillLocator {\n  readonly kind: \"bundled-skill\";\n  /** Absolute skill directory that also serves as the resource base. */\n  readonly directory: string;\n  /** Absolute `SKILL.md` path read by `get()`. */\n  readonly instructionFile: string;\n}\n\n/** One validated on-disk bundled skill. */\nexport interface BundledSkill {\n  readonly name: string;\n  readonly description: string;\n  readonly whenToUse?: string;\n  readonly invocation: SkillInvocationPolicy;\n  /** Absolute skill directory; the candidate resource base. */\n  readonly directory: string;\n  /** Absolute `SKILL.md` path. */\n  readonly instructionFile: string;\n}\n\n/** Validated skills keyed by their absolute directory. */\nexport type BundledSkillIndex = ReadonlyMap<string, BundledSkill>;\n\n/** Raised when a bundled asset violates the provider contract. */\nexport class BundledSkillError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"BundledSkillError\";\n  }\n}\n\n/**\n * Read and validate every bundled skill below one directory.\n *\n * This is the startup check: it runs before the provider registers, so a missing\n * `SKILL.md`, an invalid frontmatter block, or a name that disagrees with its\n * directory fails plugin activation with a path-qualified message instead of\n * dropping a skill from the catalog.\n *\n * @param skillsRoot - absolute path of the directory holding the skill directories.\n * @returns validated skills keyed by absolute skill directory, sorted by name.\n * @throws {BundledSkillError} when the tree or any skill in it is malformed.\n */\nexport function loadBundledSkillIndex(skillsRoot: string): BundledSkillIndex {\n  let entries;\n  try {\n    entries = readdirSync(skillsRoot, { withFileTypes: true });\n  } catch (error) {\n    throw new BundledSkillError(\n      `bundled skills: cannot read \"${skillsRoot}\": ${messageOf(error)}`,\n    );\n  }\n\n  const index = new Map<string, BundledSkill>();\n\n  for (const entry of entries.sort((left, right) => (left.name < right.name ? -1 : 1))) {\n    const directory = join(skillsRoot, entry.name);\n    if (!entry.isDirectory()) {\n      throw new BundledSkillError(\n        `bundled skills: \"${directory}\" is not a skill directory; remove it or add a SKILL.md`,\n      );\n    }\n\n    const instructionFile = join(directory, \"SKILL.md\");\n    const text = readSkillFile(instructionFile);\n    const frontmatter = readSkillFrontmatter(text, instructionFile);\n\n    if (frontmatter.name !== entry.name) {\n      throw new BundledSkillError(\n        `${instructionFile}: skill name \"${frontmatter.name}\" does not match its directory \"${entry.name}\"`,\n      );\n    }\n\n    index.set(directory, {\n      name: frontmatter.name,\n      description: frontmatter.description,\n      ...(frontmatter.whenToUse === undefined ? {} : { whenToUse: frontmatter.whenToUse }),\n      invocation: {\n        modelInvocable: !frontmatter.disableModelInvocation,\n        userInvocable: frontmatter.userInvocable,\n      },\n      directory,\n      instructionFile,\n    });\n  }\n\n  if (index.size === 0) {\n    throw new BundledSkillError(`bundled skills: no skill directories under \"${skillsRoot}\"`);\n  }\n\n  return index;\n}\n\n/**\n * Build the provider over an already validated index.\n *\n * @param index - result of {@link loadBundledSkillIndex}.\n * @param providerName - registry name for this provider.\n * @returns a read-only provider whose catalog never changes until the package does.\n */\nexport function createPstackSkillProvider(\n  index: BundledSkillIndex,\n  providerName: string = DEFAULT_PROVIDER_NAME,\n): SkillProvider {\n  const ordered = [...index.values()].sort((left, right) =>\n    left.name < right.name ? -1 : left.name > right.name ? 1 : 0,\n  );\n\n  return {\n    name: providerName,\n\n    async list(options) {\n      throwIfAborted(options?.signal);\n      return ordered.map(\n        (skill): SkillCandidate => ({\n          name: skill.name,\n          description: skill.description,\n          ...(skill.whenToUse === undefined ? {} : { whenToUse: skill.whenToUse }),\n          invocation: skill.invocation,\n          source: \"bundled\",\n          provider: providerName,\n          rank: BUNDLED_SKILL_RANK,\n          locator: {\n            kind: \"bundled-skill\",\n            directory: skill.directory,\n            instructionFile: skill.instructionFile,\n          } satisfies BundledSkillLocator,\n          path: skill.instructionFile,\n          resourceBase: { kind: \"directory\", path: skill.directory },\n        }),\n      );\n    },\n\n    async get(candidate, options) {\n      const locator = asBundledSkillLocator(candidate.locator);\n      if (locator === undefined) return undefined;\n\n      const skill = index.get(locator.directory);\n      if (\n        skill === undefined ||\n        skill.instructionFile !== locator.instructionFile ||\n        skill.name !== candidate.name\n      ) {\n        return undefined;\n      }\n\n      throwIfAborted(options?.signal);\n\n      const text = readOptionalSkillFile(skill.instructionFile);\n      if (text === undefined) return undefined;\n      const { body } = parseFrontmatter(text);\n\n      return {\n        name: skill.name,\n        description: skill.description,\n        ...(skill.whenToUse === undefined ? {} : { whenToUse: skill.whenToUse }),\n        invocation: skill.invocation,\n        source: \"bundled\",\n        provider: providerName,\n        path: skill.instructionFile,\n        resourceBase: { kind: \"directory\", path: skill.directory },\n        content: body,\n      };\n    },\n  };\n}\n\n/**\n * Load the index and build the provider in one step, failing on a malformed tree.\n *\n * `apply()` uses this exact function, so the startup failure path and the\n * provider used in tests are the same code.\n *\n * @param skillsRoot - absolute path of the bundled skill root.\n * @param providerName - registry name for this provider.\n * @returns the provider over the validated index.\n */\nexport function createPstackSkillProviderFromRoot(\n  skillsRoot: string,\n  providerName: string = DEFAULT_PROVIDER_NAME,\n): SkillProvider {\n  return createPstackSkillProvider(loadBundledSkillIndex(skillsRoot), providerName);\n}\n\nfunction asBundledSkillLocator(locator: unknown): BundledSkillLocator | undefined {\n  if (typeof locator !== \"object\" || locator === null) return undefined;\n  const candidate = locator as Partial<BundledSkillLocator>;\n  if (candidate.kind !== \"bundled-skill\") return undefined;\n  if (typeof candidate.directory !== \"string\") return undefined;\n  if (typeof candidate.instructionFile !== \"string\") return undefined;\n  return {\n    kind: \"bundled-skill\",\n    directory: candidate.directory,\n    instructionFile: candidate.instructionFile,\n  };\n}\n\nfunction readSkillFile(instructionFile: string): string {\n  try {\n    return readFileSync(instructionFile, \"utf8\");\n  } catch (error) {\n    throw new BundledSkillError(\n      `bundled skills: cannot read \"${instructionFile}\": ${messageOf(error)}`,\n    );\n  }\n}\n\n/** Parse and validate one skill header, reporting failures as bundled-asset errors. */\nfunction readSkillFrontmatter(\n  text: string,\n  instructionFile: string,\n): ReturnType<typeof validateSkillFrontmatter> {\n  try {\n    const { data } = parseFrontmatter(text);\n    return validateSkillFrontmatter(data, instructionFile);\n  } catch (error) {\n    const message = messageOf(error);\n    throw new BundledSkillError(\n      message.includes(instructionFile) ? message : `${instructionFile}: ${message}`,\n    );\n  }\n}\n\nfunction readOptionalSkillFile(instructionFile: string): string | undefined {\n  try {\n    return readFileSync(instructionFile, \"utf8\");\n  } catch (error) {\n    if (errorCode(error) === \"ENOENT\") return undefined;\n    throw error;\n  }\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted !== true) return;\n  throw signal.reason ?? new Error(\"skill provider work was aborted\");\n}\n\nfunction errorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) return undefined;\n  const code = (error as { code?: unknown }).code;\n  return typeof code === \"string\" ? code : undefined;\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","/**\n * dsh-pstack Host entry.\n *\n * Unit 2 ships one minimal capability: a single `ctx.skills` provider over the\n * generated assets in this package. Delegation, restricted history, roles, and\n * the worktree integration are later units and are deliberately absent here.\n *\n * The provider contract types live in `./provider.ts` and are structural copies\n * of the `@deepseek-ai/dsh-skill` 0.2.1-rc.3 declarations, so this module imports\n * nothing from the host packages at runtime.\n */\n\nimport { SKILLS_ROOT } from \"./paths.ts\";\nimport {\n  DEFAULT_PROVIDER_NAME,\n  createPstackSkillProvider,\n  loadBundledSkillIndex,\n} from \"./provider.ts\";\nimport type { SkillProvider, SkillProviderControl } from \"./provider.ts\";\n\n/** Plugin name used by Loader diagnostics for this row. */\nexport const name = \"pstack\";\n\n/** The provider needs the skill registry and nothing else. */\nexport const inject = [\"skills\"];\n\n/** Row configuration. Every field is optional; an omitted `config` is valid. */\nexport interface PstackConfig {\n  /** Registry name for the provider; change it when two rows must coexist. */\n  readonly providerName?: string;\n}\n\ninterface StandardSchemaIssue {\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\ntype StandardSchemaResult =\n  | { readonly value: PstackConfig; readonly issues?: undefined }\n  | { readonly issues: readonly StandardSchemaIssue[] };\n\n/**\n * Minimal Standard Schema validator for this plugin's row config.\n *\n * Cordis validates `apply()`'s second argument with `Config[\"~standard\"]` and\n * substitutes the returned `value`, so an omitted row `config` resolves to the\n * documented defaults without a schemastery dependency.\n */\nexport const Config = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"dsh-pstack\",\n    validate(value: unknown): StandardSchemaResult {\n      if (value === undefined || value === null) {\n        return { value: { providerName: DEFAULT_PROVIDER_NAME } };\n      }\n      if (typeof value !== \"object\" || Array.isArray(value)) {\n        return { issues: [{ message: \"config must be a mapping\" }] };\n      }\n\n      const issues: StandardSchemaIssue[] = [];\n      const record = value as Record<string, unknown>;\n      for (const key of Object.keys(record)) {\n        if (key !== \"providerName\") issues.push({ message: `unknown field \"${key}\"`, path: [key] });\n      }\n\n      const providerName = record[\"providerName\"];\n      if (providerName === undefined) {\n        return issues.length > 0\n          ? { issues }\n          : { value: { providerName: DEFAULT_PROVIDER_NAME } };\n      }\n      if (typeof providerName !== \"string\" || providerName.trim() === \"\") {\n        issues.push({ message: \"providerName must be a non-empty string\", path: [\"providerName\"] });\n        return { issues };\n      }\n\n      return issues.length > 0 ? { issues } : { value: { providerName } };\n    },\n  },\n};\n\n/** The slice of the Cordis context this plugin requires. */\nexport interface PstackSkillHost {\n  readonly skills: {\n    registerProvider(create: (control: SkillProviderControl) => SkillProvider): () => void;\n  };\n}\n\n/**\n * Register the bundled pstack skill provider.\n *\n * The bundled tree is validated before the provider registers, so a malformed\n * `SKILL.md` fails plugin activation with a path-qualified error instead of\n * removing one skill from the catalog. Nothing is copied out of the package and\n * nothing is watched: reinstalling the package is the refresh boundary.\n *\n * @param ctx - host context carrying the skill registry.\n * @param config - validated row config.\n * @throws {import(\"./provider.ts\").BundledSkillError} when the bundled tree is malformed.\n */\nexport function apply(ctx: PstackSkillHost, config: PstackConfig = {}): void {\n  const providerName = config.providerName ?? DEFAULT_PROVIDER_NAME;\n  const index = loadBundledSkillIndex(SKILLS_ROOT);\n  ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, providerName));\n}\n\nexport { ASSETS_ROOT, HARNESS_DOC_PATH, PACKAGE_ROOT, SKILLS_ROOT } from \"./paths.ts\";\nexport {\n  BUNDLED_SKILL_RANK,\n  BundledSkillError,\n  DEFAULT_PROVIDER_NAME,\n  createPstackSkillProvider,\n  createPstackSkillProviderFromRoot,\n  loadBundledSkillIndex,\n} from \"./provider.ts\";\nexport type {\n  BundledSkill,\n  BundledSkillIndex,\n  SkillCandidate,\n  SkillDefinition,\n  SkillInvocationPolicy,\n  SkillLookupOptions,\n  SkillProvider,\n  SkillProviderControl,\n  SkillResourceBase,\n  SkillSource,\n  SkillSummary,\n} from \"./provider.ts\";\nexport * from \"./frontmatter.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,qBAAqB;;AAGlC,MAAa,wBAAwB;;AAuHrC,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;;;;;;;;;;;;AAcA,SAAgB,sBAAsB,YAAuC;CAC3E,IAAI;CACJ,IAAI;EACF,UAAU,YAAY,YAAY,EAAE,eAAe,KAAK,CAAC;CAC3D,SAAS,OAAO;EACd,MAAM,IAAI,kBACR,gCAAgC,WAAW,KAAK,UAAU,KAAK,GACjE;CACF;CAEA,MAAM,wBAAQ,IAAI,IAA0B;CAE5C,KAAK,MAAM,SAAS,QAAQ,MAAM,MAAM,UAAW,KAAK,OAAO,MAAM,OAAO,KAAK,CAAE,GAAG;EACpF,MAAM,YAAY,KAAK,YAAY,MAAM,IAAI;EAC7C,IAAI,CAAC,MAAM,YAAY,GACrB,MAAM,IAAI,kBACR,oBAAoB,UAAU,wDAChC;EAGF,MAAM,kBAAkB,KAAK,WAAW,UAAU;EAElD,MAAM,cAAc,qBADP,cAAc,eACiB,GAAG,eAAe;EAE9D,IAAI,YAAY,SAAS,MAAM,MAC7B,MAAM,IAAI,kBACR,GAAG,gBAAgB,gBAAgB,YAAY,KAAK,kCAAkC,MAAM,KAAK,EACnG;EAGF,MAAM,IAAI,WAAW;GACnB,MAAM,YAAY;GAClB,aAAa,YAAY;GACzB,GAAI,YAAY,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,YAAY,UAAU;GAClF,YAAY;IACV,gBAAgB,CAAC,YAAY;IAC7B,eAAe,YAAY;GAC7B;GACA;GACA;EACF,CAAC;CACH;CAEA,IAAI,MAAM,SAAS,GACjB,MAAM,IAAI,kBAAkB,+CAA+C,WAAW,EAAE;CAG1F,OAAO;AACT;;;;;;;;AASA,SAAgB,0BACd,OACA,eAAuB,uBACR;CACf,MAAM,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,UAC9C,KAAK,OAAO,MAAM,OAAO,KAAK,KAAK,OAAO,MAAM,OAAO,IAAI,CAC7D;CAEA,OAAO;EACL,MAAM;EAEN,MAAM,KAAK,SAAS;GAClB,eAAe,SAAS,MAAM;GAC9B,OAAO,QAAQ,KACZ,WAA2B;IAC1B,MAAM,MAAM;IACZ,aAAa,MAAM;IACnB,GAAI,MAAM,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,MAAM,UAAU;IACtE,YAAY,MAAM;IAClB,QAAQ;IACR,UAAU;IACV,MAAA;IACA,SAAS;KACP,MAAM;KACN,WAAW,MAAM;KACjB,iBAAiB,MAAM;IACzB;IACA,MAAM,MAAM;IACZ,cAAc;KAAE,MAAM;KAAa,MAAM,MAAM;IAAU;GAC3D,EACF;EACF;EAEA,MAAM,IAAI,WAAW,SAAS;GAC5B,MAAM,UAAU,sBAAsB,UAAU,OAAO;GACvD,IAAI,YAAY,KAAA,GAAW,OAAO,KAAA;GAElC,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS;GACzC,IACE,UAAU,KAAA,KACV,MAAM,oBAAoB,QAAQ,mBAClC,MAAM,SAAS,UAAU,MAEzB;GAGF,eAAe,SAAS,MAAM;GAE9B,MAAM,OAAO,sBAAsB,MAAM,eAAe;GACxD,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;GAC/B,MAAM,EAAE,SAAS,iBAAiB,IAAI;GAEtC,OAAO;IACL,MAAM,MAAM;IACZ,aAAa,MAAM;IACnB,GAAI,MAAM,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,MAAM,UAAU;IACtE,YAAY,MAAM;IAClB,QAAQ;IACR,UAAU;IACV,MAAM,MAAM;IACZ,cAAc;KAAE,MAAM;KAAa,MAAM,MAAM;IAAU;IACzD,SAAS;GACX;EACF;CACF;AACF;;;;;;;;;;;AAYA,SAAgB,kCACd,YACA,eAAuB,uBACR;CACf,OAAO,0BAA0B,sBAAsB,UAAU,GAAG,YAAY;AAClF;AAEA,SAAS,sBAAsB,SAAmD;CAChF,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO,KAAA;CAC5D,MAAM,YAAY;CAClB,IAAI,UAAU,SAAS,iBAAiB,OAAO,KAAA;CAC/C,IAAI,OAAO,UAAU,cAAc,UAAU,OAAO,KAAA;CACpD,IAAI,OAAO,UAAU,oBAAoB,UAAU,OAAO,KAAA;CAC1D,OAAO;EACL,MAAM;EACN,WAAW,UAAU;EACrB,iBAAiB,UAAU;CAC7B;AACF;AAEA,SAAS,cAAc,iBAAiC;CACtD,IAAI;EACF,OAAO,aAAa,iBAAiB,MAAM;CAC7C,SAAS,OAAO;EACd,MAAM,IAAI,kBACR,gCAAgC,gBAAgB,KAAK,UAAU,KAAK,GACtE;CACF;AACF;;AAGA,SAAS,qBACP,MACA,iBAC6C;CAC7C,IAAI;EACF,MAAM,EAAE,SAAS,iBAAiB,IAAI;EACtC,OAAO,yBAAyB,MAAM,eAAe;CACvD,SAAS,OAAO;EACd,MAAM,UAAU,UAAU,KAAK;EAC/B,MAAM,IAAI,kBACR,QAAQ,SAAS,eAAe,IAAI,UAAU,GAAG,gBAAgB,IAAI,SACvE;CACF;AACF;AAEA,SAAS,sBAAsB,iBAA6C;CAC1E,IAAI;EACF,OAAO,aAAa,iBAAiB,MAAM;CAC7C,SAAS,OAAO;EACd,IAAI,UAAU,KAAK,MAAM,UAAU,OAAO,KAAA;EAC1C,MAAM;CACR;AACF;AAEA,SAAS,eAAe,QAAuC;CAC7D,IAAI,QAAQ,YAAY,MAAM;CAC9B,MAAM,OAAO,0BAAU,IAAI,MAAM,iCAAiC;AACpE;AAEA,SAAS,UAAU,OAAoC;CACrD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,OAAQ,MAA6B;CAC3C,OAAO,OAAO,SAAS,WAAW,OAAO,KAAA;AAC3C;AAEA,SAAS,UAAU,OAAwB;CACzC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;;;;;;;;;;;;;;AClWA,MAAa,OAAO;;AAGpB,MAAa,SAAS,CAAC,QAAQ;;;;;;;;AAwB/B,MAAa,SAAS,EACpB,aAAa;CACX,SAAS;CACT,QAAQ;CACR,SAAS,OAAsC;EAC7C,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO,EAAE,OAAO,EAAE,cAAc,sBAAsB,EAAE;EAE1D,IAAI,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAClD,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,2BAA2B,CAAC,EAAE;EAG7D,MAAM,SAAgC,CAAC;EACvC,MAAM,SAAS;EACf,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,IAAI,QAAQ,gBAAgB,OAAO,KAAK;GAAE,SAAS,kBAAkB,IAAI;GAAI,MAAM,CAAC,GAAG;EAAE,CAAC;EAG5F,MAAM,eAAe,OAAO;EAC5B,IAAI,iBAAiB,KAAA,GACnB,OAAO,OAAO,SAAS,IACnB,EAAE,OAAO,IACT,EAAE,OAAO,EAAE,cAAc,sBAAsB,EAAE;EAEvD,IAAI,OAAO,iBAAiB,YAAY,aAAa,KAAK,MAAM,IAAI;GAClE,OAAO,KAAK;IAAE,SAAS;IAA2C,MAAM,CAAC,cAAc;GAAE,CAAC;GAC1F,OAAO,EAAE,OAAO;EAClB;EAEA,OAAO,OAAO,SAAS,IAAI,EAAE,OAAO,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE;CACpE;AACF,EACF;;;;;;;;;;;;;AAqBA,SAAgB,MAAM,KAAsB,SAAuB,CAAC,GAAS;CAC3E,MAAM,eAAe,OAAO,gBAAA;CAC5B,MAAM,QAAQ,sBAAsB,WAAW;CAC/C,IAAI,OAAO,kBAAkB,aAAa,0BAA0B,OAAO,YAAY,CAAC;AAC1F"}

package/dist/paths-D_JlVmBk.mjs

@@ -0,0 +1,42 @@
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/paths.ts
+/**
+* Package-internal resource locations.
+*
+* The provider reads generated assets in place instead of copying them into a
+* user-visible skills directory, so every path here is resolved from this
+* module's own location. The modules run from `src/` in a checkout and from the
+* bundled `dist/index.mjs` in an installed package; both sit one directory below
+* the package root, so the same expression holds in both cases.
+*/
+/** Absolute path of the package root: the repository in a checkout, the install directory after packing. */
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+/** Absolute path of the generated, committed assets directory. */
+const ASSETS_ROOT = join(PACKAGE_ROOT, "assets");
+/** Absolute path of the directory holding the 55 bundled skill directories. */
+const SKILLS_ROOT = join(ASSETS_ROOT, "skills");
+/** Absolute path of the directory holding the generated agent preambles. */
+const AGENTS_ROOT = join(ASSETS_ROOT, "agents");
+/**
+* Absolute path of the `poteto-mode` instructions.
+*
+* `pstack_subagent` injects this path into a `poteto-agent` child's prompt, so the
+* child reads the playbook from where it actually is instead of searching a Cursor
+* plugin install for the highest version.
+*/
+const POTETO_MODE_SKILL_PATH = join(SKILLS_ROOT, "poteto-mode", "SKILL.md");
+/** Absolute path of the generated harness mapping document. */
+const HARNESS_DOC_PATH = join(ASSETS_ROOT, "docs", "harness", "dsh.md");
+/**
+* Absolute path of one agent preamble.
+*
+* Returns `undefined` for `general`, which is a plain child and gets no preamble.
+*/
+function agentPreamblePath(agent) {
+	return agent === "general" ? void 0 : join(AGENTS_ROOT, `${agent}.md`);
+}
+//#endregion
+export { SKILLS_ROOT as a, POTETO_MODE_SKILL_PATH as i, HARNESS_DOC_PATH as n, agentPreamblePath as o, PACKAGE_ROOT as r, ASSETS_ROOT as t };
+
+//# sourceMappingURL=paths-D_JlVmBk.mjs.map

package/dist/paths-D_JlVmBk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-D_JlVmBk.mjs","names":[],"sources":["../src/paths.ts"],"sourcesContent":["/**\n * Package-internal resource locations.\n *\n * The provider reads generated assets in place instead of copying them into a\n * user-visible skills directory, so every path here is resolved from this\n * module's own location. The modules run from `src/` in a checkout and from the\n * bundled `dist/index.mjs` in an installed package; both sit one directory below\n * the package root, so the same expression holds in both cases.\n */\n\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** Absolute path of the package root: the repository in a checkout, the install directory after packing. */\nexport const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\n\n/** Absolute path of the generated, committed assets directory. */\nexport const ASSETS_ROOT = join(PACKAGE_ROOT, \"assets\");\n\n/** Absolute path of the directory holding the 55 bundled skill directories. */\nexport const SKILLS_ROOT = join(ASSETS_ROOT, \"skills\");\n\n/** Absolute path of the directory holding the generated agent preambles. */\nexport const AGENTS_ROOT = join(ASSETS_ROOT, \"agents\");\n\n/**\n * Absolute path of the `poteto-mode` instructions.\n *\n * `pstack_subagent` injects this path into a `poteto-agent` child's prompt, so the\n * child reads the playbook from where it actually is instead of searching a Cursor\n * plugin install for the highest version.\n */\nexport const POTETO_MODE_SKILL_PATH = join(SKILLS_ROOT, \"poteto-mode\", \"SKILL.md\");\n\n/** Absolute path of the generated harness mapping document. */\nexport const HARNESS_DOC_PATH = join(ASSETS_ROOT, \"docs\", \"harness\", \"dsh.md\");\n\n/**\n * Absolute path of one agent preamble.\n *\n * Returns `undefined` for `general`, which is a plain child and gets no preamble.\n */\nexport function agentPreamblePath(agent: string): string | undefined {\n  return agent === \"general\" ? undefined : join(AGENTS_ROOT, `${agent}.md`);\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAa,eAAe,QAAQ,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,IAAI;;AAGjF,MAAa,cAAc,KAAK,cAAc,QAAQ;;AAGtD,MAAa,cAAc,KAAK,aAAa,QAAQ;;AAGrD,MAAa,cAAc,KAAK,aAAa,QAAQ;;;;;;;;AASrD,MAAa,yBAAyB,KAAK,aAAa,eAAe,UAAU;;AAGjF,MAAa,mBAAmB,KAAK,aAAa,QAAQ,WAAW,QAAQ;;;;;;AAO7E,SAAgB,kBAAkB,OAAmC;CACnE,OAAO,UAAU,YAAY,KAAA,IAAY,KAAK,aAAa,GAAG,MAAM,IAAI;AAC1E"}