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

package/dist/index.d.mts

@@ -0,0 +1,278 @@
+//#region src/provider.d.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.
+ */
+export declare const BUNDLED_SKILL_RANK = 600;
+/** Default provider name used when the row does not override it. */
+export declare const DEFAULT_PROVIDER_NAME = "pstack";
+/** Origin bucket for a skill contribution. */
+type SkillSource = "project-dsh" | "project-agents" | "runtime" | "user-dsh" | "user-agents" | "custom" | "bundled" | (string & {});
+/** Optional provider-specific base used by loaded skill bodies to resolve relative resources. */
+type SkillResourceBase = {
+  readonly kind: "directory";
+  readonly path: string;
+} | {
+  readonly kind: "url";
+  readonly url: string;
+} | {
+  readonly kind: "opaque";
+  readonly description: string;
+};
+/** Invocation controls shared by skill discovery consumers. */
+interface SkillInvocationPolicy {
+  /** Whether model-facing catalogs and loaders include this skill. */
+  readonly modelInvocable: boolean;
+  /** Whether human-facing command catalogs and loaders include this skill. */
+  readonly userInvocable: boolean;
+}
+/** Invocation-neutral skill metadata returned by `ctx.skills.list()`. */
+interface SkillSummary {
+  /** Absolute instruction file path. */
+  readonly path?: string;
+  /** Kebab-case identifier used to address the skill. */
+  readonly name: string;
+  /** Short routing description shown by discovery consumers. */
+  readonly description: string;
+  /** Optional extra routing guidance. */
+  readonly whenToUse?: string;
+  /** Resolved model and user invocation controls. */
+  readonly invocation: SkillInvocationPolicy;
+  /** Discovery source that produced this skill. */
+  readonly source: SkillSource;
+  /** Provider that owns this skill body. */
+  readonly provider: string;
+  /** Provider-specific base for relative resources. */
+  readonly resourceBase?: SkillResourceBase;
+}
+/** Provider catalog entry used by the registry to merge and later load skills. */
+interface SkillCandidate extends SkillSummary {
+  /** Lower ranks win duplicate skill names. */
+  readonly rank: number;
+  /** Opaque provider-owned handle passed back to `provider.get()`. */
+  readonly locator: unknown;
+  /** Parsed optional metadata object from provider-specific skill frontmatter. */
+  readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Complete parsed skill definition, including the body loaded by `ctx.skills.get()`. */
+interface SkillDefinition extends SkillSummary {
+  /** Markdown instruction body after frontmatter removal. */
+  readonly content: string;
+  /** Parsed optional metadata object from frontmatter. */
+  readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Caller context used for cwd-sensitive and abortable provider work. */
+interface SkillLookupOptions {
+  /** Workspace selector for the current lookup. */
+  readonly cwd?: string | undefined;
+  /** Abort discovery or loading work for the current caller. */
+  readonly signal?: AbortSignal | undefined;
+}
+/** Registration-scoped lifecycle capability handed to a provider factory. */
+interface SkillProviderControl {
+  /** Aborts when registration fails or the exact provider registration is disposed. */
+  readonly signal: AbortSignal;
+  /** Invalidate completed catalogs and notify consumers. */
+  readonly invalidate: () => void;
+}
+/** Provider interface for one source of skills. */
+interface SkillProvider {
+  /** Unique provider name in the `ctx.skills` registry. */
+  readonly name: string;
+  /** List available skill candidates for the current lookup context. */
+  readonly list: (options: SkillLookupOptions) => Promise<readonly SkillCandidate[]>;
+  /** Load a complete skill body for a previously listed candidate. */
+  readonly get: (candidate: SkillCandidate, options: SkillLookupOptions) => Promise<SkillDefinition | undefined>;
+}
+/** One validated on-disk bundled skill. */
+interface BundledSkill {
+  readonly name: string;
+  readonly description: string;
+  readonly whenToUse?: string;
+  readonly invocation: SkillInvocationPolicy;
+  /** Absolute skill directory; the candidate resource base. */
+  readonly directory: string;
+  /** Absolute `SKILL.md` path. */
+  readonly instructionFile: string;
+}
+/** Validated skills keyed by their absolute directory. */
+type BundledSkillIndex = ReadonlyMap<string, BundledSkill>;
+/** Raised when a bundled asset violates the provider contract. */
+export declare class BundledSkillError extends Error {
+  constructor(message: string);
+}
+/**
+ * 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.
+ */
+export declare function loadBundledSkillIndex(skillsRoot: string): BundledSkillIndex;
+/**
+ * Build the provider over an already validated index.
+ *
+ * @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.
+ */
+export declare function createPstackSkillProvider(index: BundledSkillIndex, providerName?: string): SkillProvider;
+/**
+ * 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.
+ */
+export declare function createPstackSkillProviderFromRoot(skillsRoot: string, providerName?: string): SkillProvider;
+//#endregion
+//#region src/paths.d.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. */
+export declare const PACKAGE_ROOT: string;
+/** Absolute path of the generated, committed assets directory. */
+export declare const ASSETS_ROOT: string;
+/** Absolute path of the directory holding the 55 bundled skill directories. */
+export declare const SKILLS_ROOT: string;
+/** Absolute path of the generated harness mapping document. */
+export declare const HARNESS_DOC_PATH: string;
+//#endregion
+//#region src/frontmatter.d.ts
+/**
+ * Frontmatter parsing for pstack skills and agents.
+ *
+ * This is a deliberately small YAML subset, not YAML. It reads the shapes the
+ * upstream files use: plain scalars, single and double quotes, folded (`>` and
+ * `>-`) and literal (`|` and `|-`) blocks, comments, and blank lines. Nesting
+ * and multi-document streams are rejected rather than half-supported.
+ */
+export interface Frontmatter {
+  readonly data: Readonly<Record<string, string>>;
+  readonly body: string;
+}
+export interface SkillFrontmatter {
+  readonly name: string;
+  readonly description: string;
+  readonly disableModelInvocation: boolean;
+  readonly userInvocable: boolean;
+  readonly whenToUse?: string;
+}
+export interface AgentFrontmatter {
+  readonly name: string;
+  readonly description: string;
+}
+export interface DroppedFrontmatterField {
+  readonly file: string;
+  readonly field: string;
+  readonly value: string;
+}
+export declare const SKILL_CONSUMED_FIELDS: readonly ["name", "description", "disable-model-invocation", "user-invocable", "whenToUse"];
+export declare const SKILL_DROPPED_FIELDS: readonly ["icon", "color", "paths"];
+export declare const AGENT_CONSUMED_FIELDS: readonly ["name", "description"];
+export declare const AGENT_DROPPED_FIELDS: readonly ["is_background"];
+export declare const MAX_SKILL_NAME_LENGTH = 64;
+export declare class FrontmatterError extends Error {
+  constructor(message: string);
+}
+export declare function parseFrontmatter(source: string): Frontmatter;
+export declare function validateSkillFrontmatter(data: Readonly<Record<string, string>>, source: string): SkillFrontmatter;
+export declare function validateAgentFrontmatter(data: Readonly<Record<string, string>>, source: string): AgentFrontmatter;
+export declare function serializeSkillFrontmatter(data: SkillFrontmatter): string;
+export declare function serializeAgentFrontmatter(data: AgentFrontmatter): string;
+export declare function skillDroppedFields(data: Readonly<Record<string, string>>, source: string): readonly DroppedFrontmatterField[];
+export declare function agentDroppedFields(data: Readonly<Record<string, string>>, source: string): readonly DroppedFrontmatterField[];
+//#endregion
+//#region src/index.d.ts
+/** Plugin name used by Loader diagnostics for this row. */
+export declare const name = "pstack";
+/** The provider needs the skill registry and nothing else. */
+export declare const inject: string[];
+/** Row configuration. Every field is optional; an omitted `config` is valid. */
+export interface PstackConfig {
+  /** Registry name for the provider; change it when two rows must coexist. */
+  readonly providerName?: string;
+}
+interface StandardSchemaIssue {
+  readonly message: string;
+  readonly path?: readonly (string | number)[];
+}
+type StandardSchemaResult = {
+  readonly value: PstackConfig;
+  readonly issues?: undefined;
+} | {
+  readonly issues: readonly StandardSchemaIssue[];
+};
+/**
+ * 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.
+ */
+export declare const Config: {
+  "~standard": {
+    version: number;
+    vendor: string;
+    validate(value: unknown): StandardSchemaResult;
+  };
+};
+/** The slice of the Cordis context this plugin requires. */
+export interface PstackSkillHost {
+  readonly skills: {
+    registerProvider(create: (control: SkillProviderControl) => SkillProvider): () => void;
+  };
+}
+/**
+ * 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.
+ */
+export declare function apply(ctx: PstackSkillHost, config?: PstackConfig): void;
+//#endregion
+export type { BundledSkill, BundledSkillIndex, SkillCandidate, SkillDefinition, SkillInvocationPolicy, SkillLookupOptions, SkillProvider, SkillProviderControl, SkillResourceBase, SkillSource, SkillSummary };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,272 @@
+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";
+//#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";
+	}
+};
+/**
+* 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)}`);
+	}
+	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
+		});
+	}
+	if (index.size === 0) throw new BundledSkillError(`bundled skills: no skill directories under "${skillsRoot}"`);
+	return index;
+}
+/**
+* Build the provider over an already validated index.
+*
+* @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.
+*/
+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
+			};
+		}
+	};
+}
+/**
+* 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 createPstackSkillProviderFromRoot(skillsRoot, providerName = DEFAULT_PROVIDER_NAME) {
+	return createPstackSkillProvider(loadBundledSkillIndex(skillsRoot), providerName);
+}
+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: "bundled-skill",
+		directory: candidate.directory,
+		instructionFile: candidate.instructionFile
+	};
+}
+function readSkillFile(instructionFile) {
+	try {
+		return readFileSync(instructionFile, "utf8");
+	} catch (error) {
+		throw new BundledSkillError(`bundled skills: cannot read "${instructionFile}": ${messageOf(error)}`);
+	}
+}
+/** 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"];
+/**
+* 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 providerName = config.providerName ?? "pstack";
+	const index = loadBundledSkillIndex(SKILLS_ROOT);
+	ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, providerName));
+}
+//#endregion
+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

@@ -0,0 +1 @@
+{"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":"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"}

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"}