obsidian-plugin-config 1.7.1 → 1.7.3

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.
@@ -1,897 +1,898 @@
1
- #!/usr/bin/env tsx
2
-
3
- import fs from 'fs';
4
- import path from 'path';
5
- import { execSync } from 'child_process';
6
- import { fileURLToPath } from 'url';
7
- import { isValidPath, gitExec } from './utils.js';
8
-
9
- export interface InjectionPlan {
10
- targetPath: string;
11
- isObsidianPlugin: boolean;
12
- hasPackageJson: boolean;
13
- hasManifest: boolean;
14
- hasScriptsFolder: boolean;
15
- currentDependencies: string[];
16
- }
17
-
18
- /**
19
- * Analyze the target plugin directory
20
- */
21
- export async function analyzePlugin(pluginPath: string): Promise<InjectionPlan> {
22
- const packageJsonPath = path.join(pluginPath, 'package.json');
23
- const manifestPath = path.join(pluginPath, 'manifest.json');
24
- const scriptsPath = path.join(pluginPath, 'scripts');
25
-
26
- const plan: InjectionPlan = {
27
- targetPath: pluginPath,
28
- isObsidianPlugin: false,
29
- hasPackageJson: await isValidPath(packageJsonPath),
30
- hasManifest: await isValidPath(manifestPath),
31
- hasScriptsFolder: await isValidPath(scriptsPath),
32
- currentDependencies: []
33
- };
34
-
35
- if (plan.hasManifest) {
36
- try {
37
- const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
38
- plan.isObsidianPlugin = !!(manifest.id && manifest.name && manifest.version);
39
- } catch {
40
- console.warn('Warning: Could not parse manifest.json');
41
- }
42
- }
43
-
44
- if (plan.hasPackageJson) {
45
- try {
46
- const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
47
- plan.currentDependencies = [
48
- ...Object.keys(packageJson.dependencies || {}),
49
- ...Object.keys(packageJson.devDependencies || {})
50
- ];
51
- } catch {
52
- console.warn('Warning: Could not parse package.json');
53
- }
54
- }
55
-
56
- return plan;
57
- }
58
-
59
- /**
60
- * Find plugin-config root directory (handles NPM global installs)
61
- */
62
- export function findPluginConfigRoot(): string {
63
- const scriptDir = path.dirname(fileURLToPath(import.meta.url));
64
- const npmPackageRoot = path.resolve(scriptDir, '..');
65
- const npmPackageJson = path.join(npmPackageRoot, 'package.json');
66
-
67
- if (fs.existsSync(npmPackageJson)) {
68
- try {
69
- const packageContent = JSON.parse(fs.readFileSync(npmPackageJson, 'utf8'));
70
- if (packageContent.name === 'obsidian-plugin-config') {
71
- return npmPackageRoot;
72
- }
73
- } catch {
74
- // Ignore parsing errors
75
- }
76
- }
77
-
78
- return process.cwd();
79
- }
80
-
81
- /**
82
- * Copy file content from local plugin-config directory
83
- */
84
- export function copyFromLocal(filePath: string): string {
85
- const configRoot = findPluginConfigRoot();
86
- const sourcePath = path.join(configRoot, filePath);
87
-
88
- try {
89
- return fs.readFileSync(sourcePath, 'utf8');
90
- } catch (error) {
91
- throw new Error(`Failed to copy ${filePath}: ${error}`);
92
- }
93
- }
94
-
95
- /**
96
- * Check if plugin-config repo is clean and commit if needed
97
- */
98
- export async function ensurePluginConfigClean(): Promise<void> {
99
- const configRoot = findPluginConfigRoot();
100
- const gitDir = path.join(configRoot, '.git');
101
-
102
- // Skip git check if not a git repo
103
- // (e.g. NPM global install)
104
- if (!fs.existsSync(gitDir)) {
105
- console.log(`✅ Plugin-config repo is clean` + ` (NPM install, no git check)`);
106
- return;
107
- }
108
-
109
- const originalCwd = process.cwd();
110
-
111
- try {
112
- process.chdir(configRoot);
113
- const gitStatus = execSync('git status --porcelain', { encoding: 'utf8' }).trim();
114
-
115
- if (gitStatus) {
116
- console.log(`\n⚠️ Plugin-config has uncommitted changes:`);
117
- console.log(gitStatus);
118
- console.log(`\n🔧 Auto-committing changes...`);
119
-
120
- const msg = '🔧 Update plugin-config templates';
121
- gitExec('git add -A');
122
- gitExec(`git commit -m "${msg}"`);
123
-
124
- try {
125
- const branch = execSync('git rev-parse --abbrev-ref HEAD', {
126
- encoding: 'utf8'
127
- }).trim();
128
- gitExec(`git push origin ${branch}`);
129
- console.log(`✅ Changes committed and pushed`);
130
- } catch {
131
- try {
132
- const branch = execSync('git rev-parse --abbrev-ref HEAD', {
133
- encoding: 'utf8'
134
- }).trim();
135
- gitExec(`git push --set-upstream origin ${branch}`);
136
- console.log(`✅ New branch pushed with upstream`);
137
- } catch {
138
- console.log(`⚠️ Committed locally, push failed`);
139
- }
140
- }
141
- } else {
142
- console.log(`✅ Plugin-config repo is clean`);
143
- }
144
- } finally {
145
- process.chdir(originalCwd);
146
- }
147
- }
148
-
149
- /**
150
- * Display injection plan and ask for confirmation
151
- */
152
- export async function showInjectionPlan(
153
- plan: InjectionPlan,
154
- autoConfirm: boolean = false
155
- ): Promise<boolean> {
156
- const { createReadlineInterface } = await import('./utils.js');
157
- const rl = createReadlineInterface();
158
-
159
- console.log(`\n🎯 Injection Plan for: ${plan.targetPath}`);
160
- console.log(`📁 Target: ${path.basename(plan.targetPath)}`);
161
- console.log(`📦 Package.json: ${plan.hasPackageJson ? '✅' : '❌'}`);
162
- console.log(`📋 Manifest.json: ${plan.hasManifest ? '✅' : '❌'}`);
163
- console.log(
164
- `📂 Scripts folder: ${plan.hasScriptsFolder ? '✅ (will be updated)' : '❌ (will be created)'}`
165
- );
166
- console.log(`🔌 Obsidian plugin: ${plan.isObsidianPlugin ? '✅' : '❌'}`);
167
-
168
- if (!plan.isObsidianPlugin) {
169
- console.log(`\n⚠️ Warning: This doesn't appear to be a valid Obsidian plugin`);
170
- console.log(` Missing manifest.json or invalid structure`);
171
- }
172
-
173
- console.log(`\n📋 Will inject:`);
174
- console.log(` ✅ Local scripts (esbuild.config.ts, utils.ts, env.ts, constants.ts, etc.)`);
175
- console.log(` ✅ Updated package.json scripts`);
176
- console.log(` ✅ Required dependencies`);
177
-
178
- if (autoConfirm) {
179
- console.log(`\n✅ Auto-confirming all file replacements...`);
180
- rl.close();
181
- return true;
182
- }
183
-
184
- // No global confirmation needed - file-by-file confirmation will happen in diffAndPromptFiles
185
- rl.close();
186
- return true;
187
- }
188
-
189
- /**
190
- * Clean old script files
191
- */
192
- export async function cleanOldScripts(
193
- scriptsPath: string,
194
- approvedDests: Set<string>
195
- ): Promise<void> {
196
- const scriptNames = [
197
- 'utils',
198
- 'esbuild.config',
199
- 'acp',
200
- 'update-version',
201
- 'release',
202
- 'help',
203
- 'constants',
204
- 'env',
205
- 'reload',
206
- 'typingsPlugin'
207
- ];
208
- const extensions = ['.ts', '.mts', '.js', '.mjs'];
209
-
210
- for (const scriptName of scriptNames) {
211
- for (const ext of extensions) {
212
- const scriptFile = path.join(scriptsPath, `${scriptName}${ext}`);
213
- if (await isValidPath(scriptFile)) {
214
- if (approvedDests.has(scriptFile)) {
215
- fs.unlinkSync(scriptFile);
216
- console.log(`🗑️ Removed existing ${scriptName}${ext} (will be replaced)`);
217
- }
218
- }
219
- }
220
- }
221
-
222
- const obsoleteRootFiles = ['help-plugin.ts'];
223
- for (const fileName of obsoleteRootFiles) {
224
- const filePath = path.join(path.dirname(scriptsPath), fileName);
225
- if (await isValidPath(filePath)) {
226
- fs.unlinkSync(filePath);
227
- console.log(`🗑️ Removed obsolete root file: ${fileName}`);
228
- }
229
- }
230
-
231
- const obsoleteFiles = ['start.mjs', 'start.js'];
232
- for (const fileName of obsoleteFiles) {
233
- const filePath = path.join(scriptsPath, fileName);
234
- if (await isValidPath(filePath)) {
235
- fs.unlinkSync(filePath);
236
- console.log(`🗑️ Removed obsolete file: ${fileName}`);
237
- }
238
- }
239
- }
240
-
241
- /**
242
- * Clean old ESLint config files
243
- */
244
- export async function cleanOldLintFiles(targetPath: string): Promise<void> {
245
- const oldLintFiles = ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintignore'];
246
- const conflictingLintFiles = [
247
- 'eslint.config.ts',
248
- 'eslint.config.cjs',
249
- 'eslint.config.js',
250
- 'eslint.config.mjs'
251
- ];
252
-
253
- for (const fileName of oldLintFiles) {
254
- const filePath = path.join(targetPath, fileName);
255
- if (await isValidPath(filePath)) {
256
- fs.unlinkSync(filePath);
257
- console.log(
258
- `🗑️ Removed old ESLint file: ${fileName} (replaced by 1
259
- fig.ts)`
260
- );
261
- }
262
- }
263
-
264
- for (const fileName of conflictingLintFiles) {
265
- const filePath = path.join(targetPath, fileName);
266
- if (await isValidPath(filePath)) {
267
- fs.unlinkSync(filePath);
268
- console.log(
269
- `🗑️ Removed existing ESLint file: ${fileName} (will be replaced by injection)`
270
- );
271
- }
272
- }
273
- }
274
-
275
- interface FileEntry {
276
- src: string; // path relative to configRoot
277
- dest: string; // absolute path in target plugin
278
- mergeEnv?: boolean; // special .env merge logic
279
- }
280
-
281
- /**
282
- * Build the full list of files to inject, with source and destination paths
283
- */
284
- function buildFileList(targetPath: string): FileEntry[] {
285
- const scriptsPath = path.join(targetPath, 'scripts');
286
- const entries: FileEntry[] = [];
287
-
288
- // Scripts
289
- const scriptFiles = [
290
- 'templates/scripts/utils.ts',
291
- 'templates/scripts/esbuild.config.ts',
292
- 'templates/scripts/acp.ts',
293
- 'templates/scripts/update-version.ts',
294
- 'templates/scripts/release.ts',
295
- 'templates/scripts/help.ts',
296
- 'templates/scripts/constants.ts',
297
- 'templates/scripts/env.ts',
298
- 'templates/scripts/reload.ts',
299
- 'templates/scripts/typingsPlugin.ts'
300
- ];
301
- for (const src of scriptFiles) {
302
- entries.push({
303
- src,
304
- dest: path.join(scriptsPath, path.basename(src))
305
- });
306
- }
307
-
308
- // Root config files
309
- const configFileMap: Array<[string, string, boolean?]> = [
310
- ['templates/tsconfig.json', 'tsconfig.json'],
311
- ['templates/gitignore.template', '.gitignore'],
312
- ['templates/eslint.config.mts', 'eslint.config.mts'],
313
- ['templates/.editorconfig', '.editorconfig'],
314
- ['templates/.prettierrc', '.prettierrc'],
315
- ['templates/.prettierignore', '.prettierignore'],
316
- ['templates/npmrc.template', '.npmrc'],
317
- ['templates/env.template', '.env', true]
318
- ];
319
- for (const [src, destName, mergeEnv] of configFileMap) {
320
- entries.push({
321
- src,
322
- dest: path.join(targetPath, destName),
323
- mergeEnv: !!mergeEnv
324
- });
325
- }
326
-
327
- // VSCode config files
328
- const configVscodeMap: Array<[string, string]> = [
329
- ['templates/.vscode/settings.json', '.vscode/settings.json'],
330
- ['templates/.vscode/tasks.json', '.vscode/tasks.json'],
331
- ['templates/.vscode/extensions.json', '.vscode/extensions.json']
332
- ];
333
- for (const [src, destName] of configVscodeMap) {
334
- entries.push({
335
- src,
336
- dest: path.join(targetPath, destName)
337
- });
338
- }
339
-
340
- // GitHub workflow files
341
- const workflowFiles = [
342
- 'templates/.github/workflows/release.yml',
343
- 'templates/.github/workflows/release-body.md'
344
- ];
345
- for (const src of workflowFiles) {
346
- entries.push({
347
- src,
348
- dest: path.join(targetPath, src.replace('templates/', ''))
349
- });
350
- }
351
-
352
- return entries;
353
- }
354
-
355
- /**
356
- * Compare source templates with existing target files.
357
- * Prompt user only when content differs and file already exists.
358
- * Returns the Set of dest paths approved for injection.
359
- */
360
- export async function diffAndPromptFiles(
361
- targetPath: string,
362
- autoConfirm: boolean
363
- ): Promise<Set<string>> {
364
- const { askConfirmation, createReadlineInterface } = await import('./utils.js');
365
- const rl = autoConfirm ? null : createReadlineInterface();
366
- const configRoot = findPluginConfigRoot();
367
- const entries = buildFileList(targetPath);
368
- const approved = new Set<string>();
369
-
370
- console.log(`\n🔍 Comparing files with existing content...`);
371
-
372
- let hasChanges = false;
373
-
374
- for (const entry of entries) {
375
- // Skip .env merge (always approved, merge logic handled separately)
376
- if (entry.mergeEnv) {
377
- approved.add(entry.dest);
378
- continue;
379
- }
380
-
381
- const srcPath = path.join(configRoot, entry.src);
382
- let srcContent: string;
383
- try {
384
- srcContent = fs.readFileSync(srcPath, 'utf8');
385
- } catch {
386
- // Source doesn't exist, skip
387
- continue;
388
- }
389
-
390
- // Target doesn't exist yet → inject without prompting
391
- if (!fs.existsSync(entry.dest)) {
392
- approved.add(entry.dest);
393
- continue;
394
- }
395
-
396
- // Special case: eslint.config.mts - auto-approve if old .eslintrc exists
397
- if (entry.dest.endsWith('eslint.config.mts')) {
398
- const oldEslintFiles = [
399
- '.eslintrc',
400
- '.eslintrc.js',
401
- '.eslintrc.json',
402
- '.eslintrc.cjs'
403
- ];
404
- const hasOldEslint = oldEslintFiles.some((file) =>
405
- fs.existsSync(path.join(targetPath, file))
406
- );
407
- if (hasOldEslint) {
408
- console.log(
409
- ` 🔄 ${path.relative(targetPath, entry.dest)} (migrating from old .eslintrc format)`
410
- );
411
- approved.add(entry.dest);
412
- continue;
413
- }
414
- }
415
-
416
- const destContent = fs.readFileSync(entry.dest, 'utf8');
417
-
418
- // Identical skip silently
419
- if (srcContent === destContent) {
420
- console.log(` ✅ ${path.relative(targetPath, entry.dest)} (unchanged)`);
421
- continue;
422
- }
423
-
424
- // Different → ask user (or auto-approve if autoConfirm)
425
- hasChanges = true;
426
- const relDest = path.relative(targetPath, entry.dest);
427
-
428
- if (autoConfirm) {
429
- console.log(` ✅ ${relDest} (will be updated)`);
430
- approved.add(entry.dest);
431
- } else {
432
- const update = await askConfirmation(
433
- ` Update ${relDest}? (content differs)`,
434
- rl!
435
- );
436
- if (update) {
437
- approved.add(entry.dest);
438
- } else {
439
- console.log(` ⏭️ Kept existing ${relDest}`);
440
- }
441
- }
442
- }
443
-
444
- if (!hasChanges) {
445
- console.log(` ✅ All existing files are up to date`);
446
- }
447
-
448
- if (rl) rl.close();
449
- return approved;
450
- }
451
-
452
- /**
453
- * Inject scripts and config files
454
- */
455
- export async function injectScripts(
456
- targetPath: string,
457
- approvedDests: Set<string>
458
- ): Promise<void> {
459
- const scriptsPath = path.join(targetPath, 'scripts');
460
-
461
- if (!(await isValidPath(scriptsPath))) {
462
- fs.mkdirSync(scriptsPath, { recursive: true });
463
- console.log(`📁 Created scripts directory`);
464
- }
465
-
466
- await cleanOldScripts(scriptsPath, approvedDests);
467
- await cleanOldLintFiles(targetPath);
468
-
469
- const scriptFiles = [
470
- 'templates/scripts/utils.ts',
471
- 'templates/scripts/esbuild.config.ts',
472
- 'templates/scripts/acp.ts',
473
- 'templates/scripts/update-version.ts',
474
- 'templates/scripts/release.ts',
475
- 'templates/scripts/help.ts',
476
- 'templates/scripts/constants.ts',
477
- 'templates/scripts/env.ts',
478
- 'templates/scripts/reload.ts',
479
- 'templates/scripts/typingsPlugin.ts'
480
- ];
481
-
482
- // Files that need value-preserving merge instead
483
- // of full overwrite (user fills in their paths)
484
- const mergeEnvFile = new Set(['.env']);
485
-
486
- // Files with .template suffix (NPM excludes dotfiles)
487
- // Map: { source: targetName }
488
- const configFileMap: Record<string, string> = {
489
- 'templates/tsconfig.json': 'tsconfig.json',
490
- 'templates/gitignore.template': '.gitignore',
491
- 'templates/eslint.config.mts': 'eslint.config.mts',
492
- 'templates/.editorconfig': '.editorconfig',
493
- 'templates/.prettierrc': '.prettierrc',
494
- 'templates/.prettierignore': '.prettierignore',
495
- 'templates/npmrc.template': '.npmrc',
496
- 'templates/env.template': '.env'
497
- };
498
-
499
- const configVscodeMap: Record<string, string> = {
500
- 'templates/.vscode/settings.json': '.vscode/settings.json',
501
- 'templates/.vscode/tasks.json': '.vscode/tasks.json',
502
- 'templates/.vscode/extensions.json': '.vscode/extensions.json'
503
- };
504
-
505
- const workflowFiles = [
506
- 'templates/.github/workflows/release.yml',
507
- 'templates/.github/workflows/release-body.md'
508
- ];
509
-
510
- console.log(`\n📥 Copying scripts from local files...`);
511
-
512
- for (const scriptFile of scriptFiles) {
513
- try {
514
- const fileName = path.basename(scriptFile);
515
- const targetFile = path.join(scriptsPath, fileName);
516
- if (!approvedDests.has(targetFile)) {
517
- console.log(` ⏭️ Skipped ${fileName} (kept existing)`);
518
- continue;
519
- }
520
- const content = copyFromLocal(scriptFile);
521
- fs.writeFileSync(targetFile, content, 'utf8');
522
- console.log(` ✅ ${fileName}`);
523
- } catch (error) {
524
- console.error(` ❌ Failed to inject ${scriptFile}: ${error}`);
525
- }
526
- }
527
-
528
- console.log(`\n📥 Copying config files...`);
529
-
530
- // Copy root config files
531
- for (const [src, destName] of Object.entries(configFileMap)) {
532
- // Skip if not approved by diff step
533
- const targetFile = path.join(targetPath, destName);
534
- if (!approvedDests.has(targetFile)) {
535
- continue; // already logged during diff step
536
- }
537
-
538
- try {
539
- const templateContent = copyFromLocal(src);
540
-
541
- // For .env: merge existing values into the template
542
- if (mergeEnvFile.has(destName) && fs.existsSync(targetFile)) {
543
- const existing = fs.readFileSync(targetFile, 'utf8');
544
- // Parse existing key=value pairs
545
- const existingVals: Record<string, string> = {};
546
- for (const line of existing.split(/\r?\n/)) {
547
- const m = line.match(/^([^#=]+)=(.*)$/);
548
- if (m) existingVals[m[1].trim()] = m[2].trim();
549
- }
550
- // Re-write template, substituting existing values
551
- const merged = templateContent
552
- .split(/\r?\n/)
553
- .map((line) => {
554
- const m = line.match(/^([^#=]+)=(.*)$/);
555
- if (m) {
556
- const key = m[1].trim();
557
- const val = existingVals[key] ?? m[2].trim();
558
- return `${key}=${val}`;
559
- }
560
- return line;
561
- })
562
- .join('\n');
563
- fs.writeFileSync(targetFile, merged, 'utf8');
564
- console.log(` ✅ ${destName} (values preserved)`);
565
- continue;
566
- }
567
-
568
- fs.writeFileSync(targetFile, templateContent, 'utf8');
569
- console.log(` ✅ ${destName}`);
570
- } catch (error) {
571
- console.error(` ❌ Failed to inject ${destName}: ${error}`);
572
- }
573
- }
574
-
575
- // Copy .vscode config files
576
- for (const [src, destName] of Object.entries(configVscodeMap)) {
577
- try {
578
- const targetFile = path.join(targetPath, destName);
579
- if (!approvedDests.has(targetFile)) continue;
580
- const content = copyFromLocal(src);
581
- const targetDir = path.dirname(targetFile);
582
- if (!(await isValidPath(targetDir))) {
583
- fs.mkdirSync(targetDir, { recursive: true });
584
- }
585
- fs.writeFileSync(targetFile, content, 'utf8');
586
- console.log(` ✅ ${destName}`);
587
- } catch (error) {
588
- console.error(` ❌ Failed to inject ${destName}: ${error}`);
589
- }
590
- }
591
-
592
- console.log(`\n📥 Copying GitHub workflows from local files...`);
593
-
594
- for (const workflowFile of workflowFiles) {
595
- try {
596
- const content = copyFromLocal(workflowFile);
597
- const relativePath = workflowFile.replace('templates/', '');
598
- const targetFile = path.join(targetPath, relativePath);
599
- if (!approvedDests.has(targetFile)) continue;
600
- const targetDir = path.dirname(targetFile);
601
-
602
- if (!(await isValidPath(targetDir))) {
603
- fs.mkdirSync(targetDir, { recursive: true });
604
- }
605
-
606
- fs.writeFileSync(targetFile, content, 'utf8');
607
- console.log(` ✅ ${relativePath}`);
608
- } catch (error) {
609
- console.error(` ❌ Failed to inject ${workflowFile}: ${error}`);
610
- }
611
- }
612
- }
613
-
614
- /**
615
- * Update package.json with autonomous configuration
616
- */
617
- export async function updatePackageJson(
618
- targetPath: string
619
- ): Promise<void> {
620
- const packageJsonPath = path.join(targetPath, 'package.json');
621
-
622
- if (!(await isValidPath(packageJsonPath))) {
623
- console.log(`❌ No package.json found, skipping package.json update`);
624
- return;
625
- }
626
-
627
- try {
628
- const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
629
-
630
- const configRoot = findPluginConfigRoot();
631
- const templatePkg = JSON.parse(
632
- fs.readFileSync(path.join(configRoot, 'templates/package.json'), 'utf8')
633
- );
634
-
635
- const obsoleteScripts = ['version'];
636
- for (const script of obsoleteScripts) {
637
- if (packageJson.scripts?.[script]) {
638
- console.log(` 🧹 Removing obsolete script: "${script}"`);
639
- delete packageJson.scripts[script];
640
- }
641
- }
642
-
643
- packageJson.scripts = {
644
- ...packageJson.scripts,
645
- ...templatePkg.scripts
646
- };
647
-
648
- if (!packageJson.devDependencies) packageJson.devDependencies = {};
649
-
650
- const requiredDeps: Record<string, string> = templatePkg.devDependencies;
651
-
652
- let addedDeps = 0;
653
- let updatedDeps = 0;
654
- for (const [dep, version] of Object.entries(requiredDeps)) {
655
- if (!packageJson.devDependencies[dep]) {
656
- packageJson.devDependencies[dep] = version as string;
657
- addedDeps++;
658
- } else if (packageJson.devDependencies[dep] !== version) {
659
- packageJson.devDependencies[dep] = version as string;
660
- updatedDeps++;
661
- }
662
- }
663
-
664
- if (!packageJson.engines) packageJson.engines = {};
665
- packageJson.engines.npm = templatePkg.engines.npm;
666
- packageJson.engines.yarn = templatePkg.engines.yarn;
667
- packageJson.type = templatePkg.type;
668
-
669
- fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf8');
670
- console.log(
671
- ` ✅ Updated package.json (${addedDeps} new, ${updatedDeps} updated dependencies)`
672
- );
673
- } catch (error) {
674
- console.error(` ❌ Failed to update package.json: ${error}`);
675
- }
676
- }
677
-
678
- /**
679
- * Create required directories
680
- */
681
- export async function createRequiredDirectories(targetPath: string): Promise<void> {
682
- const directories = [path.join(targetPath, '.github', 'workflows')];
683
-
684
- for (const dir of directories) {
685
- if (!(await isValidPath(dir))) {
686
- fs.mkdirSync(dir, { recursive: true });
687
- console.log(` 📁 Created ${path.relative(targetPath, dir)}`);
688
- }
689
- }
690
- }
691
-
692
- /**
693
- * Create injection info file
694
- */
695
- export async function createInjectionInfo(targetPath: string): Promise<void> {
696
- const configRoot = findPluginConfigRoot();
697
- const configPackageJsonPath = path.join(configRoot, 'package.json');
698
-
699
- let injectorVersion = 'unknown';
700
- try {
701
- const configPackageJson = JSON.parse(fs.readFileSync(configPackageJsonPath, 'utf8'));
702
- injectorVersion = configPackageJson.version || 'unknown';
703
- } catch {
704
- console.warn('Warning: Could not read injector version');
705
- }
706
-
707
- const injectionInfo = {
708
- injectorVersion,
709
- injectionDate: new Date().toISOString(),
710
- injectorName: 'obsidian-plugin-config'
711
- };
712
-
713
- const infoPath = path.join(targetPath, '.injection-info.json');
714
- fs.writeFileSync(infoPath, JSON.stringify(injectionInfo, null, 2));
715
- console.log(` ✅ Created injection info file (.injection-info.json)`);
716
- }
717
-
718
- /**
719
- * Read injection info from target plugin
720
- */
721
- export function readInjectionInfo(targetPath: string): Record<string, string> | null {
722
- const infoPath = path.join(targetPath, '.injection-info.json');
723
-
724
- if (!fs.existsSync(infoPath)) return null;
725
-
726
- try {
727
- return JSON.parse(fs.readFileSync(infoPath, 'utf8'));
728
- } catch {
729
- console.warn('Warning: Could not parse .injection-info.json');
730
- return null;
731
- }
732
- }
733
-
734
- /**
735
- * Clean NPM/Yarn lock files and node_modules to ensure fresh install
736
- */
737
- export async function cleanNpmArtifactsIfNeeded(targetPath: string): Promise<void> {
738
- const packageLockPath = path.join(targetPath, 'package-lock.json');
739
- const yarnLockPath = path.join(targetPath, 'yarn.lock');
740
- const nodeModulesPath = path.join(targetPath, 'node_modules');
741
-
742
- const hasPackageLock = fs.existsSync(packageLockPath);
743
- const hasYarnLock = fs.existsSync(yarnLockPath);
744
-
745
- if (hasPackageLock) {
746
- console.log(`\n🧹 Cleaning NPM artifacts (migrating to Yarn)...`);
747
-
748
- try {
749
- // Remove node_modules FIRST (before lock files)
750
- if (fs.existsSync(nodeModulesPath)) {
751
- console.log(` ⏳ Removing node_modules (this may take a moment)...`);
752
-
753
- execSync(`rmdir /s /q "${nodeModulesPath}"`, {
754
- stdio: 'pipe',
755
- windowsHide: true
756
- });
757
-
758
- if (fs.existsSync(nodeModulesPath)) {
759
- // rmdir failed silently (locked .exe files) - rename instead
760
- const timestamp = Date.now();
761
- const oldPath = `${nodeModulesPath}.old.${timestamp}`;
762
- try {
763
- fs.renameSync(nodeModulesPath, oldPath);
764
- console.log(` 🔄 Renamed locked node_modules to ${path.basename(oldPath)}`);
765
- console.log(` 💡 Delete it manually later: ${oldPath}`);
766
- } catch {
767
- console.log(
768
- ` ⚠️ Could not remove/rename node_modules (locked by processes)`
769
- );
770
- console.log(` 💡 Close Obsidian/VSCode and run: obsidian-inject again`);
771
- throw new Error('node_modules locked - close processes and retry');
772
- }
773
- } else {
774
- console.log(` 🗑️ Removed node_modules (will be reinstalled with Yarn)`);
775
- }
776
- }
777
-
778
- // Then remove lock files
779
- if (hasPackageLock) {
780
- fs.unlinkSync(packageLockPath);
781
- console.log(` 🗑️ Removed package-lock.json`);
782
- }
783
-
784
- if (hasYarnLock) {
785
- fs.unlinkSync(yarnLockPath);
786
- console.log(` 🗑️ Removed yarn.lock`);
787
- }
788
-
789
- console.log(` ✅ Lock files and artifacts cleaned for fresh install`);
790
- } catch (error) {
791
- if (error instanceof Error && error.message.includes('locked')) {
792
- throw error;
793
- }
794
- console.error(` ❌ Failed to clean artifacts: ${error}`);
795
- console.log(
796
- ` 💡 You may need to manually remove package-lock.json, yarn.lock and node_modules`
797
- );
798
- }
799
- }
800
- }
801
-
802
- /**
803
- * Check if tsx is installed locally and install it if needed
804
- */
805
- export async function ensureTsxInstalled(targetPath: string): Promise<void> {
806
- console.log(`\n🔍 Checking tsx installation...`);
807
-
808
- const packageJsonPath = path.join(targetPath, 'package.json');
809
-
810
- try {
811
- const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
812
- const devDependencies = packageJson.devDependencies || {};
813
- const dependencies = packageJson.dependencies || {};
814
-
815
- if (devDependencies.tsx || dependencies.tsx) {
816
- console.log(` ✅ tsx is already installed`);
817
- return;
818
- }
819
-
820
- console.log(` ⚠️ tsx not found, installing as dev dependency...`);
821
- execSync('yarn add -D tsx', { cwd: targetPath, stdio: 'inherit' });
822
- console.log(` ✅ tsx installed successfully`);
823
- } catch (error) {
824
- console.error(` ❌ Failed to install tsx: ${error}`);
825
- console.log(` 💡 You may need to install tsx manually: yarn add -D tsx`);
826
- throw new Error('tsx installation failed');
827
- }
828
- }
829
-
830
- /**
831
- * Run yarn install in target directory
832
- */
833
- export async function runYarnInstall(targetPath: string): Promise<void> {
834
- console.log(`\n📦 Installing dependencies...`);
835
-
836
- try {
837
- execSync('yarn install', { cwd: targetPath, stdio: 'inherit' });
838
- console.log(` ✅ Dependencies installed successfully`);
839
- } catch (error) {
840
- console.error(` ❌ Failed to install dependencies: ${error}`);
841
- console.log(
842
- ` 💡 You may need to run 'yarn install' manually in the target directory`
843
- );
844
- }
845
- }
846
-
847
- /**
848
- * Main injection orchestration function
849
- */
850
- export async function performInjection(
851
- targetPath: string,
852
- autoConfirm: boolean = false
853
- ): Promise<void> {
854
- console.log(`\n🚀 Starting injection process...`);
855
-
856
- try {
857
- const approvedDests = await diffAndPromptFiles(targetPath, autoConfirm);
858
- await cleanNpmArtifactsIfNeeded(targetPath);
859
- await ensureTsxInstalled(targetPath);
860
- await injectScripts(targetPath, approvedDests);
861
-
862
- console.log(`\n📦 Updating package.json...`);
863
- await updatePackageJson(targetPath);
864
-
865
- console.log(`\n📁 Creating required directories...`);
866
- await createRequiredDirectories(targetPath);
867
-
868
- await runYarnInstall(targetPath);
869
-
870
- console.log(`\n📝 Creating injection info...`);
871
- await createInjectionInfo(targetPath);
872
-
873
- console.log(`\n✅ Injection completed successfully!`);
874
- console.log(`\n📋 Next steps:`);
875
- console.log(` 1. cd ${targetPath}`);
876
- console.log(` 2. yarn build # Test the build`);
877
- console.log(` 3. yarn start # Test development mode`);
878
- console.log(` 4. yarn acp # Commit changes (or yarn bacp for build+commit)`);
879
-
880
- // Check for .old directories and remind user to delete them
881
- const oldDirs = fs
882
- .readdirSync(targetPath)
883
- .filter((name) => name.startsWith('node_modules.old.'))
884
- .map((name) => path.basename(name));
885
-
886
- if (oldDirs.length > 0) {
887
- console.log(`\n🧹 Cleanup reminder:`);
888
- for (const oldDir of oldDirs) {
889
- console.log(` 🗑️ Delete manually: ${oldDir}`);
890
- }
891
- console.log(` 💡 Close all processes first, then delete these folders`);
892
- }
893
- } catch (error) {
894
- console.error(`\n❌ Injection failed: ${error}`);
895
- throw error;
896
- }
897
- }
1
+ #!/usr/bin/env tsx
2
+
3
+ import fs from 'fs';
4
+ import path from 'path';
5
+ import { execSync } from 'child_process';
6
+ import { fileURLToPath } from 'url';
7
+ import { isValidPath, gitExec } from './utils.ts';
8
+
9
+ export interface InjectionPlan {
10
+ targetPath: string;
11
+ isObsidianPlugin: boolean;
12
+ hasPackageJson: boolean;
13
+ hasManifest: boolean;
14
+ hasScriptsFolder: boolean;
15
+ currentDependencies: string[];
16
+ }
17
+
18
+ /**
19
+ * Analyze the target plugin directory
20
+ */
21
+ export async function analyzePlugin(pluginPath: string): Promise<InjectionPlan> {
22
+ const packageJsonPath = path.join(pluginPath, 'package.json');
23
+ const manifestPath = path.join(pluginPath, 'manifest.json');
24
+ const scriptsPath = path.join(pluginPath, 'scripts');
25
+
26
+ const plan: InjectionPlan = {
27
+ targetPath: pluginPath,
28
+ isObsidianPlugin: false,
29
+ hasPackageJson: await isValidPath(packageJsonPath),
30
+ hasManifest: await isValidPath(manifestPath),
31
+ hasScriptsFolder: await isValidPath(scriptsPath),
32
+ currentDependencies: []
33
+ };
34
+
35
+ if (plan.hasManifest) {
36
+ try {
37
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
38
+ plan.isObsidianPlugin = !!(manifest.id && manifest.name && manifest.version);
39
+ } catch {
40
+ console.warn('Warning: Could not parse manifest.json');
41
+ }
42
+ }
43
+
44
+ if (plan.hasPackageJson) {
45
+ try {
46
+ const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
47
+ plan.currentDependencies = [
48
+ ...Object.keys(packageJson.dependencies || {}),
49
+ ...Object.keys(packageJson.devDependencies || {})
50
+ ];
51
+ } catch {
52
+ console.warn('Warning: Could not parse package.json');
53
+ }
54
+ }
55
+
56
+ return plan;
57
+ }
58
+
59
+ /**
60
+ * Find plugin-config root directory (handles NPM global installs)
61
+ */
62
+ export function findPluginConfigRoot(): string {
63
+ const scriptDir = path.dirname(fileURLToPath(import.meta.url));
64
+ const npmPackageRoot = path.resolve(scriptDir, '..');
65
+ const npmPackageJson = path.join(npmPackageRoot, 'package.json');
66
+
67
+ if (fs.existsSync(npmPackageJson)) {
68
+ try {
69
+ const packageContent = JSON.parse(fs.readFileSync(npmPackageJson, 'utf8'));
70
+ if (packageContent.name === 'obsidian-plugin-config') {
71
+ return npmPackageRoot;
72
+ }
73
+ } catch {
74
+ // Ignore parsing errors
75
+ }
76
+ }
77
+
78
+ return process.cwd();
79
+ }
80
+
81
+ /**
82
+ * Copy file content from local plugin-config directory
83
+ */
84
+ export function copyFromLocal(filePath: string): string {
85
+ const configRoot = findPluginConfigRoot();
86
+ const sourcePath = path.join(configRoot, filePath);
87
+
88
+ try {
89
+ return fs.readFileSync(sourcePath, 'utf8');
90
+ } catch (error) {
91
+ throw new Error(`Failed to copy ${filePath}: ${error}`);
92
+ }
93
+ }
94
+
95
+ /**
96
+ * Check if plugin-config repo is clean and commit if needed
97
+ */
98
+ export async function ensurePluginConfigClean(): Promise<void> {
99
+ const configRoot = findPluginConfigRoot();
100
+ const gitDir = path.join(configRoot, '.git');
101
+
102
+ // Skip git check if not a git repo
103
+ // (e.g. NPM global install)
104
+ if (!fs.existsSync(gitDir)) {
105
+ console.log(`✅ Plugin-config repo is clean` + ` (NPM install, no git check)`);
106
+ return;
107
+ }
108
+
109
+ try {
110
+ const gitStatus = execSync('git status --porcelain', { cwd: configRoot, encoding: 'utf8' }).trim();
111
+
112
+ if (gitStatus) {
113
+ console.log(`\n⚠️ Plugin-config has uncommitted changes:`);
114
+ console.log(gitStatus);
115
+ console.log(`\n🔧 Auto-committing changes...`);
116
+
117
+ const msg = '🔧 Update plugin-config templates';
118
+ gitExec('git add -A', configRoot);
119
+ gitExec(`git commit -m "${msg}"`, configRoot);
120
+
121
+ try {
122
+ const branch = execSync('git rev-parse --abbrev-ref HEAD', {
123
+ cwd: configRoot,
124
+ encoding: 'utf8'
125
+ }).trim();
126
+ gitExec(`git push origin ${branch}`, configRoot);
127
+ console.log(`✅ Changes committed and pushed`);
128
+ } catch {
129
+ try {
130
+ const branch = execSync('git rev-parse --abbrev-ref HEAD', {
131
+ cwd: configRoot,
132
+ encoding: 'utf8'
133
+ }).trim();
134
+ gitExec(`git push --set-upstream origin ${branch}`, configRoot);
135
+ console.log(`✅ New branch pushed with upstream`);
136
+ } catch {
137
+ console.log(`⚠️ Committed locally, push failed`);
138
+ }
139
+ }
140
+ } else {
141
+ console.log(`✅ Plugin-config repo is clean`);
142
+ }
143
+ } catch (error) {
144
+ console.error(`⚠️ Failed to check or commit plugin-config: ${error}`);
145
+ }
146
+ }
147
+
148
+ /**
149
+ * Display injection plan and ask for confirmation
150
+ */
151
+ export async function showInjectionPlan(
152
+ plan: InjectionPlan,
153
+ autoConfirm: boolean = false
154
+ ): Promise<boolean> {
155
+ const { createReadlineInterface } = await import('./utils.ts');
156
+ const rl = createReadlineInterface();
157
+
158
+ console.log(`\n🎯 Injection Plan for: ${plan.targetPath}`);
159
+ console.log(`📁 Target: ${path.basename(plan.targetPath)}`);
160
+ console.log(`📦 Package.json: ${plan.hasPackageJson ? '✅' : '❌'}`);
161
+ console.log(`📋 Manifest.json: ${plan.hasManifest ? '✅' : '❌'}`);
162
+ console.log(
163
+ `📂 Scripts folder: ${plan.hasScriptsFolder ? '✅ (will be updated)' : '❌ (will be created)'}`
164
+ );
165
+ console.log(`🔌 Obsidian plugin: ${plan.isObsidianPlugin ? '✅' : '❌'}`);
166
+
167
+ if (!plan.isObsidianPlugin) {
168
+ console.log(`\n⚠️ Warning: This doesn't appear to be a valid Obsidian plugin`);
169
+ console.log(` Missing manifest.json or invalid structure`);
170
+ }
171
+
172
+ console.log(`\n📋 Will inject:`);
173
+ console.log(` ✅ Local scripts (esbuild.config.ts, utils.ts, env.ts, constants.ts, etc.)`);
174
+ console.log(` ✅ Updated package.json scripts`);
175
+ console.log(` ✅ Required dependencies`);
176
+
177
+ if (autoConfirm) {
178
+ console.log(`\n✅ Auto-confirming all file replacements...`);
179
+ rl.close();
180
+ return true;
181
+ }
182
+
183
+ // No global confirmation needed - file-by-file confirmation will happen in diffAndPromptFiles
184
+ rl.close();
185
+ return true;
186
+ }
187
+
188
+ /**
189
+ * Clean old script files
190
+ */
191
+ export async function cleanOldScripts(
192
+ scriptsPath: string,
193
+ approvedDests: Set<string>
194
+ ): Promise<void> {
195
+ const scriptNames = [
196
+ 'utils',
197
+ 'esbuild.config',
198
+ 'acp',
199
+ 'update-version',
200
+ 'release',
201
+ 'help',
202
+ 'constants',
203
+ 'env',
204
+ 'reload',
205
+ 'typingsPlugin'
206
+ ];
207
+ const extensions = ['.ts', '.mts', '.js', '.mjs'];
208
+
209
+ for (const scriptName of scriptNames) {
210
+ for (const ext of extensions) {
211
+ const scriptFile = path.join(scriptsPath, `${scriptName}${ext}`);
212
+ if (await isValidPath(scriptFile)) {
213
+ if (approvedDests.has(scriptFile)) {
214
+ fs.unlinkSync(scriptFile);
215
+ console.log(`🗑️ Removed existing ${scriptName}${ext} (will be replaced)`);
216
+ }
217
+ }
218
+ }
219
+ }
220
+
221
+ const obsoleteRootFiles = ['help-plugin.ts'];
222
+ for (const fileName of obsoleteRootFiles) {
223
+ const filePath = path.join(path.dirname(scriptsPath), fileName);
224
+ if (await isValidPath(filePath)) {
225
+ fs.unlinkSync(filePath);
226
+ console.log(`🗑️ Removed obsolete root file: ${fileName}`);
227
+ }
228
+ }
229
+
230
+ const obsoleteFiles = ['start.mjs', 'start.js'];
231
+ for (const fileName of obsoleteFiles) {
232
+ const filePath = path.join(scriptsPath, fileName);
233
+ if (await isValidPath(filePath)) {
234
+ fs.unlinkSync(filePath);
235
+ console.log(`🗑️ Removed obsolete file: ${fileName}`);
236
+ }
237
+ }
238
+ }
239
+
240
+ /**
241
+ * Clean old ESLint config files
242
+ */
243
+ export async function cleanOldLintFiles(targetPath: string): Promise<void> {
244
+ const oldLintFiles = ['.eslintrc', '.eslintrc.js', '.eslintrc.json', '.eslintignore'];
245
+ const conflictingLintFiles = [
246
+ 'eslint.config.ts',
247
+ 'eslint.config.cjs',
248
+ 'eslint.config.js',
249
+ 'eslint.config.mjs'
250
+ ];
251
+
252
+ for (const fileName of oldLintFiles) {
253
+ const filePath = path.join(targetPath, fileName);
254
+ if (await isValidPath(filePath)) {
255
+ fs.unlinkSync(filePath);
256
+ console.log(
257
+ `🗑️ Removed old ESLint file: ${fileName} (replaced by eslint.config.mts)`
258
+ );
259
+ }
260
+ }
261
+
262
+ for (const fileName of conflictingLintFiles) {
263
+ const filePath = path.join(targetPath, fileName);
264
+ if (await isValidPath(filePath)) {
265
+ fs.unlinkSync(filePath);
266
+ console.log(
267
+ `🗑️ Removed existing ESLint file: ${fileName} (will be replaced by injection)`
268
+ );
269
+ }
270
+ }
271
+ }
272
+
273
+ interface FileEntry {
274
+ src: string; // path relative to configRoot
275
+ dest: string; // absolute path in target plugin
276
+ mergeEnv?: boolean; // special .env merge logic
277
+ }
278
+
279
+ /**
280
+ * Build the full list of files to inject, with source and destination paths
281
+ */
282
+ function buildFileList(targetPath: string): FileEntry[] {
283
+ const scriptsPath = path.join(targetPath, 'scripts');
284
+ const entries: FileEntry[] = [];
285
+
286
+ // Scripts
287
+ const scriptFiles = [
288
+ 'templates/scripts/utils.ts',
289
+ 'templates/scripts/esbuild.config.ts',
290
+ 'templates/scripts/acp.ts',
291
+ 'templates/scripts/update-version.ts',
292
+ 'templates/scripts/release.ts',
293
+ 'templates/scripts/help.ts',
294
+ 'templates/scripts/constants.ts',
295
+ 'templates/scripts/env.ts',
296
+ 'templates/scripts/reload.ts',
297
+ 'templates/scripts/typingsPlugin.ts'
298
+ ];
299
+ for (const src of scriptFiles) {
300
+ entries.push({
301
+ src,
302
+ dest: path.join(scriptsPath, path.basename(src))
303
+ });
304
+ }
305
+
306
+ // Root config files
307
+ const configFileMap: Array<[string, string, boolean?]> = [
308
+ ['templates/tsconfig.json.template', 'tsconfig.json'],
309
+ ['templates/gitignore.template', '.gitignore'],
310
+ ['templates/eslint.config.mts', 'eslint.config.mts'],
311
+ ['templates/.editorconfig', '.editorconfig'],
312
+ ['templates/.prettierrc', '.prettierrc'],
313
+ ['templates/.prettierignore', '.prettierignore'],
314
+ ['templates/npmrc.template', '.npmrc'],
315
+ ['templates/.gitattributes', '.gitattributes'],
316
+ ['templates/env.template', '.env', true]
317
+ ];
318
+ for (const [src, destName, mergeEnv] of configFileMap) {
319
+ entries.push({
320
+ src,
321
+ dest: path.join(targetPath, destName),
322
+ mergeEnv: !!mergeEnv
323
+ });
324
+ }
325
+
326
+ // VSCode config files
327
+ const configVscodeMap: Array<[string, string]> = [
328
+ ['templates/.vscode/settings.json', '.vscode/settings.json'],
329
+ ['templates/.vscode/tasks.json', '.vscode/tasks.json'],
330
+ ['templates/.vscode/extensions.json', '.vscode/extensions.json']
331
+ ];
332
+ for (const [src, destName] of configVscodeMap) {
333
+ entries.push({
334
+ src,
335
+ dest: path.join(targetPath, destName)
336
+ });
337
+ }
338
+
339
+ // GitHub workflow files
340
+ const workflowFiles = [
341
+ 'templates/.github/workflows/release.yml',
342
+ 'templates/.github/workflows/release-body.md'
343
+ ];
344
+ for (const src of workflowFiles) {
345
+ entries.push({
346
+ src,
347
+ dest: path.join(targetPath, src.replace('templates/', ''))
348
+ });
349
+ }
350
+
351
+ return entries;
352
+ }
353
+
354
+ /**
355
+ * Compare source templates with existing target files.
356
+ * Prompt user only when content differs and file already exists.
357
+ * Returns the Set of dest paths approved for injection.
358
+ */
359
+ export async function diffAndPromptFiles(
360
+ targetPath: string,
361
+ autoConfirm: boolean
362
+ ): Promise<Set<string>> {
363
+ const { askConfirmation, createReadlineInterface } = await import('./utils.ts');
364
+ const rl = autoConfirm ? null : createReadlineInterface();
365
+ const configRoot = findPluginConfigRoot();
366
+ const entries = buildFileList(targetPath);
367
+ const approved = new Set<string>();
368
+
369
+ console.log(`\n🔍 Comparing files with existing content...`);
370
+
371
+ let hasChanges = false;
372
+
373
+ for (const entry of entries) {
374
+ // Skip .env merge (always approved, merge logic handled separately)
375
+ if (entry.mergeEnv) {
376
+ approved.add(entry.dest);
377
+ continue;
378
+ }
379
+
380
+ const srcPath = path.join(configRoot, entry.src);
381
+ let srcContent: string;
382
+ try {
383
+ srcContent = fs.readFileSync(srcPath, 'utf8');
384
+ } catch {
385
+ // Source doesn't exist, skip
386
+ continue;
387
+ }
388
+
389
+ // Target doesn't exist yet → inject without prompting
390
+ if (!fs.existsSync(entry.dest)) {
391
+ approved.add(entry.dest);
392
+ continue;
393
+ }
394
+
395
+ // Special case: eslint.config.mts - auto-approve if old .eslintrc exists
396
+ if (entry.dest.endsWith('eslint.config.mts')) {
397
+ const oldEslintFiles = [
398
+ '.eslintrc',
399
+ '.eslintrc.js',
400
+ '.eslintrc.json',
401
+ '.eslintrc.cjs'
402
+ ];
403
+ const hasOldEslint = oldEslintFiles.some((file) =>
404
+ fs.existsSync(path.join(targetPath, file))
405
+ );
406
+ if (hasOldEslint) {
407
+ console.log(
408
+ ` 🔄 ${path.relative(targetPath, entry.dest)} (migrating from old .eslintrc format)`
409
+ );
410
+ approved.add(entry.dest);
411
+ continue;
412
+ }
413
+ }
414
+
415
+ const destContent = fs.readFileSync(entry.dest, 'utf8');
416
+
417
+ // Identical → skip silently
418
+ if (srcContent === destContent) {
419
+ console.log(` ✅ ${path.relative(targetPath, entry.dest)} (unchanged)`);
420
+ continue;
421
+ }
422
+
423
+ // Different → ask user (or auto-approve if autoConfirm)
424
+ hasChanges = true;
425
+ const relDest = path.relative(targetPath, entry.dest);
426
+
427
+ if (autoConfirm) {
428
+ console.log(` ✅ ${relDest} (will be updated)`);
429
+ approved.add(entry.dest);
430
+ } else {
431
+ const update = await askConfirmation(
432
+ ` Update ${relDest}? (content differs)`,
433
+ rl!
434
+ );
435
+ if (update) {
436
+ approved.add(entry.dest);
437
+ } else {
438
+ console.log(` ⏭️ Kept existing ${relDest}`);
439
+ }
440
+ }
441
+ }
442
+
443
+ if (!hasChanges) {
444
+ console.log(` ✅ All existing files are up to date`);
445
+ }
446
+
447
+ if (rl) rl.close();
448
+ return approved;
449
+ }
450
+
451
+ /**
452
+ * Inject scripts and config files
453
+ */
454
+ export async function injectScripts(
455
+ targetPath: string,
456
+ approvedDests: Set<string>
457
+ ): Promise<void> {
458
+ const scriptsPath = path.join(targetPath, 'scripts');
459
+
460
+ if (!(await isValidPath(scriptsPath))) {
461
+ fs.mkdirSync(scriptsPath, { recursive: true });
462
+ console.log(`📁 Created scripts directory`);
463
+ }
464
+
465
+ await cleanOldScripts(scriptsPath, approvedDests);
466
+ await cleanOldLintFiles(targetPath);
467
+
468
+ const scriptFiles = [
469
+ 'templates/scripts/utils.ts',
470
+ 'templates/scripts/esbuild.config.ts',
471
+ 'templates/scripts/acp.ts',
472
+ 'templates/scripts/update-version.ts',
473
+ 'templates/scripts/release.ts',
474
+ 'templates/scripts/help.ts',
475
+ 'templates/scripts/constants.ts',
476
+ 'templates/scripts/env.ts',
477
+ 'templates/scripts/reload.ts',
478
+ 'templates/scripts/typingsPlugin.ts'
479
+ ];
480
+
481
+ // Files that need value-preserving merge instead
482
+ // of full overwrite (user fills in their paths)
483
+ const mergeEnvFile = new Set(['.env']);
484
+
485
+ // Files with .template suffix (NPM excludes dotfiles)
486
+ // Map: { source: targetName }
487
+ const configFileMap: Record<string, string> = {
488
+ 'templates/tsconfig.json.template': 'tsconfig.json',
489
+ 'templates/gitignore.template': '.gitignore',
490
+ 'templates/eslint.config.mts': 'eslint.config.mts',
491
+ 'templates/.editorconfig': '.editorconfig',
492
+ 'templates/.prettierrc': '.prettierrc',
493
+ 'templates/.prettierignore': '.prettierignore',
494
+ 'templates/npmrc.template': '.npmrc',
495
+ 'templates/.gitattributes': '.gitattributes',
496
+ 'templates/env.template': '.env'
497
+ };
498
+
499
+ const configVscodeMap: Record<string, string> = {
500
+ 'templates/.vscode/settings.json': '.vscode/settings.json',
501
+ 'templates/.vscode/tasks.json': '.vscode/tasks.json',
502
+ 'templates/.vscode/extensions.json': '.vscode/extensions.json'
503
+ };
504
+
505
+ const workflowFiles = [
506
+ 'templates/.github/workflows/release.yml',
507
+ 'templates/.github/workflows/release-body.md'
508
+ ];
509
+
510
+ console.log(`\n📥 Copying scripts from local files...`);
511
+
512
+ for (const scriptFile of scriptFiles) {
513
+ try {
514
+ const fileName = path.basename(scriptFile);
515
+ const targetFile = path.join(scriptsPath, fileName);
516
+ if (!approvedDests.has(targetFile)) {
517
+ console.log(` ⏭️ Skipped ${fileName} (kept existing)`);
518
+ continue;
519
+ }
520
+ const content = copyFromLocal(scriptFile);
521
+ fs.writeFileSync(targetFile, content, 'utf8');
522
+ console.log(` ✅ ${fileName}`);
523
+ } catch (error) {
524
+ console.error(` ❌ Failed to inject ${scriptFile}: ${error}`);
525
+ }
526
+ }
527
+
528
+ console.log(`\n📥 Copying config files...`);
529
+
530
+ // Copy root config files
531
+ for (const [src, destName] of Object.entries(configFileMap)) {
532
+ // Skip if not approved by diff step
533
+ const targetFile = path.join(targetPath, destName);
534
+ if (!approvedDests.has(targetFile)) {
535
+ continue; // already logged during diff step
536
+ }
537
+
538
+ try {
539
+ const templateContent = copyFromLocal(src);
540
+
541
+ // For .env: merge existing values into the template
542
+ if (mergeEnvFile.has(destName) && fs.existsSync(targetFile)) {
543
+ const existing = fs.readFileSync(targetFile, 'utf8');
544
+ // Parse existing key=value pairs
545
+ const existingVals: Record<string, string> = {};
546
+ for (const line of existing.split(/\r?\n/)) {
547
+ const m = line.match(/^([^#=]+)=(.*)$/);
548
+ if (m) existingVals[m[1].trim()] = m[2].trim();
549
+ }
550
+ // Re-write template, substituting existing values
551
+ const merged = templateContent
552
+ .split(/\r?\n/)
553
+ .map((line) => {
554
+ const m = line.match(/^([^#=]+)=(.*)$/);
555
+ if (m) {
556
+ const key = m[1].trim();
557
+ const val = existingVals[key] ?? m[2].trim();
558
+ return `${key}=${val}`;
559
+ }
560
+ return line;
561
+ })
562
+ .join('\n');
563
+ fs.writeFileSync(targetFile, merged, 'utf8');
564
+ console.log(` ✅ ${destName} (values preserved)`);
565
+ continue;
566
+ }
567
+
568
+ fs.writeFileSync(targetFile, templateContent, 'utf8');
569
+ console.log(` ✅ ${destName}`);
570
+ } catch (error) {
571
+ console.error(` ❌ Failed to inject ${destName}: ${error}`);
572
+ }
573
+ }
574
+
575
+ // Copy .vscode config files
576
+ for (const [src, destName] of Object.entries(configVscodeMap)) {
577
+ try {
578
+ const targetFile = path.join(targetPath, destName);
579
+ if (!approvedDests.has(targetFile)) continue;
580
+ const content = copyFromLocal(src);
581
+ const targetDir = path.dirname(targetFile);
582
+ if (!(await isValidPath(targetDir))) {
583
+ fs.mkdirSync(targetDir, { recursive: true });
584
+ }
585
+ fs.writeFileSync(targetFile, content, 'utf8');
586
+ console.log(` ✅ ${destName}`);
587
+ } catch (error) {
588
+ console.error(` ❌ Failed to inject ${destName}: ${error}`);
589
+ }
590
+ }
591
+
592
+ console.log(`\n📥 Copying GitHub workflows from local files...`);
593
+
594
+ for (const workflowFile of workflowFiles) {
595
+ try {
596
+ const content = copyFromLocal(workflowFile);
597
+ const relativePath = workflowFile.replace('templates/', '');
598
+ const targetFile = path.join(targetPath, relativePath);
599
+ if (!approvedDests.has(targetFile)) continue;
600
+ const targetDir = path.dirname(targetFile);
601
+
602
+ if (!(await isValidPath(targetDir))) {
603
+ fs.mkdirSync(targetDir, { recursive: true });
604
+ }
605
+
606
+ fs.writeFileSync(targetFile, content, 'utf8');
607
+ console.log(` ✅ ${relativePath}`);
608
+ } catch (error) {
609
+ console.error(` ❌ Failed to inject ${workflowFile}: ${error}`);
610
+ }
611
+ }
612
+ }
613
+
614
+ /**
615
+ * Update package.json with autonomous configuration
616
+ */
617
+ export async function updatePackageJson(
618
+ targetPath: string
619
+ ): Promise<void> {
620
+ const packageJsonPath = path.join(targetPath, 'package.json');
621
+
622
+ if (!(await isValidPath(packageJsonPath))) {
623
+ console.log(`❌ No package.json found, skipping package.json update`);
624
+ return;
625
+ }
626
+
627
+ try {
628
+ const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
629
+
630
+ const configRoot = findPluginConfigRoot();
631
+ const templatePkg = JSON.parse(
632
+ fs.readFileSync(path.join(configRoot, 'templates/package.json.template'), 'utf8')
633
+ );
634
+
635
+ const obsoleteScripts = ['version'];
636
+ for (const script of obsoleteScripts) {
637
+ if (packageJson.scripts?.[script]) {
638
+ console.log(` 🧹 Removing obsolete script: "${script}"`);
639
+ delete packageJson.scripts[script];
640
+ }
641
+ }
642
+
643
+ packageJson.scripts = {
644
+ ...packageJson.scripts,
645
+ ...templatePkg.scripts
646
+ };
647
+
648
+ if (!packageJson.devDependencies) packageJson.devDependencies = {};
649
+
650
+ const requiredDeps: Record<string, string> = templatePkg.devDependencies;
651
+
652
+ let addedDeps = 0;
653
+ let updatedDeps = 0;
654
+ for (const [dep, version] of Object.entries(requiredDeps)) {
655
+ if (!packageJson.devDependencies[dep]) {
656
+ packageJson.devDependencies[dep] = version as string;
657
+ addedDeps++;
658
+ } else if (packageJson.devDependencies[dep] !== version) {
659
+ packageJson.devDependencies[dep] = version as string;
660
+ updatedDeps++;
661
+ }
662
+ }
663
+
664
+ if (!packageJson.engines) packageJson.engines = {};
665
+ packageJson.engines.npm = templatePkg.engines.npm;
666
+ packageJson.engines.yarn = templatePkg.engines.yarn;
667
+ packageJson.type = templatePkg.type;
668
+
669
+ fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2), 'utf8');
670
+ console.log(
671
+ ` ✅ Updated package.json (${addedDeps} new, ${updatedDeps} updated dependencies)`
672
+ );
673
+ } catch (error) {
674
+ console.error(` ❌ Failed to update package.json: ${error}`);
675
+ }
676
+ }
677
+
678
+ /**
679
+ * Create required directories
680
+ */
681
+ export async function createRequiredDirectories(targetPath: string): Promise<void> {
682
+ const directories = [path.join(targetPath, '.github', 'workflows')];
683
+
684
+ for (const dir of directories) {
685
+ if (!(await isValidPath(dir))) {
686
+ fs.mkdirSync(dir, { recursive: true });
687
+ console.log(` 📁 Created ${path.relative(targetPath, dir)}`);
688
+ }
689
+ }
690
+ }
691
+
692
+ /**
693
+ * Create injection info file
694
+ */
695
+ export async function createInjectionInfo(targetPath: string): Promise<void> {
696
+ const configRoot = findPluginConfigRoot();
697
+ const configPackageJsonPath = path.join(configRoot, 'package.json');
698
+
699
+ let injectorVersion = 'unknown';
700
+ try {
701
+ const configPackageJson = JSON.parse(fs.readFileSync(configPackageJsonPath, 'utf8'));
702
+ injectorVersion = configPackageJson.version || 'unknown';
703
+ } catch {
704
+ console.warn('Warning: Could not read injector version');
705
+ }
706
+
707
+ const injectionInfo = {
708
+ injectorVersion,
709
+ injectionDate: new Date().toISOString(),
710
+ injectorName: 'obsidian-plugin-config'
711
+ };
712
+
713
+ const infoPath = path.join(targetPath, '.injection-info.json');
714
+ fs.writeFileSync(infoPath, JSON.stringify(injectionInfo, null, 2));
715
+ console.log(` ✅ Created injection info file (.injection-info.json)`);
716
+ }
717
+
718
+ /**
719
+ * Read injection info from target plugin
720
+ */
721
+ export function readInjectionInfo(targetPath: string): Record<string, string> | null {
722
+ const infoPath = path.join(targetPath, '.injection-info.json');
723
+
724
+ if (!fs.existsSync(infoPath)) return null;
725
+
726
+ try {
727
+ return JSON.parse(fs.readFileSync(infoPath, 'utf8'));
728
+ } catch {
729
+ console.warn('Warning: Could not parse .injection-info.json');
730
+ return null;
731
+ }
732
+ }
733
+
734
+ /**
735
+ * Clean NPM/Yarn lock files and node_modules to ensure fresh install
736
+ */
737
+ export async function cleanNpmArtifactsIfNeeded(targetPath: string): Promise<void> {
738
+ const packageLockPath = path.join(targetPath, 'package-lock.json');
739
+ const yarnLockPath = path.join(targetPath, 'yarn.lock');
740
+ const nodeModulesPath = path.join(targetPath, 'node_modules');
741
+
742
+ const hasPackageLock = fs.existsSync(packageLockPath);
743
+ const hasYarnLock = fs.existsSync(yarnLockPath);
744
+
745
+ if (hasPackageLock) {
746
+ console.log(`\n🧹 Cleaning NPM artifacts (migrating to Yarn)...`);
747
+
748
+ try {
749
+ // Remove node_modules FIRST (before lock files)
750
+ if (fs.existsSync(nodeModulesPath)) {
751
+ console.log(` ⏳ Removing node_modules (this may take a moment)...`);
752
+
753
+ try {
754
+ fs.rmSync(nodeModulesPath, { recursive: true, force: true });
755
+ } catch {
756
+ // Ignore initial error, lock detection checks if it still exists below
757
+ }
758
+
759
+ if (fs.existsSync(nodeModulesPath)) {
760
+ // rmdir failed silently (locked .exe files) - rename instead
761
+ const timestamp = Date.now();
762
+ const oldPath = `${nodeModulesPath}.old.${timestamp}`;
763
+ try {
764
+ fs.renameSync(nodeModulesPath, oldPath);
765
+ console.log(` 🔄 Renamed locked node_modules to ${path.basename(oldPath)}`);
766
+ console.log(` 💡 Delete it manually later: ${oldPath}`);
767
+ } catch {
768
+ console.log(
769
+ ` ⚠️ Could not remove/rename node_modules (locked by processes)`
770
+ );
771
+ console.log(` 💡 Close Obsidian/VSCode and run: obsidian-inject again`);
772
+ throw new Error('node_modules locked - close processes and retry');
773
+ }
774
+ } else {
775
+ console.log(` 🗑️ Removed node_modules (will be reinstalled with Yarn)`);
776
+ }
777
+ }
778
+
779
+ // Then remove lock files
780
+ if (hasPackageLock) {
781
+ fs.unlinkSync(packageLockPath);
782
+ console.log(` 🗑️ Removed package-lock.json`);
783
+ }
784
+
785
+ if (hasYarnLock) {
786
+ fs.unlinkSync(yarnLockPath);
787
+ console.log(` 🗑️ Removed yarn.lock`);
788
+ }
789
+
790
+ console.log(` ✅ Lock files and artifacts cleaned for fresh install`);
791
+ } catch (error) {
792
+ if (error instanceof Error && error.message.includes('locked')) {
793
+ throw error;
794
+ }
795
+ console.error(` ❌ Failed to clean artifacts: ${error}`);
796
+ console.log(
797
+ ` 💡 You may need to manually remove package-lock.json, yarn.lock and node_modules`
798
+ );
799
+ }
800
+ }
801
+ }
802
+
803
+ /**
804
+ * Check if tsx is installed locally and install it if needed
805
+ */
806
+ export async function ensureTsxInstalled(targetPath: string): Promise<void> {
807
+ console.log(`\n🔍 Checking tsx installation...`);
808
+
809
+ const packageJsonPath = path.join(targetPath, 'package.json');
810
+
811
+ try {
812
+ const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
813
+ const devDependencies = packageJson.devDependencies || {};
814
+ const dependencies = packageJson.dependencies || {};
815
+
816
+ if (devDependencies.tsx || dependencies.tsx) {
817
+ console.log(` ✅ tsx is already installed`);
818
+ return;
819
+ }
820
+
821
+ console.log(` ⚠️ tsx not found, installing as dev dependency...`);
822
+ execSync('yarn add -D tsx', { cwd: targetPath, stdio: 'inherit' });
823
+ console.log(` ✅ tsx installed successfully`);
824
+ } catch (error) {
825
+ console.error(` Failed to install tsx: ${error}`);
826
+ console.log(` 💡 You may need to install tsx manually: yarn add -D tsx`);
827
+ throw new Error('tsx installation failed');
828
+ }
829
+ }
830
+
831
+ /**
832
+ * Run yarn install in target directory
833
+ */
834
+ export async function runYarnInstall(targetPath: string): Promise<void> {
835
+ console.log(`\n📦 Installing dependencies...`);
836
+
837
+ try {
838
+ execSync('yarn install', { cwd: targetPath, stdio: 'inherit' });
839
+ console.log(` ✅ Dependencies installed successfully`);
840
+ } catch (error) {
841
+ console.error(` ❌ Failed to install dependencies: ${error}`);
842
+ console.log(
843
+ ` 💡 You may need to run 'yarn install' manually in the target directory`
844
+ );
845
+ }
846
+ }
847
+
848
+ /**
849
+ * Main injection orchestration function
850
+ */
851
+ export async function performInjection(
852
+ targetPath: string,
853
+ autoConfirm: boolean = false
854
+ ): Promise<void> {
855
+ console.log(`\n🚀 Starting injection process...`);
856
+
857
+ try {
858
+ const approvedDests = await diffAndPromptFiles(targetPath, autoConfirm);
859
+ await cleanNpmArtifactsIfNeeded(targetPath);
860
+ await ensureTsxInstalled(targetPath);
861
+ await injectScripts(targetPath, approvedDests);
862
+
863
+ console.log(`\n📦 Updating package.json...`);
864
+ await updatePackageJson(targetPath);
865
+
866
+ console.log(`\n📁 Creating required directories...`);
867
+ await createRequiredDirectories(targetPath);
868
+
869
+ await runYarnInstall(targetPath);
870
+
871
+ console.log(`\n📝 Creating injection info...`);
872
+ await createInjectionInfo(targetPath);
873
+
874
+ console.log(`\n Injection completed successfully!`);
875
+ console.log(`\n📋 Next steps:`);
876
+ console.log(` 1. cd ${targetPath}`);
877
+ console.log(` 2. yarn build # Test the build`);
878
+ console.log(` 3. yarn start # Test development mode`);
879
+ console.log(` 4. yarn acp # Commit changes (or yarn bacp for build+commit)`);
880
+
881
+ // Check for .old directories and remind user to delete them
882
+ const oldDirs = fs
883
+ .readdirSync(targetPath)
884
+ .filter((name) => name.startsWith('node_modules.old.'))
885
+ .map((name) => path.basename(name));
886
+
887
+ if (oldDirs.length > 0) {
888
+ console.log(`\n🧹 Cleanup reminder:`);
889
+ for (const oldDir of oldDirs) {
890
+ console.log(` 🗑️ Delete manually: ${oldDir}`);
891
+ }
892
+ console.log(` 💡 Close all processes first, then delete these folders`);
893
+ }
894
+ } catch (error) {
895
+ console.error(`\n❌ Injection failed: ${error}`);
896
+ throw error;
897
+ }
898
+ }