@graftsync/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brandon Roberts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/diff.d.ts

@@ -0,0 +1,62 @@
+import type { ScopedFileDiff } from './types.js';
+/** A region of interest for narrowing a diff, typically one located anchor. */
+export interface AnchorRegion {
+    name: string;
+    /** 1-based inclusive line span in the old version, if the anchor was located there. */
+    old?: [number, number];
+    /** 1-based inclusive line span in the new version, if the anchor was located there. */
+    new?: [number, number];
+    /** Identifiers/strings that identify the anchor; hunks mentioning them are kept. */
+    symbols?: string[];
+}
+export interface ScopeFileOptions {
+    file: string;
+    oldText: string | undefined;
+    newText: string | undefined;
+    regions: AnchorRegion[];
+    /** Lines of slack around anchor spans when deciding if a hunk is "near". Default 40. */
+    window?: number;
+    /** Context lines in each hunk. Default 3. */
+    context?: number;
+}
+/** Diff one target file and keep only hunks near or mentioning the given anchor regions. */
+export declare function scopeFileDiff(options: ScopeFileOptions): ScopedFileDiff;
+/** Render scoped file diffs as a unified patch. */
+export declare function renderPatch(files: ScopedFileDiff[], labels: {
+    from: string;
+    to: string;
+}): string;
+/** Find files under `dir` (excluding node_modules) whose text contains any of `symbols`. */
+export declare function findFilesMentioning(dir: string, symbols: string[], limit?: number): Promise<string[]>;
+/**
+ * Distinctive text in some source lines, for finding where removed code moved: trimmed lines
+ * worth matching (not blank, not bare punctuation like `}` or `});`, at least 8 characters, and
+ * containing an identifier) and identifiers of 4+ characters that are not common keywords.
+ */
+export declare function distinctiveText(lines: string[]): {
+    lines: string[];
+    identifiers: string[];
+};
+export interface RankFilesOptions {
+    /** Trimmed lines to look for (each counts once per file). */
+    lines: string[];
+    /** Identifiers to look for; break ties between files matching the same number of lines. */
+    identifiers?: string[];
+    /** Maximum files returned. Default 10. */
+    limit?: number;
+    /** File name pattern to scan. Default: JavaScript (.js/.cjs/.mjs). */
+    include?: RegExp;
+    /** Paths (relative to `dir`) to skip. */
+    exclude?: string[];
+}
+/**
+ * Rank files under `dir` (excluding node_modules and dot-directories) by how many of `lines`
+ * they contain, then by how many identifiers. Files matching nothing are left out.
+ */
+export declare function rankFilesByContent(dir: string, options: RankFilesOptions): Promise<string[]>;
+/** 1-based line and column of a UTF-16 offset. */
+export declare function lineColumn(text: string, offset: number): {
+    line: number;
+    column: number;
+};
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3D,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,uFAAuF;IACvF,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAwCvE;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkBjG;AAID,4FAA4F;AAC5F,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBvG;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAW3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBlG;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAUzF"}

package/dist/diff.js

