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

package/dist/tracking/traversal-view.js

@@ -0,0 +1,253 @@
+/**
+ * Recorded traversal views, one per traversalId.
+ * Missing runs stay unobserved. Plan revisions and physical records stay.
+ * Encounter order is kept. Time is not authority, and step is not an attempt.
+ */
+import { ArtifactDataEncodingSchema } from '@vibesdotdev/runnable/events';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { JsonObjectSchema, JsonValueSchema, JsonValueFromReaderSchema } from '@vibesdotdev/kernel/schemas/json';
+import { TRAVERSAL_PLAN_ARTIFACT, TRAVERSAL_EXECUTION_ARTIFACT, TraversalPlanSchema, TraversalExecutionSchema, VisitStampSchema } from '@vibesdotdev/traversal/schemas';
+function refuse(reason, message) {
+    throw new CapabilityError(message, 'INVALID_INPUT', { reason: `traversal-view-${reason}` });
+}
+function refOf(run) {
+    return { id: run.id, runnableId: run.runnableId, status: run.status, parentRunId: run.parentRunId, outcome: run.outcome, ref: run.ref };
+}
+function isCoordinator(stamp) {
+    return 'between' in stamp && stamp.between === true;
+}
+function semanticKey(stamp) {
+    return isCoordinator(stamp)
+        ? JSON.stringify([stamp.traversalId, stamp.planRevision, stamp.step, stamp.coordinationOrdinal])
+        : JSON.stringify([stamp.traversalId, stamp.planRevision, stamp.step, stamp.id, stamp.revision, stamp.attempt]);
+}
+function collides(records) {
+    const seen = new Map();
+    return records.some((record) => {
+        const prior = seen.get(semanticKey(record.stamp));
+        seen.set(semanticKey(record.stamp), record.run.id);
+        return prior !== undefined && prior !== record.run.id;
+    });
+}
+function preferred(records) {
+    let chosen;
+    for (const record of records) {
+        if (isCoordinator(record.stamp))
+            continue;
+        if (!chosen || isCoordinator(chosen.stamp)) {
+            chosen = record;
+            continue;
+        }
+        const next = record.stamp;
+        const prior = chosen.stamp;
+        if (next.revision > prior.revision || (next.revision === prior.revision && next.attempt > prior.attempt))
+            chosen = record;
+    }
+    return chosen;
+}
+function orderedObject(_key, value) {
+    const object = JsonObjectSchema.safeParse(value);
+    if (!object.success)
+        return value;
+    return Object.fromEntries(Object.entries(object.data).sort(([left], [right]) => left.localeCompare(right)));
+}
+function sameJson(left, right) {
+    if (left === right)
+        return true;
+    if (left === undefined || right === undefined)
+        return false;
+    return JSON.stringify(JsonValueFromReaderSchema.parse(left), orderedObject) === JSON.stringify(JsonValueFromReaderSchema.parse(right), orderedObject);
+}
+function observed(records) {
+    const chosen = preferred(records);
+    const outcomes = records.flatMap(record => {
+        if (isCoordinator(record.stamp) || !chosen || isCoordinator(chosen.stamp))
+            return [];
+        if (record.stamp.revision !== chosen.stamp.revision || record.stamp.attempt !== chosen.stamp.attempt)
+            return [];
+        return record.run.outcome === undefined ? [] : [record.run.outcome];
+    });
+    const collision = collides(records) || outcomes.some(outcome => !sameJson(outcome, outcomes[0]));
+    return {
+        observation: records.length === 0 ? 'unobserved' : collision ? 'ambiguous' : 'recorded',
+        outcome: collision ? undefined : outcomes[0]
+    };
+}
+function blockedByOf(outcome) {
+    if (!outcome || outcome.status !== 'skipped' || outcome.cause.kind !== 'dependency')
+        return undefined;
+    return outcome.cause.blockedBy;
+}
+function artifactJson(artifact) {
+    const encoding = ArtifactDataEncodingSchema.safeParse(artifact.metadata?.encoding);
+    if (!encoding.success || artifact.data === undefined)
+        refuse('plan-artifact', `Plan artifact ${artifact.id} has no explicit utf8 or base64 data.`);
+    let text = artifact.data;
+    if (encoding.data === 'base64') {
+        try {
+            text = new TextDecoder('utf8', { fatal: true }).decode(Uint8Array.from(atob(artifact.data), (char) => char.charCodeAt(0)));
+        }
+        catch (cause) {
+            throw new CapabilityError(`Traversal artifact ${artifact.id} is not base64 UTF-8.`, 'INVALID_INPUT', {
+                reason: 'traversal-view-plan-artifact', cause: CaughtFailureSchema.parse(cause)
+            });
+        }
+    }
+    try {
+        return JsonValueSchema.parse(JSON.parse(text));
+    }
+    catch (cause) {
+        throw new CapabilityError(`Traversal artifact ${artifact.id} is not JSON.`, 'INVALID_INPUT', {
+            reason: 'traversal-view-plan-artifact', cause: CaughtFailureSchema.parse(cause)
+        });
+    }
+}
+function readStamp(run) {
+    if (run.metadata.visit === undefined)
+        return undefined;
+    const stamp = VisitStampSchema.safeParse(run.metadata.visit);
+    if (!stamp.success)
+        refuse('visit-stamp', `Run ${run.id} declared a visit stamp that is not a visit.`);
+    return stamp.data;
+}
+function admit(runs, run) {
+    const prior = runs.get(run.id);
+    if (!prior) {
+        runs.set(run.id, run);
+        return;
+    }
+    if (JSON.stringify(prior.metadata.visit) !== JSON.stringify(run.metadata.visit))
+        refuse('visit-stamp', `Run ${run.id} declares two visit stamps.`);
+    if (prior.status !== run.status)
+        refuse('run-record', `Run ${run.id} declares two statuses.`);
+    if (prior.outcome !== undefined && run.outcome !== undefined && JSON.stringify(prior.outcome) !== JSON.stringify(run.outcome))
+        refuse('run-record', `Run ${run.id} declares two outcomes.`);
+    if (prior.ref !== undefined && run.ref !== undefined && JSON.stringify(prior.ref) !== JSON.stringify(run.ref))
+        refuse('run-record', `Run ${run.id} declares two execution references.`);
+    runs.set(run.id, { ...prior, outcome: prior.outcome ?? run.outcome, ref: prior.ref ?? run.ref });
+}
+function nodeViews(plan, visits, execution, executionAmbiguous) {
+    const cohorts = new Map();
+    const steps = new Map();
+    const byId = new Map();
+    for (const cycle of plan.cycles)
+        for (const id of cycle)
+            cohorts.set(id, [...(cohorts.get(id) ?? []), cycle]);
+    for (const step of plan.steps)
+        for (const id of step.ids)
+            steps.set(id, [...(steps.get(id) ?? []), step.index]);
+    for (const visit of visits)
+        if (!isCoordinator(visit.stamp))
+            byId.set(visit.stamp.id, [...(byId.get(visit.stamp.id) ?? []), visit]);
+    const states = new Map();
+    function stateOf(id) {
+        const held = states.get(id);
+        if (held)
+            return held;
+        const visitState = observed(byId.get(id) ?? []);
+        const terminalOutcome = execution?.outcomes[id];
+        const conflict = visitState.observation === 'ambiguous' || (visitState.outcome !== undefined && terminalOutcome !== undefined && !sameJson(visitState.outcome, terminalOutcome));
+        const outcome = terminalOutcome ?? visitState.outcome;
+        const state = executionAmbiguous || conflict
+            ? { observation: 'ambiguous', outcome: undefined }
+            : { observation: outcome ? 'recorded' : visitState.observation, outcome };
+        states.set(id, state);
+        return state;
+    }
+    return plan.nodes.map((node) => {
+        const records = byId.get(node.id) ?? [];
+        const state = stateOf(node.id);
+        const ownCohorts = cohorts.get(node.id) ?? [];
+        return {
+            node, records, ...state, steps: steps.get(node.id) ?? [], cohorts: ownCohorts,
+            blockedBy: state.observation === 'ambiguous' ? undefined : execution?.blockedBy[node.id] ?? blockedByOf(state.outcome),
+            attempts: execution?.attempts[node.id] ?? [], failure: execution?.failures[node.id],
+            dependencies: node.dependsOn.map((id) => ({ id, inCohort: ownCohorts.some((cycle) => cycle.includes(id)), ...stateOf(id) }))
+        };
+    });
+}
+/** Project watch runs, or a snapshot list, into per-traversal views. */
+export function buildTraversalViews(input) {
+    const plans = [];
+    const executions = [];
+    const seenArtifacts = new Map();
+    const runs = new Map();
+    const snapshots = 'revision' in input ? input.runs : input;
+    // A full row is the owner snapshot; embedded child summaries may predate it.
+    for (const snapshot of snapshots)
+        admit(runs, snapshot.run);
+    for (const snapshot of snapshots) {
+        for (const child of snapshot.children)
+            if (!runs.has(child.id))
+                admit(runs, child);
+        for (const artifact of snapshot.artifacts) {
+            if (artifact.artifactKind !== TRAVERSAL_PLAN_ARTIFACT && artifact.artifactKind !== TRAVERSAL_EXECUTION_ARTIFACT)
+                continue;
+            const artifactKey = JSON.stringify([snapshot.run.id, artifact.id]);
+            const body = JSON.stringify([artifact.data, artifact.metadata]);
+            const prior = seenArtifacts.get(artifactKey);
+            if (prior !== undefined && prior !== body)
+                refuse('plan-artifact', `Plan artifact ${artifact.id} declares two bodies.`);
+            if (prior !== undefined)
+                continue;
+            seenArtifacts.set(artifactKey, body);
+            if (artifact.artifactKind === TRAVERSAL_PLAN_ARTIFACT) {
+                plans.push({ plan: TraversalPlanSchema.parse(artifactJson(artifact)), artifactId: artifact.id, owner: refOf(snapshot.run) });
+            }
+            else {
+                const identity = TraversalPlanSchema.pick({ traversalId: true, revision: true }).parse(artifact.metadata);
+                executions.push({ ...identity, execution: TraversalExecutionSchema.parse(artifactJson(artifact)), artifactId: artifact.id, owner: refOf(snapshot.run) });
+            }
+        }
+    }
+    const visits = [];
+    for (const run of runs.values()) {
+        const stamp = readStamp(run);
+        if (stamp)
+            visits.push({ stamp, run: refOf(run) });
+    }
+    const ids = [];
+    for (const id of [...plans.map((plan) => plan.plan.traversalId), ...visits.map((visit) => visit.stamp.traversalId), ...executions.map(item => item.traversalId)]) {
+        if (!ids.includes(id))
+            ids.push(id);
+    }
+    return ids.map((traversalId) => {
+        const ownPlans = plans.filter((plan) => plan.plan.traversalId === traversalId);
+        const revisions = [];
+        for (const plan of ownPlans)
+            if (!revisions.includes(plan.plan.revision))
+                revisions.push(plan.plan.revision);
+        const matched = new Set();
+        const matchedExecutions = new Set();
+        const revisionViews = revisions.map((revision) => {
+            const revisionPlans = ownPlans.filter((plan) => plan.plan.revision === revision);
+            const revisionVisits = visits.filter((visit) => visit.stamp.traversalId === traversalId && visit.stamp.planRevision === revision);
+            for (const visit of revisionVisits)
+                matched.add(visit);
+            const first = revisionPlans[0]?.plan;
+            const agreed = revisionPlans.every((plan) => JSON.stringify(plan.plan) === JSON.stringify(first));
+            const graph = agreed ? first : undefined;
+            const recordedExecutions = executions.filter(item => item.traversalId === traversalId && item.revision === revision);
+            for (const item of recordedExecutions)
+                matchedExecutions.add(item);
+            const firstExecution = recordedExecutions[0]?.execution;
+            const executionAmbiguous = !recordedExecutions.every(item => JSON.stringify(item.execution) === JSON.stringify(firstExecution));
+            const execution = executionAmbiguous ? undefined : firstExecution;
+            return {
+                revision, plans: revisionPlans, planAmbiguous: !agreed, visits: revisionVisits,
+                executions: recordedExecutions, executionAmbiguous,
+                nodes: graph ? nodeViews(graph, revisionVisits, execution, executionAmbiguous) : [],
+                steps: graph ? graph.steps.map((step) => {
+                    const coordinators = revisionVisits.filter((visit) => isCoordinator(visit.stamp) && visit.stamp.step === step.index);
+                    return { step, coordinators, ambiguous: collides(coordinators) };
+                }) : []
+            };
+        });
+        return {
+            traversalId, revisions: revisionViews,
+            unmatched: visits.filter(visit => visit.stamp.traversalId === traversalId && !matched.has(visit)),
+            unmatchedExecutions: executions.filter(item => item.traversalId === traversalId && !matchedExecutions.has(item))
+        };
+    });
+}
+//# sourceMappingURL=traversal-view.js.map

