Add advanced os and shutil chapter

Complete Phase 8 Standard Library with the multilingual os and shutil chapter, deterministic examples, synchronized navigation, and the reviewed environment-restoration fixes.

Author: RamonRDR

README.md

@@ -74,18 +74,9 @@ Detailed explanations:
 
 ## Current status
 
-The project foundation is complete. Phase 0 established the multilingual documentation, contribution workflow, collaboration templates, community standards, authorship, licensing, AI governance, automated quality checks, original visual identity, scalable repository structure, and final foundation audit.
+The project foundation and **Phases 1–8 are complete**. [Phase 8: Standard Library](standard-library/README.md) now contains nine reviewed chapters: [`pathlib`](standard-library/01-pathlib/README.md), [`datetime`](standard-library/02-datetime/README.md), [`json`](standard-library/03-json/README.md), [`csv`](standard-library/04-csv/README.md), [`logging`](standard-library/05-logging/README.md), [`collections`](standard-library/06-collections/README.md), [`itertools`](standard-library/07-itertools/README.md), [`decimal`](standard-library/08-decimal/README.md), and [`os` + `shutil`](standard-library/09-os-shutil/README.md).
 
-The project foundation and seven complete educational sections are available, and [Phase 8: Standard Library](standard-library/README.md) is now in progress with [Chapter 01: `pathlib`](standard-library/01-pathlib/README.md), [Chapter 02: `datetime`](standard-library/02-datetime/README.md), [Chapter 03: `json`](standard-library/03-json/README.md), [Chapter 04: `csv`](standard-library/04-csv/README.md), [Chapter 05: `logging`](standard-library/05-logging/README.md), [Chapter 06: `collections`](standard-library/06-collections/README.md), [Chapter 07: `itertools`](standard-library/07-itertools/README.md), and [Chapter 08: `decimal`](standard-library/08-decimal/README.md). [Phase 7: Errors, Files, and Modules](errors-files-and-modules/README.md) is complete with five reviewed chapters. [Phase 1: Fundamentals](fundamentals/README.md) provides six reviewed beginner chapters. Phase 6 contains six reviewed learning chapters:
-
-- [Comments in Python](comments-and-documentation/01-comments/README.md)
-- [Docstrings in Python](comments-and-documentation/02-docstrings/README.md)
-- [Meaningful Names and Self-Explanatory Code](comments-and-documentation/03-meaningful-names/README.md)
-- [Task Markers and Technical Follow-up](comments-and-documentation/04-task-markers/README.md)
-- [Comments versus Logging in Python](comments-and-documentation/05-comments-vs-logging/README.md)
-- [PEP 8 and Readability in Python](comments-and-documentation/06-pep8-and-readability/README.md)
-
-Phases 1, 2, 3, 4, 5, 6, and 7 are complete. Phase 8 is in progress with [Working with Filesystem Paths Using `pathlib`](standard-library/01-pathlib/README.md), [Working with Dates and Time Calculations Using `datetime`](standard-library/02-datetime/README.md), [Controlling JSON Serialization and Decoding Contracts](standard-library/03-json/README.md), [Controlling CSV Dialects and Tabular Text Contracts](standard-library/04-csv/README.md), [Engineering Logging Pipelines and Runtime Context Contracts](standard-library/05-logging/README.md), and [Specialized Containers and Collection Contracts](standard-library/06-collections/README.md), [Engineering Lazy Iterator Pipelines with `itertools`](standard-library/07-itertools/README.md), and [Engineering Decimal Precision and Rounding Contracts](standard-library/08-decimal/README.md). Together they add path-aware filesystem work, explicit date/time modeling, deeper JSON and CSV data-boundary contracts, runtime logging architecture, specialized collection semantics, lazy iterator composition, and explicit decimal representation, precision, rounding, quantization, signal, and validation contracts. Phase 7 contains five reviewed chapters: exception handling; deliberate raising and custom exceptions; safe file handling with `open()` and `with`; [Working with TXT, CSV, and JSON](errors-files-and-modules/04-txt-csv-and-json/README.md); and [Organizing Code with Imports, Modules, and Packages](errors-files-and-modules/05-imports-modules-and-packages/README.md), which closes the phase with explicit module imports, regular package structure, the main guard, import search context, absolute and relative imports, `python -m`, and dependency design. Phase 5: Functions contains nine reviewed chapters: [Defining and Calling Functions](functions/01-defining-and-calling-functions/README.md), [Parameters and Arguments](functions/02-parameters-and-arguments/README.md), [Return Values](functions/03-return-values/README.md), [Scope](functions/04-scope/README.md), [Type Hints](functions/05-type-hints/README.md), [Default Values](functions/06-default-values/README.md), [`*args` and `**kwargs`](functions/07-args-and-kwargs/README.md), [Functions Working Together](functions/08-functions-working-together/README.md), and [Data Flow Between Functions](functions/09-data-flow-between-functions/README.md). Together they establish function definition and calling, required input flow, returned results, local and global scope, typed interfaces, safe optional inputs, intentionally flexible positional and keyword argument collection, composition through helpers and coordinators, and explicit caller-to-parameter-to-return data flow including rebinding versus mutation. Phase 4 remains complete with eight reviewed Program Flow chapters, ending with [Choosing and Combining Program Flow](program-flow/08-choosing-and-combining-program-flow/README.md). Phase 3 contains six reviewed Collections chapters, ending with [Choosing the Right Collection](collections/06-choosing-the-right-collection/README.md). Phase 2 remains complete with four reviewed chapters, ending with [Numeric Built-ins](strings-and-numbers/04-numeric-builtins/README.md). See the [roadmap](docs/roadmap.en.md) or the [full learning path](docs/learning-path.en.md) for the current curriculum status and direct chapter links.
+Together, Phase 8 moves from path modeling through time, structured data, diagnostics, specialized containers, lazy iteration, decimal arithmetic, and finally operating-system/filesystem contracts for environment state, traversal, metadata, copy, move, removal, platform capabilities, and archive safety. Phase 9: External Libraries is the next planned curriculum phase. See the [roadmap](docs/roadmap.en.md) or the [full learning path](docs/learning-path.en.md) for direct chapter links and current status.
 
 ## Visual identity
 

