@_linked/cli 1.8.1 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 1.9.0
+
+### Minor Changes
+
+- [#59](https://github.com/linked-cm/cli/pull/59) [`98dbb5a`](https://github.com/linked-cm/cli/commit/98dbb5a7767aed3ee1da62009c096eeb76b2c377) Thanks [@flyon](https://github.com/flyon)! - ESM-only. Dropped the CommonJS build; ships ES modules only (`type: module`, no `require` export condition, no `lib/cjs`). Fixed the root `types` field. CJS consumers on Node 22+ can `require()` it (sync ESM) or use dynamic `import()`.
+
+- [#59](https://github.com/linked-cm/cli/pull/59) [`647417b`](https://github.com/linked-cm/cli/commit/647417bdcfbd5603daeb02ffd9ddc94f702a960e) Thanks [@flyon](https://github.com/flyon)! - Standalone dev + template git-clone scaffolding:
+
+  - **Standalone dev resolution** — `createViteConfig` now detects when an app is NOT inside a workspace (lib-only npm install of `@_linked/*`) and resolves those deps via `import → lib/esm` (conditions `['module','node']`) instead of the `development → src` export they don't ship. Fixes "Failed to load `@_linked/server/shapes/LinkedServer`" on a clean install. Monorepo/workspace dev is unchanged.
+  - **`create-app` clones the template repo** — new apps are scaffolded by `git clone`-ing `linked-cm/app-template` (single source of truth, same repo CN's server-side project creation uses) instead of copying a bundled defaults tree. The bundled `defaults/app-with-backend` is removed.
+  - Removed the orphaned tsx `register`/`register-css-only` loaders (+ `tsx` dep); apps run plain `linked start` (Vite handles TS transform).
+
+## 1.8.2
+
+### Patch Changes
+
+- [#57](https://github.com/linked-cm/cli/pull/57) [`e8385bd`](https://github.com/linked-cm/cli/commit/e8385bd4d4287afd85fbb86d6d4d20b1ea7152a7) Thanks [@flyon](https://github.com/flyon)! - CLI sub-template imports updated to use `@_linked/core` instead of legacy
+  `lincd/...`:
+
+  - `defaults/shape.ts` — `Shape` + `NamedNode` from `@_linked/core`
+  - `defaults/package/src/package.ts` — `linkedPackage` from `@_linked/core/utils/Package` (clean 1:1 swap; `@_linked/core` exports it identically)
+  - `defaults/package/src/ontologies/example-ontology.ts` — `NamedNode` + `createNameSpace` from `@_linked/core` (unused `lincd-jsonld` import dropped)
+
+  **Important caveat — TODO comments inline in the template files explain**:
+  the `package.ts` template is a clean working swap. The `shape.ts` and
+  `ontologies/example-ontology.ts` templates' generated output **will fail
+  to compile** because `@_linked/core` doesn't export `NamedNode` or
+  `Literal` as runtime classes — the new framework architecture moved past
+  direct node construction. Templates need a rewrite to emit the modern
+  getter-only `@_linked/*` shape pattern (see `@_linked/schema/shapes/Person.ts`).
+  The import-path change is a deliberate signal-of-intent that lands
+  incomplete; the actual template rewrite is tracked as downstream
+  Shape-Builder / Ontology-Manager review work.
+
+  Users of `linked create shape Foo` and `linked create package Bar`: if you
+  hit "Cannot find name NamedNode" or "Cannot find name Literal" errors
+  in scaffolded files, you've hit the documented gap. The fix path is the
+  template rewrite, not reverting to legacy lincd.
+
+  Context: see create-now plan-011 report (docs/reports/009-legacy-lincd-eradication.md).
+
 ## 1.8.1
 
 ### Patch Changes

package/defaults/setup-publish/dual-branch/github/workflows/publish.yml

@@ -51,6 +51,9 @@ jobs:
           publish: npx changeset publish
           title: "chore: release"
           commit: "chore: release"
+        # npm auth uses the npm token below. Do NOT switch to OIDC trusted publishing
+        # (id-token: write + publishConfig.provenance) unless you FIRST register this package's
+        # trusted publisher on npmjs.com — otherwise publishes fail with 404 / permission errors.
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/defaults/setup-publish/github/workflows/publish.yml

@@ -48,6 +48,9 @@ jobs:
           publish: npx changeset publish
           title: 'chore: release'
           commit: 'chore: release'
+        # npm auth uses the npm token below. Do NOT switch to OIDC trusted publishing
+        # (id-token: write + publishConfig.provenance) unless you FIRST register this package's
+        # trusted publisher on npmjs.com — otherwise publishes fail with 404 / permission errors.
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/defaults/shape.ts

@@ -1,5 +1,11 @@
-import {Shape} from 'lincd/shapes/Shape';
-import {NamedNode} from 'lincd/models';
+// TODO(plan-1.5 / Phase 3 — Shape Builder review): @_linked/core does
+// not export NamedNode as a class. The template needs to be rewritten to
+// match the modern @_linked/* shape pattern — see packages/schema/src/
+// shapes/Person.ts (getter-only, no NamedNode annotation). Import paths
+// updated to @_linked/core to flag intent; current generated output
+// won't compile until the template + downstream tooling are updated.
+import {Shape} from '@_linked/core/shapes/Shape';
+import {NamedNode} from '@_linked/core';
 import {linkedShape} from '../package.js';
 
 @linkedShape

package/jest.config.cjs

@@ -1,9 +1,10 @@
 // Jest config for @_linked/cli unit tests.
 //
-// Tests target the compiled CJS output in lib/cjs, not raw src/. This avoids
-// configuring jest's ESM mode (notoriously fiddly with our mixed tsx/ESM
-// runtime) and keeps the test runner identical to what npm consumers see.
-// Run `yarn build` before `yarn test:unit` so lib/cjs exists.
+// The cli is now ESM-only (no lib/cjs). Rather than configure jest's ESM mode
+// (notoriously fiddly), tests import raw `src/` .ts and let babel-jest
+// transpile ESM→CJS. The `moduleNameMapper` below strips the `.js` suffix from
+// relative specifiers (src uses the published-output `./foo.js` convention) so
+// they resolve back to the `.ts` source.
 //
 // E2E specs live in tests/e2e/ and run under Playwright (see
 // playwright.config.ts), not Jest.
@@ -25,5 +26,8 @@ module.exports = {
       },
     ],
   },
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
 };

package/lib/esm/cli-methods.d.ts

@@ -1,4 +1,13 @@
-import { PackageDetails } from './interfaces';
+import type { PackageDetails } from './interfaces.js';
+/**
+ * Dynamically import the app's backend storage configuration. Tries the
+ * canonical `linked.backend.storage.{ts,js}` at app root first, then the
+ * earlier `backend-storage-config.{ts,js}` (Iter3), then the legacy
+ * `scripts/storage-config.js` (pre-rename). The fallback chain lets older
+ * app clones keep booting through the rename.
+ */
+import { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages } from './lifecycle.js';
+export { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages };
 export declare const createApp: (name: any, basePath?: string, options?: {
     appName?: string;
     appPrefix?: string;
@@ -10,8 +19,8 @@ export declare function logError(...errors: any[]): void;
 export declare function developPackage(target: any, mode: any): void;
 export declare function runOnPackagesGroupedByDependencies(lincdPackages: any, onBuildStack: (packageGroup: any, dependencies: any) => (pkg: PackageDetails) => Promise<any>, onStackEnd: any, sync?: boolean): Promise<void>;
 export declare function buildAll(options: any): void;
-export declare function getLincdPackages(rootPath?: string): PackageDetails[];
 export declare const createOntology: (prefix: any, uriBase?: any, basePath?: string) => Promise<void>;
+export declare const addLineToIndex: (line: any, insertMatchString: string, root?: string, insertAtStart?: boolean) => string;
 export declare const setNameVariables: (name: any) => {
     hyphenName: any;
     camelCaseName: any;
@@ -32,7 +41,6 @@ invalidImports?: Map<string, {
 }[]>) => Promise<boolean>;
 export declare const depCheckStaged: () => Promise<void>;
 export declare const depCheck: (packagePath?: string) => Promise<unknown>;
-export declare const ensureEnvironmentLoaded: () => Promise<void>;
 export declare const runScript: (scriptName: string, options: {
     spawn: boolean;
 }) => Promise<never>;

package/lib/esm/cli-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAoE5C,eAAO,MAAM,SAAS,GAAU,SAAI,EAAE,iBAAwB,EAAE,UAAS;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAM,kBAgL9J,CAAC;AAmBF,wBAAgB,IAAI,CAAC,GAAG,QAAQ,OAAA,QAK/B;AACD,wBAAgB,QAAQ,CAAC,GAAG,MAAM,OAAA,QAIjC;AACD,wBAAgB,cAAc,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA,QAyB1C;AA2CD,wBAAgB,kCAAkC,CAChD,aAAa,KAAA,EACb,YAAY,EAAE,CACZ,YAAY,KAAA,EACZ,YAAY,KAAA,KACT,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1C,UAAU,KAAA,EACV,IAAI,UAAQ,GACX,OAAO,CAAC,IAAI,CAAC,CAqNf;AA+ID,wBAAgB,QAAQ,CAAC,OAAO,KAAA,QAkU/B;AAkCD,wBAAgB,gBAAgB,CAAC,QAAQ,SAAgB,GAAG,cAAc,EAAE,CAyB3E;AAyCD,eAAO,MAAM,cAAc,GACzB,WAAM,EACN,aAAQ,EACR,iBAAwB,kBA6FzB,CAAC;AAuIF,eAAO,MAAM,gBAAgB,GAAa,SAAI;;;;;CAc7C,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,YAAY,cAaxB,CAAC;AACF,eAAO,MAAM,WAAW,GAAU,SAAI,EAAE,iBAAwB,kBA2B/D,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,SAAI,EAAE,iBAAwB,kBAmCtE,CAAC;AACF,eAAO,MAAM,eAAe,GAAU,SAAI,EAAE,iBAAwB,kBAuCnE,CAAC;AAKF,eAAO,MAAM,YAAY,GACvB,eAAc,MAA0B,EACxC,QAAO,MAAU,EAAE,wDAAwD;AAC3E,iBAAgB,GAAG,CAAC,MAAM,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAC,EAAE,CAAa,qBA4F9E,CAAC;AAEF,eAAO,MAAM,cAAc,qBAuB1B,CAAC;AACF,eAAO,MAAM,QAAQ,GAAU,cAAa,MAAsB,qBAwDjE,CAAC;AACF,eAAO,MAAM,uBAAuB,qBAoDnC,CAAC;AACF,eAAO,MAAM,SAAS,GACpB,YAAY,MAAM,EAClB,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,mBAoB1B,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,QAAQ,MAAM,EACd,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,kBA2G1B,CAAC;AACF,eAAO,MAAM,WAAW,GACtB,WAAU,OAAe,EACzB,iBAAkB,iBA8DnB,CAAC;AACF,eAAO,MAAM,QAAQ,sBAKpB,CAAC;AACF,eAAO,MAAM,aAAa,qBAiHzB,CAAC;AACF,eAAO,MAAM,YAAY,wBAiExB,CAAC;AAEF,eAAO,MAAM,eAAe,qBAoK3B,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAI,EACJ,aAAQ,EACR,iBAAwB,kBA4GzB,CAAC;AAqBF,eAAO,MAAM,QAAQ,GAAa,gBAAW,kBAuD5C,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,WAAM,EACN,YAAO,EACP,oBAA2B,EAC3B,aAAY,OAAc,iBAoN3B,CAAC;AACF,eAAO,MAAM,cAAc,GAAU,oBAA2B,kBAyB/D,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B,qBAWlE,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B;;EAelE,CAAC;AAEF,eAAO,IAAI,cAAc,GAAa,OAAM,OAAe,kBA0K1D,CAAC;AAsBF,eAAO,IAAI,cAAc,GACvB,SAAI,EACJ,UAAK,EACL,UAAK,EACL,oBAAe,oBA6DhB,CAAC;AAEF,eAAO,IAAI,YAAY,GACrB,SAAI,EACJ,WAAM,EACN,YAAO,EACP,wBAAuB,OAAe,EACtC,OAAM,OAAe,kBAqHtB,CAAC;AAeF,eAAO,IAAI,4BAA4B,GACrC,aAAQ,EACR,YAAO,EACP,iBAAY,EACZ,gBAAW,qBA4CZ,CAAC;AAOF,eAAO,IAAI,cAAc,GAAa,aAAQ,EAAE,YAAO,SAMtD,CAAC;AACF,eAAO,IAAI,YAAY,GAAmB,iBAAwB,kBA8FjE,CAAC;AAEF,eAAO,IAAI,wBAAwB,GAAa,gBAAW,EAAE,YAAO,SA6BnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,gBAAW,qBA8B/C,CAAC"}
+{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}

package/lib/esm/cli-methods.js

@@ -37,30 +37,12 @@ let dirname__ = typeof __dirname !== 'undefined'
  * `scripts/storage-config.js` (pre-rename). The fallback chain lets older
  * app clones keep booting through the rename.
  */
-function loadBackendStorageConfig() {
-    return __awaiter(this, void 0, void 0, function* () {
-        const cwd = process.cwd();
-        const candidates = [
-            // Iter4 canonical:
-            path.join(cwd, 'linked.backend.storage.ts'),
-            path.join(cwd, 'linked.backend.storage.js'),
-            // Iter3:
-            path.join(cwd, 'backend-storage-config.ts'),
-            path.join(cwd, 'backend-storage-config.js'),
-            path.join(cwd, 'scripts', 'backend-storage-config.js'),
-            path.join(cwd, 'scripts', 'backend-storage-config.ts'),
-            // legacy pre-rename:
-            path.join(cwd, 'scripts', 'storage-config.js'),
-        ];
-        for (const candidate of candidates) {
-            if (fs.existsSync(candidate)) {
-                return import(candidate);
-            }
-        }
-        console.warn(chalk.yellow('[linked.backend.storage] no linked.backend.storage.{ts,js} found at app root.'));
-        return undefined;
-    });
-}
+// Plan-011: extracted to ./lifecycle.ts so the Vite SSR loader doesn't
+// have to graph-walk the rest of cli-methods.ts (which contains many
+// dynamic imports Vite can't analyze). We import for internal callers
+// AND re-export so external consumers can keep importing from here.
+import { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages, } from './lifecycle.js';
+export { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages };
 var variables = {};
 /**
  * Prompt user for input
@@ -123,14 +105,26 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     if (!fs.existsSync(targetFolder)) {
         fs.mkdirSync(targetFolder);
     }
-    fs.copySync(path.join(dirname__, '..', '..', 'defaults', 'app-with-backend'), targetFolder);
+    // Scaffold from the canonical template repo (single source of truth; CN's
+    // server-side createProject clones the same repo). Shallow clone, then drop
+    // .git so the new app starts with clean history.
+    yield execPromise(`git clone --depth 1 https://github.com/linked-cm/app-template.git "${targetFolder}"`, false, false);
+    fs.removeSync(path.join(targetFolder, '.git'));
     //make sure the data folder exists (even though its empty).. copying empty folders does not work with fs.copySync
     fs.mkdirSync(path.join(targetFolder, 'data'), { recursive: true });
     fs.mkdirSync(path.join(targetFolder, 'data/uploads/resized'), {
         recursive: true,
     });
-    fs.renameSync(path.join(targetFolder, 'gitignore.template'), path.join(targetFolder, '.gitignore'));
-    fs.renameSync(path.join(targetFolder, 'yarnrc.yml.template'), path.join(targetFolder, '.yarnrc.yml'));
+    // The template repo now ships real dotfiles; guard the legacy
+    // `*.template` renames so they no-op when the dotfile already exists.
+    const gitignoreTemplate = path.join(targetFolder, 'gitignore.template');
+    if (fs.existsSync(gitignoreTemplate)) {
+        fs.renameSync(gitignoreTemplate, path.join(targetFolder, '.gitignore'));
+    }
+    const yarnrcTemplate = path.join(targetFolder, 'yarnrc.yml.template');
+    if (fs.existsSync(yarnrcTemplate)) {
+        fs.renameSync(yarnrcTemplate, path.join(targetFolder, '.yarnrc.yml'));
+    }
     // Mark the new app as a self-contained Yarn project root. Without this,
     // Yarn climbs ancestor dirs looking for the project root and may decide
     // a stray yarn.lock further up the tree is "the project" — aborting
@@ -842,29 +836,7 @@ function getLocalLincdModules(rootPath = './') {
         return pkg.path.indexOf('..\\') === -1;
     });
 }
-export function getLincdPackages(rootPath = process.cwd()) {
-    let pack = getPackageJSON(rootPath);
-    if (!pack || !pack.workspaces) {
-        const originalRoot = rootPath;
-        for (let i = 0; i <= 3; i++) {
-            rootPath = path.join(originalRoot, ...Array(i).fill('..'));
-            pack = getPackageJSON(rootPath);
-            if (pack && pack.workspaces) {
-                // log('Found workspace at '+packagePath);
-                break;
-            }
-        }
-    }
-    if (!pack || !pack.workspaces) {
-        // Standalone apps (scaffolded with `linked create-app`) don't have
-        // workspaces — that's expected, just no local packages to scan.
-        return [];
-    }
-    // console.log(pack.workspaces);
-    let res = [];
-    checkWorkspaces(rootPath, pack.workspaces, res);
-    return res;
-}
+// getLincdPackages moved to ./lifecycle.ts and re-exported above.
 function setVariable(name, replacement) {
     //prepare name for regexp
     name = name.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
@@ -927,7 +899,9 @@ export const createOntology = (prefix_1, uriBase_1, ...args_1) => __awaiter(void
         log(`Added an import of this file from ${chalk.magenta(indexPath)}`);
     }
 });
-const addLineToIndex = function (line, insertMatchString, root = process.cwd(), insertAtStart = false) {
+// Exported for Shape-Builder reuse (plan-010 T1d.4): CodeShapeSyncService adds
+// the `import './shapes/<Shape>.js';` line to a generated app package's index.
+export const addLineToIndex = function (line, insertMatchString, root = process.cwd(), insertAtStart = false) {
     //import ontology in index
     let indexPath = ['index.ts', 'index.tsx']
         .map((f) => path.join(root, 'src', f))
@@ -936,6 +910,11 @@ const addLineToIndex = function (line, insertMatchString, root = process.cwd(),
     });
     if (indexPath) {
         let indexContents = fs.readFileSync(indexPath, 'utf-8');
+        // Idempotent: if the exact line is already present, do nothing (re-running
+        // a shape edit must not append a duplicate import).
+        if (indexContents.split(/\n/g).some((l) => l.trim() === line.trim())) {
+            return indexPath;
+        }
         let lines = indexContents.split(/\n/g);
         let newContents;
         for (var key in lines) {
@@ -1158,6 +1137,17 @@ invalidImports = new Map()) {
     // Start checking each file in the source folder
     for (const file of dir) {
         const filename = path.join(sourceFolder, file);
+        // plan-011 §P7 — skip test sources. Test files (and their helpers/probes)
+        // are not part of the shipped ESM contract, so the missing-extension rule
+        // isn't load-bearing for them; enforcing it only blocks `linked build`
+        // (the real ESM-output gate stays in force for shipped source). This is
+        // what makes `linked build` green for packages whose tests use
+        // extensionless imports (e.g. @_linked/core).
+        if (/(?:^|[\\/])(?:tests?|__tests__|test-helpers)(?:[\\/]|$)/.test(filename) ||
+            /\.(?:test|spec)\.tsx?$/.test(file) ||
+            /^type-probe.*\.tsx?$/.test(file)) {
+            continue;
+        }
         // File is either a directory, or not a .ts(x)
         // INFO: For future use - if this part fails, it could be due to user permissions
         //  i.e. the program not having access to check the file metadata
@@ -1309,55 +1299,7 @@ export const depCheck = (...args_1) => __awaiter(void 0, [...args_1], void 0, fu
         });
     });
 });
-export const ensureEnvironmentLoaded = () => __awaiter(void 0, void 0, void 0, function* () {
-    if (!process.env.ENV_VARS_LOADED) {
-        //load env-cmd for development environment
-        let { GetEnvVars } = yield import('env-cmd');
-        let envCmdrcPath = path.join(process.cwd(), '.env-cmdrc.json');
-        if (!fs.existsSync(envCmdrcPath)) {
-            console.warn('No .env-cmdrc.json found in this folder. Are you running this command from the root of a LINCD app?');
-            process.exit();
-        }
-        let vars = yield GetEnvVars({
-            envFile: {
-                filePath: envCmdrcPath,
-            },
-        });
-        let environments = Object.keys(vars);
-        // Snapshot the original shell environment so it always takes highest priority
-        let shellEnv = Object.assign({}, process.env);
-        //if _main is present, load it first
-        if (environments.includes('_main')) {
-            process.env = Object.assign(Object.assign({}, process.env), vars._main);
-        }
-        //if --env is passed, load that environment
-        let args = process.argv.splice(2);
-        if (args.includes('--env')) {
-            let envIndex = args.indexOf('--env');
-            let env = args[envIndex + 1];
-            env.split(',').forEach((singleEnvironment) => {
-                if (environments.includes(singleEnvironment)) {
-                    console.log('Environment: ' + singleEnvironment);
-                    process.env = Object.assign(Object.assign({}, process.env), vars[singleEnvironment]);
-                }
-                else {
-                    console.warn('Environment ' +
-                        singleEnvironment +
-                        ' not found in .env-cmdrc.json. Available environments: ' +
-                        environments.join(', '));
-                }
-            });
-        }
-        else {
-            //chose development by default
-            process.env = Object.assign(Object.assign({}, process.env), vars.development);
-            console.log('No environment specified, using development');
-        }
-        // Re-apply original shell env vars so they always win over .env-cmdrc.json
-        process.env = Object.assign(Object.assign({}, process.env), shellEnv);
-        process.env.ENV_VARS_LOADED = 'true';
-    }
-});
+// ensureEnvironmentLoaded moved to ./lifecycle.ts and re-exported above.
 export const runScript = (scriptName, options) => __awaiter(void 0, void 0, void 0, function* () {
     //if spawn is not defined, default to true
     const spawn = options.spawn !== undefined ? options.spawn : true;
@@ -1392,8 +1334,8 @@ export const runMethod = (packageName, method, options) => __awaiter(void 0, voi
             linkedConfig.server.loadRoutes = () => __awaiter(void 0, void 0, void 0, function* () { return yield import(path.join(process.cwd(), 'src', 'routes.tsx')); });
         }
         //@ts-ignore
-        const ServerClass = (yield import('@_linked/server/shapes/LincdServer'))
-            .LincdServer;
+        const ServerClass = (yield import('@_linked/server/shapes/LinkedServer'))
+            .LinkedServer;
         yield loadBackendStorageConfig();
         let server = new ServerClass(linkedConfig);
         //init the server
@@ -1432,7 +1374,7 @@ export const runMethod = (packageName, method, options) => __awaiter(void 0, voi
         });
     }
     else {
-        //reuse the existing running LincdServer instance.
+        //reuse the existing running LinkedServer instance.
         //make a HTTP call
         //'/call/:pkg/:method',
         fetch(process.env.SITE_ROOT + '/call/' + packageName + '/' + method, {
@@ -1481,7 +1423,7 @@ export const startServer = (...args_1) => __awaiter(void 0, [...args_1], void 0,
     // hook.hook('.module.css', scssLoadcall);
     if (!ServerClass) {
         //@ts-ignore
-        ServerClass = (yield import('@_linked/server/shapes/LincdServer')).LincdServer;
+        ServerClass = (yield import('@_linked/server/shapes/LinkedServer')).LinkedServer;
     }
     yield loadBackendStorageConfig();
     // Set default loadAppComponent if not provided
@@ -1532,7 +1474,11 @@ export const buildApp = () => __awaiter(void 0, void 0, void 0, function* () {
 });
 export const buildFrontend = () => __awaiter(void 0, void 0, void 0, function* () {
     yield ensureEnvironmentLoaded();
-    const webpackAppConfig = yield (yield import('./config-webpack-app.js')).getWebpackAppConfig();
+    // @vite-ignore — the webpack build path is legacy code, only reached
+    // by `linked build-frontend` which is not part of the Vite dev/SSR
+    // flow. Tell Vite not to graph-walk into it so we don't emit
+    // import-analysis warnings for a file we never load via SSR.
+    const webpackAppConfig = yield (yield import(/* @vite-ignore */ './config-webpack-app.js')).getWebpackAppConfig();
     console.log(chalk.magenta(`🛠 Building ${process.env.NODE_ENV} frontend bundles`));
     yield new Promise((resolve, reject) => {
         webpack(webpackAppConfig, (err, stats) => __awaiter(void 0, void 0, void 0, function* () {