dsh-industry-research 0.1.0

package/lib/types/chain.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The industry-chain structure model (`ChainMap`) and its validation. This is
+ * a pure data module: no I/O, no clock. A metric is either a sourced value
+ * (`value` + `sourceRef`, optionally `unit`/`asOf`) or an explicit gap slot
+ * (no `value`), so an unsourced number is a validation error by construction
+ * and a missing number is an honest, listable gap.
+ * @module dsh-industry-research/chain
+ */
+/** Chain tiers, upstream → downstream. */
+export declare const CHAIN_TIERS: readonly ["upstream", "midstream", "downstream"];
+/** One chain tier. */
+export type ChainTier = (typeof CHAIN_TIERS)[number];
+/** One metric slot on a chain node. */
+export type ChainMetric = {
+    /** Metric name (e.g. `市场规模`, `毛利率`). */
+    key: string;
+    /** The numeric value; absent means the slot is an explicit gap (待补). */
+    value?: number;
+    /** Unit of the value (e.g. `亿元`, `%`). */
+    unit?: string;
+    /** ISO-8601 date the value is current as of. */
+    asOf?: string;
+    /** Source reference: a sources.json ref (`S1`), a URL, or a workspace path. Required whenever `value` is present. */
+    sourceRef?: string;
+};
+/** One node in the industry chain. */
+export type ChainNode = {
+    /** Stable node id referenced by edges (unique within the map). */
+    id: string;
+    /** Display name (e.g. `高粱种植`, `白酒酿造`). */
+    name: string;
+    tier: ChainTier;
+    /** Metric slots; each is a sourced value or an explicit gap. */
+    metrics: ChainMetric[];
+};
+/** One directed relation between two nodes. */
+export type ChainEdge = {
+    /** Source node id. */
+    from: string;
+    /** Target node id. */
+    to: string;
+    /** Optional relation note (e.g. `原料供应`). */
+    note?: string;
+};
+/** The industry-chain map persisted as `<industryRoot>/<industry>/chain.json`. */
+export type ChainMap = {
+    /** Industry display name. */
+    industry: string;
+    nodes: ChainNode[];
+    edges: ChainEdge[];
+};
+/**
+ * Validate a chain map. Pure: returns the list of problems (empty when the
+ * map is well-formed). Rules: unique node ids, legal tiers, edges reference
+ * existing nodes, and every metric carrying a `value` also carries a
+ * `sourceRef` (gap slots without a value are always legal).
+ * @param map - the candidate chain map.
+ * @returns human-readable validation problems, in encounter order.
+ */
+export declare function validateChainMap(map: ChainMap): string[];
+/**
+ * List the explicit gaps of a well-formed chain map: metric slots without a
+ * value, nodes without any metric slot, and tiers with no node at all.
+ * @param map - the chain map (already validated).
+ * @returns human-readable gap lines, in encounter order.
+ */
+export declare function chainGaps(map: ChainMap): string[];
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/chain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,WAAW,kDAAmD,CAAA;AAE3E,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qHAAqH;IACrH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG;IACtB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAA;IACV,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,gEAAgE;IAChE,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAED,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG;IACtB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG;IACrB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAuCxD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAkBjD"}

package/lib/types/chain.js

