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

package/dist/execution-schemas.d.ts.map

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

package/dist/execution-schemas.js

@@ -0,0 +1,102 @@
+/** Neutral persisted graph results; scheduling remains owned by Runbooks and Workers. */
+import * as z from 'zod/v4';
+import { JsonValueSchema, JsonObjectSchema, keyedRecordSchema } from '@vibesdotdev/kernel/schemas/json';
+import { FailureFactsSchema, OutcomeSchema } from '@vibesdotdev/runnable/schemas/outcome';
+import { RunnableAttemptSchema as TraversalAttemptSchema } from '@vibesdotdev/runnable/schemas/runs';
+import { GraphNodeSchema } from "./graph-schemas.js";
+export const GraphPlanSchema = z.object({
+    /** Tiers in execution order; each tier lists cohorts, each cohort lists node ids. */
+    tiers: z.array(z.array(z.array(z.string()))),
+    /** Cohorts of more than one node: the graph's real cycles. */
+    cycles: z.array(z.array(z.string()))
+});
+export const NodeOutcomeSchema = z.object({
+    id: z.string(),
+    tier: z.number().int().nonnegative(),
+    status: z.enum(['succeeded', 'failed', 'skipped']),
+    output: JsonValueSchema.optional(),
+    /** Value-free failure facts for a failed node; the blocking dependency for a skipped one. */
+    failure: JsonValueSchema.optional(),
+    blockedBy: z.array(z.string()).optional(),
+    /** The top-level node an expanded nested node belongs to. */
+    parent: z.string().optional()
+});
+/** A failed node's recorded facts: a typed refusal's code, reason, message and details, or a failure's value-free name. */
+export const NodeFailureFactsSchema = z.object({
+    name: z.string(),
+    code: z.string().optional(),
+    reason: z.string().optional(),
+    message: z.string().optional(),
+    details: JsonValueSchema.optional()
+});
+export const GraphExecutionSchema = z.object({
+    plan: GraphPlanSchema,
+    outcomes: z.array(NodeOutcomeSchema),
+    /** What the after-tier hook reported after each tier it ran on, in tier order. */
+    tierReports: z.array(JsonValueSchema).default([]),
+    /** The after-tier hook stopped the run; the nodes after it were skipped. */
+    stopped: z.boolean().default(false)
+});
+/** What graph-execute hands its after-tier hook. */
+export const TierHookInputSchema = z.object({
+    tier: z.number().int().nonnegative(),
+    /** The tier's nodes (with their data), in run order. */
+    nodes: z.array(z.object({ id: z.string(), data: JsonValueSchema.optional() })),
+    outcomes: z.array(NodeOutcomeSchema),
+    /** Earlier nodes and outcomes, so a parent coordinator can rework an unresolved earlier failure. */
+    previous: z.object({
+        nodes: z.array(z.object({ id: z.string(), data: JsonValueSchema.optional() })),
+        outcomes: z.array(NodeOutcomeSchema)
+    }).default({ nodes: [], outcomes: [] }),
+    /** The hook's own reports from earlier tiers. */
+    reports: z.array(JsonValueSchema),
+    input: JsonValueSchema.nullable()
+});
+/** What an after-tier hook returns: the tier's outcomes (replacing those it ran with), whether to stop, a report to keep. */
+export const TierHookResultSchema = z.object({
+    outcomes: z.array(NodeOutcomeSchema),
+    /** Reworked earlier failed nodes only; ids and original tiers are validated by graph-execute. */
+    updates: z.array(NodeOutcomeSchema).default([]),
+    stop: z.boolean().default(false),
+    report: JsonValueSchema.optional()
+});
+export const GraphSummarySchema = z.object({
+    total: z.number().int(),
+    succeeded: z.number().int(),
+    failed: z.number().int(),
+    skipped: z.number().int(),
+    tiers: z.number().int(),
+    cycles: z.array(z.array(z.string())),
+    failedNodes: z.array(z.string()),
+    skippedNodes: z.array(z.string())
+});
+/** Runnable visit results, distinct from legacy GraphExecution's transport result array. */
+export { TraversalAttemptSchema };
+export const TraversalExecutionSchema = z.object({
+    outcomes: keyedRecordSchema(OutcomeSchema),
+    tiers: z.array(z.array(z.string())),
+    blockedBy: keyedRecordSchema(z.array(z.string())),
+    coordination: OutcomeSchema.optional(),
+    /** Native execution/admission failures remain separate from semantic truth and review feedback. */
+    failures: keyedRecordSchema(FailureFactsSchema).default({}),
+    attempts: keyedRecordSchema(z.array(TraversalAttemptSchema)).default({}),
+    reports: z.array(JsonValueSchema)
+});
+export const TierInputSchema = z.object({
+    step: z.number().int().nonnegative(),
+    ids: z.array(z.string()),
+    nodes: z.array(GraphNodeSchema),
+    outcomes: keyedRecordSchema(OutcomeSchema),
+    failures: keyedRecordSchema(FailureFactsSchema).default({}),
+    attempts: keyedRecordSchema(z.array(TraversalAttemptSchema)).default({}),
+    waitedOn: keyedRecordSchema(keyedRecordSchema(OutcomeSchema)),
+    previous: z.object({ nodes: z.array(GraphNodeSchema), outcomes: keyedRecordSchema(OutcomeSchema) }),
+    reports: z.array(JsonValueSchema)
+});
+export const TierResultSchema = z.object({
+    next: z.enum(['continue', 'stop']),
+    outcomes: keyedRecordSchema(OutcomeSchema),
+    rework: z.array(z.object({ id: z.string().min(1), input: JsonObjectSchema, reason: z.string().min(1) })).optional(),
+    report: JsonValueSchema.optional()
+});
+//# sourceMappingURL=execution-schemas.js.map

