@vibesdotdev/editor 0.0.0-stage → 1.0.0-rc.2

package/dist/code-atlas/tools/graph/cycles.js

@@ -0,0 +1,24 @@
+/**
+ * Cycle selection for the Atlas graph tool: scope to a path, order smallest first,
+ * bound by a limit, and keep each cycle's edges so it can be attributed.
+ */
+/** Cycles returned when the caller names no limit: enough to act on, small enough to read. */
+export const CYCLE_LIMIT_DEFAULT = 20;
+/** Atlas node labels are workspace-relative paths; accept an absolute or relative prefix. */
+export function toWorkspaceRelative(path, workspacePath) {
+    const root = workspacePath.endsWith('/') ? workspacePath : `${workspacePath}/`;
+    const rel = path.startsWith(root) ? path.slice(root.length) : path;
+    return rel.replace(/^\.\//, '');
+}
+export function selectCycles(all, options) {
+    const prefix = options.path ? toWorkspaceRelative(options.path, options.workspacePath) : undefined;
+    const matching = (prefix ? all.filter((cycle) => cycle.nodes.some((node) => node.label.startsWith(prefix))) : [...all]).sort((a, b) => a.nodes.length - b.nodes.length);
+    const shown = matching.slice(0, options.limit ?? CYCLE_LIMIT_DEFAULT);
+    return {
+        total: matching.length,
+        prefix,
+        cycles: shown.map((cycle) => cycle.nodes.map(({ id, label }) => ({ id, label }))),
+        cycleEdges: shown.map((cycle) => cycle.edges.map(({ sourceId, targetId }) => ({ sourceId, targetId })))
+    };
+}
+//# sourceMappingURL=cycles.js.map

package/dist/code-atlas/tools/graph/cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.js","sourceRoot":"","sources":["../../../../src/code-atlas/tools/graph/cycles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAetC,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,aAAqB;IACtE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC;IAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AASD,MAAM,UAAU,YAAY,CAC3B,GAAqB,EACrB,OAAiE;IAEjE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnG,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAC3H,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CACzC,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;IACtE,OAAO;QACN,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,MAAM;QACN,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACjF,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;KACvG,CAAC;AACH,CAAC"}

package/dist/code-atlas/tools/graph/implementation.d.ts

@@ -0,0 +1,4 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { AtlasGraphInput, AtlasGraphOutput } from './schemas.ts';
+export declare function atlasGraph(runtime: VibesRuntime, input: AtlasGraphInput): Promise<AtlasGraphOutput>;
+//# sourceMappingURL=implementation.d.ts.map

package/dist/code-atlas/tools/graph/implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../src/code-atlas/tools/graph/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAItE,wBAAsB,UAAU,CAC/B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAgJ3B"}

package/dist/code-atlas/tools/graph/implementation.js

@@ -0,0 +1,131 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { withAtlasStorage, ensureAtlasIndex, resolveAtlasProjectId } from "../helpers.js";
+import { resolveCodeAtlas, queryPackageGraph } from '@vibesdotdev/workspace/code-atlas';
+import { selectCycles, toWorkspaceRelative } from "./cycles.js";
+export async function atlasGraph(runtime, input) {
+    const workspacePath = await runtime.context('runtime/workspace-path');
+    const { projectId } = await resolveAtlasProjectId(runtime, input.projectId, workspacePath);
+    const queryType = input.queryType;
+    const maxDepth = input.maxDepth ?? 3;
+    if (input.nodeType === 'package') {
+        // Package nodes come from the declared workspace packages, not the file index; an absent atlas refuses typed.
+        const atlas = await resolveCodeAtlas(runtime);
+        const graph = await atlas.packageGraph({ workspaceRoot: workspacePath });
+        const answer = queryPackageGraph(graph, {
+            queryType,
+            name: input.packageName,
+            target: input.targetPackage,
+            maxDepth,
+            includeDev: input.includeDev ?? true
+        });
+        const node = (name) => ({ id: name, label: name });
+        const output = { queryType, projectId, summary: answer.summary };
+        if (answer.nodes)
+            output.nodes = answer.nodes.map(node);
+        if (answer.path)
+            output.path = answer.path.map(node);
+        if (answer.cycles) {
+            output.cycles = answer.cycles.map((cycle) => cycle.map(node));
+            output.total = answer.total;
+        }
+        return output;
+    }
+    const result = await withAtlasStorage(runtime, projectId, async (storage) => {
+        const { config, latestRun } = await ensureAtlasIndex(storage, projectId);
+        if (queryType === 'cycles') {
+            const selected = selectCycles(await storage.findCycles(latestRun.id), {
+                path: input.path,
+                limit: input.limit,
+                workspacePath
+            });
+            const where = selected.prefix ? ` under ${selected.prefix}` : '';
+            return {
+                summary: selected.total === 0
+                    ? `No circular dependencies detected${where}.`
+                    : `Found ${selected.total} circular dependenc${selected.total === 1 ? 'y' : 'ies'}${where}; showing ${selected.cycles.length}, smallest first.`,
+                total: selected.total,
+                cycles: selected.cycles,
+                cycleEdges: selected.cycleEdges
+            };
+        }
+        if (queryType === 'impact-radius') {
+            if (!input.nodeId) {
+                throw new Error('nodeId is required for impact-radius query.');
+            }
+            const impacted = await storage.getImpactRadius(input.nodeId, latestRun.id, maxDepth);
+            return {
+                summary: impacted.length === 0
+                    ? 'No dependent files within the requested depth.'
+                    : `${impacted.length} file(s) would be impacted.`,
+                nodes: impacted.map(({ id, label }) => ({ id, label }))
+            };
+        }
+        if (queryType === 'fan-out' || queryType === 'fan-in') {
+            // The node: an explicit id, or the file at `path` (A1e). Edges are queried by node,
+            // never by run: an incremental run re-saves only some of them.
+            const files = await storage.getFilesByConfig(config.id);
+            const byPath = input.path ? files.find((file) => file.path === toWorkspaceRelative(input.path ?? '', workspacePath)) : undefined;
+            const nodeId = input.nodeId ?? byPath?.id;
+            if (!nodeId) {
+                throw new CapabilityError(`A ${queryType} query needs the node: nodeId, or the path of an indexed file.`, 'INVALID_INPUT', {
+                    reason: 'atlas-graph-node-required',
+                    recoveryHint: input.path
+                        ? `No indexed file at "${input.path}". Use a workspace-relative path from search results, or pass nodeId.`
+                        : 'Pass nodeId (from search or symbol results) or path (a workspace-relative file path).'
+                });
+            }
+            const isSymbol = input.nodeType === 'symbol';
+            const filePath = (id) => (id ? files.find((file) => file.id === id) : undefined);
+            if (queryType === 'fan-out') {
+                const edges = await storage.getEdgesFrom(isSymbol ? undefined : nodeId, isSymbol ? nodeId : undefined);
+                const nodes = edges
+                    .filter((edge) => edge.edgeType === 'imports')
+                    .map((edge) => filePath(edge.targetFileId))
+                    .filter((file) => file !== undefined)
+                    .map((file) => ({ id: file.id, label: file.path }));
+                return {
+                    summary: nodes.length === 0 ? 'This node has no outgoing dependencies.' : `Depends on ${nodes.length} file(s).`,
+                    nodes
+                };
+            }
+            // fan-in: importers of a file (imports edges) or of a symbol (references edges)
+            const edges = await storage.getEdgesTo(isSymbol ? undefined : nodeId, isSymbol ? nodeId : undefined);
+            const seen = new Set();
+            const nodes = edges
+                .map((edge) => filePath(edge.sourceFileId))
+                .filter((file) => file !== undefined && !seen.has(file.id) && Boolean(seen.add(file.id)))
+                .map((file) => ({ id: file.id, label: file.path }));
+            return {
+                summary: nodes.length === 0 ? 'No files depend on this node.' : `${nodes.length} file(s) import this node.`,
+                nodes
+            };
+        }
+        // path query
+        if (!input.sourceNodeId || !input.targetNodeId) {
+            throw new Error('sourceNodeId and targetNodeId are required for path query.');
+        }
+        const pathResult = await storage.findPath(input.sourceNodeId, input.targetNodeId, latestRun.id, maxDepth);
+        if (!pathResult) {
+            return {
+                summary: 'No path found between the specified nodes (within depth limit).'
+            };
+        }
+        return {
+            summary: `Path contains ${pathResult.nodes.length} node(s) and ${pathResult.edges.length} edge(s).`,
+            path: pathResult.nodes.map((node) => ({
+                id: node.id,
+                label: node.label
+            })),
+            edges: pathResult.edges.map((edge) => ({
+                sourceId: edge.sourceId,
+                targetId: edge.targetId
+            }))
+        };
+    }, workspacePath);
+    return {
+        queryType,
+        projectId,
+        ...result
+    };
+}
+//# sourceMappingURL=implementation.js.map

package/dist/code-atlas/tools/graph/implementation.js.map

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

package/dist/code-atlas/tools/graph/schemas.d.ts

@@ -0,0 +1,62 @@
+import z from 'zod/v4';
+export declare const AtlasGraphInputSchema: z.ZodObject<{
+    queryType: z.ZodDefault<z.ZodEnum<{
+        path: "path";
+        cycles: "cycles";
+        "fan-in": "fan-in";
+        "fan-out": "fan-out";
+        "impact-radius": "impact-radius";
+    }>>;
+    nodeType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        symbol: "symbol";
+        file: "file";
+        package: "package";
+    }>>>;
+    packageName: z.ZodOptional<z.ZodString>;
+    targetPackage: z.ZodOptional<z.ZodString>;
+    includeDev: z.ZodOptional<z.ZodBoolean>;
+    nodeId: z.ZodOptional<z.ZodUUID>;
+    sourceNodeId: z.ZodOptional<z.ZodUUID>;
+    targetNodeId: z.ZodOptional<z.ZodUUID>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const AtlasGraphOutputSchema: z.ZodObject<{
+    queryType: z.ZodEnum<{
+        path: "path";
+        cycles: "cycles";
+        "fan-in": "fan-in";
+        "fan-out": "fan-out";
+        "impact-radius": "impact-radius";
+    }>;
+    projectId: z.ZodString;
+    summary: z.ZodString;
+    nodes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        targetId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    cycles: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>>;
+    cycleEdges: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        targetId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    total: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type AtlasGraphInput = z.infer<typeof AtlasGraphInputSchema>;
+export type AtlasGraphOutput = z.infer<typeof AtlasGraphOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/code-atlas/tools/graph/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/code-atlas/tools/graph/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAmBvB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAqBhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYjC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/code-atlas/tools/graph/schemas.js

@@ -0,0 +1,51 @@
+import z from 'zod/v4';
+/**
+ * Atlas graph tool schemas
+ *
+ * Input/output schemas for workspace-search action "graph".
+ */
+const graphNodeSchema = z.object({
+    id: z.string(),
+    label: z.string()
+});
+const graphEdgeSchema = z.object({
+    sourceId: z.string(),
+    targetId: z.string(),
+    label: z.string().optional()
+});
+export const AtlasGraphInputSchema = z.object({
+    queryType: z
+        .enum(['fan-in', 'fan-out', 'cycles', 'impact-radius', 'path'])
+        .default('fan-out')
+        .describe('Graph query type'),
+    nodeType: z.enum(['file', 'symbol', 'package']).optional().default('file'),
+    /** package: the queried package (path source), by manifest name. */
+    packageName: z.string().min(1).optional(),
+    /** package path queries: the target package. */
+    targetPackage: z.string().min(1).optional(),
+    /** package: count devDependencies-only edges (default true). */
+    includeDev: z.boolean().optional(),
+    nodeId: z.uuid().optional(),
+    sourceNodeId: z.uuid().optional(),
+    targetNodeId: z.uuid().optional(),
+    maxDepth: z.number().int().positive().max(10).optional(),
+    projectId: z.string().optional(),
+    /** cycles: only cycles with at least one node under this workspace-relative path prefix. */
+    path: z.string().min(1).optional(),
+    /** cycles: the most cycles returned, smallest first (default 20, max 200). */
+    limit: z.number().int().positive().max(200).optional()
+});
+export const AtlasGraphOutputSchema = z.object({
+    queryType: z.enum(['fan-in', 'fan-out', 'cycles', 'impact-radius', 'path']),
+    projectId: z.string(),
+    summary: z.string(),
+    nodes: z.array(graphNodeSchema).optional(),
+    edges: z.array(graphEdgeSchema).optional(),
+    cycles: z.array(z.array(graphNodeSchema)).optional(),
+    /** cycles: the edges of each returned cycle, index-aligned with `cycles` (from -> to), so a cycle can be attributed. */
+    cycleEdges: z.array(z.array(graphEdgeSchema)).optional(),
+    /** cycles: how many cycles matched before `limit` was applied. */
+    total: z.number().int().nonnegative().optional(),
+    path: z.array(graphNodeSchema).optional()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/code-atlas/tools/graph/schemas.js.map

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

package/dist/code-atlas/tools/helpers.d.ts

@@ -0,0 +1,60 @@
+export { inferLanguages } from '@vibesdotdev/workspace/codegraph/helpers';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { AtlasStorage } from './schemas/helpers.ts';
+export type { AtlasStorage } from './schemas/helpers.ts';
+export declare function getAtlasStorageOptions(projectId: string, workspacePath: string): Promise<import("@vibesdotdev/workspace/codegraph/storage").AtlasStorageLocation>;
+/**
+ * The Atlas project for the caller's bound workspace root
+ * (`runtime/workspace-path`): the checkout's ProjectRef binding, which an
+ * explicit or aliased id must match.
+ */
+export declare function resolveAtlasProjectId(runtime: RuntimeRef, preferred: string | null | undefined, workspacePath: string): Promise<{
+    projectId: string;
+    requested: string;
+    alias?: string;
+    workspaceRoot: string;
+}>;
+export declare function withAtlasStorage<T>(runtime: RuntimeRef, projectId: string, callback: (storage: AtlasStorage) => Promise<T>, workspacePath: string): Promise<T>;
+export declare function ensureAtlasIndex(storage: AtlasStorage, projectId: string): Promise<{
+    config: {
+        id: string;
+        projectContext: {
+            projectId: string;
+            branch: string;
+            workspacePath: string;
+            commit?: string | undefined;
+        };
+        paths: string[];
+        excludePaths: string[];
+        languages: string[];
+        storageBackend: "local-sqlite" | "worker-postgres" | "worker-pgvector";
+        runtime: "bun" | "node";
+        packageManager: "bun" | "npm" | "pnpm" | "yarn";
+        enableEmbeddings: boolean;
+        redactPatterns: string[];
+        enableLangServerEnrichment: boolean;
+        enableLangServerValidation: boolean;
+        langServerTimeout: number;
+        langServerReadyTimeout: number;
+        refreshCadence?: number | undefined;
+    };
+    latestRun: {
+        id: string;
+        configId: string;
+        status: "cancelled" | "failed" | "pending" | "running" | "completed";
+        startedAt: Date;
+        completedAt: Date | null;
+        filesProcessed: number;
+        symbolsCaptured: number;
+        errors: string[];
+        workerJobId?: string | undefined;
+        metrics?: {
+            duration?: number | undefined;
+            memoryUsage?: number | undefined;
+            cpuUsage?: number | undefined;
+        } | undefined;
+    };
+}>;
+export declare function getDefaultGlobs(): "src/**/*.{ts,tsx,js,jsx,svelte}"[];
+export declare function getDefaultLanguages(): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/code-atlas/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/code-atlas/tools/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAK1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUzD,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oFAIpF;AAYD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,aAAa,EAAE,MAAM,GACnB,OAAO,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC,CAkBD;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/C,aAAa,EAAE,MAAM,cAQrB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmB9E;AAED,wBAAgB,eAAe,wCAE9B;AAED,wBAAgB,mBAAmB,aAElC"}

package/dist/code-atlas/tools/helpers.js

@@ -0,0 +1,78 @@
+import { resolveProjectAlias } from "./aliases.js";
+import { resolveProjectRef } from '@vibesdotdev/workspace/project-ref';
+export { inferLanguages } from '@vibesdotdev/workspace/codegraph/helpers';
+const DEFAULT_GLOBS = ['src/**/*.{ts,tsx,js,jsx,svelte}'];
+const PROJECT_REF_UNBOUND = 'PROJECT_REF_UNBOUND';
+/** Open the project's Atlas index on the calling tool's runtime (C083a). */
+async function createStorage(runtime, projectId, workspacePath) {
+    const { projectId: canonicalProjectId, workspaceRoot } = await resolveAtlasProjectId(runtime, projectId, workspacePath);
+    const location = await getAtlasStorageOptions(canonicalProjectId, workspaceRoot);
+    const { createAtlasStorage } = await import('@vibesdotdev/workspace/codegraph/storage');
+    return createAtlasStorage({ ...location, runtime });
+}
+export async function getAtlasStorageOptions(projectId, workspacePath) {
+    const { getDefaultStorageOptions } = await import('@vibesdotdev/workspace/codegraph/storage');
+    const storageOptions = getDefaultStorageOptions(projectId, workspacePath);
+    return storageOptions;
+}
+function requireCheckoutProjectId(runtime, workspaceRoot) {
+    const projectRef = resolveProjectRef({ cwd: workspaceRoot }, null, runtime);
+    if (!projectRef) {
+        throw new Error(`${PROJECT_REF_UNBOUND}: Atlas requires a checkout project binding at ${workspaceRoot}`);
+    }
+    return { projectId: projectRef.projectId, workspaceRoot: projectRef.workspaceRoot };
+}
+/**
+ * The Atlas project for the caller's bound workspace root
+ * (`runtime/workspace-path`): the checkout's ProjectRef binding, which an
+ * explicit or aliased id must match.
+ */
+export async function resolveAtlasProjectId(runtime, preferred, workspacePath) {
+    const bound = requireCheckoutProjectId(runtime, workspacePath);
+    const requested = preferred?.trim() || bound.projectId;
+    // The binding's own id is the binding; only another name is looked up as an alias.
+    const resolved = requested.toLowerCase() === bound.projectId.toLowerCase()
+        ? { projectId: bound.projectId, alias: undefined }
+        : await resolveProjectAlias(runtime, requested, bound.workspaceRoot);
+    if (resolved.projectId.toLowerCase() !== bound.projectId.toLowerCase()) {
+        throw new Error(`PROJECT_REF_CONFLICT: checkout is bound to ${bound.projectId}, not ${requested}`);
+    }
+    return {
+        projectId: bound.projectId,
+        requested,
+        alias: resolved.alias,
+        workspaceRoot: bound.workspaceRoot
+    };
+}
+export async function withAtlasStorage(runtime, projectId, callback, workspacePath) {
+    const storage = await createStorage(runtime, projectId, workspacePath);
+    try {
+        return await callback(storage);
+    }
+    finally {
+        await storage.close();
+    }
+}
+export async function ensureAtlasIndex(storage, projectId) {
+    const config = await storage.getConfigByProject(projectId);
+    if (!config) {
+        throw new Error(`No code index found for project "${projectId}". ` +
+            'Create one with: workspace-search { action: "index-create" } or ' +
+            '`bun vibes dev code atlas index create`. ' +
+            'Use workspace-search { action: "index-list" } to see existing indexes.');
+    }
+    const latestRun = await storage.getLatestRun(config.id);
+    if (!latestRun) {
+        throw new Error(`No completed index run found for project "${projectId}". ` +
+            'Run: workspace-search { action: "index-create" } or ' +
+            '`bun vibes dev code atlas index create` to populate the index.');
+    }
+    return { config, latestRun };
+}
+export function getDefaultGlobs() {
+    return [...DEFAULT_GLOBS];
+}
+export function getDefaultLanguages() {
+    return ['typescript', 'javascript'];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/code-atlas/tools/helpers.js.map

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

package/dist/code-atlas/tools/hooks/on-tool-error.impl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Inline Handler: Atlas Tool Error Recovery Hints
+ *
+ * Runs when `tools.tool.error` fires for the `workspace-search` tool. Maps common
+ * atlas-engine failures (missing index, FTS5 parse error, unknown action)
+ * to recovery guidance so callers can self-correct.
+ */
+import type { ToolErrorEvent } from '@vibesdotdev/tools/schemas/tool-events';
+declare class AtlasToolErrorHintHandler {
+    handle(event: ToolErrorEvent): Promise<void>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof AtlasToolErrorHintHandler>;
+export default _default;
+//# sourceMappingURL=on-tool-error.impl.d.ts.map

package/dist/code-atlas/tools/hooks/on-tool-error.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-tool-error.impl.d.ts","sourceRoot":"","sources":["../../../../src/code-atlas/tools/hooks/on-tool-error.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AA6C7E,cAAM,yBAAyB;IACxB,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CASlD;;AAED,wBAIG"}

package/dist/code-atlas/tools/hooks/on-tool-error.impl.js

@@ -0,0 +1,57 @@
+/**
+ * Inline Handler: Atlas Tool Error Recovery Hints
+ *
+ * Runs when `tools.tool.error` fires for the `workspace-search` tool. Maps common
+ * atlas-engine failures (missing index, FTS5 parse error, unknown action)
+ * to recovery guidance so callers can self-correct.
+ */
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
+function deriveAtlasRecoveryHint(message) {
+    const errorMsg = message.toLowerCase();
+    if (errorMsg.includes('index') && errorMsg.includes('not found')) {
+        return ('Atlas index not found. Use workspace-search with action "index-create" to create an index, ' +
+            'or action "index-list" to see existing indexes.');
+    }
+    if (errorMsg.includes('no index data') || errorMsg.includes('no completed index run')) {
+        return 'Atlas index exists but has no data. Run workspace-search with action "index-create" to populate it.';
+    }
+    if (errorMsg.includes('symbol') && errorMsg.includes('not found')) {
+        return 'Symbol not found. Use workspace-search with action "search" to find symbols in the codebase.';
+    }
+    if (errorMsg.includes('sqlite') ||
+        errorMsg.includes('database') ||
+        errorMsg.includes('no such table')) {
+        return ('Atlas database error. The index database may be corrupted or outdated. ' +
+            'Try recreating the index with workspace-search action "index-delete" followed by "index-create".');
+    }
+    if (errorMsg.includes('project')) {
+        return 'Project context required. Ensure projectId is specified or use action "index-alias".';
+    }
+    if (errorMsg.includes('fts5')) {
+        return ('Full-text search query error. Try simplifying the search query — avoid special characters like quotes, ' +
+            'parentheses, or operators. Use workspace-search with { raw: true } to bypass query sanitization if needed.');
+    }
+    if (errorMsg.includes('unknown action')) {
+        return ('Invalid action. Valid actions: search, graph, symbol, rename, index-status, ' +
+            'diagnostics, index-create, index-incremental, index-delete, index-list, index-update, index-alias, job-status');
+    }
+    return undefined;
+}
+class AtlasToolErrorHintHandler {
+    async handle(event) {
+        if (!event?.error)
+            return;
+        if (event.recoveryHints?.hint)
+            return;
+        const hint = deriveAtlasRecoveryHint(event.error.message);
+        if (hint) {
+            event.recoveryHints.hint = hint;
+        }
+    }
+}
+export default createRuntimeImplementation({
+    kind: 'runtime/subscription',
+    id: 'workspace.codegraph.hooks.on-tool-error',
+    implementation: AtlasToolErrorHintHandler
+});
+//# sourceMappingURL=on-tool-error.impl.js.map

package/dist/code-atlas/tools/hooks/on-tool-error.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-tool-error.impl.js","sourceRoot":"","sources":["../../../../src/code-atlas/tools/hooks/on-tool-error.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAGlE,SAAS,uBAAuB,CAAC,OAAe;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClE,OAAO,CACN,6FAA6F;YAC7F,iDAAiD,CACjD,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACvF,OAAO,qGAAqG,CAAC;IAC9G,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnE,OAAO,8FAA8F,CAAC;IACvG,CAAC;IACD,IACC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7B,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EACjC,CAAC;QACF,OAAO,CACN,yEAAyE;YACzE,kGAAkG,CAClG,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,sFAAsF,CAAC;IAC/F,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,CACN,yGAAyG;YACzG,4GAA4G,CAC5G,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACzC,OAAO,CACN,8EAA8E;YAC9E,+GAA+G,CAC/G,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,yBAAyB;IAC9B,KAAK,CAAC,MAAM,CAAC,KAAqB;QACjC,IAAI,CAAC,KAAK,EAAE,KAAK;YAAE,OAAO;QAC1B,IAAI,KAAK,CAAC,aAAa,EAAE,IAAI;YAAE,OAAO;QAEtC,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACV,KAAK,CAAC,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC;QACjC,CAAC;IACF,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC;IAC1C,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,yCAAyC;IAC7C,cAAc,EAAE,yBAAyB;CACzC,CAAC,CAAC"}

package/dist/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Subscription: attach atlas-specific recovery hints to workspace-search tool errors.
+ *
+ * Binds to `tools.tool.error`; filters to the `workspace-search` tool. Hint copy
+ * mirrors the legacy AtlasToolsPlugin so clients keep the same guidance.
+ */
+declare const _default: {
+    kind: "runtime/subscription";
+    id: string;
+    name: string;
+    description: string;
+    event: string;
+    handler: string;
+    handlerType: string;
+    filter: {
+        toolId: string;
+    };
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=on-tool-error.subscription.codegraph.descriptor.d.ts.map

package/dist/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-tool-error.subscription.codegraph.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;;;;AAIH,wBAUG"}

package/dist/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.js

@@ -0,0 +1,19 @@
+/**
+ * Subscription: attach atlas-specific recovery hints to workspace-search tool errors.
+ *
+ * Binds to `tools.tool.error`; filters to the `workspace-search` tool. Hint copy
+ * mirrors the legacy AtlasToolsPlugin so clients keep the same guidance.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    kind: 'runtime/subscription',
+    id: 'workspace.codegraph.hooks.on-tool-error',
+    name: 'Atlas Tool Error Recovery Hints',
+    description: 'Attaches atlas recovery hints when workspace-search throws',
+    event: 'tools.tool.error',
+    handler: 'inline',
+    handlerType: 'inline',
+    filter: { toolId: 'workspace-search' },
+    enabled: true
+});
+//# sourceMappingURL=on-tool-error.subscription.codegraph.descriptor.js.map

package/dist/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-tool-error.subscription.codegraph.descriptor.js","sourceRoot":"","sources":["../../../../src/code-atlas/tools/hooks/on-tool-error.subscription.codegraph.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,yCAAyC;IAC7C,IAAI,EAAE,iCAAiC;IACvC,WAAW,EAAE,4DAA4D;IACzE,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACtC,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/code-atlas/tools/index-management/alias/implementation.d.ts

@@ -0,0 +1,15 @@
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { indexAliasAction, indexAliasRemoveAction, indexAliasSetAction } from '../../schemas-actions.ts';
+import type { AtlasIndexAliasOutput } from './schemas.ts';
+/**
+ * `index-alias`: list the workspace's aliases. A read: it never writes. A call
+ * that still sends the retired set/remove fields is refused, naming the write
+ * action that now does it, so a read-only policy cannot be talked into a write.
+ */
+export declare function atlasIndexAlias(runtime: VibesRuntime, input: z.infer<typeof indexAliasAction>): Promise<AtlasIndexAliasOutput>;
+/** `index-alias-set`: point an alias at a project (writes the workspace's alias state). */
+export declare function atlasIndexAliasSet(runtime: VibesRuntime, input: z.infer<typeof indexAliasSetAction>): Promise<AtlasIndexAliasOutput>;
+/** `index-alias-remove`: remove an alias (writes the workspace's alias state). */
+export declare function atlasIndexAliasRemove(runtime: VibesRuntime, input: z.infer<typeof indexAliasRemoveAction>): Promise<AtlasIndexAliasOutput>;
+//# sourceMappingURL=implementation.d.ts.map

package/dist/code-atlas/tools/index-management/alias/implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/alias/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAO1D;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACrC,OAAO,CAAC,qBAAqB,CAAC,CAahC;AAED,2FAA2F;AAC3F,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,kFAAkF;AAClF,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAShC"}