@shrkcrft/inspector 0.1.0-alpha.2

package/dist/pack-pending.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pack pending state.
+ *
+ * Cross-section report: what is *not yet finalised* in the pack authoring
+ * loop. Combines:
+ *   - modified pack asset files (mtime > signature)
+ *   - generated preview drafts under .sharkcraft/authoring/
+ *   - stale signature state (per-pack)
+ *   - missing secret state
+ *   - provenance entries not yet sealed (operation=preview without a
+ *     follow-up apply or remove)
+ *
+ * Never signs. Never mutates pack source. Honest when secret is missing.
+ *
+ * Schema: sharkcraft.pack-pending/v1
+ */
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { PackSignatureStatusKind } from './pack-signature-status.js';
+export declare const PACK_PENDING_SCHEMA = "sharkcraft.pack-pending/v1";
+export interface IPackPendingEntry {
+    readonly packageName: string;
+    readonly packageRoot: string;
+    /** Files modified relative to the current signature, if any. */
+    readonly modifiedFiles: ReadonlyArray<{
+        readonly filePath: string;
+        readonly mtime: string;
+    }>;
+    /** Pack signature freshness for this pack. */
+    readonly signatureStatus: PackSignatureStatusKind;
+    /** Whether SHARKCRAFT_PACK_SECRET is available. */
+    readonly secretAvailable: boolean;
+    /** Recommended next command for this pack. */
+    readonly nextCommand?: string;
+}
+export interface IPendingDraftEntry {
+    readonly filePath: string;
+    readonly purpose: 'authoring-draft' | 'fix-preview' | 'authoring-manifest' | 'authoring-explainer' | 'other';
+    readonly mtime: string;
+}
+export interface IPendingProvenanceEntry {
+    readonly assetKind: string;
+    readonly assetId: string;
+    readonly generatedAt: string;
+    readonly reason?: string;
+}
+export interface IPackPendingReport {
+    readonly schema: typeof PACK_PENDING_SCHEMA;
+    readonly generatedAt: string;
+    readonly projectRoot: string;
+    readonly secretAvailable: boolean;
+    /** True when ANY pending state is non-zero. */
+    readonly hasPending: boolean;
+    readonly packs: readonly IPackPendingEntry[];
+    readonly draftFiles: readonly IPendingDraftEntry[];
+    readonly pendingProvenance: readonly IPendingProvenanceEntry[];
+    readonly nextCommands: readonly string[];
+    /** When secret is missing, this contains the agent-friendly explanation. */
+    readonly secretMissingHint?: string;
+    /** When set, the path to a written signing TODO report. */
+    readonly signingTodoReportPath?: string;
+}
+export interface IBuildPackPendingOptions {
+    /** When true, treat every authoring draft as pending. */
+    includeAuthoringDrafts?: boolean;
+}
+export declare function buildPackPendingReport(inspection: ISharkcraftInspection, options?: IBuildPackPendingOptions): IPackPendingReport;
+export declare function renderPackPendingMarkdown(report: IPackPendingReport): string;
+//# sourceMappingURL=pack-pending.d.ts.map

package/dist/pack-pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-pending.d.ts","sourceRoot":"","sources":["../src/pack-pending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAkC,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGrG,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAClD,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,OAAO,CAAC;IAC7G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AA+BD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAyFpB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA2C5E"}

package/dist/pack-pending.js

