@ixo/topic-protocol 0.8.0 → 1.0.0-rc.2

package/dist/src/shapes/state.d.ts

@@ -0,0 +1,105 @@
+import type { TopicContractBodyV3, TopicContractBodyV4 } from "../contracts/topic-contract.js";
+import type { TopicFlowBindingV1 } from "../action-runtime/types.js";
+import type { TopicAnchor, TopicContractHeads, TopicRootV3, TopicRootV4 } from "../projector/types.js";
+import type { ResolvedTopicClaimBindingV1, TopicClaimBindingV1, TopicProgressProjectionV1, TopicProgressProjectionV2, TopicShapeSourceRefV1 } from "./types.js";
+export declare const TOPIC_STATE_PROFILE_V3 = "qi.topic-contract-state/v3";
+export declare const TOPIC_STATE_PROFILE_V4 = "qi.topic-contract-state/v4";
+export interface TopicContractReferenceV3 {
+    readonly revision: string;
+    readonly bodyHash: string;
+    readonly bodyRef: Readonly<Record<string, unknown>>;
+    readonly body?: TopicContractBodyV3;
+}
+export interface TopicContractReferenceV4 {
+    readonly revision: string;
+    readonly bodyHash: `sha256:${string}`;
+    readonly bodyRef: Readonly<Record<string, unknown>>;
+    readonly body?: TopicContractBodyV4;
+}
+export interface TopicContractConfirmationV1 {
+    readonly operationId: string;
+    readonly contractRevision: string;
+    readonly bodyHash: `sha256:${string}`;
+    readonly policyDigest: `sha256:${string}`;
+    readonly actor: string;
+    readonly confirmedAt: string;
+    readonly requiredAbility: string;
+    readonly authorityProofRef: string;
+    readonly withdrawnAt?: string;
+}
+export interface TopicContractAssentV1 extends Omit<TopicContractConfirmationV1, "confirmedAt"> {
+    readonly assentedAt: string;
+}
+export interface TopicContractHeadsV4 {
+    readonly proposed?: TopicContractReferenceV4 & {
+        readonly confirmations?: readonly TopicContractConfirmationV1[];
+        readonly assents?: readonly TopicContractAssentV1[];
+    };
+    readonly effective?: TopicContractReferenceV4 & {
+        readonly effectiveAt: string;
+        readonly confirmations: readonly TopicContractConfirmationV1[];
+        readonly assents?: readonly TopicContractAssentV1[];
+    };
+    readonly superseded?: readonly (TopicContractReferenceV4 & {
+        readonly supersededAt: string;
+    })[];
+}
+export interface TopicStateBindingsV3 {
+    readonly flows?: readonly TopicFlowBindingV1[];
+    readonly context?: readonly {
+        readonly type: "ixo.resource" | "ixo.flow" | "matrix.conversation" | "ixo.entity" | "ixo.service";
+        readonly id: string;
+        readonly label?: string;
+    }[];
+    readonly udidReferences?: readonly {
+        readonly id: string;
+        readonly role: "evaluation" | "decision" | "effect" | "settlement";
+        readonly digest?: `sha256:${string}`;
+    }[];
+}
+interface TopicContractStateCommonV1 {
+    readonly schema: "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json";
+    readonly topicId: string;
+    readonly anchor: TopicAnchor;
+    readonly shape: {
+        readonly digest: `sha256:${string}`;
+        readonly sources: readonly TopicShapeSourceRefV1[];
+    };
+    readonly policy: Readonly<Record<string, unknown>>;
+    readonly bindings: TopicStateBindingsV3;
+    readonly provenance: Readonly<Record<string, unknown>>;
+    readonly extensions?: Readonly<Record<string, unknown>>;
+}
+interface TopicStateProjectionCommonV1 {
+    readonly revision: string;
+    readonly contractRevision: string;
+    readonly title: string;
+    readonly attachmentCount: number;
+    readonly operationCount: number;
+    readonly claimBinding?: TopicClaimBindingV1;
+    readonly claimResolution?: ResolvedTopicClaimBindingV1;
+}
+export interface TopicContractStateV3 extends TopicContractStateCommonV1 {
+    readonly version: 3;
+    readonly profile: typeof TOPIC_STATE_PROFILE_V3;
+    readonly manifest: TopicRootV3;
+    readonly contracts: TopicContractHeads;
+    readonly progress: TopicProgressProjectionV1;
+    readonly projection: TopicStateProjectionCommonV1 & {
+        readonly status: TopicRootV3["status"];
+        readonly kindRef: TopicContractBodyV3["kindRef"];
+    };
+}
+export interface TopicContractStateV4 extends TopicContractStateCommonV1 {
+    readonly version: 4;
+    readonly profile: typeof TOPIC_STATE_PROFILE_V4;
+    readonly manifest: TopicRootV4;
+    readonly contracts: TopicContractHeadsV4;
+    readonly progress: TopicProgressProjectionV2;
+    readonly projection: TopicStateProjectionCommonV1 & {
+        readonly status: TopicRootV4["status"];
+        readonly setupStatus: "draft" | "awaiting-confirmation" | "scheduled" | "confirmed" | "review-due" | "expired" | "disputed";
+        readonly kindRef: TopicContractBodyV4["kindRef"];
+    };
+}
+export {};

