@cloudcare/guance-front-tools 1.0.19 → 1.0.20
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/package.json
CHANGED
|
@@ -9,7 +9,7 @@ description: Convert Grafana dashboard JSON into Guance dashboard JSON with a fu
|
|
|
9
9
|
|
|
10
10
|
Use this skill when working on Grafana dashboard to Guance dashboard conversion as a standalone package.
|
|
11
11
|
|
|
12
|
-
This skill is self-contained. Use only the files
|
|
12
|
+
This skill is self-contained. Use only the files in this skill directory unless the user explicitly asks to compare with older repository code or migrate logic elsewhere.
|
|
13
13
|
|
|
14
14
|
This is not just a script-running skill. Use the LLM before and after conversion to analyze risk, explain missing mappings, compare Grafana and Guance structures, infer likely units when Grafana leaves them implicit, audit PromQL dialect differences, and propose or implement converter fixes.
|
|
15
15
|
|
|
@@ -26,7 +26,7 @@ The skill directory now includes its own:
|
|
|
26
26
|
|
|
27
27
|
## Core Workflow
|
|
28
28
|
|
|
29
|
-
1. Change into
|
|
29
|
+
1. Change into the skill root directory.
|
|
30
30
|
2. Install standalone dependencies with `npm install` when needed.
|
|
31
31
|
3. Read the input Grafana dashboard and perform a preflight analysis before running the converter.
|
|
32
32
|
4. Identify the output path and choose conversion flags.
|
|
@@ -103,7 +103,7 @@ Choose the mode that matches the user request.
|
|
|
103
103
|
|
|
104
104
|
## Commands
|
|
105
105
|
|
|
106
|
-
Use these commands from
|
|
106
|
+
Use these commands from the skill root directory.
|
|
107
107
|
|
|
108
108
|
```bash
|
|
109
109
|
npm install
|
|
@@ -369,27 +369,27 @@ User-facing summary
|
|
|
369
369
|
|
|
370
370
|
The skill script directory contains two files:
|
|
371
371
|
|
|
372
|
-
- `
|
|
372
|
+
- `scripts/convert-grafana-dashboard.mjs`
|
|
373
373
|
- executable wrapper
|
|
374
374
|
- parses CLI args
|
|
375
375
|
- validates output against local schemas
|
|
376
376
|
- imports `./convert-grafana-dashboard-core.js`
|
|
377
|
-
- `
|
|
377
|
+
- `scripts/convert-grafana-dashboard-core.js`
|
|
378
378
|
- pure conversion logic
|
|
379
379
|
- no file-system or schema-validation responsibilities
|
|
380
380
|
|
|
381
381
|
The skill directory also includes:
|
|
382
382
|
|
|
383
|
-
- `
|
|
383
|
+
- `scripts/validate-file.mjs`
|
|
384
384
|
- standalone validation entrypoint
|
|
385
385
|
- always validates against the skill-local `schemas/`
|
|
386
|
-
- `
|
|
386
|
+
- `schemas/`
|
|
387
387
|
- local schema copy used for standalone validation
|
|
388
|
-
- `
|
|
388
|
+
- `fixtures/`
|
|
389
389
|
- bundled sample Grafana dashboard for standalone smoke tests
|
|
390
|
-
- `
|
|
390
|
+
- `test/`
|
|
391
391
|
- bundled standalone regression tests
|
|
392
|
-
- `
|
|
392
|
+
- `package.json`
|
|
393
393
|
- standalone runtime dependencies and convenience scripts
|
|
394
394
|
|
|
395
395
|
Treat these two files as the source of truth for this skill.
|
|
@@ -399,9 +399,9 @@ Treat these two files as the source of truth for this skill.
|
|
|
399
399
|
This skill must remain usable on its own. Do not rely on repository sync/build steps as the default workflow.
|
|
400
400
|
|
|
401
401
|
- For conversion behavior changes:
|
|
402
|
-
- edit `
|
|
402
|
+
- edit `scripts/convert-grafana-dashboard-core.js`
|
|
403
403
|
- For CLI / validation behavior changes:
|
|
404
|
-
- edit `
|
|
404
|
+
- edit `scripts/convert-grafana-dashboard.mjs`
|
|
405
405
|
- After editing:
|
|
406
406
|
- re-run the standalone converter command from this skill
|
|
407
407
|
- re-run validation against the target output file
|
|
@@ -468,8 +468,8 @@ When conversion fails or output is incomplete, read [references/converter-notes.
|
|
|
468
468
|
## Standalone Use Rules
|
|
469
469
|
|
|
470
470
|
- Default to the standalone converter shipped in this skill.
|
|
471
|
-
- Keep all conversion logic needed by the skill inside `
|
|
472
|
-
- Keep validation schemas needed by the skill inside `
|
|
471
|
+
- Keep all conversion logic needed by the skill inside `scripts/`.
|
|
472
|
+
- Keep validation schemas needed by the skill inside `schemas/`.
|
|
473
473
|
- Keep smoke-test inputs and regression tests inside this skill directory.
|
|
474
474
|
- Do not make the skill depend on `lib/scripts/*`, sync steps, root-level schemas, repository fixtures, or build steps for normal use.
|
|
475
475
|
- If behavior is duplicated elsewhere in the repository, treat that as optional follow-up work, not part of the default skill workflow.
|
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
## Skill Files
|
|
4
4
|
|
|
5
|
-
- `
|
|
6
|
-
- `
|
|
7
|
-
- `
|
|
8
|
-
- `
|
|
9
|
-
- `
|
|
10
|
-
- `
|
|
11
|
-
- `
|
|
5
|
+
- `package.json`: standalone dependencies and convenience scripts
|
|
6
|
+
- `scripts/convert-grafana-dashboard.mjs`: standalone converter shipped by this skill
|
|
7
|
+
- `scripts/convert-grafana-dashboard-core.js`: standalone conversion core used by this skill
|
|
8
|
+
- `scripts/validate-file.mjs`: standalone validator for generated output
|
|
9
|
+
- `schemas/dashboard-schema.json`: standalone Guance dashboard schema entrypoint
|
|
10
|
+
- `fixtures/grafana-dashboard.json`: bundled standalone fixture dashboard
|
|
11
|
+
- `test/convert.test.mjs`: bundled end-to-end regression test
|
|
12
12
|
|
|
13
13
|
## Current Mapping Notes
|
|
14
14
|
|
|
@@ -129,7 +129,7 @@ npm run validate:file -- ./output/guance-dashboard.json
|
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
7. Run `npm test` to verify the bundled standalone fixture still converts and validates cleanly.
|
|
132
|
-
8. If the behavior itself is wrong, patch the standalone files under `
|
|
132
|
+
8. If the behavior itself is wrong, patch the standalone files under `scripts/` directly instead of relying on repository sync/build flows.
|
|
133
133
|
|
|
134
134
|
## Audit Prompts
|
|
135
135
|
|