stylegallery 0.1.2 → 0.1.4

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.
Files changed (42) hide show
  1. package/AGENTS.md +8 -1
  2. package/DOMAINS.md +3 -1
  3. package/GOVERNANCE.md +3 -1
  4. package/README.md +12 -7
  5. package/consumer-reference/agent-native/README.md +12 -1
  6. package/consumer-reference/agent-native/v2/admission-policy.json +106 -1
  7. package/consumer-reference/agent-native/v2/material-registry.json +1 -1
  8. package/consumer-reference/agent-native/v2/schema/admission-policy.schema.json +3 -3
  9. package/consumer-reference/agent-native/v2/schema/material-record.schema.json +1 -1
  10. package/design-engineering/consumer-migration-readiness.md +124 -0
  11. package/design-engineering/interface-craft.md +107 -0
  12. package/design-terminology/concept-families.md +78 -0
  13. package/design-terminology/conflict-cases.md +120 -0
  14. package/design-terminology/index.md +65 -0
  15. package/design-terminology/relation-types.md +103 -0
  16. package/design-terminology/source-kinds.md +77 -0
  17. package/design-terminology/source-vocabularies.md +79 -0
  18. package/game-ui/classification.md +82 -0
  19. package/game-ui/reference-record.md +62 -0
  20. package/game-ui/screen-hierarchy.md +107 -0
  21. package/game-ui/unity/architecture.md +166 -0
  22. package/game-ui/unity/cli-loop.md +84 -0
  23. package/game-ui/unity/org-wiki.md +146 -0
  24. package/game-ui/unity/repository-map.md +102 -0
  25. package/game-ui/unity/ui-systems.md +85 -0
  26. package/guides/vocabulary.md +1 -1
  27. package/index.md +2 -1
  28. package/log.md +5 -0
  29. package/motion/practice-reference.md +145 -0
  30. package/motion/review-workflow.md +86 -0
  31. package/motion/vocabulary.md +82 -0
  32. package/package.json +22 -1
  33. package/platform-guides/apple-interaction.md +89 -0
  34. package/quality/claim-records/design-terminology-domain-scope.md +57 -0
  35. package/quality/evidence/executable-evidence.md +1 -1
  36. package/quality/index.md +2 -2
  37. package/scripts/agent-native/v2/material-admission.mjs +1 -1
  38. package/scripts/agent-native/v2/material-cli-adapter.mjs +9 -4
  39. package/scripts/agent-native/v2/material-identity.mjs +2 -2
  40. package/scripts/agent-native/v2/material-mcp-adapter.mjs +3 -3
  41. package/scripts/agent-native/v2/material-operation-registry.mjs +2 -1
  42. package/scripts/agent-native/v2/material-queries.mjs +70 -16
package/AGENTS.md CHANGED
@@ -6,7 +6,7 @@ description: Rules coding agents must follow when editing this governed multi-do
6
6
 
7
7
  # Agent Instructions
8
8
 
9
- This repository is StyleGallery: a governed gallery with Layout, Motion, Design Engineering, Game UI, and Platform Guides domains. Read [StyleGallery Domains](DOMAINS.md) before adding a domain, changing a domain boundary, or adapting an external source.
9
+ This repository is StyleGallery: a governed gallery with Layout, Motion, Design Engineering, Game UI, Platform Guides, and Design Terminology domains. Read [StyleGallery Domains](DOMAINS.md) before adding a domain, changing a domain boundary, or adapting an external source.
10
10
 
11
11
  Before editing generated artifacts, validators, lifecycle state, or ownership policy, read [Governance, Lifecycle, And Docs-As-Code](GOVERNANCE.md).
12
12
 
@@ -18,6 +18,7 @@ Before editing generated artifacts, validators, lifecycle state, or ownership po
18
18
  - Treat `consumer-reference/` as shared non-domain schema, provenance, routing, and evidence infrastructure; it owns no profile values, visual defaults, component implementation, or product CSS.
19
19
  - Keep dependency direction consumer/profile -> Layout. Do not import consumer-reference records, profile data, tokens, or decorative values into `layout/**`, `patterns/**`, `scripts/pattern-data.mjs`, or `CATALOG.md`.
