Function fileShapeIssues

src/compiled/cognition/validate.js:151–174

Push issues for a value that should be a File record. Empty string * prefix is fine for the singular File path; pass `file[N]: ` for list.

(value, issues, prefix)

/** Push issues for a value that should be a File record. Empty string
 *  prefix is fine for the singular File path; pass `file[N]: ` for list. */
function fileShapeIssues(value, issues, prefix) {
    if (!value || typeof value !== "object") {
        issues.push(`${prefix}expected File record, got ${typeof value}`);
        return;
    }
    const v = value;
    if (typeof v.path !== "string" || v.path.length === 0) {
        issues.push(`${prefix}File.path must be a non-empty string`);
    }
    else if (v.path.includes("..") || v.path.startsWith("/") || /^[A-Za-z]:/.test(v.path)) {
        // Defensive: reject path-traversal and absolute paths so the
        // generated artifact can be safely written to a sandbox dir.
        issues.push(`${prefix}File.path must be a relative path without ".." segments`);
    }
    if (typeof v.content !== "string") {
        issues.push(`${prefix}File.content must be a string`);
    }
    else if (v.content.length === 0) {
        issues.push(`${prefix}File.content is empty`);
    }
    if (v.kind !== undefined && typeof v.kind !== "string") {
        issues.push(`${prefix}File.kind must be a string when present`);
    }
}
function finalize(issues, kind) {
    if (issues.length > 0) {
        (0, metrics_1.counter)("cognition.validate.failed", { mode: "schema_only", kind });