ai-delivery-workflow 0.4.0 → 0.5.1

package/lib/fs-utils.mjs

@@ -35,19 +35,3 @@ export function assertPathInside(root, target) {
   if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) return target;
   throw new Error(`Path resolves outside the project: ${target} -> ${realAncestor}`);
 }
-
-export function resolveContainedRelativePath(root, relative, allowedPrefixes = []) {
-  const value = String(relative || "");
-  if (!value || value.includes("\\") || value.includes("\0")
-    || path.posix.isAbsolute(value) || path.posix.normalize(value) !== value
-    || value === ".." || value.startsWith("../")) {
-    throw new Error(`Invalid migration path: ${value || "missing"}.`);
-  }
-  if (allowedPrefixes.length && !allowedPrefixes.some((prefix) =>
-    value === prefix || value.startsWith(`${prefix}/`))) {
-    throw new Error(`Migration path is outside its allowed area: ${value}.`);
-  }
-  const target = path.resolve(root, ...value.split("/"));
-  assertPathInside(root, target);
-  return target;
-}

package/lib/npm-auth.mjs

@@ -0,0 +1,16 @@
+const OFFICIAL_NPM_REGISTRY = "https://registry.npmjs.org/";
+const OFFICIAL_NPM_TOKEN_ENV_KEY = "npm_config_//registry.npmjs.org/:_authToken";
+
+export function withNpmAccessToken(environment = process.env) {
+  const token = typeof environment.NPM_ACCESS_TOKEN === "string"
+    ? environment.NPM_ACCESS_TOKEN.trim()
+    : "";
+  if (!token) return environment;
+
+  return {
+    ...environment,
+    [OFFICIAL_NPM_TOKEN_ENV_KEY]: token,
+  };
+}
+
+export { OFFICIAL_NPM_REGISTRY, OFFICIAL_NPM_TOKEN_ENV_KEY };

package/lib/project-bootstrap.mjs

