@stacksjs/actions 0.75.13 → 0.75.15

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { StxLintConfig, StxLintReport, StxLintResult } from './lint/stx-gate';
+export type { RouteActionReference } from './upgrade/route-actions';
 export type { ProjectStructureChange } from './upgrade/package-project';
 export type { CrudField } from './scaffold-crud';
 export type { DiscoveredPackagesManifest, PackageStacksMeta } from './discover-packages';
@@ -39,6 +40,7 @@ export { DEFAULT_STX_LINT_CONFIG, loadStxLintConfig, runStxLint } from './lint/s
 // import. The cheap version-level check lives in @stacksjs/path, because the
 // boot path consults it and cannot depend on this package.
 export { measureDefaultsDrift, summarizeStructureChanges } from './upgrade/package-project';
+export { describeDanglingRouteActions, findDanglingRouteActions } from './upgrade/route-actions';
 export * from './setup/index';
 // makeFactory,
 export {

package/dist/index.js

@@ -1 +1 @@
-import{setActionRunner}from"@stacksjs/action-runner";import{runAction}from"./helpers";setActionRunner((action,options)=>runAction(action,options));export*from"./action";export{add as runAdd}from"./add";export{BlogAdminError,deleteBlogPost,getBlogPost,listBlogPosts,saveBlogPost,slugify as blogSlugify}from"./blog-admin";export{commit as runCommit}from"./commit";export*from"./dev";export*from"./generate";export*from"./helpers";export*from"./library";export{formatProject,lintFix,lintProject}from"./lint/lint";export{DEFAULT_STX_LINT_CONFIG,loadStxLintConfig,runStxLint}from"./lint/stx-gate";export{measureDefaultsDrift,summarizeStructureChanges}from"./upgrade/package-project";export*from"./setup";export{createComponent,createDatabase,createFactory,createFunction,createLanguage,createMiddleware,createMigration,createModel,createMail,createNotification,createPage,isDryRunActive,makeAction,makeCertificate,makeComponent,makeDatabase,makeFunction,makeLanguage,makeMail,makeNotification,makePage,makeQueueTable,makeStack,make as runMake,setDryRun}from"./make";export{discoverPackages,ensureDiscoveredPackages}from"./discover-packages";export{parseFields,scaffoldCrud}from"./scaffold-crud";export{installStack,uninstallStack,listStacks}from"./stacks";export{makeJob}from"./make-job";export{makeCommand}from"./make-command";export{makePolicy}from"./make-policy";export{makeResource}from"./make-resource";
+import{setActionRunner}from"@stacksjs/action-runner";import{runAction}from"./helpers";setActionRunner((action,options)=>runAction(action,options));export*from"./action";export{add as runAdd}from"./add";export{BlogAdminError,deleteBlogPost,getBlogPost,listBlogPosts,saveBlogPost,slugify as blogSlugify}from"./blog-admin";export{commit as runCommit}from"./commit";export*from"./dev";export*from"./generate";export*from"./helpers";export*from"./library";export{formatProject,lintFix,lintProject}from"./lint/lint";export{DEFAULT_STX_LINT_CONFIG,loadStxLintConfig,runStxLint}from"./lint/stx-gate";export{measureDefaultsDrift,summarizeStructureChanges}from"./upgrade/package-project";export{describeDanglingRouteActions,findDanglingRouteActions}from"./upgrade/route-actions";export*from"./setup";export{createComponent,createDatabase,createFactory,createFunction,createLanguage,createMiddleware,createMigration,createModel,createMail,createNotification,createPage,isDryRunActive,makeAction,makeCertificate,makeComponent,makeDatabase,makeFunction,makeLanguage,makeMail,makeNotification,makePage,makeQueueTable,makeStack,make as runMake,setDryRun}from"./make";export{discoverPackages,ensureDiscoveredPackages}from"./discover-packages";export{parseFields,scaffoldCrud}from"./scaffold-crud";export{installStack,uninstallStack,listStacks}from"./stacks";export{makeJob}from"./make-job";export{makeCommand}from"./make-command";export{makePolicy}from"./make-policy";export{makeResource}from"./make-resource";

package/dist/upgrade/framework.js

@@ -1,8 +1,9 @@
-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,runPostSyncDependencyRefresh,runPostSyncMigration,shouldRefreshPostSyncDependencies,shouldRunPostSyncHooks}from"./framework-hooks";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})}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),willResolveStable=!options.version&&!options.canary&&(!!options.stable||currentChannel!=="canary");let latestStableRef="";if(willResolveStable)latestStableRef=await resolveLatestStableTag()??(currentVersion?`v${currentVersion}`:"main");const ctx=resolveUpgradeContext(options,currentChannel,latestStableRef),explicitLocal=options.from?p.projectPath(options.from):null,detectedLocal=explicitLocal??(shouldAutoDetectLocalStacks(options)?detectLocalStacks(projectRoot):null),usingLocal=!!detectedLocal;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(`
+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,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})}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),willResolveStable=!options.version&&!options.canary&&(!!options.stable||currentChannel!=="canary");let latestStableRef="";if(willResolveStable)latestStableRef=await resolveLatestStableTag()??(currentVersion?`v${currentVersion}`:"main");const ctx=resolveUpgradeContext(options,currentChannel,latestStableRef),explicitLocal=options.from?p.projectPath(options.from):null,detectedLocal=explicitLocal??(shouldAutoDetectLocalStacks(options)?detectLocalStacks(projectRoot):null),usingLocal=!!detectedLocal;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(`
 \u26A0 The following framework-managed paths have uncommitted changes:`);for(const path of dirty)console.warn(`    - ${path}`);console.warn(`
   Aborting to avoid clobbering your edits.`);console.warn(`  Re-run with --force to overwrite, or commit / stash the changes first.
 `);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.
-`);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 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(`
+`);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(`
+`))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(`
   DRY RUN - preview only. No files will be written, nothing will be installed, no migrations will run.
 `);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(`
   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","migrations")))console.log("    - run pending migrations")}if(sawRemoved>0)console.log(`

package/dist/upgrade/packages.js

@@ -1,4 +1,4 @@
-import{existsSync,readdirSync,readFileSync,statSync,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{detectProjectAiProviders,measureDefaultsDrift,migratePackageProjectManifest,migratePackageProjectTsconfig,summarizeStructureChanges,syncPackageProjectFiles}from"./package-project";export function hasStacksDependency(pkg){return Boolean(pkg.dependencies?.stacks||pkg.devDependencies?.stacks)}export function standalonePackageUpdateCommand(){return"bun update"}export function frameworkPackageUpdateCommand(){return"bun update stacks"}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){return installedStacksVersion(projectRoot)!==target}async function updateStandalonePackage(projectRoot,options){console.log(`
+import{existsSync,readdirSync,readFileSync,statSync,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{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(){return"bun update stacks"}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){return installedStacksVersion(projectRoot)!==target}async function updateStandalonePackage(projectRoot,options){console.log(`
   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...
 `);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(`
 \u2714 Standalone package dependencies are up to date.
@@ -6,18 +6,20 @@ import{existsSync,readdirSync,readFileSync,statSync,writeFileSync}from"node:fs";
   Upgrading the Stacks framework${options.canary?" (canary)":""} \u2192 ${target}`);if(current)console.log(`  current \`stacks\` constraint: ${current}
 `);const lockstep=lockstepPackages(metaDeps,target),changes=applyBumps(pkg,target,lockstep),projectManifestChanges=migratePackageProjectManifest(pkg),manifestChanges=reconcileVendoredManifests(projectRoot,target,{dryRun:options.dryRun,context:{lockstep,metaDeps}});if(changes.length>0){console.log("  The following dependencies will be updated:");const width=Math.max(...changes.map((c)=>c.name.length));for(const c of changes)console.log(`    ${c.name.padEnd(width)}  ${c.from}  \u2192  ${c.to}`);console.log("")}if(manifestChanges.length>0){console.log(`  Vendored manifests under storage/framework (${manifestChanges.length}):`);const width=Math.max(...manifestChanges.map((c)=>c.name.length));for(const c of manifestChanges)console.log(`    ${c.name.padEnd(width)}  ${c.from}  \u2192  ${c.to}   ${c.file}`);console.log("")}if(projectManifestChanges.length>0)console.log(`  Project manifest migrations: ${projectManifestChanges.length}
 `);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
-`)}console.log(`  --dry-run: no files were written and nothing was installed.
+`)}reportRouteActions(projectRoot,!0);console.log(`  --dry-run: no files were written and nothing was installed.
 `);process.exit(0)}if(changes.length>0||projectManifestChanges.length>0){const trailing=raw.endsWith(`
 `)?`
 `:"";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()}
 `);process.exit(0)}const dependenciesNeedInstall=needsFrameworkInstall(projectRoot,target);if(changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||options.force){console.log(`  Installing\u2026
-`);if((await runCommand(frameworkPackageUpdateCommand(),{cwd:projectRoot})).isErr){console.error("\n\u2717 The install step failed. Your package.json was updated - resolve the error and re-run `bun update`.\n");process.exit(1)}}const defaultsPackageRoot=join(projectRoot,"node_modules/@stacksjs/defaults"),structureChanges=existsSync(join(defaultsPackageRoot,"package.json"))?syncPackageProjectFiles(projectRoot,defaultsPackageRoot):[],tsconfigChanges=migratePackageProjectTsconfig(projectRoot);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);for(const provider of detectProjectAiProviders(projectRoot))if((await runCommand(`./buddy setup:ai ${provider} --force`,{cwd:projectRoot})).isErr){console.error(`
+`);if((await runCommand(frameworkPackageUpdateCommand(),{cwd:projectRoot})).isErr){console.error("\n\u2717 The install step failed. Your package.json was updated - resolve the error and re-run `bun update`.\n");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);for(const provider of detectProjectAiProviders(projectRoot))if((await runCommand(`./buddy setup:ai ${provider} --force`,{cwd:projectRoot})).isErr){console.error(`
 \u2717 AI setup refresh failed for ${provider}. Re-run \`buddy setup:ai ${provider} --force\`.
-`);process.exit(1)}if(!(changes.length>0||manifestChanges.length>0||projectManifestChanges.length>0||dependenciesNeedInstall||structureChanges.length>0||tsconfigChanges.length>0)&&!options.force)console.log(`
+`);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(`
 \u2714 Already up to date - dependencies and managed project files match the target.
 `);else console.log(`
 \u2714 Upgraded to stacks@${target}. Review the changelog: https://github.com/stacksjs/stacks/releases/tag/v${target}
-`);process.exit(0)}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(`
+`);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(`
+  ${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(`
+`))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(`
 `).pop()||`exit ${proc.exitCode}`}`);return}console.log("  Regenerated auto-imports")}export function resolveManifestSpec(name,spec,target,context){if(name!=="stacks"&&!name.startsWith("@stacksjs/"))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 reconcileVendoredManifests(projectRoot,target,options={}){const root=join(projectRoot,"storage/framework");if(!existsSync(root))return[];const changes=[],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=statSync(full)}catch{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);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(`
 `)?`
 `:"";writeFileSync(full,`${JSON.stringify(pkg,null,2)}${suffix}`)}}};walk(root);return changes}

