@deftai/directive-types 0.88.0 → 0.90.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, PlanArchitecture, PlanItem, VBriefDocument, 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 PlanPolicy, type ProjectionProviderExpectation, type ProjectionProviderPolicy, REGISTERED_POLICY_FIELD_NAMES, type TriageScopeRule, } from "./policy.js";
+export { type HotfixCriteria, type PlanPolicy, 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

@@ -6,6 +6,18 @@ export interface TriageScopeRule {
     readonly rule: string;
     readonly [key: string]: unknown;
 }
+/**
+ * Typed hotfix eligibility thresholds (#1193 / Wave 2 of #2948).
+ * Agent may propose `hotfix-candidate` only; a human promotes to `hotfix`.
+ */
+export interface HotfixCriteria {
+    /** Max changed lines for a small fix (default 10). */
+    readonly maxLines?: number;
+    /** Max changed files for a small fix (default 2). */
+    readonly maxFiles?: number;
+    /** Paths that never qualify as hotfix (default includes deploy/CI/migrations). */
+    readonly forbiddenPathGlobs?: readonly string[];
+}
 export interface PlanPolicy {
     readonly allowDirectCommitsToMaster?: boolean;
     readonly wipCap?: number;
@@ -27,6 +39,19 @@ export interface PlanPolicy {
     readonly projectionProviders?: Record<string, ProjectionProviderPolicy>;
     /** Per-host Directive hook deposit toggles (#2752). Default: all true. */
     readonly hostHooks?: Partial<Record<"claude" | "cursor" | "grok" | "codex", boolean>>;
+    /**
+     * When true, agents may open PRs but must not merge (#1193). Defaults true
+     * when `autoDeployOnMerge` is also true. Override: `policy:allow-bot-merge`
+     * or `DEFT_ALLOW_BOT_MERGE=1`.
+     */
+    readonly requireHumanMerge?: boolean;
+    /**
+     * When true, merges to the default branch auto-deploy to production.
+     * Couples with requireHumanMerge defaulting (#1193 Shadowlogic profile).
+     */
+    readonly autoDeployOnMerge?: boolean;
+    /** Structural hotfix eligibility thresholds (#1193). */
+    readonly hotfixCriteria?: HotfixCriteria;
     readonly [key: `x-${string}`]: unknown;
 }
 export interface ProjectionProviderExpectation {
@@ -42,5 +67,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.swarmSubagentBackend", "plan.policy.engineSkewWindow"];
+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.swarmSubagentBackend", "plan.policy.engineSkewWindow", "plan.policy.requireHumanMerge", "plan.policy.hotfixCriteria", "plan.policy.autoDeployOnMerge"];
 //# sourceMappingURL=policy.d.ts.map

package/dist/policy.js

@@ -10,5 +10,8 @@ export const REGISTERED_POLICY_FIELD_NAMES = [
     "plan.policy.triageHoldMarkers",
     "plan.policy.swarmSubagentBackend",
     "plan.policy.engineSkewWindow",
+    "plan.policy.requireHumanMerge",
+    "plan.policy.hotfixCriteria",
+    "plan.policy.autoDeployOnMerge",
 ];
 //# sourceMappingURL=policy.js.map

package/package.json

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

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

@@ -609,12 +609,45 @@
           "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."
         },
+        "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."
+        },
+        "autoDeployOnMerge": {
+          "type": "boolean",
+          "description": "When true, merges to the default branch auto-deploy to production. Couples with requireHumanMerge defaulting (#1193)."
+        },
+        "hotfixCriteria": {
+          "$ref": "#/$defs/HotfixCriteria"
+        },
         "projectionProviders": {
           "$ref": "#/$defs/ProjectionProviderPolicies"
         }
       },
       "additionalProperties": true
     },
+    "HotfixCriteria": {
+      "type": "object",
+      "description": "Structural hotfix eligibility thresholds (#1193). Agent may label hotfix-candidate only; human promotes hotfix.",
+      "properties": {
+        "maxLines": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Max changed lines for a small-fix hotfix candidate. Default: 10."
+        },
+        "maxFiles": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Max changed files for a small-fix hotfix candidate. Default: 2."
+        },
+        "forbiddenPathGlobs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Path globs that never qualify as hotfix (deploy/CI/migrations/auth defaults apply when omitted)."
+        }
+      },
+      "additionalProperties": true
+    },
     "ProjectionProviderPolicies": {
       "type": "object",
       "description": "Projection provider artifact policies keyed by projection kind. Values point at durable artifacts; runner command strings are not canonical policy.",