@hawkeyexl/manni 4.4.1 → 4.6.0

package/dist/docmeta.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   buildProgram
-} from "./chunk-QZ6LRSNV.js";
-import "./chunk-6JSSEWBG.js";
-import "./chunk-A5ULMVHQ.js";
-import "./chunk-TK3FC4RF.js";
-import "./chunk-M3W7J6MU.js";
-import "./chunk-IDV6HJCB.js";
-import "./chunk-57NEQRVO.js";
+} from "./chunk-3NWX34ZI.js";
+import "./chunk-GREQKO6M.js";
+import "./chunk-TUAAR3MM.js";
+import "./chunk-5G53XATW.js";
+import "./chunk-KCOFEWV5.js";
 import {
   runIfMain
 } from "./chunk-YEUYKR62.js";
 import "./chunk-RNVYGWIC.js";
 import "./chunk-MNH7QO4Z.js";
-import "./chunk-Q35YIDBV.js";
-import "./chunk-UJCVAWP7.js";
+import "./chunk-XKBEHKWO.js";
+import "./chunk-HX44GB4Z.js";
+import "./chunk-QCHVR4ZM.js";
+import "./chunk-PCFG7E6B.js";
 import "./chunk-OWBRDNRZ.js";
 import "./chunk-G3T47CFV.js";
 import "./chunk-2H7UOFLK.js";

package/dist/github-7ZCH5PSO.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  renderFindingsGithub
+} from "./chunk-C3B2VJNC.js";
+import "./chunk-C73RSUIC.js";
+import "./chunk-77AINBYM.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-TLXE7LYK.js";
+import "./chunk-GREQKO6M.js";
+import "./chunk-TUAAR3MM.js";
+import "./chunk-5G53XATW.js";
+import "./chunk-KCOFEWV5.js";
+import "./chunk-YEUYKR62.js";
+import "./chunk-RNVYGWIC.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-XKBEHKWO.js";
+import "./chunk-HX44GB4Z.js";
+import "./chunk-QCHVR4ZM.js";
+import "./chunk-PCFG7E6B.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  renderFindingsGithub
+};
+//# sourceMappingURL=github-7ZCH5PSO.js.map

package/dist/github-POT6724K.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+} from "./chunk-GAJIJKET.js";
+import "./chunk-T6SYGLWR.js";
+import "./chunk-UAKNZVCD.js";
+import "./chunk-MHM4QEBV.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-TLXE7LYK.js";
+import "./chunk-GREQKO6M.js";
+import "./chunk-TUAAR3MM.js";
+import "./chunk-5G53XATW.js";
+import "./chunk-KCOFEWV5.js";
+import "./chunk-YEUYKR62.js";
+import "./chunk-RNVYGWIC.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-XKBEHKWO.js";
+import "./chunk-HX44GB4Z.js";
+import "./chunk-QCHVR4ZM.js";
+import "./chunk-PCFG7E6B.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+};
+//# sourceMappingURL=github-POT6724K.js.map

package/dist/host-6GURH5HE.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import {
+  QUEUE_WAIT_MS,
+  hostHolds,
+  hostSetting,
+  hostStatus,
+  queued,
+  releaseHost,
+  warmModel
+} from "./chunk-WQWKYAAK.js";
+import "./chunk-QCHVR4ZM.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  QUEUE_WAIT_MS,
+  hostHolds,
+  hostSetting,
+  hostStatus,
+  queued,
+  releaseHost,
+  warmModel
+};
+//# sourceMappingURL=host-6GURH5HE.js.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ProviderSelector, InferenceProvider, ConsensusResult, ExecFn, ProviderSpec, ProviderName as ProviderName$1, CompleteJSONRequest, CompleteJSONResponse, JudgeRun, JudgeVerdict, Match as Match$1, MockProvider, MockResponse, Zone, ZoneThresholds, computeConsensus, mockVerdict, zoneFor, JsonCache, sha256 } from '@hawkeyexl/inference';
+import { ProviderSelector, InferenceProvider, ConsensusResult, ExecFn, ProviderSpec, ProviderName as ProviderName$1, CompleteJSONRequest, CompleteJSONResponse, JudgeRun, JudgeVerdict, Match as Match$1, MockProvider, MockResponse, Zone, ZoneThresholds, computeConsensus, mockVerdict, zoneFor, JsonCache, LlamaCppProviderOptions, sha256 } from '@hawkeyexl/inference';
 import { Buffer as Buffer$1 } from 'node:buffer';
 import { DatabaseSync } from 'node:sqlite';
 import pc from 'picocolors';