@@ -14,7 +14,6 @@ const IGNORED_DIRECTORIES = new Set([
   ".git",
   ".agents",
   ".codex",
-  ".ai-delivery",
   ".workflow",
   ".idea",
   ".vscode",
@@ -94,19 +93,6 @@ const WORKFLOW_REQUIRED_FILES = [
   ".workflow/standards/index.yaml",
   ".gitattributes",
 ];
-const LEGACY_WORKFLOW_REQUIRED_FILES = [
-  ".ai-delivery/workspace.yaml",
-  ".ai-delivery/install-manifest.json",
-  ".codex/config.toml",
-  "AGENTS.md",
-  ".ai-delivery/state/state.mjs",
-  ".ai-delivery/hooks/hook-event.mjs",
-  "delivery/project.yaml",
-  "delivery/workflow-state.yaml",
-  "delivery/artifact-registry.yaml",
-  "delivery/standards-baseline.yaml",
-  "standards/index.yaml",
-];
 const ESSENTIAL_STARTUP_SKILLS = [
   "ai-delivery-bootstrap",
   "ai-delivery-checkpoint-task",
@@ -306,13 +292,13 @@ function normalizeInspectedScope(value, fallbackScopeId = null) {
 }
 
 function inspectWorkflowScopes(workflowState, errors) {
-  const schemaVersion = Number(workflowState?.schema_version || 1);
-  const development = schemaVersion >= 2
-    ? normalizeInspectedScope(workflowState.development_state)
-    : normalizeInspectedScope(workflowState, workflowState.iteration_id ?? null);
-  const release = schemaVersion >= 2
-    ? normalizeInspectedScope(workflowState.release_state)
-    : normalizeInspectedScope(null);
+  if (Number(workflowState?.schema_version) !== 2
+    || !workflowState?.development_state || !workflowState?.release_state) {
+    errors.push("formal state must use schema 2 with development_state and release_state scopes");
+    return { development: normalizeInspectedScope(null), release: normalizeInspectedScope(null) };
+  }
+  const development = normalizeInspectedScope(workflowState.development_state);
+  const release = normalizeInspectedScope(workflowState.release_state);
 
   for (const [scopeName, scope] of [["development", development], ["release", release]]) {
     for (const conflict of findIncompatibleNodeStates(scope)) {
@@ -505,23 +491,15 @@ export function inspectProjectState(target) {
   const codebase = scanProjectFiles(codeRoot);
   const errors = [];
   const currentIndicators = WORKFLOW_REQUIRED_FILES.filter((file) => exists(root, file));
-  const legacyIndicators = LEGACY_WORKFLOW_REQUIRED_FILES.filter((file) => exists(root, file));
-  const currentStateIndicators = WORKFLOW_REQUIRED_FILES.filter((file) =>
-    file.startsWith(".workflow/delivery/") || file === ".workflow/standards/index.yaml")
-    .filter((file) => exists(root, file));
-  const legacyStateIndicators = LEGACY_WORKFLOW_REQUIRED_FILES.filter((file) =>
-    file.startsWith("delivery/") || file === "standards/index.yaml")
+  const unsupportedIndicators = [".ai-delivery", ".ai-delivery-task", "delivery", "standards"]
     .filter((file) => exists(root, file));
-  const legacyLayout = currentStateIndicators.length === 0 && legacyStateIndicators.length > 0;
-  const requiredFiles = legacyLayout ? LEGACY_WORKFLOW_REQUIRED_FILES : WORKFLOW_REQUIRED_FILES;
-  const workflowRoot = legacyLayout ? "." : ".workflow";
-  const workflowIndicators = requiredFiles.filter((file) => exists(root, file));
-  const missingFiles = requiredFiles.filter((file) => !exists(root, file));
+  const workflowRoot = ".workflow";
+  const workflowIndicators = WORKFLOW_REQUIRED_FILES.filter((file) => exists(root, file));
+  const missingFiles = WORKFLOW_REQUIRED_FILES.filter((file) => !exists(root, file));
   const installation = {
-    detected: currentIndicators.length > 0 || legacyIndicators.length > 0,
-    complete: workflowIndicators.length === requiredFiles.length,
+    detected: currentIndicators.length > 0 || unsupportedIndicators.length > 0,
+    complete: workflowIndicators.length === WORKFLOW_REQUIRED_FILES.length,
     workflow_root: workflowRoot,
-    legacy_layout: legacyLayout,
     present_files: workflowIndicators,
     missing_files: missingFiles,
     installed_skill_count: 0,
@@ -556,25 +534,13 @@ export function inspectProjectState(target) {
     dependency_errors: [],
   };
 
-  if (legacyLayout) {
-    errors.push("检测到旧版 delivery/ 与 standards/ 布局；迁移到 .workflow/ 后才能继续执行。");
-  }
-  if (currentStateIndicators.length > 0 && legacyStateIndicators.length > 0) {
-    errors.push("同时检测到 .workflow 和旧版 delivery/standards 状态；必须人工确定唯一权威根。");
+  if (unsupportedIndicators.length) {
+    errors.push(`检测到不受支持的旧工作流路径：${unsupportedIndicators.join(", ")}。当前项目只接受 .workflow/ 布局。`);
   }
 
   if (installation.complete) {
-    if (legacyLayout) {
-      errors.push("检测到旧版 delivery/ 与 standards/ 布局；迁移到 .workflow/ 后才能继续执行。");
-    }
-    if (currentStateIndicators.length > 0 && legacyStateIndicators.length > 0) {
-      errors.push("同时检测到 .workflow 和旧版 delivery/standards 状态；必须人工确定唯一权威根。");
-    }
-    const manifest = readStructuredFile(path.join(
-      root,
-      legacyLayout ? ".ai-delivery/install-manifest.json" : ".workflow/config/install-manifest.json",
-    ), "json", errors);
-    const stateRoot = path.join(root, workflowRoot);
+    const manifest = readStructuredFile(path.join(root, ".workflow/config/install-manifest.json"), "json", errors);
+    const stateRoot = path.join(root, ".workflow");
     let project = null;
     let workflowState = null;
     let registry = null;
@@ -583,13 +549,10 @@ export function inspectProjectState(target) {
       workflowState = readStructuredFile(path.join(stateRoot, "delivery", "workflow-state.yaml"), "yaml", errors);
       registry = readStructuredFile(path.join(stateRoot, "delivery", "artifact-registry.yaml"), "yaml", errors);
     };
-    if (legacyLayout) readFormalState();
-    else {
-      try {
-        withFormalStateReadLock(root, readFormalState);
-      } catch (error) {
-        errors.push(error.message);
-      }
+    try {
+      withFormalStateReadLock(root, readFormalState);
+    } catch (error) {
+      errors.push(error.message);
     }
     readStructuredFile(path.join(stateRoot, "delivery", "standards-baseline.yaml"), "yaml", errors);
     readStructuredFile(path.join(stateRoot, "standards", "index.yaml"), "yaml", errors);

package/lib/project-installer.mjs

@@ -9,10 +9,8 @@ import { isSeq, parse as parseYaml, parseDocument, stringify as stringifyYaml }
 import { assertPathInside, atomicWrite, filesUnder } from "./fs-utils.mjs";
 import { inspectCodeGraph } from "./codegraph.mjs";
 import { executeDeliveryStateCommand } from "./delivery-state.mjs";
-import { planPrototypeMigration } from "./prototype-migration.mjs";
 import { inspectHookConfig, managedHookConfigProjection, mergeHookConfig } from "./toml-hooks.mjs";
 import {
-  LEGACY_WORKSPACE_CONFIG,
   WORKSPACE_CONFIG,
   gitCommonDirectory,
   gitTopLevel,
@@ -39,7 +37,6 @@ const GIT_ATTRIBUTE_ENTRIES = [
   "/.gitattributes text eol=lf",
   ...RAW_GIT_ATTRIBUTE_TARGETS.map((file) => `/${file} -text`),
 ];
-const OBSOLETE_IGNORE_ENTRIES = new Set([".ai-delivery-task", ".ai-delivery/backups/"]);
 const INSTALL_MANIFEST = path.join(".workflow", "config", "install-manifest.json");
 const UPGRADE_RUNTIME = path.join(".workflow", "delivery", "runtime", "upgrades");
 const PRESERVED_DETAIL_LIMIT = 200;
@@ -48,32 +45,18 @@ const DOCTOR_ATTRIBUTE_BATCH_SIZE = 5_000;
 const DOCTOR_DETAIL_LIMIT = 200;
 const FORMAL_STATE_INSPECT_MAX_BUFFER = 16 * 1024 * 1024;
 const INSTALL_MANIFEST_SCHEMA = 6;
-const UI_CONTRACT_VERSION = "prototype-first-ui-v1";
-const FORMAL_STATE_YAML = {
-  parse: parseYaml,
-  stringify: (value) => stringifyYaml(value, { lineWidth: 0 }),
-};
 const MERGED_MANAGED_SURFACES = Object.freeze([
   { key: "agents", path: "AGENTS.md" },
   { key: "hook_config", path: ".codex/config.toml" },
   { key: "gitignore", path: ".gitignore" },
   { key: "gitattributes", path: ".gitattributes" },
 ]);
-const ACTIVE_TASK = path.join(".workflow", "delivery", "runtime", "active-task.json");
-const LEGACY_ACTIVE_TASK = ".ai-delivery-task";
 const WORKFLOW_CONTENT_DIRECTORIES = ["product", "architecture", "experience", "iterations", "releases"];
 const CONTROL_DIRECTORIES = [
   "tasks", "checkpoints", "artifacts", "gates", "versions", "releases", "events", "archives",
-  "migrations", "repairs",
+  "repairs",
 ];
-const ENSURED_CONTROL_DIRECTORIES = ["migrations", "repairs"];
-const RETIRED_MANAGED_ASSETS = Object.freeze([
-  {
-    path: ".workflow/tools/viewer",
-    kind: "retired-directory",
-    manifest_key: "viewer",
-  },
-]);
+const ENSURED_CONTROL_DIRECTORIES = ["repairs"];
 const ESSENTIAL_STARTUP_SKILLS = [
   "ai-delivery-assemble-release",
   "ai-delivery-bootstrap",
@@ -138,11 +121,9 @@ const V2_PROTOTYPE_DELIVERY_SURFACE_FILES = Object.freeze([
 const REQUIRED_PACKAGE_SURFACE_FILES = Object.freeze([
   "LICENSE",
   "bin/ai-delivery.mjs",
-  "docs/PROTOTYPE-MIGRATION.zh-CN.md",
   "lib/mock-scenario-pack.mjs",
   "lib/mock-system.mjs",
-  "lib/project-migration.mjs",
-  "lib/prototype-migration.mjs",
+  "lib/project-repair.mjs",
   "lib/prototype-page-review.mjs",
   "lib/prototype-review-target.mjs",
   "skills/ai-delivery-checkpoint-task/scripts/hook-event.mjs",
@@ -344,8 +325,7 @@ function mergeManagedMarkdown(existing, managedTemplate) {
 }
 
 function mergeGitignore(existing, requiredEntries = []) {
-  const lines = existing.split(/\r?\n/)
-    .filter((line) => !OBSOLETE_IGNORE_ENTRIES.has(line.trim()));
+  const lines = existing.split(/\r?\n/);
   const additions = [...IGNORE_ENTRIES, ...requiredEntries]
     .filter((entry) => !lines.some((line) => line.trim() === entry));
   const retained = lines.join("\n").trimEnd();
@@ -706,7 +686,7 @@ function mergedSurfaceManagedDigest(key, text, codePath) {
   if (key === "hook_config") return contentDigest(JSON.stringify(managedHookConfigProjection(text)));
   const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
   if (key === "gitignore") {
-    const managedEntries = new Set([...IGNORE_ENTRIES, `/${codePath}/`, ...OBSOLETE_IGNORE_ENTRIES]);
+    const managedEntries = new Set([...IGNORE_ENTRIES, `/${codePath}/`]);
     return contentDigest(JSON.stringify(lines.filter((line) => managedEntries.has(line)).sort()));
   }
   return contentDigest(JSON.stringify(lines.filter((line) => GIT_ATTRIBUTE_ENTRIES.includes(line)).sort()));
@@ -868,10 +848,11 @@ export function initProject(packageRoot, target, options = {}) {
     "backups",
     new Date().toISOString().replaceAll(":", "-"),
   );
-  const legacyRoot = path.join(target, ".ai-delivery");
-  const legacyActiveTask = path.join(target, LEGACY_ACTIVE_TASK);
-  const hasLegacyRoot = fs.existsSync(legacyRoot);
-  const hasLegacyActiveTask = fs.existsSync(legacyActiveTask);
+  const unsupportedRoot = path.join(target, ".ai-delivery");
+  const unsupportedActiveTask = path.join(target, ".ai-delivery-task");
+  if (fs.existsSync(unsupportedRoot) || fs.existsSync(unsupportedActiveTask)) {
+    throw new Error("Unsupported workflow layout detected; install requires the current .workflow contract.");
+  }
   let previousManifest = null;
   try {
     previousManifest = JSON.parse(fs.readFileSync(path.join(target, INSTALL_MANIFEST), "utf8"));
@@ -889,24 +870,9 @@ export function initProject(packageRoot, target, options = {}) {
     throw new Error(`Refusing package downgrade from ${previousManifest.version} to ${packageVersion}; use --force only after explicit approval.`);
   }
   const packageVersionUpgrade = packageVersionComparison > 0;
-  const reinstallManagedRuntime = force || hasLegacyRoot || hasLegacyActiveTask
-    || packageVersionUpgrade || (previousManifest && previousManifest.schema_version < 5);
-  if (!dryRun && hasLegacyRoot) {
-    const legacyBackup = path.join(backupRoot, "legacy-ai-delivery");
-    fs.mkdirSync(path.dirname(legacyBackup), { recursive: true });
-    fs.cpSync(legacyRoot, legacyBackup, { recursive: true });
-  }
-  if (!dryRun && hasLegacyActiveTask) {
-    const taskBackup = path.join(backupRoot, "legacy-active-task.json");
-    fs.mkdirSync(path.dirname(taskBackup), { recursive: true });
-    fs.copyFileSync(legacyActiveTask, taskBackup);
-  }
+  const reinstallManagedRuntime = force || packageVersionUpgrade;
   const currentWorkspace = readWorkspaceConfiguration(target, { optional: true });
-  const legacyWorkspaceFile = path.join(target, LEGACY_WORKSPACE_CONFIG);
-  const legacyWorkspace = !currentWorkspace && fs.existsSync(legacyWorkspaceFile)
-    ? readWorkspaceConfiguration(target, { configurationPath: LEGACY_WORKSPACE_CONFIG })
-    : null;
-  const existingWorkspace = (currentWorkspace || legacyWorkspace)?.configuration;
+  const existingWorkspace = currentWorkspace?.configuration;
   const codePath = options.codePath || existingWorkspace?.code_repository?.path || "code";
   const codeId = options.codeId || existingWorkspace?.code_repository?.repo_id || "app";
   const sharedRemote = options.sharedRemote || null;
@@ -942,23 +908,23 @@ export function initProject(packageRoot, target, options = {}) {
   const sourceStandardsIndex = path.join(sourceWorkflow, "standards", "index.yaml");
   const workflowRoot = path.join(target, ".workflow");
   const standardsIndexFile = path.join(workflowRoot, "standards", "index.yaml");
-  const legacyIndicators = [
+  const unsupportedIndicators = [
     path.join(target, "delivery", "project.yaml"),
     path.join(target, "delivery", "workflow-state.yaml"),
     path.join(target, "delivery", "artifact-registry.yaml"),
     path.join(target, "delivery", "standards-baseline.yaml"),
     path.join(target, "standards", "index.yaml"),
   ].filter((candidate) => fs.existsSync(candidate));
-  if (fs.existsSync(workflowRoot) && legacyIndicators.length) {
+  if (fs.existsSync(workflowRoot) && unsupportedIndicators.length) {
     throw new Error(
-      "Detected both .workflow and legacy delivery/standards directories. "
+      "Detected both .workflow and unsupported delivery/standards directories. "
       + "Resolve the split workflow state before initialization.",
     );
   }
-  if (legacyIndicators.length) {
+  if (unsupportedIndicators.length) {
     throw new Error(
-      "Legacy workflow directories detected at delivery/ or standards/. "
-      + "Move them under .workflow/ before upgrading; refusing to create split workflow state.",
+      "Unsupported workflow directories detected at delivery/ or standards/. "
+      + "Remove them before initialization; refusing to create split workflow state.",
     );
   }
   for (const managedPath of [
@@ -986,8 +952,6 @@ export function initProject(packageRoot, target, options = {}) {
   const hookConflict = fs.existsSync(hookDestination)
     && !managedFilesEqual(hookDestination, sourceHook);
   if (hookConflict && !reinstallManagedRuntime) conflicts.push(path.relative(target, hookDestination));
-  const retiredViewerDestination = path.join(target, ".workflow", "tools", "viewer");
-  const retireLegacyViewer = hasLegacyRoot && fs.existsSync(retiredViewerDestination);
   const designReferenceDestination = path.join(target, "ref", "ui");
   let designReferencePlan = null;
   if (!fs.existsSync(designReferenceDestination)) {
@@ -1064,19 +1028,6 @@ export function initProject(packageRoot, target, options = {}) {
     ? fs.readFileSync(gitattributesFile, "utf8")
     : "";
   const gitattributesText = mergeGitattributes(existingGitattributes);
-  if (hasLegacyRoot || hasLegacyActiveTask) {
-    actions.push("migrate legacy .ai-delivery runtime into .workflow");
-    if (!dryRun) {
-      if (hasLegacyActiveTask) {
-        const activeTask = path.join(target, ACTIVE_TASK);
-        if (!fs.existsSync(activeTask)) {
-          fs.mkdirSync(path.dirname(activeTask), { recursive: true });
-          fs.copyFileSync(legacyActiveTask, activeTask);
-        }
-      }
-    }
-  }
-
   for (const plan of skillPlans) {
     if (plan.type === "copy") {
       actions.push(`install .agents/skills/${plan.name}`);
@@ -1098,9 +1049,6 @@ export function initProject(packageRoot, target, options = {}) {
   } else if (hookConflict) {
     backupAndReplace(target, hookDestination, sourceHook, backupRoot, actions, dryRun);
   }
-  if (retireLegacyViewer) {
-    backupAndRemove(target, retiredViewerDestination, backupRoot, actions, dryRun);
-  }
   if (designReferencePlan?.type === "copy") {
     actions.push("install ref/ui Design Reference Library");
     if (!dryRun) {
@@ -1200,21 +1148,6 @@ export function initProject(packageRoot, target, options = {}) {
     if (!dryRun) atomicWrite(manifestFile, manifestText);
   }
 
-  if (!dryRun && (hasLegacyRoot || hasLegacyActiveTask)) {
-    for (const required of [
-      path.join(target, WORKSPACE_CONFIG),
-      path.join(target, INSTALL_MANIFEST),
-      path.join(target, ".workflow", "tools", "state", "state.mjs"),
-      path.join(target, ".workflow", "tools", "hooks", "hook-event.mjs"),
-    ]) {
-      if (!fs.existsSync(required)) {
-        throw new Error(`Legacy migration is incomplete; preserved .ai-delivery for recovery: ${required}`);
-      }
-    }
-    if (hasLegacyRoot) fs.rmSync(legacyRoot, { recursive: true, force: true });
-    if (hasLegacyActiveTask) fs.rmSync(legacyActiveTask, { force: true });
-  }
-
   return {
     actions: [...workspace.actions, ...actions],
     summary: `${dryRun ? "Dry run" : "Initialized"} ${skillNames.length} workspace-scoped AI delivery skills in ${target}`,
@@ -1456,11 +1389,9 @@ function planUpgrade(packageRoot, target, options) {
     validateManagedPath(target, path.join(target, managedPath));
   }
   const { manifest, manifestFile } = readInstallManifest(target);
-  if (!Number.isInteger(manifest.schema_version)
-    || manifest.schema_version < 5
-    || manifest.schema_version > INSTALL_MANIFEST_SCHEMA) {
+  if (manifest.schema_version !== INSTALL_MANIFEST_SCHEMA) {
     throw new Error(
-      `Installation manifest schema ${manifest.schema_version} is incompatible with upgrade; run the compatible migration or repair command first.`,
+      `Installation manifest schema ${manifest.schema_version} is unsupported; expected current schema ${INSTALL_MANIFEST_SCHEMA}.`,
     );
   }
   const comparison = comparePackageVersions(packageVersion, manifest.version);
@@ -1471,10 +1402,6 @@ function planUpgrade(packageRoot, target, options) {
     throw new Error(`Refusing package downgrade from ${manifest.version} to ${packageVersion}; use --force only after explicit approval.`);
   }
   const workspace = readWorkspaceConfiguration(target);
-  const contractRetirement = executeDeliveryStateCommand([
-    "contract", "retire", "--project", target, "--gate-id", "UX-LF", "--dry-run",
-  ], { yaml: FORMAL_STATE_YAML });
-  const prototypeMigration = planPrototypeMigration(target);
   const codeRepository = workspace.configuration.code_repository;
   if (["path", "repo_id", "remote", "default_branch"].some((key) =>
     (manifest.code_repository?.[key] ?? null) !== (codeRepository[key] ?? null))) {
@@ -1484,18 +1411,12 @@ function planUpgrade(packageRoot, target, options) {
   }
   const sources = installationSources(packageRoot);
   const exactAssets = managedAssetInventory(sources, manifest);
-  const retiredAssets = RETIRED_MANAGED_ASSETS
-    .filter((asset) => manifest.managed_assets?.[asset.manifest_key])
-    .map((asset) => ({
-      ...asset,
-      previous_digest: manifest.managed_assets[asset.manifest_key].sha256 || null,
-    }));
   const mergedAssets = upgradeMergedAssets(
     target,
     sources,
     { ...manifest, code_repository: codeRepository },
   );
-  for (const asset of [...exactAssets, ...retiredAssets, ...mergedAssets]) {
+  for (const asset of [...exactAssets, ...mergedAssets]) {
     validateManagedPath(target, installPath(target, asset.path));
   }
   const additions = [];
@@ -1552,32 +1473,12 @@ function planUpgrade(packageRoot, target, options) {
       replacements.push({ path: asset.path, kind: "merged-file", forced: false });
     }
   }
-  for (const asset of retiredAssets) {
-    const destination = installPath(target, asset.path);
-    asset.destination = destination;
-    const currentDigest = pathDigest(destination);
-    asset.current_digest = currentDigest;
-    if (currentDigest === null) {
-      preserved.push({ path: asset.path, reason: "retired managed asset is already absent" });
-    } else if (asset.previous_digest && currentDigest === asset.previous_digest) {
-      removals.push({ path: asset.path, kind: asset.kind, forced: false });
-    } else {
-      conflicts.push({
-        path: asset.path,
-        reason: asset.previous_digest
-          ? "retired managed asset differs from the installed manifest digest"
-          : "installed manifest does not prove ownership of the retired managed asset",
-      });
-      if (force) removals.push({ path: asset.path, kind: asset.kind, forced: true });
-    }
-  }
   const preservedWorkflow = preservedWorkflowFiles(
     target,
     [
       ...exactAssets
         .filter((asset) => asset.kind !== "ensure-directory")
         .map((asset) => asset.path),
-      ...retiredAssets.map((asset) => asset.path),
       ...mergedAssets.map((asset) => asset.path),
     ],
   );
@@ -1599,7 +1500,6 @@ function planUpgrade(packageRoot, target, options) {
     codeRepository,
     sources,
     exactAssets,
-    retiredAssets,
     mergedAssets,
     additions,
     replacements,
@@ -1609,8 +1509,6 @@ function planUpgrade(packageRoot, target, options) {
     conflicts,
     backups,
     comparison,
-    contractRetirement,
-    prototypeMigration,
   };
 }
 
@@ -1704,17 +1602,6 @@ function applyUpgradePlan(target, plan, packageVersion) {
         apply: () => atomicWrite(asset.destination, asset.desired),
       });
     }
-    for (const asset of plan.retiredAssets) {
-      if (!changes.has(asset.path)) continue;
-      applyReceiptBackedAsset({
-        target,
-        upgradeRoot,
-        asset,
-        operation: "remove",
-        receiptAssets,
-        apply: () => fs.rmSync(asset.destination, { recursive: true, force: true }),
-      });
-    }
     const manifestRelative = INSTALL_MANIFEST.replaceAll("\\", "/");
     const manifestBackup = backupUpgradePath(target, upgradeRoot, manifestRelative);
     const nextManifest = buildInstallManifest(
@@ -1742,30 +1629,10 @@ function applyUpgradePlan(target, plan, packageVersion) {
       to_version: packageVersion,
       applied_at: new Date().toISOString(),
       formal_event_tree_fingerprint: formalEventFingerprint,
-      contract_retirement: {
-        gate_id: plan.contractRetirement.gate_id,
-        contract_version: UI_CONTRACT_VERSION,
-        affected_iterations: plan.contractRetirement.affected_iterations,
-        expected_scope_revisions: plan.contractRetirement.expected_scope_revisions,
-      },
       assets: receiptAssets,
     };
     atomicWrite(path.join(upgradeRoot, "receipt.json"), `${JSON.stringify(receipt, null, 2)}\n`);
-    const retirementArgs = [
-      "contract", "retire", "--project", target,
-      "--gate-id", "UX-LF",
-      "--actor", "system:package-upgrade",
-      "--reason", "prototype-first UI contract",
-      "--contract-version", UI_CONTRACT_VERSION,
-    ];
-    const expectedRevisions = Object.values(plan.contractRetirement.expected_scope_revisions);
-    if (expectedRevisions.length === 1) {
-      retirementArgs.push("--expected-scope-revision", String(expectedRevisions[0]));
-    }
-    const contractRetirement = executeDeliveryStateCommand(retirementArgs, {
-      yaml: FORMAL_STATE_YAML,
-    });
-    return { upgradeId, contractRetirement };
+    return { upgradeId };
   } catch (error) {
     restoreUpgradeAssets(target, upgradeRoot, receiptAssets);
     fs.rmSync(upgradeRoot, { recursive: true, force: true });
@@ -1796,7 +1663,6 @@ function rollbackUpgrade(packageRoot, target, upgradeId) {
   const sources = installationSources(packageRoot);
   const allowedPaths = new Set([
     ...managedAssetInventory(sources).map((asset) => asset.path),
-    ...RETIRED_MANAGED_ASSETS.map((asset) => asset.path),
     ...MERGED_MANAGED_SURFACES.map((surface) => surface.path),
     INSTALL_MANIFEST.replaceAll("\\", "/"),
   ]);
@@ -1866,26 +1732,10 @@ export function upgradeProject(packageRoot, target, options = {}) {
       conflicts: plan.conflicts,
       backups: plan.backups,
     },
-    compatibility: {
-      installation_manifest: "compatible",
-      package_version: plan.comparison > 0 ? "upgrade" : plan.comparison === 0 ? "same-version repair" : "forced downgrade",
-    },
     code_repository: {
       path: plan.codeRepository.path,
       write_planned: false,
     },
-    contract_retirement: {
-      ...plan.contractRetirement,
-      contract_version: UI_CONTRACT_VERSION,
-      write_planned: plan.contractRetirement.affected_iterations.length > 0,
-    },
-    prototype_migration: {
-      ...plan.prototypeMigration,
-      required_follow_up: {
-        command: "ai-delivery migrate",
-        write_planned: false,
-      },
-    },
   };
   if (dryRun) return report;
   const blockingConflicts = plan.conflicts.filter((item) => !force || item.forceable === false);
@@ -1897,12 +1747,6 @@ export function upgradeProject(packageRoot, target, options = {}) {
   }
   const applied = applyUpgradePlan(target, plan, packageVersion);
   report.upgrade_id = applied.upgradeId;
-  report.contract_retirement = {
-    ...report.contract_retirement,
-    ...applied.contractRetirement,
-    contract_version: UI_CONTRACT_VERSION,
-    write_planned: false,
-  };
   report.applied = true;
   return report;
 }
@@ -2496,8 +2340,8 @@ export function doctorProject(target, options = {}) {
     });
   }
   checks.push({
-    ok: !fs.existsSync(path.join(target, ".ai-delivery")) && !fs.existsSync(path.join(target, LEGACY_ACTIVE_TASK)),
-    message: "legacy .ai-delivery paths are absent",
+    ok: !fs.existsSync(path.join(target, ".ai-delivery")) && !fs.existsSync(path.join(target, ".ai-delivery-task")),
+    message: "unsupported workflow paths are absent",
   });
   checks.push({ ok: fs.existsSync(path.join(target, "AGENTS.md")), message: "project AGENTS.md is present" });
   return { checks, ok: checks.filter((check) => check.required !== false).every((check) => check.ok) };