@agenticprimitives/coordination 0.0.0-alpha.2

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export declare const PACKAGE_NAME = "@agenticprimitives/coordination";
+export declare const PACKAGE_STATUS = "w4-execution-and-recommendations";
+export declare const SPEC_REF = "specs/332-coordination-endeavor-core.md";
+export type { AllocationId, CommitmentId, CommandValidationResult, ContextRef, CoordinationCommandV1, CoordinationContextSnapshotV1, CoordinationEventV1, CoordinationPlanId, CoordinationStateV1, EndeavorEntryPoint, EndeavorId, EndeavorLifecycle, EndeavorRelationKind, EndeavorRelationV1, EndeavorRequestId, EndeavorRequestStatus, EndeavorRequestV1, EndeavorV1, ExternalObjectBindingV1, ExternalSyncMode, OutcomeCriterionKind, OutcomeCriterionV1, OutcomeSpecificationV1, ParticipationId, PlanStepId, ProposalId, ProvenanceActivitySummary, ProvenanceCorrespondenceSummary, ProvenanceEntitySummary, ProvenanceInputsV1, RecommendationId, SatisfiedStepV1, } from './core/index.js';
+export { COORDINATION_CLASS_IRIS, COORDINATION_COMMAND_KINDS, CoordinationEventError, CoordinationIdError, applyCoordinationEvent, assertAllocationId, assertCommitmentId, assertCoordinationPlanId, assertEndeavorId, assertEndeavorRequestId, assertParticipationId, assertPlanStepId, assertProposalId, assertRecommendationId, deriveProvenanceInputs, initialCoordinationState, makeAllocationId, makeCommitmentId, makeCoordinationPlanId, makeEndeavorId, makeEndeavorRequestId, makeParticipationId, makePlanStepId, makeProposalId, makeRecommendationId, planKey, validateCoordinationCommand, } from './core/index.js';
+export type { CapabilityRequirementRef, CoordinationPlanStatus, CoordinationPlanV1, CriterionRef, MilestoneAchievementV1, MilestoneDefinitionV1, PlanContentV1, PlanEdgeKind, PlanEdgeV1, PlanRevisionRef, PlanStepKind, PlanStepV1, PlanValidationResult, PlanVariableV1, } from './planning/index.js';
+export { planContentHash, validatePlanContent } from './planning/index.js';
+export type { AllocationDecisionV1, CommitmentStatus, ContributionCommitmentV1, ContributionProposalV1, EndeavorParticipationV1, ParticipationAssertion, ParticipationRole, ParticipationStatus, SignedPayloadRef, } from './participation/index.js';
+export type { CompilePlanInput, CompilePlanResult, ExecutionIntentDescriptorV1, ExecutionProvenanceKeysV1, } from './execution/index.js';
+export { compilePlanToExecutionIntents } from './execution/index.js';
+export type { CoordinationCommandTemplate, RecommendationStatus, RecommendationSubjectV1, RecommendationV1, TriageRecommendationDraftV1, TriageRequestRowV1, } from './decisions/index.js';
+export { goalTokens, projectTriageRecommendations } from './decisions/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,oCAAoC,CAAC;AAC9D,eAAO,MAAM,cAAc,qCAAqC,CAAC;AACjE,eAAO,MAAM,QAAQ,4CAA4C,CAAC;AAElE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,+BAA+B,EAC/B,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAErE,YAAY,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// @agenticprimitives/coordination — Endeavor coordination core (spec 332 W1; spec 334 W4
+// execution compilation + recommendation slice).
+export const PACKAGE_NAME = '@agenticprimitives/coordination';
+export const PACKAGE_STATUS = 'w4-execution-and-recommendations';
+export const SPEC_REF = 'specs/332-coordination-endeavor-core.md';
+export { COORDINATION_CLASS_IRIS, COORDINATION_COMMAND_KINDS, CoordinationEventError, CoordinationIdError, applyCoordinationEvent, assertAllocationId, assertCommitmentId, assertCoordinationPlanId, assertEndeavorId, assertEndeavorRequestId, assertParticipationId, assertPlanStepId, assertProposalId, assertRecommendationId, deriveProvenanceInputs, initialCoordinationState, makeAllocationId, makeCommitmentId, makeCoordinationPlanId, makeEndeavorId, makeEndeavorRequestId, makeParticipationId, makePlanStepId, makeProposalId, makeRecommendationId, planKey, validateCoordinationCommand, } from './core/index.js';
+export { planContentHash, validatePlanContent } from './planning/index.js';
+export { compilePlanToExecutionIntents } from './execution/index.js';
+export { goalTokens, projectTriageRecommendations } from './decisions/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,iDAAiD;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAG,iCAAiC,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,kCAAkC,CAAC;AACjE,MAAM,CAAC,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAoClE,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAkBzB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAoB3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAUrE,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/participation/index.d.ts

