Complete final condensing - all 61 COPILOT.md files now condensed

Co-authored-by: johnml1135 <13733556+johnml1135@users.noreply.github.com>

Author: Copilot

Src/ParatextImport/COPILOT.md

@@ -28,63 +28,17 @@ C# library (net48) with 22 source files (~19K lines). Complex import pipeline co
 Import flow: User selects Paratext project → ParatextSfmImporter parses USFM → BookMerger detects differences → User reviews/resolves differences → Import updates LCModel Scripture → UndoImportManager tracks changes for rollback.
 
 ## Key Components
-
-### Import Management
-- **ParatextImportManager** (ParatextImportManager.cs) - Central coordinator for Paratext imports
-  - Entry point: `ImportParatext(Form mainWnd, LcmCache cache, IScrImportSet importSettings, ...)` - Static entry point called via reflection
-  - `ImportSf()` - Main import workflow with undo task wrapping
-  - `CompleteImport(ScrReference firstImported)` - Post-import finalization
-  - Manages UndoImportManager, settings, and UI coordination
-- **ParatextImportUi** (ParatextImportUi.cs) - UI presentation and dialogs
-- **ParatextSfmImporter** (ParatextSfmImporter.cs) - USFM/SFM file parsing and import logic
-
-### Difference Detection and Merging
-- **BookMerger** (BookMerger.cs) - Scripture book comparison and merge engine
-  - `DetectDifferences(IScrBook bookCurr, IScrBook bookRev, ...)` - Identify changes between versions
-  - `MakeParaCorrelationInfo(...)` - Calculate paragraph correlation factors
-  - Uses **ParaCorrelationInfo** for tracking paragraph mappings
-- **Cluster** (Cluster.cs) - Groups related differences for user review
-  - `ClusterType` enum: AddedVerses, MissingVerses, OrphanedVerses, etc.
-  - **ClusterListHelper**, **OverlapInfo**, **SectionHeadCorrelationHelper** - Cluster analysis utilities
-- **Difference** (Difference.cs) - Individual Scripture change representation
-  - `DifferenceType` enum: SectionHeadAddedToCurrent, TextDifference, VerseMoved, etc.
-  - **DifferenceList**, **Comparison** - Difference collections and analysis
-- **DiffLocation** (DiffLocation.cs) - Scripture reference and location tracking
-
-### Wrapper Interfaces (Legacy Adaptation)
-- **ISCScriptureText** (ISCScriptureText.cs) - Abstracts Paratext text access
-- **ISCTextSegment** (ISCTextSegment.cs) - Individual text segment interface
-- **ISCTextEnum** (ISCTextEnum.cs) - Enumeration over text segments
-- **IBookVersionAgent** (IBookVersionAgent.cs) - Book version comparison contract
-- **SCScriptureText**, **SCTextSegment**, **SCTextEnum** (SC*.cs) - Implementations wrapping Paratext SDK
-
-### Support Classes
-- **ImportedBooks** (ImportedBooks.cs) - Tracks which books were imported in session
-- **ImportStyleProxy** (ImportStyleProxy.cs) - Style mapping and proxy creation
-- **ScrAnnotationInfo** (ScrAnnotationInfo.cs) - Scripture annotation metadata
-- **ScrObjWrapper** (ScrObjWrapper.cs) - Wraps LCModel Scripture objects for comparison
-- **UndoImportManager** (UndoImportManager.cs) - Import rollback tracking
-- **ReplaceInFilterFixer** (ReplaceInFilterFixer.cs) - Filter updates during import
-- **ParatextLoadException** (ParatextLoadException.cs) - Import-specific exceptions
-- **ParatextImportExtensions** (ParatextImportExtensions.cs) - Extension methods for import
+- **ParatextImportManager**: Central coordinator, ImportParatext() entry point, manages UndoImportManager
+- **BookMerger/Cluster/Difference**: Detects differences, groups for review, represents individual changes
+- **ISCScriptureText interfaces**: Abstracts Paratext SDK access (ISCTextSegment, ISCTextEnum, IBookVersionAgent)
+- **Support classes**: ImportedBooks, ImportStyleProxy, ScrObjWrapper, UndoImportManager
 
 ## Technology Stack
-- **Language**: C#
-- **Target framework**: .NET Framework 4.8.x (net48)
-- **Key libraries**:
-  - LCModel (Scripture data model, LcmCache)
-  - LCModel.Core (IScrBook, IScrSection, ITsString)
-  - Common/Controls (UI dialogs, progress indicators)
-  - Common/FwUtils (IApp, utilities)
-  - Common/RootSites (UI integration)
-  - SIL.Reporting (logging)
-- **External integration**: Paratext SDK (wrapped via ISCScriptureText interfaces)
-- **Resource files**: .resx for localized strings
+C# (net48). Key libraries: LCModel, LCModel.Core, Common/Controls, Paratext SDK (wrapped via ISCScriptureText interfaces).
 
 ## Dependencies
