@theglitchking/hit-em-with-the-docs 2.2.0 → 2.3.0

package/dist/action/core/metadata/schema.d.ts

@@ -1,24 +1,35 @@
 import { z } from 'zod';
+import { LIFECYCLE_TRACKED_TIERS, isLifecycleTrackedTier, type Tier } from '../domains/classifier.js';
+import { type KbErrorCode } from './errors.js';
+declare const DOC_STATUS_VALUES: readonly ["draft", "active", "deprecated", "archived"];
+declare const FACT_CONFIDENCE_VALUES: readonly ["high", "medium", "low", "hypothesis"];
+declare const INCIDENT_SEVERITY_VALUES: readonly ["low", "medium", "high", "critical"];
+declare const INCIDENT_RESOLUTION_VALUES: readonly ["resolved", "partial", "open", "planned"];
+declare const KEBAB_SLUG_RE: RegExp;
+declare const INCIDENT_ID_RE: RegExp;
 /**
- * Complete metadata schema (22 fields total).
+ * Complete metadata schema with all conditional refinements applied.
  *
- * Required fields: title, tier, domains, status, last_updated.
- * Plus `version` — required for ALL tiers EXCEPT `tier: "plan"`.
- *
- * Plans (introduced in 2.2.0 for persistent-planning lg-mode interop) use
- * lifecycle status instead of semver. The .refine() below enforces:
- *   - tier !== 'plan' → version is required
- *   - tier === 'plan' → version is optional (may be absent or supplied)
+ * Required fields by tier:
+ *   - Non-lifecycle-tracked (guide/standard/example/reference/admin):
+ *       title, tier, domains, status (enum), last_updated, version
+ *   - plan: title, tier, domains, status, last_updated (no version)
+ *   - fact: title, tier, domains, status, last_updated, id, confidence,
+ *       last_verified, provenance (no version)
+ *   - incident-narrative: title, tier, domains, status, last_updated,
+ *       id, date, severity, resolution_status, components (no version)
+ *   - incident-facts: title, tier, domains, status, last_updated,
+ *       incident_id, produced (no version)
  */
-export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     title: z.ZodString;
-    tier: z.ZodEnum<["guide" | "standard" | "example" | "reference" | "admin" | "plan", ...("guide" | "standard" | "example" | "reference" | "admin" | "plan")[]]>;
+    tier: z.ZodEnum<["guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts", ...("guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts")[]]>;
     domains: z.ZodArray<z.ZodString, "many">;
     audience: z.ZodDefault<z.ZodArray<z.ZodEnum<["all", "developers", "devops", "admin"]>, "many">>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 } & {
     status: z.ZodString;
-    last_updated: z.ZodString;
+    last_updated: z.ZodEffects<z.ZodString, string, unknown>;
     version: z.ZodOptional<z.ZodString>;
 } & {
     purpose: z.ZodOptional<z.ZodString>;
@@ -35,16 +46,56 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
 } & {
     estimated_read_time: z.ZodOptional<z.ZodString>;
     word_count: z.ZodOptional<z.ZodNumber>;
-    last_validated: z.ZodOptional<z.ZodString>;
+    last_validated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
     backlinks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+} & {
+    id: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodString>;
+    last_verified: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    verify_command: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    invalidated_by: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    working_dir: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    severity: z.ZodOptional<z.ZodString>;
+    resolution_status: z.ZodOptional<z.ZodString>;
+    components: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    incident_id: z.ZodOptional<z.ZodString>;
+    produced: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    strengthened: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    weakened: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    symptoms: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        alert_name: z.ZodOptional<z.ZodString>;
+        user_phrase: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        error_pattern: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        target: z.ZodOptional<z.ZodString>;
+        cites: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }, {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
     audience: ("devops" | "admin" | "all" | "developers")[];
     tags: string[];
     last_updated: string;
+    date?: string | undefined;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -59,14 +110,38 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
-    last_updated: string;
+    date?: unknown;
     audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
     tags?: string[] | undefined;
+    last_updated?: unknown;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -79,16 +154,40 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     production_ready?: boolean | undefined;
     estimated_read_time?: string | undefined;
     word_count?: number | undefined;
-    last_validated?: string | undefined;
+    last_validated?: unknown;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }>, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
     audience: ("devops" | "admin" | "all" | "developers")[];
     tags: string[];
     last_updated: string;
+    date?: string | undefined;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -103,14 +202,176 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
+    audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
+    tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}>, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
+    audience: ("devops" | "admin" | "all" | "developers")[];
+    tags: string[];
     last_updated: string;
+    date?: string | undefined;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: string | undefined;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
     audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
     tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}>, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    audience: ("devops" | "admin" | "all" | "developers")[];
+    tags: string[];
+    last_updated: string;
+    date?: string | undefined;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -125,14 +386,84 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
+    audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
+    tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }>, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
     audience: ("devops" | "admin" | "all" | "developers")[];
     tags: string[];
     last_updated: string;
+    date?: string | undefined;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -147,14 +478,176 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }, {
     domains: string[];
     title: string;
-    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan";
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
+    audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
+    tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}>, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
     status: string;
