@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/cli/index-freshness.js

@@ -0,0 +1,226 @@
+import { buildCorpusRevisionFingerprint, buildFileId, buildRefId, canonicalJson, CHUNKER_VERSION, LEXICAL_TOKENIZER_VERSION, normalizeRelativePath, knownParserLanguages, parserVersionForLanguage, sha256Hex, } from "@untangle-code/domain";
+import { discoverFiles } from "@untangle-code/scanner";
+import { NodeFileSystem } from "@untangle-code/scanner/node-fs";
+import { detectRefName, resolveTarget } from "../commands/index/target.js";
+/** Bind source selection and chunk semantics; operational concurrency does not change the corpus. */
+export function indexConfigFingerprint(view, target) {
+    return sha256Hex(canonicalJson({
+        chunkerVersion: CHUNKER_VERSION,
+        parserVersions: knownParserLanguages().map((language) => [
+            language,
+            parserVersionForLanguage(language),
+        ]),
+        maxFileSizeMb: view.config.index.maxFileSizeMb,
+        maxChunkTokens: view.config.index.maxChunkTokens,
+        include: target.include ?? [],
+        exclude: target.exclude ?? [],
+    }));
+}
+export async function inspectIndexFreshness(view, states, options = {}) {
+    const repositories = [];
+    for (const found of states) {
+        options.signal?.throwIfAborted();
+        repositories.push(await inspectRepositoryFreshness(view, found, options));
+    }
+    appendMissingSnapshots(view, states, repositories, options);
+    return {
+        status: aggregateFreshnessStatus(repositories),
+        checkedAt: new Date().toISOString(),
+        repositories,
+    };
+}
+async function inspectRepositoryFreshness(view, found, options) {
+    const entry = snapshotFreshness(found.state);
+    if (!hasCompleteSnapshotMetadata(found.state, entry))
+        return entry;
+    const target = resolveFreshnessTarget(view, found, entry, options);
+    if (target !== null)
+        await scanContentManifest(view, found.state, target, entry, options);
+    return entry;
+}
+/** Keep persisted evidence visible even when it cannot establish freshness. */
+function snapshotFreshness(state) {
+    return {
+        repoId: state.repoId,
+        refId: state.refId,
+        status: "unknown",
+        reason: "snapshot_metadata_missing",
+        filesChecked: 0,
+        ...(state.indexedAt === undefined ? {} : { indexedAt: state.indexedAt }),
+        ...(state.corpusRevisionFingerprint === undefined
+            ? {}
+            : { indexedCorpusFingerprint: state.corpusRevisionFingerprint }),
+    };
+}
+function hasCompleteSnapshotMetadata(state, entry) {
+    if (state.lexicalTokenizerVersion !== LEXICAL_TOKENIZER_VERSION) {
+        entry.status = "incompatible";
+        entry.reason = "lexical_tokenizer_changed";
+        return false;
+    }
+    if (state.outcome !== "completed") {
+        entry.status = "stale";
+        entry.reason = "index_incomplete";
+        return false;
+    }
+    return (state.corpusRevisionFingerprint !== undefined &&
+        state.indexConfigFingerprint !== undefined &&
+        state.indexedAt !== undefined);
+}
+/** Historical refs and changed source-selection rules need different diagnoses. */
+function resolveFreshnessTarget(view, found, entry, options) {
+    const state = found.state;
+    let target;
+    try {
+        target = resolveTarget({
+            config: view.config,
+            cwd: found.repoRoot,
+            rootFlag: found.repoRoot,
+            repoFlag: (view.config.repositories ?? []).length === 0 ? undefined : state.repoId,
+            refFlag: state.refName,
+            configBaseDir: view.load.sources.configBaseDir,
+        });
+    }
+    catch {
+        options.signal?.throwIfAborted();
+        entry.reason = "repository_unavailable";
+        return null;
+    }
+    if (target.rootPath !== found.repoRoot || detectRefName(target.rootPath) !== state.refName) {
+        entry.reason = "ref_not_checked_out";
+        return null;
+    }
+    if (indexConfigFingerprint(view, target) !== state.indexConfigFingerprint) {
+        entry.status = "stale";
+        entry.reason = "index_configuration_changed";
+        return null;
+    }
+    return target;
+}
+/** Compare the same full file/content manifest recorded by completed index discovery. */
+async function scanContentManifest(view, state, target, entry, options) {
+    const hashes = {};
+    let unreadable = false;
+    try {
+        for await (const file of discoverFiles({
+            fs: new NodeFileSystem(),
+            roots: [target.rootPath],
+            repoRoot: target.rootPath,
+            maxFileSizeBytes: view.config.index.maxFileSizeMb * 1024 * 1024,
+            concurrency: view.config.index.scanConcurrency,
+            ignore: {
+                ...(target.include === undefined ? {} : { configInclude: target.include }),
+                ...(target.exclude === undefined ? {} : { configExclude: target.exclude }),
+            },
+            onSkip: (skip) => {
+                if (skip.reason === "unreadable")
+                    unreadable = true;
+            },
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        })) {
+            options.signal?.throwIfAborted();
+            const fileId = buildFileId({
+                workspaceId: state.workspaceId,
+                repoId: state.repoId,
+                refId: state.refId,
+                relativePath: normalizeRelativePath(file.relativePath),
+            });
+            hashes[fileId] = file.contentHash;
+            entry.filesChecked++;
+        }
+        if (unreadable) {
+            entry.reason = "source_scan_incomplete";
+            return;
+        }
+        entry.currentCorpusFingerprint = buildCorpusRevisionFingerprint(hashes);
+        entry.status =
+            entry.currentCorpusFingerprint === state.corpusRevisionFingerprint ? "fresh" : "stale";
+        entry.reason = entry.status === "fresh" ? "content_hashes_match" : "sources_changed";
+    }
+    catch {
+        options.signal?.throwIfAborted();
+        entry.reason = "source_scan_incomplete";
+    }
+}
+/** Missing selected records must not disappear from the aggregate. */
+function appendMissingSnapshots(view, states, repositories, options) {
+    if (options.expectedRepoIds === undefined)
+        return;
+    const expectedRepos = expectedRepositoryIds(view, options.expectedRepoIds);
+    if (options.expectedRefs?.length) {
+        appendMissingRefSnapshots(view, states, repositories, expectedRepos, options.expectedRefs, options);
+        return;
+    }
+    for (const repoId of expectedRepos) {
+        if (!states.some(({ state }) => state.repoId === repoId)) {
+            repositories.push(missingSnapshot(view, repoId, undefined, options));
+        }
+    }
+}
+function expectedRepositoryIds(view, repoIds) {
+    if (repoIds.length > 0)
+        return repoIds;
+    return [
+        resolveTarget({
+            config: view.config,
+            cwd: view.root,
+            rootFlag: view.root,
+            repoFlag: undefined,
+            refFlag: undefined,
+            configBaseDir: view.load.sources.configBaseDir,
+        }).repoId,
+    ];
+}
+/** Named refs cover every selected repository; canonical refs retain their repo qualification. */
+function appendMissingRefSnapshots(view, states, repositories, expectedRepos, expectedRefs, options) {
+    for (const ref of expectedRefs) {
+        const matchingRepos = ref.includes(":")
+            ? expectedRepos.filter((repoId) => ref.startsWith(`${repoId}:`))
+            : expectedRepos;
+        if (matchingRepos.length === 0) {
+            repositories.push(missingSnapshot(view, expectedRepos[0] ?? "unknown", ref, options));
+            continue;
+        }
+        for (const repoId of matchingRepos) {
+            if (!states.some(({ state }) => state.repoId === repoId && (state.refId === ref || state.refName === ref))) {
+                repositories.push(missingSnapshot(view, repoId, ref, options));
+            }
+        }
+    }
+}
+function missingSnapshot(view, repoId, ref, options) {
+    let refId = ref?.includes(":") ? ref : buildRefId(repoId, ref ?? "unknown");
+    if (ref === undefined) {
+        try {
+            refId = resolveTarget({
+                config: view.config,
+                cwd: view.root,
+                rootFlag: view.root,
+                repoFlag: (view.config.repositories ?? []).length === 0 ? undefined : repoId,
+                refFlag: undefined,
+                configBaseDir: view.load.sources.configBaseDir,
+            }).refId;
+        }
+        catch {
+            options.signal?.throwIfAborted();
+            /* Missing configuration remains unverified. */
+        }
+    }
+    return {
+        repoId,
+        refId,
+        status: "unknown",
+        reason: "index_snapshot_missing",
+        filesChecked: 0,
+    };
+}
+function aggregateFreshnessStatus(repositories) {
+    if (repositories.length === 0)
+        return "unknown";
+    for (const status of ["incompatible", "stale", "unknown"]) {
+        if (repositories.some((entry) => entry.status === status))
+            return status;
+    }
+    return "fresh";
+}
+//# sourceMappingURL=index-freshness.js.map

