@vibe-validate/cli 0.17.6 → 0.18.0-rc.1

package/dist/schemas/watch-pr-result.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-pr-result.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/watch-pr-result.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,mDAAiD,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,sGAQhC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,iGASjC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,yCAAuC,CAAC;AAMnE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mBAAmB;;IAGnB,kBAAkB;;IAGlB,gBAAgB;;;;;;;;;;EAEhB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gBAAgB;;IAGhB,eAAe;;IAGf,aAAa;;IAGb,uBAAuB;;IAGvB,qDAAqD;;IAGrD,yBAAyB;;IAGzB,0BAA0B;;IAG1B,2BAA2B;;IAG3B,0DAA0D;;IAG1D,gBAAgB;;IAGhB,sDAAsD;;QA9CtD,mBAAmB;;QAGnB,kBAAkB;;QAGlB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ChB,CAAC;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;IAClC,iBAAiB;;IAGjB,oDAAoD;;IAGpD,gDAAgD;;IAGhD,mCAAmC;;IAGnC,oBAAoB;;IAGpB,wCAAwC;;IAGxC,8CAA8C;;IAG9C,gDAAgD;;IAGhD;;;;;;;;OAQG;;;;;;;;;;;;;;;gBAyDuC,CAAC;gBAEZ,CAAA;kBAAqC,CAAA;gBACpD,CAAA;oBAEO,CAAC;mBACnB,CAAC;oBAGN,CAAC;;;gBAGoC,CAAC;gBACd,CAAC;kBAAqC,CAAA;gBAE1C,CAAC;oBACR,CAAC;mBACkB,CAAC;oBAEJ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA2ElB,CAAC;;;;;;uBAOX,CAAC;;;;;qBASF,CAAC;;;;;;uBAIG,CAAC;;;;;;;gBAIc,CAAC;gBAGlB,CAAC;kBAEO,CAAC;gBACE,CAAC;oBAEc,CAAC;mBACU,CAAC;oBAGjB,CAAC;;;;;;;;qBASpB,CAAA;;;;;;uBAKqB,CAAC;;;;;;;gBAMuB,CAAC;gBAC9C,CAAC;kBACU,CAAC;gBAAkC,CAAC;oBAG/C,CAAC;mBAEqB,CAAC;oBAEjB,CAAC;;;;;;;;qBAKK,CAAC;;;;;;uBAMK,CAAC;;;;;;;;;;;;;;;gBApDJ,CAAC;gBAGlB,CAAC;kBAEO,CAAC;gBACE,CAAC;oBAEc,CAAC;mBACU,CAAC;oBAGjB,CAAC;;;;;;;;qBASpB,CAAA;;;;;;uBAKqB,CAAC;;;;;;;;;;;;;;;;;gBAMuB,CAAC;gBAC9C,CAAC;kBACU,CAAC;gBAAkC,CAAC;oBAG/C,CAAC;mBAEqB,CAAC;oBAEjB,CAAC;;;;;;;;qBAKK,CAAC;;;;;;uBAMK,CAAC;;;;;EAjOxB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;IACrC,iDAAiD;;IAGjD,6CAA6C;;IAG7C,qBAAqB;;;;;;;;;;EAErB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;IAC9B,qEAAqE;;IAGrE,mBAAmB;;IAGnB,gDAAgD;;IAGhD,qDAAqD;;IAGrD,oDAAoD;;IAGpD,kDAAkD;;QAhClD,iDAAiD;;QAGjD,6CAA6C;;QAG7C,qBAAqB;;;;;;;;;;;IA6BrB,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;IACpC,uDAAuD;;IAGvD,oFAAoF;;IAGpF,kEAAkE;;;;;;;;;;EAElE,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;IAC9B,6BAA6B;;IAG7B,8BAA8B;;IAG9B,8BAA8B;;IAG9B,+BAA+B;;IAG/B,2EAA2E;;QA7B3E,uDAAuD;;QAGvD,oFAAoF;;QAGpF,kEAAkE;;;;;;;;;;;IA0BlE,kEAAkE;;QAxHlE,iBAAiB;;QAGjB,oDAAoD;;QAGpD,gDAAgD;;QAGhD,mCAAmC;;QAGnC,oBAAoB;;QAGpB,wCAAwC;;QAGxC,8CAA8C;;QAG9C,gDAAgD;;QAGhD;;;;;;;;WAQG;;;;;;;;;;;;;;;oBAyDuC,CAAC;oBAEZ,CAAA;sBAAqC,CAAA;oBACpD,CAAA;wBAEO,CAAC;uBACnB,CAAC;wBAGN,CAAC;;;oBAGoC,CAAC;oBACd,CAAC;sBAAqC,CAAA;oBAE1C,CAAC;wBACR,CAAC;uBACkB,CAAC;wBAEJ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA2ElB,CAAC;;;;;;2BAOX,CAAC;;;;;yBASF,CAAC;;;;;;2BAIG,CAAC;;;;;;;oBAIc,CAAC;oBAGlB,CAAC;sBAEO,CAAC;oBACE,CAAC;wBAEc,CAAC;uBACU,CAAC;wBAGjB,CAAC;;;;;;;;yBASpB,CAAA;;;;;;2BAKqB,CAAC;;;;;;;oBAMuB,CAAC;oBAC9C,CAAC;sBACU,CAAC;oBAAkC,CAAC;wBAG/C,CAAC;uBAEqB,CAAC;wBAEjB,CAAC;;;;;;;;yBAKK,CAAC;;;;;;2BAMK,CAAC;;;;;;;;;;;;;;;oBApDJ,CAAC;oBAGlB,CAAC;sBAEO,CAAC;oBACE,CAAC;wBAEc,CAAC;uBACU,CAAC;wBAGjB,CAAC;;;;;;;;yBASpB,CAAA;;;;;;2BAKqB,CAAC;;;;;;;;;;;;;;;;;oBAMuB,CAAC;oBAC9C,CAAC;sBACU,CAAC;oBAAkC,CAAC;wBAG/C,CAAC;uBAEqB,CAAC;wBAEjB,CAAC;;;;;;;;yBAKK,CAAC;;;;;;2BAMK,CAAC;;;;;;IAxIxB,gEAAgE;;QAhEhE,qEAAqE;;QAGrE,mBAAmB;;QAGnB,gDAAgD;;QAGhD,qDAAqD;;QAGrD,oDAAoD;;QAGpD,kDAAkD;;YAhClD,iDAAiD;;YAGjD,6CAA6C;;YAG7C,qBAAqB;;;;;;;;;;;QA6BrB,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAkIrB,CAAC;oBAGlB,CAAC;sBAEO,CAAC;oBACE,CAAC;wBAEc,CAAC;uBACU,CAAC;wBAGjB,CAAC;;;;;;;;yBASpB,CAAA;;;;;;2BAKqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAMuB,CAAC;oBAC9C,CAAC;sBACU,CAAC;oBAAkC,CAAC;wBAG/C,CAAC;uBAEqB,CAAC;wBAEjB,CAAC;;;;;;;;yBAKK,CAAC;;;;;;2BAMK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;EAtIxB,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gBAAgB;;IAGhB,+BAA+B;;IAG/B,8BAA8B;;IAG9B,0BAA0B;;;;;;;;;;;;EAE1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B,oCAAoC;;IAGpC,4CAA4C;;IAG5C,2CAA2C;;IAG3C,kCAAkC;;IAGlC,sEAAsE;;QAhCtE,gBAAgB;;QAGhB,+BAA+B;;QAG/B,8BAA8B;;QAG9B,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB1B,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,yBAAyB;;IAGzB,gDAAgD;;IAGhD,sCAAsC;;IAGtC,wCAAwC;;;;;;;;;;;;EAExC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc;IACzB,+CAA+C;;IAG/C,uCAAuC;;IAGvC,uBAAuB;;IAGvB,6BAA6B;;IAG7B,qCAAqC;;QAhCrC,yBAAyB;;QAGzB,gDAAgD;;QAGhD,sCAAsC;;QAGtC,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBxC,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,eAAe;IAC1B,+BAA+B;;IAG/B,4CAA4C;;IAG5C,wCAAwC;;;;;;;;;;EAExC,CAAC;AAMH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB;IAC9B,4EAA4E;;QAlT5E,gBAAgB;;QAGhB,eAAe;;QAGf,aAAa;;QAGb,uBAAuB;;QAGvB,qDAAqD;;QAGrD,yBAAyB;;QAGzB,0BAA0B;;QAG1B,2BAA2B;;QAG3B,0DAA0D;;QAG1D,gBAAgB;;QAGhB,sDAAsD;;YA9CtD,mBAAmB;;YAGnB,kBAAkB;;YAGlB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+ThB,+CAA+C;;IAG/C,yCAAyC;;QAjKzC,6BAA6B;;QAG7B,8BAA8B;;QAG9B,8BAA8B;;QAG9B,+BAA+B;;QAG/B,2EAA2E;;YA7B3E,uDAAuD;;YAGvD,oFAAoF;;YAGpF,kEAAkE;;;;;;;;;;;QA0BlE,kEAAkE;;YAxHlE,iBAAiB;;YAGjB,oDAAoD;;YAGpD,gDAAgD;;YAGhD,mCAAmC;;YAGnC,oBAAoB;;YAGpB,wCAAwC;;YAGxC,8CAA8C;;YAG9C,gDAAgD;;YAGhD;;;;;;;;eAQG;;;;;;;;;;;;;;;wBAyDuC,CAAC;wBAEZ,CAAA;0BAAqC,CAAA;wBACpD,CAAA;4BAEO,CAAC;2BACnB,CAAC;4BAGN,CAAC;;;wBAGoC,CAAC;wBACd,CAAC;0BAAqC,CAAA;wBAE1C,CAAC;4BACR,CAAC;2BACkB,CAAC;4BAEJ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA2ElB,CAAC;;;;;;+BAOX,CAAC;;;;;6BASF,CAAC;;;;;;+BAIG,CAAC;;;;;;;wBAIc,CAAC;wBAGlB,CAAC;0BAEO,CAAC;wBACE,CAAC;4BAEc,CAAC;2BACU,CAAC;4BAGjB,CAAC;;;;;;;;6BASpB,CAAA;;;;;;+BAKqB,CAAC;;;;;;;wBAMuB,CAAC;wBAC9C,CAAC;0BACU,CAAC;wBAAkC,CAAC;4BAG/C,CAAC;2BAEqB,CAAC;4BAEjB,CAAC;;;;;;;;6BAKK,CAAC;;;;;;+BAMK,CAAC;;;;;;;;;;;;;;;wBApDJ,CAAC;wBAGlB,CAAC;0BAEO,CAAC;wBACE,CAAC;4BAEc,CAAC;2BACU,CAAC;4BAGjB,CAAC;;;;;;;;6BASpB,CAAA;;;;;;+BAKqB,CAAC;;;;;;;;;;;;;;;;;wBAMuB,CAAC;wBAC9C,CAAC;0BACU,CAAC;wBAAkC,CAAC;4BAG/C,CAAC;2BAEqB,CAAC;4BAEjB,CAAC;;;;;;;;6BAKK,CAAC;;;;;;+BAMK,CAAC;;;;;;QAxIxB,gEAAgE;;YAhEhE,qEAAqE;;YAGrE,mBAAmB;;YAGnB,gDAAgD;;YAGhD,qDAAqD;;YAGrD,oDAAoD;;YAGpD,kDAAkD;;gBAhClD,iDAAiD;;gBAGjD,6CAA6C;;gBAG7C,qBAAqB;;;;;;;;;;;YA6BrB,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkIrB,CAAC;wBAGlB,CAAC;0BAEO,CAAC;wBACE,CAAC;4BAEc,CAAC;2BACU,CAAC;4BAGjB,CAAC;;;;;;;;6BASpB,CAAA;;;;;;+BAKqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAMuB,CAAC;wBAC9C,CAAC;0BACU,CAAC;wBAAkC,CAAC;4BAG/C,CAAC;2BAEqB,CAAC;4BAEjB,CAAC;;;;;;;;6BAKK,CAAC;;;;;;+BAMK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;IAUxB,6DAA6D;;QAhH7D,oCAAoC;;QAGpC,4CAA4C;;QAG5C,2CAA2C;;QAG3C,kCAAkC;;QAGlC,sEAAsE;;YAhCtE,gBAAgB;;YAGhB,+BAA+B;;YAG/B,8BAA8B;;YAG9B,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8H1B,sDAAsD;;QArEtD,+CAA+C;;QAG/C,uCAAuC;;QAGvC,uBAAuB;;QAGvB,6BAA6B;;QAG7B,qCAAqC;;YAhCrC,yBAAyB;;YAGzB,gDAAgD;;YAGhD,sCAAsC;;YAGtC,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmFxC,gCAAgC;;QA9ChC,+BAA+B;;QAG/B,4CAA4C;;QAG5C,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA5BpB,CAAC;wBAGlB,CAAC;0BAEO,CAAC;wBACE,CAAC;4BAEc,CAAC;2BACU,CAAC;4BAGjB,CAAC;;;;;;;;6BASpB,CAAA;;;;;;+BAKqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAMuB,CAAC;wBAC9C,CAAC;0BACU,CAAC;wBAAkC,CAAC;4BAG/C,CAAC;2BAEqB,CAAC;4BAEjB,CAAC;;;;;;;;6BAKK,CAAC;;;;;;+BAMK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxB,CAAC;AAMH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/watch-pr-result.schema.js

