release 0.0.2 with quality gates

Author: KSemenenko

.editorconfig

@@ -31,6 +31,11 @@ dotnet_style_collection_initializer = true:warning
 dotnet_style_require_accessibility_modifiers = for_non_interface_members:warning
 dotnet_style_readonly_field = true:warning
 
+# Keep semantic numeric limits and repeated protocol text named in product code.
+[src/**/*.cs]
+dotnet_diagnostic.S109.severity = warning
+dotnet_diagnostic.S1192.severity = warning
+
 [tests/**/*.cs]
 dotnet_diagnostic.CA1707.severity = none
 dotnet_diagnostic.CA1716.severity = none

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -20,7 +20,7 @@ body:
     id: version
     attributes:
       label: Package version
-      placeholder: 0.0.1
+      placeholder: 0.0.2
     validations:
       required: true
   - type: input

.github/workflows/ci.yml

@@ -38,7 +38,7 @@ jobs:
         run: dotnet build ManagedCode.FileContext.slnx --configuration Release --no-restore
 
       - name: Test with coverage
-        run: dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build /p:CollectCoverage=true /p:CoverletOutput=${{ github.workspace }}/TestResults/coverage /p:CoverletOutputFormat=opencover
+        run: dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build /p:CollectCoverage=true /p:CoverletOutput=${{ github.workspace }}/TestResults/coverage
 
       - name: Pack
         run: dotnet pack src/ManagedCode.FileContext/ManagedCode.FileContext.csproj --configuration Release --no-build --output artifacts

.github/workflows/release.yml

@@ -58,8 +58,8 @@ jobs:
       - name: Build
         run: dotnet build ManagedCode.FileContext.slnx --configuration Release --no-restore
 
-      - name: Test
-        run: dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build
+      - name: Test with coverage
+        run: dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build /p:CollectCoverage=true
 
       - name: Pack
         run: dotnet pack src/ManagedCode.FileContext/ManagedCode.FileContext.csproj --configuration Release --no-build --output artifacts -p:IncludeSymbols=false

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to ManagedCode.FileContext are documented here.
 
+## 0.0.2 - 2026-09-03
+
+- Enforce a 95% product line-coverage gate in local and CI coverage runs.
+- Add centrally managed Roslynator, Meziantou, and Sonar static analysis with magic-number and repeated-string diagnostics.
+- Replace semantic default literals with the public `FileContextDefaults` contract and centralize tool descriptions.
+- Stream and bound individual range lines so giant unterminated lines cannot cause proportional memory allocation.
+- Exercise every Agent Framework file-context tool through real filesystem and LlmTck integration tests, including a sparse 1 GiB allocation boundary.
+
 ## 0.0.1 - 2026-09-03
 
 - Adapt ManagedCode.Storage `IStorage` to Microsoft Agent Framework `AgentFileStore`.

CONTRIBUTING.md

@@ -12,9 +12,9 @@ Issues and focused pull requests are welcome.
    dotnet restore ManagedCode.FileContext.slnx
    dotnet format ManagedCode.FileContext.slnx --verify-no-changes --no-restore
    dotnet build ManagedCode.FileContext.slnx --configuration Release --no-restore
