@ztothez/design-engineering 2.0.0

package/dist/src/portfolio/registry.js

@@ -0,0 +1,240 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { ZodError } from "zod";
+import { containsPrunedDirectory, isContained, isCustomExcluded, portablePath, } from "./files.js";
+import { loadPortfolioRegistry } from "./loader.js";
+const REPORT_VERSION = "1.0.0";
+const DISCOVERY_MARKERS = new Set([
+    "Cargo.toml",
+    "composer.json",
+    "go.mod",
+    "package.json",
+    "pyproject.toml",
+    "requirements.txt",
+]);
+function issue(code, path, message, severity = "error") {
+    return { code, severity, path, message };
+}
+function relationIsNested(left, right) {
+    return left !== right && (isContained(left, right) || isContained(right, left));
+}
+function emptyCounts() {
+    return { roots: 0, projects: 0, enabled: 0, development: 0, holdout: 0, excluded: 0 };
+}
+export async function inspectPortfolioRegistry(path) {
+    const issues = [];
+    let registry;
+    try {
+        registry = await loadPortfolioRegistry(path);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            for (const entry of error.issues) {
+                issues.push(issue("PORTFOLIO-SCHEMA", entry.path.map(String).join("."), entry.message));
+            }
+        }
+        else {
+            issues.push(issue("PORTFOLIO-PARSE", "registry", error instanceof Error ? error.message : String(error)));
+        }
+    }
+    if (!registry) {
+        return {
+            report: {
+                version: REPORT_VERSION,
+                generatedAt: new Date().toISOString(),
+                counts: emptyCounts(),
+                projects: [],
+                issues,
+                passed: false,
+            },
+            roots: [],
+            projects: [],
+        };
+    }
+    const roots = [];
+    for (const [index, root] of registry.roots.entries()) {
+        const field = `roots.${index}.path`;
+        if (!isAbsolute(root.path)) {
+            issues.push(issue("PORTFOLIO-ROOT-PATH", field, "Local root paths must be absolute."));
+            continue;
+        }
+        try {
+            const canonicalPath = await realpath(root.path);
+            const stats = await lstat(canonicalPath);
+            if (!stats.isDirectory()) {
+                issues.push(issue("PORTFOLIO-ROOT-TYPE", field, "Portfolio roots must resolve to directories."));
+                continue;
+            }
+            roots.push({ declaration: root, canonicalPath });
+        }
+        catch (error) {
+            issues.push(issue("PORTFOLIO-ROOT-MISSING", field, `Portfolio root is unavailable: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    for (let left = 0; left < roots.length; left += 1) {
+        for (let right = left + 1; right < roots.length; right += 1) {
+            const first = roots[left];
+            const second = roots[right];
+            if (first.canonicalPath === second.canonicalPath || relationIsNested(first.canonicalPath, second.canonicalPath)) {
+                issues.push(issue("PORTFOLIO-DUPLICATE-ROOT", "roots", `Roots ${first.declaration.id} and ${second.declaration.id} resolve to duplicate or nested locations.`));
+            }
+        }
+    }
+    const rootById = new Map(roots.map((root) => [root.declaration.id, root]));
+    const projects = [];
+    for (const [index, project] of registry.projects.entries()) {
+        const field = `projects.${index}.path`;
+        const root = rootById.get(project.root);
+        if (!root)
+            continue;
+        if (project.enabled && ["third-party-reference", "unknown"].includes(project.ownership)) {
+            issues.push(issue("PORTFOLIO-OWNERSHIP", `projects.${index}.ownership`, "Third-party or unknown-origin projects cannot be enabled for portfolio benchmarking."));
+        }
+        if (project.confidentiality === "private-local" &&
+            (project.publication.sourceExcerpts || project.publication.screenshots || project.publication.machineReports)) {
+            issues.push(issue("PORTFOLIO-PUBLICATION", `projects.${index}.publication`, "Private-local projects cannot publish source excerpts, screenshots, or machine reports."));
+        }
+        if (project.ownership === "client-authorized" &&
+            (project.publication.sourceExcerpts || project.publication.screenshots || project.publication.machineReports)) {
+            issues.push(issue("PORTFOLIO-CLIENT-PUBLICATION", `projects.${index}.publication`, "Client projects default to zero publishable raw artifacts."));
+        }
+        const lexicalPath = resolve(root.canonicalPath, project.path);
+        if (!isContained(root.canonicalPath, lexicalPath)) {
+            issues.push(issue("PORTFOLIO-PROJECT-ESCAPE", field, "Project path resolves outside its approved root."));
+            continue;
+        }
+        try {
+            const canonicalPath = await realpath(lexicalPath);
+            const stats = await lstat(canonicalPath);
+            if (!stats.isDirectory()) {
+                issues.push(issue("PORTFOLIO-PROJECT-TYPE", field, "Project paths must resolve to directories."));
+                continue;
+            }
+            if (!isContained(root.canonicalPath, canonicalPath)) {
+                issues.push(issue("PORTFOLIO-PROJECT-ESCAPE", field, "Project real path escapes its approved root."));
+                continue;
+            }
+            const entrypoint = resolve(canonicalPath, project.technology.entrypoint);
+            if (!isContained(canonicalPath, entrypoint)) {
+                issues.push(issue("PORTFOLIO-ENTRYPOINT-ESCAPE", `projects.${index}.technology.entrypoint`, "Entrypoint resolves outside the project root."));
+            }
+            else {
+                try {
+                    const entryStats = await lstat(entrypoint);
+                    if (!entryStats.isFile())
+                        throw new Error("not a regular file");
+                }
+                catch {
+                    issues.push(issue("PORTFOLIO-ENTRYPOINT-MISSING", `projects.${index}.technology.entrypoint`, `Declared entrypoint is unavailable: ${project.technology.entrypoint}.`));
+                }
+            }
+            projects.push({ declaration: project, root, canonicalPath });
+        }
+        catch (error) {
+            issues.push(issue("PORTFOLIO-PROJECT-MISSING", field, `Project is unavailable: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    for (let left = 0; left < projects.length; left += 1) {
+        for (let right = left + 1; right < projects.length; right += 1) {
+            const first = projects[left];
+            const second = projects[right];
+            if (first.canonicalPath === second.canonicalPath || relationIsNested(first.canonicalPath, second.canonicalPath)) {
+                issues.push(issue("PORTFOLIO-DUPLICATE-PROJECT", "projects", `Projects ${first.declaration.id} and ${second.declaration.id} resolve to duplicate or nested locations.`));
+            }
+        }
+    }
+    const resolvedIds = new Set(projects.map((project) => project.declaration.id));
+    const reportProjects = registry.projects.map((project) => ({
+        id: project.id,
+        root: project.root,
+        rootClass: registry.roots.find((root) => root.id === project.root)?.class,
+        enabled: project.enabled,
+        cohort: project.cohort,
+        ownership: project.ownership,
+        confidentiality: project.confidentiality,
+        resolved: resolvedIds.has(project.id),
+    }));
+    const counts = {
+        roots: registry.roots.length,
+        projects: registry.projects.length,
+        enabled: registry.projects.filter((project) => project.enabled).length,
+        development: registry.projects.filter((project) => project.cohort === "development").length,
+        holdout: registry.projects.filter((project) => project.cohort === "holdout").length,
+        excluded: registry.projects.filter((project) => project.cohort === "excluded").length,
+    };
+    const report = {
+        version: REPORT_VERSION,
+        generatedAt: new Date().toISOString(),
+        registryId: registry.id,
+        counts,
+        projects: reportProjects,
+        issues,
+        passed: !issues.some((entry) => entry.severity === "error"),
+    };
+    return { report, registry, roots, projects };
+}
+export async function discoverPortfolioCandidates(inspection) {
+    const candidateMap = new Map();
+    const issues = [...inspection.report.issues];
+    for (const root of inspection.roots) {
+        let directoriesVisited = 0;
+        const walk = async (directory, depth) => {
+            directoriesVisited += 1;
+            if (directoriesVisited > 50_000) {
+                issues.push(issue("PORTFOLIO-INVENTORY-LIMIT", root.declaration.id, "Discovery stopped after 50,000 directories."));
+                return;
+            }
+            const entries = (await readdir(directory, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name));
+            const markerNames = entries
+                .filter((entry) => entry.isFile() && DISCOVERY_MARKERS.has(entry.name))
+                .map((entry) => entry.name);
+            if (markerNames.length > 0) {
+                const relativeDirectory = portablePath(relative(root.canonicalPath, directory)) || ".";
+                const registeredProject = inspection.projects.find((project) => isContained(project.canonicalPath, directory));
+                candidateMap.set(`${root.declaration.id}:${relativeDirectory}`, {
+                    root: root.declaration.id,
+                    rootClass: root.declaration.class,
+                    path: relativeDirectory,
+                    markers: markerNames,
+                    ...(registeredProject ? { registeredProject: registeredProject.declaration.id } : {}),
+                });
+            }
+            if (depth >= root.declaration.discoveryDepth)
+                return;
+            for (const entry of entries) {
+                if (!entry.isDirectory() || entry.isSymbolicLink())
+                    continue;
+                const child = join(directory, entry.name);
+                const relativeChild = portablePath(relative(root.canonicalPath, child));
+                if (containsPrunedDirectory(relativeChild) ||
+                    isCustomExcluded(relativeChild, root.declaration.excludes)) {
+                    continue;
+                }
+                await walk(child, depth + 1);
+            }
+        };
+        try {
+            await walk(root.canonicalPath, 0);
+        }
+        catch (error) {
+            issues.push(issue("PORTFOLIO-INVENTORY-READ", root.declaration.id, error instanceof Error ? error.message : String(error)));
+        }
+    }
+    return {
+        version: REPORT_VERSION,
+        generatedAt: new Date().toISOString(),
+        ...(inspection.registry ? { registryId: inspection.registry.id } : {}),
+        candidates: [...candidateMap.values()].sort((left, right) => left.root.localeCompare(right.root) || left.path.localeCompare(right.path)),
+        issues,
+        passed: !issues.some((entry) => entry.severity === "error"),
+    };
+}
+export function projectById(inspection, projectId) {
+    const project = inspection.projects.find((entry) => entry.declaration.id === projectId);
+    if (!project)
+        throw new Error(`Portfolio project is unavailable or unregistered: ${projectId}`);
+    if (!project.declaration.enabled)
+        throw new Error(`Portfolio project is disabled: ${projectId}`);
+    return project;
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/portfolio/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/portfolio/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AASpD,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,cAAc;IACd,gBAAgB;IAChB,kBAAkB;CACnB,CAAC,CAAC;AAqCH,SAAS,KAAK,CACZ,IAAY,EACZ,IAAY,EACZ,OAAe,EACf,WAAuC,OAAO;IAE9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACzD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,QAAuC,CAAC;IAE5C,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5G,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE;gBACN,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,MAAM,EAAE,WAAW,EAAE;gBACrB,QAAQ,EAAE,EAAE;gBACZ,MAAM;gBACN,MAAM,EAAE,KAAK;aACd;YACD,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,SAAS,KAAK,OAAO,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,EAAE,oCAAoC,CAAC,CAAC,CAAC;YACvF,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC,CAAC;gBACjG,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,KAAK,CACH,wBAAwB,EACxB,KAAK,EACL,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3F,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAClD,KAAK,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,IAAI,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChH,MAAM,CAAC,IAAI,CACT,KAAK,CACH,0BAA0B,EAC1B,OAAO,EACP,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,QAAQ,MAAM,CAAC,WAAW,CAAC,EAAE,4CAA4C,CACvG,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,YAAY,KAAK,OAAO,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CACT,KAAK,CACH,qBAAqB,EACrB,YAAY,KAAK,YAAY,EAC7B,sFAAsF,CACvF,CACF,CAAC;QACJ,CAAC;QACD,IACE,OAAO,CAAC,eAAe,KAAK,eAAe;YAC3C,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAC7G,CAAC;YACD,MAAM,CAAC,IAAI,CACT,KAAK,CACH,uBAAuB,EACvB,YAAY,KAAK,cAAc,EAC/B,yFAAyF,CAC1F,CACF,CAAC;QACJ,CAAC;QACD,IACE,OAAO,CAAC,SAAS,KAAK,mBAAmB;YACzC,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAC7G,CAAC;YACD,MAAM,CAAC,IAAI,CACT,KAAK,CACH,8BAA8B,EAC9B,YAAY,KAAK,cAAc,EAC/B,4DAA4D,CAC7D,CACF,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,EAAE,kDAAkD,CAAC,CAAC,CAAC;YAC1G,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,4CAA4C,CAAC,CAAC,CAAC;gBAClG,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC,CAAC;gBACtG,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACzE,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CACT,KAAK,CACH,6BAA6B,EAC7B,YAAY,KAAK,wBAAwB,EACzC,+CAA+C,CAChD,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC3C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBAClE,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,IAAI,CACT,KAAK,CACH,8BAA8B,EAC9B,YAAY,KAAK,wBAAwB,EACzC,uCAAuC,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,CACxE,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,KAAK,CACH,2BAA2B,EAC3B,KAAK,EACL,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACpF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,KAAK,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;YAChC,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,IAAI,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChH,MAAM,CAAC,IAAI,CACT,KAAK,CACH,6BAA6B,EAC7B,UAAU,EACV,YAAY,KAAK,CAAC,WAAW,CAAC,EAAE,QAAQ,MAAM,CAAC,WAAW,CAAC,EAAE,4CAA4C,CAC1G,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzD,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK;QACzE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;KACtC,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;QAClC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM;QACtE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;QAC3F,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACnF,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM;KACtF,CAAC;IAEF,MAAM,MAAM,GAA4B;QACtC,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,MAAM;QACN,QAAQ,EAAE,cAAc;QACxB,MAAM;QACN,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;KAC5D,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAuC;IAEvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,EAAE,SAAiB,EAAE,KAAa,EAAiB,EAAE;YACrE,kBAAkB,IAAI,CAAC,CAAC;YACxB,IAAI,kBAAkB,GAAG,MAAM,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CACT,KAAK,CACH,2BAA2B,EAC3B,IAAI,CAAC,WAAW,CAAC,EAAE,EACnB,6CAA6C,CAC9C,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACvF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CACpC,CAAC;YACF,MAAM,WAAW,GAAG,OAAO;iBACxB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;iBACtE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,iBAAiB,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,IAAI,GAAG,CAAC;gBACvF,MAAM,iBAAiB,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7D,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAC9C,CAAC;gBACF,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,iBAAiB,EAAE,EAAE;oBAC9D,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE;oBACzB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;oBACjC,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,WAAW;oBACpB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtF,CAAC,CAAC;YACL,CAAC;YACD,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,cAAc;gBAAE,OAAO;YACrD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE;oBAAE,SAAS;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;gBACxE,IACE,uBAAuB,CAAC,aAAa,CAAC;oBACtC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAC1D,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,KAAK,CACH,0BAA0B,EAC1B,IAAI,CAAC,WAAW,CAAC,EAAE,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,UAAU,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAC5F;QACD,MAAM;QACN,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,UAAuC,EACvC,SAAiB;IAEjB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACxF,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,SAAS,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/portfolio/report.d.ts

@@ -0,0 +1,4 @@
+import type { PortfolioInventoryReport } from "./registry.js";
+import type { PortfolioRegistryReport } from "./schema.js";
+export declare function formatPortfolioRegistryReport(report: PortfolioRegistryReport): string;
+export declare function formatPortfolioInventoryReport(report: PortfolioInventoryReport): string;

package/dist/src/portfolio/report.js

@@ -0,0 +1,47 @@
+export function formatPortfolioRegistryReport(report) {
+    const lines = [
+        "# Portfolio Registry",
+        "",
+        `- Registry: ${report.registryId ?? "unavailable"}`,
+        `- Roots: ${report.counts.roots}`,
+        `- Projects: ${report.counts.projects}; ${report.counts.enabled} enabled`,
+        `- Cohorts: ${report.counts.development} development, ${report.counts.holdout} holdout, ${report.counts.excluded} excluded`,
+        `- Result: ${report.passed ? "PASS" : "FAIL"}`,
+        "",
+        "## Projects",
+        "",
+    ];
+    if (report.projects.length === 0)
+        lines.push("- None");
+    for (const project of report.projects) {
+        lines.push(`- \`${project.id}\`: ${project.enabled ? "enabled" : "disabled"}; ${project.cohort}; ${project.ownership}; ${project.confidentiality}; ${project.resolved ? "resolved" : "unresolved"}`);
+    }
+    lines.push("", "## Issues", "");
+    if (report.issues.length === 0)
+        lines.push("- None");
+    for (const entry of report.issues) {
+        lines.push(`- ${entry.severity.toUpperCase()} \`${entry.code}\` at \`${entry.path}\`: ${entry.message}`);
+    }
+    return lines.join("\n").trimEnd();
+}
+export function formatPortfolioInventoryReport(report) {
+    const lines = [
+        "# Portfolio Inventory",
+        "",
+        `- Registry: ${report.registryId ?? "unavailable"}`,
+        `- Candidates: ${report.candidates.length}`,
+        `- Result: ${report.passed ? "PASS" : "FAIL"}`,
+        "",
+    ];
+    for (const candidate of report.candidates) {
+        lines.push(`- \`${candidate.root}:${candidate.path}\`: ${candidate.markers.join(", ")}${candidate.registeredProject ? `; registered as \`${candidate.registeredProject}\`` : "; unregistered"}`);
+    }
+    if (report.issues.length > 0) {
+        lines.push("", "## Issues", "");
+        for (const entry of report.issues) {
+            lines.push(`- ${entry.severity.toUpperCase()} \`${entry.code}\` at \`${entry.path}\`: ${entry.message}`);
+        }
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=report.js.map

package/dist/src/portfolio/report.js.map

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

package/dist/src/portfolio/run-schema.d.ts

@@ -0,0 +1,135 @@
+import { z } from "zod";
+export declare const portfolioBenchmarkReportSchema: z.ZodObject<{
+    version: z.ZodEnum<{
+        "1.0.0": "1.0.0";
+        "1.1.0": "1.1.0";
+        "1.2.0": "1.2.0";
+    }>;
+    toolVersion: z.ZodString;
+    runId: z.ZodString;
+    mode: z.ZodEnum<{
+        baseline: "baseline";
+        cohort: "cohort";
+    }>;
+    registryId: z.ZodString;
+    registryDigest: z.ZodString;
+    cohort: z.ZodOptional<z.ZodEnum<{
+        development: "development";
+        holdout: "holdout";
+    }>>;
+    projectIds: z.ZodArray<z.ZodString>;
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    projects: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        cohort: z.ZodEnum<{
+            development: "development";
+            holdout: "holdout";
+        }>;
+        adapter: z.ZodOptional<z.ZodString>;
+        sourceDigest: z.ZodOptional<z.ZodString>;
+        sourceRevision: z.ZodOptional<z.ZodString>;
+        environmentPolicy: z.ZodObject<{
+            network: z.ZodString;
+            lifecycleScripts: z.ZodBoolean;
+            environmentVariables: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        commands: z.ZodArray<z.ZodObject<{
+            stage: z.ZodString;
+            command: z.ZodString;
+            arguments: z.ZodArray<z.ZodString>;
+            cwd: z.ZodString;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxOutputBytes: z.ZodDefault<z.ZodNumber>;
+            allowDependencyNetwork: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        startedAt: z.ZodString;
+        completedAt: z.ZodString;
+        stages: z.ZodArray<z.ZodObject<{
+            stage: z.ZodString;
+            status: z.ZodEnum<{
+                passed: "passed";
+                "not-applicable": "not-applicable";
+                failed: "failed";
+                unsupported: "unsupported";
+                "timed-out": "timed-out";
+            }>;
+            reason: z.ZodString;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            audit: z.ZodOptional<z.ZodObject<{
+                filesScanned: z.ZodNumber;
+                errors: z.ZodNumber;
+                warnings: z.ZodNumber;
+                info: z.ZodNumber;
+            }, z.core.$strip>>;
+            findings: z.ZodOptional<z.ZodNumber>;
+            limitations: z.ZodOptional<z.ZodNumber>;
+            findingDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                id: z.ZodString;
+                severity: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strip>>>;
+            limitationDetails: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            viewports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>>;
+            fixture: z.ZodOptional<z.ZodObject<{
+                state: z.ZodEnum<{
+                    ready: "ready";
+                    stopped: "stopped";
+                }>;
+                port: z.ZodNumber;
+                route: z.ZodString;
+                directory: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        artifacts: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            kind: z.ZodEnum<{
+                screenshot: "screenshot";
+                download: "download";
+                report: "report";
+                log: "log";
+                other: "other";
+            }>;
+            bytes: z.ZodNumber;
+            sha256: z.ZodString;
+            evidenceClass: z.ZodOptional<z.ZodEnum<{
+                "private-raw": "private-raw";
+                "redacted-report": "redacted-report";
+                "approved-screenshot": "approved-screenshot";
+                "public-synthetic": "public-synthetic";
+                "aggregate-metrics": "aggregate-metrics";
+            }>>;
+            policyDecision: z.ZodOptional<z.ZodEnum<{
+                "public-synthetic": "public-synthetic";
+                "retained-by-policy": "retained-by-policy";
+                "redacted-machine-path": "redacted-machine-path";
+                "screenshot-opt-in-approved": "screenshot-opt-in-approved";
+                "screenshot-disabled-by-policy": "screenshot-disabled-by-policy";
+            }>>;
+            sourceDigest: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            findings: "findings";
+            passed: "passed";
+            limitations: "limitations";
+            "unsafe-configuration": "unsafe-configuration";
+            "source-mutation": "source-mutation";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        passed: z.ZodNumber;
+        findings: z.ZodNumber;
+        limitations: z.ZodNumber;
+        unsafeConfiguration: z.ZodNumber;
+        sourceMutation: z.ZodNumber;
+    }, z.core.$strip>;
+    resultFingerprint: z.ZodString;
+    passed: z.ZodBoolean;
+}, z.core.$strip>;

package/dist/src/portfolio/run-schema.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+const stageSchema = z.object({
+    stage: z.string().min(1),
+    status: z.enum(["passed", "failed", "timed-out", "unsupported", "not-applicable"]),
+    reason: z.string(),
+    durationMs: z.number().nonnegative().optional(),
+    exitCode: z.number().int().nullable().optional(),
+    audit: z.object({ filesScanned: z.number().int().nonnegative(), errors: z.number().int().nonnegative(), warnings: z.number().int().nonnegative(), info: z.number().int().nonnegative() }).optional(),
+    findings: z.number().int().nonnegative().optional(),
+    limitations: z.number().int().nonnegative().optional(),
+    findingDetails: z.array(z.object({ source: z.string(), id: z.string(), severity: z.string(), message: z.string() })).optional(),
+    limitationDetails: z.array(z.string()).optional(),
+    viewports: z.array(z.object({ name: z.string(), width: z.number().int().positive(), height: z.number().int().positive() })).optional(),
+    fixture: z.object({ state: z.enum(["ready", "stopped"]), port: z.number().int().positive(), route: z.string(), directory: z.string() }).optional(),
+});
+const artifactSchema = z.object({
+    path: z.string().min(1),
+    kind: z.enum(["report", "screenshot", "download", "other", "log"]),
+    bytes: z.number().int().nonnegative(),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+    evidenceClass: z.enum([
+        "private-raw",
+        "redacted-report",
+        "approved-screenshot",
+        "public-synthetic",
+        "aggregate-metrics",
+    ]).optional(),
+    policyDecision: z.enum([
+        "retained-by-policy",
+        "redacted-machine-path",
+        "screenshot-opt-in-approved",
+        "screenshot-disabled-by-policy",
+        "public-synthetic",
+    ]).optional(),
+    sourceDigest: z.string().optional(),
+});
+const summarySchema = z.object({
+    passed: z.number().int().nonnegative(),
+    findings: z.number().int().nonnegative(),
+    limitations: z.number().int().nonnegative(),
+    unsafeConfiguration: z.number().int().nonnegative(),
+    sourceMutation: z.number().int().nonnegative(),
+});
+export const portfolioBenchmarkReportSchema = z.object({
+    version: z.enum(["1.0.0", "1.1.0", "1.2.0"]),
+    toolVersion: z.string(),
+    runId: z.string().regex(/^[a-z0-9][a-z0-9._-]{0,127}$/i),
+    mode: z.enum(["baseline", "cohort"]),
+    registryId: z.string(),
+    registryDigest: z.string(),
+    cohort: z.enum(["development", "holdout"]).optional(),
+    projectIds: z.array(z.string()),
+    startedAt: z.string().datetime(),
+    completedAt: z.string().datetime(),
+    projects: z.array(z.object({
+        projectId: z.string(),
+        cohort: z.enum(["development", "holdout"]),
+        adapter: z.string().optional(),
+        sourceDigest: z.string().optional(),
+        sourceRevision: z.string().optional(),
+        environmentPolicy: z.object({ network: z.string(), lifecycleScripts: z.boolean(), environmentVariables: z.array(z.string()) }),
+        commands: z.array(z.object({ stage: z.string(), command: z.string(), arguments: z.array(z.string()), cwd: z.string(), timeoutMs: z.number().int().positive().default(120_000), maxOutputBytes: z.number().int().positive().default(2 * 1024 * 1024), allowDependencyNetwork: z.boolean().default(false) })),
+        startedAt: z.string().datetime(),
+        completedAt: z.string().datetime(),
+        stages: z.array(stageSchema),
+        artifacts: z.array(artifactSchema),
+        status: z.enum(["passed", "findings", "limitations", "unsafe-configuration", "source-mutation"]),
+        message: z.string().optional(),
+    })),
+    summary: summarySchema,
+    resultFingerprint: z.string(),
+    passed: z.boolean(),
+}).superRefine((report, context) => {
+    if (report.projectIds.length !== report.projects.length || report.projectIds.some((id, index) => id !== report.projects[index]?.projectId)) {
+        context.addIssue({ code: "custom", path: ["projectIds"], message: "Project IDs must match ordered project reports." });
+    }
+    if (Object.values(report.summary).reduce((sum, count) => sum + count, 0) !== report.projects.length) {
+        context.addIssue({ code: "custom", path: ["summary"], message: "Summary counts must equal project count." });
+    }
+});
+//# sourceMappingURL=run-schema.js.map

package/dist/src/portfolio/run-schema.js.map

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