@rpamis/comet 0.3.9 → 0.4.0-beta.1

package/dist/domains/bundle/platform.js

@@ -0,0 +1,170 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { planBundleHook, planBundleOverride, planBundleRule, } from './bundle-platform.js';
+import { planSkillDirectoryCopy } from '../skill/platform-install.js';
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function required(ir, capability) {
+    return ir.capabilities.requires.includes(capability);
+}
+function addUnsupported(report, ir, capability, reason, forcedRequired) {
+    if (report.unsupported.some((item) => item.capability === capability))
+        return;
+    report.unsupported.push({
+        capability,
+        required: forcedRequired ?? required(ir, capability),
+        reason,
+    });
+}
+function overrideFor(ir, platform, replaces) {
+    return ir.overrides.find((override) => override.platform === platform && override.replaces === replaces);
+}
+function skillResourceDestination(ir, target, logicalPath) {
+    for (const skill of ir.skills) {
+        const prefix = `${skill.logicalRoot.replace(/\/+$/, '')}/`;
+        if (!logicalPath.startsWith(prefix))
+            continue;
+        return path.join(target.layout.skillsRoot, skill.id, ...logicalPath.slice(prefix.length).split('/'));
+    }
+    return null;
+}
+function capabilityCoveredByOverrides(ir, platform, capability) {
+    if (capability === 'hooks') {
+        return (ir.hooks.length > 0 &&
+            ir.hooks.every((hook) => overrideFor(ir, platform, `hooks.${hook.id}`) !== undefined));
+    }
+    if (capability === 'rules') {
+        return (ir.rules.length > 0 &&
+            ir.rules.every((rule) => overrideFor(ir, platform, `rules.${rule.id}`) !== undefined));
+    }
+    return false;
+}
+async function collectEngineFiles(root, directory, destinationRoot, files) {
+    const entries = await fs.readdir(directory, { withFileTypes: true });
+    entries.sort((left, right) => compareText(left.name, right.name));
+    for (const entry of entries) {
+        const source = path.join(directory, entry.name);
+        const stats = await fs.lstat(source);
+        if (stats.isSymbolicLink()) {
+            throw new Error(`${path.relative(root, source).replaceAll('\\', '/')} is a symbolic link`);
+        }
+        if (stats.isDirectory()) {
+            await collectEngineFiles(root, source, destinationRoot, files);
+        }
+        else if (stats.isFile()) {
+            files.push({
+                source,
+                destination: path.join(destinationRoot, path.relative(root, source)),
+                kind: 'engine',
+            });
+        }
+    }
+}
+export async function compileBundleForPlatform(ir, target, options) {
+    const report = {
+        platform: target.id,
+        scope: options.scope,
+        files: [],
+        entrySkills: ir.skills
+            .filter((skill) => skill.visibility === 'entry')
+            .map((skill) => skill.id)
+            .sort(compareText),
+        unsupported: [],
+        executableDisclosures: [],
+    };
+    for (const skill of ir.skills) {
+        const planned = planSkillDirectoryCopy(skill.files, path.join(target.layout.skillsRoot, skill.id));
+        report.files.push(...planned.map((file) => ({ ...file, kind: 'skill' })));
+    }
+    for (const rule of ir.rules) {
+        const replacement = overrideFor(ir, target.id, `rules.${rule.id}`);
+        if (replacement) {
+            report.files.push(planBundleOverride(target, replacement, 'rule'));
+            continue;
+        }
+        const planned = planBundleRule(target, rule);
+        if (planned.length > 0)
+            report.files.push(...planned);
+        else
+            addUnsupported(report, ir, 'rules', `Platform ${target.id} cannot express rule ${rule.id}`);
+    }
+    for (const hook of ir.hooks) {
+        const replacement = overrideFor(ir, target.id, `hooks.${hook.id}`);
+        if (replacement) {
+            report.files.push(planBundleOverride(target, replacement, 'hook'));
+            continue;
+        }
+        const hookScript = ir.scripts.find((script) => script.id === hook.script);
+        const installedScript = hookScript
+            ? skillResourceDestination(ir, target, hookScript.path)
+            : null;
+        const commandScript = installedScript
+            ? path.relative(target.layout.baseDir, installedScript).replaceAll('\\', '/')
+            : undefined;
+        const planned = planBundleHook(target, hook, ir.scripts, ir.bundle.name, installedScript ?? undefined, commandScript);
+        if (planned) {
+            report.files.push(...planned.files);
+            report.executableDisclosures.push(planned.disclosure);
+        }
+        else {
+            addUnsupported(report, ir, 'hooks', `Platform ${target.id} cannot express hook ${hook.id}`);
+        }
+    }
+    const supportRoot = path.join(target.layout.scriptsRoot, ir.bundle.name);
+    for (const script of ir.scripts) {
+        if (skillResourceDestination(ir, target, script.path))
+            continue;
+        report.files.push({
+            source: script.source,
+            destination: path.join(supportRoot, ...script.path.split('/')),
+            kind: 'script',
+        });
+    }
+    for (const reference of ir.references) {
+        if (skillResourceDestination(ir, target, reference.logicalPath))
+            continue;
+        report.files.push({
+            source: reference.source,
+            destination: path.join(supportRoot, ...reference.logicalPath.split('/')),
+            kind: 'reference',
+        });
+    }
+    for (const asset of ir.assets) {
+        if (skillResourceDestination(ir, target, asset.logicalPath))
+            continue;
+        report.files.push({
+            source: asset.source,
+            destination: path.join(supportRoot, ...asset.logicalPath.split('/')),
+            kind: 'asset',
+        });
+    }
+    for (const agent of ir.agents) {
+        if (agent.platform !== target.id || !target.layout.agentsRoot) {
+            if (agent.required) {
+                addUnsupported(report, ir, 'agents', `Platform ${target.id} cannot express agent ${agent.id}`, true);
+            }
+            continue;
+        }
+        report.files.push({
+            source: agent.source,
+            destination: path.join(target.layout.agentsRoot, `${agent.id}.md`),
+            kind: 'agent',
+        });
+    }
+    if (ir.engine) {
+        await collectEngineFiles(ir.engine.sourceRoot, ir.engine.sourceRoot, path.join(supportRoot, 'engine'), report.files);
+    }
+    for (const capability of [...ir.capabilities.requires, ...ir.capabilities.optional]) {
+        if (!target.capabilities.has(capability) &&
+            !capabilityCoveredByOverrides(ir, target.id, capability) &&
+            !report.unsupported.some((item) => item.capability === capability)) {
+            addUnsupported(report, ir, capability, `Platform ${target.id} does not support ${capability}`);
+        }
+    }
+    report.files.sort((left, right) => compareText(left.destination, right.destination));
+    report.unsupported.sort((left, right) => compareText(left.capability, right.capability));
+    report.executableDisclosures.sort((left, right) => compareText(left.id, right.id));
+    return report;
+}
+//# sourceMappingURL=platform.js.map

