@nestledjs/upgrades 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @nestledjs/upgrades
+
+`nestled-update` — apply Nestled template upgrades to a cloned project.
+
+A project created from `nestled-template` uses this package to pull published
+upgrades from its channel and apply them, tracking what it has already received
+in `.nestled/upgrade-log.yaml`. Note **authoring** stays private (only the
+template maintainer produces upgrades); every clone only ever consumes.
+
+## Model
+
+- **Manifest** — the published feed: an ordered list of releases plus a pointer
+  per channel (`canary`, `stable`). A clone on channel `C` applies every release
+  with `baseline < release.id <= channels[C]`. Canary points ahead of stable, so
+  the maintainer's fleet validates a release before the world sees it.
+- **Baseline** — each clone remembers the release it started from. Fresh clones
+  read it from a committed `.nestled/template-version` stamp; `nestled-update
+  init` records it, and each apply advances it.
+
+See `docs/DISTRIBUTION-SPEC.md` in the nestled-upgrader repo for the full design.
+
+## CLI
+
+```bash
+nestled-update init      # establish this clone's baseline + channel
+nestled-update check     # show pending upgrades (no changes)
+nestled-update status    # show channel, baseline, applied history
+nestled-update apply     # apply pending upgrades
+```
+
+## How it reads the feed
+
+The feed lives in the public `nestled-template` repo under `.nestled-upgrades/`
+(`manifest.yaml` + `patches/*.diff`). `nestled-update` adds the template as an
+upstream remote, `git fetch`es the feed ref, and reads the manifest + patches
+via `git show` — no working checkout of the template. For local development/
+testing, `--manifest <file>` reads a manifest off disk instead.
+
+Configure the feed once at init:
+
+```bash
+nestled-update init --remote <template-git-url> --ref develop --channel stable
+```
+
+## Status
+
+- **Phase 1** — manifest schema, baseline stamp, channel-aware pending, and
+  `init` / `check` / `status`.
+- **Phase 2** — real `apply`: git-fetch feed transport, branch per run, 3-way
+  patch application, `package-release` version bumps, verification gating with
+  clean rollback on failure, baseline advancement, and optional `--pr`.
+
+Still to come (producer side, in the private repo): the `publish` /
+`promote-release` / `baseline-fleet` commands that write releases into the
+template feed and move channel pointers.

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@nestledjs/upgrades",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "description": "Consume and apply Nestled template upgrades in a cloned project (nestled-update).",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "bin": {
+    "nestled-update": "src/bin/nestled-update.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tslib": "^2.6.0",
+    "yaml": "^2.8.0"
+  }
+}

package/src/bin/nestled-update.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/bin/nestled-update.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../lib/cli");
+process.exit((0, cli_1.run)(process.argv.slice(2)));
+//# sourceMappingURL=nestled-update.js.map

package/src/bin/nestled-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestled-update.js","sourceRoot":"","sources":["../../../../upgrades/src/bin/nestled-update.ts"],"names":[],"mappings":";;;AACA,oCAAiC;AAEjC,OAAO,CAAC,IAAI,CAAC,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from './lib/manifest';
+export * from './lib/baseline';
+export * from './lib/pending';
+export * from './lib/git';
+export * from './lib/feed';
+export * from './lib/apply';
+export { run } from './lib/cli';

package/src/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/manifest"), exports);
+tslib_1.__exportStar(require("./lib/baseline"), exports);
+tslib_1.__exportStar(require("./lib/pending"), exports);
+tslib_1.__exportStar(require("./lib/git"), exports);
+tslib_1.__exportStar(require("./lib/feed"), exports);
+tslib_1.__exportStar(require("./lib/apply"), exports);
+var cli_1 = require("./lib/cli");
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return cli_1.run; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../upgrades/src/index.ts"],"names":[],"mappings":";;;;AAAA,yDAA+B;AAC/B,yDAA+B;AAC/B,wDAA8B;AAC9B,oDAA0B;AAC1B,qDAA2B;AAC3B,sDAA4B;AAC5B,iCAAgC;AAAvB,0FAAA,GAAG,OAAA"}

