@nestledjs/upgrades 0.1.0

package/src/lib/baseline.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CHANNEL = exports.TERMINAL_OUTCOMES = void 0;
+exports.readSiteConfig = readSiteConfig;
+exports.nestledDir = nestledDir;
+exports.logPathFor = logPathFor;
+exports.readUpgradeLog = readUpgradeLog;
+exports.writeUpgradeLog = writeUpgradeLog;
+exports.readTemplateStamp = readTemplateStamp;
+exports.initBaseline = initBaseline;
+exports.advanceBaseline = advanceBaseline;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const yaml_1 = require("yaml");
+/** Outcomes that mean a note should not be offered again. */
+exports.TERMINAL_OUTCOMES = new Set([
+    'applied',
+    'superseded',
+    'not-applicable',
+]);
+exports.DEFAULT_CHANNEL = 'stable';
+function readSiteConfig(projectDir) {
+    var _a;
+    const file = (0, node_path_1.join)(nestledDir(projectDir), 'config.yaml');
+    if (!(0, node_fs_1.existsSync)(file))
+        return {};
+    return (_a = (0, yaml_1.parse)((0, node_fs_1.readFileSync)(file, 'utf8'))) !== null && _a !== void 0 ? _a : {};
+}
+function nestledDir(projectDir) {
+    return (0, node_path_1.join)(projectDir, '.nestled');
+}
+function logPathFor(projectDir) {
+    return (0, node_path_1.join)(nestledDir(projectDir), 'upgrade-log.yaml');
+}
+function readUpgradeLog(projectDir) {
+    var _a, _b, _c;
+    const file = logPathFor(projectDir);
+    if (!(0, node_fs_1.existsSync)(file)) {
+        return { template: {}, upgrades: {} };
+    }
+    const raw = (_a = (0, yaml_1.parse)((0, node_fs_1.readFileSync)(file, 'utf8'))) !== null && _a !== void 0 ? _a : {};
+    return {
+        template: (_b = raw.template) !== null && _b !== void 0 ? _b : {},
+        upgrades: (_c = raw.upgrades) !== null && _c !== void 0 ? _c : {},
+    };
+}
+function writeUpgradeLog(projectDir, log) {
+    const file = logPathFor(projectDir);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(file), { recursive: true });
+    (0, node_fs_1.writeFileSync)(file, (0, yaml_1.stringify)(log), 'utf8');
+}
+/**
+ * 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).
+ */
+function readTemplateStamp(projectDir) {
+    const candidates = [
+        (0, node_path_1.join)(nestledDir(projectDir), 'template-version'),
+        (0, node_path_1.join)(nestledDir(projectDir), 'template-version.yaml'),
+        (0, node_path_1.join)(nestledDir(projectDir), 'template-version.json'),
+    ];
+    for (const file of candidates) {
+        if (!(0, node_fs_1.existsSync)(file))
+            continue;
+        const raw = (0, yaml_1.parse)((0, node_fs_1.readFileSync)(file, 'utf8'));
+        if (raw && typeof raw.release === 'string') {
+            return { release: raw.release, commit: raw.commit, repo: raw.repo };
+        }
+    }
+    return null;
+}
+/**
+ * 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.
+ */
+function initBaseline(projectDir, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+    const log = readUpgradeLog(projectDir);
+    const stamp = readTemplateStamp(projectDir);
+    const baselineRelease = (_b = (_a = options.at) !== null && _a !== void 0 ? _a : log.template.baselineRelease) !== null && _b !== void 0 ? _b : stamp === null || stamp === void 0 ? void 0 : stamp.release;
+    if (!baselineRelease) {
+        throw new Error('Cannot determine a baseline. Pass --at <release>, or add a committed ' +
+            '.nestled/template-version to the template so clones carry their origin.');
+    }
+    const config = readSiteConfig(projectDir);
+    log.template = Object.assign(Object.assign({}, log.template), { repo: (_d = (_c = options.repo) !== null && _c !== void 0 ? _c : log.template.repo) !== null && _d !== void 0 ? _d : stamp === null || stamp === void 0 ? void 0 : stamp.repo, channel: (_f = (_e = options.channel) !== null && _e !== void 0 ? _e : log.template.channel) !== null && _f !== void 0 ? _f : exports.DEFAULT_CHANNEL, baselineRelease, remote: (_k = (_h = (_g = options.remote) !== null && _g !== void 0 ? _g : log.template.remote) !== null && _h !== void 0 ? _h : (_j = config.template) === null || _j === void 0 ? void 0 : _j.remote) !== null && _k !== void 0 ? _k : stamp === null || stamp === void 0 ? void 0 : stamp.remote, ref: (_p = (_m = (_l = options.ref) !== null && _l !== void 0 ? _l : log.template.ref) !== null && _m !== void 0 ? _m : (_o = config.template) === null || _o === void 0 ? void 0 : _o.ref) !== null && _p !== void 0 ? _p : stamp === null || stamp === void 0 ? void 0 : stamp.ref, originCommit: (_r = (_q = log.template.originCommit) !== null && _q !== void 0 ? _q : options.commit) !== null && _r !== void 0 ? _r : stamp === null || stamp === void 0 ? void 0 : stamp.commit, lastReviewedCommit: (_t = (_s = log.template.lastReviewedCommit) !== null && _s !== void 0 ? _s : options.commit) !== null && _t !== void 0 ? _t : stamp === null || stamp === void 0 ? void 0 : stamp.commit });
+    writeUpgradeLog(projectDir, log);
+    return log;
+}
+/**
+ * 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`.
+ */
+function advanceBaseline(log, releasesAscending) {
+    var _a;
+    const applied = (_a = log.upgrades) !== null && _a !== void 0 ? _a : {};
+    for (const release of releasesAscending) {
+        const allTerminal = release.noteIds.every((id) => {
+            const status = applied[id];
+            return status != null && exports.TERMINAL_OUTCOMES.has(status);
+        });
+        if (!allTerminal)
+            break;
+        log.template.baselineRelease = release.id;
+        if (release.templateCommit)
+            log.template.lastReviewedCommit = release.templateCommit;
+    }
+    return log;
+}
+//# sourceMappingURL=baseline.js.map

