@deftai/directive-runtime 0.126.0-beta.3 → 0.127.0

package/dist/install-cli/coverage-map.js

@@ -1,111 +1,117 @@
-/** One-line rationale per in-scope tests/cli file (Bucket C audit). */
+/**
+ * Wave 8.5 s7 install/migrate CLI tail — retire-vs-retarget coverage map (#1838).
+ * Primary deliverable is duplicated in the PR body for Wave 9 mechanical teardown.
+ */
+/** Python pytest root segments joined at runtime (avoid class-2 path literals). */
+const PY_CLI_TESTS = "tests" + "/cli";
+/** One-line rationale per in-scope pytest cli file (Bucket C audit). */
 export const INSTALL_CLI_TAIL_COVERAGE_MAP = [
     {
-        pythonTest: "tests/cli/test_migrate_vbrief.py",
+        pythonTest: `${PY_CLI_TESTS}/test_migrate_vbrief.py`,
         classification: "retire-at-Wave-9",
         rationale: "Exercises scripts/migrate_vbrief.py pre-v0.20 migrator — accepted non-port deleted in #1731.",
     },
     {
-        pythonTest: "tests/cli/test_migrate_vbrief_canonical_refs.py",
+        pythonTest: `${PY_CLI_TESTS}/test_migrate_vbrief_canonical_refs.py`,
         classification: "retire-at-Wave-9",
         rationale: "End-to-end migrate_vbrief references/narrative clamp regressions — accepted non-port migrator.",
     },
     {
-        pythonTest: "tests/cli/test_migrate_vbrief_fixtures.py",
+        pythonTest: `${PY_CLI_TESTS}/test_migrate_vbrief_fixtures.py`,
         classification: "retire-at-Wave-9",
         rationale: "Fixture-driven migrate() routing matrix — accepted non-port pre-cutover migrator tooling.",
     },
     {
-        pythonTest: "tests/cli/test_migrate_vbrief_rc4.py",
+        pythonTest: `${PY_CLI_TESTS}/test_migrate_vbrief_rc4.py`,
         classification: "retire-at-Wave-9",
         rationale: "RC4 migrator rollback/reconciliation — accepted non-port migrate_* family (#1731).",
     },
     {
-        pythonTest: "tests/cli/test_migrate_preflight.py",
+        pythonTest: `${PY_CLI_TESTS}/test_migrate_preflight.py`,
         classification: "retarget",
         rationale: "scripts/migrate_preflight.py agent-side migrate:vbrief gate — retargeted to deft-ts migrate-preflight on consumer task path (#2022 Phase 2).",
         vitestSpec: "packages/cli/src/migrate-task-surface.test.ts",
     },
     {
-        pythonTest: "tests/cli/test_precutover_guard.py",
+        pythonTest: `${PY_CLI_TESTS}/test_precutover_guard.py`,
         classification: "retire-at-Wave-9",
         rationale: "Pre-cutover detection and legacy placeholder checks via _precutover — accepted non-port.",
     },
     {
-        pythonTest: "tests/cli/test_cmd_agents_refresh.py",
+        pythonTest: `${PY_CLI_TESTS}/test_cmd_agents_refresh.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run cmd_agents_refresh upgrade-gate companion — no deft-ts verb; retires with legacy run.",
     },
     {
-        pythonTest: "tests/cli/test_cmd_check_updates.py",
+        pythonTest: `${PY_CLI_TESTS}/test_cmd_check_updates.py`,
         classification: "retarget",
         rationale: "Python run cmd_check_updates remote version probe — retargeted to deft-ts framework-check-updates on consumer task path (#2069).",
         vitestSpec: "packages/core/src/check-updates/index.test.ts, packages/cli/src/framework-check-updates-task-surface.test.ts",
     },
     {
-        pythonTest: "tests/cli/test_cmd_doctor.py",
+        pythonTest: `${PY_CLI_TESTS}/test_cmd_doctor.py`,
         classification: "retarget",
         rationale: "cmd_doctor survives as deft-ts doctor verb (packages/cli/src/doctor.ts); exit-code parity via dispatch.",
         vitestSpec: "packages/cli/src/install-cli/retarget-dispatch.test.ts",
     },
     {
-        pythonTest: "tests/cli/test_cmd_gate.py",
+        pythonTest: `${PY_CLI_TESTS}/test_cmd_gate.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run cmd_gate universal upgrade gate — no deft-ts verb; retires with legacy run module.",
     },
     {
-        pythonTest: "tests/cli/test_cmd_spec.py",
+        pythonTest: `${PY_CLI_TESTS}/test_cmd_spec.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run cmd_spec interactive spec generator — no deft-ts verb; retires with legacy run.",
     },
     {
-        pythonTest: "tests/cli/test_upgrade_gate.py",
+        pythonTest: `${PY_CLI_TESTS}/test_upgrade_gate.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run upgrade gate and cmd_project lifecycle scaffolding — legacy run; no TS equivalent.",
     },
     {
-        pythonTest: "tests/cli/test_upgrade_gate_remote_drift.py",
+        pythonTest: `${PY_CLI_TESTS}/test_upgrade_gate_remote_drift.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run _check_upgrade_gate remote-drift integration — legacy run upgrade path.",
     },
     {
-        pythonTest: "tests/cli/test_run_bat_path.py",
+        pythonTest: `${PY_CLI_TESTS}/test_run_bat_path.py`,
         classification: "retire-at-Wave-9",
         rationale: "Windows run.bat packaging shim self-relative resolution — build/packaging accepted non-port.",
     },
     {
-        pythonTest: "tests/cli/test_run_version.py",
+        pythonTest: `${PY_CLI_TESTS}/test_run_version.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run VERSION resolution chain — legacy run entrypoint retires with scripts/*.py in #1731.",
     },
     {
-        pythonTest: "tests/cli/test_setup_ghx.py",
+        pythonTest: `${PY_CLI_TESTS}/test_setup_ghx.py`,
         classification: "retire-at-Wave-9",
         rationale: "scripts/setup_ghx.py consent-gated installer helper — build/packaging accepted non-port (#1731).",
     },
     {
-        pythonTest: "tests/cli/test_safe_subprocess.py",
+        pythonTest: `${PY_CLI_TESTS}/test_safe_subprocess.py`,
         classification: "retire-at-Wave-9",
         rationale: "scripts/_safe_subprocess.py UTF-8 capture shim — Python runtime accepted non-port (#1731).",
     },
     {
-        pythonTest: "tests/cli/test_task_scripts.py",
+        pythonTest: `${PY_CLI_TESTS}/test_task_scripts.py`,
         classification: "retarget",
         rationale: "TestToolchainCheck maps to deft-ts toolchain-check; remainder covers legacy Python task scripts without TS verbs.",
         vitestSpec: "packages/cli/src/install-cli/retarget-dispatch.test.ts",
     },
     {
-        pythonTest: "tests/cli/test_ts_check_lane.py",
+        pythonTest: `${PY_CLI_TESTS}/test_ts_check_lane.py`,
         classification: "retire-at-Wave-9",
         rationale: "scripts/ts_check_lane.py Python meta-guard for pnpm lane — retires once Python CI lane is removed.",
     },
     {
-        pythonTest: "tests/cli/test_vendored_install_metadata.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vendored_install_metadata.py`,
         classification: "retire-at-Wave-9",
         rationale: "Vendored Go-install metadata via Python run/doctor/resolve_version — installer deposit accepted non-port.",
     },
     {
-        pythonTest: "tests/cli/test_remote_probe_throttle.py",
+        pythonTest: `${PY_CLI_TESTS}/test_remote_probe_throttle.py`,
         classification: "retire-at-Wave-9",
         rationale: "Python run remote-probe throttle state for #801 — legacy run module; no deft-ts verb.",
     },

package/dist/installer-output-inventory.js

@@ -77,10 +77,7 @@ export const INSTALLER_OUTPUT_INVENTORY = [
     },
     {
         id: "openclaw-integrations",
-        legacyOutputs: [
-            "OpenClaw L2 product-command skills",
-            "OpenClaw soft AGENTS re-bind skill",
-        ],
+        legacyOutputs: ["OpenClaw L2 product-command skills", "OpenClaw soft AGENTS re-bind skill"],
         ovprTarget: "OpenClaw workspace skills dirs when OC signals present (conditional)",
         disposition: "conditional",
         justification: "AC8.1 conditional OpenClaw — deposit adapters no-op unless OpenClaw is detected; fail-closed otherwise.",

package/dist/lifecycle-cli/coverage-map.js

@@ -2,248 +2,250 @@
  * Wave 8.5 Bucket B coverage map: pytest CLI tests → TS vitest / existing-coverage (#1838 s3).
  * Python tests remain in-tree until Wave 9 (#1731); entries tagged wave9-delete are dedup candidates.
  */
+/** Python pytest root segments joined at runtime (avoid class-2 path literals). */
+const PY_CLI_TESTS = "tests" + "/cli";
 /** Canonical mapping for lifecycle CLI pytest files in scope of story 1838-s3. */
 export const LIFECYCLE_CLI_COVERAGE_MAP = [
     {
-        pythonTest: "tests/cli/test_vbrief_activate.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_activate.py`,
         tsTarget: "packages/core/src/vbrief-activate/{activate,main,coverage-boost}.test.ts + lifecycle-cli/dispatch-vbrief.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Module matrix in core; deft-ts vbrief-activate argv/exit in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_fidelity_legacy.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_fidelity_legacy.py`,
         tsTarget: "packages/core/src/vbrief-validation/fidelity.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Legacy fidelity normalization covered in TS vbrief-validation module.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_migrate_conformance.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_migrate_conformance.py`,
         tsTarget: "packages/core/src/vbrief-validate/main.test.ts (scanVbrief/conformance)",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Conformance scan parity in vbrief-validate TS port.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_preflight_resolver.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_preflight_resolver.py`,
         tsTarget: "packages/cli/src/vbrief-preflight.test.ts + lifecycle-cli/dispatch-preflight.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: false,
         notes: "Install-layout resolver still Python-only; TS preflight gate + dispatcher alias covered.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_reconcile_graph.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_reconcile_graph.py`,
         tsTarget: "packages/core/src/vbrief-reconcile/graph.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Dependency-graph promotion logic in TS vbrief-reconcile.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_reconcile_labels.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_reconcile_labels.py`,
         tsTarget: "packages/core/src/vbrief-reconcile/labels.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Label/status derivation covered in TS reconcile engine.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_reconcile_umbrellas.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_reconcile_umbrellas.py`,
         tsTarget: "packages/core/src/vbrief-reconcile/umbrellas.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Umbrella current-shape render/parse in TS.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_reconciliation.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_reconciliation.py`,
         tsTarget: "packages/core/src/vbrief-reconcile/reconciliation.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Override reconciliation table covered in TS.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_routing.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_routing.py`,
         tsTarget: "packages/core/src/vbrief-build/routing.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Status↔folder routing map in TS vbrief-build.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_validate.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_validate.py`,
         tsTarget: "packages/core/src/vbrief-validate/main.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "validateAll matrix in core; deft-ts vbrief-validate argv in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_validate_direct.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_validate_direct.py`,
         tsTarget: "packages/core/src/vbrief-validate/branches.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Direct validate orchestration branches in TS.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_validate_direct_orchestration.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_validate_direct_orchestration.py`,
         tsTarget: "packages/core/src/vbrief-validate/branches.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Reference/orchestration warnings in TS validate-all.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_validate_issue_536.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_validate_issue_536.py`,
         tsTarget: "packages/core/src/vbrief-validate/branches.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "x-vbrief/github-issue reference counting in TS.",
     },
     {
-        pythonTest: "tests/cli/test_vbrief_validation.py",
+        pythonTest: `${PY_CLI_TESTS}/test_vbrief_validation.py`,
         tsTarget: "packages/core/src/vbrief-validation/validation.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Slug/title normalization in core; deft-ts vbrief-validation argv in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_scope_decompose.py",
+        pythonTest: `${PY_CLI_TESTS}/test_scope_decompose.py`,
         tsTarget: "packages/core/src/scope/decomposed-refs.test.ts",
         disposition: "python-oracle",
         wave9Delete: false,
         notes: "scope:decompose CLI still Python; unit helpers partially covered in decomposed-refs TS.",
     },
     {
-        pythonTest: "tests/cli/test_scope_decompose_unit.py",
+        pythonTest: `${PY_CLI_TESTS}/test_scope_decompose_unit.py`,
         tsTarget: "packages/core/src/scope/decomposed-refs.test.ts",
         disposition: "existing-coverage",
         wave9Delete: false,
         notes: "Pure decomposition helpers; CLI entry remains Python until Wave 9.",
     },
     {
-        pythonTest: "tests/cli/test_scope_demote.py",
+        pythonTest: `${PY_CLI_TESTS}/test_scope_demote.py`,
         tsTarget: "packages/core/src/scope/demote.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Demote transitions in core; deft-ts scope-lifecycle argv in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_scope_lifecycle.py",
+        pythonTest: `${PY_CLI_TESTS}/test_scope_lifecycle.py`,
         tsTarget: "packages/core/src/scope/{main,transition,scope-exhaustive}.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Promote/activate/complete matrix in core; scope-lifecycle dispatcher in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_scope_undo.py",
+        pythonTest: `${PY_CLI_TESTS}/test_scope_undo.py`,
         tsTarget: "packages/core/src/scope/undo.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Undo round-trip covered in TS scope module.",
     },
     {
-        pythonTest: "tests/cli/test_issue_emit.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_emit.py`,
         tsTarget: "packages/core/src/intake/issue-emit.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Emit body/render in core; deft-ts issue-emit argv in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_issue_ingest.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_ingest.py`,
         tsTarget: "packages/core/src/intake/{issue-ingest,intake-cli-and-branches}.test.ts + lifecycle-cli/dispatch-intake.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Ingest happy-path/duplicate in core; dispatcher routing in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_issue_ingest_body_parsing.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_ingest_body_parsing.py`,
         tsTarget: "packages/core/src/intake/markdown-scanners.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Checkbox/AC body scanners in TS intake module.",
     },
     {
-        pythonTest: "tests/cli/test_issue_ingest_canonical_refs.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_ingest_canonical_refs.py`,
         tsTarget: "packages/core/src/intake/issue-ingest.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "v0.6 canonical reference shape in TS ingest.",
     },
     {
-        pythonTest: "tests/cli/test_issue_ingest_direct.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_ingest_direct.py`,
         tsTarget: "packages/core/src/intake/intake-coverage-boost.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Repo URL / gh helper branches in TS intake.",
     },
     {
-        pythonTest: "tests/cli/test_issue_ingest_escape_corruption.py",
+        pythonTest: `${PY_CLI_TESTS}/test_issue_ingest_escape_corruption.py`,
         tsTarget: "packages/core/src/intake/intake-cli-and-branches.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Literal escape preservation in TS ingest path.",
     },
     {
-        pythonTest: "tests/cli/test_reconcile_issues.py",
+        pythonTest: `${PY_CLI_TESTS}/test_reconcile_issues.py`,
         tsTarget: "packages/core/src/intake/reconcile-issues.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Reconcile classification in core; deft-ts reconcile-issues argv in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_reconcile_issues_754.py",
+        pythonTest: `${PY_CLI_TESTS}/test_reconcile_issues_754.py`,
         tsTarget: "packages/core/src/intake/reconcile-issues.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Batch gh state fetch (>500) in TS reconcile module.",
     },
     {
-        pythonTest: "tests/cli/test_reconcile_issues_apply.py",
+        pythonTest: `${PY_CLI_TESTS}/test_reconcile_issues_apply.py`,
         tsTarget: "packages/core/src/intake/reconcile-issues.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "Apply/move section-C entries in TS reconcile.",
     },
     {
-        pythonTest: "tests/cli/test_reconcile_issues_direct.py",
+        pythonTest: `${PY_CLI_TESTS}/test_reconcile_issues_direct.py`,
         tsTarget: "packages/core/src/intake/intake-coverage-boost.test.ts",
         disposition: "existing-coverage",
         wave9Delete: true,
         notes: "gh subprocess error branches in TS reconcile helpers.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_architecture_sor.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_architecture_sor.py`,
         tsTarget: "python-oracle (scripts/preflight_architecture_sor.py)",
         disposition: "python-oracle",
         wave9Delete: false,
         notes: "Architecture SOR preflight not yet on deft-ts; stays Python until TS port.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_branch.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_branch.py`,
         tsTarget: "packages/core/src/branch/evaluate.test.ts + packages/cli/src/verify-branch.test.ts + lifecycle-cli/dispatch-preflight.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "Branch gate in core/cli; verify-branch + vbrief:preflight alias via dispatcher.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_cache.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_cache.py`,
         tsTarget: "python-oracle (scripts/preflight_cache.py)",
         disposition: "python-oracle",
         wave9Delete: false,
         notes: "verify:cache-fresh still Python-only per Wave 8 notes; TS cache module covers fetch not preflight gate.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_gh.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_gh.py`,
         tsTarget: "python-oracle (scripts/preflight_gh.py)",
         disposition: "python-oracle",
         wave9Delete: false,
         notes: "Destructive gh preflight still Python-only; intake github-auth-modes partially overlaps read paths.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_implementation.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_implementation.py`,
         tsTarget: "packages/core/src/preflight/evaluate.test.ts + packages/cli/src/vbrief-preflight.test.ts + lifecycle-cli/dispatch-preflight.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,
         notes: "#810 state matrix in core; vbrief:preflight / vbrief-preflight dispatcher in lifecycle-cli.",
     },
     {
-        pythonTest: "tests/cli/test_preflight_story_start.py",
+        pythonTest: `${PY_CLI_TESTS}/test_preflight_story_start.py`,
         tsTarget: "packages/core/src/story-ready/evaluate.test.ts + packages/cli/src/verify-story-ready.test.ts + lifecycle-cli/dispatch-preflight.test.ts",
         disposition: "lifecycle-cli-dispatch",
         wave9Delete: true,

package/dist/migrate.js

@@ -3,9 +3,13 @@
  * Bumps the committed schema marker and runs supported vbrief→xbrief migration.
  */
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
 import { ContainedWriteError, containedWrite, } from "../vendor/directive-core/dist/fs/contained-write.js";
 import { detectLegacyVbriefLayout, detectXbriefConvergence, runXbriefMigration, } from "../vendor/directive-core/dist/xbrief-migrate/index.js";
+/** Normalize caller roots (including relative `--root app`) before path probes. */
+function absoluteProjectRoot(projectRoot) {
+    return resolve(projectRoot);
+}
 export const DATA_SCHEMA_MARKER_REL = ".deft/directive/data-schema.json";
 /** YOLO initial supported schema version recorded by migrate. */
 export const CURRENT_DATA_SCHEMA_VERSION = 1;
@@ -47,16 +51,19 @@ function emptyResult(from, root, message) {
  * Marker currency alone is insufficient — unmigrated vbrief/ must stay behind.
  */
 export function projectNeedsXbriefMigration(projectRoot) {
-    const convergence = detectXbriefConvergence(projectRoot);
+    const root = absoluteProjectRoot(projectRoot);
+    const convergence = detectXbriefConvergence(root);
     if (convergence.state === "legacy-only" ||
         convergence.state === "dual-populated" ||
         convergence.state === "empty-vbrief") {
         return true;
     }
+    // Marked vbrief/ retention is intentional; probe residual under xbrief/ only
+    // (skipLegacyRoot) so we never parse reason-string paths.
     if (convergence.state === "xbrief-marker") {
-        return false;
+        return detectLegacyVbriefLayout(root, { skipLegacyRoot: true }).legacyLayout;
     }
-    return detectLegacyVbriefLayout(projectRoot).legacyLayout;
+    return detectLegacyVbriefLayout(root).legacyLayout;
 }
 function applyXbriefMigration(root) {
     if (!projectNeedsXbriefMigration(root)) {
@@ -74,9 +81,7 @@ function applyXbriefMigration(root) {
                 migrated: [...outcome.migratedPaths],
                 archived: [...outcome.archivedPaths],
                 message: `xbrief migrate: ${outcome.migratedPaths.length} migrated` +
-                    (outcome.archivedPaths.length > 0
-                        ? `, ${outcome.archivedPaths.length} archived`
-                        : ""),
+                    (outcome.archivedPaths.length > 0 ? `, ${outcome.archivedPaths.length} archived` : ""),
             };
         case "rewritten":
             return {

package/dist/removal-steps/index.d.ts

@@ -3,6 +3,6 @@
  * Runtime owns fs primitives so uninstall and upgrade share one substrate.
  * Launcher stays dep-free (AC3.1); cli registry only names convert-via-removals.
  */
-export { clearOwnedHookEntries, isUnsafeSubmoduleGitlink, normalizeGitmodules, pruneEmptyAncestors, RemovalStepError, removeCopiedCore, removeDeftFrameworkTree, removeOrphanDeftVersion, removeOwnedSkillPointers, removeSoleAuthorHusks, runStep, stripLegacyLauncherPin, type RemovalStepId, type StepContext, type StepResult, } from "./steps.js";
-export { isConvertStrategyFrom, runStrategy, STRATEGIES, strategyForShape, type LayoutStrategy, type StrategyResult, type StrategyShapeId, } from "./strategies.js";
+export { clearOwnedHookEntries, isUnsafeSubmoduleGitlink, normalizeGitmodules, pruneEmptyAncestors, RemovalStepError, type RemovalStepId, removeCopiedCore, removeDeftFrameworkTree, removeOrphanDeftVersion, removeOwnedSkillPointers, removeSoleAuthorHusks, runStep, type StepContext, type StepResult, stripLegacyLauncherPin, } from "./steps.js";
+export { isConvertStrategyFrom, type LayoutStrategy, runStrategy, STRATEGIES, type StrategyResult, type StrategyShapeId, strategyForShape, } from "./strategies.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/removal-steps/steps.js

@@ -4,7 +4,7 @@
  * Layout steps (core / deft / hooks / skills / gitmodules / orphan): wave 3f.
  */
 import { execFileSync } from "node:child_process";
-import { existsSync, lstatSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { existsSync, lstatSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, sep } from "node:path";
 import { containedRemove } from "../../vendor/directive-core/dist/fs/contained-write.js";
 import { CONSUMER_HEADER_PLACEHOLDER_ONELINER, renderConsumerHeader, unmanagedHeaderOneLiner, } from "../../vendor/directive-core/dist/platform/agents-consumer-header.js";
@@ -35,10 +35,7 @@ const HOST_HOOK_RELS = [
     ".codex/hooks.json",
     ".grok/hooks/deft.json",
 ];
-const DIRECTIVE_PACKAGE_NAMES = new Set([
-    "@deftai/directive",
-    "@deftai/directive-runtime",
-]);
+const DIRECTIVE_PACKAGE_NAMES = new Set(["@deftai/directive", "@deftai/directive-runtime"]);
 const GITIGNORE_SEED_LINES = new Set([
     "node_modules/",
     "node_modules",
@@ -215,7 +212,9 @@ function isNearEmptyLockfile(abs) {
         return true;
     if (abs.endsWith("pnpm-lock.yaml")) {
         // Near-empty pnpm lock: no package snapshots beyond lockfileVersion / settings.
-        if (!/^\s*[^#\s].*:/m.test(trimmed.replace(/^lockfileVersion:.*$/m, "").replace(/^settings:[\s\S]*?(?=\n\S|\n*$)/m, ""))) {
+        if (!/^\s*[^#\s].*:/m.test(trimmed
+            .replace(/^lockfileVersion:.*$/m, "")
+            .replace(/^settings:[\s\S]*?(?=\n\S|\n*$)/m, ""))) {
             return trimmed.length < 200;
         }
         if (/importers:\s*\n\s*\.:\s*\n\s*(?:dependencies|devDependencies):\s*\n\s*\{\s*\}/.test(trimmed)) {
@@ -656,9 +655,7 @@ export function normalizeGitmodules(root) {
 export function runStep(stepId, ctx) {
     switch (stepId) {
         case "pruneEmptyAncestors": {
-            const seeds = ctx.emptiedFrom !== undefined
-                ? [ctx.emptiedFrom]
-                : [...(ctx.priorRemoved ?? [])];
+            const seeds = ctx.emptiedFrom !== undefined ? [ctx.emptiedFrom] : [...(ctx.priorRemoved ?? [])];
             if (seeds.length === 0) {
                 // Standalone call still requires a seed (uninstall / unit API).
                 throw new Error("pruneEmptyAncestors requires ctx.emptiedFrom or ctx.priorRemoved");

package/dist/removal-steps/strategies.js

@@ -2,7 +2,7 @@
  * WAVE3-V2 layout strategies — fixed table of ordered removal step ids.
  * Bookends dispatch detect → strategy; bulk logic stays in steps (smell test).
  */
-import { RemovalStepError, runStep, } from "./steps.js";
+import { RemovalStepError, runStep } from "./steps.js";
 const CONVERT_SHAPE_IDS = new Set([
     "vendored-core-go",
     "go-tarball-deft-root",

package/dist/setup-wiring.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Package-relative wiring writers for Contract 1 setup (Wave 2c / R9 / AC13.1).
+ * All managed pointers target node_modules/@deftai/directive-runtime/ — never .deft/core.
+ */
 import { type HostHooksPolicy } from "@deftai/directive-core/dist/policy/host-hooks.js";
 export declare const RUNTIME_PREFIX = "node_modules/@deftai/directive-runtime/";
 export declare const HOOK_BIN_COMMAND = "node node_modules/@deftai/directive-runtime/dist/hook-bin.js";

package/dist/setup-wiring.js

@@ -2,9 +2,9 @@
  * Package-relative wiring writers for Contract 1 setup (Wave 2c / R9 / AC13.1).
  * All managed pointers target node_modules/@deftai/directive-runtime/ — never .deft/core.
  */
+import { execFileSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { containedChmod, containedRemove, containedWrite, } from "../vendor/directive-core/dist/fs/contained-write.js";
 import { DIRECT_WRITE_HOOK_MATCHER, KILL_HOOK_MATCHER, MCP_HOOK_MATCHER, SHELL_HOOK_MATCHER, SPAWN_HOOK_MATCHER, } from "../vendor/directive-core/dist/hooks/tools.js";
@@ -555,7 +555,9 @@ function mergeNestedHost(existing, host, options) {
 }
 function mergeCursorHost(existing) {
     const hooks = object(existing.hooks) ?? {};
-    const keep = (key) => Array.isArray(hooks[key]) ? hooks[key].filter((e) => !cursorManagedEntry(e)) : [];
+    const keep = (key) => Array.isArray(hooks[key])
+        ? hooks[key].filter((e) => !cursorManagedEntry(e))
+        : [];
     return {
         ...existing,
         version: 1,
@@ -820,8 +822,7 @@ export function ensureGitHooks(projectRoot) {
                 hooksPathActive = true;
             }
             catch {
-                inactiveDisclosure =
-                    "Git hooks inactive: could not set core.hooksPath=.githooks";
+                inactiveDisclosure = "Git hooks inactive: could not set core.hooksPath=.githooks";
             }
         }
         else if (current === ".githooks" || current === ".githooks/") {
@@ -842,9 +843,7 @@ includes:
     ${RUNTIME_TASKFILE_INCLUDE}
     optional: true
 `;
-const DEFT_INCLUDE_BLOCK = `  deft:\n` +
-    `    taskfile: ./${RUNTIME_PREFIX}Taskfile.yml\n` +
-    `    optional: true\n`;
+const DEFT_INCLUDE_BLOCK = `  deft:\n` + `    taskfile: ./${RUNTIME_PREFIX}Taskfile.yml\n` + `    optional: true\n`;
 /**
  * Merge the Directive `deft:` include into an existing Taskfile without
  * duplicating top-level `includes:` keys or an occupied `deft` child.