@deftai/directive-core 0.72.0 → 0.73.1

package/dist/branch/evaluate.js

@@ -1,5 +1,6 @@
 import { recordBypassSignal, recordGateCatch } from "../events/attribution-ledger.js";
 import { disclosureLine } from "../policy/disclosure.js";
+import { policyColonInvocation } from "../policy/policy-invocation.js";
 import { ENV_BYPASS, resolvePolicy } from "../policy/resolve.js";
 import { currentBranch, GitNotFoundError } from "./git.js";
 export const DEFAULT_BRANCHES = new Set(["master", "main"]);
@@ -32,7 +33,7 @@ function buildBlockMessage(branch, result) {
     if (result.deprecationWarning !== null) {
         parts.push(`  Note: ${result.deprecationWarning}`);
     }
-    parts.push("", "  How to proceed:", "    • Create a feature branch:  git switch -c feat/<name>", "    • Or opt out via the typed surface:", "        task policy:allow-direct-commits -- --confirm", `    • Or set the emergency-escape env-var:  ${ENV_BYPASS}=1`, "", "  See README.md (Branch policy) and skills/deft-directive-setup/", "  Phase 2 Step 9 (capability-cost disclosure).");
+    parts.push("", "  How to proceed:", "    • Create a feature branch:  git switch -c feat/<name>", "    • Or opt out via the typed surface:", `        ${policyColonInvocation("allow-direct-commits", " -- --confirm")}`, `    • Or set the emergency-escape env-var:  ${ENV_BYPASS}=1`, "", "  See README.md (Branch policy) and skills/deft-directive-setup/", "  Phase 2 Step 9 (capability-cost disclosure).");
     return parts.join("\n");
 }
 /**

package/dist/category-b-namespace/index.js

@@ -9,7 +9,7 @@
  * order-preserving (the namespaced key takes the legacy key's slot, keeping
  * artifact diffs minimal).
  */
