holycodex 0.5.2 → 0.6.1-dev.29547206710.2

package/plugin/runtime/mcp-stdio-core.js

@@ -1,209 +0,0 @@
-//#region packages/mcp-stdio-core/src/record.ts
-function isPlainRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-//#endregion
-//#region packages/mcp-stdio-core/src/responses.ts
-function successResponse(id, result) {
-	return {
-		jsonrpc: "2.0",
-		id,
-		result
-	};
-}
-function errorResponse(id, code, message, data) {
-	return {
-		jsonrpc: "2.0",
-		id,
-		error: data === void 0 ? {
-			code,
-			message
-		} : {
-			code,
-			message,
-			data
-		}
-	};
-}
-function jsonRpcId(value) {
-	return typeof value === "string" || typeof value === "number" || value === null ? value : null;
-}
-function messageFromError(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-//#endregion
-//#region packages/mcp-stdio-core/src/transport.ts
-var HEADER_SEPARATOR = Buffer.from("\r\n\r\n");
-async function* readStdioJsonRpcMessages(input) {
-	let buffer = Buffer.alloc(0);
-	for await (const chunk of input) {
-		buffer = Buffer.concat([buffer, bufferFromChunk(chunk)]);
-		while (true) {
-			const result = readNextMessage(buffer);
-			if (result.kind === "incomplete") break;
-			buffer = result.remaining;
-			if (result.message) yield result.message;
-		}
-	}
-	const trailing = buffer.toString("utf8").trim();
-	if (trailing.length > 0) yield parseJsonPayload(trailing, "line");
-}
-function writeStdioJsonRpcResponse(output, response, responseMode) {
-	const body = JSON.stringify(response);
-	if (responseMode === "framed") {
-		output.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
-		return;
-	}
-	output.write(`${body}\n`);
-}
-function readNextMessage(buffer) {
-	if (buffer.length === 0) return { kind: "incomplete" };
-	return startsWithContentLength(buffer) ? readFramedMessage(buffer) : readLineMessage(buffer);
-}
-function readLineMessage(buffer) {
-	const newlineIndex = buffer.indexOf(10);
-	if (newlineIndex === -1) return { kind: "incomplete" };
-	const line = buffer.subarray(0, newlineIndex).toString("utf8").replace(/\r$/, "");
-	if (line.trim().length === 0) return {
-		kind: "complete",
-		remaining: buffer.subarray(newlineIndex + 1)
-	};
-	return {
-		kind: "complete",
-		message: parseJsonPayload(line, "line"),
-		remaining: buffer.subarray(newlineIndex + 1)
-	};
-}
-function readFramedMessage(buffer) {
-	const separatorIndex = buffer.indexOf(HEADER_SEPARATOR);
-	if (separatorIndex === -1) return { kind: "incomplete" };
-	const contentLength = parseContentLength(buffer.subarray(0, separatorIndex).toString("ascii"));
-	const bodyStart = separatorIndex + HEADER_SEPARATOR.length;
-	if (contentLength === void 0) return {
-		kind: "complete",
-		message: {
-			kind: "parse_error",
-			message: "Missing or invalid Content-Length header",
-			responseMode: "framed"
-		},
-		remaining: buffer.subarray(bodyStart)
-	};
-	const bodyEnd = bodyStart + contentLength;
-	if (buffer.length < bodyEnd) return { kind: "incomplete" };
-	return {
-		kind: "complete",
-		message: parseJsonPayload(buffer.subarray(bodyStart, bodyEnd).toString("utf8"), "framed"),
-		remaining: buffer.subarray(bodyEnd)
-	};
-}
-function startsWithContentLength(buffer) {
-	return buffer.subarray(0, 15).toString("ascii").toLowerCase() === "content-length:";
-}
-function parseContentLength(headers) {
-	for (const line of headers.split("\r\n")) {
-		const match = /^content-length:\s*(\d+)$/i.exec(line);
-		if (match === null) continue;
-		const value = match[1];
-		if (value === void 0) return void 0;
-		return Number(value);
-	}
-}
-function parseJsonPayload(payload, responseMode) {
-	try {
-		return {
-			kind: "request",
-			payload: JSON.parse(payload),
-			responseMode
-		};
-	} catch (error) {
-		return {
-			kind: "parse_error",
-			message: error instanceof Error ? error.message : String(error),
-			responseMode
-		};
-	}
-}
-function bufferFromChunk(chunk) {
-	if (Buffer.isBuffer(chunk)) return chunk;
-	if (typeof chunk === "string") return Buffer.from(chunk);
-	throw new TypeError(`Unsupported stdio chunk type: ${typeof chunk}`);
-}
-//#endregion
-//#region packages/mcp-stdio-core/src/server.ts
-var DEFAULT_IDLE_TIMEOUT_MS = 10 * 6e4;
-var noopLog = () => {};
-async function runJsonRpcStdioServer(config) {
-	const log = config.log ?? noopLog;
-	const idleTimeoutMs = config.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
-	const idleTimer = createIdleTimer(idleTimeoutMs, log, config.onIdleTimeout);
-	log("stdio_started", {
-		cwd: process.cwd(),
-		idle_timeout_ms: idleTimeoutMs
-	});
-	idleTimer.arm();
-	try {
-		for await (const message of readStdioJsonRpcMessages(config.input)) {
-			if (idleTimer.closed()) break;
-			idleTimer.arm();
-			if (message.kind === "parse_error") {
-				handleParseError(message, config, log);
-				continue;
-			}
-			await handleRequest(message, config, log);
-		}
-	} finally {
-		idleTimer.clear();
-		log("stdio_stopped");
-	}
-}
-function handleParseError(message, config, log) {
-	log("parse_error", { message: message.message });
-	const response = config.parseErrorResponse?.(message.message) ?? errorResponse(null, -32700, "Parse error", message.message);
-	if (response !== void 0) writeStdioJsonRpcResponse(config.output, response, message.responseMode);
-}
-async function handleRequest(message, config, log) {
-	const parsed = message.payload;
-	const id = isPlainRecord(parsed) ? jsonRpcId(parsed["id"]) : null;
-	const method = isPlainRecord(parsed) && typeof parsed["method"] === "string" ? parsed["method"] : null;
-	log("request", {
-		id: id === null ? null : String(id),
-		method
-	});
-	try {
-		const response = await config.handler(parsed, config.handlerOptions);
-		if (response === void 0) return;
-		writeStdioJsonRpcResponse(config.output, response, message.responseMode);
-		log("response", {
-			id: String(response.id),
-			method,
-			is_error: response.error !== void 0
-		});
-	} catch (error) {
-		if (config.onHandlerError === void 0) throw error;
-		config.onHandlerError(error);
-	}
-}
-function createIdleTimer(idleTimeoutMs, log, onIdleTimeout) {
-	let timer = null;
-	let isClosed = false;
-	return {
-		arm: () => {
-			if (timer !== null) clearTimeout(timer);
-			if (idleTimeoutMs <= 0) return;
-			timer = setTimeout(() => {
-				isClosed = true;
-				log("idle_timeout", { idle_timeout_ms: idleTimeoutMs });
-				onIdleTimeout?.();
-			}, idleTimeoutMs);
-			timer.unref();
-		},
-		clear: () => {
-			if (timer === null) return;
-			clearTimeout(timer);
-			timer = null;
-		},
-		closed: () => isClosed
-	};
-}
-//#endregion
-export { successResponse as a, messageFromError as i, errorResponse as n, isPlainRecord as o, jsonRpcId as r, runJsonRpcStdioServer as t };

package/plugin/runtime/rules.js

@@ -1,171 +0,0 @@
-#!/usr/bin/env node
-import { t as CORE_INSTRUCTIONS } from "./core-instructions.js";
-import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
-import { stdin, stdout } from "node:process";
-import { tmpdir } from "node:os";
-import { createHash } from "node:crypto";
-//#region src/rules-hook.ts
-var DEFAULT_RULE_LIMIT = 8e3;
-var DEFAULT_RESULT_LIMIT = 24e3;
-var SOURCES = [
-	".holycodex/rules",
-	".codex/rules",
-	".github/instructions"
-];
-async function loadRules(cwd, targetPath) {
-	if (process.env.HOLYCODEX_RULES_DISABLED === "1") return [];
-	const candidates = [join(cwd, "CONTEXT.md"), join(cwd, ".github", "copilot-instructions.md")];
-	for (const source of SOURCES) candidates.push(...await markdownFiles(join(cwd, source)));
-	const rules = [];
-	const seen = /* @__PURE__ */ new Set();
-	let total = 0;
-	for (const path of candidates) {
-		const text = await readable(path);
-		if (text === void 0) continue;
-		const parsed = parseRule(text);
-		const staticSource = path.endsWith("CONTEXT.md") || path.endsWith("copilot-instructions.md");
-		if (!(targetPath === void 0 ? staticSource || parsed.alwaysApply : parsed.globs.some((glob) => globMatches(glob, relative(cwd, targetPath)))) || parsed.body.length === 0) continue;
-		const body = parsed.body.slice(0, numberFromEnv("HOLYCODEX_RULES_MAX_RULE_CHARS", DEFAULT_RULE_LIMIT));
-		const hash = createHash("sha256").update(body).digest("hex");
-		if (seen.has(hash)) continue;
-		if (total + body.length > numberFromEnv("HOLYCODEX_RULES_MAX_RESULT_CHARS", DEFAULT_RESULT_LIMIT)) break;
-		seen.add(hash);
-		total += body.length;
-		rules.push({
-			path,
-			body
-		});
-	}
-	return rules;
-}
-async function runRulesHook(input) {
-	if (typeof input.cwd !== "string" || typeof input.session_id !== "string") return "";
-	const event = input.hook_event_name;
-	const cache = cachePath(input.session_id);
-	if (event === "PostCompact") {
-		await rm(cache, { force: true });
-		return `${JSON.stringify({ hookSpecificOutput: {
-			hookEventName: event,
-			additionalContext: CORE_INSTRUCTIONS
-		} })}\n`;
-	}
-	const target = event === "PostToolUse" ? editPath(input.tool_input, input.cwd) : void 0;
-	if (event === "PostToolUse" && target === void 0) return "";
-	if (event !== "SessionStart" && event !== "UserPromptSubmit" && event !== "PostToolUse") return "";
-	const emitted = await filterCached(cache, await loadRules(input.cwd, target), typeof input.transcript_path === "string" ? await readable(input.transcript_path) ?? "" : "");
-	if (emitted.length === 0) return "";
-	const context = emitted.map((rule) => `Rule ${relative(input.cwd, rule.path)}:\n${rule.body}`).join("\n\n");
-	return `${JSON.stringify({ hookSpecificOutput: {
-		hookEventName: event,
-		additionalContext: context
-	} })}\n`;
-}
-function parseRule(text) {
-	if (!text.startsWith("---\n")) return {
-		alwaysApply: false,
-		globs: [],
-		body: text.trim()
-	};
-	const end = text.indexOf("\n---\n", 4);
-	if (end < 0) return {
-		alwaysApply: false,
-		globs: [],
-		body: text.trim()
-	};
-	const header = text.slice(4, end);
-	return {
-		alwaysApply: /^alwaysApply:\s*true\s*$/m.test(header),
-		globs: parseGlobs(header),
-		body: text.slice(end + 5).trim()
-	};
-}
-function parseGlobs(header) {
-	const lines = header.split("\n");
-	const index = lines.findIndex((line) => /^globs\s*:/.test(line));
-	if (index < 0) return [];
-	const value = lines[index]?.replace(/^globs\s*:\s*/, "").trim() ?? "";
-	if (value.length > 0) return (value.startsWith("[") && value.endsWith("]") ? value.slice(1, -1) : value).split(",").map(unquote).filter((glob) => glob.length > 0);
-	const globs = [];
-	for (const line of lines.slice(index + 1)) {
-		const item = /^\s+-\s*(.+?)\s*$/.exec(line)?.[1];
-		if (item === void 0) break;
-		const glob = unquote(item);
-		if (glob.length > 0) globs.push(glob);
-	}
-	return globs;
-}
-function unquote(value) {
-	const trimmed = value.trim();
-	return trimmed.length >= 2 && (trimmed.startsWith("\"") && trimmed.endsWith("\"") || trimmed.startsWith("'") && trimmed.endsWith("'")) ? trimmed.slice(1, -1) : trimmed;
-}
-function globMatches(glob, path) {
-	const normalized = path.replaceAll("\\", "/");
-	const pattern = glob.replaceAll("\\", "/").replace(/[.+^${}()|[\]\\]/g, "\\$&").replaceAll("**", "\0").replaceAll("*", "[^/]*").replaceAll("\0", ".*");
-	return new RegExp(`^${pattern}$`).test(normalized);
-}
-async function markdownFiles(root) {
-	try {
-		const entries = await readdir(root, { withFileTypes: true });
-		return (await Promise.all(entries.map(async (entry) => {
-			const path = join(root, entry.name);
-			return entry.isDirectory() ? markdownFiles(path) : entry.isFile() && entry.name.endsWith(".md") ? [path] : [];
-		}))).flat();
-	} catch (error) {
-		if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
-		throw error;
-	}
-}
-async function readable(path) {
-	try {
-		return await readFile(path, "utf8");
-	} catch (error) {
-		if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
-		throw error;
-	}
-}
-function editPath(value, cwd) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
-	const input = new Map(Object.entries(value));
-	for (const key of [
-		"filePath",
-		"file_path",
-		"path",
-		"targetPath",
-		"target_path"
-	]) {
-		const candidate = input.get(key);
-		if (typeof candidate === "string") return isAbsolute(candidate) ? candidate : resolve(cwd, candidate);
-	}
-	const patch = typeof input.get("patch") === "string" ? input.get("patch") : typeof input.get("input") === "string" ? input.get("input") : void 0;
-	const path = patch === void 0 ? void 0 : /^\*\*\* (?:Add|Update) File: (.+)$/m.exec(patch)?.[1]?.trim();
-	return path === void 0 ? void 0 : resolve(cwd, path);
-}
-async function filterCached(path, rules, transcript) {
-	const previous = new Set(JSON.parse(await readable(path) ?? "[]"));
-	const emitted = rules.filter((rule) => !previous.has(hashRule(rule)) && !transcript.includes(rule.body));
-	for (const rule of emitted) previous.add(hashRule(rule));
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, JSON.stringify([...previous]), "utf8");
-	return emitted;
-}
-function hashRule(rule) {
-	return createHash("sha256").update(rule.body).digest("hex");
-}
-function cachePath(session) {
-	return join(process.env.PLUGIN_DATA ?? join(tmpdir(), "holycodex-plugin-data"), "rules", `${session.replaceAll(/[^A-Za-z0-9._-]/g, "_")}.json`);
-}
-function numberFromEnv(name, fallback) {
-	const value = Number(process.env[name]);
-	return Number.isInteger(value) && value > 0 ? value : fallback;
-}
-//#endregion
-//#region src/rules-cli.ts
-var raw = "";
-stdin.setEncoding("utf8");
-for await (const chunk of stdin) raw += chunk;
-if (raw.trim()) {
-	const input = JSON.parse(raw);
-	if (typeof input === "object" && input !== null && !Array.isArray(input)) stdout.write(await runRulesHook(input));
-}
-//#endregion

