WEBSITE: Fixed /docs path redirecting to the correct path rather than home

Co-authored-by: Copilot <copilot@github.com>

Author: PredictabilityAtScale

src/validation/validate.ts

@@ -257,7 +257,7 @@ export function validateAsset(
   }
 
   for (const [envName, overrides] of Object.entries(asset.environments ?? {})) {
-    if (asset.cache && !overrides.cache) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
       warnings.push({
         code: 'POK045',
         message: `Environment "${envName}" does not override cache while prompt-level cache is defined.`,
@@ -268,7 +268,7 @@ export function validateAsset(
   }
 
   for (const [tierName, overrides] of Object.entries(asset.tiers ?? {})) {
-    if (asset.cache && !overrides.cache) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
       warnings.push({
         code: 'POK045',
         message: `Tier "${tierName}" does not override cache while prompt-level cache is defined.`,
@@ -279,7 +279,7 @@ export function validateAsset(
   }
 
   for (const tool of asset.tools ?? []) {
-    if (typeof tool !== 'string') {
+    if (isRecord(tool)) {
       if (!tool.description) {
         warnings.push({
           code: 'POK047',
@@ -353,3 +353,7 @@ function findClosestMatch(input: string, candidates: Set<string>): string | unde
 
   return best;
 }
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

tests/validation.test.ts

@@ -234,6 +234,38 @@ describe('validateAsset', () => {
     expect(result.warnings.filter((warning) => warning.code === 'POK047')).toHaveLength(2);
   });
 
+  it('returns schema errors for malformed override entries instead of throwing', () => {
+    const result = validateAsset({
+      id: 'test',
+      schema_version: 1,
+      cache: {
+        openai: { prompt_cache_key: 'test-v1' },
+      },
+      environments: {
+        prod: null,
+      },
+      tiers: {
+        pro: null,
+      },
+      sections: { prompt_template: 'Hello' },
+    } as never);
+
+    expect(result.valid).toBe(false);
+    expect(result.errors.some((error) => error.code === 'POK001')).toBe(true);
+  });
+
+  it('returns schema errors for malformed inline tools instead of throwing', () => {
+    const result = validateAsset({
+      id: 'test',
+      schema_version: 1,
+      tools: [null],
+      sections: { prompt_template: 'Hello' },
+    } as never);
+
+    expect(result.valid).toBe(false);
+    expect(result.errors.some((error) => error.code === 'POK001')).toBe(true);
+  });
+
   it('does not warn when trim is explicitly false without max_size', () => {
     const result = validateAsset({
       id: 'test',