@@ -0,0 +1,88 @@
+/**
+ * The industry-chain structure model (`ChainMap`) and its validation. This is
+ * a pure data module: no I/O, no clock. A metric is either a sourced value
+ * (`value` + `sourceRef`, optionally `unit`/`asOf`) or an explicit gap slot
+ * (no `value`), so an unsourced number is a validation error by construction
+ * and a missing number is an honest, listable gap.
+ * @module dsh-industry-research/chain
+ */
+/** Chain tiers, upstream → downstream. */
+export const CHAIN_TIERS = ['upstream', 'midstream', 'downstream'];
+/**
+ * Validate a chain map. Pure: returns the list of problems (empty when the
+ * map is well-formed). Rules: unique node ids, legal tiers, edges reference
+ * existing nodes, and every metric carrying a `value` also carries a
+ * `sourceRef` (gap slots without a value are always legal).
+ * @param map - the candidate chain map.
+ * @returns human-readable validation problems, in encounter order.
+ */
+export function validateChainMap(map) {
+    const problems = [];
+    if (typeof map.industry !== 'string' || map.industry.trim().length === 0) {
+        problems.push('chain.industry must be a non-empty name');
+    }
+    const ids = new Set();
+    for (const node of map.nodes) {
+        if (typeof node.id !== 'string' || node.id.trim().length === 0) {
+            problems.push(`node ${JSON.stringify(node.id)} has an empty id`);
+            continue;
+        }
+        if (ids.has(node.id))
+            problems.push(`duplicate node id "${node.id}"`);
+        ids.add(node.id);
+        if (typeof node.name !== 'string' || node.name.trim().length === 0) {
+            problems.push(`node "${node.id}" has an empty name`);
+        }
+        if (!CHAIN_TIERS.includes(node.tier)) {
+            problems.push(`node "${node.id}" has an illegal tier ${JSON.stringify(node.tier)} (expected upstream|midstream|downstream)`);
+        }
+        for (const metric of node.metrics) {
+            if (typeof metric.key !== 'string' || metric.key.trim().length === 0) {
+                problems.push(`node "${node.id}" has a metric with an empty key`);
+                continue;
+            }
+            if (metric.value !== undefined) {
+                if (typeof metric.value !== 'number' || !Number.isFinite(metric.value)) {
+                    problems.push(`node "${node.id}" metric "${metric.key}" carries a non-finite value`);
+                }
+                if (typeof metric.sourceRef !== 'string' || metric.sourceRef.trim().length === 0) {
+                    problems.push(`node "${node.id}" metric "${metric.key}" carries a value without a sourceRef — register the source or mark the slot 待补 (omit value)`);
+                }
+            }
+        }
+    }
+    for (const edge of map.edges) {
+        if (!ids.has(edge.from))
+            problems.push(`edge references unknown node "${edge.from}" (from)`);
+        if (!ids.has(edge.to))
+            problems.push(`edge references unknown node "${edge.to}" (to)`);
+    }
+    return problems;
+}
+/**
+ * List the explicit gaps of a well-formed chain map: metric slots without a
+ * value, nodes without any metric slot, and tiers with no node at all.
+ * @param map - the chain map (already validated).
+ * @returns human-readable gap lines, in encounter order.
+ */
+export function chainGaps(map) {
+    const gaps = [];
+    const tiers = new Set();
+    for (const node of map.nodes) {
+        tiers.add(node.tier);
+        if (node.metrics.length === 0) {
+            gaps.push(`节点「${node.name}」(${node.id}) 没有任何指标槽位`);
+        }
+        for (const metric of node.metrics) {
+            if (metric.value === undefined) {
+                gaps.push(`节点「${node.name}」(${node.id}) 的指标「${metric.key}」待补（无来源数值）`);
+            }
+        }
+    }
+    for (const tier of CHAIN_TIERS) {
+        if (!tiers.has(tier))
+            gaps.push(`产业链缺少 ${tier} 层节点`);
+    }
+    return gaps;
+}
+//# sourceMappingURL=chain.js.map

