Skip to content

Commit f57a909

Browse files
committed
Add dependency graph and update README
Add command→script and script→script dependency graph to README. Update pr-status.sh description (now uses gh api, not GITHUB_TOKEN). Add install-deps.sh, tool-sync.sh, port-to-opencode.sh, convention-sync.sh to the companion scripts tables.
1 parent 15cfa35 commit f57a909

File tree

1 file changed

+83
-1
lines changed

1 file changed

+83
-1
lines changed

.cursor/README.md

Lines changed: 83 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ All GitHub API operations use **`gh` CLI** (`gh api`, `gh api graphql`, `gh pr`)
112112
| Script | What it does | API |
113113
|--------|-------------|-----|
114114
| [`pr-status-gql.sh`](.cursor/commands/pr-status-gql.sh) | PR status with review state, CI checks, new comments (primary) | `gh api graphql` |
115-
| [`pr-status.sh`](.cursor/commands/pr-status.sh) | Same as above, REST fallback when `gh` unavailable | `https` + `$GITHUB_TOKEN` |
115+
| [`pr-status.sh`](.cursor/commands/pr-status.sh) | Same as above, REST fallback | `gh api` REST |
116116
| [`pr-watch.sh`](.cursor/commands/pr-watch.sh) | TUI wrapper — auto-refresh dashboard with rate limit awareness | Delegates to above |
117117

118118
### PR Landing Pipeline (`/pr-land`)
@@ -154,8 +154,90 @@ These scripts run sequentially. Each handles one phase of the landing workflow:
154154
|--------|-------------|
155155
| [`lint-commit.sh`](.cursor/commands/lint-commit.sh) | ESLint `--fix` before commit, auto-runs `update-eslint-warnings` when available |
156156
| [`lint-warnings.sh`](.cursor/commands/lint-warnings.sh) | Update `eslint-warnings.mdc` knowledge base from current lint output |
157+
| [`install-deps.sh`](.cursor/commands/install-deps.sh) | Install dependencies and run prepare script |
157158
| [`upgrade-dep.sh`](.cursor/commands/upgrade-dep.sh) | Upgrade a dependency in the GUI repo |
158159

160+
### Sync & Portability
161+
162+
| Script | What it does |
163+
|--------|-------------|
164+
| [`convention-sync.sh`](.cursor/commands/convention-sync.sh) | Diff and sync `~/.cursor/` files with the edge-conventions repo |
165+
| [`tool-sync.sh`](.cursor/commands/tool-sync.sh) | Sync Cursor rules, commands, and scripts to OpenCode and Claude Code formats |
166+
| [`port-to-opencode.sh`](.cursor/scripts/port-to-opencode.sh) | Convert Cursor `.mdc`/`.md` files to OpenCode-compatible JSON + MD mirrors |
167+
168+
---
169+
170+
## Dependency Graph
171+
172+
Command → script dependencies and script → script cross-references.
173+
174+
### Commands → Scripts
175+
176+
```
177+
/im ─────────────── lint-warnings.sh
178+
lint-commit.sh
179+
install-deps.sh
180+
verify-repo.sh
181+
asana-get-context.sh
182+
183+
/pr-create ──────── pr-create.sh
184+
lint-commit.sh
185+
verify-repo.sh
186+
asana-attach-pr.sh ──→ asana-whoami.sh
187+
asana-get-context.sh
188+
189+
/pr-address ─────── pr-address.sh
190+
lint-commit.sh
191+
192+
/pr-review ──────── github-pr-review.sh
193+
194+
/pr-land ────────── pr-land-discover.sh
195+
pr-land-comments.sh
196+
pr-land-prepare.sh ──→ edge-repo.js
197+
verify-repo.sh
198+
pr-land-merge.sh ────→ edge-repo.js
199+
pr-land-publish.sh ──→ edge-repo.js
200+
pr-land-extract-asana-task.sh
201+
asana-verification-needed.sh
202+
lint-commit.sh
203+
upgrade-dep.sh
204+
205+
/dep-pr ─────────── asana-get-context.sh
206+
asana-create-dep-task.sh ──→ asana-whoami.sh
207+
208+
/convention-sync ── convention-sync.sh
209+
210+
/standup ────────── asana-standup.sh ──→ asana-whoami.sh
211+
github-pr-activity.sh
212+
213+
/chat-audit ─────── cursor-chat-extract.js
214+
215+
/task-review ────── asana-get-context.sh
216+
217+
/changelog ──────── (no scripts)
218+
/q ──────────────── (no scripts)
219+
/author ─────────── (no scripts)
220+
```
221+
222+
### Script → Script
223+
224+
```
225+
asana-attach-pr.sh ────────→ asana-whoami.sh
226+
asana-create-dep-task.sh ──→ asana-whoami.sh
227+
asana-standup.sh ──────────→ asana-whoami.sh
228+
pr-watch.sh ───────────────→ pr-status-gql.sh | pr-status.sh
229+
pr-land-prepare.sh ────────→ edge-repo.js
230+
pr-land-merge.sh ──────────→ edge-repo.js
231+
pr-land-publish.sh ────────→ edge-repo.js
232+
```
233+
234+
### Shared Modules
235+
236+
```
237+
edge-repo.js ──── Used by: pr-land-prepare.sh, pr-land-merge.sh, pr-land-publish.sh
238+
asana-whoami.sh ─ Used by: asana-attach-pr.sh, asana-create-dep-task.sh, asana-standup.sh
239+
```
240+
159241
---
160242

161243
## Shared Module: `edge-repo.js`

0 commit comments

Comments
 (0)