dsh-research-report 0.1.0

package/lib/types/verify.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Claim verification: the built-in byte-level check plus the optional numeric
+ * bridge to `ctx.dataQuality`.
+ *
+ * Byte-level semantics (v1 is deliberately NON-semantic): every number and
+ * quoted span in the claim text must be locatable VERBATIM in the bound
+ * evidence snapshots. A citation that cannot be located makes the claim
+ * `unverified`; a number whose left-context label appears in the snapshot
+ * followed by a DIFFERENT number makes the claim `contradicted`. The check
+ * proves "the claimed literals exist in the captured bytes", nothing more.
+ *
+ * The `CitationCheckRequest` / `CitationCheckResult` block below is BYTE-FROZEN:
+ * it is the structural surface of the optional `ctx.dataQuality` service
+ * (provided by the sibling dsh-data-quality plugin, consumed via `ctx.get` —
+ * never imported, never injected). `scripts/verify-frozen-contract.mjs` gates
+ * drift.
+ *
+ * @module dsh-research-report/verify
+ */
+export interface CitationCheckRequest {
+    /** Workspace-relative path of the source dataset snapshot (CSV/JSON). */
+    dataset: string;
+    /** Citations to verify against the dataset. */
+    citations: Array<{
+        /** Stable id chosen by the caller, echoed back in results. */
+        id: string;
+        /** JSON-path-ish locator, e.g. "rows[3].nav" or "summary.annualReturn". */
+        path: string;
+        /** The value as cited in the document. */
+        value: number | string;
+        /** Optional relative tolerance for numeric comparison, e.g. 0.01 = 1%. */
+        tolerance?: number;
+    }>;
+}
+export interface CitationCheckResult {
+    results: Array<{
+        id: string;
+        status: 'verified' | 'mismatch' | 'not-found' | 'unverifiable';
+        /** Actual value found at path, when found. */
+        actual?: number | string;
+        /** Human-readable evidence note. */
+        note?: string;
+    }>;
+}
+/**
+ * The structural surface of the optional `ctx.dataQuality` service. Declared
+ * locally (never imported from the sibling package) and reached via
+ * `ctx.get('dataQuality')` + an `as unknown as` assertion.
+ */
+export interface DataQualityBridge {
+    /**
+     * Verify citations against a structured dataset snapshot.
+     * @param request - the dataset and its citations.
+     * @returns per-citation outcomes.
+     */
+    verifyCitations(request: CitationCheckRequest): Promise<CitationCheckResult>;
+}
+/** One literal citation extracted from a claim text. */
+export interface Citation {
+    /** What kind of literal this is. */
+    kind: 'number' | 'quote';
+    /** The literal text that must be locatable verbatim in bound evidence. */
+    text: string;
+    /** Left-context label of a number citation (drives the contradiction check). */
+    context?: string;
+}
+/**
+ * Extract the trailing context label of a number citation: up to 24 characters
+ * before the number, trimmed to its trailing label run. Too-short labels are
+ * dropped (a weak label would false-positive the contradiction check).
+ * @param text - the full claim text.
+ * @param index - offset of the number in the text.
+ * @returns the label, or undefined when there is no usable one.
+ */
+export declare function contextLabelOf(text: string, index: number): string | undefined;
+/**
+ * Extract every checkable citation from one claim text: number literals (with
+ * their left-context labels) and quoted spans.
+ * @param claimText - the claim to analyze.
+ * @returns citations in first-seen order (duplicates kept once).
+ */
+export declare function extractCitations(claimText: string): Citation[];
+/** Normalize a number literal for comparison (drop grouping commas and %). */
+export declare function normalizeNumber(text: string): string;
+/** The outcome of the byte-level check of one claim. */
+export interface ByteCheckOutcome {
+    /** The three-state verdict. */
+    status: 'verified' | 'unverified' | 'contradicted';
+    /** Human-readable evidence note. */
+    note: string;
+    /** Citations that could not be located verbatim. */
+    missing: string[];
+    /** Contradiction details (`label: claimed X, snapshot says Y`). */
+    contradictions: string[];
+}
+/**
+ * Run the byte-level check of one claim against its bound evidence snapshots.
+ * @param claimText - the claim text.
+ * @param evidenceContents - the verbatim snapshot contents of the bound evidence.
+ * @returns the outcome (never throws).
+ */
+export declare function verifyClaimText(claimText: string, evidenceContents: readonly string[]): ByteCheckOutcome;
+/**
+ * Map one bridge result set onto the three-state verdict vocabulary.
+ * `mismatch` maps to `contradicted`; `not-found`/`unverifiable` map to
+ * `unverified`.
+ * @param result - the dataQuality outcome.
+ * @returns the mapped status plus a human-readable note.
+ */
+export declare function mapBridgeResults(result: CitationCheckResult): {
+    status: 'verified' | 'unverified' | 'contradicted';
+    note: string;
+};
+/**
+ * Combine the byte-level and bridge outcomes: `contradicted` wins, then
+ * `unverified`, then `verified`.
+ * @param byte - the byte-level outcome.
+ * @param bridge - the bridge outcome, when the numeric bridge ran.
+ * @returns the combined status and a merged note.
+ */
+export declare function combineOutcomes(byte: ByteCheckOutcome, bridge: {
+    status: 'verified' | 'unverified' | 'contradicted';
+    note: string;
+} | undefined): {
+    status: 'verified' | 'unverified' | 'contradicted';
+    note: string;
+};
+//# sourceMappingURL=verify.d.ts.map

