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.
- package/LICENSE +21 -0
- package/README.md +869 -0
- package/dist/src/checks/run.d.ts +3 -0
- package/dist/src/checks/run.js +173 -0
- package/dist/src/checks/run.js.map +1 -0
- package/dist/src/cli.d.ts +2 -0
- package/dist/src/cli.js +406 -0
- package/dist/src/cli.js.map +1 -0
- package/dist/src/config.d.ts +11 -0
- package/dist/src/config.js +585 -0
- package/dist/src/config.js.map +1 -0
- package/dist/src/context/build.d.ts +2 -0
- package/dist/src/context/build.js +147 -0
- package/dist/src/context/build.js.map +1 -0
- package/dist/src/context/render.d.ts +7 -0
- package/dist/src/context/render.js +74 -0
- package/dist/src/context/render.js.map +1 -0
- package/dist/src/engine/apply.d.ts +2 -0
- package/dist/src/engine/apply.js +96 -0
- package/dist/src/engine/apply.js.map +1 -0
- package/dist/src/engine/diff.d.ts +2 -0
- package/dist/src/engine/diff.js +100 -0
- package/dist/src/engine/diff.js.map +1 -0
- package/dist/src/engine/plan.d.ts +2 -0
- package/dist/src/engine/plan.js +259 -0
- package/dist/src/engine/plan.js.map +1 -0
- package/dist/src/errors.d.ts +14 -0
- package/dist/src/errors.js +31 -0
- package/dist/src/errors.js.map +1 -0
- package/dist/src/filesystem/paths.d.ts +2 -0
- package/dist/src/filesystem/paths.js +47 -0
- package/dist/src/filesystem/paths.js.map +1 -0
- package/dist/src/hooks/run.d.ts +10 -0
- package/dist/src/hooks/run.js +105 -0
- package/dist/src/hooks/run.js.map +1 -0
- package/dist/src/index.d.ts +7 -0
- package/dist/src/index.js +7 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/lock.d.ts +2 -0
- package/dist/src/lock.js +16 -0
- package/dist/src/lock.js.map +1 -0
- package/dist/src/onboarding.d.ts +26 -0
- package/dist/src/onboarding.js +212 -0
- package/dist/src/onboarding.js.map +1 -0
- package/dist/src/parsers/index.d.ts +18 -0
- package/dist/src/parsers/index.js +194 -0
- package/dist/src/parsers/index.js.map +1 -0
- package/dist/src/parsers/json.d.ts +17 -0
- package/dist/src/parsers/json.js +214 -0
- package/dist/src/parsers/json.js.map +1 -0
- package/dist/src/parsers/merge.d.ts +1 -0
- package/dist/src/parsers/merge.js +17 -0
- package/dist/src/parsers/merge.js.map +1 -0
- package/dist/src/project/discover.d.ts +2 -0
- package/dist/src/project/discover.js +144 -0
- package/dist/src/project/discover.js.map +1 -0
- package/dist/src/rules/json-pointer.d.ts +3 -0
- package/dist/src/rules/json-pointer.js +114 -0
- package/dist/src/rules/json-pointer.js.map +1 -0
- package/dist/src/snapshots/canonical.d.ts +11 -0
- package/dist/src/snapshots/canonical.js +150 -0
- package/dist/src/snapshots/canonical.js.map +1 -0
- package/dist/src/sources/process.d.ts +3 -0
- package/dist/src/sources/process.js +28 -0
- package/dist/src/sources/process.js.map +1 -0
- package/dist/src/sources/resolve.d.ts +3 -0
- package/dist/src/sources/resolve.js +144 -0
- package/dist/src/sources/resolve.js.map +1 -0
- package/dist/src/template/init.d.ts +1 -0
- package/dist/src/template/init.js +62 -0
- package/dist/src/template/init.js.map +1 -0
- package/dist/src/template/manifest.d.ts +2 -0
- package/dist/src/template/manifest.js +80 -0
- package/dist/src/template/manifest.js.map +1 -0
- package/dist/src/template/release.d.ts +3 -0
- package/dist/src/template/release.js +8 -0
- package/dist/src/template/release.js.map +1 -0
- package/dist/src/template/validate.d.ts +2 -0
- package/dist/src/template/validate.js +62 -0
- package/dist/src/template/validate.js.map +1 -0
- package/dist/src/types.d.ts +242 -0
- package/dist/src/types.js +4 -0
- package/dist/src/types.js.map +1 -0
- package/dist/src/version.d.ts +2 -0
- package/dist/src/version.js +3 -0
- package/dist/src/version.js.map +1 -0
- 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,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,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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"}
|