package/plugin/skills/ast-grep/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Yeongyu Kim
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/plugin/skills/ast-grep/SKILL.md

@@ -1,20 +0,0 @@
----
-name: ast-grep
-description: Use when a task needs syntax-aware code search or a repeatable structural rewrite across AST-shaped matches; do not use for plain text search, one local edit, or symbol navigation. Produces reviewed deterministic matches or a codemod; unlike LSP it matches syntax, not symbol identity.
----
-
-# ast-grep
-
-Use `sg` for syntax shapes; use `rg` for text.
-
-## Flow
-
-1. Name language and exact syntax shape.
-2. Start search-only. Use smallest pattern with metavariables.
-3. Inspect match classes; constrain only as needed.
-4. Test rewrite on narrow path. Review diff.
-5. Apply deterministic rewrite. Run formatter, diagnostics, targeted tests.
-
-Simple search: `sg run -p '<pattern>' -l <language> <path>`. Use YAML for constraints, relations, or reusable codemods. Review matches before writes. Never regex-replace syntax-bearing code.
-
-Load only needed reference: `patterns.md`, `yaml-rules.md`, `recipes.md`, `pitfalls.md`, `sgconfig.md`, `cli.md`, or `install.md`.

package/plugin/skills/ast-grep/references/cli.md