package/dist/execution-schemas.js.map

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

package/dist/graph-schemas.d.ts

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+export declare const GraphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strip>;
+export type GraphNode = z.infer<typeof GraphNodeSchema>;
+export declare const GraphSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Graph = z.infer<typeof GraphSchema>;
+export type GraphInput = z.input<typeof GraphSchema>;
+//# sourceMappingURL=graph-schemas.d.ts.map

package/dist/graph-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.d.ts","sourceRoot":"","sources":["../src/graph-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,eAAO,MAAM,WAAW;;;;;;iBAAgD,CAAC;AACzE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/graph-schemas.js

@@ -0,0 +1,9 @@
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+export const GraphNodeSchema = z.object({
+    id: z.string().min(1),
+    dependsOn: z.array(z.string().min(1)).default([]),
+    data: JsonValueSchema.optional()
+});
+export const GraphSchema = z.object({ nodes: z.array(GraphNodeSchema) });
+//# sourceMappingURL=graph-schemas.js.map

package/dist/graph-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.js","sourceRoot":"","sources":["../src/graph-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './schemas.ts';
+export { strategyKind } from './strategies.ts';
+export { default as plugin } from './plugin.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./schemas.js";
+export { strategyKind } from "./strategies.js";
+export { default as plugin } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+declare const plugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,MAAM,6CAYV,CAAC;AACH,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,23 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { strategyKind } from "./strategies.js";
+const descriptors = [
+    { kind: 'traversal/strategy', id: 'traversal.package-graph', source: 'package-graph' },
+    { kind: 'traversal/strategy', id: 'traversal.file-graph', source: 'file-graph' },
+    { kind: 'traversal/strategy', id: 'traversal.findings', source: 'findings' },
+    { kind: 'traversal/strategy', id: 'traversal.list', source: 'list' }
+];
+const plugin = createRuntimePlugin({
+    id: 'traversal',
+    name: 'Traversal graph strategies',
+    description: 'Build package, file, finding and list graphs; execution stays with Runbooks and Workers.',
+    kinds: [strategyKind],
+    descriptors,
+    loaders: [
+        loader('traversal.package-graph', { kind: 'traversal/strategy' }, async () => ({ impl: (await import("./strategies.js")).PackageGraphStrategy })),
+        loader('traversal.file-graph', { kind: 'traversal/strategy' }, async () => ({ impl: (await import("./strategies.js")).FileGraphStrategy })),
+        loader('traversal.findings', { kind: 'traversal/strategy' }, async () => ({ impl: (await import("./strategies.js")).FindingsStrategy })),
+        loader('traversal.list', { kind: 'traversal/strategy' }, async () => ({ impl: (await import("./strategies.js")).ListStrategy }))
+    ]
+});
+export default plugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,GAAyB;IACzC,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,yBAAyB,EAAE,MAAM,EAAE,eAAe,EAAE;IACtF,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,YAAY,EAAE;IAChF,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE;CACpE,CAAC;AAEF,MAAM,MAAM,GAAG,mBAAmB,CAAC;IAClC,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,0FAA0F;IACvG,KAAK,EAAE,CAAC,YAAY,CAAC;IACrB,WAAW;IACX,OAAO,EAAE;QACR,MAAM,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACjJ,MAAM,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC3I,MAAM,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACxI,MAAM,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;KAChI;CACD,CAAC,CAAC;AACH,eAAe,MAAM,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,60 @@
+import * as z from 'zod/v4';
+export { GraphNodeSchema, GraphSchema, type GraphNode, type Graph, type GraphInput } from './graph-schemas.ts';
+import type { Graph } from './graph-schemas.ts';
+export declare const TraversalSourceKindSchema: z.ZodEnum<{
+    list: "list";
+    "package-graph": "package-graph";
+    "file-graph": "file-graph";
+    findings: "findings";
+}>;
+export type TraversalSourceKind = z.infer<typeof TraversalSourceKindSchema>;
+export declare const StrategyDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"traversal/strategy">;
+    source: z.ZodEnum<{
+        list: "list";
+        "package-graph": "package-graph";
+        "file-graph": "file-graph";
+        findings: "findings";
+    }>;
+}, z.core.$strip>;
+export type StrategyDescriptor = z.infer<typeof StrategyDescriptorSchema>;
+/** Callbacks stay inside the caller; only the built JSON graph crosses job boundaries. */
+export interface TraversalSource<T> {
+    kind: TraversalSourceKind;
+    /** Source-owner label recorded with the initial plan, independent of strategy selection. */
+    name?: string;
+    items(): T[] | Promise<T[]>;
+    id(item: T): string;
+    dependsOn?(item: T): string[];
+}
+export interface StrategyImplementation {
+    build<T>(source: TraversalSource<T>): Promise<Graph>;
+}
+declare module '@vibesdotdev/kernel/schemas/asset' {
+    interface RuntimeAssetSchemaRegistry {
+        'traversal/strategy': StrategyDescriptor;
+    }
+}
+export * from './execution-schemas.ts';
+export * from './tracking-schemas.ts';
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,eAAO,MAAM,yBAAyB;;;;;EAA8D,CAAC;AACrG,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,0FAA0F;AAC1F,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACpB,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;CAC9B;AACD,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACrD;AAED,OAAO,QAAQ,mCAAmC,CAAC;IAClD,UAAU,0BAA0B;QACnC,oBAAoB,EAAE,kBAAkB,CAAC;KACzC;CACD;AAED,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,11 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+export { GraphNodeSchema, GraphSchema } from "./graph-schemas.js";
+export const TraversalSourceKindSchema = z.enum(['package-graph', 'file-graph', 'findings', 'list']);
+export const StrategyDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('traversal/strategy'),
+    source: TraversalSourceKindSchema
+});
+export * from "./execution-schemas.js";
+export * from "./tracking-schemas.js";
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,WAAW,EAA+C,MAAM,oBAAoB,CAAC;AAG/G,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,MAAM,EAAE,yBAAyB;CACjC,CAAC,CAAC;AAsBH,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/strategies.d.ts

