@voxgig/sdkgen 4.32.1 → 4.34.0

package/bin/voxgig-sdkgen

@@ -8,7 +8,7 @@ const { Shape, One, Skip } = require('shape')
 
 const { SdkGen } = require('../dist/sdkgen.js')
 
-const VERSION = '4.32.1'
+const VERSION = '4.34.0'
 const KONSOLE = console
 
 

package/dist/action/copies.d.ts

@@ -0,0 +1,21 @@
+import type { ActionContext } from '../types';
+import type { Source } from './resolve';
+declare const COPIES = "sdkgen-copies.json";
+type CopyItem = {
+    package?: string;
+    version?: string;
+};
+type CopyRecord = {
+    items: Record<string, CopyItem>;
+    files: Record<string, string>;
+};
+declare function copiesPath(folder: string): string;
+declare function itemKey(kind: string, name: string): string;
+declare function fingerprint(content: any): string;
+declare function readCopies(fs: any, folder: string): CopyRecord;
+declare function isCopy(rel: string): boolean;
+declare function recordCopies(actx: ActionContext, jres: any, kind: string, sources: Source[]): void;
+declare function forgetCopies(actx: ActionContext, kind: string, name: string): void;
+declare function untouched(fs: any, folder: string, record: CopyRecord, rel: string): boolean | undefined;
+export type { CopyItem, CopyRecord, };
+export { COPIES, copiesPath, itemKey, fingerprint, readCopies, recordCopies, forgetCopies, untouched, isCopy, };

