@git.zone/cli 6.17.0 → 6.17.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.
@@ -5,11 +5,11 @@
5
5
  "schema": {
6
6
  "type": "object",
7
7
  "properties": {
8
- "npmci": {
8
+ "@ship.zone/szci": {
9
9
  "type": "object",
10
- "description": "settings for npmci"
10
+ "description": "settings for szci"
11
11
  },
12
- "gitzone": {
12
+ "@git.zone/cli": {
13
13
  "type": "object",
14
14
  "description": "settings for gitzone",
15
15
  "properties": {
@@ -3,7 +3,7 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@git.zone/cli',
6
- version: '6.17.0',
6
+ version: '6.17.1',
7
7
  description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
8
8
  };
9
9
  //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxlQUFlO0lBQ3JCLE9BQU8sRUFBRSxRQUFRO0lBQ2pCLFdBQVcsRUFBRSwrTEFBK0w7Q0FDN00sQ0FBQSJ9
@@ -1,12 +1,28 @@
1
1
  import { BaseFormatter } from '../classes.baseformatter.js';
2
- import type { IPlannedChange } from '../interfaces.format.js';
2
+ import type { IFormatWarning, IPlannedChange } from '../interfaces.format.js';
3
3
  export declare class TemplatesFormatter extends BaseFormatter {
4
+ private replacementWarnings;
4
5
  get name(): string;
6
+ validate(): Promise<IFormatWarning[]>;
5
7
  /**
6
8
  * Render a template directory through smartscaf and return a map of path → content.
7
9
  */
8
10
  private renderTemplate;
9
11
  analyze(): Promise<IPlannedChange[]>;
12
+ /**
13
+ * Parse a JSON object a merge needs. A file that is not a JSON object cannot
14
+ * be merged into, and guessing its shape would lose data: the caller is told
15
+ * why and falls back to replacing it.
16
+ */
17
+ private parseJsonObjectForMerge;
18
+ /**
19
+ * Merge the rendered template into the destination's own top-level keys. The
20
+ * template owns every key it declares; a key only the project declares — an
21
+ * editor setting the template never knew about — survives the update.
22
+ * A template-owned key is taken as a whole, so an array the template declares
23
+ * replaces the project's array of the same name.
24
+ */
25
+ private mergeJsonTopLevel;
10
26
  private analyzeTemplate;
11
27
  applyChange(change: IPlannedChange): Promise<void>;
12
28
  }
@@ -3,9 +3,13 @@ import * as plugins from '../mod.plugins.js';
3
3
  import * as paths from '../../paths.js';
4
4
  import { logger, logVerbose } from '../../gitzone.logging.js';
5
5
  export class TemplatesFormatter extends BaseFormatter {
6
+ replacementWarnings = [];
6
7
  get name() {
7
8
  return 'templates';
8
9
  }
10
+ async validate() {
11
+ return this.replacementWarnings;
12
+ }
9
13
  /**
10
14
  * Render a template directory through smartscaf and return a map of path → content.
11
15
  */
@@ -31,10 +35,19 @@ export class TemplatesFormatter extends BaseFormatter {
31
35
  const changes = [];
32
36
  const project = this.project;
33
37
  const projectType = project.gitzoneConfig?.data?.projectType;
38
+ this.replacementWarnings = [];
34
39
  // VSCode template - for all projects
35
40
  const vscodeChanges = await this.analyzeTemplate('vscode', [
36
- { templatePath: '.vscode/settings.json', destPath: '.vscode/settings.json' },
37
- { templatePath: '.vscode/launch.json', destPath: '.vscode/launch.json' },
41
+ {
42
+ templatePath: '.vscode/settings.json',
43
+ destPath: '.vscode/settings.json',
44
+ merge: 'jsonTopLevel',
45
+ },
46
+ {
47
+ templatePath: '.vscode/launch.json',
48
+ destPath: '.vscode/launch.json',
49
+ merge: 'jsonTopLevel',
50
+ },
38
51
  ]);
39
52
  changes.push(...vscodeChanges);
40
53
  // CI and other templates based on projectType
@@ -45,26 +58,26 @@ export class TemplatesFormatter extends BaseFormatter {
45
58
  || project.gitzoneConfig?.data?.npmciOptions?.npmAccessLevel;
46
59
  const ciTemplate = accessLevel === 'public' ? 'ci_default' : 'ci_default_private';
47
60
  const ciChanges = await this.analyzeTemplate(ciTemplate, [
48
- { templatePath: '.gitea/workflows/default_nottags.yaml', destPath: '.gitea/workflows/default_nottags.yaml' },
49
- { templatePath: '.gitea/workflows/default_tags.yaml', destPath: '.gitea/workflows/default_tags.yaml' },
61
+ { templatePath: '.gitea/workflows/default_nottags.yaml', destPath: '.gitea/workflows/default_nottags.yaml', merge: 'replace' },
62
+ { templatePath: '.gitea/workflows/default_tags.yaml', destPath: '.gitea/workflows/default_tags.yaml', merge: 'replace' },
50
63
  ]);
51
64
  changes.push(...ciChanges);
52
65
  break;
53
66
  case 'service':
54
67
  case 'website':
55
68
  const dockerCiChanges = await this.analyzeTemplate('ci_docker', [
56
- { templatePath: '.gitea/workflows/docker_nottags.yaml', destPath: '.gitea/workflows/docker_nottags.yaml' },
57
- { templatePath: '.gitea/workflows/docker_tags.yaml', destPath: '.gitea/workflows/docker_tags.yaml' },
69
+ { templatePath: '.gitea/workflows/docker_nottags.yaml', destPath: '.gitea/workflows/docker_nottags.yaml', merge: 'replace' },
70
+ { templatePath: '.gitea/workflows/docker_tags.yaml', destPath: '.gitea/workflows/docker_tags.yaml', merge: 'replace' },
58
71
  ]);
59
72
  changes.push(...dockerCiChanges);
60
73
  const dockerfileChanges = await this.analyzeTemplate('dockerfile_service', [
61
- { templatePath: 'Dockerfile', destPath: 'Dockerfile' },
62
- { templatePath: 'dockerignore', destPath: '.dockerignore' },
74
+ { templatePath: 'Dockerfile', destPath: 'Dockerfile', merge: 'replace' },
75
+ { templatePath: 'dockerignore', destPath: '.dockerignore', merge: 'replace' },
63
76
  ]);
64
77
  changes.push(...dockerfileChanges);
65
78
  const cliChanges = await this.analyzeTemplate('cli', [
66
- { templatePath: 'cli.js', destPath: 'cli.js' },
67
- { templatePath: 'cli.ts.js', destPath: 'cli.ts.js' },
79
+ { templatePath: 'cli.js', destPath: 'cli.js', merge: 'replace' },
80
+ { templatePath: 'cli.ts.js', destPath: 'cli.ts.js', merge: 'replace' },
68
81
  ]);
69
82
  changes.push(...cliChanges);
70
83
  break;
@@ -72,19 +85,71 @@ export class TemplatesFormatter extends BaseFormatter {
72
85
  // Update templates based on projectType
73
86
  if (projectType === 'website') {
74
87
  const websiteChanges = await this.analyzeTemplate('website_update', [
75
- { templatePath: 'html/index.html', destPath: 'html/index.html' },
88
+ { templatePath: 'html/index.html', destPath: 'html/index.html', merge: 'replace' },
76
89
  ]);
77
90
  changes.push(...websiteChanges);
78
91
  }
79
92
  else if (projectType === 'wcc') {
80
93
  const wccChanges = await this.analyzeTemplate('wcc_update', [
81
- { templatePath: 'html/index.html', destPath: 'html/index.html' },
82
- { templatePath: 'html/index.ts', destPath: 'html/index.ts' },
94
+ { templatePath: 'html/index.html', destPath: 'html/index.html', merge: 'replace' },
95
+ { templatePath: 'html/index.ts', destPath: 'html/index.ts', merge: 'replace' },
83
96
  ]);
84
97
  changes.push(...wccChanges);
85
98
  }
86
99
  return changes;
87
100
  }
101
+ /**
102
+ * Parse a JSON object a merge needs. A file that is not a JSON object cannot
103
+ * be merged into, and guessing its shape would lose data: the caller is told
104
+ * why and falls back to replacing it.
105
+ */
106
+ parseJsonObjectForMerge(contentArg, sourceDescriptionArg) {
107
+ let parsed;
108
+ try {
109
+ parsed = JSON.parse(contentArg);
110
+ }
111
+ catch (error) {
112
+ const errorMessage = error instanceof Error ? error.message : String(error);
113
+ return {
114
+ reason: `${sourceDescriptionArg} is not valid JSON (${errorMessage})`,
115
+ };
116
+ }
117
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
118
+ return { reason: `${sourceDescriptionArg} is not a JSON object` };
119
+ }
120
+ return { object: parsed };
121
+ }
122
+ /**
123
+ * Merge the rendered template into the destination's own top-level keys. The
124
+ * template owns every key it declares; a key only the project declares — an
125
+ * editor setting the template never knew about — survives the update.
126
+ * A template-owned key is taken as a whole, so an array the template declares
127
+ * replaces the project's array of the same name.
128
+ */
129
+ mergeJsonTopLevel(currentContentArg, renderedContentArg) {
130
+ const rendered = this.parseJsonObjectForMerge(renderedContentArg, 'the rendered template');
131
+ const current = this.parseJsonObjectForMerge(currentContentArg, 'the current file');
132
+ const renderedObject = rendered.object;
133
+ const currentObject = current.object;
134
+ if (!renderedObject || !currentObject) {
135
+ return {
136
+ content: renderedContentArg,
137
+ replacedReason: rendered.reason ?? current.reason,
138
+ };
139
+ }
140
+ // Nothing of the project's own is at stake, so the template's own text —
141
+ // its indentation and inline arrays included — stays the settled state.
142
+ const foreignKeys = Object.keys(currentObject).filter((keyArg) => !(keyArg in renderedObject));
143
+ if (foreignKeys.length === 0) {
144
+ return { content: renderedContentArg };
145
+ }
146
+ const merged = {
147
+ ...currentObject,
148
+ ...renderedObject,
149
+ };
150
+ const trailingNewline = renderedContentArg.endsWith('\n') ? '\n' : '';
151
+ return { content: `${JSON.stringify(merged, null, 2)}${trailingNewline}` };
152
+ }
88
153
  async analyzeTemplate(templateName, files) {
89
154
  const changes = [];
90
155
  const templateDir = plugins.path.join(paths.templatesDir, templateName);
@@ -118,13 +183,29 @@ export class TemplatesFormatter extends BaseFormatter {
118
183
  .encoding('utf8')
119
184
  .read());
120
185
  }
121
- if (processedContent !== currentContent) {
186
+ const outcome = destExists && file.merge === 'jsonTopLevel'
187
+ ? this.mergeJsonTopLevel(currentContent, processedContent)
188
+ : { content: processedContent };
189
+ if (outcome.content !== currentContent) {
190
+ // A replacement the project did not ask for must state its reason
191
+ // where the decision is made: in the plan the user confirms.
192
+ if (outcome.replacedReason) {
193
+ const replacementMessage = `${file.destPath} is replaced by the ${templateName} template instead of merged, because ${outcome.replacedReason}. Top-level keys only this project declares are lost.`;
194
+ this.replacementWarnings.push({
195
+ level: 'warning',
196
+ message: replacementMessage,
197
+ module: this.name,
198
+ });
199
+ logVerbose(replacementMessage);
200
+ }
122
201
  changes.push({
123
202
  type: destExists ? 'modify' : 'create',
124
203
  path: file.destPath,
125
204
  module: this.name,
126
- description: `Apply template ${templateName}/${file.templatePath}`,
127
- content: processedContent,
205
+ description: outcome.replacedReason
206
+ ? `Replace ${file.destPath}: ${outcome.replacedReason}`
207
+ : `Apply template ${templateName}/${file.templatePath}`,
208
+ content: outcome.content,
128
209
  });
129
210
  }
130
211
  }
@@ -142,4 +223,4 @@ export class TemplatesFormatter extends BaseFormatter {
142
223
  logger.log('info', `Applied template to ${change.path}`);
143
224
  }
144
225
  }
145
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVtcGxhdGVzLmZvcm1hdHRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL21vZF9mb3JtYXQvZm9ybWF0dGVycy90ZW1wbGF0ZXMuZm9ybWF0dGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUU1RCxPQUFPLEtBQUssT0FBTyxNQUFNLG1CQUFtQixDQUFDO0FBQzdDLE9BQU8sS0FBSyxLQUFLLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEMsT0FBTyxFQUFFLE1BQU0sRUFBRSxVQUFVLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUU5RCxNQUFNLE9BQU8sa0JBQW1CLFNBQVEsYUFBYTtJQUNuRCxJQUFJLElBQUk7UUFDTixPQUFPLFdBQVcsQ0FBQztJQUNyQixDQUFDO0lBRUQ7O09BRUc7SUFDSyxLQUFLLENBQUMsY0FBYyxDQUFDLFlBQW9CO1FBQy9DLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQUUsWUFBWSxDQUFDLENBQUM7UUFFeEUsTUFBTSxZQUFZLEdBQUcsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLFlBQVksQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUNyRSxNQUFNLFlBQVksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1FBRXpDLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLElBQUksQ0FBQztRQUNyRCxJQUFJLFdBQVcsRUFBRSxDQUFDO1lBQ2hCLE1BQU0sWUFBWSxDQUFDLGVBQWUsQ0FBQztnQkFDakMsTUFBTSxFQUFFLFdBQVcsQ0FBQyxNQUFNO2dCQUMxQixXQUFXLEVBQUUsV0FBVyxDQUFDLFdBQVc7YUFDckMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUVELE1BQU0sYUFBYSxHQUFHLE1BQU0sWUFBWSxDQUFDLGNBQWMsRUFBRSxD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
226
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVtcGxhdGVzLmZvcm1hdHRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL21vZF9mb3JtYXQvZm9ybWF0dGVycy90ZW1wbGF0ZXMuZm9ybWF0dGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUU1RCxPQUFPLEtBQUssT0FBTyxNQUFNLG1CQUFtQixDQUFDO0FBQzdDLE9BQU8sS0FBSyxLQUFLLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEMsT0FBTyxFQUFFLE1BQU0sRUFBRSxVQUFVLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQTZCOUQsTUFBTSxPQUFPLGtCQUFtQixTQUFRLGFBQWE7SUFDM0MsbUJBQW1CLEdBQXFCLEVBQUUsQ0FBQztJQUVuRCxJQUFJLElBQUk7UUFDTixPQUFPLFdBQVcsQ0FBQztJQUNyQixDQUFDO0lBRUQsS0FBSyxDQUFDLFFBQVE7UUFDWixPQUFPLElBQUksQ0FBQyxtQkFBbUIsQ0FBQztJQUNsQyxDQUFDO0lBRUQ7O09BRUc7SUFDSyxLQUFLLENBQUMsY0FBYyxDQUFDLFlBQW9CO1FBQy9DLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQUUsWUFBWSxDQUFDLENBQUM7UUFFeEUsTUFBTSxZQUFZLEdBQUcsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLFlBQVksQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUNyRSxNQUFNLFlBQVksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1FBRXpDLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLElBQUksQ0FBQztRQUNyRCxJQUFJLFdBQVcsRUFBRSxDQUFDO1lBQ2hCLE1BQU0sWUFBWSxDQUFDLGVBQWUsQ0FBQztnQkFDakMsTUFBTSxFQUFFLFdBQVcsQ0FBQyxNQUFNO2dCQUMxQixXQUFX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
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@git.zone/cli",
3
3
  "private": false,
4
- "version": "6.17.0",
4
+ "version": "6.17.1",
5
5
  "description": "A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.",
6
6
  "main": "dist_ts/index.js",
7
7
  "typings": "dist_ts/index.d.ts",
@@ -39,24 +39,24 @@
39
39
  },
40
40
  "homepage": "https://code.foss.global/git.zone/cli#README",
41
41
  "devDependencies": {
42
- "@api.global/typedrequest": "8.0.4",
43
- "@git.zone/tsbuild": "^4.5.0",
44
- "@git.zone/tspack": "1.3.0",
42
+ "@api.global/typedrequest": "^8.2.0",
43
+ "@git.zone/tsbuild": "^4.5.1",
44
+ "@git.zone/tspack": "^1.4.0",
45
45
  "@git.zone/tsrun": "^2.0.6",
46
- "@git.zone/tstest": "6.1.1",
47
- "@types/node": "26.5.1"
46
+ "@git.zone/tstest": "^6.1.2",
47
+ "@types/node": "^26.5.1"
48
48
  },
49
49
  "dependencies": {
50
50
  "@aws-sdk/client-s3": "3.1095.0",
51
- "@git.zone/tsdoc": "^2.1.1",
52
- "@git.zone/tsdocker": "3.5.9",
53
- "@git.zone/tspublish": "^1.14.0",
51
+ "@git.zone/tsdoc": "^2.2.1",
52
+ "@git.zone/tsdocker": "3.8.1",
53
+ "@git.zone/tspublish": "^1.14.1",
54
54
  "@push.rocks/commitinfo": "^1.1.1",
55
55
  "@push.rocks/early": "^4.0.4",
56
56
  "@push.rocks/projectinfo": "^5.1.0",
57
57
  "@push.rocks/smartbucket": "4.13.0",
58
- "@push.rocks/smartcli": "^4.0.20",
59
- "@push.rocks/smartconfig": "^6.0.1",
58
+ "@push.rocks/smartcli": "^4.3.1",
59
+ "@push.rocks/smartconfig": "^6.2.4",
60
60
  "@push.rocks/smartdelay": "^3.0.5",
61
61
  "@push.rocks/smartdiff": "^1.1.0",
62
62
  "@push.rocks/smartfile": "^13.1.2",
@@ -64,7 +64,7 @@
64
64
  "@push.rocks/smartinteract": "^2.0.16",
65
65
  "@push.rocks/smartjson": "^6.0.0",
66
66
  "@push.rocks/smartlegal": "^1.0.27",
67
- "@push.rocks/smartlog": "^3.2.1",
67
+ "@push.rocks/smartlog": "^3.2.1 || ^4.0.0",
68
68
  "@push.rocks/smartlog-destination-local": "^9.0.2",
69
69
  "@push.rocks/smartmustache": "^3.0.2",
70
70
  "@push.rocks/smartnetwork": "^4.4.0",
package/readme.md CHANGED
@@ -996,6 +996,8 @@ gitzone format fix
996
996
 
997
997
  Formatters include cleanup, smartconfig normalization, dependency license checks, package metadata normalization, template updates, `.gitignore`, TypeScript config, Prettier, README existence checks, and configured copy operations.
998
998
 
999
+ The template formatter owns `.vscode/settings.json` and `.vscode/launch.json` in every project, and the Gitea workflows, Dockerfile, CLI entry points and HTML entry files of the project types that declare them. Workflow and entry files are written from the template as a whole. The two `.vscode` files are merged at the top level instead: every key the template declares is refreshed, and every other top-level key — an editor setting only your project has, such as `deno.enable` — is kept. Two limits follow from that. A key the template itself declares is taken as a whole, so an array such as `json.schemas` or `configurations` is replaced rather than unioned, and a merged file is re-serialized with two-space indentation, so a project that keeps its own key loses hand-made formatting in those two files. A `.vscode` file that is not valid JSON cannot be merged and is replaced by the template as a whole. That never happens silently: the plan line reads `Replace .vscode/settings.json: the current file is not valid JSON (…)` instead of the usual `Apply template …`, and the run prints a warning that keys only your project declares are lost. Both appear in `gitzone format`, `gitzone format check` and `gitzone format plan --json`, so you see them before confirming a write.
1000
+
999
1001
  `gitzone format fix` intentionally lives outside the default format path. Normal format runs stay deterministic; the fix command uses opencode only after deterministic formatters have done what they can.
1000
1002
 
1001
1003
  ## Development Services
@@ -3,6 +3,6 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@git.zone/cli',
6
- version: '6.17.0',
6
+ version: '6.17.1',
7
7
  description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
8
8
  }
@@ -1,14 +1,47 @@
1
1
  import { BaseFormatter } from '../classes.baseformatter.js';
2
- import type { IPlannedChange } from '../interfaces.format.js';
2
+ import type { IFormatWarning, IPlannedChange } from '../interfaces.format.js';
3
3
  import * as plugins from '../mod.plugins.js';
4
4
  import * as paths from '../../paths.js';
5
5
  import { logger, logVerbose } from '../../gitzone.logging.js';
6
6
 
7
+ /**
8
+ * `replace` writes the rendered template over the destination. `jsonTopLevel`
9
+ * keeps the top-level keys a project added itself, because an editor
10
+ * configuration is shared between the template and its user.
11
+ */
12
+ type TTemplateMergeStrategy = 'replace' | 'jsonTopLevel';
13
+
14
+ interface ITemplateFile {
15
+ templatePath: string;
16
+ destPath: string;
17
+ merge: TTemplateMergeStrategy;
18
+ }
19
+
20
+ /**
21
+ * The content a file should end up with, plus the reason a requested merge
22
+ * could not run, which makes the resulting whole-file replacement explainable.
23
+ */
24
+ interface ITemplateMergeOutcome {
25
+ content: string;
26
+ replacedReason?: string;
27
+ }
28
+
29
+ interface IJsonObjectParseOutcome {
30
+ object?: Record<string, unknown>;
31
+ reason?: string;
32
+ }
33
+
7
34
  export class TemplatesFormatter extends BaseFormatter {
35
+ private replacementWarnings: IFormatWarning[] = [];
36
+
8
37
  get name(): string {
9
38
  return 'templates';
10
39
  }
11
40
 
41
+ async validate(): Promise<IFormatWarning[]> {
42
+ return this.replacementWarnings;
43
+ }
44
+
12
45
  /**
13
46
  * Render a template directory through smartscaf and return a map of path → content.
14
47
  */
@@ -39,11 +72,20 @@ export class TemplatesFormatter extends BaseFormatter {
39
72
  const changes: IPlannedChange[] = [];
40
73
  const project = this.project;
41
74
  const projectType = project.gitzoneConfig?.data?.projectType;
75
+ this.replacementWarnings = [];
42
76
 
43
77
  // VSCode template - for all projects
44
78
  const vscodeChanges = await this.analyzeTemplate('vscode', [
45
- { templatePath: '.vscode/settings.json', destPath: '.vscode/settings.json' },
46
- { templatePath: '.vscode/launch.json', destPath: '.vscode/launch.json' },
79
+ {
80
+ templatePath: '.vscode/settings.json',
81
+ destPath: '.vscode/settings.json',
82
+ merge: 'jsonTopLevel',
83
+ },
84
+ {
85
+ templatePath: '.vscode/launch.json',
86
+ destPath: '.vscode/launch.json',
87
+ merge: 'jsonTopLevel',
88
+ },
47
89
  ]);
48
90
  changes.push(...vscodeChanges);
49
91
 
@@ -55,8 +97,8 @@ export class TemplatesFormatter extends BaseFormatter {
55
97
  || project.gitzoneConfig?.data?.npmciOptions?.npmAccessLevel;
56
98
  const ciTemplate = accessLevel === 'public' ? 'ci_default' : 'ci_default_private';
57
99
  const ciChanges = await this.analyzeTemplate(ciTemplate, [
58
- { templatePath: '.gitea/workflows/default_nottags.yaml', destPath: '.gitea/workflows/default_nottags.yaml' },
59
- { templatePath: '.gitea/workflows/default_tags.yaml', destPath: '.gitea/workflows/default_tags.yaml' },
100
+ { templatePath: '.gitea/workflows/default_nottags.yaml', destPath: '.gitea/workflows/default_nottags.yaml', merge: 'replace' },
101
+ { templatePath: '.gitea/workflows/default_tags.yaml', destPath: '.gitea/workflows/default_tags.yaml', merge: 'replace' },
60
102
  ]);
61
103
  changes.push(...ciChanges);
62
104
  break;
@@ -64,20 +106,20 @@ export class TemplatesFormatter extends BaseFormatter {
64
106
  case 'service':
65
107
  case 'website':
66
108
  const dockerCiChanges = await this.analyzeTemplate('ci_docker', [
67
- { templatePath: '.gitea/workflows/docker_nottags.yaml', destPath: '.gitea/workflows/docker_nottags.yaml' },
68
- { templatePath: '.gitea/workflows/docker_tags.yaml', destPath: '.gitea/workflows/docker_tags.yaml' },
109
+ { templatePath: '.gitea/workflows/docker_nottags.yaml', destPath: '.gitea/workflows/docker_nottags.yaml', merge: 'replace' },
110
+ { templatePath: '.gitea/workflows/docker_tags.yaml', destPath: '.gitea/workflows/docker_tags.yaml', merge: 'replace' },
69
111
  ]);
70
112
  changes.push(...dockerCiChanges);
71
113
 
72
114
  const dockerfileChanges = await this.analyzeTemplate('dockerfile_service', [
73
- { templatePath: 'Dockerfile', destPath: 'Dockerfile' },
74
- { templatePath: 'dockerignore', destPath: '.dockerignore' },
115
+ { templatePath: 'Dockerfile', destPath: 'Dockerfile', merge: 'replace' },
116
+ { templatePath: 'dockerignore', destPath: '.dockerignore', merge: 'replace' },
75
117
  ]);
76
118
  changes.push(...dockerfileChanges);
77
119
 
78
120
  const cliChanges = await this.analyzeTemplate('cli', [
79
- { templatePath: 'cli.js', destPath: 'cli.js' },
80
- { templatePath: 'cli.ts.js', destPath: 'cli.ts.js' },
121
+ { templatePath: 'cli.js', destPath: 'cli.js', merge: 'replace' },
122
+ { templatePath: 'cli.ts.js', destPath: 'cli.ts.js', merge: 'replace' },
81
123
  ]);
82
124
  changes.push(...cliChanges);
83
125
  break;
@@ -86,13 +128,13 @@ export class TemplatesFormatter extends BaseFormatter {
86
128
  // Update templates based on projectType
87
129
  if (projectType === 'website') {
88
130
  const websiteChanges = await this.analyzeTemplate('website_update', [
89
- { templatePath: 'html/index.html', destPath: 'html/index.html' },
131
+ { templatePath: 'html/index.html', destPath: 'html/index.html', merge: 'replace' },
90
132
  ]);
91
133
  changes.push(...websiteChanges);
92
134
  } else if (projectType === 'wcc') {
93
135
  const wccChanges = await this.analyzeTemplate('wcc_update', [
94
- { templatePath: 'html/index.html', destPath: 'html/index.html' },
95
- { templatePath: 'html/index.ts', destPath: 'html/index.ts' },
136
+ { templatePath: 'html/index.html', destPath: 'html/index.html', merge: 'replace' },
137
+ { templatePath: 'html/index.ts', destPath: 'html/index.ts', merge: 'replace' },
96
138
  ]);
97
139
  changes.push(...wccChanges);
98
140
  }
@@ -100,9 +142,78 @@ export class TemplatesFormatter extends BaseFormatter {
100
142
  return changes;
101
143
  }
102
144
 
145
+ /**
146
+ * Parse a JSON object a merge needs. A file that is not a JSON object cannot
147
+ * be merged into, and guessing its shape would lose data: the caller is told
148
+ * why and falls back to replacing it.
149
+ */
150
+ private parseJsonObjectForMerge(
151
+ contentArg: string,
152
+ sourceDescriptionArg: string,
153
+ ): IJsonObjectParseOutcome {
154
+ let parsed: unknown;
155
+ try {
156
+ parsed = JSON.parse(contentArg);
157
+ } catch (error) {
158
+ const errorMessage = error instanceof Error ? error.message : String(error);
159
+ return {
160
+ reason: `${sourceDescriptionArg} is not valid JSON (${errorMessage})`,
161
+ };
162
+ }
163
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
164
+ return { reason: `${sourceDescriptionArg} is not a JSON object` };
165
+ }
166
+ return { object: parsed as Record<string, unknown> };
167
+ }
168
+
169
+ /**
170
+ * Merge the rendered template into the destination's own top-level keys. The
171
+ * template owns every key it declares; a key only the project declares — an
172
+ * editor setting the template never knew about — survives the update.
173
+ * A template-owned key is taken as a whole, so an array the template declares
174
+ * replaces the project's array of the same name.
175
+ */
176
+ private mergeJsonTopLevel(
177
+ currentContentArg: string,
178
+ renderedContentArg: string,
179
+ ): ITemplateMergeOutcome {
180
+ const rendered = this.parseJsonObjectForMerge(
181
+ renderedContentArg,
182
+ 'the rendered template',
183
+ );
184
+ const current = this.parseJsonObjectForMerge(
185
+ currentContentArg,
186
+ 'the current file',
187
+ );
188
+ const renderedObject = rendered.object;
189
+ const currentObject = current.object;
190
+ if (!renderedObject || !currentObject) {
191
+ return {
192
+ content: renderedContentArg,
193
+ replacedReason: rendered.reason ?? current.reason,
194
+ };
195
+ }
196
+
197
+ // Nothing of the project's own is at stake, so the template's own text —
198
+ // its indentation and inline arrays included — stays the settled state.
199
+ const foreignKeys = Object.keys(currentObject).filter(
200
+ (keyArg) => !(keyArg in renderedObject),
201
+ );
202
+ if (foreignKeys.length === 0) {
203
+ return { content: renderedContentArg };
204
+ }
205
+
206
+ const merged: Record<string, unknown> = {
207
+ ...currentObject,
208
+ ...renderedObject,
209
+ };
210
+ const trailingNewline = renderedContentArg.endsWith('\n') ? '\n' : '';
211
+ return { content: `${JSON.stringify(merged, null, 2)}${trailingNewline}` };
212
+ }
213
+
103
214
  private async analyzeTemplate(
104
215
  templateName: string,
105
- files: Array<{ templatePath: string; destPath: string }>,
216
+ files: ITemplateFile[],
106
217
  ): Promise<IPlannedChange[]> {
107
218
  const changes: IPlannedChange[] = [];
108
219
  const templateDir = plugins.path.join(paths.templatesDir, templateName);
@@ -141,13 +252,32 @@ export class TemplatesFormatter extends BaseFormatter {
141
252
  .read()) as string;
142
253
  }
143
254
 
144
- if (processedContent !== currentContent) {
255
+ const outcome: ITemplateMergeOutcome =
256
+ destExists && file.merge === 'jsonTopLevel'
257
+ ? this.mergeJsonTopLevel(currentContent, processedContent)
258
+ : { content: processedContent };
259
+
260
+ if (outcome.content !== currentContent) {
261
+ // A replacement the project did not ask for must state its reason
262
+ // where the decision is made: in the plan the user confirms.
263
+ if (outcome.replacedReason) {
264
+ const replacementMessage = `${file.destPath} is replaced by the ${templateName} template instead of merged, because ${outcome.replacedReason}. Top-level keys only this project declares are lost.`;
265
+ this.replacementWarnings.push({
266
+ level: 'warning',
267
+ message: replacementMessage,
268
+ module: this.name,
269
+ });
270
+ logVerbose(replacementMessage);
271
+ }
272
+
145
273
  changes.push({
146
274
  type: destExists ? 'modify' : 'create',
147
275
  path: file.destPath,
148
276
  module: this.name,
149
- description: `Apply template ${templateName}/${file.templatePath}`,
150
- content: processedContent,
277
+ description: outcome.replacedReason
278
+ ? `Replace ${file.destPath}: ${outcome.replacedReason}`
279
+ : `Apply template ${templateName}/${file.templatePath}`,
280
+ content: outcome.content,
151
281
  });
152
282
  }
153
283
  }