package/dist/tracking/traversal-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal-view.js","sourceRoot":"","sources":["../../src/tracking/traversal-view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAAkB,MAAM,kCAAkC,CAAC;AAEhI,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,gBAAgB,EAAgE,MAAM,gCAAgC,CAAC;AAyDtO,SAAS,MAAM,CAAC,MAAsD,EAAE,OAAe;IACtF,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,kBAAkB,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7F,CAAC;AACD,SAAS,KAAK,CAAC,GAAuB;IACrC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;AACzI,CAAC;AACD,SAAS,aAAa,CAAC,KAAiB;IACvC,OAAO,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;AACrD,CAAC;AACD,SAAS,WAAW,CAAC,KAAiB;IACrC,OAAO,aAAa,CAAC,KAAK,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACjH,CAAC;AACD,SAAS,QAAQ,CAAC,OAA0C;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;AACJ,CAAC;AACD,SAAS,SAAS,CAAC,OAA0C;IAC5D,IAAI,MAA0C,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,MAAM,GAAG,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,IAAI,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAAE,MAAM,GAAG,MAAM,CAAC;IAC3H,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAGD,SAAS,aAAa,CAAC,IAAY,EAAE,KAAgB;IACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,SAAS,QAAQ,CAAC,IAAmC,EAAE,KAAoC;IAC1F,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;AACvJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAA0C;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACzC,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrF,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAChH,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO;QACN,WAAW,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU;QACvF,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC5C,CAAC;AACH,CAAC;AACD,SAAS,WAAW,CAAC,OAAsC;IAC1D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,SAAS,CAAC;IACtG,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;AAChC,CAAC;AACD,SAAS,YAAY,CAAC,QAA0B;IAC/C,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnF,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,QAAQ,CAAC,EAAE,uCAAuC,CAAC,CAAC;IACnJ,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IACzB,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC;YACJ,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5H,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CAAC,sBAAsB,QAAQ,CAAC,EAAE,uBAAuB,EAAE,eAAe,EAAE;gBACpG,MAAM,EAAE,8BAA8B,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC;aAC/E,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,IAAI,CAAC;QACJ,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,sBAAsB,QAAQ,CAAC,EAAE,eAAe,EAAE,eAAe,EAAE;YAC5F,MAAM,EAAE,8BAA8B,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC;SAC/E,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AACD,SAAS,SAAS,CAAC,GAAuB;IACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,CAAC,aAAa,EAAE,OAAO,GAAG,CAAC,EAAE,8CAA8C,CAAC,CAAC;IACvG,OAAO,KAAK,CAAC,IAAI,CAAC;AACnB,CAAC;AACD,SAAS,KAAK,CAAC,IAAqC,EAAE,GAAuB;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,aAAa,EAAE,OAAO,GAAG,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACnJ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAAE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC9F,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC5L,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,CAAC,EAAE,qCAAqC,CAAC,CAAC;IACxL,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;AAClG,CAAC;AACD,SAAS,SAAS,CAAC,IAAmB,EAAE,MAAyC,EAAE,SAAyC,EAAE,kBAA2B;IACxJ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkD,CAAC;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0D,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoC,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;QAAE,KAAK,MAAM,EAAE,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9G,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChH,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACpI,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC5D,SAAS,OAAO,CAAC,EAAU;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,KAAK,WAAW,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACjL,MAAM,OAAO,GAAG,eAAe,IAAI,UAAU,CAAC,OAAO,CAAC;QACtD,MAAM,KAAK,GAA8B,kBAAkB,IAAI,QAAQ;YACtE,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE;YAClD,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO;YACN,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU;YAC7E,SAAS,EAAE,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;YACtH,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnF,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SAC5H,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,KAA0D;IAC7F,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAiC,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA8B,CAAC;IACnD,MAAM,SAAS,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3D,6EAA6E;IAC7E,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnF,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC3C,IAAI,QAAQ,CAAC,YAAY,KAAK,uBAAuB,IAAI,QAAQ,CAAC,YAAY,KAAK,4BAA4B;gBAAE,SAAS;YAC1H,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,QAAQ,CAAC,EAAE,uBAAuB,CAAC,CAAC;YACxH,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,QAAQ,CAAC,YAAY,KAAK,uBAAuB,EAAE,CAAC;gBACvD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9H,CAAC;iBAAM,CAAC;gBACP,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC1G,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1J,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAClK,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAqC,EAAE,CAAC;QACvD,KAAK,MAAM,IAAI,IAAI,QAAQ;YAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7G,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;QAClD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA8B,CAAC;QAChE,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAyB,EAAE;YACvE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YACjF,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC;YAClI,KAAK,MAAM,KAAK,IAAI,cAAc;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YACrC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAClG,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACzC,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YACrH,KAAK,MAAM,IAAI,IAAI,kBAAkB;gBAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,cAAc,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;YACxD,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;YAChI,MAAM,SAAS,GAAG,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;YAClE,OAAO;gBACN,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc;gBAC9E,UAAU,EAAE,kBAAkB,EAAE,kBAAkB;gBAClD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE;gBACnF,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACvC,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;aACP,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO;YACN,WAAW,EAAE,SAAS,EAAE,aAAa;YACrC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjG,mBAAmB,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAChH,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/tracking-schemas.d.ts

