upstream-radar 0.40.0 → 0.41.0

package/dist/src/dsh-compatibility-issues.js

@@ -0,0 +1,185 @@
+import { parseDshCompatibilityLedger, } from './dsh-compatibility-ledger.js';
+const CASE_MARKER = /<!-- upstream-radar:dsh-compatibility-case=([a-z0-9][a-z0-9._-]{0,63}) -->/;
+const ACTIONABLE_RESULTS = new Set([
+    'runtime-incompatible',
+    'peer-contract-incompatible',
+    'install-failed',
+    'load-failed',
+]);
+export const DSH_COMPATIBILITY_ISSUE_LABELS = ['upstream-radar', 'dsh-compatibility'];
+function inline(value, maximum = 1_024) {
+    return value
+        .replace(/[\u0000-\u001f\u007f`|<>]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, maximum);
+}
+function runLink(runUrl) {
+    if (runUrl === undefined)
+        return 'not recorded';
+    try {
+        const parsed = new URL(runUrl);
+        if (parsed.protocol !== 'https:')
+            return 'not recorded';
+        return `[GitHub Actions evidence](${parsed.toString()})`;
+    }
+    catch {
+        return 'not recorded';
+    }
+}
+export function dshCompatibilityIssueMarker(caseId) {
+    if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(caseId))
+        throw new Error(`invalid DSH compatibility case id: ${caseId}`);
+    return `<!-- upstream-radar:dsh-compatibility-case=${caseId} -->`;
+}
+export function dshCompatibilityIssueCaseId(body) {
+    return CASE_MARKER.exec(body)?.[1];
+}
+function repairPath(entry) {
+    if (entry.result === 'runtime-incompatible') {
+        return [
+            'Confirm which Node.js majors the plugin and DSH release are intended to support.',
+            'Align the published `engines.node` contract or add a tested runtime cell that satisfies it.',
+        ];
+    }
+    if (entry.result === 'peer-contract-incompatible') {
+        return [
+            'Align required DSH/React peer ranges with the versions the final DSH profile actually provides.',
+            'Re-run the same plugin, DSH and Node cell; a successful headless boot alone is not enough when a required peer remains missing or mismatched.',
+        ];
+    }
+    if (entry.result === 'install-failed') {
+        return [
+            'Reproduce the package-manager failure with the exact artifact and approved dependency-build policy below.',
+            'Publish a corrected artifact or narrow the supported DSH/runtime contract, then let Radar perform the next clean install.',
+        ];
+    }
+    return [
+        'Reproduce the DSH registration/import/boot failure with the exact coordinates below.',
+        'Fix the runtime integration or declare the unsupported DSH boundary, then let Radar perform the next clean load.',
+    ];
+}
+function peerEvidence(entry) {
+    const contracts = entry.resolution?.runtimeGraph?.pluginPeerContracts;
+    if (contracts === undefined)
+        return [];
+    const lines = [
+        '',
+        '### Direct host contracts',
+        '',
+        `- Declared: **${contracts.declared}**; satisfied: **${contracts.satisfied}**; mismatched: **${contracts.mismatched}**; missing: **${contracts.missing}**; indeterminate: **${contracts.indeterminate}**.`,
+    ];
+    for (const issue of contracts.issues ?? []) {
+        lines.push(`- \`${inline(issue.name, 214)}\`: ${inline(issue.status, 32)}; requires \`${inline(issue.required, 512)}\`${issue.resolvedVersion === undefined ? '' : `, resolved \`${inline(issue.resolvedVersion, 256)}\``}; static use: \`${inline(issue.staticUsage, 64)}\`.`);
+    }
+    return lines;
+}
+export function renderDshCompatibilityIssue(entry, runUrl) {
+    const title = `[DSH compatibility] ${inline(entry.plugin, 160)} on DSH ${inline(entry.dshVersion, 64)} / Node ${entry.runtime.nodeMajor}: ${entry.result}`.slice(0, 256);
+    const graph = entry.resolution?.runtimeGraph;
+    const lockfile = entry.resolution?.profileLockfile;
+    const lines = [
+        dshCompatibilityIssueMarker(entry.caseId),
+        '',
+        'Upstream Radar reproduced an incompatibility in a disposable GitHub-hosted environment. This is an internal compatibility incident; forward it to an upstream author only after reviewing the attached evidence.',
+        '',
+        '### Exact cell',
+        '',
+        `- Plugin: \`${inline(entry.plugin, 512)}\``,
+        `- DSH: \`@deepseek-ai/dsh@${inline(entry.dshVersion, 128)}\``,
+        `- Runtime: Node \`${inline(entry.runtime.nodeVersion, 64)}\` on \`${inline(`${entry.runtime.platform}/${entry.runtime.architecture}`, 128)}\``,
+        `- Result: \`${entry.result}\``,
+        `- Observed: \`${inline(entry.observedAt, 64)}\``,
+        `- Artifact: ${entry.artifact.sha256 === undefined ? 'digest unavailable' : `\`sha256:${inline(entry.artifact.sha256, 64)}\``}`,
+        `- Evidence run: ${runLink(runUrl)}`,
+        '',
+        '### Reproduced failure',
+        '',
+        inline(entry.reason, 4_096),
+    ];
+    if (graph !== undefined || lockfile !== undefined) {
+        lines.push('', '### Dependency evidence', '', `- Final profile graph: ${lockfile === undefined ? 'not established' : `${lockfile.nodes} node(s), ${lockfile.edges} edge(s), ${lockfile.unresolved} unresolved edge(s)`}.`, `- Effective runtime graph: ${graph === undefined ? 'not established' : `${graph.nodes} node(s), ${graph.edges} edge(s), ${graph.unresolved} required unresolved edge(s)`}.`);
+    }
+    lines.push(...peerEvidence(entry), '', '### Repair path', '');
+    for (const item of repairPath(entry))
+        lines.push(`- ${item}`);
+    lines.push('', 'This issue is managed by Upstream Radar. A later compatible observation for the same maintained cell will add a resolution note and close it automatically.', '', '_Bounded compatibility evidence is not a claim that third-party code is safe or malicious._', '');
+    return { title, body: lines.join('\n').slice(0, 60_000) };
+}
+export function renderDshCompatibilityResolution(entry, runUrl) {
+    return [
+        `<!-- upstream-radar:dsh-compatibility-resolution=${entry.caseId}:${entry.contractFingerprint} -->`,
+        '',
+        'Upstream Radar re-ran this maintained cell in a fresh isolated environment and the exact package now installs, registers and loads with a complete required host contract.',
+        '',
+        `- Plugin: \`${inline(entry.plugin, 512)}\``,
+        `- DSH: \`@deepseek-ai/dsh@${inline(entry.dshVersion, 128)}\``,
+        `- Runtime: Node \`${inline(entry.runtime.nodeVersion, 64)}\``,
+        `- Observed: \`${inline(entry.observedAt, 64)}\``,
+        `- Evidence run: ${runLink(runUrl)}`,
+        '',
+        'Closing this compatibility incident as verified resolved.',
+    ].join('\n');
+}
+function existingByCase(issues) {
+    const result = new Map();
+    for (const issue of issues) {
+        if (!Number.isSafeInteger(issue.number) || issue.number < 1)
+            throw new Error('existing compatibility issue has an invalid number');
+        if (issue.state !== 'open' && issue.state !== 'closed')
+            throw new Error(`issue #${issue.number} has an invalid state`);
+        const caseId = dshCompatibilityIssueCaseId(issue.body);
+        if (caseId === undefined)
+            continue;
+        const duplicate = result.get(caseId);
+        if (duplicate !== undefined)
+            throw new Error(`duplicate managed compatibility issues for ${caseId}: #${duplicate.number} and #${issue.number}`);
+        result.set(caseId, issue);
+    }
+    return result;
+}
+/** Build an idempotent desired-state plan for issues in Radar's own repository. */
+export function buildDshCompatibilityIssuePlan(input) {
+    const ledger = parseDshCompatibilityLedger(input.ledger);
+    const existing = existingByCase(input.existingIssues);
+    const actions = [];
+    const openCaseIds = [];
+    const ignoredUnknownCaseIds = [];
+    for (const entry of ledger.entries) {
+        const issue = existing.get(entry.caseId);
+        if (entry.result === 'unknown') {
+            ignoredUnknownCaseIds.push(entry.caseId);
+            continue;
+        }
+        if (entry.result === 'compatible') {
+            if (issue?.state === 'open') {
+                actions.push({
+                    kind: 'close',
+                    caseId: entry.caseId,
+                    issueNumber: issue.number,
+                    comment: renderDshCompatibilityResolution(entry, input.runUrl),
+                });
+            }
+            continue;
+        }
+        if (!ACTIONABLE_RESULTS.has(entry.result))
+            continue;
+        openCaseIds.push(entry.caseId);
+        const rendered = renderDshCompatibilityIssue(entry, input.runUrl);
+        if (issue === undefined) {
+            actions.push({ kind: 'create', caseId: entry.caseId, ...rendered });
+        }
+        else if (issue.state === 'closed') {
+            actions.push({ kind: 'reopen', caseId: entry.caseId, issueNumber: issue.number, ...rendered });
+        }
+        else if (issue.title !== rendered.title || issue.body !== rendered.body) {
+            actions.push({ kind: 'update', caseId: entry.caseId, issueNumber: issue.number, ...rendered });
+        }
+    }
+    return {
+        actions,
+        openCaseIds: openCaseIds.sort(),
+        ignoredUnknownCaseIds: ignoredUnknownCaseIds.sort(),
+    };
+}
+//# sourceMappingURL=dsh-compatibility-issues.js.map

