@elevasis/sdk 1.20.2 → 1.22.0

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 (164) hide show
  1. package/dist/cli.cjs +4220 -1583
  2. package/dist/index.d.ts +1035 -481
  3. package/dist/index.js +7381 -4187
  4. package/dist/node/index.d.ts +1 -3
  5. package/dist/node/index.js +40 -49
  6. package/dist/test-utils/index.d.ts +699 -123
  7. package/dist/test-utils/index.js +3826 -630
  8. package/dist/worker/index.js +3616 -442
  9. package/package.json +3 -3
  10. package/reference/_navigation.md +9 -7
  11. package/reference/_reference-manifest.json +1 -1
  12. package/reference/claude-config/hooks/post-edit-validate.mjs +98 -98
  13. package/reference/claude-config/hooks/scaffold-registry-reminder.mjs +188 -188
  14. package/reference/claude-config/hooks/tool-failure-recovery.mjs +73 -73
  15. package/reference/claude-config/registries/graph-skills.json +4 -4
  16. package/reference/claude-config/registries/knowledge-flags.json +0 -2
  17. package/reference/claude-config/rules/active-change-index.md +80 -80
  18. package/reference/claude-config/rules/agent-start-here.md +277 -273
  19. package/reference/claude-config/rules/deployment.md +57 -57
  20. package/reference/claude-config/rules/error-handling.md +56 -56
  21. package/reference/claude-config/rules/execution.md +40 -40
  22. package/reference/claude-config/rules/frontend.md +4 -4
  23. package/reference/claude-config/rules/observability.md +31 -31
  24. package/reference/claude-config/rules/operations.md +29 -17
  25. package/reference/claude-config/rules/organization-model.md +108 -40
  26. package/reference/claude-config/rules/organization-os.md +115 -113
  27. package/reference/claude-config/rules/package-taxonomy.md +33 -33
  28. package/reference/claude-config/rules/platform.md +42 -42
  29. package/reference/claude-config/rules/shared-types.md +49 -46
  30. package/reference/claude-config/rules/task-tracking.md +47 -47
  31. package/reference/claude-config/rules/ui.md +200 -200
  32. package/reference/claude-config/rules/vibe.md +235 -231
  33. package/reference/claude-config/scripts/statusline-command.js +18 -18
  34. package/reference/claude-config/settings.json +34 -34
  35. package/reference/claude-config/skills/deploy/{SKILL.md → skill.md} +156 -156
  36. package/reference/claude-config/skills/dsp/SKILL.md +66 -66
  37. package/reference/claude-config/skills/elevasis/SKILL.md +235 -235
  38. package/reference/claude-config/skills/explore/SKILL.md +6 -6
  39. package/reference/claude-config/skills/git-sync/SKILL.md +126 -126
  40. package/reference/claude-config/skills/knowledge/SKILL.md +330 -271
  41. package/reference/claude-config/skills/knowledge/operations/codify-level-a.md +100 -100
  42. package/reference/claude-config/skills/knowledge/operations/codify-level-b.md +159 -158
  43. package/reference/claude-config/skills/knowledge/operations/customers.md +109 -109
  44. package/reference/claude-config/skills/knowledge/operations/features.md +76 -113
  45. package/reference/claude-config/skills/knowledge/operations/goals.md +118 -118
  46. package/reference/claude-config/skills/knowledge/operations/identity.md +93 -93
  47. package/reference/claude-config/skills/knowledge/operations/labels.md +94 -89
  48. package/reference/claude-config/skills/knowledge/operations/offerings.md +109 -109
  49. package/reference/claude-config/skills/knowledge/operations/roles.md +99 -99
  50. package/reference/claude-config/skills/knowledge/operations/techStack.md +30 -30
  51. package/reference/claude-config/skills/project/SKILL.md +1088 -1088
  52. package/reference/claude-config/skills/run-ui/SKILL.md +73 -73
  53. package/reference/claude-config/skills/save/SKILL.md +3 -3
  54. package/reference/claude-config/skills/setup/SKILL.md +275 -275
  55. package/reference/claude-config/skills/status/SKILL.md +59 -59
  56. package/reference/claude-config/skills/submit-request/SKILL.md +180 -180
  57. package/reference/claude-config/skills/sync/SKILL.md +47 -47
  58. package/reference/claude-config/skills/tutorial/SKILL.md +259 -259
  59. package/reference/claude-config/skills/tutorial/progress-template.md +74 -74
  60. package/reference/claude-config/skills/tutorial/technical.md +1303 -1306
  61. package/reference/claude-config/skills/tutorial/vibe-coder.md +890 -890
  62. package/reference/claude-config/sync-notes/2026-04-22-git-sync-and-sync-notes.md +27 -27
  63. package/reference/claude-config/sync-notes/2026-04-22-lead-gen-deliverability-removal.md +30 -30
  64. package/reference/claude-config/sync-notes/2026-04-24-test-utils-and-template-tests.md +73 -73
  65. package/reference/claude-config/sync-notes/2026-04-24-ui-consolidation-and-sdk-cli-train.md +86 -86
  66. package/reference/claude-config/sync-notes/2026-04-25-auth-role-system-and-settings-roles.md +55 -55
  67. package/reference/claude-config/sync-notes/2026-04-27-crm-hitl-action-layer-cutover.md +97 -97
  68. package/reference/claude-config/sync-notes/2026-04-27-lead-gen-substrate-train.md +112 -112
  69. package/reference/claude-config/sync-notes/2026-04-29-crm-state-and-lead-gen-processing-status.md +93 -93
  70. package/reference/claude-config/sync-notes/2026-05-02-crm-ownership-next-action.md +58 -58
  71. package/reference/claude-config/sync-notes/2026-05-02-template-hardcode-workos-config.md +56 -56
  72. package/reference/claude-config/sync-notes/2026-05-04-elevasis-workspace.md +71 -71
  73. package/reference/claude-config/sync-notes/2026-05-04-knowledge-bundle.md +83 -83
  74. package/reference/claude-config/sync-notes/2026-05-04-template-skills-run-ui-and-tutorial.md +59 -59
  75. package/reference/claude-config/sync-notes/2026-05-05-list-builder.md +42 -42
  76. package/reference/claude-config/sync-notes/2026-05-06-crm-spine.md +60 -60
  77. package/reference/claude-config/sync-notes/2026-05-06-sdk-changes-release-train.md +37 -37
  78. package/reference/claude-config/sync-notes/2026-05-07-sdk-changes-release-train.md +34 -34
  79. package/reference/claude-config/sync-notes/2026-05-08-resource-governance-scaffold-guidance.md +38 -38
  80. package/reference/claude-config/sync-notes/2026-05-09-clients-domain.md +32 -32
  81. package/reference/claude-config/sync-notes/2026-05-09-command-system.md +33 -33
  82. package/reference/claude-config/sync-notes/2026-05-09-resource-governance-and-misc.md +69 -69
  83. package/reference/claude-config/sync-notes/2026-05-12-sdk-ready-release-train.md +30 -0
  84. package/reference/claude-config/sync-notes/2026-05-14-organization-model-ontology-refactor.md +42 -0
  85. package/reference/claude-config/sync-notes/README.md +43 -43
  86. package/reference/cli.mdx +808 -668
  87. package/reference/concepts.mdx +146 -146
  88. package/reference/deployment/api.mdx +297 -297
  89. package/reference/deployment/command-center.mdx +209 -209
  90. package/reference/deployment/index.mdx +195 -195
  91. package/reference/deployment/provided-features.mdx +107 -93
  92. package/reference/deployment/ui-execution.mdx +250 -250
  93. package/reference/examples/organization-model.ts +147 -84
  94. package/reference/framework/agent.mdx +156 -156
  95. package/reference/framework/index.mdx +195 -195
  96. package/reference/framework/interaction-guidance.mdx +182 -182
  97. package/reference/framework/memory.mdx +326 -326
  98. package/reference/framework/project-structure.mdx +282 -282
  99. package/reference/framework/tutorial-system.mdx +135 -135
  100. package/reference/getting-started.mdx +142 -142
  101. package/reference/index.mdx +106 -106
  102. package/reference/packages/core/src/README.md +14 -14
  103. package/reference/packages/core/src/business/README.md +2 -2
  104. package/reference/packages/core/src/knowledge/README.md +33 -32
  105. package/reference/packages/core/src/organization-model/README.md +149 -109
  106. package/reference/packages/core/src/test-utils/README.md +37 -37
  107. package/reference/packages/ui/src/api/README.md +18 -18
  108. package/reference/packages/ui/src/app/README.md +24 -24
  109. package/reference/packages/ui/src/auth/README.md +18 -18
  110. package/reference/packages/ui/src/components/README.md +24 -24
  111. package/reference/packages/ui/src/execution/README.md +16 -16
  112. package/reference/packages/ui/src/features/README.md +28 -28
  113. package/reference/packages/ui/src/graph/README.md +16 -16
  114. package/reference/packages/ui/src/hooks/README.md +23 -23
  115. package/reference/packages/ui/src/initialization/README.md +19 -19
  116. package/reference/packages/ui/src/knowledge/README.md +31 -31
  117. package/reference/packages/ui/src/organization/README.md +18 -18
  118. package/reference/packages/ui/src/profile/README.md +19 -19
  119. package/reference/packages/ui/src/provider/README.md +32 -32
  120. package/reference/packages/ui/src/router/README.md +18 -18
  121. package/reference/packages/ui/src/sse/README.md +13 -13
  122. package/reference/packages/ui/src/test-utils/README.md +7 -7
  123. package/reference/packages/ui/src/theme/README.md +23 -23
  124. package/reference/packages/ui/src/theme/presets/README.md +19 -19
  125. package/reference/packages/ui/src/types/README.md +16 -16
  126. package/reference/packages/ui/src/utils/README.md +18 -18
  127. package/reference/packages/ui/src/zustand/README.md +18 -18
  128. package/reference/platform-tools/adapters-integration.mdx +301 -301
  129. package/reference/platform-tools/adapters-platform.mdx +553 -553
  130. package/reference/platform-tools/index.mdx +217 -217
  131. package/reference/platform-tools/type-safety.mdx +82 -82
  132. package/reference/resources/index.mdx +349 -349
  133. package/reference/resources/patterns.mdx +449 -449
  134. package/reference/resources/types.mdx +116 -116
  135. package/reference/roadmap.mdx +165 -165
  136. package/reference/runtime.mdx +173 -173
  137. package/reference/scaffold/core/organization-graph.mdx +110 -89
  138. package/reference/scaffold/core/organization-model.mdx +226 -171
  139. package/reference/scaffold/index.mdx +67 -67
  140. package/reference/scaffold/operations/propagation-pipeline.md +77 -77
  141. package/reference/scaffold/operations/scaffold-maintenance.md +10 -10
  142. package/reference/scaffold/operations/workflow-recipes.md +138 -138
  143. package/reference/scaffold/recipes/add-a-feature.md +310 -88
  144. package/reference/scaffold/recipes/add-a-resource.md +137 -117
  145. package/reference/scaffold/recipes/customize-crm-actions.md +439 -439
  146. package/reference/scaffold/recipes/customize-knowledge-browser.md +384 -0
  147. package/reference/scaffold/recipes/customize-organization-model.md +281 -118
  148. package/reference/scaffold/recipes/extend-a-base-entity.md +8 -8
  149. package/reference/scaffold/recipes/extend-crm.md +40 -39
  150. package/reference/scaffold/recipes/extend-lead-gen.md +400 -401
  151. package/reference/scaffold/recipes/gate-by-feature-or-admin.md +118 -114
  152. package/reference/scaffold/recipes/index.md +47 -46
  153. package/reference/scaffold/recipes/query-the-knowledge-graph.md +227 -0
  154. package/reference/scaffold/reference/contracts.md +2389 -2121
  155. package/reference/scaffold/reference/feature-registry.md +9 -20
  156. package/reference/scaffold/reference/glossary.md +76 -76
  157. package/reference/scaffold/ui/composition-extensibility.mdx +233 -233
  158. package/reference/scaffold/ui/customization.md +243 -243
  159. package/reference/scaffold/ui/feature-flags-and-gating.md +46 -46
  160. package/reference/scaffold/ui/feature-shell.mdx +72 -72
  161. package/reference/scaffold/ui/recipes.md +221 -213
  162. package/reference/spine/spine-primer.md +96 -96
  163. package/reference/templates/index.mdx +47 -47
  164. package/reference/troubleshooting.mdx +223 -223
