@chrisdudek/yg 0.3.4 → 1.1.0
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/README.md +28 -2
- package/dist/bin.js +1818 -1232
- package/dist/bin.js.map +1 -1
- package/dist/templates/default-config.ts +3 -14
- package/dist/templates/rules.ts +272 -186
- package/graph-schemas/aspect.yaml +9 -0
- package/graph-schemas/config.yaml +39 -0
- package/graph-schemas/flow.yaml +10 -0
- package/graph-schemas/node.yaml +19 -0
- package/package.json +2 -2
- package/graph-templates/aspect.yaml +0 -2
- package/graph-templates/flow.yaml +0 -8
- package/graph-templates/knowledge.yaml +0 -2
- package/graph-templates/node.yaml +0 -17
package/README.md
CHANGED
|
@@ -39,6 +39,10 @@ yg build-context --node orders/order-service
|
|
|
39
39
|
|
|
40
40
|
## Core Commands
|
|
41
41
|
|
|
42
|
+
**Diagnostics:**
|
|
43
|
+
|
|
44
|
+
- `yg preflight [--quick]` — Unified diagnostic report: journal, drift, status, validation
|
|
45
|
+
|
|
42
46
|
**Reading and analysis:**
|
|
43
47
|
|
|
44
48
|
- `yg build-context --node <path>` — Assemble context package for a node
|
|
@@ -47,12 +51,15 @@ yg build-context --node orders/order-service
|
|
|
47
51
|
- `yg owner --file <path>` — Find which graph node owns a source file
|
|
48
52
|
- `yg deps --node <path>` — Forward dependency tree and materialization order
|
|
49
53
|
- `yg impact --node <path> [--simulate]` — Reverse dependencies and context impact
|
|
54
|
+
- `yg aspects` — List aspects with metadata (YAML output)
|
|
55
|
+
- `yg flows` — List flows with metadata (YAML output)
|
|
50
56
|
|
|
51
57
|
**Validation and drift:**
|
|
52
58
|
|
|
53
59
|
- `yg validate [--scope all|node-path]` — Structural integrity and completeness
|
|
54
|
-
- `yg drift [--scope all|node-path]` — Detect graph-to-file divergence
|
|
55
|
-
- `yg drift-sync --node <path
|
|
60
|
+
- `yg drift [--scope all|node-path] [--drifted-only] [--limit <n>]` — Detect graph-to-file divergence
|
|
61
|
+
- `yg drift-sync --node <path> [--recursive]` — Record current file hash after resolving drift
|
|
62
|
+
- `yg drift-sync --all` — Sync all nodes with mappings in one command
|
|
56
63
|
|
|
57
64
|
**Session journal:**
|
|
58
65
|
|
|
@@ -63,10 +70,22 @@ yg build-context --node orders/order-service
|
|
|
63
70
|
**Setup:**
|
|
64
71
|
|
|
65
72
|
- `yg init --platform <name>` — Initialize `.yggdrasil/` structure (once per repository)
|
|
73
|
+
- `yg init --platform <name> --upgrade` — Refresh rules only (config and graph stay unchanged)
|
|
66
74
|
|
|
67
75
|
Node paths are relative to `.yggdrasil/model/`. File paths are relative to the
|
|
68
76
|
repository root.
|
|
69
77
|
|
|
78
|
+
## Upgrade
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npm install -g @chrisdudek/yg
|
|
82
|
+
cd your-project
|
|
83
|
+
yg init --platform <platform> --upgrade
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
`--upgrade` overwrites only the rules file. Your `.yggdrasil/` config and graph
|
|
87
|
+
are not modified.
|
|
88
|
+
|
|
70
89
|
## Supported Platforms
|
|
71
90
|
|
|
72
91
|
| Platform | Init | Rules location |
|
|
@@ -74,6 +93,13 @@ repository root.
|
|
|
74
93
|
| Cursor | `yg init --platform cursor` | `.cursor/rules/yggdrasil.mdc` |
|
|
75
94
|
| Claude Code | `yg init --platform claude-code` | `AGENTS.md` (Yggdrasil section) |
|
|
76
95
|
| Copilot | `yg init --platform copilot` | `.github/copilot-instructions.md` |
|
|
96
|
+
| Cline | `yg init --platform cline` | `.clinerules/yggdrasil.md` |
|
|
97
|
+
| RooCode | `yg init --platform roocode` | `.roo/rules/yggdrasil.md` |
|
|
98
|
+
| Codex | `yg init --platform codex` | `AGENTS.md` (Yggdrasil section) |
|
|
99
|
+
| Windsurf | `yg init --platform windsurf` | `.windsurf/rules/yggdrasil.md` |
|
|
100
|
+
| Aider | `yg init --platform aider` | `.yggdrasil/agent-rules.md` |
|
|
101
|
+
| Gemini CLI | `yg init --platform gemini` | `GEMINI.md` (import) |
|
|
102
|
+
| Amp | `yg init --platform amp` | `AGENTS.md` (import) |
|
|
77
103
|
| Generic | `yg init --platform generic` | `.yggdrasil/agent-rules.md` |
|
|
78
104
|
|
|
79
105
|
## License
|