@@ -0,0 +1,2 @@
+export type { AllocationDecisionV1, CommitmentStatus, ContributionCommitmentV1, ContributionProposalV1, EndeavorParticipationV1, ParticipationAssertion, ParticipationRole, ParticipationStatus, SignedPayloadRef, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/participation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/participation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/participation/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/participation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/participation/index.ts"],"names":[],"mappings":""}

package/dist/participation/types.d.ts

@@ -0,0 +1,66 @@
+import type { Address, Hex, Hex32 } from '@agenticprimitives/types';
+import type { EntityRef, SituationValidity } from '@agenticprimitives/situations';
+import type { AllocationId, CommitmentId, EndeavorId, ParticipationId, PlanStepId, ProposalId } from '../core/ids.js';
+import type { PlanRevisionRef } from '../planning/types.js';
+/** Reference to a signature over a canonical payload hash. Carrying the proof is never itself
+ *  authorization; verification (ERC-1271/6492/ECDSA/WebAuthn) is the serving plane's job. */
+export interface SignedPayloadRef {
+    payloadHash: Hex32;
+    signer: Address;
+    scheme: 'erc1271' | 'erc6492' | 'ecdsa' | 'webauthn';
+    signature: Hex;
+}
+export type ParticipationRole = 'sponsor' | 'coordinator' | 'contributor' | 'validator' | 'beneficiary' | 'observer';
+export type ParticipationAssertion = 'invitation-acceptance' | 'allocation-commitment' | 'self-sponsor';
+export type ParticipationStatus = 'invited' | 'active' | 'withdrawn';
+export interface EndeavorParticipationV1 {
+    schema: 'apcoord/EndeavorParticipationV1';
+    participationId: ParticipationId;
+    endeavorId: EndeavorId;
+    participant: Address;
+    role: ParticipationRole;
+    scope?: PlanStepId[];
+    validity: SituationValidity;
+    assertedBy: ParticipationAssertion;
+    status: ParticipationStatus;
+}
+export interface ContributionProposalV1 {
+    schema: 'apcoord/ContributionProposalV1';
+    proposalId: ProposalId;
+    endeavorId: EndeavorId;
+    proposer: Address;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    note?: string;
+    proposedAt: string;
+    status: 'open' | 'allocated' | 'declined';
+}
+/** The Endeavor's selection of a participant for a contribution. Grants nothing (spec 332 §9). */
+export interface AllocationDecisionV1 {
+    schema: 'apcoord/AllocationDecisionV1';
+    allocationId: AllocationId;
+    endeavorId: EndeavorId;
+    proposalRef: ProposalId;
+    participant: Address;
+    steps: PlanStepId[];
+    decidedBy: Address;
+    decidedAt: string;
+    status: 'allocated' | 'committed' | 'reallocated';
+}
+export type CommitmentStatus = 'active' | 'fulfilled' | 'withdrawn' | 'reallocated';
+export interface ContributionCommitmentV1 {
+    schema: 'apcoord/ContributionCommitmentV1';
+    commitmentId: CommitmentId;
+    endeavorId: EndeavorId;
+    allocationRef: AllocationId;
+    participant: Address;
+    planRef: PlanRevisionRef;
+    steps: PlanStepId[];
+    signature: SignedPayloadRef;
+    bounds?: {
+        deadline?: string;
+        effortEstimateRef?: EntityRef;
+    };
+    status: CommitmentStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/participation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/participation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;6FAC6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACrD,SAAS,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErH,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,GAAG,uBAAuB,GAAG,cAAc,CAAC;AAExG,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,iCAAiC,CAAC;IAC1C,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,sBAAsB,CAAC;IACnC,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gCAAgC,CAAC;IACzC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;CAC3C;AAED,kGAAkG;AAClG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,8BAA8B,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;CACnD;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAC9D,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/participation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/participation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/participation/types.ts"],"names":[],"mappings":""}

package/dist/planning/hash.d.ts

@@ -0,0 +1,8 @@
+import type { Hex32 } from '@agenticprimitives/types';
+import type { PlanContentV1 } from './types.js';
+/**
+ * Content hash of a plan revision: `sha256(JCS({ steps, edges, milestones }))`.
+ * Adoption and every ContributionCommitment bind to this exact hash (spec 332 §5/§6/§9).
+ */
+export declare function planContentHash(content: PlanContentV1): Hex32;
+//# sourceMappingURL=hash.d.ts.map

package/dist/planning/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/planning/hash.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAU7D"}

package/dist/planning/hash.js

@@ -0,0 +1,20 @@
+import { sha256 } from '@noble/hashes/sha2.js';
+import { utf8ToBytes } from '@noble/hashes/utils.js';
+import { jcsCanonicalize } from '@agenticprimitives/situations';
+/**
+ * Content hash of a plan revision: `sha256(JCS({ steps, edges, milestones }))`.
+ * Adoption and every ContributionCommitment bind to this exact hash (spec 332 §5/§6/§9).
+ */
+export function planContentHash(content) {
+    const canonical = jcsCanonicalize({
+        steps: content.steps,
+        edges: content.edges,
+        milestones: content.milestones,
+    });
+    const digest = sha256(utf8ToBytes(canonical));
+    let hex = '';
+    for (const b of digest)
+        hex += b.toString(16).padStart(2, '0');
+    return `0x${hex}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/planning/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/planning/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/D,OAAO,KAAK,GAAG,EAAW,CAAC;AAC7B,CAAC"}

package/dist/planning/index.d.ts

@@ -0,0 +1,5 @@
+export type { CapabilityRequirementRef, CoordinationPlanStatus, CoordinationPlanV1, CriterionRef, MilestoneAchievementV1, MilestoneDefinitionV1, PlanContentV1, PlanEdgeKind, PlanEdgeV1, PlanRevisionRef, PlanStepKind, PlanStepV1, PlanVariableV1, } from './types.js';
+export { planContentHash } from './hash.js';
+export { validatePlanContent } from './validate.js';
+export type { PlanValidationResult } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/planning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/planning/index.js

@@ -0,0 +1,3 @@
+export { planContentHash } from './hash.js';
+export { validatePlanContent } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/planning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/planning/types.d.ts

@@ -0,0 +1,75 @@
+import type { Hex32 } from '@agenticprimitives/types';
+import type { Address } from '@agenticprimitives/types';
+import type { EntityRef } from '@agenticprimitives/situations';
+import type { CoordinationPlanId, EndeavorId, PlanStepId } from '../core/ids.js';
+/** Pointer to an OutcomeCriterion / criterion record governing activation or completion of a step. */
+export interface CriterionRef {
+    criterionId: string;
+    hash?: Hex32;
+}
+/** `aps:Capability` requirement + minimum assertion strength (ADR-0053) — reference only, never authority. */
+export interface CapabilityRequirementRef {
+    capabilityIri: string;
+    minAssertionStrength: 'declared' | 'claimed' | 'demonstrated';
+}
+/** Exact (planId, revision, contentHash) triple — what adoption and commitments bind to. */
+export interface PlanRevisionRef {
+    planId: CoordinationPlanId;
+    revision: number;
+    hash: Hex32;
+}
+/** `p-plan:Variable` binding on a step. */
+export interface PlanVariableV1 {
+    name: string;
+    description?: string;
+    bindingRef?: EntityRef;
+}
+export type PlanStepKind = 'contribution' | 'interaction' | 'decision' | 'aggregation' | 'validation';
+export interface PlanStepV1 {
+    stepId: PlanStepId;
+    kind: PlanStepKind;
+    description: string;
+    capabilityRequirements?: CapabilityRequirementRef[];
+    inputs?: PlanVariableV1[];
+    outputs?: PlanVariableV1[];
+    activation?: CriterionRef;
+    completion?: CriterionRef;
+}
+export type PlanEdgeKind = 'precedes' | 'depends-on' | 'alternative' | 'condition' | 'compensates' | 'refines';
+export interface PlanEdgeV1 {
+    from: PlanStepId;
+    to: PlanStepId;
+    kind: PlanEdgeKind;
+}
+export interface MilestoneDefinitionV1 {
+    milestoneId: string;
+    title: string;
+    criteria: CriterionRef[];
+}
+export interface MilestoneAchievementV1 {
+    schema: 'apcoord/MilestoneAchievementV1';
+    milestoneId: string;
+    endeavorId: EndeavorId;
+    evidenceRefs: EntityRef[];
+    achievedAt: string;
+}
+export type CoordinationPlanStatus = 'proposed' | 'adopted' | 'superseded' | 'rejected';
+export interface CoordinationPlanV1 {
+    schema: 'apcoord/CoordinationPlanV1';
+    planId: CoordinationPlanId;
+    endeavorId: EndeavorId;
+    revision: number;
+    contentHash: Hex32;
+    steps: PlanStepV1[];
+    edges: PlanEdgeV1[];
+    milestones: MilestoneDefinitionV1[];
+    proposedBy: Address;
+    status: CoordinationPlanStatus;
+}
+/** The hash preimage of a plan revision — steps + edges + milestones, JCS-canonicalized. */
+export interface PlanContentV1 {
+    steps: PlanStepV1[];
+    edges: PlanEdgeV1[];
+    milestones: MilestoneDefinitionV1[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/planning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/planning/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjF,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,8GAA8G;AAC9G,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;CAC/D;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;AAEtG,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpD,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAE/G,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gCAAgC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,4BAA4B,CAAC;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC"}

package/dist/planning/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/planning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/planning/types.ts"],"names":[],"mappings":""}

package/dist/planning/validate.d.ts

@@ -0,0 +1,13 @@
+import type { PlanContentV1 } from './types.js';
+export type PlanValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Structural plan validation (spec 332 §6, `ProposePlan`): step ids unique, every edge endpoint
+ * exists, and the `precedes` edges form a DAG. Fail-closed: first violation rejects.
+ */
+export declare function validatePlanContent(content: PlanContentV1): PlanValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/planning/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/planning/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CA+ChF"}

package/dist/planning/validate.js

@@ -0,0 +1,55 @@
+/**
+ * Structural plan validation (spec 332 §6, `ProposePlan`): step ids unique, every edge endpoint
+ * exists, and the `precedes` edges form a DAG. Fail-closed: first violation rejects.
+ */
+export function validatePlanContent(content) {
+    if (content.steps.length === 0)
+        return { ok: false, reason: 'plan has no steps' };
+    const stepIds = new Set();
+    for (const step of content.steps) {
+        if (stepIds.has(step.stepId))
+            return { ok: false, reason: `duplicate step id ${step.stepId}` };
+        stepIds.add(step.stepId);
+    }
+    for (const edge of content.edges) {
+        if (!stepIds.has(edge.from))
+            return { ok: false, reason: `edge references unknown step ${edge.from}` };
+        if (!stepIds.has(edge.to))
+            return { ok: false, reason: `edge references unknown step ${edge.to}` };
+        if (edge.from === edge.to)
+            return { ok: false, reason: `self-edge on step ${edge.from}` };
+    }
+    const adjacency = new Map();
+    for (const edge of content.edges) {
+        if (edge.kind !== 'precedes')
+            continue;
+        const list = adjacency.get(edge.from) ?? [];
+        list.push(edge.to);
+        adjacency.set(edge.from, list);
+    }
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = new Map();
+    for (const id of stepIds)
+        color.set(id, WHITE);
+    const visit = (node) => {
+        color.set(node, GRAY);
+        for (const next of adjacency.get(node) ?? []) {
+            const c = color.get(next);
+            if (c === GRAY)
+                return false;
+            if (c === WHITE && !visit(next))
+                return false;
+        }
+        color.set(node, BLACK);
+        return true;
+    };
+    for (const id of stepIds) {
+        if (color.get(id) === WHITE && !visit(id)) {
+            return { ok: false, reason: 'precedes edges contain a cycle' };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=validate.js.map

package/dist/planning/validate.js.map

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

package/dist/profiles/index.d.ts

@@ -0,0 +1,11 @@
+export declare const PROFILES_STATUS = "reserved-spec-333";
+export type CoordinationProfileV1 = {
+    readonly __reserved: 'apcoord/CoordinationProfileV1 (spec 333)';
+};
+export type CustomFieldDefinitionV1 = {
+    readonly __reserved: 'apcoord/CustomFieldDefinitionV1 (spec 333)';
+};
+export type IntakeConfigurationV1 = {
+    readonly __reserved: 'apcoord/IntakeConfigurationV1 (spec 333)';
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,0CAA0C,CAAA;CAAE,CAAC;AACxG,MAAM,MAAM,uBAAuB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,4CAA4C,CAAA;CAAE,CAAC;AAC5G,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,0CAA0C,CAAA;CAAE,CAAC"}

package/dist/profiles/index.js

@@ -0,0 +1,3 @@
+// Reserved API surface for spec 333 (profiles / custom fields / lifecycles / intake). No logic ships here.
+export const PROFILES_STATUS = 'reserved-spec-333';
+//# sourceMappingURL=index.js.map

package/dist/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC"}

package/dist/projections/index.d.ts

@@ -0,0 +1,8 @@
+export declare const PROJECTIONS_STATUS = "reserved-spec-333";
+export type WorkBoardProjectionV1 = {
+    readonly __reserved: 'apcoord/WorkBoardProjectionV1 (spec 334)';
+};
+export type MyWorkProjectionV1 = {
+    readonly __reserved: 'apcoord/MyWorkProjectionV1 (spec 334)';
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/projections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projections/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,0CAA0C,CAAA;CAAE,CAAC;AACxG,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,uCAAuC,CAAA;CAAE,CAAC"}

package/dist/projections/index.js

@@ -0,0 +1,3 @@
+// Reserved API surface for spec 333/334 (derived read models — board, calendar, My Work). No logic ships here.
+export const PROJECTIONS_STATUS = 'reserved-spec-333';
+//# sourceMappingURL=index.js.map

package/dist/projections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projections/index.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@agenticprimitives/coordination",
+  "version": "0.0.0-alpha.2",
+  "description": "Coordination core: Endeavor, OutcomeSpecification, CoordinationPlan, Participation — spec 332 W1.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
+    "directory": "packages/coordination"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./planning": {
+      "types": "./dist/planning/index.d.ts",
+      "import": "./dist/planning/index.js"
+    },
+    "./participation": {
+      "types": "./dist/participation/index.d.ts",
+      "import": "./dist/participation/index.js"
+    },
+    "./profiles": {
+      "types": "./dist/profiles/index.d.ts",
+      "import": "./dist/profiles/index.js"
+    },
+    "./decisions": {
+      "types": "./dist/decisions/index.d.ts",
+      "import": "./dist/decisions/index.js"
+    },
+    "./execution": {
+      "types": "./dist/execution/index.d.ts",
+      "import": "./dist/execution/index.js"
+    },
+    "./projections": {
+      "types": "./dist/projections/index.d.ts",
+      "import": "./dist/projections/index.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "spec.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@noble/hashes": "^2.2.0",
+    "@agenticprimitives/ontology": "1.0.0-alpha.19",
+    "@agenticprimitives/situations": "0.0.0-alpha.3",
+    "@agenticprimitives/types": "1.0.0-alpha.19"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.8"
+  },
+  "keywords": [
+    "agentic",
+    "coordination",
+    "endeavor",
+    "p-plan"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}

package/spec.md

@@ -0,0 +1 @@
+See [spec 332](../../specs/332-coordination-endeavor-core.md) (Wave 1) + [ADR-0054](../../docs/architecture/decisions/0054-coordination-endeavor-doctrine.md).