@stacksjs/actions 0.75.514 → 0.75.518

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/dist/action.js +1 -1
  2. package/dist/auth/client-options.js +1 -1
  3. package/dist/auth/client.js +1 -1
  4. package/dist/auth/prune.js +1 -1
  5. package/dist/auth/setup.js +2 -2
  6. package/dist/blog-admin.js +3 -3
  7. package/dist/blog.js +23 -23
  8. package/dist/build/android-config.js +1 -1
  9. package/dist/build/android-icons.js +1 -1
  10. package/dist/build/android.js +1 -1
  11. package/dist/build/component-library.js +1 -1
  12. package/dist/build/core.js +1 -1
  13. package/dist/build/craft-entry.js +1 -1
  14. package/dist/build/craft-provenance.js +1 -1
  15. package/dist/build/desktop-macos.js +2 -2
  16. package/dist/build/desktop.js +2 -2
  17. package/dist/build/dmg-macos.js +1 -1
  18. package/dist/build/dmg.js +1 -1
  19. package/dist/build/docs.js +1 -1
  20. package/dist/build/frontend-static.js +5 -5
  21. package/dist/build/ios-config.js +3 -3
  22. package/dist/build/ios-shell.js +3 -3
  23. package/dist/build/ios-toolchain.js +2 -2
  24. package/dist/build/ios.js +2 -2
  25. package/dist/build/macos-native.js +3 -3
  26. package/dist/build/mobile-splash.js +1 -1
  27. package/dist/build/mobile-target.js +1 -1
  28. package/dist/build/native-screens.js +1 -1
  29. package/dist/build/native-sensors.js +1 -1
  30. package/dist/build/notarize.js +2 -2
  31. package/dist/build/run-build-step.js +1 -1
  32. package/dist/build/stacks.js +1 -1
  33. package/dist/build/views.js +1 -1
  34. package/dist/build.js +1 -1
  35. package/dist/bump.js +7 -7
  36. package/dist/calendar-version.js +1 -1
  37. package/dist/changelog.js +1 -1
  38. package/dist/check/ports.js +1 -1
  39. package/dist/commit.js +1 -1
  40. package/dist/database/seed.js +1 -1
  41. package/dist/deploy/create-receipt-rule.js +1 -1
  42. package/dist/deploy/hooks.js +1 -1
  43. package/dist/deploy/index.js +17 -17
  44. package/dist/deploy/stack.js +6 -6
  45. package/dist/dev/api.js +1 -1
  46. package/dist/dev/components.js +1 -1
  47. package/dist/dev/csrf.js +1 -1
  48. package/dist/dev/dashboard-native.js +1 -1
  49. package/dist/dev/dashboard-request-routing.js +1 -1
  50. package/dist/dev/dashboard-supervisor.js +2 -2
  51. package/dist/dev/dashboard-utils.js +1 -1
  52. package/dist/dev/dashboard.js +4 -4
  53. package/dist/dev/defaults-resources.js +1 -1
  54. package/dist/dev/docs.js +1 -1
  55. package/dist/dev/exit-with-parent.js +1 -1
  56. package/dist/dev/migrate-watcher.js +1 -1
  57. package/dist/dev/system-tray.js +2 -2
  58. package/dist/dev/tray-origin.js +1 -1
  59. package/dist/dev/views.js +1 -1
  60. package/dist/discover-packages.js +1 -1
  61. package/dist/domains/add.js +1 -1
  62. package/dist/domains/purchase.js +1 -1
  63. package/dist/domains/remove.js +1 -1
  64. package/dist/examples.js +1 -1
  65. package/dist/find-projects.js +1 -1
  66. package/dist/generate/action-types.js +3 -3
  67. package/dist/generate/erd.js +2 -2
  68. package/dist/generate/ide-helpers.js +1 -1
  69. package/dist/generate/images.js +1 -1
  70. package/dist/generate/index.js +1 -1
  71. package/dist/generate/lib-entries.js +1 -1
  72. package/dist/generate/vschema.js +2 -2
  73. package/dist/github-release.js +5 -5
  74. package/dist/helpers/api-host.js +3 -3
  75. package/dist/helpers/api-shutdown.js +1 -1
  76. package/dist/helpers/component-meta.js +3 -3
  77. package/dist/helpers/utils.js +1 -1
  78. package/dist/helpers/vscode-custom-data.js +1 -1
  79. package/dist/key-generate.js +1 -1
  80. package/dist/library/build.js +2 -2
  81. package/dist/library/entries.js +1 -1
  82. package/dist/library/globals.js +1 -1
  83. package/dist/library/manifest.js +2 -2
  84. package/dist/library/packages.js +1 -1
  85. package/dist/library/publish.js +2 -2
  86. package/dist/library-publish.js +1 -1
  87. package/dist/lint/files.js +1 -1
  88. package/dist/lint/lint.js +1 -1
  89. package/dist/lint/stx-gate.js +3 -3
  90. package/dist/make-command.js +2 -2
  91. package/dist/make-job.js +2 -2
  92. package/dist/make-policy.js +2 -2
  93. package/dist/make-resource.js +1 -1
  94. package/dist/make.js +7 -7
  95. package/dist/migrate/database.js +1 -1
  96. package/dist/migrate/fresh.js +1 -1
  97. package/dist/pantry-lock.js +1 -1
  98. package/dist/pantry-toolchain.js +1 -1
  99. package/dist/project-scripts.js +1 -1
  100. package/dist/publication-preflight.js +1 -1
  101. package/dist/queue/clear.js +1 -1
  102. package/dist/queue/dlq-purge.js +1 -1
  103. package/dist/queue/dlq-retry.js +1 -1
  104. package/dist/queue/dlq.js +2 -2
  105. package/dist/queue/failed.js +2 -2
  106. package/dist/queue/flush.js +1 -1
  107. package/dist/queue/inspect.js +6 -6
  108. package/dist/queue/list.js +2 -2
  109. package/dist/queue/monitor.js +5 -5
  110. package/dist/queue/options.js +1 -1
  111. package/dist/queue/pause.js +1 -1
  112. package/dist/queue/quarantine.js +1 -1
  113. package/dist/queue/resume.js +1 -1
  114. package/dist/queue/retry.js +1 -1
  115. package/dist/queue/schedule-list.js +2 -2
  116. package/dist/queue/status.js +2 -2
  117. package/dist/queue/unquarantine.js +1 -1
  118. package/dist/queue/work.js +1 -1
  119. package/dist/release-evidence.js +1 -1
  120. package/dist/release-notes.js +5 -5
  121. package/dist/release-preflight.js +2 -2
  122. package/dist/release-push-target.js +3 -3
  123. package/dist/release.js +1 -1
  124. package/dist/reviewos-evidence.js +1 -1
  125. package/dist/route/list.js +1 -1
  126. package/dist/saas/setup.js +1 -1
  127. package/dist/scaffold-crud.js +7 -7
  128. package/dist/search/flush.js +1 -1
  129. package/dist/search/import.js +1 -1
  130. package/dist/search/settings-list.js +1 -1
  131. package/dist/seo.js +4 -4
  132. package/dist/serve/api.js +1 -1
  133. package/dist/serve/dashboard-gate.js +1 -1
  134. package/dist/serve/dashboard.js +1 -1
  135. package/dist/setup/ssl.js +2 -2
  136. package/dist/stacks.js +1 -1
  137. package/dist/stx-source.js +1 -1
  138. package/dist/test/feature.js +1 -1
  139. package/dist/test/runner.js +1 -1
  140. package/dist/test/unit.js +1 -1
  141. package/dist/upgrade/binary.js +1 -1
  142. package/dist/upgrade/framework-hooks.d.ts +6 -0
  143. package/dist/upgrade/framework-hooks.js +1 -1
  144. package/dist/upgrade/framework-utils.js +2 -2
  145. package/dist/upgrade/framework.js +10 -10
  146. package/dist/upgrade/package-project.js +2 -2
  147. package/dist/upgrade/packages.js +23 -22
  148. package/dist/upgrade/route-actions.js +3 -3
  149. package/dist/upgrade/shell.js +4 -4
  150. package/dist/upgrade.js +1 -1
  151. package/package.json +40 -40
