codexgpt 1.0.0

package/dist/guidance/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/guidance/diagnostics.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,4BAA4B,CAAC,WAAoC;IAC/E,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;YAC/D,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,WAAW,CAAC,MAAM;gBAClB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI;QACV,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,KAAK;QACL,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,iCAAiC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/guidance/instructions.js

@@ -0,0 +1,167 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { assertSafePathInput, displayPath, isSubpath, normalizeRelPath } from "../guard.js";
+import { normalizeGuidancePathInput, readGuidanceText } from "./safeTextReader.js";
+import { redactSensitiveText } from "../redact.js";
+const FIXED_NAMES = ["AGENTS.override.md", "AGENTS.md"];
+const DEFAULT_FALLBACKS = ["agents.md", ".agents.md"];
+const RESERVED = /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(?:\..*)?$/i;
+export function validateInstructionFallbacks(values) {
+    const candidates = values ?? [...DEFAULT_FALLBACKS];
+    if (candidates.length > 8)
+        throw new Error("At most eight instruction fallback basenames are allowed.");
+    const seen = new Set();
+    for (const candidate of candidates) {
+        if (!candidate || candidate.trim() !== candidate || candidate === "." || candidate === ".." || candidate.includes("/") || candidate.includes("\\") || /[\u0000-\u001f\u007f]/.test(candidate) || candidate.endsWith(".") || candidate.endsWith(" ") || RESERVED.test(candidate)) {
+            throw new Error(`Unsafe instruction fallback basename: ${candidate}`);
+        }
+        assertSafePathInput(candidate, "win32");
+        const key = candidate.toLocaleLowerCase("en-US");
+        if (seen.has(key))
+            throw new Error(`Duplicate instruction fallback basename: ${candidate}`);
+        seen.add(key);
+    }
+    return [...candidates];
+}
+function mapReadReason(reason) {
+    if (reason === "READ_TOO_LARGE")
+        return "INSTRUCTION_FILE_TOO_LARGE";
+    if (reason === "READ_IDENTITY_CHANGED" || reason === "READ_BOUNDARY_VIOLATION")
+        return "INSTRUCTION_READ_IDENTITY_CHANGED";
+    if (reason === "READ_HARDLINK_UNSAFE")
+        return "INSTRUCTION_HARDLINK_UNSAFE";
+    if (reason === "READ_NOT_TEXT" || reason === "READ_NOT_REGULAR")
+        return "INSTRUCTION_NOT_TEXT";
+    return "INSTRUCTION_READ_FAILED";
+}
+function diagnostic(code, filePath) {
+    const actions = {
+        INSTRUCTION_NAME_COLLISION: "Keep only one case-insensitive match for this instruction filename.",
+        INSTRUCTION_FILE_TOO_LARGE: "Reduce the instruction file size or raise the bounded per-file limit.",
+        INSTRUCTION_TOTAL_BUDGET_EXCEEDED: "Reduce closer instruction files or raise the bounded combined limit.",
+        INSTRUCTION_READ_IDENTITY_CHANGED: "Retry after filesystem changes stop.",
+        INSTRUCTION_HARDLINK_UNSAFE: "Replace the hard link with a single-link instruction file.",
+        INSTRUCTION_NOT_TEXT: "Replace the instruction candidate with regular UTF-8 text.",
+        INSTRUCTION_READ_FAILED: "Fix the instruction file and retry context loading."
+    };
+    return { status: "warning", code, path: filePath, count: 1, action: actions[code] };
+}
+async function targetDirectory(root, targetPath) {
+    const requestedTargetPath = targetPath || ".";
+    if (redactSensitiveText(requestedTargetPath) !== requestedTargetPath)
+        throw new Error("Target path is blocked by safety rules.");
+    const normalizedTargetPath = normalizeGuidancePathInput(requestedTargetPath);
+    const requested = path.resolve(root, normalizedTargetPath);
+    if (!isSubpath(requested, root))
+        throw new Error("Target path escapes workspace root.");
+    try {
+        const real = await fsp.realpath(requested);
+        if (!isSubpath(real, root))
+            throw new Error("Target path resolves outside workspace root.");
+        const stat = await fsp.stat(real);
+        if (stat.isDirectory())
+            return { targetPath: displayPath(real, root), targetKind: "directory", directory: real };
+        if (stat.isFile())
+            return { targetPath: displayPath(real, root), targetKind: "file", directory: path.dirname(real) };
+        throw new Error("Target path is not a regular file or directory.");
+    }
+    catch (error) {
+        if (error instanceof Error && (error.message.includes("outside") || error.message.includes("not a regular")))
+            throw error;
+        let parent = path.dirname(requested);
+        while (!fs.existsSync(parent)) {
+            const next = path.dirname(parent);
+            if (next === parent)
+                break;
+            parent = next;
+        }
+        const realParent = await fsp.realpath(parent);
+        const stat = await fsp.stat(realParent);
+        const directory = stat.isDirectory() ? realParent : path.dirname(realParent);
+        if (!isSubpath(directory, root))
+            throw new Error("Target parent resolves outside workspace root.");
+        return { targetPath: normalizeRelPath(path.relative(root, requested)) || ".", targetKind: "missing", directory };
+    }
+}
+function directoryChain(root, targetDir) {
+    const relative = path.relative(root, targetDir);
+    if (!relative)
+        return [root];
+    const out = [root];
+    let current = root;
+    for (const segment of relative.split(path.sep).filter(Boolean)) {
+        current = path.join(current, segment);
+        out.push(current);
+    }
+    return out;
+}
+export async function discoverInstructions(options) {
+    const root = fs.realpathSync.native(path.resolve(options.root));
+    const target = await targetDirectory(root, options.targetPath);
+    const names = [...FIXED_NAMES, ...validateInstructionFallbacks(options.fallbackNames)];
+    const files = [];
+    const diagnostics = [];
+    let totalSourceBytes = 0;
+    for (const directory of directoryChain(root, target.directory)) {
+        const entries = [];
+        let handle;
+        try {
+            handle = await fsp.opendir(directory);
+            for await (const entry of handle) {
+                if (names.some((name) => process.platform === "win32"
+                    ? entry.name.toLocaleLowerCase("en-US") === name.toLocaleLowerCase("en-US")
+                    : entry.name === name))
+                    entries.push(entry);
+            }
+        }
+        catch {
+            continue;
+        }
+        finally {
+            await handle?.close().catch(() => undefined);
+        }
+        for (const name of names) {
+            const matches = process.platform === "win32"
+                ? entries.filter((entry) => entry.name.toLocaleLowerCase("en-US") === name.toLocaleLowerCase("en-US"))
+                : entries.filter((entry) => entry.name === name);
+            if (matches.length === 0)
+                continue;
+            const rel = normalizeRelPath(path.relative(root, path.join(directory, matches[0].name)));
+            if (matches.length > 1) {
+                diagnostics.push(diagnostic("INSTRUCTION_NAME_COLLISION", redactSensitiveText(rel)));
+                break;
+            }
+            const loaded = await readGuidanceText({ root, relativePath: rel, maxBytes: options.maxFileBytes, blockedGlobs: options.blockedGlobs });
+            if (!loaded.ok) {
+                diagnostics.push(diagnostic(mapReadReason(loaded.reason), redactSensitiveText(loaded.path ?? rel)));
+                break;
+            }
+            if (loaded.text.trim().length === 0)
+                continue;
+            if (totalSourceBytes + loaded.sourceBytes > options.maxTotalBytes) {
+                diagnostics.push(diagnostic("INSTRUCTION_TOTAL_BUDGET_EXCEEDED", redactSensitiveText(loaded.path)));
+                break;
+            }
+            const safeText = redactSensitiveText(loaded.text);
+            files.push({
+                path: redactSensitiveText(loaded.path),
+                text: safeText,
+                sourceBytes: loaded.sourceBytes,
+                returnedBytes: Buffer.byteLength(safeText, "utf8"),
+                redacted: safeText !== loaded.text
+            });
+            totalSourceBytes += loaded.sourceBytes;
+            break;
+        }
+    }
+    return {
+        targetPath: target.targetPath,
+        targetKind: target.targetKind,
+        files,
+        diagnostics,
+        totalSourceBytes,
+        complete: diagnostics.length === 0
+    };
+}
+//# sourceMappingURL=instructions.js.map

