@deftai/directive-core 0.64.0 → 0.66.0

package/dist/triage/bootstrap/index.js

@@ -3,6 +3,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
+import { hasArtifactSuffix, resolveEvalPath, resolveLifecycleRoot } from "../../layout/resolve.js";
 import { SUBPROCESS_MAX_BUFFER } from "../../subprocess/max-buffer.js";
 import { stepEnsureGitignoreEntry, stepEnsureGitignoreEvalEntries, stepSeedCandidatesLog, } from "./gitignore.js";
 import { PROGRESS_DEFAULT } from "./types.js";
@@ -296,7 +297,9 @@ function extractIssueNumber(vbriefData) {
         if (typeof ref !== "object" || ref === null)
             continue;
         const typed = ref;
-        if (typed.type !== "x-vbrief/github-issue")
+        // Dual-namespace (#2109): accept the migrated `x-xbrief/` corpus token and
+        // the legacy `x-vbrief/` token (still read-accepted for back-compat).
+        if (typed.type !== "x-xbrief/github-issue" && typed.type !== "x-vbrief/github-issue")
             continue;
         const uri = typed.uri;
         if (typeof uri !== "string")
@@ -312,7 +315,7 @@ function scanLifecycleFolder(folder) {
     if (!existsSync(folder))
         return results;
     const entries = readdirSync(folder)
-        .filter((name) => name.endsWith(".vbrief.json"))
+        .filter((name) => hasArtifactSuffix(name))
         .sort();
     for (const name of entries) {
         const path = join(folder, name);
@@ -370,11 +373,11 @@ export function stepBackfillAuditLog(projectRoot, repo, options = {}) {
     if (repo === null) {
         return stepOutcome("backfill_audit_log", true, "skipped (no --repo provided; pass --repo OWNER/NAME to backfill)", { skipped: "no-repo" });
     }
-    const vbriefRoot = join(projectRoot, "vbrief");
+    const vbriefRoot = resolveLifecycleRoot(projectRoot);
     if (!existsSync(vbriefRoot)) {
         return stepOutcome("backfill_audit_log", true, `skipped (no vbrief/ directory under ${projectRoot})`, { skipped: "no-vbrief" });
     }
-    const auditPath = join(projectRoot, AUDIT_LOG_RELPATH);
+    const auditPath = resolveEvalPath(projectRoot, "candidates.jsonl");
     const alreadyLogged = existingAuditIssueNumbers(auditPath);
     const nowIso = options.nowIso ?? nowIsoDefault;
     const appendEntry = options.appendAuditEntry ?? appendAuditEntryDefault;

package/dist/triage/bulk/index.js

@@ -1,6 +1,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { resolveEvalPath } from "../../layout/resolve.js";
 export const ACTION_FN_NAMES = {
     accept: "accept",
     reject: "reject",
@@ -375,7 +376,7 @@ export function createFilesystemCacheModule() {
         CacheError,
     };
 }
-export function createFilesystemCandidatesLogModule(logPath = "vbrief/.eval/candidates.jsonl") {
+export function createFilesystemCandidatesLogModule(logPath = resolveEvalPath(process.cwd(), "candidates.jsonl")) {
     return {
         readAll(options) {
             if (!existsSync(logPath)) {

package/dist/triage/classify/index.js

@@ -1,5 +1,8 @@
 import { readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { referenceTypeMatches } from "@deftai/directive-types";
+import { hasArtifactSuffix, resolveLifecycleRoot, resolveProjectDefinitionPath, } from "../../layout/resolve.js";
+import { readPlanPolicy } from "../../policy/plan-extensions.js";
 import { pyRepr } from "../../scm/py-format.js";
 function pythonTypeName(value) {
     if (value === null) {
@@ -252,8 +255,7 @@ export function validateHoldMarkers(markers) {
     return { errors, warnings };
 }
 export function projectDefinitionPath(projectRoot) {
-    const root = projectRoot ?? process.cwd();
-    return join(root, PROJECT_DEFINITION_REL_PATH);
+    return resolveProjectDefinitionPath(projectRoot ?? process.cwd());
 }
 function loadProjectDefinition(projectRoot) {
     const path = projectDefinitionPath(projectRoot);
@@ -276,7 +278,7 @@ function consumerRulesFromProject(data) {
     if (typeof plan !== "object" || plan === null || Array.isArray(plan)) {
         return [];
     }
-    const policy = plan.policy;
+    const policy = readPlanPolicy(plan);
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         return [];
     }
@@ -294,7 +296,7 @@ function holdMarkersFromProject(data) {
     if (typeof plan !== "object" || plan === null || Array.isArray(plan)) {
         return null;
     }
-    const policy = plan.policy;
+    const policy = readPlanPolicy(plan);
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         return null;
     }
@@ -518,13 +520,13 @@ export function classifyIssue(issue, options = {}) {
 }
 /** Return issue numbers referenced by pending/ or active/ scope vBRIEFs. */
 export function extractReferencedIssues(projectRoot, lifecycleFolders = ["pending", "active"]) {
-    const root = join(projectRoot ?? process.cwd(), "vbrief");
+    const root = resolveLifecycleRoot(projectRoot ?? process.cwd());
     const referenced = new Set();
     for (const folder of lifecycleFolders) {
         const folderPath = join(root, folder);
         let entries;
         try {
-            entries = readdirSync(folderPath).filter((f) => f.endsWith(".vbrief.json"));
+            entries = readdirSync(folderPath).filter((f) => hasArtifactSuffix(f));
         }
         catch {
             continue;
@@ -549,7 +551,7 @@ export function extractReferencedIssues(projectRoot, lifecycleFolders = ["pendin
                         continue;
                     }
                     const r = ref;
-                    if (r.type !== "x-vbrief/github-issue") {
+                    if (!referenceTypeMatches(String(r.type ?? ""), "github-issue")) {
                         continue;
                     }
                     const uri = r.uri;
@@ -652,7 +654,7 @@ export function validateTriageAutoClassifyOnPlan(plan, filepath) {
     if (typeof plan !== "object" || plan === null || Array.isArray(plan)) {
         return out;
     }
-    const policy = plan.policy;
+    const policy = readPlanPolicy(plan);
     const raw = typeof policy === "object" && policy !== null && !Array.isArray(policy)
         ? policy.triageAutoClassify
         : undefined;
@@ -671,7 +673,7 @@ export function validateTriageHoldMarkersOnPlan(plan, filepath) {
     if (typeof plan !== "object" || plan === null || Array.isArray(plan)) {
         return out;
     }
-    const policy = plan.policy;
+    const policy = readPlanPolicy(plan);
     const raw = typeof policy === "object" && policy !== null && !Array.isArray(policy)
         ? policy.triageHoldMarkers
         : undefined;
@@ -696,7 +698,7 @@ export function validateProject(projectRoot) {
         return {
             code: 0,
             stdout: "OK: no PROJECT-DEFINITION at " +
-                `${join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json")} -- ` +
+                `${resolveProjectDefinitionPath(root)} -- ` +
                 "framework defaults apply with no consumer overrides.\n",
             stderr: "",
         };
@@ -709,7 +711,7 @@ export function validateProject(projectRoot) {
             stderr: "FAIL: PROJECT-DEFINITION.plan is not an object\n",
         };
     }
-    const rel = join(root, "vbrief", "PROJECT-DEFINITION.vbrief.json");
+    const rel = resolveProjectDefinitionPath(root);
     const classifyErrs = validateTriageAutoClassifyOnPlan(plan, rel);
     const holderErrs = validateTriageHoldMarkersOnPlan(plan, rel);
     const errors = [...classifyErrs, ...holderErrs];

package/dist/triage/queue/audit.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { DEFAULT_AUDIT_LOG_REL_PATH } from "./constants.js";
+import { resolve } from "node:path";
+import { resolveEvalPath } from "../../layout/resolve.js";
 /** Resolve audit log path; mirrors candidates_log._resolve_path (framework root). */
 export function resolveAuditLogPath(options = {}) {
     if (options.auditLogPath !== null && options.auditLogPath !== undefined) {
@@ -12,7 +12,7 @@ export function resolveAuditLogPath(options = {}) {
         : envRoot.length > 0
             ? resolve(envRoot)
             : process.cwd();
-    return join(root, DEFAULT_AUDIT_LOG_REL_PATH);
+    return resolveEvalPath(root, "candidates.jsonl");
 }
 /** Read audit log entries, optionally filtered by repo. */
 export function readAuditEntries(repo, options = {}) {

package/dist/triage/queue/build-queue.js

@@ -1,5 +1,6 @@
 import { GROUP_ORDER } from "./constants.js";
 import { deriveGroup } from "./derive-group.js";
+import { hasActiveScopeIgnores, isCachedIssueScopeIgnored, } from "./scope-ignores-filter.js";
 import { compareSelectionKeys, matchedLabelFor, withinGroupSortKey } from "./selection.js";
 function resolveRank(issue, number, rankByNumber) {
     let candidate = rankByNumber.get(number);
@@ -71,6 +72,8 @@ export function buildQueue(issues, auditEntries, options) {
     const dropNetNew = Boolean(opts.finishBeforeStart && opts.wipAtCap);
     const includeBlocked = Boolean(opts.includeBlocked);
     const limit = opts.limit;
+    const scopeIgnores = opts.scopeIgnores;
+    const filterScopeIgnores = scopeIgnores !== undefined && hasActiveScopeIgnores(scopeIgnores);
     const decisions = latestDecisionsByIssue(auditEntries);
     const grouped = new Map();
     for (const group of GROUP_ORDER) {
@@ -81,6 +84,9 @@ export function buildQueue(issues, auditEntries, options) {
         if (typeof n !== "number") {
             continue;
         }
+        if (filterScopeIgnores && isCachedIssueScopeIgnored(issue, scopeIgnores)) {
+            continue;
+        }
         const isContinuation = resolveContinuation(issue, n, continuationNumbers);
         const isOrphan = orphanIssueNumbers.has(n);
         if (dropNetNew && !isContinuation && !isOrphan) {

package/dist/triage/queue/cache.js

@@ -1,6 +1,9 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { CACHE_DIR_NAME, CACHE_SOURCE_GITHUB_ISSUE, DEFAULT_SLICES_LOG_REL_PATH, } from "./constants.js";
+import { resolveEvalPath } from "../../layout/resolve.js";
+import { extractAuthor, extractMilestone } from "../scope-drift/cache-walker.js";
+import { CACHE_DIR_NAME, CACHE_SOURCE_GITHUB_ISSUE } from "./constants.js";
+import { hasActiveScopeIgnores, isRawIssueScopeIgnored, resolveScopeIgnores, } from "./scope-ignores-filter.js";
 import { blockedByIssueNumber, rankByIssueNumber } from "./scope-walk.js";
 function cachedState(issue) {
     if (issue === undefined) {
@@ -20,7 +23,7 @@ export function resolveSlicesLogPath(options = {}) {
         : envRoot.length > 0
             ? resolve(envRoot)
             : process.cwd();
-    return join(root, DEFAULT_SLICES_LOG_REL_PATH);
+    return resolveEvalPath(root, "slices.jsonl");
 }
 /** Read slices.jsonl records. */
 export function loadSliceRecords(options = {}) {
@@ -116,6 +119,8 @@ export function loadCachedIssues(repo, options) {
     }
     const rankMap = rankByIssueNumber(root);
     const blockedSet = blockedByIssueNumber(root);
+    const scopeIgnores = resolveScopeIgnores(root);
+    const filterScopeIgnores = hasActiveScopeIgnores(scopeIgnores);
     const issues = [];
     for (const entryName of readdirSync(base)) {
         if (!/^\d+$/.test(entryName)) {
@@ -150,11 +155,16 @@ export function loadCachedIssues(repo, options) {
         if (state !== "open" && !options.includeClosed) {
             continue;
         }
+        if (filterScopeIgnores && isRawIssueScopeIgnored(payload, scopeIgnores)) {
+            continue;
+        }
         issues.push({
             number: n,
             title: typeof payload.title === "string" ? payload.title : "",
             state,
             labels: parseLabels(payload.labels),
+            author: extractAuthor(payload),
+            milestone: extractMilestone(payload),
             updatedAt: typeof payload.updated_at === "string" ? payload.updated_at : "",
             createdAt: typeof payload.created_at === "string" ? payload.created_at : "",
             metadataRank: rankMap.get(n) ?? null,

package/dist/triage/queue/index.d.ts

@@ -6,6 +6,7 @@ export * from "./derive-group.js";
 export * from "./ranking-labels.js";
 export * from "./render.js";
 export * from "./repo.js";
+export * from "./scope-ignores-filter.js";
 export * from "./scope-walk.js";
 export * from "./selection.js";
 export * from "./types.js";

package/dist/triage/queue/index.js

@@ -6,6 +6,7 @@ export * from "./derive-group.js";
 export * from "./ranking-labels.js";
 export * from "./render.js";
 export * from "./repo.js";
+export * from "./scope-ignores-filter.js";
 export * from "./scope-walk.js";
 export * from "./selection.js";
 export * from "./types.js";

package/dist/triage/queue/ranking-labels.js

@@ -1,3 +1,4 @@
+import { readPlanPolicy } from "../../policy/plan-extensions.js";
 import { DEFAULT_TRIAGE_RANKING_LABELS, PROJECT_DEFINITION_REL_PATH } from "./constants.js";
 import { loadProjectDefinition } from "./project.js";
 /** Resolve effective plan.policy.triageRankingLabels list. */
@@ -10,7 +11,7 @@ export function resolveRankingLabels(projectRoot) {
     if (typeof plan !== "object" || plan === null) {
         return [...DEFAULT_TRIAGE_RANKING_LABELS];
     }
-    const policy = plan.policy;
+    const policy = readPlanPolicy(plan);
     if (typeof policy !== "object" || policy === null) {
         return [...DEFAULT_TRIAGE_RANKING_LABELS];
     }

package/dist/triage/queue/scope-ignores-filter.d.ts

@@ -0,0 +1,12 @@
+import { resolveScopeIgnores, type ScopeIgnores } from "../scope-drift/scope-rules.js";
+export { resolveScopeIgnores, type ScopeIgnores };
+export declare function hasActiveScopeIgnores(ignores: ScopeIgnores): boolean;
+/** True when a cached raw.json payload matches any triageScopeIgnores entry. */
+export declare function isRawIssueScopeIgnored(raw: Record<string, unknown>, ignores: ScopeIgnores): boolean;
+/** True when a queue CachedIssue matches any triageScopeIgnores entry. */
+export declare function isCachedIssueScopeIgnored(issue: {
+    readonly labels: readonly string[];
+    readonly author?: string;
+    readonly milestone?: string;
+}, ignores: ScopeIgnores): boolean;
+//# sourceMappingURL=scope-ignores-filter.d.ts.map

package/dist/triage/queue/scope-ignores-filter.js

@@ -0,0 +1,50 @@
+import { extractAuthor, extractLabels, extractMilestone } from "../scope-drift/cache-walker.js";
+import { resolveScopeIgnores } from "../scope-drift/scope-rules.js";
+export { resolveScopeIgnores };
+export function hasActiveScopeIgnores(ignores) {
+    return ignores.labels.size > 0 || ignores.milestones.size > 0 || ignores.authors.size > 0;
+}
+/** True when a cached raw.json payload matches any triageScopeIgnores entry. */
+export function isRawIssueScopeIgnored(raw, ignores) {
+    if (ignores.authors.size > 0 && ignores.authors.has(extractAuthor(raw))) {
+        return true;
+    }
+    if (ignores.labels.size > 0) {
+        for (const label of extractLabels(raw)) {
+            if (ignores.labels.has(label)) {
+                return true;
+            }
+        }
+    }
+    if (ignores.milestones.size > 0) {
+        const milestone = extractMilestone(raw);
+        if (milestone && ignores.milestones.has(milestone)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** True when a queue CachedIssue matches any triageScopeIgnores entry. */
+export function isCachedIssueScopeIgnored(issue, ignores) {
+    if (ignores.authors.size > 0 &&
+        issue.author !== undefined &&
+        issue.author.length > 0 &&
+        ignores.authors.has(issue.author)) {
+        return true;
+    }
+    if (ignores.labels.size > 0) {
+        for (const label of issue.labels) {
+            if (ignores.labels.has(label)) {
+                return true;
+            }
+        }
+    }
+    if (ignores.milestones.size > 0 &&
+        issue.milestone !== undefined &&
+        issue.milestone.length > 0 &&
+        ignores.milestones.has(issue.milestone)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=scope-ignores-filter.js.map

package/dist/triage/queue/scope-walk.js

@@ -1,5 +1,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { join } from "node:path";
+import { referenceTypeMatches } from "@deftai/directive-types";
+import { hasArtifactSuffix, resolveLifecycleFolder, resolveLifecycleRoot, } from "../../layout/resolve.js";
 function loadPlan(path) {
     try {
         const data = JSON.parse(readFileSync(path, { encoding: "utf8" }));
@@ -25,7 +27,7 @@ export function issueNumbersFromPlan(plan) {
             continue;
         }
         const typed = ref;
-        if (typed.type !== "x-vbrief/github-issue") {
+        if (!referenceTypeMatches(String(typed.type ?? ""), "github-issue")) {
             continue;
         }
         const uri = typed.uri;
@@ -82,11 +84,11 @@ function dependsOnIds(plan) {
 }
 function completedPlanIds(projectRoot) {
     const out = new Set();
-    const base = join(resolve(projectRoot), "vbrief", "completed");
+    const base = resolveLifecycleFolder(projectRoot, "completed");
     if (!existsSync(base)) {
         return out;
     }
-    for (const name of readdirSync(base).filter((entry) => entry.endsWith(".vbrief.json"))) {
+    for (const name of readdirSync(base).filter((entry) => hasArtifactSuffix(entry))) {
         const plan = loadPlan(join(base, name));
         if (plan === null) {
             continue;
@@ -111,14 +113,14 @@ export function scopeIsBlocked(plan, completedIds) {
     return deps.length > 0 && deps.some((dep) => !completedIds.has(dep));
 }
 function walkScopeFolders(projectRoot, folders, visitor) {
-    const base = join(resolve(projectRoot), "vbrief");
+    const base = resolveLifecycleRoot(projectRoot);
     for (const folder of folders) {
         const folderDir = join(base, folder);
         if (!existsSync(folderDir)) {
             continue;
         }
         for (const name of readdirSync(folderDir)
-            .filter((entry) => entry.endsWith(".vbrief.json"))
+            .filter((entry) => hasArtifactSuffix(entry))
             .sort()) {
             const plan = loadPlan(join(folderDir, name));
             if (plan !== null) {

package/dist/triage/queue/types.d.ts

@@ -1,4 +1,5 @@
 import type { QueueGroup } from "./constants.js";
+import type { ScopeIgnores } from "./scope-ignores-filter.js";
 /** One ranked row in buildQueue. */
 export interface QueueItem {
     readonly number: number;
@@ -25,6 +26,7 @@ export interface QueueBuildOptions {
     readonly blockedIssueNumbers?: ReadonlySet<number>;
     readonly includeBlocked?: boolean;
     readonly limit?: number | null;
+    readonly scopeIgnores?: ScopeIgnores;
 }
 /** Cached issue row produced by loadCachedIssues. */
 export interface CachedIssue {
@@ -32,6 +34,8 @@ export interface CachedIssue {
     readonly title: string;
     readonly state: string;
     readonly labels: readonly string[];
+    readonly author?: string;
+    readonly milestone?: string;
     readonly updatedAt: string;
     readonly createdAt: string;
     readonly metadataRank: number | null;

package/dist/triage/reconcile/audit.js

@@ -1,12 +1,13 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { hasArtifactSuffix } from "../../layout/resolve.js";
 import { extractIssueRef } from "./parse-uri.js";
 export function scanLifecycleRefs(folder) {
     const results = [];
     if (!existsSync(folder))
         return results;
     const files = readdirSync(folder)
-        .filter((name) => name.endsWith(".vbrief.json"))
+        .filter((name) => hasArtifactSuffix(name))
         .sort();
     for (const name of files) {
         const path = join(folder, name);

package/dist/triage/reconcile/parse-uri.js

@@ -1,3 +1,4 @@
+import { referenceTypeMatches } from "@deftai/directive-types";
 /** Parse (repo, issue_number) from a github-issue reference URI. */
 export function parseGithubIssueUri(uri) {
     if (typeof uri !== "string")
@@ -32,7 +33,7 @@ export function extractIssueRef(data) {
         if (typeof ref !== "object" || ref === null || Array.isArray(ref))
             continue;
         const rec = ref;
-        if (rec.type !== "x-vbrief/github-issue")
+        if (!referenceTypeMatches(String(rec.type ?? ""), "github-issue"))
             continue;
         const [repo, number] = parseGithubIssueUri(rec.uri);
         if (number !== null)

package/dist/triage/reconcile/reconcile.js

@@ -1,9 +1,10 @@
 import { execFileSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { appendFileSync, mkdirSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { dirname, resolve } from "node:path";
+import { resolveEvalPath, resolveLifecycleFolder } from "../../layout/resolve.js";
 import { auditKey, existingAuditRefs, scanLifecycleRefs } from "./audit.js";
-import { AUDIT_LOG_RELPATH, BACKFILL_FOLDERS, RECONCILE_ACTOR, } from "./types.js";
+import { BACKFILL_FOLDERS, RECONCILE_ACTOR, } from "./types.js";
 const GIT_ORIGIN_RE = /^(?:https?:\/\/(?:[^@/]+@)?github\.com\/|git@github\.com:|ssh:\/\/git@github\.com[:/])([A-Za-z0-9][A-Za-z0-9._-]*)\/([A-Za-z0-9][A-Za-z0-9._-]*?)(?:\.git)?\/?\s*$/;
 export function inferRepoFromGit(cwd) {
     try {
@@ -32,13 +33,13 @@ function newDecisionId() {
 }
 export function findReconcilable(projectRoot, options = {}) {
     const root = resolve(projectRoot);
-    const auditPath = options.auditLogPath ?? join(root, AUDIT_LOG_RELPATH);
+    const auditPath = options.auditLogPath ?? resolveEvalPath(root, "candidates.jsonl");
     const existing = existingAuditRefs(auditPath);
     const defaultRepo = options.defaultRepo ?? null;
     const items = [];
     const seen = new Set();
     for (const folderName of BACKFILL_FOLDERS) {
-        const folderPath = join(root, "vbrief", folderName);
+        const folderPath = resolveLifecycleFolder(root, folderName);
         for (const [refRepo, number, path] of scanLifecycleRefs(folderPath)) {
             const effectiveRepo = refRepo ?? defaultRepo;
             if (effectiveRepo === null)
@@ -63,7 +64,7 @@ function countSkippedExisting(projectRoot, defaultRepo, auditPath) {
     let count = 0;
     const root = resolve(projectRoot);
     for (const folderName of BACKFILL_FOLDERS) {
-        for (const [refRepo, number] of scanLifecycleRefs(join(root, "vbrief", folderName))) {
+        for (const [refRepo, number] of scanLifecycleRefs(resolveLifecycleFolder(root, folderName))) {
             const effectiveRepo = refRepo ?? defaultRepo;
             if (effectiveRepo === null)
                 continue;
@@ -86,7 +87,7 @@ function countNoRepo(projectRoot, defaultRepo, auditPath) {
     let count = 0;
     const root = resolve(projectRoot);
     for (const folderName of BACKFILL_FOLDERS) {
-        for (const [refRepo, number] of scanLifecycleRefs(join(root, "vbrief", folderName))) {
+        for (const [refRepo, number] of scanLifecycleRefs(resolveLifecycleFolder(root, folderName))) {
             if ((refRepo ?? defaultRepo) === null && !existingNumbers.has(number))
                 count += 1;
         }
@@ -115,7 +116,7 @@ export function reconcile(projectRoot, options = {}) {
     if (defaultRepo === null) {
         defaultRepo = inferRepoFromGit(root);
     }
-    const auditPath = options.auditLogPath ?? join(root, AUDIT_LOG_RELPATH);
+    const auditPath = options.auditLogPath ?? resolveEvalPath(root, "candidates.jsonl");
     const dryRun = options.dryRun ?? false;
     const result = {
         projectRoot: root,

package/dist/triage/refresh/extract.js

@@ -1,11 +1,13 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { referenceTypeMatches } from "@deftai/directive-types";
+import { hasArtifactSuffix } from "../../layout/resolve.js";
 const ISSUE_URL_RE = /github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/i;
 export function iterActiveVbriefs(activeDir) {
     if (!existsSync(activeDir))
         return [];
     return readdirSync(activeDir)
-        .filter((name) => name.endsWith(".vbrief.json"))
+        .filter((name) => hasArtifactSuffix(name))
         .sort()
         .map((name) => join(activeDir, name));
 }
@@ -30,7 +32,7 @@ export function extractIssueRefs(vbriefPath) {
         if (typeof ref !== "object" || ref === null || Array.isArray(ref))
             continue;
         const rec = ref;
-        if (rec.type !== "x-vbrief/github-issue")
+        if (!referenceTypeMatches(String(rec.type ?? ""), "github-issue"))
             continue;
         const uri = String(rec.uri ?? "");
         const match = ISSUE_URL_RE.exec(uri);

package/dist/triage/refresh/refresh.js

@@ -1,4 +1,5 @@
-import { join, resolve } from "node:path";
+import { resolve } from "node:path";
+import { resolveLifecycleFolder } from "../../layout/resolve.js";
 import { detectDrift } from "./drift.js";
 import { iterActiveVbriefs } from "./extract.js";
 import { PROMPT_OPTIONS } from "./types.js";
@@ -20,7 +21,7 @@ function defaultAuditWriter(repo, issueNumber, annotation, log) {
 }
 export function refreshActive(projectRoot, options = {}) {
     const root = resolve(projectRoot);
-    const activeDir = options.activeDir ?? join(root, "vbrief", "active");
+    const activeDir = options.activeDir ?? resolveLifecycleFolder(root, "active");
     const log = options.log ?? ((line) => process.stdout.write(`${line}\n`));
     const inputFn = options.inputFn ?? (() => "");
     const refreshLocal = options.refreshLocal ?? (() => { });

package/dist/triage/scope/mutations-core.js

@@ -2,14 +2,16 @@ import { randomUUID } from "node:crypto";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import { PROJECT_DEFINITION_REL_PATH, SUBSCRIPTION_HISTORY_REL_PATH, SUBSCRIPTION_HISTORY_SCHEMA, } from "./constants.js";
+import { resolveEvalPath, resolveProjectDefinitionPath } from "../../layout/resolve.js";
+import { migrateLegacyPolicyKey, PLAN_POLICY_KEY } from "../../policy/plan-extensions.js";
+import { SUBSCRIPTION_HISTORY_SCHEMA } from "./constants.js";
 import { pyStrRepr } from "./python-repr.js";
 import { utcIso } from "./time.js";
 export class ProjectDefinitionIOError extends Error {
     name = "ProjectDefinitionIOError";
 }
 export function projectDefinitionPath(projectRoot) {
-    return join(projectRoot, PROJECT_DEFINITION_REL_PATH);
+    return resolveProjectDefinitionPath(projectRoot);
 }
 export function loadProjectDefinitionForMutation(projectRoot) {
     const path = projectDefinitionPath(projectRoot);
@@ -58,7 +60,7 @@ function resolveActor(actor) {
     }
 }
 export function recordSubscriptionChange(projectRoot, options) {
-    const historyPath = join(projectRoot, SUBSCRIPTION_HISTORY_REL_PATH);
+    const historyPath = resolveEvalPath(projectRoot, "subscription-history.jsonl");
     const record = {
         schema: SUBSCRIPTION_HISTORY_SCHEMA,
         change_id: randomUUID(),
@@ -132,9 +134,10 @@ export function subscribe(projectRoot, options) {
         throw new Error(`PROJECT-DEFINITION at ${path} has a non-object 'plan' key`);
     }
     const planRec = plan;
-    if (planRec.policy === undefined)
-        planRec.policy = {};
-    const policy = planRec.policy;
+    migrateLegacyPolicyKey(planRec);
+    if (planRec[PLAN_POLICY_KEY] === undefined)
+        planRec[PLAN_POLICY_KEY] = {};
+    const policy = planRec[PLAN_POLICY_KEY];
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         throw new Error(`PROJECT-DEFINITION at ${path} has a non-object 'plan.policy' key`);
     }
@@ -179,9 +182,10 @@ export function addIgnore(projectRoot, label) {
         throw new Error(`PROJECT-DEFINITION at ${path} has a non-object 'plan' key`);
     }
     const planRec = plan;
-    if (planRec.policy === undefined)
-        planRec.policy = {};
-    const policy = planRec.policy;
+    migrateLegacyPolicyKey(planRec);
+    if (planRec[PLAN_POLICY_KEY] === undefined)
+        planRec[PLAN_POLICY_KEY] = {};
+    const policy = planRec[PLAN_POLICY_KEY];
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         throw new Error(`PROJECT-DEFINITION at ${path} has a non-object 'plan.policy' key`);
     }

package/dist/triage/scope/renderers.js

@@ -1,10 +1,12 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { referenceTypeMatches } from "@deftai/directive-types";
+import { hasArtifactSuffix, resolveLifecycleRoot } from "../../layout/resolve.js";
 import { subscriptionHash } from "./normalize.js";
 import { pyListRepr } from "./python-repr.js";
 const LIFECYCLE_FOLDERS = ["proposed", "pending", "active", "completed", "cancelled"];
 export function extractReferencedIssues(projectRoot, lifecycleFolders = LIFECYCLE_FOLDERS) {
-    const root = join(projectRoot, "vbrief");
+    const root = resolveLifecycleRoot(projectRoot);
     const anySet = new Set();
     const activeSet = new Set();
     if (!existsSync(root))
@@ -14,7 +16,7 @@ export function extractReferencedIssues(projectRoot, lifecycleFolders = LIFECYCL
         if (!existsSync(folderPath))
             continue;
         for (const name of readdirSync(folderPath)) {
-            if (!name.endsWith(".vbrief.json"))
+            if (!hasArtifactSuffix(name))
                 continue;
             const vbriefPath = join(folderPath, name);
             let data;
@@ -36,7 +38,7 @@ export function extractReferencedIssues(projectRoot, lifecycleFolders = LIFECYCL
                 if (typeof ref !== "object" || ref === null || Array.isArray(ref))
                     continue;
                 const rec = ref;
-                if (rec.type !== "x-vbrief/github-issue")
+                if (!referenceTypeMatches(String(rec.type ?? ""), "github-issue"))
                     continue;
                 const uri = rec.uri;
                 if (typeof uri !== "string")