@sdd-method/sdd-cli 0.9.0

package/dist/lib/sync/diff.js

@@ -0,0 +1,48 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export const PROTECTED_PREFIXES = ["content/"];
+export function findProtectedPaths(paths) {
+    return paths.filter((p) => PROTECTED_PREFIXES.some((prefix) => p.startsWith(prefix)));
+}
+export async function findMissingPayloadFiles(incomingPaths, payloadDir) {
+    const missing = [];
+    for (const p of incomingPaths) {
+        try {
+            await readFile(join(payloadDir, p));
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                missing.push(p);
+            else
+                throw err;
+        }
+    }
+    return missing;
+}
+export async function findConflicts(incomingPaths, payloadDir, targetRepo) {
+    const conflicts = [];
+    for (const p of incomingPaths) {
+        const targetPath = join(targetRepo, p);
+        let targetContent;
+        try {
+            targetContent = await readFile(targetPath);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                continue;
+            throw err;
+        }
+        const bundleContent = await readFile(join(payloadDir, p));
+        if (!targetContent.equals(bundleContent)) {
+            conflicts.push(p);
+        }
+    }
+    return conflicts;
+}
+export function computeRemovals(prevPaths, incomingPaths, options) {
+    if (options.noDelete)
+        return [];
+    const incoming = new Set(incomingPaths);
+    return prevPaths.filter((p) => !incoming.has(p));
+}
+//# sourceMappingURL=diff.js.map

package/dist/lib/sync/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/lib/sync/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,UAAU,CAAC,CAAC;AAElE,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxB,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAgC,EAChC,UAAkB;IAElB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;gBACjE,MAAM,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,aAAgC,EAChC,UAAkB,EAClB,UAAkB;IAElB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAA4B,EAC5B,aAAgC,EAChC,OAA8B;IAE9B,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/sync/index.d.ts

@@ -0,0 +1,17 @@
+export interface SyncOptions {
+    bundle: string;
+    targetRepo: string;
+    dryRun: boolean;
+    allowOverwrite: boolean;
+    delete: boolean;
+    /**
+     * When set, sync upserts the harness-specific hooks baseline per
+     * ADR 0129. Unset = CI-only baseline.
+     */
+    agentHarness?: "claude-code";
+}
+export interface SyncResult {
+    exitCode: number;
+}
+export declare function runSync(opts: SyncOptions, stdout?: (line: string) => void): Promise<SyncResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/index.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,OAAO,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA2C,GACpE,OAAO,CAAC,UAAU,CAAC,CAiMrB"}

package/dist/lib/sync/index.js