package/dist/guidance/instructions.js.map

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

package/dist/guidance/mode.js

@@ -0,0 +1,18 @@
+// Phase 6A6 changes this single constant after every standard-mode gate passes.
+export const DEFAULT_GUIDANCE_MODE = "standard";
+export const STANDARD_GUIDANCE_READINESS = "ready";
+export function resolveGuidanceMode(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return DEFAULT_GUIDANCE_MODE;
+    if (normalized === "legacy" || normalized === "standard")
+        return normalized;
+    throw new Error("CODEXGPT_GUIDANCE_MODE must be legacy or standard.");
+}
+export function guidanceReadiness(mode) {
+    return mode === "standard" ? STANDARD_GUIDANCE_READINESS : "not_ready";
+}
+export function guidanceRuntimeState(mode) {
+    return { mode, readiness: guidanceReadiness(mode) };
+}
+//# sourceMappingURL=mode.js.map

package/dist/guidance/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../src/guidance/mode.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAiB,UAAU,CAAC;AAC9D,MAAM,CAAC,MAAM,2BAA2B,GAAsB,OAAO,CAAC;AAEtE,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,CAAC,UAAU;QAAE,OAAO,qBAAqB,CAAC;IAC9C,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC5E,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,WAAW,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IAIrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/guidance/openaiSkillMetadata.js