docs/learning-path.en.md

@@ -99,7 +99,7 @@ This phase is already available and is the next recommended phase after Function
 
 Phase 7 is complete with five reviewed chapters. Chapters 01–02 establish exception handling and deliberate signaling. Chapter 03 adds safe file lifetime and text I/O. Chapter 04 adds TXT, CSV, and JSON data boundaries. Chapter 05 closes the phase with modules, regular packages, `__name__`, the main guard, import search context, absolute and relative imports, `python -m`, and dependency design.
 
-## Phase 8 · Standard Library 🚧
+## Phase 8 · Standard Library ✅
 
 [Open the Standard Library section index](../standard-library/README.md)
 
@@ -111,8 +111,9 @@ Phase 7 is complete with five reviewed chapters. Chapters 01–02 establish exce
 6. [Specialized Containers and Collection Contracts](../standard-library/06-collections/README.md)
 7. [Engineering Lazy Iterator Pipelines with `itertools`](../standard-library/07-itertools/README.md)
 8. [Engineering Decimal Precision and Rounding Contracts](../standard-library/08-decimal/README.md)
+9. [Engineering OS and Filesystem Operations with `os` and `shutil`](../standard-library/09-os-shutil/README.md)
 
-Phase 8 is in progress. Chapter 01 introduces path objects and filesystem boundaries. Chapter 02 adds dates, times, durations, parsing, formatting, naive versus aware datetimes, fixed UTC offsets, timezone conversion, and deterministic time calculations. Chapter 03 deepens JSON serialization and decoding policies. Chapter 04 deepens CSV as a tabular-text boundary. Chapter 05 deepens logging as a runtime event-delivery graph. Chapter 06 adds specialized container contracts with `Counter`, `defaultdict`, `deque`, named tuple records, `ChainMap`, `OrderedDict`, extension wrappers, and `collections.abc`. Chapter 07 adds lazy iterator composition, explicit consumption boundaries, grouping, infinite-stream limiting, alignment, fan-out, and combinatoric iteration. Chapter 08 adds exact decimal representation, context precision, explicit rounding, quantization, signals, traps, and validation boundaries. The next planned chapter is **`os` and `shutil`**.
+Phase 8 is complete with nine reviewed chapters. The sequence moves from path modeling through time, structured data formats, runtime diagnostics, specialized containers, lazy iteration, decimal arithmetic, and finally operating-system and filesystem contracts. Chapter 09 closes the phase with environment state, path-like boundaries, deterministic scanning and traversal, metadata, copy/move/removal behavior, platform capabilities, and archive-safety decisions.
 
 ## Phase 9 · External Libraries ⏳
 

docs/learning-path.es.md

@@ -99,7 +99,7 @@ Esta fase ya está disponible y es la siguiente fase recomendada después de Fun
 
 La Fase 7 está completada con cinco capítulos revisados. Los Capítulos 01–02 establecen manejo y señalización deliberada de excepciones. El Capítulo 03 añade un tiempo de vida seguro de archivos e I/O de texto. El Capítulo 04 añade límites de datos TXT, CSV y JSON. El Capítulo 05 cierra la fase con módulos, paquetes regulares, `__name__`, main guard, contexto de búsqueda de imports, imports absolutos y relativos, `python -m` y diseño de dependencias.
 
-## Fase 8 · Biblioteca Estándar 🚧
+## Fase 8 · Biblioteca Estándar ✅
 
 [Abrir el índice de la sección Biblioteca Estándar](../standard-library/README.es.md)
 
@@ -111,8 +111,9 @@ La Fase 7 está completada con cinco capítulos revisados. Los Capítulos 01–0
 6. [Contenedores Especializados y Contratos de Colecciones](../standard-library/06-collections/README.es.md)
 7. [Diseñando Pipelines Lazy de Iteradores con `itertools`](../standard-library/07-itertools/README.es.md)
 8. [Diseñando Contratos de Precisión y Redondeo Decimal](../standard-library/08-decimal/README.es.md)
