@vibesdotdev/tracking-schemas 0.0.0-stage → 1.0.0-rc.6

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+# @vibesdotdev/tracking-schemas
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Zod schemas and TypeScript types for Vibes tracking items and pull requests: the
+item, priority, PR-state and CI-status vocabularies, review and comment enums, the
+authenticated actor principal, the compact PR-stack membership projection, and the
+status-check wire shape for one CI result.
+
+It is a pure leaf. It depends on `zod` only and has no runtime behavior, so
+`@vibesdotdev/forge`, `@vibesdotdev/projects` and `@vibesdotdev/git-operations` can
+agree on the same wire contract without importing each other.
+
+## Install
+
+```sh
+bun add @vibesdotdev/tracking-schemas
+```
+
+## Example
+
+```ts
+import {
+	StatusCheckSchema,
+	TrackingPrStateSchema,
+	TrackingPrStateValues,
+	type StatusCheck
+} from '@vibesdotdev/tracking-schemas';
+
+TrackingPrStateValues; // ['draft', 'open', 'merged', 'closed']
+TrackingPrStateSchema.parse('open');
+
+const check: StatusCheck = StatusCheckSchema.parse({
+	context: 'ci/quality',
+	state: 'success',
+	sha: 'abc123',
+	updatedAt: new Date().toISOString()
+});
+```
+
+Merge-policy helpers that operate on these shapes (`aggregateStatusChecks`,
+`statusChecksBlockMerge` and friends) live in `@vibesdotdev/forge`, not here.
+
+Schemas and their inferred types live in `src/schemas/` and are exported through
+the package root.
+
+See the published [SPEC.md](./SPEC.md) for the full export list,
+the ownership boundary and the hard rules.
+
+## Development
+
+Run these commands from the package directory:
+
+- `bun run check` uses the default `tsconfig.json` to typecheck all TypeScript and
+  TSX sources, including tests and Svelte TypeScript sources, without emitting code.
+  `tsconfig.check.json` remains a compatibility alias for this project.
+- `bun run test` runs the in-process schema contract tests.
+- `bun run build` uses `tsconfig.build.json` to emit production JavaScript,
+  declarations and maps into `dist`, excluding tests, specs, `__tests__` directories
+  and `src/svelte/**`.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './schemas/vocabulary.ts';
+export * from './schemas/actor.ts';
+export * from './schemas/stack-projection.ts';
+export * from './schemas/status-check.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,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./schemas/vocabulary.js";
+export * from "./schemas/actor.js";
+export * from "./schemas/stack-projection.js";
+export * from "./schemas/status-check.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,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC"}

package/dist/schemas/actor.d.ts

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+/**
+ * Authenticated identity used for Forge authorship, review distinctness, and
+ * merge audit; also embedded in App's tracking-item PR sub-shape
+ * (`TrackingPrSchema.authorPrincipal`). Account ownership remains a separate
+ * tenancy/notification concern — `principalId` is the identity that must be
+ * distinct for review.
+ */
+export declare const ForgePrincipalTypeSchema: z.ZodEnum<{
+    human: "human";
+    agent: "agent";
+}>;
+export type ForgePrincipalType = z.infer<typeof ForgePrincipalTypeSchema>;
+export declare const ForgeActorPrincipalSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    principalId: z.ZodString;
+    principalType: z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+    }>;
+}, z.core.$strict>;
+export type ForgeActorPrincipal = z.infer<typeof ForgeActorPrincipalSchema>;
+//# sourceMappingURL=actor.d.ts.map

package/dist/schemas/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../src/schemas/actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;EAA6B,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;;;;;kBAM5B,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/actor.js

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+/**
+ * Authenticated identity used for Forge authorship, review distinctness, and
+ * merge audit; also embedded in App's tracking-item PR sub-shape
+ * (`TrackingPrSchema.authorPrincipal`). Account ownership remains a separate
+ * tenancy/notification concern — `principalId` is the identity that must be
+ * distinct for review.
+ */
+export const ForgePrincipalTypeSchema = z.enum(['human', 'agent']);
+export const ForgeActorPrincipalSchema = z
+    .object({
+    accountId: z.string().min(1),
+    principalId: z.string().min(1),
+    principalType: ForgePrincipalTypeSchema
+})
+    .strict();
+//# sourceMappingURL=actor.js.map

