@lesliechan721/aw 0.1.0-beta.3

package/dist/scripts/plugin-staging.js

@@ -0,0 +1,196 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+export { bundleLocalPlugin, prepareLocalPluginBundleSource, } from '../src/generators/local-plugin.js';
+export { createCatalogRuntimeImportResolver, } from '../src/utils/catalog-runtime-projection.js';
+export { buildLifecycleSpawnEnv, calculateFileDigest, collectSensitivePluginConfigValues, redactPluginScriptOutput, } from '../src/utils/plugin-scripts.js';
+export { coercePluginConfigValue, resolveEffectivePluginConfig, resolvePluginConfigStorePath, } from '../src/utils/plugin-config.js';
+export { compareStrictSemVer, createMarketplaceManifestEntry, discoverPlugins, normalizeManifestDigestInput, readPluginManifest, resolvePluginsFromCatalog, } from '../src/utils/manifest.js';
+export { appendCatalogToPluginReleaseLedger, assertStablePluginVersion, mergePluginReleaseLedgers, PLUGIN_RELEASE_LEDGER_FILENAME, PLUGIN_RELEASE_LEDGER_SCHEMA_VERSION, resolveBetaPluginVersionOverrides, validatePluginReleaseLedgerAgainstManifest, validatePluginReleaseLedger, } from '../src/utils/plugin-release.js';
+export { scanJavaScriptImportSpecifiers, scanNodeImportContract, } from '../src/utils/plugin-script-contract.js';
+export { formatMarketplaceProductsForError, formatSupportedPlatforms, resolveSupportedPlatforms, } from '../src/utils/platform-support.js';
+export { resolveAwHome, resolveCliPackageRoot, } from '../src/utils/paths.js';
+export { CATALOG_MANIFEST_FILENAME, } from '../src/utils/bundle-layout.js';
+import { CATALOG_MANIFEST_FILENAME, } from '../src/utils/bundle-layout.js';
+import { assertStrictSemVer, compareStrictSemVer, resolvePluginsFromCatalog, } from '../src/utils/manifest.js';
+import { calculateCatalogEntryContentDigest, } from '../src/utils/catalog-digests.js';
+import { createCatalogManifestV4, createCatalogManifestV4Entry, CATALOG_SCHEMA_4_CLI_FLOOR, validateCatalogManifestV4, } from '../src/utils/catalog-manifest-v4.js';
+import { validateCatalogSnapshot } from '../src/utils/catalog-snapshot.js';
+import { validatePluginMetaDependencyGraph } from '../src/utils/plugin-dependencies.js';
+import { readJsonFile } from '../src/utils/json.js';
+import { resolveCliPackageRoot } from '../src/utils/paths.js';
+import { appendCatalogToPluginReleaseLedger, assertStablePluginVersion, PLUGIN_RELEASE_LEDGER_FILENAME, PLUGIN_RELEASE_LEDGER_SCHEMA_VERSION, resolveBetaPluginVersionOverrides, validatePluginReleaseLedgerAgainstManifest, } from '../src/utils/plugin-release.js';
+export { CATALOG_SCHEMA_4_CLI_FLOOR };
+export const CATALOG_SCHEMA_3_CLI_FLOOR = CATALOG_SCHEMA_4_CLI_FLOOR;
+function detectCatalogChannel(version) {
+    return version.includes('-') ? 'beta' : 'latest';
+}
+function resolveCatalogMinAwVersion(plugins) {
+    let current = CATALOG_SCHEMA_4_CLI_FLOOR;
+    for (const plugin of plugins) {
+        const pluginMinVersion = plugin.manifest.compatibility.aw.minVersion;
+        if (compareStrictSemVer(pluginMinVersion, current) > 0) {
+            current = pluginMinVersion;
+        }
+    }
+    return current;
+}
+async function readCliPackageMetadata(repoRoot) {
+    const candidatePaths = [
+        path.join(repoRoot, 'packages', 'cli', 'package.json'),
+        path.join(repoRoot, 'package.json'),
+        path.join(resolveCliPackageRoot(), 'package.json'),
+    ];
+    let cliPackageJsonPath = candidatePaths[candidatePaths.length - 1];
+    for (const candidatePath of candidatePaths) {
+        if (await fs.pathExists(candidatePath)) {
+            cliPackageJsonPath = candidatePath;
+            break;
+        }
+    }
+    const packageJson = await readJsonFile(cliPackageJsonPath);
+    return {
+        version: assertStrictSemVer(packageJson.version, 'packages/cli/package.json version'),
+    };
+}
+async function writeCanonicalJsonFile(filePath, value) {
+    const content = `${JSON.stringify(value, null, 2)}\n`;
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf8');
+    return content;
+}
+async function rewriteBundledPluginVersions(outputRoot, overrides) {
+    for (const [pluginName, requestedVersion] of Object.entries(overrides)) {
+        const version = assertStrictSemVer(requestedVersion, `${pluginName} release version`);
+        const pluginRoot = path.join(outputRoot, 'plugins', pluginName);
+        if (!(await fs.pathExists(pluginRoot))) {
+            throw new Error(`Plugin version override refers to unknown plugin ${JSON.stringify(pluginName)}.`);
+        }
+        for (const relativePath of [
+            '.agents-plugin/plugin.json',
+            '.claude-plugin/plugin.json',
+            '.codex-plugin/plugin.json',
+        ]) {
+            const manifestPath = path.join(pluginRoot, relativePath);
+            if (!(await fs.pathExists(manifestPath)))
+                continue;
+            const manifest = await readJsonFile(manifestPath);
+            await writeCanonicalJsonFile(manifestPath, { ...manifest, version });
+        }
+    }
+}
+export async function stageCatalogArtifacts(options) {
+    const repoRoot = options.repoRoot ?? path.resolve(resolveCliPackageRoot(), '..', '..');
+    const phase = options.phase ?? 'development';
+    const [{ version }, sourcePlugins] = await Promise.all([
+        readCliPackageMetadata(repoRoot),
+        resolvePluginsFromCatalog(options.outputRoot),
+    ]);
+    validatePluginMetaDependencyGraph(sourcePlugins);
+    const catalogVersion = assertStrictSemVer(options.catalogVersion ?? version, 'catalog version');
+    const derivedChannel = detectCatalogChannel(catalogVersion);
+    const channel = options.channel ?? derivedChannel;
+    if (channel !== derivedChannel) {
+        throw new Error(`Catalog channel ${JSON.stringify(channel)} does not match catalog version ${catalogVersion}.`);
+    }
+    for (const plugin of sourcePlugins) {
+        assertStablePluginVersion(plugin.manifest.version, `${plugin.manifest.name} source version`);
+    }
+    const contentDigestEntries = await Promise.all(sourcePlugins.map(async (plugin) => [
+        plugin.manifest.name,
+        await calculateCatalogEntryContentDigest(path.join(options.outputRoot, 'plugins', plugin.manifest.name)),
+    ]));
+    const contentDigests = new Map(contentDigestEntries);
+    const previousReleaseLedger = options.previousReleaseLedger
+        ?? { schemaVersion: PLUGIN_RELEASE_LEDGER_SCHEMA_VERSION, records: [] };
+    if (phase === 'release') {
+        const overrides = options.pluginVersionOverrides ?? (channel === 'beta'
+            ? resolveBetaPluginVersionOverrides({
+                plugins: sourcePlugins,
+                contentDigests,
+                ledger: previousReleaseLedger,
+            })
+            : Object.fromEntries(sourcePlugins.map((plugin) => [
+                plugin.manifest.name, plugin.manifest.version,
+            ])));
+        if (options.pluginVersionOverrides) {
+            const expectedNames = sourcePlugins.map((plugin) => plugin.manifest.name).sort();
+            const actualNames = Object.keys(overrides).sort();
+            if (expectedNames.join('\0') !== actualNames.join('\0')) {
+                throw new Error('Plan plugin candidate overrides must cover the complete catalog inventory.');
+            }
+            for (const plugin of sourcePlugins) {
+                const candidateVersion = assertStrictSemVer(overrides[plugin.manifest.name], `${plugin.manifest.name} plan candidate version`);
+                const targetVersion = plugin.manifest.version;
+                if (candidateVersion !== targetVersion
+                    && !candidateVersion.startsWith(`${targetVersion}-beta.`))
+                    throw new Error(`Plan plugin candidate ${plugin.manifest.name}@${candidateVersion} does not match stable target ${targetVersion}.`);
+                const planned = options.pluginCandidates?.find((entry) => entry.name === plugin.manifest.name);
+                if (options.pluginCandidates && (!planned
+                    || planned.targetVersion !== targetVersion
+                    || planned.candidateVersion !== candidateVersion
+                    || planned.contentDigest !== contentDigests.get(plugin.manifest.name))) {
+                    throw new Error(`Plan plugin candidate ${plugin.manifest.name} does not match the staged target or content.`);
+                }
+                const stableSkipInBeta = channel === 'beta'
+                    && candidateVersion === targetVersion
+                    && planned?.action === 'skip';
+                if (stableSkipInBeta && !previousReleaseLedger.records.some((record) => record.plugin === plugin.manifest.name
+                    && record.version === targetVersion
+                    && record.contentDigest === contentDigests.get(plugin.manifest.name))) {
+                    throw new Error(`Stable skip candidate ${plugin.manifest.name}@${targetVersion} is not present in release history with the same content.`);
+                }
+                if ((channel === 'beta') !== candidateVersion.includes('-beta.') && !stableSkipInBeta) {
+                    throw new Error(`Plan plugin candidate ${plugin.manifest.name}@${candidateVersion} does not match catalog channel ${channel}.`);
+                }
+            }
+        }
+        await rewriteBundledPluginVersions(options.outputRoot, overrides);
+    }
+    const plugins = phase === 'release'
+        ? await resolvePluginsFromCatalog(options.outputRoot)
+        : sourcePlugins;
+    const minAwVersion = resolveCatalogMinAwVersion(plugins);
+    const entries = await Promise.all(plugins.map((plugin) => createCatalogManifestV4Entry(plugin, path.join(options.outputRoot, 'plugins', plugin.manifest.name))));
+    const marketplace = await readJsonFile(path.join(options.outputRoot, '.agents', 'plugins', 'marketplace.json'));
+    const manifest = createCatalogManifestV4({
+        catalogVersion,
+        channel,
+        marketplace: {
+            owner: marketplace.owner,
+            interface: marketplace.interface,
+        },
+        compatibility: {
+            aw: {
+                minVersion: minAwVersion,
+            },
+        },
+        release: options.release ?? { state: 'development' },
+        entries,
+    });
+    const releaseLedger = appendCatalogToPluginReleaseLedger({
+        previous: previousReleaseLedger,
+        manifest,
+        contentDigests,
+    });
+    const canonicalManifestPath = path.join(options.outputRoot, CATALOG_MANIFEST_FILENAME);
+    const releaseLedgerPath = path.join(options.outputRoot, PLUGIN_RELEASE_LEDGER_FILENAME);
+    await Promise.all([
+        fs.remove(path.join(options.outputRoot, '.catalog')),
+        fs.remove(releaseLedgerPath),
+    ]);
+    await writeCanonicalJsonFile(canonicalManifestPath, manifest);
+    if (manifest.release.state === 'published') {
+        await writeCanonicalJsonFile(releaseLedgerPath, releaseLedger);
+        validatePluginReleaseLedgerAgainstManifest(releaseLedger, manifest);
+    }
+    await validateCatalogSnapshot(options.outputRoot);
+    return {
+        manifest,
+        releaseLedger,
+        canonicalManifestPath,
+    };
+}
+export async function readStagedCatalogManifest(outputRoot) {
+    return validateCatalogManifestV4(await readJsonFile(path.join(outputRoot, CATALOG_MANIFEST_FILENAME)));
+}
+//# sourceMappingURL=plugin-staging.js.map