@@ -0,0 +1,335 @@
+/**
+ * Zod Schema for Watch PR Results
+ *
+ * CRITICAL PROJECT REQUIREMENT: All YAML-serializable types MUST be Zod schemas.
+ * Use z.infer<> to derive TypeScript types. Manual interfaces only for non-serializable data.
+ *
+ * This schema defines the complete structure of watch-pr command output,
+ * enabling runtime validation and JSON Schema generation.
+ *
+ * Output follows "Newspaper Philosophy" ordering: most important info first.
+ *
+ * @packageDocumentation
+ */
+import { ErrorExtractorResultSchema } from '@vibe-validate/extractors';
+import { z } from 'zod';
+// ============================================================================
+// Enums
+// ============================================================================
+/**
+ * Check Status Enum
+ *
+ * GitHub check run status
+ */
+export const CheckStatusSchema = z.enum(['queued', 'in_progress', 'completed']);
+/**
+ * Check Conclusion Enum
+ *
+ * GitHub check run conclusion (present when status is 'completed')
+ */
+export const CheckConclusionSchema = z.enum([
+    'success',
+    'failure',
+    'neutral',
+    'cancelled',
+    'skipped',
+    'timed_out',
+    'action_required',
+]);
+/**
+ * Merge State Status Enum
+ *
+ * GitHub PR merge state status
+ */
+export const MergeStateStatusSchema = z.enum([
+    'BEHIND',
+    'BLOCKED',
+    'CLEAN',
+    'DIRTY',
+    'DRAFT',
+    'HAS_HOOKS',
+    'UNKNOWN',
+    'UNSTABLE',
+]);
+/**
+ * Severity Enum
+ *
+ * Severity level for guidance and external checks
+ */
+export const SeveritySchema = z.enum(['error', 'warning', 'info']);
+// ============================================================================
+// PR Context Schemas
+// ============================================================================
+/**
+ * Linked Issue Schema
+ *
+ * GitHub issue linked to the PR (via closing keywords or manually)
+ */
+export const LinkedIssueSchema = z.object({
+    /** Issue number */
+    number: z.number().int().positive(),
+    /** Issue title */
+    title: z.string(),
+    /** Issue URL */
+    url: z.string().url(),
+});
+/**
+ * PR Metadata Schema
+ *
+ * Complete PR context including metadata, labels, and linked issues
+ */
+export const PRMetadataSchema = z.object({
+    /** PR number */
+    number: z.number().int().positive(),
+    /** PR title */
+    title: z.string(),
+    /** PR URL */
+    url: z.string().url(),
+    /** Head branch name */
+    branch: z.string(),
+    /** Base branch name (usually 'main' or 'develop') */
+    base_branch: z.string(),
+    /** PR author username */
+    author: z.string(),
+    /** Is this a draft PR? */
+    draft: z.boolean(),
+    /** Is the PR mergeable? */
+    mergeable: z.boolean(),
+    /** Merge state status (CLEAN, UNSTABLE, BLOCKED, etc.) */
+    merge_state_status: MergeStateStatusSchema,
+    /** PR labels */
+    labels: z.array(z.string()),
+    /** Issues linked to this PR (via closing keywords) */
+    linked_issues: z.array(LinkedIssueSchema).optional(),
+});
+// ============================================================================
+// Check Schemas
+// ============================================================================
+/**
+ * GitHub Actions Check Schema
+ *
+ * Check run from GitHub Actions workflow.
+ * Includes run_id for drilling down with `gh run view`.
+ * May include extraction (from matrix or non-matrix mode).
+ */
+export const GitHubActionCheckSchema = z.object({
+    /** Check name */
+    name: z.string(),
+    /** Check status (queued, in_progress, completed) */
+    status: CheckStatusSchema,
+    /** Check conclusion (present when completed) */
+    conclusion: CheckConclusionSchema.optional(),
+    /** GitHub run ID for this check */
+    run_id: z.number().int().positive(),
+    /** Workflow name */
+    workflow: z.string(),
+    /** When the check started (ISO 8601) */
+    started_at: z.string().datetime(),
+    /** Human-readable duration (e.g., "2m15s") */
+    duration: z.string(),
+    /** Local path to cached log file (if cached) */
+    log_file: z.string().optional(),
+    /**
+     * Extraction result (CRITICAL: NEW FEATURE)
+     *
+     * Errors extracted from check logs using one of two modes:
+     * - Matrix mode: Parsed from validate YAML output, passed through faithfully
+     * - Non-matrix mode: Extracted from raw test output using extractors
+     *
+     * Both modes produce ErrorExtractorResult schema (from @vibe-validate/extractors)
+     */
+    extraction: ErrorExtractorResultSchema.optional(),
+});
+/**
+ * External Check Details Schema
+ *
+ * Details extracted from external checks (codecov, SonarCloud, etc.)
+ */
+export const ExternalCheckDetailsSchema = z.object({
+    /** Human-readable summary of the check result */
+    summary: z.string(),
+    /** Additional details (provider-specific) */
+    details: z.record(z.any()).optional(),
+    /** Severity level */
+    severity: SeveritySchema.optional(),
+});
+/**
+ * External Check Schema
+ *
+ * Status check from external provider (codecov, SonarCloud, etc.)
+ * These don't have GitHub run IDs, only detailsUrl.
+ */
+export const ExternalCheckSchema = z.object({
+    /** Check name (e.g., "codecov/patch", "SonarCloud Code Analysis") */
+    name: z.string(),
+    /** Check status */
+    status: CheckStatusSchema,
+    /** Check conclusion (present when completed) */
+    conclusion: CheckConclusionSchema.optional(),
+    /** URL to view check details on external provider */
+    url: z.string().url(),
+    /** Provider name (e.g., "codecov", "sonarcloud") */
+    provider: z.string().optional(),
+    /** Extracted details (if extraction succeeded) */
+    extracted: ExternalCheckDetailsSchema.optional().nullable(),
+    /** Error message if extraction failed */
+    extraction_error: z.string().optional(),
+});
+/**
+ * Check History Summary Schema
+ *
+ * Condensed history for pattern recognition (~75 tokens)
+ * Provides recent pattern and success rate without full history details.
+ */
+export const CheckHistorySummarySchema = z.object({
+    /** Total number of workflow runs for this PR branch */
+    total_runs: z.number().int().nonnegative(),
+    /** Recent pattern description (e.g., "Passed last 2 runs", "Failed last 3 runs") */
+    recent_pattern: z.string(),
+    /** Success rate percentage (e.g., "75%") based on last 10 runs */
+    success_rate: z.string().optional(),
+});
+/**
+ * Checks Summary Schema
+ *
+ * Complete check results with history context.
+ * Ordered by newspaper philosophy: failed checks before passed checks.
+ */
+export const ChecksSummarySchema = z.object({
+    /** Total number of checks */
+    total: z.number().int().nonnegative(),
+    /** Number of passed checks */
+    passed: z.number().int().nonnegative(),
+    /** Number of failed checks */
+    failed: z.number().int().nonnegative(),
+    /** Number of pending checks */
+    pending: z.number().int().nonnegative(),
+    /** Condensed history for pattern recognition (cheap tokens, high value) */
+    history_summary: CheckHistorySummarySchema.optional(),
+    /** GitHub Actions checks (with run_id and optional extraction) */
+    github_actions: z.array(GitHubActionCheckSchema),
+    /** External checks (with detailsUrl and optional extraction) */
+    external_checks: z.array(ExternalCheckSchema),
+});
+// ============================================================================
+// Changes Context Schemas
+// ============================================================================
+/**
+ * File Change Schema
+ *
+ * Git diff statistics for a single file
+ */
+export const FileChangeSchema = z.object({
+    /** File path */
+    file: z.string(),
+    /** Number of lines inserted */
+    insertions: z.number().int().nonnegative(),
+    /** Number of lines deleted */
+    deletions: z.number().int().nonnegative(),
+    /** Is this a new file? */
+    new_file: z.boolean().optional(),
+});
+/**
+ * Changes Context Schema
+ *
+ * File change statistics for the PR
+ * Helps understand scope and potential impact areas.
+ */
+export const ChangesContextSchema = z.object({
+    /** Total number of files changed */
+    files_changed: z.number().int().nonnegative(),
+    /** Total lines inserted across all files */
+    insertions: z.number().int().nonnegative(),
+    /** Total lines deleted across all files */
+    deletions: z.number().int().nonnegative(),
+    /** Number of commits in the PR */
+    commits: z.number().int().positive(),
+    /** Top files by lines changed (limited to 10 for token efficiency) */
+    top_files: z.array(FileChangeSchema).optional(),
+});
+// ============================================================================
+// Guidance Schemas
+// ============================================================================
+/**
+ * Next Step Schema
+ *
+ * Actionable next step with severity and context
+ */
+export const NextStepSchema = z.object({
+    /** Action description */
+    action: z.string(),
+    /** URL to perform the action (if applicable) */
+    url: z.string().url().optional(),
+    /** Severity level (prioritization) */
+    severity: SeveritySchema,
+    /** Reason or context for this action */
+    reason: z.string().optional(),
+});
+/**
+ * Guidance Schema
+ *
+ * Intelligent guidance based on check results.
+ * Provides context-aware next steps with severity-based prioritization.
+ */
+export const GuidanceSchema = z.object({
+    /** Overall status (passed, failed, pending) */
+    status: z.enum(['passed', 'failed', 'pending']),
+    /** Does this failure block merging? */
+    blocking: z.boolean(),
+    /** Overall severity */
+    severity: SeveritySchema,
+    /** Human-readable summary */
+    summary: z.string(),
+    /** Prioritized list of next steps */
+    next_steps: z.array(NextStepSchema).optional(),
+});
+// ============================================================================
+// Cache Schemas
+// ============================================================================
+/**
+ * Cache Info Schema
+ *
+ * Metadata about the local cache
+ */
+export const CacheInfoSchema = z.object({
+    /** Cache directory location */
+    location: z.string(),
+    /** When the cache was created (ISO 8601) */
+    cached_at: z.string().datetime(),
+    /** When the cache expires (ISO 8601) */
+    expires_at: z.string().datetime(),
+});
+// ============================================================================
+// Complete Result Schema
+// ============================================================================
+/**
+ * Watch PR Result Schema
+ *
+ * Complete result structure from watch-pr command.
+ *
+ * Field ordering follows "Newspaper Philosophy":
+ * 1. PR context & status (always needed)
+ * 2. Check summary + history (quick overview)
+ * 3. Failed checks FIRST (most actionable)
+ * 4. Passed checks (confirmation)
+ * 5. Guidance (what to do next)
+ * 6. Changes (context)
+ * 7. Cache (metadata, least important)
+ *
+ * If output is truncated, LLM still sees critical details.
+ */
+export const WatchPRResultSchema = z.object({
+    /** PR metadata (number, title, branch, mergeable, labels, linked issues) */
+    pr: PRMetadataSchema,
+    /** Overall status (passed, failed, pending) */
+    status: z.enum(['passed', 'failed', 'pending']),
+    /** Check results with history context */
+    checks: ChecksSummarySchema,
+    /** File change context (optional, helps understand scope) */
+    changes: ChangesContextSchema.optional(),
+    /** Intelligent guidance with next steps (optional) */
+    guidance: GuidanceSchema.optional(),
+    /** Cache metadata (optional) */
+    cache: CacheInfoSchema.optional(),
+});
+//# sourceMappingURL=watch-pr-result.schema.js.map