package/dist/domains/bundle/platform.js.map

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

package/dist/domains/bundle/preferences.d.ts

@@ -0,0 +1,11 @@
+import { type NormalizedSkillPreferences, type SkillPreferenceWarning } from '../skill/preferences.js';
+export interface BundleSkillPreferences {
+    names: string[];
+    preferences: NormalizedSkillPreferences;
+    path: string;
+    hash: string;
+    warnings: SkillPreferenceWarning[];
+}
+export declare function readBundleSkillPreferences(projectRoot: string): Promise<BundleSkillPreferences | null>;
+export declare function readSkillPreferences(projectRoot: string): Promise<string[] | null>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/domains/bundle/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../domains/bundle/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,0BAA0B,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAUxC;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAExF"}

package/dist/domains/bundle/preferences.js

@@ -0,0 +1,17 @@
+import { readProjectSkillPreferences, skillPreferenceEntries, } from '../skill/preferences.js';
+export async function readBundleSkillPreferences(projectRoot) {
+    const projectPreferences = await readProjectSkillPreferences(projectRoot);
+    if (!projectPreferences)
+        return null;
+    return {
+        names: skillPreferenceEntries(projectPreferences.preferences).map((entry) => entry.query),
+        preferences: projectPreferences.preferences,
+        path: projectPreferences.path,
+        hash: projectPreferences.hash,
+        warnings: projectPreferences.warnings,
+    };
+}
+export async function readSkillPreferences(projectRoot) {
+    return (await readBundleSkillPreferences(projectRoot))?.names ?? null;
+}
+//# sourceMappingURL=preferences.js.map

