@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom/software-delivery-plan.d.ts

@@ -0,0 +1,32 @@
+import { type WorkflowPlanProposal, type WorkflowPlanProposalMetadata, type WorkflowPlanTaskSchedulerInput, type WorkflowTaskCapabilityRequirement } from './workflow-plan-builder.js';
+export type SoftwareDeliveryStage = 'requirements' | 'design' | 'implement' | 'test' | 'review' | 'release' | 'health';
+export interface SoftwareDeliveryPlanInput {
+    readonly metadata: Omit<WorkflowPlanProposalMetadata, 'strategy' | 'parameterDigest'>;
+    readonly request: Readonly<{
+        ref: string;
+        digest: string;
+    }>;
+    readonly acceptanceCriteria: readonly Readonly<{
+        ref: string;
+        digest: string;
+    }>[];
+    readonly repositoryId: string;
+    readonly environment: string;
+    readonly stages: Readonly<Record<SoftwareDeliveryStage, Readonly<{
+        role: string;
+        requires: WorkflowTaskCapabilityRequirement;
+        maxAttempts: number;
+    }>>>;
+    readonly scheduler: Omit<WorkflowPlanTaskSchedulerInput, 'localRank' | 'preemptibility'>;
+    readonly sponsor: Readonly<{
+        principalId: string;
+        decisionTimeoutMs: number;
+    }>;
+}
+/**
+ * Pure, bounded reference strategy. This creates only a proposal. Admission,
+ * capability assignment, evidence acceptance and release authorization remain
+ * existing Kernel/Effect authorities. A plan gate does not authorize a deploy.
+ */
+export declare function createSoftwareDeliveryPlan(input: SoftwareDeliveryPlanInput): WorkflowPlanProposal;
+//# sourceMappingURL=software-delivery-plan.d.ts.map

package/lib/workroom/software-delivery-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-delivery-plan.d.ts","sourceRoot":"","sources":["../../src/workroom/software-delivery-plan.ts"],"names":[],"mappings":"AACA,OAAO,EACgB,KAAK,oBAAoB,EAAE,KAAK,4BAA4B,EACjF,KAAK,8BAA8B,EAAE,KAAK,iCAAiC,EAC5E,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,4BAA4B,EAAE,UAAU,GAAG,iBAAiB,CAAC,CAAC;IACtF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,iCAAiC,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC,CAAC,CAAC;IACL,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,8BAA8B,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,oBAAoB,CA0CjG"}

package/lib/workroom/software-delivery-plan.js