@@ -1,3 +0,0 @@
-# CLI
-
-Search: `sg run -p '<pattern>' -l <language> <path>`. Structured rule: `sg scan -r rule.yml <path>`. Rewrite uses `--rewrite '<fix>'`; add interactive/update flag only after reviewing matches. Check installed syntax with `sg --help` because flags vary by version.

package/plugin/skills/ast-grep/references/install.md

@@ -1,3 +0,0 @@
-# Install
-
-First run `sg --version`. If absent and user authorized install, use project/package-manager convention or official ast-grep package. Confirm executable and version. Never silently download or mutate global environment.

package/plugin/skills/ast-grep/references/patterns.md

@@ -1,3 +0,0 @@
-# Patterns
-
-Use code-shaped pattern in target language. `$A` captures one node; `$$$ARGS` captures many; `$_` ignores one. Start concrete, then replace only variable parts. Quote pattern in shell. If syntax fragment cannot parse alone, use `context` plus `selector` in YAML. Verify matches before rewrite.

package/plugin/skills/ast-grep/references/pitfalls.md

@@ -1,3 +0,0 @@
-# Pitfalls
-
-Text that looks alike may have different AST. Pattern may overmatch nested nodes, comments may not be nodes, and shell may expand `$`. Quote patterns. Specify language. Avoid `$$$` unless arity truly irrelevant. Never write on first query. After rewrite inspect diff and rerun search for leftovers.