-import { readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
 import { join, relative, resolve } from "node:path";
 import { hasArtifactSuffix, resolveLifecycleRoot } from "../layout/resolve.js";
 import { LEGACY_PLAN_COMPLETED_NOTE_KEY, LEGACY_PLAN_POLICY_KEY, PLAN_COMPLETED_NOTE_KEY, PLAN_POLICY_KEY, } from "../policy/plan-extensions.js";
@@ -85,7 +85,21 @@ function collectVbriefFiles(dir, acc = []) {
  */
 export function migrateCategoryBCorpus(projectRoot) {
     const root = resolve(projectRoot);
-    const vbriefDir = resolveLifecycleRoot(root);
+    let vbriefDir;
+    try {
+        vbriefDir = resolveLifecycleRoot(root);
+    }
+    catch {
+        // If xbrief/ layout is absent, fall back to vbrief/ for this pre-migration tool
+        // (category-b migration rewrites policy keys regardless of layout stage).
+        const legacyDir = join(root, "vbrief");
+        if (existsSync(legacyDir)) {
+            vbriefDir = legacyDir;
+        }
+        else {
+            return { scanned: 0, changed: [], conflicts: [] };
+        }
+    }
     let scanned = 0;
     const changed = [];
     const conflicts = [];

package/dist/codebase/default-extractor.js

@@ -101,7 +101,15 @@ function sourcePathRel(projectRoot, sourcePath) {
 }
 /** Return the authored codeStructure source path used by the default extractor. */
 export function defaultCodeStructurePath(projectRoot, codeStructurePath) {
-    return codeStructurePath ?? resolveProjectDefinitionPath(projectRoot);
+    if (codeStructurePath !== undefined)
+        return codeStructurePath;
+    try {
+        return resolveProjectDefinitionPath(projectRoot);
+    }
+    catch {
+        // No xbrief/ layout; return canonical path so callers get a predictable "not found" result.
+        return join(projectRoot, "xbrief", "PROJECT-DEFINITION.xbrief.json");
+    }
 }
 function stableId(value) {
     let slug = "";

package/dist/codebase/map.js

@@ -10,7 +10,7 @@ export const GENERATED_SENTINEL = "AUTO-GENERATED by task codebase:map";
 export const DEFAULT_OUTPUT_PATH = ".planning/codebase/MAP.md";
 export const BANNER_TEMPLATE = "<!-- AUTO-GENERATED by task codebase:map -- DO NOT EDIT MANUALLY -->\n" +
     "<!-- Purpose: generated codebase MAP projection -->\n" +
-    "<!-- Source of truth: vbrief/PROJECT-DEFINITION.vbrief.json " +
+    "<!-- Source of truth: xbrief/PROJECT-DEFINITION.xbrief.json " +
     "plan.architecture.codeStructure -->\n" +
     "<!-- Regenerate with: task codebase:map -->\n";
 export function markdownText(value) {

package/dist/deposit/copy-tree.js

@@ -7,12 +7,29 @@
  *
  * Refs #1942 S1, #1477.
  */
-import { createReadStream, createWriteStream } from "node:fs";
-import { chmod, lstat, mkdir, readdir, stat } from "node:fs/promises";
+import { constants } from "node:fs";
+import { lstat, mkdir, open, readdir, readFile, stat } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { pipeline } from "node:stream/promises";
 const DEFAULT_FILE_MODE = 0o644;
 const DEFAULT_DIR_MODE = 0o755;
+async function assertDestinationIsNotSymlink(path) {
+    try {
+        const info = await lstat(path);
+        if (info.isSymbolicLink()) {
+            throw new Error(`copyTree: refusing to write through destination symlink ${path}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.startsWith("copyTree: refusing")) {
+            throw err;
+        }
+        if (err.code === "ENOENT") {
+            // Missing paths are created by the caller; only pre-existing symlinks matter.
+            return;
+        }
+        throw err;
+    }
+}
 async function copyFilePreserveMode(src, dst) {
     let mode = DEFAULT_FILE_MODE;
     try {
@@ -23,12 +40,19 @@ async function copyFilePreserveMode(src, dst) {
         // Stat failure is non-fatal — fall back to 0o644 (mirrors Go copyFile).
     }
     await mkdir(dirname(dst), { recursive: true, mode: DEFAULT_DIR_MODE });
-    await pipeline(createReadStream(src), createWriteStream(dst, { mode }));
-    // createWriteStream mode applies on create; chmod ensures the final bits match
-    // the source even when the destination file already existed.
-    await chmod(dst, mode);
+    await assertDestinationIsNotSymlink(dst);
+    const handle = await open(dst, constants.O_WRONLY | constants.O_CREAT | constants.O_TRUNC | constants.O_NOFOLLOW, mode);
+    try {
+        await handle.writeFile(await readFile(src));
+        // Use the opened handle, not the path, so chmod cannot follow a swapped symlink.
+        await handle.chmod(mode);
+    }
+    finally {
+        await handle.close();
+    }
 }
 async function copyDirContents(src, dst) {
+    await assertDestinationIsNotSymlink(dst);
     await mkdir(dst, { recursive: true, mode: DEFAULT_DIR_MODE });
     const entries = await readdir(src, { withFileTypes: true });
     for (const entry of entries) {

package/dist/doctor/checks.d.ts

@@ -30,6 +30,15 @@ export declare function checkCanonicalVendoredNpmSignpost(projectRoot: string, s
  * deposit is still a working install, just an unpinned one.
  */
 export declare function checkManifestVersionReportable(projectRoot: string, installRoot: string | null, seams?: CheckSeams): CheckResult;
+/**
+ * #2206: check that the consumer `.gitignore` carries the canonical Deft baseline
+ * entries. Advisory (exit-exempt) because missing entries are an adoption risk, not
+ * a broken install.
+ *
+ * Skips when `.gitignore` is absent (greenfield project that has not yet run
+ * `directive init` or `directive update`).
+ */
+export declare function checkGitignoreCoverage(projectRoot: string, seams?: CheckSeams): CheckResult;
 export declare function deriveExitCode(checks: readonly CheckResult[], errors: readonly string[]): number;
 export declare function runChecksImpl(projectRoot: string, seams?: CheckSeams & {
     isDir?: (p: string) => boolean;

package/dist/doctor/checks.js

@@ -1,8 +1,10 @@
 import { join } from "node:path";
+import { CANONICAL_GITIGNORE_BASELINE } from "../init-deposit/gitignore.js";
 import { detectLegacyLayout, legacyLayoutSignpostLine, } from "../init-deposit/legacy-detect.js";
 import { detectCanonicalVendoredManifest, isNpmManaged, NPM_MANAGED_SENTINEL_KEY, NPM_MANAGED_SENTINEL_VALUE, } from "../init-deposit/migrate.js";
 import { resolveLifecycleRoot } from "../layout/resolve.js";
 import { findSkillPathsInText } from "../text/redos-safe.js";
+import { stripGitignoreInlineComment } from "../triage/bootstrap/gitignore.js";
 import { CANONICAL_UPGRADE_COMMAND, GO_BRIDGE_RELEASES_URL, UPGRADING_DOC_URL, } from "./constants.js";
 import { isDeprecationRedirectStub, locateManifest, manifestCandidatePaths, manifestReportableVersion, manifestTagToVersion, parseInstallManifest, parseInstallRootFromAgentsMd, parseManifest, } from "./manifest.js";
 import { readTextSafe } from "./paths.js";
@@ -127,10 +129,14 @@ export function checkManifestAgreement(projectRoot, installRoot, seams = {}) {
     const isFile = seams.isFile ?? ((p) => readText(p, seams) !== null);
     const manifestPath = locateManifest(projectRoot, installRoot, isFile);
     const expectedManifestPath = manifestPath ?? manifestCandidatePaths(projectRoot, installRoot)[0];
-    const bareCandidates = [
-        join(resolveLifecycleRoot(projectRoot), ".deft-version"),
-        join(projectRoot, ".deft-version"),
-    ];
+    let layoutRoot;
+    try {
+        layoutRoot = resolveLifecycleRoot(projectRoot);
+    }
+    catch {
+        layoutRoot = projectRoot; // No xbrief/ layout; fall back to project root for bare version check.
+    }
+    const bareCandidates = [join(layoutRoot, ".deft-version"), join(projectRoot, ".deft-version")];
     const barePath = bareCandidates.find((p) => isFile(p)) ?? null;
     const manifestText = manifestPath ? readText(manifestPath, seams) : null;
     const bareText = barePath ? readText(barePath, seams) : null;
@@ -436,8 +442,80 @@ export function checkManifestVersionReportable(projectRoot, installRoot, seams =
         data: { manifest_path: manifestPath, version: null, sha: null, source: reportable.source },
     };
 }
+/**
+ * Collect the normalised (inline-comment-stripped) gitignore patterns from a
+ * `.gitignore` file text. Uses the shared `stripGitignoreInlineComment` helper
+ * so coverage checks stay consistent with `ensureInitGitignoreLines`.
+ */
+function collectGitignorePresent(text) {
+    const present = new Set();
+    for (const raw of text.split("\n")) {
+        const line = stripGitignoreInlineComment(raw);
+        if (line)
+            present.add(line);
+    }
+    return present;
+}
+function gitignoreLineIsCovered(present, line) {
+    return present.has(line);
+}
+/**
+ * #2206: check that the consumer `.gitignore` carries the canonical Deft baseline
+ * entries. Advisory (exit-exempt) because missing entries are an adoption risk, not
+ * a broken install.
+ *
+ * Skips when `.gitignore` is absent (greenfield project that has not yet run
+ * `directive init` or `directive update`).
+ */
+export function checkGitignoreCoverage(projectRoot, seams = {}) {
+    const gitignorePath = join(projectRoot, ".gitignore");
+    const text = readText(gitignorePath, seams);
+    if (text === null) {
+        return {
+            name: "gitignore-coverage",
+            status: "skip",
+            detail: ".gitignore not found; run `directive init` or `directive update` to create it.",
+            data: { gitignore_path: gitignorePath, missing: [] },
+        };
+    }
+    const present = collectGitignorePresent(text);
+    const missing = [];
+    for (const line of CANONICAL_GITIGNORE_BASELINE) {
+        if (!gitignoreLineIsCovered(present, line)) {
+            missing.push(line);
+        }
+    }
+    // Check .deft/core/ separately — only required for hybrid/greenfield installs.
+    // We conservatively omit it from the missing list here (tracked-deposit projects
+    // legitimately omit it). The update path handles this correctly per layout.
+    if (missing.length === 0) {
+        return {
+            name: "gitignore-coverage",
+            status: "pass",
+            detail: "All canonical Deft .gitignore entries are present.",
+            data: { gitignore_path: gitignorePath, missing: [] },
+        };
+    }
+    return {
+        name: "gitignore-coverage",
+        status: "fail",
+        detail: `Deft .gitignore coverage incomplete: ${missing.length} canonical entr${missing.length === 1 ? "y" : "ies"} ` +
+            `missing (${missing.slice(0, 3).join(", ")}${missing.length > 3 ? ", …" : ""}). ` +
+            "Run `directive update` to add the missing entries (idempotent, safe on re-run). " +
+            `Full missing list: ${JSON.stringify(missing)}.`,
+        data: {
+            gitignore_path: gitignorePath,
+            missing,
+            suggested_fix: "directive update",
+        },
+    };
+}
 export function deriveExitCode(checks, errors) {
-    const exitExempt = new Set(["canonical-vendored-npm-signpost", "manifest-version-reportable"]);
+    const exitExempt = new Set([
+        "canonical-vendored-npm-signpost",
+        "manifest-version-reportable",
+        "gitignore-coverage",
+    ]);
     if (errors.length > 0 || checks.some((c) => c.status === "error")) {
         return 2;
     }
@@ -476,6 +554,7 @@ export function runChecksImpl(projectRoot, seams = {}) {
         checks.push(checkManifestVersionReportable(projectRoot, null, seams));
         checks.push(checkLegacyLayout(projectRoot, seams));
         checks.push(checkCanonicalVendoredNpmSignpost(projectRoot, seams));
+        checks.push(checkGitignoreCoverage(projectRoot, seams));
         return {
             projectRoot,
             installRoot: null,
@@ -491,6 +570,7 @@ export function runChecksImpl(projectRoot, seams = {}) {
     checks.push(checkInstallPathConsistency(projectRoot, installRoot, seams));
     checks.push(checkLegacyLayout(projectRoot, seams));
     checks.push(checkCanonicalVendoredNpmSignpost(projectRoot, seams));
+    checks.push(checkGitignoreCoverage(projectRoot, seams));
     return {
         projectRoot,
         installRoot,

package/dist/doctor/main.js

@@ -373,7 +373,8 @@ function runInstallIntegrityChecks(projectRoot, sink, addFinding, seams) {
             }
             if ((name === "legacy-layout" ||
                 name === "canonical-vendored-npm-signpost" ||
-                name === "manifest-version-reportable") &&
+                name === "manifest-version-reportable" ||
+                name === "gitignore-coverage") &&
                 status === "fail") {
                 sink.warn(`${name}: ${detail}`);
                 addFinding({

package/dist/eval/health.js

@@ -21,7 +21,13 @@ function isFrameworkSourceCheckout(projectRoot) {
     return existsSync(manifest) && existsSync(cliPkg);
 }
 function loadPlan(projectRoot) {
-    const filepath = resolveProjectDefinitionPath(projectRoot);
+    let filepath;
+    try {
+        filepath = resolveProjectDefinitionPath(projectRoot);
+    }
+    catch {
+        return null; // No xbrief/ layout; no project definition.
+    }
     if (!existsSync(filepath)) {
         return null;
     }

package/dist/eval/readback.js

@@ -28,7 +28,13 @@ function parseJsonObjectOrNull(text) {
     return null;
 }
 function readHealthHistoryRows(projectRoot) {
-    const path = healthHistoryPath(projectRoot);
+    let path;
+    try {
+        path = healthHistoryPath(projectRoot);
+    }
+    catch {
+        return []; // No xbrief/ layout; no health history.
+    }
     if (!existsSync(path)) {
         return [];
     }

package/dist/init-deposit/gitignore.js

@@ -44,7 +44,13 @@ export const CANONICAL_GITIGNORE_BASELINE = [
     "vbrief/*.lock",
     ".deft/core.bak-*/",
     ".deft/*.bak-*",
+    // xBRIEF-era migration-backup directories created by `deft migrate:xbrief` (#2206).
+    ".deft/xbrief-migrate-backup-*/",
     "*.premigrate.*",
+    // Generated version-eval results live under `.eval/results/` (NOT triage-cache)
+    // for both the legacy `vbrief/` tree and the post-#2034 `xbrief/` tree (#2206).
+    "vbrief/.eval/results/",
+    "xbrief/.eval/results/",
 ];
 const DEFT_FRAMEWORK_GITIGNORE_HEADER = "# Deft framework: ignore local-only caches and scratch directories\n";
 const DEFT_CORE_GITIGNORE_RATIONALE = "# Hybrid deposit (#1942): reconstituted by `directive init` like node_modules.\n" +

package/dist/init-deposit/hygiene.d.ts

@@ -17,6 +17,12 @@ export declare function installerManagedMatchers(): InstallerManagedMatcher[];
 export declare function installerManagedGuardEre(): string;
 export declare function isInstallerManagedPath(path: string): boolean;
 export interface FrameworkStagePathsOptions {
+    /**
+     * Include the vendored `.deft/core` payload in the stage set. Defaults to
+     * `true` for init and real payload swaps. No-op updates set this to `false`
+     * so CRLF-only core noise cannot be staged while safe projections are repaired.
+     */
+    readonly includeCore?: boolean;
     /**
      * Include the project-root ``Taskfile.yml`` in the stage set. Defaults to
      * ``false``: unlike the other allowlisted paths, ``Taskfile.yml`` is a
@@ -37,6 +43,30 @@ export declare function stageFrameworkPaths(projectDir: string, paths: readonly
     staged: boolean;
     error: Error | null;
 };
+/**
+ * Framework-internal subdirectories that are shipped as part of the source
+ * repository but are NOT included in the `@deftai/directive-content` npm
+ * package deposited into `.deft/core/`. If one of these paths survives from
+ * a prior git-vendored install, `deft update`'s additive file-swap will never
+ * remove it — causing the deposit-hygiene advisory to persist indefinitely.
+ *
+ * Each entry is a relative path within `.deft/core/`; presence in the CONTENT
+ * root overrides the prune (i.e. if the content package ever ships `packages/`
+ * again, we won't prune it).
+ *
+ * Refs #2347.
+ */
+export declare const STRAY_DEPOSIT_FRAMEWORK_PATHS: readonly ["packages"];
+export interface PruneStrayDepositPathsResult {
+    readonly pruned: string[];
+}
+/**
+ * Remove framework-source subdirectories from `.deft/core/` that are not
+ * present in the deposited content package (#2347). Silently skips any path
+ * that is also present in `contentRoot` (future-safe: if the content package
+ * ever ships `packages/` we stop pruning it).
+ */
+export declare function pruneStrayDepositPaths(deftDir: string, contentRoot: string, io: InitDepositIo): Promise<PruneStrayDepositPathsResult>;
 export declare const COMMIT_HYGIENE_BRANCH_NAME = "chore/deft-framework-upgrade";
 export declare function printCommitGuidance(io: InitDepositIo, paths: readonly string[], staged: boolean): void;
 export interface DepositStagePathsOptions extends StageFrameworkPathsSeams, FrameworkStagePathsOptions {

package/dist/init-deposit/hygiene.js

@@ -6,6 +6,7 @@
  */
 import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
+import { rm, stat } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { gitPorcelain } from "../story-ready/git.js";
 import { CANONICAL_INSTALL_ROOT } from "./constants.js";
@@ -81,7 +82,10 @@ export function frameworkStagePaths(projectDir, deftDir, options = {}) {
         paths.push(normalized);
     };
     const relDeft = relative(projectDir, deftDir);
-    if (relDeft && !relDeft.startsWith("..") && !relDeft.startsWith("/")) {
+    if (options.includeCore !== false &&
+        relDeft &&
+        !relDeft.startsWith("..") &&
+        !relDeft.startsWith("/")) {
         add(relDeft);
     }
     for (const matcher of installerManagedMatchers()) {
@@ -120,6 +124,60 @@ export function stageFrameworkPaths(projectDir, paths, seams = {}) {
         return { staged: false, error };
     }
 }
+/**
+ * Framework-internal subdirectories that are shipped as part of the source
+ * repository but are NOT included in the `@deftai/directive-content` npm
+ * package deposited into `.deft/core/`. If one of these paths survives from
+ * a prior git-vendored install, `deft update`'s additive file-swap will never
+ * remove it — causing the deposit-hygiene advisory to persist indefinitely.
+ *
+ * Each entry is a relative path within `.deft/core/`; presence in the CONTENT
+ * root overrides the prune (i.e. if the content package ever ships `packages/`
+ * again, we won't prune it).
+ *
+ * Refs #2347.
+ */
+export const STRAY_DEPOSIT_FRAMEWORK_PATHS = ["packages"];
+/**
+ * Remove framework-source subdirectories from `.deft/core/` that are not
+ * present in the deposited content package (#2347). Silently skips any path
+ * that is also present in `contentRoot` (future-safe: if the content package
+ * ever ships `packages/` we stop pruning it).
+ */
+export async function pruneStrayDepositPaths(deftDir, contentRoot, io) {
+    const pruned = [];
+    for (const rel of STRAY_DEPOSIT_FRAMEWORK_PATHS) {
+        const depositPath = join(deftDir, rel);
+        const contentPath = join(contentRoot, rel);
+        let isInDeposit = false;
+        let isInContent = false;
+        try {
+            isInDeposit = (await stat(depositPath)).isDirectory();
+        }
+        catch {
+            // absent — nothing to prune
+        }
+        if (!isInDeposit)
+            continue;
+        try {
+            isInContent = (await stat(contentPath)).isDirectory();
+        }
+        catch {
+            // not in content package — safe to prune
+        }
+        if (isInContent)
+            continue;
+        try {
+            await rm(depositPath, { recursive: true, force: true });
+            pruned.push(rel);
+            io.printf(`Pruned stray framework-source tree .deft/core/${rel}/ — not shipped by @deftai/directive-content (#2347).\n`);
+        }
+        catch (cause) {
+            io.printf(`Warning: could not prune .deft/core/${rel}/: ${String(cause)}\n`);
+        }
+    }
+    return { pruned };
+}
 export const COMMIT_HYGIENE_BRANCH_NAME = "chore/deft-framework-upgrade";
 export function printCommitGuidance(io, paths, staged) {
     if (paths.length === 0)
@@ -173,6 +231,7 @@ function actuallyStagedPaths(stagePaths, cachedNames) {
 export function depositStagePaths(projectDir, options = {}) {
     const deftDir = join(projectDir, CANONICAL_INSTALL_ROOT);
     const stagePaths = frameworkStagePaths(projectDir, deftDir, {
+        includeCore: options.includeCore,
         includeTaskfile: options.includeTaskfile ?? false,
     });
     const { staged } = stageFrameworkPaths(projectDir, stagePaths, options);

package/dist/init-deposit/refresh.d.ts

@@ -22,12 +22,15 @@ export interface RefreshDepositResult {
     readonly contentVersion: string;
     readonly engineVersion: string;
     readonly previousDepositVersion: string | null;
+    readonly alreadyCurrent: boolean;
+    readonly strategy: RefreshDepositStrategy;
     readonly agentsMdUpdated: boolean;
     readonly versionSkewNotice: string | null;
     readonly legacyLayout: boolean;
     readonly taskfileWired: boolean;
     readonly stagedPaths: string[];
 }
+export type RefreshDepositStrategy = "file-swap" | "no-op";
 export interface RefreshDepositSeams {
     resolveContentRoot?: () => Promise<string>;
     copyContent?: (src: string, dst: string) => Promise<void>;
@@ -35,6 +38,7 @@ export interface RefreshDepositSeams {
     readEngineVersion?: () => string;
     nowIso?: () => string;
     gitPorcelain?: (projectRoot: string) => string | null;
+    gitSemanticDiffNames?: GitSemanticDiffNames;
     detectLegacy?: (projectDir: string) => LegacyLayoutDetection;
     /**
      * #2266: `git ls-files` probe threaded into the non-destructive `.gitignore`
@@ -101,9 +105,19 @@ export declare function buildDefaultLadderFacts(projectDir: string, facts: Resol
  * manual npm/PATH steps (#2266 a3).
  */
 export declare function selfHealEngine(projectDir: string, facts: ResolutionFacts, io: InitDepositIo, seams?: SelfHealSeams): EngineResolution;
+export type GitSemanticDiffNames = (projectRoot: string, paths: readonly string[]) => readonly string[] | null;
+export interface FrameworkRefreshSideEffectsOptions {
+    readonly readPorcelain?: (root: string) => string | null;
+    readonly readSemanticDiffNames?: GitSemanticDiffNames;
+}
+export interface RefreshSideEffects {
+    readonly files: string[];
+    readonly crlfOnlyCoreFiles: string[];
+    readonly payloadSwapped?: boolean;
+}
 /** Framework-managed uncommitted paths after refresh (#1671). */
-export declare function frameworkRefreshSideEffects(projectDir: string, readPorcelain?: (root: string) => string | null): string[];
-export declare function printRefreshSideEffects(io: InitDepositIo, files: readonly string[]): void;
+export declare function frameworkRefreshSideEffects(projectDir: string, options?: FrameworkRefreshSideEffectsOptions): RefreshSideEffects;
+export declare function printRefreshSideEffects(io: InitDepositIo, effects: RefreshSideEffects): void;
 export declare function buildVersionSkewNotice(engineVersion: string, contentVersion: string, previousDepositVersion: string | null): string | null;
 export declare function buildUpdateSummaryJson(result: RefreshDepositResult, options: RefreshDepositArgs, updateState?: UpdateState): Record<string, unknown>;
 export declare function printUpdateComplete(result: RefreshDepositResult, io: InitDepositIo, updateState?: UpdateState): void;