@treeseed/sdk 0.13.0-rc.18 → 0.13.0-rc.19

package/README.md

@@ -19,32 +19,42 @@ import {
   ControlPlaneClient,
   defaultLocalControlPlaneServer,
 } from '@treeseed/sdk/control-plane-client';
+import { CONTROL_PLANE_OPERATIONS } from '@treeseed/sdk/operator-contracts';
 
 const client = new ControlPlaneClient({
   profile: defaultLocalControlPlaneServer(),
   accessToken: process.env.TREESEED_ACCESS_TOKEN,
 });
 
-const health = await client.call({ method: 'GET', path: '/v1/health' });
+const health = await client.invoke(CONTROL_PLANE_OPERATIONS.health.readiness, {
+  path: {},
+  query: {},
+  body: undefined,
+});
 ```
 
-The client provides typed operation dispatch, RFC 9457 problem handling, OAuth device and refresh flows, server-profile normalization, idempotency keys, optimistic-concurrency headers, and request cancellation. Generated operation bindings come from the versioned operation catalog; the generic `call` method accepts only the public REST path shape. Token and profile persistence belong to the consuming CLI, application, or host credential store.
+The client provides typed operation dispatch, RFC 9457 problem handling, OAuth device and refresh flows, server-profile normalization, idempotency keys, optimistic-concurrency headers, and request cancellation. Operation bindings come from the versioned operation catalog; callers do not construct control-plane paths. Token and profile persistence belong to the consuming CLI, application, or host credential store.
 
 ## TreeDX API
 
 ```ts
-import { TreeDxClient } from '@treeseed/sdk/treedx/client';
+import { ControlPlaneClient } from '@treeseed/sdk/control-plane-client';
+import { TreeSeedTreeDxClient } from '@treeseed/sdk/treedx';
 