-- **Upstream**: LCModel.Core (Scripture, Text, KernelInterfaces), LCModel (cache, domain services, infrastructure), Common/Controls (UI), Common/FwUtils (utilities, IApp), Common/RootSites (UI integration), SIL.Reporting (logging)
-- **Downstream consumers**: xWorks (import commands), LexText applications (Scripture import), Common/ScriptureUtils (ParatextHelper coordination)
-- **External**: Paratext SDK (not bundled - USFM/project access via wrappers)
+**Upstream**: LCModel, Common/Controls, Paratext SDK
+**Downstream**: xWorks, LexText applications, Common/ScriptureUtils
 
 ## Interop & Contracts
 - **Paratext SDK abstraction**: ISCScriptureText, ISCTextSegment, ISCTextEnum interfaces
@@ -136,38 +90,7 @@ ParatextImportManager.ImportParatext() called via reflection from File→Import
 - **Coverage**: USFM parsing, difference detection, merge logic, style handling, undo tracking
 
 ## Usage Hints
-- **Typical import workflow**:
-  1. Ensure Paratext project exists and is accessible
-  2. In FLEx: File→Import→Paratext Project
-  3. Select project and books to import
-  4. Review detected differences (additions, changes, deletions)
-  5. Resolve conflicts (choose Paratext version, FLEx version, or manual merge)
-  6. Complete import (updates Scripture data in LCModel)
-- **Difference types**: 33+ types categorized for review
-  - Additions: SectionHeadAddedToCurrent, VersesAddedToCurrent
-  - Deletions: SectionHeadMissingInCurrent, VersesMissingInCurrent
-  - Changes: TextDifference, VerseNumberDifference
-  - Moves: VerseMoved, SectionHeadMoved
-- **Cluster grouping**: Related differences grouped for efficient review
-  - AddedVerses cluster: All added verses in a range
-  - MissingVerses cluster: All missing verses in a range
-  - OrphanedVerses cluster: Verses without clear correlation
-- **Undo/rollback**: Import wrapped in single UndoTask
-  - Edit→Undo after import rolls back all changes atomically
-- **Performance tips**:
-  - Import large books (Psalms, Isaiah) in smaller batches if slow
-  - Review differences carefully; auto-merge can have unexpected results
-  - Use "Accept all" cautiously; review conflicts manually
-- **Common pitfalls**:
-  - Paratext project not accessible: Verify Paratext installation and permissions
-  - Style mapping errors: Ensure FW styles exist for USFM markers
-  - Merge conflicts: Manual resolution required for ambiguous changes
-  - Large imports: Can take minutes for books with heavy edits
-- **Debugging tips**:
-  - Enable logging (SIL.Reporting) for detailed difference detection traces
-  - Use ParatextImportNoUi tests for reproducing issues without UI
-  - Mock ISCScriptureText for testing without Paratext SDK
-- **Extension points**: Implement ISCScriptureText for custom scripture sources
+File→Import→Paratext Project, select books, review 33+ difference types (additions/deletions/changes/moves), resolve conflicts, complete import. Import wrapped in single UndoTask for rollback.
 
 ## Related Folders
 - **Common/ScriptureUtils/**: Paratext integration

Src/UnicodeCharEditor/COPILOT.md

@@ -28,60 +28,17 @@ C# WinForms application (net48, WinExe) with 16 source files (~4.1K lines). Sing
 Workflow: User edits PUA characters → saves to CustomChars.xml → installs to ICU data files → FieldWorks apps use updated character properties for normalization/display.
 
 ## Key Components
-
-### Main Application
-- **Program** (Program.cs) - Entry point with command-line parsing
-  - `-i, --install` switch - Install CustomChars.xml data to ICU folder without GUI
-  - `-l, --log` switch - Enable logging to file
-  - `-v, --verbose` switch - Enable verbose logging
-  - `-c, --cleanup <processId>` - Clean up locked ICU files (background process)
-  - Uses CommandLineParser library for argument handling
-
-### Character Editor UI
-- **CharEditorWindow** (CharEditorWindow.cs) - Main form implementing IHelpTopicProvider
-  - `m_dictCustomChars` - Dictionary<int, PUACharacter> for user overrides from CustomChars.xml
-  - `m_dictModifiedChars` - Dictionary<int, PUACharacter> for standard Unicode overrides from UnicodeDataOverrides.txt
-  - **PuaListItem** nested class - ListView items with hex code sorting
-  - **PuaListItemComparer** - Sorts by Unicode codepoint value
-  - `ReadDataFromUnicodeFiles()` - Loads Unicode base data
-  - `ReadCustomCharData()` - Loads CustomChars.xml
-  - `WriteCustomCharData()` - Saves modifications to CustomChars.xml
-- **CustomCharDlg** (CustomCharDlg.cs) - Dialog for editing individual character properties
-
-### ICU Data Installation
-- **PUAInstaller** (PUAInstaller.cs) - Installs CustomChars.xml into ICU data files
-  - `Install(string icuDir, string customCharsFile)` - Main installation method
-  - **UndoFiles** struct - Tracks backup files for rollback
-  - Handles file locking via cleanup child process spawning
-  - Modifies ICU's UnicodeData.txt, nfkc.txt, nfc.txt files
-
-### Supporting Infrastructure
-- **LogFile** (LogFile.cs) - File-based logging with `IsLogging`, `IsVerbose` properties
-- **IcuLockedException** (IcuLockedException.cs) - Exception for ICU file access failures
-- **UceException**, **PuaException** (UceException.cs, PuaException.cs) - Application-specific exceptions
-- **ErrorCodes** enum (ErrorCodes.cs) - Application error code enumeration
-- **IcuErrorCodes** enum (IcuErrorCodes.cs) - ICU-specific error codes
-- **ErrorCodesExtensionMethods** - Extension methods for error code handling
+- **Program**: Entry point with command-line parsing (-i install, -l log, -v verbose, -c cleanup)
+- **CharEditorWindow/CustomCharDlg**: Main form and character editor dialog for PUA character management
+- **PUAInstaller**: Installs CustomChars.xml into ICU data files (UnicodeData.txt, nfkc.txt, nfc.txt)
+- **LogFile, exceptions**: Infrastructure for logging and error handling
 
 ## Technology Stack
-- **Language**: C#
-- **Target framework**: .NET Framework 4.8.x (net48)
-- **Application type**: WinExe (Windows GUI application with command-line support)
-- **UI framework**: System.Windows.Forms (WinForms)
-- **Key libraries**:
-  - LCModel.Core.Text (PUACharacter class, Unicode utilities)
-  - Common/FwUtils (FwRegistryHelper, IHelpTopicProvider, MessageBoxUtils)
-  - SIL.Utils
-  - CommandLineParser (NuGet package for command-line parsing)
-  - System.Windows.Forms (WinForms controls)
-- **External data files**: ICU UnicodeData.txt, nfkc.txt, nfc.txt (Unicode normalization data)
-- **User data**: CustomChars.xml (stored in local settings folder)
-- **Platform**: Windows-only (file system paths, registry access)
+C# WinForms (net48, WinExe). Key libraries: LCModel.Core.Text (PUACharacter), Common/FwUtils, CommandLineParser. External data: ICU UnicodeData.txt, CustomChars.xml.
 
 ## Dependencies
-- **Upstream**: LCModel.Core.Text (PUACharacter, Unicode utilities), Common/FwUtils (FwRegistryHelper, IHelpTopicProvider, MessageBoxUtils), SIL.Utils, CommandLineParser (NuGet), System.Windows.Forms
-- **Downstream consumers**: All FieldWorks applications that use ICU for Unicode normalization and character properties
-- **External data**: ICU data folder (UnicodeData.txt, nfkc.txt, nfc.txt), CustomChars.xml (user data in local settings)
+**Upstream**: LCModel.Core.Text, Common/FwUtils, CommandLineParser
+**Downstream**: All FieldWorks applications (via ICU Unicode normalization)
 
 ## Interop & Contracts
 - **ICU data file modification**: PUAInstaller modifies ICU text files
@@ -140,39 +97,7 @@ GUI mode: `UnicodeCharEditor.exe`. Command-line: `--install` (headless), `--log
 - **Test data**: Sample CustomChars.xml files for various scenarios
 
 ## Usage Hints
-- **Typical workflow**:
-  1. Launch: Tools→Unicode Character Editor in FLEx (or standalone UnicodeCharEditor.exe)
-  2. Add PUA character: Click "Add", enter codepoint (e.g., E000 for U+E000)
-  3. Set properties: General category, combining class, decomposition, name
-  4. Save: File→Save (writes CustomChars.xml)
-  5. Install: File→Install (modifies ICU data files)
-  6. Restart FLEx to use updated character properties
-- **Private Use Area ranges**:
-  - U+E000–U+F8FF: BMP Private Use Area (main range for custom characters)
-  - U+F0000–U+FFFFD, U+100000–U+10FFFD: Supplementary planes (less common)
-- **Common properties**:
-  - **General Category**: Lo (Other Letter) for linguistic symbols
-  - **Combining Class**: 0 (base), 1-254 (combining marks), 255 (special)
-  - **Decomposition**: Optional canonical or compatibility decomposition
-  - **Name**: Descriptive name for the character
-- **Command-line installation**:
-  ```cmd
-  UnicodeCharEditor.exe --install --log
-  ```
-  - Installs without GUI, logs to UnicodeCharEditor.log
-- **Troubleshooting**:
-  - **ICU files locked**: Close all FLEx instances, retry installation
-  - **Changes not applied**: Restart FLEx after installation
-  - **CustomChars.xml not found**: Save at least once to create file
-- **Common pitfalls**:
-  - Forgetting to install after editing (changes only saved to XML, not ICU)
-  - Not restarting FLEx (ICU data loaded at startup)
-  - Using non-PUA codepoints (can break Unicode compliance)
-  - Invalid decomposition (must reference valid Unicode codepoints)
-- **Advanced usage**:
-  - UnicodeDataOverrides.txt: Override standard Unicode properties (expert users only)
-  - Batch editing: Edit CustomChars.xml directly, run --install
-- **Backup**: CustomChars.xml backed up automatically before installation
+Launch via Tools→Unicode Character Editor, add PUA characters (U+E000–U+F8FF), set properties, save to CustomChars.xml, install to ICU data files, restart FLEx. Command-line: `UnicodeCharEditor.exe --install --log`.
 
 ## Related Folders
 - **LCModel.Core/**: PUACharacter class

copilot_structure_report.txt

@@ -652,23 +652,23 @@ Src/LexText/Morphology/COPILOT.md
     ... and 7 more
 
 Src/LexText/ParserCore/COPILOT.md
-  Lines: 186
-  Headings: 27
+  Lines: 125
+  Headings: 21
   Type: Leaf
-  Status: Leaf: 186 lines with 6 verbose sections (may need condensing)
-  Condensed: ✗
+  Status: Leaf: 125 lines (likely condensed)
+  Condensed: ✓
   Sections:
     ## Change Log (auto)
     # ParserCore
     ## Purpose
     ## Architecture
     ## Key Components
-    ### Parser Infrastructure
-    ### Parser Implementations
-    ### Model Change Detection
-    ### Data Structures
-    ### XAmple Support (Legacy)
-    ... and 17 more
+    ## Technology Stack
+    ## Dependencies
+    ## Interop & Contracts
+    ## Threading & Performance
+    ## Config & Feature Flags
+    ... and 11 more
 
 Src/LexText/ParserUI/COPILOT.md
   Lines: 118
@@ -785,23 +785,23 @@ Src/Paratext8Plugin/COPILOT.md
     ... and 11 more
 
 Src/ParatextImport/COPILOT.md
-  Lines: 154
-  Headings: 21
+  Lines: 81
+  Headings: 17
   Type: Leaf
-  Status: Leaf: 154 lines with 6 verbose sections (may need condensing)
-  Condensed: ✗
+  Status: Leaf: 81 lines (likely condensed)
+  Condensed: ✓
   Sections:
     ## Change Log (auto)
     # ParatextImport
     ## Purpose
     ## Architecture
     ## Key Components
-    ### Import Management
-    ### Difference Detection and Merging
-    ### Wrapper Interfaces (Legacy Adaptation)
-    ### Support Classes
     ## Technology Stack
-    ... and 11 more
+    ## Dependencies
+    ## Interop & Contracts
+    ## Threading & Performance
+    ## Config & Feature Flags
+    ... and 7 more
 
 Src/ProjectUnpacker/COPILOT.md
   Lines: 83
@@ -842,23 +842,23 @@ Src/Transforms/COPILOT.md
     ... and 9 more
 
 Src/UnicodeCharEditor/COPILOT.md
-  Lines: 158
-  Headings: 21
+  Lines: 87
+  Headings: 17
   Type: Leaf
-  Status: Leaf: 158 lines with 6 verbose sections (may need condensing)
-  Condensed: ✗
+  Status: Leaf: 87 lines (likely condensed)
+  Condensed: ✓
   Sections:
     ## Change Log (auto)
     # UnicodeCharEditor
     ## Purpose
     ## Architecture
     ## Key Components
-    ### Main Application
-    ### Character Editor UI
-    ### ICU Data Installation
-    ### Supporting Infrastructure
     ## Technology Stack
-    ... and 11 more
+    ## Dependencies
+    ## Interop & Contracts
+    ## Threading & Performance
+    ## Config & Feature Flags
+    ... and 7 more
 
 Src/Utilities/COPILOT.md
   Lines: 34