@@ -0,0 +1,184 @@
+import { createHash } from "node:crypto";
+import { access, readFile } from "node:fs/promises";
+import { loadBundle } from "../bundle.js";
+import { readLockFile, writeLockFile } from "../lock-file.js";
+import { REPO_KIND_FILE, profileFromBundleName, repoKindFromProfile, writeRepoKind, } from "../repo-kind.js";
+import { join } from "node:path";
+import { copyManagedFiles, removeManagedFiles } from "./apply.js";
+import { PROTECTED_PREFIXES, computeRemovals, findConflicts, findMissingPayloadFiles, findProtectedPaths, } from "./diff.js";
+import { syncMethodManagedSettings } from "./settings-merge.js";
+import { renderMethodManagedWorkflowBlock, renderMethodValidationWorkflow, WORKFLOW_REL_PATH, BLOCK_BEGIN, BLOCK_END, } from "../init/ci-workflow.js";
+import { detectBlockDrift, writeMarkedBlockFile, } from "./yaml-block-merge.js";
+const SECTION_RULE = "═".repeat(59);
+export async function runSync(opts, stdout = (line) => process.stdout.write(line)) {
+    if (!(await exists(opts.bundle))) {
+        stdout(fail(`Bundle not found: ${opts.bundle}`));
+        return { exitCode: 1 };
+    }
+    if (!(await exists(opts.targetRepo))) {
+        stdout(fail(`Target repo not found: ${opts.targetRepo}`));
+        return { exitCode: 1 };
+    }
+    stdout(section("Sync Method Baseline"));
+    const bundle = await loadBundle(opts.bundle);
+    try {
+        const missing = await findMissingPayloadFiles(bundle.managedPaths, bundle.payloadDir);
+        if (missing.length > 0) {
+            stdout(fail(`Missing payload file listed in MANAGED_PATHS.txt: ${missing[0]}`));
+            return { exitCode: 1 };
+        }
+        const protectedIncoming = findProtectedPaths(bundle.managedPaths);
+        if (protectedIncoming.length > 0) {
+            stdout(fail(`Incoming bundle attempts to manage protected product-owned path: ${protectedIncoming[0]}`));
+            stdout(fail(`Method baseline bundles must not manage files under: ${PROTECTED_PREFIXES.join(" ")}`));
+            return { exitCode: 1 };
+        }
+        const conflicts = await findConflicts(bundle.managedPaths, bundle.payloadDir, opts.targetRepo);
+        if (conflicts.length > 0 && !opts.allowOverwrite) {
+            stdout(fail(`Found ${conflicts.length} conflicting managed file(s). Re-run with --allow-overwrite to apply.`));
+            for (const p of conflicts)
+                stdout(`  - ${p}\n`);
+            return { exitCode: 1 };
+        }
+        const prevLock = await readLockFile(opts.targetRepo);
+        const prevPaths = prevLock?.managedPaths ?? [];
+        const protectedPrev = findProtectedPaths(prevPaths);
+        if (protectedPrev.length > 0) {
+            stdout(fail(`Existing lock file contains protected product-owned path: ${protectedPrev[0]}`));
+            stdout(fail("Resolve this manually before refreshing the method baseline."));
+            return { exitCode: 1 };
+        }
+        const removals = computeRemovals(prevPaths, bundle.managedPaths, {
+            noDelete: !opts.delete,
+        });
+        stdout(info(`Incoming managed files: ${bundle.managedPaths.length}`));
+        stdout(info(`Conflicts: ${conflicts.length}`));
+        stdout(info(`Removals from previous baseline: ${removals.length}`));
+        stdout(info(`Protected ownership prefixes: ${PROTECTED_PREFIXES.join(" ")}`));
+        if (opts.dryRun) {
+            stdout(info("Dry run enabled. No files modified."));
+            if (conflicts.length > 0) {
+                stdout(info("Conflicting files:"));
+                for (const p of conflicts)
+                    stdout(`  - ${p}\n`);
+            }
+            if (removals.length > 0) {
+                stdout(info("Files that would be removed:"));
+                for (const p of removals)
+                    stdout(`  - ${p}\n`);
+            }
+            return { exitCode: 0 };
+        }
+        const profile = profileFromBundleName(bundle.manifest.bundleName);
+        const repoKind = repoKindFromProfile(profile);
+        await copyManagedFiles(bundle.managedPaths, bundle.payloadDir, opts.targetRepo);
+        await removeManagedFiles(removals, opts.targetRepo);
+        await writeRepoKind(opts.targetRepo, repoKind);
+        const settingsResult = await syncMethodManagedSettings({
+            targetRepo: opts.targetRepo,
+            profile,
+            allowOverwrite: opts.allowOverwrite,
+            ...(opts.agentHarness ? { agentHarness: opts.agentHarness } : {}),
+        });
+        if (settingsResult.refused) {
+            const conflicts = [];
+            if (settingsResult.drifted.length > 0)
+                conflicts.push(`mcpServers: ${settingsResult.drifted.join(", ")}`);
+            if (settingsResult.hooksDrifted.length > 0)
+                conflicts.push(`hooks: ${settingsResult.hooksDrifted.join(", ")}`);
+            stdout(fail(`.claude/settings.json has adopter-modified method entries (${conflicts.join("; ")}). Re-run with --allow-overwrite to rewrite them.`));
+            return { exitCode: 1 };
+        }
+        if (settingsResult.wroteFile) {
+            const labels = [];
+            if (settingsResult.added.length > 0)
+                labels.push(`mcp added: ${settingsResult.added.join(", ")}`);
+            if (settingsResult.updated.length > 0)
+                labels.push(`mcp updated: ${settingsResult.updated.join(", ")}`);
+            if (settingsResult.hooksChangedEvents.length > 0)
+                labels.push(`hooks: ${settingsResult.hooksChangedEvents.join(", ")}`);
+            stdout(info(`Refreshed ${settingsResult.path} (${labels.join("; ") || "no changes"}).`));
+        }
+        const workflowBlock = renderMethodManagedWorkflowBlock(profile);
+        const workflowAbsPath = join(opts.targetRepo, WORKFLOW_REL_PATH);
+        const existingWorkflow = await tryReadFile(workflowAbsPath);
+        const blockDrifted = existingWorkflow !== null &&
+            detectBlockDrift(existingWorkflow, workflowBlock, {
+                begin: BLOCK_BEGIN,
+                end: BLOCK_END,
+            });
+        if (blockDrifted && !opts.allowOverwrite) {
+            stdout(fail(`${WORKFLOW_REL_PATH} has adopter edits inside the method-managed block. Re-run with --allow-overwrite to refresh, or revert the in-block changes.`));
+            return { exitCode: 1 };
+        }
+        // When the target file doesn't exist at all, seed with the full
+        // template (block + adopter footer). When it exists, write the
+        // block only — writeMarkedBlockFile preserves adopter content
+        // around the markers.
+        const incoming = existingWorkflow === null
+            ? renderMethodValidationWorkflow(profile)
+            : workflowBlock;
+        const workflowResult = await writeMarkedBlockFile(workflowAbsPath, incoming, { begin: BLOCK_BEGIN, end: BLOCK_END }, opts.allowOverwrite);
+        if (workflowResult.refused) {
+            stdout(fail(`${WORKFLOW_REL_PATH} exists without method-managed markers — refusing to overwrite adopter content. Re-run with --allow-overwrite to replace the file.`));
+            return { exitCode: 1 };
+        }
+        if (workflowResult.changed) {
+            stdout(info(`Refreshed ${WORKFLOW_REL_PATH}.`));
+        }
+        const bundleSha = await sha256File(opts.bundle);
+        await writeLockFile(opts.targetRepo, {
+            methodRepo: "sdd-method",
+            bundleVersion: bundle.manifest.bundleVersion,
+            sourceCommit: bundle.manifest.sourceCommit,
+            bundleSha256: bundleSha,
+            syncedAtUtc: nowUtcIso(),
+            managedPaths: [...bundle.managedPaths],
+        });
+        stdout(pass(`Method baseline synced to: ${opts.targetRepo}`));
+        stdout(info("Updated lock file: method-baseline.lock"));
+        stdout(info(`Set repo kind marker: ${REPO_KIND_FILE} = ${repoKind}`));
+        return { exitCode: 0 };
+    }
+    finally {
+        await bundle.cleanup();
+    }
+}
+function section(title) {
+    return `\n${SECTION_RULE}\n  ${title}\n${SECTION_RULE}\n\n`;
+}
+function info(msg) {
+    return `[INFO] ${msg}\n`;
+}
+function pass(msg) {
+    return `[PASS] ${msg}\n`;
+}
+function fail(msg) {
+    return `[FAIL] ${msg}\n`;
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function tryReadFile(path) {
+    try {
+        await access(path);
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+async function sha256File(path) {
+    const buf = await readFile(path);
+    return createHash("sha256").update(buf).digest("hex");
+}
+function nowUtcIso() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/sync/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/sync/settings-merge.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `.claude/settings.json` merge pass during `sdd-cli sync`. Method-
+ * managed `mcpServers` entries (see src/lib/mcp-seed/) get upserted;
+ * any adopter-added entries or other top-level keys are preserved.
+ *
+ * The file cannot ship in the method baseline bundle because it
+ * carries per-adopter absolute paths. That's why this is a separate
+ * sync step, outside the bundle-driven `copyManagedFiles` path.
+ *
+ * Conflict handling mirrors ADR 0114: if the adopter has manually
+ * modified a method-owned entry, sync refuses unless
+ * `--allow-overwrite` is passed.
+ */
+import type { HookEventName } from "../hooks-seed/index.js";
+import type { Profile } from "../repo-kind.js";
+export interface SettingsMergeOptions {
+    readonly targetRepo: string;
+    readonly profile: Profile;
+    readonly allowOverwrite: boolean;
+    /** When set, also upsert the harness-specific hooks baseline. */
+    readonly agentHarness?: "claude-code";
+}
+export interface SettingsMergeResult {
+    /** `.claude/settings.json` relative path; echoed for logging. */
+    readonly path: string;
+    /** Method-managed ids that drifted from the seed before this sync. */
+    readonly drifted: readonly string[];
+    /** Ids added by this run (not previously present). */
+    readonly added: readonly string[];
+    /** Ids updated by this run (previously present but different). */
+    readonly updated: readonly string[];
+    /** Ids unchanged. */
+    readonly unchanged: readonly string[];
+    /** Hook events touched by this run (empty when hooks layer skipped). */
+    readonly hooksChangedEvents: readonly HookEventName[];
+    /** Hook events where adopter drift was detected. */
+    readonly hooksDrifted: readonly HookEventName[];
+    /** Whether the file was written. */
+    readonly wroteFile: boolean;
+    /** Set when drift exists and --allow-overwrite was not passed. */
+    readonly refused: boolean;
+}
+export declare const SETTINGS_REL_PATH = ".claude/settings.json";
+export declare function syncMethodManagedSettings(opts: SettingsMergeOptions): Promise<SettingsMergeResult>;
+//# sourceMappingURL=settings-merge.d.ts.map

package/dist/lib/sync/settings-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/settings-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,SAAS,aAAa,EAAE,CAAC;IACtD,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AAEzD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA2E9B"}

package/dist/lib/sync/settings-merge.js

@@ -0,0 +1,109 @@
+/**
+ * `.claude/settings.json` merge pass during `sdd-cli sync`. Method-
+ * managed `mcpServers` entries (see src/lib/mcp-seed/) get upserted;
+ * any adopter-added entries or other top-level keys are preserved.
+ *
+ * The file cannot ship in the method baseline bundle because it
+ * carries per-adopter absolute paths. That's why this is a separate
+ * sync step, outside the bundle-driven `copyManagedFiles` path.
+ *
+ * Conflict handling mirrors ADR 0114: if the adopter has manually
+ * modified a method-owned entry, sync refuses unless
+ * `--allow-overwrite` is passed.
+ */
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { buildMethodManagedServers, detectManagedDrift, upsertMethodManagedServers, } from "../mcp-seed/index.js";
+import { buildMethodManagedHooks, detectHooksDrift, upsertMethodManagedHooks, } from "../hooks-seed/index.js";
+export const SETTINGS_REL_PATH = ".claude/settings.json";
+export async function syncMethodManagedSettings(opts) {
+    const absPath = join(opts.targetRepo, SETTINGS_REL_PATH);
+    const existing = await readSettings(absPath);
+    const owned = buildMethodManagedServers(
+    // Only platform profile gets an explicit SDD_REPO_PATH — for
+    // platform the target repo IS the SDD. App/integration leave it
+    // empty so the adopter configures their sibling platform SDD
+    // manually (see docs/method/onboarding/mcp-harness-setup.md).
+    opts.profile === "platform" ? { sddRepoPath: opts.targetRepo } : {});
+    const drifted = detectManagedDrift(existing, owned);
+    const hooksActive = opts.agentHarness === "claude-code";
+    const ownedHooks = hooksActive ? buildMethodManagedHooks() : undefined;
+    const hooksDrifted = hooksActive && ownedHooks
+        ? detectHooksDrift(existing, ownedHooks)
+        : [];
+    if ((drifted.length > 0 || hooksDrifted.length > 0) && !opts.allowOverwrite) {
+        return {
+            path: SETTINGS_REL_PATH,
+            drifted,
+            added: [],
+            updated: [],
+            unchanged: [],
+            hooksChangedEvents: [],
+            hooksDrifted,
+            wroteFile: false,
+            refused: true,
+        };
+    }
+    const mcpResult = upsertMethodManagedServers(existing, owned);
+    let nextSettings = mcpResult.settings;
+    let hooksChangedEvents = [];
+    if (hooksActive && ownedHooks) {
+        const hooksResult = upsertMethodManagedHooks(nextSettings, ownedHooks);
+        nextSettings = hooksResult.settings;
+        hooksChangedEvents = [...hooksResult.changedEvents];
+    }
+    const changed = mcpResult.changed || hooksChangedEvents.length > 0;
+    if (!changed) {
+        return {
+            path: SETTINGS_REL_PATH,
+            drifted,
+            added: mcpResult.added,
+            updated: mcpResult.updated,
+            unchanged: mcpResult.unchanged,
+            hooksChangedEvents: [],
+            hooksDrifted,
+            wroteFile: false,
+            refused: false,
+        };
+    }
+    await mkdir(dirname(absPath), { recursive: true });
+    await writeFile(absPath, JSON.stringify(nextSettings, null, 2) + "\n", "utf8");
+    return {
+        path: SETTINGS_REL_PATH,
+        drifted,
+        added: mcpResult.added,
+        updated: mcpResult.updated,
+        unchanged: mcpResult.unchanged,
+        hooksChangedEvents,
+        hooksDrifted,
+        wroteFile: true,
+        refused: false,
+    };
+}
+async function readSettings(absPath) {
+    if (!(await fileExists(absPath)))
+        return {};
+    const raw = await readFile(absPath, "utf8");
+    if (raw.trim().length === 0)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* fall through — treat malformed as empty so we at least seed method content */
+    }
+    return {};
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=settings-merge.js.map

package/dist/lib/sync/settings-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.js","sourceRoot":"","sources":["../../../src/lib/sync/settings-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAiChC,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA0B;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,yBAAyB;IACrC,6DAA6D;IAC7D,gEAAgE;IAChE,6DAA6D;IAC7D,8DAA8D;IAC9D,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CACpE,CAAC;IAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEpD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,KAAK,aAAa,CAAC;IACxD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,YAAY,GAChB,WAAW,IAAI,UAAU;QACvB,CAAC,CAAC,gBAAgB,CAAC,QAA6B,EAAE,UAAU,CAAC;QAC7D,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5E,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,OAAO;YACP,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,kBAAkB,EAAE,EAAE;YACtB,YAAY;YACZ,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,YAAY,GAAmB,SAAS,CAAC,QAAQ,CAAC;IACtD,IAAI,kBAAkB,GAAoB,EAAE,CAAC;IAC7C,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,wBAAwB,CAC1C,YAAiC,EACjC,UAAU,CACX,CAAC;QACF,YAAY,GAAG,WAAW,CAAC,QAA0B,CAAC;QACtD,kBAAkB,GAAG,CAAC,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,iBAAiB;YACvB,OAAO;YACP,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,kBAAkB,EAAE,EAAE;YACtB,YAAY;YACZ,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,OAAO;QACP,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,kBAAkB;QAClB,YAAY;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAe;IACzC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAwB,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;IAClF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/sync/source-tag.d.ts

@@ -0,0 +1,5 @@
+export declare function isAdrPath(managedPath: string): boolean;
+export declare function ensureSourceTag(content: string, tag: string): string;
+export declare function stripSourceTag(content: string): string;
+export declare function contentForCompare(managedPath: string, content: string): string;
+//# sourceMappingURL=source-tag.d.ts.map

package/dist/lib/sync/source-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-tag.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/source-tag.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/lib/sync/source-tag.js

@@ -0,0 +1,34 @@
+const SOURCE_LINE_PREFIX = "* **Source:** ";
+const STATUS_LINE_PREFIX = "* **Status:** ";
+export function isAdrPath(managedPath) {
+    return (managedPath.startsWith("docs/platform/adr/") ||
+        managedPath.startsWith("docs/method/adr/"));
+}
+export function ensureSourceTag(content, tag) {
+    if (content.split("\n").some((line) => line.startsWith(SOURCE_LINE_PREFIX))) {
+        return content;
+    }
+    if (!content.split("\n").some((line) => line.startsWith(STATUS_LINE_PREFIX))) {
+        return content;
+    }
+    const out = [];
+    let inserted = false;
+    for (const line of content.split("\n")) {
+        out.push(line);
+        if (!inserted && line.startsWith(STATUS_LINE_PREFIX)) {
+            out.push(`${SOURCE_LINE_PREFIX}${tag}`);
+            inserted = true;
+        }
+    }
+    return out.join("\n");
+}
+export function stripSourceTag(content) {
+    return content
+        .split("\n")
+        .filter((line) => !line.startsWith(SOURCE_LINE_PREFIX))
+        .join("\n");
+}
+export function contentForCompare(managedPath, content) {
+    return isAdrPath(managedPath) ? stripSourceTag(content) : content;
+}
+//# sourceMappingURL=source-tag.js.map

package/dist/lib/sync/source-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-tag.js","sourceRoot":"","sources":["../../../src/lib/sync/source-tag.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,CACL,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC;QAC5C,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAW;IAC1D,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,GAAG,kBAAkB,GAAG,GAAG,EAAE,CAAC,CAAC;YACxC,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;SACtD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,OAAe;IAEf,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpE,CAAC"}

package/dist/lib/sync/yaml-block-merge.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Merge-aware write for files with `# method-managed: begin/end`
+ * markers. The method block is replaced; content outside the block
+ * (including content above a lone trailing block, or below it, or
+ * both) is preserved verbatim.
+ *
+ * Conflict model (per ADR 0114, narrowed to block scope):
+ *  - If the existing file has no markers, treat it as adopter-authored.
+ *    Refuse to replace unless `allowOverwrite` is true.
+ *  - If the existing file has markers, upsert the block. Lines outside
+ *    the markers survive unchanged.
+ *  - Drift inside the block does not block here — callers compare the
+ *    in-block slice to the incoming slice separately if they need
+ *    refuse-on-drift semantics (see `detectBlockDrift`).
+ */
+export interface BlockMarkers {
+    readonly begin: string;
+    readonly end: string;
+}
+export interface BlockMergeResult {
+    /** Serialised output that should be written to disk. */
+    readonly output: string;
+    /** True if input lacked markers and `allowOverwrite` was false. */
+    readonly refused: boolean;
+    /** True if the output differs from the existing file. */
+    readonly changed: boolean;
+    /** The extracted pre-block and post-block adopter content (for debug). */
+    readonly preAdopter: string;
+    readonly postAdopter: string;
+}
+export interface MergeBlockOptions {
+    readonly existing: string | null;
+    readonly incomingBlock: string;
+    readonly markers: BlockMarkers;
+    readonly allowOverwrite: boolean;
+}
+export declare function mergeMarkedBlock(opts: MergeBlockOptions): BlockMergeResult;
+/**
+ * Detect whether the method block in `existing` differs from the
+ * incoming block. Returns true if the adopter has edited inside the
+ * markers (drift); false if no markers, exact match, or no file.
+ * Callers use this to implement refuse-on-drift policy where desired.
+ */
+export declare function detectBlockDrift(existing: string | null, incomingBlock: string, markers: BlockMarkers): boolean;
+/**
+ * Apply the merge and write the result to disk. Creates the target
+ * directory if absent.
+ */
+export declare function writeMarkedBlockFile(absPath: string, incomingBlock: string, markers: BlockMarkers, allowOverwrite: boolean): Promise<BlockMergeResult>;
+//# sourceMappingURL=yaml-block-merge.d.ts.map

package/dist/lib/sync/yaml-block-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-block-merge.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/yaml-block-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CA2D1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAa3B"}