-const treeDx = new TreeDxClient({
-  baseUrl: 'http://127.0.0.1:4000',
-  token: process.env.TREEDX_TOKEN,
-  repoId: 'repo_123',
+const controlPlane = new ControlPlaneClient({
+  profile: defaultLocalControlPlaneServer(),
+  accessToken: process.env.TREESEED_ACCESS_TOKEN,
 });
+const treeDx = new TreeSeedTreeDxClient(controlPlane);
 
-const result = await treeDx.searchRepositoryFiles({ query: 'release' });
+const result = await treeDx.proxy.repositories.searchFiles({
+  path: { projectId: 'project_123', repositoryId: 'repository_123' },
+  query: { query: 'release' },
+  body: undefined,
+});
 ```
 
-TreeDX remains a remote service. Its client and transport types are retained here so consumers do not duplicate protocol code.
+TreeDX remains an independently released remote service. This package imports its authoritative payload types but exposes only the project-scoped TreeSeed proxy facade. Direct TreeDX transport, endpoints, topology, and credentials remain confined to trusted control-plane infrastructure.
 
 ## Public boundaries
 

package/dist/agent-capacity/artifacts.d.ts

@@ -1,6 +1,5 @@
 import type { ExecutionUsageActual } from '../types/agents.js';
 import type { ResearchCitation } from './contracts/support/research-citation.js';
-import type { ArtifactRef } from '../treedx/types.js';
 import { type ArtifactMutationReceipt } from './artifact-mutation-receipt.js';
 export interface AgentToolEventReference {
     id: string;
@@ -62,6 +61,23 @@ export interface AgentDiagnosticReference {
     retryable?: boolean | null;
     evidenceRef?: string | null;
 }
+export interface ArtifactRef {
+    contract: 'treeseed.artifact-ref/v1';
+    kind: 'treedx-content' | 'repository-file' | 'r2-object' | 'verification-evidence' | 'provider-input' | 'provider-output' | 'citation' | 'source-commit';
+    repositoryId?: string;
+    workspaceId?: string;
+    path?: string;
+    commitSha?: string | null;
+    objectKey?: string;
+    sha256: string | null;
+    byteLength?: number;
+    mediaType?: string;
+    visibility: 'private' | 'assignment' | 'project' | 'team' | 'public';
+    assignmentId?: string;
+    toolCallId?: string;
+    eventId?: string;
+    provenance?: Record<string, string>;
+}
 /** Portable, secret-free terminal evidence emitted by AgentKernel. */
 export interface AgentArtifactManifest {
     schemaVersion: 1;

package/dist/content/validation/agent-operational-content-schemas.d.ts

@@ -54,8 +54,8 @@ export declare const agentContextQueryContentSchema: z.ZodObject<{
     };
     depth: number;
     purpose: string;
-    relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
     maturity: "draft" | "validated" | "simulated" | "proven";
+    relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
     resultLimit: number;
     contextBudget: {
         maxItems: number;
@@ -88,8 +88,8 @@ export declare const agentContextQueryContentSchema: z.ZodObject<{
     scope?: string | undefined;
     filters?: Record<string, unknown> | undefined;
     depth?: number | undefined;
-    relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     codeScopes?: string[] | undefined;
+    relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
 }>;
 export declare const agentContextQuerySetContentSchema: z.ZodObject<{
@@ -445,8 +445,8 @@ export declare const assignmentSummaryContentSchema: z.ZodObject<{
         outcome: z.ZodString;
         metrics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
-        metrics: Record<string, number>;
         outcome: string;
+        metrics: Record<string, number>;
     }, {
         outcome: string;
         metrics?: Record<string, number> | undefined;
@@ -479,8 +479,8 @@ export declare const assignmentSummaryContentSchema: z.ZodObject<{
     artifactRefs: string[];
     lessons: string[];
     performance: {
-        metrics: Record<string, number>;
         outcome: string;
+        metrics: Record<string, number>;
     };
     verificationRefs: string[];
     description?: string | undefined;
@@ -724,8 +724,8 @@ export declare const agentOperationalContentSchemas: {
         };
         depth: number;
         purpose: string;
-        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         maturity: "draft" | "validated" | "simulated" | "proven";
+        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         resultLimit: number;
         contextBudget: {
             maxItems: number;
@@ -758,8 +758,8 @@ export declare const agentOperationalContentSchemas: {
         scope?: string | undefined;
         filters?: Record<string, unknown> | undefined;
         depth?: number | undefined;
-        relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         codeScopes?: string[] | undefined;
+        relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
     }>;
     agent_context_query_set: z.ZodObject<{
@@ -1115,8 +1115,8 @@ export declare const agentOperationalContentSchemas: {
             outcome: z.ZodString;
             metrics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
         }, "strict", z.ZodTypeAny, {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         }, {
             outcome: string;
             metrics?: Record<string, number> | undefined;
@@ -1149,8 +1149,8 @@ export declare const agentOperationalContentSchemas: {
         artifactRefs: string[];
         lessons: string[];
         performance: {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         };
         verificationRefs: string[];
         description?: string | undefined;

package/dist/content/validation/auxiliary-content-schemas.d.ts

@@ -316,15 +316,15 @@ export declare const templateProductContentSchema: z.ZodObject<{
             integrity: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         }, {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"r2">;
@@ -353,9 +353,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -371,9 +371,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     }, {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -427,9 +427,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     fulfillment: {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -472,9 +472,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     fulfillment: {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -1524,15 +1524,15 @@ export declare const auxiliaryContentSchemas: {
                 integrity: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             }, {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"r2">;
@@ -1561,9 +1561,9 @@ export declare const auxiliaryContentSchemas: {
         }, "strip", z.ZodTypeAny, {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1579,9 +1579,9 @@ export declare const auxiliaryContentSchemas: {
         }, {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1635,9 +1635,9 @@ export declare const auxiliaryContentSchemas: {
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1680,9 +1680,9 @@ export declare const auxiliaryContentSchemas: {
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;

package/dist/content/validation/content-model-schemas.d.ts

@@ -57,8 +57,8 @@ declare const schemas: {
         };
         depth: number;
         purpose: string;
-        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         maturity: "draft" | "validated" | "simulated" | "proven";
+        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         resultLimit: number;
         contextBudget: {
             maxItems: number;
@@ -91,8 +91,8 @@ declare const schemas: {
         scope?: string | undefined;
         filters?: Record<string, unknown> | undefined;
         depth?: number | undefined;
-        relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         codeScopes?: string[] | undefined;
+        relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
     }>;
     agent_context_query_set: z.ZodObject<{
@@ -448,8 +448,8 @@ declare const schemas: {
             outcome: z.ZodString;
             metrics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
         }, "strict", z.ZodTypeAny, {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         }, {
             outcome: string;
             metrics?: Record<string, number> | undefined;
@@ -482,8 +482,8 @@ declare const schemas: {
         artifactRefs: string[];
         lessons: string[];
         performance: {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         };
         verificationRefs: string[];
         description?: string | undefined;
@@ -1339,15 +1339,15 @@ declare const schemas: {
                 integrity: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             }, {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"r2">;
@@ -1376,9 +1376,9 @@ declare const schemas: {
         }, "strip", z.ZodTypeAny, {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1394,9 +1394,9 @@ declare const schemas: {
         }, {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1450,9 +1450,9 @@ declare const schemas: {
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1495,9 +1495,9 @@ declare const schemas: {
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -9769,19 +9769,19 @@ declare const schemas: {
     }, "strip", z.ZodTypeAny, {
         title: string;
         sequence?: number | undefined;
-        refs?: string[] | undefined;
         phase?: string | undefined;
         group_ids?: string[] | undefined;
         discussion_id?: string | undefined;
         occurred_at?: Date | undefined;
+        refs?: string[] | undefined;
     }, {
         title: string;
         sequence?: number | undefined;
-        refs?: string[] | undefined;
         phase?: string | undefined;
         group_ids?: string[] | undefined;
         discussion_id?: string | undefined;
         occurred_at?: Date | undefined;
+        refs?: string[] | undefined;
     }>;
     group: z.ZodObject<{
         contract: z.ZodLiteral<"treeseed.group/v1">;
@@ -11453,9 +11453,9 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -11538,8 +11538,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         };
         depth: number;
         purpose: string;
-        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         maturity: "draft" | "validated" | "simulated" | "proven";
+        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         resultLimit: number;
         contextBudget: {
             maxItems: number;
@@ -11643,8 +11643,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         artifactRefs: string[];
         lessons: string[];
         performance: {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         };
         verificationRefs: string[];
         description?: string | undefined;
@@ -11884,11 +11884,11 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
     } | {
         title: string;
         sequence?: number | undefined;
-        refs?: string[] | undefined;
         phase?: string | undefined;
         group_ids?: string[] | undefined;
         discussion_id?: string | undefined;
         occurred_at?: Date | undefined;
+        refs?: string[] | undefined;
     } | {
         id: string;
         classification: string;
@@ -19839,15 +19839,15 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
             integrity: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         }, {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"r2">;
@@ -19876,9 +19876,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     }, "strip", z.ZodTypeAny, {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -19894,9 +19894,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     }, {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -19950,9 +19950,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     fulfillment: {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -19995,9 +19995,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     fulfillment: {
         source: {
             kind: "git";
-            ref: string;
             repoUrl: string;
             directory: string;
+            ref: string;
             integrity?: string | undefined;
         } | {
             version: string;
@@ -20431,8 +20431,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     };
     depth: number;
     purpose: string;
-    relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
     maturity: "draft" | "validated" | "simulated" | "proven";
+    relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
     resultLimit: number;
     contextBudget: {
         maxItems: number;
@@ -20465,8 +20465,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     scope?: string | undefined;
     filters?: Record<string, unknown> | undefined;
     depth?: number | undefined;
-    relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     codeScopes?: string[] | undefined;
+    relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
 }> | z.ZodObject<{
     id: z.ZodString;
@@ -20816,8 +20816,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         outcome: z.ZodString;
         metrics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
-        metrics: Record<string, number>;
         outcome: string;
+        metrics: Record<string, number>;
     }, {
         outcome: string;
         metrics?: Record<string, number> | undefined;
@@ -20850,8 +20850,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     artifactRefs: string[];
     lessons: string[];
     performance: {
-        metrics: Record<string, number>;
         outcome: string;
+        metrics: Record<string, number>;
     };
     verificationRefs: string[];
     description?: string | undefined;
@@ -21657,19 +21657,19 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
 }, "strip", z.ZodTypeAny, {
     title: string;
     sequence?: number | undefined;
-    refs?: string[] | undefined;
     phase?: string | undefined;
     group_ids?: string[] | undefined;
     discussion_id?: string | undefined;
     occurred_at?: Date | undefined;
+    refs?: string[] | undefined;
 }, {
     title: string;
     sequence?: number | undefined;
-    refs?: string[] | undefined;
     phase?: string | undefined;
     group_ids?: string[] | undefined;
     discussion_id?: string | undefined;
     occurred_at?: Date | undefined;
+    refs?: string[] | undefined;
 }> | z.ZodObject<{
     contract: z.ZodLiteral<"treeseed.group/v1">;
     id: z.ZodString;

package/dist/content/validation/portable-content-data.d.ts

@@ -1635,9 +1635,9 @@ export declare function validatePortableContentData(model: string, value: unknow
         fulfillment: {
             source: {
                 kind: "git";
-                ref: string;
                 repoUrl: string;
                 directory: string;
+                ref: string;
                 integrity?: string | undefined;
             } | {
                 version: string;
@@ -1720,8 +1720,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         };
         depth: number;
         purpose: string;
-        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         maturity: "draft" | "validated" | "simulated" | "proven";
+        relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
         resultLimit: number;
         contextBudget: {
             maxItems: number;
@@ -1825,8 +1825,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         artifactRefs: string[];
         lessons: string[];
         performance: {
-            metrics: Record<string, number>;
             outcome: string;
+            metrics: Record<string, number>;
         };
         verificationRefs: string[];
         description?: string | undefined;
@@ -2066,11 +2066,11 @@ export declare function validatePortableContentData(model: string, value: unknow
     } | {
         title: string;
         sequence?: number | undefined;
-        refs?: string[] | undefined;
         phase?: string | undefined;
         group_ids?: string[] | undefined;
         discussion_id?: string | undefined;
         occurred_at?: Date | undefined;
+        refs?: string[] | undefined;
     } | {
         id: string;
         classification: string;

package/dist/operator-contracts/canonical-command-tree.js

@@ -43,6 +43,14 @@ const operationBindings = {
   "assignments explain": operation("assignments.explain", [field("path", "teamId", "context", "team", true), field("path", "assignmentId", "argument", "assignment", true)]),
   "assignments retry": operation("assignments.retry", [field("path", "teamId", "context", "team", true), field("path", "assignmentId", "argument", "assignment", true), field("body", "reason", "option")]),
   "assignments cancel": operation("assignments.cancel", [field("path", "teamId", "context", "team", true), field("path", "assignmentId", "argument", "assignment", true), field("body", "reason", "option")]),
+  "projects treedx show": operation("treedx.library.show", [field("path", "projectId", "argument", "project", true)]),
+  "projects treedx bind": operation("treedx.library.bind", [field("path", "projectId", "argument", "project", true), field("body", "connectionId", "option", "connection", true)]),
+  "projects treedx status": operation("treedx.health.show", [field("path", "projectId", "argument", "project", true)]),
+  "projects treedx diagnose": operation("treedx.service.contract", [field("path", "projectId", "argument", "project", true)]),
+  "projects treedx capabilities": operation("treedx.capabilities.list", [field("path", "projectId", "argument", "project", true)]),
+  "projects treedx workspaces list": operation("treedx.workspaces.list", [field("path", "projectId", "argument", "project", true), ...page()]),
+  "projects treedx workspaces show": operation("treedx.workspaces.show", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
+  "projects treedx workspaces abandon": operation("treedx.workspaces.abandon", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
   "status": operation("status.show"),
   "save": unavailable("Unified GitHub-backed save is intentionally fail-closed during this cutover."),
   "stage": unavailable("Unified GitHub-backed stage is intentionally fail-closed during this cutover."),
@@ -107,6 +115,14 @@ const commandTree = {
       branch("schedules", [leaf("list"), leaf("show", "read", "schedule"), leaf("plan"), leaf("start", "mutation", void 0, "authority"), leaf("pause", "mutation", "schedule", "authority"), leaf("resume", "mutation", "schedule", "authority"), leaf("retire", "mutation", "schedule", "destructive")])
     ]),
     branch("assignments", [leaf("list"), leaf("show", "read", "assignment"), leaf("explain", "read", "assignment"), leaf("watch", "read", "assignment"), leaf("retry", "mutation", "assignment", "authority"), leaf("cancel", "mutation", "assignment", "destructive"), leaf("artifacts", "read", "assignment")]),
+    branch("projects", [branch("treedx", [
+      leaf("show", "read", "project"),
+      leaf("bind", "mutation", "project"),
+      leaf("status", "read", "project"),
+      leaf("diagnose", "read", "project"),
+      leaf("capabilities", "read", "project"),
+      branch("workspaces", [leaf("list", "read", "project"), leaf("show", "read", "workspace"), leaf("abandon", "mutation", "workspace", "destructive")])
+    ])]),
     leaf("save", "mutation"),
     leaf("stage", "mutation", void 0, "authority"),
     leaf("release", "mutation", void 0, "production"),

package/dist/operator-contracts/control-plane-operation.d.ts

@@ -27,6 +27,12 @@ export interface ControlPlaneConcurrencyContract {
     readHeader: 'ETag';
     writeHeader: 'If-Match';
 }
+export interface ControlPlaneUpstreamBinding {
+    service: 'treedx';
+    operationId: string;
+    contractVersion: string;
+    contractDigest: `sha256:${string}`;
+}
 export interface ControlPlaneOperationDescriptor {
     schemaVersion: typeof CONTROL_PLANE_OPERATION_SCHEMA_VERSION;
     operationId: `${string}.${string}`;
@@ -47,6 +53,7 @@ export interface ControlPlaneOperationDescriptor {
     audited: boolean;
     receipt: boolean;
     redactedPaths: string[];
+    upstream?: ControlPlaneUpstreamBinding;
 }
 export interface ControlPlaneOperationInput<TPath = Record<string, never>, TQuery = Record<string, never>, TBody = undefined> {
     path: TPath;