documentation cleanse, sprints work and planning. remaining non EF DAL migration to EF

This commit is contained in:
master
2026-02-25 01:24:07 +02:00
parent b07d27772e
commit 4db038123b
9090 changed files with 4836 additions and 2909 deletions

View File

@@ -0,0 +1,165 @@
{
"module": "binaryindex",
"feature": "semantic-analysis-library",
"runId": "run-001",
"tier": 0,
"capturedAtUtc": "2026-02-12T06:52:50.3376555Z",
"filesChecked": [
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/IrLiftingService.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/IrLiftingService.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticFingerprintGenerator.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticFingerprintGenerator.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticGraphExtractor.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticGraphExtractor.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticMatcher.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticMatcher.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/CallNgramGenerator.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/CallNgramGenerator.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/WeisfeilerLehmanHasher.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/WeisfeilerLehmanHasher.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/GraphCanonicalizer.cs",
"status": "found_exact",
"resolvedPath": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/GraphCanonicalizer.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/FingerprintModels.cs",
"status": "found_fallback",
"resolvedPath": "C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\FingerprintModels.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/GraphModels.cs",
"status": "found_fallback",
"resolvedPath": "C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\GraphModels.cs"
},
{
"expected": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/IrModels.cs",
"status": "found_fallback",
"resolvedPath": "C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\IrModels.cs"
}
],
"found": [
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/IrLiftingService.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticFingerprintGenerator.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticGraphExtractor.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticMatcher.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/CallNgramGenerator.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/WeisfeilerLehmanHasher.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/GraphCanonicalizer.cs",
"C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\FingerprintModels.cs",
"C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\GraphModels.cs",
"C:\\dev\\New folder\\git.stella-ops.org\\src\\BinaryIndex\\__Libraries\\StellaOps.BinaryIndex.Semantic\\Models\\IrModels.cs"
],
"missing": [
],
"symbolsChecked": [
{
"symbol": "IrLiftingService",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\IrLiftingService.cs:16:public sealed class IrLiftingService : IIrLiftingService"
},
{
"symbol": "SemanticFingerprintGenerator",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\SemanticFingerprintGenerator.cs:17:public sealed class SemanticFingerprintGenerator : ISemanticFingerprintGenerator"
},
{
"symbol": "SemanticGraphExtractor",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\SemanticGraphExtractor.cs:15:public sealed class SemanticGraphExtractor : ISemanticGraphExtractor"
},
{
"symbol": "SemanticMatcher",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\SemanticMatcher.cs:14:public sealed class SemanticMatcher : ISemanticMatcher"
},
{
"symbol": "CallNgramGenerator",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\CallNgramGenerator.cs:22:public sealed class CallNgramGenerator : ICallNgramGenerator"
},
{
"symbol": "WeisfeilerLehmanHasher",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Internal\\WeisfeilerLehmanHasher.cs:15:internal sealed class WeisfeilerLehmanHasher"
},
{
"symbol": "GraphCanonicalizer",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Internal\\GraphCanonicalizer.cs:12:internal sealed class GraphCanonicalizer"
},
{
"symbol": "IIrLiftingService",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\IIrLiftingService.cs:11:public interface IIrLiftingService"
},
{
"symbol": "ISemanticFingerprintGenerator",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\ISemanticFingerprintGenerator.cs:9:public interface ISemanticFingerprintGenerator"
},
{
"symbol": "ISemanticGraphExtractor",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\ISemanticGraphExtractor.cs:9:public interface ISemanticGraphExtractor"
},
{
"symbol": "ISemanticMatcher",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\ISemanticMatcher.cs:11:public interface ISemanticMatcher"
},
{
"symbol": "SemanticFingerprint",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\FingerprintModels.cs:22:public sealed record SemanticFingerprint("
},
{
"symbol": "SemanticFingerprintOptions",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\FingerprintModels.cs:86:public sealed record SemanticFingerprintOptions"
},
{
"symbol": "SemanticFingerprintAlgorithm",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\FingerprintModels.cs:62:public enum SemanticFingerprintAlgorithm"
},
{
"symbol": "KeySemanticsGraph",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\GraphModels.cs:16:public sealed record KeySemanticsGraph("
},
{
"symbol": "LiftedFunction",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\IrModels.cs:16:public sealed record LiftedFunction("
},
{
"symbol": "IrStatement",
"status": "found",
"evidence": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic\\Models\\IrModels.cs:48:public sealed record IrStatement("
}
],
"symbolsMissing": [
],
"verdict": "pass"
}

View File

@@ -0,0 +1,70 @@
{
"type": "build",
"module": "binaryindex",
"feature": "semantic-analysis-library",
"runId": "run-001",
"capturedAtUtc": "2026-02-12T06:58:56.8891392Z",
"projects": [
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/StellaOps.BinaryIndex.Semantic.csproj",
"src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/StellaOps.BinaryIndex.Semantic.Tests.csproj"
],
"buildSteps": [
{
"project": "src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/StellaOps.BinaryIndex.Semantic.csproj",
"result": "pass",
"log": "tier1-build.log"
}
],
"testSteps": [
{
"project": "src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/StellaOps.BinaryIndex.Semantic.Tests.csproj",
"result": "pass",
"testsPassed": 80,
"testsFailed": 0,
"testsSkipped": 0,
"testsTotal": 80,
"log": "tier1-test.log"
}
],
"codeReview": {
"reviewedFiles": [
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/IrLiftingService.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticGraphExtractor.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticFingerprintGenerator.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/SemanticMatcher.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/CallNgramGenerator.cs",
"src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Semantic/Internal/WeisfeilerLehmanHasher.cs",
"src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/Integration/EndToEndSemanticDiffTests.cs"
],
"checklist": [
{
"item": "Main service implementation is non-trivial and not placeholder.",
"result": "pass",
"evidence": "Core classes implement deterministic IR/SSA transformation, graph extraction, fingerprint generation, and semantic matching logic; no NotImplementedException/TODOs in key services."
},
{
"item": "Feature logic matches documented behavior claims.",
"result": "pass",
"evidence": "Implementation provides IR lifting, key-semantics graph extraction, WL hashing, semantic similarity scoring, and call n-gram generation via the documented semantic library classes."
},
{
"item": "Unit/integration tests exercise core behavior.",
"result": "pass",
"evidence": "Semantic test suite passes (80/80) including integration tests in EndToEndSemanticDiffTests for full pipeline behavior."
},
{
"item": "Tests assert meaningful outcomes.",
"result": "pass",
"evidence": "Assertions verify deterministic hashes, similarity thresholds, confidence levels, delta generation, and positive/negative semantic matching outcomes."
}
],
"notes": [
"IrLiftingService performs deterministic IR/SSA lifting from disassembled instructions; B2R2-specific pooling types exist under Lifting and are documented separately.",
"Tier 1 command outputs are captured in tier1-build.log and tier1-test.log."
],
"codeReviewResult": "pass"
},
"buildResult": "pass",
"testResult": "pass",
"verdict": "pass"
}

View File

@@ -0,0 +1,40 @@
{
"type": "integration",
"module": "binaryindex",
"feature": "semantic-analysis-library",
"runId": "run-001",
"capturedAtUtc": "2026-02-12T06:58:56.8891392Z",
"commands": [
"dotnet test src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/StellaOps.BinaryIndex.Semantic.Tests.csproj --nologo -c Release --no-build"
],
"testsRun": 80,
"testsPassed": 80,
"testsFailed": 0,
"testsSkipped": 0,
"checks": [
{
"description": "Positive behavior path: identical functions produce perfect semantic match",
"assertion": "EndToEnd_IdenticalFunctions_ShouldProducePerfectMatch enforces OverallSimilarity == 1.0 and VeryHigh confidence.",
"result": "pass",
"evidence": "src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/Integration/EndToEndSemanticDiffTests.cs:40 and :53; run log tier2-positive.log shows semantic suite passed (80/80)."
},
{
"description": "Negative behavior path: different functions produce reduced similarity",
"assertion": "EndToEnd_DifferentFunctions_ShouldProduceLowSimilarity enforces OverallSimilarity \u003c 0.9 for dissimilar functions.",
"result": "pass",
"evidence": "src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/Integration/EndToEndSemanticDiffTests.cs:90 and :102; run log tier2-negative.log shows semantic suite passed (80/80)."
},
{
"description": "Deterministic pipeline behavior",
"assertion": "EndToEnd_DeterministicPipeline_ShouldProduceConsistentResults verifies hash stability across repeated pipeline runs.",
"result": "pass",
"evidence": "src/BinaryIndex/__Tests/StellaOps.BinaryIndex.Semantic.Tests/Integration/EndToEndSemanticDiffTests.cs:166; run log tier2-suite.log shows semantic suite passed (80/80)."
}
],
"behaviorVerified": [
"IR to semantic-graph to fingerprint pipeline executes end-to-end for representative function inputs.",
"Semantic matcher distinguishes identical vs different functions with deterministic thresholded outcomes.",
"Semantic hashing and pipeline outputs remain stable across repeated runs."
],
"verdict": "pass"
}