@elevasis/sdk 1.21.0 → 1.22.1

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 (160) hide show
  1. package/dist/cli.cjs +1239 -173
  2. package/dist/index.d.ts +1752 -464
  3. package/dist/index.js +3477 -143
  4. package/dist/node/index.d.ts +1 -0
  5. package/dist/node/index.js +19 -1
  6. package/dist/test-utils/index.d.ts +1188 -127
  7. package/dist/test-utils/index.js +3359 -152
  8. package/dist/worker/index.js +3148 -80
  9. package/package.json +2 -2
  10. package/reference/claude-config/hooks/post-edit-validate.mjs +98 -98
  11. package/reference/claude-config/hooks/scaffold-registry-reminder.mjs +188 -188
  12. package/reference/claude-config/hooks/tool-failure-recovery.mjs +73 -73
  13. package/reference/claude-config/registries/graph-skills.json +4 -4
  14. package/reference/claude-config/registries/knowledge-flags.json +0 -2
  15. package/reference/claude-config/rules/active-change-index.md +80 -80
  16. package/reference/claude-config/rules/agent-start-here.md +277 -277
  17. package/reference/claude-config/rules/deployment.md +57 -57
  18. package/reference/claude-config/rules/error-handling.md +56 -56
  19. package/reference/claude-config/rules/execution.md +40 -40
  20. package/reference/claude-config/rules/frontend.md +4 -4
  21. package/reference/claude-config/rules/observability.md +31 -31
  22. package/reference/claude-config/rules/operations.md +29 -17
  23. package/reference/claude-config/rules/organization-model.md +113 -81
  24. package/reference/claude-config/rules/organization-os.md +115 -113
  25. package/reference/claude-config/rules/package-taxonomy.md +33 -33
  26. package/reference/claude-config/rules/platform.md +42 -42
  27. package/reference/claude-config/rules/shared-types.md +49 -46
  28. package/reference/claude-config/rules/task-tracking.md +47 -47
  29. package/reference/claude-config/rules/ui.md +200 -200
  30. package/reference/claude-config/rules/vibe.md +235 -235
  31. package/reference/claude-config/scripts/statusline-command.js +18 -18
  32. package/reference/claude-config/settings.json +34 -34
  33. package/reference/claude-config/skills/deploy/{SKILL.md → skill.md} +156 -156
  34. package/reference/claude-config/skills/dsp/SKILL.md +66 -66
  35. package/reference/claude-config/skills/elevasis/SKILL.md +235 -235
  36. package/reference/claude-config/skills/explore/SKILL.md +6 -6
  37. package/reference/claude-config/skills/git-sync/SKILL.md +126 -126
  38. package/reference/claude-config/skills/knowledge/SKILL.md +314 -299
  39. package/reference/claude-config/skills/knowledge/operations/codify-level-a.md +100 -100
  40. package/reference/claude-config/skills/knowledge/operations/codify-level-b.md +159 -159
  41. package/reference/claude-config/skills/knowledge/operations/customers.md +109 -109
  42. package/reference/claude-config/skills/knowledge/operations/features.md +76 -76
  43. package/reference/claude-config/skills/knowledge/operations/goals.md +118 -118
  44. package/reference/claude-config/skills/knowledge/operations/identity.md +93 -93
  45. package/reference/claude-config/skills/knowledge/operations/labels.md +94 -94
  46. package/reference/claude-config/skills/knowledge/operations/offerings.md +109 -109
  47. package/reference/claude-config/skills/knowledge/operations/roles.md +99 -99
  48. package/reference/claude-config/skills/knowledge/operations/techStack.md +30 -30
  49. package/reference/claude-config/skills/project/SKILL.md +1088 -1088
  50. package/reference/claude-config/skills/run-ui/SKILL.md +73 -73
  51. package/reference/claude-config/skills/save/SKILL.md +3 -3
  52. package/reference/claude-config/skills/setup/SKILL.md +275 -275
  53. package/reference/claude-config/skills/status/SKILL.md +59 -59
  54. package/reference/claude-config/skills/submit-request/SKILL.md +180 -180
  55. package/reference/claude-config/skills/sync/SKILL.md +47 -47
  56. package/reference/claude-config/skills/tutorial/SKILL.md +259 -259
  57. package/reference/claude-config/skills/tutorial/progress-template.md +74 -74
  58. package/reference/claude-config/skills/tutorial/technical.md +1303 -1303
  59. package/reference/claude-config/skills/tutorial/vibe-coder.md +890 -890
  60. package/reference/claude-config/sync-notes/2026-04-22-git-sync-and-sync-notes.md +27 -27
  61. package/reference/claude-config/sync-notes/2026-04-22-lead-gen-deliverability-removal.md +30 -30
  62. package/reference/claude-config/sync-notes/2026-04-24-test-utils-and-template-tests.md +73 -73
  63. package/reference/claude-config/sync-notes/2026-04-24-ui-consolidation-and-sdk-cli-train.md +86 -86
  64. package/reference/claude-config/sync-notes/2026-04-25-auth-role-system-and-settings-roles.md +55 -55
  65. package/reference/claude-config/sync-notes/2026-04-27-crm-hitl-action-layer-cutover.md +97 -97
  66. package/reference/claude-config/sync-notes/2026-04-27-lead-gen-substrate-train.md +112 -112
  67. package/reference/claude-config/sync-notes/2026-04-29-crm-state-and-lead-gen-processing-status.md +93 -93
  68. package/reference/claude-config/sync-notes/2026-05-02-crm-ownership-next-action.md +58 -58
  69. package/reference/claude-config/sync-notes/2026-05-02-template-hardcode-workos-config.md +56 -56
  70. package/reference/claude-config/sync-notes/2026-05-04-elevasis-workspace.md +71 -71
  71. package/reference/claude-config/sync-notes/2026-05-04-knowledge-bundle.md +83 -83
  72. package/reference/claude-config/sync-notes/2026-05-04-template-skills-run-ui-and-tutorial.md +59 -59
  73. package/reference/claude-config/sync-notes/2026-05-05-list-builder.md +42 -42
  74. package/reference/claude-config/sync-notes/2026-05-06-crm-spine.md +60 -60
  75. package/reference/claude-config/sync-notes/2026-05-06-sdk-changes-release-train.md +37 -37
  76. package/reference/claude-config/sync-notes/2026-05-07-sdk-changes-release-train.md +34 -34
  77. package/reference/claude-config/sync-notes/2026-05-08-resource-governance-scaffold-guidance.md +38 -38
  78. package/reference/claude-config/sync-notes/2026-05-09-clients-domain.md +32 -32
  79. package/reference/claude-config/sync-notes/2026-05-09-command-system.md +33 -33
  80. package/reference/claude-config/sync-notes/2026-05-09-resource-governance-and-misc.md +69 -69
  81. package/reference/claude-config/sync-notes/2026-05-12-sdk-ready-release-train.md +30 -30
  82. package/reference/claude-config/sync-notes/2026-05-14-organization-model-ontology-refactor.md +45 -0
  83. package/reference/claude-config/sync-notes/README.md +43 -43
  84. package/reference/cli.mdx +808 -808
  85. package/reference/concepts.mdx +146 -146
  86. package/reference/deployment/api.mdx +297 -297
  87. package/reference/deployment/command-center.mdx +209 -209
  88. package/reference/deployment/index.mdx +195 -195
  89. package/reference/deployment/provided-features.mdx +107 -107
  90. package/reference/deployment/ui-execution.mdx +250 -250
  91. package/reference/examples/organization-model.ts +171 -84
  92. package/reference/framework/agent.mdx +156 -156
  93. package/reference/framework/index.mdx +195 -195
  94. package/reference/framework/interaction-guidance.mdx +182 -182
  95. package/reference/framework/memory.mdx +326 -326
  96. package/reference/framework/project-structure.mdx +282 -282
  97. package/reference/framework/tutorial-system.mdx +135 -135
  98. package/reference/getting-started.mdx +142 -142
  99. package/reference/index.mdx +106 -106
  100. package/reference/packages/core/src/README.md +14 -14
  101. package/reference/packages/core/src/business/README.md +2 -2
  102. package/reference/packages/core/src/knowledge/README.md +32 -32
  103. package/reference/packages/core/src/organization-model/README.md +149 -149
  104. package/reference/packages/core/src/test-utils/README.md +37 -37
  105. package/reference/packages/ui/src/api/README.md +18 -18
  106. package/reference/packages/ui/src/app/README.md +24 -24
  107. package/reference/packages/ui/src/auth/README.md +18 -18
  108. package/reference/packages/ui/src/components/README.md +24 -24
  109. package/reference/packages/ui/src/execution/README.md +16 -16
  110. package/reference/packages/ui/src/features/README.md +28 -28
  111. package/reference/packages/ui/src/graph/README.md +16 -16
  112. package/reference/packages/ui/src/hooks/README.md +23 -23
  113. package/reference/packages/ui/src/initialization/README.md +19 -19
  114. package/reference/packages/ui/src/knowledge/README.md +31 -31
  115. package/reference/packages/ui/src/organization/README.md +18 -18
  116. package/reference/packages/ui/src/profile/README.md +19 -19
  117. package/reference/packages/ui/src/provider/README.md +32 -32
  118. package/reference/packages/ui/src/router/README.md +18 -18
  119. package/reference/packages/ui/src/sse/README.md +13 -13
  120. package/reference/packages/ui/src/test-utils/README.md +7 -7
  121. package/reference/packages/ui/src/theme/README.md +23 -23
  122. package/reference/packages/ui/src/theme/presets/README.md +19 -19
  123. package/reference/packages/ui/src/types/README.md +16 -16
  124. package/reference/packages/ui/src/utils/README.md +18 -18
  125. package/reference/packages/ui/src/zustand/README.md +18 -18
  126. package/reference/platform-tools/adapters-integration.mdx +301 -301
  127. package/reference/platform-tools/adapters-platform.mdx +553 -553
  128. package/reference/platform-tools/index.mdx +217 -217
  129. package/reference/platform-tools/type-safety.mdx +82 -82
  130. package/reference/resources/index.mdx +349 -349
  131. package/reference/resources/patterns.mdx +449 -449
  132. package/reference/resources/types.mdx +116 -116
  133. package/reference/roadmap.mdx +165 -165
  134. package/reference/runtime.mdx +173 -173
  135. package/reference/scaffold/core/organization-graph.mdx +110 -90
  136. package/reference/scaffold/core/organization-model.mdx +225 -213
  137. package/reference/scaffold/index.mdx +67 -67
  138. package/reference/scaffold/operations/propagation-pipeline.md +77 -77
  139. package/reference/scaffold/operations/scaffold-maintenance.md +12 -12
  140. package/reference/scaffold/operations/workflow-recipes.md +138 -138
  141. package/reference/scaffold/recipes/add-a-feature.md +307 -85
  142. package/reference/scaffold/recipes/add-a-resource.md +137 -103
  143. package/reference/scaffold/recipes/customize-knowledge-browser.md +5 -5
  144. package/reference/scaffold/recipes/customize-organization-model.md +275 -138
  145. package/reference/scaffold/recipes/extend-a-base-entity.md +8 -8
  146. package/reference/scaffold/recipes/extend-crm.md +3 -3
  147. package/reference/scaffold/recipes/extend-lead-gen.md +394 -394
  148. package/reference/scaffold/recipes/gate-by-feature-or-admin.md +118 -118
  149. package/reference/scaffold/recipes/index.md +46 -46
  150. package/reference/scaffold/recipes/query-the-knowledge-graph.md +197 -170
  151. package/reference/scaffold/reference/contracts.md +2136 -2093
  152. package/reference/scaffold/reference/glossary.md +76 -76
  153. package/reference/scaffold/ui/composition-extensibility.mdx +233 -233
  154. package/reference/scaffold/ui/customization.md +243 -243
  155. package/reference/scaffold/ui/feature-flags-and-gating.md +46 -46
  156. package/reference/scaffold/ui/feature-shell.mdx +72 -72
  157. package/reference/scaffold/ui/recipes.md +221 -214
  158. package/reference/spine/spine-primer.md +96 -96
  159. package/reference/templates/index.mdx +47 -47
  160. 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.