package/lib/types/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/chain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,CAAU,CAAA;AAgD3E;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IAC1D,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAA;YAChE,SAAQ;QACV,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;QACrE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;QAC9H,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAA;gBACjE,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,aAAa,MAAM,CAAC,GAAG,8BAA8B,CAAC,CAAA;gBACtF,CAAC;gBACD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACjF,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,aAAa,MAAM,CAAC,GAAG,8FAA8F,CAAC,CAAA;gBACtJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,IAAI,UAAU,CAAC,CAAA;QAC5F,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IACxF,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;QACpD,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,SAAS,MAAM,CAAC,GAAG,YAAY,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/lib/types/company.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Company scan support: read user-supplied data files from the workspace,
+ * hash them, extract a lightweight outline (Markdown headings) and
+ * figure-candidate lines (lines carrying digits, so every number the model
+ * cites can point at a file and a line), and persist the scan card
+ * (`card.json` + `card.md`). v1 reads text formats only — no PDF.
+ * @module dsh-industry-research/company
+ */
+import type { ResolvedConfig } from './config.js';
+/** File extensions v1 can read as text. PDF and office formats are out of scope. */
+export declare const READABLE_EXTENSIONS: Set<string>;
+/** One registered data-file source on a card. */
+export type CardSource = {
+    /** Absolute workspace path of the data file. */
+    path: string;
+    /** SHA-256 of the file content at scan time. */
+    sha256: string;
+    /** File size in bytes at scan time. */
+    bytes: number;
+    /** Line count at scan time. */
+    lines: number;
+};
+/** One line carrying a digit — a citation anchor for every figure the model quotes. */
+export type FigureCandidate = {
+    /** Absolute workspace path of the data file. */
+    path: string;
+    /** 1-based line number. */
+    line: number;
+    /** The verbatim line text (trimmed, capped). */
+    text: string;
+};
+/** Markdown heading outline of one data file. */
+export type FileOutline = {
+    /** Absolute workspace path of the data file. */
+    path: string;
+    /** Heading texts in document order (`#`/`##`/`###`). */
+    headings: string[];
+};
+/** One web citation attached to the card (public-source complement). */
+export type CardWebSource = {
+    url: string;
+    title?: string;
+    snippet?: string;
+    publishedAt?: string;
+};
+/** The structured company scan card persisted as `card.json`. */
+export type CompanyCard = {
+    /** Company display name. */
+    name: string;
+    /** Directory slug (validated path segment). */
+    slug: string;
+    /** ISO-8601 scan time. */
+    asOf: string;
+    /** Data-file sources with hashes. */
+    sources: CardSource[];
+    /** Per-file Markdown outlines. */
+    outline: FileOutline[];
+    /** Lines carrying digits, for precise figure citation. */
+    figureCandidates: FigureCandidate[];
+    /** Public-source citations from ctx.web; null when the web complement did not run. */
+    webSources: CardWebSource[] | null;
+    /** Honest gap declarations (what the card could not establish). */
+    gaps: string[];
+    /** Research-only disclaimer carried into every rendering. */
+    disclaimer: string;
+};
+/** The research-only disclaimer text shared by cards and reports. */
+export declare const DISCLAIMER = "\u4EC5\u4F9B\u7814\u7A76\uFF0C\u4E0D\u6784\u6210\u6295\u8D44\u5EFA\u8BAE";
+/** The outcome of reading and extracting one data file. */
+export interface ScannedFile {
+    source: CardSource;
+    outline: FileOutline | undefined;
+    figures: FigureCandidate[];
+    /** Verbatim content (for downstream evidence registration). */
+    content: string;
+}
+/**
+ * Read one containment-verified data file and extract its outline and figure
+ * candidates. Unsupported extensions and unreadable entries throw — the tool
+ * wraps them into the card's gap list where the contract allows skipping.
+ * @param path - absolute, containment-verified file path.
+ * @param maxBytes - per-file read cap.
+ * @returns the scanned file.
+ */
+export declare function scanFile(path: string, maxBytes: number): Promise<ScannedFile>;
+/**
+ * Persist a company card as `card.json` + `card.md` inside its directory.
+ * The Markdown card is a template whose analytical sections stay explicitly
+ * 待补 — the tool surfaces evidence (sources, outline, figure candidates); it
+ * never invents business structure, financials, or risks.
+ * @param dir - absolute company card directory.
+ * @param card - the card to persist.
+ * @returns the written file paths.
+ */
+export declare function writeCard(dir: string, card: CompanyCard): Promise<{
+    cardJsonPath: string;
+    cardPath: string;
+}>;
+/**
+ * Render the human-facing Markdown card. Every section that the scan could
+ * not fill from evidence is an explicit 待补 line, never prose.
+ * @param card - the card to render.
+ * @returns the Markdown text.
+ */
+export declare function renderCardMarkdown(card: CompanyCard): string;
+/**
+ * Load a persisted card (for report assembly). Missing/corrupt cards fail
+ * loud to the caller, which decides per-card tolerance.
+ * @param cardJsonPath - absolute path of `card.json`.
+ * @returns the parsed card.
+ */
+export declare function readCard(cardJsonPath: string): Promise<CompanyCard>;
+/**
+ * Apply the figure-candidate budget to a scan result set, keeping files in
+ * scan order and noting the cut in the card gaps when it applies.
+ * @param figures - all candidates, in scan order.
+ * @param config - resolved config (budget source).
+ * @returns the bounded candidate list.
+ */
+export declare function boundFigures(figures: readonly FigureCandidate[], config: ResolvedConfig): FigureCandidate[];
+//# sourceMappingURL=company.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"company.d.ts","sourceRoot":"","sources":["../../src/company.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,aAAoD,CAAA;AAEpF,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACvB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG;IACxB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACxB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,kCAAkC;IAClC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,0DAA0D;IAC1D,gBAAgB,EAAE,eAAe,EAAE,CAAA;IACnC,sFAAsF;IACtF,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,CAAA;IAClC,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,UAAU,6EAAiB,CAAA;AAOxC,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BnF;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAOnH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoD5D;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAOzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,eAAe,EAAE,CAE3G"}