@@ -0,0 +1,16 @@
+import { type RuntimeKindDescriptorRecord } from '@vibesdotdev/kernel';
+import { type Graph, type StrategyImplementation, type TraversalSource } from './schemas.ts';
+export declare class PackageGraphStrategy implements StrategyImplementation {
+    build<T>(source: TraversalSource<T>): Promise<Graph>;
+}
+export declare class FileGraphStrategy implements StrategyImplementation {
+    build<T>(source: TraversalSource<T>): Promise<Graph>;
+}
+export declare class ListStrategy implements StrategyImplementation {
+    build<T>(source: TraversalSource<T>): Promise<Graph>;
+}
+export declare class FindingsStrategy implements StrategyImplementation {
+    build<T>(source: TraversalSource<T>): Promise<Graph>;
+}
+export declare const strategyKind: RuntimeKindDescriptorRecord<StrategyImplementation>;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../src/strategies.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,EAAyC,KAAK,KAAK,EAAkB,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAA4B,MAAM,cAAc,CAAC;AAyB9K,qBAAa,oBAAqB,YAAW,sBAAsB;IAC5D,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;CAI1D;AAED,qBAAa,iBAAkB,YAAW,sBAAsB;IACzD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;CAI1D;AAED,qBAAa,YAAa,YAAW,sBAAsB;IACpD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;CAI1D;AAKD,qBAAa,gBAAiB,YAAW,sBAAsB;IACxD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;CAqB1D;AAQD,eAAO,MAAM,YAAY,EAAE,2BAA2B,CAAC,sBAAsB,CAE5E,CAAC"}

