@shrkcrft/inspector 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/pack-helper-registry.d.ts

@@ -1,5 +1,12 @@
 import { type IPackHelper } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IRejectedEntry } from '@shrkcrft/core';
+/**
+ * THE helper acceptance predicate (round 12, 12.1): every ERROR of
+ * `validatePackHelper` (a warning never refuses a helper), `<field>:
+ * <message>` — `[]` means accepted.
+ */
+export declare function packHelperRejectionReasons(raw: unknown): readonly string[];
 export declare const PACK_HELPER_REGISTRY_SCHEMA = "sharkcraft.pack-helper-registry/v1";
 export declare enum PackHelperSource {
     Local = "local",
@@ -22,6 +29,13 @@ export interface IPackHelperDoctorIssue {
 export declare function loadPackHelpers(inspection: ISharkcraftInspection): Promise<{
     entries: readonly IPackHelperEntry[];
     issues: readonly IPackHelperDoctorIssue[];
+    /** Every helper file this load considered (absolute path) and what happened to it. */
+    files: readonly {
+        readonly file: string;
+        readonly status: 'loaded' | 'failed' | 'missing';
+    }[];
+    /** Every declared helper the loader refused — invalid or a duplicate id (round 12, 12.1). */
+    rejected: readonly IRejectedEntry[];
 }>;
 export declare function listPackHelpers(inspection: ISharkcraftInspection): Promise<readonly IPackHelperEntry[]>;
 export declare function findPackHelper(inspection: ISharkcraftInspection, id: string): Promise<IPackHelperEntry | null>;

package/dist/pack-helper-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-helper-registry.d.ts","sourceRoot":"","sources":["../src/pack-helper-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4BD,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAE,CAAC,CAoF9F;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAGtC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAG5C"}
+{"version":3,"file":"pack-helper-registry.d.ts","sourceRoot":"","sources":["../src/pack-helper-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAM1E;AAED,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoBD,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1C,sFAAsF;IACtF,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAC9F,6FAA6F;IAC7F,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC,CAAC,CAgID;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAGtC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAG5C"}

package/dist/pack-helper-registry.js

@@ -6,7 +6,21 @@
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { validatePackHelper } from '@shrkcrft/plugin-api';
-import { importModuleViaLoader } from '@shrkcrft/core';
+import { importModuleViaLoader, readContributionExport, RejectionCause, } from '@shrkcrft/core';
+/**
+ * THE helper acceptance predicate (round 12, 12.1): every ERROR of
+ * `validatePackHelper` (a warning never refuses a helper), `<field>:
+ * <message>` — `[]` means accepted.
+ */
+export function packHelperRejectionReasons(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return ['(entry): must be an object'];
+    const v = validatePackHelper(raw);
+    if (v.valid)
+        return [];
+    const errors = v.issues.filter((i) => i.severity !== 'warning');
+    return (errors.length > 0 ? errors : v.issues).map((i) => `${i.field}: ${i.message}`);
+}
 export const PACK_HELPER_REGISTRY_SCHEMA = 'sharkcraft.pack-helper-registry/v1';
 export var PackHelperSource;
 (function (PackHelperSource) {
@@ -14,15 +28,8 @@ export var PackHelperSource;
     PackHelperSource["Pack"] = "pack";
     PackHelperSource["Fixture"] = "fixture";
 })(PackHelperSource || (PackHelperSource = {}));
-async function importDefault(file) {
-    const mod = (await importModuleViaLoader(file));
-    if (Array.isArray(mod.default))
-        return mod.default;
-    if (mod.default && typeof mod.default === 'object')
-        return [mod.default];
-    if (Array.isArray(mod.helpers))
-        return mod.helpers;
-    return [];
+async function importHelpers(file) {
+    return readContributionExport(await importModuleViaLoader(file), { namedKeys: ['helpers'] });
 }
 function localFiles(inspection) {
     const out = [];
@@ -34,58 +41,88 @@ function localFiles(inspection) {
         if (existsSync(abs))
             out.push(abs);
     }
-    const cfg = inspection.config;
-    for (const rel of cfg?.helperFiles ?? []) {
-        out.push(nodePath.isAbsolute(rel) ? rel : nodePath.join(dir, rel));
-    }
+    // More helper files come from pack manifests (`helperFiles`, loaded below) —
+    // there is no local-config key for them; the strict config schema rejects
+    // one, so a local read here could never be reached.
     return out;
 }
 export async function loadPackHelpers(inspection) {
     const entries = [];
     const issues = [];
-    const seen = new Set();
-    const ingest = (raw, source, packageName, sourceFile) => {
-        const v = validatePackHelper(raw);
-        if (!v.valid) {
-            for (const i of v.issues) {
+    const rejected = [];
+    const files = [];
+    const seen = new Map();
+    const ingest = (raw, source, packageName, sourceFile, at) => {
+        const rawId = raw && typeof raw === 'object' ? raw.id : undefined;
+        const helperId = typeof rawId === 'string' ? rawId : undefined;
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            for (const i of validatePackHelper(raw).issues) {
+                // Errors make the helper invalid (skipped); warnings (e.g. an unknown key
+                // on an operation, which the engine would silently drop) still surface.
+                const warning = i.severity === 'warning';
                 issues.push({
-                    severity: 'error',
-                    code: 'invalid-helper',
+                    severity: warning ? 'warning' : 'error',
+                    code: warning ? 'helper-warning' : 'invalid-helper',
                     message: `${i.field}: ${i.message}`,
-                    helperId: typeof raw.id === 'string' ? raw.id : undefined,
+                    ...(helperId ? { helperId } : {}),
                     source: sourceFile,
                 });
             }
+        }
+        const reasons = packHelperRejectionReasons(raw);
+        if (reasons.length > 0) {
+            if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+                issues.push({ severity: 'error', code: 'invalid-helper', message: reasons[0], source: sourceFile });
+            }
+            rejected.push({ ...at, ...(helperId ? { entryId: helperId } : {}), reasons, cause: RejectionCause.Invalid });
             return;
         }
-        if (seen.has(raw.id)) {
+        const helper = raw;
+        const prev = seen.get(helper.id);
+        if (prev !== undefined) {
             issues.push({
                 severity: 'error',
                 code: 'duplicate-id',
-                message: `Helper "${raw.id}" already loaded; skipping ${sourceFile}.`,
-                helperId: raw.id,
+                message: `Helper "${helper.id}" already loaded; skipping ${sourceFile}.`,
+                helperId: helper.id,
                 source: sourceFile,
             });
+            rejected.push({
+                ...at,
+                entryId: helper.id,
+                reasons: [`id: "${helper.id}" is already declared in ${prev}`],
+                cause: RejectionCause.DuplicateId,
+            });
             return;
         }
-        seen.add(raw.id);
+        seen.set(helper.id, sourceFile);
         entries.push({
-            helper: raw,
+            helper,
             source,
             ...(packageName ? { packageName } : {}),
             sourceFile,
         });
     };
+    const ingestAll = (exp, file, source, packageName, sourceFile) => {
+        exp.items.forEach((h, i) => ingest(h, source, packageName, sourceFile, {
+            file,
+            index: exp.single ? -1 : i,
+            ...(exp.exportName ? { exportName: exp.exportName } : {}),
+        }));
+    };
     for (const file of localFiles(inspection)) {
         try {
-            const list = await importDefault(file);
+            const exp = await importHelpers(file);
             const rel = nodePath.relative(inspection.projectRoot, file) || file;
-            for (const h of list)
-                ingest(h, PackHelperSource.Local, undefined, rel);
+            files.push({ file, status: 'loaded' });
+            ingestAll(exp, file, PackHelperSource.Local, undefined, rel);
         }
         catch (e) {
+            files.push({ file, status: 'failed' });
+            // A helper file that cannot be imported contributes nothing: an error,
+            // like every other contribution load failure.
             issues.push({
-                severity: 'warning',
+                severity: 'error',
                 code: 'load-failed',
                 message: `Failed to load ${file}: ${e.message}`,
                 source: file,
@@ -97,8 +134,9 @@ export async function loadPackHelpers(inspection) {
         for (const rel of contributions.helperFiles ?? []) {
             const file = nodePath.resolve(pack.packageRoot, rel);
             if (!existsSync(file)) {
+                files.push({ file, status: 'missing' });
                 issues.push({
-                    severity: 'warning',
+                    severity: 'error',
                     code: 'missing-file',
                     message: `Pack ${pack.packageName} declares ${rel} but file is missing.`,
                     source: file,
@@ -106,13 +144,14 @@ export async function loadPackHelpers(inspection) {
                 continue;
             }
             try {
-                const list = await importDefault(file);
-                for (const h of list)
-                    ingest(h, PackHelperSource.Pack, pack.packageName, rel);
+                const exp = await importHelpers(file);
+                files.push({ file, status: 'loaded' });
+                ingestAll(exp, file, PackHelperSource.Pack, pack.packageName, rel);
             }
             catch (e) {
+                files.push({ file, status: 'failed' });
                 issues.push({
-                    severity: 'warning',
+                    severity: 'error',
                     code: 'load-failed',
                     message: `Pack ${pack.packageName} (${rel}): ${e.message}`,
                     source: file,
@@ -120,7 +159,7 @@ export async function loadPackHelpers(inspection) {
             }
         }
     }
-    return { entries, issues };
+    return { entries, issues, files, rejected };
 }
 export async function listPackHelpers(inspection) {
     const { entries } = await loadPackHelpers(inspection);

package/dist/pack-manifest-reader.d.ts

@@ -0,0 +1,8 @@
+import type { ISharkCraftPackManifest } from '@shrkcrft/plugin-api';
+export declare function readPackManifest(packRoot: string): Promise<{
+    readonly manifestPath: string | null;
+    readonly signedManifestPath: string | null;
+    readonly manifest: ISharkCraftPackManifest | null;
+    readonly error?: string;
+}>;
+//# sourceMappingURL=pack-manifest-reader.d.ts.map

package/dist/pack-manifest-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manifest-reader.d.ts","sourceRoot":"","sources":["../src/pack-manifest-reader.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAUpE,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAmDD"}

package/dist/pack-manifest-reader.js

@@ -0,0 +1,79 @@
+/**
+ * Find and load a pack's manifest from its root — the one reader the
+ * pack-author surfaces (`packs dev-status`, `packs test --typecheck`) share.
+ *
+ *   - `manifestPath`: what `package.json` `sharkcraft.manifest` (or a string
+ *     `sharkcraft` field) points at;
+ *   - `signedManifestPath`: the `<dir>/<base>.signed.json` `packs sign` writes
+ *     next to it (or a root-level `sharkcraft.plugin.signed.json`, for older
+ *     packs) — preferred when present, since it carries the signature;
+ *   - `manifest`: the loaded object (JSON parsed; TS/JS imported through the
+ *     engine loader, so a module that failed once rejects deterministically).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { importModuleViaLoader } from '@shrkcrft/core';
+function readJsonSafe(p) {
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function readPackManifest(packRoot) {
+    const pkg = readJsonSafe(join(packRoot, 'package.json'));
+    const field = pkg?.sharkcraft;
+    const rel = typeof field === 'string'
+        ? field
+        : field && typeof field === 'object' && typeof field.manifest === 'string'
+            ? field.manifest
+            : undefined;
+    let manifestPath = rel ? resolve(packRoot, rel) : null;
+    if (manifestPath && !existsSync(manifestPath))
+        manifestPath = null;
+    let signedManifestPath = null;
+    if (manifestPath?.endsWith('.json')) {
+        signedManifestPath = manifestPath;
+    }
+    else if (manifestPath) {
+        const sibling = join(dirname(manifestPath), basename(manifestPath).replace(/\.(ts|js|mjs|cjs)$/i, '') + '.signed.json');
+        if (existsSync(sibling))
+            signedManifestPath = sibling;
+    }
+    if (!signedManifestPath) {
+        const legacy = join(packRoot, 'sharkcraft.plugin.signed.json');
+        if (existsSync(legacy))
+            signedManifestPath = legacy;
+    }
+    const file = signedManifestPath ?? manifestPath;
+    if (!file) {
+        return {
+            manifestPath,
+            signedManifestPath,
+            manifest: null,
+            error: rel
+                ? `sharkcraft.manifest points at a missing file (${rel})`
+                : 'package.json declares no sharkcraft.manifest',
+        };
+    }
+    try {
+        if (file.endsWith('.json')) {
+            return { manifestPath, signedManifestPath, manifest: JSON.parse(readFileSync(file, 'utf8')) };
+        }
+        const mod = (await importModuleViaLoader(file));
+        return {
+            manifestPath,
+            signedManifestPath,
+            manifest: mod.default ?? mod,
+        };
+    }
+    catch (e) {
+        return {
+            manifestPath,
+            signedManifestPath,
+            manifest: null,
+            error: `manifest failed to load (${(e.message.split('\n')[0] ?? '').trim()})`,
+        };
+    }
+}

package/dist/pack-release-check.d.ts

@@ -19,6 +19,19 @@ export interface IPackReleaseCheck {
     contributionsFound: number;
     findings: readonly IPackReleaseFinding[];
     passed: boolean;
+    /**
+     * Present only when the check ran with `typecheck: true`: how many TS files
+     * the in-process check examined. `ran: false` means nothing was type-checked
+     * — a caller must not read the release check as typecheck-verified.
+     */
+    typecheck?: {
+        readonly ran: boolean;
+        readonly checkedFiles: number;
+        readonly errors: number;
+        readonly note?: string;
+    };
 }
-export declare function runPackReleaseCheck(packPath: string): Promise<IPackReleaseCheck>;
+export declare function runPackReleaseCheck(packPath: string, options?: {
+    readonly typecheck?: boolean;
+}): Promise<IPackReleaseCheck>;
 //# sourceMappingURL=pack-release-check.d.ts.map

package/dist/pack-release-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-release-check.d.ts","sourceRoot":"","sources":["../src/pack-release-check.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;CACjB;AA6ED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoLtF"}
+{"version":3,"file":"pack-release-check.d.ts","sourceRoot":"","sources":["../src/pack-release-check.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvH;AA6ED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,OAAO,CAAC,iBAAiB,CAAC,CA0M5B"}

package/dist/pack-release-check.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { CONTRIBUTION_FILE_KEYS, validatePackManifest, } from '@shrkcrft/plugin-api';
 import { importModuleViaLoader } from '@shrkcrft/core';
+import { typecheckPackAssets } from "./pack-typecheck.js";
 export const PACK_RELEASE_CHECK_SCHEMA = 'sharkcraft.pack-release-check/v1';
 function findManifest(packPath) {
     const pkgFile = nodePath.join(packPath, 'package.json');
@@ -73,7 +74,7 @@ function checkFilesWhitelist(pkgFile, manifestFile) {
     }
     return null;
 }
-export async function runPackReleaseCheck(packPath) {
+export async function runPackReleaseCheck(packPath, options = {}) {
     const findings = [];
     const absPath = nodePath.resolve(packPath);
     if (!existsSync(absPath)) {
@@ -241,6 +242,26 @@ export async function runPackReleaseCheck(packPath) {
     const filesFinding = checkFilesWhitelist(pkgFile, manifestFile);
     if (filesFinding)
         findings.push(filesFinding);
+    // Opt-in typecheck of the pack's own TS assets (the one in-process check).
+    let typecheck;
+    if (options.typecheck) {
+        const tc = typecheckPackAssets({ packageRoot: absPath, manifestPath: manifestFile, manifest });
+        typecheck = {
+            ran: tc.ran,
+            checkedFiles: tc.ran ? tc.checkedFiles.length : 0,
+            errors: tc.errors.length,
+            ...(tc.note ? { note: tc.note } : {}),
+        };
+        for (const e of tc.errors) {
+            findings.push({
+                code: 'typecheck-error',
+                severity: 'error',
+                message: `${nodePath.relative(absPath, e.file) || e.file}:${e.line}:${e.column} TS${e.code} ${e.message}`,
+                file: e.file,
+                suggestedFix: 'Fix the type error in the asset; `shrk packs test <pack> --typecheck` reproduces it.',
+            });
+        }
+    }
     const passed = findings.every((f) => f.severity !== 'error');
     return {
         schema: PACK_RELEASE_CHECK_SCHEMA,
@@ -250,5 +271,6 @@ export async function runPackReleaseCheck(packPath) {
         contributionsFound,
         findings,
         passed,
+        ...(typecheck ? { typecheck } : {}),
     };
 }

package/dist/pack-signature-status.d.ts

@@ -3,6 +3,7 @@ export declare const PACK_SIGNATURE_STATUS_SCHEMA = "sharkcraft.pack-signature-s
 export declare enum PackSignatureStatusKind {
     Present = "present",
     Stale = "stale",
+    Unverified = "unverified",
     Missing = "missing"
 }
 export interface IPackSignatureEntry {
@@ -12,8 +13,17 @@ export interface IPackSignatureEntry {
     readonly status: PackSignatureStatusKind;
     readonly signatureSignedAt?: string;
     readonly reason?: string;
+    /** First contribution file whose content changed since signing (back-compat alias of `divergedFiles[0]`). */
     readonly newerContributionFile?: string;
+    /**
+     * @deprecated Freshness is content divergence, never age — no mtime is read
+     * any more. Always absent.
+     */
     readonly newerContributionMtime?: string;
+    /** Every pack-relative file whose content differs from the signed record. */
+    readonly divergedFiles?: readonly string[];
+    /** Pack-relative files the signature holds no content digest for. */
+    readonly unrecordedFiles?: readonly string[];
     readonly secretAvailable: boolean;
     readonly nextCommand?: string;
     /**
@@ -32,6 +42,8 @@ export interface IPackSignatureStatusReport {
         readonly total: number;
         readonly present: number;
         readonly stale: number;
+        /** Signed packs whose freshness could not be verified (no content record). */
+        readonly unverified: number;
         readonly missing: number;
         /** Packs whose latest signature is dev-only (subset of `present`). */
         readonly dev: number;
@@ -43,19 +55,19 @@ export declare function buildPackSignatureStatusReport(inspection: ISharkcraftIn
 /**
  * Pack signature explanation. Surfaces the distinct lifecycle
  * states (`unsigned`, `stale`, `invalid`, `valid`, `present-unverified`,
- * `dev-signature`, `secret-missing`, `not-required`) per pack with a one-line
- * "why this matters".
+ * `freshness-unverified`, `dev-signature`, `secret-missing`, `not-required`)
+ * per pack with a one-line "why this matters".
  *
  * Read-only. Reads `inspection.packs.discoveredPacks[i].signatureStatus`
  * which already reflects the verifier's outcome when the inspector was
  * constructed with `verifyPackSignatures: true`.
  *
  * `valid` is reserved STRICTLY for a real HMAC pass (verifier === 'verified').
- * A pack whose signature timestamp is merely fresher than its contribution
- * files — but whose HMAC was not checked this run — is `present-unverified`,
- * never `valid`: freshness is not verification.
+ * A pack whose signed content record still matches — but whose HMAC was not
+ * checked this run — is `present-unverified`, never `valid`: freshness is not
+ * verification.
  */
-export type PackSignatureExplainState = 'valid' | 'unsigned' | 'stale' | 'invalid' | 'present-unverified' | 'dev-signature' | 'secret-missing' | 'not-required' | 'unknown';
+export type PackSignatureExplainState = 'valid' | 'unsigned' | 'stale' | 'invalid' | 'present-unverified' | 'freshness-unverified' | 'dev-signature' | 'secret-missing' | 'not-required' | 'unknown';
 export interface IPackSignatureExplainEntry {
     readonly packageName: string;
     readonly packageVersion: string;

package/dist/pack-signature-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-signature-status.d.ts","sourceRoot":"","sources":["../src/pack-signature-status.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,4BAA4B,wCAAwC,CAAC;AAElF,oBAAY,uBAAuB;IACjC,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,4BAA4B,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,sEAAsE;QACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AA+BD,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,qBAAqB,GAChC,0BAA0B,CA6G5B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,kCAAkC;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,kCAAuC,GAC/C,2BAA2B,CAuE7B"}
+{"version":3,"file":"pack-signature-status.d.ts","sourceRoot":"","sources":["../src/pack-signature-status.ts"],"names":[],"mappings":"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"}