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

package/dist/code-atlas/tools/index-management/job-status/implementation.js

@@ -0,0 +1,108 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { getWorkersClient } from '@vibesdotdev/workers/client';
+import { resolveAtlasProjectId } from "../../helpers.js";
+import { ProjectedExecutionClaimSchema } from "./schemas.js";
+/** Jobs read per page while filtering by project. */
+const PAGE_SIZE = 100;
+/** The most jobs one listing reads before it reports what it found as incomplete. */
+const MAX_SCANNED_JOBS = 1000;
+/** A job's progress as a percentage; an object-shaped progress report is not one. */
+const ProgressSchema = z.number();
+/** A pending job whose execution owner is unknown: the owner keeps its status, and it is not runnable yet. */
+const AWAITING_RETIREMENT_EVIDENCE = 'Awaiting retirement evidence: its execution owner is unknown, so it is not runnable until that is settled.';
+/** The project an Atlas job's payload names, when it names one. */
+const JobProjectSchema = z.object({ projectId: z.string() });
+export async function atlasJobStatus(runtime, input) {
+    const queueName = input.queueName ?? 'dev-atlas-jobs';
+    const queue = await (await getWorkersClient(runtime)).getQueue(queueName);
+    if (input.jobId) {
+        const job = await queue.getJob(input.jobId);
+        if (!job) {
+            throw new CapabilityError(`Job ${input.jobId} not found in queue ${queueName}.`, 'NOT_FOUND', { reason: 'atlas-job-not-found' });
+        }
+        const info = mapJob(job);
+        return { summary: `Job ${job.id} is currently ${job.status}.${info.note ? ` ${info.note}` : ''}`, job: info };
+    }
+    const limit = input.limit ?? 20;
+    if (!input.projectId) {
+        const jobs = (await queue.listJobs(input.status, { limit })).map(mapJob);
+        const awaiting = awaitingCount(jobs);
+        return {
+            summary: `Found ${jobs.length} job(s)${awaitingSuffix(awaiting)}.`,
+            jobs,
+            scanned: jobs.length,
+            complete: jobs.length < limit,
+            awaitingRetirementEvidence: awaiting
+        };
+    }
+    // Only the project filter needs the bound workspace (for its aliases), read at use.
+    const { projectId } = await resolveAtlasProjectId(runtime, input.projectId, await runtime.context('runtime/workspace-path'));
+    // The queue filters by status only: page through it, keeping the project's jobs,
+    // so another project's rows never hide this one's.
+    const found = [];
+    let scanned = 0;
+    let complete = false;
+    while (found.length < limit && scanned < MAX_SCANNED_JOBS) {
+        const pageSize = Math.min(PAGE_SIZE, MAX_SCANNED_JOBS - scanned);
+        const page = await queue.listJobs(input.status, { limit: pageSize, offset: scanned });
+        scanned += page.length;
+        for (const job of page) {
+            if (projectOf(job) === projectId && found.length < limit)
+                found.push(job);
+        }
+        // A short page is the end of the queue: everything was read.
+        if (page.length < pageSize) {
+            complete = true;
+            break;
+        }
+    }
+    const jobs = found.map(mapJob);
+    const awaiting = awaitingCount(jobs);
+    const summary = jobs.length > 0
+        ? `Found ${jobs.length} job(s) for project ${projectId}${complete ? '' : ` among the ${scanned} most recent read`}${awaitingSuffix(awaiting)}.`
+        : complete
+            ? `No jobs found for project ${projectId}.`
+            : `No jobs for project ${projectId} among the ${scanned} most recent read; older jobs were not read.`;
+    return { summary, jobs, scanned, complete, awaitingRetirementEvidence: awaiting };
+}
+function awaitingCount(jobs) {
+    return jobs.filter((job) => job.note === AWAITING_RETIREMENT_EVIDENCE).length;
+}
+function awaitingSuffix(awaiting) {
+    return awaiting > 0 ? `; ${awaiting} pending job(s) awaiting retirement evidence, not runnable yet` : '';
+}
+/** The owner's claim as the tool shows it: the held claim's identity without its token. */
+function projectClaim(job) {
+    const claim = job.executionClaim;
+    if (claim.state !== 'held')
+        return ProjectedExecutionClaimSchema.parse({ state: claim.state });
+    const { generation, attempt, owner } = claim.identity;
+    return ProjectedExecutionClaimSchema.parse({ state: 'held', generation, attempt, owner, heartbeatAt: claim.heartbeatAt });
+}
+function projectOf(job) {
+    const parsed = JobProjectSchema.safeParse(job.data);
+    return parsed.success ? parsed.data.projectId : undefined;
+}
+function mapJob(job) {
+    const data = JsonObjectSchema.safeParse(job.data);
+    return {
+        id: job.id,
+        status: job.status,
+        progress: ProgressSchema.safeParse(job.progress).data,
+        createdAt: job.createdAt.toISOString(),
+        startedAt: job.startedAt?.toISOString(),
+        completedAt: job.completedAt?.toISOString(),
+        attempts: job.attemptsMade,
+        projectId: projectOf(job),
+        data: data.success ? data.data : undefined,
+        result: job.result,
+        error: job.error,
+        generation: job.generation,
+        revision: job.revision,
+        executionClaim: projectClaim(job),
+        note: job.status === 'pending' && job.executionClaim.state === 'unknown' ? AWAITING_RETIREMENT_EVIDENCE : undefined
+    };
+}
+//# sourceMappingURL=implementation.js.map

