@legioncodeinc/nectar 0.0.1

package/dist/brood-prereqs.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Brood prerequisite evaluation and first-run guidance (PRD-018k / NEC-023).
+ *
+ * Brooding is dormant out of the box: auto-brood on boot runs only when Deep
+ * Lake credentials resolve AND Portkey is explicitly enabled (via
+ * `NECTAR_PORTKEY_ENABLED` + `NECTAR_PORTKEY_API_KEY` + `NECTAR_PORTKEY_CONFIG`).
+ * Without those the daemon boots, serves `/health`, and describes nothing, with
+ * no signal that it is waiting on configuration. This module makes the dormancy
+ * loud: the daemon logs exactly which prerequisites are missing at startup, the
+ * `/health` brooding slice carries a machine-readable reason, and (on an
+ * interactive terminal) the CLI prints the exact steps to configure them.
+ *
+ * Pure and dependency-free (Node built-ins only, AGENTS.md): a caller supplies
+ * whether the credentials file resolved and the Portkey env flags; this module
+ * decides ready/dormant, the machine-readable reason, and the human message.
+ */
+/** The machine-readable dormancy reason surfaced on `/health` and in the startup log. */
+export type BroodDormancyReason = "credentials_missing" | "portkey_disabled";
+/** The outcome of evaluating the brood prerequisites. */
+export interface BroodPrereqStatus {
+    /** True when every prerequisite is satisfied (auto-brood can run). */
+    readonly ready: boolean;
+    /** The machine-readable reason when dormant; null when ready. */
+    readonly reason: BroodDormancyReason | null;
+    /** Human-readable list of exactly what is missing (empty when ready). */
+    readonly missing: readonly string[];
+}
+/** The resolved prerequisite inputs (each already reduced to a boolean by the caller). */
+export interface BroodPrereqInputs {
+    /** `~/.deeplake/credentials.json` resolved and validated. */
+    readonly credentialsPresent: boolean;
+    /** The credentials file path, named in the missing list when absent. */
+    readonly credentialsPath: string;
+    /** `NECTAR_PORTKEY_ENABLED` is set to a truthy value. */
+    readonly portkeyEnabled: boolean;
+    /** `NECTAR_PORTKEY_API_KEY` is set (non-blank). */
+    readonly portkeyApiKeySet: boolean;
+    /** `NECTAR_PORTKEY_CONFIG` is set (non-blank). */
+    readonly portkeyConfigSet: boolean;
+}
+/**
+ * Evaluate the brood prerequisites. `ready` is true only when the credentials
+ * file resolved and all three Portkey variables are set; otherwise `reason` is
+ * `credentials_missing` (credentials take priority as the first blocker) or
+ * `portkey_disabled`, and `missing` names each unsatisfied prerequisite so the
+ * startup log can enumerate them (AC-018k.1 / AC-018k.2).
+ */
+export declare function evaluateBroodPrereqs(inputs: BroodPrereqInputs): BroodPrereqStatus;
+/** Build the prerequisite status from the process env + a resolved credentials state. */
+export declare function broodPrereqsFromEnv(opts: {
+    readonly credentialsPresent: boolean;
+    readonly credentialsPath: string;
+    readonly env?: NodeJS.ProcessEnv;
+}): BroodPrereqStatus;
+/**
+ * Build the guided first-run message a caller prints on an interactive terminal
+ * (AC-018k.5 option B): the exact steps to satisfy the missing prerequisites.
+ * Returns the empty string when nothing is missing, so a caller can print it
+ * unconditionally without a "you are configured" line.
+ */
+export declare function formatFirstRunGuidance(status: BroodPrereqStatus): string;
+//# sourceMappingURL=brood-prereqs.d.ts.map

package/dist/brood-prereqs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brood-prereqs.d.ts","sourceRoot":"","sources":["../src/brood-prereqs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,yFAAyF;AACzF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAE7E,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAUjF;AAcD,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,GAAG,iBAAiB,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAiBxE"}

package/dist/brood-prereqs.js

