@company-semantics/contracts 91.1.0 → 93.0.0

package/src/root-exports/delivery.ts

@@ -299,13 +299,24 @@ export {
   AFFORDANCE_UNAVAILABLE_REASONS,
   AffordanceAvailabilityIdSchema,
   AffordanceAvailabilitySchema,
+  AffordanceCoverageSchema,
   AffordanceIdSchema,
   AffordanceSchema,
+  AvailableAffordanceSchema,
+  AvailableAffordancesSchema,
+  ChatOpenArgsSchema,
+  CompanyMdDocArgsSchema,
+  ExecutionOpenArgsSchema,
   MAX_OFFERED_AFFORDANCES,
+  NO_AFFORDANCE_REASONS,
   NO_ARG_AFFORDANCE_IDS,
+  NoAffordanceReasonSchema,
   OfferedAffordanceSchema,
+  OrgStructureOpenReviewArgsSchema,
   PROJECTED_AFFORDANCE_IDS,
   ReviewOpenArgsSchema,
+  SourceSyncOpenUpdateArgsSchema,
+  TeamOpenArgsSchema,
   sameAffordances,
 } from "../affordances/index";
 
@@ -315,8 +326,12 @@ export type {
   AffordanceAvailability,
   AffordanceAvailabilityId,
   AffordanceBindingKind,
+  AffordanceCoverage,
   AffordanceId,
   AffordanceUnavailableReason,
+  AvailableAffordance,
+  AvailableAffordances,
+  NoAffordanceReason,
   OfferedAffordance,
   ProjectedAffordanceId,
 } from "../affordances/index";

package/src/source-sync/README.md

@@ -305,7 +305,8 @@ in `attention-evidence.ts`.
   `attentionEvidence` (null before index-first discovery).
 - `SourceSyncCandidateSetResponseSchema` / `SourceSyncCandidateSetResponse` —
   the draft set under review: its revision, items, presented questions,
-  distinct-file `totals` and cost estimate.
+  distinct-file `totals`. No cost estimate: approval authorizes the files,
+  never a spend.
 - `SourceSyncCandidateTotalsSchema` / `SourceSyncCandidateTotals` and
   `candidateTotalsOf(items)` — THE file count: distinct `sourceId`, never lines
   (ADR-CONTRACTS-195).

package/src/source-sync/__tests__/approval-schemas.test.ts

