@nanonets/graft 0.21.1 → 0.22.0

package/dist/check/local-check.d.ts

@@ -0,0 +1,104 @@
+import type { CheckFinding, CheckResult } from "./types.js";
+import type { Note } from "../notes/notes.js";
+import type { Skill } from "../skills/skills.js";
+export interface LocalCheckInput {
+    /** Unified diff text, as `git diff <base>...` gives it (the CLI already produces it, capped at 400 KB). */
+    diff: string;
+    /** Changed files, repo-relative. */
+    files: string[];
+    /** Every note that could bear on the repo; the check picks its candidates itself. */
+    notes: Note[];
+    /** Skills from `listSkills(repo)`. */
+    skills: Skill[];
+    /** Who is asking (first name). The server only records it: a note by the asker is still a candidate. */
+    asker?: string;
+    now?: Date;
+}
+/**
+ * Check a diff against the notes and skills on this machine, with the rules
+ * Trail's server falls back to when it has no model. Same shape as the
+ * server's answer: `files` is the changed-file count, `notes` and `skills`
+ * how many the check was given (the server reports how many it has indexed),
+ * and the findings, conflicts first.
+ */
+export declare function checkLocally(input: LocalCheckInput): CheckResult;
+/** `NormalizeBox` → [Normalize, Box], `max_retries` → [max, retries], `HTTPServer` → [HTTP, Server]. */
+export declare function splitIdentifier(word: string): string[];
+/**
+ * The terms of a piece of text, lower-cased, deduplicated, in first-seen
+ * order. Identifiers give their parts and, for camelCase, the whole word too.
+ * At most `max` (0: no cap).
+ */
+export declare function trailTerms(text: string, max?: number): string[];
+/**
+ * Folds the plural and simple verb endings that make two people's words for
+ * the same thing differ (`retries`/`retry`). Much weaker than a stemmer on
+ * purpose: it only has to stop overlap detection missing the obvious.
+ */
+export declare function normTerm(term: string): string;
+export interface DiffLine {
+    /** New-file line number; 0 for a removed line. */
+    new: number;
+    op: "+" | "-" | " ";
+    text: string;
+}
+export interface DiffFile {
+    path: string;
+    lines: DiffLine[];
+    hunks: Array<{
+        start: number;
+        len: number;
+    }>;
+}
+/** Every line the diff adds to the file. */
+export declare function addedText(f: DiffFile): string[];
+/** Whether a new-file line number lies inside one of the file's hunks. */
+export declare function inHunk(f: DiffFile, line: number): boolean;
+/**
+ * A unified diff (git's or plain) as files. Hunk bodies are read by their
+ * declared line counts, so an added line that itself starts with `+++` is not
+ * taken for a file header. A deleted file keeps its old path.
+ */
+export declare function parseTrailDiff(diff: string): DiffFile[];
+/** The words and identifiers the diff adds: identifiers (camelCase, snake_case, with digits) first, then by how often they appear. */
+export declare function trailDiffTerms(added: string[], max: number): string[];
+/** The changed files: what the caller listed, then every file the diff names, deduplicated in that order. */
+export declare function trailCheckFiles(listed: string[], diffFiles: DiffFile[]): string[];
+/** One piece of knowledge a diff is held against. */
+export type Candidate = {
+    kind: "note";
+    note: Note;
+} | {
+    kind: "skill";
+    skill: Skill;
+};
+/**
+ * At most 25 pieces of knowledge for the changed files: skills that name a
+ * changed path or share the diff's words (at most 6), then notes that touched
+ * these files or their folders, or share the diff's words, best first. Notes
+ * come first in the returned order. Exported for tests.
+ */
+export declare function selectTrailCheckCandidates(files: string[], diffTerms: string[], notes: Array<{
+    note: Note;
+    textScore: number;
+}>, skills: Array<{
+    skill: Skill;
+    textScore: number;
+}>, now: Date): Candidate[];
+/**
+ * A line of prose as sentences, without bullet or numbering markers. Each is
+ * a verbatim run of the line, so it can be quoted back as written. Exported
+ * for tests.
+ */
+export declare function trailSentences(raw: string): string[];
+/** Every number a sentence states, in digits (`60s`, `4th`) or words (`three`, `fourth`). Exported for tests. */
+export declare function trailNumbers(text: string): Set<number>;
+/** The numbers a code line carries outside its identifiers (`retries2` gives no 2), in order. Exported for tests. */
+export declare function trailLineNumbers(line: string): string[];
+/**
+ * Holds the diff against the candidates with the rules above. One finding per
+ * (file, candidate), a conflict winning over a follow; conflicts first, then
+ * by file and line; at most 20. Exported for tests.
+ */
+export declare function judgeTrailCheck(candidates: Candidate[], diffFiles: DiffFile[]): CheckFinding[];
+//# sourceMappingURL=local-check.d.ts.map

package/dist/check/local-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-check.d.ts","sourceRoot":"","sources":["../../src/check/local-check.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAqBjD,MAAM,WAAW,eAAe;IAC9B,2GAA2G;IAC3G,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qFAAqF;IACrF,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,wGAAwG;IACxG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAqBhE;AA6BD,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBtD;AAWD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CAgB1D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7C;AAgED,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAE/C;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAiCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CA0DvD;AAED,sIAAsI;AACtI,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBrE;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAWjF;AAMD,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AA8FvF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,GAAG,EAAE,IAAI,GACR,SAAS,EAAE,CA0Bb;AA0CD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBpD;AAiGD,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQtD;AAYD,qHAAqH;AACrH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAyFD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CA0E9F"}