package/lib/types/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,SAAS,EAAE,KAAK,CAAC;QACf,8DAA8D;QAC9D,EAAE,EAAE,MAAM,CAAA;QACV,2EAA2E;QAC3E,IAAI,EAAE,MAAM,CAAA;QACZ,0CAA0C;QAC1C,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;QACtB,0EAA0E;QAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;CACH;AACD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAA;QAC9D,8CAA8C;QAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;QACxB,oCAAoC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAID;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAC7E;AAID,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;IACxB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAeD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmB9D;AAOD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AASD,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAA;IAClD,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAoExG;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG;IAAE,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBlI;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE;IAAE,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACvF;IAAE,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKtE"}

package/lib/types/verify.js

@@ -0,0 +1,208 @@
+/**
+ * Claim verification: the built-in byte-level check plus the optional numeric
+ * bridge to `ctx.dataQuality`.
+ *
+ * Byte-level semantics (v1 is deliberately NON-semantic): every number and
+ * quoted span in the claim text must be locatable VERBATIM in the bound
+ * evidence snapshots. A citation that cannot be located makes the claim
+ * `unverified`; a number whose left-context label appears in the snapshot
+ * followed by a DIFFERENT number makes the claim `contradicted`. The check
+ * proves "the claimed literals exist in the captured bytes", nothing more.
+ *
+ * The `CitationCheckRequest` / `CitationCheckResult` block below is BYTE-FROZEN:
+ * it is the structural surface of the optional `ctx.dataQuality` service
+ * (provided by the sibling dsh-data-quality plugin, consumed via `ctx.get` —
+ * never imported, never injected). `scripts/verify-frozen-contract.mjs` gates
+ * drift.
+ *
+ * @module dsh-research-report/verify
+ */
+/** Number literal: optional sign, grouped digits, decimals, trailing %. */
+const NUMBER_PATTERN = /-?\d[\d,]*(?:\.\d+)?%?/gu;
+/** Quoted spans: ASCII double quotes, CJK corner brackets, full-width quotes. */
+const QUOTE_PATTERNS = [
+    /"([^"\n]{4,200})"/gu,
+    /「([^」\n]{2,200})」/gu,
+    /“([^“”\n]{4,200})”/gu,
+];
+/** The tail run of label characters (letters / CJK) ending a context window. */
+const LABEL_PATTERN = /[\p{L}\p{N}_（）()%$-]{2,24}$/u;
+/**
+ * Extract the trailing context label of a number citation: up to 24 characters
+ * before the number, trimmed to its trailing label run. Too-short labels are
+ * dropped (a weak label would false-positive the contradiction check).
+ * @param text - the full claim text.
+ * @param index - offset of the number in the text.
+ * @returns the label, or undefined when there is no usable one.
+ */
+export function contextLabelOf(text, index) {
+    const window = text.slice(Math.max(0, index - 24), index).trimEnd();
+    const match = LABEL_PATTERN.exec(window);
+    const label = match?.[0].trim();
+    if (label === undefined || label.length < 2)
+        return undefined;
+    return label;
+}
+/**
+ * Extract every checkable citation from one claim text: number literals (with
+ * their left-context labels) and quoted spans.
+ * @param claimText - the claim to analyze.
+ * @returns citations in first-seen order (duplicates kept once).
+ */
+export function extractCitations(claimText) {
+    const citations = [];
+    const seen = new Set();
+    for (const match of claimText.matchAll(NUMBER_PATTERN)) {
+        const text = match[0];
+        if (seen.has(`number:${text}`))
+            continue;
+        seen.add(`number:${text}`);
+        const context = contextLabelOf(claimText, match.index);
+        citations.push(context === undefined ? { kind: 'number', text } : { kind: 'number', text, context });
+    }
+    for (const pattern of QUOTE_PATTERNS) {
+        for (const match of claimText.matchAll(pattern)) {
+            const text = match[1];
+            if (seen.has(`quote:${text}`))
+                continue;
+            seen.add(`quote:${text}`);
+            citations.push({ kind: 'quote', text });
+        }
+    }
+    return citations;
+}
+// ── Byte-level verification ─────────────────────────────────────────────────
+/** The number token scan window after a context label (bytes of text). */
+const CONTEXT_SCAN_WINDOW = 24;
+/** Normalize a number literal for comparison (drop grouping commas and %). */
+export function normalizeNumber(text) {
+    return text.replace(/[,%]/gu, '');
+}
+/** The first number literal found in `text` from `from` (fresh regex — no shared lastIndex). */
+function numberAfter(text, from) {
+    const window = text.slice(from, from + CONTEXT_SCAN_WINDOW);
+    const match = /-?\d[\d,]*(?:\.\d+)?%?/u.exec(window);
+    return match?.[0];
+}
+/** Cap how many problem citations one note enumerates. */
+const NOTE_LIST_CAP = 5;
+/**
+ * Run the byte-level check of one claim against its bound evidence snapshots.
+ * @param claimText - the claim text.
+ * @param evidenceContents - the verbatim snapshot contents of the bound evidence.
+ * @returns the outcome (never throws).
+ */
+export function verifyClaimText(claimText, evidenceContents) {
+    if (evidenceContents.length === 0) {
+        return { status: 'unverified', note: 'claim binds no evidence snapshot', missing: [], contradictions: [] };
+    }
+    const haystack = evidenceContents.join('\n');
+    const citations = extractCitations(claimText);
+    if (citations.length === 0) {
+        return {
+            status: 'unverified',
+            note: 'claim carries no checkable citation (number or quoted span); byte-level verification needs a literal to locate',
+            missing: [],
+            contradictions: [],
+        };
+    }
+    const missing = [];
+    const contradictions = [];
+    for (const citation of citations) {
+        if (citation.kind === 'quote') {
+            if (!haystack.includes(citation.text))
+                missing.push(`"${citation.text}"`);
+            continue;
+        }
+        // Number citation, presence-first: a number locatable verbatim supports
+        // the claim. The contradiction check runs only when the claimed number is
+        // ABSENT — then a label occurrence carrying a different number means the
+        // snapshot explicitly contradicts the claim (the audit-critical signal).
+        if (haystack.includes(citation.text))
+            continue;
+        if (citation.context !== undefined) {
+            let searchFrom = 0;
+            let different;
+            for (;;) {
+                const at = haystack.indexOf(citation.context, searchFrom);
+                if (at === -1)
+                    break;
+                const found = numberAfter(haystack, at + citation.context.length);
+                if (found !== undefined && normalizeNumber(found) !== normalizeNumber(citation.text)) {
+                    different = found;
+                    break;
+                }
+                searchFrom = at + citation.context.length;
+            }
+            if (different !== undefined) {
+                contradictions.push(`${citation.context}: claim says ${citation.text}, snapshot says ${different}`);
+                continue;
+            }
+        }
+        missing.push(citation.text);
+    }
+    if (contradictions.length > 0) {
+        return {
+            status: 'contradicted',
+            note: `contradicts the snapshot: ${contradictions.slice(0, NOTE_LIST_CAP).join('; ')}`,
+            missing,
+            contradictions,
+        };
+    }
+    if (missing.length > 0) {
+        return {
+            status: 'unverified',
+            note: `citation(s) not found in bound evidence: ${missing.slice(0, NOTE_LIST_CAP).join(', ')}`,
+            missing,
+            contradictions,
+        };
+    }
+    return {
+        status: 'verified',
+        note: `${citations.length} citation(s) located verbatim in the bound snapshot(s)`,
+        missing,
+        contradictions,
+    };
+}
+// ── The numeric bridge mapping ──────────────────────────────────────────────
+/**
+ * Map one bridge result set onto the three-state verdict vocabulary.
+ * `mismatch` maps to `contradicted`; `not-found`/`unverifiable` map to
+ * `unverified`.
+ * @param result - the dataQuality outcome.
+ * @returns the mapped status plus a human-readable note.
+ */
+export function mapBridgeResults(result) {
+    const mismatch = result.results.filter(entry => entry.status === 'mismatch');
+    if (mismatch.length > 0) {
+        const detail = mismatch
+            .slice(0, NOTE_LIST_CAP)
+            .map(entry => `${entry.id}: dataset has ${String(entry.actual ?? '?')}${entry.note === undefined ? '' : ` (${entry.note})`}`)
+            .join('; ');
+        return { status: 'contradicted', note: `dataset cross-check mismatch: ${detail}` };
+    }
+    const unresolved = result.results.filter(entry => entry.status === 'not-found' || entry.status === 'unverifiable');
+    if (unresolved.length > 0) {
+        const detail = unresolved
+            .slice(0, NOTE_LIST_CAP)
+            .map(entry => `${entry.id}: ${entry.status}${entry.note === undefined ? '' : ` (${entry.note})`}`)
+            .join('; ');
+        return { status: 'unverified', note: `dataset cross-check unresolved: ${detail}` };
+    }
+    return { status: 'verified', note: `${result.results.length} dataset citation(s) verified via ctx.dataQuality` };
+}
+/**
+ * Combine the byte-level and bridge outcomes: `contradicted` wins, then
+ * `unverified`, then `verified`.
+ * @param byte - the byte-level outcome.
+ * @param bridge - the bridge outcome, when the numeric bridge ran.
+ * @returns the combined status and a merged note.
+ */
+export function combineOutcomes(byte, bridge) {
+    if (bridge === undefined)
+        return { status: byte.status, note: byte.note };
+    const rank = { verified: 0, unverified: 1, contradicted: 2 };
+    const status = rank[bridge.status] > rank[byte.status] ? bridge.status : byte.status;
+    return { status, note: `${byte.note} | ${bridge.note}` };
+}
+//# sourceMappingURL=verify.js.map

