truecourse 0.1.13 → 0.1.15
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.
- package/cli.mjs +153 -76
- package/package.json +4 -4
- package/public/assets/{index-CVwZeppe.js → index-DMFqQ7fW.js} +63 -63
- package/public/index.html +2 -2
- package/server.mjs +258 -94
- package/skills/truecourse/truecourse-analyze/SKILL.md +39 -0
- package/skills/truecourse/truecourse-fix/SKILL.md +34 -0
- package/skills/truecourse/truecourse-list/SKILL.md +26 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: truecourse-analyze
|
|
3
|
+
description: Run TrueCourse architecture analysis on this repository
|
|
4
|
+
user_invocable: true
|
|
5
|
+
triggers:
|
|
6
|
+
- analyze this repo
|
|
7
|
+
- run analysis
|
|
8
|
+
- check my code
|
|
9
|
+
- run a diff check
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# TrueCourse Analyze
|
|
13
|
+
|
|
14
|
+
Run architecture analysis on the current repository using TrueCourse.
|
|
15
|
+
|
|
16
|
+
## Important
|
|
17
|
+
|
|
18
|
+
- The TrueCourse server must be running before using this skill. If it's not running, tell the user to start it with `npx truecourse start` and try again.
|
|
19
|
+
- Full analysis stashes any uncommitted changes, analyzes the clean working tree, then unstashes. The user's uncommitted work is preserved.
|
|
20
|
+
- Diff check analyzes only files changed since the last analysis — it does NOT stash.
|
|
21
|
+
|
|
22
|
+
## Instructions
|
|
23
|
+
|
|
24
|
+
1. Ask the user whether they want a **full analysis** or a **diff check** (changes only). If they mentioned "diff" in their request, default to diff mode.
|
|
25
|
+
|
|
26
|
+
2. Run the appropriate command using the Bash tool:
|
|
27
|
+
- **Full analysis:** `npx truecourse analyze --no-autostart`
|
|
28
|
+
- **Diff check:** `npx truecourse analyze --diff --no-autostart`
|
|
29
|
+
|
|
30
|
+
3. This is a long-running command (can take several minutes). Let it run to completion — do NOT set a short timeout. Use a timeout of at least 600000ms (10 minutes).
|
|
31
|
+
|
|
32
|
+
4. If the command fails with "Could not connect to TrueCourse server", tell the user to run `npx truecourse start` first.
|
|
33
|
+
|
|
34
|
+
5. When the command finishes, summarize the output for the user:
|
|
35
|
+
- Number of violations found (by severity)
|
|
36
|
+
- Number of changed files (for diff mode)
|
|
37
|
+
- Any errors that occurred
|
|
38
|
+
|
|
39
|
+
6. After summarizing, tell the user they can run `/truecourse-list` to see the full violation details, or `/truecourse-fix` to apply suggested fixes.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: truecourse-fix
|
|
3
|
+
description: Fix TrueCourse violations that have suggested fixes
|
|
4
|
+
user_invocable: true
|
|
5
|
+
triggers:
|
|
6
|
+
- fix violations
|
|
7
|
+
- apply fixes
|
|
8
|
+
- fix my code
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# TrueCourse Fix
|
|
12
|
+
|
|
13
|
+
Apply fixes for TrueCourse violations that have fix suggestions.
|
|
14
|
+
|
|
15
|
+
## Instructions
|
|
16
|
+
|
|
17
|
+
1. First, fetch the current violations by running:
|
|
18
|
+
```
|
|
19
|
+
npx truecourse list
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
2. Parse the output to identify violations that have a **Fix:** suggestion. These are the only violations that can be automatically fixed.
|
|
23
|
+
|
|
24
|
+
3. If no violations have fix suggestions, tell the user and stop.
|
|
25
|
+
|
|
26
|
+
4. Present the fixable violations to the user as a numbered list with their title, severity, and target location. Ask which ones they'd like to fix (they can pick specific numbers or say "all").
|
|
27
|
+
|
|
28
|
+
5. For each selected violation, read the fix suggestion and apply it to the codebase:
|
|
29
|
+
- The fix suggestion describes what code change to make
|
|
30
|
+
- Use the Read tool to read the relevant source file(s)
|
|
31
|
+
- Use the Edit tool to apply the fix
|
|
32
|
+
- Explain what you changed
|
|
33
|
+
|
|
34
|
+
6. After applying fixes, suggest the user run `/truecourse-analyze` again to verify the fixes resolved the violations.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: truecourse-list
|
|
3
|
+
description: List TrueCourse violations found in this repository
|
|
4
|
+
user_invocable: true
|
|
5
|
+
triggers:
|
|
6
|
+
- show violations
|
|
7
|
+
- list issues
|
|
8
|
+
- what violations were found
|
|
9
|
+
- show diff results
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# TrueCourse List
|
|
13
|
+
|
|
14
|
+
Show violations and analysis results from TrueCourse.
|
|
15
|
+
|
|
16
|
+
## Instructions
|
|
17
|
+
|
|
18
|
+
1. Determine whether to show **full violations** or **diff results**. If the user mentioned "diff" in their request, use diff mode.
|
|
19
|
+
|
|
20
|
+
2. Run the appropriate command using the Bash tool:
|
|
21
|
+
- **Full violations:** `npx truecourse list`
|
|
22
|
+
- **Diff results:** `npx truecourse list --diff`
|
|
23
|
+
|
|
24
|
+
3. Present the output to the user. The command output is already formatted — show it as-is.
|
|
25
|
+
|
|
26
|
+
4. If violations with fix suggestions are found, tell the user they can run `/truecourse-fix` to apply fixes.
|