@@ -0,0 +1,29 @@
+import { parseDocument } from "yaml";
+export function parseOpenAISkillMetadata(text) {
+    if (Buffer.byteLength(text, "utf8") > 16_384)
+        return null;
+    try {
+        const document = parseDocument(text, { schema: "core", customTags: [], strict: true, uniqueKeys: true });
+        if (document.errors.length > 0 || document.warnings.some((warning) => warning.code === "TAG_RESOLVE_FAILED"))
+            return null;
+        const value = document.toJS({ maxAliasCount: 0 });
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return null;
+        const raw = value;
+        const policy = raw.policy && typeof raw.policy === "object" && !Array.isArray(raw.policy)
+            ? raw.policy
+            : {};
+        const implicit = policy.allow_implicit_invocation;
+        if (implicit !== undefined && typeof implicit !== "boolean")
+            return null;
+        const dependencies = raw.dependencies;
+        const requirementsState = dependencies && typeof dependencies === "object" && Object.keys(dependencies).length > 0
+            ? "declared_unverified"
+            : "none";
+        return { implicitInvocation: implicit !== false, requirementsState };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=openaiSkillMetadata.js.map

package/dist/guidance/openaiSkillMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiSkillMetadata.js","sourceRoot":"","sources":["../../src/guidance/openaiSkillMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAOrC,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACzG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,oBAAoB,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1H,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACvF,CAAC,CAAC,GAAG,CAAC,MAAiC;YACvC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,GAAG,MAAM,CAAC,yBAAyB,CAAC;QAClD,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzE,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;QACtC,MAAM,iBAAiB,GAAG,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,YAAsB,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1H,CAAC,CAAC,qBAAqB;YACvB,CAAC,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,kBAAkB,EAAE,QAAQ,KAAK,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/guidance/safeTextReader.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import { createHash } from "node:crypto";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { PathGuard, assertSafePathInput, displayPath, isSubpath, normalizeRelPath, parentObjectIdentity } from "../guard.js";
+export function normalizeGuidancePathInput(inputPath) {
+    const value = inputPath || ".";
+    if (/^[A-Za-z]:/u.test(value)) {
+        throw new Error("Windows drive paths are not allowed for guidance reads.");
+    }
+    try {
+        assertSafePathInput(value, "win32");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "";
+        if (message.includes("alternate data stream")) {
+            throw new Error("NTFS alternate data stream paths are not allowed for guidance reads.");
+        }
+        if (message.includes("UNC") || message.includes("device")) {
+            throw new Error("Windows UNC and device paths are not allowed for guidance reads.");
+        }
+        throw new Error("Windows-unsafe paths are not allowed for guidance reads.");
+    }
+    return value.replace(/\\/g, "/");
+}
+function identity(stat) {
+    return { dev: stat.dev.toString(), ino: stat.ino.toString(), nlink: Number(stat.nlink) };
+}
+function sameIdentity(left, right) {
+    return left.dev === right.dev &&
+        left.ino === right.ino &&
+        left.nlink === right.nlink &&
+        left.size === right.size &&
+        left.mtimeNs === right.mtimeNs &&
+        left.ctimeNs === right.ctimeNs;
+}
+function failure(pathValue, reason) {
+    return { ok: false, path: pathValue, reason };
+}
+function sameNativePath(left, right) {
+    return process.platform === "win32"
+        ? left.toLocaleLowerCase("en-US") === right.toLocaleLowerCase("en-US")
+        : left === right;
+}
+function classifyPreOpenError(error) {
+    const code = typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : "";
+    if (code === "ENOENT")
+        return "READ_MISSING";
+    const message = error instanceof Error ? error.message : "";
+    if (message.includes("blocked by safety rules"))
+        return "READ_BLOCKED";
+    if (message.includes("outside") || message.includes("escapes") || message.includes("drive paths") || message.includes("UNC") || message.includes("device") || message.includes("alternate data stream")) {
+        return "READ_BOUNDARY_VIOLATION";
+    }
+    return "READ_FAILED";
+}
+export async function readGuidanceText(options) {
+    const root = options.preparedBoundary?.root ?? fs.realpathSync.native(path.resolve(options.root));
+    const workspace = { id: "guidance-reader", root, openedAt: "1970-01-01T00:00:00.000Z" };
+    const guard = options.preparedBoundary?.guard ?? new PathGuard({ blockedGlobs: options.blockedGlobs });
+    let resolved;
+    try {
+        resolved = guard.resolve(workspace, normalizeGuidancePathInput(options.relativePath));
+    }
+    catch (error) {
+        return failure(null, classifyPreOpenError(error));
+    }
+    const safePath = normalizeRelPath(resolved.relPath);
+    const maxBytes = Math.max(0, Math.floor(options.maxBytes));
+    let handle;
+    try {
+        const canonicalParentBefore = await fsp.realpath(path.dirname(resolved.absPath));
+        if (!isSubpath(canonicalParentBefore, root))
+            return failure(safePath, "READ_BOUNDARY_VIOLATION");
+        handle = await fsp.open(resolved.absPath, "r");
+        const before = await handle.stat({ bigint: true });
+        if (!before.isFile())
+            return failure(safePath, "READ_NOT_REGULAR");
+        if (before.nlink !== 1n)
+            return failure(safePath, "READ_HARDLINK_UNSAFE");
+        if (before.size > BigInt(maxBytes))
+            return failure(safePath, "READ_TOO_LARGE");
+        if (before.size > BigInt(Number.MAX_SAFE_INTEGER))
+            return failure(safePath, "READ_TOO_LARGE");
+        await options.testHooks?.afterOpen?.();
+        const buffer = Buffer.alloc(Number(before.size));
+        let offset = 0;
+        while (offset < buffer.length) {
+            const read = await handle.read(buffer, offset, buffer.length - offset, offset);
+            if (read.bytesRead === 0)
+                break;
+            offset += read.bytesRead;
+        }
+        if (offset !== buffer.length)
+            return failure(safePath, "READ_IDENTITY_CHANGED");
+        await options.testHooks?.afterRead?.();
+        if (options.verificationPasses !== 1) {
+            const verification = Buffer.alloc(buffer.length);
+            let verificationOffset = 0;
+            while (verificationOffset < verification.length) {
+                const read = await handle.read(verification, verificationOffset, verification.length - verificationOffset, verificationOffset);
+                if (read.bytesRead === 0)
+                    break;
+                verificationOffset += read.bytesRead;
+            }
+            if (verificationOffset !== verification.length || !verification.equals(buffer)) {
+                return failure(safePath, "READ_IDENTITY_CHANGED");
+            }
+        }
+        const after = await handle.stat({ bigint: true });
+        if (!sameIdentity(before, after) || !after.isFile() || after.nlink !== 1n || after.size !== before.size) {
+            return failure(safePath, "READ_IDENTITY_CHANGED");
+        }
+        let currentReal;
+        let currentStat;
+        try {
+            currentReal = await fsp.realpath(resolved.absPath);
+            currentStat = await fsp.stat(currentReal, { bigint: true });
+        }
+        catch {
+            return failure(safePath, "READ_IDENTITY_CHANGED");
+        }
+        const currentParent = await fsp.realpath(path.dirname(resolved.absPath)).catch(() => "");
+        if (!currentParent || !sameNativePath(currentParent, canonicalParentBefore) || !isSubpath(currentParent, root) || !isSubpath(currentReal, root) || !sameIdentity(before, currentStat)) {
+            return failure(safePath, "READ_IDENTITY_CHANGED");
+        }
+        const canonicalPath = displayPath(currentReal, root);
+        if (guard.isBlockedRelativePath(canonicalPath))
+            return failure(safePath, "READ_BLOCKED");
+        if (buffer.includes(0))
+            return failure(safePath, "READ_NOT_TEXT");
+        const rawSha256 = createHash("sha256").update(buffer).digest("hex");
+        const verifiedExistingText = options.expectedRawSha256 !== undefined &&
+            /^[a-f0-9]{64}$/u.test(options.expectedRawSha256) &&
+            rawSha256 === options.expectedRawSha256;
+        if (options.expectedRawSha256 !== undefined && !verifiedExistingText) {
+            return failure(safePath, "READ_IDENTITY_CHANGED");
+        }
+        let text = "";
+        if (!verifiedExistingText) {
+            try {
+                text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(buffer);
+            }
+            catch {
+                return failure(safePath, "READ_NOT_TEXT");
+            }
+        }
+        const parentStat = await fsp.stat(currentParent, { bigint: true });
+        return {
+            ok: true,
+            path: safePath,
+            text,
+            sourceBytes: buffer.length,
+            returnedBytes: buffer.length,
+            bom: buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf,
+            identity: identity(before),
+            canonicalParentPath: currentParent,
+            parentIdentity: parentObjectIdentity(currentParent, parentStat),
+            rawSha256
+        };
+    }
+    catch (error) {
+        return failure(safePath, classifyPreOpenError(error));
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=safeTextReader.js.map

package/dist/guidance/safeTextReader.js.map

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

package/dist/guidance/skillCatalog.js

@@ -0,0 +1,70 @@
+const SOURCE_RANK = {
+    workspace: 0,
+    user: 1,
+    plugin: 2,
+    other: 3
+};
+function publicEntry(skill, descriptionLimit) {
+    const description = skill.description.length > descriptionLimit
+        ? `${skill.description.slice(0, Math.max(1, descriptionLimit - 1)).trimEnd()}…`
+        : skill.description;
+    return {
+        name: skill.name,
+        description,
+        source: skill.source,
+        path: skill.path,
+        compatibility: skill.compatibility,
+        loadable: skill.loadable,
+        implicitEligible: skill.implicitEligible,
+        requirementsState: skill.requirementsState,
+        specCompliant: skill.specCompliant
+    };
+}
+function serialize(entries, omitted, shortened) {
+    return JSON.stringify({
+        skills: entries,
+        catalog_complete: omitted === 0,
+        catalog_omitted_count: omitted,
+        descriptions_shortened: shortened
+    });
+}
+export function buildSkillCatalog(skills, requestedMaxChars = 8_000) {
+    const maxChars = Math.max(1_000, Math.min(32_000, Math.floor(requestedMaxChars)));
+    const eligible = skills.filter((skill) => skill.loadable && skill.implicitEligible)
+        .sort((left, right) => SOURCE_RANK[left.source] - SOURCE_RANK[right.source] || left.proximity - right.proximity || left.name.localeCompare(right.name) || left.path.localeCompare(right.path));
+    const ineligibleCount = skills.length - eligible.length;
+    let descriptionLimit = 1_000;
+    let included = eligible.length;
+    let entries = [];
+    let shortened = 0;
+    let serialized = "";
+    const rebuild = () => {
+        entries = eligible.slice(0, included).map((skill) => publicEntry(skill, descriptionLimit));
+        shortened = entries.filter((entry, index) => entry.description !== eligible[index].description).length;
+        serialized = serialize(entries, eligible.length - included, shortened);
+    };
+    rebuild();
+    while (serialized.length > maxChars && descriptionLimit > 32) {
+        descriptionLimit = Math.max(32, descriptionLimit - 32);
+        rebuild();
+    }
+    while (serialized.length > maxChars && included > 0) {
+        included -= 1;
+        rebuild();
+    }
+    if (serialized.length > maxChars) {
+        entries = [];
+        shortened = 0;
+        serialized = serialize([], eligible.length, 0);
+    }
+    return {
+        entries,
+        serialized,
+        characterCount: serialized.length,
+        catalogComplete: included === eligible.length,
+        catalogOmittedCount: eligible.length - included,
+        descriptionsShortened: shortened,
+        ineligibleCount
+    };
+}
+//# sourceMappingURL=skillCatalog.js.map

package/dist/guidance/skillCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCatalog.js","sourceRoot":"","sources":["../../src/guidance/skillCatalog.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,GAAkD;IACjE,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,WAAW,CAAC,KAA0B,EAAE,gBAAwB;IACvE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,gBAAgB;QAC7D,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG;QAC/E,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IACtB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW;QACX,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,OAA4B,EAAE,OAAe,EAAE,SAAiB;IACjF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,OAAO;QACf,gBAAgB,EAAE,OAAO,KAAK,CAAC;QAC/B,qBAAqB,EAAE,OAAO;QAC9B,sBAAsB,EAAE,SAAS;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA6B,EAAE,iBAAiB,GAAG,KAAK;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,gBAAgB,CAAC;SAChF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IACxD,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,IAAI,OAAO,GAAwB,EAAE,CAAC;IACtC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3F,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;QACxG,UAAU,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC,CAAC;IACF,OAAO,EAAE,CAAC;IACV,OAAO,UAAU,CAAC,MAAM,GAAG,QAAQ,IAAI,gBAAgB,GAAG,EAAE,EAAE,CAAC;QAC7D,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,gBAAgB,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,GAAG,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,IAAI,CAAC,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC;QACb,SAAS,GAAG,CAAC,CAAC;QACd,UAAU,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO;QACL,OAAO;QACP,UAAU;QACV,cAAc,EAAE,UAAU,CAAC,MAAM;QACjC,eAAe,EAAE,QAAQ,KAAK,QAAQ,CAAC,MAAM;QAC7C,mBAAmB,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ;QAC/C,qBAAqB,EAAE,SAAS;QAChC,eAAe;KAChB,CAAC;AACJ,CAAC"}