Add Phase 10 Fictional Reconciliation Workflow

[RamonRDR]

Summary

Adds Phase 10 Project 07, the Fictional Reconciliation Workflow, as the next practical project after File Organizer.

Project scope

• immutable reconciliation domain models;
• deterministic matching by reference;
• exact monetary comparison with Decimal;
• explicit matched, amount_mismatch, left_only, and right_only outcomes;
• duplicate-reference rejection;
• deterministic ordering and summary metrics;
• text report rendering;
• deterministic public-safe demo;
• focused pytest coverage;
• aligned English, Brazilian Portuguese, and Spanish project documentation;
• Phase 10 practical-project navigation updates;
• approved-example manifest registration.

Safety and educational boundaries

• all data and business rules are fictional and generic;
• no employer, client, proprietary, or personal workflow details are used;
• no network access is required;
• the demo does not mutate external files or services;
• the project intentionally focuses on reconciliation contracts rather than production accounting or financial-system behavior.

Validation before PR

• focused local project suite: 34 tests passed;
• deterministic demo executed successfully;
• branch created from the post-File-Organizer main commit 3aa08f1edb0af658ed70ecb47ed95cac73e7113c.

Review plan

1. Run the repository quality workflow on this PR.
2. If CI is green, request a full Codex review.
3. Address review findings before merge.

Squash merge only after explicit maintainer authorization.

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1b3dbc8a2e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 81bd41bba8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5478f955de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c103aea49f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9587553f86

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e6039874e8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[RamonRDR]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d0eb3c82bf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Validate the report summary against its items

When a caller constructs the public ReconciliationReport directly, this initializer accepts a correctly typed but unrelated ReconciliationSummary. For example, a tuple containing one valid LEFT_ONLY item can be paired with an all-zero summary, after which render_text_report() displays the item and contradicts it with Total items: 0. Verify that summary equals the result of _build_summary(items) so every accepted report preserves its aggregate contract.

Useful? React with 👍 / 👎.