20
20
  - Include the consumer-reference handoff field in implementation handoffs. For this repository-wide agent surface use `consumer_reference: consumer-reference/agent-native/registry.json`; otherwise use one normalized repository-relative JSON record or `not_applicable` with a sentence reason.
21
+ - When an implementation handoff relies on design-terminology records, declare the term identifiers and relation types used and whether the named sources were re-checked in the session; unverified reliance must be marked as such.
21
22
  - Keep material v2, v1 trust/conformance, CLI/MCP transport, and A2A/AG-UI extension planes separate. Material admission never imports profiles, source code, fixtures, schemas, tests, `.omo`, or visual defaults.
22
23
  - Validate canonical evidence v2 against its recorded immutable Git revision. Use current-authoring source checks only when creating or finalizing new capture evidence; do not recapture merely because later repository changes differ.
23
24
  - Treat `consumer-reference/policies/lifecycle-dispositions.json` as the lifecycle index. Preserve named owners, caller status `unknown`, deadlines, extension dispositions, and immutable archive bindings until their machine gate authorizes a transition.
@@ -33,6 +34,12 @@ Before editing generated artifacts, validators, lifecycle state, or ownership po
33
34
  - Make scroll responsibility obvious in both class names and CSS.
34
35
  - Keep decorative styling out of reusable pattern CSS.
35
36
 
37
+ ## Agent Retrieval Route
38
+
39
+ - When repository filesystem access is available, traverse the local Markdown corpus first: start at this file and `README.md`, follow the relevant task route or domain index, and read the selected source files directly.
40
+ - When the relevant path is not yet clear, use `sg-material search --query "<narrow query>" --paths-only --limit <N>` to obtain a small deterministic set of repository-relative candidate paths, then continue by reading those files locally.
41
+ - Use `sg-material context` as a fallback when repository files cannot be read directly or when a bounded, provenance-linked context package must be transferred to another process. Do not make context packaging the default local retrieval path.
42
+
36
43
  The remaining pattern, CSS, naming, token, checklist, and verification rules apply to the Layout domain. Non-Layout domain documents may discuss product-layer behavior, but they do not authorize decorative or motion properties in reusable Layout pattern CSS.
37
44
 
38
45
  ## Pattern Boundary Gate
package/DOMAINS.md CHANGED
@@ -19,6 +19,7 @@ This manifest is the source of truth for top-level StyleGallery domains. A domai
19
19
  | Design Engineering | [Design Engineering](design-engineering/index.md) | `experimental` | Product-layer craft questions and evidence-bearing decisions. | A second shared principle system or taste as proof. | Design Engineering domain owner |
20
20
  | Game UI | [Game UI](game-ui/index.md) | `experimental` | Game-interface classification, hierarchy, reference records, and implementation guides nested by engine. | Reusable Layout CSS or claims that one engine structure is universal. | Game UI domain owner |
21
21
  | Platform Guides | [Platform Guides](platform-guides/index.md) | `experimental` | Comparative references for a named platform and version context. | Affiliation, brand imitation, or authority over web standards. | Platform Guides domain owner |
22
+ | Design Terminology | [Design Terminology](design-terminology/index.md) | `experimental` | Source-kind classification, concept-family classification, typed term relations, and cross-system conflict cases for named vocabulary sources. | StyleGallery's own controlled vocabulary, motion terminology, visual token values, universal naming prescriptions, or authority over external vocabularies. | Design Terminology domain owner |
22
23
 
23
24
  ## Page Manifest
24
25
 
@@ -29,10 +30,11 @@ This manifest is the source of truth for top-level StyleGallery domains. A domai
29
30
  | Design Engineering | `design-engineering/index.md` | `design-engineering/interface-craft.md`, `design-engineering/consumer-migration-readiness.md`, `design-engineering/reference-profiles/index.md`, `design-engineering/reference-profiles/governed-local/index.md`, `design-engineering/reference-profiles/external-adaptation/index.md` |