@@ -0,0 +1,60 @@
+import { digestCanonicalWorkroomValue as digest } from './canonical-value.js';
+import { WorkflowPlanBuilder, } from './workflow-plan-builder.js';
+/**
+ * Pure, bounded reference strategy. This creates only a proposal. Admission,
+ * capability assignment, evidence acceptance and release authorization remain
+ * existing Kernel/Effect authorities. A plan gate does not authorize a deploy.
+ */
+export function createSoftwareDeliveryPlan(input) {
+    const stages = ['requirements', 'design', 'implement', 'test', 'review', 'release', 'health'];
+    reference(input.request);
+    if (!input.acceptanceCriteria.length)
+        throw new Error('Software delivery requires acceptance criteria');
+    for (const criterion of input.acceptanceCriteria)
+        reference(criterion);
+    if (new Set(input.acceptanceCriteria.map(item => item.ref)).size !== input.acceptanceCriteria.length) {
+        throw new Error('Software delivery acceptance criteria must have unique refs');
+    }
+    for (const value of [input.repositoryId, input.environment, input.sponsor.principalId]) {
+        if (typeof value !== 'string' || !value.trim() || value.trim() !== value)
+            throw new Error('Software delivery scope is invalid');
+    }
+    if (input.stages.implement.role === input.stages.review.role) {
+        throw new Error('Software delivery requires separate implementation and review roles');
+    }
+    const parameters = {
+        request: input.request,
+        acceptanceCriteria: [...input.acceptanceCriteria].sort((a, b) => a.ref < b.ref ? -1 : a.ref > b.ref ? 1 : 0),
+        repositoryId: input.repositoryId, environment: input.environment,
+    };
+    let builder = WorkflowPlanBuilder.create({
+        ...input.metadata,
+        strategy: { id: 'software-delivery', version: '1.0.0', digest: digest({ version: 1, stages }) },
+        parameterDigest: digest(parameters),
+    });
+    for (const [index, stage] of stages.entries()) {
+        const binding = input.stages[stage];
+        if (!binding)
+            throw new Error(`Software delivery stage ${stage} is missing`);
+        builder = builder.addTask({
+            key: stage, title: `Software delivery: ${stage}`, role: binding.role,
+            required: true, maxAttempts: binding.maxAttempts,
+            dependsOn: index ? [stages[index - 1]] : [], requires: binding.requires,
+            scheduler: { ...input.scheduler, localRank: index, preemptibility: 'atomic' },
+            ...(stage === 'release' ? { approvalGate: {
+                    id: 'approval:release', kind: 'sponsor', owner: input.sponsor.principalId,
+                    decisionTimeoutMs: input.sponsor.decisionTimeoutMs,
+                    deadline: Math.min(input.scheduler.deadline, input.scheduler.enqueuedAt + input.sponsor.decisionTimeoutMs),
+                    policyRevisionId: input.metadata.authority.planningPolicyRevisionId,
+                    policyDigest: input.metadata.authority.planningPolicyDigest,
+                } } : {}),
+        });
+    }
+    return builder.build();
+}
+function reference(value) {
+    if (!value || typeof value.ref !== 'string' || !value.ref.trim() || value.ref !== value.ref.trim()
+        || !/^sha256:[a-f0-9]{64}$/u.test(value.digest))
+        throw new Error('Software delivery requires immutable evidence references');
+}
+//# sourceMappingURL=software-delivery-plan.js.map

package/lib/workroom/software-delivery-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-delivery-plan.js","sourceRoot":"","sources":["../../src/workroom/software-delivery-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACL,mBAAmB,GAEpB,MAAM,4BAA4B,CAAC;AAmBpC;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAgC;IACzE,MAAM,MAAM,GAAqC,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACxG,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,kBAAkB;QAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC;QACrG,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,UAAU,GAAG;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,kBAAkB,EAAE,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5G,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW;KACjE,CAAC;IACF,IAAI,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC;QACvC,GAAG,KAAK,CAAC,QAAQ;QACjB,QAAQ,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC/F,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC;KACpC,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,aAAa,CAAC,CAAC;QAC7E,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YACxB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI;YACpE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW;YAChD,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YACxE,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE;YAC7E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE;oBACxC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW;oBAClF,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,iBAAiB;oBAClD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC;oBAC1G,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,wBAAwB;oBACnE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,oBAAoB;iBAC5D,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACV,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,SAAS,CAAC,KAAgD;IACjE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;WAC7F,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AACjI,CAAC"}

package/lib/workroom/validate-catalog.d.ts

@@ -0,0 +1,2 @@
+export declare function validateWorkroomDefinitions(rawWorkrooms: unknown, agentNames: readonly string[], endpointKeys?: ReadonlySet<string>): string[];
+//# sourceMappingURL=validate-catalog.d.ts.map

package/lib/workroom/validate-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-catalog.d.ts","sourceRoot":"","sources":["../../src/workroom/validate-catalog.ts"],"names":[],"mappings":"AAIA,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACjC,MAAM,EAAE,CA+JV"}

package/lib/workroom/validate-catalog.js

