dsh-pstack 0.0.0-stage → 0.2.0-beta.1

package/assets/skills/why/references/synthesizer-prompt.md

@@ -0,0 +1,129 @@
+# Synthesizer Prompt Template
+
+Fill in the placeholders.
+
+---
+
+You are answering a "why" question about a piece of code by synthesizing findings from investigators who searched different historical sources (source control, issue / ticket tracker, long-form documents, real-time team chat, infrastructure observability, error / exception tracking, product analytics warehouse, and code comments). Produce a confidence-weighted, evidence-cited narrative that says honestly what the evidence supports, and just as honestly what it doesn't.
+
+## The Question
+
+> {QUESTION}
+
+## The Code Anchor
+
+**Target files:** {FILES_WITH_LINE_RANGES}
+
+**Key symbols:** {SYMBOLS}
+
+## Investigator Findings
+
+{ALL_INVESTIGATOR_FINDINGS}
+
+## Sources That Weren't Searched
+
+{SKIPPED_SOURCES_WITH_REASONS}
+
+## Epistemics Framework
+
+You MUST follow `references/epistemics.md`. Read it in full before writing. The key rules:
+
+1. Every claim must sit in one tier: **Direct**, **Supported**, **Inferred**, **Speculative**, **Unknown**. The tier sets its section and its phrasing.
+2. Every Direct/Supported claim must have a citation (PR #, ticket ID, doc URL, chat permalink, commit hash, or file:line).
+3. Inferred and Speculative claims must use hedged language ("appears to", "likely", "suggests", "one possibility is").
+4. Never cite code as evidence for its own intent.
+5. Document gaps. Don't fill them with plausible-sounding guesses.
+6. Treat a hypothesis embedded in the user's question as a candidate, not a conclusion. Check it independently.
+
+## Instructions
+
+1. **Read all investigator findings** and weigh the evidence yourself. Investigators gathered raw evidence, not conclusions.
+2. **Merge overlaps.** When several investigators cite the same PR, ticket, or doc, give it one authoritative reference.
+3. **Surface contradictions.** When two items disagree, show both. Don't pick one.
+4. **Calibrate each claim.** Find its evidence and tier. Direct: cite it and state it plainly. Inferred: hedge it and show the inference. Speculative: mark it. No evidence: put it in the gaps.
+5. **Verify citations by spot-checking.** If you're uncertain a cited item exists or says what the investigator claims, check it by reading the codebase or calling MCP tools. Don't propagate errors. Do not write files, commit, or modify external state.
+6. **Don't overreach.** The user will act on this. Leave an open question open rather than fill it with a confident guess.
+
+## Output Format
+
+Write for the user, in this exact structure:
+
+---
+
+### The Question
+
+Restate the user's question in one or two sentences.
+
+### The Code in Question
+
+File paths, line ranges, key symbols. Two or three lines to orient a cold reader.
+
+### What We Found
+
+Claims with textual evidence, each quoted or paraphrased and cited precisely:
+
+- **[Direct]** {Claim}. Source: [PR #123](url) / ticket ID / file:line. {Brief quote or paraphrase.}
+- **[Supported]** {Claim}. Evidence: {list of items and what each contributes}.
+
+`[Direct]` is single-source, explicit evidence. `[Supported]` is multiple indirect items converging on a conclusion.
+
+### What We Can Reasonably Infer
+
+Claims stated nowhere but well-supported by indirect evidence. Each bullet must make the inference chain visible ("Given A and B, it's likely that C") and must use hedged language ("appears to", "likely", "suggests", "is consistent with"):
+
+- **[Inferred]** {Hedged claim}. Reasoning: {the specific evidence and the inference step}.
+
+Skip this section if there's nothing to infer.
+
+### Competing Hypotheses
+
+If the evidence fits multiple stories, present each. Don't force a winner the record doesn't support. For each hypothesis:
+
+- **Hypothesis:** {one-sentence statement}
+- **Evidence for:** {specific items}
+- **Evidence against or missing:** {what would need to be true but isn't, or what counter-signals exist}
+
+Skip this section if there's a single clear answer.
+
+### What We Don't Know
+
+Specific gaps: "We searched the issue tracker for [query1], [query2], [query3] and found no issue discussing the rate-limit threshold", not "We don't know why." Include:
+
+- Questions that went unanswered
+- Searches that returned nothing
+- Sources that were unavailable, and why (such as a missing real-time team chat MCP)
+- People who would likely know but whom you can't ask
+
+### Sources Consulted
+
+What was actually searched, so the user can judge coverage and redirect:
+
+- **Source control history**: {file paths}, {number of commits reviewed}, PRs #{numbers}, and code comments searched. Or "Not searched. This should not happen because git and `gh` are always expected."
+- **Issue / ticket tracker**: {ticket IDs and keyword searches}. Or "Not searched. No matching MCP available in this environment."
+- **Long-form documents**: {page titles and search queries}. Or "Not searched. No matching MCP available in this environment."
+- **Real-time team chat**: {channels searched, date ranges, queries}. Or "Not searched. No matching MCP available in this environment."
+- **Infrastructure observability**: {dashboards, monitors, metrics, logs, traces, or incidents searched}. Or "Not searched. No matching MCP available in this environment."
+- **Error / exception tracking**: {issues, events, or releases searched}. Or "Not searched. No matching MCP available in this environment."
+- **Product analytics warehouse**: {fully-qualified tables queried, the time windows, and the numeric summaries (counts, percentiles, first/last-seen timestamps) that bore on the question}. Or "Not searched. No matching MCP available in this environment."
+
+### Confidence Summary
+
+One or two sentences on overall confidence, e.g.:
+
+> "The core rationale (A) is well-supported by direct PR and ticket evidence. The specific threshold value (100) is inferred from the surrounding context but not explicitly documented. The question of whether this was driven by a customer request could not be answered. No relevant issue tracker or long-form doc content surfaced, and real-time team chat search was unavailable."
+
+---
+
+## Quality Check Before Returning
+
+Revise if any item fails:
+
+1. Does every claim in "What We Found" have a citation? If not, add one or move it to "Inferred" or "Hypotheses."
+2. Is the phrasing tier-appropriate? (Direct claims can use "because". Inferred claims cannot.)
+3. Did you surface every contradiction you noticed, or quietly pick one?
+4. Does "What We Don't Know" name specific gaps? If it's empty or missing, be suspicious. Historical investigations almost always have gaps.
+5. Did you check any hypothesis embedded in the question against the evidence rather than rubber-stamp it?
+6. Did you cite code as evidence for its own intent? Remove it. Code is mechanics, not motivation.
+7. Is the tone calibrated? A confident-sounding answer on weak evidence is the exact failure this skill exists to prevent.
+
+The value of this output is its honesty, not its authority. A reader who takes it to the original author, an engineering lead, or a product manager should know what's known, what's inferred, and what's missing, so they can ask the right follow-up questions. Optimize for being useful, not for looking decisive.

package/cordis.patch.yml

@@ -0,0 +1,39 @@
+# dsh-pstack bundle patch.
+#
+# `pstack` registers the bundled skill provider. `pstack-subagent` registers
+# `pstack_subagent`, which starts one child per activation and re-reads the role
+# file on every delegation. `pstack-history` registers `pstack_history`, the
+# restricted read-only history tool; it reads raw events through `sessionQuery`
+# and authorizes the caller and its direct children only.
+#
+# The two worktree rows carry the README promise that worktree support ships as a
+# necessary dependency: the bundle turns the official integration on when the
+# profile does not have it, and mounts nothing when it does. `disabled: !!js` is
+# evaluated by the Loader at every mount decision, and each expression reads the
+# composed row list rather than a startup snapshot. The row handle is
+# `ctx[Symbol.for('cordis.entry')]` (this entry), not `ctx.fiber.entry`, which
+# resolves to the enclosing `include` row and therefore never sees these siblings.
+# `scripts/worktree-mount.ts` owns the text of both expressions and `check:assets`
+# fails when this file drifts from it. See
+# docs/decisions/2026-10-26-worktree-guard-reads-own-entry.md.
+#
+# `pstack-history` is appended after the unit-4 rows so no delivered line moves.
+# Row order is not part of the history contract; the two worktree guards, by
+# contrast, stay adjacent and byte-identical to their generator.
+- insert:
+    - id: pstack
+      name: dsh-pstack
+    - id: pstack-subagent
+      name: dsh-pstack/subagent
+      config:
+        maxDepth: 2
+    - id: pstack-worktree
+      name: '@deepseek-ai/dsh-experimental-worktree'
+      disabled: !!js "(() => { const own = ctx[Symbol.for('cordis.entry')]; const rows = own && own.parent && own.parent.data; if (!Array.isArray(rows)) return false; return rows.some((row) => row !== null && typeof row === 'object' && row.id !== 'pstack-worktree' && row.name === '@deepseek-ai/dsh-experimental-worktree' && row.disabled !== true) })()"
+    - id: pstack-tool-worktree
+      name: '@deepseek-ai/dsh-experimental-tool-worktree'
+      disabled: !!js "(() => { const own = ctx[Symbol.for('cordis.entry')]; const rows = own && own.parent && own.parent.data; if (!Array.isArray(rows)) return false; return rows.some((row) => row !== null && typeof row === 'object' && row.id !== 'pstack-tool-worktree' && row.name === '@deepseek-ai/dsh-experimental-tool-worktree' && row.disabled !== true) })()"
+    - id: pstack-history
+      name: dsh-pstack/history
+    - id: pstack-script
+      name: dsh-pstack/script

package/dist/frontmatter-BQX3ekwP.mjs

@@ -0,0 +1,229 @@
+//#region src/frontmatter.ts
+const SKILL_CONSUMED_FIELDS = [
+	"name",
+	"description",
+	"disable-model-invocation",
+	"user-invocable",
+	"whenToUse"
+];
+const SKILL_DROPPED_FIELDS = [
+	"icon",
+	"color",
+	"paths"
+];
+const AGENT_CONSUMED_FIELDS = ["name", "description"];
+const AGENT_DROPPED_FIELDS = ["is_background"];
+const MAX_SKILL_NAME_LENGTH = 64;
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var FrontmatterError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "FrontmatterError";
+	}
+};
+function parseFrontmatter(source) {
+	const eol = detectEol(source);
+	const lines = (eol === "\r\n" ? source.replaceAll("\r\n", "\n") : source).split("\n");
+	if (lines[0] !== "---") throw new FrontmatterError("frontmatter: file must start with a \"---\" line");
+	const closing = lines.indexOf("---", 1);
+	if (closing === -1) throw new FrontmatterError("frontmatter: missing closing \"---\" delimiter");
+	const data = parseBlock(lines.slice(1, closing));
+	const body = lines.slice(closing + 1).join("\n");
+	return {
+		data,
+		body: eol === "\r\n" ? body.replaceAll("\n", eol) : body
+	};
+}
+function validateSkillFrontmatter(data, source) {
+	rejectUnknownFields(data, source, SKILL_CONSUMED_FIELDS, SKILL_DROPPED_FIELDS);
+	const name = readName(data, source);
+	const description = readDescription(data, source);
+	const whenToUse = data["whenToUse"];
+	if (whenToUse !== void 0 && whenToUse.trim() === "") throw new FrontmatterError(`${source}: "whenToUse" must not be empty`);
+	return {
+		name,
+		description,
+		disableModelInvocation: readBoolean(data, "disable-model-invocation", source, false),
+		userInvocable: readBoolean(data, "user-invocable", source, true),
+		...whenToUse === void 0 ? {} : { whenToUse }
+	};
+}
+function validateAgentFrontmatter(data, source) {
+	rejectUnknownFields(data, source, AGENT_CONSUMED_FIELDS, AGENT_DROPPED_FIELDS);
+	return {
+		name: readName(data, source),
+		description: readDescription(data, source)
+	};
+}
+function serializeSkillFrontmatter(data) {
+	const lines = [
+		"---",
+		`name: ${formatScalar(data.name)}`,
+		`description: ${formatScalar(data.description)}`
+	];
+	if (data.disableModelInvocation) lines.push("disable-model-invocation: true");
+	if (!data.userInvocable) lines.push("user-invocable: false");
+	if (data.whenToUse !== void 0) lines.push(`whenToUse: ${formatScalar(data.whenToUse)}`);
+	lines.push("---");
+	return `${lines.join("\n")}\n`;
+}
+function serializeAgentFrontmatter(data) {
+	return [
+		"---",
+		`name: ${formatScalar(data.name)}`,
+		`description: ${formatScalar(data.description)}`,
+		"---",
+		""
+	].join("\n");
+}
+function skillDroppedFields(data, source) {
+	return droppedFields(data, source, SKILL_DROPPED_FIELDS);
+}
+function agentDroppedFields(data, source) {
+	return droppedFields(data, source, AGENT_DROPPED_FIELDS);
+}
+function droppedFields(data, source, fields) {
+	return fields.flatMap((field) => {
+		const value = data[field];
+		return value === void 0 ? [] : [{
+			file: source,
+			field,
+			value
+		}];
+	});
+}
+function detectEol(source) {
+	if (!source.includes("\r\n")) return "\n";
+	const withoutCrlf = source.replaceAll("\r\n", "");
+	if (withoutCrlf.includes("\r") || withoutCrlf.includes("\n")) throw new FrontmatterError("frontmatter: mixed line endings are not supported");
+	return "\r\n";
+}
+function parseBlock(lines) {
+	const data = {};
+	for (let index = 0; index < lines.length; index += 1) {
+		const line = lines[index];
+		const trimmed = line.trim();
+		if (trimmed === "" || trimmed.startsWith("#")) continue;
+		if (trimmed !== line) throw new FrontmatterError(`frontmatter: unexpected indented line "${trimmed}"`);
+		const entry = /^([A-Za-z_][A-Za-z0-9_-]*):(.*)$/.exec(line);
+		if (entry === null) throw new FrontmatterError(`frontmatter: expected "key: value", got "${line}"`);
+		const key = entry[1];
+		const rest = entry[2];
+		if (rest !== "" && !rest.startsWith(" ")) throw new FrontmatterError(`frontmatter: missing space after "${key}:"`);
+		if (Object.hasOwn(data, key)) throw new FrontmatterError(`frontmatter: duplicate key "${key}"`);
+		const raw = rest.trim();
+		if (raw === ">" || raw === ">-" || raw === "|" || raw === "|-") {
+			const block = [];
+			let cursor = index + 1;
+			while (cursor < lines.length) {
+				const candidate = lines[cursor];
+				if (candidate.trim() !== "" && !candidate.startsWith(" ") && !candidate.startsWith("	")) break;
+				block.push(candidate);
+				cursor += 1;
+			}
+			while (block.length > 0 && block.at(-1).trim() === "") block.pop();
+			if (block.length === 0) throw new FrontmatterError(`frontmatter: "${key}" has an empty ${raw} block`);
+			data[key] = parseBlockScalar(block, raw, key);
+			index = cursor - 1;
+			continue;
+		}
+		data[key] = parseScalar(raw, key);
+	}
+	return data;
+}
+function parseScalar(raw, key) {
+	if (raw === "") return "";
+	if (raw.startsWith("\"")) return parseDoubleQuoted(raw, key);
+	if (raw.startsWith("'")) return parseSingleQuoted(raw, key);
+	return raw;
+}
+function parseDoubleQuoted(raw, key) {
+	if (raw.length < 2 || !raw.endsWith("\"")) throw new FrontmatterError(`frontmatter: unterminated double-quoted value for "${key}"`);
+	const inner = raw.slice(1, -1);
+	let value = "";
+	for (let index = 0; index < inner.length; index += 1) {
+		const character = inner[index];
+		if (character !== "\\") {
+			value += character;
+			continue;
+		}
+		const escaped = inner[index += 1];
+		if (escaped === "\"") value += "\"";
+		else if (escaped === "\\") value += "\\";
+		else if (escaped === "n") value += "\n";
+		else throw new FrontmatterError(`frontmatter: unsupported escape "\\${escaped ?? ""}" in "${key}"`);
+	}
+	return value;
+}
+function parseSingleQuoted(raw, key) {
+	if (raw.length < 2 || !raw.endsWith("'")) throw new FrontmatterError(`frontmatter: unterminated single-quoted value for "${key}"`);
+	const inner = raw.slice(1, -1);
+	let value = "";
+	for (let index = 0; index < inner.length; index += 1) {
+		const character = inner[index];
+		if (character !== "'") {
+			value += character;
+			continue;
+		}
+		if (inner[index + 1] === "'") {
+			value += "'";
+			index += 1;
+			continue;
+		}
+		throw new FrontmatterError(`frontmatter: unescaped single quote in "${key}"`);
+	}
+	return value;
+}
+function parseBlockScalar(lines, indicator, key) {
+	const indents = lines.filter((line) => line.trim() !== "").map((line) => /^\s*/.exec(line)[0].length);
+	const indent = Math.min(...indents);
+	const content = lines.map((line) => line.trim() === "" ? "" : line.slice(indent));
+	const text = indicator.startsWith("|") ? content.join("\n") : fold(content);
+	if (text.trim() === "") throw new FrontmatterError(`frontmatter: "${key}" block is empty`);
+	return indicator.endsWith("-") ? text : `${text}\n`;
+}
+function fold(lines) {
+	const paragraphs = [[]];
+	for (const line of lines) if (line === "") paragraphs.push([]);
+	else paragraphs.at(-1).push(line);
+	return paragraphs.map((paragraph) => paragraph.join(" ")).join("\n");
+}
+function rejectUnknownFields(data, source, consumed, dropped) {
+	const unknown = Object.keys(data).filter((key) => !consumed.includes(key) && !dropped.includes(key));
+	if (unknown.length > 0) throw new FrontmatterError(`${source}: unknown frontmatter field(s) ${unknown.join(", ")}`);
+}
+function readName(data, source) {
+	const value = data["name"];
+	if (value === void 0 || value.trim() === "") throw new FrontmatterError(`${source}: missing "name"`);
+	if (!SKILL_NAME_PATTERN.test(value)) throw new FrontmatterError(`${source}: "name" must be kebab-case, got "${value}"`);
+	if (value.length > 64) throw new FrontmatterError(`${source}: "name" is longer than 64 characters`);
+	return value;
+}
+function readDescription(data, source) {
+	const value = data["description"];
+	if (value === void 0 || value.trim() === "") throw new FrontmatterError(`${source}: missing "description"`);
+	return value;
+}
+function readBoolean(data, key, source, fallback) {
+	const value = data[key];
+	if (value === void 0) return fallback;
+	if (value === "true") return true;
+	if (value === "false") return false;
+	throw new FrontmatterError(`${source}: "${key}" must be true or false, got "${value}"`);
+}
+function formatScalar(value) {
+	return needsQuotes(value) ? `"${escapeDoubleQuoted(value)}"` : value;
+}
+function needsQuotes(value) {
+	if (value === "" || value.trim() !== value) return true;
+	if (/[\n\r\t]/.test(value)) return true;
+	if (/^[-?:,[\]{}#&*!|>'"%@`]/.test(value)) return true;
+	return /: | #|:$/.test(value);
+}
+function escapeDoubleQuoted(value) {
+	return value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"").replaceAll("\n", "\\n").replaceAll("\r", "\\r");
+}
+//#endregion
+export { SKILL_CONSUMED_FIELDS as a, parseFrontmatter as c, skillDroppedFields as d, validateAgentFrontmatter as f, MAX_SKILL_NAME_LENGTH as i, serializeAgentFrontmatter as l, AGENT_DROPPED_FIELDS as n, SKILL_DROPPED_FIELDS as o, validateSkillFrontmatter as p, FrontmatterError as r, agentDroppedFields as s, AGENT_CONSUMED_FIELDS as t, serializeSkillFrontmatter as u };
+
+//# sourceMappingURL=frontmatter-BQX3ekwP.mjs.map

package/dist/frontmatter-BQX3ekwP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-BQX3ekwP.mjs","names":[],"sources":["../src/frontmatter.ts"],"sourcesContent":["/**\n * Frontmatter parsing for pstack skills and agents.\n *\n * This is a deliberately small YAML subset, not YAML. It reads the shapes the\n * upstream files use: plain scalars, single and double quotes, folded (`>` and\n * `>-`) and literal (`|` and `|-`) blocks, comments, and blank lines. Nesting\n * and multi-document streams are rejected rather than half-supported.\n */\n\nexport interface Frontmatter {\n  readonly data: Readonly<Record<string, string>>;\n  readonly body: string;\n}\n\nexport interface SkillFrontmatter {\n  readonly name: string;\n  readonly description: string;\n  readonly disableModelInvocation: boolean;\n  readonly userInvocable: boolean;\n  readonly whenToUse?: string;\n}\n\nexport interface AgentFrontmatter {\n  readonly name: string;\n  readonly description: string;\n}\n\nexport interface DroppedFrontmatterField {\n  readonly file: string;\n  readonly field: string;\n  readonly value: string;\n}\n\nexport const SKILL_CONSUMED_FIELDS = [\n  \"name\",\n  \"description\",\n  \"disable-model-invocation\",\n  \"user-invocable\",\n  \"whenToUse\",\n] as const;\n\nexport const SKILL_DROPPED_FIELDS = [\"icon\", \"color\", \"paths\"] as const;\n\nexport const AGENT_CONSUMED_FIELDS = [\"name\", \"description\"] as const;\n\nexport const AGENT_DROPPED_FIELDS = [\"is_background\"] as const;\n\nexport const MAX_SKILL_NAME_LENGTH = 64;\n\nconst SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\nexport class FrontmatterError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"FrontmatterError\";\n  }\n}\n\nexport function parseFrontmatter(source: string): Frontmatter {\n  const eol = detectEol(source);\n  const text = eol === \"\\r\\n\" ? source.replaceAll(\"\\r\\n\", \"\\n\") : source;\n  const lines = text.split(\"\\n\");\n\n  if (lines[0] !== \"---\") {\n    throw new FrontmatterError('frontmatter: file must start with a \"---\" line');\n  }\n  const closing = lines.indexOf(\"---\", 1);\n  if (closing === -1) {\n    throw new FrontmatterError('frontmatter: missing closing \"---\" delimiter');\n  }\n\n  const data = parseBlock(lines.slice(1, closing));\n  const body = lines.slice(closing + 1).join(\"\\n\");\n  return { data, body: eol === \"\\r\\n\" ? body.replaceAll(\"\\n\", eol) : body };\n}\n\nexport function validateSkillFrontmatter(\n  data: Readonly<Record<string, string>>,\n  source: string,\n): SkillFrontmatter {\n  rejectUnknownFields(data, source, SKILL_CONSUMED_FIELDS, SKILL_DROPPED_FIELDS);\n\n  const name = readName(data, source);\n  const description = readDescription(data, source);\n  const whenToUse = data[\"whenToUse\"];\n  if (whenToUse !== undefined && whenToUse.trim() === \"\") {\n    throw new FrontmatterError(`${source}: \"whenToUse\" must not be empty`);\n  }\n\n  return {\n    name,\n    description,\n    disableModelInvocation: readBoolean(data, \"disable-model-invocation\", source, false),\n    userInvocable: readBoolean(data, \"user-invocable\", source, true),\n    ...(whenToUse === undefined ? {} : { whenToUse }),\n  };\n}\n\nexport function validateAgentFrontmatter(\n  data: Readonly<Record<string, string>>,\n  source: string,\n): AgentFrontmatter {\n  rejectUnknownFields(data, source, AGENT_CONSUMED_FIELDS, AGENT_DROPPED_FIELDS);\n  return { name: readName(data, source), description: readDescription(data, source) };\n}\n\nexport function serializeSkillFrontmatter(data: SkillFrontmatter): string {\n  const lines = [\n    \"---\",\n    `name: ${formatScalar(data.name)}`,\n    `description: ${formatScalar(data.description)}`,\n  ];\n  if (data.disableModelInvocation) lines.push(\"disable-model-invocation: true\");\n  if (!data.userInvocable) lines.push(\"user-invocable: false\");\n  if (data.whenToUse !== undefined) lines.push(`whenToUse: ${formatScalar(data.whenToUse)}`);\n  lines.push(\"---\");\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nexport function serializeAgentFrontmatter(data: AgentFrontmatter): string {\n  return [\n    \"---\",\n    `name: ${formatScalar(data.name)}`,\n    `description: ${formatScalar(data.description)}`,\n    \"---\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nexport function skillDroppedFields(\n  data: Readonly<Record<string, string>>,\n  source: string,\n): readonly DroppedFrontmatterField[] {\n  return droppedFields(data, source, SKILL_DROPPED_FIELDS);\n}\n\nexport function agentDroppedFields(\n  data: Readonly<Record<string, string>>,\n  source: string,\n): readonly DroppedFrontmatterField[] {\n  return droppedFields(data, source, AGENT_DROPPED_FIELDS);\n}\n\nfunction droppedFields(\n  data: Readonly<Record<string, string>>,\n  source: string,\n  fields: readonly string[],\n): readonly DroppedFrontmatterField[] {\n  return fields.flatMap((field) => {\n    const value = data[field];\n    return value === undefined ? [] : [{ file: source, field, value }];\n  });\n}\n\nfunction detectEol(source: string): \"\\n\" | \"\\r\\n\" {\n  if (!source.includes(\"\\r\\n\")) return \"\\n\";\n  const withoutCrlf = source.replaceAll(\"\\r\\n\", \"\");\n  if (withoutCrlf.includes(\"\\r\") || withoutCrlf.includes(\"\\n\")) {\n    throw new FrontmatterError(\"frontmatter: mixed line endings are not supported\");\n  }\n  return \"\\r\\n\";\n}\n\nfunction parseBlock(lines: readonly string[]): Record<string, string> {\n  const data: Record<string, string> = {};\n\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index] as string;\n    const trimmed = line.trim();\n    if (trimmed === \"\" || trimmed.startsWith(\"#\")) continue;\n    if (trimmed !== line) {\n      throw new FrontmatterError(`frontmatter: unexpected indented line \"${trimmed}\"`);\n    }\n\n    const entry = /^([A-Za-z_][A-Za-z0-9_-]*):(.*)$/.exec(line);\n    if (entry === null) {\n      throw new FrontmatterError(`frontmatter: expected \"key: value\", got \"${line}\"`);\n    }\n    const key = entry[1] as string;\n    const rest = entry[2] as string;\n    if (rest !== \"\" && !rest.startsWith(\" \")) {\n      throw new FrontmatterError(`frontmatter: missing space after \"${key}:\"`);\n    }\n    if (Object.hasOwn(data, key)) {\n      throw new FrontmatterError(`frontmatter: duplicate key \"${key}\"`);\n    }\n\n    const raw = rest.trim();\n    if (raw === \">\" || raw === \">-\" || raw === \"|\" || raw === \"|-\") {\n      const block: string[] = [];\n      let cursor = index + 1;\n      while (cursor < lines.length) {\n        const candidate = lines[cursor] as string;\n        if (candidate.trim() !== \"\" && !candidate.startsWith(\" \") && !candidate.startsWith(\"\\t\"))\n          break;\n        block.push(candidate);\n        cursor += 1;\n      }\n      while (block.length > 0 && (block.at(-1) as string).trim() === \"\") block.pop();\n      if (block.length === 0) {\n        throw new FrontmatterError(`frontmatter: \"${key}\" has an empty ${raw} block`);\n      }\n      data[key] = parseBlockScalar(block, raw, key);\n      index = cursor - 1;\n      continue;\n    }\n\n    data[key] = parseScalar(raw, key);\n  }\n\n  return data;\n}\n\nfunction parseScalar(raw: string, key: string): string {\n  if (raw === \"\") return \"\";\n  if (raw.startsWith('\"')) return parseDoubleQuoted(raw, key);\n  if (raw.startsWith(\"'\")) return parseSingleQuoted(raw, key);\n  return raw;\n}\n\nfunction parseDoubleQuoted(raw: string, key: string): string {\n  if (raw.length < 2 || !raw.endsWith('\"')) {\n    throw new FrontmatterError(`frontmatter: unterminated double-quoted value for \"${key}\"`);\n  }\n  const inner = raw.slice(1, -1);\n  let value = \"\";\n  for (let index = 0; index < inner.length; index += 1) {\n    const character = inner[index] as string;\n    if (character !== \"\\\\\") {\n      value += character;\n      continue;\n    }\n    const escaped = inner[(index += 1)];\n    if (escaped === '\"') value += '\"';\n    else if (escaped === \"\\\\\") value += \"\\\\\";\n    else if (escaped === \"n\") value += \"\\n\";\n    else\n      throw new FrontmatterError(\n        `frontmatter: unsupported escape \"\\\\${escaped ?? \"\"}\" in \"${key}\"`,\n      );\n  }\n  return value;\n}\n\nfunction parseSingleQuoted(raw: string, key: string): string {\n  if (raw.length < 2 || !raw.endsWith(\"'\")) {\n    throw new FrontmatterError(`frontmatter: unterminated single-quoted value for \"${key}\"`);\n  }\n  const inner = raw.slice(1, -1);\n  let value = \"\";\n  for (let index = 0; index < inner.length; index += 1) {\n    const character = inner[index] as string;\n    if (character !== \"'\") {\n      value += character;\n      continue;\n    }\n    if (inner[index + 1] === \"'\") {\n      value += \"'\";\n      index += 1;\n      continue;\n    }\n    throw new FrontmatterError(`frontmatter: unescaped single quote in \"${key}\"`);\n  }\n  return value;\n}\n\nfunction parseBlockScalar(lines: readonly string[], indicator: string, key: string): string {\n  const indents = lines\n    .filter((line) => line.trim() !== \"\")\n    .map((line) => (/^\\s*/.exec(line) as RegExpExecArray)[0].length);\n  const indent = Math.min(...indents);\n  const content = lines.map((line) => (line.trim() === \"\" ? \"\" : line.slice(indent)));\n\n  const text = indicator.startsWith(\"|\") ? content.join(\"\\n\") : fold(content);\n  if (text.trim() === \"\") {\n    throw new FrontmatterError(`frontmatter: \"${key}\" block is empty`);\n  }\n  return indicator.endsWith(\"-\") ? text : `${text}\\n`;\n}\n\nfunction fold(lines: readonly string[]): string {\n  const paragraphs: string[][] = [[]];\n  for (const line of lines) {\n    if (line === \"\") paragraphs.push([]);\n    else (paragraphs.at(-1) as string[]).push(line);\n  }\n  return paragraphs.map((paragraph) => paragraph.join(\" \")).join(\"\\n\");\n}\n\nfunction rejectUnknownFields(\n  data: Readonly<Record<string, string>>,\n  source: string,\n  consumed: readonly string[],\n  dropped: readonly string[],\n): void {\n  const unknown = Object.keys(data).filter(\n    (key) => !consumed.includes(key) && !dropped.includes(key),\n  );\n  if (unknown.length > 0) {\n    throw new FrontmatterError(`${source}: unknown frontmatter field(s) ${unknown.join(\", \")}`);\n  }\n}\n\nfunction readName(data: Readonly<Record<string, string>>, source: string): string {\n  const value = data[\"name\"];\n  if (value === undefined || value.trim() === \"\") {\n    throw new FrontmatterError(`${source}: missing \"name\"`);\n  }\n  if (!SKILL_NAME_PATTERN.test(value)) {\n    throw new FrontmatterError(`${source}: \"name\" must be kebab-case, got \"${value}\"`);\n  }\n  if (value.length > MAX_SKILL_NAME_LENGTH) {\n    throw new FrontmatterError(\n      `${source}: \"name\" is longer than ${MAX_SKILL_NAME_LENGTH} characters`,\n    );\n  }\n  return value;\n}\n\nfunction readDescription(data: Readonly<Record<string, string>>, source: string): string {\n  const value = data[\"description\"];\n  if (value === undefined || value.trim() === \"\") {\n    throw new FrontmatterError(`${source}: missing \"description\"`);\n  }\n  return value;\n}\n\nfunction readBoolean(\n  data: Readonly<Record<string, string>>,\n  key: string,\n  source: string,\n  fallback: boolean,\n): boolean {\n  const value = data[key];\n  if (value === undefined) return fallback;\n  if (value === \"true\") return true;\n  if (value === \"false\") return false;\n  throw new FrontmatterError(`${source}: \"${key}\" must be true or false, got \"${value}\"`);\n}\n\nfunction formatScalar(value: string): string {\n  return needsQuotes(value) ? `\"${escapeDoubleQuoted(value)}\"` : value;\n}\n\nfunction needsQuotes(value: string): boolean {\n  if (value === \"\" || value.trim() !== value) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (/^[-?:,[\\]{}#&*!|>'\"%@`]/.test(value)) return true;\n  return /: | #|:$/.test(value);\n}\n\nfunction escapeDoubleQuoted(value: string): string {\n  return value\n    .replaceAll(\"\\\\\", \"\\\\\\\\\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"\\n\", \"\\\\n\")\n    .replaceAll(\"\\r\", \"\\\\r\");\n}\n"],"mappings":"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"}