package/plugin/skills/ast-grep/references/recipes.md

@@ -1,9 +0,0 @@
-# Recipes
-
-- Call: `pattern: logger.debug($A)`.
-- Any arguments: `pattern: console.log($$$ARGS)`.
-- Empty catch: match `catch ($E) {}` with language-correct syntax.
-- Missing await: match call plus `not`/`inside` constraint excluding await expression.
-- Import migration: match full import/require form; preserve captured module/name in fix.
-
-For each recipe: search narrow path, inspect variants, add constraint, dry review, write, format, test.

package/plugin/skills/ast-grep/references/sgconfig.md

@@ -1,3 +0,0 @@
-# sgconfig
-
-Use `sgconfig.yml` only for reusable project rules. Declare `ruleDirs` and optional test directories using repository-relative paths. Do not add config for one query. Run config-backed scan/test from repository root.

package/plugin/skills/ast-grep/references/yaml-rules.md

@@ -1,3 +0,0 @@
-# YAML rules
-
-Minimum rule: `id`, `language`, `rule`. Compose with `all`, `any`, `not`; relate with `inside`, `has`, `precedes`, `follows`; constrain captures with `constraints`. Add `fix` only after search result is exact. Keep one semantic purpose per rule. Test positive and negative fixtures with `sg test`.