package/dist/src/shapes/state.js

@@ -0,0 +1,3 @@
+export const TOPIC_STATE_PROFILE_V3 = "qi.topic-contract-state/v3";
+export const TOPIC_STATE_PROFILE_V4 = "qi.topic-contract-state/v4";
+//# sourceMappingURL=state.js.map

package/dist/src/shapes/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/shapes/state.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC"}

package/dist/src/shapes/types.d.ts

@@ -0,0 +1,392 @@
+export declare const SHAPE_PHASES: readonly ["forming", "working", "verifying", "deciding", "effecting", "settling", "complete", "dormant"];
+export declare const SHAPE_CONDITIONS: readonly ["on-track", "needs-input", "needs-confirmation", "review-due", "expired", "waiting", "blocked", "failed", "disputed", "degraded"];
+export declare const SHAPE_ATTENTION_STATES: readonly ["none", "viewer-action-required", "viewer-review-required", "viewer-confirmation-required"];
+export declare const BASE_RECIPE_CODES: readonly ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"];
+export declare const TOPIC_RECIPE_CODES: readonly ["research-brief", "agent-delivery", "verified-work-payment"];
+export type ShapePhaseV1 = (typeof SHAPE_PHASES)[number];
+export type ShapeConditionV1 = (typeof SHAPE_CONDITIONS)[number];
+export type ShapeAttentionV1 = (typeof SHAPE_ATTENTION_STATES)[number];
+export type BaseRecipeCodeV1 = (typeof BASE_RECIPE_CODES)[number];
+export type TopicRecipeCodeV1 = (typeof TOPIC_RECIPE_CODES)[number];
+export type ShapeConsequenceClassV1 = "none" | "shared-state" | "external-effect" | "settlement";
+export type ShapeConfirmationPolicyV1 = "none" | "viewer" | "authority";
+export type ShapeEvidenceRequirementV1 = {
+    readonly kind: "operation" | "record" | "receipt";
+    readonly type: string;
+    readonly finality?: "observed" | "accepted" | "verified" | "final";
+};
+export type TopicSubjectRefV1 = {
+    readonly kind: "actor";
+    readonly id: string;
+} | {
+    readonly kind: "role";
+    readonly id: string;
+};
+export interface TopicConfirmationPolicyV1 {
+    readonly mode: "any" | "all" | "threshold";
+    readonly subjects: readonly TopicSubjectRefV1[];
+    readonly threshold?: number;
+}
+export interface TopicAssentPolicyV1 {
+    readonly mode: "any" | "all" | "threshold";
+    readonly signatories: readonly TopicSubjectRefV1[];
+    readonly threshold?: number;
+}
+export interface TopicDisputePolicyV1 {
+    readonly resolvers?: readonly TopicSubjectRefV1[];
+    readonly process?: {
+        readonly kind: "flow" | "resource";
+        readonly id: string;
+        readonly label?: string;
+    };
+}
+export interface TopicActivationPolicyV1 {
+    /** Drafts may leave any activation detail unresolved; effectiveness may not. */
+    readonly editors?: readonly TopicSubjectRefV1[];
+    readonly confirmation?: TopicConfirmationPolicyV1;
+    readonly lifecycle?: {
+        readonly effectiveAt?: string;
+        readonly reviewAt?: string;
+        readonly expiresAt?: string;
+        readonly onExpiry: "pause-consequential";
+    };
+    readonly dispute?: TopicDisputePolicyV1;
+}
+export interface ShapeRequirementPresentationV1 {
+    readonly code: string;
+    readonly labelKey: string;
+    readonly promptKey: string;
+    readonly purposeKey: string;
+    readonly priority: number;
+    readonly focusPath?: string;
+    readonly assignedTo?: {
+        readonly kind: "actor" | "role";
+        readonly value: string;
+    };
+}
+export type ShapeGateV1 = ({
+    readonly kind: "field";
+    readonly path: string;
+    readonly predicate: "present" | "accepted";
+} | {
+    readonly kind: "field-any";
+    readonly paths: readonly string[];
+    readonly predicate: "present" | "accepted";
+} | {
+    readonly kind: "record";
+    readonly type: string;
+    readonly status?: string;
+} | {
+    readonly kind: "receipt";
+    readonly type: string;
+    readonly status?: string;
+} | {
+    readonly kind: "axis";
+    readonly axis: string;
+    readonly states: readonly string[];
+} | {
+    readonly kind: "binding";
+    readonly type: "flow" | "claim" | "resource";
+} | {
+    readonly kind: "condition";
+    readonly states: readonly ("waiting" | "blocked" | "failed" | "disputed")[];
+}) & {
+    readonly requirement?: ShapeRequirementPresentationV1;
+};
+export interface ShapeStateDefinitionV1 {
+    readonly code: string;
+    readonly labelKey?: string;
+    readonly terminal?: boolean;
+    readonly condition?: ShapeConditionV1;
+}
+export interface ShapeStateAxisV1 {
+    readonly code: string;
+    readonly phase: ShapePhaseV1;
+    readonly required: boolean;
+    readonly initialState: string;
+    readonly states: readonly ShapeStateDefinitionV1[];
+}
+export interface ShapeTransitionV1 {
+    readonly code: string;
+    readonly phase: ShapePhaseV1;
+    readonly predecessor: {
+        readonly axis: string;
+        readonly state: string;
+    };
+    readonly target: {
+        readonly axis: string;
+        readonly state: string;
+    };
+    readonly command: string;
+    readonly requiredAbility: string;
+    readonly assignedTo: {
+        readonly kind: "actor" | "role";
+        readonly value: string;
+    };
+    readonly gates: readonly ShapeGateV1[];
+    readonly confirmation: ShapeConfirmationPolicyV1;
+    readonly consequence: ShapeConsequenceClassV1;
+    readonly evidence: ShapeEvidenceRequirementV1;
+    readonly completesTopic?: boolean;
+    readonly handoff?: {
+        readonly kind: "flow" | "resource";
+        readonly binding: string;
+    };
+    readonly presentation?: {
+        readonly reasonCode: string;
+        readonly actionLabelKey?: string;
+        readonly bodyKey?: string;
+        readonly purposeKey?: string;
+        readonly unlocksKey?: string;
+        readonly priority?: number;
+        readonly focusPath?: string;
+    };
+}
+export interface ShapeProgressRuleV1 {
+    readonly code: string;
+    readonly condition: Exclude<ShapeConditionV1, "on-track" | "degraded">;
+    readonly priority: number;
+    readonly source: {
+        readonly kind: "axis" | "record" | "receipt" | "topic";
+        readonly value: string;
+    };
+    readonly states?: readonly string[];
+    readonly requiresTarget?: boolean;
+}
+export interface TopicShapeV1 {
+    readonly version: 1;
+    readonly code: string;
+    readonly axes: readonly ShapeStateAxisV1[];
+    readonly transitions: readonly ShapeTransitionV1[];
+    readonly progressRules: readonly ShapeProgressRuleV1[];
+    readonly inferredRecordPolicy: {
+        readonly autoAccept: readonly string[];
+        readonly neverAutoAccept: readonly string[];
+    };
+}
+export type TopicShapeOverlayV1 = Omit<TopicShapeV1, "axes" | "transitions" | "progressRules"> & {
+    readonly axes?: readonly ShapeStateAxisV1[];
+    readonly transitions?: readonly ShapeTransitionV1[];
+    readonly progressRules?: readonly ShapeProgressRuleV1[];
+};
+export interface TopicShapeSourceRefV1 {
+    readonly kind: "base-recipe" | "topic-recipe" | "kind" | "topic";
+    readonly id: string;
+    readonly version: string;
+    readonly digest: `sha256:${string}`;
+}
+export interface TopicRecipeRefV1 {
+    readonly id: string;
+    readonly version: string;
+    readonly digest: `sha256:${string}`;
+}
+export interface TopicRecipeV1 {
+    readonly version: 1;
+    readonly code: TopicRecipeCodeV1;
+    readonly id: string;
+    readonly recipeVersion: string;
+    readonly label: string;
+    readonly description: string;
+    readonly baseRecipe: BaseRecipeCodeV1;
+    readonly creates: "draft";
+    readonly shape: TopicShapeV1;
+}
+export interface EffectiveTopicShapeV1 {
+    readonly version: 1;
+    readonly shape: TopicShapeV1;
+    readonly sources: readonly TopicShapeSourceRefV1[];
+    readonly digest: `sha256:${string}`;
+}
+export interface TopicClaimBindingV1 {
+    readonly entityDid: string;
+    readonly collectionId: string;
+}
+export interface ResolvedTopicClaimBindingV1 extends TopicClaimBindingV1 {
+    readonly protocolDid: string;
+    readonly rubric: {
+        readonly id: string;
+        readonly digest?: `sha256:${string}`;
+    };
+}
+export interface TopicProgressSourceV1 {
+    readonly kind: "operation" | "record" | "receipt";
+    readonly type: string;
+    readonly id: string;
+    readonly status?: string;
+    readonly finality?: "observed" | "accepted" | "verified" | "final";
+}
+export interface TopicProgressSourceV2 extends TopicProgressSourceV1 {
+    readonly actor?: string;
+    readonly contractRevision?: string;
+    readonly bodyHash?: `sha256:${string}`;
+    readonly policyDigest?: `sha256:${string}`;
+    readonly authorityProofRef?: string;
+}
+export interface TopicEvaluationTimeV1 {
+    readonly at: string;
+    readonly source: "matrix" | "server" | "system" | "client";
+    readonly trusted: boolean;
+    readonly freshUntil?: string;
+}
+export interface TopicDisputeV1 {
+    readonly id: string;
+    readonly status: "open" | "resolved";
+    readonly reasonCode: string;
+    readonly raisedBy: string;
+    readonly affectedRevision: string;
+    readonly resolver: TopicSubjectRefV1;
+    readonly process?: TopicDisputePolicyV1["process"];
+    readonly resolutionRef?: string;
+}
+export interface TopicProgressBlockV1 {
+    readonly condition: "waiting" | "blocked" | "failed" | "disputed";
+    readonly sourceId: string;
+    readonly target: {
+        readonly kind: "actor" | "flow" | "resource" | "external";
+        readonly id: string;
+    };
+    readonly reasonCode: string;
+}
+export interface TopicProgressInputV1 {
+    readonly topicId: string;
+    readonly topicRevision: string;
+    readonly contractRevision: string;
+    readonly status: "draft" | "active" | "resolved" | "archived" | "redirected";
+    readonly shape?: EffectiveTopicShapeV1;
+    readonly historyCompatible: boolean;
+    readonly axisStates: Readonly<Record<string, string>>;
+    readonly sources: readonly TopicProgressSourceV1[];
+    readonly presentFields?: readonly string[];
+    readonly acceptedFields?: readonly string[];
+    readonly bindings?: readonly ("flow" | "claim" | "resource")[];
+    readonly actorAssignments?: Readonly<Record<string, readonly string[]>>;
+    readonly block?: TopicProgressBlockV1;
+}
+export interface TopicStateTagV1 {
+    readonly code: string;
+    readonly source: {
+        readonly axis: string;
+        readonly state: string;
+    } | {
+        readonly progressRule: string;
+    };
+    readonly priority: number;
+    readonly tone: "neutral" | "info" | "attention" | "warning" | "critical" | "positive";
+    readonly provenance: readonly string[];
+}
+export interface TopicTransitionCandidateV1 {
+    readonly transition: ShapeTransitionV1;
+    readonly assignedActor?: string;
+    readonly assignedActors?: readonly string[];
+    readonly gateStatus: readonly {
+        readonly gate: ShapeGateV1;
+        readonly satisfied: boolean;
+    }[];
+}
+export type TopicObligationKindV1 = "safety" | "input" | "confirmation" | "assent" | "transition" | "wait" | "review" | "expiry" | "dispute";
+export type TopicObligationStatusV1 = "open" | "ready" | "waiting" | "blocked" | "unavailable";
+export interface TopicObligationV1 {
+    readonly id: string;
+    readonly code: string;
+    readonly kind: TopicObligationKindV1;
+    readonly phase: ShapePhaseV1;
+    readonly status: TopicObligationStatusV1;
+    readonly priority: number;
+    readonly blocking: boolean;
+    readonly responsibility?: {
+        readonly kind: "actor" | "role";
+        readonly value: string;
+    };
+    readonly assignedActors: readonly string[];
+    readonly requiredAbility?: string;
+    readonly consequence: ShapeConsequenceClassV1;
+    readonly focusPath?: string;
+    readonly transitionCode?: string;
+    readonly command?: string;
+    readonly handoff?: ShapeTransitionV1["handoff"];
+    readonly presentation: {
+        readonly labelKey: string;
+        readonly promptKey: string;
+        readonly purposeKey: string;
+        readonly unlocksKey?: string;
+    };
+    readonly provenance: readonly string[];
+}
+export type TopicProgressInputV2 = Omit<TopicProgressInputV1, "sources" | "shape"> & {
+    readonly shape?: EffectiveTopicShapeV1;
+    readonly sources: readonly TopicProgressSourceV2[];
+    readonly contractBodyHash: `sha256:${string}`;
+    readonly policyDigest: `sha256:${string}`;
+    readonly activationPolicy?: TopicActivationPolicyV1;
+    readonly assentPolicy?: TopicAssentPolicyV1;
+    readonly evaluationTime?: TopicEvaluationTimeV1;
+    readonly dispute?: TopicDisputeV1;
+};
+interface TopicProgressProjectionCommonV1 {
+    readonly topicId: string;
+    readonly topicRevision: string;
+    readonly contractRevision: string;
+    readonly shapeDigest: `sha256:${string}`;
+    readonly phase: ShapePhaseV1;
+    readonly condition: ShapeConditionV1;
+    readonly reasonCode: string;
+    readonly axisStates: Readonly<Record<string, string>>;
+    readonly stateTags: readonly TopicStateTagV1[];
+    readonly candidates: readonly TopicTransitionCandidateV1[];
+    readonly provenance: readonly string[];
+    readonly block?: TopicProgressBlockV1;
+}
+export interface TopicProgressProjectionV1 extends TopicProgressProjectionCommonV1 {
+    readonly version: 1;
+}
+export interface TopicProgressProjectionV2 extends TopicProgressProjectionCommonV1 {
+    readonly version: 2;
+    readonly obligations: readonly TopicObligationV1[];
+    readonly primaryObligationId?: string;
+    readonly evaluatedAt?: TopicEvaluationTimeV1;
+    readonly dispute?: TopicDisputeV1;
+}
+export interface TopicViewerAuthorityV1 {
+    readonly viewerId: string;
+    readonly matrixWrite: boolean;
+    readonly verifiedAbilities: readonly string[];
+    readonly roleAssignments: Readonly<Record<string, readonly string[]>>;
+}
+export interface TopicNowProjectionV1 {
+    readonly version: 1;
+    readonly phase: ShapePhaseV1;
+    readonly condition: ShapeConditionV1;
+    readonly attention: ShapeAttentionV1;
+    readonly reasonCode: string;
+    readonly stateTags: readonly TopicStateTagV1[];
+    readonly transitions: readonly ShapeTransitionV1[];
+    readonly cacheKey: {
+        readonly topicRevision: string;
+        readonly contractRevision: string;
+        readonly shapeDigest: `sha256:${string}`;
+    };
+    readonly blockedOn?: TopicProgressBlockV1["target"];
+}
+export type TopicObligationActionabilityV1 = "mine" | "theirs" | "unassigned" | "unauthorized" | "unavailable";
+export interface TopicNowObligationV1 extends TopicObligationV1 {
+    readonly actionability: TopicObligationActionabilityV1;
+}
+export interface TopicNowProjectionV2 {
+    readonly version: 2;
+    readonly phase: ShapePhaseV1;
+    readonly condition: ShapeConditionV1;
+    readonly attention: ShapeAttentionV1;
+    readonly reasonCode: string;
+    readonly stateTags: readonly TopicStateTagV1[];
+    readonly transitions: readonly ShapeTransitionV1[];
+    readonly obligations: readonly TopicNowObligationV1[];
+    readonly primaryObligation?: TopicNowObligationV1;
+    readonly remainingCount: number;
+    readonly cacheKey: {
+        readonly topicRevision: string;
+        readonly contractRevision: string;
+        readonly shapeDigest: `sha256:${string}`;
+    };
+    readonly blockedOn?: TopicProgressBlockV1["target"];
+}
+export {};