package/src/lib/apply.d.ts

@@ -0,0 +1,52 @@
+import { ResolveFeedOptions } from './feed';
+import { PrResult } from './git';
+export type RunStatus = 'up-to-date' | 'applied' | 'blocked' | 'verification-failed';
+export interface AppliedNote {
+    id: string;
+    title: string;
+    delivery: string;
+    via3way?: boolean;
+    alreadyApplied?: boolean;
+    packageUpdated?: {
+        manifest: string;
+        name: string;
+        version: string;
+    }[];
+}
+export interface BlockedInfo {
+    id: string;
+    reason: string;
+    output?: string;
+}
+export interface VerificationResult {
+    command: string;
+    status: number;
+    output: string;
+    error: string;
+}
+export interface ApplyRunResult {
+    status: RunStatus;
+    channel: string;
+    branch?: string;
+    applied: AppliedNote[];
+    blocked?: BlockedInfo;
+    verification?: VerificationResult[];
+    baselineRelease?: string;
+    pr?: PrResult;
+}
+export interface ApplyOptions extends ResolveFeedOptions {
+    allowDirty?: boolean;
+    autoPR?: boolean;
+    verification?: string[];
+    forkedAreas?: string[];
+    defaultBranch?: string;
+}
+/**
+ * Apply every pending upgrade for this clone's channel, all-or-nothing per run:
+ * notes are applied and committed one at a time onto a dedicated branch; the
+ * first note that cannot be applied cleanly, or a failing verification run,
+ * rolls the branch back to where it started and records the blocker for manual
+ * adaptation. On success, per-note outcomes are recorded and the baseline is
+ * advanced across every fully-completed release.
+ */
+export declare function applyRun(projectDir: string, options?: ApplyOptions): ApplyRunResult;