package/dist/schemas/watch-pr-result.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-pr-result.schema.js","sourceRoot":"","sources":["../../src/schemas/watch-pr-result.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1C,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;IACT,WAAW;IACX,iBAAiB;CAClB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,OAAO;IACP,WAAW;IACX,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEnE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,mBAAmB;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEnC,kBAAkB;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,gBAAgB;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,gBAAgB;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEnC,eAAe;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,aAAa;IACb,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,uBAAuB;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,qDAAqD;IACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IAEvB,yBAAyB;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,0BAA0B;IAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAElB,2BAA2B;IAC3B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IAEtB,0DAA0D;IAC1D,kBAAkB,EAAE,sBAAsB;IAE1C,gBAAgB;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAE3B,sDAAsD;IACtD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAEH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,iBAAiB;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAEhB,oDAAoD;IACpD,MAAM,EAAE,iBAAiB;IAEzB,gDAAgD;IAChD,UAAU,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAE5C,mCAAmC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEnC,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,wCAAwC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B;;;;;;;;OAQG;IACH,UAAU,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iDAAiD;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IAEnB,6CAA6C;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IAErC,qBAAqB;IACrB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,qEAAqE;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAEhB,mBAAmB;IACnB,MAAM,EAAE,iBAAiB;IAEzB,gDAAgD;IAChD,UAAU,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAE5C,qDAAqD;IACrD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,oDAAoD;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,kDAAkD;IAClD,SAAS,EAAE,0BAA0B,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3D,yCAAyC;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,uDAAuD;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE1C,oFAAoF;IACpF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAE1B,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAErC,8BAA8B;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEtC,8BAA8B;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEtC,+BAA+B;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEvC,2EAA2E;IAC3E,eAAe,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAErD,kEAAkE;IAClE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAEhD,gEAAgE;IAChE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CAC9C,CAAC,CAAC;AAEH,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,gBAAgB;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAEhB,+BAA+B;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE1C,8BAA8B;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEzC,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,oCAAoC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE7C,4CAA4C;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE1C,2CAA2C;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEzC,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEpC,sEAAsE;IACtE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,yBAAyB;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,gDAAgD;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAEhC,sCAAsC;IACtC,QAAQ,EAAE,cAAc;IAExB,wCAAwC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,+CAA+C;IAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE/C,uCAAuC;IACvC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IAErB,uBAAuB;IACvB,QAAQ,EAAE,cAAc;IAExB,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IAEnB,qCAAqC;IACrC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,4CAA4C;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,wCAAwC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,4EAA4E;IAC5E,EAAE,EAAE,gBAAgB;IAEpB,+CAA+C;IAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE/C,yCAAyC;IACzC,MAAM,EAAE,mBAAmB;IAE3B,6DAA6D;IAC7D,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAExC,sDAAsD;IACtD,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IAEnC,gCAAgC;IAChC,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}

