@rpamis/comet 0.3.9 → 0.4.0-beta.1

package/dist/domains/bundle/factory-plan.js

@@ -0,0 +1,172 @@
+import { createHash, randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { normalizeWorkflowDefinition, } from '../workflow-contract/index.js';
+const FACTORY_PLAN_FIELDS = new Set([
+    'goal',
+    'preferredSkills',
+    'skillCreatorIntent',
+    'workflow',
+    'deviations',
+    'engineMode',
+    'runnerMode',
+    'mode',
+    'sourceRoot',
+    'defaultLocale',
+    'locales',
+    'engineEnabled',
+]);
+function persistedFactoryPlan(plan) {
+    return {
+        schemaVersion: 1,
+        goal: plan.goal,
+        skillCreatorIntent: plan.skillCreatorIntent,
+        preferredSkills: plan.preferredSkills,
+        workflow: plan.workflowDefinition,
+        workflowDefinition: plan.workflowDefinition,
+        workflowProtocol: plan.workflowProtocol,
+        deviations: plan.deviations,
+        engineMode: plan.engineMode,
+        runnerMode: plan.runnerMode,
+        mode: plan.mode,
+        ...(plan.sourceRoot ? { sourceRoot: plan.sourceRoot } : {}),
+        defaultLocale: plan.defaultLocale,
+        locales: plan.locales,
+        engineEnabled: plan.engineEnabled,
+    };
+}
+export function hashBundleFactoryPlan(plan) {
+    return createHash('sha256')
+        .update(JSON.stringify(persistedFactoryPlan(plan), null, 2) + '\n')
+        .digest('hex');
+}
+function ensureStringArray(value, label) {
+    if (!Array.isArray(value) ||
+        value.some((item) => typeof item !== 'string' || item.length === 0)) {
+        throw new Error(`${label} must be a non-empty string array when provided`);
+    }
+    return value;
+}
+function dedupe(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        if (seen.has(value))
+            continue;
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+function normalizeCallChain(skills, preferredSkills) {
+    const preferredIndex = new Map(preferredSkills.map((skill, index) => [skill, index]));
+    return skills.map((skill) => ({
+        skill,
+        preferenceIndex: preferredIndex.get(skill) ?? null,
+    }));
+}
+function assertKnownFactoryPlanFields(plan, absolutePath) {
+    const unknown = Object.keys(plan).filter((field) => !FACTORY_PLAN_FIELDS.has(field));
+    if (unknown.length === 0)
+        return;
+    throw new Error(`Invalid factory plan: ${absolutePath} unknown fields are not supported (${unknown.join(', ')})`);
+}
+function assertValidDeviations(value, absolutePath) {
+    if (value !== undefined &&
+        (!Array.isArray(value) ||
+            value.some((item) => !item ||
+                typeof item !== 'object' ||
+                typeof item.skill !== 'string' ||
+                typeof item.expectedIndex !== 'number' ||
+                typeof item.actualIndex !== 'number' ||
+                typeof item.reason !== 'string'))) {
+        throw new Error(`Invalid factory plan: ${absolutePath} deviations must be structured objects`);
+    }
+}
+export async function readBundleFactoryPlan(filePath) {
+    const absolutePath = path.resolve(filePath);
+    const value = JSON.parse(await fs.readFile(absolutePath, 'utf8'));
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid factory plan: ${absolutePath}`);
+    }
+    const plan = value;
+    assertKnownFactoryPlanFields(plan, absolutePath);
+    if (typeof plan.goal !== 'string' || plan.goal.length === 0) {
+        throw new Error(`Invalid factory plan: ${absolutePath} must include goal`);
+    }
+    if (!plan.workflow || typeof plan.workflow !== 'object' || Array.isArray(plan.workflow)) {
+        throw new Error(`Invalid factory plan: ${absolutePath} must include workflow`);
+    }
+    normalizeWorkflowDefinition(plan.workflow);
+    if (plan.preferredSkills !== undefined) {
+        ensureStringArray(plan.preferredSkills, 'preferredSkills');
+    }
+    if (plan.locales !== undefined) {
+        ensureStringArray(plan.locales, 'locales');
+    }
+    assertValidDeviations(plan.deviations, absolutePath);
+    return plan;
+}
+export function normalizeBundleFactoryPlan(options) {
+    const { plan } = options;
+    assertKnownFactoryPlanFields(plan, '<inline factory plan>');
+    const workflow = normalizeWorkflowDefinition(plan.workflow);
+    const preferredSkills = dedupe([
+        ...(plan.preferredSkills ?? options.projectPreferredSkills ?? []),
+        ...workflow.requiredSkills,
+    ]);
+    const planMode = plan.mode ?? 'create';
+    if (planMode === 'optimize' && !plan.sourceRoot) {
+        throw new Error('factory plan sourceRoot is required for optimize mode');
+    }
+    const skillCreatorIntent = plan.skillCreatorIntent ??
+        (workflow.protocol.kind === 'comet-five-phase-overlay'
+            ? 'customize-comet'
+            : planMode === 'optimize'
+                ? 'upgrade-existing'
+                : 'new-skill');
+    const defaultLocale = plan.defaultLocale ?? 'en';
+    const locales = dedupe(plan.locales ?? [defaultLocale]);
+    const engineMode = plan.engineMode ?? 'deterministic';
+    return {
+        goal: plan.goal,
+        skillCreatorIntent,
+        preferredSkills,
+        callChain: normalizeCallChain(workflow.requiredSkills, preferredSkills),
+        workflowDefinition: workflow.input,
+        workflowProtocol: workflow.protocol,
+        deviations: structuredClone(plan.deviations ?? []),
+        engineMode,
+        runnerMode: plan.runnerMode ?? 'standalone',
+        mode: planMode,
+        ...(plan.sourceRoot ? { sourceRoot: plan.sourceRoot } : {}),
+        defaultLocale,
+        locales,
+        engineEnabled: plan.engineEnabled ?? engineMode !== 'none',
+    };
+}
+function factoryPlanPath(projectRoot, name) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/u.test(name)) {
+        throw new Error(`Invalid Bundle name: ${name}`);
+    }
+    return path.resolve(projectRoot, '.comet', 'bundle-factory-plans', name, 'plan.json');
+}
+export async function writeBundleFactoryPlanArtifact(options) {
+    const planPath = factoryPlanPath(options.projectRoot, options.name);
+    const document = persistedFactoryPlan(options.plan);
+    const content = JSON.stringify(document, null, 2) + '\n';
+    const temporary = path.join(path.dirname(planPath), `.plan.${randomUUID()}.tmp`);
+    await fs.mkdir(path.dirname(planPath), { recursive: true });
+    try {
+        await fs.writeFile(temporary, content, { encoding: 'utf8', flag: 'wx' });
+        await fs.rename(temporary, planPath);
+    }
+    finally {
+        await fs.rm(temporary, { force: true });
+    }
+    return {
+        planPath,
+        planHash: hashBundleFactoryPlan(options.plan),
+    };
+}
+//# sourceMappingURL=factory-plan.js.map

package/dist/domains/bundle/factory-plan.js.map

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

package/dist/domains/bundle/factory-proposal.d.ts

@@ -0,0 +1,31 @@
+import { type SkillCreatorPlanSummary } from './user-facing.js';
+import type { BundleFactoryCallChainItem, BundleFactoryComposition, BundleFactoryProposalAction, BundleFactoryProposalSummary, BundleFactoryResolvedSkill } from './types.js';
+import type { WorkflowProtocol } from '../workflow-contract/index.js';
+export interface BundleFactoryProposal {
+    schemaVersion: 1;
+    name: string;
+    goal: string;
+    preference: {
+        mode: 'advisory' | 'strict';
+        source: string | null;
+        hash: string | null;
+        warnings: unknown[];
+    };
+    callChain: BundleFactoryCallChainItem[];
+    workflowProtocol?: WorkflowProtocol;
+    resolvedSkills: BundleFactoryResolvedSkill[];
+    composition: BundleFactoryComposition;
+    blockers: string[];
+    warnings: string[];
+    canGenerate: boolean;
+    userSummary: BundleFactoryProposalSummary;
+    skillCreatorSummary: SkillCreatorPlanSummary;
+    actions: BundleFactoryProposalAction[];
+    proposalHash: string;
+}
+export declare function buildBundleFactoryProposal(options: {
+    projectRoot: string;
+    name: string;
+    filePath: string;
+}): Promise<BundleFactoryProposal>;
+//# sourceMappingURL=factory-proposal.d.ts.map

package/dist/domains/bundle/factory-proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-proposal.d.ts","sourceRoot":"","sources":["../../../domains/bundle/factory-proposal.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgC,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;QAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;KACrB,CAAC;IACF,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,cAAc,EAAE,0BAA0B,EAAE,CAAC;IAC7C,WAAW,EAAE,wBAAwB,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,4BAA4B,CAAC;IAC1C,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AA0ED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoKjC"}

package/dist/domains/bundle/factory-proposal.js

@@ -0,0 +1,225 @@
+import { createHash } from 'crypto';
+import path from 'path';
+import { discoverBundleCandidates } from './candidates.js';
+import { composeBundleFactoryPlan } from './factory-compose.js';
+import { normalizeBundleFactoryPlan, readBundleFactoryPlan } from './factory-plan.js';
+import { readBundleSkillPreferences } from './preferences.js';
+import { buildSkillCreatorPlanSummary } from './user-facing.js';
+import { COMET_FIVE_PHASE_NODES } from '../workflow-contract/builtins.js';
+function proposalHash(value) {
+    return createHash('sha256').update(JSON.stringify(value)).digest('hex');
+}
+function generatedControlPlane() {
+    return [
+        'SKILL.md',
+        'scripts/',
+        'rules/',
+        'hooks/',
+        'reference/',
+        'comet/skill.yaml',
+        'comet/guardrails.yaml',
+        'comet/checks.yaml',
+        'comet/eval.yaml',
+        'bundle.yaml',
+    ];
+}
+function validationPlan() {
+    return ['quick smoke eval', 'generated Skill manifest eval', 'publish readiness review'];
+}
+function builtInCandidate(projectRoot, skill, preferenceIndex) {
+    const source = {
+        name: skill,
+        preferenceIndex,
+        platform: 'builtin',
+        scope: 'builtin',
+        origin: 'builtin',
+        factory: {
+            query: skill,
+        },
+        root: path.join(projectRoot, '.comet', '__bundle_builtin__', skill),
+        description: `Built-in Comet workflow step: ${skill}.`,
+        skillMd: `# ${skill}\n`,
+        references: [],
+        scripts: [],
+        hash: `builtin:${skill}`,
+    };
+    return {
+        name: skill,
+        preferenceIndex,
+        status: 'available',
+        sources: [source],
+    };
+}
+const WORKFLOW_CONTRACT_BUILTIN_SKILLS = new Set(COMET_FIVE_PHASE_NODES.map((node) => node.implementation.skill));
+function isWorkflowContractBuiltinSkill(skill) {
+    return WORKFLOW_CONTRACT_BUILTIN_SKILLS.has(skill);
+}
+function applyBuiltInCandidates(projectRoot, candidates) {
+    return candidates.map((candidate) => {
+        if (!isWorkflowContractBuiltinSkill(candidate.name) || candidate.status !== 'missing') {
+            return candidate;
+        }
+        return builtInCandidate(projectRoot, candidate.name, candidate.preferenceIndex);
+    });
+}
+export async function buildBundleFactoryProposal(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const projectPreferences = await readBundleSkillPreferences(projectRoot);
+    const plan = normalizeBundleFactoryPlan({
+        plan: await readBundleFactoryPlan(path.resolve(options.filePath)),
+        projectPreferredSkills: projectPreferences?.names ?? null,
+    });
+    const candidates = applyBuiltInCandidates(projectRoot, await discoverBundleCandidates({
+        projectRoot,
+        preferences: plan.preferredSkills.length > 0 ? plan.preferredSkills : null,
+    }));
+    const resolvedSkills = candidates.map((candidate) => ({
+        query: candidate.name,
+        preferenceIndex: candidate.preferenceIndex,
+        status: candidate.status,
+        sources: candidate.sources,
+    }));
+    const composed = await composeBundleFactoryPlan({
+        entrySkills: plan.callChain.map((item) => item.skill),
+        preferredSkills: plan.preferredSkills,
+        resolvedSkills,
+    });
+    const callChain = composed.callChain.length > 0 ? composed.callChain : plan.callChain;
+    const blockers = [
+        ...resolvedSkills
+            .filter((skill) => skill.status === 'missing' || skill.status === 'ambiguous')
+            .map((skill) => `[candidate] ${skill.query} (${skill.status})`),
+        ...composed.composition.issues.map((issue) => `[composition] ${issue.message}`),
+    ];
+    const policies = projectPreferences?.preferences.policies;
+    if (policies?.scripts === 'deny')
+        blockers.push('[policy] preference policy denies scripts');
+    if (policies?.hooks === 'deny')
+        blockers.push('[policy] preference policy denies hooks');
+    const userSummary = {
+        title: `Create ${options.name} as a Comet-native Skill`,
+        goal: plan.goal,
+        reusedSkills: resolvedSkills.map((skill) => ({
+            skill: skill.query,
+            status: skill.status,
+            sourceCount: skill.sources.length,
+            preferenceIndex: skill.preferenceIndex,
+            fromProjectPreference: skill.preferenceIndex !== null,
+        })),
+        generatedControlPlane: generatedControlPlane(),
+        validationPlan: validationPlan(),
+        requiredConfirmations: [
+            {
+                id: 'generate-scripts',
+                label: 'Allow Comet to generate scripts as part of the control plane',
+                required: true,
+                reason: 'Scripts let the generated Skill perform deterministic checks and recovery steps.',
+            },
+            {
+                id: 'generate-rules',
+                label: 'Allow Comet to generate orchestration rules',
+                required: true,
+                reason: 'Rules keep the Agent aligned with the generated workflow.',
+            },
+            {
+                id: 'generate-hooks',
+                label: 'Allow Comet to generate portable hook descriptors',
+                required: true,
+                reason: 'Hooks guard unsafe progression and are compiled per target platform during distribution.',
+            },
+            {
+                id: 'run-eval',
+                label: 'Run benchmark before publish',
+                required: true,
+                reason: 'Benchmark evidence is required before the candidate can become publishable.',
+            },
+        ],
+        preferenceNotes: [
+            ...plan.deviations.map((item) => `${item.skill}: ${item.reason}`),
+            ...blockers.filter((item) => item.startsWith('[policy]')),
+        ],
+    };
+    const skillCreatorSummary = buildSkillCreatorPlanSummary({
+        intent: plan.skillCreatorIntent,
+        skillName: options.name,
+        goal: plan.goal,
+        workflow: {
+            kind: plan.workflowProtocol.kind,
+            nodes: plan.workflowProtocol.nodes
+                .filter((node) => !node.disabled)
+                .map((node) => ({
+                id: node.id,
+                label: node.label,
+                kind: node.kind,
+                implementationSkill: node.implementation.skill,
+                requiredSkills: node.requiredSkillCalls.map((binding) => binding.skill),
+                outputSchemas: node.outputSchemas,
+            })),
+            outputSchemas: plan.workflowProtocol.outputSchemas.map((schema) => schema.id),
+        },
+        retained: [],
+        additions: plan.workflowProtocol.nodes
+            .filter((node) => !node.disabled)
+            .map((node) => `${node.id}: ${node.implementation.skill}`),
+        replacements: plan.workflowProtocol.nodes
+            .filter((node) => node.implementation.operation === 'override')
+            .map((node) => `${node.id}: ${node.implementation.skill}`),
+        disabled: plan.workflowProtocol.nodes.filter((node) => node.disabled).map((node) => node.id),
+        rejected: blockers,
+        generated: generatedControlPlane(),
+        validation: validationPlan(),
+        install: ['Install/enable into the current Agent after validation and preview.'],
+        advanced: [
+            `Preference mode: ${projectPreferences?.preferences.mode ?? 'advisory'}`,
+            'Skill Creator proposal hash will be recorded after confirmation.',
+        ],
+    });
+    const canGenerate = blockers.length === 0;
+    const actions = [
+        ...(canGenerate
+            ? [
+                {
+                    id: 'confirm-generate',
+                    label: 'Confirm and initialize generation',
+                    command: `comet creator init ${options.name} --file ${path.resolve(options.filePath)} --confirmed-proposal`,
+                    writesState: true,
+                },
+            ]
+            : []),
+        {
+            id: 'revise-proposal',
+            label: 'Revise the plan before generating',
+            command: 'Ask /comet-any to revise the goal, preferences, or candidate choices',
+            writesState: false,
+        },
+        {
+            id: 'cancel',
+            label: 'Cancel without writing Bundle state',
+            command: 'No command',
+            writesState: false,
+        },
+    ];
+    const proposal = {
+        schemaVersion: 1,
+        name: options.name,
+        goal: plan.goal,
+        preference: {
+            mode: projectPreferences?.preferences.mode ?? 'advisory',
+            source: projectPreferences?.path ?? null,
+            hash: projectPreferences?.hash ?? null,
+            warnings: projectPreferences?.warnings ?? [],
+        },
+        callChain,
+        ...(plan.workflowProtocol ? { workflowProtocol: plan.workflowProtocol } : {}),
+        resolvedSkills,
+        composition: composed.composition,
+        blockers,
+        warnings: plan.deviations.map((item) => `[deviation] ${item.skill}: ${item.reason}`),
+        canGenerate,
+        userSummary,
+        skillCreatorSummary,
+        actions,
+    };
+    return { ...proposal, proposalHash: proposalHash(proposal) };
+}
+//# sourceMappingURL=factory-proposal.js.map

package/dist/domains/bundle/factory-proposal.js.map

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

package/dist/domains/bundle/factory-resolve.d.ts

@@ -0,0 +1,11 @@
+import type { BundleAuthoringState } from './types.js';
+export interface ResolveBundleFactoryCandidateOptions {
+    projectRoot: string;
+    name: string;
+    candidate: string;
+    source?: string;
+    ignoreMissing?: boolean;
+    reason?: string;
+}
+export declare function resolveBundleFactoryCandidate(options: ResolveBundleFactoryCandidateOptions): Promise<BundleAuthoringState>;
+//# sourceMappingURL=factory-resolve.d.ts.map

package/dist/domains/bundle/factory-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-resolve.d.ts","sourceRoot":"","sources":["../../../domains/bundle/factory-resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0DD,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAoF/B"}

package/dist/domains/bundle/factory-resolve.js

@@ -0,0 +1,121 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { reconcileBundleAuthoringState, writeBundleAuthoringState } from './state.js';
+async function canonicalPathForComparison(targetPath) {
+    const resolved = path.resolve(targetPath);
+    try {
+        return await fs.realpath(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+async function candidateSelector(source, selector, projectRoot) {
+    if (source.hash === selector)
+        return true;
+    const selectedPath = path.resolve(projectRoot, selector);
+    const sourceRoot = path.resolve(source.root);
+    if (sourceRoot === selectedPath)
+        return true;
+    return ((await canonicalPathForComparison(sourceRoot)) ===
+        (await canonicalPathForComparison(selectedPath)));
+}
+function invalidateGeneratedFactoryState(state) {
+    const updated = {
+        ...state,
+        status: 'draft',
+        currentHash: null,
+        factory: state.factory
+            ? {
+                ...state.factory,
+            }
+            : undefined,
+    };
+    if (updated.factory) {
+        delete updated.factory.generatedSkillPackage;
+        delete updated.factory.composition;
+        delete updated.factory.proposalConfirmation;
+    }
+    delete updated.eval;
+    delete updated.review;
+    delete updated.ready;
+    delete updated.conflict;
+    return updated;
+}
+function withoutCandidate(sources, candidate) {
+    return sources.filter((source) => source.factory?.query !== candidate && source.name !== candidate);
+}
+export async function resolveBundleFactoryCandidate(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    if (!options.candidate)
+        throw new Error('--candidate is required');
+    if (Boolean(options.source) === Boolean(options.ignoreMissing)) {
+        throw new Error('Pass exactly one of --source or --ignore-missing');
+    }
+    const state = await reconcileBundleAuthoringState(projectRoot, options.name);
+    if (!state.factory)
+        throw new Error(`Bundle ${state.name} does not have Skill Creator metadata`);
+    const target = state.factory.resolvedSkills.find((skill) => skill.query === options.candidate);
+    if (!target)
+        throw new Error(`Skill Creator candidate not found: ${options.candidate}`);
+    let updated = invalidateGeneratedFactoryState(state);
+    const factory = updated.factory;
+    if (options.source) {
+        const matches = [];
+        for (const source of target.sources) {
+            if (await candidateSelector(source, options.source, projectRoot)) {
+                matches.push(source);
+            }
+        }
+        if (matches.length === 0) {
+            throw new Error(`No source for ${options.candidate} matches ${options.source}`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`Source selector is ambiguous for ${options.candidate}: ${options.source}`);
+        }
+        const selected = matches[0];
+        factory.resolvedSkills = factory.resolvedSkills.map((skill) => skill.query === options.candidate
+            ? {
+                ...skill,
+                status: 'available',
+                sources: [selected],
+            }
+            : skill);
+        updated = {
+            ...updated,
+            candidates: [...withoutCandidate(updated.candidates, options.candidate), selected],
+        };
+    }
+    else {
+        if (target.status !== 'missing') {
+            throw new Error(`--ignore-missing can only be used for missing candidates: ${options.candidate}`);
+        }
+        if (!options.reason || options.reason.trim().length === 0) {
+            throw new Error('--reason is required when ignoring a missing candidate');
+        }
+        const remainingCallChain = factory.callChain.filter((item) => item.skill !== options.candidate);
+        if (remainingCallChain.length === 0) {
+            throw new Error(`Cannot ignore the only call-chain Skill: ${options.candidate}`);
+        }
+        const expectedIndex = target.preferenceIndex ?? factory.preferredSkills.indexOf(options.candidate);
+        factory.preferredSkills = factory.preferredSkills.filter((skill) => skill !== options.candidate);
+        factory.resolvedSkills = factory.resolvedSkills.filter((skill) => skill.query !== options.candidate);
+        factory.callChain = remainingCallChain;
+        factory.deviations = [
+            ...factory.deviations.filter((deviation) => !(deviation.skill === options.candidate && deviation.actualIndex === -1)),
+            {
+                skill: options.candidate,
+                expectedIndex,
+                actualIndex: -1,
+                reason: options.reason.trim(),
+            },
+        ];
+        updated = {
+            ...updated,
+            candidates: withoutCandidate(updated.candidates, options.candidate),
+        };
+    }
+    await writeBundleAuthoringState(projectRoot, updated);
+    return updated;
+}
+//# sourceMappingURL=factory-resolve.js.map

package/dist/domains/bundle/factory-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-resolve.js","sourceRoot":"","sources":["../../../domains/bundle/factory-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAYtF,KAAK,UAAU,0BAA0B,CAAC,UAAkB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAA6B,EAC7B,QAAgB,EAChB,WAAmB;IAEnB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,CACL,CAAC,MAAM,0BAA0B,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC,MAAM,0BAA0B,CAAC,YAAY,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CAAC,KAA2B;IAClE,MAAM,OAAO,GAAyB;QACpC,GAAG,KAAK;QACR,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;YACpB,CAAC,CAAC;gBACE,GAAG,KAAK,CAAC,OAAO;aACjB;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IACF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;QAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QACnC,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC;IACpB,OAAO,OAAO,CAAC,MAAM,CAAC;IACtB,OAAO,OAAO,CAAC,KAAK,CAAC;IACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAgC,EAChC,SAAiB;IAEjB,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA6C;IAE7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,uCAAuC,CAAC,CAAC;IAEjG,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAExF,IAAI,OAAO,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAQ,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,CAAC,SAAS,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5D,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS;YAC/B,CAAC,CAAC;gBACE,GAAG,KAAK;gBACR,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,CAAC,QAAQ,CAAC;aACpB;YACH,CAAC,CAAC,KAAK,CACV,CAAC;QACF,OAAO,GAAG;YACR,GAAG,OAAO;YACV,UAAU,EAAE,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;SACnF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6DAA6D,OAAO,CAAC,SAAS,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAChG,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,4CAA4C,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,aAAa,GACjB,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CACtD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CACvC,CAAC;QACF,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CACpD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAC7C,CAAC;QACF,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC;QACvC,OAAO,CAAC,UAAU,GAAG;YACnB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAC1B,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CACxF;YACD;gBACE,KAAK,EAAE,OAAO,CAAC,SAAS;gBACxB,aAAa;gBACb,WAAW,EAAE,CAAC,CAAC;gBACf,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;aAC9B;SACF,CAAC;QACF,OAAO,GAAG;YACR,GAAG,OAAO;YACV,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,MAAM,yBAAyB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { BundleAuthoringState, BundleFactoryMetadata } from './types.js';
+export declare function composeFactoryMetadata(name: string, factory: BundleFactoryMetadata): Promise<BundleFactoryMetadata>;
+export declare function generateBundleDraftFromFactoryState(options: {
+    projectRoot: string;
+    state: BundleAuthoringState;
+}): Promise<BundleAuthoringState>;
+export declare function initializeBundleFactoryState(options: {
+    projectRoot: string;
+    name: string;
+    filePath: string;
+    confirmedProposal?: boolean;
+}): Promise<BundleAuthoringState>;
+export declare function assertFactoryProposalConfirmed(state: {
+    name: string;
+    factory?: BundleFactoryMetadata;
+}): void;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../domains/bundle/factory.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAkB,MAAM,YAAY,CAAC;AA8S9F,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAiBhC;AAED,wBAAsB,mCAAmC,CAAC,OAAO,EAAE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqGhC;AAED,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiJhC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,GAAG,IAAI,CAMP"}