package/plugin/skills/caveman/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Julius Brussee
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/plugin/skills/caveman/SKILL.md

@@ -1,31 +0,0 @@
----
-name: caveman
-description: Use when the user requests caveman mode, terse replies, fewer tokens, or `/caveman`, or when HolyCodex prompt and instruction edits require dense wording; do not remove required detail or silently change ordinary prose tone. Produces constraint-preserving lite, full, ultra, or Wenyan text; unlike compress it controls ongoing voice.
----
-
-# Caveman
-
-Write terse. Keep all technical meaning; remove filler.
-
-Active every reply until user says `stop caveman` or `normal mode`. Default `full`; switch with `/caveman lite|full|ultra` or Wenyan equivalent.
-
-## Rules
-
-- Match user's language.
-- Preserve exact technical terms, code, APIs, commands, paths, error text, and commit keywords unless translation requested.
-- Remove articles when clear, filler, pleasantries, hedging, repetition, and decorative formatting. Fragments allowed.
-- Use short familiar words. Keep standard acronyms; invent none. No causal arrows.
-- No self-reference, style announcement, tool narration, or duplicate normal-language recap.
-- Quote only decisive error lines unless more requested.
-- Code, commits, and PR text stay grammatical.
-
-Pattern: `[thing] [action] [reason]. [next step].`
-
-## Levels
-
-- `lite`: grammatical sentences; no filler or hedging.
-- `full`: drop clear articles; fragments and short words allowed.
-- `ultra`: state each fact once; remove safe conjunctions; never shorten technical text.
-- `wenyan-lite|full|ultra`: same levels in semi-classical to fully classical Chinese.
-
-Use full grammar for security warnings, irreversible confirmations, ordered steps, ambiguity, or clarification. Resume terse style afterward.

package/plugin/skills/compress/SKILL.md