@@ -0,0 +1,230 @@
+const WORKROOM_ROLES = new Set(['orchestrator', 'executor', 'reviewer', 'integration']);
+export function validateWorkroomDefinitions(rawWorkrooms, agentNames, endpointKeys) {
+    const errors = [];
+    if (rawWorkrooms == null)
+        return errors;
+    if (typeof rawWorkrooms !== 'object' || Array.isArray(rawWorkrooms)) {
+        return ['workroomCatalog: definitions must be an object'];
+    }
+    const workrooms = rawWorkrooms;
+    const agents = new Set(agentNames);
+    const enabledConversationOwners = new Map();
+    for (const [projectId, workroom] of Object.entries(workrooms)) {
+        const path = `workroomCatalog.${projectId}`;
+        if (!/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(projectId)) {
+            errors.push(`${path}: projectId must match [a-z0-9][a-z0-9_-]{0,63}`);
+        }
+        if (!workroom || typeof workroom !== 'object' || Array.isArray(workroom)) {
+            errors.push(`${path}: Workroom definition must be an object`);
+            continue;
+        }
+        if (typeof workroom.name !== 'string' || !workroom.name.trim()) {
+            errors.push(`${path}.name: name is required`);
+        }
+        if (workroom.description !== undefined && typeof workroom.description !== 'string') {
+            errors.push(`${path}.description: description must be a string`);
+        }
+        if (workroom.enabled !== undefined && typeof workroom.enabled !== 'boolean') {
+            errors.push(`${path}.enabled: enabled must be a boolean`);
+        }
+        if (workroom.sponsors !== undefined) {
+            if (!Array.isArray(workroom.sponsors)) {
+                errors.push(`${path}.sponsors: sponsors must be an array of authenticated principal ids`);
+            }
+            else {
+                const seenSponsors = new Set();
+                workroom.sponsors.forEach((principalId, index) => {
+                    if (typeof principalId !== 'string' || !principalId.trim() || principalId !== principalId.trim()) {
+                        errors.push(`${path}.sponsors.${index}: Sponsor principal id must be canonical non-empty text`);
+                    }
+                    else if (seenSponsors.has(principalId)) {
+                        errors.push(`${path}.sponsors.${index}: duplicate Sponsor principal id "${principalId}"`);
+                    }
+                    else {
+                        seenSponsors.add(principalId);
+                    }
+                });
+            }
+        }
+        if (!Array.isArray(workroom.members)) {
+            errors.push(`${path}.members: members must be an array`);
+            continue;
+        }
+        const memberAgents = new Set();
+        const memberKeys = new Set();
+        const messageRouteOwners = new Map();
+        let orchestrators = 0;
+        workroom.members.forEach((member, index) => {
+            const memberPath = `${path}.members.${index}`;
+            if (!member || typeof member !== 'object') {
+                errors.push(`${memberPath}: member must be an object`);
+                return;
+            }
+            if (typeof member.agent !== 'string' || !member.agent.trim()) {
+                errors.push(`${memberPath}.agent: agent is required`);
+            }
+            else if (!agents.has(member.agent)) {
+                errors.push(`${memberPath}.agent: unknown Agent "${member.agent}"`);
+            }
+            if (!WORKROOM_ROLES.has(member.role)) {
+                errors.push(`${memberPath}.role: invalid Workroom role "${String(member.role)}"`);
+            }
+            if (member.assignmentRoute !== undefined) {
+                const route = member.assignmentRoute;
+                if (!route || typeof route !== 'object' || Array.isArray(route)
+                    || (route.kind !== 'local' && route.kind !== 'remote')) {
+                    errors.push(`${memberPath}.assignmentRoute: route must be local or remote`);
+                }
+                else if (route.kind === 'remote'
+                    && (typeof route.endpointId !== 'string'
+                        || !route.endpointId.trim()
+                        || route.endpointId !== route.endpointId.trim())) {
+                    errors.push(`${memberPath}.assignmentRoute.endpointId: endpoint id is required`);
+                }
+            }
+            if (member.messageRoute !== undefined) {
+                const route = member.messageRoute;
+                if (!route || typeof route !== 'object' || Array.isArray(route)) {
+                    errors.push(`${memberPath}.messageRoute: route must be an object`);
+                }
+                else if (typeof route.adapter !== 'string' || !route.adapter.trim()
+                    || route.adapter !== route.adapter.trim()) {
+                    errors.push(`${memberPath}.messageRoute.adapter: adapter is required`);
+                }
+                else if (typeof route.endpoint !== 'string' || !route.endpoint.trim()
+                    || route.endpoint !== route.endpoint.trim()) {
+                    errors.push(`${memberPath}.messageRoute.endpoint: endpoint is required`);
+                }
+                else {
+                    const routeKey = `${route.adapter}:${route.endpoint}`;
+                    const owner = messageRouteOwners.get(routeKey);
+                    if (owner && owner !== member.agent) {
+                        errors.push(`${memberPath}.messageRoute: Bot Endpoint "${routeKey}" is already assigned to member "${owner}"`);
+                    }
+                    else {
+                        messageRouteOwners.set(routeKey, member.agent);
+                    }
+                    if (endpointKeys && !endpointKeys.has(routeKey)) {
+                        errors.push(`${memberPath}.messageRoute: unknown configured Bot Endpoint "${routeKey}"`);
+                    }
+                }
+            }
+            if (member.role === 'orchestrator')
+                orchestrators += 1;
+            const key = `${member.agent}:${member.role}`;
+            if (memberKeys.has(key))
+                errors.push(`${memberPath}: duplicate Agent role membership "${key}"`);
+            memberKeys.add(key);
+            if (typeof member.agent === 'string' && member.agent)
+                memberAgents.add(member.agent);
+        });
+        if (workroom.enabled !== false && orchestrators === 0) {
+            errors.push(`${path}.members: enabled Workroom requires an orchestrator`);
+        }
+        const conversation = workroom.conversation;
+        if (workroom.enabled !== false && !conversation) {
+            errors.push(`${path}.conversation: enabled Workroom requires a collaboration space binding`);
+        }
+        for (const [field, binding] of [
+            ['conversation', conversation],
+            ['sponsorConversation', workroom.sponsorConversation],
+        ]) {
+            if (!binding)
+                continue;
+            validateConversationBinding({
+                binding, field, path, projectId, workroom, memberAgents,
+                enabledConversationOwners, endpointKeys, errors,
+            });
+        }
+        if (workroom.enabled !== false && conversation) {
+            const canonicalId = conversation.kind === 'repository'
+                ? conversation.id.toLowerCase()
+                : conversation.id;
+            for (const [index, member] of workroom.members.entries()) {
+                if (!member.messageRoute || typeof member.messageRoute !== 'object'
+                    || Array.isArray(member.messageRoute)
+                    || typeof member.messageRoute.adapter !== 'string'
+                    || typeof member.messageRoute.endpoint !== 'string')
+                    continue;
+                const address = `${member.messageRoute.adapter}:${member.messageRoute.endpoint}`
+                    + `:${conversation.kind}:${canonicalId}`;
+                const owner = enabledConversationOwners.get(address);
+                if (owner && !owner.projectIds.includes(projectId)) {
+                    const label = owner.kind === 'workroom' ? 'Workroom' : 'Sponsor Room';
+                    errors.push(`${path}.members.${index}.messageRoute: conversation "${address}" is already owned by enabled ${label} "${owner.projectIds.join(',')}"`);
+                }
+                else if (!owner) {
+                    enabledConversationOwners.set(address, { kind: 'workroom', projectIds: [projectId] });
+                }
+            }
+        }
+    }
+    for (const [address, owner] of enabledConversationOwners) {
+        if (owner.kind !== 'sponsor_room' || owner.projectIds.length < 2)
+            continue;
+        const audiences = owner.projectIds.map(projectId => ({
+            projectId,
+            sponsors: JSON.stringify([...(workrooms[projectId]?.sponsors ?? [])].sort()),
+        }));
+        if (audiences.some(audience => audience.sponsors === '[]')
+            || new Set(audiences.map(audience => audience.sponsors)).size !== 1) {
+            errors.push(`portfolio Sponsor Room "${address}" requires the same non-empty Sponsor audience for Projects "${owner.projectIds.join(',')}"`);
+        }
+    }
+    return errors;
+}
+function validateConversationBinding(input) {
+    const { binding, field, path, projectId, workroom, memberAgents, enabledConversationOwners, endpointKeys, errors } = input;
+    const conversationPath = `${path}.${field}`;
+    if (!binding || typeof binding !== 'object' || Array.isArray(binding)) {
+        errors.push(`${conversationPath}: conversation binding must be an object`);
+        return;
+    }
+    if (typeof binding.adapter !== 'string' || !binding.adapter.trim()) {
+        errors.push(`${conversationPath}.adapter: adapter is required`);
+    }
+    if (typeof binding.endpoint !== 'string' || !binding.endpoint.trim()) {
+        errors.push(`${conversationPath}.endpoint: endpoint is required`);
+    }
+    if (binding.kind !== 'group' && binding.kind !== 'channel' && binding.kind !== 'repository') {
+        errors.push(`${conversationPath}.kind: kind must be group, channel, or repository`);
+    }
+    if (field === 'sponsorConversation' && binding.kind === 'repository') {
+        errors.push(`${conversationPath}.kind: Sponsor Room must be a group or channel`);
+    }
+    if (typeof binding.id !== 'string' || !binding.id.trim()) {
+        errors.push(`${conversationPath}.id: collaboration space id is required`);
+    }
+    else if (binding.kind === 'repository' && !/^[^/\s]+\/[^/\s]+$/u.test(binding.id.trim())) {
+        errors.push(`${conversationPath}.id: repository id must be owner/repo`);
+    }
+    if (typeof binding.agent !== 'string' || !memberAgents.has(binding.agent)) {
+        errors.push(`${conversationPath}.agent: Agent must be a Workroom member`);
+    }
+    else if (!workroom.members.some(member => member.agent === binding.agent && member.role === 'orchestrator')) {
+        errors.push(`${conversationPath}.agent: Project Inbox Agent must have the orchestrator role`);
+    }
+    const endpointKey = `${binding.adapter}:${binding.endpoint}`;
+    if (endpointKeys && !endpointKeys.has(endpointKey)) {
+        errors.push(`${conversationPath}: unknown configured Bot Endpoint "${endpointKey}"`);
+    }
+    if (workroom.enabled !== false) {
+        const canonicalId = binding.kind === 'repository' ? binding.id.toLowerCase() : binding.id;
+        const address = `${endpointKey}:${binding.kind}:${canonicalId}`;
+        const owner = enabledConversationOwners.get(address);
+        const ownerKind = field === 'sponsorConversation' ? 'sponsor_room' : 'workroom';
+        if (owner && (owner.kind !== 'sponsor_room' || ownerKind !== 'sponsor_room')) {
+            const label = owner.kind === 'workroom' ? 'Workroom' : 'Sponsor Room';
+            errors.push(`${conversationPath}: conversation "${address}" is already owned by enabled ${label} "${owner.projectIds.join(',')}"`);
+        }
+        else if (owner) {
+            enabledConversationOwners.set(address, {
+                kind: 'sponsor_room', projectIds: [...owner.projectIds, projectId],
+            });
+        }
+        else {
+            enabledConversationOwners.set(address, { kind: ownerKind, projectIds: [projectId] });
+        }
+    }
+}
+//# sourceMappingURL=validate-catalog.js.map

