@specsure/knowledge 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+Specsure knowledge pack — license (DRAFT, not reviewed by a lawyer)
+
+Copyright (c) 2026 Adam Reznik. All rights reserved.
+
+This package ("the Pack") is data, not software, and is not covered by the MIT license of dsgraph.
+
+You may use the Pack, free of charge, only together with dsgraph (the @dsgraph/* packages, the
+dsgraph CLI, MCP server and GitHub Action), in any project, commercial or not.
+
+You may not:
+- distribute the Pack, or any part or derivative of it, on its own or with software other than
+  dsgraph;
+- use the Pack, or output produced mainly to extract it, to build, train, tune or evaluate other
+  tools, datasets or models;
+- remove this notice.
+
+The Pack is provided "as is", without warranty of any kind. In no event shall the author be liable
+for any claim, damages or other liability arising from the Pack or its use.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @specsure/knowledge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The knowledge pack for dsgraph (`dsgraph/knowledge@1`): words design systems name things by, beyond
+the neutral vocabulary built into the engine. Private source; published to npm under its own
+license (LICENSE), separately from the MIT engine. See `strategy/Открытое и закрытое.md`.
+
+## What is in it
+
+- `vocabulary.states` — words in token names that name a state (`pressed` → `active`).
+- `vocabulary.rest` — words that name the resting state (`idle`).
+- Later: role synonyms, abbreviations (`btn` → `button`), migration maps, thresholds — derived from
+  the corpus, not written by hand.
+
+Only words that are not in `DEFAULT_VOCABULARY` (`packages/dsgraph-core/src/knowledge.ts`) belong
+here; the pack adds, never replaces.
+
+## How dsgraph finds it
+
+`loadKnowledge` in `@dsgraph/cli` (used by `dsgraph check` and `dsgraph-mcp`) reads
+`@specsure/knowledge/knowledge.json` when the package is installed next to dsgraph or in the
+project. `DSGRAPH_KNOWLEDGE=<file>` reads another pack, `DSGRAPH_KNOWLEDGE=off` none.
+
+Try it before publishing:
+
+```bash
+DSGRAPH_KNOWLEDGE=../internal/knowledge/knowledge.json npx dsgraph check ./tokens --code ./src
+```
+
+## Publishing
+
+1. Bump `version` in both `package.json` and `knowledge.json`.
+2. `npm publish` from this folder (Adam, 2FA).
+3. First publish only: add `"@specsure/knowledge": "^0.1.0"` to the dependencies of `@dsgraph/cli`
+   and `@dsgraph/mcp`, and bundle the pack into the Action and the site.

package/knowledge.json

@@ -0,0 +1,16 @@
+{
+  "schema": "dsgraph/knowledge@1",
+  "version": "0.1.0",
+  "vocabulary": {
+    "states": {
+      "hovered": "hover",
+      "focused": "focus",
+      "pressed": "active",
+      "press": "active",
+      "inactive": "disabled",
+      "checked": "selected",
+      "current": "selected"
+    },
+    "rest": ["idle", "normal", "enabled"]
+  }
+}

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@specsure/knowledge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Specsure's knowledge pack for dsgraph: how design systems name things",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Adam Reznik",
+  "homepage": "https://specsure.vercel.app",
+  "files": ["knowledge.json", "LICENSE"],
+  "exports": {
+    "./knowledge.json": "./knowledge.json",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": { "access": "public" }
+}