@redaksjon/protokoll 0.0.6 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/constants.js +1 -1
  2. package/package.json +76 -76
  3. package/tsconfig.tsbuildinfo +1 -1
  4. package/vitest.config.ts +5 -5
  5. package/output/kodrdriv/250702-1905-commit-message.md +0 -1
  6. package/output/kodrdriv/250702-1905-commit.request.json +0 -14
  7. package/output/kodrdriv/250702-1905-commit.response.json +0 -36
  8. package/output/kodrdriv/250702-1906-commit-message.md +0 -1
  9. package/output/kodrdriv/250702-1907-commit-message.md +0 -1
  10. package/output/kodrdriv/250702-1907-commit.request.json +0 -14
  11. package/output/kodrdriv/250702-1907-commit.response.json +0 -36
  12. package/output/kodrdriv/250716-1517-review-analysis.md +0 -39
  13. package/output/kodrdriv/250716-1517-review-notes.md +0 -69
  14. package/output/kodrdriv/250716-1518-review-analysis.md +0 -15
  15. package/output/kodrdriv/250716-1518-review-notes.md +0 -67
  16. package/output/kodrdriv/250716-1523-review-analysis.md +0 -36
  17. package/output/kodrdriv/250716-1523-review-notes.md +0 -87
  18. package/output/kodrdriv/250722-1135-commit-message.md +0 -1
  19. package/output/kodrdriv/250722-1331-commit-message.md +0 -1
  20. package/output/kodrdriv/250722-1335-commit-message.md +0 -1
  21. package/output/kodrdriv/250722-1337-commit-message.md +0 -1
  22. package/output/kodrdriv/250722-1342-release-notes.md +0 -26
  23. package/output/kodrdriv/250722-1416-commit-message.md +0 -3
  24. package/output/kodrdriv/250722-1420-commit-message.md +0 -1
  25. package/output/kodrdriv/250722-1422-commit-message.md +0 -1
  26. package/output/kodrdriv/250722-1423-commit-message.md +0 -1
  27. package/output/kodrdriv/250722-1425-release-notes.md +0 -41
  28. package/output/kodrdriv/250722-1527-commit-message.md +0 -13
  29. package/output/kodrdriv/250722-1532-commit-message.md +0 -1
  30. package/output/kodrdriv/250722-1532-release-notes.md +0 -32
  31. package/output/kodrdriv/250722-2314-review-analysis.md +0 -28
  32. package/output/kodrdriv/250722-2314-review-notes.md +0 -464
  33. package/output/kodrdriv/250722-2315-review-analysis.md +0 -28
  34. package/output/kodrdriv/250722-2315-review-notes.md +0 -477
  35. package/output/kodrdriv/250804-1623-review-analysis.md +0 -38
  36. package/output/kodrdriv/250804-1623-review-notes.md +0 -479
  37. package/output/kodrdriv/250804-1638-review-analysis.md +0 -56
  38. package/output/kodrdriv/250804-1638-review-notes.md +0 -502
  39. package/output/kodrdriv/250812-2021-review-analysis.md +0 -27
  40. package/output/kodrdriv/250812-2021-review-notes.md +0 -571
  41. package/output/kodrdriv/250826-0700-commit-message.md +0 -12
  42. package/output/kodrdriv/RELEASE_NOTES.md +0 -30
  43. package/output/kodrdriv/RELEASE_TITLE.md +0 -1
