@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.
Files changed (33) hide show
  1. package/dist/cli.cjs +276 -298
  2. package/dist/index.d.ts +13 -256
  3. package/dist/index.js +10 -38
  4. package/dist/templates.js +193 -187
  5. package/dist/types/worker/adapters/index.d.ts +0 -1
  6. package/dist/worker/index.js +126 -75
  7. package/package.json +1 -1
  8. package/reference/_navigation.md +13 -57
  9. package/reference/concepts.mdx +203 -0
  10. package/reference/deployment/{command-center-ui.mdx → command-center.mdx} +229 -151
  11. package/reference/deployment/index.mdx +158 -153
  12. package/reference/framework/agent.mdx +168 -151
  13. package/reference/framework/index.mdx +182 -103
  14. package/reference/framework/memory.mdx +347 -347
  15. package/reference/framework/project-structure.mdx +3 -13
  16. package/reference/framework/tutorial-system.mdx +253 -0
  17. package/reference/{getting-started/index.mdx → getting-started.mdx} +6 -7
  18. package/reference/index.mdx +117 -114
  19. package/reference/platform-tools/adapters.mdx +175 -32
  20. package/reference/platform-tools/index.mdx +354 -195
  21. package/reference/resources/index.mdx +5 -0
  22. package/reference/{roadmap/index.mdx → roadmap.mdx} +1 -1
  23. package/reference/{runtime/index.mdx → runtime.mdx} +196 -141
  24. package/dist/types/worker/adapters/trello.d.ts +0 -14
  25. package/reference/concepts/index.mdx +0 -203
  26. package/reference/deployment/command-view.mdx +0 -154
  27. package/reference/framework/documentation.mdx +0 -92
  28. package/reference/platform-tools/examples.mdx +0 -170
  29. package/reference/runtime/limits.mdx +0 -75
  30. package/reference/security/credentials.mdx +0 -141
  31. /package/reference/{cli/index.mdx → cli.mdx} +0 -0
  32. /package/reference/{developer → framework}/interaction-guidance.mdx +0 -0
  33. /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 = 24;
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' | 'production')
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
- autoCompact: false,
36
- statusLine: {
37
- type: "command",
38
- command: "node .claude/scripts/statusline-command.js"
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
- hooks: {
41
- PreToolUse: [
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 \`npx\`, \`curl\`, or any other tool.
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
- - \`ElevasisProvider\` is pre-configured in \`ui/src/App.tsx\` (oauth mode, redirectUri \`http://localhost:5100/auth-redirect\`, apiUrl \`http://localhost:5170\`)
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
- ORCHESTRATION CONCEPTS 0/7
436
- 1 Welcome & Orientation [ ]
437
- 2 Your First Custom Workflow [ ]
438
- 3 Understanding Data (Schemas) [ ]
439
- 4 Using Platform Tools [ ]
440
- 5 Multi-Step Workflows [ ]
441
- 6 Decision Points [ ]
442
- 7 Going to Production [ ]
443
-
444
- EXAMPLES & ADVANCED MODULES 0/9
445
- 8 Human-in-the-Loop [ ]
446
- 9 Task Scheduling [ ]
447
- 10 Notification System [ ]
448
- 11 Real-World Integrations [ ]
449
- 12 Error Handling Mastery [ ]
450
- 13 Advanced Workflows [ ]
451
- 14 Resource Composition [ ]
452
- 15 LLM Integration [ ]
453
- 16 AI Agents [ ]
454
-
455
- META-FRAMEWORK 0/5
456
- 17 The Agent Framework [ ]
457
- 18 The /meta Command [ ]
458
- 19 /work and /docs [ ]
459
- 20 Rules, Memory, and Customization [ ]
460
- 21 Template Lifecycle [ ]
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 completion: mark done in progress file, show updated menu table
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, record observations in \`.claude/memory/tutorial-progress.md\`
484
- 6. Ask: "Ready for the next lesson, or want to practice more?"
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
- **Lesson 1: Welcome & Orientation**
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
- **Lesson 2: Your First Custom Workflow**
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
- **Lesson 3: Understanding Data (Schemas)**
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
- **Lesson 4: Using Platform Tools**
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
- **Lesson 5: Multi-Step Workflows**
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
- **Lesson 6: Decision Points**
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
- **Lesson 7: Going to Production**
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 8-16 in the main menu): hitl, schedules, notifications,
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
- ## Meta-Framework Track
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
- **MF3: /work and /docs -- Task and Documentation Lifecycle**
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
- When automation is none:
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
- When automation is low-code:
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
- **MF5: Advanced -- Template Lifecycle and Extending**
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 each lesson, update \`.claude/memory/tutorial-progress.md\`
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
- | Lesson | Title | Completed | Duration |
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. "L4: Using Platform Tools" or "M:integrations" or "MF2"
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 tables: add a row when a lesson/module/MF lesson finishes
941
- - Capability Observations: prefix source with L# for lessons, M:<id> for modules, MF# for MF lessons
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 or Completed MF Lessons sections treated as empty.
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. Current template version vs latest available
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\`, \`webhook-secret\`, or \`trello\`). Not \`oauth\`.
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';