package/lib/types/company.js

@@ -0,0 +1,170 @@
+/**
+ * Company scan support: read user-supplied data files from the workspace,
+ * hash them, extract a lightweight outline (Markdown headings) and
+ * figure-candidate lines (lines carrying digits, so every number the model
+ * cites can point at a file and a line), and persist the scan card
+ * (`card.json` + `card.md`). v1 reads text formats only — no PDF.
+ * @module dsh-industry-research/company
+ */
+import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import { sha256Of } from "./sources.js";
+/** File extensions v1 can read as text. PDF and office formats are out of scope. */
+export const READABLE_EXTENSIONS = new Set(['.md', '.txt', '.csv', '.tsv', '.json']);
+/** The research-only disclaimer text shared by cards and reports. */
+export const DISCLAIMER = '仅供研究，不构成投资建议';
+/** Maximum length of one surfaced figure-candidate line. */
+const FIGURE_LINE_CAP = 200;
+/** Maximum headings surfaced per file. */
+const OUTLINE_CAP = 50;
+/**
+ * Read one containment-verified data file and extract its outline and figure
+ * candidates. Unsupported extensions and unreadable entries throw — the tool
+ * wraps them into the card's gap list where the contract allows skipping.
+ * @param path - absolute, containment-verified file path.
+ * @param maxBytes - per-file read cap.
+ * @returns the scanned file.
+ */
+export async function scanFile(path, maxBytes) {
+    const ext = extname(path).toLowerCase();
+    if (!READABLE_EXTENSIONS.has(ext)) {
+        throw new Error(`unsupported data-file extension ${JSON.stringify(ext)} (v1 reads ${[...READABLE_EXTENSIONS].join(', ')}; PDF is out of scope)`);
+    }
+    const info = await stat(path);
+    if (!info.isFile())
+        throw new Error(`not a regular file: ${path}`);
+    if (info.size > maxBytes) {
+        throw new Error(`file exceeds scan.maxFileBytes (${info.size} > ${maxBytes}): ${path}`);
+    }
+    const content = await readFile(path, 'utf8');
+    const lines = content.split('\n');
+    const headings = [];
+    const figures = [];
+    if (ext === '.md') {
+        for (const line of lines) {
+            const match = /^#{1,3}\s+(.+?)\s*$/u.exec(line);
+            if (match?.[1] !== undefined && headings.length < OUTLINE_CAP)
+                headings.push(match[1]);
+        }
+    }
+    lines.forEach((raw, index) => {
+        const text = raw.trim();
+        if (text.length === 0 || !/\d/u.test(text))
+            return;
+        figures.push({ path, line: index + 1, text: text.length > FIGURE_LINE_CAP ? `${text.slice(0, FIGURE_LINE_CAP)}…` : text });
+    });
+    return {
+        source: { path, sha256: sha256Of(content), bytes: info.size, lines: lines.length },
+        outline: headings.length > 0 ? { path, headings } : undefined,
+        figures,
+        content,
+    };
+}
+/**
+ * Persist a company card as `card.json` + `card.md` inside its directory.
+ * The Markdown card is a template whose analytical sections stay explicitly
+ * 待补 — the tool surfaces evidence (sources, outline, figure candidates); it
+ * never invents business structure, financials, or risks.
+ * @param dir - absolute company card directory.
+ * @param card - the card to persist.
+ * @returns the written file paths.
+ */
+export async function writeCard(dir, card) {
+    await mkdir(dir, { recursive: true });
+    const cardJsonPath = join(dir, 'card.json');
+    const cardPath = join(dir, 'card.md');
+    await writeFile(cardJsonPath, `${JSON.stringify(card, null, 2)}\n`, 'utf8');
+    await writeFile(cardPath, renderCardMarkdown(card), 'utf8');
+    return { cardJsonPath, cardPath };
+}
+/**
+ * Render the human-facing Markdown card. Every section that the scan could
+ * not fill from evidence is an explicit 待补 line, never prose.
+ * @param card - the card to render.
+ * @returns the Markdown text.
+ */
+export function renderCardMarkdown(card) {
+    const lines = [
+        `# 公司速览卡：${card.name}`,
+        '',
+        `> ${card.disclaimer}。扫描时间（asOf）：${card.asOf}`,
+        '',
+        '## 业务结构',
+        '',
+    ];
+    if (card.outline.length > 0) {
+        lines.push('数据文件目录结构（供研究定位，非分析结论）：');
+        for (const outline of card.outline) {
+            lines.push(`- \`${outline.path}\``);
+            for (const heading of outline.headings)
+                lines.push(`  - ${heading}`);
+        }
+    }
+    else {
+        lines.push('待补：未从数据文件中提取到目录结构。');
+    }
+    lines.push('', '## 财务要点', '');
+    if (card.figureCandidates.length > 0) {
+        lines.push(`数字候选行（共 ${card.figureCandidates.length} 行，引用时必须标注文件与行号）：`);
+        for (const figure of card.figureCandidates.slice(0, 20)) {
+            lines.push(`- \`${figure.path}\`:${figure.line} — ${figure.text}`);
+        }
+        if (card.figureCandidates.length > 20)
+            lines.push(`- ……其余 ${card.figureCandidates.length - 20} 行见 card.json`);
+    }
+    else {
+        lines.push('待补：数据文件中未发现数字行。');
+    }
+    lines.push('', '## 风险点', '', '待补：由研究者基于来源材料归纳；不得凭空列举。', '', '## 来源清单', '');
+    if (card.sources.length > 0) {
+        for (const source of card.sources) {
+            lines.push(`- \`${source.path}\` — SHA-256 \`${source.sha256}\`，${source.bytes} 字节，${source.lines} 行`);
+        }
+    }
+    else {
+        lines.push('无用户提供的数据文件。');
+    }
+    if (card.webSources !== null) {
+        lines.push('', '公开源检索（ctx.web）：');
+        for (const source of card.webSources) {
+            const label = source.title ?? source.url;
+            const when = source.publishedAt !== undefined ? `（${source.publishedAt}）` : '';
+            lines.push(`- [${label}](${source.url})${when}`);
+        }
+    }
+    lines.push('', '## 缺口声明', '');
+    if (card.gaps.length > 0) {
+        for (const gap of card.gaps)
+            lines.push(`- ${gap}`);
+    }
+    else {
+        lines.push('无。');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Load a persisted card (for report assembly). Missing/corrupt cards fail
+ * loud to the caller, which decides per-card tolerance.
+ * @param cardJsonPath - absolute path of `card.json`.
+ * @returns the parsed card.
+ */
+export async function readCard(cardJsonPath) {
+    const text = await readFile(cardJsonPath, 'utf8');
+    const parsed = JSON.parse(text);
+    if (typeof parsed.name !== 'string' || !Array.isArray(parsed.sources) || !Array.isArray(parsed.gaps)) {
+        throw new Error(`company card at ${cardJsonPath} is malformed`);
+    }
+    return parsed;
+}
+/**
+ * Apply the figure-candidate budget to a scan result set, keeping files in
+ * scan order and noting the cut in the card gaps when it applies.
+ * @param figures - all candidates, in scan order.
+ * @param config - resolved config (budget source).
+ * @returns the bounded candidate list.
+ */
+export function boundFigures(figures, config) {
+    return figures.slice(0, config.scan.maxFigureCandidates);
+}
+//# sourceMappingURL=company.js.map

package/lib/types/company.js.map

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

package/lib/types/config.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Config schema and resolution for `dsh-industry-research`. Every tunable is a
+ * validated {@link Config} field changeable from cordis.yml; the resolution
+ * step validates bounds so misconfiguration fails loud at mount. With
+ * `enabled: false` the plugin registers nothing and stays inert.
+ * @module dsh-industry-research/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** Public-source tracking bounds. */
+export interface TrackConfig {
+    /** `web_search` maxResults per topic. */
+    maxResultsPerTopic?: number;
+    /** Maximum snapshot fetches per `industry_track` call; sources beyond the budget stay citation-only entries. */
+    maxFetchesPerCall?: number;
+}
+/** Company scan bounds. */
+export interface ScanConfig {
+    /** Maximum bytes read per user-supplied data file. */
+    maxFileBytes?: number;
+    /** Maximum figure-candidate lines surfaced per company scan. */
+    maxFigureCandidates?: number;
+}
+/** Raw plugin config — every field optional; {@link resolveConfig} supplies the defaults. */
+export interface Config {
+    /** Master switch; `false` mounts nothing. */
+    enabled?: boolean;
+    /** Root directory (relative to the session workspace, or absolute) holding every industry artifact. */
+    industryRoot?: string;
+    /** Per-request timeout (ms) applied to `ctx.web` search/fetch calls. */
+    fetchTimeoutMs?: number;
+    /** Maximum entries retained per industry `timeline.jsonl` (oldest dropped). */
+    timelineMaxEntries?: number;
+    /** Host allowlist for tracked sources (empty = all hosts allowed). Entries are host suffixes (`gov.cn`) or URL prefixes (`https://www.gov.cn/`). */
+    sourceAllowlist?: string[];
+    /** Host blocklist for tracked sources; wins over the allowlist. */
+    sourceBlocklist?: string[];
+    /** Offline mode: never touch `ctx.web`; only local workspace data is used. */
+    offline?: boolean;
+    /** Explicit skills root override; defaults to the packaged `skills/` edition. */
+    skillsDir?: string;
+    track?: TrackConfig;
+    scan?: ScanConfig;
+}
+/** Fully resolved config handed to the runtime. */
+export interface ResolvedConfig {
+    readonly enabled: boolean;
+    readonly industryRoot: string;
+    readonly fetchTimeoutMs: number;
+    readonly timelineMaxEntries: number;
+    readonly sourceAllowlist: readonly string[];
+    readonly sourceBlocklist: readonly string[];
+    readonly offline: boolean;
+    readonly skillsDir: string | undefined;
+    readonly track: {
+        readonly maxResultsPerTopic: number;
+        readonly maxFetchesPerCall: number;
+    };
+    readonly scan: {
+        readonly maxFileBytes: number;
+        readonly maxFigureCandidates: number;
+    };
+}
+/** Schemastery schema: the loader validates and fills defaults before `apply`. */
+export declare const Config: z<Config>;
+/**
+ * Validate raw values and fill explicit defaults. Invalid bounds throw here —
+ * misconfiguration fails loud at mount even without the Schemastery loader.
+ * @param config - raw (possibly partial) plugin config.
+ * @returns the fully resolved config.
+ */
+export declare function resolveConfig(config?: Config): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gHAAgH;IAChH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,6FAA6F;AAC7F,MAAM,WAAW,MAAM;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,oJAAoJ;IACpJ,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;QACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KACnC,CAAA;IACD,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;QAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;KACrC,CAAA;CACF;AAED,kFAAkF;AAClF,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAiB3B,CAAA;AAkBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CA2CjE"}

package/lib/types/config.js

@@ -0,0 +1,86 @@
+/**
+ * Config schema and resolution for `dsh-industry-research`. Every tunable is a
+ * validated {@link Config} field changeable from cordis.yml; the resolution
+ * step validates bounds so misconfiguration fails loud at mount. With
+ * `enabled: false` the plugin registers nothing and stays inert.
+ * @module dsh-industry-research/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** Schemastery schema: the loader validates and fills defaults before `apply`. */
+export const Config = z.object({
+    enabled: z.boolean().default(true),
+    industryRoot: z.string().default('industry-research'),
+    fetchTimeoutMs: z.number().default(20_000),
+    timelineMaxEntries: z.number().default(500),
+    sourceAllowlist: z.array(z.string()).default([]),
+    sourceBlocklist: z.array(z.string()).default([]),
+    offline: z.boolean().default(false),
+    skillsDir: z.string(),
+    track: z.object({
+        maxResultsPerTopic: z.number().default(10),
+        maxFetchesPerCall: z.number().default(10),
+    }).default({ maxResultsPerTopic: 10, maxFetchesPerCall: 10 }),
+    scan: z.object({
+        maxFileBytes: z.number().default(1_048_576),
+        maxFigureCandidates: z.number().default(100),
+    }).default({ maxFileBytes: 1_048_576, maxFigureCandidates: 100 }),
+});
+/** Throw unless `value` is a positive safe integer. */
+function assertPositiveInt(name, value) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new TypeError(`${name} must be a positive safe integer, got ${String(value)}`);
+    }
+}
+/** Throw unless every entry is a non-empty string. */
+function assertStringList(name, value) {
+    for (const entry of value) {
+        if (typeof entry !== 'string' || entry.trim().length === 0) {
+            throw new TypeError(`${name} entries must be non-empty strings, got ${JSON.stringify(entry)}`);
+        }
+    }
+}
+/**
+ * Validate raw values and fill explicit defaults. Invalid bounds throw here —
+ * misconfiguration fails loud at mount even without the Schemastery loader.
+ * @param config - raw (possibly partial) plugin config.
+ * @returns the fully resolved config.
+ */
+export function resolveConfig(config = {}) {
+    const industryRoot = config.industryRoot ?? 'industry-research';
+    if (typeof industryRoot !== 'string' || industryRoot.trim().length === 0) {
+        throw new TypeError('industryRoot must be a non-empty path');
+    }
+    const fetchTimeoutMs = config.fetchTimeoutMs ?? 20_000;
+    assertPositiveInt('fetchTimeoutMs', fetchTimeoutMs);
+    const timelineMaxEntries = config.timelineMaxEntries ?? 500;
+    assertPositiveInt('timelineMaxEntries', timelineMaxEntries);
+    const sourceAllowlist = config.sourceAllowlist ?? [];
+    assertStringList('sourceAllowlist', sourceAllowlist);
+    const sourceBlocklist = config.sourceBlocklist ?? [];
+    assertStringList('sourceBlocklist', sourceBlocklist);
+    const skillsDir = config.skillsDir;
+    if (skillsDir !== undefined && (typeof skillsDir !== 'string' || skillsDir.trim().length === 0)) {
+        throw new TypeError('skillsDir must be a non-empty path when set');
+    }
+    const maxResultsPerTopic = config.track?.maxResultsPerTopic ?? 10;
+    assertPositiveInt('track.maxResultsPerTopic', maxResultsPerTopic);
+    const maxFetchesPerCall = config.track?.maxFetchesPerCall ?? 10;
+    assertPositiveInt('track.maxFetchesPerCall', maxFetchesPerCall);
+    const maxFileBytes = config.scan?.maxFileBytes ?? 1_048_576;
+    assertPositiveInt('scan.maxFileBytes', maxFileBytes);
+    const maxFigureCandidates = config.scan?.maxFigureCandidates ?? 100;
+    assertPositiveInt('scan.maxFigureCandidates', maxFigureCandidates);
+    return {
+        enabled: config.enabled ?? true,
+        industryRoot,
+        fetchTimeoutMs,
+        timelineMaxEntries,
+        sourceAllowlist,
+        sourceBlocklist,
+        offline: config.offline ?? false,
+        skillsDir,
+        track: { maxResultsPerTopic, maxFetchesPerCall },
+        scan: { maxFileBytes, maxFigureCandidates },
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/types/config.js.map

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