@elevasis/sdk 1.21.0 → 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.
- package/dist/cli.cjs +951 -171
- package/dist/index.d.ts +632 -341
- package/dist/index.js +3102 -142
- package/dist/node/index.d.ts +1 -0
- package/dist/node/index.js +19 -1
- package/dist/test-utils/index.d.ts +313 -4
- package/dist/test-utils/index.js +3246 -281
- package/dist/worker/index.js +3041 -80
- package/package.json +3 -3
- package/reference/claude-config/hooks/post-edit-validate.mjs +98 -98
- package/reference/claude-config/hooks/scaffold-registry-reminder.mjs +188 -188
- package/reference/claude-config/hooks/tool-failure-recovery.mjs +73 -73
- package/reference/claude-config/registries/graph-skills.json +4 -4
- package/reference/claude-config/registries/knowledge-flags.json +0 -2
- package/reference/claude-config/rules/active-change-index.md +80 -80
- package/reference/claude-config/rules/agent-start-here.md +277 -277
- package/reference/claude-config/rules/deployment.md +57 -57
- package/reference/claude-config/rules/error-handling.md +56 -56
- package/reference/claude-config/rules/execution.md +40 -40
- package/reference/claude-config/rules/frontend.md +4 -4
- package/reference/claude-config/rules/observability.md +31 -31
- package/reference/claude-config/rules/operations.md +29 -17
- package/reference/claude-config/rules/organization-model.md +110 -84
- package/reference/claude-config/rules/organization-os.md +115 -113
- package/reference/claude-config/rules/package-taxonomy.md +33 -33
- package/reference/claude-config/rules/platform.md +42 -42
- package/reference/claude-config/rules/shared-types.md +49 -46
- package/reference/claude-config/rules/task-tracking.md +47 -47
- package/reference/claude-config/rules/ui.md +200 -200
- package/reference/claude-config/rules/vibe.md +235 -235
- package/reference/claude-config/scripts/statusline-command.js +18 -18
- package/reference/claude-config/settings.json +34 -34
- package/reference/claude-config/skills/deploy/{SKILL.md → skill.md} +156 -156
- package/reference/claude-config/skills/dsp/SKILL.md +66 -66
- package/reference/claude-config/skills/elevasis/SKILL.md +235 -235
- package/reference/claude-config/skills/explore/SKILL.md +6 -6
- package/reference/claude-config/skills/git-sync/SKILL.md +126 -126
- package/reference/claude-config/skills/knowledge/SKILL.md +314 -299
- package/reference/claude-config/skills/knowledge/operations/codify-level-a.md +100 -100
- package/reference/claude-config/skills/knowledge/operations/codify-level-b.md +159 -159
- package/reference/claude-config/skills/knowledge/operations/customers.md +109 -109
- package/reference/claude-config/skills/knowledge/operations/features.md +76 -76
- package/reference/claude-config/skills/knowledge/operations/goals.md +118 -118
- package/reference/claude-config/skills/knowledge/operations/identity.md +93 -93
- package/reference/claude-config/skills/knowledge/operations/labels.md +94 -94
- package/reference/claude-config/skills/knowledge/operations/offerings.md +109 -109
- package/reference/claude-config/skills/knowledge/operations/roles.md +99 -99
- package/reference/claude-config/skills/knowledge/operations/techStack.md +30 -30
- package/reference/claude-config/skills/project/SKILL.md +1088 -1088
- package/reference/claude-config/skills/run-ui/SKILL.md +73 -73
- package/reference/claude-config/skills/save/SKILL.md +3 -3
- package/reference/claude-config/skills/setup/SKILL.md +275 -275
- package/reference/claude-config/skills/status/SKILL.md +59 -59
- package/reference/claude-config/skills/submit-request/SKILL.md +180 -180
- package/reference/claude-config/skills/sync/SKILL.md +47 -47
- package/reference/claude-config/skills/tutorial/SKILL.md +259 -259
- package/reference/claude-config/skills/tutorial/progress-template.md +74 -74
- package/reference/claude-config/skills/tutorial/technical.md +1303 -1303
- package/reference/claude-config/skills/tutorial/vibe-coder.md +890 -890
- package/reference/claude-config/sync-notes/2026-04-22-git-sync-and-sync-notes.md +27 -27
- package/reference/claude-config/sync-notes/2026-04-22-lead-gen-deliverability-removal.md +30 -30
- package/reference/claude-config/sync-notes/2026-04-24-test-utils-and-template-tests.md +73 -73
- package/reference/claude-config/sync-notes/2026-04-24-ui-consolidation-and-sdk-cli-train.md +86 -86
- package/reference/claude-config/sync-notes/2026-04-25-auth-role-system-and-settings-roles.md +55 -55
- package/reference/claude-config/sync-notes/2026-04-27-crm-hitl-action-layer-cutover.md +97 -97
- package/reference/claude-config/sync-notes/2026-04-27-lead-gen-substrate-train.md +112 -112
- package/reference/claude-config/sync-notes/2026-04-29-crm-state-and-lead-gen-processing-status.md +93 -93
- package/reference/claude-config/sync-notes/2026-05-02-crm-ownership-next-action.md +58 -58
- package/reference/claude-config/sync-notes/2026-05-02-template-hardcode-workos-config.md +56 -56
- package/reference/claude-config/sync-notes/2026-05-04-elevasis-workspace.md +71 -71
- package/reference/claude-config/sync-notes/2026-05-04-knowledge-bundle.md +83 -83
- package/reference/claude-config/sync-notes/2026-05-04-template-skills-run-ui-and-tutorial.md +59 -59
- package/reference/claude-config/sync-notes/2026-05-05-list-builder.md +42 -42
- package/reference/claude-config/sync-notes/2026-05-06-crm-spine.md +60 -60
- package/reference/claude-config/sync-notes/2026-05-06-sdk-changes-release-train.md +37 -37
- package/reference/claude-config/sync-notes/2026-05-07-sdk-changes-release-train.md +34 -34
- package/reference/claude-config/sync-notes/2026-05-08-resource-governance-scaffold-guidance.md +38 -38
- package/reference/claude-config/sync-notes/2026-05-09-clients-domain.md +32 -32
- package/reference/claude-config/sync-notes/2026-05-09-command-system.md +33 -33
- package/reference/claude-config/sync-notes/2026-05-09-resource-governance-and-misc.md +69 -69
- package/reference/claude-config/sync-notes/2026-05-12-sdk-ready-release-train.md +30 -30
- package/reference/claude-config/sync-notes/2026-05-14-organization-model-ontology-refactor.md +42 -0
- package/reference/claude-config/sync-notes/README.md +43 -43
- package/reference/cli.mdx +808 -808
- package/reference/concepts.mdx +146 -146
- package/reference/deployment/api.mdx +297 -297
- package/reference/deployment/command-center.mdx +209 -209
- package/reference/deployment/index.mdx +195 -195
- package/reference/deployment/provided-features.mdx +107 -107
- package/reference/deployment/ui-execution.mdx +250 -250
- package/reference/examples/organization-model.ts +146 -83
- package/reference/framework/agent.mdx +156 -156
- package/reference/framework/index.mdx +195 -195
- package/reference/framework/interaction-guidance.mdx +182 -182
- package/reference/framework/memory.mdx +326 -326
- package/reference/framework/project-structure.mdx +282 -282
- package/reference/framework/tutorial-system.mdx +135 -135
- package/reference/getting-started.mdx +142 -142
- package/reference/index.mdx +106 -106
- package/reference/packages/core/src/README.md +14 -14
- package/reference/packages/core/src/business/README.md +2 -2
- package/reference/packages/core/src/knowledge/README.md +32 -32
- package/reference/packages/core/src/organization-model/README.md +149 -149
- package/reference/packages/core/src/test-utils/README.md +37 -37
- package/reference/packages/ui/src/api/README.md +18 -18
- package/reference/packages/ui/src/app/README.md +24 -24
- package/reference/packages/ui/src/auth/README.md +18 -18
- package/reference/packages/ui/src/components/README.md +24 -24
- package/reference/packages/ui/src/execution/README.md +16 -16
- package/reference/packages/ui/src/features/README.md +28 -28
- package/reference/packages/ui/src/graph/README.md +16 -16
- package/reference/packages/ui/src/hooks/README.md +23 -23
- package/reference/packages/ui/src/initialization/README.md +19 -19
- package/reference/packages/ui/src/knowledge/README.md +31 -31
- package/reference/packages/ui/src/organization/README.md +18 -18
- package/reference/packages/ui/src/profile/README.md +19 -19
- package/reference/packages/ui/src/provider/README.md +32 -32
- package/reference/packages/ui/src/router/README.md +18 -18
- package/reference/packages/ui/src/sse/README.md +13 -13
- package/reference/packages/ui/src/test-utils/README.md +7 -7
- package/reference/packages/ui/src/theme/README.md +23 -23
- package/reference/packages/ui/src/theme/presets/README.md +19 -19
- package/reference/packages/ui/src/types/README.md +16 -16
- package/reference/packages/ui/src/utils/README.md +18 -18
- package/reference/packages/ui/src/zustand/README.md +18 -18
- package/reference/platform-tools/adapters-integration.mdx +301 -301
- package/reference/platform-tools/adapters-platform.mdx +553 -553
- package/reference/platform-tools/index.mdx +217 -217
- package/reference/platform-tools/type-safety.mdx +82 -82
- package/reference/resources/index.mdx +349 -349
- package/reference/resources/patterns.mdx +449 -449
- package/reference/resources/types.mdx +116 -116
- package/reference/roadmap.mdx +165 -165
- package/reference/runtime.mdx +173 -173
- package/reference/scaffold/core/organization-graph.mdx +110 -90
- package/reference/scaffold/core/organization-model.mdx +226 -219
- package/reference/scaffold/index.mdx +67 -67
- package/reference/scaffold/operations/propagation-pipeline.md +77 -77
- package/reference/scaffold/operations/scaffold-maintenance.md +12 -12
- package/reference/scaffold/operations/workflow-recipes.md +138 -138
- package/reference/scaffold/recipes/add-a-feature.md +308 -88
- package/reference/scaffold/recipes/add-a-resource.md +134 -110
- package/reference/scaffold/recipes/customize-knowledge-browser.md +5 -5
- package/reference/scaffold/recipes/customize-organization-model.md +273 -138
- package/reference/scaffold/recipes/extend-a-base-entity.md +8 -8
- package/reference/scaffold/recipes/extend-crm.md +3 -3
- package/reference/scaffold/recipes/extend-lead-gen.md +400 -400
- package/reference/scaffold/recipes/gate-by-feature-or-admin.md +118 -118
- package/reference/scaffold/recipes/index.md +46 -46
- package/reference/scaffold/recipes/query-the-knowledge-graph.md +197 -170
- package/reference/scaffold/reference/contracts.md +2101 -2096
- package/reference/scaffold/reference/glossary.md +76 -76
- package/reference/scaffold/ui/composition-extensibility.mdx +233 -233
- package/reference/scaffold/ui/customization.md +243 -243
- package/reference/scaffold/ui/feature-flags-and-gating.md +46 -46
- package/reference/scaffold/ui/feature-shell.mdx +72 -72
- package/reference/scaffold/ui/recipes.md +221 -214
- package/reference/spine/spine-primer.md +96 -96
- package/reference/templates/index.mdx +47 -47
- 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.
|