@@ -1,73 +1,73 @@
1
- #!/usr/bin/env node
2
- // tool-failure-recovery.mjs
3
- // PostToolUseFailure hook — pattern-matches known Bash errors and returns
4
- // recovery advice via stderr + exit 2 (feedback to Claude).
5
-
6
- const RECOVERY_TABLE = [
7
- {
8
- test: (r) => /JavaScript heap out of memory/i.test(r),
9
- advice: 'Out of memory.',
10
- fix: 'Run the command with NODE_OPTIONS="--max-old-space-size=4096".',
11
- why: 'Large TypeScript projects can exceed Node default heap limit.'
12
- },
13
- {
14
- test: (r) => /ENOENT/.test(r) && /node_modules/.test(r),
15
- advice: 'Missing node_modules dependency.',
16
- fix: 'Run: pnpm install',
17
- why: 'Dependencies are not installed or were cleared.'
18
- },
19
- {
20
- test: (r) => /ERR_MODULE_NOT_FOUND/.test(r),
21
- advice: 'Module not found at import path.',
22
- fix: 'Check the import path and verify the package is installed (pnpm install).',
23
- why: 'The import path does not match any installed package or local file.'
24
- },
25
- {
26
- test: (r) => /TS2307/.test(r) || (/cannot find/i.test(r) && /declaration/i.test(r)),
27
- advice: 'TypeScript cannot resolve module or declaration file.',
28
- fix: 'Check that the package is installed and tsconfig paths are correct.',
29
- why: 'Missing dependency or incorrect TypeScript configuration.'
30
- },
31
- {
32
- test: (r) => /EPERM/.test(r) || /permission denied/i.test(r),
33
- advice: 'Permission denied (EPERM).',
34
- fix: 'Close the file in any other process (editor, terminal, or dev server) and retry.',
35
- why: 'On Windows, files locked by another process cannot be written to.'
36
- },
37
- {
38
- test: (r) => /lockfile/i.test(r) && /conflict|outdated|ERR_PNPM/i.test(r),
39
- advice: 'pnpm lockfile conflict or outdated.',
40
- fix: 'Run: pnpm install to regenerate the lockfile.',
41
- why: 'The lockfile is out of sync with package.json changes.'
42
- },
43
- {
44
- test: (r) => /EADDRINUSE/.test(r),
45
- advice: 'Port already in use.',
46
- fix: 'Find and kill the process using the port, or use a different port.',
47
- why: 'A previous dev server or process is still holding the port.'
48
- }
49
- ]
50
-
51
- function formatRecovery(entry) {
52
- let msg = 'FAILED: ' + entry.advice + '\nFIX: ' + entry.fix
53
- if (entry.why) msg += '\nWHY: ' + entry.why
54
- if (entry.see) msg += '\nSEE: ' + entry.see
55
- return msg
56
- }
57
-
58
- try {
59
- const chunks = []
60
- for await (const chunk of process.stdin) chunks.push(chunk)
61
- const input = JSON.parse(Buffer.concat(chunks).toString())
62
-
63
- const response = input.tool_response ?? ''
64
-
65
- for (const entry of RECOVERY_TABLE) {
66
- if (entry.test(response)) {
67
- process.stderr.write(formatRecovery(entry))
68
- process.exit(2)
69
- }
70
- }
71
- } catch {}
72
-
73
- process.exit(0)
1
+ #!/usr/bin/env node
2
+ // tool-failure-recovery.mjs
3
+ // PostToolUseFailure hook — pattern-matches known Bash errors and returns
4
+ // recovery advice via stderr + exit 2 (feedback to Claude).
5
+
6
+ const RECOVERY_TABLE = [
7
+ {
8
+ test: (r) => /JavaScript heap out of memory/i.test(r),
9
+ advice: 'Out of memory.',
10
+ fix: 'Run the command with NODE_OPTIONS="--max-old-space-size=4096".',
11
+ why: 'Large TypeScript projects can exceed Node default heap limit.'
12
+ },
13
+ {
14
+ test: (r) => /ENOENT/.test(r) && /node_modules/.test(r),
15
+ advice: 'Missing node_modules dependency.',
16
+ fix: 'Run: pnpm install',
17
+ why: 'Dependencies are not installed or were cleared.'
18
+ },
19
+ {
20
+ test: (r) => /ERR_MODULE_NOT_FOUND/.test(r),
21
+ advice: 'Module not found at import path.',
22
+ fix: 'Check the import path and verify the package is installed (pnpm install).',
23
+ why: 'The import path does not match any installed package or local file.'
24
+ },
25
+ {
26
+ test: (r) => /TS2307/.test(r) || (/cannot find/i.test(r) && /declaration/i.test(r)),
27
+ advice: 'TypeScript cannot resolve module or declaration file.',
28
+ fix: 'Check that the package is installed and tsconfig paths are correct.',
29
+ why: 'Missing dependency or incorrect TypeScript configuration.'
30
+ },
31
+ {
32
+ test: (r) => /EPERM/.test(r) || /permission denied/i.test(r),
33
+ advice: 'Permission denied (EPERM).',
34
+ fix: 'Close the file in any other process (editor, terminal, or dev server) and retry.',
35
+ why: 'On Windows, files locked by another process cannot be written to.'
36
+ },
37
+ {
38
+ test: (r) => /lockfile/i.test(r) && /conflict|outdated|ERR_PNPM/i.test(r),
39
+ advice: 'pnpm lockfile conflict or outdated.',
40
+ fix: 'Run: pnpm install to regenerate the lockfile.',
41
+ why: 'The lockfile is out of sync with package.json changes.'
42
+ },
43
+ {
44
+ test: (r) => /EADDRINUSE/.test(r),
45
+ advice: 'Port already in use.',
46
+ fix: 'Find and kill the process using the port, or use a different port.',
47
+ why: 'A previous dev server or process is still holding the port.'
48
+ }
49
+ ]
50
+
51
+ function formatRecovery(entry) {
52
+ let msg = 'FAILED: ' + entry.advice + '\nFIX: ' + entry.fix
53
+ if (entry.why) msg += '\nWHY: ' + entry.why
54
+ if (entry.see) msg += '\nSEE: ' + entry.see
55
+ return msg
56
+ }
57
+
58
+ try {
59
+ const chunks = []
60
+ for await (const chunk of process.stdin) chunks.push(chunk)
61
+ const input = JSON.parse(Buffer.concat(chunks).toString())
62
+
63
+ const response = input.tool_response ?? ''
64
+
65
+ for (const entry of RECOVERY_TABLE) {
66
+ if (entry.test(response)) {
67
+ process.stderr.write(formatRecovery(entry))
68
+ process.exit(2)
69
+ }
70
+ }
71
+ } catch {}
72
+
73
+ process.exit(0)
@@ -1,4 +1,4 @@
1
- {
2
- "generatedBy": "generate-knowledge-nodes",
3
- "domains": {}
4
- }
1
+ {
2
+ "generatedBy": "generate-knowledge-nodes",
3
+ "domains": {}
4
+ }
@@ -50,7 +50,6 @@
50
50
  "welcome",
