tea-rags 1.24.0 → 1.25.1

package/README.md

@@ -205,6 +205,32 @@ For other MCP clients, CI, or air-gapped setups, see the
 [manual install](https://artk0de.github.io/TeaRAGs-MCP/quickstart/installation#option-b--manual-install)
 (Node + `npm install -g tea-rags` + Ollama/ONNX/OpenAI/Cohere/Voyage).
 
+## 🗂️ Project Registry
+
+TeaRAGs maintains a per-machine registry at `~/.tea-rags/registry.json` (or
+`$TEA_RAGS_DATA_DIR/registry.json`) that records collection metadata and lets
+you address indexed projects by a short name instead of an absolute path or
+opaque collection id.
+
+**CLI:**
+
+```bash
+tea-rags register-project --path ./my-repo --name myrepo
+tea-rags list-projects
+tea-rags list-projects --json
+tea-rags tune --project myrepo
+tea-rags unregister-project --name myrepo
+```
+
+**MCP tools:** `register_project`, `list_projects`, `unregister_project`.
+
+Every project-aware tool and command also accepts an optional `project`
+parameter alongside `path` and `collection`. Resolution priority is
+`collection > project > path`. The registry is auto-populated at the end of each
+indexing / reindexing run with the embedding model, embedding dimensions, Qdrant
+URL, `indexedAt` timestamp, tea-rags version, and chunk count — no manual
+`register-project` call is required for collections you index through tea-rags.
+
 ## 📚 Documentation
 
 **[artk0de.github.io/TeaRAGs-MCP](https://artk0de.github.io/TeaRAGs-MCP/)**

package/build/bootstrap/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/bootstrap/factory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EAKL,aAAa,EACb,KAAK,GAAG,EACT,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKhF,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAIhF,QAAA,MAAM,GAAG,EAA+E;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAsGD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA2F7E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,IAAI,CAUnE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAetG"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/bootstrap/factory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EAKL,aAAa,EACb,KAAK,GAAG,EACT,MAAM,sBAAsB,CAAC;AAS9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKhF,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAIhF,QAAA,MAAM,GAAG,EAA+E;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAsGD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAwG7E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,IAAI,CAUnE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAetG"}

package/build/bootstrap/factory.js

@@ -8,10 +8,12 @@ import { OllamaEmbeddings } from "../core/adapters/embeddings/ollama.js";
 import { QdrantManager } from "../core/adapters/qdrant/client.js";
 import { resolveQdrantUrl } from "../core/adapters/qdrant/embedded/daemon.js";
 import { createApp, createComposition, ExploreFacade, IngestFacade, SchemaBuilder, } from "../core/api/index.js";
+import { ProjectRegistryOps } from "../core/api/internal/ops/project-registry-ops.js";
 import { initDebugLogger, pipelineLog } from "../core/domains/ingest/pipeline/infra/debug-logger.js";
 import { setDebug } from "../core/domains/ingest/pipeline/infra/runtime.js";
 import { buildPipelineConfig } from "../core/domains/ingest/pipeline/types.js";
 import { EmbeddingModelGuard } from "../core/infra/embedding-model-guard.js";
+import { CollectionRegistry } from "../core/infra/registry/index.js";
 import { SchemaDriftMonitor } from "../core/infra/schema-drift-monitor.js";
 import { StatsCache } from "../core/infra/stats-cache.js";
 import { loadPromptsConfig } from "../mcp/prompts/index.js";
@@ -106,6 +108,8 @@ export async function createAppContext(config) {
         concurrency: zodConfig.ingest.tune.pipelineConcurrency,
         ioConcurrency: zodConfig.ingest.tune.ioConcurrency,
     };
+    const collectionRegistry = new CollectionRegistry(config.paths.appData);
+    const registryWatchStop = collectionRegistry.startWatching();
     const ingest = new IngestFacade({
         qdrant: infra.qdrant,
         embeddings: infra.embeddings,
@@ -120,17 +124,26 @@ export async function createAppContext(config) {
         syncTuning,
         snapshotDir: config.paths.snapshots,
         modelGuard: infra.modelGuard,
+        collectionRegistry,
+        teaRagsVersion: pkg.version,
     });
     const essentialTrajectoryFields = composition.registry.getEssentialPayloadKeys();
     const schemaDriftMonitor = new SchemaDriftMonitor(statsCache, [
         ...composition.allPayloadSignalDescriptors.map((d) => d.key),
         "navigation",
     ]);
+    const projectRegistryOps = new ProjectRegistryOps({
+        registry: collectionRegistry,
+        qdrant: infra.qdrant,
+        embeddings: infra.embeddings,
+        snapshotDir: config.paths.snapshots,
+    });
     const explore = new ExploreFacade({
         qdrant: infra.qdrant,
         embeddings: infra.embeddings,
         reranker: composition.reranker,
         registry: composition.registry,
+        collectionRegistry,
         statsCache,
         schemaDriftMonitor,
         payloadSignals: composition.allPayloadSignalDescriptors,
@@ -144,10 +157,12 @@ export async function createAppContext(config) {
         explore,
         reranker: composition.reranker,
         schemaDriftMonitor,
+        projectRegistryOps,
         quantizationScalar: zodConfig.qdrantTune.quantizationScalar,
         modelGuard: infra.modelGuard,
     });
     const cleanup = () => {
+        registryWatchStop();
         if ("terminate" in infra.embeddings && typeof infra.embeddings.terminate === "function") {
             void infra.embeddings.terminate();
         }

package/build/bootstrap/factory.js.map

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

package/build/cli/commands/doctor.d.ts

@@ -0,0 +1,39 @@
+import type { CommandModule } from "yargs";
+import type { EmbeddingProvider } from "../../core/adapters/embeddings/base.js";
+import { QdrantManager } from "../../core/adapters/qdrant/client.js";
+interface DoctorArgs {
+    json?: boolean;
+    recoverRegistry?: boolean;
+}
+/**
+ * Narrow surfaces of QdrantManager + EmbeddingProvider that runDoctor needs.
+ * The `Pick` types make it trivial for tests to pass plain object mocks.
+ */
+interface DoctorDeps {
+    qdrant: Pick<QdrantManager, "url" | "checkHealth" | "listCollections" | "getCollectionInfo" | "countPoints" | "scrollFiltered"> & {
+        /**
+         * Optional — older Qdrant servers or partial mocks may omit it.
+         * Used to exclude physical collections that back an alias from the orphan
+         * count (mirrors FixB in src/cli/commands/projects.ts:runOrphans).
+         */
+        aliases?: Pick<QdrantManager["aliases"], "listAliases">;
+    };
+    embeddings: Pick<EmbeddingProvider, "checkHealth" | "getProviderName" | "getBaseUrl">;
+}
+/**
+ * `tea-rags doctor` — read-only infrastructure + registry health summary.
+ * When `--recover-registry` is set, delegates to
+ * `ProjectRegistryOps.recoverFromQdrant` to repopulate registry stubs for
+ * every Qdrant collection not yet known to the registry (audit #6, #7).
+ *
+ * `deps` is an injection point for tests; production constructs Qdrant +
+ * embeddings via the same bootstrap path the server uses.
+ */
+export declare function runDoctor(args: DoctorArgs, deps?: DoctorDeps): Promise<void>;
+/**
+ * `tea-rags doctor` yargs subcommand. `--recover-registry` delegates to
+ * `ProjectRegistryOps.recoverFromQdrant` via `runDoctor`.
+ */
+export declare const doctorCommand: CommandModule<unknown, DoctorArgs>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/build/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAIrE,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,IAAI,CACV,aAAa,EACb,KAAK,GAAG,aAAa,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,aAAa,GAAG,gBAAgB,CACnG,GAAG;QACF;;;;WAIG;QACH,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;KACzD,CAAC;IACF,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,iBAAiB,GAAG,YAAY,CAAC,CAAC;CACvF;AAmBD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyElF;AAyBD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,OAAO,EAAE,UAAU,CAqB5D,CAAC"}

package/build/cli/commands/doctor.js

@@ -0,0 +1,136 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { QdrantManager } from "../../core/adapters/qdrant/client.js";
+import { ProjectRegistryOps } from "../../core/api/internal/ops/project-registry-ops.js";
+import { CollectionRegistry } from "../../core/infra/registry/collection-registry.js";
+function resolveDataDir() {
+    return process.env.TEA_RAGS_DATA_DIR ?? join(homedir(), ".tea-rags");
+}
+function statusPrefix(ok, warn = false) {
+    if (warn)
+        return "[WARN]";
+    return ok ? "[OK]  " : "[FAIL]";
+}
+async function safe(fn, fallback) {
+    try {
+        return await fn();
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * `tea-rags doctor` — read-only infrastructure + registry health summary.
+ * When `--recover-registry` is set, delegates to
+ * `ProjectRegistryOps.recoverFromQdrant` to repopulate registry stubs for
+ * every Qdrant collection not yet known to the registry (audit #6, #7).
+ *
+ * `deps` is an injection point for tests; production constructs Qdrant +
+ * embeddings via the same bootstrap path the server uses.
+ */
+export async function runDoctor(args, deps) {
+    const { qdrant, embeddings } = deps ?? (await defaultDeps());
+    const registry = new CollectionRegistry(resolveDataDir());
+    const qdrantOk = await safe(async () => qdrant.checkHealth(), false);
+    const embeddingsOk = await safe(async () => embeddings.checkHealth(), false);
+    const collections = await safe(async () => qdrant.listCollections(), []);
+    const registeredBefore = new Set(registry.list().map((e) => e.collectionName));
+    // Aliased-to physical collections must NOT count as orphans — they back a
+    // registered (or unregistered) alias and removing them destroys live data.
+    // Mirrors FixB in src/cli/commands/projects.ts:runOrphans so `tea-rags doctor`
+    // and `tea-rags projects orphans` report consistent counts.
+    const aliasedTargets = await safe(async () => {
+        if (typeof qdrant.aliases?.listAliases !== "function")
+            return new Set();
+        const aliases = await qdrant.aliases.listAliases();
+        return new Set(aliases.map((a) => a.collectionName));
+    }, new Set());
+    const orphanCount = collections.filter((c) => !registeredBefore.has(c) && !aliasedTargets.has(c)).length;
+    const embeddingUrl = typeof embeddings.getBaseUrl === "function" ? embeddings.getBaseUrl() : undefined;
+    let recovery;
+    if (args.recoverRegistry) {
+        const before = registeredBefore.size;
+        const ops = new ProjectRegistryOps({
+            registry,
+            // ProjectRegistryOps expects full QdrantManager; the mock + real
+            // QdrantManager both satisfy the subset of methods recoverFromQdrant
+            // actually calls (listCollections, getCollectionInfo, countPoints,
+            // scrollFiltered, url).
+            qdrant: qdrant,
+        });
+        await ops.recoverFromQdrant();
+        const after = registry.list().length;
+        recovery = { recovered: after - before };
+    }
+    const projectCount = registry.list().length;
+    const remainingOrphanCount = args.recoverRegistry ? 0 : orphanCount;
+    if (args.json) {
+        process.stdout.write(`${JSON.stringify({
+            qdrant: { url: qdrant.url, reachable: qdrantOk },
+            embeddings: {
+                provider: embeddings.getProviderName(),
+                url: embeddingUrl,
+                reachable: embeddingsOk,
+            },
+            registry: { projectCount, orphanCount: remainingOrphanCount },
+            ...(recovery ? { recovery } : {}),
+        }, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(`${statusPrefix(qdrantOk)} Qdrant: ${qdrant.url}\n`);
+    process.stdout.write(`${statusPrefix(embeddingsOk)} Embeddings (${embeddings.getProviderName()})${embeddingUrl ? `: ${embeddingUrl}` : ""}\n`);
+    process.stdout.write(`${statusPrefix(true)} Registry: ${projectCount} project(s)\n`);
+    if (recovery) {
+        process.stdout.write(`${statusPrefix(true)} Recovered ${recovery.recovered} entry/entries from Qdrant; paths are empty — re-register them with 'tea-rags projects register --path <dir> --name <alias>' to enable alias resolution.\n`);
+    }
+    else if (orphanCount > 0) {
+        process.stdout.write(`${statusPrefix(true, true)} Registry: ${orphanCount} orphan collection(s) — run 'tea-rags doctor --recover-registry' or 'tea-rags projects orphans' to inspect\n`);
+    }
+}
+/**
+ * Build the same QdrantManager + EmbeddingProvider the MCP server would use.
+ * Mirrors the construction path in src/bootstrap/factory.ts:resolveInfrastructure,
+ * but skips embedded-daemon spawn (doctor is read-only — connection refused is
+ * a legitimate [FAIL] report).
+ */
+async function defaultDeps() {
+    const { parseAppConfig, getZodConfig } = await import("../../bootstrap/config/index.js");
+    const { resolveQdrantUrl } = await import("../../core/adapters/qdrant/embedded/daemon.js");
+    const { EmbeddingProviderFactory } = await import("../../core/adapters/embeddings/factory.js");
+    const config = parseAppConfig();
+    const zodConfig = getZodConfig();
+    const resolution = await resolveQdrantUrl(config.qdrantUrl, config.paths.appData);
+    const qdrant = new QdrantManager(resolution.url, config.qdrantApiKey);
+    const embeddings = EmbeddingProviderFactory.create(zodConfig.embedding, {
+        models: config.paths.models,
+        daemonSocket: config.paths.daemonSocket,
+        daemonPid: config.paths.daemonPid,
+    });
+    return { qdrant, embeddings };
+}
+/**
+ * `tea-rags doctor` yargs subcommand. `--recover-registry` delegates to
+ * `ProjectRegistryOps.recoverFromQdrant` via `runDoctor`.
+ */
+export const doctorCommand = {
+    command: "doctor",
+    describe: "Print infrastructure + registry health summary",
+    builder: (yargs) => yargs
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Output as JSON",
+    })
+        .option("recover-registry", {
+        type: "boolean",
+        default: false,
+        describe: "Repopulate the project registry from live Qdrant state",
+    }),
+    handler: async (argv) => {
+        await runDoctor({
+            json: argv.json,
+            recoverRegistry: Boolean(argv["recover-registry"]),
+        });
+    },
+};
+//# sourceMappingURL=doctor.js.map

package/build/cli/commands/doctor.js.map

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

package/build/cli/commands/prime.d.ts

@@ -1,6 +1,7 @@
 import type { CommandModule } from "yargs";
 interface PrimeArgs {
-    path: string;
+    path?: string;
+    project?: string;
 }
 export declare const primeCommand: CommandModule<object, PrimeArgs>;
 export {};

package/build/cli/commands/prime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAYzD,CAAC"}
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAiBzD,CAAC"}

package/build/cli/commands/prime.js

@@ -1,14 +1,18 @@
 import { runPrime } from "../prime/run-prime.js";
 export const primeCommand = {
-    command: "prime <path>",
+    command: "prime [path]",
     describe: "Emit a markdown digest of index state for SessionStart context.",
-    builder: (yargs) => yargs.positional("path", {
+    builder: (yargs) => yargs
+        .positional("path", {
         type: "string",
-        describe: "Project path (typically $CLAUDE_PROJECT_DIR from a hook)",
-        demandOption: true,
+        describe: "Project path (typically $CLAUDE_PROJECT_DIR from a hook). Optional if --project is given.",
+    })
+        .option("project", {
+        type: "string",
+        describe: "Project alias from registry. Resolves --path / --qdrant-url from the registered entry; heuristic discovery only used as fallback.",
     }),
     handler: async (argv) => {
-        await runPrime(argv.path);
+        await runPrime({ path: argv.path, project: argv.project });
     },
 };
 //# sourceMappingURL=prime.js.map

package/build/cli/commands/prime.js.map

@@ -1 +1 @@
-{"version":3,"file":"prime.js","sourceRoot":"","sources":["../../../src/cli/commands/prime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMjD,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,iEAAiE;IAC3E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,0DAA0D;QACpE,YAAY,EAAE,IAAI;KACnB,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC"}
+{"version":3,"file":"prime.js","sourceRoot":"","sources":["../../../src/cli/commands/prime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOjD,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,iEAAiE;IAC3E,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,2FAA2F;KACtG,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,mIAAmI;KACtI,CAAC;IACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/build/cli/commands/projects.d.ts

@@ -0,0 +1,48 @@
+import type { CommandModule } from "yargs";
+import { QdrantManager } from "../../core/adapters/qdrant/client.js";
+interface RegisterArgs {
+    path: string;
+    name: string;
+}
+interface UnregisterArgs {
+    name: string;
+    purge?: boolean;
+}
+interface ListArgs {
+    json?: boolean;
+}
+interface InfoArgs {
+    name: string;
+    json?: boolean;
+}
+interface OrphansArgs {
+    json?: boolean;
+}
+/** Narrow surface of QdrantManager that runOrphans needs (allows test injection). */
+type QdrantSurface = Pick<QdrantManager, "listCollections" | "countPoints"> & {
+    /**
+     * Optional — older Qdrant servers or partial mocks may omit it.
+     * Used to exclude physical collections that back an alias from the orphan list.
+     */
+    aliases?: Pick<QdrantManager["aliases"], "listAliases">;
+};
+export declare function runRegister(args: RegisterArgs): Promise<void>;
+export declare function runUnregister(args: UnregisterArgs, qdrant?: Pick<QdrantManager, "deleteCollection" | "countPoints">): Promise<void>;
+export declare function runList(args: ListArgs): void;
+export declare function runInfo(args: InfoArgs): void;
+/**
+ * List Qdrant collections that are not represented in the project registry.
+ * Read-only — does not mutate either side. Audit #8 listing half.
+ *
+ * `qdrant` is an injection point: production code constructs a real
+ * QdrantManager via parseAppConfig + resolveQdrantUrl; tests pass a mock.
+ */
+export declare function runOrphans(args: OrphansArgs, qdrant?: QdrantSurface): Promise<void>;
+/**
+ * `tea-rags projects [register|list|unregister|info|orphans]` — grouped subcommands
+ * for project registry management. `list` is the default when no subcommand
+ * is given.
+ */
+export declare const projectsCommand: CommandModule;
+export {};
+//# sourceMappingURL=projects.d.ts.map

package/build/cli/commands/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAMrE,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AACD,UAAU,QAAQ;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AACD,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AACD,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qFAAqF;AACrF,KAAK,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,aAAa,CAAC,GAAG;IAC5E;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;CACzD,CAAC;AAWF,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnE;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,kBAAkB,GAAG,aAAa,CAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAc5C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CA2C5C;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CzF;AAsBD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,aAyE7B,CAAC"}

package/build/cli/commands/projects.js

@@ -0,0 +1,216 @@
+import { realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { QdrantManager } from "../../core/adapters/qdrant/client.js";
+import { ProjectRegistryOps } from "../../core/api/internal/ops/project-registry-ops.js";
+import { CollectionRegistry } from "../../core/infra/registry/collection-registry.js";
+import { PROJECT_NAME_RE } from "../../core/infra/registry/index.js";
+function resolveDataDir() {
+    return process.env.TEA_RAGS_DATA_DIR ?? join(homedir(), ".tea-rags");
+}
+function newOps() {
+    const registry = new CollectionRegistry(resolveDataDir());
+    return { registry, ops: new ProjectRegistryOps({ registry }) };
+}
+export async function runRegister(args) {
+    const { ops } = newOps();
+    try {
+        const out = await ops.register({ path: args.path, name: args.name });
+        process.stdout.write(`Registered '${args.name}' -> ${out.collectionName}${out.alreadyIndexed ? " (already indexed)" : ""}\n`);
+    }
+    catch (err) {
+        process.stderr.write(`projects register failed: ${err.message}\n`);
+        process.exit(1);
+    }
+}
+export async function runUnregister(args, qdrant) {
+    const { registry, ops } = newOps();
+    // Capture the collectionName before the entry is removed so we can purge it.
+    const entry = registry.findByName(args.name);
+    const out = await ops.unregister({ name: args.name });
+    if (!out.removed) {
+        process.stdout.write(`'${args.name}' was not registered\n`);
+        return;
+    }
+    const collectionName = entry?.collectionName ?? "(unknown)";
+    if (args.purge) {
+        const client = qdrant ?? (await defaultQdrant());
+        const chunkCount = await safeCount(client, collectionName);
+        try {
+            await client.deleteCollection(collectionName);
+            process.stdout.write(`Removed '${args.name}' from registry; deleted Qdrant collection '${collectionName}' (${chunkCount} chunks)\n`);
+        }
+        catch (err) {
+            process.stdout.write(`Removed '${args.name}' from registry; failed to delete Qdrant collection '${collectionName}': ${err.message}\n`);
+        }
+        return;
+    }
+    process.stdout.write(`Removed '${args.name}' from registry. Note: Qdrant collection '${collectionName}' is still present. Run 'tea-rags projects unregister --name ${args.name} --purge' to remove it.\n`);
+}
+export function runList(args) {
+    const { registry } = newOps();
+    const list = registry.list();
+    if (args.json) {
+        process.stdout.write(`${JSON.stringify(list, null, 2)}\n`);
+        return;
+    }
+    if (list.length === 0) {
+        process.stdout.write("(no projects registered)\n");
+        return;
+    }
+    for (const e of list) {
+        process.stdout.write(`${e.name ?? "(no name)"}\t${e.collectionName}\t${e.path}\n`);
+    }
+}
+export function runInfo(args) {
+    const { registry } = newOps();
+    const entry = registry.findByName(args.name);
+    if (!entry) {
+        process.stderr.write(`'${args.name}' was not registered\n`);
+        process.exit(1);
+        return;
+    }
+    // Compute live realpath. Missing on disk → null sentinel rendered as
+    // "(missing on disk)" in text mode and omitted from JSON. Audit #13.
+    let realpath;
+    try {
+        realpath = realpathSync(entry.path);
+    }
+    catch {
+        realpath = null;
+    }
+    const realpathDiffers = realpath !== null && realpath !== entry.path;
+    if (args.json) {
+        const payload = { ...entry };
+        if (realpathDiffers) {
+            payload.realpath = realpath;
+        }
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(`name:                ${entry.name ?? "(no name)"}\n`);
+    process.stdout.write(`collectionName:      ${entry.collectionName}\n`);
+    process.stdout.write(`path:                ${entry.path}\n`);
+    if (realpath === null) {
+        process.stdout.write(`realpath:            (missing on disk)\n`);
+    }
+    else if (realpathDiffers) {
+        process.stdout.write(`realpath:            ${realpath}\n`);
+        process.stdout.write(`                     (symlink or moved mount — re-register to refresh)\n`);
+    }
+    process.stdout.write(`qdrantUrl:           ${entry.qdrantUrl || "(none)"}\n`);
+    process.stdout.write(`embeddingModel:      ${entry.embeddingModel || "(none)"}\n`);
+    process.stdout.write(`embeddingDimensions: ${entry.embeddingDimensions || 0}\n`);
+    process.stdout.write(`chunksCount:         ${entry.chunksCount}\n`);
+    process.stdout.write(`indexedAt:           ${entry.indexedAt || "(never)"}\n`);
+    process.stdout.write(`teaRagsVersion:      ${entry.teaRagsVersion || "(unknown)"}\n`);
+}
+/**
+ * List Qdrant collections that are not represented in the project registry.
+ * Read-only — does not mutate either side. Audit #8 listing half.
+ *
+ * `qdrant` is an injection point: production code constructs a real
+ * QdrantManager via parseAppConfig + resolveQdrantUrl; tests pass a mock.
+ */
+export async function runOrphans(args, qdrant) {
+    const { registry } = newOps();
+    const client = qdrant ?? (await defaultQdrant());
+    const registered = new Set(registry.list().map((e) => e.collectionName));
+    // Aliased-to physical collections must NOT appear as orphans — they back a
+    // registered (or unregistered) alias and removing them destroys live data.
+    // Qdrant's listCollections returns physical names (e.g. `code_8b243ffe_v2`);
+    // the registry stores alias names (e.g. `code_8b243ffe`). Subtract the alias
+    // targets so the user is never told a live backing collection is "orphaned".
+    let aliasedTargets = new Set();
+    try {
+        const aliases = (await client.aliases?.listAliases()) ?? [];
+        aliasedTargets = new Set(aliases.map((a) => a.collectionName));
+    }
+    catch {
+        // Best-effort fallback — older Qdrant servers without alias support fall
+        // back to pre-fix behaviour (all physical names visible).
+    }
+    const collections = await client.listCollections();
+    const orphans = collections.filter((c) => !registered.has(c) && !aliasedTargets.has(c));
+    if (args.json) {
+        const rows = await Promise.all(orphans.map(async (collectionName) => ({
+            collectionName,
+            chunksCount: await safeCount(client, collectionName),
+        })));
+        process.stdout.write(`${JSON.stringify(rows, null, 2)}\n`);
+        return;
+    }
+    if (orphans.length === 0) {
+        process.stdout.write("(no orphan collections)\n");
+        return;
+    }
+    for (const collectionName of orphans) {
+        const count = await safeCount(client, collectionName);
+        process.stdout.write(`${collectionName}\t${count}\n`);
+    }
+}
+async function safeCount(client, collectionName) {
+    try {
+        return await client.countPoints(collectionName);
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Build a QdrantManager pointed at the same URL the MCP server would use.
+ * Resolves via parseAppConfig + resolveQdrantUrl so embedded mode is honored.
+ */
+async function defaultQdrant() {
+    const { parseAppConfig } = await import("../../bootstrap/config/index.js");
+    const { resolveQdrantUrl } = await import("../../core/adapters/qdrant/embedded/daemon.js");
+    const config = parseAppConfig();
+    const resolution = await resolveQdrantUrl(config.qdrantUrl, config.paths.appData);
+    return new QdrantManager(resolution.url, config.qdrantApiKey);
+}
+/**
+ * `tea-rags projects [register|list|unregister|info|orphans]` — grouped subcommands
+ * for project registry management. `list` is the default when no subcommand
+ * is given.
+ */
+export const projectsCommand = {
+    command: "projects",
+    describe: "Manage registered projects (register | list | unregister | info | orphans). Defaults to list.",
+    builder: (yargs) => yargs
+        .command("register", "Register a project path under an alias name", (y) => y
+        .option("path", {
+        type: "string",
+        demandOption: true,
+        describe: "Absolute path to the project root",
+    })
+        .option("name", {
+        type: "string",
+        demandOption: true,
+        describe: `Short name to register (regex ${PROJECT_NAME_RE.source})`,
+    }), async (argv) => runRegister({ path: argv.path, name: argv.name }))
+        .command("unregister", "Remove a registered project by name (optionally also delete the Qdrant collection)", (y) => y.option("name", { type: "string", demandOption: true, describe: "Project name to remove" }).option("purge", {
+        type: "boolean",
+        default: false,
+        describe: "Also delete the underlying Qdrant collection",
+    }), async (argv) => runUnregister({ name: argv.name, purge: argv.purge }))
+        .command("orphans", "List Qdrant collections without a registry entry", (y) => y.option("json", { type: "boolean", default: false, describe: "Output as JSON" }), async (argv) => {
+        await runOrphans({ json: argv.json });
+    })
+        .command("list", "List all registered projects", (y) => y.option("json", { type: "boolean", default: false, describe: "Output as JSON" }), (argv) => {
+        runList({ json: argv.json });
+    })
+        .command("info", "Show full info for one registered project", (y) => y
+        .option("name", { type: "string", demandOption: true, describe: "Project name" })
+        .option("json", { type: "boolean", default: false, describe: "Output as JSON" }), (argv) => {
+        runInfo({ name: argv.name, json: argv.json });
+    })
+        .command("$0", "List all registered projects (default subcommand)", (y) => y.option("json", { type: "boolean", default: false, describe: "Output as JSON" }), (argv) => {
+        runList({ json: argv.json });
+    })
+        .demandCommand(0)
+        .strict(),
+    handler: () => {
+        // never reached — yargs delegates to subcommands
+    },
+};
+//# sourceMappingURL=projects.js.map