+    audience: ("devops" | "admin" | "all" | "developers")[];
+    tags: string[];
     last_updated: string;
+    date?: string | undefined;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: string | undefined;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
     audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
     tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}>, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    audience: ("devops" | "admin" | "all" | "developers")[];
+    tags: string[];
+    last_updated: string;
+    date?: string | undefined;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -169,22 +662,90 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
+}, {
+    domains: string[];
+    title: string;
+    tier: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts";
+    status: string;
+    date?: unknown;
+    audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
+    tags?: string[] | undefined;
+    last_updated?: unknown;
+    version?: string | undefined;
+    purpose?: string | undefined;
+    related_docs?: string[] | undefined;
+    load_priority?: number | undefined;
+    author?: string | undefined;
+    maintainer?: string | undefined;
+    review_frequency?: "weekly" | "monthly" | "quarterly" | "annually" | undefined;
+    implementation_status?: "planned" | "in_progress" | "complete" | "deprecated" | undefined;
+    tested?: boolean | undefined;
+    production_ready?: boolean | undefined;
+    estimated_read_time?: string | undefined;
+    word_count?: number | undefined;
+    last_validated?: unknown;
+    backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }>;
 export type DocumentMetadata = z.infer<typeof MetadataSchema>;
 /**
  * Partial schema for documents that may have incomplete metadata.
- * Built from the un-refined base so all fields (including version) are
- * optional, regardless of tier — this is the schema used by `hewtd fix`
- * to identify incomplete docs.
+ * Built from the un-refined base so every field is optional regardless of
+ * tier — used by `hewtd fix` to identify incomplete docs.
  */
 export declare const PartialMetadataSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
-    tier: z.ZodOptional<z.ZodEnum<["guide" | "standard" | "example" | "reference" | "admin" | "plan", ...("guide" | "standard" | "example" | "reference" | "admin" | "plan")[]]>>;
+    tier: z.ZodOptional<z.ZodEnum<["guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts", ...("guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts")[]]>>;
     domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     audience: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodEnum<["all", "developers", "devops", "admin"]>, "many">>>;
     tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
     status: z.ZodOptional<z.ZodString>;
-    last_updated: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
     version: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     purpose: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     related_docs: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
