mancode 0.3.18 → 0.4.1

package/dist/{chunk-LMXUPBCN.js → chunk-S3BAOJPP.js}

@@ -592,6 +592,7 @@ var AUTHORIZATION_ACTIONS = /* @__PURE__ */ new Set([
   "handoff_offer_cancel",
   "handoff_accept_reject",
   "review_skip_or_waiver",
+  "project_maintenance",
   "team_policy_config_transport",
   "actor_profile_publish",
   "confirmed_decision_publish"
@@ -601,7 +602,7 @@ function evaluateAuthorization(input) {
   validateRequest(input);
   const failures = [];
   requireActiveSession(input, failures);
-  if (input.action !== "local_workflow_mutation") {
+  if (input.action !== "local_workflow_mutation" && input.action !== "project_maintenance") {
     if (input.action !== "actor_profile_publish" && !input.joined) {
       failures.push("MANCODE_JOIN_REQUIRED");
     }
@@ -750,6 +751,15 @@ function evaluateAuthorization(input) {
         failures.push("MANCODE_WAIVER_FORBIDDEN");
       }
       break;
+    case "project_maintenance":
+      requireExpectedRevision(input, failures);
+      requireCondition(
+        input,
+        "explicitConfirmation",
+        "MANCODE_EXPLICIT_CONFIRMATION_REQUIRED",
+        failures
+      );
+      break;
     case "team_policy_config_transport":
       requireExpectedRevision(input, failures);
       requireCondition(
@@ -1043,6 +1053,7 @@ function authorizationDecisionProjection(input) {
 var OPERATION_TYPES = /* @__PURE__ */ new Set([
   "workflow_create",
   "workflow_update",
+  "requirements_draft",
   "requirements_finalize",
   "plan_revision",
   "review_remediation",
@@ -1059,10 +1070,13 @@ var OPERATION_TYPES = /* @__PURE__ */ new Set([
   "claim_revalidation",
   "checkpoint_create",
   "solo_handoff",
+  "reframe",
   "child_result_merge",
   "task_head_reconcile",
   "transport_migrate",
   "greenfield_initialize",
+  "adapter_upgrade",
+  "project_policy_upgrade",
   "v3_activate"
 ]);
 var OPERATION_STATES = /* @__PURE__ */ new Set([
@@ -1369,7 +1383,7 @@ function allowedOperationTransitions(from) {
     case "applying":
       return /* @__PURE__ */ new Set(["committed", "repair_required", "aborted"]);
     case "repair_required":
-      return /* @__PURE__ */ new Set(["committed"]);
+      return /* @__PURE__ */ new Set(["committed", "aborted"]);
     case "committed":
     case "aborted":
       return /* @__PURE__ */ new Set();
@@ -1553,6 +1567,7 @@ function isNotFound2(error) {
 var CHECKPOINT_KINDS = /* @__PURE__ */ new Set([
   "plan_confirmed",
   "scope_changed",
+  "requirements_reframed",
   "diagnostic_started",
   "base_changed",
   "verification_completed",
@@ -3601,6 +3616,28 @@ function allowedTransitions(from) {
 }
 
 // src/context/workflow-metadata.ts
+var SUPPORTED_WORKFLOW_POLICY_VERSIONS = {
+  planning: [1, 2],
+  review: [1, 2],
+  verification: [1]
+};
+var WorkflowPolicyVersionUnsupportedError = class extends Error {
+  constructor(component, observedVersion, supportedVersions, requiredWriter) {
+    super(
+      `MANCODE_POLICY_VERSION_UNSUPPORTED: component=${component} observed=${String(observedVersion)} supported=${supportedVersions.join(",")} requiredWriter=${requiredWriter}`
+    );
+    this.component = component;
+    this.observedVersion = observedVersion;
+    this.supportedVersions = supportedVersions;
+    this.requiredWriter = requiredWriter;
+    this.name = "WorkflowPolicyVersionUnsupportedError";
+  }
+  component;
+  observedVersion;
+  supportedVersions;
+  requiredWriter;
+  code = "MANCODE_POLICY_VERSION_UNSUPPORTED";
+};
 var TRANSITION_STATES = /* @__PURE__ */ new Set([
   "stable",
   "operation_pending",
@@ -3991,20 +4028,24 @@ function parsePolicyVersions(value) {
     "workflow metadata policyVersions"
   );
   return {
-    planning: parsePositiveIntegerOrNull2(
-      value.planning,
-      "workflow metadata planning policy version"
-    ),
-    review: parsePositiveIntegerOrNull2(
-      value.review,
-      "workflow metadata review policy version"
-    ),
-    verification: parsePositiveIntegerOrNull2(
-      value.verification,
-      "workflow metadata verification policy version"
-    )
+    planning: parsePolicyVersionOrNull(value.planning, "planning"),
+    review: parsePolicyVersionOrNull(value.review, "review"),
+    verification: parsePolicyVersionOrNull(value.verification, "verification")
   };
 }
+function parsePolicyVersionOrNull(value, component) {
+  if (value === null) return null;
+  const supported = SUPPORTED_WORKFLOW_POLICY_VERSIONS[component];
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || !supported.some((version) => version === value)) {
+    throw new WorkflowPolicyVersionUnsupportedError(
+      component,
+      value,
+      supported,
+      component === "planning" && value === 2 ? "0.4.0" : ">0.4.0"
+    );
+  }
+  return value;
+}
 function parsePlanDecision(value) {
   if (value === null) return null;
   if (typeof value !== "string" || !PLAN_DECISIONS.has(value)) {
@@ -4194,9 +4235,6 @@ function parsePositiveInteger7(value, label) {
   }
   return value;
 }
-function parsePositiveIntegerOrNull2(value, label) {
-  return value === null ? null : parsePositiveInteger7(value, label);
-}
 function parseNonNegativeInteger4(value, label) {
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
     throw new Error(`${label} must be a non-negative integer`);
@@ -5827,6 +5865,12 @@ var VERSION_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 var DIGEST_PATTERN13 = /^sha256:[a-f0-9]{64}$/;
 function parseSchemaManifest(value) {
   assertRecord(value, "schema manifest");
+  if (value.manifestVersion !== 1 && value.manifestVersion !== 2) {
+    throw new Error(
+      `MANCODE_MANIFEST_VERSION_UNSUPPORTED: observed=${String(value.manifestVersion)} supported=1,2 requiredWriter=0.4.0`
+    );
+  }
+  const manifestVersion = value.manifestVersion;
   assertKnownKeys(
     value,
     [
@@ -5839,21 +5883,19 @@ function parseSchemaManifest(value) {
       "activatedAt",
       "legacyBaseline",
       "managedAdapters",
-      "lastOperationId"
+      "lastOperationId",
+      ...manifestVersion === 2 ? ["workflowPolicyDefaults"] : []
     ],
     "schema manifest"
   );
-  if (value.manifestVersion !== 1 || value.layoutVersion !== 3) {
-    throw new Error(
-      "schema manifest must use manifestVersion 1 and layoutVersion 3"
-    );
+  if (value.layoutVersion !== 3) {
+    throw new Error("schema manifest must use layoutVersion 3");
   }
   assertUlid(value.epoch, "schema manifest epoch");
   if (typeof value.activationState !== "string" || !ACTIVATION_STATES.has(value.activationState)) {
     throw new Error("schema manifest activationState is invalid");
   }
-  const manifest = {
-    manifestVersion: 1,
+  const common = {
     layoutVersion: 3,
     epoch: value.epoch,
     activationState: value.activationState,
@@ -5864,11 +5906,48 @@ function parseSchemaManifest(value) {
     managedAdapters: parseManagedAdapters(value.managedAdapters),
     lastOperationId: parseUlidOrNull9(value.lastOperationId, "lastOperationId")
   };
+  const manifest = manifestVersion === 1 ? { manifestVersion: 1, ...common } : {
+    manifestVersion: 2,
+    ...common,
+    workflowPolicyDefaults: parseWorkflowPolicyDefaults(
+      value.workflowPolicyDefaults
+    )
+  };
   assertManifestStateShape(manifest);
+  if (manifest.manifestVersion === 2 && (compareVersions(manifest.minReaderVersion, "0.4.0") < 0 || compareVersions(manifest.minWriterVersion, "0.4.0") < 0)) {
+    throw new Error(
+      "schema manifest V2 requires minReaderVersion and minWriterVersion 0.4.0 or newer"
+    );
+  }
+  return manifest;
+}
+function serializeSchemaManifest(value) {
+  return `${JSON.stringify(parseSchemaManifest(value), null, 2)}
+`;
+}
+function managedAdapterNames(inventory) {
+  return MANAGED_ADAPTERS.filter((adapter) => inventory[adapter] !== void 0);
+}
+function parseSchemaManifestV1(value) {
+  const manifest = parseSchemaManifest(value);
+  if (manifest.manifestVersion !== 1) {
+    throw new Error(
+      `MANCODE_MANIFEST_VERSION_UNSUPPORTED: observed=${manifest.manifestVersion} supported=1 requiredWriter=0.3.x`
+    );
+  }
+  return manifest;
+}
+function parseSchemaManifestV2(value) {
+  const manifest = parseSchemaManifest(value);
+  if (manifest.manifestVersion !== 2) {
+    throw new Error(
+      `MANCODE_MANIFEST_VERSION_UNSUPPORTED: observed=${manifest.manifestVersion} supported=2 requiredWriter=0.4.0`
+    );
+  }
   return manifest;
 }
 function assertSchemaManifestTransition(previous, next) {
-  if (previous.manifestVersion !== next.manifestVersion || previous.layoutVersion !== next.layoutVersion || previous.epoch !== next.epoch || !sameLegacyBaseline(previous.legacyBaseline, next.legacyBaseline)) {
+  if (previous.manifestVersion !== next.manifestVersion || previous.layoutVersion !== next.layoutVersion || previous.epoch !== next.epoch || !sameLegacyBaseline(previous.legacyBaseline, next.legacyBaseline) || compareVersions(next.minReaderVersion, previous.minReaderVersion) < 0 || compareVersions(next.minWriterVersion, previous.minWriterVersion) < 0) {
     throw new Error(
       "schema manifest identity and legacy baseline are immutable"
     );
@@ -5882,11 +5961,33 @@ function assertSchemaManifestTransition(previous, next) {
     );
   }
 }
+function assertSchemaManifestPolicyUpgrade(previous, next) {
+  if (previous.manifestVersion !== 1 || next.manifestVersion !== 2 || previous.layoutVersion !== next.layoutVersion || previous.epoch !== next.epoch || previous.activationState !== "v3_active" || next.activationState !== "v3_active" || previous.activatedAt !== next.activatedAt || !sameLegacyBaseline(previous.legacyBaseline, next.legacyBaseline) || !managedAdapterInventoriesMatch(
+    previous.managedAdapters,
+    next.managedAdapters
+  ) || compareVersions(next.minReaderVersion, previous.minReaderVersion) < 0 || compareVersions(next.minWriterVersion, previous.minWriterVersion) < 0 || next.workflowPolicyDefaults.planning !== 2 || next.lastOperationId === null || next.lastOperationId === previous.lastOperationId) {
+    throw new Error("invalid schema manifest Policy 2 upgrade");
+  }
+}
 function assertActivationRollbackManifestTransition(previous, next) {
   if (previous.manifestVersion !== next.manifestVersion || previous.layoutVersion !== next.layoutVersion || previous.epoch !== next.epoch || !sameLegacyBaseline(previous.legacyBaseline, next.legacyBaseline) || previous.activationState !== "v3_active" || next.activationState !== "dual_read" || previous.activatedAt === null || next.activatedAt !== null) {
     throw new Error("invalid activation rollback manifest transition");
   }
 }
+function parseWorkflowPolicyDefaults(value) {
+  assertRecord(value, "schema manifest workflowPolicyDefaults");
+  assertKnownKeys(
+    value,
+    ["planning"],
+    "schema manifest workflowPolicyDefaults"
+  );
+  if (value.planning !== 2) {
+    throw new Error(
+      `MANCODE_POLICY_VERSION_UNSUPPORTED: component=planning observed=${String(value.planning)} supported=2 requiredWriter=0.4.0`
+    );
+  }
+  return { planning: 2 };
+}
 function parseVersion(value, label) {
   if (typeof value !== "string" || !VERSION_PATTERN.test(value)) {
     throw new Error(`schema manifest ${label} must be a semantic version`);
@@ -5925,10 +6026,14 @@ function parseManagedAdapters(value) {
   assertKnownKeys(value, MANAGED_ADAPTERS, "schema manifest managedAdapters");
   const adapters = {};
   for (const adapter of MANAGED_ADAPTERS) {
-    if (typeof value[adapter] !== "string" || !value[adapter].trim()) {
-      throw new Error(`schema manifest managedAdapters.${adapter} is required`);
+    const version = value[adapter];
+    if (version === void 0) continue;
+    if (typeof version !== "string" || !version.trim()) {
+      throw new Error(
+        `schema manifest managedAdapters.${adapter} must be a non-empty version`
+      );
     }
-    adapters[adapter] = value[adapter];
+    adapters[adapter] = version;
   }
   return adapters;
 }
@@ -5957,6 +6062,46 @@ function assertManifestStateShape(manifest) {
     );
   }
 }
+function managedAdapterInventoriesMatch(left, right) {
+  const leftKeys = managedAdapterNames(left);
+  const rightKeys = managedAdapterNames(right);
+  return leftKeys.length === rightKeys.length && leftKeys.every(
+    (adapter, index) => adapter === rightKeys[index] && left[adapter] === right[adapter]
+  );
+}
+function compareVersions(left, right) {
+  const [leftCore = "", leftPrerelease] = left.split("-", 2);
+  const [rightCore = "", rightPrerelease] = right.split("-", 2);
+  const leftParts = leftCore.split(".").map(Number);
+  const rightParts = rightCore.split(".").map(Number);
+  for (let index = 0; index < 3; index += 1) {
+    const delta = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+    if (delta !== 0) return delta;
+  }
+  if (leftPrerelease === rightPrerelease) return 0;
+  if (leftPrerelease === void 0) return 1;
+  if (rightPrerelease === void 0) return -1;
+  return comparePrerelease(leftPrerelease, rightPrerelease);
+}
+function comparePrerelease(left, right) {
+  const leftParts = left.split(".");
+  const rightParts = right.split(".");
+  for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+    const leftPart = leftParts[index];
+    const rightPart = rightParts[index];
+    if (leftPart === void 0) return -1;
+    if (rightPart === void 0) return 1;
+    if (leftPart === rightPart) continue;
+    const leftNumeric = /^\d+$/.test(leftPart);
+    const rightNumeric = /^\d+$/.test(rightPart);
+    if (leftNumeric && rightNumeric)
+      return Number(leftPart) - Number(rightPart);
+    if (leftNumeric) return -1;
+    if (rightNumeric) return 1;
+    return leftPart.localeCompare(rightPart, "en");
+  }
+  return 0;
+}
 function sameLegacyBaseline(left, right) {
   return left === right || left !== null && right !== null && left.stateDigest === right.stateDigest && left.workflowIndexDigest === right.workflowIndexDigest;
 }
@@ -7020,10 +7165,20 @@ function storedTaskAggregateDigest(snapshot) {
 }
 
 export {
+  isUlid,
   assertUlid,
   createUlid,
   assertRecord,
   assertKnownKeys,
+  parseSchemaManifest,
+  serializeSchemaManifest,
+  managedAdapterNames,
+  parseSchemaManifestV1,
+  parseSchemaManifestV2,
+  assertSchemaManifestTransition,
+  assertSchemaManifestPolicyUpgrade,
+  assertActivationRollbackManifestTransition,
+  managedAdapterInventoriesMatch,
   formatTaskRef,
   parseTaskRef,
   parseTaskRefValue,
@@ -7036,6 +7191,9 @@ export {
   claimDirectory,
   handoffDirectory,
   taskHeadDirectory,
+  gitRefWorkflowRepairJournalPath,
+  listGitRefWorkflowRepairJournalSummaries,
+  listUnfinishedGitRefWorkflowRepairs,
   canonicalizeJson,
   digestCanonicalJson,
   sortUtf8StringSet,
@@ -7053,9 +7211,14 @@ export {
   operationReservationJournalDigest,
   assertOperationReservationTopology,
   withOperationReservationDigests,
-  parseSchemaManifest,
-  assertSchemaManifestTransition,
-  assertActivationRollbackManifestTransition,
+  parseOperationReservation,
+  createOperationReservation,
+  writeOperationReservation,
+  readOperationReservation,
+  removeOperationReservation,
+  parseCheckpoint,
+  parseCheckpointKind,
+  checkpointDigest,
   parseRequirementsLedger,
   requirementsLedgerDigest,
   assertRequirementsLedgerTransition,
@@ -7079,9 +7242,13 @@ export {
   workflowMetadataDigest,
   assertWorkflowMetadataTransition,
   assertParentWorkflowRelation,
-  parseCheckpoint,
-  parseCheckpointKind,
-  checkpointDigest,
+  buildTaskAggregateManifest,
+  taskAggregateDigest,
+  parseTaskAggregateManifest,
+  assertTaskCompletionGate,
+  parseTaskHeadFence,
+  assertTaskHeadFenceMatchesAggregate,
+  assertTaskHeadFenceTransition,
   parseClaim,
   assertClaimTransition,
   normalizeClaimScope,
@@ -7094,21 +7261,6 @@ export {
   assertConfigPolicyConsistency,
   assertProjectConfigTransition,
   assertTeamPolicyTransition,
-  buildTaskAggregateManifest,
-  taskAggregateDigest,
-  parseTaskAggregateManifest,
-  assertTaskCompletionGate,
-  parseTaskHeadFence,
-  assertTaskHeadFenceMatchesAggregate,
-  assertTaskHeadFenceTransition,
-  parseOperationReservation,
-  createOperationReservation,
-  writeOperationReservation,
-  readOperationReservation,
-  removeOperationReservation,
-  gitRefWorkflowRepairJournalPath,
-  listGitRefWorkflowRepairJournalSummaries,
-  listUnfinishedGitRefWorkflowRepairs,
   createConfirmedDecision,
   publishConfirmedDecision,
   readConfirmedDecision,
@@ -7123,4 +7275,4 @@ export {
   V3ContextStore,
   storedTaskAggregateDigest
 };
-//# sourceMappingURL=chunk-LMXUPBCN.js.map
+//# sourceMappingURL=chunk-S3BAOJPP.js.map