@memoarchitect/tools 0.13.0 → 0.15.0

package/packages/tools/lib/model/package-manifest.js

@@ -5,7 +5,7 @@
 // This file used to read `methodology`, `extends`, `ontologies`, `modules`,
 // `type`, and `usage`, and those fields decided what a project's model
 // contained. They do not any more. Selection is native: the project's SysML
-// import graph and its `ProjectMethodBinding` decide what is loaded, and
+// import graph and its `ModelMethodBinding` decide what is loaded, and
 // `settings-boundary.ts` rejects the removed fields with a diagnostic naming
 // their replacement rather than reading them as a fallback.
 //
@@ -22,7 +22,7 @@ import { parse as parseYaml } from 'yaml';
  * Descriptor filenames, in search order.
  *
  * `memo.config.yaml` is gone: it existed to carry project semantics, and every
- * field it carried now lives in `model/catalog/project.sysml`. A project that
+ * field it carried now lives in `model/methodology/project.sysml`. A project that
  * still has one is told so by `checkSemanticFields`.
  */
 export const CONFIG_SEARCH_ORDER = [
@@ -53,6 +53,7 @@ export function readManifest(filePath) {
         sysmlDir: str(doc.sysmlDir),
         entrypoint: str(doc.entrypoint),
         include: strList(doc.include),
+        dependencies: strMap(doc.dependencies),
         raw: doc,
     };
 }
@@ -88,6 +89,17 @@ function str(value) {
         return String(value);
     return undefined;
 }