@@ -48,7 +48,6 @@ function addCandidate(overrides: Record<string, unknown> = {}) {
 function approveRequest(overrides: Record<string, unknown> = {}) {
   return {
     revision: 7,
-    spendCapMicroUsd: "2500000",
     ...overrides,
   };
 }
@@ -112,20 +111,10 @@ describe("SourceSyncApproveRequestSchema", () => {
     expect(refused.error?.issues[0]?.path).toEqual(["revision"]);
   });
 
-  it("refuses an approval with no spend cap", () => {
-    const { spendCapMicroUsd: _cap, ...withoutCap } = approveRequest();
-    const refused = SourceSyncApproveRequestSchema.safeParse(withoutCap);
-    expect(refused.success).toBe(false);
-    expect(refused.error?.issues[0]?.path).toEqual(["spendCapMicroUsd"]);
-
-    expect(
-      SourceSyncApproveRequestSchema.safeParse(
-        approveRequest({ spendCapMicroUsd: "2.50" }),
-      ).success,
-    ).toBe(false);
+  it("refuses a spend cap: an approval authorizes files, never a spend", () => {
     expect(
       SourceSyncApproveRequestSchema.safeParse(
-        approveRequest({ spendCapMicroUsd: 2500000 }),
+        approveRequest({ spendCapMicroUsd: "2500000" }),
       ).success,
     ).toBe(false);
   });

package/src/source-sync/__tests__/current-synthesis.test.ts

@@ -43,6 +43,7 @@ describe("SOURCE_SYNC_SYNTHESIS_PHASES", () => {
       "drafting",
       "waiting_for_review",
       "paused_billing",
+      "paused_ceiling",
       "applied",
       "applied_partial",
       "failed",

package/src/source-sync/__tests__/schemas.test.ts

@@ -140,11 +140,6 @@ function candidateSet(overrides: Record<string, unknown> = {}) {
       filesPendingClassification: 0,
     },
     scopes: [],
-    estimate: {
-      lowMicroUsd: "250000",
-      highMicroUsd: "1250000",
-      capMicroUsd: "2000000",
-    },
     discovery: {
       foundThisRun: 12,
       retainedDecisions: 3,
@@ -264,38 +259,16 @@ describe("SourceSyncCandidateItemSchema", () => {
 });
 
 describe("SourceSyncCandidateSetResponseSchema", () => {
-  it("accepts an estimate as integer micro-USD strings and refuses a decimal", () => {
+  it("accepts the draft set", () => {
     expect(
       SourceSyncCandidateSetResponseSchema.safeParse(candidateSet()).success,
     ).toBe(true);
-    const decimal = candidateSet({
-      estimate: {
-        lowMicroUsd: "0.25",
-        highMicroUsd: "1250000",
-        capMicroUsd: "2000000",
-      },
-    });
-    expect(
-      SourceSyncCandidateSetResponseSchema.safeParse(decimal).success,
-    ).toBe(false);
-    const jsonNumber = candidateSet({
-      estimate: {
-        lowMicroUsd: "250000",
-        highMicroUsd: "1250000",
-        capMicroUsd: 2000000,
-      },
-    });
-    expect(
-      SourceSyncCandidateSetResponseSchema.safeParse(jsonNumber).success,
-    ).toBe(false);
   });
 
-  it("accepts a null estimate before the estimator has run", () => {
-    expect(
-      SourceSyncCandidateSetResponseSchema.safeParse(
-        candidateSet({ estimate: null }),
-      ).success,
-    ).toBe(true);
+  it("carries no cost estimate: the review authorizes files, never a spend", () => {
+    expect(SourceSyncCandidateSetResponseSchema.shape).not.toHaveProperty(
+      "estimate",
+    );
   });
 
   it("refuses an unknown set state", () => {

package/src/source-sync/schemas.ts

@@ -30,9 +30,6 @@ import {
 import { CandidateDiscoverySummarySchema } from "./relevance";
 import { SourceSyncCandidateItemSchema } from "./candidate-item";
 
-/** Integer micro-USD as a string — the billing domain's money convention on the wire. */
-const MicroUsd = z.string().regex(/^[0-9]+$/);
-
 /** A person as the review names them: a display label, never an id or an address. */
 const PersonLabel = z.string().min(1).max(255);
 
@@ -109,14 +106,6 @@ export const SourceSyncCandidateSetResponseSchema = z.object({
   totals: SourceSyncCandidateTotalsSchema,
   /** Every scope of the set the caller may see, and where its approval stands. */
   scopes: z.array(SourceSyncScopeApprovalProjectionSchema).max(500),
-  /** A RANGE, and the cap that is the promise. Null until the estimator has run. */
-  estimate: z
-    .object({
-      lowMicroUsd: MicroUsd,
-      highMicroUsd: MicroUsd,
-      capMicroUsd: MicroUsd,
-    })
-    .nullable(),
   /** The last completed discovery run's counts; null before any run completed. */
   discovery: z.nullable(CandidateDiscoverySummarySchema),
 });
@@ -134,13 +123,14 @@ export const SourceSyncAddCandidateRequestSchema = z
 
 /**
  * Approve the set AS REVIEWED. `revision` is the revision the person was looking at; the server
- * refuses a stale one, freezes the items, and hashes them PER SCOPE with that scope's share of the cap.
+ * refuses a stale one, freezes the items, and hashes them PER SCOPE.
+ *
+ * An approval authorizes the files, never a spend: there is no cap and no estimate here. Spend is
+ * bounded by the org's standing spending controls and a server-derived run ceiling.
  */
 export const SourceSyncApproveRequestSchema = z
   .object({
     revision: z.number().int().min(0),
-    /** The promise: synthesis stops at this. Integer micro-USD. */
-    spendCapMicroUsd: MicroUsd,
     /** Absent: every scope the caller may approve (all of them for the single v1 approver). */
     scopeKeys: z.array(z.string().min(1).max(64)).min(1).max(500).optional(),
   })
@@ -151,7 +141,7 @@ export const SourceSyncScopeApprovalSchema = z.object({
   /** 'company' or 'unit:<uuid>'. */
   scopeKey: z.string().min(1).max(64),
   approvalId: z.string().uuid(),
-  /** Hash over THIS scope's ordered (source, target, use, observation) tuples and its share of the cap. */
+  /** Hash over THIS scope's ordered (source, target, use, observation) tuples. */
   candidateSetHash: z.string().regex(/^[0-9a-f]{64}$/),
 });
 
@@ -285,6 +275,7 @@ export const SOURCE_SYNC_SYNTHESIS_PHASES = [
   "drafting",
   "waiting_for_review",
   "paused_billing",
+  "paused_ceiling",
   "applied",
   "applied_partial",
   "failed",

package/src/workflows/deferred-route.ts

@@ -150,6 +150,8 @@ export const SYNTHESIZE_DEFERRED_ROUTE_OF_REASON = {
   updates_applied: { route: "covered", by: "sourceSync.docs_updated", fallback: "notice", audience: "creator" },
   stopped_by_user: STOPPED,
   paused_billing: EXPLAINED,
+  run_ceiling_reached: NOTICE_ADMINS,
+  pricing_unconfigured: NOTICE_ADMINS,
   synthesis_incomplete: NOTICE_ADMINS,
   approval_mismatch: NOTICE_ADMINS,
   landing_refused: NOTICE_ADMINS,

package/src/workflows/outcome-reasons.ts

@@ -123,6 +123,8 @@ export const SYNTHESIZE_OUTCOME_KIND_OF_REASON = {
   updates_applied: "produced",
   stopped_by_user: "stopped",
   paused_billing: "failed",
+  run_ceiling_reached: "failed",
+  pricing_unconfigured: "failed",
   synthesis_incomplete: "failed",
   approval_mismatch: "failed",
   landing_refused: "failed",
@@ -143,6 +145,8 @@ export const SYNTHESIZE_AFFORDANCES_OF_REASON = {
   updates_applied: [],
   stopped_by_user: [],
   paused_billing: [OPEN_BILLING],
+  run_ceiling_reached: [],
+  pricing_unconfigured: [],
   synthesis_incomplete: [],
   approval_mismatch: [],
   landing_refused: [],