@skenora/tooling 0.1.2

package/resources/examples/invalid-scene.json

@@ -0,0 +1,9 @@
+{
+  "schema": "skenora.scene",
+  "version": 1,
+  "id": "",
+  "name": "Invalid example",
+  "assets": [],
+  "entities": {},
+  "rootEntityIds": ["missing-entity"]
+}

package/resources/examples/valid-scene.json

@@ -0,0 +1,69 @@
+{
+  "schema": "skenora.scene",
+  "version": 1,
+  "id": "tooling-example",
+  "name": "Tooling example",
+  "assets": {},
+  "entities": {},
+  "rootEntityIds": [],
+  "materials": {},
+  "materialBindings": {},
+  "textureAnimations": {},
+  "camera": {
+    "mode": "orbit",
+    "position": { "x": 0, "y": 2, "z": -6 },
+    "target": { "x": 0, "y": 0, "z": 0 },
+    "minZ": 0.01,
+    "maxZ": 10000,
+    "fov": 0.8,
+    "speed": 1
+  },
+  "cameraPaths": {},
+  "environment": {
+    "enabled": true,
+    "intensity": 1,
+    "rotationY": 0,
+    "background": { "mode": "color", "color": "#202124", "blur": 0 }
+  },
+  "ground": {
+    "enabled": false,
+    "mode": "solid",
+    "size": 20,
+    "fitToScene": false,
+    "padding": 1.5,
+    "color": "#808080",
+    "opacity": 1,
+    "shadowOpacity": 0.55
+  },
+  "fog": {
+    "enabled": false,
+    "mode": "linear",
+    "color": "#ffffff",
+    "density": 0.01,
+    "start": 10,
+    "end": 100
+  },
+  "weather": {
+    "enabled": false,
+    "type": "rain",
+    "intensity": 0.5,
+    "wind": { "x": 0, "y": 0, "z": 0 },
+    "particleSize": 0.1
+  },
+  "lights": [],
+  "postProcess": {
+    "enabled": false,
+    "samples": 1,
+    "bloom": false,
+    "glow": false,
+    "sharpen": false,
+    "grain": false,
+    "chromaticAberration": false,
+    "depthOfField": false,
+    "vignetteEnabled": false,
+    "ssao": { "enabled": false }
+  },
+  "flows": {},
+  "variables": {},
+  "extensions": {}
+}

package/resources/llms-full.txt

@@ -0,0 +1,52 @@
+# Skenora agent reference
+
+## Ownership
+
+`SceneDocumentData` is persistent authored truth. EditorSession owns commands,
+revision, undo, and selection. RuntimeSession owns Babylon Engine, Scene,
+materials, GPU resources, render loop, and disposal. ResourceResolver is the
+only path from logical asset references to bytes. ScenePlan compiles declarative
+Blueprints and Patches without executing arbitrary code.
+
+## Safe workflow
+
+1. Discover schemas/capabilities from installed Skenora resources.
+2. Produce a native SceneDocument, SceneBlueprint, or ScenePatch version 1.
+3. Run pure `checkSceneInput()` and repair diagnostic codes.
+4. Supply explicit resource bindings for Blueprint compilation.
+5. Let the host commit through Editor/ScenePlan APIs.
+6. Let Runtime project the accepted document.
+7. Use `getBackendSnapshot()` for device facts and `probe()` for real health.
+
+Never serialize Babylon objects or infer authored state from GPU resources.
+Never put URLs, credentials, callbacks, JavaScript, GLSL, or WGSL in scene data.
+MaterialProgram and ProceduralGeometryProgram are bounded declarative ceilings.
+
+## Diagnostics
+
+Every shared diagnostic is JSON-safe and includes version, code, severity,
+stage, and message. Optional path and entity/asset/material/animation/binding/
+capability identities locate the issue. `repair` is public guidance. Error
+messages are explanatory but not stable identifiers.
+
+## Runtime evidence
+
+Backend snapshots report observed WebGL/WebGPU facts and host policy separately.
+They do not prove rendering. `healthy` is permitted only when an active browser
+Runtime rendered and successfully read pixels. Plain Node doctor runs are
+`unverified`, not healthy.
+
+## Tooling and MCP
+
+The `skenora` CLI provides check, doctor, docs, examples, resource verification,
+and a read-only stdio or loopback-HTTP MCP server. The default MCP exposes
+resource discovery/read/search, schema lookup, pure scene check, and doctor
+report generation. It exposes no filesystem writes, Editor commands, arbitrary
+URL fetch, credentials, or Runtime objects.
+
+A protected host may inject ScenePlan tools for an active Editor. Every such
+call includes an opaque `editorHandle`; writes also require the revision token
+returned by inspect and an idempotency key. Inspect returns a revision-bound
+paginated safe outline. The host owns authentication, content-bound approval,
+handle resolution, resource policy, audit, and persistence. Apply uses strict
+projection and returns document and projection outcomes separately.

