@elevasis/sdk 0.5.11 → 0.5.13
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 +276 -298
- package/dist/index.d.ts +13 -256
- package/dist/index.js +10 -38
- package/dist/templates.js +193 -187
- package/dist/types/worker/adapters/index.d.ts +0 -1
- package/dist/worker/index.js +126 -75
- package/package.json +1 -1
- package/reference/_navigation.md +13 -57
- package/reference/concepts.mdx +203 -0
- package/reference/deployment/{command-center-ui.mdx → command-center.mdx} +229 -151
- package/reference/deployment/index.mdx +158 -153
- package/reference/framework/agent.mdx +168 -151
- package/reference/framework/index.mdx +182 -103
- package/reference/framework/memory.mdx +347 -347
- package/reference/framework/project-structure.mdx +3 -13
- package/reference/framework/tutorial-system.mdx +253 -0
- package/reference/{getting-started/index.mdx → getting-started.mdx} +6 -7
- package/reference/index.mdx +117 -114
- package/reference/platform-tools/adapters.mdx +175 -32
- package/reference/platform-tools/index.mdx +354 -195
- package/reference/resources/index.mdx +5 -0
- package/reference/{roadmap/index.mdx → roadmap.mdx} +1 -1
- package/reference/{runtime/index.mdx → runtime.mdx} +196 -141
- package/dist/types/worker/adapters/trello.d.ts +0 -14
- package/reference/concepts/index.mdx +0 -203
- package/reference/deployment/command-view.mdx +0 -154
- package/reference/framework/documentation.mdx +0 -92
- package/reference/platform-tools/examples.mdx +0 -170
- package/reference/runtime/limits.mdx +0 -75
- package/reference/security/credentials.mdx +0 -141
- /package/reference/{cli/index.mdx → cli.mdx} +0 -0
- /package/reference/{developer → framework}/interaction-guidance.mdx +0 -0
- /package/reference/{troubleshooting/common-errors.mdx → troubleshooting.mdx} +0 -0
package/dist/templates.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
// package.json
|
|
2
2
|
|
|
3
3
|
// src/cli/commands/templates/core/workspace.ts
|
|
4
|
-
var TEMPLATE_VERSION =
|
|
4
|
+
var TEMPLATE_VERSION = 27;
|
|
5
5
|
function configTemplate() {
|
|
6
6
|
return `import type { ElevasConfig } from '@elevasis/sdk'
|
|
7
7
|
|
|
8
8
|
export default {
|
|
9
9
|
templateVersion: ${TEMPLATE_VERSION},
|
|
10
|
-
// defaultStatus: 'dev', // Default status for new resources ('dev' | '
|
|
10
|
+
// defaultStatus: 'dev', // Default status for new resources ('dev' | 'prod')
|
|
11
11
|
// dev: { port: 5170 }, // Local API port (internal development only)
|
|
12
12
|
} satisfies ElevasConfig
|
|
13
13
|
`;
|
|
@@ -31,26 +31,30 @@ ui/dist/
|
|
|
31
31
|
|
|
32
32
|
// src/cli/commands/templates/core/claude.ts
|
|
33
33
|
function claudeSettingsTemplate() {
|
|
34
|
-
return JSON.stringify(
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
34
|
+
return JSON.stringify(
|
|
35
|
+
{
|
|
36
|
+
autoCompact: false,
|
|
37
|
+
statusLine: {
|
|
38
|
+
type: "command",
|
|
39
|
+
command: "node .claude/scripts/statusline-command.js"
|
|
40
|
+
},
|
|
41
|
+
hooks: {
|
|
42
|
+
PreToolUse: [
|
|
43
|
+
{
|
|
44
|
+
matcher: "Write|Edit|MultiEdit|Bash",
|
|
45
|
+
hooks: [
|
|
46
|
+
{
|
|
47
|
+
type: "command",
|
|
48
|
+
command: "node .claude/hooks/enforce-sdk-boundary.mjs"
|
|
49
|
+
}
|
|
50
|
+
]
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
}
|
|
39
54
|
},
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
matcher: "Write|Edit|MultiEdit|Bash",
|
|
44
|
-
hooks: [
|
|
45
|
-
{
|
|
46
|
-
type: "command",
|
|
47
|
-
command: "node .claude/hooks/enforce-sdk-boundary.mjs"
|
|
48
|
-
}
|
|
49
|
-
]
|
|
50
|
-
}
|
|
51
|
-
]
|
|
52
|
-
}
|
|
53
|
-
}, null, 2) + "\n";
|
|
55
|
+
null,
|
|
56
|
+
2
|
|
57
|
+
) + "\n";
|
|
54
58
|
}
|
|
55
59
|
function claudeStatuslineScriptTemplate() {
|
|
56
60
|
return `#!/usr/bin/env node
|
|
@@ -274,13 +278,18 @@ All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
|
|
|
274
278
|
|
|
275
279
|
## Elevasis CLI
|
|
276
280
|
|
|
277
|
-
**MANDATORY:** Use the \`elevasis-sdk\` CLI for all execution/platform operations -- never \`
|
|
281
|
+
**MANDATORY:** Use the \`elevasis-sdk\` CLI for all execution/platform operations -- never \`curl\` or any other tool.
|
|
282
|
+
|
|
283
|
+
Use pnpm scripts for check and deploy (they resolve the local binary automatically):
|
|
284
|
+
|
|
285
|
+
- \`pnpm run check\` -- validate resource definitions without deploying
|
|
286
|
+
- \`pnpm run deploy\` -- deploy to the platform
|
|
287
|
+
|
|
288
|
+
Use \`pnpm exec elevasis-sdk\` for runtime commands (resolves the locally installed binary):
|
|
278
289
|
|
|
279
|
-
- \`elevasis-sdk exec <resource-id> --input '{...}'\` -- run a resource synchronously
|
|
280
|
-
- \`elevasis-sdk exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
|
|
281
|
-
- \`elevasis-sdk execution <resource-id> <execution-id>\` -- inspect execution detail
|
|
282
|
-
- \`elevasis-sdk check\` -- validate resource definitions without deploying
|
|
283
|
-
- \`elevasis-sdk deploy\` -- deploy to the platform
|
|
290
|
+
- \`pnpm exec elevasis-sdk exec <resource-id> --input '{...}'\` -- run a resource synchronously
|
|
291
|
+
- \`pnpm exec elevasis-sdk exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
|
|
292
|
+
- \`pnpm exec elevasis-sdk execution <resource-id> <execution-id>\` -- inspect execution detail
|
|
284
293
|
|
|
285
294
|
Organization is derived from your API key -- no org prefix needed in the resource ID.
|
|
286
295
|
For full CLI reference: \`reference/cli/index.mdx\`
|
|
@@ -308,7 +317,8 @@ When an error occurs:
|
|
|
308
317
|
- Import from \`@elevasis/sdk-ui\`, never from \`@elevasis/sdk\` or \`@repo/ui\`
|
|
309
318
|
- Dev server runs on port 5100: \`cd ui && pnpm dev\`
|
|
310
319
|
- Set \`VITE_WORKOS_CLIENT_ID\` in \`ui/.env\` before running
|
|
311
|
-
- \`
|
|
320
|
+
- \`ElevasisCoreProvider\` (headless, no Mantine dependency) is pre-configured in \`ui/src/App.tsx\` with \`auth={{ mode: 'oauth', clientId, redirectUri }}\`, \`apiUrl="http://localhost:5170"\`, and \`theme={{ colorScheme: 'dark', preset: 'default' }}\`
|
|
321
|
+
- To use pre-built Mantine components from \`@elevasis/sdk-ui\`, switch to \`ElevasisUIProvider\` and install \`@mantine/core\` and \`@mantine/hooks\`
|
|
312
322
|
- OAuth redirect is handled by the \`AuthRedirect\` component at \`/auth-redirect\` -- it uses \`useAuthContext()\` from \`@elevasis/sdk-ui/auth\` and navigates home once \`user\` is set
|
|
313
323
|
- API must be running on port 5170 for the UI to work (\`pnpm --filter api dev\` from the platform monorepo)` : ""}
|
|
314
324
|
|
|
@@ -432,32 +442,34 @@ Example (first time, no progress):
|
|
|
432
442
|
Elevasis Tutorial
|
|
433
443
|
==================
|
|
434
444
|
|
|
435
|
-
|
|
436
|
-
1 Welcome & Orientation
|
|
437
|
-
2
|
|
438
|
-
3
|
|
439
|
-
4
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
8
|
|
446
|
-
9
|
|
447
|
-
10
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
17
|
|
457
|
-
18
|
|
458
|
-
19
|
|
459
|
-
|
|
460
|
-
|
|
445
|
+
INTRODUCTION 0/4
|
|
446
|
+
1 Welcome & Orientation [ ]
|
|
447
|
+
2 How This Workspace Works [ ]
|
|
448
|
+
3 The /meta Command [ ]
|
|
449
|
+
4 /work and /docs [ ]
|
|
450
|
+
|
|
451
|
+
CORE CONCEPTS 0/6
|
|
452
|
+
5 Your First Custom Workflow [ ]
|
|
453
|
+
6 Understanding Data (Schemas) [ ]
|
|
454
|
+
7 Using Platform Tools [ ]
|
|
455
|
+
8 Multi-Step Workflows [ ]
|
|
456
|
+
9 Decision Points [ ]
|
|
457
|
+
10 Going to Production [ ]
|
|
458
|
+
|
|
459
|
+
ADVANCED MODULES 0/9
|
|
460
|
+
11 Human-in-the-Loop [ ]
|
|
461
|
+
12 Task Scheduling [ ]
|
|
462
|
+
13 Notification System [ ]
|
|
463
|
+
14 Real-World Integrations [ ]
|
|
464
|
+
15 Error Handling Mastery [ ]
|
|
465
|
+
16 Advanced Workflows [ ]
|
|
466
|
+
17 Resource Composition [ ]
|
|
467
|
+
18 LLM Integration [ ]
|
|
468
|
+
19 AI Agents [ ]
|
|
469
|
+
|
|
470
|
+
ADVANCED WORKSPACE 0/2
|
|
471
|
+
20 Rules, Memory, and Customization [ ]
|
|
472
|
+
21 Template Lifecycle [ ]
|
|
461
473
|
|
|
462
474
|
Pick a number to start.
|
|
463
475
|
\`\`\`
|
|
@@ -470,7 +482,7 @@ indicators from completed/current state. \`"status"\` -> show the same table.
|
|
|
470
482
|
1. Read \`.claude/memory/tutorial-progress.md\`
|
|
471
483
|
2. Show the full menu table (## Menu) with progress filled in
|
|
472
484
|
3. User picks a number -> start or resume that lesson or module directly
|
|
473
|
-
4. After
|
|
485
|
+
4. After user confirms readiness: mark done in progress file, show updated menu table
|
|
474
486
|
5. All 21 items complete -> congratulate, suggest exploring docs/ or /work
|
|
475
487
|
|
|
476
488
|
## Lesson Flow
|
|
@@ -480,12 +492,12 @@ Each lesson follows this flow:
|
|
|
480
492
|
2. Explain the concept (read docs per skill level, adapt to user)
|
|
481
493
|
3. Guide user to build or modify something (agent writes all code for automation: none)
|
|
482
494
|
4. Verify it works (CLI primary for all levels; Command Center for visual review -- Command View, Execution Logs)
|
|
483
|
-
5. Celebrate success,
|
|
484
|
-
6.
|
|
495
|
+
5. Celebrate success and ask: "Any questions, or ready to continue?"
|
|
496
|
+
6. Once the user confirms, record observations in \`.claude/memory/tutorial-progress.md\`
|
|
485
497
|
|
|
486
498
|
## Lessons
|
|
487
499
|
|
|
488
|
-
**
|
|
500
|
+
**Item 1: Welcome & Orientation**
|
|
489
501
|
|
|
490
502
|
When automation is none:
|
|
491
503
|
Skip the file tour. Start with what Elevasis does for their business -- use analogies
|
|
@@ -505,7 +517,108 @@ main pages: Command View (resource graph), Execution Logs.
|
|
|
505
517
|
Point out the echo workflow node in Command View.
|
|
506
518
|
Observation focus: cloud deployment model, UI navigation comfort.
|
|
507
519
|
|
|
508
|
-
**
|
|
520
|
+
**Item 2: How This Workspace Works**
|
|
521
|
+
|
|
522
|
+
When automation is none:
|
|
523
|
+
"This workspace comes with a built-in assistant that knows your project, your tools,
|
|
524
|
+
and your goals. Let me show you how it's set up." Open CLAUDE.md and explain in
|
|
525
|
+
plain terms: it's the agent's instruction sheet. Point out the commands in the
|
|
526
|
+
Commands table. Show /meta, /tutorial, /work. Explain the creds skill as
|
|
527
|
+
"the assistant automatically helps when you mention API keys." Tour the memory folder
|
|
528
|
+
at a high level -- "this is where the agent stores what it learns about your project."
|
|
529
|
+
Verify: Ask the user a question about their business goal and show how the agent
|
|
530
|
+
references their profile in the answer.
|
|
531
|
+
Observation focus: agent-as-assistant concept, CLAUDE.md as instruction sheet.
|
|
532
|
+
|
|
533
|
+
When automation is low-code:
|
|
534
|
+
Read CLAUDE.md and walk through each section. Explain: what the agent reads on
|
|
535
|
+
session start, how the navigation table works, what the Skills section means.
|
|
536
|
+
Explain the four commands briefly. Show that the agent has memory: open
|
|
537
|
+
\`.claude/memory/profile/skills.md\` and show their own profile -- "every session,
|
|
538
|
+
the agent reads this and adapts." Explain the initialized flag.
|
|
539
|
+
Verify: Run /meta to see project status.
|
|
540
|
+
Observation focus: memory system concept, session initialization flow.
|
|
541
|
+
|
|
542
|
+
When automation is custom:
|
|
543
|
+
Read CLAUDE.md in full. Explain the session initialization sequence: CLAUDE.md ->
|
|
544
|
+
navigation table -> memory files -> context loading. Walk through: Commands section
|
|
545
|
+
(4 commands + creds skill), Rules section (auto-loaded based on file paths), Skills
|
|
546
|
+
section (auto-triggered by content patterns). Point out the initialized flag and
|
|
547
|
+
explain how /meta init set it.
|
|
548
|
+
Verify: Run /meta to see project status; observe which fields it reports.
|
|
549
|
+
Observation focus: initialization model, command-vs-rule-vs-skill distinction.
|
|
550
|
+
|
|
551
|
+
**Item 3: The /meta Command**
|
|
552
|
+
|
|
553
|
+
When automation is none:
|
|
554
|
+
"Think of /meta as your project dashboard -- it shows what's healthy and what needs
|
|
555
|
+
attention." Run /meta (no arguments) and narrate the output in plain language: what
|
|
556
|
+
each field means. Explain /meta fix as "the agent tidies up and applies updates."
|
|
557
|
+
Explain /meta deploy as "the agent publishes your changes in one step." Briefly note
|
|
558
|
+
/meta health shows what happened when something goes wrong.
|
|
559
|
+
Verify: Run /meta (no arguments). Narrate the output together.
|
|
560
|
+
Observation focus: project lifecycle concept, dashboard reading.
|
|
561
|
+
|
|
562
|
+
When automation is low-code:
|
|
563
|
+
Show all /meta operations with their purpose. Map to familiar concepts: /meta fix is
|
|
564
|
+
like "repair this Zap" in Zapier; /meta deploy is a one-command publish pipeline.
|
|
565
|
+
Walk through the /meta (no-args) output: template version (SDK template your workspace
|
|
566
|
+
uses), SDK version (installed package), profile summary, drift check.
|
|
567
|
+
Verify: Run /meta and interpret each field together.
|
|
568
|
+
Observation focus: deploy pipeline understanding, version tracking.
|
|
569
|
+
|
|
570
|
+
When automation is custom:
|
|
571
|
+
Read \`.claude/commands/meta.md\`. Walk through each operation: init (first-run setup
|
|
572
|
+
with assessment), (no-args) (status dashboard), fix (drift repair + SDK upgrade +
|
|
573
|
+
rules health), deploy (7-step pipeline: check, typecheck, docs, git, deploy,
|
|
574
|
+
project-map, verify), health (runtime diagnostics). Explain the merge strategy for
|
|
575
|
+
CLAUDE.md and commands. Note the template access model: templates read from
|
|
576
|
+
@elevasis/sdk/templates subpath.
|
|
577
|
+
Verify: Run /meta to see project status. Identify what a version mismatch looks like.
|
|
578
|
+
Observation focus: full lifecycle coverage, pipeline internals.
|
|
579
|
+
|
|
580
|
+
**Item 4: /work and /docs**
|
|
581
|
+
|
|
582
|
+
When automation is none:
|
|
583
|
+
"You can ask the assistant to track work across conversations. When you start something
|
|
584
|
+
complex, use /work create to save your place. Next session, /work resume picks up where
|
|
585
|
+
you left off." Walk through the concept without deep command details. Then introduce /docs:
|
|
586
|
+
"When a task is finished, /work complete moves it to docs/ permanently. After that, /docs
|
|
587
|
+
helps you find and read what's there -- like a notebook for your project." Run /docs (no
|
|
588
|
+
args) to show the docs/ overview together.
|
|
589
|
+
Verify: Create a task with \`/work create "practice task"\`, then run /work to see it listed.
|
|
590
|
+
Then run /docs to see the docs/ structure.
|
|
591
|
+
Observation focus: persistence concept, cross-session continuity, docs as permanent notes.
|
|
592
|
+
|
|
593
|
+
When automation is low-code:
|
|
594
|
+
Show /work operations: create (task doc with frontmatter + sections), save (updates
|
|
595
|
+
Progress + Resume Context), resume (loads context for next session), complete (moves
|
|
596
|
+
to permanent docs/).
|
|
597
|
+
Then introduce /docs: "/docs is for permanent knowledge -- things that don't expire. Use
|
|
598
|
+
/docs create to document a workflow or integration. Use /docs verify to check if your
|
|
599
|
+
docs match the current code." Explain the boundary: /work manages in-progress/, /docs
|
|
600
|
+
manages permanent docs/.
|
|
601
|
+
Verify: Create a task with \`/work create "practice task"\`, run /work save, inspect the
|
|
602
|
+
file. Then run /docs to browse docs/.
|
|
603
|
+
Observation focus: task tracking workflow, /work vs /docs separation.
|
|
604
|
+
|
|
605
|
+
When automation is custom:
|
|
606
|
+
Read \`.claude/commands/work.md\`. Full /work coverage:
|
|
607
|
+
/work create (kebab-case filename, frontmatter with status, Objective/Plan/Progress/
|
|
608
|
+
Resume Context sections), /work save (Progress + Resume Context update), /work resume
|
|
609
|
+
(multiple-task disambiguation), /work complete (moves to final location).
|
|
610
|
+
Then read \`.claude/commands/docs.md\`. Cover /docs operations:
|
|
611
|
+
/docs (default): browse permanent docs/, categorized with read-only auto-generated files
|
|
612
|
+
separate; /docs create: interview-driven, resource-aware doc creation from src/ code
|
|
613
|
+
analysis; /docs verify: cross-references resource IDs, schema fields, platform tools in
|
|
614
|
+
docs against src/ -- standalone analog of /meta fix step 5.
|
|
615
|
+
Explain the relationship: /work owns docs/in-progress/ (task lifecycle), /work complete
|
|
616
|
+
moves docs to permanent location, /docs browses and verifies what's there.
|
|
617
|
+
Verify: Create a task doc, save progress, run /work complete to move it. Then run /docs
|
|
618
|
+
to see it in the permanent docs/ listing.
|
|
619
|
+
Observation focus: task doc anatomy, /work-to-/docs handoff, docs verification as standalone tool.
|
|
620
|
+
|
|
621
|
+
**Item 5: Your First Custom Workflow**
|
|
509
622
|
|
|
510
623
|
When automation is none:
|
|
511
624
|
Frame the workflow as "a recipe." Use plain language: "settings" not "config",
|
|
@@ -522,7 +635,7 @@ Runner in the Command Center, find the echo workflow, fill out the form, and
|
|
|
522
635
|
run it from the UI. Compare the result to the CLI output.
|
|
523
636
|
Observation focus: deployment-to-execution loop, TypeScript syntax comfort.
|
|
524
637
|
|
|
525
|
-
**
|
|
638
|
+
**Item 6: Understanding Data (Schemas)**
|
|
526
639
|
|
|
527
640
|
When automation is none:
|
|
528
641
|
Frame as "What information does your automation need?" Describe types in plain English:
|
|
@@ -545,7 +658,7 @@ run with \`elevasis-sdk exec --input '{...}'\` to verify the schema and inspect
|
|
|
545
658
|
the execution output.
|
|
546
659
|
Observation focus: schema-to-input mapping, optional fields, types.
|
|
547
660
|
|
|
548
|
-
**
|
|
661
|
+
**Item 7: Using Platform Tools**
|
|
549
662
|
|
|
550
663
|
When automation is none:
|
|
551
664
|
Frame as "Connecting your automation to a service you already use." Pick ONE
|
|
@@ -567,7 +680,7 @@ If using the approval tool, note that pending requests surface in Command Queue.
|
|
|
567
680
|
See reference/platform-tools/adapters.mdx for full API.
|
|
568
681
|
Observation focus: credential setup (CLI + UI), async/await.
|
|
569
682
|
|
|
570
|
-
**
|
|
683
|
+
**Item 8: Multi-Step Workflows**
|
|
571
684
|
|
|
572
685
|
When automation is none:
|
|
573
686
|
Frame as "Step 1 passes its result to Step 2, like a relay race." Command View is
|
|
@@ -583,7 +696,7 @@ relationship edges between resources. Explain how declared relationships map
|
|
|
583
696
|
to the visual graph.
|
|
584
697
|
Observation focus: data flow reasoning, relationship visualization.
|
|
585
698
|
|
|
586
|
-
**
|
|
699
|
+
**Item 9: Decision Points**
|
|
587
700
|
|
|
588
701
|
When automation is none:
|
|
589
702
|
Frame as "If the customer is VIP, do this -- otherwise, do that." No StepType.CONDITIONAL
|
|
@@ -599,7 +712,7 @@ Execution Logs in the Command Center, filter by the resource, and show how
|
|
|
599
712
|
each path appears in the log detail (step trace, input/output).
|
|
600
713
|
Observation focus: branching logic reasoning, execution log interpretation.
|
|
601
714
|
|
|
602
|
-
**
|
|
715
|
+
**Item 10: Going to Production**
|
|
603
716
|
|
|
604
717
|
When automation is none:
|
|
605
718
|
Frame as "draft vs live" not "dev vs production." Error handling: "when something
|
|
@@ -618,7 +731,7 @@ Observation focus: readiness for independent operation (CLI + UI).
|
|
|
618
731
|
|
|
619
732
|
## Module Menu
|
|
620
733
|
|
|
621
|
-
Module order (items
|
|
734
|
+
Module order (items 11-19 in the main menu): hitl, schedules, notifications,
|
|
622
735
|
integrations, error-handling, workflows, composition, llm, agents.
|
|
623
736
|
|
|
624
737
|
After completing a module, show the updated full menu table (## Menu).
|
|
@@ -703,114 +816,14 @@ Compare agent vs workflow for a task.
|
|
|
703
816
|
Key concepts: agent definition, tool registration, LLM tool calling, execution trace.
|
|
704
817
|
Verify: Run agent with \`elevasis-sdk exec\`, review tool call trace in Execution Logs.
|
|
705
818
|
|
|
706
|
-
##
|
|
707
|
-
|
|
708
|
-
The Meta-Framework track teaches you how the Claude Code workspace works -- the commands,
|
|
709
|
-
rules, memory system, and customization model. It is independent of the core path and
|
|
710
|
-
can be taken in any order.
|
|
711
|
-
|
|
712
|
-
**MF1: The Agent Framework -- How This Workspace Works**
|
|
713
|
-
|
|
714
|
-
When automation is none:
|
|
715
|
-
"This workspace comes with a built-in assistant that knows your project, your tools,
|
|
716
|
-
and your goals. Let me show you how it's set up." Open CLAUDE.md and explain in
|
|
717
|
-
plain terms: it's the agent's instruction sheet. Point out the commands in the
|
|
718
|
-
Commands table. Show /meta, /tutorial, /work. Explain the creds skill as
|
|
719
|
-
"the assistant automatically helps when you mention API keys." Tour the memory folder
|
|
720
|
-
at a high level -- "this is where the agent stores what it learns about your project."
|
|
721
|
-
Verify: Ask the user a question about their business goal and show how the agent
|
|
722
|
-
references their profile in the answer.
|
|
723
|
-
Observation focus: agent-as-assistant concept, CLAUDE.md as instruction sheet.
|
|
724
|
-
|
|
725
|
-
When automation is low-code:
|
|
726
|
-
Read CLAUDE.md and walk through each section. Explain: what the agent reads on
|
|
727
|
-
session start, how the navigation table works, what the Skills section means.
|
|
728
|
-
Explain the four commands briefly. Show that the agent has memory: open
|
|
729
|
-
\`.claude/memory/profile/skills.md\` and show their own profile -- "every session,
|
|
730
|
-
the agent reads this and adapts." Explain the initialized flag.
|
|
731
|
-
Verify: Run /meta to see project status.
|
|
732
|
-
Observation focus: memory system concept, session initialization flow.
|
|
733
|
-
|
|
734
|
-
When automation is custom:
|
|
735
|
-
Read CLAUDE.md in full. Explain the session initialization sequence: CLAUDE.md ->
|
|
736
|
-
navigation table -> memory files -> context loading. Walk through: Commands section
|
|
737
|
-
(4 commands + creds skill), Rules section (auto-loaded based on file paths), Skills
|
|
738
|
-
section (auto-triggered by content patterns). Point out the initialized flag and
|
|
739
|
-
explain how /meta init set it.
|
|
740
|
-
Verify: Run /meta to see project status; observe which fields it reports.
|
|
741
|
-
Observation focus: initialization model, command-vs-rule-vs-skill distinction.
|
|
742
|
-
|
|
743
|
-
**MF2: The /meta Command -- Project Lifecycle**
|
|
744
|
-
|
|
745
|
-
When automation is none:
|
|
746
|
-
"Think of /meta as your project dashboard -- it shows what's healthy and what needs
|
|
747
|
-
attention." Run /meta (no arguments) and narrate the output in plain language: what
|
|
748
|
-
each field means. Explain /meta fix as "the agent tidies up and applies updates."
|
|
749
|
-
Explain /meta deploy as "the agent publishes your changes in one step." Briefly note
|
|
750
|
-
/meta health shows what happened when something goes wrong.
|
|
751
|
-
Verify: Run /meta (no arguments). Narrate the output together.
|
|
752
|
-
Observation focus: project lifecycle concept, dashboard reading.
|
|
753
|
-
|
|
754
|
-
When automation is low-code:
|
|
755
|
-
Show all /meta operations with their purpose. Map to familiar concepts: /meta fix is
|
|
756
|
-
like "repair this Zap" in Zapier; /meta deploy is a one-command publish pipeline.
|
|
757
|
-
Walk through the /meta (no-args) output: template version (SDK template your workspace
|
|
758
|
-
uses), SDK version (installed package), profile summary, drift check.
|
|
759
|
-
Verify: Run /meta and interpret each field together.
|
|
760
|
-
Observation focus: deploy pipeline understanding, version tracking.
|
|
761
|
-
|
|
762
|
-
When automation is custom:
|
|
763
|
-
Read \`.claude/commands/meta.md\`. Walk through each operation: init (first-run setup
|
|
764
|
-
with assessment), (no-args) (status dashboard), fix (drift repair + SDK upgrade +
|
|
765
|
-
rules health), deploy (7-step pipeline: check, typecheck, docs, git, deploy,
|
|
766
|
-
project-map, verify), health (runtime diagnostics). Explain the merge strategy for
|
|
767
|
-
CLAUDE.md and commands. Note the template access model: templates read from
|
|
768
|
-
@elevasis/sdk/templates subpath.
|
|
769
|
-
Verify: Run /meta to see project status. Identify what a version mismatch looks like.
|
|
770
|
-
Observation focus: full lifecycle coverage, pipeline internals.
|
|
819
|
+
## Advanced Workspace Track
|
|
771
820
|
|
|
772
|
-
|
|
821
|
+
The Advanced Workspace track teaches power-user workspace customization and maintenance --
|
|
822
|
+
rules, memory, and the template lifecycle. Independent of the core path; can be taken at any time.
|
|
773
823
|
|
|
774
|
-
|
|
775
|
-
"You can ask the assistant to track work across conversations. When you start something
|
|
776
|
-
complex, use /work create to save your place. Next session, /work resume picks up where
|
|
777
|
-
you left off." Walk through the concept without deep command details. Then introduce /docs:
|
|
778
|
-
"When a task is finished, /work complete moves it to docs/ permanently. After that, /docs
|
|
779
|
-
helps you find and read what's there -- like a notebook for your project." Run /docs (no
|
|
780
|
-
args) to show the docs/ overview together.
|
|
781
|
-
Verify: Create a task with \`/work create "practice task"\`, then run /work to see it listed.
|
|
782
|
-
Then run /docs to see the docs/ structure.
|
|
783
|
-
Observation focus: persistence concept, cross-session continuity, docs as permanent notes.
|
|
824
|
+
Each item follows the same flow as core lessons: announce, explain per skill level, verify, record observations.
|
|
784
825
|
|
|
785
|
-
|
|
786
|
-
Show /work operations: create (task doc with frontmatter + sections), save (updates
|
|
787
|
-
Progress + Resume Context), resume (loads context for next session), complete (moves
|
|
788
|
-
to permanent docs/).
|
|
789
|
-
Then introduce /docs: "/docs is for permanent knowledge -- things that don't expire. Use
|
|
790
|
-
/docs create to document a workflow or integration. Use /docs verify to check if your
|
|
791
|
-
docs match the current code." Explain the boundary: /work manages in-progress/, /docs
|
|
792
|
-
manages permanent docs/.
|
|
793
|
-
Verify: Create a task with \`/work create "practice task"\`, run /work save, inspect the
|
|
794
|
-
file. Then run /docs to browse docs/.
|
|
795
|
-
Observation focus: task tracking workflow, /work vs /docs separation.
|
|
796
|
-
|
|
797
|
-
When automation is custom:
|
|
798
|
-
Read \`.claude/commands/work.md\`. Full /work coverage:
|
|
799
|
-
/work create (kebab-case filename, frontmatter with status, Objective/Plan/Progress/
|
|
800
|
-
Resume Context sections), /work save (Progress + Resume Context update), /work resume
|
|
801
|
-
(multiple-task disambiguation), /work complete (moves to final location).
|
|
802
|
-
Then read \`.claude/commands/docs.md\`. Cover /docs operations:
|
|
803
|
-
/docs (default): browse permanent docs/, categorized with read-only auto-generated files
|
|
804
|
-
separate; /docs create: interview-driven, resource-aware doc creation from src/ code
|
|
805
|
-
analysis; /docs verify: cross-references resource IDs, schema fields, platform tools in
|
|
806
|
-
docs against src/ -- standalone analog of /meta fix step 5.
|
|
807
|
-
Explain the relationship: /work owns docs/in-progress/ (task lifecycle), /work complete
|
|
808
|
-
moves docs to permanent location, /docs browses and verifies what's there.
|
|
809
|
-
Verify: Create a task doc, save progress, run /work complete to move it. Then run /docs
|
|
810
|
-
to see it in the permanent docs/ listing.
|
|
811
|
-
Observation focus: task doc anatomy, /work-to-/docs handoff, docs verification as standalone tool.
|
|
812
|
-
|
|
813
|
-
**MF4: Rules, Memory, and Customization**
|
|
826
|
+
**Item 20: Rules, Memory, and Customization**
|
|
814
827
|
|
|
815
828
|
When automation is none:
|
|
816
829
|
"The assistant has a set of reminders specific to your project. Over time, when it
|
|
@@ -841,7 +854,7 @@ workspace-patterns.md. Walk through how to add a new rule.
|
|
|
841
854
|
Verify: Read \`.claude/rules/workspace-patterns.md\`. Add a sample rule entry together.
|
|
842
855
|
Observation focus: MANAGED vs INIT_ONLY lifecycle, rule authoring, memory layout.
|
|
843
856
|
|
|
844
|
-
**
|
|
857
|
+
**Item 21: Template Lifecycle**
|
|
845
858
|
|
|
846
859
|
When automation is none:
|
|
847
860
|
"When Elevasis SDK releases updates, the assistant can apply them to your workspace
|
|
@@ -892,7 +905,7 @@ for intermediate/advanced users.
|
|
|
892
905
|
|
|
893
906
|
**General rules (all levels)**
|
|
894
907
|
- If user is fast, acknowledge and offer to skip ahead within a lesson
|
|
895
|
-
- After
|
|
908
|
+
- After the user confirms readiness at the end of a lesson, update \`.claude/memory/tutorial-progress.md\`
|
|
896
909
|
- If user demonstrates a level change, promote to skills.md Growth Log
|
|
897
910
|
- After completing a module, show the updated full menu table
|
|
898
911
|
- Adapt module depth to skill level as with lessons
|
|
@@ -911,7 +924,7 @@ Last Session: {today's date}
|
|
|
911
924
|
|
|
912
925
|
## Completed Lessons
|
|
913
926
|
|
|
914
|
-
|
|
|
927
|
+
| Item | Title | Completed | Duration |
|
|
915
928
|
| --- | --- | --- | --- |
|
|
916
929
|
|
|
917
930
|
## Completed Modules
|
|
@@ -919,11 +932,6 @@ Last Session: {today's date}
|
|
|
919
932
|
| Module | Title | Completed | Duration |
|
|
920
933
|
| --- | --- | --- | --- |
|
|
921
934
|
|
|
922
|
-
## Completed MF Lessons
|
|
923
|
-
|
|
924
|
-
| Lesson | Title | Completed | Notes |
|
|
925
|
-
| --- | --- | --- | --- |
|
|
926
|
-
|
|
927
935
|
## Capability Observations
|
|
928
936
|
|
|
929
937
|
| Source | Observation |
|
|
@@ -935,13 +943,14 @@ Last Session: {today's date}
|
|
|
935
943
|
\`\`\`
|
|
936
944
|
|
|
937
945
|
Update rules:
|
|
938
|
-
- \`Current\`: free-form, e.g. "
|
|
946
|
+
- \`Current\`: free-form, e.g. "4: Using Platform Tools" or "M:integrations" or "20: Rules, Memory, and Customization"
|
|
939
947
|
- \`Last Session\`: update to today's date on each \`/tutorial\` invocation
|
|
940
|
-
- Completed
|
|
941
|
-
-
|
|
948
|
+
- Completed Lessons: add a row when any numbered item (1-10, 20-21) finishes
|
|
949
|
+
- Completed Modules: add a row when any module (items 11-19) finishes
|
|
950
|
+
- Capability Observations: prefix source with item number for lessons (#), M:<id> for modules
|
|
942
951
|
- Assessment Notes: bullet points of general skill observations
|
|
943
952
|
|
|
944
|
-
Backward-compatible: missing Completed Modules
|
|
953
|
+
Backward-compatible: missing Completed Modules treated as empty. Old files with Completed MF Lessons: map entries to items 2-4 and 20-21 by lesson title match.
|
|
945
954
|
`;
|
|
946
955
|
}
|
|
947
956
|
function claudeMetaCommandTemplate() {
|
|
@@ -1052,8 +1061,7 @@ by the \`<!-- initialized: false -->\` flag in CLAUDE.md, or run manually.
|
|
|
1052
1061
|
### \`/meta\` (no arguments) -- Project Status
|
|
1053
1062
|
|
|
1054
1063
|
Display a project health summary:
|
|
1055
|
-
1.
|
|
1056
|
-
2. SDK package version from package.json
|
|
1064
|
+
1. Template version (from elevasis.config.ts) and installed SDK version (from package.json). Suggest \`elevasis-sdk update\` to check for updates
|
|
1057
1065
|
3. Profile summary (from memory/profile/skills.md)
|
|
1058
1066
|
4. Quick drift check: count of missing managed files, missing gitignore entries
|
|
1059
1067
|
5. Last deployment status (from memory/deployment-state.md if it exists)
|
|
@@ -1492,7 +1500,6 @@ Your \`ELEVASIS_PLATFORM_KEY\` in \`.env\` determines the organization.
|
|
|
1492
1500
|
| --- | --- | --- |
|
|
1493
1501
|
| \`api-key\` | \`{"apiKey": "sk-..."}\` | Stripe, Resend, Apify, Attio, Instantly |
|
|
1494
1502
|
| \`webhook-secret\` | \`{"signingSecret": "whsec_..."}\` | Cal.com, Stripe webhooks |
|
|
1495
|
-
| \`trello\` | \`{"apiKey": "...", "token": "..."}\` | Trello |
|
|
1496
1503
|
| \`oauth\` | N/A (browser flow only) | Notion, Google Sheets, Dropbox |
|
|
1497
1504
|
|
|
1498
1505
|
OAuth credentials **cannot** be created via CLI. Redirect the user to the Command Center UI.
|
|
@@ -1515,12 +1522,11 @@ elevasis-sdk creds list
|
|
|
1515
1522
|
Display the output. Note which are \`oauth\` (not modifiable via CLI).
|
|
1516
1523
|
|
|
1517
1524
|
**\`create\`:** Guided credential creation flow:
|
|
1518
|
-
1. Ask credential type (\`api-key
|
|
1525
|
+
1. Ask credential type (\`api-key\` or \`webhook-secret\`). Not \`oauth\`.
|
|
1519
1526
|
2. Ask credential name. Validate naming rules before proceeding.
|
|
1520
1527
|
3. Ask the user to paste the credential value directly in chat.
|
|
1521
1528
|
- For \`api-key\`: ask for the API key, construct \`{"apiKey": "..."}\`
|
|
1522
1529
|
- For \`webhook-secret\`: ask for the signing secret, construct \`{"signingSecret": "..."}\`
|
|
1523
|
-
- For \`trello\`: ask for API key AND user token, construct \`{"apiKey": "...", "token": "..."}\`
|
|
1524
1530
|
4. Pipe to CLI: \`echo '{"apiKey":"..."}' | elevasis-sdk creds create --name {name} --type {type}\`
|
|
1525
1531
|
5. Confirm success. **NEVER echo the credential value back.**
|
|
1526
1532
|
|
|
@@ -17,7 +17,6 @@ export { createNotionAdapter } from './notion.js';
|
|
|
17
17
|
export { createResendAdapter } from './resend.js';
|
|
18
18
|
export { createSignatureApiAdapter } from './signature-api.js';
|
|
19
19
|
export { createStripeAdapter } from './stripe.js';
|
|
20
|
-
export { createTrelloAdapter } from './trello.js';
|
|
21
20
|
export { scheduler } from './scheduler.js';
|
|
22
21
|
export { llm } from './llm.js';
|
|
23
22
|
export { storage } from './storage.js';
|