dsh-statcheck 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/LICENSE +201 -0
  3. package/README-zh.md +117 -0
  4. package/README.md +116 -2
  5. package/SECURITY.md +19 -0
  6. package/THIRD_PARTY_NOTICES.md +10 -0
  7. package/cordis.patch.yml +18 -0
  8. package/lib/check.d.ts +92 -0
  9. package/lib/check.d.ts.map +1 -0
  10. package/lib/check.js +250 -0
  11. package/lib/check.js.map +1 -0
  12. package/lib/config.d.ts +37 -0
  13. package/lib/config.d.ts.map +1 -0
  14. package/lib/config.js +44 -0
  15. package/lib/config.js.map +1 -0
  16. package/lib/index.d.ts +36 -0
  17. package/lib/index.d.ts.map +1 -0
  18. package/lib/index.js +50 -0
  19. package/lib/index.js.map +1 -0
  20. package/lib/math.d.ts +76 -0
  21. package/lib/math.d.ts.map +1 -0
  22. package/lib/math.js +218 -0
  23. package/lib/math.js.map +1 -0
  24. package/lib/report.d.ts +41 -0
  25. package/lib/report.d.ts.map +1 -0
  26. package/lib/report.js +91 -0
  27. package/lib/report.js.map +1 -0
  28. package/lib/runtime.d.ts +104 -0
  29. package/lib/runtime.d.ts.map +1 -0
  30. package/lib/runtime.js +235 -0
  31. package/lib/runtime.js.map +1 -0
  32. package/lib/tools/shared.d.ts +127 -0
  33. package/lib/tools/shared.d.ts.map +1 -0
  34. package/lib/tools/shared.js +61 -0
  35. package/lib/tools/shared.js.map +1 -0
  36. package/lib/tools/stat-check.d.ts +12 -0
  37. package/lib/tools/stat-check.d.ts.map +1 -0
  38. package/lib/tools/stat-check.js +83 -0
  39. package/lib/tools/stat-check.js.map +1 -0
  40. package/lib/tools/stat-recompute.d.ts +12 -0
  41. package/lib/tools/stat-recompute.d.ts.map +1 -0
  42. package/lib/tools/stat-recompute.js +82 -0
  43. package/lib/tools/stat-recompute.js.map +1 -0
  44. package/lib/tools/stat-report.d.ts +10 -0
  45. package/lib/tools/stat-report.d.ts.map +1 -0
  46. package/lib/tools/stat-report.js +66 -0
  47. package/lib/tools/stat-report.js.map +1 -0
  48. package/lib/version.d.ts +7 -0
  49. package/lib/version.d.ts.map +1 -0
  50. package/lib/version.js +7 -0
  51. package/lib/version.js.map +1 -0
  52. package/package.json +84 -4
  53. package/src/check.ts +308 -0
  54. package/src/config.ts +71 -0
  55. package/src/index.ts +75 -0
  56. package/src/math.ts +205 -0
  57. package/src/report.ts +113 -0
  58. package/src/runtime.ts +293 -0
  59. package/src/tools/shared.ts +77 -0
  60. package/src/tools/stat-check.ts +83 -0
  61. package/src/tools/stat-recompute.ts +82 -0
  62. package/src/tools/stat-report.ts +68 -0
  63. package/src/version.ts +7 -0