package/resources/llms.txt

@@ -0,0 +1,19 @@
+# Skenora
+
+Skenora is a local-first 3D scene foundation. Authored truth is a serializable
+SceneDocument; Babylon.js objects are disposable runtime projections.
+
+Use SceneBlueprint and ScenePatch for declarative input. Run `skenora check`
+before execution. Diagnostics are versioned JSON objects; branch on code.
+
+Use only bounded MaterialProgram and ProceduralGeometryProgram contracts. Never
+emit raw shaders, arbitrary URLs, JavaScript, credentials, or runtime handles.
+
+Static validity is not GPU health. A healthy Runtime report requires a real
+browser render and pixel readback from `renderer.probe()`.
+
+Offline resources: `skenora docs list`, `skenora examples list`, or the
+read-only `skenora mcp` stdio/HTTP server. Protected host composition may add
+handle-scoped ScenePlan inspect, resource search, validation, strict apply, and
+operation-wait tools. Inspect pages model-safe scene IDs and relationships;
+never invent an editor handle, revision token, or write approval.

package/resources/manifest.json

@@ -0,0 +1,97 @@
+{
+  "schema": "skenora.tooling-manifest",
+  "version": 1,
+  "packageVersion": "0.1.2",
+  "resources": [
+    {
+      "id": "docs.overview",
+      "version": "1",
+      "kind": "documentation",
+      "title": "Skenora offline tooling",
+      "path": "docs/overview.md",
+      "mediaType": "text/markdown",
+      "sha256": "6a9e659a453670e79697da0a0074efcc7ef00c4faaf2a5f94277a156fcd002ab"
+    },
+    {
+      "id": "docs.diagnostics",
+      "version": "1",
+      "kind": "documentation",
+      "title": "Diagnostics and repair",
+      "path": "docs/diagnostics.md",
+      "mediaType": "text/markdown",
+      "sha256": "93afbe844fb38dd6e5204eaefa476f3ab04f230ef2439c74f9802f82852d4a92"
+    },
+    {
+      "id": "docs.runtime-probe",
+      "version": "1",
+      "kind": "documentation",
+      "title": "Runtime backend snapshot and probe",
+      "path": "docs/runtime-probe.md",
+      "mediaType": "text/markdown",
+      "sha256": "ca6e52e7dc19bca849107dcfa98cb7f08ad70e4824607e2c2005479e2b144c0d"
+    },
+    {
+      "id": "examples.valid-scene",
+      "version": "1",
+      "kind": "example",
+      "title": "Valid minimal native scene",
+      "path": "examples/valid-scene.json",
+      "mediaType": "application/json",
+      "sha256": "df44ea351e95badcbd388547f6a6d8152332f5a6b0d27c577f16242c7a5c58a0"
+    },
+    {
+      "id": "examples.invalid-scene",
+      "version": "1",
+      "kind": "example",
+      "title": "Invalid scene with repairable diagnostics",
+      "path": "examples/invalid-scene.json",
+      "mediaType": "application/json",
+      "sha256": "7f53cbd52b9aba890c84fecc4e52ed5e8a42ad86edc28eb1ec65c0e1c572e5af"
+    },
+    {
+      "id": "examples.gallery",
+      "version": "1",
+      "kind": "example",
+      "title": "Skenora immutable example gallery",
+      "path": "examples/gallery.json",
+      "mediaType": "application/json",
+      "sha256": "4a7ea71fa8097cf4ab569fde4aac544608362125ad352a04d8961ed30cae7a9d"
+    },
+    {
+      "id": "schemas.scene-check-report",
+      "version": "1",
+      "kind": "schema",
+      "title": "Scene check report JSON Schema",
+      "path": "schemas/scene-check-report.schema.json",
+      "mediaType": "application/schema+json",
+      "sha256": "16138ec754757e162fee6bf03438e07f00fd7e1bb9c1a2fcf85c13b149718218"
+    },
+    {
+      "id": "schemas.example-manifest",
+      "version": "1",
+      "kind": "schema",
+      "title": "Skenora example manifest JSON Schema",
+      "path": "schemas/example-manifest.schema.json",
+      "mediaType": "application/schema+json",
+      "sha256": "644a98a2a97aeffa69d58fa5745195919569b2511bdce476042d578e7b02e85e"
+    },
+    {
+      "id": "llms.summary",
+      "version": "1",
+      "kind": "llms",
+      "title": "Skenora concise agent reference",
+      "path": "llms.txt",
+      "mediaType": "text/plain",
+      "sha256": "2411b26761b665453dc00995d8f101edffe9d73313551076fbd71176bc2afe84"
+    },
+    {
+      "id": "llms.full",
+      "version": "1",
+      "kind": "llms",
+      "title": "Skenora complete agent reference",
+      "path": "llms-full.txt",
+      "mediaType": "text/plain",
+      "sha256": "e43b62d9bd877128146810c4d438dfe32949637e77eac590fe021a5272fa123c"
+    }
+  ]
+}

