easyeda-mcp-pro 0.35.3 → 0.35.4

package/README.md

@@ -42,8 +42,9 @@
   </a>
 </p>
 
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/oaslananka/easyeda-mcp-pro)
+
 <p>
-  <a href="https://deepwiki.com/oaslananka/easyeda-mcp-pro">Ask DeepWiki</a> ·
   <a href="docs/ROADMAP.md">Roadmap</a> ·
   <a href="docs/OPENSSF_BEST_PRACTICES.md">OpenSSF evidence</a> ·
   <a href="docs/SECURITY_ASSURANCE_CASE.md">Security assurance case</a>

package/dist/config/version.d.ts

@@ -1 +1 @@
-export declare const SERVER_VERSION = "0.35.3";
+export declare const SERVER_VERSION = "0.35.4";

package/dist/config/version.js

@@ -1,2 +1,2 @@
-export const SERVER_VERSION = '0.35.3'; // x-release-please-version
+export const SERVER_VERSION = '0.35.4'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/dist/live/schematic-transaction-smoke-report.d.ts

@@ -0,0 +1,96 @@
+export declare function sortUnknownForStableHash(value: unknown): unknown;
+export declare function extractPrimitiveId(value: unknown): string | undefined;
+export declare function primitiveDescriptorHash(snapshot: unknown): string;
+export declare function extractPrimitiveIds(value: unknown): string[];
+export interface SchematicTransactionFixtureIdentity {
+    project: string;
+    schematic: string;
+    page: string;
+    disposable: true;
+}
+export interface SchematicTransactionRuntimeIdentity {
+    projectInfo: unknown;
+    schematicInfo: unknown;
+    pageInfo: unknown;
+}
+export interface SchematicTransactionFixtureMismatch {
+    field: 'project' | 'schematic' | 'page';
+    expected: string;
+    actual?: string;
+}
+export declare function verifySchematicTransactionFixtureIdentity(expected: SchematicTransactionFixtureIdentity, runtime: SchematicTransactionRuntimeIdentity): {
+    ok: boolean;
+    actual: {
+        project?: string;
+        schematic?: string;
+        page?: string;
+    };
+    mismatches: SchematicTransactionFixtureMismatch[];
+};
+export interface SchematicTransactionStateDigest {
+    primitiveInventoryHash: string;
+    componentHash: string;
+    netHash: string;
+    ercAvailable: boolean;
+    ercHash?: string;
+}
+export interface SchematicTransactionOutcome {
+    passed: boolean;
+    rolledBack: boolean;
+    stateRestored: boolean;
+    details?: Record<string, unknown>;
+}
+export interface SchematicTransactionSmokeInput {
+    generatedAt?: string;
+    environment: {
+        operatingSystem: string;
+        architecture: string;
+        nodeVersion: string;
+    };
+    fixture: SchematicTransactionFixtureIdentity;
+    bridge: {
+        easyedaVersion?: string;
+        bridgeVersion?: string;
+        dispatcherBuildId?: string;
+        methodRegistryHash?: string;
+        activePort?: number;
+    };
+    outcomes: {
+        createRollback: SchematicTransactionOutcome;
+        modifyRollback: SchematicTransactionOutcome;
+        deleteRollback: SchematicTransactionOutcome;
+    };
+    cleanup: {
+        remainingIds: string[];
+        errors: string[];
+    };
+    baseline: SchematicTransactionStateDigest;
+    finalState: SchematicTransactionStateDigest;
+    error?: string;
+}
+export type SchematicTransactionSmokeCheckId = 'create-rollback' | 'modify-rollback' | 'delete-rollback' | 'final-state-restored';
+export interface SchematicTransactionSmokeCheck {
+    id: SchematicTransactionSmokeCheckId;
+    status: 'passed' | 'failed';
+    details: Record<string, unknown>;
+}
+export interface SchematicTransactionSmokeReport {
+    schemaVersion: 1;
+    status: 'passed' | 'failed';
+    generatedAt: string;
+    environment: SchematicTransactionSmokeInput['environment'];
+    fixture: SchematicTransactionFixtureIdentity;
+    bridge: SchematicTransactionSmokeInput['bridge'];
+    checks: SchematicTransactionSmokeCheck[];
+    cleanup: {
+        clean: boolean;
+        remainingIds: string[];
+        errors: string[];
+    };
+    baseline: SchematicTransactionStateDigest;
+    finalState: SchematicTransactionStateDigest;
+    error?: string;
+}
+export declare function compareSchematicTransactionState(baseline: SchematicTransactionStateDigest, finalState: SchematicTransactionStateDigest): Record<string, boolean>;
+export declare function buildSchematicTransactionSmokeReport(input: SchematicTransactionSmokeInput): SchematicTransactionSmokeReport;
+export declare function writeSchematicTransactionSmokeReport(path: string, report: SchematicTransactionSmokeReport): Promise<void>;