package/dist/code-atlas/tools/index-management/job-status/implementation.js.map

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

package/dist/code-atlas/tools/index-management/job-status/schemas.d.ts

@@ -0,0 +1,109 @@
+import z from 'zod/v4';
+/**
+ * The queue owner's execution claim as a tool shows it, from the owner's own
+ * schemas. A held claim's `token` is its write capability and is never projected.
+ */
+export declare const ProjectedExecutionClaimSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodEnum<{
+        none: "none";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodEnum<{
+        unknown: "unknown";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    owner: z.ZodString;
+    generation: z.ZodNumber;
+    attempt: z.ZodNumber;
+    state: z.ZodEnum<{
+        held: "held";
+    }>;
+    heartbeatAt: z.ZodString;
+}, z.core.$strict>], "state">;
+export declare const AtlasJobStatusInputSchema: z.ZodObject<{
+    jobId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    queueName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        completed: "completed";
+        processing: "processing";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const AtlasJobStatusOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    job: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        progress: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+        projectId: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        result: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+        generation: z.ZodNumber;
+        revision: z.ZodNumber;
+        executionClaim: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            state: z.ZodEnum<{
+                none: "none";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            owner: z.ZodString;
+            generation: z.ZodNumber;
+            attempt: z.ZodNumber;
+            state: z.ZodEnum<{
+                held: "held";
+            }>;
+            heartbeatAt: z.ZodString;
+        }, z.core.$strict>], "state">;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    jobs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        progress: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        attempts: z.ZodOptional<z.ZodNumber>;
+        projectId: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        result: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+        generation: z.ZodNumber;
+        revision: z.ZodNumber;
+        executionClaim: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            state: z.ZodEnum<{
+                none: "none";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            owner: z.ZodString;
+            generation: z.ZodNumber;
+            attempt: z.ZodNumber;
+            state: z.ZodEnum<{
+                held: "held";
+            }>;
+            heartbeatAt: z.ZodString;
+        }, z.core.$strict>], "state">;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    scanned: z.ZodOptional<z.ZodNumber>;
+    complete: z.ZodOptional<z.ZodBoolean>;
+    awaitingRetirementEvidence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AtlasJobStatusInput = z.infer<typeof AtlasJobStatusInputSchema>;
+export type AtlasJobStatusOutput = z.infer<typeof AtlasJobStatusOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/code-atlas/tools/index-management/job-status/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/job-status/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAIvB;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;6BAOxC,CAAC;AAwBH,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/code-atlas/tools/index-management/job-status/schemas.js

