build: add canonical product catalog and docs drift checks

Derive package, tool-family, provider, setup-client, schema-version, and CLI facts from the runtime contract sources into a deterministic checked-in catalog.

Add non-mutating generated-file checks, exact TypeDoc regenerate-and-compare validation, caller-visible documentation fact checks, and CI enforcement through docs:check.

Cover command-router parity, source-derived catalog values, deliberate documentation drift, and stale generated artifacts while preserving runtime behavior.
This commit is contained in:
N0zoM1z0 committed 2026-07-15 17:43:52 +08:00
1 parent addc208f12
commit beb9ece7d1
109 files changed
+1878 -281

No files matched your search

@@ -15,7 +15,7 @@
<div class="tsd-comment tsd-typography"><p>Target lifecycle used by CLI and MCP without exposing a concrete provider.</p>
</div></section>
<div class="tsd-signature"><span class="tsd-signature-keyword">interface</span> <span class="tsd-kind-interface">BinarySessionPort</span> <span class="tsd-signature-symbol">{</span><br/>    <a class="tsd-kind-call-signature" href="#activetarget-1">activeTarget</a><span class="tsd-signature-symbol">()</span><span class="tsd-signature-symbol">:</span> <a href="domain_binaryTarget.BinaryTarget.html" class="tsd-signature-type tsd-kind-interface">BinaryTarget</a> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">undefined</span><span class="tsd-signature-symbol">;</span><br/>    <a class="tsd-kind-call-signature" href="#close-1">close</a><span class="tsd-signature-symbol">()</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="../types/domain_result.Result.html" class="tsd-signature-type tsd-kind-type-alias">Result</a><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">,</span> <a href="../classes/domain_errors.AnalysisError.html" class="tsd-signature-type tsd-kind-class">AnalysisError</a><span class="tsd-signature-symbol">&gt;</span><span class="tsd-signature-symbol">&gt;</span><span class="tsd-signature-symbol">;</span><br/>    <a class="tsd-kind-call-signature" href="#evidencebyid-1">evidenceById</a><span class="tsd-signature-symbol">(</span><br/>        <span class="tsd-kind-parameter">evidenceId</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span><br/>        <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-symbol">{</span><br/>            <span class="tsd-kind-property">authority</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;shipped-artifact&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;controlled-replay&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;historical-reference&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;external-service&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;analyst-inference&quot;</span><span class="tsd-signature-symbol">;</span><br/>            <span class="tsd-kind-property">confidence</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;observed&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;derived&quot;</span><br/>            <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;inferred&quot;</span><span class="tsd-signature-symbol">;</span><br/>            <span class="tsd-kind-property">environment</span><span class="tsd-signature-symbol">:</span><br/>                <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-symbol">{</span><br/>                    <span class="tsd-kind-property">architecture</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">;</span><br/>                    <span class="tsd-kind-property">id</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">;</span><br/>                    <span class="tsd-kind-property">isolation</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">&quot;process&quot;</span><br/>                    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;none&quot;</span><br/>                    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;container&quot;</span><br/>                    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">&quot;virtual-machine&quot;</span><span class="tsd-signature-symbol">;</span><br/>                    <span class="tsd-kind-property">platform</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">;</span><br/>                <span class="tsd-signature-symbol">}</span><br/>                <span class="tsd-signature-symbol">|</span> <span classLine truncated
<section class="tsd-panel tsd-hierarchy" data-refl="28169">
<section class="tsd-panel tsd-hierarchy" data-refl="28717">
<h4>Hierarchy (<a href="../hierarchy.html#application/BinarySessionPort.BinarySessionPort">View Summary</a>)</h4>
<ul class="tsd-hierarchy">
<li class="tsd-hierarchy-item"><a href="application_AnalysisProvider.AnalysisOperationPort.html" class="tsd-signature-type tsd-kind-interface">AnalysisOperationPort</a>