@@ -0,0 +1,87 @@
+/**
+ * Brood prerequisite evaluation and first-run guidance (PRD-018k / NEC-023).
+ *
+ * Brooding is dormant out of the box: auto-brood on boot runs only when Deep
+ * Lake credentials resolve AND Portkey is explicitly enabled (via
+ * `NECTAR_PORTKEY_ENABLED` + `NECTAR_PORTKEY_API_KEY` + `NECTAR_PORTKEY_CONFIG`).
+ * Without those the daemon boots, serves `/health`, and describes nothing, with
+ * no signal that it is waiting on configuration. This module makes the dormancy
+ * loud: the daemon logs exactly which prerequisites are missing at startup, the
+ * `/health` brooding slice carries a machine-readable reason, and (on an
+ * interactive terminal) the CLI prints the exact steps to configure them.
+ *
+ * Pure and dependency-free (Node built-ins only, AGENTS.md): a caller supplies
+ * whether the credentials file resolved and the Portkey env flags; this module
+ * decides ready/dormant, the machine-readable reason, and the human message.
+ */
+/**
+ * Evaluate the brood prerequisites. `ready` is true only when the credentials
+ * file resolved and all three Portkey variables are set; otherwise `reason` is
+ * `credentials_missing` (credentials take priority as the first blocker) or
+ * `portkey_disabled`, and `missing` names each unsatisfied prerequisite so the
+ * startup log can enumerate them (AC-018k.1 / AC-018k.2).
+ */
+export function evaluateBroodPrereqs(inputs) {
+    const missing = [];
+    if (!inputs.credentialsPresent)
+        missing.push(`${inputs.credentialsPath} (Deep Lake credentials)`);
+    if (!inputs.portkeyEnabled)
+        missing.push("NECTAR_PORTKEY_ENABLED");
+    if (!inputs.portkeyApiKeySet)
+        missing.push("NECTAR_PORTKEY_API_KEY");
+    if (!inputs.portkeyConfigSet)
+        missing.push("NECTAR_PORTKEY_CONFIG");
+    if (missing.length === 0)
+        return { ready: true, reason: null, missing: [] };
+    const reason = inputs.credentialsPresent ? "portkey_disabled" : "credentials_missing";
+    return { ready: false, reason, missing };
+}
+/** True when an env value is a recognized truthy flag (mirrors portkey/config's `envBool`). */
+function envTruthy(raw) {
+    if (raw === undefined)
+        return false;
+    const v = raw.trim().toLowerCase();
+    return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+/** True when an env value is present and non-blank. */
+function envSet(raw) {
+    return raw !== undefined && raw.trim() !== "";
+}
+/** Build the prerequisite status from the process env + a resolved credentials state. */
+export function broodPrereqsFromEnv(opts) {
+    const env = opts.env ?? process.env;
+    return evaluateBroodPrereqs({
+        credentialsPresent: opts.credentialsPresent,
+        credentialsPath: opts.credentialsPath,
+        portkeyEnabled: envTruthy(env["NECTAR_PORTKEY_ENABLED"]),
+        portkeyApiKeySet: envSet(env["NECTAR_PORTKEY_API_KEY"]),
+        portkeyConfigSet: envSet(env["NECTAR_PORTKEY_CONFIG"]),
+    });
+}
+/**
+ * Build the guided first-run message a caller prints on an interactive terminal
+ * (AC-018k.5 option B): the exact steps to satisfy the missing prerequisites.
+ * Returns the empty string when nothing is missing, so a caller can print it
+ * unconditionally without a "you are configured" line.
+ */
+export function formatFirstRunGuidance(status) {
+    if (status.ready)
+        return "";
+    const lines = [
+        "nectar: brooding is dormant, so no file will be described yet.",
+        "To enable it, configure these prerequisites, then restart the daemon:",
+    ];
+    if (status.reason === "credentials_missing") {
+        lines.push("  1. Sign in so ~/.deeplake/credentials.json exists (the shared Deep Lake credentials).");
+        lines.push("  2. Enable Portkey so descriptions can be generated:");
+    }
+    else {
+        lines.push("  1. Enable Portkey so descriptions can be generated:");
+    }
+    lines.push("       export NECTAR_PORTKEY_ENABLED=1");
+    lines.push("       export NECTAR_PORTKEY_API_KEY=<your Portkey API key>");
+    lines.push("       export NECTAR_PORTKEY_CONFIG=<your Portkey config id>");
+    lines.push(`Missing now: ${status.missing.join(", ")}.`);
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=brood-prereqs.js.map

package/dist/brood-prereqs.js.map

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

package/dist/brooding/bucketing.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Bucketing + dynamic batch packing (PRD-007b) - stage 3 of the pipeline.
+ *
+ * Files that survive the pre-check are bucketed by size and parsability into the
+ * four buckets, carried verbatim from `brooding-pipeline.md`:
+ *
+ *   - skip-binary     NUL in first 8 KB, or a known-binary extension. No LLM call.
+ *   - skip-too-large  size_bytes > MAX_DESCRIBE_SIZE (256 KB). No LLM call.
+ *   - batch           text, size_bytes <= BATCH_FILE_SIZE (4 KB), cumulative <= 100 KB.
+ *   - solo            text, size_bytes > BATCH_FILE_SIZE but <= MAX_DESCRIBE_SIZE.
+ *
+ * The buckets are mutually exclusive and exhaustive. Batch packing is DYNAMIC
+ * (locked decision #22): files are packed until the estimated input-token budget
+ * is approached, capped by the 100 KB cumulative `BATCH_TOTAL_SIZE` and the
+ * max-files safety ceiling in the corpus's 30-50 band - it adapts to actual file
+ * sizes rather than counting a fixed number of files, and preserves the cost
+ * math (~40 files/call remains the representative average at ~2 KB/file).
+ */
+import { type BroodBucket } from "./constants.js";
+import type { PreparedFile } from "./precheck.js";
+/** Estimated input tokens for a byte count ("4 KB of source ~= 1K tokens"). */
+export declare function estimateTokens(sizeBytes: number): number;
+/**
+ * True when an extension is in the known-binary list, with NO dependence on
+ * file content or size. Exposed so {@link "./precheck.js" | precheck.ts} can
+ * short-circuit a known-binary file before reading any bytes (NEC-012 /
+ * AC-018e.5), the same predicate {@link classifyBucket} applies after prepare.
+ */
+export declare function isKnownBinaryExtension(ext: string): boolean;
+/**
+ * Classify one prepared file into exactly one bucket. Order: known-binary
+ * extension first (no size dependence), then too-large, then NUL-sniffed binary,
+ * then the batch/solo size split.
+ */
+export declare function classifyBucket(prepared: PreparedFile): BroodBucket;
+/** A packed batch call: the files it carries plus its cumulative byte + token estimate. */
+export interface BatchGroup {
+    readonly files: readonly PreparedFile[];
+    readonly totalBytes: number;
+    readonly estimatedTokens: number;
+}
+export interface PackBatchesOptions {
+    readonly maxFiles?: number;
+    readonly maxTotalBytes?: number;
+    readonly tokenBudget?: number;
+}
+/**
+ * Pack batch-eligible files into {@link BatchGroup}s with dynamic token-budget
+ * packing (decision #22). A file starts a new group when adding it to the
+ * current group would exceed the max-files ceiling, the cumulative byte cap, or
+ * the input-token budget. A single file always fits (a batch file is <= 4 KB).
+ */
+export declare function packBatches(batchFiles: readonly PreparedFile[], opts?: PackBatchesOptions): BatchGroup[];
+/** The full bucketing outcome for a set of survivors. */
+export interface BucketedFiles {
+    readonly skipBinary: readonly PreparedFile[];
+    readonly skipTooLarge: readonly PreparedFile[];
+    /** Batch-eligible files packed into dynamic groups. */
+    readonly batches: readonly BatchGroup[];
+    readonly soloFiles: readonly PreparedFile[];
+    /** Flat count of files in the batch bucket (across all groups). */
+    readonly batchFileCount: number;
+    /** Count of solo files. */
+    readonly soloFileCount: number;
+}
+/** Bucket survivors into the four buckets, packing the batch bucket dynamically. */
+export declare function bucketFiles(survivors: readonly PreparedFile[], opts?: PackBatchesOptions): BucketedFiles;
+//# sourceMappingURL=bucketing.d.ts.map

package/dist/brooding/bucketing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucketing.d.ts","sourceRoot":"","sources":["../../src/brooding/bucketing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAQL,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAMlE;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,SAAS,YAAY,EAAE,EACnC,IAAI,GAAE,kBAAuB,GAC5B,UAAU,EAAE,CAgCd;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAqCf"}

package/dist/brooding/bucketing.js

@@ -0,0 +1,122 @@
+/**
+ * Bucketing + dynamic batch packing (PRD-007b) - stage 3 of the pipeline.
+ *
+ * Files that survive the pre-check are bucketed by size and parsability into the
+ * four buckets, carried verbatim from `brooding-pipeline.md`:
+ *
+ *   - skip-binary     NUL in first 8 KB, or a known-binary extension. No LLM call.
+ *   - skip-too-large  size_bytes > MAX_DESCRIBE_SIZE (256 KB). No LLM call.
+ *   - batch           text, size_bytes <= BATCH_FILE_SIZE (4 KB), cumulative <= 100 KB.
+ *   - solo            text, size_bytes > BATCH_FILE_SIZE but <= MAX_DESCRIBE_SIZE.
+ *
+ * The buckets are mutually exclusive and exhaustive. Batch packing is DYNAMIC
+ * (locked decision #22): files are packed until the estimated input-token budget
+ * is approached, capped by the 100 KB cumulative `BATCH_TOTAL_SIZE` and the
+ * max-files safety ceiling in the corpus's 30-50 band - it adapts to actual file
+ * sizes rather than counting a fixed number of files, and preserves the cost
+ * math (~40 files/call remains the representative average at ~2 KB/file).
+ */
+import { BATCH_FILE_SIZE, BATCH_INPUT_TOKEN_BUDGET, BATCH_TOTAL_SIZE, BYTES_PER_TOKEN, KNOWN_BINARY_EXTENSIONS, MAX_BATCH_FILES, MAX_DESCRIBE_SIZE, } from "./constants.js";
+/** Estimated input tokens for a byte count ("4 KB of source ~= 1K tokens"). */
+export function estimateTokens(sizeBytes) {
+    return Math.ceil(sizeBytes / BYTES_PER_TOKEN);
+}
+/**
+ * True when an extension is in the known-binary list, with NO dependence on
+ * file content or size. Exposed so {@link "./precheck.js" | precheck.ts} can
+ * short-circuit a known-binary file before reading any bytes (NEC-012 /
+ * AC-018e.5), the same predicate {@link classifyBucket} applies after prepare.
+ */
+export function isKnownBinaryExtension(ext) {
+    return KNOWN_BINARY_EXTENSIONS.has(ext);
+}
+/**
+ * Classify one prepared file into exactly one bucket. Order: known-binary
+ * extension first (no size dependence), then too-large, then NUL-sniffed binary,
+ * then the batch/solo size split.
+ */
+export function classifyBucket(prepared) {
+    if (isKnownBinaryExtension(prepared.file.ext))
+        return "skip-binary";
+    if (prepared.file.sizeBytes > MAX_DESCRIBE_SIZE)
+        return "skip-too-large";
+    if (prepared.hasNulInSniff)
+        return "skip-binary";
+    if (prepared.file.sizeBytes <= BATCH_FILE_SIZE)
+        return "batch";
+    return "solo";
+}
+/**
+ * Pack batch-eligible files into {@link BatchGroup}s with dynamic token-budget
+ * packing (decision #22). A file starts a new group when adding it to the
+ * current group would exceed the max-files ceiling, the cumulative byte cap, or
+ * the input-token budget. A single file always fits (a batch file is <= 4 KB).
+ */
+export function packBatches(batchFiles, opts = {}) {
+    const maxFiles = opts.maxFiles ?? MAX_BATCH_FILES;
+    const maxTotalBytes = opts.maxTotalBytes ?? BATCH_TOTAL_SIZE;
+    const tokenBudget = opts.tokenBudget ?? BATCH_INPUT_TOKEN_BUDGET;
+    const groups = [];
+    let current = [];
+    let bytes = 0;
+    let tokens = 0;
+    const flush = () => {
+        if (current.length > 0) {
+            groups.push({ files: current, totalBytes: bytes, estimatedTokens: tokens });
+            current = [];
+            bytes = 0;
+            tokens = 0;
+        }
+    };
+    for (const f of batchFiles) {
+        const fileTokens = estimateTokens(f.file.sizeBytes);
+        const wouldExceed = current.length + 1 > maxFiles ||
+            bytes + f.file.sizeBytes > maxTotalBytes ||
+            tokens + fileTokens > tokenBudget;
+        if (current.length > 0 && wouldExceed)
+            flush();
+        current.push(f);
+        bytes += f.file.sizeBytes;
+        tokens += fileTokens;
+    }
+    flush();
+    return groups;
+}
+/** Bucket survivors into the four buckets, packing the batch bucket dynamically. */
+export function bucketFiles(survivors, opts = {}) {
+    const skipBinary = [];
+    const skipTooLarge = [];
+    const batchEligible = [];
+    const soloFiles = [];
+    for (const p of survivors) {
+        const bucket = classifyBucket(p);
+        switch (bucket) {
+            case "skip-binary":
+                skipBinary.push(p);
+                break;
+            case "skip-too-large":
+                skipTooLarge.push(p);
+                break;
+            case "batch":
+                batchEligible.push(p);
+                break;
+            case "solo":
+                soloFiles.push(p);
+                break;
+            default: {
+                const _exhaustive = bucket;
+                return _exhaustive;
+            }
+        }
+    }
+    const batches = packBatches(batchEligible, opts);
+    return {
+        skipBinary,
+        skipTooLarge,
+        batches,
+        soloFiles,
+        batchFileCount: batchEligible.length,
+        soloFileCount: soloFiles.length,
+    };
+}
+//# sourceMappingURL=bucketing.js.map

package/dist/brooding/bucketing.js.map

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

package/dist/brooding/cli.d.ts

@@ -0,0 +1,78 @@
+import type { Tenancy } from "../hive-graph/model.js";
+import type { AsyncHiveGraphStore, HiveGraphStore } from "../hive-graph/store.js";
+import type { BroodRunOptions } from "./pipeline.js";
+import type { BroodCostEstimate } from "./cost.js";
+import type { DiscoverySource } from "./discovery.js";
+/** The parsed `brood` flags plus any parse errors. */
+export interface ParsedBroodArgs {
+    readonly options: BroodRunOptions;
+    /** Non-empty when a flag was malformed (e.g. `--limit abc`); the caller should reject. */
+    readonly errors: readonly string[];
+}
+/**
+ * Parse the `brood` verb's flags. Recognizes `--force`, `--dry-run`,
+ * `--limit N` (and `--limit=N`), and `--model <new>` (and `--model=<new>`).
+ * Unknown flags and malformed values are reported in `errors`.
+ */
+export declare function parseBroodArgs(argv: readonly string[]): ParsedBroodArgs;
+/** Inputs the automatic-trigger decision needs (checked at startup / registration). */
+export interface AutoBroodCheck {
+    /** Whether the project already has any `hive_graph` rows. */
+    readonly hasHiveGraphRows: boolean;
+    /** Whether `.honeycomb/nectars.json` exists for the project. */
+    readonly hasProjection: boolean;
+}
+/**
+ * The automatic trigger (PRD-007d): brooding runs the first time hiveantennae
+ * runs against a project with NO `hive_graph` rows OR NO `.honeycomb/nectars.json`.
+ * The daemon must run this in the background (it does not block readiness).
+ */
+export declare function shouldAutoBrood(check: AutoBroodCheck): boolean;
+/** Build the {@link AutoBroodCheck} from the store + project root (a startup helper). */
+export declare function evaluateAutoBrood(store: HiveGraphStore, tenancy: Tenancy, root: string): AutoBroodCheck;
+/**
+ * The async twin of {@link evaluateAutoBrood} for the durable
+ * {@link AsyncHiveGraphStore} (Deep Lake). Reads whether the project has any
+ * hive_graph rows over the async store and whether the projection exists on
+ * disk. The daemon's durable auto-brood path uses this so a real daemon with
+ * Deep Lake credentials evaluates the trigger against the durable substrate.
+ */
+export declare function evaluateAutoBroodAsync(store: AsyncHiveGraphStore, tenancy: Tenancy, root: string): Promise<AutoBroodCheck>;
+/** The fields a dry-run preview prints (a subset shared by plan + result). */
+export interface DryRunPreviewInput {
+    readonly discoveredCount: number;
+    readonly inheritedCount: number;
+    readonly skipBinaryCount: number;
+    readonly skipTooLargeCount: number;
+    readonly batchFileCount: number;
+    readonly soloFileCount: number;
+    readonly batchCalls: number;
+    readonly soloCalls: number;
+    readonly estimate: BroodCostEstimate;
+    /**
+     * PRD-018c AC-018c.11: how discovery produced the candidate set ("git" or
+     * "walk"). Optional so existing callers that predate this field keep
+     * compiling; `formatDryRunReport` simply omits the line when absent.
+     */
+    readonly source?: DiscoverySource;
+    /**
+     * PRD-018c NEC-039 / AC-018c.10/11: set when `source` is "walk" because git
+     * was PRESENT but ERRORED - the loud counterpart to the silent walk that
+     * runs when git is simply absent (which leaves this undefined).
+     */
+    readonly degraded?: {
+        readonly reason: string;
+    };
+}
+/**
+ * Format the `--dry-run` cost preview (PRD-007d). Prints the bucket counts, the
+ * estimated call count, and the estimated cost for THIS project, derived from
+ * the 007b per-bucket economics applied to the actual discovery.
+ *
+ * PRD-018c AC-018c.11: also prints the discovery source (git or walk) and,
+ * when discovery degraded to the walk because git errored (never when git is
+ * simply absent), the reason - so a user can tell the degradation happened
+ * instead of only noticing an inflated brood cost.
+ */
+export declare function formatDryRunReport(input: DryRunPreviewInput): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/brooding/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/brooding/cli.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGlF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AASD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAwDvE;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAIvG;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAIzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAoBpE"}

package/dist/brooding/cli.js

@@ -0,0 +1,140 @@
+/**
+ * The `brood` CLI surface (PRD-007d).
+ *
+ * Owns the BROOD-verb behavior: flag parsing (`--force`, `--limit N`,
+ * `--dry-run`, `--model <new>`), the two triggering paths (automatic on a fresh
+ * project vs explicit invocation), and the `--dry-run` cost-preview formatting.
+ * The CLI INVOCATION dispatch (the `nectar` binary, loopback thin-client) is
+ * owned by PRD-002c; this module is the pure verb logic the orchestrator wires.
+ */
+import { existsSync } from "node:fs";
+import { DEFAULT_PROJECTION_REL_PATH } from "../projection/format.js";
+import { projectionFinalPath } from "../projection/write.js";
+function takeValue(argv, i, inlineValue) {
+    if (inlineValue !== undefined)
+        return { value: inlineValue, next: i };
+    const nextArg = argv[i + 1];
+    if (nextArg === undefined || nextArg.startsWith("-"))
+        return { value: undefined, next: i };
+    return { value: nextArg, next: i + 1 };
+}
+/**
+ * Parse the `brood` verb's flags. Recognizes `--force`, `--dry-run`,
+ * `--limit N` (and `--limit=N`), and `--model <new>` (and `--model=<new>`).
+ * Unknown flags and malformed values are reported in `errors`.
+ */
+export function parseBroodArgs(argv) {
+    let force = false;
+    let dryRun = false;
+    let limit;
+    let model;
+    const errors = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const eq = arg.indexOf("=");
+        const flag = eq === -1 ? arg : arg.slice(0, eq);
+        const inline = eq === -1 ? undefined : arg.slice(eq + 1);
+        switch (flag) {
+            case "--force":
+                force = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--limit": {
+                const { value, next } = takeValue(argv, i, inline);
+                i = next;
+                if (value === undefined) {
+                    errors.push("--limit requires a non-negative integer");
+                    break;
+                }
+                const n = Number.parseInt(value, 10);
+                if (!Number.isInteger(n) || n < 0 || String(n) !== value.trim()) {
+                    errors.push(`--limit expects a non-negative integer, got ${JSON.stringify(value)}`);
+                    break;
+                }
+                limit = n;
+                break;
+            }
+            case "--model": {
+                const { value, next } = takeValue(argv, i, inline);
+                i = next;
+                if (value === undefined || value.trim() === "") {
+                    errors.push("--model requires a model id");
+                    break;
+                }
+                model = value;
+                break;
+            }
+            default:
+                errors.push(`unknown brood flag: ${flag}`);
+                break;
+        }
+    }
+    const options = { force, dryRun };
+    return {
+        options: { ...options, ...(limit !== undefined ? { limit } : {}), ...(model !== undefined ? { model } : {}) },
+        errors,
+    };
+}
+/**
+ * The automatic trigger (PRD-007d): brooding runs the first time hiveantennae
+ * runs against a project with NO `hive_graph` rows OR NO `.honeycomb/nectars.json`.
+ * The daemon must run this in the background (it does not block readiness).
+ */
+export function shouldAutoBrood(check) {
+    return !check.hasHiveGraphRows || !check.hasProjection;
+}
+/** Build the {@link AutoBroodCheck} from the store + project root (a startup helper). */
+export function evaluateAutoBrood(store, tenancy, root) {
+    const hasHiveGraphRows = store.listLatestVersions(tenancy).length > 0;
+    const hasProjection = existsSync(projectionFinalPath(root, DEFAULT_PROJECTION_REL_PATH));
+    return { hasHiveGraphRows, hasProjection };
+}
+/**
+ * The async twin of {@link evaluateAutoBrood} for the durable
+ * {@link AsyncHiveGraphStore} (Deep Lake). Reads whether the project has any
+ * hive_graph rows over the async store and whether the projection exists on
+ * disk. The daemon's durable auto-brood path uses this so a real daemon with
+ * Deep Lake credentials evaluates the trigger against the durable substrate.
+ */
+export async function evaluateAutoBroodAsync(store, tenancy, root) {
+    const hasHiveGraphRows = (await store.listLatestVersions(tenancy)).length > 0;
+    const hasProjection = existsSync(projectionFinalPath(root, DEFAULT_PROJECTION_REL_PATH));
+    return { hasHiveGraphRows, hasProjection };
+}
+function usd(n) {
+    return `$${n.toFixed(2)}`;
+}
+/**
+ * Format the `--dry-run` cost preview (PRD-007d). Prints the bucket counts, the
+ * estimated call count, and the estimated cost for THIS project, derived from
+ * the 007b per-bucket economics applied to the actual discovery.
+ *
+ * PRD-018c AC-018c.11: also prints the discovery source (git or walk) and,
+ * when discovery degraded to the walk because git errored (never when git is
+ * simply absent), the reason - so a user can tell the degradation happened
+ * instead of only noticing an inflated brood cost.
+ */
+export function formatDryRunReport(input) {
+    const e = input.estimate;
+    const lines = [
+        "brood --dry-run (no LLM calls made)",
+        ...(input.source !== undefined ? [`  discovery source:  ${input.source}`] : []),
+        ...(input.degraded !== undefined
+            ? [`  discovery DEGRADED: git ls-files failed, fell back to a manual walk (${input.degraded.reason})`]
+            : []),
+        `  discovered:        ${input.discoveredCount}`,
+        `  inherited ($0):    ${input.inheritedCount}`,
+        "  buckets:",
+        `    skip-binary:     ${input.skipBinaryCount}`,
+        `    skip-too-large:  ${input.skipTooLargeCount}`,
+        `    batch files:     ${input.batchFileCount} (${input.batchCalls} calls)`,
+        `    solo files:      ${input.soloFileCount} (${input.soloCalls} calls)`,
+        `  estimated calls:   ${e.totalCalls}`,
+        `  estimated input:   ${e.inputTokens} tokens`,
+        `  estimated cost:    ${usd(e.totalUsd)} (input ${usd(e.inputUsd)} + output ${usd(e.outputUsd)}, embedding ${usd(e.embeddingUsd)})`,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=cli.js.map

package/dist/brooding/cli.js.map

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