package/dist/schemas/watch-pr-schema.d.ts

@@ -11,13 +11,13 @@ export declare const WatchPRResultSchema: z.ZodObject<{
         title: z.ZodString;
         url: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        id: string | number;
         title: string;
         url: string;
-    }, {
         id: string | number;
+    }, {
         title: string;
         url: string;
+        id: string | number;
     }>;
     status: z.ZodEnum<["pending", "in_progress", "completed", "timeout"]>;
     result: z.ZodEnum<["success", "failure", "cancelled", "unknown"]>;
@@ -531,12 +531,12 @@ export declare const WatchPRResultSchema: z.ZodObject<{
     summary: string;
     status: "in_progress" | "completed" | "pending" | "timeout";
     result: "unknown" | "success" | "failure" | "cancelled";
+    duration: string;
     pr: {
-        id: string | number;
         title: string;
         url: string;
+        id: string | number;
     };
-    duration: string;
     failures?: {
         name: string;
         checkId: string;
@@ -598,12 +598,12 @@ export declare const WatchPRResultSchema: z.ZodObject<{
     summary: string;
     status: "in_progress" | "completed" | "pending" | "timeout";
     result: "unknown" | "success" | "failure" | "cancelled";
+    duration: string;
     pr: {
-        id: string | number;
         title: string;
         url: string;
+        id: string | number;
     };
-    duration: string;
     failures?: {
         name: string;
         checkId: string;

package/dist/services/cache-manager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * CacheManager - Local cache management for watch-pr command
+ *
+ * Provides:
+ * - Atomic writes (concurrent-safe)
+ * - TTL-based cache freshness
+ * - Separate logs (immutable) and extractions (mutable) directories
+ * - Cross-platform path handling
+ *
+ * Cache structure:
+ * ${os.tmpdir()}/vibe-validate/watch-pr-cache/<repo-name>/<pr-number>/
+ *   ├── logs/             # Immutable log files
+ *   │   ├── 123.log
+ *   │   └── 456.log
+ *   ├── extractions/      # Mutable extraction results
+ *   │   ├── 123.json
+ *   │   └── 456.json
+ *   └── metadata.json     # Complete WatchPRResult
+ *
+ * @packageDocumentation
+ */
+import type { ErrorExtractorResult } from '@vibe-validate/extractors';
+import type { WatchPRResult } from '../schemas/watch-pr-result.schema.js';
+/**
+ * CacheManager - Manages local cache for watch-pr command
+ *
+ * Provides concurrent-safe caching with TTL support.
+ */
+export declare class CacheManager {
+    /** Base cache directory */
+    private readonly cacheDir;
+    /** Logs directory (immutable) */
+    private readonly logsDir;
+    /** Extractions directory (mutable) */
+    private readonly extractionsDir;
+    /**
+     * Create a new CacheManager
+     *
+     * @param repoName - Repository name (e.g., "jdutton/vibe-validate")
+     * @param prNumber - PR number
+     * @param baseDir - Base directory for cache (defaults to OS temp)
+     */
+    constructor(repoName: string, prNumber: number, baseDir?: string);
+    /**
+     * Initialize cache directories
+     *
+     * Creates directory structure if it doesn't exist.
+     */
+    private initDirectories;
+    /**
+     * Atomic write - Write file atomically using temp file + rename
+     *
+     * Provides concurrent safety by writing to temp file first, then renaming.
+     *
+     * @param filePath - Target file path
+     * @param content - Content to write
+     */
+    private atomicWrite;
+    /**
+     * Check if a file is fresh (within TTL)
+     *
+     * @param filePath - File path to check
+     * @param ttl - TTL in milliseconds
+     * @returns true if file exists and is fresh, false otherwise
+     */
+    private isFresh;
+    /**
+     * Save log file (immutable)
+     *
+     * @param runId - GitHub run ID
+     * @param logs - Log content
+     * @returns Path to saved log file
+     */
+    saveLog(runId: number, logs: string): Promise<string>;
+    /**
+     * Save extraction result (mutable)
+     *
+     * @param runId - GitHub run ID
+     * @param extraction - Extraction result
+     */
+    saveExtraction(runId: number, extraction: ErrorExtractorResult): Promise<void>;
+    /**
+     * Get extraction result
+     *
+     * @param runId - GitHub run ID
+     * @returns Extraction result or null if not found
+     */
+    getExtraction(runId: number): Promise<ErrorExtractorResult | null>;
+    /**
+     * Save metadata (complete WatchPRResult)
+     *
+     * @param data - WatchPRResult data
+     */
+    saveMetadata(data: WatchPRResult): Promise<void>;
+    /**
+     * Get metadata (complete WatchPRResult)
+     *
+     * @returns Metadata or null if not found
+     */
+    getMetadata(): Promise<WatchPRResult | null>;
+    /**
+     * Get or fetch data with caching
+     *
+     * Generic cache wrapper with TTL support.
+     *
+     * @param key - Cache key
+     * @param fetcher - Function to fetch data if cache is stale/missing
+     * @param ttl - TTL in milliseconds (default: 5 minutes)
+     * @returns Cached or fetched data
+     */
+    getOrFetch<T>(key: string, fetcher: () => Promise<T>, ttl?: number): Promise<T>;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/services/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/services/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAO1E;;;;GAIG;AACH,qBAAa,YAAY;IACvB,2BAA2B;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;;;OAMG;gBACS,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAiBhE;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;;OAOG;YACW,WAAW;IAezB;;;;;;OAMG;YACW,OAAO;IAUrB;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3D;;;;;OAKG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpF;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAUxE;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUlD;;;;;;;;;OASG;IACG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,MAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;CAyBtG"}