@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/github-status.schema.d.ts

@@ -0,0 +1,418 @@
+import { z } from 'zod';
+/**
+ * SSOT for `health.problems[].code` and aligned API error codes (e.g. repo-not-linked).
+ * Order is stable for documentation and diffs.
+ */
+export declare const PROJECT_GITHUB_HEALTH_PROBLEM_CODES: readonly ["GITHUB_NOT_CONNECTED", "GITHUB_INSTALLATION_MISSING", "GITHUB_APP_NOT_INSTALLED", "GITHUB_RATE_LIMITED", "GITHUB_ACTIONS_NOT_ACCESSIBLE", "PROJECT_REPO_NOT_LINKED", "GITHUB_PERMISSION_CONTENTS_READ_MISSING", "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING", "GITHUB_PERMISSION_PULL_REQUESTS_MISSING", "REPO_SCAN_NEVER_RUN", "REPO_SCAN_RUNNING", "REPO_SCAN_FAILED", "REPO_SCAN_ONLY_CURSOR_FOUND", "REPO_SCAN_ZERO_ROUTES", "REPO_SCAN_ZERO_MIGRATIONS", "REPO_SCAN_ZERO_WORKFLOWS", "KNOWLEDGE_GRAPH_EMPTY", "KNOWLEDGE_GRAPH_ZERO_EDGES", "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN", "IMPLEMENT_PR_WRITEBACK_NOT_READY"];
+export type ProjectGitHubHealthProblemCode = (typeof PROJECT_GITHUB_HEALTH_PROBLEM_CODES)[number];
+export declare const ProjectGitHubHealthProblemCodeSchema: z.ZodEnum<["GITHUB_NOT_CONNECTED", "GITHUB_INSTALLATION_MISSING", "GITHUB_APP_NOT_INSTALLED", "GITHUB_RATE_LIMITED", "GITHUB_ACTIONS_NOT_ACCESSIBLE", "PROJECT_REPO_NOT_LINKED", "GITHUB_PERMISSION_CONTENTS_READ_MISSING", "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING", "GITHUB_PERMISSION_PULL_REQUESTS_MISSING", "REPO_SCAN_NEVER_RUN", "REPO_SCAN_RUNNING", "REPO_SCAN_FAILED", "REPO_SCAN_ONLY_CURSOR_FOUND", "REPO_SCAN_ZERO_ROUTES", "REPO_SCAN_ZERO_MIGRATIONS", "REPO_SCAN_ZERO_WORKFLOWS", "KNOWLEDGE_GRAPH_EMPTY", "KNOWLEDGE_GRAPH_ZERO_EDGES", "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN", "IMPLEMENT_PR_WRITEBACK_NOT_READY"]>;
+/** Dot access: `ProjectGitHubHealthProblemCodes.GITHUB_NOT_CONNECTED`, etc. */
+export declare const ProjectGitHubHealthProblemCodes: { [K in ProjectGitHubHealthProblemCode]: K; };
+export declare const ProjectGitHubStatusSchema: z.ZodObject<{
+    githubConnected: z.ZodBoolean;
+    /** Canonical installation summary (additive; aligns with constitution DTO). */
+    githubInstallation: z.ZodObject<{
+        connected: z.ZodBoolean;
+        installationIdPresent: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        connected: boolean;
+        installationIdPresent: boolean;
+    }, {
+        connected: boolean;
+        installationIdPresent: boolean;
+    }>;
+    installationId: z.ZodNullable<z.ZodString>;
+    installationOwner: z.ZodNullable<z.ZodString>;
+    installationOwnerType: z.ZodNullable<z.ZodEnum<["User", "Organization"]>>;
+    /** Canonical linkage flag when `linkedRepository` is flattened elsewhere. */
+    repository: z.ZodObject<{
+        linked: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        linked: boolean;
+    }, {
+        linked: boolean;
+    }>;
+    linkedRepository: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodLiteral<"github">;
+        owner: z.ZodString;
+        name: z.ZodString;
+        fullName: z.ZodString;
+        defaultBranch: z.ZodString;
+        private: z.ZodBoolean;
+        htmlUrl: z.ZodString;
+        linkedAt: z.ZodString;
+        lastSyncedAt: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        fullName: string;
+        defaultBranch: string;
+        lastSyncedAt: string | null;
+        provider: "github";
+        private: boolean;
+        htmlUrl: string;
+        linkedAt: string;
+        owner: string;
+    }, {
+        id: string;
+        name: string;
+        fullName: string;
+        defaultBranch: string;
+        lastSyncedAt: string | null;
+        provider: "github";
+        private: boolean;
+        htmlUrl: string;
+        linkedAt: string;
+        owner: string;
+    }>>;
+    /** DB-derived workflow gate lineage (PRs, knowledge, artifacts) — complements repo scan. */
+    lineageSignals: z.ZodObject<{
+        hasPRs: z.ZodBoolean;
+        hasKnowledgeNodes: z.ZodBoolean;
+        hasWorkflowArtifacts: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        hasPRs: boolean;
+        hasKnowledgeNodes: boolean;
+        hasWorkflowArtifacts: boolean;
+    }, {
+        hasPRs: boolean;
+        hasKnowledgeNodes: boolean;
+        hasWorkflowArtifacts: boolean;
+    }>;
+    permissions: z.ZodObject<{
+        canReadContents: z.ZodBoolean;
+        canWriteContents: z.ZodBoolean;
+        canReadIssues: z.ZodBoolean;
+        canWriteIssues: z.ZodBoolean;
+        canReadPullRequests: z.ZodBoolean;
+        canWritePullRequests: z.ZodBoolean;
+        canReadActions: z.ZodBoolean;
+        canReadMetadata: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        canReadContents: boolean;
+        canWriteContents: boolean;
+        canReadIssues: boolean;
+        canWriteIssues: boolean;
+        canReadPullRequests: boolean;
+        canWritePullRequests: boolean;
+        canReadActions: boolean;
+        canReadMetadata: boolean;
+    }, {
+        canReadContents: boolean;
+        canWriteContents: boolean;
+        canReadIssues: boolean;
+        canWriteIssues: boolean;
+        canReadPullRequests: boolean;
+        canWritePullRequests: boolean;
+        canReadActions: boolean;
+        canReadMetadata: boolean;
+    }>;
+    scan: z.ZodObject<{
+        status: z.ZodEnum<["never_scanned", "queued", "running", "completed", "failed"]>;
+        /** True when `status === 'completed'`. */
+        ready: z.ZodBoolean;
+        lastScanId: z.ZodNullable<z.ZodString>;
+        lastStartedAt: z.ZodNullable<z.ZodString>;
+        lastCompletedAt: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+        counts: z.ZodObject<{
+            files: z.ZodNumber;
+            pages: z.ZodNumber;
+            apiRoutes: z.ZodNumber;
+            migrations: z.ZodNumber;
+            workflows: z.ZodNumber;
+            nodes: z.ZodNumber;
+            edges: z.ZodNumber;
+            issues: z.ZodNumber;
+            pullRequests: z.ZodNumber;
+            branches: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        }, {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        status: "running" | "completed" | "failed" | "queued" | "never_scanned";
+        lastCompletedAt: string | null;
+        ready: boolean;
+        counts: {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        };
+        lastScanId: string | null;
+        lastStartedAt: string | null;
+        lastError: string | null;
+    }, {
+        status: "running" | "completed" | "failed" | "queued" | "never_scanned";
+        lastCompletedAt: string | null;
+        ready: boolean;
+        counts: {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        };
+        lastScanId: string | null;
+        lastStartedAt: string | null;
+        lastError: string | null;
+    }>;
+    gate: z.ZodObject<{
+        canScan: z.ZodBoolean;
+        canProceedToImplement: z.ZodBoolean;
+        blockers: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        blockers: string[];
+        canScan: boolean;
+        canProceedToImplement: boolean;
+    }, {
+        blockers: string[];
+        canScan: boolean;
+        canProceedToImplement: boolean;
+    }>;
+    health: z.ZodObject<{
+        status: z.ZodEnum<["ok", "warning", "error"]>;
+        problems: z.ZodArray<z.ZodObject<{
+            code: z.ZodEnum<["GITHUB_NOT_CONNECTED", "GITHUB_INSTALLATION_MISSING", "GITHUB_APP_NOT_INSTALLED", "GITHUB_RATE_LIMITED", "GITHUB_ACTIONS_NOT_ACCESSIBLE", "PROJECT_REPO_NOT_LINKED", "GITHUB_PERMISSION_CONTENTS_READ_MISSING", "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING", "GITHUB_PERMISSION_PULL_REQUESTS_MISSING", "REPO_SCAN_NEVER_RUN", "REPO_SCAN_RUNNING", "REPO_SCAN_FAILED", "REPO_SCAN_ONLY_CURSOR_FOUND", "REPO_SCAN_ZERO_ROUTES", "REPO_SCAN_ZERO_MIGRATIONS", "REPO_SCAN_ZERO_WORKFLOWS", "KNOWLEDGE_GRAPH_EMPTY", "KNOWLEDGE_GRAPH_ZERO_EDGES", "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN", "IMPLEMENT_PR_WRITEBACK_NOT_READY"]>;
+            severity: z.ZodEnum<["info", "warning", "error"]>;
+            message: z.ZodString;
+            actionLabel: z.ZodOptional<z.ZodString>;
+            actionHref: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }, {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        status: "warning" | "error" | "ok";
+        problems: {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }[];
+    }, {
+        status: "warning" | "error" | "ok";
+        problems: {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }[];
+    }>;
+    repoReadiness: z.ZodEnum<["unknown", "linked", "scanning", "ready", "failed"]>;
+}, "strip", z.ZodTypeAny, {
+    scan: {
+        status: "running" | "completed" | "failed" | "queued" | "never_scanned";
+        lastCompletedAt: string | null;
+        ready: boolean;
+        counts: {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        };
+        lastScanId: string | null;
+        lastStartedAt: string | null;
+        lastError: string | null;
+    };
+    repository: {
+        linked: boolean;
+    };
+    repoReadiness: "unknown" | "failed" | "scanning" | "linked" | "ready";
+    permissions: {
+        canReadContents: boolean;
+        canWriteContents: boolean;
+        canReadIssues: boolean;
+        canWriteIssues: boolean;
+        canReadPullRequests: boolean;
+        canWritePullRequests: boolean;
+        canReadActions: boolean;
+        canReadMetadata: boolean;
+    };
+    gate: {
+        blockers: string[];
+        canScan: boolean;
+        canProceedToImplement: boolean;
+    };
+    githubConnected: boolean;
+    githubInstallation: {
+        connected: boolean;
+        installationIdPresent: boolean;
+    };
+    installationId: string | null;
+    installationOwner: string | null;
+    installationOwnerType: "User" | "Organization" | null;
+    linkedRepository: {
+        id: string;
+        name: string;
+        fullName: string;
+        defaultBranch: string;
+        lastSyncedAt: string | null;
+        provider: "github";
+        private: boolean;
+        htmlUrl: string;
+        linkedAt: string;
+        owner: string;
+    } | null;
+    lineageSignals: {
+        hasPRs: boolean;
+        hasKnowledgeNodes: boolean;
+        hasWorkflowArtifacts: boolean;
+    };
+    health: {
+        status: "warning" | "error" | "ok";
+        problems: {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }[];
+    };
+}, {
+    scan: {
+        status: "running" | "completed" | "failed" | "queued" | "never_scanned";
+        lastCompletedAt: string | null;
+        ready: boolean;
+        counts: {
+            issues: number;
+            pages: number;
+            migrations: number;
+            nodes: number;
+            edges: number;
+            files: number;
+            workflows: number;
+            apiRoutes: number;
+            pullRequests: number;
+            branches: number;
+        };
+        lastScanId: string | null;
+        lastStartedAt: string | null;
+        lastError: string | null;
+    };
+    repository: {
+        linked: boolean;
+    };
+    repoReadiness: "unknown" | "failed" | "scanning" | "linked" | "ready";
+    permissions: {
+        canReadContents: boolean;
+        canWriteContents: boolean;
+        canReadIssues: boolean;
+        canWriteIssues: boolean;
+        canReadPullRequests: boolean;
+        canWritePullRequests: boolean;
+        canReadActions: boolean;
+        canReadMetadata: boolean;
+    };
+    gate: {
+        blockers: string[];
+        canScan: boolean;
+        canProceedToImplement: boolean;
+    };
+    githubConnected: boolean;
+    githubInstallation: {
+        connected: boolean;
+        installationIdPresent: boolean;
+    };
+    installationId: string | null;
+    installationOwner: string | null;
+    installationOwnerType: "User" | "Organization" | null;
+    linkedRepository: {
+        id: string;
+        name: string;
+        fullName: string;
+        defaultBranch: string;
+        lastSyncedAt: string | null;
+        provider: "github";
+        private: boolean;
+        htmlUrl: string;
+        linkedAt: string;
+        owner: string;
+    } | null;
+    lineageSignals: {
+        hasPRs: boolean;
+        hasKnowledgeNodes: boolean;
+        hasWorkflowArtifacts: boolean;
+    };
+    health: {
+        status: "warning" | "error" | "ok";
+        problems: {
+            code: "GITHUB_NOT_CONNECTED" | "GITHUB_INSTALLATION_MISSING" | "GITHUB_APP_NOT_INSTALLED" | "GITHUB_RATE_LIMITED" | "GITHUB_ACTIONS_NOT_ACCESSIBLE" | "PROJECT_REPO_NOT_LINKED" | "GITHUB_PERMISSION_CONTENTS_READ_MISSING" | "GITHUB_PERMISSION_CONTENTS_WRITE_MISSING" | "GITHUB_PERMISSION_PULL_REQUESTS_MISSING" | "REPO_SCAN_NEVER_RUN" | "REPO_SCAN_RUNNING" | "REPO_SCAN_FAILED" | "REPO_SCAN_ONLY_CURSOR_FOUND" | "REPO_SCAN_ZERO_ROUTES" | "REPO_SCAN_ZERO_MIGRATIONS" | "REPO_SCAN_ZERO_WORKFLOWS" | "KNOWLEDGE_GRAPH_EMPTY" | "KNOWLEDGE_GRAPH_ZERO_EDGES" | "WEBHOOK_NOT_CONFIGURED_OR_UNSEEN" | "IMPLEMENT_PR_WRITEBACK_NOT_READY";
+            message: string;
+            severity: "info" | "warning" | "error";
+            actionLabel?: string | undefined;
+            actionHref?: string | undefined;
+        }[];
+    };
+}>;
+export type ProjectGitHubStatus = z.infer<typeof ProjectGitHubStatusSchema>;
+/** GET `/api/integrations/github/status` without `projectId` (account-level connection summary). */
+export declare const GitHubAccountConnectionStatusSchema: z.ZodObject<{
+    connected: z.ZodBoolean;
+    installationId: z.ZodNullable<z.ZodNumber>;
+    repositories: z.ZodNumber;
+    status: z.ZodString;
+    connectedAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    connected: boolean;
+    installationId: number | null;
+    repositories: number;
+    connectedAt: string | null;
+}, {
+    status: string;
+    connected: boolean;
+    installationId: number | null;
+    repositories: number;
+    connectedAt: string | null;
+}>;
+export type GitHubAccountConnectionStatus = z.infer<typeof GitHubAccountConnectionStatusSchema>;

package/dist/schemas/github-status.schema.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubAccountConnectionStatusSchema = exports.ProjectGitHubStatusSchema = exports.ProjectGitHubHealthProblemCodes = exports.ProjectGitHubHealthProblemCodeSchema = exports.PROJECT_GITHUB_HEALTH_PROBLEM_CODES = void 0;
+const zod_1 = require("zod");
+const repo_readiness_schema_1 = require("./repos/repo-readiness.schema");
+/**
+ * SSOT for `health.problems[].code` and aligned API error codes (e.g. repo-not-linked).
+ * Order is stable for documentation and diffs.
+ */
+exports.PROJECT_GITHUB_HEALTH_PROBLEM_CODES = [
+    'GITHUB_NOT_CONNECTED',
+    'GITHUB_INSTALLATION_MISSING',
+    'GITHUB_APP_NOT_INSTALLED',
+    'GITHUB_RATE_LIMITED',
+    'GITHUB_ACTIONS_NOT_ACCESSIBLE',
+    'PROJECT_REPO_NOT_LINKED',
+    'GITHUB_PERMISSION_CONTENTS_READ_MISSING',
+    'GITHUB_PERMISSION_CONTENTS_WRITE_MISSING',
+    'GITHUB_PERMISSION_PULL_REQUESTS_MISSING',
+    'REPO_SCAN_NEVER_RUN',
+    'REPO_SCAN_RUNNING',
+    'REPO_SCAN_FAILED',
+    'REPO_SCAN_ONLY_CURSOR_FOUND',
+    'REPO_SCAN_ZERO_ROUTES',
+    'REPO_SCAN_ZERO_MIGRATIONS',
+    'REPO_SCAN_ZERO_WORKFLOWS',
+    'KNOWLEDGE_GRAPH_EMPTY',
+    'KNOWLEDGE_GRAPH_ZERO_EDGES',
+    'WEBHOOK_NOT_CONFIGURED_OR_UNSEEN',
+    'IMPLEMENT_PR_WRITEBACK_NOT_READY',
+];
+exports.ProjectGitHubHealthProblemCodeSchema = zod_1.z.enum(exports.PROJECT_GITHUB_HEALTH_PROBLEM_CODES);
+/** Dot access: `ProjectGitHubHealthProblemCodes.GITHUB_NOT_CONNECTED`, etc. */
+exports.ProjectGitHubHealthProblemCodes = Object.fromEntries(exports.PROJECT_GITHUB_HEALTH_PROBLEM_CODES.map((c) => [c, c]));
+exports.ProjectGitHubStatusSchema = zod_1.z.object({
+    githubConnected: zod_1.z.boolean(),
+    /** Canonical installation summary (additive; aligns with constitution DTO). */
+    githubInstallation: zod_1.z.object({
+        connected: zod_1.z.boolean(),
+        installationIdPresent: zod_1.z.boolean(),
+    }),
+    installationId: zod_1.z.string().nullable(),
+    installationOwner: zod_1.z.string().nullable(),
+    installationOwnerType: zod_1.z.enum(['User', 'Organization']).nullable(),
+    /** Canonical linkage flag when `linkedRepository` is flattened elsewhere. */
+    repository: zod_1.z.object({
+        linked: zod_1.z.boolean(),
+    }),
+    linkedRepository: zod_1.z.object({
+        id: zod_1.z.string(),
+        provider: zod_1.z.literal('github'),
+        owner: zod_1.z.string(),
+        name: zod_1.z.string(),
+        fullName: zod_1.z.string(),
+        defaultBranch: zod_1.z.string(),
+        private: zod_1.z.boolean(),
+        htmlUrl: zod_1.z.string(),
+        linkedAt: zod_1.z.string(),
+        lastSyncedAt: zod_1.z.string().nullable(),
+    }).nullable(),
+    /** DB-derived workflow gate lineage (PRs, knowledge, artifacts) — complements repo scan. */
+    lineageSignals: zod_1.z.object({
+        hasPRs: zod_1.z.boolean(),
+        hasKnowledgeNodes: zod_1.z.boolean(),
+        hasWorkflowArtifacts: zod_1.z.boolean(),
+    }),
+    permissions: zod_1.z.object({
+        canReadContents: zod_1.z.boolean(),
+        canWriteContents: zod_1.z.boolean(),
+        canReadIssues: zod_1.z.boolean(),
+        canWriteIssues: zod_1.z.boolean(),
+        canReadPullRequests: zod_1.z.boolean(),
+        canWritePullRequests: zod_1.z.boolean(),
+        canReadActions: zod_1.z.boolean(),
+        canReadMetadata: zod_1.z.boolean(),
+    }),
+    scan: zod_1.z.object({
+        status: zod_1.z.enum(['never_scanned', 'queued', 'running', 'completed', 'failed']),
+        /** True when `status === 'completed'`. */
+        ready: zod_1.z.boolean(),
+        lastScanId: zod_1.z.string().nullable(),
+        lastStartedAt: zod_1.z.string().nullable(),
+        lastCompletedAt: zod_1.z.string().nullable(),
+        lastError: zod_1.z.string().nullable(),
+        counts: zod_1.z.object({
+            files: zod_1.z.number(),
+            pages: zod_1.z.number(),
+            apiRoutes: zod_1.z.number(),
+            migrations: zod_1.z.number(),
+            workflows: zod_1.z.number(),
+            nodes: zod_1.z.number(),
+            edges: zod_1.z.number(),
+            issues: zod_1.z.number(),
+            pullRequests: zod_1.z.number(),
+            branches: zod_1.z.number(),
+        }),
+    }),
+    gate: zod_1.z.object({
+        canScan: zod_1.z.boolean(),
+        canProceedToImplement: zod_1.z.boolean(),
+        blockers: zod_1.z.array(zod_1.z.string()),
+    }),
+    health: zod_1.z.object({
+        status: zod_1.z.enum(['ok', 'warning', 'error']),
+        problems: zod_1.z.array(zod_1.z.object({
+            code: exports.ProjectGitHubHealthProblemCodeSchema,
+            severity: zod_1.z.enum(['info', 'warning', 'error']),
+            message: zod_1.z.string(),
+            actionLabel: zod_1.z.string().optional(),
+            actionHref: zod_1.z.string().optional(),
+        })),
+    }),
+    repoReadiness: repo_readiness_schema_1.RepoReadinessSchema,
+});
+/** GET `/api/integrations/github/status` without `projectId` (account-level connection summary). */
+exports.GitHubAccountConnectionStatusSchema = zod_1.z.object({
+    connected: zod_1.z.boolean(),
+    installationId: zod_1.z.number().nullable(),
+    repositories: zod_1.z.number(),
+    status: zod_1.z.string(),
+    connectedAt: zod_1.z.string().nullable(),
+});

package/dist/schemas/graph/edge-v2.schema.d.ts

@@ -0,0 +1,85 @@
+/**
+ * NeuraLoom — Knowledge Graph v2 edge types (skeleton)
+ *
+ * Refs: GH umbrella #689, task #698, KG deep-research subagent finding.
+ * Canvas: canvases/mega-sprint-01-knowledge-graph-foundation.canvas.tsx
+ *
+ * ────────────────────────────────────────────────────────────────────────────
+ * LEGACY COMPATIBILITY — backfill of 145,013 `knowledge_edges` rows
+ * ────────────────────────────────────────────────────────────────────────────
+ * The live `public.knowledge_edges` table already constrains its `relation`
+ * column to a fixed set of 16 string values (see
+ * `supabase/migrations/20260504123000_baseline_from_live_db_v2.sql`,
+ * `knowledge_edges_relation_check`):
+ *
+ *   implements, depends_on, validated_by, deployed_to, generated_from,
+ *   tested_by, approved_by, blocks, references, supersedes, derived_from,
+ *   task_in_patch, patch_opens_pr, pr_touches_file, task_covered_by_file,
+ *   task_duplicated_across_prs
+ *
+ * The KG-v2 edge registry below is a SUPERSET. To keep all 145k legacy rows
+ * survivable on backfill (MS01-T9 / #705), every legacy value MUST map to a
+ * KG-v2 edge type via `LEGACY_RELATION_TO_KG_V2_EDGE` below. Promoting the
+ * draft migration out of `supabase/migrations/_drafts/` MUST also relax (or
+ * drop) the legacy CHECK constraint OR add a translation column — the
+ * backfill task picks the strategy.
+ * ────────────────────────────────────────────────────────────────────────────
+ */
+import { z } from "zod";
+/**
+ * Canonical edge-type registry for KG-v2.
+ *
+ * Grouped (informational only) by the relationship they express:
+ *   - Cross-layer: IMPLEMENTS_REQUIREMENT, TESTED_BY, VERIFIED_BY, etc.
+ *   - Architecture: USES_TABLE, EXPOSES_ENDPOINT, RENDERS_COMPONENT, etc.
+ *   - Code Reality: DEFINED_IN, IMPORTS, CALLS, INTRODUCED_BY_PR, etc.
+ *   - Security: PROTECTED_BY_RLS, CONTAINS_PII, CODE_MATCHES_UNSAFE_PATTERN, etc.
+ *   - Lifecycle: SUPERSEDES, DUPLICATES, DRIFTS_FROM
+ */
+export declare const KgEdgeTypeSchema: z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>;
+export type KgEdgeType = z.infer<typeof KgEdgeTypeSchema>;
+/**
+ * Canonical mapping from legacy `public.knowledge_edges.relation` values to
+ * KG-v2 `KgEdgeTypeSchema` members. Every entry in the legacy CHECK
+ * constraint (16 values) MUST be present here — `LEGACY_RELATION_VALUES`
+ * below is the assertion source for the unit test in MS01-T10 (#706).
+ *
+ * This constant is the single instruction the MS01-T9 backfill script
+ * (#705) consults; do not duplicate the mapping anywhere else.
+ */
+export declare const LEGACY_RELATION_TO_KG_V2_EDGE: {
+    readonly implements: "IMPLEMENTS_REQUIREMENT";
+    readonly depends_on: "DEPENDS_ON";
+    readonly validated_by: "VERIFIED_BY";
+    readonly deployed_to: "DEPLOYED_AS";
+    readonly generated_from: "GENERATES_FILE";
+    readonly tested_by: "TESTED_BY";
+    readonly approved_by: "ACCEPTED_BY";
+    readonly blocks: "DEPENDS_ON";
+    readonly references: "REFERENCES";
+    readonly supersedes: "SUPERSEDES";
+    readonly derived_from: "GENERATES_FILE";
+    readonly task_in_patch: "INTRODUCED_BY_PR";
+    readonly patch_opens_pr: "INTRODUCED_BY_PR";
+    readonly pr_touches_file: "MODIFIED_BY_COMMIT";
+    readonly task_covered_by_file: "IMPLEMENTS_REQUIREMENT";
+    readonly task_duplicated_across_prs: "DUPLICATES";
+};
+/** Closed list of legacy values the live DB constraint enforces. */
+export declare const LEGACY_RELATION_VALUES: readonly ["implements", "depends_on", "validated_by", "deployed_to", "generated_from", "tested_by", "approved_by", "blocks", "references", "supersedes", "derived_from", "task_in_patch", "patch_opens_pr", "pr_touches_file", "task_covered_by_file", "task_duplicated_across_prs"];
+export type LegacyRelation = (typeof LEGACY_RELATION_VALUES)[number];
+/**
+ * Columns added to `public.knowledge_edges` for KG v2 semantic edge registry.
+ * Legacy `relation` stays CHECK-constrained until a follow-up migration widens it.
+ */
+export declare const KnowledgeEdgeKgOverlaySchema: z.ZodObject<{
+    kg_edge_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<["IMPLEMENTS_REQUIREMENT", "ACCEPTED_BY", "TESTED_BY", "VERIFIED_BY", "DEPLOYED_AS", "GENERATED_FROM_ARTIFACT", "HAS_ENDPOINT", "HAS_COMPONENT", "GOVERNS", "OWNS_TABLE", "EXPOSES_ENDPOINT", "USES_TABLE", "USES_POLICY", "RENDERS_COMPONENT", "CALLS_ENDPOINT", "USES_ENV", "PROTECTED_BY_RLS", "DEPENDS_ON", "GENERATES_FILE", "DEFINED_IN", "IMPORTS", "EXPORTS", "CALLS", "REFERENCES", "VALIDATES_WITH", "READS_TABLE", "WRITES_TABLE", "GUARDED_BY", "INTRODUCED_BY_PR", "MODIFIED_BY_COMMIT", "ROUTE_HANDLED_BY_FILE", "ROUTE_USES_SCHEMA", "ROUTE_REQUIRES_AUTH", "ROUTE_CALLED_BY_COMPONENT", "ROUTE_EXPOSED_IN_CONTRACTS", "ROUTE_REGISTERED_IN_API_CLIENT", "TABLE_HAS_COLUMN", "TABLE_HAS_INDEX", "TABLE_HAS_CONSTRAINT", "COLUMN_REFERENCES_COLUMN", "TABLE_PROTECTED_BY_RLS", "RLS_POLICY_APPLIES_TO_TABLE", "RLS_POLICY_USES_ROLE", "MIGRATION_CREATES_TABLE", "MIGRATION_ALTERS_TABLE", "ROUTE_REQUIRES_PERMISSION", "TABLE_CONTAINS_PII", "PII_PROTECTED_BY_RLS", "ENV_USED_BY_FILE", "SECRET_USED_BY_SERVICE", "DEPENDENCY_HAS_VULNERABILITY", "CODE_MATCHES_UNSAFE_PATTERN", "PUBLIC_ROUTE_TOUCHES_TABLE", "WEBHOOK_VERIFIED_BY_SIGNATURE", "SUPERSEDES", "DUPLICATES", "DRIFTS_FROM", "TASK_FROM_FINDING", "FINDING_FROM_PROBE", "ISSUE_FROM_FINDING"]>>>;
+    kg_evidence: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    kg_evidence: Record<string, unknown>;
+    kg_edge_type?: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null | undefined;
+}, {
+    kg_edge_type?: "IMPLEMENTS_REQUIREMENT" | "ACCEPTED_BY" | "TESTED_BY" | "VERIFIED_BY" | "DEPLOYED_AS" | "GENERATED_FROM_ARTIFACT" | "HAS_ENDPOINT" | "HAS_COMPONENT" | "GOVERNS" | "OWNS_TABLE" | "EXPOSES_ENDPOINT" | "USES_TABLE" | "USES_POLICY" | "RENDERS_COMPONENT" | "CALLS_ENDPOINT" | "USES_ENV" | "PROTECTED_BY_RLS" | "DEPENDS_ON" | "GENERATES_FILE" | "DEFINED_IN" | "IMPORTS" | "EXPORTS" | "CALLS" | "REFERENCES" | "VALIDATES_WITH" | "READS_TABLE" | "WRITES_TABLE" | "GUARDED_BY" | "INTRODUCED_BY_PR" | "MODIFIED_BY_COMMIT" | "ROUTE_HANDLED_BY_FILE" | "ROUTE_USES_SCHEMA" | "ROUTE_REQUIRES_AUTH" | "ROUTE_CALLED_BY_COMPONENT" | "ROUTE_EXPOSED_IN_CONTRACTS" | "ROUTE_REGISTERED_IN_API_CLIENT" | "TABLE_HAS_COLUMN" | "TABLE_HAS_INDEX" | "TABLE_HAS_CONSTRAINT" | "COLUMN_REFERENCES_COLUMN" | "TABLE_PROTECTED_BY_RLS" | "RLS_POLICY_APPLIES_TO_TABLE" | "RLS_POLICY_USES_ROLE" | "MIGRATION_CREATES_TABLE" | "MIGRATION_ALTERS_TABLE" | "ROUTE_REQUIRES_PERMISSION" | "TABLE_CONTAINS_PII" | "PII_PROTECTED_BY_RLS" | "ENV_USED_BY_FILE" | "SECRET_USED_BY_SERVICE" | "DEPENDENCY_HAS_VULNERABILITY" | "CODE_MATCHES_UNSAFE_PATTERN" | "PUBLIC_ROUTE_TOUCHES_TABLE" | "WEBHOOK_VERIFIED_BY_SIGNATURE" | "SUPERSEDES" | "DUPLICATES" | "DRIFTS_FROM" | "TASK_FROM_FINDING" | "FINDING_FROM_PROBE" | "ISSUE_FROM_FINDING" | null | undefined;
+    kg_evidence?: Record<string, unknown> | undefined;
+}>;
+export type KnowledgeEdgeKgOverlay = z.infer<typeof KnowledgeEdgeKgOverlaySchema>;