akm-cli/dist/indexer/init.js

akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cur

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
/**
 * Explicit composition root for the indexer's built-in registrations.
 *
 * Historically a lazy gate (`ensureBuiltinsRegistered` in `walk/file-context.ts`)
 * registered the built-in renderer set on first use. That implicit,
 * order-dependent wiring is the M1/M2 finding in
 * the 2026-06 code-health brittleness audit.
 *
 * `initIndexer()` folds the renderer registration into a single deterministic,
 * idempotent entry point. It registers, exactly once:
 *
 *  1. Built-in renderers — `registerBuiltinRenderers()` (`output/renderers.ts`),
 *     which value-imports the workflow renderers from `workflows/renderer.ts`.
 *
 * Recognition is no longer registry-driven: the chunk-3 cutover replaced the
 * `registerBuiltinMatchers()`/`runMatchers()` competition with the akm adapter's
 * synchronous `recognizeMatch()` (`core/adapter/adapters/akm-adapter.ts`), so no
 * matcher registration happens here. Index-time metadata is likewise no longer
 * registry-driven: the `akm` adapter's synchronous `foldRecognizedMetadata`
 * (`core/adapter/adapters/akm-metadata.ts`) computes it inline during recognize.
 *
 * Timing is preserved: this stays a *lazy* gate. It is awaited from the same
 * accessor call sites the old gate was awaited from, so no startup work is
 * forced eagerly. The shared promise makes concurrent and repeat calls safe —
 * the registrations run at most once per process.
 */
let initPromise;
/**
 * Idempotently register every built-in indexer renderer.
 *
 * Safe to call repeatedly and concurrently: the registration work runs at most
 * once; subsequent calls await the same resolved promise.
 */
export function initIndexer() {
    if (!initPromise) {
        initPromise = (async () => {
            // Importing renderers exposes registerBuiltinRenderers(); it value-imports
            // the workflow renderers, so no separate workflows/renderer import is needed.
            const { registerBuiltinRenderers } = await import("../output/renderers.js");
            registerBuiltinRenderers();
        })();
    }
    return initPromise;
}