@deftai/directive-core 0.71.1 → 0.73.0

package/dist/layout/index.js

@@ -1,2 +1,2 @@
-export { ARTIFACT_SUFFIXES, hasArtifactSuffix, isLifecycleArtifactPath, LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, LEGACY_INFO_ROOT_KEY, LIFECYCLE_DIR_NAMES, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, projectDefinitionFilename, projectDefinitionRelPath, resolveAuditDir, resolveAuditPath, resolveEvalDir, resolveEvalPath, resolveLifecycleFolder, resolveLifecycleLayout, resolveLifecycleRoot, resolveProjectDefinitionPath, resolveSpecArtifactPath, specArtifactRelPath, stripArtifactSuffix, } from "./resolve.js";
+export { ARTIFACT_SUFFIXES, hasArtifactSuffix, isLifecycleArtifactPath, LIFECYCLE_DIR_NAMES, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, projectDefinitionFilename, projectDefinitionRelPath, resolveAuditDir, resolveAuditPath, resolveEvalDir, resolveEvalPath, resolveLifecycleFolder, resolveLifecycleLayout, resolveLifecycleRoot, resolveProjectDefinitionPath, resolveSpecArtifactPath, specArtifactRelPath, stripArtifactSuffix, } from "./resolve.js";
 //# sourceMappingURL=index.js.map

package/dist/layout/resolve.d.ts

@@ -1,28 +1,39 @@
-import { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, LEGACY_INFO_ROOT_KEY, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY } from "../xbrief-migrate/constants.js";
-export { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, LEGACY_INFO_ROOT_KEY, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, };
+import { LEGACY_ARTIFACT_DIR, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY } from "../xbrief-migrate/constants.js";
+export { LEGACY_ARTIFACT_DIR, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, };
 /**
- * Lifecycle directory names recognized by the layout-aware resolver, in
- * preference order (migrated `xbrief` first, legacy `vbrief` second).
+ * Lifecycle directory names recognized by the layout-aware resolver and path
+ * validators. Includes both `xbrief` (canonical) and `vbrief` (legacy) so that
+ * path-validation helpers remain accurate during and after migration.
  */
 export declare const LIFECYCLE_DIR_NAMES: readonly ["xbrief", "vbrief"];
 /**
- * Artifact filename suffixes recognized by the layout-aware resolver, in
- * preference order (`.xbrief.json` first, `.vbrief.json` second).
+ * Artifact filename suffixes recognized by the layout-aware resolver and path
+ * validators. Includes both `.xbrief.json` (canonical) and `.vbrief.json`
+ * (legacy) so that path-validation helpers remain accurate during and after
+ * migration.
  */
 export declare const ARTIFACT_SUFFIXES: readonly [".xbrief.json", ".vbrief.json"];
-/** The on-disk lifecycle layout an engine call site should resolve against (#2109). */
+/** The on-disk lifecycle layout an engine call site should resolve against (#2109 / #2112). */
 export interface LifecycleLayout {
-    /** The lifecycle directory name -- `xbrief` when migrated, else `vbrief`. */
-    readonly artifactDir: typeof MIGRATED_ARTIFACT_DIR | typeof LEGACY_ARTIFACT_DIR;
-    /** The artifact filename suffix matching `artifactDir`. */
-    readonly artifactSuffix: typeof MIGRATED_ARTIFACT_SUFFIX | typeof LEGACY_ARTIFACT_SUFFIX;
-    /** The `*BRIEFInfo` root key matching `artifactDir`. */
-    readonly infoRootKey: typeof MIGRATED_INFO_ROOT_KEY | typeof LEGACY_INFO_ROOT_KEY;
-    /** Absolute path to the resolved lifecycle root (`<projectRoot>/<artifactDir>`). */
+    /** The lifecycle directory name -- always `xbrief` after the vbrief read path removal (#2112). */
+    readonly artifactDir: typeof MIGRATED_ARTIFACT_DIR;
+    /** The artifact filename suffix -- always `.xbrief.json` after #2112. */
+    readonly artifactSuffix: typeof MIGRATED_ARTIFACT_SUFFIX;
+    /** The `xBRIEFInfo` root key. */
+    readonly infoRootKey: typeof MIGRATED_INFO_ROOT_KEY;
+    /** Absolute path to the resolved lifecycle root (`<projectRoot>/xbrief`). */
     readonly root: string;
-    /** True when the resolved layout is the migrated `xbrief` layout. */
-    readonly migrated: boolean;
+    /** Always `true` -- the legacy vbrief read path was removed in #2112. */
+    readonly migrated: true;
 }