+function strMap(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const out = {};
+    for (const [name, range] of Object.entries(value)) {
+        const text = str(range);
+        if (text)
+            out[name] = text;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
 function strList(value) {
     if (value === undefined || value === null)
         return undefined;

package/packages/tools/lib/model/package-manifest.js.map

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

package/packages/tools/lib/model/pinned.d.ts

@@ -0,0 +1,216 @@
+import type { MEMOConfig } from './config.js';
+import type { MemoModel } from './semantic.js';
+import type { BuilderRegistries } from './complete-model.js';
+import { Stage1RejectedError, type ProjectModel } from '../toolchain/project-model.js';
+import type { Diagnostic } from '../toolchain/diagnostic.js';
+import type { PinnedInfo } from '../protocol/messages.js';
+/** The folder of the layout a family uses for its systems, under each include root. */
+export declare const SYSTEMS_DIR = "systems";
+/** A project's repository: its top level and where the project sits in it. */
+export declare function findRepository(projectRoot: string): Promise<{
+    top: string;
+    subpath: string;
+}>;
+/** A commit checked out in a cached worktree. */
+export interface Pin {
+    /** What the caller asked for: a ref, or a commit. */
+    ref: string;
+    /** The full commit hash. */
+    sha: string;
+    /** The worktree: a checkout of the whole repository. */
+    dir: string;
+    /** The project inside the worktree. */
+    projectDir: string;
+    /** True when the worktree already existed and was reused. */
+    reused: boolean;
+    /** Milliseconds spent resolving and checking out. */
+    ms: number;
+}
+/** The commit a ref names. Throws when it names none. */
+export declare function resolveCommit(projectRoot: string, ref: string): Promise<string>;
+/** Whether `ancestor` is `descendant` or reachable from it. */
+export declare function isAncestor(projectRoot: string, ancestor: string, descendant: string): Promise<boolean>;
+/**
+ * The worktree of a commit, created once and reused while it is at that commit and unmodified.
+ * Nothing is ever written into the project's own checkout: the worktree is the only addition.
+ */
+export declare function pinWorktree(projectRoot: string, ref: string): Promise<Pin>;
+/** What a pinned build used, and cost. */
+export interface PinnedBuild {
+    project: ProjectModel;
+    /** The commits the model was built from. */
+    pins: {
+        name: string;
+        pin: Pin;
+    }[];
+    /** The directory the model was built in. */
+    projectDir: string;
+    compiler: string;
+    compilerVersion?: string;
+    /** The ontology packages the build resolved (today's installed ones; see the header). */
+    timings: {
+        checkoutMs: number;
+        assembleMs: number;
+        compileMs: number;
+    };
+}
+export interface BuildOptions {
+    /** Settings laid over the pinned tree's own (the compiler is the caller's choice). */
+    config?: Partial<MEMOConfig>;
+}
+/** The model at one commit or ref: a release's `modelCommit`, a tag, a branch. */
+export declare function buildAt(projectRoot: string, ref: string, options?: BuildOptions): Promise<PinnedBuild>;
+export interface ReleasePin {
+    /** The system folder name under `systems/`. */
+    system: string;
+    /** `<include root>/systems/<system>`, project-relative, with forward slashes. */
+    path: string;
+    commit: string;
+    /** The release record that names the commit, and the item it releases. */
+    record: string;
+    item: string;
+}
+export interface ReleasePins {
+    record: string;
+    commit: string;
+    systems: ReleasePin[];
+    /** Contained records that pin nothing of their own: their item is not under `systems/`. */
+    notPinned: {
+        record: string;
+        item: string;
+        file: string;
+    }[];
+}
+/**
+ * The commits an SoS version is assembled from, read from the working model: the record's own
+ * `modelCommit`, and for each record it `contains` the commit and the system folder of the item
+ * that record is a release of. A record that releases an item outside `systems/` is listed in
+ * `notPinned`, never guessed at.
+ */
+export declare function releasePins(model: MemoModel, recordId: string): ReleasePins;
+/** A `Contains` edge whose contained record is not at or before its container's commit. */
+export interface OrderingViolation {
+    container: string;
+    contained: string;
+    containerCommit: string;
+    containedCommit: string;
+}
+/**
+ * Every `Contains` edge below a record, at every level: a container's commit must be at or after
+ * the commit of what it contains (plan section 9, decision 2). The identity registry and `shared/`
+ * come from the container's commit, so an element added later would be minted on the fly.
+ */
+export declare function orderingViolations(projectRoot: string, model: MemoModel, recordId: string): Promise<OrderingViolation[]>;
+export interface Assembly {
+    dir: string;
+    key: string;
+    sos: Pin;
+    systems: {
+        pin: ReleasePin;
+        worktree: Pin;
+    }[];
+    reused: boolean;
+}
+/**
+ * The project of an SoS version: the SoS commit's project directory without `.memo` and without
+ * `<include>/systems/`, then each system folder laid from its own commit. The directory is keyed by
+ * the commits, which do not change, so a second call reuses it. Refused when a system folder exists
+ * at the SoS commit and is not pinned, or a pinned one does not exist at its commit.
+ */
+export declare function assemble(projectRoot: string, sosCommit: string, pins: ReleasePin[]): Promise<Assembly>;
+/** Where a path in an assembled build came from: the system and commit, or the SoS commit. */
+export declare function originOf(assembly: Assembly, file: string): string;
+/** Stage 1 rejected an assembled build: the same diagnostics, each path mapped back to its commit. */
+export declare class PinnedBuildError extends Error {
+    readonly assembly: Assembly;
+    readonly diagnostics: Diagnostic[];
+    readonly cause: Stage1RejectedError;
+    constructor(assembly: Assembly, diagnostics: Diagnostic[], cause: Stage1RejectedError);
+}
+export interface CrossSystemReference {
+    from: string;
+    to: string;
+    fromSystem: string;
+    toSystem: string;
+    how: string;
+}
+/**
+ * Elements of one system folder that type by, or link to, an element declared in another's.
+ * Such a build is wrong without being an error: the second system's elements come from the other
+ * system's commit. Typing is read from the workspace closure; every relationship is read as is.
+ */
+export declare function crossSystemReferences(model: MemoModel, registries: BuilderRegistries): CrossSystemReference[];
+export interface ReleaseBuild extends PinnedBuild {
+    assembly: Assembly;
+    /** What the record named: the SoS commit and each system's. */
+    releasePins: ReleasePins;
+}
+/**
+ * The model of an SoS version: the release record's pins read from `working` (the model of the
+ * checkout the record lives in), ordering checked at every level, assembled, built, and checked for
+ * references across system folders. Diagnostics of a rejected build name the system and commit.
+ */
+export declare function buildRelease(projectRoot: string, working: Pick<ProjectModel, 'model'>, recordId: string, options?: BuildOptions): Promise<ReleaseBuild>;
+/** The unmodified read of a file at a commit, for tests that check a worktree stayed clean. */
+export declare function worktreeIsClean(pin: Pin): Promise<boolean>;
+/** What a read-only server shows about an SoS version: the record and the commits it was built from. */
+export declare function releaseInfo(build: ReleaseBuild): PinnedInfo;
+/** What a read-only server shows about an unreleased ref: a tag or a branch is not a release. */
+export declare function refInfo(ref: string, pin: Pin): PinnedInfo;
+/**
+ * The packages a commit locked at a version this installation does not resolve.
+ *
+ * A pinned build is made with the ontology and compiler installed today: the locator reaches the installation,
+ * not the commit's copy. The commit's `memo.lock.yaml` says which version of each package it was made with, so
+ * the difference is knowable even though the build cannot yet use the old one; saying it is what stops a release
+ * rebuilt long after being read as the model as it was.
+ */
+export declare function ontologyDrift(pinnedProjectDir: string): {
+    name: string;
+    locked: string;
+    used: string;
+}[];
+/** A release record built from its own commit or assembled from its pins. */
+export interface RecordBuild {
+    build: PinnedBuild;
+    info: PinnedInfo;
+    /** The directory the model was built in, which a read-only server can serve. */
+    dir: string;
+    /** The record's commit. */
+    commit: string;
+}
+/**
+ * The model of one release record. A record that contains releases of systems is an SoS version and
+ * is assembled (`buildRelease`); any other is the model at its own `modelCommit`, opened on the one
+ * item it releases (a system release shows that system, as T2 draws it).
+ */
+export declare function buildForRecord(projectRoot: string, working: Pick<ProjectModel, 'model'>, recordId: string, options?: BuildOptions): Promise<RecordBuild>;
+/**
+ * The release before this one: the nearest record of the same item whose commit is an ancestor of
+ * this one's. Nothing is guessed: with no such record, or with two that are not ordered against each
+ * other (a branch), there is no previous release.
+ */
+export declare function previousRelease(projectRoot: string, model: MemoModel, recordId: string): Promise<string | undefined>;
+/** One cached pinned worktree or assembly. */
+export interface CachedBuild {
+    kind: 'pinned' | 'assembled';
+    dir: string;
+    /** When it was last built or reused. */
+    used: Date;
+}
+/** What `prune` removed (or, on a dry run, would remove). */
+export interface PruneResult {
+    removed: CachedBuild[];
+    kept: CachedBuild[];
+}
+/**
+ * Remove all but the `keep` most recently used pinned worktrees and, separately, assemblies of a
+ * project. Each is a cache: a pinned worktree is a full checkout of the repository and an assembly
+ * a copy of a project, and either is rebuilt on demand, so removing one costs a rebuild and nothing
+ * else. A worktree is removed through git so the repository does not keep a stale entry.
+ */
+export declare function pruneBuilds(projectRoot: string, options: {
+    keep: number;
+    dryRun?: boolean;
+}): Promise<PruneResult>;
+//# sourceMappingURL=pinned.d.ts.map

package/packages/tools/lib/model/pinned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinned.d.ts","sourceRoot":"","sources":["../../src/model/pinned.ts"],"names":[],"mappings":"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"}