docs: drop the debt and debugging entries #576, #579 and #583 fixed

.vale/warnings.json

@@ -5,30 +5,30 @@
     "Google.Headings": 138,
     "Google.LyHyphens": 1,
     "Google.OptionalPlurals": 11,
-    "Google.OxfordComma": 55,
+    "Google.OxfordComma": 53,
     "Google.Quotes": 14,
     "Google.Ranges": 2,
     "Google.Units": 1,
     "Google.Will": 12,
     "Google.WordList": 229,
-    "Google.WordListCase": 138,
+    "Google.WordListCase": 136,
     "Microvms.Counts": 3,
-    "Readability.AutomatedReadability": 37,
-    "Readability.ColemanLiau": 52,
-    "Readability.FleschKincaid": 40,
-    "Readability.FleschReadingEase": 65,
-    "Readability.GunningFog": 30,
-    "Readability.LIX": 59,
-    "Readability.SMOG": 43,
+    "Readability.AutomatedReadability": 35,
+    "Readability.ColemanLiau": 50,
+    "Readability.FleschKincaid": 38,
+    "Readability.FleschReadingEase": 63,
+    "Readability.GunningFog": 26,
+    "Readability.LIX": 58,
+    "Readability.SMOG": 42,
     "ai-tells.AbsoluteAssertions": 1,
-    "ai-tells.AnthropomorphicAdjectives": 3,
+    "ai-tells.AnthropomorphicAdjectives": 1,
     "ai-tells.AnthropomorphicCognition": 12,
     "ai-tells.BareHolds": 8,
     "ai-tells.BareNames": 28,
-    "ai-tells.BareReaches": 19,
-    "ai-tells.CataphoricForecasting": 12,
+    "ai-tells.BareReaches": 17,
+    "ai-tells.CataphoricForecasting": 11,
     "ai-tells.ColonUsage": 547,
-    "ai-tells.ConsequenceClause": 30,
+    "ai-tells.ConsequenceClause": 29,
     "ai-tells.ConsequenceParticiple": 4,
     "ai-tells.ContrastiveNegation": 4,
     "ai-tells.CoordinatedReveal": 3,
@@ -48,28 +48,28 @@
     "ai-tells.FigurativeSurfaces": 7,
     "ai-tells.FigurativeWins": 17,
     "ai-tells.FillerIntensifier": 5,
-    "ai-tells.FormalRegister": 113,
+    "ai-tells.FormalRegister": 112,
     "ai-tells.FormalTransitions": 38,
-    "ai-tells.LabelAndExplain": 9,
+    "ai-tells.LabelAndExplain": 8,
     "ai-tells.MortalityMetaphors": 21,
     "ai-tells.MotionMetaphors": 11,
     "ai-tells.NamedAdjective": 2,
-    "ai-tells.NegatedObject": 54,
+    "ai-tells.NegatedObject": 53,
     "ai-tells.NegatedPair": 3,
     "ai-tells.NegatedSubject": 14,
-    "ai-tells.NounString": 20,
-    "ai-tells.ParallelStaccato": 13,
-    "ai-tells.SemicolonUsage": 298,
+    "ai-tells.NounString": 19,
+    "ai-tells.ParallelStaccato": 12,
+    "ai-tells.SemicolonUsage": 293,
     "ai-tells.ServesAsDodge": 5,
-    "ai-tells.ShipOveruse": 15,
-    "ai-tells.StackedAnaphora": 7,
+    "ai-tells.ShipOveruse": 14,
+    "ai-tells.StackedAnaphora": 6,
     "ai-tells.UnderRegime": 4,
     "ai-tells.UniversalSubject": 5,
-    "ai-tells.VerbTricolon": 144,
-    "proselint.Diacritical": 12,
+    "ai-tells.VerbTricolon": 143,
+    "proselint.Diacritical": 8,
     "proselint.Needless": 1,
-    "write-good.Passive": 519,
-    "write-good.TooWordy": 251,
+    "write-good.Passive": 509,
+    "write-good.TooWordy": 245,
     "write-good.Weasel": 16
   }
 }

docs/analysis/dead-code.md

@@ -64,8 +64,10 @@ these uses.
 
 ## See also
 