package/src/lib/apply.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRun = applyRun;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const manifest_1 = require("./manifest");
+const baseline_1 = require("./baseline");
+const pending_1 = require("./pending");
+const feed_1 = require("./feed");
+const git_1 = require("./git");
+/** A patch must never touch our own bookkeeping. */
+const PATCH_EXCLUDES = ['.nestled/**'];
+function includesPackage(note) {
+    return note.delivery === 'package-release' || note.delivery === 'hybrid';
+}
+function includesPatch(note) {
+    return !note.delivery || note.delivery === 'code-patch' || note.delivery === 'hybrid';
+}
+function tryApplyPatch(cwd, diffText) {
+    const excludeArgs = PATCH_EXCLUDES.map((pattern) => `--exclude=${pattern}`);
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'nestled-upd-'));
+    const file = (0, node_path_1.join)(dir, 'change.diff');
+    (0, node_fs_1.writeFileSync)(file, diffText, 'utf8');
+    try {
+        const check = (0, git_1.git)(cwd, ['apply', ...excludeArgs, '--check', file]);
+        if (check.status !== 0) {
+            const reverse = (0, git_1.git)(cwd, ['apply', ...excludeArgs, '--reverse', '--check', file]);
+            if (reverse.status === 0)
+                return { applied: false, alreadyApplied: true };
+            const threeWay = (0, git_1.git)(cwd, ['apply', '--3way', ...excludeArgs, file]);
+            if (threeWay.status === 0)
+                return { applied: true, via3way: true };
+            // 3-way may have left partial state on this (uncommitted) note only.
+            (0, git_1.git)(cwd, ['checkout', '--', '.']);
+            return { applied: false, output: check.stderr || check.stdout };
+        }
+        const apply = (0, git_1.git)(cwd, ['apply', ...excludeArgs, file]);
+        return { applied: apply.status === 0, output: apply.stderr || apply.stdout };
+    }
+    finally {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+}
+function safeReadPackageJson(filePath) {
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function walkPackageJson(dir, result) {
+    for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name === '.git')
+            continue;
+        const absolute = (0, node_path_1.join)(dir, entry.name);
+        if (entry.isDirectory())
+            walkPackageJson(absolute, result);
+        else if (entry.name === 'package.json')
+            result.push(absolute);
+    }
+}
+function findPackageManifests(cwd, releases) {
+    const explicit = releases.flatMap((release) => { var _a; return (_a = release.manifests) !== null && _a !== void 0 ? _a : []; });
+    if (explicit.length) {
+        return explicit.map((manifest) => (0, node_path_1.join)(cwd, manifest)).filter((manifest) => (0, node_fs_1.existsSync)(manifest));
+    }
+    const result = [];
+    walkPackageJson(cwd, result);
+    return result;
+}
+function verifyPublishedPackage(name, version) {
+    var _a, _b;
+    if (!name || !version)
+        return false;
+    const result = (0, node_child_process_1.spawnSync)('npm', ['view', `${name}@${version}`, 'version', '--json'], { encoding: 'utf8' });
+    return ((_a = result.status) !== null && _a !== void 0 ? _a : 1) === 0 && ((_b = result.stdout) !== null && _b !== void 0 ? _b : '').trim() !== '';
+}
+function packageManagerInstall(cwd) {
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'pnpm-lock.yaml')))
+        return ['pnpm', 'install'];
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'yarn.lock')))
+        return ['yarn', 'install'];
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'package-lock.json')))
+        return ['npm', 'install'];
+    return null;
+}
+function updateLockfile(cwd) {
+    var _a, _b;
+    const command = packageManagerInstall(cwd);
+    if (!command)
+        return { status: 0, reason: 'No package manager lockfile detected.' };
+    const result = (0, node_child_process_1.spawnSync)(command[0], command.slice(1), { cwd, encoding: 'utf8' });
+    return {
+        status: (_a = result.status) !== null && _a !== void 0 ? _a : 1,
+        reason: ((_b = result.status) !== null && _b !== void 0 ? _b : 1) === 0 ? 'Lockfile updated.' : result.stderr || result.stdout || 'Install failed.',
+    };
+}
+function applyPackageReleases(cwd, note) {
+    var _a, _b, _c, _d, _e;
+    const releases = (_a = note.packageReleases) !== null && _a !== void 0 ? _a : [];
+    if (releases.some((release) => !release.targetVersion && !release.versionRange)) {
+        return { status: 'blocked', reason: 'Package release is missing targetVersion and versionRange (pending release).' };
+    }
+    for (const release of releases) {
+        const version = (_b = release.targetVersion) !== null && _b !== void 0 ? _b : release.versionRange;
+        if (!verifyPublishedPackage(release.name, version)) {
+            return { status: 'blocked', reason: `Cannot verify published version for ${release.name}@${version}.` };
+        }
+    }
+    const manifests = findPackageManifests(cwd, releases);
+    const updated = [];
+    for (const manifestPath of manifests) {
+        const pkg = safeReadPackageJson(manifestPath);
+        if (!pkg)
+            continue;
+        let changed = false;
+        for (const release of releases) {
+            const version = (_d = (_c = release.versionRange) !== null && _c !== void 0 ? _c : release.targetVersion) !== null && _d !== void 0 ? _d : '';
+            for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+                if ((_e = pkg[field]) === null || _e === void 0 ? void 0 : _e[release.name]) {
+                    pkg[field][release.name] = version;
+                    updated.push({ manifest: (0, node_path_1.relative)(cwd, manifestPath), name: release.name, version });
+                    changed = true;
+                }
+            }
+        }
+        if (changed)
+            (0, node_fs_1.writeFileSync)(manifestPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    }
+    if (updated.length === 0) {
+        const names = releases.map((r) => r.name).join(', ') || 'the referenced packages';
+        return { status: 'not-applicable', reason: `Project does not consume ${names}.` };
+    }
+    const lockfile = updateLockfile(cwd);
+    return { status: lockfile.status === 0 ? 'applied' : 'blocked', reason: lockfile.reason, updated };
+}
+function detectPackageManager(cwd) {
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'yarn.lock')))
+        return 'yarn';
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'package-lock.json')))
+        return 'npm';
+    return 'pnpm';
+}
+function inferVerification(cwd) {
+    var _a;
+    const pkg = safeReadPackageJson((0, node_path_1.join)(cwd, 'package.json'));
+    if (!pkg)
+        return [];
+    const pm = detectPackageManager(cwd);
+    const scripts = (_a = pkg.scripts) !== null && _a !== void 0 ? _a : {};
+    const commands = [];
+    if (scripts.lint)
+        commands.push(`${pm} lint`);
+    if (scripts.test)
+        commands.push(`${pm} test`);
+    return commands;
+}
+function runVerification(cwd, commands) {
+    return commands.map((command) => {
+        var _a, _b, _c;
+        const result = (0, node_child_process_1.spawnSync)(command, { cwd, shell: true, encoding: 'utf8' });
+        return { command, status: (_a = result.status) !== null && _a !== void 0 ? _a : 1, output: (_b = result.stdout) !== null && _b !== void 0 ? _b : '', error: (_c = result.stderr) !== null && _c !== void 0 ? _c : '' };
+    });
+}
+function releasesForBaseline(manifest, pending) {
+    return manifest.releases
+        .filter((release) => {
+        const aboveBaseline = !pending.baseline || (0, manifest_1.compareReleaseId)(release.id, pending.baseline) > 0;
+        const withinCeiling = !pending.ceiling || (0, manifest_1.compareReleaseId)(release.id, pending.ceiling) <= 0;
+        return aboveBaseline && withinCeiling;
+    })
+        .sort((a, b) => (0, manifest_1.compareReleaseId)(a.id, b.id))
+        .map((release) => {
+        var _a;
+        return ({
+            id: release.id,
+            templateCommit: release.templateCommit,
+            noteIds: ((_a = release.notes) !== null && _a !== void 0 ? _a : []).map((note) => note.id),
+        });
+    });
+}
+function prBody(applied, channel, ceiling) {
+    const lines = applied.map((note) => `- ${note.id} — ${note.title}`);
+    return [
+        '## Nestled upgrades',
+        '',
+        `Channel: ${channel}${ceiling ? ` (up to ${ceiling})` : ''}`,
+        '',
+        ...lines,
+        '',
+        '🤖 Applied by nestled-update',
+    ].join('\n');
+}
+/**
+ * Apply every pending upgrade for this clone's channel, all-or-nothing per run:
+ * notes are applied and committed one at a time onto a dedicated branch; the
+ * first note that cannot be applied cleanly, or a failing verification run,
+ * rolls the branch back to where it started and records the blocker for manual
+ * adaptation. On success, per-note outcomes are recorded and the baseline is
+ * advanced across every fully-completed release.
+ */
+function applyRun(projectDir, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const config = (0, baseline_1.readSiteConfig)(projectDir);
+    const log = (0, baseline_1.readUpgradeLog)(projectDir);
+    (_a = log.upgrades) !== null && _a !== void 0 ? _a : (log.upgrades = {});
+    const channel = log.template.channel || baseline_1.DEFAULT_CHANNEL;
+    const feed = (0, feed_1.resolveFeed)(projectDir, log, options);
+    const pending = (0, pending_1.computePending)(feed.manifest, log);
+    if (pending.notes.length === 0) {
+        return { status: 'up-to-date', channel, applied: [], baselineRelease: log.template.baselineRelease };
+    }
+    if (!(0, git_1.isGitRepo)(projectDir)) {
+        throw new Error('Project is not a git repository; cannot create an upgrade branch.');
+    }
+    const startedClean = !(0, git_1.hasUncommittedChanges)(projectDir);
+    if (!startedClean && !options.allowDirty) {
+        throw new Error('Project has uncommitted changes. Commit them, or re-run with --allow-dirty.');
+    }
+    const branch = `nestled-update/${channel}-${pending.ceiling}`;
+    (0, git_1.checkoutBranch)(projectDir, branch);
+    const startCommit = (0, git_1.gitOutput)(projectDir, ['rev-parse', 'HEAD']);
+    const forked = new Set((_c = (_b = options.forkedAreas) !== null && _b !== void 0 ? _b : config.forkedAreas) !== null && _c !== void 0 ? _c : []);
+    const rollback = () => {
+        if (startedClean && startCommit)
+            (0, git_1.git)(projectDir, ['reset', '--hard', startCommit]);
+        else
+            (0, git_1.git)(projectDir, ['checkout', '--', '.']);
+    };
+    const applied = [];
+    let blocked = null;
+    for (const note of pending.notes) {
+        if (note.area && forked.has(note.area)) {
+            blocked = { id: note.id, reason: `Area "${note.area}" is marked forked; review intent before applying.` };
+            break;
+        }
+        const entry = { id: note.id, title: note.title, delivery: note.delivery };
+        if (includesPackage(note)) {
+            const result = applyPackageReleases(projectDir, note);
+            if (result.status === 'blocked') {
+                blocked = { id: note.id, reason: (_d = result.reason) !== null && _d !== void 0 ? _d : 'Package release blocked.' };
+                break;
+            }
+            if (result.status === 'not-applicable' && !includesPatch(note)) {
+                log.upgrades[note.id] = 'not-applicable';
+                continue;
+            }
+            entry.packageUpdated = result.updated;
+        }
+        if (includesPatch(note)) {
+            if (!note.patch) {
+                blocked = { id: note.id, reason: 'Note declares a code patch but has no patch reference.' };
+                break;
+            }
+            const diff = feed.readPatch(note.patch);
+            if (diff == null) {
+                blocked = { id: note.id, reason: `Patch not found in feed: ${note.patch}` };
+                break;
+            }
+            const patch = tryApplyPatch(projectDir, diff);
+            if (!patch.applied && !patch.alreadyApplied) {
+                blocked = {
+                    id: note.id,
+                    reason: 'Patch did not apply cleanly; intent-based adaptation required.',
+                    output: patch.output,
+                };
+                break;
+            }
+            entry.via3way = patch.via3way;
+            entry.alreadyApplied = patch.alreadyApplied;
+        }
+        (0, git_1.commitAll)(projectDir, `Apply Nestled upgrade ${note.id}`);
+        applied.push({ note, entry });
+    }
+    if (blocked) {
+        rollback();
+        log.upgrades[blocked.id] = 'blocked';
+        (0, baseline_1.writeUpgradeLog)(projectDir, log);
+        return { status: 'blocked', channel, branch, applied: [], blocked, baselineRelease: log.template.baselineRelease };
+    }
+    const commands = (_f = (_e = options.verification) !== null && _e !== void 0 ? _e : config.verification) !== null && _f !== void 0 ? _f : inferVerification(projectDir);
+    const verification = applied.length ? runVerification(projectDir, commands) : [];
+    const failed = verification.find((item) => item.status !== 0);
+    if (failed) {
+        rollback();
+        for (const { note } of applied)
+            log.upgrades[note.id] = 'blocked';
+        (0, baseline_1.writeUpgradeLog)(projectDir, log);
+        return {
+            status: 'verification-failed',
+            channel,
+            branch,
+            applied: [],
+            verification,
+            blocked: { id: failed.command, reason: `Verification failed: ${failed.command}` },
+            baselineRelease: log.template.baselineRelease,
+        };
+    }
+    for (const { note, entry } of applied) {
+        log.upgrades[note.id] = (entry.alreadyApplied ? 'superseded' : 'applied');
+    }
+    (0, baseline_1.advanceBaseline)(log, releasesForBaseline(feed.manifest, pending));
+    (0, baseline_1.writeUpgradeLog)(projectDir, log);
+    let pr;
+    if (((_g = options.autoPR) !== null && _g !== void 0 ? _g : config.autoPR) && applied.length) {
+        pr = (0, git_1.pushAndCreatePR)(projectDir, {
+            branch,
+            base: (_j = (_h = options.defaultBranch) !== null && _h !== void 0 ? _h : config.defaultBranch) !== null && _j !== void 0 ? _j : 'develop',
+            title: `Nestled upgrades up to ${pending.ceiling}`,
+            body: prBody(applied.map((a) => a.entry), channel, pending.ceiling),
+        });
+    }
+    return {
+        status: 'applied',
+        channel,
+        branch,
+        applied: applied.map((a) => a.entry),
+        verification,
+        baselineRelease: log.template.baselineRelease,
+        pr,
+    };
+}
+//# sourceMappingURL=apply.js.map