package/dist/schemas/actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.js","sourceRoot":"","sources":["../../src/schemas/actor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAGnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACxC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,wBAAwB;CACvC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/schemas/stack-projection.d.ts

@@ -0,0 +1,53 @@
+import * as z from 'zod/v4';
+/**
+ * The compact stack-membership projection carried on every pull-request
+ * tracking item — Forge's `ForgePrStackMembershipProjectionSchema`, consumed
+ * verbatim by App's `TrackingPrSchema.stack`. The full stack CRUD/operation/
+ * event surface (create/list/restack/merge, `ForgePrStackSchema`, and friends)
+ * stays forge-owned in `forge/src/schemas/stack.ts` — only the
+ * read-only projection embedded in tracking items is genuinely shared.
+ */
+export declare const ForgePrStackStateSchema: z.ZodEnum<{
+    merged: "merged";
+    active: "active";
+    merging: "merging";
+    dissolved: "dissolved";
+}>;
+export type ForgePrStackState = z.infer<typeof ForgePrStackStateSchema>;
+export declare const ForgePrStackHealthSchema: z.ZodEnum<{
+    clean: "clean";
+    "restack-required": "restack-required";
+    conflicted: "conflicted";
+}>;
+export type ForgePrStackHealth = z.infer<typeof ForgePrStackHealthSchema>;
+export declare const ForgePrStackLandingPolicySchema: z.ZodEnum<{
+    "batch-allowed": "batch-allowed";
+    "one-layer-at-a-time": "one-layer-at-a-time";
+}>;
+export type ForgePrStackLandingPolicy = z.infer<typeof ForgePrStackLandingPolicySchema>;
+/** Compact membership projected onto every pull-request response. */
+export declare const ForgePrStackMembershipProjectionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    stackNumber: z.ZodNumber;
+    position: z.ZodNumber;
+    size: z.ZodNumber;
+    trunkRef: z.ZodString;
+    state: z.ZodEnum<{
+        merged: "merged";
+        active: "active";
+        merging: "merging";
+        dissolved: "dissolved";
+    }>;
+    health: z.ZodEnum<{
+        clean: "clean";
+        "restack-required": "restack-required";
+        conflicted: "conflicted";
+    }>;
+    landingPolicy: z.ZodEnum<{
+        "batch-allowed": "batch-allowed";
+        "one-layer-at-a-time": "one-layer-at-a-time";
+    }>;
+    revision: z.ZodNumber;
+}, z.core.$strip>;
+export type ForgePrStackMembershipProjection = z.infer<typeof ForgePrStackMembershipProjectionSchema>;
+//# sourceMappingURL=stack-projection.d.ts.map

package/dist/schemas/stack-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-projection.d.ts","sourceRoot":"","sources":["../../src/schemas/stack-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;EAAuD,CAAC;AAC5F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;EAAsD,CAAC;AAC5F,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,+BAA+B;;;EAAmD,CAAC;AAChG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,qEAAqE;AACrE,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;iBAUjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,sCAAsC,CAC7C,CAAC"}

package/dist/schemas/stack-projection.js