package/dist/scripts/plugin-staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-staging.js","sourceRoot":"","sources":["../../scripts/plugin-staging.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,mCAAmC,CAAC;AAQ3C,OAAO,EACL,kCAAkC,GACnC,MAAM,4CAA4C,CAAC;AAIpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,kCAAkC,EAClC,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,4BAA4B,EAC5B,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,EAC9B,oCAAoC,EACpC,iCAAiC,EACjC,0CAA0C,EAC1C,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iCAAiC,EACjC,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,aAAa,EACb,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kCAAkC,GACnC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kCAAkC,EAClC,yBAAyB,EAEzB,8BAA8B,EAC9B,oCAAoC,EACpC,iCAAiC,EACjC,0CAA0C,GAC3C,MAAM,gCAAgC,CAAC;AAmCxC,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAErE,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnD,CAAC;AAED,SAAS,0BAA0B,CAAC,OAA8B;IAChE,IAAI,OAAO,GAAG,0BAA0B,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAc,CAAC,EAAE,CAAC,UAAU,CAAC;QACtE,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,GAAG,gBAAgB,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,QAAgB;IAEhB,MAAM,cAAc,GAAG;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,cAAc,CAAC;KACnD,CAAC;IACF,IAAI,kBAAkB,GAAG,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACvC,kBAAkB,GAAG,aAAa,CAAC;YACnC,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,YAAY,CAA0B,kBAAkB,CAAC,CAAC;IACpF,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,WAAW,CAAC,OAAO,EAAE,mCAAmC,CAAC;KACtF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,QAAgB,EAAE,KAAc;IACpE,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,KAAK,UAAU,4BAA4B,CACzC,UAAkB,EAClB,SAA2C;IAE3C,KAAK,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,GAAG,UAAU,kBAAkB,CAAC,CAAC;QACtF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrG,CAAC;QACD,KAAK,MAAM,YAAY,IAAI;YACzB,4BAA4B;YAC5B,4BAA4B;YAC5B,2BAA2B;SAC5B,EAAE,CAAC;YACF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACzD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;gBAAE,SAAS;YACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAA0B,YAAY,CAAC,CAAC;YAC3E,MAAM,sBAAsB,CAAC,YAAY,EAAE,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA4B;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,sBAAsB,CAAC,QAAQ,CAAC;QAChC,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC;KAC9C,CAAC,CAAC;IACH,iCAAiC,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,kBAAkB,CACvC,OAAO,CAAC,cAAc,IAAI,OAAO,EACjC,iBAAiB,CAClB,CAAC;IACF,MAAM,cAAc,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAClD,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,mCAAmC,cAAc,GAAG,CAC/F,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,yBAAyB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;QACjF,MAAM,CAAC,QAAQ,CAAC,IAAI;QACpB,MAAM,kCAAkC,CACtC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC/D;KACO,CAAC,CAAC,CAAC;IACb,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,qBAAqB,GAAwB,OAAO,CAAC,qBAAqB;WAC3E,EAAE,aAAa,EAAE,oCAAoC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,OAAO,CAAC,sBAAsB,IAAI,CAAC,OAAO,KAAK,MAAM;YACrE,CAAC,CAAC,iCAAiC,CAAC;gBAChC,OAAO,EAAE,aAAa;gBACtB,cAAc;gBACd,MAAM,EAAE,qBAAqB;aAC9B,CAAC;YACJ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC/C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;aAC9C,CAAC,CAAC,CAAC,CAAC;QACT,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;YACnC,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACjF,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;YAChG,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,MAAM,gBAAgB,GAAG,kBAAkB,CACzC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/B,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,yBAAyB,CACjD,CAAC;gBACF,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC9C,IACE,gBAAgB,KAAK,aAAa;uBAC/B,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,aAAa,QAAQ,CAAC;oBACzD,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,gBAAgB,iCAAiC,aAAa,GAAG,CAAC,CAAC;gBACtI,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC/F,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAC9B,CAAC,OAAO;uBACL,OAAO,CAAC,aAAa,KAAK,aAAa;uBACvC,OAAO,CAAC,gBAAgB,KAAK,gBAAgB;uBAC7C,OAAO,CAAC,aAAa,KAAK,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtE,EAAE,CAAC;oBACF,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,+CAA+C,CAAC,CAAC;gBAChH,CAAC;gBACD,MAAM,gBAAgB,GAAG,OAAO,KAAK,MAAM;uBACtC,gBAAgB,KAAK,aAAa;uBAClC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;gBAChC,IAAI,gBAAgB,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACrE,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI;uBACnC,MAAM,CAAC,OAAO,KAAK,aAAa;uBAChC,MAAM,CAAC,aAAa,KAAK,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;oBACxE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,aAAa,2DAA2D,CAAC,CAAC;gBAC7I,CAAC;gBACD,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtF,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,gBAAgB,mCAAmC,OAAO,GAAG,CAAC,CAAC;gBAClI,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,4BAA4B,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS;QACjC,CAAC,CAAC,MAAM,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC;QACrD,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,YAAY,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACvD,4BAA4B,CAC1B,MAAM,EACN,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC/D,CAAC,CAAC,CAAC;IACN,MAAM,WAAW,GAAG,MAAM,YAAY,CACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,CAAC,CACxE,CAAC;IACF,MAAM,QAAQ,GAAG,uBAAuB,CAAC;QACvC,cAAc;QACd,OAAO;QACP,WAAW,EAAE;YACX,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,SAAS,EAAE,WAAW,CAAC,SAAS;SACjC;QACD,aAAa,EAAE;YACb,EAAE,EAAE;gBACF,UAAU,EAAE,YAAY;aACzB;SACF;QACD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE;QACpD,OAAO;KACR,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,kCAAkC,CAAC;QACvD,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ;QACR,cAAc;KACf,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IACvF,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;IACxF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACpD,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC;KAC7B,CAAC,CAAC;IACH,MAAM,sBAAsB,CAC1B,qBAAqB,EACrB,QAAQ,CACT,CAAC;IACF,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC3C,MAAM,sBAAsB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;QAC/D,0CAA0C,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAElD,OAAO;QACL,QAAQ;QACR,aAAa;QACb,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAAkB;IAElB,OAAO,yBAAyB,CAC9B,MAAM,YAAY,CAAU,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC,CAC9E,CAAC;AACJ,CAAC"}

