@legioncodeinc/nectar 0.0.1

package/dist/hivedoctor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hivedoctor-registry.d.ts","sourceRoot":"","sources":["../src/hivedoctor-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,EAAG,YAAqB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,0EAA0E;AAC1E,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,EAC5D,SAAS,GAAE,OAAO,CAChB,IAAI,CACF,uBAAuB,EACvB,iBAAiB,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,mBAAmB,GAAG,iBAAiB,CAC1G,CACG,GACL,uBAAuB,CAYzB;AA0DD,MAAM,WAAW,6BAA6B;IAC5C,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;IACtE,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAC1B,IAAI,CACF,uBAAuB,EACvB,iBAAiB,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,mBAAmB,GAAG,iBAAiB,CAC1G,CACF,CAAC;CACH;AAED,MAAM,WAAW,4BAA4B;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAa9B"}

package/dist/hivedoctor-registry.js

@@ -0,0 +1,143 @@
+/**
+ * hivenectar's registry entry in hivedoctor's daemon registry (PRD-003c).
+ *
+ * hivenectar becomes a supervised daemon by appending ONE entry to hivedoctor's
+ * registry file (`~/.honeycomb/hivedoctor.daemons.json`, the schema PRD-004a
+ * specifies, mirrored read-side in `hivedoctor/src/registry.ts`). That entry
+ * carries hivenectar's `healthUrl`, `pidPath`, `probeIntervalMs`, `startupGraceMs`,
+ * and restart thresholds. At the next hivedoctor boot, hivedoctor reads the
+ * registry and spawns one supervisor instance for hivenectar alongside honeycomb
+ * and thehive.
+ *
+ * Registration is a FILE EDIT at install time (PRD-003c "Registration mechanics"),
+ * never a runtime call: this module does not restart hivedoctor, does not open an
+ * HTTP connection, and does not hot-reload anything. It is idempotent - re-running
+ * the installer replaces hivenectar's own entry (keyed by `name: "hivenectar"`)
+ * rather than appending a duplicate, and every other daemon's entry is preserved
+ * byte-for-byte apart from array position.
+ *
+ * A PRESENT-but-malformed registry file fails loudly (this module never silently
+ * clobbers a broken file it cannot safely parse), mirroring hivedoctor's own
+ * fail-loud posture for a malformed registry (`hivedoctor/src/registry.ts`).
+ * PRD-017a deliberately does NOT change this posture to match hivedoctor's own
+ * fail-soft posture for a malformed registry read - the two are intentionally
+ * different (this writer refuses to clobber a broken install-time file; a
+ * malformed registry read is hivedoctor's own runtime concern, not this one).
+ *
+ * PRD-017a extends this entry with `telemetryDbPath`: the absolute path to
+ * hivenectar's runtime telemetry SQLite database (`telemetry/db.ts`,
+ * `~/.honeycomb/telemetry/hivenectar.sqlite` by default), per hivedoctor's
+ * `ADR-0002-service-registration-static-registry-plus-runtime-sqlite.md`. It is
+ * derived from `config.pidFilePath`'s directory (the same resolved runtime dir
+ * `healthUrl`/`pidPath` already come from), so a test-overridden runtime dir
+ * (`HIVENECTAR_RUNTIME_DIR` / `resolveConfig({ runtimeDir })`) keeps every
+ * per-daemon artifact - pid, lock, and now telemetry DB - colocated, with no
+ * separate `~` round-trip needed here (same rationale as `healthUrl`/`pidPath`).
+ *
+ * Built-ins only: node:fs, node:os, node:path.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { TELEMETRY_DB_FILE_NAME, TELEMETRY_DIR_NAME } from "./telemetry/db.js";
+/** The daemon name hivenectar registers itself under. */
+export const HIVENECTAR_DAEMON_NAME = "hivenectar";
+/** hivedoctor's per-daemon defaults hivenectar's entry resolves to (PRD-003c table). */
+export const DEFAULT_PROBE_INTERVAL_MS = 30_000;
+export const DEFAULT_STARTUP_GRACE_MS = 60_000;
+export const DEFAULT_RESTART_GIVE_UP_THRESHOLD = 3;
+export const DEFAULT_RESTART_COOLDOWN_MS = 5_000;
+/** Thrown when a PRESENT registry file cannot be safely parsed/edited. */
+export class HivedoctorRegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HivedoctorRegistryError";
+    }
+}
+/** The default registry file location, alongside the other `~/.honeycomb` artifacts. */
+export function defaultHivedoctorRegistryPath(home = homedir()) {
+    return join(home, ".honeycomb", "hivedoctor.daemons.json");
+}
+/**
+ * Build hivenectar's registry entry from its resolved {@link RuntimeConfig}
+ * (PRD-003c table): `healthUrl`/`pidPath` come from hivenectar's own runtime
+ * config (already home-expanded, so no `~` round-trip is needed here); the
+ * remaining fields are hivedoctor's per-daemon defaults unless overridden.
+ *
+ * `telemetryDbPath` (PRD-017a) defaults to `<runtimeDir>/telemetry/hivenectar.sqlite`,
+ * where `runtimeDir` is `pidFilePath`'s own directory - the same resolved
+ * runtime dir every other per-daemon artifact already lives under, so a
+ * test-overridden runtime dir keeps pid/lock/telemetry colocated automatically.
+ */
+export function buildHivenectarRegistryEntry(config, overrides = {}) {
+    const runtimeDir = dirname(config.pidFilePath);
+    return {
+        name: HIVENECTAR_DAEMON_NAME,
+        healthUrl: `http://${config.host}:${config.port}/health`,
+        pidPath: config.pidFilePath,
+        probeIntervalMs: overrides.probeIntervalMs ?? DEFAULT_PROBE_INTERVAL_MS,
+        startupGraceMs: overrides.startupGraceMs ?? DEFAULT_STARTUP_GRACE_MS,
+        restartGiveUpThreshold: overrides.restartGiveUpThreshold ?? DEFAULT_RESTART_GIVE_UP_THRESHOLD,
+        restartCooldownMs: overrides.restartCooldownMs ?? DEFAULT_RESTART_COOLDOWN_MS,
+        telemetryDbPath: overrides.telemetryDbPath ?? join(runtimeDir, TELEMETRY_DIR_NAME, TELEMETRY_DB_FILE_NAME),
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+/**
+ * Read the registry file's raw `daemons` array. A PRESENT-but-malformed file
+ * (unparseable JSON, not an object, or a `daemons` field that is not an array)
+ * throws {@link HivedoctorRegistryError} rather than being silently overwritten -
+ * a real misconfiguration must not be clobbered by an installer.
+ */
+function readExistingRegistry(registryPath) {
+    let contents;
+    try {
+        contents = readFileSync(registryPath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { fileExisted: false, daemons: [] };
+        throw new HivedoctorRegistryError(`could not read the hivedoctor registry at ${registryPath}: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch (error) {
+        throw new HivedoctorRegistryError(`the hivedoctor registry at ${registryPath} is not valid JSON: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new HivedoctorRegistryError(`the hivedoctor registry at ${registryPath} must be a JSON object with a "daemons" array`);
+    }
+    const daemons = parsed.daemons;
+    if (daemons === undefined)
+        return { fileExisted: true, daemons: [] };
+    if (!Array.isArray(daemons)) {
+        throw new HivedoctorRegistryError(`the hivedoctor registry at ${registryPath} has a non-array "daemons" field`);
+    }
+    return { fileExisted: true, daemons };
+}
+/** True iff a raw (unvalidated) registry entry names hivenectar. */
+function isHivenectarEntry(raw) {
+    return isRecord(raw) && raw.name === HIVENECTAR_DAEMON_NAME;
+}
+/**
+ * Append (or idempotently replace) hivenectar's entry in hivedoctor's registry
+ * file (PRD-003c US-003c.1). Every OTHER daemon's entry is preserved unchanged.
+ * Does NOT restart hivedoctor and does NOT touch anything besides this one file -
+ * the entry takes effect at hivedoctor's next natural boot (PRD-003c Non-Goals).
+ */
+export function registerWithHivedoctor(options) {
+    const registryPath = options.registryPath ?? defaultHivedoctorRegistryPath();
+    const entry = buildHivenectarRegistryEntry(options.config, options.overrides);
+    const { fileExisted, daemons: existing } = readExistingRegistry(registryPath);
+    const replaced = existing.some(isHivenectarEntry);
+    const kept = existing.filter((raw) => !isHivenectarEntry(raw));
+    const daemons = [...kept, entry];
+    mkdirSync(dirname(registryPath), { recursive: true });
+    writeFileSync(registryPath, `${JSON.stringify({ daemons }, null, 2)}\n`, "utf8");
+    return { registryPath, entry, created: !fileExisted, replaced };
+}
+//# sourceMappingURL=hivedoctor-registry.js.map

package/dist/hivedoctor-registry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Public entry point for @legioncodeinc/nectar.
+ *
+ * Re-exports the daemon composition root and its building blocks so the package
+ * can be embedded (tests, hive aggregation, future SDK) without going through
+ * the CLI. The CLI (`nectar daemon`) is the operator-facing surface;
+ * `assembleDaemon` is the programmatic one.
+ */
+export { assembleDaemon } from "./daemon.js";
+export type { AssembleOptions, AssembledDaemon, RegistrationPipeline } from "./daemon.js";
+export { resolveConfig, DEFAULT_HOST, DEFAULT_PORT, DEFAULT_POLL_INTERVAL_MS, DEFAULT_PID_FILE_NAME, DEFAULT_LOCK_FILE_NAME, RUNTIME_DIR_NAME, } from "./config.js";
+export type { RuntimeConfig, RuntimeConfigOverrides } from "./config.js";
+export { acquireSingleInstanceLock, releaseSingleInstanceLock, isPidAlive, readPidFile, isLockHeldByLiveDaemon, } from "./lock.js";
+export type { LockPaths } from "./lock.js";
+export { HealthState, healthHttpStatus } from "./health.js";
+export type { HealthBody, PipelineStatus } from "./health.js";
+export { PollLoop, realTimer } from "./poll-loop.js";
+export type { PollLoopOptions, Tick, Timer } from "./poll-loop.js";
+export { HiveantennaeWorker, emptyJobSource } from "./worker.js";
+export type { Job, JobHandler, JobKind, JobSource, WorkerOptions } from "./worker.js";
+export { createHttpServer } from "./server.js";
+export type { HttpServer } from "./server.js";
+export { DaemonAlreadyRunningError } from "./errors.js";
+export { NectarRouter, ROUTE_GROUPS, HIVE_GRAPH_GROUP, MAX_REQUEST_BODY_BYTES, allowAllPermission, notImplementedScaffold, buildRouteContext, BodyTooLargeError, } from "./api/router.js";
+export type { RouteGroup, RouteGroupSpec, RouteContext, RouteResponse, RouteHandler, PermissionGate, PermissionRejection, } from "./api/router.js";
+export { mountHiveGraphApi, NO_ORG_BODY, parseSearchRequest, parseBuildRequest } from "./api/hive-graph-api.js";
+export type { MountHiveGraphOptions, RouteGroupProvider, BuildArgs, ProjectionRebuildResult, } from "./api/hive-graph-api.js";
+export { readHiveGraphStatusOverStorage, buildDescribeStatusCountSql, buildQueueDepthSql, emptyDescribeStatusCounts, parseDescribeStatusCounts, } from "./api/status-query.js";
+export type { HiveGraphStatus, DescribeStatusCounts, ReadHiveGraphStatusOptions } from "./api/status-query.js";
+export { searchViaDaemon, DaemonUnreachableError, DaemonSearchError } from "./api/loopback-client.js";
+export type { LoopbackSearchOptions } from "./api/loopback-client.js";
+export type { Tenancy, NectarKind, DescribeStatus, HiveGraphRow, HiveGraphVersionRow, } from "./hive-graph/model.js";
+export { DESCRIBE_STATUSES, EMBED_DIMS, isValidEmbedding, inTenancy } from "./hive-graph/model.js";
+export type { HiveGraphStore, AsyncHiveGraphStore, LatestVersion } from "./hive-graph/store.js";
+export { InMemoryHiveGraphStore } from "./hive-graph/memory-store.js";
+export { mintNectar, nectarCreatedAt, nectarTimestampMs, isValidNectar } from "./hive-graph/ulid.js";
+export { sha256Hex } from "./hive-graph/hash.js";
+export { toRepoRelative, filenameOf, extOf } from "./hive-graph/paths.js";
+export type { ColumnDef, CatalogTable, SqlType } from "./hive-graph/schema.js";
+export { HIVE_GRAPH_TABLE, HIVE_GRAPH_VERSIONS_TABLE, HIVE_GRAPH_CATALOG_GROUP, HIVE_GRAPH_COLUMNS, HIVE_GRAPH_VERSIONS_COLUMNS, assertValidCatalogTable, buildCreateTableSql, } from "./hive-graph/schema.js";
+export type { TransportErrorKind, DeepLakeRow, DeepLakeTransportConfig } from "./hive-graph/deeplake-transport.js";
+export { TransportError, HttpDeepLakeTransport, DEFAULT_TRANSPORT_TIMEOUT_MS, DEEPLAKE_CLIENT_HEADER, DEEPLAKE_ORG_HEADER, } from "./hive-graph/deeplake-transport.js";
+export type { DeepLakeCredentials, LoadCredentialsOptions } from "./hive-graph/deeplake-credentials.js";
+export { loadDeepLakeCredentials, DeepLakeCredentialsError, redactToken, credentialsDir, credentialsPath, DEFAULT_DEEPLAKE_API_URL, } from "./hive-graph/deeplake-credentials.js";
+export { withHeal, isMissingTableError } from "./hive-graph/deeplake-heal.js";
+export type { QueryRunner } from "./hive-graph/deeplake-heal.js";
+export { sqlStr, sqlLike, sqlIdent, sLiteral, eLiteral, sqlFloat4Array, sqlNum } from "./hive-graph/sql-guards.js";
+export { DeepLakeHiveGraphStore } from "./hive-graph/deeplake-store.js";
+export type { DeepLakeHiveGraphStoreOptions } from "./hive-graph/deeplake-store.js";
+export { WatchIntake, DEFAULT_DEBOUNCE_MS } from "./registration/fs-watch.js";
+export type { WatchIntakeOptions } from "./registration/fs-watch.js";
+export { classifyPath } from "./registration/classify.js";
+export type { PathObservation, LadderInput, LadderInputKind } from "./registration/classify.js";
+export { classifyNewFile } from "./registration/copy-detect.js";
+export type { NewFileDecision } from "./registration/copy-detect.js";
+export { reassociate, carryNectar } from "./registration/ladder.js";
+export type { ObservedFile, FuzzyStep, FuzzyOutcome, FuzzyCandidate, ReviewCandidate, LadderDeps, LadderResult, LadderStep, LadderAction, } from "./registration/ladder.js";
+export { createDefaultIgnore, loadIgnorePrefixes, ALWAYS_IGNORED_SEGMENTS, GRAPH_IGNORE_FILE, } from "./registration/ignore.js";
+export type { IgnorePredicate } from "./registration/ignore.js";
+export { computeFingerprint, fingerprintDistance, distanceToConfidence, createTlshFuzzyStep, DEFAULT_TUNABLE_FUZZY_CONFIG, MAX_DISTANCE, SIZE_BUCKET_TOLERANCE, FINGERPRINT_PREFIX, } from "./registration/tlsh.js";
+export type { FuzzyConfig } from "./registration/tlsh.js";
+export { RegistrationService } from "./registration/service.js";
+export type { RegistrationServiceOptions, RegistrationFs, StatResult } from "./registration/service.js";
+export { StoreBridge } from "./registration/store-bridge.js";
+export type { StoreBridgeOptions, DurableWriteOp } from "./registration/store-bridge.js";
+export { createDiskRegistrationFs } from "./registration/disk-fs.js";
+export { isSafeRelPath, containedPath, realpathContained } from "./registration/paths-safe.js";
+export { InMemoryPendingReviewStore, FilePendingReviewStore, } from "./registration/review-store.js";
+export type { PendingReviewStore, PendingReviewCandidate } from "./registration/review-store.js";
+export { runReviewMatches } from "./registration/review-cli.js";
+export type { ReviewMatchesDeps, ReviewMatchesResult, ReviewDecision } from "./registration/review-cli.js";
+export { runPrune, findPruneCandidates, PRUNE_GRACE_MS } from "./registration/prune-cli.js";
+export type { PruneDeps, PruneCandidate, PruneResult } from "./registration/prune-cli.js";
+export { resolveServicePlan, resolveServiceContext, SERVICE_LABEL, SYSTEMD_UNIT_NAME, WINDOWS_TASK_NAME, NECTAR_RUN_COMMAND, RESTART_SEC, WINDOWS_RESTART_INTERVAL, renderUnit, installCommands, uninstallCommands, statusCommand, createExecFileRunner, createServiceModule, createNodeServiceFs, serviceStatus, } from "./service/index.js";
+export type { ServicePlan, ServiceEnvironment, ServiceCommand, CommandRunner, CommandResult, CommandRunOptions, ServiceModule, ServiceModuleDeps, ServiceResult, ServiceStatus, ServiceFs, } from "./service/index.js";
+export { resolveProjectScope, loadProjectsCache, emptyProjectsCache, canonicalizeRemote, readGitRemoteSignal, originUrlFromConfig, projectsCacheDir, projectsCachePath, ENV_PROJECT_ID, DETECTED_HONEYCOMB_PROJECT_ID, UNSORTED_PROJECT_ID, PROJECTS_CACHE_FILE_NAME, PROJECTS_CACHE_SCHEMA_VERSION, } from "./hive-graph/project-scope.js";
+export type { ResolvedProjectScope, ProjectScopeSource, ResolveProjectScopeOptions, ProjectsCache, FolderBinding, CachedProject, } from "./hive-graph/project-scope.js";
+export { createTelemetry, createNullTelemetry, wrapStoreWithMetrics, createLogTap, redactLogMessage, levelFromLine, messageFromLine, defaultTelemetryDbPath, telemetryDbPathForRuntimeDir, TELEMETRY_DIR_NAME, TELEMETRY_DB_FILE_NAME, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOG_MAX_AGE_MS, MAX_LOG_MESSAGE_LENGTH, LOG_LEVELS, CheckinService, CheckinWriter, MetricsWriter, LogWriter, } from "./telemetry/index.js";
+export type { Telemetry, CreateTelemetryOptions, StartCheckinOptions, StopHeartbeat, MetricsSnapshot, PipelineMetricsSink, LogLevel, LogSink, SqliteDatabaseLike, } from "./telemetry/index.js";
+export { NECTAR_DAEMON_NAME, DEFAULT_PROBE_INTERVAL_MS, DEFAULT_STARTUP_GRACE_MS, DEFAULT_RESTART_GIVE_UP_THRESHOLD, DEFAULT_RESTART_COOLDOWN_MS, DoctorRegistryError, defaultDoctorRegistryPath, buildNectarRegistryEntry, registerWithDoctor, } from "./doctor-registry.js";
+export type { DoctorRegistryEntry, RegisterWithDoctorOptions, RegisterWithDoctorResult, } from "./doctor-registry.js";
+export { PORTKEY_BASE_URL, PORTKEY_CHAT_COMPLETIONS_URL, PORTKEY_EMBEDDINGS_URL, PORTKEY_API_KEY_HEADER, PORTKEY_CONFIG_HEADER, buildPortkeyHeaders, } from "./portkey/headers.js";
+export { resolvePortkeyConfig, DEFAULT_ACTIVE_MODEL, PORTKEY_CONFIG_SURFACE_KEYS } from "./portkey/config.js";
+export type { PortkeyRuntimeConfig, PortkeyEnabled, PortkeyDisabled, PortkeyConfigOverrides, } from "./portkey/config.js";
+export { describeViaPortkey, PortkeyTransportError, PORTKEY_DEFAULT_MAX_TOKENS, PORTKEY_RETRYABLE_STATUSES, PORTKEY_MAX_ATTEMPTS, PORTKEY_RETRY_BACKOFF_MS, PORTKEY_REQUEST_TIMEOUT_MS, } from "./portkey/transport.js";
+export type { ChatMessage, PortkeyUsage, DescribeViaPortkeyResult, DescribeViaPortkeyRequest, DescribeViaPortkeyDeps, PortkeyFetch, } from "./portkey/transport.js";
+export { buildDescribeModelStamp, resetForRedescribe, applyDescribeModelStamp, isSkippedDescribeStatus, SKIPPED_DESCRIBE_STATUSES, } from "./portkey/describe-model.js";
+export type { DescriptionPayload, DescribeModelStamp, RedescribeRow, RedescribeReset, } from "./portkey/describe-model.js";
+export { PROJECTION_SCHEMA_VERSION, DEFAULT_PROJECTION_REL_PATH, DEFAULT_GENERATOR, isValidContentHash, parseProjectionJson, canonicalSerialize, canonicalSerializeExceptGeneratedAt, } from "./projection/format.js";
+export type { PortableProjection, ProjectionProject, ProjectionFileEntry, ProjectionDerivedEntry, } from "./projection/format.js";
+export { buildProjection, buildProjectionFromStore, buildProjectionFromAsyncStore, } from "./projection/generate.js";
+export type { BuildProjectionOptions, BuildProjectionFromStoreOptions } from "./projection/generate.js";
+export { collectProjectionSources, collectProjectionSourcesAsync } from "./projection/store-adapter.js";
+export type { ProjectionNectarSource, CollectProjectionSourcesOptions } from "./projection/store-adapter.js";
+export { ProjectionWriter, writeProjectionAtomic, projectionFinalPath, rebuildProjection, rebuildProjectionAsync, DEFAULT_WRITE_DEBOUNCE_MS, } from "./projection/write.js";
+export type { WriteProjectionOptions, ProjectionWriterOptions, RebuildProjectionOptions, RebuildProjectionAsyncOptions, } from "./projection/write.js";
+export { loadProjection, loadProjectionFromFile, validateProjection, buildContentHashIndex, MAX_PROJECTION_FILE_BYTES, } from "./projection/load.js";
+export type { LoadIgnoreReason, LoadProjectionResult, LoadProjectionFromFileOptions, } from "./projection/load.js";
+export { inheritFromProjection } from "./projection/inherit.js";
+export type { DiskHashMap, InheritRow, InheritSummary, InheritFromProjectionOptions, } from "./projection/inherit.js";
+export { resolveEmbeddingsConfig, normalizeSelector, resolveEmbedProvider, createOffProvider, DEFAULT_EMBED_PROVIDER, withDimGuard, guardVector, stderrDimRejectionSink, createLocalNomicHttpTransport, createLocalNomicProvider, createHostedPortkeyProvider, parseEmbeddingsResponse, DEFAULT_LOCAL_EMBED_HOST, DEFAULT_LOCAL_EMBED_PORT, DEFAULT_LOCAL_EMBED_TIMEOUT_MS, DEFAULT_HOSTED_EMBED_MODEL, DEFAULT_HOSTED_OUTPUT_DIMENSION, DEFAULT_HOSTED_MAX_ATTEMPTS, DEFAULT_HOSTED_RETRY_BACKOFF_MS, DEFAULT_HOSTED_REQUEST_TIMEOUT_MS, HOSTED_RETRYABLE_STATUSES, defaultFetch, defaultSleep, } from "./embeddings/index.js";
+export type { EmbedProvider, EmbedProviderSelector, ResolveEmbedProviderDeps, ResolvedEmbeddingsConfig, EmbeddingsConfigOverrides, DimRejection, DimRejectionSink, LocalNomicConfig, LocalNomicTransport, LocalNomicHttpDeps, HostedEmbeddingsConfig, HostedPortkeyDeps, FetchLike, FetchResponseLike, SleepFn, } from "./embeddings/index.js";
+export * as brooding from "./brooding/index.js";
+export * as enricher from "./enricher/index.js";
+export * as search from "./hive-graph/search.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,78 @@
+/**
+ * Public entry point for @legioncodeinc/nectar.
+ *
+ * Re-exports the daemon composition root and its building blocks so the package
+ * can be embedded (tests, hive aggregation, future SDK) without going through
+ * the CLI. The CLI (`nectar daemon`) is the operator-facing surface;
+ * `assembleDaemon` is the programmatic one.
+ */
+export { assembleDaemon } from "./daemon.js";
+export { resolveConfig, DEFAULT_HOST, DEFAULT_PORT, DEFAULT_POLL_INTERVAL_MS, DEFAULT_PID_FILE_NAME, DEFAULT_LOCK_FILE_NAME, RUNTIME_DIR_NAME, } from "./config.js";
+export { acquireSingleInstanceLock, releaseSingleInstanceLock, isPidAlive, readPidFile, isLockHeldByLiveDaemon, } from "./lock.js";
+export { HealthState, healthHttpStatus } from "./health.js";
+export { PollLoop, realTimer } from "./poll-loop.js";
+export { HiveantennaeWorker, emptyJobSource } from "./worker.js";
+export { createHttpServer } from "./server.js";
+export { DaemonAlreadyRunningError } from "./errors.js";
+// PRD-008: the /api/hive-graph route-group seam + handler-attachment module.
+export { NectarRouter, ROUTE_GROUPS, HIVE_GRAPH_GROUP, MAX_REQUEST_BODY_BYTES, allowAllPermission, notImplementedScaffold, buildRouteContext, BodyTooLargeError, } from "./api/router.js";
+export { mountHiveGraphApi, NO_ORG_BODY, parseSearchRequest, parseBuildRequest } from "./api/hive-graph-api.js";
+export { readHiveGraphStatusOverStorage, buildDescribeStatusCountSql, buildQueueDepthSql, emptyDescribeStatusCounts, parseDescribeStatusCounts, } from "./api/status-query.js";
+export { searchViaDaemon, DaemonUnreachableError, DaemonSearchError } from "./api/loopback-client.js";
+export { DESCRIBE_STATUSES, EMBED_DIMS, isValidEmbedding, inTenancy } from "./hive-graph/model.js";
+export { InMemoryHiveGraphStore } from "./hive-graph/memory-store.js";
+export { mintNectar, nectarCreatedAt, nectarTimestampMs, isValidNectar } from "./hive-graph/ulid.js";
+export { sha256Hex } from "./hive-graph/hash.js";
+export { toRepoRelative, filenameOf, extOf } from "./hive-graph/paths.js";
+export { HIVE_GRAPH_TABLE, HIVE_GRAPH_VERSIONS_TABLE, HIVE_GRAPH_CATALOG_GROUP, HIVE_GRAPH_COLUMNS, HIVE_GRAPH_VERSIONS_COLUMNS, assertValidCatalogTable, buildCreateTableSql, } from "./hive-graph/schema.js";
+export { TransportError, HttpDeepLakeTransport, DEFAULT_TRANSPORT_TIMEOUT_MS, DEEPLAKE_CLIENT_HEADER, DEEPLAKE_ORG_HEADER, } from "./hive-graph/deeplake-transport.js";
+export { loadDeepLakeCredentials, DeepLakeCredentialsError, redactToken, credentialsDir, credentialsPath, DEFAULT_DEEPLAKE_API_URL, } from "./hive-graph/deeplake-credentials.js";
+export { withHeal, isMissingTableError } from "./hive-graph/deeplake-heal.js";
+export { sqlStr, sqlLike, sqlIdent, sLiteral, eLiteral, sqlFloat4Array, sqlNum } from "./hive-graph/sql-guards.js";
+export { DeepLakeHiveGraphStore } from "./hive-graph/deeplake-store.js";
+// PRD-006: file registration protocol.
+export { WatchIntake, DEFAULT_DEBOUNCE_MS } from "./registration/fs-watch.js";
+export { classifyPath } from "./registration/classify.js";
+export { classifyNewFile } from "./registration/copy-detect.js";
+export { reassociate, carryNectar } from "./registration/ladder.js";
+export { createDefaultIgnore, loadIgnorePrefixes, ALWAYS_IGNORED_SEGMENTS, GRAPH_IGNORE_FILE, } from "./registration/ignore.js";
+export { computeFingerprint, fingerprintDistance, distanceToConfidence, createTlshFuzzyStep, DEFAULT_TUNABLE_FUZZY_CONFIG, MAX_DISTANCE, SIZE_BUCKET_TOLERANCE, FINGERPRINT_PREFIX, } from "./registration/tlsh.js";
+export { RegistrationService } from "./registration/service.js";
+export { StoreBridge } from "./registration/store-bridge.js";
+export { createDiskRegistrationFs } from "./registration/disk-fs.js";
+export { isSafeRelPath, containedPath, realpathContained } from "./registration/paths-safe.js";
+export { InMemoryPendingReviewStore, FilePendingReviewStore, } from "./registration/review-store.js";
+export { runReviewMatches } from "./registration/review-cli.js";
+export { runPrune, findPruneCandidates, PRUNE_GRACE_MS } from "./registration/prune-cli.js";
+// PRD-003b: OS service unit (launchd / systemd / schtasks).
+export { resolveServicePlan, resolveServiceContext, SERVICE_LABEL, SYSTEMD_UNIT_NAME, WINDOWS_TASK_NAME, NECTAR_RUN_COMMAND, RESTART_SEC, WINDOWS_RESTART_INTERVAL, renderUnit, installCommands, uninstallCommands, statusCommand, createExecFileRunner, createServiceModule, createNodeServiceFs, serviceStatus, } from "./service/index.js";
+// Per-project scope resolution (ADR-0002 decoupling: nectar's own ladder,
+// honeycomb detected but never required).
+export { resolveProjectScope, loadProjectsCache, emptyProjectsCache, canonicalizeRemote, readGitRemoteSignal, originUrlFromConfig, projectsCacheDir, projectsCachePath, ENV_PROJECT_ID, DETECTED_HONEYCOMB_PROJECT_ID, UNSORTED_PROJECT_ID, PROJECTS_CACHE_FILE_NAME, PROJECTS_CACHE_SCHEMA_VERSION, } from "./hive-graph/project-scope.js";
+// PRD-017: service check-in and local SQLite telemetry.
+export { createTelemetry, createNullTelemetry, wrapStoreWithMetrics, createLogTap, redactLogMessage, levelFromLine, messageFromLine, defaultTelemetryDbPath, telemetryDbPathForRuntimeDir, TELEMETRY_DIR_NAME, TELEMETRY_DB_FILE_NAME, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOG_MAX_AGE_MS, MAX_LOG_MESSAGE_LENGTH, LOG_LEVELS, CheckinService, CheckinWriter, MetricsWriter, LogWriter, } from "./telemetry/index.js";
+// PRD-003c: nectar's entry in doctor's daemon registry.
+export { NECTAR_DAEMON_NAME, DEFAULT_PROBE_INTERVAL_MS, DEFAULT_STARTUP_GRACE_MS, DEFAULT_RESTART_GIVE_UP_THRESHOLD, DEFAULT_RESTART_COOLDOWN_MS, DoctorRegistryError, defaultDoctorRegistryPath, buildNectarRegistryEntry, registerWithDoctor, } from "./doctor-registry.js";
+// PRD-010: Portkey gateway (chat-completions transport, config, describe_model audit).
+export { PORTKEY_BASE_URL, PORTKEY_CHAT_COMPLETIONS_URL, PORTKEY_EMBEDDINGS_URL, PORTKEY_API_KEY_HEADER, PORTKEY_CONFIG_HEADER, buildPortkeyHeaders, } from "./portkey/headers.js";
+export { resolvePortkeyConfig, DEFAULT_ACTIVE_MODEL, PORTKEY_CONFIG_SURFACE_KEYS } from "./portkey/config.js";
+export { describeViaPortkey, PortkeyTransportError, PORTKEY_DEFAULT_MAX_TOKENS, PORTKEY_RETRYABLE_STATUSES, PORTKEY_MAX_ATTEMPTS, PORTKEY_RETRY_BACKOFF_MS, PORTKEY_REQUEST_TIMEOUT_MS, } from "./portkey/transport.js";
+export { buildDescribeModelStamp, resetForRedescribe, applyDescribeModelStamp, isSkippedDescribeStatus, SKIPPED_DESCRIBE_STATUSES, } from "./portkey/describe-model.js";
+// PRD-011: portable projection (.honeycomb/nectars.json) format, generation, write, load, inherit.
+export { PROJECTION_SCHEMA_VERSION, DEFAULT_PROJECTION_REL_PATH, DEFAULT_GENERATOR, isValidContentHash, parseProjectionJson, canonicalSerialize, canonicalSerializeExceptGeneratedAt, } from "./projection/format.js";
+export { buildProjection, buildProjectionFromStore, buildProjectionFromAsyncStore, } from "./projection/generate.js";
+export { collectProjectionSources, collectProjectionSourcesAsync } from "./projection/store-adapter.js";
+export { ProjectionWriter, writeProjectionAtomic, projectionFinalPath, rebuildProjection, rebuildProjectionAsync, DEFAULT_WRITE_DEBOUNCE_MS, } from "./projection/write.js";
+export { loadProjection, loadProjectionFromFile, validateProjection, buildContentHashIndex, MAX_PROJECTION_FILE_BYTES, } from "./projection/load.js";
+export { inheritFromProjection } from "./projection/inherit.js";
+// PRD-014: embeddings provider switching (off | local nomic | Cohere-via-Portkey) + the 768-dim guard.
+export { resolveEmbeddingsConfig, normalizeSelector, resolveEmbedProvider, createOffProvider, DEFAULT_EMBED_PROVIDER, withDimGuard, guardVector, stderrDimRejectionSink, createLocalNomicHttpTransport, createLocalNomicProvider, createHostedPortkeyProvider, parseEmbeddingsResponse, DEFAULT_LOCAL_EMBED_HOST, DEFAULT_LOCAL_EMBED_PORT, DEFAULT_LOCAL_EMBED_TIMEOUT_MS, DEFAULT_HOSTED_EMBED_MODEL, DEFAULT_HOSTED_OUTPUT_DIMENSION, DEFAULT_HOSTED_MAX_ATTEMPTS, DEFAULT_HOSTED_RETRY_BACKOFF_MS, DEFAULT_HOSTED_REQUEST_TIMEOUT_MS, HOSTED_RETRYABLE_STATUSES, defaultFetch, defaultSleep, } from "./embeddings/index.js";
+// PRD-007 (brooding), PRD-016 (enricher), PRD-012a (hive-graph search): the
+// Wave C module surfaces, re-exported as namespaces so the package can drive the
+// full pipeline programmatically. Namespaced to keep each module's public API
+// intact without flattening two overlapping names (e.g. both brooding and the
+// enricher export an `embeddingText`) into one ambiguous top-level binding.
+export * as brooding from "./brooding/index.js";
+export * as enricher from "./enricher/index.js";
+export * as search from "./hive-graph/search.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lock.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The identity a live daemon stamps into its lock file. `pid` alone is not
+ * enough (it is reused after death); `boot` distinguishes a pre-crash/pre-reboot
+ * pid from a live one, and `token` is a per-acquire nonce used for a precise
+ * ownership check on release. `boot`/`token` are optional only so a legacy
+ * bare-pid lock still parses (see {@link readLockIdentity}).
+ */
+export interface LockIdentity {
+    readonly pid: number;
+    readonly boot?: number;
+    readonly token?: string;
+}
+/**
+ * Probe whether a PID is alive via signal 0.
+ *   - `ESRCH` -> no such process (stale),
+ *   - `EPERM` -> alive but owned by another user (treated as alive),
+ *   - success -> alive.
+ * Mirrors honeycomb's `isPidAlive` (assemble.ts:692-705).
+ */
+export declare function isPidAlive(pid: number): boolean;
+/** Read the PID from a lock/pid file; absent/unreadable/garbage returns null. */
+export declare function readPidFile(path: string): number | null;
+/**
+ * Read and parse the identity a lock file records. Accepts the current JSON
+ * shape and, for backward compatibility, a legacy bare-pid file (interpreted as
+ * a pid-only identity). Absent / unreadable / unparseable returns null.
+ */
+export declare function readLockIdentity(path: string): LockIdentity | null;
+export interface LockPaths {
+    readonly lockFilePath: string;
+    readonly pidFilePath: string;
+}
+/** Test/wiring seam: override the identity an acquire stamps (defaults to this live process). */
+export interface AcquireOptions {
+    readonly pid?: number;
+    readonly boot?: number;
+    readonly token?: string;
+    /**
+     * Test seam: override the lock-body write (default: `node:fs`'s `writeSync`).
+     * Lets a test inject a write failure (simulating a disk-full or similar
+     * mid-write fault) without needing a real filesystem-level fault or a
+     * mocking dependency (this repo has zero runtime deps and none for tests).
+     */
+    readonly writeLockBody?: (fd: number, data: string) => void;
+}
+/**
+ * Acquire the single-instance lock. Called BEFORE the socket bind (PRD-002a).
+ * Throws `DaemonAlreadyRunningError` if a LIVE daemon already holds the lock;
+ * atomically reclaims a stale lock otherwise. Returns the identity it stamped so
+ * the caller can pass it back to {@link releaseSingleInstanceLock} for an
+ * ownership-checked release (PRD-018a NEC-002).
+ */
+export declare function acquireSingleInstanceLock(paths: LockPaths, options?: AcquireOptions): LockIdentity;
+/**
+ * Release the lock: remove both files, but ONLY when this process owns the lock
+ * (PRD-018a NEC-002). Called by a process that does not own the lock (a failed
+ * second start), it is a no-op, so a failed start can never delete the live
+ * daemon's lock and pid. Pass the identity returned by
+ * {@link acquireSingleInstanceLock} for a precise token-based check; omit it to
+ * fall back to a pid+boot check against this live process. Never throws (a
+ * missing lock on shutdown is fine; the goal already holds).
+ */
+export declare function releaseSingleInstanceLock(paths: LockPaths, identity?: LockIdentity): void;
+/** True if a live daemon currently holds this lock (used by health/status). */
+export declare function isLockHeldByLiveDaemon(lockFilePath: string): boolean;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU/C;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvD;AAYD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgClE;AAoBD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAqCD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CA8DtG;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAQzF;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAGpE"}