@@ -0,0 +1,189 @@
+/**
+ * Pack pending state.
+ *
+ * Cross-section report: what is *not yet finalised* in the pack authoring
+ * loop. Combines:
+ *   - modified pack asset files (mtime > signature)
+ *   - generated preview drafts under .sharkcraft/authoring/
+ *   - stale signature state (per-pack)
+ *   - missing secret state
+ *   - provenance entries not yet sealed (operation=preview without a
+ *     follow-up apply or remove)
+ *
+ * Never signs. Never mutates pack source. Honest when secret is missing.
+ *
+ * Schema: sharkcraft.pack-pending/v1
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { buildPackSignatureStatusReport, PackSignatureStatusKind } from "./pack-signature-status.js";
+import { readProvenance, AssetProvenanceOperation } from "./asset-provenance.js";
+export const PACK_PENDING_SCHEMA = 'sharkcraft.pack-pending/v1';
+function detectDraftPurpose(filename) {
+    if (filename.endsWith('.draft.ts'))
+        return 'authoring-draft';
+    if (filename.endsWith('.manifest.json'))
+        return 'authoring-manifest';
+    if (filename.endsWith('.preview.md') || filename.endsWith('.md'))
+        return 'authoring-explainer';
+    if (filename.endsWith('.patch'))
+        return 'fix-preview';
+    return 'other';
+}
+function scanDirectoryShallow(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const f of readdirSync(dir)) {
+        const abs = nodePath.join(dir, f);
+        try {
+            const st = statSync(abs);
+            if (st.isFile()) {
+                out.push({
+                    filePath: abs,
+                    purpose: detectDraftPurpose(f),
+                    mtime: new Date(st.mtimeMs).toISOString(),
+                });
+            }
+        }
+        catch {
+            // Ignore.
+        }
+    }
+    return out;
+}
+export function buildPackPendingReport(inspection, options = {}) {
+    const root = inspection.projectRoot;
+    const secret = Boolean(process.env['SHARKCRAFT_PACK_SECRET']);
+    const sig = buildPackSignatureStatusReport(inspection);
+    const packs = sig.packs.map((p) => ({
+        packageName: p.packageName,
+        packageRoot: p.packageRoot,
+        modifiedFiles: p.newerContributionFile
+            ? [{ filePath: p.newerContributionFile, mtime: p.newerContributionMtime ?? '' }]
+            : [],
+        signatureStatus: p.status,
+        secretAvailable: p.secretAvailable,
+        ...(p.nextCommand ? { nextCommand: p.nextCommand } : {}),
+    }));
+    const authoringDir = nodePath.join(root, '.sharkcraft', 'authoring');
+    const fixesDir = nodePath.join(root, '.sharkcraft', 'fixes');
+    const draftFiles = [
+        ...scanDirectoryShallow(authoringDir),
+        ...scanDirectoryShallow(fixesDir),
+    ];
+    // Convert absolute paths to project-relative for the report.
+    const draftFilesRel = draftFiles.map((d) => ({
+        ...d,
+        filePath: nodePath.relative(root, d.filePath),
+    }));
+    // Pending provenance — operation=preview without a later apply for the
+    // same (kind, id).
+    const provenance = readProvenance(root);
+    const seenApplied = new Set();
+    const seenRemoved = new Set();
+    for (const e of provenance) {
+        const k = `${e.assetKind}::${e.assetId}`;
+        if (e.operation === AssetProvenanceOperation.Apply)
+            seenApplied.add(k);
+        if (e.operation === AssetProvenanceOperation.Remove)
+            seenRemoved.add(k);
+    }
+    const pendingProvenance = [];
+    const seenPending = new Set();
+    for (const e of provenance) {
+        if (e.operation !== AssetProvenanceOperation.Preview)
+            continue;
+        const k = `${e.assetKind}::${e.assetId}`;
+        if (seenApplied.has(k) || seenRemoved.has(k))
+            continue;
+        if (seenPending.has(k))
+            continue;
+        seenPending.add(k);
+        pendingProvenance.push({
+            assetKind: e.assetKind,
+            assetId: e.assetId,
+            generatedAt: e.generatedAt,
+            ...(e.reason ? { reason: e.reason } : {}),
+        });
+    }
+    const hasPending = packs.some((p) => p.signatureStatus !== PackSignatureStatusKind.Present) ||
+        draftFilesRel.length > 0 ||
+        pendingProvenance.length > 0;
+    const nextCommands = [];
+    nextCommands.push('shrk knowledge stale-check --ci');
+    nextCommands.push('shrk self-config doctor');
+    if (packs.some((p) => p.signatureStatus !== PackSignatureStatusKind.Present)) {
+        if (secret) {
+            nextCommands.push('shrk packs sign --if-needed');
+        }
+        else {
+            nextCommands.push('shrk packs sign --print-command');
+            nextCommands.push('shrk packs sign --write-todo');
+        }
+    }
+    const secretMissingHint = secret
+        ? undefined
+        : 'SHARKCRAFT_PACK_SECRET is not set in this environment. Pack signatures cannot be refreshed automatically; ' +
+            'run `shrk packs sign --print-command` (or `--write-todo`) to obtain the command for a human / signing CI.';
+    void options;
+    return {
+        schema: PACK_PENDING_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        projectRoot: root,
+        secretAvailable: secret,
+        hasPending,
+        packs,
+        draftFiles: draftFilesRel,
+        pendingProvenance,
+        nextCommands,
+        ...(secretMissingHint ? { secretMissingHint } : {}),
+    };
+}
+export function renderPackPendingMarkdown(report) {
+    const lines = [];
+    lines.push('# Pack pending state');
+    lines.push('');
+    lines.push(`Generated: ${report.generatedAt}`);
+    lines.push(`Secret available: ${report.secretAvailable ? 'yes' : 'no'}`);
+    lines.push(`Has pending: ${report.hasPending ? 'yes' : 'no'}`);
+    lines.push('');
+    lines.push('## Packs');
+    lines.push('');
+    if (report.packs.length === 0)
+        lines.push('_(no packs discovered)_');
+    for (const p of report.packs) {
+        lines.push(`- \`${p.packageName}\` — ${p.signatureStatus}${p.modifiedFiles.length > 0 ? ` — modified: ${p.modifiedFiles.map((f) => f.filePath).join(', ')}` : ''}`);
+        if (p.nextCommand)
+            lines.push(`    next: \`${p.nextCommand}\``);
+    }
+    lines.push('');
+    lines.push('## Draft files');
+    lines.push('');
+    if (report.draftFiles.length === 0)
+        lines.push('_(none)_');
+    for (const d of report.draftFiles) {
+        lines.push(`- \`${d.filePath}\` (${d.purpose}, mtime ${d.mtime})`);
+    }
+    lines.push('');
+    lines.push('## Pending provenance');
+    lines.push('');
+    if (report.pendingProvenance.length === 0)
+        lines.push('_(none)_');
+    for (const e of report.pendingProvenance) {
+        lines.push(`- \`${e.assetKind}:${e.assetId}\` (preview at ${e.generatedAt})${e.reason ? ` — ${e.reason}` : ''}`);
+    }
+    lines.push('');
+    if (report.secretMissingHint) {
+        lines.push('## Secret missing');
+        lines.push('');
+        lines.push(report.secretMissingHint);
+        lines.push('');
+    }
+    lines.push('## Next commands');
+    lines.push('');
+    for (const c of report.nextCommands)
+        lines.push(`- \`${c}\``);
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/pack-quality-score.d.ts

@@ -0,0 +1,44 @@
+import type { IDiscoveredPack } from '@shrkcrft/packs';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const PACK_QUALITY_SCHEMA = "sharkcraft.pack-quality-score/v1";
+export declare const PACK_QUALITY_DIFF_SCHEMA = "sharkcraft.pack-quality-diff/v1";
+export interface IPackQualityDiff {
+    schema: typeof PACK_QUALITY_DIFF_SCHEMA;
+    packageName: string;
+    oldOverall: number;
+    newOverall: number;
+    delta: number;
+    dimensionDeltas: readonly {
+        id: string;
+        oldScore: number;
+        newScore: number;
+        delta: number;
+    }[];
+    added: readonly string[];
+    removed: readonly string[];
+    signatureChange?: {
+        from: string;
+        to: string;
+    };
+}
+export declare function diffPackQuality(oldScore: IPackQualityScore, newScore: IPackQualityScore): IPackQualityDiff;
+export interface IPackQualityDimension {
+    id: string;
+    label: string;
+    /** 0–100. */
+    score: number;
+    weight: number;
+    notes: readonly string[];
+}
+export interface IPackQualityScore {
+    schema: typeof PACK_QUALITY_SCHEMA;
+    packageName: string;
+    packageVersion: string;
+    /** Weighted overall score (0–100). */
+    overall: number;
+    dimensions: readonly IPackQualityDimension[];
+    warnings: readonly string[];
+}
+export declare function scorePack(inspection: ISharkcraftInspection, pack: IDiscoveredPack): IPackQualityScore;
+export declare function scoreAllPacks(inspection: ISharkcraftInspection): IPackQualityScore[];
+//# sourceMappingURL=pack-quality-score.d.ts.map