package/dist/strategies.js

@@ -0,0 +1,76 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { DagInputSchema, patternsOverlap } from '@vibesdotdev/shared/schemas';
+import { GraphSchema, StrategyDescriptorSchema } from "./schemas.js";
+function requireSource(source, kind) {
+    if (source.kind !== kind) {
+        throw new CapabilityError('The traversal strategy does not support this source.', 'INVALID_INPUT', {
+            reason: 'traversal-source-mismatch', details: { expected: kind, received: source.kind }
+        });
+    }
+}
+function validateGraph(nodes) {
+    const graph = GraphSchema.parse({ nodes });
+    DagInputSchema.parse(graph);
+    return graph;
+}
+async function graphOf(source, dependencies) {
+    const items = await source.items();
+    return validateGraph(items.map((item) => ({
+        id: source.id(item),
+        dependsOn: dependencies ? source.dependsOn?.(item) ?? [] : [],
+        data: JsonValueSchema.parse(item)
+    })));
+}
+export class PackageGraphStrategy {
+    async build(source) {
+        requireSource(source, 'package-graph');
+        return graphOf(source, true);
+    }
+}
+export class FileGraphStrategy {
+    async build(source) {
+        requireSource(source, 'file-graph');
+        return graphOf(source, true);
+    }
+}
+export class ListStrategy {
+    async build(source) {
+        requireSource(source, 'list');
+        return graphOf(source, false);
+    }
+}
+/** Rule owners may add fields; grouping preserves the complete JSON finding. */
+const FindingSchema = z.object({ rule: z.string().min(1), file: z.string().optional() }).loose();
+export class FindingsStrategy {
+    async build(source) {
+        requireSource(source, 'findings');
+        const groups = new Map();
+        for (const item of await source.items()) {
+            const value = JsonValueSchema.parse(item);
+            const finding = FindingSchema.parse(value);
+            const group = groups.get(finding.rule) ?? { files: [], findings: [] };
+            group.files.push(finding.file);
+            group.findings.push(value);
+            groups.set(finding.rule, group);
+        }
+        const rules = [...groups.keys()].sort();
+        const overlaps = (left, right) => groups.get(left).files.some((first) => groups.get(right).files.some((second) => first === undefined || second === undefined || patternsOverlap(first, second)));
+        return validateGraph(rules.map((rule, index) => ({
+            id: rule,
+            dependsOn: rules.slice(0, index).filter((previous) => overlaps(previous, rule)),
+            data: { rule, findings: groups.get(rule).findings }
+        })));
+    }
+}
+/** A missing implementation is a refusal; each shipped strategy has its own owner loader. */
+class UnimplementedStrategy {
+    async build(_source) {
+        throw new CapabilityError('Traversal strategy has no registered implementation.', 'UNAVAILABLE', { reason: 'traversal-strategy-unimplemented' });
+    }
+}
+export const strategyKind = {
+    id: 'traversal/strategy', descriptorSchema: StrategyDescriptorSchema, defaultImplementation: UnimplementedStrategy
+};
+//# sourceMappingURL=strategies.js.map