@@ -373,10 +373,21 @@ interface ProviderConnections {
     "claude-cli"?: {
         command?: string;
     };
-    /** `modelsDir` is absolute: resolved against the config file's directory. */
+    /** A decide-only provider: it judges, and never generates. */
+    jev?: {
+        apiKeyEnv?: string;
+        baseUrl?: string;
+    };
+    /**
+     * `modelsDir` is absolute: resolved against the config file's directory.
+     * `keepAlive` is milliseconds, parsed from a duration; `0` unloads a model
+     * as soon as no session holds it. It belongs to the model host, so it
+     * never reaches a provider spec.
+     */
     "llama-cpp"?: {
         modelsDir?: string;
         thoughtTokens?: number;
+        keepAlive?: number;
     };
 }
 /** The family's top-level `providers:` map, parsed. */
@@ -7826,6 +7837,21 @@ interface SectionNode {
     parentSlug: string | null;
     /** Span of the title itself. Null for the implicit lead section. */
     titlePosition: Position | null;
+    /**
+     * The anchor the source itself gives this section, verbatim - an HTML `id`,
+     * a DITA `@id`, an AsciiDoc `[[id]]`, a reST `.. _label:` - when it gives
+     * one. `slug` stays the slugged title either way: a link written against
+     * the source's own id resolves through this, and nothing lint matches on
+     * reads it.
+     */
+    id?: string;
+    /**
+     * Set on the level-1 section `withMetadataTitle` made from a metadata
+     * `title`, so a consumer can tell it from a heading the author wrote. Its
+     * `titlePosition` is not enough: a reST title read back as docinfo shares
+     * its span with the frontmatter, written or not.
+     */
+    synthetic?: true;
     /** Span of the whole section: its heading through the last node before the next sibling heading. */
     position: Position;
     /** Direct content, in document order, excluding anything owned by a subsection. */
@@ -7845,6 +7871,16 @@ interface DocumentTree {
     frontmatterPosition: Position | null;
     /** Top-level sections, in document order. */
     sections: SectionNode[];
+    /**
+     * Link targets exactly as the source wrote them, in document order, for
+     * `manni graph`. No lint rule reads them. Each parser decides what counts:
+     * an anchor to elsewhere does, and a stylesheet, a heading's own permalink,
+     * or a key reference resolved only at build time does not.
+     */
+    links: {
+        target: string;
+        position: Position;
+    }[];
 }
 /**
  * A parser for one input format.
@@ -9156,16 +9192,13 @@ interface RunConfigOptions {
  */
 declare function loadRunConfig(opts: RunConfigOptions, cwd?: string): GraphConfig;
 
-/** The formats graph parses, as `--as` names them. */
-declare const DOC_FORMATS: readonly ["markdown", "mdx"];
+/** The formats graph parses, as `--as` names them: lint's parser names. */
+declare const DOC_FORMATS: readonly ["asciidoc", "html", "markdown", "mdx", "rst", "xml"];
 type DocFormat = (typeof DOC_FORMATS)[number];
 interface AnalyzeOptions {
     /** Site-route mappings for resolving root-absolute links. */
     routes?: RouteMapping[];
-    /**
-     * `--as`: parse as this format whatever the path says. Absent, a `.mdx`
-     * path is MDX and anything else is markdown.
-     */
+    /** `--as`: parse as this format whatever the path says. Absent, see `formatOf`. */
     format?: DocFormat;
     /**
      * How the body is parsed. Absent, `parseBody`. `graph build` passes a cache's
@@ -9191,7 +9224,7 @@ interface DocBody {
     /** Code fence languages, sorted and distinct. */
     codeLanguages: string[];
 }
-/** Analyze one Markdown file. `allPaths` is the discovered corpus for link resolution. */
+/** Analyze one document. `allPaths` is the discovered corpus for link resolution. */
 declare function analyzeDoc(content: string, relPath: string, allPaths: ReadonlySet<string>, options?: AnalyzeOptions): DocModel;
 
 /** Shared types for manni graph. */
@@ -9304,7 +9337,7 @@ interface DocumentSetOptions {
     exclude?: string[];
     /**
      * `--ext <list>`: what a directory walk or a glob keeps. Absent means
-     * `.md,.mdx,.markdown`. A file named outright is never filtered by it.
+     * `DEFAULT_EXTENSIONS`. A file named outright is never filtered by it.
      */
     ext?: string[];
     /** `--as <format>`: parse every input as this format. Required with `-`. */
@@ -12610,8 +12643,11 @@ type Options = Record<string, unknown>;
  * branch, and project rules govern the whole session.
  */
 interface TraceWindow {
-    /** Which rule produced this window. */
-    scope: "session" | "skill" | "agent" | "slash-command";
+    /**
+     * Which rule produced this window. `turn` is the last turn of a session or
+     * a subagent's whole run, cut by `rules/turn.ts` (proposal 0079).
+     */
+    scope: "session" | "skill" | "agent" | "slash-command" | "turn";
     /** Names the window in reasons and in the judge digest. */
     label: string;
     /**
@@ -12674,6 +12710,11 @@ declare const CONDITIONS: {
         test: (value: unknown, window: TraceWindow) => boolean;
         reason: (value: unknown) => string;
     };
+    "command-matches": {
+        validate: (value: unknown) => string | undefined;
+        test: (value: unknown, window: TraceWindow) => boolean;
+        reason: (value: unknown) => string;
+    };
     "turn-count-above": {
         validate: (value: unknown) => "options.when.turn-count-above must be a whole number" | "options.when.turn-count-above must be at least 0" | undefined;
         test: (value: unknown, window: TraceWindow) => boolean;
@@ -12735,6 +12776,17 @@ interface RenderOptions {
      * than instead of them. Sources are compiled with the `g` flag.
      */
     redact?: string[];
+    /**
+     * A window cut elsewhere, such as the turn a Stop judges (proposal 0079).
+     * It takes the place of the plan's window when both are given.
+     */
+    window?: TraceWindow;
+    /**
+     * Called when `maxTotalChars` cut the digest: the header, the timeline, or
+     * both. The cut is already visible as a marker in the text; this lets a
+     * caller say so in a warning as well.
+     */
+    onTruncated?: () => void;
 }
 declare function renderTrace(trace: Trace, options?: RenderOptions, plan?: EvalPlan): string;
 
@@ -12918,6 +12970,19 @@ interface TraceJudgeContext {
 type TraceJudge = (plans: EvalPlan[], renderFor: (plan: EvalPlan) => string, context?: TraceJudgeContext) => Promise<JudgedEval[]>;
 declare function makeTraceJudge(options: TraceJudgeOptions): TraceJudge;
 
+/**
+ * The model host seam (proposal 0079, "Concurrency and the model host").
+ *
+ * The host is one background process per machine and user that keeps a local
+ * model loaded between hooks, with a queue, leases and keep-alive. The
+ * inference library owns it. Every host-dependent behavior goes through this
+ * module and no other, and the library's three calls are injectable so a test
+ * never starts a real host.
+ */
+
+/** The host fields of a `llama-cpp` provider spec. */
+type HostSetting = Pick<LlamaCppProviderOptions, "host" | "session" | "keepAlive" | "hostWaitMs">;
+
 declare const DEFAULT_CONFIG_FILENAME: string;
 /**
  * Top-level key holding this tool's settings inside the shared family config.
@@ -13019,6 +13084,26 @@ interface TracevalsConfig {
     plugins: string[];
     /** List offered-but-unused artifacts in coverage, not just count them. */
     reportUnusedArtifacts: boolean;
+    /**
+     * Checking each turn against its rule sources (proposal 0079). `null` when
+     * the section is absent, which keeps tracevals out of every hook; `{}` puts
+     * it in play with these defaults.
+     */
+    conformance: ConformanceConfig | null;
+}
+interface ConformanceConfig {
+    /** The in-loop judge. `null` falls back to `tracevals.provider` / `model`. */
+    hook: {
+        provider: string | null;
+        model: string | null;
+        runs: number;
+    };
+    /** Globs of designated rule sources, in scope once read. */
+    include: string[];
+    /** Globs never treated as rule sources. */
+    exclude: string[];
+    /** Globs of files that say what to build, in scope once touched (proposal 0080). */
+    plans: string[];
 }
 /** What the file the section came from carries beside it. */
 interface ConfigFileContext {
@@ -13065,6 +13150,11 @@ interface JudgeProviderOptions {
      * offered, so nothing that lists providers mentions it.
      */
     mockResponses?: MockResponse[];
+    /**
+     * How a `llama-cpp` provider reaches the model host. Unset, it connects to
+     * a running host and never starts one, which is every run by hand.
+     */
+    host?: HostSetting;
 }
 /**
  * The provider and model in force: a flag, then the eval's own choice, then