@revealui/contracts 1.0.0

package/dist/entities/board.js

@@ -0,0 +1,99 @@
+/**
+ * Board Entity Contract
+ *
+ * Kanban board that contains tickets organized into columns.
+ *
+ * Business Rules:
+ * - Board slug must be unique per tenant
+ * - One board per tenant may be marked isDefault
+ * - Creating a board auto-creates default columns (Backlog, To Do, In Progress, Review, Done)
+ * - Deleting a board cascades to columns and tickets
+ */
+import { z } from 'zod/v4';
+// =============================================================================
+// Constants
+// =============================================================================
+export const BOARD_SCHEMA_VERSION = 1;
+export const DEFAULT_COLUMN_SLUGS = ['backlog', 'todo', 'in-progress', 'review', 'done'];
+export const BOARD_LIMITS = {
+    MIN_NAME_LENGTH: 1,
+    MAX_NAME_LENGTH: 200,
+    MIN_SLUG_LENGTH: 1,
+    MAX_SLUG_LENGTH: 200,
+    MAX_DESCRIPTION_LENGTH: 1000,
+    MAX_COLUMNS: 20,
+};
+// =============================================================================
+// Board Schema
+// =============================================================================
+export const BoardObjectSchema = z.object({
+    id: z.string().min(1),
+    schemaVersion: z.string().default(String(BOARD_SCHEMA_VERSION)),
+    name: z.string().min(BOARD_LIMITS.MIN_NAME_LENGTH).max(BOARD_LIMITS.MAX_NAME_LENGTH),
+    slug: z
+        .string()
+        .min(BOARD_LIMITS.MIN_SLUG_LENGTH)
+        .max(BOARD_LIMITS.MAX_SLUG_LENGTH)
+        .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, 'Slug must be lowercase with hyphens'),
+    description: z.string().max(BOARD_LIMITS.MAX_DESCRIPTION_LENGTH).nullable().optional(),
+    ownerId: z.string().nullable().optional(),
+    tenantId: z.string().nullable().optional(),
+    isDefault: z.boolean().default(false),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+});
+export const BoardSchema = BoardObjectSchema;
+export const BoardInsertSchema = BoardObjectSchema.omit({
+    createdAt: true,
+    updatedAt: true,
+}).extend({
+    createdAt: z.date().optional(),
+    updatedAt: z.date().optional(),
+});
+// =============================================================================
+// Board Column Schema
+// =============================================================================
+export const BoardColumnObjectSchema = z.object({
+    id: z.string().min(1),
+    boardId: z.string().min(1),
+    name: z.string().min(1).max(100),
+    slug: z.string().min(1).max(100),
+    position: z.number().int().min(0),
+    wipLimit: z.number().int().min(1).nullable().optional(),
+    color: z.string().max(20).nullable().optional(),
+    isDefault: z.boolean().default(false),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+});
+export const BoardColumnSchema = BoardColumnObjectSchema;
+// =============================================================================
+// Helpers
+// =============================================================================
+export function generateSlug(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/[\s_-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, BOARD_LIMITS.MAX_SLUG_LENGTH);
+}
+export function isValidSlug(slug) {
+    return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug);
+}
+export function createBoardInsert(name, slug, options) {
+    const now = new Date();
+    return {
+        id: options?.id ?? crypto.randomUUID(),
+        schemaVersion: String(BOARD_SCHEMA_VERSION),
+        name,
+        slug,
+        description: options?.description ?? null,
+        ownerId: options?.ownerId ?? null,
+        tenantId: options?.tenantId ?? null,
+        isDefault: options?.isDefault ?? false,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=board.js.map

package/dist/entities/board.js.map

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

package/dist/entities/code-provenance.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Code Provenance Entity Contract
+ *
+ * Tracks authorship (AI-generated, human-written, AI-assisted, mixed) and
+ * review status of code at file/function granularity.
+ *
+ * Design: Value functions — pure functions that take data in and return
+ * computed results. No side effects, easy to test, composable.
+ *
+ * Business Rules:
+ * - authorType classifies who wrote the code
+ * - reviewStatus tracks audit state
+ * - codeReviews is an append-only log (immutable history)
+ * - confidence is a 0-1 score for automated classification
+ * - Stale = created > 90 days ago and never reviewed
+ * - AI involvement = ai_generated || ai_assisted || mixed
+ */
+import { z } from 'zod/v4';
+export declare const PROVENANCE_SCHEMA_VERSION = 1;
+export declare const AUTHOR_TYPES: readonly ["ai_generated", "human_written", "ai_assisted", "mixed"];
+export type AuthorType = (typeof AUTHOR_TYPES)[number];
+export declare const REVIEW_STATUSES: readonly ["unreviewed", "human_reviewed", "ai_reviewed", "human_and_ai_reviewed"];
+export type ReviewStatus = (typeof REVIEW_STATUSES)[number];
+export declare const REVIEW_TYPES: readonly ["human_review", "ai_review", "human_approval", "ai_suggestion"];
+export type ReviewType = (typeof REVIEW_TYPES)[number];
+export declare const REVIEW_DECISIONS: readonly ["approved", "rejected", "needs_changes", "informational"];
+export type ReviewDecision = (typeof REVIEW_DECISIONS)[number];
+export declare const PROVENANCE_LIMITS: {
+    readonly MAX_FILE_PATH_LENGTH: 1000;
+    readonly MAX_FUNCTION_NAME_LENGTH: 200;
+};
+export declare const ProvenanceObjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodDefault<z.ZodString>;
+    filePath: z.ZodString;
+    functionName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lineStart: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lineEnd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    authorType: z.ZodEnum<{
+        ai_generated: "ai_generated";
+        human_written: "human_written";
+        ai_assisted: "ai_assisted";
+        mixed: "mixed";
+    }>;
+    aiModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aiSessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitCommitHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitAuthor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    reviewStatus: z.ZodDefault<z.ZodEnum<{
+        unreviewed: "unreviewed";
+        human_reviewed: "human_reviewed";
+        ai_reviewed: "ai_reviewed";
+        human_and_ai_reviewed: "human_and_ai_reviewed";
+    }>>;
+    reviewedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    linesOfCode: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const ProvenanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodDefault<z.ZodString>;
+    filePath: z.ZodString;
+    functionName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lineStart: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lineEnd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    authorType: z.ZodEnum<{
+        ai_generated: "ai_generated";
+        human_written: "human_written";
+        ai_assisted: "ai_assisted";
+        mixed: "mixed";
+    }>;
+    aiModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aiSessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitCommitHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitAuthor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    reviewStatus: z.ZodDefault<z.ZodEnum<{
+        unreviewed: "unreviewed";
+        human_reviewed: "human_reviewed";
+        ai_reviewed: "ai_reviewed";
+        human_and_ai_reviewed: "human_and_ai_reviewed";
+    }>>;
+    reviewedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    linesOfCode: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+export declare const ProvenanceInsertSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    id: z.ZodString;
+    schemaVersion: z.ZodDefault<z.ZodString>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    filePath: z.ZodString;
+    functionName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lineStart: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lineEnd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    authorType: z.ZodEnum<{
+        ai_generated: "ai_generated";
+        human_written: "human_written";
+        ai_assisted: "ai_assisted";
+        mixed: "mixed";
+    }>;
+    aiModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aiSessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitCommitHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitAuthor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewStatus: z.ZodDefault<z.ZodEnum<{
+        unreviewed: "unreviewed";
+        human_reviewed: "human_reviewed";
+        ai_reviewed: "ai_reviewed";
+        human_and_ai_reviewed: "human_and_ai_reviewed";
+    }>>;
+    reviewedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    linesOfCode: z.ZodDefault<z.ZodNumber>;
+    createdAt: z.ZodOptional<z.ZodDate>;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export type ProvenanceInsert = z.infer<typeof ProvenanceInsertSchema>;
+export declare const CodeReviewObjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    provenanceId: z.ZodString;
+    reviewerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewType: z.ZodEnum<{
+        human_review: "human_review";
+        ai_review: "ai_review";
+        human_approval: "human_approval";
+        ai_suggestion: "ai_suggestion";
+    }>;
+    status: z.ZodEnum<{
+        approved: "approved";
+        rejected: "rejected";
+        needs_changes: "needs_changes";
+        informational: "informational";
+    }>;
+    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    createdAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const CodeReviewSchema: z.ZodObject<{
+    id: z.ZodString;
+    provenanceId: z.ZodString;
+    reviewerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewType: z.ZodEnum<{
+        human_review: "human_review";
+        ai_review: "ai_review";
+        human_approval: "human_approval";
+        ai_suggestion: "ai_suggestion";
+    }>;
+    status: z.ZodEnum<{
+        approved: "approved";
+        rejected: "rejected";
+        needs_changes: "needs_changes";
+        informational: "informational";
+    }>;
+    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    createdAt: z.ZodDate;
+}, z.core.$strip>;
+export type CodeReview = z.infer<typeof CodeReviewSchema>;
+export declare const CodeReviewInsertSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        approved: "approved";
+        rejected: "rejected";
+        needs_changes: "needs_changes";
+        informational: "informational";
+    }>;
+    provenanceId: z.ZodString;
+    reviewerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewType: z.ZodEnum<{
+        human_review: "human_review";
+        ai_review: "ai_review";
+        human_approval: "human_approval";
+        ai_suggestion: "ai_suggestion";
+    }>;
+    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export type CodeReviewInsert = z.infer<typeof CodeReviewInsertSchema>;
+export declare function isAiGenerated(entry: Provenance): boolean;
+export declare function isHumanWritten(entry: Provenance): boolean;
+export declare function isAiAssisted(entry: Provenance): boolean;
+export declare function isMixedAuthorship(entry: Provenance): boolean;
+export declare function hasAiInvolvement(entry: Provenance): boolean;
+export declare function getAuthorTypeLabel(type: AuthorType): string;
+export declare function isUnreviewed(entry: Provenance): boolean;
+export declare function isHumanReviewed(entry: Provenance): boolean;
+export declare function isAiReviewed(entry: Provenance): boolean;
+export declare function isFullyReviewed(entry: Provenance): boolean;
+export declare function needsReview(entry: Provenance): boolean;
+export declare function needsHumanReview(entry: Provenance): boolean;
+export declare function getReviewStatusLabel(status: ReviewStatus): string;
+export declare function isHighConfidence(entry: Provenance): boolean;
+export declare function isLowConfidence(entry: Provenance): boolean;
+export declare function getConfidenceLabel(entry: Provenance): string;
+export declare function getProvenanceAge(entry: Provenance): number;
+export declare function getProvenanceAgeInDays(entry: Provenance): number;
+export declare function getTimeSinceReview(entry: Provenance): number | null;
+export declare function isStale(entry: Provenance): boolean;
+export declare function isRecentlyReviewed(entry: Provenance): boolean;
+export declare function isFileLevel(entry: Provenance): boolean;
+export declare function isFunctionLevel(entry: Provenance): boolean;
+export declare function hasLineRange(entry: Provenance): boolean;
+export declare function hasGitInfo(entry: Provenance): boolean;
+export declare function hasAiModel(entry: Provenance): boolean;
+export declare function calculateAiPercentage(entries: Provenance[]): number;
+export declare function calculateReviewCoverage(entries: Provenance[]): number;
+export declare function calculateHumanReviewCoverage(entries: Provenance[]): number;
+export declare function getEntriesByAuthorType(entries: Provenance[], type: AuthorType): Provenance[];
+export declare function getUnreviewedEntries(entries: Provenance[]): Provenance[];
+export declare function getEntriesNeedingHumanReview(entries: Provenance[]): Provenance[];
+interface PackageSummary {
+    packageName: string;
+    totalEntries: number;
+    totalLines: number;
+    aiPercentage: number;
+    reviewCoverage: number;
+    humanReviewCoverage: number;
+}
+export declare function summarizeByPackage(entries: Provenance[]): Map<string, PackageSummary>;
+export interface ProvenanceWithComputed extends Provenance {
+    _computed: {
+        isAiGenerated: boolean;
+        isHumanWritten: boolean;
+        isAiAssisted: boolean;
+        hasAiInvolvement: boolean;
+        isUnreviewed: boolean;
+        isHumanReviewed: boolean;
+        needsReview: boolean;
+        needsHumanReview: boolean;
+        isHighConfidence: boolean;
+        isStale: boolean;
+        ageInDays: number;
+        timeSinceReview: number | null;
+        authorTypeLabel: string;
+        reviewStatusLabel: string;
+        confidenceLabel: string;
+    };
+}
+export declare function provenanceToHuman(entry: Provenance): ProvenanceWithComputed;
+export declare function createProvenanceInsert(filePath: string, authorType: AuthorType, options?: {
+    id?: string;
+    functionName?: string;
+    lineStart?: number;
+    lineEnd?: number;
+    aiModel?: string;
+    aiSessionId?: string;
+    gitCommitHash?: string;
+    gitAuthor?: string;
+    confidence?: number;
+    linesOfCode?: number;
+    metadata?: unknown;
+}): ProvenanceInsert;
+export declare function createCodeReviewInsert(provenanceId: string, reviewType: ReviewType, status: ReviewDecision, options?: {
+    id?: string;
+    reviewerId?: string;
+    comment?: string;
+    metadata?: unknown;
+}): CodeReviewInsert;
+export {};
+//# sourceMappingURL=code-provenance.d.ts.map

package/dist/entities/code-provenance.d.ts.map

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