package/dist/upgrade/route-actions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Where an `'Actions/…'` handler can live: the app first, then the framework
+ * defaults, vendored or installed. The same order the router resolves in.
+ */
+export declare function actionRoots(projectRoot: string): string[];
+export declare function actionResolves(projectRoot: string, action: string): boolean;
+/**
+ * Every `'Actions/…'` string in the app's route files that resolves to no file.
+ *
+ * Literal handler strings only: a resource route composes its five names at
+ * runtime, and a `Controller@method` handler is not an action path.
+ */
+export declare function findDanglingRouteActions(projectRoot: string): RouteActionReference[];
+/**
+ * Remove the retired scaffold routes an app still carries, where it carries
+ * them unchanged and the action is gone. Returns what was (or, with `dryRun`,
+ * would be) removed.
+ */
+export declare function pruneRetiredScaffoldRoutes(projectRoot: string, options?: { dryRun?: boolean }): PrunedScaffoldRoute[];
+/** One line per reference, for the upgrade summary and `buddy doctor`. */
+export declare function describeDanglingRouteActions(references: RouteActionReference[]): string;
+export declare const RETIRED_SCAFFOLD_ROUTES: RetiredScaffoldRoute[];
+export declare interface RetiredScaffoldRoute {
+  file: string
+  statement: string
+  action: string
+  removedIn: string
+  reason: string
+}
+export declare interface RouteActionReference {
+  file: string
+  line: number
+  action: string
+}
+export declare interface PrunedScaffoldRoute extends RouteActionReference {
+  removedIn: string
+  reason: string
+}

