@antelopejs/core 1.18.2 → 1.19.0

package/dist/core/runtime/runtime-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../../../src/core/runtime/runtime-bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../../../src/core/runtime/runtime-bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/core/runtime/runtime-types.d.ts

@@ -2,7 +2,7 @@ import type { AntelopeLogging } from "@antelopejs/interface-core/config";
 import type { ExpandedModuleConfig, LoadedConfig } from "../config";
 import type { DownloaderRegistry } from "../downloaders";
 import type { NodeFileSystem } from "../filesystem";
-import type { ModuleCache, ModuleConfig, ModuleManager, ModuleManifest } from "../modules";
+import type { ModuleCache, ModuleConfig, ModuleLockMode, ModuleLockStore, ModuleManager, ModuleManifest } from "../modules";
 import type { RuntimePolicy } from "./runtime-policy";
 import type { ShutdownManager } from "./shutdown/index";
 export interface ModuleOverrideRef {
@@ -16,11 +16,13 @@ export interface ModuleManifestEntry {
 }
 export interface BuildOptions {
     verbose?: string[];
+    frozenModules?: boolean;
 }
 export interface NormalizedLoadedConfig extends LoadedConfig {
     cacheFolder: string;
     projectFolder: string;
     modules: Record<string, ExpandedModuleConfig>;
+    moduleLocks?: ModuleLockMode;
 }
 export interface ProjectRuntimeConfig {
     fs: NodeFileSystem;
@@ -29,12 +31,14 @@ export interface ProjectRuntimeConfig {
 export interface LoaderConfig {
     cacheFolder: string;
     projectFolder: string;
+    moduleLocks?: ModuleLockMode;
 }
 export interface LoaderContext {
     fs: NodeFileSystem;
     cache: ModuleCache;
     registry: DownloaderRegistry;
     projectFolder: string;
+    locks?: ModuleLockStore;
 }
 export type LoaderContextProvider = () => Promise<LoaderContext>;
 export interface PreparedProject {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/core",
-  "version": "1.18.2",
+  "version": "1.19.0",
   "description": "TypeScript framework extending hexagonal architecture across your application and its ecosystem through explicit contracts and replaceable modules.",
   "keywords": [
     "antelopejs",

package/skills/ajs-cli/SKILL.md

@@ -16,7 +16,7 @@ ajs project dev --watch      # reload modules when their files change (-w)
 ajs project dev -e production    # select an environment of antelope.config.ts (env: ANTELOPEJS_LAUNCH_ENV)
 ajs project dev -i           # REPL with the project loaded
 ajs project dev --inspect    # Node inspector (default 127.0.0.1:9229)
-ajs project build            # download & install modules, check they load, write .antelope/build/build.json
+ajs project build            # download & install modules, check they load and interface ranges, write .antelope/build/build.json (--frozen-modules in CI)
 ajs project start            # launch from the build artifact; --refresh-config re-resolves the config at start
 ajs project logging show|set # view/change logging settings
 ```
@@ -31,16 +31,20 @@ ajs project logging show|set # view/change logging settings
 ajs project modules list                 # configured modules + their sources (alias: ls; -j for JSON)
 ajs project modules add <modules...>     # add & download modules you name (-m, --mode package|git|local|dir; default package = npm)
 ajs project modules remove <modules...>  # remove from config (alias: rm; -f, --force)
-ajs project modules update [modules...]  # bump npm modules to their latest versions (--dry-run)
+ajs project modules update [modules...]  # bump npm modules to their latest versions and resolve their locks again (--dry-run)
 ajs project modules install              # add a provider module for every unresolved interface (-y: never ask)
 ```
 
 `add` in package mode accepts `<name>@<exact|range|dist-tag>`; without a spec it writes a caret range of the latest version. `add` does no interface resolution.
 
-`modules install` (not `add`) fixes **unresolved imports**, and despite its name it installs no npm dependencies: it finds the interfaces no loaded module implements, looks up their implementing modules in the interface repository, and writes the chosen one into `antelope.config.ts`. A single implementer is added without a question; with several it asks, or takes the first with `-y`.
+`modules install` (not `add`) fixes **unresolved imports**, and despite its name it installs no npm dependencies: it finds the interfaces no loaded module implements, looks up their implementing modules in the interface repository, and writes the chosen one into `antelope.config.ts`. A single implementer is added without a question; with several it asks, or takes the first with `-y`. It then checks interface ranges like `build`.
+
+`build` and `modules install` fail (exit `1`, no `build.json` written) with `Incompatible interface package resolution` when a module's declared range of an interface package excludes the shared copy, the same error `start` and `dev` raise. Fix it as the error says: update that module, or widen its range to the shared version (`^<version>`) and reinstall, or keep the module that provides the shared copy on a version within the range. Do not skip the build check. A module marked `optional: true` that would conflict only produces a warning, as `start` runs without it.
 
 Modules declared in `antelope.config.ts` are downloaded into `.antelope/cache` by `dev`, `build`, and `modules add`; a module's own npm dependencies install inside its cache folder.
 
+**Module locks.** The lockfile an npm module's package manager writes in its cache folder is recorded in `antelope-lock/<package>@<version>/` (`pnpm-lock.yaml`, `package-lock.json` or `yarn.lock`), and replayed on every later install, so the same commit installs the same dependency versions on every machine and every day. Commit `antelope-lock/` with `antelope.config.ts`. A locked range (`^1.0.0`) stays on its recorded version. Only `modules update` resolves the dependencies again (and drops the locks no environment uses, as `modules remove` does): that is how a dependency fix reaches the project, and its diff is the review. In CI and image builds run `ajs project build --frozen-modules` (env `ANTELOPEJS_FROZEN_MODULES`): it installs only from the locks and fails on an npm module without one. Git and local modules carry their own lockfiles and are not locked here.
+
 ## Embedded mode: no `ajs project`
 
 In **embedded** mode the host application (AdonisJS, Express, Fastify…) owns the process and starts the runtime itself with `createRuntime({ projectFolder, modules, uses })` from `@antelopejs/core`, calling `start()` and `stop()` from its own lifecycle (in AdonisJS, a service provider). Recognize it before running any `ajs project` command: **no `antelope.config.*`**, and a host file calls `createRuntime`.

package/skills/ajs-cli/cases.json

@@ -99,6 +99,21 @@
         "acceptable": ["antelopejs"],
         "mustMention": ["ajs project build", "ajs project start"]
       }
+    },
+    {
+      "id": "ajs-cli-module-locks-ci",
+      "area": "framework",
+      "style": "clean",
+      "prompt": "My antelope.config.ts pins @antelopejs/api to an exact version, yet a clean CI build installs newer interface packages than my laptop did yesterday. How do I make module installs reproducible?",
+      "expect": {
+        "skills": ["ajs-cli"],
+        "acceptable": ["antelopejs"],
+        "mustMention": [
+          "antelope-lock",
+          "--frozen-modules",
+          "ajs project modules update"
+        ]
+      }
     }
   ]
 }