dsh-scout 0.9.0 → 0.9.2

package/dist/model.d.ts

@@ -1,3 +1,6 @@
+import type { ScoutLanguage } from './i18n.js';
+export { formatScoutString, isScoutLanguage, normalizeScoutLanguage, SCOUT_LANGUAGES, scoutStrings, } from './i18n.js';
+export type { ScoutLanguage, ScoutStrings } from './i18n.js';
 export declare const EVIDENCE_LEVELS: readonly ["E0", "E1", "E2", "E3"];
 export type EvidenceLevel = typeof EVIDENCE_LEVELS[number];
 export declare const CLAIM_STATUSES: readonly ["verified", "reported", "inferred", "contradicted", "unknown", "needs_verification"];
@@ -9,7 +12,10 @@ export type ClaimImpact = typeof CLAIM_IMPACTS[number];
 export declare const CLAIM_DIMENSIONS: readonly ["identity", "role_existence", "reporting_line", "mandate", "company_and_founder", "product_and_technology", "market_and_competition", "financing_and_commercialization", "organization_and_hr", "risk", "role_fit"];
 export type ClaimDimension = typeof CLAIM_DIMENSIONS[number];
 export type Decision = 'PROCEED' | 'VERIFY' | 'STOP';
-export declare const EVENT_TYPES: readonly ["case_started", "source_added", "claim_added", "identity_verified", "claim_verified", "case_exported", "case_imported"];
+export declare const DECISION_REASON_CODES: readonly ["identity", "unresolved", "missing_dimension", "proceed"];
+export type DecisionReasonCode = typeof DECISION_REASON_CODES[number];
+export declare function isDecisionReasonCode(value: unknown): value is DecisionReasonCode;
+export declare const EVENT_TYPES: readonly ["case_started", "source_added", "claim_added", "identity_verified", "claim_verified", "case_exported", "case_imported", "case_rehydrated"];
 export type ScoutEventType = typeof EVENT_TYPES[number];
 export interface ScoutEvent {
     eventId: string;
@@ -70,6 +76,8 @@ export interface ScoutCase {
     };
     decision: Decision;
     decisionReason: string;
+    /** Optional reason code for the decision; older exports omit it. */
+    decisionReasonCode?: DecisionReasonCode;
     sources: ScoutSource[];
     claims: ScoutClaim[];
     interviewQuestions: string[];
@@ -81,6 +89,7 @@ export declare function createCase(input: {
     roleTitle: string;
     location?: string;
     decisionObjective?: string;
+    language?: ScoutLanguage;
 }): ScoutCase;
 export declare function addSource(scoutCase: ScoutCase, source: ScoutSource, authoritySuffixes?: readonly string[]): ScoutCase;
 export declare function isTrustedAuthorityUrl(value: string | null, authoritySuffixes?: readonly string[]): boolean;
@@ -94,6 +103,13 @@ export declare function inferEvidenceLevel(url: string | null, type: SourceType,
     evidenceLevel: EvidenceLevel;
     inferred: boolean;
 };
+/**
+ * Normalize a source URL for deduplication: trim, lowercase the host, drop a
+ * trailing slash and any fragment. Empty or unparsable URLs return `undefined`.
+ */
+export declare function normalizeSourceUrl(value: string | null | undefined): string | undefined;
+/** Find a source by normalized URL (trim + trailing-slash + host case insensitive). */
+export declare function findSourceByUrl(scoutCase: ScoutCase, url: string): ScoutSource | undefined;
 export declare function addClaim(scoutCase: ScoutCase, claim: ScoutClaim): ScoutCase;
 export declare function verifyClaim(scoutCase: ScoutCase, input: {
     claimId: string;
@@ -110,15 +126,49 @@ export declare function verifyIdentity(scoutCase: ScoutCase, input: {
     brandRelationship: string;
     sourceIds: string[];
 }, authoritySuffixes?: readonly string[]): ScoutCase;
-export declare function decideCase(scoutCase: ScoutCase): ScoutCase;
-/** Derive a deduplicated, prioritized interview question list from the case. */
-export declare function generateInterviewQuestions(scoutCase: ScoutCase): string[];
-export declare function renderReport(scoutCase: ScoutCase): string;
+/** Pure decision reason code recomputed from the subject and claims, without stored state. */
+export declare function explainDecision(scoutCase: ScoutCase): DecisionReasonCode;
+export declare function decideCase(scoutCase: ScoutCase, opts?: {
+    language?: ScoutLanguage;
+}): ScoutCase;
+export interface DimensionCoverage {
+    dimension: ClaimDimension;
+    verified: number;
+    open: number;
+    untouched: boolean;
+}
+/** Investigation coverage per dimension, in `CLAIM_DIMENSIONS` order. */
+export declare function computeCoverage(scoutCase: ScoutCase): DimensionCoverage[];
+/**
+ * Derive a deduplicated, prioritized interview question list from the case.
+ * Order: pending next actions, missing required dimensions, untouched
+ * dimensions, then the case's own curated questions. The curated questions
+ * reserve their full quota, so an uninvestigated case cannot crowd them out of
+ * the 12-item cap.
+ */
+export declare function generateInterviewQuestions(scoutCase: ScoutCase, opts?: {
+    language?: ScoutLanguage;
+}): string[];
+export declare function renderReport(scoutCase: ScoutCase, opts?: {
+    language?: ScoutLanguage;
+}): string;
 export declare function appendEvent(scoutCase: ScoutCase, event: ScoutEvent): ScoutCase;
 export declare const EXPORT_FILE_NAMES: readonly ["case.json", "sources.json", "claims.json", "events.jsonl", "report.md"];
-/** Serialize a case into the durable five-file export payloads (no I/O). */
-export declare function exportCaseFiles(scoutCase: ScoutCase): Record<string, string>;
+/**
+ * Serialize a case into the durable five-file export payloads (no I/O).
+ *
+ * `case.json` keeps the case's own `language` field, which records the language
+ * the case was created in; the language used to render `report.md` is decided by
+ * the caller through `opts.language` (falling back to the case language), so a
+ * case imported across a language boundary can still be exported in the
+ * configured language.
+ */
+export declare function exportCaseFiles(scoutCase: ScoutCase, opts?: {
+    language?: ScoutLanguage;
+}): Record<string, string>;
 /** Rebuild a case from the five-file export payloads, validating structure. */
 export declare function importCaseFromFiles(files: Record<string, string>): ScoutCase;
 /** Render a side-by-side comparison report for two or more cases. */
-export declare function renderComparison(cases: ScoutCase[]): string;
+export declare function renderComparison(cases: ScoutCase[], opts?: {
+    language?: ScoutLanguage;
+}): string;