@@ -0,0 +1,25 @@
+import * as z from 'zod/v4';
+/**
+ * The compact stack-membership projection carried on every pull-request
+ * tracking item — Forge's `ForgePrStackMembershipProjectionSchema`, consumed
+ * verbatim by App's `TrackingPrSchema.stack`. The full stack CRUD/operation/
+ * event surface (create/list/restack/merge, `ForgePrStackSchema`, and friends)
+ * stays forge-owned in `forge/src/schemas/stack.ts` — only the
+ * read-only projection embedded in tracking items is genuinely shared.
+ */
+export const ForgePrStackStateSchema = z.enum(['active', 'merging', 'merged', 'dissolved']);
+export const ForgePrStackHealthSchema = z.enum(['clean', 'restack-required', 'conflicted']);
+export const ForgePrStackLandingPolicySchema = z.enum(['batch-allowed', 'one-layer-at-a-time']);
+/** Compact membership projected onto every pull-request response. */
+export const ForgePrStackMembershipProjectionSchema = z.object({
+    id: z.uuid(),
+    stackNumber: z.number().int().positive(),
+    position: z.number().int().nonnegative(),
+    size: z.number().int().min(2).max(100),
+    trunkRef: z.string().min(1),
+    state: ForgePrStackStateSchema,
+    health: ForgePrStackHealthSchema,
+    landingPolicy: ForgePrStackLandingPolicySchema,
+    revision: z.number().int().nonnegative()
+});
+//# sourceMappingURL=stack-projection.js.map

package/dist/schemas/stack-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-projection.js","sourceRoot":"","sources":["../../src/schemas/stack-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAG5F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC,CAAC;AAG5F,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAGhG,qEAAqE;AACrE,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IACZ,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,wBAAwB;IAChC,aAAa,EAAE,+BAA+B;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC"}

package/dist/schemas/status-check.d.ts

@@ -0,0 +1,73 @@
+import * as z from 'zod/v4';
+/**
+ * The Forge status-check WIRE SHAPE — one CI result reported for a PR head.
+ * Forge owns the merge-policy HELPERS that operate on this shape
+ * (`aggregateStatusChecks`, `readStatusChecks`, `upsertStatusCheck`,
+ * `statusChecksBlock(ing)Merge` — see `forge/src/schemas/wire-contracts.ts`);
+ * only the transport-neutral shape lives here, so App's tracking-item metadata
+ * bag and Forge's merge responses can agree on it without either package
+ * importing the other.
+ */
+/** CI state alias retained for tracking consumers. */
+export declare const StatusCheckStateSchema: z.ZodEnum<{
+    pending: "pending";
+    success: "success";
+    failure: "failure";
+    error: "error";
+}>;
+export declare const StatusCheckResultSchema: z.ZodObject<{
+    context: z.ZodString;
+    state: z.ZodEnum<{
+        pending: "pending";
+        success: "success";
+        failure: "failure";
+        error: "error";
+    }>;
+    sha: z.ZodString;
+    targetUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ciRunId: z.ZodOptional<z.ZodString>;
+    ciAttemptId: z.ZodOptional<z.ZodString>;
+    logsRef: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    updatedAt: z.ZodString;
+}, z.core.$loose>;
+export type StatusCheckResult = z.infer<typeof StatusCheckResultSchema>;
+/** Canonical status-check schema used by tracking persistence and merge responses. */
+export declare const StatusCheckSchema: z.ZodObject<{
+    context: z.ZodString;
+    state: z.ZodEnum<{
+        pending: "pending";
+        success: "success";
+        failure: "failure";
+        error: "error";
+    }>;
+    sha: z.ZodString;
+    targetUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ciRunId: z.ZodOptional<z.ZodString>;
+    ciAttemptId: z.ZodOptional<z.ZodString>;
+    logsRef: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    updatedAt: z.ZodString;
+}, z.core.$loose>;
+export declare const StatusCheckArraySchema: z.ZodArray<z.ZodObject<{
+    context: z.ZodString;
+    state: z.ZodEnum<{
+        pending: "pending";
+        success: "success";
+        failure: "failure";
+        error: "error";
+    }>;
+    sha: z.ZodString;
+    targetUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ciRunId: z.ZodOptional<z.ZodString>;
+    ciAttemptId: z.ZodOptional<z.ZodString>;
+    logsRef: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    updatedAt: z.ZodString;
+}, z.core.$loose>>;
+export type StatusCheckState = z.infer<typeof StatusCheckStateSchema>;
+export type StatusCheck = z.infer<typeof StatusCheckSchema>;
+//# sourceMappingURL=status-check.d.ts.map

