claude-plugin-dsh 0.0.0-stage → 0.1.0

package/dist/src/plugin-files.js

@@ -0,0 +1,198 @@
+// Reading a Claude Code plugin tree: manifest, skills, commands, agents, hooks.json,
+// and the text transforms applied to what is read.
+import { readdirSync, readFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+export const DEFAULT_HOOK_TIMEOUT_S = 60;
+/** Split YAML-ish front matter from a markdown file. Only flat `key: value` lines are read. */
+export function parseFrontMatter(text) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
+    if (!match)
+        return { meta: {}, body: text };
+    const meta = {};
+    for (const line of (match[1] ?? '').split(/\r?\n/)) {
+        const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        if (!kv || kv[1] === undefined || kv[2] === undefined)
+            continue;
+        const raw = kv[2].trim();
+        let value = raw;
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+            if (raw.startsWith('"'))
+                value = value.replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+        }
+        meta[kv[1]] = value;
+    }
+    return { meta, body: text.slice(match[0].length) };
+}
+// A marker counts only on a line of its own, optionally after heading hashes (`## <!--/harness-->`).
+const CLAUDE_ONLY_OPEN = /^\s*(?:#+\s*)?<!--\s*harness:claude-only\s*-->\s*$/;
+const CLAUDE_ONLY_CLOSE = /^\s*(?:#+\s*)?<!--\s*\/harness\s*-->\s*$/;
+/**
+ * Remove `<!--harness:claude-only--> ... <!--/harness-->` blocks.
+ * An opener without a closer drops the rest of the file, so Claude-only text never leaks.
+ */
+export function stripClaudeOnlyBlocks(text) {
+    const out = [];
+    let inside = false;
+    for (const line of text.split(/(?<=\n)/)) {
+        const bare = line.replace(/\r?\n$/, '');
+        if (!inside && CLAUDE_ONLY_OPEN.test(bare))
+            inside = true;
+        else if (inside && CLAUDE_ONLY_CLOSE.test(bare))
+            inside = false;
+        else if (!inside)
+            out.push(line);
+    }
+    return { text: out.join(''), unterminated: inside };
+}
+export const stripClaudeOnly = (text) => stripClaudeOnlyBlocks(text).text;
+/** Keep hook text from closing the tag it is wrapped in. */
+export const escapeClosingTag = (text, tag) => String(text).replaceAll(`</${tag}`, `<\\/${tag}`);
+/** Replace the Claude plugin root variables with the real plugin directory. */
+export function expandPluginRoot(text, root) {
+    return text.replaceAll('${CLAUDE_PLUGIN_ROOT}', root).replaceAll('$CLAUDE_PLUGIN_ROOT', root);
+}
+export const kebab = (value) => String(value)
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+export function readText(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function listDir(path) {
+    try {
+        return readdirSync(path, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/** Read the plugin manifest; the plugin name falls back to the directory name. */
+export function readManifest(root) {
+    const raw = readText(join(root, '.claude-plugin', 'plugin.json'));
+    const manifest = (raw ? JSON.parse(raw) : {});
+    return { ...manifest, name: manifest.name || basename(root) };
+}
+/** Skill directories: `skills/<name>/SKILL.md`. */
+export function discoverSkills(root, options = {}) {
+    const dir = join(root, 'skills');
+    const skip = new Set(options.exclude ?? []);
+    const out = [];
+    for (const entry of listDir(dir)) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        if (skip.has(entry.name))
+            continue;
+        const path = join(dir, entry.name, 'SKILL.md');
+        const text = readText(path);
+        if (text === undefined)
+            continue;
+        const { meta } = parseFrontMatter(text);
+        const bare = kebab(meta.name || entry.name);
+        if (!bare || !meta.description)
+            continue;
+        const name = options.prefix ? `${options.prefix}-${bare}` : bare;
+        out.push({ name, description: meta.description, path, base: dirname(path), meta });
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Command files: `commands/<name>.md`. */
+export function discoverCommands(root, options = {}) {
+    const dir = join(root, 'commands');
+    const skip = new Set(options.exclude ?? []);
+    const out = [];
+    for (const entry of listDir(dir)) {
+        if (!entry.name.endsWith('.md'))
+            continue;
+        const stem = entry.name.slice(0, -3);
+        if (skip.has(stem))
+            continue;
+        const path = join(dir, entry.name);
+        const text = readText(path);
+        if (text === undefined)
+            continue;
+        const { meta, body } = parseFrontMatter(text);
+        out.push({ stem, name: kebab(meta.name || stem), description: meta.description || stem, hint: meta['argument-hint'] || '', body, path });
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Agent definitions: `agents/<name>.md` plus any extra directories the bundle lists. */
+export function discoverAgents(root, options = {}) {
+    const dirs = [join(root, 'agents'), ...(options.extraDirs ?? []).map((d) => resolve(root, d))];
+    const skip = new Set(options.exclude ?? []);
+    const out = [];
+    const seen = new Set();
+    for (const dir of dirs) {
+        for (const entry of listDir(dir)) {
+            if (!entry.name.endsWith('.md'))
+                continue;
+            const path = join(dir, entry.name);
+            const text = readText(path);
+            if (text === undefined)
+                continue;
+            const { meta, body } = parseFrontMatter(text);
+            const name = kebab(meta.name || entry.name.slice(0, -3));
+            if (skip.has(name) || seen.has(name) || !meta.description)
+                continue;
+            seen.add(name);
+            out.push({ name, description: meta.description, tools: meta.tools || '', model: meta.model || '', body, path });
+        }
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** hooks/hooks.json command hooks, flattened. Function-hook `modules` are Claude-only and skipped. */
+export function readHooks(root) {
+    const raw = readText(join(root, 'hooks', 'hooks.json'));
+    if (!raw)
+        return [];
+    const hooks = JSON.parse(raw).hooks ?? {};
+    const out = [];
+    for (const [event, groups] of Object.entries(hooks)) {
+        for (const group of groups ?? []) {
+            for (const hook of group.hooks ?? []) {
+                if (hook.type !== 'command' || !hook.command)
+                    continue;
+                const spec = { event, matcher: group.matcher ?? '', command: hook.command, timeout: hook.timeout ?? DEFAULT_HOOK_TIMEOUT_S };
+                if (hook.args !== undefined) {
+                    // Running a malformed exec hook through a shell would quietly run something else.
+                    if (!Array.isArray(hook.args) || !hook.args.every((arg) => typeof arg === 'string'))
+                        throw new Error(`hooks.json: ${event} hook "${hook.command}" has args that are not a list of strings`);
+                    spec.args = hook.args;
+                }
+                if (hook.onFailure === 'block' || hook.onFailure === 'continue')
+                    spec.onFailure = hook.onFailure;
+                out.push(spec);
+            }
+        }
+    }
+    return out;
+}
+/** A Claude Code matcher: empty or `*` matches all, otherwise an anchored regex (`Bash`, `Skill|Agent|Task`). */
+export function matcherMatches(matcher, toolName) {
+    if (!matcher || matcher === '*')
+        return true;
+    try {
+        return new RegExp(`^(?:${matcher})$`).test(toolName);
+    }
+    catch {
+        return matcher === toolName;
+    }
+}
+/** Expand `$ARGUMENTS`, `$1..$9` and `${CLAUDE_PLUGIN_ROOT}` in a command body. */
+export function renderCommand(body, rawInput, root) {
+    const args = rawInput.trim();
+    const positional = args ? args.split(/\s+/) : [];
+    let text = expandPluginRoot(body, root);
+    const usesArgs = /\$ARGUMENTS|\$[1-9]/.test(text);
+    // One pass with a function: user text is never re-scanned or read as a replacement pattern.
+    text = text.replace(/\$(ARGUMENTS|[1-9])/g, (_, key) => (key === 'ARGUMENTS' ? args : (positional[Number(key) - 1] ?? '')));
+    if (!usesArgs && args)
+        text += `\n\nArguments: ${args}`;
+    return text;
+}
+//# sourceMappingURL=plugin-files.js.map

package/dist/src/plugin-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-files.js","sourceRoot":"","sources":["../../src/plugin-files.ts"],"names":[],"mappings":"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"}

package/dist/src/plugin.d.ts

@@ -0,0 +1,35 @@
+import { type AgentOptions, type CommandOptions, type SkillOptions } from './plugin-files.js';
+export declare const COMPAT_VERSION = "0.1.0";
+export declare const SKILL_RANK = 450;
+export type Part = 'skills' | 'commands' | 'agents' | 'instructions' | 'hooks';
+export interface PluginSpec {
+    /** Plugin root, the directory holding `.claude-plugin/`. */
+    root: string;
+    /** Root-relative files put into the system prompt, claude-only blocks removed. */
+    instructions?: string[];
+    skills?: SkillOptions;
+    commands?: CommandOptions;
+    agents?: AgentOptions;
+    /** Limit which Claude hook events run; default all. */
+    hooks?: {
+        events?: string[];
+    };
+    /** Extra environment for hooks; values may use `${CLAUDE_PLUGIN_ROOT}`. */
+    env?: Record<string, string>;
+    /** Parts that stay off unless the row config sets `disable`. */
+    disableByDefault?: Part[];
+}
+export interface RowConfig {
+    /** Parts to turn off for this row; replaces `disableByDefault`. */
+    disable?: Part[];
+}
+export interface DshPlugin {
+    name: string;
+    /** Accept the host context without pinning DSH's version-specific branded types. */
+    apply(ctx: object, config?: RowConfig): void;
+}
+/** Build a Cordis plugin for one Claude Code plugin directory. */
+export declare function createPlugin(spec: PluginSpec): DshPlugin;
+/** The plugin root is the parent of the `dsh/` directory holding the caller. */
+export declare function rootFrom(importMetaUrl: string): string;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,EAcL,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B,eAAO,MAAM,cAAc,UAAU,CAAA;AACrC,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,CAAA;AAE9E,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,uDAAuD;IACvD,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC7B,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,oFAAoF;IACpF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAC7C;AAUD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAuZxD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAItD"}