package/resources/schemas/example-manifest.schema.json

@@ -0,0 +1,454 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:skenora:example-manifest:1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "schemaVersion",
+    "id",
+    "title",
+    "description",
+    "tags",
+    "mode",
+    "tier",
+    "requiredCapabilities",
+    "optionalCapabilities",
+    "assets",
+    "controls",
+    "evidence",
+    "files",
+    "license",
+    "aggregateSha256"
+  ],
+  "properties": {
+    "schema": {
+      "const": "skenora.example-manifest"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tags": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+      }
+    },
+    "mode": {
+      "enum": [
+        "blueprint",
+        "recipe",
+        "renderer-lab"
+      ]
+    },
+    "tier": {
+      "enum": [
+        "foundation",
+        "bounded-effects",
+        "materials",
+        "render-graph",
+        "compute",
+        "advanced-simulation"
+      ]
+    },
+    "requiredCapabilities": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "version",
+          "reason"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9.-]+$"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "optionalCapabilities": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "version",
+          "reason"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9.-]+$"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "assets": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/asset"
+      }
+    },
+    "controls": {
+      "$ref": "#/$defs/fieldRule"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/evidence"
+      }
+    },
+    "fallback": {
+      "$ref": "#/$defs/fallback"
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/file"
+      }
+    },
+    "license": {
+      "$ref": "#/$defs/license"
+    },
+    "aggregateSha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    }
+  },
+  "$defs": {
+    "asset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "kind",
+        "required",
+        "provenance",
+        "description"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "kind": {
+          "enum": [
+            "texture",
+            "model",
+            "environment",
+            "data"
+          ]
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "provenance": {
+          "enum": [
+            "generated",
+            "repository",
+            "host-supplied"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "integrity": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "required",
+        "status",
+        "note"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "parse",
+            "compile",
+            "capability",
+            "preparation",
+            "runtime",
+            "pixels",
+            "visual",
+            "performance",
+            "package-consumption",
+            "cross-device"
+          ]
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "status": {
+          "enum": [
+            "unverified",
+            "passed",
+            "failed",
+            "not-applicable"
+          ]
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        },
+        "report": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "fallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "strategy",
+        "description"
+      ],
+      "properties": {
+        "strategy": {
+          "enum": [
+            "degrade",
+            "substitute-example",
+            "unsupported"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exampleId": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        }
+      }
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "role",
+        "mediaType",
+        "bytes",
+        "sha256"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\).+$"
+        },
+        "role": {
+          "enum": [
+            "readme",
+            "blueprint",
+            "source",
+            "fixture",
+            "evidence"
+          ]
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "license": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "spdx",
+        "attribution"
+      ],
+      "properties": {
+        "spdx": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attribution": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "fieldRule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "description"
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "required": [
+            "oneOf"
+          ]
+        }
+      ],
+      "properties": {
+        "type": {
+          "enum": [
+            "object",
+            "array",
+            "string",
+            "number",
+            "integer",
+            "boolean"
+          ]
+        },
+        "oneOf": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/fieldRule"
+          }
+        },
+        "nullable": {
+          "type": "boolean"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "type": [
+              "string",
+              "number",
+              "boolean"
+            ]
+          }
+        },
+        "minimum": {
+          "type": "number"
+        },
+        "exclusiveMinimum": {
+          "type": "number"
+        },
+        "maximum": {
+          "type": "number"
+        },
+        "minLength": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "minItems": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maxItems": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "properties": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/fieldRule"
+          }
+        },
+        "required": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/$defs/fieldRule"
+            }
+          ]
+        },
+        "items": {
+          "$ref": "#/$defs/fieldRule"
+        },
+        "default": {},
+        "unit": {
+          "type": "string",
+          "minLength": 1
+        },
+        "update": {
+          "enum": [
+            "parameter",
+            "rebuild"
+          ]
+        },
+        "reference": {
+          "enum": [
+            "asset",
+            "entity",
+            "material"
+          ]
+        }
+      }
+    }
+  }
+}