@company-semantics/contracts 91.1.0 → 92.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "91.1.0",
+  "version": "92.0.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -179,6 +179,7 @@
       "esbuild@<0.28.1": ">=0.28.1",
       "linkify-it@<5.0.2": ">=5.0.2",
       "postcss@<8.5.23": ">=8.5.23",
+      "source-map-js@<1.2.2": ">=1.2.2",
       "markdown-it@<14.2.0": ">=14.2.0",
       "@humanfs/node@<0.16.8": ">=0.16.8 <0.17.0"
     }
@@ -188,5 +189,5 @@
     "*.md": "markdownlint-cli2",
     "package.json": "node -e \"JSON.parse(require('fs').readFileSync('package.json'))\""
   },
-  "securityRequirementsVersion": "8700b9fe36f8c948f12970ec54128e4f1955986dd9b634114f7501fdb1884267"
+  "securityRequirementsVersion": "4b88755e9a43a82b2f5eb55b953581526f1982de362da77bc579888d1f6a1bb0"
 }

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = '2d074ecfa53c' as const;
-export const SPEC_HASH_FULL = '2d074ecfa53c0f377dfda06d9a46167a9cfc77eb3878e2cd71b8a04149c700b7' as const;
+export const SPEC_HASH = '9937d3953931' as const;
+export const SPEC_HASH_FULL = '9937d39539319f5173df9f15191c8dc5af40aca8c8cd62a9995f7221436909d2' as const;

package/src/api/generated.ts

@@ -4936,7 +4936,7 @@ export interface paths {
         put?: never;
         /**
          * Approve the draft candidate set as reviewed, per scope
-         * @description Approves the named scopes (or every scope still open) at the revision the person reviewed. Per scope, the items freeze, a hash binds them to that scope’s share of the spending cap, and a landing job is scheduled on one landing-and-synthesis workflow.
+         * @description Approves the named scopes (or every scope still open) at the revision the person reviewed. Per scope, the items freeze, a hash binds the approval to exactly those files and treatments, and a landing job is scheduled on one landing-and-synthesis workflow. Approval authorizes the revision only; it carries no spend.
          */
         post: operations["approveSourceCandidateSet"];
         delete?: never;
@@ -7169,7 +7169,7 @@ export interface components {
                 /** @enum {string} */
                 kind: "produced" | "empty" | "partial" | "stopped" | "failed" | "abandoned" | "unknown";
                 /** @enum {string} */
-                reason: "updates_ready" | "updates_applied" | "stopped_by_user" | "paused_billing" | "synthesis_incomplete" | "approval_mismatch" | "landing_refused" | "standing_order_refused" | "no_connection" | "source_sync_off" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
+                reason: "updates_ready" | "updates_applied" | "stopped_by_user" | "paused_billing" | "run_ceiling_reached" | "pricing_unconfigured" | "synthesis_incomplete" | "approval_mismatch" | "landing_refused" | "standing_order_refused" | "no_connection" | "source_sync_off" | "internal_error" | "abandoned" | "unrecognized_terminal_state";
                 facts: {
                     scopeCount: number;
                     violationCount: number;
@@ -9829,11 +9829,6 @@ export interface components {
                 } | null;
                 approvedAt: string | null;
             }[];
-            estimate: {
-                lowMicroUsd: string;
-                highMicroUsd: string;
-                capMicroUsd: string;
-            } | null;
             discovery: {
                 foundThisRun: number;
                 retainedDecisions: number;
@@ -9909,7 +9904,7 @@ export interface components {
                 workflowId: string;
                 batchId: string | null;
                 /** @enum {string} */
-                phase: "landing" | "drafting" | "waiting_for_review" | "paused_billing" | "applied" | "applied_partial" | "failed" | "closed";
+                phase: "landing" | "drafting" | "waiting_for_review" | "paused_billing" | "paused_ceiling" | "applied" | "applied_partial" | "failed" | "closed";
                 fileCount: number | null;
                 proposedDocumentCount: number;
                 appliedAt: string | null;
@@ -19984,7 +19979,6 @@ export interface operations {
             content: {
                 "application/json": {
                     revision: number;
-                    spendCapMicroUsd: string;
                     scopeKeys?: string[];
                 };
             };
@@ -19999,7 +19993,7 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncApproveResponse"];
                 };
             };
-            /** @description Invalid request, a scope with no files (SOURCE_SYNC_SCOPE_UNKNOWN), or a cap too large to hold exactly (SOURCE_SYNC_SPEND_CAP_INVALID) */
+            /** @description Invalid request (an unknown field such as a spend cap is refused by the schema), or a scope with no files (SOURCE_SYNC_SCOPE_UNKNOWN) */
             400: {
                 headers: {
                     [name: string]: unknown;

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: [],