knitto 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +869 -0
  3. package/dist/src/checks/run.d.ts +3 -0
  4. package/dist/src/checks/run.js +173 -0
  5. package/dist/src/checks/run.js.map +1 -0
  6. package/dist/src/cli.d.ts +2 -0
  7. package/dist/src/cli.js +406 -0
  8. package/dist/src/cli.js.map +1 -0
  9. package/dist/src/config.d.ts +11 -0
  10. package/dist/src/config.js +585 -0
  11. package/dist/src/config.js.map +1 -0
  12. package/dist/src/context/build.d.ts +2 -0
  13. package/dist/src/context/build.js +147 -0
  14. package/dist/src/context/build.js.map +1 -0
  15. package/dist/src/context/render.d.ts +7 -0
  16. package/dist/src/context/render.js +74 -0
  17. package/dist/src/context/render.js.map +1 -0
  18. package/dist/src/engine/apply.d.ts +2 -0
  19. package/dist/src/engine/apply.js +96 -0
  20. package/dist/src/engine/apply.js.map +1 -0
  21. package/dist/src/engine/diff.d.ts +2 -0
  22. package/dist/src/engine/diff.js +100 -0
  23. package/dist/src/engine/diff.js.map +1 -0
  24. package/dist/src/engine/plan.d.ts +2 -0
  25. package/dist/src/engine/plan.js +259 -0
  26. package/dist/src/engine/plan.js.map +1 -0
  27. package/dist/src/errors.d.ts +14 -0
  28. package/dist/src/errors.js +31 -0
  29. package/dist/src/errors.js.map +1 -0
  30. package/dist/src/filesystem/paths.d.ts +2 -0
  31. package/dist/src/filesystem/paths.js +47 -0
  32. package/dist/src/filesystem/paths.js.map +1 -0
  33. package/dist/src/hooks/run.d.ts +10 -0
  34. package/dist/src/hooks/run.js +105 -0
  35. package/dist/src/hooks/run.js.map +1 -0
  36. package/dist/src/index.d.ts +7 -0
  37. package/dist/src/index.js +7 -0
  38. package/dist/src/index.js.map +1 -0
  39. package/dist/src/lock.d.ts +2 -0
  40. package/dist/src/lock.js +16 -0
  41. package/dist/src/lock.js.map +1 -0
  42. package/dist/src/onboarding.d.ts +26 -0
  43. package/dist/src/onboarding.js +212 -0
  44. package/dist/src/onboarding.js.map +1 -0
  45. package/dist/src/parsers/index.d.ts +18 -0
  46. package/dist/src/parsers/index.js +194 -0
  47. package/dist/src/parsers/index.js.map +1 -0
  48. package/dist/src/parsers/json.d.ts +17 -0
  49. package/dist/src/parsers/json.js +214 -0
  50. package/dist/src/parsers/json.js.map +1 -0
  51. package/dist/src/parsers/merge.d.ts +1 -0
  52. package/dist/src/parsers/merge.js +17 -0
  53. package/dist/src/parsers/merge.js.map +1 -0
  54. package/dist/src/project/discover.d.ts +2 -0
  55. package/dist/src/project/discover.js +144 -0
  56. package/dist/src/project/discover.js.map +1 -0
  57. package/dist/src/rules/json-pointer.d.ts +3 -0
  58. package/dist/src/rules/json-pointer.js +114 -0
  59. package/dist/src/rules/json-pointer.js.map +1 -0
  60. package/dist/src/snapshots/canonical.d.ts +11 -0
  61. package/dist/src/snapshots/canonical.js +150 -0
  62. package/dist/src/snapshots/canonical.js.map +1 -0
  63. package/dist/src/sources/process.d.ts +3 -0
  64. package/dist/src/sources/process.js +28 -0
  65. package/dist/src/sources/process.js.map +1 -0
  66. package/dist/src/sources/resolve.d.ts +3 -0
  67. package/dist/src/sources/resolve.js +144 -0
  68. package/dist/src/sources/resolve.js.map +1 -0
  69. package/dist/src/template/init.d.ts +1 -0
  70. package/dist/src/template/init.js +62 -0
  71. package/dist/src/template/init.js.map +1 -0
  72. package/dist/src/template/manifest.d.ts +2 -0
  73. package/dist/src/template/manifest.js +80 -0
  74. package/dist/src/template/manifest.js.map +1 -0
  75. package/dist/src/template/release.d.ts +3 -0
  76. package/dist/src/template/release.js +8 -0
  77. package/dist/src/template/release.js.map +1 -0
  78. package/dist/src/template/validate.d.ts +2 -0
  79. package/dist/src/template/validate.js +62 -0
  80. package/dist/src/template/validate.js.map +1 -0
  81. package/dist/src/types.d.ts +242 -0
  82. package/dist/src/types.js +4 -0
  83. package/dist/src/types.js.map +1 -0
  84. package/dist/src/version.d.ts +2 -0
  85. package/dist/src/version.js +3 -0
  86. package/dist/src/version.js.map +1 -0
  87. package/package.json +51 -0