30
31
  | Game UI | `game-ui/index.md` | `game-ui/classification.md`, `game-ui/screen-hierarchy.md`, `game-ui/reference-record.md`, `game-ui/unity/architecture.md`, `game-ui/unity/ui-systems.md`, `game-ui/unity/cli-loop.md`, `game-ui/unity/repository-map.md`, `game-ui/unity/org-wiki.md` |
31
32
  | Platform Guides | `platform-guides/index.md` | `platform-guides/apple-interaction.md` |
33
+ | Design Terminology | `design-terminology/index.md` | `design-terminology/source-kinds.md`, `design-terminology/source-vocabularies.md`, `design-terminology/concept-families.md`, `design-terminology/relation-types.md`, `design-terminology/conflict-cases.md` |
32
34
 
33
35
  ## Shared Non-Domain Infrastructure
34
36
 
35
- [Consumer Reference](consumer-reference/index.md) is shared schema, provenance, routing, evidence, lifecycle, and machine-retrieval infrastructure outside the five-domain contract. Its source-bound material v2 index classifies admitted pages by these five domains but does not own their prose. It owns no profile implementation, visual values, or product CSS and cannot add a sixth domain row. Consumer or profile records may depend on Layout; Layout and its generated corpus cannot import consumer-reference, profile, material-registry, or transport records.
37
+ [Consumer Reference](consumer-reference/index.md) is shared schema, provenance, routing, evidence, lifecycle, and machine-retrieval infrastructure outside the six-domain contract. Its source-bound material v2 index classifies admitted pages by these six domains but does not own their prose. It owns no profile implementation, visual values, or product CSS and cannot add a seventh domain row. Consumer or profile records may depend on Layout; Layout and its generated corpus cannot import consumer-reference, profile, material-registry, or transport records.
36
38
 
37
39
  ## External Adaptation Contract
38
40
 
package/GOVERNANCE.md CHANGED
@@ -42,6 +42,7 @@ Use this file before editing repository documentation. It names which file is au
42
42
  | Design Engineering domain guidance | `design-engineering/*.md` | Manual | None | `experimental` | Upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Design Engineering domain owner |
43
43
  | Game UI domain guidance | `game-ui/**/*.md` | Manual | None | `experimental` | Classification, hierarchy, engine implementation, evidence boundary, or route changes. | `scripts/validate-domains.mjs` | Game UI domain owner |
44
44
  | Platform Guides domain guidance | `platform-guides/*.md` | Manual | None | `experimental` | Platform version, upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Platform Guides domain owner |
45
+ | Design Terminology domain guidance | `design-terminology/*.md` | Manual | None | `experimental` | Source-kind, source-vocabulary, concept-family, relation-model, or conflict-case changes. | `scripts/validate-domains.mjs`, `scripts/validate-design-terminology.mjs` | Design Terminology domain owner |
45
46
  | Pattern data and examples | `scripts/pattern-data.mjs` | Manual data source | `patterns/**/*.md`, `patterns/**/index.md`, `patterns/index.md`, `CATALOG.md` | `generated` output from `stable` source | Source-lineage URL changes, generated drift, category changes, or pattern count changes. | `scripts/validate-patterns.mjs`, `scripts/validate-catalog.mjs`, `scripts/validate-governance.mjs` | Pattern-data owner |
46
47
  | Pattern generator | `scripts/generate-patterns.mjs` | Manual code source | `patterns/**/*.md`, `patterns/**/index.md`, `patterns/index.md`, `CATALOG.md` | `stable` generator, `generated` output | Generated structure changes, generated-warning changes, or generated metadata changes. | `node -c scripts/generate-patterns.mjs`, generated drift check, `scripts/validate-governance.mjs` | Pattern-data owner |
47
48
  | Validation scripts | `scripts/validate-*.mjs`, `scripts/test-validate-*.mjs` | Manual code source | CI validation output | `stable` | Validator scope changes, fixture changes, or CI parity changes. | `node -c`, matching fixture tests, `.github/workflows/validate.yml` | Validation owner |
