@deftai/directive-types 0.104.0 → 0.106.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { ACCEPTED_VBRIEF_VERSIONS, EXTENSION_KEY_PATTERN, LEGACY_VBRIEF_CORE_SCH
 export { type EngineInfo, PLAN_ITEM_EFFORTS, type Plan, type PlanArchitecture, type PlanItem, type PlanItemEffort, type VBriefDocument, type VBriefInfo, } from "./document.js";
 export { collectExtensionProperties, type ExtensionKey, isExtensionKey, } from "./extension.js";
 export { GATE_EXIT_CONFIG_ERROR, GATE_EXIT_OK, GATE_EXIT_VIOLATION, type GateExitCode, type GateResult, } from "./gate.js";
-export { type HotfixCriteria, type PlanPolicy, type ProjectionProviderExpectation, type ProjectionProviderPolicy, REGISTERED_POLICY_FIELD_NAMES, type TriageScopeRule, } from "./policy.js";
+export { type HotfixCriteria, type PlanPolicy, type ProjectInvariant, type ProjectInvariantContractSurface, type ProjectionProviderExpectation, type ProjectionProviderPolicy, REGISTERED_POLICY_FIELD_NAMES, type TriageScopeRule, } from "./policy.js";
 export { isVBriefReferenceType, KNOWN_REFERENCE_TYPES, type KnownReferenceType, referenceTypeMatches, type TrustLevel, type VBriefReference, } from "./reference.js";
 export { RESOLUTION_ENCODINGS, RESOLUTION_MODES, RESOLUTION_PLAN_SCHEMA_VERSION, type ResolutionEncoding, type ResolutionFacts, type ResolutionFile, type ResolutionMode, type ResolutionNextAction, type ResolutionPlan, } from "./resolution.js";
 export { FOLDER_ALLOWED_STATUSES, type Status, VALID_STATUSES, } from "./status.js";

package/dist/policy.d.ts

@@ -22,6 +22,16 @@ export interface PlanPolicy {
     readonly allowDirectCommitsToMaster?: boolean;
     readonly wipCap?: number;
     readonly sessionRitualStalenessHours?: number | null;
+    /**
+     * Forge-outage re-probe interval in minutes (#3422).
+     * Integer, minimum 5, default 30. USER.md Personal wins over this field.
+     */
+    readonly forgeOutageRetryMinutes?: number | null;
+    /**
+     * Authored project-level must-not-break contracts (#3425).
+     * Empty or omitted is a no-op.
+     */
+    readonly projectInvariants?: readonly ProjectInvariant[];
     /**
      * Engine-vs-pin skew tolerance for the three-band skew policy (#2264).
      *
@@ -87,8 +97,29 @@ export interface PlanPolicy {
          */
         readonly override?: "minimal" | "rapid" | "standard" | "elevated" | null;
     };
+    /**
+     * Max files for an integration-to-delivery sync warn (#3390). Unset is 400.
+     * A maxFiles argument overrides one evaluation without writing policy.
+     */
+    readonly syncMaxFiles?: number;
     readonly [key: `x-${string}`]: unknown;
 }