package/dist/action/copies.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COPIES = void 0;
+exports.copiesPath = copiesPath;
+exports.itemKey = itemKey;
+exports.fingerprint = fingerprint;
+exports.readCopies = readCopies;
+exports.recordCopies = recordCopies;
+exports.forgetCopies = forgetCopies;
+exports.untouched = untouched;
+exports.isCopy = isCopy;
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const definition_1 = require("../helpers/definition");
+const kind_1 = require("./kind");
+// What every add last wrote into `.sdk`, by fingerprint, and the version of
+// the package each item came from. It is the only record that tells a copy
+// the project changed from one its source has since moved past.
+const COPIES = 'sdkgen-copies.json';
+exports.COPIES = COPIES;
+const ABOUT = 'Written by voxgig-sdkgen on every add: what it copied into ' +
+    '.sdk, so that doctor, generate and package update can tell an outdated ' +
+    'copy from a local edit. Commit it; do not edit it.';
+function copiesPath(folder) {
+    return node_path_1.default.join(folder, COPIES);
+}
+function itemKey(kind, name) {
+    return kind + '/' + name;
+}
+// CRLF and LF copies of one file share a fingerprint, as doctor compares
+// them. latin1 maps each byte to one character, so nothing else changes.
+function fingerprint(content) {
+    const bytes = Buffer.isBuffer(content) ? content : Buffer.from(String(content));
+    const lf = Buffer.from(bytes.toString('latin1').replace(/\r\n/g, '\n'), 'latin1');
+    return (0, node_crypto_1.createHash)('sha256').update(lf).digest('hex').slice(0, 16);
+}
+// An unreadable record is treated as absent: every copy is then unrecorded,
+// which is exactly the state of a project from before the record existed.
+function readCopies(fs, folder) {
+    const empty = { items: {}, files: {} };
+    const path = copiesPath(folder);
+    if (!fs.existsSync(path)) {
+        return empty;
+    }
+    try {
+        const read = JSON.parse(String(fs.readFileSync(path, 'utf8')));
+        return {
+            items: { ...(read?.items ?? {}) },
+            files: { ...(read?.files ?? {}) },
+        };
+    }
+    catch (err) {
+        return empty;
+    }
+}
+function writeCopies(fs, folder, record) {
+    const sorted = (obj) => Object.fromEntries(Object.keys(obj).sort().map((key) => [key, obj[key]]));
+    fs.writeFileSync(copiesPath(folder), JSON.stringify({
+        about: ABOUT,
+        items: sorted(record.items),
+        files: sorted(record.files),
+    }, null, 2) + '\n');
+}
+function provenanceOf(source) {
+    return {
+        ...(null == source.package ? {} : { package: source.package }),
+        ...(null == source.version ? {} : { version: source.version }),
+    };
+}
+// The trees and definition files an add owns. An index is excluded: every
+// add rewrites it and no source holds a copy to compare it with.
+const TREE_ROOTS = Array.from(new Set(Object.values(kind_1.KINDS)
+    .flatMap((kind) => (kind.trees ?? [])
+    .map((tree) => String(tree.path).split('{name}')[0]))));
+function isCopy(rel) {
+    if (TREE_ROOTS.some((root) => rel.startsWith(root))) {
+        return true;
+    }
+    const dir = node_path_1.default.posix.dirname(rel);
+    const base = node_path_1.default.posix.basename(rel);
+    return Object.keys(kind_1.KINDS).some((kind) => dir === (0, definition_1.definitionFolder)('', kind).split(node_path_1.default.sep).join('/') &&
+        base !== (0, definition_1.indexName)(kind) &&
+        base.endsWith((0, definition_1.definitionFileName)('')));
+}
+function relativeTo(folder, abs) {
+    const rel = node_path_1.default.relative(node_path_1.default.resolve(folder), node_path_1.default.resolve(abs))
+        .split(node_path_1.default.sep).join('/');
+    return ('' === rel || rel.startsWith('../') || node_path_1.default.isAbsolute(rel)) ?
+        undefined : rel;
+}
+// Called by each add with what its own jostraca run wrote. A dry run writes
+// nothing, so it records nothing.
+function recordCopies(actx, jres, kind, sources) {
+    if (true === actx.opts?.dryrun || null == jres?.files) {
+        return;
+    }
+    const fs = actx.fs();
+    const folder = actx.folder;
+    const record = readCopies(fs, folder);
+    const files = [
+        ...(jres.files.written ?? []), ...(jres.files.unchanged ?? []),
+    ];
+    for (const abs of files) {
+        const rel = relativeTo(folder, abs);
+        if (null != rel && isCopy(rel) && fs.existsSync(abs)) {
+            record.files[rel] = fingerprint(fs.readFileSync(abs));
+        }
+    }
+    for (const source of sources) {
+        record.items[itemKey(kind, source.name)] = provenanceOf(source);
+    }
+    pruneMissing(fs, folder, record);
+    writeCopies(fs, folder, record);
+}
+// After a remove: the item goes, with every file entry nothing holds now.
+function forgetCopies(actx, kind, name) {
+    const fs = actx.fs();
+    const folder = actx.folder;
+    if (true === actx.opts?.dryrun || !fs.existsSync(copiesPath(folder))) {
+        return;
+    }
+    const record = readCopies(fs, folder);
+    delete record.items[itemKey(kind, name)];
+    pruneMissing(fs, folder, record);
+    writeCopies(fs, folder, record);
+}
+function pruneMissing(fs, folder, record) {
+    for (const rel of Object.keys(record.files)) {
+        if (!fs.existsSync(node_path_1.default.join(folder, ...rel.split('/')))) {
+            delete record.files[rel];
+        }
+    }
+}
+// Was this project file left exactly as an add wrote it?
+function untouched(fs, folder, record, rel) {
+    const recorded = record.files[rel];
+    if (null == recorded) {
+        return undefined;
+    }
+    const abs = node_path_1.default.join(folder, ...rel.split('/'));
+    return fs.existsSync(abs) && recorded === fingerprint(fs.readFileSync(abs));
+}
+//# sourceMappingURL=copies.js.map