-   dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build
+   dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release --no-build /p:CollectCoverage=true
    ```
 
 4. Explain public API, dependency, configuration, and security changes in the pull request.
 
-Keep product code provider-neutral: concrete storage providers and LlmTck belong in tests or host applications. Do not commit credentials, generated test artifacts, or packages. NuGet publication is performed only by the repository release workflow.
+The test command enforces at least 95% total line coverage for product code. Keep product code provider-neutral: concrete storage providers and LlmTck belong in tests or host applications. Do not commit credentials, generated test artifacts, or packages. NuGet publication is performed only by the repository release workflow.

Directory.Build.props

@@ -12,7 +12,7 @@
     <AnalysisMode>Recommended</AnalysisMode>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <NoWarn>$(NoWarn);CS1591;MAAI001</NoWarn>
-    <Version>0.0.1</Version>
+    <Version>0.0.2</Version>
     <PackageVersion>$(Version)</PackageVersion>
   </PropertyGroup>
 

Directory.Packages.props

@@ -3,6 +3,11 @@
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
     <CentralPackageTransitivePinningEnabled>false</CentralPackageTransitivePinningEnabled>
   </PropertyGroup>
+  <ItemGroup>
+    <GlobalPackageReference Include="Meziantou.Analyzer" Version="3.0.200" PrivateAssets="all" />
+    <GlobalPackageReference Include="Roslynator.Analyzers" Version="5.0.0" PrivateAssets="all" />
+    <GlobalPackageReference Include="SonarAnalyzer.CSharp" Version="10.33.0.1635" PrivateAssets="all" />
+  </ItemGroup>
   <ItemGroup>
     <PackageVersion Include="coverlet.collector" Version="10.0.1" />
     <PackageVersion Include="coverlet.msbuild" Version="10.0.1" />
@@ -24,7 +29,7 @@
     <PackageVersion Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="10.0.11" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.9.0" />
     <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="10.0.400" />
-    <PackageVersion Include="OpenAI" Version="2.13.0" />
+    <PackageVersion Include="OpenAI" Version="2.12.0" />
     <PackageVersion Include="Shouldly" Version="4.3.0" />
     <PackageVersion Include="xunit" Version="2.9.3" />
     <PackageVersion Include="xunit.runner.visualstudio" Version="4.0.0" />

README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![.NET 10](https://img.shields.io/badge/.NET-10.0-512BD4)](https://dotnet.microsoft.com/)
 
-Storage-backed file tools and Markdown knowledge-graph context for Microsoft Agent Framework.
+Bounded, provider-neutral file tools and Markdown knowledge-graph context for Microsoft Agent Framework.
 
 `ManagedCode.FileContext` turns any [`ManagedCode.Storage.Core.IStorage`](https://github.com/managedcode/Storage) implementation into an Agent Framework file context. An agent can read, list, grep, create, edit, and delete files through the framework's standard `file_access_*` tools; use bounded line-range and metadata tools for large files; and build/search/export a linked-data graph from Markdown through [`ManagedCode.MarkdownLd.Kb`](https://github.com/managedcode/markdown-ld-kb).
 
@@ -40,7 +40,7 @@ flowchart LR
 ## Install
 
 ```bash
-dotnet add package ManagedCode.FileContext --version 0.0.1
+dotnet add package ManagedCode.FileContext --version 0.0.2
 ```
 
 Add one concrete ManagedCode.Storage provider to the host application. For a local filesystem:
@@ -185,15 +185,17 @@ Product code references only `ManagedCode.Storage.Core`; it does not depend on a
 
 ## Tests
 
-The test suite uses real filesystem storage. The tool-loop integration test starts a real ManagedCode.LlmTck HTTP server, returns an OpenAI-compatible `file_access_read` call, lets Agent Framework invoke the storage-backed tool, verifies the tool result was sent back to the model endpoint, and then receives the final response. No live model or API key is required.
+The integration-first test suite uses a unique real filesystem root per test. LlmTck HTTP replays invoke every advertised `file_access_*` and `file_context_*` tool through the actual Agent Framework function loop, then assert the resulting file content or structured tool result. A sparse 1 GiB file scenario verifies bounded range reads, allocation limits, and fail-fast handling for an oversized single line. No live model or API key is required.
 
 ```bash
 dotnet restore ManagedCode.FileContext.slnx
 dotnet format ManagedCode.FileContext.slnx --verify-no-changes
 dotnet build ManagedCode.FileContext.slnx --configuration Release
-dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release
+dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.csproj --configuration Release /p:CollectCoverage=true
 ```
 
+The coverage command enforces at least 95% line coverage for the product assembly and writes an OpenCover report under the test project's `TestResults/coverage` directory.
+
 ## Documentation
 
 - [Architecture](docs/Architecture.md)
@@ -205,7 +207,7 @@ dotnet test tests/ManagedCode.FileContext.Tests/ManagedCode.FileContext.Tests.cs
 
 ## Release policy
 
-The package version is defined in `Directory.Build.props`. Pull requests and `main` run the required `build-and-test` workflow. NuGet publication is allowed only from the tag-driven GitHub Actions release workflow, and a tag such as `v0.0.1` must exactly match the evaluated package version. The repository intentionally provides no local publish script.
+The package version is defined in `Directory.Build.props`. Pull requests and `main` run the required `build-and-test` workflow. NuGet publication is allowed only from the tag-driven GitHub Actions release workflow, and a tag such as `v0.0.2` must exactly match the evaluated package version. The repository intentionally provides no local publish script.
 
 ## License
 

docs/API/index.md

@@ -5,6 +5,7 @@ The primary entry points are:
 - `ManagedCodeStorageFileStore` — use when a raw Microsoft `AgentFileStore` is required.
 - `FileContextProvider` — add one provider to an Agent Framework agent to receive standard file tools plus range, metadata, and graph tools.
 - `IFileContext` — call the extended context operations directly from application code.
+- `FileContextDefaults` — reuse the package's named default limits and selectors when configuring or documenting a host.
 - `AddManagedCodeFileContext(...)` — register the default storage-backed context services with Microsoft dependency injection.
 - `AddKeyedManagedCodeFileContext(...)` — bind the context services to a keyed `IStorage` registration.