package/dist/live/schematic-transaction-smoke-report.js

@@ -0,0 +1,160 @@
+import { mkdir, rename, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { stableHash } from '../transactions/stable.js';
+export function sortUnknownForStableHash(value) {
+    if (Array.isArray(value)) {
+        return value
+            .map(sortUnknownForStableHash)
+            .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, sortUnknownForStableHash(nested)]));
+    }
+    return value;
+}
+const PRIMITIVE_ID_KEYS = ['primitiveId', 'primitiveUuid', 'id', 'uuid'];
+const PRIMITIVE_NESTED_KEYS = ['result', 'data', 'text', 'rectangle'];
+export function extractPrimitiveId(value) {
+    if (typeof value === 'string')
+        return value.trim() || undefined;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const id = extractPrimitiveId(item);
+            if (id)
+                return id;
+        }
+        return undefined;
+    }
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    for (const key of PRIMITIVE_ID_KEYS) {
+        const id = extractPrimitiveId(record[key]);
+        if (id)
+            return id;
+    }
+    for (const key of PRIMITIVE_NESTED_KEYS) {
+        const id = extractPrimitiveId(record[key]);
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+export function primitiveDescriptorHash(snapshot) {
+    if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) {
+        return stableHash(snapshot);
+    }
+    const copy = structuredClone(snapshot);
+    delete copy.primitiveId;
+    return stableHash(copy);
+}
+export function extractPrimitiveIds(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return [];
+    const primitiveIds = value.primitiveIds;
+    return Array.isArray(primitiveIds)
+        ? primitiveIds
+            .filter((id) => typeof id === 'string' && id.length > 0)
+            .sort((a, b) => a.localeCompare(b))
+        : [];
+}
+function recordString(value, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    for (const key of keys) {
+        const candidate = record[key];
+        if (typeof candidate === 'string' && candidate.trim())
+            return candidate.trim();
+    }
+    return undefined;
+}
+export function verifySchematicTransactionFixtureIdentity(expected, runtime) {
+    const actual = {
+        project: recordString(runtime.projectInfo, ['friendlyName', 'name']),
+        schematic: recordString(runtime.schematicInfo, ['name']),
+        page: recordString(runtime.pageInfo, ['name']),
+    };
+    const mismatches = [];
+    for (const field of ['project', 'schematic', 'page']) {
+        if (actual[field] !== expected[field]) {
+            mismatches.push({
+                field,
+                expected: expected[field],
+                ...(actual[field] ? { actual: actual[field] } : {}),
+            });
+        }
+    }
+    return { ok: mismatches.length === 0, actual, mismatches };
+}
+function outcomeCheck(id, outcome) {
+    const passed = outcome.passed && outcome.rolledBack && outcome.stateRestored;
+    return {
+        id,
+        status: passed ? 'passed' : 'failed',
+        details: {
+            passed: outcome.passed,
+            rolledBack: outcome.rolledBack,
+            stateRestored: outcome.stateRestored,
+            ...(outcome.details ?? {}),
+        },
+    };
+}
+export function compareSchematicTransactionState(baseline, finalState) {
+    const ercComparable = baseline.ercAvailable && finalState.ercAvailable;
+    return {
+        primitiveInventoryHashEqual: baseline.primitiveInventoryHash === finalState.primitiveInventoryHash,
+        componentHashEqual: baseline.componentHash === finalState.componentHash,
+        netHashEqual: baseline.netHash === finalState.netHash,
+        ercComparable,
+        ercStateEqual: !ercComparable || baseline.ercHash === finalState.ercHash,
+    };
+}
+export function buildSchematicTransactionSmokeReport(input) {
+    const finalComparison = compareSchematicTransactionState(input.baseline, input.finalState);
+    const finalStatePassed = finalComparison.primitiveInventoryHashEqual &&
+        finalComparison.componentHashEqual &&
+        finalComparison.netHashEqual &&
+        finalComparison.ercStateEqual;
+    const checks = [
+        outcomeCheck('create-rollback', input.outcomes.createRollback),
+        outcomeCheck('modify-rollback', input.outcomes.modifyRollback),
+        outcomeCheck('delete-rollback', input.outcomes.deleteRollback),
+        {
+            id: 'final-state-restored',
+            status: finalStatePassed ? 'passed' : 'failed',
+            details: finalComparison,
+        },
+    ];
+    const cleanup = {
+        clean: input.cleanup.remainingIds.length === 0 && input.cleanup.errors.length === 0,
+        remainingIds: [...input.cleanup.remainingIds],
+        errors: [...input.cleanup.errors],
+    };
+    const status = checks.every((check) => check.status === 'passed') && cleanup.clean && !input.error
+        ? 'passed'
+        : 'failed';
+    return {
+        schemaVersion: 1,
+        status,
+        generatedAt: input.generatedAt ?? new Date().toISOString(),
+        environment: input.environment,
+        fixture: input.fixture,
+        bridge: input.bridge,
+        checks,
+        cleanup,
+        baseline: input.baseline,
+        finalState: input.finalState,
+        ...(input.error ? { error: input.error } : {}),
+    };
+}
+export async function writeSchematicTransactionSmokeReport(path, report) {
+    const absolutePath = resolve(path);
+    await mkdir(dirname(absolutePath), { recursive: true });
+    const temporaryPath = `${absolutePath}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(temporaryPath, `${JSON.stringify(report, null, 2)}\n`, 'utf8');
+    await rename(temporaryPath, absolutePath);
+}
+//# sourceMappingURL=schematic-transaction-smoke-report.js.map

package/dist/live/schematic-transaction-smoke-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematic-transaction-smoke-report.js","sourceRoot":"","sources":["../../src/live/schematic-transaction-smoke-report.ts"],"names":[],"mappings":"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"}

package/dist/release/published-release-verifier.d.ts

@@ -0,0 +1,56 @@
+export type ReleaseChannel = 'stable' | 'prerelease';
+export type ProvenanceObservation = 'passed' | 'failed' | 'unverified';
+export type ReleaseVerificationCheckStatus = 'passed' | 'failed';
+export interface ReleaseVerificationExpectation {
+    repository: string;
+    packageName: string;
+    mcpName: string;
+    version: string;
+    tag: string;
+    channel: ReleaseChannel;
+    npmDistTag: string;
+    commitSha: string;
+    requiredAssets: string[];
+    requiredGhcrTags: string[];
+}
+export interface ReleaseAssetObservation {
+    name: string;
+    digest?: string;
+}
+export interface ReleaseVerificationObservation {
+    npm: {
+        version?: string;
+        distTags: Record<string, string | undefined>;
+        provenance: ProvenanceObservation;
+        workflowContextProof?: boolean;
+    };
+    github: {
+        tag?: string;
+        tagCommitSha?: string;
+        isDraft?: boolean;
+        isPrerelease?: boolean;
+        assets: ReleaseAssetObservation[];
+    };
+    ghcr: {
+        digest?: string;
+        tags: string[];
+    };
+    mcpRegistry: {
+        version?: string;
+        isLatest?: boolean;
+    } | null;
+}
+export type ReleaseVerificationCheckId = 'npm-version' | 'npm-dist-tag' | 'npm-provenance' | 'github-tag' | 'github-tag-commit' | 'github-classification' | 'github-assets' | 'ghcr-tags' | 'mcp-registry';
+export interface ReleaseVerificationCheck {
+    id: ReleaseVerificationCheckId;
+    status: ReleaseVerificationCheckStatus;
+    expected: unknown;
+    actual: unknown;
+    message?: string;
+}
+export interface ReleaseVerificationReport {
+    ok: boolean;
+    checks: ReleaseVerificationCheck[];
+    failures: ReleaseVerificationCheck[];
+}
+export declare function verifyPublishedReleaseObservation(expectation: ReleaseVerificationExpectation, observation: ReleaseVerificationObservation): ReleaseVerificationReport;

package/dist/release/published-release-verifier.js

@@ -0,0 +1,63 @@
+function check(id, passed, expected, actual, message) {
+    return {
+        id,
+        status: passed ? 'passed' : 'failed',
+        expected,
+        actual,
+        ...(message ? { message } : {}),
+    };
+}
+function sortedUnique(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+function sameStringSet(expected, actual) {
+    const normalizedExpected = sortedUnique(expected);
+    const normalizedActual = sortedUnique(actual);
+    return (normalizedExpected.length === normalizedActual.length &&
+        normalizedExpected.every((value, index) => value === normalizedActual[index]));
+}
+export function verifyPublishedReleaseObservation(expectation, observation) {
+    const expectedPrerelease = expectation.channel === 'prerelease';
+    const assetByName = new Map(observation.github.assets.map((asset) => [asset.name, asset]));
+    const missingOrUndigestedAssets = expectation.requiredAssets.filter((name) => {
+        const asset = assetByName.get(name);
+        return !asset || typeof asset.digest !== 'string' || asset.digest.trim().length === 0;
+    });
+    const provenancePassed = observation.npm.provenance === 'passed' || observation.npm.workflowContextProof === true;
+    const provenanceActual = {
+        registry: observation.npm.provenance,
+        workflowContextProof: observation.npm.workflowContextProof === true,
+    };
+    const ghcrDigestPresent = typeof observation.ghcr.digest === 'string' && observation.ghcr.digest.trim().length > 0;
+    const ghcrTagsMatch = sameStringSet(expectation.requiredGhcrTags, observation.ghcr.tags);
+    const mcpPassed = expectation.channel === 'stable'
+        ? observation.mcpRegistry?.version === expectation.version &&
+            observation.mcpRegistry?.isLatest === true
+        : observation.mcpRegistry === null;
+    const checks = [
+        check('npm-version', observation.npm.version === expectation.version, expectation.version, observation.npm.version, 'The exact npm package version must match the release version.'),
+        check('npm-dist-tag', observation.npm.distTags[expectation.npmDistTag] === expectation.version, { [expectation.npmDistTag]: expectation.version }, { [expectation.npmDistTag]: observation.npm.distTags[expectation.npmDistTag] }, 'The channel-specific npm dist-tag must point to the exact release version.'),
+        check('npm-provenance', provenancePassed, 'registry provenance passed or workflow-context proof present', provenanceActual, 'The npm package must have registry provenance or verified workflow-context proof.'),
+        check('github-tag', observation.github.tag === expectation.tag, expectation.tag, observation.github.tag, 'The GitHub Release tag must match the expected immutable release tag.'),
+        check('github-tag-commit', observation.github.tagCommitSha === expectation.commitSha, expectation.commitSha, observation.github.tagCommitSha, 'The release tag must resolve to the expected candidate commit.'),
+        check('github-classification', observation.github.isDraft === false &&
+            observation.github.isPrerelease === expectedPrerelease, { isDraft: false, isPrerelease: expectedPrerelease }, {
+            isDraft: observation.github.isDraft,
+            isPrerelease: observation.github.isPrerelease,
+        }, 'The GitHub Release draft/prerelease classification must match the channel.'),
+        check('github-assets', missingOrUndigestedAssets.length === 0, expectation.requiredAssets, observation.github.assets, missingOrUndigestedAssets.length > 0
+            ? `Missing or undigested assets: ${missingOrUndigestedAssets.join(', ')}`
+            : undefined),
+        check('ghcr-tags', ghcrDigestPresent && ghcrTagsMatch, { digest: 'non-empty', tags: sortedUnique(expectation.requiredGhcrTags) }, { digest: observation.ghcr.digest, tags: sortedUnique(observation.ghcr.tags) }, 'All exact and moving GHCR tags must resolve to one non-empty image digest.'),
+        check('mcp-registry', mcpPassed, expectation.channel === 'stable' ? { version: expectation.version, isLatest: true } : null, observation.mcpRegistry, expectation.channel === 'stable'
+            ? 'Stable releases must be present in the MCP Registry and marked latest.'
+            : 'Prereleases must not be published to the MCP Registry.'),
+    ];
+    const failures = checks.filter((item) => item.status === 'failed');
+    return {
+        ok: failures.length === 0,
+        checks,
+        failures,
+    };
+}
+//# sourceMappingURL=published-release-verifier.js.map

package/dist/release/published-release-verifier.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easyeda-mcp-pro",
-  "version": "0.35.3",
+  "version": "0.35.4",
   "mcpName": "io.github.oaslananka/easyeda-mcp-pro",
   "description": "MCP server for EasyEDA Pro: PCB inspection, BOM, exports, and hardware review.",
   "keywords": [
@@ -112,7 +112,8 @@
     "generate:capability-docs": "tsx scripts/update-capability-counts.mts",
     "check:capability-docs": "tsx scripts/update-capability-counts.mts --check",
     "release:readiness": "node scripts/check-release-readiness.mjs",
-    "release:readiness:compatibility": "node scripts/check-release-readiness.mjs --compatibility-only"
+    "release:readiness:compatibility": "node scripts/check-release-readiness.mjs --compatibility-only",
+    "release:verify-published": "node scripts/verify-published-release.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",