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

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/session-start.js

@@ -2,7 +2,7 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { CEREMONY_DEPTHS, normalizeCeremonyModelTier, normalizeCeremonyProjectShape, normalizeCeremonyTaskSize, selectCeremonyDepth, } from "../vendor/directive-core/dist/policy/index.js";
-import { COLD_CEREMONY_TIER, PRIMARY_CLAIM_EXCEPTIONS, parseDeferrals, parseSessionPostureToken, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, REQUIREMENTS_POSTURE, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "../vendor/directive-core/dist/session/index.js";
+import { COLD_CEREMONY_TIER, PRIMARY_CLAIM_EXCEPTIONS, parseDeferrals, parseSessionPostureToken, publishApplyingHostFromCanonicalSessionId, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, REQUIREMENTS_POSTURE, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "../vendor/directive-core/dist/session/index.js";
 function parseCeremonyDepth(raw) {
     const value = raw.trim().toLowerCase();
     if (CEREMONY_DEPTHS.includes(value)) {
@@ -523,6 +523,33 @@ export function run(argv) {
     if (stray) {
         lines.push(stray);
     }
+    // #5676: read-only may bootstrap the applying-host record; mutation/rearm
+    // republishes as reinforcement after a successful ceremony. Skip opt-out /
+    // kill-switch disabled results so .no-deft-directive stays write-free.
+    const disabled = typeof result.payload === "object" &&
+        result.payload !== null &&
+        result.payload.disabled === true;
+    if (result.code === 0 && !disabled) {
+        const owner = args.sessionId?.trim() ||
+            (typeof result.payload.occupancy === "object" &&
+                result.payload.occupancy !== null &&
+                typeof result.payload.occupancy.session_id === "string"
+                ? String(result.payload.occupancy.session_id)
+                : "") ||
+            process.env.DEFT_SESSION_ID?.trim() ||
+            "";
+        if (owner.length > 0) {
+            try {
+                const transport = process.env.GROK_HOOK_EVENT?.trim() ? "grok-hook-event" : "native";
+                publishApplyingHostFromCanonicalSessionId(projectRoot, owner, {
+                    transport: owner.startsWith("host:cursor:") ? "native" : transport,
+                });
+            }
+            catch {
+                /* ceremony success stays authoritative; applying-host is best-effort */
+            }
+        }
+    }
     if (args.emitJson) {
         const sorted = Object.keys(result.payload)
             .sort()

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.

package/dist/setup.js

@@ -10,10 +10,10 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { ContainedWriteError, containedRemove, containedWrite, } from "../vendor/directive-core/dist/fs/contained-write.js";
 import { buildOwnershipRecord, fingerprintContent, ownershipRecordsEqual, readEvidenceGenerationNumber, readOwnershipRecord, writeOwnershipRecord, } from "../vendor/directive-core/dist/install-health/index.js";
-import { CURRENT_DATA_SCHEMA_VERSION, DATA_SCHEMA_MARKER_REL, } from "./migrate.js";
-import { isConvertStrategyFrom, runStrategy, } from "./removal-steps/index.js";
-import { ensureAgentsManagedSection, ensureGitHooks, ensureHostHooks, ensureOpenClawIntegrations, ensureSkillPointers, ensureSlashCommands, ensureTaskfileInclude, listSkillPointerPaths, listVerifiedManagedSlashCommandPaths, RUNTIME_PREFIX, } from "./setup-wiring.js";
 import { assertInventoryCompleteness } from "./installer-output-inventory.js";
+import { CURRENT_DATA_SCHEMA_VERSION, DATA_SCHEMA_MARKER_REL } from "./migrate.js";
+import { isConvertStrategyFrom, runStrategy } from "./removal-steps/index.js";
+import { ensureAgentsManagedSection, ensureGitHooks, ensureHostHooks, ensureOpenClawIntegrations, ensureSkillPointers, ensureSlashCommands, ensureTaskfileInclude, listSkillPointerPaths, listVerifiedManagedSlashCommandPaths, RUNTIME_PREFIX, } from "./setup-wiring.js";
 const SEED_PLACEHOLDER_REL = "xbrief/.directive-seed-placeholder";
 const GEN_REL = ".deft/GENERATION.json";
 const WIRING_READY_DIR_REL = ".deft/directive";
@@ -174,11 +174,7 @@ function buildOwnershipArtifacts(projectRoot) {
             });
         }
     }
-    for (const rel of [
-        ".githooks/pre-commit",
-        ".githooks/pre-push",
-        ".githooks/_directive-run.sh",
-    ]) {
+    for (const rel of [".githooks/pre-commit", ".githooks/pre-push", ".githooks/_directive-run.sh"]) {
         const body = readText(join(projectRoot, rel));
         if (body !== null) {
             artifacts.push({
@@ -311,16 +307,18 @@ export function runSetup(options) {
             conflicts.push(taskfile.conflictReason ?? "Taskfile.yml: include conflict");
         }
         // Seeds only on first-time install (AC8.4); repair/upgrade never create them.
-        // AC6.2: also leave data-schema current for empty/seeded install. Repair must
-        // not migrate; upgrade still migrates when data is truly behind.
+        // AC6.2: leave data-schema current for empty/seeded install. Repair may write a
+        // missing marker (not a migration); upgrade still migrates when data is behind.
         if (operation === "install" && conflicts.length === 0) {
             const seed = createSeedPlaceholder(root);
             if (seed !== null)
                 created.push(seed);
-            if (!existsSync(join(root, DATA_SCHEMA_MARKER_REL))) {
-                writeContained(root, DATA_SCHEMA_MARKER_REL, `${JSON.stringify({ schemaVersion: CURRENT_DATA_SCHEMA_VERSION }, null, 2)}\n`);
-                created.push(DATA_SCHEMA_MARKER_REL);
-            }
+        }
+        if ((operation === "install" || operation === "repair") &&
+            conflicts.length === 0 &&
+            !existsSync(join(root, DATA_SCHEMA_MARKER_REL))) {
+            writeContained(root, DATA_SCHEMA_MARKER_REL, `${JSON.stringify({ schemaVersion: CURRENT_DATA_SCHEMA_VERSION }, null, 2)}\n`);
+            created.push(DATA_SCHEMA_MARKER_REL);
         }
         // AC13.1: never materialize a content copy under .deft/core.
         const desired = buildOwnershipRecord({

package/dist/uninstall.js

@@ -9,7 +9,7 @@ import { join } from "node:path";
 import { containedRemove } from "../vendor/directive-core/dist/fs/contained-write.js";
 import { inspectOwnershipRecord, MANAGED_SECTION_CLOSE, MANAGED_SECTION_OPEN_PREFIX, } from "../vendor/directive-core/dist/install-health/index.js";
 import { pruneEmptyAncestors, removeSoleAuthorHusks } from "./removal-steps/steps.js";
-import { HOOK_BIN_COMMAND, RUNTIME_PREFIX, SKILL_POINTER_INVENTORY, } from "./setup-wiring.js";
+import { HOOK_BIN_COMMAND, RUNTIME_PREFIX, SKILL_POINTER_INVENTORY } from "./setup-wiring.js";
 const SKILL_HOST_ROOTS = [
     ".agents/skills",
     ".claude/skills",

package/dist/vbrief-preflight-fixtures.js

@@ -59,7 +59,7 @@ export function buildFixtures(root) {
 /** Render a human-readable parity report (exported for unit tests). */
 export function renderReport(result) {
     if (result.ok) {
-        return `vbrief_preflight parity: CLEAN -- Python and TS agree on ${result.cases.length} fixture(s).`;
+        return `vbrief_preflight parity: CLEAN -- Python and TS agree on ${result.cases.length} fixtures.`;
     }
     const lines = ["vbrief_preflight parity: DIVERGENCE"];
     for (const c of result.cases.filter((x) => !x.ok)) {

package/dist/verify-intent-constraint.d.ts

@@ -5,6 +5,8 @@ interface ParsedArgs {
     staged: boolean;
     quiet: boolean;
     planId?: string;
+    pr?: string;
+    repo?: string;
     error?: string;
 }
 /** Parse verify-intent-constraint CLI args. */

package/dist/verify-intent-constraint.js

@@ -46,6 +46,28 @@ export function parseArgs(argv) {
         else if (arg?.startsWith("--plan-id=")) {
             parsed.planId = arg.slice("--plan-id=".length);
         }
+        else if (arg === "--pr") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --pr: expected one argument" };
+            }
+            parsed.pr = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--pr=")) {
+            parsed.pr = arg.slice("--pr=".length);
+        }
+        else if (arg === "--repo") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --repo: expected one argument" };
+            }
+            parsed.repo = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--repo=")) {
+            parsed.repo = arg.slice("--repo=".length);
+        }
         else if (arg === "--base-ref") {
             return {
                 ...parsed,
@@ -71,6 +93,8 @@ export function run(argv) {
         staged: args.staged,
         quiet: args.quiet,
         planId: args.planId,
+        pr: args.pr,
+        repo: args.repo,
     });
     if (result.message.length > 0) {
         if (result.stream === "stdout")

package/dist/verify-observable-scope.d.ts

@@ -5,6 +5,8 @@ interface ParsedArgs {
     staged: boolean;
     quiet: boolean;
     planId?: string;
+    pr?: string;
+    repo?: string;
     error?: string;
 }
 /** Parse verify-observable-scope CLI args. */