@grunnverk/kodrdriv 1.5.0 → 1.5.1

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.
@@ -4,10 +4,16 @@
4
4
 
5
5
  Ensure that precommit checks pass successfully across the entire monorepo tree. When failures occur, understand the root cause, fix the issues, and resume from the point of failure rather than restarting from the beginning.
6
6
 
7
- ## Critical: Monorepo Root Directory
7
+ ## Prerequisites
8
8
 
9
- **IMPORTANT**: The monorepo root directory is `/Users/tobrien/gitw/grunnverk`, NOT `/Users/tobrien/gitw/grunnverk/kodrdriv`.
9
+ Before proceeding, fetch the workspace resource to understand the monorepo structure:
10
+
11
+ **Workspace Resource**: `kodrdriv://workspace[/path/to/directory]`
12
+ - Confirms this is a tree operation (`packages.length > 1`)
13
+ - Provides the list of all packages in the monorepo
14
+ - Shows the root directory of the monorepo
10
15
 
16
+ **IMPORTANT**: The monorepo root directory is `/Users/tobrien/gitw/grunnverk`, NOT `/Users/tobrien/gitw/grunnverk/kodrdriv`.
11
17
  - `kodrdriv` is a subdirectory within the `grunnverk` monorepo
12
18
  - All tree commands MUST be run from the grunnverk root: `/Users/tobrien/gitw/grunnverk`
13
19
  - Never run tree commands from within the kodrdriv subdirectory
@@ -66,7 +72,10 @@ Ensure that precommit checks pass successfully across the entire monorepo tree.
66
72
  ## Example Flow
67
73
 
68
74
  ```
69
- 1. kodrdriv_tree_precommit({
75
+ 1. Fetch kodrdriv://workspace/Users/tobrien/gitw/grunnverk
76
+ → Confirms this is a tree with multiple packages
77
+
78
+ 2. kodrdriv_tree_precommit({
70
79
  directory: "/Users/tobrien/gitw/grunnverk",
71
80
  fix: true,
72
81
  parallel: true // CRITICAL: Speeds up execution significantly
@@ -74,10 +83,10 @@ Ensure that precommit checks pass successfully across the entire monorepo tree.
74
83
  → Fails at package "@grunnverk/commands-git"
75
84
  → Error: "Command failed in package @grunnverk/commands-git"
76
85
 
77
- 2. Analyze error: TypeScript type error in src/git.ts:42
86
+ 3. Analyze error: TypeScript type error in src/git.ts:42
78
87
  → Fix the type error in the commands-git package
79
88
 
80
- 3. kodrdriv_tree_precommit({
89
+ 4. kodrdriv_tree_precommit({
81
90
  directory: "/Users/tobrien/gitw/grunnverk",
82
91
  fix: true,
83
92
  parallel: true, // ALWAYS include parallel=true
@@ -85,9 +94,9 @@ Ensure that precommit checks pass successfully across the entire monorepo tree.
85
94
  })
86
95
  → Continues from commands-git, may fail at next package
87
96
 
88
- 4. Repeat until all pass (always using MCP tools with parallel=true, never manual commands)
97
+ 5. Repeat until all pass (always using MCP tools with parallel=true, never manual commands)
89
98
 
90
- 5. kodrdriv_tree_commit({
99
+ 6. kodrdriv_tree_commit({
91
100
  directory: "/Users/tobrien/gitw/grunnverk",
92
101
  sendit: true
93
102
  })
@@ -4,6 +4,15 @@
4
4
 
5
5
  Execute a complete publishing workflow for a monorepo tree. Handle errors gracefully, fix issues as they arise, and resume from checkpoints when appropriate.
6
6
 
7
+ ## Prerequisites
8
+
9
+ Before proceeding, fetch the workspace resource to understand the monorepo structure:
10
+
11
+ **Workspace Resource**: `kodrdriv://workspace[/path/to/directory]`
12
+ - Confirms this is a tree operation (`packages.length > 1`)
13
+ - Provides the list of all packages in the monorepo
14
+ - Shows the root directory and dependency relationships
15
+
7
16
  ## Pre-Publish Verification
8
17
 
9
18
  **Important**: Before running `kodrdriv_tree_publish`, verify that `kodrdriv_tree_precommit` works successfully.
@@ -105,14 +114,22 @@ After a successful publish workflow, projects should end up in a "working" branc
105
114
  ## Example Flow
106
115
 
107
116
  ```
108
- 1. Run kodrdriv_tree_precommit({ parallel: true }) (unless fix_and_commit was just run)
117
+ 1. Fetch kodrdriv://workspace/path/to/monorepo
118
+ → Confirms this is a tree with multiple packages
119
+
120
+ 2. Run kodrdriv_tree_precommit({ parallel: true }) (unless fix_and_commit was just run)
109
121
  → Use parallel=true to speed up execution significantly
110
- 2. Run kodrdriv_tree_publish
122
+
123
+ 3. Run kodrdriv_tree_publish
111
124
  → Error: PR validation failed for @org/package-a
112
125
  → Link provided: https://github.com/org/repo/pull/123
113
- 3. Investigate PR #123 → Find failing test
114
- 4. Fix the testCommit and push
115
- 5. **Return to top-level directory** → Run kodrdriv_tree_publish({ continue: true })
126
+
127
+ 4. Investigate PR #123Find failing test
128
+
129
+ 5. Fix the test → Commit and push
130
+
131
+ 6. **Return to top-level directory** → Run kodrdriv_tree_publish({ continue: true })
116
132
  → Resumes from checkpoint, continues processing with maintained context
117
- 6. Monitor for additional errors or completion
133
+
134
+ 7. Monitor for additional errors or completion
118
135
  ```