@@ -98,7 +99,7 @@ Use these states in reviews and governance notes. Do not invent new lifecycle la
98
99
  Default lifecycle:
99
100
 
100
101
  - Root docs, guides, recipes, quality docs, validators, and CI are `stable` unless a page explicitly says otherwise.
101
- - `DOMAINS.md`, the scope decision, and `layout/index.md` are `stable`; domain leaves under `motion/`, `design-engineering/`, `game-ui/`, and `platform-guides/` begin `experimental`.
102
+ - `DOMAINS.md`, the scope decision, and `layout/index.md` are `stable`; domain leaves under `motion/`, `design-engineering/`, `game-ui/`, `platform-guides/`, and `design-terminology/` begin `experimental`.
102
103
  - Generated pattern docs, generated pattern indexes, and `CATALOG.md` are `generated`.
103
104
  - Draft research artifacts under `.omo/` are `draft` or `experimental` and are not contributor-facing source of truth.
104
105
 
@@ -125,6 +126,7 @@ Consumer-reference ownership records the current truth as `owner.enforcement: "p
125
126
  | `tests/**`, `playwright.config.mjs`, `consumer-reference/baselines/**`, `scripts/*baseline*.mjs`, `scripts/*sentinel*.mjs`, `scripts/*renderer-purity.mjs` | Repository governance owner with Validation owner | Pure rendering, computed semantics before screenshots, immutable browser pins, required consumer-conformance semantics, optional raster capture, calibration cardinality, and pending owner approval. |
126
127
  | `game-ui/**` | Game UI domain owner | Player-task classification, hierarchy responsibility, reference records, engine-specific subtrees, and cross-engine boundaries. |
127
128
  | `platform-guides/**` | Platform Guides domain owner | Platform/source/version limits, comparison boundaries, and stale review. |
129
+ | `design-terminology/**` | Design Terminology domain owner | Term-family classification, comparative system definitions, conflict-case boundaries, and external vocabulary citations. |
128
130
  | `scripts/validate-*.mjs`, `scripts/test-validate-*.mjs`, `.github/workflows/validate.yml`, `.github/workflows/evidence-freshness.yml` | Validation owner | Validator scope, negative fixtures, blocking/advisory boundaries, CI parity. |
129
131
 
130
132
  ## Shared Promotion Governance
package/README.md CHANGED
@@ -7,18 +7,18 @@ description: Governed gallery of portable interface knowledge organized by domai
7
7
  # StyleGallery
8
8
 
9
9
  <p align="center">
10
- <img src="https://cdn.jsdelivr.net/gh/changeroa/StyleGallery@c18bc87/assets/stylegallery-hero-infographic.webp" alt="StyleGallery infographic connecting five governed interface-knowledge domains to shared consumer and agent infrastructure" width="100%">
10
+ <img src="https://cdn.jsdelivr.net/gh/changeroa/StyleGallery@c18bc87/assets/stylegallery-hero-infographic.webp" alt="StyleGallery infographic connecting six governed interface-knowledge domains to shared consumer and agent infrastructure" width="100%">
11
11
  </p>
12
12
 
13
- StyleGallery is a governed gallery of portable interface knowledge. It separates reusable spatial patterns, product-layer motion guidance, design-engineering practice, and platform-specific references into explicit domains with different evidence and ownership boundaries.
13
+ StyleGallery is a governed gallery of portable interface knowledge. It separates reusable spatial patterns, product-layer motion guidance, design-engineering practice, platform-specific references, and comparative design terminology into explicit domains with different evidence and ownership boundaries.
14
14
 
15
15
  Primary role: repository guide.
16
16
 
17
17
  The existing Layout corpus remains a gallery of minimal, portable CSS layout patterns at its current paths. Each pattern documents one primary spatial problem and the smallest robust HTML/CSS structure that solves it. Motion, visual treatment, and platform guidance do not expand reusable Layout pattern CSS; they live in their own domains and carry explicit evidence boundaries.
18
18
 
19
- [Consumer Reference](consumer-reference/index.md) is shared non-domain infrastructure for optional consumer-owned reference handoffs. It carries schema, routing, provenance, and evidence metadata without owning profiles, visual values, components, or a sixth domain.
19
+ [Consumer Reference](consumer-reference/index.md) is shared non-domain infrastructure for optional consumer-owned reference handoffs. It carries schema, routing, provenance, and evidence metadata without owning profiles, visual values, components, or a seventh domain.
20
20
 
21
- [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) is the machine-facing entry point over that governed knowledge. Frozen v1 provides claim/evidence/governance records through `sg` and its MCP; isolated material v2 indexes admitted Markdown and exposes `sg-material` plus a separate read-only MCP. Lifecycle records own extension and archive dispositions. These material, trust/conformance, transport, and extension planes do not create a sixth domain, replace the Markdown corpus, permit mutation, or feed visual defaults back into Layout.
21
+ [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) is the machine-facing entry point over that governed knowledge. Frozen v1 provides claim/evidence/governance records through `sg` and its MCP; isolated material v2 indexes admitted Markdown and exposes `sg-material` plus a separate read-only MCP. Lifecycle records own extension and archive dispositions. These material, trust/conformance, transport, and extension planes do not create a seventh domain, replace the Markdown corpus, permit mutation, or feed visual defaults back into Layout.
22
22
 
23
23
  ## Quick Start
24
24
 
@@ -52,10 +52,12 @@ Material v2 searches the admitted Markdown corpus and returns JSON without an ad
52
52
 
53
53
  ```sh
54
54
  sg-material discover
55
- sg-material search --query "sticky layout" --limit 5
55
+ sg-material search --query "sticky layout" --paths-only --limit 5
56
56
  sg-material context --query "responsive sidebar" --budget-tokens 4096
57
57
  ```
58
58
 
59
+ For a coding agent with repository filesystem access, local guided traversal is the default: read `AGENTS.md` and this README, follow the narrowest relevant task route or domain index, and inspect the selected Markdown files directly. Use `search --paths-only` only when the path is unclear; it returns a deterministic `paths` array of repository-relative candidates without full result metadata. Reserve `context` for environments that cannot read repository files or for transferring a bounded, provenance-linked package.
60
+
59
61
  ### Worked homepage example
60
62
 
61
63
  The [StyleGallery homepage example](examples/stylegallery-homepage/README.md) was planned from a clean install of the published npm package. It demonstrates the Homepage recipe, selected layout patterns, agent-native CLI access, responsive behavior, and Chrome CDP verification in a standalone product-layer implementation.
@@ -100,7 +102,7 @@ npm install --global stylegallery
100
102
  sg discover --format json
101
103
  ```
102
104
 
103
- `discover`는 사용 가능한 인터페이스를 보여주고, `resolve`는 하나의 레코드를 조회하며, `claims`는 관련 주장과 근거를 분리해서 보여줍니다. `context`는 에이전트에 전달할 수 있는 제한된 컨텍스트 패키지를 만들고, `ops`는 지원하는 작업 목록을 반환합니다. `sg-material search --query "검색어"`를 사용하면 Material v2에 등록된 Markdown 문서를 검색할 수 있습니다. 모든 결과는 자동화에 바로 사용할 수 있는 JSON입니다.
105
+ `discover`는 사용 가능한 인터페이스를 보여주고, `resolve`는 하나의 레코드를 조회하며, `claims`는 관련 주장과 근거를 분리해서 보여줍니다. `context`는 에이전트에 전달할 수 있는 제한된 컨텍스트 패키지를 만들고, `ops`는 지원하는 작업 목록을 반환합니다. 저장소를 직접 읽을 수 있는 에이전트는 `AGENTS.md`와 이 README의 작업 경로에서 시작해 로컬 Markdown을 따라가는 방식이 기본입니다. 경로가 불명확할 때만 `sg-material search --query "검색어" --paths-only --limit 5`로 후보 경로를 좁히고, `context`는 파일에 직접 접근할 수 없거나 제한된 패키지를 전달해야 할 때 사용합니다. 모든 결과는 자동화에 바로 사용할 수 있는 JSON입니다.
104
106
 
105
107
  CLI와 MCP의 상세 사용법은 [Agent-Native StyleGallery 가이드](consumer-reference/agent-native/README.md)를 참고하세요. 사람이 문서를 탐색하려면 아래의 도메인 표에서 목적에 맞는 진입점을 선택하면 됩니다.
106
108
 
@@ -113,6 +115,7 @@ CLI와 MCP의 상세 사용법은 [Agent-Native StyleGallery 가이드](consumer
113
115
  | [Design Engineering](design-engineering/index.md) | Product-layer craft decisions and verification questions. | A second universal principle set or taste as evidence. |
114
116
  | [Game UI](game-ui/index.md) | Game-interface classification, hierarchy, reference records, and engine-specific implementation guides. | Reusable Layout CSS or claims that one engine structure is universal. |
115
117
  | [Platform Guides](platform-guides/index.md) | Bounded comparison with named platform conventions. | Affiliation, imitation, or authority over web and accessibility contracts. |
118
+ | [Design Terminology](design-terminology/index.md) | Comparative design-term definitions, term families, and cross-system conflict cases for named systems. | StyleGallery's own vocabulary, motion terminology, visual token values, or authority over external vocabularies. |
116
119
 
117
120
  The canonical domain manifest and provenance policy are in [StyleGallery Domains](DOMAINS.md).
118
121
 
@@ -135,6 +138,7 @@ Use each root hub for one primary job.
135
138
  | [Design Engineering](design-engineering/index.md) | Design Engineering domain hub | You need product-level interface-craft decision guidance. |
136
139
  | [Game UI](game-ui/index.md) | Game UI domain hub | You need to classify a game interface or understand its screen hierarchy. |
137
140
  | [Platform Guides](platform-guides/index.md) | Platform Guides domain hub | You need a bounded platform comparison. |
141
+ | [Design Terminology](design-terminology/index.md) | Design Terminology domain hub | You need to compare how named design systems define or classify design terms. |
138
142
 
139
143
  ## Task Routes
140
144
 
@@ -149,6 +153,7 @@ Each common task has one primary route. Use secondary links only after the prima
149
153
  | `compare adversarial consumer identities` | [Reference Profiles](design-engineering/reference-profiles/index.md) | It keeps non-default product values in related Design Engineering examples over one pinned Layout source. |
150
154
  | `classify a game interface or map it to an engine` | [Game UI](game-ui/index.md) | It separates engine-neutral roles from implementation-specific guidance. |
151
155
  | `compare a named platform convention` | [Platform Guides](platform-guides/index.md) | It requires platform and evidence boundaries before adaptation. |
156
+ | `compare how design systems define a term` | [Design Terminology](design-terminology/index.md) | It separates external terminology comparison from StyleGallery's own controlled vocabulary. |
152
157
  | `turn raw content into a homepage or ordinary webpage` | [Webpage Generation Workflow](guides/webpage-generation-workflow.md) | It starts with use case, content-to-layout fit, harmony, and handoff. |
153
158
  | `plan a screen before the layout problem is obvious` | [Layout Planning Guide](GUIDE.md) | It sequences task, content, scroll, recipe, and verification choices. |
154
159
  | `choose a pattern when the name is unknown` | [Decision Tree](guides/decision-tree.md) | It routes from constraints to pattern categories. |
@@ -175,7 +180,7 @@ Each common task has one primary route. Use secondary links only after the prima
175
180
  ## How To Use This Repository
176
181
 
177
182
  - Start with [StyleGallery Domains](DOMAINS.md) when the owning domain is not already clear.
178
- - Use [Layout](layout/index.md), [Motion](motion/index.md), [Design Engineering](design-engineering/index.md), [Game UI](game-ui/index.md), or [Platform Guides](platform-guides/index.md) as the domain-local entry point.
183
+ - Use [Layout](layout/index.md), [Motion](motion/index.md), [Design Engineering](design-engineering/index.md), [Game UI](game-ui/index.md), [Platform Guides](platform-guides/index.md), or [Design Terminology](design-terminology/index.md) as the domain-local entry point.
179
184
  - Start with [Layout Planning Guide](GUIDE.md) when you are designing a screen before a layout problem is obvious.
180
185
  - Use the [Webpage Generation Workflow](guides/webpage-generation-workflow.md) when raw content needs to become a homepage or ordinary webpage before a layout recipe is obvious.
181
186
  - Use the [Documentation Mode Taxonomy](guides/documentation-mode-taxonomy.md) when adding or reviewing docs so each page has a clear primary reading mode.
@@ -10,7 +10,7 @@ Primary role: machine interface guide.
10
10
 
11
11
  Agent-Native StyleGallery lets a person, script, or agent inspect the governed StyleGallery knowledge graph without learning repository paths first. The Markdown corpus remains the human-readable source material; the agent-native layer gives its governed fixture records stable identities, closed schemas, deterministic operations, and protocol-specific projections.
12
12
 
13
- This is shared non-domain infrastructure. It does not add a sixth StyleGallery domain, make example profiles canonical, or allow an MCP client to mutate repository knowledge.
13
+ This is shared non-domain infrastructure. It does not add a seventh StyleGallery domain, make example profiles canonical, or allow an MCP client to mutate repository knowledge.
14
14
 
15
15
  ## Mental Model
16
16
 
@@ -56,6 +56,17 @@ All machine-mode results are deterministic JSON on stdout. A failed request retu
56
56
  | `context <StableRef>` | Build a deterministic, bounded context package with a snapshot, member manifest, policy, and cache key. |
57
57
  | `ops` | List all operation specifications, including internal governed mutations and their exposure metadata. |
58
58
 
59
+ ## Governed Material v2
60
+
61
+ Material v2 is an isolated, read-only interface over admitted Markdown. Use `sg-material discover`, `search`, `get`, and `context`, or the equivalent `material-*` tools exposed by `stylegallery-material-mcp`. It does not merge material with v1 trust records or expand the admission policy.
62
+
63
+ Search keeps the fixed field weights `title: 16`, `path: 8`, and `body: 1`. For a multi-token query, each field contribution is multiplied by `ceil(material_count / max(1, token_document_frequency))` so a specific, uncommon term such as `sticky` is not outranked by a corpus-wide term such as `layout`. Results expose the document frequency and multiplier for every normalized query token; ties remain ordered by projected StableRef. `--paths-only` preserves the same ranking while returning repository-relative paths.
64
+
65
+ ```sh
66
+ sg-material search --query "sticky layout" --paths-only --limit 5
67
+ stylegallery-material search --query "design terminology source kinds" --paths-only --limit 5
68
+ ```
69
+
59
70
  ## MCP
60
71
 
61
72
  Start the stdio MCP server with:
@@ -49,16 +49,96 @@
49
49
  "domain": "shared",
50
50
  "lifecycle": "stable"
51
51
  },
52
+ {
53
+ "repository_path": "design-engineering/consumer-migration-readiness.md",
54
+ "domain": "design-engineering",
55
+ "lifecycle": "experimental"
56
+ },
52
57
  {
53
58
  "repository_path": "design-engineering/index.md",
54
59
  "domain": "design-engineering",
55
60
  "lifecycle": "experimental"
56
61
  },
62
+ {
63
+ "repository_path": "design-engineering/interface-craft.md",
64
+ "domain": "design-engineering",
65
+ "lifecycle": "experimental"
66
+ },
67
+ {
68
+ "repository_path": "design-terminology/concept-families.md",
69
+ "domain": "design-terminology",
70
+ "lifecycle": "experimental"
71
+ },
72
+ {
73
+ "repository_path": "design-terminology/conflict-cases.md",
74
+ "domain": "design-terminology",
75
+ "lifecycle": "experimental"
76
+ },
77
+ {
78
+ "repository_path": "design-terminology/index.md",
79
+ "domain": "design-terminology",
80
+ "lifecycle": "experimental"
81
+ },
82
+ {
83
+ "repository_path": "design-terminology/relation-types.md",
84
+ "domain": "design-terminology",
85
+ "lifecycle": "experimental"
86
+ },
87
+ {
88
+ "repository_path": "design-terminology/source-kinds.md",
89
+ "domain": "design-terminology",
90
+ "lifecycle": "experimental"
91
+ },
92
+ {
93
+ "repository_path": "design-terminology/source-vocabularies.md",
94
+ "domain": "design-terminology",
95
+ "lifecycle": "experimental"
96
+ },
97
+ {
98
+ "repository_path": "game-ui/classification.md",
99
+ "domain": "game-ui",
100
+ "lifecycle": "experimental"
101
+ },
57
102
  {
58
103
  "repository_path": "game-ui/index.md",
59
104
  "domain": "game-ui",
60
105
  "lifecycle": "experimental"
61
106
  },
107
+ {
108
+ "repository_path": "game-ui/reference-record.md",
109
+ "domain": "game-ui",
110
+ "lifecycle": "experimental"
111
+ },
112
+ {
113
+ "repository_path": "game-ui/screen-hierarchy.md",
114
+ "domain": "game-ui",
115
+ "lifecycle": "experimental"
116
+ },
117
+ {
118
+ "repository_path": "game-ui/unity/architecture.md",
119
+ "domain": "game-ui",
120
+ "lifecycle": "experimental"
121
+ },
122
+ {
123
+ "repository_path": "game-ui/unity/cli-loop.md",
124
+ "domain": "game-ui",
125
+ "lifecycle": "experimental"
126
+ },
127
+ {
128
+ "repository_path": "game-ui/unity/org-wiki.md",
129
+ "domain": "game-ui",
130
+ "lifecycle": "experimental"
131
+ },
132
+ {
133
+ "repository_path": "game-ui/unity/repository-map.md",
134
+ "domain": "game-ui",
135
+ "lifecycle": "experimental"
136
+ },
137
+ {
138
+ "repository_path": "game-ui/unity/ui-systems.md",
139
+ "domain": "game-ui",
140
+ "lifecycle": "experimental"
141
+ },
62
142
  {
63
143
  "repository_path": "guides/decision-tree.md",
64
144
  "domain": "layout",
@@ -104,6 +184,21 @@
104
184
  "domain": "motion",
105
185
  "lifecycle": "experimental"
106
186
  },
187
+ {
188
+ "repository_path": "motion/practice-reference.md",
189
+ "domain": "motion",
190
+ "lifecycle": "experimental"
191
+ },
192
+ {
193
+ "repository_path": "motion/review-workflow.md",
194
+ "domain": "motion",
195
+ "lifecycle": "experimental"
196
+ },
197
+ {
198
+ "repository_path": "motion/vocabulary.md",
199
+ "domain": "motion",
200
+ "lifecycle": "experimental"
201
+ },
107
202
  {
108
203
  "repository_path": "patterns/centering/center.md",
109
204
  "domain": "layout",
@@ -384,11 +479,21 @@
384
479
  "domain": "layout",
385
480
  "lifecycle": "generated"
386
481
  },
482
+ {
483
+ "repository_path": "platform-guides/apple-interaction.md",
484
+ "domain": "platform-guides",
485
+ "lifecycle": "experimental"
486
+ },
387
487
  {
388
488
  "repository_path": "platform-guides/index.md",
389
489
  "domain": "platform-guides",
390
490
  "lifecycle": "experimental"
391
491
  },
492
+ {
493
+ "repository_path": "quality/claim-records/design-terminology-domain-scope.md",
494
+ "domain": "shared",
495
+ "lifecycle": "stable"
496
+ },
392
497
  {
393
498
  "repository_path": "quality/claim-records/index.md",
394
499
  "domain": "shared",
@@ -642,5 +747,5 @@
642
747
  "code": "material_path_internal_excluded"
643
748
  }
644
749
  ],
645
- "version_id": "sg:policy/material-admission-v2@sha256:c866cf112525130508252d2303207da9057c0f3a239f0e056cce9ef2d5a96f1d"
750
+ "version_id": "sg:policy/material-admission-v2@sha256:f306613097c233ca309a1360fa736233dfe5858c8828c5238b956fff8e253870"
646
751
  }