package/dist/action/copies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copies.js","sourceRoot":"","sources":["../../src/action/copies.ts"],"names":[],"mappings":";;;;;;QAkNE,UAAU;QACV,OAAO;QACP,WAAW;QACX,UAAU;QACV,YAAY;QACZ,YAAY;QACZ,SAAS;QACT,MAAM;AAzNR,0DAA4B;AAE5B,6CAAwC;AAIxC,sDAE8B;AAE9B,iCAA8B;AAK9B,4EAA4E;AAC5E,2EAA2E;AAC3E,gEAAgE;AAChE,MAAM,MAAM,GAAG,oBAAoB,CAAA;QA+LjC,MAAM;AA7LR,MAAM,KAAK,GAAG,6DAA6D;IACzE,yEAAyE;IACzE,oDAAoD,CAAA;AActD,SAAS,UAAU,CAAC,MAAc;IAChC,OAAO,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAClC,CAAC;AAGD,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,OAAO,IAAI,GAAG,GAAG,GAAG,IAAI,CAAA;AAC1B,CAAC;AAGD,yEAAyE;AACzE,yEAAyE;AACzE,SAAS,WAAW,CAAC,OAAY;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/E,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IACjF,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACnE,CAAC;AAGD,4EAA4E;AAC5E,0EAA0E;AAC1E,SAAS,UAAU,CAAC,EAAO,EAAE,MAAc;IACzC,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAE/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QAC9D,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACjC,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;SAClC,CAAA;IACH,CAAC;IACD,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAGD,SAAS,WAAW,CAAC,EAAO,EAAE,MAAc,EAAE,MAAkB;IAC9D,MAAM,MAAM,GAAG,CAAC,GAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhE,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;QAClD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACrB,CAAC;AAGD,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO;QACL,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC;AAGD,0EAA0E;AAC1E,iEAAiE;AACjE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAK,CAAC;KACvD,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;KACvC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhE,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,GAAG,GAAG,mBAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,mBAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAErC,OAAO,MAAM,CAAC,IAAI,CAAC,YAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAC9C,GAAG,KAAK,IAAA,6BAAgB,EAAC,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5D,IAAI,KAAK,IAAA,sBAAS,EAAC,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAA,+BAAkB,EAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAC1C,CAAC;AAGD,SAAS,UAAU,CAAC,MAAc,EAAE,GAAW;IAC7C,MAAM,GAAG,GAAG,mBAAI,CAAC,QAAQ,CAAC,mBAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SAC/D,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE5B,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,mBAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;AACnB,CAAC;AAGD,4EAA4E;AAC5E,kCAAkC;AAClC,SAAS,YAAY,CACnB,IAAmB,EAAE,IAAS,EAAE,IAAY,EAAE,OAAiB;IAE/D,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;QACtD,OAAM;IACR,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAErC,MAAM,KAAK,GAAa;QACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;KAC/D,CAAA;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAEnC,IAAI,IAAI,IAAI,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACjE,CAAC;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC;AAGD,0EAA0E;AAC1E,SAAS,YAAY,CAAC,IAAmB,EAAE,IAAY,EAAE,IAAY;IACnE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAA;IACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAE1B,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACrE,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IACrC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACxC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC;AAGD,SAAS,YAAY,CAAC,EAAO,EAAE,MAAc,EAAE,MAAkB;IAC/D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAGD,yDAAyD;AACzD,SAAS,SAAS,CAChB,EAAO,EAAE,MAAc,EAAE,MAAkB,EAAE,GAAW;IAExD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAElC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QACrB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IAEhD,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;AAC7E,CAAC"}

package/dist/action/doctor.d.ts

@@ -10,10 +10,23 @@ type DoctorReport = {
     orphanModel: string[];
     resyncPending: string[];
     aliasedDiff: string[];
+    outdated: string[];
+    unrecorded: string[];
+    byItem: Record<string, ItemDrift>;
     ok: boolean;
 };
+type ItemDrift = {
+    package?: string;
+    from?: string;
+    to?: string;
+    outdated: number;
+    changed: number;
+};
 declare function action_doctor(args: string[], actx: ActionContext): Promise<ActionResult>;
 type DoctorScope = (kind: string, name: string) => boolean;
 declare function doctor(actx: ActionContext, scope?: DoctorScope, selected?: string[]): Promise<ActionResult>;