package/dist/schemas/status-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-check.d.ts","sourceRoot":"","sources":["../../src/schemas/status-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,eAAO,MAAM,sBAAsB;;;;;EAA2B,CAAC;AAE/D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;iBAwBrB,CAAC;AAChB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,sFAAsF;AACtF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;iBAA0B,CAAC;AACzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;kBAA6B,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/status-check.js

@@ -0,0 +1,42 @@
+import { TrackingPrCiStatusSchema } from "./vocabulary.js";
+import * as z from 'zod/v4';
+/**
+ * The Forge status-check WIRE SHAPE — one CI result reported for a PR head.
+ * Forge owns the merge-policy HELPERS that operate on this shape
+ * (`aggregateStatusChecks`, `readStatusChecks`, `upsertStatusCheck`,
+ * `statusChecksBlock(ing)Merge` — see `forge/src/schemas/wire-contracts.ts`);
+ * only the transport-neutral shape lives here, so App's tracking-item metadata
+ * bag and Forge's merge responses can agree on it without either package
+ * importing the other.
+ */
+/** CI state alias retained for tracking consumers. */
+export const StatusCheckStateSchema = TrackingPrCiStatusSchema;
+export const StatusCheckResultSchema = z
+    .object({
+    context: z.string().min(1),
+    state: TrackingPrCiStatusSchema,
+    sha: z.string().min(1),
+    targetUrl: z.string().optional(),
+    description: z.string().optional(),
+    /**
+     * Canonical CI correlation — the stable interface for log retrieval.
+     * `ciRunId`/`ciAttemptId` identify the platform CI run and attempt;
+     * `logsRef` is the durable log object reference
+     * (`r2://vibes-forge-ci-artifacts/runs/<ciRunId>/attempts/<ciAttemptId>/log.txt`)
+     * persisted by the executor for every terminal attempt.
+     */
+    ciRunId: z.string().optional(),
+    ciAttemptId: z.string().optional(),
+    logsRef: z.string().optional(),
+    /**
+     * `false`: advisory — the check is reported but never blocks a merge (its job is not
+     * required; a branch policy may still require its context by name). Absent: blocking.
+     */
+    required: z.boolean().optional(),
+    updatedAt: z.string().min(1)
+})
+    .passthrough();
+/** Canonical status-check schema used by tracking persistence and merge responses. */
+export const StatusCheckSchema = StatusCheckResultSchema;
+export const StatusCheckArraySchema = z.array(StatusCheckSchema);
+//# sourceMappingURL=status-check.js.map

package/dist/schemas/status-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-check.js","sourceRoot":"","sources":["../../src/schemas/status-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACtC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,wBAAwB;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC;KACD,WAAW,EAAE,CAAC;AAGhB,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/schemas/vocabulary.d.ts