package/dist/strategies.js.map

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

package/dist/svelte/GraphRunSection.svelte

@@ -0,0 +1,56 @@
+<script lang="ts">
+	import { CapabilityError, CaughtFailureSchema, settle, settleNow } from '@vibesdotdev/kernel';
+	import { Alert, AlertTitle, AlertDescription } from '@vibesdotdev/kit/components/ui/alert';
+	import type { RunsStore } from '@vibesdotdev/runnable/svelte';
+	import type { RunnableWatchSnapshot } from '@vibesdotdev/runnable';
+	import { followTraversalRecords, selectedTraversalRunId, selectedTraversalViews } from '../tracking/selected-traversal.js';
+	import GraphRunView from './GraphRunView.svelte';
+
+	let { store }: { store: RunsStore } = $props();
+	let subtree = $state.raw<{ id: string; snapshot: RunnableWatchSnapshot } | null>(null);
+	let readFailure = $state.raw<unknown>(null);
+	let loading = $state(false);
+	let readGeneration = 0;
+	const graphRunId = $derived(selectedTraversalRunId(store.selected));
+
+	$effect(() => {
+		const source = store.source;
+		const id = graphRunId;
+		const generation = ++readGeneration;
+		subtree = null;
+		readFailure = null;
+		loading = false;
+		if (store.projection === 'records' || id === null) return;
+
+		loading = true;
+		const stop = followTraversalRecords(source, id, snapshot => {
+			subtree = { id, snapshot };
+			loading = false;
+		}, cause => {
+			readFailure = cause;
+			loading = false;
+		});
+		return () => {
+			void stop().catch(cause => {
+				if (readGeneration === generation && store.selectedId === id) readFailure = cause;
+			});
+		};
+	});
+
+	const records = $derived(store.projection === 'records' ? store.snapshot
+		: subtree?.id === store.selectedId ? subtree.snapshot : null);
+	const projection = $derived.by(() => settleNow(() => selectedTraversalViews(store.selected, records)));
+	const failure = $derived(readFailure !== null ? CapabilityError.from(CaughtFailureSchema.parse(readFailure))
+		: projection.ok ? null : CapabilityError.from(CaughtFailureSchema.parse(projection.cause)));
+
+	async function select(id: string) {
+		// RunsStore retains admission errors under its own selection generation.
+		await settle(() => store.select(id));
+	}
+</script>
+
+{#if failure}
+	<Alert variant="destructive"><AlertTitle>{failure.message}</AlertTitle><AlertDescription><code>{failure.code}</code> {failure.reason ?? ''}</AlertDescription></Alert>
+{:else if loading}<p role="status">Loading recorded graph visits…</p>
+{:else if projection.ok}<GraphRunView traversals={projection.value} onselect={select} />
+{/if}

package/dist/svelte/GraphRunSection.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { RunsStore } from '@vibesdotdev/runnable/svelte';
+type $$ComponentProps = {
+    store: RunsStore;
+};
+declare const GraphRunSection: import("svelte").Component<$$ComponentProps, {}, "">;
+type GraphRunSection = ReturnType<typeof GraphRunSection>;
+export default GraphRunSection;
+//# sourceMappingURL=GraphRunSection.svelte.d.ts.map

package/dist/svelte/GraphRunSection.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphRunSection.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/GraphRunSection.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK7D,KAAK,gBAAgB,GAAI;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AA4D/C,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}