Dump env with original source path

[ultmaster]

This pull request introduces several enhancements and fixes to the POML handling codebase, focusing on improving resource management, traceability, and test coverage. The most significant changes include the addition of automatic file association for .poml resources, enhancements to trace file generation with support for .env files, and updates to test cases to validate these new functionalities.

Resource Management Enhancements:

• Added a new autoAddAssociatedFiles method in POMLWebviewPanel to automatically associate context and stylesheet files with .poml resources if they exist. This ensures consistent handling of related files. (packages/poml-vscode/panel/panel.ts, [1] [2]
• Removed redundant resourceOptions updates in POMLWebviewPanel to prevent unnecessary data storage for unchanged resources. (packages/poml-vscode/panel/panel.ts, [1] [2]

Traceability Improvements:

• Updated the dumpTrace function to include .env file generation, recording the SOURCE_PATH for .poml files, and creating symlinks to source files for better traceability. (packages/poml/util/trace.ts, [1] [2]
• Modified trace file naming conventions to use dots (.) as separators instead of underscores (_) for better readability and consistency. (packages/poml/util/trace.ts, packages/poml/util/trace.tsL83-R112)

Test Coverage Enhancements:

• Added a new test case to verify .env file creation, source path recording, and the ability to include associated files during trace dumps. (packages/poml/tests/trace.test.tsx, packages/poml/tests/trace.test.tsxL30-R61)
• Updated existing test cases to align with the new trace file naming conventions. (packages/poml/tests/trace.test.tsx, packages/poml/tests/trace.test.tsxL30-R61)

File Handling Improvements:

• Enhanced PomlFile to read .env files and update the sourcePath dynamically if specified, improving flexibility in handling .poml resources. (packages/poml/file.tsx, packages/poml/file.tsxR69-R83)

Miscellaneous:

• Added necessary imports for fs in multiple files to support new file operations. (packages/poml-vscode/panel/panel.ts, [1]; packages/poml/file.tsx, [2]

These changes collectively improve the robustness of the system, streamline resource management, and enhance the developer experience through better traceability and testing.

[Copilot]

Pull Request Overview

This PR enhances the POML system by adding automatic file association for .poml resources and improving trace file generation with source path tracking. The changes improve resource management, traceability, and developer experience through better file handling and test coverage.

• Adds automatic association of context and stylesheet files with .poml resources
• Enhances trace dumps to include .env files with source path information and symlinks
• Updates trace file naming to use dots instead of underscores for better readability

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/poml/util/trace.ts	Enhanced trace dumping with source path tracking, .env file generation, and updated naming conventions
packages/poml/tests/trace.test.tsx	Added test coverage for new .env file functionality and updated existing tests for new naming
packages/poml/index.ts	Updated commandLine function to pass sourcePath to dumpTrace
packages/poml/file.tsx	Added logic to read .env files and update sourcePath dynamically
packages/poml-vscode/panel/panel.ts	Added autoAddAssociatedFiles method and optimized resource options handling

Comments suppressed due to low confidence (1)

packages/poml/file.tsx:70

• The regex pattern has an incorrect escape sequence. The pattern \.? should be \. to match a literal dot. The current pattern matches zero or more literal backslashes followed by any character.

      const envFile = this.sourcePath.replace(/(source\.)?\.poml$/i, '.env');