@@ -0,0 +1,56 @@
+import * as z from 'zod/v4';
+/** Persisted before visits start; trackers render this graph, never a current source rebuild. */
+export declare const TraversalPlanSchema: z.ZodObject<{
+    traversalId: z.ZodString;
+    revision: z.ZodNumber;
+    source: z.ZodString;
+    strategy: z.ZodString;
+    onFailure: z.ZodEnum<{
+        continue: "continue";
+        stop: "stop";
+        "skip-dependents": "skip-dependents";
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    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>>>;
+        label: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cycles: z.ZodArray<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TraversalPlan = z.output<typeof TraversalPlanSchema>;
+export declare const VisitStampDeclarationSchema: z.ZodObject<{
+    traversalId: z.ZodString;
+    planRevision: z.ZodNumber;
+    step: z.ZodNumber;
+    id: z.ZodString;
+}, z.core.$strip>;
+/** Node retries have actual scheduler facts; a coordinator has only its durable coordination ordinal. */
+export declare const VisitStampSchema: z.ZodUnion<readonly [z.ZodObject<{
+    traversalId: z.ZodString;
+    planRevision: z.ZodNumber;
+    step: z.ZodNumber;
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    attempt: z.ZodNumber;
+    between: z.ZodOptional<z.ZodNever>;
+    coordinationOrdinal: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    traversalId: z.ZodString;
+    planRevision: z.ZodNumber;
+    step: z.ZodNumber;
+    between: z.ZodLiteral<true>;
+    coordinationOrdinal: z.ZodNumber;
+    id: z.ZodOptional<z.ZodNever>;
+    revision: z.ZodOptional<z.ZodNever>;
+    attempt: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>]>;
+export type VisitStamp = z.output<typeof VisitStampSchema>;
+export declare const TRAVERSAL_PLAN_ARTIFACT = "traversal.plan";
+export declare const TRAVERSAL_EXECUTION_ARTIFACT = "traversal.execution";
+//# sourceMappingURL=tracking-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-schemas.d.ts","sourceRoot":"","sources":["../src/tracking-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,iGAAiG;AACjG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;iBAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOjE,eAAO,MAAM,2BAA2B;;;;;iBAAwD,CAAC;AAEjG,yGAAyG;AACzG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;mBAS3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3D,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AACxD,eAAO,MAAM,4BAA4B,wBAAwB,CAAC"}

package/dist/tracking-schemas.js

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+import { GraphNodeSchema } from "./graph-schemas.js";
+/** Persisted before visits start; trackers render this graph, never a current source rebuild. */
+export const TraversalPlanSchema = z.object({
+    traversalId: z.string().min(1),
+    revision: z.number().int().nonnegative(),
+    source: z.string().min(1),
+    strategy: z.string().min(1),
+    onFailure: z.enum(['skip-dependents', 'stop', 'continue']),
+    steps: z.array(z.object({ index: z.number().int().nonnegative(), ids: z.array(z.string().min(1)) })),
+    nodes: z.array(GraphNodeSchema.extend({ label: z.string().optional(), kind: z.string().optional() })),
+    cycles: z.array(z.array(z.string().min(1)))
+});
+const VisitIdentitySchema = z.object({
+    traversalId: TraversalPlanSchema.shape.traversalId,
+    planRevision: TraversalPlanSchema.shape.revision,
+    step: z.number().int().nonnegative()
+});
+export const VisitStampDeclarationSchema = VisitIdentitySchema.extend({ id: z.string().min(1) });
+/** Node retries have actual scheduler facts; a coordinator has only its durable coordination ordinal. */
+export const VisitStampSchema = z.union([
+    VisitStampDeclarationSchema.extend({
+        revision: z.number().int().nonnegative(), attempt: z.number().int().positive(),
+        between: z.never().optional(), coordinationOrdinal: z.never().optional()
+    }),
+    VisitIdentitySchema.extend({
+        between: z.literal(true), coordinationOrdinal: z.number().int().nonnegative(),
+        id: z.never().optional(), revision: z.never().optional(), attempt: z.never().optional()
+    })
+]);
+export const TRAVERSAL_PLAN_ARTIFACT = 'traversal.plan';
+export const TRAVERSAL_EXECUTION_ARTIFACT = 'traversal.execution';
+//# sourceMappingURL=tracking-schemas.js.map

package/dist/tracking-schemas.js.map

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

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@vibesdotdev/traversal",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-rc.1",
+  "dependencies": {
+    "@vibesdotdev/kernel": "^1.0.0-rc.8",
+    "@vibesdotdev/shared": "^1.0.0-rc.4",
+    "@vibesdotdev/runnable": "^1.0.0-rc.1",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/kit": "^1.0.0-rc.0",
+    "svelte": "^5.57.2"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "bun": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "bun": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./tracking": {
+      "bun": "./dist/tracking/index.js",
+      "types": "./dist/tracking/index.d.ts",
+      "import": "./dist/tracking/index.js",
+      "default": "./dist/tracking/index.js"
+    },
+    "./svelte": {
+      "bun": "./dist/svelte/index.js",
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js",
+      "default": "./dist/svelte/index.js"
+    },
+    "./schemas": {
+      "bun": "./dist/schemas.js",
+      "types": "./dist/schemas.d.ts",
+      "import": "./dist/schemas.js",
+      "default": "./dist/schemas.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "!dist/**/*.test.*",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "scripts": {
+    "lint": "node ../node_modules/@vibesdotdev/internal-oxlint-toolchain/ratchet.mjs .",
+    "check": "bun --bun tsc -p tsconfig.json --noEmit && bun --bun svelte-check --tsconfig ./tsconfig.svelte.check.json",
+    "test": "bun test src",
+    "build": "tsc -p tsconfig.build.json && bun --bun svelte-package --input ./src/svelte --output ./dist/svelte --tsconfig ./tsconfig.svelte.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "directory": "traversal"
+  },
+  "publishConfig": {
+    "registry": "https://packages.vibes.dev",
+    "access": "public"
+  },
+  "vibes": {
+    "visibility": "public",
+    "registry": {
+      "repositoryId": "4b1374d4-6830-4bfd-98e3-de66416368a8",
+      "directory": "traversal"
+    },
+    "handedRuntimeLogging": true
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "description": "Runtime-selected graph building strategies; execution remains owned by Runbooks and Workers.",
+  "gitHead": "f1ff526c235b10c970497738beb16b0651c428c8",
+  "_vibes_source": {
+    "repo": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "sha": "f1ff526c235b10c970497738beb16b0651c428c8",
+    "workspaceDigest": "sha256:2a7c7b503393d8f0383f03271da2e9be2dc7189aa11e643845b77816be8c8db6"
+  }
+}