*

*

* Updates the VDOM tag of the button (e.g., switching between 'button' and 'a' tags) based on the current configuration.

* @param {Object} data * @param {Number} data.value

* Update the timer, typically once per second * @param {String} value

*

* @param {Boolean} [silent=false] * @protected

* @param {Boolean} silent=false

*

* @summary Upserts the volatile HarnessPresence overlay for a bootstrapped wake route. * * The durable WAKE_SUBSCRIPTION node records intere

* @returns {Boolean}

* Checks for client-side field errors * @param {Boolean} silent=true * @returns {Boolean} Returns true in case there are no client-side erro

* Validates the canonical mailbox target after `normalizeMailboxTarget`. * Resolves unambiguous `AGENT:<family>/<model>` aliases against registered A

* Rejects or logs client-supplied identity fields that conflict with server context. * * @param {Object} chunk Parsed knowledge chunk.

* Recursive folder iteration mapping directly to GraphService endpoints. * @param {String} dir Current directory path * @param {String} root

* Move a popup window * @param {Object} data * @param {Number} [data.height] * @param {Number} [data.width] * @param {String} data

* @summary Emits Docker Compose process and log diagnostics for failed startup. * @param {String} reason The failure reason that triggered diagnostic

* Helper to call the injected log function. * @param {String} level * @param {String} message * @returns {void}