@@ -0,0 +1,71 @@
+import * as z from 'zod/v4';
+/**
+ * Canonical tracking vocabulary shared by every Forge surface AND
+ * `@vibesdotdev/projects/app`'s tracking domain. Extracted as a pure leaf so neither
+ * side has to import the other just to agree on these enums — see this
+ * package's SPEC.md for the membership rule.
+ *
+ * `TrackingItemStatus` (the product lifecycle enum) is deliberately NOT here:
+ * its true canonical source is `@vibesdotdev/shared`'s `VibesProductStatusSchema`
+ * (already a pure, zero-@vibesdotdev-dep leaf) — Forge and App both alias it
+ * from there directly. Duplicating it here would fork one source into two.
+ */
+/** Canonical tracking item kinds shared by Forge and App consumers. */
+export declare const TrackingItemTypeValues: readonly ["task", "bug", "research", "ops", "doc", "pr"];
+export declare const TrackingItemTypeSchema: z.ZodEnum<{
+    task: "task";
+    bug: "bug";
+    research: "research";
+    ops: "ops";
+    doc: "doc";
+    pr: "pr";
+}>;
+export type TrackingItemType = z.infer<typeof TrackingItemTypeSchema>;
+/** Canonical urgency levels for tracking items. */
+export declare const TrackingItemPriorityValues: readonly ["low", "medium", "high", "urgent"];
+export declare const TrackingItemPrioritySchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    urgent: "urgent";
+}>;
+export type TrackingItemPriority = z.infer<typeof TrackingItemPrioritySchema>;
+/** Pull-request lifecycle states shared by every Forge/App surface. */
+export declare const TrackingPrStateValues: readonly ["draft", "open", "merged", "closed"];
+export declare const TrackingPrStateSchema: z.ZodEnum<{
+    draft: "draft";
+    open: "open";
+    merged: "merged";
+    closed: "closed";
+}>;
+export type TrackingPrState = z.infer<typeof TrackingPrStateSchema>;
+/** Aggregate CI states for one exact pull-request head (Forge's "status-check state"). */
+export declare const TrackingPrCiStatusValues: readonly ["pending", "success", "failure", "error"];
+export declare const TrackingPrCiStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    success: "success";
+    failure: "failure";
+    error: "error";
+}>;
+export type TrackingPrCiStatus = z.infer<typeof TrackingPrCiStatusSchema>;
+/** Source responsible for a tracking comment. */
+export declare const TrackingCommentSourceSchema: z.ZodEnum<{
+    human: "human";
+    agent: "agent";
+    system: "system";
+}>;
+export type TrackingCommentSource = z.infer<typeof TrackingCommentSourceSchema>;
+/** Diff side an inline review comment anchors to. */
+export declare const TrackingReviewSideSchema: z.ZodEnum<{
+    old: "old";
+    new: "new";
+}>;
+export type TrackingReviewSide = z.infer<typeof TrackingReviewSideSchema>;
+/** Review verdict carried by a comment. */
+export declare const TrackingReviewStateSchema: z.ZodEnum<{
+    approved: "approved";
+    "changes-requested": "changes-requested";
+    commented: "commented";
+}>;
+export type TrackingReviewState = z.infer<typeof TrackingReviewStateSchema>;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/schemas/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/schemas/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,0DAA2D,CAAC;AAC/F,eAAO,MAAM,sBAAsB;;;;;;;EAAiC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,8CAA+C,CAAC;AACvF,eAAO,MAAM,0BAA0B;;;;;EAAqC,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,gDAAiD,CAAC;AACpF,eAAO,MAAM,qBAAqB;;;;;EAAgC,CAAC;AACnE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,qDAAsD,CAAC;AAC5F,eAAO,MAAM,wBAAwB;;;;;EAAmC,CAAC;AACzE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,iDAAiD;AACjD,eAAO,MAAM,2BAA2B;;;;EAAuC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,qDAAqD;AACrD,eAAO,MAAM,wBAAwB;;;EAAyB,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB;;;;EAAyD,CAAC;AAChG,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/vocabulary.js