package/dist/src/dsh-compatibility-issues.js.map

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

package/dist/src/dsh-compatibility-ledger.d.ts

@@ -0,0 +1,150 @@
+import type { DshInstallObservationResult, DshInstallPeerStaticUsage } from './dsh-install-observation.js';
+/**
+ * Durable, current-state evidence for the exact plugin/DSH/runtime cells that
+ * Radar promises to keep checking. This is deliberately a ledger, not a test
+ * history database: one entry represents the latest trustworthy observation
+ * for one active cell.
+ */
+export declare const DSH_COMPATIBILITY_LEDGER_SCHEMA: 'upstream-radar.dsh-compatibility-ledger/v1alpha1';
+export interface DshCompatibilityProfileLockfile {
+    sha256: string;
+    bytes: number;
+    graphDigest?: string;
+    nodes?: number;
+    edges?: number;
+    unresolved?: number;
+    unresolvedDependencies?: DshCompatibilityProfileGraphGap[];
+}
+export interface DshCompatibilityProfileGraphGap {
+    from: string;
+    name: string;
+    spec: string;
+    kind: 'runtime' | 'development' | 'optional' | 'peer' | 'host-runtime';
+}
+export interface DshCompatibilityRuntimeGraph {
+    digest: string;
+    nodes: number;
+    edges: number;
+    /** Required runtime/peer gaps; optional platform variants are kept separately. */
+    unresolved: number;
+    unresolvedDependencies?: DshCompatibilityProfileGraphGap[];
+    optionalUnavailable?: number;
+    optionalUnavailableDependencies?: DshCompatibilityProfileGraphGap[];
+    pluginPeerContracts?: DshCompatibilityPluginPeerContracts;
+    hostRuntime?: {
+        source: 'dsh-profile-fallback' | 'dsh-process';
+        resolvedNodes: number;
+        dshVersion?: string;
+    };
+}
+export interface DshCompatibilityPeerContractIssue {
+    name: string;
+    required: string;
+    status: 'mismatched' | 'indeterminate' | 'missing';
+    staticUsage: DshInstallPeerStaticUsage;
+    resolvedVersion?: string;
+}
+/** One exact plugin peer relation, kept for the reverse compatibility index. */
+export interface DshCompatibilityPeerContractRelation {
+    name: string;
+    required: string;
+    status: 'satisfied' | 'mismatched' | 'indeterminate' | 'missing';
+    staticUsage: DshInstallPeerStaticUsage;
+    resolvedVersion?: string;
+}
+export interface DshCompatibilityPluginPeerContracts {
+    declared: number;
+    satisfied: number;
+    mismatched: number;
+    indeterminate: number;
+    missing: number;
+    relations: DshCompatibilityPeerContractRelation[];
+    issues?: DshCompatibilityPeerContractIssue[];
+}
+export interface DshCompatibilityLedgerEntry {
+    caseId: string;
+    targetId: string;
+    plugin: string;
+    dshVersion: string;
+    runtime: {
+        nodeMajor: number;
+        nodeVersion: string;
+        platform: string;
+        architecture: string;
+        pnpmVersion?: string;
+    };
+    staticFingerprint: string;
+    contractFingerprint: string;
+    observedAt: string;
+    result: DshInstallObservationResult;
+    reason: string;
+    artifact: {
+        lifecycleScripts: string[];
+        sha256?: string;
+        integrity?: string;
+        nodeEngine?: string;
+    };
+    resolution?: {
+        profileLockfile?: DshCompatibilityProfileLockfile;
+        runtimeGraph?: DshCompatibilityRuntimeGraph;
+    };
+    observer: {
+        schema: string;
+        version: string;
+    };
+}
+export interface DshCompatibilityLedger {
+    schema: typeof DSH_COMPATIBILITY_LEDGER_SCHEMA;
+    entries: DshCompatibilityLedgerEntry[];
+}
+/** One matrix entry sent from the static reconciler to the isolated runner. */
+export interface DshCompatibilityExpectedCase {
+    id: string;
+    targetId: string;
+    plugin: string;
+    dshVersion: string;
+    nodeMajor: number;
+    allowedBuilds: string;
+    staticFingerprint: string;
+    contractFingerprint: string;
+    reasons: string[];
+}
+export type DshCompatibilityTransitionStatus = 'compatible' | 'artifact-drift' | 'resolution-drift' | 'new-incompatibility' | 'changed-incompatibility' | 'resolved-incompatibility' | 'persisting-incompatibility';
+export interface DshCompatibilityTransition {
+    caseId: string;
+    status: DshCompatibilityTransitionStatus;
+    result: DshInstallObservationResult;
+    reason: string;
+    previousResult?: DshInstallObservationResult;
+}
+export interface DshCompatibilityLedgerMerge {
+    ledger: DshCompatibilityLedger;
+    transitions: DshCompatibilityTransition[];
+    acceptedCaseIds: string[];
+    missingCaseIds: string[];
+    rejectedReports: string[];
+}
+export declare function emptyDshCompatibilityLedger(): DshCompatibilityLedger;
+export declare function parseDshCompatibilityLedger(input: unknown): DshCompatibilityLedger;
+/** Static facts that may invalidate a prior runtime observation. */
+export declare function createDshCompatibilityStaticFingerprint(value: unknown): string;
+/** The controlled execution contract, deliberately separate from source facts. */
+export declare function createDshCompatibilityContractFingerprint(value: {
+    plugin: string;
+    dshVersion: string;
+    nodeMajor: number;
+    allowedBuilds: readonly string[];
+}): string;
+export declare function dshCompatibilityCaseId(targetId: string, runtimeProfileId: string): string;
+/**
+ * Merge only reports that prove they belong to a scheduled exact cell. Bad or
+ * absent reports never become a green result; absent cells stay missing and
+ * therefore are planned again on the next reconciliation.
+ */
+export declare function mergeDshCompatibilityLedger(input: {
+    ledger: DshCompatibilityLedger;
+    expected: readonly DshCompatibilityExpectedCase[];
+    reports: readonly unknown[];
+}): DshCompatibilityLedgerMerge;
+export declare function renderDshCompatibilityLedgerMerge(merge: DshCompatibilityLedgerMerge): string;
+//# sourceMappingURL=dsh-compatibility-ledger.d.ts.map

package/dist/src/dsh-compatibility-ledger.d.ts.map

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