Update coverage data

Author: mvandeberg

.clang-format

@@ -0,0 +1,125 @@
+#
+# Copyright (c) 2026 Steve Gerbino
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/cppalliance/corosio
+#
+
+Language: Cpp
+Standard: c++20
+
+# Indentation
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+IndentCaseLabels: false
+IndentPPDirectives: None
+NamespaceIndentation: None
+
+# Brace wrapping - Allman style (opening brace on new line)
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterCaseLabel: true
+  AfterClass: true
+  AfterControlStatement: Always
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: false
+  AfterStruct: true
+  AfterUnion: true
+  AfterExternBlock: true
+  BeforeCatch: true
+  BeforeElse: true
+  BeforeLambdaBody: false
+  BeforeWhile: true
+  IndentBraces: false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: false
+
+# Alignment
+AlignAfterOpenBracket: AlwaysBreak
+AlignConsecutiveAssignments: Consecutive
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: Left
+AlignOperands: DontAlign
+AlignTrailingComments: true
+ContinuationIndentWidth: 4
+
+# Line breaking
+ColumnLimit: 80
+AllowShortBlocksOnASingleLine: Empty
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLambdasOnASingleLine: All
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterReturnType: TopLevelDefinitions
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: true
+BinPackParameters: false
+BreakBeforeBinaryOperators: None
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: BeforeComma
+BreakInheritanceList: BeforeComma
+BreakStringLiterals: true
+
+# Spaces
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+
+# Pointer and reference alignment
+DerivePointerAlignment: false
+PointerAlignment: Left
+
+# Include sorting
+IncludeBlocks: Preserve
+SortIncludes: false
+
+# Other
+AccessModifierOffset: -4
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+CompactNamespaces: false
+Cpp11BracedListStyle: true
+EmptyLineBeforeAccessModifier: Always
+FixNamespaceComments: true
+IndentAccessModifiers: false
+IndentWrappedFunctionNames: false
+InsertBraces: false
+InsertNewlineAtEOF: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+PackConstructorInitializers: CurrentLine
+ReflowComments: false
+SeparateDefinitionBlocks: Leave
+ShortNamespaceLines: 0
+
+# Penalties
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 0

.clang-tidy

@@ -0,0 +1,34 @@
+#
+# Copyright (c) 2026 Steve Gerbino
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/cppalliance/corosio
+#
+
+# Conservative config: high-signal checks, minimal false positives.
+# Run: clang-tidy -p build src/corosio/src/detail/epoll/scheduler.cpp
+
+Checks: >
+  -*,
+  bugprone-*,
+  -bugprone-branch-clone,
+  -bugprone-easily-swappable-parameters,
+  -bugprone-narrowing-conversions,
+  -bugprone-switch-missing-default-case,
+  clang-analyzer-*,
+  -clang-analyzer-optin.*,
+  concurrency-*,
+  -concurrency-mt-unsafe,
+  misc-redundant-expression,
+  misc-unconventional-assign-operator,
+  misc-unused-parameters,
+  modernize-use-override,
+  performance-*,
+  -performance-enum-size,
+  readability-container-size-empty,
+  readability-redundant-smartptr-get,
+
+HeaderFilterRegex: '(boost/corosio|src/detail)/'
+FormatStyle: file

.codecov.yml

@@ -0,0 +1,41 @@
+# Copyright 2019 - 2021 Alexander Grund
+# Distributed under the Boost Software License, Version 1.0.
+# (See accompanying file LICENSE_1_0.txt or copy at http://boost.org/LICENSE_1_0.txt)
+#
+# Sample codecov configuration file. Edit as required
+
+codecov:
+  max_report_age: off
+  require_ci_to_pass: yes
+  notify:
+    # Increase this if you have multiple coverage collection jobs
+    after_n_builds: 1
+    wait_for_ci: yes
+
+# Fix paths from CI build to match repository structure
+# Coverage paths look like: /home/runner/work/corosio/corosio/boost-root/libs/corosio/include/...
+# Strip everything up to and including boost-root/libs/corosio/
+fixes:
+  - "boost-root/libs/corosio/::"
+
+# Make coverage checks informational (report but never fail CI)
+coverage:
+  status:
+    project:
+      default:
+        informational: true
+    patch:
+      default:
+        informational: true
+
+# Change how pull request comments look
+comment:
+  layout: "reach,diff,flags,files,footer"
+
+# Ignore specific files or folders. Glob patterns are supported.
+# See https://docs.codecov.com/docs/ignoring-paths
+ignore:
+  - extra/*
+  - extra/**/*
+  - test/*
+  - test/**/*

.coderabbit.yaml