package/lib/types/verify.js.map

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

package/lib/types/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Single source of truth for the plugin version (stamped by scripts/release.mjs).
+ * @module dsh-research-report/version
+ */
+/** The published package version. */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/types/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/lib/types/version.js

@@ -0,0 +1,7 @@
+/**
+ * Single source of truth for the plugin version (stamped by scripts/release.mjs).
+ * @module dsh-research-report/version
+ */
+/** The published package version. */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/lib/types/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,147 @@
+{
+  "name": "dsh-research-report",
+  "version": "0.1.0",
+  "description": "Verifiable research-report engine for DeepSeek Harness: a content-addressed evidence ledger (claim ↔ snapshot binding, tamper-evident) plus versioned sealed reports where every claim carries a verification verdict and the manifest hash seals the directory. Retrieval orchestration reuses the official ctx.web / ctx.jobs seams — no deep-research loop.",
+  "author": "dsh-research-report contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-research-report.git"
+  },
+  "homepage": "https://github.com/PerryLink/dsh-research-report#readme",
+  "bugs": {
+    "url": "https://github.com/PerryLink/dsh-research-report/issues"
+  },
+  "private": false,
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "cordis.patch.yml",
+    "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md",
+    "README.md",
+    "README.zh.md",
+    "README.es.md",
+    "README.pt.md",
+    "README.hi.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dshWorkshop": {
+    "schema": "omdsh-workshop-package/v1",
+    "type": "plugin",
+    "integration": {
+      "protocol": "harness-profile",
+      "artifact": "cordis.patch.yml"
+    },
+    "install": {
+      "mode": "transactional",
+      "adapter": "profile-bundle",
+      "failurePolicy": "generation-rollback",
+      "touchesCurrentBeforeActivation": false
+    },
+    "lifecycle": {
+      "activation": "restart-profile",
+      "dispose": "supported"
+    },
+    "permissions": [
+      "fs:workspace-write",
+      "network:via-ctx.web-only",
+      "session:read",
+      "session:write",
+      "native-code:none"
+    ],
+    "compatibility": {
+      "dshVersions": [
+        "0.1.0-rc.6"
+      ]
+    },
+    "capability": {
+      "id": "research-report",
+      "kind": "verifiable-reporting",
+      "invocation": "mount the dsh-research-report bundle row",
+      "expected": "provides ctx.researchReport (assemble), the evidence_add / research_report / ledger_query tools, and a content-addressed evidence ledger with tamper-evident sealed reports under the workspace"
+    },
+    "evidence": {
+      "install": null,
+      "failureIsolation": null,
+      "hotReload": null,
+      "remove": null
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "cordis",
+    "research",
+    "evidence-ledger",
+    "verifiable-report",
+    "audit",
+    "citation-verification"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-jobs": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-web": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.0"
+  },
+  "dependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-include": "1.0.6",
+    "@deepseek-ai/cordis-plugin-loader": "1.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-jobs": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-jobs-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-web": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "@types/node": "^22.19.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "oxlint": "0.18.1",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "node scripts/prepare.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "typecheck:ci": "tsc -p tsconfig.ci.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint",
+    "prepare": "node scripts/prepare.mjs",
+    "verify:self-contained": "node scripts/verify-self-contained.mjs",
+    "verify:artifacts": "node scripts/verify-artifacts.mjs",
+    "verify:readme-sync": "node scripts/check-readme-sync.mjs",
+    "verify:frozen-contract": "node scripts/verify-frozen-contract.mjs",
+    "pack:check": "node scripts/prepare.mjs && pnpm pack"
+  },
+  "license": "Apache-2.0"
+}