@@ -1,18 +0,0 @@
----
-name: compress
-description: Use when a task needs text, prompts, or instructions shortened without losing meaning or constraints; do not use for lossy summaries, code refactors, or ongoing voice changes. Produces a denser constraint-equivalent version; unlike caveman it preserves source tone unless asked otherwise.
----
-
-# Compress
-
-1. Identify purpose, audience, format, facts, exact strings, constraints, gates, warnings, links, and tone.
-2. Remove repetition, filler, redundant headings, obvious explanation, decorative wording, and weak transitions.
-3. Merge related rules. Use direct verbs, familiar words, compact lists, and one statement per fact.
-4. Preserve names, code, commands, paths, APIs, errors, numbers, citations, legal terms, user terminology, and order where it matters.
-5. Compare result with source: no lost rule, changed meaning, weaker prohibition, invented claim, broken reference, or scope change.
-
-Keep grammar when terseness risks ambiguity, especially for safety, irreversible actions, legal or medical text, and ordered work. Do not adopt caveman voice unless requested.
-
-For skills and prompts, preserve frontmatter, triggers, tool and resource routing, permissions, stop conditions, and validation. For code or config, change prose only unless refactoring was requested. Keep evidence and nuance in prose; keep tables only when they improve scanning.
-
-Honor requested size or style; otherwise maximize safe reduction. Report size only when useful or requested.

package/plugin/skills/debugging/SKILL.md

@@ -1,22 +0,0 @@
----
-name: debugging
-description: Use when a task involves a crash, wrong result, hang, race, leak, slowdown, or other reproducible defect that needs root-cause proof; do not use for feature work, behavior-preserving refactors, or speculative cleanup. Produces reproduction, evidence, regression proof, and an authorized minimal fix; unlike programming it owns symptom-to-cause diagnosis.
----
-
-# Debugging
-
-No guess-fix loop.
-
-1. Reproduce exact symptom with smallest command.
-2. Minimize input, environment, and path.
-3. List three plausible cross-layer causes; rank by evidence and cheapest falsifier.
-4. Instrument narrow boundary. Capture values, ordering, ownership, timing, process state.
-5. Disprove causes. Change angle after two failed rounds; add no reviewer or oracle agent.
-6. Confirm root cause with evidence that predicts symptom.
-7. Add failing public-behavior regression test.
-8. Make minimum root fix.
-9. Run targeted test, then proportional suite. Remove temporary instrumentation.
-
-No sleeps for async proof; use deterministic events, clocks, traces, debuggers, profilers, sanitizers, or fixtures. Do not implement before proving cause unless user requests mitigation.
-
-Load only relevant runtime/tool reference under `references/`. Report reproduction, hypotheses rejected, root cause, proof, fix, checks, residual uncertainty.

package/plugin/skills/debugging/references/runtimes/README.md

@@ -1,9 +0,0 @@
-# Runtime probes
-
-- Node/Bun: reproduce with exact runtime/version; enable source maps and warnings; inspect event ordering, handles, promises, memory snapshots, CPU profile. Distinguish module resolution, transpilation, runtime, and external process.
-- Python: use traceback with causes, `faulthandler`, debugger, allocation/profile tools. Check interpreter/env, import path, sync blocking in async loop, resource ownership.
-- Rust/native: debug symbols; backtrace, debugger, sanitizer, Miri, profiler as symptom requires. Check UB, ownership, ABI, signal/thread ordering.
-- Go: race detector, pprof, trace, goroutine dump. Check cancellation, channel ownership, leaked goroutines, copied synchronization.
-- Bundled JS binary: reproduce source and bundle separately; verify target/runtime/externalization and source map. Inspect generated boundary, not minified noise first.
-
-Capture smallest evidence that separates hypotheses. Remove probe after proof.

package/plugin/skills/debugging/references/tools/README.md

@@ -1,8 +0,0 @@
-# Tool choice
-
-- Playwright: deterministic browser flow, console/network/DOM/screenshot evidence.
-- GDB/pwndbg: native crash, registers, stack, memory, heap; local authorized target only.
-- Ghidra: static binary control/data flow when source absent; pair claims with runtime proof when possible.
-- pwntools: local protocol/process PoC with bounded input and timeout; never destructive or third-party.
-
-Use least invasive tool that falsifies a hypothesis. Record exact command/version and preserve a safe reproducer.