@evalops/maestro 0.10.51 → 0.10.53

package/dist/skills/learned-guidelines.js

@@ -1,291 +0,0 @@
-/**
- * Learned guidelines for skills
- *
- * A skill can accumulate durable, plain-text guidance across runs — for
- * example, incident-triage learning which tools and interfaces a given alert
- * type needs. Learnings are stored as markdown at
- * `<userSkillsDir>/<skill>/guidelines.md` (default `~/.maestro/skills`), so a
- * later run of the same skill can load what earlier runs discovered.
- *
- * The file is markdown, not settings, and every function takes the skills root
- * as a parameter (defaulting to the sanctioned PATHS.MAESTRO_HOME), so this
- * module reads no environment directly and writes atomically.
- */
-import { randomUUID } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, rmSync, statSync } from "node:fs";
-import { dirname, join, resolve, sep } from "node:path";
-import { PATHS } from "../config/constants.js";
-import { isProcessAlive } from "../tools/process-tree.js";
-import { writeTextFileAtomic } from "../utils/fs.js";
-const GUIDELINES_FILENAME = "guidelines.md";
-const SKILL_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-const GUIDELINES_LOCK_RETRY_MS = 25;
-const GUIDELINES_LOCK_STALE_MS = 30_000;
-const GUIDELINES_LOCK_TIMEOUT_MS = GUIDELINES_LOCK_STALE_MS + GUIDELINES_LOCK_RETRY_MS;
-const GUIDELINES_LOCK_OWNER_FILE = "owner.json";
-const MAX_GUIDELINES_BYTES = 64 * 1024;
-const GUIDELINE_ENTRY_SEPARATOR = "\n\n---\n\n";
-const GUIDELINE_ENTRY_MARKER = "<!-- maestro-learned-guideline-entry -->";
-const GUIDELINE_ENTRY_JSON_MARKER = "<!-- maestro-learned-guideline-entry-json -->";
-const GUIDELINE_TRUNCATION_NOTICE = "\n\n[learned guideline truncated to fit byte cap]";
-const SLEEP_BUFFER = new SharedArrayBuffer(4);
-const SLEEP_VIEW = new Int32Array(SLEEP_BUFFER);
-/** Default per-user skills root (`~/.maestro/skills`). */
-export function defaultUserSkillsDir() {
-    return join(PATHS.MAESTRO_HOME, "skills");
-}
-function validateSkillName(skillName) {
-    if (!SKILL_NAME_PATTERN.test(skillName)) {
-        throw new Error(`Invalid skill name for learned guidelines: ${skillName}`);
-    }
-    return skillName;
-}
-/** Absolute path to a skill's learned-guidelines file. */
-export function getLearnedGuidelinesPath(skillName, userSkillsDir = defaultUserSkillsDir()) {
-    return join(resolveSkillDirectory(skillName, userSkillsDir), GUIDELINES_FILENAME);
-}
-/**
- * Load a skill's learned guidelines, or null when none have been recorded.
- */
-export function loadLearnedGuidelines(skillName, userSkillsDir = defaultUserSkillsDir()) {
-    const content = formatGuidelineEntries(loadDisplayGuidelineEntries(skillName, userSkillsDir, MAX_GUIDELINES_BYTES));
-    return content.length > 0 ? content : null;
-}
-/**
- * Render a skill's learned guidelines as a prompt-ready block, or null when
- * there are none. Suitable for injection alongside the skill's own content.
- */
-export function formatLearnedGuidelinesForPrompt(skillName, userSkillsDir = defaultUserSkillsDir()) {
-    const promptPrefix = learnedGuidelinesPromptPrefix(skillName);
-    const content = formatGuidelineEntries(loadDisplayGuidelineEntries(skillName, userSkillsDir, MAX_GUIDELINES_BYTES - byteLength(promptPrefix)));
-    if (!content) {
-        return null;
-    }
-    return `${promptPrefix}${content}`;
-}
-/**
- * Append a learned-guideline entry to a skill's guidelines file, creating it on
- * first use. Entries are separated by a horizontal rule so the file stays a
- * readable, append-only log.
- */
-export function appendLearnedGuideline(skillName, entry, userSkillsDir = defaultUserSkillsDir()) {
-    const trimmed = entry.trim();
-    if (trimmed.length === 0) {
-        throw new Error("appendLearnedGuideline requires a non-empty entry");
-    }
-    const path = getLearnedGuidelinesPath(skillName, userSkillsDir);
-    return withLearnedGuidelinesLock(path, () => {
-        const existing = existsSync(path) ? readFileSync(path, "utf-8").trim() : "";
-        const next = buildGuidelinesContent(existing, trimmed);
-        if (next !== null) {
-            writeTextFileAtomic(path, next, { createDirs: true });
-        }
-        return path;
-    });
-}
-function buildGuidelinesContent(existing, entry) {
-    const entries = parseGuidelineEntries(existing);
-    if (byteLength(serializeGuidelineEntries([entry])) > MAX_GUIDELINES_BYTES) {
-        return null;
-    }
-    entries.push(entry);
-    return formatGuidelinesContent(pruneGuidelineEntries(entries));
-}
-function loadDisplayGuidelineEntries(skillName, userSkillsDir, maxBytes) {
-    const path = getLearnedGuidelinesPath(skillName, userSkillsDir);
-    if (!existsSync(path)) {
-        return [];
-    }
-    return fitGuidelineEntriesForDisplay(parseGuidelineEntries(readFileSync(path, "utf-8")), maxBytes);
-}
-function pruneGuidelineEntries(entries) {
-    while (entries.length > 0 &&
-        byteLength(serializeGuidelineEntries(entries)) > MAX_GUIDELINES_BYTES) {
-        entries.shift();
-    }
-    return entries;
-}
-function formatGuidelinesContent(entries) {
-    const content = serializeGuidelineEntries(entries);
-    return content.length > 0 ? `${content}\n` : "";
-}
-function formatGuidelineEntries(entries) {
-    return normalizeGuidelineEntries(entries).join(GUIDELINE_ENTRY_SEPARATOR);
-}
-function parseGuidelineEntries(content) {
-    const trimmed = content
-        .replace(/^\uFEFF/, "")
-        .replace(/\r\n?/g, "\n")
-        .trim();
-    if (trimmed.length === 0) {
-        return [];
-    }
-    if (trimmed.startsWith(GUIDELINE_ENTRY_JSON_MARKER)) {
-        return parseJsonGuidelineEntries(trimmed);
-    }
-    if (!trimmed.startsWith(GUIDELINE_ENTRY_MARKER)) {
-        return normalizeGuidelineEntries(trimmed.split(GUIDELINE_ENTRY_SEPARATOR));
-    }
-    const markerLine = `${GUIDELINE_ENTRY_MARKER}\n`;
-    return normalizeGuidelineEntries(trimmed
-        .slice(markerLine.length)
-        .split(`${GUIDELINE_ENTRY_SEPARATOR}${markerLine}`));
-}
-function parseJsonGuidelineEntries(content) {
-    const markerLine = `${GUIDELINE_ENTRY_JSON_MARKER}\n`;
-    return normalizeGuidelineEntries(content
-        .slice(markerLine.length)
-        .split(`${GUIDELINE_ENTRY_SEPARATOR}${markerLine}`)
-        .map((entry) => {
-        try {
-            const parsed = JSON.parse(entry);
-            return typeof parsed === "string" ? parsed : "";
-        }
-        catch {
-            return "";
-        }
-    }));
-}
-function serializeGuidelineEntries(entries) {
-    return normalizeGuidelineEntries(entries)
-        .map((entry) => `${GUIDELINE_ENTRY_JSON_MARKER}\n${JSON.stringify(entry)}`)
-        .join(GUIDELINE_ENTRY_SEPARATOR);
-}
-function normalizeGuidelineEntries(entries) {
-    return entries.map((entry) => entry.trim()).filter(Boolean);
-}
-function fitGuidelineEntriesForDisplay(entries, maxBytes) {
-    const fitted = normalizeGuidelineEntries(entries);
-    while (fitted.length > 0 &&
-        byteLength(formatGuidelineEntries(fitted)) > maxBytes) {
-        if (fitted.length === 1) {
-            const truncated = truncateEntryToBytes(fitted[0] ?? "", maxBytes);
-            return truncated ? [truncated] : [];
-        }
-        fitted.shift();
-    }
-    return fitted;
-}
-function truncateEntryToBytes(entry, maxBytes) {
-    if (maxBytes <= byteLength(GUIDELINE_TRUNCATION_NOTICE)) {
-        return "";
-    }
-    let truncated = "";
-    for (const char of Array.from(entry)) {
-        const next = `${truncated}${char}`;
-        if (byteLength(`${next}${GUIDELINE_TRUNCATION_NOTICE}`) > maxBytes) {
-            break;
-        }
-        truncated = next;
-    }
-    return `${truncated}${GUIDELINE_TRUNCATION_NOTICE}`.trim();
-}
-function byteLength(value) {
-    return Buffer.byteLength(value, "utf-8");
-}
-function learnedGuidelinesPromptPrefix(skillName) {
-    return `# Learned guidelines (${skillName})\n\nAccumulated from earlier runs of this skill. Treat as priors to verify, not as ground truth.\n\n`;
-}
-function resolveSkillDirectory(skillName, userSkillsDir) {
-    const validatedSkillName = validateSkillName(skillName);
-    const skillDirectory = resolve(userSkillsDir, validatedSkillName);
-    if (!isPathWithinDirectory(skillDirectory, userSkillsDir)) {
-        throw new Error(`Invalid skill name for learned guidelines: ${skillName}`);
-    }
-    return skillDirectory;
-}
-function isPathWithinDirectory(candidatePath, directoryPath) {
-    const normalizedDir = `${resolve(directoryPath)}${sep}`;
-    const normalizedCandidate = resolve(candidatePath);
-    return normalizedCandidate.startsWith(normalizedDir);
-}
-function withLearnedGuidelinesLock(path, operation) {
-    mkdirSync(dirname(path), { recursive: true });
-    const lockPath = `${path}.lock`;
-    const ownerToken = randomUUID();
-    const startedAt = Date.now();
-    while (true) {
-        try {
-            mkdirSync(lockPath);
-            writeGuidelinesLockOwner(lockPath, ownerToken);
-            break;
-        }
-        catch (error) {
-            const code = error.code;
-            if (code !== "EEXIST")
-                throw error;
-            if (recoverStaleGuidelinesLock(lockPath))
-                continue;
-            if (Date.now() - startedAt > GUIDELINES_LOCK_TIMEOUT_MS) {
-                throw new Error(`timed out waiting for learned guidelines lock: ${path}`);
-            }
-            sleepSync(GUIDELINES_LOCK_RETRY_MS);
-        }
-    }
-    try {
-        return operation();
-    }
-    finally {
-        releaseGuidelinesLock(lockPath, ownerToken);
-    }
-}
-function writeGuidelinesLockOwner(lockPath, ownerToken) {
-    const owner = {
-        pid: process.pid,
-        token: ownerToken,
-        createdAt: new Date().toISOString(),
-    };
-    try {
-        writeTextFileAtomic(join(lockPath, GUIDELINES_LOCK_OWNER_FILE), `${JSON.stringify(owner)}\n`, { createDirs: true });
-    }
-    catch (error) {
-        rmSync(lockPath, { recursive: true, force: true });
-        throw error;
-    }
-}
-function releaseGuidelinesLock(lockPath, ownerToken) {
-    const owner = readGuidelinesLockOwner(lockPath);
-    if (owner?.token === ownerToken) {
-        rmSync(lockPath, { recursive: true, force: true });
-    }
-}
-function recoverStaleGuidelinesLock(lockPath) {
-    try {
-        const stats = statSync(lockPath);
-        if (Date.now() - stats.mtimeMs <= GUIDELINES_LOCK_STALE_MS) {
-            return false;
-        }
-        const owner = readGuidelinesLockOwner(lockPath);
-        if (typeof owner?.pid === "number" && isProcessAlive(owner.pid)) {
-            return false;
-        }
-        rmSync(lockPath, { recursive: true, force: true });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function readGuidelinesLockOwner(lockPath) {
-    try {
-        const raw = readFileSync(join(lockPath, GUIDELINES_LOCK_OWNER_FILE), "utf-8");
-        const parsed = JSON.parse(raw);
-        if (typeof parsed.pid === "number" &&
-            typeof parsed.token === "string" &&
-            typeof parsed.createdAt === "string") {
-            return {
-                pid: parsed.pid,
-                token: parsed.token,
-                createdAt: parsed.createdAt,
-            };
-        }
-    }
-    catch {
-        // Missing or malformed ownership metadata is treated as unowned.
-    }
-    return null;
-}
-function sleepSync(ms) {
-    Atomics.wait(SLEEP_VIEW, 0, 0, ms);
-}
-//# sourceMappingURL=learned-guidelines.js.map

package/dist/skills/learned-guidelines.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"learned-guidelines.js","sourceRoot":"","sources":["../../src/skills/learned-guidelines.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Learned guidelines for skills\n *\n * A skill can accumulate durable, plain-text guidance across runs — for\n * example, incident-triage learning which tools and interfaces a given alert\n * type needs. Learnings are stored as markdown at\n * `<userSkillsDir>/<skill>/guidelines.md` (default `~/.maestro/skills`), so a\n * later run of the same skill can load what earlier runs discovered.\n *\n * The file is markdown, not settings, and every function takes the skills root\n * as a parameter (defaulting to the sanctioned PATHS.MAESTRO_HOME), so this\n * module reads no environment directly and writes atomically.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, rmSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve, sep } from \"node:path\";\nimport { PATHS } from \"../config/constants.js\";\nimport { isProcessAlive } from \"../tools/process-tree.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\n\nconst GUIDELINES_FILENAME = \"guidelines.md\";\nconst SKILL_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;\nconst GUIDELINES_LOCK_RETRY_MS = 25;\nconst GUIDELINES_LOCK_STALE_MS = 30_000;\nconst GUIDELINES_LOCK_TIMEOUT_MS =\n\tGUIDELINES_LOCK_STALE_MS + GUIDELINES_LOCK_RETRY_MS;\nconst GUIDELINES_LOCK_OWNER_FILE = \"owner.json\";\nconst MAX_GUIDELINES_BYTES = 64 * 1024;\nconst GUIDELINE_ENTRY_SEPARATOR = \"\\n\\n---\\n\\n\";\nconst GUIDELINE_ENTRY_MARKER = \"<!-- maestro-learned-guideline-entry -->\";\nconst GUIDELINE_ENTRY_JSON_MARKER =\n\t\"<!-- maestro-learned-guideline-entry-json -->\";\nconst GUIDELINE_TRUNCATION_NOTICE =\n\t\"\\n\\n[learned guideline truncated to fit byte cap]\";\nconst SLEEP_BUFFER = new SharedArrayBuffer(4);\nconst SLEEP_VIEW = new Int32Array(SLEEP_BUFFER);\n\ninterface GuidelinesLockOwner {\n\tpid: number;\n\ttoken: string;\n\tcreatedAt: string;\n}\n\n/** Default per-user skills root (`~/.maestro/skills`). */\nexport function defaultUserSkillsDir(): string {\n\treturn join(PATHS.MAESTRO_HOME, \"skills\");\n}\n\nfunction validateSkillName(skillName: string): string {\n\tif (!SKILL_NAME_PATTERN.test(skillName)) {\n\t\tthrow new Error(`Invalid skill name for learned guidelines: ${skillName}`);\n\t}\n\treturn skillName;\n}\n\n/** Absolute path to a skill's learned-guidelines file. */\nexport function getLearnedGuidelinesPath(\n\tskillName: string,\n\tuserSkillsDir: string = defaultUserSkillsDir(),\n): string {\n\treturn join(\n\t\tresolveSkillDirectory(skillName, userSkillsDir),\n\t\tGUIDELINES_FILENAME,\n\t);\n}\n\n/**\n * Load a skill's learned guidelines, or null when none have been recorded.\n */\nexport function loadLearnedGuidelines(\n\tskillName: string,\n\tuserSkillsDir: string = defaultUserSkillsDir(),\n): string | null {\n\tconst content = formatGuidelineEntries(\n\t\tloadDisplayGuidelineEntries(skillName, userSkillsDir, MAX_GUIDELINES_BYTES),\n\t);\n\treturn content.length > 0 ? content : null;\n}\n\n/**\n * Render a skill's learned guidelines as a prompt-ready block, or null when\n * there are none. Suitable for injection alongside the skill's own content.\n */\nexport function formatLearnedGuidelinesForPrompt(\n\tskillName: string,\n\tuserSkillsDir: string = defaultUserSkillsDir(),\n): string | null {\n\tconst promptPrefix = learnedGuidelinesPromptPrefix(skillName);\n\tconst content = formatGuidelineEntries(\n\t\tloadDisplayGuidelineEntries(\n\t\t\tskillName,\n\t\t\tuserSkillsDir,\n\t\t\tMAX_GUIDELINES_BYTES - byteLength(promptPrefix),\n\t\t),\n\t);\n\tif (!content) {\n\t\treturn null;\n\t}\n\treturn `${promptPrefix}${content}`;\n}\n\n/**\n * Append a learned-guideline entry to a skill's guidelines file, creating it on\n * first use. Entries are separated by a horizontal rule so the file stays a\n * readable, append-only log.\n */\nexport function appendLearnedGuideline(\n\tskillName: string,\n\tentry: string,\n\tuserSkillsDir: string = defaultUserSkillsDir(),\n): string {\n\tconst trimmed = entry.trim();\n\tif (trimmed.length === 0) {\n\t\tthrow new Error(\"appendLearnedGuideline requires a non-empty entry\");\n\t}\n\tconst path = getLearnedGuidelinesPath(skillName, userSkillsDir);\n\treturn withLearnedGuidelinesLock(path, () => {\n\t\tconst existing = existsSync(path) ? readFileSync(path, \"utf-8\").trim() : \"\";\n\t\tconst next = buildGuidelinesContent(existing, trimmed);\n\t\tif (next !== null) {\n\t\t\twriteTextFileAtomic(path, next, { createDirs: true });\n\t\t}\n\t\treturn path;\n\t});\n}\n\nfunction buildGuidelinesContent(\n\texisting: string,\n\tentry: string,\n): string | null {\n\tconst entries = parseGuidelineEntries(existing);\n\tif (byteLength(serializeGuidelineEntries([entry])) > MAX_GUIDELINES_BYTES) {\n\t\treturn null;\n\t}\n\tentries.push(entry);\n\treturn formatGuidelinesContent(pruneGuidelineEntries(entries));\n}\n\nfunction loadDisplayGuidelineEntries(\n\tskillName: string,\n\tuserSkillsDir: string,\n\tmaxBytes: number,\n): string[] {\n\tconst path = getLearnedGuidelinesPath(skillName, userSkillsDir);\n\tif (!existsSync(path)) {\n\t\treturn [];\n\t}\n\treturn fitGuidelineEntriesForDisplay(\n\t\tparseGuidelineEntries(readFileSync(path, \"utf-8\")),\n\t\tmaxBytes,\n\t);\n}\n\nfunction pruneGuidelineEntries(entries: string[]): string[] {\n\twhile (\n\t\tentries.length > 0 &&\n\t\tbyteLength(serializeGuidelineEntries(entries)) > MAX_GUIDELINES_BYTES\n\t) {\n\t\tentries.shift();\n\t}\n\treturn entries;\n}\n\nfunction formatGuidelinesContent(entries: string[]): string {\n\tconst content = serializeGuidelineEntries(entries);\n\treturn content.length > 0 ? `${content}\\n` : \"\";\n}\n\nfunction formatGuidelineEntries(entries: string[]): string {\n\treturn normalizeGuidelineEntries(entries).join(GUIDELINE_ENTRY_SEPARATOR);\n}\n\nfunction parseGuidelineEntries(content: string): string[] {\n\tconst trimmed = content\n\t\t.replace(/^\\uFEFF/, \"\")\n\t\t.replace(/\\r\\n?/g, \"\\n\")\n\t\t.trim();\n\tif (trimmed.length === 0) {\n\t\treturn [];\n\t}\n\tif (trimmed.startsWith(GUIDELINE_ENTRY_JSON_MARKER)) {\n\t\treturn parseJsonGuidelineEntries(trimmed);\n\t}\n\tif (!trimmed.startsWith(GUIDELINE_ENTRY_MARKER)) {\n\t\treturn normalizeGuidelineEntries(trimmed.split(GUIDELINE_ENTRY_SEPARATOR));\n\t}\n\tconst markerLine = `${GUIDELINE_ENTRY_MARKER}\\n`;\n\treturn normalizeGuidelineEntries(\n\t\ttrimmed\n\t\t\t.slice(markerLine.length)\n\t\t\t.split(`${GUIDELINE_ENTRY_SEPARATOR}${markerLine}`),\n\t);\n}\n\nfunction parseJsonGuidelineEntries(content: string): string[] {\n\tconst markerLine = `${GUIDELINE_ENTRY_JSON_MARKER}\\n`;\n\treturn normalizeGuidelineEntries(\n\t\tcontent\n\t\t\t.slice(markerLine.length)\n\t\t\t.split(`${GUIDELINE_ENTRY_SEPARATOR}${markerLine}`)\n\t\t\t.map((entry) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(entry) as unknown;\n\t\t\t\t\treturn typeof parsed === \"string\" ? parsed : \"\";\n\t\t\t\t} catch {\n\t\t\t\t\treturn \"\";\n\t\t\t\t}\n\t\t\t}),\n\t);\n}\n\nfunction serializeGuidelineEntries(entries: string[]): string {\n\treturn normalizeGuidelineEntries(entries)\n\t\t.map((entry) => `${GUIDELINE_ENTRY_JSON_MARKER}\\n${JSON.stringify(entry)}`)\n\t\t.join(GUIDELINE_ENTRY_SEPARATOR);\n}\n\nfunction normalizeGuidelineEntries(entries: string[]): string[] {\n\treturn entries.map((entry) => entry.trim()).filter(Boolean);\n}\n\nfunction fitGuidelineEntriesForDisplay(\n\tentries: string[],\n\tmaxBytes: number,\n): string[] {\n\tconst fitted = normalizeGuidelineEntries(entries);\n\twhile (\n\t\tfitted.length > 0 &&\n\t\tbyteLength(formatGuidelineEntries(fitted)) > maxBytes\n\t) {\n\t\tif (fitted.length === 1) {\n\t\t\tconst truncated = truncateEntryToBytes(fitted[0] ?? \"\", maxBytes);\n\t\t\treturn truncated ? [truncated] : [];\n\t\t}\n\t\tfitted.shift();\n\t}\n\treturn fitted;\n}\n\nfunction truncateEntryToBytes(entry: string, maxBytes: number): string {\n\tif (maxBytes <= byteLength(GUIDELINE_TRUNCATION_NOTICE)) {\n\t\treturn \"\";\n\t}\n\tlet truncated = \"\";\n\tfor (const char of Array.from(entry)) {\n\t\tconst next = `${truncated}${char}`;\n\t\tif (byteLength(`${next}${GUIDELINE_TRUNCATION_NOTICE}`) > maxBytes) {\n\t\t\tbreak;\n\t\t}\n\t\ttruncated = next;\n\t}\n\treturn `${truncated}${GUIDELINE_TRUNCATION_NOTICE}`.trim();\n}\n\nfunction byteLength(value: string): number {\n\treturn Buffer.byteLength(value, \"utf-8\");\n}\n\nfunction learnedGuidelinesPromptPrefix(skillName: string): string {\n\treturn `# Learned guidelines (${skillName})\\n\\nAccumulated from earlier runs of this skill. Treat as priors to verify, not as ground truth.\\n\\n`;\n}\n\nfunction resolveSkillDirectory(\n\tskillName: string,\n\tuserSkillsDir: string,\n): string {\n\tconst validatedSkillName = validateSkillName(skillName);\n\tconst skillDirectory = resolve(userSkillsDir, validatedSkillName);\n\tif (!isPathWithinDirectory(skillDirectory, userSkillsDir)) {\n\t\tthrow new Error(`Invalid skill name for learned guidelines: ${skillName}`);\n\t}\n\treturn skillDirectory;\n}\n\nfunction isPathWithinDirectory(\n\tcandidatePath: string,\n\tdirectoryPath: string,\n): boolean {\n\tconst normalizedDir = `${resolve(directoryPath)}${sep}`;\n\tconst normalizedCandidate = resolve(candidatePath);\n\treturn normalizedCandidate.startsWith(normalizedDir);\n}\n\nfunction withLearnedGuidelinesLock<T>(path: string, operation: () => T): T {\n\tmkdirSync(dirname(path), { recursive: true });\n\tconst lockPath = `${path}.lock`;\n\tconst ownerToken = randomUUID();\n\tconst startedAt = Date.now();\n\twhile (true) {\n\t\ttry {\n\t\t\tmkdirSync(lockPath);\n\t\t\twriteGuidelinesLockOwner(lockPath, ownerToken);\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tconst code = (error as NodeJS.ErrnoException).code;\n\t\t\tif (code !== \"EEXIST\") throw error;\n\t\t\tif (recoverStaleGuidelinesLock(lockPath)) continue;\n\t\t\tif (Date.now() - startedAt > GUIDELINES_LOCK_TIMEOUT_MS) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`timed out waiting for learned guidelines lock: ${path}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tsleepSync(GUIDELINES_LOCK_RETRY_MS);\n\t\t}\n\t}\n\ttry {\n\t\treturn operation();\n\t} finally {\n\t\treleaseGuidelinesLock(lockPath, ownerToken);\n\t}\n}\n\nfunction writeGuidelinesLockOwner(lockPath: string, ownerToken: string): void {\n\tconst owner: GuidelinesLockOwner = {\n\t\tpid: process.pid,\n\t\ttoken: ownerToken,\n\t\tcreatedAt: new Date().toISOString(),\n\t};\n\ttry {\n\t\twriteTextFileAtomic(\n\t\t\tjoin(lockPath, GUIDELINES_LOCK_OWNER_FILE),\n\t\t\t`${JSON.stringify(owner)}\\n`,\n\t\t\t{ createDirs: true },\n\t\t);\n\t} catch (error) {\n\t\trmSync(lockPath, { recursive: true, force: true });\n\t\tthrow error;\n\t}\n}\n\nfunction releaseGuidelinesLock(lockPath: string, ownerToken: string): void {\n\tconst owner = readGuidelinesLockOwner(lockPath);\n\tif (owner?.token === ownerToken) {\n\t\trmSync(lockPath, { recursive: true, force: true });\n\t}\n}\n\nfunction recoverStaleGuidelinesLock(lockPath: string): boolean {\n\ttry {\n\t\tconst stats = statSync(lockPath);\n\t\tif (Date.now() - stats.mtimeMs <= GUIDELINES_LOCK_STALE_MS) {\n\t\t\treturn false;\n\t\t}\n\t\tconst owner = readGuidelinesLockOwner(lockPath);\n\t\tif (typeof owner?.pid === \"number\" && isProcessAlive(owner.pid)) {\n\t\t\treturn false;\n\t\t}\n\t\trmSync(lockPath, { recursive: true, force: true });\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction readGuidelinesLockOwner(lockPath: string): GuidelinesLockOwner | null {\n\ttry {\n\t\tconst raw = readFileSync(\n\t\t\tjoin(lockPath, GUIDELINES_LOCK_OWNER_FILE),\n\t\t\t\"utf-8\",\n\t\t);\n\t\tconst parsed = JSON.parse(raw) as Partial<GuidelinesLockOwner>;\n\t\tif (\n\t\t\ttypeof parsed.pid === \"number\" &&\n\t\t\ttypeof parsed.token === \"string\" &&\n\t\t\ttypeof parsed.createdAt === \"string\"\n\t\t) {\n\t\t\treturn {\n\t\t\t\tpid: parsed.pid,\n\t\t\t\ttoken: parsed.token,\n\t\t\t\tcreatedAt: parsed.createdAt,\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Missing or malformed ownership metadata is treated as unowned.\n\t}\n\treturn null;\n}\n\nfunction sleepSync(ms: number): void {\n\tAtomics.wait(SLEEP_VIEW, 0, 0, ms);\n}\n"]}

package/dist/skills/linter.d.ts

@@ -1,36 +0,0 @@
-export type SkillLintSeverity = "error" | "warning";
-export interface SkillLintIssue {
-    code: string;
-    severity: SkillLintSeverity;
-    message: string;
-    path: string;
-}
-export interface SkillLintResult {
-    path: string;
-    issues: SkillLintIssue[];
-}
-export interface SkillScaffoldOptions {
-    description?: string;
-    force?: boolean;
-}
-export interface SkillScaffoldResult {
-    name: string;
-    directory: string;
-    files: string[];
-}
-type SkillLintOptions = {
-    describeToolbox?: boolean;
-    platform?: NodeJS.Platform;
-};
-export declare const SKILL_BODY_MAX_LINES = 500;
-export declare const SKILL_BODY_MAX_CHARS = 20000;
-export declare function isWindowsRunnableToolboxEntry(path: string, pathExt?: string | undefined): boolean;
-export declare function shouldUseShellForToolboxDescribe(platform?: NodeJS.Platform): boolean;
-export declare function toolboxDescribeSpawnCommand(path: string, platform?: NodeJS.Platform): string;
-export declare function lintSkillDirectory(skillDir: string, options?: SkillLintOptions): Promise<SkillLintResult>;
-export declare function lintSkillPaths(paths: string[], options?: SkillLintOptions): Promise<SkillLintResult[]>;
-export declare function formatSkillLintText(results: SkillLintResult[]): string;
-export declare function hasSkillLintErrors(results: SkillLintResult[]): boolean;
-export declare function scaffoldSkill(baseDir: string, name: string, options?: SkillScaffoldOptions): SkillScaffoldResult;
-export {};
-//# sourceMappingURL=linter.d.ts.map

package/dist/skills/linter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/skills/linter.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,KAAK,gBAAgB,GAAG;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAyS3C,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,qBAAsB,GAC3B,OAAO,CAKT;AAsBD,wBAAgB,gCAAgC,CAC/C,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,OAAO,CAET;AAED,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,MAAM,CAER;AA4FD,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA+F1B;AAED,wBAAsB,cAAc,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CA6C5B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CA6BtE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAItE;AAED,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GAChC,mBAAmB,CAgFrB"}