package/dist/domains/bundle/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../../domains/bundle/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AAUjC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB;IAEnB,MAAM,kBAAkB,GAAG,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAC1E,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO;QACL,KAAK,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;QACzF,WAAW,EAAE,kBAAkB,CAAC,WAAW;QAC3C,IAAI,EAAE,kBAAkB,CAAC,IAAI;QAC7B,IAAI,EAAE,kBAAkB,CAAC,IAAI;QAC7B,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,OAAO,CAAC,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AACxE,CAAC"}

package/dist/domains/bundle/publish.d.ts

@@ -0,0 +1,14 @@
+import type { BundleAuthoringState } from './types.js';
+export declare function reviewBundle(options: {
+    projectRoot: string;
+    name: string;
+    decision: 'approved' | 'rejected';
+    reviewer: string;
+}): Promise<BundleAuthoringState>;
+export declare function publishBundle(options: {
+    projectRoot: string;
+    name: string;
+    overwrite?: boolean;
+    referencePlatform: string;
+}): Promise<BundleAuthoringState>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/domains/bundle/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../domains/bundle/publish.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAoBvD,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0BhC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoHhC"}

package/dist/domains/bundle/publish.js

@@ -0,0 +1,159 @@
+import { randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import os from 'os';
+import path from 'path';
+import { compileBundleIr } from './compiler.js';
+import { validateStableFactoryControlPlane } from './eval.js';
+import { assertFactoryProposalConfirmed } from './factory.js';
+import { hashBundle } from './hash.js';
+import { loadBundle } from './load.js';
+import { compileBundleForPlatform } from './platform.js';
+import { reconcileBundleAuthoringState, writeBundleAuthoringState } from './state.js';
+import { assertValidBundle } from './validate.js';
+import { listBundlePlatformTargets } from './bundle-platform.js';
+async function pathExists(target) {
+    try {
+        await fs.access(target);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function assertReviewer(reviewer) {
+    const normalized = reviewer.trim();
+    if (!normalized)
+        throw new Error('Bundle reviewer must be a non-empty string');
+    return normalized;
+}
+export async function reviewBundle(options) {
+    const state = await reconcileBundleAuthoringState(options.projectRoot, options.name);
+    assertFactoryProposalConfirmed(state);
+    if (state.status !== 'eval-passed' ||
+        !state.eval?.passed ||
+        state.eval.hash !== state.currentHash ||
+        !state.currentHash) {
+        throw new Error('Bundle review requires eval-passed evidence for the current hash');
+    }
+    const reviewed = {
+        ...state,
+        status: options.decision === 'approved' ? 'review-approved' : 'draft',
+        review: {
+            hash: state.currentHash,
+            decision: options.decision,
+            reviewer: assertReviewer(options.reviewer),
+            at: new Date().toISOString(),
+        },
+    };
+    delete reviewed.ready;
+    delete reviewed.conflict;
+    await writeBundleAuthoringState(options.projectRoot, reviewed);
+    return reviewed;
+}
+export async function publishBundle(options) {
+    const state = await reconcileBundleAuthoringState(options.projectRoot, options.name);
+    if (state.factory && !state.factory.generatedSkillPackage) {
+        throw new Error('Factory publish requires generated Skill package evidence');
+    }
+    assertFactoryProposalConfirmed(state);
+    const bundle = await loadBundle(state.draftPath);
+    const controlPlane = await validateStableFactoryControlPlane(state);
+    if (!controlPlane.passed) {
+        throw new Error(`Bundle control plane is incomplete: ${controlPlane.errors.join(', ')}`);
+    }
+    await assertValidBundle(bundle);
+    const currentHash = await hashBundle(bundle);
+    if (currentHash !== state.currentHash) {
+        throw new Error('Bundle draft changed during final validation; reconcile and evaluate it again');
+    }
+    if (bundle.manifest.metadata.name !== state.name) {
+        throw new Error(`Bundle manifest name ${bundle.manifest.metadata.name} does not match authoring state ${state.name}`);
+    }
+    if (state.status !== 'review-approved' ||
+        state.eval?.hash !== currentHash ||
+        !state.eval.passed ||
+        state.review?.hash !== currentHash ||
+        state.review.decision !== 'approved') {
+        throw new Error('Bundle publish requires eval and review approval for the current hash');
+    }
+    const ir = await compileBundleIr(bundle, { locale: state.defaultLocale });
+    if (ir.bundle.hash !== currentHash) {
+        throw new Error('Bundle hash changed during final compilation');
+    }
+    const target = listBundlePlatformTargets({
+        projectRoot: options.projectRoot,
+        homeDir: os.homedir(),
+        scope: 'project',
+    }).find((candidate) => candidate.id === options.referencePlatform);
+    if (!target) {
+        throw new Error(`Unknown reference platform: ${options.referencePlatform}`);
+    }
+    const report = await compileBundleForPlatform(ir, target, {
+        projectRoot: options.projectRoot,
+        scope: 'project',
+        locale: state.defaultLocale,
+    });
+    const unsupportedRequired = report.unsupported.filter((item) => item.required);
+    if (unsupportedRequired.length > 0) {
+        throw new Error(`Reference platform ${target.id} cannot satisfy required capabilities: ${unsupportedRequired
+            .map((item) => item.capability)
+            .join(', ')}`);
+    }
+    const bundlesRoot = path.resolve(options.projectRoot, '.comet', 'bundles');
+    const destination = path.join(bundlesRoot, options.name);
+    const exists = await pathExists(destination);
+    if (exists && !options.overwrite) {
+        throw new Error(`Published Bundle already exists at ${destination}; use overwrite to replace it`);
+    }
+    await fs.mkdir(bundlesRoot, { recursive: true });
+    const temporary = path.join(bundlesRoot, `.${options.name}.${randomUUID()}.tmp`);
+    const backup = path.join(bundlesRoot, `.${options.name}.backup-${randomUUID()}`);
+    let movedExisting = false;
+    let installed = false;
+    try {
+        await fs.cp(state.draftPath, temporary, {
+            recursive: true,
+            errorOnExist: true,
+            force: false,
+        });
+        if (exists) {
+            await fs.rename(destination, backup);
+            movedExisting = true;
+        }
+        await fs.rename(temporary, destination);
+        installed = true;
+        const publishedHash = await hashBundle(await loadBundle(destination));
+        if (publishedHash !== currentHash) {
+            throw new Error('Published Bundle hash does not match the approved draft');
+        }
+        const ready = {
+            ...state,
+            status: 'ready',
+            currentHash,
+            ready: {
+                hash: currentHash,
+                path: destination,
+                publishedAt: new Date().toISOString(),
+            },
+        };
+        delete ready.conflict;
+        await writeBundleAuthoringState(options.projectRoot, ready);
+        if (movedExisting) {
+            await fs.rm(backup, { recursive: true, force: true }).catch(() => undefined);
+        }
+        return ready;
+    }
+    catch (error) {
+        await fs.rm(temporary, { recursive: true, force: true });
+        if (installed && (await pathExists(destination))) {
+            await fs.rm(destination, { recursive: true, force: true });
+        }
+        if (movedExisting && (await pathExists(backup))) {
+            await fs.rename(backup, destination);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/domains/bundle/publish.js.map

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

package/dist/domains/bundle/readiness-user-summary.d.ts

@@ -0,0 +1,25 @@
+import type { BundleReviewReadiness } from './review-summary.js';
+export type BundleReadinessConclusion = 'blocked' | 'needs-confirmation' | 'can-publish' | 'published';
+export interface BundleReadinessUserSummaryItem {
+    code: 'candidate' | 'proposal' | 'preference' | 'composition' | 'workflow' | 'control-plane' | 'authoring' | 'draft' | 'eval' | 'review' | 'publish' | 'capability' | 'agent' | 'executable' | 'unknown';
+    severity: 'blocker' | 'warning';
+    message: string;
+    impact: string;
+    nextAction: {
+        label: string;
+        command: string;
+    };
+    evidence: string | null;
+}
+export interface BundleReadinessUserSummary {
+    conclusion: BundleReadinessConclusion;
+    title: string;
+    summary: string;
+    items: BundleReadinessUserSummaryItem[];
+    nextSteps: Array<{
+        label: string;
+        command: string;
+    }>;
+}
+export declare function buildReadinessUserSummary(bundleName: string, readiness: BundleReviewReadiness): BundleReadinessUserSummary;
+//# sourceMappingURL=readiness-user-summary.d.ts.map

package/dist/domains/bundle/readiness-user-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-user-summary.d.ts","sourceRoot":"","sources":["../../../domains/bundle/readiness-user-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,oBAAoB,GACpB,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EACA,WAAW,GACX,UAAU,GACV,YAAY,GACZ,aAAa,GACb,UAAU,GACV,eAAe,GACf,WAAW,GACX,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,OAAO,GACP,YAAY,GACZ,SAAS,CAAC;IACd,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,yBAAyB,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAyJD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,qBAAqB,GAC/B,0BAA0B,CAsD5B"}

package/dist/domains/bundle/readiness-user-summary.js

@@ -0,0 +1,186 @@
+function fallbackNextSteps(conclusion, bundleName) {
+    if (conclusion === 'can-publish') {
+        return [
+            {
+                label: 'Publish the approved candidate',
+                command: `comet publish run ${bundleName} --platform <reference-platform>`,
+            },
+        ];
+    }
+    if (conclusion === 'published') {
+        return [
+            {
+                label: 'Preview distribution before installing into Agent platforms',
+                command: `comet publish distribute ${bundleName} --platform <platform> --scope project --preview`,
+            },
+        ];
+    }
+    return [];
+}
+function codeOf(message) {
+    const match = message.match(/^\[([a-z-]+)\]/u);
+    const value = match?.[1] ?? 'unknown';
+    if ([
+        'candidate',
+        'proposal',
+        'preference',
+        'composition',
+        'workflow',
+        'control-plane',
+        'authoring',
+        'draft',
+        'eval',
+        'review',
+        'publish',
+        'capability',
+        'agent',
+        'executable',
+    ].includes(value)) {
+        return value;
+    }
+    return 'unknown';
+}
+function advice(code, bundleName) {
+    switch (code) {
+        case 'candidate':
+            return {
+                impact: 'Comet cannot safely compose the Skill until every source Skill is resolved.',
+                label: 'Resolve missing or ambiguous Skill candidates',
+                command: `comet creator status ${bundleName}`,
+            };
+        case 'proposal':
+            return {
+                impact: 'The resolved Skill composition has not been confirmed by the user.',
+                label: 'Confirm the resolved composition proposal',
+                command: `comet creator init ${bundleName} --file <plan.json> --confirmed-proposal`,
+            };
+        case 'preference':
+            return {
+                impact: 'The saved project Skill preferences no longer match this candidate.',
+                label: 'Review project Skill preferences and resume /comet-any',
+                command: 'Open .comet/skill-preferences.yaml, then run /comet-any again',
+            };
+        case 'composition':
+            return {
+                impact: 'The generated Skill plan is not stable enough to publish.',
+                label: 'Ask /comet-any to revise the composition proposal',
+                command: 'Ask /comet-any to revise the proposal',
+            };
+        case 'workflow':
+            return {
+                impact: 'The generated workflow contract is missing a required Output Schema or violates a protected Node rule.',
+                label: 'Revise the workflow contract',
+                command: 'Ask /comet-any to revise the Workflow Nodes, Skill Bindings, or Output Schemas',
+            };
+        case 'control-plane':
+            return {
+                impact: 'Required scripts, rules, hooks, or checks are missing from the generated Skill.',
+                label: 'Regenerate the Skill Creator package',
+                command: `comet creator generate ${bundleName}`,
+            };
+        case 'authoring':
+            return {
+                impact: 'The generated Skill still contains scaffold content that must be authored before publishing.',
+                label: 'Complete generated Skill authoring',
+                command: `comet creator authoring-record ${bundleName} --lane skill-core --file <authoring-output.json>, then run the skill-review lane`,
+            };
+        case 'draft':
+            return {
+                impact: 'The draft cannot be tied to a stable hash.',
+                label: 'Reconcile the Bundle status',
+                command: `comet creator status ${bundleName}`,
+            };
+        case 'eval':
+            return {
+                impact: 'There is no passing eval evidence for the current generated Skill draft.',
+                label: 'Run repository eval for the generated Skill',
+                command: 'comet eval <generated-skill>/comet/eval.yaml --quick --html',
+            };
+        case 'review':
+            return {
+                impact: 'A human has not approved the current draft hash.',
+                label: 'Review readiness and approve when acceptable',
+                command: `comet publish review ${bundleName} --platform <reference-platform>`,
+            };
+        case 'publish':
+            return {
+                impact: 'Published Bundle metadata is incomplete.',
+                label: 'Run publish again after review approval',
+                command: `comet publish run ${bundleName} --platform <reference-platform>`,
+            };
+        case 'capability':
+            return {
+                impact: 'The selected platform cannot support one of the required generated capabilities.',
+                label: 'Preview distribution on the target platform',
+                command: `comet publish distribute ${bundleName} --platform <platform> --scope project --preview`,
+            };
+        case 'agent':
+            return {
+                impact: 'The generated Skill declares Claude Code custom agents, but the platform preview does not include them.',
+                label: 'Preview Claude Code agent distribution',
+                command: `comet publish distribute ${bundleName} --platform claude --scope project --preview`,
+            };
+        case 'executable':
+            return {
+                impact: 'The generated Skill includes executable hooks or scripts that require explicit confirmation.',
+                label: 'Review executable disclosures before distribution',
+                command: `comet publish distribute ${bundleName} --platform <platform> --scope project --preview`,
+            };
+        default:
+            return {
+                impact: 'Comet needs more information before it can publish safely.',
+                label: 'Inspect publish readiness',
+                command: `comet publish review ${bundleName} --platform <reference-platform>`,
+            };
+    }
+}
+export function buildReadinessUserSummary(bundleName, readiness) {
+    const items = [
+        ...readiness.blockers.map((message) => ({ message, severity: 'blocker' })),
+        ...readiness.warnings.map((message) => ({ message, severity: 'warning' })),
+    ].map((item) => {
+        const code = codeOf(item.message);
+        const next = advice(code, bundleName);
+        return {
+            code,
+            severity: item.severity,
+            message: item.message.replace(/^\[[^\]]+\]\s*/u, ''),
+            impact: next.impact,
+            nextAction: {
+                label: next.label,
+                command: next.command,
+            },
+            evidence: readiness.evidence[code] ?? null,
+        };
+    });
+    const conclusion = readiness.state === 'published'
+        ? 'published'
+        : readiness.state === 'publishable'
+            ? 'can-publish'
+            : readiness.blockers.length > 0
+                ? 'blocked'
+                : 'needs-confirmation';
+    const title = conclusion === 'published'
+        ? 'Already published'
+        : conclusion === 'can-publish'
+            ? 'Ready to publish'
+            : conclusion === 'needs-confirmation'
+                ? 'Ready for review approval'
+                : 'Cannot publish yet';
+    return {
+        conclusion,
+        title,
+        summary: conclusion === 'blocked'
+            ? `${readiness.blockers.length} issue(s) must be fixed before publishing.`
+            : conclusion === 'needs-confirmation'
+                ? 'No blockers remain, but human review approval is still required.'
+                : conclusion === 'can-publish'
+                    ? 'Eval and review evidence match the current draft.'
+                    : 'The published Bundle is bound to the current hash.',
+        items,
+        nextSteps: items.length > 0
+            ? items.map((item) => item.nextAction)
+            : fallbackNextSteps(conclusion, bundleName),
+    };
+}
+//# sourceMappingURL=readiness-user-summary.js.map

package/dist/domains/bundle/readiness-user-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-user-summary.js","sourceRoot":"","sources":["../../../domains/bundle/readiness-user-summary.ts"],"names":[],"mappings":"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"}