@@ -0,0 +1,75 @@
+# https://docs.coderabbit.ai/reference/configuration
+
+language: en
+
+early_access: false
+
+chat:
+  auto_reply: true
+
+reviews:
+  auto_review:
+    enabled: true
+    ignore_title_keywords:
+      - "WIP"
+    drafts: false
+    base_branches:
+      - master
+      - develop
+
+  high_level_summary: true
+
+  # Generate sequence diagrams for complex code flows
+  sequence_diagrams: true
+
+  poem: true
+  review_status: true
+  collapse_walkthrough: true
+  changed_files_summary: true
+  request_changes_workflow: false
+
+  pre_merge_checks:
+    description:
+      mode: warning # Options: off, warning, error
+    docstrings:
+      mode: off # Disabled: cannot exclude detail namespaces from coverage
+
+  path_filters:
+    - "!**/bench/**"
+    - "!**/build/**"
+    - "!**/context/**"
+    - "!**/doc/**"
+    - "!**/meta/**"
+    - "!**/papers/**"
+    - "!**/test/**"
+
+  # Custom review instructions for specific file patterns
+  path_instructions:
+    - path: "**/*.{cpp,hpp}"
+      instructions: |
+        Documentation Best Practices
+        - Docstrings are required for all classes and functions in public
+          headers in non-detail namespaces. Docstrings should include a brief
+          description of purpose, document all parameters, return values, and
+          any preconditions, postconditions, or exceptions. For template
+          parameters, document constraints or concepts required. Warn if a
+          class or function is missing a docstring or if the docstring fails
+          to cover these elements.
+        - Avoid redundant documentation that merely restates the obvious from
+          the name and signature. Docstrings should add value beyond what the
+          declaration already communicates. Do not warn about terse
+          documentation for self-explanatory accessors or trivial type aliases.
+        - Document thread-safety guarantees and exception specifications where
+          applicable, particularly for classes intended for concurrent use or
+          functions that may throw.
+        - Files containing non-trivial implementation logic should include a
+          `/* */` block comment after the includes that provides a high-level
+          overview of how the implementation works. This should highlight
+          anything tricky or non-obvious that a maintainer might need to know
+          in order to reason effectively about the code. Warn if such files
+          lack this overview or if the overview appears stale relative to the
+          code.
+        - Single-line `//` comments within code should be used sparingly and
+          judiciously, explaining the why (not the what or how) when it is
+          non-obvious. Warn about comments that merely restate what the code
+          does or excessive commenting that adds noise rather than clarity.

.cursor/rules/doc-awaitable.mdc

@@ -0,0 +1,21 @@
+---
+description: doc javadoc for async awaitable functions of I/O objects
+alwaysApply: false
+---
+
+**Checklist for an outstanding awaitable function javadoc:**
+- **Brief** — One-sentence summary starting with a verb, e.g. "Read data from the stream asynchronously."
+- **Extended description** — Short paragraph explaining what the function does. State that it is an asynchronous operation that suspends the calling coroutine until completion. If composed, state which underlying operations it is implemented in terms of.
+- **Completion conditions** — Bulleted `@li` list of conditions under which the operation completes and the coroutine resumes (e.g. "The supplied buffers are full", "An error occurs", "The operation was canceled").
+- **Concurrency and overlap** — State which operations may be simultaneously in flight. E.g. for a read: "At most one write operation may be in flight concurrently with this read operation. No other read operations may be in flight until this operation completes." Clarify that simultaneous in-flight operations does *not* imply that the initiating calls themselves may be made concurrently; all calls to the stream must be made from the same implicit or explicit serialization context.
+- **`@param` for each parameter** — Including ownership/lifetime semantics. For buffers: state that the caller retains ownership and must guarantee validity until the operation completes. For string/view parameters: state whether the implementation copies the data or requires it to remain valid for the duration.
+- **`@return`** — Describe the returned aggregate and its elements. The first element is always `error_code`. Name and describe each subsequent element (e.g. "bytes_transferred", "endpoint"). Note that the result is customarily destructured by the caller.
+- **Error conditions** — Document the notable `error_code` values or conditions that may appear in the first element. E.g. `capy::cond::canceled` if the stop token was activated or the i/o object's `cancel()` was called, EOF conditions, protocol-specific errors, etc. State that error codes should be compared to error conditions, not specific values.
+- **`@throws`** — Typically only for precondition violations. State which preconditions trigger exceptions, or state that no exceptions are thrown during normal operation.
+- **Cancellation** — State that the operation supports cancellation via `stop_token` propagated through the IoAwaitable protocol, or via the i/o object's `cancel()` member. State that the resulting error compares equal to `capy::cond::canceled`.
+- **`@par Example`** — Two or three `@code` blocks showing different usage patterns: typical happy path with destructuring, error handling, cancellation, different overloads, etc.
+- **`@note` / `@par Remarks`** — Behavioral gotchas. E.g. "This operation may not read all of the requested bytes." Or equivalence to another overload.
+- **`@tparam`** — For non-variadic template parameters. State the concept requirement (e.g. "The type must satisfy the *AsyncStream* concept"). Don't document `Args...`.
+- **`@see`** — Always last. Cross-references to related functions, concepts, and relevant RFC sections.
+- Keep the ascii-art to a minimum, only add dividers if the class declaration is very long
+- Don't emit @tparam for deduced types or concepts