+9. [Diseñando Operaciones de Sistema Operativo y Archivos con `os` y `shutil`](../standard-library/09-os-shutil/README.es.md)
 
-La Fase 8 está en progreso. El Capítulo 01 introduce objetos de ruta y límites del filesystem. El Capítulo 02 añade fechas, horas, duraciones, parsing, formato, conciencia de timezone y cálculos deterministas. El Capítulo 03 profundiza políticas de serialización y decodificación JSON. El Capítulo 04 profundiza CSV como frontera de texto tabular. El Capítulo 05 profundiza logging como grafo de entrega de eventos en runtime. El Capítulo 06 añade contratos de contenedores especializados con `Counter`, `defaultdict`, `deque`, registros de tuplas nombradas, `ChainMap`, `OrderedDict`, wrappers de extensión y `collections.abc`. El Capítulo 07 añade composición lazy de iteradores, fronteras explícitas de consumo, agrupación, limitación de streams infinitos, alineación, fan-out e iteración combinatoria. El Capítulo 08 añade representación decimal exacta, precisión de context, redondeo explícito, cuantización, señales, traps y fronteras de validación. El próximo capítulo planificado es **`os` y `shutil`**.
+La Fase 8 está completada con nueve capítulos revisados. La secuencia avanza desde modelado de rutas por tiempo, formatos estructurados de datos, diagnóstico en runtime, contenedores especializados, iteración lazy, aritmética decimal y finalmente contratos del sistema operativo y filesystem. El Capítulo 09 cierra la fase con estado del entorno, fronteras path-like, exploración y recorrido deterministas, metadatos, comportamiento de copia/movimiento/eliminación, capacidades de plataforma y decisiones de seguridad para archives.
 
 ## Fase 9 · Bibliotecas Externas ⏳
 

docs/learning-path.pt-BR.md

@@ -99,7 +99,7 @@ Esta fase já está disponível e é a próxima fase recomendada depois de Funç
 
 A Fase 7 está concluída com cinco capítulos revisados. Os Capítulos 01–02 estabelecem tratamento e sinalização deliberada de exceções. O Capítulo 03 acrescenta tempo de vida seguro de arquivos e I/O de texto. O Capítulo 04 adiciona fronteiras de dados TXT, CSV e JSON. O Capítulo 05 encerra a fase com módulos, pacotes regulares, `__name__`, main guard, contexto de busca de imports, imports absolutos e relativos, `python -m` e design de dependências.
 
-## Fase 8 · Biblioteca Padrão 🚧
+## Fase 8 · Biblioteca Padrão ✅
 
 [Abrir o índice da seção Biblioteca Padrão](../standard-library/README.pt-BR.md)
 
@@ -111,8 +111,9 @@ A Fase 7 está concluída com cinco capítulos revisados. Os Capítulos 01–02
 6. [Contêineres Especializados e Contratos de Coleções](../standard-library/06-collections/README.pt-BR.md)
 7. [Projetando Pipelines Lazy de Iteradores com `itertools`](../standard-library/07-itertools/README.pt-BR.md)
 8. [Projetando Contratos de Precisão e Arredondamento Decimal](../standard-library/08-decimal/README.pt-BR.md)
+9. [Projetando Operações de Sistema Operacional e Arquivos com `os` e `shutil`](../standard-library/09-os-shutil/README.pt-BR.md)
 
-A Fase 8 está em andamento. O Capítulo 01 introduz objetos de caminho e fronteiras do filesystem. O Capítulo 02 acrescenta datas, horários, durações, parsing, formatação, consciência de timezone e cálculos determinísticos. O Capítulo 03 aprofunda políticas de serialização e decodificação JSON. O Capítulo 04 aprofunda CSV como fronteira de texto tabular. O Capítulo 05 aprofunda logging como grafo de entrega de eventos em runtime. O Capítulo 06 acrescenta contratos de contêineres especializados com `Counter`, `defaultdict`, `deque`, registros de tuplas nomeadas, `ChainMap`, `OrderedDict`, wrappers de extensão e `collections.abc`. O Capítulo 07 acrescenta composição lazy de iteradores, fronteiras explícitas de consumo, agrupamento, limitação de streams infinitos, alinhamento, fan-out e iteração combinatória. O Capítulo 08 acrescenta representação decimal exata, precisão de context, arredondamento explícito, quantização, sinais, traps e fronteiras de validação. O próximo capítulo planejado é **`os` e `shutil`**.
+A Fase 8 está concluída com nove capítulos revisados. A sequência avança de modelagem de caminhos por tempo, formatos estruturados de dados, diagnóstico em runtime, contêineres especializados, iteração lazy, aritmética decimal e finalmente contratos do sistema operacional e filesystem. O Capítulo 09 encerra a fase com estado do ambiente, fronteiras path-like, varredura e travessia determinísticas, metadados, comportamento de cópia/movimentação/remoção, capacidades de plataforma e decisões de segurança para archives.
 
 ## Fase 9 · Bibliotecas Externas ⏳