@@ -0,0 +1,147 @@
1
+ import path from "node:path";
2
+ import { readFile } from "node:fs/promises";
3
+ import { KnittoError } from "../errors.js";
4
+ import { renderTemplate } from "./render.js";
5
+ import { assertNoEscapingSymlink, resolveInside, } from "../filesystem/paths.js";
6
+ import { templateReleaseTag } from "../template/release.js";
7
+ async function readOptional(file) {
8
+ try {
9
+ return await readFile(file, "utf8");
10
+ }
11
+ catch (error) {
12
+ if (typeof error === "object" &&
13
+ error !== null &&
14
+ "code" in error &&
15
+ error.code === "ENOENT") {
16
+ return null;
17
+ }
18
+ throw error;
19
+ }
20
+ }
21
+ export async function buildContext(unit, manifest) {
22
+ const projectRoot = unit.path;
23
+ const config = unit.config;
24
+ const releaseTag = templateReleaseTag(manifest.release);
25
+ const inputPaths = new Set([
26
+ ...(manifest.inputs ?? []),
27
+ ...manifest.rules
28
+ .map((rule) => rule.destination)
29
+ .filter((destination) => !destination.includes("{{")),
30
+ ]);
31
+ const files = {};
32
+ for (const relativePath of [...inputPaths].sort()) {
33
+ const destination = resolveInside(projectRoot, relativePath);
34
+ await assertNoEscapingSymlink(projectRoot, destination);
35
+ const text = await readOptional(destination);
36
+ if (text === null)
37
+ continue;
38
+ const entry = { text };
39
+ if (relativePath.endsWith(".json")) {
40
+ try {
41
+ entry.json = JSON.parse(text);
42
+ }
43
+ catch (error) {
44
+ throw new KnittoError(`Unable to parse project JSON input: ${relativePath}`, "TEMPLATE", { cause: error });
45
+ }
46
+ }
47
+ files[relativePath] = entry;
48
+ }
49
+ const defaults = manifest.variables ?? {};
50
+ const configured = config.variables ?? {};
51
+ const promptedVariables = new Set((manifest.prompts ?? [])
52
+ .map((prompt) => prompt.path)
53
+ .filter((promptPath) => promptPath.startsWith("variables."))
54
+ .map((promptPath) => promptPath.slice("variables.".length)));
55
+ for (const prompt of manifest.prompts ?? []) {
56
+ if (prompt.when) {
57
+ const enabled = renderTemplate(prompt.when, {
58
+ project: {
59
+ path: projectRoot,
60
+ name: path.basename(projectRoot),
61
+ },
62
+ files,
63
+ metadata: config.metadata ?? {},
64
+ variables: {
65
+ ...defaults,
66
+ ...configured,
67
+ },
68
+ pkg: unit.packageJson,
69
+ derived: {},
70
+ }, `${prompt.path}.when`)
71
+ .trim()
72
+ .toLowerCase();
73
+ if (enabled === "" || enabled === "false" || enabled === "0")
74
+ continue;
75
+ }
76
+ const [section, name] = prompt.path.split(".", 2);
77
+ const values = section === "metadata" ? config.metadata : configured;
78
+ if (prompt.required && !(name in (values ?? {}))) {
79
+ throw new KnittoError(`Template input ${prompt.path} is required; run knitto plan interactively or pass --set ${prompt.path}=value`, "CONFIG");
80
+ }
81
+ }
82
+ for (const name of Object.keys(configured)) {
83
+ if (!(name in defaults) && !promptedVariables.has(name)) {
84
+ throw new KnittoError(`Project config sets unknown template variable: ${name}`, "CONFIG");
85
+ }
86
+ }
87
+ return {
88
+ template: {
89
+ name: manifest.name,
90
+ ...(manifest.engine ? { engine: manifest.engine } : {}),
91
+ ...(manifest.release
92
+ ? {
93
+ release: {
94
+ provider: manifest.release.provider,
95
+ version: manifest.release.version,
96
+ ...(releaseTag ? { tag: releaseTag } : {}),
97
+ },
98
+ }
99
+ : {}),
100
+ },
101
+ project: {
102
+ path: projectRoot,
103
+ name: path.basename(projectRoot),
104
+ },
105
+ files,
106
+ metadata: config.metadata ?? {},
107
+ variables: {
108
+ ...defaults,
109
+ ...configured,
110
+ },
111
+ pkg: unit.packageJson,
112
+ derived: {
113
+ isRoot: unit.isRoot,
114
+ isWorkspace: !unit.isRoot,
115
+ isMono: unit.workspacePaths.length > 0,
116
+ isRootMono: unit.isRoot && unit.workspacePaths.length > 0,
117
+ repoDir: unit.repositoryRoot,
118
+ moduleDir: unit.path,
119
+ pkgPath: unit.relativePath,
120
+ pkgDir: unit.relativePath === "." ? "" : `${unit.relativePath}/`,
121
+ pkgName: typeof unit.packageJson.name === "string"
122
+ ? unit.packageJson.name
123
+ : path.basename(unit.path),
124
+ pkgNameFs: typeof unit.packageJson.name === "string"
125
+ ? unit.packageJson.name.replaceAll("/", "-").replaceAll("@", "")
126
+ : path.basename(unit.path),
127
+ workspacePaths: unit.workspacePaths,
128
+ workspaceGlobs: unit.workspacePaths.map((workspace) => `${workspace}/**`),
129
+ isPrivate: Boolean(unit.packageJson.private),
130
+ isPublic: !unit.packageJson.private,
131
+ esm: unit.packageJson.type === "module" ||
132
+ Boolean((config.variables ?? {}).typescript) ||
133
+ Boolean((config.variables ?? {}).esm),
134
+ cjsExt: unit.packageJson.type === "module" ||
135
+ Boolean((config.variables ?? {}).typescript) ||
136
+ Boolean((config.variables ?? {}).esm)
137
+ ? "cjs"
138
+ : "js",
139
+ deleteJsExt: unit.packageJson.type === "module" ||
140
+ Boolean((config.variables ?? {}).typescript) ||
141
+ Boolean((config.variables ?? {}).esm)
142
+ ? "js"
143
+ : "cjs",
144
+ },
145
+ };
146
+ }
147
+ //# sourceMappingURL=build.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/context/build.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { RenderContext } from "../types.js";
2
+ export declare const DELETE_SENTINEL = "__KNITTO_DELETE__";
3
+ export interface TemplatePartial {
4
+ name: string;
5
+ contents: string;
6
+ }
7
+ export declare function renderTemplate(template: string, context: RenderContext, name: string, partials?: TemplatePartial[]): string;
@@ -0,0 +1,74 @@
1
+ import path from "node:path";
2
+ import Handlebars from "handlebars";
3
+ import { minVersion } from "semver";
4
+ import { KnittoError } from "../errors.js";
5
+ export const DELETE_SENTINEL = "__KNITTO_DELETE__";
6
+ function createHandlebars(partials) {
7
+ const handlebars = Handlebars.create();
8
+ handlebars.registerHelper("json", (value) => {
9
+ return new handlebars.SafeString(JSON.stringify(value));
10
+ });
11
+ handlebars.registerHelper("remove", () => {
12
+ return new handlebars.SafeString(JSON.stringify(DELETE_SENTINEL));
13
+ });
14
+ handlebars.registerHelper("obj", (options) => options.hash);
15
+ handlebars.registerHelper("extGlob", (values) => `{${values.map(String).join(",")}}`);
16
+ handlebars.registerHelper("join", (values, separator) => values.join(typeof separator === "string" ? separator : ", "));
17
+ handlebars.registerHelper("pluck", (values, key) => values.map((value) => typeof value === "object" && value !== null
18
+ ? value[key]
19
+ : undefined));
20
+ handlebars.registerHelper("quote", (values) => values.map((value) => `'${String(value)}'`));
21
+ handlebars.registerHelper("last", (values) => values.at(-1));
22
+ handlebars.registerHelper("lowercase", (value) => String(value).toLowerCase());
23
+ handlebars.registerHelper("uppercase", (value) => String(value).toUpperCase());
24
+ handlebars.registerHelper("basename", (value) => path.basename(String(value)));
25
+ handlebars.registerHelper("default", (value, fallback) => value ?? fallback);
26
+ handlebars.registerHelper("appendMissingLines", (value, ...valuesAndOptions) => {
27
+ const values = valuesAndOptions.slice(0, -1).map(String);
28
+ const text = value === undefined || value === null ? "" : String(value);
29
+ const newline = text.includes("\r\n") ? "\r\n" : "\n";
30
+ const existing = new Set(text.split(/\r?\n/));
31
+ const missing = values.filter((line) => !existing.has(line));
32
+ if (missing.length === 0)
33
+ return new handlebars.SafeString(text);
34
+ const separator = text.length === 0 || text.endsWith(newline) ? "" : newline;
35
+ return new handlebars.SafeString(`${text}${separator}${missing.join(newline)}${newline}`);
36
+ });
37
+ handlebars.registerHelper("lte", (left, right) => Number(left) <= Number(right));
38
+ handlebars.registerHelper("eq", (left, right) => Object.is(left, right));
39
+ handlebars.registerHelper("semverRangeMajor", (value) => {
40
+ const version = minVersion(String(value));
41
+ if (!version) {
42
+ throw new Error(`Invalid semantic version range: ${String(value)}`);
43
+ }
44
+ return version.major;
45
+ });
46
+ for (const partial of partials) {
47
+ handlebars.registerPartial(partial.name, partial.contents);
48
+ }
49
+ return handlebars;
50
+ }
51
+ export function renderTemplate(template, context, name, partials = []) {
52
+ try {
53
+ const handlebars = createHandlebars(partials);
54
+ const compiled = handlebars.compile(template, {
55
+ strict: true,
56
+ noEscape: true,
57
+ preventIndent: true,
58
+ });
59
+ return compiled({
60
+ ...context.variables,
61
+ ...context.derived,
62
+ ...context,
63
+ }, {
64
+ allowProtoMethodsByDefault: false,
65
+ allowProtoPropertiesByDefault: false,
66
+ });
67
+ }
68
+ catch (error) {
69
+ throw new KnittoError(`Unable to render template: ${name}`, "TEMPLATE", {
70
+ cause: error,
71
+ });
72
+ }
73
+ }
74
+ //# sourceMappingURL=render.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/context/render.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { ReconciliationPlan } from "../types.js";
2
+ export declare function applyPlan(plan: ReconciliationPlan): Promise<void>;
@@ -0,0 +1,96 @@
1
+ import { createHash } from "node:crypto";
2
+ import path from "node:path";
3
+ import { chmod, mkdir, readFile, rename, rmdir, rm, unlink, writeFile, } from "node:fs/promises";
4
+ import { KnittoError } from "../errors.js";
5
+ import { assertNoEscapingSymlink, resolveInside } from "../filesystem/paths.js";
6
+ function digest(contents) {
7
+ return `sha256:${createHash("sha256").update(contents).digest("hex")}`;
8
+ }
9
+ async function pruneEmptyParents(file, projectRoot) {
10
+ let directory = path.dirname(file);
11
+ while (directory !== projectRoot) {
12
+ try {
13
+ await rmdir(directory);
14
+ }
15
+ catch (error) {
16
+ if (typeof error === "object" &&
17
+ error !== null &&
18
+ "code" in error &&
19
+ (error.code === "ENOTEMPTY" ||
20
+ error.code === "EEXIST" ||
21
+ error.code === "ENOENT")) {
22
+ return;
23
+ }
24
+ throw error;
25
+ }
26
+ directory = path.dirname(directory);
27
+ }
28
+ }
29
+ async function writeAtomically(destination, contents, mode) {
30
+ await mkdir(path.dirname(destination), { recursive: true });
31
+ const temporary = `${destination}.knitto-${process.pid}-${Date.now()}`;
32
+ try {
33
+ await writeFile(temporary, contents, {
34
+ ...(mode !== undefined ? { mode } : {}),
35
+ });
36
+ if (mode !== undefined)
37
+ await chmod(temporary, mode);
38
+ await rename(temporary, destination);
39
+ }
40
+ finally {
41
+ await rm(temporary, { force: true });
42
+ }
43
+ }
44
+ export async function applyPlan(plan) {
45
+ for (const operation of plan.operations) {
46
+ const destination = resolveInside(plan.projectRoot, operation.path);
47
+ const current = await readFile(destination, "utf8").catch((error) => {
48
+ if (typeof error === "object" &&
49
+ error !== null &&
50
+ "code" in error &&
51
+ error.code === "ENOENT") {
52
+ return null;
53
+ }
54
+ throw error;
55
+ });
56
+ const currentDigest = current === null ? null : digest(current);
57
+ if (currentDigest !== operation.beforeDigest) {
58
+ throw new KnittoError(`Refusing to apply stale plan; ${operation.path} changed after planning`, "APPLY");
59
+ }
60
+ }
61
+ const applied = [];
62
+ try {
63
+ for (const operation of plan.operations) {
64
+ const destination = resolveInside(plan.projectRoot, operation.path);
65
+ await assertNoEscapingSymlink(plan.projectRoot, destination);
66
+ if (operation.type === "delete") {
67
+ await unlink(destination);
68
+ await pruneEmptyParents(destination, plan.projectRoot);
69
+ applied.push(operation);
70
+ continue;
71
+ }
72
+ await writeAtomically(destination, operation.after, operation.mode);
73
+ applied.push(operation);
74
+ }
75
+ }
76
+ catch (error) {
77
+ try {
78
+ for (const operation of [...applied].reverse()) {
79
+ const destination = resolveInside(plan.projectRoot, operation.path);
80
+ if (operation.before === null) {
81
+ await rm(destination, { force: true });
82
+ }
83
+ else {
84
+ await writeAtomically(destination, operation.before);
85
+ }
86
+ }
87
+ }
88
+ catch (rollbackError) {
89
+ throw new KnittoError("Apply failed and the previous project state could not be fully restored", "APPLY", { cause: rollbackError });
90
+ }
91
+ throw new KnittoError("Unable to apply reconciliation plan", "APPLY", {
92
+ cause: error,
93
+ });
94
+ }
95
+ }
96
+ //# sourceMappingURL=apply.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/engine/apply.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { ReconciliationPlan } from "../types.js";
2
+ export declare function formatPlan(plan: ReconciliationPlan): string;
@@ -0,0 +1,100 @@
1
+ import { createTwoFilesPatch, diffLines } from "diff";
2
+ function plural(count, singular, pluralValue = `${singular}s`) {
3
+ return `${count} ${count === 1 ? singular : pluralValue}`;
4
+ }
5
+ function displayDigest(digest) {
6
+ const [algorithm, value] = digest.split(":", 2);
7
+ return value ? `${algorithm}:${value.slice(0, 12)}` : digest.slice(0, 19);
8
+ }
9
+ function operationAction(operation) {
10
+ if (operation.type === "delete")
11
+ return "DELETE";
12
+ return operation.before === null ? "CREATE" : "UPDATE";
13
+ }
14
+ function changedLineCounts(operation) {
15
+ const before = operation.type === "delete" ? operation.before : operation.before ?? "";
16
+ const after = operation.type === "delete" ? "" : operation.after;
17
+ let added = 0;
18
+ let removed = 0;
19
+ for (const change of diffLines(before, after)) {
20
+ const count = change.count ?? 0;
21
+ if (change.added)
22
+ added += count;
23
+ if (change.removed)
24
+ removed += count;
25
+ }
26
+ return { added, removed };
27
+ }
28
+ function patchSymbol(operation) {
29
+ if (operation.op === "add" || operation.op === "copy")
30
+ return "+";
31
+ if (operation.op === "remove")
32
+ return "-";
33
+ return "~";
34
+ }
35
+ function formatOperation(operation, index) {
36
+ const action = operationAction(operation);
37
+ const lines = changedLineCounts(operation);
38
+ const summary = [
39
+ lines.added > 0 ? plural(lines.added, "line") + " added" : "",
40
+ lines.removed > 0 ? plural(lines.removed, "line") + " removed" : "",
41
+ ]
42
+ .filter(Boolean)
43
+ .join(", ");
44
+ const before = operation.type === "delete" ? operation.before : operation.before ?? "";
45
+ const after = operation.type === "delete" ? "" : operation.after;
46
+ const patch = createTwoFilesPatch(operation.type === "write" && operation.before === null
47
+ ? "/dev/null"
48
+ : `a/${operation.path}`, operation.type === "delete" ? "/dev/null" : `b/${operation.path}`, before, after, operation.ruleId, operation.ruleId);
49
+ const structured = operation.type === "write" && operation.jsonPatch?.length
50
+ ? [
51
+ " Structured changes:",
52
+ ...operation.jsonPatch.map((entry) => ` ${patchSymbol(entry)} ${entry.path || "/"}`),
53
+ "",
54
+ ]
55
+ : [];
56
+ return [
57
+ `${index + 1}. ${action} ${operation.path}`,
58
+ ` Rule: ${operation.ruleId}`,
59
+ ` Change: ${summary || "content changed"}`,
60
+ ...structured,
61
+ "",
62
+ patch.trimEnd(),
63
+ ].join("\n");
64
+ }
65
+ export function formatPlan(plan) {
66
+ const writes = plan.operations.filter((operation) => operation.type === "write").length;
67
+ const deletes = plan.operations.length - writes;
68
+ const excludedPointers = Object.values(plan.excludedPointers).reduce((count, pointers) => count + pointers.length, 0);
69
+ const compliant = plan.operations.length === 0 && plan.checks.length === 0;
70
+ const header = [
71
+ "Knitto Plan",
72
+ "",
73
+ `Project: ${plan.projectRoot}`,
74
+ `Template: ${displayDigest(plan.templateDigest)}`,
75
+ `Status: ${compliant ? "Compliant" : "Changes required"}`,
76
+ `Changes: ${plural(writes, "write")}, ${plural(deletes, "deletion")}`,
77
+ `Checks: ${plural(plan.checks.length, "issue")}`,
78
+ `Excluded: ${plural(plan.excludedRules.length, "rule")}, ${plural(excludedPointers, "pointer")}`,
79
+ ];
80
+ if (compliant)
81
+ return `${header.join("\n")}\n`;
82
+ const sections = [header.join("\n")];
83
+ if (plan.operations.length > 0) {
84
+ sections.push(["Changes\n-------", ...plan.operations.map(formatOperation)].join("\n\n"));
85
+ }
86
+ if (plan.checks.length > 0) {
87
+ sections.push([
88
+ "Policy Issues\n-------------",
89
+ ...plan.checks.map((check, index) => [
90
+ `${index + 1}. ${check.title}`,
91
+ ` Check: ${check.id}`,
92
+ ` Project: ${check.project}`,
93
+ ...check.body.map((line) => ` ${line}`),
94
+ ...(check.solution ? [` Fix: ${check.solution}`] : []),
95
+ ].join("\n")),
96
+ ].join("\n\n"));
97
+ }
98
+ return `${sections.join("\n\n")}\n`;
99
+ }
100
+ //# sourceMappingURL=diff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/engine/diff.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { ProjectConfig, ReconciliationPlan, Snapshot } from "../types.js";
2
+ export declare function createPlan(projectRoot: string, config: ProjectConfig, snapshot: Snapshot): Promise<ReconciliationPlan>;