package/lib/workroom/validate-catalog.js.map

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

package/lib/workroom/workflow-plan-builder.d.ts

@@ -0,0 +1,88 @@
+import { type WorkroomSchedulerPolicySnapshot, type WorkroomSponsorLane, type WorkroomTaskPreemptibility } from './workroom-scheduler.js';
+export interface WorkflowStrategyReference {
+    readonly id: string;
+    readonly version: string;
+    readonly digest: string;
+}
+export interface WorkflowTaskCapabilityRequirement {
+    readonly tools?: readonly string[];
+    readonly skills?: readonly string[];
+    readonly integrations?: readonly string[];
+    readonly authorities?: readonly string[];
+}
+export interface WorkflowPlanAuthoritySnapshot {
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly profileRevisionId: string;
+    readonly profileDigest: string;
+    readonly planningPolicyRevisionId: string;
+    readonly planningPolicyDigest: string;
+    readonly orchestratorAgentDefinitionId: string;
+    readonly orchestratorAuthorityDigest: string;
+}
+export interface WorkflowPlanBudget {
+    readonly maxTasks: number;
+    readonly maxTotalAttempts: number;
+}
+export interface WorkflowPlanApprovalGateInput {
+    readonly id: string;
+    readonly kind: 'sponsor';
+    readonly owner: string;
+    readonly decisionTimeoutMs: number;
+    readonly deadline: number;
+    readonly policyRevisionId: string;
+    readonly policyDigest: string;
+}
+export interface WorkflowPlanApprovalGate extends WorkflowPlanApprovalGateInput {
+    readonly allowedActions: readonly ['approve', 'reject', 'replan', 'cancel'];
+}
+export interface WorkflowPlanTaskSchedulerInput {
+    readonly sponsorLane: WorkroomSponsorLane;
+    readonly localRank: number;
+    readonly deadline: number;
+    readonly enqueuedAt: number;
+    readonly preemptibility: WorkroomTaskPreemptibility;
+}
+export interface WorkflowPlanTaskInput {
+    readonly key: string;
+    readonly title: string;
+    readonly role: string;
+    readonly required: boolean;
+    readonly maxAttempts: number;
+    readonly dependsOn: readonly string[];
+    readonly requires: WorkflowTaskCapabilityRequirement;
+    readonly scheduler: WorkflowPlanTaskSchedulerInput;
+    readonly approvalGate?: WorkflowPlanApprovalGateInput;
+}
+export interface WorkflowPlanTaskProposal extends Omit<WorkflowPlanTaskInput, 'requires' | 'approvalGate'> {
+    readonly requires: Readonly<Required<WorkflowTaskCapabilityRequirement>>;
+    readonly approvalGate?: WorkflowPlanApprovalGate;
+}
+export interface WorkflowPlanProposalMetadata {
+    readonly proposalId: string;
+    readonly projectId: string;
+    readonly strategy: WorkflowStrategyReference;
+    readonly parameterDigest: string;
+    readonly authority: WorkflowPlanAuthoritySnapshot;
+    readonly budget: WorkflowPlanBudget;
+    readonly schedulerPolicy: WorkroomSchedulerPolicySnapshot;
+}
+export interface WorkflowPlanProposal extends WorkflowPlanProposalMetadata {
+    readonly version: 1;
+    readonly tasks: readonly WorkflowPlanTaskProposal[];
+    readonly digest: string;
+}
+/** Revalidates untrusted planner output against the same canonical builder. */
+export declare function assertWorkflowPlanProposal(value: WorkflowPlanProposal): void;
+/**
+ * Persistent, I/O-free graph builder. It can only produce a versioned proposal;
+ * applying, scheduling and executing that proposal remain Kernel-owned concerns.
+ */
+export declare class WorkflowPlanBuilder {
+    #private;
+    private constructor();
+    static create(metadata: WorkflowPlanProposalMetadata): WorkflowPlanBuilder;
+    addTask(input: WorkflowPlanTaskInput): WorkflowPlanBuilder;
+    build(): WorkflowPlanProposal;
+}
+//# sourceMappingURL=workflow-plan-builder.d.ts.map

package/lib/workroom/workflow-plan-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-plan-builder.d.ts","sourceRoot":"","sources":["../../src/workroom/workflow-plan-builder.ts"],"names":[],"mappings":"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"}