51
51
  "welcome-mdx"
52
52
  ],
53
- "skills": [],
54
53
  "cliBindings": [
55
54
  {
56
55
  "command": "pnpm exec elevasis-sdk knowledge:cat knowledge.welcome",
@@ -112,7 +111,6 @@
112
111
  "appear"
113
112
  ],
114
113
  "links": [],
115
- "skills": [],
116
114
  "cliBindings": [
117
115
  {
118
116
  "command": "pnpm exec elevasis-sdk knowledge:cat knowledge.welcome",
@@ -1,80 +1,80 @@
1
- ---
2
- description: Bridge between stable scaffold docs and higher-volatility in-progress architecture work that may override assumptions for agents working in the template
3
- ---
4
-
5
- # Active Change Index
6
-
7
- Use this rule to decide whether stable scaffold docs are enough, or whether you also need to load in-progress platform architecture docs from the monorepo.
8
-
9
- > **Note:** Paths prefixed with `apps/` or `packages/` are monorepo-internal and unavailable in standalone projects. For those areas, use the stable scaffold docs under `node_modules/@elevasis/sdk/reference/scaffold/` as the primary reference. The monorepo paths are retained for contributors working within the monorepo.
10
-
11
- ## Current Watch Areas
12
-
13
- ### Organization OS
14
-
15
- Use when the task touches:
16
-
17
- - organization model semantics
18
- - feature/provider runtime
19
- - feature manifests or shell composition
20
- - graph or command-view concepts
21
- - downstream propagation of scaffold contract changes
22
-
23
- Load:
24
-
25
- - `apps/docs/content/docs/technical/architecture/core/organization-model/index.mdx`
26
- - `apps/docs/content/docs/technical/architecture/core/organization-model/graph.mdx`
27
- - `apps/docs/content/docs/technical/architecture/ui/feature-shell.mdx`
28
- - `apps/docs/content/docs/technical/architecture/ui/composition-extensibility.mdx`
29
-
30
- Stable scaffold docs affected:
31
-
32
- - `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
33
- - `.claude/rules/ui.md`
34
- - `node_modules/@elevasis/sdk/reference/scaffold/ui/customization.md`
35
- - `node_modules/@elevasis/sdk/reference/scaffold/ui/feature-flags-and-gating.md`
36
-
37
- ### Package Surface / Reference System
38
-
39
- Use when the task touches:
40
-
41
- - published `@elevasis/core`, `@elevasis/ui`, or `@elevasis/sdk` surfaces
42
- - generated package maps
43
- - contract drift between source and scaffold docs
44
-
45
- Load:
46
-
47
- - `packages/core/src/organization-model/README.md`
48
- - `packages/ui/src/provider/README.md`
49
- - `packages/ui/src/features/README.md`
50
- - `packages/sdk/reference/_navigation.md`
51
-
52
- Stable scaffold docs affected:
53
-
54
- - `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
55
-
56
- ### Resource / Topology Mapping
57
-
58
- Use when the task touches:
59
-
60
- - resource registration
61
- - triggers, integrations, relationships, human checkpoints
62
- - topology-aware navigation or impact analysis
63
-
64
- Load:
65
-
66
- - `operations/src/README.md`
67
- - `operations/src/index.ts`
68
-
69
- Stable scaffold docs affected:
70
-
71
- - `.claude/rules/operations.md`
72
-
73
- ## Working Rule
74
-
75
- When a task touches one of the watch areas above:
76
-
77
- 1. Read the stable scaffold doc.
78
- 2. Read the listed in-progress or package-local source-of-truth docs.
79
- 3. Prefer source and in-progress architecture docs if they disagree with scaffold prose.
80
- 4. Flag drift instead of silently trusting the scaffold doc.
1
+ ---
2
+ description: Bridge between stable scaffold docs and higher-volatility in-progress architecture work that may override assumptions for agents working in the template
3
+ ---
4
+
5
+ # Active Change Index
6
+
7
+ Use this rule to decide whether stable scaffold docs are enough, or whether you also need to load in-progress platform architecture docs from the monorepo.
8
+
9
+ > **Note:** Paths prefixed with `apps/` or `packages/` are monorepo-internal and unavailable in standalone projects. For those areas, use the stable scaffold docs under `node_modules/@elevasis/sdk/reference/scaffold/` as the primary reference. The monorepo paths are retained for contributors working within the monorepo.
10
+
11
+ ## Current Watch Areas
12
+
13
+ ### Organization OS
14
+
15
+ Use when the task touches:
16
+
17
+ - organization model semantics
18
+ - feature/provider runtime
19
+ - feature manifests or shell composition
20
+ - graph or command-view concepts
21
+ - downstream propagation of scaffold contract changes
22
+
23
+ Load:
24
+
25
+ - `apps/docs/content/docs/technical/architecture/core/organization-model/index.mdx`
26
+ - `apps/docs/content/docs/technical/architecture/core/organization-model/graph.mdx`
27
+ - `apps/docs/content/docs/technical/architecture/ui/feature-shell.mdx`
28
+ - `apps/docs/content/docs/technical/architecture/ui/composition-extensibility.mdx`
29
+
30
+ Stable scaffold docs affected:
31
+
32
+ - `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
33
+ - `.claude/rules/ui.md`
34
+ - `node_modules/@elevasis/sdk/reference/scaffold/ui/customization.md`
35
+ - `node_modules/@elevasis/sdk/reference/scaffold/ui/feature-flags-and-gating.md`
36
+
37
+ ### Package Surface / Reference System
38
+
39
+ Use when the task touches:
40
+
41
+ - published `@elevasis/core`, `@elevasis/ui`, or `@elevasis/sdk` surfaces
42
+ - generated package maps
43
+ - contract drift between source and scaffold docs
44
+
45
+ Load:
46
+
47
+ - `packages/core/src/organization-model/README.md`
48
+ - `packages/ui/src/provider/README.md`
49
+ - `packages/ui/src/features/README.md`
50
+ - `packages/sdk/reference/_navigation.md`
51
+
52
+ Stable scaffold docs affected:
53
+
54
+ - `node_modules/@elevasis/sdk/reference/scaffold/reference/contracts.md`
55
+
56
+ ### Resource / Topology Mapping
57
+
58
+ Use when the task touches:
59
+
60
+ - resource registration
61
+ - triggers, integrations, relationships, human checkpoints
62
+ - topology-aware navigation or impact analysis
63
+
64
+ Load:
65
+
66
+ - `operations/src/README.md`
67
+ - `operations/src/index.ts`
68
+
69
+ Stable scaffold docs affected:
70
+
71
+ - `.claude/rules/operations.md`
72
+
73
+ ## Working Rule
74
+
75
+ When a task touches one of the watch areas above:
76
+
77
+ 1. Read the stable scaffold doc.
78
+ 2. Read the listed in-progress or package-local source-of-truth docs.
79
+ 3. Prefer source and in-progress architecture docs if they disagree with scaffold prose.
80
+ 4. Flag drift instead of silently trusting the scaffold doc.