package/dist/src/shapes/types.js

@@ -0,0 +1,44 @@
+export const SHAPE_PHASES = [
+    "forming",
+    "working",
+    "verifying",
+    "deciding",
+    "effecting",
+    "settling",
+    "complete",
+    "dormant",
+];
+export const SHAPE_CONDITIONS = [
+    "on-track",
+    "needs-input",
+    "needs-confirmation",
+    "review-due",
+    "expired",
+    "waiting",
+    "blocked",
+    "failed",
+    "disputed",
+    "degraded",
+];
+export const SHAPE_ATTENTION_STATES = [
+    "none",
+    "viewer-action-required",
+    "viewer-review-required",
+    "viewer-confirmation-required",
+];
+export const BASE_RECIPE_CODES = [
+    "project",
+    "flow",
+    "proposal",
+    "evaluation",
+    "claims",
+    "research",
+    "discussion",
+    "incident",
+];
+export const TOPIC_RECIPE_CODES = [
+    "research-brief",
+    "agent-delivery",
+    "verified-work-payment",
+];
+//# sourceMappingURL=types.js.map

package/dist/src/shapes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,SAAS;IACT,WAAW;IACX,UAAU;IACV,WAAW;IACX,UAAU;IACV,UAAU;IACV,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,YAAY;IACZ,SAAS;IACT,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM;IACN,wBAAwB;IACxB,wBAAwB;IACxB,8BAA8B;CACtB,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,MAAM;IACN,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB;IAChB,gBAAgB;IAChB,uBAAuB;CACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/topic-protocol",
-  "version": "0.8.0",
+  "version": "1.0.0-rc.2",
   "description": "Reference contracts and deterministic projection for IXO Topics",
   "type": "module",
   "sideEffects": false,
@@ -18,6 +18,7 @@
   "files": [
     "dist",
     "profiles",
+    "recipes",
     "templates",
     "README.md"
   ],
@@ -28,6 +29,7 @@
     },
     "./schemas/*": "./dist/schemas/*",
     "./profiles/*": "./profiles/*",
+    "./recipes/*": "./recipes/*",
     "./templates/*": "./templates/*"
   },
   "scripts": {

package/recipes/README.md

@@ -0,0 +1,12 @@
+# Topic Recipe registry
+
+These digest-addressed Topic Recipes are Marketplace-ready release-candidate
+artifacts. Every recipe creates a user-reviewable Draft; none grants authority
+or executes its Flow bindings.
+
+- `research-brief.json`
+- `agent-delivery.json`
+- `verified-work-payment.json`
+
+`registry.json` publishes the corresponding immutable references. Consumers
+must verify the recipe digest before resolving the Effective Topic Shape.