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

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

@@ -2,7 +2,7 @@ export declare const SHAPE_PHASES: readonly ["forming", "working", "verifying",
 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 declare const TOPIC_RECIPE_CODES: readonly ["software-build", "blueprint-design", "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];
@@ -14,6 +14,7 @@ export type ShapeEvidenceRequirementV1 = {
     readonly kind: "operation" | "record" | "receipt";
     readonly type: string;
     readonly finality?: "observed" | "accepted" | "verified" | "final";
+    readonly status?: string;
 };
 export type TopicSubjectRefV1 = {
     readonly kind: "actor";
@@ -72,6 +73,7 @@ export type ShapeGateV1 = ({
     readonly kind: "field-any";
     readonly paths: readonly string[];
     readonly predicate: "present" | "accepted";
+    readonly values?: Readonly<Record<string, readonly string[]>>;
 } | {
     readonly kind: "record";
     readonly type: string;
@@ -190,6 +192,7 @@ export interface TopicRecipeV1 {
     readonly baseRecipe: BaseRecipeCodeV1;
     readonly creates: "draft";
     readonly shape: TopicShapeV1;
+    readonly project?: ProjectRecipeConfigurationV1;
 }
 export interface EffectiveTopicShapeV1 {
     readonly version: 1;
@@ -221,6 +224,13 @@ export interface TopicProgressSourceV2 extends TopicProgressSourceV1 {
     readonly bodyHash?: `sha256:${string}`;
     readonly policyDigest?: `sha256:${string}`;
     readonly authorityProofRef?: string;
+    /** Authenticated context immediately before this event, supplied by the history adapter. */
+    readonly context?: {
+        readonly status: TopicProgressInputV1["status"];
+        readonly block?: TopicProgressBlockV1;
+        readonly dispute?: TopicDisputeV1;
+        readonly evaluationTime?: TopicEvaluationTimeV1;
+    };
 }
 export interface TopicEvaluationTimeV1 {
     readonly at: string;
@@ -234,7 +244,7 @@ export interface TopicDisputeV1 {
     readonly reasonCode: string;
     readonly raisedBy: string;
     readonly affectedRevision: string;
-    readonly resolver: TopicSubjectRefV1;
+    readonly resolver?: TopicSubjectRefV1;
     readonly process?: TopicDisputePolicyV1["process"];
     readonly resolutionRef?: string;
 }
@@ -257,6 +267,8 @@ export interface TopicProgressInputV1 {
     readonly axisStates: Readonly<Record<string, string>>;
     readonly sources: readonly TopicProgressSourceV1[];
     readonly presentFields?: readonly string[];
+    readonly fieldValues?: Readonly<Record<string, string>>;
+    readonly supportedCommands?: readonly string[];
     readonly acceptedFields?: readonly string[];
     readonly bindings?: readonly ("flow" | "claim" | "resource")[];
     readonly actorAssignments?: Readonly<Record<string, readonly string[]>>;
@@ -348,6 +360,7 @@ export interface TopicProgressProjectionV2 extends TopicProgressProjectionCommon
 }
 export interface TopicViewerAuthorityV1 {
     readonly viewerId: string;
+    readonly supportedCommands?: readonly string[];
     readonly matrixWrite: boolean;
     readonly verifiedAbilities: readonly string[];
     readonly roleAssignments: Readonly<Record<string, readonly string[]>>;
@@ -389,4 +402,5 @@ export interface TopicNowProjectionV2 {
     };
     readonly blockedOn?: TopicProgressBlockV1["target"];
 }
+import type { ProjectRecipeConfigurationV1 } from "../projects/types.js";
 export {};

package/dist/src/shapes/types.js

@@ -37,6 +37,8 @@ export const BASE_RECIPE_CODES = [
     "incident",
 ];
 export const TOPIC_RECIPE_CODES = [
+    "software-build",
+    "blueprint-design",
     "research-brief",
     "agent-delivery",
     "verified-work-payment",

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

@@ -1 +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"}
+{"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,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,uBAAuB;CACf,CAAC"}

package/dist/src/work-bridge/types.d.ts

@@ -13,7 +13,7 @@ export interface ExternalWorkStateMapV1 {
     readonly profileId: string;
     readonly provider: string;
     readonly organizationId: string;
-    readonly teamId: string;
+    readonly teamId?: string;
     readonly mappings: readonly ExternalWorkStateMapping[];
 }
 export interface ExternalWorkflowStateInput {
@@ -112,6 +112,19 @@ export interface WorkItemSnapshotV1 extends Readonly<Record<string, unknown>> {
     readonly topicId: string;
     readonly digest: Sha256Digest;
 }
+/**
+ * Immutable provider-neutral observation of an external project/container.
+ * Its state is evidence only: even `handoff_ready` cannot alter Topic
+ * authority, Project lifecycle, or closer acceptance.
+ */
+export interface ExternalProjectSnapshotV1 extends Readonly<Record<string, unknown>> {
+    readonly version: 1;
+    readonly snapshotId: string;
+    readonly bindingId: string;
+    readonly topicId: string;
+    readonly digest: Sha256Digest;
+}
+export type ExternalWorkSnapshotV1 = WorkItemSnapshotV1 | ExternalProjectSnapshotV1;
 export interface DeliveryPacketV1 {
     readonly version: 1;
     readonly deliveryPacketId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/topic-protocol",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "Reference contracts and deterministic projection for IXO Topics",
   "type": "module",
   "sideEffects": false,