package/dist/upgrade/route-actions.js

@@ -0,0 +1,5 @@
+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)"}];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(`
+`).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(`
+`),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(`
+`))}return pruned}export function describeDanglingRouteActions(references){return references.map((ref)=>`${ref.file}:${ref.line} names ${ref.action}, which no longer exists`).join(`
+`)}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/actions",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.13",
+  "version": "0.75.15",
   "description": "The Stacks actions.",
   "author": "Chris Breuer",
   "contributors": [
@@ -60,53 +60,53 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/action-runner": "0.75.13",
-    "@stacksjs/ai": "0.75.13",
-    "@stacksjs/analytics": "0.75.13",
-    "@stacksjs/api": "0.75.13",
-    "@stacksjs/auth": "0.75.13",
-    "@stacksjs/build": "0.75.13",
+    "@stacksjs/action-runner": "0.75.15",
+    "@stacksjs/ai": "0.75.15",
+    "@stacksjs/analytics": "0.75.15",
+    "@stacksjs/api": "0.75.15",
+    "@stacksjs/auth": "0.75.15",
+    "@stacksjs/build": "0.75.15",
     "@stacksjs/bumpx": "^0.2.6",
     "@stacksjs/bunpress": "^0.2.8",
-    "@stacksjs/cli": "0.75.13",
-    "@stacksjs/cloud": "0.75.13",
-    "@stacksjs/cms": "0.75.13",
-    "@stacksjs/components": "^0.2.320",
-    "@stacksjs/config": "0.75.13",
-    "@stacksjs/database": "0.75.13",
-    "@stacksjs/desktop-build": "0.75.13",
-    "@stacksjs/dns": "0.75.13",
-    "@stacksjs/enums": "0.75.13",
-    "@stacksjs/env": "0.75.13",
-    "@stacksjs/error-handling": "0.75.13",
+    "@stacksjs/cli": "0.75.15",
+    "@stacksjs/cloud": "0.75.15",
+    "@stacksjs/cms": "0.75.15",
+    "@stacksjs/components": "^0.2.321",
+    "@stacksjs/config": "0.75.15",
+    "@stacksjs/database": "0.75.15",
+    "@stacksjs/desktop-build": "0.75.15",
+    "@stacksjs/dns": "0.75.15",
+    "@stacksjs/enums": "0.75.15",
+    "@stacksjs/env": "0.75.15",
+    "@stacksjs/error-handling": "0.75.15",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/i18n": "0.75.13",
-    "@stacksjs/image": "0.75.13",
-    "@stacksjs/logging": "0.75.13",
+    "@stacksjs/i18n": "0.75.15",
+    "@stacksjs/image": "0.75.15",
+    "@stacksjs/logging": "0.75.15",
     "@stacksjs/logsmith": "^0.2.3",
-    "@stacksjs/orm": "0.75.13",
-    "@stacksjs/path": "0.75.13",
-    "@stacksjs/payments": "0.75.13",
-    "@stacksjs/queue": "0.75.13",
-    "@stacksjs/registry": "0.75.13",
-    "@stacksjs/router": "0.75.13",
+    "@stacksjs/orm": "0.75.15",
+    "@stacksjs/path": "0.75.15",
+    "@stacksjs/payments": "0.75.15",
+    "@stacksjs/queue": "0.75.15",
+    "@stacksjs/registry": "0.75.15",
+    "@stacksjs/router": "0.75.15",
     "@stacksjs/rpx": "^0.11.54",
-    "@stacksjs/scheduler": "0.75.13",
-    "@stacksjs/search-engine": "0.75.13",
-    "@stacksjs/security": "0.75.13",
-    "@stacksjs/server": "0.75.13",
-    "@stacksjs/sites": "0.75.13",
-    "@stacksjs/storage": "0.75.13",
-    "@stacksjs/strings": "0.75.13",
-    "@stacksjs/stx": "^0.2.320",
+    "@stacksjs/scheduler": "0.75.15",
+    "@stacksjs/search-engine": "0.75.15",
+    "@stacksjs/security": "0.75.15",
+    "@stacksjs/server": "0.75.15",
+    "@stacksjs/sites": "0.75.15",
+    "@stacksjs/storage": "0.75.15",
+    "@stacksjs/strings": "0.75.15",
+    "@stacksjs/stx": "^0.2.321",
     "@stacksjs/tlsx": "^0.13.19",
     "@stacksjs/ts-cloud": "^0.16.14",
     "@stacksjs/ts-md": "^0.1.1",
-    "@stacksjs/tunnel": "0.75.13",
-    "@stacksjs/types": "0.75.13",
-    "@stacksjs/utils": "0.75.13",
-    "@stacksjs/whois": "0.75.13",
-    "bun-plugin-stx": "^0.2.320"
+    "@stacksjs/tunnel": "0.75.15",
+    "@stacksjs/types": "0.75.15",
+    "@stacksjs/utils": "0.75.15",
+    "@stacksjs/whois": "0.75.15",
+    "bun-plugin-stx": "^0.2.321"
   },
   "peerDependencies": {
     "craft-native": ">=0.0.72",
@@ -121,7 +121,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.75.13",
+    "@stacksjs/validation": "0.75.15",
     "better-dx": "^0.2.24"
   }
 }