package/src/lib/apply.js.map

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

package/src/lib/baseline.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Per-clone state, stored at `<project>/.nestled/upgrade-log.yaml`. This is the
+ * same file (and the same `template.originCommit` / `lastReviewedCommit` fields)
+ * the private fleet upgrader already writes — we add `channel` and
+ * `baselineRelease` so a standalone clone can compute what it still needs.
+ */
+export type Outcome = 'applied' | 'blocked' | 'superseded' | 'not-applicable' | 'pending-release';
+/** Outcomes that mean a note should not be offered again. */
+export declare const TERMINAL_OUTCOMES: ReadonlySet<Outcome>;
+export interface TemplateState {
+    repo?: string;
+    /** Which channel this clone follows. Defaults to `stable`. */
+    channel?: string;
+    /** Newest release considered already-present in this clone. */
+    baselineRelease?: string;
+    /** Git URL of the template feed source. */
+    remote?: string;
+    /** Branch/ref on the template that carries the feed. */
+    ref?: string;
+    originCommit?: string;
+    lastReviewedCommit?: string;
+}
+export interface UpgradeLog {
+    template: TemplateState;
+    upgrades: Record<string, Outcome>;
+}
+export declare const DEFAULT_CHANNEL = "stable";
+/** Version stamp committed into the template, carried by every clone. */
+export interface TemplateVersionStamp {
+    release: string;
+    commit?: string;
+    repo?: string;
+    remote?: string;
+    ref?: string;
+}
+/**
+ * Optional per-site settings at `<project>/.nestled/config.yaml`. Everything is
+ * optional; sensible defaults apply when the file (or a field) is absent.
+ */
+export interface SiteConfig {
+    /** Verification commands to run after applying; inferred if omitted. */
+    verification?: string[];
+    /** Subsystem tags this clone has forked; matching notes are held for review. */
+    forkedAreas?: string[];
+    /** Push the upgrade branch and open a PR after a successful apply. */
+    autoPR?: boolean;
+    /** Base branch for the PR (default: the current branch's tracking base). */
+    defaultBranch?: string;
+    template?: {
+        remote?: string;
+        ref?: string;
+    };
+}
+export declare function readSiteConfig(projectDir: string): SiteConfig;
+export declare function nestledDir(projectDir: string): string;
+export declare function logPathFor(projectDir: string): string;
+export declare function readUpgradeLog(projectDir: string): UpgradeLog;
+export declare function writeUpgradeLog(projectDir: string, log: UpgradeLog): void;
+/**
+ * Read the version stamp that travelled with the clone. Tolerates a couple of
+ * filename spellings so producers aren't locked into one. Returns null if the
+ * clone predates the stamp (legacy adoption — caller must supply a baseline).
+ */
+export declare function readTemplateStamp(projectDir: string): TemplateVersionStamp | null;
+export interface InitBaselineOptions {
+    /** Explicit baseline release id; overrides the clone's stamp. */
+    at?: string;
+    channel?: string;
+    repo?: string;
+    commit?: string;
+    /** Git URL of the template feed source. */
+    remote?: string;
+    /** Feed branch/ref on the template. */
+    ref?: string;
+}
+/**
+ * Establish (or re-affirm) the baseline for a clone. Precedence for the
+ * baseline release: explicit `--at` > existing log > committed template stamp.
+ * Idempotent: re-running never lowers an existing baseline or loses history.
+ */
+export declare function initBaseline(projectDir: string, options?: InitBaselineOptions): UpgradeLog;
+/**
+ * Advance the baseline as far as the manifest allows: walk releases in order
+ * above the current baseline and move the baseline forward across each release
+ * whose every note has reached a terminal outcome in the log, stopping at the
+ * first release that still has unfinished work. Also carries `lastReviewedCommit`
+ * forward to the release's template commit. Mutates and returns `log`.
+ */
+export declare function advanceBaseline(log: UpgradeLog, releasesAscending: {
+    id: string;
+    templateCommit?: string;
+    noteIds: string[];
+}[]): UpgradeLog;