@skillcap/gdh 0.26.5 → 0.26.7
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/INSTALL-BUNDLE.json +1 -1
- package/RELEASE-SPAN-UPDATE-CONTRACTS.json +117 -0
- package/node_modules/@gdh/adapters/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/adapters/dist/index.js +1 -2
- package/node_modules/@gdh/adapters/dist/index.js.map +1 -1
- package/node_modules/@gdh/adapters/dist/skill-rendering.js +7 -7
- package/node_modules/@gdh/adapters/dist/skill-rendering.js.map +1 -1
- package/node_modules/@gdh/adapters/dist/templates/authoring-hook.js.tpl +191 -40
- package/node_modules/@gdh/adapters/package.json +8 -8
- package/node_modules/@gdh/authoring/dist/authoring-state-store.d.ts +3 -0
- package/node_modules/@gdh/authoring/dist/authoring-state-store.d.ts.map +1 -0
- package/node_modules/@gdh/authoring/dist/authoring-state-store.js +19 -0
- package/node_modules/@gdh/authoring/dist/authoring-state-store.js.map +1 -0
- package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.d.ts +15 -21
- package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.js +22 -37
- package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/diagnostics-broker.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/diagnostics-broker.js +121 -15
- package/node_modules/@gdh/authoring/dist/diagnostics-broker.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp-broker-snapshot.d.ts +28 -0
- package/node_modules/@gdh/authoring/dist/lsp-broker-snapshot.d.ts.map +1 -0
- package/node_modules/@gdh/authoring/dist/lsp-broker-snapshot.js +67 -0
- package/node_modules/@gdh/authoring/dist/lsp-broker-snapshot.js.map +1 -0
- package/node_modules/@gdh/authoring/dist/lsp-test-server.test-utils.d.ts +1 -0
- package/node_modules/@gdh/authoring/dist/lsp-test-server.test-utils.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp-test-server.test-utils.js +3 -0
- package/node_modules/@gdh/authoring/dist/lsp-test-server.test-utils.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp-warmup.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp-warmup.js +2 -1
- package/node_modules/@gdh/authoring/dist/lsp-warmup.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/lsp.js +11 -73
- package/node_modules/@gdh/authoring/dist/lsp.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/project.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/project.js +24 -8
- package/node_modules/@gdh/authoring/dist/project.js.map +1 -1
- package/node_modules/@gdh/authoring/dist/scene-resource.d.ts.map +1 -1
- package/node_modules/@gdh/authoring/dist/scene-resource.js +73 -29
- package/node_modules/@gdh/authoring/dist/scene-resource.js.map +1 -1
- package/node_modules/@gdh/authoring/package.json +2 -2
- package/node_modules/@gdh/cli/dist/index.js +5 -5
- package/node_modules/@gdh/cli/dist/index.js.map +1 -1
- package/node_modules/@gdh/cli/dist/migrate.d.ts.map +1 -1
- package/node_modules/@gdh/cli/dist/migrate.js +2 -1
- package/node_modules/@gdh/cli/dist/migrate.js.map +1 -1
- package/node_modules/@gdh/cli/package.json +10 -10
- package/node_modules/@gdh/core/dist/index.d.ts +21 -21
- package/node_modules/@gdh/core/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/core/dist/index.js +7 -7
- package/node_modules/@gdh/core/dist/index.js.map +1 -1
- package/node_modules/@gdh/core/package.json +1 -1
- package/node_modules/@gdh/docs/dist/agent-contract.d.ts.map +1 -1
- package/node_modules/@gdh/docs/dist/agent-contract.js +0 -1
- package/node_modules/@gdh/docs/dist/agent-contract.js.map +1 -1
- package/node_modules/@gdh/docs/dist/guidance.d.ts.map +1 -1
- package/node_modules/@gdh/docs/dist/guidance.js +8 -100
- package/node_modules/@gdh/docs/dist/guidance.js.map +1 -1
- package/node_modules/@gdh/docs/dist/templates/guidance/authoring-and-validation.md.tpl +15 -103
- package/node_modules/@gdh/docs/dist/templates/guidance/project-surfaces.md.tpl +6 -11
- package/node_modules/@gdh/docs/package.json +2 -2
- package/node_modules/@gdh/mcp/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/mcp/dist/index.js +37 -4
- package/node_modules/@gdh/mcp/dist/index.js.map +1 -1
- package/node_modules/@gdh/mcp/package.json +8 -8
- package/node_modules/@gdh/observability/package.json +2 -2
- package/node_modules/@gdh/runtime/package.json +2 -2
- package/node_modules/@gdh/scan/package.json +3 -3
- package/node_modules/@gdh/verify/package.json +7 -7
- package/package.json +11 -11
- package/node_modules/@gdh/docs/dist/templates/guidance/gdh-glossary.md.tpl +0 -34
- package/node_modules/@gdh/docs/dist/templates/guidance/persistence-semantics.md.tpl +0 -24
- package/node_modules/@gdh/docs/dist/templates/guidance/project-migration.md.tpl +0 -19
|
@@ -11,13 +11,13 @@
|
|
|
11
11
|
}
|
|
12
12
|
},
|
|
13
13
|
"dependencies": {
|
|
14
|
-
"@gdh/authoring": "0.26.
|
|
15
|
-
"@gdh/core": "0.26.
|
|
16
|
-
"@gdh/docs": "0.26.
|
|
17
|
-
"@gdh/observability": "0.26.
|
|
18
|
-
"@gdh/runtime": "0.26.
|
|
19
|
-
"@gdh/scan": "0.26.
|
|
14
|
+
"@gdh/authoring": "0.26.7",
|
|
15
|
+
"@gdh/core": "0.26.7",
|
|
16
|
+
"@gdh/docs": "0.26.7",
|
|
17
|
+
"@gdh/observability": "0.26.7",
|
|
18
|
+
"@gdh/runtime": "0.26.7",
|
|
19
|
+
"@gdh/scan": "0.26.7",
|
|
20
20
|
"yaml": "^2.8.3"
|
|
21
21
|
},
|
|
22
|
-
"version": "0.26.
|
|
22
|
+
"version": "0.26.7"
|
|
23
23
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@skillcap/gdh",
|
|
3
|
-
"version": "0.26.
|
|
3
|
+
"version": "0.26.7",
|
|
4
4
|
"description": "Godot-specific authoring and validation harness for agentic development.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -31,17 +31,17 @@
|
|
|
31
31
|
"releaseStage": "broader_internal_release"
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@gdh/cli": "0.26.
|
|
34
|
+
"@gdh/cli": "0.26.7",
|
|
35
35
|
"@clack/prompts": "^1.2.0",
|
|
36
|
-
"@gdh/adapters": "0.26.
|
|
37
|
-
"@gdh/authoring": "0.26.
|
|
38
|
-
"@gdh/core": "0.26.
|
|
39
|
-
"@gdh/docs": "0.26.
|
|
40
|
-
"@gdh/mcp": "0.26.
|
|
41
|
-
"@gdh/observability": "0.26.
|
|
42
|
-
"@gdh/runtime": "0.26.
|
|
43
|
-
"@gdh/scan": "0.26.
|
|
44
|
-
"@gdh/verify": "0.26.
|
|
36
|
+
"@gdh/adapters": "0.26.7",
|
|
37
|
+
"@gdh/authoring": "0.26.7",
|
|
38
|
+
"@gdh/core": "0.26.7",
|
|
39
|
+
"@gdh/docs": "0.26.7",
|
|
40
|
+
"@gdh/mcp": "0.26.7",
|
|
41
|
+
"@gdh/observability": "0.26.7",
|
|
42
|
+
"@gdh/runtime": "0.26.7",
|
|
43
|
+
"@gdh/scan": "0.26.7",
|
|
44
|
+
"@gdh/verify": "0.26.7",
|
|
45
45
|
"picocolors": "^1.1.1"
|
|
46
46
|
},
|
|
47
47
|
"bundledDependencies": [
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
# {{projectName}}: GDH Operational Terms
|
|
2
|
-
|
|
3
|
-
Use this unit when a GDH skill, command, or guidance file uses GDH-specific vocabulary. Do not repeat the words without understanding the operational meaning.
|
|
4
|
-
|
|
5
|
-
- `target`: the Godot project root GDH should inspect, prepare, validate, or manage.
|
|
6
|
-
- `authoring`: editing or validating Godot-facing files such as `.gd`, `.tscn`, `.tres`, and `project.godot`.
|
|
7
|
-
- `authoring check`: `gdh authoring check`, the command that collects validator diagnostics and blocking summaries.
|
|
8
|
-
- `diagnostics broker`: GDH's persistent diagnostics snapshot service backed by the managed LSP; exposes `current`, `refresh`, `status`, `doctor`, and `prune` operations under `gdh authoring diagnostics`.
|
|
9
|
-
- `diagnostics snapshot`: the last set of normalized diagnostics GDH collected from the managed LSP, scoped to files that were opened or refreshed; not whole-project coverage.
|
|
10
|
-
- `validation evidence`: concrete diagnostics from validators; capability availability or LSP lifecycle health alone is not validation evidence.
|
|
11
|
-
- `LSP lifecycle`: whether GDH can launch, reuse, inspect, restart, prune, or stop the editor-backed Godot LSP service for this target.
|
|
12
|
-
- `readiness`: GDH's structured status for whether the target is detected, onboarded, authorable, blocked, degraded, or unavailable.
|
|
13
|
-
- `capability`: an available GDH feature surface, such as scan, authoring readiness, authoring LSP lifecycle, or runtime bridge support.
|
|
14
|
-
- `inventory`: discovered Godot projects, addons, scenes, tests, and related filesystem evidence.
|
|
15
|
-
- `inventory cache`: `.gdh-state/inventory.json`, derived machine-local project discovery data used by onboarded targets.
|
|
16
|
-
- `.gdh/`: durable project truth owned by the repository, including GDH config, rules, run configurations, scenarios, project-owned bridge entries, and runtime knowledge.
|
|
17
|
-
- `.gdh-state/`: ignored machine-local operational state, such as inventory cache, readiness snapshots, local paths, hook state, and logs.
|
|
18
|
-
- `.godot/ generated state`: Godot's editor/import cache; useful for validation and import readiness, but not durable project truth.
|
|
19
|
-
- `cold worktree`: a checkout/worktree whose generated Godot editor/import state is missing, stale, or incomplete.
|
|
20
|
-
- `hydration`: copying reusable `.godot/` generated state from another local checkout to make this worktree ready faster.
|
|
21
|
-
- `source target`: a sibling checkout used as the source for `.godot/` hydration.
|
|
22
|
-
- `import refresh`: running Godot to rebuild or update generated import state for the target.
|
|
23
|
-
- `machine-local path`: a path valid only on this computer, such as the Godot editor binary path; keep it in `.gdh-state/`, not committed project config.
|
|
24
|
-
- `managed surface`: a GDH-owned or GDH-merge-managed file that must match the selected GDH version, such as guidance, rules, agent adapters, MCP config, or runtime bridge output.
|
|
25
|
-
- `terminal.state`: the structured lifecycle outcome from migration or update flows; use it instead of prose, stderr, or action count guesses.
|
|
26
|
-
- `manual review`: project-owned judgment GDH cannot safely automate; stop for the user after surfaced commands and validations.
|
|
27
|
-
- `validationCommands`: exact GDH-surfaced commands to run after apply or follow-up work.
|
|
28
|
-
- `runtime reachability knowledge`: scene-scoped route, waypoint, transition, dynamic-blocker, trust, and stale-status notes under `.gdh/runtime-knowledge/`.
|
|
29
|
-
- `player_reachable`: a bounded action that a normal player could do through ordinary game input.
|
|
30
|
-
- `internal_route`: bounded direct control used only when no practical player path exists.
|
|
31
|
-
- `waiter`: a bounded runtime polling primitive for property, node, or signal conditions.
|
|
32
|
-
|
|
33
|
-
If a shipped skill uses a GDH term not defined locally, load this glossary before acting. If the term is still ambiguous, ask for clarification rather than guessing.
|
|
34
|
-
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# {{projectName}}: Persistence Semantics
|
|
2
|
-
|
|
3
|
-
Use this unit when the task touches `gdh scan`, `gdh onboard`, `gdh status`, or any reasoning about whether a command warms `.gdh-state/` cache or not.
|
|
4
|
-
|
|
5
|
-
Anchor on the command → effect table:
|
|
6
|
-
|
|
7
|
-
| Command | Reads from disk | Writes to disk | Precondition | Session event |
|
|
8
|
-
|---------|-----------------|----------------|--------------|---------------|
|
|
9
|
-
| scan | `.gdh-state/inventory.json` (cache-first on onboarded targets) | `.gdh-state/inventory.json` (onboarded targets only) | Any filesystem path | `kind: "scan"` on onboarded branch only |
|
|
10
|
-
| onboard | `.gdh/project.yaml` (if exists, for migration check), `.gitignore` | `.gitignore` (GDH-managed `.gdh-state/` section only), `.gdh/project.yaml`, `.gdh-state/inventory.json`, skill files | No precondition | `kind: "onboard"` |
|
|
11
|
-
| status | `.gdh-state/inventory.json` (cache-first when onboarded) | None | Any filesystem path | None |
|
|
12
|
-
|
|
13
|
-
Key facts agents keep getting wrong:
|
|
14
|
-
|
|
15
|
-
- The inventory cache is `.gdh-state/inventory.json`: derived, machine-local project inventory used to avoid rescanning unchanged onboarded targets.
|
|
16
|
-
- `gdh scan` on a target with no ancestor `.gdh/project.yaml` writes nothing — it is stdout-only and `persisted` is `null`. It does not "warm the cache" because there is no cache to warm.
|
|
17
|
-
- `gdh scan` on an onboarded target writes `.gdh-state/inventory.json` atomically and emits `persisted.mode` of `create`, `unchanged`, or `overwrite`.
|
|
18
|
-
- `gdh status` never writes to disk. It reads the cached inventory when present and live-scans when it is missing, corrupt, or schema-mismatched (degraded path).
|
|
19
|
-
- `gdh onboard` may update `.gitignore`, but only for the GDH-managed `.gdh-state/` ignore section. It does not take ownership of `.godot/` ignore policy.
|
|
20
|
-
- `gdh onboard` writes durable project truth (`.gdh/project.yaml`), derived state (`.gdh-state/inventory.json`), and skill files. It is not a synonym for scan.
|
|
21
|
-
- Run `gdh scan` when you need fresh filesystem discovery: before first setup/onboard, after project structure changed, when the user asks what Godot projects/addons/scenes/tests were detected, or when cache freshness is explicitly in doubt. For normal readiness, migration, or validation questions, start with `gdh status` or `gdh authoring check` instead.
|
|
22
|
-
|
|
23
|
-
Do not infer behavior from command names. Read the table, run the command, and check the envelope.
|
|
24
|
-
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# {{projectName}}: Project Migration
|
|
2
|
-
|
|
3
|
-
Use this unit when `gdh status` or `gdh migrate` says the managed target needs migration, repair, or follow-up before normal implementation work.
|
|
4
|
-
|
|
5
|
-
Follow this order:
|
|
6
|
-
|
|
7
|
-
- run `gdh status` first and name the exact migration or degraded-compatibility reasons GDH reports
|
|
8
|
-
- run `gdh migrate` before proposing manual edits so GDH can preview the supported repair or migration actions
|
|
9
|
-
- only run `gdh migrate --apply` after explaining the planned changes and confirming the target path is correct
|
|
10
|
-
- after apply, read `terminal.state` in the stdout JSON instead of guessing from prose summaries
|
|
11
|
-
- if `terminal.state` is `healthy`, stop — no further migration action is required
|
|
12
|
-
- if `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands` before treating the target as healthy
|
|
13
|
-
- if `terminal.state` is `manual_review_required`, complete the surfaced `terminal.manualSteps`, then run the surfaced `terminal.validationCommands`; do not collapse review-gated work into an automatic repair
|
|
14
|
-
- if runtime bridge compatibility remains degraded, enable the `GDH Runtime Bridge` plugin in the Godot editor so the addon can register `GDHBridge` itself
|
|
15
|
-
- read `brokerTransition` when present: old pre-broker active sessions are unrecoverable, new broker-backed sessions are reconnectable, `.gdh-state/` remains untracked runtime state, and host-side broker migration alone does not require `gdh bridge repair`
|
|
16
|
-
- if `terminal.state` is `blocked`, stop and review the surfaced reasons before making repo-local changes
|
|
17
|
-
|
|
18
|
-
Do not hand-edit `project.godot` to register `GDHBridge`, and do not treat a migrated target as healthy until GDH's structured surfaces agree. GDH does not yet back up or reapply customized managed-surface patches automatically.
|
|
19
|
-
|