-- [module map](../architecture/module-map.md): 8 shared source citations
-- [contract map](../insights/contract-map.md): 6 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 5 shared source citations
-- [risk hotspots](risk-hotspots.md): 4 shared source citations
-- [system overview](../architecture/system-overview.md): 4 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [contract map](../insights/contract-map.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [risk hotspots](risk-hotspots.md)
+- [system overview](../architecture/system-overview.md)

docs/analysis/ownership.md

@@ -112,8 +112,10 @@ implementation boundary and evidence. Apply these mitigations during review:
 
 ## See also
 
-- [module map](../architecture/module-map.md): 11 shared source citations
-- [system overview](../architecture/system-overview.md): 9 shared source citations
-- [dependency graph](../diagrams/structural/dependency-graph.md): 7 shared source citations
-- [dead code](dead-code.md): 3 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 3 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [system overview](../architecture/system-overview.md)
+- [dependency graph](../diagrams/structural/dependency-graph.md)
+- [dead code](dead-code.md)
+- [impact analysis](../insights/impact-analysis.md)

docs/analysis/risk-hotspots.md

@@ -73,8 +73,10 @@ No current per-file diagnostic dataset supports warning or error totals, so this
 
 ## See also
 
-- [module map](../architecture/module-map.md): 12 shared source citations
-- [contract map](../insights/contract-map.md): 8 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 6 shared source citations
-- [dead code](dead-code.md): 4 shared source citations
-- [data flow](../architecture/data-flow.md): 3 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [contract map](../insights/contract-map.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [dead code](dead-code.md)
+- [data flow](../architecture/data-flow.md)

docs/architecture/data-flow.md

@@ -127,8 +127,10 @@ sequenceDiagram
 
 ## See also
 
-- [contract map](../insights/contract-map.md): 11 shared source citations
-- [processes](../behavior/processes.md): 10 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 10 shared source citations
-- [module map](module-map.md): 9 shared source citations
-- [components](../diagrams/architecture/components.md): 6 shared source citations
+These pages cite many of the same source files as this one.
+
+- [contract map](../insights/contract-map.md)
+- [processes](../behavior/processes.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [module map](module-map.md)
+- [components](../diagrams/architecture/components.md)

docs/architecture/module-map.md

@@ -146,8 +146,10 @@ The portable model crate expresses daemon and client behavior as state machines
 
 ## See also
 
-- [contract map](../insights/contract-map.md): 41 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 31 shared source citations
-- [processes](../behavior/processes.md): 20 shared source citations
-- [business logic](../insights/business-logic.md): 18 shared source citations
-- [risk hotspots](../analysis/risk-hotspots.md): 12 shared source citations
+These pages cite many of the same source files as this one.
+
+- [contract map](../insights/contract-map.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [processes](../behavior/processes.md)
+- [business logic](../insights/business-logic.md)
+- [risk hotspots](../analysis/risk-hotspots.md)

docs/architecture/system-overview.md

@@ -71,8 +71,10 @@ flowchart LR
 
 ## See also
 
-- [dependency graph](../diagrams/structural/dependency-graph.md): 19 shared source citations
-- [module map](module-map.md): 12 shared source citations
-- [ownership](../analysis/ownership.md): 9 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 8 shared source citations
-- [contract map](../insights/contract-map.md): 7 shared source citations
+These pages cite many of the same source files as this one.
+
+- [dependency graph](../diagrams/structural/dependency-graph.md)
+- [module map](module-map.md)
+- [ownership](../analysis/ownership.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [contract map](../insights/contract-map.md)

docs/behavior/processes.md

@@ -205,8 +205,10 @@ Entry point: `crates/agentd/src/fs.rs:1450`
 
 ## See also
 
-- [contract map](../insights/contract-map.md): 25 shared source citations
-- [module map](../architecture/module-map.md): 20 shared source citations
-- [impact analysis](../insights/impact-analysis.md): 19 shared source citations
-- [business logic](../insights/business-logic.md): 11 shared source citations
-- [debugging guide](../insights/debugging-guide.md): 11 shared source citations
+These pages cite many of the same source files as this one.
+
+- [contract map](../insights/contract-map.md)
+- [module map](../architecture/module-map.md)
+- [impact analysis](../insights/impact-analysis.md)
+- [business logic](../insights/business-logic.md)
+- [debugging guide](../insights/debugging-guide.md)

docs/behavior/state-machines.md

@@ -331,8 +331,10 @@ Defined at: `crates/model/src/wrap.rs:256-263`
 
 ## See also
 
-- [module map](../architecture/module-map.md): 9 shared source citations
-- [data flow](../architecture/data-flow.md): 2 shared source citations
-- [system overview](../architecture/system-overview.md): 2 shared source citations
-- [processes](processes.md): 2 shared source citations
-- [components](../diagrams/architecture/components.md): 2 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [data flow](../architecture/data-flow.md)
+- [system overview](../architecture/system-overview.md)
+- [processes](processes.md)
+- [components](../diagrams/architecture/components.md)

docs/diagrams/architecture/components.md

@@ -105,8 +105,10 @@ classDiagram
 
 ## See also
 
-- [contract map](../../insights/contract-map.md): 9 shared source citations
-- [module map](../../architecture/module-map.md): 8 shared source citations
-- [processes](../../behavior/processes.md): 8 shared source citations
-- [business logic](../../insights/business-logic.md): 7 shared source citations
-- [impact analysis](../../insights/impact-analysis.md): 7 shared source citations
+These pages cite many of the same source files as this one.
+
+- [contract map](../../insights/contract-map.md)
+- [module map](../../architecture/module-map.md)
+- [processes](../../behavior/processes.md)
+- [business logic](../../insights/business-logic.md)
+- [impact analysis](../../insights/impact-analysis.md)

docs/diagrams/behavioral/sequences.md

@@ -149,8 +149,10 @@ sequenceDiagram
 
 ## See also
 
-- [processes](../../behavior/processes.md): 6 shared source citations
-- [contract map](../../insights/contract-map.md): 6 shared source citations
-- [module map](../../architecture/module-map.md): 5 shared source citations
-- [components](../architecture/components.md): 5 shared source citations
-- [data flow](../../architecture/data-flow.md): 4 shared source citations
+These pages cite many of the same source files as this one.
+
+- [processes](../../behavior/processes.md)
+- [contract map](../../insights/contract-map.md)
+- [module map](../../architecture/module-map.md)
+- [components](../architecture/components.md)
+- [data flow](../../architecture/data-flow.md)

docs/diagrams/structural/dependency-graph.md

@@ -167,8 +167,10 @@ fields, and getter receivers. The supported Node versions provide this API level
 
 ## See also
 
-- [system overview](../../architecture/system-overview.md): 19 shared source citations
-- [contract map](../../insights/contract-map.md): 13 shared source citations
-- [module map](../../architecture/module-map.md): 12 shared source citations
-- [impact analysis](../../insights/impact-analysis.md): 9 shared source citations
-- [ownership](../../analysis/ownership.md): 7 shared source citations
+These pages cite many of the same source files as this one.
+
+- [system overview](../../architecture/system-overview.md)
+- [contract map](../../insights/contract-map.md)
+- [module map](../../architecture/module-map.md)
+- [impact analysis](../../insights/impact-analysis.md)
+- [ownership](../../analysis/ownership.md)

docs/insights/business-logic.md

@@ -118,8 +118,10 @@ The report charges snapshot reads on launch, compute for a recorded running phas
 
 ## See also
 
-- [module map](../architecture/module-map.md): 18 shared source citations
-- [contract map](contract-map.md): 17 shared source citations
-- [impact analysis](impact-analysis.md): 14 shared source citations
-- [processes](../behavior/processes.md): 11 shared source citations
-- [components](../diagrams/architecture/components.md): 7 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [contract map](contract-map.md)
+- [impact analysis](impact-analysis.md)
+- [processes](../behavior/processes.md)
+- [components](../diagrams/architecture/components.md)

docs/insights/contract-map.md

@@ -616,8 +616,10 @@ Mitigation: retain separate collected-response and streaming implementations wit
 
 ## See also
 
-- [module map](../architecture/module-map.md): 41 shared source citations
-- [impact analysis](impact-analysis.md): 41 shared source citations
-- [processes](../behavior/processes.md): 25 shared source citations
-- [business logic](business-logic.md): 17 shared source citations
-- [dependency graph](../diagrams/structural/dependency-graph.md): 13 shared source citations
+These pages cite many of the same source files as this one.
+
+- [module map](../architecture/module-map.md)
+- [impact analysis](impact-analysis.md)
+- [processes](../behavior/processes.md)
+- [business logic](business-logic.md)
+- [dependency graph](../diagrams/structural/dependency-graph.md)