* @summary Writes captured Docker CLI output to stderr when it is non-empty. * @param {String} label Human-readable command label. * @param {Object

* Arms the wedge watchdog for one in-flight update; see {@link #registerInFlightUpdate}. * Extracted for testability — specs can shrink {@link #w

* Builds a request-fresh healthcheck snapshot from a cached healthy payload. * * The broader healthcheck cache intentionally preserves expen

* Calculates a SHA-256 hash of the given content for change detection. * @param {string} content The content to hash. * @returns {string} Th

* Calculates a SHA-256 hash of the given content for change detection. * @param {string} content The content to hash. * @returns {string} Th

* Calculates a SHA-256 hash of the given content for change detection. * @param {string} content The content to hash. * @returns {string} Th

* Checks if ChromaDB is running and accessible. * * Intent: This is the most critical check. Without ChromaDB running, no knowledge base

* Computes the ChromaDB-side actionable migration-debt counts for the multi-tenant * observability surface, companion to the SQLite graph-side co

* Verifies that the required collections exist and are accessible. * * Intent: Even if ChromaDB is running, we need to ensure our specific c

* Checks if the active vector and graph databases are running and accessible. * @returns {Promise<Object>} {running: boolean, error: string|undef

* Checks whether the resolved embedding provider is ready (provider-aware). * * Reads the resolved `aiConfig.embeddingProvider` leaf (the re

* Verifies that the user is authenticated with GitHub via the `gh` CLI. * * Intent: Authentication is required for all GitHub API operations

* Checks if the GitHub CLI is installed and meets the minimum version requirement. * * Intent: This is the most critical check. Without `gh`

* Computes the untagged-legacy-node counts for the multi-tenant migration observability * surface. Operators scrape `healthcheck.migration.untagg

* Builds disposable/prod classification records for every target destination path. * * @param {Object} target * @returns {Object[]}

* Collects target destination paths from the canonical descriptor shape. * * @param {Object} target * @returns {String[]} * @priva

* @summary Persists an `acknowledgedReassign` reason as a GitHub-visible audit-trail comment. * * The reason must be persisted in a GitHub-v

* @summary Resolves a closed issue's release-date bucket. * @param {String} closedAt GitHub close timestamp. * @returns {String|null} Versio

* @summary Resolves a closed or merged pull request's release-date bucket. * @param {Object} pr GitHub pull request node or cached pull entry.

* @summary Resolves an opt-in milestone archive bucket without pre-staging future releases. * @param {Object} issue GitHub issue node or cached i

* @summary Resolves an opt-in milestone archive bucket without pre-staging future releases. * @param {Object} pr GitHub pull request node or cach

* @summary Runs queued OpenAI-compatible posts one at a time, preferring interactive work. * @returns {Promise<void>} * @private

* @summary Embeds a text array through OpenAI-compatible chunked batch requests. * * Local OpenAI-compatible embedding servers often seriali

* Helper method to stream a ChromaDB collection into a timestamped JSONL artifact. * Mirror of `Memory_DatabaseService#exportCollection` — duplic

* Helper method to export the Native Graph (Nodes and Edges) as JSONL. * @param {String} backupPath The directory to save the backup file. *

* Formats a single timeline event into a human-readable Markdown string. * @param {object} event The timeline event object. * @returns {stri

* Resolves the GitLab GraphQL endpoint from config. GitLab is frequently self-hosted, * so the endpoint is `${hostUrl}/api/graphql` rather than a

* Resolves the GitLab Personal Access Token from config (or the test override). Unlike the * GitHub client, this reads a config PAT rather than s

* Fetches the GitHub authentication token from the `gh` CLI and caches it. * This is the only method in the service that should interact with the

* Determines the correct local file path for a given discussion. * @param {object} discussion The GitHub discussion object. * @param {Map} p

* Resolves the built-in and caller-provided disposable roots. * * @param {Object} target * @returns {String[]} * @private

* Resolves the embedding write canary with a short healthy-result TTL. * * Cache key includes the active provider and expected vector dimens

* Extracts scopes from GitLab `/oauth/token/info` into the SDK AuthInfo shape. * @param {Object|null} tokenInfo * @returns {String[]}

* @returns {{name: String, embeddingFunction: Object}}

* @summary Selects the next OpenAI-compatible queue item, FIFO within each priority lane. * @returns {Number} * @private

* Determines the correct local file path for a given pull request based on its state. * @param {object} pr The GitHub pull request object. *

* Calculates the retry delay for a transient GitLab failure (honors `retry-after`). * @param {Number} attempt The 1-based retry attempt. * @

* Calculates the retry delay for a transient GitHub failure. * @param {Number} attempt The 1-based retry attempt. * @param {Response|null} r

* Handles "blocked by" relationships between issues. * @param {number} blockedIssue The issue number being blocked * @param {string}

* @summary Detects whether a GraphQL response contains usable partial data. * * GitLab can return `{data, errors}` when only one aliased fie

* @summary Detects whether a GraphQL response contains usable partial data. * * GitHub can return `{data, errors}` when only one aliased fie

* Helper method to import the Native Graph from JSONL. * @param {String} filePath The JSONL file path. * @param {String} mode 'merge' or 're

* @param {String} name * @returns {Boolean}

* @param {Error} error * @returns {Boolean}

* @param {Error} error * @returns {Boolean}

* Checks if `childPath` is inside `parentPath`. * * @param {String} childPath * @param {String} parentPath * @returns {Boolean}

* Determines whether both production-bypass gates are present. * * @param {Object} options * @param {String|Object} options.conf

* @param {Number} status The HTTP response status. * @returns {Boolean} * @private

* @param {Number} status The HTTP response status. * @returns {Boolean} * @private

* Determines whether a transport error is likely transient. * @param {Error|*} error The thrown fetch error. * @returns {Boolean} * @pr

* Determines whether a transport error is likely transient. * @param {Error|*} error The thrown fetch error. * @returns {Boolean} * @pr

* @summary Detects when saving would only update root-level telemetry timestamps. * @param {object} existingMetadata The currently persisted meta

* @summary Parses a plain JSON chat-completions body after the stream ends. * * Pretty-printed JSON can span multiple lines, so this fallbac

* Performs a comprehensive health check without using the cache. * * Intent: This is the core health check logic, separated from the caching

* Performs a comprehensive health check without using the cache. * * Intent: This is the core health check logic, separated from the caching

* Performs a comprehensive health check without using the cache. * * Intent: This is the core health check logic, separated from the caching

* @summary Pre-computes bucket distribution for all pull requests based on historical milestones/releases. * @param {object} metadata Current syn

* @summary Pre-computes bucket counts and indices for all discussions based on historical releases. * @param {Object} metadata The sync metadata.

* @summary Executes OpenAI-compatible /v1/embeddings POST requests with bounded retry semantics. * * Retries unloaded-model failures for bot

* Sequentially processes any method calls that were cached while the addon was not ready. * This method is asynchronous to allow awaiting the exe

* Converts an absolute path to a path relative to the project root. * @param {string} p The absolute path. * @returns {string|null} The rela

* Converts an absolute path to a path relative to the project root. * @param {string} p The absolute path. * @returns {string|null} The rela

* @summary Resolves an issue `iid` to its opaque global id (the `noteableId` a comment needs). * @param {Number|String} iid * @returns {Prom

* @summary Resolves the canonical KB collection without creating it during a shadow-swap promote window. * * Shadow-swap promotion briefly r

* @summary Resolves project label names to their opaque global ids (drops unknown names). * Shares the project-scoped `GET_PROJECT_LABEL_IDS` que

* @summary Resolves project label names to their opaque global ids (drops unknown names). * @param {String[]} labelNames * @returns {Promise

* @summary Resolves an MR `iid` to its opaque global id (the `noteableId` a comment needs). * @param {Number|String} iid * @returns {Promise

* Resolves a path to an absolute path against the project root. * @param {string} p The path to resolve. * @returns {string|null} The absolu

* Resolves a path to an absolute path against the project root. * @param {string} p The path to resolve. * @returns {string|null} The absolu

* @summary Bounds synthesis-provider errors before returning them through MCP callers. * @param {Error|String} error The raw provider error.

* Recursively scans the configured issue directory to find all local .md issue files. * This operation is intentionally limited to the active iss

* Seeds the in-memory file system with initial demo content. * This method bypasses the `ready()` check to avoid deadlocks during initialization.

* @summary Shared `mergeRequestSetAssignees` mutation runner (username-native; no id pre-lookup). * @param {Number|String} iid * @param {Str