-export type { DoctorReport, DoctorScope, };
-export { action_doctor, doctor, };
+declare function refreshCommand(item: string, pkg?: string): string;
+declare function copyCheck(actx: ActionContext): Promise<string[]>;
+declare function copyWarnings(report: DoctorReport): string[];
+export type { DoctorReport, DoctorScope, ItemDrift, };
+export { action_doctor, doctor, copyCheck, copyWarnings, refreshCommand, };

package/dist/action/doctor.js

@@ -5,6 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.action_doctor = action_doctor;
 exports.doctor = doctor;
+exports.copyCheck = copyCheck;
+exports.copyWarnings = copyWarnings;
+exports.refreshCommand = refreshCommand;
 const kindCollection_1 = require("../helpers/kindCollection");
 const node_path_1 = __importDefault(require("node:path"));
 const jostraca_1 = require("jostraca");
@@ -17,6 +20,7 @@ const resolve_1 = require("./resolve");
 const definition_1 = require("../helpers/definition");
 const featureSource_1 = require("../helpers/featureSource");
 const junk_1 = require("../helpers/junk");
+const copies_1 = require("./copies");
 const IGNORED_RE = /(~|-jostraca-off)$/;
 function ignoredEntry(name) {
     return IGNORED_RE.test(name) || (0, junk_1.isJunk)(name);
@@ -134,8 +138,10 @@ async function doctor(actx, scope, selected) {
     const report = {
         forked: [], edited: [], stale: [], missing: [], additive: [],
         superseded: [], unwired: [], orphanModel: [],
-        resyncPending: [], aliasedDiff: [], ok: true,
+        resyncPending: [], aliasedDiff: [],
+        outdated: [], unrecorded: [], byItem: {}, ok: true,
     };
+    const copies = (0, copies_1.readCopies)(fs, root);
     report.superseded = supersededFiles(actx);
     report.orphanModel = orphanModelFiles(actx);
     const kinds = Object.keys(kind_1.KINDS).sort();
@@ -162,20 +168,21 @@ async function doctor(actx, scope, selected) {
             if (null == source) {
                 continue;
             }
+            const found = noteDrift(actx, report, copies, kind, source);
             if ('target' === kind) {
-                checkTarget(actx, source, report, selected);
+                checkTarget(actx, source, report, found, selected);
             }
             if ('edition' === kind) {
-                checkEdition(actx, source, report);
+                checkEdition(actx, source, report, found);
             }
             // Only an ACTIVE feature has source copied out; an inactive one's
             // leftovers are stale. `selected` overrides that for the caller's own.
             if ('feature' === kind &&
                 (false !== model?.main?.[types_1.KIT]?.feature?.[name]?.active ||
                     true === selected?.includes(name))) {
-                checkFeatureSource(actx, source, targets, report);
+                checkFeatureSource(actx, source, targets, found);
             }
-            checkItemModel(actx, kind, source, report);
+            checkItemModel(actx, kind, source, report, found);
         }
     }
     if (null == scope) {
@@ -188,7 +195,7 @@ async function doctor(actx, scope, selected) {
     // authoritative either way.
     report.ok = 0 === report.forked.length + report.edited.length +
         report.stale.length + report.missing.length + report.superseded.length +
-        report.orphanModel.length;
+        report.orphanModel.length + report.outdated.length;
     for (const [kind, note] of [
         ['forked', 'FORKED (will be reverted by `target add`)'],
         ['edited', 'EDITED template master'],
@@ -200,11 +207,22 @@ async function doctor(actx, scope, selected) {
         ['orphanModel', 'ORPHAN MODEL FILE (on disk, included by nothing, read by nobody)'],
         ['resyncPending', 'RESYNC PENDING (predates provenance; `target add` updates it)'],
         ['aliasedDiff', 'aliased model differs from its origin (project-owned, not drift)'],
+        ['outdated', 'OUTDATED (unchanged since it was copied, but its source has moved on)'],
     ]) {
         for (const file of report[kind]) {
             log.info({ point: 'doctor-finding', kind, file, note: note + ': ' + file });
         }
     }
+    for (const item of Object.keys(report.byItem).sort()) {
+        const drift = report.byItem[item];
+        if (0 < drift.outdated) {
+            log.info({
+                point: 'doctor-outdated', item, ...drift,
+                note: outdatedNote(item, drift) + ' - `voxgig-sdkgen ' +
+                    refreshCommand(item, drift.package) + '` refreshes them'
+            });
+        }
+    }
     log.info({
         point: 'doctor-end',
         ok: report.ok,
@@ -218,11 +236,13 @@ async function doctor(actx, scope, selected) {
         orphanModel: report.orphanModel.length,
         resyncPending: report.resyncPending.length,
         aliasedDiff: report.aliasedDiff.length,
+        outdated: report.outdated.length,
         note: report.ok ?
             ('.sdk matches the scaffold (' + report.additive.length + ' additive)') :
             ('.sdk has drifted: ' + report.forked.length + ' forked, ' +
                 report.edited.length + ' edited, ' + report.stale.length + ' stale, ' +
-                report.missing.length + ' missing')
+                report.missing.length + ' missing, ' + report.outdated.length +
+                ' outdated')
     });
     return { report };
 }
@@ -266,7 +286,7 @@ function resolveDeclared(kind, name, actx) {
         return undefined;
     }
 }
-function checkTarget(actx, resolved, report, selected) {
+function checkTarget(actx, resolved, report, found, selected) {
     const tname = resolved.name;
     const tfolder = resolved.folder;
     const torigname = resolved.origname;
@@ -309,13 +329,13 @@ function checkTarget(actx, resolved, report, selected) {
     // different trim from the one `target add` applied and report correctly
     // trimmed files as missing.
     const excludes = (0, target_1.trimFeatures)({ log: quietLog(actx.log), fs: () => fs, folder: root, model }, tfolder, torigname, tname, features);
-    compareTrees(actx, report, trees, {
+    compareTrees(actx, report, found, trees, {
         excludes,
         foreign: (kind) => 'edited' === kind ?
             foreignFeatureSource(actx, resolved) : [],
     });
 }
-function compareTrees(actx, report, trees, opts) {
+function compareTrees(actx, report, found, trees, opts) {
     const fs = actx.fs();
     const model = actx.model;
     const root = actx.folder;
@@ -342,7 +362,7 @@ function compareTrees(actx, report, trees, opts) {
         const actualSet = new Set(actual);
         for (const rel of expected) {
             if (!actualSet.has(rel)) {
-                report.missing.push(label + rel);
+                found('missing', label + rel);
                 continue;
             }
             // A foreign feature's file is EXPECTED here (so it is not stale) but
@@ -355,7 +375,7 @@ function compareTrees(actx, report, trees, opts) {
             }
             const from = landed.get(rel);
             if (differs(fs, from, node_path_1.default.join(tree.project, rel), model, tree.replace, undefined, tree.rewrite)) {
-                report[tree.kind].push(label + rel);
+                found(tree.kind, label + rel);
             }
         }
         for (const rel of actual) {
@@ -371,12 +391,12 @@ function compareTrees(actx, report, trees, opts) {
                 report.additive.push(label + rel);
             }
             else {
-                report.stale.push(label + rel);
+                found('stale', label + rel);
             }
         }
     }
 }
-function checkEdition(actx, resolved, report) {
+function checkEdition(actx, resolved, report, found) {
     const fs = actx.fs();
     const root = actx.folder;
     const name = resolved.name;
@@ -401,7 +421,7 @@ function checkEdition(actx, resolved, report) {
                     (src) => (0, target_1.aliasCmpText)(src, origname, name) : undefined,
             }];
     });
-    compareTrees(actx, report, trees);
+    compareTrees(actx, report, found, trees);
 }
 function foreignFeatureSource(actx, target) {
     const out = new Map();
@@ -445,7 +465,7 @@ function overlayFiles(actx, feature, target) {
     }
     return out;
 }
-function checkFeatureSource(actx, feature, targets, report) {
+function checkFeatureSource(actx, feature, targets, found) {
     const fs = actx.fs();
     const root = actx.folder;
     const model = actx.model;
@@ -454,18 +474,18 @@ function checkFeatureSource(actx, feature, targets, report) {
             const project = node_path_1.default.join(root, 'tm', tname, rel);
             const label = 'tm/' + tname + '/' + rel;
             if (!fs.existsSync(project)) {
-                report.missing.push(label);
+                found('missing', label);
                 continue;
             }
             // The same map `feature add` copies with — see helpers/stdrep. A
             // different one here would report every substituted file as edited.
             if (differs(fs, from, project, model, (0, stdrep_1.templateReplacements)(model, tname))) {
-                report.edited.push(label);
+                found('edited', label);
             }
         }
     }
 }
-function checkItemModel(actx, kind, source, report) {
+function checkItemModel(actx, kind, source, report, found) {
     const name = source.name;
     const origname = source.origname;
     const base = source.base;
@@ -478,7 +498,7 @@ function checkItemModel(actx, kind, source, report) {
     const project = (0, definition_1.definitionPath)(actx.folder, kind, name);
     const label = 'model/' + kind + '/' + node_path_1.default.basename(project);
     if (!fs.existsSync(project)) {
-        report.missing.push(label);
+        found('missing', label);
         return;
     }
     const provenance = (0, stdrep_1.provenanceReplace)({ base, origname, name, package: source.package });
@@ -494,7 +514,70 @@ function checkItemModel(actx, kind, source, report) {
         report.resyncPending.push(label);
         return;
     }
-    report.forked.push(label);
+    found('forked', label);
+}
+// Files every finding through one place: a forked or edited copy the record
+// shows untouched is outdated instead, and every item keeps a tally.
+function noteDrift(actx, report, copies, kind, source) {
+    const fs = actx.fs();
+    const item = (0, copies_1.itemKey)(kind, source.name);
+    const copied = copies.items[item];
+    return (category, label) => {
+        let into = category;
+        if ('forked' === category || 'edited' === category) {
+            const same = (0, copies_1.untouched)(fs, actx.folder, copies, label);
+            if (true === same) {
+                into = 'outdated';
+            }
+            else if (undefined === same) {
+                report.unrecorded.push(label);
+            }
+        }
+        report[into].push(label);
+        const drift = report.byItem[item] = report.byItem[item] ?? {
+            ...pkgOf(source.package ?? copied?.package),
+            ...(null == copied?.version ? {} : { from: copied.version }),
+            ...(null == source.version ? {} : { to: source.version }),
+            outdated: 0,
+            changed: 0,
+        };
+        if ('outdated' === into) {
+            drift.outdated++;
+        }
+        else {
+            drift.changed++;
+        }
+    };
+}
+function pkgOf(name) {
+    return null == name ? {} : { package: name };
+}
+// The command that brings an item's copies up to the installed source. The
+// package form checks first and refuses to overwrite a local edit.
+function refreshCommand(item, pkg) {
+    if (null != pkg) {
+        return 'package update ' + pkg + ' --no-fetch';
+    }
+    const [kind, ...name] = item.split('/');
+    return kind + ' add ' + name.join('/');
+}
+function outdatedNote(item, drift) {
+    return item.replace('/', ' ') + ': ' + drift.outdated +
+        ' file(s) are unchanged copies' + sinceCopied(drift.package, [drift]);
+}
+// Names both versions only when they differ: a source that changed under the
+// same version (a linked checkout, say) is still a source that moved on.
+function sinceCopied(pkg, drift) {
+    const froms = Array.from(new Set(drift.map((d) => d.from)));
+    const to = drift[0].to;
+    const from = 1 === froms.length ? froms[0] : undefined;
+    const name = pkg ?? 'their source';
+    if (null != from && null != to && from !== to) {
+        return ' from ' + name + ' ' + from + ', but ' + name + ' ' + to +
+            ' is installed';
+    }
+    return ', but ' + name + (null == to ? '' : ' ' + to) +
+        ' has changed since they were copied';
 }
 function stampOnly(fs, scaffoldPath, projectPath, model, provenance, rewrite) {
     const { expected, actual } = renderPair(fs, scaffoldPath, projectPath, model, provenance, rewrite);
@@ -573,15 +656,78 @@ function differs(fs, scaffoldPath, projectPath, model, replace, ignore, rewrite)
 function renderPair(fs, scaffoldPath, projectPath, model, replace, rewrite) {
     const rawsrc = fs.readFileSync(scaffoldPath, 'utf8');
     const src = null == rewrite ? rawsrc : rewrite(rawsrc);
+    // git may rewrite line endings on checkout (core.autocrlf).
     return {
-        expected: (0, jostraca_1.template)(src, model, { replace }),
-        actual: fs.readFileSync(projectPath, 'utf8'),
+        expected: lfEndings((0, jostraca_1.template)(src, model, { replace })),
+        actual: lfEndings(fs.readFileSync(projectPath, 'utf8')),
     };
 }
+function lfEndings(text) {
+    return text.replace(/\r\n/g, '\n');
+}
 function quietLog(log) {
     const noop = () => { };
     const quiet = { info: noop, debug: noop, warn: log.warn.bind(log), error: noop, trace: noop, fatal: noop };
     quiet.child = () => quiet;
     return quiet;
 }
+function silentLog() {
+    const noop = () => { };
+    const silent = { info: noop, debug: noop, warn: noop, error: noop, trace: noop, fatal: noop };
+    silent.child = () => silent;
+    return silent;
+}
+// What `generate` checks before it reads the copies: the active items only,
+// and a warning per refresh command rather than a failure, since a
+// difference may be a deliberate edit.
+async function copyCheck(actx) {
+    const active = (kind, name) => false !== (0, kindCollection_1.kindCollection)(actx.model, kind)?.[name]?.active;
+    const res = await doctor({ ...actx, log: silentLog() }, active);
+    return copyWarnings(res.report);
+}
+function copyWarnings(report) {
+    const groups = new Map();
+    const add = (key, item, files, drift) => {
+        const group = groups.get(key) ?? { items: [], files: 0, drift: [] };
+        group.items.push(item.replace('/', ' '));
+        group.files += files;
+        group.drift.push(drift);
+        groups.set(key, group);
+    };
+    for (const item of Object.keys(report.byItem).sort()) {
+        const drift = report.byItem[item];
+        const command = refreshCommand(item, drift.package);
+        if (0 < drift.outdated) {
+            add('outdated\n' + command, item, drift.outdated, drift);
+        }
+        if (0 < drift.changed) {
+            add('changed\n' + command, item, drift.changed, drift);
+        }
+    }
+    const lines = [];
+    for (const [key, group] of groups) {
+        const [what, command] = key.split('\n');
+        const pkg = group.drift[0].package;
+        const to = group.drift[0].to;
+        const installed = null == pkg ? 'their source' :
+            (pkg + (null == to ? '' : ' ' + to));
+        const refresh = '`npx voxgig-sdkgen ' + command + '`';
+        if ('outdated' === what) {
+            lines.push(group.items.join(', ') + ': ' + group.files +
+                ' file(s) in .sdk are unchanged copies' +
+                sinceCopied(pkg, group.drift) + ', so this run generates from ' +
+                'older templates. Run ' + refresh + ' to refresh them.');
+        }
+        else {
+            lines.push(group.items.join(', ') + ': ' + group.files +
+                ' file(s) in .sdk differ from what ' + installed + ' installs: ' +
+                'changed in this project, or copied before sdkgen recorded its ' +
+                'copies. `npx voxgig-sdkgen doctor` lists them; ' + refresh +
+                ' refreshes them' +
+                (null == pkg ? ', discarding any local edit.' :
+                    ', and refuses before it overwrites a local edit.'));
+        }
+    }
+    return lines;
+}
 //# sourceMappingURL=doctor.js.map