+/**
+ * Returns the layout root for non-layout-sensitive helpers (#2112).
+ *
+ * - If a valid `xbrief/` layout exists, returns its root.
+ * - If only `vbrief/` exists (legacy-only), throws so the caller surfaces the migrate hint.
+ * - If neither exists (empty/new project), falls back to `<projectRoot>/xbrief/` canonical path.
+ */
+export declare function resolveLayoutRootOrCanonical(projectRoot: string): string;
 /** True when `name` ends with any recognized artifact suffix (.xbrief.json or .vbrief.json). */
 export declare function hasArtifactSuffix(name: string): boolean;
 /**
@@ -31,24 +42,30 @@ export declare function hasArtifactSuffix(name: string): boolean;
  */
 export declare function stripArtifactSuffix(name: string): string;
 /**
- * True when a POSIX-style path is a lifecycle artifact under either layout
- * root (`xbrief/` or `vbrief/`) carrying either artifact suffix.
+ * True when a POSIX-style path is a lifecycle artifact path carrying a
+ * recognized lifecycle directory prefix (`xbrief/` or `vbrief/`) and a
+ * recognized artifact suffix. The `vbrief/` prefix and `.vbrief.json` suffix
+ * remain recognized for path-validation purposes during and after migration.
  */
 export declare function isLifecycleArtifactPath(posix: string): boolean;
 /**
- * Resolve the active lifecycle layout for `projectRoot` (#2109 part 1).
+ * Resolve the active lifecycle layout for `projectRoot` (#2109 part 1 / #2112).
+ *
+ * Requires the migrated `xbrief/` layout: the `xbrief/` directory must exist
+ * AND contain at least one `.xbrief.json` artifact. If no such layout is found,
+ * throws with a clear error directing the operator to run `deft migrate:xbrief`.
+ *
+ * The legacy `vbrief/` read-path fallback was removed in #2112 (0.73.0 MINOR).
+ * Projects that have not migrated must run `deft migrate:xbrief` first.
  *
- * Prefers the migrated `xbrief/` layout only when BOTH the `xbrief/` directory
- * exists AND it contains at least one `.xbrief.json` artifact; otherwise falls
- * back to the legacy `vbrief/` layout. With only `vbrief/` present (today's
- * repo) the result is the legacy layout, so existing behavior is unchanged.
+ * @throws {Error} When no `xbrief/` layout with `.xbrief.json` artifacts exists.
  */
 export declare function resolveLifecycleLayout(projectRoot: string): LifecycleLayout;
 /** Convenience accessor for the absolute resolved lifecycle root directory. */
 export declare function resolveLifecycleRoot(projectRoot: string): string;
 /**
- * Absolute path to a lifecycle folder under the resolved layout root
- * (e.g. `<root>/<xbrief|vbrief>/active`). Layout-aware (#2109 part 2a).
+ * Absolute path to a lifecycle folder under the resolved `xbrief/` layout root
+ * (e.g. `<root>/xbrief/active`). Layout-aware (#2109 part 2a / #2112).
  */
 export declare function resolveLifecycleFolder(projectRoot: string, folder: string): string;
 /** Absolute path to the layout-aware `.eval/` directory for version-eval results (#1703). */
@@ -68,20 +85,19 @@ export declare function projectDefinitionFilename(projectRoot: string): string;
 export declare function resolveProjectDefinitionPath(projectRoot: string): string;
 /**
  * POSIX-style display path to the resolved PROJECT-DEFINITION artifact relative
- * to the project root (e.g. `vbrief/PROJECT-DEFINITION.vbrief.json`).
+ * to the project root (e.g. `xbrief/PROJECT-DEFINITION.xbrief.json`).
  */
 export declare function projectDefinitionRelPath(projectRoot: string): string;
 /**
- * Absolute path to the resolved specification artifact (#2132).
+ * Absolute path to the resolved specification artifact (#2132 / #2112).
  *
- * Prefers `xbrief/specification.xbrief.json` on a migrated tree; falls back to
- * `vbrief/specification.vbrief.json` on an unmigrated tree. Consistent with the
- * layout resolver used by the #2109 Part-2a call-site sweep.
+ * Returns `xbrief/specification.xbrief.json`; throws when no migrated xbrief/
+ * layout is present (see `resolveLifecycleLayout`).
  */
 export declare function resolveSpecArtifactPath(projectRoot: string): string;
 /**
  * POSIX-style display path to the resolved specification artifact relative to
- * the project root (e.g. `xbrief/specification.xbrief.json`).
+ * the project root (`xbrief/specification.xbrief.json`).
  */
 export declare function specArtifactRelPath(projectRoot: string): string;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/layout/resolve.js

