docs: final cleanup and accuracy pass before public push

- Fix const inference bug: wrap inferred contracts with status-code guards
- Add integration test for status-guarded contract inference
- Tighten and deduplicate docs across verify, qualify, getting-started, cli
- Fix broken cross-references and TypeScript→JavaScript conversions
- Fix factual errors: license, Date.now(), sampling defaults, cache env
- Add missing features: --workspace, --generation-profile, json-summary formats
- Move stale extension docs (AUTH-RATE-LIMIT-REVISED, HTTP-EXTENSIONS) to attic
- Update PLUGIN_CONTRACTS_SPEC status to Implemented
- Build: clean | Tests: 849 pass, 0 fail

docs/chaos.md

@@ -4,7 +4,7 @@ Inject controlled failures into contract tests to validate resilience guarantees
 
 ## Usage
 
-```typescript
+```javascript
 const result = await fastify.apophis.contract({
   depth: 'standard',
   chaos: {
@@ -14,7 +14,7 @@ const result = await fastify.apophis.contract({
     dropout: { probability: 1 },
     corruption: { probability: 1 },
   },
-})
+});
 ```
 
 ## Event Types
@@ -52,35 +52,35 @@ Mutates response bodies. Tests parsing robustness:
 response_body(this).id != null
 ```
 
-## Content-Type Aware Corruption
+## Corruption Strategies
 
-Built-in strategies for common formats:
+Built-in strategies are content-type agnostic:
 
-| Content-Type | Strategy | Effect |
-|-------------|----------|--------|
-| `application/json` | Truncate or null field | Removes fields or sets random field to null |
-| `application/x-ndjson` | Chunk corrupt | Corrupts one NDJSON chunk |
-| `text/event-stream` | Event corrupt | Adds malformed SSE line |
-| `multipart/form-data` | Field corrupt | Replaces field with corrupted data |
-| `text/plain` | Truncate | Cuts string in half |
+| Strategy | Effect |
+|----------|--------|
+| `truncate` | Cuts response body short |
+| `malformed` | Invalidates structural boundaries (e.g., unclosed JSON, bad headers) |
+| `field-corrupt` | Replaces a random field value with corrupted data |
+
+Extension strategies can add content-type-specific behavior if needed.
 
 ## Custom Corruption via Extensions
 
-```typescript
+```javascript
 const myExtension = {
   name: 'custom-corrupt',
   corruptionStrategies: {
     'application/vnd.api+json': (data) => ({
-      ...data as object,
+      ...data,
       corrupted: true,
     }),
     'text/*': (data) => `CORRUPTED:${String(data)}`,
   },
-}
+};
 
 await fastify.register(apophis, {
   extensions: [myExtension],
-})
+});
 ```
 
 Extension strategies take precedence over built-ins. Wildcard patterns (`text/*`) match any subtype.
@@ -90,7 +90,7 @@ Extension strategies take precedence over built-ins. Wildcard patterns (`text/*`
 Low-level contract chaos APIs require `NODE_ENV=test`. For CLI qualification, environment policy controls whether chaos gates may run.
 
 ```
-Error: Chaos mode is only available in test environment.
+Error: chaos is only available in test environment. Set NODE_ENV=test to enable quality features.
 ```
 
 ## Interpreting Results
@@ -123,7 +123,7 @@ Failed tests include chaos events in diagnostics:
 
 ## Example: Testing Retry Logic
 
-```typescript
+```javascript
 fastify.get('/data', {
   schema: {
     'x-ensures': [
@@ -131,7 +131,7 @@ fastify.get('/data', {
       'redirect_count(this) <= 3',
     ],
   },
-}, handler)
+}, handler);
 
 // Test
 const result = await fastify.apophis.contract({
@@ -139,5 +139,5 @@ const result = await fastify.apophis.contract({
     probability: 0.2,
     error: { probability: 1, statusCode: 503 },
   },
-})
+});
 ```