@@ -197,13 +758,52 @@ export declare const PartialMetadataSchema: z.ZodObject<{
     production_ready: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
     estimated_read_time: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     word_count: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-    last_validated: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    last_validated: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
     backlinks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    confidence: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    last_verified: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
+    verify_command: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    provenance: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    sources: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    invalidated_by: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    working_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    date: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
+    severity: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    resolution_status: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    components: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    incident_id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    produced: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    strengthened: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    weakened: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    symptoms: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        alert_name: z.ZodOptional<z.ZodString>;
+        user_phrase: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        error_pattern: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        target: z.ZodOptional<z.ZodString>;
+        cites: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }, {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     domains?: string[] | undefined;
     title?: string | undefined;
-    tier?: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | undefined;
+    tier?: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts" | undefined;
     status?: string | undefined;
+    date?: string | undefined;
     audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
     tags?: string[] | undefined;
     last_updated?: string | undefined;
@@ -221,14 +821,38 @@ export declare const PartialMetadataSchema: z.ZodObject<{
     word_count?: number | undefined;
     last_validated?: string | undefined;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: string | undefined;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }, {
     domains?: string[] | undefined;
     title?: string | undefined;
-    tier?: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | undefined;
+    tier?: "guide" | "standard" | "example" | "reference" | "admin" | "plan" | "fact" | "incident-narrative" | "incident-facts" | undefined;
     status?: string | undefined;
+    date?: unknown;
     audience?: ("devops" | "admin" | "all" | "developers")[] | undefined;
     tags?: string[] | undefined;
-    last_updated?: string | undefined;
+    last_updated?: unknown;
     version?: string | undefined;
     purpose?: string | undefined;
     related_docs?: string[] | undefined;
@@ -241,71 +865,98 @@ export declare const PartialMetadataSchema: z.ZodObject<{
     production_ready?: boolean | undefined;
     estimated_read_time?: string | undefined;
     word_count?: number | undefined;
-    last_validated?: string | undefined;
+    last_validated?: unknown;
     backlinks?: string[] | undefined;
+    id?: string | undefined;
+    confidence?: string | undefined;
+    last_verified?: unknown;
+    verify_command?: string | undefined;
+    provenance?: string[] | undefined;
+    sources?: string[] | undefined;
+    invalidated_by?: string[] | undefined;
+    working_dir?: string | undefined;
+    severity?: string | undefined;
+    resolution_status?: string | undefined;
+    components?: string[] | undefined;
+    incident_id?: string | undefined;
+    produced?: string[] | undefined;
+    strengthened?: string[] | undefined;
+    weakened?: string[] | undefined;
+    symptoms?: {
+        severity?: "low" | "medium" | "high" | "critical" | undefined;
+        alert_name?: string | undefined;
+        user_phrase?: string | string[] | undefined;
+        error_pattern?: string | undefined;
+        target?: string | undefined;
+        cites?: string[] | undefined;
+    }[] | undefined;
 }>;
 export type PartialDocumentMetadata = z.infer<typeof PartialMetadataSchema>;
 /**
- * Required fields that must always be present.
+ * Required fields shared across all tiers.
  *
- * Note: `version` is conditionally required — it must be present for ALL
- * tiers EXCEPT `tier: "plan"`, where it may be absent (plans use lifecycle
- * status instead of semver). The list below preserves the historical
- * 6-required-field contract for non-plan docs; for plan-tier docs, the
- * effective required list is the first 5 entries (without `version`).
+ * Note: `version` is conditionally required — it must be present for all
+ * tiers NOT in LIFECYCLE_TRACKED_TIERS. The list below preserves the
+ * historical 6-required-field contract for non-lifecycle docs; for lifecycle-
+ * tracked docs (plan/fact/incident-narrative/incident-facts), `version` is
+ * dropped and the per-tier extension fields are added by
+ * `getRequiredFieldsForTier()`.
  *
- * Use `getMissingRequiredFields(data)` for tier-aware checks rather than
+ * Prefer `getMissingRequiredFields(data)` for tier-aware checks rather than
  * iterating REQUIRED_FIELDS directly.
  */
 export declare const REQUIRED_FIELDS: readonly ["title", "tier", "domains", "status", "last_updated", "version"];
 /**
- * Optional fields with their default values
+ * Tier-specific required-field extensions for lifecycle-tracked tiers.
+ *
+ * For each tier, these fields are required IN ADDITION to the universal
+ * five (title, tier, domains, status, last_updated). `version` is excluded.
  */
+declare const TIER_REQUIRED_EXTENSIONS: Partial<Record<Tier, readonly string[]>>;
 export declare const OPTIONAL_FIELDS_DEFAULTS: Partial<DocumentMetadata>;
-/**
- * Auto-generated fields that should not be manually edited
- */
 export declare const AUTO_GENERATED_FIELDS: readonly ["estimated_read_time", "word_count", "last_validated", "backlinks"];
 /**
- * All 22 field names
+ * All 22 universal field names (unchanged from 2.2.0). The 2.3.0 knowledge-
+ * base extension fields (id, confidence, etc.) are intentionally NOT in this
+ * list — they apply per-tier and would skew completeness calc on non-KB docs.
  */
 export declare const ALL_METADATA_FIELDS: readonly ["title", "tier", "domains", "audience", "tags", "status", "last_updated", "version", "purpose", "related_docs", "load_priority", "author", "maintainer", "review_frequency", "implementation_status", "tested", "production_ready", "estimated_read_time", "word_count", "last_validated", "backlinks"];
 export type MetadataField = (typeof ALL_METADATA_FIELDS)[number];
-/**
- * Validate metadata against the schema
- */
 export declare function validateMetadata(data: unknown): {
     valid: boolean;
     errors: string[];
     data?: DocumentMetadata;
 };
 /**
- * Validate partial metadata (for documents being fixed)
+ * Coded error produced by `validateKnowledgeBaseFields()`. The auditor maps
+ * these to `AuditIssue` entries with `code` populated, so CI tooling can
+ * switch on specific violation kinds without substring-matching prose.
  */
+export interface KbValidationError {
+    code: KbErrorCode;
+    message: string;
+    path: string;
+}
+export declare function validateKnowledgeBaseFields(data: Record<string, unknown>): KbValidationError[];
 export declare function validatePartialMetadata(data: unknown): {
     valid: boolean;
     errors: string[];
     data?: PartialDocumentMetadata;
 };
 /**
- * Get missing required fields, respecting the tier-conditional `version`
- * exception. For `tier: "plan"`, missing `version` is NOT reported as
- * missing — plans use lifecycle status, not semver.
+ * Get missing required fields, respecting both the version-exemption for
+ * lifecycle-tracked tiers AND the tier-specific extension requirements.
+ *
+ *   - For non-lifecycle tiers: REQUIRED_FIELDS (all six, including version).
+ *   - For lifecycle-tracked tiers: REQUIRED_FIELDS minus 'version', plus
+ *     any tier-specific extensions from TIER_REQUIRED_EXTENSIONS.
  */
 export declare function getMissingRequiredFields(data: Record<string, unknown>): string[];
-/**
- * Get all missing fields (both required and optional)
- */
 export declare function getMissingFields(data: Record<string, unknown>): {
     required: string[];
     optional: string[];
 };
-/**
- * Calculate metadata completeness percentage
- */
 export declare function calculateMetadataCompleteness(data: Record<string, unknown>): number;
-/**
- * Get field category
- */
 export declare function getFieldCategory(field: MetadataField): 'core' | 'status' | 'discovery' | 'ownership' | 'implementation' | 'auto';
+export { LIFECYCLE_TRACKED_TIERS, isLifecycleTrackedTier, DOC_STATUS_VALUES, FACT_CONFIDENCE_VALUES, INCIDENT_SEVERITY_VALUES, INCIDENT_RESOLUTION_VALUES, KEBAB_SLUG_RE, INCIDENT_ID_RE, TIER_REQUIRED_EXTENSIONS, };
 //# sourceMappingURL=schema.d.ts.map