@@ -0,0 +1,31 @@
+import * as z from 'zod/v4';
+/**
+ * Canonical tracking vocabulary shared by every Forge surface AND
+ * `@vibesdotdev/projects/app`'s tracking domain. Extracted as a pure leaf so neither
+ * side has to import the other just to agree on these enums — see this
+ * package's SPEC.md for the membership rule.
+ *
+ * `TrackingItemStatus` (the product lifecycle enum) is deliberately NOT here:
+ * its true canonical source is `@vibesdotdev/shared`'s `VibesProductStatusSchema`
+ * (already a pure, zero-@vibesdotdev-dep leaf) — Forge and App both alias it
+ * from there directly. Duplicating it here would fork one source into two.
+ */
+/** Canonical tracking item kinds shared by Forge and App consumers. */
+export const TrackingItemTypeValues = ['task', 'bug', 'research', 'ops', 'doc', 'pr'];
+export const TrackingItemTypeSchema = z.enum(TrackingItemTypeValues);
+/** Canonical urgency levels for tracking items. */
+export const TrackingItemPriorityValues = ['low', 'medium', 'high', 'urgent'];
+export const TrackingItemPrioritySchema = z.enum(TrackingItemPriorityValues);
+/** Pull-request lifecycle states shared by every Forge/App surface. */
+export const TrackingPrStateValues = ['draft', 'open', 'merged', 'closed'];
+export const TrackingPrStateSchema = z.enum(TrackingPrStateValues);
+/** Aggregate CI states for one exact pull-request head (Forge's "status-check state"). */
+export const TrackingPrCiStatusValues = ['pending', 'success', 'failure', 'error'];
+export const TrackingPrCiStatusSchema = z.enum(TrackingPrCiStatusValues);
+/** Source responsible for a tracking comment. */
+export const TrackingCommentSourceSchema = z.enum(['human', 'agent', 'system']);
+/** Diff side an inline review comment anchors to. */
+export const TrackingReviewSideSchema = z.enum(['old', 'new']);
+/** Review verdict carried by a comment. */
+export const TrackingReviewStateSchema = z.enum(['approved', 'changes-requested', 'commented']);
+//# sourceMappingURL=vocabulary.js.map

package/dist/schemas/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/schemas/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAU,CAAC;AAC/F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAGrE,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AACvF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAG7E,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAGnE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAC5F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAGzE,iDAAiD;AACjD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGhF,qDAAqD;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAG/D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,85 @@
 {
   "name": "@vibesdotdev/tracking-schemas",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-rc.6",
+  "dependencies": {
+    "zod": "^4.6.7"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "bun": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "!dist/tsconfig.tsbuildinfo",
+    "!**/.turbo/**",
+    "!**/.svelte-kit/**",
+    "!**/.vibes/**",
+    "!**/__tests__/**",
+    "!**/__stubs__/**",
+    "!**/*.test.js",
+    "!**/*.test.mjs",
+    "!**/*.test.cjs",
+    "!**/*.test.jsx",
+    "!**/*.test.ts",
+    "!**/*.test.mts",
+    "!**/*.test.cts",
+    "!**/*.test.tsx",
+    "!**/*.spec.js",
+    "!**/*.spec.mjs",
+    "!**/*.spec.cjs",
+    "!**/*.spec.jsx",
+    "!**/*.spec.ts",
+    "!**/*.spec.mts",
+    "!**/*.spec.cts",
+    "!**/*.spec.tsx",
+    "!**/SPEC.md",
+    "!**/tsconfig.json",
+    "!**/tsconfig.*.json",
+    "!**/*.tsbuildinfo",
+    "!**/.build-ok.json",
+    "!**/*.tgz"
+  ],
+  "scripts": {
+    "lint": "node ../node_modules/@vibesdotdev/internal-oxlint-toolchain/ratchet.mjs .",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "check": "${BUN:-bun} --bun tsc -p tsconfig.json",
+    "test": "${BUN:-bun} test src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "directory": "tracking-schemas"
+  },
+  "publishConfig": {
+    "registry": "https://packages.vibes.dev",
+    "access": "public"
+  },
+  "vibes": {
+    "visibility": "public",
+    "registry": {
+      "repositoryId": "4b1374d4-6830-4bfd-98e3-de66416368a8",
+      "directory": "tracking-schemas"
+    },
+    "handedRuntimeLogging": true,
+    "compositionRoots": [
+      "src/__tests__/package-files.ts"
+    ]
+  },
+  "license": "MIT",
+  "description": "Transport-neutral tracking contract (Zod) shared by @vibesdotdev/forge and @vibesdotdev/projects/app — pure leaf, zero @vibesdotdev/* runtime dependencies",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "gitHead": "d1948c757f179d2c3fb41553347085335cb76710",
+  "_vibes_source": {
+    "repo": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "sha": "d1948c757f179d2c3fb41553347085335cb76710",
+    "workspaceDigest": "sha256:5718e1a087262e986d3732a2f8d75963a0b3786c55f2e2b99e62b532953feb1d"
+  }
+}