+/** One authored project invariant (#3425). */
+export interface ProjectInvariantContractSurface {
+    readonly paths?: readonly string[];
+    readonly pathGlobs?: readonly string[];
+    readonly moduleIds?: readonly string[];
+    readonly module_ids?: readonly string[];
+}
+export interface ProjectInvariant {
+    readonly id: string;
+    readonly statement: string;
+    readonly contractSurface?: ProjectInvariantContractSurface | readonly string[];
+    readonly contract_surface?: ProjectInvariantContractSurface | readonly string[];
+    readonly paths?: readonly string[];
+    readonly moduleIds?: readonly string[];
+    readonly module_ids?: readonly string[];
+}
 export interface ProjectionProviderExpectation {
     readonly provider?: string | Record<string, unknown>;
     readonly name?: string;
@@ -102,5 +133,5 @@ export interface ProjectionProviderPolicy {
     readonly [key: `x-${string}`]: unknown;
 }
 /** Canonical dotted policy field names registered by the directive engine. */
-export declare const REGISTERED_POLICY_FIELD_NAMES: readonly ["plan.policy.allowDirectCommitsToMaster", "plan.policy.wipCap", "plan.policy.sessionRitualStalenessHours", "plan.policy.triageScope", "plan.policy.triageScopeIgnores", "plan.policy.triageRankingLabels", "plan.policy.triageAutoClassify", "plan.policy.triageHoldMarkers", "plan.policy.triageLabelMirror", "plan.policy.swarmSubagentBackend", "plan.policy.engineSkewWindow", "plan.policy.requireHumanMerge", "plan.policy.hotfixCriteria", "plan.policy.autoDeployOnMerge", "plan.policy.ceremonyDial"];
+export declare const REGISTERED_POLICY_FIELD_NAMES: readonly ["plan.policy.allowDirectCommitsToMaster", "plan.policy.wipCap", "plan.policy.sessionRitualStalenessHours", "plan.policy.forgeOutageRetryMinutes", "plan.policy.projectInvariants", "plan.policy.triageScope", "plan.policy.triageScopeIgnores", "plan.policy.triageRankingLabels", "plan.policy.triageAutoClassify", "plan.policy.triageHoldMarkers", "plan.policy.triageLabelMirror", "plan.policy.swarmSubagentBackend", "plan.policy.engineSkewWindow", "plan.policy.requireHumanMerge", "plan.policy.hotfixCriteria", "plan.policy.autoDeployOnMerge", "plan.policy.ceremonyDial", "plan.policy.syncMaxFiles"];
 //# sourceMappingURL=policy.d.ts.map

package/dist/policy.js

@@ -3,6 +3,8 @@ export const REGISTERED_POLICY_FIELD_NAMES = [
     "plan.policy.allowDirectCommitsToMaster",
     "plan.policy.wipCap",
     "plan.policy.sessionRitualStalenessHours",
+    "plan.policy.forgeOutageRetryMinutes",
+    "plan.policy.projectInvariants",
     "plan.policy.triageScope",
     "plan.policy.triageScopeIgnores",
     "plan.policy.triageRankingLabels",
@@ -15,5 +17,6 @@ export const REGISTERED_POLICY_FIELD_NAMES = [
     "plan.policy.hotfixCriteria",
     "plan.policy.autoDeployOnMerge",
     "plan.policy.ceremonyDial",
+    "plan.policy.syncMaxFiles",
 ];
 //# sourceMappingURL=policy.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-types",
-  "version": "0.104.0",
+  "version": "0.106.0",
   "description": "Shared TypeScript types for the Directive framework engine.",
   "license": "MIT",
   "type": "module",

package/schemas/vbrief-core-0.6.schema.json

@@ -614,6 +614,18 @@
           "minimum": 1,
           "description": "Maximum age, in hours, for .deft/ritual-state.json before the fail-closed session ritual verifier requires task session:start to run again. Default: 4."
         },
+        "forgeOutageRetryMinutes": {
+          "type": ["integer", "null"],
+          "minimum": 5,
+          "description": "Minutes to wait between GitHub I/O re-probes after a forge outage drop-back (#3422). Default: 30. USER.md Personal wins over this project field. null is unset (same as omit)."
+        },
+        "projectInvariants": {
+          "type": "array",
+          "description": "Authored project-level must-not-break contracts (#3425). Empty or omitted is a no-op. Each entry names an id, statement, and contract surface (paths and/or module ids).",
+          "items": {
+            "$ref": "#/$defs/ProjectInvariant"
+          }
+        },
         "requireHumanMerge": {
           "type": "boolean",
           "description": "When true, agents may open PRs but must not merge (#1193). Defaults true when autoDeployOnMerge is also true. Override: policy:allow-bot-merge --confirm or DEFT_ALLOW_BOT_MERGE=1."
@@ -631,6 +643,66 @@
       },
       "additionalProperties": true
     },
+    "ProjectInvariant": {
+      "type": "object",
+      "description": "One authored project invariant (#3425). Contract surface is paths and/or module ids that must not be broken.",
+      "required": ["id", "statement"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "statement": {
+          "type": "string",
+          "minLength": 1
+        },
+        "contractSurface": {
+          "$ref": "#/$defs/ProjectInvariantContractSurface"
+        },
+        "contract_surface": {
+          "oneOf": [
+            { "$ref": "#/$defs/ProjectInvariantContractSurface" },
+            { "type": "array", "items": { "type": "string" } }
+          ]
+        },
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "moduleIds": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "module_ids": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    },
+    "ProjectInvariantContractSurface": {
+      "type": "object",
+      "description": "Must-not-break module/contract surface: repository paths and/or codeStructure module ids.",
+      "properties": {
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "pathGlobs": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "moduleIds": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "module_ids": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    },
     "HotfixCriteria": {
       "type": "object",
       "description": "Structural hotfix eligibility thresholds (#1193). Agent may label hotfix-candidate only; human promotes hotfix.",