package/dist/scripts/skill-reporting.d.ts

@@ -0,0 +1,212 @@
+export type SkillReportOwner = {
+    kind: 'plugin-skill';
+    plugin: string;
+    skill: string;
+} | {
+    kind: 'static-skill';
+    skill: string;
+};
+export interface SkillReportSourceIdentity {
+    digest: string;
+    gitHead: string | null;
+    gitHeads?: string[];
+    inScopeDirty: boolean;
+}
+export type SkillReportTargetCompositions = Record<string, string[]>;
+export interface SkillEvalRunLayout {
+    batchId: string;
+    batchRoot: string;
+    reportBoundaryRoot: string;
+    runId: string;
+    workRoot: string;
+    reportRoot: string;
+    rawRoot: string;
+    startedAt: string;
+    pid: number;
+    host: string;
+    cleanupWork(): Promise<void>;
+}
+interface EvaluationSubjectLike {
+    profile: string;
+    scope: string;
+    configDigest?: string;
+    bundleDigest?: string;
+    contentDigest?: string;
+    artifacts?: Array<{
+        kind: string;
+        key?: string;
+        contentDigest: string;
+    }>;
+}
+interface EvaluationSuiteLike {
+    id: string;
+    kind: 'trigger' | 'conversation' | 'command';
+    profile?: string;
+    split?: string | null;
+    outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete';
+    complete: boolean;
+    mechanicalPassed: boolean;
+    qualitativeReview?: string;
+    reportPath?: string;
+    caseResults?: Array<{
+        id: string;
+        outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete';
+        complete: boolean;
+        mechanicalPassed: boolean;
+        qualitativeReview?: string;
+        reportPath?: string;
+        sourceRunId?: string;
+        reused?: boolean;
+        summary?: Record<string, unknown>;
+        diagnostics?: string[];
+    }>;
+    summary?: Record<string, unknown>;
+    diagnostics?: string[];
+}
+export interface EvaluationLike {
+    generatedAt: string;
+    outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete';
+    complete: boolean;
+    mechanicalPassed: boolean;
+    subjects: EvaluationSubjectLike[];
+    suites: EvaluationSuiteLike[];
+    diagnostics: string[];
+    model?: string | null;
+    modelProvider?: string | null;
+    codexVersion?: string | null;
+}
+export interface SkillEvalTargetSummary {
+    schemaVersion: 1;
+    target: string;
+    kind: 'materialization' | 'trigger' | 'conversation' | 'command';
+    runId: string;
+    generatedAt: string;
+    profile: string;
+    suite: string | null;
+    split: string;
+    case: string;
+    outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete';
+    complete: boolean;
+    mechanicalPassed: boolean;
+    qualitativeReview: string;
+    requiredForRelease: boolean;
+    reportPath: string | null;
+    summary: Record<string, unknown>;
+    diagnostics: string[];
+}
+type TargetSummary = SkillEvalTargetSummary;
+export interface SkillEvalTargetPlan {
+    pending: string[];
+    reusable: SkillEvalTargetSummary[];
+}
+interface RunSummary {
+    runId: string;
+    status: 'running' | 'completed' | 'failed';
+    completedAt: string | null;
+    outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete' | null;
+    complete: boolean;
+    mechanicalPassed: boolean;
+    reportPath: string;
+}
+interface BatchSummary {
+    schemaVersion: 1;
+    batchId: string;
+    name: string;
+    owner: SkillReportOwner;
+    createdAt: string;
+    updatedAt: string;
+    latestCompletedAt: string | null;
+    source: SkillReportSourceIdentity;
+    eval: {
+        runCount: number;
+        runs: RunSummary[];
+        targetCount: number;
+        attemptCount: number;
+        outcome: 'passed' | 'failed' | 'needs_review' | 'incomplete' | 'not_run';
+        complete: boolean;
+        mechanicalPassed: boolean;
+        releaseRequired: number;
+        releaseCovered: number;
+        releaseOutcome: 'passed' | 'failed' | 'needs_review' | 'incomplete' | 'not_run';
+        missingTargets: string[];
+        targets: TargetSummary[];
+        targetAttempts: TargetSummary[];
+    };
+    diagnostics: string[];
+}
+export declare function createSkillReportBatchId(name: string, date?: Date): string;
+export declare function resolveSkillEvalRoot(repoRoot: string, owner: SkillReportOwner): string;
+export declare function createSkillEvalRunLayout(options: {
+    repoRoot: string;
+    owner: SkillReportOwner;
+    batchName?: string;
+    batchId?: string;
+    runId?: string;
+    source: SkillReportSourceIdentity;
+    environmentDigest: string;
+    modelEnvironmentDigest?: string | null;
+    harnessDigest: string;
+    requiredTargets: string[];
+    targetCompositions?: SkillReportTargetCompositions;
+}): Promise<SkillEvalRunLayout>;
+export declare function computeAuthorSourceDigest(roots: Array<{
+    name: string;
+    root: string;
+}>): Promise<string>;
+export declare function createEnvironmentDigest(value: unknown): string;
+export declare function pluginReleaseTargets(manifest: {
+    profiles: Array<{
+        id: string;
+        requiredForRelease: boolean;
+    }>;
+    suites: Array<{
+        id: string;
+        kind: string;
+        profiles: string[];
+        releaseSplits: string[];
+        requiredForRelease: boolean;
+    }>;
+}): string[];
+export declare function staticReleaseTargets(manifest: {
+    suites: Array<{
+        id: string;
+        kind: string;
+        releaseSplits: string[];
+        requiredForRelease: boolean;
+    }>;
+}): string[];
+export declare function validateSkillReportTargetSegment(value: string, label: string): string;
+export declare function createSkillEvalTargetKey(parts: Array<string | null | undefined>): string;
+export declare function resolveSkillEvalTargetPlan(options: {
+    layout: SkillEvalRunLayout;
+    targets: string[];
+}): Promise<SkillEvalTargetPlan>;
+export declare function publishEvalRunCheckpoint(options: {
+    layout: SkillEvalRunLayout;
+    evaluation: EvaluationLike;
+    caseId?: string;
+    allowDuplicateTargets?: boolean;
+}): Promise<BatchSummary>;
+export declare function completeSkillEvalRun(options: {
+    layout: SkillEvalRunLayout;
+    evaluation: EvaluationLike;
+}): Promise<BatchSummary>;
+export declare function publishEvalRunToBatch(options: {
+    repoRoot: string;
+    layout: SkillEvalRunLayout;
+    evaluation: EvaluationLike;
+    caseId?: string;
+    requiredTargets: string[];
+    allowDuplicateTargets?: boolean;
+}): Promise<BatchSummary>;
+export declare function failSkillEvalRun(options: {
+    layout: SkillEvalRunLayout;
+    message?: string;
+}): Promise<BatchSummary>;
+export declare function refreshSkillReportBatch(options: {
+    repoRoot: string;
+    owner: SkillReportOwner;
+    batchId: string;
+}): Promise<BatchSummary>;
+export declare function reportBatchName(batchId: string): string;
+export {};