package/dist/cli/index-freshness.js.map

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

package/dist/cli/index-refresh.d.ts

@@ -0,0 +1,10 @@
+import type { CommandContext } from "./command.js";
+import type { WorkspaceView } from "./workspace.js";
+/** Rebuild only selected, physically checked-out refs; route progress away from query JSON. */
+export declare function refreshWorkspaceIndex(ctx: CommandContext, options: {
+    view: WorkspaceView;
+    repoIds?: readonly string[];
+    refIds?: readonly string[];
+    embedder: "auto" | "offline";
+}): Promise<void>;
+//# sourceMappingURL=index-refresh.d.ts.map

package/dist/cli/index-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-refresh.d.ts","sourceRoot":"","sources":["../../src/cli/index-refresh.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,+FAA+F;AAC/F,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE;IACP,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GACA,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/cli/index-refresh.js

@@ -0,0 +1,76 @@
+import { buildRefId } from "@untangle-code/domain";
+import { indexCommand } from "../commands/index/index.js";
+import { detectRefName, resolveTarget } from "../commands/index/target.js";
+import { EXIT, EnvironmentError, UsageError } from "./exit.js";
+/** Rebuild only selected, physically checked-out refs; route progress away from query JSON. */
+export async function refreshWorkspaceIndex(ctx, options) {
+    const { view } = options;
+    const configured = view.config.repositories ?? [];
+    const targets = preflightRefreshTargets(view, options.repoIds, options.refIds);
+    for (const target of targets) {
+        ctx.signal.throwIfAborted();
+        const exit = await indexCommand.run({ ...ctx, io: { out: (chunk) => ctx.io.err(chunk), err: (chunk) => ctx.io.err(chunk) } }, {
+            positionals: [],
+            flags: {
+                root: configured.length === 0 ? target.rootPath : view.root,
+                ...(configured.length === 0 ? {} : { repo: target.repoId }),
+                ref: target.refName,
+                embedder: options.embedder,
+                format: "json",
+                resume: false,
+            },
+        });
+        ctx.signal.throwIfAborted();
+        if (exit !== EXIT.ok)
+            throw new EnvironmentError("The search index could not be fully refreshed.", "Check the index report on stderr and run `untangle doctor`.");
+    }
+}
+/** Resolve and validate the complete requested scope before the first mutation. */
+function preflightRefreshTargets(view, selectedRepoIds, selectedRefIds) {
+    const configured = view.config.repositories ?? [];
+    const repoIds = selectedRepoIds?.length
+        ? [...new Set(selectedRepoIds)]
+        : configured.map((repo) => repo.id);
+    const requestedRefs = new Set(selectedRefIds ?? []);
+    const availableTargets = (repoIds.length ? repoIds : [undefined]).map((repoId) => resolveRefreshTarget(view, repoId, requestedRefs.size > 0));
+    const unavailableRefs = [...requestedRefs].flatMap((ref) => ref.includes(":")
+        ? availableTargets.some((target) => target.refId === ref)
+            ? []
+            : [ref]
+        : availableTargets
+            .filter((target) => target.refName !== ref)
+            .map((target) => buildRefId(target.repoId, ref)));
+    if (unavailableRefs.length > 0)
+        throw new UsageError(`Selected refs are not checked out here: ${unavailableRefs.join(", ")}.`, "Switch to matching worktrees or select only refs checked out here.");
+    const targets = availableTargets.filter((target) => requestedRefs.size === 0 ||
+        requestedRefs.has(target.refId) ||
+        requestedRefs.has(target.refName));
+    if (targets.length === 0)
+        throw new UsageError("None of the selected refs is checked out here.", "Switch to the matching worktree and run `untangle index` there.");
+    for (const target of targets) {
+        if (detectRefName(target.rootPath) !== target.refName)
+            throw new UsageError(`Ref ${target.refName} is not checked out in ${target.rootPath}.`, "Switch to the matching worktree before refreshing its index.");
+    }
+    return targets;
+}
+/** Explicit ref selection follows the physical checkout rather than a configured default. */
+function resolveRefreshTarget(view, repoId, hasExplicitRefs) {
+    const input = {
+        config: view.config,
+        cwd: view.root,
+        rootFlag: view.root,
+        repoFlag: repoId,
+        refFlag: undefined,
+        configBaseDir: view.load.sources.configBaseDir,
+    };
+    const configuredTarget = resolveTarget(input);
+    if ((view.config.repositories ?? []).length === 0 &&
+        repoId !== undefined &&
+        repoId !== configuredTarget.repoId) {
+        throw new UsageError(`Repository ${repoId} is absent from this project.`, "Select the index by its actual repository ID or omit --repo.");
+    }
+    return hasExplicitRefs
+        ? resolveTarget({ ...input, refFlag: detectRefName(configuredTarget.rootPath) })
+        : configuredTarget;
+}
+//# sourceMappingURL=index-refresh.js.map