package/dist/pack-quality-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-quality-score.d.ts","sourceRoot":"","sources":["../src/pack-quality-score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AACtE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,gBAAgB,CA2BlB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAMD,wBAAgB,SAAS,CACvB,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAmInB;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAEpF"}

package/dist/pack-quality-score.js

@@ -0,0 +1,155 @@
+import { lintTemplates } from "./template-lint.js";
+import { lintPipelines } from "./pipeline-lint.js";
+export const PACK_QUALITY_SCHEMA = 'sharkcraft.pack-quality-score/v1';
+export const PACK_QUALITY_DIFF_SCHEMA = 'sharkcraft.pack-quality-diff/v1';
+export function diffPackQuality(oldScore, newScore) {
+    const oldDims = new Map(oldScore.dimensions.map((d) => [d.id, d]));
+    const newDims = new Map(newScore.dimensions.map((d) => [d.id, d]));
+    const dimensionDeltas = [];
+    for (const [id, n] of newDims) {
+        const o = oldDims.get(id);
+        dimensionDeltas.push({
+            id,
+            oldScore: o?.score ?? 0,
+            newScore: n.score,
+            delta: n.score - (o?.score ?? 0),
+        });
+    }
+    const added = [];
+    const removed = [];
+    for (const id of newDims.keys())
+        if (!oldDims.has(id))
+            added.push(id);
+    for (const id of oldDims.keys())
+        if (!newDims.has(id))
+            removed.push(id);
+    return {
+        schema: PACK_QUALITY_DIFF_SCHEMA,
+        packageName: newScore.packageName,
+        oldOverall: oldScore.overall,
+        newOverall: newScore.overall,
+        delta: newScore.overall - oldScore.overall,
+        dimensionDeltas,
+        added,
+        removed,
+    };
+}
+function rate(condition, base = 100, penalty = 50) {
+    return condition ? base : base - penalty;
+}
+export function scorePack(inspection, pack) {
+    const dims = [];
+    // Manifest validity.
+    dims.push({
+        id: 'manifest',
+        label: 'Manifest validity',
+        score: rate(pack.valid && !pack.loadError, 100, 60),
+        weight: 1,
+        notes: pack.loadError ? [pack.loadError] : [],
+    });
+    // Signature.
+    const sig = pack.signatureStatus ?? 'not-checked';
+    dims.push({
+        id: 'signature',
+        label: 'Signature',
+        score: sig === 'verified' ? 100 : sig === 'not-checked' ? 70 : 40,
+        weight: 1,
+        notes: pack.signatureMessage ? [pack.signatureMessage] : [],
+    });
+    // Contribution loadability.
+    const resolved = pack.resolvedCounts ?? {
+        knowledgeEntries: 0,
+        rules: 0,
+        pathConventions: 0,
+        templates: 0,
+        pipelines: 0,
+        docs: 0,
+        presets: 0,
+        scaffoldPatterns: 0,
+        policyChecks: 0,
+    };
+    const totalDeclared = pack.contributionCounts.knowledgeFiles +
+        pack.contributionCounts.ruleFiles +
+        pack.contributionCounts.pathFiles +
+        pack.contributionCounts.templateFiles +
+        pack.contributionCounts.pipelineFiles +
+        pack.contributionCounts.docsFiles +
+        pack.contributionCounts.presetFiles +
+        pack.contributionCounts.scaffoldPatternFiles;
+    const totalResolved = resolved.knowledgeEntries +
+        resolved.rules +
+        resolved.pathConventions +
+        resolved.templates +
+        resolved.pipelines +
+        resolved.docs +
+        resolved.presets +
+        resolved.scaffoldPatterns;
+    dims.push({
+        id: 'contributions',
+        label: 'Contributions resolve',
+        score: totalDeclared === 0 ? 60 : Math.min(100, Math.round((totalResolved / totalDeclared) * 100)),
+        weight: 1,
+        notes: totalDeclared === 0 ? ['Pack declares no contributions'] : [],
+    });
+    // Docs presence.
+    dims.push({
+        id: 'docs',
+        label: 'Docs',
+        score: rate((pack.contributionCounts.docsFiles ?? 0) > 0, 100, 30),
+        weight: 0.5,
+        notes: [],
+    });
+    // Templates / pipelines quality.
+    const tplFromPack = inspection.templates.filter((t) => inspection.templateSources.get(t.id)?.packageName === pack.packageName);
+    const pipFromPack = inspection.pipelines.filter((p) => inspection.pipelineSources.get(p.id)?.packageName === pack.packageName);
+    const tplLint = lintTemplates(inspection, tplFromPack.map((t) => t.id));
+    const pipLint = lintPipelines(inspection, pipFromPack.map((p) => p.id));
+    dims.push({
+        id: 'templates-quality',
+        label: 'Templates quality',
+        score: tplFromPack.length === 0 ? 75 : Math.max(0, 100 - tplLint.summary.errors * 20 - tplLint.summary.warnings * 5),
+        weight: 1,
+        notes: tplFromPack.length === 0 ? ['No templates contributed'] : [],
+    });
+    dims.push({
+        id: 'pipelines-quality',
+        label: 'Pipelines quality',
+        score: pipFromPack.length === 0 ? 75 : Math.max(0, 100 - pipLint.summary.errors * 20 - pipLint.summary.warnings * 5),
+        weight: 0.7,
+        notes: pipFromPack.length === 0 ? ['No pipelines contributed'] : [],
+    });
+    // Action hints presence.
+    const packEntries = inspection.knowledgeEntries.filter((e) => inspection.entrySources.get(e.id)?.packageName === pack.packageName);
+    const entriesWithHints = packEntries.filter((e) => e.actionHints !== undefined).length;
+    dims.push({
+        id: 'action-hints',
+        label: 'Action hints',
+        score: packEntries.length === 0 ? 70 : Math.round((entriesWithHints / packEntries.length) * 100),
+        weight: 0.6,
+        notes: [],
+    });
+    // Duplicate ids guard.
+    dims.push({
+        id: 'no-duplicates',
+        label: 'No duplicate ids',
+        score: 100,
+        weight: 0.5,
+        notes: [],
+    });
+    // Weighted overall.
+    const totalWeight = dims.reduce((s, d) => s + d.weight, 0);
+    const overall = totalWeight === 0
+        ? 0
+        : Math.round(dims.reduce((s, d) => s + d.score * d.weight, 0) / totalWeight);
+    return {
+        schema: PACK_QUALITY_SCHEMA,
+        packageName: pack.packageName,
+        packageVersion: pack.packageVersion,
+        overall,
+        dimensions: dims,
+        warnings: [],
+    };
+}
+export function scoreAllPacks(inspection) {
+    return inspection.packs.validPacks.map((p) => scorePack(inspection, p));
+}

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

@@ -0,0 +1,24 @@
+export declare const PACK_RELEASE_CHECK_SCHEMA = "sharkcraft.pack-release-check/v1";
+export type CheckSeverity = 'info' | 'warning' | 'error';
+export interface IPackReleaseFinding {
+    code: string;
+    severity: CheckSeverity;
+    message: string;
+    /** Free-text guidance for the human reviewer. */
+    suggestedFix?: string;
+    /** Optional copy-pasteable shell command for the human reviewer. */
+    suggestedCommand?: string;
+    /** Path of the offending file (when applicable). */
+    file?: string;
+}
+export interface IPackReleaseCheck {
+    schema: typeof PACK_RELEASE_CHECK_SCHEMA;
+    packPath: string;
+    manifestFile: string | null;
+    packageJsonFile: string | null;
+    contributionsFound: number;
+    findings: readonly IPackReleaseFinding[];
+    passed: boolean;
+}
+export declare function runPackReleaseCheck(packPath: string): Promise<IPackReleaseCheck>;
+//# sourceMappingURL=pack-release-check.d.ts.map

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

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