@@ -1,15 +1,18 @@
 import { readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
-import { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, LEGACY_INFO_ROOT_KEY, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, } from "../xbrief-migrate/constants.js";
-export { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, LEGACY_INFO_ROOT_KEY, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, };
+import { LEGACY_ARTIFACT_DIR, LEGACY_ARTIFACT_SUFFIX, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, } from "../xbrief-migrate/constants.js";
+export { LEGACY_ARTIFACT_DIR, MIGRATED_ARTIFACT_DIR, MIGRATED_ARTIFACT_SUFFIX, MIGRATED_INFO_ROOT_KEY, };
 /**
- * Lifecycle directory names recognized by the layout-aware resolver, in
- * preference order (migrated `xbrief` first, legacy `vbrief` second).
+ * Lifecycle directory names recognized by the layout-aware resolver and path
+ * validators. Includes both `xbrief` (canonical) and `vbrief` (legacy) so that
+ * path-validation helpers remain accurate during and after migration.
  */
 export const LIFECYCLE_DIR_NAMES = [MIGRATED_ARTIFACT_DIR, LEGACY_ARTIFACT_DIR];
 /**
- * Artifact filename suffixes recognized by the layout-aware resolver, in
- * preference order (`.xbrief.json` first, `.vbrief.json` second).
+ * Artifact filename suffixes recognized by the layout-aware resolver and path
+ * validators. Includes both `.xbrief.json` (canonical) and `.vbrief.json`
+ * (legacy) so that path-validation helpers remain accurate during and after
+ * migration.
  */
 export const ARTIFACT_SUFFIXES = [MIGRATED_ARTIFACT_SUFFIX, LEGACY_ARTIFACT_SUFFIX];
 function isDirectory(path) {
@@ -20,6 +23,25 @@ function isDirectory(path) {
         return false;
     }
 }
+/**
+ * Returns the layout root for non-layout-sensitive helpers (#2112).
+ *
+ * - If a valid `xbrief/` layout exists, returns its root.
+ * - If only `vbrief/` exists (legacy-only), throws so the caller surfaces the migrate hint.
+ * - If neither exists (empty/new project), falls back to `<projectRoot>/xbrief/` canonical path.
+ */
+export function resolveLayoutRootOrCanonical(projectRoot) {
+    try {
+        return resolveLifecycleRoot(projectRoot);
+    }
+    catch (err) {
+        if (isDirectory(join(projectRoot, LEGACY_ARTIFACT_DIR)) &&
+            !isDirectory(join(projectRoot, MIGRATED_ARTIFACT_DIR))) {
+            throw err; // Legacy-only project: operator must run deft migrate:xbrief.
+        }
+        return join(projectRoot, MIGRATED_ARTIFACT_DIR); // New/empty project; use canonical path.
+    }
+}
 /** True when `name` ends with any recognized artifact suffix (.xbrief.json or .vbrief.json). */
 export function hasArtifactSuffix(name) {
     return ARTIFACT_SUFFIXES.some((suffix) => name.endsWith(suffix));
@@ -37,8 +59,10 @@ export function stripArtifactSuffix(name) {
     return name;
 }
 /**
- * True when a POSIX-style path is a lifecycle artifact under either layout
- * root (`xbrief/` or `vbrief/`) carrying either artifact suffix.
+ * True when a POSIX-style path is a lifecycle artifact path carrying a
+ * recognized lifecycle directory prefix (`xbrief/` or `vbrief/`) and a
+ * recognized artifact suffix. The `vbrief/` prefix and `.vbrief.json` suffix
+ * remain recognized for path-validation purposes during and after migration.
  */
 export function isLifecycleArtifactPath(posix) {
     const underLifecycleDir = LIFECYCLE_DIR_NAMES.some((dir) => posix.startsWith(`${dir}/`));
@@ -64,12 +88,16 @@ function containsMigratedArtifact(root) {
     return false;
 }
 /**
- * Resolve the active lifecycle layout for `projectRoot` (#2109 part 1).
+ * Resolve the active lifecycle layout for `projectRoot` (#2109 part 1 / #2112).
+ *
+ * Requires the migrated `xbrief/` layout: the `xbrief/` directory must exist
+ * AND contain at least one `.xbrief.json` artifact. If no such layout is found,
+ * throws with a clear error directing the operator to run `deft migrate:xbrief`.
  *
- * Prefers the migrated `xbrief/` layout only when BOTH the `xbrief/` directory
- * exists AND it contains at least one `.xbrief.json` artifact; otherwise falls
- * back to the legacy `vbrief/` layout. With only `vbrief/` present (today's
- * repo) the result is the legacy layout, so existing behavior is unchanged.
+ * The legacy `vbrief/` read-path fallback was removed in #2112 (0.73.0 MINOR).
+ * Projects that have not migrated must run `deft migrate:xbrief` first.
+ *
+ * @throws {Error} When no `xbrief/` layout with `.xbrief.json` artifacts exists.
  */
 export function resolveLifecycleLayout(projectRoot) {
     const migratedRoot = join(projectRoot, MIGRATED_ARTIFACT_DIR);
@@ -82,28 +110,26 @@ export function resolveLifecycleLayout(projectRoot) {
             migrated: true,
         };
     }
-    return {
-        artifactDir: LEGACY_ARTIFACT_DIR,
-        artifactSuffix: LEGACY_ARTIFACT_SUFFIX,
-        infoRootKey: LEGACY_INFO_ROOT_KEY,
-        root: join(projectRoot, LEGACY_ARTIFACT_DIR),
-        migrated: false,
-    };
+    throw new Error(`No xbrief/ layout found at ${projectRoot}. ` +
+        "Run `deft migrate:xbrief` to convert your project from the legacy vbrief/ layout.");
 }
 /** Convenience accessor for the absolute resolved lifecycle root directory. */
 export function resolveLifecycleRoot(projectRoot) {
     return resolveLifecycleLayout(projectRoot).root;
 }
 /**
- * Absolute path to a lifecycle folder under the resolved layout root
- * (e.g. `<root>/<xbrief|vbrief>/active`). Layout-aware (#2109 part 2a).
+ * Absolute path to a lifecycle folder under the resolved `xbrief/` layout root
+ * (e.g. `<root>/xbrief/active`). Layout-aware (#2109 part 2a / #2112).
  */
 export function resolveLifecycleFolder(projectRoot, folder) {
-    return join(resolveLifecycleRoot(projectRoot), folder);
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    return join(resolveLayoutRootOrCanonical(projectRoot), folder);
 }
 /** Absolute path to the layout-aware `.eval/` directory for version-eval results (#1703). */
 export function resolveEvalDir(projectRoot) {
-    return join(resolveLifecycleRoot(projectRoot), ".eval");
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    const layoutRoot = resolveLayoutRootOrCanonical(projectRoot);
+    return join(layoutRoot, ".eval");
 }
 /** Absolute path under `.eval/` for version-eval artefacts (not triage working-set). */
 export function resolveEvalPath(projectRoot, ...segments) {
@@ -111,7 +137,9 @@ export function resolveEvalPath(projectRoot, ...segments) {
 }
 /** Absolute path to the resolved lifecycle `.audit` directory (#2109 part 2a). */
 export function resolveAuditDir(projectRoot) {
-    return join(resolveLifecycleRoot(projectRoot), ".audit");
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    const layoutRoot = resolveLayoutRootOrCanonical(projectRoot);
+    return join(layoutRoot, ".audit");
 }
 /** Absolute path to a file or subpath under the resolved `.audit` directory. */
 export function resolveAuditPath(projectRoot, ...segments) {
@@ -122,27 +150,56 @@ export function resolveAuditPath(projectRoot, ...segments) {
  * (`PROJECT-DEFINITION.xbrief.json` when migrated, else `.vbrief.json`).
  */
 export function projectDefinitionFilename(projectRoot) {
-    return `PROJECT-DEFINITION${resolveLifecycleLayout(projectRoot).artifactSuffix}`;
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    try {
+        return `PROJECT-DEFINITION${resolveLifecycleLayout(projectRoot).artifactSuffix}`;
+    }
+    catch (err) {
+        if (isDirectory(join(projectRoot, LEGACY_ARTIFACT_DIR)) &&
+            !isDirectory(join(projectRoot, MIGRATED_ARTIFACT_DIR))) {
+            throw err;
+        }
+        return `PROJECT-DEFINITION${MIGRATED_ARTIFACT_SUFFIX}`;
+    }
 }
 /** Absolute path to the resolved PROJECT-DEFINITION artifact (#2109 part 2a). */
 export function resolveProjectDefinitionPath(projectRoot) {
-    const layout = resolveLifecycleLayout(projectRoot);
-    return join(layout.root, `PROJECT-DEFINITION${layout.artifactSuffix}`);
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    try {
+        const layout = resolveLifecycleLayout(projectRoot);
+        return join(layout.root, `PROJECT-DEFINITION${layout.artifactSuffix}`);
+    }
+    catch (err) {
+        if (isDirectory(join(projectRoot, LEGACY_ARTIFACT_DIR)) &&
+            !isDirectory(join(projectRoot, MIGRATED_ARTIFACT_DIR))) {
+            throw err; // Legacy-only project: operator must run deft migrate:xbrief.
+        }
+        return join(projectRoot, MIGRATED_ARTIFACT_DIR, `PROJECT-DEFINITION${MIGRATED_ARTIFACT_SUFFIX}`);
+    }
 }
 /**
  * POSIX-style display path to the resolved PROJECT-DEFINITION artifact relative
- * to the project root (e.g. `vbrief/PROJECT-DEFINITION.vbrief.json`).
+ * to the project root (e.g. `xbrief/PROJECT-DEFINITION.xbrief.json`).
  */
 export function projectDefinitionRelPath(projectRoot) {
-    const layout = resolveLifecycleLayout(projectRoot);
-    return `${layout.artifactDir}/PROJECT-DEFINITION${layout.artifactSuffix}`;
+    // Throws on a pure vbrief/-only tree (#2112). Falls back to xbrief/ when neither layout exists.
+    try {
+        const layout = resolveLifecycleLayout(projectRoot);
+        return `${layout.artifactDir}/PROJECT-DEFINITION${layout.artifactSuffix}`;
+    }
+    catch (err) {
+        if (isDirectory(join(projectRoot, LEGACY_ARTIFACT_DIR)) &&
+            !isDirectory(join(projectRoot, MIGRATED_ARTIFACT_DIR))) {
+            throw err;
+        }
+        return `${MIGRATED_ARTIFACT_DIR}/PROJECT-DEFINITION${MIGRATED_ARTIFACT_SUFFIX}`;
+    }
 }
 /**
- * Absolute path to the resolved specification artifact (#2132).
+ * Absolute path to the resolved specification artifact (#2132 / #2112).
  *
- * Prefers `xbrief/specification.xbrief.json` on a migrated tree; falls back to
- * `vbrief/specification.vbrief.json` on an unmigrated tree. Consistent with the
- * layout resolver used by the #2109 Part-2a call-site sweep.
+ * Returns `xbrief/specification.xbrief.json`; throws when no migrated xbrief/
+ * layout is present (see `resolveLifecycleLayout`).
  */
 export function resolveSpecArtifactPath(projectRoot) {
     const layout = resolveLifecycleLayout(projectRoot);
@@ -150,7 +207,7 @@ export function resolveSpecArtifactPath(projectRoot) {
 }
 /**
  * POSIX-style display path to the resolved specification artifact relative to
- * the project root (e.g. `xbrief/specification.xbrief.json`).
+ * the project root (`xbrief/specification.xbrief.json`).
  */
 export function specArtifactRelPath(projectRoot) {
     const layout = resolveLifecycleLayout(projectRoot);

package/dist/lifecycle/lifecycle-hygiene.d.ts

@@ -11,7 +11,7 @@ export declare const TERMINAL_STATUSES: Set<string>;
 /** Child reference type that marks an epic as decomposed. */
 export declare const CHILD_REF_TYPE = "x-xbrief/plan";
 /** Durable tech-debt acceptance ledger relative path segments. */
-export declare const TECH_DEBT_LEDGER_RELPATH: readonly ["vbrief", ".audit", "epic-tech-debt-accepted.jsonl"];
+export declare const TECH_DEBT_LEDGER_RELPATH: readonly ["xbrief", ".audit", "epic-tech-debt-accepted.jsonl"];
 /** Session-start nudge tiers (rate-of-harm ranking). */
 export declare const TIER_STRANDED = 1;
 export declare const TIER_STALE_EPIC = 2;

package/dist/lifecycle/lifecycle-hygiene.js

@@ -26,7 +26,7 @@ export const TERMINAL_STATUSES = new Set(["completed", "cancelled", "failed"]);
 export const CHILD_REF_TYPE = "x-xbrief/plan";
 /** Durable tech-debt acceptance ledger relative path segments. */
 export const TECH_DEBT_LEDGER_RELPATH = [
-    "vbrief",
+    "xbrief",
     ".audit",
     "epic-tech-debt-accepted.jsonl",
 ];

package/dist/migrate-preflight/index.js

@@ -14,7 +14,7 @@ function resolveContentRoot(frameworkRoot) {
     return frameworkRoot;
 }
 export function checkLayout(deftRoot, projectRoot) {
-    const schemasDir = join(resolveContentRoot(deftRoot), "vbrief", "schemas");
+    const schemasDir = join(resolveContentRoot(deftRoot), "xbrief", "schemas");
     if (!existsSync(schemasDir) || !statSync(schemasDir).isDirectory()) {
         return {
             name: "layout",
@@ -22,18 +22,18 @@ export function checkLayout(deftRoot, projectRoot) {
             message: `Framework schemas dir missing at ${schemasDir}. Refresh the deft checkout (see deft/QUICK-START.md).`,
         };
     }
-    const projectVbrief = join(projectRoot, "vbrief");
-    if (!existsSync(projectVbrief)) {
+    const projectXbrief = join(projectRoot, "xbrief");
+    if (!existsSync(projectXbrief)) {
         return {
             name: "layout",
             status: "WARN",
-            message: `Project vbrief/ not present at ${projectVbrief} -- expected for greenfield projects.`,
+            message: `Project xbrief/ not present at ${projectXbrief} -- expected for greenfield projects.`,
         };
     }
     return {
         name: "layout",
         status: "PASS",
-        message: `Framework schemas present; project vbrief/ at ${projectVbrief}.`,
+        message: `Framework schemas present; project xbrief/ at ${projectXbrief}.`,
     };
 }
 export function checkGitClean(projectRoot) {
@@ -91,7 +91,7 @@ export function checkDocumentModel(projectRoot) {
                 return {
                     name: "document-model",
                     status: "FAIL",
-                    message: `Generated SPECIFICATION.md detected (source: vbrief/specification.vbrief.json); repair missing lifecycle folder(s) instead of migrating: ${missing.join(", ")}.`,
+                    message: `Generated SPECIFICATION.md detected (source: xbrief/specification.xbrief.json); repair missing lifecycle folder(s) instead of migrating: ${missing.join(", ")}.`,
                 };
             }
         }
@@ -99,18 +99,18 @@ export function checkDocumentModel(projectRoot) {
             return {
                 name: "document-model",
                 status: "PASS",
-                message: "Current generated SPECIFICATION.md detected (source: vbrief/specification.vbrief.json); pre-v0.20 migration is not needed.",
+                message: "Current generated SPECIFICATION.md detected (source: xbrief/specification.xbrief.json); pre-v0.20 migration is not needed.",
             };
         }
     }
-    const vbriefRoot = join(projectRoot, "vbrief");
-    if (existsSync(vbriefRoot)) {
+    const xbriefRoot = join(projectRoot, "xbrief");
+    if (existsSync(xbriefRoot)) {
         const missing = missingLifecycleFolders(projectRoot);
         if (missing.length > 0) {
             return {
                 name: "document-model",
                 status: "FAIL",
-                message: `Partial vBRIEF layout detected; missing lifecycle folder(s): ${missing.join(", ")}. Create the folders or follow ${frozenPreCutoverMigrationGuidance()}`,
+                message: `Partial xBRIEF layout detected; missing lifecycle folder(s): ${missing.join(", ")}. Create the folders or follow ${frozenPreCutoverMigrationGuidance()}`,
             };
         }
     }

package/dist/policy/index.js

@@ -215,8 +215,8 @@ function inspectSwarmSubagentBackend(data) {
         source: "default-on-error",
     };
 }
-function inspectValueFeedbackField(data) {
-    const field = inspectValueFeedback(data);
+function inspectValueFeedbackField(data, projectRoot) {
+    const field = inspectValueFeedback(data, projectRoot);
     return {
         name: field.name,
         current: field.current,
@@ -241,7 +241,7 @@ const REGISTERED_POLICIES = [
 /** Walk registered inspectors and return one row per field (#1148). */
 export function inspectAllPolicies(projectRoot) {
     const [data] = loadProjectDefinition(projectRoot);
-    return REGISTERED_POLICIES.map((inspect) => inspect(data));
+    return REGISTERED_POLICIES.map((inspect) => inspect(data, projectRoot));
 }
 /** Look up a single registered field by canonical dotted-path name (or CLI alias). */
 export function inspectOnePolicy(name, projectRoot) {

package/dist/policy/resolve.d.ts

@@ -1,5 +1,5 @@
-/** Filesystem-relative location of the project-definition vBRIEF (display/back-compat). */
-export declare const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+/** Filesystem-relative location of the project-definition xBRIEF (display/back-compat). */
+export declare const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Environment variable emergency bypass for branch protection (#747). */
 export declare const ENV_BYPASS = "DEFT_ALLOW_DEFAULT_BRANCH_COMMIT";
 /** Legacy narrative key replaced by the typed flag (#746). */

package/dist/policy/resolve.js

@@ -3,8 +3,8 @@ import { join, resolve as pathResolve } from "node:path";
 import { resolveProjectDefinitionPath } from "../layout/resolve.js";
 import { atomicWriteProjectDefinition, projectDefinitionMutationLock, } from "../vbrief-build/project-definition-io.js";
 import { migrateLegacyPolicyKey, PLAN_POLICY_KEY, readPlanPolicy } from "./plan-extensions.js";
-/** Filesystem-relative location of the project-definition vBRIEF (display/back-compat). */
-export const PROJECT_DEFINITION_REL_PATH = "vbrief/PROJECT-DEFINITION.vbrief.json";
+/** Filesystem-relative location of the project-definition xBRIEF (display/back-compat). */
+export const PROJECT_DEFINITION_REL_PATH = "xbrief/PROJECT-DEFINITION.xbrief.json";
 /** Environment variable emergency bypass for branch protection (#747). */
 export const ENV_BYPASS = "DEFT_ALLOW_DEFAULT_BRANCH_COMMIT";
 /** Legacy narrative key replaced by the typed flag (#746). */
@@ -18,7 +18,15 @@ const TRUTHY = new Set(["1", "true", "yes", "on"]);
  * else PROJECT-DEFINITION.vbrief.json (unchanged on today's tree).
  */
 export function projectDefinitionPath(projectRoot) {
-    return resolveProjectDefinitionPath(pathResolve(projectRoot));
+    const root = pathResolve(projectRoot);
+    try {
+        return resolveProjectDefinitionPath(root);
+    }
+    catch {
+        // No xbrief/ layout; return canonical xbrief path so callers get a predictable
+        // "not found" result rather than a thrown error.
+        return join(root, PROJECT_DEFINITION_REL_PATH);
+    }
 }
 function envBypassActive() {
     const raw = process.env[ENV_BYPASS] ?? "";

package/dist/policy/value-feedback-autoenable.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Company-owned GitHub orgs whose repos auto-enable LOCAL value-feedback
+ * collection (#2376). Org membership is the consent for local, no-egress
+ * collection; network/upstream surfaces stay opt-in regardless.
+ */
+export declare const DEFAULT_AUTOENABLE_ORGS: readonly string[];
+/** Optional comma-separated env override that EXTENDS the built-in trusted-org set. */
+export declare const AUTOENABLE_ORGS_ENV = "DEFT_VALUE_AUTOENABLE_ORGS";
+/** Built-in trusted orgs plus any from the env override, normalized to lowercase. */
+export declare function resolveTrustedOrgs(env?: NodeJS.ProcessEnv): Set<string>;
+/** Test/hygiene hook: drop the memoized origin-org lookups. */
+export declare function clearOriginOrgCache(): void;
+export interface OriginOrgOptions {
+    /** Test seam for origin-repo resolution; defaults to `inferRepoFromGit`. */
+    readonly repoResolver?: (projectRoot: string) => string | null;
+    /** Override caching; defaults to caching only when no custom resolver is supplied. */
+    readonly useCache?: boolean;
+}
+/**
+ * Lowercased owner of the origin remote for `projectRoot`, or null when there is
+ * no remote / not a git checkout. Memoized per projectRoot (the org does not
+ * change within a session) to keep the resolver off the hot emit path.
+ */
+export declare function detectOriginOrg(projectRoot: string, options?: OriginOrgOptions): string | null;
+export interface OrgAutoEnableOptions extends OriginOrgOptions {
+    readonly env?: NodeJS.ProcessEnv;
+}
+/**
+ * True when `projectRoot`'s origin org is in the trusted-org set (#2376).
+ * Fail-safe: any resolution failure (no remote, non-GitHub, git absent) is false.
+ */
+export declare function isTrustedOrgAutoEnable(projectRoot: string, options?: OrgAutoEnableOptions): boolean;
+//# sourceMappingURL=value-feedback-autoenable.d.ts.map

package/dist/policy/value-feedback-autoenable.js

@@ -0,0 +1,67 @@
+import { inferRepoFromGit } from "../triage/queue/repo.js";
+/**
+ * Company-owned GitHub orgs whose repos auto-enable LOCAL value-feedback
+ * collection (#2376). Org membership is the consent for local, no-egress
+ * collection; network/upstream surfaces stay opt-in regardless.
+ */
+export const DEFAULT_AUTOENABLE_ORGS = ["deftai"];
+/** Optional comma-separated env override that EXTENDS the built-in trusted-org set. */
+export const AUTOENABLE_ORGS_ENV = "DEFT_VALUE_AUTOENABLE_ORGS";
+/** Built-in trusted orgs plus any from the env override, normalized to lowercase. */
+export function resolveTrustedOrgs(env = process.env) {
+    const orgs = new Set(DEFAULT_AUTOENABLE_ORGS.map((o) => o.toLowerCase()));
+    const raw = env[AUTOENABLE_ORGS_ENV];
+    if (typeof raw === "string") {
+        for (const part of raw.split(",")) {
+            const trimmed = part.trim().toLowerCase();
+            if (trimmed.length > 0) {
+                orgs.add(trimmed);
+            }
+        }
+    }
+    return orgs;
+}
+const originOrgCache = new Map();
+/** Test/hygiene hook: drop the memoized origin-org lookups. */
+export function clearOriginOrgCache() {
+    originOrgCache.clear();
+}
+/**
+ * Lowercased owner of the origin remote for `projectRoot`, or null when there is
+ * no remote / not a git checkout. Memoized per projectRoot (the org does not
+ * change within a session) to keep the resolver off the hot emit path.
+ */
+export function detectOriginOrg(projectRoot, options = {}) {
+    const useCache = options.useCache ?? options.repoResolver === undefined;
+    if (useCache && originOrgCache.has(projectRoot)) {
+        return originOrgCache.get(projectRoot) ?? null;
+    }
+    const resolver = options.repoResolver ?? inferRepoFromGit;
+    let org = null;
+    try {
+        const repo = resolver(projectRoot);
+        if (typeof repo === "string") {
+            const owner = repo.split("/")[0]?.trim().toLowerCase() ?? "";
+            org = owner.length > 0 ? owner : null;
+        }
+    }
+    catch {
+        org = null;
+    }
+    if (useCache) {
+        originOrgCache.set(projectRoot, org);
+    }
+    return org;
+}
+/**
+ * True when `projectRoot`'s origin org is in the trusted-org set (#2376).
+ * Fail-safe: any resolution failure (no remote, non-GitHub, git absent) is false.
+ */
+export function isTrustedOrgAutoEnable(projectRoot, options = {}) {
+    const org = detectOriginOrg(projectRoot, options);
+    if (org === null) {
+        return false;
+    }
+    return resolveTrustedOrgs(options.env).has(org);
+}
+//# sourceMappingURL=value-feedback-autoenable.js.map