package/dist/cli/index-refresh.js.map

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

package/dist/cli/index-state.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Der lokale Indexzustand: welches Einbettungsprofil welchen Repo/Ref-Index
+ * gebaut hat.
+ *
+ * Seit Welle 9 ist das keine Singleton-Datei mehr. Eine physische
+ * Repository-Wurzel kann mehrere konfigurierte Repo-IDs, Refs und
+ * Einbettungsprofile tragen. Jeder dieser Zustaende liegt deshalb in einem
+ * eigenen, aus seiner kanonischen Identitaet gehashten Datensatz. Ein
+ * separater, generationsgebundener Pointer pro Repo/Ref bezeichnet das
+ * Profil des letzten gestarteten Laufs fuer `--embedder=auto`.
+ *
+ * `index-state.json` bleibt als lesbarer Migrations-Fallback erhalten. Sobald
+ * die Registry dieselbe logische Identitaet kennt, gewinnt jedoch immer ihr
+ * Datensatz; der Singleton wird dann nicht ein zweites Mal ausgegeben.
+ *
+ * Alle Dateinamen entstehen ausschliesslich aus SHA-256-Hashes. Registry und
+ * Datensaetze sind hart begrenzt. Korrupte, uebergrosse oder unbeschraenkte
+ * Registry-Inhalte werden nicht teilweise als gesund behandelt.
+ */
+/** Welcher Einbetter einen Index gebaut hat. */
+export type EmbedderChoice = "service" | "offline";
+/** Lifecycle persisted for query routing and index-completeness provenance. */
+export type IndexStateOutcome = "running" | "completed" | "cancelled" | "failed";
+/** Der Zustand eines indizierten Repositories. Reine Daten. */
+export interface IndexStateV1 {
+    readonly schemaVersion: 1;
+    readonly workspaceId: string;
+    readonly repoId: string;
+    readonly refId: string;
+    readonly refName: string;
+    /** `service` = der konfigurierte Dienst, `offline` = netzlos im Prozess. */
+    readonly embedder: EmbedderChoice;
+    readonly embeddingProfileId: string;
+    readonly collection: string;
+    /** Legacy Qdrant endpoint. Absent for embedded records. */
+    readonly qdrantUrl?: string;
+    readonly storageBackend?: "lancedb" | "qdrant";
+    readonly storeUrl?: string;
+    /** Generation des Indexlaufs; fehlt nur in vor Welle 9 geschriebenen Zuständen. */
+    readonly generationId?: string;
+    /** SHA-256 fingerprint of the complete confirmed file/content manifest. */
+    readonly corpusRevisionFingerprint?: string;
+    /** Completion time, indexing configuration and lexical format of this snapshot. */
+    readonly indexedAt?: string;
+    readonly indexConfigFingerprint?: string;
+    readonly lexicalTokenizerVersion?: string;
+    /** Ergebnis des Laufs, der diesen Zustand geschrieben hat. */
+    readonly outcome: IndexStateOutcome;
+}
+/** Identitaet eines Registry-Datensatzes. Collection/URL duerfen sich aendern. */
+export type IndexStateRecordIdentity = Pick<IndexStateV1, "workspaceId" | "repoId" | "refId" | "embeddingProfileId"> & StorageStateIdentity;
+/** Identitaet des aktuellen Profils eines Repo/Ref-Paares. */
+interface StorageStateIdentity {
+    readonly storageBackend?: "lancedb" | "qdrant";
+    readonly storeUrl?: string;
+}
+export type IndexStateCurrentIdentity = Pick<IndexStateV1, "workspaceId" | "repoId" | "refId"> & StorageStateIdentity;
+/**
+ * Index-Report-Daten, aus denen der CLI-Adapter einen persistierbaren Zustand
+ * ableitet. Ein Readiness-Fehler vor der Generation darf einen nutzbaren
+ * Zustand nicht ueberschreiben. Ein spaeter Fehler muss ihn invalidieren.
+ */
+export type IndexStateAfterRunInput = Omit<IndexStateV1, "generationId" | "outcome"> & {
+    readonly generationId: string | null;
+    readonly outcome: Exclude<IndexStateOutcome, "running">;
+};
+export declare function indexStateAfterRun(input: IndexStateAfterRunInput): IndexStateV1 | null;
+/** Alter Singleton-Name unterhalb von `.untangle/`. Nur noch Lesefallback. */
+export declare const INDEX_STATE_FILE = "index-state.json";
+export declare const INDEX_STATE_REGISTRY_DIR = "index-states-v1";
+export declare const INDEX_STATE_RECORDS_DIR = "records";
+export declare const INDEX_STATE_CURRENT_DIR = "current";
+/** Harte Ressourcenlimits fuer lokal kontrollierbare Registry-Lesevorgaenge. */
+export declare const MAX_INDEX_STATE_FILE_BYTES: number;
+export declare const MAX_INDEX_STATE_REGISTRY_ENTRIES = 512;
+/** `<repoRoot>/.untangle` — dasselbe Verzeichnis, das `untangle index` anlegt. */
+export declare function stateRootOf(repoRoot: string): string;
+/** Der alte Singleton-Pfad. Externe Hinweise und Migration duerfen ihn weiter nennen. */
+export declare function indexStatePath(stateRoot: string): string;
+export declare function indexStateRecordKey(identity: IndexStateRecordIdentity): string;
+export declare function indexStateCurrentKey(identity: IndexStateCurrentIdentity): string;
+/** Lock key shared by every profile publication for one repo/ref/backend pointer. */
+export declare function indexStateLockKey(identity: IndexStateCurrentIdentity): string;
+export declare function indexStateRecordPath(stateRoot: string, identity: IndexStateRecordIdentity): string;
+export declare function indexStateCurrentPath(stateRoot: string, identity: IndexStateCurrentIdentity): string;
+export type IndexStateWriteResult = {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    error: unknown;
+    path: string;
+    /** `true` means an earlier state cannot still masquerade as this run. */
+    previousStateInvalidated: boolean;
+    invalidationError?: unknown;
+};
+export type TerminalIndexStateWriteResult = (IndexStateWriteResult & {
+    superseded: false;
+}) | {
+    ok: true;
+    path: string;
+    superseded: true;
+};
+/** Owner check supplied by the renewable publication lease. */
+export interface IndexStatePublicationOptions {
+    /** Must reject after lease ownership was lost. Called directly before every live rename. */
+    readonly assertOwnership?: () => Promise<void>;
+}
+/**
+ * Publiziert einen Registry-Datensatz und macht ihn zum aktuellen Profil des
+ * Repo/Ref-Paares. Beide Dateien werden einzeln atomar ersetzt. Der Aufrufer
+ * serialisiert die kurze Sequenz mit {@link indexStateLockKey}.
+ *
+ * Misslingt ein Teil, werden der neue Datensatz, der current-Pointer und ein
+ * passender Legacy-Fallback invalidiert. Damit kann ein neuer Lauf nie einen
+ * alten `completed`-Hinweis gesund aussehen lassen.
+ */
+export declare function writeIndexState(stateRoot: string, state: IndexStateV1, options?: IndexStatePublicationOptions): Promise<IndexStateWriteResult>;
+/**
+ * Replaces exactly one `running` registry record while its generation still
+ * matches. The current pointer is deliberately not republished: if another
+ * profile became current while this run finished, a late terminal write may
+ * archive its own result but cannot steal `auto` routing back.
+ */
+export declare function replaceRunningIndexState(stateRoot: string, terminalState: IndexStateV1, options?: IndexStatePublicationOptions): Promise<TerminalIndexStateWriteResult>;
+/**
+ * Compatibility reader for old callers. It returns a state only when exactly
+ * one current repo/ref state exists below this physical root; callers needing
+ * every context use {@link resolveIndexState}.
+ */
+export declare function readIndexState(stateRoot: string): Promise<IndexStateV1 | null>;
+/** The parser remains public for legacy migration and focused tests. */
+export declare function parseIndexState(text: string): IndexStateV1 | null;
+/** Ein gefundener Zustand samt Herkunft und Auto-Routing-Rolle. */
+export interface FoundIndexState {
+    readonly repoRoot: string;
+    readonly statePath: string;
+    readonly source: "registry" | "legacy";
+    readonly current: boolean;
+    readonly state: IndexStateV1;
+}
+/** Optional query scope applied before states can influence auto-routing. */
+export interface IndexStateScope {
+    readonly repoIds?: readonly string[];
+    /** Accepts human ref names as well as canonical repo-qualified ref IDs. */
+    readonly refs?: readonly string[];
+    readonly storageBackend?: "lancedb" | "qdrant";
+    readonly storeUrl?: string;
+}
+export interface IndexStateDiagnostic {
+    readonly code: "INDEX_STATE_CORRUPT" | "INDEX_STATE_IO" | "INDEX_STATE_OVERSIZED" | "INDEX_STATE_UNBOUNDED";
+    readonly path: string;
+    readonly message: string;
+}
+/**
+ * `all` contains every selected profile record. `found`/`current` only use
+ * the generation-checked current pointer and therefore drive `auto` routing.
+ */
+export type IndexStateResolution = {
+    readonly kind: "resolved";
+    readonly embedder: EmbedderChoice;
+    readonly found: FoundIndexState;
+    readonly current: readonly FoundIndexState[];
+    readonly all: readonly FoundIndexState[];
+} | {
+    readonly kind: "none";
+} | {
+    readonly kind: "ambiguous";
+    readonly found: readonly FoundIndexState[];
+    readonly all: readonly FoundIndexState[];
+} | {
+    readonly kind: "invalid";
+    readonly diagnostics: readonly IndexStateDiagnostic[];
+    /** Valid states from other roots are exposed for diagnosis, never auto-used. */
+    readonly all: readonly FoundIndexState[];
+};
+/**
+ * Enumerates every bounded registry under the candidate physical roots.
+ * Roots are de-duplicated, records are not: one root can legitimately contain
+ * multiple repo IDs, refs and profiles.
+ */
+export declare function resolveIndexState(candidateRoots: readonly string[], workspaceId: string, scope?: IndexStateScope): Promise<IndexStateResolution>;
+export {};
+//# sourceMappingURL=index-state.d.ts.map

package/dist/cli/index-state.d.ts.map

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