package/lib/math.js ADDED
@@ -0,0 +1,218 @@
1
+ /**
2
+ * Distribution tails for statistical consistency checks — zero dependencies.
3
+ *
4
+ * Implementations: Lanczos log-gamma, regularized incomplete beta (continued
5
+ * fraction), regularized upper incomplete gamma (series + continued fraction),
6
+ * and the normal CDF via an error-function approximation. Accuracy is ~1e-10
7
+ * for the beta/gamma paths, enough for p-values reported to three decimals.
8
+ *
9
+ * Sources are the standard Numerical Recipes formulas (public-domain algorithms,
10
+ * reimplemented in TypeScript).
11
+ *
12
+ * @module dsh-statcheck/math
13
+ */
14
+ const LANCZOS = [
15
+ 0.99999999999980993, 676.5203681218851, -1259.1392167224028, 771.32342877765313,
16
+ -176.61502916214059, 12.507343278686905, -0.13857109526572012, 9.9843695780195716e-6,
17
+ 1.5056327351493116e-7,
18
+ ];
19
+ /**
20
+ * Log-gamma (Lanczos approximation).
21
+ * @param value - a positive number.
22
+ * @returns ln Γ(value).
23
+ */
24
+ export function logGamma(value) {
25
+ if (value < 0.5)
26
+ return Math.log(Math.PI / Math.sin(Math.PI * value)) - logGamma(1 - value);
27
+ const z = value - 1;
28
+ let x = LANCZOS[0];
29
+ for (let index = 1; index < LANCZOS.length; index += 1)
30
+ x += LANCZOS[index] / (z + index);
31
+ const t = z + LANCZOS.length - 2 + 0.5;
32
+ return 0.5 * Math.log(2 * Math.PI) + (z + 0.5) * Math.log(t) - t + Math.log(x);
33
+ }
34
+ /**
35
+ * Continued fraction for the regularized incomplete beta function.
36
+ * @param a - first shape parameter.
37
+ * @param b - second shape parameter.
38
+ * @param x - evaluation point in (0, 1).
39
+ * @returns the fraction value.
40
+ */
41
+ function betaContinuedFraction(a, b, x) {
42
+ const tiny = 1e-300;
43
+ const qab = a + b;
44
+ const qap = a + 1;
45
+ const qam = a - 1;
46
+ let c = 1;
47
+ let d = 1 - (qab * x) / qap;
48
+ if (Math.abs(d) < tiny)
49
+ d = tiny;
50
+ d = 1 / d;
51
+ let h = d;
52
+ for (let m = 1; m <= 300; m += 1) {
53
+ const m2 = 2 * m;
54
+ let aa = (m * (b - m) * x) / ((qam + m2) * (a + m2));
55
+ d = 1 + aa * d;
56
+ if (Math.abs(d) < tiny)
57
+ d = tiny;
58
+ c = 1 + aa / c;
59
+ if (Math.abs(c) < tiny)
60
+ c = tiny;
61
+ d = 1 / d;
62
+ h *= d * c;
63
+ aa = (-(a + m) * (qab + m) * x) / ((a + m2) * (qap + m2));
64
+ d = 1 + aa * d;
65
+ if (Math.abs(d) < tiny)
66
+ d = tiny;
67
+ c = 1 + aa / c;
68
+ if (Math.abs(c) < tiny)
69
+ c = tiny;
70
+ d = 1 / d;
71
+ const delta = d * c;
72
+ h *= delta;
73
+ if (Math.abs(delta - 1) < 3e-14)
74
+ break;
75
+ }
76
+ return h;
77
+ }
78
+ /**
79
+ * Regularized incomplete beta I_x(a, b).
80
+ * @param a - first shape parameter.
81
+ * @param b - second shape parameter.
82
+ * @param x - evaluation point in [0, 1].
83
+ * @returns I_x(a, b) in [0, 1].
84
+ */
85
+ export function incompleteBeta(a, b, x) {
86
+ if (x <= 0)
87
+ return 0;
88
+ if (x >= 1)
89
+ return 1;
90
+ const front = Math.exp(logGamma(a + b) - logGamma(a) - logGamma(b) + a * Math.log(x) + b * Math.log(1 - x));
91
+ if (x < (a + 1) / (a + b + 2))
92
+ return (front * betaContinuedFraction(a, b, x)) / a;
93
+ return 1 - (front * betaContinuedFraction(b, a, 1 - x)) / b;
94
+ }
95
+ /**
96
+ * Regularized upper incomplete gamma Q(a, x).
97
+ * @param a - shape parameter.
98
+ * @param x - evaluation point.
99
+ * @returns Q(a, x) in [0, 1].
100
+ */
101
+ export function upperGamma(a, x) {
102
+ if (x <= 0)
103
+ return 1;
104
+ if (x < a + 1) {
105
+ // Series for P(a, x).
106
+ let term = 1 / a;
107
+ let sum = term;
108
+ let current = a;
109
+ for (let index = 1; index <= 1000; index += 1) {
110
+ current += 1;
111
+ term *= x / current;
112
+ sum += term;
113
+ if (Math.abs(term) < Math.abs(sum) * 1e-15)
114
+ break;
115
+ }
116
+ return 1 - sum * Math.exp(-x + a * Math.log(x) - logGamma(a));
117
+ }
118
+ // Continued fraction for Q(a, x).
119
+ const tiny = 1e-300;
120
+ let b = x + 1 - a;
121
+ let c = 1 / tiny;
122
+ let d = 1 / b;
123
+ let h = d;
124
+ for (let index = 1; index <= 1000; index += 1) {
125
+ const an = -index * (index - a);
126
+ b += 2;
127
+ d = an * d + b;
128
+ if (Math.abs(d) < tiny)
129
+ d = tiny;
130
+ c = b + an / c;
131
+ if (Math.abs(c) < tiny)
132
+ c = tiny;
133
+ d = 1 / d;
134
+ const delta = d * c;
135
+ h *= delta;
136
+ if (Math.abs(delta - 1) < 3e-14)
137
+ break;
138
+ }
139
+ return h * Math.exp(-x + a * Math.log(x) - logGamma(a));
140
+ }
141
+ /**
142
+ * Standard normal CDF (Abramowitz–Stegun 7.1.26; |error| < 1.5e-7).
143
+ * @param value - the z score.
144
+ * @returns Φ(value).
145
+ */
146
+ export function normalCdf(value) {
147
+ // Φ(x) = 0.5 * (1 + erf(x / √2))
148
+ const z = Math.abs(value) / Math.SQRT2;
149
+ const t = 1 / (1 + 0.3275911 * z);
150
+ const erf = 1 -
151
+ ((((1.061405429 * t - 1.453152027) * t + 1.421413741) * t - 0.284496736) * t + 0.254829592) * t * Math.exp(-z * z);
152
+ const cdf = 0.5 * (1 + erf);
153
+ return value >= 0 ? cdf : 1 - cdf;
154
+ }
155
+ /**
156
+ * Two-tailed p for Student's t.
157
+ * @param t - the t statistic (absolute value is used).
158
+ * @param df - degrees of freedom (> 0).
159
+ * @returns the two-tailed p value.
160
+ */
161
+ export function tTwoTailedP(t, df) {
162
+ if (!(df > 0) || !Number.isFinite(df))
163
+ throw new RangeError(`df must be > 0, got ${String(df)}`);
164
+ const x = df / (df + t * t);
165
+ return incompleteBeta(df / 2, 0.5, x);
166
+ }
167
+ /**
168
+ * Upper-tail p for the F distribution.
169
+ * @param f - the F statistic.
170
+ * @param df1 - numerator degrees of freedom.
171
+ * @param df2 - denominator degrees of freedom.
172
+ * @returns P(F >= f).
173
+ */
174
+ export function fUpperP(f, df1, df2) {
175
+ if (!(df1 > 0) || !(df2 > 0))
176
+ throw new RangeError(`df must be > 0, got ${String(df1)}, ${String(df2)}`);
177
+ if (f <= 0)
178
+ return 1;
179
+ return incompleteBeta(df2 / 2, df1 / 2, df2 / (df2 + df1 * f));
180
+ }
181
+ /**
182
+ * Upper-tail p for the chi-square distribution.
183
+ * @param chi2 - the chi-square statistic.
184
+ * @param df - degrees of freedom (> 0).
185
+ * @returns P(χ² >= chi2).
186
+ */
187
+ export function chiSquareUpperP(chi2, df) {
188
+ if (!(df > 0))
189
+ throw new RangeError(`df must be > 0, got ${String(df)}`);
190
+ if (chi2 <= 0)
191
+ return 1;
192
+ return upperGamma(df / 2, chi2 / 2);
193
+ }
194
+ /**
195
+ * Two-tailed p for a correlation r with df = n - 2.
196
+ * @param r - the correlation.
197
+ * @param df - degrees of freedom (> 0).
198
+ * @returns the two-tailed p value.
199
+ */
200
+ export function rTwoTailedP(r, df) {
201
+ if (!(df > 0))
202
+ throw new RangeError(`df must be > 0, got ${String(df)}`);
203
+ if (Math.abs(r) > 1)
204
+ throw new RangeError(`r must be in [-1, 1], got ${String(r)}`);
205
+ if (Math.abs(r) === 1)
206
+ return 0;
207
+ const t = r * Math.sqrt(df / (1 - r * r));
208
+ return tTwoTailedP(t, df);
209
+ }
210
+ /**
211
+ * Two-tailed p for a z statistic.
212
+ * @param z - the z statistic.
213
+ * @returns the two-tailed p value.
214
+ */
215
+ export function zTwoTailedP(z) {
216
+ return 2 * (1 - normalCdf(Math.abs(z)));
217
+ }
218
+ //# sourceMappingURL=math.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"math.js","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * SARIF 2.1.0 and Markdown rendering for statistical findings.
3
+ *
4
+ * Every finding names the reported value, the recomputed value and the exact
5
+ * character range, so a reviewer can check it in seconds. Nothing is described
6
+ * as misconduct: the text says "the reported p does not follow from the
7
+ * reported statistic".
8
+ *
9
+ * @module dsh-statcheck/report
10
+ */
11
+ import type { StatFinding } from './check.ts';
12
+ /** Minimal SARIF shapes emitted here. */
13
+ export interface StatSarifResult {
14
+ readonly ruleId: string;
15
+ readonly level: 'error' | 'warning' | 'note';
16
+ readonly message: {
17
+ readonly text: string;
18
+ };
19
+ readonly locations: readonly {
20
+ readonly physicalLocation: {
21
+ readonly artifactLocation: {
22
+ readonly uri: string;
23
+ };
24
+ readonly region: {
25
+ readonly startLine: number;
26
+ readonly startColumn: number;
27
+ };
28
+ };
29
+ }[];
30
+ readonly properties: Record<string, unknown>;
31
+ }
32
+ /** Render findings as a SARIF 2.1.0 log. */
33
+ export declare function findingsToSarif(findings: readonly StatFinding[], version: string, text?: string): Record<string, unknown>;
34
+ /** Render findings as a Markdown table plus a short explanation. */
35
+ export declare function findingsToMarkdown(findings: readonly StatFinding[], summary: {
36
+ total: number;
37
+ consistent: number;
38
+ inconsistent: number;
39
+ unparsed: number;
40
+ }): string;
41
+ //# sourceMappingURL=report.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,gBAAgB,EAAE;YACzB,QAAQ,CAAC,gBAAgB,EAAE;gBAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;aAAE,CAAA;YACnD,QAAQ,CAAC,MAAM,EAAE;gBAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAA;SAC9E,CAAA;KACF,EAAE,CAAA;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7C;AAoBD,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzH;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsBnK"}
package/lib/report.js ADDED
@@ -0,0 +1,91 @@
1
+ /**
2
+ * SARIF 2.1.0 and Markdown rendering for statistical findings.
3
+ *
4
+ * Every finding names the reported value, the recomputed value and the exact
5
+ * character range, so a reviewer can check it in seconds. Nothing is described
6
+ * as misconduct: the text says "the reported p does not follow from the
7
+ * reported statistic".
8
+ *
9
+ * @module dsh-statcheck/report
10
+ */
11
+ /** Read a finite recomputed p, tolerating the JSON `null` a df error emits. */
12
+ function recomputedOf(finding) {
13
+ const value = finding.recomputed?.p;
14
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
15
+ }
16
+ /**
17
+ * Map a UTF-16 character offset to a 1-based SARIF line/column.
18
+ * Without the source text the old line-1 + character-column fallback is kept.
19
+ */
20
+ function regionOf(finding, text) {
21
+ if (text === undefined)
22
+ return { startLine: 1, startColumn: finding.charStart + 1 };
23
+ const offset = Math.min(Math.max(finding.charStart, 0), text.length);
24
+ const before = text.slice(0, offset);
25
+ const lastNewline = before.lastIndexOf('\n');
26
+ return { startLine: before.split('\n').length, startColumn: offset - lastNewline };
27
+ }
28
+ /** Render findings as a SARIF 2.1.0 log. */
29
+ export function findingsToSarif(findings, version, text) {
30
+ const results = findings
31
+ .filter(finding => finding.status === 'inconsistent')
32
+ .map(finding => {
33
+ const recomputed = recomputedOf(finding);
34
+ return {
35
+ ruleId: `statcheck/${finding.issue ?? 'p-value'}`,
36
+ level: 'error',
37
+ message: {
38
+ text: `${finding.text}: ${finding.detail}`,
39
+ },
40
+ locations: [
41
+ {
42
+ physicalLocation: {
43
+ artifactLocation: { uri: 'manuscript.txt' },
44
+ region: regionOf(finding, text),
45
+ },
46
+ },
47
+ ],
48
+ properties: {
49
+ statistic: finding.statistic,
50
+ df: [...finding.df],
51
+ reportedP: finding.reported.p ?? null,
52
+ recomputedP: recomputed === undefined ? null : Number(recomputed.toFixed(6)),
53
+ issue: finding.issue ?? null,
54
+ charStart: finding.charStart,
55
+ charEnd: finding.charEnd,
56
+ },
57
+ };
58
+ });
59
+ const rules = [...new Set(results.map(result => result.ruleId))].map(id => ({ id, name: id.split('/')[1] ?? 'finding' }));
60
+ return {
61
+ $schema: 'https://json.schemastore.org/sarif-2.1.0.json',
62
+ version: '2.1.0',
63
+ runs: [
64
+ {
65
+ tool: { driver: { name: 'dsh-statcheck', version, ...(rules.length === 0 ? {} : { rules }) } },
66
+ results,
67
+ },
68
+ ],
69
+ };
70
+ }
71
+ /** Render findings as a Markdown table plus a short explanation. */
72
+ export function findingsToMarkdown(findings, summary) {
73
+ const lines = [];
74
+ lines.push('# Statistical consistency report');
75
+ lines.push('');
76
+ lines.push(`${summary.total} reported statistic(s): ${summary.consistent} consistent, ${summary.inconsistent} inconsistent, ${summary.unparsed} unparsed.`);
77
+ lines.push('');
78
+ if (summary.inconsistent > 0) {
79
+ lines.push('> These findings mean **the reported p value does not follow from the reported statistic**. They do not imply misconduct, and they are not a substitute for a statistician reviewing the analysis.');
80
+ lines.push('');
81
+ }
82
+ lines.push('| # | Reported | Recomputed p | Status | Detail | Chars |');
83
+ lines.push('|---:|---|---:|---|---|---|');
84
+ findings.forEach((finding, index) => {
85
+ const recomputed = recomputedOf(finding);
86
+ const shown = recomputed === undefined ? 'n/a' : recomputed.toFixed(4);
87
+ lines.push(`| ${index + 1} | \`${finding.text}\` | ${shown} | ${finding.status}${finding.issue === undefined ? '' : ` (${finding.issue})`} | ${finding.detail.replace(/\|/gu, '\\|')} | ${finding.charStart}-${finding.charEnd} |`);
88
+ });
89
+ return `${lines.join('\n')}\n`;
90
+ }
91
+ //# sourceMappingURL=report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Runtime: text/path handling, REP evidence and records for statistical
3
+ * findings.
4
+ *
5
+ * A finding is a check on the manuscript snapshot: `pass` for a consistent
6
+ * report, `fail` for an inconsistent one, `skipped` (`parse_failed`) when no p
7
+ * value could be located. The evidence status therefore inherits the same
8
+ * honesty rules as the rest of the family.
9
+ *
10
+ * @module dsh-statcheck/runtime
11
+ */
12
+ import { type AddEvidenceInput, type CaptureInput, type CheckResult, type Evidence, type ResearchRecord, type Snapshot } from '@perrylink/dsh-research-core';
13
+ import { StatInputError, type StatFinding, type StatisticKind, type StatSummary } from './check.ts';
14
+ import type { ResolvedConfig } from './config.ts';
15
+ /** Stable runtime error codes. */
16
+ export type StatcheckErrorCode = 'INVALID_INPUT' | 'NOT_FOUND' | 'PATH_ESCAPE' | 'NOT_A_FILE' | 'TOO_LARGE' | 'OUT_OF_DOMAIN' | 'STORE_ERROR';
17
+ /** A typed failure. */
18
+ export declare class StatcheckError extends Error {
19
+ /** Stable code. */
20
+ readonly code: StatcheckErrorCode;
21
+ constructor(code: StatcheckErrorCode, message: string);
22
+ }
23
+ /** The subset of the REP service used here. */
24
+ export interface EvidencePort {
25
+ capture(input: CaptureInput): Promise<{
26
+ snapshot: Snapshot;
27
+ }>;
28
+ addEvidence(input: AddEvidenceInput): Promise<{
29
+ evidence: Evidence;
30
+ }>;
31
+ buildRecord(options?: {
32
+ evidenceIds?: readonly string[];
33
+ }): Promise<Omit<ResearchRecord, 'manifest'>>;
34
+ }
35
+ /** The `stat_check` success value. */
36
+ export interface StatCheckResult {
37
+ readonly ok: true;
38
+ readonly summary: StatSummary;
39
+ readonly findings: readonly StatFinding[];
40
+ readonly source: {
41
+ readonly kind: 'file' | 'inline';
42
+ readonly id: string;
43
+ readonly chars: number;
44
+ };
45
+ readonly evidenceId?: string;
46
+ readonly recordPath?: string;
47
+ }
48
+ /** Input for {@link StatcheckRuntime.check}. */
49
+ export interface StatCheckRequest {
50
+ readonly text?: string;
51
+ readonly path?: string;
52
+ readonly persist?: boolean;
53
+ readonly maxFindings?: number;
54
+ }
55
+ /** Options for {@link StatcheckRuntime}. */
56
+ export interface StatcheckRuntimeOptions {
57
+ readonly config: ResolvedConfig;
58
+ readonly service?: EvidencePort;
59
+ readonly now?: () => Date;
60
+ }
61
+ /** Map one finding to a REP check. */
62
+ export declare function findingToCheck(finding: StatFinding): CheckResult;
63
+ /** The statcheck runtime. */
64
+ export declare class StatcheckRuntime {
65
+ #private;
66
+ readonly config: ResolvedConfig;
67
+ constructor(options: StatcheckRuntimeOptions);
68
+ /** Current ISO timestamp. */
69
+ iso(): string;
70
+ /** The evidence port. */
71
+ port(): EvidencePort;
72
+ /** Resolve a manuscript path inside the workspace. */
73
+ resolvePath(input: string): Promise<{
74
+ absolute: string;
75
+ id: string;
76
+ }>;
77
+ /**
78
+ * Analyze text or a workspace manuscript.
79
+ * @param request - text or path plus optional caps.
80
+ * @returns findings, counts and (when persisting) the evidence id and record path.
81
+ */
82
+ check(request: StatCheckRequest): Promise<StatCheckResult>;
83
+ /**
84
+ * Recompute one statistic and optionally judge a reported p.
85
+ * @param input - statistic kind, value, df and optional reported p string.
86
+ * @returns the recomputed p and, when a p was given, the judgment.
87
+ */
88
+ recompute(input: {
89
+ statistic: StatisticKind;
90
+ value: number;
91
+ df: readonly number[];
92
+ p?: string;
93
+ }): {
94
+ p: number;
95
+ judgment?: {
96
+ status: 'consistent' | 'inconsistent';
97
+ issue?: string;
98
+ detail: string;
99
+ };
100
+ };
101
+ }
102
+ /** Re-export the math errors for tools. */
103
+ export { StatInputError };
104
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}