@@ -0,0 +1,160 @@
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { structuredPatch } from 'diff';
+const overlaps = (a, b) => a[0] <= b[1] && b[0] <= a[1];
+/** Diff one target file and keep only hunks near or mentioning the given anchor regions. */
+export function scopeFileDiff(options) {
+    const { file, oldText, newText, regions } = options;
+    const window = options.window ?? 40;
+    if (oldText === undefined && newText === undefined) {
+        return { file, status: 'removed', totalHunks: 0, hunks: [], narrowed: false };
+    }
+    const status = oldText === undefined ? 'added' : newText === undefined ? 'removed' : oldText === newText ? 'unchanged' : 'modified';
+    if (status === 'unchanged')
+        return { file, status, totalHunks: 0, hunks: [], narrowed: true };
+    const patch = structuredPatch(file, file, oldText ?? '', newText ?? '', '', '', {
+        context: options.context ?? 3,
+    });
+    const hunks = patch.hunks.map((h) => ({
+        oldStart: h.oldStart,
+        oldLines: h.oldLines,
+        newStart: h.newStart,
+        newLines: h.newLines,
+        lines: h.lines,
+        anchors: [],
+    }));
+    const located = regions.some((r) => r.old || r.new || r.symbols?.length);
+    if (!located || status !== 'modified') {
+        return { file, status, totalHunks: hunks.length, hunks, narrowed: false };
+    }
+    for (const hunk of hunks) {
+        const oldSpan = [hunk.oldStart, hunk.oldStart + Math.max(hunk.oldLines - 1, 0)];
+        const newSpan = [hunk.newStart, hunk.newStart + Math.max(hunk.newLines - 1, 0)];
+        const changed = hunk.lines.filter((l) => l[0] === '+' || l[0] === '-').join('\n');
+        for (const region of regions) {
+            const near = (region.old && overlaps(oldSpan, [region.old[0] - window, region.old[1] + window])) ||
+                (region.new && overlaps(newSpan, [region.new[0] - window, region.new[1] + window]));
+            const mentions = region.symbols?.some((s) => s && changed.includes(s));
+            if (near || mentions)
+                hunk.anchors.push(region.name);
+        }
+    }
+    return { file, status, totalHunks: hunks.length, hunks: hunks.filter((h) => h.anchors.length > 0), narrowed: true };
+}
+/** Render scoped file diffs as a unified patch. */
+export function renderPatch(files, labels) {
+    const out = [];
+    for (const f of files) {
+        if (f.status === 'unchanged')
+            continue;
+        out.push(`--- a/${f.file}\t(${labels.from})`, `+++ b/${f.file}\t(${labels.to})`);
+        if (f.status === 'removed' && f.hunks.length === 0)
+            out.push(`# target removed in ${labels.to}`);
+        if (f.narrowed && f.hunks.length < f.totalHunks) {
+            out.push(`# narrowed: showing ${f.hunks.length} of ${f.totalHunks} hunks (those near anchors)`);
+        }
+        for (const h of f.hunks) {
+            const note = h.anchors.length ? ` anchors: ${h.anchors.join(', ')}` : '';
+            out.push(`@@ -${h.oldStart},${h.oldLines} +${h.newStart},${h.newLines} @@${note}`, ...h.lines);
+        }
+        if (f.candidates?.length) {
+            out.push(`# candidate files in ${labels.to} that contain the removed target's patched code (best match first):`, ...f.candidates.map((c) => `#   ${c}`));
+        }
+    }
+    return out.join('\n') + (out.length ? '\n' : '');
+}
+const CODE_EXT = /\.(c|m)?js$/;
+/** Find files under `dir` (excluding node_modules) whose text contains any of `symbols`. */
+export async function findFilesMentioning(dir, symbols, limit = 10) {
+    const wanted = symbols.filter((s) => s.length >= 3);
+    if (!wanted.length)
+        return [];
+    const hits = [];
+    const walk = async (rel) => {
+        const entries = await readdir(path.join(dir, rel), { withFileTypes: true }).catch(() => []);
+        for (const e of entries) {
+            if (hits.length >= limit)
+                return;
+            const child = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory()) {
+                if (e.name !== 'node_modules' && !e.name.startsWith('.'))
+                    await walk(child);
+            }
+            else if (CODE_EXT.test(e.name)) {
+                const text = await readFile(path.join(dir, child), 'utf8').catch(() => '');
+                if (wanted.some((s) => text.includes(s)))
+                    hits.push(child);
+            }
+        }
+    };
+    await walk('');
+    return hits;
+}
+const KEYWORDS = new Set('this that from with true false null undefined const function return export import default async await else case break continue throw catch finally typeof instanceof void delete while switch class extends super static yield require module exports Object Array String Number Boolean Promise prototype length push call apply bind then value'.split(' '));
+/**
+ * Distinctive text in some source lines, for finding where removed code moved: trimmed lines
+ * worth matching (not blank, not bare punctuation like `}` or `});`, at least 8 characters, and
+ * containing an identifier) and identifiers of 4+ characters that are not common keywords.
+ */
+export function distinctiveText(lines) {
+    const keptLines = new Set();
+    const identifiers = new Set();
+    for (const raw of lines) {
+        const line = raw.trim();
+        const ids = (line.match(/[A-Za-z_$][\w$]{3,}/g) ?? []).filter((id) => !KEYWORDS.has(id));
+        for (const id of ids)
+            identifiers.add(id);
+        if (line.length >= 8 && /[A-Za-z_$][\w$]{2,}/.test(line))
+            keptLines.add(line);
+    }
+    // Longer lines are more distinctive; check them first.
+    return { lines: [...keptLines].sort((a, b) => b.length - a.length), identifiers: [...identifiers] };
+}
+/**
+ * Rank files under `dir` (excluding node_modules and dot-directories) by how many of `lines`
+ * they contain, then by how many identifiers. Files matching nothing are left out.
+ */
+export async function rankFilesByContent(dir, options) {
+    const wantedLines = options.lines.filter((l) => l.trim().length > 0);
+    const wantedIds = (options.identifiers ?? []).filter((s) => s.length >= 4);
+    if (!wantedLines.length && !wantedIds.length)
+        return [];
+    const include = options.include ?? CODE_EXT;
+    const exclude = new Set(options.exclude ?? []);
+    const scored = [];
+    const walk = async (rel) => {
+        const entries = await readdir(path.join(dir, rel), { withFileTypes: true }).catch(() => []);
+        for (const e of entries) {
+            const child = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory()) {
+                if (e.name !== 'node_modules' && !e.name.startsWith('.'))
+                    await walk(child);
+            }
+            else if (include.test(e.name) && !exclude.has(child)) {
+                const text = await readFile(path.join(dir, child), 'utf8').catch(() => '');
+                if (!text)
+                    continue;
+                const lines = wantedLines.filter((l) => text.includes(l)).length;
+                const ids = wantedIds.filter((s) => text.includes(s)).length;
+                if (lines || ids)
+                    scored.push({ file: child, lines, ids });
+            }
+        }
+    };
+    await walk('');
+    scored.sort((a, b) => b.lines - a.lines || b.ids - a.ids || (a.file < b.file ? -1 : a.file > b.file ? 1 : 0));
+    return scored.slice(0, options.limit ?? 10).map((s) => s.file);
+}
+/** 1-based line and column of a UTF-16 offset. */
+export function lineColumn(text, offset) {
+    let line = 1;
+    let last = -1;
+    for (let i = 0; i < offset && i < text.length; i++) {
+        if (text.charCodeAt(i) === 10) {
+            line++;
+            last = i;
+        }
+    }
+    return { line, column: offset - last };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/** Base class for errors caused by tooling/config problems (CLI exit code 2). */
+export declare class GraftError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** Thrown when an anchor does not match. A graft must never silently apply nothing. */
+export declare class AnchorMissError extends GraftError {
+    readonly graft: string;
+    readonly anchors: string[];
+    constructor(message: string, graft: string, anchors: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qBAAa,UAAW,SAAQ,KAAK;IAGjC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,YACE,OAAO,EAAE,MAAM,EACN,IAAI,GAAE,MAAsB,EAItC;CACF;AAED,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,UAAU;IAG3C,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAH5B,YACE,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EAI3B;CACF"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+/** Base class for errors caused by tooling/config problems (CLI exit code 2). */
+export class GraftError extends Error {
+    code;
+    constructor(message, code = 'graft/error') {
+        super(message);
+        this.code = code;
+        this.name = 'GraftError';
+    }
+}
+/** Thrown when an anchor does not match. A graft must never silently apply nothing. */
+export class AnchorMissError extends GraftError {
+    graft;
+    anchors;
+    constructor(message, graft, anchors) {
+        super(message, 'graft/anchor-miss');
+        this.graft = graft;
+        this.anchors = anchors;
+        this.name = 'AnchorMissError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGxB,IAAI;IAFf,YACE,OAAe,EACN,IAAI,GAAW,aAAa;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAFN,IAAI;QAGb,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,uFAAuF;AACvF,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAGlC,KAAK;IACL,OAAO;IAHlB,YACE,OAAe,EACN,KAAa,EACb,OAAiB;QAE1B,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;qBAH3B,KAAK;uBACL,OAAO;QAGhB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './upstream.js';
+export * from './project.js';
+export * from './oracle.js';
+export * from './diff.js';
+export * from './operations.js';
+export * from './install.js';
+export * from './sync.js';
+export * from './scaffold.js';
+export * from './outdated.js';
+export * from './replay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './upstream.js';
+export * from './project.js';
+export * from './oracle.js';
+export * from './diff.js';
+export * from './operations.js';
+export * from './install.js';
+export * from './sync.js';
+export * from './scaffold.js';
+export * from './outdated.js';
+export * from './replay.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,22 @@
+/** `yarn` is yarn classic (1.x); `yarn-berry` is yarn 2+ (Plug'n'Play or `nodeLinker: node-modules`). */
+export type PackageManager = 'pnpm' | 'yarn' | 'yarn-berry' | 'npm' | 'bun' | 'upm';
+/**
+ * Is the yarn project in `dir` yarn 2+ (berry)? Berry projects carry a `.yarnrc.yml` or a
+ * Plug'n'Play runtime (`.pnp.cjs`), and berry's yarn.lock starts with a `__metadata:` block;
+ * yarn classic has none of these.
+ */
+export declare function isYarnBerry(dir: string): boolean;
+/** The package manager Graft assumes when a project gives no signal. */
+export declare const DEFAULT_PACKAGE_MANAGER: PackageManager;
+/**
+ * Detect the package manager, walking up from `root`. In each directory: an explicit
+ * package.json `packageManager` (e.g. "pnpm@10.28.0") wins; otherwise lockfiles in the order
+ * pnpm, npm, upm, yarn, bun. With no signal anywhere, npm. yarn is `yarn-berry` for
+ * `packageManager: yarn@2+`, or a yarn.lock next to berry's markers (see {@link isYarnBerry}).
+ */
+export declare function detectPackageManager(root: string): PackageManager;
+/** Install `spec` (e.g. `lib@1.2.3`), keeping it in the manifest(s) and dependency field that already declare it. */
+export declare function installPackage(root: string, pkg: string, spec: string): Promise<string>;
+/** Reinstall the project's dependencies (so package-manager patch config takes effect). */
+export declare function reinstall(root: string): Promise<string>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAMA,yGAAyG;AACzG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAcpF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,EAAE,cAAsB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoBjE;AAED,qHAAqH;AACrH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB7F;AAED,2FAA2F;AAC3F,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7D"}

package/dist/install.js

@@ -0,0 +1,100 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { GraftError } from './errors.js';
+import { runCommand } from './oracle.js';
+/**
+ * Precedence when a directory has several lockfiles: pnpm first, then npm, then upm.
+ * yarn and bun remain supported after those. A project with no signal at all is npm.
+ */
+const LOCKFILE_PRECEDENCE = [
+    ['pnpm', ['pnpm-lock.yaml', 'pnpm-workspace.yaml']],
+    ['npm', ['package-lock.json', 'npm-shrinkwrap.json']],
+    ['upm', ['upm.lock']],
+    ['yarn', ['yarn.lock']],
+    ['bun', ['bun.lock', 'bun.lockb']],
+];
+/**
+ * Is the yarn project in `dir` yarn 2+ (berry)? Berry projects carry a `.yarnrc.yml` or a
+ * Plug'n'Play runtime (`.pnp.cjs`), and berry's yarn.lock starts with a `__metadata:` block;
+ * yarn classic has none of these.
+ */
+export function isYarnBerry(dir) {
+    if (['.yarnrc.yml', '.pnp.cjs', '.pnp.js'].some((f) => existsSync(path.join(dir, f))))
+        return true;
+    try {
+        return /^__metadata:/m.test(readFileSync(path.join(dir, 'yarn.lock'), 'utf8').slice(0, 4096));
+    }
+    catch {
+        return false;
+    }
+}
+/** The package manager Graft assumes when a project gives no signal. */
+export const DEFAULT_PACKAGE_MANAGER = 'npm';
+/**
+ * Detect the package manager, walking up from `root`. In each directory: an explicit
+ * package.json `packageManager` (e.g. "pnpm@10.28.0") wins; otherwise lockfiles in the order
+ * pnpm, npm, upm, yarn, bun. With no signal anywhere, npm. yarn is `yarn-berry` for
+ * `packageManager: yarn@2+`, or a yarn.lock next to berry's markers (see {@link isYarnBerry}).
+ */
+export function detectPackageManager(root) {
+    let dir = path.resolve(root);
+    for (;;) {
+        const manifest = path.join(dir, 'package.json');
+        if (existsSync(manifest)) {
+            try {
+                const declared = /^(pnpm|yarn|npm|bun|upm)@(\d+)?/.exec(String(JSON.parse(readFileSync(manifest, 'utf8')).packageManager ?? ''));
+                if (declared?.[1] === 'yarn')
+                    return (declared[2] ? Number(declared[2]) >= 2 : isYarnBerry(dir)) ? 'yarn-berry' : 'yarn';
+                if (declared)
+                    return declared[1];
+            }
+            catch {
+                // unreadable manifest: fall through to lockfile detection
+            }
+        }
+        for (const [pm, files] of LOCKFILE_PRECEDENCE) {
+            if (files.some((f) => existsSync(path.join(dir, f))))
+                return pm === 'yarn' && isYarnBerry(dir) ? 'yarn-berry' : pm;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return DEFAULT_PACKAGE_MANAGER;
+        dir = parent;
+    }
+}
+/** Install `spec` (e.g. `lib@1.2.3`), keeping it in the manifest(s) and dependency field that already declare it. */
+export async function installPackage(root, pkg, spec) {
+    const manifest = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
+    const dev = !!manifest.devDependencies?.[pkg];
+    const pm = detectPackageManager(root);
+    const quoted = `'${spec.replaceAll("'", "'\\''")}'`;
+    const command = {
+        // `update -r` bumps the package wherever it is already declared (workspace-aware)
+        // instead of adding it to the root manifest.
+        pnpm: `pnpm update -r ${quoted}`,
+        yarn: `yarn add ${dev ? '-D ' : ''}${quoted}`,
+        // berry: `up` bumps the package in every workspace that declares it, keeping its field.
+        'yarn-berry': `yarn up ${quoted}`,
+        bun: `bun add ${dev ? '-d ' : ''}${quoted}`,
+        upm: `upm add ${dev ? '--dev ' : ''}${quoted}`,
+        npm: `npm install ${dev ? '--save-dev ' : ''}${quoted}`,
+    }[pm];
+    const result = await runCommand(command, { cwd: root, timeoutMs: 10 * 60_000 });
+    if (!result.passed)
+        throw new GraftError(`\`${command}\` failed:\n${result.output}`, 'install/failed');
+    // npm and yarn classic run the project's own lifecycle scripts (e.g. a patch-package
+    // postinstall) only on a bare install, not when adding a specific package.
+    if (pm === 'npm' || pm === 'yarn')
+        return `${command} && ${await reinstall(root)}`;
+    return command;
+}
+/** Reinstall the project's dependencies (so package-manager patch config takes effect). */
+export async function reinstall(root) {
+    const command = { pnpm: 'pnpm install', yarn: 'yarn install', 'yarn-berry': 'yarn install', bun: 'bun install', upm: 'upm install', npm: 'npm install' }[detectPackageManager(root)];
+    const result = await runCommand(command, { cwd: root, timeoutMs: 10 * 60_000 });
+    if (!result.passed)
+        throw new GraftError(`\`${command}\` failed:\n${result.output}`, 'install/failed');
+    return command;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC;;;GAGG;AACH,MAAM,mBAAmB,GAAiC;IACxD,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;IACnD,CAAC,KAAK,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;IACrD,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;IACrB,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnG,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAmB,KAAK,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,CAAC;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,iCAAiC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjI,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM;oBAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;gBACzH,IAAI,QAAQ;oBAAE,OAAO,QAAQ,CAAC,CAAC,CAAmB,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,mBAAmB,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,KAAK,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACrH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,uBAAuB,CAAC;QACnD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW,EAAE,IAAY;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAElF,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;IACpD,MAAM,OAAO,GAAG;QACd,kFAAkF;QAClF,6CAA6C;QAC7C,IAAI,EAAE,kBAAkB,MAAM,EAAE;QAChC,IAAI,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;QAC7C,wFAAwF;QACxF,YAAY,EAAE,WAAW,MAAM,EAAE;QACjC,GAAG,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;QAC3C,GAAG,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;QAC9C,GAAG,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;KACxD,CAAC,EAAE,CAAC,CAAC;IACN,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,OAAO,eAAe,MAAM,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACvG,qFAAqF;IACrF,2EAA2E;IAC3E,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,GAAG,OAAO,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACnF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrL,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,OAAO,eAAe,MAAM,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACvG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/operations.d.ts

@@ -0,0 +1,90 @@
+import { type GraftStatus } from '@graftsync/spec';
+import type { Project } from './project.js';
+import type { GraftUpdate, InstalledApplyReport, AnchorReport, ApplyOptions, ApplyResult, Graft, ScopedDiff, VariantInput } from './types.js';
+/** Resolve a version argument, defaulting to the installed version of the graft's rootstock. */
+export declare function resolveVersion(project: Project, graft: Graft, version?: string): Promise<string>;
+export declare function checkAnchors(project: Project, id: string, version?: string): Promise<AnchorReport>;
+export declare function applyGraft(project: Project, id: string, options?: ApplyOptions): Promise<ApplyResult>;
+export declare function scopeDiff(project: Project, id: string, from?: string, to?: string): Promise<ScopedDiff>;
+export interface UpdateStatusInput extends GraftUpdate {
+    status?: GraftStatus;
+}
+export declare function updateGraft(project: Project, id: string, input: UpdateStatusInput): Promise<Graft>;
+export interface RecordVariantOptions {
+    /** Refuse to record unless all anchors match at this version (the record is rolled back). */
+    verifyVersion?: string;
+    /** Extra text for the History entry (what moved upstream, how the variant differs). */
+    note?: string;
+}
+export interface RecordVariantResult {
+    graft: Graft;
+    /** Existing variants whose ranges were narrowed: index → new range. */
+    narrowed: {
+        module: string;
+        from: string;
+        to: string;
+    }[];
+    anchors?: AnchorReport;
+}
+/**
+ * Register a new variant for a version range. Never edits existing variant modules;
+ * may narrow open-ended ranges of existing variants so ranges stay disjoint.
+ */
+export declare function recordVariant(project: Project, id: string, input: VariantInput, options?: RecordVariantOptions): Promise<RecordVariantResult>;
+/** One line for a report: errors, then missed anchors grouped by file (long lists are cut). */
+export declare function summarizeMisses(report: AnchorReport, maxFiles?: number): string;
+export interface GraftStatusEntry {
+    id: string;
+    package: string;
+    mechanism: string;
+    status: GraftStatus;
+    verified: string;
+    installed?: string;
+    /** Anchor health against the installed version; absent for inactive grafts or when not installed. */
+    anchors?: AnchorReport;
+    error?: string;
+}
+/** Status of every graft, with anchor health against installed versions. */
+export declare function projectStatus(project: Project): Promise<{
+    grafts: GraftStatusEntry[];
+    invalid: {
+        id: string;
+        errors: string[];
+    }[];
+}>;
+export interface ApplyToProjectResult {
+    /** Grafts whose package-manager configuration was pointed at their selected variant. */
+    configured: {
+        id: string;
+        package: string;
+        version: string;
+        variant: string;
+    }[];
+    /** Reinstall command that was run, if any. */
+    installCommand?: string;
+    /** Anchor reports at the installed versions, after configuring and reinstalling. */
+    anchors: AnchorReport[];
+    errors: {
+        id: string;
+        error: string;
+    }[];
+}
+/**
+ * Make the project actually use its grafts: point the package manager at the variant selected
+ * for each installed version (e.g. pnpm patchedDependencies), reinstall, and re-check anchors.
+ */
+export declare function applyToProject(project: Project, options?: {
+    ids?: string[];
+    install?: boolean;
+}): Promise<ApplyToProjectResult>;
+/**
+ * Apply every active graft directly to the installed packages (Graft's built-in applier, run
+ * from postinstall). Offline and idempotent; returns per-graft reports.
+ */
+export declare function applyInstalled(project: Project, options?: {
+    ids?: string[];
+}): Promise<{
+    reports: InstalledApplyReport[];
+    ok: boolean;
+}>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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