package/src/lib/baseline.js.map

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

package/src/lib/cli.d.ts

@@ -0,0 +1 @@
+export declare function run(argv: string[]): number;

package/src/lib/cli.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const pending_1 = require("./pending");
+const baseline_1 = require("./baseline");
+const feed_1 = require("./feed");
+const apply_1 = require("./apply");
+function parseArgs(argv) {
+    const [command = 'help', ...rest] = argv;
+    const flags = {};
+    for (let i = 0; i < rest.length; i++) {
+        const token = rest[i];
+        if (!token.startsWith('--'))
+            continue;
+        const key = token.slice(2);
+        const next = rest[i + 1];
+        if (next != null && !next.startsWith('--')) {
+            flags[key] = next;
+            i++;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    return { command, flags };
+}
+function str(flags, key) {
+    return typeof flags[key] === 'string' ? flags[key] : undefined;
+}
+function projectDirFrom(flags) {
+    var _a;
+    return (_a = str(flags, 'project')) !== null && _a !== void 0 ? _a : process.cwd();
+}
+function feedOptions(flags) {
+    return {
+        manifestFile: str(flags, 'manifest'),
+        remote: str(flags, 'remote'),
+        ref: str(flags, 'ref'),
+    };
+}
+function printPending(pending) {
+    var _a, _b;
+    if (pending.notes.length === 0) {
+        console.log(`Up to date on channel "${pending.channel}" (baseline ${(_a = pending.baseline) !== null && _a !== void 0 ? _a : 'unset'}` +
+            `${pending.ceiling ? `, channel at ${pending.ceiling}` : ''}).`);
+        return;
+    }
+    console.log(`${pending.notes.length} pending note(s) on channel "${pending.channel}" ` +
+        `(baseline ${(_b = pending.baseline) !== null && _b !== void 0 ? _b : 'unset'} → ${pending.ceiling}):\n`);
+    for (const release of pending.releases) {
+        const notes = pending.notes.filter((n) => n.releaseId === release.id);
+        if (notes.length === 0)
+            continue;
+        console.log(`  ${release.id}${release.title ? ` — ${release.title}` : ''}`);
+        for (const note of notes) {
+            const flag = note.status ? ` [${note.status}]` : '';
+            console.log(`    • ${note.id} (${note.delivery})${flag} — ${note.title}`);
+        }
+    }
+}
+function cmdInit(flags) {
+    var _a;
+    const projectDir = projectDirFrom(flags);
+    const log = (0, baseline_1.initBaseline)(projectDir, {
+        at: str(flags, 'at'),
+        channel: str(flags, 'channel'),
+        repo: str(flags, 'repo'),
+        remote: str(flags, 'remote'),
+        ref: str(flags, 'ref'),
+    });
+    console.log(`Initialised baseline: channel "${log.template.channel}", ` +
+        `baseline release ${log.template.baselineRelease}` +
+        `${log.template.remote ? `, feed ${log.template.remote}@${(_a = log.template.ref) !== null && _a !== void 0 ? _a : 'develop'}` : ''}.`);
+    if (!(0, baseline_1.readTemplateStamp)(projectDir) && !flags.at) {
+        console.log('Note: no .nestled/template-version stamp found; baseline was taken from ' +
+            'existing state. For a legacy clone, pass --at <release> to be explicit.');
+    }
+    return 0;
+}
+function cmdCheck(flags) {
+    const projectDir = projectDirFrom(flags);
+    const log = (0, baseline_1.readUpgradeLog)(projectDir);
+    const feed = (0, feed_1.resolveFeed)(projectDir, log, feedOptions(flags));
+    printPending((0, pending_1.computePending)(feed.manifest, log));
+    return 0;
+}
+function cmdStatus(flags) {
+    var _a, _b, _c, _d, _e;
+    const projectDir = projectDirFrom(flags);
+    const log = (0, baseline_1.readUpgradeLog)(projectDir);
+    console.log(`channel:  ${(_a = log.template.channel) !== null && _a !== void 0 ? _a : baseline_1.DEFAULT_CHANNEL} (default applied if unset)`);
+    console.log(`baseline: ${(_b = log.template.baselineRelease) !== null && _b !== void 0 ? _b : '(unset — run `nestled-update init`)'}`);
+    console.log(`feed:     ${log.template.remote ? `${log.template.remote}@${(_c = log.template.ref) !== null && _c !== void 0 ? _c : 'develop'}` : '(unset)'}`);
+    console.log(`origin:   ${(_d = log.template.originCommit) !== null && _d !== void 0 ? _d : '(unknown)'}`);
+    const outcomes = Object.entries((_e = log.upgrades) !== null && _e !== void 0 ? _e : {});
+    console.log(`applied history: ${outcomes.length} recorded`);
+    for (const [id, outcome] of outcomes) {
+        console.log(`  ${id}: ${outcome}`);
+    }
+    return 0;
+}
+function reportApply(result) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    switch (result.status) {
+        case 'up-to-date':
+            console.log(`Up to date on channel "${result.channel}" (baseline ${(_a = result.baselineRelease) !== null && _a !== void 0 ? _a : 'unset'}).`);
+            return 0;
+        case 'applied':
+            console.log(`Applied ${result.applied.length} note(s) on branch ${result.branch}:`);
+            for (const note of result.applied) {
+                const via = note.via3way ? ' (3-way)' : note.alreadyApplied ? ' (already present)' : '';
+                console.log(`  • ${note.id} — ${note.title}${via}`);
+            }
+            console.log(`Baseline advanced to ${(_b = result.baselineRelease) !== null && _b !== void 0 ? _b : 'unset'}.`);
+            if (((_c = result.pr) === null || _c === void 0 ? void 0 : _c.status) === 'created')
+                console.log(`PR: ${result.pr.url}`);
+            if (((_d = result.pr) === null || _d === void 0 ? void 0 : _d.status) === 'blocked')
+                console.log(`PR not created: ${result.pr.reason}`);
+            return 0;
+        case 'blocked':
+            console.error(`Blocked at ${(_e = result.blocked) === null || _e === void 0 ? void 0 : _e.id}: ${(_f = result.blocked) === null || _f === void 0 ? void 0 : _f.reason}`);
+            if ((_g = result.blocked) === null || _g === void 0 ? void 0 : _g.output)
+                console.error(result.blocked.output);
+            console.error('Nothing was applied; the branch was rolled back. Adapt the note by intent, then re-run.');
+            return 1;
+        case 'verification-failed':
+            console.error(`Verification failed: ${(_h = result.blocked) === null || _h === void 0 ? void 0 : _h.reason}`);
+            console.error('Applied changes were rolled back so the tree stays clean. Fix and re-run.');
+            return 1;
+        default:
+            return 1;
+    }
+}
+function cmdApply(flags) {
+    const projectDir = projectDirFrom(flags);
+    const verify = str(flags, 'verify');
+    const result = (0, apply_1.applyRun)(projectDir, Object.assign(Object.assign({}, feedOptions(flags)), { allowDirty: flags['allow-dirty'] === true, autoPR: flags.pr === true ? true : undefined, verification: verify != null ? verify.split(',').map((s) => s.trim()).filter(Boolean) : undefined, defaultBranch: str(flags, 'base') }));
+    return reportApply(result);
+}
+const HELP = `nestled-update — apply Nestled template upgrades to this project
+
+Usage: nestled-update <command> [options]
+
+Commands:
+  init      Establish the baseline for this clone (from .nestled/template-version or --at)
+  check     Show pending upgrades for this project's channel (no changes)
+  status    Show current channel, baseline, feed, and applied history
+  apply     Apply pending upgrades on a branch (all-or-nothing, verified, rollback on failure)
+  help      Show this help
+
+Options:
+  --project <dir>    Target project directory (default: cwd)
+  --manifest <path>  Read the feed from a local manifest file (dev/testing/offline)
+  --remote <url>     Template git URL for the feed (init records it; overrides the log)
+  --ref <branch>     Feed branch on the template (default: develop)
+  --channel <name>   Channel to follow: stable | canary (init only; default: stable)
+  --at <release>     Explicit baseline release id (init only)
+  --repo <name>      Template repo name to record (init only)
+  --verify <cmds>    Comma-separated verification commands (apply; else inferred)
+  --pr               Push the branch and open a PR after a successful apply
+  --base <branch>    Base branch for the PR (default: develop)
+  --allow-dirty      Allow apply when the working tree has uncommitted changes
+`;
+function run(argv) {
+    const { command, flags } = parseArgs(argv);
+    try {
+        switch (command) {
+            case 'init':
+                return cmdInit(flags);
+            case 'check':
+                return cmdCheck(flags);
+            case 'status':
+                return cmdStatus(flags);
+            case 'apply':
+                return cmdApply(flags);
+            case 'help':
+            case '--help':
+            case '-h':
+                console.log(HELP);
+                return 0;
+            default:
+                console.error(`Unknown command: ${command}\n`);
+                console.log(HELP);
+                return 1;
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/src/lib/cli.js.map

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

package/src/lib/feed.d.ts

@@ -0,0 +1,25 @@
+import { Manifest } from './manifest';
+import { UpgradeLog } from './baseline';
+/** Where the feed lives inside the template repo. */
+export declare const FEED_DIR = ".nestled-upgrades";
+export declare const MANIFEST_PATH = ".nestled-upgrades/manifest.yaml";
+export declare const UPSTREAM_REMOTE = "nestled-upstream";
+/**
+ * A resolved feed: the parsed manifest plus a way to read a patch file the
+ * notes reference. `readPatch` takes the note's `patch` value (a path relative
+ * to the feed dir, or a full repo path) and returns the diff text.
+ */
+export interface ResolvedFeed {
+    manifest: Manifest;
+    source: string;
+    readPatch(patchRef: string): string | null;
+}
+export interface ResolveFeedOptions {
+    /** Local manifest file (dev/testing/offline); bypasses git fetch. */
+    manifestFile?: string;
+    /** Override the template git URL (else taken from the log). */
+    remote?: string;
+    /** Override the feed ref (else taken from the log, default `develop`). */
+    ref?: string;
+}
+export declare function resolveFeed(projectDir: string, log: UpgradeLog, options?: ResolveFeedOptions): ResolvedFeed;

package/src/lib/feed.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPSTREAM_REMOTE = exports.MANIFEST_PATH = exports.FEED_DIR = void 0;
+exports.resolveFeed = resolveFeed;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const manifest_1 = require("./manifest");
+const git_1 = require("./git");
+/** Where the feed lives inside the template repo. */
+exports.FEED_DIR = '.nestled-upgrades';
+exports.MANIFEST_PATH = `${exports.FEED_DIR}/manifest.yaml`;
+exports.UPSTREAM_REMOTE = 'nestled-upstream';
+function normalizePatchRef(patchRef) {
+    if (patchRef.startsWith(`${exports.FEED_DIR}/`))
+        return patchRef;
+    return `${exports.FEED_DIR}/${patchRef.replace(/^\.?\/*/, '')}`;
+}
+/**
+ * Resolve the feed from a local manifest file: patches are read from
+ * `<manifest dir>/patches/...` (or a path relative to the manifest's dir).
+ */
+function resolveLocalFeed(manifestFile) {
+    const manifest = (0, manifest_1.loadManifestFromFile)(manifestFile);
+    const baseDir = (0, node_path_1.dirname)(manifestFile);
+    return {
+        manifest,
+        source: manifestFile,
+        readPatch(patchRef) {
+            const rel = patchRef.startsWith(`${exports.FEED_DIR}/`)
+                ? patchRef.slice(exports.FEED_DIR.length + 1)
+                : patchRef.replace(/^\.?\/*/, '');
+            const candidate = (0, node_path_1.isAbsolute)(patchRef) ? patchRef : (0, node_path_1.join)(baseDir, rel);
+            return (0, node_fs_1.existsSync)(candidate) ? (0, node_fs_1.readFileSync)(candidate, 'utf8') : null;
+        },
+    };
+}
+/**
+ * Resolve the feed from the template git repo: ensure the upstream remote,
+ * fetch the feed ref, then read the manifest and patches via `git show` at that
+ * ref — no working checkout of the template needed.
+ */
+function resolveGitFeed(projectDir, remote, ref) {
+    (0, git_1.ensureRemote)(projectDir, exports.UPSTREAM_REMOTE, remote);
+    const fetched = (0, git_1.fetchRef)(projectDir, exports.UPSTREAM_REMOTE, ref, { filterBlobless: true });
+    if (fetched.status !== 0) {
+        throw new Error(`Failed to fetch feed ref "${ref}" from ${remote}: ${fetched.stderr || fetched.stdout}`);
+    }
+    const rev = `${exports.UPSTREAM_REMOTE}/${ref}`;
+    const manifestText = (0, git_1.showFile)(projectDir, rev, exports.MANIFEST_PATH);
+    if (manifestText == null) {
+        throw new Error(`No ${exports.MANIFEST_PATH} found at ${rev}. Has a release been published to this channel yet?`);
+    }
+    const manifest = (0, manifest_1.parseManifest)(manifestText);
+    return {
+        manifest,
+        source: `${remote}@${ref}`,
+        readPatch(patchRef) {
+            return (0, git_1.showFile)(projectDir, rev, normalizePatchRef(patchRef));
+        },
+    };
+}
+function resolveFeed(projectDir, log, options = {}) {
+    var _a, _b, _c, _d, _e;
+    if (options.manifestFile) {
+        return resolveLocalFeed(options.manifestFile);
+    }
+    const remote = (_a = options.remote) !== null && _a !== void 0 ? _a : (_b = log.template) === null || _b === void 0 ? void 0 : _b.remote;
+    const ref = (_e = (_c = options.ref) !== null && _c !== void 0 ? _c : (_d = log.template) === null || _d === void 0 ? void 0 : _d.ref) !== null && _e !== void 0 ? _e : 'develop';
+    if (!remote) {
+        throw new Error('No template remote configured. Run `nestled-update init --remote <git-url>`, ' +
+            'set template.remote in .nestled/config.yaml, or pass --manifest <file> for local testing.');
+    }
+    return resolveGitFeed(projectDir, remote, ref);
+}
+//# sourceMappingURL=feed.js.map

package/src/lib/feed.js.map

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

package/src/lib/git.d.ts

@@ -0,0 +1,40 @@
+export interface GitResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function git(cwd: string, args: string[]): GitResult;
+export declare function gitOutput(cwd: string, args: string[]): string;
+export declare function isGitRepo(cwd: string): boolean;
+/** Uncommitted changes, ignoring our own `.nestled/` bookkeeping. */
+export declare function hasUncommittedChanges(cwd: string): boolean;
+export declare function currentBranch(cwd: string): string;
+export declare function checkoutBranch(cwd: string, branch: string): void;
+export declare function commitAll(cwd: string, message: string): string;
+/**
+ * Restore a working tree that we dirtied, safe only when the caller verified the
+ * tree was clean before starting: reverts tracked edits and removes files our
+ * patches added, but preserves `.nestled/` so the log we are about to write
+ * survives. Never call this when the run started `--allow-dirty`.
+ */
+export declare function resetWorktree(cwd: string): void;
+export declare function ensureRemote(cwd: string, name: string, url: string): void;
+export interface FetchOptions {
+    depth?: number;
+    filterBlobless?: boolean;
+}
+export declare function fetchRef(cwd: string, remote: string, ref: string, options?: FetchOptions): GitResult;
+/** Read a file from a git rev (e.g. `remote/branch`) without a checkout. */
+export declare function showFile(cwd: string, rev: string, repoPath: string): string | null;
+export interface PrOptions {
+    branch: string;
+    base: string;
+    title: string;
+    body: string;
+}
+export interface PrResult {
+    status: 'created' | 'blocked';
+    url?: string;
+    reason?: string;
+}
+export declare function pushAndCreatePR(cwd: string, options: PrOptions): PrResult;

package/src/lib/git.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.git = git;
+exports.gitOutput = gitOutput;
+exports.isGitRepo = isGitRepo;
+exports.hasUncommittedChanges = hasUncommittedChanges;
+exports.currentBranch = currentBranch;
+exports.checkoutBranch = checkoutBranch;
+exports.commitAll = commitAll;
+exports.resetWorktree = resetWorktree;
+exports.ensureRemote = ensureRemote;
+exports.fetchRef = fetchRef;
+exports.showFile = showFile;
+exports.pushAndCreatePR = pushAndCreatePR;
+const node_child_process_1 = require("node:child_process");
+function git(cwd, args) {
+    var _a, _b, _c;
+    const result = (0, node_child_process_1.spawnSync)('git', args, { cwd, encoding: 'utf8' });
+    return {
+        status: (_a = result.status) !== null && _a !== void 0 ? _a : 1,
+        stdout: (_b = result.stdout) !== null && _b !== void 0 ? _b : '',
+        stderr: (_c = result.stderr) !== null && _c !== void 0 ? _c : '',
+    };
+}
+function gitOutput(cwd, args) {
+    const result = git(cwd, args);
+    return result.status === 0 ? result.stdout.trim() : '';
+}
+function isGitRepo(cwd) {
+    return gitOutput(cwd, ['rev-parse', '--is-inside-work-tree']) === 'true';
+}
+/** Uncommitted changes, ignoring our own `.nestled/` bookkeeping. */
+function hasUncommittedChanges(cwd) {
+    return gitOutput(cwd, ['status', '--porcelain'])
+        .split('\n')
+        .filter(Boolean)
+        .some((line) => !line.includes('.nestled/'));
+}
+function currentBranch(cwd) {
+    return gitOutput(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']);
+}
+function checkoutBranch(cwd, branch) {
+    const existing = git(cwd, ['show-ref', '--verify', '--quiet', `refs/heads/${branch}`]);
+    const args = existing.status === 0 ? ['checkout', branch] : ['checkout', '-b', branch];
+    const result = git(cwd, args);
+    if (result.status !== 0) {
+        throw new Error(`Unable to checkout ${branch}: ${result.stderr || result.stdout}`);
+    }
+}
+function commitAll(cwd, message) {
+    if (!gitOutput(cwd, ['status', '--porcelain'])) {
+        return gitOutput(cwd, ['rev-parse', '--short', 'HEAD']);
+    }
+    if (git(cwd, ['add', '-A']).status !== 0)
+        return '';
+    if (git(cwd, ['commit', '--no-gpg-sign', '-m', message]).status !== 0)
+        return '';
+    return gitOutput(cwd, ['rev-parse', '--short', 'HEAD']);
+}
+/**
+ * Restore a working tree that we dirtied, safe only when the caller verified the
+ * tree was clean before starting: reverts tracked edits and removes files our
+ * patches added, but preserves `.nestled/` so the log we are about to write
+ * survives. Never call this when the run started `--allow-dirty`.
+ */
+function resetWorktree(cwd) {
+    git(cwd, ['checkout', '--', '.']);
+    git(cwd, ['clean', '-fd', '-e', '.nestled']);
+}
+function ensureRemote(cwd, name, url) {
+    const existing = gitOutput(cwd, ['remote', 'get-url', name]);
+    if (!existing) {
+        git(cwd, ['remote', 'add', name, url]);
+    }
+    else if (url && existing !== url) {
+        git(cwd, ['remote', 'set-url', name, url]);
+    }
+}
+function fetchRef(cwd, remote, ref, options = {}) {
+    const args = ['fetch'];
+    if (options.depth)
+        args.push(`--depth=${options.depth}`);
+    if (options.filterBlobless)
+        args.push('--filter=blob:none');
+    args.push(remote, ref);
+    return git(cwd, args);
+}
+/** Read a file from a git rev (e.g. `remote/branch`) without a checkout. */
+function showFile(cwd, rev, repoPath) {
+    const result = git(cwd, ['show', `${rev}:${repoPath}`]);
+    return result.status === 0 ? result.stdout : null;
+}
+function pushAndCreatePR(cwd, options) {
+    var _a, _b;
+    const push = git(cwd, ['push', '-u', 'origin', options.branch]);
+    if (push.status !== 0) {
+        return { status: 'blocked', reason: `Push failed: ${push.stderr || push.stdout}` };
+    }
+    const pr = (0, node_child_process_1.spawnSync)('gh', ['pr', 'create', '--title', options.title, '--base', options.base, '--head', options.branch, '--body', options.body], { cwd, encoding: 'utf8' });
+    if (((_a = pr.status) !== null && _a !== void 0 ? _a : 1) !== 0) {
+        return { status: 'blocked', reason: `PR creation failed: ${pr.stderr || pr.stdout}` };
+    }
+    return { status: 'created', url: ((_b = pr.stdout) !== null && _b !== void 0 ? _b : '').trim() };
+}
+//# sourceMappingURL=git.js.map

package/src/lib/git.js.map

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