@@ -1,36 +0,0 @@
1
- {
2
- "id": "chatcmpl-Bp3e6B7Z8RoJK60j2j4PCDYTvlCIE",
3
- "object": "chat.completion",
4
- "created": 1751508442,
5
- "model": "gpt-4.1-2025-04-14",
6
- "choices": [
7
- {
8
- "index": 0,
9
- "message": {
10
- "role": "assistant",
11
- "content": "Renamed configuration and context directory files from `.gitcarve` to `.kodrdriv`, consolidating context references and removing legacy settings. Also updated the config structure by eliminating the `verbose` and `model` fields and simplifying `contextDirectories` entries for consistency with the new directory naming.",
12
- "refusal": null,
13
- "annotations": []
14
- },
15
- "logprobs": null,
16
- "finish_reason": "stop"
17
- }
18
- ],
19
- "usage": {
20
- "prompt_tokens": 2087,
21
- "completion_tokens": 60,
22
- "total_tokens": 2147,
23
- "prompt_tokens_details": {
24
- "cached_tokens": 1408,
25
- "audio_tokens": 0
26
- },
27
- "completion_tokens_details": {
28
- "reasoning_tokens": 0,
29
- "audio_tokens": 0,
30
- "accepted_prediction_tokens": 0,
31
- "rejected_prediction_tokens": 0
32
- }
33
- },
34
- "service_tier": "default",
35
- "system_fingerprint": "fp_51e1070cf2"
36
- }
@@ -1,39 +0,0 @@
1
- # Review Analysis Result
2
-
3
- ## Summary
4
- The review highlights significant dissatisfaction with the transcript processing pipeline, specifically loss of fidelity compared to raw Whisper outputs and cumbersome manual workflows for evaluating and comparing transcripts. The reviewer requests investigation into model selection, prompt simplification, and improved tools for transcript comparison.
5
-
6
- ## Total Issues Found
7
- 2
8
-
9
- ## Issues
10
-
11
- [
12
- {
13
- "title": "Investigate and Simplify Transcript Generation Prompt and Model Selection",
14
- "description": "Transcripts generated from the current pipeline are often incomplete or of lower quality compared to direct raw Whisper outputs. The reviewer is dissatisfied with the fidelity of processed transcripts and frequently resorts to manually refining them using ChatGPT 4.5. There is concern that the current prompt or the underlying model may be causing this loss, and the prompt involved in transcript modification may be unnecessarily complex.",
15
- "priority": "high",
16
- "category": "functionality",
17
- "suggestions": [
18
- "Audit which language model is used for processing transcripts and assess if it is optimal for transcription refinement (e.g., consider using ChatGPT 4.5 as referenced).",
19
- "Review and dramatically simplify the prompt used for transcript editing to minimize loss of information and complexity.",
20
- "Experiment with alternate prompts or models and validate output fidelity directly against raw Whisper outputs.",
21
- "Document and share findings with the team, including evidence of improvements."
22
- ]
23
- },
24
- {
25
- "title": "Develop Tooling for Easier Transcript Comparison",
26
- "description": "It is currently time-consuming to compare raw transcripts with processed transcripts, requiring manual location of interim files and external diffing or inspection. Reviewers find this workflow cumbersome and error-prone.",
27
- "priority": "medium",
28
- "category": "functionality",
29
- "suggestions": [
30
- "Develop or integrate a tool or interface that facilitates straightforward side-by-side or inline comparison between raw and processed transcript files.",
31
- "Automate the process of locating and selecting the correct interim files for comparison.",
32
- "Consider adding diff/compare functionality to the existing pipeline with clear output formats (e.g., color-coded diffs, summary statistics on changes)."
33
- ]
34
- }
35
- ]
36
-
37
- ---
38
-
39
- *Analysis completed at 2025-07-16T22:17:12.018Z*
@@ -1,69 +0,0 @@
1
- # Review Notes
2
-
3
- I'm really not happy with the quality and completeness of the transcripts. Whenever I have to look at the output of the transcripts, I end up comparing it to the raw Whisper output and I almost always lose something in the transition. When this happens I end up having to go into ChatGPT and just manually transcribe the raw Whisper transcript with ChatGPT 4.5. Can you investigate if we're using the right model, and can you dramatically simplify what the prompt is to generate a modified transcript?
4
-
5
- You also need to develop some way for you to compare the raw transcript to the processed transcript in a way that is easier to manage. It takes way too much effort to track down the interim file and run a comparison.
6
-
7
- # Commit History Context
8
-
9
-
10
-
11
- [Recent Commit History]
12
- commit 1253f50a35374cf31ae23ed55d53d525b5bd15c6
13
- Author: Simran Jafari <jafarisimran@gmail.com>
14
- Date: Wed Jul 2 19:07:23 2025 -0700
15
-
16
- Renamed configuration and context directory files from `.gitcarve` to `.kodrdriv`, consolidating context references and removing legacy settings. Also updated the config structure by eliminating the `verbose` and `model` fields and simplifying `contextDirectories` entries for consistency with the new directory naming.
17
-
18
- commit febc22b207ecd1208720dc72da93c00ab9c01423
19
- Author: Simran Jafari <jafarisimran@gmail.com>
20
- Date: Fri May 23 17:07:11 2025 -0700
21
-
22
- Introduced several configuration and workflow files to optimize project setup, testing, and automation.
23
-
24
- - Initialized `.cursorrules` with guidelines for testing and mocking ESM modules in Jest.
25
- - Configured ESLint with `.eslintrc.json` to enforce coding standards, leveraging TypeScript rules.
26
- - Set up CodeQL with `codeql.yml` workflow for automated code scanning on the repository.
27
- - Added a workflow `dependency-review.yml` to enforce dependency checks on PRs.
28
- - Created a `pnpm-publish.yml` workflow for publishing packages to GitHub on release.
29
- - Established a basic testing workflow in `test.yml`.
30
- - Added `.npmignore` to exclude unnecessary files from packages.
31
- - Configured Nodemon with `nodemon.json` for development environment.
32
- - Provided a comprehensive `README.md` with usage instructions for the Maloomscan tool.
33
- - Initialized `jest.config.js` for Jest testing setup.
34
- - Defined `package.json` to manage project dependencies and scripts.
35
- - Added TypeScript configurations in `tsconfig.json` for project settings.
36
- - Added a `LICENSE` file with the Apache 2.0 License.
37
- - Written extensive unit and integration tests across various files to ensure functionality, placed under `tests/`.
38
- - Created utility scripts and modules under `src/**` for handling arguments, logging, processing phases, and various utilities related to date handling and file interactions.
39
-
40
- This setup enhances development workflows, improves code quality assurance, and supports automated deployment processes.
41
-
42
-
43
- # Recent Diffs Context
44
-
45
-
46
-
47
- [Recent Diff 1 (HEAD~1)]
48
- diff --git a/.gitcarve/config.yaml b/.kodrdriv/config.yaml
49
- similarity index 63%
50
- rename from .gitcarve/config.yaml
51
- rename to .kodrdriv/config.yaml
52
- index 92f6110..6e93ef3 100644
53
- --- a/.gitcarve/config.yaml
54
- +++ b/.kodrdriv/config.yaml
55
- @@ -1,7 +1,5 @@
56
- -verbose: false
57
- -model: gpt-4o
58
- contextDirectories:
59
- - - .gitcarve/context
60
- + - .kodrdriv/context
61
- commit:
62
- cached: true
63
- sendit: true
64
- diff --git a/.gitcarve/context/content.md b/.kodrdriv/context/content.md
65
- similarity index 100%
66
- rename from .gitcarve/context/content.md
67
- rename to .kodrdriv/context/content.md
68
-
69
-
@@ -1,15 +0,0 @@
1
- # Review Analysis Result
2
-
3
- ## Summary
4
- The review note contains only the text 'Hello# Kodrdriv Review Note' and does not provide any actionable feedback, observations, or suggestions. After analyzing both the review notes and the provided project context, no new issues can be extracted or filed.
5
-
6
- ## Total Issues Found
7
- 0
8
-
9
- ## Issues
10
-
11
- []
12
-
13
- ---
14
-
15
- *Analysis completed at 2025-07-16T22:18:17.251Z*
@@ -1,67 +0,0 @@
1
- # Review Notes
2
-
3
- Hello# Kodrdriv Review Note
4
-
5
- # Commit History Context
6
-
7
-
8
-
9
- [Recent Commit History]
10
- commit 1253f50a35374cf31ae23ed55d53d525b5bd15c6
11
- Author: Simran Jafari <jafarisimran@gmail.com>
12
- Date: Wed Jul 2 19:07:23 2025 -0700
13
-
14
- Renamed configuration and context directory files from `.gitcarve` to `.kodrdriv`, consolidating context references and removing legacy settings. Also updated the config structure by eliminating the `verbose` and `model` fields and simplifying `contextDirectories` entries for consistency with the new directory naming.
15
-
16
- commit febc22b207ecd1208720dc72da93c00ab9c01423
17
- Author: Simran Jafari <jafarisimran@gmail.com>
18
- Date: Fri May 23 17:07:11 2025 -0700
19
-
20
- Introduced several configuration and workflow files to optimize project setup, testing, and automation.
21
-
22
- - Initialized `.cursorrules` with guidelines for testing and mocking ESM modules in Jest.
23
- - Configured ESLint with `.eslintrc.json` to enforce coding standards, leveraging TypeScript rules.
24
- - Set up CodeQL with `codeql.yml` workflow for automated code scanning on the repository.
25
- - Added a workflow `dependency-review.yml` to enforce dependency checks on PRs.
26
- - Created a `pnpm-publish.yml` workflow for publishing packages to GitHub on release.
27
- - Established a basic testing workflow in `test.yml`.
28
- - Added `.npmignore` to exclude unnecessary files from packages.
29
- - Configured Nodemon with `nodemon.json` for development environment.
30
- - Provided a comprehensive `README.md` with usage instructions for the Maloomscan tool.
31
- - Initialized `jest.config.js` for Jest testing setup.
32
- - Defined `package.json` to manage project dependencies and scripts.
33
- - Added TypeScript configurations in `tsconfig.json` for project settings.
34
- - Added a `LICENSE` file with the Apache 2.0 License.
35
- - Written extensive unit and integration tests across various files to ensure functionality, placed under `tests/`.
36
- - Created utility scripts and modules under `src/**` for handling arguments, logging, processing phases, and various utilities related to date handling and file interactions.
37
-
38
- This setup enhances development workflows, improves code quality assurance, and supports automated deployment processes.
39
-
40
-
41
- # Recent Diffs Context
42
-
43
-
44
-
45
- [Recent Diff 1 (HEAD~1)]
46
- diff --git a/.gitcarve/config.yaml b/.kodrdriv/config.yaml
47
- similarity index 63%
48
- rename from .gitcarve/config.yaml
49
- rename to .kodrdriv/config.yaml
50
- index 92f6110..6e93ef3 100644
51
- --- a/.gitcarve/config.yaml
52
- +++ b/.kodrdriv/config.yaml
53
- @@ -1,7 +1,5 @@
54
- -verbose: false
55
- -model: gpt-4o
56
- contextDirectories:
57
- - - .gitcarve/context
58
- + - .kodrdriv/context
59
- commit:
60
- cached: true
61
- sendit: true
62
- diff --git a/.gitcarve/context/content.md b/.kodrdriv/context/content.md
63
- similarity index 100%
64
- rename from .gitcarve/context/content.md
65
- rename to .kodrdriv/context/content.md
66
-
67
-
@@ -1,36 +0,0 @@
1
- # Review Analysis Result
2
-
3
- ## Summary
4
- The review feedback highlights significant dissatisfaction with the current transcript processing approach. Valuable information is being lost when transforming raw Whisper transcripts into processed versions. The reviewer requests changes to the transcript formatting process and suggests reevaluating both the prompt and the model in use.
5
-
6
- ## Total Issues Found
7
- 2
8
-
9
- ## Issues
10
-
11
- [
12
- {
13
- "title": "Loss of Information in Processed Transcripts",
14
- "description": "When converting raw Whisper transcripts into processed versions, a significant amount of valuable information is lost. This harms the usefulness and fidelity of the transcripts for downstream users.",
15
- "priority": "high",
16
- "category": "functionality",
17
- "suggestions": [
18
- "Review and adjust the transcript processing logic to preserve all original information present in raw Whisper outputs.",
19
- "Audit the transformation pipeline to identify steps where data loss occurs and refactor as needed."
20
- ]
21
- },
22
- {
23
- "title": "Improve Transcript Prompt and Model Selection",
24
- "description": "The current prompt used to generate processed transcripts needs refinement to produce clearer and more useful results. Additionally, the transcript model in use may not be the best fit and should be reconsidered.",
25
- "priority": "medium",
26
- "category": "functionality",
27
- "suggestions": [
28
- "Update or rewrite the prompt to focus on formatting the transcript for clarity without discarding original content.",
29
- "Evaluate alternative models or configurations that can better preserve details and provide more straightforward, accurately formatted transcripts."
30
- ]
31
- }
32
- ]
33
-
34
- ---
35
-
36
- *Analysis completed at 2025-07-16T22:23:24.660Z*
@@ -1,87 +0,0 @@
1
- # Review Notes
2
-
3
- There's a problem with the processed transcripts, whenever I see that trascript that is processed from the raw Whisper transcript I see that it loses a lot of the information that was in the original raw Whisper transcript. I need to work on the prompt that generates this, and I think we also need to reconsider what model is being used to capture this transcript. Instead of a summary, I'd like some that is just formatting the transcript and making it more straightforward to understand.
4
-
5
- # Commit History Context
6
-
7
-
8
-
9
- [Recent Commit History]
10
- commit 1253f50a35374cf31ae23ed55d53d525b5bd15c6
11
- Author: Simran Jafari <jafarisimran@gmail.com>
12
- Date: Wed Jul 2 19:07:23 2025 -0700
13
-
14
- Renamed configuration and context directory files from `.gitcarve` to `.kodrdriv`, consolidating context references and removing legacy settings. Also updated the config structure by eliminating the `verbose` and `model` fields and simplifying `contextDirectories` entries for consistency with the new directory naming.
15
-
16
- commit febc22b207ecd1208720dc72da93c00ab9c01423
17
- Author: Simran Jafari <jafarisimran@gmail.com>
18
- Date: Fri May 23 17:07:11 2025 -0700
19
-
20
- Introduced several configuration and workflow files to optimize project setup, testing, and automation.
21
-
22
- - Initialized `.cursorrules` with guidelines for testing and mocking ESM modules in Jest.
23
- - Configured ESLint with `.eslintrc.json` to enforce coding standards, leveraging TypeScript rules.
24
- - Set up CodeQL with `codeql.yml` workflow for automated code scanning on the repository.
25
- - Added a workflow `dependency-review.yml` to enforce dependency checks on PRs.
26
- - Created a `pnpm-publish.yml` workflow for publishing packages to GitHub on release.
27
- - Established a basic testing workflow in `test.yml`.
28
- - Added `.npmignore` to exclude unnecessary files from packages.
29
- - Configured Nodemon with `nodemon.json` for development environment.
30
- - Provided a comprehensive `README.md` with usage instructions for the Maloomscan tool.
31
- - Initialized `jest.config.js` for Jest testing setup.
32
- - Defined `package.json` to manage project dependencies and scripts.
33
- - Added TypeScript configurations in `tsconfig.json` for project settings.
34
- - Added a `LICENSE` file with the Apache 2.0 License.
35
- - Written extensive unit and integration tests across various files to ensure functionality, placed under `tests/`.
36
- - Created utility scripts and modules under `src/**` for handling arguments, logging, processing phases, and various utilities related to date handling and file interactions.
37
-
38
- This setup enhances development workflows, improves code quality assurance, and supports automated deployment processes.
39
-
40
-
41
- # Recent Diffs Context
42
-
43
-
44
-
45
- [Recent Diff 1 (HEAD~1)]
46
- diff --git a/.gitcarve/config.yaml b/.kodrdriv/config.yaml
47
- similarity index 63%
48
- rename from .gitcarve/config.yaml
49
- rename to .kodrdriv/config.yaml
50
- index 92f6110..6e93ef3 100644
51
- --- a/.gitcarve/config.yaml
52
- +++ b/.kodrdriv/config.yaml
53
- @@ -1,7 +1,5 @@
54
- -verbose: false
55
- -model: gpt-4o
56
- contextDirectories:
57
- - - .gitcarve/context
58
- + - .kodrdriv/context
59
- commit:
60
- cached: true
61
- sendit: true
62
- diff --git a/.gitcarve/context/content.md b/.kodrdriv/context/content.md
63
- similarity index 100%
64
- rename from .gitcarve/context/content.md
65
- rename to .kodrdriv/context/content.md
66
-
67
-
68
- # GitHub Issues Context
69
-
70
- Issue #6: Transcription Fails Due to OpenAI Connection Error – Improve Resiliency
71
- Labels: none
72
- Created: 2025-05-27T17:41:08Z
73
- Updated: 2025-05-27T17:41:08Z
74
- Body: During audio file processing, transcription consistently fails due to transient connection errors with the OpenAI API. These failures currently halt processing entirely for the affected file, and no recovery or retry logic is in place.
75
-
76
- **Steps to Reproduce:**
77
-
78
- 1. Run the processor on a directory containing `.m4a` files.
79
- 2. A connection error occurs during the transcription step.
80
- 3. The file is skipped or the entire process halts without recovery.
81
-
82
- **Observed Behavior:**
83
-
84
- ```
85
- Error: Connection e...
86
- ---
87
-
@@ -1 +0,0 @@
1
- Removed ts-expect-error for config shape in matnava.ts, corrected error assertion in media utility test to throw an error, and fixed typo in tsconfig.json types array by removing duplicate entries and ensuring correct type specification.
@@ -1 +0,0 @@
1
- Upgraded @riotprompt/riotprompt, @theunwalked/cardigantime, and @theunwalked/dreadcabinet dependencies from local workspace links to released package versions in package.json, removed pnpm-workspace.yaml, and updated the packageManager field to require pnpm 10.13.1. This streamlines dependency management by transitioning from local development references to stable, published versions, and eliminates the need for custom workspace overrides.
@@ -1 +0,0 @@
1
- Removed mockdate from devDependencies in package.json to eliminate unused development dependency.
@@ -1 +0,0 @@
1
- Removed duplicate test execution in GitHub Actions workflows by deleting redundant 'pnpm test --coverage' steps from both pnpm-publish.yml and test.yml, ensuring tests run only once before code coverage upload.
@@ -1,26 +0,0 @@
1
- # Transition to Published Dependencies, CI Workflow Clean-up, and Minor Code Improvements
2
-
3
- This release harmonises dependency management, clarifies project structure, and attends to minor correctness in test and configuration logic. Following the guiding intention—outlined in the Release Focus—of streamlining dependency resolution and simplifying development flows, these changes prioritise clarity and stability for developers building on or contributing to Matnava.
4
-
5
- **Improvements**
6
-
7
- * Package dependencies have been changed from local workspace links to stable released versions for `@riotprompt/riotprompt`, `@theunwalked/cardigantime`, and `@theunwalked/dreadcabinet`. This moves the project away from local coupling towards a more maintainable and reproducible build (see `package.json`).
8
- * The minimum required `pnpm` version is now set to `10.13.1` (updated in `package.json`), aligning with modern package management conventions.
9
- * The now-unnecessary `pnpm-workspace.yaml` has been deleted, since local overrides are no longer relevant.
10
- * The unused development dependency `mockdate` has been removed, trimming extraneous baggage from `package.json`.
11
-
12
- **Continuous Integration Changes**
13
-
14
- * The test workflows (`.github/workflows/pnpm-publish.yml` and `test.yml`) have been cleaned up: duplicate `pnpm test --coverage` runs have been removed, ensuring each test executes only once before code coverage is uploaded.
15
-
16
- **Code & Configuration Fixes**
17
-
18
- * In `src/matnava.ts`, code comments and handling for config schema types have been refined to remove a workaround relating to `zod` type compatibility.
19
- * The `types` field in `tsconfig.json` has been corrected to reference only `vitest/globals` instead of `jest`, preventing possible confusion or unintended type imports.
20
- * Test utility (`tests/util/media.test.ts`) now uses `throw new Error(...)` instead of the deprecated `fail()` pattern, ensuring accurate failure reporting in async error checks.
21
-
22
- ---
23
-
24
- > "درخت هرچه بارورتر افتاده‌تر (The more fruitful the tree, the more it bows.)"
25
- >
26
- > With roots in clarity and branches reaching for community, this release aims for simplicity over spectacle.
@@ -1,3 +0,0 @@
1
- Removed local configuration and context files in favor of pnpm-workspace.yaml overrides; tightened dependency handling and updated instructional prompt
2
-
3
- Deleted .cursorrules, .kodrdriv/config.yaml, and .kodrdriv/context/content.md to eliminate local test, workflow, and documentation rules. Added pnpm-workspace.yaml with explicit package link overrides to control dependency resolution. Expanded and clarified src/prompt/instructions/transcribe.md to set stricter constraints and formatting requirements for transcript processing, including clearer guidelines for spelling correction, Markdown structure, and fidelity, while discouraging summarization and interpretation. Refined src/arguments.ts and src/constants.ts to streamline config merging and remove unnecessary default properties and early argument parsing for --check-config and --init-config. Adjusted SecureConfigSchema in src/matnava.ts for proper secure configuration typing. Updated Vite rollupOptions externals list for more robust dependency exclusion. These changes enhance reproducibility, make project dependency management explicit, and improve transcript post-processing consistency.
@@ -1 +0,0 @@
1
- No changes detected — empty commit.
@@ -1 +0,0 @@
1
- No changes detected — empty commit.
@@ -1 +0,0 @@
1
- No changes detected — empty commit.
@@ -1,41 +0,0 @@
1
- # Dependency Upgrade, Workspace Cleanup, and Transcript Prompt Enhancement
2
-
3
- In this release, the focus shifts towards streamlining dependency management, reducing local configuration overhead, and refining transcript formatting guidance to ensure accuracy, readability, and clarity. The intent—echoing the motif of clearing garden paths for new growth—is to make the project more reproducible and instructions for transcript post-processing more explicit, as guided by thoughtful constraint and curation.
4
-
5
- **Improvements**
6
-
7
- * **Dependencies Now Use Released Versions:**
8
- * Upgraded `@riotprompt/riotprompt`, `@theunwalked/cardigantime`, and `@theunwalked/dreadcabinet` from local workspace links to published package versions in `package.json`.
9
- * Updated the `packageManager` requirement to `pnpm 10.13.1`.
10
- * Expanded Vite/rollup externals configuration for more robust build outputs.
11
-
12
- * **Configuration and Workspace Simplification:**
13
- * Removed `.kodrdriv/config.yaml`, `.kodrdriv/context/content.md`, `.cursorrules`, and `pnpm-workspace.yaml` to eliminate bespoke local configuration, manual dependency overrides, and context files no longer needed with published packages.
14
- * Configuration handling in `src/arguments.ts` no longer gives precedence to isolated `--check-config` or `--init-config` flags; logic is streamlined for consistent config merging and validation.
15
- * Redundant or unused default config properties removed from `src/constants.ts`.
16
- * `SecureConfigSchema` in `src/matnava.ts` now has correct typing for improved type safety.
17
- * Internal test and dev helper tips (e.g., about usage of `@ts-ignore` or mocking ESM modules in Jest) are no longer maintained as separate files.
18
-
19
- * **Enhanced Transcript Post-Processing Prompt:**
20
- * `src/prompt/instructions/transcribe.md` is rewritten for clarity: defines strictly what must be preserved, formatted, or corrected when processing Whisper transcripts.
21
- * Clearer Markdown output structure, rules for paragraph and heading division, and a gentle but firm reminder not to summarise, interpret, or embellish transcripts.
22
- * Adds constraints and concrete examples for spelling correction, entity resolution, and handling repetition—anchored in the value of preserving speaker intent and context fidelity.
23
- * Outlines acceptable and unacceptable types of modification, improving downstream uses of the tool.
24
-
25
- **Build and Test Workflow Updates**
26
-
27
- * `mockdate` is removed from devDependencies as it is unused.
28
- * Minor fixes to test assertions and type arrays in configuration files (e.g., `tsconfig.json` and tests/util/media.test.ts)
29
- * Adjusted GitHub Actions (`pnpm-publish.yml`, `test.yml`) to run tests a single time before code coverage upload, preventing redundant executions.
30
-
31
- ---
32
-
33
- Like the careful pruning of a flowering bush, these changes clear away accumulated local constraints, update roots for stability, and nurture more reliable collaboration and clearer user-facing behaviour.
34
-
35
- ```text
36
- "هر گل رعنا که در این بستان است
37
- پیش اندیشهٔ ما خار کم از گل باشد"
38
-
39
- "For every flourish in this garden, wisdom sees the nettle beneath the rose."
40
- // This release cuts back the nettles of local overrides, opening space for shared understanding.
41
- ```
@@ -1,13 +0,0 @@
1
- Add documentation site for Matnava with automated GitHub Pages deployment
2
-
3
- Introduce a standalone documentation site under the `docs/` directory, built with React and Vite, featuring step-by-step setup instructions, feature overview, example usage, and customization guidance. The site leverages modern styling with dark/light mode support and is configured for GitHub Pages deployment.
4
-
5
- Key additions and setup:
6
- - `docs/README.md`: Instructions for local development, structure, and deployment workflow.
7
- - `docs/src/`: Contains the main React components and styles (`App.jsx`, `index.css`, `main.jsx`).
8
- - `docs/vite.config.js`: Vite configuration with `/matnava/` base for correct GH Pages routing.
9
- - `docs/package.json`: Dependencies and scripts using pnpm.
10
- - `.github/workflows/deploy-docs.yml`: GitHub Actions workflow to build and deploy the docs site on pushes to the `main` branch.
11
- - `.gitignore`: Node, build artifacts, and local config files ignored under `docs/`.
12
-
13
- This enables automated, seamless deployment of up-to-date documentation with every change to the `main` branch.
@@ -1 +0,0 @@
1
- No changes detected — empty commit.
@@ -1,32 +0,0 @@
1
- # Standalone Documentation Site with Automated GitHub Pages Deployment
2
-
3
- This release centres on introducing a dedicated documentation site for Matnava, echoing a garden carefully cultivated for newcomers and long-time wanderers alike. The effort harmonises documentation, hosting, and dependency management: the "Release Focus" is to provide contributors and users with a reliable, self-contained, and always-current source of guidance, automatically deployed on every update to the main branch.
4
-
5
- **New Features**
6
-
7
- * Added a standalone React-based documentation site under the `docs/` directory.
8
- * Documentation details quick start, key features, usage patterns, output formats, and customization guidance for Matnava.
9
- * Modern design with dark/light mode support and a focus on clarity.
10
-
11
- **Automated Deployment**
12
-
13
- * Introduced `.github/workflows/deploy-docs.yml` GitHub Actions workflow to automate building and deploying the documentation site to GitHub Pages on pushes to the `main` branch.
14
- * Deployment to `https://[username].github.io/matnava/` ensures the docs are always fresh and accessible, with each update reflected in production automatically.
15
-
16
- **Dependency and Build Isolation**
17
-
18
- * Added `docs/package-lock.json` to lock documentation site dependencies, ensuring reproducible installs and reliable CI builds.
19
- * Introduced `docs/.npmrc` with `ignore-workspace=true` so that docs dependencies are not impacted by workspace or monorepo settings.
20
- * Local development and CI are made more robust as docs/builds are decoupled from global or other workspace configurations.
21
-
22
- **Project Structure**
23
-
24
- * The documentation site's main content lives in `docs/src/`, with `App.jsx` (content), `index.css` (styling), and `main.jsx` (entry point).
25
- * Vite is configured (`docs/vite.config.js`) for correct production routing under GitHub Pages.
26
- * `.gitignore` within `docs/` keeps node modules, builds, dotfiles, and IDE settings out of version control.
27
-
28
- ---
29
-
30
- If I may borrow a phrase: "هر که در این سرا درآید، نانش دهید و از ایمانش مپرسید." ∎
31
-
32
- > "Whoever enters this house, give them bread and do not ask of their faith." (Inscription at the tomb of Persian poet Saadi)
@@ -1,28 +0,0 @@
1
- # Review Analysis Result
2
-
3
- ## Summary
4
- The review highlights the need for a systematic and intelligent approach to file management of audio transcripts, suggesting the introduction or use of dedicated directories (such as 'transcripts' and 'notes') to streamline processing and prevent redundant reprocessing. The current workflow causes confusion and inefficiency due to transcripts being repeatedly sent to the same processing engines, as there is no file organization indicating completed or in-progress items.
5
-
6
- ## Total Issues Found
7
- 1
8
-
9
- ## Issues
10
-
11
- [
12
- {
13
- "title": "Introduce dedicated directories for transcript file lifecycle management",
14
- "description": "Currently, all transcript files are collected without a clear organizational system, leading to duplicate processing and reduced workflow efficiency. The reviewer suggests implementing a system where transcripts, once generated by the transcription tool (e.g., Matnava), are placed in a dedicated 'transcripts' directory. After they are processed (e.g., reviewed or converted into notes), they should be moved to a secondary directory such as 'notes' or 'review'. This will make it easier to track which files need further attention and which have already been processed, reducing the risk of unnecessary duplicate work.",
15
- "priority": "medium",
16
- "category": "functionality",
17
- "suggestions": [
18
- "Update the transcript generation tool to save all new transcripts in a top-level 'transcripts' directory.",
19
- "Implement logic or a script to move transcripts from 'transcripts' to a 'notes' or 'review' directory once they have been processed.",
20
- "Update documentation and workflow instructions to clarify the new file handling process for transcripts and notes.",
21
- "Consider adopting a naming or tagging system to further clarify the processing status of each file if directories alone are not sufficient."
22
- ]
23
- }
24
- ]
25
-
26
- ---
27
-
28
- *Analysis completed at 2025-07-23T06:14:55.213Z*