@@ -0,0 +1,55 @@
+import z from 'zod/v4';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { JobExecutionClaimSchema, JobExecutionOwnershipSchema } from '@vibesdotdev/workers/core/schemas';
+/**
+ * The queue owner's execution claim as a tool shows it, from the owner's own
+ * schemas. A held claim's `token` is its write capability and is never projected.
+ */
+export const ProjectedExecutionClaimSchema = z.discriminatedUnion('state', [
+    z.object({ state: JobExecutionOwnershipSchema.extract(['none']) }),
+    z.object({ state: JobExecutionOwnershipSchema.extract(['unknown']) }),
+    JobExecutionClaimSchema.unwrap().omit({ token: true }).extend({
+        state: JobExecutionOwnershipSchema.extract(['held']),
+        heartbeatAt: z.string()
+    })
+]);
+const jobInfoSchema = z.object({
+    id: z.string(),
+    status: z.string(),
+    progress: z.number().optional(),
+    createdAt: z.string(),
+    startedAt: z.string().optional(),
+    completedAt: z.string().optional(),
+    attempts: z.number().optional(),
+    projectId: z.string().optional(),
+    data: JsonObjectSchema.optional(),
+    result: z.unknown().optional(),
+    error: z.string().optional(),
+    /** The owner's admission count and logical mutation order. */
+    generation: z.number().int().nonnegative(),
+    revision: z.number().int().nonnegative(),
+    executionClaim: ProjectedExecutionClaimSchema,
+    /** Why a job its status calls pending is not runnable yet, when that is so. */
+    note: z.string().optional()
+});
+// NOTE: jobId/projectId requirement is enforced in the consumer impl.
+// .refine() breaks z.toJSONSchema() used by MCP tool registration.
+export const AtlasJobStatusInputSchema = z.object({
+    jobId: z.string().optional(),
+    projectId: z.string().optional(),
+    queueName: z.string().optional(),
+    status: z.enum(['pending', 'processing', 'completed', 'failed']).optional(),
+    limit: z.number().int().positive().max(50).optional()
+});
+export const AtlasJobStatusOutputSchema = z.object({
+    summary: z.string(),
+    job: jobInfoSchema.optional(),
+    jobs: z.array(jobInfoSchema).optional(),
+    /** Jobs read from the queue to answer a listing. */
+    scanned: z.number().int().nonnegative().optional(),
+    /** The listing read the whole queue; when false, older jobs were not read and "none found" is not claimed. */
+    complete: z.boolean().optional(),
+    /** Listed pending jobs whose execution owner is unknown: not runnable until retirement evidence settles it. */
+    awaitingRetirementEvidence: z.number().int().nonnegative().optional()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/code-atlas/tools/index-management/job-status/schemas.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/list/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE9E,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsD/B"}

package/dist/code-atlas/tools/index-management/list/implementation.js

@@ -0,0 +1,48 @@
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem';
+import { resolveAtlasProjectId, withAtlasStorage } from "../../helpers.js";
+export async function atlasIndexList(runtime, _input) {
+    const workspacePath = await runtime.context('runtime/workspace-path');
+    const { projectId, workspaceRoot } = await resolveAtlasProjectId(runtime, undefined, workspacePath);
+    const atlasDir = `${workspaceRoot}/.vibes/atlas`;
+    const filesystem = await resolveFileSystemAdapter(runtime, { binding: false });
+    if (!(await filesystem.exists(atlasDir))) {
+        return {
+            indexes: [],
+            summary: `No Atlas index found for bound project ${projectId}.`
+        };
+    }
+    const dbFiles = (await filesystem.list(atlasDir)).map((entry) => entry.name).filter((file) => file.endsWith('.db'));
+    const canonicalDb = `${projectId}.db`;
+    const legacyCount = dbFiles.filter((file) => file !== canonicalDb).length;
+    const legacyNote = legacyCount > 0
+        ? ` Ignored ${legacyCount} noncanonical database(s); run index create to rebuild under the checkout ProjectRef.`
+        : '';
+    if (!dbFiles.includes(canonicalDb)) {
+        return {
+            indexes: [],
+            summary: `No Atlas index found for bound project ${projectId}.${legacyNote}`
+        };
+    }
+    const info = await withAtlasStorage(runtime, projectId, async (storage) => {
+        const config = await storage.getConfigByProject(projectId);
+        if (!config)
+            return null;
+        const runs = await storage.getRunsByConfig(config.id, 1);
+        const latestRun = runs[0];
+        return {
+            projectId,
+            configId: config.id,
+            latestRunId: latestRun?.id,
+            filesProcessed: latestRun?.filesProcessed ?? undefined,
+            symbolsCaptured: latestRun?.symbolsCaptured ?? undefined,
+            completedAt: latestRun?.completedAt ? latestRun.completedAt.toISOString() : undefined
+        };
+    }, workspaceRoot);
+    return {
+        indexes: info ? [info] : [],
+        summary: info
+            ? `Found 1 index.${legacyNote}`
+            : `No Atlas index found for bound project ${projectId}.${legacyNote}`
+    };
+}
+//# sourceMappingURL=implementation.js.map

package/dist/code-atlas/tools/index-management/list/implementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/list/implementation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAqB,EACrB,MAA2B;IAE3B,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC;IAC9E,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,GAAG,aAAa,eAAe,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO;YACN,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,0CAA0C,SAAS,GAAG;SAC/D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACpH,MAAM,WAAW,GAAG,GAAG,SAAS,KAAK,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC1E,MAAM,UAAU,GACf,WAAW,GAAG,CAAC;QACd,CAAC,CAAC,YAAY,WAAW,uFAAuF;QAChH,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,OAAO;YACN,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,0CAA0C,SAAS,IAAI,UAAU,EAAE;SAC5E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAClC,OAAO,EACP,SAAS,EACT,KAAK,EAAE,OAAO,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO;YACN,SAAS;YACT,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,SAAS,EAAE,EAAE;YAC1B,cAAc,EAAE,SAAS,EAAE,cAAc,IAAI,SAAS;YACtD,eAAe,EAAE,SAAS,EAAE,eAAe,IAAI,SAAS;YACxD,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;SACrF,CAAC;IACH,CAAC,EACD,aAAa,CACb,CAAC;IAEF,OAAO;QACN,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QAC3B,OAAO,EAAE,IAAI;YACZ,CAAC,CAAC,iBAAiB,UAAU,EAAE;YAC/B,CAAC,CAAC,0CAA0C,SAAS,IAAI,UAAU,EAAE;KACtE,CAAC;AACH,CAAC"}

package/dist/code-atlas/tools/index-management/list/schemas.d.ts

@@ -0,0 +1,16 @@
+import z from 'zod/v4';
+export declare const AtlasIndexListInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const AtlasIndexListOutputSchema: z.ZodObject<{
+    indexes: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        configId: z.ZodString;
+        latestRunId: z.ZodOptional<z.ZodString>;
+        filesProcessed: z.ZodOptional<z.ZodNumber>;
+        symbolsCaptured: z.ZodOptional<z.ZodNumber>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodString;
+}, z.core.$strip>;
+export type AtlasIndexListInput = z.infer<typeof AtlasIndexListInputSchema>;
+export type AtlasIndexListOutput = z.infer<typeof AtlasIndexListOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/code-atlas/tools/index-management/list/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/list/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,eAAO,MAAM,yBAAyB,gCAAe,CAAC;AAEtD,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAYrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/code-atlas/tools/index-management/list/schemas.js

@@ -0,0 +1,14 @@
+import z from 'zod/v4';
+export const AtlasIndexListInputSchema = z.object({});
+export const AtlasIndexListOutputSchema = z.object({
+    indexes: z.array(z.object({
+        projectId: z.string(),
+        configId: z.string(),
+        latestRunId: z.string().optional(),
+        filesProcessed: z.number().optional(),
+        symbolsCaptured: z.number().optional(),
+        completedAt: z.string().optional()
+    })),
+    summary: z.string()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/code-atlas/tools/index-management/list/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/list/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACR,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC,CACF;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/status/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAElF,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,qBAAqB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAsFjC"}

package/dist/code-atlas/tools/index-management/status/implementation.js

@@ -0,0 +1,70 @@
+import { resolveAtlasProjectId, withAtlasStorage } from "../../helpers.js";
+export async function atlasIndexStatus(runtime, input) {
+    const workspacePath = await runtime.context('runtime/workspace-path');
+    const { projectId, alias: resolvedFromAlias } = await resolveAtlasProjectId(runtime, input.projectId, workspacePath);
+    const payload = await withAtlasStorage(runtime, projectId, async (storage) => {
+        const config = await storage.getConfigByProject(projectId);
+        if (!config) {
+            return {
+                projectId,
+                exists: false,
+                summary: `No code index found for project "${projectId}"${resolvedFromAlias ? ` (from alias ${resolvedFromAlias})` : ''}.`
+            };
+        }
+        const [runs, corpusFiles, corpusSymbols] = await Promise.all([
+            storage.getRunsByConfig(config.id, 1),
+            storage.countFiles(config.id),
+            storage.countSymbols(config.id)
+        ]);
+        const latest = runs[0];
+        const latestRunCompletedAt = latest?.completedAt instanceof Date
+            ? latest.completedAt.toISOString()
+            : (latest?.completedAt ?? undefined);
+        const emptyIndexInjury = latest &&
+            latest.filesProcessed === 0 &&
+            corpusFiles === 0 &&
+            (latest.status === 'completed' || latest.status === 'failed')
+            ? {
+                code: 'atlas.empty-index',
+                filesProcessed: 0,
+                corpusFiles: 0,
+                message: 'Atlas matched index configuration but has no persisted files. Run a full index with --force and inspect the latest run errors.'
+            }
+            : undefined;
+        const aliasSuffix = resolvedFromAlias ? ` (from alias ${resolvedFromAlias})` : '';
+        const { atlasFreshnessOf } = await import('@vibesdotdev/workspace/codegraph/startup/freshness');
+        const freshness = atlasFreshnessOf(runtime)?.state();
+        return {
+            projectId,
+            exists: true,
+            configId: config.id,
+            latestRunId: latest?.id,
+            filesProcessed: latest?.filesProcessed ?? 0,
+            symbolsCaptured: latest?.symbolsCaptured ?? 0,
+            lastRunCompletedAt: latestRunCompletedAt,
+            corpusFiles,
+            corpusSymbols,
+            latestRun: latest
+                ? {
+                    id: latest.id,
+                    status: latest.status,
+                    filesProcessed: latest.filesProcessed,
+                    symbolsCaptured: latest.symbolsCaptured,
+                    completedAt: latestRunCompletedAt,
+                    errors: latest.errors
+                }
+                : undefined,
+            emptyIndexInjury,
+            freshness,
+            summary: emptyIndexInjury
+                ? `WARNING: ${emptyIndexInjury.message} Corpus ${corpusFiles} files / latest run delta ${latest?.filesProcessed ?? 0} files${aliasSuffix}.`
+                : latest?.status === 'failed'
+                    ? `WARNING: latest run failed; corpus ${corpusFiles} files / latest run delta ${latest.filesProcessed} files (${corpusSymbols} symbols / ${latest.symbolsCaptured} symbols)${aliasSuffix}.`
+                    : latest
+                        ? `Index corpus ${corpusFiles} files / latest run delta ${latest.filesProcessed} files (${corpusSymbols} symbols / ${latest.symbolsCaptured} symbols)${aliasSuffix}.`
+                        : `Index configuration exists but no runs have completed yet; corpus ${corpusFiles} files${aliasSuffix}.`
+        };
+    }, workspacePath);
+    return payload;
+}
+//# sourceMappingURL=implementation.js.map

package/dist/code-atlas/tools/index-management/status/implementation.js.map

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

package/dist/code-atlas/tools/index-management/status/schemas.d.ts

@@ -0,0 +1,44 @@
+import z from 'zod/v4';
+export declare const AtlasIndexStatusInputSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AtlasIndexStatusOutputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    exists: z.ZodBoolean;
+    configId: z.ZodOptional<z.ZodString>;
+    latestRunId: z.ZodOptional<z.ZodString>;
+    filesProcessed: z.ZodOptional<z.ZodNumber>;
+    symbolsCaptured: z.ZodOptional<z.ZodNumber>;
+    lastRunCompletedAt: z.ZodOptional<z.ZodString>;
+    corpusFiles: z.ZodOptional<z.ZodNumber>;
+    corpusSymbols: z.ZodOptional<z.ZodNumber>;
+    latestRun: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+            completed: "completed";
+        }>;
+        filesProcessed: z.ZodNumber;
+        symbolsCaptured: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodString>;
+        errors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    emptyIndexInjury: z.ZodOptional<z.ZodObject<{
+        code: z.ZodLiteral<"atlas.empty-index">;
+        filesProcessed: z.ZodLiteral<0>;
+        corpusFiles: z.ZodLiteral<0>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    freshness: z.ZodOptional<z.ZodObject<{
+        pendingChanges: z.ZodNumber;
+        lastEnqueuedAt: z.ZodNullable<z.ZodString>;
+        lastJobId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodString;
+}, z.core.$strip>;
+export type AtlasIndexStatusInput = z.infer<typeof AtlasIndexStatusInputSchema>;
+export type AtlasIndexStatusOutput = z.infer<typeof AtlasIndexStatusOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/code-atlas/tools/index-management/status/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/status/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,eAAO,MAAM,2BAA2B;;iBAEtC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCvC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/code-atlas/tools/index-management/status/schemas.js

@@ -0,0 +1,45 @@
+import z from 'zod/v4';
+export const AtlasIndexStatusInputSchema = z.object({
+    projectId: z.string().optional()
+});
+export const AtlasIndexStatusOutputSchema = z.object({
+    projectId: z.string(),
+    exists: z.boolean(),
+    configId: z.string().optional(),
+    // Compatibility fields report the newest run's delta.
+    latestRunId: z.string().optional(),
+    filesProcessed: z.number().optional(),
+    symbolsCaptured: z.number().optional(),
+    lastRunCompletedAt: z.string().optional(),
+    // Corpus totals are deduplicated persistent storage counts.
+    corpusFiles: z.number().optional(),
+    corpusSymbols: z.number().optional(),
+    latestRun: z
+        .object({
+        id: z.string(),
+        status: z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']),
+        filesProcessed: z.number(),
+        symbolsCaptured: z.number(),
+        completedAt: z.string().optional(),
+        errors: z.array(z.string())
+    })
+        .optional(),
+    emptyIndexInjury: z
+        .object({
+        code: z.literal('atlas.empty-index'),
+        filesProcessed: z.literal(0),
+        corpusFiles: z.literal(0),
+        message: z.string()
+    })
+        .optional(),
+    /** Live freshness on this runtime: changes waiting for the next incremental run, and the last enqueue. */
+    freshness: z
+        .object({
+        pendingChanges: z.number().int().nonnegative(),
+        lastEnqueuedAt: z.string().nullable(),
+        lastJobId: z.string().nullable()
+    })
+        .optional(),
+    summary: z.string()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/code-atlas/tools/index-management/status/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/status/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,sDAAsD;IACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,4DAA4D;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC;SACV,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC3B,CAAC;SACD,QAAQ,EAAE;IACZ,gBAAgB,EAAE,CAAC;SACjB,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACpC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5B,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;SACD,QAAQ,EAAE;IACZ,0GAA0G;IAC1G,SAAS,EAAE,CAAC;SACV,MAAM,CAAC;QACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC9C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;SACD,QAAQ,EAAE;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../../src/code-atlas/tools/index-management/update/implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAElF,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,qBAAqB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAiHjC"}