package/dist/stacks.js CHANGED
@@ -1 +1 @@
1
- import{mkdtempSync,rmSync}from"node:fs";import{tmpdir}from"node:os";import{dirname,isAbsolute,join,relative,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/logging";import{registry}from"@stacksjs/registry";import{copyFile,createFolder,deleteFile,deleteEmptyFolders,doesFolderExist,fs}from"@stacksjs/storage";const STACK_DIRS=["app","config","database","resources","routes","public","locales","docs"];function stackLockPath(projectRoot){return join(projectRoot,"storage","framework","stacks.lock.json")}function stackBackupPath(projectRoot,stackName){return join(projectRoot,"storage","framework","stacks","backups",stackName)}async function readStackLock(projectRoot){const lockPath=stackLockPath(projectRoot);try{if(fs.existsSync(lockPath)){const content=await Bun.file(lockPath).text();return JSON.parse(content)}}catch{}return{version:1,generatedAt:new Date().toISOString(),stacks:{}}}async function writeStackLock(projectRoot,lock){const lockPath=stackLockPath(projectRoot),lockDir=dirname(lockPath);if(!fs.existsSync(lockDir))await createFolder(lockDir);lock.generatedAt=new Date().toISOString();await Bun.write(lockPath,JSON.stringify(lock,null,2))}function resolveProjectRoot(project){return resolve(project||process.cwd())}function resolveRegistryEntry(name){const entry=registry.find((candidate)=>{if(typeof candidate==="string")return candidate===name;return candidate.name===name||candidate.package===name});if(!entry||typeof entry==="string")return null;if(!entry.github)return null;return{name:entry.name,github:entry.github,package:entry.package}}async function checkoutRegistryStack(github){const tempRoot=mkdtempSync(join(tmpdir(),"stacks-stack-")),checkoutPath=join(tempRoot,"source"),source=`https://github.com/${github}.git`;if(await Bun.spawn(["git","clone","--depth","1","--quiet",source,checkoutPath],{stdout:"inherit",stderr:"inherit"}).exited!==0){rmSync(tempRoot,{recursive:!0,force:!0});throw Error(`Could not pull ${source}`)}return{path:checkoutPath,cleanup:()=>rmSync(tempRoot,{recursive:!0,force:!0})}}function isSafeStackDirectory(directory){return directory.length>0&&!isAbsolute(directory)&&!directory.includes("..")&&!directory.includes("\\")}function fileChecksum(path){return new Bun.CryptoHasher("sha256").update(fs.readFileSync(path)).digest("hex")}function collectFiles(dir,baseDir){const files=[];if(!fs.existsSync(dir))return files;const entries=fs.readdirSync(dir,{withFileTypes:!0});for(const entry of entries){const fullPath=join(dir,entry.name);if(entry.isDirectory())files.push(...collectFiles(fullPath,baseDir));else if(entry.isSymbolicLink())throw Error(`Stack contains an unsupported symbolic link: ${relative(baseDir,fullPath)}`);else{const relPath=relative(baseDir,fullPath);if(!isSafeStackDirectory(relPath))throw Error(`Stack contains an unsafe path: ${relPath}`);files.push(relPath)}}return files}export async function installStack(options){const{name,force=!1,dryRun=!1,verbose=!1}=options,conflict=force?"overwrite":options.conflict??"skip",projectRoot=resolveProjectRoot(options.project);log.info(`Installing stack "${name}"...`);if(!fs.existsSync(join(projectRoot,"package.json"))){log.error(`No Stacks project found at "${projectRoot}"`);return null}const registryEntry=resolveRegistryEntry(name);if(!registryEntry){log.error(`Stack "${name}" is not in the Stacks registry. Run "buddy stack:list" to see available stacks.`);return null}let checkout;try{checkout=await checkoutRegistryStack(registryEntry.github)}catch(error){log.error(error instanceof Error?error.message:String(error));return null}try{const stackPath=checkout.path;let pkg,meta;try{const pkgContent=await Bun.file(join(stackPath,"package.json")).text();pkg=JSON.parse(pkgContent);meta=pkg.stacks;if(!meta?.name||meta.name!==registryEntry.name){log.error(`Registry source "${registryEntry.github}" does not declare stacks.name as "${registryEntry.name}"`);return null}}catch(error){log.error(`Failed to read stack metadata: ${error}`);return null}const lock=await readStackLock(projectRoot),packageName=pkg.name||registryEntry.package||name;if(lock.stacks[packageName]&&!force){log.warn(`Stack "${meta.name}" is already installed. Use --force to reinstall.`);return lock.stacks[packageName]}const dirsToScan=meta.directories??STACK_DIRS;if(dirsToScan.some((directory)=>!isSafeStackDirectory(directory))){log.error(`Stack "${meta.name}" declares an unsafe project directory`);return null}const allFiles=[];try{for(const dir of dirsToScan){const dirPath=join(stackPath,dir);if(fs.existsSync(dirPath))allFiles.push(...collectFiles(dirPath,stackPath))}}catch(error){log.error(error instanceof Error?error.message:String(error));return null}if(allFiles.length===0){log.warn(`Stack "${meta.name}" has no project files to install`);return null}if(verbose)log.info(`Pulled ${registryEntry.github} and found ${allFiles.length} project file(s)`);const copiedFiles=[],skippedFiles=[],checksums={};for(const relPath of allFiles){const src=join(stackPath,relPath),dest=join(projectRoot,relPath);if(dryRun){if(fs.existsSync(dest)){log.info(`[dry-run] Would ${conflict}: ${relPath}`);if(conflict==="skip")skippedFiles.push(relPath);else copiedFiles.push(relPath)}else{log.info(`[dry-run] Would copy: ${relPath}`);copiedFiles.push(relPath)}continue}if(fs.existsSync(dest))switch(conflict){case"skip":if(verbose)log.warn(`Skipping (file exists): ${relPath}`);skippedFiles.push(relPath);continue;case"backup":{const backupDir=stackBackupPath(projectRoot,meta.name),backupDest=join(backupDir,relPath),backupDestDir=dirname(backupDest);if(!fs.existsSync(backupDestDir))await createFolder(backupDestDir);copyFile(dest,backupDest);if(verbose)log.info(`Backed up: ${relPath}`);break}case"overwrite":if(verbose)log.warn(`Overwriting: ${relPath}`);break}const destDir=dirname(dest);if(!fs.existsSync(destDir))await createFolder(destDir);copyFile(src,dest);copiedFiles.push(relPath);checksums[relPath]=fileChecksum(dest);if(verbose)log.info(`Copied: ${relPath}`)}const entry={packageName,name:meta.name,version:pkg.version||"0.0.0",installedAt:new Date().toISOString(),files:copiedFiles,checksums,source:registryEntry.github,skipped:skippedFiles,conflictStrategy:conflict};if(dryRun){log.info(`[dry-run] Would install ${copiedFiles.length} file(s), skip ${skippedFiles.length} file(s)`);return entry}lock.stacks[packageName]=entry;await writeStackLock(projectRoot,lock);log.success(`Installed stack "${meta.name}" from ${registryEntry.github} (${copiedFiles.length} file(s) copied, ${skippedFiles.length} skipped)`);return entry}finally{checkout.cleanup()}}export async function uninstallStack(options){const{name,force=!1,verbose=!1}=options,projectRoot=resolveProjectRoot(options.project);log.info(`Uninstalling stack "${name}"...`);const lock=await readStackLock(projectRoot);let entryKey=null,entry=null;for(const[key,value]of Object.entries(lock.stacks))if(value.name===name||key===name){entryKey=key;entry=value;break}if(!entry||!entryKey){log.error(`Stack "${name}" is not installed`);return!1}let removedCount=0;const remainingFiles=[];for(const relPath of entry.files){const filePath=join(projectRoot,relPath);if(!fs.existsSync(filePath)){if(verbose)log.info(`Already removed: ${relPath}`);continue}if(!force){const installedChecksum=entry.checksums?.[relPath];if(!installedChecksum||fileChecksum(filePath)!==installedChecksum){log.warn(`Skipping modified file: ${relPath} (use --force to remove)`);remainingFiles.push(relPath);continue}}const removed=await deleteFile(filePath);if(removed.isErr){log.warn(`Could not remove ${relPath}: ${removed.error.message}`);remainingFiles.push(relPath);continue}removedCount++;if(verbose)log.info(`Removed: ${relPath}`)}if(remainingFiles.length>0){entry.files=remainingFiles;entry.checksums=Object.fromEntries(remainingFiles.map((file)=>[file,entry.checksums?.[file]]).filter((item)=>typeof item[1]==="string"));lock.stacks[entryKey]=entry;await writeStackLock(projectRoot,lock);log.warn(`Stack "${entry.name}" is still tracked because ${remainingFiles.length} modified or undeletable file(s) remain`);return!1}const backupDir=stackBackupPath(projectRoot,entry.name);if(fs.existsSync(backupDir)&&doesFolderExist(backupDir)){const backupFiles=collectFiles(backupDir,backupDir);for(const relPath of backupFiles){const backupSrc=join(backupDir,relPath),dest=join(projectRoot,relPath),destDir=dirname(dest);if(!fs.existsSync(destDir))await createFolder(destDir);copyFile(backupSrc,dest);if(verbose)log.info(`Restored from backup: ${relPath}`)}fs.rmSync(backupDir,{recursive:!0,force:!0})}for(const dir of STACK_DIRS){const dirPath=join(projectRoot,dir);if(fs.existsSync(dirPath))await deleteEmptyFolders(dirPath)}delete lock.stacks[entryKey];await writeStackLock(projectRoot,lock);log.success(`Uninstalled stack "${entry.name}" (${removedCount} file(s) removed)`);return!0}export async function listStacks(project){const entries=[],projectRoot=resolveProjectRoot(project),lock=await readStackLock(projectRoot);for(const candidate of registry){if(typeof candidate==="string")continue;const packageName=candidate.package||candidate.name,lockEntry=lock.stacks[packageName];entries.push({name:candidate.name,packageName,version:lockEntry?.version||"latest",description:candidate.description,installed:Boolean(lockEntry),installedAt:lockEntry?.installedAt,fileCount:lockEntry?.files.length})}for(const[packageName,entry]of Object.entries(lock.stacks))if(!entries.some((e)=>e.packageName===packageName))entries.push({name:entry.name,packageName,version:entry.version,installed:!0,installedAt:entry.installedAt,fileCount:entry.files.length});return entries}
1
+ import{mkdtempSync,rmSync}from"node:fs";import{tmpdir}from"node:os";import{dirname,isAbsolute,join,relative,resolve}from"node:path";import process from"node:process";import{log}from"@stacksjs/logging";import{registry}from"@stacksjs/registry";import{copyFile,createFolder,deleteFile,deleteEmptyFolders,doesFolderExist,fs}from"@stacksjs/storage";const STACK_DIRS=["app","config","database","resources","routes","public","locales","docs"];function stackLockPath(projectRoot){return join(projectRoot,"storage","framework","stacks.lock.json")}function stackBackupPath(projectRoot,stackName){return join(projectRoot,"storage","framework","stacks","backups",stackName)}async function readStackLock(projectRoot){const lockPath=stackLockPath(projectRoot);try{if(fs.existsSync(lockPath)){const content=await Bun.file(lockPath).text();return JSON.parse(content)}}catch{}return{version:1,generatedAt:new Date().toISOString(),stacks:{}}}async function writeStackLock(projectRoot,lock){const lockPath=stackLockPath(projectRoot);const lockDir=dirname(lockPath);if(!fs.existsSync(lockDir))await createFolder(lockDir);lock.generatedAt=new Date().toISOString();await Bun.write(lockPath,JSON.stringify(lock,null,2))}function resolveProjectRoot(project){return resolve(project||process.cwd())}function resolveRegistryEntry(name){const entry=registry.find((candidate)=>{if(typeof candidate==="string")return candidate===name;return candidate.name===name||candidate.package===name});if(!entry||typeof entry==="string")return null;if(!entry.github)return null;return{name:entry.name,github:entry.github,package:entry.package}}async function checkoutRegistryStack(github){const tempRoot=mkdtempSync(join(tmpdir(),"stacks-stack-"));const checkoutPath=join(tempRoot,"source");const source=`https://github.com/${github}.git`;const child=Bun.spawn(["git","clone","--depth","1","--quiet",source,checkoutPath],{stdout:"inherit",stderr:"inherit"});const exitCode=await child.exited;if(exitCode!==0){rmSync(tempRoot,{recursive:true,force:true});throw new Error(`Could not pull ${source}`)}return{path:checkoutPath,cleanup:()=>rmSync(tempRoot,{recursive:true,force:true})}}function isSafeStackDirectory(directory){return directory.length>0&&!isAbsolute(directory)&&!directory.includes("..")&&!directory.includes("\\")}function fileChecksum(path){return new Bun.CryptoHasher("sha256").update(fs.readFileSync(path)).digest("hex")}function collectFiles(dir,baseDir){const files=[];if(!fs.existsSync(dir))return files;const entries=fs.readdirSync(dir,{withFileTypes:true});for(const entry of entries){const fullPath=join(dir,entry.name);if(entry.isDirectory()){files.push(...collectFiles(fullPath,baseDir))}else if(entry.isSymbolicLink()){throw new Error(`Stack contains an unsupported symbolic link: ${relative(baseDir,fullPath)}`)}else{const relPath=relative(baseDir,fullPath);if(!isSafeStackDirectory(relPath))throw new Error(`Stack contains an unsafe path: ${relPath}`);files.push(relPath)}}return files}export async function installStack(options){const{name,force=false,dryRun=false,verbose=false}=options;const conflict=force?"overwrite":options.conflict??"skip";const projectRoot=resolveProjectRoot(options.project);log.info(`Installing stack "${name}"...`);if(!fs.existsSync(join(projectRoot,"package.json"))){log.error(`No Stacks project found at "${projectRoot}"`);return null}const registryEntry=resolveRegistryEntry(name);if(!registryEntry){log.error(`Stack "${name}" is not in the Stacks registry. Run "buddy stack:list" to see available stacks.`);return null}let checkout;try{checkout=await checkoutRegistryStack(registryEntry.github)}catch(error){log.error(error instanceof Error?error.message:String(error));return null}try{const stackPath=checkout.path;let pkg;let meta;try{const pkgContent=await Bun.file(join(stackPath,"package.json")).text();pkg=JSON.parse(pkgContent);meta=pkg.stacks;if(!meta?.name||meta.name!==registryEntry.name){log.error(`Registry source "${registryEntry.github}" does not declare stacks.name as "${registryEntry.name}"`);return null}}catch(error){log.error(`Failed to read stack metadata: ${error}`);return null}const lock=await readStackLock(projectRoot);const packageName=pkg.name||registryEntry.package||name;if(lock.stacks[packageName]&&!force){log.warn(`Stack "${meta.name}" is already installed. Use --force to reinstall.`);return lock.stacks[packageName]}const dirsToScan=meta.directories??STACK_DIRS;if(dirsToScan.some((directory)=>!isSafeStackDirectory(directory))){log.error(`Stack "${meta.name}" declares an unsafe project directory`);return null}const allFiles=[];try{for(const dir of dirsToScan){const dirPath=join(stackPath,dir);if(fs.existsSync(dirPath))allFiles.push(...collectFiles(dirPath,stackPath))}}catch(error){log.error(error instanceof Error?error.message:String(error));return null}if(allFiles.length===0){log.warn(`Stack "${meta.name}" has no project files to install`);return null}if(verbose)log.info(`Pulled ${registryEntry.github} and found ${allFiles.length} project file(s)`);const copiedFiles=[];const skippedFiles=[];const checksums={};for(const relPath of allFiles){const src=join(stackPath,relPath);const dest=join(projectRoot,relPath);if(dryRun){if(fs.existsSync(dest)){log.info(`[dry-run] Would ${conflict}: ${relPath}`);if(conflict==="skip")skippedFiles.push(relPath);else copiedFiles.push(relPath)}else{log.info(`[dry-run] Would copy: ${relPath}`);copiedFiles.push(relPath)}continue}if(fs.existsSync(dest)){switch(conflict){case"skip":if(verbose)log.warn(`Skipping (file exists): ${relPath}`);skippedFiles.push(relPath);continue;case"backup":{const backupDir=stackBackupPath(projectRoot,meta.name);const backupDest=join(backupDir,relPath);const backupDestDir=dirname(backupDest);if(!fs.existsSync(backupDestDir))await createFolder(backupDestDir);copyFile(dest,backupDest);if(verbose)log.info(`Backed up: ${relPath}`);break}case"overwrite":if(verbose)log.warn(`Overwriting: ${relPath}`);break}}const destDir=dirname(dest);if(!fs.existsSync(destDir))await createFolder(destDir);copyFile(src,dest);copiedFiles.push(relPath);checksums[relPath]=fileChecksum(dest);if(verbose)log.info(`Copied: ${relPath}`)}const entry={packageName,name:meta.name,version:pkg.version||"0.0.0",installedAt:new Date().toISOString(),files:copiedFiles,checksums,source:registryEntry.github,skipped:skippedFiles,conflictStrategy:conflict};if(dryRun){log.info(`[dry-run] Would install ${copiedFiles.length} file(s), skip ${skippedFiles.length} file(s)`);return entry}lock.stacks[packageName]=entry;await writeStackLock(projectRoot,lock);log.success(`Installed stack "${meta.name}" from ${registryEntry.github} (${copiedFiles.length} file(s) copied, ${skippedFiles.length} skipped)`);return entry}finally{checkout.cleanup()}}export async function uninstallStack(options){const{name,force=false,verbose=false}=options;const projectRoot=resolveProjectRoot(options.project);log.info(`Uninstalling stack "${name}"...`);const lock=await readStackLock(projectRoot);let entryKey=null;let entry=null;for(const[key,value]of Object.entries(lock.stacks)){if(value.name===name||key===name){entryKey=key;entry=value;break}}if(!entry||!entryKey){log.error(`Stack "${name}" is not installed`);return false}let removedCount=0;const remainingFiles=[];for(const relPath of entry.files){const filePath=join(projectRoot,relPath);if(!fs.existsSync(filePath)){if(verbose)log.info(`Already removed: ${relPath}`);continue}if(!force){const installedChecksum=entry.checksums?.[relPath];if(!installedChecksum||fileChecksum(filePath)!==installedChecksum){log.warn(`Skipping modified file: ${relPath} (use --force to remove)`);remainingFiles.push(relPath);continue}}const removed=await deleteFile(filePath);if(removed.isErr){log.warn(`Could not remove ${relPath}: ${removed.error.message}`);remainingFiles.push(relPath);continue}removedCount++;if(verbose)log.info(`Removed: ${relPath}`)}if(remainingFiles.length>0){entry.files=remainingFiles;entry.checksums=Object.fromEntries(remainingFiles.map((file)=>[file,entry.checksums?.[file]]).filter((item)=>typeof item[1]==="string"));lock.stacks[entryKey]=entry;await writeStackLock(projectRoot,lock);log.warn(`Stack "${entry.name}" is still tracked because ${remainingFiles.length} modified or undeletable file(s) remain`);return false}const backupDir=stackBackupPath(projectRoot,entry.name);if(fs.existsSync(backupDir)&&doesFolderExist(backupDir)){const backupFiles=collectFiles(backupDir,backupDir);for(const relPath of backupFiles){const backupSrc=join(backupDir,relPath);const dest=join(projectRoot,relPath);const destDir=dirname(dest);if(!fs.existsSync(destDir))await createFolder(destDir);copyFile(backupSrc,dest);if(verbose)log.info(`Restored from backup: ${relPath}`)}fs.rmSync(backupDir,{recursive:true,force:true})}for(const dir of STACK_DIRS){const dirPath=join(projectRoot,dir);if(fs.existsSync(dirPath))await deleteEmptyFolders(dirPath)}delete lock.stacks[entryKey];await writeStackLock(projectRoot,lock);log.success(`Uninstalled stack "${entry.name}" (${removedCount} file(s) removed)`);return true}export async function listStacks(project){const entries=[];const projectRoot=resolveProjectRoot(project);const lock=await readStackLock(projectRoot);for(const candidate of registry){if(typeof candidate==="string")continue;const packageName=candidate.package||candidate.name;const lockEntry=lock.stacks[packageName];entries.push({name:candidate.name,packageName,version:lockEntry?.version||"latest",description:candidate.description,installed:Boolean(lockEntry),installedAt:lockEntry?.installedAt,fileCount:lockEntry?.files.length})}for(const[packageName,entry]of Object.entries(lock.stacks)){if(!entries.some((e)=>e.packageName===packageName)){entries.push({name:entry.name,packageName,version:entry.version,installed:true,installedAt:entry.installedAt,fileCount:entry.files.length})}}return entries}
@@ -1 +1 @@
1
- import{existsSync}from"node:fs";export function resolveStxSource(options){const exists=options.exists??existsSync,path=options.value?.trim();if(!path)return{kind:"installed"};return exists(path)?{kind:"override",path}:{kind:"missing",path}}
1
+ import{existsSync}from"node:fs";export function resolveStxSource(options){const exists=options.exists??existsSync;const path=options.value?.trim();if(!path)return{kind:"installed"};return exists(path)?{kind:"override",path}:{kind:"missing",path}}
@@ -1 +1 @@
1
- import{namedTestPaths,runTestSuites}from"./runner";await runTestSuites(["feature"],void 0,namedTestPaths());
1
+ import{namedTestPaths,runTestSuites}from"./runner";await runTestSuites(["feature"],undefined,namedTestPaths());
@@ -1 +1 @@
1
- import process from"node:process";import{existsSync,realpathSync,statSync}from"node:fs";import{join,relative,resolve}from"node:path";import{log}from"@stacksjs/cli";import{projectPath}from"@stacksjs/path";const testFilePattern="**/*.{test,spec}.{js,jsx,ts,tsx,mjs,mts,cjs,cts}";export function resolveTestSuiteFilters(project,suites){const visitedDirectories=new Set;return suites.flatMap((suite)=>{const suiteDirectory=join(project,"tests",suite);if(!existsSync(suiteDirectory))return[];const canonicalDirectory=realpathSync(suiteDirectory);if(visitedDirectories.has(canonicalDirectory))return[];visitedDirectories.add(canonicalDirectory);return[...new Bun.Glob(testFilePattern).scanSync({cwd:suiteDirectory,onlyFiles:!0})].map((file)=>suite?`./tests/${suite}/${file}`:`./tests/${file}`)})}export function namedTestPaths(){const raw=process.env.STACKS_TEST_PATHS;if(!raw)return[];try{const parsed=JSON.parse(raw);return Array.isArray(parsed)?parsed.filter((path)=>typeof path==="string"):[]}catch{return[]}}export function resolveNamedTestFiles(project,paths){const found=new Set;for(const named of paths){const absolute=resolve(project,named),rel=relative(project,absolute).split("\\").join("/");if(rel===".."||rel.startsWith("../"))throw Error(`Cannot run ${named}: it is outside the project at ${project}`);if(!existsSync(absolute))throw Error(`Cannot run ${named}: no such file or directory`);if(statSync(absolute).isDirectory()){const under=[...new Bun.Glob(testFilePattern).scanSync({cwd:absolute,onlyFiles:!0})].map((file)=>`./${rel?`${rel}/`:""}${file.split("\\").join("/")}`);if(under.length===0)throw Error(`Cannot run ${named}: it holds no test files`);for(const file of under)found.add(file);continue}if(!new Bun.Glob(testFilePattern).match(rel))throw Error(`Cannot run ${named}: a test file is named *.test.ts or *.spec.ts (or .js, .tsx, .mts, ...)`);found.add(`./${rel}`)}return[...found].sort()}export function withinSuite(files,suite,paths){const prefix=`./tests/${suite}/`,inSuite=files.filter((file)=>file.startsWith(prefix));if(inSuite.length===0)throw Error(`No ${suite} tests under ${paths.join(" ")}. Run \`buddy test ${paths.join(" ")}\` for the tests that are there.`);return inSuite}export async function runTestSuites(suites,timeout,paths){const project=projectPath();let filters;if(paths?.length)try{const named=resolveNamedTestFiles(project,paths),suite=suites.find(Boolean);filters=suite?withinSuite(named,suite,paths):named}catch(error){await log.error(error instanceof Error?error.message:String(error));process.exit(1)}else filters=resolveTestSuiteFilters(project,suites);if(filters.length===0){log.info("No matching tests found.");return}const args=["bun","test","--isolate"];if(timeout)args.push("--timeout",String(timeout));args.push(...filters);const exitCode=await Bun.spawn(args,{cwd:project,stdio:["inherit","inherit","inherit"]}).exited;if(exitCode!==0){await log.error("Tests failed");process.exit(exitCode??1)}}
1
+ import process from"node:process";import{existsSync,realpathSync,statSync}from"node:fs";import{join,relative,resolve}from"node:path";import{log}from"@stacksjs/cli";import{projectPath}from"@stacksjs/path";const testFilePattern="**/*.{test,spec}.{js,jsx,ts,tsx,mjs,mts,cjs,cts}";export function resolveTestSuiteFilters(project,suites){const visitedDirectories=new Set;return suites.flatMap((suite)=>{const suiteDirectory=join(project,"tests",suite);if(!existsSync(suiteDirectory))return[];const canonicalDirectory=realpathSync(suiteDirectory);if(visitedDirectories.has(canonicalDirectory))return[];visitedDirectories.add(canonicalDirectory);return[...new Bun.Glob(testFilePattern).scanSync({cwd:suiteDirectory,onlyFiles:true})].map((file)=>suite?`./tests/${suite}/${file}`:`./tests/${file}`)})}export function namedTestPaths(){const raw=process.env.STACKS_TEST_PATHS;if(!raw)return[];try{const parsed=JSON.parse(raw);return Array.isArray(parsed)?parsed.filter((path)=>typeof path==="string"):[]}catch{return[]}}export function resolveNamedTestFiles(project,paths){const found=new Set;for(const named of paths){const absolute=resolve(project,named);const rel=relative(project,absolute).split("\\").join("/");if(rel===".."||rel.startsWith("../"))throw new Error(`Cannot run ${named}: it is outside the project at ${project}`);if(!existsSync(absolute))throw new Error(`Cannot run ${named}: no such file or directory`);if(statSync(absolute).isDirectory()){const under=[...new Bun.Glob(testFilePattern).scanSync({cwd:absolute,onlyFiles:true})].map((file)=>`./${rel?`${rel}/`:""}${file.split("\\").join("/")}`);if(under.length===0)throw new Error(`Cannot run ${named}: it holds no test files`);for(const file of under)found.add(file);continue}if(!new Bun.Glob(testFilePattern).match(rel))throw new Error(`Cannot run ${named}: a test file is named *.test.ts or *.spec.ts (or .js, .tsx, .mts, ...)`);found.add(`./${rel}`)}return[...found].sort()}export function withinSuite(files,suite,paths){const prefix=`./tests/${suite}/`;const inSuite=files.filter((file)=>file.startsWith(prefix));if(inSuite.length===0)throw new Error(`No ${suite} tests under ${paths.join(" ")}. Run \`buddy test ${paths.join(" ")}\` for the tests that are there.`);return inSuite}export async function runTestSuites(suites,timeout,paths){const project=projectPath();let filters;if(paths?.length){try{const named=resolveNamedTestFiles(project,paths);const suite=suites.find(Boolean);filters=suite?withinSuite(named,suite,paths):named}catch(error){await log.error(error instanceof Error?error.message:String(error));process.exit(1)}}else{filters=resolveTestSuiteFilters(project,suites)}if(filters.length===0){log.info("No matching tests found.");return}const args=["bun","test","--isolate"];if(timeout)args.push("--timeout",String(timeout));args.push(...filters);const proc=Bun.spawn(args,{cwd:project,stdio:["inherit","inherit","inherit"]});const exitCode=await proc.exited;if(exitCode!==0){await log.error("Tests failed");process.exit(exitCode??1)}}
package/dist/test/unit.js CHANGED
@@ -1 +1 @@
1
- import{namedTestPaths,runTestSuites}from"./runner";await runTestSuites(["unit"],void 0,namedTestPaths());
1
+ import{namedTestPaths,runTestSuites}from"./runner";await runTestSuites(["unit"],undefined,namedTestPaths());
@@ -1 +1 @@
1
- import process from"node:process";import{runCommand}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{fs,storage}from"@stacksjs/storage";const source=path.buddyPath("dist/stacks"),destination=path.homeDir(".stacks/bin/stacks"),destinationDir=path.homeDir(".stacks/bin/");log.info("Upgrading `stacks`...");const result=await runCommand("bun compile.ts",{cwd:path.buddyPath()});if(result.isErr){await log.error("There was an error compiling the binary",result.error);process.exit(ExitCode.FatalError)}if(await storage.exists(source))try{log.info("Updating Binary...");log.info(`Source: ${source}`);log.info(`Destination: ${destination}`);await fs.promises.mkdir(destinationDir,{recursive:!0});await fs.promises.copyFile(source,destination);await fs.promises.unlink(source);log.success("Binary Latest Version Is Used")}catch(err){await log.error(err);process.exit(ExitCode.FatalError)}else{await log.error(`Binary source not found: ${source}`);process.exit(ExitCode.FatalError)}
1
+ import process from"node:process";import{runCommand}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{path}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{fs,storage}from"@stacksjs/storage";const source=path.buddyPath("dist/stacks");const destination=path.homeDir(".stacks/bin/stacks");const destinationDir=path.homeDir(".stacks/bin/");log.info("Upgrading `stacks`...");const result=await runCommand("bun compile.ts",{cwd:path.buddyPath()});if(result.isErr){await log.error("There was an error compiling the binary",result.error);process.exit(ExitCode.FatalError)}if(await storage.exists(source)){try{log.info("Updating Binary...");log.info(`Source: ${source}`);log.info(`Destination: ${destination}`);await fs.promises.mkdir(destinationDir,{recursive:true});await fs.promises.copyFile(source,destination);await fs.promises.unlink(source);log.success("Binary Latest Version Is Used")}catch(err){await log.error(err);process.exit(ExitCode.FatalError)}}else{await log.error(`Binary source not found: ${source}`);process.exit(ExitCode.FatalError)}
@@ -1,3 +1,9 @@
1
+ /** Refresh agent entrypoints after the upgraded defaults are available. */
2
+ export declare function runPostSyncAiRefresh(options: {
3
+ cli: string[]
4
+ projectRoot: string
5
+ spawn: PostSyncSpawn
6
+ }): Promise<void>;
1
7
  /**
2
8
  * A `pantry.lock` is the marker: it only exists once pantry owns the graph.
3
9
  *
@@ -1 +1 @@
1
- export function detectDependencyInstaller(hasPantryLock){return hasPantryLock?"pantry":"bun"}export function resolveDependencyRefreshCommand(options){return[options.installer==="pantry"?options.pantryExecutable:options.bunExecutable,"install","--force"]}export function resolvePantryExecutable(candidates,exists){for(const candidate of candidates)if(candidate&&exists(candidate))return candidate;return"pantry"}export function shouldRunPostSyncHooks(changeCount,alreadyRestarted){return changeCount>0||alreadyRestarted}export function shouldRefreshPostSyncDependencies(corePackageChanged,alreadyRestarted){return corePackageChanged||alreadyRestarted}export async function runPostSyncDependencyRefresh(options){const code=await options.spawn({cmd:options.cmd,cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"}).exited;if(code!==0)throw Error(`Post-upgrade dependency refresh exited with code ${code}.`)}export async function runPostSyncMigration(options){const code=await options.spawn({cmd:[options.bunExecutable,options.migrateScript,"migrate","--force"],cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"}).exited;if(code!==0)throw Error(`Post-upgrade migration exited with code ${code}.`)}export async function runPostSyncDatabaseTypesRefresh(options){if(!options.exists(`${options.projectRoot}/database/types.d.ts`))return!1;const code=await options.spawn({cmd:options.cmd,cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"}).exited;if(code!==0)throw Error(`\`buddy generate:db-types\` exited with code ${code}.`);return!0}
1
+ import{detectProjectAiProviders}from"./package-project";export async function runPostSyncAiRefresh(options){for(const provider of detectProjectAiProviders(options.projectRoot)){const child=options.spawn({cmd:[...options.cli,"setup:ai",provider,"--force"],cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"});const code=await child.exited;if(code!==0)throw new Error(`AI setup refresh failed for ${provider} (exit ${code}). Re-run \`buddy setup:ai ${provider} --force\`.`)}}export function detectDependencyInstaller(hasPantryLock){return hasPantryLock?"pantry":"bun"}export function resolveDependencyRefreshCommand(options){const executable=options.installer==="pantry"?options.pantryExecutable:options.bunExecutable;return[executable,"install","--force"]}export function resolvePantryExecutable(candidates,exists){for(const candidate of candidates){if(candidate&&exists(candidate))return candidate}return"pantry"}export function shouldRunPostSyncHooks(changeCount,alreadyRestarted){return changeCount>0||alreadyRestarted}export function shouldRefreshPostSyncDependencies(corePackageChanged,alreadyRestarted){return corePackageChanged||alreadyRestarted}export async function runPostSyncDependencyRefresh(options){const process=options.spawn({cmd:options.cmd,cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"});const code=await process.exited;if(code!==0)throw new Error(`Post-upgrade dependency refresh exited with code ${code}.`)}export async function runPostSyncMigration(options){const process=options.spawn({cmd:[options.bunExecutable,options.migrateScript,"migrate","--force"],cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"});const code=await process.exited;if(code!==0)throw new Error(`Post-upgrade migration exited with code ${code}.`)}export async function runPostSyncDatabaseTypesRefresh(options){if(!options.exists(`${options.projectRoot}/database/types.d.ts`))return false;const process=options.spawn({cmd:options.cmd,cwd:options.projectRoot,stdin:"ignore",stdout:"inherit",stderr:"inherit"});const code=await process.exited;if(code!==0)throw new Error(`\`buddy generate:db-types\` exited with code ${code}.`);return true}
@@ -1,2 +1,2 @@
1
- import{existsSync,readdirSync,readFileSync,statSync,writeFileSync}from"node:fs";import{homedir}from"node:os";import{join,resolve}from"node:path";import process from"node:process";export function resolveUpgradeContext(options,currentChannel,latestStableRef){const targetVersion=options.version;if(targetVersion)return{channel:"stable",ref:targetVersion.startsWith("v")?targetVersion:`v${targetVersion}`,targetVersion};if(options.canary)return{channel:"canary",ref:"main"};if(options.stable)return{channel:"stable",ref:latestStableRef};if(currentChannel==="canary")return{channel:"canary",ref:"main"};return{channel:"stable",ref:latestStableRef}}function compareVersionParts(a,b){return a[0]-b[0]||a[1]-b[1]||a[2]-b[2]}export function pickLatestStableTag(tags){const re=/^v(\d+)\.(\d+)\.(\d+)$/;let best=null;for(const tag of tags){const m=re.exec(tag.trim());if(!m)continue;const parts=[Number(m[1]),Number(m[2]),Number(m[3])];if(!best||compareVersionParts(parts,best.parts)>0)best={tag:tag.trim(),parts}}return best?.tag??null}export async function resolveLatestStableTag(){try{const proc=Bun.spawn({cmd:["git","ls-remote","--tags","--refs","https://github.com/stacksjs/stacks.git","v*"],stdout:"pipe",stderr:"pipe"}),out=await new Response(proc.stdout).text();if(await proc.exited!==0)return null;const tags=out.split(`
2
- `).map((line)=>line.split("\t")[1]?.replace("refs/tags/","")).filter((t)=>!!t);return pickLatestStableTag(tags)}catch{return null}}export function buildTemplateString(ref,subPath="storage/framework/core"){return`github:stacksjs/stacks/${subPath}#${ref}`}export function readVersion(pkgPath){try{if(existsSync(pkgPath))return JSON.parse(readFileSync(pkgPath,"utf-8")).version||null}catch{}return null}export function readChannel(channelFilePath){try{if(existsSync(channelFilePath)){if(readFileSync(channelFilePath,"utf-8").trim()==="canary")return"canary"}}catch{}return"stable"}export function writeChannel(channelFilePath,ch){try{writeFileSync(channelFilePath,ch,"utf-8")}catch{}}export function readSyncedVersion(versionFilePath){try{if(existsSync(versionFilePath)){const content=readFileSync(versionFilePath,"utf-8").trim(),[ch,sha]=content.split(/\s+/);if((ch==="stable"||ch==="canary")&&sha&&/^[0-9a-f]{40}$/i.test(sha))return{channel:ch,sha:sha.toLowerCase()}}}catch{}return null}export function writeSyncedVersion(versionFilePath,ch,sha){try{writeFileSync(versionFilePath,`${ch} ${sha}`,"utf-8")}catch{}}export function shouldCheckDirtyManagedPaths(args){return!args.force&&!args.alreadyRestarted}export function shouldShortCircuit(args){const{force,targetVersion,remoteSha,synced,channel}=args;if(force||targetVersion)return!1;if(!remoteSha||!synced)return!1;return synced.channel===channel&&synced.sha===remoteSha.toLowerCase()}export function resolveUpgradeMessage(ctx,currentChannel,isStableFlag){if(ctx.targetVersion)return`Installing Stacks v${ctx.targetVersion.replace(/^v/,"")}...`;if(ctx.channel==="canary")return"Upgrading to the latest canary build...";if(isStableFlag&&currentChannel==="canary")return"Switching back to the latest stable release...";return"Upgrading to the latest version..."}export function resolveSuccessMessage(ctx,currentVersion,newVersion,currentChannel,force){if(ctx.targetVersion){const pinned=ctx.targetVersion.replace(/^v/,"");if(currentVersion===pinned&&!force)return`Stacks is already at v${pinned}`;if(currentVersion)return`Installed Stacks v${pinned} (was v${currentVersion})`;return`Installed Stacks v${pinned}`}if(currentVersion&&newVersion&&currentVersion===newVersion&&!force){if(ctx.channel==="canary")return`Stacks is already up to date (canary ${currentVersion})`;return`Stacks is already up to date (v${currentVersion})`}if(currentVersion&&newVersion){const from=currentChannel==="canary"?`canary ${currentVersion}`:`v${currentVersion}`,to=ctx.channel==="canary"?`canary ${newVersion}`:`v${newVersion}`;return`Upgraded Stacks from ${from} to ${to}`}if(newVersion)return`Upgraded Stacks to ${ctx.channel==="canary"?`canary ${newVersion}`:`v${newVersion}`}`;return`Upgraded Stacks to ${ctx.ref} (latest)`}export const MANAGED_PATHS=[{localPath:"storage/framework/core",subPath:"storage/framework/core",label:"core",skip:["node_modules","dist","bun.lock",".DS_Store"]},{localPath:"storage/framework/defaults",subPath:"storage/framework/defaults",label:"defaults",skip:["node_modules","dist",".DS_Store",".discovered-models.json"]},{localPath:"storage/framework/types",subPath:"storage/framework/types",label:"types",skip:["server-auto-imports.d.ts","browser-auto-imports.d.ts",".DS_Store"]},{localPath:"buddy",subPath:"buddy",label:"buddy",isFile:!0,executable:!0},{localPath:"bootstrap",subPath:"bootstrap",label:"bootstrap",isFile:!0,executable:!0}];export function detectLocalStacks(projectRoot){const candidates=[process.env.STACKS_LOCAL_PATH,resolve(projectRoot,"..","stacks"),resolve(projectRoot,"..","..","stacks"),resolve(homedir(),"Code","stacks"),resolve(homedir(),"code","stacks"),resolve(homedir(),"projects","stacks"),resolve(homedir(),"src","stacks")];for(const candidate of candidates){if(!candidate)continue;const marker=join(candidate,"storage","framework","core","buddy","package.json");try{if(existsSync(marker)&&resolve(candidate)!==resolve(projectRoot))return resolve(candidate)}catch{}}return null}export function shouldAutoDetectLocalStacks(options){return!options.from&&!options.version}export async function snapshotTree(root,skip=[]){const out=new Map;if(!existsSync(root))return out;const skipSet=new Set(skip),stack=[{abs:root,rel:""}],hashJobs=[];while(stack.length>0){const{abs,rel}=stack.pop();let entries;try{entries=readdirSync(abs)}catch{continue}for(const name of entries){if(skipSet.has(name))continue;const childAbs=join(abs,name),childRel=rel?`${rel}/${name}`:name;let info;try{info=statSync(childAbs)}catch{continue}if(info.isDirectory())stack.push({abs:childAbs,rel:childRel});else if(info.isFile()){const size=info.size;hashJobs.push((async()=>{const hash=await hashFile(childAbs);out.set(childRel,{size,hash})})())}}}await Promise.all(hashJobs);return out}export function diffSnapshots(before,after){let added=0,changed=0,unchanged=0;for(const[rel,info]of after){const prev=before.get(rel);if(!prev)added++;else if(prev.size!==info.size||prev.hash!==info.hash)changed++;else unchanged++}let removed=0;for(const rel of before.keys())if(!after.has(rel))removed++;return{added,changed,removed,unchanged}}export function diffSnapshotsDetailed(before,after){const addedFiles=[],changedFiles=[],removedFiles=[];let unchanged=0;for(const[rel,info]of after){const prev=before.get(rel);if(!prev)addedFiles.push(rel);else if(prev.size!==info.size||prev.hash!==info.hash)changedFiles.push(rel);else unchanged++}for(const rel of before.keys())if(!after.has(rel))removedFiles.push(rel);addedFiles.sort();changedFiles.sort();removedFiles.sort();return{added:addedFiles.length,changed:changedFiles.length,removed:removedFiles.length,unchanged,addedFiles,changedFiles,removedFiles}}async function hashFile(absPath){try{const buf=await Bun.file(absPath).arrayBuffer();return Bun.hash(buf)}catch{return 0n}}
1
+ import{existsSync,readdirSync,readFileSync,statSync,writeFileSync}from"node:fs";import{homedir}from"node:os";import{join,resolve}from"node:path";import process from"node:process";export function resolveUpgradeContext(options,currentChannel,latestStableRef){const targetVersion=options.version;if(targetVersion){const ref=targetVersion.startsWith("v")?targetVersion:`v${targetVersion}`;return{channel:"stable",ref,targetVersion}}if(options.canary){return{channel:"canary",ref:"main"}}if(options.stable){return{channel:"stable",ref:latestStableRef}}if(currentChannel==="canary"){return{channel:"canary",ref:"main"}}return{channel:"stable",ref:latestStableRef}}function compareVersionParts(a,b){return a[0]-b[0]||a[1]-b[1]||a[2]-b[2]}export function pickLatestStableTag(tags){const re=/^v(\d+)\.(\d+)\.(\d+)$/;let best=null;for(const tag of tags){const m=re.exec(tag.trim());if(!m)continue;const parts=[Number(m[1]),Number(m[2]),Number(m[3])];if(!best||compareVersionParts(parts,best.parts)>0)best={tag:tag.trim(),parts}}return best?.tag??null}export async function resolveLatestStableTag(){try{const proc=Bun.spawn({cmd:["git","ls-remote","--tags","--refs","https://github.com/stacksjs/stacks.git","v*"],stdout:"pipe",stderr:"pipe"});const out=await new Response(proc.stdout).text();if(await proc.exited!==0)return null;const tags=out.split(`
2
+ `).map((line)=>line.split("\t")[1]?.replace("refs/tags/","")).filter((t)=>!!t);return pickLatestStableTag(tags)}catch{return null}}export function buildTemplateString(ref,subPath="storage/framework/core"){return`github:stacksjs/stacks/${subPath}#${ref}`}export function readVersion(pkgPath){try{if(existsSync(pkgPath)){const pkg=JSON.parse(readFileSync(pkgPath,"utf-8"));return pkg.version||null}}catch{}return null}export function readChannel(channelFilePath){try{if(existsSync(channelFilePath)){const content=readFileSync(channelFilePath,"utf-8").trim();if(content==="canary")return"canary"}}catch{}return"stable"}export function writeChannel(channelFilePath,ch){try{writeFileSync(channelFilePath,ch,"utf-8")}catch{}}export function readSyncedVersion(versionFilePath){try{if(existsSync(versionFilePath)){const content=readFileSync(versionFilePath,"utf-8").trim();const[ch,sha]=content.split(/\s+/);if((ch==="stable"||ch==="canary")&&sha&&/^[0-9a-f]{40}$/i.test(sha))return{channel:ch,sha:sha.toLowerCase()}}}catch{}return null}export function writeSyncedVersion(versionFilePath,ch,sha){try{writeFileSync(versionFilePath,`${ch} ${sha}`,"utf-8")}catch{}}export function shouldCheckDirtyManagedPaths(args){return!args.force&&!args.alreadyRestarted}export function shouldShortCircuit(args){const{force,targetVersion,remoteSha,synced,channel}=args;if(force||targetVersion)return false;if(!remoteSha||!synced)return false;return synced.channel===channel&&synced.sha===remoteSha.toLowerCase()}export function resolveUpgradeMessage(ctx,currentChannel,isStableFlag){if(ctx.targetVersion){return`Installing Stacks v${ctx.targetVersion.replace(/^v/,"")}...`}if(ctx.channel==="canary"){return"Upgrading to the latest canary build..."}if(isStableFlag&&currentChannel==="canary"){return"Switching back to the latest stable release..."}return"Upgrading to the latest version..."}export function resolveSuccessMessage(ctx,currentVersion,newVersion,currentChannel,force){if(ctx.targetVersion){const pinned=ctx.targetVersion.replace(/^v/,"");if(currentVersion===pinned&&!force){return`Stacks is already at v${pinned}`}if(currentVersion){return`Installed Stacks v${pinned} (was v${currentVersion})`}return`Installed Stacks v${pinned}`}if(currentVersion&&newVersion&&currentVersion===newVersion&&!force){if(ctx.channel==="canary"){return`Stacks is already up to date (canary ${currentVersion})`}return`Stacks is already up to date (v${currentVersion})`}if(currentVersion&&newVersion){const from=currentChannel==="canary"?`canary ${currentVersion}`:`v${currentVersion}`;const to=ctx.channel==="canary"?`canary ${newVersion}`:`v${newVersion}`;return`Upgraded Stacks from ${from} to ${to}`}if(newVersion){const label=ctx.channel==="canary"?`canary ${newVersion}`:`v${newVersion}`;return`Upgraded Stacks to ${label}`}return`Upgraded Stacks to ${ctx.ref} (latest)`}export const MANAGED_PATHS=[{localPath:"storage/framework/core",subPath:"storage/framework/core",label:"core",skip:["node_modules","dist","bun.lock",".DS_Store"]},{localPath:"storage/framework/defaults",subPath:"storage/framework/defaults",label:"defaults",skip:["node_modules","dist",".DS_Store",".discovered-models.json"]},{localPath:"storage/framework/types",subPath:"storage/framework/types",label:"types",skip:["server-auto-imports.d.ts","browser-auto-imports.d.ts",".DS_Store"]},{localPath:"buddy",subPath:"buddy",label:"buddy",isFile:true,executable:true},{localPath:"bootstrap",subPath:"bootstrap",label:"bootstrap",isFile:true,executable:true}];export function detectLocalStacks(projectRoot){const candidates=[process.env.STACKS_LOCAL_PATH,resolve(projectRoot,"..","stacks"),resolve(projectRoot,"..","..","stacks"),resolve(homedir(),"Code","stacks"),resolve(homedir(),"code","stacks"),resolve(homedir(),"projects","stacks"),resolve(homedir(),"src","stacks")];for(const candidate of candidates){if(!candidate)continue;const marker=join(candidate,"storage","framework","core","buddy","package.json");try{if(existsSync(marker)&&resolve(candidate)!==resolve(projectRoot))return resolve(candidate)}catch{}}return null}export function shouldAutoDetectLocalStacks(options){return!options.from&&!options.version}export async function snapshotTree(root,skip=[]){const out=new Map;if(!existsSync(root))return out;const skipSet=new Set(skip);const stack=[{abs:root,rel:""}];const hashJobs=[];while(stack.length>0){const{abs,rel}=stack.pop();let entries;try{entries=readdirSync(abs)}catch{continue}for(const name of entries){if(skipSet.has(name))continue;const childAbs=join(abs,name);const childRel=rel?`${rel}/${name}`:name;let info;try{info=statSync(childAbs)}catch{continue}if(info.isDirectory()){stack.push({abs:childAbs,rel:childRel})}else if(info.isFile()){const size=info.size;hashJobs.push((async()=>{const hash=await hashFile(childAbs);out.set(childRel,{size,hash})})())}}}await Promise.all(hashJobs);return out}export function diffSnapshots(before,after){let added=0;let changed=0;let unchanged=0;for(const[rel,info]of after){const prev=before.get(rel);if(!prev)added++;else if(prev.size!==info.size||prev.hash!==info.hash)changed++;else unchanged++}let removed=0;for(const rel of before.keys()){if(!after.has(rel))removed++}return{added,changed,removed,unchanged}}export function diffSnapshotsDetailed(before,after){const addedFiles=[];const changedFiles=[];const removedFiles=[];let unchanged=0;for(const[rel,info]of after){const prev=before.get(rel);if(!prev)addedFiles.push(rel);else if(prev.size!==info.size||prev.hash!==info.hash)changedFiles.push(rel);else unchanged++}for(const rel of before.keys()){if(!after.has(rel))removedFiles.push(rel)}addedFiles.sort();changedFiles.sort();removedFiles.sort();return{added:addedFiles.length,changed:changedFiles.length,removed:removedFiles.length,unchanged,addedFiles,changedFiles,removedFiles}}async function hashFile(absPath){try{const buf=await Bun.file(absPath).arrayBuffer();return Bun.hash(buf)}catch{return 0n}}
@@ -1,13 +1,13 @@
1
- import{chmodSync,copyFileSync,cpSync,existsSync,mkdirSync,mkdtempSync,readFileSync,rmSync,statSync,writeFileSync}from"node:fs";import{tmpdir}from"node:os";import{dirname,join}from"node:path";import process from"node:process";import{parseOptions}from"@stacksjs/cli";import{downloadTemplate}from"@stacksjs/gitit";import{path as p}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{buildTemplateString,detectLocalStacks,diffSnapshots,diffSnapshotsDetailed,MANAGED_PATHS,readChannel,readSyncedVersion,readVersion,resolveLatestStableTag,resolveSuccessMessage,resolveUpgradeContext,resolveUpgradeMessage,shouldAutoDetectLocalStacks,shouldCheckDirtyManagedPaths,shouldShortCircuit,snapshotTree,writeChannel,writeSyncedVersion}from"./framework-utils";import{detectDependencyInstaller,resolveDependencyRefreshCommand,resolvePantryExecutable,runPostSyncDatabaseTypesRefresh,runPostSyncDependencyRefresh,runPostSyncMigration,shouldRefreshPostSyncDependencies,shouldRunPostSyncHooks}from"./framework-hooks";import{describeDanglingRouteActions,findDanglingRouteActions,pruneRetiredScaffoldRoutes}from"./route-actions";const options=parseOptions(),projectRoot=p.projectPath();if(!existsSync(p.projectPath("storage/framework/core"))){const{upgradeStacksPackages}=await import("./packages");await upgradeStacksPackages(projectRoot,{version:options.version,canary:options.canary,stable:options.stable,force:options.force,dryRun:options.dryRun,noPostinstall:options.noPostinstall??options.postinstall===!1,allowDowngrade:options.allowDowngrade})}const channelFile=join(projectRoot,".stacks-channel"),versionFile=join(projectRoot,".stacks-version"),currentChannel=readChannel(channelFile),corePkgPath=p.projectPath("storage/framework/core/buddy/package.json"),currentVersion=readVersion(corePkgPath),explicitLocal=options.from?p.projectPath(options.from):null,detectedLocal=explicitLocal??(shouldAutoDetectLocalStacks(options)?detectLocalStacks(projectRoot):null),usingLocal=!!detectedLocal,willResolveStable=!usingLocal&&!options.version&&!options.canary&&(!!options.stable||currentChannel!=="canary");let latestStableRef=currentVersion?`v${currentVersion}`:"main";if(willResolveStable)latestStableRef=await resolveLatestStableTag()??latestStableRef;const ctx=resolveUpgradeContext(options,currentChannel,latestStableRef);console.log(resolveUpgradeMessage(ctx,currentChannel,!!options.stable));console.log(usingLocal?` source: local checkout at ${detectedLocal}`:` source: github:stacksjs/stacks#${ctx.ref}`);if(options.dryRun){await runDryRunPreview();process.exit(ExitCode.Success)}const alreadyRestarted=process.argv.includes("--__restarted");if(shouldCheckDirtyManagedPaths({force:!!options.force,alreadyRestarted})){const dirty=await detectDirtyManagedPaths(projectRoot);if(dirty.length>0){console.warn(`
2
- \u26A0 The following framework-managed paths have uncommitted changes:`);for(const path of dirty)console.warn(` - ${path}`);console.warn(`
1
+ import{chmodSync,copyFileSync,cpSync,existsSync,mkdirSync,mkdtempSync,readFileSync,rmSync,statSync,writeFileSync}from"node:fs";import{tmpdir}from"node:os";import{dirname,join}from"node:path";import process from"node:process";import{parseOptions}from"@stacksjs/cli";import{downloadTemplate}from"@stacksjs/gitit";import{path as p}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{buildTemplateString,detectLocalStacks,diffSnapshots,diffSnapshotsDetailed,MANAGED_PATHS,readChannel,readSyncedVersion,readVersion,resolveLatestStableTag,resolveSuccessMessage,resolveUpgradeContext,resolveUpgradeMessage,shouldAutoDetectLocalStacks,shouldCheckDirtyManagedPaths,shouldShortCircuit,snapshotTree,writeChannel,writeSyncedVersion}from"./framework-utils";import{detectDependencyInstaller,resolveDependencyRefreshCommand,resolvePantryExecutable,runPostSyncAiRefresh,runPostSyncDatabaseTypesRefresh,runPostSyncDependencyRefresh,runPostSyncMigration,shouldRefreshPostSyncDependencies,shouldRunPostSyncHooks}from"./framework-hooks";import{detectProjectAiProviders}from"./package-project";import{describeDanglingRouteActions,findDanglingRouteActions,pruneRetiredScaffoldRoutes}from"./route-actions";const options=parseOptions();const projectRoot=p.projectPath();if(!existsSync(p.projectPath("storage/framework/core"))){const{upgradeStacksPackages}=await import("./packages");await upgradeStacksPackages(projectRoot,{version:options.version,canary:options.canary,stable:options.stable,force:options.force,dryRun:options.dryRun,noPostinstall:options.noPostinstall??options.postinstall===false,allowDowngrade:options.allowDowngrade})}const channelFile=join(projectRoot,".stacks-channel");const versionFile=join(projectRoot,".stacks-version");const currentChannel=readChannel(channelFile);const corePkgPath=p.projectPath("storage/framework/core/buddy/package.json");const currentVersion=readVersion(corePkgPath);const explicitLocal=options.from?p.projectPath(options.from):null;const detectedLocal=explicitLocal??(shouldAutoDetectLocalStacks(options)?detectLocalStacks(projectRoot):null);const usingLocal=!!detectedLocal;const willResolveStable=!usingLocal&&!options.version&&!options.canary&&(!!options.stable||currentChannel!=="canary");let latestStableRef=currentVersion?`v${currentVersion}`:"main";if(willResolveStable){latestStableRef=await resolveLatestStableTag()??latestStableRef}const ctx=resolveUpgradeContext(options,currentChannel,latestStableRef);console.log(resolveUpgradeMessage(ctx,currentChannel,!!options.stable));console.log(usingLocal?` source: local checkout at ${detectedLocal}`:` source: github:stacksjs/stacks#${ctx.ref}`);if(options.dryRun){await runDryRunPreview();process.exit(ExitCode.Success)}const alreadyRestarted=process.argv.includes("--__restarted");if(shouldCheckDirtyManagedPaths({force:!!options.force,alreadyRestarted})){const dirty=await detectDirtyManagedPaths(projectRoot);if(dirty.length>0){console.warn(`
2
+ ⚠ The following framework-managed paths have uncommitted changes:`);for(const path of dirty)console.warn(` - ${path}`);console.warn(`
3
3
  Aborting to avoid clobbering your edits.`);console.warn(` Re-run with --force to overwrite, or commit / stash the changes first.
4
- `);process.exit(ExitCode.FatalError)}}let resolvedRemoteSha=null;if(!options.force&&!ctx.targetVersion){resolvedRemoteSha=await getRemoteSha(ctx,usingLocal,detectedLocal);const synced=readSyncedVersion(versionFile);if(shouldShortCircuit({force:!!options.force,targetVersion:ctx.targetVersion,remoteSha:resolvedRemoteSha,synced,channel:ctx.channel})){console.log(`\u2714 Already on the latest ${ctx.channel} (${resolvedRemoteSha.slice(0,7)}).`);process.exit(ExitCode.Success)}}const ownPath=p.frameworkPath("core/actions/src/upgrade/framework.ts"),ownHashBefore=await hashFileOrZero(ownPath),aggregate={added:0,changed:0,removed:0,unchanged:0},perPath=[];try{for(const managed of MANAGED_PATHS){const localTarget=join(projectRoot,managed.localPath),before=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip);if(usingLocal&&detectedLocal)await syncFromLocal(detectedLocal,managed,localTarget);else{if(managed.isFile)continue;await syncFromGitHub(ctx.ref,managed,localTarget,!!options.force)}const after=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip),summary=diffSnapshots(before,after);aggregate.added+=summary.added;aggregate.changed+=summary.changed;aggregate.removed+=summary.removed;aggregate.unchanged+=summary.unchanged;perPath.push({managed,summary})}if(!usingLocal)await syncRootFilesFromGitHub(ctx.ref)}catch(err){console.error("\u2718 Failed to upgrade Stacks framework:",err?.message||err);process.exit(ExitCode.FatalError)}const newVersion=readVersion(corePkgPath),ownHashAfter=await hashFileOrZero(ownPath);if(ownHashBefore!==0n&&ownHashAfter!==0n&&ownHashBefore!==ownHashAfter&&!alreadyRestarted){console.log(`Upgrade pulled a newer version of the upgrade action - re-running once to pick up new sync paths and hooks.
5
- `);const args=process.argv.slice(2).filter((a)=>a!=="--__restarted"),code=await Bun.spawn({cmd:[process.argv[0]||"bun",ownPath,...args,"--__restarted"],cwd:projectRoot,stdout:"inherit",stderr:"inherit"}).exited;process.exit(code??0)}if(!ctx.targetVersion){writeChannel(channelFile,ctx.channel);if(!resolvedRemoteSha)resolvedRemoteSha=await getRemoteSha(ctx,usingLocal,detectedLocal);if(resolvedRemoteSha)writeSyncedVersion(versionFile,ctx.channel,resolvedRemoteSha)}console.log(`\u2714 ${resolveSuccessMessage(ctx,currentVersion,newVersion,currentChannel,!!options.force)}`);console.log("Sync summary:");for(const{managed,summary}of perPath)if(managed.isFile){const moved=summary.added+summary.changed>0;console.log(` ${managed.label.padEnd(10)} ${moved?"updated":"unchanged"}`)}else if(summary.added+summary.changed+summary.removed===0)console.log(` ${managed.label.padEnd(10)} unchanged (${summary.unchanged} files)`);else console.log(` ${managed.label.padEnd(10)} +${summary.added} ~${summary.changed} -${summary.removed} (${summary.unchanged} unchanged)`);{const pruned=pruneRetiredScaffoldRoutes(projectRoot);for(const route of pruned)console.log(`Removed ${route.file}:${route.line}, the scaffold route to ${route.action}: removed in ${route.removedIn}, ${route.reason}`);const dangling=findDanglingRouteActions(projectRoot);if(dangling.length>0){console.warn(`${dangling.length} route(s) name an action this version does not ship. Point them at an action that exists, or delete them:`);for(const line of describeDanglingRouteActions(dangling).split(`
6
- `))console.warn(` ${line}`)}}const runHooks=!options.noPostinstall&&options.postinstall!==!1;if(runHooks)try{await runPostSyncHooks({aggregate,perPath,projectRoot,alreadyRestarted})}catch(err){console.error(`Post-sync hooks failed: ${err?.message||err}`);process.exit(ExitCode.FatalError)}if(ctx.channel==="canary"&&!ctx.targetVersion)console.warn("\u26A0 Canary builds may contain bugs or breaking changes. Not recommended for production.");process.exit(ExitCode.Success);async function runDryRunPreview(){console.log(`
4
+ `);process.exit(ExitCode.FatalError)}}let resolvedRemoteSha=null;if(!options.force&&!ctx.targetVersion){resolvedRemoteSha=await getRemoteSha(ctx,usingLocal,detectedLocal);const synced=readSyncedVersion(versionFile);if(shouldShortCircuit({force:!!options.force,targetVersion:ctx.targetVersion,remoteSha:resolvedRemoteSha,synced,channel:ctx.channel})){console.log(`✔ Already on the latest ${ctx.channel} (${resolvedRemoteSha.slice(0,7)}).`);process.exit(ExitCode.Success)}}const ownPath=p.frameworkPath("core/actions/src/upgrade/framework.ts");const ownHashBefore=await hashFileOrZero(ownPath);const aggregate={added:0,changed:0,removed:0,unchanged:0};const perPath=[];try{for(const managed of MANAGED_PATHS){const localTarget=join(projectRoot,managed.localPath);const before=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip);if(usingLocal&&detectedLocal){await syncFromLocal(detectedLocal,managed,localTarget)}else{if(managed.isFile)continue;await syncFromGitHub(ctx.ref,managed,localTarget,!!options.force)}const after=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip);const summary=diffSnapshots(before,after);aggregate.added+=summary.added;aggregate.changed+=summary.changed;aggregate.removed+=summary.removed;aggregate.unchanged+=summary.unchanged;perPath.push({managed,summary})}if(!usingLocal){await syncRootFilesFromGitHub(ctx.ref)}}catch(err){console.error("✘ Failed to upgrade Stacks framework:",err?.message||err);process.exit(ExitCode.FatalError)}const newVersion=readVersion(corePkgPath);const ownHashAfter=await hashFileOrZero(ownPath);if(ownHashBefore!==0n&&ownHashAfter!==0n&&ownHashBefore!==ownHashAfter&&!alreadyRestarted){console.log(`Upgrade pulled a newer version of the upgrade action - re-running once to pick up new sync paths and hooks.
5
+ `);const args=process.argv.slice(2).filter((a)=>a!=="--__restarted");const proc=Bun.spawn({cmd:[process.argv[0]||"bun",ownPath,...args,"--__restarted"],cwd:projectRoot,stdout:"inherit",stderr:"inherit"});const code=await proc.exited;process.exit(code??0)}console.log("Sync summary:");for(const{managed,summary}of perPath){if(managed.isFile){const moved=summary.added+summary.changed>0;console.log(` ${managed.label.padEnd(10)} ${moved?"updated":"unchanged"}`)}else{const noop=summary.added+summary.changed+summary.removed===0;if(noop){console.log(` ${managed.label.padEnd(10)} unchanged (${summary.unchanged} files)`)}else{console.log(` ${managed.label.padEnd(10)} +${summary.added} ~${summary.changed} -${summary.removed} (${summary.unchanged} unchanged)`)}}}{const pruned=pruneRetiredScaffoldRoutes(projectRoot);for(const route of pruned)console.log(`Removed ${route.file}:${route.line}, the scaffold route to ${route.action}: removed in ${route.removedIn}, ${route.reason}`);const dangling=findDanglingRouteActions(projectRoot);if(dangling.length>0){console.warn(`${dangling.length} route(s) name an action this version does not ship. Point them at an action that exists, or delete them:`);for(const line of describeDanglingRouteActions(dangling).split(`
6
+ `))console.warn(` ${line}`)}}const runHooks=!options.noPostinstall&&options.postinstall!==false;if(runHooks){try{await runPostSyncHooks({aggregate,perPath,projectRoot,alreadyRestarted:alreadyRestarted||!!options.force})}catch(err){console.error(`Post-sync hooks failed: ${err?.message||err}`);process.exit(ExitCode.FatalError)}}if(!ctx.targetVersion){writeChannel(channelFile,ctx.channel);if(!resolvedRemoteSha)resolvedRemoteSha=await getRemoteSha(ctx,usingLocal,detectedLocal);if(resolvedRemoteSha)writeSyncedVersion(versionFile,ctx.channel,resolvedRemoteSha)}console.log(`✔ ${resolveSuccessMessage(ctx,currentVersion,newVersion,currentChannel,!!options.force)}`);if(ctx.channel==="canary"&&!ctx.targetVersion){console.warn("⚠ Canary builds may contain bugs or breaking changes. Not recommended for production.")}process.exit(ExitCode.Success);async function runDryRunPreview(){console.log(`
7
7
  DRY RUN - preview only. No files will be written, nothing will be installed, no migrations will run.
8
- `);const dirty=await detectDirtyManagedPaths(projectRoot);if(dirty.length>0){console.warn(" Note: these framework-managed paths have uncommitted changes (a real run would abort without --force):");for(const path of dirty)console.warn(` - ${path}`);console.warn("")}let previewSha=null;if(!options.force&&!ctx.targetVersion){previewSha=await getRemoteSha(ctx,usingLocal,detectedLocal);const synced=readSyncedVersion(versionFile);if(shouldShortCircuit({force:!!options.force,targetVersion:ctx.targetVersion,remoteSha:previewSha,synced,channel:ctx.channel})){console.log(`\u2714 Already on the latest ${ctx.channel} (${previewSha.slice(0,7)}). A real run would change nothing.`);return}}const aggregate={added:0,changed:0,removed:0,unchanged:0},perPath=[];let sawRemoved=0,sourceVersion=null;const tmpBase=mkdtempSync(join(tmpdir(),"stacks-upgrade-dry-run-"));try{let repoTmp=null;for(const managed of MANAGED_PATHS){const localTarget=join(projectRoot,managed.localPath),before=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip);let after;if(usingLocal&&detectedLocal){const src=join(detectedLocal,managed.subPath);if(!existsSync(src)){console.log(` ${managed.label.padEnd(10)} skip: source missing at ${src}`);continue}after=managed.isFile?await singleFileSnapshot(src):await snapshotTree(src,managed.skip)}else try{if(managed.isFile){if(!repoTmp){repoTmp=join(tmpBase,"repo");await downloadTemplate(`github:stacksjs/stacks#${ctx.ref}`,{dir:repoTmp,force:!0,forceClean:!0,preferOffline:!0,silent:!0})}after=await singleFileSnapshot(join(repoTmp,managed.subPath))}else{const dir=join(tmpBase,managed.label);await downloadTemplate(buildTemplateString(ctx.ref,managed.subPath),{dir,force:!0,forceClean:!0,preferOffline:!options.force,silent:!0});after=await snapshotTree(dir,managed.skip)}}catch(err){console.log(` ${managed.label.padEnd(10)} preview unavailable (${err?.message||err}); a real run would sync from github:stacksjs/stacks#${ctx.ref}`);continue}const summary=diffSnapshotsDetailed(before,after);aggregate.added+=summary.added;aggregate.changed+=summary.changed;aggregate.removed+=summary.removed;aggregate.unchanged+=summary.unchanged;perPath.push({managed,summary});sawRemoved+=summary.removed;if(managed.isFile){const moved=summary.added+summary.changed>0;console.log(` ${managed.label.padEnd(10)} ${moved?"would update":"unchanged"}`)}else if(summary.added+summary.changed+summary.removed===0)console.log(` ${managed.label.padEnd(10)} unchanged (${summary.unchanged} files)`);else{console.log(` ${managed.label.padEnd(10)} +${summary.added} ~${summary.changed} -${summary.removed} (${summary.unchanged} unchanged)`);const samples=[...summary.addedFiles.map((f)=>`+ ${f}`),...summary.changedFiles.map((f)=>`~ ${f}`)];for(const line of samples.slice(0,8))console.log(` ${line}`);if(samples.length>8)console.log(` ... and ${samples.length-8} more`)}}const sourcePkgPath=usingLocal&&detectedLocal?join(detectedLocal,"storage/framework/core/buddy/package.json"):repoTmp?join(repoTmp,"storage/framework/core/buddy/package.json"):join(tmpBase,"core","buddy","package.json");sourceVersion=readVersion(sourcePkgPath)}finally{rmSync(tmpBase,{recursive:!0,force:!0})}console.log("");if(currentVersion||sourceVersion)console.log(currentVersion===sourceVersion?` version: unchanged (v${currentVersion??"unknown"})`:` version: v${currentVersion??"unknown"} -> v${sourceVersion??"unknown"}`);console.log(`
9
- A real run would:`);console.log(" - sync the managed paths above into place");if(!ctx.targetVersion){console.log(` - write channel "${ctx.channel}" to .stacks-channel`);console.log(previewSha?` - record synced sha ${previewSha.slice(0,7)} in .stacks-version`:" - record the resolved commit sha in .stacks-version (unavailable in this preview)")}if(!(!options.noPostinstall&&options.postinstall!==!1))console.log(" - skip post-sync hooks (--no-postinstall)");else if(aggregate.added+aggregate.changed+aggregate.removed===0)console.log(" - skip post-sync hooks (nothing changed)");else{console.log(" - regenerate the auto-import manifest");if(perPath.some((entry)=>{const{managed,summary}=entry;if(managed.isFile)return!1;if(managed.label!=="core"&&managed.label!=="defaults")return!1;if(summary.added+summary.changed===0)return!1;return pkgJsonInTree(join(projectRoot,managed.localPath))}))console.log(" - run `bun install` to refresh dependencies");if(existsSync(join(projectRoot,"database","types.d.ts")))console.log(" - regenerate database/types.d.ts");if(existsSync(join(projectRoot,"database","migrations")))console.log(" - run pending migrations")}if(sawRemoved>0)console.log(`
8
+ `);const dirty=await detectDirtyManagedPaths(projectRoot);if(dirty.length>0){console.warn(" Note: these framework-managed paths have uncommitted changes (a real run would abort without --force):");for(const path of dirty)console.warn(` - ${path}`);console.warn("")}let previewSha=null;if(!options.force&&!ctx.targetVersion){previewSha=await getRemoteSha(ctx,usingLocal,detectedLocal);const synced=readSyncedVersion(versionFile);if(shouldShortCircuit({force:!!options.force,targetVersion:ctx.targetVersion,remoteSha:previewSha,synced,channel:ctx.channel})){console.log(`✔ Already on the latest ${ctx.channel} (${previewSha.slice(0,7)}). A real run would change nothing.`);return}}const aggregate={added:0,changed:0,removed:0,unchanged:0};const perPath=[];let sawRemoved=0;let sourceVersion=null;const tmpBase=mkdtempSync(join(tmpdir(),"stacks-upgrade-dry-run-"));try{let repoTmp=null;for(const managed of MANAGED_PATHS){const localTarget=join(projectRoot,managed.localPath);const before=managed.isFile?await singleFileSnapshot(localTarget):await snapshotTree(localTarget,managed.skip);let after;if(usingLocal&&detectedLocal){const src=join(detectedLocal,managed.subPath);if(!existsSync(src)){console.log(` ${managed.label.padEnd(10)} skip: source missing at ${src}`);continue}after=managed.isFile?await singleFileSnapshot(src):await snapshotTree(src,managed.skip)}else{try{if(managed.isFile){if(!repoTmp){repoTmp=join(tmpBase,"repo");await downloadTemplate(`github:stacksjs/stacks#${ctx.ref}`,{dir:repoTmp,force:true,forceClean:true,preferOffline:true,silent:true})}after=await singleFileSnapshot(join(repoTmp,managed.subPath))}else{const dir=join(tmpBase,managed.label);await downloadTemplate(buildTemplateString(ctx.ref,managed.subPath),{dir,force:true,forceClean:true,preferOffline:!options.force,silent:true});after=await snapshotTree(dir,managed.skip)}}catch(err){console.log(` ${managed.label.padEnd(10)} preview unavailable (${err?.message||err}); a real run would sync from github:stacksjs/stacks#${ctx.ref}`);continue}}const summary=diffSnapshotsDetailed(before,after);aggregate.added+=summary.added;aggregate.changed+=summary.changed;aggregate.removed+=summary.removed;aggregate.unchanged+=summary.unchanged;perPath.push({managed,summary});sawRemoved+=summary.removed;if(managed.isFile){const moved=summary.added+summary.changed>0;console.log(` ${managed.label.padEnd(10)} ${moved?"would update":"unchanged"}`)}else if(summary.added+summary.changed+summary.removed===0){console.log(` ${managed.label.padEnd(10)} unchanged (${summary.unchanged} files)`)}else{console.log(` ${managed.label.padEnd(10)} +${summary.added} ~${summary.changed} -${summary.removed} (${summary.unchanged} unchanged)`);const samples=[...summary.addedFiles.map((f)=>`+ ${f}`),...summary.changedFiles.map((f)=>`~ ${f}`)];for(const line of samples.slice(0,8))console.log(` ${line}`);if(samples.length>8)console.log(` ... and ${samples.length-8} more`)}}const sourcePkgPath=usingLocal&&detectedLocal?join(detectedLocal,"storage/framework/core/buddy/package.json"):repoTmp?join(repoTmp,"storage/framework/core/buddy/package.json"):join(tmpBase,"core","buddy","package.json");sourceVersion=readVersion(sourcePkgPath)}finally{rmSync(tmpBase,{recursive:true,force:true})}console.log("");if(currentVersion||sourceVersion){console.log(currentVersion===sourceVersion?` version: unchanged (v${currentVersion??"unknown"})`:` version: v${currentVersion??"unknown"} -> v${sourceVersion??"unknown"}`)}console.log(`
9
+ A real run would:`);console.log(" - sync the managed paths above into place");if(!ctx.targetVersion){console.log(` - write channel "${ctx.channel}" to .stacks-channel`);console.log(previewSha?` - record synced sha ${previewSha.slice(0,7)} in .stacks-version`:" - record the resolved commit sha in .stacks-version (unavailable in this preview)")}const runHooks=!options.noPostinstall&&options.postinstall!==false;if(!runHooks){console.log(" - skip post-sync hooks (--no-postinstall)")}else if(aggregate.added+aggregate.changed+aggregate.removed===0&&!options.force){console.log(" - skip post-sync hooks (nothing changed)")}else{console.log(" - regenerate the auto-import manifest");const corePkgChanged=perPath.some((entry)=>{const{managed,summary}=entry;if(managed.isFile)return false;if(managed.label!=="core"&&managed.label!=="defaults")return false;if(summary.added+summary.changed===0)return false;return pkgJsonInTree(join(projectRoot,managed.localPath))});if(shouldRefreshPostSyncDependencies(corePkgChanged,!!options.force)){const installer=detectDependencyInstaller(existsSync(join(projectRoot,"pantry.lock")));console.log(` - run \`${installer} install --force\` to refresh dependencies`)}if(existsSync(join(projectRoot,"database","types.d.ts")))console.log(" - regenerate database/types.d.ts");if(existsSync(join(projectRoot,"database","migrations")))console.log(" - run pending migrations");console.log(` - refresh AI setup for ${detectProjectAiProviders(projectRoot).join(", ")} (including bundled skills)`)}if(sawRemoved>0)console.log(`
10
10
  (-N counts files no longer shipped upstream; the sync leaves them in place.)`);console.log(`
11
- \u2714 Dry run complete. No changes were made.`)}async function detectDirtyManagedPaths(root){const gitDir=join(root,".git");if(!existsSync(gitDir))return[];try{const proc=Bun.spawn({cmd:["git","-C",root,"status","--porcelain","--",...MANAGED_PATHS.map((m)=>m.localPath)],stdout:"pipe",stderr:"pipe"}),output=await new Response(proc.stdout).text();await proc.exited;return output.split(`
12
- `).filter((line)=>line.length>0).map((line)=>line.slice(3))}catch{return[]}}async function getRemoteSha(context,fromLocal,stacksRoot){const SHA_RE=/^[0-9a-f]{40}$/i;try{if(fromLocal&&stacksRoot){const head=Bun.spawn({cmd:["git","-C",stacksRoot,"rev-parse","HEAD"],stdout:"pipe",stderr:"pipe"}),h=(await new Response(head.stdout).text()).trim();return await head.exited===0&&SHA_RE.test(h)?h.toLowerCase():null}const proc=Bun.spawn({cmd:["git","ls-remote","https://github.com/stacksjs/stacks.git",`refs/heads/${context.ref}`,`refs/tags/${context.ref}`,`refs/tags/${context.ref}^{}`],stdout:"pipe",stderr:"pipe"}),out=await new Response(proc.stdout).text();if(await proc.exited!==0)return null;const lines=out.split(`
13
- `).filter(Boolean),m=(lines.find((l)=>l.includes("^{}"))??lines[0])?.match(/^([0-9a-f]{40})\s/i);return m?.[1]?m[1].toLowerCase():null}catch{return null}}async function hashFileOrZero(absPath){try{if(!existsSync(absPath))return 0n;const buf=await Bun.file(absPath).arrayBuffer();return Bun.hash(buf)}catch{return 0n}}async function singleFileSnapshot(absPath){const out=new Map;if(!existsSync(absPath))return out;try{const file=Bun.file(absPath);if(file.size>0){const buf=await file.arrayBuffer();out.set("self",{size:file.size,hash:Bun.hash(buf)})}}catch{}return out}async function syncFromLocal(stacksRoot,managed,localTarget){const src=join(stacksRoot,managed.subPath);if(!existsSync(src)){console.warn(` skip ${managed.label}: source missing at ${src}`);return}if(managed.isFile){mkdirSync(dirname(localTarget),{recursive:!0});copyFileSync(src,localTarget);if(managed.executable)chmodSync(localTarget,493);return}mkdirSync(localTarget,{recursive:!0});cpSync(src,localTarget,{recursive:!0,force:!0,filter:(source)=>{if(!managed.skip)return!0;const name=source.split("/").pop()||"";return!managed.skip.includes(name)}})}async function syncFromGitHub(ref,managed,localTarget,force){const kept=new Map;for(const name of managed.skip??[]){const file=join(localTarget,name);try{if(existsSync(file)&&statSync(file).isFile())kept.set(file,readFileSync(file))}catch{}}const template=buildTemplateString(ref,managed.subPath);await downloadTemplate(template,{dir:localTarget,force:!0,forceClean:!1,preferOffline:!force});for(const[file,contents]of kept)writeFileSync(file,contents)}async function syncRootFilesFromGitHub(ref){const tmpDir=p.projectPath(".tmp-upgrade");try{await downloadTemplate(`github:stacksjs/stacks#${ref}`,{dir:tmpDir,force:!0,forceClean:!0,preferOffline:!0,silent:!0});for(const managed of MANAGED_PATHS){if(!managed.isFile)continue;const src=join(tmpDir,managed.subPath),dest=p.projectPath(managed.localPath);try{if(existsSync(src)&&existsSync(dest)){copyFileSync(src,dest);if(managed.executable)chmodSync(dest,493)}}catch{}}}catch{}finally{if(existsSync(tmpDir))rmSync(tmpDir,{recursive:!0,force:!0})}}async function runPostSyncHooks(args){const{aggregate,perPath,projectRoot,alreadyRestarted}=args,changeCount=aggregate.added+aggregate.changed+aggregate.removed;if(!shouldRunPostSyncHooks(changeCount,alreadyRestarted)){console.log("Nothing changed - skipping post-sync hooks.");return}console.log("Regenerating auto-import manifest...");try{const{generateAutoImportFiles}=await import("@stacksjs/server");await generateAutoImportFiles()}catch(err){console.warn(` auto-imports failed (non-fatal): ${err?.message||err}`)}if(shouldRefreshPostSyncDependencies(perPath.some((entry)=>{const{managed,summary}=entry;if(managed.isFile)return!1;if(managed.label!=="core"&&managed.label!=="defaults")return!1;if(summary.added+summary.changed===0)return!1;return pkgJsonInTree(join(projectRoot,managed.localPath))}),alreadyRestarted)){const installer=detectDependencyInstaller(existsSync(join(projectRoot,"pantry.lock"))),cmd=resolveDependencyRefreshCommand({installer,bunExecutable:process.argv[0]||"bun",pantryExecutable:resolvePantryExecutable(pantryExecutableCandidates(projectRoot),existsSync)});console.log(`Running \`${installer} install\` to refresh dependencies...`);try{await runPostSyncDependencyRefresh({cmd,projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}catch(err){console.warn(` ${installer} install failed (non-fatal): ${err?.message||err}`)}}try{if(await runPostSyncDatabaseTypesRefresh({cmd:[process.argv[0]||"bun",p.frameworkPath("core/buddy/src/cli.ts"),"generate:db-types"],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions),exists:existsSync}))console.log("Regenerated database/types.d.ts")}catch(err){console.warn(` database/types.d.ts was not regenerated (non-fatal): ${err?.message||err}`)}const migrationsDir=join(projectRoot,"database","migrations");if(existsSync(migrationsDir)){console.log("Running pending migrations...");const migrateScript=p.frameworkPath("core/buddy/src/cli.ts");await runPostSyncMigration({bunExecutable:process.argv[0]||"bun",migrateScript,projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}}function pantryExecutableCandidates(projectRoot){const home=process.env.HOME??"";return[join(projectRoot,"pantry",".bin","pantry"),home?join(home,".local","bin","pantry"):"",home?join(home,".local","share","pantry","global","bin","pantry"):""].filter(Boolean)}function pkgJsonInTree(dir){try{if(!existsSync(dir))return!1;return readFileSync(join(dir,"package.json"),"utf-8").length>0}catch{return existsSync(dir)}}
11
+ ✔ Dry run complete. No changes were made.`)}async function detectDirtyManagedPaths(root){const gitDir=join(root,".git");if(!existsSync(gitDir))return[];try{const proc=Bun.spawn({cmd:["git","-C",root,"status","--porcelain","--",...MANAGED_PATHS.map((m)=>m.localPath)],stdout:"pipe",stderr:"pipe"});const output=await new Response(proc.stdout).text();await proc.exited;return output.split(`
12
+ `).filter((line)=>line.length>0).map((line)=>line.slice(3))}catch{return[]}}async function getRemoteSha(context,fromLocal,stacksRoot){const SHA_RE=/^[0-9a-f]{40}$/i;try{if(fromLocal&&stacksRoot){const head=Bun.spawn({cmd:["git","-C",stacksRoot,"rev-parse","HEAD"],stdout:"pipe",stderr:"pipe"});const h=(await new Response(head.stdout).text()).trim();return await head.exited===0&&SHA_RE.test(h)?h.toLowerCase():null}const proc=Bun.spawn({cmd:["git","ls-remote","https://github.com/stacksjs/stacks.git",`refs/heads/${context.ref}`,`refs/tags/${context.ref}`,`refs/tags/${context.ref}^{}`],stdout:"pipe",stderr:"pipe"});const out=await new Response(proc.stdout).text();if(await proc.exited!==0)return null;const lines=out.split(`
13
+ `).filter(Boolean);const deref=lines.find((l)=>l.includes("^{}"));const chosen=deref??lines[0];const m=chosen?.match(/^([0-9a-f]{40})\s/i);return m?.[1]?m[1].toLowerCase():null}catch{return null}}async function hashFileOrZero(absPath){try{if(!existsSync(absPath))return 0n;const buf=await Bun.file(absPath).arrayBuffer();return Bun.hash(buf)}catch{return 0n}}async function singleFileSnapshot(absPath){const out=new Map;if(!existsSync(absPath))return out;try{const file=Bun.file(absPath);if(file.size>0){const buf=await file.arrayBuffer();out.set("self",{size:file.size,hash:Bun.hash(buf)})}}catch{}return out}async function syncFromLocal(stacksRoot,managed,localTarget){const src=join(stacksRoot,managed.subPath);if(!existsSync(src)){console.warn(` skip ${managed.label}: source missing at ${src}`);return}if(managed.isFile){mkdirSync(dirname(localTarget),{recursive:true});copyFileSync(src,localTarget);if(managed.executable)chmodSync(localTarget,493);return}mkdirSync(localTarget,{recursive:true});cpSync(src,localTarget,{recursive:true,force:true,filter:(source)=>{if(!managed.skip)return true;const name=source.split("/").pop()||"";return!managed.skip.includes(name)}})}async function syncFromGitHub(ref,managed,localTarget,force){const kept=new Map;for(const name of managed.skip??[]){const file=join(localTarget,name);try{if(existsSync(file)&&statSync(file).isFile())kept.set(file,readFileSync(file))}catch{}}const template=buildTemplateString(ref,managed.subPath);await downloadTemplate(template,{dir:localTarget,force:true,forceClean:false,preferOffline:!force});for(const[file,contents]of kept)writeFileSync(file,contents)}async function syncRootFilesFromGitHub(ref){const tmpDir=p.projectPath(".tmp-upgrade");try{await downloadTemplate(`github:stacksjs/stacks#${ref}`,{dir:tmpDir,force:true,forceClean:true,preferOffline:true,silent:true});for(const managed of MANAGED_PATHS){if(!managed.isFile)continue;const src=join(tmpDir,managed.subPath);const dest=p.projectPath(managed.localPath);try{if(existsSync(src)&&existsSync(dest)){copyFileSync(src,dest);if(managed.executable)chmodSync(dest,493)}}catch{}}}catch{}finally{if(existsSync(tmpDir))rmSync(tmpDir,{recursive:true,force:true})}}async function runPostSyncHooks(args){const{aggregate,perPath,projectRoot,alreadyRestarted}=args;const changeCount=aggregate.added+aggregate.changed+aggregate.removed;if(!shouldRunPostSyncHooks(changeCount,alreadyRestarted)){console.log("Nothing changed - skipping post-sync hooks.");return}console.log("Regenerating auto-import manifest...");try{const{generateAutoImportFiles}=await import("@stacksjs/server");await generateAutoImportFiles()}catch(err){console.warn(` auto-imports failed (non-fatal): ${err?.message||err}`)}const corePkgChanged=shouldRefreshPostSyncDependencies(perPath.some((entry)=>{const{managed,summary}=entry;if(managed.isFile)return false;if(managed.label!=="core"&&managed.label!=="defaults")return false;if(summary.added+summary.changed===0)return false;return pkgJsonInTree(join(projectRoot,managed.localPath))}),alreadyRestarted);if(corePkgChanged){const installer=detectDependencyInstaller(existsSync(join(projectRoot,"pantry.lock")));const cmd=resolveDependencyRefreshCommand({installer,bunExecutable:process.argv[0]||"bun",pantryExecutable:resolvePantryExecutable(pantryExecutableCandidates(projectRoot),existsSync)});console.log(`Running \`${installer} install\` to refresh dependencies...`);try{await runPostSyncDependencyRefresh({cmd,projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}catch(err){console.warn(` ${installer} install failed (non-fatal): ${err?.message||err}`)}}try{const refreshed=await runPostSyncDatabaseTypesRefresh({cmd:[process.argv[0]||"bun",p.frameworkPath("core/buddy/src/cli.ts"),"generate:db-types"],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions),exists:existsSync});if(refreshed)console.log("Regenerated database/types.d.ts")}catch(err){console.warn(` database/types.d.ts was not regenerated (non-fatal): ${err?.message||err}`)}const migrationsDir=join(projectRoot,"database","migrations");if(existsSync(migrationsDir)){console.log("Running pending migrations...");const migrateScript=p.frameworkPath("core/buddy/src/cli.ts");await runPostSyncMigration({bunExecutable:process.argv[0]||"bun",migrateScript,projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}console.log("Refreshing AI setup and bundled skills...");await runPostSyncAiRefresh({cli:[process.argv[0]||"bun",p.frameworkPath("core/buddy/src/cli.ts")],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}function pantryExecutableCandidates(projectRoot){const home=process.env.HOME??"";return[join(projectRoot,"pantry",".bin","pantry"),home?join(home,".local","bin","pantry"):"",home?join(home,".local","share","pantry","global","bin","pantry"):""].filter(Boolean)}function pkgJsonInTree(dir){try{if(!existsSync(dir))return false;const top=readFileSync(join(dir,"package.json"),"utf-8");return top.length>0}catch{return existsSync(dir)}}
@@ -1,2 +1,2 @@
1
- import{chmodSync,existsSync,lstatSync,mkdirSync,readFileSync,readdirSync,rmSync,statSync,writeFileSync}from"node:fs";import{dirname,join,relative}from"node:path";import{DEFAULTS_SYNC_MARKER,defaultsPackagePath,usesVendoredDefaults}from"@stacksjs/path";const DEFAULTS_PACKAGE_IGNORES=new Set(["README.md","build.ts","node_modules","package.json","project","tests"]),LOCAL_DEFAULT_IGNORES=new Set([".DS_Store",".discovered-models.json",DEFAULTS_SYNC_MARKER,"dist","node_modules"]),LEGACY_PACKAGE_PROJECT_FILES=["storage/framework/types/traits.d.ts"],SUPPORT_FILES=[{source:"project/buddy",target:"buddy",executable:!0},{source:"project/bootstrap",target:"bootstrap",executable:!0},{source:"project/storage/framework/tsconfig.app.json",target:"storage/framework/tsconfig.app.json"},{source:"project/storage/framework/tsconfig.base.json",target:"storage/framework/tsconfig.base.json"},{source:"project/storage/framework/server/tsconfig.docker.json",target:"storage/framework/server/tsconfig.docker.json"}];export const FRAMEWORK_TYPES_SUPPORT_DIRECTORY={source:"project/storage/framework/types",target:"storage/framework/types"},GENERATED_FRAMEWORK_TYPES=["server-auto-imports.d.ts","browser-auto-imports.d.ts"];function copyDirectoryIfChanged(source,target,projectRoot,changes,options,skip){for(const entry of readdirSync(source)){if(skip.has(entry)||LOCAL_DEFAULT_IGNORES.has(entry))continue;const sourcePath=join(source,entry),targetPath=join(target,entry);if(lstatSync(sourcePath).isDirectory())copyDirectoryIfChanged(sourcePath,targetPath,projectRoot,changes,options,skip);else copyFileIfChanged(sourcePath,targetPath,projectRoot,changes,options)}}function sameFile(left,right,shallow=!1){if(!existsSync(left)||!existsSync(right))return!1;const leftStat=statSync(left),rightStat=statSync(right);if(leftStat.size!==rightStat.size)return!1;if(shallow)return!0;return readFileSync(left).equals(readFileSync(right))}function copyFileIfChanged(source,target,projectRoot,changes,options,executable=!1){if(sameFile(source,target,options.shallow&&options.dryRun)){if(executable&&!options.dryRun)chmodSync(target,493);return}changes.push({path:relative(projectRoot,target),action:existsSync(target)?"update":"add"});if(options.dryRun)return;mkdirSync(dirname(target),{recursive:!0});writeFileSync(target,readFileSync(source));if(executable)chmodSync(target,493)}function syncDirectory(source,target,projectRoot,changes,options,isRoot=!1){if(!options.dryRun)mkdirSync(target,{recursive:!0});const sourceEntries=new Set;for(const entry of readdirSync(source)){if(isRoot&&DEFAULTS_PACKAGE_IGNORES.has(entry))continue;sourceEntries.add(entry);const sourcePath=join(source,entry),targetPath=join(target,entry);if(lstatSync(sourcePath).isDirectory()){syncDirectory(sourcePath,targetPath,projectRoot,changes,options);continue}copyFileIfChanged(sourcePath,targetPath,projectRoot,changes,options)}if(!existsSync(target))return;for(const entry of readdirSync(target)){if(LOCAL_DEFAULT_IGNORES.has(entry)||sourceEntries.has(entry))continue;const targetPath=join(target,entry);changes.push({path:relative(projectRoot,targetPath),action:"remove"});if(!options.dryRun)rmSync(targetPath,{recursive:!0,force:!0})}}export function vendorDefaultsTree(projectRoot,defaultsPackageRoot,options={}){const changes=[],targetDefaults=join(projectRoot,"storage/framework/defaults");syncDirectory(defaultsPackageRoot,targetDefaults,projectRoot,changes,options,!0);if(!options.dryRun)stampDefaultsSync(targetDefaults,defaultsPackageRoot);return changes}export function syncPackageProjectFiles(projectRoot,defaultsPackageRoot,options={}){const changes=[],targetDefaults=join(projectRoot,"storage/framework/defaults"),vendorDefaults=options.vendorDefaults??usesVendoredDefaults(projectRoot);if(vendorDefaults)syncDirectory(defaultsPackageRoot,targetDefaults,projectRoot,changes,options,!0);for(const file of SUPPORT_FILES){const source=join(defaultsPackageRoot,file.source);if(!existsSync(source))continue;copyFileIfChanged(source,join(projectRoot,file.target),projectRoot,changes,options,file.executable)}const typesSource=join(defaultsPackageRoot,FRAMEWORK_TYPES_SUPPORT_DIRECTORY.source);if(existsSync(typesSource))copyDirectoryIfChanged(typesSource,join(projectRoot,FRAMEWORK_TYPES_SUPPORT_DIRECTORY.target),projectRoot,changes,options,new Set(GENERATED_FRAMEWORK_TYPES));const bunVersion=shippedBunVersion(defaultsPackageRoot);if(bunVersion)alignBunPins(projectRoot,bunVersion,changes,options);for(const legacyFile of LEGACY_PACKAGE_PROJECT_FILES){const target=join(projectRoot,legacyFile);if(!existsSync(target))continue;changes.push({path:legacyFile,action:"remove"});if(!options.dryRun)rmSync(target,{force:!0})}if(!options.dryRun&&vendorDefaults)stampDefaultsSync(targetDefaults,defaultsPackageRoot);return changes}export const BUN_VERSION_FILE="project/bun-version";function shippedBunVersion(defaultsPackageRoot){try{const version=readFileSync(join(defaultsPackageRoot,BUN_VERSION_FILE),"utf8").trim();return/^\d+\.\d+\.\d+$/.test(version)?version:null}catch{return null}}function olderVersion(candidate,than){const left=candidate.split(".").map(Number),right=than.split(".").map(Number);for(let i=0;i<3;i++)if(left[i]!==right[i])return(left[i]??0)<(right[i]??0);return!1}const VERSION="(\\d+\\.\\d+\\.\\d+)",BUN_PINS=[new RegExp(`^(\\s*BUN_VERSION:\\s*['"]?)${VERSION}`,"gm"),new RegExp(`^(\\s*bun-version:\\s*['"]?)${VERSION}`,"gm"),new RegExp(`((?:^|[\\s'"])bun(?:\\.sh|\\.com)?@)${VERSION}`,"gm"),new RegExp(`(oven/bun:)${VERSION}`,"g"),new RegExp(`^(\\s*ARG\\s+BUN_VERSION=)${VERSION}`,"gm")];export function raiseBunPins(text,version){let next=text;for(const pattern of BUN_PINS)next=next.replace(pattern,(match,prefix,pinned)=>olderVersion(pinned,version)?`${prefix}${version}`:match);return next}function bunPinFiles(projectRoot){const files=[],workflows=join(projectRoot,".github/workflows");if(existsSync(workflows)){for(const entry of readdirSync(workflows))if(/\.ya?ml$/.test(entry))files.push(join(workflows,entry))}for(const entry of readdirSync(projectRoot))if(/^Dockerfile/.test(entry))files.push(join(projectRoot,entry));for(const path of["storage/framework/Dockerfile","storage/framework/server/Dockerfile"])if(existsSync(join(projectRoot,path)))files.push(join(projectRoot,path));return files}export function alignBunPins(projectRoot,version,changes=[],options={}){for(const file of bunPinFiles(projectRoot)){const text=readFileSync(file,"utf8"),next=raiseBunPins(text,version);if(next===text)continue;changes.push({path:relative(projectRoot,file),action:"update"});if(!options.dryRun)writeFileSync(file,next)}return changes}function stampDefaultsSync(targetDefaults,defaultsPackageRoot){const version=manifestVersion(defaultsPackageRoot);if(!version)return;const marker={version,syncedAt:new Date().toISOString()};mkdirSync(targetDefaults,{recursive:!0});writeFileSync(join(targetDefaults,DEFAULTS_SYNC_MARKER),`${JSON.stringify(marker,null,2)}
2
- `)}function manifestVersion(packageRoot){try{const version=JSON.parse(readFileSync(join(packageRoot,"package.json"),"utf8"))?.version;return typeof version==="string"?version:null}catch{return null}}export function measureDefaultsDrift(projectRoot,options={}){const packageRoot=defaultsPackagePath(projectRoot);if(!existsSync(join(packageRoot,"package.json")))return null;return syncPackageProjectFiles(projectRoot,packageRoot,{dryRun:!0,shallow:options.shallow})}export function summarizeStructureChanges(changes){const added=changes.filter((change)=>change.action==="add").length,updated=changes.filter((change)=>change.action==="update").length,removed=changes.filter((change)=>change.action==="remove").length;return`+${added} ~${updated} -${removed}`}export function migratePackageProjectManifest(pkg){const changes=[],scripts=pkg.scripts??{},setScript=(name,value)=>{if(scripts[name]===value)return;scripts[name]=value;changes.push({path:`package.json#scripts.${name}`,action:"update"})};setScript("buddy","./buddy");const appCheck="bun x --bun tsc --noEmit -p tsconfig.json --pretty false";for(const[name,replacement]of Object.entries({typecheck:appCheck,"typecheck:app":appCheck,"types:check":"bun run typecheck"})){const current=scripts[name];if(!current){setScript(name,replacement);continue}const steps=current.match(/(?:[^&"'`]|"[^"\\]*(?:\\.[^"\\]*)*"|'[^']*')+/g);if(!steps||steps.join("&&")!==current||/[;|`$()<>#\\\n]/.test(current))continue;let changed=!1;const migrated=steps.flatMap((step)=>{const command=step.trim();if(/^(?:bun|npm|pnpm) run build:framework-types$/.test(command)){changed=!0;return[]}if(/^(?:(?:bun(?: x|x)?(?: --bun)?|npx) )?(?:tsc|tsgo)\b/.test(command)&&/storage\/framework\/(?:core(?:\/|['"\s]|$)|tsconfig\.(?:framework|defaults|type-tests)\.json)/.test(command)){changed=!0;return[appCheck]}return[command]});if(changed)setScript(name,migrated.length?migrated.join(" && "):replacement)}if(scripts["build:reset"]?.includes("storage/framework")||scripts["build:reset"]==="rm -rf node_modules pantry.lock && bun install && ./buddy generate:types && ./buddy lint:fix")setScript("build:reset","rm -rf node_modules && bun install && ./buddy generate:types && ./buddy lint:fix");if(scripts["build:framework-types"]&&!Object.entries(scripts).some(([name,command])=>name!=="build:framework-types"&&command.includes("build:framework-types"))){delete scripts["build:framework-types"];changes.push({path:"package.json#scripts.build:framework-types",action:"remove"})}pkg.scripts=scripts;if(Array.isArray(pkg.workspaces)){const next=pkg.workspaces.filter((workspace)=>workspace!=="storage/framework/core"&&!workspace.startsWith("storage/framework/core/"));if(next.length!==pkg.workspaces.length){pkg.workspaces=next;changes.push({path:"package.json#workspaces",action:"update"})}}return changes}export function migratePackageProjectTsconfig(projectRoot,options={}){const path=join(projectRoot,"tsconfig.json");if(!existsSync(path))return[];const raw=readFileSync(path,"utf8"),next=raw.replace(/"extends"\s*:\s*"\.\/storage\/framework\/core\/tsconfig\.json"/,'"extends": "./storage/framework/tsconfig.app.json"');if(next===raw)return[];if(!options.dryRun)writeFileSync(path,next);return[{path:"tsconfig.json",action:"update"}]}export function detectProjectAiProviders(projectRoot){const providers=new Set(["codex"]);if(existsSync(join(projectRoot,"CLAUDE.md"))||existsSync(join(projectRoot,".claude")))providers.add("claude");if(existsSync(join(projectRoot,".cursor")))providers.add("cursor");if(existsSync(join(projectRoot,".github/copilot-instructions.md")))providers.add("copilot");if(existsSync(join(projectRoot,"GEMINI.md")))providers.add("gemini");return[...providers]}
1
+ import{chmodSync,existsSync,lstatSync,mkdirSync,readFileSync,readdirSync,rmSync,statSync,writeFileSync}from"node:fs";import{dirname,join,relative}from"node:path";import{DEFAULTS_SYNC_MARKER,defaultsPackagePath,usesVendoredDefaults}from"@stacksjs/path";const DEFAULTS_PACKAGE_IGNORES=new Set(["README.md","build.ts","node_modules","package.json","project","tests"]);const LOCAL_DEFAULT_IGNORES=new Set([".DS_Store",".discovered-models.json",DEFAULTS_SYNC_MARKER,"dist","node_modules"]);const LEGACY_PACKAGE_PROJECT_FILES=["storage/framework/types/traits.d.ts"];const SUPPORT_FILES=[{source:"project/buddy",target:"buddy",executable:true},{source:"project/bootstrap",target:"bootstrap",executable:true},{source:"project/storage/framework/tsconfig.app.json",target:"storage/framework/tsconfig.app.json"},{source:"project/storage/framework/tsconfig.base.json",target:"storage/framework/tsconfig.base.json"},{source:"project/storage/framework/server/tsconfig.docker.json",target:"storage/framework/server/tsconfig.docker.json"}];export const FRAMEWORK_TYPES_SUPPORT_DIRECTORY={source:"project/storage/framework/types",target:"storage/framework/types"};export const GENERATED_FRAMEWORK_TYPES=["server-auto-imports.d.ts","browser-auto-imports.d.ts"];function copyDirectoryIfChanged(source,target,projectRoot,changes,options,skip){for(const entry of readdirSync(source)){if(skip.has(entry)||LOCAL_DEFAULT_IGNORES.has(entry))continue;const sourcePath=join(source,entry);const targetPath=join(target,entry);if(lstatSync(sourcePath).isDirectory())copyDirectoryIfChanged(sourcePath,targetPath,projectRoot,changes,options,skip);else copyFileIfChanged(sourcePath,targetPath,projectRoot,changes,options)}}function sameFile(left,right,shallow=false){if(!existsSync(left)||!existsSync(right))return false;const leftStat=statSync(left);const rightStat=statSync(right);if(leftStat.size!==rightStat.size)return false;if(shallow)return true;return readFileSync(left).equals(readFileSync(right))}function copyFileIfChanged(source,target,projectRoot,changes,options,executable=false){if(sameFile(source,target,options.shallow&&options.dryRun)){if(executable&&!options.dryRun)chmodSync(target,493);return}changes.push({path:relative(projectRoot,target),action:existsSync(target)?"update":"add"});if(options.dryRun)return;mkdirSync(dirname(target),{recursive:true});writeFileSync(target,readFileSync(source));if(executable)chmodSync(target,493)}function syncDirectory(source,target,projectRoot,changes,options,isRoot=false){if(!options.dryRun)mkdirSync(target,{recursive:true});const sourceEntries=new Set;for(const entry of readdirSync(source)){if(isRoot&&DEFAULTS_PACKAGE_IGNORES.has(entry))continue;sourceEntries.add(entry);const sourcePath=join(source,entry);const targetPath=join(target,entry);const sourceStat=lstatSync(sourcePath);if(sourceStat.isDirectory()){syncDirectory(sourcePath,targetPath,projectRoot,changes,options);continue}copyFileIfChanged(sourcePath,targetPath,projectRoot,changes,options)}if(!existsSync(target))return;for(const entry of readdirSync(target)){if(LOCAL_DEFAULT_IGNORES.has(entry)||sourceEntries.has(entry))continue;const targetPath=join(target,entry);changes.push({path:relative(projectRoot,targetPath),action:"remove"});if(!options.dryRun)rmSync(targetPath,{recursive:true,force:true})}}export function vendorDefaultsTree(projectRoot,defaultsPackageRoot,options={}){const changes=[];const targetDefaults=join(projectRoot,"storage/framework/defaults");syncDirectory(defaultsPackageRoot,targetDefaults,projectRoot,changes,options,true);if(!options.dryRun)stampDefaultsSync(targetDefaults,defaultsPackageRoot);return changes}export function syncPackageProjectFiles(projectRoot,defaultsPackageRoot,options={}){const changes=[];const targetDefaults=join(projectRoot,"storage/framework/defaults");const vendorDefaults=options.vendorDefaults??usesVendoredDefaults(projectRoot);if(vendorDefaults)syncDirectory(defaultsPackageRoot,targetDefaults,projectRoot,changes,options,true);for(const file of SUPPORT_FILES){const source=join(defaultsPackageRoot,file.source);if(!existsSync(source))continue;copyFileIfChanged(source,join(projectRoot,file.target),projectRoot,changes,options,file.executable)}const typesSource=join(defaultsPackageRoot,FRAMEWORK_TYPES_SUPPORT_DIRECTORY.source);if(existsSync(typesSource)){copyDirectoryIfChanged(typesSource,join(projectRoot,FRAMEWORK_TYPES_SUPPORT_DIRECTORY.target),projectRoot,changes,options,new Set(GENERATED_FRAMEWORK_TYPES))}const bunVersion=shippedBunVersion(defaultsPackageRoot);if(bunVersion)alignBunPins(projectRoot,bunVersion,changes,options);for(const legacyFile of LEGACY_PACKAGE_PROJECT_FILES){const target=join(projectRoot,legacyFile);if(!existsSync(target))continue;changes.push({path:legacyFile,action:"remove"});if(!options.dryRun)rmSync(target,{force:true})}if(!options.dryRun&&vendorDefaults)stampDefaultsSync(targetDefaults,defaultsPackageRoot);return changes}export const BUN_VERSION_FILE="project/bun-version";function shippedBunVersion(defaultsPackageRoot){try{const version=readFileSync(join(defaultsPackageRoot,BUN_VERSION_FILE),"utf8").trim();return/^\d+\.\d+\.\d+$/.test(version)?version:null}catch{return null}}function olderVersion(candidate,than){const left=candidate.split(".").map(Number);const right=than.split(".").map(Number);for(let i=0;i<3;i++){if(left[i]!==right[i])return(left[i]??0)<(right[i]??0)}return false}const VERSION="(\\d+\\.\\d+\\.\\d+)";const BUN_PINS=[new RegExp(`^(\\s*BUN_VERSION:\\s*['"]?)${VERSION}`,"gm"),new RegExp(`^(\\s*bun-version:\\s*['"]?)${VERSION}`,"gm"),new RegExp(`((?:^|[\\s'"])bun(?:\\.sh|\\.com)?@)${VERSION}`,"gm"),new RegExp(`(oven/bun:)${VERSION}`,"g"),new RegExp(`^(\\s*ARG\\s+BUN_VERSION=)${VERSION}`,"gm")];export function raiseBunPins(text,version){let next=text;for(const pattern of BUN_PINS)next=next.replace(pattern,(match,prefix,pinned)=>olderVersion(pinned,version)?`${prefix}${version}`:match);return next}function bunPinFiles(projectRoot){const files=[];const workflows=join(projectRoot,".github/workflows");if(existsSync(workflows)){for(const entry of readdirSync(workflows)){if(/\.ya?ml$/.test(entry))files.push(join(workflows,entry))}}for(const entry of readdirSync(projectRoot)){if(/^Dockerfile/.test(entry))files.push(join(projectRoot,entry))}for(const path of["storage/framework/Dockerfile","storage/framework/server/Dockerfile"]){if(existsSync(join(projectRoot,path)))files.push(join(projectRoot,path))}return files}export function alignBunPins(projectRoot,version,changes=[],options={}){for(const file of bunPinFiles(projectRoot)){const text=readFileSync(file,"utf8");const next=raiseBunPins(text,version);if(next===text)continue;changes.push({path:relative(projectRoot,file),action:"update"});if(!options.dryRun)writeFileSync(file,next)}return changes}function stampDefaultsSync(targetDefaults,defaultsPackageRoot){const version=manifestVersion(defaultsPackageRoot);if(!version)return;const marker={version,syncedAt:new Date().toISOString()};mkdirSync(targetDefaults,{recursive:true});writeFileSync(join(targetDefaults,DEFAULTS_SYNC_MARKER),`${JSON.stringify(marker,null,2)}
2
+ `)}function manifestVersion(packageRoot){try{const version=JSON.parse(readFileSync(join(packageRoot,"package.json"),"utf8"))?.version;return typeof version==="string"?version:null}catch{return null}}export function measureDefaultsDrift(projectRoot,options={}){const packageRoot=defaultsPackagePath(projectRoot);if(!existsSync(join(packageRoot,"package.json")))return null;return syncPackageProjectFiles(projectRoot,packageRoot,{dryRun:true,shallow:options.shallow})}export function summarizeStructureChanges(changes){const added=changes.filter((change)=>change.action==="add").length;const updated=changes.filter((change)=>change.action==="update").length;const removed=changes.filter((change)=>change.action==="remove").length;return`+${added} ~${updated} -${removed}`}export function migratePackageProjectManifest(pkg){const changes=[];const scripts=pkg.scripts??{};const setScript=(name,value)=>{if(scripts[name]===value)return;scripts[name]=value;changes.push({path:`package.json#scripts.${name}`,action:"update"})};setScript("buddy","./buddy");const appCheck="bun x --bun tsc --noEmit -p tsconfig.json --pretty false";for(const[name,replacement]of Object.entries({typecheck:appCheck,"typecheck:app":appCheck,"types:check":"bun run typecheck"})){const current=scripts[name];if(!current){setScript(name,replacement);continue}const steps=current.match(/(?:[^&"'`]|"[^"\\]*(?:\\.[^"\\]*)*"|'[^']*')+/g);if(!steps||steps.join("&&")!==current||/[;|`$()<>#\\\n]/.test(current))continue;let changed=false;const migrated=steps.flatMap((step)=>{const command=step.trim();if(/^(?:bun|npm|pnpm) run build:framework-types$/.test(command)){changed=true;return[]}if(/^(?:(?:bun(?: x|x)?(?: --bun)?|npx) )?(?:tsc|tsgo)\b/.test(command)&&/storage\/framework\/(?:core(?:\/|['"\s]|$)|tsconfig\.(?:framework|defaults|type-tests)\.json)/.test(command)){changed=true;return[appCheck]}return[command]});if(changed)setScript(name,migrated.length?migrated.join(" && "):replacement)}if(scripts["build:reset"]?.includes("storage/framework")||scripts["build:reset"]==="rm -rf node_modules pantry.lock && bun install && ./buddy generate:types && ./buddy lint:fix"){setScript("build:reset","rm -rf node_modules && bun install && ./buddy generate:types && ./buddy lint:fix")}if(scripts["build:framework-types"]&&!Object.entries(scripts).some(([name,command])=>name!=="build:framework-types"&&command.includes("build:framework-types"))){delete scripts["build:framework-types"];changes.push({path:"package.json#scripts.build:framework-types",action:"remove"})}pkg.scripts=scripts;if(Array.isArray(pkg.workspaces)){const next=pkg.workspaces.filter((workspace)=>workspace!=="storage/framework/core"&&!workspace.startsWith("storage/framework/core/"));if(next.length!==pkg.workspaces.length){pkg.workspaces=next;changes.push({path:"package.json#workspaces",action:"update"})}}return changes}export function migratePackageProjectTsconfig(projectRoot,options={}){const path=join(projectRoot,"tsconfig.json");if(!existsSync(path))return[];const raw=readFileSync(path,"utf8");const next=raw.replace(/"extends"\s*:\s*"\.\/storage\/framework\/core\/tsconfig\.json"/,'"extends": "./storage/framework/tsconfig.app.json"');if(next===raw)return[];if(!options.dryRun)writeFileSync(path,next);return[{path:"tsconfig.json",action:"update"}]}export function detectProjectAiProviders(projectRoot){const providers=new Set(["codex"]);if(existsSync(join(projectRoot,"CLAUDE.md"))||existsSync(join(projectRoot,".claude")))providers.add("claude");if(existsSync(join(projectRoot,".cursor")))providers.add("cursor");if(existsSync(join(projectRoot,".github/copilot-instructions.md")))providers.add("copilot");if(existsSync(join(projectRoot,"GEMINI.md")))providers.add("gemini");return[...providers]}
@@ -1,34 +1,35 @@
1
- import{existsSync,lstatSync,readdirSync,readFileSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";import process from"node:process";import{runCommand}from"@stacksjs/cli";import{installedDefaultsVersion}from"@stacksjs/path";import{runPostSyncDatabaseTypesRefresh}from"./framework-hooks";import{detectProjectAiProviders,measureDefaultsDrift,migratePackageProjectManifest,migratePackageProjectTsconfig,summarizeStructureChanges,syncPackageProjectFiles}from"./package-project";import{describeDanglingRouteActions,findDanglingRouteActions,pruneRetiredScaffoldRoutes}from"./route-actions";export function hasStacksDependency(pkg){return Boolean(pkg.dependencies?.stacks||pkg.devDependencies?.stacks)}export function standalonePackageUpdateCommand(){return"bun update"}export function frameworkPackageUpdateCommand(target,force=!1){if(!/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(target))throw Error("The framework install target must be a published version.");return`bun update stacks@${target}${force?" --force":""}`}export function installedStacksVersion(projectRoot){try{const manifest=JSON.parse(readFileSync(join(projectRoot,"node_modules/stacks/package.json"),"utf-8"));return typeof manifest.version==="string"?manifest.version:null}catch{return null}}export function needsFrameworkInstall(projectRoot,target,runtimePins={}){try{const metaRoot=join(projectRoot,"node_modules/stacks"),installed=JSON.parse(readFileSync(join(metaRoot,"package.json"),"utf8"));if(installed.version!==target)return!0;const projectPath=join(projectRoot,"package.json"),project=existsSync(projectPath)?JSON.parse(readFileSync(projectPath,"utf8")):{},publishedRange=/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/,customResolution=(name)=>{const rule=project.overrides?.[name]??project.resolutions?.[name];return rule!==void 0&&(typeof rule!=="string"||!publishedRange.test(rule))},lockPath=join(projectRoot,"bun.lock");if(existsSync(lockPath)){if(Bun.JSONC.parse(readFileSync(lockPath,"utf8")).packages?.stacks?.[0]!==`stacks@${target}`)return!0}for(const[name,version]of Object.entries(installed.dependencies??{})){if(!name.startsWith("@stacksjs/")||version!==target||customResolution(name))continue;if(JSON.parse(readFileSync(Bun.resolveSync(`${name}/package.json`,metaRoot),"utf8")).version!==target)return!0}if(Object.keys(runtimePins).length){const declared={...project.dependencies,...project.devDependencies};for(const[name,version]of Object.entries(runtimePins)){const spec=declared[name];if(typeof spec!=="string"||!publishedRange.test(spec)||customResolution(name))continue;if(JSON.parse(readFileSync(Bun.resolveSync(`${name}/package.json`,projectRoot),"utf8")).version!==baseVersion(version))return!0}}return!1}catch{return!0}}async function updateStandalonePackage(projectRoot,options){console.log(`
1
+ import{existsSync,lstatSync,readdirSync,readFileSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";import process from"node:process";import{runCommand}from"@stacksjs/cli";import{installedDefaultsVersion}from"@stacksjs/path";import{runPostSyncAiRefresh,runPostSyncDatabaseTypesRefresh}from"./framework-hooks";import{measureDefaultsDrift,migratePackageProjectManifest,migratePackageProjectTsconfig,summarizeStructureChanges,syncPackageProjectFiles}from"./package-project";import{describeDanglingRouteActions,findDanglingRouteActions,pruneRetiredScaffoldRoutes}from"./route-actions";export function hasStacksDependency(pkg){return Boolean(pkg.dependencies?.stacks||pkg.devDependencies?.stacks)}export function standalonePackageUpdateCommand(){return"bun update"}export function frameworkPackageUpdateCommand(target,force=false){if(!/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/.test(target))throw new Error("The framework install target must be a published version.");return`bun update stacks@${target}${force?" --force":""}`}export function installedStacksVersion(projectRoot){try{const manifest=JSON.parse(readFileSync(join(projectRoot,"node_modules/stacks/package.json"),"utf-8"));return typeof manifest.version==="string"?manifest.version:null}catch{return null}}export function needsFrameworkInstall(projectRoot,target,runtimePins={}){try{const metaRoot=join(projectRoot,"node_modules/stacks");const installed=JSON.parse(readFileSync(join(metaRoot,"package.json"),"utf8"));if(installed.version!==target)return true;const projectPath=join(projectRoot,"package.json");const project=existsSync(projectPath)?JSON.parse(readFileSync(projectPath,"utf8")):{};const publishedRange=/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/;const customResolution=(name)=>{const rule=project.overrides?.[name]??project.resolutions?.[name];return rule!==undefined&&(typeof rule!=="string"||!publishedRange.test(rule))};const lockPath=join(projectRoot,"bun.lock");if(existsSync(lockPath)){const lock=Bun.JSONC.parse(readFileSync(lockPath,"utf8"));if(lock.packages?.stacks?.[0]!==`stacks@${target}`)return true}for(const[name,version]of Object.entries(installed.dependencies??{})){if(!name.startsWith("@stacksjs/")||version!==target||customResolution(name))continue;const manifest=JSON.parse(readFileSync(Bun.resolveSync(`${name}/package.json`,metaRoot),"utf8"));if(manifest.version!==target)return true}if(Object.keys(runtimePins).length){const declared={...project.dependencies,...project.devDependencies};for(const[name,version]of Object.entries(runtimePins)){const spec=declared[name];if(typeof spec!=="string"||!publishedRange.test(spec)||customResolution(name))continue;const manifest=JSON.parse(readFileSync(Bun.resolveSync(`${name}/package.json`,projectRoot),"utf8"));if(manifest.version!==baseVersion(version))return true}}return false}catch{return true}}async function updateStandalonePackage(projectRoot,options){console.log(`
2
2
  Standalone package detected. No Stacks framework source is installed.`);if(options.dryRun){console.log(" --dry-run: would refresh the package dependencies with `bun update`. No files were changed.\n");process.exit(0)}if(options.noPostinstall){console.log(" --no-postinstall: skipping the dependency refresh. Run `bun update` when ready.\n");process.exit(0)}console.log(` Refreshing declared dependencies...
3
- `);if((await runCommand(standalonePackageUpdateCommand(),{cwd:projectRoot})).isErr){console.error("\n\u2717 The dependency refresh failed. Resolve the reported error and re-run `buddy update`.\n");process.exit(1)}console.log(`
4
- \u2714 Standalone package dependencies are up to date.
5
- `);process.exit(0)}export function declaredPins(pkg,names){const declared={...pkg.devDependencies,...pkg.dependencies},pins={};for(const name of names){const spec=declared[name];if(typeof spec==="string"&&/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec))pins[name]=baseVersion(spec)}return pins}async function resolveTarget(options){const res=await fetch("https://registry.npmjs.org/stacks").catch(()=>null);if(!res||!res.ok)throw Error("Could not reach the npm registry to resolve the target `stacks` version.");const meta=await res.json(),distTags=meta["dist-tags"]??{},versions=meta.versions??{};let version;if(options.version){if(!versions[options.version])throw Error(`stacks@${options.version} was not found on the npm registry.`);version=options.version}else{const tag=options.canary?"canary":"latest",resolved=distTags[tag];if(!resolved)throw Error(`The \`${tag}\` dist-tag is not published for \`stacks\`.`);version=resolved}const metaDeps=versions[version]?.dependencies??{},actions=await fetch(`https://registry.npmjs.org/@stacksjs%2factions/${version}`);if(!actions.ok)throw Error(`Could not resolve the frontend dependencies shipped by @stacksjs/actions@${version}.`);const manifest=await actions.json();if(manifest.version!==version)throw Error("The published actions manifest does not match the requested framework release.");return{version,metaDeps,runtimePins:await resolvePublishedRuntimePins(manifest.dependencies??{}),craftFloor:craftFloor(manifest)}}export function publishedRuntimePins(dependencies){const pins={};for(const name of["@stacksjs/stx","@stacksjs/components","bun-plugin-stx","@stacksjs/desktop","@stacksjs/sanitizer","stx-router"]){const version=dependencies[name];if(version&&/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(version))pins[name]=version}return pins}export async function resolvePublishedRuntimePins(dependencies,read=fetch){const pins=publishedRuntimePins(dependencies),version=pins["@stacksjs/stx"];if(!version)return pins;const response=await read(`https://registry.npmjs.org/@stacksjs%2fstx/${version}`);if(!response.ok)throw Error(`Could not resolve the runtime dependencies shipped by @stacksjs/stx@${version}.`);const manifest=await response.json();if(manifest.name!=="@stacksjs/stx"||manifest.version!==version)throw Error("The published STX manifest does not match the requested runtime release.");for(const[name,target]of Object.entries(publishedRuntimePins(manifest.dependencies??{}))){if(pins[name]&&pins[name]!==target)throw Error(`The published framework and STX manifests disagree on ${name}.`);pins[name]=target}return pins}export function keepsNewerRelease(spec,target){const declared=baseVersion(spec),plain=/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/;return plain.test(declared)&&plain.test(target)&&Bun.semver.order(declared,target)>=0&&Bun.semver.satisfies(declared,`^${target}`)}export function applyRuntimePins(pkg,pins,options={}){const changes=[];for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(!declarations||typeof declarations!=="object"||Array.isArray(declarations))continue;for(const[name,target]of Object.entries(pins)){const spec=declarations[name];if(typeof spec!=="string"||!/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec))continue;if(!options.exact&&keepsNewerRelease(spec,target))continue;const next=`${/^[\^~]/.test(spec)?spec[0]:""}${target}`;if(next===spec)continue;changes.push({name,from:spec,to:next,...field==="overrides"||field==="resolutions"?{field}:{}});declarations[name]=next}}return changes}export function isCraftPackage(name){return name==="craft-native"||/^@craft-native\/[a-z0-9][\w.-]*$/.test(name)}export function craftFloor(manifest){return(manifest.peerDependencies?.["craft-native"]??manifest.dependencies?.["craft-native"])?.match(/^>=\s*(\d+\.\d+\.\d+)$/)?.[1]}export function declaredCraftPackages(pkg){const names=new Set;for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(declarations&&typeof declarations==="object"&&!Array.isArray(declarations))Object.keys(declarations).filter(isCraftPackage).forEach((name)=>names.add(name))}return[...names].sort()}export async function resolveCraftPins(pkg,floor,read=fetch){const pins={};if(!floor)return pins;for(const name of declaredCraftPackages(pkg)){const response=await read(`https://registry.npmjs.org/${name.replace("/","%2f")}/${floor}`).catch(()=>null),manifest=response?.ok?await response.json().catch(()=>null):null;if(manifest?.name===name&&manifest.version===floor)pins[name]=floor;else console.warn(` ${name}@${floor} is not published; leaving ${name} as declared.`)}return pins}export function applyCraftFloor(pkg,pins){const changes=[];for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(!declarations||typeof declarations!=="object"||Array.isArray(declarations))continue;for(const[name,floor]of Object.entries(pins)){const spec=declarations[name],match=typeof spec==="string"?/^(\^|~|>=\s*)?(\d+\.\d+\.\d+(?:-[\w.-]+)?)$/.exec(spec):null;if(!match||Bun.semver.order(match[2],floor)>=0)continue;const next=`${(match[1]??"").replace(/\s+/,"")}${floor}`;changes.push({name,from:spec,to:next,...field==="overrides"||field==="resolutions"?{field}:{}});declarations[name]=next}}return changes}export function lockfileVersion(projectRoot){const path=join(projectRoot,"bun.lock");if(!existsSync(path))return null;const match=/"lockfileVersion"\s*:\s*(\d+)/.exec(readFileSync(path,"utf8"));return match?Number(match[1]):null}export function lockfileOnlyAddCommands(pkg,names){const wanted=new Set(names),commands=[];for(const[field,flag]of[["dependencies",""],["devDependencies"," --dev"]]){const specs=Object.entries(pkg[field]??{}).filter(([name,spec])=>wanted.has(name)&&/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec)&&/^(?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*$/.test(name)).map(([name,spec])=>`${name}@${spec}`);if(specs.length)commands.push(`bun add --exact --lockfile-only${flag} ${specs.join(" ")}`)}return commands}export function baseVersion(range){return range.replace(/^[\^~>=<\s]+/,"").trim()}export function isDowngrade(from,to){const before=baseVersion(from),after=baseVersion(to),plain=/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/;return plain.test(before)&&plain.test(after)&&Bun.semver.order(after,before)<0}export function lockstepPackages(metaDeps,target){const lockstep=new Set(["stacks"]);for(const[name,range]of Object.entries(metaDeps))if(name.startsWith("@stacksjs/")&&baseVersion(range)===target)lockstep.add(name);return lockstep}export function applyBumps(pkg,target,lockstep){const changes=[];for(const field of["dependencies","devDependencies"]){const deps=pkg[field];if(!deps)continue;for(const[name,spec]of Object.entries(deps)){if(!lockstep.has(name))continue;const next=`${/^[\^~]/.test(spec)?spec[0]:/^\d/.test(spec)?"":"^"}${target}`;if(spec!==next){changes.push({name,from:spec,to:next});deps[name]=next}}}for(const field of["overrides","resolutions"]){const rules=pkg[field];if(!rules||typeof rules!=="object"||Array.isArray(rules))continue;for(const[name,spec]of Object.entries(rules)){if(!lockstep.has(name)||typeof spec!=="string"||!/^[\^~]?\d/.test(spec))continue;const next=resolveManifestSpec(name,spec,target);if(!next)continue;changes.push({name,from:spec,to:next,field});rules[name]=next}}return changes}export async function upgradeStacksPackages(projectRoot,options){const pkgPath=join(projectRoot,"package.json");if(!existsSync(pkgPath)){console.error("No package.json found - nothing to upgrade.");process.exit(1)}const raw=readFileSync(pkgPath,"utf-8"),pkg=JSON.parse(raw),current=pkg.dependencies?.stacks??pkg.devDependencies?.stacks;if(!hasStacksDependency(pkg))return updateStandalonePackage(projectRoot,options);const{version:target,metaDeps,runtimePins,craftFloor:floor}=await resolveTarget(options).catch((err)=>{console.error(`\u2717 ${err.message}`);process.exit(1)}),craftPins=await resolveCraftPins(pkg,floor);console.log(`
6
- Upgrading the Stacks framework${options.canary?" (canary)":""} \u2192 ${target}`);if(current)console.log(` current \`stacks\` constraint: ${current}
7
- `);const lockstep=lockstepPackages(metaDeps,target),changes=[...applyBumps(pkg,target,lockstep),...applyRuntimePins(pkg,runtimePins,{exact:options.allowDowngrade}),...applyCraftFloor(pkg,craftPins)],installedPins=declaredPins(pkg,[...Object.keys(runtimePins),...Object.keys(craftPins)]),projectManifestChanges=migratePackageProjectManifest(pkg),manifestContext={lockstep,metaDeps},manifestChanges=reconcileVendoredManifests(projectRoot,target,{dryRun:!0,context:manifestContext}),backwards=(change)=>isDowngrade(change.from,change.to),forwards=changes.filter((change)=>!backwards(change)),downgrades=[...changes.filter(backwards).map((change)=>({...change,label:change.field?`${change.name} (${change.field})`:change.name,where:""})),...manifestChanges.filter(backwards).map((change)=>({...change,label:change.name,where:` ${change.file}`}))];if(forwards.length>0){console.log(" The following dependencies will be updated:");const reported=forwards.map((change)=>({...change,label:change.field?`${change.name} (${change.field})`:change.name})),width=Math.max(...reported.map((c)=>c.label.length));for(const c of reported)console.log(` ${c.label.padEnd(width)} ${c.from} \u2192 ${c.to}`);console.log("")}const vendoredForwards=manifestChanges.filter((change)=>!backwards(change));if(vendoredForwards.length>0){console.log(` Vendored manifests under storage/framework (${vendoredForwards.length}):`);const width=Math.max(...vendoredForwards.map((c)=>c.name.length));for(const c of vendoredForwards)console.log(` ${c.name.padEnd(width)} ${c.from} \u2192 ${c.to} ${c.file}`);console.log("")}if(downgrades.length>0){const verb=options.allowDowngrade?"will be downgraded":"would be downgraded";console.log(` The following dependencies ${verb}, because stacks@${target} declares older versions than this app does:`);const width=Math.max(...downgrades.map((c)=>c.label.length));for(const c of downgrades)console.log(` ${c.label.padEnd(width)} ${c.from} \u2192 ${c.to} (downgrade)${c.where}`);console.log("");if(!options.allowDowngrade){const advice=options.version?[` --version ${target} asks for an older release than this app declares. Re-run with --allow-downgrade to confirm it.
8
- `]:[" Wait for a framework release that declares these versions or newer, or re-run with --allow-downgrade to accept them."," Checking for one: `npm view stacks versions`, then `buddy upgrade --version <version> --dry-run`.\n"];if(options.dryRun){console.log(" A real run refuses this upgrade unless --allow-downgrade is passed.");console.log(advice.join(`
9
- `))}else{console.error(`\u2717 Refusing to downgrade ${downgrades.length} ${downgrades.length===1?"dependency":"dependencies"}. Nothing was written or installed.`);console.error(advice.join(`
3
+ `);const result=await runCommand(standalonePackageUpdateCommand(),{cwd:projectRoot});if(result.isErr){console.error("\n✗ The dependency refresh failed. Resolve the reported error and re-run `buddy update`.\n");process.exit(1)}console.log(`
4
+ ✔ Standalone package dependencies are up to date.
5
+ `);process.exit(0)}export function declaredPins(pkg,names){const declared={...pkg.devDependencies,...pkg.dependencies};const pins={};for(const name of names){const spec=declared[name];if(typeof spec==="string"&&/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec))pins[name]=baseVersion(spec)}return pins}async function resolveTarget(options){const res=await fetch("https://registry.npmjs.org/stacks").catch(()=>null);if(!res||!res.ok)throw new Error("Could not reach the npm registry to resolve the target `stacks` version.");const meta=await res.json();const distTags=meta["dist-tags"]??{};const versions=meta.versions??{};let version;if(options.version){if(!versions[options.version])throw new Error(`stacks@${options.version} was not found on the npm registry.`);version=options.version}else{const tag=options.canary?"canary":"latest";const resolved=distTags[tag];if(!resolved)throw new Error(`The \`${tag}\` dist-tag is not published for \`stacks\`.`);version=resolved}const metaDeps=versions[version]?.dependencies??{};const actions=await fetch(`https://registry.npmjs.org/@stacksjs%2factions/${version}`);if(!actions.ok)throw new Error(`Could not resolve the frontend dependencies shipped by @stacksjs/actions@${version}.`);const manifest=await actions.json();if(manifest.version!==version)throw new Error("The published actions manifest does not match the requested framework release.");return{version,metaDeps,runtimePins:await resolvePublishedRuntimePins(manifest.dependencies??{}),craftFloor:craftFloor(manifest)}}export function publishedRuntimePins(dependencies){const pins={};for(const name of["@stacksjs/stx","@stacksjs/components","bun-plugin-stx","@stacksjs/desktop","@stacksjs/sanitizer","stx-router"]){const version=dependencies[name];if(version&&/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(version))pins[name]=version}return pins}export async function resolvePublishedRuntimePins(dependencies,read=fetch){const pins=publishedRuntimePins(dependencies);const version=pins["@stacksjs/stx"];if(!version)return pins;const response=await read(`https://registry.npmjs.org/@stacksjs%2fstx/${version}`);if(!response.ok)throw new Error(`Could not resolve the runtime dependencies shipped by @stacksjs/stx@${version}.`);const manifest=await response.json();if(manifest.name!=="@stacksjs/stx"||manifest.version!==version)throw new Error("The published STX manifest does not match the requested runtime release.");for(const[name,target]of Object.entries(publishedRuntimePins(manifest.dependencies??{}))){if(pins[name]&&pins[name]!==target)throw new Error(`The published framework and STX manifests disagree on ${name}.`);pins[name]=target}return pins}export function keepsNewerRelease(spec,target){const declared=baseVersion(spec);const plain=/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/;return plain.test(declared)&&plain.test(target)&&Bun.semver.order(declared,target)>=0&&Bun.semver.satisfies(declared,`^${target}`)}export function applyRuntimePins(pkg,pins,options={}){const changes=[];for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(!declarations||typeof declarations!=="object"||Array.isArray(declarations))continue;for(const[name,target]of Object.entries(pins)){const spec=declarations[name];if(typeof spec!=="string"||!/^[\^~]?\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec))continue;if(!options.exact&&keepsNewerRelease(spec,target))continue;const next=`${/^[\^~]/.test(spec)?spec[0]:""}${target}`;if(next===spec)continue;changes.push({name,from:spec,to:next,...field==="overrides"||field==="resolutions"?{field}:{}});declarations[name]=next}}return changes}export function isCraftPackage(name){return name==="craft-native"||/^@craft-native\/[a-z0-9][\w.-]*$/.test(name)}export function craftFloor(manifest){const range=manifest.peerDependencies?.["craft-native"]??manifest.dependencies?.["craft-native"];return range?.match(/^>=\s*(\d+\.\d+\.\d+)$/)?.[1]}export function declaredCraftPackages(pkg){const names=new Set;for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(declarations&&typeof declarations==="object"&&!Array.isArray(declarations))Object.keys(declarations).filter(isCraftPackage).forEach((name)=>names.add(name))}return[...names].sort()}export async function resolveCraftPins(pkg,floor,read=fetch){const pins={};if(!floor)return pins;for(const name of declaredCraftPackages(pkg)){const response=await read(`https://registry.npmjs.org/${name.replace("/","%2f")}/${floor}`).catch(()=>null);const manifest=response?.ok?await response.json().catch(()=>null):null;if(manifest?.name===name&&manifest.version===floor)pins[name]=floor;else console.warn(` ${name}@${floor} is not published; leaving ${name} as declared.`)}return pins}export function applyCraftFloor(pkg,pins){const changes=[];for(const field of["dependencies","devDependencies","overrides","resolutions"]){const declarations=pkg[field];if(!declarations||typeof declarations!=="object"||Array.isArray(declarations))continue;for(const[name,floor]of Object.entries(pins)){const spec=declarations[name];const match=typeof spec==="string"?/^(\^|~|>=\s*)?(\d+\.\d+\.\d+(?:-[\w.-]+)?)$/.exec(spec):null;if(!match||Bun.semver.order(match[2],floor)>=0)continue;const next=`${(match[1]??"").replace(/\s+/,"")}${floor}`;changes.push({name,from:spec,to:next,...field==="overrides"||field==="resolutions"?{field}:{}});declarations[name]=next}}return changes}export function lockfileVersion(projectRoot){const path=join(projectRoot,"bun.lock");if(!existsSync(path))return null;const match=/"lockfileVersion"\s*:\s*(\d+)/.exec(readFileSync(path,"utf8"));return match?Number(match[1]):null}export function lockfileOnlyAddCommands(pkg,names){const wanted=new Set(names);const commands=[];for(const[field,flag]of[["dependencies",""],["devDependencies"," --dev"]]){const specs=Object.entries(pkg[field]??{}).filter(([name,spec])=>wanted.has(name)&&/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec)&&/^(?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*$/.test(name)).map(([name,spec])=>`${name}@${spec}`);if(specs.length)commands.push(`bun add --exact --lockfile-only${flag} ${specs.join(" ")}`)}return commands}export function baseVersion(range){return range.replace(/^[\^~>=<\s]+/,"").trim()}export function isDowngrade(from,to){const before=baseVersion(from);const after=baseVersion(to);const plain=/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/;return plain.test(before)&&plain.test(after)&&Bun.semver.order(after,before)<0}export function lockstepPackages(metaDeps,target){const lockstep=new Set(["stacks"]);for(const[name,range]of Object.entries(metaDeps)){if(name.startsWith("@stacksjs/")&&baseVersion(range)===target)lockstep.add(name)}return lockstep}export function applyBumps(pkg,target,lockstep){const changes=[];for(const field of["dependencies","devDependencies"]){const deps=pkg[field];if(!deps)continue;for(const[name,spec]of Object.entries(deps)){if(!lockstep.has(name))continue;const prefix=/^[\^~]/.test(spec)?spec[0]:/^\d/.test(spec)?"":"^";const next=`${prefix}${target}`;if(spec!==next){changes.push({name,from:spec,to:next});deps[name]=next}}}for(const field of["overrides","resolutions"]){const rules=pkg[field];if(!rules||typeof rules!=="object"||Array.isArray(rules))continue;for(const[name,spec]of Object.entries(rules)){if(!lockstep.has(name)||typeof spec!=="string"||!/^[\^~]?\d/.test(spec))continue;const next=resolveManifestSpec(name,spec,target);if(!next)continue;changes.push({name,from:spec,to:next,field});rules[name]=next}}return changes}export async function upgradeStacksPackages(projectRoot,options){const pkgPath=join(projectRoot,"package.json");if(!existsSync(pkgPath)){console.error("No package.json found - nothing to upgrade.");process.exit(1)}const raw=readFileSync(pkgPath,"utf-8");const pkg=JSON.parse(raw);const current=pkg.dependencies?.stacks??pkg.devDependencies?.stacks;if(!hasStacksDependency(pkg))return updateStandalonePackage(projectRoot,options);const{version:target,metaDeps,runtimePins,craftFloor:floor}=await resolveTarget(options).catch((err)=>{console.error(`✗ ${err.message}`);process.exit(1)});const craftPins=await resolveCraftPins(pkg,floor);console.log(`
6
+ Upgrading the Stacks framework${options.canary?" (canary)":""} → ${target}`);if(current)console.log(` current \`stacks\` constraint: ${current}
7
+ `);const lockstep=lockstepPackages(metaDeps,target);const changes=[...applyBumps(pkg,target,lockstep),...applyRuntimePins(pkg,runtimePins,{exact:options.allowDowngrade}),...applyCraftFloor(pkg,craftPins)];const installedPins=declaredPins(pkg,[...Object.keys(runtimePins),...Object.keys(craftPins)]);const projectManifestChanges=migratePackageProjectManifest(pkg);const manifestContext={lockstep,metaDeps};const manifestChanges=reconcileVendoredManifests(projectRoot,target,{dryRun:true,context:manifestContext});const backwards=(change)=>isDowngrade(change.from,change.to);const forwards=changes.filter((change)=>!backwards(change));const downgrades=[...changes.filter(backwards).map((change)=>({...change,label:change.field?`${change.name} (${change.field})`:change.name,where:""})),...manifestChanges.filter(backwards).map((change)=>({...change,label:change.name,where:` ${change.file}`}))];if(forwards.length>0){console.log(" The following dependencies will be updated:");const reported=forwards.map((change)=>({...change,label:change.field?`${change.name} (${change.field})`:change.name}));const width=Math.max(...reported.map((c)=>c.label.length));for(const c of reported)console.log(` ${c.label.padEnd(width)} ${c.from} → ${c.to}`);console.log("")}const vendoredForwards=manifestChanges.filter((change)=>!backwards(change));if(vendoredForwards.length>0){console.log(` Vendored manifests under storage/framework (${vendoredForwards.length}):`);const width=Math.max(...vendoredForwards.map((c)=>c.name.length));for(const c of vendoredForwards)console.log(` ${c.name.padEnd(width)} ${c.from} → ${c.to} ${c.file}`);console.log("")}if(downgrades.length>0){const verb=options.allowDowngrade?"will be downgraded":"would be downgraded";console.log(` The following dependencies ${verb}, because stacks@${target} declares older versions than this app does:`);const width=Math.max(...downgrades.map((c)=>c.label.length));for(const c of downgrades)console.log(` ${c.label.padEnd(width)} ${c.from} → ${c.to} (downgrade)${c.where}`);console.log("");if(!options.allowDowngrade){const advice=options.version?[` --version ${target} asks for an older release than this app declares. Re-run with --allow-downgrade to confirm it.
8
+ `]:[` Wait for a framework release that declares these versions or newer, or re-run with --allow-downgrade to accept them.`,` Checking for one: \`npm view stacks versions\`, then \`buddy upgrade --version <version> --dry-run\`.
9
+ `];if(options.dryRun){console.log(` A real run refuses this upgrade unless --allow-downgrade is passed.`);console.log(advice.join(`
10
+ `))}else{console.error(`✗ Refusing to downgrade ${downgrades.length} ${downgrades.length===1?"dependency":"dependencies"}. Nothing was written or installed.`);console.error(advice.join(`
10
11
  `));process.exit(1)}}}if(!options.dryRun&&manifestChanges.length>0)reconcileVendoredManifests(projectRoot,target,{context:manifestContext});if(projectManifestChanges.length>0)console.log(` Project manifest migrations: ${projectManifestChanges.length}
11
12
  `);if(options.dryRun){const pending=measureDefaultsDrift(projectRoot);if(pending&&pending.length>0){const installed=installedDefaultsVersion(projectRoot);console.log(` Managed project files, against the installed @stacksjs/defaults${installed?` (${installed})`:""}:`);console.log(` ${summarizeStructureChanges(pending)} in storage/framework/defaults and project support files
12
- `)}reportRouteActions(projectRoot,!0);console.log(` --dry-run: no files were written and nothing was installed.
13
+ `)}reportRouteActions(projectRoot,true);console.log(` --dry-run: no files were written and nothing was installed.
13
14
  `);process.exit(0)}if(changes.length>0||projectManifestChanges.length>0){const trailing=raw.endsWith(`
14
15
  `)?`
15
- `:"";writeFileSync(pkgPath,`${JSON.stringify(pkg,null,2)}${trailing}`);console.log("\u2714 Updated package.json")}if(options.noPostinstall){console.log(" --no-postinstall: skipping install. Run this to pull the new versions:");console.log(` ${frameworkPackageUpdateCommand(target)}
16
- `);process.exit(0)}const dependenciesNeedInstall=needsFrameworkInstall(projectRoot,target,installedPins);if(changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||options.force){console.log(` Installing\u2026
17
- `);const lockBefore=lockfileVersion(projectRoot);if(lockBefore!==null){for(const command of lockfileOnlyAddCommands(pkg,changes.filter((change)=>!change.field&&!lockstep.has(change.name)).map((change)=>change.name)))if((await runCommand(command,{cwd:projectRoot})).isErr){console.error(`
18
- \u2717 \`${command}\` failed. Your package.json was updated - resolve the error and re-run \`buddy upgrade --version ${target}\`.
19
- `);process.exit(1)}}const result=await runCommand(frameworkPackageUpdateCommand(target,options.force),{cwd:projectRoot}),lockAfter=lockfileVersion(projectRoot);if(lockBefore!==null&&lockAfter!==null&&lockAfter!==lockBefore)console.warn(` bun.lock moved from lockfileVersion ${lockBefore} to ${lockAfter}. If CI or the server runs an older Bun, restore it (\`git checkout bun.lock\`) and re-resolve only the changed packages with \`bun add --exact --lockfile-only <package>@<version>\`.`);if(result.isErr){console.error(`
20
- \u2717 The install step failed. Your package.json was updated - resolve the error and re-run \`buddy upgrade --version ${target}\`.
16
+ `:"";writeFileSync(pkgPath,`${JSON.stringify(pkg,null,2)}${trailing}`);console.log("✔ Updated package.json")}if(options.noPostinstall){console.log(" --no-postinstall: skipping install. Run this to pull the new versions:");console.log(` ${frameworkPackageUpdateCommand(target)}
17
+ `);process.exit(0)}const dependenciesNeedInstall=needsFrameworkInstall(projectRoot,target,installedPins);if(changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||options.force){console.log(` Installing…
18
+ `);const lockBefore=lockfileVersion(projectRoot);if(lockBefore!==null){for(const command of lockfileOnlyAddCommands(pkg,changes.filter((change)=>!change.field&&!lockstep.has(change.name)).map((change)=>change.name))){const added=await runCommand(command,{cwd:projectRoot});if(added.isErr){console.error(`
19
+ ✗ \`${command}\` failed. Your package.json was updated - resolve the error and re-run \`buddy upgrade --version ${target}\`.
20
+ `);process.exit(1)}}}const result=await runCommand(frameworkPackageUpdateCommand(target,options.force),{cwd:projectRoot});const lockAfter=lockfileVersion(projectRoot);if(lockBefore!==null&&lockAfter!==null&&lockAfter!==lockBefore)console.warn(` bun.lock moved from lockfileVersion ${lockBefore} to ${lockAfter}. If CI or the server runs an older Bun, restore it (\`git checkout bun.lock\`) and re-resolve only the changed packages with \`bun add --exact --lockfile-only <package>@<version>\`.`);if(result.isErr){console.error(`
21
+ ✗ The install step failed. Your package.json was updated - resolve the error and re-run \`buddy upgrade --version ${target}\`.
21
22
  `);process.exit(1)}}const installed=installedStacksVersion(projectRoot);if(installed!==target){console.error(`
22
- \u2717 Requested stacks@${target}, but the installed package reports ${installed??"no readable version"}. The installed files are retained for diagnosis; managed defaults were not synchronized.
23
- `);process.exit(1)}const defaultsPackageRoot=join(projectRoot,"node_modules/@stacksjs/defaults"),structureChanges=existsSync(join(defaultsPackageRoot,"package.json"))?syncPackageProjectFiles(projectRoot,defaultsPackageRoot):[],tsconfigChanges=migratePackageProjectTsconfig(projectRoot),prunedRoutes=reportRouteActions(projectRoot,!1);if(structureChanges.length>0||tsconfigChanges.length>0){const added=structureChanges.filter((change)=>change.action==="add").length,updated=structureChanges.filter((change)=>change.action==="update").length+tsconfigChanges.length,removed=structureChanges.filter((change)=>change.action==="remove").length;console.log(` Project structure: +${added} ~${updated} -${removed}`)}if(structureChanges.length>0)await regenerateAutoImports(projectRoot);if(changes.length>0||dependenciesNeedInstall||structureChanges.length>0||options.force)await regenerateDatabaseTypes(projectRoot);for(const provider of detectProjectAiProviders(projectRoot))if((await runCommand(`./buddy setup:ai ${provider} --force`,{cwd:projectRoot})).isErr){console.error(`
24
- \u2717 AI setup refresh failed for ${provider}. Re-run \`buddy setup:ai ${provider} --force\`.
25
- `);process.exit(1)}if(!(changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||structureChanges.length>0||tsconfigChanges.length>0||prunedRoutes>0)&&!options.force)console.log(`
26
- \u2714 Already up to date - dependencies and managed project files match the target.
23
+ ✗ Requested stacks@${target}, but the installed package reports ${installed??"no readable version"}. The installed files are retained for diagnosis; managed defaults were not synchronized.
24
+ `);process.exit(1)}const defaultsPackageRoot=join(projectRoot,"node_modules/@stacksjs/defaults");const structureChanges=existsSync(join(defaultsPackageRoot,"package.json"))?syncPackageProjectFiles(projectRoot,defaultsPackageRoot):[];const tsconfigChanges=migratePackageProjectTsconfig(projectRoot);const prunedRoutes=reportRouteActions(projectRoot,false);if(structureChanges.length>0||tsconfigChanges.length>0){const added=structureChanges.filter((change)=>change.action==="add").length;const updated=structureChanges.filter((change)=>change.action==="update").length+tsconfigChanges.length;const removed=structureChanges.filter((change)=>change.action==="remove").length;console.log(` Project structure: +${added} ~${updated} -${removed}`)}if(structureChanges.length>0)await regenerateAutoImports(projectRoot);if(changes.length>0||dependenciesNeedInstall||structureChanges.length>0||options.force)await regenerateDatabaseTypes(projectRoot);try{await runPostSyncAiRefresh({cli:["./buddy"],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions)})}catch(err){console.error(`
25
+ ✗ ${err.message}
26
+ `);process.exit(1)}const didChange=changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||structureChanges.length>0||tsconfigChanges.length>0||prunedRoutes>0;if(!didChange&&!options.force)console.log(`
27
+ ✔ Already up to date - dependencies and managed project files match the target.
27
28
  `);else console.log(`
28
- \u2714 Upgraded to stacks@${target}. Review the changelog: https://github.com/stacksjs/stacks/releases/tag/v${target}
29
+ ✔ Upgraded to stacks@${target}. Review the changelog: https://github.com/stacksjs/stacks/releases/tag/v${target}
29
30
  `);process.exit(0)}function reportRouteActions(projectRoot,dryRun){const pruned=pruneRetiredScaffoldRoutes(projectRoot,{dryRun});for(const route of pruned)console.log(` ${dryRun?"Would remove":"Removed"} ${route.file}:${route.line}, the scaffold route to ${route.action}: removed in ${route.removedIn}, ${route.reason}`);const dangling=findDanglingRouteActions(projectRoot);if(dangling.length>0){console.warn(`
30
31
  ${dangling.length} route${dangling.length===1?"":"s"} name${dangling.length===1?"s":""} an action this version does not ship. Point ${dangling.length===1?"it":"them"} at an action that exists, or delete ${dangling.length===1?"it":"them"}:`);for(const line of describeDanglingRouteActions(dangling).split(`
31
32
  `))console.warn(` ${line}`);console.warn("")}return pruned.length}async function regenerateAutoImports(projectRoot){const proc=Bun.spawn({cmd:[process.execPath,"-e","await (await import('@stacksjs/server')).generateAutoImportFiles()"],cwd:projectRoot,stdout:"ignore",stderr:"pipe"});if(await proc.exited!==0){const stderr=(await new Response(proc.stderr).text()).trim();console.warn(` auto-imports were not regenerated (non-fatal): ${stderr.split(`
32
- `).pop()||`exit ${proc.exitCode}`}`);return}console.log(" Regenerated auto-imports")}async function regenerateDatabaseTypes(projectRoot){const buddy=join(projectRoot,"buddy");if(!existsSync(buddy))return;try{if(await runPostSyncDatabaseTypesRefresh({cmd:[buddy,"generate:db-types"],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions),exists:existsSync}))console.log(" Regenerated database/types.d.ts")}catch(err){console.warn(` database/types.d.ts was not regenerated (non-fatal): ${err.message} Run \`./buddy generate:db-types\`.`)}}export function resolveManifestSpec(name,spec,target,context,members){if(name!=="stacks"&&!name.startsWith("@stacksjs/"))return null;if(spec.startsWith("workspace:")&&members?.has(name))return null;if(context&&!context.lockstep.has(name)){const declared=context.metaDeps[name];if(!declared)return null;return baseVersion(declared)===baseVersion(spec)?null:declared}if(spec.startsWith("workspace:"))return`^${target}`;if(baseVersion(spec)===target)return null;if(!/^[\^~]?\d/.test(spec))return null;return`${/^[\^~]/.test(spec)?spec[0]:""}${target}`}export function workspaceMembers(projectRoot){const members=new Set;let patterns=[];try{const root=JSON.parse(readFileSync(join(projectRoot,"package.json"),"utf-8"));patterns=((Array.isArray(root.workspaces)?root.workspaces:root.workspaces?.packages)??[]).filter((one)=>typeof one==="string")}catch{return members}const manifestsFor=(pattern)=>{return[...new Bun.Glob(`${pattern.replace(/\/+$/,"")}/package.json`).scanSync({cwd:projectRoot,onlyFiles:!0})].filter((file)=>!file.split("/").includes("node_modules"))},excluded=new Set(patterns.filter((one)=>one.startsWith("!")).flatMap((one)=>manifestsFor(one.slice(1))));for(const pattern of patterns.filter((one)=>!one.startsWith("!")))for(const file of manifestsFor(pattern)){if(excluded.has(file))continue;try{const name=JSON.parse(readFileSync(join(projectRoot,file),"utf-8")).name;if(typeof name==="string"&&name)members.add(name)}catch{}}return members}export function reconcileVendoredManifests(projectRoot,target,options={}){const root=join(projectRoot,"storage/framework");try{if(![join(projectRoot,"storage"),root].every((dir)=>lstatSync(dir).isDirectory()))return[]}catch{return[]}const changes=[],members=workspaceMembers(projectRoot),walk=(dir)=>{let entries;try{entries=readdirSync(dir)}catch{return}for(const entry of entries){if(entry==="node_modules"||entry==="dist"||entry===".git")continue;const full=join(dir,entry);let stat;try{stat=lstatSync(full)}catch{continue}if(stat.isSymbolicLink())continue;if(stat.isDirectory()){walk(full);continue}if(entry!=="package.json")continue;let raw;try{raw=readFileSync(full,"utf-8")}catch{continue}let pkg;try{pkg=JSON.parse(raw)}catch{continue}let touched=!1;for(const field of["dependencies","devDependencies"]){const deps=pkg[field];if(!deps)continue;for(const[name,spec]of Object.entries(deps)){const next=resolveManifestSpec(name,spec,target,options.context,members);if(!next)continue;changes.push({file:relative(projectRoot,full),name,from:spec,to:next});deps[name]=next;touched=!0}}if(touched&&!options.dryRun){const suffix=raw.endsWith(`
33
+ `).pop()||`exit ${proc.exitCode}`}`);return}console.log(" Regenerated auto-imports")}async function regenerateDatabaseTypes(projectRoot){const buddy=join(projectRoot,"buddy");if(!existsSync(buddy))return;try{const refreshed=await runPostSyncDatabaseTypesRefresh({cmd:[buddy,"generate:db-types"],projectRoot,spawn:(spawnOptions)=>Bun.spawn(spawnOptions),exists:existsSync});if(refreshed)console.log(" Regenerated database/types.d.ts")}catch(err){console.warn(` database/types.d.ts was not regenerated (non-fatal): ${err.message} Run \`./buddy generate:db-types\`.`)}}export function resolveManifestSpec(name,spec,target,context,members){if(name!=="stacks"&&!name.startsWith("@stacksjs/"))return null;if(spec.startsWith("workspace:")&&members?.has(name))return null;if(context&&!context.lockstep.has(name)){const declared=context.metaDeps[name];if(!declared)return null;return baseVersion(declared)===baseVersion(spec)?null:declared}if(spec.startsWith("workspace:"))return`^${target}`;if(baseVersion(spec)===target)return null;if(!/^[\^~]?\d/.test(spec))return null;const prefix=/^[\^~]/.test(spec)?spec[0]:"";return`${prefix}${target}`}export function workspaceMembers(projectRoot){const members=new Set;let patterns=[];try{const root=JSON.parse(readFileSync(join(projectRoot,"package.json"),"utf-8"));const declared=Array.isArray(root.workspaces)?root.workspaces:root.workspaces?.packages;patterns=(declared??[]).filter((one)=>typeof one==="string")}catch{return members}const manifestsFor=(pattern)=>{const glob=new Bun.Glob(`${pattern.replace(/\/+$/,"")}/package.json`);return[...glob.scanSync({cwd:projectRoot,onlyFiles:true})].filter((file)=>!file.split("/").includes("node_modules"))};const excluded=new Set(patterns.filter((one)=>one.startsWith("!")).flatMap((one)=>manifestsFor(one.slice(1))));for(const pattern of patterns.filter((one)=>!one.startsWith("!"))){for(const file of manifestsFor(pattern)){if(excluded.has(file))continue;try{const name=JSON.parse(readFileSync(join(projectRoot,file),"utf-8")).name;if(typeof name==="string"&&name)members.add(name)}catch{}}}return members}export function reconcileVendoredManifests(projectRoot,target,options={}){const root=join(projectRoot,"storage/framework");try{if(![join(projectRoot,"storage"),root].every((dir)=>lstatSync(dir).isDirectory()))return[]}catch{return[]}const changes=[];const members=workspaceMembers(projectRoot);const walk=(dir)=>{let entries;try{entries=readdirSync(dir)}catch{return}for(const entry of entries){if(entry==="node_modules"||entry==="dist"||entry===".git")continue;const full=join(dir,entry);let stat;try{stat=lstatSync(full)}catch{continue}if(stat.isSymbolicLink())continue;if(stat.isDirectory()){walk(full);continue}if(entry!=="package.json")continue;let raw;try{raw=readFileSync(full,"utf-8")}catch{continue}let pkg;try{pkg=JSON.parse(raw)}catch{continue}let touched=false;for(const field of["dependencies","devDependencies"]){const deps=pkg[field];if(!deps)continue;for(const[name,spec]of Object.entries(deps)){const next=resolveManifestSpec(name,spec,target,options.context,members);if(!next)continue;changes.push({file:relative(projectRoot,full),name,from:spec,to:next});deps[name]=next;touched=true}}if(touched&&!options.dryRun){const suffix=raw.endsWith(`
33
34
  `)?`
34
35
  `:"";writeFileSync(full,`${JSON.stringify(pkg,null,2)}${suffix}`)}}};walk(root);return changes}
@@ -1,5 +1,5 @@
1
- import{existsSync,readdirSync,readFileSync,statSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";export const RETIRED_SCAFFOLD_ROUTES=[{file:"routes/buddy.ts",statement:"route.get('/commands', 'Actions/Buddy/CommandsAction')",action:"Actions/Buddy/CommandsAction",removedIn:"0.74.5",reason:"the hand-written commands endpoint was dropped for `buddy list --json` (stacksjs/stacks#2056)"},{file:"routes/buddy.ts",statement:"route.get('/jobs', 'Actions/Buddy/JobsListAction')",action:"Actions/Buddy/JobsListAction",removedIn:"0.75.483",reason:"the dashboard lists jobs from /api/dashboard/jobs, and this duplicate read both job tables whole (stacksjs/stacks#3203)"}];export function actionRoots(projectRoot){return[join(projectRoot,"app"),join(projectRoot,"storage/framework/defaults/app"),join(projectRoot,"node_modules/@stacksjs/defaults/app")]}export function actionResolves(projectRoot,action){return actionRoots(projectRoot).some((root)=>[".ts",".js"].some((extension)=>existsSync(join(root,`${action}${extension}`))))}function routeFiles(dir){if(!existsSync(dir))return[];const files=[];for(const entry of readdirSync(dir)){const path=join(dir,entry);if(statSync(path).isDirectory())files.push(...routeFiles(path));else if(/\.[cm]?ts$/.test(entry)&&!entry.endsWith(".d.ts"))files.push(path)}return files.sort()}function withoutLineComment(line){let quote=null;for(let i=0;i<line.length;i++){const char=line[i];if(quote){if(char==="\\")i++;else if(char===quote)quote=null;continue}if(char==="'"||char==='"'||char==="`")quote=char;else if(char==="/"&&line[i+1]==="/")return line.slice(0,i)}return line}const normalize=(statement)=>statement.replace(/\s+/g,"").replace(/;$/,"");export function findDanglingRouteActions(projectRoot){const dangling=[];for(const path of routeFiles(join(projectRoot,"routes")))readFileSync(path,"utf8").split(`
2
- `).forEach((line,index)=>{const code=withoutLineComment(line);if(/^\s*(?:\*|\/\*)/.test(code))return;for(const match of code.matchAll(/(['"`])(Actions\/[\w/.-]+)\1/g)){const action=match[2];if(!actionResolves(projectRoot,action))dangling.push({file:relative(projectRoot,path),line:index+1,action})}});return dangling}export function pruneRetiredScaffoldRoutes(projectRoot,options={}){const pruned=[];for(const retired of RETIRED_SCAFFOLD_ROUTES){const path=join(projectRoot,retired.file);if(!existsSync(path)||actionResolves(projectRoot,retired.action))continue;const lines=readFileSync(path,"utf8").split(`
3
- `),kept=lines.filter((line,index)=>{if(normalize(withoutLineComment(line))!==normalize(retired.statement))return!0;pruned.push({file:retired.file,line:index+1,action:retired.action,removedIn:retired.removedIn,reason:retired.reason});return!1});if(kept.length!==lines.length&&!options.dryRun)writeFileSync(path,kept.join(`
1
+ import{existsSync,readdirSync,readFileSync,statSync,writeFileSync}from"node:fs";import{join,relative}from"node:path";export const RETIRED_SCAFFOLD_ROUTES=[{file:"routes/buddy.ts",statement:`route.get('/commands', 'Actions/Buddy/CommandsAction')`,action:"Actions/Buddy/CommandsAction",removedIn:"0.74.5",reason:"the hand-written commands endpoint was dropped for `buddy list --json` (stacksjs/stacks#2056)"},{file:"routes/buddy.ts",statement:`route.get('/jobs', 'Actions/Buddy/JobsListAction')`,action:"Actions/Buddy/JobsListAction",removedIn:"0.75.483",reason:"the dashboard lists jobs from /api/dashboard/jobs, and this duplicate read both job tables whole (stacksjs/stacks#3203)"}];export function actionRoots(projectRoot){return[join(projectRoot,"app"),join(projectRoot,"storage/framework/defaults/app"),join(projectRoot,"node_modules/@stacksjs/defaults/app")]}export function actionResolves(projectRoot,action){return actionRoots(projectRoot).some((root)=>[".ts",".js"].some((extension)=>existsSync(join(root,`${action}${extension}`))))}function routeFiles(dir){if(!existsSync(dir))return[];const files=[];for(const entry of readdirSync(dir)){const path=join(dir,entry);if(statSync(path).isDirectory())files.push(...routeFiles(path));else if(/\.[cm]?ts$/.test(entry)&&!entry.endsWith(".d.ts"))files.push(path)}return files.sort()}function withoutLineComment(line){let quote=null;for(let i=0;i<line.length;i++){const char=line[i];if(quote){if(char==="\\")i++;else if(char===quote)quote=null;continue}if(char==="'"||char==='"'||char==="`")quote=char;else if(char==="/"&&line[i+1]==="/")return line.slice(0,i)}return line}const normalize=(statement)=>statement.replace(/\s+/g,"").replace(/;$/,"");export function findDanglingRouteActions(projectRoot){const dangling=[];for(const path of routeFiles(join(projectRoot,"routes"))){const lines=readFileSync(path,"utf8").split(`
2
+ `);lines.forEach((line,index)=>{const code=withoutLineComment(line);if(/^\s*(?:\*|\/\*)/.test(code))return;for(const match of code.matchAll(/(['"`])(Actions\/[\w/.-]+)\1/g)){const action=match[2];if(!actionResolves(projectRoot,action))dangling.push({file:relative(projectRoot,path),line:index+1,action})}})}return dangling}export function pruneRetiredScaffoldRoutes(projectRoot,options={}){const pruned=[];for(const retired of RETIRED_SCAFFOLD_ROUTES){const path=join(projectRoot,retired.file);if(!existsSync(path)||actionResolves(projectRoot,retired.action))continue;const lines=readFileSync(path,"utf8").split(`
3
+ `);const kept=lines.filter((line,index)=>{if(normalize(withoutLineComment(line))!==normalize(retired.statement))return true;pruned.push({file:retired.file,line:index+1,action:retired.action,removedIn:retired.removedIn,reason:retired.reason});return false});if(kept.length!==lines.length&&!options.dryRun)writeFileSync(path,kept.join(`
4
4
  `))}return pruned}export function describeDanglingRouteActions(references){return references.map((ref)=>`${ref.file}:${ref.line} names ${ref.action}, which no longer exists`).join(`
5
5
  `)}
@@ -1,4 +1,4 @@
1
- import{$}from"bun";import process from"node:process";import{italic}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{path as p}from"@stacksjs/path";import{writeFile}from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";const homePath=(await $`echo $HOME`.text()).trim(),zshrcPath=p.join(homePath,".zshrc"),pluginPath=p.shellPath("src/buddy.plugin.zsh"),customPath=p.join(homePath,".oh-my-zsh/custom/plugins/buddy/");log.info(`Setting up Oh My Zsh via ${zshrcPath}...`);$.cwd(p.dirname(zshrcPath));let data=await $`cat ${p.basename(zshrcPath)}`.text();const pluginLineRegex=/^(?!#).*plugins=\(([^)]+)\)/m,match=data.match(pluginLineRegex);if(match){const plugins=match[1]?.split(/\s+/).filter(Boolean);if(!plugins){await log.error("Maybe the plugins line in your .zshrc file could not be found? If this continues being an issue, please reach out to us on Discord.");process.exit(ExitCode.FatalError)}if(!plugins.includes("buddy")){plugins.push("buddy");const newPluginLine=`plugins=(
2
- ${plugins.map((plugin)=>plugin.trim()).join(`
3
- `)}
4
- )`;data=data.replace(pluginLineRegex,newPluginLine);await writeFile(zshrcPath,data);log.info(`Copying buddy zsh plugin ${pluginPath} to ${customPath}...`);await $`mkdir -p ${customPath}`;await $`cp -rf ${pluginPath} ${customPath}`;log.success("Copied buddy zsh plugin")}else{log.info("Buddy is already set up");log.info("Ensuring `buddy` is updated...");await $`cp -rf ${pluginPath} ${customPath}`;log.success("Updated buddy zsh plugin to latest version")}}log.success("Oh My Zsh Setup Complete");log.info(italic("To see changes reflect, you may need to open a new terminal window"));if(process.env.TERM_PROGRAM==="vscode")log.info("\u2318\u21E7P terminal.create.new.terminal");
1
+ import{$}from"bun";import process from"node:process";import{italic}from"@stacksjs/cli";import{log}from"@stacksjs/logging";import{path as p}from"@stacksjs/path";import{writeFile}from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";const homePath=(await $`echo $HOME`.text()).trim();const zshrcPath=p.join(homePath,".zshrc");const pluginPath=p.shellPath("src/buddy.plugin.zsh");const customPath=p.join(homePath,".oh-my-zsh/custom/plugins/buddy/");log.info(`Setting up Oh My Zsh via ${zshrcPath}...`);$.cwd(p.dirname(zshrcPath));let data=await $`cat ${p.basename(zshrcPath)}`.text();const pluginLineRegex=/^(?!#).*plugins=\(([^)]+)\)/m;const match=data.match(pluginLineRegex);if(match){const plugins=match[1]?.split(/\s+/).filter(Boolean);if(!plugins){await log.error("Maybe the plugins line in your .zshrc file could not be found? If this continues being an issue, please reach out to us on Discord.");process.exit(ExitCode.FatalError)}if(!plugins.includes("buddy")){plugins.push("buddy");const formattedPlugins=plugins.map((plugin)=>plugin.trim()).join(`
2
+ `);const newPluginLine=`plugins=(
3
+ ${formattedPlugins}
4
+ )`;data=data.replace(pluginLineRegex,newPluginLine);await writeFile(zshrcPath,data);log.info(`Copying buddy zsh plugin ${pluginPath} to ${customPath}...`);await $`mkdir -p ${customPath}`;await $`cp -rf ${pluginPath} ${customPath}`;log.success("Copied buddy zsh plugin")}else{log.info("Buddy is already set up");log.info("Ensuring `buddy` is updated...");await $`cp -rf ${pluginPath} ${customPath}`;log.success("Updated buddy zsh plugin to latest version")}}log.success("Oh My Zsh Setup Complete");log.info(italic("To see changes reflect, you may need to open a new terminal window"));if(process.env.TERM_PROGRAM==="vscode")log.info("⌘⇧P terminal.create.new.terminal");
package/dist/upgrade.js CHANGED
@@ -1 +1 @@
1
- import{readFileSync}from"node:fs";import process from"node:process";import{intro,outro,runCommand}from"@stacksjs/cli";import{NpmScript}from"@stacksjs/enums";import{log}from"@stacksjs/logging";import{projectPath}from"@stacksjs/path";import*as storage from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";const{version}=JSON.parse(readFileSync(new URL("../package.json",import.meta.url),"utf8"));export function checkForUncommittedChanges(options){try{console.log("checkForUncommittedChanges",options)}catch(error){console.error(error)}}export async function downloadFrameworkUpdate(options){const tempFolderName="updates",tempUpdatePath=projectPath(tempFolderName);if(storage.doesFolderExist(tempUpdatePath)){const cleared=await storage.deleteFolder(tempUpdatePath);if(cleared.isErr)throw Error(`Could not clear ${tempUpdatePath} before downloading the update: ${cleared.error.message}`)}log.info("Downloading framework updates...");await runCommand(`giget stacks ${tempFolderName}`,options);log.success(`Your framework updated correctly to version: v${version}`)}export async function updateDependencies(){const perf=await intro("buddy upgrade:dependencies"),result=await runCommand(NpmScript.UpgradeDependencies,{cwd:projectPath()});if(result.isErr){await outro("While running the upgrade:dependencies command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}await outro("Freshly updated your dependencies.",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)}
1
+ import{readFileSync}from"node:fs";import process from"node:process";import{intro,outro,runCommand}from"@stacksjs/cli";import{NpmScript}from"@stacksjs/enums";import{log}from"@stacksjs/logging";import{projectPath}from"@stacksjs/path";import*as storage from"@stacksjs/storage";import{ExitCode}from"@stacksjs/types";const{version}=JSON.parse(readFileSync(new URL("../package.json",import.meta.url),"utf8"));export function checkForUncommittedChanges(options){try{console.log("checkForUncommittedChanges",options)}catch(error){console.error(error)}}export async function downloadFrameworkUpdate(options){const tempFolderName="updates";const tempUpdatePath=projectPath(tempFolderName);if(storage.doesFolderExist(tempUpdatePath)){const cleared=await storage.deleteFolder(tempUpdatePath);if(cleared.isErr)throw new Error(`Could not clear ${tempUpdatePath} before downloading the update: ${cleared.error.message}`)}log.info("Downloading framework updates...");await runCommand(`giget stacks ${tempFolderName}`,options);log.success(`Your framework updated correctly to version: v${version}`)}export async function updateDependencies(){const perf=await intro("buddy upgrade:dependencies");const result=await runCommand(NpmScript.UpgradeDependencies,{cwd:projectPath()});if(result.isErr){await outro("While running the upgrade:dependencies command, there was an issue",{startTime:perf,useSeconds:true},result.error);process.exit(ExitCode.FatalError)}await outro("Freshly updated your dependencies.",{startTime:perf,useSeconds:true});process.exit(ExitCode.Success)}